diff --git a/ci/etc/expected_install_directories b/ci/etc/expected_install_directories index 864bc139c2061..0a2a9dc6ded47 100644 --- a/ci/etc/expected_install_directories +++ b/ci/etc/expected_install_directories @@ -231,6 +231,10 @@ ./include/google/cloud/compute/addresses/v1 ./include/google/cloud/compute/addresses/v1/internal ./include/google/cloud/compute/addresses/v1/mocks +./include/google/cloud/compute/advice +./include/google/cloud/compute/advice/v1 +./include/google/cloud/compute/advice/v1/internal +./include/google/cloud/compute/advice/v1/mocks ./include/google/cloud/compute/autoscalers ./include/google/cloud/compute/autoscalers/v1 ./include/google/cloud/compute/autoscalers/v1/internal @@ -243,6 +247,10 @@ ./include/google/cloud/compute/backend_services/v1 ./include/google/cloud/compute/backend_services/v1/internal ./include/google/cloud/compute/backend_services/v1/mocks +./include/google/cloud/compute/cross_site_networks +./include/google/cloud/compute/cross_site_networks/v1 +./include/google/cloud/compute/cross_site_networks/v1/internal +./include/google/cloud/compute/cross_site_networks/v1/mocks ./include/google/cloud/compute/disk_types ./include/google/cloud/compute/disk_types/v1 ./include/google/cloud/compute/disk_types/v1/internal @@ -291,10 +299,18 @@ ./include/google/cloud/compute/global_public_delegated_prefixes/v1 ./include/google/cloud/compute/global_public_delegated_prefixes/v1/internal ./include/google/cloud/compute/global_public_delegated_prefixes/v1/mocks +./include/google/cloud/compute/global_vm_extension_policies +./include/google/cloud/compute/global_vm_extension_policies/v1 +./include/google/cloud/compute/global_vm_extension_policies/v1/internal +./include/google/cloud/compute/global_vm_extension_policies/v1/mocks ./include/google/cloud/compute/health_checks ./include/google/cloud/compute/health_checks/v1 ./include/google/cloud/compute/health_checks/v1/internal ./include/google/cloud/compute/health_checks/v1/mocks +./include/google/cloud/compute/hosts +./include/google/cloud/compute/hosts/v1 +./include/google/cloud/compute/hosts/v1/internal +./include/google/cloud/compute/hosts/v1/mocks ./include/google/cloud/compute/http_health_checks ./include/google/cloud/compute/http_health_checks/v1 ./include/google/cloud/compute/http_health_checks/v1/internal @@ -335,6 +351,10 @@ ./include/google/cloud/compute/instances/v1 ./include/google/cloud/compute/instances/v1/internal ./include/google/cloud/compute/instances/v1/mocks +./include/google/cloud/compute/instant_snapshot_groups +./include/google/cloud/compute/instant_snapshot_groups/v1 +./include/google/cloud/compute/instant_snapshot_groups/v1/internal +./include/google/cloud/compute/instant_snapshot_groups/v1/mocks ./include/google/cloud/compute/instant_snapshots ./include/google/cloud/compute/instant_snapshots/v1 ./include/google/cloud/compute/instant_snapshots/v1/internal @@ -415,10 +435,18 @@ ./include/google/cloud/compute/node_types/v1 ./include/google/cloud/compute/node_types/v1/internal ./include/google/cloud/compute/node_types/v1/mocks +./include/google/cloud/compute/organization_security_policies +./include/google/cloud/compute/organization_security_policies/v1 +./include/google/cloud/compute/organization_security_policies/v1/internal +./include/google/cloud/compute/organization_security_policies/v1/mocks ./include/google/cloud/compute/packet_mirrorings ./include/google/cloud/compute/packet_mirrorings/v1 ./include/google/cloud/compute/packet_mirrorings/v1/internal ./include/google/cloud/compute/packet_mirrorings/v1/mocks +./include/google/cloud/compute/preview_features +./include/google/cloud/compute/preview_features/v1 +./include/google/cloud/compute/preview_features/v1/internal +./include/google/cloud/compute/preview_features/v1/mocks ./include/google/cloud/compute/projects ./include/google/cloud/compute/projects/v1 ./include/google/cloud/compute/projects/v1/internal @@ -435,6 +463,10 @@ ./include/google/cloud/compute/region_autoscalers/v1 ./include/google/cloud/compute/region_autoscalers/v1/internal ./include/google/cloud/compute/region_autoscalers/v1/mocks +./include/google/cloud/compute/region_backend_buckets +./include/google/cloud/compute/region_backend_buckets/v1 +./include/google/cloud/compute/region_backend_buckets/v1/internal +./include/google/cloud/compute/region_backend_buckets/v1/mocks ./include/google/cloud/compute/region_backend_services ./include/google/cloud/compute/region_backend_services/v1 ./include/google/cloud/compute/region_backend_services/v1/internal @@ -443,6 +475,10 @@ ./include/google/cloud/compute/region_commitments/v1 ./include/google/cloud/compute/region_commitments/v1/internal ./include/google/cloud/compute/region_commitments/v1/mocks +./include/google/cloud/compute/region_composite_health_checks +./include/google/cloud/compute/region_composite_health_checks/v1 +./include/google/cloud/compute/region_composite_health_checks/v1/internal +./include/google/cloud/compute/region_composite_health_checks/v1/mocks ./include/google/cloud/compute/region_disk_types ./include/google/cloud/compute/region_disk_types/v1 ./include/google/cloud/compute/region_disk_types/v1/internal @@ -451,6 +487,10 @@ ./include/google/cloud/compute/region_disks/v1 ./include/google/cloud/compute/region_disks/v1/internal ./include/google/cloud/compute/region_disks/v1/mocks +./include/google/cloud/compute/region_health_aggregation_policies +./include/google/cloud/compute/region_health_aggregation_policies/v1 +./include/google/cloud/compute/region_health_aggregation_policies/v1/internal +./include/google/cloud/compute/region_health_aggregation_policies/v1/mocks ./include/google/cloud/compute/region_health_check_services ./include/google/cloud/compute/region_health_check_services/v1 ./include/google/cloud/compute/region_health_check_services/v1/internal @@ -459,6 +499,14 @@ ./include/google/cloud/compute/region_health_checks/v1 ./include/google/cloud/compute/region_health_checks/v1/internal ./include/google/cloud/compute/region_health_checks/v1/mocks +./include/google/cloud/compute/region_health_sources +./include/google/cloud/compute/region_health_sources/v1 +./include/google/cloud/compute/region_health_sources/v1/internal +./include/google/cloud/compute/region_health_sources/v1/mocks +./include/google/cloud/compute/region_instance_group_manager_resize_requests +./include/google/cloud/compute/region_instance_group_manager_resize_requests/v1 +./include/google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal +./include/google/cloud/compute/region_instance_group_manager_resize_requests/v1/mocks ./include/google/cloud/compute/region_instance_group_managers ./include/google/cloud/compute/region_instance_group_managers/v1 ./include/google/cloud/compute/region_instance_group_managers/v1/internal @@ -475,6 +523,10 @@ ./include/google/cloud/compute/region_instances/v1 ./include/google/cloud/compute/region_instances/v1/internal ./include/google/cloud/compute/region_instances/v1/mocks +./include/google/cloud/compute/region_instant_snapshot_groups +./include/google/cloud/compute/region_instant_snapshot_groups/v1 +./include/google/cloud/compute/region_instant_snapshot_groups/v1/internal +./include/google/cloud/compute/region_instant_snapshot_groups/v1/mocks ./include/google/cloud/compute/region_instant_snapshots ./include/google/cloud/compute/region_instant_snapshots/v1 ./include/google/cloud/compute/region_instant_snapshots/v1/internal @@ -499,6 +551,14 @@ ./include/google/cloud/compute/region_security_policies/v1 ./include/google/cloud/compute/region_security_policies/v1/internal ./include/google/cloud/compute/region_security_policies/v1/mocks +./include/google/cloud/compute/region_snapshot_settings +./include/google/cloud/compute/region_snapshot_settings/v1 +./include/google/cloud/compute/region_snapshot_settings/v1/internal +./include/google/cloud/compute/region_snapshot_settings/v1/mocks +./include/google/cloud/compute/region_snapshots +./include/google/cloud/compute/region_snapshots/v1 +./include/google/cloud/compute/region_snapshots/v1/internal +./include/google/cloud/compute/region_snapshots/v1/mocks ./include/google/cloud/compute/region_ssl_certificates ./include/google/cloud/compute/region_ssl_certificates/v1 ./include/google/cloud/compute/region_ssl_certificates/v1/internal @@ -531,10 +591,18 @@ ./include/google/cloud/compute/regions/v1 ./include/google/cloud/compute/regions/v1/internal ./include/google/cloud/compute/regions/v1/mocks +./include/google/cloud/compute/reliability_risks +./include/google/cloud/compute/reliability_risks/v1 +./include/google/cloud/compute/reliability_risks/v1/internal +./include/google/cloud/compute/reliability_risks/v1/mocks ./include/google/cloud/compute/reservation_blocks ./include/google/cloud/compute/reservation_blocks/v1 ./include/google/cloud/compute/reservation_blocks/v1/internal ./include/google/cloud/compute/reservation_blocks/v1/mocks +./include/google/cloud/compute/reservation_slots +./include/google/cloud/compute/reservation_slots/v1 +./include/google/cloud/compute/reservation_slots/v1/internal +./include/google/cloud/compute/reservation_slots/v1/mocks ./include/google/cloud/compute/reservation_sub_blocks ./include/google/cloud/compute/reservation_sub_blocks/v1 ./include/google/cloud/compute/reservation_sub_blocks/v1/internal @@ -547,6 +615,14 @@ ./include/google/cloud/compute/resource_policies/v1 ./include/google/cloud/compute/resource_policies/v1/internal ./include/google/cloud/compute/resource_policies/v1/mocks +./include/google/cloud/compute/rollout_plans +./include/google/cloud/compute/rollout_plans/v1 +./include/google/cloud/compute/rollout_plans/v1/internal +./include/google/cloud/compute/rollout_plans/v1/mocks +./include/google/cloud/compute/rollouts +./include/google/cloud/compute/rollouts/v1 +./include/google/cloud/compute/rollouts/v1/internal +./include/google/cloud/compute/rollouts/v1/mocks ./include/google/cloud/compute/routers ./include/google/cloud/compute/routers/v1 ./include/google/cloud/compute/routers/v1/internal @@ -635,10 +711,18 @@ ./include/google/cloud/compute/vpn_tunnels/v1 ./include/google/cloud/compute/vpn_tunnels/v1/internal ./include/google/cloud/compute/vpn_tunnels/v1/mocks +./include/google/cloud/compute/wire_groups +./include/google/cloud/compute/wire_groups/v1 +./include/google/cloud/compute/wire_groups/v1/internal +./include/google/cloud/compute/wire_groups/v1/mocks ./include/google/cloud/compute/zone_operations ./include/google/cloud/compute/zone_operations/v1 ./include/google/cloud/compute/zone_operations/v1/internal ./include/google/cloud/compute/zone_operations/v1/mocks +./include/google/cloud/compute/zone_vm_extension_policies +./include/google/cloud/compute/zone_vm_extension_policies/v1 +./include/google/cloud/compute/zone_vm_extension_policies/v1/internal +./include/google/cloud/compute/zone_vm_extension_policies/v1/mocks ./include/google/cloud/compute/zones ./include/google/cloud/compute/zones/v1 ./include/google/cloud/compute/zones/v1/internal diff --git a/generator/discovery/compute_public_google_rest_v1.json b/generator/discovery/compute_public_google_rest_v1.json index 7a24ba19fb980..b2c545f6b6570 100644 --- a/generator/discovery/compute_public_google_rest_v1.json +++ b/generator/discovery/compute_public_google_rest_v1.json @@ -1,25 +1,283 @@ { - "ownerName": "Google", - "revision": "20250601", - "servicePath": "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" + } + } + } + }, "basePath": "/compute/v1/", - "documentationLink": "https://cloud.google.com/compute/", - "description": "Creates and runs virtual machines on Google Cloud Platform. ", + "baseUrl": "https://compute.googleapis.com/compute/v1/", "batchPath": "batch/compute/v1", + "description": "Creates and runs virtual machines on Google Cloud Platform.", + "discoveryVersion": "v1", + "documentationLink": "https://cloud.google.com/compute/", + "endpoints": [ + { + "description": "Regional Endpoint", + "endpointUrl": "https://compute.africa-south1.rep.googleapis.com/", + "location": "africa-south1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://compute.asia-east1.rep.googleapis.com/", + "location": "asia-east1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://compute.asia-east2.rep.googleapis.com/", + "location": "asia-east2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://compute.asia-northeast1.rep.googleapis.com/", + "location": "asia-northeast1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://compute.asia-northeast2.rep.googleapis.com/", + "location": "asia-northeast2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://compute.asia-northeast3.rep.googleapis.com/", + "location": "asia-northeast3" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://compute.asia-south1.rep.googleapis.com/", + "location": "asia-south1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://compute.asia-south2.rep.googleapis.com/", + "location": "asia-south2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://compute.asia-southeast1.rep.googleapis.com/", + "location": "asia-southeast1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://compute.asia-southeast2.rep.googleapis.com/", + "location": "asia-southeast2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://compute.asia-southeast3.rep.googleapis.com/", + "location": "asia-southeast3" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://compute.australia-southeast1.rep.googleapis.com/", + "location": "australia-southeast1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://compute.australia-southeast2.rep.googleapis.com/", + "location": "australia-southeast2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://compute.europe-central2.rep.googleapis.com/", + "location": "europe-central2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://compute.europe-north1.rep.googleapis.com/", + "location": "europe-north1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://compute.europe-north2.rep.googleapis.com/", + "location": "europe-north2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://compute.europe-southwest1.rep.googleapis.com/", + "location": "europe-southwest1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://compute.europe-west1.rep.googleapis.com/", + "location": "europe-west1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://compute.europe-west10.rep.googleapis.com/", + "location": "europe-west10" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://compute.europe-west12.rep.googleapis.com/", + "location": "europe-west12" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://compute.europe-west2.rep.googleapis.com/", + "location": "europe-west2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://compute.europe-west3.rep.googleapis.com/", + "location": "europe-west3" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://compute.europe-west4.rep.googleapis.com/", + "location": "europe-west4" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://compute.europe-west6.rep.googleapis.com/", + "location": "europe-west6" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://compute.europe-west8.rep.googleapis.com/", + "location": "europe-west8" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://compute.europe-west9.rep.googleapis.com/", + "location": "europe-west9" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://compute.me-central1.rep.googleapis.com/", + "location": "me-central1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://compute.me-central2.rep.googleapis.com/", + "location": "me-central2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://compute.me-west1.rep.googleapis.com/", + "location": "me-west1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://compute.northamerica-northeast1.rep.googleapis.com/", + "location": "northamerica-northeast1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://compute.northamerica-northeast2.rep.googleapis.com/", + "location": "northamerica-northeast2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://compute.northamerica-south1.rep.googleapis.com/", + "location": "northamerica-south1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://compute.southamerica-east1.rep.googleapis.com/", + "location": "southamerica-east1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://compute.southamerica-west1.rep.googleapis.com/", + "location": "southamerica-west1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://compute.us-central1.rep.googleapis.com/", + "location": "us-central1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://compute.us-east1.rep.googleapis.com/", + "location": "us-east1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://compute.us-east4.rep.googleapis.com/", + "location": "us-east4" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://compute.us-east5.rep.googleapis.com/", + "location": "us-east5" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://compute.us-south1.rep.googleapis.com/", + "location": "us-south1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://compute.us-west1.rep.googleapis.com/", + "location": "us-west1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://compute.us-west2.rep.googleapis.com/", + "location": "us-west2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://compute.us-west3.rep.googleapis.com/", + "location": "us-west3" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://compute.us-west4.rep.googleapis.com/", + "location": "us-west4" + } + ], + "icons": { + "x16": "https://www.google.com/images/icons/product/compute_engine-16.png", + "x32": "https://www.google.com/images/icons/product/compute_engine-32.png" + }, "id": "compute:v1", "kind": "discovery#restDescription", - "baseUrl": "https://compute.googleapis.com/compute/v1/", - "discoveryVersion": "v1", + "mtlsRootUrl": "https://compute.mtls.googleapis.com/", + "name": "compute", + "ownerDomain": "google.com", + "ownerName": "Google", "parameters": { + "$.xgafv": { + "description": "V1 error format.", + "enum": [ + "1", + "2" + ], + "enumDescriptions": [ + "v1 error format", + "v2 error format" + ], + "location": "query", + "type": "string" + }, "access_token": { - "type": "string", "description": "OAuth access token.", - "location": "query" + "location": "query", + "type": "string" }, "alt": { - "type": "string", - "description": "Data format for response.", "default": "json", + "description": "Data format for response.", "enum": [ "json", "media", @@ -30,52881 +288,46800 @@ "Media download with context-dependent Content-Type", "Responses with Content-Type of application/x-protobuf" ], - "location": "query" + "location": "query", + "type": "string" }, "callback": { - "type": "string", "description": "JSONP", - "location": "query" + "location": "query", + "type": "string" }, "fields": { - "type": "string", "description": "Selector specifying which fields to include in a partial response.", - "location": "query" + "location": "query", + "type": "string" }, "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" + "location": "query", + "type": "string" }, "oauth_token": { - "type": "string", "description": "OAuth 2.0 token for the current user.", - "location": "query" + "location": "query", + "type": "string" }, "prettyPrint": { - "type": "boolean", - "description": "Returns response with indentations and line breaks.", "default": "true", - "location": "query" + "description": "Returns response with indentations and line breaks.", + "location": "query", + "type": "boolean" }, "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" + "location": "query", + "type": "string" }, "uploadType": { - "type": "string", "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").", - "location": "query" + "location": "query", + "type": "string" + }, + "upload_protocol": { + "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").", + "location": "query", + "type": "string" }, "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" + "location": "query", + "type": "string" } }, - "schemas": { - "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": { - "$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" + "protocol": "rest", + "resources": { + "acceleratorTypes": { + "methods": { + "aggregatedList": { + "description": "Retrieves an aggregated list of accelerator types.\n\nTo prevent failure, it is recommended that you set the\n`returnPartialSuccess` parameter to `true`.", + "flatPath": "projects/{project}/aggregated/acceleratorTypes", + "httpMethod": "GET", + "id": "compute.acceleratorTypes.aggregatedList", + "parameterOrder": [ + "project" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region,\nglobal) should be included in the response. For new resource types added\nafter this field, the flag has no effect as new resource types will always\ninclude every visible scope for each scope type in response. For resource\ntypes which predate this field, if this flag is omitted or false, only\nscopes of the scope types where the resource type is expected to be found\nwill be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which\naggregated list request is invoked for subnetworks list-usable api.", + "format": "int64", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/aggregated/acceleratorTypes", + "response": { + "$ref": "AcceleratorTypeAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "get": { + "description": "Returns the specified accelerator type.", + "flatPath": "projects/{project}/zones/{zone}/acceleratorTypes/{acceleratorType}", + "httpMethod": "GET", + "id": "compute.acceleratorTypes.get", + "parameterOrder": [ + "project", + "zone", + "acceleratorType" + ], + "parameters": { + "acceleratorType": { + "description": "Name of the accelerator type to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/acceleratorTypes/{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" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "list": { + "description": "Retrieves a list of accelerator types that are available to the specified\nproject.", + "flatPath": "projects/{project}/zones/{zone}/acceleratorTypes", + "httpMethod": "GET", + "id": "compute.acceleratorTypes.list", + "parameterOrder": [ + "project", + "zone" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`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\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" } - } + }, + "path": "projects/{project}/zones/{zone}/acceleratorTypes", + "response": { + "$ref": "AcceleratorTypeList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] } } }, - "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": { - "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" - }, - "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 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": [ - "", - "", - "" + "addresses": { + "methods": { + "aggregatedList": { + "description": "Retrieves an aggregated list of addresses.\n\nTo prevent failure, it is recommended that you set the\n`returnPartialSuccess` parameter to `true`.", + "flatPath": "projects/{project}/aggregated/addresses", + "httpMethod": "GET", + "id": "compute.addresses.aggregatedList", + "parameterOrder": [ + "project" ], - "enum": [ - "DONE", - "PENDING", - "RUNNING" + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region,\nglobal) should be included in the response. For new resource types added\nafter this field, the flag has no effect as new resource types will always\ninclude every visible scope for each scope type in response. For resource\ntypes which predate this field, if this flag is omitted or false, only\nscopes of the scope types where the resource type is expected to be found\nwill be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which\naggregated list request is invoked for subnetworks list-usable api.", + "format": "int64", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/aggregated/addresses", + "response": { + "$ref": "AddressAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "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" + "delete": { + "description": "Deletes the specified address resource.", + "flatPath": "projects/{project}/regions/{region}/addresses/{address}", + "httpMethod": "DELETE", + "id": "compute.addresses.delete", + "parameterOrder": [ + "project", + "region", + "address" + ], + "parameters": { + "address": { + "description": "Name of the address resource to delete.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/addresses/{address}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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": { + "description": "Returns the specified address resource.", + "flatPath": "projects/{project}/regions/{region}/addresses/{address}", + "httpMethod": "GET", + "id": "compute.addresses.get", + "parameterOrder": [ + "project", + "region", + "address" + ], + "parameters": { + "address": { + "description": "Name of the address resource to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" } - } + }, + "path": "projects/{project}/regions/{region}/addresses/{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" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "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": { + "description": "Creates an address resource in the specified project by using the data\nincluded in the request.", + "flatPath": "projects/{project}/regions/{region}/addresses", + "httpMethod": "POST", + "id": "compute.addresses.insert", + "parameterOrder": [ + "project", + "region" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "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": { - "id": "SetCommonInstanceMetadataOperationMetadata", - "type": "object", - "properties": { - "clientOperationId": { - "description": "[Output Only] The client operation id.", - "type": "string" + }, + "path": "projects/{project}/regions/{region}/addresses", + "request": { + "$ref": "Address" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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.", - "" + "list": { + "description": "Retrieves a list of addresses contained within\nthe specified region.", + "flatPath": "projects/{project}/regions/{region}/addresses", + "httpMethod": "GET", + "id": "compute.addresses.list", + "parameterOrder": [ + "project", + "region" ], - "enum": [ - "ABANDONED", - "DONE", - "FAILED", - "PROPAGATED", - "PROPAGATING", - "UNSPECIFIED" + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/regions/{region}/addresses", + "response": { + "$ref": "AddressList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "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" + "move": { + "description": "Moves the specified address resource.", + "flatPath": "projects/{project}/regions/{region}/addresses/{address}/move", + "httpMethod": "POST", + "id": "compute.addresses.move", + "parameterOrder": [ + "project", + "region", + "address" + ], + "parameters": { + "address": { + "description": "Name of the address resource to move.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Source project ID which the Address is moved from.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/addresses/{address}/move", + "request": { + "$ref": "RegionAddressesMoveRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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" + "setLabels": { + "description": "Sets the labels on an Address. To learn more about labels, read theLabeling\nResources documentation.", + "flatPath": "projects/{project}/regions/{region}/addresses/{resource}/setLabels", + "httpMethod": "POST", + "id": "compute.addresses.setLabels", + "parameterOrder": [ + "project", + "region", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/addresses/{resource}/setLabels", + "request": { + "$ref": "RegionSetLabelsRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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": { - "format": "google.protobuf.Any", - "type": "object", - "additionalProperties": { - "type": "any", - "description": "Properties of the object. Contains field @type with type URL." + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource.", + "flatPath": "projects/{project}/regions/{region}/addresses/{resource}/testIamPermissions", + "httpMethod": "POST", + "id": "compute.addresses.testIamPermissions", + "parameterOrder": [ + "project", + "region", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "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" - } + }, + "path": "projects/{project}/regions/{region}/addresses/{resource}/testIamPermissions", + "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" + ] } } }, - "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.", - "" + "advice": { + "methods": { + "calendarMode": { + "description": "Advise how, where and when to create the requested amount of instances\nwith specified accelerators, within the specified time and location limits.\nThe method recommends creating future reservations for the requested\nresources.", + "flatPath": "projects/{project}/regions/{region}/advice/calendarMode", + "httpMethod": "POST", + "id": "compute.advice.calendarMode", + "parameterOrder": [ + "project", + "region" ], - "enum": [ - "CREATING", - "DONE", - "ROLLING_BACK", - "STATUS_UNSPECIFIED" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/advice/calendarMode", + "request": { + "$ref": "CalendarModeAdviceRequest" + }, + "response": { + "$ref": "CalendarModeAdviceResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] - }, - "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" - }, - "deletedVmCount": { - "description": "[Output Only] Count of VMs that got deleted during rollback.", - "type": "integer", - "format": "int32" } } }, - "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" - }, - "metadatas": { - "description": "Additional structured details about this error. Keys must match a regular expression of `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" - }, - "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." + "autoscalers": { + "methods": { + "aggregatedList": { + "description": "Retrieves an aggregated list of autoscalers.\n\nTo prevent failure, it is recommended that you set the\n`returnPartialSuccess` parameter to `true`.", + "flatPath": "projects/{project}/aggregated/autoscalers", + "httpMethod": "GET", + "id": "compute.autoscalers.aggregatedList", + "parameterOrder": [ + "project" ], - "enum": [ - "IN_PROGRESS", - "ROLLOUT_STATUS_UNSPECIFIED" + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region,\nglobal) should be included in the response. For new resource types added\nafter this field, the flag has no effect as new resource types will always\ninclude every visible scope for each scope type in response. For resource\ntypes which predate this field, if this flag is omitted or false, only\nscopes of the scope types where the resource type is expected to be found\nwill be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which\naggregated list request is invoked for subnetworks list-usable api.", + "format": "int64", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/aggregated/autoscalers", + "response": { + "$ref": "AutoscalerAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] - } - } - }, - "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" - } - } - }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "delete": { + "description": "Deletes the specified autoscaler.", + "flatPath": "projects/{project}/zones/{zone}/autoscalers/{autoscaler}", + "httpMethod": "DELETE", + "id": "compute.autoscalers.delete", + "parameterOrder": [ + "project", + "zone", + "autoscaler" + ], + "parameters": { + "autoscaler": { + "description": "Name of the autoscaler to delete.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "Name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" } - } - }, - "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": { + }, + "path": "projects/{project}/zones/{zone}/autoscalers/{autoscaler}", + "response": { "$ref": "Operation" - } + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "get": { + "description": "Returns the specified autoscaler resource.", + "flatPath": "projects/{project}/zones/{zone}/autoscalers/{autoscaler}", + "httpMethod": "GET", + "id": "compute.autoscalers.get", + "parameterOrder": [ + "project", + "zone", + "autoscaler" + ], + "parameters": { + "autoscaler": { + "description": "Name of the autoscaler to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" } - } - } - } - }, - "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" + }, + "path": "projects/{project}/zones/{zone}/autoscalers/{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" + ] }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "insert": { + "description": "Creates an autoscaler in the specified project using the data\nincluded in the request.", + "flatPath": "projects/{project}/zones/{zone}/autoscalers", + "httpMethod": "POST", + "id": "compute.autoscalers.insert", + "parameterOrder": [ + "project", + "zone" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "Name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/autoscalers", + "request": { + "$ref": "Autoscaler" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "list": { + "description": "Retrieves a list of autoscalers contained within\nthe specified zone.", + "flatPath": "projects/{project}/zones/{zone}/autoscalers", + "httpMethod": "GET", + "id": "compute.autoscalers.list", + "parameterOrder": [ + "project", + "zone" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`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\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "zone": { + "description": "Name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" } - } - } - } - }, - "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" - }, - "deprecated": { - "description": "[Output Only] The deprecation status associated with this accelerator type.", - "$ref": "DeprecationStatus" - }, - "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" - }, - "selfLink": { - "description": "[Output Only] Server-defined, fully qualified URL for this resource.", - "type": "string" + }, + "path": "projects/{project}/zones/{zone}/autoscalers", + "response": { + "$ref": "AutoscalerList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "maximumCardsPerInstance": { - "description": "[Output Only] Maximum number of accelerator cards allowed per instance.", - "type": "integer", - "format": "int32" - } - } - }, - "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": [ - "", - "", - "", - "" + "patch": { + "description": "Updates an autoscaler in the specified project using the data\nincluded in the request. This method supportsPATCH\nsemantics and uses theJSON merge\npatch format and processing rules.", + "flatPath": "projects/{project}/zones/{zone}/autoscalers", + "httpMethod": "PATCH", + "id": "compute.autoscalers.patch", + "parameterOrder": [ + "project", + "zone" ], - "enum": [ - "ACTIVE", - "DELETED", - "DEPRECATED", - "OBSOLETE" + "parameters": { + "autoscaler": { + "description": "Name of the autoscaler to patch.", + "location": "query", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "Name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/autoscalers", + "request": { + "$ref": "Autoscaler" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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" - }, - "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" - }, - "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" - } - } - }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource.", + "flatPath": "projects/{project}/zones/{zone}/autoscalers/{resource}/testIamPermissions", + "httpMethod": "POST", + "id": "compute.autoscalers.testIamPermissions", + "parameterOrder": [ + "project", + "zone", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" } - } + }, + "path": "projects/{project}/zones/{zone}/autoscalers/{resource}/testIamPermissions", + "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" + ] }, - "unreachables": { - "description": "[Output Only] Unreachable resources.", - "type": "array", - "items": { - "type": "string" - } + "update": { + "description": "Updates an autoscaler in the specified project using the data\nincluded in the request.", + "flatPath": "projects/{project}/zones/{zone}/autoscalers", + "httpMethod": "PUT", + "id": "compute.autoscalers.update", + "parameterOrder": [ + "project", + "zone" + ], + "parameters": { + "autoscaler": { + "description": "Name of the autoscaler to update.", + "location": "query", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "Name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/autoscalers", + "request": { + "$ref": "Autoscaler" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] } } }, - "AcceleratorTypesScopedList": { - "id": "AcceleratorTypesScopedList", - "type": "object", - "properties": { - "acceleratorTypes": { - "description": "[Output Only] A list of accelerator types contained in this scope.", - "type": "array", - "items": { - "$ref": "AcceleratorType" - } + "backendBuckets": { + "methods": { + "addSignedUrlKey": { + "description": "Adds a key for validating requests with signed URLs for this backend\nbucket.", + "flatPath": "projects/{project}/global/backendBuckets/{backendBucket}/addSignedUrlKey", + "httpMethod": "POST", + "id": "compute.backendBuckets.addSignedUrlKey", + "parameterOrder": [ + "project", + "backendBucket" + ], + "parameters": { + "backendBucket": { + "description": "Name of the BackendBucket resource to which the Signed URL Key should be\nadded. The name should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/backendBuckets/{backendBucket}/addSignedUrlKey", + "request": { + "$ref": "SignedUrlKey" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "aggregatedList": { + "description": "Retrieves the list of all BackendBucket resources, regional and global,\navailable to the specified project.\n\nTo prevent failure, it is recommended that you set the\n`returnPartialSuccess` parameter to `true`.", + "flatPath": "projects/{project}/aggregated/backendBuckets", + "httpMethod": "GET", + "id": "compute.backendBuckets.aggregatedList", + "parameterOrder": [ + "project" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "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,\nglobal) should be included in the response. For new resource types added\nafter this field, the flag has no effect as new resource types will always\ninclude every visible scope for each scope type in response. For resource\ntypes which predate this field, if this flag is omitted or false, only\nscopes of the scope types where the resource type is expected to be found\nwill be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`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" - } - } - } - } - } - } - } - }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "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\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Name of the project scoping this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which\naggregated list request is invoked for subnetworks list-usable api.", + "format": "int64", + "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" + "path": "projects/{project}/aggregated/backendBuckets", + "response": { + "$ref": "BackendBucketAggregatedList" + }, + "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] 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." + "delete": { + "description": "Deletes the specified BackendBucket resource.", + "flatPath": "projects/{project}/global/backendBuckets/{backendBucket}", + "httpMethod": "DELETE", + "id": "compute.backendBuckets.delete", + "parameterOrder": [ + "project", + "backendBucket" ], - "enum": [ - "IN_USE", - "RESERVED", - "RESERVING" + "parameters": { + "backendBucket": { + "description": "Name of the BackendBucket resource to delete.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/backendBuckets/{backendBucket}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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." + "deleteSignedUrlKey": { + "description": "Deletes a key for validating requests with signed URLs for this backend\nbucket.", + "flatPath": "projects/{project}/global/backendBuckets/{backendBucket}/deleteSignedUrlKey", + "httpMethod": "POST", + "id": "compute.backendBuckets.deleteSignedUrlKey", + "parameterOrder": [ + "project", + "backendBucket", + "keyName" ], - "enum": [ - "FIXED_STANDARD", - "PREMIUM", - "STANDARD", - "STANDARD_OVERRIDES_FIXED_STANDARD" + "parameters": { + "backendBucket": { + "description": "Name of the BackendBucket resource to which the Signed URL Key should be\nadded. 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.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/backendBuckets/{backendBucket}/deleteSignedUrlKey", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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": [ - "", - "", - "" + "get": { + "description": "Returns the specified BackendBucket resource.", + "flatPath": "projects/{project}/global/backendBuckets/{backendBucket}", + "httpMethod": "GET", + "id": "compute.backendBuckets.get", + "parameterOrder": [ + "project", + "backendBucket" ], - "enum": [ - "IPV4", - "IPV6", - "UNSPECIFIED_VERSION" + "parameters": { + "backendBucket": { + "description": "Name of the BackendBucket resource to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/backendBuckets/{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" ] }, - "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.", - "" + "getIamPolicy": { + "description": "Gets the access control policy for a resource. May be empty if no such\npolicy or resource exists.", + "flatPath": "projects/{project}/global/backendBuckets/{resource}/getIamPolicy", + "httpMethod": "GET", + "id": "compute.backendBuckets.getIamPolicy", + "parameterOrder": [ + "project", + "resource" ], - "enum": [ - "EXTERNAL", - "INTERNAL", - "UNSPECIFIED_TYPE" + "parameters": { + "optionsRequestedPolicyVersion": { + "description": "Requested IAM Policy version.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/backendBuckets/{resource}/getIamPolicy", + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "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." + "insert": { + "description": "Creates a BackendBucket resource in the specified project using\nthe data included in the request.", + "flatPath": "projects/{project}/global/backendBuckets", + "httpMethod": "POST", + "id": "compute.backendBuckets.insert", + "parameterOrder": [ + "project" ], - "enum": [ - "DNS_RESOLVER", - "GCE_ENDPOINT", - "IPSEC_INTERCONNECT", - "NAT_AUTO", - "PRIVATE_SERVICE_CONNECT", - "SERVERLESS", - "SHARED_LOADBALANCER_VIP", - "VPC_PEERING" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/backendBuckets", + "request": { + "$ref": "BackendBucket" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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." + "list": { + "description": "Retrieves the list of BackendBucket resources available to the specified\nproject.", + "flatPath": "projects/{project}/global/backendBuckets", + "httpMethod": "GET", + "id": "compute.backendBuckets.list", + "parameterOrder": [ + "project" ], - "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" - }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "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.", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "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" - } - } - } - }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`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" - } - } - } - } - } - } - } - }, - "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" - }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "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\n`nextPageToken` returned by a previous list request to get\nthe 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.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" } - } - } - } - }, - "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" - }, - "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": [ - "" - ], - "enum": [ - "RAW" + "path": "projects/{project}/global/backendBuckets", + "response": { + "$ref": "BackendBucketList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "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 ", + "listUsable": { + "description": "Retrieves a list of all usable backend buckets in the specified project.", + "flatPath": "projects/{project}/global/backendBuckets/listUsable", + "httpMethod": "GET", + "id": "compute.backendBuckets.listUsable", + "parameterOrder": [ + "project" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", "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, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "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" - ] + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" } - } - }, - "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." - ], - "enum": [ - "DELETING", - "FAILED", - "PENDING", - "READY" + }, + "path": "projects/{project}/global/backendBuckets/listUsable", + "response": { + "$ref": "BackendBucketListUsable" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "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" + "patch": { + "description": "Updates the specified BackendBucket resource with the data included in the\nrequest. This method supportsPATCH\nsemantics and uses theJSON merge\npatch format and processing rules.", + "flatPath": "projects/{project}/global/backendBuckets/{backendBucket}", + "httpMethod": "PATCH", + "id": "compute.backendBuckets.patch", + "parameterOrder": [ + "project", + "backendBucket" ], - "enum": [ - "ARCHITECTURE_UNSPECIFIED", - "ARM64", - "X86_64" + "parameters": { + "backendBucket": { + "description": "Name of the BackendBucket resource to patch.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/backendBuckets/{backendBucket}", + "request": { + "$ref": "BackendBucket" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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 - SNP_SVSM_CAPABLE For more information, see Enabling guest operating system features.", - "type": "string", - "enumDescriptions": [ - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "" + "setEdgeSecurityPolicy": { + "description": "Sets the edge security policy for the specified backend bucket.", + "flatPath": "projects/{project}/global/backendBuckets/{backendBucket}/setEdgeSecurityPolicy", + "httpMethod": "POST", + "id": "compute.backendBuckets.setEdgeSecurityPolicy", + "parameterOrder": [ + "project", + "backendBucket" ], - "enum": [ - "BARE_METAL_LINUX_COMPATIBLE", - "FEATURE_TYPE_UNSPECIFIED", - "GVNIC", - "IDPF", - "MULTI_IP_SUBNET", - "SECURE_BOOT", - "SEV_CAPABLE", - "SEV_LIVE_MIGRATABLE", - "SEV_LIVE_MIGRATABLE_V2", - "SEV_SNP_CAPABLE", - "SNP_SVSM_CAPABLE", - "TDX_CAPABLE", - "UEFI_COMPATIBLE", - "VIRTIO_SCSI_MULTIQUEUE", - "WINDOWS" + "parameters": { + "backendBucket": { + "description": "Name of the BackendBucket resource to which the security policy should be\nset. The name should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/backendBuckets/{backendBucket}/setEdgeSecurityPolicy", + "request": { + "$ref": "SecurityPolicyReference" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] - } - } - }, - "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" - } - }, - "dbs": { - "description": "The Key Database (db).", - "type": "array", - "items": { - "$ref": "FileContentBuffer" - } - }, - "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": [ - "", - "", - "" + "setIamPolicy": { + "description": "Sets the access control policy on the specified resource.\nReplaces any existing policy.", + "flatPath": "projects/{project}/global/backendBuckets/{resource}/setIamPolicy", + "httpMethod": "POST", + "id": "compute.backendBuckets.setIamPolicy", + "parameterOrder": [ + "project", + "resource" ], - "enum": [ - "BIN", - "UNDEFINED", - "X509" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/backendBuckets/{resource}/setIamPolicy", + "request": { + "$ref": "GlobalSetPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] - } - } - }, - "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" - } - }, - "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" - } - } - }, - "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." + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource.", + "flatPath": "projects/{project}/global/backendBuckets/{resource}/testIamPermissions", + "httpMethod": "POST", + "id": "compute.backendBuckets.testIamPermissions", + "parameterOrder": [ + "project", + "resource" ], - "enum": [ - "ADMIN_READ", - "DATA_READ", - "DATA_WRITE", - "LOG_TYPE_UNSPECIFIED" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/backendBuckets/{resource}/testIamPermissions", + "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" ] }, - "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" - } + "update": { + "description": "Updates the specified BackendBucket resource with the data included in the\nrequest.", + "flatPath": "projects/{project}/global/backendBuckets/{backendBucket}", + "httpMethod": "PUT", + "id": "compute.backendBuckets.update", + "parameterOrder": [ + "project", + "backendBucket" + ], + "parameters": { + "backendBucket": { + "description": "Name of the BackendBucket resource to update.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/backendBuckets/{backendBucket}", + "request": { + "$ref": "BackendBucket" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] } } }, - "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" - }, - "bindings": { - "description": "Flatten Policy to create a backward compatible wire-format. Deprecated. Use 'policy' to specify bindings.", - "type": "array", - "items": { - "$ref": "Binding" - } + "backendServices": { + "methods": { + "addSignedUrlKey": { + "description": "Adds a key for validating requests with signed URLs for this backend\nservice.", + "flatPath": "projects/{project}/global/backendServices/{backendService}/addSignedUrlKey", + "httpMethod": "POST", + "id": "compute.backendServices.addSignedUrlKey", + "parameterOrder": [ + "project", + "backendService" + ], + "parameters": { + "backendService": { + "description": "Name of the BackendService resource to which the Signed URL Key should be\nadded. The name should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/backendServices/{backendService}/addSignedUrlKey", + "request": { + "$ref": "SignedUrlKey" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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" - } - } - } - }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "aggregatedList": { + "description": "Retrieves the list of all BackendService resources, regional and global,\navailable to the specified project.\n\nTo prevent failure, it is recommended that you set the\n`returnPartialSuccess` parameter to `true`.", + "flatPath": "projects/{project}/aggregated/backendServices", + "httpMethod": "GET", + "id": "compute.backendServices.aggregatedList", + "parameterOrder": [ + "project" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "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,\nglobal) should be included in the response. For new resource types added\nafter this field, the flag has no effect as new resource types will always\ninclude every visible scope for each scope type in response. For resource\ntypes which predate this field, if this flag is omitted or false, only\nscopes of the scope types where the resource type is expected to be found\nwill be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`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\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Name of the project scoping this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which\naggregated list request is invoked for subnetworks list-usable api.", + "format": "int64", + "location": "query", + "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. LINT.IfChange", - "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" + "path": "projects/{project}/aggregated/backendServices", + "response": { + "$ref": "BackendServiceAggregatedList" + }, + "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] 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." + "delete": { + "description": "Deletes the specified BackendService resource.", + "flatPath": "projects/{project}/global/backendServices/{backendService}", + "httpMethod": "DELETE", + "id": "compute.backendServices.delete", + "parameterOrder": [ + "project", + "backendService" ], - "enum": [ - "CREATING", - "DELETING", - "FAILED", - "READY", - "UPLOADING" + "parameters": { + "backendService": { + "description": "Name of the BackendService resource to delete.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/backendServices/{backendService}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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": [ - "", - "" + "deleteSignedUrlKey": { + "description": "Deletes a key for validating requests with signed URLs for this backend\nservice.", + "flatPath": "projects/{project}/global/backendServices/{backendService}/deleteSignedUrlKey", + "httpMethod": "POST", + "id": "compute.backendServices.deleteSignedUrlKey", + "parameterOrder": [ + "project", + "backendService", + "keyName" ], - "enum": [ - "UPDATING", - "UP_TO_DATE" + "parameters": { + "backendService": { + "description": "Name of the BackendService resource to which the Signed URL Key should be\nadded. 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.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/backendServices/{backendService}/deleteSignedUrlKey", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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" - }, - "guestFlush": { - "description": "[Input Only] Whether to attempt an application consistent snapshot by informing the OS to prepare for the snapshot process.", - "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 snapshot. For example, if you created the snapshot 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" + "get": { + "description": "Returns the specified BackendService resource.", + "flatPath": "projects/{project}/global/backendServices/{backendService}", + "httpMethod": "GET", + "id": "compute.backendServices.get", + "parameterOrder": [ + "project", + "backendService" ], - "enum": [ - "ARCHITECTURE_UNSPECIFIED", - "ARM64", - "X86_64" + "parameters": { + "backendService": { + "description": "Name of the BackendService resource to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/backendServices/{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" ] }, - "snapshotType": { - "description": "Indicates the type of the snapshot.", - "type": "string", - "enumDescriptions": [ - "", - "" + "getEffectiveSecurityPolicies": { + "description": "Returns effective security policies applied to this backend service.", + "flatPath": "projects/{project}/global/backendServices/{backendService}/getEffectiveSecurityPolicies", + "httpMethod": "GET", + "id": "compute.backendServices.getEffectiveSecurityPolicies", + "parameterOrder": [ + "project", + "backendService" ], - "enum": [ - "ARCHIVE", - "STANDARD" + "parameters": { + "backendService": { + "description": "Name of the Backend Service for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/backendServices/{backendService}/getEffectiveSecurityPolicies", + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "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" + "getHealth": { + "description": "Gets the most recent health check results for this\nBackendService.\n\nExample request body:\n\n{\n \"group\": \"/zones/us-east1-b/instanceGroups/lb-backend-example\"\n}", + "flatPath": "projects/{project}/global/backendServices/{backendService}/getHealth", + "httpMethod": "POST", + "id": "compute.backendServices.getHealth", + "parameterOrder": [ + "project", + "backendService" + ], + "parameters": { + "backendService": { + "description": "Name of the BackendService resource to which the queried instance belongs.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/backendServices/{backendService}/getHealth", + "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" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "getIamPolicy": { + "description": "Gets the access control policy for a resource. May be empty if no such\npolicy or resource exists.", + "flatPath": "projects/{project}/global/backendServices/{resource}/getIamPolicy", + "httpMethod": "GET", + "id": "compute.backendServices.getIamPolicy", + "parameterOrder": [ + "project", + "resource" + ], + "parameters": { + "optionsRequestedPolicyVersion": { + "description": "Requested IAM Policy version.", + "format": "int32", + "location": "query", + "type": "integer" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "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" - }, - "description": { - "description": "An optional description of this resource. Provide this property when you create the resource.", - "type": "string" - }, - "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" + "path": "projects/{project}/global/backendServices/{resource}/getIamPolicy", + "response": { + "$ref": "Policy" + }, + "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] 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." + "insert": { + "description": "Creates a BackendService resource in the specified project using\nthe data included in the request. For more information, see\nBackend services overview.", + "flatPath": "projects/{project}/global/backendServices", + "httpMethod": "POST", + "id": "compute.backendServices.insert", + "parameterOrder": [ + "project" ], - "enum": [ - "CREATING", - "DELETING", - "FAILED", - "READY", - "RESTORING", - "UNAVAILABLE" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/backendServices", + "request": { + "$ref": "BackendService" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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." + "list": { + "description": "Retrieves the list of BackendService resources available to the specified\nproject.", + "flatPath": "projects/{project}/global/backendServices", + "httpMethod": "GET", + "id": "compute.backendServices.list", + "parameterOrder": [ + "project" ], - "enum": [ - "READ_ONLY_MANY", - "READ_WRITE_MANY", - "READ_WRITE_SINGLE" + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/global/backendServices", + "response": { + "$ref": "BackendServiceList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "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" + "listUsable": { + "description": "Retrieves a list of all usable backend services for Application Load\nBalancers and Proxy Network Load Balancers in the specified project.\nBackend services for external and internal passthrough Network Load\nBalancers are not included in the response.", + "flatPath": "projects/{project}/global/backendServices/listUsable", + "httpMethod": "GET", + "id": "compute.backendServices.listUsable", + "parameterOrder": [ + "project" ], - "enum": [ - "ARCHITECTURE_UNSPECIFIED", - "ARM64", - "X86_64" + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/global/backendServices/listUsable", + "response": { + "$ref": "BackendServiceListUsable" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "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." + "patch": { + "description": "Patches the specified BackendService resource with the data included in the\nrequest. For more information, see \nBackend services overview. This method\nsupports PATCH semantics and uses the JSON merge\npatch format and processing rules.", + "flatPath": "projects/{project}/global/backendServices/{backendService}", + "httpMethod": "PATCH", + "id": "compute.backendServices.patch", + "parameterOrder": [ + "project", + "backendService" ], - "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" - } + "parameters": { + "backendService": { + "description": "Name of the BackendService resource to patch.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/backendServices/{backendService}", + "request": { + "$ref": "BackendService" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" + "setEdgeSecurityPolicy": { + "description": "Sets the edge security policy for the specified backend service.", + "flatPath": "projects/{project}/global/backendServices/{backendService}/setEdgeSecurityPolicy", + "httpMethod": "POST", + "id": "compute.backendServices.setEdgeSecurityPolicy", + "parameterOrder": [ + "project", + "backendService" + ], + "parameters": { + "backendService": { + "description": "Name of the BackendService resource to which the edge security policy\nshould be set. The name should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/backendServices/{backendService}/setEdgeSecurityPolicy", + "request": { + "$ref": "SecurityPolicyReference" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "setIamPolicy": { + "description": "Sets the access control policy on the specified resource.\nReplaces any existing policy.", + "flatPath": "projects/{project}/global/backendServices/{resource}/setIamPolicy", + "httpMethod": "POST", + "id": "compute.backendServices.setIamPolicy", + "parameterOrder": [ + "project", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/backendServices/{resource}/setIamPolicy", + "request": { + "$ref": "GlobalSetPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "setSecurityPolicy": { + "description": "Sets the Google Cloud Armor security policy for the specified backend\nservice. For more information, seeGoogle\nCloud Armor Overview", + "flatPath": "projects/{project}/global/backendServices/{backendService}/setSecurityPolicy", + "httpMethod": "POST", + "id": "compute.backendServices.setSecurityPolicy", + "parameterOrder": [ + "project", + "backendService" + ], + "parameters": { + "backendService": { + "description": "Name of the BackendService resource to which the security policy should be\nset. 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.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" } - } + }, + "path": "projects/{project}/global/backendServices/{backendService}/setSecurityPolicy", + "request": { + "$ref": "SecurityPolicyReference" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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" - } + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource.", + "flatPath": "projects/{project}/global/backendServices/{resource}/testIamPermissions", + "httpMethod": "POST", + "id": "compute.backendServices.testIamPermissions", + "parameterOrder": [ + "project", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/backendServices/{resource}/testIamPermissions", + "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" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "update": { + "description": "Updates the specified BackendService resource with the data included in the\nrequest. For more information, seeBackend\nservices overview.", + "flatPath": "projects/{project}/global/backendServices/{backendService}", + "httpMethod": "PUT", + "id": "compute.backendServices.update", + "parameterOrder": [ + "project", + "backendService" + ], + "parameters": { + "backendService": { + "description": "Name of the BackendService resource to update.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "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" - } - } - }, - "BulkZoneSetLabelsRequest": { - "id": "BulkZoneSetLabelsRequest", - "type": "object", - "properties": { - "requests": { - "type": "array", - "items": { - "$ref": "BulkSetLabelsRequest" - } + }, + "path": "projects/{project}/global/backendServices/{backendService}", + "request": { + "$ref": "BackendService" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] } } }, - "BulkSetLabelsRequest": { - "id": "BulkSetLabelsRequest", - "type": "object", - "properties": { - "labels": { - "description": "The labels to set for this resource.", - "type": "object", - "additionalProperties": { - "type": "string" - } + "crossSiteNetworks": { + "methods": { + "delete": { + "description": "Deletes the specified cross-site network in the given scope.", + "flatPath": "projects/{project}/global/crossSiteNetworks/{crossSiteNetwork}", + "httpMethod": "DELETE", + "id": "compute.crossSiteNetworks.delete", + "parameterOrder": [ + "project", + "crossSiteNetwork" + ], + "parameters": { + "crossSiteNetwork": { + "description": "Name of the cross-site network to delete.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).\nend_interface: MixerMutationRequestBuilder", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/crossSiteNetworks/{crossSiteNetwork}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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 may optionally 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" - }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "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.", + "get": { + "description": "Returns the specified cross-site network in the given scope.", + "flatPath": "projects/{project}/global/crossSiteNetworks/{crossSiteNetwork}", + "httpMethod": "GET", + "id": "compute.crossSiteNetworks.get", + "parameterOrder": [ + "project", + "crossSiteNetwork" + ], + "parameters": { + "crossSiteNetwork": { + "description": "Name of the cross-site network to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "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.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" } - } - } - } - }, - "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" - }, - "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.firewalls.insert", - "compute.firewalls.patch" - ] }, - "type": "string" - }, - "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" - } - } - } - } + "path": "projects/{project}/global/crossSiteNetworks/{crossSiteNetwork}", + "response": { + "$ref": "CrossSiteNetwork" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "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" - } - } + "insert": { + "description": "Creates a cross-site network in the specified project in the given scope\nusing the parameters that are included in the request.", + "flatPath": "projects/{project}/global/crossSiteNetworks", + "httpMethod": "POST", + "id": "compute.crossSiteNetworks.insert", + "parameterOrder": [ + "project" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).\nend_interface: MixerMutationRequestBuilder", + "location": "query", + "type": "string" + }, + "validateOnly": { + "description": "[Input Only] Validate the new configuration, but don't create it.", + "location": "query", + "type": "boolean" } - } + }, + "path": "projects/{project}/global/crossSiteNetworks", + "request": { + "$ref": "CrossSiteNetwork" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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." + "list": { + "description": "Lists the cross-site networks for a project in the given scope.", + "flatPath": "projects/{project}/global/crossSiteNetworks", + "httpMethod": "GET", + "id": "compute.crossSiteNetworks.list", + "parameterOrder": [ + "project" ], - "enum": [ - "EGRESS", - "INGRESS" + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/global/crossSiteNetworks", + "response": { + "$ref": "CrossSiteNetworkList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "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" - }, - "params": { - "description": "Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload.", - "$ref": "FirewallParams" - } - } - }, - "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": [ - "", - "" + "patch": { + "description": "Updates the specified cross-site network with the data included in\nthe request. This method supportsPATCH\nsemantics and uses theJSON merge\npatch format and processing rules.", + "flatPath": "projects/{project}/global/crossSiteNetworks/{crossSiteNetwork}", + "httpMethod": "PATCH", + "id": "compute.crossSiteNetworks.patch", + "parameterOrder": [ + "project", + "crossSiteNetwork" ], - "enum": [ - "EXCLUDE_ALL_METADATA", - "INCLUDE_ALL_METADATA" + "parameters": { + "crossSiteNetwork": { + "description": "Name of the cross-site network to update.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).\nend_interface: MixerMutationRequestBuilder", + "location": "query", + "type": "string" + }, + "updateMask": { + "description": "update_mask indicates fields to be updated as part of this request.", + "format": "google-fieldmask", + "location": "query", + "type": "string" + }, + "validateOnly": { + "description": "[Input Only] Validate the new configuration, but don't update it.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/global/crossSiteNetworks/{crossSiteNetwork}", + "request": { + "$ref": "CrossSiteNetwork" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] } } }, - "FirewallParams": { - "id": "FirewallParams", - "description": "Additional firewall parameters.", - "type": "object", - "properties": { - "resourceManagerTags": { - "description": "Tag keys/values directly bound to this resource. Tag keys and values have the same definition as resource manager tags. The field is allowed for INSERT only. The keys/values to set on the resource should be specified in either ID { : } or Namespaced format { : }. For example the following are valid inputs: * {\"tagKeys/333\" : \"tagValues/444\", \"tagKeys/123\" : \"tagValues/456\"} * {\"123/environment\" : \"production\", \"345/abc\" : \"xyz\"} Note: * Invalid combinations of ID & namespaced format is not supported. For instance: {\"123/environment\" : \"tagValues/444\"} is invalid.", - "type": "object", - "additionalProperties": { - "type": "string" - } - } - } - }, - "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" - }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "diskTypes": { + "methods": { + "aggregatedList": { + "description": "Retrieves an aggregated list of disk types.\n\nTo prevent failure, it is recommended that you set the\n`returnPartialSuccess` parameter to `true`.", + "flatPath": "projects/{project}/aggregated/diskTypes", + "httpMethod": "GET", + "id": "compute.diskTypes.aggregatedList", + "parameterOrder": [ + "project" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "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,\nglobal) should be included in the response. For new resource types added\nafter this field, the flag has no effect as new resource types will always\ninclude every visible scope for each scope type in response. For resource\ntypes which predate this field, if this flag is omitted or false, only\nscopes of the scope types where the resource type is expected to be found\nwill be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`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\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which\naggregated list request is invoked for subnetworks list-usable api.", + "format": "int64", + "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" - } - }, - "packetMirroringRules": { - "description": "A list of packet mirroring rules that belong to this policy.", - "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": [ - "", - "" - ], - "enum": [ - "EGRESS", - "INGRESS" + }, + "path": "projects/{project}/aggregated/diskTypes", + "response": { + "$ref": "DiskTypeAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "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" - } - }, - "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" - } - }, - "srcNetworkType": { - "description": "Network type of the traffic source. Allowed values are: - UNSPECIFIED - INTERNET - INTRA_VPC - NON_INTERNET - VPC_NETWORKS ", - "type": "string", - "enumDescriptions": [ - "", - "", - "", - "", - "" + "get": { + "description": "Returns the specified disk type.", + "flatPath": "projects/{project}/zones/{zone}/diskTypes/{diskType}", + "httpMethod": "GET", + "id": "compute.diskTypes.get", + "parameterOrder": [ + "project", + "zone", + "diskType" ], - "enum": [ - "INTERNET", - "INTRA_VPC", - "NON_INTERNET", - "UNSPECIFIED", - "VPC_NETWORKS" + "parameters": { + "diskType": { + "description": "Name of the disk type to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/diskTypes/{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" ] }, - "srcNetworks": { - "description": "Networks of the traffic source. It can be either a full or partial url.", - "type": "array", - "items": { - "type": "string" - } - }, - "destNetworkType": { - "description": "Network type of the traffic destination. Allowed values are: - UNSPECIFIED - INTERNET - NON_INTERNET ", - "type": "string", - "enumDescriptions": [ - "", - "", - "", - "", - "" + "list": { + "description": "Retrieves a list of disk types available to the specified\nproject.", + "flatPath": "projects/{project}/zones/{zone}/diskTypes", + "httpMethod": "GET", + "id": "compute.diskTypes.list", + "parameterOrder": [ + "project", + "zone" ], - "enum": [ - "INTERNET", - "INTRA_VPC", - "NON_INTERNET", - "UNSPECIFIED", - "VPC_NETWORKS" + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/diskTypes", + "response": { + "$ref": "DiskTypeList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] } } }, - "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": [ - "", - "" + "disks": { + "methods": { + "addResourcePolicies": { + "description": "Adds existing resource policies to a disk. You can only add one\npolicy which will be applied to this disk for scheduling snapshot\ncreation.", + "flatPath": "projects/{project}/zones/{zone}/disks/{disk}/addResourcePolicies", + "httpMethod": "POST", + "id": "compute.disks.addResourcePolicies", + "parameterOrder": [ + "project", + "zone", + "disk" ], - "enum": [ - "EFFECTIVE", - "INEFFECTIVE" + "parameters": { + "disk": { + "description": "The disk name for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/disks/{disk}/addResourcePolicies", + "request": { + "$ref": "DisksAddResourcePoliciesRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] - } - } - }, - "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" - } - } - } - }, - "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" - } - }, - "etag": { - "description": "Flatten Policy to create a backward compatible wire-format. Deprecated. Use 'policy' to specify the etag.", - "type": "string", - "format": "byte" - } - } - }, - "NetworkFirewallPolicyAggregatedList": { - "id": "NetworkFirewallPolicyAggregatedList", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always compute#networkFirewallPoliciesAggregatedList for lists of network firewall policies.", - "default": "compute#networkFirewallPolicyAggregatedList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of FirewallPoliciesScopedList resources.", - "type": "object", - "additionalProperties": { - "description": "Name of the scope containing this set of addresses.", - "$ref": "FirewallPoliciesScopedList" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the 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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "aggregatedList": { + "description": "Retrieves an aggregated list of persistent disks.\n\nTo prevent failure, it is recommended that you set the\n`returnPartialSuccess` parameter to `true`.", + "flatPath": "projects/{project}/aggregated/disks", + "httpMethod": "GET", + "id": "compute.disks.aggregatedList", + "parameterOrder": [ + "project" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "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,\nglobal) should be included in the response. For new resource types added\nafter this field, the flag has no effect as new resource types will always\ninclude every visible scope for each scope type in response. For resource\ntypes which predate this field, if this flag is omitted or false, only\nscopes of the scope types where the resource type is expected to be found\nwill be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`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\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which\naggregated list request is invoked for subnetworks list-usable api.", + "format": "int64", + "location": "query", + "type": "string" } - } - }, - "unreachables": { - "description": "[Output Only] Unreachable resources.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "FirewallPoliciesScopedList": { - "id": "FirewallPoliciesScopedList", - "type": "object", - "properties": { - "firewallPolicies": { - "description": "A list of firewall policies contained in this scope.", - "type": "array", - "items": { - "$ref": "FirewallPolicy" - } + }, + "path": "projects/{project}/aggregated/disks", + "response": { + "$ref": "DiskAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "warning": { - "description": "Informational warning which replaces the list of firewall 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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "bulkInsert": { + "description": "Bulk create a set of disks.", + "flatPath": "projects/{project}/zones/{zone}/disks/bulkInsert", + "httpMethod": "POST", + "id": "compute.disks.bulkInsert", + "parameterOrder": [ + "project", + "zone" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" } - } - } - } - }, - "RegionNetworkFirewallPoliciesGetEffectiveFirewallsResponse": { - "id": "RegionNetworkFirewallPoliciesGetEffectiveFirewallsResponse", - "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 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" + }, + "path": "projects/{project}/zones/{zone}/disks/bulkInsert", + "request": { + "$ref": "BulkInsertDiskResource" + }, + "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": [ - "", - "", - "", - "", - "", - "" + "bulkSetLabels": { + "description": "Sets the labels on many disks at once. To learn more about labels, read theLabeling\nResources documentation.", + "flatPath": "projects/{project}/zones/{zone}/disks/bulkSetLabels", + "httpMethod": "POST", + "id": "compute.disks.bulkSetLabels", + "parameterOrder": [ + "project", + "zone" ], - "enum": [ - "HIERARCHY", - "NETWORK", - "NETWORK_REGIONAL", - "SYSTEM_GLOBAL", - "SYSTEM_REGIONAL", - "UNSPECIFIED" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "query", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/disks/bulkSetLabels", + "request": { + "$ref": "BulkZoneSetLabelsRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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" - } - }, - "packetMirroringRules": { - "description": "[Output only] The packet mirroring 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" - } - } - }, - "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" + "createSnapshot": { + "description": "Creates a snapshot of a specified persistent disk. For regular snapshot\ncreation, consider using snapshots.insert\ninstead, as that method supports more features, such as creating snapshots\nin a project different from the source disk project.", + "flatPath": "projects/{project}/zones/{zone}/disks/{disk}/createSnapshot", + "httpMethod": "POST", + "id": "compute.disks.createSnapshot", + "parameterOrder": [ + "project", + "zone", + "disk" + ], + "parameters": { + "disk": { + "description": "Name of the persistent disk to snapshot.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "guestFlush": { + "description": "[Input Only] Whether to attempt an application consistent snapshot by\ninforming the OS to prepare for the snapshot process.", + "location": "query", + "type": "boolean" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/disks/{disk}/createSnapshot", + "request": { + "$ref": "Snapshot" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "delete": { + "description": "Deletes the specified persistent disk. Deleting a disk removes its data\npermanently and is irreversible. However, deleting a disk does not\ndelete any snapshots\npreviously made from the disk. You must separatelydelete\nsnapshots.", + "flatPath": "projects/{project}/zones/{zone}/disks/{disk}", + "httpMethod": "DELETE", + "id": "compute.disks.delete", + "parameterOrder": [ + "project", + "zone", + "disk" + ], + "parameters": { + "disk": { + "description": "Name of the persistent disk to delete.", + "location": "path", + "pattern": "\\S{1,66}", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" } - } - } - } - }, - "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" + }, + "path": "projects/{project}/zones/{zone}/disks/{disk}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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": { + "description": "Returns the specified persistent disk.", + "flatPath": "projects/{project}/zones/{zone}/disks/{disk}", + "httpMethod": "GET", + "id": "compute.disks.get", + "parameterOrder": [ + "project", + "zone", + "disk" ], - "enum": [ - "CLOUD_ARMOR", - "CLOUD_ARMOR_EDGE", - "CLOUD_ARMOR_NETWORK" + "parameters": { + "disk": { + "description": "Name of the persistent disk to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/disks/{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" ] }, - "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 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" - }, - "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" - }, - "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": [ - "", - "", - "", - "" + "getIamPolicy": { + "description": "Gets the access control policy for a resource. May be empty if no such\npolicy or resource exists.", + "flatPath": "projects/{project}/zones/{zone}/disks/{resource}/getIamPolicy", + "httpMethod": "GET", + "id": "compute.disks.getIamPolicy", + "parameterOrder": [ + "project", + "zone", + "resource" ], - "enum": [ - "IPV4", - "IPV6", - "TCP", - "UDP" + "parameters": { + "optionsRequestedPolicyVersion": { + "description": "Requested IAM Policy version.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/disks/{resource}/getIamPolicy", + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "offset": { - "description": "Offset of the first byte of the field (in network byte order) relative to 'base'.", - "type": "integer", - "format": "int32" - }, - "size": { - "description": "Size of the field in bytes. Valid values: 1-4.", - "type": "integer", - "format": "int32" - }, - "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" - }, - "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": "SecurityPolicyRuleMatcher" - }, - "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" - }, - "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" - }, - "exprOptions": { - "description": "The configuration options available when specifying a user defined CEVAL expression (i.e., 'expr').", - "$ref": "SecurityPolicyRuleMatcherExprOptions" + "insert": { + "description": "Creates a persistent disk in the specified project using the data\nin the request. You can create a disk from a source\n(sourceImage, sourceSnapshot, orsourceDisk) or create an empty 500 GB data disk by\nomitting all properties. You can also create a disk that is larger than\nthe default size by specifying the sizeGb property.", + "flatPath": "projects/{project}/zones/{zone}/disks", + "httpMethod": "POST", + "id": "compute.disks.insert", + "parameterOrder": [ + "project", + "zone" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/disks", + "request": { + "$ref": "Disk" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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." + "list": { + "description": "Retrieves a list of persistent disks contained within\nthe specified zone.", + "flatPath": "projects/{project}/zones/{zone}/disks", + "httpMethod": "GET", + "id": "compute.disks.list", + "parameterOrder": [ + "project", + "zone" ], - "enum": [ - "SRC_IPS_V1" + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/disks", + "response": { + "$ref": "DiskList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "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" - } + "removeResourcePolicies": { + "description": "Removes resource policies from a disk.", + "flatPath": "projects/{project}/zones/{zone}/disks/{disk}/removeResourcePolicies", + "httpMethod": "POST", + "id": "compute.disks.removeResourcePolicies", + "parameterOrder": [ + "project", + "zone", + "disk" + ], + "parameters": { + "disk": { + "description": "The disk name for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/disks/{disk}/removeResourcePolicies", + "request": { + "$ref": "DisksRemoveResourcePoliciesRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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" - } - }, - "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. - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the key type defaults to ALL. ", - "type": "string", - "enumDescriptions": [ - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "" + "resize": { + "description": "Resizes the specified persistent disk.\nYou can only increase the size of the disk.", + "flatPath": "projects/{project}/zones/{zone}/disks/{disk}/resize", + "httpMethod": "POST", + "id": "compute.disks.resize", + "parameterOrder": [ + "project", + "zone", + "disk" ], - "enum": [ - "ALL", - "HTTP_COOKIE", - "HTTP_HEADER", - "HTTP_PATH", - "IP", - "REGION_CODE", - "SNI", - "TLS_JA3_FINGERPRINT", - "TLS_JA4_FINGERPRINT", - "USER_IP", - "XFF_IP" + "parameters": { + "disk": { + "description": "The name of the persistent disk.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/disks/{disk}/resize", + "request": { + "$ref": "DisksResizeRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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" - }, - "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": [ - "", - "" + "setIamPolicy": { + "description": "Sets the access control policy on the specified resource.\nReplaces any existing policy.", + "flatPath": "projects/{project}/zones/{zone}/disks/{resource}/setIamPolicy", + "httpMethod": "POST", + "id": "compute.disks.setIamPolicy", + "parameterOrder": [ + "project", + "zone", + "resource" ], - "enum": [ - "EXTERNAL_302", - "GOOGLE_RECAPTCHA" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/disks/{resource}/setIamPolicy", + "request": { + "$ref": "ZoneSetPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "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. - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the key type defaults to ALL. ", - "type": "string", - "enumDescriptions": [ - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "" + "setLabels": { + "description": "Sets the labels on a disk. To learn more about labels, read theLabeling\nResources documentation.", + "flatPath": "projects/{project}/zones/{zone}/disks/{resource}/setLabels", + "httpMethod": "POST", + "id": "compute.disks.setLabels", + "parameterOrder": [ + "project", + "zone", + "resource" ], - "enum": [ - "ALL", - "HTTP_COOKIE", - "HTTP_HEADER", - "HTTP_PATH", - "IP", - "REGION_CODE", - "SNI", - "TLS_JA3_FINGERPRINT", - "TLS_JA4_FINGERPRINT", - "USER_IP", - "XFF_IP" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/disks/{resource}/setLabels", + "request": { + "$ref": "ZoneSetLabelsRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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" - }, - "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." + "startAsyncReplication": { + "description": "Starts asynchronous replication.\nMust be invoked on the primary disk.", + "flatPath": "projects/{project}/zones/{zone}/disks/{disk}/startAsyncReplication", + "httpMethod": "POST", + "id": "compute.disks.startAsyncReplication", + "parameterOrder": [ + "project", + "zone", + "disk" ], - "enum": [ - "CONTAINS", - "ENDS_WITH", - "EQUALS", - "EQUALS_ANY", - "STARTS_WITH" + "parameters": { + "disk": { + "description": "The name of the persistent disk.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/disks/{disk}/startAsyncReplication", + "request": { + "$ref": "DisksStartAsyncReplicationRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] - } - } - }, - "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": [ - "", - "" + "stopAsyncReplication": { + "description": "Stops asynchronous replication.\nCan be invoked either on the primary or on the secondary disk.", + "flatPath": "projects/{project}/zones/{zone}/disks/{disk}/stopAsyncReplication", + "httpMethod": "POST", + "id": "compute.disks.stopAsyncReplication", + "parameterOrder": [ + "project", + "zone", + "disk" ], - "enum": [ - "PREMIUM", - "STANDARD" + "parameters": { + "disk": { + "description": "The name of the persistent disk.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/disks/{disk}/stopAsyncReplication", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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" + "stopGroupAsyncReplication": { + "description": "Stops asynchronous replication for a consistency group of disks.\nCan be invoked either in the primary or secondary scope.", + "flatPath": "projects/{project}/zones/{zone}/disks/stopGroupAsyncReplication", + "httpMethod": "POST", + "id": "compute.disks.stopGroupAsyncReplication", + "parameterOrder": [ + "project", + "zone" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(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\nor secondary disks in the consistency group.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/disks/stopGroupAsyncReplication", + "request": { + "$ref": "DisksStopGroupAsyncReplicationResource" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "detectionAbsoluteQps": { - "type": "number", - "format": "float" + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource.", + "flatPath": "projects/{project}/zones/{zone}/disks/{resource}/testIamPermissions", + "httpMethod": "POST", + "id": "compute.disks.testIamPermissions", + "parameterOrder": [ + "project", + "zone", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/disks/{resource}/testIamPermissions", + "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" + ] }, - "detectionRelativeToBaselineQps": { - "type": "number", - "format": "float" + "update": { + "description": "Updates the specified disk with the data included in the request.\nThe update is performed only on selected fields included as part\nof update-mask.", + "flatPath": "projects/{project}/zones/{zone}/disks/{disk}", + "httpMethod": "PATCH", + "id": "compute.disks.update", + "parameterOrder": [ + "project", + "zone", + "disk" + ], + "parameters": { + "disk": { + "description": "The disk name for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "paths": { + "location": "query", + "repeated": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "updateMask": { + "description": "update_mask indicates fields to be updated as part of this request.", + "format": "google-fieldmask", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/disks/{disk}", + "request": { + "$ref": "Disk" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "trafficGranularityConfigs": { - "description": "Configuration options for enabling Adaptive Protection to operate on specified granular traffic units.", - "type": "array", - "items": { - "$ref": "SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfigThresholdConfigTrafficGranularityConfig" - } + "updateKmsKey": { + "description": "Rotates the customer-managed\nencryption key to the latest version for the specified persistent disk.", + "flatPath": "projects/{project}/zones/{zone}/disks/{disk}/updateKmsKey", + "httpMethod": "POST", + "id": "compute.disks.updateKmsKey", + "parameterOrder": [ + "project", + "zone", + "disk" + ], + "parameters": { + "disk": { + "description": "Name of the Disk resource, should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/disks/{disk}/updateKmsKey", + "request": { + "$ref": "DiskUpdateKmsKeyRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] } } }, - "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": [ - "", - "", - "" + "externalVpnGateways": { + "methods": { + "delete": { + "description": "Deletes the specified externalVpnGateway.", + "flatPath": "projects/{project}/global/externalVpnGateways/{externalVpnGateway}", + "httpMethod": "DELETE", + "id": "compute.externalVpnGateways.delete", + "parameterOrder": [ + "project", + "externalVpnGateway" ], - "enum": [ - "HTTP_HEADER_HOST", - "HTTP_PATH", - "UNSPECIFIED_TYPE" + "parameters": { + "externalVpnGateway": { + "description": "Name of the externalVpnGateways to delete.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/externalVpnGateways/{externalVpnGateway}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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": [ - "", - "", - "" + "get": { + "description": "Returns the specified externalVpnGateway. Get a list of available\nexternalVpnGateways by making a list() request.", + "flatPath": "projects/{project}/global/externalVpnGateways/{externalVpnGateway}", + "httpMethod": "GET", + "id": "compute.externalVpnGateways.get", + "parameterOrder": [ + "project", + "externalVpnGateway" ], - "enum": [ - "ADVANCED", - "ADVANCED_PREVIEW", - "STANDARD" + "parameters": { + "externalVpnGateway": { + "description": "Name of the externalVpnGateway to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/externalVpnGateways/{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" ] - } - } - }, - "SecurityPolicyAdvancedOptionsConfig": { - "id": "SecurityPolicyAdvancedOptionsConfig", - "type": "object", - "properties": { - "jsonParsing": { - "type": "string", - "enumDescriptions": [ - "", - "", - "" + }, + "insert": { + "description": "Creates a ExternalVpnGateway in the specified project using\nthe data included in the request.", + "flatPath": "projects/{project}/global/externalVpnGateways", + "httpMethod": "POST", + "id": "compute.externalVpnGateways.insert", + "parameterOrder": [ + "project" ], - "enum": [ - "DISABLED", - "STANDARD", - "STANDARD_WITH_GRAPHQL" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/externalVpnGateways", + "request": { + "$ref": "ExternalVpnGateway" + }, + "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" + "list": { + "description": "Retrieves the list of ExternalVpnGateway available to the specified\nproject.", + "flatPath": "projects/{project}/global/externalVpnGateways", + "httpMethod": "GET", + "id": "compute.externalVpnGateways.list", + "parameterOrder": [ + "project" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/global/externalVpnGateways", + "response": { + "$ref": "ExternalVpnGatewayList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "logLevel": { - "type": "string", - "enumDescriptions": [ - "", - "" + "setLabels": { + "description": "Sets the labels on an ExternalVpnGateway. To learn more about labels,\nread the Labeling\nResources documentation.", + "flatPath": "projects/{project}/global/externalVpnGateways/{resource}/setLabels", + "httpMethod": "POST", + "id": "compute.externalVpnGateways.setLabels", + "parameterOrder": [ + "project", + "resource" ], - "enum": [ - "NORMAL", - "VERBOSE" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/externalVpnGateways/{resource}/setLabels", + "request": { + "$ref": "GlobalSetLabelsRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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" - } + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource.", + "flatPath": "projects/{project}/global/externalVpnGateways/{resource}/testIamPermissions", + "httpMethod": "POST", + "id": "compute.externalVpnGateways.testIamPermissions", + "parameterOrder": [ + "project", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/externalVpnGateways/{resource}/testIamPermissions", + "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" + ] } } }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "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.", + "firewallPolicies": { + "methods": { + "addAssociation": { + "description": "Inserts an association for the specified firewall policy.", + "flatPath": "locations/global/firewallPolicies/{firewallPolicy}/addAssociation", + "httpMethod": "POST", + "id": "compute.firewallPolicies.addAssociation", + "parameterOrder": [ + "firewallPolicy" + ], + "parameters": { + "firewallPolicy": { + "description": "Name of the firewall policy to update.", + "location": "path", + "pattern": "(firewallPolicies/)?[0-9]{0,20}", + "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" - } - } - } + "replaceExistingAssociation": { + "description": "Indicates whether or not to replace it if an association of the attachment\nalready exists. This is false by default, in which case an error will be\nreturned if an association already exists.", + "location": "query", + "type": "boolean" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "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" - } + }, + "path": "locations/global/firewallPolicies/{firewallPolicy}/addAssociation", + "request": { + "$ref": "FirewallPolicyAssociation" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "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.", + "addRule": { + "description": "Inserts a rule into a firewall policy.", + "flatPath": "locations/global/firewallPolicies/{firewallPolicy}/addRule", + "httpMethod": "POST", + "id": "compute.firewallPolicies.addRule", + "parameterOrder": [ + "firewallPolicy" + ], + "parameters": { + "firewallPolicy": { + "description": "Name of the firewall policy to update.", + "location": "path", + "pattern": "(firewallPolicies/)?[0-9]{0,20}", + "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(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" + }, + "path": "locations/global/firewallPolicies/{firewallPolicy}/addRule", + "request": { + "$ref": "FirewallPolicyRule" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "cloneRules": { + "description": "Copies rules to the specified firewall policy.", + "flatPath": "locations/global/firewallPolicies/{firewallPolicy}/cloneRules", + "httpMethod": "POST", + "id": "compute.firewallPolicies.cloneRules", + "parameterOrder": [ + "firewallPolicy" + ], + "parameters": { + "firewallPolicy": { + "description": "Name of the firewall policy to update.", + "location": "path", + "pattern": "(firewallPolicies/)?[0-9]{0,20}", + "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(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" - } - } - } + "sourceFirewallPolicy": { + "description": "The firewall policy from which to copy rules.", + "location": "query", + "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)." - ], - "enum": [ - "DEPROVISIONING", - "PROVISIONING", - "REPAIRING", - "RUNNING", - "STAGING", - "STOPPED", - "STOPPING", - "SUSPENDED", - "SUSPENDING", - "TERMINATED" + "path": "locations/global/firewallPolicies/{firewallPolicy}/cloneRules", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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 metadata keys that were explicitly defined for the instance.", - "$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" - }, - "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." + "delete": { + "description": "Deletes the specified policy.", + "flatPath": "locations/global/firewallPolicies/{firewallPolicy}", + "httpMethod": "DELETE", + "id": "compute.firewallPolicies.delete", + "parameterOrder": [ + "firewallPolicy" ], - "enum": [ - "ENABLE_BIDIRECTIONAL_ACCESS_TO_GOOGLE", - "ENABLE_OUTBOUND_VM_ACCESS_TO_GOOGLE", - "INHERIT_FROM_SUBNETWORK" + "parameters": { + "firewallPolicy": { + "description": "Name of the firewall policy to delete.", + "location": "path", + "pattern": "(firewallPolicies/)?[0-9]{0,20}", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "locations/global/firewallPolicies/{firewallPolicy}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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." + "get": { + "description": "Returns the specified firewall policy.", + "flatPath": "locations/global/firewallPolicies/{firewallPolicy}", + "httpMethod": "GET", + "id": "compute.firewallPolicies.get", + "parameterOrder": [ + "firewallPolicy" ], - "enum": [ - "KEY_REVOCATION_ACTION_TYPE_UNSPECIFIED", - "NONE", - "STOP" + "parameters": { + "firewallPolicy": { + "description": "Name of the firewall policy to get.", + "location": "path", + "pattern": "(firewallPolicies/)?[0-9]{0,20}", + "required": true, + "type": "string" + } + }, + "path": "locations/global/firewallPolicies/{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" ] - } - } - }, - "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" - }, - "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." + "getAssociation": { + "description": "Gets an association with the specified name.", + "flatPath": "locations/global/firewallPolicies/{firewallPolicy}/getAssociation", + "httpMethod": "GET", + "id": "compute.firewallPolicies.getAssociation", + "parameterOrder": [ + "firewallPolicy" ], - "enum": [ - "IPV4_IPV6", - "IPV4_ONLY", - "IPV6_ONLY" + "parameters": { + "firewallPolicy": { + "description": "Name of the firewall policy to which the queried rule belongs.", + "location": "path", + "pattern": "(firewallPolicies/)?[0-9]{0,20}", + "required": true, + "type": "string" + }, + "name": { + "description": "The name of the association to get from the firewall policy.", + "location": "query", + "type": "string" + } + }, + "path": "locations/global/firewallPolicies/{firewallPolicy}/getAssociation", + "response": { + "$ref": "FirewallPolicyAssociation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "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." + "getIamPolicy": { + "description": "Gets the access control policy for a resource. May be empty if no such\npolicy or resource exists.", + "flatPath": "locations/global/firewallPolicies/{resource}/getIamPolicy", + "httpMethod": "GET", + "id": "compute.firewallPolicies.getIamPolicy", + "parameterOrder": [ + "resource" ], - "enum": [ - "EXTERNAL", - "INTERNAL" + "parameters": { + "optionsRequestedPolicyVersion": { + "description": "Requested IAM Policy version.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "(firewallPolicies/)?[0-9]{0,20}", + "required": true, + "type": "string" + } + }, + "path": "locations/global/firewallPolicies/{resource}/getIamPolicy", + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "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", - "IRDMA", - "MRDMA", - "No type specified.", - "VIRTIO" + "getRule": { + "description": "Gets a rule of the specified priority.", + "flatPath": "locations/global/firewallPolicies/{firewallPolicy}/getRule", + "httpMethod": "GET", + "id": "compute.firewallPolicies.getRule", + "parameterOrder": [ + "firewallPolicy" ], - "enum": [ - "GVNIC", - "IDPF", - "IRDMA", - "MRDMA", - "UNSPECIFIED_NIC_TYPE", - "VIRTIO_NET" + "parameters": { + "firewallPolicy": { + "description": "Name of the firewall policy to which the queried rule belongs.", + "location": "path", + "pattern": "(firewallPolicies/)?[0-9]{0,20}", + "required": true, + "type": "string" + }, + "priority": { + "description": "The priority of the rule to get from the firewall policy.", + "format": "int32", + "location": "query", + "type": "integer" + } + }, + "path": "locations/global/firewallPolicies/{firewallPolicy}/getRule", + "response": { + "$ref": "FirewallPolicyRule" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "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": [ - "", - "" - ], - "enum": [ - "DIRECT_IPV6", - "ONE_TO_ONE_NAT" + "insert": { + "description": "Creates a new policy in the specified project using the data included in\nthe request.", + "flatPath": "locations/global/firewallPolicies", + "httpMethod": "POST", + "id": "compute.firewallPolicies.insert", + "parameters": { + "parentId": { + "description": "Parent ID for this request. The ID can be either be \"folders/[FOLDER_ID]\"\nif the parent is a folder or \"organizations/[ORGANIZATION_ID]\" if the\nparent is an organization.", + "location": "query", + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "locations/global/firewallPolicies", + "request": { + "$ref": "FirewallPolicy" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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." - ], - "enum": [ - "FIXED_STANDARD", - "PREMIUM", - "STANDARD", - "STANDARD_OVERRIDES_FIXED_STANDARD" + "list": { + "description": "Lists all the policies that have been configured for the specified\nfolder or organization.", + "flatPath": "locations/global/firewallPolicies", + "httpMethod": "GET", + "id": "compute.firewallPolicies.list", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "parentId": { + "description": "Parent ID for this request. The ID can be either be \"folders/[FOLDER_ID]\"\nif the parent is a folder or \"organizations/[ORGANIZATION_ID]\" if the\nparent is an organization.", + "location": "query", + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "locations/global/firewallPolicies", + "response": { + "$ref": "FirewallPolicyList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "securityPolicy": { - "description": "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": [ - "", - "" - ], - "enum": [ - "PERSISTENT", - "SCRATCH" + "listAssociations": { + "description": "Lists associations of a specified target, i.e., organization or folder.", + "flatPath": "locations/global/firewallPolicies/listAssociations", + "httpMethod": "GET", + "id": "compute.firewallPolicies.listAssociations", + "parameters": { + "includeInheritedPolicies": { + "description": "If set to \"true\", the response will contain a list of all associations for\nthe containing folders and the containing organization of the target. The\nparameter has no effect if the target is an organization.", + "location": "query", + "type": "boolean" + }, + "targetResource": { + "description": "The target resource to list associations. It is an organization, or a\nfolder.", + "location": "query", + "type": "string" + } + }, + "path": "locations/global/firewallPolicies/listAssociations", + "response": { + "$ref": "FirewallPoliciesListAssociationsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "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." + "move": { + "description": "Moves the specified firewall policy.", + "flatPath": "locations/global/firewallPolicies/{firewallPolicy}/move", + "httpMethod": "POST", + "id": "compute.firewallPolicies.move", + "parameterOrder": [ + "firewallPolicy" ], - "enum": [ - "READ_ONLY", - "READ_WRITE" + "parameters": { + "firewallPolicy": { + "description": "Name of the firewall policy to update.", + "location": "path", + "pattern": "(firewallPolicies/)?[0-9]{0,20}", + "required": true, + "type": "string" + }, + "parentId": { + "description": "The new parent of the firewall policy. The ID can be either be\n\"folders/[FOLDER_ID]\" if the parent is a folder or\n\"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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "locations/global/firewallPolicies/{firewallPolicy}/move", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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." + "patch": { + "description": "Patches the specified policy with the data included in the request.", + "flatPath": "locations/global/firewallPolicies/{firewallPolicy}", + "httpMethod": "PATCH", + "id": "compute.firewallPolicies.patch", + "parameterOrder": [ + "firewallPolicy" ], - "enum": [ - "DISK_SAVED_STATE_UNSPECIFIED", - "PRESERVED" + "parameters": { + "firewallPolicy": { + "description": "Name of the firewall policy to update.", + "location": "path", + "pattern": "(firewallPolicies/)?[0-9]{0,20}", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "locations/global/firewallPolicies/{firewallPolicy}", + "request": { + "$ref": "FirewallPolicy" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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": [ - "", - "" + "patchRule": { + "description": "Patches a rule of the specified priority.", + "flatPath": "locations/global/firewallPolicies/{firewallPolicy}/patchRule", + "httpMethod": "POST", + "id": "compute.firewallPolicies.patchRule", + "parameterOrder": [ + "firewallPolicy" ], - "enum": [ - "NVME", - "SCSI" + "parameters": { + "firewallPolicy": { + "description": "Name of the firewall policy to update.", + "location": "path", + "pattern": "(firewallPolicies/)?[0-9]{0,20}", + "required": true, + "type": "string" + }, + "priority": { + "description": "The priority of the rule to patch.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "locations/global/firewallPolicies/{firewallPolicy}/patchRule", + "request": { + "$ref": "FirewallPolicyRule" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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" + "removeAssociation": { + "description": "Removes an association for the specified firewall policy.", + "flatPath": "locations/global/firewallPolicies/{firewallPolicy}/removeAssociation", + "httpMethod": "POST", + "id": "compute.firewallPolicies.removeAssociation", + "parameterOrder": [ + "firewallPolicy" ], - "enum": [ - "ARCHITECTURE_UNSPECIFIED", - "ARM64", - "X86_64" + "parameters": { + "firewallPolicy": { + "description": "Name of the firewall policy to update.", + "location": "path", + "pattern": "(firewallPolicies/)?[0-9]{0,20}", + "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "locations/global/firewallPolicies/{firewallPolicy}/removeAssociation", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] - } - } - }, - "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" - }, - "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. Note: You cannot create VMs in bulk using a snapshot as the source. Use an image instead when you create VMs using the bulk insert method.", - "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." + "removeRule": { + "description": "Deletes a rule of the specified priority.", + "flatPath": "locations/global/firewallPolicies/{firewallPolicy}/removeRule", + "httpMethod": "POST", + "id": "compute.firewallPolicies.removeRule", + "parameterOrder": [ + "firewallPolicy" ], - "enum": [ - "RECREATE_DISK", - "RECREATE_DISK_IF_SOURCE_CHANGED", - "USE_EXISTING_DISK" + "parameters": { + "firewallPolicy": { + "description": "Name of the firewall policy to update.", + "location": "path", + "pattern": "(firewallPolicies/)?[0-9]{0,20}", + "required": true, + "type": "string" + }, + "priority": { + "description": "The priority of the rule to remove from the firewall policy.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "locations/global/firewallPolicies/{firewallPolicy}/removeRule", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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" + "setIamPolicy": { + "description": "Sets the access control policy on the specified resource.\nReplaces any existing policy.", + "flatPath": "locations/global/firewallPolicies/{resource}/setIamPolicy", + "httpMethod": "POST", + "id": "compute.firewallPolicies.setIamPolicy", + "parameterOrder": [ + "resource" ], - "enum": [ - "ARCHITECTURE_UNSPECIFIED", - "ARM64", - "X86_64" + "parameters": { + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "(firewallPolicies/)?[0-9]{0,20}", + "required": true, + "type": "string" + } + }, + "path": "locations/global/firewallPolicies/{resource}/setIamPolicy", + "request": { + "$ref": "GlobalOrganizationSetPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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" - }, - "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" - } + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource.", + "flatPath": "locations/global/firewallPolicies/{resource}/testIamPermissions", + "httpMethod": "POST", + "id": "compute.firewallPolicies.testIamPermissions", + "parameterOrder": [ + "resource" + ], + "parameters": { + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "(firewallPolicies/)?[0-9]{0,20}", + "required": true, + "type": "string" } - } - } - } - }, - "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" - } + }, + "path": "locations/global/firewallPolicies/{resource}/testIamPermissions", + "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" + ] } } }, - "Scheduling": { - "id": "Scheduling", - "description": "Sets the scheduling options for an Instance.", - "type": "object", - "properties": { - "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" - }, - "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." + "firewalls": { + "methods": { + "delete": { + "description": "Deletes the specified firewall.", + "flatPath": "projects/{project}/global/firewalls/{firewall}", + "httpMethod": "DELETE", + "id": "compute.firewalls.delete", + "parameterOrder": [ + "project", + "firewall" ], - "enum": [ - "MIGRATE", - "TERMINATE" + "parameters": { + "firewall": { + "description": "Name of the firewall rule to delete.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/firewalls/{firewall}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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": [ - "Bound to the lifecycle of the reservation in which it is provisioned.", - "Heavily discounted, no guaranteed runtime.", - "Standard provisioning with user controlled runtime, no discounts." + "get": { + "description": "Returns the specified firewall.", + "flatPath": "projects/{project}/global/firewalls/{firewall}", + "httpMethod": "GET", + "id": "compute.firewalls.get", + "parameterOrder": [ + "project", + "firewall" ], - "enum": [ - "RESERVATION_BOUND", - "SPOT", - "STANDARD" + "parameters": { + "firewall": { + "description": "Name of the firewall rule to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/firewalls/{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" ] }, - "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." + "insert": { + "description": "Creates a firewall rule in the specified project using the data\nincluded in the request.", + "flatPath": "projects/{project}/global/firewalls", + "httpMethod": "POST", + "id": "compute.firewalls.insert", + "parameterOrder": [ + "project" ], - "enum": [ - "DELETE", - "INSTANCE_TERMINATION_ACTION_UNSPECIFIED", - "STOP" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/firewalls", + "request": { + "$ref": "Firewall" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "hostErrorTimeoutSeconds": { - "description": "Specify the time in seconds for host error detection, the value must be within the range of [90, 330] with the increment of 30, if unset, the default behavior of host error recovery will be used.", - "type": "integer", - "format": "int32" - }, - "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" - } - } - }, - "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" - } - } - }, - "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.", - "" + "list": { + "description": "Retrieves the list of firewall rules available to the specified\nproject.", + "flatPath": "projects/{project}/global/firewalls", + "httpMethod": "GET", + "id": "compute.firewalls.list", + "parameterOrder": [ + "project" ], - "enum": [ - "IN", - "NOT_IN", - "OPERATOR_UNSPECIFIED" + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/global/firewalls", + "response": { + "$ref": "FirewallList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "values": { - "description": "Corresponds to the label values of Node resource.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "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.", - "" + "patch": { + "description": "Updates the specified firewall rule with the data included in the\nrequest. This method supportsPATCH\nsemantics and uses theJSON merge\npatch format and processing rules.", + "flatPath": "projects/{project}/global/firewalls/{firewall}", + "httpMethod": "PATCH", + "id": "compute.firewalls.patch", + "parameterOrder": [ + "project", + "firewall" ], - "enum": [ - "ANY_RESERVATION", - "NO_RESERVATION", - "SPECIFIC_RESERVATION", - "UNSPECIFIED" + "parameters": { + "firewall": { + "description": "Name of the firewall rule to patch.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/firewalls/{firewall}", + "request": { + "$ref": "Firewall" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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." + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource.", + "flatPath": "projects/{project}/global/firewalls/{resource}/testIamPermissions", + "httpMethod": "POST", + "id": "compute.firewalls.testIamPermissions", + "parameterOrder": [ + "project", + "resource" ], - "enum": [ - "CONFIDENTIAL_INSTANCE_TYPE_UNSPECIFIED", - "SEV", - "SEV_SNP", - "TDX" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/firewalls/{resource}/testIamPermissions", + "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" ] - } - } - }, - "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" }, - "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." + "update": { + "description": "Updates the specified firewall rule with the data included in the\nrequest.\nNote that all fields will be updated if using PUT, even fields that are not\nspecified. To update individual fields, please use PATCH instead.", + "flatPath": "projects/{project}/global/firewalls/{firewall}", + "httpMethod": "PUT", + "id": "compute.firewalls.update", + "parameterOrder": [ + "project", + "firewall" ], - "enum": [ - "ARCHITECTURAL", - "ENHANCED", - "PERFORMANCE_MONITORING_UNIT_UNSPECIFIED", - "STANDARD" + "parameters": { + "firewall": { + "description": "Name of the firewall rule to update.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/firewalls/{firewall}", + "request": { + "$ref": "Firewall" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] - }, - "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] The precise location of your instance within the zone's data center, including the block, sub-block, and host. The field is formatted as follows: blockId/subBlockId/hostId.", - "type": "string" - }, - "physicalHostTopology": { - "description": "[Output Only] A series of fields containing the global name of the Compute Engine cluster, as well as the ID of the block, sub-block, and host on which the running instance is located.", - "$ref": "ResourceStatusPhysicalHostTopology" - } - } - }, - "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)." + "forwardingRules": { + "methods": { + "aggregatedList": { + "description": "Retrieves an aggregated list of forwarding rules.\n\nTo prevent failure, it is recommended that you set the\n`returnPartialSuccess` parameter to `true`.", + "flatPath": "projects/{project}/aggregated/forwardingRules", + "httpMethod": "GET", + "id": "compute.forwardingRules.aggregatedList", + "parameterOrder": [ + "project" ], - "enum": [ - "SCHEDULED", - "UNKNOWN_TYPE", - "UNSCHEDULED" + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region,\nglobal) should be included in the response. For new resource types added\nafter this field, the flag has no effect as new resource types will always\ninclude every visible scope for each scope type in response. For resource\ntypes which predate this field, if this flag is omitted or false, only\nscopes of the scope types where the resource type is expected to be found\nwill be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which\naggregated list request is invoked for subnetworks list-usable api.", + "format": "int64", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/aggregated/forwardingRules", + "response": { + "$ref": "ForwardingRuleAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "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." + "delete": { + "description": "Deletes the specified ForwardingRule resource.", + "flatPath": "projects/{project}/regions/{region}/forwardingRules/{forwardingRule}", + "httpMethod": "DELETE", + "id": "compute.forwardingRules.delete", + "parameterOrder": [ + "project", + "region", + "forwardingRule" ], - "enum": [ - "ONGOING", - "PENDING", - "UNKNOWN" + "parameters": { + "forwardingRule": { + "description": "Name of the ForwardingRule resource to delete.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/forwardingRules/{forwardingRule}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] - } - } - }, - "ResourceStatusPhysicalHostTopology": { - "id": "ResourceStatusPhysicalHostTopology", - "description": "Represents the physical host topology of the host on which the VM is running.", - "type": "object", - "properties": { - "cluster": { - "description": "[Output Only] The global name of the Compute Engine cluster where the running instance is located.", - "type": "string" - }, - "block": { - "description": "[Output Only] The ID of the block in which the running instance is located. Instances within the same block experience low network latency.", - "type": "string" }, - "subblock": { - "description": "[Output Only] The ID of the sub-block in which the running instance is located. Instances in the same sub-block experience lower network latency than instances in the same block.", - "type": "string" - }, - "host": { - "description": "[Output Only] The ID of the host on which the running instance is located. Instances on the same host experience the lowest possible network latency.", - "type": "string" - } - } - }, - "NetworkPerformanceConfig": { - "id": "NetworkPerformanceConfig", - "type": "object", - "properties": { - "totalEgressBandwidthTier": { - "type": "string", - "enumDescriptions": [ - "", - "" + "get": { + "description": "Returns the specified ForwardingRule resource.", + "flatPath": "projects/{project}/regions/{region}/forwardingRules/{forwardingRule}", + "httpMethod": "GET", + "id": "compute.forwardingRules.get", + "parameterOrder": [ + "project", + "region", + "forwardingRule" ], - "enum": [ - "DEFAULT", - "TIER_1" - ] - } - } - }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "parameters": { + "forwardingRule": { + "description": "Name of the ForwardingRule resource to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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" - } - } - } - } - } - }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "view": { + "enum": [ + "BASIC", + "FULL" ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false + "enumDescriptions": [ + "The default view of a ForwardingRule, which includes the basic fields.", + "The full view, including the ForwardingRule.`attached_extensions` field." ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/forwardingRules/{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" + ] + }, + "insert": { + "description": "Creates a ForwardingRule resource in the specified project and region using\nthe data included in the request.", + "flatPath": "projects/{project}/regions/{region}/forwardingRules", + "httpMethod": "POST", + "id": "compute.forwardingRules.insert", + "parameterOrder": [ + "project", + "region" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" } - } - } - } - }, - "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" + }, + "path": "projects/{project}/regions/{region}/forwardingRules", + "request": { + "$ref": "ForwardingRule" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "list": { + "description": "Retrieves a list of ForwardingRule resources available to the specified\nproject and region.", + "flatPath": "projects/{project}/regions/{region}/forwardingRules", + "httpMethod": "GET", + "id": "compute.forwardingRules.list", + "parameterOrder": [ + "project", + "region" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`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\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" } - } - } - } - }, - "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" + }, + "path": "projects/{project}/regions/{region}/forwardingRules", + "response": { + "$ref": "ForwardingRuleList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "referenceType": { - "description": "A description of the reference type with no implied semantics. Possible values include: 1. MEMBER_OF ", - "type": "string" + "patch": { + "description": "Updates the specified forwarding rule with the data included in the\nrequest. This method supportsPATCH\nsemantics and uses theJSON merge\npatch format and processing rules. Currently, you can only\npatch the network_tier field.", + "flatPath": "projects/{project}/regions/{region}/forwardingRules/{forwardingRule}", + "httpMethod": "PATCH", + "id": "compute.forwardingRules.patch", + "parameterOrder": [ + "project", + "region", + "forwardingRule" + ], + "parameters": { + "forwardingRule": { + "description": "Name of the ForwardingRule resource to patch.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/forwardingRules/{forwardingRule}", + "request": { + "$ref": "ForwardingRule" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "referrer": { - "description": "URL of the resource which refers to the target.", - "type": "string" - } - } - }, - "InstancesReportHostAsFaultyRequest": { - "id": "InstancesReportHostAsFaultyRequest", - "type": "object", - "properties": { - "faultReasons": { - "type": "array", - "items": { - "$ref": "InstancesReportHostAsFaultyRequestFaultReason" - } + "setLabels": { + "description": "Sets the labels on the specified resource. To learn more about labels,\nread the \nLabeling Resources documentation.", + "flatPath": "projects/{project}/regions/{region}/forwardingRules/{resource}/setLabels", + "httpMethod": "POST", + "id": "compute.forwardingRules.setLabels", + "parameterOrder": [ + "project", + "region", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/forwardingRules/{resource}/setLabels", + "request": { + "$ref": "RegionSetLabelsRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "disruptionSchedule": { - "description": "The disruption schedule for the VM. Required field, only allows IMMEDIATE.", - "type": "string", - "enumDescriptions": [ - "Not used. Required as per aip/126.", - "Delay disruption for caller control. Will be default soon.", - "Default value. Disrupt the VM immediately." + "setTarget": { + "description": "Changes target URL for forwarding rule. The new target should be of the\nsame type as the old target.", + "flatPath": "projects/{project}/regions/{region}/forwardingRules/{forwardingRule}/setTarget", + "httpMethod": "POST", + "id": "compute.forwardingRules.setTarget", + "parameterOrder": [ + "project", + "region", + "forwardingRule" ], - "enum": [ - "DISRUPTION_SCHEDULE_UNSPECIFIED", - "FUTURE", - "IMMEDIATE" + "parameters": { + "forwardingRule": { + "description": "Name of the ForwardingRule resource in which target is to be set.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/forwardingRules/{forwardingRule}/setTarget", + "request": { + "$ref": "TargetReference" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] } } }, - "InstancesReportHostAsFaultyRequestFaultReason": { - "id": "InstancesReportHostAsFaultyRequestFaultReason", - "type": "object", - "properties": { - "behavior": { - "type": "string", - "enumDescriptions": [ - "Public reportable behaviors", - "", - "", - "" + "futureReservations": { + "methods": { + "aggregatedList": { + "description": "Retrieves an aggregated list of future reservations.\n\nTo prevent failure, it is recommended that you set the\n`returnPartialSuccess` parameter to `true`.", + "flatPath": "projects/{project}/aggregated/futureReservations", + "httpMethod": "GET", + "id": "compute.futureReservations.aggregatedList", + "parameterOrder": [ + "project" ], - "enum": [ - "BEHAVIOR_UNSPECIFIED", - "PERFORMANCE", - "SILENT_DATA_CORRUPTION", - "UNRECOVERABLE_GPU_ERROR" + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region,\nglobal) should be included in the response. For new resource types added\nafter this field, the flag has no effect as new resource types will always\ninclude every visible scope for each scope type in response. For resource\ntypes which predate this field, if this flag is omitted or false, only\nscopes of the scope types where the resource type is expected to be found\nwill be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which\naggregated list request is invoked for subnetworks list-usable api.", + "format": "int64", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/aggregated/futureReservations", + "response": { + "$ref": "FutureReservationsAggregatedListResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "description": { - "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" + "cancel": { + "description": "Cancel the specified future reservation.", + "flatPath": "projects/{project}/zones/{zone}/futureReservations/{futureReservation}/cancel", + "httpMethod": "POST", + "id": "compute.futureReservations.cancel", + "parameterOrder": [ + "project", + "zone", + "futureReservation" + ], + "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.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(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" + } + }, + "path": "projects/{project}/zones/{zone}/futureReservations/{futureReservation}/cancel", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "variableKey": { - "description": "The key to search for.", - "type": "string" + "delete": { + "description": "Deletes the specified future reservation.", + "flatPath": "projects/{project}/zones/{zone}/futureReservations/{futureReservation}", + "httpMethod": "DELETE", + "id": "compute.futureReservations.delete", + "parameterOrder": [ + "project", + "zone", + "futureReservation" + ], + "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.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(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" + } + }, + "path": "projects/{project}/zones/{zone}/futureReservations/{futureReservation}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "variableValue": { - "description": "[Output Only] The value found for the requested key.", - "type": "string" + "get": { + "description": "Retrieves information about the specified future reservation.", + "flatPath": "projects/{project}/zones/{zone}/futureReservations/{futureReservation}", + "httpMethod": "GET", + "id": "compute.futureReservations.get", + "parameterOrder": [ + "project", + "zone", + "futureReservation" + ], + "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.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "zone": { + "description": "Name of the zone for this request. Name should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/futureReservations/{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" + ] }, - "queryPath": { - "description": "The path to be queried. This can be the default namespace ('') or a nested namespace ('\\/') or a specified key ('\\/\\').", - "type": "string" + "insert": { + "description": "Creates a new Future Reservation.", + "flatPath": "projects/{project}/zones/{zone}/futureReservations", + "httpMethod": "POST", + "id": "compute.futureReservations.insert", + "parameterOrder": [ + "project", + "zone" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(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" + } + }, + "path": "projects/{project}/zones/{zone}/futureReservations", + "request": { + "$ref": "FutureReservation" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "queryValue": { - "description": "[Output Only] The value of the requested queried path.", - "$ref": "GuestAttributesValue" + "list": { + "description": "A list of all the future reservations that have been configured for the\nspecified project in specified zone.", + "flatPath": "projects/{project}/zones/{zone}/futureReservations", + "httpMethod": "GET", + "id": "compute.futureReservations.list", + "parameterOrder": [ + "project", + "zone" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith 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" + } + }, + "path": "projects/{project}/zones/{zone}/futureReservations", + "response": { + "$ref": "FutureReservationsListResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "update": { + "description": "Updates the specified future reservation.", + "flatPath": "projects/{project}/zones/{zone}/futureReservations/{futureReservation}", + "httpMethod": "PATCH", + "id": "compute.futureReservations.update", + "parameterOrder": [ + "project", + "zone", + "futureReservation" + ], + "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.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "updateMask": { + "description": "update_mask indicates fields to be updated as part of this request.", + "format": "google-fieldmask", + "location": "query", + "type": "string" + }, + "zone": { + "description": "Name of the zone for this request. Name should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/futureReservations/{futureReservation}", + "request": { + "$ref": "FutureReservation" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] } } }, - "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 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" - }, - "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" - ] + "globalAddresses": { + "methods": { + "delete": { + "description": "Deletes the specified address resource.", + "flatPath": "projects/{project}/global/addresses/{address}", + "httpMethod": "DELETE", + "id": "compute.globalAddresses.delete", + "parameterOrder": [ + "project", + "address" + ], + "parameters": { + "address": { + "description": "Name of the address resource to delete.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } }, - "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" + "path": "projects/{project}/global/addresses/{address}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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." + "get": { + "description": "Returns the specified address resource.", + "flatPath": "projects/{project}/global/addresses/{address}", + "httpMethod": "GET", + "id": "compute.globalAddresses.get", + "parameterOrder": [ + "project", + "address" ], - "enum": [ - "ENABLE_BIDIRECTIONAL_ACCESS_TO_GOOGLE", - "ENABLE_OUTBOUND_VM_ACCESS_TO_GOOGLE", - "INHERIT_FROM_SUBNETWORK" + "parameters": { + "address": { + "description": "Name of the address resource to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/addresses/{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" ] }, - "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." + "insert": { + "description": "Creates an address resource in the specified project by using the data\nincluded in the request.", + "flatPath": "projects/{project}/global/addresses", + "httpMethod": "POST", + "id": "compute.globalAddresses.insert", + "parameterOrder": [ + "project" ], - "enum": [ - "KEY_REVOCATION_ACTION_TYPE_UNSPECIFIED", - "NONE", - "STOP" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/addresses", + "request": { + "$ref": "Address" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] - } - } - }, - "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." + "list": { + "description": "Retrieves a list of global addresses.", + "flatPath": "projects/{project}/global/addresses", + "httpMethod": "GET", + "id": "compute.globalAddresses.list", + "parameterOrder": [ + "project" ], - "enum": [ - "ANY", - "ANY_SINGLE_ZONE", - "BALANCED" + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/global/addresses", + "response": { + "$ref": "AddressList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] - } - } - }, - "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." + }, + "move": { + "description": "Moves the specified address resource from one project to another project.", + "flatPath": "projects/{project}/global/addresses/{address}/move", + "httpMethod": "POST", + "id": "compute.globalAddresses.move", + "parameterOrder": [ + "project", + "address" ], - "enum": [ - "ALLOW", - "DENY", - "PREFERENCE_UNSPECIFIED" + "parameters": { + "address": { + "description": "Name of the address resource to move.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Source project ID which the Address is moved from.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/addresses/{address}/move", + "request": { + "$ref": "GlobalAddressesMoveRequest" + }, + "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": [ - "", - "", - "", - "", - "", - "" + "setLabels": { + "description": "Sets the labels on a GlobalAddress. To learn more about labels, read theLabeling\nResources documentation.", + "flatPath": "projects/{project}/global/addresses/{resource}/setLabels", + "httpMethod": "POST", + "id": "compute.globalAddresses.setLabels", + "parameterOrder": [ + "project", + "resource" ], - "enum": [ - "HIERARCHY", - "NETWORK", - "NETWORK_REGIONAL", - "SYSTEM_GLOBAL", - "SYSTEM_REGIONAL", - "UNSPECIFIED" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/addresses/{resource}/setLabels", + "request": { + "$ref": "GlobalSetLabelsRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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" - } - }, - "packetMirroringRules": { - "description": "[Output Only] The packet mirroring rules that apply to the instance.", - "type": "array", - "items": { - "$ref": "FirewallPolicyRule" - } - }, - "priority": { - "description": "[Output only] Priority of firewall policy association. Not applicable for type=HIERARCHY.", - "type": "integer", - "format": "int32" + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource.", + "flatPath": "projects/{project}/global/addresses/{resource}/testIamPermissions", + "httpMethod": "POST", + "id": "compute.globalAddresses.testIamPermissions", + "parameterOrder": [ + "project", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/addresses/{resource}/testIamPermissions", + "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" + ] } } }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "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": { + "delete": { + "description": "Deletes the specified GlobalForwardingRule resource.", + "flatPath": "projects/{project}/global/forwardingRules/{forwardingRule}", + "httpMethod": "DELETE", + "id": "compute.globalForwardingRules.delete", + "parameterOrder": [ + "project", + "forwardingRule" + ], + "parameters": { + "forwardingRule": { + "description": "Name of the ForwardingRule resource to delete.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "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": { - "specificReservation": { - "description": "Reservation for instances with specific machine shapes.", - "$ref": "AllocationSpecificSKUReservation" - }, - "aggregateReservation": { - "description": "Reservation for aggregated resources, providing shape flexibility.", - "$ref": "AllocationAggregateReservation" - }, - "deleteAtTime": { - "description": "Absolute time in future when the reservation will be auto-deleted by Compute Engine. Timestamp is represented in RFC3339 text format.", - "type": "string" - }, - "deleteAfterDuration": { - "description": "Duration time relative to reservation creation when Compute Engine will automatically delete this resource.", - "$ref": "Duration" - }, - "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" - }, - "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" - }, - "linkedCommitments": { - "description": "[Output Only] Full or partial URL to parent commitments. This field displays for reservations that are tied to multiple commitments.", - "type": "array", - "items": { - "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" + "path": "projects/{project}/global/forwardingRules/{forwardingRule}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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." + "get": { + "description": "Returns the specified GlobalForwardingRule resource. Gets a list of\navailable forwarding rules by making a list() request.", + "flatPath": "projects/{project}/global/forwardingRules/{forwardingRule}", + "httpMethod": "GET", + "id": "compute.globalForwardingRules.get", + "parameterOrder": [ + "project", + "forwardingRule" ], - "enum": [ - "CREATING", - "DELETING", - "INVALID", - "READY", - "UPDATING" + "parameters": { + "forwardingRule": { + "description": "Name of the ForwardingRule resource to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "view": { + "enum": [ + "BASIC", + "FULL" + ], + "enumDescriptions": [ + "The default view of a ForwardingRule, which includes the basic fields.", + "The full view, including the ForwardingRule.`attached_extensions` field." + ], + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/forwardingRules/{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" ] }, - "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" - }, - "reservationSharingPolicy": { - "description": "Specify the reservation sharing policy. If unspecified, the reservation will not be shared with Google Cloud managed services.", - "$ref": "AllocationReservationSharingPolicy" - }, - "deploymentType": { - "description": "Specifies the deployment strategy for this reservation.", - "type": "string", - "enumDescriptions": [ - "The reserved capacity is made up of densely deployed reservation blocks.", - "" + "insert": { + "description": "Creates a GlobalForwardingRule resource in the specified project using\nthe data included in the request.", + "flatPath": "projects/{project}/global/forwardingRules", + "httpMethod": "POST", + "id": "compute.globalForwardingRules.insert", + "parameterOrder": [ + "project" ], - "enum": [ - "DENSE", - "DEPLOYMENT_TYPE_UNSPECIFIED" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/forwardingRules", + "request": { + "$ref": "ForwardingRule" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "enableEmergentMaintenance": { - "description": "Indicates whether Compute Engine allows unplanned maintenance for your VMs; for example, to fix hardware errors.", - "type": "boolean" - } - } - }, - "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" + "list": { + "description": "Retrieves a list of GlobalForwardingRule resources available to the\nspecified project.", + "flatPath": "projects/{project}/global/forwardingRules", + "httpMethod": "GET", + "id": "compute.globalForwardingRules.list", + "parameterOrder": [ + "project" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/global/forwardingRules", + "response": { + "$ref": "ForwardingRuleList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "inUseCount": { - "description": "[Output Only] Indicates how many instances are in use.", - "type": "string", - "format": "int64" + "patch": { + "description": "Updates the specified forwarding rule with the data included in the\nrequest. This method supportsPATCH\nsemantics and uses theJSON merge\npatch format and processing rules. Currently, you can only\npatch the network_tier field.", + "flatPath": "projects/{project}/global/forwardingRules/{forwardingRule}", + "httpMethod": "PATCH", + "id": "compute.globalForwardingRules.patch", + "parameterOrder": [ + "project", + "forwardingRule" + ], + "parameters": { + "forwardingRule": { + "description": "Name of the ForwardingRule resource to patch.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/forwardingRules/{forwardingRule}", + "request": { + "$ref": "ForwardingRule" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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" + "setLabels": { + "description": "Sets the labels on the specified resource. To learn more about labels,\nread the \nLabeling resources documentation.", + "flatPath": "projects/{project}/global/forwardingRules/{resource}/setLabels", + "httpMethod": "POST", + "id": "compute.globalForwardingRules.setLabels", + "parameterOrder": [ + "project", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/forwardingRules/{resource}/setLabels", + "request": { + "$ref": "GlobalSetLabelsRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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": [ - "", - "" + "setTarget": { + "description": "Changes target URL for the GlobalForwardingRule resource. The new target\nshould be of the same type as the old target.", + "flatPath": "projects/{project}/global/forwardingRules/{forwardingRule}/setTarget", + "httpMethod": "POST", + "id": "compute.globalForwardingRules.setTarget", + "parameterOrder": [ + "project", + "forwardingRule" ], - "enum": [ - "NVME", - "SCSI" + "parameters": { + "forwardingRule": { + "description": "Name of the ForwardingRule resource in which target is to be set.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/forwardingRules/{forwardingRule}/setTarget", + "request": { + "$ref": "TargetReference" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] } } }, - "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": [ - "", - "", - "", - "", - "", - "", - "" + "globalNetworkEndpointGroups": { + "methods": { + "attachNetworkEndpoints": { + "description": "Attach a network endpoint to the specified network endpoint group.", + "flatPath": "projects/{project}/global/networkEndpointGroups/{networkEndpointGroup}/attachNetworkEndpoints", + "httpMethod": "POST", + "id": "compute.globalNetworkEndpointGroups.attachNetworkEndpoints", + "parameterOrder": [ + "project", + "networkEndpointGroup" ], - "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_LITE_POD_SLICE_CT6E", - "VM_FAMILY_CLOUD_TPU_POD_SLICE_CT3P", - "VM_FAMILY_CLOUD_TPU_POD_SLICE_CT4P", - "VM_FAMILY_CLOUD_TPU_POD_SLICE_CT5P" + "parameters": { + "networkEndpointGroup": { + "description": "The name of the network endpoint group where you are attaching network\nendpoints to. It should comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/networkEndpointGroups/{networkEndpointGroup}/attachNetworkEndpoints", + "request": { + "$ref": "GlobalNetworkEndpointGroupsAttachEndpointsRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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.", - "" + "delete": { + "description": "Deletes the specified network endpoint group.Note that the NEG cannot be\ndeleted if there are backend services referencing it.", + "flatPath": "projects/{project}/global/networkEndpointGroups/{networkEndpointGroup}", + "httpMethod": "DELETE", + "id": "compute.globalNetworkEndpointGroups.delete", + "parameterOrder": [ + "project", + "networkEndpointGroup" ], - "enum": [ - "BATCH", - "SERVING", - "UNSPECIFIED" + "parameters": { + "networkEndpointGroup": { + "description": "The name of the network endpoint group to delete. It should comply with\nRFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/networkEndpointGroups/{networkEndpointGroup}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] - } - } - }, - "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" + "detachNetworkEndpoints": { + "description": "Detach the network endpoint from the specified network endpoint group.", + "flatPath": "projects/{project}/global/networkEndpointGroups/{networkEndpointGroup}/detachNetworkEndpoints", + "httpMethod": "POST", + "id": "compute.globalNetworkEndpointGroups.detachNetworkEndpoints", + "parameterOrder": [ + "project", + "networkEndpointGroup" ], - "enum": [ - "LOCAL", - "ORGANIZATION", - "SHARE_TYPE_UNSPECIFIED", - "SPECIFIC_PROJECTS" + "parameters": { + "networkEndpointGroup": { + "description": "The name of the network endpoint group where you are removing network\nendpoints. It should comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/networkEndpointGroups/{networkEndpointGroup}/detachNetworkEndpoints", + "request": { + "$ref": "GlobalNetworkEndpointGroupsDetachEndpointsRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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" - }, - "reservationMaintenance": { - "description": "Maintenance information for this reservation", - "$ref": "GroupMaintenanceInfo" - }, - "reservationBlockCount": { - "description": "The number of reservation blocks associated with this reservation.", - "type": "integer", - "format": "int32" - } - } - }, - "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" - }, - "utilizations": { - "description": "Per service utilization breakdown. The Key is the Google Cloud managed service name.", - "type": "object", - "additionalProperties": { - "type": "string", - "format": "int64" - } - } - } - }, - "GroupMaintenanceInfo": { - "id": "GroupMaintenanceInfo", - "description": "Maintenance Info for ReservationBlocks.", - "type": "object", - "properties": { - "upcomingGroupMaintenance": { - "description": "Maintenance information on this group of VMs.", - "$ref": "UpcomingMaintenance" + "get": { + "description": "Returns the specified network endpoint group.", + "flatPath": "projects/{project}/global/networkEndpointGroups/{networkEndpointGroup}", + "httpMethod": "GET", + "id": "compute.globalNetworkEndpointGroups.get", + "parameterOrder": [ + "project", + "networkEndpointGroup" + ], + "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.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/networkEndpointGroups/{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" + ] }, - "maintenanceOngoingCount": { - "description": "Progress for ongoing maintenance for this group of VMs/hosts. Describes number of hosts in the block that have ongoing maintenance.", - "type": "integer", - "format": "int32" + "insert": { + "description": "Creates a network endpoint group in the specified project using the\nparameters that are included in the request.\n\nNote: Use the following APIs to manage network endpoint groups:\n \n - \n To manage NEGs with zonal scope (such as zonal NEGs, hybrid connectivity\n NEGs): zonal\n API\n - \n To manage NEGs with regional scope (such as regional internet NEGs,\n serverless NEGs, Private Service Connect NEGs): regional\n API\n - \n To manage NEGs with global scope (such as global internet NEGs):global\n API", + "flatPath": "projects/{project}/global/networkEndpointGroups", + "httpMethod": "POST", + "id": "compute.globalNetworkEndpointGroups.insert", + "parameterOrder": [ + "project" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/networkEndpointGroups", + "request": { + "$ref": "NetworkEndpointGroup" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "maintenancePendingCount": { - "description": "Progress for ongoing maintenance for this group of VMs/hosts. Describes number of hosts in the block that have pending maintenance.", - "type": "integer", - "format": "int32" + "list": { + "description": "Retrieves the list of network endpoint groups that are located in the\nspecified project.", + "flatPath": "projects/{project}/global/networkEndpointGroups", + "httpMethod": "GET", + "id": "compute.globalNetworkEndpointGroups.list", + "parameterOrder": [ + "project" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/global/networkEndpointGroups", + "response": { + "$ref": "NetworkEndpointGroupList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "schedulingType": { - "description": "The type of maintenance for the reservation.", - "type": "string", - "enumDescriptions": [ - "Maintenance on all reserved instances in the reservation is synchronized.", - "Unknown maintenance type.", - "Maintenance is not synchronized for this reservation. Instead, each instance has its own maintenance window." + "listNetworkEndpoints": { + "description": "Lists the network endpoints in the specified network endpoint group.", + "flatPath": "projects/{project}/global/networkEndpointGroups/{networkEndpointGroup}/listNetworkEndpoints", + "httpMethod": "POST", + "id": "compute.globalNetworkEndpointGroups.listNetworkEndpoints", + "parameterOrder": [ + "project", + "networkEndpointGroup" ], - "enum": [ - "GROUPED", - "GROUP_MAINTENANCE_TYPE_UNSPECIFIED", - "INDEPENDENT" + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "networkEndpointGroup": { + "description": "The name of the network endpoint group from which you want to generate a\nlist 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\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/global/networkEndpointGroups/{networkEndpointGroup}/listNetworkEndpoints", + "response": { + "$ref": "NetworkEndpointGroupsListNetworkEndpoints" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] } } }, - "AllocationReservationSharingPolicy": { - "id": "AllocationReservationSharingPolicy", - "type": "object", - "properties": { - "serviceShareType": { - "description": "Sharing config for all Google Cloud services.", - "type": "string", - "enumDescriptions": [ - "Allow all Google Cloud managed services to share reservations.", - "[Default] Disallow sharing with all Google Cloud services.", - "" + "globalOperations": { + "methods": { + "aggregatedList": { + "description": "Retrieves an aggregated list of all operations.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", + "flatPath": "projects/{project}/aggregated/operations", + "httpMethod": "GET", + "id": "compute.globalOperations.aggregatedList", + "parameterOrder": [ + "project" ], - "enum": [ - "ALLOW_ALL", - "DISALLOW_ALL", - "SERVICE_SHARE_TYPE_UNSPECIFIED" + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region,\nglobal) should be included in the response. For new resource types added\nafter this field, the flag has no effect as new resource types will always\ninclude every visible scope for each scope type in response. For resource\ntypes which predate this field, if this flag is omitted or false, only\nscopes of the scope types where the resource type is expected to be found\nwill be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which\naggregated list request is invoked for subnetworks list-usable api.", + "format": "int64", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/aggregated/operations", + "response": { + "$ref": "OperationAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] - } - } - }, - "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" + "delete": { + "description": "Deletes the specified Operations resource.", + "flatPath": "projects/{project}/global/operations/{operation}", + "httpMethod": "DELETE", + "id": "compute.globalOperations.delete", + "parameterOrder": [ + "project", + "operation" + ], + "parameters": { + "operation": { + "description": "Name of the Operations resource to delete, or its unique numeric\nidentifier.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/operations/{operation}", + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "get": { + "description": "Retrieves the specified Operations resource.", + "flatPath": "projects/{project}/global/operations/{operation}", + "httpMethod": "GET", + "id": "compute.globalOperations.get", + "parameterOrder": [ + "project", + "operation" + ], + "parameters": { + "operation": { + "description": "Name of the Operations resource to return, or its unique numeric\nidentifier.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/operations/{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" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "list": { + "description": "Retrieves a list of Operation resources contained within the specified\nproject.", + "flatPath": "projects/{project}/global/operations", + "httpMethod": "GET", + "id": "compute.globalOperations.list", + "parameterOrder": [ + "project" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`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\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" } - } + }, + "path": "projects/{project}/global/operations", + "response": { + "$ref": "OperationList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "unreachables": { - "description": "[Output Only] Unreachable resources.", - "type": "array", - "items": { - "type": "string" - } + "wait": { + "description": "Waits for the specified Operation resource to return as `DONE`\nor for the request to approach the 2 minute deadline, and retrieves the\nspecified Operation resource. This method differs from the\n`GET` method in that it waits for no more than the default\ndeadline (2 minutes) and then returns the current state of the operation,\nwhich might be `DONE` or still in progress.\n\nThis method is called on a best-effort basis. Specifically:\n \n \n - In uncommon cases, when the server is overloaded, the request might\n return before the default deadline is reached, or might return after zero\n seconds.\n - If the default deadline is reached, there is no guarantee that the\n operation is actually done when the method returns. Be prepared to retry\n if the operation is not `DONE`.", + "flatPath": "projects/{project}/global/operations/{operation}/wait", + "httpMethod": "POST", + "id": "compute.globalOperations.wait", + "parameterOrder": [ + "project", + "operation" + ], + "parameters": { + "operation": { + "description": "Name of the Operations resource to return, or its unique numeric\nidentifier.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/operations/{operation}/wait", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] } } }, - "ReservationsScopedList": { - "id": "ReservationsScopedList", - "type": "object", - "properties": { - "reservations": { - "description": "A list of reservations contained in this scope.", - "type": "array", - "items": { - "$ref": "Reservation" - } + "globalOrganizationOperations": { + "methods": { + "delete": { + "description": "Deletes the specified Operations resource.", + "flatPath": "locations/global/operations/{operation}", + "httpMethod": "DELETE", + "id": "compute.globalOrganizationOperations.delete", + "parameterOrder": [ + "operation" + ], + "parameters": { + "operation": { + "description": "Name of the Operations resource to delete, or its unique numeric\nidentifier.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "parentId": { + "description": "Parent ID for this request.", + "location": "query", + "type": "string" + } + }, + "path": "locations/global/operations/{operation}", + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "get": { + "description": "Retrieves the specified Operations resource. Gets a list of operations\nby making a `list()` request.", + "flatPath": "locations/global/operations/{operation}", + "httpMethod": "GET", + "id": "compute.globalOrganizationOperations.get", + "parameterOrder": [ + "operation" + ], + "parameters": { + "operation": { + "description": "Name of the Operations resource to return. Parent is derived from this\nfield.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "parentId": { + "description": "Parent ID for this request. Not used. Parent is derived from resource_id.", + "location": "query", + "type": "string" + } + }, + "path": "locations/global/operations/{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" + ] + }, + "list": { + "description": "Retrieves a list of Operation resources contained within the specified\norganization.", + "flatPath": "locations/global/operations", + "httpMethod": "GET", + "id": "compute.globalOrganizationOperations.list", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "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": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe 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\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" } - } + }, + "path": "locations/global/operations", + "response": { + "$ref": "OperationList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] } } }, - "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" - } - } - }, - "ReservationsPerformMaintenanceRequest": { - "id": "ReservationsPerformMaintenanceRequest", - "type": "object", - "properties": { - "maintenanceScope": { - "description": "Specifies if all, running or unused hosts are in scope for this request.", - "type": "string", - "enumDescriptions": [ - "Trigger maintenance for all hosts belonging to this reservation irrespective of whether VMs are running on them or not.", - "Internal only", - "Trigger maintenance only on the hosts belonging to this reservation which have VMs running on them.", - "Trigger maintenance only on the hosts belonging to this reservation which do not have any VMs running on them. This is not allowed for Standard ExR" + "globalPublicDelegatedPrefixes": { + "methods": { + "delete": { + "description": "Deletes the specified global PublicDelegatedPrefix.", + "flatPath": "projects/{project}/global/publicDelegatedPrefixes/{publicDelegatedPrefix}", + "httpMethod": "DELETE", + "id": "compute.globalPublicDelegatedPrefixes.delete", + "parameterOrder": [ + "project", + "publicDelegatedPrefix" ], - "enum": [ - "ALL", - "MAINTENANCE_SCOPE_UNSPECIFIED", - "RUNNING_VMS", - "UNUSED_CAPACITY" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "publicDelegatedPrefix": { + "description": "Name of the PublicDelegatedPrefix resource to delete.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/publicDelegatedPrefixes/{publicDelegatedPrefix}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] - } - } - }, - "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" - } + "get": { + "description": "Returns the specified global PublicDelegatedPrefix resource.", + "flatPath": "projects/{project}/global/publicDelegatedPrefixes/{publicDelegatedPrefix}", + "httpMethod": "GET", + "id": "compute.globalPublicDelegatedPrefixes.get", + "parameterOrder": [ + "project", + "publicDelegatedPrefix" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "publicDelegatedPrefix": { + "description": "Name of the PublicDelegatedPrefix resource to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/publicDelegatedPrefixes/{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" + ] }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the 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": { + "description": "Creates a global PublicDelegatedPrefix in the specified project using the\nparameters that are included in the request.", + "flatPath": "projects/{project}/global/publicDelegatedPrefixes", + "httpMethod": "POST", + "id": "compute.globalPublicDelegatedPrefixes.insert", + "parameterOrder": [ + "project" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/publicDelegatedPrefixes", + "request": { + "$ref": "PublicDelegatedPrefix" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "list": { + "description": "Lists the global PublicDelegatedPrefixes for a project.", + "flatPath": "projects/{project}/global/publicDelegatedPrefixes", + "httpMethod": "GET", + "id": "compute.globalPublicDelegatedPrefixes.list", + "parameterOrder": [ + "project" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/global/publicDelegatedPrefixes", + "response": { + "$ref": "PublicDelegatedPrefixList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "patch": { + "description": "Patches the specified global PublicDelegatedPrefix resource with the data\nincluded in the request. This method supportsPATCH\nsemantics and usesJSON merge\npatch format and processing rules.", + "flatPath": "projects/{project}/global/publicDelegatedPrefixes/{publicDelegatedPrefix}", + "httpMethod": "PATCH", + "id": "compute.globalPublicDelegatedPrefixes.patch", + "parameterOrder": [ + "project", + "publicDelegatedPrefix" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" } - } + }, + "path": "projects/{project}/global/publicDelegatedPrefixes/{publicDelegatedPrefix}", + "request": { + "$ref": "PublicDelegatedPrefix" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] } } }, - "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" + "globalVmExtensionPolicies": { + "methods": { + "aggregatedList": { + "description": "Retrieves the list of all VM Extension Policy resources\navailable to the specified project.\n\nTo prevent failure, it's recommended that you set the\n`returnPartialSuccess` parameter to `true`.", + "flatPath": "projects/{project}/aggregated/vmExtensionPolicies", + "httpMethod": "GET", + "id": "compute.globalVmExtensionPolicies.aggregatedList", + "parameterOrder": [ + "project" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region,\nglobal) should be included in the response. For new resource types added\nafter this field, the flag has no effect as new resource types will always\ninclude every visible scope for each scope type in response. For resource\ntypes which predate this field, if this flag is omitted or false, only\nscopes of the scope types where the resource type is expected to be found\nwill be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Name of the project scoping this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which\naggregated list request is invoked for subnetworks list-usable api.", + "format": "int64", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/aggregated/vmExtensionPolicies", + "response": { + "$ref": "VmExtensionPolicyAggregatedListResponse" + }, + "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] A unique identifier for this instance group, generated by the server.", - "type": "string", - "format": "uint64" + "delete": { + "description": "Purge scoped resources (zonal policies) from a global VM extension\npolicy, and then delete the global VM extension policy. Purge of the scoped\nresources is a pre-condition of the global VM extension policy deletion.\nThe deletion of the global VM extension policy happens after the purge\nrollout is done, so it's not a part of the LRO. It's an automatic process\nthat triggers in the backend.", + "flatPath": "projects/{project}/global/vmExtensionPolicies/{globalVmExtensionPolicy}/delete", + "httpMethod": "POST", + "id": "compute.globalVmExtensionPolicies.delete", + "parameterOrder": [ + "project", + "globalVmExtensionPolicy" + ], + "parameters": { + "globalVmExtensionPolicy": { + "description": "Name of the global VM extension policy to purge scoped resources for.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/vmExtensionPolicies/{globalVmExtensionPolicy}/delete", + "request": { + "$ref": "GlobalVmExtensionPolicyRolloutOperationRolloutInput" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "creationTimestamp": { - "description": "[Output Only] The creation timestamp for this instance group in RFC3339 text format.", - "type": "string" + "get": { + "description": "Gets details of a global VM extension policy.", + "flatPath": "projects/{project}/global/vmExtensionPolicies/{globalVmExtensionPolicy}", + "httpMethod": "GET", + "id": "compute.globalVmExtensionPolicies.get", + "parameterOrder": [ + "project", + "globalVmExtensionPolicy" + ], + "parameters": { + "globalVmExtensionPolicy": { + "description": "Name of the GlobalVmExtensionPolicy resource to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/vmExtensionPolicies/{globalVmExtensionPolicy}", + "response": { + "$ref": "GlobalVmExtensionPolicy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "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" - ] + "insert": { + "description": "Creates a new project level GlobalVmExtensionPolicy.", + "flatPath": "projects/{project}/global/vmExtensionPolicies", + "httpMethod": "POST", + "id": "compute.globalVmExtensionPolicies.insert", + "parameterOrder": [ + "project" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } }, - "type": "string" + "path": "projects/{project}/global/vmExtensionPolicies", + "request": { + "$ref": "GlobalVmExtensionPolicy" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "description": { - "description": "An optional description of this resource. Provide this property when you create the resource.", - "type": "string" + "list": { + "description": "Lists global VM extension policies.", + "flatPath": "projects/{project}/global/vmExtensionPolicies", + "httpMethod": "GET", + "id": "compute.globalVmExtensionPolicies.list", + "parameterOrder": [ + "project" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/global/vmExtensionPolicies", + "response": { + "$ref": "GlobalVmExtensionPolicyList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "namedPorts": { - "description": " Optional. 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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "update": { + "description": "Updates a global VM extension policy.", + "flatPath": "projects/{project}/global/vmExtensionPolicies/{globalVmExtensionPolicy}", + "httpMethod": "PATCH", + "id": "compute.globalVmExtensionPolicies.update", + "parameterOrder": [ + "project", + "globalVmExtensionPolicy" + ], + "parameters": { + "globalVmExtensionPolicy": { + "description": "Name of the global VM extension policy to update.", + "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.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" } - } - }, - "unreachables": { - "description": "[Output Only] Unreachable resources.", - "type": "array", - "items": { - "type": "string" - } + }, + "path": "projects/{project}/global/vmExtensionPolicies/{globalVmExtensionPolicy}", + "request": { + "$ref": "GlobalVmExtensionPolicy" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] } } }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "healthChecks": { + "methods": { + "aggregatedList": { + "description": "Retrieves the list of all HealthCheck resources, regional and global,\navailable to the specified project.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", + "flatPath": "projects/{project}/aggregated/healthChecks", + "httpMethod": "GET", + "id": "compute.healthChecks.aggregatedList", + "parameterOrder": [ + "project" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "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,\nglobal) should be included in the response. For new resource types added\nafter this field, the flag has no effect as new resource types will always\ninclude every visible scope for each scope type in response. For resource\ntypes which predate this field, if this flag is omitted or false, only\nscopes of the scope types where the resource type is expected to be found\nwill be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`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\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Name of the project scoping this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which\naggregated list request is invoked for subnetworks list-usable api.", + "format": "int64", + "location": "query", + "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" + }, + "path": "projects/{project}/aggregated/healthChecks", + "response": { + "$ref": "HealthChecksAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] - } - } - }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "delete": { + "description": "Deletes the specified HealthCheck resource.", + "flatPath": "projects/{project}/global/healthChecks/{healthCheck}", + "httpMethod": "DELETE", + "id": "compute.healthChecks.delete", + "parameterOrder": [ + "project", + "healthCheck" + ], + "parameters": { + "healthCheck": { + "description": "Name of the HealthCheck resource to delete.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" } - } - } - } - }, - "InstanceWithNamedPorts": { - "id": "InstanceWithNamedPorts", - "type": "object", - "properties": { - "instance": { - "description": "[Output Only] The URL of the instance.", - "type": "string" + }, + "path": "projects/{project}/global/healthChecks/{healthCheck}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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)." + "get": { + "description": "Returns the specified HealthCheck resource.", + "flatPath": "projects/{project}/global/healthChecks/{healthCheck}", + "httpMethod": "GET", + "id": "compute.healthChecks.get", + "parameterOrder": [ + "project", + "healthCheck" ], - "enum": [ - "DEPROVISIONING", - "PROVISIONING", - "REPAIRING", - "RUNNING", - "STAGING", - "STOPPED", - "STOPPING", - "SUSPENDED", - "SUSPENDING", - "TERMINATED" + "parameters": { + "healthCheck": { + "description": "Name of the HealthCheck resource to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/healthChecks/{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" ] }, - "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" + "insert": { + "description": "Creates a HealthCheck resource in the specified project using the data\nincluded in the request.", + "flatPath": "projects/{project}/global/healthChecks", + "httpMethod": "POST", + "id": "compute.healthChecks.insert", + "parameterOrder": [ + "project" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/healthChecks", + "request": { + "$ref": "HealthCheck" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "items": { - "description": "A list of InstanceGroup resources.", - "type": "array", - "items": { - "$ref": "InstanceGroup" - } + "list": { + "description": "Retrieves the list of HealthCheck resources available to the specified\nproject.", + "flatPath": "projects/{project}/global/healthChecks", + "httpMethod": "GET", + "id": "compute.healthChecks.list", + "parameterOrder": [ + "project" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/global/healthChecks", + "response": { + "$ref": "HealthCheckList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the 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": { + "description": "Updates a HealthCheck resource in the specified project using the data\nincluded in the request. This method supportsPATCH\nsemantics and uses theJSON merge\npatch format and processing rules.", + "flatPath": "projects/{project}/global/healthChecks/{healthCheck}", + "httpMethod": "PATCH", + "id": "compute.healthChecks.patch", + "parameterOrder": [ + "project", + "healthCheck" + ], + "parameters": { + "healthCheck": { + "description": "Name of the HealthCheck resource to patch.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/healthChecks/{healthCheck}", + "request": { + "$ref": "HealthCheck" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource.", + "flatPath": "projects/{project}/global/healthChecks/{resource}/testIamPermissions", + "httpMethod": "POST", + "id": "compute.healthChecks.testIamPermissions", + "parameterOrder": [ + "project", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/healthChecks/{resource}/testIamPermissions", + "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" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "update": { + "description": "Updates a HealthCheck resource in the specified project using the data\nincluded in the request.", + "flatPath": "projects/{project}/global/healthChecks/{healthCheck}", + "httpMethod": "PUT", + "id": "compute.healthChecks.update", + "parameterOrder": [ + "project", + "healthCheck" + ], + "parameters": { + "healthCheck": { + "description": "Name of the HealthCheck resource to update.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" } - } + }, + "path": "projects/{project}/global/healthChecks/{healthCheck}", + "request": { + "$ref": "HealthCheck" + }, + "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." + "hosts": { + "methods": { + "get": { + "description": "Retrieves information about the specified host.", + "flatPath": "projects/{project}/zones/{zone}/{association}/hosts/{host}", + "httpMethod": "GET", + "id": "compute.hosts.get", + "parameterOrder": [ + "project", + "zone", + "association", + "host" ], - "enum": [ - "ALL", - "RUNNING" + "parameters": { + "association": { + "description": "The parent resource association for the Host. This field specifies the\nhierarchical context (e.g., reservation, block, sub-block) when\naccessing the host. For example, reservations/reservation_name,\nreservations/reservation_name/reservationBlocks/reservation_block_name or\nreservations/reservation_name/reservationBlocks/reservation_block_name/reservationSubBlocks/reservation_sub_block_name.", + "location": "path", + "required": true, + "type": "string" + }, + "host": { + "description": "The name of the host, formatted as RFC1035 or a resource ID\nnumber.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "The project ID for this request.", + "location": "path", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request, formatted as RFC1035.", + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/{association}/hosts/{host}", + "response": { + "$ref": "Host" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "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" + "getVersion": { + "description": "Allows customers to get SBOM versions of a host.", + "flatPath": "projects/{project}/zones/{zone}/{association}/hosts/{host}/getVersion", + "httpMethod": "POST", + "id": "compute.hosts.getVersion", + "parameterOrder": [ + "project", + "zone", + "association", + "host" + ], + "parameters": { + "association": { + "description": "The parent resource association for the Host. This field specifies the\nhierarchical context (e.g., reservation, block, sub-block) when\naccessing the host.", + "location": "path", + "required": true, + "type": "string" + }, + "host": { + "description": "The name of the host, formatted as RFC1035 or a resource ID\nnumber.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.", + "location": "query", + "type": "string" + }, + "zone": { + "description": "Name of the zone for this request. Zone name should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/{association}/hosts/{host}/getVersion", + "request": { + "$ref": "HostsGetVersionRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "list": { + "description": "Retrieves a list of hosts.", + "flatPath": "projects/{project}/zones/{zone}/{association}/hosts", + "httpMethod": "GET", + "id": "compute.hosts.list", + "parameterOrder": [ + "project", + "zone", + "association" + ], + "parameters": { + "association": { + "description": "The parent resource association for the Host. This field specifies the\nhierarchical context (e.g., reservation, block, sub-block) when\naccessing the host. For example, reservations/reservation_name,\nreservations/reservation_name/reservationBlocks/reservation_block_name or\nreservations/reservation_name/reservationBlocks/reservation_block_name/reservationSubBlocks/reservation_sub_block_name.", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "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": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "The project ID for this request.", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "zone": { + "description": "The name of the zone for this request, formatted as RFC1035.", + "location": "path", + "required": true, + "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" + }, + "path": "projects/{project}/zones/{zone}/{association}/hosts", + "response": { + "$ref": "HostsListResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] } } }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "httpHealthChecks": { + "methods": { + "delete": { + "description": "Deletes the specified HttpHealthCheck resource.", + "flatPath": "projects/{project}/global/httpHealthChecks/{httpHealthCheck}", + "httpMethod": "DELETE", + "id": "compute.httpHealthChecks.delete", + "parameterOrder": [ + "project", + "httpHealthCheck" + ], + "parameters": { + "httpHealthCheck": { + "description": "Name of the HttpHealthCheck resource to delete.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "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" - ] + "path": "projects/{project}/global/httpHealthChecks/{httpHealthCheck}", + "response": { + "$ref": "Operation" }, - "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" - }, - "targetStoppedSize": { - "description": "The target number of stopped instances for this managed instance group. This number changes when you: - Stop instance using the stopInstances method or start instances using the startInstances method. - Manually change the targetStoppedSize using the update method. ", - "type": "integer", - "format": "int32" - }, - "targetSuspendedSize": { - "description": "The target number of suspended instances for this managed instance group. This number changes when you: - Suspend instance using the suspendInstances method or resume instances using the resumeInstances method. - Manually change the targetSuspendedSize using the update method. ", - "type": "integer", - "format": "int32" + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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." + "get": { + "description": "Returns the specified HttpHealthCheck resource.", + "flatPath": "projects/{project}/global/httpHealthChecks/{httpHealthCheck}", + "httpMethod": "GET", + "id": "compute.httpHealthChecks.get", + "parameterOrder": [ + "project", + "httpHealthCheck" ], - "enum": [ - "PAGELESS", - "PAGINATED" + "parameters": { + "httpHealthCheck": { + "description": "Name of the HttpHealthCheck resource to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/httpHealthChecks/{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" ] }, - "standbyPolicy": { - "description": "Standby policy for stopped and suspended instances.", - "$ref": "InstanceGroupManagerStandbyPolicy" - }, - "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" - }, - "resourcePolicies": { - "description": "Resource policies for this managed instance group.", - "$ref": "InstanceGroupManagerResourcePolicies" - } - } - }, - "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." + "insert": { + "description": "Creates a HttpHealthCheck resource in the specified project using the data\nincluded in the request.", + "flatPath": "projects/{project}/global/httpHealthChecks", + "httpMethod": "POST", + "id": "compute.httpHealthChecks.insert", + "parameterOrder": [ + "project" ], - "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" - ] + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } }, - "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" + "path": "projects/{project}/global/httpHealthChecks", + "request": { + "$ref": "HttpHealthCheck" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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" - } + "list": { + "description": "Retrieves the list of HttpHealthCheck resources available to the specified\nproject.", + "flatPath": "projects/{project}/global/httpHealthChecks", + "httpMethod": "GET", + "id": "compute.httpHealthChecks.list", + "parameterOrder": [ + "project" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/global/httpHealthChecks", + "response": { + "$ref": "HttpHealthCheckList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "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" - } - } - }, - "InstanceGroupManagerStandbyPolicy": { - "id": "InstanceGroupManagerStandbyPolicy", - "type": "object", - "properties": { - "initialDelaySec": { - "description": "Specifies the number of seconds that the MIG should wait to suspend or stop a VM after that VM was created. The initial delay gives the initialization script the time to prepare your VM for a quick scale out. The value of initial delay must be between 0 and 3600 seconds. The default value is 0.", - "type": "integer", - "format": "int32" + "patch": { + "description": "Updates a HttpHealthCheck resource in the specified project using the data\nincluded in the request. This method supportsPATCH\nsemantics and uses theJSON merge\npatch format and processing rules.", + "flatPath": "projects/{project}/global/httpHealthChecks/{httpHealthCheck}", + "httpMethod": "PATCH", + "id": "compute.httpHealthChecks.patch", + "parameterOrder": [ + "project", + "httpHealthCheck" + ], + "parameters": { + "httpHealthCheck": { + "description": "Name of the HttpHealthCheck resource to patch.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/httpHealthChecks/{httpHealthCheck}", + "request": { + "$ref": "HttpHealthCheck" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "mode": { - "description": "Defines how a MIG resumes or starts VMs from a standby pool when the group scales out. The default mode is `MANUAL`.", - "type": "string", - "enumDescriptions": [ - "MIG does not automatically resume or start VMs in the standby pool when the group scales out.", - "MIG automatically resumes or starts VMs in the standby pool when the group scales out, and replenishes the standby pool afterwards." + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource.", + "flatPath": "projects/{project}/global/httpHealthChecks/{resource}/testIamPermissions", + "httpMethod": "POST", + "id": "compute.httpHealthChecks.testIamPermissions", + "parameterOrder": [ + "project", + "resource" ], - "enum": [ - "MANUAL", - "SCALE_OUT_POOL" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/httpHealthChecks/{resource}/testIamPermissions", + "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" ] - } - } - }, - "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" + "update": { + "description": "Updates a HttpHealthCheck resource in the specified project using the data\nincluded in the request.", + "flatPath": "projects/{project}/global/httpHealthChecks/{httpHealthCheck}", + "httpMethod": "PUT", + "id": "compute.httpHealthChecks.update", + "parameterOrder": [ + "project", + "httpHealthCheck" + ], + "parameters": { + "httpHealthCheck": { + "description": "Name of the HttpHealthCheck resource to update.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/httpHealthChecks/{httpHealthCheck}", + "request": { + "$ref": "HttpHealthCheck" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] } } }, - "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." + "httpsHealthChecks": { + "methods": { + "delete": { + "description": "Deletes the specified HttpsHealthCheck resource.", + "flatPath": "projects/{project}/global/httpsHealthChecks/{httpsHealthCheck}", + "httpMethod": "DELETE", + "id": "compute.httpsHealthChecks.delete", + "parameterOrder": [ + "project", + "httpsHealthCheck" ], - "enum": [ - "OPPORTUNISTIC", - "PROACTIVE" + "parameters": { + "httpsHealthCheck": { + "description": "Name of the HttpsHealthCheck resource to delete.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/httpsHealthChecks/{httpsHealthCheck}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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." + "get": { + "description": "Returns the specified HttpsHealthCheck resource.", + "flatPath": "projects/{project}/global/httpsHealthChecks/{httpsHealthCheck}", + "httpMethod": "GET", + "id": "compute.httpsHealthChecks.get", + "parameterOrder": [ + "project", + "httpsHealthCheck" ], - "enum": [ - "NONE", - "PROACTIVE" + "parameters": { + "httpsHealthCheck": { + "description": "Name of the HttpsHealthCheck resource to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/httpsHealthChecks/{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" ] }, - "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." + "insert": { + "description": "Creates a HttpsHealthCheck resource in the specified project using the data\nincluded in the request.", + "flatPath": "projects/{project}/global/httpsHealthChecks", + "httpMethod": "POST", + "id": "compute.httpsHealthChecks.insert", + "parameterOrder": [ + "project" ], - "enum": [ - "NONE", - "REFRESH", - "REPLACE", - "RESTART" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/httpsHealthChecks", + "request": { + "$ref": "HttpsHealthCheck" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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." + "list": { + "description": "Retrieves the list of HttpsHealthCheck resources available to the specified\nproject.", + "flatPath": "projects/{project}/global/httpsHealthChecks", + "httpMethod": "GET", + "id": "compute.httpsHealthChecks.list", + "parameterOrder": [ + "project" ], - "enum": [ - "NONE", - "REFRESH", - "REPLACE", - "RESTART" + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/global/httpsHealthChecks", + "response": { + "$ref": "HttpsHealthCheckList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "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)" + "patch": { + "description": "Updates a HttpsHealthCheck resource in the specified project using the data\nincluded in the request. This method supportsPATCH\nsemantics and uses theJSON merge\npatch format and processing rules.", + "flatPath": "projects/{project}/global/httpsHealthChecks/{httpsHealthCheck}", + "httpMethod": "PATCH", + "id": "compute.httpsHealthChecks.patch", + "parameterOrder": [ + "project", + "httpsHealthCheck" ], - "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" - } + "parameters": { + "httpsHealthCheck": { + "description": "Name of the HttpsHealthCheck resource to patch.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/httpsHealthChecks/{httpsHealthCheck}", + "request": { + "$ref": "HttpsHealthCheck" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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" - } + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource.", + "flatPath": "projects/{project}/global/httpsHealthChecks/{resource}/testIamPermissions", + "httpMethod": "POST", + "id": "compute.httpsHealthChecks.testIamPermissions", + "parameterOrder": [ + "project", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/httpsHealthChecks/{resource}/testIamPermissions", + "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" + ] }, - "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": [ - "", - "" + "update": { + "description": "Updates a HttpsHealthCheck resource in the specified project using the data\nincluded in the request.", + "flatPath": "projects/{project}/global/httpsHealthChecks/{httpsHealthCheck}", + "httpMethod": "PUT", + "id": "compute.httpsHealthChecks.update", + "parameterOrder": [ + "project", + "httpsHealthCheck" ], - "enum": [ - "NEVER", - "ON_PERMANENT_INSTANCE_DELETION" + "parameters": { + "httpsHealthCheck": { + "description": "Name of the HttpsHealthCheck resource to update.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/httpsHealthChecks/{httpsHealthCheck}", + "request": { + "$ref": "HttpsHealthCheck" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] } } }, - "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": [ - "", - "" + "imageFamilyViews": { + "methods": { + "get": { + "description": "Returns the latest image that is part of an image family, is not\ndeprecated and is rolled out in the specified zone.", + "flatPath": "projects/{project}/zones/{zone}/imageFamilyViews/{family}", + "httpMethod": "GET", + "id": "compute.imageFamilyViews.get", + "parameterOrder": [ + "project", + "zone", + "family" ], - "enum": [ - "NEVER", - "ON_PERMANENT_INSTANCE_DELETION" + "parameters": { + "family": { + "description": "Name of the image family to search for.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/imageFamilyViews/{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" ] } } }, - "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": [ - "", - "" + "images": { + "methods": { + "delete": { + "description": "Deletes the specified image.", + "flatPath": "projects/{project}/global/images/{image}", + "httpMethod": "DELETE", + "id": "compute.images.delete", + "parameterOrder": [ + "project", + "image" ], - "enum": [ - "NO", - "YES" + "parameters": { + "image": { + "description": "Name of the image resource to delete.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/images/{image}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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." + "deprecate": { + "description": "Sets the deprecation status of an image.\n\nIf an empty request body is given, clears the deprecation status instead.", + "flatPath": "projects/{project}/global/images/{image}/deprecate", + "httpMethod": "POST", + "id": "compute.images.deprecate", + "parameterOrder": [ + "project", + "image" ], - "enum": [ - "DO_NOTHING", - "REPAIR" + "parameters": { + "image": { + "description": "Image name.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/images/{image}/deprecate", + "request": { + "$ref": "DeprecationStatus" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] - } - } - }, - "InstanceGroupManagerResourcePolicies": { - "id": "InstanceGroupManagerResourcePolicies", - "type": "object", - "properties": { - "workloadPolicy": { - "description": "The URL of the workload policy that is specified for this managed instance group. It can be a full or partial URL. For example, the following are all valid URLs to a workload policy: - https://www.googleapis.com/compute/v1/projects/project/regions/region /resourcePolicies/resourcePolicy - projects/project/regions/region/resourcePolicies/resourcePolicy - regions/region/resourcePolicies/resourcePolicy ", - "type": "string" - } - } - }, - "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" + "get": { + "description": "Returns the specified image.", + "flatPath": "projects/{project}/global/images/{image}", + "httpMethod": "GET", + "id": "compute.images.get", + "parameterOrder": [ + "project", + "image" + ], + "parameters": { + "image": { + "description": "Name of the image resource to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/images/{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" + ] }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "getFromFamily": { + "description": "Returns the latest image that is part of an image family and is not\ndeprecated. For more information on image families, seePublic\nimage families documentation.", + "flatPath": "projects/{project}/global/images/family/{family}", + "httpMethod": "GET", + "id": "compute.images.getFromFamily", + "parameterOrder": [ + "project", + "family" + ], + "parameters": { + "family": { + "description": "Name of the image family to search for.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "The image project that the image belongs to. For example, to get a CentOS\nimage, specify centos-cloud as the image project.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/images/family/{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" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "getIamPolicy": { + "description": "Gets the access control policy for a resource. May be empty if no such\npolicy or resource exists.", + "flatPath": "projects/{project}/global/images/{resource}/getIamPolicy", + "httpMethod": "GET", + "id": "compute.images.getIamPolicy", + "parameterOrder": [ + "project", + "resource" + ], + "parameters": { + "optionsRequestedPolicyVersion": { + "description": "Requested IAM Policy version.", + "format": "int32", + "location": "query", + "type": "integer" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "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" - } + }, + "path": "projects/{project}/global/images/{resource}/getIamPolicy", + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "insert": { + "description": "Creates an image in the specified project using the data included\nin the request.", + "flatPath": "projects/{project}/global/images", + "httpMethod": "POST", + "id": "compute.images.insert", + "parameterOrder": [ + "project" + ], + "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.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "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" - } - } - }, - "InstanceGroupManagersSuspendInstancesRequest": { - "id": "InstanceGroupManagersSuspendInstancesRequest", - "type": "object", - "properties": { - "instances": { - "description": "The URLs of one or more instances to suspend. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].", - "type": "array", - "items": { - "type": "string" - } - }, - "forceSuspend": { - "description": "If this flag is set to true, the Instance Group Manager will proceed to suspend the instances, skipping initialization on them.", - "type": "boolean" - } - } - }, - "InstanceGroupManagersResumeInstancesRequest": { - "id": "InstanceGroupManagersResumeInstancesRequest", - "type": "object", - "properties": { - "instances": { - "description": "The URLs of one or more instances to resume. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "InstanceGroupManagersStopInstancesRequest": { - "id": "InstanceGroupManagersStopInstancesRequest", - "type": "object", - "properties": { - "instances": { - "description": "The URLs of one or more instances to stop. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].", - "type": "array", - "items": { - "type": "string" - } - }, - "forceStop": { - "description": "If this flag is set to true, the Instance Group Manager will proceed to stop the instances, skipping initialization on them.", - "type": "boolean" - } - } - }, - "InstanceGroupManagersStartInstancesRequest": { - "id": "InstanceGroupManagersStartInstancesRequest", - "type": "object", - "properties": { - "instances": { - "description": "The URLs of one or more instances to start. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "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" + }, + "path": "projects/{project}/global/images", + "request": { + "$ref": "Image" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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)." + "list": { + "description": "Retrieves the list of custom images\navailable to the specified project. Custom images are images you\ncreate that belong to your project. This method does not\nget any images that belong to other projects, including publicly-available\nimages, like Debian 8. If you want to get a list of publicly-available\nimages, use this method to make a request to the respective image project,\nsuch as debian-cloud or windows-cloud.", + "flatPath": "projects/{project}/global/images", + "httpMethod": "GET", + "id": "compute.images.list", + "parameterOrder": [ + "project" ], - "enum": [ - "ABANDONING", - "CREATING", - "CREATING_WITHOUT_RETRIES", - "DELETING", - "NONE", - "RECREATING", - "REFRESHING", - "RESTARTING", - "RESUMING", - "STARTING", - "STOPPING", - "SUSPENDING", - "VERIFYING" + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/global/images", + "response": { + "$ref": "ImageList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "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." + "patch": { + "description": "Patches the specified image with the data included in the request.\nOnly the following fields can be modified: family, description,\ndeprecation status.", + "flatPath": "projects/{project}/global/images/{image}", + "httpMethod": "PATCH", + "id": "compute.images.patch", + "parameterOrder": [ + "project", + "image" ], - "enum": [ - "READ_ONLY", - "READ_WRITE" + "parameters": { + "image": { + "description": "Name of the image resource to patch.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/images/{image}", + "request": { + "$ref": "Image" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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": [ - "", - "" + "setIamPolicy": { + "description": "Sets the access control policy on the specified resource.\nReplaces any existing policy.", + "flatPath": "projects/{project}/global/images/{resource}/setIamPolicy", + "httpMethod": "POST", + "id": "compute.images.setIamPolicy", + "parameterOrder": [ + "project", + "resource" ], - "enum": [ - "NEVER", - "ON_PERMANENT_INSTANCE_DELETION" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/images/{resource}/setIamPolicy", + "request": { + "$ref": "GlobalSetPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] - } - } - }, - "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": [ - "", - "" + }, + "setLabels": { + "description": "Sets the labels on an image. To learn more about labels, read theLabeling\nResources documentation.", + "flatPath": "projects/{project}/global/images/{resource}/setLabels", + "httpMethod": "POST", + "id": "compute.images.setLabels", + "parameterOrder": [ + "project", + "resource" ], - "enum": [ - "NEVER", - "ON_PERMANENT_INSTANCE_DELETION" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/images/{resource}/setLabels", + "request": { + "$ref": "GlobalSetLabelsRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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." + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource.", + "flatPath": "projects/{project}/global/images/{resource}/testIamPermissions", + "httpMethod": "POST", + "id": "compute.images.testIamPermissions", + "parameterOrder": [ + "project", + "resource" ], - "enum": [ - "DRAINING", - "HEALTHY", - "TIMEOUT", - "UNHEALTHY", - "UNKNOWN" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/images/{resource}/testIamPermissions", + "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" ] } } }, - "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" - } - } - } - } - } - } + "instanceGroupManagerResizeRequests": { + "methods": { + "cancel": { + "description": "Cancels the specified resize request and removes it from the queue.\nCancelled resize request does no longer wait for the resources to be\nprovisioned. Cancel is only possible for requests that are accepted in the\nqueue.", + "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/resizeRequests/{resizeRequest}/cancel", + "httpMethod": "POST", + "id": "compute.instanceGroupManagerResizeRequests.cancel", + "parameterOrder": [ + "project", + "zone", + "instanceGroupManager", + "resizeRequest" + ], + "parameters": { + "instanceGroupManager": { + "description": "The name of the managed instance group.\nThe name should conform to RFC1035 or be a resource ID.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "resizeRequest": { + "description": "The name of the resize request to cancel.\nThe name should conform to RFC1035 or be a resource ID.", + "location": "path", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of thezone where the managed\ninstance group is located. The name should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" } - } - } - } - }, - "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" + }, + "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/resizeRequests/{resizeRequest}/cancel", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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)." + "delete": { + "description": "Deletes the specified, inactive resize request. Requests that are still\nactive cannot be deleted. Deleting request does not delete instances that\nwere provisioned previously.", + "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/resizeRequests/{resizeRequest}", + "httpMethod": "DELETE", + "id": "compute.instanceGroupManagerResizeRequests.delete", + "parameterOrder": [ + "project", + "zone", + "instanceGroupManager", + "resizeRequest" ], - "enum": [ - "ABANDONING", - "CREATING", - "CREATING_WITHOUT_RETRIES", - "DELETING", - "NONE", - "RECREATING", - "REFRESHING", - "RESTARTING", - "RESUMING", - "STARTING", - "STOPPING", - "SUSPENDING", - "VERIFYING" + "parameters": { + "instanceGroupManager": { + "description": "The name of the managed instance group.\nThe name should conform to RFC1035 or be a resource ID.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "resizeRequest": { + "description": "The name of the resize request to delete.\nThe name should conform to RFC1035 or be a resource ID.", + "location": "path", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of thezone where the managed\ninstance group is located. The name should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/resizeRequests/{resizeRequest}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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" - } + "get": { + "description": "Returns all of the details about the specified resize request.", + "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/resizeRequests/{resizeRequest}", + "httpMethod": "GET", + "id": "compute.instanceGroupManagerResizeRequests.get", + "parameterOrder": [ + "project", + "zone", + "instanceGroupManager", + "resizeRequest" + ], + "parameters": { + "instanceGroupManager": { + "description": "The name of the managed instance group.\nName should conform to RFC1035 or be a resource ID.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "resizeRequest": { + "description": "The name of the resize request.\nName 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\">zone\nscoping this request. Name should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/resizeRequests/{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" + ] }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the 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": { + "description": "Creates a new resize request that starts provisioning VMs immediately\nor queues VM creation.", + "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/resizeRequests", + "httpMethod": "POST", + "id": "compute.instanceGroupManagerResizeRequests.insert", + "parameterOrder": [ + "project", + "zone", + "instanceGroupManager" + ], + "parameters": { + "instanceGroupManager": { + "description": "The name of the managed instance group to which the resize request will\nbe added.\nName should conform to RFC1035 or be a resource ID.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of thezone where the managed\ninstance group is located and where the resize request will be created.\nName should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/resizeRequests", + "request": { + "$ref": "InstanceGroupManagerResizeRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "list": { + "description": "Retrieves a list of resize requests that are contained in the\nmanaged instance group.", + "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/resizeRequests", + "httpMethod": "GET", + "id": "compute.instanceGroupManagerResizeRequests.list", + "parameterOrder": [ + "project", + "zone", + "instanceGroupManager" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "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. 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" - } - } - } + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "zone": { + "description": "The name of thezone where the managed\ninstance group is located. The name should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" } - } + }, + "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/resizeRequests", + "response": { + "$ref": "InstanceGroupManagerResizeRequestsListResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] } } }, - "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 configuration 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." + "instanceGroupManagers": { + "methods": { + "abandonInstances": { + "description": "Flags the specified instances to be removed from the\nmanaged instance group. Abandoning an instance does not delete the\ninstance, but it does remove the instance from any target pools that are\napplied by the managed instance group. This method reduces thetargetSize of the managed instance group by the\nnumber of instances that you abandon. This operation is marked asDONE when the action is scheduled even if the instances have\nnot yet been removed from the group. You must separately verify the\nstatus of the abandoning action with thelistmanagedinstances\nmethod.\n\nIf the group is part of a backend\nservice that has enabled\nconnection draining, it can take up to 60 seconds after the connection\ndraining duration has elapsed before the VM instance is removed or deleted.\n\nYou can specify a maximum of 1000 instances with this method per request.", + "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/abandonInstances", + "httpMethod": "POST", + "id": "compute.instanceGroupManagers.abandonInstances", + "parameterOrder": [ + "project", + "zone", + "instanceGroupManager" ], - "enum": [ - "APPLYING", - "DELETING", - "EFFECTIVE", - "NONE", - "UNAPPLIED", - "UNAPPLIED_DELETION" + "parameters": { + "instanceGroupManager": { + "description": "The name of the managed instance group.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of thezone where the managed\ninstance group is located.", + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/abandonInstances", + "request": { + "$ref": "InstanceGroupManagersAbandonInstancesRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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." + "aggregatedList": { + "description": "Retrieves the list of managed instance groups and groups them by zone.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", + "flatPath": "projects/{project}/aggregated/instanceGroupManagers", + "httpMethod": "GET", + "id": "compute.instanceGroupManagers.aggregatedList", + "parameterOrder": [ + "project" ], - "enum": [ - "NONE", - "REFRESH", - "REPLACE", - "RESTART" + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region,\nglobal) should be included in the response. For new resource types added\nafter this field, the flag has no effect as new resource types will always\ninclude every visible scope for each scope type in response. For resource\ntypes which predate this field, if this flag is omitted or false, only\nscopes of the scope types where the resource type is expected to be found\nwill be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which\naggregated list request is invoked for subnetworks list-usable api.", + "format": "int64", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/aggregated/instanceGroupManagers", + "response": { + "$ref": "InstanceGroupManagerAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "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." + "applyUpdatesToInstances": { + "description": "Applies changes to selected instances on the managed instance group.\nThis method can be used to apply new overrides and/or new versions.", + "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/applyUpdatesToInstances", + "httpMethod": "POST", + "id": "compute.instanceGroupManagers.applyUpdatesToInstances", + "parameterOrder": [ + "project", + "zone", + "instanceGroupManager" ], - "enum": [ - "NONE", - "REFRESH", - "REPLACE", - "RESTART" + "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.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of thezone\nwhere the managed instance group is located. Should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/applyUpdatesToInstances", + "request": { + "$ref": "InstanceGroupManagersApplyUpdatesRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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" - ] + "createInstances": { + "description": "Creates instances with per-instance configurations in this managed instance\ngroup. Instances are created using the current instance template. Thecreate instances operation is marked DONE if thecreateInstances request is successful. The underlying actions\ntake additional time. You must separately verify the status of thecreating or actions with the listmanagedinstances\nmethod.", + "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/createInstances", + "httpMethod": "POST", + "id": "compute.instanceGroupManagers.createInstances", + "parameterOrder": [ + "project", + "zone", + "instanceGroupManager" + ], + "parameters": { + "instanceGroupManager": { + "description": "The name of the managed instance group.\nIt should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of thezone\nwhere the managed instance group is located.\nIt should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + } }, - "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" + "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/createInstances", + "request": { + "$ref": "InstanceGroupManagersCreateInstancesRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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" + "delete": { + "description": "Deletes the specified managed instance group and all of the instances\nin that group. Note that the instance group must not belong to a\nbackend service. Read\nDeleting an instance group for more information.", + "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}", + "httpMethod": "DELETE", + "id": "compute.instanceGroupManagers.delete", + "parameterOrder": [ + "project", + "zone", + "instanceGroupManager" + ], + "parameters": { + "instanceGroupManager": { + "description": "The name of the managed instance group to delete.", + "location": "path", + "required": true, + "type": "string" + }, + "noGracefulShutdown": { + "default": "false", + "description": "When set, graceful shutdown is skipped for instance deletion even if it's\nconfigured for the instances.", + "location": "query", + "type": "boolean" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of thezone where the managed\ninstance group is located.", + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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" + "deleteInstances": { + "description": "Flags the specified instances in the managed instance group for immediate\ndeletion. The instances are also removed from any target\npools of which they were a member. This method reduces thetargetSize of the managed instance group by the number of\ninstances that you delete. This operation is marked as DONE\nwhen the action is scheduled even if the instances are still being deleted.\nYou must separately verify the status of the deleting action\nwith thelistmanagedinstances\nmethod.\n\nIf the group is part of a backend\nservice that has enabled\nconnection draining, it can take up to 60 seconds after the connection\ndraining duration has elapsed before the VM instance is removed or deleted.\n\nYou can specify a maximum of 1000 instances with this method per request.", + "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/deleteInstances", + "httpMethod": "POST", + "id": "compute.instanceGroupManagers.deleteInstances", + "parameterOrder": [ + "project", + "zone", + "instanceGroupManager" + ], + "parameters": { + "instanceGroupManager": { + "description": "The name of the managed instance group.", + "location": "path", + "required": true, + "type": "string" + }, + "noGracefulShutdown": { + "default": "false", + "description": "When set, graceful shutdown is skipped for instance deletion even if it's\nconfigured for the instances.", + "location": "query", + "type": "boolean" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of thezone where the managed\ninstance group is located.", + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/deleteInstances", + "request": { + "$ref": "InstanceGroupManagersDeleteInstancesRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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." + "deletePerInstanceConfigs": { + "description": "Deletes selected per-instance configurations for the managed instance\ngroup.", + "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/deletePerInstanceConfigs", + "httpMethod": "POST", + "id": "compute.instanceGroupManagers.deletePerInstanceConfigs", + "parameterOrder": [ + "project", + "zone", + "instanceGroupManager" ], - "enum": [ - "ACCEPTED", - "CANCELLED", - "CREATING", - "FAILED", - "STATE_UNSPECIFIED", - "SUCCEEDED" + "parameters": { + "instanceGroupManager": { + "description": "The name of the managed instance group.\nIt should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of thezone\nwhere the managed instance\ngroup is located.\nIt should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/deletePerInstanceConfigs", + "request": { + "$ref": "InstanceGroupManagersDeletePerInstanceConfigsReq" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "status": { - "description": "[Output only] Status of the request.", - "$ref": "InstanceGroupManagerResizeRequestStatus" + "get": { + "description": "Returns all of the details about the specified managed instance group.", + "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}", + "httpMethod": "GET", + "id": "compute.instanceGroupManagers.get", + "parameterOrder": [ + "project", + "zone", + "instanceGroupManager" + ], + "parameters": { + "instanceGroupManager": { + "description": "The name of the managed instance group.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of thezone where the managed\ninstance group is located.", + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{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" + ] }, - "selfLink": { - "description": "[Output Only] The URL for this resize request. The server defines this URL.", - "type": "string" + "insert": { + "description": "Creates a managed instance group using the information that you specify\nin the request. After the group is created, instances in the group are\ncreated using the specified instance template.\nThis operation is marked as DONE when the group is created\neven if the instances in the group have not yet been created. You\nmust separately verify the status of the individual instances with thelistmanagedinstances\nmethod.\n\nA managed instance group can have up to 1000 VM instances per group. Please\ncontact Cloud Support if you need an increase in\nthis limit.", + "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers", + "httpMethod": "POST", + "id": "compute.instanceGroupManagers.insert", + "parameterOrder": [ + "project", + "zone" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone\nwhere you want to create the managed instance group.", + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instanceGroupManagers", + "request": { + "$ref": "InstanceGroupManager" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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" - } - } - } - } - } - } + "list": { + "description": "Retrieves a list of managed instance groups that are contained within the\nspecified project and zone.", + "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers", + "httpMethod": "GET", + "id": "compute.instanceGroupManagers.list", + "parameterOrder": [ + "project", + "zone" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "zone": { + "description": "The name of thezone where the managed\ninstance group is located.", + "location": "path", + "required": true, + "type": "string" } - } - } - } - }, - "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" + }, + "path": "projects/{project}/zones/{zone}/instanceGroupManagers", + "response": { + "$ref": "InstanceGroupManagerList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "listErrors": { + "description": "Lists all errors thrown by actions on instances for a given managed\ninstance group. The filter and orderBy query\nparameters are not supported.", + "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/listErrors", + "httpMethod": "GET", + "id": "compute.instanceGroupManagers.listErrors", + "parameterOrder": [ + "project", + "zone", + "instanceGroupManager" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "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.\nIt must be a string that meets the requirements in RFC1035, or an\nunsigned long integer: must match regexp pattern:\n(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?)|1-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": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "zone": { + "description": "The name of thezone where the managed\ninstance group is located.\nIt should conform to RFC1035.", + "location": "path", + "required": true, + "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" + }, + "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/listErrors", + "response": { + "$ref": "InstanceGroupManagersListErrorsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "listManagedInstances": { + "description": "Lists all of the instances in the managed instance group. Each instance\nin the list has a currentAction, which indicates the action\nthat the managed instance group is performing on the instance. For example,\nif the group is still creating an instance, the currentAction\nis CREATING. If a previous action failed, the\nlist displays the errors for that failed action. The orderBy\nquery parameter is not supported. The `pageToken` query parameter is\nsupported only if the group's `listManagedInstancesResults` field is set\nto `PAGINATED`.", + "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/listManagedInstances", + "httpMethod": "POST", + "id": "compute.instanceGroupManagers.listManagedInstances", + "parameterOrder": [ + "project", + "zone", + "instanceGroupManager" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "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.", + "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": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "zone": { + "description": "The name of thezone where the managed\ninstance group is located.", + "location": "path", + "required": true, + "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" - } - } - }, - "RegionInstanceGroupManagersSuspendInstancesRequest": { - "id": "RegionInstanceGroupManagersSuspendInstancesRequest", - "type": "object", - "properties": { - "instances": { - "description": "The URLs of one or more instances to suspend. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].", - "type": "array", - "items": { - "type": "string" - } + }, + "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/listManagedInstances", + "response": { + "$ref": "InstanceGroupManagersListManagedInstancesResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "forceSuspend": { - "description": "If this flag is set to true, the Instance Group Manager will proceed to suspend the instances, skipping initialization on them.", - "type": "boolean" - } - } - }, - "RegionInstanceGroupManagersResumeInstancesRequest": { - "id": "RegionInstanceGroupManagersResumeInstancesRequest", - "type": "object", - "properties": { - "instances": { - "description": "The URLs of one or more instances to resume. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "RegionInstanceGroupManagersStopInstancesRequest": { - "id": "RegionInstanceGroupManagersStopInstancesRequest", - "type": "object", - "properties": { - "instances": { - "description": "The URLs of one or more instances to stop. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].", - "type": "array", - "items": { - "type": "string" - } - }, - "forceStop": { - "description": "If this flag is set to true, the Instance Group Manager will proceed to stop the instances, skipping initialization on them.", - "type": "boolean" - } - } - }, - "RegionInstanceGroupManagersStartInstancesRequest": { - "id": "RegionInstanceGroupManagersStartInstancesRequest", - "type": "object", - "properties": { - "instances": { - "description": "The URLs of one or more instances to start. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "listPerInstanceConfigs": { + "description": "Lists all of the per-instance configurations defined for the managed\ninstance group. The orderBy query parameter is not supported.", + "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/listPerInstanceConfigs", + "httpMethod": "POST", + "id": "compute.instanceGroupManagers.listPerInstanceConfigs", + "parameterOrder": [ + "project", + "zone", + "instanceGroupManager" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "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": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "zone": { + "description": "The name of thezone\nwhere the managed instance group is located.\nIt should conform to RFC1035.", + "location": "path", + "required": true, + "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" + }, + "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/listPerInstanceConfigs", + "response": { + "$ref": "InstanceGroupManagersListPerInstanceConfigsResp" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "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." + "patch": { + "description": "Updates a managed instance group using the information that you specify\nin the request.\nThis operation is marked as DONE when the group is patched\neven if the instances in the group are still in the process of being\npatched. You must separately verify the status of the individual instances\nwith thelistManagedInstances\nmethod. This method supportsPATCH\nsemantics and uses theJSON merge\npatch format and processing rules.\n\nIf you update your group to specify a new template or instance\nconfiguration, it's possible that your intended specification for each VM\nin the group is different from the current state of that VM. To learn how\nto apply an updated configuration to the VMs in a MIG, seeUpdating instances in\na MIG.", + "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}", + "httpMethod": "PATCH", + "id": "compute.instanceGroupManagers.patch", + "parameterOrder": [ + "project", + "zone", + "instanceGroupManager" ], - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "parameters": { + "instanceGroupManager": { + "description": "The name of the instance group manager.", + "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.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone where\nyou want to create the managed instance group.", + "location": "path", + "required": true, + "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" + "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}", + "request": { + "$ref": "InstanceGroupManager" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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" + "patchPerInstanceConfigs": { + "description": "Inserts or patches per-instance configurations for the managed instance\ngroup. perInstanceConfig.name serves as a key used to\ndistinguish whether to perform insert or patch.", + "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/patchPerInstanceConfigs", + "httpMethod": "POST", + "id": "compute.instanceGroupManagers.patchPerInstanceConfigs", + "parameterOrder": [ + "project", + "zone", + "instanceGroupManager" ], - "enum": [ - "ACTIVE", - "DELETING", - "ERROR", - "PENDING" + "parameters": { + "instanceGroupManager": { + "description": "The name of the managed instance group.\nIt should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of thezone\nwhere the managed instance group is located.\nIt should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/patchPerInstanceConfigs", + "request": { + "$ref": "InstanceGroupManagersPatchPerInstanceConfigsReq" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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." + "recreateInstances": { + "description": "Flags the specified VM instances in the managed instance group to be\nimmediately recreated. Each instance is recreated using the group's current\nconfiguration. This operation is marked as DONE when the flag\nis set even if the instances have not yet been recreated. You must\nseparately verify the status of each instance by checking itscurrentAction field; for more information, see Checking\nthe status of managed instances.\n\nIf the group is part of a backend\nservice that has enabled\nconnection draining, it can take up to 60 seconds after the connection\ndraining duration has elapsed before the VM instance is removed or deleted.\n\nYou can specify a maximum of 1000 instances with this method per request.", + "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/recreateInstances", + "httpMethod": "POST", + "id": "compute.instanceGroupManagers.recreateInstances", + "parameterOrder": [ + "project", + "zone", + "instanceGroupManager" ], - "enum": [ - "OFF", - "ON", - "ONLY_SCALE_OUT", - "ONLY_UP" + "parameters": { + "instanceGroupManager": { + "description": "The name of the managed instance group.", + "location": "path", + "required": true, + "type": "string" + }, + "noGracefulShutdown": { + "default": "false", + "description": "When set, graceful shutdown is skipped for instance recreation even if it's\nconfigured for the instances.", + "location": "query", + "type": "boolean" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of thezone where the managed\ninstance group is located.", + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/recreateInstances", + "request": { + "$ref": "InstanceGroupManagersRecreateInstancesRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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." + "resize": { + "description": "Resizes the managed instance group. If you increase the size, the group\ncreates new instances using the current instance template. If you decrease\nthe size, the group deletes instances. The resize operation is markedDONE when the resize actions are scheduled even if the group\nhas not yet added or deleted any instances. You must separately\nverify the status of the creating or deleting\nactions with thelistmanagedinstances\nmethod.\n\nWhen resizing down, the instance group arbitrarily chooses the order in\nwhich VMs are deleted. The group takes into account some VM attributes when\nmaking the selection including:\n\n+ The status of the VM instance.\n+ The health of the VM instance.\n+ The instance template version the VM is based on.\n+ For regional managed instance groups, the location of the VM instance.\n\nThis list is subject to change.\n\nIf the group is part of a backend\nservice that has enabled\nconnection draining, it can take up to 60 seconds after the connection\ndraining duration has elapsed before the VM instance is removed or deleted.", + "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/resize", + "httpMethod": "POST", + "id": "compute.instanceGroupManagers.resize", + "parameterOrder": [ + "project", + "zone", + "instanceGroupManager", + "size" ], - "enum": [ - "NONE", - "OPTIMIZE_AVAILABILITY" + "parameters": { + "instanceGroupManager": { + "description": "The name of the managed instance group.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "size": { + "description": "The number of running instances that the managed instance group should\nmaintain at any given time. The group automatically adds or removes\ninstances to maintain the number of instances specified by this parameter.", + "format": "int32", + "location": "query", + "required": true, + "type": "integer" + }, + "zone": { + "description": "The name of thezone where the managed\ninstance group is located.", + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/resize", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] - } - } - }, - "AutoscalingPolicyCustomMetricUtilization": { - "id": "AutoscalingPolicyCustomMetricUtilization", - "description": "Custom utilization metric policy.", - "type": "object", - "properties": { - "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" - }, - "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" }, - "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." + "resumeInstances": { + "description": "Flags the specified instances in the managed instance group to be\nresumed. This method increases thetargetSize and decreases the targetSuspendedSize\nof the managed instance group by the number of instances that you resume.\nThe resumeInstances operation is marked DONE if\nthe resumeInstances request is successful. The underlying\nactions take additional time. You must separately verify the status of theRESUMING action with thelistmanagedinstances\nmethod.\n\nIn this request, you can only specify instances that are suspended. For\nexample, if an instance was previously suspended using the suspendInstances\nmethod, it can be resumed using the resumeInstances method.\n\nIf a health check is attached to the managed instance group, the specified\ninstances will be verified as healthy after they are resumed.\n\nYou can specify a maximum of 1000 instances with this method per request.", + "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/resumeInstances", + "httpMethod": "POST", + "id": "compute.instanceGroupManagers.resumeInstances", + "parameterOrder": [ + "project", + "zone", + "instanceGroupManager" ], - "enum": [ - "DELTA_PER_MINUTE", - "DELTA_PER_SECOND", - "GAUGE" + "parameters": { + "instanceGroupManager": { + "description": "The name of the managed instance group.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of thezone where the managed\ninstance group is located.", + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/resumeInstances", + "request": { + "$ref": "InstanceGroupManagersResumeInstancesRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] - } - } - }, - "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." + "setInstanceTemplate": { + "description": "Specifies the instance template to use when creating new instances in this\ngroup. The templates for existing instances in the group do not change\nunless you run recreateInstances, runapplyUpdatesToInstances, or set the group'supdatePolicy.type to PROACTIVE.", + "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/setInstanceTemplate", + "httpMethod": "POST", + "id": "compute.instanceGroupManagers.setInstanceTemplate", + "parameterOrder": [ + "project", + "zone", + "instanceGroupManager" ], - "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" + "parameters": { + "instanceGroupManager": { + "description": "The name of the managed instance group.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of thezone where the managed\ninstance group is located.", + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/setInstanceTemplate", + "request": { + "$ref": "InstanceGroupManagersSetInstanceTemplateRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] - } - } - }, - "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." + "setTargetPools": { + "description": "Modifies the target pools to which all instances in this managed instance\ngroup are assigned. The target pools automatically apply to all of the\ninstances in the managed instance group. This operation is markedDONE when you make the request even if the instances have not\nyet been added to their target pools. The change might take some time to\napply to all of the instances in the group depending on the size of the\ngroup.", + "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/setTargetPools", + "httpMethod": "POST", + "id": "compute.instanceGroupManagers.setTargetPools", + "parameterOrder": [ + "project", + "zone", + "instanceGroupManager" ], - "enum": [ - "ACTIVE", - "DISABLED", - "OBSOLETE", - "READY" + "parameters": { + "instanceGroupManager": { + "description": "The name of the managed instance group.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of thezone where the managed\ninstance group is located.", + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/setTargetPools", + "request": { + "$ref": "InstanceGroupManagersSetTargetPoolsRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] - } - } - }, - "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" + "startInstances": { + "description": "Flags the specified instances in the managed instance group to be\nstarted. This method increases thetargetSize and decreases the targetStoppedSize\nof the managed instance group by the number of instances that you start.\nThe startInstances operation is marked DONE if\nthe startInstances request is successful. The underlying\nactions take additional time. You must separately verify the status of theSTARTING action with thelistmanagedinstances\nmethod.\n\nIn this request, you can only specify instances that are stopped. For\nexample, if an instance was previously stopped using the stopInstances\nmethod, it can be started using the startInstances method.\n\nIf a health check is attached to the managed instance group, the specified\ninstances will be verified as healthy after they are started.\n\nYou can specify a maximum of 1000 instances with this method per request.", + "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/startInstances", + "httpMethod": "POST", + "id": "compute.instanceGroupManagers.startInstances", + "parameterOrder": [ + "project", + "zone", + "instanceGroupManager" + ], + "parameters": { + "instanceGroupManager": { + "description": "The name of the managed instance group.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of thezone where the managed\ninstance group is located.", + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/startInstances", + "request": { + "$ref": "InstanceGroupManagersStartInstancesRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "stopInstances": { + "description": "Flags the specified instances in the managed instance group to be\nimmediately stopped. You can only specify instances that are running in\nthis request. This method reduces thetargetSize and increases the targetStoppedSize\nof the managed instance group by the number of instances that you stop.\nThe stopInstances operation is marked DONE if\nthe stopInstances request is successful. The underlying\nactions take additional time. You must separately verify the status of theSTOPPING action with thelistmanagedinstances\nmethod.\n\nIf the standbyPolicy.initialDelaySec field is set, the group\ndelays stopping the instances until initialDelaySec have\npassed from instance.creationTimestamp (that is, when the\ninstance was created). This delay gives your application time to\nset itself up and initialize on the instance. If more thaninitialDelaySec seconds have passed sinceinstance.creationTimestamp when this method is called, there\nwill be zero delay.\n\nIf the group is part of a backend\nservice that has enabled\nconnection draining, it can take up to 60 seconds after the connection\ndraining duration has elapsed before the VM instance is stopped.\n\nStopped instances can be started using the startInstances\nmethod.\n\nYou can specify a maximum of 1000 instances with this method per request.", + "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/stopInstances", + "httpMethod": "POST", + "id": "compute.instanceGroupManagers.stopInstances", + "parameterOrder": [ + "project", + "zone", + "instanceGroupManager" + ], + "parameters": { + "instanceGroupManager": { + "description": "The name of the managed instance group.", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "noGracefulShutdown": { + "default": "false", + "description": "When set, graceful shutdown is skipped for instance stopping even if it's\nconfigured for the instances.", + "location": "query", + "type": "boolean" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of thezone where the managed\ninstance group is located.", + "location": "path", + "required": true, + "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" - } + }, + "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/stopInstances", + "request": { + "$ref": "InstanceGroupManagersStopInstancesRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "suspendInstances": { + "description": "Flags the specified instances in the managed instance group to be\nimmediately suspended. You can only specify instances that are running in\nthis request. This method reduces thetargetSize and increases the targetSuspendedSize\nof the managed instance group by the number of instances that you suspend.\nThe suspendInstances operation is marked DONE if\nthe suspendInstances request is successful. The underlying\nactions take additional time. You must separately verify the status of theSUSPENDING action with thelistmanagedinstances\nmethod.\n\nIf the standbyPolicy.initialDelaySec field is set, the group\ndelays suspension of the instances until initialDelaySec have\npassed from instance.creationTimestamp (that is, when the\ninstance was created). This delay gives your application time to\nset itself up and initialize on the instance. If more thaninitialDelaySec seconds have passed sinceinstance.creationTimestamp when this method is called, there\nwill be zero delay.\n\nIf the group is part of a backend\nservice that has enabled\nconnection draining, it can take up to 60 seconds after the connection\ndraining duration has elapsed before the VM instance is suspended.\n\nSuspended instances can be resumed using the resumeInstances\nmethod.\n\nYou can specify a maximum of 1000 instances with this method per request.", + "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/suspendInstances", + "httpMethod": "POST", + "id": "compute.instanceGroupManagers.suspendInstances", + "parameterOrder": [ + "project", + "zone", + "instanceGroupManager" + ], + "parameters": { + "instanceGroupManager": { + "description": "The 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.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of thezone where the managed\ninstance group is located.", + "location": "path", + "required": true, + "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" + }, + "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/suspendInstances", + "request": { + "$ref": "InstanceGroupManagersSuspendInstancesRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "updatePerInstanceConfigs": { + "description": "Inserts or updates per-instance configurations for the managed instance\ngroup. perInstanceConfig.name serves as a key used to\ndistinguish whether to perform insert or patch.", + "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/updatePerInstanceConfigs", + "httpMethod": "POST", + "id": "compute.instanceGroupManagers.updatePerInstanceConfigs", + "parameterOrder": [ + "project", + "zone", + "instanceGroupManager" + ], + "parameters": { + "instanceGroupManager": { + "description": "The name of the managed instance group.\nIt 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.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of thezone\nwhere the managed instance group is located.\nIt should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" } - } + }, + "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/updatePerInstanceConfigs", + "request": { + "$ref": "InstanceGroupManagersUpdatePerInstanceConfigsReq" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] } } }, - "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" + "instanceGroups": { + "methods": { + "addInstances": { + "description": "Adds a list of instances to the specified instance group. All of the\ninstances in the instance group must be in the same network/subnetwork.\nRead \nAdding instances for more information.", + "flatPath": "projects/{project}/zones/{zone}/instanceGroups/{instanceGroup}/addInstances", + "httpMethod": "POST", + "id": "compute.instanceGroups.addInstances", + "parameterOrder": [ + "project", + "zone", + "instanceGroup" + ], + "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.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone\nwhere the instance group is located.", + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instanceGroups/{instanceGroup}/addInstances", + "request": { + "$ref": "InstanceGroupsAddInstancesRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "aggregatedList": { + "description": "Retrieves the list of instance groups and sorts them by zone.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", + "flatPath": "projects/{project}/aggregated/instanceGroups", + "httpMethod": "GET", + "id": "compute.instanceGroups.aggregatedList", + "parameterOrder": [ + "project" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "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,\nglobal) should be included in the response. For new resource types added\nafter this field, the flag has no effect as new resource types will always\ninclude every visible scope for each scope type in response. For resource\ntypes which predate this field, if this flag is omitted or false, only\nscopes of the scope types where the resource type is expected to be found\nwill be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`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\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which\naggregated list request is invoked for subnetworks list-usable api.", + "format": "int64", + "location": "query", + "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" + }, + "path": "projects/{project}/aggregated/instanceGroups", + "response": { + "$ref": "InstanceGroupAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "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." + "delete": { + "description": "Deletes the specified instance group. The instances in the group are not\ndeleted. Note that instance group must not belong to a backend service.\nRead\nDeleting an instance group for more information.", + "flatPath": "projects/{project}/zones/{zone}/instanceGroups/{instanceGroup}", + "httpMethod": "DELETE", + "id": "compute.instanceGroups.delete", + "parameterOrder": [ + "project", + "zone", + "instanceGroup" ], - "enum": [ - "AUTOMATIC", - "DISABLED" + "parameters": { + "instanceGroup": { + "description": "The name of the instance group to delete.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone\nwhere the instance group is located.", + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instanceGroups/{instanceGroup}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "loadBalancingScheme": { - "description": "The value can only be INTERNAL_MANAGED for cross-region internal layer 7 load balancer. If loadBalancingScheme is not specified, the backend bucket can be used by classic global external load balancers, or global application external load balancers, or both.", - "type": "string", - "enumDescriptions": [ - "Signifies that this will be used for internal Application Load Balancers." + "get": { + "description": "Returns the specified zonal instance group. Get a list of available zonal\ninstance groups by making a list() request.\n\nFor managed instance groups, use theinstanceGroupManagers\nor regionInstanceGroupManagers\nmethods instead.", + "flatPath": "projects/{project}/zones/{zone}/instanceGroups/{instanceGroup}", + "httpMethod": "GET", + "id": "compute.instanceGroups.get", + "parameterOrder": [ + "project", + "zone", + "instanceGroup" ], - "enum": [ - "INTERNAL_MANAGED" + "parameters": { + "instanceGroup": { + "description": "The name of the instance group.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone\nwhere the instance group is located.", + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instanceGroups/{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" ] }, - "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. If no value is provided for cdnPolicy.cacheMode, it defaults to CACHE_ALL_STATIC.", - "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." + "insert": { + "description": "Creates an instance group in the specified project using the\nparameters that are included in the request.", + "flatPath": "projects/{project}/zones/{zone}/instanceGroups", + "httpMethod": "POST", + "id": "compute.instanceGroups.insert", + "parameterOrder": [ + "project", + "zone" ], - "enum": [ - "CACHE_ALL_STATIC", - "FORCE_CACHE_ALL", - "INVALID_CACHE_MODE", - "USE_ORIGIN_HEADERS" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone\nwhere you want to create the instance group.", + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instanceGroups", + "request": { + "$ref": "InstanceGroup" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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-maxage). 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" + "list": { + "description": "Retrieves the list of zonal instance group resources contained within the\nspecified zone.\n\nFor managed instance groups, use theinstanceGroupManagers\nor regionInstanceGroupManagers\nmethods instead.", + "flatPath": "projects/{project}/zones/{zone}/instanceGroups", + "httpMethod": "GET", + "id": "compute.instanceGroups.list", + "parameterOrder": [ + "project", + "zone" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "zone": { + "description": "The name of thezone\nwhere the instance group is located.", + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instanceGroups", + "response": { + "$ref": "InstanceGroupList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "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" + "listInstances": { + "description": "Lists the instances in the specified instance group.\nThe orderBy query parameter is not supported.\nThe filter query parameter is supported, but only for\nexpressions that use `eq` (equal) or `ne` (not equal) operators.", + "flatPath": "projects/{project}/zones/{zone}/instanceGroups/{instanceGroup}/listInstances", + "httpMethod": "POST", + "id": "compute.instanceGroups.listInstances", + "parameterOrder": [ + "project", + "zone", + "instanceGroup" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "instanceGroup": { + "description": "The name of the instance group from which you want to generate a list\nof included instances.", + "location": "path", + "required": true, + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "zone": { + "description": "The name of the zone\nwhere the instance group is located.", + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instanceGroups/{instanceGroup}/listInstances", + "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" + ] }, - "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" + "removeInstances": { + "description": "Removes one or more instances from the specified instance group, but does\nnot delete those instances.\n\nIf the group is part of a backend\nservice that has enabled\nconnection draining, it can take up to 60 seconds after the connection\ndraining duration before the VM instance is removed or deleted.", + "flatPath": "projects/{project}/zones/{zone}/instanceGroups/{instanceGroup}/removeInstances", + "httpMethod": "POST", + "id": "compute.instanceGroups.removeInstances", + "parameterOrder": [ + "project", + "zone", + "instanceGroup" + ], + "parameters": { + "instanceGroup": { + "description": "The name of the instance group where the specified instances will be\nremoved.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone\nwhere the instance group is located.", + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instanceGroups/{instanceGroup}/removeInstances", + "request": { + "$ref": "InstanceGroupsRemoveInstancesRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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-maxage) 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" + "setNamedPorts": { + "description": "Sets the named ports for the specified instance group.", + "flatPath": "projects/{project}/zones/{zone}/instanceGroups/{instanceGroup}/setNamedPorts", + "httpMethod": "POST", + "id": "compute.instanceGroups.setNamedPorts", + "parameterOrder": [ + "project", + "zone", + "instanceGroup" + ], + "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.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone\nwhere the instance group is located.", + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instanceGroups/{instanceGroup}/setNamedPorts", + "request": { + "$ref": "InstanceGroupsSetNamedPortsRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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" + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource.", + "flatPath": "projects/{project}/zones/{zone}/instanceGroups/{resource}/testIamPermissions", + "httpMethod": "POST", + "id": "compute.instanceGroups.testIamPermissions", + "parameterOrder": [ + "project", + "zone", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instanceGroups/{resource}/testIamPermissions", + "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" + ] } } }, - "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" + "instanceSettings": { + "methods": { + "get": { + "description": "Get Instance settings.", + "flatPath": "projects/{project}/zones/{zone}/instanceSettings", + "httpMethod": "GET", + "id": "compute.instanceSettings.get", + "parameterOrder": [ + "project", + "zone" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "zone": { + "description": "Name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instanceSettings", + "response": { + "$ref": "InstanceSettings" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "patch": { + "description": "Patch Instance settings", + "flatPath": "projects/{project}/zones/{zone}/instanceSettings", + "httpMethod": "PATCH", + "id": "compute.instanceSettings.patch", + "parameterOrder": [ + "project", + "zone" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(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" - } - } - } + "updateMask": { + "description": "update_mask indicates fields to be updated as part of this request.", + "format": "google-fieldmask", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The zone scoping this request. It should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" } - } + }, + "path": "projects/{project}/zones/{zone}/instanceSettings", + "request": { + "$ref": "InstanceSettings" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] } } }, - "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 unless haPolicy is specified. Backend services with internet or serverless NEG backends must not have a health check. healthChecks[] cannot be specified with haPolicy.", - "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, H2C, 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).", - "HTTP2 over cleartext", - "", - "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." + "instanceTemplates": { + "methods": { + "aggregatedList": { + "description": "Retrieves the list of all InstanceTemplates resources, regional and global,\navailable to the specified project.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", + "flatPath": "projects/{project}/aggregated/instanceTemplates", + "httpMethod": "GET", + "id": "compute.instanceTemplates.aggregatedList", + "parameterOrder": [ + "project" ], - "enum": [ - "GRPC", - "H2C", - "HTTP", - "HTTP2", - "HTTPS", - "SSL", - "TCP", - "UDP", - "UNSPECIFIED" + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region,\nglobal) should be included in the response. For new resource types added\nafter this field, the flag has no effect as new resource types will always\ninclude every visible scope for each scope type in response. For resource\ntypes which predate this field, if this flag is omitted or false, only\nscopes of the scope types where the resource type is expected to be found\nwill be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Name of the project scoping this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which\naggregated list request is invoked for subnetworks list-usable api.", + "format": "int64", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/aggregated/instanceTemplates", + "response": { + "$ref": "InstanceTemplateAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "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" + "delete": { + "description": "Deletes the specified instance template. Deleting an instance template is\npermanent and cannot be undone. It is not possible to delete templates\nthat are already in use by a managed instance group.", + "flatPath": "projects/{project}/global/instanceTemplates/{instanceTemplate}", + "httpMethod": "DELETE", + "id": "compute.instanceTemplates.delete", + "parameterOrder": [ + "project", + "instanceTemplate" + ], + "parameters": { + "instanceTemplate": { + "description": "The name of the instance template to delete.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/instanceTemplates/{instanceTemplate}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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). sessionAffinity cannot be specified with haPolicy.", - "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." + "get": { + "description": "Returns the specified instance template.", + "flatPath": "projects/{project}/global/instanceTemplates/{instanceTemplate}", + "httpMethod": "GET", + "id": "compute.instanceTemplates.get", + "parameterOrder": [ + "project", + "instanceTemplate" ], - "enum": [ - "CLIENT_IP", - "CLIENT_IP_NO_DESTINATION", - "CLIENT_IP_PORT_PROTO", - "CLIENT_IP_PROTO", - "GENERATED_COOKIE", - "HEADER_FIELD", - "HTTP_COOKIE", - "NONE", - "STRONG_COOKIE_AFFINITY" + "parameters": { + "instanceTemplate": { + "description": "The name of the instance template.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/instanceTemplates/{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" ] }, - "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). failoverPolicy cannot be specified with haPolicy.", - "$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.", - "" + "getIamPolicy": { + "description": "Gets the access control policy for a resource. May be empty if no such\npolicy or resource exists.", + "flatPath": "projects/{project}/global/instanceTemplates/{resource}/getIamPolicy", + "httpMethod": "GET", + "id": "compute.instanceTemplates.getIamPolicy", + "parameterOrder": [ + "project", + "resource" ], - "enum": [ - "EXTERNAL", - "EXTERNAL_MANAGED", - "INTERNAL", - "INTERNAL_MANAGED", - "INTERNAL_SELF_MANAGED", - "INVALID_LOAD_BALANCING_SCHEME" + "parameters": { + "optionsRequestedPolicyVersion": { + "description": "Requested IAM Policy version.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/instanceTemplates/{resource}/getIamPolicy", + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "connectionDraining": { - "description": "connectionDraining cannot be specified with haPolicy.", - "$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, HTTP2 or H2C, 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. localityLbPolicy cannot be specified with haPolicy.", - "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.", - "Per-endpoint weighted round-robin Load Balancing using weights computed from Backend reported Custom Metrics. If set, the Backend Service responses are expected to contain non-standard HTTP response header field X-Endpoint-Load-Metrics. The reported metrics to use for computing the weights are specified via the backends[].customMetrics fields." + "insert": { + "description": "Creates an instance template in the specified project using the\ndata that is included in the request. If you are creating a new template to\nupdate an existing instance group, your new instance template must use the\nsame network or, if applicable, the same subnetwork as the original\ntemplate.", + "flatPath": "projects/{project}/global/instanceTemplates", + "httpMethod": "POST", + "id": "compute.instanceTemplates.insert", + "parameterOrder": [ + "project" ], - "enum": [ - "INVALID_LB_POLICY", - "LEAST_REQUEST", - "MAGLEV", - "ORIGINAL_DESTINATION", - "RANDOM", - "RING_HASH", - "ROUND_ROBIN", - "WEIGHTED_MAGLEV", - "WEIGHTED_ROUND_ROBIN" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/instanceTemplates", + "request": { + "$ref": "InstanceTemplate" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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, HTTP2 or H2C, 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, HTTP2 or H2C, 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 must be set for Internal Passthrough Network Load Balancers when the haPolicy is enabled, and for External Passthrough Network Load Balancers when the haPolicy fastIpMove is enabled. This field can only be specified when the load balancing scheme is set to INTERNAL, or when the load balancing scheme is set to EXTERNAL and haPolicy fastIpMove is enabled.", - "type": "string" - }, - "subsetting": { - "description": "subsetting cannot be specified with haPolicy.", - "$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. connectionTrackingPolicy cannot be specified with haPolicy.", - "$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." + "list": { + "description": "Retrieves a list of instance templates that are contained within\nthe specified project.", + "flatPath": "projects/{project}/global/instanceTemplates", + "httpMethod": "GET", + "id": "compute.instanceTemplates.list", + "parameterOrder": [ + "project" ], - "enum": [ - "AUTOMATIC", - "DISABLED" + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/global/instanceTemplates", + "response": { + "$ref": "InstanceTemplateList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "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" - } - }, - "externalManagedMigrationState": { - "description": "Specifies the canary migration state. Possible values are PREPARE, TEST_BY_PERCENTAGE, and TEST_ALL_TRAFFIC. To begin the migration from EXTERNAL to EXTERNAL_MANAGED, the state must be changed to PREPARE. The state must be changed to TEST_ALL_TRAFFIC before the loadBalancingScheme can be changed to EXTERNAL_MANAGED. Optionally, the TEST_BY_PERCENTAGE state can be used to migrate traffic by percentage using externalManagedMigrationTestingPercentage. Rolling back a migration requires the states to be set in reverse order. So changing the scheme from EXTERNAL_MANAGED to EXTERNAL requires the state to be set to TEST_ALL_TRAFFIC at the same time. Optionally, the TEST_BY_PERCENTAGE state can be used to migrate some traffic back to EXTERNAL or PREPARE can be used to migrate all traffic back to EXTERNAL.", - "type": "string", - "enumDescriptions": [ - "", - "", - "" + "setIamPolicy": { + "description": "Sets the access control policy on the specified resource.\nReplaces any existing policy.", + "flatPath": "projects/{project}/global/instanceTemplates/{resource}/setIamPolicy", + "httpMethod": "POST", + "id": "compute.instanceTemplates.setIamPolicy", + "parameterOrder": [ + "project", + "resource" ], - "enum": [ - "PREPARE", - "TEST_ALL_TRAFFIC", - "TEST_BY_PERCENTAGE" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/instanceTemplates/{resource}/setIamPolicy", + "request": { + "$ref": "GlobalSetPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "externalManagedMigrationTestingPercentage": { - "description": "Determines the fraction of requests that should be processed by the Global external Application Load Balancer. The value of this field must be in the range [0, 100]. Session affinity options will slightly affect this routing behavior, for more details, see: Session Affinity. This value can only be set if the loadBalancingScheme in the BackendService is set to EXTERNAL (when using the classic Application Load Balancer) and the migration state is TEST_BY_PERCENTAGE.", - "type": "number", - "format": "float" - }, - "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)." + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource.", + "flatPath": "projects/{project}/global/instanceTemplates/{resource}/testIamPermissions", + "httpMethod": "POST", + "id": "compute.instanceTemplates.testIamPermissions", + "parameterOrder": [ + "project", + "resource" ], - "enum": [ - "IPV4_ONLY", - "IPV6_ONLY", - "IP_ADDRESS_SELECTION_POLICY_UNSPECIFIED", - "PREFER_IPV6" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/instanceTemplates/{resource}/testIamPermissions", + "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" ] - }, - "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" - } - }, - "haPolicy": { - "description": "Configures self-managed High Availability (HA) for External and Internal Protocol Forwarding. The backends of this regional backend service must only specify zonal network endpoint groups (NEGs) of type GCE_VM_IP. When haPolicy is set for an Internal Passthrough Network Load Balancer, the regional backend service must set the network field. All zonal NEGs must belong to the same network. However, individual NEGs can belong to different subnetworks of that network. When haPolicy is specified, the set of attached network endpoints across all backends comprise an High Availability domain from which one endpoint is selected as the active endpoint (the leader) that receives all traffic. haPolicy can be added only at backend service creation time. Once set up, it cannot be deleted. Note that haPolicy is not for load balancing, and therefore cannot be specified with sessionAffinity, connectionTrackingPolicy, and failoverPolicy. haPolicy requires customers to be responsible for tracking backend endpoint health and electing a leader among the healthy endpoints. Therefore, haPolicy cannot be specified with healthChecks. haPolicy can only be specified for External Passthrough Network Load Balancers and Internal Passthrough Network Load Balancers.", - "$ref": "BackendServiceHAPolicy" - }, - "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" - }, - "customMetrics": { - "description": "List of custom metrics that are used for the WEIGHTED_ROUND_ROBIN locality_lb_policy.", - "type": "array", - "items": { - "$ref": "BackendServiceCustomMetric" - } } } }, - "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. If haPolicy is specified, backends must refer to NEG resources of type GCE_VM_IP.", - "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.", - "Based on custom defined and reported metrics.", - "Balance based on requests per second (RPS).", - "Balance based on the backend utilization." + "instances": { + "methods": { + "addAccessConfig": { + "description": "Adds an access config to an instance's network interface.", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/addAccessConfig", + "httpMethod": "POST", + "id": "compute.instances.addAccessConfig", + "parameterOrder": [ + "project", + "zone", + "instance", + "networkInterface" ], - "enum": [ - "CONNECTION", - "CUSTOM_METRICS", - "RATE", - "UTILIZATION" + "parameters": { + "instance": { + "description": "The instance name for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "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.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instances/{instance}/addAccessConfig", + "request": { + "$ref": "AccessConfig" + }, + "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." + "addNetworkInterface": { + "description": "Adds one dynamic network interface to an active instance.", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/addNetworkInterface", + "httpMethod": "POST", + "id": "compute.instances.addNetworkInterface", + "parameterOrder": [ + "project", + "zone", + "instance" ], - "enum": [ - "DEFAULT", - "PREFERENCE_UNSPECIFIED", - "PREFERRED" + "parameters": { + "instance": { + "description": "The instance name for this request stored as resource_id.\nName should conform to RFC1035 or be an unsigned long integer.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instances/{instance}/addNetworkInterface", + "request": { + "$ref": "NetworkInterface" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "customMetrics": { - "description": "List of custom metrics that are used for CUSTOM_METRICS BalancingMode.", - "type": "array", - "items": { - "$ref": "BackendCustomMetric" - } - } - } - }, - "BackendCustomMetric": { - "id": "BackendCustomMetric", - "description": "Custom Metrics are used for CUSTOM_METRICS balancing_mode.", - "type": "object", - "properties": { - "name": { - "description": "Name of a custom utilization signal. The name must be 1-64 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, period, underscore, lowercase letter, or digit, except the last character, which cannot be a dash, period, or underscore. For usage guidelines, see Custom Metrics balancing mode. This field can only be used for a global or regional backend service with the loadBalancingScheme set to EXTERNAL_MANAGED, INTERNAL_MANAGED INTERNAL_SELF_MANAGED.", - "type": "string" - }, - "maxUtilization": { - "description": "Optional parameter to define a target utilization for the Custom Metrics balancing mode. The valid range is [0.0, 1.0].", - "type": "number", - "format": "float" - }, - "dryRun": { - "description": "If true, the metric data is collected and reported to Cloud Monitoring, but is not used for load balancing.", - "type": "boolean" - } - } - }, - "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. If no value is provided for cdnPolicy.cacheMode, it defaults to CACHE_ALL_STATIC.", - "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." + "addResourcePolicies": { + "description": "Adds existing resource policies to an instance. You can only add one\npolicy right now which will be applied to this instance for scheduling live\nmigrations.", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/addResourcePolicies", + "httpMethod": "POST", + "id": "compute.instances.addResourcePolicies", + "parameterOrder": [ + "project", + "zone", + "instance" ], - "enum": [ - "CACHE_ALL_STATIC", - "FORCE_CACHE_ALL", - "INVALID_CACHE_MODE", - "USE_ORIGIN_HEADERS" + "parameters": { + "instance": { + "description": "The instance name for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instances/{instance}/addResourcePolicies", + "request": { + "$ref": "InstancesAddResourcePoliciesRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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-maxage). 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-maxage) 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." + "aggregatedList": { + "description": "Retrieves an aggregated list of all of the instances in your project\nacross all regions and zones.\n\nThe performance of this method degrades when a filter is specified on a\nproject that has a very large number of instances.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", + "flatPath": "projects/{project}/aggregated/instances", + "httpMethod": "GET", + "id": "compute.instances.aggregatedList", + "parameterOrder": [ + "project" ], - "enum": [ - "CUSTOM", - "EXCLUDE_ALL_OPTIONAL", - "INCLUDE_ALL_OPTIONAL" + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region,\nglobal) should be included in the response. For new resource types added\nafter this field, the flag has no effect as new resource types will always\ninclude every visible scope for each scope type in response. For resource\ntypes which predate this field, if this flag is omitted or false, only\nscopes of the scope types where the resource type is expected to be found\nwill be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which\naggregated list request is invoked for subnetworks list-usable api.", + "format": "int64", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/aggregated/instances", + "response": { + "$ref": "InstanceAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "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." + "attachDisk": { + "description": "Attaches an existing Disk resource to an instance. You must first\ncreate the disk before you can attach it. It is not possible to create\nand attach a disk at the same time. For more information, readAdding a\npersistent disk to your instance.", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/attachDisk", + "httpMethod": "POST", + "id": "compute.instances.attachDisk", + "parameterOrder": [ + "project", + "zone", + "instance" ], - "enum": [ - "CONSISTENT_HASH_SUBSETTING", - "NONE" + "parameters": { + "forceAttach": { + "description": "Whether to force attach the regional disk even if it's currently attached\nto another instance. If you try to force attach a zonal disk to an\ninstance, you will receive an error.", + "location": "query", + "type": "boolean" + }, + "instance": { + "description": "The instance name for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instances/{instance}/attachDisk", + "request": { + "$ref": "AttachedDisk" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] - } - } - }, - "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": [ - "", - "", - "" + }, + "bulkInsert": { + "description": "Creates multiple instances. Count specifies the number of instances to\ncreate. For more information, seeAbout bulk\ncreation of VMs.", + "flatPath": "projects/{project}/zones/{zone}/instances/bulkInsert", + "httpMethod": "POST", + "id": "compute.instances.bulkInsert", + "parameterOrder": [ + "project", + "zone" ], - "enum": [ - "INVALID_TRACKING_MODE", - "PER_CONNECTION", - "PER_SESSION" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instances/bulkInsert", + "request": { + "$ref": "BulkInsertInstanceResource" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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": [ - "", - "", - "" + "delete": { + "description": "Deletes the specified Instance resource. For more information, seeDeleting\nan instance.", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}", + "httpMethod": "DELETE", + "id": "compute.instances.delete", + "parameterOrder": [ + "project", + "zone", + "instance" ], - "enum": [ - "ALWAYS_PERSIST", - "DEFAULT_FOR_PROTOCOL", - "NEVER_PERSIST" + "parameters": { + "instance": { + "description": "Name of the instance resource to delete.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "noGracefulShutdown": { + "description": "If set to true, Graceful Shutdown is skipped.", + "location": "query", + "type": "boolean" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instances/{instance}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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.", - "Per-endpoint weighted round-robin Load Balancing using weights computed from Backend reported Custom Metrics. If set, the Backend Service responses are expected to contain non-standard HTTP response header field X-Endpoint-Load-Metrics. The reported metrics to use for computing the weights are specified via the backends[].customMetrics fields." + "deleteAccessConfig": { + "description": "Deletes an access config from an instance's network interface.", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/deleteAccessConfig", + "httpMethod": "POST", + "id": "compute.instances.deleteAccessConfig", + "parameterOrder": [ + "project", + "zone", + "instance", + "accessConfig", + "networkInterface" ], - "enum": [ - "INVALID_LB_POLICY", - "LEAST_REQUEST", - "MAGLEV", - "ORIGINAL_DESTINATION", - "RANDOM", - "RING_HASH", - "ROUND_ROBIN", - "WEIGHTED_MAGLEV", - "WEIGHTED_ROUND_ROBIN" + "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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "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.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instances/{instance}/deleteAccessConfig", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] - } - } - }, - "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" - } - } - }, - "BackendServiceHAPolicy": { - "id": "BackendServiceHAPolicy", - "type": "object", - "properties": { - "fastIPMove": { - "description": "Specifies whether fast IP move is enabled, and if so, the mechanism to achieve it. Supported values are: - DISABLED: Fast IP Move is disabled. You can only use the haPolicy.leader API to update the leader. - \u003eGARP_RA: Provides a method to very quickly define a new network endpoint as the leader. This method is faster than updating the leader using the haPolicy.leader API. Fast IP move works as follows: The VM hosting the network endpoint that should become the new leader sends either a Gratuitous ARP (GARP) packet (IPv4) or an ICMPv6 Router Advertisement(RA) packet (IPv6). Google Cloud immediately but temporarily associates the forwarding rule IP address with that VM, and both new and in-flight packets are quickly delivered to that VM. Note the important properties of the Fast IP Move functionality: - The GARP/RA-initiated re-routing stays active for approximately 20 minutes. After triggering fast failover, you must also appropriately set the haPolicy.leader. - The new leader instance should continue to send GARP/RA packets periodically every 10 seconds until at least 10 minutes after updating the haPolicy.leader (but stop immediately if it is no longer the leader). - After triggering a fast failover, we recommend that you wait at least 3 seconds before sending another GARP/RA packet from a different VM instance to avoid race conditions. - Don't send GARP/RA packets from different VM instances at the same time. If multiple instances continue to send GARP/RA packets, traffic might be routed to different destinations in an alternating order. This condition ceases when a single instance issues a GARP/RA packet. - The GARP/RA request always takes priority over the leader API. Using the haPolicy.leader API to change the leader to a different instance will have no effect until the GARP/RA request becomes inactive. - The GARP/RA packets should follow the GARP/RA Packet Specifications.. - When multiple forwarding rules refer to a regional backend service, you need only send a GARP or RA packet for a single forwarding rule virtual IP. The virtual IPs for all forwarding rules targeting the same backend service will also be moved to the sender of the GARP or RA packet. The following are the Fast IP Move limitations (that is, when fastIPMove is not DISABLED): - Multiple forwarding rules cannot use the same IP address if one of them refers to a regional backend service with fastIPMove. - The regional backend service must set the network field, and all NEGs must belong to that network. However, individual NEGs can belong to different subnetworks of that network. - The maximum number of network endpoints across all backends of a backend service with fastIPMove is 32. - The maximum number of backend services with fastIPMove that can have the same network endpoint attached to one of its backends is 64. - The maximum number of backend services with fastIPMove in a VPC in a region is 64. - The network endpoints that are attached to a backend of a backend service with fastIPMove cannot resolve to Gen3+ machines for IPv6. - Traffic directed to the leader by a static route next hop will not be redirected to a new leader by fast failover. Such traffic will only be redirected once an haPolicy.leader update has taken effect. Only traffic to the forwarding rule's virtual IP will be redirected to a new leader by fast failover. haPolicy.fastIPMove can be set only at backend service creation time. Once set, it cannot be updated. By default, fastIpMove is set to DISABLED.", - "type": "string", - "enumDescriptions": [ - "", - "" + "deleteNetworkInterface": { + "description": "Deletes one dynamic network interface from an active instance.\nInstancesDeleteNetworkInterfaceRequest indicates:\n- instance from which to delete, using project+zone+resource_id fields;\n- dynamic network interface to be deleted, using network_interface_name\nfield;", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/deleteNetworkInterface", + "httpMethod": "POST", + "id": "compute.instances.deleteNetworkInterface", + "parameterOrder": [ + "project", + "zone", + "instance", + "networkInterfaceName" ], - "enum": [ - "DISABLED", - "GARP_RA" + "parameters": { + "instance": { + "description": "The instance name for this request stored as resource_id.\nName should conform to RFC1035 or be an unsigned long integer.", + "location": "path", + "required": true, + "type": "string" + }, + "networkInterfaceName": { + "description": "The name of the dynamic network interface to be deleted from the instance.", + "location": "query", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instances/{instance}/deleteNetworkInterface", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "leader": { - "description": "Selects one of the network endpoints attached to the backend NEGs of this service as the active endpoint (the leader) that receives all traffic. When the leader changes, there is no connection draining to persist existing connections on the old leader. You are responsible for selecting a suitable endpoint as the leader. For example, preferring a healthy endpoint over unhealthy ones. Note that this service does not track backend endpoint health, and selects the configured leader unconditionally.", - "$ref": "BackendServiceHAPolicyLeader" - } - } - }, - "BackendServiceHAPolicyLeader": { - "id": "BackendServiceHAPolicyLeader", - "type": "object", - "properties": { - "backendGroup": { - "description": "A fully-qualified URL (starting with https://www.googleapis.com/) of the zonal Network Endpoint Group (NEG) with `GCE_VM_IP` endpoints that the leader is attached to. The leader's backendGroup must already be specified as a backend of this backend service. Removing a backend that is designated as the leader's backendGroup is not permitted.", - "type": "string" - }, - "networkEndpoint": { - "description": "The network endpoint within the leader.backendGroup that is designated as the leader. This network endpoint cannot be detached from the NEG specified in the haPolicy.leader.backendGroup until the leader is updated with another network endpoint, or the leader is removed from the haPolicy.", - "$ref": "BackendServiceHAPolicyLeaderNetworkEndpoint" - } - } - }, - "BackendServiceHAPolicyLeaderNetworkEndpoint": { - "id": "BackendServiceHAPolicyLeaderNetworkEndpoint", - "type": "object", - "properties": { - "instance": { - "description": "The name of the VM instance of the leader network endpoint. The instance must already be attached to the NEG specified in the haPolicy.leader.backendGroup. The name must be 1-63 characters long, and comply with RFC1035. Authorization requires the following IAM permission on the specified resource instance: compute.instances.use", - "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" - }, - "path": { - "description": "Path to set for the cookie.", - "type": "string" - }, - "ttl": { - "description": "Lifetime of the cookie.", - "$ref": "Duration" - } - } - }, - "BackendServiceCustomMetric": { - "id": "BackendServiceCustomMetric", - "description": "Custom Metrics are used for WEIGHTED_ROUND_ROBIN locality_lb_policy.", - "type": "object", - "properties": { - "name": { - "description": "Name of a custom utilization signal. The name must be 1-64 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, period, underscore, lowercase letter, or digit, except the last character, which cannot be a dash, period, or underscore. For usage guidelines, see Custom Metrics balancing mode. This field can only be used for a global or regional backend service with the loadBalancingScheme set to EXTERNAL_MANAGED, INTERNAL_MANAGED INTERNAL_SELF_MANAGED.", - "type": "string" - }, - "dryRun": { - "description": "If true, the metric data is not used for load balancing.", - "type": "boolean" - } - } - }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "detachDisk": { + "description": "Detaches a disk from an instance.", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/detachDisk", + "httpMethod": "POST", + "id": "compute.instances.detachDisk", + "parameterOrder": [ + "project", + "zone", + "instance", + "deviceName" + ], + "parameters": { + "deviceName": { + "description": "The device name of the disk to detach. Make a get() request on\nthe instance to view currently attached disks and device names.", + "location": "query", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "instance": { + "description": "Instance name for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "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.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "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" - } + }, + "path": "projects/{project}/zones/{zone}/instances/{instance}/detachDisk", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "get": { + "description": "Returns the specified Instance resource.", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}", + "httpMethod": "GET", + "id": "compute.instances.get", + "parameterOrder": [ + "project", + "zone", + "instance" + ], + "parameters": { + "instance": { + "description": "Name of the instance resource to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "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" + }, + "path": "projects/{project}/zones/{zone}/instances/{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" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "getEffectiveFirewalls": { + "description": "Returns effective firewalls applied to an interface of the instance.", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/getEffectiveFirewalls", + "httpMethod": "GET", + "id": "compute.instances.getEffectiveFirewalls", + "parameterOrder": [ + "project", + "zone", + "instance", + "networkInterface" + ], + "parameters": { + "instance": { + "description": "Name of the instance scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "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 get the effective firewalls.", + "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.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "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": { - "weight": { - "type": "string" + }, + "path": "projects/{project}/zones/{zone}/instances/{instance}/getEffectiveFirewalls", + "response": { + "$ref": "InstancesGetEffectiveFirewallsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "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." + "getGuestAttributes": { + "description": "Returns the specified guest attributes entry.", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/getGuestAttributes", + "httpMethod": "GET", + "id": "compute.instances.getGuestAttributes", + "parameterOrder": [ + "project", + "zone", + "instance" ], - "enum": [ - "INVALID_WEIGHT", - "MISSING_WEIGHT", - "UNAVAILABLE_WEIGHT", - "WEIGHT_NONE" + "parameters": { + "instance": { + "description": "Name of the instance scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instances/{instance}/getGuestAttributes", + "response": { + "$ref": "GuestAttributes" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "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" + "getIamPolicy": { + "description": "Gets the access control policy for a resource. May be empty if no such\npolicy or resource exists.", + "flatPath": "projects/{project}/zones/{zone}/instances/{resource}/getIamPolicy", + "httpMethod": "GET", + "id": "compute.instances.getIamPolicy", + "parameterOrder": [ + "project", + "zone", + "resource" + ], + "parameters": { + "optionsRequestedPolicyVersion": { + "description": "Requested IAM Policy version.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instances/{resource}/getIamPolicy", + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "port": { - "description": "The named port of the instance group, not necessarily the port that is health-checked.", - "type": "integer", - "format": "int32" + "getScreenshot": { + "description": "Returns the screenshot from the specified instance.", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/screenshot", + "httpMethod": "GET", + "id": "compute.instances.getScreenshot", + "parameterOrder": [ + "project", + "zone", + "instance" + ], + "parameters": { + "instance": { + "description": "Name of the instance scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instances/{instance}/screenshot", + "response": { + "$ref": "Screenshot" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "instance": { - "description": "URL of the instance resource.", - "type": "string" + "getSerialPortOutput": { + "description": "Returns the last 1 MB of serial port output from the specified instance.", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/serialPort", + "httpMethod": "GET", + "id": "compute.instances.getSerialPortOutput", + "parameterOrder": [ + "project", + "zone", + "instance" + ], + "parameters": { + "instance": { + "description": "Name of the instance for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "port": { + "default": "1", + "description": "Specifies which COM or serial port to retrieve data from.", + "format": "int32", + "location": "query", + "maximum": "4", + "minimum": "1", + "type": "integer" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "start": { + "description": "Specifies the starting byte position of the output to return. To start with\nthe first byte of output to the specified port, omit this field or set it\nto `0`.\n\nIf the output for that byte position is available, this field matches the\n`start` parameter sent with the request. If the amount of serial console\noutput exceeds the size of the buffer (1 MB), the oldest output is\ndiscarded and is no longer available. If the requested start position\nrefers to discarded output, the start position is adjusted to the oldest\noutput still available, and the adjusted start position is returned as the\n`start` property value.\n\nYou can also provide a negative start position, which translates to the\nmost recent number of bytes written to the serial port. For example, -3 is\ninterpreted as the most recent 3 bytes written to the serial console. Note\nthat the negative start is bounded by the retained buffer size, and the\nreturned serial console output will not exceed the max buffer size.", + "format": "int64", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instances/{instance}/serialPort", + "response": { + "$ref": "SerialPortOutput" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "healthState": { - "description": "Health state of the IPv4 address of the instance.", - "type": "string", - "enumDescriptions": [ - "", - "" + "getShieldedInstanceIdentity": { + "description": "Returns the Shielded Instance Identity of an instance", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/getShieldedInstanceIdentity", + "httpMethod": "GET", + "id": "compute.instances.getShieldedInstanceIdentity", + "parameterOrder": [ + "project", + "zone", + "instance" ], - "enum": [ - "HEALTHY", - "UNHEALTHY" + "parameters": { + "instance": { + "description": "Name or id of the instance scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instances/{instance}/getShieldedInstanceIdentity", + "response": { + "$ref": "ShieldedInstanceIdentity" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "ipv6HealthState": { - "description": "Health state of the IPv6 address of the instance.", - "type": "string", - "enumDescriptions": [ - "", - "" + "insert": { + "description": "Creates an instance resource in the specified project using the data\nincluded in the request.", + "flatPath": "projects/{project}/zones/{zone}/instances", + "httpMethod": "POST", + "id": "compute.instances.insert", + "parameterOrder": [ + "project", + "zone" ], - "enum": [ - "HEALTHY", - "UNHEALTHY" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "sourceInstanceTemplate": { + "description": "Specifies instance template to create the instance.\n\nThis field is optional. It can be a full or partial URL. For example, the\nfollowing are all valid URLs to an instance template:\n \n \n - https://www.googleapis.com/compute/v1/projects/project/global/instanceTemplates/instanceTemplate\n - projects/project/global/instanceTemplates/instanceTemplate\n - global/instanceTemplates/instanceTemplate", + "location": "query", + "type": "string" + }, + "sourceMachineImage": { + "description": "Specifies the machine image to use to create the instance.\n\nThis field is optional. It can be a full or partial URL. For example, the\nfollowing are all valid URLs to a machine image:\n \n \n - https://www.googleapis.com/compute/v1/projects/project/global/global/machineImages/machineImage\n - projects/project/global/global/machineImages/machineImage\n - global/machineImages/machineImage", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instances", + "request": { + "$ref": "Instance" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "annotations": { - "description": "Metadata defined as annotations for network endpoint.", - "type": "object", - "additionalProperties": { - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "list": { + "description": "Retrieves the list of instances contained within\nthe specified zone.", + "flatPath": "projects/{project}/zones/{zone}/instances", + "httpMethod": "GET", + "id": "compute.instances.list", + "parameterOrder": [ + "project", + "zone" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`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\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" } - } - } - } - }, - "Commitment": { - "id": "Commitment", - "description": "Represents a regional resource-based commitment resource. Creating this commitment resource means that you are purchasing a resource-based committed use contract, with an explicit start and end time. You can purchase resource-based commitments for both hardware and software resources. For more information, read Resource-based 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 commitment. You must specify a name when you purchase the commitment. 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 the commitment. You can provide this property when you create the resource.", - "type": "string" - }, - "region": { - "description": "[Output Only] URL of the region where the commitment and committed resources are located.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for the resource.", - "type": "string" + }, + "path": "projects/{project}/zones/{zone}/instances", + "response": { + "$ref": "InstanceList" + }, + "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 commitment with regards to eventual expiration (each commitment has an end date defined). Status can be one of the following values: NOT_YET_ACTIVE, ACTIVE, or EXPIRED.", - "type": "string", - "enumDescriptions": [ - "", - "Deprecate CANCELED status. Will use separate status to differentiate cancel by mergeCud or manual cancellation.", - "", - "", - "" + "listReferrers": { + "description": "Retrieves a list of resources that refer to the VM instance specified in\nthe request. For example, if the VM instance is part of a managed or\nunmanaged instance group, the referrers list includes the instance group.\nFor more information, readViewing\nreferrers to VM instances.", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/referrers", + "httpMethod": "GET", + "id": "compute.instances.listReferrers", + "parameterOrder": [ + "project", + "zone", + "instance" ], - "enum": [ - "ACTIVE", - "CANCELLED", - "CREATING", - "EXPIRED", - "NOT_YET_ACTIVE" + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "instance": { + "description": "Name of the target instance scoping this request, or '-' if the\nrequest should span over all instances in the container.", + "location": "path", + "pattern": "-|[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instances/{instance}/referrers", + "response": { + "$ref": "InstanceListReferrers" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "statusMessage": { - "description": "[Output Only] An optional, human-readable explanation of the status.", - "type": "string" - }, - "plan": { - "description": "The minimum time duration that you commit to purchasing resources. The plan that you choose determines the preset term length of the commitment (which is 1 year or 3 years) and affects the discount rate that you receive for your resources. Committing to a longer time duration typically gives you a higher discount rate. The supported values for this field are TWELVE_MONTH (1 year), and THIRTY_SIX_MONTH (3 years).", - "type": "string", - "enumDescriptions": [ - "", - "", - "" + "performMaintenance": { + "description": "Perform a manual maintenance on the instance.", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/performMaintenance", + "httpMethod": "POST", + "id": "compute.instances.performMaintenance", + "parameterOrder": [ + "project", + "zone", + "instance" ], - "enum": [ - "INVALID", - "THIRTY_SIX_MONTH", - "TWELVE_MONTH" + "parameters": { + "instance": { + "description": "Name of the instance scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instances/{instance}/performMaintenance", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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" - }, - "category": { - "description": "The category of the commitment; specifies whether the commitment is for hardware or software resources. Category MACHINE specifies that you are committing to hardware machine resources such as VCPU or MEMORY, listed in resources. Category LICENSE specifies that you are committing to software licenses, listed in licenseResources. Note that if you specify MACHINE commitments, then you must also specify a type to indicate the machine series of the hardware resource that you are committing to.", - "type": "string", - "enumDescriptions": [ - "", - "", - "" + "removeResourcePolicies": { + "description": "Removes resource policies from an instance.", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/removeResourcePolicies", + "httpMethod": "POST", + "id": "compute.instances.removeResourcePolicies", + "parameterOrder": [ + "project", + "zone", + "instance" ], - "enum": [ - "CATEGORY_UNSPECIFIED", - "LICENSE", - "MACHINE" + "parameters": { + "instance": { + "description": "The instance name for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instances/{instance}/removeResourcePolicies", + "request": { + "$ref": "InstancesRemoveResourcePoliciesRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "resources": { - "description": "The list of all the hardware resources, with their types and amounts, that you want to commit to. Specify as a separate entry in the list for each individual resource type.", - "type": "array", - "items": { - "$ref": "ResourceCommitment" - } - }, - "type": { - "description": "The type of commitment; specifies the machine series for which you want to commit to purchasing resources. The choice of machine series affects the discount rate and the eligible resource types. The type must be one of the following: 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, MEMORY_OPTIMIZED_X4, STORAGE_OPTIMIZED_Z3. For example, type MEMORY_OPTIMIZED specifies a commitment that applies only to eligible resources of memory optimized M1 and M2 machine series. Type GENERAL_PURPOSE specifies a commitment that applies only to eligible resources of general purpose N1 machine series.", - "type": "string", - "enumDescriptions": [ - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "Note for internal users: When adding a new enum Type for v1, make sure to also add it in the comment for the `optional Type type` definition. This ensures that the public documentation displays the new enum Type." + "reportHostAsFaulty": { + "description": "Mark the host as faulty and try to restart the instance on a new host.", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/reportHostAsFaulty", + "httpMethod": "POST", + "id": "compute.instances.reportHostAsFaulty", + "parameterOrder": [ + "project", + "zone", + "instance" ], - "enum": [ - "ACCELERATOR_OPTIMIZED", - "ACCELERATOR_OPTIMIZED_A3", - "ACCELERATOR_OPTIMIZED_A3_MEGA", - "ACCELERATOR_OPTIMIZED_A3_ULTRA", - "ACCELERATOR_OPTIMIZED_A4", - "COMPUTE_OPTIMIZED", - "COMPUTE_OPTIMIZED_C2D", - "COMPUTE_OPTIMIZED_C3", - "COMPUTE_OPTIMIZED_C3D", - "COMPUTE_OPTIMIZED_H3", - "COMPUTE_OPTIMIZED_H4D", - "GENERAL_PURPOSE", - "GENERAL_PURPOSE_C4", - "GENERAL_PURPOSE_C4A", - "GENERAL_PURPOSE_C4D", - "GENERAL_PURPOSE_E2", - "GENERAL_PURPOSE_N2", - "GENERAL_PURPOSE_N2D", - "GENERAL_PURPOSE_N4", - "GENERAL_PURPOSE_T2D", - "GRAPHICS_OPTIMIZED", - "MEMORY_OPTIMIZED", - "MEMORY_OPTIMIZED_M3", - "MEMORY_OPTIMIZED_M4", - "MEMORY_OPTIMIZED_M4_6TB", - "MEMORY_OPTIMIZED_X4_16TB", - "MEMORY_OPTIMIZED_X4_24TB", - "MEMORY_OPTIMIZED_X4_32TB", - "STORAGE_OPTIMIZED_Z3", - "TYPE_UNSPECIFIED" + "parameters": { + "instance": { + "description": "Name of the instance scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instances/{instance}/reportHostAsFaulty", + "request": { + "$ref": "InstancesReportHostAsFaultyRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "reservations": { - "description": "The list of new reservations that you want to create and attach to this commitment. You must attach reservations to your commitment if your commitment specifies any GPUs or Local SSD disks. For more information, see Attach reservations to resource-based commitments. Specify this property only if you want to create new reservations to attach. To attach existing reservations, specify the existingReservations property instead.", - "type": "array", - "items": { - "$ref": "Reservation" - } - }, - "licenseResource": { - "description": "The license specification required as part of a license commitment.", - "$ref": "LicenseResourceCommitment" - }, - "autoRenew": { - "description": "Specifies whether to automatically renew the commitment at the end of its current term. The default value is false. If you set the field to true, each time your commitment reaches the end of its term, Compute Engine automatically renews it for another term. You can update this field anytime before the commitment expires. For example, if the commitment is set to expire at 12 AM UTC-8 on January 3, 2027, you can update this field until 11:59 PM UTC-8 on January 2, 2027.", - "type": "boolean" - }, - "mergeSourceCommitments": { - "description": "The list of source commitments that you are merging to create the new merged commitment. For more information, see Merging commitments.", - "type": "array", - "items": { - "type": "string" - } - }, - "splitSourceCommitment": { - "description": "The source commitment from which you are transferring resources to create the new split commitment. For more information, see Split commitments.", - "type": "string" - }, - "resourceStatus": { - "description": "[Output Only] Status information for Commitment resource.", - "$ref": "CommitmentResourceStatus" - }, - "existingReservations": { - "type": "array", - "items": { - "type": "string" - } - }, - "customEndTimestamp": { - "description": "[Input Only] Optional, specifies the requested commitment end time in RFC3339 text format. Use this option when the desired commitment's end date is later than the start date + term duration.", - "type": "string" - } - } - }, - "ResourceCommitment": { - "id": "ResourceCommitment", - "description": "Commitment for a particular hardware resource (a commitment is composed of one or more of these).", - "type": "object", - "properties": { - "type": { - "description": "The type of hardware resource that you want to specify. You can specify any of the following values: - VCPU - MEMORY - LOCAL_SSD - ACCELERATOR Specify as a separate entry in the list for each individual resource type.", - "type": "string", - "enumDescriptions": [ - "", - "", - "", - "", - "" + "reset": { + "description": "Performs a reset on the instance. This is a hard reset. The VM\ndoes not do a graceful shutdown. For more information, seeResetting\nan instance.", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/reset", + "httpMethod": "POST", + "id": "compute.instances.reset", + "parameterOrder": [ + "project", + "zone", + "instance" ], - "enum": [ - "ACCELERATOR", - "LOCAL_SSD", - "MEMORY", - "UNSPECIFIED", - "VCPU" - ] - }, - "amount": { - "description": "The quantity of the hardware resource that you want to commit to purchasing (in a type-dependent unit). - For vCPUs, you must specify an integer value. - For memory, you specify the amount of MB that you want. The value you specify must be a multiple of 256 MB, with up to 6.5 GB of memory per every vCPU. - For GPUs, you must specify an integer value. - For Local SSD disks, you must specify the amount in GB. The size of a single Local SSD disk is 375 GB. ", - "type": "string", - "format": "int64" - }, - "acceleratorType": { - "description": "Name of the accelerator type or GPU resource. Specify this field only when the type of hardware resource is ACCELERATOR.", - "type": "string" - } - } - }, - "LicenseResourceCommitment": { - "id": "LicenseResourceCommitment", - "description": "Commitment for a particular license resource.", - "type": "object", - "properties": { - "license": { - "description": "The applicable license URI.", - "type": "string" - }, - "amount": { - "description": "The number of licenses you plan to purchase.", - "type": "string", - "format": "int64" - }, - "coresPerLicense": { - "description": "The number of cores per license.", - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "parameters": { + "instance": { + "description": "Name of the instance scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" } - } - }, - "unreachables": { - "description": "[Output Only] Unreachable resources.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "CommitmentsScopedList": { - "id": "CommitmentsScopedList", - "type": "object", - "properties": { - "commitments": { - "description": "[Output Only] The list of commitments contained in this scope.", - "type": "array", - "items": { - "$ref": "Commitment" - } + }, + "path": "projects/{project}/zones/{zone}/instances/{instance}/reset", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "resume": { + "description": "Resumes an instance that was suspended using theinstances().suspend\nmethod.", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/resume", + "httpMethod": "POST", + "id": "compute.instances.resume", + "parameterOrder": [ + "project", + "zone", + "instance" + ], + "parameters": { + "instance": { + "description": "Name of the instance resource to resume.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "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" + }, + "path": "projects/{project}/zones/{zone}/instances/{instance}/resume", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "sendDiagnosticInterrupt": { + "description": "Sends diagnostic interrupt to the instance.", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/sendDiagnosticInterrupt", + "httpMethod": "POST", + "id": "compute.instances.sendDiagnosticInterrupt", + "parameterOrder": [ + "project", + "zone", + "instance" + ], + "parameters": { + "instance": { + "description": "Name of the instance scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "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" + }, + "path": "projects/{project}/zones/{zone}/instances/{instance}/sendDiagnosticInterrupt", + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "setDeletionProtection": { + "description": "Sets deletion protection on the instance.", + "flatPath": "projects/{project}/zones/{zone}/instances/{resource}/setDeletionProtection", + "httpMethod": "POST", + "id": "compute.instances.setDeletionProtection", + "parameterOrder": [ + "project", + "zone", + "resource" + ], + "parameters": { + "deletionProtection": { + "default": "true", + "description": "Whether the resource should be protected against deletion.", + "location": "query", + "type": "boolean" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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" - } - } - } - } - } - }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "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" + }, + "path": "projects/{project}/zones/{zone}/instances/{resource}/setDeletionProtection", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "setDiskAutoDelete": { + "description": "Sets the auto-delete flag for a disk attached to an instance.", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/setDiskAutoDelete", + "httpMethod": "POST", + "id": "compute.instances.setDiskAutoDelete", + "parameterOrder": [ + "project", + "zone", + "instance", + "autoDelete", + "deviceName" + ], + "parameters": { + "autoDelete": { + "description": "Whether to auto-delete the disk when the instance is deleted.", + "location": "query", + "required": true, + "type": "boolean" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "deviceName": { + "description": "The device name of the disk to modify. Make a get() request\non the instance to view currently attached disks and device names.", + "location": "query", + "pattern": "\\w[\\w.-]{0,254}", + "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" - } - } - } + "instance": { + "description": "The instance name for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "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" + }, + "path": "projects/{project}/zones/{zone}/instances/{instance}/setDiskAutoDelete", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "setIamPolicy": { + "description": "Sets the access control policy on the specified resource.\nReplaces any existing policy.", + "flatPath": "projects/{project}/zones/{zone}/instances/{resource}/setIamPolicy", + "httpMethod": "POST", + "id": "compute.instances.setIamPolicy", + "parameterOrder": [ + "project", + "zone", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "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. Valid values are 1440, 1460, 1500, and 8896. 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" + }, + "path": "projects/{project}/zones/{zone}/instances/{resource}/setIamPolicy", + "request": { + "$ref": "ZoneSetPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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." + "setLabels": { + "description": "Sets labels on an instance. To learn more about labels, read theLabeling\nResources documentation.", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/setLabels", + "httpMethod": "POST", + "id": "compute.instances.setLabels", + "parameterOrder": [ + "project", + "zone", + "instance" ], - "enum": [ - "OS_ACTIVE", - "OS_UNPROVISIONED" + "parameters": { + "instance": { + "description": "Name of the instance scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instances/{instance}/setLabels", + "request": { + "$ref": "InstancesSetLabelsRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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." + "setMachineResources": { + "description": "Changes the number and/or type of accelerator for a stopped instance to the\nvalues specified in the request.", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/setMachineResources", + "httpMethod": "POST", + "id": "compute.instances.setMachineResources", + "parameterOrder": [ + "project", + "zone", + "instance" ], - "enum": [ - "DEDICATED", - "PARTNER", - "PARTNER_PROVIDER" + "parameters": { + "instance": { + "description": "Name of the instance scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instances/{instance}/setMachineResources", + "request": { + "$ref": "InstancesSetMachineResourcesRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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": "Input only. 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": [ - "", - "", - "" + "setMachineType": { + "description": "Changes the machine type for a stopped instance to the machine\ntype specified in the request.", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/setMachineType", + "httpMethod": "POST", + "id": "compute.instances.setMachineType", + "parameterOrder": [ + "project", + "zone", + "instance" ], - "enum": [ - "AVAILABILITY_DOMAIN_1", - "AVAILABILITY_DOMAIN_2", - "AVAILABILITY_DOMAIN_ANY" + "parameters": { + "instance": { + "description": "Name of the instance scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instances/{instance}/setMachineType", + "request": { + "$ref": "InstancesSetMachineTypeRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "candidateSubnets": { - "description": "Input only. 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 - BPS_100G: 100 Gbit/s ", - "type": "string", - "enumDescriptions": [ - "100 Gbit/s", - "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" + "setMetadata": { + "description": "Sets metadata for the specified instance to the data included\nin the request.", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/setMetadata", + "httpMethod": "POST", + "id": "compute.instances.setMetadata", + "parameterOrder": [ + "project", + "zone", + "instance" ], - "enum": [ - "BPS_100G", - "BPS_100M", - "BPS_10G", - "BPS_1G", - "BPS_200M", - "BPS_20G", - "BPS_2G", - "BPS_300M", - "BPS_400M", - "BPS_500M", - "BPS_50G", - "BPS_50M", - "BPS_5G" + "parameters": { + "instance": { + "description": "Name of the instance scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instances/{instance}/setMetadata", + "request": { + "$ref": "Metadata" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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." + "setMinCpuPlatform": { + "description": "Changes the minimum CPU platform that this instance should use.\nThis method can only\nbe called on a stopped instance. For more information, readSpecifying a\nMinimum CPU Platform.", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/setMinCpuPlatform", + "httpMethod": "POST", + "id": "compute.instances.setMinCpuPlatform", + "parameterOrder": [ + "project", + "zone", + "instance" ], - "enum": [ - "ACTIVE", - "DEFUNCT", - "PARTNER_REQUEST_RECEIVED", - "PENDING_CUSTOMER", - "PENDING_PARTNER", - "STATE_UNSPECIFIED", - "UNPROVISIONED" + "parameters": { + "instance": { + "description": "Name of the instance scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instances/{instance}/setMinCpuPlatform", + "request": { + "$ref": "InstancesSetMinCpuPlatformRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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." + "setName": { + "description": "Sets name of an instance.", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/setName", + "httpMethod": "POST", + "id": "compute.instances.setName", + "parameterOrder": [ + "project", + "zone", + "instance" ], - "enum": [ - "IPSEC", - "NONE" + "parameters": { + "instance": { + "description": "The instance name for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instances/{instance}/setName", + "request": { + "$ref": "InstancesSetNameRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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." + "setScheduling": { + "description": "Sets an instance's scheduling options. You can only call this method on astopped instance,\nthat is, a VM instance that is in a `TERMINATED` state. SeeInstance Life\nCycle for more information on the possible instance states.\nFor more information about setting scheduling options for a VM, seeSet\nVM host maintenance policy.", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/setScheduling", + "httpMethod": "POST", + "id": "compute.instances.setScheduling", + "parameterOrder": [ + "project", + "zone", + "instance" ], - "enum": [ - "IPV4_IPV6", - "IPV4_ONLY" + "parameters": { + "instance": { + "description": "Instance name for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instances/{instance}/setScheduling", + "request": { + "$ref": "Scheduling" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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": "Input only. 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" - }, - "attachmentGroup": { - "description": "[Output Only] URL of the AttachmentGroup that includes this Attachment.", - "type": "string" - } - } - }, - "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" + "setSecurityPolicy": { + "description": "Sets the Google Cloud Armor security policy for the specified instance.\nFor more information, seeGoogle\nCloud Armor Overview", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/setSecurityPolicy", + "httpMethod": "POST", + "id": "compute.instances.setSecurityPolicy", + "parameterOrder": [ + "project", + "zone", + "instance" ], - "enum": [ - "MD5_OPTIONAL", - "MD5_REQUIRED", - "MD5_UNSUPPORTED" - ] - }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "parameters": { + "instance": { + "description": "Name of the Instance resource to which the security policy should be\nset. 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.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "Name of the zone scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "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" - } + }, + "path": "projects/{project}/zones/{zone}/instances/{instance}/setSecurityPolicy", + "request": { + "$ref": "InstancesSetSecurityPolicyRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "setServiceAccount": { + "description": "Sets the service account on the instance. For more information,\nreadChanging\nthe service account and access scopes for an instance.", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/setServiceAccount", + "httpMethod": "POST", + "id": "compute.instances.setServiceAccount", + "parameterOrder": [ + "project", + "zone", + "instance" + ], + "parameters": { + "instance": { + "description": "Name of the instance resource to start.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" } - } - } - } - }, - "InterconnectAttachmentGroupsListResponse": { - "id": "InterconnectAttachmentGroupsListResponse", - "type": "object", - "properties": { - "kind": { - "default": "compute#interconnectAttachmentGroup", - "type": "string" + }, + "path": "projects/{project}/zones/{zone}/instances/{instance}/setServiceAccount", + "request": { + "$ref": "InstancesSetServiceAccountRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of InterconnectAttachmentGroup resources.", - "type": "array", - "items": { - "$ref": "InterconnectAttachmentGroup" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the 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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "setShieldedInstanceIntegrityPolicy": { + "description": "Sets the Shielded Instance integrity policy for an instance. You can\nonly use this method on a running instance. This method\nsupports PATCH semantics and uses the JSON merge\npatch format and processing rules.", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/setShieldedInstanceIntegrityPolicy", + "httpMethod": "PATCH", + "id": "compute.instances.setShieldedInstanceIntegrityPolicy", + "parameterOrder": [ + "project", + "zone", + "instance" + ], + "parameters": { + "instance": { + "description": "Name or id of the instance scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" } - } - }, - "etag": { - "type": "string" - }, - "unreachables": { - "description": "[Output Only] Unreachable resources. end_interface: MixerListResponseWithEtagBuilder", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "InterconnectAttachmentGroup": { - "id": "InterconnectAttachmentGroup", - "description": "An interconnect attachment group resource allows customers to create, analyze, and expand highly available deployments.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of the resource. Always compute#interconnectAttachmentGroup.", - "default": "compute#interconnectAttachmentGroup", - "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])?", - "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" - }, - "etag": { - "description": "Opaque system-generated token that uniquely identifies the configuration. If provided when patching a configuration in update mode, the provided token must match the current token or the update is rejected. This provides a reliable means of doing read-modify-write (optimistic locking) as described by AIP 154.", - "type": "string" - }, - "attachments": { - "description": "Attachments in the AttachmentGroup. Keys are arbitrary user-specified strings. Users are encouraged, but not required, to use their preferred format for resource links as keys. Note that there are add-members and remove-members methods in gcloud. The size of this map is limited by an \"Attachments per group\" quota.", - "type": "object", - "additionalProperties": { - "$ref": "InterconnectAttachmentGroupAttachment" - } - }, - "interconnectGroup": { - "description": "The URL of an InterconnectGroup that groups these Attachments' Interconnects. Customers do not need to set this unless directed by Google Support.", - "type": "string" - }, - "intent": { - "$ref": "InterconnectAttachmentGroupIntent" - }, - "logicalStructure": { - "$ref": "InterconnectAttachmentGroupLogicalStructure" + }, + "path": "projects/{project}/zones/{zone}/instances/{instance}/setShieldedInstanceIntegrityPolicy", + "request": { + "$ref": "ShieldedInstanceIntegrityPolicy" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "configured": { - "$ref": "InterconnectAttachmentGroupConfigured" - } - } - }, - "InterconnectAttachmentGroupAttachment": { - "id": "InterconnectAttachmentGroupAttachment", - "description": "An Attachment in this AttachmentGroup.", - "type": "object", - "properties": { - "attachment": { - "type": "string" - } - } - }, - "InterconnectAttachmentGroupIntent": { - "id": "InterconnectAttachmentGroupIntent", - "description": "The user's intent for this AttachmentGroup. This is the only required field besides the name that must be specified on group creation.", - "type": "object", - "properties": { - "availabilitySla": { - "type": "string", - "enumDescriptions": [ - "", - "", - "", - "" + "setTags": { + "description": "Sets network tags\nfor the specified instance to the data included in the request.", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/setTags", + "httpMethod": "POST", + "id": "compute.instances.setTags", + "parameterOrder": [ + "project", + "zone", + "instance" ], - "enum": [ - "AVAILABILITY_SLA_UNSPECIFIED", - "NO_SLA", - "PRODUCTION_CRITICAL", - "PRODUCTION_NON_CRITICAL" + "parameters": { + "instance": { + "description": "Name of the instance scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instances/{instance}/setTags", + "request": { + "$ref": "Tags" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] - } - } - }, - "InterconnectAttachmentGroupLogicalStructure": { - "id": "InterconnectAttachmentGroupLogicalStructure", - "description": "[Output Only] An analysis of the logical layout of Attachments in this group. Every Attachment in the group is shown once in this structure.", - "type": "object", - "properties": { - "regions": { - "type": "array", - "items": { - "$ref": "InterconnectAttachmentGroupLogicalStructureRegion" - } - } - } - }, - "InterconnectAttachmentGroupLogicalStructureRegion": { - "id": "InterconnectAttachmentGroupLogicalStructureRegion", - "description": "[Output Only] The regions Attachments in this group are in.", - "type": "object", - "properties": { - "region": { - "description": "[Output Only] The name of a region, like \"us-central1\".", - "type": "string" - }, - "metros": { - "type": "array", - "items": { - "$ref": "InterconnectAttachmentGroupLogicalStructureRegionMetro" - } - } - } - }, - "InterconnectAttachmentGroupLogicalStructureRegionMetro": { - "id": "InterconnectAttachmentGroupLogicalStructureRegionMetro", - "description": "[Output Only] The metros of Attachments in this group in this region.", - "type": "object", - "properties": { - "metro": { - "description": "[Output Only] The name of the metro, as a three-letter lowercase string like \"iad\". This is the first component of the location of an Interconnect.", - "type": "string" - }, - "facilities": { - "type": "array", - "items": { - "$ref": "InterconnectAttachmentGroupLogicalStructureRegionMetroFacility" - } - } - } - }, - "InterconnectAttachmentGroupLogicalStructureRegionMetroFacility": { - "id": "InterconnectAttachmentGroupLogicalStructureRegionMetroFacility", - "description": "[Output Only] The facilities used for this group's Attachments' Interconnects.", - "type": "object", - "properties": { - "facility": { - "description": "[Output Only] The name of a facility, like \"iad-1234\".", - "type": "string" - }, - "zones": { - "type": "array", - "items": { - "$ref": "InterconnectAttachmentGroupLogicalStructureRegionMetroFacilityZone" - } - } - } - }, - "InterconnectAttachmentGroupLogicalStructureRegionMetroFacilityZone": { - "id": "InterconnectAttachmentGroupLogicalStructureRegionMetroFacilityZone", - "description": "[Output Only] The zones that Attachments in this group are present in, in the given facilities. This is inherited from their Interconnects.", - "type": "object", - "properties": { - "zone": { - "description": "[Output Only] The name of a zone, either \"zone1\" or \"zone2\".", - "type": "string" }, - "attachments": { - "description": "[Output Only] URLs of Attachments in the given zone, to the given region, on Interconnects in the given facility and metro. Every Attachment in the AG has such an entry.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "InterconnectAttachmentGroupConfigured": { - "id": "InterconnectAttachmentGroupConfigured", - "description": "[Output Only] The redundancy this group is configured to support. The way a user queries what SLA their Attachment gets is by looking at this field of the Attachment's AttachmentGroup.", - "type": "object", - "properties": { - "availabilitySla": { - "$ref": "InterconnectAttachmentGroupConfiguredAvailabilitySLA" - } - } - }, - "InterconnectAttachmentGroupConfiguredAvailabilitySLA": { - "id": "InterconnectAttachmentGroupConfiguredAvailabilitySLA", - "description": "[Output Only] Which SLA this group is configured to support, and why this group does or does not meet that SLA's requirements.", - "type": "object", - "properties": { - "effectiveSla": { - "type": "string", - "enumDescriptions": [ - "", - "", - "", - "" + "simulateMaintenanceEvent": { + "description": "Simulates a host maintenance event on a VM. For more information, see\nSimulate a host maintenance event.", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/simulateMaintenanceEvent", + "httpMethod": "POST", + "id": "compute.instances.simulateMaintenanceEvent", + "parameterOrder": [ + "project", + "zone", + "instance" ], - "enum": [ - "EFFECTIVE_SLA_UNSPECIFIED", - "NO_SLA", - "PRODUCTION_CRITICAL", - "PRODUCTION_NON_CRITICAL" + "parameters": { + "instance": { + "description": "Name of the instance scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "withExtendedNotifications": { + "description": "Determines whether the customers receive notifications before migration.\nOnly applicable to SF vms.", + "location": "query", + "type": "boolean" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instances/{instance}/simulateMaintenanceEvent", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "intendedSlaBlockers": { - "type": "array", - "items": { - "$ref": "InterconnectAttachmentGroupConfiguredAvailabilitySLAIntendedSlaBlockers" - } - } - } - }, - "InterconnectAttachmentGroupConfiguredAvailabilitySLAIntendedSlaBlockers": { - "id": "InterconnectAttachmentGroupConfiguredAvailabilitySLAIntendedSlaBlockers", - "description": "[Output Only] Reasons why configuration.availabilitySLA.sla differs from intent.availabilitySLA. This list is empty if and only if those are the same.", - "type": "object", - "properties": { - "blockerType": { - "type": "string", - "enumDescriptions": [ - "", - "", - "", - "", - "", - "", - "" + "start": { + "description": "Starts an instance that was stopped using theinstances().stop\nmethod. For more information, seeRestart an\ninstance.", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/start", + "httpMethod": "POST", + "id": "compute.instances.start", + "parameterOrder": [ + "project", + "zone", + "instance" ], - "enum": [ - "BLOCKER_TYPE_UNSPECIFIED", - "INCOMPATIBLE_METROS", - "INCOMPATIBLE_REGIONS", - "MISSING_GLOBAL_ROUTING", - "NO_ATTACHMENTS", - "NO_ATTACHMENTS_IN_METRO_AND_ZONE", - "OTHER" + "parameters": { + "instance": { + "description": "Name of the instance resource to start.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instances/{instance}/start", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "explanation": { - "description": "[Output Only] A human-readable explanation of this requirement and why it's not met. This is set for every type of requirement.", - "type": "string" - }, - "documentationLink": { - "description": "[Output Only] The url of Google Cloud public documentation explaining this requirement. This is set for every type of requirement.", - "type": "string" - }, - "regions": { - "description": "[Output Only] Regions used to explain this blocker in more detail. These are region names formatted like \"us-central1\". This will be set for some blockers (like INCOMPATIBLE_REGIONS) but does not apply to others.", - "type": "array", - "items": { - "type": "string" - } - }, - "metros": { - "description": "[Output Only] Metros used to explain this blocker in more detail. These are three-letter lowercase strings like \"iad\". This will be set for some blockers (like NO_ATTACHMENTS_IN_METRO_AND_ZONE) but does not apply to others.", - "type": "array", - "items": { - "type": "string" - } - }, - "zones": { - "description": "[Output Only] Zones used to explain this blocker in more detail. Format is \"zone1\" and/or \"zone2\". This will be set for some blockers (like MISSING_ZONE) but does not apply to others.", - "type": "array", - "items": { - "type": "string" - } - }, - "attachments": { - "description": "[Output Only] URLs of any particular Attachments to explain this blocker in more detail.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "InterconnectAttachmentGroupsGetOperationalStatusResponse": { - "id": "InterconnectAttachmentGroupsGetOperationalStatusResponse", - "description": "Response for the InterconnectAttachmentGroupsGetOperationalStatusResponse.", - "type": "object", - "properties": { - "result": { - "$ref": "InterconnectAttachmentGroupsOperationalStatus" - }, - "etag": { - "type": "string" - } - } - }, - "InterconnectAttachmentGroupsOperationalStatus": { - "id": "InterconnectAttachmentGroupsOperationalStatus", - "type": "object", - "properties": { - "groupStatus": { - "description": "Summarizes the status of the group.", - "type": "string", - "enumDescriptions": [ - "", - "", - "", - "" + "startWithEncryptionKey": { + "description": "Starts an instance that was stopped using theinstances().stop\nmethod. For more information, seeRestart an\ninstance.", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/startWithEncryptionKey", + "httpMethod": "POST", + "id": "compute.instances.startWithEncryptionKey", + "parameterOrder": [ + "project", + "zone", + "instance" ], - "enum": [ - "DEGRADED", - "FULLY_DOWN", - "FULLY_UP", - "UNSPECIFIED" + "parameters": { + "instance": { + "description": "Name of the instance resource to start.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instances/{instance}/startWithEncryptionKey", + "request": { + "$ref": "InstancesStartWithEncryptionKeyRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "attachmentStatuses": { - "type": "array", - "items": { - "$ref": "InterconnectAttachmentGroupsOperationalStatusAttachmentStatus" - } - }, - "intent": { - "$ref": "InterconnectAttachmentGroupIntent" - }, - "configured": { - "$ref": "InterconnectAttachmentGroupConfigured" - }, - "operational": { - "description": "The operational state of the group, including only active Attachments.", - "$ref": "InterconnectAttachmentGroupConfigured" - } - } - }, - "InterconnectAttachmentGroupsOperationalStatusAttachmentStatus": { - "id": "InterconnectAttachmentGroupsOperationalStatusAttachmentStatus", - "description": "The status of one Attachment in the group. List order is arbitrary.", - "type": "object", - "properties": { - "attachment": { - "description": "The URL of the Attachment being described.", - "type": "string" - }, - "isActive": { - "description": "Whether this Attachment is participating in the redundant configuration. This will be ACTIVE if and only if the status below is CONNECTION_UP. Any INACTIVE Attachments are excluded from the analysis that generates operational.availabilitySLA.", - "type": "string", - "enumDescriptions": [ - "", - "", - "" + "stop": { + "description": "Stops a running instance, shutting it down cleanly, and allows\nyou to restart the instance at a later time. Stopped instances do not incur\nVM usage charges while they are stopped. However, resources that the VM is\nusing, such as persistent disks and static IP addresses, will continue to\nbe charged until they are deleted. For more information, seeStopping\nan instance.", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/stop", + "httpMethod": "POST", + "id": "compute.instances.stop", + "parameterOrder": [ + "project", + "zone", + "instance" ], - "enum": [ - "ACTIVE", - "INACTIVE", - "UNSPECIFIED" + "parameters": { + "discardLocalSsd": { + "description": "This property is required if the instance has any attached Local SSD disks.\nIf false, Local SSD data will be preserved when the instance is suspended.\nIf 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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "noGracefulShutdown": { + "description": "If set to true, Graceful Shutdown is skipped.", + "location": "query", + "type": "boolean" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instances/{instance}/stop", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "adminEnabled": { - "description": "Whether this Attachment is enabled. This becomes false when the customer drains their Attachment.", - "type": "boolean" - }, - "status": { - "description": "Whether this Attachment is active, and if so, whether BGP is up. This is based on the statuses available in the Pantheon UI here: http://google3/java/com/google/cloud/boq/clientapi/gce/hybrid/api/interconnect_models.proto", - "type": "string", - "enumDescriptions": [ - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "" + "suspend": { + "description": "This method suspends a running instance, saving its state to persistent\nstorage, and allows you to resume the instance at a later time. Suspended\ninstances have no compute costs (cores or RAM), and incur only storage\ncharges for the saved VM memory and localSSD data. Any charged resources\nthe virtual machine was using, such as persistent disks and static IP\naddresses, will continue to be charged while the instance is suspended.\nFor more information, see\nSuspending and resuming an instance.", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/suspend", + "httpMethod": "POST", + "id": "compute.instances.suspend", + "parameterOrder": [ + "project", + "zone", + "instance" ], - "enum": [ - "ATTACHMENT_STATUS_UNKNOWN", - "CONNECTION_DISABLED", - "CONNECTION_DOWN", - "CONNECTION_UP", - "DEFUNCT", - "IPSEC_CONFIGURATION_NEEDED_STATUS", - "IPSEC_READY_TO_RESUME_FLOW_STATUS", - "IPV4_DOWN_IPV6_UP", - "IPV4_UP_IPV6_DOWN", - "PARTNER_REQUEST_RECEIVED", - "PENDING_CUSTOMER", - "PENDING_PARTNER", - "PROVISIONED", - "ROUTER_CONFIGURATION_BROKEN", - "UNPROVISIONED" + "parameters": { + "discardLocalSsd": { + "description": "This property is required if the instance has any attached Local SSD disks.\nIf false, Local SSD data will be preserved when the instance is suspended.\nIf 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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instances/{instance}/suspend", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] - } - } - }, - "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" - ] + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource.", + "flatPath": "projects/{project}/zones/{zone}/instances/{resource}/testIamPermissions", + "httpMethod": "POST", + "id": "compute.instances.testIamPermissions", + "parameterOrder": [ + "project", + "zone", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } }, - "type": "string" - }, - "location": { - "description": "URL of the InterconnectLocation object that represents where this connection is to be provisioned.", - "type": "string" + "path": "projects/{project}/zones/{zone}/instances/{resource}/testIamPermissions", + "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" + ] }, - "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. - LINK_TYPE_ETHERNET_400G_LR4: A 400G Ethernet with LR4 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];", - "400G Ethernet, LR4 Optics." + "update": { + "description": "Updates an instance only if the necessary resources are available. This\nmethod can update only a specific set of instance properties. See\nUpdating a running instance for a list of updatable instance\nproperties.", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}", + "httpMethod": "PUT", + "id": "compute.instances.update", + "parameterOrder": [ + "project", + "zone", + "instance" ], - "enum": [ - "LINK_TYPE_ETHERNET_100G_LR", - "LINK_TYPE_ETHERNET_10G_LR", - "LINK_TYPE_ETHERNET_400G_LR4" + "parameters": { + "discardLocalSsd": { + "description": "Whether to discard local SSDs from the instance during restart\ndefault value is false.", + "location": "query", + "type": "boolean" + }, + "instance": { + "description": "Name of the instance resource to update.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "minimalAction": { + "description": "Specifies the action to take when updating an instance even if the\nupdated properties do not require it. If not specified, then\nCompute Engine acts based on the minimum action that the updated\nproperties require.", + "enum": [ + "INVALID", + "NO_EFFECT", + "REFRESH", + "RESTART" + ], + "enumDescriptions": [ + "", + "No changes can be made to the instance.", + "The instance will not restart.", + "The instance will restart, potentially on a different host." + ], + "location": "query", + "type": "string" + }, + "mostDisruptiveAllowedAction": { + "description": "Specifies the most disruptive action that can be taken on the instance\nas part of the update. Compute Engine returns an error if the\ninstance properties require a more disruptive action as part of the\ninstance update. Valid options from lowest to highest are\nNO_EFFECT, REFRESH, and RESTART.", + "enum": [ + "INVALID", + "NO_EFFECT", + "REFRESH", + "RESTART" + ], + "enumDescriptions": [ + "", + "No changes can be made to the instance.", + "The instance will not restart.", + "The instance will restart, potentially on a different host." + ], + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instances/{instance}", + "request": { + "$ref": "Instance" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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." + "updateAccessConfig": { + "description": "Updates the specified access config from an instance's network interface\nwith the data included in the request. This method supportsPATCH\nsemantics and uses theJSON merge\npatch format and processing rules.", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/updateAccessConfig", + "httpMethod": "POST", + "id": "compute.instances.updateAccessConfig", + "parameterOrder": [ + "project", + "zone", + "instance", + "networkInterface" ], - "enum": [ - "DEDICATED", - "IT_PRIVATE", - "PARTNER" + "parameters": { + "instance": { + "description": "The instance name for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "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.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instances/{instance}/updateAccessConfig", + "request": { + "$ref": "AccessConfig" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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." + "updateDisplayDevice": { + "description": "Updates the Display config for a VM instance. You can\nonly use this method on a stopped VM instance. This method supportsPATCH\nsemantics and uses theJSON merge\npatch format and processing rules.", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/updateDisplayDevice", + "httpMethod": "PATCH", + "id": "compute.instances.updateDisplayDevice", + "parameterOrder": [ + "project", + "zone", + "instance" ], - "enum": [ - "OS_ACTIVE", - "OS_UNPROVISIONED" + "parameters": { + "instance": { + "description": "Name of the instance scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instances/{instance}/updateDisplayDevice", + "request": { + "$ref": "DisplayDevice" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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." + "updateNetworkInterface": { + "description": "Updates an instance's network interface. This method can only update an\ninterface's alias IP range and attached network. See Modifying\nalias IP ranges for an existing instance for instructions on\nchanging alias IP ranges. See Migrating\na VM between networks for instructions on migrating an interface.\nThis method follows PATCH semantics.", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/updateNetworkInterface", + "httpMethod": "PATCH", + "id": "compute.instances.updateNetworkInterface", + "parameterOrder": [ + "project", + "zone", + "instance", + "networkInterface" ], - "enum": [ - "ACTIVE", - "UNPROVISIONED" + "parameters": { + "instance": { + "description": "The instance name for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "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.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instances/{instance}/updateNetworkInterface", + "request": { + "$ref": "NetworkInterface" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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" - ] - } - }, - "interconnectGroups": { - "description": "[Output Only] URLs of InterconnectGroups that include this Interconnect. Order is arbitrary and items are unique.", - "type": "array", - "items": { - "type": "string" - } + "updateShieldedInstanceConfig": { + "description": "Updates the Shielded Instance config for an instance. You can\nonly use this method on a stopped instance. This method supportsPATCH\nsemantics and uses theJSON merge\npatch format and processing rules.", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/updateShieldedInstanceConfig", + "httpMethod": "PATCH", + "id": "compute.instances.updateShieldedInstanceConfig", + "parameterOrder": [ + "project", + "zone", + "instance" + ], + "parameters": { + "instance": { + "description": "Name or id of the instance scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instances/{instance}/updateShieldedInstanceConfig", + "request": { + "$ref": "ShieldedInstanceConfig" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] } } }, - "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." + "instantSnapshotGroups": { + "methods": { + "delete": { + "description": "deletes a Zonal InstantSnapshotGroup resource", + "flatPath": "projects/{project}/zones/{zone}/instantSnapshotGroups/{instantSnapshotGroup}", + "httpMethod": "DELETE", + "id": "compute.instantSnapshotGroups.delete", + "parameterOrder": [ + "project", + "zone", + "instantSnapshotGroup" ], - "enum": [ - "GOOGLE", - "NSRC_GOOGLE" + "parameters": { + "instantSnapshotGroup": { + "description": "Name of the InstantSnapshot resource to delete.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instantSnapshotGroups/{instantSnapshotGroup}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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." + "get": { + "description": "returns the specified InstantSnapshotGroup resource in the specified zone.", + "flatPath": "projects/{project}/zones/{zone}/instantSnapshotGroups/{instantSnapshotGroup}", + "httpMethod": "GET", + "id": "compute.instantSnapshotGroups.get", + "parameterOrder": [ + "project", + "zone", + "instantSnapshotGroup" ], - "enum": [ - "ACTIVE", - "CANCELLED", - "COMPLETED", - "NS_ACTIVE", - "NS_CANCELED" + "parameters": { + "instantSnapshotGroup": { + "description": "Name of the InstantSnapshotGroup resource to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instantSnapshotGroups/{instantSnapshotGroup}", + "response": { + "$ref": "InstantSnapshotGroup" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "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." + "getIamPolicy": { + "description": "Gets the access control policy for a resource. May be empty if no such\npolicy or resource exists.", + "flatPath": "projects/{project}/zones/{zone}/instantSnapshotGroups/{resource}/getIamPolicy", + "httpMethod": "GET", + "id": "compute.instantSnapshotGroups.getIamPolicy", + "parameterOrder": [ + "project", + "zone", + "resource" ], - "enum": [ - "IT_OUTAGE", - "IT_PARTIAL_OUTAGE", - "OUTAGE", - "PARTIAL_OUTAGE" + "parameters": { + "optionsRequestedPolicyVersion": { + "description": "Requested IAM Policy version.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instantSnapshotGroups/{resource}/getIamPolicy", + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "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" + "insert": { + "description": "inserts a Zonal InstantSnapshotGroup resource", + "flatPath": "projects/{project}/zones/{zone}/instantSnapshotGroups", + "httpMethod": "POST", + "id": "compute.instantSnapshotGroups.insert", + "parameterOrder": [ + "project", + "zone" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "sourceConsistencyGroup": { + "description": "begin_interface: MixerMutationRequestBuilder", + "location": "query", + "type": "string" + }, + "zone": { + "description": "Name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instantSnapshotGroups", + "request": { + "$ref": "InstantSnapshotGroup" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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" - } + "list": { + "description": "retrieves the list of InstantSnapshotGroup resources contained within\nthe specified zone.", + "flatPath": "projects/{project}/zones/{zone}/instantSnapshotGroups", + "httpMethod": "GET", + "id": "compute.instantSnapshotGroups.list", + "parameterOrder": [ + "project", + "zone" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instantSnapshotGroups", + "response": { + "$ref": "ListInstantSnapshotGroups" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "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" + "setIamPolicy": { + "description": "Sets the access control policy on the specified resource.\nReplaces any existing policy.", + "flatPath": "projects/{project}/zones/{zone}/instantSnapshotGroups/{resource}/setIamPolicy", + "httpMethod": "POST", + "id": "compute.instantSnapshotGroups.setIamPolicy", + "parameterOrder": [ + "project", + "zone", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instantSnapshotGroups/{resource}/setIamPolicy", + "request": { + "$ref": "ZoneSetPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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": { + "description": "Returns permissions that a caller has on the specified resource.", + "flatPath": "projects/{project}/zones/{zone}/instantSnapshotGroups/{resource}/testIamPermissions", + "httpMethod": "POST", + "id": "compute.instantSnapshotGroups.testIamPermissions", + "parameterOrder": [ + "project", + "zone", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instantSnapshotGroups/{resource}/testIamPermissions", + "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" + ] } } }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "instantSnapshots": { + "methods": { + "aggregatedList": { + "description": "Retrieves an aggregated list of instantSnapshots.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", + "flatPath": "projects/{project}/aggregated/instantSnapshots", + "httpMethod": "GET", + "id": "compute.instantSnapshots.aggregatedList", + "parameterOrder": [ + "project" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "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,\nglobal) should be included in the response. For new resource types added\nafter this field, the flag has no effect as new resource types will always\ninclude every visible scope for each scope type in response. For resource\ntypes which predate this field, if this flag is omitted or false, only\nscopes of the scope types where the resource type is expected to be found\nwill be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`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\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which\naggregated list request is invoked for subnetworks list-usable api.", + "format": "int64", + "location": "query", + "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" - } + }, + "path": "projects/{project}/aggregated/instantSnapshots", + "response": { + "$ref": "InstantSnapshotAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "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." + "delete": { + "description": "Deletes the specified InstantSnapshot resource. Keep in mind that deleting\na single instantSnapshot might not necessarily delete all the data on that\ninstantSnapshot. If any data on the instantSnapshot that is marked for\ndeletion is needed for subsequent instantSnapshots, the data will be moved\nto the next corresponding instantSnapshot.\n\nFor more information, seeDeleting\ninstantSnapshots.", + "flatPath": "projects/{project}/zones/{zone}/instantSnapshots/{instantSnapshot}", + "httpMethod": "DELETE", + "id": "compute.instantSnapshots.delete", + "parameterOrder": [ + "project", + "zone", + "instantSnapshot" ], - "enum": [ - "BUNDLE_OPERATIONAL_STATUS_DOWN", - "BUNDLE_OPERATIONAL_STATUS_UP" + "parameters": { + "instantSnapshot": { + "description": "Name of the InstantSnapshot resource to delete.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instantSnapshots/{instantSnapshot}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "bundleAggregationType": { - "description": "The aggregation type of the bundle interface.", - "type": "string", - "enumDescriptions": [ - "LACP is enabled.", - "LACP is disabled." + "get": { + "description": "Returns the specified InstantSnapshot resource in the specified zone.", + "flatPath": "projects/{project}/zones/{zone}/instantSnapshots/{instantSnapshot}", + "httpMethod": "GET", + "id": "compute.instantSnapshots.get", + "parameterOrder": [ + "project", + "zone", + "instantSnapshot" ], - "enum": [ - "BUNDLE_AGGREGATION_TYPE_LACP", - "BUNDLE_AGGREGATION_TYPE_STATIC" + "parameters": { + "instantSnapshot": { + "description": "Name of the InstantSnapshot resource to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instantSnapshots/{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" ] - } - } - }, - "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." + "getIamPolicy": { + "description": "Gets the access control policy for a resource. May be empty if no such\npolicy or resource exists.", + "flatPath": "projects/{project}/zones/{zone}/instantSnapshots/{resource}/getIamPolicy", + "httpMethod": "GET", + "id": "compute.instantSnapshots.getIamPolicy", + "parameterOrder": [ + "project", + "zone", + "resource" ], - "enum": [ - "LINK_OPERATIONAL_STATUS_DOWN", - "LINK_OPERATIONAL_STATUS_UP" + "parameters": { + "optionsRequestedPolicyVersion": { + "description": "Requested IAM Policy version.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instantSnapshots/{resource}/getIamPolicy", + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "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." + "insert": { + "description": "Creates an instant snapshot in the specified zone.", + "flatPath": "projects/{project}/zones/{zone}/instantSnapshots", + "httpMethod": "POST", + "id": "compute.instantSnapshots.insert", + "parameterOrder": [ + "project", + "zone" ], - "enum": [ - "HIGH_ALARM", - "HIGH_WARNING", - "LOW_ALARM", - "LOW_WARNING", - "OK" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "Name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instantSnapshots", + "request": { + "$ref": "InstantSnapshot" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] - } - } - }, - "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." + }, + "list": { + "description": "Retrieves the list of InstantSnapshot resources contained within\nthe specified zone.", + "flatPath": "projects/{project}/zones/{zone}/instantSnapshots", + "httpMethod": "GET", + "id": "compute.instantSnapshots.list", + "parameterOrder": [ + "project", + "zone" ], - "enum": [ - "ACTIVE", - "DETACHED" + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instantSnapshots", + "response": { + "$ref": "InstantSnapshotList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "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" - } - } - }, - "InterconnectGroupsListResponse": { - "id": "InterconnectGroupsListResponse", - "type": "object", - "properties": { - "kind": { - "default": "compute#InterconnectGroup", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of InterconnectGroup resources.", - "type": "array", - "items": { - "$ref": "InterconnectGroup" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the 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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "setIamPolicy": { + "description": "Sets the access control policy on the specified resource.\nReplaces any existing policy.", + "flatPath": "projects/{project}/zones/{zone}/instantSnapshots/{resource}/setIamPolicy", + "httpMethod": "POST", + "id": "compute.instantSnapshots.setIamPolicy", + "parameterOrder": [ + "project", + "zone", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" } - } - }, - "etag": { - "type": "string" - }, - "unreachables": { - "description": "[Output Only] Unreachable resources. end_interface: MixerListResponseWithEtagBuilder", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "InterconnectGroup": { - "id": "InterconnectGroup", - "description": "An interconnect group resource allows customers to create, analyze, and expand their redundant connections.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of the resource. Always compute#InterconnectGroup", - "default": "compute#InterconnectGroup", - "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.interconnectGroups.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" - }, - "etag": { - "description": "Opaque system-generated token that uniquely identifies the configuration. If provided when patching a configuration in update mode, the provided token must match the current token or the update is rejected. This provides a reliable means of doing read-modify-write (optimistic locking) as described by API 154.", - "type": "string" - }, - "interconnects": { - "description": "Interconnects in the InterconnectGroup. Keys are arbitrary user-specified strings. Users are encouraged, but not required, to use their preferred format for resource links as keys. Note that there are add-members and remove-members methods in gcloud. The size of this map is limited by an \"Interconnects per group\" quota.", - "type": "object", - "additionalProperties": { - "$ref": "InterconnectGroupInterconnect" - } - }, - "intent": { - "$ref": "InterconnectGroupIntent" - }, - "physicalStructure": { - "$ref": "InterconnectGroupPhysicalStructure" + "path": "projects/{project}/zones/{zone}/instantSnapshots/{resource}/setIamPolicy", + "request": { + "$ref": "ZoneSetPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "configured": { - "$ref": "InterconnectGroupConfigured" - } - } - }, - "InterconnectGroupInterconnect": { - "id": "InterconnectGroupInterconnect", - "description": "An Interconnect in this InterconnectGroup.", - "type": "object", - "properties": { - "interconnect": { - "description": "The URL of an Interconnect in this group. All Interconnects in the group are unique.", - "type": "string" - } - } - }, - "InterconnectGroupIntent": { - "id": "InterconnectGroupIntent", - "description": "The user's intent for this group. This is the only required field besides the name that must be specified on group creation.", - "type": "object", - "properties": { - "topologyCapability": { - "type": "string", - "enumDescriptions": [ - "", - "", - "", - "" + "setLabels": { + "description": "Sets the labels on a instantSnapshot in the given zone. To learn more about\nlabels, read the Labeling\nResources documentation.", + "flatPath": "projects/{project}/zones/{zone}/instantSnapshots/{resource}/setLabels", + "httpMethod": "POST", + "id": "compute.instantSnapshots.setLabels", + "parameterOrder": [ + "project", + "zone", + "resource" ], - "enum": [ - "NO_SLA", - "PRODUCTION_CRITICAL", - "PRODUCTION_NON_CRITICAL", - "UNSPECIFIED" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instantSnapshots/{resource}/setLabels", + "request": { + "$ref": "ZoneSetLabelsRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] - } - } - }, - "InterconnectGroupPhysicalStructure": { - "id": "InterconnectGroupPhysicalStructure", - "description": "[Output Only] An analysis of the physical layout of Interconnects in this group. Every Interconnect in the group is shown once in this structure.", - "type": "object", - "properties": { - "metros": { - "type": "array", - "items": { - "$ref": "InterconnectGroupPhysicalStructureMetros" - } - } - } - }, - "InterconnectGroupPhysicalStructureMetros": { - "id": "InterconnectGroupPhysicalStructureMetros", - "description": "[Output Only] The metros Interconnects in this group are in.", - "type": "object", - "properties": { - "metro": { - "description": "[Output Only] The name of the metro, as a three-letter lowercase string like \"iad\". This is the first component of the location of Interconnects underneath this.", - "type": "string" - }, - "facilities": { - "type": "array", - "items": { - "$ref": "InterconnectGroupPhysicalStructureMetrosFacilities" - } - } - } - }, - "InterconnectGroupPhysicalStructureMetrosFacilities": { - "id": "InterconnectGroupPhysicalStructureMetrosFacilities", - "description": "[Output Only] The facilities Interconnects in this metro are present in.", - "type": "object", - "properties": { - "facility": { - "description": "[Output Only] The ID of this facility, as a numeric string like \"5467\". This is the third component of the location of Interconnects in this facility.", - "type": "string" }, - "zones": { - "type": "array", - "items": { - "$ref": "InterconnectGroupPhysicalStructureMetrosFacilitiesZones" - } - } - } - }, - "InterconnectGroupPhysicalStructureMetrosFacilitiesZones": { - "id": "InterconnectGroupPhysicalStructureMetrosFacilitiesZones", - "description": "[Output Only] The zones that Interconnects in this facility are present in.", - "type": "object", - "properties": { - "zone": { - "description": "[Output Only] The name of the zone, either \"zone1\" or \"zone2\". This is the second component of the location of Interconnects in this facility.", - "type": "string" - }, - "interconnects": { - "description": "[Output Only] URLs of Interconnects in this redundancy group in the given metro, facility, and zone.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "InterconnectGroupConfigured": { - "id": "InterconnectGroupConfigured", - "description": "[Output Only] The status of the group as configured. This has the same structure as the operational field reported by the OperationalStatus method, but does not take into account the operational status of each resource.", - "type": "object", - "properties": { - "topologyCapability": { - "$ref": "InterconnectGroupConfiguredTopologyCapability" - } - } - }, - "InterconnectGroupConfiguredTopologyCapability": { - "id": "InterconnectGroupConfiguredTopologyCapability", - "description": "[Output Only] How reliable this topology is configured to be, and why this group does or does not meet the requirements for the intended capability.", - "type": "object", - "properties": { - "supportedSla": { - "type": "string", - "enumDescriptions": [ - "", - "", - "", - "" + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource.", + "flatPath": "projects/{project}/zones/{zone}/instantSnapshots/{resource}/testIamPermissions", + "httpMethod": "POST", + "id": "compute.instantSnapshots.testIamPermissions", + "parameterOrder": [ + "project", + "zone", + "resource" ], - "enum": [ - "NO_SLA", - "PRODUCTION_CRITICAL", - "PRODUCTION_NON_CRITICAL", - "UNSPECIFIED" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instantSnapshots/{resource}/testIamPermissions", + "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" ] - }, - "intendedCapabilityBlockers": { - "type": "array", - "items": { - "$ref": "InterconnectGroupConfiguredTopologyCapabilityIntendedCapabilityBlockers" - } } } }, - "InterconnectGroupConfiguredTopologyCapabilityIntendedCapabilityBlockers": { - "id": "InterconnectGroupConfiguredTopologyCapabilityIntendedCapabilityBlockers", - "description": "[Output Only] Reasons why configuration.topologyCapability.sla differs from intent.topologyCapability. This list is empty if and only if those are the same.", - "type": "object", - "properties": { - "blockerType": { - "type": "string", - "enumDescriptions": [ - "", - "", - "", - "", - "", - "" + "interconnectAttachmentGroups": { + "methods": { + "delete": { + "description": "Deletes the specified InterconnectAttachmentGroup in the given scope", + "flatPath": "projects/{project}/global/interconnectAttachmentGroups/{interconnectAttachmentGroup}", + "httpMethod": "DELETE", + "id": "compute.interconnectAttachmentGroups.delete", + "parameterOrder": [ + "project", + "interconnectAttachmentGroup" ], - "enum": [ - "INCOMPATIBLE_METROS", - "NOT_AVAILABLE", - "NO_INTERCONNECTS", - "NO_INTERCONNECTS_IN_METRO_AND_ZONE", - "OTHER", - "UNSPECIFIED" + "parameters": { + "interconnectAttachmentGroup": { + "description": "Name of the InterconnectAttachmentGroup resource to delete.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).\nend_interface: MixerMutationRequestBuilder", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/interconnectAttachmentGroups/{interconnectAttachmentGroup}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "explanation": { - "description": "[Output Only] A human-readable explanation of this requirement and why it's not met. This is set for every type of requirement.", - "type": "string" - }, - "documentationLink": { - "description": "[Output Only] The url of Google Cloud public documentation explaining this requirement. This is set for every type of requirement.", - "type": "string" - }, - "metros": { - "description": "[Output Only] Metros used to explain this blocker in more detail. These are three-letter lowercase strings like \"iad\". A blocker like INCOMPATIBLE_METROS will specify the problematic metros in this field.", - "type": "array", - "items": { - "type": "string" - } - }, - "facilities": { - "description": "[Output Only] Facilities used to explain this blocker in more detail. Like physicalStructure.metros.facilities.facility, this is a numeric string like \"5467\".", - "type": "array", - "items": { - "type": "string" - } - }, - "zones": { - "description": "[Output Only] Zones used to explain this blocker in more detail. Zone names are \"zone1\" and/or \"zone2\".", - "type": "array", - "items": { - "type": "string" - } - }, - "interconnects": { - "description": "[Output Only] Interconnects used to explain this blocker in more detail.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "InterconnectGroupsGetOperationalStatusResponse": { - "id": "InterconnectGroupsGetOperationalStatusResponse", - "description": "Response for the InterconnectGroupsGetOperationalStatusResponse.", - "type": "object", - "properties": { - "result": { - "$ref": "InterconnectGroupsOperationalStatus" - }, - "etag": { - "type": "string" - } - } - }, - "InterconnectGroupsOperationalStatus": { - "id": "InterconnectGroupsOperationalStatus", - "description": "Request to get the status of the interconnect group with extra detail.", - "type": "object", - "properties": { - "groupStatus": { - "description": "Summarizes the status of the group.", - "type": "string", - "enumDescriptions": [ - "", - "", - "", - "" + "get": { + "description": "Returns the specified InterconnectAttachmentGroup resource in the given\nscope.", + "flatPath": "projects/{project}/global/interconnectAttachmentGroups/{interconnectAttachmentGroup}", + "httpMethod": "GET", + "id": "compute.interconnectAttachmentGroups.get", + "parameterOrder": [ + "project", + "interconnectAttachmentGroup" ], - "enum": [ - "DEGRADED", - "FULLY_DOWN", - "FULLY_UP", - "GROUPS_STATUS_UNSPECIFIED" + "parameters": { + "interconnectAttachmentGroup": { + "description": "Name of the InterconnectAttachmentGroup resource to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/interconnectAttachmentGroups/{interconnectAttachmentGroup}", + "response": { + "$ref": "InterconnectAttachmentGroup" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "interconnectStatuses": { - "type": "array", - "items": { - "$ref": "InterconnectGroupsOperationalStatusInterconnectStatus" - } - }, - "intent": { - "description": "The intent of the resource, as returned by Get.", - "$ref": "InterconnectGroupIntent" - }, - "configured": { - "description": "The configuration analysis, as returned by Get.", - "$ref": "InterconnectGroupConfigured" - }, - "operational": { - "description": "The operational state of the group, including only active Interconnects.", - "$ref": "InterconnectGroupConfigured" - } - } - }, - "InterconnectGroupsOperationalStatusInterconnectStatus": { - "id": "InterconnectGroupsOperationalStatusInterconnectStatus", - "description": "The status of one Interconnect in the group. The order is arbitrary.", - "type": "object", - "properties": { - "interconnect": { - "description": "The URL of the Interconnect being described.", - "type": "string" - }, - "isActive": { - "description": "Whether this interconnect is participating in the redundant configuration.", - "type": "string", - "enumDescriptions": [ - "", - "", - "" + "getIamPolicy": { + "description": "Gets the access control policy for a resource. May be empty if no such\npolicy or resource exists.", + "flatPath": "projects/{project}/global/interconnectAttachmentGroups/{resource}/getIamPolicy", + "httpMethod": "GET", + "id": "compute.interconnectAttachmentGroups.getIamPolicy", + "parameterOrder": [ + "project", + "resource" ], - "enum": [ - "ACTIVE", - "INACTIVE", - "IS_ACTIVE_UNSPECIFIED" + "parameters": { + "optionsRequestedPolicyVersion": { + "description": "Requested IAM Policy version.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/interconnectAttachmentGroups/{resource}/getIamPolicy", + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "adminEnabled": { - "description": "Whether the Interconnect is enabled.", - "type": "boolean" - }, - "diagnostics": { - "description": "The diagnostics of the Interconnect, as returned by the existing get-diagnostics method.", - "$ref": "InterconnectDiagnostics" - } - } - }, - "InterconnectGroupsCreateMembersRequest": { - "id": "InterconnectGroupsCreateMembersRequest", - "type": "object", - "properties": { - "request": { - "$ref": "InterconnectGroupsCreateMembers" - } - } - }, - "InterconnectGroupsCreateMembers": { - "id": "InterconnectGroupsCreateMembers", - "type": "object", - "properties": { - "intentMismatchBehavior": { - "description": "How to behave when configured.topologyCapability.supportedSLA would not equal intent.topologyCapability after this call.", - "type": "string", - "enumDescriptions": [ - "", - "", - "" + "getOperationalStatus": { + "description": "Returns the InterconnectAttachmentStatuses for the specified\nInterconnectAttachmentGroup resource.", + "flatPath": "projects/{project}/global/interconnectAttachmentGroups/{interconnectAttachmentGroup}/getOperationalStatus", + "httpMethod": "GET", + "id": "compute.interconnectAttachmentGroups.getOperationalStatus", + "parameterOrder": [ + "project", + "interconnectAttachmentGroup" ], - "enum": [ - "CREATE", - "REJECT", - "UNSPECIFIED" + "parameters": { + "interconnectAttachmentGroup": { + "description": "Name of the interconnectAttachmentGroup resource to query.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/interconnectAttachmentGroups/{interconnectAttachmentGroup}/getOperationalStatus", + "response": { + "$ref": "InterconnectAttachmentGroupsGetOperationalStatusResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "templateInterconnect": { - "description": "Parameters for the Interconnects to create.", - "$ref": "InterconnectGroupsCreateMembersInterconnectInput" - }, - "interconnects": { - "type": "array", - "items": { - "$ref": "InterconnectGroupsCreateMembersInterconnectInput" - } - } - } - }, - "InterconnectGroupsCreateMembersInterconnectInput": { - "id": "InterconnectGroupsCreateMembersInterconnectInput", - "description": "LINT.IfChange", - "type": "object", - "properties": { - "facility": { - "description": "A zone-free location to use for all Interconnects created in this call, like \"iad-1234\".", - "type": "string" - }, - "description": { - "description": "An optional description of this resource. Provide this property when you create the resource.", - "type": "string" - }, - "name": { - "description": "Name of the Interconnects to be created. This must be specified on the template and/or on each individual interconnect. The name, if not empty, must be 1-63 characters long, and comply with RFC1035. Specifically, any nonempty 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" - }, - "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. - LINK_TYPE_ETHERNET_400G_LR4: A 400G Ethernet with LR4 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];", - "400G Ethernet, LR4 Optics." + "insert": { + "description": "Creates a InterconnectAttachmentGroup in the specified project in the given\nscope using the parameters that are included in the request.", + "flatPath": "projects/{project}/global/interconnectAttachmentGroups", + "httpMethod": "POST", + "id": "compute.interconnectAttachmentGroups.insert", + "parameterOrder": [ + "project" ], - "enum": [ - "LINK_TYPE_ETHERNET_100G_LR", - "LINK_TYPE_ETHERNET_10G_LR", - "LINK_TYPE_ETHERNET_400G_LR4" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).\nend_interface: MixerMutationRequestBuilder", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/interconnectAttachmentGroups", + "request": { + "$ref": "InterconnectAttachmentGroup" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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." + "list": { + "description": "Lists the InterconnectAttachmentGroups for a project in the given scope.", + "flatPath": "projects/{project}/global/interconnectAttachmentGroups", + "httpMethod": "GET", + "id": "compute.interconnectAttachmentGroups.list", + "parameterOrder": [ + "project" ], - "enum": [ - "DEDICATED", - "IT_PRIVATE", - "PARTNER" + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/global/interconnectAttachmentGroups", + "response": { + "$ref": "InterconnectAttachmentGroupsListResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "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" - }, - "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" - ] - } - } - } - }, - "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" - ] + "patch": { + "description": "Patches the specified InterconnectAttachmentGroup resource with the data\nincluded in the request. This method supports PATCH\nsemantics and usesJSON merge\npatch format and processing rules.", + "flatPath": "projects/{project}/global/interconnectAttachmentGroups/{interconnectAttachmentGroup}", + "httpMethod": "PATCH", + "id": "compute.interconnectAttachmentGroups.patch", + "parameterOrder": [ + "project", + "interconnectAttachmentGroup" + ], + "parameters": { + "interconnectAttachmentGroup": { + "description": "Name of the InterconnectAttachmentGroup resource to patch.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).\nend_interface: MixerMutationRequestBuilder", + "location": "query", + "type": "string" + }, + "updateMask": { + "description": "The list of fields to update.", + "format": "google-fieldmask", + "location": "query", + "type": "string" + } }, - "type": "string" + "path": "projects/{project}/global/interconnectAttachmentGroups/{interconnectAttachmentGroup}", + "request": { + "$ref": "InterconnectAttachmentGroup" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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." + "setIamPolicy": { + "description": "Sets the access control policy on the specified resource.\nReplaces any existing policy.", + "flatPath": "projects/{project}/global/interconnectAttachmentGroups/{resource}/setIamPolicy", + "httpMethod": "POST", + "id": "compute.interconnectAttachmentGroups.setIamPolicy", + "parameterOrder": [ + "project", + "resource" ], - "enum": [ - "FOUR_IPS_REDUNDANCY", - "SINGLE_IP_INTERNALLY_REDUNDANT", - "TWO_IPS_REDUNDANCY" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/interconnectAttachmentGroups/{resource}/setIamPolicy", + "request": { + "$ref": "GlobalSetPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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" + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource.", + "flatPath": "projects/{project}/global/interconnectAttachmentGroups/{resource}/testIamPermissions", + "httpMethod": "POST", + "id": "compute.interconnectAttachmentGroups.testIamPermissions", + "parameterOrder": [ + "project", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/interconnectAttachmentGroups/{resource}/testIamPermissions", + "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" + ] } } }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "interconnectAttachments": { + "methods": { + "aggregatedList": { + "description": "Retrieves an aggregated list of interconnect attachments.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", + "flatPath": "projects/{project}/aggregated/interconnectAttachments", + "httpMethod": "GET", + "id": "compute.interconnectAttachments.aggregatedList", + "parameterOrder": [ + "project" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "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,\nglobal) should be included in the response. For new resource types added\nafter this field, the flag has no effect as new resource types will always\ninclude every visible scope for each scope type in response. For resource\ntypes which predate this field, if this flag is omitted or false, only\nscopes of the scope types where the resource type is expected to be found\nwill be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`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" - } - } - } - } - } - }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "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\n`nextPageToken` returned by a previous list request to get\nthe 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.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which\naggregated list request is invoked for subnetworks list-usable api.", + "format": "int64", + "location": "query", + "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" + }, + "path": "projects/{project}/aggregated/interconnectAttachments", + "response": { + "$ref": "InterconnectAttachmentAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "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" - }, - "selfLinkWithId": { - "description": "[Output Only] Server-defined URL for this resource with the resource id.", - "type": "string" - }, - "loadBalancingScheme": { - "description": "Specifies the forwarding rule type. For more information about forwarding rules, refer to Forwarding rule concepts.", - "type": "string", - "enumDescriptions": [ - "", - "", - "", - "", - "", - "" + "delete": { + "description": "Deletes the specified interconnect attachment.", + "flatPath": "projects/{project}/regions/{region}/interconnectAttachments/{interconnectAttachment}", + "httpMethod": "DELETE", + "id": "compute.interconnectAttachments.delete", + "parameterOrder": [ + "project", + "region", + "interconnectAttachment" ], - "enum": [ - "EXTERNAL", - "EXTERNAL_MANAGED", - "INTERNAL", - "INTERNAL_MANAGED", - "INTERNAL_SELF_MANAGED", - "INVALID" + "parameters": { + "interconnectAttachment": { + "description": "Name of the interconnect attachment to delete.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/interconnectAttachments/{interconnectAttachment}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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." + "get": { + "description": "Returns the specified interconnect attachment.", + "flatPath": "projects/{project}/regions/{region}/interconnectAttachments/{interconnectAttachment}", + "httpMethod": "GET", + "id": "compute.interconnectAttachments.get", + "parameterOrder": [ + "project", + "region", + "interconnectAttachment" ], - "enum": [ - "FIXED_STANDARD", - "PREMIUM", - "STANDARD", - "STANDARD_OVERRIDES_FIXED_STANDARD" + "parameters": { + "interconnectAttachment": { + "description": "Name of the interconnect attachment to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/interconnectAttachments/{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" ] }, - "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": [ - "", - "", - "" + "insert": { + "description": "Creates an InterconnectAttachment in the specified project using the data\nincluded in the request.", + "flatPath": "projects/{project}/regions/{region}/interconnectAttachments", + "httpMethod": "POST", + "id": "compute.interconnectAttachments.insert", + "parameterOrder": [ + "project", + "region" ], - "enum": [ - "IPV4", - "IPV6", - "UNSPECIFIED_VERSION" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "validateOnly": { + "description": "If true, the request will not be committed.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/regions/{region}/interconnectAttachments", + "request": { + "$ref": "InterconnectAttachment" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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.", - "" + "list": { + "description": "Retrieves the list of interconnect attachments contained within\nthe specified region.", + "flatPath": "projects/{project}/regions/{region}/interconnectAttachments", + "httpMethod": "GET", + "id": "compute.interconnectAttachments.list", + "parameterOrder": [ + "project", + "region" ], - "enum": [ - "ACCEPTED", - "CLOSED", - "NEEDS_ATTENTION", - "PENDING", - "REJECTED", - "STATUS_UNSPECIFIED" + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/regions/{region}/interconnectAttachments", + "response": { + "$ref": "InterconnectAttachmentList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "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" - }, - "externalManagedBackendBucketMigrationState": { - "description": "Specifies the canary migration state for the backend buckets attached to this forwarding rule. Possible values are PREPARE, TEST_BY_PERCENTAGE, and TEST_ALL_TRAFFIC. To begin the migration from EXTERNAL to EXTERNAL_MANAGED, the state must be changed to PREPARE. The state must be changed to TEST_ALL_TRAFFIC before the loadBalancingScheme can be changed to EXTERNAL_MANAGED. Optionally, the TEST_BY_PERCENTAGE state can be used to migrate traffic to backend buckets attached to this forwarding rule by percentage using externalManagedBackendBucketMigrationTestingPercentage. Rolling back a migration requires the states to be set in reverse order. So changing the scheme from EXTERNAL_MANAGED to EXTERNAL requires the state to be set to TEST_ALL_TRAFFIC at the same time. Optionally, the TEST_BY_PERCENTAGE state can be used to migrate some traffic back to EXTERNAL or PREPARE can be used to migrate all traffic back to EXTERNAL.", - "type": "string", - "enumDescriptions": [ - "", - "", - "" + "patch": { + "description": "Updates the specified interconnect attachment with the data included in the\nrequest. This method supportsPATCH\nsemantics and uses theJSON merge\npatch format and processing rules.", + "flatPath": "projects/{project}/regions/{region}/interconnectAttachments/{interconnectAttachment}", + "httpMethod": "PATCH", + "id": "compute.interconnectAttachments.patch", + "parameterOrder": [ + "project", + "region", + "interconnectAttachment" ], - "enum": [ - "PREPARE", - "TEST_ALL_TRAFFIC", - "TEST_BY_PERCENTAGE" + "parameters": { + "interconnectAttachment": { + "description": "Name of the interconnect attachment to patch.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/interconnectAttachments/{interconnectAttachment}", + "request": { + "$ref": "InterconnectAttachment" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "externalManagedBackendBucketMigrationTestingPercentage": { - "description": "Determines the fraction of requests to backend buckets that should be processed by the global external Application Load Balancer. The value of this field must be in the range [0, 100]. This value can only be set if the loadBalancingScheme in the BackendService is set to EXTERNAL (when using the classic Application Load Balancer) and the migration state is TEST_BY_PERCENTAGE.", - "type": "number", - "format": "float" - } - } - }, - "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." + "setLabels": { + "description": "Sets the labels on an InterconnectAttachment. To learn more about labels,\nread the Labeling\nResources documentation.", + "flatPath": "projects/{project}/regions/{region}/interconnectAttachments/{resource}/setLabels", + "httpMethod": "POST", + "id": "compute.interconnectAttachments.setLabels", + "parameterOrder": [ + "project", + "region", + "resource" ], - "enum": [ - "MATCH_ALL", - "MATCH_ANY", - "NOT_SET" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/interconnectAttachments/{resource}/setLabels", + "request": { + "$ref": "RegionSetLabelsRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] - }, - "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" - } + "interconnectGroups": { + "methods": { + "createMembers": { + "description": "Create Interconnects with redundancy by creating them in a specified\ninterconnect group.", + "flatPath": "projects/{project}/global/interconnectGroups/{interconnectGroup}/createMembers", + "httpMethod": "POST", + "id": "compute.interconnectGroups.createMembers", + "parameterOrder": [ + "project", + "interconnectGroup" + ], + "parameters": { + "interconnectGroup": { + "description": "Name of the group resource to create members for.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/interconnectGroups/{interconnectGroup}/createMembers", + "request": { + "$ref": "InterconnectGroupsCreateMembersRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the 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": { + "description": "Deletes the specified InterconnectGroup in the given scope", + "flatPath": "projects/{project}/global/interconnectGroups/{interconnectGroup}", + "httpMethod": "DELETE", + "id": "compute.interconnectGroups.delete", + "parameterOrder": [ + "project", + "interconnectGroup" + ], + "parameters": { + "interconnectGroup": { + "description": "Name of the InterconnectGroup resource to delete.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).\nend_interface: MixerMutationRequestBuilder", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/interconnectGroups/{interconnectGroup}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "get": { + "description": "Returns the specified InterconnectGroup resource in the given scope.", + "flatPath": "projects/{project}/global/interconnectGroups/{interconnectGroup}", + "httpMethod": "GET", + "id": "compute.interconnectGroups.get", + "parameterOrder": [ + "project", + "interconnectGroup" + ], + "parameters": { + "interconnectGroup": { + "description": "Name of the InterconnectGroup resource to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/interconnectGroups/{interconnectGroup}", + "response": { + "$ref": "InterconnectGroup" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "getIamPolicy": { + "description": "Gets the access control policy for a resource. May be empty if no such\npolicy or resource exists.", + "flatPath": "projects/{project}/global/interconnectGroups/{resource}/getIamPolicy", + "httpMethod": "GET", + "id": "compute.interconnectGroups.getIamPolicy", + "parameterOrder": [ + "project", + "resource" + ], + "parameters": { + "optionsRequestedPolicyVersion": { + "description": "Requested IAM Policy version.", + "format": "int32", + "location": "query", + "type": "integer" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" } - } + }, + "path": "projects/{project}/global/interconnectGroups/{resource}/getIamPolicy", + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "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.", + "getOperationalStatus": { + "description": "Returns the interconnectStatuses for the specified\nInterconnectGroup.", + "flatPath": "projects/{project}/global/interconnectGroups/{interconnectGroup}/getOperationalStatus", + "httpMethod": "GET", + "id": "compute.interconnectGroups.getOperationalStatus", + "parameterOrder": [ + "project", + "interconnectGroup" + ], + "parameters": { + "interconnectGroup": { + "description": "Name of the interconnectGroup resource to query.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "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.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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" + }, + "path": "projects/{project}/global/interconnectGroups/{interconnectGroup}/getOperationalStatus", + "response": { + "$ref": "InterconnectGroupsGetOperationalStatusResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "insert": { + "description": "Creates a InterconnectGroup in the specified project in the given scope\nusing the parameters that are included in the request.", + "flatPath": "projects/{project}/global/interconnectGroups", + "httpMethod": "POST", + "id": "compute.interconnectGroups.insert", + "parameterOrder": [ + "project" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).\nend_interface: MixerMutationRequestBuilder", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/interconnectGroups", + "request": { + "$ref": "InterconnectGroup" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "list": { + "description": "Lists the InterconnectGroups for a project in the given scope.", + "flatPath": "projects/{project}/global/interconnectGroups", + "httpMethod": "GET", + "id": "compute.interconnectGroups.list", + "parameterOrder": [ + "project" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`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\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" } - } - } - } - }, - "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" + }, + "path": "projects/{project}/global/interconnectGroups", + "response": { + "$ref": "InterconnectGroupsListResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "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." + "patch": { + "description": "Patches the specified InterconnectGroup resource with the data included in\nthe request. This method supports PATCH\nsemantics and usesJSON merge\npatch format and processing rules.", + "flatPath": "projects/{project}/global/interconnectGroups/{interconnectGroup}", + "httpMethod": "PATCH", + "id": "compute.interconnectGroups.patch", + "parameterOrder": [ + "project", + "interconnectGroup" ], - "enum": [ - "AND", - "NO_AGGREGATION" + "parameters": { + "interconnectGroup": { + "description": "Name of the InterconnectGroup resource to patch.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).\nend_interface: MixerMutationRequestBuilder", + "location": "query", + "type": "string" + }, + "updateMask": { + "description": "The list of fields to update.", + "format": "google-fieldmask", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/interconnectGroups/{interconnectGroup}", + "request": { + "$ref": "InterconnectGroup" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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" - } + "setIamPolicy": { + "description": "Sets the access control policy on the specified resource.\nReplaces any existing policy.", + "flatPath": "projects/{project}/global/interconnectGroups/{resource}/setIamPolicy", + "httpMethod": "POST", + "id": "compute.interconnectGroups.setIamPolicy", + "parameterOrder": [ + "project", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/interconnectGroups/{resource}/setIamPolicy", + "request": { + "$ref": "GlobalSetPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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" + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource.", + "flatPath": "projects/{project}/global/interconnectGroups/{resource}/testIamPermissions", + "httpMethod": "POST", + "id": "compute.interconnectGroups.testIamPermissions", + "parameterOrder": [ + "project", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/interconnectGroups/{resource}/testIamPermissions", + "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" + ] } } }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "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.", + "interconnectLocations": { + "methods": { + "get": { + "description": "Returns the details for the specified interconnect location. Gets a list of\navailable interconnect locations by making a list() request.", + "flatPath": "projects/{project}/global/interconnectLocations/{interconnectLocation}", + "httpMethod": "GET", + "id": "compute.interconnectLocations.get", + "parameterOrder": [ + "project", + "interconnectLocation" + ], + "parameters": { + "interconnectLocation": { + "description": "Name of the interconnect location to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "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.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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" + }, + "path": "projects/{project}/global/interconnectLocations/{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" + ] }, - "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": [ - "", - "", - "", - "", - "", - "", - "" + "list": { + "description": "Retrieves the list of interconnect locations available to the specified\nproject.", + "flatPath": "projects/{project}/global/interconnectLocations", + "httpMethod": "GET", + "id": "compute.interconnectLocations.list", + "parameterOrder": [ + "project" ], - "enum": [ - "GRPC", - "HTTP", - "HTTP2", - "HTTPS", - "INVALID", - "SSL", - "TCP" + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/global/interconnectLocations", + "response": { + "$ref": "InterconnectLocationList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] - }, - "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." + "interconnectRemoteLocations": { + "methods": { + "get": { + "description": "Returns the details for the specified interconnect remote location. Gets a\nlist of available interconnect remote locations by making alist() request.", + "flatPath": "projects/{project}/global/interconnectRemoteLocations/{interconnectRemoteLocation}", + "httpMethod": "GET", + "id": "compute.interconnectRemoteLocations.get", + "parameterOrder": [ + "project", + "interconnectRemoteLocation" ], - "enum": [ - "USE_FIXED_PORT", - "USE_NAMED_PORT", - "USE_SERVING_PORT" + "parameters": { + "interconnectRemoteLocation": { + "description": "Name of the interconnect remote location to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/interconnectRemoteLocations/{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" ] }, - "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": [ - "", - "" + "list": { + "description": "Retrieves the list of interconnect remote locations available to the\nspecified project.", + "flatPath": "projects/{project}/global/interconnectRemoteLocations", + "httpMethod": "GET", + "id": "compute.interconnectRemoteLocations.list", + "parameterOrder": [ + "project" ], - "enum": [ - "NONE", - "PROXY_V1" + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/global/interconnectRemoteLocations", + "response": { + "$ref": "InterconnectRemoteLocationList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] } } }, - "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." + "interconnects": { + "methods": { + "delete": { + "description": "Deletes the specified Interconnect.", + "flatPath": "projects/{project}/global/interconnects/{interconnect}", + "httpMethod": "DELETE", + "id": "compute.interconnects.delete", + "parameterOrder": [ + "project", + "interconnect" ], - "enum": [ - "USE_FIXED_PORT", - "USE_NAMED_PORT", - "USE_SERVING_PORT" + "parameters": { + "interconnect": { + "description": "Name of the interconnect to delete.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/interconnects/{interconnect}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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": [ - "", - "" + "get": { + "description": "Returns the specified Interconnect. Get a list of available Interconnects\nby making a list() request.", + "flatPath": "projects/{project}/global/interconnects/{interconnect}", + "httpMethod": "GET", + "id": "compute.interconnects.get", + "parameterOrder": [ + "project", + "interconnect" ], - "enum": [ - "NONE", - "PROXY_V1" + "parameters": { + "interconnect": { + "description": "Name of the interconnect to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/interconnects/{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" ] - } - } - }, - "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." + "getDiagnostics": { + "description": "Returns the interconnectDiagnostics for the specified\nInterconnect.\n\nIn the event of a\nglobal outage, do not use this API to make decisions about where to\nredirect your network traffic.\n\nUnlike a VLAN attachment, which is regional, a Cloud Interconnect\nconnection is a global resource. A global outage can prevent this\nAPI from functioning properly.", + "flatPath": "projects/{project}/global/interconnects/{interconnect}/getDiagnostics", + "httpMethod": "GET", + "id": "compute.interconnects.getDiagnostics", + "parameterOrder": [ + "project", + "interconnect" ], - "enum": [ - "USE_FIXED_PORT", - "USE_NAMED_PORT", - "USE_SERVING_PORT" + "parameters": { + "interconnect": { + "description": "Name of the interconnect resource to query.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/interconnects/{interconnect}/getDiagnostics", + "response": { + "$ref": "InterconnectsGetDiagnosticsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "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": [ - "", - "" + "getMacsecConfig": { + "description": "Returns the interconnectMacsecConfig for the specified\nInterconnect.", + "flatPath": "projects/{project}/global/interconnects/{interconnect}/getMacsecConfig", + "httpMethod": "GET", + "id": "compute.interconnects.getMacsecConfig", + "parameterOrder": [ + "project", + "interconnect" ], - "enum": [ - "NONE", - "PROXY_V1" + "parameters": { + "interconnect": { + "description": "Name of the interconnect resource to query.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/interconnects/{interconnect}/getMacsecConfig", + "response": { + "$ref": "InterconnectsGetMacsecConfigResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "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." + "insert": { + "description": "Creates an Interconnect in the specified project using\nthe data included in the request.", + "flatPath": "projects/{project}/global/interconnects", + "httpMethod": "POST", + "id": "compute.interconnects.insert", + "parameterOrder": [ + "project" ], - "enum": [ - "USE_FIXED_PORT", - "USE_NAMED_PORT", - "USE_SERVING_PORT" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/interconnects", + "request": { + "$ref": "Interconnect" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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" + "list": { + "description": "Retrieves the list of Interconnects available to the specified project.", + "flatPath": "projects/{project}/global/interconnects", + "httpMethod": "GET", + "id": "compute.interconnects.list", + "parameterOrder": [ + "project" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/global/interconnects", + "response": { + "$ref": "InterconnectList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "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": [ - "", - "" + "patch": { + "description": "Updates the specified Interconnect with the data included in the request.\nThis method supportsPATCH\nsemantics and uses theJSON merge\npatch format and processing rules.", + "flatPath": "projects/{project}/global/interconnects/{interconnect}", + "httpMethod": "PATCH", + "id": "compute.interconnects.patch", + "parameterOrder": [ + "project", + "interconnect" ], - "enum": [ - "NONE", - "PROXY_V1" + "parameters": { + "interconnect": { + "description": "Name of the interconnect to update.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/interconnects/{interconnect}", + "request": { + "$ref": "Interconnect" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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" + "setLabels": { + "description": "Sets the labels on an Interconnect. To learn more about labels,\nread the Labeling\nResources documentation.", + "flatPath": "projects/{project}/global/interconnects/{resource}/setLabels", + "httpMethod": "POST", + "id": "compute.interconnects.setLabels", + "parameterOrder": [ + "project", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/interconnects/{resource}/setLabels", + "request": { + "$ref": "GlobalSetLabelsRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] } } }, - "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." + "licenseCodes": { + "methods": { + "get": { + "description": "Return a specified license code. License codes are mirrored across\nall projects that have permissions to read the License Code.\n *Caution* This resource is intended\nfor use only by third-party partners who are creatingCloud Marketplace\nimages.", + "flatPath": "projects/{project}/global/licenseCodes/{licenseCode}", + "httpMethod": "GET", + "id": "compute.licenseCodes.get", + "parameterOrder": [ + "project", + "licenseCode" ], - "enum": [ - "USE_FIXED_PORT", - "USE_NAMED_PORT", - "USE_SERVING_PORT" + "parameters": { + "licenseCode": { + "description": "Number corresponding to the License code resource to return.", + "location": "path", + "pattern": "[0-9]{0,61}?", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/licenseCodes/{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" ] }, - "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" + "getIamPolicy": { + "description": "Gets the access control policy for a resource. May be empty if no such\npolicy or resource exists.\n *Caution* This resource is intended\nfor use only by third-party partners who are creatingCloud Marketplace\nimages.", + "flatPath": "projects/{project}/global/licenseCodes/{resource}/getIamPolicy", + "httpMethod": "GET", + "id": "compute.licenseCodes.getIamPolicy", + "parameterOrder": [ + "project", + "resource" + ], + "parameters": { + "optionsRequestedPolicyVersion": { + "description": "Requested IAM Policy version.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/licenseCodes/{resource}/getIamPolicy", + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "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": [ - "", - "" + "setIamPolicy": { + "description": "Sets the access control policy on the specified resource.\nReplaces any existing policy.\n *Caution* This resource is intended\nfor use only by third-party partners who are creatingCloud Marketplace\nimages.", + "flatPath": "projects/{project}/global/licenseCodes/{resource}/setIamPolicy", + "httpMethod": "POST", + "id": "compute.licenseCodes.setIamPolicy", + "parameterOrder": [ + "project", + "resource" ], - "enum": [ - "NONE", - "PROXY_V1" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/licenseCodes/{resource}/setIamPolicy", + "request": { + "$ref": "GlobalSetPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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" + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource.\n *Caution* This resource is intended\nfor use only by third-party partners who are creatingCloud Marketplace\nimages.", + "flatPath": "projects/{project}/global/licenseCodes/{resource}/testIamPermissions", + "httpMethod": "POST", + "id": "compute.licenseCodes.testIamPermissions", + "parameterOrder": [ + "project", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/licenseCodes/{resource}/testIamPermissions", + "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" + ] } } }, - "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" + "licenses": { + "methods": { + "delete": { + "description": "Deletes the specified license.\n *Caution* This resource is intended\nfor use only by third-party partners who are creatingCloud Marketplace\nimages.", + "flatPath": "projects/{project}/global/licenses/{license}", + "httpMethod": "DELETE", + "id": "compute.licenses.delete", + "parameterOrder": [ + "project", + "license" + ], + "parameters": { + "license": { + "description": "Name of the license resource to delete.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/licenses/{license}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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." + "get": { + "description": "Returns the specified License resource.\n *Caution* This resource is intended\nfor use only by third-party partners who are creatingCloud Marketplace\nimages.", + "flatPath": "projects/{project}/global/licenses/{license}", + "httpMethod": "GET", + "id": "compute.licenses.get", + "parameterOrder": [ + "project", + "license" ], - "enum": [ - "USE_FIXED_PORT", - "USE_NAMED_PORT", - "USE_SERVING_PORT" + "parameters": { + "license": { + "description": "Name of the License resource to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/licenses/{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" ] }, - "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" + "getIamPolicy": { + "description": "Gets the access control policy for a resource. May be empty if no such\npolicy or resource exists.\n *Caution* This resource is intended\nfor use only by third-party partners who are creatingCloud Marketplace\nimages.", + "flatPath": "projects/{project}/global/licenses/{resource}/getIamPolicy", + "httpMethod": "GET", + "id": "compute.licenses.getIamPolicy", + "parameterOrder": [ + "project", + "resource" + ], + "parameters": { + "optionsRequestedPolicyVersion": { + "description": "Requested IAM Policy version.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/licenses/{resource}/getIamPolicy", + "response": { + "$ref": "Policy" + }, + "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] Unique identifier for the resource; defined by the server.", - "type": "string" + "insert": { + "description": "Create a License resource in the specified project.\n *Caution* This resource is intended\nfor use only by third-party partners who are creatingCloud Marketplace\nimages.", + "flatPath": "projects/{project}/global/licenses", + "httpMethod": "POST", + "id": "compute.licenses.insert", + "parameterOrder": [ + "project" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/licenses", + "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" + ] }, - "items": { - "description": "A list of HealthChecksScopedList resources.", - "type": "object", - "additionalProperties": { - "description": "Name of the scope containing this set of HealthChecks.", - "$ref": "HealthChecksScopedList" - } + "list": { + "description": "Retrieves the list of licenses\navailable in the specified project. This method does not\nget any licenses that belong to other projects, including licenses attached\nto publicly-available images, like Debian 9. If you want to get a list of\npublicly-available licenses, use this method to make a request to the\nrespective image project, such as debian-cloud orwindows-cloud.\n *Caution* This resource is intended\nfor use only by third-party partners who are creatingCloud Marketplace\nimages.", + "flatPath": "projects/{project}/global/licenses", + "httpMethod": "GET", + "id": "compute.licenses.list", + "parameterOrder": [ + "project" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/global/licenses", + "response": { + "$ref": "LicensesListResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the 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": { + "description": "Sets the access control policy on the specified resource.\nReplaces any existing policy.\n *Caution* This resource is intended\nfor use only by third-party partners who are creatingCloud Marketplace\nimages.", + "flatPath": "projects/{project}/global/licenses/{resource}/setIamPolicy", + "httpMethod": "POST", + "id": "compute.licenses.setIamPolicy", + "parameterOrder": [ + "project", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/licenses/{resource}/setIamPolicy", + "request": { + "$ref": "GlobalSetPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource.\n *Caution* This resource is intended\nfor use only by third-party partners who are creatingCloud Marketplace\nimages.", + "flatPath": "projects/{project}/global/licenses/{resource}/testIamPermissions", + "httpMethod": "POST", + "id": "compute.licenses.testIamPermissions", + "parameterOrder": [ + "project", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/licenses/{resource}/testIamPermissions", + "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" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "update": { + "description": "Updates a License resource in the specified project.\n *Caution* This resource is intended\nfor use only by third-party partners who are creatingCloud Marketplace\nimages.", + "flatPath": "projects/{project}/global/licenses/{license}", + "httpMethod": "PATCH", + "id": "compute.licenses.update", + "parameterOrder": [ + "project", + "license" + ], + "parameters": { + "license": { + "description": "The license name for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "updateMask": { + "description": "update_mask indicates fields to be updated as part of this request.", + "format": "google-fieldmask", + "location": "query", + "type": "string" } - } - }, - "unreachables": { - "description": "[Output Only] Unreachable resources.", - "type": "array", - "items": { - "type": "string" - } + }, + "path": "projects/{project}/global/licenses/{license}", + "request": { + "$ref": "License" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] } } }, - "HealthChecksScopedList": { - "id": "HealthChecksScopedList", - "type": "object", - "properties": { - "healthChecks": { - "description": "A list of HealthChecks contained in this scope.", - "type": "array", - "items": { - "$ref": "HealthCheck" - } - }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "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": { + "delete": { + "description": "Deletes the specified machine image. Deleting a machine image is permanent\nand cannot be undone.", + "flatPath": "projects/{project}/global/machineImages/{machineImage}", + "httpMethod": "DELETE", + "id": "compute.machineImages.delete", + "parameterOrder": [ + "project", + "machineImage" + ], + "parameters": { + "machineImage": { + "description": "The name of the machine image to delete.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "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" + }, + "path": "projects/{project}/global/machineImages/{machineImage}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "get": { + "description": "Returns the specified machine image.", + "flatPath": "projects/{project}/global/machineImages/{machineImage}", + "httpMethod": "GET", + "id": "compute.machineImages.get", + "parameterOrder": [ + "project", + "machineImage" + ], + "parameters": { + "machineImage": { + "description": "The name of the machine image.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/machineImages/{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" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "getIamPolicy": { + "description": "Gets the access control policy for a resource. May be empty if no such\npolicy or resource exists.", + "flatPath": "projects/{project}/global/machineImages/{resource}/getIamPolicy", + "httpMethod": "GET", + "id": "compute.machineImages.getIamPolicy", + "parameterOrder": [ + "project", + "resource" + ], + "parameters": { + "optionsRequestedPolicyVersion": { + "description": "Requested IAM Policy version.", + "format": "int32", + "location": "query", + "type": "integer" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "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" + }, + "path": "projects/{project}/global/machineImages/{resource}/getIamPolicy", + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "checkIntervalSec": { - "description": "How often (in seconds) to send a health check. The default value is 5 seconds.", - "type": "integer", - "format": "int32" + "insert": { + "description": "Creates a machine image in the specified project using the\ndata that is included in the request. If you are creating a new machine\nimage to update an existing instance, your new machine image should use the\nsame network or, if applicable, the same subnetwork as the original\ninstance.", + "flatPath": "projects/{project}/global/machineImages", + "httpMethod": "POST", + "id": "compute.machineImages.insert", + "parameterOrder": [ + "project" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(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" + } + }, + "path": "projects/{project}/global/machineImages", + "request": { + "$ref": "MachineImage" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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" + "list": { + "description": "Retrieves a list of machine images that are contained within\nthe specified project.", + "flatPath": "projects/{project}/global/machineImages", + "httpMethod": "GET", + "id": "compute.machineImages.list", + "parameterOrder": [ + "project" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/global/machineImages", + "response": { + "$ref": "MachineImageList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "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" + "setIamPolicy": { + "description": "Sets the access control policy on the specified resource.\nReplaces any existing policy.", + "flatPath": "projects/{project}/global/machineImages/{resource}/setIamPolicy", + "httpMethod": "POST", + "id": "compute.machineImages.setIamPolicy", + "parameterOrder": [ + "project", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/machineImages/{resource}/setIamPolicy", + "request": { + "$ref": "GlobalSetPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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" + "setLabels": { + "description": "Sets the labels on a machine image. To learn more about labels, read theLabeling\nResources documentation.", + "flatPath": "projects/{project}/global/machineImages/{resource}/setLabels", + "httpMethod": "POST", + "id": "compute.machineImages.setLabels", + "parameterOrder": [ + "project", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/machineImages/{resource}/setLabels", + "request": { + "$ref": "GlobalSetLabelsRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "selfLink": { - "description": "[Output Only] Server-defined URL for the resource.", - "type": "string" + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource.", + "flatPath": "projects/{project}/global/machineImages/{resource}/testIamPermissions", + "httpMethod": "POST", + "id": "compute.machineImages.testIamPermissions", + "parameterOrder": [ + "project", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/machineImages/{resource}/testIamPermissions", + "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" + ] } } }, - "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" - }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "machineTypes": { + "methods": { + "aggregatedList": { + "description": "Retrieves an aggregated list of machine types.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", + "flatPath": "projects/{project}/aggregated/machineTypes", + "httpMethod": "GET", + "id": "compute.machineTypes.aggregatedList", + "parameterOrder": [ + "project" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "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,\nglobal) should be included in the response. For new resource types added\nafter this field, the flag has no effect as new resource types will always\ninclude every visible scope for each scope type in response. For resource\ntypes which predate this field, if this flag is omitted or false, only\nscopes of the scope types where the resource type is expected to be found\nwill be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`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\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which\naggregated list request is invoked for subnetworks list-usable api.", + "format": "int64", + "location": "query", + "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" + }, + "path": "projects/{project}/aggregated/machineTypes", + "response": { + "$ref": "MachineTypeAggregatedList" + }, + "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" - }, - "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" - }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "get": { + "description": "Returns the specified machine type.", + "flatPath": "projects/{project}/zones/{zone}/machineTypes/{machineType}", + "httpMethod": "GET", + "id": "compute.machineTypes.get", + "parameterOrder": [ + "project", + "zone", + "machineType" + ], + "parameters": { + "machineType": { + "description": "Name of the machine type to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "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" + "path": "projects/{project}/zones/{zone}/machineTypes/{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" + ] }, - "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." + "list": { + "description": "Retrieves a list of machine types available to the specified\nproject.", + "flatPath": "projects/{project}/zones/{zone}/machineTypes", + "httpMethod": "GET", + "id": "compute.machineTypes.list", + "parameterOrder": [ + "project", + "zone" ], - "enum": [ - "ATTACH_READ_ONLY", - "BLANK", - "CUSTOM_IMAGE", - "DEFAULT", - "DO_NOT_INCLUDE", - "SOURCE_IMAGE", - "SOURCE_IMAGE_FAMILY" + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/machineTypes", + "response": { + "$ref": "MachineTypeList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] - }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "networkAttachments": { + "methods": { + "aggregatedList": { + "description": "Retrieves the list of all NetworkAttachment resources,\nregional and global, available to the specified project.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", + "flatPath": "projects/{project}/aggregated/networkAttachments", + "httpMethod": "GET", + "id": "compute.networkAttachments.aggregatedList", + "parameterOrder": [ + "project" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "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,\nglobal) should be included in the response. For new resource types added\nafter this field, the flag has no effect as new resource types will always\ninclude every visible scope for each scope type in response. For resource\ntypes which predate this field, if this flag is omitted or false, only\nscopes of the scope types where the resource type is expected to be found\nwill be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`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\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which\naggregated list request is invoked for subnetworks list-usable api.", + "format": "int64", + "location": "query", + "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" - } + }, + "path": "projects/{project}/aggregated/networkAttachments", + "response": { + "$ref": "NetworkAttachmentAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "delete": { + "description": "Deletes the specified NetworkAttachment in the given scope", + "flatPath": "projects/{project}/regions/{region}/networkAttachments/{networkAttachment}", + "httpMethod": "DELETE", + "id": "compute.networkAttachments.delete", + "parameterOrder": [ + "project", + "region", + "networkAttachment" + ], + "parameters": { + "networkAttachment": { + "description": "Name of the NetworkAttachment resource to delete.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).\nend_interface: MixerMutationRequestBuilder", + "location": "query", + "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" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the 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" + }, + "path": "projects/{project}/regions/{region}/networkAttachments/{networkAttachment}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "get": { + "description": "Returns the specified NetworkAttachment resource in the given scope.", + "flatPath": "projects/{project}/regions/{region}/networkAttachments/{networkAttachment}", + "httpMethod": "GET", + "id": "compute.networkAttachments.get", + "parameterOrder": [ + "project", + "region", + "networkAttachment" + ], + "parameters": { + "networkAttachment": { + "description": "Name of the NetworkAttachment resource to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "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" + }, + "path": "projects/{project}/regions/{region}/networkAttachments/{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" + ] }, - "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" + "getIamPolicy": { + "description": "Gets the access control policy for a resource. May be empty if no such\npolicy or resource exists.", + "flatPath": "projects/{project}/regions/{region}/networkAttachments/{resource}/getIamPolicy", + "httpMethod": "GET", + "id": "compute.networkAttachments.getIamPolicy", + "parameterOrder": [ + "project", + "region", + "resource" ], - "enum": [ - "CREATING", - "DELETING", - "FAILED", - "READY", - "UNAVAILABLE" + "parameters": { + "optionsRequestedPolicyVersion": { + "description": "Requested IAM Policy version.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/networkAttachments/{resource}/getIamPolicy", + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "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" + "insert": { + "description": "Creates a NetworkAttachment in the specified project in the given scope\nusing the parameters that are included in the request.", + "flatPath": "projects/{project}/regions/{region}/networkAttachments", + "httpMethod": "POST", + "id": "compute.networkAttachments.insert", + "parameterOrder": [ + "project", + "region" ], - "enum": [ - "ARCHITECTURE_UNSPECIFIED", - "ARM64", - "X86_64" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region of this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).\nend_interface: MixerMutationRequestBuilder", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/networkAttachments", + "request": { + "$ref": "NetworkAttachment" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "resourceStatus": { - "description": "[Output Only] Status information for the instant snapshot resource.", - "$ref": "InstantSnapshotResourceStatus" + "list": { + "description": "Lists the NetworkAttachments for a project in the given scope.", + "flatPath": "projects/{project}/regions/{region}/networkAttachments", + "httpMethod": "GET", + "id": "compute.networkAttachments.list", + "parameterOrder": [ + "project", + "region" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region of this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/regions/{region}/networkAttachments", + "response": { + "$ref": "NetworkAttachmentList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "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", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "patch": { + "description": "Patches the specified NetworkAttachment resource with the data included in\nthe request. This method supports PATCH\nsemantics and usesJSON merge\npatch format and processing rules.", + "flatPath": "projects/{project}/regions/{region}/networkAttachments/{networkAttachment}", + "httpMethod": "PATCH", + "id": "compute.networkAttachments.patch", + "parameterOrder": [ + "project", + "region", + "networkAttachment" + ], + "parameters": { + "networkAttachment": { + "description": "Name of the NetworkAttachment resource to patch.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).\nend_interface: MixerMutationRequestBuilder", + "location": "query", + "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" - } + }, + "path": "projects/{project}/regions/{region}/networkAttachments/{networkAttachment}", + "request": { + "$ref": "NetworkAttachment" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "setIamPolicy": { + "description": "Sets the access control policy on the specified resource.\nReplaces any existing policy.", + "flatPath": "projects/{project}/regions/{region}/networkAttachments/{resource}/setIamPolicy", + "httpMethod": "POST", + "id": "compute.networkAttachments.setIamPolicy", + "parameterOrder": [ + "project", + "region", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "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" + }, + "path": "projects/{project}/regions/{region}/networkAttachments/{resource}/setIamPolicy", + "request": { + "$ref": "RegionSetPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource.", + "flatPath": "projects/{project}/regions/{region}/networkAttachments/{resource}/testIamPermissions", + "httpMethod": "POST", + "id": "compute.networkAttachments.testIamPermissions", + "parameterOrder": [ + "project", + "region", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" } - } + }, + "path": "projects/{project}/regions/{region}/networkAttachments/{resource}/testIamPermissions", + "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" + ] } } }, - "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": [ - "", - "", - "", - "", - "", - "", - "", - "", - "", - "" + "networkEdgeSecurityServices": { + "methods": { + "aggregatedList": { + "description": "Retrieves the list of all NetworkEdgeSecurityService resources available to\nthe specified project.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", + "flatPath": "projects/{project}/aggregated/networkEdgeSecurityServices", + "httpMethod": "GET", + "id": "compute.networkEdgeSecurityServices.aggregatedList", + "parameterOrder": [ + "project" ], - "enum": [ - "AFRICA", - "ASIA_PAC", - "C_AFRICA", - "C_ASIA_PAC", - "C_EUROPE", - "C_NORTH_AMERICA", - "C_SOUTH_AMERICA", - "EUROPE", - "NORTH_AMERICA", - "SOUTH_AMERICA" + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region,\nglobal) should be included in the response. For new resource types added\nafter this field, the flag has no effect as new resource types will always\ninclude every visible scope for each scope type in response. For resource\ntypes which predate this field, if this flag is omitted or false, only\nscopes of the scope types where the resource type is expected to be found\nwill be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Name of the project scoping this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which\naggregated list request is invoked for subnetworks list-usable api.", + "format": "int64", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/aggregated/networkEdgeSecurityServices", + "response": { + "$ref": "NetworkEdgeSecurityServiceAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "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." + "delete": { + "description": "Deletes the specified service.", + "flatPath": "projects/{project}/regions/{region}/networkEdgeSecurityServices/{networkEdgeSecurityService}", + "httpMethod": "DELETE", + "id": "compute.networkEdgeSecurityServices.delete", + "parameterOrder": [ + "project", + "region", + "networkEdgeSecurityService" ], - "enum": [ - "AVAILABLE", - "CLOSED" + "parameters": { + "networkEdgeSecurityService": { + "description": "Name of the network edge security service to delete.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/networkEdgeSecurityServices/{networkEdgeSecurityService}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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: - IF_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 - LINK_TYPE_ETHERNET_400G_LR4 ", - "type": "array", - "items": { - "type": "string", - "enumDescriptions": [ - "100G Ethernet, LR Optics.", - "10G Ethernet, LR Optics. [(rate_bps) = 10000000000];", - "400G Ethernet, LR4 Optics." - ], - "enum": [ - "LINK_TYPE_ETHERNET_100G_LR", - "LINK_TYPE_ETHERNET_10G_LR", - "LINK_TYPE_ETHERNET_400G_LR4" - ] - } - } - } - }, - "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." + "get": { + "description": "Gets a specified NetworkEdgeSecurityService.", + "flatPath": "projects/{project}/regions/{region}/networkEdgeSecurityServices/{networkEdgeSecurityService}", + "httpMethod": "GET", + "id": "compute.networkEdgeSecurityServices.get", + "parameterOrder": [ + "project", + "region", + "networkEdgeSecurityService" ], - "enum": [ - "GLOBAL", - "LOCAL_REGION", - "LP_GLOBAL", - "LP_LOCAL_REGION" - ] - } - } - }, - "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" - } - }, - "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" - }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "parameters": { + "networkEdgeSecurityService": { + "description": "Name of the network edge security service to get.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" } - } - } - } - }, - "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": [ - "", - "", - "", - "", - "" - ], - "enum": [ - "AFRICA", - "ASIA_PAC", - "EUROPE", - "NORTH_AMERICA", - "SOUTH_AMERICA" + }, + "path": "projects/{project}/regions/{region}/networkEdgeSecurityServices/{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" ] }, - "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." + "insert": { + "description": "Creates a new service in the specified project using the data included in\nthe request.", + "flatPath": "projects/{project}/regions/{region}/networkEdgeSecurityServices", + "httpMethod": "POST", + "id": "compute.networkEdgeSecurityServices.insert", + "parameterOrder": [ + "project", + "region" ], - "enum": [ - "AVAILABLE", - "CLOSED" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "validateOnly": { + "description": "If true, the request will not be committed.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/regions/{region}/networkEdgeSecurityServices", + "request": { + "$ref": "NetworkEdgeSecurityService" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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." + "patch": { + "description": "Patches the specified policy with the data included in the request.", + "flatPath": "projects/{project}/regions/{region}/networkEdgeSecurityServices/{networkEdgeSecurityService}", + "httpMethod": "PATCH", + "id": "compute.networkEdgeSecurityServices.patch", + "parameterOrder": [ + "project", + "region", + "networkEdgeSecurityService" ], - "enum": [ - "LACP_SUPPORTED", - "LACP_UNSUPPORTED" + "parameters": { + "networkEdgeSecurityService": { + "description": "Name of the network edge security service to update.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "paths": { + "location": "query", + "repeated": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "updateMask": { + "description": "Indicates fields to be updated as part of this request.", + "format": "google-fieldmask", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/networkEdgeSecurityServices/{networkEdgeSecurityService}", + "request": { + "$ref": "NetworkEdgeSecurityService" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] - }, - "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" - } - } - }, - "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." + "networkEndpointGroups": { + "methods": { + "aggregatedList": { + "description": "Retrieves the list of network endpoint groups and sorts them by zone.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", + "flatPath": "projects/{project}/aggregated/networkEndpointGroups", + "httpMethod": "GET", + "id": "compute.networkEndpointGroups.aggregatedList", + "parameterOrder": [ + "project" ], - "enum": [ - "PORT_PAIR_MATCHING_VLAN", - "PORT_PAIR_UNCONSTRAINED_VLAN" + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region,\nglobal) should be included in the response. For new resource types added\nafter this field, the flag has no effect as new resource types will always\ninclude every visible scope for each scope type in response. For resource\ntypes which predate this field, if this flag is omitted or false, only\nscopes of the scope types where the resource type is expected to be found\nwill be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which\naggregated list request is invoked for subnetworks list-usable api.", + "format": "int64", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/aggregated/networkEndpointGroups", + "response": { + "$ref": "NetworkEndpointGroupAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "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." + "attachNetworkEndpoints": { + "description": "Attach a list of network endpoints to the specified network endpoint group.", + "flatPath": "projects/{project}/zones/{zone}/networkEndpointGroups/{networkEndpointGroup}/attachNetworkEndpoints", + "httpMethod": "POST", + "id": "compute.networkEndpointGroups.attachNetworkEndpoints", + "parameterOrder": [ + "project", + "zone", + "networkEndpointGroup" ], - "enum": [ - "PORT_PAIR_MATCHING_REMOTE_LOCATION", - "PORT_PAIR_UNCONSTRAINED_REMOTE_LOCATION" + "parameters": { + "networkEndpointGroup": { + "description": "The name of the network endpoint group where you are attaching network\nendpoints to. It should comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone where\nthe network endpoint group is located. It should comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/networkEndpointGroups/{networkEndpointGroup}/attachNetworkEndpoints", + "request": { + "$ref": "NetworkEndpointGroupsAttachEndpointsRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] - } - } - }, - "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" }, - "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" - ] + "delete": { + "description": "Deletes the specified network endpoint group. The network endpoints in the\nNEG and the VM instances they belong to are not terminated when the NEG is\ndeleted. Note that the NEG cannot be deleted if there are backend services\nreferencing it.", + "flatPath": "projects/{project}/zones/{zone}/networkEndpointGroups/{networkEndpointGroup}", + "httpMethod": "DELETE", + "id": "compute.networkEndpointGroups.delete", + "parameterOrder": [ + "project", + "zone", + "networkEndpointGroup" + ], + "parameters": { + "networkEndpointGroup": { + "description": "The name of the network endpoint group to delete. It should comply with\nRFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone where\nthe network endpoint group is located. It should comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" + } }, - "type": "string" - }, - "creationTimestamp": { - "description": "[Output Only] Creation timestamp in RFC3339 text format.", - "type": "string" + "path": "projects/{project}/zones/{zone}/networkEndpointGroups/{networkEndpointGroup}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "description": { - "description": "[Output Only] Description of this License Code.", - "type": "string" + "detachNetworkEndpoints": { + "description": "Detach a list of network endpoints from the specified network endpoint\ngroup.", + "flatPath": "projects/{project}/zones/{zone}/networkEndpointGroups/{networkEndpointGroup}/detachNetworkEndpoints", + "httpMethod": "POST", + "id": "compute.networkEndpointGroups.detachNetworkEndpoints", + "parameterOrder": [ + "project", + "zone", + "networkEndpointGroup" + ], + "parameters": { + "networkEndpointGroup": { + "description": "The name of the network endpoint group where you are removing network\nendpoints. It should comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone where\nthe network endpoint group is located. It should comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/networkEndpointGroups/{networkEndpointGroup}/detachNetworkEndpoints", + "request": { + "$ref": "NetworkEndpointGroupsDetachEndpointsRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "selfLink": { - "description": "[Output Only] Server-defined URL for the resource.", - "type": "string" + "get": { + "description": "Returns the specified network endpoint group.", + "flatPath": "projects/{project}/zones/{zone}/networkEndpointGroups/{networkEndpointGroup}", + "httpMethod": "GET", + "id": "compute.networkEndpointGroups.get", + "parameterOrder": [ + "project", + "zone", + "networkEndpointGroup" + ], + "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.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone where\nthe network endpoint group is located. It should comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/networkEndpointGroups/{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" + ] }, - "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" + "insert": { + "description": "Creates a network endpoint group in the specified project using the\nparameters that are included in the request.\n\nNote: Use the following APIs to manage network endpoint groups:\n \n - \n To manage NEGs with zonal scope (such as zonal NEGs, hybrid connectivity\n NEGs): zonal\n API\n - \n To manage NEGs with regional scope (such as regional internet NEGs,\n serverless NEGs, Private Service Connect NEGs): regional\n API\n - \n To manage NEGs with global scope (such as global internet NEGs):global\n API", + "flatPath": "projects/{project}/zones/{zone}/networkEndpointGroups", + "httpMethod": "POST", + "id": "compute.networkEndpointGroups.insert", + "parameterOrder": [ + "project", + "zone" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone where\nyou want to create the network endpoint group. It should comply with\nRFC1035.", + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/networkEndpointGroups", + "request": { + "$ref": "NetworkEndpointGroup" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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." + "list": { + "description": "Retrieves the list of network endpoint groups that are located in the\nspecified project and zone.", + "flatPath": "projects/{project}/zones/{zone}/networkEndpointGroups", + "httpMethod": "GET", + "id": "compute.networkEndpointGroups.list", + "parameterOrder": [ + "project", + "zone" ], - "enum": [ - "DISABLED", - "ENABLED", - "RESTRICTED", - "STATE_UNSPECIFIED", - "TERMINATED" + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "zone": { + "description": "The name of thezone\nwhere the network endpoint group is located. It should comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/networkEndpointGroups", + "response": { + "$ref": "NetworkEndpointGroupList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "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" + "listNetworkEndpoints": { + "description": "Lists the network endpoints in the specified network endpoint group.", + "flatPath": "projects/{project}/zones/{zone}/networkEndpointGroups/{networkEndpointGroup}/listNetworkEndpoints", + "httpMethod": "POST", + "id": "compute.networkEndpointGroups.listNetworkEndpoints", + "parameterOrder": [ + "project", + "zone", + "networkEndpointGroup" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "networkEndpointGroup": { + "description": "The name of the network endpoint group from which you want to generate a\nlist 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\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "zone": { + "description": "The name of the zone where\nthe network endpoint group is located. It should comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/networkEndpointGroups/{networkEndpointGroup}/listNetworkEndpoints", + "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": { - "description": "[Output Only] Description of this License Code.", - "type": "string" + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource.", + "flatPath": "projects/{project}/zones/{zone}/networkEndpointGroups/{resource}/testIamPermissions", + "httpMethod": "POST", + "id": "compute.networkEndpointGroups.testIamPermissions", + "parameterOrder": [ + "project", + "zone", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/networkEndpointGroups/{resource}/testIamPermissions", + "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" + ] } } }, - "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" - ] - }, - "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" - }, - "selfLinkWithId": { - "description": "[Output Only] Server-defined URL for this resource with the resource id.", - "type": "string" - }, - "resourceRequirements": { - "description": "[Input Only] Deprecated.", - "$ref": "LicenseResourceRequirements" - }, - "appendableToDisk": { - "description": "If true, this license can be appended to an existing disk's set of licenses.", - "type": "boolean" - }, - "removableFromDisk": { - "description": "If true, this license can be removed from a disk's set of licenses, with no replacement license needed.", - "type": "boolean" - }, - "allowedReplacementLicenses": { - "description": "Specifies licenseCodes of licenses that can replace this license. Note: such replacements are allowed even if removable_from_disk is false.", - "type": "array", - "items": { - "type": "string" - } - }, - "osLicense": { - "description": "If true, indicates this is an OS license. Only one OS license can be attached to a disk or image at a time.", - "type": "boolean" - }, - "incompatibleLicenses": { - "description": "Specifies licenseCodes of licenses that are incompatible with this license. If a license is incompatible with this license, it cannot be attached to the same disk or image.", - "type": "array", - "items": { - "type": "string" - } - }, - "requiredCoattachedLicenses": { - "description": "Specifies the set of permissible coattached licenseCodes of licenses that satisfy the coattachment requirement of this license. At least one license from the set must be attached to the same disk or image as this license.", - "type": "array", - "items": { - "type": "string" - } - }, - "soleTenantOnly": { - "description": "If true, this license can only be used on VMs on sole tenant nodes.", - "type": "boolean" - }, - "multiTenantOnly": { - "description": "If true, this license can only be used on VMs on multi tenant nodes.", - "type": "boolean" - }, - "minimumRetention": { - "description": "If set, this license will be unable to be removed or replaced once attached to a disk until the minimum_retention period has passed.", - "$ref": "Duration" - }, - "updateTimestamp": { - "description": "[Output Only] Last update timestamp in RFC3339 text format.", - "type": "string" - } - } - }, - "LicenseResourceRequirements": { - "id": "LicenseResourceRequirements", - "type": "object", - "properties": { - "minGuestCpuCount": { - "description": "[Input Only] Deprecated. This field no longer reflects the minimum number of guest cpus required to use the Instance.", - "type": "integer", - "format": "int32" - }, - "minMemoryMb": { - "description": "[Input Only] Deprecated. This field no longer reflects the minimum memory required to use the Instance.", - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "networkFirewallPolicies": { + "methods": { + "addAssociation": { + "description": "Inserts an association for the specified firewall policy.", + "flatPath": "projects/{project}/global/firewallPolicies/{firewallPolicy}/addAssociation", + "httpMethod": "POST", + "id": "compute.networkFirewallPolicies.addAssociation", + "parameterOrder": [ + "project", + "firewallPolicy" + ], + "parameters": { + "firewallPolicy": { + "description": "Name of the firewall policy to update.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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" - } - } - } + "replaceExistingAssociation": { + "description": "Indicates whether or not to replace it if an association of the attachment\nalready exists. This is false by default, in which case an error will be\nreturned if an association already exists.", + "location": "query", + "type": "boolean" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "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" - }, - "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" + }, + "path": "projects/{project}/global/firewallPolicies/{firewallPolicy}/addAssociation", + "request": { + "$ref": "FirewallPolicyAssociation" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "addPacketMirroringRule": { + "description": "Inserts a packet mirroring rule into a firewall policy.", + "flatPath": "projects/{project}/global/firewallPolicies/{firewallPolicy}/addPacketMirroringRule", + "httpMethod": "POST", + "id": "compute.networkFirewallPolicies.addPacketMirroringRule", + "parameterOrder": [ + "project", + "firewallPolicy" + ], + "parameters": { + "firewallPolicy": { + "description": "Name of the firewall policy to update.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "maxPriority": { + "description": "When rule.priority is not specified, auto choose a unused priority betweenminPriority and maxPriority>.\nThis field is exclusive with rule.priority.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "minPriority": { + "description": "When rule.priority is not specified, auto choose a unused priority betweenminPriority and maxPriority>.\nThis field is exclusive with rule.priority.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "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" + "path": "projects/{project}/global/firewallPolicies/{firewallPolicy}/addPacketMirroringRule", + "request": { + "$ref": "FirewallPolicyRule" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "status": { - "description": "[Output Only] The status of the machine image. One of the following values: INVALID, CREATING, READY, DELETING, and UPLOADING.", - "type": "string", - "enumDescriptions": [ - "", - "", - "", - "", - "" + "addRule": { + "description": "Inserts a rule into a firewall policy.", + "flatPath": "projects/{project}/global/firewallPolicies/{firewallPolicy}/addRule", + "httpMethod": "POST", + "id": "compute.networkFirewallPolicies.addRule", + "parameterOrder": [ + "project", + "firewallPolicy" ], - "enum": [ - "CREATING", - "DELETING", - "INVALID", - "READY", - "UPLOADING" + "parameters": { + "firewallPolicy": { + "description": "Name of the firewall policy to update.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "maxPriority": { + "description": "When rule.priority is not specified, auto choose a unused priority betweenminPriority and maxPriority>.\nThis field is exclusive with rule.priority.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "minPriority": { + "description": "When rule.priority is not specified, auto choose a unused priority betweenminPriority and maxPriority>.\nThis field is exclusive with rule.priority.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/firewallPolicies/{firewallPolicy}/addRule", + "request": { + "$ref": "FirewallPolicyRule" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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" - }, - "labels": { - "description": "Labels to apply to this machine 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 machine image, 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 machine image.", - "type": "string", - "format": "byte" - }, - "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." + "aggregatedList": { + "description": "Retrieves an aggregated list of network firewall policies, listing network\nfirewall policies from all applicable scopes (global and regional) and\ngrouping the results per scope.\n\nTo prevent failure, it is recommended that you set the\n`returnPartialSuccess` parameter to `true`.", + "flatPath": "projects/{project}/aggregated/firewallPolicies", + "httpMethod": "GET", + "id": "compute.networkFirewallPolicies.aggregatedList", + "parameterOrder": [ + "project" ], - "enum": [ - "KEY_REVOCATION_ACTION_TYPE_UNSPECIFIED", - "NONE", - "STOP" + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region,\nglobal) should be included in the response. For new resource types added\nafter this field, the flag has no effect as new resource types will always\ninclude every visible scope for each scope type in response. For resource\ntypes which predate this field, if this flag is omitted or false, only\nscopes of the scope types where the resource type is expected to be found\nwill be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which\naggregated list request is invoked for subnetworks list-usable api.", + "format": "int64", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/aggregated/firewallPolicies", + "response": { + "$ref": "NetworkFirewallPolicyAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] - } - } - }, - "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" }, - "type": { - "description": "Specifies the type of the attached disk, either SCRATCH or PERSISTENT.", - "type": "string", - "enumDescriptions": [ - "", - "" + "cloneRules": { + "description": "Copies rules to the specified firewall policy.", + "flatPath": "projects/{project}/global/firewallPolicies/{firewallPolicy}/cloneRules", + "httpMethod": "POST", + "id": "compute.networkFirewallPolicies.cloneRules", + "parameterOrder": [ + "project", + "firewallPolicy" ], - "enum": [ - "PERSISTENT", - "SCRATCH" + "parameters": { + "firewallPolicy": { + "description": "Name of the firewall policy to update.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "sourceFirewallPolicy": { + "description": "The firewall policy from which to copy rules.", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/firewallPolicies/{firewallPolicy}/cloneRules", + "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." + "delete": { + "description": "Deletes the specified policy.", + "flatPath": "projects/{project}/global/firewallPolicies/{firewallPolicy}", + "httpMethod": "DELETE", + "id": "compute.networkFirewallPolicies.delete", + "parameterOrder": [ + "project", + "firewallPolicy" ], - "enum": [ - "READ_ONLY", - "READ_WRITE" + "parameters": { + "firewallPolicy": { + "description": "Name of the firewall policy to delete.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/firewallPolicies/{firewallPolicy}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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": [ - "", - "" + "get": { + "description": "Returns the specified network firewall policy.", + "flatPath": "projects/{project}/global/firewallPolicies/{firewallPolicy}", + "httpMethod": "GET", + "id": "compute.networkFirewallPolicies.get", + "parameterOrder": [ + "project", + "firewallPolicy" ], - "enum": [ - "NVME", - "SCSI" + "parameters": { + "firewallPolicy": { + "description": "Name of the firewall policy to get.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/firewallPolicies/{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" ] }, - "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": [ - "", - "" + "getAssociation": { + "description": "Gets an association with the specified name.", + "flatPath": "projects/{project}/global/firewallPolicies/{firewallPolicy}/getAssociation", + "httpMethod": "GET", + "id": "compute.networkFirewallPolicies.getAssociation", + "parameterOrder": [ + "project", + "firewallPolicy" ], - "enum": [ - "UPDATING", - "UP_TO_DATE" + "parameters": { + "firewallPolicy": { + "description": "Name of the firewall policy to which the queried association belongs.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "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.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/firewallPolicies/{firewallPolicy}/getAssociation", + "response": { + "$ref": "FirewallPolicyAssociation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "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": [ - "", - "" + "getIamPolicy": { + "description": "Gets the access control policy for a resource. May be empty if no such\npolicy or resource exists.", + "flatPath": "projects/{project}/global/firewallPolicies/{resource}/getIamPolicy", + "httpMethod": "GET", + "id": "compute.networkFirewallPolicies.getIamPolicy", + "parameterOrder": [ + "project", + "resource" ], - "enum": [ - "UPDATING", - "UP_TO_DATE" + "parameters": { + "optionsRequestedPolicyVersion": { + "description": "Requested IAM Policy version.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/firewallPolicies/{resource}/getIamPolicy", + "response": { + "$ref": "Policy" + }, + "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 attached disk.", - "type": "string", - "enumDescriptions": [ - "Default value indicating Architecture is not set.", - "Machines with architecture ARM64", - "Machines with architecture X86_64" + "getPacketMirroringRule": { + "description": "Gets a packet mirroring rule of the specified priority.", + "flatPath": "projects/{project}/global/firewallPolicies/{firewallPolicy}/getPacketMirroringRule", + "httpMethod": "GET", + "id": "compute.networkFirewallPolicies.getPacketMirroringRule", + "parameterOrder": [ + "project", + "firewallPolicy" ], - "enum": [ - "ARCHITECTURE_UNSPECIFIED", - "ARM64", - "X86_64" + "parameters": { + "firewallPolicy": { + "description": "Name of the firewall policy to which the queried rule belongs.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "priority": { + "description": "The priority of the rule to get from the firewall policy.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/firewallPolicies/{firewallPolicy}/getPacketMirroringRule", + "response": { + "$ref": "FirewallPolicyRule" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] - } - } - }, - "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" - }, - "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" + "getRule": { + "description": "Gets a rule of the specified priority.", + "flatPath": "projects/{project}/global/firewallPolicies/{firewallPolicy}/getRule", + "httpMethod": "GET", + "id": "compute.networkFirewallPolicies.getRule", + "parameterOrder": [ + "project", + "firewallPolicy" + ], + "parameters": { + "firewallPolicy": { + "description": "Name of the firewall policy to which the queried rule belongs.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "priority": { + "description": "The priority of the rule to get from the firewall policy.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/firewallPolicies/{firewallPolicy}/getRule", + "response": { + "$ref": "FirewallPolicyRule" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "items": { - "description": "A list of MachineType resources.", - "type": "array", - "items": { - "$ref": "MachineType" - } + "insert": { + "description": "Creates a new policy in the specified project using the data included in\nthe request.", + "flatPath": "projects/{project}/global/firewallPolicies", + "httpMethod": "POST", + "id": "compute.networkFirewallPolicies.insert", + "parameterOrder": [ + "project" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/firewallPolicies", + "request": { + "$ref": "FirewallPolicy" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the 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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "list": { + "description": "Lists all the policies that have been configured for the specified project.", + "flatPath": "projects/{project}/global/firewallPolicies", + "httpMethod": "GET", + "id": "compute.networkFirewallPolicies.list", + "parameterOrder": [ + "project" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`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\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith 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" - }, - "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" + }, + "path": "projects/{project}/global/firewallPolicies", + "response": { + "$ref": "FirewallPolicyList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "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" - } + "patch": { + "description": "Patches the specified policy with the data included in the request.", + "flatPath": "projects/{project}/global/firewallPolicies/{firewallPolicy}", + "httpMethod": "PATCH", + "id": "compute.networkFirewallPolicies.patch", + "parameterOrder": [ + "project", + "firewallPolicy" + ], + "parameters": { + "firewallPolicy": { + "description": "Name of the firewall policy to update.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" } - } + }, + "path": "projects/{project}/global/firewallPolicies/{firewallPolicy}", + "request": { + "$ref": "FirewallPolicy" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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" + "patchPacketMirroringRule": { + "description": "Patches a packet mirroring rule of the specified priority.", + "flatPath": "projects/{project}/global/firewallPolicies/{firewallPolicy}/patchPacketMirroringRule", + "httpMethod": "POST", + "id": "compute.networkFirewallPolicies.patchPacketMirroringRule", + "parameterOrder": [ + "project", + "firewallPolicy" ], - "enum": [ - "ARCHITECTURE_UNSPECIFIED", - "ARM64", - "X86_64" + "parameters": { + "firewallPolicy": { + "description": "Name of the firewall policy to update.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "priority": { + "description": "The priority of the rule to patch.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/firewallPolicies/{firewallPolicy}/patchPacketMirroringRule", + "request": { + "$ref": "FirewallPolicyRule" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] - } - } - }, - "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" - }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "patchRule": { + "description": "Patches a rule of the specified priority.", + "flatPath": "projects/{project}/global/firewallPolicies/{firewallPolicy}/patchRule", + "httpMethod": "POST", + "id": "compute.networkFirewallPolicies.patchRule", + "parameterOrder": [ + "project", + "firewallPolicy" + ], + "parameters": { + "firewallPolicy": { + "description": "Name of the firewall policy to update.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "priority": { + "description": "The priority of the rule to patch.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" } - } + }, + "path": "projects/{project}/global/firewallPolicies/{firewallPolicy}/patchRule", + "request": { + "$ref": "FirewallPolicyRule" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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" - } + "removeAssociation": { + "description": "Removes an association for the specified firewall policy.", + "flatPath": "projects/{project}/global/firewallPolicies/{firewallPolicy}/removeAssociation", + "httpMethod": "POST", + "id": "compute.networkFirewallPolicies.removeAssociation", + "parameterOrder": [ + "project", + "firewallPolicy" + ], + "parameters": { + "firewallPolicy": { + "description": "Name of the firewall policy to update.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "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.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/firewallPolicies/{firewallPolicy}/removeAssociation", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "removePacketMirroringRule": { + "description": "Deletes a packet mirroring rule of the specified priority.", + "flatPath": "projects/{project}/global/firewallPolicies/{firewallPolicy}/removePacketMirroringRule", + "httpMethod": "POST", + "id": "compute.networkFirewallPolicies.removePacketMirroringRule", + "parameterOrder": [ + "project", + "firewallPolicy" + ], + "parameters": { + "firewallPolicy": { + "description": "Name of the firewall policy to update.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "priority": { + "description": "The priority of the rule to remove from the firewall policy.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(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" - }, - "items": { - "description": "A list of NetworkAttachmentsScopedList resources.", - "type": "object", - "additionalProperties": { - "description": "Name of the scope containing this set of NetworkAttachments.", - "$ref": "NetworkAttachmentsScopedList" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the 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" + }, + "path": "projects/{project}/global/firewallPolicies/{firewallPolicy}/removePacketMirroringRule", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "removeRule": { + "description": "Deletes a rule of the specified priority.", + "flatPath": "projects/{project}/global/firewallPolicies/{firewallPolicy}/removeRule", + "httpMethod": "POST", + "id": "compute.networkFirewallPolicies.removeRule", + "parameterOrder": [ + "project", + "firewallPolicy" + ], + "parameters": { + "firewallPolicy": { + "description": "Name of the firewall policy to update.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "priority": { + "description": "The priority of the rule to remove from the firewall policy.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" } - } - } - } - }, - "NetworkAttachmentsScopedList": { - "id": "NetworkAttachmentsScopedList", - "type": "object", - "properties": { - "networkAttachments": { - "description": "A list of NetworkAttachments contained in this scope.", - "type": "array", - "items": { - "$ref": "NetworkAttachment" - } + }, + "path": "projects/{project}/global/firewallPolicies/{firewallPolicy}/removeRule", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "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.", + "setIamPolicy": { + "description": "Sets the access control policy on the specified resource.\nReplaces any existing policy.", + "flatPath": "projects/{project}/global/firewallPolicies/{resource}/setIamPolicy", + "httpMethod": "POST", + "id": "compute.networkFirewallPolicies.setIamPolicy", + "parameterOrder": [ + "project", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "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" - ] }, - "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" + "path": "projects/{project}/global/firewallPolicies/{resource}/setIamPolicy", + "request": { + "$ref": "GlobalSetPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "connectionPreference": { - "type": "string", - "enumDescriptions": [ - "", - "", - "" + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource.", + "flatPath": "projects/{project}/global/firewallPolicies/{resource}/testIamPermissions", + "httpMethod": "POST", + "id": "compute.networkFirewallPolicies.testIamPermissions", + "parameterOrder": [ + "project", + "resource" ], - "enum": [ - "ACCEPT_AUTOMATIC", - "ACCEPT_MANUAL", - "INVALID" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/firewallPolicies/{resource}/testIamPermissions", + "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" ] - }, - "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.", - "" + "networkProfiles": { + "methods": { + "get": { + "description": "Returns the specified network profile.", + "flatPath": "projects/{project}/global/networkProfiles/{networkProfile}", + "httpMethod": "GET", + "id": "compute.networkProfiles.get", + "parameterOrder": [ + "project", + "networkProfile" ], - "enum": [ - "ACCEPTED", - "CLOSED", - "NEEDS_ATTENTION", - "PENDING", - "REJECTED", - "STATUS_UNSPECIFIED" + "parameters": { + "networkProfile": { + "description": "Name of the network profile to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/networkProfiles/{networkProfile}", + "response": { + "$ref": "NetworkProfile" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "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" - }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "list": { + "description": "Retrieves a list of network profiles available to the specified\nproject.", + "flatPath": "projects/{project}/global/networkProfiles", + "httpMethod": "GET", + "id": "compute.networkProfiles.list", + "parameterOrder": [ + "project" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`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\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith 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" - }, - "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" + }, + "path": "projects/{project}/global/networkProfiles", + "response": { + "$ref": "NetworkProfilesListResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] } } }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "networks": { + "methods": { + "addPeering": { + "description": "Adds a peering to the specified network.", + "flatPath": "projects/{project}/global/networks/{network}/addPeering", + "httpMethod": "POST", + "id": "compute.networks.addPeering", + "parameterOrder": [ + "project", + "network" + ], + "parameters": { + "network": { + "description": "Name of the network resource to add peering to.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" } - } + }, + "path": "projects/{project}/global/networks/{network}/addPeering", + "request": { + "$ref": "NetworksAddPeeringRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "etag": { - "type": "string" + "cancelRequestRemovePeering": { + "description": "Cancel requests to remove a peering from the specified network. Applicable\nonly for PeeringConnection with update_strategy=CONSENSUS. Cancels a\nrequest to remove a peering from the specified network.", + "flatPath": "projects/{project}/global/networks/{network}/cancelRequestRemovePeering", + "httpMethod": "POST", + "id": "compute.networks.cancelRequestRemovePeering", + "parameterOrder": [ + "project", + "network" + ], + "parameters": { + "network": { + "description": "Name of the network resource to remove peering from.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/networks/{network}/cancelRequestRemovePeering", + "request": { + "$ref": "NetworksCancelRequestRemovePeeringRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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" - } + "delete": { + "description": "Deletes the specified network.", + "flatPath": "projects/{project}/global/networks/{network}", + "httpMethod": "DELETE", + "id": "compute.networks.delete", + "parameterOrder": [ + "project", + "network" + ], + "parameters": { + "network": { + "description": "Name of the network to delete.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/networks/{network}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "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.", + "get": { + "description": "Returns the specified network.", + "flatPath": "projects/{project}/global/networks/{network}", + "httpMethod": "GET", + "id": "compute.networks.get", + "parameterOrder": [ + "project", + "network" + ], + "parameters": { + "network": { + "description": "Name of the network to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "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.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" } - } - } - } - }, - "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" + }, + "path": "projects/{project}/global/networks/{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" + ] }, - "items": { - "description": "A list of NetworkEndpointGroup resources.", - "type": "array", - "items": { - "$ref": "NetworkEndpointGroup" - } + "getEffectiveFirewalls": { + "description": "Returns the effective firewalls on a given network.", + "flatPath": "projects/{project}/global/networks/{network}/getEffectiveFirewalls", + "httpMethod": "GET", + "id": "compute.networks.getEffectiveFirewalls", + "parameterOrder": [ + "project", + "network" + ], + "parameters": { + "network": { + "description": "Name of the network for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/networks/{network}/getEffectiveFirewalls", + "response": { + "$ref": "NetworksGetEffectiveFirewallsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the 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": { + "description": "Creates a network in the specified project using the data included\nin the request.", + "flatPath": "projects/{project}/global/networks", + "httpMethod": "POST", + "id": "compute.networks.insert", + "parameterOrder": [ + "project" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/networks", + "request": { + "$ref": "Network" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "list": { + "description": "Retrieves the list of networks available to the specified project.", + "flatPath": "projects/{project}/global/networks", + "httpMethod": "GET", + "id": "compute.networks.list", + "parameterOrder": [ + "project" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/global/networks", + "response": { + "$ref": "NetworkList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." + "listPeeringRoutes": { + "description": "Lists the peering routes exchanged over peering connection.", + "flatPath": "projects/{project}/global/networks/{network}/listPeeringRoutes", + "httpMethod": "GET", + "id": "compute.networks.listPeeringRoutes", + "parameterOrder": [ + "project", + "network" + ], + "parameters": { + "direction": { + "description": "The direction of the exchanged routes.", + "enum": [ + "INCOMING", + "OUTGOING" ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false + "enumDescriptions": [ + "For routes exported from peer network.", + "For routes exported from local network." ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "location": "query", + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "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": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "network": { + "description": "Name of the network for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe 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.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The region of the request. The response will include all subnet routes,\nstatic 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\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" } - } - } - } - }, - "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" + }, + "path": "projects/{project}/global/networks/{network}/listPeeringRoutes", + "response": { + "$ref": "ExchangedPeeringRoutesList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "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." + "patch": { + "description": "Patches the specified network with the data included in the request.\nOnly routingConfig can be modified.", + "flatPath": "projects/{project}/global/networks/{network}", + "httpMethod": "PATCH", + "id": "compute.networks.patch", + "parameterOrder": [ + "project", + "network" ], - "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" + "parameters": { + "network": { + "description": "Name of the network to update.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/networks/{network}", + "request": { + "$ref": "Network" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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. Optional. 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": "Optional. Metadata defined as annotations on the network endpoint group.", - "type": "object", - "additionalProperties": { - "type": "string" - } - }, - "cloudRun": { - "description": "Optional. Only valid when networkEndpointType is SERVERLESS. Only one of cloudRun, appEngine or cloudFunction may be set.", - "$ref": "NetworkEndpointGroupCloudRun" - }, - "appEngine": { - "description": "Optional. Only valid when networkEndpointType is SERVERLESS. Only one of cloudRun, appEngine or cloudFunction may be set.", - "$ref": "NetworkEndpointGroupAppEngine" - }, - "cloudFunction": { - "description": "Optional. 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. Optional. Only valid when networkEndpointType is PRIVATE_SERVICE_CONNECT.", - "type": "string" - }, - "pscData": { - "description": "Optional. Only valid when networkEndpointType is PRIVATE_SERVICE_CONNECT.", - "$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.", - "" + "removePeering": { + "description": "Removes a peering from the specified network.", + "flatPath": "projects/{project}/global/networks/{network}/removePeering", + "httpMethod": "POST", + "id": "compute.networks.removePeering", + "parameterOrder": [ + "project", + "network" ], - "enum": [ - "ACCEPTED", - "CLOSED", - "NEEDS_ATTENTION", - "PENDING", - "REJECTED", - "STATUS_UNSPECIFIED" + "parameters": { + "network": { + "description": "Name of the network resource to remove peering from.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/networks/{network}/removePeering", + "request": { + "$ref": "NetworksRemovePeeringRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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" - } - } - }, - "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" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the 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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "requestRemovePeering": { + "description": "Requests to remove a peering from the specified network. Applicable only\nfor PeeringConnection with update_strategy=CONSENSUS.", + "flatPath": "projects/{project}/global/networks/{network}/requestRemovePeering", + "httpMethod": "POST", + "id": "compute.networks.requestRemovePeering", + "parameterOrder": [ + "project", + "network" + ], + "parameters": { + "network": { + "description": "Name of the network resource to remove peering from.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(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" - } + }, + "path": "projects/{project}/global/networks/{network}/requestRemovePeering", + "request": { + "$ref": "NetworksRequestRemovePeeringRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "switchToCustomMode": { + "description": "Switches the network mode from auto subnet mode to custom subnet mode.", + "flatPath": "projects/{project}/global/networks/{network}/switchToCustomMode", + "httpMethod": "POST", + "id": "compute.networks.switchToCustomMode", + "parameterOrder": [ + "project", + "network" + ], + "parameters": { + "network": { + "description": "Name of the network to be updated.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(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" - }, - "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. Optional. 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. Optional, the field presence depends on the network endpoint type. The 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" + }, + "path": "projects/{project}/global/networks/{network}/switchToCustomMode", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "annotations": { - "description": "Optional 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." + "updatePeering": { + "description": "Updates the specified network peering with the data included in the\nrequest. You can only modify the NetworkPeering.export_custom_routes field\nand the NetworkPeering.import_custom_routes field.", + "flatPath": "projects/{project}/global/networks/{network}/updatePeering", + "httpMethod": "PATCH", + "id": "compute.networks.updatePeering", + "parameterOrder": [ + "project", + "network" ], - "enum": [ - "SHOW", - "SKIP" + "parameters": { + "network": { + "description": "Name of the network resource which the updated peering is belonging to.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/networks/{network}/updatePeering", + "request": { + "$ref": "NetworksUpdatePeeringRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] } } }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "nodeGroups": { + "methods": { + "addNodes": { + "description": "Adds specified number of nodes to the node group.", + "flatPath": "projects/{project}/zones/{zone}/nodeGroups/{nodeGroup}/addNodes", + "httpMethod": "POST", + "id": "compute.nodeGroups.addNodes", + "parameterOrder": [ + "project", + "zone", + "nodeGroup" + ], + "parameters": { + "nodeGroup": { + "description": "Name of the NodeGroup resource.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" } - } - } - } - }, - "NetworkEndpointWithHealthStatus": { - "id": "NetworkEndpointWithHealthStatus", - "type": "object", - "properties": { - "networkEndpoint": { - "description": "[Output only] The network endpoint.", - "$ref": "NetworkEndpoint" - }, - "healths": { - "description": "[Output only] The health status of network endpoint. Optional. Displayed only if the network endpoint has centralized health checking configured.", - "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" - }, - "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." - ], - "enum": [ - "DRAINING", - "HEALTHY", - "UNHEALTHY", - "UNKNOWN" + }, + "path": "projects/{project}/zones/{zone}/nodeGroups/{nodeGroup}/addNodes", + "request": { + "$ref": "NodeGroupsAddNodesRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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." + "aggregatedList": { + "description": "Retrieves an aggregated list of node groups.\nNote: use nodeGroups.listNodes for more details about each group.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", + "flatPath": "projects/{project}/aggregated/nodeGroups", + "httpMethod": "GET", + "id": "compute.nodeGroups.aggregatedList", + "parameterOrder": [ + "project" ], - "enum": [ - "DRAINING", - "HEALTHY", - "UNHEALTHY", - "UNKNOWN" + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region,\nglobal) should be included in the response. For new resource types added\nafter this field, the flag has no effect as new resource types will always\ninclude every visible scope for each scope type in response. For resource\ntypes which predate this field, if this flag is omitted or false, only\nscopes of the scope types where the resource type is expected to be found\nwill be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which\naggregated list request is invoked for subnetworks list-usable api.", + "format": "int64", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/aggregated/nodeGroups", + "response": { + "$ref": "NodeGroupAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] - } - } - }, - "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" - } - } - } - }, - "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" - }, - "items": { - "description": "A list of Network resources.", - "type": "array", - "items": { - "$ref": "Network" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the 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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "delete": { + "description": "Deletes the specified NodeGroup resource.", + "flatPath": "projects/{project}/zones/{zone}/nodeGroups/{nodeGroup}", + "httpMethod": "DELETE", + "id": "compute.nodeGroups.delete", + "parameterOrder": [ + "project", + "zone", + "nodeGroup" + ], + "parameters": { + "nodeGroup": { + "description": "Name of the NodeGroup resource to delete.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "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" + "path": "projects/{project}/zones/{zone}/nodeGroups/{nodeGroup}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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": [ - "", - "" + "deleteNodes": { + "description": "Deletes specified nodes from the node group.", + "flatPath": "projects/{project}/zones/{zone}/nodeGroups/{nodeGroup}/deleteNodes", + "httpMethod": "POST", + "id": "compute.nodeGroups.deleteNodes", + "parameterOrder": [ + "project", + "zone", + "nodeGroup" ], - "enum": [ - "AFTER_CLASSIC_FIREWALL", - "BEFORE_CLASSIC_FIREWALL" + "parameters": { + "nodeGroup": { + "description": "Name of the NodeGroup resource whose nodes will be deleted.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/nodeGroups/{nodeGroup}/deleteNodes", + "request": { + "$ref": "NodeGroupsDeleteNodesRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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" - }, - "networkProfile": { - "description": "A full or partial URL of the network profile to apply to this network. This field can be set only at resource creation time. For example, the following are valid URLs: - https://www.googleapis.com/compute/{api_version}/projects/{project_id}/global/networkProfiles/{network_profile_name} - projects/{project_id}/global/networkProfiles/{network_profile_name} ", - "type": "string" - }, - "params": { - "description": "Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload.", - "$ref": "NetworkParams" - } - } - }, - "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." + "get": { + "description": "Returns the specified NodeGroup. Get a list of available NodeGroups\nby making a list() request.\nNote: the \"nodes\" field should not be used. Use nodeGroups.listNodes\ninstead.", + "flatPath": "projects/{project}/zones/{zone}/nodeGroups/{nodeGroup}", + "httpMethod": "GET", + "id": "compute.nodeGroups.get", + "parameterOrder": [ + "project", + "zone", + "nodeGroup" ], - "enum": [ - "ACTIVE", - "INACTIVE" + "parameters": { + "nodeGroup": { + "description": "Name of the node group to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/nodeGroups/{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" ] }, - "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": "[Output Only] Maximum Transmission Unit in bytes of the peer network.", - "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." + "getIamPolicy": { + "description": "Gets the access control policy for a resource. May be empty if no such\npolicy or resource exists.", + "flatPath": "projects/{project}/zones/{zone}/nodeGroups/{resource}/getIamPolicy", + "httpMethod": "GET", + "id": "compute.nodeGroups.getIamPolicy", + "parameterOrder": [ + "project", + "zone", + "resource" ], - "enum": [ - "IPV4_IPV6", - "IPV4_ONLY" + "parameters": { + "optionsRequestedPolicyVersion": { + "description": "Requested IAM Policy version.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/nodeGroups/{resource}/getIamPolicy", + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] - } - } - }, - "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": [ - "", - "" + }, + "insert": { + "description": "Creates a NodeGroup resource in the specified project using the data\nincluded in the request.", + "flatPath": "projects/{project}/zones/{zone}/nodeGroups", + "httpMethod": "POST", + "id": "compute.nodeGroups.insert", + "parameterOrder": [ + "project", + "zone", + "initialNodeCount" ], - "enum": [ - "GLOBAL", - "REGIONAL" + "parameters": { + "initialNodeCount": { + "description": "Initial count of nodes in the node group.", + "format": "int32", + "location": "query", + "required": true, + "type": "integer" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/nodeGroups", + "request": { + "$ref": "NodeGroup" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "bgpBestPathSelectionMode": { - "description": "The BGP best path selection algorithm to be employed within this network for dynamic routes learned by Cloud Routers. Can be LEGACY (default) or STANDARD.", - "type": "string", - "enumDescriptions": [ - "", - "" + "list": { + "description": "Retrieves a list of node groups available to the specified project.\nNote: use nodeGroups.listNodes for more details about each group.", + "flatPath": "projects/{project}/zones/{zone}/nodeGroups", + "httpMethod": "GET", + "id": "compute.nodeGroups.list", + "parameterOrder": [ + "project", + "zone" ], - "enum": [ - "LEGACY", - "STANDARD" + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/nodeGroups", + "response": { + "$ref": "NodeGroupList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "bgpAlwaysCompareMed": { - "description": "Enable comparison of Multi-Exit Discriminators (MED) across routes with different neighbor ASNs when using the STANDARD BGP best path selection algorithm.", - "type": "boolean" - }, - "bgpInterRegionCost": { - "description": "Allows to define a preferred approach for handling inter-region cost in the selection process when using the STANDARD BGP best path selection algorithm. Can be DEFAULT or ADD_COST_TO_MED.", - "type": "string", - "enumDescriptions": [ - "", - "" + "listNodes": { + "description": "Lists nodes in the node group.", + "flatPath": "projects/{project}/zones/{zone}/nodeGroups/{nodeGroup}/listNodes", + "httpMethod": "POST", + "id": "compute.nodeGroups.listNodes", + "parameterOrder": [ + "project", + "zone", + "nodeGroup" ], - "enum": [ - "ADD_COST_TO_MED", - "DEFAULT" + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "nodeGroup": { + "description": "Name of the NodeGroup resource whose nodes you want to list.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/nodeGroups/{nodeGroup}/listNodes", + "response": { + "$ref": "NodeGroupsListNodes" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "effectiveBgpAlwaysCompareMed": { - "description": "[Output Only] Effective value of the bgp_always_compare_med field.", - "type": "boolean" - }, - "effectiveBgpInterRegionCost": { - "description": "[Output Only] Effective value of the bgp_inter_region_cost field.", - "type": "string", - "enumDescriptions": [ - "", - "" + "patch": { + "description": "Updates the specified node group.", + "flatPath": "projects/{project}/zones/{zone}/nodeGroups/{nodeGroup}", + "httpMethod": "PATCH", + "id": "compute.nodeGroups.patch", + "parameterOrder": [ + "project", + "zone", + "nodeGroup" ], - "enum": [ - "ADD_COST_TO_MED", - "DEFAULT" - ] - } - } - }, - "NetworkParams": { - "id": "NetworkParams", - "description": "Additional network parameters.", - "type": "object", - "properties": { - "resourceManagerTags": { - "description": "Tag keys/values directly bound to this resource. Tag keys and values have the same definition as resource manager tags. The field is allowed for INSERT only. The keys/values to set on the resource should be specified in either ID { : } or Namespaced format { : }. For example the following are valid inputs: * {\"tagKeys/333\" : \"tagValues/444\", \"tagKeys/123\" : \"tagValues/456\"} * {\"123/environment\" : \"production\", \"345/abc\" : \"xyz\"} Note: * Invalid combinations of ID & namespaced format is not supported. For instance: {\"123/environment\" : \"tagValues/444\"} is invalid.", - "type": "object", - "additionalProperties": { - "type": "string" - } - } - } - }, - "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" - ] + "parameters": { + "nodeGroup": { + "description": "Name of the NodeGroup resource to update.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } }, - "type": "string" - }, - "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" - }, - "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" + "path": "projects/{project}/zones/{zone}/nodeGroups/{nodeGroup}", + "request": { + "$ref": "NodeGroup" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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": [ - "", - "", - "", - "" + "performMaintenance": { + "description": "Perform maintenance on a subset of nodes in the node group.", + "flatPath": "projects/{project}/zones/{zone}/nodeGroups/{nodeGroup}/performMaintenance", + "httpMethod": "POST", + "id": "compute.nodeGroups.performMaintenance", + "parameterOrder": [ + "project", + "zone", + "nodeGroup" ], - "enum": [ - "HIERARCHY", - "NETWORK", - "SYSTEM", - "UNSPECIFIED" + "parameters": { + "nodeGroup": { + "description": "Name of the node group scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/nodeGroups/{nodeGroup}/performMaintenance", + "request": { + "$ref": "NodeGroupsPerformMaintenanceRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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" - } - }, - "packetMirroringRules": { - "description": "[Output Only] The packet mirroring 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" - }, - "items": { - "description": "A list of ExchangedPeeringRoute resources.", - "type": "array", - "items": { - "$ref": "ExchangedPeeringRoute" - } + "setIamPolicy": { + "description": "Sets the access control policy on the specified resource.\nReplaces any existing policy.", + "flatPath": "projects/{project}/zones/{zone}/nodeGroups/{resource}/setIamPolicy", + "httpMethod": "POST", + "id": "compute.nodeGroups.setIamPolicy", + "parameterOrder": [ + "project", + "zone", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/nodeGroups/{resource}/setIamPolicy", + "request": { + "$ref": "ZoneSetPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" + "setNodeTemplate": { + "description": "Updates the node template of the node group.", + "flatPath": "projects/{project}/zones/{zone}/nodeGroups/{nodeGroup}/setNodeTemplate", + "httpMethod": "POST", + "id": "compute.nodeGroups.setNodeTemplate", + "parameterOrder": [ + "project", + "zone", + "nodeGroup" + ], + "parameters": { + "nodeGroup": { + "description": "Name of the NodeGroup resource to update.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/nodeGroups/{nodeGroup}/setNodeTemplate", + "request": { + "$ref": "NodeGroupsSetNodeTemplateRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "simulateMaintenanceEvent": { + "description": "Simulates maintenance event on specified nodes from the node group.", + "flatPath": "projects/{project}/zones/{zone}/nodeGroups/{nodeGroup}/simulateMaintenanceEvent", + "httpMethod": "POST", + "id": "compute.nodeGroups.simulateMaintenanceEvent", + "parameterOrder": [ + "project", + "zone", + "nodeGroup" + ], + "parameters": { + "nodeGroup": { + "description": "Name of the NodeGroup resource whose nodes will go under maintenance\nsimulation.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/nodeGroups/{nodeGroup}/simulateMaintenanceEvent", + "request": { + "$ref": "NodeGroupsSimulateMaintenanceEventRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource.", + "flatPath": "projects/{project}/zones/{zone}/nodeGroups/{resource}/testIamPermissions", + "httpMethod": "POST", + "id": "compute.nodeGroups.testIamPermissions", + "parameterOrder": [ + "project", + "zone", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" } - } + }, + "path": "projects/{project}/zones/{zone}/nodeGroups/{resource}/testIamPermissions", + "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" + ] } } }, - "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." + "nodeTemplates": { + "methods": { + "aggregatedList": { + "description": "Retrieves an aggregated list of node templates.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", + "flatPath": "projects/{project}/aggregated/nodeTemplates", + "httpMethod": "GET", + "id": "compute.nodeTemplates.aggregatedList", + "parameterOrder": [ + "project" ], - "enum": [ - "DYNAMIC_PEERING_ROUTE", - "STATIC_PEERING_ROUTE", - "SUBNET_PEERING_ROUTE" + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region,\nglobal) should be included in the response. For new resource types added\nafter this field, the flag has no effect as new resource types will always\ninclude every visible scope for each scope type in response. For resource\ntypes which predate this field, if this flag is omitted or false, only\nscopes of the scope types where the resource type is expected to be found\nwill be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which\naggregated list request is invoked for subnetworks list-usable api.", + "format": "int64", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/aggregated/nodeTemplates", + "response": { + "$ref": "NodeTemplateAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "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" + "delete": { + "description": "Deletes the specified NodeTemplate resource.", + "flatPath": "projects/{project}/regions/{region}/nodeTemplates/{nodeTemplate}", + "httpMethod": "DELETE", + "id": "compute.nodeTemplates.delete", + "parameterOrder": [ + "project", + "region", + "nodeTemplate" + ], + "parameters": { + "nodeTemplate": { + "description": "Name of the NodeTemplate resource to delete.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/nodeTemplates/{nodeTemplate}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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" - }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "get": { + "description": "Returns the specified node template.", + "flatPath": "projects/{project}/regions/{region}/nodeTemplates/{nodeTemplate}", + "httpMethod": "GET", + "id": "compute.nodeTemplates.get", + "parameterOrder": [ + "project", + "region", + "nodeTemplate" + ], + "parameters": { + "nodeTemplate": { + "description": "Name of the node template to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "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" + }, + "path": "projects/{project}/regions/{region}/nodeTemplates/{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" + ] }, - "status": { - "type": "string", - "enumDescriptions": [ - "", - "", - "", - "" + "getIamPolicy": { + "description": "Gets the access control policy for a resource. May be empty if no such\npolicy or resource exists.", + "flatPath": "projects/{project}/regions/{region}/nodeTemplates/{resource}/getIamPolicy", + "httpMethod": "GET", + "id": "compute.nodeTemplates.getIamPolicy", + "parameterOrder": [ + "project", + "region", + "resource" ], - "enum": [ - "CREATING", - "DELETING", - "INVALID", - "READY" + "parameters": { + "optionsRequestedPolicyVersion": { + "description": "Requested IAM Policy version.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/nodeTemplates/{resource}/getIamPolicy", + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "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." + "insert": { + "description": "Creates a NodeTemplate resource in the specified project using the data\nincluded in the request.", + "flatPath": "projects/{project}/regions/{region}/nodeTemplates", + "httpMethod": "POST", + "id": "compute.nodeTemplates.insert", + "parameterOrder": [ + "project", + "region" ], - "enum": [ - "DEFAULT", - "MAINTENANCE_POLICY_UNSPECIFIED", - "MIGRATE_WITHIN_NODE_GROUP", - "RESTART_IN_PLACE" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/nodeTemplates", + "request": { + "$ref": "NodeTemplate" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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" + "list": { + "description": "Retrieves a list of node templates available to the specified\nproject.", + "flatPath": "projects/{project}/regions/{region}/nodeTemplates", + "httpMethod": "GET", + "id": "compute.nodeTemplates.list", + "parameterOrder": [ + "project", + "region" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/regions/{region}/nodeTemplates", + "response": { + "$ref": "NodeTemplateList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "shareSettings": { - "description": "Share-settings for the node group", - "$ref": "ShareSettings" + "setIamPolicy": { + "description": "Sets the access control policy on the specified resource.\nReplaces any existing policy.", + "flatPath": "projects/{project}/regions/{region}/nodeTemplates/{resource}/setIamPolicy", + "httpMethod": "POST", + "id": "compute.nodeTemplates.setIamPolicy", + "parameterOrder": [ + "project", + "region", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/nodeTemplates/{resource}/setIamPolicy", + "request": { + "$ref": "RegionSetPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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": { + "description": "Returns permissions that a caller has on the specified resource.", + "flatPath": "projects/{project}/regions/{region}/nodeTemplates/{resource}/testIamPermissions", + "httpMethod": "POST", + "id": "compute.nodeTemplates.testIamPermissions", + "parameterOrder": [ + "project", + "region", + "resource" ], - "enum": [ - "AS_NEEDED", - "RECURRENT" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/nodeTemplates/{resource}/testIamPermissions", + "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" ] } } }, - "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." + "nodeTypes": { + "methods": { + "aggregatedList": { + "description": "Retrieves an aggregated list of node types.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", + "flatPath": "projects/{project}/aggregated/nodeTypes", + "httpMethod": "GET", + "id": "compute.nodeTypes.aggregatedList", + "parameterOrder": [ + "project" ], - "enum": [ - "MODE_UNSPECIFIED", - "OFF", - "ON", - "ONLY_SCALE_OUT" + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region,\nglobal) should be included in the response. For new resource types added\nafter this field, the flag has no effect as new resource types will always\ninclude every visible scope for each scope type in response. For resource\ntypes which predate this field, if this flag is omitted or false, only\nscopes of the scope types where the resource type is expected to be found\nwill be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which\naggregated list request is invoked for subnetworks list-usable api.", + "format": "int64", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/aggregated/nodeTypes", + "response": { + "$ref": "NodeTypeAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "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" - } - } - }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "get": { + "description": "Returns the specified node type.", + "flatPath": "projects/{project}/zones/{zone}/nodeTypes/{nodeType}", + "httpMethod": "GET", + "id": "compute.nodeTypes.get", + "parameterOrder": [ + "project", + "zone", + "nodeType" + ], + "parameters": { + "nodeType": { + "description": "Name of the node type to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" } - } - }, - "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" - } + }, + "path": "projects/{project}/zones/{zone}/nodeTypes/{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" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "list": { + "description": "Retrieves a list of node types available to the specified\nproject.", + "flatPath": "projects/{project}/zones/{zone}/nodeTypes", + "httpMethod": "GET", + "id": "compute.nodeTypes.list", + "parameterOrder": [ + "project", + "zone" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`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" - } - } - } - } - } - } - } - }, - "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" - }, - "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" - }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "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\n`nextPageToken` returned by a previous list request to get\nthe 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.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" } - } + }, + "path": "projects/{project}/zones/{zone}/nodeTypes", + "response": { + "$ref": "NodeTypeList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] } } }, - "NodeGroupNode": { - "id": "NodeGroupNode", - "type": "object", - "properties": { - "name": { - "description": "The name of the node.", - "type": "string" - }, - "status": { - "type": "string", - "enumDescriptions": [ - "", - "", - "", - "", - "" + "organizationSecurityPolicies": { + "methods": { + "addAssociation": { + "description": "Inserts an association for the specified security policy.\n\nThis has billing implications. Projects in the hierarchy with effective\nhierarchical security policies will be automatically enrolled into Cloud\nArmor Enterprise if not already enrolled.\n\nUse this API to modify Cloud Armor policies. Previously, alpha and beta\nversions of this API were used to modify firewall policies. This usage is\nnow disabled for most organizations. Use firewallPolicies.addAssociation\ninstead.", + "flatPath": "locations/global/securityPolicies/{securityPolicy}/addAssociation", + "httpMethod": "POST", + "id": "compute.organizationSecurityPolicies.addAssociation", + "parameterOrder": [ + "securityPolicy" ], - "enum": [ - "CREATING", - "DELETING", - "INVALID", - "READY", - "REPAIRING" + "parameters": { + "replaceExistingAssociation": { + "description": "Indicates whether or not to replace it if an association of the attachment\nalready exists. This is false by default, in which case an error will be\nreturned if an association already exists.", + "location": "query", + "type": "boolean" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "securityPolicy": { + "description": "Name of the security policy to update.", + "location": "path", + "pattern": "(securityPolicies/)?[0-9]{0,20}", + "required": true, + "type": "string" + } + }, + "path": "locations/global/securityPolicies/{securityPolicy}/addAssociation", + "request": { + "$ref": "SecurityPolicyAssociation" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "nodeType": { - "description": "The type of this node.", - "type": "string" - }, - "serverBinding": { - "description": "Binding properties for the physical server.", - "$ref": "ServerBinding" + "addRule": { + "description": "Inserts a rule into a security policy.\n\nUse this API to modify Cloud Armor policies. Previously, alpha and beta\nversions of this API were used to modify firewall policies. This usage is\nnow disabled for most organizations. Use firewallPolicies.addRule instead.", + "flatPath": "locations/global/securityPolicies/{securityPolicy}/addRule", + "httpMethod": "POST", + "id": "compute.organizationSecurityPolicies.addRule", + "parameterOrder": [ + "securityPolicy" + ], + "parameters": { + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "securityPolicy": { + "description": "Name of the security policy to update.", + "location": "path", + "pattern": "(securityPolicies/)?[0-9]{0,20}", + "required": true, + "type": "string" + } + }, + "path": "locations/global/securityPolicies/{securityPolicy}/addRule", + "request": { + "$ref": "SecurityPolicyRule" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "serverId": { - "description": "Server ID associated with this node.", - "type": "string" + "copyRules": { + "description": "Copies rules to the specified security policy.\n\nUse this API to modify Cloud Armor policies. Previously, alpha and beta\nversions of this API were used to modify firewall policies. This usage is\nnow disabled for most organizations. Use firewallPolicies.cloneRules\ninstead.", + "flatPath": "locations/global/securityPolicies/{securityPolicy}/copyRules", + "httpMethod": "POST", + "id": "compute.organizationSecurityPolicies.copyRules", + "parameterOrder": [ + "securityPolicy" + ], + "parameters": { + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "securityPolicy": { + "description": "Name of the security policy to update.", + "location": "path", + "pattern": "(securityPolicies/)?[0-9]{0,20}", + "required": true, + "type": "string" + }, + "sourceSecurityPolicy": { + "description": "The security policy from which to copy rules.", + "location": "query", + "type": "string" + } + }, + "path": "locations/global/securityPolicies/{securityPolicy}/copyRules", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "disks": { - "description": "Local disk configurations.", - "type": "array", - "items": { - "$ref": "LocalDisk" - } + "delete": { + "description": "Deletes the specified policy.\n\nUse this API to remove Cloud Armor policies. Previously, alpha and beta\nversions of this API were used to remove firewall policies. This usage is\nnow disabled for most organizations. Use firewallPolicies.delete instead.", + "flatPath": "locations/global/securityPolicies/{securityPolicy}", + "httpMethod": "DELETE", + "id": "compute.organizationSecurityPolicies.delete", + "parameterOrder": [ + "securityPolicy" + ], + "parameters": { + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "securityPolicy": { + "description": "Name of the security policy to delete.", + "location": "path", + "pattern": "(securityPolicies/)?[0-9]{0,20}", + "required": true, + "type": "string" + } + }, + "path": "locations/global/securityPolicies/{securityPolicy}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "accelerators": { - "description": "Accelerators for this node.", - "type": "array", - "items": { - "$ref": "AcceleratorConfig" - } + "get": { + "description": "List all of the ordered rules present in a single specified policy.\n\nUse this API to read Cloud Armor policies. Previously, alpha and beta\nversions of this API were used to read firewall policies. This usage is now\ndisabled for most organizations. Use firewallPolicies.get instead.", + "flatPath": "locations/global/securityPolicies/{securityPolicy}", + "httpMethod": "GET", + "id": "compute.organizationSecurityPolicies.get", + "parameterOrder": [ + "securityPolicy" + ], + "parameters": { + "securityPolicy": { + "description": "Name of the security policy to get.", + "location": "path", + "pattern": "(securityPolicies/)?[0-9]{0,20}", + "required": true, + "type": "string" + } + }, + "path": "locations/global/securityPolicies/{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" + ] }, - "instances": { - "description": "Instances scheduled on this node.", - "type": "array", - "items": { - "type": "string" - } + "getAssociation": { + "description": "Gets an association with the specified name.\n\nUse this API to read Cloud Armor policies. Previously, alpha and beta\nversions of this API were used to read firewall policies. This usage is\nnow disabled for most organizations. Use firewallPolicies.getAssociation\ninstead.", + "flatPath": "locations/global/securityPolicies/{securityPolicy}/getAssociation", + "httpMethod": "GET", + "id": "compute.organizationSecurityPolicies.getAssociation", + "parameterOrder": [ + "securityPolicy" + ], + "parameters": { + "name": { + "description": "The name of the association to get from the security policy.", + "location": "query", + "type": "string" + }, + "securityPolicy": { + "description": "Name of the security policy to which the queried rule belongs.", + "location": "path", + "pattern": "(securityPolicies/)?[0-9]{0,20}", + "required": true, + "type": "string" + } + }, + "path": "locations/global/securityPolicies/{securityPolicy}/getAssociation", + "response": { + "$ref": "SecurityPolicyAssociation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "instanceConsumptionData": { - "description": "Instance data that shows consumed resources on the node.", - "type": "array", - "items": { - "$ref": "InstanceConsumptionData" - } + "getRule": { + "description": "Gets a rule at the specified priority.\n\nUse this API to read Cloud Armor policies. Previously, alpha and beta\nversions of this API were used to read firewall policies. This usage is now\ndisabled for most organizations. Use firewallPolicies.getRule instead.", + "flatPath": "locations/global/securityPolicies/{securityPolicy}/getRule", + "httpMethod": "GET", + "id": "compute.organizationSecurityPolicies.getRule", + "parameterOrder": [ + "securityPolicy" + ], + "parameters": { + "priority": { + "description": "The priority of the rule to get from the security policy.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "securityPolicy": { + "description": "Name of the security policy to which the queried rule belongs.", + "location": "path", + "pattern": "(securityPolicies/)?[0-9]{0,20}", + "required": true, + "type": "string" + } + }, + "path": "locations/global/securityPolicies/{securityPolicy}/getRule", + "response": { + "$ref": "SecurityPolicyRule" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "consumedResources": { - "description": "Node resources that are reserved by all instances.", - "$ref": "InstanceConsumptionInfo" + "insert": { + "description": "Creates a new policy in the specified organization using the data included\nin the request.\n\nUse this API to add Cloud Armor policies. Previously, alpha and beta\nversions of this API were used to add firewall policies. This usage is now\ndisabled for most organizations. Use firewallPolicies.insert instead.", + "flatPath": "locations/global/securityPolicies", + "httpMethod": "POST", + "id": "compute.organizationSecurityPolicies.insert", + "parameters": { + "parentId": { + "description": "Parent ID for this request. The ID can be either be \"folders/[FOLDER_ID]\"\nif the parent is a folder or \"organizations/[ORGANIZATION_ID]\" if the\nparent is an organization.", + "location": "query", + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "locations/global/securityPolicies", + "request": { + "$ref": "SecurityPolicy" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "totalResources": { - "description": "Total amount of available resources on the node.", - "$ref": "InstanceConsumptionInfo" + "list": { + "description": "List all the policies that have been configured for the specified\norganization.\n\nUse this API to read Cloud Armor policies. Previously, alpha and beta\nversions of this API were used to read firewall policies. This usage is now\ndisabled for most organizations. Use firewallPolicies.list instead.", + "flatPath": "locations/global/securityPolicies", + "httpMethod": "GET", + "id": "compute.organizationSecurityPolicies.list", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe 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\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "locations/global/securityPolicies", + "response": { + "$ref": "SecurityPolicyList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "cpuOvercommitType": { - "description": "CPU overcommit.", - "type": "string", - "enumDescriptions": [ - "", - "", - "" - ], - "enum": [ - "CPU_OVERCOMMIT_TYPE_UNSPECIFIED", - "ENABLED", - "NONE" + "listAssociations": { + "description": "Lists associations of a specified target, i.e., organization or folder.\n\nUse this API to read Cloud Armor policies. Previously, alpha and beta\nversions of this API were used to read firewall policies. This usage is\nnow disabled for most organizations. Use firewallPolicies.listAssociations\ninstead.", + "flatPath": "locations/global/securityPolicies/listAssociations", + "httpMethod": "GET", + "id": "compute.organizationSecurityPolicies.listAssociations", + "parameters": { + "targetResource": { + "description": "The target resource to list associations. It is an organization, or a\nfolder.", + "location": "query", + "type": "string" + } + }, + "path": "locations/global/securityPolicies/listAssociations", + "response": { + "$ref": "OrganizationSecurityPoliciesListAssociationsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "satisfiesPzs": { - "description": "[Output Only] Reserved for future use.", - "type": "boolean" + "listPreconfiguredExpressionSets": { + "description": "Gets the current list of preconfigured Web Application Firewall (WAF)\nexpressions.", + "flatPath": "locations/global/securityPolicies/listPreconfiguredExpressionSets", + "httpMethod": "GET", + "id": "compute.organizationSecurityPolicies.listPreconfiguredExpressionSets", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe 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\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "locations/global/securityPolicies/listPreconfiguredExpressionSets", + "response": { + "$ref": "SecurityPoliciesListPreconfiguredExpressionSetsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "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.", - "" + "move": { + "description": "Moves the specified security policy.\n\nUse this API to modify Cloud Armor policies. Previously, alpha and beta\nversions of this API were used to modify firewall policies. This usage is\nnow disabled for most organizations. Use firewallPolicies.move instead.", + "flatPath": "locations/global/securityPolicies/{securityPolicy}/move", + "httpMethod": "POST", + "id": "compute.organizationSecurityPolicies.move", + "parameterOrder": [ + "securityPolicy" ], - "enum": [ - "RESTART_NODE_ON_ANY_SERVER", - "RESTART_NODE_ON_MINIMAL_SERVERS", - "SERVER_BINDING_TYPE_UNSPECIFIED" + "parameters": { + "parentId": { + "description": "The new parent of the security policy.", + "location": "query", + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "securityPolicy": { + "description": "Name of the security policy to update.", + "location": "path", + "pattern": "(securityPolicies/)?[0-9]{0,20}", + "required": true, + "type": "string" + } + }, + "path": "locations/global/securityPolicies/{securityPolicy}/move", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] - } - } - }, - "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" + "patch": { + "description": "Patches the specified policy with the data included in the request.\n\nUse this API to modify Cloud Armor policies. Previously, alpha and beta\nversions of this API were used to modify firewall policies. This usage is\nnow disabled for most organizations. Use firewallPolicies.patch instead.", + "flatPath": "locations/global/securityPolicies/{securityPolicy}", + "httpMethod": "PATCH", + "id": "compute.organizationSecurityPolicies.patch", + "parameterOrder": [ + "securityPolicy" + ], + "parameters": { + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "securityPolicy": { + "description": "Name of the security policy to update.", + "location": "path", + "pattern": "(securityPolicies/)?[0-9]{0,20}", + "required": true, + "type": "string" + } + }, + "path": "locations/global/securityPolicies/{securityPolicy}", + "request": { + "$ref": "SecurityPolicy" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "guestCpus": { - "description": "The number of virtual CPUs that are available to the instance.", - "type": "integer", - "format": "int32" + "patchRule": { + "description": "Patches a rule at the specified priority.\n\nUse this API to modify Cloud Armor policies. Previously, alpha and beta\nversions of this API were used to modify firewall policies. This usage is\nnow disabled for most organizations. Use firewallPolicies.patchRule\ninstead.", + "flatPath": "locations/global/securityPolicies/{securityPolicy}/patchRule", + "httpMethod": "POST", + "id": "compute.organizationSecurityPolicies.patchRule", + "parameterOrder": [ + "securityPolicy" + ], + "parameters": { + "priority": { + "description": "The priority of the rule to patch.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "securityPolicy": { + "description": "Name of the security policy to update.", + "location": "path", + "pattern": "(securityPolicies/)?[0-9]{0,20}", + "required": true, + "type": "string" + } + }, + "path": "locations/global/securityPolicies/{securityPolicy}/patchRule", + "request": { + "$ref": "SecurityPolicyRule" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "memoryMb": { - "description": "The amount of physical memory available to the instance, defined in MiB.", - "type": "integer", - "format": "int32" + "removeAssociation": { + "description": "Removes an association for the specified security policy.\n\nUse this API to modify Cloud Armor policies. Previously, alpha and beta\nversions of this API were used to modify firewall policies. This usage is\nnow disabled for most organizations. Use firewallPolicies.removeAssociation\ninstead.", + "flatPath": "locations/global/securityPolicies/{securityPolicy}/removeAssociation", + "httpMethod": "POST", + "id": "compute.organizationSecurityPolicies.removeAssociation", + "parameterOrder": [ + "securityPolicy" + ], + "parameters": { + "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "securityPolicy": { + "description": "Name of the security policy to update.", + "location": "path", + "pattern": "(securityPolicies/)?[0-9]{0,20}", + "required": true, + "type": "string" + } + }, + "path": "locations/global/securityPolicies/{securityPolicy}/removeAssociation", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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" - } + "removeRule": { + "description": "Deletes a rule at the specified priority.\n\nUse this API to modify Cloud Armor policies. Previously, alpha and beta\nversions of this API were used to modify firewall policies. This usage is\nnow disabled for most organizations. Use firewallPolicies.removeRule\ninstead.", + "flatPath": "locations/global/securityPolicies/{securityPolicy}/removeRule", + "httpMethod": "POST", + "id": "compute.organizationSecurityPolicies.removeRule", + "parameterOrder": [ + "securityPolicy" + ], + "parameters": { + "priority": { + "description": "The priority of the rule to remove from the security policy.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "securityPolicy": { + "description": "Name of the security policy to update.", + "location": "path", + "pattern": "(securityPolicies/)?[0-9]{0,20}", + "required": true, + "type": "string" + } + }, + "path": "locations/global/securityPolicies/{securityPolicy}/removeRule", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] } } }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "packetMirrorings": { + "methods": { + "aggregatedList": { + "description": "Retrieves an aggregated list of packetMirrorings.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", + "flatPath": "projects/{project}/aggregated/packetMirrorings", + "httpMethod": "GET", + "id": "compute.packetMirrorings.aggregatedList", + "parameterOrder": [ + "project" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "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,\nglobal) should be included in the response. For new resource types added\nafter this field, the flag has no effect as new resource types will always\ninclude every visible scope for each scope type in response. For resource\ntypes which predate this field, if this flag is omitted or false, only\nscopes of the scope types where the resource type is expected to be found\nwill be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`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\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which\naggregated list request is invoked for subnetworks list-usable api.", + "format": "int64", + "location": "query", + "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" - } + }, + "path": "projects/{project}/aggregated/packetMirrorings", + "response": { + "$ref": "PacketMirroringAggregatedList" + }, + "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] 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." + "delete": { + "description": "Deletes the specified PacketMirroring resource.", + "flatPath": "projects/{project}/regions/{region}/packetMirrorings/{packetMirroring}", + "httpMethod": "DELETE", + "id": "compute.packetMirrorings.delete", + "parameterOrder": [ + "project", + "region", + "packetMirroring" ], - "enum": [ - "CREATING", - "DELETING", - "INVALID", - "READY" + "parameters": { + "packetMirroring": { + "description": "Name of the PacketMirroring resource to delete.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/packetMirrorings/{packetMirroring}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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" + "get": { + "description": "Returns the specified PacketMirroring resource.", + "flatPath": "projects/{project}/regions/{region}/packetMirrorings/{packetMirroring}", + "httpMethod": "GET", + "id": "compute.packetMirrorings.get", + "parameterOrder": [ + "project", + "region", + "packetMirroring" + ], + "parameters": { + "packetMirroring": { + "description": "Name of the PacketMirroring resource to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/packetMirrorings/{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" + ] }, - "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" + "insert": { + "description": "Creates a PacketMirroring resource in the specified project and region\nusing the data included in the request.", + "flatPath": "projects/{project}/regions/{region}/packetMirrorings", + "httpMethod": "POST", + "id": "compute.packetMirrorings.insert", + "parameterOrder": [ + "project", + "region" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/packetMirrorings", + "request": { + "$ref": "PacketMirroring" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "disks": { - "type": "array", - "items": { - "$ref": "LocalDisk" - } + "list": { + "description": "Retrieves a list of PacketMirroring resources available to the specified\nproject and region.", + "flatPath": "projects/{project}/regions/{region}/packetMirrorings", + "httpMethod": "GET", + "id": "compute.packetMirrorings.list", + "parameterOrder": [ + "project", + "region" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/regions/{region}/packetMirrorings", + "response": { + "$ref": "PacketMirroringList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "accelerators": { - "type": "array", - "items": { - "$ref": "AcceleratorConfig" - } + "patch": { + "description": "Patches the specified PacketMirroring resource with the data included in\nthe request. This method supportsPATCH\nsemantics and usesJSON merge\npatch format and processing rules.", + "flatPath": "projects/{project}/regions/{region}/packetMirrorings/{packetMirroring}", + "httpMethod": "PATCH", + "id": "compute.packetMirrorings.patch", + "parameterOrder": [ + "project", + "region", + "packetMirroring" + ], + "parameters": { + "packetMirroring": { + "description": "Name of the PacketMirroring resource to patch.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/packetMirrorings/{packetMirroring}", + "request": { + "$ref": "PacketMirroring" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "cpuOvercommitType": { - "description": "CPU overcommit.", - "type": "string", - "enumDescriptions": [ - "", - "", - "" + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource.", + "flatPath": "projects/{project}/regions/{region}/packetMirrorings/{resource}/testIamPermissions", + "httpMethod": "POST", + "id": "compute.packetMirrorings.testIamPermissions", + "parameterOrder": [ + "project", + "region", + "resource" ], - "enum": [ - "CPU_OVERCOMMIT_TYPE_UNSPECIFIED", - "ENABLED", - "NONE" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/packetMirrorings/{resource}/testIamPermissions", + "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" ] } } }, - "NodeTemplateNodeTypeFlexibility": { - "id": "NodeTemplateNodeTypeFlexibility", - "type": "object", - "properties": { - "cpus": { - "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" + "previewFeatures": { + "methods": { + "get": { + "description": "Returns the details of the given PreviewFeature.", + "flatPath": "projects/{project}/global/previewFeatures/{previewFeature}", + "httpMethod": "GET", + "id": "compute.previewFeatures.get", + "parameterOrder": [ + "project", + "previewFeature" + ], + "parameters": { + "previewFeature": { + "description": "Name of the PreviewFeature for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/previewFeatures/{previewFeature}", + "response": { + "$ref": "PreviewFeature" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "list": { + "description": "Returns the details of the given PreviewFeature.", + "flatPath": "projects/{project}/global/previewFeatures", + "httpMethod": "GET", + "id": "compute.previewFeatures.list", + "parameterOrder": [ + "project" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`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\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" } - } - }, - "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" - } + }, + "path": "projects/{project}/global/previewFeatures", + "response": { + "$ref": "PreviewFeatureList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "update": { + "description": "Patches the given PreviewFeature. This method is used to enable or disable\na PreviewFeature.", + "flatPath": "projects/{project}/global/previewFeatures/{previewFeature}", + "httpMethod": "PATCH", + "id": "compute.previewFeatures.update", + "parameterOrder": [ + "project", + "previewFeature" + ], + "parameters": { + "previewFeature": { + "description": "Name of the PreviewFeature for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" } - } + }, + "path": "projects/{project}/global/previewFeatures/{previewFeature}", + "request": { + "$ref": "PreviewFeature" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] } } }, - "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" + "projects": { + "methods": { + "disableXpnHost": { + "description": "Disable this project as a shared VPC host project.", + "flatPath": "projects/{project}/disableXpnHost", + "httpMethod": "POST", + "id": "compute.projects.disableXpnHost", + "parameterOrder": [ + "project" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/disableXpnHost", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" + "disableXpnResource": { + "description": "Disable a service resource (also known as service project) associated with\nthis host project.", + "flatPath": "projects/{project}/disableXpnResource", + "httpMethod": "POST", + "id": "compute.projects.disableXpnResource", + "parameterOrder": [ + "project" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/disableXpnResource", + "request": { + "$ref": "ProjectsDisableXpnResourceRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "items": { - "description": "A list of NodeType resources.", - "type": "array", - "items": { - "$ref": "NodeType" - } + "enableXpnHost": { + "description": "Enable this project as a shared VPC host project.", + "flatPath": "projects/{project}/enableXpnHost", + "httpMethod": "POST", + "id": "compute.projects.enableXpnHost", + "parameterOrder": [ + "project" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/enableXpnHost", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" + "enableXpnResource": { + "description": "Enable service resource (a.k.a service project) for a host project, so that\nsubnets in the host project can be used by instances in the service\nproject.", + "flatPath": "projects/{project}/enableXpnResource", + "httpMethod": "POST", + "id": "compute.projects.enableXpnResource", + "parameterOrder": [ + "project" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/enableXpnResource", + "request": { + "$ref": "ProjectsEnableXpnResourceRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "get": { + "description": "Returns the specified Project resource.\n\nTo decrease latency for this method, you can optionally omit any unneeded\ninformation from the response by using a field mask. This practice is\nespecially recommended for unused quota information (the `quotas` field).\nTo exclude one or more fields, set your request's `fields` query parameter\nto only include the fields you need. For example, to only include the `id`\nand `selfLink` fields, add the query parameter `?fields=id,selfLink` to\nyour request.", + "flatPath": "projects/{project}", + "httpMethod": "GET", + "id": "compute.projects.get", + "parameterOrder": [ + "project" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + } + }, + "path": "projects/{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" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "getXpnHost": { + "description": "Gets the shared VPC host project that this project links to. May be empty\nif no link exists.", + "flatPath": "projects/{project}/getXpnHost", + "httpMethod": "GET", + "id": "compute.projects.getXpnHost", + "parameterOrder": [ + "project" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/getXpnHost", + "response": { + "$ref": "Project" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "getXpnResources": { + "description": "Gets service resources (a.k.a service project) associated with this host\nproject.", + "flatPath": "projects/{project}/getXpnResources", + "httpMethod": "GET", + "id": "compute.projects.getXpnResources", + "parameterOrder": [ + "project" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`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\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" } - } - } - } - }, - "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" + }, + "path": "projects/{project}/getXpnResources", + "response": { + "$ref": "ProjectsGetXpnResources" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "guestCpus": { - "description": "[Output Only] The number of virtual CPUs that are available to the node type.", - "type": "integer", - "format": "int32" + "listXpnHosts": { + "description": "Lists all shared VPC host projects visible to the user in an organization.", + "flatPath": "projects/{project}/listXpnHosts", + "httpMethod": "POST", + "id": "compute.projects.listXpnHosts", + "parameterOrder": [ + "project" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/listXpnHosts", + "request": { + "$ref": "ProjectsListXpnHostsRequest" + }, + "response": { + "$ref": "XpnHostList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "memoryMb": { - "description": "[Output Only] The amount of physical memory available to the node type, defined in MB.", - "type": "integer", - "format": "int32" + "moveDisk": { + "deprecated": true, + "description": "Moves a persistent disk from one zone to another.\n*Note*: The moveDisk API will be deprecated on September 29, 2026.\n\nStarting September 29, 2025, you can't use the moveDisk API on new\nprojects. To move a disk to a different region or zone, follow the steps in\n[Change the location of a\ndisk](https://cloud.google.com/compute/docs/disks/migrate-to-hyperdisk#migrate-to-hd).\n\nProjects that already use the moveDisk API can continue usage until\nSeptember 29, 2026.\n\nStarting November 1, 2025, API responses will include a warning message in\nthe response body about the upcoming deprecation. You can skip the message\nto continue using the service without interruption.", + "flatPath": "projects/{project}/moveDisk", + "httpMethod": "POST", + "id": "compute.projects.moveDisk", + "parameterOrder": [ + "project" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/moveDisk", + "request": { + "$ref": "DiskMoveRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "localSsdGb": { - "description": "[Output Only] Local SSD available to the node type, defined in GB.", - "type": "integer", - "format": "int32" + "moveInstance": { + "deprecated": true, + "description": "Moves an instance and its attached persistent disks from one zone to\nanother.\n*Note*: Moving VMs or disks by using this method might\n cause unexpected behavior. For more information, see the [known\n issue](/compute/docs/troubleshooting/known-issues#moving_vms_or_disks_using_the_moveinstance_api_or_the_causes_unexpected_behavior).\n[Deprecated] This method is deprecated. See [moving instance across\nzones](/compute/docs/instances/moving-instance-across-zones) instead.", + "flatPath": "projects/{project}/moveInstance", + "httpMethod": "POST", + "id": "compute.projects.moveInstance", + "parameterOrder": [ + "project" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/moveInstance", + "request": { + "$ref": "InstanceMoveRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "deprecated": { - "description": "[Output Only] The deprecation status associated with this node type.", - "$ref": "DeprecationStatus" + "setCloudArmorTier": { + "description": "Sets the Cloud Armor tier of the project. To set ENTERPRISE or above the\nbilling account of the project must be subscribed to Cloud Armor\nEnterprise. See Subscribing\nto Cloud Armor Enterprise for more information.", + "flatPath": "projects/{project}/setCloudArmorTier", + "httpMethod": "POST", + "id": "compute.projects.setCloudArmorTier", + "parameterOrder": [ + "project" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/setCloudArmorTier", + "request": { + "$ref": "ProjectsSetCloudArmorTierRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "zone": { - "description": "[Output Only] The name of the zone where the node type resides, such as us-central1-a.", - "type": "string" + "setCommonInstanceMetadata": { + "description": "Sets metadata common to all instances within the specified project using\nthe data included in the request.", + "flatPath": "projects/{project}/setCommonInstanceMetadata", + "httpMethod": "POST", + "id": "compute.projects.setCommonInstanceMetadata", + "parameterOrder": [ + "project" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/setCommonInstanceMetadata", + "request": { + "$ref": "Metadata" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "selfLink": { - "description": "[Output Only] Server-defined URL for the resource.", - "type": "string" + "setDefaultNetworkTier": { + "description": "Sets the default network tier of the project. The default network tier is\nused when an address/forwardingRule/instance is created without specifying\nthe network tier field.", + "flatPath": "projects/{project}/setDefaultNetworkTier", + "httpMethod": "POST", + "id": "compute.projects.setDefaultNetworkTier", + "parameterOrder": [ + "project" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/setDefaultNetworkTier", + "request": { + "$ref": "ProjectsSetDefaultNetworkTierRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "maxVms": { - "description": "[Output Only] Maximum number of VMs that can be created for this node type.", - "type": "integer", - "format": "int32" + "setUsageExportBucket": { + "description": "Enables the usage export feature and sets theusage export bucket\nwhere reports are stored. If you provide an empty request body using this\nmethod, the usage export feature will be disabled.", + "flatPath": "projects/{project}/setUsageExportBucket", + "httpMethod": "POST", + "id": "compute.projects.setUsageExportBucket", + "parameterOrder": [ + "project" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/setUsageExportBucket", + "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" + ] } } }, - "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" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "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" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the 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": { + "announce": { + "description": "Announces the specified PublicAdvertisedPrefix", + "flatPath": "projects/{project}/global/publicAdvertisedPrefixes/{publicAdvertisedPrefix}/announce", + "httpMethod": "POST", + "id": "compute.publicAdvertisedPrefixes.announce", + "parameterOrder": [ + "project", + "publicAdvertisedPrefix" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/publicAdvertisedPrefixes/{publicAdvertisedPrefix}/announce", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "delete": { + "description": "Deletes the specified PublicAdvertisedPrefix", + "flatPath": "projects/{project}/global/publicAdvertisedPrefixes/{publicAdvertisedPrefix}", + "httpMethod": "DELETE", + "id": "compute.publicAdvertisedPrefixes.delete", + "parameterOrder": [ + "project", + "publicAdvertisedPrefix" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "publicAdvertisedPrefix": { + "description": "Name of the PublicAdvertisedPrefix resource to delete.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/publicAdvertisedPrefixes/{publicAdvertisedPrefix}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "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.", + "get": { + "description": "Returns the specified PublicAdvertisedPrefix resource.", + "flatPath": "projects/{project}/global/publicAdvertisedPrefixes/{publicAdvertisedPrefix}", + "httpMethod": "GET", + "id": "compute.publicAdvertisedPrefixes.get", + "parameterOrder": [ + "project", + "publicAdvertisedPrefix" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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 return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" } - } + }, + "path": "projects/{project}/global/publicAdvertisedPrefixes/{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" + ] }, - "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" - } + "insert": { + "description": "Creates a PublicAdvertisedPrefix in the specified project\nusing the parameters that are included in the request.", + "flatPath": "projects/{project}/global/publicAdvertisedPrefixes", + "httpMethod": "POST", + "id": "compute.publicAdvertisedPrefixes.insert", + "parameterOrder": [ + "project" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/publicAdvertisedPrefixes", + "request": { + "$ref": "PublicAdvertisedPrefix" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "list": { + "description": "Lists the PublicAdvertisedPrefixes for a project.", + "flatPath": "projects/{project}/global/publicAdvertisedPrefixes", + "httpMethod": "GET", + "id": "compute.publicAdvertisedPrefixes.list", + "parameterOrder": [ + "project" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`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\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" } - } - } - } - }, - "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" + }, + "path": "projects/{project}/global/publicAdvertisedPrefixes", + "response": { + "$ref": "PublicAdvertisedPrefixList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "patch": { + "description": "Patches the specified Router resource with the data included in the\nrequest. This method supportsPATCH\nsemantics and usesJSON merge\npatch format and processing rules.", + "flatPath": "projects/{project}/global/publicAdvertisedPrefixes/{publicAdvertisedPrefix}", + "httpMethod": "PATCH", + "id": "compute.publicAdvertisedPrefixes.patch", + "parameterOrder": [ + "project", + "publicAdvertisedPrefix" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "publicAdvertisedPrefix": { + "description": "Name of the PublicAdvertisedPrefix resource to patch.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/publicAdvertisedPrefixes/{publicAdvertisedPrefix}", + "request": { + "$ref": "PublicAdvertisedPrefix" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "withdraw": { + "description": "Withdraws the specified PublicAdvertisedPrefix", + "flatPath": "projects/{project}/global/publicAdvertisedPrefixes/{publicAdvertisedPrefix}/withdraw", + "httpMethod": "POST", + "id": "compute.publicAdvertisedPrefixes.withdraw", + "parameterOrder": [ + "project", + "publicAdvertisedPrefix" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" } - } + }, + "path": "projects/{project}/global/publicAdvertisedPrefixes/{publicAdvertisedPrefix}/withdraw", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] } } }, - "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" - ] + "publicDelegatedPrefixes": { + "methods": { + "aggregatedList": { + "description": "Lists all PublicDelegatedPrefix resources owned by the specific project\nacross all scopes.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", + "flatPath": "projects/{project}/aggregated/publicDelegatedPrefixes", + "httpMethod": "GET", + "id": "compute.publicDelegatedPrefixes.aggregatedList", + "parameterOrder": [ + "project" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region,\nglobal) should be included in the response. For new resource types added\nafter this field, the flag has no effect as new resource types will always\ninclude every visible scope for each scope type in response. For resource\ntypes which predate this field, if this flag is omitted or false, only\nscopes of the scope types where the resource type is expected to be found\nwill be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Name of the project scoping this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which\naggregated list request is invoked for subnetworks list-usable api.", + "format": "int64", + "location": "query", + "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 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" - ] + "path": "projects/{project}/aggregated/publicDelegatedPrefixes", + "response": { + "$ref": "PublicDelegatedPrefixAggregatedList" }, - "$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" + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "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": [ - "", - "" + "announce": { + "description": "Announces the specified PublicDelegatedPrefix in the given region.", + "flatPath": "projects/{project}/regions/{region}/publicDelegatedPrefixes/{publicDelegatedPrefix}/announce", + "httpMethod": "POST", + "id": "compute.publicDelegatedPrefixes.announce", + "parameterOrder": [ + "project", + "region", + "publicDelegatedPrefix" ], - "enum": [ - "FALSE", - "TRUE" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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 theregion where\nthe 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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/publicDelegatedPrefixes/{publicDelegatedPrefix}/announce", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] - } - } - }, - "PacketMirroringNetworkInfo": { - "id": "PacketMirroringNetworkInfo", - "type": "object", - "properties": { - "url": { - "description": "URL of the network resource.", - "type": "string" - }, - "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" - }, - "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" - } - }, - "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" - } - }, - "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." + "delete": { + "description": "Deletes the specified PublicDelegatedPrefix in the given region.", + "flatPath": "projects/{project}/regions/{region}/publicDelegatedPrefixes/{publicDelegatedPrefix}", + "httpMethod": "DELETE", + "id": "compute.publicDelegatedPrefixes.delete", + "parameterOrder": [ + "project", + "region", + "publicDelegatedPrefix" ], - "enum": [ - "BOTH", - "EGRESS", - "INGRESS" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "publicDelegatedPrefix": { + "description": "Name of the PublicDelegatedPrefix resource to delete.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region of this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/publicDelegatedPrefixes/{publicDelegatedPrefix}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] - } - } - }, - "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" - }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "get": { + "description": "Returns the specified PublicDelegatedPrefix resource in the given region.", + "flatPath": "projects/{project}/regions/{region}/publicDelegatedPrefixes/{publicDelegatedPrefix}", + "httpMethod": "GET", + "id": "compute.publicDelegatedPrefixes.get", + "parameterOrder": [ + "project", + "region", + "publicDelegatedPrefix" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "publicDelegatedPrefix": { + "description": "Name of the PublicDelegatedPrefix resource to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" } - } - } - } - }, - "PacketMirroringAggregatedList": { - "id": "PacketMirroringAggregatedList", - "description": "Contains a list of packetMirrorings.", - "type": "object", - "properties": { - "kind": { - "description": "Type of resource.", - "default": "compute#packetMirroringAggregatedList", - "type": "string" + }, + "path": "projects/{project}/regions/{region}/publicDelegatedPrefixes/{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" + ] }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" + "insert": { + "description": "Creates a PublicDelegatedPrefix in the specified project in the given\nregion using the parameters that are included in the request.", + "flatPath": "projects/{project}/regions/{region}/publicDelegatedPrefixes", + "httpMethod": "POST", + "id": "compute.publicDelegatedPrefixes.insert", + "parameterOrder": [ + "project", + "region" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region of this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/publicDelegatedPrefixes", + "request": { + "$ref": "PublicDelegatedPrefix" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "list": { + "description": "Lists the PublicDelegatedPrefixes for a project in the given region.", + "flatPath": "projects/{project}/regions/{region}/publicDelegatedPrefixes", + "httpMethod": "GET", + "id": "compute.publicDelegatedPrefixes.list", + "parameterOrder": [ + "project", + "region" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`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\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region of this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" } - } + }, + "path": "projects/{project}/regions/{region}/publicDelegatedPrefixes", + "response": { + "$ref": "PublicDelegatedPrefixList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "unreachables": { - "description": "[Output Only] Unreachable resources.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "PacketMirroringsScopedList": { - "id": "PacketMirroringsScopedList", - "type": "object", - "properties": { - "packetMirrorings": { - "description": "A list of packetMirrorings contained in this scope.", - "type": "array", - "items": { - "$ref": "PacketMirroring" - } + "patch": { + "description": "Patches the specified PublicDelegatedPrefix resource with the data included\nin the request. This method supportsPATCH\nsemantics and usesJSON merge\npatch format and processing rules.", + "flatPath": "projects/{project}/regions/{region}/publicDelegatedPrefixes/{publicDelegatedPrefix}", + "httpMethod": "PATCH", + "id": "compute.publicDelegatedPrefixes.patch", + "parameterOrder": [ + "project", + "region", + "publicDelegatedPrefix" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "publicDelegatedPrefix": { + "description": "Name of the PublicDelegatedPrefix resource to patch.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/publicDelegatedPrefixes/{publicDelegatedPrefix}", + "request": { + "$ref": "PublicDelegatedPrefix" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "withdraw": { + "description": "Withdraws the specified PublicDelegatedPrefix in the given region.", + "flatPath": "projects/{project}/regions/{region}/publicDelegatedPrefixes/{publicDelegatedPrefix}/withdraw", + "httpMethod": "POST", + "id": "compute.publicDelegatedPrefixes.withdraw", + "parameterOrder": [ + "project", + "region", + "publicDelegatedPrefix" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "publicDelegatedPrefix": { + "description": "The name of the public delegated 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" - } - } - } + "region": { + "description": "The name of theregion where\nthe 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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" } - } + }, + "path": "projects/{project}/regions/{region}/publicDelegatedPrefixes/{publicDelegatedPrefix}/withdraw", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] } } }, - "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": "An optional naming prefix for daily usage reports and the Google Cloud Storage bucket where they are stored.", - "$ref": "UsageExportLocation" - }, - "enabledFeatures": { - "description": "An optional list of 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": [ - "", - "" - ], - "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." + "regionAutoscalers": { + "methods": { + "delete": { + "description": "Deletes the specified autoscaler.", + "flatPath": "projects/{project}/regions/{region}/autoscalers/{autoscaler}", + "httpMethod": "DELETE", + "id": "compute.regionAutoscalers.delete", + "parameterOrder": [ + "project", + "region", + "autoscaler" ], - "enum": [ - "FIXED_STANDARD", - "PREMIUM", - "STANDARD", - "STANDARD_OVERRIDES_FIXED_STANDARD" + "parameters": { + "autoscaler": { + "description": "Name of the autoscaler to delete.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/autoscalers/{autoscaler}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "vmDnsSetting": { - "description": "[Output Only] Default internal DNS setting used by VMs running in this project.", - "type": "string", - "enumDescriptions": [ - "", - "", - "", - "" + "get": { + "description": "Returns the specified autoscaler.", + "flatPath": "projects/{project}/regions/{region}/autoscalers/{autoscaler}", + "httpMethod": "GET", + "id": "compute.regionAutoscalers.get", + "parameterOrder": [ + "project", + "region", + "autoscaler" ], - "enum": [ - "GLOBAL_DEFAULT", - "UNSPECIFIED_VM_DNS_SETTING", - "ZONAL_DEFAULT", - "ZONAL_ONLY" + "parameters": { + "autoscaler": { + "description": "Name of the autoscaler to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/autoscalers/{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" ] }, - "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": { + "description": "Creates an autoscaler in the specified project using\nthe data included in the request.", + "flatPath": "projects/{project}/regions/{region}/autoscalers", + "httpMethod": "POST", + "id": "compute.regionAutoscalers.insert", + "parameterOrder": [ + "project", + "region" ], - "enum": [ - "CA_ENTERPRISE_ANNUAL", - "CA_ENTERPRISE_PAYGO", - "CA_STANDARD" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/autoscalers", + "request": { + "$ref": "Autoscaler" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "list": { + "description": "Retrieves a list of autoscalers contained within\nthe specified region.", + "flatPath": "projects/{project}/regions/{region}/autoscalers", + "httpMethod": "GET", + "id": "compute.regionAutoscalers.list", + "parameterOrder": [ + "project", + "region" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/regions/{region}/autoscalers", + "response": { + "$ref": "RegionAutoscalerList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] + }, + "patch": { + "description": "Updates an autoscaler in the specified project using\nthe data included in the request. This method supportsPATCH\nsemantics and uses theJSON merge\npatch format and processing rules.", + "flatPath": "projects/{project}/regions/{region}/autoscalers", + "httpMethod": "PATCH", + "id": "compute.regionAutoscalers.patch", + "parameterOrder": [ + "project", + "region" + ], + "parameters": { + "autoscaler": { + "description": "Name of the autoscaler to patch.", + "location": "query", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/autoscalers", + "request": { + "$ref": "Autoscaler" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource.", + "flatPath": "projects/{project}/regions/{region}/autoscalers/{resource}/testIamPermissions", + "httpMethod": "POST", + "id": "compute.regionAutoscalers.testIamPermissions", + "parameterOrder": [ + "project", + "region", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/autoscalers/{resource}/testIamPermissions", + "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" + ] + }, + "update": { + "description": "Updates an autoscaler in the specified project using\nthe data included in the request.", + "flatPath": "projects/{project}/regions/{region}/autoscalers", + "httpMethod": "PUT", + "id": "compute.regionAutoscalers.update", + "parameterOrder": [ + "project", + "region" + ], + "parameters": { + "autoscaler": { + "description": "Name of the autoscaler to update.", + "location": "query", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/autoscalers", + "request": { + "$ref": "Autoscaler" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + } + } + }, + "regionBackendBuckets": { + "methods": { + "delete": { + "description": "Deletes the specified regional BackendBucket resource.", + "flatPath": "projects/{project}/regions/{region}/backendBuckets/{backendBucket}", + "httpMethod": "DELETE", + "id": "compute.regionBackendBuckets.delete", + "parameterOrder": [ + "project", + "region", + "backendBucket" + ], + "parameters": { + "backendBucket": { + "description": "Name of the BackendBucket resource to delete.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).\nend_interface: MixerMutationRequestBuilder", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/backendBuckets/{backendBucket}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "get": { + "description": "Returns the specified regional BackendBucket resource.", + "flatPath": "projects/{project}/regions/{region}/backendBuckets/{backendBucket}", + "httpMethod": "GET", + "id": "compute.regionBackendBuckets.get", + "parameterOrder": [ + "project", + "region", + "backendBucket" + ], + "parameters": { + "backendBucket": { + "description": "Name of the BackendBucket resource to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/backendBuckets/{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" + ] + }, + "getIamPolicy": { + "description": "Gets the access control policy for a resource. May be empty if no such\npolicy or resource exists.", + "flatPath": "projects/{project}/regions/{region}/backendBuckets/{resource}/getIamPolicy", + "httpMethod": "GET", + "id": "compute.regionBackendBuckets.getIamPolicy", + "parameterOrder": [ + "project", + "region", + "resource" + ], + "parameters": { + "optionsRequestedPolicyVersion": { + "description": "Requested IAM Policy version.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/backendBuckets/{resource}/getIamPolicy", + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] + }, + "insert": { + "description": "Creates a RegionBackendBucket in the specified project in the given scope\nusing the parameters that are included in the request.", + "flatPath": "projects/{project}/regions/{region}/backendBuckets", + "httpMethod": "POST", + "id": "compute.regionBackendBuckets.insert", + "parameterOrder": [ + "project", + "region" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region of this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/backendBuckets", + "request": { + "$ref": "BackendBucket" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "list": { + "description": "Retrieves the list of BackendBucket resources available to the specified\nproject in the given region.", + "flatPath": "projects/{project}/regions/{region}/backendBuckets", + "httpMethod": "GET", + "id": "compute.regionBackendBuckets.list", + "parameterOrder": [ + "project", + "region" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region of this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/regions/{region}/backendBuckets", + "response": { + "$ref": "BackendBucketList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] + }, + "listUsable": { + "description": "Retrieves a list of all usable backend buckets in the specified project in\nthe given region.", + "flatPath": "projects/{project}/regions/{region}/backendBuckets/listUsable", + "httpMethod": "GET", + "id": "compute.regionBackendBuckets.listUsable", + "parameterOrder": [ + "project", + "region" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.\nIt must be a string that meets the requirements in RFC1035.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/regions/{region}/backendBuckets/listUsable", + "response": { + "$ref": "BackendBucketListUsable" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] + }, + "patch": { + "description": "Updates the specified BackendBucket resource with the data included in the\nrequest. This method supportsPATCH\nsemantics and uses theJSON merge\npatch format and processing rules.", + "flatPath": "projects/{project}/regions/{region}/backendBuckets/{backendBucket}", + "httpMethod": "PATCH", + "id": "compute.regionBackendBuckets.patch", + "parameterOrder": [ + "project", + "region", + "backendBucket" + ], + "parameters": { + "backendBucket": { + "description": "Name of the BackendBucket resource to patch.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).\nend_interface: MixerMutationRequestBuilder", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/backendBuckets/{backendBucket}", + "request": { + "$ref": "BackendBucket" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "setIamPolicy": { + "description": "Sets the access control policy on the specified resource.\nReplaces any existing policy.", + "flatPath": "projects/{project}/regions/{region}/backendBuckets/{resource}/setIamPolicy", + "httpMethod": "POST", + "id": "compute.regionBackendBuckets.setIamPolicy", + "parameterOrder": [ + "project", + "region", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/backendBuckets/{resource}/setIamPolicy", + "request": { + "$ref": "RegionSetPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource.", + "flatPath": "projects/{project}/regions/{region}/backendBuckets/{resource}/testIamPermissions", + "httpMethod": "POST", + "id": "compute.regionBackendBuckets.testIamPermissions", + "parameterOrder": [ + "project", + "region", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/backendBuckets/{resource}/testIamPermissions", + "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" + ] + } + } + }, + "regionBackendServices": { + "methods": { + "delete": { + "description": "Deletes the specified regional BackendService resource.", + "flatPath": "projects/{project}/regions/{region}/backendServices/{backendService}", + "httpMethod": "DELETE", + "id": "compute.regionBackendServices.delete", + "parameterOrder": [ + "project", + "region", + "backendService" + ], + "parameters": { + "backendService": { + "description": "Name of the BackendService resource to delete.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/backendServices/{backendService}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "get": { + "description": "Returns the specified regional BackendService resource.", + "flatPath": "projects/{project}/regions/{region}/backendServices/{backendService}", + "httpMethod": "GET", + "id": "compute.regionBackendServices.get", + "parameterOrder": [ + "project", + "region", + "backendService" + ], + "parameters": { + "backendService": { + "description": "Name of the BackendService resource to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/backendServices/{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" + ] + }, + "getHealth": { + "description": "Gets the most recent health check results for this\nregional BackendService.", + "flatPath": "projects/{project}/regions/{region}/backendServices/{backendService}/getHealth", + "httpMethod": "POST", + "id": "compute.regionBackendServices.getHealth", + "parameterOrder": [ + "project", + "region", + "backendService" + ], + "parameters": { + "backendService": { + "description": "Name of the BackendService resource for which to get health.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/backendServices/{backendService}/getHealth", + "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" + ] + }, + "getIamPolicy": { + "description": "Gets the access control policy for a resource. May be empty if no such\npolicy or resource exists.", + "flatPath": "projects/{project}/regions/{region}/backendServices/{resource}/getIamPolicy", + "httpMethod": "GET", + "id": "compute.regionBackendServices.getIamPolicy", + "parameterOrder": [ + "project", + "region", + "resource" + ], + "parameters": { + "optionsRequestedPolicyVersion": { + "description": "Requested IAM Policy version.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/backendServices/{resource}/getIamPolicy", + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] + }, + "insert": { + "description": "Creates a regional BackendService resource in the specified project using\nthe data included in the request. For more information, see\nBackend services overview.", + "flatPath": "projects/{project}/regions/{region}/backendServices", + "httpMethod": "POST", + "id": "compute.regionBackendServices.insert", + "parameterOrder": [ + "project", + "region" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/backendServices", + "request": { + "$ref": "BackendService" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "list": { + "description": "Retrieves the list of regional BackendService resources available to the\nspecified project in the given region.", + "flatPath": "projects/{project}/regions/{region}/backendServices", + "httpMethod": "GET", + "id": "compute.regionBackendServices.list", + "parameterOrder": [ + "project", + "region" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/regions/{region}/backendServices", + "response": { + "$ref": "BackendServiceList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] + }, + "listUsable": { + "description": "Retrieves a list of all usable backend services for Application Load\nBalancers and Proxy Network Load Balancers in the specified project in the\ngiven region. Backend services for external and internal passthrough\nNetwork Load Balancers are not included in the response.", + "flatPath": "projects/{project}/regions/{region}/backendServices/listUsable", + "httpMethod": "GET", + "id": "compute.regionBackendServices.listUsable", + "parameterOrder": [ + "project", + "region" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.\nIt 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\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/regions/{region}/backendServices/listUsable", + "response": { + "$ref": "BackendServiceListUsable" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] + }, + "patch": { + "description": "Updates the specified regional BackendService resource with the data\nincluded in the request. For more information, see \nUnderstanding backend services This method\nsupports PATCH semantics and uses the JSON merge\npatch format and processing rules.", + "flatPath": "projects/{project}/regions/{region}/backendServices/{backendService}", + "httpMethod": "PATCH", + "id": "compute.regionBackendServices.patch", + "parameterOrder": [ + "project", + "region", + "backendService" + ], + "parameters": { + "backendService": { + "description": "Name of the BackendService resource to patch.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/backendServices/{backendService}", + "request": { + "$ref": "BackendService" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "setIamPolicy": { + "description": "Sets the access control policy on the specified resource.\nReplaces any existing policy.", + "flatPath": "projects/{project}/regions/{region}/backendServices/{resource}/setIamPolicy", + "httpMethod": "POST", + "id": "compute.regionBackendServices.setIamPolicy", + "parameterOrder": [ + "project", + "region", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/backendServices/{resource}/setIamPolicy", + "request": { + "$ref": "RegionSetPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "setSecurityPolicy": { + "description": "Sets the Google Cloud Armor security policy for the specified backend\nservice. For more information, seeGoogle\nCloud Armor Overview", + "flatPath": "projects/{project}/regions/{region}/backendServices/{backendService}/setSecurityPolicy", + "httpMethod": "POST", + "id": "compute.regionBackendServices.setSecurityPolicy", + "parameterOrder": [ + "project", + "region", + "backendService" + ], + "parameters": { + "backendService": { + "description": "Name of the BackendService resource to which the security policy should be\nset. The name should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/backendServices/{backendService}/setSecurityPolicy", + "request": { + "$ref": "SecurityPolicyReference" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource.", + "flatPath": "projects/{project}/regions/{region}/backendServices/{resource}/testIamPermissions", + "httpMethod": "POST", + "id": "compute.regionBackendServices.testIamPermissions", + "parameterOrder": [ + "project", + "region", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/backendServices/{resource}/testIamPermissions", + "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" + ] + }, + "update": { + "description": "Updates the specified regional BackendService resource with the data\nincluded in the request. For more information,\nsee \nBackend services overview.", + "flatPath": "projects/{project}/regions/{region}/backendServices/{backendService}", + "httpMethod": "PUT", + "id": "compute.regionBackendServices.update", + "parameterOrder": [ + "project", + "region", + "backendService" + ], + "parameters": { + "backendService": { + "description": "Name of the BackendService resource to update.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/backendServices/{backendService}", + "request": { + "$ref": "BackendService" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + } + } + }, + "regionCommitments": { + "methods": { + "aggregatedList": { + "description": "Retrieves an aggregated list of commitments by region.\n\nTo prevent failure, it is recommended that you set the\n`returnPartialSuccess` parameter to `true`.", + "flatPath": "projects/{project}/aggregated/commitments", + "httpMethod": "GET", + "id": "compute.regionCommitments.aggregatedList", + "parameterOrder": [ + "project" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region,\nglobal) should be included in the response. For new resource types added\nafter this field, the flag has no effect as new resource types will always\ninclude every visible scope for each scope type in response. For resource\ntypes which predate this field, if this flag is omitted or false, only\nscopes of the scope types where the resource type is expected to be found\nwill be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which\naggregated list request is invoked for subnetworks list-usable api.", + "format": "int64", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/aggregated/commitments", + "response": { + "$ref": "CommitmentAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] + }, + "get": { + "description": "Returns the specified commitment resource.", + "flatPath": "projects/{project}/regions/{region}/commitments/{commitment}", + "httpMethod": "GET", + "id": "compute.regionCommitments.get", + "parameterOrder": [ + "project", + "region", + "commitment" + ], + "parameters": { + "commitment": { + "description": "Name of the commitment to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/commitments/{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" + ] + }, + "insert": { + "description": "Creates a commitment in the specified project using the data\nincluded in the request.", + "flatPath": "projects/{project}/regions/{region}/commitments", + "httpMethod": "POST", + "id": "compute.regionCommitments.insert", + "parameterOrder": [ + "project", + "region" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/commitments", + "request": { + "$ref": "Commitment" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "list": { + "description": "Retrieves a list of commitments contained within\nthe specified region.", + "flatPath": "projects/{project}/regions/{region}/commitments", + "httpMethod": "GET", + "id": "compute.regionCommitments.list", + "parameterOrder": [ + "project", + "region" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/regions/{region}/commitments", + "response": { + "$ref": "CommitmentList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] + }, + "update": { + "description": "Updates the specified commitment with the data included in the request.\nUpdate is performed only on selected fields included as part of\nupdate-mask. Only the following fields can be updated: auto_renew and plan.", + "flatPath": "projects/{project}/regions/{region}/commitments/{commitment}", + "httpMethod": "PATCH", + "id": "compute.regionCommitments.update", + "parameterOrder": [ + "project", + "region", + "commitment" + ], + "parameters": { + "commitment": { + "description": "Name of the commitment that you want to update.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "paths": { + "location": "query", + "repeated": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "updateMask": { + "description": "update_mask indicates fields to be updated as part of this request.", + "format": "google-fieldmask", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/commitments/{commitment}", + "request": { + "$ref": "Commitment" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + } + } + }, + "regionCompositeHealthChecks": { + "methods": { + "aggregatedList": { + "description": "Retrieves the list of all CompositeHealthCheck resources (all\nregional) available to the specified project.\n\nTo prevent failure, it is recommended that you set the\n`returnPartialSuccess` parameter to `true`.", + "flatPath": "projects/{project}/aggregated/compositeHealthChecks", + "httpMethod": "GET", + "id": "compute.regionCompositeHealthChecks.aggregatedList", + "parameterOrder": [ + "project" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region,\nglobal) should be included in the response. For new resource types added\nafter this field, the flag has no effect as new resource types will always\ninclude every visible scope for each scope type in response. For resource\ntypes which predate this field, if this flag is omitted or false, only\nscopes of the scope types where the resource type is expected to be found\nwill be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Name of the project scoping this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which\naggregated list request is invoked for subnetworks list-usable api.", + "format": "int64", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/aggregated/compositeHealthChecks", + "response": { + "$ref": "CompositeHealthCheckAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] + }, + "delete": { + "description": "Deletes the specified CompositeHealthCheck in the given region", + "flatPath": "projects/{project}/regions/{region}/compositeHealthChecks/{compositeHealthCheck}", + "httpMethod": "DELETE", + "id": "compute.regionCompositeHealthChecks.delete", + "parameterOrder": [ + "project", + "region", + "compositeHealthCheck" + ], + "parameters": { + "compositeHealthCheck": { + "description": "Name of the CompositeHealthCheck resource to delete.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/compositeHealthChecks/{compositeHealthCheck}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "get": { + "description": "Returns the specified CompositeHealthCheck resource in the given region.", + "flatPath": "projects/{project}/regions/{region}/compositeHealthChecks/{compositeHealthCheck}", + "httpMethod": "GET", + "id": "compute.regionCompositeHealthChecks.get", + "parameterOrder": [ + "project", + "region", + "compositeHealthCheck" + ], + "parameters": { + "compositeHealthCheck": { + "description": "Name of the CompositeHealthCheck resource to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/compositeHealthChecks/{compositeHealthCheck}", + "response": { + "$ref": "CompositeHealthCheck" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] + }, + "getHealth": { + "description": "Gets the most recent health check results for this\nregional CompositeHealthCheck.", + "flatPath": "projects/{project}/regions/{region}/compositeHealthChecks/{compositeHealthCheck}/getHealth", + "httpMethod": "GET", + "id": "compute.regionCompositeHealthChecks.getHealth", + "parameterOrder": [ + "project", + "region", + "compositeHealthCheck" + ], + "parameters": { + "compositeHealthCheck": { + "description": "Name of the CompositeHealthCheck resource to get health for.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Name of the project scoping this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/compositeHealthChecks/{compositeHealthCheck}/getHealth", + "response": { + "$ref": "CompositeHealthCheckHealth" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] + }, + "insert": { + "description": "Create a CompositeHealthCheck in the specified project in the given region\nusing the parameters that are included in the request.", + "flatPath": "projects/{project}/regions/{region}/compositeHealthChecks", + "httpMethod": "POST", + "id": "compute.regionCompositeHealthChecks.insert", + "parameterOrder": [ + "project", + "region" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/compositeHealthChecks", + "request": { + "$ref": "CompositeHealthCheck" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "list": { + "description": "Lists the CompositeHealthChecks for a project in the given region.", + "flatPath": "projects/{project}/regions/{region}/compositeHealthChecks", + "httpMethod": "GET", + "id": "compute.regionCompositeHealthChecks.list", + "parameterOrder": [ + "project", + "region" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/regions/{region}/compositeHealthChecks", + "response": { + "$ref": "CompositeHealthCheckList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] + }, + "patch": { + "description": "Updates the specified regional CompositeHealthCheck resource\nwith the data included in the request. This method supportsPATCH\nsemantics and uses theJSON merge\npatch format and processing rules.", + "flatPath": "projects/{project}/regions/{region}/compositeHealthChecks/{compositeHealthCheck}", + "httpMethod": "PATCH", + "id": "compute.regionCompositeHealthChecks.patch", + "parameterOrder": [ + "project", + "region", + "compositeHealthCheck" + ], + "parameters": { + "compositeHealthCheck": { + "description": "Name of the CompositeHealthCheck to update. The name\nmust be 1-63 characters long, and comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/compositeHealthChecks/{compositeHealthCheck}", + "request": { + "$ref": "CompositeHealthCheck" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource.", + "flatPath": "projects/{project}/regions/{region}/compositeHealthChecks/{resource}/testIamPermissions", + "httpMethod": "POST", + "id": "compute.regionCompositeHealthChecks.testIamPermissions", + "parameterOrder": [ + "project", + "region", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/compositeHealthChecks/{resource}/testIamPermissions", + "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" + ] + } + } + }, + "regionDiskTypes": { + "methods": { + "get": { + "description": "Returns the specified regional disk type.", + "flatPath": "projects/{project}/regions/{region}/diskTypes/{diskType}", + "httpMethod": "GET", + "id": "compute.regionDiskTypes.get", + "parameterOrder": [ + "project", + "region", + "diskType" + ], + "parameters": { + "diskType": { + "description": "Name of the disk type to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/diskTypes/{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" + ] + }, + "list": { + "description": "Retrieves a list of regional disk types available to the specified project.", + "flatPath": "projects/{project}/regions/{region}/diskTypes", + "httpMethod": "GET", + "id": "compute.regionDiskTypes.list", + "parameterOrder": [ + "project", + "region" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/regions/{region}/diskTypes", + "response": { + "$ref": "RegionDiskTypeList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] + } + } + }, + "regionDisks": { + "methods": { + "addResourcePolicies": { + "description": "Adds existing resource policies to a regional disk. You can only add one\npolicy which will be applied to this disk for scheduling snapshot\ncreation.", + "flatPath": "projects/{project}/regions/{region}/disks/{disk}/addResourcePolicies", + "httpMethod": "POST", + "id": "compute.regionDisks.addResourcePolicies", + "parameterOrder": [ + "project", + "region", + "disk" + ], + "parameters": { + "disk": { + "description": "The disk name for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/disks/{disk}/addResourcePolicies", + "request": { + "$ref": "RegionDisksAddResourcePoliciesRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "bulkInsert": { + "description": "Bulk create a set of disks.", + "flatPath": "projects/{project}/regions/{region}/disks/bulkInsert", + "httpMethod": "POST", + "id": "compute.regionDisks.bulkInsert", + "parameterOrder": [ + "project", + "region" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/disks/bulkInsert", + "request": { + "$ref": "BulkInsertDiskResource" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "createSnapshot": { + "description": "Creates a snapshot of a specified persistent disk. For regular snapshot\ncreation, consider using snapshots.insert\ninstead, as that method supports more features, such as creating snapshots\nin a project different from the source disk project.", + "flatPath": "projects/{project}/regions/{region}/disks/{disk}/createSnapshot", + "httpMethod": "POST", + "id": "compute.regionDisks.createSnapshot", + "parameterOrder": [ + "project", + "region", + "disk" + ], + "parameters": { + "disk": { + "description": "Name of the regional persistent disk to snapshot.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/disks/{disk}/createSnapshot", + "request": { + "$ref": "Snapshot" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "delete": { + "description": "Deletes the specified regional persistent disk. Deleting a regional disk\nremoves all the replicas of its data permanently and is irreversible.\nHowever, deleting a disk does not delete anysnapshots\npreviously made from the disk. You must separatelydelete\nsnapshots.", + "flatPath": "projects/{project}/regions/{region}/disks/{disk}", + "httpMethod": "DELETE", + "id": "compute.regionDisks.delete", + "parameterOrder": [ + "project", + "region", + "disk" + ], + "parameters": { + "disk": { + "description": "Name of the regional persistent disk to delete.", + "location": "path", + "pattern": "\\S{1,66}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/disks/{disk}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "get": { + "description": "Returns a specified regional persistent disk.", + "flatPath": "projects/{project}/regions/{region}/disks/{disk}", + "httpMethod": "GET", + "id": "compute.regionDisks.get", + "parameterOrder": [ + "project", + "region", + "disk" + ], + "parameters": { + "disk": { + "description": "Name of the regional persistent disk to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/disks/{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" + ] + }, + "getIamPolicy": { + "description": "Gets the access control policy for a resource. May be empty if no such\npolicy or resource exists.", + "flatPath": "projects/{project}/regions/{region}/disks/{resource}/getIamPolicy", + "httpMethod": "GET", + "id": "compute.regionDisks.getIamPolicy", + "parameterOrder": [ + "project", + "region", + "resource" + ], + "parameters": { + "optionsRequestedPolicyVersion": { + "description": "Requested IAM Policy version.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/disks/{resource}/getIamPolicy", + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] + }, + "insert": { + "description": "Creates a persistent regional disk in the specified project using the data\nincluded in the request.", + "flatPath": "projects/{project}/regions/{region}/disks", + "httpMethod": "POST", + "id": "compute.regionDisks.insert", + "parameterOrder": [ + "project", + "region" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(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" + } + }, + "path": "projects/{project}/regions/{region}/disks", + "request": { + "$ref": "Disk" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "list": { + "description": "Retrieves the list of persistent disks contained within\nthe specified region.", + "flatPath": "projects/{project}/regions/{region}/disks", + "httpMethod": "GET", + "id": "compute.regionDisks.list", + "parameterOrder": [ + "project", + "region" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/regions/{region}/disks", + "response": { + "$ref": "DiskList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] + }, + "removeResourcePolicies": { + "description": "Removes resource policies from a regional disk.", + "flatPath": "projects/{project}/regions/{region}/disks/{disk}/removeResourcePolicies", + "httpMethod": "POST", + "id": "compute.regionDisks.removeResourcePolicies", + "parameterOrder": [ + "project", + "region", + "disk" + ], + "parameters": { + "disk": { + "description": "The disk name for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/disks/{disk}/removeResourcePolicies", + "request": { + "$ref": "RegionDisksRemoveResourcePoliciesRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "resize": { + "description": "Resizes the specified regional persistent disk.", + "flatPath": "projects/{project}/regions/{region}/disks/{disk}/resize", + "httpMethod": "POST", + "id": "compute.regionDisks.resize", + "parameterOrder": [ + "project", + "region", + "disk" + ], + "parameters": { + "disk": { + "description": "Name of the regional persistent disk.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "The project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/disks/{disk}/resize", + "request": { + "$ref": "RegionDisksResizeRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "setIamPolicy": { + "description": "Sets the access control policy on the specified resource.\nReplaces any existing policy.", + "flatPath": "projects/{project}/regions/{region}/disks/{resource}/setIamPolicy", + "httpMethod": "POST", + "id": "compute.regionDisks.setIamPolicy", + "parameterOrder": [ + "project", + "region", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/disks/{resource}/setIamPolicy", + "request": { + "$ref": "RegionSetPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "setLabels": { + "description": "Sets the labels on the target regional disk.", + "flatPath": "projects/{project}/regions/{region}/disks/{resource}/setLabels", + "httpMethod": "POST", + "id": "compute.regionDisks.setLabels", + "parameterOrder": [ + "project", + "region", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/disks/{resource}/setLabels", + "request": { + "$ref": "RegionSetLabelsRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "startAsyncReplication": { + "description": "Starts asynchronous replication.\nMust be invoked on the primary disk.", + "flatPath": "projects/{project}/regions/{region}/disks/{disk}/startAsyncReplication", + "httpMethod": "POST", + "id": "compute.regionDisks.startAsyncReplication", + "parameterOrder": [ + "project", + "region", + "disk" + ], + "parameters": { + "disk": { + "description": "The name of the persistent disk.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/disks/{disk}/startAsyncReplication", + "request": { + "$ref": "RegionDisksStartAsyncReplicationRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "stopAsyncReplication": { + "description": "Stops asynchronous replication.\nCan be invoked either on the primary or on the secondary disk.", + "flatPath": "projects/{project}/regions/{region}/disks/{disk}/stopAsyncReplication", + "httpMethod": "POST", + "id": "compute.regionDisks.stopAsyncReplication", + "parameterOrder": [ + "project", + "region", + "disk" + ], + "parameters": { + "disk": { + "description": "The name of the persistent disk.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/disks/{disk}/stopAsyncReplication", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "stopGroupAsyncReplication": { + "description": "Stops asynchronous replication for a consistency group of disks.\nCan be invoked either in the primary or secondary scope.", + "flatPath": "projects/{project}/regions/{region}/disks/stopGroupAsyncReplication", + "httpMethod": "POST", + "id": "compute.regionDisks.stopGroupAsyncReplication", + "parameterOrder": [ + "project", + "region" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request. This must be the region of the\nprimary or secondary disks in the consistency group.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/disks/stopGroupAsyncReplication", + "request": { + "$ref": "DisksStopGroupAsyncReplicationResource" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource.", + "flatPath": "projects/{project}/regions/{region}/disks/{resource}/testIamPermissions", + "httpMethod": "POST", + "id": "compute.regionDisks.testIamPermissions", + "parameterOrder": [ + "project", + "region", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/disks/{resource}/testIamPermissions", + "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" + ] + }, + "update": { + "description": "Update the specified disk with the data included in the request. Update is\nperformed only on selected fields included as part of update-mask.", + "flatPath": "projects/{project}/regions/{region}/disks/{disk}", + "httpMethod": "PATCH", + "id": "compute.regionDisks.update", + "parameterOrder": [ + "project", + "region", + "disk" + ], + "parameters": { + "disk": { + "description": "The disk name for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "paths": { + "location": "query", + "repeated": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "updateMask": { + "description": "update_mask indicates fields to be updated as part of this request.", + "format": "google-fieldmask", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/disks/{disk}", + "request": { + "$ref": "Disk" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "updateKmsKey": { + "description": "Rotates the customer-managed\nencryption key to the latest version for the specified persistent disk.", + "flatPath": "projects/{project}/regions/{region}/disks/{disk}/updateKmsKey", + "httpMethod": "POST", + "id": "compute.regionDisks.updateKmsKey", + "parameterOrder": [ + "project", + "region", + "disk" + ], + "parameters": { + "disk": { + "description": "Name of the Disk resource, should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/disks/{disk}/updateKmsKey", + "request": { + "$ref": "RegionDiskUpdateKmsKeyRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + } + } + }, + "regionHealthAggregationPolicies": { + "methods": { + "aggregatedList": { + "description": "Retrieves the list of all HealthAggregationPolicy resources,\nregional and global, available to the specified project.\n\nTo prevent failure, it is recommended that you set the\n`returnPartialSuccess` parameter to `true`.", + "flatPath": "projects/{project}/aggregated/healthAggregationPolicies", + "httpMethod": "GET", + "id": "compute.regionHealthAggregationPolicies.aggregatedList", + "parameterOrder": [ + "project" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region,\nglobal) should be included in the response. For new resource types added\nafter this field, the flag has no effect as new resource types will always\ninclude every visible scope for each scope type in response. For resource\ntypes which predate this field, if this flag is omitted or false, only\nscopes of the scope types where the resource type is expected to be found\nwill be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Name of the project scoping this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which\naggregated list request is invoked for subnetworks list-usable api.", + "format": "int64", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/aggregated/healthAggregationPolicies", + "response": { + "$ref": "HealthAggregationPolicyAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] + }, + "delete": { + "description": "Deletes the specified HealthAggregationPolicy in the given region.", + "flatPath": "projects/{project}/regions/{region}/healthAggregationPolicies/{healthAggregationPolicy}", + "httpMethod": "DELETE", + "id": "compute.regionHealthAggregationPolicies.delete", + "parameterOrder": [ + "project", + "region", + "healthAggregationPolicy" + ], + "parameters": { + "healthAggregationPolicy": { + "description": "Name of the HealthAggregationPolicy resource to delete.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/healthAggregationPolicies/{healthAggregationPolicy}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "get": { + "description": "Returns the specified HealthAggregationPolicy resource in the given region.", + "flatPath": "projects/{project}/regions/{region}/healthAggregationPolicies/{healthAggregationPolicy}", + "httpMethod": "GET", + "id": "compute.regionHealthAggregationPolicies.get", + "parameterOrder": [ + "project", + "region", + "healthAggregationPolicy" + ], + "parameters": { + "healthAggregationPolicy": { + "description": "Name of the HealthAggregationPolicy resource to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/healthAggregationPolicies/{healthAggregationPolicy}", + "response": { + "$ref": "HealthAggregationPolicy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] + }, + "insert": { + "description": "Create a HealthAggregationPolicy in the specified project in the given\nregion using the parameters that are included in the request.", + "flatPath": "projects/{project}/regions/{region}/healthAggregationPolicies", + "httpMethod": "POST", + "id": "compute.regionHealthAggregationPolicies.insert", + "parameterOrder": [ + "project", + "region" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/healthAggregationPolicies", + "request": { + "$ref": "HealthAggregationPolicy" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "list": { + "description": "Lists the HealthAggregationPolicies for a project in the given region.", + "flatPath": "projects/{project}/regions/{region}/healthAggregationPolicies", + "httpMethod": "GET", + "id": "compute.regionHealthAggregationPolicies.list", + "parameterOrder": [ + "project", + "region" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/regions/{region}/healthAggregationPolicies", + "response": { + "$ref": "HealthAggregationPolicyList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] + }, + "patch": { + "description": "Updates the specified regional HealthAggregationPolicy\nresource with the data included in the request. This method supportsPATCH\nsemantics and uses theJSON merge\npatch format and processing rules.", + "flatPath": "projects/{project}/regions/{region}/healthAggregationPolicies/{healthAggregationPolicy}", + "httpMethod": "PATCH", + "id": "compute.regionHealthAggregationPolicies.patch", + "parameterOrder": [ + "project", + "region", + "healthAggregationPolicy" + ], + "parameters": { + "healthAggregationPolicy": { + "description": "Name of the HealthAggregationPolicy to update. The name\nmust be 1-63 characters long, and comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/healthAggregationPolicies/{healthAggregationPolicy}", + "request": { + "$ref": "HealthAggregationPolicy" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource.", + "flatPath": "projects/{project}/regions/{region}/healthAggregationPolicies/{resource}/testIamPermissions", + "httpMethod": "POST", + "id": "compute.regionHealthAggregationPolicies.testIamPermissions", + "parameterOrder": [ + "project", + "region", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/healthAggregationPolicies/{resource}/testIamPermissions", + "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" ] } } }, - "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.", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "" + "regionHealthCheckServices": { + "methods": { + "aggregatedList": { + "description": "Retrieves the list of all HealthCheckService resources,\nregional and global, available to the specified project.\n\nTo prevent failure, it is recommended that you set the\n`returnPartialSuccess` parameter to `true`.", + "flatPath": "projects/{project}/aggregated/healthCheckServices", + "httpMethod": "GET", + "id": "compute.regionHealthCheckServices.aggregatedList", + "parameterOrder": [ + "project" ], - "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" + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region,\nglobal) should be included in the response. For new resource types added\nafter this field, the flag has no effect as new resource types will always\ninclude every visible scope for each scope type in response. For resource\ntypes which predate this field, if this flag is omitted or false, only\nscopes of the scope types where the resource type is expected to be found\nwill be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Name of the project scoping this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which\naggregated list request is invoked for subnetworks list-usable api.", + "format": "int64", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/aggregated/healthCheckServices", + "response": { + "$ref": "HealthCheckServiceAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] + }, + "delete": { + "description": "Deletes the specified regional HealthCheckService.", + "flatPath": "projects/{project}/regions/{region}/healthCheckServices/{healthCheckService}", + "httpMethod": "DELETE", + "id": "compute.regionHealthCheckServices.delete", + "parameterOrder": [ + "project", + "region", + "healthCheckService" + ], + "parameters": { + "healthCheckService": { + "description": "Name of the HealthCheckService to delete. The name\nmust be 1-63 characters long, and comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/healthCheckServices/{healthCheckService}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "get": { + "description": "Returns the specified regional HealthCheckService resource.", + "flatPath": "projects/{project}/regions/{region}/healthCheckServices/{healthCheckService}", + "httpMethod": "GET", + "id": "compute.regionHealthCheckServices.get", + "parameterOrder": [ + "project", + "region", + "healthCheckService" + ], + "parameters": { + "healthCheckService": { + "description": "Name of the HealthCheckService to update. The name\nmust be 1-63 characters long, and comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/healthCheckServices/{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" ] }, - "limit": { - "description": "[Output Only] Quota limit for this metric.", - "type": "number", - "format": "double" + "insert": { + "description": "Creates a regional HealthCheckService resource in the\nspecified project and region using the data included in the request.", + "flatPath": "projects/{project}/regions/{region}/healthCheckServices", + "httpMethod": "POST", + "id": "compute.regionHealthCheckServices.insert", + "parameterOrder": [ + "project", + "region" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/healthCheckServices", + "request": { + "$ref": "HealthCheckService" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "usage": { - "description": "[Output Only] Current usage of this metric.", - "type": "number", - "format": "double" + "list": { + "description": "Lists all the HealthCheckService resources that have been\nconfigured for the specified project in the given region.", + "flatPath": "projects/{project}/regions/{region}/healthCheckServices", + "httpMethod": "GET", + "id": "compute.regionHealthCheckServices.list", + "parameterOrder": [ + "project", + "region" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/regions/{region}/healthCheckServices", + "response": { + "$ref": "HealthCheckServicesList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "owner": { - "description": "[Output Only] Owning resource. This is the resource on which this quota is applied.", - "type": "string" + "patch": { + "description": "Updates the specified regional HealthCheckService resource\nwith the data included in the request. This method supportsPATCH\nsemantics and uses theJSON merge\npatch format and processing rules.", + "flatPath": "projects/{project}/regions/{region}/healthCheckServices/{healthCheckService}", + "httpMethod": "PATCH", + "id": "compute.regionHealthCheckServices.patch", + "parameterOrder": [ + "project", + "region", + "healthCheckService" + ], + "parameters": { + "healthCheckService": { + "description": "Name of the HealthCheckService to update. The name\nmust be 1-63 characters long, and comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/healthCheckServices/{healthCheckService}", + "request": { + "$ref": "HealthCheckService" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource.", + "flatPath": "projects/{project}/regions/{region}/healthCheckServices/{resource}/testIamPermissions", + "httpMethod": "POST", + "id": "compute.regionHealthCheckServices.testIamPermissions", + "parameterOrder": [ + "project", + "region", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/healthCheckServices/{resource}/testIamPermissions", + "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" + ] } } }, - "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" + "regionHealthChecks": { + "methods": { + "delete": { + "description": "Deletes the specified HealthCheck resource.", + "flatPath": "projects/{project}/regions/{region}/healthChecks/{healthCheck}", + "httpMethod": "DELETE", + "id": "compute.regionHealthChecks.delete", + "parameterOrder": [ + "project", + "region", + "healthCheck" + ], + "parameters": { + "healthCheck": { + "description": "Name of the HealthCheck resource to delete.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/healthChecks/{healthCheck}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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" + "get": { + "description": "Returns the specified HealthCheck resource.", + "flatPath": "projects/{project}/regions/{region}/healthChecks/{healthCheck}", + "httpMethod": "GET", + "id": "compute.regionHealthChecks.get", + "parameterOrder": [ + "project", + "region", + "healthCheck" + ], + "parameters": { + "healthCheck": { + "description": "Name of the HealthCheck resource to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/healthChecks/{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" + ] + }, + "insert": { + "description": "Creates a HealthCheck resource in the specified project using the data\nincluded in the request.", + "flatPath": "projects/{project}/regions/{region}/healthChecks", + "httpMethod": "POST", + "id": "compute.regionHealthChecks.insert", + "parameterOrder": [ + "project", + "region" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/healthChecks", + "request": { + "$ref": "HealthCheck" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "list": { + "description": "Retrieves the list of HealthCheck resources available to the specified\nproject.", + "flatPath": "projects/{project}/regions/{region}/healthChecks", + "httpMethod": "GET", + "id": "compute.regionHealthChecks.list", + "parameterOrder": [ + "project", + "region" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/regions/{region}/healthChecks", + "response": { + "$ref": "HealthCheckList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] + }, + "patch": { + "description": "Updates a HealthCheck resource in the specified project using the data\nincluded in the request. This method supportsPATCH\nsemantics and uses theJSON merge\npatch format and processing rules.", + "flatPath": "projects/{project}/regions/{region}/healthChecks/{healthCheck}", + "httpMethod": "PATCH", + "id": "compute.regionHealthChecks.patch", + "parameterOrder": [ + "project", + "region", + "healthCheck" + ], + "parameters": { + "healthCheck": { + "description": "Name of the HealthCheck resource to patch.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/healthChecks/{healthCheck}", + "request": { + "$ref": "HealthCheck" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource.", + "flatPath": "projects/{project}/regions/{region}/healthChecks/{resource}/testIamPermissions", + "httpMethod": "POST", + "id": "compute.regionHealthChecks.testIamPermissions", + "parameterOrder": [ + "project", + "region", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/healthChecks/{resource}/testIamPermissions", + "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" + ] + }, + "update": { + "description": "Updates a HealthCheck resource in the specified project using the data\nincluded in the request.", + "flatPath": "projects/{project}/regions/{region}/healthChecks/{healthCheck}", + "httpMethod": "PUT", + "id": "compute.regionHealthChecks.update", + "parameterOrder": [ + "project", + "region", + "healthCheck" + ], + "parameters": { + "healthCheck": { + "description": "Name of the HealthCheck resource to update.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/healthChecks/{healthCheck}", + "request": { + "$ref": "HealthCheck" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] } } }, - "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" + "regionHealthSources": { + "methods": { + "aggregatedList": { + "description": "Retrieves the list of all HealthSource resources (all\nregional) available to the specified project.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", + "flatPath": "projects/{project}/aggregated/healthSources", + "httpMethod": "GET", + "id": "compute.regionHealthSources.aggregatedList", + "parameterOrder": [ + "project" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region,\nglobal) should be included in the response. For new resource types added\nafter this field, the flag has no effect as new resource types will always\ninclude every visible scope for each scope type in response. For resource\ntypes which predate this field, if this flag is omitted or false, only\nscopes of the scope types where the resource type is expected to be found\nwill be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Name of the project scoping this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which\naggregated list request is invoked for subnetworks list-usable api.", + "format": "int64", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/aggregated/healthSources", + "response": { + "$ref": "HealthSourceAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "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" + "delete": { + "description": "Deletes the specified HealthSource in the given region", + "flatPath": "projects/{project}/regions/{region}/healthSources/{healthSource}", + "httpMethod": "DELETE", + "id": "compute.regionHealthSources.delete", + "parameterOrder": [ + "project", + "region", + "healthSource" + ], + "parameters": { + "healthSource": { + "description": "Name of the HealthSource resource to delete.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/healthSources/{healthSource}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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" + "get": { + "description": "Returns the specified HealthSource resource in the given region.", + "flatPath": "projects/{project}/regions/{region}/healthSources/{healthSource}", + "httpMethod": "GET", + "id": "compute.regionHealthSources.get", + "parameterOrder": [ + "project", + "region", + "healthSource" + ], + "parameters": { + "healthSource": { + "description": "Name of the HealthSource resource to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/healthSources/{healthSource}", + "response": { + "$ref": "HealthSource" + }, + "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] Unique identifier for the resource; defined by the server.", - "type": "string" + "getHealth": { + "description": "Gets the most recent health check results for this\nregional HealthSource.", + "flatPath": "projects/{project}/regions/{region}/healthSources/{healthSource}/getHealth", + "httpMethod": "GET", + "id": "compute.regionHealthSources.getHealth", + "parameterOrder": [ + "project", + "region", + "healthSource" + ], + "parameters": { + "healthSource": { + "description": "Name of the HealthSource resource to get health for.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Name of the project scoping this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/healthSources/{healthSource}/getHealth", + "response": { + "$ref": "HealthSourceHealth" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "items": { - "description": "[Output Only] A list of shared VPC host project URLs.", - "type": "array", - "items": { - "$ref": "Project" - } + "insert": { + "description": "Create a HealthSource in the specified project in the given region\nusing the parameters that are included in the request.", + "flatPath": "projects/{project}/regions/{region}/healthSources", + "httpMethod": "POST", + "id": "compute.regionHealthSources.insert", + "parameterOrder": [ + "project", + "region" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/healthSources", + "request": { + "$ref": "HealthSource" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" + "list": { + "description": "Lists the HealthSources for a project in the given region.", + "flatPath": "projects/{project}/regions/{region}/healthSources", + "httpMethod": "GET", + "id": "compute.regionHealthSources.list", + "parameterOrder": [ + "project", + "region" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/regions/{region}/healthSources", + "response": { + "$ref": "HealthSourceList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "patch": { + "description": "Updates the specified regional HealthSource resource\nwith the data included in the request. This method supportsPATCH\nsemantics and uses theJSON merge\npatch format and processing rules.", + "flatPath": "projects/{project}/regions/{region}/healthSources/{healthSource}", + "httpMethod": "PATCH", + "id": "compute.regionHealthSources.patch", + "parameterOrder": [ + "project", + "region", + "healthSource" + ], + "parameters": { + "healthSource": { + "description": "Name of the HealthSource to update. The name\nmust be 1-63 characters long, and comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/healthSources/{healthSource}", + "request": { + "$ref": "HealthSource" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource.", + "flatPath": "projects/{project}/regions/{region}/healthSources/{resource}/testIamPermissions", + "httpMethod": "POST", + "id": "compute.regionHealthSources.testIamPermissions", + "parameterOrder": [ + "project", + "region", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/healthSources/{resource}/testIamPermissions", + "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" + ] + } + } + }, + "regionInstanceGroupManagerResizeRequests": { + "methods": { + "cancel": { + "description": "Cancels the specified resize request.\nCancelled resize request no longer waits for the resources to be\nprovisioned. Cancel is only possible for requests that are in accepted\nstate.", + "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/resizeRequests/{resizeRequest}/cancel", + "httpMethod": "POST", + "id": "compute.regionInstanceGroupManagerResizeRequests.cancel", + "parameterOrder": [ + "project", + "region", + "instanceGroupManager", + "resizeRequest" + ], + "parameters": { + "instanceGroupManager": { + "description": "The name of the managed instance group.\nName should conform to RFC1035 or be a resource ID.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region\nscoping this request. Name 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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "resizeRequest": { + "description": "The name of the resize request to cancel.\nName should conform to RFC1035 or be a resource ID.", + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/resizeRequests/{resizeRequest}/cancel", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "delete": { + "description": "Deletes the specified, inactive resize request. Requests that are still\nactive cannot be deleted. Deleting request does not delete instances that\nwere provisioned previously.", + "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/resizeRequests/{resizeRequest}", + "httpMethod": "DELETE", + "id": "compute.regionInstanceGroupManagerResizeRequests.delete", + "parameterOrder": [ + "project", + "region", + "instanceGroupManager", + "resizeRequest" + ], + "parameters": { + "instanceGroupManager": { + "description": "The name of the managed instance group.\nName should conform to RFC1035 or be a resource ID.", + "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.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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\nscoping this request. Name 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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "resizeRequest": { + "description": "The name of the resize request to delete.\nName should conform to RFC1035 or be a resource ID.", + "location": "path", + "required": true, + "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": [ - "", - "" - ], - "enum": [ - "PROJECT", - "XPN_RESOURCE_TYPE_UNSPECIFIED" + }, + "path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/resizeRequests/{resizeRequest}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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": { + "description": "Returns all of the details about the specified resize request.", + "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/resizeRequests/{resizeRequest}", + "httpMethod": "GET", + "id": "compute.regionInstanceGroupManagerResizeRequests.get", + "parameterOrder": [ + "project", + "region", + "instanceGroupManager", + "resizeRequest" + ], + "parameters": { + "instanceGroupManager": { + "description": "The name of the managed instance group.\nName should conform to RFC1035 or be a resource ID.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region\nscoping this request. Name should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "resizeRequest": { + "description": "The name of the resize request.\nName should conform to RFC1035 or be a resource ID.", + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/resizeRequests/{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" + ] }, - "resources": { - "description": "Service resources (a.k.a service projects) attached to this project as their shared VPC host.", - "type": "array", - "items": { - "$ref": "XpnResourceId" - } + "insert": { + "description": "Creates a new Resize Request that starts provisioning VMs immediately\nor queues VM creation.", + "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/resizeRequests", + "httpMethod": "POST", + "id": "compute.regionInstanceGroupManagerResizeRequests.insert", + "parameterOrder": [ + "project", + "region", + "instanceGroupManager" + ], + "parameters": { + "instanceGroupManager": { + "description": "Name of the managed instance group to which the resize request is scoped.\nName should conform to RFC1035 or be a resource ID.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region\nscoping this request. Name 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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/resizeRequests", + "request": { + "$ref": "InstanceGroupManagerResizeRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the 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." + "list": { + "description": "Retrieves a list of Resize Requests that are contained in the\nmanaged instance group.", + "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/resizeRequests", + "httpMethod": "GET", + "id": "compute.regionInstanceGroupManagerResizeRequests.list", + "parameterOrder": [ + "project", + "region", + "instanceGroupManager" ], - "enum": [ - "FIXED_STANDARD", - "PREMIUM", - "STANDARD", - "STANDARD_OVERRIDES_FIXED_STANDARD" + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "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": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region\nscoping this request. Name should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/resizeRequests", + "response": { + "$ref": "RegionInstanceGroupManagerResizeRequestsListResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] } } }, - "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." + "regionInstanceGroupManagers": { + "methods": { + "abandonInstances": { + "description": "Flags the specified instances to be immediately removed from the managed\ninstance group. Abandoning an instance does not delete the\ninstance, but it does remove the instance from any target pools that are\napplied by the managed instance group. This method reduces thetargetSize of the managed instance group by the\nnumber of instances that you abandon. This operation is marked asDONE when the action is scheduled even if the instances have\nnot yet been removed from the group. You must separately verify the\nstatus of the abandoning action with thelistmanagedinstances\nmethod.\n\nIf the group is part of a backend\nservice that has enabled\nconnection draining, it can take up to 60 seconds after the connection\ndraining duration has elapsed before the VM instance is removed or deleted.\n\nYou can specify a maximum of 1000 instances with this method per request.", + "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/abandonInstances", + "httpMethod": "POST", + "id": "compute.regionInstanceGroupManagers.abandonInstances", + "parameterOrder": [ + "project", + "region", + "instanceGroupManager" ], - "enum": [ - "CA_ENTERPRISE_ANNUAL", - "CA_ENTERPRISE_PAYGO", - "CA_STANDARD" + "parameters": { + "instanceGroupManager": { + "description": "Name of the managed instance group.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/abandonInstances", + "request": { + "$ref": "RegionInstanceGroupManagersAbandonInstancesRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] - } - } - }, - "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" - }, - "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" + "applyUpdatesToInstances": { + "description": "Apply updates to selected instances the managed instance group.", + "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/applyUpdatesToInstances", + "httpMethod": "POST", + "id": "compute.regionInstanceGroupManagers.applyUpdatesToInstances", + "parameterOrder": [ + "project", + "region", + "instanceGroupManager" + ], + "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.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request, should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/applyUpdatesToInstances", + "request": { + "$ref": "RegionInstanceGroupManagersApplyUpdatesRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "createInstances": { + "description": "Creates instances with per-instance configurations in this regional managed\ninstance group. Instances are created using the current instance template.\nThe create instances operation is marked DONE if\nthe createInstances request is successful. The underlying\nactions take additional time. You must separately verify the status of thecreating or actions with the listmanagedinstances\nmethod.", + "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/createInstances", + "httpMethod": "POST", + "id": "compute.regionInstanceGroupManagers.createInstances", + "parameterOrder": [ + "project", + "region", + "instanceGroupManager" + ], + "parameters": { + "instanceGroupManager": { + "description": "The name of the managed instance group.\nIt should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of theregion\nwhere the managed instance group is located.\nIt 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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/createInstances", + "request": { + "$ref": "RegionInstanceGroupManagersCreateInstancesRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "delete": { + "description": "Deletes the specified managed instance group and all of the instances\nin that group.", + "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}", + "httpMethod": "DELETE", + "id": "compute.regionInstanceGroupManagers.delete", + "parameterOrder": [ + "project", + "region", + "instanceGroupManager" + ], + "parameters": { + "instanceGroupManager": { + "description": "Name of the managed instance group to delete.", + "location": "path", + "required": true, + "type": "string" + }, + "noGracefulShutdown": { + "default": "false", + "description": "When set, graceful shutdown is skipped for instance deletion even if it's\nconfigured for the instances.", + "location": "query", + "type": "boolean" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "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" + "path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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." + "deleteInstances": { + "description": "Flags the specified instances in the managed instance group to be\nimmediately deleted. The instances are also removed from any target\npools of which they were a member. This method reduces thetargetSize of the managed instance group by the number of\ninstances that you delete.\nThe deleteInstances operation is marked DONE if\nthe deleteInstances request is successful. The underlying\nactions take additional time. You must separately verify the status of thedeleting action with thelistmanagedinstances\nmethod.\n\nIf the group is part of a backend\nservice that has enabled\nconnection draining, it can take up to 60 seconds after the connection\ndraining duration has elapsed before the VM instance is removed or deleted.\n\nYou can specify a maximum of 1000 instances with this method per request.", + "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/deleteInstances", + "httpMethod": "POST", + "id": "compute.regionInstanceGroupManagers.deleteInstances", + "parameterOrder": [ + "project", + "region", + "instanceGroupManager" ], - "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" + "parameters": { + "instanceGroupManager": { + "description": "Name of the managed instance group.", + "location": "path", + "required": true, + "type": "string" + }, + "noGracefulShutdown": { + "default": "false", + "description": "When set, graceful shutdown is skipped for instance deletion even if it's\nconfigured for the instances.", + "location": "query", + "type": "boolean" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/deleteInstances", + "request": { + "$ref": "RegionInstanceGroupManagersDeleteInstancesRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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." + "deletePerInstanceConfigs": { + "description": "Deletes selected per-instance configurations for the managed instance\ngroup.", + "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/deletePerInstanceConfigs", + "httpMethod": "POST", + "id": "compute.regionInstanceGroupManagers.deletePerInstanceConfigs", + "parameterOrder": [ + "project", + "region", + "instanceGroupManager" ], - "enum": [ - "GLOBAL", - "GLOBAL_AND_REGIONAL", - "REGIONAL" + "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.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request, should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/deletePerInstanceConfigs", + "request": { + "$ref": "RegionInstanceGroupManagerDeleteInstanceConfigReq" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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." + "get": { + "description": "Returns all of the details about the specified managed instance group.", + "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}", + "httpMethod": "GET", + "id": "compute.regionInstanceGroupManagers.get", + "parameterOrder": [ + "project", + "region", + "instanceGroupManager" ], - "enum": [ - "V1", - "V2" + "parameters": { + "instanceGroupManager": { + "description": "Name of the managed instance group to return.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/instanceGroupManagers/{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" ] - } - } - }, - "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" - }, - "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" + "insert": { + "description": "Creates a managed instance group using the information that you specify\nin the request. After the group is created, instances in the group are\ncreated using the specified instance template.\nThis operation is marked as DONE when the group is created\neven if the instances in the group have not yet been created. You must\nseparately verify the status of the individual instances with thelistmanagedinstances\nmethod.\n\nA regional managed instance group can contain up to 2000 instances.", + "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers", + "httpMethod": "POST", + "id": "compute.regionInstanceGroupManagers.insert", + "parameterOrder": [ + "project", + "region" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/instanceGroupManagers", + "request": { + "$ref": "InstanceGroupManager" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "list": { + "description": "Retrieves the list of managed instance groups that are contained\nwithin the specified region.", + "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers", + "httpMethod": "GET", + "id": "compute.regionInstanceGroupManagers.list", + "parameterOrder": [ + "project", + "region" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/regions/{region}/instanceGroupManagers", + "response": { + "$ref": "RegionInstanceGroupManagerList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "listErrors": { + "description": "Lists all errors thrown by actions on instances for a given regional\nmanaged instance group. The filter andorderBy query parameters are not supported.", + "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/listErrors", + "httpMethod": "GET", + "id": "compute.regionInstanceGroupManagers.listErrors", + "parameterOrder": [ + "project", + "region", + "instanceGroupManager" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "instanceGroupManager": { + "description": "The name of the managed instance group.\nIt must be a string that meets the requirements in RFC1035, or an\nunsigned long integer: must match regexp pattern:\n(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?)|1-9{0,19}.", + "location": "path", + "required": true, + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.\nThis should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/listErrors", + "response": { + "$ref": "RegionInstanceGroupManagersListErrorsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] + }, + "listManagedInstances": { + "description": "Lists the instances in the managed instance group and instances that are\nscheduled to be created. The list includes any current actions\nthat the group has scheduled for its instances. The orderBy\nquery parameter is not supported. The `pageToken` query parameter is\nsupported only if the group's `listManagedInstancesResults` field is set\nto `PAGINATED`.", + "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/listManagedInstances", + "httpMethod": "POST", + "id": "compute.regionInstanceGroupManagers.listManagedInstances", + "parameterOrder": [ + "project", + "region", + "instanceGroupManager" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "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.", + "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": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith 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 announced and ready to use. - `DELETING` The public delegated prefix is being deprovsioned. ", - "type": "string", - "enumDescriptions": [ - "The public delegated prefix is announced and ready to use.", - "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." - ], - "enum": [ - "ANNOUNCED", - "ANNOUNCED_TO_GOOGLE", - "ANNOUNCED_TO_INTERNET", - "DELETING", - "INITIALIZING", - "READY_TO_ANNOUNCE" + "path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/listManagedInstances", + "response": { + "$ref": "RegionInstanceGroupManagersListInstancesResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "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.", - "The public delegated prefix is used for creating dual-mode subnetworks only. Such prefixes cannot set publicDelegatedSubPrefixes." + "listPerInstanceConfigs": { + "description": "Lists all of the per-instance configurations defined for the managed\ninstance group. The orderBy query parameter is not supported.", + "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/listPerInstanceConfigs", + "httpMethod": "POST", + "id": "compute.regionInstanceGroupManagers.listPerInstanceConfigs", + "parameterOrder": [ + "project", + "region", + "instanceGroupManager" ], - "enum": [ - "DELEGATION", - "EXTERNAL_IPV6_FORWARDING_RULE_CREATION", - "EXTERNAL_IPV6_SUBNETWORK_CREATION" + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "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": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/listPerInstanceConfigs", + "response": { + "$ref": "RegionInstanceGroupManagersListInstanceConfigsResp" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "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." + "patch": { + "description": "Updates a managed instance group using the information that you specify\nin the request.\nThis operation is marked as DONE when the group is patched\neven if the instances in the group are still in the process of being\npatched. You must separately verify the status of the individual instances\nwith the listmanagedinstances\nmethod. This method supportsPATCH\nsemantics and uses theJSON merge\npatch format and processing rules.\n\nIf you update your group to specify a new template or instance\nconfiguration, it's possible that your intended specification for each VM\nin the group is different from the current state of that VM. To learn how\nto apply an updated configuration to the VMs in a MIG, seeUpdating instances in\na MIG.", + "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}", + "httpMethod": "PATCH", + "id": "compute.regionInstanceGroupManagers.patch", + "parameterOrder": [ + "project", + "region", + "instanceGroupManager" ], - "enum": [ - "V1", - "V2" + "parameters": { + "instanceGroupManager": { + "description": "The name of the instance group manager.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}", + "request": { + "$ref": "InstanceGroupManager" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] - } - } - }, - "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": [ - "", - "" + "patchPerInstanceConfigs": { + "description": "Inserts or patches per-instance configurations for the managed instance\ngroup. perInstanceConfig.name serves as a key used to\ndistinguish whether to perform insert or patch.", + "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/patchPerInstanceConfigs", + "httpMethod": "POST", + "id": "compute.regionInstanceGroupManagers.patchPerInstanceConfigs", + "parameterOrder": [ + "project", + "region", + "instanceGroupManager" ], - "enum": [ - "ACTIVE", - "INACTIVE" + "parameters": { + "instanceGroupManager": { + "description": "The name of the managed instance group.\nIt should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/patchPerInstanceConfigs", + "request": { + "$ref": "RegionInstanceGroupManagerPatchInstanceConfigReq" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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.", - "The public delegated prefix is used for creating dual-mode subnetworks only. Such prefixes cannot set publicDelegatedSubPrefixes." + "recreateInstances": { + "description": "Flags the specified VM instances in the managed instance group to be\nimmediately recreated. Each instance is recreated using the group's current\nconfiguration. This operation is marked as DONE when the flag\nis set even if the instances have not yet been recreated. You must\nseparately verify the status of each instance by checking itscurrentAction field; for more information, see Checking\nthe status of managed instances.\n\nIf the group is part of a backend\nservice that has enabled\nconnection draining, it can take up to 60 seconds after the connection\ndraining duration has elapsed before the VM instance is removed or deleted.\n\nYou can specify a maximum of 1000 instances with this method per request.", + "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/recreateInstances", + "httpMethod": "POST", + "id": "compute.regionInstanceGroupManagers.recreateInstances", + "parameterOrder": [ + "project", + "region", + "instanceGroupManager" ], - "enum": [ - "DELEGATION", - "EXTERNAL_IPV6_FORWARDING_RULE_CREATION", - "EXTERNAL_IPV6_SUBNETWORK_CREATION" + "parameters": { + "instanceGroupManager": { + "description": "Name of the managed instance group.", + "location": "path", + "required": true, + "type": "string" + }, + "noGracefulShutdown": { + "default": "false", + "description": "When set, graceful shutdown is skipped for instance recreation even if it's\nconfigured for the instances.", + "location": "query", + "type": "boolean" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/recreateInstances", + "request": { + "$ref": "RegionInstanceGroupManagersRecreateRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "resize": { + "description": "Changes the intended size of the managed instance group. If you increase\nthe size, the group creates new instances using the current instance\ntemplate. If you decrease the size, the group deletes one or more\ninstances.\n\nThe resize operation is marked DONE if theresize request is successful. The underlying actions take\nadditional time. You must separately verify the status of thecreating or deleting actions with thelistmanagedinstances\nmethod.\n\nIf the group is part of a backend\nservice that has enabled\nconnection draining, it can take up to 60 seconds after the connection\ndraining duration has elapsed before the VM instance is removed or deleted.", + "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/resize", + "httpMethod": "POST", + "id": "compute.regionInstanceGroupManagers.resize", + "parameterOrder": [ + "project", + "region", + "instanceGroupManager", + "size" + ], + "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.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(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" - } - } - } + "size": { + "description": "Number of instances that should exist in this instance group\nmanager.", + "format": "int32", + "location": "query", + "minimum": "0", + "required": true, + "type": "integer" } - } - }, - "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" - } + }, + "path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/resize", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "resumeInstances": { + "description": "Flags the specified instances in the managed instance group to be\nresumed. This method increases thetargetSize and decreases the targetSuspendedSize\nof the managed instance group by the number of instances that you resume.\nThe resumeInstances operation is marked DONE if\nthe resumeInstances request is successful. The underlying\nactions take additional time. You must separately verify the status of theRESUMING action with thelistmanagedinstances\nmethod.\n\nIn this request, you can only specify instances that are suspended. For\nexample, if an instance was previously suspended using the suspendInstances\nmethod, it can be resumed using the resumeInstances method.\n\nIf a health check is attached to the managed instance group, the specified\ninstances will be verified as healthy after they are resumed.\n\nYou can specify a maximum of 1000 instances with this method per request.", + "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/resumeInstances", + "httpMethod": "POST", + "id": "compute.regionInstanceGroupManagers.resumeInstances", + "parameterOrder": [ + "project", + "region", + "instanceGroupManager" + ], + "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.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" } - } - } - } - }, - "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" + }, + "path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/resumeInstances", + "request": { + "$ref": "RegionInstanceGroupManagersResumeInstancesRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "setInstanceTemplate": { + "description": "Sets the instance template to use when creating new instances or recreating\ninstances in this group. Existing instances are not affected.", + "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/setInstanceTemplate", + "httpMethod": "POST", + "id": "compute.regionInstanceGroupManagers.setInstanceTemplate", + "parameterOrder": [ + "project", + "region", + "instanceGroupManager" + ], + "parameters": { + "instanceGroupManager": { + "description": "The 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.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" } - } - } - } - }, - "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" + }, + "path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/setInstanceTemplate", + "request": { + "$ref": "RegionInstanceGroupManagersSetTemplateRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "status": { - "description": "[Output Only] Status of the region, either UP or DOWN.", - "type": "string", - "enumDescriptions": [ - "", - "" + "setTargetPools": { + "description": "Modifies the target pools to which all new instances in this group are\nassigned. Existing instances in the group are not affected.", + "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/setTargetPools", + "httpMethod": "POST", + "id": "compute.regionInstanceGroupManagers.setTargetPools", + "parameterOrder": [ + "project", + "region", + "instanceGroupManager" ], - "enum": [ - "DOWN", - "UP" + "parameters": { + "instanceGroupManager": { + "description": "Name of the managed instance group.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/setTargetPools", + "request": { + "$ref": "RegionInstanceGroupManagersSetTargetPoolsRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "startInstances": { + "description": "Flags the specified instances in the managed instance group to be\nstarted. This method increases thetargetSize and decreases the targetStoppedSize\nof the managed instance group by the number of instances that you start.\nThe startInstances operation is marked DONE if\nthe startInstances request is successful. The underlying\nactions take additional time. You must separately verify the status of theSTARTING action with thelistmanagedinstances\nmethod.\n\nIn this request, you can only specify instances that are stopped. For\nexample, if an instance was previously stopped using the stopInstances\nmethod, it can be started using the startInstances method.\n\nIf a health check is attached to the managed instance group, the specified\ninstances will be verified as healthy after they are started.\n\nYou can specify a maximum of 1000 instances with this method per request.", + "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/startInstances", + "httpMethod": "POST", + "id": "compute.regionInstanceGroupManagers.startInstances", + "parameterOrder": [ + "project", + "region", + "instanceGroupManager" + ], + "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.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "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" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + }, + "path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/startInstances", + "request": { + "$ref": "RegionInstanceGroupManagersStartInstancesRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "stopInstances": { + "description": "Flags the specified instances in the managed instance group to be\nimmediately stopped. You can only specify instances that are running in\nthis request. This method reduces thetargetSize and increases the targetStoppedSize\nof the managed instance group by the number of instances that you stop.\nThe stopInstances operation is marked DONE if\nthe stopInstances request is successful. The underlying\nactions take additional time. You must separately verify the status of theSTOPPING action with thelistmanagedinstances\nmethod.\n\nIf the standbyPolicy.initialDelaySec field is set, the group\ndelays stopping the instances until initialDelaySec have\npassed from instance.creationTimestamp (that is, when the\ninstance was created). This delay gives your application time to\nset itself up and initialize on the instance. If more thaninitialDelaySec seconds have passed sinceinstance.creationTimestamp when this method is called, there\nwill be zero delay.\n\nIf the group is part of a backend\nservice that has enabled\nconnection draining, it can take up to 60 seconds after the connection\ndraining duration has elapsed before the VM instance is stopped.\n\nStopped instances can be started using the startInstances\nmethod.\n\nYou can specify a maximum of 1000 instances with this method per request.", + "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/stopInstances", + "httpMethod": "POST", + "id": "compute.regionInstanceGroupManagers.stopInstances", + "parameterOrder": [ + "project", + "region", + "instanceGroupManager" + ], + "parameters": { + "instanceGroupManager": { + "description": "The name of the managed instance group.", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "noGracefulShutdown": { + "default": "false", + "description": "When set, graceful shutdown is skipped for instance stopping even if it's\nconfigured for the instances.", + "location": "query", + "type": "boolean" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" } - } - } - } - }, - "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" + }, + "path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/stopInstances", + "request": { + "$ref": "RegionInstanceGroupManagersStopInstancesRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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." + "suspendInstances": { + "description": "Flags the specified instances in the managed instance group to be\nimmediately suspended. You can only specify instances that are running in\nthis request. This method reduces thetargetSize and increases the targetSuspendedSize\nof the managed instance group by the number of instances that you suspend.\nThe suspendInstances operation is marked DONE if\nthe suspendInstances request is successful. The underlying\nactions take additional time. You must separately verify the status of theSUSPENDING action with thelistmanagedinstances\nmethod.\n\nIf the standbyPolicy.initialDelaySec field is set, the group\ndelays suspension of the instances until initialDelaySec have\npassed from instance.creationTimestamp (that is, when the\ninstance was created). This delay gives your application time to\nset itself up and initialize on the instance. If more thaninitialDelaySec seconds have passed sinceinstance.creationTimestamp when this method is called, there\nwill be zero delay.\n\nIf the group is part of a backend\nservice that has enabled\nconnection draining, it can take up to 60 seconds after the connection\ndraining duration has elapsed before the VM instance is suspended.\n\nSuspended instances can be resumed using the resumeInstances\nmethod.\n\nYou can specify a maximum of 1000 instances with this method per request.", + "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/suspendInstances", + "httpMethod": "POST", + "id": "compute.regionInstanceGroupManagers.suspendInstances", + "parameterOrder": [ + "project", + "region", + "instanceGroupManager" ], - "enum": [ - "DISABLE_GOOGLE_ACCESS", - "ENABLE_BIDIRECTIONAL_ACCESS_TO_GOOGLE", - "ENABLE_OUTBOUND_VM_ACCESS_TO_GOOGLE" + "parameters": { + "instanceGroupManager": { + "description": "Name of the managed instance group.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/suspendInstances", + "request": { + "$ref": "RegionInstanceGroupManagersSuspendInstancesRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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": { - "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.", - "Subnetwork will be used for Migration from one peered VPC to another. (a transient state of subnetwork while migrating resources from one project to another).", - "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." + "updatePerInstanceConfigs": { + "description": "Inserts or updates per-instance configurations for the managed instance\ngroup. perInstanceConfig.name serves as a key used to\ndistinguish whether to perform insert or patch.", + "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/updatePerInstanceConfigs", + "httpMethod": "POST", + "id": "compute.regionInstanceGroupManagers.updatePerInstanceConfigs", + "parameterOrder": [ + "project", + "region", + "instanceGroupManager" ], - "enum": [ - "GLOBAL_MANAGED_PROXY", - "INTERNAL_HTTPS_LOAD_BALANCER", - "PEER_MIGRATION", - "PRIVATE", - "PRIVATE_NAT", - "PRIVATE_RFC_1918", - "PRIVATE_SERVICE_CONNECT", - "REGIONAL_MANAGED_PROXY" + "parameters": { + "instanceGroupManager": { + "description": "The name of the managed instance group.\nIt should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/updatePerInstanceConfigs", + "request": { + "$ref": "RegionInstanceGroupManagerUpdateInstanceConfigReq" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] - }, - "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." + } + } + }, + "regionInstanceGroups": { + "methods": { + "get": { + "description": "Returns the specified instance group resource.", + "flatPath": "projects/{project}/regions/{region}/instanceGroups/{instanceGroup}", + "httpMethod": "GET", + "id": "compute.regionInstanceGroups.get", + "parameterOrder": [ + "project", + "region", + "instanceGroup" ], - "enum": [ - "ACTIVE", - "BACKUP" + "parameters": { + "instanceGroup": { + "description": "Name of the instance group resource to return.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/instanceGroups/{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" ] }, - "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." + "list": { + "description": "Retrieves the list of instance group resources contained within\nthe specified region.", + "flatPath": "projects/{project}/regions/{region}/instanceGroups", + "httpMethod": "GET", + "id": "compute.regionInstanceGroups.list", + "parameterOrder": [ + "project", + "region" ], - "enum": [ - "DRAINING", - "READY" + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/regions/{region}/instanceGroups", + "response": { + "$ref": "RegionInstanceGroupList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "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." + "listInstances": { + "description": "Lists the instances in the specified instance group and displays\ninformation about the named ports. Depending on the specified options, this\nmethod can list all instances or only the instances that are running.\nThe orderBy query parameter is not supported.", + "flatPath": "projects/{project}/regions/{region}/instanceGroups/{instanceGroup}/listInstances", + "httpMethod": "POST", + "id": "compute.regionInstanceGroups.listInstances", + "parameterOrder": [ + "project", + "region", + "instanceGroup" ], - "enum": [ - "IPV4_IPV6", - "IPV4_ONLY", - "IPV6_ONLY" + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "instanceGroup": { + "description": "Name of the regional instance group for which we want to list the\ninstances.", + "location": "path", + "required": true, + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/regions/{region}/instanceGroups/{instanceGroup}/listInstances", + "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" ] }, - "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." + "setNamedPorts": { + "description": "Sets the named ports for the specified regional instance group.", + "flatPath": "projects/{project}/regions/{region}/instanceGroups/{instanceGroup}/setNamedPorts", + "httpMethod": "POST", + "id": "compute.regionInstanceGroups.setNamedPorts", + "parameterOrder": [ + "project", + "region", + "instanceGroup" ], - "enum": [ - "EXTERNAL", - "INTERNAL" + "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.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/instanceGroups/{instanceGroup}/setNamedPorts", + "request": { + "$ref": "RegionInstanceGroupsSetNamedPortsRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "ipCollection": { - "description": "Reference to the source of IP, like a PublicDelegatedPrefix (PDP) for BYOIP. The PDP must be a sub-PDP in EXTERNAL_IPV6_SUBNETWORK_CREATION mode. Use one of the following formats to specify a sub-PDP when creating a dual stack subnetwork with external access using BYOIP: - Full resource URL, as in https://www.googleapis.com/compute/v1/projects/projectId/regions/region /publicDelegatedPrefixes/sub-pdp-name - Partial URL, as in - projects/projectId/regions/region/publicDelegatedPrefixes/ sub-pdp-name - regions/region/publicDelegatedPrefixes/sub-pdp-name ", - "type": "string" - }, - "ipv6GceEndpoint": { - "description": "[Output Only] Possible endpoints of this subnetwork. It can be one of the following: - VM_ONLY: The subnetwork can be used for creating instances and IPv6 addresses with VM endpoint type. Such a subnetwork gets external IPv6 ranges from a public delegated prefix and cannot be used to create NetLb. - VM_AND_FR: The subnetwork can be used for creating both VM instances and Forwarding Rules. It can also be used to reserve IPv6 addresses with both VM and FR endpoint types. Such a subnetwork gets its IPv6 range from Google IP Pool directly. ", - "type": "string", - "enumDescriptions": [ - "", - "" + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource.", + "flatPath": "projects/{project}/regions/{region}/instanceGroups/{resource}/testIamPermissions", + "httpMethod": "POST", + "id": "compute.regionInstanceGroups.testIamPermissions", + "parameterOrder": [ + "project", + "region", + "resource" ], - "enum": [ - "VM_AND_FR", - "VM_ONLY" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/instanceGroups/{resource}/testIamPermissions", + "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" ] - }, - "params": { - "description": "Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload.", - "$ref": "SubnetworkParams" - }, - "systemReservedInternalIpv6Ranges": { - "description": "Output only. [Output Only] The array of internal IPv6 network ranges reserved from the subnetwork's internal IPv6 range for system use.", - "readOnly": true, - "type": "array", - "items": { - "type": "string" - } - }, - "systemReservedExternalIpv6Ranges": { - "description": "Output only. [Output Only] The array of external IPv6 network ranges reserved from the subnetwork's external IPv6 range for system use.", - "readOnly": true, - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "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": [ - "", - "", - "", - "", - "", - "" + "regionInstanceTemplates": { + "methods": { + "delete": { + "description": "Deletes the specified instance template. Deleting an instance template is\npermanent and cannot be undone.", + "flatPath": "projects/{project}/regions/{region}/instanceTemplates/{instanceTemplate}", + "httpMethod": "DELETE", + "id": "compute.regionInstanceTemplates.delete", + "parameterOrder": [ + "project", + "region", + "instanceTemplate" ], - "enum": [ - "INTERVAL_10_MIN", - "INTERVAL_15_MIN", - "INTERVAL_1_MIN", - "INTERVAL_30_SEC", - "INTERVAL_5_MIN", - "INTERVAL_5_SEC" + "parameters": { + "instanceTemplate": { + "description": "The name of the instance template to delete.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/instanceTemplates/{instanceTemplate}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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": [ - "", - "", - "" + "get": { + "description": "Returns the specified instance template.", + "flatPath": "projects/{project}/regions/{region}/instanceTemplates/{instanceTemplate}", + "httpMethod": "GET", + "id": "compute.regionInstanceTemplates.get", + "parameterOrder": [ + "project", + "region", + "instanceTemplate" ], - "enum": [ - "CUSTOM_METADATA", - "EXCLUDE_ALL_METADATA", - "INCLUDE_ALL_METADATA" + "parameters": { + "instanceTemplate": { + "description": "The name of the instance template.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/instanceTemplates/{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" ] }, - "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" - } + "insert": { + "description": "Creates an instance template in the specified project and region using the\nglobal instance template whose URL is included in the request.", + "flatPath": "projects/{project}/regions/{region}/instanceTemplates", + "httpMethod": "POST", + "id": "compute.regionInstanceTemplates.insert", + "parameterOrder": [ + "project", + "region" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/instanceTemplates", + "request": { + "$ref": "InstanceTemplate" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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" - } - } - }, - "SubnetworkParams": { - "id": "SubnetworkParams", - "description": "Additional subnetwork parameters.", - "type": "object", - "properties": { - "resourceManagerTags": { - "description": "Tag keys/values directly bound to this resource. Tag keys and values have the same definition as resource manager tags. The field is allowed for INSERT only. The keys/values to set on the resource should be specified in either ID { : } or Namespaced format { : }. For example the following are valid inputs: * {\"tagKeys/333\" : \"tagValues/444\", \"tagKeys/123\" : \"tagValues/456\"} * {\"123/environment\" : \"production\", \"345/abc\" : \"xyz\"} Note: * Invalid combinations of ID & namespaced format is not supported. For instance: {\"123/environment\" : \"tagValues/444\"} is invalid.", - "type": "object", - "additionalProperties": { - "type": "string" - } + "list": { + "description": "Retrieves a list of instance templates that are contained within the\nspecified project and region.", + "flatPath": "projects/{project}/regions/{region}/instanceTemplates", + "httpMethod": "GET", + "id": "compute.regionInstanceTemplates.list", + "parameterOrder": [ + "project", + "region" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the regions for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/regions/{region}/instanceTemplates", + "response": { + "$ref": "InstanceTemplateList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] } } }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "regionInstances": { + "methods": { + "bulkInsert": { + "description": "Creates multiple instances in a given region. Count specifies the number of\ninstances to create.", + "flatPath": "projects/{project}/regions/{region}/instances/bulkInsert", + "httpMethod": "POST", + "id": "compute.regionInstances.bulkInsert", + "parameterOrder": [ + "project", + "region" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" } - } - }, - "unreachables": { - "description": "[Output Only] Unreachable resources.", - "type": "array", - "items": { - "type": "string" - } + }, + "path": "projects/{project}/regions/{region}/instances/bulkInsert", + "request": { + "$ref": "BulkInsertInstanceResource" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] } } }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "regionInstantSnapshotGroups": { + "methods": { + "delete": { + "description": "deletes a Regional InstantSnapshotGroup resource", + "flatPath": "projects/{project}/regions/{region}/instantSnapshotGroups/{instantSnapshotGroup}", + "httpMethod": "DELETE", + "id": "compute.regionInstantSnapshotGroups.delete", + "parameterOrder": [ + "project", + "region", + "instantSnapshotGroup" + ], + "parameters": { + "instantSnapshotGroup": { + "description": "Name of the InstantSnapshotGroup resource to delete.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "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" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + }, + "path": "projects/{project}/regions/{region}/instantSnapshotGroups/{instantSnapshotGroup}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "get": { + "description": "returns the specified InstantSnapshotGroup resource in the specified\nregion.", + "flatPath": "projects/{project}/regions/{region}/instantSnapshotGroups/{instantSnapshotGroup}", + "httpMethod": "GET", + "id": "compute.regionInstantSnapshotGroups.get", + "parameterOrder": [ + "project", + "region", + "instantSnapshotGroup" + ], + "parameters": { + "instantSnapshotGroup": { + "description": "Name of the InstantSnapshotGroup resource to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" } - } - }, - "unreachables": { - "description": "[Output Only] Unreachable resources.", - "type": "array", - "items": { - "type": "string" - } - }, - "scopedWarnings": { - "description": "[Output Only] Informational warning messages for failures encountered from scopes.", - "type": "array", - "items": { - "$ref": "SubnetworksScopedWarning" - } - } - } - }, - "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" - } + }, + "path": "projects/{project}/regions/{region}/instantSnapshotGroups/{instantSnapshotGroup}", + "response": { + "$ref": "InstantSnapshotGroup" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "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." + "getIamPolicy": { + "description": "Gets the access control policy for a resource. May be empty if no such\npolicy or resource exists.", + "flatPath": "projects/{project}/regions/{region}/instantSnapshotGroups/{resource}/getIamPolicy", + "httpMethod": "GET", + "id": "compute.regionInstantSnapshotGroups.getIamPolicy", + "parameterOrder": [ + "project", + "region", + "resource" ], - "enum": [ - "IPV4_IPV6", - "IPV4_ONLY", - "IPV6_ONLY" + "parameters": { + "optionsRequestedPolicyVersion": { + "description": "Requested IAM Policy version.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/instantSnapshotGroups/{resource}/getIamPolicy", + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "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": { + "description": "creates a Regional InstantSnapshotGroup resource", + "flatPath": "projects/{project}/regions/{region}/instantSnapshotGroups", + "httpMethod": "POST", + "id": "compute.regionInstantSnapshotGroups.insert", + "parameterOrder": [ + "project", + "region" ], - "enum": [ - "EXTERNAL", - "INTERNAL" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "sourceConsistencyGroup": { + "description": "begin_interface: MixerMutationRequestBuilder", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/instantSnapshotGroups", + "request": { + "$ref": "InstantSnapshotGroup" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "purpose": { - "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.", - "Subnetwork will be used for Migration from one peered VPC to another. (a transient state of subnetwork while migrating resources from one project to another).", - "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." + "list": { + "description": "retrieves the list of InstantSnapshotGroup resources contained within\nthe specified region.", + "flatPath": "projects/{project}/regions/{region}/instantSnapshotGroups", + "httpMethod": "GET", + "id": "compute.regionInstantSnapshotGroups.list", + "parameterOrder": [ + "project", + "region" ], - "enum": [ - "GLOBAL_MANAGED_PROXY", - "INTERNAL_HTTPS_LOAD_BALANCER", - "PEER_MIGRATION", - "PRIVATE", - "PRIVATE_NAT", - "PRIVATE_RFC_1918", - "PRIVATE_SERVICE_CONNECT", - "REGIONAL_MANAGED_PROXY" + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/regions/{region}/instantSnapshotGroups", + "response": { + "$ref": "ListInstantSnapshotGroups" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "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." + "setIamPolicy": { + "description": "Sets the access control policy on the specified resource.\nReplaces any existing policy.", + "flatPath": "projects/{project}/regions/{region}/instantSnapshotGroups/{resource}/setIamPolicy", + "httpMethod": "POST", + "id": "compute.regionInstantSnapshotGroups.setIamPolicy", + "parameterOrder": [ + "project", + "region", + "resource" ], - "enum": [ - "ACTIVE", - "BACKUP" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/instantSnapshotGroups/{resource}/setIamPolicy", + "request": { + "$ref": "RegionSetPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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" - }, - "ipCidrRange": { - "description": "The range of IP addresses belonging to this subnetwork secondary range.", - "type": "string" - } - } - }, - "SubnetworksScopedWarning": { - "id": "SubnetworksScopedWarning", - "type": "object", - "properties": { - "scopeName": { - "description": "Name of the scope containing this set of Subnetworks.", - "type": "string" - }, - "warning": { - "description": "An informational warning about unreachable scope", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource.", + "flatPath": "projects/{project}/regions/{region}/instantSnapshotGroups/{resource}/testIamPermissions", + "httpMethod": "POST", + "id": "compute.regionInstantSnapshotGroups.testIamPermissions", + "parameterOrder": [ + "project", + "region", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "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" + }, + "path": "projects/{project}/regions/{region}/instantSnapshotGroups/{resource}/testIamPermissions", + "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" + ] } } }, - "NetworkProfilesListResponse": { - "id": "NetworkProfilesListResponse", - "description": "Contains a list of network profiles.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always compute#networkProfileList for network profiles.", - "default": "compute#networkProfileList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of NetworkProfile resources.", - "type": "array", - "items": { - "$ref": "NetworkProfile" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the 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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "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": { + "delete": { + "description": "Deletes the specified InstantSnapshot resource. Keep in mind that deleting\na single instantSnapshot might not necessarily delete all the data on that\ninstantSnapshot. If any data on the instantSnapshot that is marked for\ndeletion is needed for subsequent instantSnapshots, the data will be moved\nto the next corresponding instantSnapshot.\n\nFor more information, seeDeleting\ninstantSnapshots.", + "flatPath": "projects/{project}/regions/{region}/instantSnapshots/{instantSnapshot}", + "httpMethod": "DELETE", + "id": "compute.regionInstantSnapshots.delete", + "parameterOrder": [ + "project", + "region", + "instantSnapshot" + ], + "parameters": { + "instantSnapshot": { + "description": "Name of the InstantSnapshot resource to delete.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" } - } - }, - "etag": { - "type": "string" - }, - "unreachables": { - "description": "[Output Only] Unreachable resources. end_interface: MixerListResponseWithEtagBuilder", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "NetworkProfile": { - "id": "NetworkProfile", - "description": "NetworkProfile represents a Google managed network profile resource.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of the resource. Always compute#networkProfile for network profiles.", - "default": "compute#networkProfile", - "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" - }, - "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" + }, + "path": "projects/{project}/regions/{region}/instantSnapshots/{instantSnapshot}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "location": { - "description": "[Output Only] Location to which the network is restricted.", - "$ref": "NetworkProfileLocation" + "get": { + "description": "Returns the specified InstantSnapshot resource in the specified region.", + "flatPath": "projects/{project}/regions/{region}/instantSnapshots/{instantSnapshot}", + "httpMethod": "GET", + "id": "compute.regionInstantSnapshots.get", + "parameterOrder": [ + "project", + "region", + "instantSnapshot" + ], + "parameters": { + "instantSnapshot": { + "description": "Name of the InstantSnapshot resource to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/instantSnapshots/{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" + ] }, - "features": { - "description": "[Output Only] Features supported by the network.", - "$ref": "NetworkProfileNetworkFeatures" - } - } - }, - "NetworkProfileLocation": { - "id": "NetworkProfileLocation", - "type": "object", - "properties": { - "scope": { - "type": "string", - "enumDescriptions": [ - "", - "" + "getIamPolicy": { + "description": "Gets the access control policy for a resource. May be empty if no such\npolicy or resource exists.", + "flatPath": "projects/{project}/regions/{region}/instantSnapshots/{resource}/getIamPolicy", + "httpMethod": "GET", + "id": "compute.regionInstantSnapshots.getIamPolicy", + "parameterOrder": [ + "project", + "region", + "resource" ], - "enum": [ - "REGION", - "ZONE" + "parameters": { + "optionsRequestedPolicyVersion": { + "description": "Requested IAM Policy version.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/instantSnapshots/{resource}/getIamPolicy", + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "name": { - "type": "string" - } - } - }, - "NetworkProfileNetworkFeatures": { - "id": "NetworkProfileNetworkFeatures", - "type": "object", - "properties": { - "allowSameNetworkUnicast": { - "description": "Specifies whether unicast within the same network is allowed.", - "type": "string", - "enumDescriptions": [ - "", - "" + "insert": { + "description": "Creates an instant snapshot in the specified region.", + "flatPath": "projects/{project}/regions/{region}/instantSnapshots", + "httpMethod": "POST", + "id": "compute.regionInstantSnapshots.insert", + "parameterOrder": [ + "project", + "region" ], - "enum": [ - "SAME_NETWORK_UNICAST_ALLOWED", - "SAME_NETWORK_UNICAST_BLOCKED" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/instantSnapshots", + "request": { + "$ref": "InstantSnapshot" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "unicast": { - "description": "Specifies which type of unicast is supported.", - "type": "string", - "enumDescriptions": [ - "", - "" + "list": { + "description": "Retrieves the list of InstantSnapshot resources contained within\nthe specified region.", + "flatPath": "projects/{project}/regions/{region}/instantSnapshots", + "httpMethod": "GET", + "id": "compute.regionInstantSnapshots.list", + "parameterOrder": [ + "project", + "region" ], - "enum": [ - "UNICAST_SDN", - "UNICAST_ULL" + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/regions/{region}/instantSnapshots", + "response": { + "$ref": "InstantSnapshotList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "allowAutoModeSubnet": { - "description": "Specifies whether auto mode subnet creation is allowed.", - "type": "string", - "enumDescriptions": [ - "", - "" + "setIamPolicy": { + "description": "Sets the access control policy on the specified resource.\nReplaces any existing policy.", + "flatPath": "projects/{project}/regions/{region}/instantSnapshots/{resource}/setIamPolicy", + "httpMethod": "POST", + "id": "compute.regionInstantSnapshots.setIamPolicy", + "parameterOrder": [ + "project", + "region", + "resource" ], - "enum": [ - "AUTO_MODE_SUBNET_ALLOWED", - "AUTO_MODE_SUBNET_BLOCKED" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/instantSnapshots/{resource}/setIamPolicy", + "request": { + "$ref": "RegionSetPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "allowVpcPeering": { - "description": "Specifies whether VPC peering is allowed.", - "type": "string", - "enumDescriptions": [ - "", - "" + "setLabels": { + "description": "Sets the labels on a instantSnapshot in the given region. To learn more\nabout labels, read the Labeling\nResources documentation.", + "flatPath": "projects/{project}/regions/{region}/instantSnapshots/{resource}/setLabels", + "httpMethod": "POST", + "id": "compute.regionInstantSnapshots.setLabels", + "parameterOrder": [ + "project", + "region", + "resource" ], - "enum": [ - "VPC_PEERING_ALLOWED", - "VPC_PEERING_BLOCKED" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/instantSnapshots/{resource}/setLabels", + "request": { + "$ref": "RegionSetLabelsRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "allowMultiNicInSameNetwork": { - "description": "Specifies whether multi-nic in the same network is allowed.", - "type": "string", - "enumDescriptions": [ - "", - "" + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource.", + "flatPath": "projects/{project}/regions/{region}/instantSnapshots/{resource}/testIamPermissions", + "httpMethod": "POST", + "id": "compute.regionInstantSnapshots.testIamPermissions", + "parameterOrder": [ + "project", + "region", + "resource" ], - "enum": [ - "MULTI_NIC_IN_SAME_NETWORK_ALLOWED", - "MULTI_NIC_IN_SAME_NETWORK_BLOCKED" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/instantSnapshots/{resource}/testIamPermissions", + "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" ] - }, - "allowLoadBalancing": { - "description": "Specifies whether cloud load balancing is allowed.", - "type": "string", - "enumDescriptions": [ - "", - "" + } + } + }, + "regionNetworkEndpointGroups": { + "methods": { + "attachNetworkEndpoints": { + "description": "Attach a list of network endpoints to the specified network endpoint group.", + "flatPath": "projects/{project}/regions/{region}/networkEndpointGroups/{networkEndpointGroup}/attachNetworkEndpoints", + "httpMethod": "POST", + "id": "compute.regionNetworkEndpointGroups.attachNetworkEndpoints", + "parameterOrder": [ + "project", + "region", + "networkEndpointGroup" ], - "enum": [ - "LOAD_BALANCING_ALLOWED", - "LOAD_BALANCING_BLOCKED" + "parameters": { + "networkEndpointGroup": { + "description": "The name of the network endpoint group where you are attaching network\nendpoints to. It should comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region where\nyou want to create the network endpoint group. It should comply with\nRFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/networkEndpointGroups/{networkEndpointGroup}/attachNetworkEndpoints", + "request": { + "$ref": "RegionNetworkEndpointGroupsAttachEndpointsRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "allowStaticRoutes": { - "description": "Specifies whether static route creation is allowed.", - "type": "string", - "enumDescriptions": [ - "", - "" + "delete": { + "description": "Deletes the specified network endpoint group. Note that the NEG cannot be\ndeleted if it is configured as a backend of a backend service.", + "flatPath": "projects/{project}/regions/{region}/networkEndpointGroups/{networkEndpointGroup}", + "httpMethod": "DELETE", + "id": "compute.regionNetworkEndpointGroups.delete", + "parameterOrder": [ + "project", + "region", + "networkEndpointGroup" ], - "enum": [ - "STATIC_ROUTES_ALLOWED", - "STATIC_ROUTES_BLOCKED" + "parameters": { + "networkEndpointGroup": { + "description": "The name of the network endpoint group to delete. It should comply with\nRFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region where\nthe 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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/networkEndpointGroups/{networkEndpointGroup}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "allowPsc": { - "description": "Specifies whether PSC creation is allowed.", - "type": "string", - "enumDescriptions": [ - "", - "" + "detachNetworkEndpoints": { + "description": "Detach the network endpoint from the specified network endpoint group.", + "flatPath": "projects/{project}/regions/{region}/networkEndpointGroups/{networkEndpointGroup}/detachNetworkEndpoints", + "httpMethod": "POST", + "id": "compute.regionNetworkEndpointGroups.detachNetworkEndpoints", + "parameterOrder": [ + "project", + "region", + "networkEndpointGroup" ], - "enum": [ - "PSC_ALLOWED", - "PSC_BLOCKED" + "parameters": { + "networkEndpointGroup": { + "description": "The name of the network endpoint group you are detaching network\nendpoints from. It should comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region where\nthe network endpoint group is located. It should comply with\nRFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).\nend_interface: MixerMutationRequestBuilder", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/networkEndpointGroups/{networkEndpointGroup}/detachNetworkEndpoints", + "request": { + "$ref": "RegionNetworkEndpointGroupsDetachEndpointsRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "allowCloudRouter": { - "description": "Specifies whether cloud router creation is allowed.", - "type": "string", - "enumDescriptions": [ - "", - "" + "get": { + "description": "Returns the specified network endpoint group.", + "flatPath": "projects/{project}/regions/{region}/networkEndpointGroups/{networkEndpointGroup}", + "httpMethod": "GET", + "id": "compute.regionNetworkEndpointGroups.get", + "parameterOrder": [ + "project", + "region", + "networkEndpointGroup" ], - "enum": [ - "CLOUD_ROUTER_ALLOWED", - "CLOUD_ROUTER_BLOCKED" + "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.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region where\nthe network endpoint group is located. It should comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/networkEndpointGroups/{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" ] }, - "allowCloudNat": { - "description": "Specifies whether cloud NAT creation is allowed.", - "type": "string", - "enumDescriptions": [ - "", - "" + "insert": { + "description": "Creates a network endpoint group in the specified project using the\nparameters that are included in the request.\n\nNote: Use the following APIs to manage network endpoint groups:\n \n - \n To manage NEGs with zonal scope (such as zonal NEGs, hybrid connectivity\n NEGs): zonal\n API\n - \n To manage NEGs with regional scope (such as regional internet NEGs,\n serverless NEGs, Private Service Connect NEGs): regional\n API\n - \n To manage NEGs with global scope (such as global internet NEGs):global\n API", + "flatPath": "projects/{project}/regions/{region}/networkEndpointGroups", + "httpMethod": "POST", + "id": "compute.regionNetworkEndpointGroups.insert", + "parameterOrder": [ + "project", + "region" ], - "enum": [ - "CLOUD_NAT_ALLOWED", - "CLOUD_NAT_BLOCKED" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region where\nyou want to create the network endpoint group. It should comply with\nRFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/networkEndpointGroups", + "request": { + "$ref": "NetworkEndpointGroup" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "allowVpn": { - "description": "Specifies whether VPN creation is allowed.", - "type": "string", - "enumDescriptions": [ - "", - "" + "list": { + "description": "Retrieves the list of regional network endpoint groups available to the\nspecified project in the given region.", + "flatPath": "projects/{project}/regions/{region}/networkEndpointGroups", + "httpMethod": "GET", + "id": "compute.regionNetworkEndpointGroups.list", + "parameterOrder": [ + "project", + "region" ], - "enum": [ - "VPN_ALLOWED", - "VPN_BLOCKED" + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of theregion\nwhere 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\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/regions/{region}/networkEndpointGroups", + "response": { + "$ref": "NetworkEndpointGroupList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "allowInterconnect": { - "description": "Specifies whether Cloud Interconnect creation is allowed.", - "type": "string", - "enumDescriptions": [ - "", - "" + "listNetworkEndpoints": { + "description": "Lists the network endpoints in the specified network endpoint group.", + "flatPath": "projects/{project}/regions/{region}/networkEndpointGroups/{networkEndpointGroup}/listNetworkEndpoints", + "httpMethod": "POST", + "id": "compute.regionNetworkEndpointGroups.listNetworkEndpoints", + "parameterOrder": [ + "project", + "region", + "networkEndpointGroup" ], - "enum": [ - "INTERCONNECT_ALLOWED", - "INTERCONNECT_BLOCKED" + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "networkEndpointGroup": { + "description": "The name of the network endpoint group from which you want to generate a\nlist 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\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of theregion\nwhere 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\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/regions/{region}/networkEndpointGroups/{networkEndpointGroup}/listNetworkEndpoints", + "response": { + "$ref": "NetworkEndpointGroupsListNetworkEndpoints" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] - }, - "allowPacketMirroring": { - "description": "Specifies whether Packet Mirroring 1.0 is supported.", - "type": "string", - "enumDescriptions": [ - "", - "" + } + } + }, + "regionNetworkFirewallPolicies": { + "methods": { + "addAssociation": { + "description": "Inserts an association for the specified network firewall policy.", + "flatPath": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}/addAssociation", + "httpMethod": "POST", + "id": "compute.regionNetworkFirewallPolicies.addAssociation", + "parameterOrder": [ + "project", + "region", + "firewallPolicy" ], - "enum": [ - "PACKET_MIRRORING_ALLOWED", - "PACKET_MIRRORING_BLOCKED" + "parameters": { + "firewallPolicy": { + "description": "Name of the firewall policy to update.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "replaceExistingAssociation": { + "description": "Indicates whether or not to replace it if an association already exists.\nThis is false by default, in which case an error will be returned if an\nassociation already exists.", + "location": "query", + "type": "boolean" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}/addAssociation", + "request": { + "$ref": "FirewallPolicyAssociation" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "subnetworkPurposes": { - "description": "Specifies which subnetwork purposes are supported.", - "type": "array", - "items": { - "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.", - "Subnetwork will be used for Migration from one peered VPC to another. (a transient state of subnetwork while migrating resources from one project to another).", - "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." - ], - "enum": [ - "GLOBAL_MANAGED_PROXY", - "INTERNAL_HTTPS_LOAD_BALANCER", - "PEER_MIGRATION", - "PRIVATE", - "PRIVATE_NAT", - "PRIVATE_RFC_1918", - "PRIVATE_SERVICE_CONNECT", - "REGIONAL_MANAGED_PROXY" - ] - } - }, - "subnetworkStackTypes": { - "description": "Specifies which subnetwork stack types are supported.", - "type": "array", - "items": { - "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." - ], - "enum": [ - "IPV4_IPV6", - "IPV4_ONLY", - "IPV6_ONLY" - ] - } - }, - "subnetPurposes": { - "description": "Specifies which subnetwork purposes are supported.", - "type": "array", - "items": { - "type": "string", - "enumDescriptions": [ - "", - "" - ], - "enum": [ - "SUBNET_PURPOSE_CUSTOM_HARDWARE", - "SUBNET_PURPOSE_PRIVATE" - ] - } - }, - "subnetStackTypes": { - "description": "Specifies which subnetwork stack types are supported.", - "type": "array", - "items": { - "type": "string", - "enumDescriptions": [ - "", - "", - "" - ], - "enum": [ - "SUBNET_STACK_TYPE_IPV4_IPV6", - "SUBNET_STACK_TYPE_IPV4_ONLY", - "SUBNET_STACK_TYPE_IPV6_ONLY" - ] - } - }, - "allowPrivateGoogleAccess": { - "description": "Specifies whether private Google access is allowed.", - "type": "string", - "enumDescriptions": [ - "", - "" + "addRule": { + "description": "Inserts a rule into a network firewall policy.", + "flatPath": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}/addRule", + "httpMethod": "POST", + "id": "compute.regionNetworkFirewallPolicies.addRule", + "parameterOrder": [ + "project", + "region", + "firewallPolicy" ], - "enum": [ - "PRIVATE_GOOGLE_ACCESS_ALLOWED", - "PRIVATE_GOOGLE_ACCESS_BLOCKED" + "parameters": { + "firewallPolicy": { + "description": "Name of the firewall policy to update.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "maxPriority": { + "description": "When rule.priority is not specified, auto choose a unused priority betweenminPriority and maxPriority>.\nThis field is exclusive with rule.priority.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "minPriority": { + "description": "When rule.priority is not specified, auto choose a unused priority betweenminPriority and maxPriority>.\nThis field is exclusive with rule.priority.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}/addRule", + "request": { + "$ref": "FirewallPolicyRule" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "interfaceTypes": { - "description": "If set, limits the interface types that the network supports. If empty, all interface types are supported.", - "type": "array", - "items": { - "type": "string", - "enumDescriptions": [ - "GVNIC", - "IDPF", - "IRDMA", - "MRDMA", - "No type specified.", - "VIRTIO" - ], - "enum": [ - "GVNIC", - "IDPF", - "IRDMA", - "MRDMA", - "UNSPECIFIED_NIC_TYPE", - "VIRTIO_NET" - ] - } - }, - "allowClassDFirewalls": { - "description": "Specifies whether firewalls for Class D address ranges are supported.", - "type": "string", - "enumDescriptions": [ - "", - "" + "cloneRules": { + "description": "Copies rules to the specified network firewall policy.", + "flatPath": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}/cloneRules", + "httpMethod": "POST", + "id": "compute.regionNetworkFirewallPolicies.cloneRules", + "parameterOrder": [ + "project", + "region", + "firewallPolicy" ], - "enum": [ - "CLASS_D_FIREWALLS_ALLOWED", - "CLASS_D_FIREWALLS_BLOCKED" + "parameters": { + "firewallPolicy": { + "description": "Name of the firewall policy to update.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "sourceFirewallPolicy": { + "description": "The firewall policy from which to copy rules.", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}/cloneRules", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "allowSubInterfaces": { - "description": "Specifies whether sub interfaces are allowed.", - "type": "string", - "enumDescriptions": [ - "", - "" + "delete": { + "description": "Deletes the specified network firewall policy.", + "flatPath": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}", + "httpMethod": "DELETE", + "id": "compute.regionNetworkFirewallPolicies.delete", + "parameterOrder": [ + "project", + "region", + "firewallPolicy" ], - "enum": [ - "SUBINTERFACES_ALLOWED", - "SUBINTERFACES_BLOCKED" + "parameters": { + "firewallPolicy": { + "description": "Name of the firewall policy to delete.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "allowExternalIpAccess": { - "description": "Specifies whether VMs are allowed to have external IP access on network interfaces connected to this VPC.", - "type": "string", - "enumDescriptions": [ - "", - "" + "get": { + "description": "Returns the specified network firewall policy.", + "flatPath": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}", + "httpMethod": "GET", + "id": "compute.regionNetworkFirewallPolicies.get", + "parameterOrder": [ + "project", + "region", + "firewallPolicy" ], - "enum": [ - "EXTERNAL_IP_ACCESS_ALLOWED", - "EXTERNAL_IP_ACCESS_BLOCKED" + "parameters": { + "firewallPolicy": { + "description": "Name of the firewall policy to get.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/firewallPolicies/{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" ] }, - "addressPurposes": { - "description": "Specifies what address purposes are supported. If empty, all address purposes are supported.", - "type": "array", - "items": { - "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." - ], - "enum": [ - "DNS_RESOLVER", - "GCE_ENDPOINT", - "IPSEC_INTERCONNECT", - "NAT_AUTO", - "PRIVATE_SERVICE_CONNECT", - "SERVERLESS", - "SHARED_LOADBALANCER_VIP", - "VPC_PEERING" - ] - } - }, - "allowAliasIpRanges": { - "description": "Specifies whether alias IP ranges (and secondary address ranges) are allowed.", - "type": "string", - "enumDescriptions": [ - "", - "" + "getAssociation": { + "description": "Gets an association with the specified name.", + "flatPath": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}/getAssociation", + "httpMethod": "GET", + "id": "compute.regionNetworkFirewallPolicies.getAssociation", + "parameterOrder": [ + "project", + "region", + "firewallPolicy" ], - "enum": [ - "ALIAS_IP_RANGES_ALLOWED", - "ALIAS_IP_RANGES_BLOCKED" + "parameters": { + "firewallPolicy": { + "description": "Name of the firewall policy to which the queried association belongs.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "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.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}/getAssociation", + "response": { + "$ref": "FirewallPolicyAssociation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "allowDefaultNicAttachment": { - "description": "Specifies whether default NIC attachment is allowed.", - "type": "string", - "enumDescriptions": [ - "", - "" + "getEffectiveFirewalls": { + "description": "Returns the effective firewalls on a given network.", + "flatPath": "projects/{project}/regions/{region}/firewallPolicies/getEffectiveFirewalls", + "httpMethod": "GET", + "id": "compute.regionNetworkFirewallPolicies.getEffectiveFirewalls", + "parameterOrder": [ + "project", + "region", + "network" ], - "enum": [ - "DEFAULT_NIC_ATTACHMENT_ALLOWED", - "DEFAULT_NIC_ATTACHMENT_BLOCKED" + "parameters": { + "network": { + "description": "Network reference", + "location": "query", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/firewallPolicies/getEffectiveFirewalls", + "response": { + "$ref": "RegionNetworkFirewallPoliciesGetEffectiveFirewallsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "allowNcc": { - "description": "Specifies whether NCC is allowed.", - "type": "string", - "enumDescriptions": [ - "", - "" + "getIamPolicy": { + "description": "Gets the access control policy for a resource. May be empty if no such\npolicy or resource exists.", + "flatPath": "projects/{project}/regions/{region}/firewallPolicies/{resource}/getIamPolicy", + "httpMethod": "GET", + "id": "compute.regionNetworkFirewallPolicies.getIamPolicy", + "parameterOrder": [ + "project", + "region", + "resource" ], - "enum": [ - "NCC_ALLOWED", - "NCC_BLOCKED" + "parameters": { + "optionsRequestedPolicyVersion": { + "description": "Requested IAM Policy version.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/firewallPolicies/{resource}/getIamPolicy", + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "allowIpForwarding": { - "description": "Specifies whether IP forwarding is allowed.", - "type": "string", - "enumDescriptions": [ - "", - "" + "getRule": { + "description": "Gets a rule of the specified priority.", + "flatPath": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}/getRule", + "httpMethod": "GET", + "id": "compute.regionNetworkFirewallPolicies.getRule", + "parameterOrder": [ + "project", + "region", + "firewallPolicy" ], - "enum": [ - "IP_FORWARDING_ALLOWED", - "IP_FORWARDING_BLOCKED" + "parameters": { + "firewallPolicy": { + "description": "Name of the firewall policy to which the queried rule belongs.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "priority": { + "description": "The priority of the rule to get from the firewall policy.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}/getRule", + "response": { + "$ref": "FirewallPolicyRule" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "allowNetworkMigration": { - "description": "Specifies whether VM network migration is allowed.", - "type": "string", - "enumDescriptions": [ - "", - "" + "insert": { + "description": "Creates a new network firewall policy in the specified project and region.", + "flatPath": "projects/{project}/regions/{region}/firewallPolicies", + "httpMethod": "POST", + "id": "compute.regionNetworkFirewallPolicies.insert", + "parameterOrder": [ + "project", + "region" ], - "enum": [ - "NETWORK_MIGRATION_ALLOWED", - "NETWORK_MIGRATION_BLOCKED" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID\nso that if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/firewallPolicies", + "request": { + "$ref": "FirewallPolicy" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] - } - } - }, - "ReservationBlocksGetResponse": { - "id": "ReservationBlocksGetResponse", - "type": "object", - "properties": { - "resource": { - "$ref": "ReservationBlock" - } - } - }, - "ReservationBlock": { - "id": "ReservationBlock", - "description": "Represents a reservation block resource.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of the resource. Always compute#reservationBlock for reservation blocks.", - "default": "compute#reservationBlock", - "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] The name of this reservation block generated by Google Compute Engine. 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" - }, - "zone": { - "description": "[Output Only] Zone in which the reservation block resides.", - "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" - }, - "count": { - "description": "[Output Only] The number of resources that are allocated in this reservation block.", - "type": "integer", - "format": "int32" }, - "inUseCount": { - "description": "[Output Only] The number of instances that are currently in use on this reservation block.", - "type": "integer", - "format": "int32" - }, - "reservationMaintenance": { - "description": "[Output Only] Maintenance information for this reservation block.", - "$ref": "GroupMaintenanceInfo" - }, - "status": { - "description": "[Output Only] Status of the reservation block.", - "type": "string", - "enumDescriptions": [ - "Resources are being allocated for the reservation block.", - "Reservation block is currently being deleted.", - "", - "Reservation block has allocated all its resources." + "list": { + "description": "Lists all the network firewall policies that have been configured\nfor the specified project in the given region.", + "flatPath": "projects/{project}/regions/{region}/firewallPolicies", + "httpMethod": "GET", + "id": "compute.regionNetworkFirewallPolicies.list", + "parameterOrder": [ + "project", + "region" ], - "enum": [ - "CREATING", - "DELETING", - "INVALID", - "READY" + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/regions/{region}/firewallPolicies", + "response": { + "$ref": "FirewallPolicyList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "physicalTopology": { - "description": "[Output Only] The physical topology of the reservation block.", - "$ref": "ReservationBlockPhysicalTopology" - }, - "reservationSubBlockCount": { - "description": "[Output Only] The number of reservation subBlocks associated with this reservation block.", - "type": "integer", - "format": "int32" - }, - "reservationSubBlockInUseCount": { - "description": "[Output Only] The number of in-use reservation subBlocks associated with this reservation block. If at least one VM is running on a subBlock, it is considered in-use.", - "type": "integer", - "format": "int32" - } - } - }, - "ReservationBlockPhysicalTopology": { - "id": "ReservationBlockPhysicalTopology", - "type": "object", - "properties": { - "cluster": { - "description": "The cluster name of the reservation block.", - "type": "string" - }, - "block": { - "description": "The hash of the capacity block within the cluster.", - "type": "string" - } - } - }, - "ReservationBlocksListResponse": { - "id": "ReservationBlocksListResponse", - "description": "A list of reservation blocks under a single reservation.", - "type": "object", - "properties": { - "kind": { - "description": "Type of the resource. Always compute#reservationBlock for a list of reservation blocks.", - "default": "compute#reservationBlock", - "type": "string" - }, - "id": { - "description": "Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of reservation block resources.", - "type": "array", - "items": { - "$ref": "ReservationBlock" - } - }, - "nextPageToken": { - "description": "This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the 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": "Server-defined URL for this resource.", - "type": "string" - }, - "warning": { - "description": "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "patch": { + "description": "Patches the specified network firewall policy.", + "flatPath": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}", + "httpMethod": "PATCH", + "id": "compute.regionNetworkFirewallPolicies.patch", + "parameterOrder": [ + "project", + "region", + "firewallPolicy" + ], + "parameters": { + "firewallPolicy": { + "description": "Name of the firewall policy to update.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}", + "request": { + "$ref": "FirewallPolicy" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "patchRule": { + "description": "Patches a rule of the specified priority.", + "flatPath": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}/patchRule", + "httpMethod": "POST", + "id": "compute.regionNetworkFirewallPolicies.patchRule", + "parameterOrder": [ + "project", + "region", + "firewallPolicy" + ], + "parameters": { + "firewallPolicy": { + "description": "Name of the firewall policy to update.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "priority": { + "description": "The priority of the rule to patch.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" } - } - } - } - }, - "ReservationsBlocksPerformMaintenanceRequest": { - "id": "ReservationsBlocksPerformMaintenanceRequest", - "type": "object", - "properties": { - "maintenanceScope": { - "description": "Specifies if all, running or unused hosts are in scope for this request.", - "type": "string", - "enumDescriptions": [ - "Trigger maintenance for all hosts belonging to this reservation irrespective of whether VMs are running on them or not.", - "Internal only", - "Trigger maintenance only on the hosts belonging to this reservation which have VMs running on them.", - "Trigger maintenance only on the hosts belonging to this reservation which do not have any VMs running on them. This is not allowed for Standard ExR" - ], - "enum": [ - "ALL", - "MAINTENANCE_SCOPE_UNSPECIFIED", - "RUNNING_VMS", - "UNUSED_CAPACITY" + }, + "path": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}/patchRule", + "request": { + "$ref": "FirewallPolicyRule" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] - } - } - }, - "ReservationSubBlocksGetResponse": { - "id": "ReservationSubBlocksGetResponse", - "type": "object", - "properties": { - "resource": { - "$ref": "ReservationSubBlock" - } - } - }, - "ReservationSubBlock": { - "id": "ReservationSubBlock", - "description": "Represents a reservation subBlock resource.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of the resource. Always compute#reservationSubBlock for reservation subBlocks.", - "default": "compute#reservationSubBlock", - "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] The name of this reservation subBlock generated by Google Compute Engine. 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" - }, - "zone": { - "description": "[Output Only] Zone in which the reservation subBlock resides.", - "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" - }, - "count": { - "description": "[Output Only] The number of hosts that are allocated in this reservation subBlock.", - "type": "integer", - "format": "int32" - }, - "inUseCount": { - "description": "[Output Only] The number of instances that are currently in use on this reservation subBlock.", - "type": "integer", - "format": "int32" }, - "status": { - "description": "[Output Only] Status of the reservation subBlock.", - "type": "string", - "enumDescriptions": [ - "Resources are being allocated for the reservation subBlock.", - "Reservation subBlock is currently being deleted.", - "", - "Reservation subBlock has allocated all its resources." + "removeAssociation": { + "description": "Removes an association for the specified network firewall policy.", + "flatPath": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}/removeAssociation", + "httpMethod": "POST", + "id": "compute.regionNetworkFirewallPolicies.removeAssociation", + "parameterOrder": [ + "project", + "region", + "firewallPolicy" ], - "enum": [ - "CREATING", - "DELETING", - "INVALID", - "READY" + "parameters": { + "firewallPolicy": { + "description": "Name of the firewall policy to update.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "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.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}/removeAssociation", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "physicalTopology": { - "description": "[Output Only] The physical topology of the reservation subBlock.", - "$ref": "ReservationSubBlockPhysicalTopology" - } - } - }, - "ReservationSubBlockPhysicalTopology": { - "id": "ReservationSubBlockPhysicalTopology", - "type": "object", - "properties": { - "cluster": { - "description": "The cluster name of the reservation subBlock.", - "type": "string" - }, - "block": { - "description": "The hash of the capacity block within the cluster.", - "type": "string" - }, - "subBlock": { - "description": "The hash of the capacity sub-block within the capacity block.", - "type": "string" - } - } - }, - "ReservationSubBlocksListResponse": { - "id": "ReservationSubBlocksListResponse", - "description": "A list of reservation subBlocks under a single reservation.", - "type": "object", - "properties": { - "kind": { - "description": "Type of the resource. Always compute#reservationSubBlock for a list of reservation subBlocks.", - "default": "compute#reservationSubBlock", - "type": "string" - }, - "id": { - "description": "Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of reservation subBlock resources.", - "type": "array", - "items": { - "$ref": "ReservationSubBlock" - } - }, - "nextPageToken": { - "description": "This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the 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": "Server-defined URL for this resource.", - "type": "string" - }, - "warning": { - "description": "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "removeRule": { + "description": "Deletes a rule of the specified priority.", + "flatPath": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}/removeRule", + "httpMethod": "POST", + "id": "compute.regionNetworkFirewallPolicies.removeRule", + "parameterOrder": [ + "project", + "region", + "firewallPolicy" + ], + "parameters": { + "firewallPolicy": { + "description": "Name of the firewall policy to update.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "priority": { + "description": "The priority of the rule to remove from the firewall policy.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "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" - } + }, + "path": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}/removeRule", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the 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": { + "description": "Sets the access control policy on the specified resource.\nReplaces any existing policy.", + "flatPath": "projects/{project}/regions/{region}/firewallPolicies/{resource}/setIamPolicy", + "httpMethod": "POST", + "id": "compute.regionNetworkFirewallPolicies.setIamPolicy", + "parameterOrder": [ + "project", + "region", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/firewallPolicies/{resource}/setIamPolicy", + "request": { + "$ref": "RegionSetPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource.", + "flatPath": "projects/{project}/regions/{region}/firewallPolicies/{resource}/testIamPermissions", + "httpMethod": "POST", + "id": "compute.regionNetworkFirewallPolicies.testIamPermissions", + "parameterOrder": [ + "project", + "region", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "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": { - "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" - }, - "workloadPolicy": { - "$ref": "ResourcePolicyWorkloadPolicy" - }, - "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" - }, - "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." - ], - "enum": [ - "CREATING", - "DELETING", - "EXPIRED", - "INVALID", - "READY" + "path": "projects/{project}/regions/{region}/firewallPolicies/{resource}/testIamPermissions", + "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" ] - }, - "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": [ - "", - "", - "", - "", - "", - "", - "", - "" + "regionNotificationEndpoints": { + "methods": { + "aggregatedList": { + "description": "Retrieves the list of all NotificationEndpoint resources,\nregional and global, available to the specified project.", + "flatPath": "projects/{project}/aggregated/notificationEndpoints", + "httpMethod": "GET", + "id": "compute.regionNotificationEndpoints.aggregatedList", + "parameterOrder": [ + "project" ], - "enum": [ - "FRIDAY", - "INVALID", - "MONDAY", - "SATURDAY", - "SUNDAY", - "THURSDAY", - "TUESDAY", - "WEDNESDAY" + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region,\nglobal) should be included in the response. For new resource types added\nafter this field, the flag has no effect as new resource types will always\ninclude every visible scope for each scope type in response. For resource\ntypes which predate this field, if this flag is omitted or false, only\nscopes of the scope types where the resource type is expected to be found\nwill be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Name of the project scoping this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which\naggregated list request is invoked for subnetworks list-usable api.", + "format": "int64", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/aggregated/notificationEndpoints", + "response": { + "$ref": "NotificationEndpointAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "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": [ - "", - "", - "" + "delete": { + "description": "Deletes the specified NotificationEndpoint in the given region", + "flatPath": "projects/{project}/regions/{region}/notificationEndpoints/{notificationEndpoint}", + "httpMethod": "DELETE", + "id": "compute.regionNotificationEndpoints.delete", + "parameterOrder": [ + "project", + "region", + "notificationEndpoint" ], - "enum": [ - "APPLY_RETENTION_POLICY", - "KEEP_AUTO_SNAPSHOTS", - "UNSPECIFIED_ON_SOURCE_DISK_DELETE" + "parameters": { + "notificationEndpoint": { + "description": "Name of the NotificationEndpoint resource to delete.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/notificationEndpoints/{notificationEndpoint}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] - } - } - }, - "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" - }, - "collocation": { - "description": "Specifies network collocation", - "type": "string", - "enumDescriptions": [ - "", - "" + "get": { + "description": "Returns the specified NotificationEndpoint resource in the given region.", + "flatPath": "projects/{project}/regions/{region}/notificationEndpoints/{notificationEndpoint}", + "httpMethod": "GET", + "id": "compute.regionNotificationEndpoints.get", + "parameterOrder": [ + "project", + "region", + "notificationEndpoint" ], - "enum": [ - "COLLOCATED", - "UNSPECIFIED_COLLOCATION" + "parameters": { + "notificationEndpoint": { + "description": "Name of the NotificationEndpoint resource to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/notificationEndpoints/{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" ] }, - "gpuTopology": { - "description": "Specifies the shape of the GPU slice, in slice based GPU families eg. A4X.", - "type": "string" - } - } - }, - "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" - }, - "vmStopSchedule": { - "description": "Specifies the schedule for stopping instances.", - "$ref": "ResourcePolicyInstanceSchedulePolicySchedule" - }, - "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" + "insert": { + "description": "Create a NotificationEndpoint in the specified project in the given region\nusing the parameters that are included in the request.", + "flatPath": "projects/{project}/regions/{region}/notificationEndpoints", + "httpMethod": "POST", + "id": "compute.regionNotificationEndpoints.insert", + "parameterOrder": [ + "project", + "region" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/notificationEndpoints", + "request": { + "$ref": "NotificationEndpoint" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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": {} - }, - "ResourcePolicyWorkloadPolicy": { - "id": "ResourcePolicyWorkloadPolicy", - "description": "Represents the workload policy.", - "type": "object", - "properties": { - "type": { - "type": "string", - "enumDescriptions": [ - "VMs will be provisioned in such a way which provides high availability.", - "VMs will be provisioned in such a way which provides high throughput." + "list": { + "description": "Lists the NotificationEndpoints for a project in the given region.", + "flatPath": "projects/{project}/regions/{region}/notificationEndpoints", + "httpMethod": "GET", + "id": "compute.regionNotificationEndpoints.list", + "parameterOrder": [ + "project", + "region" ], - "enum": [ - "HIGH_AVAILABILITY", - "HIGH_THROUGHPUT" + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/regions/{region}/notificationEndpoints", + "response": { + "$ref": "NotificationEndpointList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "maxTopologyDistance": { - "type": "string", - "enumDescriptions": [ - "VMs must be provisioned in the same block.", - "VMs must be provisioned in the same cluster.", - "VMs must be provisioned in the same subblock." + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource.", + "flatPath": "projects/{project}/regions/{region}/notificationEndpoints/{resource}/testIamPermissions", + "httpMethod": "POST", + "id": "compute.regionNotificationEndpoints.testIamPermissions", + "parameterOrder": [ + "project", + "region", + "resource" ], - "enum": [ - "BLOCK", - "CLUSTER", - "SUBBLOCK" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/notificationEndpoints/{resource}/testIamPermissions", + "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" ] - }, - "acceleratorTopology": { - "type": "string" - } - } - }, - "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" - }, - "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" - }, - "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" - }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "regionOperations": { + "methods": { + "delete": { + "description": "Deletes the specified region-specific Operations resource.", + "flatPath": "projects/{project}/regions/{region}/operations/{operation}", + "httpMethod": "DELETE", + "id": "compute.regionOperations.delete", + "parameterOrder": [ + "project", + "region", + "operation" + ], + "parameters": { + "operation": { + "description": "Name of the Operations resource to delete, or its unique numeric\nidentifier.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" } - } - }, - "etag": { - "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" - } + }, + "path": "projects/{project}/regions/{region}/operations/{operation}", + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "get": { + "description": "Retrieves the specified region-specific Operations resource.", + "flatPath": "projects/{project}/regions/{region}/operations/{operation}", + "httpMethod": "GET", + "id": "compute.regionOperations.get", + "parameterOrder": [ + "project", + "region", + "operation" + ], + "parameters": { + "operation": { + "description": "Name of the Operations resource to return, or its unique numeric\nidentifier.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" } - } - } - } - }, - "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" + }, + "path": "projects/{project}/regions/{region}/operations/{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" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "list": { + "description": "Retrieves a list of Operation resources contained within\nthe specified region.", + "flatPath": "projects/{project}/regions/{region}/operations", + "httpMethod": "GET", + "id": "compute.regionOperations.list", + "parameterOrder": [ + "project", + "region" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe 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.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/regions/{region}/operations", + "response": { + "$ref": "OperationList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] + }, + "wait": { + "description": "Waits for the specified Operation resource to return as `DONE`\nor for the request to approach the 2 minute deadline, and retrieves the\nspecified Operation resource. This method differs from the\n`GET` method in that it waits for no more than the default\ndeadline (2 minutes) and then returns the current state of the operation,\nwhich might be `DONE` or still in progress.\n\nThis method is called on a best-effort basis. Specifically:\n \n \n - In uncommon cases, when the server is overloaded, the request might\n return before the default deadline is reached, or might return after zero\n seconds.\n - If the default deadline is reached, there is no guarantee that the\n operation is actually done when the method returns. Be prepared to retry\n if the operation is not `DONE`.", + "flatPath": "projects/{project}/regions/{region}/operations/{operation}/wait", + "httpMethod": "POST", + "id": "compute.regionOperations.wait", + "parameterOrder": [ + "project", + "region", + "operation" + ], + "parameters": { + "operation": { + "description": "Name of the Operations resource to return, or its unique numeric\nidentifier.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" } - } + }, + "path": "projects/{project}/regions/{region}/operations/{operation}/wait", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] } } }, - "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" - ] + "regionSecurityPolicies": { + "methods": { + "addRule": { + "description": "Inserts a rule into a security policy.", + "flatPath": "projects/{project}/regions/{region}/securityPolicies/{securityPolicy}/addRule", + "httpMethod": "POST", + "id": "compute.regionSecurityPolicies.addRule", + "parameterOrder": [ + "project", + "region", + "securityPolicy" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "securityPolicy": { + "description": "Name of the security policy to update.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "validateOnly": { + "description": "If true, the request will not be committed.", + "location": "query", + "type": "boolean" + } }, - "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" - ] + "path": "projects/{project}/regions/{region}/securityPolicies/{securityPolicy}/addRule", + "request": { + "$ref": "SecurityPolicyRule" }, - "type": "string" - }, - "tags": { - "description": "A list of instance tags to which this route applies.", - "annotations": { - "required": [ - "compute.routes.insert" - ] + "response": { + "$ref": "Operation" }, - "type": "array", - "items": { - "type": "string" - } + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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" - ] + "delete": { + "description": "Deletes the specified policy.", + "flatPath": "projects/{project}/regions/{region}/securityPolicies/{securityPolicy}", + "httpMethod": "DELETE", + "id": "compute.regionSecurityPolicies.delete", + "parameterOrder": [ + "project", + "region", + "securityPolicy" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "securityPolicy": { + "description": "Name of the security policy to delete.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "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" - ] + "path": "projects/{project}/regions/{region}/securityPolicies/{securityPolicy}", + "response": { + "$ref": "Operation" }, - "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" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "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" - } - } - } - } + "get": { + "description": "List all of the ordered rules present in a single specified policy.", + "flatPath": "projects/{project}/regions/{region}/securityPolicies/{securityPolicy}", + "httpMethod": "GET", + "id": "compute.regionSecurityPolicies.get", + "parameterOrder": [ + "project", + "region", + "securityPolicy" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "securityPolicy": { + "description": "Name of the security policy to get.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" } - } + }, + "path": "projects/{project}/regions/{region}/securityPolicies/{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" + ] }, - "nextHopVpnTunnel": { - "description": "The URL to a VpnTunnel that should handle matching packets.", - "type": "string" + "getRule": { + "description": "Gets a rule at the specified priority.", + "flatPath": "projects/{project}/regions/{region}/securityPolicies/{securityPolicy}/getRule", + "httpMethod": "GET", + "id": "compute.regionSecurityPolicies.getRule", + "parameterOrder": [ + "project", + "region", + "securityPolicy" + ], + "parameters": { + "priority": { + "description": "The priority of the rule to get from the security policy.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "securityPolicy": { + "description": "Name of the security policy to which the queried rule belongs.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/securityPolicies/{securityPolicy}/getRule", + "response": { + "$ref": "SecurityPolicyRule" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "nextHopHub": { - "description": "[Output Only] The full resource name of the Network Connectivity Center hub that will handle matching packets.", - "type": "string" + "insert": { + "description": "Creates a new policy in the specified project using the data included in\nthe request.", + "flatPath": "projects/{project}/regions/{region}/securityPolicies", + "httpMethod": "POST", + "id": "compute.regionSecurityPolicies.insert", + "parameterOrder": [ + "project", + "region" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "validateOnly": { + "description": "If true, the request will not be committed.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/regions/{region}/securityPolicies", + "request": { + "$ref": "SecurityPolicy" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "selfLink": { - "description": "[Output Only] Server-defined fully-qualified URL for this resource.", - "type": "string" + "list": { + "description": "List all the policies that have been configured for the specified project\nand region.", + "flatPath": "projects/{project}/regions/{region}/securityPolicies", + "httpMethod": "GET", + "id": "compute.regionSecurityPolicies.list", + "parameterOrder": [ + "project", + "region" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/regions/{region}/securityPolicies", + "response": { + "$ref": "SecurityPolicyList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "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": [ - "", - "", - "", - "" + "patch": { + "description": "Patches the specified policy with the data included in the request. To\nclear fields in the policy, leave the fields empty and specify them in the\nupdateMask. This cannot be used to be update the rules in the policy.\nPlease use the per rule methods like addRule, patchRule, and removeRule\ninstead.", + "flatPath": "projects/{project}/regions/{region}/securityPolicies/{securityPolicy}", + "httpMethod": "PATCH", + "id": "compute.regionSecurityPolicies.patch", + "parameterOrder": [ + "project", + "region", + "securityPolicy" ], - "enum": [ - "BGP", - "STATIC", - "SUBNET", - "TRANSIT" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "securityPolicy": { + "description": "Name of the security policy to update.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "Indicates fields to be cleared as part of this request.", + "format": "google-fieldmask", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/securityPolicies/{securityPolicy}", + "request": { + "$ref": "SecurityPolicy" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "asPaths": { - "description": "[Output Only] AS path.", - "type": "array", - "items": { - "$ref": "RouteAsPath" - } - }, - "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." + "patchRule": { + "description": "Patches a rule at the specified priority. To clear fields in the rule,\nleave the fields empty and specify them in the updateMask.", + "flatPath": "projects/{project}/regions/{region}/securityPolicies/{securityPolicy}/patchRule", + "httpMethod": "POST", + "id": "compute.regionSecurityPolicies.patchRule", + "parameterOrder": [ + "project", + "region", + "securityPolicy" ], - "enum": [ - "ACTIVE", - "DROPPED", - "INACTIVE", - "PENDING" + "parameters": { + "priority": { + "description": "The priority of the rule to patch.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "securityPolicy": { + "description": "Name of the security policy to update.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "Indicates fields to be cleared as part of this request.", + "format": "google-fieldmask", + "location": "query", + "type": "string" + }, + "validateOnly": { + "description": "If true, the request will not be committed.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/regions/{region}/securityPolicies/{securityPolicy}/patchRule", + "request": { + "$ref": "SecurityPolicyRule" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "nextHopOrigin": { - "description": "[Output Only] Indicates the origin of the route. Can be IGP (Interior Gateway Protocol), EGP (Exterior Gateway Protocol), or INCOMPLETE.", - "type": "string", - "enumDescriptions": [ - "", - "", - "" + "removeRule": { + "description": "Deletes a rule at the specified priority.", + "flatPath": "projects/{project}/regions/{region}/securityPolicies/{securityPolicy}/removeRule", + "httpMethod": "POST", + "id": "compute.regionSecurityPolicies.removeRule", + "parameterOrder": [ + "project", + "region", + "securityPolicy" ], - "enum": [ - "EGP", - "IGP", - "INCOMPLETE" + "parameters": { + "priority": { + "description": "The priority of the rule to remove from the security policy.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "securityPolicy": { + "description": "Name of the security policy to update.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/securityPolicies/{securityPolicy}/removeRule", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "nextHopMed": { - "description": "[Output Only] Multi-Exit Discriminator, a BGP route metric that indicates the desirability of a particular route in a network.", - "type": "integer", - "format": "uint32" - }, - "nextHopInterRegionCost": { - "description": "[Output only] Internal fixed region-to-region cost that Google Cloud calculates based on factors such as network performance, distance, and available bandwidth between regions.", - "type": "integer", - "format": "uint32" - }, - "params": { - "description": "Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload.", - "$ref": "RouteParams" - } - } - }, - "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": [ - "", - "", - "", - "" + "setLabels": { + "description": "Sets the labels on a security policy. To learn more about labels,\nread the Labeling Resources\ndocumentation.", + "flatPath": "projects/{project}/regions/{region}/securityPolicies/{resource}/setLabels", + "httpMethod": "POST", + "id": "compute.regionSecurityPolicies.setLabels", + "parameterOrder": [ + "project", + "region", + "resource" ], - "enum": [ - "AS_CONFED_SEQUENCE", - "AS_CONFED_SET", - "AS_SEQUENCE", - "AS_SET" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/securityPolicies/{resource}/setLabels", + "request": { + "$ref": "RegionSetLabelsRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] - }, - "asLists": { - "description": "[Output Only] The AS numbers of the AS Path.", - "type": "array", - "items": { - "type": "integer", - "format": "uint32" - } - } - } - }, - "RouteParams": { - "id": "RouteParams", - "description": "Additional route parameters.", - "type": "object", - "properties": { - "resourceManagerTags": { - "description": "Tag keys/values directly bound to this resource. Tag keys and values have the same definition as resource manager tags. The field is allowed for INSERT only. The keys/values to set on the resource should be specified in either ID { : } or Namespaced format { : }. For example the following are valid inputs: * {\"tagKeys/333\" : \"tagValues/444\", \"tagKeys/123\" : \"tagValues/456\"} * {\"123/environment\" : \"production\", \"345/abc\" : \"xyz\"} Note: * Invalid combinations of ID & namespaced format is not supported. For instance: {\"123/environment\" : \"tagValues/444\"} is invalid.", - "type": "object", - "additionalProperties": { - "type": "string" - } } } }, - "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" - }, - "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" - ] + "regionSnapshotSettings": { + "methods": { + "get": { + "description": "Get region snapshot settings.", + "flatPath": "projects/{project}/regions/{region}/snapshotSettings", + "httpMethod": "GET", + "id": "compute.regionSnapshotSettings.get", + "parameterOrder": [ + "project", + "region" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "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" - ] + "path": "projects/{project}/regions/{region}/snapshotSettings", + "response": { + "$ref": "SnapshotSettings" }, - "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" + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "md5AuthenticationKeys": { - "description": "Keys used for MD5 authentication.", - "type": "array", - "items": { - "$ref": "RouterMd5AuthenticationKey" - } + "patch": { + "description": "Patch region snapshot settings.", + "flatPath": "projects/{project}/regions/{region}/snapshotSettings", + "httpMethod": "PATCH", + "id": "compute.regionSnapshotSettings.patch", + "parameterOrder": [ + "project", + "region" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "updateMask": { + "description": "update_mask indicates fields to be updated as part of this request.", + "format": "google-fieldmask", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/snapshotSettings", + "request": { + "$ref": "SnapshotSettings" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] } } }, - "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" - ] + "regionSnapshots": { + "methods": { + "delete": { + "description": "Deletes the specified Snapshot resource. Keep in mind that deleting\na single snapshot might not necessarily delete all the data on that\nsnapshot. If any data on the snapshot that is marked for deletion is\nneeded for subsequent snapshots, the data will be moved to the next\ncorresponding snapshot.\n\nFor more information, seeDeleting\nsnapshots.", + "flatPath": "projects/{project}/regions/{region}/snapshots/{snapshot}", + "httpMethod": "DELETE", + "id": "compute.regionSnapshots.delete", + "parameterOrder": [ + "project", + "region", + "snapshot" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "snapshot": { + "description": "Name of the snapshot resource to delete.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "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" + "path": "projects/{project}/regions/{region}/snapshots/{snapshot}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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, fdff: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" + "get": { + "description": "Returns the specified Snapshot resource.", + "flatPath": "projects/{project}/regions/{region}/snapshots/{snapshot}", + "httpMethod": "GET", + "id": "compute.regionSnapshots.get", + "parameterOrder": [ + "project", + "region", + "snapshot" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "snapshot": { + "description": "Name of the Snapshot resource to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/snapshots/{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" + ] }, - "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." + "getIamPolicy": { + "description": "Gets the access control policy for a resource. May be empty if no such\npolicy or resource exists.", + "flatPath": "projects/{project}/regions/{region}/snapshots/{resource}/getIamPolicy", + "httpMethod": "GET", + "id": "compute.regionSnapshots.getIamPolicy", + "parameterOrder": [ + "project", + "region", + "resource" ], - "enum": [ - "MANAGED_BY_ATTACHMENT", - "MANAGED_BY_USER" + "parameters": { + "optionsRequestedPolicyVersion": { + "description": "Requested IAM Policy version.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/snapshots/{resource}/getIamPolicy", + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "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": [ - "", - "" + "insert": { + "description": "Creates a snapshot in the specified region using the data included\nin the request.", + "flatPath": "projects/{project}/regions/{region}/snapshots", + "httpMethod": "POST", + "id": "compute.regionSnapshots.insert", + "parameterOrder": [ + "project", + "region" ], - "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" - ] + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } }, - "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" - ] + "path": "projects/{project}/regions/{region}/snapshots", + "request": { + "$ref": "Snapshot" }, - "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" + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "advertiseMode": { - "description": "User-specified flag to indicate which mode to use for advertisement.", - "type": "string", - "enumDescriptions": [ - "", - "" + "list": { + "description": "Retrieves the list of Snapshot resources contained within\nthe specified region.", + "flatPath": "projects/{project}/regions/{region}/snapshots", + "httpMethod": "GET", + "id": "compute.regionSnapshots.list", + "parameterOrder": [ + "project", + "region" ], - "enum": [ - "CUSTOM", - "DEFAULT" + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/regions/{region}/snapshots", + "response": { + "$ref": "SnapshotList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "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." + "setIamPolicy": { + "description": "Sets the access control policy on the specified resource.\nReplaces any existing policy.", + "flatPath": "projects/{project}/regions/{region}/snapshots/{resource}/setIamPolicy", + "httpMethod": "POST", + "id": "compute.regionSnapshots.setIamPolicy", + "parameterOrder": [ + "project", + "region", + "resource" ], - "enum": [ - "MANAGED_BY_ATTACHMENT", - "MANAGED_BY_USER" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/snapshots/{resource}/setIamPolicy", + "request": { + "$ref": "RegionSetPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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": [ - "", - "" + "setLabels": { + "description": "Sets the labels on a regional snapshot. To learn more about labels, read\nthe Labeling Resources\ndocumentation.", + "flatPath": "projects/{project}/regions/{region}/snapshots/{resource}/setLabels", + "httpMethod": "POST", + "id": "compute.regionSnapshots.setLabels", + "parameterOrder": [ + "project", + "region", + "resource" ], - "enum": [ - "FALSE", - "TRUE" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/snapshots/{resource}/setLabels", + "request": { + "$ref": "RegionSetLabelsRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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.", - "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.", - "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": [ - "", - "", - "" + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource.", + "flatPath": "projects/{project}/regions/{region}/snapshots/{resource}/testIamPermissions", + "httpMethod": "POST", + "id": "compute.regionSnapshots.testIamPermissions", + "parameterOrder": [ + "project", + "region", + "resource" ], - "enum": [ - "ACTIVE", - "DISABLED", - "PASSIVE" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/snapshots/{resource}/testIamPermissions", + "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" ] }, - "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": [ - "", - "" + "updateKmsKey": { + "description": "Rotates the customer-managed\nencryption key to the latest version for the specified snapshot.", + "flatPath": "projects/{project}/regions/{region}/snapshots/{snapshot}/updateKmsKey", + "httpMethod": "POST", + "id": "compute.regionSnapshots.updateKmsKey", + "parameterOrder": [ + "project", + "region", + "snapshot" ], - "enum": [ - "CUSTOM", - "DEFAULT" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "snapshot": { + "description": "Name of the snapshot resource to update. Should conform to RFC1035.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/snapshots/{snapshot}/updateKmsKey", + "request": { + "$ref": "RegionSnapshotUpdateKmsKeyRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] - }, - "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" } } }, - "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" - }, - "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." - ], - "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." + "regionSslCertificates": { + "methods": { + "delete": { + "description": "Deletes the specified SslCertificate resource in the region.", + "flatPath": "projects/{project}/regions/{region}/sslCertificates/{sslCertificate}", + "httpMethod": "DELETE", + "id": "compute.regionSslCertificates.delete", + "parameterOrder": [ + "project", + "region", + "sslCertificate" ], - "enum": [ - "FIXED_STANDARD", - "PREMIUM", - "STANDARD", - "STANDARD_OVERRIDES_FIXED_STANDARD" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "sslCertificate": { + "description": "Name of the SslCertificate resource to delete.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/sslCertificates/{sslCertificate}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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" - ] - } - }, - "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)" + "get": { + "description": "Returns the specified SslCertificate resource in the specified region. Get\na list of available SSL certificates by making a list()\nrequest.", + "flatPath": "projects/{project}/regions/{region}/sslCertificates/{sslCertificate}", + "httpMethod": "GET", + "id": "compute.regionSslCertificates.get", + "parameterOrder": [ + "project", + "region", + "sslCertificate" ], - "enum": [ - "ALL_SUBNETWORKS_ALL_IP_RANGES", - "ALL_SUBNETWORKS_ALL_PRIMARY_IP_RANGES", - "LIST_OF_SUBNETWORKS" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "sslCertificate": { + "description": "Name of the SslCertificate resource to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/sslCertificates/{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" ] }, - "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" - } - }, - "sourceSubnetworkIpRangesToNat64": { - "description": "Specify the Nat option for NAT64, which can take one of the following values: - ALL_IPV6_SUBNETWORKS: All of the IP ranges in every Subnetwork are allowed to Nat. - LIST_OF_IPV6_SUBNETWORKS: A list of Subnetworks are allowed to Nat (specified in the field nat64_subnetwork below) The default is NAT64_OPTION_UNSPECIFIED. Note that if this field contains NAT64_ALL_V6_SUBNETWORKS no other Router.Nat section in this region can also enable NAT64 for any Subnetworks in this network. Other Router.Nat sections can still be present to enable NAT44 only.", - "type": "string", - "enumDescriptions": [ - "NAT64 is enabled for all the IPv6 subnet ranges. In dual stack subnets, NAT64 will only be enabled for IPv6-only VMs.", - "NAT64 is enabled for a list of IPv6 subnet ranges. In dual stack subnets, NAT64 will only be enabled for IPv6-only VMs. If this option is used, the nat64_subnetworks field must be specified." + "insert": { + "description": "Creates a SslCertificate resource in the specified project and region using\nthe data included in the request", + "flatPath": "projects/{project}/regions/{region}/sslCertificates", + "httpMethod": "POST", + "id": "compute.regionSslCertificates.insert", + "parameterOrder": [ + "project", + "region" ], - "enum": [ - "ALL_IPV6_SUBNETWORKS", - "LIST_OF_IPV6_SUBNETWORKS" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/sslCertificates", + "request": { + "$ref": "SslCertificate" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "nat64Subnetworks": { - "description": "List of Subnetwork resources whose traffic should be translated by NAT64 Gateway. It is used only when LIST_OF_IPV6_SUBNETWORKS is selected for the SubnetworkIpRangeToNat64Option above.", - "type": "array", - "items": { - "$ref": "RouterNatSubnetworkToNat64" - } - }, - "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." + "list": { + "description": "Retrieves the list of SslCertificate resources available to the specified\nproject in the specified region.", + "flatPath": "projects/{project}/regions/{region}/sslCertificates", + "httpMethod": "GET", + "id": "compute.regionSslCertificates.list", + "parameterOrder": [ + "project", + "region" ], - "enum": [ - "AUTO_ONLY", - "MANUAL_ONLY" + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/regions/{region}/sslCertificates", + "response": { + "$ref": "SslCertificateList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] - }, - "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" - } - } - } - }, - "RouterNatSubnetworkToNat64": { - "id": "RouterNatSubnetworkToNat64", - "description": "Specifies a subnetwork to enable NAT64.", - "type": "object", - "properties": { - "name": { - "description": "URL for the subnetwork resource that will use NAT64.", - "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" - }, - "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." + "regionSslPolicies": { + "methods": { + "delete": { + "description": "Deletes the specified SSL policy. The SSL policy resource can be deleted\nonly if it is not in use by any TargetHttpsProxy or TargetSslProxy\nresources.", + "flatPath": "projects/{project}/regions/{region}/sslPolicies/{sslPolicy}", + "httpMethod": "DELETE", + "id": "compute.regionSslPolicies.delete", + "parameterOrder": [ + "project", + "region", + "sslPolicy" ], - "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" - }, - "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" - } - } - }, - "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" - } - }, - "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" - } - } - } - }, - "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" - ] + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(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,\nand comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" + } }, - "type": "string" - }, - "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" - ] + "path": "projects/{project}/regions/{region}/sslPolicies/{sslPolicy}", + "response": { + "$ref": "Operation" }, - "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" - }, - "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" + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "get": { + "description": "Lists all of the ordered rules present in a single specified policy.", + "flatPath": "projects/{project}/regions/{region}/sslPolicies/{sslPolicy}", + "httpMethod": "GET", + "id": "compute.regionSslPolicies.get", + "parameterOrder": [ + "project", + "region", + "sslPolicy" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "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" - } - } - } + "sslPolicy": { + "description": "Name of the SSL policy to update. The name must be 1-63 characters long,\nand 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" - } + }, + "path": "projects/{project}/regions/{region}/sslPolicies/{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" + ] }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the 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": { + "description": "Creates a new policy in the specified project and region using the data\nincluded in the request.", + "flatPath": "projects/{project}/regions/{region}/sslPolicies", + "httpMethod": "POST", + "id": "compute.regionSslPolicies.insert", + "parameterOrder": [ + "project", + "region" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/sslPolicies", + "request": { + "$ref": "SslPolicy" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "list": { + "description": "Lists all the SSL policies that have been configured for the specified\nproject and region.", + "flatPath": "projects/{project}/regions/{region}/sslPolicies", + "httpMethod": "GET", + "id": "compute.regionSslPolicies.list", + "parameterOrder": [ + "project", + "region" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/regions/{region}/sslPolicies", + "response": { + "$ref": "SslPoliciesList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "listAvailableFeatures": { + "description": "Lists all features that can be specified in the SSL policy when using\ncustom profile.", + "flatPath": "projects/{project}/regions/{region}/sslPolicies/listAvailableFeatures", + "httpMethod": "GET", + "id": "compute.regionSslPolicies.listAvailableFeatures", + "parameterOrder": [ + "project", + "region" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`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\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" } - } + }, + "path": "projects/{project}/regions/{region}/sslPolicies/listAvailableFeatures", + "response": { + "$ref": "SslPoliciesListAvailableFeaturesResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "unreachables": { - "description": "[Output Only] Unreachable resources.", - "type": "array", - "items": { - "type": "string" - } + "patch": { + "description": "Patches the specified SSL policy with the data included in the request.", + "flatPath": "projects/{project}/regions/{region}/sslPolicies/{sslPolicy}", + "httpMethod": "PATCH", + "id": "compute.regionSslPolicies.patch", + "parameterOrder": [ + "project", + "region", + "sslPolicy" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(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,\nand comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/sslPolicies/{sslPolicy}", + "request": { + "$ref": "SslPolicy" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] } } }, - "RoutersScopedList": { - "id": "RoutersScopedList", - "type": "object", - "properties": { - "routers": { - "description": "A list of routers contained in this scope.", - "type": "array", - "items": { - "$ref": "Router" - } + "regionTargetHttpProxies": { + "methods": { + "delete": { + "description": "Deletes the specified TargetHttpProxy resource.", + "flatPath": "projects/{project}/regions/{region}/targetHttpProxies/{targetHttpProxy}", + "httpMethod": "DELETE", + "id": "compute.regionTargetHttpProxies.delete", + "parameterOrder": [ + "project", + "region", + "targetHttpProxy" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "targetHttpProxy": { + "description": "Name of the TargetHttpProxy resource to delete.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/targetHttpProxies/{targetHttpProxy}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "get": { + "description": "Returns the specified TargetHttpProxy resource in the specified region.", + "flatPath": "projects/{project}/regions/{region}/targetHttpProxies/{targetHttpProxy}", + "httpMethod": "GET", + "id": "compute.regionTargetHttpProxies.get", + "parameterOrder": [ + "project", + "region", + "targetHttpProxy" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "targetHttpProxy": { + "description": "Name of the TargetHttpProxy resource to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/targetHttpProxies/{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" + ] + }, + "insert": { + "description": "Creates a TargetHttpProxy resource in the specified project and region\nusing the data included in the request.", + "flatPath": "projects/{project}/regions/{region}/targetHttpProxies", + "httpMethod": "POST", + "id": "compute.regionTargetHttpProxies.insert", + "parameterOrder": [ + "project", + "region" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "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" - } - } - } - }, - "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" + }, + "path": "projects/{project}/regions/{region}/targetHttpProxies", + "request": { + "$ref": "TargetHttpProxy" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "status": { - "description": "Status of the BGP peer: {UP, DOWN}", - "type": "string", - "enumDescriptions": [ - "", - "", - "" + "list": { + "description": "Retrieves the list of TargetHttpProxy resources available\nto the specified project in the specified region.", + "flatPath": "projects/{project}/regions/{region}/targetHttpProxies", + "httpMethod": "GET", + "id": "compute.regionTargetHttpProxies.list", + "parameterOrder": [ + "project", + "region" ], - "enum": [ - "DOWN", - "UNKNOWN", - "UP" + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/regions/{region}/targetHttpProxies", + "response": { + "$ref": "TargetHttpProxyList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "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.", - "" + "setUrlMap": { + "description": "Changes the URL map for TargetHttpProxy.", + "flatPath": "projects/{project}/regions/{region}/targetHttpProxies/{targetHttpProxy}/setUrlMap", + "httpMethod": "POST", + "id": "compute.regionTargetHttpProxies.setUrlMap", + "parameterOrder": [ + "project", + "region", + "targetHttpProxy" ], - "enum": [ - "IPV4_PEER_ON_IPV6_ONLY_CONNECTION", - "IPV6_PEER_ON_IPV4_ONLY_CONNECTION", - "MD5_AUTH_INTERNAL_PROBLEM", - "STATUS_REASON_UNSPECIFIED" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "targetHttpProxy": { + "description": "Name of the TargetHttpProxy to set a URL map for.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/targetHttpProxies/{targetHttpProxy}/setUrlMap", + "request": { + "$ref": "UrlMapReference" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] - }, - "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": [ - "", - "", - "", - "", - "" + "regionTargetHttpsProxies": { + "methods": { + "delete": { + "description": "Deletes the specified TargetHttpsProxy resource.", + "flatPath": "projects/{project}/regions/{region}/targetHttpsProxies/{targetHttpsProxy}", + "httpMethod": "DELETE", + "id": "compute.regionTargetHttpsProxies.delete", + "parameterOrder": [ + "project", + "region", + "targetHttpsProxy" ], - "enum": [ - "ADMIN_DOWN", - "DOWN", - "INIT", - "STATE_UNSPECIFIED", - "UP" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "targetHttpsProxy": { + "description": "Name of the TargetHttpsProxy resource to delete.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/targetHttpsProxies/{targetHttpsProxy}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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": [ - "", - "", - "", - "", - "", - "", - "", - "", - "", - "" + "get": { + "description": "Returns the specified TargetHttpsProxy resource in the specified region.", + "flatPath": "projects/{project}/regions/{region}/targetHttpsProxies/{targetHttpsProxy}", + "httpMethod": "GET", + "id": "compute.regionTargetHttpsProxies.get", + "parameterOrder": [ + "project", + "region", + "targetHttpsProxy" ], - "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" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "targetHttpsProxy": { + "description": "Name of the TargetHttpsProxy resource to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/targetHttpsProxies/{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" ] }, - "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" + "insert": { + "description": "Creates a TargetHttpsProxy resource in the specified project and region\nusing the data included in the request.", + "flatPath": "projects/{project}/regions/{region}/targetHttpsProxies", + "httpMethod": "POST", + "id": "compute.regionTargetHttpsProxies.insert", + "parameterOrder": [ + "project", + "region" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/targetHttpsProxies", + "request": { + "$ref": "TargetHttpsProxy" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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": [ - "", - "", - "" + "list": { + "description": "Retrieves the list of TargetHttpsProxy resources available\nto the specified project in the specified region.", + "flatPath": "projects/{project}/regions/{region}/targetHttpsProxies", + "httpMethod": "GET", + "id": "compute.regionTargetHttpsProxies.list", + "parameterOrder": [ + "project", + "region" ], - "enum": [ - "ACTIVE", - "DISABLED", - "PASSIVE" + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/regions/{region}/targetHttpsProxies", + "response": { + "$ref": "TargetHttpsProxyList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "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": [ - "", - "", - "", - "", - "", - "", - "", - "", - "", - "" + "patch": { + "description": "Patches the specified regional TargetHttpsProxy resource with the data\nincluded in the request. This method supports PATCH\nsemantics and usesJSON merge\npatch format and processing rules.", + "flatPath": "projects/{project}/regions/{region}/targetHttpsProxies/{targetHttpsProxy}", + "httpMethod": "PATCH", + "id": "compute.regionTargetHttpsProxies.patch", + "parameterOrder": [ + "project", + "region", + "targetHttpsProxy" ], - "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" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "targetHttpsProxy": { + "description": "Name of the TargetHttpsProxy resource to patch.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/targetHttpsProxies/{targetHttpsProxy}", + "request": { + "$ref": "TargetHttpsProxy" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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": [ - "", - "", - "", - "", - "" + "setSslCertificates": { + "description": "Replaces SslCertificates for TargetHttpsProxy.", + "flatPath": "projects/{project}/regions/{region}/targetHttpsProxies/{targetHttpsProxy}/setSslCertificates", + "httpMethod": "POST", + "id": "compute.regionTargetHttpsProxies.setSslCertificates", + "parameterOrder": [ + "project", + "region", + "targetHttpsProxy" ], - "enum": [ - "ADMIN_DOWN", - "DOWN", - "INIT", - "STATE_UNSPECIFIED", - "UP" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "targetHttpsProxy": { + "description": "Name of the TargetHttpsProxy resource to set an\nSslCertificates resource for.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/targetHttpsProxies/{targetHttpsProxy}/setSslCertificates", + "request": { + "$ref": "RegionTargetHttpsProxiesSetSslCertificatesRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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" + "setUrlMap": { + "description": "Changes the URL map for TargetHttpsProxy.", + "flatPath": "projects/{project}/regions/{region}/targetHttpsProxies/{targetHttpsProxy}/setUrlMap", + "httpMethod": "POST", + "id": "compute.regionTargetHttpsProxies.setUrlMap", + "parameterOrder": [ + "project", + "region", + "targetHttpsProxy" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "targetHttpsProxy": { + "description": "Name of the TargetHttpsProxy to set a URL map for.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/targetHttpsProxies/{targetHttpsProxy}/setUrlMap", + "request": { + "$ref": "UrlMapReference" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] } } }, - "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.", - "" + "regionTargetTcpProxies": { + "methods": { + "delete": { + "description": "Deletes the specified TargetTcpProxy resource.", + "flatPath": "projects/{project}/regions/{region}/targetTcpProxies/{targetTcpProxy}", + "httpMethod": "DELETE", + "id": "compute.regionTargetTcpProxies.delete", + "parameterOrder": [ + "project", + "region", + "targetTcpProxy" ], - "enum": [ - "LOOPBACK", - "RECEIVE", - "TRANSMIT", - "TYPE_UNSPECIFIED" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "targetTcpProxy": { + "description": "Name of the TargetTcpProxy resource to delete.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/targetTcpProxies/{targetTcpProxy}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "duration": { - "description": "From how long ago in the past these intervals were observed.", - "type": "string", - "enumDescriptions": [ - "", - "", - "From BfdSession object creation time.", - "" + "get": { + "description": "Returns the specified TargetTcpProxy resource.", + "flatPath": "projects/{project}/regions/{region}/targetTcpProxies/{targetTcpProxy}", + "httpMethod": "GET", + "id": "compute.regionTargetTcpProxies.get", + "parameterOrder": [ + "project", + "region", + "targetTcpProxy" ], - "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" - } - } - }, - "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" - } - }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "targetTcpProxy": { + "description": "Name of the TargetTcpProxy resource to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/targetTcpProxies/{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" + ] + }, + "insert": { + "description": "Creates a TargetTcpProxy resource in the specified project and region using\nthe data included in the request.", + "flatPath": "projects/{project}/regions/{region}/targetTcpProxies", + "httpMethod": "POST", + "id": "compute.regionTargetTcpProxies.insert", + "parameterOrder": [ + "project", + "region" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "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" - } - }, - "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" - } - }, - "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" + }, + "path": "projects/{project}/regions/{region}/targetTcpProxies", + "request": { + "$ref": "TargetTcpProxy" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "ruleMappings": { - "description": "Information about mappings provided by rules in this NAT.", - "type": "array", - "items": { - "$ref": "VmEndpointNatMappingsInterfaceNatMappingsNatRuleMappings" - } + "list": { + "description": "Retrieves a list of TargetTcpProxy resources\navailable to the specified project in a given region.", + "flatPath": "projects/{project}/regions/{region}/targetTcpProxies", + "httpMethod": "GET", + "id": "compute.regionTargetTcpProxies.list", + "parameterOrder": [ + "project", + "region" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/regions/{region}/targetTcpProxies", + "response": { + "$ref": "TargetTcpProxyList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] } } }, - "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" + "regionUrlMaps": { + "methods": { + "delete": { + "description": "Deletes the specified UrlMap resource.", + "flatPath": "projects/{project}/regions/{region}/urlMaps/{urlMap}", + "httpMethod": "DELETE", + "id": "compute.regionUrlMaps.delete", + "parameterOrder": [ + "project", + "region", + "urlMap" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "begin_interface: MixerMutationRequestBuilder\nRequest ID to support idempotency.", + "location": "query", + "type": "string" + }, + "urlMap": { + "description": "Name of the UrlMap resource to delete.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/urlMaps/{urlMap}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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" - } + "get": { + "description": "Returns the specified UrlMap resource.", + "flatPath": "projects/{project}/regions/{region}/urlMaps/{urlMap}", + "httpMethod": "GET", + "id": "compute.regionUrlMaps.get", + "parameterOrder": [ + "project", + "region", + "urlMap" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "urlMap": { + "description": "Name of the UrlMap resource to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/urlMaps/{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" + ] }, - "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" - } + "insert": { + "description": "Creates a UrlMap resource in the specified project using\nthe data included in the request.", + "flatPath": "projects/{project}/regions/{region}/urlMaps", + "httpMethod": "POST", + "id": "compute.regionUrlMaps.insert", + "parameterOrder": [ + "project", + "region" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "begin_interface: MixerMutationRequestBuilder\nRequest ID to support idempotency.", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/urlMaps", + "request": { + "$ref": "UrlMap" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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" + "list": { + "description": "Retrieves the list of UrlMap resources available to the specified\nproject in the specified region.", + "flatPath": "projects/{project}/regions/{region}/urlMaps", + "httpMethod": "GET", + "id": "compute.regionUrlMaps.list", + "parameterOrder": [ + "project", + "region" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/regions/{region}/urlMaps", + "response": { + "$ref": "UrlMapList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "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" + "patch": { + "description": "Patches the specified UrlMap resource with the data included in the\nrequest. This method supportsPATCH\nsemantics and usesJSON merge\npatch format and processing rules.", + "flatPath": "projects/{project}/regions/{region}/urlMaps/{urlMap}", + "httpMethod": "PATCH", + "id": "compute.regionUrlMaps.patch", + "parameterOrder": [ + "project", + "region", + "urlMap" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "begin_interface: MixerMutationRequestBuilder\nRequest ID to support idempotency.", + "location": "query", + "type": "string" + }, + "urlMap": { + "description": "Name of the UrlMap resource to patch.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/urlMaps/{urlMap}", + "request": { + "$ref": "UrlMap" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "usage": { - "description": "Specifies whether NAT IP is currently serving at least one endpoint or not.", - "type": "string", - "enumDescriptions": [ - "", - "" + "update": { + "description": "Updates the specified UrlMap resource with the data included in the\nrequest.", + "flatPath": "projects/{project}/regions/{region}/urlMaps/{urlMap}", + "httpMethod": "PUT", + "id": "compute.regionUrlMaps.update", + "parameterOrder": [ + "project", + "region", + "urlMap" ], - "enum": [ - "IN_USE", - "UNUSED" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "begin_interface: MixerMutationRequestBuilder\nRequest ID to support idempotency.", + "location": "query", + "type": "string" + }, + "urlMap": { + "description": "Name of the UrlMap resource to update.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/urlMaps/{urlMap}", + "request": { + "$ref": "UrlMap" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "mode": { - "description": "Specifies whether NAT IP is auto or manual.", - "type": "string", - "enumDescriptions": [ - "", - "" + "validate": { + "description": "Runs static validation for the UrlMap. In particular, the tests of the\nprovided UrlMap will be run. Calling this method does NOT create the\nUrlMap.", + "flatPath": "projects/{project}/regions/{region}/urlMaps/{urlMap}/validate", + "httpMethod": "POST", + "id": "compute.regionUrlMaps.validate", + "parameterOrder": [ + "project", + "region", + "urlMap" ], - "enum": [ - "AUTO", - "MANUAL" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "urlMap": { + "description": "Name of the UrlMap resource to be validated as.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/urlMaps/{urlMap}/validate", + "request": { + "$ref": "RegionUrlMapsValidateRequest" + }, + "response": { + "$ref": "UrlMapsValidateResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] } } }, - "RoutersPreviewResponse": { - "id": "RoutersPreviewResponse", - "type": "object", - "properties": { - "resource": { - "description": "Preview of given router.", - "$ref": "Router" - } - } - }, - "RoutePolicy": { - "id": "RoutePolicy", - "type": "object", - "properties": { - "name": { - "description": "Route Policy name, which must be a resource ID segment and unique within all the router's Route Policies. Name should conform to RFC1035.", - "type": "string" - }, - "type": { - "type": "string", - "enumDescriptions": [ - "The Route Policy is an Export Policy.", - "The Route Policy is an Import Policy." + "regionZones": { + "methods": { + "list": { + "description": "Retrieves the list of Zone resources under the specific region available to\nthe specified project.", + "flatPath": "projects/{project}/regions/{region}/zones", + "httpMethod": "GET", + "id": "compute.regionZones.list", + "parameterOrder": [ + "project", + "region" ], - "enum": [ - "ROUTE_POLICY_TYPE_EXPORT", - "ROUTE_POLICY_TYPE_IMPORT" + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/regions/{region}/zones", + "response": { + "$ref": "ZoneList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] - }, - "terms": { - "description": "List of terms (the order in the list is not important, they are evaluated in order of priority). Order of policies is not retained and might change when getting policy later.", - "type": "array", - "items": { - "$ref": "RoutePolicyPolicyTerm" - } - }, - "fingerprint": { - "description": "A fingerprint for the Route Policy being applied to this Router, which is essentially a hash of the Route Policy used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update Route Policy. You must always provide an up-to-date fingerprint hash in order to update or change labels. To see the latest fingerprint, make a getRoutePolicy() request to retrieve a Route Policy.", - "type": "string", - "format": "byte" - }, - "description": { - "description": "An optional description of route policy.", - "type": "string" } } }, - "RoutePolicyPolicyTerm": { - "id": "RoutePolicyPolicyTerm", - "type": "object", - "properties": { - "priority": { - "description": "The evaluation priority for this term, which must be between 0 (inclusive) and 2^31 (exclusive), and unique within the list.", - "type": "integer", - "format": "int32" - }, - "match": { - "description": "CEL expression evaluated against a route to determine if this term applies. When not set, the term applies to all routes.", - "$ref": "Expr" + "regions": { + "methods": { + "get": { + "description": "Returns the specified Region resource.\n\nTo decrease latency for this method, you can optionally omit any unneeded\ninformation from the response by using a field mask. This practice is\nespecially recommended for unused quota information (the `quotas` field).\nTo exclude one or more fields, set your request's `fields` query parameter\nto only include the fields you need. For example, to only include the `id`\nand `selfLink` fields, add the query parameter `?fields=id,selfLink` to\nyour request.\n\nThis method fails if the quota information is unavailable for the region\nand if the organization policy constraint\ncompute.requireBasicQuotaInResponse is enforced. This\nconstraint, when enforced, disables the fail-open behaviour when quota\ninformation (the `items.quotas` field) is unavailable for the region.\nIt is recommended to use the default setting\nfor the constraint unless your application requires the fail-closed\nbehaviour for this method.", + "flatPath": "projects/{project}/regions/{region}", + "httpMethod": "GET", + "id": "compute.regions.get", + "parameterOrder": [ + "project", + "region" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region resource to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{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" + ] }, - "actions": { - "description": "CEL expressions to evaluate to modify a route when this term matches.", - "type": "array", - "items": { - "$ref": "Expr" - } - } - } - }, - "RoutersGetRoutePolicyResponse": { - "id": "RoutersGetRoutePolicyResponse", - "type": "object", - "properties": { - "resource": { - "$ref": "RoutePolicy" + "list": { + "description": "Retrieves the list of region resources available to the specified project.\n\nTo decrease latency for this method, you can optionally omit any unneeded\ninformation from the response by using a field mask. This practice is\nespecially recommended for unused quota information\n(the `items.quotas` field).\nTo exclude one or more fields, set your request's `fields` query parameter\nto only include the fields you need. For example, to only include the `id`\nand `selfLink` fields, add the query parameter `?fields=id,selfLink` to\nyour request.\n\nThis method fails if the quota information is unavailable for the region\nand if the organization policy constraint\ncompute.requireBasicQuotaInResponse is enforced. This\nconstraint, when enforced, disables the fail-open behaviour when quota\ninformation (the `items.quotas` field) is unavailable for the region.\nIt is recommended to use the default setting\nfor the constraint unless your application requires the fail-closed\nbehaviour for this method.", + "flatPath": "projects/{project}/regions", + "httpMethod": "GET", + "id": "compute.regions.list", + "parameterOrder": [ + "project" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/regions", + "response": { + "$ref": "RegionList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] } } }, - "RoutersListRoutePolicies": { - "id": "RoutersListRoutePolicies", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always compute#routersListRoutePolicies for lists of route policies.", - "default": "compute#routersListRoutePolicies", - "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 route policies.", - "type": "array", - "items": { - "$ref": "RoutePolicy" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the 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" + "reliabilityRisks": { + "methods": { + "get": { + "description": "Returns the specified ReliabilityRisk resource.", + "flatPath": "projects/{project}/global/reliabilityRisks/{reliabilityRisk}", + "httpMethod": "GET", + "id": "compute.reliabilityRisks.get", + "parameterOrder": [ + "project", + "reliabilityRisk" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "reliabilityRisk": { + "description": "Name of the ReliabilityRisk resource to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/reliabilityRisks/{reliabilityRisk}", + "response": { + "$ref": "ReliabilityRisk" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "list": { + "description": "Retrieves the list of reliabilityRisks available in the specified project.", + "flatPath": "projects/{project}/global/reliabilityRisks", + "httpMethod": "GET", + "id": "compute.reliabilityRisks.list", + "parameterOrder": [ + "project" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`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\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" } - } - }, - "etag": { - "type": "string" - }, - "unreachables": { - "description": "[Output Only] Unreachable resources.", - "type": "array", - "items": { - "type": "string" - } + }, + "path": "projects/{project}/global/reliabilityRisks", + "response": { + "$ref": "ReliabilityRisksListResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] } } }, - "RoutersListBgpRoutes": { - "id": "RoutersListBgpRoutes", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always compute#routersListBgpRoutes for lists of bgp routes.", - "default": "compute#routersListBgpRoutes", - "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 bgp routes.", - "type": "array", - "items": { - "$ref": "BgpRoute" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the 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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "reservationBlocks": { + "methods": { + "get": { + "description": "Retrieves information about the specified reservation block.", + "flatPath": "projects/{project}/zones/{zone}/reservations/{reservation}/reservationBlocks/{reservationBlock}", + "httpMethod": "GET", + "id": "compute.reservationBlocks.get", + "parameterOrder": [ + "project", + "zone", + "reservation", + "reservationBlock" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "reservation": { + "description": "The name of the reservation.\nName should conform to RFC1035 or be a resource ID.", + "location": "path", + "required": true, + "type": "string" + }, + "reservationBlock": { + "description": "The name of the reservation block.\nName should conform to RFC1035 or be a resource ID.", + "location": "path", + "required": true, + "type": "string" + }, + "view": { + "description": "View of the Block.", + "enum": [ + "BASIC", + "BLOCK_VIEW_UNSPECIFIED", + "FULL" + ], + "enumDescriptions": [ + "This view includes basic information about the reservation block", + "The default / unset value. The API will default to the BASIC view.", + "Includes detailed topology view." + ], + "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": "Name of the zone for this request. Zone name should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" } - } - }, - "etag": { - "type": "string" - }, - "unreachables": { - "description": "[Output Only] Unreachable resources.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "BgpRoute": { - "id": "BgpRoute", - "type": "object", - "properties": { - "destination": { - "description": "[Output only] Destination IP range for the route, in human-readable CIDR format", - "$ref": "BgpRouteNetworkLayerReachabilityInformation" - }, - "asPaths": { - "description": "[Output only] AS-PATH for the route", - "type": "array", - "items": { - "$ref": "BgpRouteAsPath" - } - }, - "communities": { - "description": "[Output only] BGP communities in human-readable A:B format.", - "type": "array", - "items": { - "type": "string" - } + }, + "path": "projects/{project}/zones/{zone}/reservations/{reservation}/reservationBlocks/{reservationBlock}", + "response": { + "$ref": "ReservationBlocksGetResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "origin": { - "description": "[Output only] BGP origin (EGP, IGP or INCOMPLETE)", - "type": "string", - "enumDescriptions": [ - "", - "", - "" + "getIamPolicy": { + "description": "Gets the access control policy for a resource. May be empty if no such\npolicy or resource exists.", + "flatPath": "projects/{project}/zones/{zone}/reservations/{parentResource}/reservationBlocks/{resource}/getIamPolicy", + "httpMethod": "GET", + "id": "compute.reservationBlocks.getIamPolicy", + "parameterOrder": [ + "project", + "zone", + "parentResource", + "resource" ], - "enum": [ - "BGP_ORIGIN_EGP", - "BGP_ORIGIN_IGP", - "BGP_ORIGIN_INCOMPLETE" + "parameters": { + "optionsRequestedPolicyVersion": { + "description": "Requested IAM Policy version.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "parentResource": { + "description": "Name or id of parent resource of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-zA-Z0-9/]{0,255}[a-zA-Z0-9])?", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/reservations/{parentResource}/reservationBlocks/{resource}/getIamPolicy", + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "med": { - "description": "[Output only] BGP multi-exit discriminator", - "type": "integer", - "format": "uint32" - } - } - }, - "BgpRouteNetworkLayerReachabilityInformation": { - "id": "BgpRouteNetworkLayerReachabilityInformation", - "description": "Network Layer Reachability Information (NLRI) for a route.", - "type": "object", - "properties": { - "prefix": { - "description": "Human readable CIDR notation for a prefix. E.g. 10.42.0.0/16.", - "type": "string" - }, - "pathId": { - "description": "If the BGP session supports multiple paths (RFC 7911), the path identifier for this route.", - "type": "integer", - "format": "uint32" - } - } - }, - "BgpRouteAsPath": { - "id": "BgpRouteAsPath", - "type": "object", - "properties": { - "type": { - "description": "[Output only] Type of AS-PATH segment (SEQUENCE or SET)", - "type": "string", - "enumDescriptions": [ - "", - "" + "list": { + "description": "Retrieves a list of reservation blocks under a single reservation.", + "flatPath": "projects/{project}/zones/{zone}/reservations/{reservation}/reservationBlocks", + "httpMethod": "GET", + "id": "compute.reservationBlocks.list", + "parameterOrder": [ + "project", + "zone", + "reservation" ], - "enum": [ - "AS_PATH_TYPE_SEQUENCE", - "AS_PATH_TYPE_SET" + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "required": true, + "type": "string" + }, + "reservation": { + "description": "The name of the reservation.\nName should conform to RFC1035 or be a resource ID.", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "zone": { + "description": "Name of the zone for this request. Zone name should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/reservations/{reservation}/reservationBlocks", + "response": { + "$ref": "ReservationBlocksListResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "asns": { - "description": "[Output only] ASNs in the path segment. When type is SEQUENCE, these are ordered.", - "type": "array", - "items": { - "type": "integer", - "format": "int32" - } - } - } - }, - "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" - }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "performMaintenance": { + "description": "Allows customers to perform maintenance on a reservation block", + "flatPath": "projects/{project}/zones/{zone}/reservations/{reservation}/reservationBlocks/{reservationBlock}/performMaintenance", + "httpMethod": "POST", + "id": "compute.reservationBlocks.performMaintenance", + "parameterOrder": [ + "project", + "zone", + "reservation", + "reservationBlock" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(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": "The name of the reservation.\nName should conform to RFC1035 or be a resource ID.", + "location": "path", + "required": true, + "type": "string" + }, + "reservationBlock": { + "description": "The name of the reservation block.\nName should conform to RFC1035 or be a resource ID.", + "location": "path", + "required": true, + "type": "string" + }, + "zone": { + "description": "Name of the zone for this request. Zone name should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" } - } + }, + "path": "projects/{project}/zones/{zone}/reservations/{reservation}/reservationBlocks/{reservationBlock}/performMaintenance", + "request": { + "$ref": "ReservationsBlocksPerformMaintenanceRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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" - } + "setIamPolicy": { + "description": "Sets the access control policy on the specified resource.\nReplaces any existing policy.", + "flatPath": "projects/{project}/zones/{zone}/reservations/{parentResource}/reservationBlocks/{resource}/setIamPolicy", + "httpMethod": "POST", + "id": "compute.reservationBlocks.setIamPolicy", + "parameterOrder": [ + "project", + "zone", + "parentResource", + "resource" + ], + "parameters": { + "parentResource": { + "description": "Name or id of parent resource of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-zA-Z0-9/]{0,255}[a-zA-Z0-9])?", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/reservations/{parentResource}/reservationBlocks/{resource}/setIamPolicy", + "request": { + "$ref": "ZoneSetNestedPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource.", + "flatPath": "projects/{project}/zones/{zone}/reservations/{parentResource}/reservationBlocks/{resource}/testIamPermissions", + "httpMethod": "POST", + "id": "compute.reservationBlocks.testIamPermissions", + "parameterOrder": [ + "project", + "zone", + "parentResource", + "resource" + ], + "parameters": { + "parentResource": { + "description": "Name or id of parent resource of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-zA-Z0-9/]{0,255}[a-zA-Z0-9])?", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "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": [ - "", - "", - "" - ], - "enum": [ - "ACCEPT_AUTOMATIC", - "ACCEPT_MANUAL", - "CONNECTION_PREFERENCE_UNSPECIFIED" + "path": "projects/{project}/zones/{zone}/reservations/{parentResource}/reservationBlocks/{resource}/testIamPermissions", + "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" ] - }, - "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.", - "" + "reservationSlots": { + "methods": { + "get": { + "description": "Retrieves information about the specified reservation slot.", + "flatPath": "projects/{project}/zones/{zone}/reservations/{reservationsId}/reservationBlocks/{reservationBlocksId}/reservationSubBlocks/{reservationSubBlocksId}/reservationSlots/{reservationSlot}", + "httpMethod": "GET", + "id": "compute.reservationSlots.get", + "parameterOrder": [ + "project", + "zone", + "parentName", + "reservationSlot" ], - "enum": [ - "ACCEPTED", - "CLOSED", - "NEEDS_ATTENTION", - "PENDING", - "REJECTED", - "STATUS_UNSPECIFIED" + "parameters": { + "parentName": { + "description": "The name of the parent reservation and parent block, formatted as\nreservations/{reservation_name}/reservationBlocks/{reservation_block_name}/reservationSubBlocks/{reservation_sub_block_name}", + "location": "path", + "pattern": "reservations/([a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19})/reservationBlocks/([a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19})/reservationSubBlocks/([a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19})", + "required": true, + "type": "string" + }, + "project": { + "description": "The project ID for this request.", + "location": "path", + "required": true, + "type": "string" + }, + "reservationSlot": { + "description": "The name of the reservation slot, formatted as RFC1035 or a resource ID\nnumber.", + "location": "path", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request, formatted as RFC1035.", + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/{+parentName}/reservationSlots/{reservationSlot}", + "response": { + "$ref": "ReservationSlotsGetResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "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" - }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "getVersion": { + "description": "Allows customers to get SBOM versions of a reservation slot.", + "flatPath": "projects/{project}/zones/{zone}/reservations/{reservationsId}/reservationBlocks/{reservationBlocksId}/reservationSubBlocks/{reservationSubBlocksId}/reservationSlots/{reservationSlot}/getVersion", + "httpMethod": "POST", + "id": "compute.reservationSlots.getVersion", + "parameterOrder": [ + "project", + "zone", + "parentName", + "reservationSlot" + ], + "parameters": { + "parentName": { + "description": "The name of the parent reservation and parent block. In the format of\nreservations/{reservation_name}/reservationBlocks/{reservation_block_name}/reservationSubBlocks/{reservation_sub_block_name}", + "location": "path", + "pattern": "reservations/([a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19})/reservationBlocks/([a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19})/reservationSubBlocks/([a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19})", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for 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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "reservationSlot": { + "description": "The name of the reservation slot.\nName should conform to RFC1035 or be a resource ID.", + "location": "path", + "required": true, + "type": "string" + }, + "zone": { + "description": "Name of the zone for this request. Zone name should conform to RFC1035.", + "location": "path", + "required": true, + "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.", - "" - ], - "enum": [ - "LOCAL_REGION", - "NEAREST_MULTI_REGION", - "SPECIFIC_LOCATIONS", - "STORAGE_LOCATION_POLICY_UNSPECIFIED" + }, + "path": "projects/{project}/zones/{zone}/{+parentName}/reservationSlots/{reservationSlot}/getVersion", + "request": { + "$ref": "ReservationSlotsGetVersionRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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" - } - } - }, - "SslCertificateList": { - "id": "SslCertificateList", - "description": "Contains a list of SslCertificate resources.", - "type": "object", - "properties": { - "kind": { - "description": "Type of resource.", - "default": "compute#sslCertificateList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of SslCertificate resources.", - "type": "array", - "items": { - "$ref": "SslCertificate" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the 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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "list": { + "description": "Retrieves a list of reservation slots under a single reservation.", + "flatPath": "projects/{project}/zones/{zone}/reservations/{reservationsId}/reservationBlocks/{reservationBlocksId}/reservationSubBlocks/{reservationSubBlocksId}/reservationSlots", + "httpMethod": "GET", + "id": "compute.reservationSlots.list", + "parameterOrder": [ + "project", + "zone", + "parentName" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`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\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "parentName": { + "description": "The name of the parent reservation and parent block, formatted as\nreservations/{reservation_name}/reservationBlocks/{reservation_block_name}/reservationSubBlocks/{reservation_sub_block_name}", + "location": "path", + "pattern": "reservations/([a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19})/reservationBlocks/([a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19})/reservationSubBlocks/([a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19})", + "required": true, + "type": "string" + }, + "project": { + "description": "The project ID for this request.", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "zone": { + "description": "The name of the zone for this request, formatted as RFC1035.", + "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" + }, + "path": "projects/{project}/zones/{zone}/{+parentName}/reservationSlots", + "response": { + "$ref": "ReservationSlotsListResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "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.", - "" + "update": { + "description": "Update a reservation slot in the specified sub-block.", + "flatPath": "projects/{project}/zones/{zone}/reservations/{reservationsId}/reservationBlocks/{reservationBlocksId}/reservationSubBlocks/{reservationSubBlocksId}/reservationSlots/{reservationSlot}", + "httpMethod": "POST", + "id": "compute.reservationSlots.update", + "parameterOrder": [ + "project", + "zone", + "parentName", + "reservationSlot" ], - "enum": [ - "MANAGED", - "SELF_MANAGED", - "TYPE_UNSPECIFIED" + "parameters": { + "parentName": { + "description": "The name of the sub-block resource.", + "location": "path", + "pattern": "reservations/([a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19})/reservationBlocks/([a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19})/reservationSubBlocks/([a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19})", + "required": true, + "type": "string" + }, + "project": { + "description": "The project ID for this request.", + "location": "path", + "required": true, + "type": "string" + }, + "reservationSlot": { + "description": "The name of the slot resource.", + "location": "path", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "The fields to be updated as part of this request.", + "format": "google-fieldmask", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request, formatted as RFC1035.", + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/{+parentName}/reservationSlots/{reservationSlot}", + "request": { + "$ref": "ReservationSlot" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] - }, - "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." + "reservationSubBlocks": { + "methods": { + "get": { + "description": "Retrieves information about the specified reservation subBlock.", + "flatPath": "projects/{project}/zones/{zone}/reservations/{reservationsId}/reservationBlocks/{reservationBlocksId}/reservationSubBlocks/{reservationSubBlock}", + "httpMethod": "GET", + "id": "compute.reservationSubBlocks.get", + "parameterOrder": [ + "project", + "zone", + "parentName", + "reservationSubBlock" ], - "enum": [ - "ACTIVE", - "MANAGED_CERTIFICATE_STATUS_UNSPECIFIED", - "PROVISIONING", - "PROVISIONING_FAILED", - "PROVISIONING_FAILED_PERMANENTLY", - "RENEWAL_FAILED" + "parameters": { + "parentName": { + "description": "The name of the parent reservation and parent block. In the format of\nreservations/{reservation_name}/reservationBlocks/{reservation_block_name}", + "location": "path", + "pattern": "^reservations/[^/]+/reservationBlocks/[^/]+$", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "required": true, + "type": "string" + }, + "reservationSubBlock": { + "description": "The name of the reservation subBlock.\nName should conform to RFC1035 or be a resource ID.", + "location": "path", + "required": true, + "type": "string" + }, + "view": { + "description": "View of the subBlock.", + "enum": [ + "SUB_BLOCK_VIEW_BASIC", + "SUB_BLOCK_VIEW_FULL", + "SUB_BLOCK_VIEW_UNSPECIFIED" + ], + "enumDescriptions": [ + "This view includes basic information about the reservation sub block", + "Includes detailed topology view.", + "The default / unset value. The API will default to the BASIC view." + ], + "location": "query", + "type": "string" + }, + "zone": { + "description": "Name of the zone for this request. Zone name should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/{+parentName}/reservationSubBlocks/{reservationSubBlock}", + "response": { + "$ref": "ReservationSubBlocksGetResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "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" - } + "getIamPolicy": { + "description": "Gets the access control policy for a resource. May be empty if no such\npolicy or resource exists.", + "flatPath": "projects/{project}/zones/{zone}/reservations/{reservationsId}/reservationBlocks/{reservationBlocksId}/reservationSubBlocks/{resource}/getIamPolicy", + "httpMethod": "GET", + "id": "compute.reservationSubBlocks.getIamPolicy", + "parameterOrder": [ + "project", + "zone", + "parentResource", + "resource" + ], + "parameters": { + "optionsRequestedPolicyVersion": { + "description": "Requested IAM Policy version.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "parentResource": { + "description": "Name or id of parent resource of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-zA-Z0-9/]{0,255}[a-zA-Z0-9])?", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/{+parentResource}/reservationSubBlocks/{resource}/getIamPolicy", + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" + "getVersion": { + "description": "Allows customers to get SBOM versions of a reservation subBlock.", + "flatPath": "projects/{project}/zones/{zone}/reservations/{reservationsId}/reservationBlocks/{reservationBlocksId}/reservationSubBlocks/{reservationSubBlock}/getVersion", + "httpMethod": "POST", + "id": "compute.reservationSubBlocks.getVersion", + "parameterOrder": [ + "project", + "zone", + "parentName", + "reservationSubBlock" + ], + "parameters": { + "parentName": { + "description": "The name of the parent reservation and parent block. In the format of\nreservations/{reservation_name}/reservationBlocks/{reservation_block_name}", + "location": "path", + "pattern": "^reservations/[^/]+/reservationBlocks/[^/]+$", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "reservationSubBlock": { + "description": "The name of the reservation subBlock.\nName should conform to RFC1035 or be a resource ID.", + "location": "path", + "required": true, + "type": "string" + }, + "zone": { + "description": "Name of the zone for this request. Zone name should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/{+parentName}/reservationSubBlocks/{reservationSubBlock}/getVersion", + "request": { + "$ref": "ReservationSubBlocksGetVersionRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "list": { + "description": "Retrieves a list of reservation subBlocks under a single reservation.", + "flatPath": "projects/{project}/zones/{zone}/reservations/{reservationsId}/reservationBlocks/{reservationBlocksId}/reservationSubBlocks", + "httpMethod": "GET", + "id": "compute.reservationSubBlocks.list", + "parameterOrder": [ + "project", + "zone", + "parentName" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "parentName": { + "description": "The name of the parent reservation and parent block. In the format of\nreservations/{reservation_name}/reservationBlocks/{reservation_block_name}", + "location": "path", + "pattern": "^reservations/[^/]+/reservationBlocks/[^/]+$", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "zone": { + "description": "Name of the zone for this request. Zone name should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/{+parentName}/reservationSubBlocks", + "response": { + "$ref": "ReservationSubBlocksListResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "performMaintenance": { + "description": "Allows customers to perform maintenance on a reservation subBlock", + "flatPath": "projects/{project}/zones/{zone}/reservations/{reservationsId}/reservationBlocks/{reservationBlocksId}/reservationSubBlocks/{reservationSubBlock}/performMaintenance", + "httpMethod": "POST", + "id": "compute.reservationSubBlocks.performMaintenance", + "parameterOrder": [ + "project", + "zone", + "parentName", + "reservationSubBlock" + ], + "parameters": { + "parentName": { + "description": "The name of the parent reservation and parent block. In the format of\nreservations/{reservation_name}/reservationBlocks/{reservation_block_name}", + "location": "path", + "pattern": "^reservations/[^/]+/reservationBlocks/[^/]+$", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(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" - } - } - } + "reservationSubBlock": { + "description": "The name of the reservation subBlock.\nName should conform to RFC1035 or be a resource ID.", + "location": "path", + "required": true, + "type": "string" + }, + "zone": { + "description": "Name of the zone for this request. Zone name should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" } - } + }, + "path": "projects/{project}/zones/{zone}/{+parentName}/reservationSubBlocks/{reservationSubBlock}/performMaintenance", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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" - } + "reportFaulty": { + "description": "Allows customers to report a faulty subBlock.", + "flatPath": "projects/{project}/zones/{zone}/reservations/{reservationsId}/reservationBlocks/{reservationBlocksId}/reservationSubBlocks/{reservationSubBlock}/reportFaulty", + "httpMethod": "POST", + "id": "compute.reservationSubBlocks.reportFaulty", + "parameterOrder": [ + "project", + "zone", + "parentName", + "reservationSubBlock" + ], + "parameters": { + "parentName": { + "description": "The name of the parent reservation and parent block. In the format of\nreservations/{reservation_name}/reservationBlocks/{reservation_block_name}", + "location": "path", + "pattern": "^reservations/[^/]+/reservationBlocks/[^/]+$", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "reservationSubBlock": { + "description": "The name of the reservation subBlock.\nName should conform to RFC1035 or be a resource ID.", + "location": "path", + "required": true, + "type": "string" + }, + "zone": { + "description": "Name of the zone for this request. Zone name should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/{+parentName}/reservationSubBlocks/{reservationSubBlock}/reportFaulty", + "request": { + "$ref": "ReservationSubBlocksReportFaultyRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "setIamPolicy": { + "description": "Sets the access control policy on the specified resource.\nReplaces any existing policy.", + "flatPath": "projects/{project}/zones/{zone}/reservations/{reservationsId}/reservationBlocks/{reservationBlocksId}/reservationSubBlocks/{resource}/setIamPolicy", + "httpMethod": "POST", + "id": "compute.reservationSubBlocks.setIamPolicy", + "parameterOrder": [ + "project", + "zone", + "parentResource", + "resource" + ], + "parameters": { + "parentResource": { + "description": "Name or id of parent resource of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-zA-Z0-9/]{0,255}[a-zA-Z0-9])?", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/{+parentResource}/reservationSubBlocks/{resource}/setIamPolicy", + "request": { + "$ref": "ZoneSetNestedPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource.", + "flatPath": "projects/{project}/zones/{zone}/reservations/{reservationsId}/reservationBlocks/{reservationBlocksId}/reservationSubBlocks/{resource}/testIamPermissions", + "httpMethod": "POST", + "id": "compute.reservationSubBlocks.testIamPermissions", + "parameterOrder": [ + "project", + "zone", + "parentResource", + "resource" + ], + "parameters": { + "parentResource": { + "description": "Name or id of parent resource of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-zA-Z0-9/]{0,255}[a-zA-Z0-9])?", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" } - } + }, + "path": "projects/{project}/zones/{zone}/{+parentResource}/reservationSubBlocks/{resource}/testIamPermissions", + "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" + ] } } }, - "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" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of SslPolicy resources.", - "type": "array", - "items": { - "$ref": "SslPolicy" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" + "reservations": { + "methods": { + "aggregatedList": { + "description": "Retrieves an aggregated list of reservations.\n\nTo prevent failure, it is recommended that you set the\n`returnPartialSuccess` parameter to `true`.", + "flatPath": "projects/{project}/aggregated/reservations", + "httpMethod": "GET", + "id": "compute.reservations.aggregatedList", + "parameterOrder": [ + "project" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region,\nglobal) should be included in the response. For new resource types added\nafter this field, the flag has no effect as new resource types will always\ninclude every visible scope for each scope type in response. For resource\ntypes which predate this field, if this flag is omitted or false, only\nscopes of the scope types where the resource type is expected to be found\nwill be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which\naggregated list request is invoked for subnetworks list-usable api.", + "format": "int64", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/aggregated/reservations", + "response": { + "$ref": "ReservationAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "delete": { + "description": "Deletes the specified reservation.", + "flatPath": "projects/{project}/zones/{zone}/reservations/{reservation}", + "httpMethod": "DELETE", + "id": "compute.reservations.delete", + "parameterOrder": [ + "project", + "zone", + "reservation" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "reservation": { + "description": "Name of the reservation to delete.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "zone": { + "description": "Name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/reservations/{reservation}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "get": { + "description": "Retrieves information about the specified reservation.", + "flatPath": "projects/{project}/zones/{zone}/reservations/{reservation}", + "httpMethod": "GET", + "id": "compute.reservations.get", + "parameterOrder": [ + "project", + "zone", + "reservation" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "reservation": { + "description": "Name of the reservation to retrieve.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "zone": { + "description": "Name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/reservations/{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" + ] + }, + "getIamPolicy": { + "description": "Gets the access control policy for a resource. May be empty if no such\npolicy or resource exists.", + "flatPath": "projects/{project}/zones/{zone}/reservations/{resource}/getIamPolicy", + "httpMethod": "GET", + "id": "compute.reservations.getIamPolicy", + "parameterOrder": [ + "project", + "zone", + "resource" + ], + "parameters": { + "optionsRequestedPolicyVersion": { + "description": "Requested IAM Policy version.", + "format": "int32", + "location": "query", + "type": "integer" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "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" + }, + "path": "projects/{project}/zones/{zone}/reservations/{resource}/getIamPolicy", + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "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." + "insert": { + "description": "Creates a new reservation. For more information, readReserving zonal\nresources.", + "flatPath": "projects/{project}/zones/{zone}/reservations", + "httpMethod": "POST", + "id": "compute.reservations.insert", + "parameterOrder": [ + "project", + "zone" ], - "enum": [ - "COMPATIBLE", - "CUSTOM", - "MODERN", - "RESTRICTED" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "Name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/reservations", + "request": { + "$ref": "Reservation" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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" + "list": { + "description": "A list of all the reservations that have been configured for the\nspecified project in specified zone.", + "flatPath": "projects/{project}/zones/{zone}/reservations", + "httpMethod": "GET", + "id": "compute.reservations.list", + "parameterOrder": [ + "project", + "zone" ], - "enum": [ - "TLS_1_0", - "TLS_1_1", - "TLS_1_2" + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "zone": { + "description": "Name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/reservations", + "response": { + "$ref": "ReservationList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "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" - } - } - } - } + "performMaintenance": { + "description": "Perform maintenance on an extended reservation", + "flatPath": "projects/{project}/zones/{zone}/reservations/{reservation}/performMaintenance", + "httpMethod": "POST", + "id": "compute.reservations.performMaintenance", + "parameterOrder": [ + "project", + "zone", + "reservation" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "reservation": { + "description": "The name of the reservation.\nName should conform to RFC1035 or be a resource ID.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "zone": { + "description": "Name of the zone for this request. Zone name should conform to RFC1035.", + "location": "path", + "required": true, + "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" - } - } - } - }, - "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" + }, + "path": "projects/{project}/zones/{zone}/reservations/{reservation}/performMaintenance", + "request": { + "$ref": "ReservationsPerformMaintenanceRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "resize": { + "description": "Resizes the reservation (applicable to standalone reservations only). For\nmore information, readModifying\nreservations.", + "flatPath": "projects/{project}/zones/{zone}/reservations/{reservation}/resize", + "httpMethod": "POST", + "id": "compute.reservations.resize", + "parameterOrder": [ + "project", + "zone", + "reservation" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "reservation": { + "description": "Name of the reservation to update.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "zone": { + "description": "Name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/reservations/{reservation}/resize", + "request": { + "$ref": "ReservationsResizeRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "setIamPolicy": { + "description": "Sets the access control policy on the specified resource.\nReplaces any existing policy.", + "flatPath": "projects/{project}/zones/{zone}/reservations/{resource}/setIamPolicy", + "httpMethod": "POST", + "id": "compute.reservations.setIamPolicy", + "parameterOrder": [ + "project", + "zone", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" } - } - }, - "etag": { - "type": "string" - }, - "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" - } + }, + "path": "projects/{project}/zones/{zone}/reservations/{resource}/setIamPolicy", + "request": { + "$ref": "ZoneSetPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource.", + "flatPath": "projects/{project}/zones/{zone}/reservations/{resource}/testIamPermissions", + "httpMethod": "POST", + "id": "compute.reservations.testIamPermissions", + "parameterOrder": [ + "project", + "zone", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" } - } - } - } - }, - "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" + }, + "path": "projects/{project}/zones/{zone}/reservations/{resource}/testIamPermissions", + "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" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "update": { + "description": "Update share settings of the reservation.", + "flatPath": "projects/{project}/zones/{zone}/reservations/{reservation}", + "httpMethod": "PATCH", + "id": "compute.reservations.update", + "parameterOrder": [ + "project", + "zone", + "reservation" + ], + "parameters": { + "paths": { + "location": "query", + "repeated": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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" - } - } - } - } - } - } - } - }, - "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" - }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "reservation": { + "description": "Name of the reservation to update.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "updateMask": { + "description": "Update_mask indicates fields to be updated as part of this request.", + "format": "google-fieldmask", + "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": "Name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" } - } + }, + "path": "projects/{project}/zones/{zone}/reservations/{reservation}", + "request": { + "$ref": "Reservation" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] } } }, - "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" - } - }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "resourcePolicies": { + "methods": { + "aggregatedList": { + "description": "Retrieves an aggregated list of resource policies.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", + "flatPath": "projects/{project}/aggregated/resourcePolicies", + "httpMethod": "GET", + "id": "compute.resourcePolicies.aggregatedList", + "parameterOrder": [ + "project" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "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,\nglobal) should be included in the response. For new resource types added\nafter this field, the flag has no effect as new resource types will always\ninclude every visible scope for each scope type in response. For resource\ntypes which predate this field, if this flag is omitted or false, only\nscopes of the scope types where the resource type is expected to be found\nwill be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`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\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which\naggregated list request is invoked for subnetworks list-usable api.", + "format": "int64", + "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" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the 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" + }, + "path": "projects/{project}/aggregated/resourcePolicies", + "response": { + "$ref": "ResourcePolicyAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "delete": { + "description": "Deletes the specified resource policy.", + "flatPath": "projects/{project}/regions/{region}/resourcePolicies/{resourcePolicy}", + "httpMethod": "DELETE", + "id": "compute.resourcePolicies.delete", + "parameterOrder": [ + "project", + "region", + "resourcePolicy" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "resourcePolicy": { + "description": "Name of the resource policy to delete.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" } - } - }, - "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" - ] }, - "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" - ] + "path": "projects/{project}/regions/{region}/resourcePolicies/{resourcePolicy}", + "response": { + "$ref": "Operation" }, - "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" + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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." + "get": { + "description": "Retrieves all information of the specified resource policy.", + "flatPath": "projects/{project}/regions/{region}/resourcePolicies/{resourcePolicy}", + "httpMethod": "GET", + "id": "compute.resourcePolicies.get", + "parameterOrder": [ + "project", + "region", + "resourcePolicy" ], - "enum": [ - "CREATING", - "DELETING", - "FAILED", - "READY" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "resourcePolicy": { + "description": "Name of the resource policy to retrieve.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/resourcePolicies/{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" ] }, - "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.", - "" + "getIamPolicy": { + "description": "Gets the access control policy for a resource. May be empty if no such\npolicy or resource exists.", + "flatPath": "projects/{project}/regions/{region}/resourcePolicies/{resource}/getIamPolicy", + "httpMethod": "GET", + "id": "compute.resourcePolicies.getIamPolicy", + "parameterOrder": [ + "project", + "region", + "resource" ], - "enum": [ - "ADVANCED", - "STANDARD", - "UNSPECIFIED" + "parameters": { + "optionsRequestedPolicyVersion": { + "description": "Requested IAM Policy version.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/resourcePolicies/{resource}/getIamPolicy", + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "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.", - "" + "insert": { + "description": "Creates a new resource policy.", + "flatPath": "projects/{project}/regions/{region}/resourcePolicies", + "httpMethod": "POST", + "id": "compute.resourcePolicies.insert", + "parameterOrder": [ + "project", + "region" ], - "enum": [ - "ADVANCED", - "STANDARD", - "UNSPECIFIED" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/resourcePolicies", + "request": { + "$ref": "ResourcePolicy" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] - } - } - }, - "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" - } - } - }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "list": { + "description": "A list all the resource policies that have been configured for the\nspecified project in specified region.", + "flatPath": "projects/{project}/regions/{region}/resourcePolicies", + "httpMethod": "GET", + "id": "compute.resourcePolicies.list", + "parameterOrder": [ + "project", + "region" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`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\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" } - } - }, - "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" - } + }, + "path": "projects/{project}/regions/{region}/resourcePolicies", + "response": { + "$ref": "ResourcePolicyList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "patch": { + "description": "Modify the specified resource policy.", + "flatPath": "projects/{project}/regions/{region}/resourcePolicies/{resourcePolicy}", + "httpMethod": "PATCH", + "id": "compute.resourcePolicies.patch", + "parameterOrder": [ + "project", + "region", + "resourcePolicy" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "resourcePolicy": { + "description": "Id of the resource policy to patch.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "update_mask indicates fields to be updated as part of this request.", + "format": "google-fieldmask", + "location": "query", + "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" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the 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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + }, + "path": "projects/{project}/regions/{region}/resourcePolicies/{resourcePolicy}", + "request": { + "$ref": "ResourcePolicy" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "setIamPolicy": { + "description": "Sets the access control policy on the specified resource.\nReplaces any existing policy.", + "flatPath": "projects/{project}/regions/{region}/resourcePolicies/{resource}/setIamPolicy", + "httpMethod": "POST", + "id": "compute.resourcePolicies.setIamPolicy", + "parameterOrder": [ + "project", + "region", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "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" + }, + "path": "projects/{project}/regions/{region}/resourcePolicies/{resource}/setIamPolicy", + "request": { + "$ref": "RegionSetPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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." + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource.", + "flatPath": "projects/{project}/regions/{region}/resourcePolicies/{resource}/testIamPermissions", + "httpMethod": "POST", + "id": "compute.resourcePolicies.testIamPermissions", + "parameterOrder": [ + "project", + "region", + "resource" ], - "enum": [ - "CREATING", - "DELETING", - "FAILED", - "READY", - "RESTORING", - "UNAVAILABLE" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/resourcePolicies/{resource}/testIamPermissions", + "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" ] - }, - "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" - } } } }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "rolloutPlans": { + "methods": { + "delete": { + "description": "Deletes a RolloutPlan.", + "flatPath": "projects/{project}/global/rolloutPlans/{rolloutPlan}", + "httpMethod": "DELETE", + "id": "compute.rolloutPlans.delete", + "parameterOrder": [ + "project", + "rolloutPlan" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(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" - } - } - } + "rolloutPlan": { + "description": "Name of the RolloutPlan resource to delete.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" } - } - } - } - }, - "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" - }, - "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" - } - } - }, - "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" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of TargetHttpProxy resources.", - "type": "array", - "items": { - "$ref": "TargetHttpProxy" - } + "path": "projects/{project}/global/rolloutPlans/{rolloutPlan}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the 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": { + "description": "Gets details of a single project-scoped RolloutPlan.", + "flatPath": "projects/{project}/global/rolloutPlans/{rolloutPlan}", + "httpMethod": "GET", + "id": "compute.rolloutPlans.get", + "parameterOrder": [ + "project", + "rolloutPlan" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "rolloutPlan": { + "description": "Name of the persistent rollout plan to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/rolloutPlans/{rolloutPlan}", + "response": { + "$ref": "RolloutPlan" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "insert": { + "description": "Creates a new RolloutPlan in a given project and location.", + "flatPath": "projects/{project}/global/rolloutPlans", + "httpMethod": "POST", + "id": "compute.rolloutPlans.insert", + "parameterOrder": [ + "project" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/rolloutPlans", + "request": { + "$ref": "RolloutPlan" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "list": { + "description": "Lists RolloutPlans in a given project and location.", + "flatPath": "projects/{project}/global/rolloutPlans", + "httpMethod": "GET", + "id": "compute.rolloutPlans.list", + "parameterOrder": [ + "project" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`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\n`nextPageToken` returned by a previous list request to get\nthe 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.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" } - } - } - } - }, - "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" - }, - "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" - } + }, + "path": "projects/{project}/global/rolloutPlans", + "response": { + "$ref": "RolloutPlansListResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] } } }, - "TargetHttpProxiesScopedList": { - "id": "TargetHttpProxiesScopedList", - "type": "object", - "properties": { - "targetHttpProxies": { - "description": "A list of TargetHttpProxies contained in this scope.", - "type": "array", - "items": { - "$ref": "TargetHttpProxy" - } + "rollouts": { + "methods": { + "advance": { + "description": "Advances a Rollout to the next wave, or completes it if no waves remain.", + "flatPath": "projects/{project}/global/rollouts/{rollout}/advance", + "httpMethod": "POST", + "id": "compute.rollouts.advance", + "parameterOrder": [ + "project", + "rollout" + ], + "parameters": { + "currentWaveNumber": { + "description": "Required. Wave number of the current wave.", + "format": "int64", + "location": "query", + "type": "string" + }, + "project": { + "description": "Required. Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "rollout": { + "description": "Required. Name of the Rollout resource to advance.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/rollouts/{rollout}/advance", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "cancel": { + "description": "Cancels a Rollout.", + "flatPath": "projects/{project}/global/rollouts/{rollout}", + "httpMethod": "PATCH", + "id": "compute.rollouts.cancel", + "parameterOrder": [ + "project", + "rollout" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(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" - } - } - } + "rollback": { + "description": "Optional. If true, then the ongoing rollout must be rolled back. Else, just cancel\nthe rollout without taking any further actions. Note that products must\nsupport at least one of these options, however, it does not need to support\nboth.", + "location": "query", + "type": "boolean" + }, + "rollout": { + "description": "Name of the Rollout resource to cancel.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" } - } - } - } - }, - "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" + }, + "path": "projects/{project}/global/rollouts/{rollout}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" + "delete": { + "description": "Deletes a Rollout.", + "flatPath": "projects/{project}/global/rollouts/{rollout}", + "httpMethod": "DELETE", + "id": "compute.rollouts.delete", + "parameterOrder": [ + "project", + "rollout" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "rollout": { + "description": "Name of the Rollout resource to delete.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/rollouts/{rollout}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "items": { - "description": "A list of TargetHttpsProxy resources.", - "type": "array", - "items": { - "$ref": "TargetHttpsProxy" - } + "get": { + "description": "Gets details of a single project-scoped Rollout.", + "flatPath": "projects/{project}/global/rollouts/{rollout}", + "httpMethod": "GET", + "id": "compute.rollouts.get", + "parameterOrder": [ + "project", + "rollout" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "rollout": { + "description": "Name of the persistent rollout to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/rollouts/{rollout}", + "response": { + "$ref": "Rollout" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" + "list": { + "description": "Lists Rollouts in a given project and location.", + "flatPath": "projects/{project}/global/rollouts", + "httpMethod": "GET", + "id": "compute.rollouts.list", + "parameterOrder": [ + "project" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/global/rollouts", + "response": { + "$ref": "RolloutsListResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "pause": { + "description": "Pauses a Rollout.", + "flatPath": "projects/{project}/global/rollouts/{rollout}/pause", + "httpMethod": "POST", + "id": "compute.rollouts.pause", + "parameterOrder": [ + "project", + "rollout" + ], + "parameters": { + "etag": { + "description": "The etag of the Rollout.\nIf this is provided, the request will only succeed if the etag matches\nthe current etag of the Rollout.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Required. Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "rollout": { + "description": "Required. Name of the Rollout resource to pause.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/rollouts/{rollout}/pause", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "resume": { + "description": "Resumes a Rollout.", + "flatPath": "projects/{project}/global/rollouts/{rollout}/resume", + "httpMethod": "POST", + "id": "compute.rollouts.resume", + "parameterOrder": [ + "project", + "rollout" + ], + "parameters": { + "etag": { + "description": "The etag of the Rollout.\nIf this is provided, the request will only succeed if the etag matches\nthe current etag of the Rollout.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Required. Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(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" - } - } - } + "rollout": { + "description": "Required. Name of the Rollout resource to resume.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" } - } + }, + "path": "projects/{project}/global/rollouts/{rollout}/resume", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] } } }, - "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 Google Cloud 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 namespace. Using Certificate Manager Certificates in this field is 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 or up to 100 Certificate Manager 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." + "routers": { + "methods": { + "aggregatedList": { + "description": "Retrieves an aggregated list of routers.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", + "flatPath": "projects/{project}/aggregated/routers", + "httpMethod": "GET", + "id": "compute.routers.aggregatedList", + "parameterOrder": [ + "project" ], - "enum": [ - "DISABLE", - "ENABLE", - "NONE" + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region,\nglobal) should be included in the response. For new resource types added\nafter this field, the flag has no effect as new resource types will always\ninclude every visible scope for each scope type in response. For resource\ntypes which predate this field, if this flag is omitted or false, only\nscopes of the scope types where the resource type is expected to be found\nwill be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which\naggregated list request is invoked for subnetworks list-usable api.", + "format": "int64", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/aggregated/routers", + "response": { + "$ref": "RouterAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "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 or INTERNAL_MANAGED. It also applies to a regional TargetHttpsProxy attached to regional forwardingRules with the loadBalancingScheme set to EXTERNAL_MANAGED or INTERNAL_MANAGED. For details which ServerTlsPolicy resources are accepted with INTERNAL_SELF_MANAGED and which with EXTERNAL, INTERNAL_MANAGED, 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" + "delete": { + "description": "Deletes the specified Router resource.", + "flatPath": "projects/{project}/regions/{region}/routers/{router}", + "httpMethod": "DELETE", + "id": "compute.routers.delete", + "parameterOrder": [ + "project", + "region", + "router" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "router": { + "description": "Name of the Router resource to delete.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/routers/{router}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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.", - "This enables TLS 1.3 Early Data for requests with any HTTP method including non-idempotent methods list POST. This mode does not enforce any other limitations. This may be valuable for gRPC use cases. However, we do not recommend this method unless you have evaluated your security stance and mitigated the risk of replay attacks using other mechanisms." + "deleteNamedSet": { + "description": "Deletes Named Set", + "flatPath": "projects/{project}/regions/{region}/routers/{router}/deleteNamedSet", + "httpMethod": "POST", + "id": "compute.routers.deleteNamedSet", + "parameterOrder": [ + "project", + "region", + "router" ], - "enum": [ - "DISABLED", - "PERMISSIVE", - "STRICT", - "UNRESTRICTED" + "parameters": { + "namedSet": { + "description": "The Named Set name for this request. Name must conform to RFC1035", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "router": { + "description": "Name of the Router resource where Named Set is defined.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/routers/{router}/deleteNamedSet", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] - } - } - }, - "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" + "deleteRoutePolicy": { + "description": "Deletes Route Policy", + "flatPath": "projects/{project}/regions/{region}/routers/{router}/deleteRoutePolicy", + "httpMethod": "POST", + "id": "compute.routers.deleteRoutePolicy", + "parameterOrder": [ + "project", + "region", + "router" + ], + "parameters": { + "policy": { + "description": "The Policy name for this request. Name must conform to RFC1035", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "router": { + "description": "Name of the Router resource where Route Policy is defined.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/routers/{router}/deleteRoutePolicy", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "items": { - "description": "A list of TargetHttpsProxiesScopedList resources.", - "type": "object", - "additionalProperties": { - "description": "Name of the scope containing this set of TargetHttpsProxies.", - "$ref": "TargetHttpsProxiesScopedList" - } + "get": { + "description": "Returns the specified Router resource.", + "flatPath": "projects/{project}/regions/{region}/routers/{router}", + "httpMethod": "GET", + "id": "compute.routers.get", + "parameterOrder": [ + "project", + "region", + "router" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "router": { + "description": "Name of the Router resource to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/routers/{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" + ] }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" + "getNamedSet": { + "description": "Returns specified Named Set", + "flatPath": "projects/{project}/regions/{region}/routers/{router}/getNamedSet", + "httpMethod": "GET", + "id": "compute.routers.getNamedSet", + "parameterOrder": [ + "project", + "region", + "router" + ], + "parameters": { + "namedSet": { + "description": "The Named Set name for this request. Name must conform to RFC1035", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "router": { + "description": "Name of the Router resource to query for the named set. The name should\nconform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/routers/{router}/getNamedSet", + "response": { + "$ref": "RoutersGetNamedSetResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "getNatIpInfo": { + "description": "Retrieves runtime NAT IP information.", + "flatPath": "projects/{project}/regions/{region}/routers/{router}/getNatIpInfo", + "httpMethod": "GET", + "id": "compute.routers.getNatIpInfo", + "parameterOrder": [ + "project", + "region", + "router" + ], + "parameters": { + "natName": { + "description": "Name of the nat service to filter the NAT IP information.\nIf it is omitted, all nats for this router will be returned.\nName should conform to RFC1035.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "router": { + "description": "Name of the Router resource to query for Nat IP information. The name\nshould conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/routers/{router}/getNatIpInfo", + "response": { + "$ref": "NatIpInfoResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "getNatMappingInfo": { + "description": "Retrieves runtime Nat mapping information of VM endpoints.", + "flatPath": "projects/{project}/regions/{region}/routers/{router}/getNatMappingInfo", + "httpMethod": "GET", + "id": "compute.routers.getNatMappingInfo", + "parameterOrder": [ + "project", + "region", + "router" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "natName": { + "description": "Name of the nat service to filter the Nat Mapping information.\nIf it is omitted, all nats for this router will be returned.\nName 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\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "router": { + "description": "Name of the Router resource to query for Nat Mapping information of\nVM endpoints.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "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" - } + }, + "path": "projects/{project}/regions/{region}/routers/{router}/getNatMappingInfo", + "response": { + "$ref": "VmEndpointNatMappingsList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "getRoutePolicy": { + "description": "Returns specified Route Policy", + "flatPath": "projects/{project}/regions/{region}/routers/{router}/getRoutePolicy", + "httpMethod": "GET", + "id": "compute.routers.getRoutePolicy", + "parameterOrder": [ + "project", + "region", + "router" + ], + "parameters": { + "policy": { + "description": "The Policy name for this request. Name must conform to RFC1035", + "location": "query", + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "router": { + "description": "Name of the Router resource to query for the route policy. The name should\nconform to RFC1035.", + "location": "path", + "required": true, + "type": "string" } - } - } - } - }, - "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." - ], - "enum": [ - "DISABLE", - "ENABLE", - "NONE" + }, + "path": "projects/{project}/regions/{region}/routers/{router}/getRoutePolicy", + "response": { + "$ref": "RoutersGetRoutePolicyResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] - } - } - }, - "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" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" }, - "items": { - "description": "A list of TargetInstance resources.", - "type": "array", - "items": { - "$ref": "TargetInstance" - } + "getRouterStatus": { + "description": "Retrieves runtime information of the specified router.", + "flatPath": "projects/{project}/regions/{region}/routers/{router}/getRouterStatus", + "httpMethod": "GET", + "id": "compute.routers.getRouterStatus", + "parameterOrder": [ + "project", + "region", + "router" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "router": { + "description": "Name of the Router resource to query.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/routers/{router}/getRouterStatus", + "response": { + "$ref": "RouterStatusResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the 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": { + "description": "Creates a Router resource in the specified project and region using\nthe data included in the request.", + "flatPath": "projects/{project}/regions/{region}/routers", + "httpMethod": "POST", + "id": "compute.routers.insert", + "parameterOrder": [ + "project", + "region" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/routers", + "request": { + "$ref": "Router" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "list": { + "description": "Retrieves a list of Router resources available to the specified project.", + "flatPath": "projects/{project}/regions/{region}/routers", + "httpMethod": "GET", + "id": "compute.routers.list", + "parameterOrder": [ + "project", + "region" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/regions/{region}/routers", + "response": { + "$ref": "RouterList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "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", + "listBgpRoutes": { + "description": "Retrieves a list of router bgp routes available to the specified project.", + "flatPath": "projects/{project}/regions/{region}/routers/{router}/listBgpRoutes", + "httpMethod": "GET", + "id": "compute.routers.listBgpRoutes", + "parameterOrder": [ + "project", + "region", + "router" + ], + "parameters": { + "addressFamily": { + "default": "UNSPECIFIED_IP_VERSION", + "description": "(Required) limit results to this address family (either IPv4 or IPv6)", + "enum": [ + "IPV4", + "IPV6", + "UNSPECIFIED_IP_VERSION" + ], "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." + "", + "", + "" + ], + "location": "query", + "type": "string" + }, + "destinationPrefix": { + "description": "Limit results to destinations that are subnets of this CIDR range", + "location": "query", + "type": "string" + }, + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "peer": { + "description": "(Required) limit results to the BGP peer with the given name.\nName should conform to RFC1035.", + "location": "query", + "type": "string" + }, + "policyApplied": { + "default": "true", + "description": "When true, the method returns post-policy routes. Otherwise, it returns\npre-policy routes.", + "location": "query", + "type": "boolean" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "routeType": { + "default": "UNSPECIFIED_ROUTE_TYPE", + "description": "(Required) limit results to this type of route (either LEARNED or\nADVERTISED)", + "enum": [ + "ADVERTISED", + "LEARNED", + "UNSPECIFIED_ROUTE_TYPE" ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false + "enumDescriptions": [ + "", + "", + "" ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "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.", + "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" - } - } - } + "router": { + "description": "Name or id of the resource for this request.\nName should conform to RFC1035.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" } - } - } - } - }, - "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" + }, + "path": "projects/{project}/regions/{region}/routers/{router}/listBgpRoutes", + "response": { + "$ref": "RoutersListBgpRoutes" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "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." + "listNamedSets": { + "description": "Retrieves a list of router named set subresources available to the\nspecified project.", + "flatPath": "projects/{project}/regions/{region}/routers/{router}/listNamedSets", + "httpMethod": "GET", + "id": "compute.routers.listNamedSets", + "parameterOrder": [ + "project", + "region", + "router" ], - "enum": [ - "NO_NAT" + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "router": { + "description": "Name or id of the resource for this request.\nName should conform to RFC1035.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/routers/{router}/listNamedSets", + "response": { + "$ref": "RoutersListNamedSets" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "listRoutePolicies": { + "description": "Retrieves a list of router route policy subresources available to the\nspecified project.", + "flatPath": "projects/{project}/regions/{region}/routers/{router}/listRoutePolicies", + "httpMethod": "GET", + "id": "compute.routers.listRoutePolicies", + "parameterOrder": [ + "project", + "region", + "router" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`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\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "router": { + "description": "Name or id of the resource for this request.\nName should conform to RFC1035.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "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" - } + }, + "path": "projects/{project}/regions/{region}/routers/{router}/listRoutePolicies", + "response": { + "$ref": "RoutersListRoutePolicies" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "patch": { + "description": "Patches the specified Router resource with the data included in the\nrequest. This method supportsPATCH\nsemantics and usesJSON merge\npatch format and processing rules.", + "flatPath": "projects/{project}/regions/{region}/routers/{router}", + "httpMethod": "PATCH", + "id": "compute.routers.patch", + "parameterOrder": [ + "project", + "region", + "router" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "router": { + "description": "Name of the Router resource to patch.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/routers/{router}", + "request": { + "$ref": "Router" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "patchNamedSet": { + "description": "Patches Named Set", + "flatPath": "projects/{project}/regions/{region}/routers/{router}/patchNamedSet", + "httpMethod": "POST", + "id": "compute.routers.patchNamedSet", + "parameterOrder": [ + "project", + "region", + "router" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "router": { + "description": "Name of the Router resource where Named Set is defined.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" } - } - } - } - }, - "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" + }, + "path": "projects/{project}/regions/{region}/routers/{router}/patchNamedSet", + "request": { + "$ref": "NamedSet" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "patchRoutePolicy": { + "description": "Patches Route Policy", + "flatPath": "projects/{project}/regions/{region}/routers/{router}/patchRoutePolicy", + "httpMethod": "POST", + "id": "compute.routers.patchRoutePolicy", + "parameterOrder": [ + "project", + "region", + "router" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "router": { + "description": "Name of the Router resource where Route Policy is defined.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "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" - } + }, + "path": "projects/{project}/regions/{region}/routers/{router}/patchRoutePolicy", + "request": { + "$ref": "RoutePolicy" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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." + "preview": { + "description": "Preview fields auto-generated during router create andupdate operations.\nCalling this method does NOT create or update the router.", + "flatPath": "projects/{project}/regions/{region}/routers/{router}/preview", + "httpMethod": "POST", + "id": "compute.routers.preview", + "parameterOrder": [ + "project", + "region", + "router" ], - "enum": [ - "CLIENT_IP", - "CLIENT_IP_NO_DESTINATION", - "CLIENT_IP_PORT_PROTO", - "CLIENT_IP_PROTO", - "GENERATED_COOKIE", - "HEADER_FIELD", - "HTTP_COOKIE", - "NONE", - "STRONG_COOKIE_AFFINITY" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "router": { + "description": "Name of the Router resource to query.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/routers/{router}/preview", + "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" ] }, - "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" + "update": { + "description": "Updates the specified Router resource with the data included in the\nrequest. This method conforms toPUT semantics, which requests that the state of the\ntarget resource be created or replaced with the state defined by the\nrepresentation enclosed in the request message payload.", + "flatPath": "projects/{project}/regions/{region}/routers/{router}", + "httpMethod": "PUT", + "id": "compute.routers.update", + "parameterOrder": [ + "project", + "region", + "router" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "router": { + "description": "Name of the Router resource to update.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/routers/{router}", + "request": { + "$ref": "Router" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "updateNamedSet": { + "description": "Updates or creates new Named Set", + "flatPath": "projects/{project}/regions/{region}/routers/{router}/updateNamedSet", + "httpMethod": "POST", + "id": "compute.routers.updateNamedSet", + "parameterOrder": [ + "project", + "region", + "router" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "router": { + "description": "Name of the Router resource where Named Set is defined.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/routers/{router}/updateNamedSet", + "request": { + "$ref": "NamedSet" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "updateRoutePolicy": { + "description": "Updates or creates new Route Policy", + "flatPath": "projects/{project}/regions/{region}/routers/{router}/updateRoutePolicy", + "httpMethod": "POST", + "id": "compute.routers.updateRoutePolicy", + "parameterOrder": [ + "project", + "region", + "router" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "router": { + "description": "Name of the Router resource where Route Policy is defined.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" } - } - }, - "unreachables": { - "description": "[Output Only] Unreachable resources.", - "type": "array", - "items": { - "type": "string" - } + }, + "path": "projects/{project}/regions/{region}/routers/{router}/updateRoutePolicy", + "request": { + "$ref": "RoutePolicy" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] } } }, - "TargetPoolsScopedList": { - "id": "TargetPoolsScopedList", - "type": "object", - "properties": { - "targetPools": { - "description": "A list of target pools contained in this scope.", - "type": "array", - "items": { - "$ref": "TargetPool" - } + "routes": { + "methods": { + "delete": { + "description": "Deletes the specified Route resource.", + "flatPath": "projects/{project}/global/routes/{route}", + "httpMethod": "DELETE", + "id": "compute.routes.delete", + "parameterOrder": [ + "project", + "route" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "route": { + "description": "Name of the Route resource to delete.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/routes/{route}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "get": { + "description": "Returns the specified Route resource.", + "flatPath": "projects/{project}/global/routes/{route}", + "httpMethod": "GET", + "id": "compute.routes.get", + "parameterOrder": [ + "project", + "route" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "route": { + "description": "Name of the Route resource to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/routes/{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" + ] + }, + "insert": { + "description": "Creates a Route resource in the specified project using the data included\nin the request.", + "flatPath": "projects/{project}/global/routes", + "httpMethod": "POST", + "id": "compute.routes.insert", + "parameterOrder": [ + "project" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "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" + }, + "path": "projects/{project}/global/routes", + "request": { + "$ref": "Route" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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" - } + "list": { + "description": "Retrieves the list of Route resources available to the specified project.", + "flatPath": "projects/{project}/global/routes", + "httpMethod": "GET", + "id": "compute.routes.list", + "parameterOrder": [ + "project" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/global/routes", + "response": { + "$ref": "RouteList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] + }, + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource.", + "flatPath": "projects/{project}/global/routes/{resource}/testIamPermissions", + "httpMethod": "POST", + "id": "compute.routes.testIamPermissions", + "parameterOrder": [ + "project", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/routes/{resource}/testIamPermissions", + "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" + ] } } }, - "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" - }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "securityPolicies": { + "methods": { + "addRule": { + "description": "Inserts a rule into a security policy.", + "flatPath": "projects/{project}/global/securityPolicies/{securityPolicy}/addRule", + "httpMethod": "POST", + "id": "compute.securityPolicies.addRule", + "parameterOrder": [ + "project", + "securityPolicy" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "securityPolicy": { + "description": "Name of the security policy to update.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "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" - } - } - } + "validateOnly": { + "description": "If true, the request will not be committed.", + "location": "query", + "type": "boolean" } - } - } - } - }, - "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" - } + }, + "path": "projects/{project}/global/securityPolicies/{securityPolicy}/addRule", + "request": { + "$ref": "SecurityPolicyRule" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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" + "aggregatedList": { + "description": "Retrieves the list of all SecurityPolicy resources, regional and global,\navailable to the specified project.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", + "flatPath": "projects/{project}/aggregated/securityPolicies", + "httpMethod": "GET", + "id": "compute.securityPolicies.aggregatedList", + "parameterOrder": [ + "project" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region,\nglobal) should be included in the response. For new resource types added\nafter this field, the flag has no effect as new resource types will always\ninclude every visible scope for each scope type in response. For resource\ntypes which predate this field, if this flag is omitted or false, only\nscopes of the scope types where the resource type is expected to be found\nwill be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Name of the project scoping this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which\naggregated list request is invoked for subnetworks list-usable api.", + "format": "int64", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/aggregated/securityPolicies", + "response": { + "$ref": "SecurityPoliciesAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "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": [ - "", - "" + "delete": { + "description": "Deletes the specified policy.", + "flatPath": "projects/{project}/global/securityPolicies/{securityPolicy}", + "httpMethod": "DELETE", + "id": "compute.securityPolicies.delete", + "parameterOrder": [ + "project", + "securityPolicy" ], - "enum": [ - "NONE", - "PROXY_V1" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "securityPolicy": { + "description": "Name of the security policy to delete.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/securityPolicies/{securityPolicy}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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": [ - "", - "" + "get": { + "description": "List all of the ordered rules present in a single specified policy.", + "flatPath": "projects/{project}/global/securityPolicies/{securityPolicy}", + "httpMethod": "GET", + "id": "compute.securityPolicies.get", + "parameterOrder": [ + "project", + "securityPolicy" ], - "enum": [ - "NONE", - "PROXY_V1" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "securityPolicy": { + "description": "Name of the security policy to get.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/securityPolicies/{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" ] - } - } - }, - "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" + "getRule": { + "description": "Gets a rule at the specified priority.", + "flatPath": "projects/{project}/global/securityPolicies/{securityPolicy}/getRule", + "httpMethod": "GET", + "id": "compute.securityPolicies.getRule", + "parameterOrder": [ + "project", + "securityPolicy" + ], + "parameters": { + "priority": { + "description": "The priority of the rule to get from the security policy.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "securityPolicy": { + "description": "Name of the security policy to which the queried rule belongs.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/securityPolicies/{securityPolicy}/getRule", + "response": { + "$ref": "SecurityPolicyRule" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "items": { - "description": "A list of TargetTcpProxy resources.", - "type": "array", - "items": { - "$ref": "TargetTcpProxy" - } + "insert": { + "description": "Creates a new policy in the specified project using the data included in\nthe request.", + "flatPath": "projects/{project}/global/securityPolicies", + "httpMethod": "POST", + "id": "compute.securityPolicies.insert", + "parameterOrder": [ + "project" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "validateOnly": { + "description": "If true, the request will not be committed.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/global/securityPolicies", + "request": { + "$ref": "SecurityPolicy" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" + "list": { + "description": "List all the policies that have been configured for the specified project.", + "flatPath": "projects/{project}/global/securityPolicies", + "httpMethod": "GET", + "id": "compute.securityPolicies.list", + "parameterOrder": [ + "project" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/global/securityPolicies", + "response": { + "$ref": "SecurityPolicyList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "listPreconfiguredExpressionSets": { + "description": "Gets the current list of preconfigured Web Application Firewall (WAF)\nexpressions.", + "flatPath": "projects/{project}/global/securityPolicies/listPreconfiguredExpressionSets", + "httpMethod": "GET", + "id": "compute.securityPolicies.listPreconfiguredExpressionSets", + "parameterOrder": [ + "project" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/global/securityPolicies/listPreconfiguredExpressionSets", + "response": { + "$ref": "SecurityPoliciesListPreconfiguredExpressionSetsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "patch": { + "description": "Patches the specified policy with the data included in the request. To\nclear fields in the policy, leave the fields empty and specify them in the\nupdateMask. This cannot be used to be update the rules in the policy.\nPlease use the per rule methods like addRule, patchRule, and removeRule\ninstead.", + "flatPath": "projects/{project}/global/securityPolicies/{securityPolicy}", + "httpMethod": "PATCH", + "id": "compute.securityPolicies.patch", + "parameterOrder": [ + "project", + "securityPolicy" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(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" - } - } - } + "securityPolicy": { + "description": "Name of the security policy to update.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "Indicates fields to be cleared as part of this request.", + "format": "google-fieldmask", + "location": "query", + "type": "string" } - } - } - } - }, - "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" + }, + "path": "projects/{project}/global/securityPolicies/{securityPolicy}", + "request": { + "$ref": "SecurityPolicy" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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": [ - "", - "" + "patchRule": { + "description": "Patches a rule at the specified priority. To clear fields in the rule,\nleave the fields empty and specify them in the updateMask.", + "flatPath": "projects/{project}/global/securityPolicies/{securityPolicy}/patchRule", + "httpMethod": "POST", + "id": "compute.securityPolicies.patchRule", + "parameterOrder": [ + "project", + "securityPolicy" ], - "enum": [ - "NONE", - "PROXY_V1" + "parameters": { + "priority": { + "description": "The priority of the rule to patch.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "securityPolicy": { + "description": "Name of the security policy to update.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "Indicates fields to be cleared as part of this request.", + "format": "google-fieldmask", + "location": "query", + "type": "string" + }, + "validateOnly": { + "description": "If true, the request will not be committed.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/global/securityPolicies/{securityPolicy}/patchRule", + "request": { + "$ref": "SecurityPolicyRule" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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" - } - } - }, - "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" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "removeRule": { + "description": "Deletes a rule at the specified priority.", + "flatPath": "projects/{project}/global/securityPolicies/{securityPolicy}/removeRule", + "httpMethod": "POST", + "id": "compute.securityPolicies.removeRule", + "parameterOrder": [ + "project", + "securityPolicy" + ], + "parameters": { + "priority": { + "description": "The priority of the rule to remove from the security policy.", + "format": "int32", + "location": "query", + "type": "integer" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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 update.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" } - } + }, + "path": "projects/{project}/global/securityPolicies/{securityPolicy}/removeRule", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "unreachables": { - "description": "[Output Only] Unreachable resources.", - "type": "array", - "items": { - "type": "string" - } + "setLabels": { + "description": "Sets the labels on a security policy. To learn more about labels,\nread the Labeling Resources\ndocumentation.", + "flatPath": "projects/{project}/global/securityPolicies/{resource}/setLabels", + "httpMethod": "POST", + "id": "compute.securityPolicies.setLabels", + "parameterOrder": [ + "project", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/securityPolicies/{resource}/setLabels", + "request": { + "$ref": "GlobalSetLabelsRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] } } }, - "TargetTcpProxiesScopedList": { - "id": "TargetTcpProxiesScopedList", - "type": "object", - "properties": { - "targetTcpProxies": { - "description": "A list of TargetTcpProxies contained in this scope.", - "type": "array", - "items": { - "$ref": "TargetTcpProxy" - } + "serviceAttachments": { + "methods": { + "aggregatedList": { + "description": "Retrieves the list of all ServiceAttachment resources,\nregional and global, available to the specified project.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", + "flatPath": "projects/{project}/aggregated/serviceAttachments", + "httpMethod": "GET", + "id": "compute.serviceAttachments.aggregatedList", + "parameterOrder": [ + "project" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region,\nglobal) should be included in the response. For new resource types added\nafter this field, the flag has no effect as new resource types will always\ninclude every visible scope for each scope type in response. For resource\ntypes which predate this field, if this flag is omitted or false, only\nscopes of the scope types where the resource type is expected to be found\nwill be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Name of the project scoping this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which\naggregated list request is invoked for subnetworks list-usable api.", + "format": "int64", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/aggregated/serviceAttachments", + "response": { + "$ref": "ServiceAttachmentAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "delete": { + "description": "Deletes the specified ServiceAttachment in the given scope", + "flatPath": "projects/{project}/regions/{region}/serviceAttachments/{serviceAttachment}", + "httpMethod": "DELETE", + "id": "compute.serviceAttachments.delete", + "parameterOrder": [ + "project", + "region", + "serviceAttachment" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region of this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "serviceAttachment": { + "description": "Name of the ServiceAttachment resource to delete.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/serviceAttachments/{serviceAttachment}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "get": { + "description": "Returns the specified ServiceAttachment resource in the given scope.", + "flatPath": "projects/{project}/regions/{region}/serviceAttachments/{serviceAttachment}", + "httpMethod": "GET", + "id": "compute.serviceAttachments.get", + "parameterOrder": [ + "project", + "region", + "serviceAttachment" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "region": { + "description": "Name of the region of this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "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" - } - } - } + "serviceAttachment": { + "description": "Name of the ServiceAttachment resource to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "showNatIps": { + "description": "Indicates whether NAT IPs should be included in the response.", + "location": "query", + "type": "boolean" } - } - } - } - }, - "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": [ - "", - "" - ], - "enum": [ - "NONE", - "PROXY_V1" + }, + "path": "projects/{project}/regions/{region}/serviceAttachments/{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" ] - } - } - }, - "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" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the 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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "getIamPolicy": { + "description": "Gets the access control policy for a resource. May be empty if no such\npolicy or resource exists.", + "flatPath": "projects/{project}/regions/{region}/serviceAttachments/{resource}/getIamPolicy", + "httpMethod": "GET", + "id": "compute.serviceAttachments.getIamPolicy", + "parameterOrder": [ + "project", + "region", + "resource" + ], + "parameters": { + "optionsRequestedPolicyVersion": { + "description": "Requested IAM Policy version.", + "format": "int32", + "location": "query", + "type": "integer" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "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" - ] + "path": "projects/{project}/regions/{region}/serviceAttachments/{resource}/getIamPolicy", + "response": { + "$ref": "Policy" }, - "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" - } + "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] The status of the VPN gateway, which can be one of the following: CREATING, READY, FAILED, or DELETING.", - "type": "string", - "enumDescriptions": [ - "", - "", - "", - "" + "insert": { + "description": "Creates a ServiceAttachment in the specified project in the given scope\nusing the parameters that are included in the request.", + "flatPath": "projects/{project}/regions/{region}/serviceAttachments", + "httpMethod": "POST", + "id": "compute.serviceAttachments.insert", + "parameterOrder": [ + "project", + "region" ], - "enum": [ - "CREATING", - "DELETING", - "FAILED", - "READY" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region of this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/serviceAttachments", + "request": { + "$ref": "ServiceAttachment" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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" + "list": { + "description": "Lists the ServiceAttachments for a project in the given scope.", + "flatPath": "projects/{project}/regions/{region}/serviceAttachments", + "httpMethod": "GET", + "id": "compute.serviceAttachments.list", + "parameterOrder": [ + "project", + "region" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region of this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/regions/{region}/serviceAttachments", + "response": { + "$ref": "ServiceAttachmentList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "patch": { + "description": "Patches the specified ServiceAttachment resource with the data included in\nthe request. This method supports PATCH\nsemantics and usesJSON merge\npatch format and processing rules.", + "flatPath": "projects/{project}/regions/{region}/serviceAttachments/{serviceAttachment}", + "httpMethod": "PATCH", + "id": "compute.serviceAttachments.patch", + "parameterOrder": [ + "project", + "region", + "serviceAttachment" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "region": { + "description": "The region scoping this request and 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" - } - } - } + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "serviceAttachment": { + "description": "The resource id of the ServiceAttachment to patch. It should conform to\nRFC1035 resource name or be a string form on an unsigned long number.", + "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" - } + }, + "path": "projects/{project}/regions/{region}/serviceAttachments/{serviceAttachment}", + "request": { + "$ref": "ServiceAttachment" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "setIamPolicy": { + "description": "Sets the access control policy on the specified resource.\nReplaces any existing policy.", + "flatPath": "projects/{project}/regions/{region}/serviceAttachments/{resource}/setIamPolicy", + "httpMethod": "POST", + "id": "compute.serviceAttachments.setIamPolicy", + "parameterOrder": [ + "project", + "region", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" } - } - } - } - }, - "UrlMapList": { - "id": "UrlMapList", - "description": "Contains a list of UrlMap resources.", - "type": "object", - "properties": { - "kind": { - "description": "Type of resource.", - "default": "compute#urlMapList", - "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" + }, + "path": "projects/{project}/regions/{region}/serviceAttachments/{resource}/setIamPolicy", + "request": { + "$ref": "RegionSetPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource.", + "flatPath": "projects/{project}/regions/{region}/serviceAttachments/{resource}/testIamPermissions", + "httpMethod": "POST", + "id": "compute.serviceAttachments.testIamPermissions", + "parameterOrder": [ + "project", + "region", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" } - } - } - } - }, - "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. Only one of defaultUrlRedirect, defaultService or defaultRouteAction.weightedBackendService can be set. 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. Only one of defaultUrlRedirect, defaultService or defaultRouteAction.weightedBackendService can 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. Only one of defaultUrlRedirect, defaultService or defaultRouteAction.weightedBackendService can 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" + }, + "path": "projects/{project}/regions/{region}/serviceAttachments/{resource}/testIamPermissions", + "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" + ] } } }, - "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" - } + "snapshotSettings": { + "methods": { + "get": { + "description": "Get snapshot settings.", + "flatPath": "projects/{project}/global/snapshotSettings", + "httpMethod": "GET", + "id": "compute.snapshotSettings.get", + "parameterOrder": [ + "project" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/snapshotSettings", + "response": { + "$ref": "SnapshotSettings" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "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" + "patch": { + "description": "Patch snapshot settings.", + "flatPath": "projects/{project}/global/snapshotSettings", + "httpMethod": "PATCH", + "id": "compute.snapshotSettings.patch", + "parameterOrder": [ + "project" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "updateMask": { + "description": "update_mask indicates fields to be updated as part of this request.", + "format": "google-fieldmask", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/snapshotSettings", + "request": { + "$ref": "SnapshotSettings" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] } } }, - "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" + "snapshots": { + "methods": { + "delete": { + "description": "Deletes the specified Snapshot resource. Keep in mind that deleting\na single snapshot might not necessarily delete all the data on that\nsnapshot. If any data on the snapshot that is marked for deletion is\nneeded for subsequent snapshots, the data will be moved to the next\ncorresponding snapshot.\n\nFor more information, seeDeleting\nsnapshots.", + "flatPath": "projects/{project}/global/snapshots/{snapshot}", + "httpMethod": "DELETE", + "id": "compute.snapshots.delete", + "parameterOrder": [ + "project", + "snapshot" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "snapshot": { + "description": "Name of the Snapshot resource to delete.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/snapshots/{snapshot}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "description": { - "description": "An optional description of this resource. Provide this property when you create the resource.", - "type": "string" + "get": { + "description": "Returns the specified Snapshot resource.", + "flatPath": "projects/{project}/global/snapshots/{snapshot}", + "httpMethod": "GET", + "id": "compute.snapshots.get", + "parameterOrder": [ + "project", + "snapshot" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "snapshot": { + "description": "Name of the Snapshot resource to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/snapshots/{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" + ] }, - "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. Only one of defaultUrlRedirect, defaultService or defaultRouteAction.weightedBackendService can be set. 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" + "getIamPolicy": { + "description": "Gets the access control policy for a resource. May be empty if no such\npolicy or resource exists.", + "flatPath": "projects/{project}/global/snapshots/{resource}/getIamPolicy", + "httpMethod": "GET", + "id": "compute.snapshots.getIamPolicy", + "parameterOrder": [ + "project", + "resource" + ], + "parameters": { + "optionsRequestedPolicyVersion": { + "description": "Requested IAM Policy version.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/snapshots/{resource}/getIamPolicy", + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "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. Only one of defaultUrlRedirect, defaultService or defaultRouteAction.weightedBackendService can be set. URL maps for classic Application Load Balancers only support the urlRewrite action within a path matcher's defaultRouteAction.", - "$ref": "HttpRouteAction" + "insert": { + "description": "Creates a snapshot in the specified project using the data included\nin the request. For regular snapshot creation, consider using this method\ninstead of disks.createSnapshot,\nas this method supports more features, such as creating snapshots in a\nproject different from the source disk project.", + "flatPath": "projects/{project}/global/snapshots", + "httpMethod": "POST", + "id": "compute.snapshots.insert", + "parameterOrder": [ + "project" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/snapshots", + "request": { + "$ref": "Snapshot" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "defaultUrlRedirect": { - "description": "When none of the specified pathRules or routeRules match, the request is redirected to a URL specified by defaultUrlRedirect. Only one of defaultUrlRedirect, defaultService or defaultRouteAction.weightedBackendService can be set. Not supported when the URL map is bound to a target gRPC proxy.", - "$ref": "HttpRedirectAction" + "list": { + "description": "Retrieves the list of Snapshot resources contained within\nthe specified project.", + "flatPath": "projects/{project}/global/snapshots", + "httpMethod": "GET", + "id": "compute.snapshots.list", + "parameterOrder": [ + "project" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/global/snapshots", + "response": { + "$ref": "SnapshotList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "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" - } + "setIamPolicy": { + "description": "Sets the access control policy on the specified resource.\nReplaces any existing policy.", + "flatPath": "projects/{project}/global/snapshots/{resource}/setIamPolicy", + "httpMethod": "POST", + "id": "compute.snapshots.setIamPolicy", + "parameterOrder": [ + "project", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/snapshots/{resource}/setIamPolicy", + "request": { + "$ref": "GlobalSetPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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" - } + "setLabels": { + "description": "Sets the labels on a snapshot. To learn more about labels, read theLabeling\nResources documentation.", + "flatPath": "projects/{project}/global/snapshots/{resource}/setLabels", + "httpMethod": "POST", + "id": "compute.snapshots.setLabels", + "parameterOrder": [ + "project", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/snapshots/{resource}/setLabels", + "request": { + "$ref": "GlobalSetLabelsRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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" + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource.", + "flatPath": "projects/{project}/global/snapshots/{resource}/testIamPermissions", + "httpMethod": "POST", + "id": "compute.snapshots.testIamPermissions", + "parameterOrder": [ + "project", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/snapshots/{resource}/testIamPermissions", + "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" + ] }, - "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" + "updateKmsKey": { + "description": "Rotates the customer-managed\nencryption key to the latest version for the specified snapshot.", + "flatPath": "projects/{project}/global/snapshots/{snapshot}/updateKmsKey", + "httpMethod": "POST", + "id": "compute.snapshots.updateKmsKey", + "parameterOrder": [ + "project", + "snapshot" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "snapshot": { + "description": "Name of the snapshot resource to update. Should conform to RFC1035.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/snapshots/{snapshot}/updateKmsKey", + "request": { + "$ref": "SnapshotUpdateKmsKeyRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] } } }, - "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" + "sslCertificates": { + "methods": { + "aggregatedList": { + "description": "Retrieves the list of all SslCertificate resources, regional and global,\navailable to the specified project.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", + "flatPath": "projects/{project}/aggregated/sslCertificates", + "httpMethod": "GET", + "id": "compute.sslCertificates.aggregatedList", + "parameterOrder": [ + "project" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region,\nglobal) should be included in the response. For new resource types added\nafter this field, the flag has no effect as new resource types will always\ninclude every visible scope for each scope type in response. For resource\ntypes which predate this field, if this flag is omitted or false, only\nscopes of the scope types where the resource type is expected to be found\nwill be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Name of the project scoping this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which\naggregated list request is invoked for subnetworks list-usable api.", + "format": "int64", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/aggregated/sslCertificates", + "response": { + "$ref": "SslCertificateAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "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" + "delete": { + "description": "Deletes the specified SslCertificate resource.", + "flatPath": "projects/{project}/global/sslCertificates/{sslCertificate}", + "httpMethod": "DELETE", + "id": "compute.sslCertificates.delete", + "parameterOrder": [ + "project", + "sslCertificate" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "sslCertificate": { + "description": "Name of the SslCertificate resource to delete.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/sslCertificates/{sslCertificate}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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" + "get": { + "description": "Returns the specified SslCertificate resource.", + "flatPath": "projects/{project}/global/sslCertificates/{sslCertificate}", + "httpMethod": "GET", + "id": "compute.sslCertificates.get", + "parameterOrder": [ + "project", + "sslCertificate" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "sslCertificate": { + "description": "Name of the SslCertificate resource to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/sslCertificates/{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" + ] }, - "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" + "insert": { + "description": "Creates a SslCertificate resource in the specified project using the data\nincluded in the request.", + "flatPath": "projects/{project}/global/sslCertificates", + "httpMethod": "POST", + "id": "compute.sslCertificates.insert", + "parameterOrder": [ + "project" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/sslCertificates", + "request": { + "$ref": "SslCertificate" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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" + "list": { + "description": "Retrieves the list of SslCertificate resources available to the specified\nproject.", + "flatPath": "projects/{project}/global/sslCertificates", + "httpMethod": "GET", + "id": "compute.sslCertificates.list", + "parameterOrder": [ + "project" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/global/sslCertificates", + "response": { + "$ref": "SslCertificateList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] } } }, - "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" - } + "sslPolicies": { + "methods": { + "aggregatedList": { + "description": "Retrieves the list of all SslPolicy resources, regional and global,\navailable to the specified project.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", + "flatPath": "projects/{project}/aggregated/sslPolicies", + "httpMethod": "GET", + "id": "compute.sslPolicies.aggregatedList", + "parameterOrder": [ + "project" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region,\nglobal) should be included in the response. For new resource types added\nafter this field, the flag has no effect as new resource types will always\ninclude every visible scope for each scope type in response. For resource\ntypes which predate this field, if this flag is omitted or false, only\nscopes of the scope types where the resource type is expected to be found\nwill be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Name of the project scoping this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which\naggregated list request is invoked for subnetworks list-usable api.", + "format": "int64", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/aggregated/sslPolicies", + "response": { + "$ref": "SslPoliciesAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "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" - } + "delete": { + "description": "Deletes the specified SSL policy. The SSL policy resource can be deleted\nonly if it is not in use by any TargetHttpsProxy or TargetSslProxy\nresources.", + "flatPath": "projects/{project}/global/sslPolicies/{sslPolicy}", + "httpMethod": "DELETE", + "id": "compute.sslPolicies.delete", + "parameterOrder": [ + "project", + "sslPolicy" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(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,\nand comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/sslPolicies/{sslPolicy}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "responseHeadersToAdd": { - "description": "Headers to add the response before sending the response back to the client.", - "type": "array", - "items": { - "$ref": "HttpHeaderOption" - } - } - } - }, - "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" + "get": { + "description": "Lists all of the ordered rules present in a single specified policy.", + "flatPath": "projects/{project}/global/sslPolicies/{sslPolicy}", + "httpMethod": "GET", + "id": "compute.sslPolicies.get", + "parameterOrder": [ + "project", + "sslPolicy" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "sslPolicy": { + "description": "Name of the SSL policy to update. The name must be 1-63 characters long,\nand comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/sslPolicies/{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" + ] }, - "headerValue": { - "description": "The value of the header to add.", - "type": "string" + "insert": { + "description": "Returns the specified SSL policy resource.", + "flatPath": "projects/{project}/global/sslPolicies", + "httpMethod": "POST", + "id": "compute.sslPolicies.insert", + "parameterOrder": [ + "project" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/sslPolicies", + "request": { + "$ref": "SslPolicy" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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 true, unless a variable is present in headerValue, in which case 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" + "list": { + "description": "Lists all the SSL policies that have been configured for the specified\nproject.", + "flatPath": "projects/{project}/global/sslPolicies", + "httpMethod": "GET", + "id": "compute.sslPolicies.list", + "parameterOrder": [ + "project" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/global/sslPolicies", + "response": { + "$ref": "SslPoliciesList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "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" + "listAvailableFeatures": { + "description": "Lists all features that can be specified in the SSL policy when using\ncustom profile.", + "flatPath": "projects/{project}/global/sslPolicies/listAvailableFeatures", + "httpMethod": "GET", + "id": "compute.sslPolicies.listAvailableFeatures", + "parameterOrder": [ + "project" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/global/sslPolicies/listAvailableFeatures", + "response": { + "$ref": "SslPoliciesListAvailableFeaturesResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "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" + "patch": { + "description": "Patches the specified SSL policy with the data included in the request.", + "flatPath": "projects/{project}/global/sslPolicies/{sslPolicy}", + "httpMethod": "PATCH", + "id": "compute.sslPolicies.patch", + "parameterOrder": [ + "project", + "sslPolicy" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(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,\nand comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/sslPolicies/{sslPolicy}", + "request": { + "$ref": "SslPolicy" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] } } }, - "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" - } + "storagePoolTypes": { + "methods": { + "aggregatedList": { + "description": "Retrieves an aggregated list of storage pool types.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", + "flatPath": "projects/{project}/aggregated/storagePoolTypes", + "httpMethod": "GET", + "id": "compute.storagePoolTypes.aggregatedList", + "parameterOrder": [ + "project" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region,\nglobal) should be included in the response. For new resource types added\nafter this field, the flag has no effect as new resource types will always\ninclude every visible scope for each scope type in response. For resource\ntypes which predate this field, if this flag is omitted or false, only\nscopes of the scope types where the resource type is expected to be found\nwill be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which\naggregated list request is invoked for subnetworks list-usable api.", + "format": "int64", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/aggregated/storagePoolTypes", + "response": { + "$ref": "StoragePoolTypeAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "numRetries": { - "description": "Specifies the allowed number retries. This number must be \u003e 0. If not specified, defaults to 1.", - "type": "integer", - "format": "uint32" + "get": { + "description": "Returns the specified storage pool type.", + "flatPath": "projects/{project}/zones/{zone}/storagePoolTypes/{storagePoolType}", + "httpMethod": "GET", + "id": "compute.storagePoolTypes.get", + "parameterOrder": [ + "project", + "zone", + "storagePoolType" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "storagePoolType": { + "description": "Name of the storage pool type to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/storagePoolTypes/{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" + ] }, - "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" + "list": { + "description": "Retrieves a list of storage pool types available to the specified\nproject.", + "flatPath": "projects/{project}/zones/{zone}/storagePoolTypes", + "httpMethod": "GET", + "id": "compute.storagePoolTypes.list", + "parameterOrder": [ + "project", + "zone" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/storagePoolTypes", + "response": { + "$ref": "StoragePoolTypeList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] } } }, - "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" - } - }, - "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" + "storagePools": { + "methods": { + "aggregatedList": { + "description": "Retrieves an aggregated list of storage pools.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", + "flatPath": "projects/{project}/aggregated/storagePools", + "httpMethod": "GET", + "id": "compute.storagePools.aggregatedList", + "parameterOrder": [ + "project" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region,\nglobal) should be included in the response. For new resource types added\nafter this field, the flag has no effect as new resource types will always\ninclude every visible scope for each scope type in response. For resource\ntypes which predate this field, if this flag is omitted or false, only\nscopes of the scope types where the resource type is expected to be found\nwill be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which\naggregated list request is invoked for subnetworks list-usable api.", + "format": "int64", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/aggregated/storagePools", + "response": { + "$ref": "StoragePoolAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "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" + "delete": { + "description": "Deletes the specified storage pool. Deleting a storagePool\nremoves its data permanently and is irreversible. However, deleting a\nstoragePool does not delete any snapshots previously\nmade from the storagePool. You must separately delete\nsnapshots.", + "flatPath": "projects/{project}/zones/{zone}/storagePools/{storagePool}", + "httpMethod": "DELETE", + "id": "compute.storagePools.delete", + "parameterOrder": [ + "project", + "zone", + "storagePool" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "storagePool": { + "description": "Name of the storage pool to delete.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/storagePools/{storagePool}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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" + "get": { + "description": "Returns a specified storage pool. Gets a list of available\nstorage pools by making a list() request.", + "flatPath": "projects/{project}/zones/{zone}/storagePools/{storagePool}", + "httpMethod": "GET", + "id": "compute.storagePools.get", + "parameterOrder": [ + "project", + "zone", + "storagePool" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "storagePool": { + "description": "Name of the storage pool to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/storagePools/{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" + ] }, - "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" + "getIamPolicy": { + "description": "Gets the access control policy for a resource. May be empty if no such\npolicy or resource exists.", + "flatPath": "projects/{project}/zones/{zone}/storagePools/{resource}/getIamPolicy", + "httpMethod": "GET", + "id": "compute.storagePools.getIamPolicy", + "parameterOrder": [ + "project", + "zone", + "resource" + ], + "parameters": { + "optionsRequestedPolicyVersion": { + "description": "Requested IAM Policy version.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/storagePools/{resource}/getIamPolicy", + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "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" + "insert": { + "description": "Creates a storage pool in the specified project using the data\nin the request.", + "flatPath": "projects/{project}/zones/{zone}/storagePools", + "httpMethod": "POST", + "id": "compute.storagePools.insert", + "parameterOrder": [ + "project", + "zone" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/storagePools", + "request": { + "$ref": "StoragePool" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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" + "list": { + "description": "Retrieves a list of storage pools contained within\nthe specified zone.", + "flatPath": "projects/{project}/zones/{zone}/storagePools", + "httpMethod": "GET", + "id": "compute.storagePools.list", + "parameterOrder": [ + "project", + "zone" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/storagePools", + "response": { + "$ref": "StoragePoolList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "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" + "listDisks": { + "description": "Lists the disks in a specified storage pool.", + "flatPath": "projects/{project}/zones/{zone}/storagePools/{storagePool}/listDisks", + "httpMethod": "GET", + "id": "compute.storagePools.listDisks", + "parameterOrder": [ + "project", + "zone", + "storagePool" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "storagePool": { + "description": "Name of the storage pool to list disks of.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/storagePools/{storagePool}/listDisks", + "response": { + "$ref": "StoragePoolListDisks" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "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" + "setIamPolicy": { + "description": "Sets the access control policy on the specified resource.\nReplaces any existing policy.", + "flatPath": "projects/{project}/zones/{zone}/storagePools/{resource}/setIamPolicy", + "httpMethod": "POST", + "id": "compute.storagePools.setIamPolicy", + "parameterOrder": [ + "project", + "zone", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/storagePools/{resource}/setIamPolicy", + "request": { + "$ref": "ZoneSetPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "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." + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource.", + "flatPath": "projects/{project}/zones/{zone}/storagePools/{resource}/testIamPermissions", + "httpMethod": "POST", + "id": "compute.storagePools.testIamPermissions", + "parameterOrder": [ + "project", + "zone", + "resource" ], - "enum": [ - "FOUND", - "MOVED_PERMANENTLY_DEFAULT", - "PERMANENT_REDIRECT", - "SEE_OTHER", - "TEMPORARY_REDIRECT" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/storagePools/{resource}/testIamPermissions", + "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" ] }, - "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" - }, - "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" + "update": { + "description": "Updates the specified storagePool with the data included in the request.\nThe update is performed only on selected fields included as part\nof update-mask. Only the following fields can be modified:\npool_provisioned_capacity_gb, pool_provisioned_iops and\npool_provisioned_throughput.", + "flatPath": "projects/{project}/zones/{zone}/storagePools/{storagePool}", + "httpMethod": "PATCH", + "id": "compute.storagePools.update", + "parameterOrder": [ + "project", + "zone", + "storagePool" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "storagePool": { + "description": "The storagePool name for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "update_mask indicates fields to be updated as part of this request.", + "format": "google-fieldmask", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/storagePools/{storagePool}", + "request": { + "$ref": "StoragePool" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] } } }, - "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. Only one of urlRedirect, service or routeAction.weightedBackendService can 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. Only one of urlRedirect, service or routeAction.weightedBackendService can 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. Only one of urlRedirect, service or routeAction.weightedBackendService can 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" - } + "subnetworks": { + "methods": { + "aggregatedList": { + "description": "Retrieves an aggregated list of subnetworks.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", + "flatPath": "projects/{project}/aggregated/subnetworks", + "httpMethod": "GET", + "id": "compute.subnetworks.aggregatedList", + "parameterOrder": [ + "project" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region,\nglobal) should be included in the response. For new resource types added\nafter this field, the flag has no effect as new resource types will always\ninclude every visible scope for each scope type in response. For resource\ntypes which predate this field, if this flag is omitted or false, only\nscopes of the scope types where the resource type is expected to be found\nwill be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which\naggregated list request is invoked for subnetworks list-usable api.", + "format": "int64", + "location": "query", + "type": "string" + }, + "views": { + "description": "Defines the extra views returned back in the subnetwork resource.\nSupported values:\n \n - WITH_UTILIZATION: Utilization data is included in the\n response.", + "enum": [ + "DEFAULT", + "WITH_UTILIZATION" + ], + "enumDescriptions": [ + "", + "Utilization data is included in the response." + ], + "location": "query", + "repeated": true, + "type": "string" + } + }, + "path": "projects/{project}/aggregated/subnetworks", + "response": { + "$ref": "SubnetworkAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "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" - } + "delete": { + "description": "Deletes the specified subnetwork.", + "flatPath": "projects/{project}/regions/{region}/subnetworks/{subnetwork}", + "httpMethod": "DELETE", + "id": "compute.subnetworks.delete", + "parameterOrder": [ + "project", + "region", + "subnetwork" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "subnetwork": { + "description": "Name of the Subnetwork resource to delete.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/subnetworks/{subnetwork}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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" - } + "expandIpCidrRange": { + "description": "Expands the IP CIDR range of the subnetwork to a specified value.", + "flatPath": "projects/{project}/regions/{region}/subnetworks/{subnetwork}/expandIpCidrRange", + "httpMethod": "POST", + "id": "compute.subnetworks.expandIpCidrRange", + "parameterOrder": [ + "project", + "region", + "subnetwork" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "subnetwork": { + "description": "Name of the Subnetwork resource to update.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/subnetworks/{subnetwork}/expandIpCidrRange", + "request": { + "$ref": "SubnetworksExpandIpCidrRangeRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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" + "get": { + "description": "Returns the specified subnetwork.", + "flatPath": "projects/{project}/regions/{region}/subnetworks/{subnetwork}", + "httpMethod": "GET", + "id": "compute.subnetworks.get", + "parameterOrder": [ + "project", + "region", + "subnetwork" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "subnetwork": { + "description": "Name of the Subnetwork resource to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "views": { + "description": "Defines the extra views returned back in the subnetwork resource.\nSupported values:\n \n - WITH_UTILIZATION: Utilization data is included in the\n response.", + "enum": [ + "DEFAULT", + "WITH_UTILIZATION" + ], + "enumDescriptions": [ + "", + "Utilization data is included in the response." + ], + "location": "query", + "repeated": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/subnetworks/{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" + ] }, - "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" + "getIamPolicy": { + "description": "Gets the access control policy for a resource. May be empty if no such\npolicy or resource exists.", + "flatPath": "projects/{project}/regions/{region}/subnetworks/{resource}/getIamPolicy", + "httpMethod": "GET", + "id": "compute.subnetworks.getIamPolicy", + "parameterOrder": [ + "project", + "region", + "resource" + ], + "parameters": { + "optionsRequestedPolicyVersion": { + "description": "Requested IAM Policy version.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/subnetworks/{resource}/getIamPolicy", + "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": { - "description": "The short description conveying the intent of this routeRule. The description can have a maximum length of 1024 characters.", - "type": "string" + "insert": { + "description": "Creates a subnetwork in the specified project using the data\nincluded in the request.", + "flatPath": "projects/{project}/regions/{region}/subnetworks", + "httpMethod": "POST", + "id": "compute.subnetworks.insert", + "parameterOrder": [ + "project", + "region" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/subnetworks", + "request": { + "$ref": "Subnetwork" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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" - } + "list": { + "description": "Retrieves a list of subnetworks available to the specified\nproject.", + "flatPath": "projects/{project}/regions/{region}/subnetworks", + "httpMethod": "GET", + "id": "compute.subnetworks.list", + "parameterOrder": [ + "project", + "region" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "views": { + "description": "Defines the extra views returned back in the subnetwork resource.\nSupported values:\n \n - WITH_UTILIZATION: Utilization data is included in the\n response.", + "enum": [ + "DEFAULT", + "WITH_UTILIZATION" + ], + "enumDescriptions": [ + "", + "Utilization data is included in the response." + ], + "location": "query", + "repeated": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/subnetworks", + "response": { + "$ref": "SubnetworkList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "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. Only one of urlRedirect, service or routeAction.weightedBackendService can be set.", - "type": "string" + "listUsable": { + "description": "Retrieves an aggregated list of all usable subnetworks in the project.", + "flatPath": "projects/{project}/aggregated/subnetworks/listUsable", + "httpMethod": "GET", + "id": "compute.subnetworks.listUsable", + "parameterOrder": [ + "project" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProject": { + "description": "The project id or project number in which the subnetwork is intended to be\nused. Only applied for Shared VPC. See [Shared VPC\ndocumentation](https://cloud.google.com/vpc/docs/shared-vpc/)", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/aggregated/subnetworks/listUsable", + "response": { + "$ref": "UsableSubnetworksAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "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. Only one of urlRedirect, service or routeAction.weightedBackendService can be set. URL maps for classic Application Load Balancers only support the urlRewrite action within a route rule's routeAction.", - "$ref": "HttpRouteAction" + "patch": { + "description": "Patches the specified subnetwork with the data included in the request.\nOnly certain fields can be updated with a patch request\nas indicated in the field descriptions.\nYou must specify the current fingerprint of the\nsubnetwork resource being patched.", + "flatPath": "projects/{project}/regions/{region}/subnetworks/{subnetwork}", + "httpMethod": "PATCH", + "id": "compute.subnetworks.patch", + "parameterOrder": [ + "project", + "region", + "subnetwork" + ], + "parameters": { + "drainTimeoutSeconds": { + "description": "The drain timeout specifies the upper bound in seconds on the amount of\ntime allowed to drain connections from the current ACTIVE subnetwork\nto the current BACKUP subnetwork. The drain timeout is only applicable\nwhen the following conditions are true:\n - the subnetwork being patched has purpose = INTERNAL_HTTPS_LOAD_BALANCER\n - the subnetwork being patched has role = BACKUP\n - the patch request is setting the role to ACTIVE. Note that after this\n patch operation the roles of the ACTIVE and BACKUP subnetworks will be\n swapped.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "subnetwork": { + "description": "Name of the Subnetwork resource to patch.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/subnetworks/{subnetwork}", + "request": { + "$ref": "Subnetwork" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "urlRedirect": { - "description": "When this rule is matched, the request is redirected to a URL specified by urlRedirect. Only one of urlRedirect, service or routeAction.weightedBackendService can be set. Not supported when the URL map is bound to a target gRPC proxy.", - "$ref": "HttpRedirectAction" + "setIamPolicy": { + "description": "Sets the access control policy on the specified resource.\nReplaces any existing policy.", + "flatPath": "projects/{project}/regions/{region}/subnetworks/{resource}/setIamPolicy", + "httpMethod": "POST", + "id": "compute.subnetworks.setIamPolicy", + "parameterOrder": [ + "project", + "region", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/subnetworks/{resource}/setIamPolicy", + "request": { + "$ref": "RegionSetPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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" + "setPrivateIpGoogleAccess": { + "description": "Set whether VMs in this subnet can access Google services without assigning\nexternal IP addresses through Private Google Access.", + "flatPath": "projects/{project}/regions/{region}/subnetworks/{subnetwork}/setPrivateIpGoogleAccess", + "httpMethod": "POST", + "id": "compute.subnetworks.setPrivateIpGoogleAccess", + "parameterOrder": [ + "project", + "region", + "subnetwork" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "subnetwork": { + "description": "Name of the Subnetwork resource.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/subnetworks/{subnetwork}/setPrivateIpGoogleAccess", + "request": { + "$ref": "SubnetworksSetPrivateIpGoogleAccessRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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" + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource.", + "flatPath": "projects/{project}/regions/{region}/subnetworks/{resource}/testIamPermissions", + "httpMethod": "POST", + "id": "compute.subnetworks.testIamPermissions", + "parameterOrder": [ + "project", + "region", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/subnetworks/{resource}/testIamPermissions", + "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" + ] } } }, - "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" - }, - "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" - }, - "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" + "targetGrpcProxies": { + "methods": { + "delete": { + "description": "Deletes the specified TargetGrpcProxy in the given scope", + "flatPath": "projects/{project}/global/targetGrpcProxies/{targetGrpcProxy}", + "httpMethod": "DELETE", + "id": "compute.targetGrpcProxies.delete", + "parameterOrder": [ + "project", + "targetGrpcProxy" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "targetGrpcProxy": { + "description": "Name of the TargetGrpcProxy resource to delete.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/targetGrpcProxies/{targetGrpcProxy}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "headerMatches": { - "description": "Specifies a list of header match criteria, all of which must match corresponding headers in the request.", - "type": "array", - "items": { - "$ref": "HttpHeaderMatch" - } + "get": { + "description": "Returns the specified TargetGrpcProxy resource in the given scope.", + "flatPath": "projects/{project}/global/targetGrpcProxies/{targetGrpcProxy}", + "httpMethod": "GET", + "id": "compute.targetGrpcProxies.get", + "parameterOrder": [ + "project", + "targetGrpcProxy" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "targetGrpcProxy": { + "description": "Name of the TargetGrpcProxy resource to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/targetGrpcProxies/{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" + ] }, - "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" - } + "insert": { + "description": "Creates a TargetGrpcProxy in the specified project in the given scope\nusing the parameters that are included in the request.", + "flatPath": "projects/{project}/global/targetGrpcProxies", + "httpMethod": "POST", + "id": "compute.targetGrpcProxies.insert", + "parameterOrder": [ + "project" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/targetGrpcProxies", + "request": { + "$ref": "TargetGrpcProxy" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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" - } + "list": { + "description": "Lists the TargetGrpcProxies for a project in the given scope.", + "flatPath": "projects/{project}/global/targetGrpcProxies", + "httpMethod": "GET", + "id": "compute.targetGrpcProxies.list", + "parameterOrder": [ + "project" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/global/targetGrpcProxies", + "response": { + "$ref": "TargetGrpcProxyList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "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" + "patch": { + "description": "Patches the specified TargetGrpcProxy resource with the data included in\nthe request. This method supports PATCH\nsemantics and usesJSON merge\npatch format and processing rules.", + "flatPath": "projects/{project}/global/targetGrpcProxies/{targetGrpcProxy}", + "httpMethod": "PATCH", + "id": "compute.targetGrpcProxies.patch", + "parameterOrder": [ + "project", + "targetGrpcProxy" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "targetGrpcProxy": { + "description": "Name of the TargetGrpcProxy resource to patch.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/targetGrpcProxies/{targetGrpcProxy}", + "request": { + "$ref": "TargetGrpcProxy" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] } } }, - "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" + "targetHttpProxies": { + "methods": { + "aggregatedList": { + "description": "Retrieves the list of all TargetHttpProxy resources, regional and global,\navailable to the specified project.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", + "flatPath": "projects/{project}/aggregated/targetHttpProxies", + "httpMethod": "GET", + "id": "compute.targetHttpProxies.aggregatedList", + "parameterOrder": [ + "project" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region,\nglobal) should be included in the response. For new resource types added\nafter this field, the flag has no effect as new resource types will always\ninclude every visible scope for each scope type in response. For resource\ntypes which predate this field, if this flag is omitted or false, only\nscopes of the scope types where the resource type is expected to be found\nwill be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Name of the project scoping this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which\naggregated list request is invoked for subnetworks list-usable api.", + "format": "int64", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/aggregated/targetHttpProxies", + "response": { + "$ref": "TargetHttpProxyAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "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" + "delete": { + "description": "Deletes the specified TargetHttpProxy resource.", + "flatPath": "projects/{project}/global/targetHttpProxies/{targetHttpProxy}", + "httpMethod": "DELETE", + "id": "compute.targetHttpProxies.delete", + "parameterOrder": [ + "project", + "targetHttpProxy" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "targetHttpProxy": { + "description": "Name of the TargetHttpProxy resource to delete.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/targetHttpProxies/{targetHttpProxy}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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" + "get": { + "description": "Returns the specified TargetHttpProxy resource.", + "flatPath": "projects/{project}/global/targetHttpProxies/{targetHttpProxy}", + "httpMethod": "GET", + "id": "compute.targetHttpProxies.get", + "parameterOrder": [ + "project", + "targetHttpProxy" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "targetHttpProxy": { + "description": "Name of the TargetHttpProxy resource to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/targetHttpProxies/{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" + ] }, - "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" + "insert": { + "description": "Creates a TargetHttpProxy resource in the specified\nproject using the data included in the request.", + "flatPath": "projects/{project}/global/targetHttpProxies", + "httpMethod": "POST", + "id": "compute.targetHttpProxies.insert", + "parameterOrder": [ + "project" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/targetHttpProxies", + "request": { + "$ref": "TargetHttpProxy" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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" + "list": { + "description": "Retrieves the list of TargetHttpProxy resources available\nto the specified project.", + "flatPath": "projects/{project}/global/targetHttpProxies", + "httpMethod": "GET", + "id": "compute.targetHttpProxies.list", + "parameterOrder": [ + "project" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/global/targetHttpProxies", + "response": { + "$ref": "TargetHttpProxyList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "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" - } - } - }, - "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" + "patch": { + "description": "Patches the specified TargetHttpProxy resource with the data included in\nthe request. This method supports PATCH\nsemantics and usesJSON merge\npatch format and processing rules.", + "flatPath": "projects/{project}/global/targetHttpProxies/{targetHttpProxy}", + "httpMethod": "PATCH", + "id": "compute.targetHttpProxies.patch", + "parameterOrder": [ + "project", + "targetHttpProxy" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "targetHttpProxy": { + "description": "Name of the TargetHttpProxy resource to patch.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/targetHttpProxies/{targetHttpProxy}", + "request": { + "$ref": "TargetHttpProxy" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "rangeEnd": { - "description": "The end of the range (exclusive) in signed long integer format.", - "type": "string", - "format": "int64" + "setUrlMap": { + "description": "Changes the URL map for TargetHttpProxy.", + "flatPath": "projects/{project}/targetHttpProxies/{targetHttpProxy}/setUrlMap", + "httpMethod": "POST", + "id": "compute.targetHttpProxies.setUrlMap", + "parameterOrder": [ + "project", + "targetHttpProxy" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "targetHttpProxy": { + "description": "Name of the TargetHttpProxy to set a URL map for.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/targetHttpProxies/{targetHttpProxy}/setUrlMap", + "request": { + "$ref": "UrlMapReference" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] } } }, - "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" + "targetHttpsProxies": { + "methods": { + "aggregatedList": { + "description": "Retrieves the list of all TargetHttpsProxy resources, regional and global,\navailable to the specified project.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", + "flatPath": "projects/{project}/aggregated/targetHttpsProxies", + "httpMethod": "GET", + "id": "compute.targetHttpsProxies.aggregatedList", + "parameterOrder": [ + "project" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region,\nglobal) should be included in the response. For new resource types added\nafter this field, the flag has no effect as new resource types will always\ninclude every visible scope for each scope type in response. For resource\ntypes which predate this field, if this flag is omitted or false, only\nscopes of the scope types where the resource type is expected to be found\nwill be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Name of the project scoping this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which\naggregated list request is invoked for subnetworks list-usable api.", + "format": "int64", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/aggregated/targetHttpsProxies", + "response": { + "$ref": "TargetHttpsProxyAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "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" + "delete": { + "description": "Deletes the specified TargetHttpsProxy resource.", + "flatPath": "projects/{project}/global/targetHttpsProxies/{targetHttpsProxy}", + "httpMethod": "DELETE", + "id": "compute.targetHttpsProxies.delete", + "parameterOrder": [ + "project", + "targetHttpsProxy" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "targetHttpsProxy": { + "description": "Name of the TargetHttpsProxy resource to delete.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/targetHttpsProxies/{targetHttpsProxy}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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" + "get": { + "description": "Returns the specified TargetHttpsProxy resource.", + "flatPath": "projects/{project}/global/targetHttpsProxies/{targetHttpsProxy}", + "httpMethod": "GET", + "id": "compute.targetHttpsProxies.get", + "parameterOrder": [ + "project", + "targetHttpsProxy" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "targetHttpsProxy": { + "description": "Name of the TargetHttpsProxy resource to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/targetHttpsProxies/{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" + ] }, - "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" + "insert": { + "description": "Creates a TargetHttpsProxy resource in the specified\nproject using the data included in the request.", + "flatPath": "projects/{project}/global/targetHttpsProxies", + "httpMethod": "POST", + "id": "compute.targetHttpsProxies.insert", + "parameterOrder": [ + "project" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/targetHttpsProxies", + "request": { + "$ref": "TargetHttpsProxy" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "host": { - "description": "Host portion of the URL. If headers contains a host header, then host must also match the header value.", - "type": "string" + "list": { + "description": "Retrieves the list of TargetHttpsProxy resources\navailable to the specified project.", + "flatPath": "projects/{project}/global/targetHttpsProxies", + "httpMethod": "GET", + "id": "compute.targetHttpsProxies.list", + "parameterOrder": [ + "project" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/global/targetHttpsProxies", + "response": { + "$ref": "TargetHttpsProxyList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "path": { - "description": "Path portion of the URL.", - "type": "string" + "patch": { + "description": "Patches the specified TargetHttpsProxy resource with the data included in\nthe request. This method supports PATCH\nsemantics and usesJSON merge\npatch format and processing rules.", + "flatPath": "projects/{project}/global/targetHttpsProxies/{targetHttpsProxy}", + "httpMethod": "PATCH", + "id": "compute.targetHttpsProxies.patch", + "parameterOrder": [ + "project", + "targetHttpsProxy" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "targetHttpsProxy": { + "description": "Name of the TargetHttpsProxy resource to patch.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/targetHttpsProxies/{targetHttpsProxy}", + "request": { + "$ref": "TargetHttpsProxy" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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" - } + "setCertificateMap": { + "description": "Changes the Certificate Map for TargetHttpsProxy.", + "flatPath": "projects/{project}/global/targetHttpsProxies/{targetHttpsProxy}/setCertificateMap", + "httpMethod": "POST", + "id": "compute.targetHttpsProxies.setCertificateMap", + "parameterOrder": [ + "project", + "targetHttpsProxy" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "targetHttpsProxy": { + "description": "Name of the TargetHttpsProxy resource whose CertificateMap is\nto be set. The name must be 1-63 characters long, and comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/targetHttpsProxies/{targetHttpsProxy}/setCertificateMap", + "request": { + "$ref": "TargetHttpsProxiesSetCertificateMapRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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" + "setQuicOverride": { + "description": "Sets the QUIC override policy for TargetHttpsProxy.", + "flatPath": "projects/{project}/global/targetHttpsProxies/{targetHttpsProxy}/setQuicOverride", + "httpMethod": "POST", + "id": "compute.targetHttpsProxies.setQuicOverride", + "parameterOrder": [ + "project", + "targetHttpsProxy" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "targetHttpsProxy": { + "description": "Name of the TargetHttpsProxy resource to set the QUIC override policy for.\nThe name should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/targetHttpsProxies/{targetHttpsProxy}/setQuicOverride", + "request": { + "$ref": "TargetHttpsProxiesSetQuicOverrideRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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" + "setSslCertificates": { + "description": "Replaces SslCertificates for TargetHttpsProxy.", + "flatPath": "projects/{project}/targetHttpsProxies/{targetHttpsProxy}/setSslCertificates", + "httpMethod": "POST", + "id": "compute.targetHttpsProxies.setSslCertificates", + "parameterOrder": [ + "project", + "targetHttpsProxy" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "targetHttpsProxy": { + "description": "Name of the TargetHttpsProxy resource to set an\nSslCertificates resource for.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/targetHttpsProxies/{targetHttpsProxy}/setSslCertificates", + "request": { + "$ref": "TargetHttpsProxiesSetSslCertificatesRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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" + "setSslPolicy": { + "description": "Sets the SSL policy for TargetHttpsProxy. The SSL policy specifies the\nserver-side support for SSL features. This affects connections between\nclients and the HTTPS proxy load balancer. They do not affect the\nconnection between the load balancer and the backends.", + "flatPath": "projects/{project}/global/targetHttpsProxies/{targetHttpsProxy}/setSslPolicy", + "httpMethod": "POST", + "id": "compute.targetHttpsProxies.setSslPolicy", + "parameterOrder": [ + "project", + "targetHttpsProxy" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "targetHttpsProxy": { + "description": "Name of the TargetHttpsProxy resource whose SSL policy is\nto be set. The name must be 1-63 characters long, and comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/targetHttpsProxies/{targetHttpsProxy}/setSslPolicy", + "request": { + "$ref": "SslPolicyReference" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "value": { - "description": "Header value.", - "type": "string" + "setUrlMap": { + "description": "Changes the URL map for TargetHttpsProxy.", + "flatPath": "projects/{project}/targetHttpsProxies/{targetHttpsProxy}/setUrlMap", + "httpMethod": "POST", + "id": "compute.targetHttpsProxies.setUrlMap", + "parameterOrder": [ + "project", + "targetHttpsProxy" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "targetHttpsProxy": { + "description": "Name of the TargetHttpsProxy resource whose URL map is\nto be set.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/targetHttpsProxies/{targetHttpsProxy}/setUrlMap", + "request": { + "$ref": "UrlMapReference" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] } } }, - "UrlMapsAggregatedList": { - "id": "UrlMapsAggregatedList", - "type": "object", - "properties": { - "kind": { - "description": "Type of resource.", - "default": "compute#urlMapsAggregatedList", - "type": "string" + "targetInstances": { + "methods": { + "aggregatedList": { + "description": "Retrieves an aggregated list of target instances.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", + "flatPath": "projects/{project}/aggregated/targetInstances", + "httpMethod": "GET", + "id": "compute.targetInstances.aggregatedList", + "parameterOrder": [ + "project" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region,\nglobal) should be included in the response. For new resource types added\nafter this field, the flag has no effect as new resource types will always\ninclude every visible scope for each scope type in response. For resource\ntypes which predate this field, if this flag is omitted or false, only\nscopes of the scope types where the resource type is expected to be found\nwill be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which\naggregated list request is invoked for subnetworks list-usable api.", + "format": "int64", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/aggregated/targetInstances", + "response": { + "$ref": "TargetInstanceAggregatedList" + }, + "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] Unique identifier for the resource; defined by the server.", - "type": "string" + "delete": { + "description": "Deletes the specified TargetInstance resource.", + "flatPath": "projects/{project}/zones/{zone}/targetInstances/{targetInstance}", + "httpMethod": "DELETE", + "id": "compute.targetInstances.delete", + "parameterOrder": [ + "project", + "zone", + "targetInstance" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "targetInstance": { + "description": "Name of the TargetInstance resource to delete.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "zone": { + "description": "Name of the zone scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/targetInstances/{targetInstance}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "items": { - "description": "A list of UrlMapsScopedList resources.", - "type": "object", - "additionalProperties": { - "description": "Name of the scope containing this set of UrlMaps.", - "$ref": "UrlMapsScopedList" - } + "get": { + "description": "Returns the specified TargetInstance resource.", + "flatPath": "projects/{project}/zones/{zone}/targetInstances/{targetInstance}", + "httpMethod": "GET", + "id": "compute.targetInstances.get", + "parameterOrder": [ + "project", + "zone", + "targetInstance" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "targetInstance": { + "description": "Name of the TargetInstance resource to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "zone": { + "description": "Name of the zone scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/targetInstances/{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" + ] }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the 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": { + "description": "Creates a TargetInstance resource in the specified project and zone using\nthe data included in the request.", + "flatPath": "projects/{project}/zones/{zone}/targetInstances", + "httpMethod": "POST", + "id": "compute.targetInstances.insert", + "parameterOrder": [ + "project", + "zone" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "Name of the zone scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/targetInstances", + "request": { + "$ref": "TargetInstance" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "list": { + "description": "Retrieves a list of TargetInstance resources available to the specified\nproject and zone.", + "flatPath": "projects/{project}/zones/{zone}/targetInstances", + "httpMethod": "GET", + "id": "compute.targetInstances.list", + "parameterOrder": [ + "project", + "zone" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "zone": { + "description": "Name of the zone scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/targetInstances", + "response": { + "$ref": "TargetInstanceList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "setSecurityPolicy": { + "description": "Sets the Google Cloud Armor security policy for the specified target\ninstance. For more information, seeGoogle\nCloud Armor Overview", + "flatPath": "projects/{project}/zones/{zone}/targetInstances/{targetInstance}/setSecurityPolicy", + "httpMethod": "POST", + "id": "compute.targetInstances.setSecurityPolicy", + "parameterOrder": [ + "project", + "zone", + "targetInstance" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(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" - } - } - } + "targetInstance": { + "description": "Name of the TargetInstance resource to which the security policy should be\nset. The name should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "zone": { + "description": "Name of the zone scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "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" - } + }, + "path": "projects/{project}/zones/{zone}/targetInstances/{targetInstance}/setSecurityPolicy", + "request": { + "$ref": "SecurityPolicyReference" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource.", + "flatPath": "projects/{project}/zones/{zone}/targetInstances/{resource}/testIamPermissions", + "httpMethod": "POST", + "id": "compute.targetInstances.testIamPermissions", + "parameterOrder": [ + "project", + "zone", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "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" - } - } - } - }, - "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" - }, - "cacheTags": { - "description": "A list of cache tags used to identify cached objects. - Cache tags are specified when the response is first cached, by setting the `Cache-Tag` response header at the origin. - Multiple cache tags in the same invalidation request are treated as Boolean `OR` - for example, `tag1 OR tag2 OR tag3`. - If other fields are also specified, these are treated as Boolean `AND` with any tags. Up to 10 tags can be specified in a single invalidation request.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "RegionUrlMapsValidateRequest": { - "id": "RegionUrlMapsValidateRequest", - "type": "object", - "properties": { - "resource": { - "description": "Content of the UrlMap to be validated.", - "$ref": "UrlMap" + }, + "path": "projects/{project}/zones/{zone}/targetInstances/{resource}/testIamPermissions", + "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" + ] } } }, - "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" + "targetPools": { + "methods": { + "addHealthCheck": { + "description": "Adds health check URLs to a target pool.", + "flatPath": "projects/{project}/regions/{region}/targetPools/{targetPool}/addHealthCheck", + "httpMethod": "POST", + "id": "compute.targetPools.addHealthCheck", + "parameterOrder": [ + "project", + "region", + "targetPool" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "targetPool": { + "description": "Name of the target pool to add a health check to.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/targetPools/{targetPool}/addHealthCheck", + "request": { + "$ref": "TargetPoolsAddHealthCheckRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "addInstance": { + "description": "Adds an instance to a target pool.", + "flatPath": "projects/{project}/regions/{region}/targetPools/{targetPool}/addInstance", + "httpMethod": "POST", + "id": "compute.targetPools.addInstance", + "parameterOrder": [ + "project", + "region", + "targetPool" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "targetPool": { + "description": "Name of the TargetPool resource to add instances to.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/targetPools/{targetPool}/addInstance", + "request": { + "$ref": "TargetPoolsAddInstanceRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "aggregatedList": { + "description": "Retrieves an aggregated list of target pools.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", + "flatPath": "projects/{project}/aggregated/targetPools", + "httpMethod": "GET", + "id": "compute.targetPools.aggregatedList", + "parameterOrder": [ + "project" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region,\nglobal) should be included in the response. For new resource types added\nafter this field, the flag has no effect as new resource types will always\ninclude every visible scope for each scope type in response. For resource\ntypes which predate this field, if this flag is omitted or false, only\nscopes of the scope types where the resource type is expected to be found\nwill be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`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\n`nextPageToken` returned by a previous list request to get\nthe 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.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which\naggregated list request is invoked for subnetworks list-usable api.", + "format": "int64", + "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" - ] + "path": "projects/{project}/aggregated/targetPools", + "response": { + "$ref": "TargetPoolAggregatedList" }, - "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." - ], - "enum": [ - "IPV4_IPV6", - "IPV4_ONLY", - "IPV6_ONLY" + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ] }, - "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." + "delete": { + "description": "Deletes the specified target pool.", + "flatPath": "projects/{project}/regions/{region}/targetPools/{targetPool}", + "httpMethod": "DELETE", + "id": "compute.targetPools.delete", + "parameterOrder": [ + "project", + "region", + "targetPool" ], - "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" - }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "targetPool": { + "description": "Name of the TargetPool resource to delete.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "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" - } + }, + "path": "projects/{project}/regions/{region}/targetPools/{targetPool}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "get": { + "description": "Returns the specified target pool.", + "flatPath": "projects/{project}/regions/{region}/targetPools/{targetPool}", + "httpMethod": "GET", + "id": "compute.targetPools.get", + "parameterOrder": [ + "project", + "region", + "targetPool" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "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" - } - } - } + "targetPool": { + "description": "Name of the TargetPool resource to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "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" - } - } - }, - "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" + }, + "path": "projects/{project}/regions/{region}/targetPools/{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" + ] }, - "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" + "getHealth": { + "description": "Gets the most recent health check results for each IP for the\ninstance that is referenced by the given target pool.", + "flatPath": "projects/{project}/regions/{region}/targetPools/{targetPool}/getHealth", + "httpMethod": "POST", + "id": "compute.targetPools.getHealth", + "parameterOrder": [ + "project", + "region", + "targetPool" ], - "enum": [ - "CONNECTION_REDUNDANCY_MET", - "CONNECTION_REDUNDANCY_NOT_MET" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "targetPool": { + "description": "Name of the TargetPool resource to which the queried instance belongs.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/targetPools/{targetPool}/getHealth", + "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" ] }, - "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": [ - "" + "insert": { + "description": "Creates a target pool in the specified project and region using\nthe data included in the request.", + "flatPath": "projects/{project}/regions/{region}/targetPools", + "httpMethod": "POST", + "id": "compute.targetPools.insert", + "parameterOrder": [ + "project", + "region" ], - "enum": [ - "INCOMPLETE_TUNNELS_COVERAGE" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/targetPools", + "request": { + "$ref": "TargetPool" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] - } - } - }, - "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" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the 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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "list": { + "description": "Retrieves a list of target pools available to the specified\nproject and region.", + "flatPath": "projects/{project}/regions/{region}/targetPools", + "httpMethod": "GET", + "id": "compute.targetPools.list", + "parameterOrder": [ + "project", + "region" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`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\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" } - } - } - } - }, - "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" - ] }, - "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" + "path": "projects/{project}/regions/{region}/targetPools", + "response": { + "$ref": "TargetPoolList" + }, + "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] 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." + "removeHealthCheck": { + "description": "Removes health check URL from a target pool.", + "flatPath": "projects/{project}/regions/{region}/targetPools/{targetPool}/removeHealthCheck", + "httpMethod": "POST", + "id": "compute.targetPools.removeHealthCheck", + "parameterOrder": [ + "project", + "region", + "targetPool" ], - "enum": [ - "ALLOCATING_RESOURCES", - "AUTHORIZATION_ERROR", - "DEPROVISIONING", - "ESTABLISHED", - "FAILED", - "FIRST_HANDSHAKE", - "NEGOTIATION_FAILURE", - "NETWORK_ERROR", - "NO_INCOMING_PACKETS", - "PROVISIONING", - "REJECTED", - "STOPPED", - "WAITING_FOR_FULL_CONFIG" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "targetPool": { + "description": "Name of the target pool to remove health checks from.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/targetPools/{targetPool}/removeHealthCheck", + "request": { + "$ref": "TargetPoolsRemoveHealthCheckRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "removeInstance": { + "description": "Removes instance URL from a target pool.", + "flatPath": "projects/{project}/regions/{region}/targetPools/{targetPool}/removeInstance", + "httpMethod": "POST", + "id": "compute.targetPools.removeInstance", + "parameterOrder": [ + "project", + "region", + "targetPool" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(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" - } - } - } + "targetPool": { + "description": "Name of the TargetPool resource to remove instances from.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "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" - } + }, + "path": "projects/{project}/regions/{region}/targetPools/{targetPool}/removeInstance", + "request": { + "$ref": "TargetPoolsRemoveInstanceRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "setBackup": { + "description": "Changes a backup target pool's configurations.", + "flatPath": "projects/{project}/regions/{region}/targetPools/{targetPool}/setBackup", + "httpMethod": "POST", + "id": "compute.targetPools.setBackup", + "parameterOrder": [ + "project", + "region", + "targetPool" + ], + "parameters": { + "failoverRatio": { + "description": "New failoverRatio value for the target pool.", + "format": "float", + "location": "query", + "type": "number" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "targetPool": { + "description": "Name of the TargetPool resource to set a backup pool for.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" } - } - } - } - }, - "ZoneList": { - "id": "ZoneList", - "description": "Contains a list of zone resources.", - "type": "object", - "properties": { - "kind": { - "description": "Type of resource.", - "default": "compute#zoneList", - "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" + }, + "path": "projects/{project}/regions/{region}/targetPools/{targetPool}/setBackup", + "request": { + "$ref": "TargetReference" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "setSecurityPolicy": { + "description": "Sets the Google Cloud Armor security policy for the specified target pool.\nFor more information, seeGoogle\nCloud Armor Overview", + "flatPath": "projects/{project}/regions/{region}/targetPools/{targetPool}/setSecurityPolicy", + "httpMethod": "POST", + "id": "compute.targetPools.setSecurityPolicy", + "parameterOrder": [ + "project", + "region", + "targetPool" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "targetPool": { + "description": "Name of the TargetPool resource to which the security policy should be\nset. The name should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/targetPools/{targetPool}/setSecurityPolicy", + "request": { + "$ref": "SecurityPolicyReference" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "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", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource.", + "flatPath": "projects/{project}/regions/{region}/targetPools/{resource}/testIamPermissions", + "httpMethod": "POST", + "id": "compute.targetPools.testIamPermissions", + "parameterOrder": [ + "project", + "region", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "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.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" } - } + }, + "path": "projects/{project}/regions/{region}/targetPools/{resource}/testIamPermissions", + "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" + ] } } }, - "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": [ - "", - "" + "targetSslProxies": { + "methods": { + "delete": { + "description": "Deletes the specified TargetSslProxy resource.", + "flatPath": "projects/{project}/global/targetSslProxies/{targetSslProxy}", + "httpMethod": "DELETE", + "id": "compute.targetSslProxies.delete", + "parameterOrder": [ + "project", + "targetSslProxy" ], - "enum": [ - "DOWN", - "UP" + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "targetSslProxy": { + "description": "Name of the TargetSslProxy resource to delete.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/targetSslProxies/{targetSslProxy}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ] }, - "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" - } - } - } - }, - "name": "compute", - "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" + "get": { + "description": "Returns the specified TargetSslProxy resource.", + "flatPath": "projects/{project}/global/targetSslProxies/{targetSslProxy}", + "httpMethod": "GET", + "id": "compute.targetSslProxies.get", + "parameterOrder": [ + "project", + "targetSslProxy" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "targetSslProxy": { + "description": "Name of the TargetSslProxy resource to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/targetSslProxies/{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" + ] }, - "https://www.googleapis.com/auth/devstorage.read_only": { - "description": "View your data in Google Cloud Storage" + "insert": { + "description": "Creates a TargetSslProxy resource in the specified project using\nthe data included in the request.", + "flatPath": "projects/{project}/global/targetSslProxies", + "httpMethod": "POST", + "id": "compute.targetSslProxies.insert", + "parameterOrder": [ + "project" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/targetSslProxies", + "request": { + "$ref": "TargetSslProxy" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, - "https://www.googleapis.com/auth/devstorage.read_write": { - "description": "Manage your data in Cloud Storage and see the email address of your Google Account" - } - } - } - }, - "protocol": "rest", - "rootUrl": "https://compute.googleapis.com/", - "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" - }, - "version": "v1", - "title": "Compute Engine API", - "ownerDomain": "google.com", - "resources": { - "globalOperations": { - "methods": { "list": { - "id": "compute.globalOperations.list", - "path": "projects/{project}/global/operations", - "flatPath": "projects/{project}/global/operations", + "description": "Retrieves the list of TargetSslProxy resources\navailable to the specified project.", + "flatPath": "projects/{project}/global/targetSslProxies", "httpMethod": "GET", + "id": "compute.targetSslProxies.list", + "parameterOrder": [ + "project" + ], "parameters": { "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", "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", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", "location": "query", - "type": "integer", - "format": "uint32" + "minimum": "0", + "type": "integer" }, "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", "location": "query", "type": "string" }, "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", "location": "query", "type": "string" }, "project": { "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", "required": true, "type": "string" }, "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", "location": "query", "type": "boolean" } }, - "parameterOrder": [ - "project" - ], + "path": "projects/{project}/global/targetSslProxies", "response": { - "$ref": "OperationList" + "$ref": "TargetSslProxyList" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/compute", "https://www.googleapis.com/auth/compute.readonly" + ] + }, + "setBackendService": { + "description": "Changes the BackendService for TargetSslProxy.", + "flatPath": "projects/{project}/global/targetSslProxies/{targetSslProxy}/setBackendService", + "httpMethod": "POST", + "id": "compute.targetSslProxies.setBackendService", + "parameterOrder": [ + "project", + "targetSslProxy" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "targetSslProxy": { + "description": "Name of the TargetSslProxy resource whose BackendService resource\nis to be set.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/targetSslProxies/{targetSslProxy}/setBackendService", + "request": { + "$ref": "TargetSslProxiesSetBackendServiceRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "setCertificateMap": { + "description": "Changes the Certificate Map for TargetSslProxy.", + "flatPath": "projects/{project}/global/targetSslProxies/{targetSslProxy}/setCertificateMap", + "httpMethod": "POST", + "id": "compute.targetSslProxies.setCertificateMap", + "parameterOrder": [ + "project", + "targetSslProxy" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "targetSslProxy": { + "description": "Name of the TargetSslProxy resource whose CertificateMap is\nto be set. The name must be 1-63 characters long, and comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/targetSslProxies/{targetSslProxy}/setCertificateMap", + "request": { + "$ref": "TargetSslProxiesSetCertificateMapRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "setProxyHeader": { + "description": "Changes the ProxyHeaderType for TargetSslProxy.", + "flatPath": "projects/{project}/global/targetSslProxies/{targetSslProxy}/setProxyHeader", + "httpMethod": "POST", + "id": "compute.targetSslProxies.setProxyHeader", + "parameterOrder": [ + "project", + "targetSslProxy" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "targetSslProxy": { + "description": "Name of the TargetSslProxy resource whose ProxyHeader is to be set.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/targetSslProxies/{targetSslProxy}/setProxyHeader", + "request": { + "$ref": "TargetSslProxiesSetProxyHeaderRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "setSslCertificates": { + "description": "Changes SslCertificates for TargetSslProxy.", + "flatPath": "projects/{project}/global/targetSslProxies/{targetSslProxy}/setSslCertificates", + "httpMethod": "POST", + "id": "compute.targetSslProxies.setSslCertificates", + "parameterOrder": [ + "project", + "targetSslProxy" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "targetSslProxy": { + "description": "Name of the TargetSslProxy resource whose SslCertificate resource\nis to be set.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/targetSslProxies/{targetSslProxy}/setSslCertificates", + "request": { + "$ref": "TargetSslProxiesSetSslCertificatesRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "setSslPolicy": { + "description": "Sets the SSL policy for TargetSslProxy. The SSL policy specifies the\nserver-side support for SSL features. This affects connections between\nclients and the load balancer. They do not affect the\nconnection between the load balancer and the backends.", + "flatPath": "projects/{project}/global/targetSslProxies/{targetSslProxy}/setSslPolicy", + "httpMethod": "POST", + "id": "compute.targetSslProxies.setSslPolicy", + "parameterOrder": [ + "project", + "targetSslProxy" ], - "description": "Retrieves a list of Operation resources contained within the specified project." + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "targetSslProxy": { + "description": "Name of the TargetSslProxy resource whose SSL policy is\nto be set. The name must be 1-63 characters long, and comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/targetSslProxies/{targetSslProxy}/setSslPolicy", + "request": { + "$ref": "SslPolicyReference" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] }, + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource.", + "flatPath": "projects/{project}/global/targetSslProxies/{resource}/testIamPermissions", + "httpMethod": "POST", + "id": "compute.targetSslProxies.testIamPermissions", + "parameterOrder": [ + "project", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/targetSslProxies/{resource}/testIamPermissions", + "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" + ] + } + } + }, + "targetTcpProxies": { + "methods": { "aggregatedList": { - "id": "compute.globalOperations.aggregatedList", - "path": "projects/{project}/aggregated/operations", - "flatPath": "projects/{project}/aggregated/operations", + "description": "Retrieves the list of all TargetTcpProxy resources, regional and global,\navailable to the specified project.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", + "flatPath": "projects/{project}/aggregated/targetTcpProxies", "httpMethod": "GET", + "id": "compute.targetTcpProxies.aggregatedList", + "parameterOrder": [ + "project" + ], "parameters": { "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", "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.", + "description": "Indicates whether every visible scope for each scope type (zone, region,\nglobal) should be included in the response. For new resource types added\nafter this field, the flag has no effect as new resource types will always\ninclude every visible scope for each scope type in response. For resource\ntypes which predate this field, if this flag is omitted or false, only\nscopes of the scope types where the resource type is expected to be found\nwill 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", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", "location": "query", - "type": "integer", - "format": "uint32" + "minimum": "0", + "type": "integer" }, "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", "location": "query", "type": "string" }, "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", "location": "query", "type": "string" }, "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "description": "Name of the project scoping this request.", "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", "required": true, "type": "string" }, "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith 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.", + "description": "The Shared VPC service project id or service project number for which\naggregated list request is invoked for subnetworks list-usable api.", + "format": "int64", "location": "query", - "type": "string", - "format": "int64" + "type": "string" } }, - "parameterOrder": [ - "project" - ], + "path": "projects/{project}/aggregated/targetTcpProxies", "response": { - "$ref": "OperationAggregatedList" + "$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 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", + "delete": { + "description": "Deletes the specified TargetTcpProxy resource.", + "flatPath": "projects/{project}/global/targetTcpProxies/{targetTcpProxy}", + "httpMethod": "DELETE", + "id": "compute.targetTcpProxies.delete", + "parameterOrder": [ + "project", + "targetTcpProxy" + ], "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}", + "project": { + "description": "Project ID for this request.", "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", "required": true, "type": "string" }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "targetTcpProxy": { + "description": "Name of the TargetTcpProxy resource to delete.", "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", "required": true, "type": "string" } }, - "parameterOrder": [ - "project", - "operation" - ], + "path": "projects/{project}/global/targetTcpProxies/{targetTcpProxy}", "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." + "https://www.googleapis.com/auth/compute" + ] }, - "wait": { - "id": "compute.globalOperations.wait", - "path": "projects/{project}/global/operations/{operation}/wait", - "flatPath": "projects/{project}/global/operations/{operation}/wait", - "httpMethod": "POST", + "get": { + "description": "Returns the specified TargetTcpProxy resource.", + "flatPath": "projects/{project}/global/targetTcpProxies/{targetTcpProxy}", + "httpMethod": "GET", + "id": "compute.targetTcpProxies.get", + "parameterOrder": [ + "project", + "targetTcpProxy" + ], "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}", + "project": { + "description": "Project ID for this request.", "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", "required": true, "type": "string" }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "targetTcpProxy": { + "description": "Name of the TargetTcpProxy resource to return.", "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", "required": true, "type": "string" } }, - "parameterOrder": [ - "project", - "operation" - ], + "path": "projects/{project}/global/targetTcpProxies/{targetTcpProxy}", "response": { - "$ref": "Operation" + "$ref": "TargetTcpProxy" }, "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`. " + ] }, - "delete": { - "id": "compute.globalOperations.delete", - "path": "projects/{project}/global/operations/{operation}", - "flatPath": "projects/{project}/global/operations/{operation}", - "httpMethod": "DELETE", + "insert": { + "description": "Creates a TargetTcpProxy resource in the specified project using\nthe data included in the request.", + "flatPath": "projects/{project}/global/targetTcpProxies", + "httpMethod": "POST", + "id": "compute.targetTcpProxies.insert", + "parameterOrder": [ + "project" + ], "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", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", "required": true, "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" } }, - "parameterOrder": [ - "project", - "operation" - ], + "path": "projects/{project}/global/targetTcpProxies", + "request": { + "$ref": "TargetTcpProxy" + }, + "response": { + "$ref": "Operation" + }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified Operations resource." - } - } - }, - "globalOrganizationOperations": { - "methods": { + ] + }, "list": { - "id": "compute.globalOrganizationOperations.list", - "path": "locations/global/operations", - "flatPath": "locations/global/operations", + "description": "Retrieves the list of TargetTcpProxy resources\navailable to the specified project.", + "flatPath": "projects/{project}/global/targetTcpProxies", "httpMethod": "GET", + "id": "compute.targetTcpProxies.list", + "parameterOrder": [ + "project" + ], "parameters": { "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", "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", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", "location": "query", - "type": "integer", - "format": "uint32" + "minimum": "0", + "type": "integer" }, "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", "location": "query", "type": "string" }, "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", "location": "query", "type": "string" }, - "parentId": { - "description": "Parent ID for this request.", - "location": "query", + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, "type": "string" }, "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", "location": "query", "type": "boolean" } }, + "path": "projects/{project}/global/targetTcpProxies", "response": { - "$ref": "OperationList" + "$ref": "TargetTcpProxyList" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/compute", "https://www.googleapis.com/auth/compute.readonly" + ] + }, + "setBackendService": { + "description": "Changes the BackendService for TargetTcpProxy.", + "flatPath": "projects/{project}/global/targetTcpProxies/{targetTcpProxy}/setBackendService", + "httpMethod": "POST", + "id": "compute.targetTcpProxies.setBackendService", + "parameterOrder": [ + "project", + "targetTcpProxy" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "targetTcpProxy": { + "description": "Name of the TargetTcpProxy resource whose BackendService resource\nis to be set.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/targetTcpProxies/{targetTcpProxy}/setBackendService", + "request": { + "$ref": "TargetTcpProxiesSetBackendServiceRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "setProxyHeader": { + "description": "Changes the ProxyHeaderType for TargetTcpProxy.", + "flatPath": "projects/{project}/global/targetTcpProxies/{targetTcpProxy}/setProxyHeader", + "httpMethod": "POST", + "id": "compute.targetTcpProxies.setProxyHeader", + "parameterOrder": [ + "project", + "targetTcpProxy" ], - "description": "Retrieves a list of Operation resources contained within the specified organization." - }, - "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}", + "project": { + "description": "Project ID for this request.", "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", "required": true, "type": "string" }, - "parentId": { - "description": "Parent ID for this request.", + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", "location": "query", "type": "string" + }, + "targetTcpProxy": { + "description": "Name of the TargetTcpProxy resource whose ProxyHeader is to be set.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" } }, - "parameterOrder": [ - "operation" - ], + "path": "projects/{project}/global/targetTcpProxies/{targetTcpProxy}/setProxyHeader", + "request": { + "$ref": "TargetTcpProxiesSetProxyHeaderRequest" + }, "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." + "https://www.googleapis.com/auth/compute" + ] }, - "delete": { - "id": "compute.globalOrganizationOperations.delete", - "path": "locations/global/operations/{operation}", - "flatPath": "locations/global/operations/{operation}", - "httpMethod": "DELETE", + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource.", + "flatPath": "projects/{project}/global/targetTcpProxies/{resource}/testIamPermissions", + "httpMethod": "POST", + "id": "compute.targetTcpProxies.testIamPermissions", + "parameterOrder": [ + "project", + "resource" + ], "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}", + "project": { + "description": "Project ID for this request.", "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", "required": true, "type": "string" }, - "parentId": { - "description": "Parent ID for this request.", - "location": "query", + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, "type": "string" } }, - "parameterOrder": [ - "operation" - ], + "path": "projects/{project}/global/targetTcpProxies/{resource}/testIamPermissions", + "request": { + "$ref": "TestPermissionsRequest" + }, + "response": { + "$ref": "TestPermissionsResponse" + }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified Operations resource." + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] } } }, - "zoneOperations": { + "targetVpnGateways": { "methods": { - "list": { - "id": "compute.zoneOperations.list", - "path": "projects/{project}/zones/{zone}/operations", - "flatPath": "projects/{project}/zones/{zone}/operations", + "aggregatedList": { + "description": "Retrieves an aggregated list of target VPN gateways.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", + "flatPath": "projects/{project}/aggregated/targetVpnGateways", "httpMethod": "GET", + "id": "compute.targetVpnGateways.aggregatedList", + "parameterOrder": [ + "project" + ], "parameters": { "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", "location": "query", "type": "string" }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region,\nglobal) should be included in the response. For new resource types added\nafter this field, the flag has no effect as new resource types will always\ninclude every visible scope for each scope type in response. For resource\ntypes which predate this field, if this flag is omitted or false, only\nscopes of the scope types where the resource type is expected to be found\nwill 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", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", "location": "query", - "type": "integer", - "format": "uint32" + "minimum": "0", + "type": "integer" }, "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", "location": "query", "type": "string" }, "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", "location": "query", "type": "string" }, "project": { "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", "required": true, "type": "string" }, "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith 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, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which\naggregated list request is invoked for subnetworks list-usable api.", + "format": "int64", + "location": "query", "type": "string" } }, - "parameterOrder": [ - "project", - "zone" - ], + "path": "projects/{project}/aggregated/targetVpnGateways", "response": { - "$ref": "OperationList" + "$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 a list of Operation resources contained within the specified zone." + ] }, - "get": { - "id": "compute.zoneOperations.get", - "path": "projects/{project}/zones/{zone}/operations/{operation}", - "flatPath": "projects/{project}/zones/{zone}/operations/{operation}", - "httpMethod": "GET", + "delete": { + "description": "Deletes the specified target VPN gateway.", + "flatPath": "projects/{project}/regions/{region}/targetVpnGateways/{targetVpnGateway}", + "httpMethod": "DELETE", + "id": "compute.targetVpnGateways.delete", + "parameterOrder": [ + "project", + "region", + "targetVpnGateway" + ], "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}", + "project": { + "description": "Project ID for this request.", "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", "required": true, "type": "string" }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "region": { + "description": "Name of the region for this request.", "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", "required": true, "type": "string" }, - "zone": { - "description": "Name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "targetVpnGateway": { + "description": "Name of the target VPN gateway to delete.", "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", "required": true, "type": "string" } }, - "parameterOrder": [ - "project", - "zone", - "operation" - ], + "path": "projects/{project}/regions/{region}/targetVpnGateways/{targetVpnGateway}", "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 zone-specific Operations resource." + "https://www.googleapis.com/auth/compute" + ] }, - "wait": { - "id": "compute.zoneOperations.wait", - "path": "projects/{project}/zones/{zone}/operations/{operation}/wait", - "flatPath": "projects/{project}/zones/{zone}/operations/{operation}/wait", - "httpMethod": "POST", + "get": { + "description": "Returns the specified target VPN gateway.", + "flatPath": "projects/{project}/regions/{region}/targetVpnGateways/{targetVpnGateway}", + "httpMethod": "GET", + "id": "compute.targetVpnGateways.get", + "parameterOrder": [ + "project", + "region", + "targetVpnGateway" + ], "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}", + "project": { + "description": "Project ID for this request.", "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", "required": true, "type": "string" }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "region": { + "description": "Name of the region for this request.", "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", "required": true, "type": "string" }, - "zone": { - "description": "Name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "targetVpnGateway": { + "description": "Name of the target VPN gateway to return.", "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", "required": true, "type": "string" } }, - "parameterOrder": [ - "project", - "zone", - "operation" - ], + "path": "projects/{project}/regions/{region}/targetVpnGateways/{targetVpnGateway}", "response": { - "$ref": "Operation" + "$ref": "TargetVpnGateway" }, "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`. " + ] }, - "delete": { - "id": "compute.zoneOperations.delete", - "path": "projects/{project}/zones/{zone}/operations/{operation}", - "flatPath": "projects/{project}/zones/{zone}/operations/{operation}", - "httpMethod": "DELETE", + "insert": { + "description": "Creates a target VPN gateway in the specified project and region using\nthe data included in the request.", + "flatPath": "projects/{project}/regions/{region}/targetVpnGateways", + "httpMethod": "POST", + "id": "compute.targetVpnGateways.insert", + "parameterOrder": [ + "project", + "region" + ], "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", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", "required": true, "type": "string" }, - "zone": { - "description": "Name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "region": { + "description": "Name of the region for this request.", "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", "required": true, "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" } }, - "parameterOrder": [ - "project", - "zone", - "operation" - ], + "path": "projects/{project}/regions/{region}/targetVpnGateways", + "request": { + "$ref": "TargetVpnGateway" + }, + "response": { + "$ref": "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", + "description": "Retrieves a list of target VPN gateways available to the specified\nproject and region.", + "flatPath": "projects/{project}/regions/{region}/targetVpnGateways", "httpMethod": "GET", + "id": "compute.targetVpnGateways.list", + "parameterOrder": [ + "project", + "region" + ], "parameters": { "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", "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", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", "location": "query", - "type": "integer", - "format": "uint32" + "minimum": "0", + "type": "integer" }, "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", "location": "query", "type": "string" }, "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", "location": "query", "type": "string" }, "project": { "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", "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", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", "required": true, "type": "string" }, "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", "location": "query", "type": "boolean" } }, - "parameterOrder": [ - "project", - "region" - ], + "path": "projects/{project}/regions/{region}/targetVpnGateways", "response": { - "$ref": "OperationList" + "$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 Operation resources contained within the specified region." + ] }, - "get": { - "id": "compute.regionOperations.get", - "path": "projects/{project}/regions/{region}/operations/{operation}", - "flatPath": "projects/{project}/regions/{region}/operations/{operation}", - "httpMethod": "GET", + "setLabels": { + "description": "Sets the labels on a TargetVpnGateway. To learn more about labels, read theLabeling\nResources documentation.", + "flatPath": "projects/{project}/regions/{region}/targetVpnGateways/{resource}/setLabels", + "httpMethod": "POST", + "id": "compute.targetVpnGateways.setLabels", + "parameterOrder": [ + "project", + "region", + "resource" + ], "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", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", "required": true, "type": "string" }, "region": { - "description": "Name of the region for this request.", + "description": "The region for this request.", + "location": "path", "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", "required": true, "type": "string" } }, - "parameterOrder": [ - "project", - "region", - "operation" - ], + "path": "projects/{project}/regions/{region}/targetVpnGateways/{resource}/setLabels", + "request": { + "$ref": "RegionSetLabelsRequest" + }, "response": { "$ref": "Operation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "https://www.googleapis.com/auth/compute" + ] + } + } + }, + "urlMaps": { + "methods": { + "aggregatedList": { + "description": "Retrieves the list of all UrlMap resources, regional and global,\navailable to the specified project.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", + "flatPath": "projects/{project}/aggregated/urlMaps", + "httpMethod": "GET", + "id": "compute.urlMaps.aggregatedList", + "parameterOrder": [ + "project" ], - "description": "Retrieves the specified region-specific Operations resource." - }, - "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, + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region,\nglobal) should be included in the response. For new resource types added\nafter this field, the flag has no effect as new resource types will always\ninclude every visible scope for each scope type in response. For resource\ntypes which predate this field, if this flag is omitted or false, only\nscopes of the scope types where the resource type is expected to be found\nwill be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", "type": "string" }, "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "description": "Name of the project scoping this request.", "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", "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, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which\naggregated list request is invoked for subnetworks list-usable api.", + "format": "int64", + "location": "query", "type": "string" } }, - "parameterOrder": [ - "project", - "region", - "operation" - ], + "path": "projects/{project}/aggregated/urlMaps", "response": { - "$ref": "Operation" + "$ref": "UrlMapsAggregatedList" }, "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`. " + ] }, "delete": { - "id": "compute.regionOperations.delete", - "path": "projects/{project}/regions/{region}/operations/{operation}", - "flatPath": "projects/{project}/regions/{region}/operations/{operation}", + "description": "Deletes the specified UrlMap resource.", + "flatPath": "projects/{project}/global/urlMaps/{urlMap}", "httpMethod": "DELETE", + "id": "compute.urlMaps.delete", + "parameterOrder": [ + "project", + "urlMap" + ], "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", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", "required": true, "type": "string" }, - "region": { - "description": "Name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "urlMap": { + "description": "Name of the UrlMap resource to delete.", "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", "required": true, "type": "string" } }, - "parameterOrder": [ - "project", - "region", - "operation" - ], + "path": "projects/{project}/global/urlMaps/{urlMap}", + "response": { + "$ref": "Operation" + }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified region-specific Operations resource." - } - } - }, - "acceleratorTypes": { - "methods": { - "list": { - "id": "compute.acceleratorTypes.list", - "path": "projects/{project}/zones/{zone}/acceleratorTypes", - "flatPath": "projects/{project}/zones/{zone}/acceleratorTypes", + ] + }, + "get": { + "description": "Returns the specified UrlMap resource.", + "flatPath": "projects/{project}/global/urlMaps/{urlMap}", "httpMethod": "GET", + "id": "compute.urlMaps.get", + "parameterOrder": [ + "project", + "urlMap" + ], "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not 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", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", "required": true, "type": "string" }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, 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])?", + "urlMap": { + "description": "Name of the UrlMap resource to return.", "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", "required": true, "type": "string" } }, - "parameterOrder": [ - "project", - "zone" - ], + "path": "projects/{project}/global/urlMaps/{urlMap}", "response": { - "$ref": "AcceleratorTypeList" + "$ref": "UrlMap" }, "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", + "insert": { + "description": "Creates a UrlMap resource in the specified project using\nthe data included in the request.", + "flatPath": "projects/{project}/global/urlMaps", + "httpMethod": "POST", + "id": "compute.urlMaps.insert", + "parameterOrder": [ + "project" + ], "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not 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", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", "required": true, "type": "string" }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, 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.", + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", "location": "query", - "type": "string", - "format": "int64" + "type": "string" } }, - "parameterOrder": [ - "project" - ], + "path": "projects/{project}/global/urlMaps", + "request": { + "$ref": "UrlMap" + }, "response": { - "$ref": "AcceleratorTypeAggregatedList" + "$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 an aggregated list of accelerator types. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." + "https://www.googleapis.com/auth/compute" + ] }, - "get": { - "id": "compute.acceleratorTypes.get", - "path": "projects/{project}/zones/{zone}/acceleratorTypes/{acceleratorType}", - "flatPath": "projects/{project}/zones/{zone}/acceleratorTypes/{acceleratorType}", - "httpMethod": "GET", + "invalidateCache": { + "description": "Initiates a cache invalidation operation, invalidating the specified path,\nscoped to the specified UrlMap.\n\nFor more information, see [Invalidating cached\ncontent](/cdn/docs/invalidating-cached-content).", + "flatPath": "projects/{project}/global/urlMaps/{urlMap}/invalidateCache", + "httpMethod": "POST", + "id": "compute.urlMaps.invalidateCache", + "parameterOrder": [ + "project", + "urlMap" + ], "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", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", "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])?", + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "urlMap": { + "description": "Name of the UrlMap scoping this request.", "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", "required": true, "type": "string" } }, - "parameterOrder": [ - "project", - "zone", - "acceleratorType" - ], + "path": "projects/{project}/global/urlMaps/{urlMap}/invalidateCache", + "request": { + "$ref": "CacheInvalidationRule" + }, "response": { - "$ref": "AcceleratorType" + "$ref": "Operation" }, "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." - } - } - }, - "globalAddresses": { - "methods": { + "https://www.googleapis.com/auth/compute" + ] + }, "list": { - "id": "compute.globalAddresses.list", - "path": "projects/{project}/global/addresses", - "flatPath": "projects/{project}/global/addresses", + "description": "Retrieves the list of UrlMap resources available to the specified\nproject.", + "flatPath": "projects/{project}/global/urlMaps", "httpMethod": "GET", + "id": "compute.urlMaps.list", + "parameterOrder": [ + "project" + ], "parameters": { "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", "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", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", "location": "query", - "type": "integer", - "format": "uint32" + "minimum": "0", + "type": "integer" }, "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", "location": "query", "type": "string" }, "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", "location": "query", "type": "string" }, "project": { "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", "required": true, "type": "string" }, "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", "location": "query", "type": "boolean" } }, - "parameterOrder": [ - "project" - ], + "path": "projects/{project}/global/urlMaps", "response": { - "$ref": "AddressList" + "$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 a list of global addresses." + ] }, - "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" - } - }, + "patch": { + "description": "Patches the specified UrlMap resource with the data included in the\nrequest. This method supportsPATCH\nsemantics and uses theJSON merge\npatch format and processing rules.", + "flatPath": "projects/{project}/global/urlMaps/{urlMap}", + "httpMethod": "PATCH", + "id": "compute.urlMaps.patch", "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" + "urlMap" ], - "description": "Returns the specified address resource." - }, - "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", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", "required": true, "type": "string" }, "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", "location": "query", "type": "string" + }, + "urlMap": { + "description": "Name of the UrlMap resource to patch.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" } }, - "parameterOrder": [ - "project" - ], + "path": "projects/{project}/global/urlMaps/{urlMap}", "request": { - "$ref": "Address" + "$ref": "UrlMap" }, "response": { "$ref": "Operation" @@ -52912,80 +47089,79 @@ "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." + ] }, - "delete": { - "id": "compute.globalAddresses.delete", - "path": "projects/{project}/global/addresses/{address}", - "flatPath": "projects/{project}/global/addresses/{address}", - "httpMethod": "DELETE", + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource.", + "flatPath": "projects/{project}/global/urlMaps/{resource}/testIamPermissions", + "httpMethod": "POST", + "id": "compute.urlMaps.testIamPermissions", + "parameterOrder": [ + "project", + "resource" + ], "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", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", "required": true, "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, "type": "string" } }, - "parameterOrder": [ - "project", - "address" - ], + "path": "projects/{project}/global/urlMaps/{resource}/testIamPermissions", + "request": { + "$ref": "TestPermissionsRequest" + }, "response": { - "$ref": "Operation" + "$ref": "TestPermissionsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified address resource." + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "move": { - "id": "compute.globalAddresses.move", - "path": "projects/{project}/global/addresses/{address}/move", - "flatPath": "projects/{project}/global/addresses/{address}/move", - "httpMethod": "POST", + "update": { + "description": "Updates the specified UrlMap resource with the data included in the\nrequest.", + "flatPath": "projects/{project}/global/urlMaps/{urlMap}", + "httpMethod": "PUT", + "id": "compute.urlMaps.update", + "parameterOrder": [ + "project", + "urlMap" + ], "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])?))", + "description": "Project ID for this request.", "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", "required": true, "type": "string" }, "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", "location": "query", "type": "string" + }, + "urlMap": { + "description": "Name of the UrlMap resource to update.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" } }, - "parameterOrder": [ - "project", - "address" - ], + "path": "projects/{project}/global/urlMaps/{urlMap}", "request": { - "$ref": "GlobalAddressesMoveRequest" + "$ref": "UrlMap" }, "response": { "$ref": "Operation" @@ -52993,401 +47169,281 @@ "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", + "validate": { + "description": "Runs static validation for the UrlMap. In particular, the tests of the\nprovided UrlMap will be run. Calling this method does NOT create the\nUrlMap.", + "flatPath": "projects/{project}/global/urlMaps/{urlMap}/validate", "httpMethod": "POST", + "id": "compute.urlMaps.validate", + "parameterOrder": [ + "project", + "urlMap" + ], "parameters": { "project": { "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", "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}", + "urlMap": { + "description": "Name of the UrlMap resource to be validated as.", "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", "required": true, "type": "string" } }, - "parameterOrder": [ - "project", - "resource" - ], + "path": "projects/{project}/global/urlMaps/{urlMap}/validate", "request": { - "$ref": "GlobalSetLabelsRequest" + "$ref": "UrlMapsValidateRequest" }, "response": { - "$ref": "Operation" + "$ref": "UrlMapsValidateResponse" }, "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": { + "vpnGateways": { "methods": { - "list": { - "id": "compute.addresses.list", - "path": "projects/{project}/regions/{region}/addresses", - "flatPath": "projects/{project}/regions/{region}/addresses", + "aggregatedList": { + "description": "Retrieves an aggregated list of VPN gateways.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", + "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" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,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" - } - }, + "id": "compute.vpnGateways.aggregatedList", "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" + "project" ], - "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.", + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", "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.", + "description": "Indicates whether every visible scope for each scope type (zone, region,\nglobal) should be included in the response. For new resource types added\nafter this field, the flag has no effect as new resource types will always\ninclude every visible scope for each scope type in response. For resource\ntypes which predate this field, if this flag is omitted or false, only\nscopes of the scope types where the resource type is expected to be found\nwill 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", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", "location": "query", - "type": "integer", - "format": "uint32" + "minimum": "0", + "type": "integer" }, "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", "location": "query", "type": "string" }, "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", "location": "query", "type": "string" }, "project": { "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", "required": true, "type": "string" }, "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith 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.", + "description": "The Shared VPC service project id or service project number for which\naggregated list request is invoked for subnetworks list-usable api.", + "format": "int64", "location": "query", - "type": "string", - "format": "int64" + "type": "string" } }, - "parameterOrder": [ - "project" - ], + "path": "projects/{project}/aggregated/vpnGateways", "response": { - "$ref": "AddressAggregatedList" + "$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 addresses. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." + ] }, - "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" - } - }, + "delete": { + "description": "Deletes the specified VPN gateway.", + "flatPath": "projects/{project}/regions/{region}/vpnGateways/{vpnGateway}", + "httpMethod": "DELETE", + "id": "compute.vpnGateways.delete", "parameterOrder": [ "project", "region", - "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" + "vpnGateway" ], - "description": "Returns the specified address resource." - }, - "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", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", "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", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", "required": true, "type": "string" }, "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", "location": "query", "type": "string" + }, + "vpnGateway": { + "description": "Name of the VPN gateway to delete.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" } }, - "parameterOrder": [ - "project", - "region" - ], - "request": { - "$ref": "Address" - }, + "path": "projects/{project}/regions/{region}/vpnGateways/{vpnGateway}", "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." + ] }, - "delete": { - "id": "compute.addresses.delete", - "path": "projects/{project}/regions/{region}/addresses/{address}", - "flatPath": "projects/{project}/regions/{region}/addresses/{address}", - "httpMethod": "DELETE", + "get": { + "description": "Returns the specified VPN gateway.", + "flatPath": "projects/{project}/regions/{region}/vpnGateways/{vpnGateway}", + "httpMethod": "GET", + "id": "compute.vpnGateways.get", + "parameterOrder": [ + "project", + "region", + "vpnGateway" + ], "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", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", "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", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", "required": true, "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", + "vpnGateway": { + "description": "Name of the VPN gateway to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, "type": "string" } }, - "parameterOrder": [ - "project", - "region", - "address" - ], + "path": "projects/{project}/regions/{region}/vpnGateways/{vpnGateway}", "response": { - "$ref": "Operation" + "$ref": "VpnGateway" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified address resource." + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "move": { - "id": "compute.addresses.move", - "path": "projects/{project}/regions/{region}/addresses/{address}/move", - "flatPath": "projects/{project}/regions/{region}/addresses/{address}/move", - "httpMethod": "POST", + "getStatus": { + "description": "Returns the status for the specified VPN gateway.", + "flatPath": "projects/{project}/regions/{region}/vpnGateways/{vpnGateway}/getStatus", + "httpMethod": "GET", + "id": "compute.vpnGateways.getStatus", + "parameterOrder": [ + "project", + "region", + "vpnGateway" + ], "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])?))", + "description": "Project ID for this request.", "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", "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", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", "required": true, "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", + "vpnGateway": { + "description": "Name of the VPN gateway to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, "type": "string" } }, - "parameterOrder": [ - "project", - "region", - "address" - ], - "request": { - "$ref": "RegionAddressesMoveRequest" - }, + "path": "projects/{project}/regions/{region}/vpnGateways/{vpnGateway}/getStatus", "response": { - "$ref": "Operation" + "$ref": "VpnGatewaysGetStatusResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Moves the specified address resource." + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "setLabels": { - "id": "compute.addresses.setLabels", - "path": "projects/{project}/regions/{region}/addresses/{resource}/setLabels", - "flatPath": "projects/{project}/regions/{region}/addresses/{resource}/setLabels", + "insert": { + "description": "Creates a VPN gateway in the specified project and region using\nthe data included in the request.", + "flatPath": "projects/{project}/regions/{region}/vpnGateways", "httpMethod": "POST", + "id": "compute.vpnGateways.insert", + "parameterOrder": [ + "project", + "region" + ], "parameters": { "project": { "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", "required": true, "type": "string" }, "region": { - "description": "The region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "description": "Name of the region for this request.", "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", "required": true, "type": "string" }, "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(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" - ], + "path": "projects/{project}/regions/{region}/vpnGateways", "request": { - "$ref": "RegionSetLabelsRequest" + "$ref": "VpnGateway" }, "response": { "$ref": "Operation" @@ -53395,371 +47451,360 @@ "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", + "description": "Retrieves a list of VPN gateways available to the specified\nproject and region.", + "flatPath": "projects/{project}/regions/{region}/vpnGateways", "httpMethod": "GET", + "id": "compute.vpnGateways.list", + "parameterOrder": [ + "project", + "region" + ], "parameters": { "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", "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", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", "location": "query", - "type": "integer", - "format": "uint32" + "minimum": "0", + "type": "integer" }, "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", "location": "query", "type": "string" }, "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", "location": "query", "type": "string" }, "project": { "description": "Project ID for this request.", + "location": "path", "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", "required": true, "type": "string" }, "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", "location": "query", "type": "boolean" } }, - "parameterOrder": [ - "project" - ], + "path": "projects/{project}/regions/{region}/vpnGateways", "response": { - "$ref": "ImageList" + "$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 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." + ] }, - "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" - } - }, + "setLabels": { + "description": "Sets the labels on a VpnGateway. To learn more about labels, read theLabeling\nResources documentation.", + "flatPath": "projects/{project}/regions/{region}/vpnGateways/{resource}/setLabels", + "httpMethod": "POST", + "id": "compute.vpnGateways.setLabels", "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" + "region", + "resource" ], - "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, - "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])?))", + "description": "Project ID for this request.", "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", "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." - }, - "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])?))", + "region": { + "description": "The region for this request.", "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", "required": true, "type": "string" }, "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", "location": "query", "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" } }, - "parameterOrder": [ - "project" - ], + "path": "projects/{project}/regions/{region}/vpnGateways/{resource}/setLabels", "request": { - "$ref": "Image" + "$ref": "RegionSetLabelsRequest" }, "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." + "https://www.googleapis.com/auth/compute" + ] }, - "setLabels": { - "id": "compute.images.setLabels", - "path": "projects/{project}/global/images/{resource}/setLabels", - "flatPath": "projects/{project}/global/images/{resource}/setLabels", + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource.", + "flatPath": "projects/{project}/regions/{region}/vpnGateways/{resource}/testIamPermissions", "httpMethod": "POST", + "id": "compute.vpnGateways.testIamPermissions", + "parameterOrder": [ + "project", + "region", + "resource" + ], "parameters": { "project": { "description": "Project ID for this request.", + "location": "path", "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", "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", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", "required": true, "type": "string" } }, - "parameterOrder": [ - "project", - "resource" - ], + "path": "projects/{project}/regions/{region}/vpnGateways/{resource}/testIamPermissions", "request": { - "$ref": "GlobalSetLabelsRequest" + "$ref": "TestPermissionsRequest" }, "response": { - "$ref": "Operation" + "$ref": "TestPermissionsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] + } + } + }, + "vpnTunnels": { + "methods": { + "aggregatedList": { + "description": "Retrieves an aggregated list of VPN tunnels.\n\nTo prevent failure, Google recommends that you set the\n`returnPartialSuccess` parameter to `true`.", + "flatPath": "projects/{project}/aggregated/vpnTunnels", + "httpMethod": "GET", + "id": "compute.vpnTunnels.aggregatedList", + "parameterOrder": [ + "project" ], - "description": "Sets the labels on an image. To learn more about labels, read the Labeling Resources documentation." - }, - "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, + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region,\nglobal) should be included in the response. For new resource types added\nafter this field, the flag has no effect as new resource types will always\ninclude every visible scope for each scope type in response. For resource\ntypes which predate this field, if this flag is omitted or false, only\nscopes of the scope types where the resource type is expected to be found\nwill be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", "type": "string" }, "project": { "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", "required": true, "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which\naggregated list request is invoked for subnetworks list-usable api.", + "format": "int64", "location": "query", "type": "string" } }, - "parameterOrder": [ - "project", - "image" - ], + "path": "projects/{project}/aggregated/vpnTunnels", "response": { - "$ref": "Operation" + "$ref": "VpnTunnelAggregatedList" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified image." + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "deprecate": { - "id": "compute.images.deprecate", - "path": "projects/{project}/global/images/{image}/deprecate", - "flatPath": "projects/{project}/global/images/{image}/deprecate", - "httpMethod": "POST", + "delete": { + "description": "Deletes the specified VpnTunnel resource.", + "flatPath": "projects/{project}/regions/{region}/vpnTunnels/{vpnTunnel}", + "httpMethod": "DELETE", + "id": "compute.vpnTunnels.delete", + "parameterOrder": [ + "project", + "region", + "vpnTunnel" + ], "parameters": { - "image": { - "description": "Image name.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "project": { + "description": "Project ID for this request.", "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", "required": true, "type": "string" }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "region": { + "description": "Name of the region for this request.", "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", "required": true, "type": "string" }, "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", "location": "query", "type": "string" + }, + "vpnTunnel": { + "description": "Name of the VpnTunnel resource to delete.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" } }, - "parameterOrder": [ - "project", - "image" - ], - "request": { - "$ref": "DeprecationStatus" - }, + "path": "projects/{project}/regions/{region}/vpnTunnels/{vpnTunnel}", "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." + ] }, - "getIamPolicy": { - "id": "compute.images.getIamPolicy", - "path": "projects/{project}/global/images/{resource}/getIamPolicy", - "flatPath": "projects/{project}/global/images/{resource}/getIamPolicy", + "get": { + "description": "Returns the specified VpnTunnel resource.", + "flatPath": "projects/{project}/regions/{region}/vpnTunnels/{vpnTunnel}", "httpMethod": "GET", + "id": "compute.vpnTunnels.get", + "parameterOrder": [ + "project", + "region", + "vpnTunnel" + ], "parameters": { - "optionsRequestedPolicyVersion": { - "description": "Requested IAM Policy version.", - "location": "query", - "type": "integer", - "format": "int32" - }, "project": { "description": "Project ID for this request.", + "location": "path", "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", "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}", + "vpnTunnel": { + "description": "Name of the VpnTunnel resource to return.", "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", "required": true, "type": "string" } }, - "parameterOrder": [ - "project", - "resource" - ], + "path": "projects/{project}/regions/{region}/vpnTunnels/{vpnTunnel}", "response": { - "$ref": "Policy" + "$ref": "VpnTunnel" }, "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." + ] }, - "patch": { - "id": "compute.images.patch", - "path": "projects/{project}/global/images/{image}", - "flatPath": "projects/{project}/global/images/{image}", - "httpMethod": "PATCH", + "insert": { + "description": "Creates a VpnTunnel resource in the specified project and region using\nthe data included in the request.", + "flatPath": "projects/{project}/regions/{region}/vpnTunnels", + "httpMethod": "POST", + "id": "compute.vpnTunnels.insert", + "parameterOrder": [ + "project", + "region" + ], "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}", + "project": { + "description": "Project ID for this request.", "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", "required": true, "type": "string" }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "region": { + "description": "Name of the region for this request.", "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", "required": true, "type": "string" }, "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", "location": "query", "type": "string" } }, - "parameterOrder": [ - "project", - "image" - ], + "path": "projects/{project}/regions/{region}/vpnTunnels", "request": { - "$ref": "Image" + "$ref": "VpnTunnel" }, "response": { "$ref": "Operation" @@ -53767,249 +47812,245 @@ "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." + ] }, - "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" - } - }, + "list": { + "description": "Retrieves a list of VpnTunnel resources contained in the specified\nproject and region.", + "flatPath": "projects/{project}/regions/{region}/vpnTunnels", + "httpMethod": "GET", + "id": "compute.vpnTunnels.list", "parameterOrder": [ "project", - "resource" - ], - "request": { - "$ref": "GlobalSetPolicyRequest" - }, - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "region" ], - "description": "Sets the access control policy on the specified resource. Replaces any existing policy." - }, - "testIamPermissions": { - "id": "compute.images.testIamPermissions", - "path": "projects/{project}/global/images/{resource}/testIamPermissions", - "flatPath": "projects/{project}/global/images/{resource}/testIamPermissions", - "httpMethod": "POST", "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, "project": { "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", "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}", + "region": { + "description": "Name of the region for this request.", "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", "required": true, "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" } }, - "parameterOrder": [ - "project", - "resource" - ], - "request": { - "$ref": "TestPermissionsRequest" - }, + "path": "projects/{project}/regions/{region}/vpnTunnels", "response": { - "$ref": "TestPermissionsResponse" + "$ref": "VpnTunnelList" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/compute", "https://www.googleapis.com/auth/compute.readonly" + ] + }, + "setLabels": { + "description": "Sets the labels on a VpnTunnel. To learn more about labels, read theLabeling\nResources documentation.", + "flatPath": "projects/{project}/regions/{region}/vpnTunnels/{resource}/setLabels", + "httpMethod": "POST", + "id": "compute.vpnTunnels.setLabels", + "parameterOrder": [ + "project", + "region", + "resource" ], - "description": "Returns permissions that a caller has on the specified resource." - } - } - }, - "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}", + "project": { + "description": "Project ID for this request.", "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", "required": true, "type": "string" }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "region": { + "description": "The region for this request.", "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", "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])?", + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", "required": true, "type": "string" } }, - "parameterOrder": [ - "project", - "zone", - "family" - ], + "path": "projects/{project}/regions/{region}/vpnTunnels/{resource}/setLabels", + "request": { + "$ref": "RegionSetLabelsRequest" + }, "response": { - "$ref": "ImageFamilyView" + "$ref": "Operation" }, "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." + "https://www.googleapis.com/auth/compute" + ] } } }, - "snapshots": { + "wireGroups": { "methods": { - "list": { - "id": "compute.snapshots.list", - "path": "projects/{project}/global/snapshots", - "flatPath": "projects/{project}/global/snapshots", - "httpMethod": "GET", + "delete": { + "description": "Deletes the specified wire group in the given scope.", + "flatPath": "projects/{project}/global/crossSiteNetworks/{crossSiteNetwork}/wireGroups/{wireGroup}", + "httpMethod": "DELETE", + "id": "compute.wireGroups.delete", + "parameterOrder": [ + "project", + "crossSiteNetwork", + "wireGroup" + ], "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", + "crossSiteNetwork": { + "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", + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, "type": "string" }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).\nend_interface: MixerMutationRequestBuilder", "location": "query", "type": "string" }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "wireGroup": { + "description": "Name of the wire group resource to delete.", "location": "path", "required": true, "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, 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" - ], + "path": "projects/{project}/global/crossSiteNetworks/{crossSiteNetwork}/wireGroups/{wireGroup}", "response": { - "$ref": "SnapshotList" + "$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 list of Snapshot resources contained within the specified project." + "https://www.googleapis.com/auth/compute" + ] }, "get": { - "id": "compute.snapshots.get", - "path": "projects/{project}/global/snapshots/{snapshot}", - "flatPath": "projects/{project}/global/snapshots/{snapshot}", + "description": "Gets the specified wire group resource in the given scope.", + "flatPath": "projects/{project}/global/crossSiteNetworks/{crossSiteNetwork}/wireGroups/{wireGroup}", "httpMethod": "GET", + "id": "compute.wireGroups.get", + "parameterOrder": [ + "project", + "crossSiteNetwork", + "wireGroup" + ], "parameters": { + "crossSiteNetwork": { + "location": "path", + "required": true, + "type": "string" + }, "project": { "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", "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}", + "wireGroup": { + "description": "Name of the wire group resource to return.", "location": "path", "required": true, "type": "string" } }, - "parameterOrder": [ - "project", - "snapshot" - ], + "path": "projects/{project}/global/crossSiteNetworks/{crossSiteNetwork}/wireGroups/{wireGroup}", "response": { - "$ref": "Snapshot" + "$ref": "WireGroup" }, "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." + ] }, "insert": { - "id": "compute.snapshots.insert", - "path": "projects/{project}/global/snapshots", - "flatPath": "projects/{project}/global/snapshots", + "description": "Creates a wire group in the specified project in the given scope\nusing the parameters that are included in the request.", + "flatPath": "projects/{project}/global/crossSiteNetworks/{crossSiteNetwork}/wireGroups", "httpMethod": "POST", + "id": "compute.wireGroups.insert", + "parameterOrder": [ + "project", + "crossSiteNetwork" + ], "parameters": { + "crossSiteNetwork": { + "location": "path", + "required": true, + "type": "string" + }, "project": { "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", "required": true, "type": "string" }, "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).\nend_interface: MixerMutationRequestBuilder", "location": "query", "type": "string" + }, + "validateOnly": { + "description": "[Input Only] Validate the new configuration, but don't create it.", + "location": "query", + "type": "boolean" } }, - "parameterOrder": [ - "project" - ], + "path": "projects/{project}/global/crossSiteNetworks/{crossSiteNetwork}/wireGroups", "request": { - "$ref": "Snapshot" + "$ref": "WireGroup" }, "response": { "$ref": "Operation" @@ -54017,464 +48058,557 @@ "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." + ] }, - "setLabels": { - "id": "compute.snapshots.setLabels", - "path": "projects/{project}/global/snapshots/{resource}/setLabels", - "flatPath": "projects/{project}/global/snapshots/{resource}/setLabels", - "httpMethod": "POST", + "list": { + "description": "Lists the wire groups for a project in the given scope.", + "flatPath": "projects/{project}/global/crossSiteNetworks/{crossSiteNetwork}/wireGroups", + "httpMethod": "GET", + "id": "compute.wireGroups.list", + "parameterOrder": [ + "project", + "crossSiteNetwork" + ], "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "crossSiteNetwork": { "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}", + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", "required": true, "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" } }, - "parameterOrder": [ - "project", - "resource" - ], - "request": { - "$ref": "GlobalSetLabelsRequest" - }, + "path": "projects/{project}/global/crossSiteNetworks/{crossSiteNetwork}/wireGroups", "response": { - "$ref": "Operation" + "$ref": "WireGroupList" }, "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." + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "delete": { - "id": "compute.snapshots.delete", - "path": "projects/{project}/global/snapshots/{snapshot}", - "flatPath": "projects/{project}/global/snapshots/{snapshot}", - "httpMethod": "DELETE", + "patch": { + "description": "Updates the specified wire group resource with the data included in the\nrequest. This method supportsPATCH\nsemantics and usesJSON merge\npatch format and processing rules.", + "flatPath": "projects/{project}/global/crossSiteNetworks/{crossSiteNetwork}/wireGroups/{wireGroup}", + "httpMethod": "PATCH", + "id": "compute.wireGroups.patch", + "parameterOrder": [ + "project", + "crossSiteNetwork", + "wireGroup" + ], "parameters": { + "crossSiteNetwork": { + "location": "path", + "required": true, + "type": "string" + }, "project": { "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", "required": true, "type": "string" }, "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).\nend_interface: MixerMutationRequestBuilder", "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}", + "updateMask": { + "description": "update_mask indicates fields to be updated as part of this request.", + "format": "google-fieldmask", + "location": "query", + "type": "string" + }, + "validateOnly": { + "description": "[Input Only] Validate the new configuration, but don't update it.", + "location": "query", + "type": "boolean" + }, + "wireGroup": { + "description": "Name of the WireGroups resource to patch.", "location": "path", "required": true, "type": "string" } }, - "parameterOrder": [ - "project", - "snapshot" - ], + "path": "projects/{project}/global/crossSiteNetworks/{crossSiteNetwork}/wireGroups/{wireGroup}", + "request": { + "$ref": "WireGroup" + }, "response": { "$ref": "Operation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/compute" + ] + } + } + }, + "zoneOperations": { + "methods": { + "delete": { + "description": "Deletes the specified zone-specific Operations resource.", + "flatPath": "projects/{project}/zones/{zone}/operations/{operation}", + "httpMethod": "DELETE", + "id": "compute.zoneOperations.delete", + "parameterOrder": [ + "project", + "zone", + "operation" ], - "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." - }, - "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])?))", + "operation": { + "description": "Name of the Operations resource to delete, or its unique numeric\nidentifier.", "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", "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." - }, - "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", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", "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}", + "zone": { + "description": "Name of the zone for this request.", "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", "required": true, "type": "string" } }, - "parameterOrder": [ - "project", - "resource" - ], - "request": { - "$ref": "GlobalSetPolicyRequest" - }, - "response": { - "$ref": "Policy" - }, + "path": "projects/{project}/zones/{zone}/operations/{operation}", "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.snapshots.testIamPermissions", - "path": "projects/{project}/global/snapshots/{resource}/testIamPermissions", - "flatPath": "projects/{project}/global/snapshots/{resource}/testIamPermissions", - "httpMethod": "POST", + "get": { + "description": "Retrieves the specified zone-specific Operations resource.", + "flatPath": "projects/{project}/zones/{zone}/operations/{operation}", + "httpMethod": "GET", + "id": "compute.zoneOperations.get", + "parameterOrder": [ + "project", + "zone", + "operation" + ], "parameters": { + "operation": { + "description": "Name of the Operations resource to return, or its unique numeric\nidentifier.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, "project": { "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", "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}", + "zone": { + "description": "Name of the zone for this request.", "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", "required": true, "type": "string" } }, - "parameterOrder": [ - "project", - "resource" - ], - "request": { - "$ref": "TestPermissionsRequest" - }, + "path": "projects/{project}/zones/{zone}/operations/{operation}", "response": { - "$ref": "TestPermissionsResponse" + "$ref": "Operation" }, "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." - } - } - }, - "disks": { - "methods": { + ] + }, "list": { - "id": "compute.disks.list", - "path": "projects/{project}/zones/{zone}/disks", - "flatPath": "projects/{project}/zones/{zone}/disks", + "description": "Retrieves a list of Operation resources contained within\nthe specified zone.", + "flatPath": "projects/{project}/zones/{zone}/operations", "httpMethod": "GET", + "id": "compute.zoneOperations.list", + "parameterOrder": [ + "project", + "zone" + ], "parameters": { "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", "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", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", "location": "query", - "type": "integer", - "format": "uint32" + "minimum": "0", + "type": "integer" }, "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", "location": "query", "type": "string" }, "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", "location": "query", "type": "string" }, "project": { "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", "required": true, "type": "string" }, "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith 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])?", + "description": "Name of the zone for request.", "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", "required": true, "type": "string" } }, - "parameterOrder": [ - "project", - "zone" - ], + "path": "projects/{project}/zones/{zone}/operations", "response": { - "$ref": "DiskList" + "$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 persistent disks contained within the specified zone." + ] }, - "aggregatedList": { - "id": "compute.disks.aggregatedList", - "path": "projects/{project}/aggregated/disks", - "flatPath": "projects/{project}/aggregated/disks", - "httpMethod": "GET", + "wait": { + "description": "Waits for the specified Operation resource to return as `DONE`\nor for the request to approach the 2 minute deadline, and retrieves the\nspecified Operation resource. This method waits for no more than the\n2 minutes and then returns the current state of the\noperation, which might be `DONE` or still in progress.\n\nThis method is called on a best-effort basis. Specifically:\n \n \n - In uncommon cases, when the server is overloaded, the request might\n return before the default deadline is reached, or might return after zero\n seconds.\n - If the default deadline is reached, there is no guarantee that the\n operation is actually done when the method returns. Be prepared to retry\n if the operation is not `DONE`.", + "flatPath": "projects/{project}/zones/{zone}/operations/{operation}/wait", + "httpMethod": "POST", + "id": "compute.zoneOperations.wait", + "parameterOrder": [ + "project", + "zone", + "operation" + ], "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", + "operation": { + "description": "Name of the Operations resource to return, or its unique numeric\nidentifier.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, "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", + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, "type": "string" }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", + "zone": { + "description": "Name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, "type": "string" - }, + } + }, + "path": "projects/{project}/zones/{zone}/operations/{operation}/wait", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] + } + } + }, + "zoneVmExtensionPolicies": { + "methods": { + "delete": { + "description": "Deletes a specified zone VM extension policy within a project.", + "flatPath": "projects/{project}/zones/{zone}/vmExtensionPolicies/{vmExtensionPolicy}", + "httpMethod": "DELETE", + "id": "compute.zoneVmExtensionPolicies.delete", + "parameterOrder": [ + "project", + "zone", + "vmExtensionPolicy" + ], + "parameters": { "project": { "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", "required": true, "type": "string" }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", "location": "query", - "type": "boolean" + "type": "string" }, - "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" + "vmExtensionPolicy": { + "description": "Name of the zone VM extension policy to delete.", + "location": "path", + "required": true, + "type": "string" + }, + "zone": { + "description": "Name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" } }, - "parameterOrder": [ - "project" - ], + "path": "projects/{project}/zones/{zone}/vmExtensionPolicies/{vmExtensionPolicy}", "response": { - "$ref": "DiskAggregatedList" + "$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 an aggregated list of persistent disks. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." + "https://www.googleapis.com/auth/compute" + ] }, "get": { - "id": "compute.disks.get", - "path": "projects/{project}/zones/{zone}/disks/{disk}", - "flatPath": "projects/{project}/zones/{zone}/disks/{disk}", + "description": "Retrieves details of a specific zone VM extension policy within a project.", + "flatPath": "projects/{project}/zones/{zone}/vmExtensionPolicies/{vmExtensionPolicy}", "httpMethod": "GET", + "id": "compute.zoneVmExtensionPolicies.get", + "parameterOrder": [ + "project", + "zone", + "vmExtensionPolicy" + ], "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}", + "project": { + "description": "Project ID for this request.", "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", "required": true, "type": "string" }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "vmExtensionPolicy": { + "description": "Name of the VM extension policy resource to return.", "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", "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])?", + "description": "Name of the zone for this request.", "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", "required": true, "type": "string" } }, - "parameterOrder": [ - "project", - "zone", - "disk" - ], + "path": "projects/{project}/zones/{zone}/vmExtensionPolicies/{vmExtensionPolicy}", "response": { - "$ref": "Disk" + "$ref": "VmExtensionPolicy" }, "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." + ] }, "insert": { - "id": "compute.disks.insert", - "path": "projects/{project}/zones/{zone}/disks", - "flatPath": "projects/{project}/zones/{zone}/disks", + "description": "Creates a new zone-level VM extension policy within a project.", + "flatPath": "projects/{project}/zones/{zone}/vmExtensionPolicies", "httpMethod": "POST", + "id": "compute.zoneVmExtensionPolicies.insert", + "parameterOrder": [ + "project", + "zone" + ], "parameters": { "project": { "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", "required": true, "type": "string" }, "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", "location": "query", "type": "string" }, - "sourceImage": { - "description": "Source image to restore onto a disk. This field is optional.", + "zone": { + "description": "Name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/vmExtensionPolicies", + "request": { + "$ref": "VmExtensionPolicy" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "list": { + "description": "Lists all VM extension policies within a specific zone for a project.", + "flatPath": "projects/{project}/zones/{zone}/vmExtensionPolicies", + "httpMethod": "GET", + "id": "compute.zoneVmExtensionPolicies.list", + "parameterOrder": [ + "project", + "zone" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", "location": "query", "type": "string" }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith 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])?", + "description": "Name of the zone for this request.", "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", "required": true, "type": "string" } }, - "parameterOrder": [ - "project", - "zone" - ], - "request": { - "$ref": "Disk" - }, + "path": "projects/{project}/zones/{zone}/vmExtensionPolicies", "response": { - "$ref": "Operation" + "$ref": "VmExtensionPolicyList" }, "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." + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "setLabels": { - "id": "compute.disks.setLabels", - "path": "projects/{project}/zones/{zone}/disks/{resource}/setLabels", - "flatPath": "projects/{project}/zones/{zone}/disks/{resource}/setLabels", - "httpMethod": "POST", + "update": { + "description": "Modifies an existing zone VM extension policy within a project.", + "flatPath": "projects/{project}/zones/{zone}/vmExtensionPolicies/{vmExtensionPolicy}", + "httpMethod": "PATCH", + "id": "compute.zoneVmExtensionPolicies.update", + "parameterOrder": [ + "project", + "zone", + "vmExtensionPolicy" + ], "parameters": { "project": { "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", "required": true, "type": "string" }, "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(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}", + "vmExtensionPolicy": { + "description": "Name of the zone VM extension policy to update.", "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])?", + "description": "Name of the zone for this request.", "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", "required": true, "type": "string" } }, - "parameterOrder": [ - "project", - "zone", - "resource" - ], + "path": "projects/{project}/zones/{zone}/vmExtensionPolicies/{vmExtensionPolicy}", "request": { - "$ref": "ZoneSetLabelsRequest" + "$ref": "VmExtensionPolicy" }, "response": { "$ref": "Operation" @@ -54482,37172 +48616,65157 @@ "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/compute" + ] + } + } + }, + "zones": { + "methods": { + "get": { + "description": "Returns the specified Zone resource.", + "flatPath": "projects/{project}/zones/{zone}", + "httpMethod": "GET", + "id": "compute.zones.get", + "parameterOrder": [ + "project", + "zone" ], - "description": "Sets the labels on a disk. To learn more about labels, read the Labeling Resources documentation." - }, - "bulkSetLabels": { - "id": "compute.disks.bulkSetLabels", - "path": "projects/{project}/zones/{zone}/disks/bulkSetLabels", - "flatPath": "projects/{project}/zones/{zone}/disks/bulkSetLabels", - "httpMethod": "POST", "parameters": { "project": { "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", "required": true, "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request 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": "query", - "type": "string" - }, "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "description": "Name of the zone resource to return.", "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", "required": true, "type": "string" } }, - "parameterOrder": [ - "project", - "zone" - ], - "request": { - "$ref": "BulkZoneSetLabelsRequest" - }, + "path": "projects/{project}/zones/{zone}", "response": { - "$ref": "Operation" + "$ref": "Zone" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Sets the labels on many disks at once. To learn more about labels, read the Labeling Resources documentation." + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] }, - "delete": { - "id": "compute.disks.delete", - "path": "projects/{project}/zones/{zone}/disks/{disk}", - "flatPath": "projects/{project}/zones/{zone}/disks/{disk}", - "httpMethod": "DELETE", + "list": { + "description": "Retrieves the list of Zone resources available to the specified project.", + "flatPath": "projects/{project}/zones", + "httpMethod": "GET", + "id": "compute.zones.list", + "parameterOrder": [ + "project" + ], "parameters": { - "disk": { - "description": "Name of the persistent disk to delete.", - "location": "path", - "required": true, + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", "type": "string" }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "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).", + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", "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])?", + "project": { + "description": "Project ID for this request.", "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", "required": true, "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case\nof failure. The default value is false.\n\nFor example, when partial success behavior is enabled, aggregatedList for a\nsingle zone scope either returns all resources in the zone or no resources,\nwith an error code.", + "location": "query", + "type": "boolean" } }, - "parameterOrder": [ - "project", - "zone", - "disk" - ], + "path": "projects/{project}/zones", "response": { - "$ref": "Operation" + "$ref": "ZoneList" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] + } + } + } + }, + "revision": "20260807", + "rootUrl": "https://compute.googleapis.com/", + "schemas": { + "AWSV4Signature": { + "description": "Contains the configurations necessary to generate a signature for access to\nprivate storage buckets that support Signature Version 4 for authentication.\nThe service name for generating the authentication header will always default\nto 's3'.", + "id": "AWSV4Signature", + "properties": { + "accessKey": { + "description": "The access key used for s3 bucket authentication. Required for updating or\ncreating a backend that uses AWS v4 signature authentication, but will not\nbe returned as part of the configuration when queried with a REST API GET\nrequest.\n\n@InputOnly", + "type": "string" + }, + "accessKeyId": { + "description": "The identifier of an access key used for s3 bucket authentication.", + "type": "string" + }, + "accessKeyVersion": { + "description": "The optional version identifier for the access key. You can use this to\nkeep 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\nthe name of the region your cloud uses to host your origin. For example,\n\"us-east-1\" for AWS or \"us-ashburn-1\" for OCI.", + "type": "string" + } + }, + "type": "object" + }, + "AcceleratorConfig": { + "description": "A specification of the type and number of accelerator cards attached to the\ninstance.", + "id": "AcceleratorConfig", + "properties": { + "acceleratorCount": { + "description": "The number of the guest accelerator cards exposed to this instance.", + "format": "int32", + "type": "integer" + }, + "acceleratorType": { + "description": "Full or partial URL of the accelerator type resource to attach to this\ninstance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100\nIf you are creating an instance template, specify only the\naccelerator name.\nSee GPUs on Compute Engine\nfor a full list of accelerator types.", + "type": "string" + } + }, + "type": "object" + }, + "AcceleratorTopologiesInfo": { + "description": "Info for accelerator topologies within a densely packed reservation.", + "id": "AcceleratorTopologiesInfo", + "properties": { + "acceleratorTopologyInfos": { + "description": "Info for each accelerator topology.", + "items": { + "$ref": "AcceleratorTopologiesInfoAcceleratorTopologyInfo" + }, + "type": "array" + } + }, + "type": "object" + }, + "AcceleratorTopologiesInfoAcceleratorTopologyInfo": { + "description": "Info for a slice of a given topology.", + "id": "AcceleratorTopologiesInfoAcceleratorTopologyInfo", + "properties": { + "acceleratorTopology": { + "description": "The accelerator topology.", + "type": "string" + }, + "infoPerTopologyStates": { + "description": "Info for each topology state.", + "items": { + "$ref": "AcceleratorTopologiesInfoAcceleratorTopologyInfoInfoPerTopologyState" + }, + "type": "array" + } + }, + "type": "object" + }, + "AcceleratorTopologiesInfoAcceleratorTopologyInfoInfoPerTopologyState": { + "description": "Info for each topology state.", + "id": "AcceleratorTopologiesInfoAcceleratorTopologyInfoInfoPerTopologyState", + "properties": { + "count": { + "description": "The number of accelerator topologies in this state.", + "format": "int32", + "type": "integer" + }, + "state": { + "description": "The state of the accelerator topology.", + "enum": [ + "AVAILABLE", + "DEGRADED", + "RUNNING", + "TOPOLOGY_STATE_UNSPECIFIED", + "UNHEALTHY" + ], + "enumDeprecated": [ + false, + false, + false, + false, + true ], - "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." + "enumDescriptions": [ + "The accelerator topology is available.", + "The accelerator topology is degraded. The underlying capacity is not in a\nhealthy state and is not available.", + "The accelerator topology is running. If there are both running and\ndegraded hosts within a topology, DEGRADED state will be returned.", + "The state of the topology is unspecified.", + "This value has been deprecated and is no longer used." + ], + "type": "string" + } + }, + "type": "object" + }, + "AcceleratorType": { + "description": "Represents an Accelerator Type resource.\n\nGoogle Cloud Platform provides graphics processing units (accelerators) that\nyou can add to VM instances to improve or accelerate performance when working\nwith intensive workloads. For more information, readGPUs on Compute Engine.", + "id": "AcceleratorType", + "properties": { + "creationTimestamp": { + "description": "[Output Only] Creation timestamp inRFC3339 text format.", + "type": "string" }, - "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, + "deprecated": { + "$ref": "DeprecationStatus", + "description": "[Output Only] The deprecation status associated with this accelerator type." + }, + "description": { + "description": "[Output Only] An optional textual description of the resource.", + "type": "string" + }, + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "format": "uint64", + "type": "string" + }, + "kind": { + "default": "compute#acceleratorType", + "description": "Output only. [Output Only] The type of the resource. Alwayscompute#acceleratorType for accelerator types.", + "readOnly": true, + "type": "string" + }, + "maximumCardsPerInstance": { + "description": "[Output Only] Maximum number of accelerator cards allowed per instance.", + "format": "int32", + "type": "integer" + }, + "name": { + "description": "[Output Only] Name of the resource.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "resourceMetadata": { + "$ref": "ResourceMetadata", + "description": "Output only. Contains standard resource metadata for an AcceleratorType\nresource. It is populated for each instance of the AcceleratorType\nresource, and includes the api_version the\ninstance was retrieved through, and its canonical\nresource_type name.", + "readOnly": true + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined, fully qualified URL for this resource.", + "readOnly": true, + "type": "string" + }, + "zone": { + "description": "[Output Only] The name of the zone where the accelerator type resides,\nsuch as us-central1-a.\nYou must specify this field as part of the HTTP request URL. It is\nnot settable as a field in the request body.", + "type": "string" + } + }, + "type": "object" + }, + "AcceleratorTypeAggregatedList": { + "id": "AcceleratorTypeAggregatedList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "additionalProperties": { + "$ref": "AcceleratorTypesScopedList", + "description": "[Output Only] Name of the scope containing this set of accelerator types." + }, + "description": "A list of AcceleratorTypesScopedList resources.", + "type": "object" + }, + "kind": { + "default": "compute#acceleratorTypeAggregatedList", + "description": "Output only. [Output Only] Type of resource. Alwayscompute#acceleratorTypeAggregatedList for aggregated lists of\naccelerator types.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "unreachables": { + "description": "Output only. [Output Only] Unreachable resources.", + "items": { + "type": "string" + }, + "readOnly": true, + "type": "array" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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" + "data": { + "description": "[Output Only] Metadata about this warning in key:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{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": "object" + } + }, + "type": "object" + }, + "AcceleratorTypeList": { + "description": "Contains a list of accelerator types.", + "id": "AcceleratorTypeList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of AcceleratorType resources.", + "items": { + "$ref": "AcceleratorType" + }, + "type": "array" + }, + "kind": { + "default": "compute#acceleratorTypeList", + "description": "Output only. [Output Only] Type of resource. Alwayscompute#acceleratorTypeList for lists of accelerator types.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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, + "data": { + "description": "[Output Only] Metadata about this warning in key:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" + }, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project", - "zone", - "disk" - ], - "request": { - "$ref": "Snapshot" - }, - "response": { - "$ref": "Operation" + "type": "object" + } + }, + "type": "object" + }, + "AcceleratorTypesScopedList": { + "id": "AcceleratorTypesScopedList", + "properties": { + "acceleratorTypes": { + "description": "[Output Only] A list of accelerator types contained in this scope.", + "items": { + "$ref": "AcceleratorType" }, - "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." + "type": "array" }, - "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, + "warning": { + "description": "[Output Only] An informational warning that appears when the accelerator\ntypes list is empty.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project", - "zone", - "disk" + "type": "object" + } + }, + "type": "object" + }, + "AccessConfig": { + "description": "An access configuration attached to an instance's network interface.\nOnly one access config per instance is supported.", + "id": "AccessConfig", + "properties": { + "externalIpv6": { + "description": "Applies to ipv6AccessConfigs only.\nThe first IPv6 address of the external IPv6 range associated\nwith this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To\nuse a static external IP address, it must be unused and in the same region\nas the instance's zone. If not specified, Google Cloud will automatically\nassign an external IPv6 address from the instance's subnetwork.", + "type": "string" + }, + "externalIpv6PrefixLength": { + "description": "Applies to ipv6AccessConfigs only. The prefix length of the\nexternal IPv6 range.", + "format": "int32", + "type": "integer" + }, + "kind": { + "default": "compute#accessConfig", + "description": "Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.", + "readOnly": true, + "type": "string" + }, + "name": { + "description": "The name of this access configuration. In accessConfigs\n(IPv4), the default and recommended name is External NAT, but\nyou can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the\nrecommend name is External IPv6.", + "type": "string" + }, + "natIP": { + "description": "Applies to accessConfigs (IPv4) only. Anexternal IP\naddress associated with this instance. Specify an unused static\nexternal IP address available to the project or leave this field undefined\nto use an IP from a shared ephemeral IP address pool. If you specify a\nstatic external IP address, it must live in the same region as the zone of\nthe instance.", + "type": "string" + }, + "networkTier": { + "description": "This signifies the networking tier used for configuring this access\nconfiguration and can only take the following values: PREMIUM,STANDARD.\n\nIf an AccessConfig is specified without a valid external IP address, an\nephemeral IP will be created with this networkTier.\n\nIf an AccessConfig with a valid external IP address is specified, it must\nmatch that of the networkTier associated with the Address resource owning\nthat IP.", + "enum": [ + "FIXED_STANDARD", + "PREMIUM", + "STANDARD", + "STANDARD_OVERRIDES_FIXED_STANDARD" ], - "request": { - "$ref": "DisksResizeRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "Public internet quality with fixed bandwidth.", + "High quality, Google-grade network tier, support for all networking\nproducts.", + "Public internet quality, only limited support for other networking\nproducts.", + "(Output only) Temporary tier for FIXED_STANDARD when fixed standard tier\nis expired or not configured." ], - "description": "Resizes the specified persistent disk. You can only increase the size of the 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" + "publicPtrDomainName": { + "description": "The DNS domain name for the public PTR record.\n\nYou can set this field only if the `setPublicPtr` field is enabled inaccessConfig. If this field is unspecified inipv6AccessConfig, a default PTR record will be created for\nfirst IP in associated external IPv6 range.", + "type": "string" + }, + "securityPolicy": { + "description": "The resource URL for the security policy associated with this access\nconfig.", + "type": "string" + }, + "setPublicPtr": { + "description": "Specifies whether a public DNS 'PTR' record should be created to map the\nexternal IP address of the instance to a DNS domain name.\n\nThis field is not used in ipv6AccessConfig. A default PTR\nrecord will be created if the VM has external IPv6 range associated.", + "type": "boolean" + }, + "type": { + "description": "The type of configuration. In accessConfigs (IPv4), the\ndefault and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.", + "enum": [ + "DIRECT_IPV6", + "ONE_TO_ONE_NAT" ], - "request": { - "$ref": "DisksAddResourcePoliciesRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "", + "" ], - "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." + "type": "string" + } + }, + "type": "object" + }, + "Address": { + "description": "Represents an IP Address resource.\n\nGoogle Compute Engine has two IP Address resources:\n\n* [Global (external and\ninternal)](https://cloud.google.com/compute/docs/reference/rest/v1/globalAddresses)\n* [Regional (external and\ninternal)](https://cloud.google.com/compute/docs/reference/rest/v1/addresses)\n\nFor more information, see\nReserving a static external IP address.", + "id": "Address", + "properties": { + "address": { + "description": "The static IP address represented by this resource.", + "type": "string" }, - "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" + "addressType": { + "description": "The type of address to reserve, either INTERNAL orEXTERNAL. If unspecified, defaults to EXTERNAL.", + "enum": [ + "EXTERNAL", + "INTERNAL", + "UNSPECIFIED_TYPE" ], - "request": { - "$ref": "DisksRemoveResourcePoliciesRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "A publicly visible external IP address.", + "A private network IP address, for use with an Instance or Internal Load\nBalancer forwarding rule.", + "" ], - "description": "Removes resource policies from a disk." + "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" + "creationTimestamp": { + "description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "An optional description of this resource. Provide this field when you\ncreate the resource.", + "type": "string" + }, + "id": { + "description": "Output only. [Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "format": "uint64", + "readOnly": true, + "type": "string" + }, + "ipCollection": { + "description": "Reference to the source of IP addresses.\n\nIt supports the following cases:\n \n - \n Case 1: PublicDelegatedPrefix (PDP) for BYOIP external\n addresses. If an IPv4 PDP is used, the PDP must support enhanced IPv4\n allocations. If an IPv6 PDP is used, the PDP must be in\n EXTERNAL_IPV6_FORWARDING_RULE_CREATION mode.\n - \n Case 2: Internal Range for global internal addresses.\n\n\n\nUse one of the following formats to specify the resource:\n\nFor a Public Delegated Prefix:\n \n - \n Full resource URL:https://www.googleapis.com/compute/v1/projects/projectId/regions/region/publicDelegatedPrefixes/pdp\n - Partial URL:\n - projects/projectId/regions/region/publicDelegatedPrefixes/pdp-name\n - regions/region/publicDelegatedPrefixes/pdp-name\n \n\n\nFor an Internal Range:\n \n - Full URL:https://networkconnectivity.googleapis.com/v1/projects/project/locations/global/internalRanges/internal-range\n - Partial URL:projects/project/locations/global/internalRanges/internal-range", + "type": "string" + }, + "ipVersion": { + "description": "The IP version that will be used by this address. Valid options areIPV4 or IPV6.", + "enum": [ + "IPV4", + "IPV6", + "UNSPECIFIED_VERSION" ], - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "", + "", + "" ], - "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" + "ipv6EndpointType": { + "description": "The endpoint type of this address, which should be VM\nor NETLB. This is used for deciding which type of endpoint\nthis address can be used after the external IPv6 address reservation.", + "enum": [ + "NETLB", + "VM" ], - "request": { - "$ref": "ZoneSetPolicyRequest" + "enumDescriptions": [ + "Reserved IPv6 address can be used on network load balancer.", + "Reserved IPv6 address can be used on VM." + ], + "type": "string" + }, + "kind": { + "default": "compute#address", + "description": "Output only. [Output Only] Type of the resource. Always compute#address for\naddresses.", + "readOnly": true, + "type": "string" + }, + "labelFingerprint": { + "description": "A fingerprint for the labels being applied to this Address, which is\nessentially a hash of the labels set used for optimistic locking. The\nfingerprint is initially generated by Compute Engine and changes after\nevery request to modify or update labels. You must always provide an\nup-to-date fingerprint hash in order to update or change labels,\notherwise the request will fail with error412 conditionNotMet.\n\nTo see the latest fingerprint, make a get() request to\nretrieve an Address.", + "format": "byte", + "type": "string" + }, + "labels": { + "additionalProperties": { + "type": "string" }, - "response": { - "$ref": "Policy" + "description": "Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035.\nLabel values may be empty.", + "type": "object" + }, + "name": { + "annotations": { + "required": [ + "compute.addresses.insert" + ] }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "description": "Name of the resource. Provided by the client when the resource is created.\nThe name must be 1-63 characters long, and comply withRFC1035.\nSpecifically, the name must be 1-63 characters long and match the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?`. The first character\nmust be a lowercase letter, and all following characters (except for the\nlast character) must be a dash, lowercase letter, or digit. The last\ncharacter must be a lowercase letter or digit.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "network": { + "description": "The URL of the network in which to reserve the address. This field can\nonly be used with INTERNAL type with theVPC_PEERING purpose.", + "type": "string" + }, + "networkTier": { + "description": "This signifies the networking tier used for configuring this address and\ncan only take the following values: PREMIUM orSTANDARD. Internal IP addresses are always Premium Tier;\nglobal external IP addresses are always Premium Tier; regional external IP\naddresses can be either Standard or Premium Tier.\n\nIf this field is not specified, it is assumed to be PREMIUM.", + "enum": [ + "FIXED_STANDARD", + "PREMIUM", + "STANDARD", + "STANDARD_OVERRIDES_FIXED_STANDARD" ], - "description": "Sets the access control policy on the specified resource. Replaces any existing policy." + "enumDescriptions": [ + "Public internet quality with fixed bandwidth.", + "High quality, Google-grade network tier, support for all networking\nproducts.", + "Public internet quality, only limited support for other networking\nproducts.", + "(Output only) Temporary tier for FIXED_STANDARD when fixed standard tier\nis expired or not configured." + ], + "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" + "prefixLength": { + "description": "The prefix length if the resource represents an IP range.", + "format": "int32", + "type": "integer" + }, + "purpose": { + "description": "The purpose of this resource, which can be one of the following values:\n \n \n - GCE_ENDPOINT for addresses that are used by VM\n instances, alias IP ranges, load balancers, and similar resources.\n - DNS_RESOLVER for a DNS resolver address in a subnetwork\n for a Cloud DNS inbound\n forwarder IP addresses (regional internal IP address in a subnet of\n a VPC network)\n - VPC_PEERING for global internal IP addresses used for\n \n private services access allocated ranges.\n - NAT_AUTO for the regional external IP addresses used by\n Cloud NAT when allocating addresses using\n \n automatic NAT IP address allocation.\n - IPSEC_INTERCONNECT for addresses created from a private\n IP range that are reserved for a VLAN attachment in an\n *HA VPN over Cloud Interconnect* configuration. These addresses\n are regional resources.\n - `SHARED_LOADBALANCER_VIP` for an internal IP address that is assigned\n to multiple internal forwarding rules.\n - `PRIVATE_SERVICE_CONNECT` for a private network address that is\n used to configure Private Service Connect. Only global internal addresses\n can use this purpose.\n - `PASSTHROUGH_LOAD_BALANCER_AVAILABILITY_GROUP0` for addresses\n that can only be assigned to global external Passthrough Network Load\n Balancer forwarding rules, as an Availability Group 0 address.\n - `PASSTHROUGH_LOAD_BALANCER_AVAILABILITY_GROUP1` for addresses that\n can only be assigned to global external Passthrough Network Load Balancer\n forwarding rules, as an Availability Group 1 address.", + "enum": [ + "DNS_RESOLVER", + "GCE_ENDPOINT", + "IPSEC_INTERCONNECT", + "NAT_AUTO", + "PRIVATE_SERVICE_CONNECT", + "SERVERLESS", + "SHARED_LOADBALANCER_VIP", + "VPC_PEERING" ], - "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" + "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\nthat is used in HA VPN over Cloud Interconnect. This regional\ninternal IP address range must not overlap with any IP address range\nof subnet/route in the VPC network and its peering networks. After the\nVLAN attachment is created with the reserved IP address range, when\ncreating a new VPN gateway, its interface IP address is allocated\nfrom 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\nService Connect. This purpose can be specified only forGLOBAL 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\nLoad Balancer forwarding rules.", + "IP range for peer networks." ], - "description": "Returns permissions that a caller has on the specified resource." + "type": "string" }, - "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" + "region": { + "description": "Output only. [Output Only] The URL of the region where a regional address resides.\nFor regional addresses, you must specify the region as a path parameter in\nthe HTTP request URL. *This field is not applicable to global\naddresses.*", + "readOnly": true, + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" + }, + "status": { + "description": "Output only. [Output Only] The status of the address, which can be one ofRESERVING, RESERVED, or IN_USE.\nAn address that is RESERVING is currently in the process of\nbeing reserved. A RESERVED address is currently reserved and\navailable to use. An IN_USE address is currently being used\nby another resource and is not available.", + "enum": [ + "IN_USE", + "RESERVED", + "RESERVING" ], - "request": { - "$ref": "Disk" + "enumDescriptions": [ + "Address is being used by another resource and is not available.", + "Address is reserved and available to use.", + "Address is being reserved." + ], + "readOnly": true, + "type": "string" + }, + "subnetwork": { + "description": "The URL of the subnetwork in which to reserve the address. If an IP address\nis specified, it must be within the subnetwork's IP range. This field can\nonly be used with INTERNAL type with aGCE_ENDPOINT or DNS_RESOLVER purpose.", + "type": "string" + }, + "users": { + "description": "[Output Only] The URLs of the resources that are using this address.", + "items": { + "type": "string" }, - "response": { - "$ref": "Operation" + "type": "array" + } + }, + "type": "object" + }, + "AddressAggregatedList": { + "id": "AddressAggregatedList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "additionalProperties": { + "$ref": "AddressesScopedList", + "description": "[Output Only] Name of the scope containing this set of addresses." }, - "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." + "description": "A list of AddressesScopedList resources.", + "type": "object" }, - "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, + "kind": { + "default": "compute#addressAggregatedList", + "description": "Output only. [Output Only] Type of resource. Alwayscompute#addressAggregatedList for aggregated lists of\naddresses.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "unreachables": { + "description": "Output only. [Output Only] Unreachable resources.", + "items": { + "type": "string" + }, + "readOnly": true, + "type": "array" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project", - "zone", - "disk" - ], - "request": { - "$ref": "DisksStartAsyncReplicationRequest" - }, - "response": { - "$ref": "Operation" + "type": "object" + } + }, + "type": "object" + }, + "AddressList": { + "description": "Contains a list of addresses.", + "id": "AddressList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of Address resources.", + "items": { + "$ref": "Address" }, - "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." + "type": "array" }, - "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, + "kind": { + "default": "compute#addressList", + "description": "Output only. [Output Only] Type of resource. Always compute#addressList for\nlists of addresses.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project", - "zone", - "disk" - ], - "response": { - "$ref": "Operation" + "type": "object" + } + }, + "type": "object" + }, + "AddressesScopedList": { + "id": "AddressesScopedList", + "properties": { + "addresses": { + "description": "[Output Only] A list of addresses contained in this scope.", + "items": { + "$ref": "Address" }, - "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." + "type": "array" }, - "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, + "warning": { + "description": "[Output Only] Informational warning which replaces the list of addresses\nwhen the list is empty.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project", - "zone" + "type": "object" + } + }, + "type": "object" + }, + "AdvancedMachineFeatures": { + "description": "Specifies options for controlling advanced machine features.\nOptions that would traditionally be configured in a BIOS belong\nhere. Features that require operating system support may have\ncorresponding entries in the GuestOsFeatures of anImage (e.g., whether or not the OS in theImage supports nested virtualization being enabled or\ndisabled).", + "id": "AdvancedMachineFeatures", + "properties": { + "enableNestedVirtualization": { + "description": "Whether to enable nested virtualization or not (default is false).", + "type": "boolean" + }, + "enableUefiNetworking": { + "description": "Whether to enable UEFI networking for instance creation.", + "type": "boolean" + }, + "performanceMonitoringUnit": { + "description": "Type of Performance Monitoring Unit requested on instance.", + "enum": [ + "ARCHITECTURAL", + "ENHANCED", + "PERFORMANCE_MONITORING_UNIT_UNSPECIFIED", + "STANDARD" ], - "request": { - "$ref": "DisksStopGroupAsyncReplicationResource" + "enumDescriptions": [ + "Architecturally defined non-LLC events.", + "Most documented core/L2 and LLC events.", + "", + "Most documented core/L2 events." + ], + "type": "string" + }, + "threadsPerCore": { + "description": "The number of threads per physical core. To disable simultaneous\nmultithreading (SMT) set this to 1. If unset, the maximum number\nof threads supported per core by the underlying processor is\nassumed.", + "format": "int32", + "type": "integer" + }, + "turboMode": { + "description": "Turbo frequency mode to use for the instance.\nSupported modes include:\n* ALL_CORE_MAX\n\nUsing empty string or not setting this field will use the platform-specific\ndefault turbo mode.", + "type": "string" + }, + "visibleCoreCount": { + "description": "The number of physical cores to expose to an instance. Multiply by\nthe number of threads per core to compute the total number of virtual\nCPUs to expose to the instance. If unset, the number of cores is\ninferred from the instance's nominal CPU count and the underlying\nplatform's SMT width.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, + "AliasIpRange": { + "description": "An alias IP range attached to an instance's network interface.", + "id": "AliasIpRange", + "properties": { + "ipCidrRange": { + "description": "The IP alias ranges to allocate for this interface. This IP CIDR range\nmust belong to the specified subnetwork and cannot contain IP addresses\nreserved by system or used by other network interfaces. This range may be\na single IP address (such as 10.2.3.4), a netmask (such as/24) or a CIDR-formatted string (such as10.1.2.0/24).", + "type": "string" + }, + "subnetworkRangeName": { + "description": "The name of a subnetwork secondary IP range from which to allocate an IP\nalias range. If not specified, the primary range of the subnetwork is used.", + "type": "string" + } + }, + "type": "object" + }, + "AllocationAggregateReservation": { + "description": "This reservation type is specified by total resource amounts (e.g. total\ncount of CPUs) and can account for multiple instance SKUs. In other words,\none can create instances of varying shapes against this reservation.", + "id": "AllocationAggregateReservation", + "properties": { + "inUseResources": { + "description": "Output only. [Output only] List of resources currently in use.", + "items": { + "$ref": "AllocationAggregateReservationReservedResourceInfo" }, - "response": { - "$ref": "Operation" + "readOnly": true, + "type": "array" + }, + "reservedResources": { + "description": "List of reserved resources (CPUs, memory, accelerators).", + "items": { + "$ref": "AllocationAggregateReservationReservedResourceInfo" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "type": "array" + }, + "vmFamily": { + "description": "The VM family that all instances scheduled against this reservation must\nbelong to.", + "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_LITE_POD_SLICE_CT6E", + "VM_FAMILY_CLOUD_TPU_POD_SLICE_CT3P", + "VM_FAMILY_CLOUD_TPU_POD_SLICE_CT4P", + "VM_FAMILY_CLOUD_TPU_POD_SLICE_CT5P", + "VM_FAMILY_CLOUD_TPU_POD_SLICE_TPU7X" + ], + "enumDescriptions": [ + "", + "", + "", + "", + "", + "", + "", + "" ], - "description": "Stops asynchronous replication for a consistency group of disks. Can be invoked either in the primary or secondary scope." + "type": "string" }, - "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" + "workloadType": { + "description": "The workload type of the instances that will target this reservation.", + "enum": [ + "BATCH", + "SERVING", + "UNSPECIFIED" ], - "request": { - "$ref": "BulkInsertDiskResource" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "Reserved resources will be optimized for BATCH workloads, such as ML\ntraining.", + "Reserved resources will be optimized for SERVING workloads, such as ML\ninference.", + "" ], - "description": "Bulk create a set of disks." + "type": "string" } - } + }, + "type": "object" }, - "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" + "AllocationAggregateReservationReservedResourceInfo": { + "id": "AllocationAggregateReservationReservedResourceInfo", + "properties": { + "accelerator": { + "$ref": "AllocationAggregateReservationReservedResourceInfoAccelerator", + "description": "Properties of accelerator resources in this reservation." + } + }, + "type": "object" + }, + "AllocationAggregateReservationReservedResourceInfoAccelerator": { + "id": "AllocationAggregateReservationReservedResourceInfoAccelerator", + "properties": { + "acceleratorCount": { + "description": "Number of accelerators of specified type.", + "format": "int32", + "type": "integer" + }, + "acceleratorType": { + "description": "Full or partial URL to accelerator type. e.g.\n\"projects/{PROJECT}/zones/{ZONE}/acceleratorTypes/ct4l\"", + "type": "string" + } + }, + "type": "object" + }, + "AllocationReservationSharingPolicy": { + "id": "AllocationReservationSharingPolicy", + "properties": { + "serviceShareType": { + "description": "Sharing config for all Google Cloud services.", + "enum": [ + "ALLOW_ALL", + "DISALLOW_ALL", + "SERVICE_SHARE_TYPE_UNSPECIFIED" ], - "response": { - "$ref": "DiskList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "Allow all Google Cloud managed services to share reservations.", + "[Default] Disallow sharing with all Google Cloud services.", + "" ], - "description": "Retrieves the list of persistent disks contained within the specified region." + "type": "string" + } + }, + "type": "object" + }, + "AllocationResourceStatus": { + "description": "[Output Only] Contains output only fields.", + "id": "AllocationResourceStatus", + "properties": { + "healthInfo": { + "$ref": "AllocationResourceStatusHealthInfo", + "description": "[Output only] Health information for the reservation." }, - "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" + "reservationBlockCount": { + "description": "The number of reservation blocks associated with this reservation.", + "format": "int32", + "type": "integer" + }, + "reservationMaintenance": { + "$ref": "GroupMaintenanceInfo", + "description": "Maintenance information for this reservation" + }, + "specificSkuAllocation": { + "$ref": "AllocationResourceStatusSpecificSKUAllocation", + "description": "Allocation Properties of this reservation." + } + }, + "type": "object" + }, + "AllocationResourceStatusHealthInfo": { + "description": "Health information for the reservation.", + "id": "AllocationResourceStatusHealthInfo", + "properties": { + "degradedBlockCount": { + "description": "The number of reservation blocks that are degraded.", + "format": "int32", + "type": "integer" + }, + "healthStatus": { + "description": "The health status of the reservation.", + "enum": [ + "DEGRADED", + "HEALTHY", + "HEALTH_STATUS_UNSPECIFIED" ], - "response": { - "$ref": "Disk" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "The reservation is degraded.", + "The reservation is healthy.", + "The health status of the reservation is unspecified." ], - "description": "Returns a specified regional persistent disk." + "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" - } + "healthyBlockCount": { + "description": "The number of reservation blocks that are healthy.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, + "AllocationResourceStatusSpecificSKUAllocation": { + "description": "Contains Properties set for the reservation.", + "id": "AllocationResourceStatusSpecificSKUAllocation", + "properties": { + "sourceInstanceTemplateId": { + "description": "ID of the instance template used to populate reservation properties.", + "type": "string" + }, + "utilizations": { + "additionalProperties": { + "format": "int64", + "type": "string" }, - "parameterOrder": [ - "project", - "region" + "description": "Per service utilization breakdown. The Key is the Google Cloud managed\nservice name.", + "type": "object" + } + }, + "type": "object" + }, + "AllocationSpecificSKUAllocationAllocatedInstancePropertiesReservedDisk": { + "id": "AllocationSpecificSKUAllocationAllocatedInstancePropertiesReservedDisk", + "properties": { + "diskSizeGb": { + "description": "Specifies the size of the disk in base-2 GB.", + "format": "int64", + "type": "string" + }, + "interface": { + "description": "Specifies the disk interface to use for attaching this disk, which is\neither SCSI or NVME. The default isSCSI.\nFor performance characteristics of SCSI over NVMe, seeLocal SSD performance.", + "enum": [ + "NVME", + "SCSI" ], - "request": { - "$ref": "Disk" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "", + "" ], - "description": "Creates a persistent regional disk in the specified project using the data included in the request." + "type": "string" + } + }, + "type": "object" + }, + "AllocationSpecificSKUAllocationReservedInstanceProperties": { + "description": "Properties of the SKU instances being reserved.\nNext ID: 10", + "id": "AllocationSpecificSKUAllocationReservedInstanceProperties", + "properties": { + "guestAccelerators": { + "description": "Specifies accelerator type and count.", + "items": { + "$ref": "AcceleratorConfig" + }, + "type": "array" }, - "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" - } + "localSsds": { + "description": "Specifies amount of local ssd to reserve with each instance. The type\nof disk is local-ssd.", + "items": { + "$ref": "AllocationSpecificSKUAllocationAllocatedInstancePropertiesReservedDisk" }, - "parameterOrder": [ - "project", - "region", - "resource" + "type": "array" + }, + "locationHint": { + "description": "An opaque location hint used to place the allocation close to other\nresources.\nThis field is for use by internal tools that use the public API.", + "type": "string" + }, + "machineType": { + "description": "Specifies type of machine (name only) which has fixed number of vCPUs\nand fixed amount of memory. This also includes specifying custom\nmachine type following custom-NUMBER_OF_CPUS-AMOUNT_OF_MEMORY pattern.", + "type": "string" + }, + "minCpuPlatform": { + "description": "Minimum cpu platform the reservation.", + "type": "string" + } + }, + "type": "object" + }, + "AllocationSpecificSKUReservation": { + "description": "This reservation type allows to pre allocate specific instance\n configuration.", + "id": "AllocationSpecificSKUReservation", + "properties": { + "assuredCount": { + "description": "Output only. [Output Only] Indicates how many instances are actually usable currently.", + "format": "int64", + "readOnly": true, + "type": "string" + }, + "count": { + "description": "Specifies the number of resources that are allocated.", + "format": "int64", + "type": "string" + }, + "inUseCount": { + "description": "Output only. [Output Only] Indicates how many instances are in use.", + "format": "int64", + "readOnly": true, + "type": "string" + }, + "instanceProperties": { + "$ref": "AllocationSpecificSKUAllocationReservedInstanceProperties", + "description": "The instance properties for the reservation." + }, + "sourceInstanceTemplate": { + "description": "Specifies the instance template to create the reservation. If you use\nthis field, you must exclude the instanceProperties field.\n\nThis field is optional, and it can be a full or partial URL. For example,\nthe following are all valid URLs to an instance template: \n \n \n - https://www.googleapis.com/compute/v1/projects/project/global/instanceTemplates/instanceTemplate\n - projects/project/global/instanceTemplates/instanceTemplate\n - global/instanceTemplates/instanceTemplate", + "type": "string" + } + }, + "type": "object" + }, + "AttachedDisk": { + "description": "An instance-attached disk resource.", + "id": "AttachedDisk", + "properties": { + "architecture": { + "description": "Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64\nor X86_64.", + "enum": [ + "ARCHITECTURE_UNSPECIFIED", + "ARM64", + "X86_64" ], - "request": { - "$ref": "RegionSetLabelsRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "Default value indicating Architecture is not set.", + "Machines with architecture ARM64", + "Machines with architecture X86_64" ], - "description": "Sets the labels on the target regional disk." + "readOnly": true, + "type": "string" + }, + "autoDelete": { + "description": "Specifies whether the disk will be auto-deleted when the instance is\ndeleted (but not when the disk is detached from the instance).", + "type": "boolean" + }, + "boot": { + "description": "Indicates that this is a boot disk. The virtual machine will use the first\npartition of the disk for its root filesystem.", + "type": "boolean" + }, + "deviceName": { + "description": "Specifies a unique device name of your choice that is reflected into the/dev/disk/by-id/google-* tree of a Linux operating system\nrunning within the instance. This name can be used to reference the device\nfor mounting, resizing, and so on, from within the instance.\n\nIf not specified, the server chooses a default device name to apply to this\ndisk, in the form persistent-disk-x, where x is a number\nassigned by Google Compute Engine. This field is only applicable for\npersistent disks.", + "type": "string" + }, + "diskEncryptionKey": { + "$ref": "CustomerEncryptionKey", + "description": "Encrypts or decrypts a disk using acustomer-supplied\nencryption key.\n\nIf you are creating a new disk, this field encrypts the new disk using\nan encryption key that you provide. If you are attaching an existing\ndisk that is already encrypted, this field decrypts the disk using\nthe customer-supplied encryption key.\n\nIf you encrypt a disk using a customer-supplied key, you must provide the\nsame key again when you attempt to use this resource at a later time. For\nexample, you must provide the key when you create a snapshot or an image\nfrom the disk or when you attach the disk to a virtual machine instance.\n\nIf you do not provide an encryption key, then the disk will be encrypted\nusing an automatically generated key and you do not need to provide a key\nto use the disk later.\n\nNote:\n\nInstance templates do not storecustomer-supplied\nencryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.\n\nYou cannot create VMs that have disks with customer-supplied keys using\nthe bulk\ninsert method." + }, + "diskSizeGb": { + "description": "The size of the disk in GB.", + "format": "int64", + "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" - } + "forceAttach": { + "description": "[Input Only] Whether to force attach the regional disk even if it's\ncurrently attached to another instance. If you try to force attach a zonal\ndisk to an instance, you will receive an error.", + "type": "boolean" + }, + "guestOsFeatures": { + "description": "A list of features to enable on the guest operating system. Applicable\nonly for bootable images. Read\nEnabling guest operating system features to see a list of available\noptions.", + "items": { + "$ref": "GuestOsFeature" }, - "parameterOrder": [ - "project", - "region", - "disk" + "type": "array" + }, + "index": { + "description": "Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the\nboot disk. If you have many disks attached to an instance, each\ndisk would have a unique index number.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "initializeParams": { + "$ref": "AttachedDiskInitializeParams", + "description": "[Input Only] Specifies the parameters for a new disk that will be created\nalongside the new instance. Use initialization parameters to create boot\ndisks or local SSDs attached to the new instance.\n\nThis property is mutually exclusive with the source property;\nyou can only define one or the other, but not both." + }, + "interface": { + "description": "Specifies the disk interface to use for attaching this disk, which is\neither SCSI or NVME. For most machine types, the\ndefault is SCSI. Local SSDs can use either NVME or SCSI.\nIn certain configurations, persistent disks can use NVMe. For more\ninformation, seeAbout\npersistent disks.", + "enum": [ + "NVME", + "SCSI" ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "", + "" ], - "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" - } + "kind": { + "default": "compute#attachedDisk", + "description": "Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.", + "readOnly": true, + "type": "string" + }, + "licenses": { + "description": "Output only. [Output Only] Any valid publicly visible licenses.", + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "region", - "disk" + "readOnly": true, + "type": "array" + }, + "mode": { + "description": "The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the disk\nin READ_WRITE mode.", + "enum": [ + "READ_ONLY", + "READ_WRITE" ], - "request": { - "$ref": "Snapshot" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "Attaches this disk in read-only mode. Multiple virtual machines can use\na disk in read-only mode at a time.", + "*[Default]* Attaches this disk in read-write mode. Only one\nvirtual machine at a time can be attached to a disk in read-write mode." ], - "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." + "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" + "savedState": { + "description": "Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this\nfield is set to PRESERVED if the LocalSSD data has been saved\nto a persistent location by customer request. (see the\ndiscard_local_ssd option on Stop/Suspend).\nRead-only in the api.", + "enum": [ + "DISK_SAVED_STATE_UNSPECIFIED", + "PRESERVED" ], - "request": { - "$ref": "RegionDisksResizeRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "*[Default]* Disk state has not been preserved.", + "Disk state has been preserved." ], - "description": "Resizes the specified regional persistent disk." + "readOnly": true, + "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" + "shieldedInstanceInitialState": { + "$ref": "InitialStateConfig", + "description": "Output only. [Output Only] shielded vm initial state stored on disk", + "readOnly": true + }, + "source": { + "description": "Specifies a valid partial or full URL to an existing Persistent Disk\nresource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source\nis required.\n\nIf desired, you can also attach existing non-root persistent disks using\nthis property. This field is only applicable for persistent disks.\n\nNote that for InstanceTemplate, specify the disk name for zonal disk,\nand the URL for regional disk.", + "type": "string" + }, + "type": { + "description": "Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT.", + "enum": [ + "PERSISTENT", + "SCRATCH" ], - "request": { - "$ref": "RegionDisksAddResourcePoliciesRequest" + "enumDescriptions": [ + "", + "" + ], + "type": "string" + } + }, + "type": "object" + }, + "AttachedDiskInitializeParams": { + "description": "[Input Only] Specifies the parameters for a new disk that will be created\nalongside the new instance. Use initialization parameters to create boot\ndisks or local SSDs attached to the new instance.\n\nThis field is persisted and returned for instanceTemplate and not returned\nin the context of instance.\n\nThis property is mutually exclusive with the source property;\nyou can only define one or the other, but not both.", + "id": "AttachedDiskInitializeParams", + "properties": { + "architecture": { + "description": "The architecture of the attached disk. Valid values are\narm64 or x86_64.", + "enum": [ + "ARCHITECTURE_UNSPECIFIED", + "ARM64", + "X86_64" + ], + "enumDescriptions": [ + "Default value indicating Architecture is not set.", + "Machines with architecture ARM64", + "Machines with architecture X86_64" + ], + "type": "string" + }, + "description": { + "description": "An optional description. Provide this property when creating the disk.", + "type": "string" + }, + "diskName": { + "description": "Specifies the disk name. If not specified, the default is to use the name\nof the instance. If a disk with the same name already exists in the given\nregion, the existing disk is attached to the new instance and the\nnew disk is not created.", + "type": "string" + }, + "diskSizeGb": { + "description": "Specifies the size of the disk in base-2 GB. The size must be at least\n10 GB. If you specify a sourceImage, which is required for\nboot disks, the default size is the size of the sourceImage.\nIf you do not specify a sourceImage, the default disk size\nis 500 GB.", + "format": "int64", + "type": "string" + }, + "diskType": { + "description": "Specifies the disk type used for the boot disk or an additional data\ndisk. For valid disk type values, see \nSupported types for Hyperdisk volumes and\nPersistent Disk type variables.\n\nWhen creating a single instance, you must provide either the full or\npartial URL of the disk type. For example, the following values are\nvalid: \n \n \n - https://www.googleapis.com/compute/v1/projects/project/zones/zone/diskTypes/diskType\n - projects/project/zones/zone/diskTypes/diskType\n - zones/zone/diskTypes/diskType\n\n\n\nWhen creating an instance template, instance flexibility policy, or when\ncreating or updating an all-instances configuration, you specify the\ndisk type without a URL, for example, hyperdisk-balanced.\n\nIf you omit this field for a disk, the default disk type depends on\nthe instance's machine series, as follows.\n \n \n - For first- and second-generation machine series like N1, N2, T2, and\n M1, the\n default disk type is Standard Persistent Disk\n (pd-standard).\n - For C3, C3D, and M3 the default is Balanced Persistent Disk\n (pd-balanced). \n - For other third-generation machine\n series like A3, H3, Z3, all\n fourth-generation types like C4, N4, M4, and newer machine series,\n the default is Hyperdisk Balanced\n (hyperdisk-balanced).\n\n\n\nThe disk type you specify must be compatible with the instance's machine\nseries. For a list of machine series that support Persistent Disk, see Machine\nseries support for Persistent Disk.\n\nFor a list of machine series that support Hyperdisk, seeMachine\nseries support for Hyperdisk.", + "type": "string" + }, + "enableConfidentialCompute": { + "description": "Whether this disk is using confidential compute mode.", + "type": "boolean" + }, + "labels": { + "additionalProperties": { + "type": "string" }, - "response": { - "$ref": "Operation" + "description": "Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for\npersistent disks.", + "type": "object" + }, + "licenses": { + "description": "A list of publicly visible licenses. Reserved for Google's use.", + "items": { + "type": "string" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "type": "array" + }, + "onUpdateAction": { + "description": "Specifies which action to take on instance update with this disk. Default\nis to use the existing disk.", + "enum": [ + "RECREATE_DISK", + "RECREATE_DISK_IF_SOURCE_CHANGED", + "USE_EXISTING_DISK" + ], + "enumDescriptions": [ + "Always recreate the disk.", + "Recreate the disk if source (image, snapshot) of this disk is different\nfrom source of existing disk.", + "Use the existing disk, this is the default behaviour." ], - "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." + "type": "string" }, - "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" - } + "provisionedIops": { + "description": "Indicates how many IOPS to provision for the disk. This sets the number\nof I/O operations per second that the disk can handle. Values must be\nbetween 10,000 and 120,000. For more details, see theExtreme persistent\ndisk documentation.", + "format": "int64", + "type": "string" + }, + "provisionedThroughput": { + "description": "Indicates how much throughput to provision for the disk. This sets the\nnumber of throughput mb per second that the disk can handle. Values must\ngreater than or equal to 1.", + "format": "int64", + "type": "string" + }, + "replicaZones": { + "description": "Required for each regional disk associated with the instance. Specify\nthe URLs of the zones where the disk should be replicated to.\nYou must provide exactly two replica zones, and one zone must be the same\nas the instance zone.", + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "region", - "disk" - ], - "request": { - "$ref": "RegionDisksRemoveResourcePoliciesRequest" + "type": "array" + }, + "resourceManagerTags": { + "additionalProperties": { + "type": "string" }, - "response": { - "$ref": "Operation" + "description": "Input only. Resource manager tags to be bound to the disk. Tag keys and values\nhave the same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in\nnamespaced format such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT & PATCH) when\nempty.", + "type": "object" + }, + "resourcePolicies": { + "description": "Resource policies applied to this disk for automatic snapshot creations.\nSpecified using the full or partial URL. For instance template, specify\nonly the resource policy name.", + "items": { + "type": "string" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Removes resource policies from a regional disk." + "type": "array" }, - "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" - } + "sourceImage": { + "description": "The source image to create this disk. When creating a new instance boot\ndisk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source\nis required.\n\nTo create a disk with one of the public operating system\nimages, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:\n\nprojects/debian-cloud/global/images/family/debian-9\n\n\nAlternatively, use a specific version of a public operating system image:\n\nprojects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD\n\n\nTo create a disk with a custom image that you created, specify the\nimage name in the following format:\n\nglobal/images/my-custom-image\n\n\nYou can also specify a custom image by its image family, which returns\nthe latest version of the image in that family. Replace the image name\nwith family/family-name:\n\nglobal/images/family/my-image-family\n\n\nIf the source image is deleted later, this field will not be set.", + "type": "string" + }, + "sourceImageEncryptionKey": { + "$ref": "CustomerEncryptionKey", + "description": "Thecustomer-supplied\nencryption key of the source image. Required if the source image is\nprotected by a customer-supplied encryption key.\n\nInstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied\nencryption keys, so you cannot create disks for instances in a managed instance group if the\nsource images are encrypted with your own keys." + }, + "sourceSnapshot": { + "description": "The source snapshot to create this disk. When creating a new instance\nboot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source\nis required.\n\nTo create a disk with a snapshot that you created, specify the\nsnapshot name in the following format:\n\nglobal/snapshots/my-backup\n\n\nIf the source snapshot is deleted later, this field will not be set.\n\nNote: You cannot create VMs in bulk using a snapshot as the source. Use\nan image instead when you create VMs using\nthe bulk\ninsert method.", + "type": "string" + }, + "sourceSnapshotEncryptionKey": { + "$ref": "CustomerEncryptionKey", + "description": "Thecustomer-supplied\nencryption key of the source snapshot." + }, + "storagePool": { + "description": "The storage pool in which the new disk is created. You can provide\nthis as a partial or full URL to the resource. For example, the following\nare valid values:\n \n \n - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool\n - projects/project/zones/zone/storagePools/storagePool \n - zones/zone/storagePools/storagePool", + "type": "string" + } + }, + "type": "object" + }, + "AuditConfig": { + "description": "Specifies the audit configuration for a service.\nThe configuration determines which permission types are logged, and what\nidentities, if any, are exempted from logging.\nAn AuditConfig must have one or more AuditLogConfigs.\n\nIf there are AuditConfigs for both `allServices` and a specific service,\nthe union of the two AuditConfigs is used for that service: the log_types\nspecified in each AuditConfig are enabled, and the exempted_members in each\nAuditLogConfig are exempted.\n\nExample Policy with multiple AuditConfigs:\n\n {\n \"audit_configs\": [\n {\n \"service\": \"allServices\",\n \"audit_log_configs\": [\n {\n \"log_type\": \"DATA_READ\",\n \"exempted_members\": [\n \"user:jose@example.com\"\n ]\n },\n {\n \"log_type\": \"DATA_WRITE\"\n },\n {\n \"log_type\": \"ADMIN_READ\"\n }\n ]\n },\n {\n \"service\": \"sampleservice.googleapis.com\",\n \"audit_log_configs\": [\n {\n \"log_type\": \"DATA_READ\"\n },\n {\n \"log_type\": \"DATA_WRITE\",\n \"exempted_members\": [\n \"user:aliya@example.com\"\n ]\n }\n ]\n }\n ]\n }\n\nFor sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ\nlogging. It also exempts `jose@example.com` from DATA_READ logging, and\n`aliya@example.com` from DATA_WRITE logging.", + "id": "AuditConfig", + "properties": { + "auditLogConfigs": { + "description": "The configuration for logging of each type of permission.", + "items": { + "$ref": "AuditLogConfig" }, - "parameterOrder": [ - "project", - "region", - "resource" - ], - "response": { - "$ref": "Policy" + "type": "array" + }, + "service": { + "description": "Specifies a service that will be enabled for audit logging.\nFor example, `storage.googleapis.com`, `cloudsql.googleapis.com`.\n`allServices` is a special value that covers all services.", + "type": "string" + } + }, + "type": "object" + }, + "AuditLogConfig": { + "description": "Provides the configuration for logging a type of permissions.\nExample:\n\n {\n \"audit_log_configs\": [\n {\n \"log_type\": \"DATA_READ\",\n \"exempted_members\": [\n \"user:jose@example.com\"\n ]\n },\n {\n \"log_type\": \"DATA_WRITE\"\n }\n ]\n }\n\nThis enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting\njose@example.com from DATA_READ logging.", + "id": "AuditLogConfig", + "properties": { + "exemptedMembers": { + "description": "Specifies the identities that do not cause logging for this type of\npermission.\nFollows the same format of Binding.members.", + "items": { + "type": "string" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "type": "array" + }, + "logType": { + "description": "The log type that this config enables.", + "enum": [ + "ADMIN_READ", + "DATA_READ", + "DATA_WRITE", + "LOG_TYPE_UNSPECIFIED" + ], + "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": "Gets the access control policy for a resource. May be empty if no such policy or resource exists." + "type": "string" + } + }, + "type": "object" + }, + "Autoscaler": { + "description": "Represents an Autoscaler resource.\n\nGoogle Compute Engine has two Autoscaler resources:\n\n* [Zonal](/compute/docs/reference/rest/v1/autoscalers)\n* [Regional](/compute/docs/reference/rest/v1/regionAutoscalers)\n\nUse autoscalers to automatically add or delete instances from a\nmanaged instance group according to your defined autoscaling policy.\nFor more information, read Autoscaling Groups of Instances.\n\nFor zonal managed instance groups resource, use the autoscaler\nresource.\n\nFor regional managed instance groups, use theregionAutoscalers resource.", + "id": "Autoscaler", + "properties": { + "autoscalingPolicy": { + "$ref": "AutoscalingPolicy", + "description": "The configuration parameters for the autoscaling algorithm. You can define\none or more signals for an autoscaler: cpuUtilization,customMetricUtilizations, andloadBalancingUtilization.\n\nIf none of these are specified, the default will be to autoscale based oncpuUtilization to 0.6 or 60%." }, - "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" - } + "creationTimestamp": { + "description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you\ncreate the resource.", + "type": "string" + }, + "id": { + "description": "Output only. [Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "format": "uint64", + "readOnly": true, + "type": "string" + }, + "kind": { + "default": "compute#autoscaler", + "description": "Output only. [Output Only] Type of the resource. Always compute#autoscaler\nfor autoscalers.", + "readOnly": true, + "type": "string" + }, + "name": { + "annotations": { + "required": [ + "compute.autoscalers.insert" + ] }, - "parameterOrder": [ - "project", - "region", - "resource" + "description": "Name of the resource. Provided by the client when the resource is created.\nThe name must be 1-63 characters long, and comply withRFC1035.\nSpecifically, the name must be 1-63 characters long and match the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first\ncharacter must be a lowercase letter, and all following characters must\nbe a dash, lowercase letter, or digit, except the last character, which\ncannot be a dash.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "recommendedSize": { + "description": "Output only. [Output Only] Target recommended MIG size (number of instances) computed by\nautoscaler. Autoscaler calculates the recommended MIG size even when the\nautoscaling policy mode is different from ON. This field is empty when\nautoscaler is not connected to an existing managed instance group or\nautoscaler did not generate its prediction.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "region": { + "description": "Output only. [Output Only] URL of theregion\nwhere the instance group resides (for autoscalers living in regional\nscope).", + "readOnly": true, + "type": "string" + }, + "scalingScheduleStatus": { + "additionalProperties": { + "$ref": "ScalingScheduleStatus" + }, + "description": "Output only. [Output Only] Status information of existing scaling schedules.", + "readOnly": true, + "type": "object" + }, + "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\npossible values:\n \n - PENDING:\n Autoscaler backend hasn't read new/updated configuration.\n - DELETING:\n Configuration is being deleted.\n - ACTIVE:\n Configuration is acknowledged to be effective. Some warnings might\n be present in the statusDetails field.\n - ERROR:\n Configuration has errors. Actionable for users. Details are present in\n the statusDetails field.\n\n\nNew values might be added in the future.", + "enum": [ + "ACTIVE", + "DELETING", + "ERROR", + "PENDING" ], - "request": { - "$ref": "RegionSetPolicyRequest" + "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" + ], + "type": "string" + }, + "statusDetails": { + "description": "[Output Only] Human-readable details about the current state of the\nautoscaler. Read the documentation forCommonly\nreturned status messages for examples of status messages you might\nencounter.", + "items": { + "$ref": "AutoscalerStatusDetails" }, - "response": { - "$ref": "Policy" + "type": "array" + }, + "target": { + "description": "URL of the managed instance group that this autoscaler will scale. This\nfield is required when creating an autoscaler.", + "type": "string" + }, + "zone": { + "description": "Output only. [Output Only] URL of thezone\nwhere the instance group resides (for autoscalers living in zonal scope).", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "AutoscalerAggregatedList": { + "id": "AutoscalerAggregatedList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "additionalProperties": { + "$ref": "AutoscalersScopedList", + "description": "[Output Only] Name of the scope containing this set of autoscalers." }, - "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": "A list of AutoscalersScopedList resources.", + "type": "object" }, - "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, + "kind": { + "default": "compute#autoscalerAggregatedList", + "description": "Output only. [Output Only] Type of resource. Alwayscompute#autoscalerAggregatedList for aggregated lists of\nautoscalers.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "unreachables": { + "description": "Output only. [Output Only] Unreachable resources.\nend_interface: MixerListResponseWithEtagBuilder", + "items": { + "type": "string" + }, + "readOnly": true, + "type": "array" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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" } }, - "parameterOrder": [ - "project", - "region", - "resource" - ], - "request": { - "$ref": "TestPermissionsRequest" - }, - "response": { - "$ref": "TestPermissionsResponse" + "type": "object" + } + }, + "type": "object" + }, + "AutoscalerList": { + "description": "Contains a list of Autoscaler resources.", + "id": "AutoscalerList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of Autoscaler resources.", + "items": { + "$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 permissions that a caller has on the specified resource." + "type": "array" }, - "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, + "kind": { + "default": "compute#autoscalerList", + "description": "Output only. [Output Only] Type of resource. Always compute#autoscalerList\nfor lists of autoscalers.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. 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" - }, - "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" + "type": "object" + } + }, + "type": "object" + }, + "AutoscalerStatusDetails": { + "id": "AutoscalerStatusDetails", + "properties": { + "message": { + "description": "The status message.", + "type": "string" + }, + "type": { + "description": "The type of error, warning, or notice returned. Current set of possible\nvalues:\n \n - ALL_INSTANCES_UNHEALTHY (WARNING):\n All instances in the instance group are unhealthy (not in RUNNING\n state).\n - BACKEND_SERVICE_DOES_NOT_EXIST (ERROR):\n There is no backend service attached to the instance group.\n - CAPPED_AT_MAX_NUM_REPLICAS (WARNING):\n Autoscaler recommends a size greater than maxNumReplicas.\n - CUSTOM_METRIC_DATA_POINTS_TOO_SPARSE (WARNING):\n The custom metric samples are not exported often enough to be\n a credible base for autoscaling.\n - CUSTOM_METRIC_INVALID (ERROR):\n The custom metric that was specified does not exist or does not have\n the necessary labels.\n - MIN_EQUALS_MAX (WARNING):\n The minNumReplicas is equal to maxNumReplicas. This means the\n autoscaler cannot add or remove instances from the instance group.\n - MISSING_CUSTOM_METRIC_DATA_POINTS (WARNING):\n The autoscaler did not receive any data from the custom metric\n configured for autoscaling.\n - MISSING_LOAD_BALANCING_DATA_POINTS (WARNING):\n The autoscaler is configured to scale based on a load balancing signal\n but the instance group has not received any requests from the load\n balancer.\n - MODE_OFF (WARNING):\n Autoscaling is turned off. The number of instances in the group won't\n change automatically. The autoscaling configuration is preserved.\n - MODE_ONLY_UP (WARNING):\n Autoscaling is in the \"Autoscale only out\" mode. The autoscaler can add\n instances but not remove any.\n - MORE_THAN_ONE_BACKEND_SERVICE (ERROR):\n The instance group cannot be autoscaled because it has more than one\n backend service attached to it.\n - NOT_ENOUGH_QUOTA_AVAILABLE (ERROR):\n There is insufficient quota for the necessary resources, such as CPU or\n number of instances.\n - REGION_RESOURCE_STOCKOUT (ERROR):\n Shown only for regional autoscalers: there is a resource stockout in\n the chosen region.\n - SCALING_TARGET_DOES_NOT_EXIST (ERROR):\n The target to be scaled does not exist.\n - UNSUPPORTED_MAX_RATE_LOAD_BALANCING_CONFIGURATION\n (ERROR): Autoscaling does not work with an HTTP/S load balancer that\n has been configured for maxRate.\n - ZONE_RESOURCE_STOCKOUT (ERROR):\n For zonal autoscalers: there is a resource stockout in the chosen zone.\n For regional autoscalers: in at least one of the zones you're using\n there is a resource stockout.\n\n\nNew values might be added in the future. Some of the values might not be\navailable in all API versions.", + "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" ], - "request": { - "$ref": "Disk" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "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\nbase for autoscaling.", + "The custom metric that was specified does not exist or does not have the\nnecessary labels.", + "The minNumReplicas is equal to maxNumReplicas. This means the autoscaler\ncannot add or remove instances from the instance group.", + "The autoscaler did not receive any data from the custom metric configured\nfor autoscaling.", + "The autoscaler is configured to scale based on a load balancing signal\nbut the instance group has not received any requests from the load\nbalancer.", + "Autoscaling is turned off. The number of instances in the group won't\nchange automatically. The autoscaling configuration is preserved.", + "Autoscaling is in the \"Autoscale only scale out\" mode.\nInstances in the group will be only added.", + "Autoscaling is in the \"Autoscale only out\" mode. Instances in the group\nwill be only added.", + "The instance group cannot be autoscaled because it has more than one\nbackend service attached to it.", + "There is insufficient quota for the necessary resources, such as CPU or\nnumber of instances.", + "Showed only for regional autoscalers: there is a resource stockout in\nthe chosen region.", + "The target to be scaled does not exist.", + "For some scaling schedules minRequiredReplicas is greater than\nmaxNumReplicas. Autoscaler always recommends at most maxNumReplicas\ninstances.", + "For some scaling schedules minRequiredReplicas is less than\nminNumReplicas. Autoscaler always recommends at least minNumReplicas\ninstances.", + "", + "Autoscaling does not work with an HTTP/S load balancer that has been\nconfigured for maxRate.", + "For zonal autoscalers: there is a resource stockout in the chosen zone.\nFor regional autoscalers: in at least one of the zones you're using there\nis a resource stockout." ], - "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." + "type": "string" + } + }, + "type": "object" + }, + "AutoscalersScopedList": { + "id": "AutoscalersScopedList", + "properties": { + "autoscalers": { + "description": "[Output Only] A list of autoscalers contained in this scope.", + "items": { + "$ref": "Autoscaler" + }, + "type": "array" }, - "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, + "warning": { + "description": "[Output Only] Informational warning which replaces the list of autoscalers\nwhen the list is empty.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. 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" } }, - "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." + "type": "object" + } + }, + "type": "object" + }, + "AutoscalingPolicy": { + "description": "Cloud Autoscaler policy.", + "id": "AutoscalingPolicy", + "properties": { + "coolDownPeriodSec": { + "description": "The number of seconds that your application takes to initialize on a VM\ninstance. This is referred to as the\n[initialization period](/compute/docs/autoscaler#cool_down_period).\nSpecifying an accurate initialization period improves\nautoscaler decisions. For example, when scaling out, the autoscaler ignores\ndata from VMs that are still initializing because those VMs might not yet\nrepresent normal usage of your application. The default initialization\nperiod is 60 seconds.\n\nInitialization periods might vary because of numerous\nfactors. We recommend that you test how long your application takes to\ninitialize. To do this, create a VM and time your application's startup\nprocess.", + "format": "int32", + "type": "integer" }, - "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." + "cpuUtilization": { + "$ref": "AutoscalingPolicyCpuUtilization", + "description": "Defines the CPU utilization policy that allows the autoscaler to scale\nbased on the average CPU utilization of a managed instance group." }, - "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" - } + "customMetricUtilizations": { + "description": "Configuration parameters of autoscaling based on a custom metric.", + "items": { + "$ref": "AutoscalingPolicyCustomMetricUtilization" }, - "parameterOrder": [ - "project", - "region" + "type": "array" + }, + "loadBalancingUtilization": { + "$ref": "AutoscalingPolicyLoadBalancingUtilization", + "description": "Configuration parameters of autoscaling based on load balancer." + }, + "maxNumReplicas": { + "description": "The maximum number of instances that the autoscaler can scale out to. This\nis required when creating or updating an autoscaler. The maximum number\nof replicas must not be lower than minimal number of replicas.", + "format": "int32", + "type": "integer" + }, + "minNumReplicas": { + "description": "The minimum number of replicas that the autoscaler can scale in to.\nThis cannot be less than 0. If not provided, autoscaler chooses a\ndefault value depending on maximum number of instances allowed.", + "format": "int32", + "type": "integer" + }, + "mode": { + "description": "Defines the operating mode for this policy.\nThe following modes are available:\n \n - OFF: Disables the autoscaler but maintains its\n configuration.\n - ONLY_SCALE_OUT: Restricts the autoscaler to add\n VM instances only.\n - ON: Enables all autoscaler activities according to its\n policy.\n\n\nFor more information, see \n\"Turning off or restricting an autoscaler\"", + "enum": [ + "OFF", + "ON", + "ONLY_SCALE_OUT", + "ONLY_UP" ], - "request": { - "$ref": "DisksStopGroupAsyncReplicationResource" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "Do not automatically scale the MIG in or out.\nThe recommended_size field contains the size of MIG that would be set if\nthe 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\nthe MIG in.", + "Automatically create VMs according to the policy, but do not scale\nthe MIG in.\nIt's recommended to use ONLY_SCALE_OUT instead of ONLY_UP." ], - "description": "Stops asynchronous replication for a consistency group of disks. Can be invoked either in the primary or secondary scope." + "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" - } + "scaleInControl": { + "$ref": "AutoscalingPolicyScaleInControl" + }, + "scalingSchedules": { + "additionalProperties": { + "$ref": "AutoscalingPolicyScalingSchedule" }, - "parameterOrder": [ - "project", - "region" + "description": "Scaling schedules defined for an autoscaler. Multiple schedules\ncan be set on an autoscaler, and they can overlap. During overlapping\nperiods the greatest min_required_replicas of all scaling schedules is\napplied. Up to 128 scaling schedules are allowed.", + "type": "object" + }, + "stabilizationPeriodSec": { + "description": "The number of seconds that autoscaler waits for load stabilization before\nmaking scale-in decisions. This is referred to as the\n[stabilization period](/compute/docs/autoscaler#stabilization_period).\nThis might appear as a delay in scaling in but it is an important mechanism\nfor your application to not have fluctuating size due to short term load\nfluctuations.\n\nThe default stabilization period is 600 seconds.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, + "AutoscalingPolicyCpuUtilization": { + "description": "CPU utilization policy.", + "id": "AutoscalingPolicyCpuUtilization", + "properties": { + "predictiveMethod": { + "description": "Indicates whether predictive autoscaling based on CPU metric is enabled.\nValid values are:\n\n* NONE (default). No predictive method is used. The autoscaler scales the\ngroup to meet current demand based on real-time metrics.\n* OPTIMIZE_AVAILABILITY. Predictive autoscaling improves availability by\nmonitoring daily and weekly load patterns and scaling out ahead of\nanticipated demand.", + "enum": [ + "NONE", + "OPTIMIZE_AVAILABILITY" ], - "request": { - "$ref": "BulkInsertDiskResource" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "No predictive method is used. The autoscaler scales the group to meet\ncurrent demand based on real-time metrics", + "Predictive autoscaling improves availability by monitoring daily and\nweekly load patterns and scaling out ahead of anticipated demand." ], - "description": "Bulk create a set of disks." + "type": "string" + }, + "utilizationTarget": { + "description": "The target CPU utilization that the autoscaler maintains. Must be\na float value in the range (0, 1]. If not specified, the default is0.6.\n\nIf the CPU level is below the target utilization, the autoscaler scales\nin the number of instances until it reaches the minimum number of\ninstances you specified or until the average CPU of your instances\nreaches the target utilization.\n\nIf the average CPU is above the target utilization, the autoscaler\nscales out until it reaches the maximum number of instances you\nspecified or until the average utilization reaches the target\nutilization.", + "format": "double", + "type": "number" } - } + }, + "type": "object" }, - "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" + "AutoscalingPolicyCustomMetricUtilization": { + "description": "Custom utilization metric policy.", + "id": "AutoscalingPolicyCustomMetricUtilization", + "properties": { + "filter": { + "description": "A filter string, compatible with a Stackdriver Monitoringfilter string forTimeSeries.list API call. This filter is\nused to select a specific TimeSeries for the purpose of autoscaling and\nto determine whether the metric is exporting per-instance or\nper-group data.\n\nFor the filter to be valid for autoscaling purposes, the following rules\napply:\n \n \n - You can only use the AND operator for joining\n selectors.\n - You can only use direct equality comparison operator\n (=) without any functions for each selector.\n - You can specify the metric in both the filter string and in the\n metric field. However, if specified in both places, the metric must\n be identical.\n - The monitored resource type\n determines what kind of values are expected for the metric. If it is\n a gce_instance, the autoscaler expects the metric to\n include a separate TimeSeries for each instance in a group. In such a\n case, you cannot filter on resource labels.\n \n \n If the resource type is any other value, the autoscaler expects\n this metric to contain values that apply to the entire autoscaled\n instance group and resource label filtering can be performed to\n point autoscaler at the correct TimeSeries to scale upon. This is\n called a *per-group metric* for the purpose of autoscaling.\n \n If not specified, the type defaults to\n gce_instance.\n\n\n\nTry to provide a filter that is selective enough to pick just one\nTimeSeries for the autoscaled group or for each of the instances (if you\nare using gce_instance resource type). If multiple\nTimeSeries are returned upon the query execution, the autoscaler will sum\ntheir respective values to obtain its scaling value.", + "type": "string" + }, + "metric": { + "description": "The identifier (type) of the Stackdriver Monitoring metric. The metric\ncannot have negative values.\n\nThe metric must have a value type of INT64 orDOUBLE.", + "type": "string" + }, + "singleInstanceAssignment": { + "description": "If scaling is based on a per-group metric value that represents the\ntotal amount of work to be done or resource usage, set this value to an\namount assigned for a single instance of the scaled group. Autoscaler\nkeeps the number of instances proportional to the value of this\nmetric. The metric itself does not change value due to group\nresizing.\n\nA good metric to use with the target is for examplepubsub.googleapis.com/subscription/num_undelivered_messages\nor a custom metric exporting the total number of requests coming to\nyour instances.\n\nA bad example would be a metric exporting an average or median latency,\nsince this value can't include a chunk assignable to a single instance,\nit could be better used with utilization_target instead.", + "format": "double", + "type": "number" + }, + "utilizationTarget": { + "description": "The target value of the metric that autoscaler maintains. This\nmust be a positive value. A utilization metric scales number of\nvirtual machines handling requests to increase or decrease\nproportionally to the metric.\n\nFor example, a good metric to use as a utilization_target ishttps://www.googleapis.com/compute/v1/instance/network/received_bytes_count.\nThe autoscaler works to keep this value constant for each of the\ninstances.", + "format": "double", + "type": "number" + }, + "utilizationTargetType": { + "description": "Defines how target utilization value is expressed for a Stackdriver\nMonitoring metric. Either GAUGE,DELTA_PER_SECOND, or DELTA_PER_MINUTE.", + "enum": [ + "DELTA_PER_MINUTE", + "DELTA_PER_SECOND", + "GAUGE" ], - "response": { - "$ref": "FirewallList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "Sets the utilization target value for a cumulative or delta metric,\nexpressed as the rate of growth per minute.", + "Sets the utilization target value for a cumulative or delta metric,\nexpressed as the rate of growth per second.", + "Sets the utilization target value for a gauge metric. The autoscaler\nwill collect the average utilization of the virtual machines from the\nlast couple of minutes, and compare the value to the utilization\ntarget value to perform autoscaling." ], - "description": "Retrieves the list of firewall rules available to the specified project." + "type": "string" + } + }, + "type": "object" + }, + "AutoscalingPolicyLoadBalancingUtilization": { + "description": "Configuration parameters of autoscaling based on load balancing.", + "id": "AutoscalingPolicyLoadBalancingUtilization", + "properties": { + "utilizationTarget": { + "description": "Fraction of backend capacity utilization (set in HTTP(S) load balancing\nconfiguration) that the autoscaler maintains. Must be a positive float\nvalue. If not defined, the default is 0.8.", + "format": "double", + "type": "number" + } + }, + "type": "object" + }, + "AutoscalingPolicyScaleInControl": { + "description": "Configuration that allows for slower scale in so that even if Autoscaler\nrecommends an abrupt scale in of a MIG, it will be throttled as specified\nby the parameters below.", + "id": "AutoscalingPolicyScaleInControl", + "properties": { + "maxScaledInReplicas": { + "$ref": "FixedOrPercent", + "description": "Maximum allowed number (or %) of VMs that can be deducted from the peak\nrecommendation during the window autoscaler looks at when computing\nrecommendations. Possibly all these VMs can be deleted at once so user\nservice needs to be prepared to lose that many VMs in one step." }, - "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" + "timeWindowSec": { + "description": "How far back autoscaling looks when computing recommendations to\ninclude directives regarding slower scale in, as described above.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, + "AutoscalingPolicyScalingSchedule": { + "description": "Scaling based on user-defined schedule. The message describes a single\nscaling schedule. A scaling schedule changes the minimum number of VM\ninstances an autoscaler can recommend, which can trigger scaling out.", + "id": "AutoscalingPolicyScalingSchedule", + "properties": { + "description": { + "description": "A description of a scaling schedule.", + "type": "string" + }, + "disabled": { + "description": "A boolean value that specifies whether a scaling schedule can influence\nautoscaler recommendations. If set to true, then a scaling schedule has\nno effect. This field is optional, and its value is false by default.", + "type": "boolean" + }, + "durationSec": { + "description": "The duration of time intervals, in seconds, for which this\nscaling schedule is to run. The minimum allowed value is 300.\nThis field is required.", + "format": "int32", + "type": "integer" + }, + "minRequiredReplicas": { + "description": "The minimum number of VM instances that the autoscaler will\nrecommend in time intervals starting according to schedule. This field is\nrequired.", + "format": "int32", + "type": "integer" + }, + "schedule": { + "description": "The start timestamps of time intervals when this scaling\nschedule is to provide a scaling signal. This field uses the extended\ncron format (with an optional year field). The expression can describe a\nsingle timestamp if the optional year is set, in which case the scaling\nschedule runs once. The schedule is interpreted with respect to\ntime_zone. This field is required. Note: These timestamps only describe\nwhen autoscaler starts providing the scaling signal. The VMs\nneed additional time to become serving.", + "type": "string" + }, + "timeZone": { + "description": "The time zone to use when interpreting the schedule.\nThe value of this field must be a time zone name from the tz database:\nhttps://en.wikipedia.org/wiki/Tz_database. This field is assigned a\ndefault value of \"UTC\" if left empty.", + "type": "string" + } + }, + "type": "object" + }, + "Backend": { + "description": "Message containing information of one individual backend.", + "id": "Backend", + "properties": { + "balancingMode": { + "description": "Specifies how to determine whether the backend of a load balancer can\nhandle additional traffic or is fully loaded. For usage guidelines, see\nConnection balancing mode.\n\nBackends must use compatible balancing modes. Backends of a backend\nservice may use different balancing modes. For more information, see \nSupported balancing modes and target capacity settings and\nRestrictions and guidance for instance groups.\n\nNote: Currently, if you use the API to configure incompatible balancing\nmodes, the configuration might be accepted even though it has no impact\nand is ignored. Specifically, Backend.maxUtilization is ignored when\nBackend.balancingMode is RATE. In the future, this incompatible combination\nwill be rejected.", + "enum": [ + "CONNECTION", + "CUSTOM_METRICS", + "IN_FLIGHT", + "RATE", + "UTILIZATION" ], - "response": { - "$ref": "Firewall" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "Balance based on the number of simultaneous connections.", + "Based on custom defined and reported metrics.", + "Balance based on the number of in-flight requests.", + "Balance based on requests per second (RPS).", + "Balance based on the backend utilization." ], - "description": "Returns the specified firewall." + "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" - } + "capacityScaler": { + "description": "A multiplier applied to the backend's target capacity of its balancing\nmode.\nThe default value is 1, which means the group serves up to\n100% of its configured capacity (depending onbalancingMode). A setting of 0 means the group is\ncompletely drained, offering 0% of its available capacity. The valid ranges\nare 0.0 and [0.1,1.0].\nYou cannot configure a setting larger than 0 and smaller than0.1.\nYou cannot configure a setting of 0 when there is only one\nbackend attached to the backend service.\n\nNot available with backends that don't support using abalancingMode. This includes backends such as global\ninternet NEGs, regional serverless NEGs, and PSC NEGs.", + "format": "float", + "type": "number" + }, + "customMetrics": { + "description": "List of custom metrics that are used for CUSTOM_METRICS\nBalancingMode.", + "items": { + "$ref": "BackendCustomMetric" }, - "parameterOrder": [ - "project" + "type": "array" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you\ncreate the resource.", + "type": "string" + }, + "failover": { + "description": "This field designates whether this is a failover backend. More than one\nfailover backend can be configured for a given BackendService.\n\nThis field can only be used for a regional external Passthrough Network\nLoad Balancer or a regional internal Passthrough Network Load Balancer.", + "type": "boolean" + }, + "group": { + "description": "The fully-qualified URL of aninstance\ngroup or network endpoint\ngroup (NEG) resource. To determine what types of backends a load\nbalancer supports, see the [Backend services\noverview](https://cloud.google.com/load-balancing/docs/backend-service#backends).\n\nYou must use the *fully-qualified* URL (starting withhttps://www.googleapis.com/) to specify the instance group\nor NEG. Partial URLs are not supported.\n\nIf haPolicy is specified, backends must refer to NEG resources of type\nGCE_VM_IP.", + "type": "string" + }, + "maxConnections": { + "description": "Defines a target maximum number of simultaneous connections. For usage\nguidelines, seeConnection\nbalancing mode and Utilization\nbalancing mode. Not available if the backend'sbalancingMode is RATE.", + "format": "int32", + "type": "integer" + }, + "maxConnectionsPerEndpoint": { + "description": "Defines a target maximum number of simultaneous connections. For usage\nguidelines, seeConnection\nbalancing mode and Utilization\nbalancing mode.\n\nNot available if the backend's balancingMode isRATE.", + "format": "int32", + "type": "integer" + }, + "maxConnectionsPerInstance": { + "description": "Defines a target maximum number of simultaneous connections.\nFor usage guidelines, seeConnection\nbalancing mode and Utilization\nbalancing mode.\n\nNot available if the backend's balancingMode isRATE.", + "format": "int32", + "type": "integer" + }, + "maxInFlightRequests": { + "description": "Defines a maximum number of in-flight requests for the whole NEG or\ninstance group. Not available if backend's balancingMode isRATE or CONNECTION.", + "format": "int32", + "type": "integer" + }, + "maxInFlightRequestsPerEndpoint": { + "description": "Defines a maximum number of in-flight requests for a single endpoint.\nNot available if backend's balancingMode is RATE\nor CONNECTION.", + "format": "int32", + "type": "integer" + }, + "maxInFlightRequestsPerInstance": { + "description": "Defines a maximum number of in-flight requests for a single VM.\nNot available if backend's balancingMode is RATE\nor CONNECTION.", + "format": "int32", + "type": "integer" + }, + "maxRate": { + "description": "Defines a maximum number of HTTP requests per second (RPS). For\nusage guidelines, seeRate\nbalancing mode and Utilization\nbalancing mode.\n\nNot available if the backend's balancingMode isCONNECTION.", + "format": "int32", + "type": "integer" + }, + "maxRatePerEndpoint": { + "description": "Defines a maximum target for requests per second (RPS). For usage\nguidelines, seeRate\nbalancing mode and Utilization\nbalancing mode.\n\nNot available if the backend's balancingMode isCONNECTION.", + "format": "float", + "type": "number" + }, + "maxRatePerInstance": { + "description": "Defines a maximum target for requests per second (RPS). For usage\nguidelines, seeRate\nbalancing mode and Utilization\nbalancing mode.\n\nNot available if the backend's balancingMode isCONNECTION.", + "format": "float", + "type": "number" + }, + "maxUtilization": { + "description": "Optional parameter to define a target capacity for theUTILIZATION balancing mode. The valid range is[0.0, 1.0].\n\nFor usage guidelines, seeUtilization\nbalancing mode.", + "format": "float", + "type": "number" + }, + "orchestrationInfo": { + "$ref": "BackendBackendOrchestrationInfo", + "description": "Information about the resource or system that manages the backend." + }, + "preference": { + "description": "This field indicates whether this backend should be fully utilized before\nsending traffic to backends with default preference. The possible values\nare:\n \n - PREFERRED: Backends with this preference level will be\n filled up to their capacity limits first, based on RTT.\n - DEFAULT: If preferred backends don't have enough\n capacity, backends in this layer would be used and traffic would be\n assigned based on the load balancing algorithm you use. This is the\n default\n\n\n\nFor global external Passthrough Network Load Balancers, the following\nrestrictions apply:\n \n - At most one backend can be marked as PREFERRED.\n - PREFERRED and DEFAULT backends cannot reside\n in the same Cloud region.", + "enum": [ + "DEFAULT", + "PREFERENCE_UNSPECIFIED", + "PREFERRED" ], - "request": { - "$ref": "Firewall" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "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 firewall rule in the specified project using the data included in the request." + "type": "string" }, - "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" + "trafficDuration": { + "enum": [ + "LONG", + "SHORT", + "TRAFFIC_DURATION_UNSPECIFIED" ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "Most of the requests are expected to take more than multiple seconds to\nfinish.", + "Most requests are expected to finish with a sub-second latency.", + "Traffic duration is unspecified." ], - "description": "Deletes the specified firewall." + "type": "string" + } + }, + "type": "object" + }, + "BackendBackendOrchestrationInfo": { + "description": "A message containing information about the resource or system that manages\nthe backend.", + "id": "BackendBackendOrchestrationInfo", + "properties": { + "resourceUri": { + "description": "The URI of the resource or system that manages the backend.", + "type": "string" + } + }, + "type": "object" + }, + "BackendBucket": { + "description": "Represents a Cloud Storage Bucket resource.\n\nThis Cloud Storage bucket resource is referenced by a URL map of a load\nbalancer. For more information, readBackend Buckets.", + "id": "BackendBucket", + "properties": { + "bucketName": { + "description": "Cloud Storage bucket name.", + "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" + "cdnPolicy": { + "$ref": "BackendBucketCdnPolicy", + "description": "Cloud CDN configuration for this BackendBucket." + }, + "compressionMode": { + "description": "Compress text responses using Brotli or gzip compression, based on\nthe client's Accept-Encoding header.", + "enum": [ + "AUTOMATIC", + "DISABLED" ], - "request": { - "$ref": "Firewall" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "Automatically uses the best compression based on the Accept-Encoding\nheader sent by the client.", + "Disables compression. Existing compressed responses cached by\nCloud CDN will not be served to clients." ], - "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." + "type": "string" }, - "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" - } + "creationTimestamp": { + "description": "[Output Only] Creation timestamp inRFC3339\ntext format.", + "type": "string" + }, + "customResponseHeaders": { + "description": "Headers that the Application Load Balancer should add to proxied responses.", + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "firewall" + "type": "array" + }, + "description": { + "description": "An optional textual description of the resource; provided by the client\nwhen the resource is created.", + "type": "string" + }, + "edgeSecurityPolicy": { + "description": "[Output Only] The resource URL for the edge security policy associated with\nthis backend bucket.", + "type": "string" + }, + "enableCdn": { + "description": "If true, enable Cloud CDN for this BackendBucket.", + "type": "boolean" + }, + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "format": "uint64", + "type": "string" + }, + "kind": { + "default": "compute#backendBucket", + "description": "Output only. Type of the resource.", + "readOnly": true, + "type": "string" + }, + "loadBalancingScheme": { + "description": "The value can only be INTERNAL_MANAGED for cross-region internal layer 7\nload balancer.\n\nIf loadBalancingScheme is not specified, the backend bucket can be used by\nclassic global external load balancers, or global application external load\nbalancers, or both.", + "enum": [ + "EXTERNAL_MANAGED", + "INTERNAL_MANAGED" ], - "request": { - "$ref": "Firewall" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "Signifies that this will be used for regional external Application Load\nBalancers.", + "Signifies that this will be used for internal Application Load Balancers." ], - "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." + "type": "string" + }, + "name": { + "description": "Name of the resource. Provided by the client when the resource is created.\nThe name must be 1-63 characters long, and comply withRFC1035.\nSpecifically, the name must be 1-63 characters long and match the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first\ncharacter must be a lowercase letter, and all following characters must\nbe a dash, lowercase letter, or digit, except the last character, which\ncannot be a dash.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "params": { + "$ref": "BackendBucketParams", + "description": "Input only. [Input Only] Additional params passed with the request, but not persisted\nas part of resource payload." + }, + "region": { + "description": "Output only. [Output Only] URL of the region where the regional backend bucket\nresides. This field is not applicable to global backend buckets.\nYou must specify this field as part of the HTTP request URL. It is\nnot settable as a field in the request body.", + "readOnly": true, + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" + }, + "usedBy": { + "description": "Output only. [Output Only] List of resources referencing that backend bucket.", + "items": { + "$ref": "BackendBucketUsedBy" + }, + "readOnly": true, + "type": "array" } - } + }, + "type": "object" }, - "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", + "BackendBucketAggregatedList": { + "id": "BackendBucketAggregatedList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "additionalProperties": { + "$ref": "BackendBucketsScopedList", + "description": "Name of the scope containing this set of BackendBuckets." + }, + "description": "A list of BackendBucketsScopedList resources.", + "type": "object" + }, + "kind": { + "default": "compute#backendBucketAggregatedList", + "description": "Output only. Type of resource.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "pageToken": { - "description": "Specifies a page token 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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" } }, - "response": { - "$ref": "FirewallPolicyList" + "type": "object" + } + }, + "type": "object" + }, + "BackendBucketCdnPolicy": { + "description": "Message containing Cloud CDN configuration for a backend bucket.", + "id": "BackendBucketCdnPolicy", + "properties": { + "bypassCacheOnRequestHeaders": { + "description": "Bypass the cache when the specified request headers are matched - e.g.\nPragma or Authorization headers. Up to 5 headers can be specified.\nThe cache is bypassed for all cdnPolicy.cacheMode settings.", + "items": { + "$ref": "BackendBucketCdnPolicyBypassCacheOnRequestHeader" }, - "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": "array" }, - "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" + "cacheKeyPolicy": { + "$ref": "BackendBucketCdnPolicyCacheKeyPolicy", + "description": "The CacheKeyPolicy for this CdnPolicy." + }, + "cacheMode": { + "description": "Specifies the cache setting for all responses from this backend.\nThe possible values are:\nUSE_ORIGIN_HEADERS Requires the origin to set valid caching\nheaders to cache content. Responses without these headers will not be\ncached at Google's edge, and will require a full trip to the origin on\nevery request, potentially impacting performance and increasing load on\nthe origin server.\nFORCE_CACHE_ALL Cache all content, ignoring any \"private\",\n\"no-store\" or \"no-cache\" directives in Cache-Control response headers.\nWarning: this may result in Cloud CDN caching private,\nper-user (user identifiable) content.\nCACHE_ALL_STATIC Automatically cache static content,\nincluding common image formats, media (video and audio), and web assets\n(JavaScript and CSS). Requests and responses that are marked as\nuncacheable, as well as dynamic content (including HTML), will not be\ncached.\n\nIf no value is provided for cdnPolicy.cacheMode, it defaults\nto CACHE_ALL_STATIC.", + "enum": [ + "CACHE_ALL_STATIC", + "FORCE_CACHE_ALL", + "INVALID_CACHE_MODE", + "USE_ORIGIN_HEADERS" ], - "response": { - "$ref": "FirewallPolicy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "Automatically cache static content, including common image formats,\nmedia (video and audio), and web assets (JavaScript and CSS).\nRequests and responses that are marked as uncacheable, as well as\ndynamic content (including HTML), will not be cached.", + "Cache all content, ignoring any \"private\", \"no-store\" or \"no-cache\"\ndirectives in Cache-Control response headers.\nWarning: this may result in Cloud CDN caching private,\nper-user (user identifiable) content.", + "", + "Requires the origin to set valid caching headers to cache content.\nResponses without these headers will not be cached at Google's edge,\nand will require a full trip to the origin on every request,\npotentially impacting performance and increasing load on the\norigin server." ], - "description": "Returns the specified firewall policy." + "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" - } + "clientTtl": { + "description": "Specifies a separate client (e.g. browser client) maximum TTL. This is\nused to clamp the max-age (or Expires) value sent to the client. With\nFORCE_CACHE_ALL, the lesser of client_ttl and default_ttl is used for the\nresponse max-age directive, along with a \"public\" directive. For\ncacheable content in CACHE_ALL_STATIC mode, client_ttl clamps the max-age\nfrom the origin (if specified), or else sets the response max-age\ndirective to the lesser of the client_ttl and default_ttl, and also\nensures a \"public\" cache-control directive is present.\nIf a client TTL is not specified, a default value (1 hour) will be used.\nThe maximum allowed value is 31,622,400s (1 year).", + "format": "int32", + "type": "integer" + }, + "defaultTtl": { + "description": "Specifies the default TTL for cached content served by this origin for\nresponses that do not have an existing valid TTL (max-age or s-maxage).\nSetting a TTL of \"0\" means \"always revalidate\".\nThe value of defaultTTL cannot be set to a value greater than that of\nmaxTTL, but can be equal.\nWhen the cacheMode is set to FORCE_CACHE_ALL, the defaultTTL\nwill overwrite the TTL set in all responses. The maximum allowed value is\n31,622,400s (1 year), noting that infrequently accessed objects may be\nevicted from the cache before the defined TTL.", + "format": "int32", + "type": "integer" + }, + "maxTtl": { + "description": "Specifies the maximum allowed TTL for cached content served by this\norigin.\nCache directives that attempt to set a max-age or s-maxage higher than\nthis, or an Expires header more than maxTTL seconds in the future will\nbe capped at the value of maxTTL, as if it were the value of an\ns-maxage Cache-Control directive.\nHeaders sent to the client will not be modified.\nSetting a TTL of \"0\" means \"always revalidate\".\nThe maximum allowed value is 31,622,400s (1 year), noting that\ninfrequently accessed objects may be evicted from the cache before\nthe defined TTL.", + "format": "int32", + "type": "integer" + }, + "negativeCaching": { + "description": "Negative caching allows per-status code TTLs to be set, in order\nto apply fine-grained caching for common errors or redirects.\nThis can reduce the load on your origin and improve end-user\nexperience by reducing response latency.\nWhen the cache mode is set to CACHE_ALL_STATIC or USE_ORIGIN_HEADERS,\nnegative caching applies to responses with the specified response code\nthat lack any Cache-Control, Expires, or Pragma: no-cache directives.\nWhen the cache mode is set to FORCE_CACHE_ALL, negative caching applies\nto all responses with the specified response code, and override any\ncaching headers.\nBy default, Cloud CDN will apply the following default TTLs to these\nstatus codes:\nHTTP 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m\nHTTP 404 (Not Found), 410 (Gone),\n451 (Unavailable For Legal Reasons): 120s\nHTTP 405 (Method Not Found), 501 (Not Implemented): 60s.\nThese defaults can be overridden in negative_caching_policy.", + "type": "boolean" + }, + "negativeCachingPolicy": { + "description": "Sets a cache TTL for the specified HTTP status code.\nnegative_caching must be enabled to configure negative_caching_policy.\nOmitting the policy and leaving negative_caching enabled will use\nCloud CDN's default cache TTLs.\nNote that when specifying an explicit negative_caching_policy, you\nshould take care to specify a cache TTL for all response codes\nthat you wish to cache. Cloud CDN will not apply any default\nnegative caching when a policy exists.", + "items": { + "$ref": "BackendBucketCdnPolicyNegativeCachingPolicy" }, - "request": { - "$ref": "FirewallPolicy" + "type": "array" + }, + "requestCoalescing": { + "description": "If true then Cloud CDN will combine multiple concurrent cache fill\nrequests into a small number of requests to the origin.", + "type": "boolean" + }, + "serveWhileStale": { + "description": "Serve existing content from the cache (if available) when revalidating\ncontent with the origin, or when an error is encountered when refreshing\nthe cache.\nThis setting defines the default \"max-stale\" duration for any cached\nresponses that do not specify a max-stale directive. Stale responses that\nexceed the TTL configured here will not be served. The default limit\n(max-stale) is 86400s (1 day), which will allow stale content to be\nserved up to this limit beyond the max-age (or s-maxage) of a cached\nresponse.\nThe maximum allowed value is 604800 (1 week).\nSet this to zero (0) to disable serve-while-stale.", + "format": "int32", + "type": "integer" + }, + "signedUrlCacheMaxAgeSec": { + "description": "Maximum number of seconds the response to a signed URL request will be\nconsidered fresh. After this time period, the response will be\nrevalidated before being served. Defaults to 1hr (3600s). When serving\nresponses to signed URL requests, Cloud CDN will internally behave as\nthough all responses from this backend had a \"Cache-Control:\npublic, max-age=[TTL]\" header, regardless of any existing\nCache-Control header. The actual headers served in responses will not be\naltered.", + "format": "int64", + "type": "string" + }, + "signedUrlKeyNames": { + "description": "[Output Only] Names of the keys for signing request URLs.", + "items": { + "type": "string" }, - "response": { - "$ref": "Operation" + "type": "array" + } + }, + "type": "object" + }, + "BackendBucketCdnPolicyBypassCacheOnRequestHeader": { + "description": "Bypass the cache when the specified request headers are present,\ne.g. Pragma or Authorization headers. Values are case insensitive.\nThe presence of such a header overrides the cache_mode setting.", + "id": "BackendBucketCdnPolicyBypassCacheOnRequestHeader", + "properties": { + "headerName": { + "description": "The header field name to match on when bypassing cache.\nValues are case-insensitive.", + "type": "string" + } + }, + "type": "object" + }, + "BackendBucketCdnPolicyCacheKeyPolicy": { + "description": "Message containing what to include in the cache key for a request for\nCloud CDN.", + "id": "BackendBucketCdnPolicyCacheKeyPolicy", + "properties": { + "includeHttpHeaders": { + "description": "Allows HTTP request headers (by name) to be used in the cache key.", + "items": { + "type": "string" }, - "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." + "type": "array" }, - "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" - } + "queryStringWhitelist": { + "description": "Names of query string parameters to include in cache keys. Default\nparameters are always included. '&' and '=' will be percent encoded\nand not treated as delimiters.", + "items": { + "type": "string" }, - "parameterOrder": [ - "firewallPolicy" - ], - "response": { - "$ref": "Operation" + "type": "array" + } + }, + "type": "object" + }, + "BackendBucketCdnPolicyNegativeCachingPolicy": { + "description": "Specify CDN TTLs for response error codes.", + "id": "BackendBucketCdnPolicyNegativeCachingPolicy", + "properties": { + "code": { + "description": "The HTTP status code to define a TTL against. Only HTTP status codes\n300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be\nspecified as values, and you cannot specify a status code more than\nonce.", + "format": "int32", + "type": "integer" + }, + "ttl": { + "description": "The TTL (in seconds) for which to cache responses with the\ncorresponding status code.\nThe maximum allowed value is 1800s (30 minutes), noting that\ninfrequently accessed objects may be evicted from the cache before the\ndefined TTL.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, + "BackendBucketList": { + "description": "Contains a list of BackendBucket resources.", + "id": "BackendBucketList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of BackendBucket resources.", + "items": { + "$ref": "BackendBucket" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified policy." + "type": "array" }, - "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, + "kind": { + "default": "compute#backendBucketList", + "description": "Output only. Type of resource.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", + "data": { + "description": "[Output Only] Metadata about this warning in key:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" + }, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "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." + "type": "object" + } + }, + "type": "object" + }, + "BackendBucketListUsable": { + "id": "BackendBucketListUsable", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "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" + "items": { + "description": "A list of BackendBucket resources.", + "items": { + "$ref": "BackendBucket" }, - "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." + "type": "array" }, - "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." + "kind": { + "default": "compute#usableBackendBucketList", + "description": "Output only. [Output Only] Type of resource. Alwayscompute#usableBackendBucketList for lists of usable backend\nbuckets.", + "readOnly": true, + "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" - ], - "description": "Deletes a rule of the specified priority." + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "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, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "priority": { - "description": "The priority of the rule to patch.", - "location": "query", - "type": "integer", - "format": "int32" + "data": { + "description": "[Output Only] Metadata about this warning in key:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. 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" } }, - "parameterOrder": [ - "firewallPolicy" - ], - "request": { - "$ref": "FirewallPolicyRule" + "type": "object" + } + }, + "type": "object" + }, + "BackendBucketParams": { + "description": "Additional Backend Bucket parameters.", + "id": "BackendBucketParams", + "properties": { + "resourceManagerTags": { + "additionalProperties": { + "type": "string" }, - "response": { - "$ref": "Operation" + "description": "Tag keys/values directly bound to this resource.\nTag keys and values have the same definition as resource\nmanager tags. The field is allowed for INSERT\nonly. The keys/values to set on the resource should be specified in\neither ID { : } or Namespaced format\n{ : }.\nFor example the following are valid inputs:\n* {\"tagKeys/333\" : \"tagValues/444\", \"tagKeys/123\" : \"tagValues/456\"}\n* {\"123/environment\" : \"production\", \"345/abc\" : \"xyz\"}\nNote:\n* Invalid combinations of ID & namespaced format is not supported. For\n instance: {\"123/environment\" : \"tagValues/444\"} is invalid.", + "type": "object" + } + }, + "type": "object" + }, + "BackendBucketUsedBy": { + "id": "BackendBucketUsedBy", + "properties": { + "reference": { + "description": "Output only. [Output Only] Server-defined URL for UrlMaps referencing that\nBackendBucket.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "BackendBucketsScopedList": { + "id": "BackendBucketsScopedList", + "properties": { + "backendBuckets": { + "description": "A list of BackendBuckets contained in this scope.", + "items": { + "$ref": "BackendBucket" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Patches a rule of the specified priority." + "type": "array" }, - "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, + "warning": { + "description": "Informational warning which replaces the list of\nbackend services when the list is empty.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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" + "data": { + "description": "[Output Only] Metadata about this warning in key:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. 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" } }, - "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." + "type": "object" + } + }, + "type": "object" + }, + "BackendCustomMetric": { + "description": "Custom Metrics are used for CUSTOM_METRICS balancing_mode.", + "id": "BackendCustomMetric", + "properties": { + "dryRun": { + "description": "If true, the metric data is collected and reported to Cloud\nMonitoring, but is not used for load balancing.", + "type": "boolean" }, - "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" - } + "maxUtilization": { + "description": "Optional parameter to define a target utilization for the Custom Metrics\nbalancing mode. The valid range is [0.0, 1.0].", + "format": "float", + "type": "number" + }, + "name": { + "description": "Name of a custom utilization signal. The name must be 1-64 characters\nlong and match the regular expression\n`[a-z]([-_.a-z0-9]*[a-z0-9])?` which means that the\nfirst character must be a lowercase letter, and all following\ncharacters must be a dash, period, underscore, lowercase letter, or\ndigit, except the last character, which cannot be a dash, period, or\nunderscore. For usage guidelines, see Custom Metrics balancing mode. This\nfield can only be used for a global or regional backend service with the\nloadBalancingScheme set to EXTERNAL_MANAGED,INTERNAL_MANAGED INTERNAL_SELF_MANAGED.", + "type": "string" + } + }, + "type": "object" + }, + "BackendService": { + "description": "Represents a Backend Service resource.\n\nA backend service defines how Google Cloud load balancers distribute traffic.\nThe backend service configuration contains a set of values, such as the\nprotocol used to connect to backends, various distribution and session\nsettings, health checks, and timeouts. These settings provide fine-grained\ncontrol over how your load balancer behaves. Most of the settings have\ndefault values that allow for easy configuration if you need to get started\nquickly.\n\nBackend services in Google Compute Engine can be either regionally or\nglobally scoped.\n\n* [Global](https://cloud.google.com/compute/docs/reference/rest/v1/backendServices)\n* [Regional](https://cloud.google.com/compute/docs/reference/rest/v1/regionBackendServices)\n\nFor more information, seeBackend\nServices.", + "id": "BackendService", + "properties": { + "affinityCookieTtlSec": { + "description": "Lifetime of cookies in seconds. This setting is applicable to Application\nLoad Balancers and Traffic Director and requires\nGENERATED_COOKIE or HTTP_COOKIE session affinity.\n\nIf set to 0, the cookie is non-persistent and lasts only until\nthe end of the browser session (or equivalent). The maximum allowed value\nis two weeks (1,209,600).\n\nNot supported when the backend service is referenced by a URL map that is\nbound to target gRPC proxy that has validateForProxyless field set to true.", + "format": "int32", + "type": "integer" + }, + "backends": { + "description": "The list of backends that serve this BackendService.", + "items": { + "$ref": "Backend" }, - "parameterOrder": [ - "firewallPolicy" + "type": "array" + }, + "cdnPolicy": { + "$ref": "BackendServiceCdnPolicy", + "description": "Cloud CDN configuration for this BackendService. Only available for\nspecified load balancer types." + }, + "circuitBreakers": { + "$ref": "CircuitBreakers" + }, + "compressionMode": { + "description": "Compress text responses using Brotli or gzip compression, based on\nthe client's Accept-Encoding header.", + "enum": [ + "AUTOMATIC", + "DISABLED" ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "Automatically uses the best compression based on the Accept-Encoding\nheader sent by the client.", + "Disables compression. Existing compressed responses cached by\nCloud CDN will not be served to clients." ], - "description": "Removes an association for the specified firewall policy." + "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" + "connectionDraining": { + "$ref": "ConnectionDraining", + "description": "connectionDraining cannot be specified with haPolicy." + }, + "connectionTrackingPolicy": { + "$ref": "BackendServiceConnectionTrackingPolicy", + "description": "Connection Tracking configuration for this BackendService. Connection\ntracking policy settings are only available for external passthrough\nNetwork Load Balancers and internal passthrough Network Load Balancers.\n\nconnectionTrackingPolicy cannot be specified with haPolicy." + }, + "consistentHash": { + "$ref": "ConsistentHashLoadBalancerSettings", + "description": "Consistent Hash-based load balancing can be used to provide soft session\naffinity based on HTTP headers, cookies or other properties. This load\nbalancing policy is applicable only for HTTP connections. The affinity to a\nparticular destination host will be lost when one or more hosts are\nadded/removed from the destination service. This field specifies parameters\nthat control consistent hashing. This field is only applicable whenlocalityLbPolicy is set to MAGLEV orRING_HASH.\n\nThis field is applicable to either:\n \n - A regional backend service with the service protocol set to HTTP,\n HTTPS, HTTP2 or H2C, and load_balancing_scheme set to\n INTERNAL_MANAGED. \n - A global backend service with the\n load_balancing_scheme set to INTERNAL_SELF_MANAGED." + }, + "creationTimestamp": { + "description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", + "readOnly": true, + "type": "string" + }, + "customMetrics": { + "description": "List of custom metrics that are used for theWEIGHTED_ROUND_ROBIN locality_lb_policy.", + "items": { + "$ref": "BackendServiceCustomMetric" }, - "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." + "type": "array" + }, + "customRequestHeaders": { + "description": "Headers that the load balancer adds to proxied requests. See [Creating\ncustom\nheaders](https://cloud.google.com/load-balancing/docs/custom-headers).", + "items": { + "type": "string" + }, + "type": "array" }, - "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" - } + "customResponseHeaders": { + "description": "Headers that the load balancer adds to proxied responses. See [Creating\ncustom\nheaders](https://cloud.google.com/load-balancing/docs/custom-headers).", + "items": { + "type": "string" }, - "parameterOrder": [ - "firewallPolicy" + "type": "array" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you\ncreate the resource.", + "type": "string" + }, + "edgeSecurityPolicy": { + "description": "[Output Only] The resource URL for the edge security policy associated with\nthis backend service.", + "type": "string" + }, + "enableCDN": { + "description": "If true, enables Cloud CDN for the backend service of a\nglobal external Application Load Balancer.", + "type": "boolean" + }, + "externalManagedMigrationState": { + "description": "Specifies the canary migration state. Possible values are PREPARE,\nTEST_BY_PERCENTAGE, and TEST_ALL_TRAFFIC.\n\nTo begin the migration from EXTERNAL to EXTERNAL_MANAGED, the state must be\nchanged to PREPARE. The state must be changed to TEST_ALL_TRAFFIC before\nthe loadBalancingScheme can be changed to EXTERNAL_MANAGED. Optionally, the\nTEST_BY_PERCENTAGE state can be used to migrate traffic by percentage using\nexternalManagedMigrationTestingPercentage.\n\nRolling back a migration requires the states to be set in reverse order. So\nchanging the scheme from EXTERNAL_MANAGED to EXTERNAL requires the state to\nbe set to TEST_ALL_TRAFFIC at the same time. Optionally, the\nTEST_BY_PERCENTAGE state can be used to migrate some traffic back to\nEXTERNAL or PREPARE can be used to migrate all traffic back to EXTERNAL.", + "enum": [ + "PREPARE", + "TEST_ALL_TRAFFIC", + "TEST_BY_PERCENTAGE" ], - "response": { - "$ref": "FirewallPolicyAssociation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "", + "", + "" ], - "description": "Gets an association with the specified name." + "type": "string" }, - "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" - } + "externalManagedMigrationTestingPercentage": { + "description": "Determines the fraction of requests that should be processed by the Global\nexternal Application Load Balancer.\n\nThe value of this field must be in the range [0, 100].\n\nSession affinity options will slightly affect this routing behavior, for\nmore details, see:Session\nAffinity.\n\nThis value can only be set if the loadBalancingScheme in the BackendService\nis set to EXTERNAL (when using the classic Application Load Balancer) and\nthe migration state is TEST_BY_PERCENTAGE.", + "format": "float", + "type": "number" + }, + "failoverPolicy": { + "$ref": "BackendServiceFailoverPolicy", + "description": "Requires at least one backend instance group to be defined\nas a backup (failover) backend.\nFor load balancers that have configurable failover:\n[Internal passthrough Network Load\nBalancers](https://cloud.google.com/load-balancing/docs/internal/failover-overview)\nand [external passthrough Network Load\nBalancers](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview).\nfailoverPolicy cannot be specified with haPolicy.failoverPolicy cannot be used by global external Passthrough\nNetwork Load Balancers." + }, + "fingerprint": { + "description": "Fingerprint of this resource. A hash of the contents stored in this object.\nThis field is used in optimistic locking. This field will be ignored when\ninserting a BackendService. An up-to-date fingerprint must be provided in\norder to update the BackendService, otherwise the request will\nfail with error 412 conditionNotMet.\n\nTo see the latest fingerprint, make a get() request to\nretrieve a BackendService.", + "format": "byte", + "type": "string" + }, + "haPolicy": { + "$ref": "BackendServiceHAPolicy", + "description": "Configures self-managed High Availability (HA) for External and Internal\nProtocol Forwarding.\n\nThe backends of this regional backend service must only specify zonal\nnetwork endpoint groups (NEGs) of type GCE_VM_IP.\n\nWhen haPolicy is set for an Internal Passthrough Network Load Balancer, the\nregional backend service must set the network field. All zonal NEGs must\nbelong to the same network. However, individual NEGs can\nbelong to different subnetworks of that network.\n\nWhen haPolicy is specified, the set of attached network endpoints across\nall backends comprise an High Availability domain from which one endpoint\nis selected as the active endpoint (the leader) that receives all\ntraffic.\n\nhaPolicy can be added only at backend service creation time. Once set up,\nit cannot be deleted.\n\nNote that haPolicy is not for load balancing, and therefore cannot be\nspecified with sessionAffinity, connectionTrackingPolicy, and\nfailoverPolicy.\n\nhaPolicy requires customers to be responsible for tracking backend\nendpoint health and electing a leader among the healthy endpoints.\nTherefore, haPolicy cannot be specified with healthChecks.\nhaPolicy can only be specified for External Passthrough\nNetwork Load Balancers and Internal Passthrough Network Load Balancers.haPolicy cannot be used by global external Passthrough Network\nLoad Balancers." + }, + "healthChecks": { + "description": "The list of URLs to the healthChecks, httpHealthChecks (legacy), or\nhttpsHealthChecks (legacy) resource for health checking this backend\nservice. Not all backend services support legacy health checks. See\nLoad balancer guide. Currently, at most one health check can be\nspecified for each backend service. Backend services with\ninstance group or zonal NEG backends must have a health check unless\nhaPolicy is specified. Backend services with internet or serverless NEG\nbackends must not have a health check.\n\nhealthChecks[] cannot be specified with haPolicy.", + "items": { + "type": "string" }, - "parameterOrder": [ - "firewallPolicy" + "type": "array" + }, + "iap": { + "$ref": "BackendServiceIAP", + "description": "The configurations for Identity-Aware Proxy on this resource.\nNot available for internal passthrough Network Load Balancers and external\npassthrough Network Load Balancers." + }, + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "format": "uint64", + "type": "string" + }, + "ipAddressSelectionPolicy": { + "description": "Specifies a preference for traffic sent from the proxy to the backend (or\nfrom the client to the backend for proxyless gRPC).\nThe possible values are:\n \n - IPV4_ONLY: Only send IPv4 traffic to the backends of the\n backend service (Instance Group, Managed Instance Group, Network Endpoint\n Group), regardless of traffic from the client to the proxy. Only IPv4\n health checks are used to check the health of the backends. This is the\n default setting.\n - PREFER_IPV6: Prioritize the connection to the endpoint's\n IPv6 address over its IPv4 address (provided there is a healthy IPv6\n address).\n - IPV6_ONLY: Only send IPv6 traffic to the backends of the\n backend service (Instance Group, Managed Instance Group, Network Endpoint\n Group), regardless of traffic from the client to the proxy. Only IPv6\n health checks are used to check the health of the backends.\n\n\n\nThis field is applicable to either:\n \n - Advanced global external Application Load Balancer (load balancing\n scheme EXTERNAL_MANAGED), \n - Regional external Application Load\n Balancer, \n - Internal proxy Network Load Balancer (load balancing\n scheme INTERNAL_MANAGED), \n - Regional internal Application Load\n Balancer (load balancing scheme INTERNAL_MANAGED), \n - Traffic\n Director with Envoy proxies and proxyless gRPC (load balancing scheme\n INTERNAL_SELF_MANAGED).", + "enum": [ + "IPV4_ONLY", + "IPV6_ONLY", + "IP_ADDRESS_SELECTION_POLICY_UNSPECIFIED", + "PREFER_IPV6" ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "Only send IPv4 traffic to the backends of the Backend Service\n(Instance Group, Managed Instance Group, Network Endpoint Group)\nregardless of traffic from the client to the proxy.\nOnly IPv4 health-checks are used to check the health of the backends.\nThis is the default setting.", + "Only send IPv6 traffic to the backends of the Backend Service\n(Instance Group, Managed Instance Group, Network Endpoint Group)\nregardless of traffic from the client to the proxy. Only IPv6\nhealth-checks are used to check the health of the backends.", + "Unspecified IP address selection policy.", + "Prioritize the connection to the endpoints IPv6 address\nover its IPv4 address (provided there is a healthy IPv6 address)." ], - "description": "Copies rules to the specified firewall policy." + "type": "string" }, - "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" + "kind": { + "default": "compute#backendService", + "description": "Output only. [Output Only] Type of resource. Always compute#backendService\nfor backend services.", + "readOnly": true, + "type": "string" + }, + "loadBalancingScheme": { + "description": "Specifies the load balancer type. A backend service\ncreated for one type of load balancer cannot be used with another.\nFor more information, refer to\nBackend services product and scheme table.", + "enum": [ + "EXTERNAL", + "EXTERNAL_MANAGED", + "INTERNAL", + "INTERNAL_MANAGED", + "INTERNAL_SELF_MANAGED", + "INVALID_LOAD_BALANCING_SCHEME" ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "Signifies that this will be used for classic Application Load Balancers,\nglobal external proxy Network Load Balancers,\nor external passthrough Network Load Balancers.", + "Signifies that this will be used for global external Application Load\nBalancers, regional external Application Load Balancers, or regional\nexternal proxy Network Load Balancers.", + "Signifies that this will be used for internal passthrough Network Load\nBalancers.", + "Signifies that this will be used for internal Application Load Balancers.", + "Signifies that this will be used by Traffic Director.", + "" ], - "description": "Moves the specified firewall policy." + "type": "string" }, - "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" - } + "localityLbPolicies": { + "description": "A list of locality load-balancing policies to be used in order of\npreference. When you use localityLbPolicies, you must set at least one\nvalue for either the localityLbPolicies[].policy or the\nlocalityLbPolicies[].customPolicy field. localityLbPolicies overrides any\nvalue set in the localityLbPolicy field.\n\nFor an example of how to use this field, seeDefine\na list of preferred policies.\n\nCaution: This field and its children are intended for use in a service mesh\nthat includes gRPC clients only. Envoy proxies can't use backend services\nthat have this configuration.", + "items": { + "$ref": "BackendServiceLocalityLoadBalancingPolicyConfig" }, - "parameterOrder": [ - "resource" + "type": "array" + }, + "localityLbPolicy": { + "description": "The load balancing algorithm used within the scope of the locality. The\npossible values are:\n \n - ROUND_ROBIN: This is a simple policy in which each healthy\n backend is selected in round robin order. This is the default.\n - LEAST_REQUEST: An O(1) algorithm which\n selects two random healthy hosts and picks the host which has fewer active\n requests.\n - RING_HASH: The ring/modulo hash load balancer implements\n consistent hashing to backends. The algorithm has the property that the\n addition/removal of a host from a set of N hosts only affects 1/N of the\n requests.\n - RANDOM: The load balancer selects a random healthy\n host.\n - ORIGINAL_DESTINATION: Backend host is selected\n based on the client connection metadata, i.e., connections are opened to\n the same address as the destination address of the incoming connection\n before the connection was redirected to the load balancer.\n - MAGLEV: used as a drop in replacement for the ring hash\n load balancer. Maglev is not as stable as ring hash but has faster table\n lookup build times and host selection times. For more information about\n Maglev, see Maglev:\n A Fast and Reliable Software Network Load Balancer.\n - WEIGHTED_ROUND_ROBIN: Per-endpoint Weighted Round Robin\n Load Balancing using weights computed from Backend reported Custom Metrics.\n If set, the Backend Service responses are expected to contain non-standard\n HTTP response header field Endpoint-Load-Metrics. The reported\n metrics to use for computing the weights are specified via thecustomMetrics field.\n - WEIGHTED_MAGLEV: Per-endpoint weighted load balancing via\n health check reported weights. If set, the backend service must configure\n an HTTP-based Health Check, and health check replies are expected to\n contain the non-standard HTTP response header fieldX-Load-Balancing-Endpoint-Weight to specify the per-endpoint\n weights. If set, load balancing is weighted based on the per-endpoint\n weights reported in the last processed health check replies, as long as\n every instance either reported a valid weight or had UNAVAILABLE_WEIGHT.\n Otherwise, load balancing remains equal-weight.\n\n\n\nThis field is applicable to either:\n \n - A regional backend service with the service protocol set to HTTP,\n HTTPS, HTTP2 or H2C, and load_balancing_scheme set to\n INTERNAL_MANAGED. \n - A global backend service with the\n load_balancing_scheme set to INTERNAL_SELF_MANAGED, INTERNAL_MANAGED, or\n EXTERNAL_MANAGED.\n\n\n\nIf sessionAffinity is not configured\u2014that is, if session\naffinity remains at the default value of NONE\u2014then the\ndefault value for localityLbPolicy\nis ROUND_ROBIN. If session affinity is set to a value other\nthan NONE,\nthen the default value for localityLbPolicy isMAGLEV.\n\nOnly ROUND_ROBIN and RING_HASH are supported\nwhen the backend service is referenced by a URL map that is bound to\ntarget gRPC proxy that has validateForProxyless field set to true.\n\nlocalityLbPolicy cannot be specified with haPolicy.", + "enum": [ + "INVALID_LB_POLICY", + "LEAST_REQUEST", + "MAGLEV", + "ORIGINAL_DESTINATION", + "RANDOM", + "RING_HASH", + "ROUND_ROBIN", + "WEIGHTED_GCP_RENDEZVOUS", + "WEIGHTED_MAGLEV", + "WEIGHTED_ROUND_ROBIN" ], - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "", + "An O(1) algorithm which selects two random healthy hosts and\npicks the host which has fewer active requests.", + "This algorithm implements consistent hashing to backends. Maglev can be\nused as a drop in replacement for the ring hash load balancer. Maglev is\nnot as stable as ring hash but has faster table lookup build times and\nhost selection times. For more information about Maglev, seeMaglev:\nA Fast and Reliable Software Network Load Balancer.", + "Backend host is selected based on the client connection metadata, i.e.,\nconnections are opened to the same address as the destination address of\nthe incoming connection before the connection was redirected to the load\nbalancer.", + "The load balancer selects a random healthy host.", + "The ring/modulo hash load balancer implements consistent hashing to\nbackends. The algorithm has the property that the addition/removal\nof 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\nin round robin order. This is the default.", + "Per-instance weighted Load Balancing via health check reported weights.\nIn internal passthrough network load balancing, it is weighted\nrendezvous hashing.\nThis option is only supported in internal passthrough network load\nbalancing.", + "Per-instance weighted Load Balancing via health check reported weights.\nIf set, the Backend Service must configure a non legacy HTTP-based Health\nCheck, and health check replies are expected to contain non-standard HTTP\nresponse header field X-Load-Balancing-Endpoint-Weight to specify the\nper-instance weights.\nIf set, Load Balancing is weighted based on the\nper-instance weights reported in the last processed health check replies,\nas long as every instance either reported a valid weight or had\nUNAVAILABLE_WEIGHT. Otherwise, Load Balancing remains equal-weight.\nThis option is only supported in Network Load Balancing.", + "Per-endpoint weighted round-robin Load Balancing using weights computed\nfrom Backend reported Custom Metrics. If set, the Backend Service\nresponses are expected to contain non-standard HTTP response header field\nEndpoint-Load-Metrics. The reported metrics\nto use for computing the weights are specified via the\ncustomMetrics fields." ], - "description": "Gets the access control policy for a resource. May be empty if no such policy or resource exists." + "type": "string" }, - "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" - } + "logConfig": { + "$ref": "BackendServiceLogConfig", + "description": "This field denotes the logging options for the load balancer traffic served\nby this backend service. If logging is enabled, logs will be exported to\nStackdriver." + }, + "maxStreamDuration": { + "$ref": "Duration", + "description": "Specifies the default maximum duration (timeout) for streams to this\nservice. Duration is computed from the beginning of the stream until the\nresponse has been completely processed, including all retries. A stream\nthat does not complete in this duration is closed.\n\nIf not specified, there will be no timeout limit, i.e. the maximum\nduration is infinite.\n\nThis value can be overridden in the PathMatcher configuration of the\nUrlMap that references this backend service.\n\nThis field is only allowed when the loadBalancingScheme of\nthe backend service is INTERNAL_SELF_MANAGED." + }, + "metadatas": { + "additionalProperties": { + "type": "string" }, - "parameterOrder": [ - "resource" + "description": "Deployment metadata associated with the resource to be set by a GKE hub\ncontroller and read by the backend RCTH", + "type": "object" + }, + "name": { + "description": "Name of the resource. Provided by the client when the resource is created.\nThe name must be 1-63 characters long, and comply withRFC1035.\nSpecifically, the name must be 1-63 characters long and match the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first\ncharacter must be a lowercase letter, and all following characters must\nbe a dash, lowercase letter, or digit, except the last character, which\ncannot be a dash.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "network": { + "description": "The URL of the network to which this backend service belongs.\n\nThis field must be set for Internal Passthrough Network Load Balancers when\nthe haPolicy is enabled, and for External Passthrough Network Load\nBalancers when the haPolicy fastIpMove is enabled.\n\nThis field can only be specified when the load balancing scheme is set toINTERNAL, or when the load balancing scheme is set toEXTERNAL and haPolicy fastIpMove is enabled.", + "type": "string" + }, + "networkPassThroughLbTrafficPolicy": { + "$ref": "BackendServiceNetworkPassThroughLbTrafficPolicy", + "description": "Configures traffic steering properties of internal passthrough Network\nLoad Balancers.\n\nnetworkPassThroughLbTrafficPolicy cannot be specified with haPolicy." + }, + "orchestrationInfo": { + "$ref": "BackendServiceOrchestrationInfo", + "description": "Information about the resource or system that manages the backend service." + }, + "outlierDetection": { + "$ref": "OutlierDetection", + "description": "Settings controlling the ejection of unhealthy backend endpoints from the\nload balancing pool of each individual proxy instance that processes the\ntraffic for the given backend service. If not set, this feature is\nconsidered disabled.\n\nResults of the outlier detection algorithm (ejection of endpoints from the\nload balancing pool and returning them back to the pool) are executed\nindependently by each proxy instance of the load balancer. In most cases,\nmore than one proxy instance handles the traffic received by a backend\nservice. Thus, it is possible that an unhealthy endpoint is detected and\nejected by only some of the proxies, and while this happens, other proxies\nmay continue to send requests to the same unhealthy endpoint until they\ndetect and eject the unhealthy endpoint.\n\nApplicable backend endpoints can be:\n \n - VM instances in an Instance Group\n - Endpoints in a Zonal NEG (GCE_VM_IP, GCE_VM_IP_PORT)\n - Endpoints in a Hybrid Connectivity NEG (NON_GCP_PRIVATE_IP_PORT)\n - Serverless NEGs, that resolve to Cloud Run, App Engine, or Cloud\n Functions Services \n - Private Service Connect NEGs, that resolve to\n Google-managed regional API endpoints or managed services published using\n Private Service Connect\n\n\n\nApplicable backend service types can be:\n \n - A global backend service with the loadBalancingScheme set to\n INTERNAL_SELF_MANAGED or EXTERNAL_MANAGED. \n - A regional backend\n service with the service protocol set to HTTP, HTTPS, HTTP2 or H2C, and\n loadBalancingScheme set to INTERNAL_MANAGED or EXTERNAL_MANAGED. Not\n supported for Serverless NEGs.\n\n\n\nNot supported when the backend service is referenced by a URL map that is\nbound to target gRPC proxy that has validateForProxyless field set to true." + }, + "params": { + "$ref": "BackendServiceParams", + "description": "Input only. [Input Only] Additional params passed with the request, but not persisted\nas part of resource payload." + }, + "port": { + "deprecated": true, + "description": "Deprecated in favor of portName. The TCP port to connect on\nthe backend. The default value is 80.\nFor internal passthrough Network Load Balancers and external passthrough\nNetwork Load Balancers, omit port.", + "format": "int32", + "type": "integer" + }, + "portName": { + "description": "A named port on a backend instance group representing the port for\ncommunication to the backend VMs in that group. The\nnamed port must be [defined on each backend instance\ngroup](https://cloud.google.com/load-balancing/docs/backend-service#named_ports).\nThis parameter has no meaning if the backends are NEGs. For internal\npassthrough Network Load Balancers and external passthrough Network Load\nBalancers, omit port_name.", + "type": "string" + }, + "protocol": { + "description": "The protocol this BackendService uses to communicate with backends.\n\nPossible values are HTTP, HTTPS, HTTP2, H2C, TCP, SSL, UDP, GRPC, or\nUNSPECIFIED, depending on the chosen load balancer or Traffic Director\nconfiguration.\nRefer to \nLoad balancing features for more information.\n\nMust be set to GRPC when the backend service is referenced by a URL map\nthat is bound to target gRPC proxy.", + "enum": [ + "GRPC", + "H2C", + "HTTP", + "HTTP2", + "HTTPS", + "SSL", + "TCP", + "UDP", + "UNSPECIFIED" ], - "request": { - "$ref": "GlobalOrganizationSetPolicyRequest" - }, - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "gRPC (available for Traffic Director).", + "HTTP2 over cleartext", + "", + "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\nany L3/L4 Forwarding Rules." ], - "description": "Sets the access control policy on the specified resource. Replaces any existing policy." + "type": "string" }, - "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" - } + "region": { + "description": "Output only. [Output Only] URL of the region where the regional backend service\nresides. This field is not applicable to global backend services.\nYou must specify this field as part of the HTTP request URL. It is\nnot settable as a field in the request body.", + "readOnly": true, + "type": "string" + }, + "securityPolicy": { + "description": "[Output Only] The resource URL for the security policy associated with this\nbackend service.", + "type": "string" + }, + "securitySettings": { + "$ref": "SecuritySettings", + "description": "This field specifies the security settings that apply to this backend\nservice. This field is applicable to a global backend service with the\nload_balancing_scheme set to INTERNAL_SELF_MANAGED." + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" + }, + "serviceBindings": { + "description": "URLs of networkservices.ServiceBinding resources.\n\nCan only be set if load balancing scheme is INTERNAL_SELF_MANAGED.\nIf set, lists of backends and health checks must be both empty.", + "items": { + "type": "string" }, - "parameterOrder": [ - "resource" + "type": "array" + }, + "serviceLbPolicy": { + "description": "URL to networkservices.ServiceLbPolicy resource.\n\nCan only be set if load balancing scheme is EXTERNAL_MANAGED,\nINTERNAL_MANAGED or INTERNAL_SELF_MANAGED for a global backend service, and\nEXTERNAL_MANAGED or INTERNAL_MANAGED for a regional backend service. For a\nglobal backend service, the service lb policy must be global. For a\nregional backend service, the service lb policy must be regional and in the\nsame region.", + "type": "string" + }, + "sessionAffinity": { + "description": "Type of session affinity to use. The default is NONE.\n\nOnly NONE and HEADER_FIELD are supported\nwhen the backend service is referenced by a URL map that is bound to\ntarget gRPC proxy that has validateForProxyless field set to true.\n\nFor more details, see:\n[Session\nAffinity](https://cloud.google.com/load-balancing/docs/backend-service#session_affinity).\n\nsessionAffinity cannot be specified with haPolicy.", + "enum": [ + "CLIENT_IP", + "CLIENT_IP_NO_DESTINATION", + "CLIENT_IP_PORT_PROTO", + "CLIENT_IP_PROTO", + "GENERATED_COOKIE", + "HEADER_FIELD", + "HTTP_COOKIE", + "NONE", + "STRONG_COOKIE_AFFINITY" ], - "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" + "enumDescriptions": [ + "2-tuple hash on packet's source and destination IP addresses. Connections\nfrom the same source IP address to the same destination IP address will be\nserved by the same backend VM while that VM remains healthy.", + "1-tuple hash only on packet's source IP address. Connections from the\nsame source IP address will be served by the same backend VM while that VM\nremains healthy. This option can only be used for Internal TCP/UDP\nLoad Balancing.", + "5-tuple hash on packet's source and destination IP addresses, IP protocol,\nand source and destination ports. Connections for the same IP protocol\nfrom the same source IP address and port to the same destination IP address\nand port will be served by the same backend VM while that VM remains\nhealthy. This option cannot be used for HTTP(S) load balancing.", + "3-tuple hash on packet's source and destination IP addresses, and IP\nprotocol. Connections for the same IP protocol from the same source IP\naddress to the same destination IP address will be served by the same\nbackend VM while that VM remains healthy. This option cannot be used for\nHTTP(S) load balancing.", + "Hash based on a cookie generated by the L7 loadbalancer.\nOnly 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\nto any instance in the pool.", + "Strong cookie-based affinity. Connections bearing the same cookie will be\nserved by the same backend VM while that VM remains healthy, as long as the\ncookie has not expired." ], - "description": "Returns permissions that a caller has on the specified resource." + "type": "string" + }, + "strongSessionAffinityCookie": { + "$ref": "BackendServiceHttpCookie", + "description": "Describes the HTTP cookie used for stateful session affinity. This field is\napplicable and required if the sessionAffinity is set toSTRONG_COOKIE_AFFINITY." + }, + "subsetting": { + "$ref": "Subsetting", + "description": "subsetting cannot be specified with haPolicy." + }, + "timeoutSec": { + "description": "The backend service timeout has a different meaning depending on the\ntype of load balancer. For more information see,\nBackend service settings.\nThe default is 30 seconds.\nThe full range of timeout values allowed goes from 1\nthrough 2,147,483,647 seconds.\n\nThis value can be overridden in the PathMatcher configuration of the\nUrlMap that references this backend service.\n\nNot supported when the backend service is referenced by a URL map that is\nbound to target gRPC proxy that has validateForProxyless field set to true.\nInstead, use maxStreamDuration.", + "format": "int32", + "type": "integer" + }, + "tlsSettings": { + "$ref": "BackendServiceTlsSettings", + "description": "Configuration for Backend Authenticated TLS and mTLS. May only be specified\nwhen the backend protocol is SSL, HTTPS or HTTP2." + }, + "usedBy": { + "description": "Output only. [Output Only] List of resources referencing given backend service.", + "items": { + "$ref": "BackendServiceUsedBy" + }, + "readOnly": true, + "type": "array" } - } + }, + "type": "object" }, - "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" - } + "BackendServiceAggregatedList": { + "description": "Contains a list of BackendServicesScopedList.", + "id": "BackendServiceAggregatedList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "additionalProperties": { + "$ref": "BackendServicesScopedList", + "description": "Name of the scope containing this set of BackendServices." }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "FirewallPolicyList" + "description": "A list of BackendServicesScopedList resources.", + "type": "object" + }, + "kind": { + "default": "compute#backendServiceAggregatedList", + "description": "Output only. Type of resource.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "unreachables": { + "description": "Output only. [Output Only] Unreachable resources.", + "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": "Lists all the policies that have been configured for the specified project." + "readOnly": true, + "type": "array" }, - "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, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, + "data": { + "description": "[Output Only] Metadata about this warning in key:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" + }, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project", - "firewallPolicy" - ], - "response": { - "$ref": "FirewallPolicy" + "type": "object" + } + }, + "type": "object" + }, + "BackendServiceCdnPolicy": { + "description": "Message containing Cloud CDN configuration for a backend service.", + "id": "BackendServiceCdnPolicy", + "properties": { + "bypassCacheOnRequestHeaders": { + "description": "Bypass the cache when the specified request headers are matched - e.g.\nPragma or Authorization headers. Up to 5 headers can be specified.\nThe cache is bypassed for all cdnPolicy.cacheMode settings.", + "items": { + "$ref": "BackendServiceCdnPolicyBypassCacheOnRequestHeader" }, - "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." + "type": "array" }, - "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" + "cacheKeyPolicy": { + "$ref": "CacheKeyPolicy", + "description": "The CacheKeyPolicy for this CdnPolicy." + }, + "cacheMode": { + "description": "Specifies the cache setting for all responses from this backend.\nThe possible values are:\nUSE_ORIGIN_HEADERS Requires the origin to set valid caching\nheaders to cache content. Responses without these headers will not be\ncached at Google's edge, and will require a full trip to the origin on\nevery request, potentially impacting performance and increasing load on\nthe origin server.\nFORCE_CACHE_ALL Cache all content, ignoring any \"private\",\n\"no-store\" or \"no-cache\" directives in Cache-Control response headers.\nWarning: this may result in Cloud CDN caching private,\nper-user (user identifiable) content.\nCACHE_ALL_STATIC Automatically cache static content,\nincluding common image formats, media (video and audio), and web assets\n(JavaScript and CSS). Requests and responses that are marked as\nuncacheable, as well as dynamic content (including HTML), will not be\ncached.\n\nIf no value is provided for cdnPolicy.cacheMode, it defaults\nto CACHE_ALL_STATIC.", + "enum": [ + "CACHE_ALL_STATIC", + "FORCE_CACHE_ALL", + "INVALID_CACHE_MODE", + "USE_ORIGIN_HEADERS" ], - "request": { - "$ref": "FirewallPolicy" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "Automatically cache static content, including common image formats,\nmedia (video and audio), and web assets (JavaScript and CSS).\nRequests and responses that are marked as uncacheable, as well as\ndynamic content (including HTML), will not be cached.", + "Cache all content, ignoring any \"private\", \"no-store\" or \"no-cache\"\ndirectives in Cache-Control response headers.\nWarning: this may result in Cloud CDN caching private,\nper-user (user identifiable) content.", + "", + "Requires the origin to set valid caching headers to cache content.\nResponses without these headers will not be cached at Google's edge,\nand will require a full trip to the origin on every request,\npotentially impacting performance and increasing load on the\norigin server." ], - "description": "Creates a new policy in the specified project using the data included in the request." + "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" + "clientTtl": { + "description": "Specifies a separate client (e.g. browser client) maximum TTL. This is\nused to clamp the max-age (or Expires) value sent to the client. With\nFORCE_CACHE_ALL, the lesser of client_ttl and default_ttl is used for the\nresponse max-age directive, along with a \"public\" directive. For\ncacheable content in CACHE_ALL_STATIC mode, client_ttl clamps the max-age\nfrom the origin (if specified), or else sets the response max-age\ndirective to the lesser of the client_ttl and default_ttl, and also\nensures a \"public\" cache-control directive is present.\nIf a client TTL is not specified, a default value (1 hour) will be used.\nThe maximum allowed value is 31,622,400s (1 year).", + "format": "int32", + "type": "integer" + }, + "defaultTtl": { + "description": "Specifies the default TTL for cached content served by this origin for\nresponses that do not have an existing valid TTL (max-age or s-maxage).\nSetting a TTL of \"0\" means \"always revalidate\".\nThe value of defaultTTL cannot be set to a value greater than that of\nmaxTTL, but can be equal.\nWhen the cacheMode is set to FORCE_CACHE_ALL, the defaultTTL\nwill overwrite the TTL set in all responses. The maximum allowed value is\n31,622,400s (1 year), noting that infrequently accessed objects may be\nevicted from the cache before the defined TTL.", + "format": "int32", + "type": "integer" + }, + "maxTtl": { + "description": "Specifies the maximum allowed TTL for cached content served by this\norigin.\nCache directives that attempt to set a max-age or s-maxage higher than\nthis, or an Expires header more than maxTTL seconds in the future will\nbe capped at the value of maxTTL, as if it were the value of an\ns-maxage Cache-Control directive.\nHeaders sent to the client will not be modified.\nSetting a TTL of \"0\" means \"always revalidate\".\nThe maximum allowed value is 31,622,400s (1 year), noting that\ninfrequently accessed objects may be evicted from the cache before\nthe defined TTL.", + "format": "int32", + "type": "integer" + }, + "negativeCaching": { + "description": "Negative caching allows per-status code TTLs to be set, in order\nto apply fine-grained caching for common errors or redirects.\nThis can reduce the load on your origin and improve end-user\nexperience by reducing response latency.\nWhen the cache mode is set to CACHE_ALL_STATIC or USE_ORIGIN_HEADERS,\nnegative caching applies to responses with the specified response code\nthat lack any Cache-Control, Expires, or Pragma: no-cache directives.\nWhen the cache mode is set to FORCE_CACHE_ALL, negative caching applies\nto all responses with the specified response code, and override any\ncaching headers.\nBy default, Cloud CDN will apply the following default TTLs to these\nstatus codes:\nHTTP 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m\nHTTP 404 (Not Found), 410 (Gone),\n451 (Unavailable For Legal Reasons): 120s\nHTTP 405 (Method Not Found), 501 (Not Implemented): 60s.\nThese defaults can be overridden in negative_caching_policy.", + "type": "boolean" + }, + "negativeCachingPolicy": { + "description": "Sets a cache TTL for the specified HTTP status code.\nnegative_caching must be enabled to configure negative_caching_policy.\nOmitting the policy and leaving negative_caching enabled will use\nCloud CDN's default cache TTLs.\nNote that when specifying an explicit negative_caching_policy, you\nshould take care to specify a cache TTL for all response codes\nthat you wish to cache. Cloud CDN will not apply any default\nnegative caching when a policy exists.", + "items": { + "$ref": "BackendServiceCdnPolicyNegativeCachingPolicy" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified policy." + "type": "array" }, - "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" - } + "requestCoalescing": { + "description": "If true then Cloud CDN will combine multiple concurrent cache fill\nrequests into a small number of requests to the origin.", + "type": "boolean" + }, + "serveWhileStale": { + "description": "Serve existing content from the cache (if available) when revalidating\ncontent with the origin, or when an error is encountered when refreshing\nthe cache.\nThis setting defines the default \"max-stale\" duration for any cached\nresponses that do not specify a max-stale directive. Stale responses that\nexceed the TTL configured here will not be served. The default limit\n(max-stale) is 86400s (1 day), which will allow stale content to be\nserved up to this limit beyond the max-age (or s-maxage) of a cached\nresponse.\nThe maximum allowed value is 604800 (1 week).\nSet this to zero (0) to disable serve-while-stale.", + "format": "int32", + "type": "integer" + }, + "signedUrlCacheMaxAgeSec": { + "description": "Maximum number of seconds the response to a signed URL request will be\nconsidered fresh. After this time period, the response will be\nrevalidated before being served. Defaults to 1hr (3600s). When serving\nresponses to signed URL requests, Cloud CDN will internally behave as\nthough all responses from this backend had a \"Cache-Control:\npublic, max-age=[TTL]\" header, regardless of any existing\nCache-Control header. The actual headers served in responses will not be\naltered.", + "format": "int64", + "type": "string" + }, + "signedUrlKeyNames": { + "description": "[Output Only] Names of the keys for signing request URLs.", + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "firewallPolicy" + "type": "array" + } + }, + "type": "object" + }, + "BackendServiceCdnPolicyBypassCacheOnRequestHeader": { + "description": "Bypass the cache when the specified request headers are present,\ne.g. Pragma or Authorization headers. Values are case insensitive.\nThe presence of such a header overrides the cache_mode setting.", + "id": "BackendServiceCdnPolicyBypassCacheOnRequestHeader", + "properties": { + "headerName": { + "description": "The header field name to match on when bypassing cache.\nValues are case-insensitive.", + "type": "string" + } + }, + "type": "object" + }, + "BackendServiceCdnPolicyNegativeCachingPolicy": { + "description": "Specify CDN TTLs for response error codes.", + "id": "BackendServiceCdnPolicyNegativeCachingPolicy", + "properties": { + "code": { + "description": "The HTTP status code to define a TTL against. Only HTTP status codes\n300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be\nspecified as values, and you cannot specify a status code more than\nonce.", + "format": "int32", + "type": "integer" + }, + "ttl": { + "description": "The TTL (in seconds) for which to cache responses with the\ncorresponding status code.\nThe maximum allowed value is 1800s (30 minutes), noting that\ninfrequently accessed objects may be evicted from the cache before the\ndefined TTL.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, + "BackendServiceConnectionTrackingPolicy": { + "description": "Connection Tracking configuration for this BackendService.", + "id": "BackendServiceConnectionTrackingPolicy", + "properties": { + "connectionPersistenceOnUnhealthyBackends": { + "description": "Specifies connection persistence when backends are unhealthy. The default\nvalue is DEFAULT_FOR_PROTOCOL.\n\nIf set to DEFAULT_FOR_PROTOCOL, the existing connections\npersist on unhealthy backends only for connection-oriented protocols\n(TCP and SCTP) and only if the Tracking Mode isPER_CONNECTION (default tracking mode) or the Session\nAffinity is configured for 5-tuple. They do not persist forUDP.\n\nIf set to NEVER_PERSIST, after a backend becomes unhealthy,\nthe existing connections on the unhealthy backend are never persisted on\nthe unhealthy backend. They are always diverted to newly selected healthy\nbackends (unless all backends are unhealthy).\n\nIf set to ALWAYS_PERSIST, existing connections always\npersist on unhealthy backends regardless of protocol and session\naffinity. It is generally not recommended to use this mode overriding the\ndefault.\n\nFor more details, see [Connection Persistence for Network Load\nBalancing](https://cloud.google.com/load-balancing/docs/network/networklb-backend-service#connection-persistence)\nand [Connection Persistence for Internal TCP/UDP Load\nBalancing](https://cloud.google.com/load-balancing/docs/internal#connection-persistence).", + "enum": [ + "ALWAYS_PERSIST", + "DEFAULT_FOR_PROTOCOL", + "NEVER_PERSIST" ], - "request": { - "$ref": "FirewallPolicy" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "", + "", + "" ], - "description": "Patches the specified policy with the data included in the request." + "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" + "enableStrongAffinity": { + "description": "Enable Strong Session Affinity for external passthrough Network Load\nBalancers. This option is not available publicly.", + "type": "boolean" + }, + "idleTimeoutSec": { + "description": "Specifies how long to keep a Connection Tracking entry while there is no\nmatching traffic (in seconds).\n\nFor internal passthrough Network Load Balancers:\n \n - The minimum (default) is 10 minutes and the maximum is 16 hours.\n - It can be set only if Connection Tracking is less than 5-tuple\n (i.e. Session Affinity is CLIENT_IP_NO_DESTINATION,CLIENT_IP or CLIENT_IP_PROTO, and Tracking\n Mode is PER_SESSION).\n\n\n\nFor external passthrough Network Load Balancers the default is 60\nseconds. This option is not available publicly.", + "format": "int32", + "type": "integer" + }, + "trackingMode": { + "description": "Specifies the key used for connection tracking. There are two\noptions:\n \n - PER_CONNECTION: This is the default mode. The Connection\n Tracking is performed as per the Connection Key (default Hash Method) for\n the specific protocol.\n - PER_SESSION: The Connection Tracking is performed as per\n the configured Session Affinity. It matches the configured Session\n Affinity.\n\n\n\nFor more details, see [Tracking Mode for Network Load\nBalancing](https://cloud.google.com/load-balancing/docs/network/networklb-backend-service#tracking-mode)\nand [Tracking Mode for Internal TCP/UDP Load\nBalancing](https://cloud.google.com/load-balancing/docs/internal#tracking-mode).", + "enum": [ + "INVALID_TRACKING_MODE", + "PER_CONNECTION", + "PER_SESSION" ], - "response": { - "$ref": "FirewallPolicyRule" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "", + "", + "" ], - "description": "Gets a rule of the specified priority." + "type": "string" + } + }, + "type": "object" + }, + "BackendServiceCustomMetric": { + "description": "Custom Metrics are used for WEIGHTED_ROUND_ROBIN\nlocality_lb_policy.", + "id": "BackendServiceCustomMetric", + "properties": { + "dryRun": { + "description": "If true, the metric data is not used for load balancing.", + "type": "boolean" }, - "getPacketMirroringRule": { - "id": "compute.networkFirewallPolicies.getPacketMirroringRule", - "path": "projects/{project}/global/firewallPolicies/{firewallPolicy}/getPacketMirroringRule", - "flatPath": "projects/{project}/global/firewallPolicies/{firewallPolicy}/getPacketMirroringRule", - "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" - } + "name": { + "description": "Name of a custom utilization signal. The name must be 1-64 characters\nlong and match the regular expression\n`[a-z]([-_.a-z0-9]*[a-z0-9])?` which means that the\nfirst character must be a lowercase letter, and all following\ncharacters must be a dash, period, underscore, lowercase letter, or\ndigit, except the last character, which cannot be a dash, period, or\nunderscore. For usage guidelines, see Custom Metrics balancing mode. This\nfield can only be used for a global or regional backend service with the\nloadBalancingScheme set to EXTERNAL_MANAGED,INTERNAL_MANAGED INTERNAL_SELF_MANAGED.", + "type": "string" + } + }, + "type": "object" + }, + "BackendServiceFailoverPolicy": { + "description": "For load balancers that have configurable\nfailover:\n[Internal passthrough Network Load\nBalancers](https://cloud.google.com/load-balancing/docs/internal/failover-overview)\nand [external passthrough\nNetwork Load\nBalancers](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview).\nOn failover or failback, this field indicates whether connection draining\nwill be honored. Google Cloud has a fixed connection draining timeout of\n10 minutes. A setting of true terminates existing TCP\nconnections to the active pool during failover and failback, immediately\ndraining traffic. A setting of false allows existing TCP\nconnections to persist, even on VMs no longer in the active pool, for up\nto the duration of the connection draining timeout (10 minutes).", + "id": "BackendServiceFailoverPolicy", + "properties": { + "disableConnectionDrainOnFailover": { + "description": "This can be set to true if the protocol isTCP, UDP, or UNSPECIFIED.\n\nThe default is false.", + "type": "boolean" + }, + "dropTrafficIfUnhealthy": { + "description": "If set to true, connections to the\nload balancer are dropped when all primary and all backup backend VMs are\nunhealthy.If set to false, connections are distributed\namong all primary VMs when all primary and all backup backend VMs are\n unhealthy.\nFor load balancers that have configurable\nfailover:\n[Internal passthrough\nNetwork Load\nBalancers](https://cloud.google.com/load-balancing/docs/internal/failover-overview)\nand [external passthrough\nNetwork Load\nBalancers](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview).\nThe 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\nfailover when the number of healthy primary VMs equals zero.\nFor all other values, the load balancer performs a failover when the\ntotal number of healthy primary VMs is less than this ratio.\nFor load balancers that have configurable\nfailover:\n[Internal TCP/UDP Load\nBalancing](https://cloud.google.com/load-balancing/docs/internal/failover-overview)\nand [external TCP/UDP Load\nBalancing](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview).", + "format": "float", + "type": "number" + } + }, + "type": "object" + }, + "BackendServiceGroupHealth": { + "id": "BackendServiceGroupHealth", + "properties": { + "annotations": { + "additionalProperties": { + "type": "string" }, - "parameterOrder": [ - "project", - "firewallPolicy" - ], - "response": { - "$ref": "FirewallPolicyRule" + "description": "Metadata defined as annotations on the network endpoint group.", + "type": "object" + }, + "healthStatus": { + "description": "Health state of the backend instances or endpoints in requested instance or\nnetwork endpoint group, determined based on configured health checks.", + "items": { + "$ref": "HealthStatus" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "type": "array" + }, + "kind": { + "default": "compute#backendServiceGroupHealth", + "description": "Output only. [Output Only] Type of resource. Alwayscompute#backendServiceGroupHealth for the health of backend\nservices.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "BackendServiceHAPolicy": { + "id": "BackendServiceHAPolicy", + "properties": { + "fastIPMove": { + "description": "Specifies whether fast IP move is enabled, and if so, the mechanism to\nachieve it.\n\nSupported values are:\n \n - DISABLED: Fast IP Move is disabled. You can only use the\n haPolicy.leader API to update the leader.\n - >GARP_RA: Provides a method to very quickly define a new network\n endpoint as the leader. This method is faster than updating the leader\n using the haPolicy.leader API. Fast IP move works as follows: The VM\n hosting the network endpoint that should become the new leader sends\n either a Gratuitous ARP (GARP) packet (IPv4) or an ICMPv6 Router\n Advertisement(RA) packet (IPv6). Google Cloud immediately but\n temporarily associates the forwarding rule IP address with that VM, and\n both new and in-flight packets are quickly delivered to that VM.\n\n\n\nNote the important properties of the Fast IP Move functionality:\n \n - The GARP/RA-initiated re-routing stays active for approximately 20\n minutes. After triggering fast failover, you must also\n appropriately set the haPolicy.leader.\n - The new leader instance should continue to send GARP/RA packets\n periodically every 10 seconds until at least 10 minutes after updating\n the haPolicy.leader (but stop immediately if it is no longer the leader).\n - After triggering a fast failover, we recommend that you wait at least\n 3 seconds before sending another GARP/RA packet from a different VM\n instance to avoid race conditions.\n - Don't send GARP/RA packets from different VM\n instances at the same time. If multiple instances continue to send\n GARP/RA packets, traffic might be routed to different destinations in an\n alternating order. This condition ceases when a single instance\n issues a GARP/RA packet.\n - The GARP/RA request always takes priority over the leader API.\n Using the haPolicy.leader API to change the leader to a different\n instance will have no effect until the GARP/RA request becomes\n inactive.\n - The GARP/RA packets should follow the GARP/RA\n Packet Specifications..\n - When multiple forwarding rules refer to a regional backend service,\n you need only send a GARP or RA packet for a single forwarding rule\n virtual IP. The virtual IPs for all forwarding rules targeting the same\n backend service will also be moved to the sender of the GARP or RA\n packet. \n\n\n\nThe following are the Fast IP Move limitations (that is, when fastIPMove\nis not DISABLED):\n \n - Multiple forwarding rules cannot use the same IP address if one of\n them refers to a regional backend service with fastIPMove.\n - The regional backend service must set the network field, and all\n NEGs must belong to that network. However, individual\n NEGs can belong to different subnetworks of that network. \n - The maximum number of network endpoints across all backends of a\n backend service with fastIPMove is 32.\n - The maximum number of backend services with fastIPMove that can have\n the same network endpoint attached to one of its backends is 64.\n - The maximum number of backend services with fastIPMove in a VPC in a\n region is 64.\n - The network endpoints that are attached to a backend of a backend\n service with fastIPMove cannot resolve to Gen3+ machines for IPv6.\n - Traffic directed to the leader by a static route next hop will not be\n redirected to a new leader by fast failover. Such traffic will only be\n redirected once an haPolicy.leader update has taken effect. Only traffic\n to the forwarding rule's virtual IP will be redirected to a new leader by\n fast failover.\n\n\nhaPolicy.fastIPMove can be set only at backend service creation time.\nOnce set, it cannot be updated.\n\nBy default, fastIpMove is set to DISABLED.", + "enum": [ + "DISABLED", + "GARP_RA" + ], + "enumDescriptions": [ + "", + "" ], - "description": "Gets a packet mirroring rule of the specified priority." + "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, + "leader": { + "$ref": "BackendServiceHAPolicyLeader", + "description": "Selects one of the network endpoints attached to the backend NEGs of\nthis service as the active endpoint (the leader) that receives all\ntraffic.\n\nWhen the leader changes, there is no connection draining to persist\nexisting connections on the old leader.\n\nYou are responsible for selecting a suitable endpoint as the\nleader. For example, preferring a healthy endpoint over unhealthy ones.\nNote that this service does not track backend endpoint health, and\nselects the configured leader unconditionally." + } + }, + "type": "object" + }, + "BackendServiceHAPolicyLeader": { + "id": "BackendServiceHAPolicyLeader", + "properties": { + "backendGroup": { + "description": "A fully-qualified URL (starting with https://www.googleapis.com/)\nof the zonal Network Endpoint Group (NEG) with `GCE_VM_IP` endpoints\nthat the leader is attached to.\n\nThe leader's backendGroup must already be specified as a backend of\nthis backend service. Removing a backend that is designated as the\nleader's backendGroup is not permitted.", + "type": "string" + }, + "networkEndpoint": { + "$ref": "BackendServiceHAPolicyLeaderNetworkEndpoint", + "description": "The network endpoint within the leader.backendGroup that is\ndesignated as the leader.\n\nThis network endpoint cannot be detached from the NEG specified in\nthe haPolicy.leader.backendGroup until the leader is updated with\nanother network endpoint, or the leader is removed from the haPolicy." + } + }, + "type": "object" + }, + "BackendServiceHAPolicyLeaderNetworkEndpoint": { + "id": "BackendServiceHAPolicyLeaderNetworkEndpoint", + "properties": { + "instance": { + "description": "The name of the VM instance of the leader network endpoint. The\ninstance must already be attached to the NEG specified in the\nhaPolicy.leader.backendGroup.\n\nThe name must be 1-63 characters long, and comply with RFC1035.\nAuthorization requires the following IAM permission on the\nspecified resource instance: compute.instances.use", + "type": "string" + } + }, + "type": "object" + }, + "BackendServiceHttpCookie": { + "description": "The HTTP cookie used for stateful session affinity.", + "id": "BackendServiceHttpCookie", + "properties": { + "name": { + "description": "Name of the cookie.", + "type": "string" + }, + "path": { + "description": "Path to set for the cookie.", + "type": "string" + }, + "ttl": { + "$ref": "Duration", + "description": "Lifetime of the cookie." + } + }, + "type": "object" + }, + "BackendServiceIAP": { + "description": "Identity-Aware Proxy", + "id": "BackendServiceIAP", + "properties": { + "enabled": { + "description": "Whether the serving infrastructure will authenticate and authorize all\nincoming 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.\nFor security reasons, this value cannot be retrieved via the API.\nInstead, the SHA-256 hash of the value is returned in the\noauth2ClientSecretSha256 field.\n\n@InputOnly", + "type": "string" + }, + "oauth2ClientSecretSha256": { + "description": "Output only. [Output Only] SHA256 hash value for the field oauth2_client_secret above.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "BackendServiceList": { + "description": "Contains a list of BackendService resources.", + "id": "BackendServiceList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of BackendService resources.", + "items": { + "$ref": "BackendService" + }, + "type": "array" + }, + "kind": { + "default": "compute#backendServiceList", + "description": "Output only. [Output Only] Type of resource. Alwayscompute#backendServiceList for lists of backend services.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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" + "data": { + "description": "[Output Only] Metadata about this warning in key:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. 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" } }, - "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." + "type": "object" + } + }, + "type": "object" + }, + "BackendServiceListUsable": { + "description": "Contains a list of usable BackendService resources.", + "id": "BackendServiceListUsable", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" }, - "addPacketMirroringRule": { - "id": "compute.networkFirewallPolicies.addPacketMirroringRule", - "path": "projects/{project}/global/firewallPolicies/{firewallPolicy}/addPacketMirroringRule", - "flatPath": "projects/{project}/global/firewallPolicies/{firewallPolicy}/addPacketMirroringRule", - "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" + "items": { + "description": "A list of BackendService resources.", + "items": { + "$ref": "BackendService" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Inserts a packet mirroring rule into a firewall policy." + "type": "array" }, - "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." + "kind": { + "default": "compute#usableBackendServiceList", + "description": "Output only. [Output Only] Type of resource. Alwayscompute#usableBackendServiceList for lists of usable backend\nservices.", + "readOnly": true, + "type": "string" }, - "removePacketMirroringRule": { - "id": "compute.networkFirewallPolicies.removePacketMirroringRule", - "path": "projects/{project}/global/firewallPolicies/{firewallPolicy}/removePacketMirroringRule", - "flatPath": "projects/{project}/global/firewallPolicies/{firewallPolicy}/removePacketMirroringRule", - "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 packet mirroring rule of the specified priority." + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "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, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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" + "data": { + "description": "[Output Only] Metadata about this warning in key:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. 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" } }, - "parameterOrder": [ - "project", - "firewallPolicy" + "type": "object" + } + }, + "type": "object" + }, + "BackendServiceLocalityLoadBalancingPolicyConfig": { + "description": "Container for either a built-in LB policy supported by gRPC or Envoy or\na custom one implemented by the end user.", + "id": "BackendServiceLocalityLoadBalancingPolicyConfig", + "properties": { + "customPolicy": { + "$ref": "BackendServiceLocalityLoadBalancingPolicyConfigCustomPolicy" + }, + "policy": { + "$ref": "BackendServiceLocalityLoadBalancingPolicyConfigPolicy" + } + }, + "type": "object" + }, + "BackendServiceLocalityLoadBalancingPolicyConfigCustomPolicy": { + "description": "The configuration for a custom policy implemented by the user and\ndeployed with the client.", + "id": "BackendServiceLocalityLoadBalancingPolicyConfigCustomPolicy", + "properties": { + "data": { + "description": "An optional, arbitrary JSON object with configuration data, understood\nby a locally installed custom policy implementation.", + "type": "string" + }, + "name": { + "description": "Identifies the custom policy.\n\nThe value should match the name of a custom implementation registered\non the gRPC clients. It should follow protocol buffer message naming\nconventions and include the full path (for example,\nmyorg.CustomLbPolicy). The maximum length is 256 characters.\n\nDo not specify the same custom policy more than once for a\nbackend. If you do, the configuration is rejected.\n\nFor an example of how to use this field, seeUse\na custom policy.", + "type": "string" + } + }, + "type": "object" + }, + "BackendServiceLocalityLoadBalancingPolicyConfigPolicy": { + "description": "The configuration for a built-in load balancing policy.", + "id": "BackendServiceLocalityLoadBalancingPolicyConfigPolicy", + "properties": { + "name": { + "description": "The name of a locality load-balancing policy. Valid values include\nROUND_ROBIN and, for Java clients, LEAST_REQUEST. For information\nabout these values, see the description of localityLbPolicy.\n\nDo not specify the same policy more than once for a\nbackend. If you do, the configuration is rejected.", + "enum": [ + "INVALID_LB_POLICY", + "LEAST_REQUEST", + "MAGLEV", + "ORIGINAL_DESTINATION", + "RANDOM", + "RING_HASH", + "ROUND_ROBIN", + "WEIGHTED_GCP_RENDEZVOUS", + "WEIGHTED_MAGLEV", + "WEIGHTED_ROUND_ROBIN" ], - "request": { - "$ref": "FirewallPolicyRule" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "", + "An O(1) algorithm which selects two random healthy hosts and\npicks the host which has fewer active requests.", + "This algorithm implements consistent hashing to backends. Maglev can be\nused as a drop in replacement for the ring hash load balancer. Maglev is\nnot as stable as ring hash but has faster table lookup build times and\nhost selection times. For more information about Maglev, seeMaglev:\nA Fast and Reliable Software Network Load Balancer.", + "Backend host is selected based on the client connection metadata, i.e.,\nconnections are opened to the same address as the destination address of\nthe incoming connection before the connection was redirected to the load\nbalancer.", + "The load balancer selects a random healthy host.", + "The ring/modulo hash load balancer implements consistent hashing to\nbackends. The algorithm has the property that the addition/removal\nof 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\nin round robin order. This is the default.", + "Per-instance weighted Load Balancing via health check reported weights.\nIn internal passthrough network load balancing, it is weighted\nrendezvous hashing.\nThis option is only supported in internal passthrough network load\nbalancing.", + "Per-instance weighted Load Balancing via health check reported weights.\nIf set, the Backend Service must configure a non legacy HTTP-based Health\nCheck, and health check replies are expected to contain non-standard HTTP\nresponse header field X-Load-Balancing-Endpoint-Weight to specify the\nper-instance weights.\nIf set, Load Balancing is weighted based on the\nper-instance weights reported in the last processed health check replies,\nas long as every instance either reported a valid weight or had\nUNAVAILABLE_WEIGHT. Otherwise, Load Balancing remains equal-weight.\nThis option is only supported in Network Load Balancing.", + "Per-endpoint weighted round-robin Load Balancing using weights computed\nfrom Backend reported Custom Metrics. If set, the Backend Service\nresponses are expected to contain non-standard HTTP response header field\nEndpoint-Load-Metrics. The reported metrics\nto use for computing the weights are specified via the\ncustomMetrics fields." ], - "description": "Patches a rule of the specified priority." + "type": "string" + } + }, + "type": "object" + }, + "BackendServiceLogConfig": { + "description": "The available logging options for the load balancer traffic served by this\nbackend service.", + "id": "BackendServiceLogConfig", + "properties": { + "enable": { + "description": "Denotes whether to enable logging for the load balancer\ntraffic served by this backend service. The default value is false.", + "type": "boolean" }, - "patchPacketMirroringRule": { - "id": "compute.networkFirewallPolicies.patchPacketMirroringRule", - "path": "projects/{project}/global/firewallPolicies/{firewallPolicy}/patchPacketMirroringRule", - "flatPath": "projects/{project}/global/firewallPolicies/{firewallPolicy}/patchPacketMirroringRule", - "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" + "loggingHttpRequestHeaders": { + "description": "The list of request headers that will be logged to Stackdriver.", + "items": { + "$ref": "BackendServiceLogConfigLoggingHttpHeader" }, - "response": { - "$ref": "Operation" + "type": "array" + }, + "loggingHttpResponseHeaders": { + "description": "The list of response headers that will be logged to Stackdriver.", + "items": { + "$ref": "BackendServiceLogConfigLoggingHttpHeader" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Patches a packet mirroring rule of the specified priority." + "type": "array" }, - "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" - } + "optionalFields": { + "description": "This field can only be specified if logging is enabled for this backend\nservice and \"logConfig.optionalMode\" was set to CUSTOM. Contains a list\nof optional fields you want to include in the logs. For example:\nserverInstance, serverGkeDetails.cluster,\nserverGkeDetails.pod.podNamespace", + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "resource" + "type": "array" + }, + "optionalMode": { + "description": "This field can only be specified if logging is enabled for this backend\nservice. Configures whether all, none or a subset of optional fields\nshould be added to the reported logs. One of [INCLUDE_ALL_OPTIONAL,\nEXCLUDE_ALL_OPTIONAL, CUSTOM]. Default is EXCLUDE_ALL_OPTIONAL.", + "enum": [ + "CUSTOM", + "EXCLUDE_ALL_OPTIONAL", + "INCLUDE_ALL_OPTIONAL" ], - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "A subset of optional fields.", + "None optional fields.", + "All optional fields." ], - "description": "Gets the access control policy for a resource. May be empty if no such policy or resource exists." + "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" + "sampleRate": { + "description": "This field can only be specified if logging is enabled for this backend\nservice. The value of the field must be in [0, 1]. This configures the\nsampling rate of requests to the load balancer where 1.0 means all logged\nrequests are reported and 0.0 means no logged requests are reported. The\ndefault value is 1.0.", + "format": "float", + "type": "number" + } + }, + "type": "object" + }, + "BackendServiceLogConfigLoggingHttpHeader": { + "description": "Determines which HTTP headers will be logged to Stackdriver.", + "id": "BackendServiceLogConfigLoggingHttpHeader", + "properties": { + "headerName": { + "description": "The name of the header to be logged.", + "type": "string" + } + }, + "type": "object" + }, + "BackendServiceNetworkPassThroughLbTrafficPolicy": { + "id": "BackendServiceNetworkPassThroughLbTrafficPolicy", + "properties": { + "zonalAffinity": { + "$ref": "BackendServiceNetworkPassThroughLbTrafficPolicyZonalAffinity", + "description": "When configured, new connections are load balanced across healthy backend\nendpoints in the local zone." + } + }, + "type": "object" + }, + "BackendServiceNetworkPassThroughLbTrafficPolicyZonalAffinity": { + "id": "BackendServiceNetworkPassThroughLbTrafficPolicyZonalAffinity", + "properties": { + "spillover": { + "description": "This field indicates whether zonal affinity is enabled or not. The\npossible values are:\n \n - ZONAL_AFFINITY_DISABLED: Default Value. Zonal Affinity\n is disabled. The load balancer distributes new connections to all\n healthy backend endpoints across all zones.\n - ZONAL_AFFINITY_STAY_WITHIN_ZONE: Zonal Affinity is\n enabled. The load balancer distributes new connections to all healthy\n backend endpoints in the local zone only. If there are no healthy\n backend endpoints in the local zone, the load balancer distributes\n new connections to all backend endpoints in the local zone.\n - ZONAL_AFFINITY_SPILL_CROSS_ZONE: Zonal Affinity is\n enabled. The load balancer distributes new connections to all healthy\n backend endpoints in the local zone only. If there aren't enough\n healthy backend endpoints in the local zone, the load balancer\n distributes new connections to all healthy backend endpoints across all\n zones.", + "enum": [ + "ZONAL_AFFINITY_DISABLED", + "ZONAL_AFFINITY_SPILL_CROSS_ZONE", + "ZONAL_AFFINITY_STAY_WITHIN_ZONE" + ], + "enumDescriptions": [ + "", + "", + "" ], - "description": "Sets the access control policy on the specified resource. Replaces any existing policy." + "type": "string" }, - "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" - } + "spilloverRatio": { + "description": "The value of the field must be in [0, 1]. When the ratio of the count\nof healthy backend endpoints in a zone to the count of backend\nendpoints in that same zone is equal to or above this threshold, the\nload balancer distributes new connections to all healthy endpoints in\nthe local zone only. When the ratio of the count of healthy backend\nendpoints in a zone to the count of backend endpoints in that same\nzone is below this threshold, the load balancer distributes all new\nconnections to all healthy endpoints across all zones.", + "format": "float", + "type": "number" + } + }, + "type": "object" + }, + "BackendServiceOrchestrationInfo": { + "description": "A message containing information about the resource or system that manages\nthe backend service.", + "id": "BackendServiceOrchestrationInfo", + "properties": { + "resourceUri": { + "description": "The resource URI of the resource or system that manages the backend\nservice.", + "type": "string" + } + }, + "type": "object" + }, + "BackendServiceParams": { + "description": "Additional Backend Service parameters.", + "id": "BackendServiceParams", + "properties": { + "resourceManagerTags": { + "additionalProperties": { + "type": "string" }, - "parameterOrder": [ - "project", - "resource" - ], - "request": { - "$ref": "TestPermissionsRequest" + "description": "Tag keys/values directly bound to this resource.\nTag keys and values have the same definition as resource\nmanager tags. The field is allowed for INSERT\nonly. The keys/values to set on the resource should be specified in\neither ID { : } or Namespaced format\n{ : }.\nFor example the following are valid inputs:\n* {\"tagKeys/333\" : \"tagValues/444\", \"tagKeys/123\" : \"tagValues/456\"}\n* {\"123/environment\" : \"production\", \"345/abc\" : \"xyz\"}\nNote:\n* Invalid combinations of ID & namespaced format is not supported. For\n instance: {\"123/environment\" : \"tagValues/444\"} is invalid.", + "type": "object" + } + }, + "type": "object" + }, + "BackendServiceReference": { + "id": "BackendServiceReference", + "properties": { + "backendService": { + "type": "string" + } + }, + "type": "object" + }, + "BackendServiceTlsSettings": { + "id": "BackendServiceTlsSettings", + "properties": { + "authenticationConfig": { + "description": "Reference to the BackendAuthenticationConfig resource from the\nnetworksecurity.googleapis.com namespace. Can be used in authenticating\nTLS connections to the backend, as specified by the authenticationMode\nfield. Can only be specified if authenticationMode is not NONE.", + "type": "string" + }, + "identity": { + "description": "Assigns the Managed Identity for the BackendService Workload.\n\n\nUse this property to configure the load balancer back-end to use\ncertificates and roots of trust provisioned by the Managed Workload\nIdentity system. \n\n The `identity` property is the\nfully-specified SPIFFE ID to use in the SVID presented by the Load\nBalancer Workload. \n\n The SPIFFE ID must be a resource starting with the\n`trustDomain` property value, followed by the path to the Managed\nWorkload Identity. \n\n Supported SPIFFE ID format: \n \n - ///ns//sa/\n\n\nThe Trust Domain within the Managed Identity must refer to a valid\nWorkload Identity Pool. The TrustConfig and CertificateIssuanceConfig\nwill be inherited from the Workload Identity Pool. \n\n Restrictions: \n \n - If you set the `identity` property, you cannot manually set\n the following fields: \n - tlsSettings.sni\n - tlsSettings.subjectAltNames\n - tlsSettings.authenticationConfig\n \n\nWhen defining a `identity` for a RegionBackendServices, the\ncorresponding Workload Identity Pool must have a ca_pool\nconfigured in the same region. \n\n The system will set up a read-onlytlsSettings.authenticationConfig for the Managed Identity.", + "type": "string" + }, + "sni": { + "description": "Server Name Indication - see RFC3546 section 3.1. If set, the load\nbalancer sends this string as the SNI hostname in the TLS connection to\nthe backend, and requires that this string match a Subject Alternative\nName (SAN) in the backend's server certificate. With a Regional Internet\nNEG backend, if the SNI is specified here, the load balancer uses it\nregardless of whether the Regional Internet NEG is specified with FQDN or\nIP address and port. When both sni and subjectAltNames[] are specified,\nthe load balancer matches the backend certificate's SAN only to\nsubjectAltNames[].", + "type": "string" + }, + "subjectAltNames": { + "description": "A list of Subject Alternative Names (SANs) that the Load Balancer\nverifies during a TLS handshake with the backend. When the server\npresents its X.509 certificate to the Load Balancer, the Load Balancer\ninspects the certificate's SAN field, and requires that at least one SAN\nmatch one of the subjectAltNames in the list. This field is limited to 5\nentries. When both sni and subjectAltNames[] are specified, the load\nbalancer matches the backend certificate's SAN only to subjectAltNames[].", + "items": { + "$ref": "BackendServiceTlsSettingsSubjectAltName" }, - "response": { - "$ref": "TestPermissionsResponse" + "type": "array" + } + }, + "type": "object" + }, + "BackendServiceTlsSettingsSubjectAltName": { + "description": "A Subject Alternative Name that the load balancer matches against the SAN\nfield in the TLS certificate provided by the backend, specified as either\na DNS name or a URI, in accordance with RFC 5280 4.2.1.6", + "id": "BackendServiceTlsSettingsSubjectAltName", + "properties": { + "dnsName": { + "description": "The SAN specified as a DNS Name.", + "type": "string" + }, + "uniformResourceIdentifier": { + "description": "The SAN specified as a URI.", + "type": "string" + } + }, + "type": "object" + }, + "BackendServiceUsedBy": { + "id": "BackendServiceUsedBy", + "properties": { + "reference": { + "description": "Output only. [Output Only] Server-defined URL for resources referencing given\nBackendService like UrlMaps, TargetTcpProxies, TargetSslProxies\nand ForwardingRule.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "BackendServicesScopedList": { + "id": "BackendServicesScopedList", + "properties": { + "backendServices": { + "description": "A list of BackendServices contained in this scope.", + "items": { + "$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 permissions that a caller has on the specified resource." + "type": "array" }, - "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, + "warning": { + "description": "Informational warning which replaces the list of\nbackend services when the list is empty.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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" + "data": { + "description": "[Output Only] Metadata about this warning in key:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. 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" } }, - "parameterOrder": [ - "project", - "firewallPolicy" + "type": "object" + } + }, + "type": "object" + }, + "BfdPacket": { + "id": "BfdPacket", + "properties": { + "authenticationPresent": { + "description": "The Authentication Present bit of the BFD packet. This is specified in\nsection 4.1 ofRFC5880", + "type": "boolean" + }, + "controlPlaneIndependent": { + "description": "The Control Plane Independent bit of the BFD packet. This is specified in\nsection 4.1 ofRFC5880", + "type": "boolean" + }, + "demand": { + "description": "The demand bit of the BFD packet. This is specified in section 4.1 ofRFC5880", + "type": "boolean" + }, + "diagnostic": { + "description": "The diagnostic code specifies the local system's reason for the last change\nin session state. This allows remote systems to determine the reason that\nthe previous session failed, for example. These diagnostic codes are\nspecified in section 4.1 ofRFC5880", + "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" ], - "request": { - "$ref": "FirewallPolicyAssociation" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "", + "", + "", + "", + "", + "", + "", + "", + "", + "" ], - "description": "Inserts an association for the specified firewall policy." + "type": "string" }, - "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" + "final": { + "description": "The Final bit of the BFD packet. This is specified in section 4.1 ofRFC5880", + "type": "boolean" + }, + "length": { + "description": "The length of the BFD Control packet in bytes. This is specified in section\n4.1 ofRFC5880", + "format": "uint32", + "type": "integer" + }, + "minEchoRxIntervalMs": { + "description": "The Required Min Echo RX Interval value in the BFD packet. This is\nspecified in section 4.1 ofRFC5880", + "format": "uint32", + "type": "integer" + }, + "minRxIntervalMs": { + "description": "The Required Min RX Interval value in the BFD packet. This is specified in\nsection 4.1 ofRFC5880", + "format": "uint32", + "type": "integer" + }, + "minTxIntervalMs": { + "description": "The Desired Min TX Interval value in the BFD packet. This is specified in\nsection 4.1 ofRFC5880", + "format": "uint32", + "type": "integer" + }, + "multiplier": { + "description": "The detection time multiplier of the BFD packet. This is specified in\nsection 4.1 ofRFC5880", + "format": "uint32", + "type": "integer" + }, + "multipoint": { + "description": "The multipoint bit of the BFD packet. This is specified in section 4.1 ofRFC5880", + "type": "boolean" + }, + "myDiscriminator": { + "description": "The My Discriminator value in the BFD packet. This is specified in section\n4.1 ofRFC5880", + "format": "uint32", + "type": "integer" + }, + "poll": { + "description": "The Poll bit of the BFD packet. This is specified in section 4.1 ofRFC5880", + "type": "boolean" + }, + "state": { + "description": "The current BFD session state as seen by the transmitting system. These\nstates are specified in section 4.1 ofRFC5880", + "enum": [ + "ADMIN_DOWN", + "DOWN", + "INIT", + "STATE_UNSPECIFIED", + "UP" ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "", + "", + "", + "", + "" ], - "description": "Removes an association for the specified firewall policy." + "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" + "version": { + "description": "The version number of the BFD protocol, as specified in section 4.1 ofRFC5880.", + "format": "uint32", + "type": "integer" + }, + "yourDiscriminator": { + "description": "The Your Discriminator value in the BFD packet. This is specified in\nsection 4.1 ofRFC5880", + "format": "uint32", + "type": "integer" + } + }, + "type": "object" + }, + "BfdStatus": { + "description": "Next free: 15", + "id": "BfdStatus", + "properties": { + "bfdSessionInitializationMode": { + "description": "The BFD session initialization mode for this BGP peer.\nIf set to ACTIVE, the Cloud Router will initiate the BFD session for\nthis BGP peer. If set to PASSIVE, the Cloud Router will wait for the\npeer router to initiate the BFD session for this BGP peer. If set to\nDISABLED, BFD is disabled for this BGP peer.", + "enum": [ + "ACTIVE", + "DISABLED", + "PASSIVE" ], - "response": { - "$ref": "FirewallPolicyAssociation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "", + "", + "" ], - "description": "Gets an association with the specified name." + "type": "string" }, - "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" - } + "configUpdateTimestampMicros": { + "description": "Unix timestamp of the most recent config update.", + "format": "int64", + "type": "string" + }, + "controlPacketCounts": { + "$ref": "BfdStatusPacketCounts", + "description": "Control packet counts for the current BFD session." + }, + "controlPacketIntervals": { + "description": "Inter-packet time interval statistics for control packets.", + "items": { + "$ref": "PacketIntervals" }, - "parameterOrder": [ - "project", - "firewallPolicy" + "type": "array" + }, + "localDiagnostic": { + "description": "The diagnostic code specifies the local system's reason for the last change\nin session state. This allows remote systems to determine the reason that\nthe previous session failed, for example. These diagnostic codes are\nspecified in section 4.1 ofRFC5880", + "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" ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "", + "", + "", + "", + "", + "", + "", + "", + "", + "" ], - "description": "Copies rules to the specified firewall policy." + "type": "string" }, - "aggregatedList": { - "id": "compute.networkFirewallPolicies.aggregatedList", - "path": "projects/{project}/aggregated/firewallPolicies", - "flatPath": "projects/{project}/aggregated/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" - }, - "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" + "localState": { + "description": "The current BFD session state as seen by the transmitting system. These\nstates are specified in section 4.1 ofRFC5880", + "enum": [ + "ADMIN_DOWN", + "DOWN", + "INIT", + "STATE_UNSPECIFIED", + "UP" ], - "response": { - "$ref": "NetworkFirewallPolicyAggregatedList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "", + "", + "", + "", + "" ], - "description": "Retrieves an aggregated list of network firewall policies, listing network firewall policies from all applicable scopes (global and regional) and grouping the results per scope. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." + "type": "string" + }, + "negotiatedLocalControlTxIntervalMs": { + "description": "Negotiated transmit interval for control packets.", + "format": "uint32", + "type": "integer" + }, + "rxPacket": { + "$ref": "BfdPacket", + "description": "The most recent Rx control packet for this BFD session." + }, + "txPacket": { + "$ref": "BfdPacket", + "description": "The most recent Tx control packet for this BFD session." + }, + "uptimeMs": { + "description": "Session uptime in milliseconds. Value will be 0 if session is not up.", + "format": "int64", + "type": "string" } - } + }, + "type": "object" }, - "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" + "BfdStatusPacketCounts": { + "id": "BfdStatusPacketCounts", + "properties": { + "numRx": { + "description": "Number of packets received since the beginning of the current BFD\nsession.", + "format": "uint32", + "type": "integer" + }, + "numRxRejected": { + "description": "Number of packets received that were rejected because of errors since the\nbeginning of the current BFD session.", + "format": "uint32", + "type": "integer" + }, + "numRxSuccessful": { + "description": "Number of packets received that were successfully processed since the\nbeginning of the current BFD session.", + "format": "uint32", + "type": "integer" + }, + "numTx": { + "description": "Number of packets transmitted since the beginning of the current BFD\nsession.", + "format": "uint32", + "type": "integer" + } + }, + "type": "object" + }, + "BgpRoute": { + "id": "BgpRoute", + "properties": { + "asPaths": { + "description": "Output only. [Output only] AS-PATH for the route", + "items": { + "$ref": "BgpRouteAsPath" }, - "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." + "readOnly": true, + "type": "array" }, - "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" - } + "communities": { + "description": "Output only. [Output only] BGP communities in human-readable A:B format.", + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "region", - "firewallPolicy" + "readOnly": true, + "type": "array" + }, + "destination": { + "$ref": "BgpRouteNetworkLayerReachabilityInformation", + "description": "Output only. [Output only] Destination IP range for the route, in human-readable CIDR\nformat", + "readOnly": true + }, + "med": { + "description": "Output only. [Output only] BGP multi-exit discriminator", + "format": "uint32", + "readOnly": true, + "type": "integer" + }, + "origin": { + "description": "Output only. [Output only] BGP origin (EGP, IGP or INCOMPLETE)", + "enum": [ + "BGP_ORIGIN_EGP", + "BGP_ORIGIN_IGP", + "BGP_ORIGIN_INCOMPLETE" ], - "response": { - "$ref": "FirewallPolicy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "", + "", + "" ], - "description": "Returns the specified network firewall policy." + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "BgpRouteAsPath": { + "id": "BgpRouteAsPath", + "properties": { + "asns": { + "description": "Output only. [Output only] ASNs in the path segment. When type is SEQUENCE, these are\nordered.", + "items": { + "format": "int32", + "type": "integer" + }, + "readOnly": true, + "type": "array" }, - "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" - } + "asns32": { + "description": "Output only. [Output only] ASNs in the path segment. This field is for better\nsupport of 32 bit ASNs as the other asns field suffers from overflow when\nthe ASN is larger. When type is SEQUENCE, these are ordered.", + "items": { + "format": "uint32", + "type": "integer" }, - "parameterOrder": [ - "project", - "region" + "readOnly": true, + "type": "array" + }, + "type": { + "description": "Output only. [Output only] Type of AS-PATH segment (SEQUENCE or SET)", + "enum": [ + "AS_PATH_TYPE_SEQUENCE", + "AS_PATH_TYPE_SET" ], - "request": { - "$ref": "FirewallPolicy" + "enumDescriptions": [ + "", + "" + ], + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "BgpRouteNetworkLayerReachabilityInformation": { + "description": "Network Layer Reachability Information (NLRI) for a route.", + "id": "BgpRouteNetworkLayerReachabilityInformation", + "properties": { + "pathId": { + "description": "If the BGP session supports multiple paths (RFC 7911), the path\nidentifier for this route.", + "format": "uint32", + "type": "integer" + }, + "prefix": { + "description": "Human readable CIDR notation for a prefix. E.g. 10.42.0.0/16.", + "type": "string" + } + }, + "type": "object" + }, + "Binding": { + "description": "Associates `members`, or principals, with a `role`.", + "id": "Binding", + "properties": { + "condition": { + "$ref": "Expr", + "description": "The condition that is associated with this binding.\n\nIf the condition evaluates to `true`, then this binding applies to the\ncurrent request.\n\nIf the condition evaluates to `false`, then this binding does not apply to\nthe current request. However, a different role binding might grant the same\nrole to one or more of the principals in this binding.\n\nTo learn which resources support conditions in their IAM policies, see the\n[IAM\ndocumentation](https://cloud.google.com/iam/help/conditions/resource-policies)." + }, + "members": { + "description": "Specifies the principals requesting access for a Google Cloud resource.\n`members` can have the following values:\n\n* `allUsers`: A special identifier that represents anyone who is\n on the internet; with or without a Google account.\n\n* `allAuthenticatedUsers`: A special identifier that represents anyone\n who is authenticated with a Google account or a service account.\n Does not include identities that come from external identity providers\n (IdPs) through identity federation.\n\n* `user:{emailid}`: An email address that represents a specific Google\n account. For example, `alice@example.com` .\n\n\n* `serviceAccount:{emailid}`: An email address that represents a Google\n service account. For example,\n `my-other-app@appspot.gserviceaccount.com`.\n\n* `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An\n identifier for a\n [Kubernetes service\n account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts).\n For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`.\n\n* `group:{emailid}`: An email address that represents a Google group.\n For example, `admins@example.com`.\n\n\n* `domain:{domain}`: The G Suite domain (primary) that represents all the\n users of that domain. For example, `google.com` or `example.com`.\n\n\n\n\n* `principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`:\n A single identity in a workforce identity pool.\n\n* `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/group/{group_id}`:\n All workforce identities in a group.\n\n* `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/attribute.{attribute_name}/{attribute_value}`:\n All workforce identities with a specific attribute value.\n\n* `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/*`:\n All identities in a workforce identity pool.\n\n* `principal://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/subject/{subject_attribute_value}`:\n A single identity in a workload identity pool.\n\n* `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/group/{group_id}`:\n A workload identity pool group.\n\n* `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/attribute.{attribute_name}/{attribute_value}`:\n All identities in a workload identity pool with a certain attribute.\n\n* `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/*`:\n All identities in a workload identity pool.\n\n* `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique\n identifier) representing a user that has been recently deleted. For\n example, `alice@example.com?uid=123456789012345678901`. If the user is\n recovered, this value reverts to `user:{emailid}` and the recovered user\n retains the role in the binding.\n\n* `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus\n unique identifier) representing a service account that has been recently\n deleted. For example,\n `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`.\n If the service account is undeleted, this value reverts to\n `serviceAccount:{emailid}` and the undeleted service account retains the\n role in the binding.\n\n* `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique\n identifier) representing a Google group that has been recently\n deleted. For example, `admins@example.com?uid=123456789012345678901`. If\n the group is recovered, this value reverts to `group:{emailid}` and the\n recovered group retains the role in the binding.\n\n* `deleted:principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`:\n Deleted single identity in a workforce identity pool. For example,\n `deleted:principal://iam.googleapis.com/locations/global/workforcePools/my-pool-id/subject/my-subject-attribute-value`.", + "items": { + "type": "string" }, - "response": { - "$ref": "Operation" + "type": "array" + }, + "role": { + "description": "Role that is assigned to the list of `members`, or principals.\nFor example, `roles/viewer`, `roles/editor`, or `roles/owner`.\n\nFor an overview of the IAM roles and permissions, see the\n[IAM documentation](https://cloud.google.com/iam/docs/roles-overview). For\na list of the available pre-defined roles, see\n[here](https://cloud.google.com/iam/docs/understanding-roles).", + "type": "string" + } + }, + "type": "object" + }, + "BulkInsertDiskResource": { + "description": "A transient resource used in compute.disks.bulkInsert and\ncompute.regionDisks.bulkInsert. It is only used to process\nrequests and is not persisted.", + "id": "BulkInsertDiskResource", + "properties": { + "instantSnapshotGroupParameters": { + "$ref": "InstantSnapshotGroupParameters", + "description": "The parameters for the instant snapshot group." + }, + "snapshotGroupParameters": { + "$ref": "SnapshotGroupParameters", + "description": "The parameters for the snapshot group. The usage of snapshot group feature\nis restricted." + }, + "sourceConsistencyGroupPolicy": { + "description": "The URL of the DiskConsistencyGroupPolicy for the group of disks to clone.\nThis may be a full or partial URL, such as:\n \n \n - \n https://www.googleapis.com/compute/v1/projects/project/regions/region/resourcePolicies/resourcePolicy\n \n - \n projects/project/regions/region/resourcePolicies/resourcePolicy\n \n - \n regions/region/resourcePolicies/resourcePolicy", + "type": "string" + } + }, + "type": "object" + }, + "BulkInsertInstanceResource": { + "description": "A transient resource used in compute.instances.bulkInsert and\ncompute.regionInstances.bulkInsert . This resource is not persisted\nanywhere, it is used only for processing the requests.", + "id": "BulkInsertInstanceResource", + "properties": { + "count": { + "description": "The maximum number of instances to create.", + "format": "int64", + "type": "string" + }, + "instanceFlexibilityPolicy": { + "$ref": "InstanceFlexibilityPolicy", + "description": "A flexible specification of machine type of instances to create." + }, + "instanceProperties": { + "$ref": "InstanceProperties", + "description": "The instance properties defining the VM instances to be created. Required\nif sourceInstanceTemplate is not provided." + }, + "locationPolicy": { + "$ref": "LocationPolicy", + "description": "Policy for choosing target zone. For more information, seeCreate VMs in\nbulk." + }, + "minCount": { + "description": "The minimum number of instances to create. If no min_count is\nspecified then count is used as the default value. Ifmin_count instances cannot be created, then no instances will\nbe created and instances already created will be deleted.", + "format": "int64", + "type": "string" + }, + "namePattern": { + "description": "The string pattern used for the names of the VMs.\nEither name_pattern or per_instance_properties\nmust be set. The pattern must contain one continuous sequence of\nplaceholder hash characters (#) with each character corresponding to one\ndigit of the generated instance name. Example: a name_pattern\nof inst-#### generates instance names such asinst-0001 and inst-0002. If existing instances\nin the same project and zone have names that match the name pattern\nthen the generated instance numbers start after the biggest\nexisting number. For example, if there exists an instance with nameinst-0050, then instance names generated using the patterninst-#### begin with inst-0051. The name pattern\nplaceholder #...# can contain up to 18 characters.", + "type": "string" + }, + "perInstanceProperties": { + "additionalProperties": { + "$ref": "BulkInsertInstanceResourcePerInstanceProperties" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "description": "Per-instance properties to be set on individual instances.\nKeys of this map specify requested instance names.\nCan be empty if name_pattern is used.", + "type": "object" + }, + "sourceInstanceTemplate": { + "description": "Specifies the instance template from which to create instances. You may\ncombine sourceInstanceTemplate withinstanceProperties to override specific values from an\nexisting instance template. Bulk API follows the semantics of JSON Merge\nPatch described by RFC\n7396.\n\nIt can be a full or partial URL. For example, the following are\nall valid URLs to an instance template: \n \n \n - https://www.googleapis.com/compute/v1/projects/project/global/instanceTemplates/instanceTemplate\n - projects/project/global/instanceTemplates/instanceTemplate\n - global/instanceTemplates/instanceTemplate\n\n\n\nThis field is optional.", + "type": "string" + } + }, + "type": "object" + }, + "BulkInsertInstanceResourcePerInstanceProperties": { + "description": "Per-instance properties to be set on individual instances.\nTo be extended in the future.", + "id": "BulkInsertInstanceResourcePerInstanceProperties", + "properties": { + "hostname": { + "description": "Specifies the hostname of the instance. More details in:\nhttps://cloud.google.com/compute/docs/instances/custom-hostname-vm#naming_convention", + "type": "string" + }, + "name": { + "description": "Output only. This field is only temporary. It will be removed. Do not use it.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "BulkInsertOperationStatus": { + "id": "BulkInsertOperationStatus", + "properties": { + "createdVmCount": { + "description": "[Output Only] Count of VMs successfully created so far.", + "format": "int32", + "type": "integer" + }, + "deletedVmCount": { + "description": "[Output Only] Count of VMs that got deleted during rollback.", + "format": "int32", + "type": "integer" + }, + "failedToCreateVmCount": { + "description": "[Output Only] Count of VMs that started creating but encountered an\nerror.", + "format": "int32", + "type": "integer" + }, + "status": { + "description": "[Output Only] Creation status of BulkInsert operation - information\nif the flow is rolling forward or rolling back.", + "enum": [ + "CREATING", + "DONE", + "ROLLING_BACK", + "STATUS_UNSPECIFIED" + ], + "enumDescriptions": [ + "Rolling forward - creating VMs.", + "Done", + "Rolling back - cleaning up after an error.", + "" ], - "description": "Creates a new network firewall policy in the specified project and region." + "type": "string" }, - "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" - } + "targetVmCount": { + "description": "[Output Only] Count of VMs originally planned to be created.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, + "BulkSetLabelsRequest": { + "id": "BulkSetLabelsRequest", + "properties": { + "labelFingerprint": { + "description": "The fingerprint of the previous set of labels for this resource,\nused to detect conflicts. The fingerprint is initially generated by Compute\nEngine and changes after every request to modify or update labels. You may\noptionally provide an up-to-date fingerprint hash in order to update or\nchange labels. Make a get() request to the resource to get the\nlatest fingerprint.", + "format": "byte", + "type": "string" + }, + "labels": { + "additionalProperties": { + "type": "string" }, - "parameterOrder": [ - "project", - "region", - "firewallPolicy" - ], - "response": { - "$ref": "Operation" + "description": "The labels to set for this resource.", + "type": "object" + } + }, + "type": "object" + }, + "BulkZoneSetLabelsRequest": { + "id": "BulkZoneSetLabelsRequest", + "properties": { + "requests": { + "items": { + "$ref": "BulkSetLabelsRequest" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified network firewall policy." + "type": "array" + } + }, + "type": "object" + }, + "BundledLocalSsds": { + "id": "BundledLocalSsds", + "properties": { + "defaultInterface": { + "description": "The default disk interface if the interface is not specified.", + "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" - } + "partitionCount": { + "description": "The number of partitions.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, + "CacheInvalidationRule": { + "id": "CacheInvalidationRule", + "properties": { + "cacheTags": { + "description": "A list of cache tags used to identify cached objects.\n\n \n - Cache tags are specified when the response is first cached, by setting\n the `Cache-Tag` response header at the origin.\n - Multiple cache tags in the same invalidation request are treated as\n Boolean `OR` - for example, `tag1 OR tag2 OR tag3`.\n - If other fields are also specified, these are treated as Boolean `AND`\n with any tags.\n\n\nUp to 10 tags can be specified in a single invalidation request.", + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "region", - "firewallPolicy" - ], - "request": { - "$ref": "FirewallPolicy" + "type": "array" + }, + "host": { + "description": "If set, this invalidation rule will only apply to requests with a Host\nheader matching host.", + "type": "string" + }, + "path": { + "type": "string" + } + }, + "type": "object" + }, + "CacheKeyPolicy": { + "description": "Message containing what to include in the cache key for a request for Cloud\nCDN.", + "id": "CacheKeyPolicy", + "properties": { + "includeHost": { + "description": "If true, requests to different hosts will be cached separately.", + "type": "boolean" + }, + "includeHttpHeaders": { + "description": "Allows HTTP request headers (by name) to be used in the cache key.", + "items": { + "type": "string" }, - "response": { - "$ref": "Operation" + "type": "array" + }, + "includeNamedCookies": { + "description": "Allows HTTP cookies (by name) to be used in the cache key.\nThe name=value pair will be used in the cache key Cloud CDN generates.", + "items": { + "type": "string" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Patches the specified network firewall policy." + "type": "array" }, - "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" - } + "includeProtocol": { + "description": "If true, http and https requests will be cached separately.", + "type": "boolean" + }, + "includeQueryString": { + "description": "If true, include query string parameters in the cache key according to\nquery_string_whitelist and query_string_blacklist. If neither is set, the\nentire query string will be included. If false, the query string will be\nexcluded from the cache key entirely.", + "type": "boolean" + }, + "queryStringBlacklist": { + "description": "Names of query string parameters to exclude in cache keys. All other\nparameters will be included. Either specify query_string_whitelist or\nquery_string_blacklist, not both. '&' and '=' will be percent encoded and\nnot treated as delimiters.", + "items": { + "type": "string" + }, + "type": "array" + }, + "queryStringWhitelist": { + "description": "Names of query string parameters to include in cache keys. All other\nparameters will be excluded. Either specify query_string_whitelist or\nquery_string_blacklist, not both. '&' and '=' will be percent encoded and\nnot treated as delimiters.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, + "CachePolicy": { + "description": "Message containing CachePolicy configuration for URL Map's Route Action.", + "id": "CachePolicy", + "properties": { + "cacheBypassRequestHeaderNames": { + "description": "Bypass the cache when the specified request headers are matched by name,\ne.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5\nheader names can be specified. The cache is bypassed for all `cacheMode`\nvalues.", + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "region", - "firewallPolicy" + "type": "array" + }, + "cacheKeyPolicy": { + "$ref": "CachePolicyCacheKeyPolicy", + "description": "The cache key configuration. If not specified, the default behavior depends\non the backend type: for Backend Services, the complete request URI is\nused; for Backend Buckets, the request URI is used without the protocol or\nhost, and only query parameters known to Cloud Storage are included." + }, + "cacheMode": { + "description": "Specifies the cache setting for all responses from this route. If not\nspecified, Cloud CDN uses `CACHE_ALL_STATIC` mode.", + "enum": [ + "CACHE_ALL_STATIC", + "FORCE_CACHE_ALL", + "USE_ORIGIN_HEADERS" ], - "response": { - "$ref": "FirewallPolicyRule" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "Automatically cache static content, including common image formats,\nmedia (video and audio), and web assets (JavaScript and CSS).\nRequests and responses that are marked as uncacheable, as well as\ndynamic content (including HTML), will not be cached.", + "Cache all content, ignoring any \"private\", \"no-store\" or \"no-cache\"\ndirectives in Cache-Control response headers.\nWarning: this may result in Cloud CDN caching private,\nper-user (user identifiable) content.", + "Requires the origin to set valid caching headers to cache content.\nResponses without these headers will not be cached at the edge, and will\nrequire a full trip to the origin on every request, potentially impacting\nperformance and increasing load on the origin server." ], - "description": "Gets a rule of the specified priority." + "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" - } + "clientTtl": { + "$ref": "Duration", + "description": "Specifies a separate client (e.g. browser client) maximum TTL for cached\ncontent. This is used to clamp the max-age (or Expires) value sent to the\nclient. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`\nis used for the response max-age directive, along with a \"public\"\ndirective. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`\nclamps the max-age from the origin (if specified), or else sets the\nresponse max-age directive to the lesser of the `clientTtl` and\n`defaultTtl`, and also ensures a \"public\" cache-control directive is\npresent. The maximum allowed value is 31,622,400s (1 year). If not\nspecified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.\nCannot exceed `maxTtl`. Cannot be specified when `cacheMode` is\n`USE_ORIGIN_HEADERS`." + }, + "defaultTtl": { + "$ref": "Duration", + "description": "Specifies the default TTL for cached content for responses that do not have\nan existing valid TTL (max-age or s-maxage). Setting a TTL of \"0\" means\n\"always revalidate\". The value of `defaultTtl` cannot be set to a value\ngreater than that of `maxTtl`. When the `cacheMode` is set to\n`FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all\nresponses. The maximum allowed value is 31,622,400s (1 year). Infrequently\naccessed objects may be evicted from the cache before the defined TTL. If\nnot specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and\n`FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is\n`USE_ORIGIN_HEADERS`." + }, + "maxTtl": { + "$ref": "Duration", + "description": "Specifies the maximum allowed TTL for cached content. Cache directives that\nattempt to set a max-age or s-maxage higher than this, or an Expires header\nmore than `maxTtl` seconds in the future will be capped at the value of\n`maxTtl`, as if it were the value of an s-maxage Cache-Control directive.\nHeaders sent to the client will not be modified. Setting a TTL of \"0\" means\n\"always revalidate\". The maximum allowed value is 31,622,400s (1 year).\nInfrequently accessed objects may be evicted from the cache before the\ndefined TTL. If not specified, Cloud CDN uses 86400s (1 day) for\n`CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache\nmode." + }, + "negativeCaching": { + "description": "Negative caching allows per-status code TTLs to be set, in order\nto apply fine-grained caching for common errors or redirects.\nThis can reduce the load on your origin and improve end-user\nexperience by reducing response latency.\nWhen the `cacheMode` is set to `CACHE_ALL_STATIC` or\n`USE_ORIGIN_HEADERS`, negative caching applies to responses with\nthe specified response code that lack any Cache-Control, Expires, or\nPragma: no-cache directives. When the `cacheMode` is set to\n`FORCE_CACHE_ALL`, negative caching applies to all responses\nwith the specified response code, and overrides any caching headers. By\ndefault, Cloud CDN applies the following TTLs to these HTTP status codes:\n\n* 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m\n* 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s\n* 405 (Method Not Found), 501 (Not Implemented): 60s\n\nThese defaults can be overridden in `negativeCachingPolicy`.\nIf not specified, Cloud CDN applies negative caching by default.", + "type": "boolean" + }, + "negativeCachingPolicy": { + "description": "Sets a cache TTL for the specified HTTP status code.\n`negativeCaching` must be enabled to configure `negativeCachingPolicy`.\nOmitting the policy and leaving `negativeCaching` enabled will use Cloud\nCDN's default cache TTLs. Note that when specifying an explicit\n`negativeCachingPolicy`, you should take care to specify a cache TTL for\nall response codes that you wish to cache. Cloud CDN will not apply any\ndefault negative caching when a policy exists.", + "items": { + "$ref": "CachePolicyNegativeCachingPolicy" }, - "parameterOrder": [ - "project", - "region", - "firewallPolicy" - ], - "request": { - "$ref": "FirewallPolicyRule" + "type": "array" + }, + "requestCoalescing": { + "description": "If true then Cloud CDN will combine multiple concurrent cache fill\nrequests into a small number of requests to the origin. If not specified,\nCloud CDN applies request coalescing by default.", + "type": "boolean" + }, + "serveWhileStale": { + "$ref": "Duration", + "description": "Serve existing content from the cache (if available) when revalidating\ncontent with the origin, or when an error is encountered when refreshing\nthe cache.\nThis setting defines the default \"max-stale\" duration for any cached\nresponses that do not specify a max-stale directive. Stale responses that\nexceed the TTL configured here will not be served. The default limit\n(max-stale) is 86400s (1 day), which will allow stale content to be\nserved up to this limit beyond the max-age (or s-maxage) of a cached\nresponse.\nThe maximum allowed value is 604800 (1 week).\nSet this to zero (0) to disable serve-while-stale." + } + }, + "type": "object" + }, + "CachePolicyCacheKeyPolicy": { + "description": "Message containing what to include in the cache key for a request for Cache\nPolicy defined on Route Action.", + "id": "CachePolicyCacheKeyPolicy", + "properties": { + "excludedQueryParameters": { + "description": "Names of query string parameters to exclude in cache keys. All other\nparameters will be included. Either specify `excludedQueryParameters`\nor `includedQueryParameters`, not both. '&' and '=' will be percent\nencoded and not treated as delimiters.\n\nNote: This field applies to routes that use backend services. Attempting\nto set it on a route that points exclusively to Backend Buckets will\nresult in a configuration error. For routes that point to a Backend\nBucket, use `includedQueryParameters` to define which parameters should\nbe part of the cache key.", + "items": { + "type": "string" }, - "response": { - "$ref": "Operation" + "type": "array" + }, + "includeHost": { + "description": "If true, requests to different hosts will be cached separately.\n\nNote: This setting is only applicable to routes that use a Backend\nService. It does not affect requests served by a Backend Bucket, as the\nhost is never included in a Backend Bucket's cache key. Attempting to set\nit on a route that points exclusively to Backend Buckets will result in a\nconfiguration error.", + "type": "boolean" + }, + "includeProtocol": { + "description": "If true, http and https requests will be cached separately.\n\nNote: This setting is only applicable to routes that use a Backend\nService. It does not affect requests served by a Backend Bucket, as the\nprotocol is never included in a Backend Bucket's cache key. Attempting to\nset on a route that points exclusively to Backend Buckets will result in\na configuration error.", + "type": "boolean" + }, + "includeQueryString": { + "description": "If true, include query string parameters in the cache key according to\n`includedQueryParameters` and `excludedQueryParameters`. If neither\nis set, the entire query string will be included. If false, the query\nstring will be excluded from the cache key entirely.\n\nNote: This field applies to routes that use backend services. Attempting\nto set it on a route that points exclusively to Backend Buckets will\nresult in a configuration error. For routes that point to a Backend\nBucket, use `includedQueryParameters` to define which parameters should\nbe part of the cache key.", + "type": "boolean" + }, + "includedCookieNames": { + "description": "Allows HTTP cookies (by name) to be used in the cache key.\nThe name=value pair will be used in the cache key Cloud CDN generates.\n\nNote: This setting is only applicable to routes that use a Backend\nService. It does not affect requests served by a Backend Bucket.\nAttempting to set it on a route that points exclusively to Backend\nBuckets will result in a configuration error. Up to 5 cookie names can be\nspecified.", + "items": { + "type": "string" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Inserts a rule into a network firewall policy." + "type": "array" }, - "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" - } + "includedHeaderNames": { + "description": "Allows HTTP request headers (by name) to be used in the cache key.", + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "region", - "firewallPolicy" - ], - "response": { - "$ref": "Operation" + "type": "array" + }, + "includedQueryParameters": { + "description": "Names of query string parameters to include in cache keys. All other\nparameters will be excluded. Either specify `includedQueryParameters`\nor `excludedQueryParameters`, not both. '&' and '=' will be percent\nencoded and not treated as delimiters.", + "items": { + "type": "string" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes a rule of the specified priority." + "type": "array" + } + }, + "type": "object" + }, + "CachePolicyNegativeCachingPolicy": { + "description": "Specify CDN TTLs for response error codes.", + "id": "CachePolicyNegativeCachingPolicy", + "properties": { + "code": { + "description": "The HTTP status code to define a TTL against. Only HTTP status codes\n300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be\nspecified as values, and you cannot specify a status code more than\nonce.", + "format": "int32", + "type": "integer" }, - "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" - } + "ttl": { + "$ref": "Duration", + "description": "The TTL (in seconds) for which to cache responses with the\ncorresponding status code.\nThe maximum allowed value is 1800s (30 minutes). Infrequently accessed\nobjects may be evicted from the cache before the defined TTL." + } + }, + "type": "object" + }, + "CalendarModeAdviceRequest": { + "description": "A request to recommend the best way to consume the specified resources in the\nfuture.", + "id": "CalendarModeAdviceRequest", + "properties": { + "futureResourcesSpecs": { + "additionalProperties": { + "$ref": "FutureResourcesSpec" }, - "parameterOrder": [ - "project", - "region", - "firewallPolicy" - ], - "request": { - "$ref": "FirewallPolicyRule" + "description": "Specification of resources to create in the future.\nThe key of the map is an arbitrary string specified by the caller.\nValue of the map is a specification of required resources and their\nconstraints. Currently only one value is allowed in this map.", + "type": "object" + } + }, + "type": "object" + }, + "CalendarModeAdviceResponse": { + "description": "A response containing the recommended way of creating the specified resources\nin the future. It contains (will contain) multiple recommendations that can\nbe analyzed by the customer and the best one can be picked.", + "id": "CalendarModeAdviceResponse", + "properties": { + "recommendations": { + "description": "Recommendations where, how and when to create the requested resources\nin order to maximize their obtainability and minimize cost.", + "items": { + "$ref": "CalendarModeRecommendation" }, - "response": { - "$ref": "Operation" + "type": "array" + } + }, + "type": "object" + }, + "CalendarModeRecommendation": { + "description": "A single recommendation to create requested resources. Contains detailed\nrecommendations for every future resources specification specified in\nCalendarModeAdviceRequest.", + "id": "CalendarModeRecommendation", + "properties": { + "recommendationsPerSpec": { + "additionalProperties": { + "$ref": "FutureResourcesRecommendation" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "description": "Recommendations for every future resource specification passed in\nCalendarModeAdviceRequest. Keys of the map correspond to keys\nspecified in the request.", + "type": "object" + } + }, + "type": "object" + }, + "CircuitBreakers": { + "description": "Settings controlling the volume of requests, connections and retries to this\nbackend service.", + "id": "CircuitBreakers", + "properties": { + "maxConnections": { + "description": "The maximum number of connections to the backend service. If not specified,\nthere is no limit.\n\nNot supported when the backend service is referenced by a URL map that is\nbound to target gRPC proxy that has validateForProxyless field set to true.", + "format": "int32", + "type": "integer" + }, + "maxPendingRequests": { + "description": "The maximum number of pending requests allowed to the backend service. If\nnot specified, there is no limit.\n\nNot supported when the backend service is referenced by a URL map that is\nbound to target gRPC proxy that has validateForProxyless field set to true.", + "format": "int32", + "type": "integer" + }, + "maxRequests": { + "description": "The maximum number of parallel requests that allowed to the backend\nservice. If not specified, there is no limit.", + "format": "int32", + "type": "integer" + }, + "maxRequestsPerConnection": { + "description": "Maximum requests for a single connection to the backend service.\nThis parameter is respected by both the HTTP/1.1 and HTTP/2\nimplementations. If not specified, there is no limit. Setting this\nparameter to 1 will effectively disable keep alive.\n\nNot supported when the backend service is referenced by a URL map that is\nbound to target gRPC proxy that has validateForProxyless field set to true.", + "format": "int32", + "type": "integer" + }, + "maxRetries": { + "description": "The maximum number of parallel retries allowed to the backend cluster. If\nnot specified, the default is 1.\n\nNot supported when the backend service is referenced by a URL map that is\nbound to target gRPC proxy that has validateForProxyless field set to true.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, + "Commitment": { + "description": "Represents a regional resource-based commitment resource.\n\nCreating this commitment resource means that you are purchasing a\nresource-based committed use contract, with an explicit start and end time.\nYou can purchase resource-based commitments for both hardware and software\nresources. For more information, read\nResource-based committed use discounts", + "id": "Commitment", + "properties": { + "autoRenew": { + "description": "Specifies whether to automatically renew the commitment at the end of its\ncurrent term. The default value is false. If you set the field\nto true, each time your commitment reaches the end of its\nterm, Compute Engine automatically renews it for another term. You can\nupdate this field anytime before the commitment expires. For example, if\nthe commitment is set to expire at 12 AM UTC-8 on January 3, 2027, you can\nupdate this field until 11:59 PM UTC-8 on January 2, 2027.", + "type": "boolean" + }, + "category": { + "description": "The category of the commitment; specifies whether the commitment is for\nhardware or software resources. Category MACHINE specifies\nthat you are committing to hardware machine resources such asVCPU or MEMORY, listed in resources.\nCategory LICENSE specifies that you are committing to software\nlicenses, listed in licenseResources.\nNote that if you specify MACHINE commitments, then you must\nalso specify a type to indicate the machine series of the\nhardware resource that you are committing to.", + "enum": [ + "CATEGORY_UNSPECIFIED", + "LICENSE", + "MACHINE" + ], + "enumDescriptions": [ + "", + "", + "" ], - "description": "Patches a rule of the specified priority." + "type": "string" }, - "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" - } + "creationTimestamp": { + "description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", + "readOnly": true, + "type": "string" + }, + "customEndTimestamp": { + "description": "[Input Only] Optional, specifies the requested commitment end time inRFC3339 text format. Use this option when the desired\ncommitment's end date is later than the start date + term duration.", + "type": "string" + }, + "description": { + "description": "An optional description of the commitment. You can provide this property\nwhen you create the resource.", + "type": "string" + }, + "endTimestamp": { + "description": "Output only. [Output Only] Commitment end time inRFC3339\ntext format.", + "readOnly": true, + "type": "string" + }, + "existingReservations": { + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "region", - "firewallPolicy" - ], - "response": { - "$ref": "Operation" + "type": "array" + }, + "id": { + "description": "Output only. [Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "format": "uint64", + "readOnly": true, + "type": "string" + }, + "kind": { + "default": "compute#commitment", + "description": "Output only. [Output Only] Type of the resource. Always compute#commitment\nfor commitments.", + "readOnly": true, + "type": "string" + }, + "licenseResource": { + "$ref": "LicenseResourceCommitment", + "description": "The license specification required as part of a license commitment." + }, + "mergeSourceCommitments": { + "description": "The list of source commitments that you are merging to create the new\nmerged commitment. For more information, see\nMerging commitments.", + "items": { + "type": "string" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "type": "array" + }, + "name": { + "description": "Name of the commitment. You must specify a name when you purchase the\ncommitment. The name must be 1-63 characters long, and comply withRFC1035.\nSpecifically, the name must be 1-63 characters long and match the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first\ncharacter must be a lowercase letter, and all following characters must\nbe a dash, lowercase letter, or digit, except the last character, which\ncannot be a dash.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "params": { + "$ref": "CommitmentParams", + "description": "Input only. Additional params passed with the request, but not persisted\nas part of resource payload." + }, + "plan": { + "description": "The minimum time duration that you commit to purchasing resources.\nThe plan that you choose determines the preset term length of the\ncommitment (which is 1 year or 3 years) and affects the discount rate that\nyou receive for your resources. Committing to a longer time duration\ntypically gives you a higher discount rate. The supported values for this\nfield are TWELVE_MONTH (1 year), andTHIRTY_SIX_MONTH (3 years).", + "enum": [ + "INVALID", + "THIRTY_SIX_MONTH", + "TWELVE_MONTH" + ], + "enumDescriptions": [ + "", + "", + "" ], - "description": "Copies rules to the specified network firewall policy." + "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" - } + "region": { + "description": "Output only. [Output Only] URL of the region where the commitment and committed\nresources are located.", + "readOnly": true, + "type": "string" + }, + "reservations": { + "description": "The list of new reservations that you want to create and attach to this\ncommitment.\n\nYou must attach reservations to your commitment if your commitment\nspecifies any GPUs or Local SSD disks. For more information, see \nAttach reservations to resource-based commitments.\n\nSpecify this property only if you want to create new\nreservations to attach. To attach existing reservations, specify theexistingReservations property instead.", + "items": { + "$ref": "Reservation" }, - "parameterOrder": [ - "project", - "region", - "firewallPolicy" - ], - "response": { - "$ref": "FirewallPolicyAssociation" + "type": "array" + }, + "resourceStatus": { + "$ref": "CommitmentResourceStatus", + "description": "Output only. [Output Only] Status information for Commitment resource.", + "readOnly": true + }, + "resources": { + "description": "The list of all the hardware resources, with their types and amounts, that\nyou want to commit to. Specify as a separate entry in the list for each\nindividual resource type.", + "items": { + "$ref": "ResourceCommitment" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "type": "array" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for the resource.", + "readOnly": true, + "type": "string" + }, + "splitSourceCommitment": { + "description": "The source commitment from which you are transferring resources to create\nthe new split commitment. For more information, see \nSplit commitments.", + "type": "string" + }, + "startTimestamp": { + "description": "Output only. [Output Only] Commitment start time inRFC3339\ntext format.", + "readOnly": true, + "type": "string" + }, + "status": { + "description": "Output only. [Output Only] Status of the commitment with regards to eventual expiration\n(each commitment has an end date defined). Status can be one of the\nfollowing values: NOT_YET_ACTIVE, ACTIVE, orEXPIRED.", + "enum": [ + "ACTIVE", + "CANCELLED", + "CREATING", + "EXPIRED", + "NOT_YET_ACTIVE" + ], + "enumDescriptions": [ + "", + "Deprecate CANCELED status. Will use separate status to differentiate\ncancel by mergeCud or manual cancellation.", + "", + "", + "" ], - "description": "Gets an association with the specified name." + "readOnly": true, + "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" - }, - "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" + "statusMessage": { + "description": "Output only. [Output Only] An optional, human-readable explanation of the status.", + "readOnly": true, + "type": "string" + }, + "type": { + "description": "The type of commitment; specifies the\nmachine series for which you want to commit to purchasing resources.\nThe choice of machine series affects the discount rate and the eligible\nresource types.\n\n The type must be one of the following:ACCELERATOR_OPTIMIZED, ACCELERATOR_OPTIMIZED_A3,ACCELERATOR_OPTIMIZED_A3_MEGA,COMPUTE_OPTIMIZED, COMPUTE_OPTIMIZED_C2D,\n 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, GRAPHICS_OPTIMIZED_G4,GRAPHICS_OPTIMIZED_G4_VGPU,MEMORY_OPTIMIZED, MEMORY_OPTIMIZED_M3,MEMORY_OPTIMIZED_X4, STORAGE_OPTIMIZED_Z3. For\nexample, type MEMORY_OPTIMIZED specifies a commitment that\napplies only to eligible resources of memory optimized M1 and M2 machine\nseries. Type GENERAL_PURPOSE specifies a commitment that\napplies only to eligible resources of general purpose N1 machine series.", + "enum": [ + "ACCELERATOR_OPTIMIZED", + "ACCELERATOR_OPTIMIZED_A3", + "ACCELERATOR_OPTIMIZED_A3_MEGA", + "ACCELERATOR_OPTIMIZED_A3_ULTRA", + "ACCELERATOR_OPTIMIZED_A4", + "COMPUTE_OPTIMIZED", + "COMPUTE_OPTIMIZED_C2D", + "COMPUTE_OPTIMIZED_C3", + "COMPUTE_OPTIMIZED_C3D", + "COMPUTE_OPTIMIZED_H3", + "COMPUTE_OPTIMIZED_H4D", + "GENERAL_PURPOSE", + "GENERAL_PURPOSE_C4", + "GENERAL_PURPOSE_C4A", + "GENERAL_PURPOSE_C4D", + "GENERAL_PURPOSE_E2", + "GENERAL_PURPOSE_N2", + "GENERAL_PURPOSE_N2D", + "GENERAL_PURPOSE_N4", + "GENERAL_PURPOSE_N4A", + "GENERAL_PURPOSE_N4D", + "GENERAL_PURPOSE_T2D", + "GRAPHICS_OPTIMIZED", + "GRAPHICS_OPTIMIZED_G4", + "GRAPHICS_OPTIMIZED_G4_VGPU", + "MEMORY_OPTIMIZED", + "MEMORY_OPTIMIZED_M3", + "MEMORY_OPTIMIZED_M4", + "MEMORY_OPTIMIZED_M4_6TB", + "MEMORY_OPTIMIZED_X4_1440_24T", + "MEMORY_OPTIMIZED_X4_16TB", + "MEMORY_OPTIMIZED_X4_1920_32T", + "MEMORY_OPTIMIZED_X4_24TB", + "MEMORY_OPTIMIZED_X4_32TB", + "MEMORY_OPTIMIZED_X4_480_6T", + "MEMORY_OPTIMIZED_X4_480_8T", + "MEMORY_OPTIMIZED_X4_960_12T", + "MEMORY_OPTIMIZED_X4_960_16T", + "NETWORK_OPTIMIZED_C4N", + "NETWORK_OPTIMIZED_U4C", + "NETWORK_OPTIMIZED_U4P", + "NETWORK_OPTIMIZED_U4S", + "STORAGE_OPTIMIZED_Z3", + "TYPE_UNSPECIFIED" ], - "request": { - "$ref": "FirewallPolicyAssociation" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "CUD bucket for X4 machine with 1440 vCPUs and 24TB of memory.", + "", + "CUD bucket for X4 machine with 1920 vCPUs and 32TB of memory.", + "", + "", + "CUD bucket for X4 machine with 480 vCPUs and 6TB of memory.", + "CUD bucket for X4 machine with 480 vCPUs and 8TB of memory.", + "CUD bucket for X4 machine with 960 vCPUs and 12TB of memory.", + "CUD bucket for X4 machine with 960 vCPUs and 16TB of memory.", + "CUD bucket for C4N (dual Diorite) machines.", + "CUD bucket for NETWORK_OPTIMIZED_U4C machines.", + "CUD bucket for NETWORK_OPTIMIZED_U4P machines.", + "CUD bucket for NETWORK_OPTIMIZED_U4S machines.", + "", + "Note for internal users: When adding a new enum Type for v1, make sure\nto also add it in the comment for the `optional Type type` definition.\nThis ensures that the public documentation displays the new enum Type." ], - "description": "Inserts an association for the specified network firewall policy." + "type": "string" + } + }, + "type": "object" + }, + "CommitmentAggregatedList": { + "id": "CommitmentAggregatedList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" }, - "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" - } + "items": { + "additionalProperties": { + "$ref": "CommitmentsScopedList", + "description": "[Output Only] Name of the scope containing this set of commitments." }, - "parameterOrder": [ - "project", - "region", - "firewallPolicy" - ], - "response": { - "$ref": "Operation" + "description": "A list of CommitmentsScopedList resources.", + "type": "object" + }, + "kind": { + "default": "compute#commitmentAggregatedList", + "description": "Output only. [Output Only] Type of resource. Alwayscompute#commitmentAggregatedList for aggregated lists of\ncommitments.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "unreachables": { + "description": "Output only. [Output Only] Unreachable resources.", + "items": { + "type": "string" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Removes an association for the specified network firewall policy." + "readOnly": true, + "type": "array" }, - "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, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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" } }, - "parameterOrder": [ - "project", - "region", - "network" - ], - "response": { - "$ref": "RegionNetworkFirewallPoliciesGetEffectiveFirewallsResponse" + "type": "object" + } + }, + "type": "object" + }, + "CommitmentList": { + "description": "Contains a list of Commitment resources.", + "id": "CommitmentList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of Commitment resources.", + "items": { + "$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 effective firewalls on a given network." + "type": "array" }, - "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, + "kind": { + "default": "compute#commitmentList", + "description": "Output only. [Output Only] Type of resource. Always compute#commitmentList\nfor lists of commitments.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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" } }, - "parameterOrder": [ - "project", - "region", - "resource" - ], - "response": { - "$ref": "Policy" + "type": "object" + } + }, + "type": "object" + }, + "CommitmentParams": { + "description": "Additional commitment params.", + "id": "CommitmentParams", + "properties": { + "resourceManagerTags": { + "additionalProperties": { + "type": "string" }, - "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": "Input only. Resource manager tags to be bound to the commitment. Tag keys and\nvalues have the same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in\nnamespaced format such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT &\nPATCH) when empty.", + "type": "object" + } + }, + "type": "object" + }, + "CommitmentResourceStatus": { + "description": "[Output Only] Contains output only fields.", + "id": "CommitmentResourceStatus", + "properties": { + "customTermEligibilityEndTimestamp": { + "description": "Output only. [Output Only] Indicates the end time of customer's eligibility to send\ncustom term requests in RFC3339 text format. Term extension requests that\n(not the end time in the request) after this time will be rejected.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "CommitmentsScopedList": { + "id": "CommitmentsScopedList", + "properties": { + "commitments": { + "description": "[Output Only] The list of commitments contained in this scope.", + "items": { + "$ref": "Commitment" + }, + "type": "array" }, - "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, + "warning": { + "description": "[Output Only] Informational warning which replaces the list of commitments\nwhen the list is empty.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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" } }, - "parameterOrder": [ - "project", - "region", - "resource" - ], - "request": { - "$ref": "RegionSetPolicyRequest" + "type": "object" + } + }, + "type": "object" + }, + "CompositeHealthCheck": { + "description": "Represents a composite health check.\n\nA composite health check resource specifies the health source resources and\nthe health destination resource to which the aggregated health result from\nthe health source resources is delivered.", + "id": "CompositeHealthCheck", + "properties": { + "creationTimestamp": { + "description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you\ncreate the resource.", + "type": "string" + }, + "fingerprint": { + "description": "Fingerprint of this resource. A hash of the contents stored in this object.\nThis field is used in optimistic locking. This field will be ignored when\ninserting a CompositeHealthCheck. An up-to-date fingerprint\nmust be provided in order to patch the CompositeHealthCheck; Otherwise,\nthe request will fail with error 412 conditionNotMet. To see\nthe latest fingerprint, make a get() request to retrieve the\nCompositeHealthCheck.", + "format": "byte", + "type": "string" + }, + "healthDestination": { + "description": "URL to the destination resource. Must be set. Must be aForwardingRule. The ForwardingRule must have\nload balancing scheme INTERNAL orINTERNAL_MANAGED and must be regional and in the same region\nas the CompositeHealthCheck (cross-region deployment forINTERNAL_MANAGED is not supported). Can be mutated.", + "type": "string" + }, + "healthSources": { + "description": "URLs to the HealthSource resources whose results are AND'ed.\nI.e. he aggregated result is is HEALTHY only if all sources\nare HEALTHY. Must have at least 1. Must not have more than 10.\nMust be regional and in the same region as theCompositeHealthCheck. Can be mutated.", + "items": { + "type": "string" }, - "response": { - "$ref": "Policy" + "type": "array" + }, + "id": { + "description": "Output only. [Output Only] A unique identifier for this resource type. The server\ngenerates this identifier.", + "format": "uint64", + "readOnly": true, + "type": "string" + }, + "kind": { + "default": "compute#compositeHealthCheck", + "description": "Output only. [Output Only] Type of the resource. Alwayscompute#compositeHealthCheck for composite health checks.", + "readOnly": true, + "type": "string" + }, + "name": { + "description": "Name of the resource. Provided by the client when the resource is created.\nThe name must be 1-63 characters long, and comply withRFC1035.\nSpecifically, the name must be 1-63 characters long and match the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first\ncharacter must be a lowercase letter, and all following characters must\nbe a dash, lowercase letter, or digit, except the last character, which\ncannot be a dash.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "region": { + "description": "Output only. [Output Only] URL of the region where the composite health check resides.\nThis field applies only to the regional resource. You must specify this\nfield as part of the HTTP request URL. It is not settable as a field in\nthe request body.", + "readOnly": true, + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for the resource.", + "readOnly": true, + "type": "string" + }, + "selfLinkWithId": { + "description": "Output only. [Output Only] Server-defined URL with id for the resource.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "CompositeHealthCheckAggregatedList": { + "description": "Contains a list of CompositeHealthChecksScopedList.", + "id": "CompositeHealthCheckAggregatedList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "additionalProperties": { + "$ref": "CompositeHealthChecksScopedList", + "description": "Name of the scope containing this set of CompositeHealthChecks." }, - "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": "A list of CompositeHealthChecksScopedList resources.", + "type": "object" }, - "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, + "kind": { + "default": "compute#compositeHealthCheckAggregatedList", + "description": "Output only. Type of resource.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "unreachables": { + "description": "Output only. [Output Only] Unreachable resources.", + "items": { + "type": "string" + }, + "readOnly": true, + "type": "array" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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" } }, - "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." + "type": "object" } - } + }, + "type": "object" }, - "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" + "CompositeHealthCheckHealth": { + "description": "Response message for RegionCompositeHealthChecks.GetHealth", + "id": "CompositeHealthCheckHealth", + "properties": { + "healthSources": { + "description": "Health sources and their corresponding health states.", + "items": { + "$ref": "CompositeHealthChecksGetHealthResponseHealthSourceHealth" }, - "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." + "type": "array" }, - "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" + "healthState": { + "description": "Health state of the CompositeHealthCheck.", + "enum": [ + "HEALTHY", + "UNHEALTHY", + "UNKNOWN" ], - "response": { - "$ref": "SecurityPolicy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "", + "", + "" ], - "description": "List all of the ordered rules present in a single specified policy." + "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" - } - }, - "parameterOrder": [ - "project" - ], - "request": { - "$ref": "SecurityPolicy" - }, - "response": { - "$ref": "Operation" + "kind": { + "default": "compute#compositeHealthCheckHealth", + "description": "Output only. [Output Only] Type of resource. Alwayscompute#compositeHealthCheckHealth for the health of\ncomposite health checks.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "CompositeHealthCheckList": { + "id": "CompositeHealthCheckList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of CompositeHealthCheck resources.", + "items": { + "$ref": "CompositeHealthCheck" }, - "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." + "type": "array" }, - "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, + "kind": { + "default": "compute#compositeHealthCheckList", + "description": "Output only. [Output Only] Type of the resource. Alwayscompute#compositeHealthCheck for composite health checks.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue 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.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project", - "securityPolicy" + "type": "object" + } + }, + "type": "object" + }, + "CompositeHealthChecksGetHealthResponseHealthSourceHealth": { + "id": "CompositeHealthChecksGetHealthResponseHealthSourceHealth", + "properties": { + "healthState": { + "description": "Health state of the associated HealthSource resource.", + "enum": [ + "HEALTHY", + "UNHEALTHY", + "UNKNOWN" ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "", + "", + "" ], - "description": "Deletes the specified policy." + "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, + "source": { + "description": "Fully qualified URL of the associated HealthSource resource.", + "type": "string" + } + }, + "type": "object" + }, + "CompositeHealthChecksScopedList": { + "id": "CompositeHealthChecksScopedList", + "properties": { + "compositeHealthChecks": { + "description": "A list of CompositeHealthChecks contained in this scope.", + "items": { + "$ref": "CompositeHealthCheck" + }, + "type": "array" + }, + "warning": { + "description": "Informational warning which replaces the list of composite health checks\nwhen the list is empty.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" - }, - "updateMask": { - "description": "Indicates fields to be cleared as part of this request.", - "location": "query", - "type": "string", - "format": "google-fieldmask" } }, - "parameterOrder": [ - "project", - "securityPolicy" + "type": "object" + } + }, + "type": "object" + }, + "ConfidentialInstanceConfig": { + "description": "A set of Confidential Instance options.", + "id": "ConfidentialInstanceConfig", + "properties": { + "confidentialInstanceType": { + "description": "Defines the type of technology used by the confidential instance.", + "enum": [ + "CCA", + "CONFIDENTIAL_INSTANCE_TYPE_UNSPECIFIED", + "SEV", + "SEV_SNP", + "TDX" ], - "request": { - "$ref": "SecurityPolicy" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "Arm Confidential Compute Architecture.", + "No type specified. Do not use this value.", + "AMD Secure Encrypted Virtualization.", + "AMD Secure Encrypted Virtualization - Secure Nested Paging.", + "Intel Trust Domain eXtension." ], - "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." + "type": "string" }, - "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" - } + "enableConfidentialCompute": { + "description": "Defines whether the instance should have confidential compute enabled.", + "type": "boolean" + } + }, + "type": "object" + }, + "ConnectionDraining": { + "description": "Message containing connection draining configuration.", + "id": "ConnectionDraining", + "properties": { + "drainingTimeoutSec": { + "description": "Configures a duration timeout for existing requests on a removed backend\ninstance. For supported load balancers and protocols, as described inEnabling\nconnection draining.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, + "ConsistentHashLoadBalancerSettings": { + "description": "This message defines settings for a consistent hash style load balancer.", + "id": "ConsistentHashLoadBalancerSettings", + "properties": { + "httpCookie": { + "$ref": "ConsistentHashLoadBalancerSettingsHttpCookie", + "description": "Hash is based on HTTP Cookie. This field describes a HTTP cookie that will\nbe used as the hash key for the consistent hash load balancer. If the\ncookie is not present, it will be generated. This field is applicable if\nthe sessionAffinity is set to HTTP_COOKIE.\n\nNot supported when the backend service is referenced by a URL map that is\nbound to target gRPC proxy that has validateForProxyless field set to true." + }, + "httpHeaderName": { + "description": "The hash based on the value of the specified header field. This field is\napplicable if the sessionAffinity is set toHEADER_FIELD.", + "type": "string" + }, + "minimumRingSize": { + "description": "The minimum number of virtual nodes to use for the hash ring. Defaults to\n1024. Larger ring sizes result in more granular load distributions. If the\nnumber of hosts in the load balancing pool is larger than the ring size,\neach host will be assigned a single virtual node.", + "format": "int64", + "type": "string" + } + }, + "type": "object" + }, + "ConsistentHashLoadBalancerSettingsHttpCookie": { + "description": "The information about the HTTP Cookie on which the hash function is based\nfor load balancing policies that use a consistent hash.", + "id": "ConsistentHashLoadBalancerSettingsHttpCookie", + "properties": { + "name": { + "description": "Name of the cookie.", + "type": "string" + }, + "path": { + "description": "Path to set for the cookie.", + "type": "string" + }, + "ttl": { + "$ref": "Duration", + "description": "Lifetime of the cookie." + } + }, + "type": "object" + }, + "CorsPolicy": { + "description": "The specification for allowing client-side cross-origin requests. For more\ninformation about the W3C recommendation for cross-origin resource sharing\n(CORS), see Fetch API Living\nStandard.", + "id": "CorsPolicy", + "properties": { + "allowCredentials": { + "description": "In response to a preflight request, setting this to true\nindicates that\nthe actual request can include user credentials. This field translates to\nthe Access-Control-Allow-Credentials header.\n\nDefault is false.", + "type": "boolean" + }, + "allowHeaders": { + "description": "Specifies the content for the Access-Control-Allow-Headers\nheader.", + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "securityPolicy" - ], - "response": { - "$ref": "SecurityPolicyRule" + "type": "array" + }, + "allowMethods": { + "description": "Specifies the content for the Access-Control-Allow-Methods\nheader.", + "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": "Gets a rule at the specified priority." + "type": "array" }, - "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" - } + "allowOriginRegexes": { + "description": "Specifies a regular expression that matches allowed origins. For\nmore information, see regular expression syntax. \n\nAn origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.\n\nRegular expressions can only be used when the loadBalancingScheme is\nset to INTERNAL_SELF_MANAGED.", + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "securityPolicy" - ], - "request": { - "$ref": "SecurityPolicyRule" + "type": "array" + }, + "allowOrigins": { + "description": "Specifies the list of origins that is allowed to do CORS requests.\n\nAn origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.", + "items": { + "type": "string" }, - "response": { - "$ref": "Operation" + "type": "array" + }, + "disabled": { + "description": "If true, disables the CORS policy.\nThe default value is false, which indicates that the CORS\npolicy is in effect.", + "type": "boolean" + }, + "exposeHeaders": { + "description": "Specifies the content for the Access-Control-Expose-Headers\nheader.", + "items": { + "type": "string" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Inserts a rule into a security policy." + "type": "array" }, - "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" - } + "maxAge": { + "description": "Specifies how long results of a preflight request can be cached in\nseconds. This field translates to the Access-Control-Max-Age\nheader.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, + "CrossSiteNetwork": { + "description": "A resource that represents a cross-site network.\n\nYou can use cross-site networks to connect your on-premises networks to\neach other through Interconnect connections.", + "id": "CrossSiteNetwork", + "properties": { + "creationTimestamp": { + "description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "An optional description of the cross-site network.", + "type": "string" + }, + "id": { + "description": "Output only. [Output Only] The unique identifier for the resource type. The server\ngenerates this identifier.", + "format": "uint64", + "readOnly": true, + "type": "string" + }, + "kind": { + "default": "compute#crossSiteNetwork", + "description": "Output only. [Output Only] Type of the resource. Alwayscompute#crossSiteNetwork for cross-site networks.", + "readOnly": true, + "type": "string" + }, + "name": { + "description": "Name of the resource. Provided by the client when the resource is created.\nThe name must be 1-63 characters long, and comply withRFC1035.\nSpecifically, the name must be 1-63 characters long and match the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first\ncharacter must be a lowercase letter, and all following characters must\nbe a dash, lowercase letter, or digit, except the last character, which\ncannot be a dash.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for the resource.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "CrossSiteNetworkList": { + "description": "Response to the list request that contains a list of cross-site networks.", + "id": "CrossSiteNetworkList", + "properties": { + "etag": { + "type": "string" + }, + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of CrossSiteNetwork resources.", + "items": { + "$ref": "CrossSiteNetwork" }, - "parameterOrder": [ - "project", - "securityPolicy" - ], - "response": { - "$ref": "Operation" + "type": "array" + }, + "kind": { + "default": "compute#crossSiteNetwork", + "description": "Output only. [Output Only] Type of the resource. Alwayscompute#crossSiteNetwork for cross-site networks.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "unreachables": { + "description": "Output only. [Output Only] Unreachable resources.\nend_interface: MixerListResponseWithEtagBuilder", + "items": { + "type": "string" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes a rule at the specified priority." + "readOnly": true, + "type": "array" }, - "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, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "updateMask": { - "description": "Indicates fields to be cleared as part of this request.", - "location": "query", - "type": "string", - "format": "google-fieldmask" + "data": { + "description": "[Output Only] Metadata about this warning in key:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "validateOnly": { - "description": "If true, the request will not be committed.", - "location": "query", - "type": "boolean" + "message": { + "description": "[Output Only] A human-readable description of the warning code.", + "type": "string" } }, - "parameterOrder": [ - "project", - "securityPolicy" - ], - "request": { - "$ref": "SecurityPolicyRule" - }, - "response": { - "$ref": "Operation" + "type": "object" + } + }, + "type": "object" + }, + "CustomErrorResponsePolicy": { + "description": "Specifies the custom error response policy that must be applied when the\nbackend service or backend bucket responds with an error.", + "id": "CustomErrorResponsePolicy", + "properties": { + "errorResponseRules": { + "description": "Specifies rules for returning error responses.\n\nIn a given policy, if you specify rules for both a range of error codes\nas well as rules for specific error codes then rules with specific error\ncodes have a higher priority. For example, assume that you configure a rule\nfor 401 (Un-authorized) code, and another for all 4 series\nerror codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.\nHowever if the backend service returns a 403, the rule for4xx takes effect.", + "items": { + "$ref": "CustomErrorResponsePolicyCustomErrorResponseRule" }, - "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." + "type": "array" }, - "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" - } + "errorService": { + "description": "The full or partial URL to the BackendBucket resource that\ncontains the custom error content. Examples are:\n \n \n - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket\n - compute/v1/projects/project/global/backendBuckets/myBackendBucket\n - global/backendBuckets/myBackendBucket\n\nIf errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,\nan errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService. \n\nIf load balancer cannot reach\nthe backendBucket, a simple Not Found Error will\nbe returned, with the original response code (oroverrideResponseCode if configured).\n\nerrorService is not supported for internal or regionalHTTP/HTTPS load balancers.", + "type": "string" + } + }, + "type": "object" + }, + "CustomErrorResponsePolicyCustomErrorResponseRule": { + "description": "Specifies the mapping between the response code that will be returned along\nwith the custom error content and the response code returned by the backend\nservice.", + "id": "CustomErrorResponsePolicyCustomErrorResponseRule", + "properties": { + "matchResponseCodes": { + "description": "Valid values include:\n \n \n - A number between 400 and 599: For example\n 401 or 503, in which case the load balancer\n applies the policy if the error code exactly matches this value.\n - 5xx: Load Balancer will apply the policy if the\n backend service responds with any response code in the range of\n 500 to 599. \n - 4xx: Load\n Balancer will apply the policy if the backend service responds with any\n response code in the range of 400 to\n 499.\n\nValues must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.", + "items": { + "type": "string" }, - "parameterOrder": [ - "project" + "type": "array" + }, + "overrideResponseCode": { + "description": "The HTTP status code returned with the response containing the custom\nerror content. If overrideResponseCode is not supplied, the\nsame response code returned by the original backend bucket or backend\nservice is returned to the client.", + "format": "int32", + "type": "integer" + }, + "path": { + "description": "The full path to a file within backendBucket . For example:/errors/defaultError.html \n\npath must start\nwith a leading slash. path cannot have trailing slashes.\n\nIf the file is not available in backendBucket or the\nload balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client. \n\nThe value must\nbe from 1 to 1024 characters", + "type": "string" + } + }, + "type": "object" + }, + "CustomerEncryptionKey": { + "id": "CustomerEncryptionKey", + "properties": { + "kmsKeyName": { + "description": "The name of the encryption key that is stored in Google Cloud KMS.\nFor example:\n\n\"kmsKeyName\": \"projects/kms_project_id/locations/region/keyRings/\nkey_region/cryptoKeys/key\n\nThe fully-qualifed key name may be returned for resource GET requests. For \nexample: \n\n\"kmsKeyName\": \"projects/kms_project_id/locations/region/keyRings/\nkey_region/cryptoKeys/key\n/cryptoKeyVersions/1", + "type": "string" + }, + "kmsKeyServiceAccount": { + "description": "The service account being used for the encryption request for the given KMS\nkey. If absent, the Compute Engine default service account is used.\nFor example:\n\n\"kmsKeyServiceAccount\": \"name@project_id.iam.gserviceaccount.com/", + "type": "string" + }, + "rawKey": { + "deprecated": true, + "description": "[DEPRECATED] CSEK is no longer supported. Use CMEK instead.\nSpecifies a 256-bit customer-supplied\nencryption key, encoded in RFC\n4648 base64 to either encrypt or decrypt this resource. You can\nprovide either the rawKey or thersaEncryptedKey.\nFor example:\n\n\"rawKey\":\n\"SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=\"", + "type": "string" + }, + "rsaEncryptedKey": { + "deprecated": true, + "description": "[DEPRECATED] CSEK is no longer supported. Use CMEK instead.\nSpecifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit\ncustomer-supplied encryption key to either encrypt or decrypt this\nresource. You can provide either the rawKey or thersaEncryptedKey.\nFor example:\n\n\"rsaEncryptedKey\":\n\"ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH\nz0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD\nD6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==\"\n\nThe key must meet the following requirements before you can provide it to \nCompute Engine: \n \n 1. The key is wrapped using a RSA public key certificate provided by \n Google. \n 2. After being wrapped, the key must be encoded in RFC 4648 base64 \n encoding. \n\nGets the RSA public key certificate provided by Google at: \n\n\nhttps://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem", + "type": "string" + }, + "sha256": { + "deprecated": true, + "description": "[DEPRECATED] CSEK is no longer supported. Use CMEK instead.\n[Output only] TheRFC\n4648 base64 encoded SHA-256 hash of the customer-supplied\nencryption key that protects this resource.", + "type": "string" + } + }, + "type": "object" + }, + "CustomerEncryptionKeyProtectedDisk": { + "id": "CustomerEncryptionKeyProtectedDisk", + "properties": { + "diskEncryptionKey": { + "$ref": "CustomerEncryptionKey", + "description": "Decrypts data associated with the disk with acustomer-supplied\nencryption key." + }, + "source": { + "description": "Specifies a valid partial or full URL to an existing Persistent Disk\nresource. This field is only applicable for persistent disks.\nFor example:\n\n\"source\": \"/compute/v1/projects/project_id/zones/zone/disks/\ndisk_name", + "type": "string" + } + }, + "type": "object" + }, + "Date": { + "description": "Represents a whole or partial calendar date, such as a birthday. The time of\nday and time zone are either specified elsewhere or are insignificant. The\ndate is relative to the Gregorian Calendar. This can represent one of the\nfollowing:\n\n* A full date, with non-zero year, month, and day values.\n* A month and day, with a zero year (for example, an anniversary).\n* A year on its own, with a zero month and a zero day.\n* A year and month, with a zero day (for example, a credit card expiration\n date).\n\nRelated types:\n\n* google.type.TimeOfDay\n* google.type.DateTime\n* google.protobuf.Timestamp", + "id": "Date", + "properties": { + "day": { + "description": "Day of a month. Must be from 1 to 31 and valid for the year and month, or 0\nto specify a year by itself or a year and month where the day isn't\nsignificant.", + "format": "int32", + "type": "integer" + }, + "month": { + "description": "Month of a year. Must be from 1 to 12, or 0 to specify a year without a\nmonth and day.", + "format": "int32", + "type": "integer" + }, + "year": { + "description": "Year of the date. Must be from 1 to 9999, or 0 to specify a date without\na year.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, + "DateTime": { + "description": "Represents civil time (or occasionally physical time).\n\nThis type can represent a civil time in one of a few possible ways:\n\n * When utc_offset is set and time_zone is unset: a civil time on a calendar\n day with a particular offset from UTC.\n * When time_zone is set and utc_offset is unset: a civil time on a calendar\n day in a particular time zone.\n * When neither time_zone nor utc_offset is set: a civil time on a calendar\n day in local time.\n\nThe date is relative to the Proleptic Gregorian Calendar.\n\nIf year, month, or day are 0, the DateTime is considered not to have a\nspecific year, month, or day respectively.\n\nThis type may also be used to represent a physical time if all the date and\ntime fields are set and either case of the `time_offset` oneof is set.\nConsider using `Timestamp` message for physical time instead. If your use\ncase also would like to store the user's timezone, that can be done in\nanother field.\n\nThis type is more flexible than some applications may want. Make sure to\ndocument and validate your application's limitations.", + "id": "DateTime", + "properties": { + "day": { + "description": "Optional. Day of month. Must be from 1 to 31 and valid for the year and\nmonth, or 0 if specifying a datetime without a day.", + "format": "int32", + "type": "integer" + }, + "hours": { + "description": "Optional. Hours of day in 24 hour format. Should be from 0 to 23, defaults\nto 0 (midnight). An API may choose to allow the value \"24:00:00\" for\nscenarios like business closing time.", + "format": "int32", + "type": "integer" + }, + "minutes": { + "description": "Optional. Minutes of hour of day. Must be from 0 to 59, defaults to 0.", + "format": "int32", + "type": "integer" + }, + "month": { + "description": "Optional. Month of year. Must be from 1 to 12, or 0 if specifying a\ndatetime without a month.", + "format": "int32", + "type": "integer" + }, + "nanos": { + "description": "Optional. Fractions of seconds in nanoseconds. Must be from 0 to\n999,999,999, defaults to 0.", + "format": "int32", + "type": "integer" + }, + "seconds": { + "description": "Optional. Seconds of minutes of the time. Must normally be from 0 to 59,\ndefaults to 0. An API may allow the value 60 if it allows leap-seconds.", + "format": "int32", + "type": "integer" + }, + "timeZone": { + "$ref": "TimeZone", + "description": "Time zone." + }, + "utcOffset": { + "description": "UTC offset. Must be whole seconds, between -18 hours and +18 hours.\nFor example, a UTC offset of -4:00 would be represented as\n{ seconds: -14400 }.", + "format": "google-duration", + "type": "string" + }, + "year": { + "description": "Optional. Year of date. Must be from 1 to 9999, or 0 if specifying a\ndatetime without a year.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, + "DeprecationStatus": { + "description": "Deprecation status for a public resource.", + "id": "DeprecationStatus", + "properties": { + "deleted": { + "description": "An optional RFC3339 timestamp on or after which the state of this\nresource is intended to change to DELETED. This is only\ninformational and the status will not change unless the client explicitly\nchanges it.", + "type": "string" + }, + "deprecated": { + "description": "An optional RFC3339 timestamp on or after which the state of this\nresource is intended to change to DEPRECATED. This is only\ninformational and the status will not change unless the client explicitly\nchanges it.", + "type": "string" + }, + "obsolete": { + "description": "An optional RFC3339 timestamp on or after which the state of this\nresource is intended to change to OBSOLETE. This is only\ninformational and the status will not change unless the client explicitly\nchanges it.", + "type": "string" + }, + "replacement": { + "description": "The URL of the suggested replacement for a deprecated resource.\nThe suggested replacement resource must be the same kind of resource as the\ndeprecated resource.", + "type": "string" + }, + "state": { + "description": "The deprecation state of this resource. This can be ACTIVE,DEPRECATED, OBSOLETE, or DELETED.\nOperations which communicate the end of life date for an image, can useACTIVE. Operations which create a new resource using aDEPRECATED resource will return successfully, but with a\nwarning indicating the deprecated resource and recommending its\nreplacement. Operations which use OBSOLETE orDELETED resources will be rejected and result in an error.", + "enum": [ + "ACTIVE", + "DELETED", + "DEPRECATED", + "OBSOLETE" ], - "response": { - "$ref": "SecurityPoliciesListPreconfiguredExpressionSetsResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "", + "", + "", + "" ], - "description": "Gets the current list of preconfigured Web Application Firewall (WAF) expressions." - }, - "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" + "type": "string" + } + }, + "type": "object" + }, + "Disk": { + "description": "Represents a Persistent Disk resource.\n\nGoogle Compute Engine has two Disk resources:\n\n* [Zonal](/compute/docs/reference/rest/v1/disks)\n* [Regional](/compute/docs/reference/rest/v1/regionDisks)\n\nPersistent disks are required for running your VM instances.\nCreate both boot and non-boot (data) persistent disks. For more information,\nread Persistent Disks. For more\nstorage options, read Storage options.\n\nThe disks resource represents a zonal persistent disk.\nFor more information, readZonal persistent disks.\n\nThe regionDisks resource represents a\nregional persistent disk. For more information, read\nRegional resources.", + "id": "Disk", + "properties": { + "accessMode": { + "description": "The access mode of the disk.\n \n \n - READ_WRITE_SINGLE: The default AccessMode, means the\n disk can be attached to single instance in RW mode.\n - READ_WRITE_MANY: The AccessMode means the disk can be\n attached to multiple instances in RW mode.\n - READ_ONLY_MANY: The AccessMode means the disk can be\n attached to multiple instances in RO mode.\n\n\nThe AccessMode is only valid for Hyperdisk disk types.", + "enum": [ + "READ_ONLY_MANY", + "READ_WRITE_MANY", + "READ_WRITE_SINGLE" ], - "request": { - "$ref": "GlobalSetLabelsRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "The AccessMode means the disk can be attached to multiple instances in RO\nmode.", + "The AccessMode means the disk can be attached to multiple instances in RW\nmode.", + "The default AccessMode, means the disk can be attached to single instance\nin RW mode." ], - "description": "Sets the labels on a security policy. To learn more about labels, read the Labeling Resources documentation." + "type": "string" }, - "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" + "architecture": { + "description": "The architecture of the disk. Valid values are\nARM64 or X86_64.", + "enum": [ + "ARCHITECTURE_UNSPECIFIED", + "ARM64", + "X86_64" ], - "response": { - "$ref": "SecurityPoliciesAggregatedList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "Default value indicating Architecture is not set.", + "Machines with architecture ARM64", + "Machines with architecture X86_64" ], - "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`." - } - } - }, - "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" - }, - "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" - } + "type": "string" + }, + "asyncPrimaryDisk": { + "$ref": "DiskAsyncReplication", + "description": "Disk asynchronously replicated into this disk." + }, + "asyncSecondaryDisks": { + "additionalProperties": { + "$ref": "DiskAsyncReplicationList" }, - "parameterOrder": [ - "project", - "region" - ], - "response": { - "$ref": "SecurityPolicyList" + "description": "Output only. [Output Only] A list of disks this disk is asynchronously replicated to.", + "readOnly": true, + "type": "object" + }, + "creationTimestamp": { + "description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you\ncreate the resource.", + "type": "string" + }, + "diskEncryptionKey": { + "$ref": "CustomerEncryptionKey", + "description": "Encrypts the disk using a\ncustomer-supplied encryption key or a \ncustomer-managed encryption key.\n\nEncryption keys do not protect access to metadata of the disk.\n\nAfter you encrypt a disk with a customer-supplied key, you must provide the\nsame key if you use the disk later. For example, to create a disk snapshot,\nto create a disk image, to create a machine image, or to attach the disk to\na virtual machine.\n\nAfter you encrypt a disk with a customer-managed key, thediskEncryptionKey.kmsKeyName is set to a key *version*\nname once the disk is created. The disk is encrypted with this version of\nthe key. In the response, diskEncryptionKey.kmsKeyName appears\nin the following format:\n\n\"diskEncryptionKey.kmsKeyName\":\n\"projects/kms_project_id/locations/region/keyRings/\nkey_region/cryptoKeys/key\n/cryptoKeysVersions/version\n\nIf you do not provide an encryption key when creating the disk, then the \ndisk is encrypted using an automatically generated key and you don't need \nto provide a key to use the disk later." + }, + "enableConfidentialCompute": { + "description": "Whether this disk is using confidential compute mode.", + "type": "boolean" + }, + "guestOsFeatures": { + "description": "A list of features to enable on the guest operating system. Applicable\nonly for bootable images. Read\nEnabling guest operating system features to see a list of available\noptions.", + "items": { + "$ref": "GuestOsFeature" }, - "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." + "type": "array" }, - "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" - }, - "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 get.", - "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. [Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "format": "uint64", + "readOnly": true, + "type": "string" + }, + "kind": { + "default": "compute#disk", + "description": "Output only. [Output Only] Type of the resource. Always compute#disk for\ndisks.", + "readOnly": true, + "type": "string" + }, + "labelFingerprint": { + "description": "A fingerprint for the labels being applied to this disk, which is\nessentially a hash of the labels set used for optimistic locking. The\nfingerprint is initially generated by Compute Engine and changes after\nevery request to modify or update labels. You must always provide an\nup-to-date fingerprint hash in order to update or change labels,\notherwise the request will fail with error412 conditionNotMet.\n\nTo see the latest fingerprint, make a get() request to\nretrieve a disk.", + "format": "byte", + "type": "string" + }, + "labels": { + "additionalProperties": { + "type": "string" }, - "parameterOrder": [ - "project", - "region", - "securityPolicy" - ], - "response": { - "$ref": "SecurityPolicy" + "description": "Labels to apply to this disk. These can be later modified by\nthe setLabels method.", + "type": "object" + }, + "lastAttachTimestamp": { + "description": "Output only. [Output Only] Last attach timestamp inRFC3339\ntext format.", + "readOnly": true, + "type": "string" + }, + "lastDetachTimestamp": { + "description": "Output only. [Output Only] Last detach timestamp inRFC3339\ntext format.", + "readOnly": true, + "type": "string" + }, + "licenseCodes": { + "description": "Integer license codes indicating which licenses are attached to this disk.", + "items": { + "format": "int64", + "type": "string" }, - "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." + "type": "array" }, - "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" - } + "licenses": { + "description": "A list of publicly visible licenses. Reserved for Google's use.", + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "region" - ], - "request": { - "$ref": "SecurityPolicy" + "type": "array" + }, + "locationHint": { + "description": "An opaque location hint used to place the disk close to other resources.\nThis field is for use by internal tools that use the public API.", + "type": "string" + }, + "name": { + "annotations": { + "required": [ + "compute.disks.insert" + ] }, - "response": { - "$ref": "Operation" + "description": "Name of the resource. Provided by the client when the resource is created.\nThe name must be 1-63 characters long, and comply withRFC1035.\nSpecifically, the name must be 1-63 characters long and match the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?`\nwhich means the first character must be a lowercase letter, and all\nfollowing characters must be a dash, lowercase letter, or digit, except\nthe last character, which cannot be a dash.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "options": { + "description": "Internal use only.", + "type": "string" + }, + "params": { + "$ref": "DiskParams", + "description": "Input only. [Input Only] Additional params passed with the request, but not persisted\nas part of resource payload." + }, + "physicalBlockSizeBytes": { + "description": "Physical block size of the persistent disk, in bytes.\nIf not present in a request, a default value is used.\nThe currently supported size is 4096, other sizes may be added in\nthe future.\nIf an unsupported value is requested, the error message will list\nthe supported values for the caller's project.", + "format": "int64", + "type": "string" + }, + "provisionedIops": { + "description": "Indicates how many IOPS to provision for the disk. This sets the number\nof I/O operations per second that the disk can handle. Values must be\nbetween 10,000 and 120,000. For more details, see theExtreme persistent\ndisk documentation.", + "format": "int64", + "type": "string" + }, + "provisionedThroughput": { + "description": "Indicates how much throughput to provision for the disk. This sets the\nnumber of throughput mb per second that the disk can handle. Values must be\ngreater than or equal to 1.", + "format": "int64", + "type": "string" + }, + "region": { + "description": "Output only. [Output Only] URL of the region where the disk resides. Only applicable for\nregional resources.\nYou must specify this field as part of the HTTP request URL. It is\nnot settable as a field in the request body.", + "readOnly": true, + "type": "string" + }, + "replicaZones": { + "description": "URLs of the zones where the disk should be replicated to. Only applicable\nfor regional resources.", + "items": { + "type": "string" }, - "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." + "type": "array" }, - "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" - } + "resourcePolicies": { + "description": "Resource policies applied to this disk for automatic snapshot creations.", + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "region", - "securityPolicy" + "type": "array" + }, + "resourceStatus": { + "$ref": "DiskResourceStatus", + "description": "Output only. [Output Only] Status information for the disk resource.", + "readOnly": true + }, + "satisfiesPzi": { + "description": "Output only. Reserved for future use.", + "readOnly": true, + "type": "boolean" + }, + "satisfiesPzs": { + "description": "Output only. [Output Only] Reserved for future use.", + "readOnly": true, + "type": "boolean" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined fully-qualified URL for this resource.", + "readOnly": true, + "type": "string" + }, + "sizeGb": { + "description": "Size, in GB, of the persistent disk. You can specify\nthis field when creating a persistent disk using thesourceImage, sourceSnapshot, orsourceDisk parameter, or specify it alone to create an empty\npersistent disk.\n\nIf you specify this field along with a source, the value ofsizeGb must not be less than the size of the\nsource.\nAcceptable values are greater than 0.", + "format": "int64", + "type": "string" + }, + "sourceConsistencyGroupPolicy": { + "description": "Output only. [Output Only] URL of the DiskConsistencyGroupPolicy for a secondary disk\nthat was created using a consistency group.", + "readOnly": true, + "type": "string" + }, + "sourceConsistencyGroupPolicyId": { + "description": "Output only. [Output Only] ID of the DiskConsistencyGroupPolicy for a secondary disk\nthat was created using a consistency group.", + "readOnly": true, + "type": "string" + }, + "sourceDisk": { + "description": "The source disk used to create this disk. You can provide this as a\npartial or full URL to the resource. For example, the following are valid\nvalues:\n \n \n - \n https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk\n \n - \n https://www.googleapis.com/compute/v1/projects/project/regions/region/disks/disk\n \n - \n projects/project/zones/zone/disks/disk\n \n - \n projects/project/regions/region/disks/disk\n \n - \n zones/zone/disks/disk\n \n - \n regions/region/disks/disk", + "type": "string" + }, + "sourceDiskId": { + "description": "Output only. [Output Only] The unique ID of the disk used to create this disk. This\nvalue identifies the exact disk that was used to create this persistent\ndisk. For example, if you created the persistent disk from a disk that\nwas later deleted and recreated under the same name, the source disk ID\nwould identify the exact version of the disk that was used.", + "readOnly": true, + "type": "string" + }, + "sourceImage": { + "description": "The source image used to create this disk. If the source image is\ndeleted, this field will not be set.\n\nTo create a disk with one of the public operating system images, specify\nthe image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:\n\nprojects/debian-cloud/global/images/family/debian-9\n\n\nAlternatively, use a specific version of a public operating system image:\n\nprojects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD\n\n\nTo create a disk with a custom image that you created, specify the\nimage name in the following format:\n\nglobal/images/my-custom-image\n\n\nYou can also specify a custom image by its image family, which returns\nthe latest version of the image in that family. Replace the image name\nwith family/family-name:\n\nglobal/images/family/my-image-family", + "type": "string" + }, + "sourceImageEncryptionKey": { + "$ref": "CustomerEncryptionKey", + "description": "Thecustomer-supplied\nencryption key of the source image. Required if the source image is\nprotected by a customer-supplied encryption key." + }, + "sourceImageId": { + "description": "Output only. [Output Only] The ID value of the image used to create this disk. This\nvalue identifies the exact image that was used to create this persistent\ndisk. For example, if you created the persistent disk from an image that\nwas later deleted and recreated under the same name, the source image ID\nwould identify the exact version of the image that was used.", + "readOnly": true, + "type": "string" + }, + "sourceInstantSnapshot": { + "description": "The source instant snapshot used to create this disk. You can provide\nthis as a partial or full URL to the resource. For example, the following\nare valid values:\n \n \n - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instantSnapshots/instantSnapshot\n - projects/project/zones/zone/instantSnapshots/instantSnapshot \n - zones/zone/instantSnapshots/instantSnapshot", + "type": "string" + }, + "sourceInstantSnapshotId": { + "description": "Output only. [Output Only] The unique ID of the instant snapshot used to create this\ndisk. This value identifies the exact instant snapshot that was used to\ncreate this persistent disk. For example, if you created the persistent\ndisk from an instant snapshot that was later deleted and recreated under\nthe same name, the source instant snapshot ID would identify the exact\nversion of the instant snapshot that was used.", + "readOnly": true, + "type": "string" + }, + "sourceSnapshot": { + "description": "The source snapshot used to create this disk. You can provide this as a\npartial or full URL to the resource. For example, the following are valid\nvalues:\n \n \n - https://www.googleapis.com/compute/v1/projects/project/global/snapshots/snapshot \n - projects/project/global/snapshots/snapshot\n - global/snapshots/snapshot", + "type": "string" + }, + "sourceSnapshotEncryptionKey": { + "$ref": "CustomerEncryptionKey", + "description": "Thecustomer-supplied\nencryption key of the source snapshot. Required if the source snapshot\nis protected by a customer-supplied encryption key." + }, + "sourceSnapshotId": { + "description": "Output only. [Output Only] The unique ID of the snapshot used to create this disk. This\nvalue identifies the exact snapshot that was used to create this persistent\ndisk. For example, if you created the persistent disk from a snapshot that\nwas later deleted and recreated under the same name, the source snapshot ID\nwould identify the exact version of the snapshot that was used.", + "readOnly": true, + "type": "string" + }, + "sourceStorageObject": { + "description": "The full Google Cloud Storage URI where the disk image is stored. This file\nmust be a gzip-compressed tarball whose name ends in .tar.gz or virtual\nmachine disk whose name ends in vmdk. Valid URIs may start with gs:// or\nhttps://storage.googleapis.com/. This flag is not optimized for creating\nmultiple disks from a source storage object. To create many disks from a\nsource storage object, use gcloud compute images\nimport instead.", + "type": "string" + }, + "status": { + "description": "Output only. [Output Only] The status of disk creation.\n \n \n - CREATING: Disk is provisioning.\n - RESTORING: Source data is being copied into the\n disk.\n - FAILED: Disk creation failed.\n - READY: Disk is ready for use.\n - DELETING: Disk is deleting.", + "enum": [ + "CREATING", + "DELETING", + "FAILED", + "READY", + "RESTORING", + "UNAVAILABLE" ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "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\ndetached." ], - "description": "Deletes the specified policy." + "readOnly": true, + "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" - } + "storagePool": { + "description": "The storage pool in which the new disk is created. You can provide\nthis as a partial or full URL to the resource. For example, the following\nare valid values:\n \n \n - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool\n - projects/project/zones/zone/storagePools/storagePool \n - zones/zone/storagePools/storagePool", + "type": "string" + }, + "type": { + "description": "URL of the disk type resource describing which disk type to use to create\nthe disk. Provide this when creating the disk. For example:projects/project/zones/zone/diskTypes/pd-ssd. See Persistent disk\ntypes.", + "type": "string" + }, + "users": { + "description": "Output only. [Output Only] Links to the users of the disk (attached instances)\nin form:projects/project/zones/zone/instances/instance", + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "region", - "securityPolicy" - ], - "request": { - "$ref": "SecurityPolicy" + "readOnly": true, + "type": "array" + }, + "zone": { + "description": "Output only. [Output Only] URL of the zone where the disk resides.\nYou must specify this field as part of the HTTP request URL. It is\nnot settable as a field in the request body.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "DiskAggregatedList": { + "id": "DiskAggregatedList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "additionalProperties": { + "$ref": "DisksScopedList", + "description": "[Output Only] Name of the scope containing this set of disks." }, - "response": { - "$ref": "Operation" + "description": "A list of DisksScopedList resources.", + "type": "object" + }, + "kind": { + "default": "compute#diskAggregatedList", + "description": "Output only. [Output Only] Type of resource. Alwayscompute#diskAggregatedList for aggregated lists of persistent\ndisks.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "unreachables": { + "description": "Output only. [Output Only] Unreachable resources.", + "items": { + "type": "string" }, - "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." + "readOnly": true, + "type": "array" }, - "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, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project", - "region", - "securityPolicy" + "type": "object" + } + }, + "type": "object" + }, + "DiskAsyncReplication": { + "id": "DiskAsyncReplication", + "properties": { + "consistencyGroupPolicy": { + "description": "Output only. [Output Only] URL of the DiskConsistencyGroupPolicy if replication was\nstarted on the disk as a member of a group.", + "readOnly": true, + "type": "string" + }, + "consistencyGroupPolicyId": { + "description": "Output only. [Output Only] ID of the DiskConsistencyGroupPolicy if replication was\nstarted on the disk as a member of a group.", + "readOnly": true, + "type": "string" + }, + "disk": { + "description": "The other disk asynchronously replicated to or from the current disk.\nYou can provide this as a partial or full URL to the resource.\nFor example, the following are valid values:\n \n \n - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk \n - projects/project/zones/zone/disks/disk \n - zones/zone/disks/disk", + "type": "string" + }, + "diskId": { + "description": "Output only. [Output Only] The unique ID of the other disk asynchronously replicated\nto or from the current disk. This value identifies the exact disk that\nwas used to create this replication. For example, if you started\nreplicating the persistent disk from a disk that was later deleted and\nrecreated under the same name, the disk ID would identify the exact\nversion of the disk that was used.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "DiskAsyncReplicationList": { + "id": "DiskAsyncReplicationList", + "properties": { + "asyncReplicationDisk": { + "$ref": "DiskAsyncReplication" + } + }, + "type": "object" + }, + "DiskInstantiationConfig": { + "description": "A specification of the desired way to instantiate a disk in the instance\ntemplate when its created from a source instance.", + "id": "DiskInstantiationConfig", + "properties": { + "autoDelete": { + "description": "Specifies whether the disk will be auto-deleted when the instance is\ndeleted (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\nthis instance template.", + "type": "string" + }, + "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\nvalues are:\n \n \n - source-image: to use the same image that was used to\n create the source instance's corresponding disk. Applicable to the boot\n disk and additional read-write disks.\n - source-image-family: to use the same image family that\n was used to create the source instance's corresponding disk. Applicable\n to the boot disk and additional read-write disks.\n - custom-image: to use a user-provided image url for disk\n creation. Applicable to the boot disk and additional read-write\n disks. \n - attach-read-only: to attach a read-only\n disk. Applicable to read-only disks.\n - do-not-include: to exclude a disk from the template.\n Applicable to additional read-write disks, local SSDs, and read-only\n disks.", + "enum": [ + "ATTACH_READ_ONLY", + "BLANK", + "CUSTOM_IMAGE", + "DEFAULT", + "DO_NOT_INCLUDE", + "SOURCE_IMAGE", + "SOURCE_IMAGE_FAMILY" ], - "response": { - "$ref": "SecurityPolicyRule" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "Attach the existing disk in read-only mode. The request will fail if the\ndisk was attached in read-write mode on the source instance. Applicable\nto: read-only disks.", + "Create a blank disk. The disk will be created unformatted. Applicable to:\nadditional read-write disks, local SSDs.", + "Use the custom image specified in the custom_image field. Applicable to:\nboot disk, additional read-write disks.", + "Use the default instantiation option for the corresponding type of disk.\nFor boot disk and any other R/W disks, new custom images will be created\nfrom each disk. For read-only disks, they will be attached in read-only\nmode. Local SSD disks will be created as blank volumes.", + "Do not include the disk in the instance template. Applicable to:\nadditional read-write disks, local SSDs, read-only disks.", + "Use the same source image used for creation of the source instance's\ncorresponding disk. The request will fail if the source VM's disk was\ncreated from a snapshot. Applicable to: boot disk, additional read-write\ndisks.", + "Use the same source image family used for creation of the source\ninstance's corresponding disk. The request will fail if the source image\nof the source disk does not belong to any image family. Applicable to:\nboot disk, additional read-write disks." ], - "description": "Gets a rule at the specified priority." + "type": "string" + } + }, + "type": "object" + }, + "DiskList": { + "description": "A list of Disk resources.", + "id": "DiskList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "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, + "items": { + "description": "A list of Disk resources.", + "items": { + "$ref": "Disk" + }, + "type": "array" + }, + "kind": { + "default": "compute#diskList", + "description": "Output only. [Output Only] Type of resource. Always compute#diskList for\nlists of disks.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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, + "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" } }, - "parameterOrder": [ - "project", - "region", - "securityPolicy" - ], - "request": { - "$ref": "SecurityPolicyRule" + "type": "object" + } + }, + "type": "object" + }, + "DiskMoveRequest": { + "id": "DiskMoveRequest", + "properties": { + "destinationZone": { + "description": "The URL of the destination zone to move the disk. This can be a full or\npartial URL. For example, the following are all valid URLs to a zone:\n \n - https://www.googleapis.com/compute/v1/projects/project/zones/zone \n - projects/project/zones/zone \n - zones/zone", + "type": "string" + }, + "targetDisk": { + "description": "The URL of the target disk to move. This can be a full or partial URL.\nFor example, the following are all valid URLs to a disk:\n \n - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk \n - projects/project/zones/zone/disks/disk \n - zones/zone/disks/disk", + "type": "string" + } + }, + "type": "object" + }, + "DiskParams": { + "description": "Additional disk params.", + "id": "DiskParams", + "properties": { + "resourceManagerTags": { + "additionalProperties": { + "type": "string" }, - "response": { - "$ref": "Operation" + "description": "Input only. Resource manager tags to be bound to the disk. Tag keys and values\nhave the same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in\nnamespaced format such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT &\nPATCH) when empty.", + "type": "object" + } + }, + "type": "object" + }, + "DiskResourceStatus": { + "id": "DiskResourceStatus", + "properties": { + "asyncPrimaryDisk": { + "$ref": "DiskResourceStatusAsyncReplicationStatus" + }, + "asyncSecondaryDisks": { + "additionalProperties": { + "$ref": "DiskResourceStatusAsyncReplicationStatus" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "description": "Key: disk, value: AsyncReplicationStatus message", + "type": "object" + } + }, + "type": "object" + }, + "DiskResourceStatusAsyncReplicationStatus": { + "id": "DiskResourceStatusAsyncReplicationStatus", + "properties": { + "state": { + "enum": [ + "ACTIVE", + "CREATED", + "STARTING", + "STATE_UNSPECIFIED", + "STOPPED", + "STOPPING" + ], + "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": "Inserts a rule into a security policy." + "type": "string" + } + }, + "type": "object" + }, + "DiskType": { + "description": "Represents a Disk Type resource.\n\nGoogle Compute Engine has two Disk Type resources:\n\n* [Regional](/compute/docs/reference/rest/v1/regionDiskTypes)\n* [Zonal](/compute/docs/reference/rest/v1/diskTypes)\n\nYou can choose from a variety of disk types based on your needs.\nFor more information, readStorage options.\n\nThe diskTypes resource represents disk types for a zonal\npersistent disk.\nFor more information, readZonal persistent disks.\n\nThe regionDiskTypes resource represents disk types for a\nregional persistent disk. For more information, read Regional persistent disks.", + "id": "DiskType", + "properties": { + "creationTimestamp": { + "description": "[Output Only] Creation timestamp inRFC3339\ntext format.", + "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" - } + "defaultDiskSizeGb": { + "description": "[Output Only] Server-defined default disk size in GB.", + "format": "int64", + "type": "string" + }, + "deprecated": { + "$ref": "DeprecationStatus", + "description": "[Output Only] The deprecation status associated with this disk type." + }, + "description": { + "description": "[Output Only] An optional description of this resource.", + "type": "string" + }, + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "format": "uint64", + "type": "string" + }, + "kind": { + "default": "compute#diskType", + "description": "Output only. [Output Only] Type of the resource. Always compute#diskType\nfor disk types.", + "readOnly": true, + "type": "string" + }, + "name": { + "description": "[Output Only] Name of the resource.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "region": { + "description": "[Output Only] URL of the region where the disk type resides. Only\napplicable for regional resources.\nYou must specify this field as part of the HTTP request URL. It is\nnot settable as a field in the request body.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" + }, + "validDiskSize": { + "description": "[Output Only] An optional textual description of the valid disk size,\nsuch as \"10GB-10TB\".", + "type": "string" + }, + "zone": { + "description": "[Output Only] URL of the zone where the disk type resides.\nYou must specify this field as part of the HTTP request URL. It is\nnot settable as a field in the request body.", + "type": "string" + } + }, + "type": "object" + }, + "DiskTypeAggregatedList": { + "id": "DiskTypeAggregatedList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "additionalProperties": { + "$ref": "DiskTypesScopedList", + "description": "[Output Only] Name of the scope containing this set of disk types." }, - "parameterOrder": [ - "project", - "region", - "securityPolicy" - ], - "response": { - "$ref": "Operation" + "description": "A list of DiskTypesScopedList resources.", + "type": "object" + }, + "kind": { + "default": "compute#diskTypeAggregatedList", + "description": "Output only. [Output Only] Type of resource. Alwayscompute#diskTypeAggregatedList.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "unreachables": { + "description": "Output only. [Output Only] Unreachable resources.", + "items": { + "type": "string" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes a rule at the specified priority." + "readOnly": true, + "type": "array" }, - "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, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "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" + "type": "object" + } + }, + "type": "object" + }, + "DiskTypeList": { + "description": "Contains a list of disk types.", + "id": "DiskTypeList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of DiskType resources.", + "items": { + "$ref": "DiskType" }, - "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." + "type": "array" }, - "setLabels": { - "id": "compute.regionSecurityPolicies.setLabels", - "path": "projects/{project}/regions/{region}/securityPolicies/{resource}/setLabels", - "flatPath": "projects/{project}/regions/{region}/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" - }, - "region": { - "description": "The region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, + "kind": { + "default": "compute#diskTypeList", + "description": "Output only. [Output Only] Type of resource. Always compute#diskTypeList\nfor disk types.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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" } }, - "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 security policy. To learn more about labels, read the Labeling Resources documentation." + "type": "object" } - } + }, + "type": "object" }, - "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, + "DiskTypesScopedList": { + "id": "DiskTypesScopedList", + "properties": { + "diskTypes": { + "description": "[Output Only] A list of disk types contained in this scope.", + "items": { + "$ref": "DiskType" + }, + "type": "array" + }, + "warning": { + "description": "[Output Only] Informational warning which replaces the list of disk types\nwhen the list is empty.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project", - "zone" - ], - "response": { - "$ref": "InstanceList" + "type": "object" + } + }, + "type": "object" + }, + "DiskUpdateKmsKeyRequest": { + "id": "DiskUpdateKmsKeyRequest", + "properties": { + "kmsKeyName": { + "description": "Optional. The new KMS key to replace the current one on the disk. If empty, the disk\nwill be re-encrypted using the primary version of the disk's current KMS\nkey.\n\nThe KMS key can be provided in the following formats:\n \n \n - projects/project_id/locations/location/keyRings/key_ring/cryptoKeys/key\n\n\nWhere project is the project ID or\nproject number.", + "type": "string" + } + }, + "type": "object" + }, + "DisksAddResourcePoliciesRequest": { + "id": "DisksAddResourcePoliciesRequest", + "properties": { + "resourcePolicies": { + "description": "Full or relative path to the resource policy to be added to this disk. You\ncan only specify one resource policy.", + "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 the list of instances contained within the specified zone." + "type": "array" + } + }, + "type": "object" + }, + "DisksRemoveResourcePoliciesRequest": { + "id": "DisksRemoveResourcePoliciesRequest", + "properties": { + "resourcePolicies": { + "description": "Resource policies to be removed from this disk.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, + "DisksResizeRequest": { + "id": "DisksResizeRequest", + "properties": { + "sizeGb": { + "description": "The new size of the persistent disk, which is specified in GB.", + "format": "int64", + "type": "string" + } + }, + "type": "object" + }, + "DisksScopedList": { + "id": "DisksScopedList", + "properties": { + "disks": { + "description": "[Output Only] A list of disks contained in this scope.", + "items": { + "$ref": "Disk" + }, + "type": "array" }, - "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", + "warning": { + "description": "[Output Only] Informational warning which replaces the list of disks when\nthe list is empty.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "pageToken": { - "description": "Specifies a page token 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{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" } }, - "parameterOrder": [ - "project" + "type": "object" + } + }, + "type": "object" + }, + "DisksStartAsyncReplicationRequest": { + "id": "DisksStartAsyncReplicationRequest", + "properties": { + "asyncSecondaryDisk": { + "description": "The secondary disk to start asynchronous replication to.\nYou can provide this as a partial or full URL to the resource. For example,\nthe following are valid values:\n \n \n - \n https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk\n \n - \n https://www.googleapis.com/compute/v1/projects/project/regions/region/disks/disk\n \n - \n projects/project/zones/zone/disks/disk\n \n - \n projects/project/regions/region/disks/disk\n \n - \n zones/zone/disks/disk\n \n - \n regions/region/disks/disk", + "type": "string" + } + }, + "type": "object" + }, + "DisksStopGroupAsyncReplicationResource": { + "description": "A transient resource used in compute.disks.stopGroupAsyncReplication and\ncompute.regionDisks.stopGroupAsyncReplication. It is only used to process\nrequests and is not persisted.", + "id": "DisksStopGroupAsyncReplicationResource", + "properties": { + "resourcePolicy": { + "description": "The URL of the DiskConsistencyGroupPolicy for the group of disks to stop.\nThis may be a full or partial URL, such as:\n \n \n - \n https://www.googleapis.com/compute/v1/projects/project/regions/region/resourcePolicies/resourcePolicy\n \n - \n projects/project/regions/region/resourcePolicies/resourcePolicy\n \n - \n regions/region/resourcePolicies/resourcePolicy", + "type": "string" + } + }, + "type": "object" + }, + "DisplayDevice": { + "description": "A set of Display Device options", + "id": "DisplayDevice", + "properties": { + "enableDisplay": { + "description": "Defines whether the instance has Display enabled.", + "type": "boolean" + } + }, + "type": "object" + }, + "DistributionPolicy": { + "id": "DistributionPolicy", + "properties": { + "targetShape": { + "description": "The distribution shape to which the group converges either proactively or\non resize events (depending on the value set inupdatePolicy.instanceRedistributionType).", + "enum": [ + "ANY", + "ANY_SINGLE_ZONE", + "BALANCED", + "EVEN" ], - "response": { - "$ref": "InstanceAggregatedList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "The group picks zones for creating VM instances to fulfill the requested\nnumber of VMs within present resource constraints and to maximize\nutilization of unused zonal reservations. Recommended for batch workloads\nthat do not require high availability.", + "The group creates all VM instances within a single zone. The zone is\nselected based on the present resource constraints and to maximize\nutilization of unused zonal reservations.\nRecommended for batch workloads with heavy interprocess communication.", + "The group prioritizes acquisition of resources, scheduling VMs in zones\nwhere resources are available while distributing VMs as evenly as\npossible across selected zones to minimize the impact of zonal failure.\nRecommended for highly available serving workloads.", + "The group schedules VM instance creation and deletion to achieve and\nmaintain an even number of managed instances across the selected zones.\nThe distribution is even when the number of managed instances does not\ndiffer by more than 1 between any two zones. Recommended for highly\navailable serving workloads." ], - "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`." + "type": "string" }, - "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" - } + "zones": { + "description": "Zones where the regional managed instance group will create and manage\nits instances.\nBy default, a regional MIG doesn't automatically select an AI zone to create\ninstances, even if an AI zone is available in the specified region. To\ncreate instances in an AI zone in the selected region, you must explicitly\nspecify it in the distribution policy together with the other preferred\nzones.", + "items": { + "$ref": "DistributionPolicyZoneConfiguration" }, - "parameterOrder": [ - "project", - "zone", - "instance" + "type": "array" + } + }, + "type": "object" + }, + "DistributionPolicyZoneConfiguration": { + "id": "DistributionPolicyZoneConfiguration", + "properties": { + "zone": { + "annotations": { + "required": [ + "compute.regionInstanceGroupManagers.insert" + ] + }, + "description": "The URL of thezone.\nThe zone must exist in the region where the managed instance group is\nlocated.", + "type": "string" + } + }, + "type": "object" + }, + "Duration": { + "description": "A Duration represents a fixed-length span of time represented\nas a count of seconds and fractions of seconds at nanosecond\nresolution. It is independent of any calendar and concepts like \"day\"\nor \"month\". Range is approximately 10,000 years.", + "id": "Duration", + "properties": { + "nanos": { + "description": "Span of time that's a fraction of a second at nanosecond resolution.\nDurations less than one second are represented with a 0\n`seconds` field and a positive `nanos` field. Must be from 0\nto 999,999,999 inclusive.", + "format": "int32", + "type": "integer" + }, + "seconds": { + "description": "Span of time at a resolution of a second. Must be from 0\nto 315,576,000,000 inclusive. Note: these bounds are computed from:\n60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years", + "format": "int64", + "type": "string" + } + }, + "type": "object" + }, + "ErrorInfo": { + "description": "Describes the cause of the error with structured details.\n\nExample of an error when contacting the \"pubsub.googleapis.com\" API when it\nis not enabled:\n\n { \"reason\": \"API_DISABLED\"\n \"domain\": \"googleapis.com\"\n \"metadata\": {\n \"resource\": \"projects/123\",\n \"service\": \"pubsub.googleapis.com\"\n }\n }\n\nThis response indicates that the pubsub.googleapis.com API is not enabled.\n\nExample of an error that is returned when attempting to create a Spanner\ninstance in a region that is out of stock:\n\n { \"reason\": \"STOCKOUT\"\n \"domain\": \"spanner.googleapis.com\",\n \"metadata\": {\n \"availableRegions\": \"us-central1,us-east2\"\n }\n }", + "id": "ErrorInfo", + "properties": { + "domain": { + "description": "The logical grouping to which the \"reason\" belongs. The error domain\nis typically the registered service name of the tool or product that\ngenerates the error. Example: \"pubsub.googleapis.com\". If the error is\ngenerated by some common infrastructure, the error domain must be a\nglobally unique value that identifies the infrastructure. For Google API\ninfrastructure, the error domain is \"googleapis.com\".", + "type": "string" + }, + "metadatas": { + "additionalProperties": { + "type": "string" + }, + "description": "Additional structured details about this error.\n\nKeys must match a regular expression of `a-z+` but should\nideally be lowerCamelCase. Also, they must be limited to 64 characters in\nlength. When identifying the current value of an exceeded limit, the units\nshould be contained in the key, not the value. For example, rather than\n`{\"instanceLimit\": \"100/request\"}`, should be returned as,\n`{\"instanceLimitPerRequest\": \"100\"}`, if the client exceeds the number of\ninstances that can be created in a single (batch) request.", + "type": "object" + }, + "reason": { + "description": "The reason of the error. This is a constant value that identifies the\nproximate cause of the error. Error reasons are unique within a particular\ndomain of errors. This should be at most 63 characters and match a\nregular expression of `A-Z+[A-Z0-9]`, which represents\nUPPER_SNAKE_CASE.", + "type": "string" + } + }, + "type": "object" + }, + "ExchangedPeeringRoute": { + "id": "ExchangedPeeringRoute", + "properties": { + "destRange": { + "description": "The destination range of the route.", + "type": "string" + }, + "imported": { + "description": "True if the peering route has been imported from a peer. The actual import\nhappens if the field networkPeering.importCustomRoutes is true\nfor this network, and networkPeering.exportCustomRoutes is\ntrue for the peer network, and the import does not result in a route\nconflict.", + "type": "boolean" + }, + "nextHopRegion": { + "description": "The region of peering route next hop, only applies to dynamic routes.", + "type": "string" + }, + "priority": { + "description": "The priority of the peering route.", + "format": "uint32", + "type": "integer" + }, + "type": { + "description": "The type of the peering route.", + "enum": [ + "DYNAMIC_PEERING_ROUTE", + "STATIC_PEERING_ROUTE", + "SUBNET_PEERING_ROUTE" ], - "response": { - "$ref": "InstanceListReferrers" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "For routes exported from local network.", + "The peering route.", + "The peering route corresponding to subnetwork range." ], - "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." + "type": "string" + } + }, + "type": "object" + }, + "ExchangedPeeringRoutesList": { + "id": "ExchangedPeeringRoutesList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "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" + "items": { + "description": "A list of ExchangedPeeringRoute resources.", + "items": { + "$ref": "ExchangedPeeringRoute" }, - "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." + "type": "array" }, - "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", + "kind": { + "default": "compute#exchangedPeeringRoutesList", + "description": "Output only. [Output Only] Type of resource. Alwayscompute#exchangedPeeringRoutesList for exchanged peering\nroutes lists.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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" + "data": { + "description": "[Output Only] Metadata about this warning in key:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project", - "zone" - ], - "request": { - "$ref": "Instance" + "type": "object" + } + }, + "type": "object" + }, + "Expr": { + "description": "Represents a textual expression in the Common Expression Language (CEL)\nsyntax. CEL is a C-like expression language. The syntax and semantics of CEL\nare documented at https://github.com/google/cel-spec.\n\nExample (Comparison):\n\n title: \"Summary size limit\"\n description: \"Determines if a summary is less than 100 chars\"\n expression: \"document.summary.size() < 100\"\n\nExample (Equality):\n\n title: \"Requestor is owner\"\n description: \"Determines if requestor is the document owner\"\n expression: \"document.owner == request.auth.claims.email\"\n\nExample (Logic):\n\n title: \"Public documents\"\n description: \"Determine whether the document should be publicly visible\"\n expression: \"document.type != 'private' && document.type != 'internal'\"\n\nExample (Data Manipulation):\n\n title: \"Notification string\"\n description: \"Create a notification string with a timestamp.\"\n expression: \"'New message received at ' + string(document.create_time)\"\n\nThe exact variables and functions that may be referenced within an expression\nare determined by the service that evaluates it. See the service\ndocumentation for additional information.", + "id": "Expr", + "properties": { + "description": { + "description": "Optional. Description of the expression. This is a longer text which\ndescribes the expression, e.g. when hovered over it in a UI.", + "type": "string" + }, + "expression": { + "description": "Textual representation of an expression in Common Expression Language\nsyntax.", + "type": "string" + }, + "location": { + "description": "Optional. String indicating the location of the expression for error\nreporting, e.g. a file name and a position in the file.", + "type": "string" + }, + "title": { + "description": "Optional. Title for the expression, i.e. a short string describing\nits purpose. This can be used e.g. in UIs which allow to enter the\nexpression.", + "type": "string" + } + }, + "type": "object" + }, + "ExternalVpnGateway": { + "description": "Represents an external VPN gateway.\n\nExternal VPN gateway is the on-premises VPN gateway(s) or another cloud\nprovider's VPN gateway that connects to your Google Cloud VPN gateway.\n\nTo create a highly available VPN from Google Cloud Platform to your\nVPN gateway or another cloud provider's VPN gateway, you must create a\nexternal VPN gateway resource with information about the other gateway.\n\nFor more information about using external VPN gateways, see\nCreating an HA VPN gateway and tunnel pair to a peer VPN.", + "id": "ExternalVpnGateway", + "properties": { + "creationTimestamp": { + "description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you\ncreate the resource.", + "type": "string" + }, + "id": { + "description": "Output only. [Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "format": "uint64", + "readOnly": true, + "type": "string" + }, + "interfaces": { + "description": "A list of interfaces for this external VPN gateway.\n\nIf your peer-side gateway is an on-premises gateway and non-AWS cloud\nproviders' gateway, at most two interfaces can be provided for an external\nVPN gateway. If your peer side is an AWS virtual private gateway, four\ninterfaces should be provided for an external VPN gateway.", + "items": { + "$ref": "ExternalVpnGatewayInterface" }, - "response": { - "$ref": "Operation" + "type": "array" + }, + "kind": { + "default": "compute#externalVpnGateway", + "description": "Output only. [Output Only] Type of the resource. Alwayscompute#externalVpnGateway for externalVpnGateways.", + "readOnly": true, + "type": "string" + }, + "labelFingerprint": { + "description": "A fingerprint for the labels being applied to this ExternalVpnGateway,\nwhich is essentially a hash of the labels set used for optimistic locking.\nThe fingerprint is initially generated by Compute Engine and changes after\nevery request to modify or update labels. You must always provide an\nup-to-date fingerprint hash in order to update or change labels,\notherwise the request will fail with error412 conditionNotMet.\n\nTo see the latest fingerprint, make a get() request to\nretrieve an ExternalVpnGateway.", + "format": "byte", + "type": "string" + }, + "labels": { + "additionalProperties": { + "type": "string" }, - "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." + "description": "Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035.\nLabel values may be empty.", + "type": "object" }, - "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" - } + "name": { + "annotations": { + "required": [ + "compute.externalVpnGateways.insert" + ] }, - "parameterOrder": [ - "project", - "zone", - "instance" + "description": "Name of the resource. Provided by the client when the resource is created.\nThe name must be 1-63 characters long, and comply withRFC1035.\nSpecifically, the name must be 1-63 characters long and match the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first\ncharacter must be a lowercase letter, and all following characters must be\na dash, lowercase letter, or digit, except the last character, which cannot\nbe a dash.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "params": { + "$ref": "ExternalVpnGatewayParams", + "description": "Input only. [Input Only] Additional params passed with the request, but not persisted\nas part of resource payload." + }, + "redundancyType": { + "description": "Indicates the user-supplied redundancy type of this external VPN gateway.", + "enum": [ + "FOUR_IPS_REDUNDANCY", + "SINGLE_IP_INTERNALLY_REDUNDANT", + "TWO_IPS_REDUNDANCY" ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "The external VPN gateway has four public IP addresses; at the time of\nwriting this API, the AWS virtual private gateway is an example which has\nfour public IP addresses for high availability connections; there should\nbe two VPN connections in the AWS virtual private gateway , each AWS VPN\nconnection has two public IP addresses; please make sure to put two\npublic IP addresses from one AWS VPN connection into interfaces 0 and 1\nof this external VPN gateway, and put the other two public IP addresses\nfrom another AWS VPN connection into interfaces 2 and 3 of this external\nVPN gateway. When displaying highly available configuration status\nfor the VPN tunnels connected to FOUR_IPS_REDUNDANCY external VPN\ngateway, Google will always detect whether interfaces 0 and 1 are\nconnected on one interface of HA Cloud VPN gateway, and detect whether\ninterfaces 2 and 3 are connected to another interface of the HA Cloud VPN\ngateway.", + "The external VPN gateway has only one public IP address which internally\nprovide redundancy or failover.", + "The external VPN gateway has two public IP addresses which are redundant\nwith each other, the following two types of setup on your on-premises\nside would have this type of redundancy:\n(1) Two separate on-premises gateways, each with one public IP address,\n the two on-premises gateways are redundant with each other.\n(2) A single on-premise gateway with two public IP addresses that are\n redundant with eatch other." ], - "description": "Deletes the specified Instance resource. For more information, see Deleting an instance." + "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" + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for the resource.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "ExternalVpnGatewayInterface": { + "description": "The interface for the external VPN gateway.", + "id": "ExternalVpnGatewayInterface", + "properties": { + "id": { + "description": "The numeric ID of this interface.\nThe allowed input values for this id for different redundancy types of\nexternal VPN gateway:\n \n - SINGLE_IP_INTERNALLY_REDUNDANT - 0\n - TWO_IPS_REDUNDANCY - 0, 1\n - FOUR_IPS_REDUNDANCY - 0, 1, 2, 3", + "format": "uint32", + "type": "integer" + }, + "ipAddress": { + "description": "IP address of the interface in the external VPN gateway. Only IPv4 is\nsupported. This IP address can be either from your on-premise gateway or\nanother Cloud provider's VPN gateway, it cannot be an IP address from\nGoogle Compute Engine.", + "type": "string" + }, + "ipv6Address": { + "description": "IPv6 address of the interface in the external VPN gateway. This IPv6\naddress can be either from your on-premise gateway or another Cloud\nprovider's VPN gateway, it cannot be an IP address from Google Compute\nEngine. Must specify an IPv6 address (not IPV4-mapped) using any format\ndescribed in RFC 4291 (e.g. 2001:db8:0:0:2d9:51:0:0). The output format\nis RFC 5952 format (e.g. 2001:db8::2d9:51:0:0).", + "type": "string" + } + }, + "type": "object" + }, + "ExternalVpnGatewayList": { + "description": "Response to the list request, and contains a list of externalVpnGateways.", + "id": "ExternalVpnGatewayList", + "properties": { + "etag": { + "type": "string" + }, + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of ExternalVpnGateway resources.", + "items": { + "$ref": "ExternalVpnGateway" }, - "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": "array" }, - "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", + "kind": { + "default": "compute#externalVpnGatewayList", + "description": "Output only. [Output Only] Type of resource. Always compute#externalVpnGatewayList for lists of externalVpnGateways.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "withExtendedNotifications": { - "description": "Determines whether the customers receive notifications before migration. Only applicable to SF vms.", - "location": "query", - "type": "boolean" + "data": { + "description": "[Output Only] Metadata about this warning in key:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project", - "zone", - "instance" - ], - "response": { - "$ref": "Operation" + "type": "object" + } + }, + "type": "object" + }, + "ExternalVpnGatewayParams": { + "id": "ExternalVpnGatewayParams", + "properties": { + "resourceManagerTags": { + "additionalProperties": { + "type": "string" }, - "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." + "description": "Tag keys/values directly bound to this resource.\nTag keys and values have the same definition as resource\nmanager tags. The field is allowed for INSERT\nonly. The keys/values to set on the resource should be specified in\neither ID { : } or Namespaced format\n{ : }.\nFor example the following are valid inputs:\n* {\"tagKeys/333\" : \"tagValues/444\", \"tagKeys/123\" : \"tagValues/456\"}\n* {\"123/environment\" : \"production\", \"345/abc\" : \"xyz\"}\nNote:\n* Invalid combinations of ID & namespaced format is not supported. For\n instance: {\"123/environment\" : \"tagValues/444\"} is invalid.\n* Inconsistent format is not supported. For instance:\n {\"tagKeys/333\" : \"tagValues/444\", \"123/env\" : \"prod\"} is invalid.", + "type": "object" + } + }, + "type": "object" + }, + "FileContentBuffer": { + "id": "FileContentBuffer", + "properties": { + "content": { + "description": "The raw content in the secure keys file.", + "format": "byte", + "type": "string" }, - "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" + "fileType": { + "description": "The file type of source file.", + "enum": [ + "BIN", + "UNDEFINED", + "X509" + ], + "enumDescriptions": [ + "", + "", + "" + ], + "type": "string" + } + }, + "type": "object" + }, + "Firewall": { + "description": "Represents a Firewall Rule resource.\n\nFirewall rules allow or deny ingress traffic to, and egress traffic from your\ninstances. For more information, readFirewall rules.", + "id": "Firewall", + "properties": { + "allowed": { + "description": "The list of ALLOW rules specified by this firewall. Each rule specifies a\nprotocol and port-range tuple that describes a permitted connection.", + "items": { + "properties": { + "IPProtocol": { + "description": "The IP protocol to which this rule applies. The protocol type is\nrequired when creating a firewall rule. This value can either be one of the\nfollowing 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.\nThis field is only applicable for the UDP or TCP protocol.\nEach entry must be either an integer or a range.\nIf not specified, this rule applies to connections through any port.\n\nExample inputs include: [\"22\"], [\"80\",\"443\"],\nand [\"12345-12349\"].", + "items": { + "type": "string" + }, + "type": "array" + } }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" + "type": "object" + }, + "type": "array" + }, + "creationTimestamp": { + "description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", + "readOnly": true, + "type": "string" + }, + "denied": { + "description": "The list of DENY rules specified by this firewall. Each rule specifies a\nprotocol and port-range tuple that describes a denied connection.", + "items": { + "properties": { + "IPProtocol": { + "description": "The IP protocol to which this rule applies. The protocol type is\nrequired when creating a firewall rule. This value can either be one of the\nfollowing 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.\nThis field is only applicable for the UDP or TCP protocol.\nEach entry must be either an integer or a range.\nIf not specified, this rule applies to connections through any port.\n\nExample inputs include: [\"22\"], [\"80\",\"443\"],\nand [\"12345-12349\"].", + "items": { + "type": "string" + }, + "type": "array" + } }, - "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": "object" }, - "parameterOrder": [ - "project", - "zone", - "instance" - ], - "response": { - "$ref": "Operation" + "type": "array" + }, + "description": { + "description": "An optional description of this resource. Provide this field when you\ncreate the resource.", + "type": "string" + }, + "destinationRanges": { + "description": "If destination ranges are specified, the firewall rule applies only to\ntraffic that has destination IP address in these ranges. These ranges must\nbe expressed inCIDR format. Both IPv4 and IPv6 are supported.", + "items": { + "type": "string" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "type": "array" + }, + "direction": { + "description": "Direction of traffic to which this firewall applies, either `INGRESS` or\n`EGRESS`. The default is `INGRESS`. For `EGRESS` traffic, you cannot\nspecify the sourceTags fields.", + "enum": [ + "EGRESS", + "INGRESS" + ], + "enumDescriptions": [ + "Indicates that firewall should apply to outgoing traffic.", + "Indicates that firewall should apply to incoming traffic." ], - "description": "Perform a manual maintenance on the instance." + "type": "string" }, - "reportHostAsFaulty": { - "id": "compute.instances.reportHostAsFaulty", - "path": "projects/{project}/zones/{zone}/instances/{instance}/reportHostAsFaulty", - "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/reportHostAsFaulty", - "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, + "disabled": { + "description": "Denotes whether the firewall rule is disabled. When set to true, the\nfirewall rule is not enforced and the network behaves as if it did not\nexist. If this is unspecified, the firewall rule will be enabled.", + "type": "boolean" + }, + "id": { + "description": "Output only. [Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "format": "uint64", + "readOnly": true, + "type": "string" + }, + "kind": { + "default": "compute#firewall", + "description": "Output only. [Output Only] Type of the resource. Always compute#firewall\nfor firewall rules.", + "readOnly": true, + "type": "string" + }, + "logConfig": { + "$ref": "FirewallLogConfig", + "description": "This field denotes the logging options for a particular firewall rule. If\nlogging is enabled, logs will be exported to Cloud Logging." + }, + "name": { + "annotations": { + "required": [ + "compute.firewalls.insert", + "compute.firewalls.patch" + ] + }, + "description": "Name of the resource; provided by the client when the resource is created.\nThe name must be 1-63 characters long, and comply withRFC1035.\nSpecifically, the name must be 1-63 characters long and match the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?`. The first character\nmust be a lowercase letter, and all following characters (except for the\nlast character) must be a dash, lowercase letter, or digit. The last\ncharacter must be a lowercase letter or digit.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "network": { + "description": "URL of the network resource for this firewall rule. If not\nspecified when creating a firewall rule, the default network\nis used:\n\nglobal/networks/default\n\nIf you choose to specify this field, you can specify the network as a full \nor partial URL. For example, the following are all valid URLs: \n \n - \n https://www.googleapis.com/compute/v1/projects/myproject/global/networks/my-network \n - projects/myproject/global/networks/my-network \n - global/networks/default", + "type": "string" + }, + "params": { + "$ref": "FirewallParams", + "description": "Input only. [Input Only] Additional params passed with the request, but not persisted\nas part of resource payload." + }, + "priority": { + "description": "Priority for this rule.\nThis is an integer between `0` and `65535`, both inclusive.\nThe default value is `1000`.\nRelative priorities determine which rule takes effect if multiple rules\napply. Lower values indicate higher priority. For example, a rule with\npriority `0` has higher precedence than a rule with priority `1`.\nDENY rules take precedence over ALLOW rules if they have equal priority.\nNote that VPC networks have implied\nrules with a priority of `65535`. To avoid conflicts with the implied\nrules, use a priority number less than `65535`.", + "format": "int32", + "type": "integer" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" + }, + "sourceRanges": { + "description": "If source ranges are specified, the firewall rule applies only to traffic\nthat has a source IP address in these ranges. These ranges must be\nexpressed inCIDR format. One or both of sourceRanges\nand sourceTags may be set.\nIf both fields are set, the rule applies to traffic that has a\nsource IP address within sourceRanges OR a source IP\nfrom a resource with a matching tag listed in thesourceTags field. The connection does not need to match\nboth fields for the rule to\napply. Both IPv4 and IPv6 are supported.", + "items": { + "type": "string" + }, + "type": "array" + }, + "sourceServiceAccounts": { + "description": "If source service accounts are specified, the firewall rules apply only to\ntraffic originating from an instance with a service account in this list.\nSource service accounts cannot be used to control traffic to an instance's\nexternal IP address because service accounts are associated with an\ninstance, not an IP address.sourceRanges can be set at the same time assourceServiceAccounts.\nIf both are set, the firewall applies to traffic that\nhas a source IP address within the sourceRanges OR a source\nIP that belongs to an instance with service account listed insourceServiceAccount. The connection does not need to match\nboth fields for the firewall to apply.sourceServiceAccounts cannot be used at the same time assourceTags or targetTags.", + "items": { + "type": "string" + }, + "type": "array" + }, + "sourceTags": { + "description": "If source tags are specified, the firewall rule applies only to traffic\nwith source IPs that match the primary network interfaces of VM instances\nthat have the tag and are in the same VPC network.\nSource tags cannot be used to control traffic to an instance's external IP\naddress, it only applies to traffic between instances in the same virtual\nnetwork. Because tags are associated with instances, not IP addresses.\nOne or both of sourceRanges and sourceTags may be\nset. If both fields are set, the firewall applies to traffic that has a\nsource IP address within sourceRanges OR a source IP from a\nresource with a matching tag listed in the sourceTags\nfield. The connection does not need to match both fields for the\nfirewall to apply.", + "items": { + "type": "string" + }, + "type": "array" + }, + "targetServiceAccounts": { + "description": "A list of service accounts indicating sets of instances located in the\nnetwork that may make network connections as specified inallowed[].targetServiceAccounts cannot be used at the same time astargetTags or sourceTags.\nIf neither targetServiceAccounts nor targetTags\nare specified, the firewall rule applies to all instances on the specified\nnetwork.", + "items": { + "type": "string" + }, + "type": "array" + }, + "targetTags": { + "description": "A list of tags that controls which instances the firewall rule\napplies to. If targetTags are specified, then the firewall\nrule applies only to instances in the VPC network that have one of those\ntags. If no targetTags are specified, the firewall rule\napplies to all instances on the specified network.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, + "FirewallList": { + "description": "Contains a list of firewalls.", + "id": "FirewallList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of Firewall resources.", + "items": { + "$ref": "Firewall" + }, + "type": "array" + }, + "kind": { + "default": "compute#firewallList", + "description": "Output only. [Output Only] Type of resource. Always compute#firewallList\nfor lists of firewalls.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project", - "zone", - "instance" + "type": "object" + } + }, + "type": "object" + }, + "FirewallLogConfig": { + "description": "The available logging options for a firewall rule.", + "id": "FirewallLogConfig", + "properties": { + "enable": { + "description": "This field denotes whether to enable logging for a particular firewall\nrule.", + "type": "boolean" + }, + "metadata": { + "description": "This field can only be specified for a particular firewall rule if\nlogging is enabled for that rule. This field denotes whether to include\nor exclude metadata for firewall logs.", + "enum": [ + "EXCLUDE_ALL_METADATA", + "INCLUDE_ALL_METADATA" ], - "request": { - "$ref": "InstancesReportHostAsFaultyRequest" + "enumDescriptions": [ + "", + "" + ], + "type": "string" + } + }, + "type": "object" + }, + "FirewallParams": { + "description": "Additional firewall parameters.", + "id": "FirewallParams", + "properties": { + "resourceManagerTags": { + "additionalProperties": { + "type": "string" }, - "response": { - "$ref": "Operation" + "description": "Tag keys/values directly bound to this resource.\nTag keys and values have the same definition as resource\nmanager tags. The field is allowed for INSERT\nonly. The keys/values to set on the resource should be specified in\neither ID { : } or Namespaced format\n{ : }.\nFor example the following are valid inputs:\n* {\"tagKeys/333\" : \"tagValues/444\", \"tagKeys/123\" : \"tagValues/456\"}\n* {\"123/environment\" : \"production\", \"345/abc\" : \"xyz\"}\nNote:\n* Invalid combinations of ID & namespaced format is not supported. For\n instance: {\"123/environment\" : \"tagValues/444\"} is invalid.", + "type": "object" + } + }, + "type": "object" + }, + "FirewallPoliciesListAssociationsResponse": { + "id": "FirewallPoliciesListAssociationsResponse", + "properties": { + "associations": { + "description": "A list of associations.", + "items": { + "$ref": "FirewallPolicyAssociation" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Mark the host as faulty and try to restart the instance on a new host." + "type": "array" }, - "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, + "kind": { + "default": "compute#firewallPoliciesListAssociationsResponse", + "description": "Output only. [Output Only] Type of firewallPolicy associations. Alwayscompute#FirewallPoliciesListAssociations for lists of\nfirewallPolicy associations.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "FirewallPoliciesScopedList": { + "id": "FirewallPoliciesScopedList", + "properties": { + "firewallPolicies": { + "description": "A list of firewall policies contained in this scope.", + "items": { + "$ref": "FirewallPolicy" + }, + "type": "array" + }, + "warning": { + "description": "Informational warning which replaces the list of firewall policies when\nthe list is empty.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project", - "zone", - "instance", - "networkInterface" - ], - "request": { - "$ref": "AccessConfig" - }, - "response": { - "$ref": "Operation" + "type": "object" + } + }, + "type": "object" + }, + "FirewallPolicy": { + "description": "Represents a Firewall Policy resource.", + "id": "FirewallPolicy", + "properties": { + "associations": { + "description": "A list of associations that belong to this firewall policy.", + "items": { + "$ref": "FirewallPolicyAssociation" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Adds an access config to an instance's network interface." + "type": "array" }, - "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" - } + "creationTimestamp": { + "description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you\ncreate the resource.", + "type": "string" + }, + "displayName": { + "deprecated": true, + "description": "Deprecated, please use short name instead. User-provided name of the\nOrganization firewall policy. The name should be unique in the organization\nin which the firewall policy is created.\nThis field is not applicable to network firewall policies.\nThis name must be set on creation and cannot be changed.\nThe name must be 1-63 characters long, and comply\nwith RFC1035. Specifically, the name must be 1-63 characters\nlong and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which\nmeans the first character must be a lowercase letter, and all following\ncharacters must be a dash, lowercase letter, or digit, except the last\ncharacter, which cannot be a dash.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "fingerprint": { + "description": "Specifies a fingerprint for this resource, which is essentially a hash of\nthe metadata's contents and used for optimistic locking. The\nfingerprint is initially generated by Compute Engine and changes after\nevery request to modify or update metadata. You must always provide an\nup-to-date fingerprint hash in order to update or change metadata,\notherwise the request will fail with error412 conditionNotMet.\n\nTo see the latest fingerprint, make get() request to the\nfirewall policy.", + "format": "byte", + "type": "string" + }, + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "format": "uint64", + "type": "string" + }, + "kind": { + "default": "compute#firewallPolicy", + "description": "Output only. [Output only] Type of the resource. Alwayscompute#firewallPolicyfor firewall policies", + "readOnly": true, + "type": "string" + }, + "name": { + "description": "Name of the resource. For Organization Firewall Policies it's a\n[Output Only] numeric ID allocated by Google Cloud which uniquely\nidentifies the Organization Firewall Policy.", + "type": "string" + }, + "packetMirroringRules": { + "description": "A list of packet mirroring rules that belong to this policy.", + "items": { + "$ref": "FirewallPolicyRule" }, - "parameterOrder": [ - "project", - "zone", - "instance", - "accessConfig", - "networkInterface" + "type": "array" + }, + "parent": { + "description": "Output only. [Output Only] The parent of the firewall policy.\nThis field is not applicable to network firewall policies.", + "readOnly": true, + "type": "string" + }, + "policyType": { + "description": "The type of the firewall policy. This field can be one of\nVPC_POLICY, RDMA_ROCE_POLICY or ULL_POLICY.\n\nNote: if not specified then VPC_POLICY will be used.", + "enum": [ + "RDMA_ROCE_POLICY", + "ULL_POLICY", + "VPC_POLICY" ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "", + "", + "" ], - "description": "Deletes an access config from an instance's network interface." + "type": "string" }, - "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" + "region": { + "description": "Output only. [Output Only] URL of the region where the regional firewall policy resides.\nThis field is not applicable to global firewall policies.\nYou must specify this field as part of the HTTP request URL. It is\nnot settable as a field in the request body.", + "readOnly": true, + "type": "string" + }, + "ruleTupleCount": { + "description": "Output only. [Output Only] Total count of all firewall policy rule tuples. A firewall\npolicy can not exceed a set number of tuples.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "rules": { + "description": "A list of rules that belong to this policy.\nThere must always be a default rule (rule with priority 2147483647 and\nmatch \"*\"). If no rules are provided when creating a firewall policy, a\ndefault rule with action \"allow\" will be added.", + "items": { + "$ref": "FirewallPolicyRule" }, - "response": { - "$ref": "Operation" + "type": "array" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" + }, + "selfLinkWithId": { + "description": "Output only. [Output Only] Server-defined URL for this resource with the resource id.", + "readOnly": true, + "type": "string" + }, + "shortName": { + "description": "User-provided name of the Organization firewall policy. The name should be\nunique in the organization in which the firewall policy is created.\nThis field is not applicable to network firewall policies.\nThis name must be set on creation and cannot be changed. The name must be\n1-63 characters long, and comply with RFC1035.\nSpecifically, the name must be 1-63 characters long and match the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first\ncharacter must be a lowercase letter, and all following characters must\nbe a dash, lowercase letter, or digit, except the last character, which\ncannot be a dash.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + } + }, + "type": "object" + }, + "FirewallPolicyAssociation": { + "id": "FirewallPolicyAssociation", + "properties": { + "attachmentTarget": { + "description": "The target that the firewall policy is attached to.", + "type": "string" + }, + "displayName": { + "deprecated": true, + "description": "[Output Only] Deprecated, please use short name instead. The display name\nof the firewall policy of the association.", + "type": "string" + }, + "firewallPolicyId": { + "description": "Output only. [Output Only] The firewall policy ID of the association.", + "readOnly": true, + "type": "string" + }, + "name": { + "description": "The name for an association.", + "type": "string" + }, + "shortName": { + "description": "Output only. [Output Only] The short name of the firewall policy of the association.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "FirewallPolicyList": { + "id": "FirewallPolicyList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of FirewallPolicy resources.", + "items": { + "$ref": "FirewallPolicy" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "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." + "type": "array" }, - "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, + "kind": { + "default": "compute#firewallPolicyList", + "description": "Output only. [Output Only] Type of resource. Alwayscompute#firewallPolicyList for listsof FirewallPolicies", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project", - "zone", - "instance", - "networkInterface" + "type": "object" + } + }, + "type": "object" + }, + "FirewallPolicyRule": { + "description": "Represents a rule that describes one or more match conditions along with\nthe action to be taken when traffic matches this condition (allow or deny).", + "id": "FirewallPolicyRule", + "properties": { + "action": { + "description": "The Action to perform when the client connection triggers the rule.\nValid actions for firewall rules are: \"allow\", \"deny\",\n\"apply_security_profile_group\" and \"goto_next\" (\n\"apply_security_profile_group\" can be specified only for global\nnetwork firewall policies or hierarchical firewall policies).\nValid actions for packet mirroring rules are: \"mirror\", \"do_not_mirror\"\nand \"goto_next\".", + "type": "string" + }, + "description": { + "description": "An optional description for this resource.", + "type": "string" + }, + "direction": { + "description": "The direction in which this rule applies.", + "enum": [ + "EGRESS", + "INGRESS" ], - "request": { - "$ref": "NetworkInterface" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "", + "" ], - "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." + "type": "string" }, - "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" - } + "disabled": { + "description": "Denotes whether the firewall policy rule is disabled. When set to true,\nthe firewall policy rule is not enforced and traffic behaves as if it did\nnot exist. If this is unspecified, the firewall policy rule will be\nenabled.", + "type": "boolean" + }, + "enableLogging": { + "description": "Denotes whether to enable logging for a particular rule. If logging is\nenabled, logs will be exported to the configured export destination in\nStackdriver. Logs may be exported to BigQuery or Pub/Sub. Note: you\ncannot enable logging on \"goto_next\" rules.", + "type": "boolean" + }, + "kind": { + "default": "compute#firewallPolicyRule", + "description": "Output only. [Output only] Type of the resource. Returnscompute#firewallPolicyRule for firewall rules andcompute#packetMirroringRule for packet mirroring rules.", + "readOnly": true, + "type": "string" + }, + "match": { + "$ref": "FirewallPolicyRuleMatcher", + "description": "A match condition that incoming traffic is evaluated against.\nIf it evaluates to true, the corresponding 'action' is enforced." + }, + "priority": { + "description": "An integer indicating the priority of a rule in the list. The priority\nmust be a positive value between 0 and 2147483647.\nRules are evaluated from highest to lowest priority where 0 is the\nhighest priority and 2147483647 is the lowest priority.", + "format": "int32", + "type": "integer" + }, + "ruleName": { + "description": "An optional name for the rule. This field is not a unique identifier\nand can be updated.", + "type": "string" + }, + "ruleTupleCount": { + "description": "Output only. [Output Only] Calculation of the complexity of a single firewall policy\nrule.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "securityProfileGroup": { + "description": "A fully-qualified URL of a SecurityProfileGroup resource instance.\nExample:\nhttps://networksecurity.googleapis.com/v1/projects/{project}/locations/{location}/securityProfileGroups/my-security-profile-group\nMust be specified if action is one of 'apply_security_profile_group' or\n'mirror'. Cannot be specified for other actions. Can be specified only\nfor global network firewall policies or hierarchical firewall policies.", + "type": "string" + }, + "targetForwardingRules": { + "description": "A list of forwarding rules to which this rule applies.\nThis field allows you to control which load balancers get this rule.\nFor example, the following are valid values:\n \n \n - https://www.googleapis.com/compute/v1/projects/project/global/forwardingRules/forwardingRule\n - https://www.googleapis.com/compute/v1/projects/project/regions/region/forwardingRules/forwardingRule\n - projects/project/global/\n forwardingRules/forwardingRule\n - projects/project/regions/region/forwardingRules/\n forwardingRule", + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "zone", - "instance" - ], - "request": { - "$ref": "Scheduling" + "type": "array" + }, + "targetResources": { + "description": "A list of network resource URLs to which this rule applies. This field\nallows you to control which network's VMs get this rule. If this field\nis left blank, all VMs within the organization will receive the rule.", + "items": { + "type": "string" }, - "response": { - "$ref": "Operation" + "type": "array" + }, + "targetSecureTags": { + "description": "A list of secure tags that controls which instances the firewall rule\napplies to. If targetSecureTag are specified, then the\nfirewall rule applies only to instances in the VPC network that have one\nof those EFFECTIVE secure tags, if all the target_secure_tag are in\nINEFFECTIVE state, then this rule will be ignored.targetSecureTag may not be set at the same time astargetServiceAccounts.\nIf neither targetServiceAccounts nortargetSecureTag are specified, the firewall rule applies\nto all instances on the specified network.\nMaximum number of target label tags allowed is 256.", + "items": { + "$ref": "FirewallPolicyRuleSecureTag" }, - "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." + "type": "array" }, - "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. Note that the negative start is bounded by the retained buffer size, and the returned serial console output will not exceed the max buffer size.", - "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" - } + "targetServiceAccounts": { + "description": "A list of service accounts indicating the sets of instances that are\napplied with this rule.", + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "zone", - "instance" + "type": "array" + }, + "targetType": { + "description": "Target types of the firewall policy rule.\nDefault value is INSTANCES.", + "enum": [ + "INSTANCES", + "INTERNAL_MANAGED_LB" ], - "response": { - "$ref": "SerialPortOutput" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "", + "" ], - "description": "Returns the last 1 MB of serial port output from the specified instance." + "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" - } + "tlsInspect": { + "description": "Boolean flag indicating if the traffic should be TLS decrypted.\nCan be set only if action = 'apply_security_profile_group' and cannot\nbe set for other actions.", + "type": "boolean" + } + }, + "type": "object" + }, + "FirewallPolicyRuleMatcher": { + "description": "Represents a match condition that incoming traffic is evaluated against.\nExactly one field must be specified.", + "id": "FirewallPolicyRuleMatcher", + "properties": { + "destAddressGroups": { + "description": "Address groups which should be matched against the traffic destination.\nMaximum number of destination address groups is 10.", + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "zone", - "instance" - ], - "response": { - "$ref": "Screenshot" + "type": "array" + }, + "destFqdns": { + "description": "Fully Qualified Domain Name (FQDN) which should be matched against\ntraffic destination.\nMaximum number of destination fqdn allowed is 100.", + "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": "Returns the screenshot from the specified instance." + "type": "array" }, - "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" - } + "destIpRanges": { + "description": "CIDR IP address range.\nMaximum number of destination CIDR IP ranges allowed is 5000.", + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "zone", - "instance" + "type": "array" + }, + "destNetworkContext": { + "description": "Network context of the traffic destination. Allowed values are:\n \n \n - UNSPECIFIED\n - INTERNET\n - NON_INTERNET", + "enum": [ + "INTERNET", + "INTRA_VPC", + "NON_INTERNET", + "UNSPECIFIED", + "VPC_NETWORKS" ], - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "", + "", + "", + "", + "" ], - "description": "Sends diagnostic interrupt to the instance." + "type": "string" }, - "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" - }, - "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" - } - }, - "parameterOrder": [ - "project", - "zone", - "instance" + "destNetworkType": { + "description": "Network type of the traffic destination. Allowed values are:\n \n \n - UNSPECIFIED\n - INTERNET\n - NON_INTERNET", + "enum": [ + "INTERNET", + "INTRA_VPC", + "NON_INTERNET", + "UNSPECIFIED", + "VPC_NETWORKS" ], - "response": { - "$ref": "GuestAttributes" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "", + "", + "", + "", + "" ], - "description": "Returns the specified guest attributes entry." + "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" - } + "destRegionCodes": { + "description": "Region codes whose IP addresses will be used to match for destination\nof traffic. Should be specified as 2 letter country code defined as per\nISO 3166 alpha-2 country codes. ex.\"US\"\nMaximum number of dest region codes allowed is 5000.", + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "zone", - "instance" - ], - "request": { - "$ref": "AttachedDisk" + "type": "array" + }, + "destThreatIntelligences": { + "description": "Names of Network Threat Intelligence lists.\nThe IPs in these lists will be matched against traffic destination.", + "items": { + "type": "string" }, - "response": { - "$ref": "Operation" + "type": "array" + }, + "layer4Configs": { + "description": "Pairs of IP protocols and ports that the rule should match.", + "items": { + "$ref": "FirewallPolicyRuleMatcherLayer4Config" }, - "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." + "type": "array" }, - "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" - } + "srcAddressGroups": { + "description": "Address groups which should be matched against the traffic source.\nMaximum number of source address groups is 10.", + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "zone", - "instance", - "deviceName" - ], - "response": { - "$ref": "Operation" + "type": "array" + }, + "srcFqdns": { + "description": "Fully Qualified Domain Name (FQDN) which should be matched against\ntraffic source.\nMaximum number of source fqdn allowed is 100.", + "items": { + "type": "string" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Detaches a disk from an instance." + "type": "array" }, - "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" - } + "srcIpRanges": { + "description": "CIDR IP address range.\nMaximum number of source CIDR IP ranges allowed is 5000.", + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "zone", - "instance" + "type": "array" + }, + "srcNetworkContext": { + "description": "Network context of the traffic source. Allowed values are:\n \n \n - UNSPECIFIED\n - INTERNET\n - INTRA_VPC\n - NON_INTERNET\n - VPC_NETWORKS", + "enum": [ + "INTERNET", + "INTRA_VPC", + "NON_INTERNET", + "UNSPECIFIED", + "VPC_NETWORKS" ], - "request": { - "$ref": "InstancesSetMachineResourcesRequest" + "enumDescriptions": [ + "", + "", + "", + "", + "" + ], + "type": "string" + }, + "srcNetworkType": { + "description": "Network type of the traffic source. Allowed values are:\n \n \n - UNSPECIFIED\n - INTERNET\n - INTRA_VPC\n - NON_INTERNET\n - VPC_NETWORKS", + "enum": [ + "INTERNET", + "INTRA_VPC", + "NON_INTERNET", + "UNSPECIFIED", + "VPC_NETWORKS" + ], + "enumDescriptions": [ + "", + "", + "", + "", + "" + ], + "type": "string" + }, + "srcNetworks": { + "description": "Networks of the traffic source. It can be either a full or partial url.", + "items": { + "type": "string" }, - "response": { - "$ref": "Operation" + "type": "array" + }, + "srcRegionCodes": { + "description": "Region codes whose IP addresses will be used to match for source\nof traffic. Should be specified as 2 letter country code defined as per\nISO 3166 alpha-2 country codes. ex.\"US\"\nMaximum number of source region codes allowed is 5000.", + "items": { + "type": "string" }, - "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." + "type": "array" }, - "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" - } + "srcSecureTags": { + "description": "List of secure tag values, which should be matched at the source\nof the traffic.\nFor INGRESS rule, if all the srcSecureTag are INEFFECTIVE,\nand there is no srcIpRange, this rule will be ignored.\nMaximum number of source tag values allowed is 256.", + "items": { + "$ref": "FirewallPolicyRuleSecureTag" }, - "parameterOrder": [ - "project", - "zone", - "instance" + "type": "array" + }, + "srcThreatIntelligences": { + "description": "Names of Network Threat Intelligence lists.\nThe IPs in these lists will be matched against traffic source.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, + "FirewallPolicyRuleMatcherLayer4Config": { + "id": "FirewallPolicyRuleMatcherLayer4Config", + "properties": { + "ipProtocol": { + "description": "The IP protocol to which this rule applies. The protocol type is\nrequired when creating a firewall rule. This value can either be\none of the following well known protocol strings (tcp,udp, icmp, esp,ah, ipip, sctp), or the IP\nprotocol number.", + "type": "string" + }, + "ports": { + "description": "An optional list of ports to which this rule applies. This field is\nonly applicable for UDP or TCP protocol. Each entry must be either\nan integer or a range. If not specified, this rule applies to\nconnections through any port.\n\nExample inputs include: [\"22\"],[\"80\",\"443\"], and [\"12345-12349\"].", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, + "FirewallPolicyRuleSecureTag": { + "id": "FirewallPolicyRuleSecureTag", + "properties": { + "name": { + "description": "Name of the secure tag, created with TagManager's TagValue API.", + "pattern": "tagValues/[0-9]+", + "type": "string" + }, + "state": { + "description": "Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or\n`INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted\nor its network is deleted.", + "enum": [ + "EFFECTIVE", + "INEFFECTIVE" + ], + "enumDescriptions": [ + "", + "" ], - "request": { - "$ref": "InstancesSetMachineTypeRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "FixedOrPercent": { + "description": "Encapsulates numeric value that can be either absolute or relative.", + "id": "FixedOrPercent", + "properties": { + "calculated": { + "description": "Output only. Absolute value of VM instances calculated based on the specific mode.\n\n \n \n - If the value is fixed, then the calculated\n value is equal to the fixed value.\n - If the value is a percent, then the\n calculated\n value is percent/100 * targetSize. For example,\n the calculated value of a 80% of a managed instance group\n with 150 instances would be (80/100 * 150) = 120 VM instances. If there\n is a remainder, the number is rounded.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "fixed": { + "description": "Specifies a fixed number of VM instances. This must be a positive integer.", + "format": "int32", + "type": "integer" + }, + "percent": { + "description": "Specifies a percentage of instances between 0 to 100%, inclusive. For\nexample, specify 80 for 80%.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, + "FlexibleTimeRange": { + "description": "Specifies a flexible time range with flexible start time and duration.\n\nIt is possible to specify a contradictory time range that cannot be matched\nby any Interval. This causes a validation error.", + "id": "FlexibleTimeRange", + "properties": { + "maxDuration": { + "format": "google-duration", + "type": "string" + }, + "minDuration": { + "format": "google-duration", + "type": "string" + }, + "startTimeNotEarlierThan": { + "format": "google-datetime", + "type": "string" + }, + "startTimeNotLaterThan": { + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, + "ForwardingRule": { + "description": "Represents a Forwarding Rule resource.\n\nForwarding rule resources in Google Cloud can be either regional or global in\nscope:\n\n* [Global](https://cloud.google.com/compute/docs/reference/rest/v1/globalForwardingRules)\n* [Regional](https://cloud.google.com/compute/docs/reference/rest/v1/forwardingRules)\n\nA forwarding rule and its corresponding IP address represent the frontend\nconfiguration of a Google Cloud load balancer.\nForwarding rules can also reference target instances and Cloud VPN Classic\ngateways (targetVpnGateway).\n\nFor more information, read\nForwarding rule concepts and\nUsing protocol forwarding.", + "id": "ForwardingRule", + "properties": { + "IPAddress": { + "description": "IP address for which this forwarding rule accepts traffic. When a client\nsends traffic to this IP address, the forwarding rule directs the traffic\nto the referenced target or backendService.\nWhile creating a forwarding rule, specifying an IPAddress is\nrequired under the following circumstances:\n\n \n - When the target is set to targetGrpcProxy andvalidateForProxyless is set to true, theIPAddress should be set to 0.0.0.0.\n - When the target is a Private Service Connect Google APIs\n bundle, you must specify an IPAddress.\n\n\nOtherwise, you can optionally specify an IP address that references an\nexisting static (reserved) IP address resource. When omitted, Google Cloud\nassigns an ephemeral IP address.\n\nUse one of the following formats to specify an IP address while creating a\nforwarding rule:\n\n* IP address number, as in `100.1.2.3`\n* IPv6 address range, as in `2600:1234::/96`\n* Full resource URL, as inhttps://www.googleapis.com/compute/v1/projects/project_id/regions/region/addresses/address-name\n* Partial URL or by name, as in:\n \n - projects/project_id/regions/region/addresses/address-name\n - regions/region/addresses/address-name\n - global/addresses/address-name\n - address-name\n\n\n\nThe IP address can only be set at creation. Once set, it cannot be updated.\n\nThe forwarding rule's target or backendService,\nand in most cases, also the loadBalancingScheme, determine the\ntype of IP address that you can use. For detailed information, see\n[IP address\nspecifications](https://cloud.google.com/load-balancing/docs/forwarding-rule-concepts#ip_address_specifications).\n\nWhen reading an IPAddress, the API always returns the IP\naddress number.\n\nWhen creating a global external Passthrough Network Load Balancer\nforwarding rule (a parent forwarding rule), you must use theIPAddresses field, but the Google Cloud generated child\nforwarding rules set the IPAddress field instead. Refer to theavailabilityGroup field for further details.", + "type": "string" + }, + "IPProtocol": { + "description": "The IP protocol to which this rule applies.\n\nFor protocol forwarding, valid\noptions are TCP, UDP, ESP,AH, SCTP, ICMP andL3_DEFAULT.\n\nThe valid IP protocols are different for different load balancing products\nas described in [Load balancing\nfeatures](https://cloud.google.com/load-balancing/docs/features#protocols_from_the_load_balancer_to_the_backends).", + "enum": [ + "AH", + "ESP", + "ICMP", + "L3_DEFAULT", + "SCTP", + "TCP", + "UDP" + ], + "enumDescriptions": [ + "", + "", + "", + "", + "", + "", + "" ], - "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" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request 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" - } + "allPorts": { + "description": "The ports, portRange, and allPorts\nfields are mutually exclusive. Only packets addressed to ports in the\nspecified range will be forwarded to the backends configured with this\nforwarding rule.\n\nThe allPorts field has the following limitations:\n \n - It requires that the forwarding rule IPProtocol be TCP,\n UDP, SCTP, or L3_DEFAULT.\n - It's applicable only to the following products: internal passthrough\n Network Load Balancers, backend service-based external passthrough Network\n Load Balancers, and internal and external protocol forwarding.\n - Set this field to true to allow packets addressed to any port or\n packets lacking destination port information (for example, UDP fragments\n after the first fragment) to be forwarded to the backends configured with\n this forwarding rule. The L3_DEFAULT protocol requiresallPorts be set to true.", + "type": "boolean" + }, + "allowGlobalAccess": { + "description": "If set to true, clients can access the internal passthrough Network Load\nBalancers, the regional internal Application Load Balancer, and the\nregional internal proxy Network Load Balancer from all regions.\nIf false, only allows access from the local region the load balancer is\nlocated at. Note that for INTERNAL_MANAGED forwarding rules, this field\ncannot be changed after the forwarding rule is created.", + "type": "boolean" + }, + "allowPscGlobalAccess": { + "description": "This is used in PSC consumer ForwardingRule to control whether the PSC\nendpoint can be accessed from another region.", + "type": "boolean" + }, + "attachedExtensions": { + "description": "Output only. [Output Only]. The extensions that are attached to this ForwardingRule.", + "items": { + "$ref": "ForwardingRuleAttachedExtension" }, - "parameterOrder": [ - "project", - "zone", - "instance" + "readOnly": true, + "type": "array" + }, + "backendService": { + "description": "Identifies the backend service to which the forwarding rule sends traffic.\n\nIt is a required field for the following load balancers:\n \n - Internal passthrough Network Load Balancers\n - Backend service-based regional external passthrough Network Load\n Balancers\n - Global external passthrough Network Load Balancers\n\n\n\nIt cannot be set by other load balancer types and protocol forwarding\nrules.", + "type": "string" + }, + "baseForwardingRule": { + "description": "Output only. [Output Only] The URL for the corresponding base forwarding rule. By base\nforwarding rule, we mean the forwarding rule that has the same IP address,\nprotocol, and port settings with the current forwarding rule, but without\nsourceIPRanges specified.\nAlways empty if the current forwarding rule does not have sourceIPRanges\nspecified.", + "readOnly": true, + "type": "string" + }, + "creationTimestamp": { + "description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you\ncreate the resource.", + "type": "string" + }, + "externalManagedBackendBucketMigrationState": { + "description": "Specifies the canary migration state for the backend buckets attached to\nthis forwarding rule. Possible values are PREPARE, TEST_BY_PERCENTAGE, and\nTEST_ALL_TRAFFIC.\n\nTo begin the migration from EXTERNAL to EXTERNAL_MANAGED, the state must be\nchanged to PREPARE. The state must be changed to TEST_ALL_TRAFFIC before\nthe loadBalancingScheme can be changed to EXTERNAL_MANAGED. Optionally, the\nTEST_BY_PERCENTAGE state can be used to migrate traffic to backend buckets\nattached to this forwarding rule by percentage using\nexternalManagedBackendBucketMigrationTestingPercentage.\n\nRolling back a migration requires the states to be set in reverse order. So\nchanging the scheme from EXTERNAL_MANAGED to EXTERNAL requires the state to\nbe set to TEST_ALL_TRAFFIC at the same time. Optionally, the\nTEST_BY_PERCENTAGE state can be used to migrate some traffic back to\nEXTERNAL or PREPARE can be used to migrate all traffic back to EXTERNAL.", + "enum": [ + "PREPARE", + "TEST_ALL_TRAFFIC", + "TEST_BY_PERCENTAGE" ], - "request": { - "$ref": "Metadata" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "", + "", + "" ], - "description": "Sets metadata for the specified instance to the data included in the request." + "type": "string" }, - "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" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request 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" + "externalManagedBackendBucketMigrationTestingPercentage": { + "description": "Determines the fraction of requests to backend buckets that should be\nprocessed by the global external Application Load Balancer.\n\nThe value of this field must be in the range [0, 100].\n\nThis value can only be set if the loadBalancingScheme in the BackendService\nis set to EXTERNAL (when using the classic Application Load Balancer) and\nthe migration state is TEST_BY_PERCENTAGE.", + "format": "float", + "type": "number" + }, + "fingerprint": { + "description": "Fingerprint of this resource. A hash of the contents stored in this object.\nThis field is used in optimistic locking. This field will be ignored when\ninserting a ForwardingRule. Include the fingerprint in patch request to\nensure that you do not overwrite changes that were applied from another\nconcurrent request.\n\nTo see the latest fingerprint, make a get() request to\nretrieve a ForwardingRule.", + "format": "byte", + "type": "string" + }, + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "format": "uint64", + "type": "string" + }, + "ipCollection": { + "description": "Resource reference of a PublicDelegatedPrefix. The PDP must\nbe a sub-PDP in EXTERNAL_IPV6_FORWARDING_RULE_CREATION mode.\n\nUse one of the following formats to specify a sub-PDP when creating an IPv6\nNetLB forwarding rule using BYOIP:\nFull resource URL, as inhttps://www.googleapis.com/compute/v1/projects/project_id/regions/region/publicDelegatedPrefixes/sub-pdp-name\nPartial URL, as in:\n \n - projects/project_id/regions/region/publicDelegatedPrefixes/sub-pdp-name\n - regions/region/publicDelegatedPrefixes/sub-pdp-name", + "type": "string" + }, + "ipVersion": { + "description": "The IP Version that will be used by this forwarding rule. Valid options\nare IPV4 or IPV6.", + "enum": [ + "IPV4", + "IPV6", + "UNSPECIFIED_VERSION" ], - "request": { - "$ref": "InstancesSetMinCpuPlatformRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "", + "", + "" ], - "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." + "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" - } + "isMirroringCollector": { + "description": "Indicates whether or not this load balancer can be used as a collector for\npacket mirroring. To prevent mirroring loops, instances behind this\nload balancer will not have their traffic mirrored even if aPacketMirroring rule applies to them.\nThis can only be set to true for load balancers that have theirloadBalancingScheme set to INTERNAL.", + "type": "boolean" + }, + "kind": { + "default": "compute#forwardingRule", + "description": "Output only. [Output Only] Type of the resource. Alwayscompute#forwardingRule for forwarding rule resources.", + "readOnly": true, + "type": "string" + }, + "labelFingerprint": { + "description": "A fingerprint for the labels being applied to this resource, which is\nessentially a hash of the labels set used for optimistic locking. The\nfingerprint is initially generated by Compute Engine and changes after\nevery request to modify or update labels. You must always provide an\nup-to-date fingerprint hash in order to update or change labels,\notherwise the request will fail with error412 conditionNotMet.\n\nTo see the latest fingerprint, make a get() request to\nretrieve a ForwardingRule.", + "format": "byte", + "type": "string" + }, + "labels": { + "additionalProperties": { + "type": "string" }, - "parameterOrder": [ - "project", - "zone", - "instance" + "description": "Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035.\nLabel values may be empty.", + "type": "object" + }, + "loadBalancingScheme": { + "description": "Specifies the forwarding rule type.\n\nFor more information, refer to \nForwarding rule product and scheme table.", + "enum": [ + "EXTERNAL", + "EXTERNAL_MANAGED", + "INTERNAL", + "INTERNAL_MANAGED", + "INTERNAL_SELF_MANAGED", + "INVALID" ], - "request": { - "$ref": "Tags" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "", + "", + "", + "", + "", + "" ], - "description": "Sets network tags for the specified instance to the data included in the request." + "type": "string" }, - "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" - } + "metadataFilters": { + "description": "Opaque filter criteria used by load balancer to restrict routing\nconfiguration to a limited set of xDS\ncompliant clients. In their xDS requests to load balancer, xDS clients\npresent node\nmetadata. When there is a match, the relevant configuration\nis made available to those proxies. Otherwise, all the resources (e.g.TargetHttpProxy, UrlMap)\nreferenced by the ForwardingRule are not visible to\nthose proxies.\n\nFor each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least one of thefilterLabels must match the corresponding label provided in\nthe metadata. If its filterMatchCriteria is set to\nMATCH_ALL, then all of its filterLabels must match with\ncorresponding labels provided in the metadata. If multiplemetadataFilters are specified, all of them need to be satisfied\nin order to be considered a match.\n\nmetadataFilters specified here will be applifed before\nthose specified in the UrlMap that thisForwardingRule references.\n\nmetadataFilters only applies to Loadbalancers that have\ntheir loadBalancingScheme set toINTERNAL_SELF_MANAGED.", + "items": { + "$ref": "MetadataFilter" }, - "parameterOrder": [ - "project", - "zone", - "instance" + "type": "array" + }, + "name": { + "description": "Name of the resource; provided by the client when the resource is created.\nThe name must be 1-63 characters long, and comply withRFC1035.\nSpecifically, the name must be 1-63 characters long and match the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first\ncharacter must be a lowercase letter, and all following characters must\nbe a dash, lowercase letter, or digit, except the last character, which\ncannot be a dash.\n\nFor Private Service Connect forwarding rules that forward traffic to Google\nAPIs, the forwarding rule name must be a 1-20 characters string with\nlowercase letters and numbers and must start with a letter.\n\nFor global external Passthrough Network Load Balancer forwarding rules, the\nforwarding rule name must be 1-43 characters long. For each global external\nPassthrough Network Load Balancer forwarding rule (a parent forwarding\nrule) that you create, Google Cloud generates two output-only child\nforwarding rules that are named by concatenating the parent forwarding rule\nname with the `-ag0` and `-ag1` suffixes, respectively. Refer to theavailabilityGroup field for further details.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "network": { + "description": "This field is not used for global external load balancing.\n\nFor internal passthrough Network Load Balancers, this field identifies the\nnetwork that the load balanced IP should belong to for this forwarding\nrule.\nIf the subnetwork is specified, the network of the subnetwork will be used.\nIf neither subnetwork nor this field is specified, the default network will\nbe used.\n\nFor Private Service Connect forwarding rules that forward traffic to Google\nAPIs, a network must be provided.", + "type": "string" + }, + "networkTier": { + "description": "This signifies the networking tier used for configuring\nthis load balancer and can only take the following values:PREMIUM, STANDARD.\n\nFor regional ForwardingRule, the valid values are PREMIUM andSTANDARD. For GlobalForwardingRule, the valid value isPREMIUM.\n\nIf this field is not specified, it is assumed to be PREMIUM.\nIf IPAddress is specified, this value must be equal to the\nnetworkTier of the Address.", + "enum": [ + "FIXED_STANDARD", + "PREMIUM", + "STANDARD", + "STANDARD_OVERRIDES_FIXED_STANDARD" ], - "request": { - "$ref": "InstancesSetLabelsRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "Public internet quality with fixed bandwidth.", + "High quality, Google-grade network tier, support for all networking\nproducts.", + "Public internet quality, only limited support for other networking\nproducts.", + "(Output only) Temporary tier for FIXED_STANDARD when fixed standard tier\nis expired or not configured." ], - "description": "Sets labels on an instance. To learn more about labels, read the Labeling Resources documentation." + "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" - } + "noAutomateDnsZone": { + "description": "This is used in PSC consumer ForwardingRule to control whether it should\ntry to auto-generate a DNS zone or not. Non-PSC forwarding rules do not use\nthis field. Once set, this field is not mutable.", + "type": "boolean" + }, + "portRange": { + "description": "The ports, portRange, and allPorts\nfields are mutually exclusive. Only packets addressed to ports in the\nspecified range will be forwarded to the backends configured with this\nforwarding rule.\n\nThe portRange field has the following limitations:\n \n - It requires that the forwarding rule IPProtocol be TCP,\n UDP, or SCTP, and\n - It's applicable only to the following products: external passthrough\n Network Load Balancers, internal and external proxy Network Load Balancers,\n internal and external Application Load Balancers, external protocol\n forwarding, and Classic VPN.\n - Some products have restrictions on what ports can be used. See \n port specifications for details.\n\n\n\nFor external forwarding rules, two or more forwarding rules cannot use the\nsame [IPAddress, IPProtocol] pair (specified inIPAddress, IPAddresses, IPProtocol\nfields) if they have overlapping portRanges.\n\nFor internal forwarding rules within the same VPC network, two or more\nforwarding rules cannot use the same [IPAddress, IPProtocol]\npair, and cannot have overlapping portRanges.\n\n@pattern: \\\\d+(?:-\\\\d+)?", + "type": "string" + }, + "ports": { + "description": "The ports, portRange, and allPorts\nfields are mutually exclusive. Only packets addressed to ports in the\nspecified range will be forwarded to the backends configured with this\nforwarding rule.\n\nThe ports field has the following limitations:\n \n - It requires that the forwarding rule IPProtocol be TCP,\n UDP, or SCTP, and\n - It's applicable only to the following products: internal passthrough\n Network Load Balancers, backend service-based external passthrough Network\n Load Balancers, and internal protocol forwarding.\n - You can specify a list of up to five ports by number, separated by\n commas. The ports can be contiguous or discontiguous.\n\n\n\nFor external forwarding rules, two or more forwarding rules cannot use the\nsame [IPAddress, IPProtocol] pair (specified inIPAddress, IPAddresses, IPProtocol\nfields) if they share at least one port number.\n\nFor internal forwarding rules within the same VPC network, two or more\nforwarding rules cannot use the same [IPAddress, IPProtocol]\npair if they share at least one port number.\n\n@pattern: \\\\d+(?:-\\\\d+)?", + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "zone", - "instance" + "type": "array" + }, + "pscConnectionId": { + "description": "[Output Only] The PSC connection id of the PSC forwarding rule.", + "format": "uint64", + "type": "string" + }, + "pscConnectionStatus": { + "enum": [ + "ACCEPTED", + "CLOSED", + "NEEDS_ATTENTION", + "PENDING", + "REJECTED", + "STATUS_UNSPECIFIED" ], - "request": { - "$ref": "InstancesSetNameRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "The connection has been accepted by the producer.", + "The connection has been closed by the producer and will not serve traffic\ngoing forward.", + "The connection has been accepted by the producer, but the producer needs\nto 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 name of an instance." + "readOnly": true, + "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" - } + "region": { + "description": "Output only. [Output Only] URL of the region where the regional forwarding rule resides.\nThis field is not applicable to global forwarding rules.\nYou must specify this field as part of the HTTP request URL. It is\nnot settable as a field in the request body.", + "readOnly": true, + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" + }, + "selfLinkWithId": { + "description": "Output only. [Output Only] Server-defined URL for this resource with the resource id.", + "readOnly": true, + "type": "string" + }, + "serviceDirectoryRegistrations": { + "description": "Service Directory resources to register this forwarding rule with.\nCurrently, only supports a single Service Directory resource.", + "items": { + "$ref": "ForwardingRuleServiceDirectoryRegistration" }, - "parameterOrder": [ - "project", - "zone", - "instance", - "autoDelete", - "deviceName" - ], - "response": { - "$ref": "Operation" + "type": "array" + }, + "serviceLabel": { + "description": "An optional prefix to the service name for this forwarding rule.\nIf specified, the prefix is the first label of the fully qualified service\nname.\n\nThe label must be 1-63 characters long, and comply withRFC1035.\nSpecifically, the label must be 1-63 characters long and match the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first\ncharacter must be a lowercase letter, and all following characters must\nbe a dash, lowercase letter, or digit, except the last character, which\ncannot be a dash.\n\nThis 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]\nThe internal fully qualified service name for this forwarding rule.\n\nThis field is only used for internal load balancing.", + "type": "string" + }, + "sourceIpRanges": { + "description": "If not empty, this forwarding rule will only forward the traffic when the\nsource IP address matches one of the IP addresses or CIDR ranges set here.\nNote that a forwarding rule can only have up to 64 source IP ranges, and\nthis field can only be used with a regional forwarding rule whose scheme isEXTERNAL.\nEach source_ip_range entry should be either an IP address (for\nexample, 1.2.3.4) or a CIDR range (for example, 1.2.3.0/24).", + "items": { + "type": "string" }, - "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." + "type": "array" + }, + "subnetwork": { + "description": "This field identifies the subnetwork that the load balanced IP should\nbelong to for this forwarding rule, used with internal load balancers and\nexternal passthrough Network Load Balancers with IPv6.\n\nIf the network specified is in auto subnet mode, this field is optional.\nHowever, a subnetwork must be specified if the network is in custom subnet\nmode or when creating external forwarding rule with IPv6.", + "type": "string" + }, + "target": { + "description": "The URL of the target resource to receive the matched traffic. For\nregional forwarding rules, this target must be in the same region as the\nforwarding rule. For global forwarding rules, this target must be a global\nload balancing resource.\n\nThe forwarded traffic must be of a type appropriate to the target object.\n \n \n - For load balancers, see the \"Target\" column in [Port specifications](https://cloud.google.com/load-balancing/docs/forwarding-rule-concepts#ip_address_specifications).\n - For Private Service Connect forwarding rules that forward traffic to Google APIs, provide the name of a supported Google API bundle:\n \n \n - vpc-sc - APIs that support VPC Service Controls. \n - all-apis - All supported Google APIs. \n \n \n - 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. \n\n\n\nThe following load balancers cannot set the target field (they should set the backendService field instead):\n \n - Internal passthrough Network Load Balancers\n - Backend service-based regional external passthrough Network Load\n Balancers\n - Global external passthrough Network Load Balancers", + "type": "string" + } + }, + "type": "object" + }, + "ForwardingRuleAggregatedList": { + "id": "ForwardingRuleAggregatedList", + "properties": { + "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" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request 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" - } + "items": { + "additionalProperties": { + "$ref": "ForwardingRulesScopedList", + "description": "Name of the scope containing this set of addresses." }, - "parameterOrder": [ - "project", - "zone", - "instance" - ], - "response": { - "$ref": "Operation" + "description": "A list of ForwardingRulesScopedList resources.", + "type": "object" + }, + "kind": { + "default": "compute#forwardingRuleAggregatedList", + "description": "Output only. [Output Only] Type of resource. Alwayscompute#forwardingRuleAggregatedList for lists of forwarding rules.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "unreachables": { + "description": "Output only. [Output Only] Unreachable resources.", + "items": { + "type": "string" }, - "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." + "readOnly": true, + "type": "array" }, - "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, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project", - "zone", - "instance" - ], - "request": { - "$ref": "InstancesStartWithEncryptionKeyRequest" - }, - "response": { - "$ref": "Operation" + "type": "object" + } + }, + "type": "object" + }, + "ForwardingRuleAttachedExtension": { + "description": "Reference to an extension resource that is attached to this ForwardingRule.", + "id": "ForwardingRuleAttachedExtension", + "properties": { + "reference": { + "description": "Output only. The resource name.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "ForwardingRuleList": { + "description": "Contains a list of ForwardingRule resources.", + "id": "ForwardingRuleList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of ForwardingRule resources.", + "items": { + "$ref": "ForwardingRule" }, - "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." + "type": "array" }, - "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, + "kind": { + "default": "compute#forwardingRuleList", + "description": "Output only. Type of resource.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project", - "zone", - "instance" - ], - "response": { - "$ref": "Operation" + "type": "object" + } + }, + "type": "object" + }, + "ForwardingRuleReference": { + "id": "ForwardingRuleReference", + "properties": { + "forwardingRule": { + "type": "string" + } + }, + "type": "object" + }, + "ForwardingRuleServiceDirectoryRegistration": { + "description": "Describes the auto-registration of the forwarding rule to Service Directory.\nThe region and project of the Service Directory resource generated from\nthis registration will be the same as this forwarding rule.", + "id": "ForwardingRuleServiceDirectoryRegistration", + "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\nrule under. Default to \"us-central1\". Only used for PSC for Google APIs.\nAll PSC for Google APIs forwarding rules on the same network should use\nthe same Service Directory region.", + "type": "string" + } + }, + "type": "object" + }, + "ForwardingRulesScopedList": { + "id": "ForwardingRulesScopedList", + "properties": { + "forwardingRules": { + "description": "A list of forwarding rules contained in this scope.", + "items": { + "$ref": "ForwardingRule" }, - "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." + "type": "array" }, - "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, + "warning": { + "description": "Informational warning which replaces the list of forwarding rules when\nthe list is empty.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project", - "zone", - "resource" + "type": "object" + } + }, + "type": "object" + }, + "FutureReservation": { + "id": "FutureReservation", + "properties": { + "aggregateReservation": { + "$ref": "AllocationAggregateReservation", + "description": "Aggregate reservation details for the future reservation." + }, + "autoCreatedReservationsDeleteTime": { + "description": "Future timestamp when the FR auto-created reservations will be deleted by\nCompute Engine. Format of this field must be a valid\nhref=\"https://www.ietf.org/rfc/rfc3339.txt\">RFC3339 value.", + "type": "string" + }, + "autoCreatedReservationsDuration": { + "$ref": "Duration", + "description": "Specifies the duration of auto-created reservations.\nIt represents relative time to future reservation start_time when\nauto-created reservations will be automatically deleted by Compute\nEngine. Duration time unit is represented as a count of seconds\nand fractions of seconds at nanosecond resolution." + }, + "autoDeleteAutoCreatedReservations": { + "description": "Setting for enabling or disabling automatic deletion for auto-created\nreservation. If set to true, auto-created reservations will be\ndeleted at Future Reservation's end time (default) or at user's defined\ntimestamp if any of the\n[auto_created_reservations_delete_time, auto_created_reservations_duration]\nvalues is specified.\nFor keeping auto-created reservation indefinitely, this value should be set\nto false.", + "type": "boolean" + }, + "commitmentInfo": { + "$ref": "FutureReservationCommitmentInfo", + "description": "If not present, then FR will not deliver a new commitment or update an\nexisting commitment." + }, + "confidentialComputeType": { + "enum": [ + "CONFIDENTIAL_COMPUTE_TYPE_TDX", + "CONFIDENTIAL_COMPUTE_TYPE_UNSPECIFIED" ], - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "Intel Trust Domain Extensions.", + "" ], - "description": "Gets the access control policy for a resource. May be empty if no such policy or resource exists." + "type": "string" }, - "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" + "creationTimestamp": { + "description": "Output only. [Output Only] The creation timestamp for this future reservation inRFC3339\ntext format.", + "readOnly": true, + "type": "string" + }, + "deploymentType": { + "description": "Type of the deployment requested as part of future reservation.", + "enum": [ + "DENSE", + "DEPLOYMENT_TYPE_UNSPECIFIED" ], - "request": { - "$ref": "ZoneSetPolicyRequest" - }, - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "The reserved capacity is made up of densely deployed reservation blocks.", + "" ], - "description": "Sets the access control policy on the specified resource. Replaces any existing policy." + "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" - } + "description": { + "description": "An optional description of this resource. Provide this property when you\ncreate the future reservation.", + "type": "string" + }, + "enableEmergentMaintenance": { + "description": "Indicates if this group of VMs have emergent maintenance enabled.", + "type": "boolean" + }, + "id": { + "description": "Output only. [Output Only] A unique identifier for this future reservation. The server\ndefines this identifier.", + "format": "uint64", + "readOnly": true, + "type": "string" + }, + "kind": { + "default": "compute#futureReservation", + "description": "Output only. [Output Only] Type of the resource. Alwayscompute#futureReservation for future reservations.", + "readOnly": true, + "type": "string" + }, + "name": { + "annotations": { + "required": [ + "compute.instances.insert" + ] }, - "parameterOrder": [ - "project", - "zone", - "resource" + "description": "The name of the resource, provided by the client when initially creating\nthe resource. The resource name must be 1-63 characters long, and comply\nwithRFC1035.\nSpecifically, the name must be 1-63 characters long and match the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first\ncharacter must be a lowercase letter, and all following characters must be\na dash, lowercase letter, or digit, except the last character, which cannot\nbe a dash.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "namePrefix": { + "description": "Name prefix for the reservations to be created at the time of\ndelivery. The name prefix must comply with RFC1035.\nMaximum allowed length for name prefix is 20. Automatically created\nreservations name format will be -date-####.", + "type": "string" + }, + "params": { + "$ref": "FutureReservationParams", + "description": "Input only. Additional params passed with the request, but not persisted\nas part of resource payload." + }, + "planningStatus": { + "description": "Planning state before being submitted for evaluation", + "enum": [ + "DRAFT", + "PLANNING_STATUS_UNSPECIFIED", + "SUBMITTED" ], - "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" + "enumDescriptions": [ + "Future Reservation is being drafted.", + "", + "Future Reservation has been submitted for evaluation by GCP." ], - "description": "Returns permissions that a caller has on the specified resource." + "type": "string" }, - "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" + "reservationMode": { + "description": "The reservation mode which determines reservation-termination behavior and\nexpected pricing.", + "enum": [ + "CALENDAR", + "DEFAULT", + "RESERVATION_MODE_UNSPECIFIED" ], - "request": { - "$ref": "InstancesSetServiceAccountRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "The delivered reservations will delivered at specified start time and\nterminated at specified end time along with terminating the VMs running\non it.", + "The delivered reservations do not terminate VMs at the end of\nreservations. This is default mode.", + "" ], - "description": "Sets the service account on the instance. For more information, read Changing the service account and access scopes for an instance." + "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" + "reservationName": { + "description": "Name of reservations where the capacity is provisioned at the time of\ndelivery of future reservations. If the reservation with the given name\ndoes not exist already, it is created automatically at the time of Approval\nwith INACTIVE state till specified start-time. Either provide the\nreservation_name or a name_prefix.", + "type": "string" + }, + "resourceMetadata": { + "$ref": "ResourceMetadata", + "description": "Output only. Contains standard resource metadata for an FutureReservation\nresource. It is populated for each instance of the FutureReservation\nresource, and includes the api_version the\ninstance was retrieved through, and its canonical\nresource_type name.", + "readOnly": true + }, + "resourceName": { + "description": "Name of the resource intended to be delivered. Name should conform to\nRFC1035. This will be the name of storage pool or Exapool for persistent\ndisk FRs.", + "type": "string" + }, + "schedulingType": { + "description": "Maintenance information for this reservation", + "enum": [ + "GROUPED", + "GROUP_MAINTENANCE_TYPE_UNSPECIFIED", + "INDEPENDENT" ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "Maintenance on all reserved instances in the reservation is synchronized.", + "Unknown maintenance type.", + "Maintenance is not synchronized for this reservation. Instead, each\ninstance has its own maintenance window." ], - "description": "Sets deletion protection on the instance." + "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" + "selfLink": { + "description": "Output only. [Output Only] Server-defined fully-qualified URL for this resource.", + "readOnly": true, + "type": "string" + }, + "selfLinkWithId": { + "description": "Output only. [Output Only] Server-defined URL for this resource with the resource id.", + "readOnly": true, + "type": "string" + }, + "shareSettings": { + "$ref": "ShareSettings", + "description": "List of Projects/Folders to share with." + }, + "specificReservationRequired": { + "description": "Indicates whether the auto-created reservation can be consumed by VMs with\naffinity for \"any\" reservation. If the field is set, then only VMs that\ntarget the reservation by name can consume from the delivered reservation.", + "type": "boolean" + }, + "specificSkuProperties": { + "$ref": "FutureReservationSpecificSKUProperties", + "description": "Future Reservation configuration to indicate instance properties and\ntotal count." + }, + "status": { + "$ref": "FutureReservationStatus", + "description": "Output only. [Output only] Status of the Future Reservation", + "readOnly": true + }, + "storagePoolProperties": { + "$ref": "FutureReservationStoragePoolProperties", + "description": "Storage pool details for the future reservation." + }, + "timeWindow": { + "$ref": "FutureReservationTimeWindow", + "description": "Time window for this Future Reservation." + }, + "zone": { + "description": "Output only. [Output Only] URL of the Zone where this future reservation resides.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "FutureReservationCommitmentInfo": { + "id": "FutureReservationCommitmentInfo", + "properties": { + "commitmentName": { + "description": "name of the commitment where capacity is being delivered to.", + "type": "string" + }, + "commitmentPlan": { + "description": "Indicates if a Commitment needs to be created as part of FR delivery. If\nthis field is not present, then no\ncommitment needs to be created.", + "enum": [ + "INVALID", + "THIRTY_SIX_MONTH", + "TWELVE_MONTH" ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "", + "", + "" ], - "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." + "type": "string" }, - "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" + "previousCommitmentTerms": { + "description": "Only applicable if FR is delivering to the same reservation. If set, all\nparent commitments will be extended to match the end date of the plan for\nthis commitment.", + "enum": [ + "EXTEND", + "PREVIOUSCOMMITMENTTERM_UNSPECIFIED" ], - "response": { - "$ref": "Operation" + "enumDescriptions": [ + "All associated parent Committed Used Discount(s) end-date/term will be\nextended to the end-time of this future reservation. Default is to\nextend previous commitment(s) time to the end_time of the reservation.", + "No changes to associated parents Committed Used Discount(s) terms." + ], + "type": "string" + } + }, + "type": "object" + }, + "FutureReservationParams": { + "description": "Additional future reservation params.", + "id": "FutureReservationParams", + "properties": { + "resourceManagerTags": { + "additionalProperties": { + "type": "string" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "description": "Input only. Resource manager tags to be bound to the future reservation. Tag keys and\nvalues have the same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in\nnamespaced format such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT &\nPATCH) when empty.", + "type": "object" + } + }, + "type": "object" + }, + "FutureReservationSpecificSKUProperties": { + "id": "FutureReservationSpecificSKUProperties", + "properties": { + "instanceProperties": { + "$ref": "AllocationSpecificSKUAllocationReservedInstanceProperties", + "description": "Properties of the SKU instances being reserved." + }, + "sourceInstanceTemplate": { + "description": "The instance template that will be used to populate the\nReservedInstanceProperties of the future reservation", + "type": "string" + }, + "totalCount": { + "description": "Total number of instances for which capacity assurance is requested at a\nfuture time period.", + "format": "int64", + "type": "string" + } + }, + "type": "object" + }, + "FutureReservationStatus": { + "description": "[Output only] Represents status related to the future reservation.", + "id": "FutureReservationStatus", + "properties": { + "amendmentStatus": { + "description": "Output only. [Output Only] The current status of the requested amendment.", + "enum": [ + "AMENDMENT_APPROVED", + "AMENDMENT_DECLINED", + "AMENDMENT_IN_REVIEW", + "AMENDMENT_STATUS_UNSPECIFIED" + ], + "enumDescriptions": [ + "The requested amendment to the Future Resevation has been approved and\napplied by GCP.", + "The requested amendment to the Future Reservation has been declined by\nGCP and the original state was restored.", + "The requested amendment to the Future Reservation is currently being\nreviewd by GCP.", + "" ], - "description": "Resumes an instance that was suspended using the instances().suspend method." + "readOnly": true, + "type": "string" }, - "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" - } + "autoCreatedReservations": { + "description": "Output only. Fully qualified urls of the automatically created reservations at\nstart_time.", + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "zone", - "instance" + "readOnly": true, + "type": "array" + }, + "exapoolProvisionedCapacityGb": { + "$ref": "StoragePoolExapoolProvisionedCapacityGb", + "description": "Output only. Exapool provisioned capacities for each SKU type.", + "readOnly": true + }, + "existingMatchingUsageInfo": { + "$ref": "FutureReservationStatusExistingMatchingUsageInfo", + "description": "Output only. [Output Only] Represents the existing matching usage for the future\nreservation.", + "readOnly": true + }, + "fulfilledCount": { + "description": "Output only. This count indicates the fulfilled capacity so far. This is set during\n\"PROVISIONING\" state. This count also includes capacity delivered as part\nof existing matching reservations.", + "format": "int64", + "readOnly": true, + "type": "string" + }, + "lastKnownGoodState": { + "$ref": "FutureReservationStatusLastKnownGoodState", + "description": "Output only. [Output Only] This field represents the future reservation before an\namendment was requested. If the amendment is declined, the Future\nReservation will be reverted to the last known good state. The last known\ngood state is not set when updating a future reservation whose\nProcurement Status is DRAFTING.", + "readOnly": true + }, + "lockTime": { + "description": "Output only. Time when Future Reservation would become LOCKED, after which no\nmodifications to Future Reservation will be allowed. Applicable only\nafter the Future Reservation is in the APPROVED state. The lock_time is\nan RFC3339 string. The procurement_status will transition to PROCURING\nstate at this time.", + "readOnly": true, + "type": "string" + }, + "procurementStatus": { + "description": "Output only. Current state of this Future Reservation", + "enum": [ + "APPROVED", + "CANCELLED", + "COMMITTED", + "DECLINED", + "DRAFTING", + "FAILED", + "FAILED_PARTIALLY_FULFILLED", + "FULFILLED", + "PENDING_AMENDMENT_APPROVAL", + "PENDING_APPROVAL", + "PROCUREMENT_STATUS_UNSPECIFIED", + "PROCURING", + "PROVISIONING" ], - "request": { - "$ref": "InstancesAddResourcePoliciesRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "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\nPENDING_APPROVAL upon user submitting FR.", + "Future reservation failed. No additional reservations were provided.", + "Future reservation is partially fulfilled. Additional reservations were\nprovided 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\nAmendment is declined, the Future Reservation will be restored to the\nlast known good state.", + "Future reservation is pending approval by GCP.", + "", + "Future reservation is being procured by GCP. Beyond this point, Future\nreservation is locked and no further modifications are allowed.", + "Future reservation capacity is being provisioned. This state will be\nentered after start_time, while reservations are being created to\nprovide total_count reserved instance slots. This state will not\npersist past start_time + 24h." ], - "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." + "readOnly": true, + "type": "string" + }, + "specificSkuProperties": { + "$ref": "FutureReservationStatusSpecificSKUProperties" + }, + "storagePoolProvisionedCapacity": { + "$ref": "FutureReservationStoragePoolProvisionedCapacity", + "description": "Output only. Storage pool provisioned capacities for each SKU type.", + "readOnly": true + } + }, + "type": "object" + }, + "FutureReservationStatusExistingMatchingUsageInfo": { + "description": "[Output Only] Represents the existing matching usage for the future\nreservation.", + "id": "FutureReservationStatusExistingMatchingUsageInfo", + "properties": { + "count": { + "description": "Output only. Count to represent min(FR total_count,\nmatching_reserved_capacity+matching_unreserved_instances)", + "format": "int64", + "readOnly": true, + "type": "string" + }, + "timestamp": { + "description": "Output only. Timestamp when the matching usage was calculated", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "FutureReservationStatusLastKnownGoodState": { + "description": "The state that the future reservation will be reverted to should the\namendment be declined.", + "id": "FutureReservationStatusLastKnownGoodState", + "properties": { + "description": { + "description": "Output only. [Output Only] The description of the FutureReservation before an\namendment was requested.", + "readOnly": true, + "type": "string" + }, + "existingMatchingUsageInfo": { + "$ref": "FutureReservationStatusExistingMatchingUsageInfo", + "description": "Output only. [Output Only] Represents the matching usage for the future\nreservation before an amendment was requested.", + "readOnly": true + }, + "futureReservationSpecs": { + "$ref": "FutureReservationStatusLastKnownGoodStateFutureReservationSpecs", + "readOnly": true + }, + "lockTime": { + "description": "Output only. [Output Only] The lock time of the FutureReservation before an\namendment was requested.", + "readOnly": true, + "type": "string" }, - "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" + "namePrefix": { + "description": "Output only. [Output Only] The name prefix of the Future Reservation before an\namendment was requested.", + "readOnly": true, + "type": "string" + }, + "procurementStatus": { + "description": "Output only. [Output Only] The status of the last known good state for the Future\nReservation.", + "enum": [ + "APPROVED", + "CANCELLED", + "COMMITTED", + "DECLINED", + "DRAFTING", + "FAILED", + "FAILED_PARTIALLY_FULFILLED", + "FULFILLED", + "PENDING_AMENDMENT_APPROVAL", + "PENDING_APPROVAL", + "PROCUREMENT_STATUS_UNSPECIFIED", + "PROCURING", + "PROVISIONING" ], - "request": { - "$ref": "InstancesRemoveResourcePoliciesRequest" + "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\nPENDING_APPROVAL upon user submitting FR.", + "Future reservation failed. No additional reservations were provided.", + "Future reservation is partially fulfilled. Additional reservations were\nprovided 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\nAmendment is declined, the Future Reservation will be restored to the\nlast known good state.", + "Future reservation is pending approval by GCP.", + "", + "Future reservation is being procured by GCP. Beyond this point, Future\nreservation is locked and no further modifications are allowed.", + "Future reservation capacity is being provisioned. This state will be\nentered after start_time, while reservations are being created to\nprovide total_count reserved instance slots. This state will not\npersist past start_time + 24h." + ], + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "FutureReservationStatusLastKnownGoodStateFutureReservationSpecs": { + "description": "The properties of the last known good state for the Future Reservation.", + "id": "FutureReservationStatusLastKnownGoodStateFutureReservationSpecs", + "properties": { + "shareSettings": { + "$ref": "ShareSettings", + "description": "Output only. [Output Only] The previous share settings of the Future Reservation.", + "readOnly": true + }, + "specificSkuProperties": { + "$ref": "FutureReservationSpecificSKUProperties", + "description": "Output only. [Output Only] The previous instance related properties of the\nFuture Reservation.", + "readOnly": true + }, + "timeWindow": { + "$ref": "FutureReservationTimeWindow", + "description": "Output only. [Output Only] The previous time window of the Future Reservation.", + "readOnly": true + } + }, + "type": "object" + }, + "FutureReservationStatusSpecificSKUProperties": { + "description": "Properties to be set for the Future Reservation.", + "id": "FutureReservationStatusSpecificSKUProperties", + "properties": { + "sourceInstanceTemplateId": { + "description": "ID of the instance template used to populate the Future Reservation\nproperties.", + "type": "string" + } + }, + "type": "object" + }, + "FutureReservationStoragePoolProperties": { + "description": "Storage pool properties for the future reservation.", + "id": "FutureReservationStoragePoolProperties", + "properties": { + "requestedExapoolProvisionedCapacityGb": { + "$ref": "StoragePoolExapoolProvisionedCapacityGb", + "description": "Requested exapool provisioned capacity in GiB." + }, + "requestedStoragePoolProvisionedCapacity": { + "$ref": "FutureReservationStoragePoolProvisionedCapacity", + "description": "Requested storage pool provisioned capacity." + }, + "storagePoolType": { + "description": "Type of the storage pool.", + "type": "string" + } + }, + "type": "object" + }, + "FutureReservationStoragePoolProvisionedCapacity": { + "description": "Storage pool provisioned capacities for each SKU type.", + "id": "FutureReservationStoragePoolProvisionedCapacity", + "properties": { + "poolProvisionedCapacityGb": { + "description": "Size of the storage pool in GiB.", + "format": "int64", + "type": "string" + }, + "poolProvisionedIops": { + "description": "Provisioned IOPS of the storage pool. Only relevant if the storage pool\ntype is hyperdisk-balanced.", + "format": "int64", + "type": "string" + }, + "poolProvisionedThroughput": { + "description": "Provisioned throughput of the storage pool in MiB/s. Only relevant if\nthe storage pool type is hyperdisk-balanced or hyperdisk-throughput.", + "format": "int64", + "type": "string" + } + }, + "type": "object" + }, + "FutureReservationTimeWindow": { + "id": "FutureReservationTimeWindow", + "properties": { + "duration": { + "$ref": "Duration" + }, + "endTime": { + "type": "string" + }, + "startTime": { + "description": "Start time of the Future Reservation. The start_time is an RFC3339\nstring.", + "type": "string" + } + }, + "type": "object" + }, + "FutureReservationsAggregatedListResponse": { + "description": "Contains a list of future reservations.", + "id": "FutureReservationsAggregatedListResponse", + "properties": { + "etag": { + "type": "string" + }, + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "additionalProperties": { + "$ref": "FutureReservationsScopedList", + "description": "Name of the scope containing this set of future reservations." }, - "response": { - "$ref": "Operation" + "description": "A list of Future reservation resources.", + "type": "object" + }, + "kind": { + "default": "compute#futureReservationsAggregatedListResponse", + "description": "Output only. [Output Only] Type of resource. Alwayscompute#futureReservationsAggregatedListResponse for future\nresevation aggregated list response.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "unreachables": { + "description": "Output only. [Output Only] Unreachable resources.", + "items": { + "type": "string" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Removes resource policies from an instance." + "readOnly": true, + "type": "array" }, - "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": [ - "", - "No changes can be made to the instance.", - "The instance will not restart.", - "The instance will restart." - ], + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", "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", + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], "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\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." ], - "enum": [ - "INVALID", - "NO_EFFECT", - "REFRESH", - "RESTART" - ] - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "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." + "type": "object" + } + }, + "type": "object" + }, + "FutureReservationsListResponse": { + "id": "FutureReservationsListResponse", + "properties": { + "etag": { + "type": "string" }, - "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." + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "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" + "items": { + "description": "[Output Only] A list of future reservation resources.", + "items": { + "$ref": "FutureReservation" }, - "response": { - "$ref": "Operation" + "type": "array" + }, + "kind": { + "default": "compute#futureReservationsListResponse", + "description": "Output only. [Output Only] Type of resource.Alwayscompute#FutureReservationsListResponse for lists of\nreservations", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "unreachables": { + "description": "Output only. [Output Only] Unreachable resources.", + "items": { + "type": "string" }, - "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." + "readOnly": true, + "type": "array" }, - "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, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project", - "zone", - "instance" - ], - "request": { - "$ref": "ShieldedInstanceIntegrityPolicy" - }, - "response": { - "$ref": "Operation" + "type": "object" + } + }, + "type": "object" + }, + "FutureReservationsScopedList": { + "id": "FutureReservationsScopedList", + "properties": { + "futureReservations": { + "description": "A list of future reservations contained in this scope.", + "items": { + "$ref": "FutureReservation" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "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." + "type": "array" }, - "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, + "warning": { + "description": "Informational warning which replaces the list of future reservations when\nthe list is empty.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "zone": { - "description": "Name of the zone 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" } }, - "parameterOrder": [ - "project", - "zone", - "instance" - ], - "request": { - "$ref": "InstancesSetSecurityPolicyRequest" - }, - "response": { - "$ref": "Operation" + "type": "object" + } + }, + "type": "object" + }, + "FutureResourcesRecommendation": { + "description": "Recommendation for single resources specification, to be created in the\nfuture.", + "id": "FutureResourcesRecommendation", + "properties": { + "endTime": { + "format": "google-datetime", + "type": "string" + }, + "location": { + "description": "The advised location for resource usage. When a zone, in format\n'zones/'.\nIf not set, it means that no location is recommended - see\nother_locations for details.", + "type": "string" + }, + "otherLocations": { + "additionalProperties": { + "$ref": "FutureResourcesRecommendationOtherLocation" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "description": "List of locations in the request scope that were not\nrecommended. Keys of the map are zones, in format 'zones/'.\nThe values are status information indicating the recommendation status.", + "type": "object" + }, + "recommendationId": { + "description": "Unique id of the recommendation, a UUID string generated by the API.", + "type": "string" + }, + "recommendationType": { + "description": "Type of recommendation. Currently only FUTURE_RESERVATION is supported.", + "enum": [ + "FUTURE_RESERVATION", + "RECOMMENDATION_TYPE_UNSPECIFIED" + ], + "enumDescriptions": [ + "A Future Reservation is recommended.", + "Default value, unused." ], - "description": "Sets the Google Cloud Armor security policy for the specified instance. For more information, see Google Cloud Armor Overview" + "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" + "startTime": { + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, + "FutureResourcesRecommendationOtherLocation": { + "description": "Information about recommendation status for locations\nthat were allowed but not used by the response.", + "id": "FutureResourcesRecommendationOtherLocation", + "properties": { + "details": { + "description": "Details (human readable) describing the situation.\nFor example, if status is CONDITION_NOT_MET, then\ndetails contain information about the parameters of the time window\nthat did not meet the required conditions.", + "type": "string" + }, + "status": { + "description": "Status of recommendation in this location.", + "enum": [ + "CONDITIONS_NOT_MET", + "NOT_SUPPORTED", + "NO_CAPACITY", + "OTHER_LOCATION_STATUS_UNDEFINED", + "RECOMMENDED" ], - "response": { - "$ref": "ShieldedInstanceIdentity" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "The requested resources are offered in this location\nbut the requested time window is does not meet the required conditions.", + "The requested resources are not offered in this location.\nRetrying the request will not change this status.", + "The requested resources are offered in this location\nand the requested time window is accepted\nbut there is no capacity within the requested time window.", + "Default value, unused.", + "The requested resources are offered in this location\nand it is possible to request them. However, another location\nwas better and was recommended." + ], + "type": "string" + } + }, + "type": "object" + }, + "FutureResourcesSpec": { + "description": "Specification of resources to be created at some time in the future within an\noptionally specified set of locations, and within the specified time range.", + "id": "FutureResourcesSpec", + "properties": { + "deploymentType": { + "description": "Indicates if the reservation allocation strategy is static (DENSE) or\ndynamic (STANDARD). Defaults to DENSE.", + "enum": [ + "DENSE", + "DEPLOYMENT_TYPE_UNSPECIFIED" + ], + "enumDescriptions": [ + "The reserved capacity is made up of densely deployed reservation blocks.", + "" ], - "description": "Returns the Shielded Instance Identity of an instance" + "type": "string" }, - "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" + "locationPolicy": { + "$ref": "FutureResourcesSpecLocationPolicy", + "description": "Optional location policy allowing to exclude some zone(s) in which\nthe resources must not be created." + }, + "targetResources": { + "$ref": "FutureResourcesSpecTargetResources", + "description": "Specification of the reserved resources." + }, + "timeRangeSpec": { + "$ref": "FlexibleTimeRange", + "description": "Specification of a time range in which the resources may be created.\nThe time range specifies start of resource use and planned end of resource\nuse." + } + }, + "type": "object" + }, + "FutureResourcesSpecAggregateResources": { + "id": "FutureResourcesSpecAggregateResources", + "properties": { + "acceleratorCount": { + "description": "Size of the request, in accelerator (chip) count.", + "format": "int64", + "type": "string" + }, + "vmFamily": { + "description": "The VM family that all instances scheduled against this reservation\nmust belong to. Use for TPU reservations.", + "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_LITE_POD_SLICE_CT6E", + "VM_FAMILY_CLOUD_TPU_POD_SLICE_CT3P", + "VM_FAMILY_CLOUD_TPU_POD_SLICE_CT4P", + "VM_FAMILY_CLOUD_TPU_POD_SLICE_CT5P", + "VM_FAMILY_CLOUD_TPU_POD_SLICE_TPU7X" ], - "request": { - "$ref": "BulkInsertInstanceResource" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "", + "", + "", + "", + "", + "", + "", + "" ], - "description": "Creates multiple instances. Count specifies the number of instances to create. For more information, see About bulk creation of VMs." + "type": "string" }, - "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" + "workloadType": { + "description": "Workload type. Use for TPU reservations.", + "enum": [ + "BATCH", + "SERVING", + "UNSPECIFIED" ], - "response": { - "$ref": "InstancesGetEffectiveFirewallsResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "Reserved resources will be optimized for BATCH workloads, such as ML\ntraining.", + "Reserved resources will be optimized for SERVING workloads, such as ML\ninference.", + "" ], - "description": "Returns effective firewalls applied to an interface of the instance." + "type": "string" } - } + }, + "type": "object" }, - "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" + "FutureResourcesSpecLocalSsdPartition": { + "id": "FutureResourcesSpecLocalSsdPartition", + "properties": { + "diskInterface": { + "description": "Disk interface. Defaults to SCSI.", + "enum": [ + "NVME", + "SCSI" ], - "request": { - "$ref": "BulkInsertInstanceResource" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "", + "" ], - "description": "Creates multiple instances in a given region. Count specifies the number of instances to create." + "type": "string" + }, + "diskSizeGb": { + "description": "The size of the disk in GB.", + "format": "int64", + "type": "string" } - } + }, + "type": "object" }, - "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" - } + "FutureResourcesSpecLocationPolicy": { + "description": "Specification of locations to create resources in.", + "id": "FutureResourcesSpecLocationPolicy", + "properties": { + "locations": { + "additionalProperties": { + "$ref": "FutureResourcesSpecLocationPolicyLocation" }, - "parameterOrder": [ - "project", - "zone" + "description": "Preferences for specified locations.\nKeys of the map are locations - zones, in format of 'zones/'.\nValues are preferences for the zones.\nIf a zone is not specified in this map, it is ALLOWed.", + "type": "object" + } + }, + "type": "object" + }, + "FutureResourcesSpecLocationPolicyLocation": { + "description": "Preference for a single specified location.", + "id": "FutureResourcesSpecLocationPolicyLocation", + "properties": { + "preference": { + "description": "Preference for this location.", + "enum": [ + "ALLOW", + "DENY", + "PREFERENCE_UNSPECIFIED" ], - "response": { - "$ref": "ReservationList" + "enumDescriptions": [ + "Location is allowed for use.", + "Location is prohibited.", + "Default value, unused." + ], + "type": "string" + } + }, + "type": "object" + }, + "FutureResourcesSpecSpecificSKUResources": { + "id": "FutureResourcesSpecSpecificSKUResources", + "properties": { + "instanceCount": { + "description": "Size of the request, in instance count.", + "format": "int64", + "type": "string" + }, + "localSsdPartitions": { + "description": "Local SSD partitions. You do not have to include SSD partitions that\nare built in the machine type.", + "items": { + "$ref": "FutureResourcesSpecLocalSsdPartition" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "type": "array" + }, + "machineType": { + "description": "The machine type to use for instances that will use the reservation.\nThis field only accepts machine type names. e.g. n2-standard-4\nand does not accept machine type full or partial url. e.g.\nprojects/my-l7ilb-project/zones/us-central1-a/machineTypes/n2-standard-4.\nUse for GPU reservations.", + "type": "string" + } + }, + "type": "object" + }, + "FutureResourcesSpecTargetResources": { + "description": "Specification of reserved resources.", + "id": "FutureResourcesSpecTargetResources", + "properties": { + "aggregateResources": { + "$ref": "FutureResourcesSpecAggregateResources" + }, + "specificSkuResources": { + "$ref": "FutureResourcesSpecSpecificSKUResources" + } + }, + "type": "object" + }, + "GRPCHealthCheck": { + "id": "GRPCHealthCheck", + "properties": { + "grpcServiceName": { + "description": "The gRPC service name for the health check. This field is optional. The\nvalue of grpc_service_name has the following meanings by convention: \n\n- Empty service_name means the overall status of all services at the\nbackend. \n\n- Non-empty service_name means the health of that gRPC service, as defined\nby the owner of the service. \n\nThe grpc_service_name can only be ASCII.", + "type": "string" + }, + "port": { + "description": "The TCP port number to which the health check prober sends packets. Valid\nvalues are 1 through 65535.", + "format": "int32", + "type": "integer" + }, + "portName": { + "description": "Not supported.", + "type": "string" + }, + "portSpecification": { + "description": "Specifies how a port is selected for health checking. Can be one of the\nfollowing values: \nUSE_FIXED_PORT: Specifies a port number explicitly using theport field in the health check. Supported by backend services\nfor passthrough load balancers and backend services for proxy load\nbalancers. Not supported by target pools. The health check supports all\nbackends supported by the backend service provided the backend can be\nhealth checked. For example, GCE_VM_IP network endpoint\ngroups, GCE_VM_IP_PORT network endpoint groups, and instance\ngroup backends. \n USE_NAMED_PORT: Not supported. \nUSE_SERVING_PORT: Provides an indirect method of specifying\nthe health check port by referring to the backend service. Only supported\nby backend services for proxy load balancers. Not supported by target\npools. Not supported by backend services for passthrough load balancers.\nSupports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group\nbackends.\n\nFor GCE_VM_IP_PORT network endpoint group backends, the health\ncheck uses the port number specified for each endpoint in the network\nendpoint group. For instance group backends, the health check uses the\nport number determined by looking up the backend service's named port in\nthe instance group's list of named ports.", + "enum": [ + "USE_FIXED_PORT", + "USE_NAMED_PORT", + "USE_SERVING_PORT" + ], + "enumDescriptions": [ + "The port number in the health check's port is used for health\nchecking. Applies to network endpoint group and instance group backends.", + "Not supported.", + "For network endpoint group backends, the health check uses the port number\nspecified on each endpoint in the network endpoint group. For instance\ngroup backends, the health check uses the port number specified for the\nbackend service's named port defined in the instance group's named ports." ], - "description": "A list of all the reservations that have been configured for the specified project in specified zone." + "type": "string" + } + }, + "type": "object" + }, + "GRPCTLSHealthCheck": { + "id": "GRPCTLSHealthCheck", + "properties": { + "grpcServiceName": { + "description": "The gRPC service name for the health check. This field is optional. The\nvalue of grpc_service_name has the following meanings by convention: \n\n- Empty service_name means the overall status of all services at the\nbackend. \n\n- Non-empty service_name means the health of that gRPC service, as defined\nby the owner of the service. \n\nThe grpc_service_name can only be ASCII.", + "type": "string" }, - "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" + "port": { + "description": "The TCP port number to which the health check prober sends packets. Valid\nvalues are 1 through 65535.", + "format": "int32", + "type": "integer" + }, + "portSpecification": { + "description": "Specifies how a port is selected for health checking. Can be one of the\nfollowing values: \nUSE_FIXED_PORT: Specifies a port number explicitly using theport field in the health check. Supported by backend services\nfor passthrough load balancers and backend services for proxy load\nbalancers. Not supported by target pools. The health check supports all\nbackends supported by the backend service provided the backend can be\nhealth checked. For example, GCE_VM_IP network endpoint\ngroups, GCE_VM_IP_PORT network endpoint groups, and instance\ngroup backends. \n USE_NAMED_PORT: Not supported. \nUSE_SERVING_PORT: Provides an indirect method of specifying\nthe health check port by referring to the backend service. Only supported\nby backend services for proxy load balancers. Not supported by target\npools. Not supported by backend services for passthrough load balancers.\nSupports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group\nbackends.\n\nFor GCE_VM_IP_PORT network endpoint group backends, the health\ncheck uses the port number specified for each endpoint in the network\nendpoint group. For instance group backends, the health check uses the\nport number determined by looking up the backend service's named port in\nthe instance group's list of named ports.", + "enum": [ + "USE_FIXED_PORT", + "USE_NAMED_PORT", + "USE_SERVING_PORT" ], - "response": { - "$ref": "ReservationAggregatedList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "The port number in the health check's port is used for health\nchecking. Applies to network endpoint group and instance group backends.", + "Not supported.", + "For network endpoint group backends, the health check uses the port number\nspecified on each endpoint in the network endpoint group. For instance\ngroup backends, the health check uses the port number specified for the\nbackend service's named port defined in the instance group's named ports." ], - "description": "Retrieves an aggregated list of reservations. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." + "type": "string" + } + }, + "type": "object" + }, + "GetVersionOperationMetadata": { + "id": "GetVersionOperationMetadata", + "properties": { + "inlineSbomInfo": { + "$ref": "GetVersionOperationMetadataSbomInfo" + } + }, + "type": "object" + }, + "GetVersionOperationMetadataSbomInfo": { + "id": "GetVersionOperationMetadataSbomInfo", + "properties": { + "currentComponentVersions": { + "additionalProperties": { + "type": "string" + }, + "description": "A mapping of components to their currently-applied versions or other\nappropriate identifiers.", + "type": "object" }, - "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" - } + "targetComponentVersions": { + "additionalProperties": { + "type": "string" }, - "parameterOrder": [ - "project", - "zone", - "reservation" - ], - "response": { - "$ref": "Reservation" + "description": "A mapping of components to their target versions or other appropriate\nidentifiers.", + "type": "object" + } + }, + "type": "object" + }, + "GlobalAddressesMoveRequest": { + "id": "GlobalAddressesMoveRequest", + "properties": { + "description": { + "description": "An optional destination address description if intended to be different\nfrom the source.", + "type": "string" + }, + "destinationAddress": { + "description": "The URL of the destination address to move to. This can be a full or\npartial URL. For example, the following are all valid URLs to a address:\n \n - https://www.googleapis.com/compute/v1/projects/project/global/addresses/address \n - projects/project/global/addresses/address\n\n\nNote that destination project must be different from the source project. So/global/addresses/address is not valid partial url.", + "type": "string" + } + }, + "type": "object" + }, + "GlobalNetworkEndpointGroupsAttachEndpointsRequest": { + "id": "GlobalNetworkEndpointGroupsAttachEndpointsRequest", + "properties": { + "networkEndpoints": { + "description": "The list of network endpoints to be attached.", + "items": { + "$ref": "NetworkEndpoint" }, - "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." + "type": "array" + } + }, + "type": "object" + }, + "GlobalNetworkEndpointGroupsDetachEndpointsRequest": { + "id": "GlobalNetworkEndpointGroupsDetachEndpointsRequest", + "properties": { + "networkEndpoints": { + "description": "The list of network endpoints to be detached.", + "items": { + "$ref": "NetworkEndpoint" + }, + "type": "array" + } + }, + "type": "object" + }, + "GlobalOrganizationSetPolicyRequest": { + "id": "GlobalOrganizationSetPolicyRequest", + "properties": { + "bindings": { + "description": "Flatten Policy to create a backward compatible wire-format.\nDeprecated. Use 'policy' to specify bindings.", + "items": { + "$ref": "Binding" + }, + "type": "array" }, - "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" - } + "etag": { + "description": "Flatten Policy to create a backward compatible wire-format.\nDeprecated. Use 'policy' to specify the etag.", + "format": "byte", + "type": "string" + }, + "policy": { + "$ref": "Policy", + "description": "REQUIRED: The complete policy to be applied to the 'resource'. The size of\nthe policy is limited to a few 10s of KB. An empty policy is in general a\nvalid policy but certain services (like Projects) might reject them." + } + }, + "type": "object" + }, + "GlobalSetLabelsRequest": { + "id": "GlobalSetLabelsRequest", + "properties": { + "labelFingerprint": { + "description": "The fingerprint of the previous set of labels for this resource,\nused to detect conflicts. The fingerprint is initially generated by Compute\nEngine and changes after every request to modify or update labels. You must\nalways provide an up-to-date fingerprint hash when updating or changing\nlabels, otherwise the request will fail with error412 conditionNotMet. Make a get() request to the\nresource to get the latest fingerprint.", + "format": "byte", + "type": "string" + }, + "labels": { + "additionalProperties": { + "type": "string" }, - "parameterOrder": [ - "project", - "zone" - ], - "request": { - "$ref": "Reservation" + "description": "A list of labels to apply for this resource. Each label must comply with\nthe\nrequirements for labels. For example,\"webserver-frontend\": \"images\". A label value can also be\nempty (e.g. \"my-label\": \"\").", + "type": "object" + } + }, + "type": "object" + }, + "GlobalSetPolicyRequest": { + "id": "GlobalSetPolicyRequest", + "properties": { + "bindings": { + "description": "Flatten Policy to create a backward compatible wire-format.\nDeprecated. Use 'policy' to specify bindings.", + "items": { + "$ref": "Binding" }, - "response": { - "$ref": "Operation" + "type": "array" + }, + "etag": { + "description": "Flatten Policy to create a backward compatible wire-format.\nDeprecated. Use 'policy' to specify the etag.", + "format": "byte", + "type": "string" + }, + "policy": { + "$ref": "Policy", + "description": "REQUIRED: The complete policy to be applied to the 'resource'. The size of\nthe policy is limited to a few 10s of KB. An empty policy is in general a\nvalid policy but certain services (like Projects) might reject them." + } + }, + "type": "object" + }, + "GlobalVmExtensionPolicy": { + "description": "Message describing GlobalVmExtensionPolicy object.", + "id": "GlobalVmExtensionPolicy", + "properties": { + "creationTimestamp": { + "description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you\ncreate the resource.", + "type": "string" + }, + "extensionPolicies": { + "additionalProperties": { + "$ref": "GlobalVmExtensionPolicyExtensionPolicy" }, - "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." + "description": "Required. Map from extension (eg: \"cloudops\") to its policy configuration.\nThe key is the name of the extension.", + "type": "object" }, - "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" - } + "id": { + "description": "Output only. [Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "format": "uint64", + "readOnly": true, + "type": "string" + }, + "instanceSelectors": { + "description": "Optional. Selector to target VMs for a policy.\nThere is a logical \"AND\" between instance_selectors.", + "items": { + "$ref": "GlobalVmExtensionPolicyInstanceSelector" }, - "parameterOrder": [ - "project", - "zone", - "reservation" + "type": "array" + }, + "kind": { + "default": "compute#globalVmExtensionPolicy", + "description": "Output only. [Output Only] Type of the resource. Alwayscompute#globalVmExtensionPolicy for globalVmExtensionPolicies.", + "readOnly": true, + "type": "string" + }, + "name": { + "description": "Name of the resource. Provided by the client when the resource is created.\nThe name must be 1-63 characters long, and comply withRFC1035.\nSpecifically, the name must be 1-63 characters long and match the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?`\nwhich means the first character must be a lowercase letter, and all\nfollowing characters must be a dash, lowercase letter, or digit, except\nthe last character, which cannot be a dash.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "priority": { + "description": "Optional. Used to resolve conflicts when multiple policies are active for the same\nextension. Defaults to 0.\n\nLarger the number, higher the priority. When the priority is the same,\nthe policy with the newer create time has higher priority.", + "format": "int32", + "type": "integer" + }, + "rolloutOperation": { + "$ref": "GlobalVmExtensionPolicyRolloutOperation", + "description": "Required. The rollout strategy and status." + }, + "scopedResourceStatus": { + "description": "Output only. [Output Only] The scoped resource status. It's only for tracking the\npurging status of the policy.", + "enum": [ + "SCOPED_RESOURCE_STATUS_DELETING", + "SCOPED_RESOURCE_STATUS_UNSPECIFIED" ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "The zonal policies are being deleted.", + "Default value. This value is unused." ], - "description": "Deletes the specified reservation." + "readOnly": true, + "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" - }, - "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" - } + "selfLink": { + "description": "Output only. [Output Only] Server-defined fully-qualified URL for this resource.", + "readOnly": true, + "type": "string" + }, + "selfLinkWithId": { + "description": "Output only. [Output Only] Server-defined URL for this resource's resource id.", + "readOnly": true, + "type": "string" + }, + "updateTimestamp": { + "description": "Output only. [Output Only] Update timestamp inRFC3339\ntext format.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "GlobalVmExtensionPolicyExtensionPolicy": { + "description": "Policy for a single extension.", + "id": "GlobalVmExtensionPolicyExtensionPolicy", + "properties": { + "pinnedVersion": { + "description": "Optional. The version pinning for the extension.\nIf empty, the extension will be installed with the latest version\nreleased by the extension producer.", + "type": "string" + }, + "stringConfig": { + "description": "Optional. String configuration. Any string payload that the extension\nunderstands.", + "type": "string" + } + }, + "type": "object" + }, + "GlobalVmExtensionPolicyInstanceSelector": { + "description": "Selector to target VMs for a zone VM extension policy.", + "id": "GlobalVmExtensionPolicyInstanceSelector", + "properties": { + "labelSelector": { + "$ref": "GlobalVmExtensionPolicyLabelSelector", + "description": "Optional. Labels within the LabelSelector are OR'd." + } + }, + "type": "object" + }, + "GlobalVmExtensionPolicyLabelSelector": { + "description": "A LabelSelector is applicable for a VM only if it matches all labels in\nthe LabelSelector.", + "id": "GlobalVmExtensionPolicyLabelSelector", + "properties": { + "inclusionLabels": { + "additionalProperties": { + "type": "string" }, - "parameterOrder": [ - "project", - "zone", - "reservation" - ], - "request": { - "$ref": "ReservationsResizeRequest" + "description": "Optional. Labels as key value pairs.\nA VM should contain all the pairs specified in this map to be selected;\nLabels within the LabelSelector are OR'ed.", + "type": "object" + } + }, + "type": "object" + }, + "GlobalVmExtensionPolicyList": { + "description": "Response to list global VM extension policy resources.", + "id": "GlobalVmExtensionPolicyList", + "properties": { + "etag": { + "type": "string" + }, + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of GlobalVmExtensionPolicy resources.", + "items": { + "$ref": "GlobalVmExtensionPolicy" }, - "response": { - "$ref": "Operation" + "type": "array" + }, + "kind": { + "default": "compute#globalVmExtensionPolicyList", + "description": "Output only. Type of resource.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "unreachables": { + "description": "Output only. [Output Only] Unreachable resources.", + "items": { + "type": "string" }, - "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." + "readOnly": true, + "type": "array" }, - "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, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "zone": { - "description": "Name of the zone 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" } }, - "parameterOrder": [ - "project", - "zone", - "reservation" + "type": "object" + } + }, + "type": "object" + }, + "GlobalVmExtensionPolicyRolloutOperation": { + "description": "Represents the rollout operation", + "id": "GlobalVmExtensionPolicyRolloutOperation", + "properties": { + "rolloutInput": { + "$ref": "GlobalVmExtensionPolicyRolloutOperationRolloutInput", + "description": "Required. The rollout input which defines the rollout plan." + }, + "rolloutStatus": { + "$ref": "GlobalVmExtensionPolicyRolloutOperationRolloutStatus", + "description": "Output only. [Output Only] The rollout status of the policy.", + "readOnly": true + } + }, + "type": "object" + }, + "GlobalVmExtensionPolicyRolloutOperationRolloutInput": { + "id": "GlobalVmExtensionPolicyRolloutOperationRolloutInput", + "properties": { + "conflictBehavior": { + "description": "Optional. Specifies the behavior of the rollout if a conflict is detected in a\nproject during a rollout. This only applies to `insert` and `update`\nmethods.\n\nA conflict occurs in the following cases:\n\n* `insert` method: If the zonal policy already exists when the insert\n happens.\n* `update` method: If the zonal policy was modified by a zonal API call\n outside of this rollout.\n\nPossible values are the following:\n\n* `\"\"` (empty string): If a conflict occurs, the local value is not\n overwritten. This is the default behavior.\n* `\"overwrite\"`: If a conflict occurs, the local value is overwritten\n with the rollout value.", + "type": "string" + }, + "name": { + "description": "Optional. The name of the rollout plan.\nEx.\nprojects//locations/global/rolloutPlans/.", + "type": "string" + }, + "predefinedRolloutPlan": { + "description": "Optional. Specifies the predefined rollout plan for the policy. Valid values\nare `SLOW_ROLLOUT` and `FAST_ROLLOUT`. The recommended value is\n`SLOW_ROLLOUT` for progressive rollout. For more information, see Rollout\nplans for global policies.", + "enum": [ + "FAST_ROLLOUT", + "ROLLOUT_PLAN_UNSPECIFIED", + "SLOW_ROLLOUT" ], - "request": { - "$ref": "Reservation" + "enumDescriptions": [ + "", + "", + "" + ], + "type": "string" + }, + "retryUuid": { + "description": "Optional. The UUID that identifies a policy rollout retry attempt for update and\ndelete operations. Set this field only when retrying a rollout for an\nexisting extension policy.\n\n* `update` method: Lets you retry policy rollout without changes.\nAn error occurs if you set retry_uuid but the policy is modified.\n* `delete` method: Lets you retry policy deletion rollout if the\nprevious deletion rollout is not finished and the policy is in the\nDELETING state. If you set this field when the policy is not in the\nDELETING state, an error occurs.", + "type": "string" + } + }, + "type": "object" + }, + "GlobalVmExtensionPolicyRolloutOperationRolloutStatus": { + "id": "GlobalVmExtensionPolicyRolloutOperationRolloutStatus", + "properties": { + "currentRollouts": { + "description": "Output only. [Output Only] The current rollouts for the latest version of the\nresource. There should be only one current rollout, but for\nscalability, we make it repeated.", + "items": { + "$ref": "GlobalVmExtensionPolicyRolloutOperationRolloutStatusRolloutMetadata" }, - "response": { - "$ref": "Operation" + "readOnly": true, + "type": "array" + }, + "previousRollout": { + "$ref": "GlobalVmExtensionPolicyRolloutOperationRolloutStatusRolloutMetadata", + "description": "Output only. [Output Only] The last completed rollout resource. This field will not\nbe populated until the first rollout is completed.", + "readOnly": true + } + }, + "type": "object" + }, + "GlobalVmExtensionPolicyRolloutOperationRolloutStatusRolloutMetadata": { + "id": "GlobalVmExtensionPolicyRolloutOperationRolloutStatusRolloutMetadata", + "properties": { + "locationRolloutStatus": { + "additionalProperties": { + "$ref": "GlobalVmExtensionPolicyRolloutOperationRolloutStatusRolloutMetadataLocationRolloutStatus" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "description": "Output only. [Output Only] The rollout status for each location. The list of the\nlocations is the same as the list of locations in the rollout plan.", + "readOnly": true, + "type": "object" + }, + "rollout": { + "description": "Output only. [Output Only] The name of the rollout.\nEx. projects//locations/global/rollouts/.", + "readOnly": true, + "type": "string" + }, + "rolloutPlan": { + "description": "Output only. [Output Only] The name of the rollout plan.\nEx.\nprojects//locations/global/rolloutPlans/.", + "readOnly": true, + "type": "string" + }, + "state": { + "description": "Output only. [Output Only] The overall state of the rollout.", + "enum": [ + "STATE_CANCELLED", + "STATE_COMPLETED", + "STATE_FAILED", + "STATE_PAUSED", + "STATE_PROCESSING", + "STATE_UNKNOWN", + "STATE_UNSPECIFIED" + ], + "enumDescriptions": [ + "Iteration was explicitly cancelled.", + "Iteration completed, with all actions being successful.", + "Iteration completed, with failures.", + "The rollout is paused.", + "Iteration is in progress.", + "Impossible to determine current state of the iteration.", + "Default value. This value is unused." + ], + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "GlobalVmExtensionPolicyRolloutOperationRolloutStatusRolloutMetadataLocationRolloutStatus": { + "id": "GlobalVmExtensionPolicyRolloutOperationRolloutStatusRolloutMetadataLocationRolloutStatus", + "properties": { + "state": { + "description": "Output only. [Output Only] The state of the location rollout.", + "enum": [ + "LOCATION_ROLLOUT_STATE_COMPLETED", + "LOCATION_ROLLOUT_STATE_FAILED", + "LOCATION_ROLLOUT_STATE_NOT_STARTED", + "LOCATION_ROLLOUT_STATE_SKIPPED", + "LOCATION_ROLLOUT_STATE_UNSPECIFIED" + ], + "enumDescriptions": [ + "The location rollout is completed.", + "The location rollout has failed.", + "The location rollout has not started.", + "The location rollout is skipped.", + "Default value. This value is unused." ], - "description": "Update share settings of the reservation." + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "GroupMaintenanceInfo": { + "description": "Maintenance Info for ReservationBlocks.", + "id": "GroupMaintenanceInfo", + "properties": { + "instanceMaintenanceOngoingCount": { + "description": "Describes number of instances that have ongoing maintenance.", + "format": "int32", + "type": "integer" }, - "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" + "instanceMaintenancePendingCount": { + "description": "Describes number of instances that have pending maintenance.", + "format": "int32", + "type": "integer" + }, + "maintenanceOngoingCount": { + "description": "Progress for ongoing maintenance for this group of VMs/hosts.\nDescribes number of hosts in the block that have ongoing maintenance.", + "format": "int32", + "type": "integer" + }, + "maintenancePendingCount": { + "description": "Progress for ongoing maintenance for this group of VMs/hosts.\nDescribes number of hosts in the block that have pending maintenance.", + "format": "int32", + "type": "integer" + }, + "schedulingType": { + "description": "The type of maintenance for the reservation.", + "enum": [ + "GROUPED", + "GROUP_MAINTENANCE_TYPE_UNSPECIFIED", + "INDEPENDENT" ], - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "Maintenance on all reserved instances in the reservation is synchronized.", + "Unknown maintenance type.", + "Maintenance is not synchronized for this reservation. Instead, each\ninstance has its own maintenance window." ], - "description": "Gets the access control policy for a resource. May be empty if no such policy or resource exists." + "type": "string" }, - "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" - } + "subblockInfraMaintenanceOngoingCount": { + "description": "Describes number of subblock Infrastructure that has ongoing maintenance.\nHere, Subblock Infrastructure Maintenance pertains to upstream hardware\ncontained in the Subblock that is necessary for a VM Family(e.g. NVLink\nDomains). Not all VM Families will support this field.", + "format": "int32", + "type": "integer" + }, + "subblockInfraMaintenancePendingCount": { + "description": "Describes number of subblock Infrastructure that has pending maintenance.\n Here, Subblock Infrastructure Maintenance pertains to upstream hardware\n contained in the Subblock that is necessary for a VM Family (e.g. NVLink\n Domains). Not all VM Families will support this field.", + "format": "int32", + "type": "integer" + }, + "upcomingGroupMaintenance": { + "$ref": "UpcomingMaintenance", + "description": "Maintenance information on this group of VMs." + } + }, + "type": "object" + }, + "GuestAttributes": { + "description": "A guest attributes entry.", + "id": "GuestAttributes", + "properties": { + "kind": { + "default": "compute#guestAttributes", + "description": "Output only. [Output Only] Type of the resource. Alwayscompute#guestAttributes for guest attributes entry.", + "readOnly": true, + "type": "string" + }, + "queryPath": { + "description": "The path to be queried. This can be the default namespace ('') or a\nnested namespace ('\\/') or a specified key\n('\\/\\').", + "type": "string" + }, + "queryValue": { + "$ref": "GuestAttributesValue", + "description": "Output only. [Output Only] The value of the requested queried path.", + "readOnly": true + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "variableKey": { + "description": "The key to search for.", + "type": "string" + }, + "variableValue": { + "description": "Output only. [Output Only] The value found for the requested key.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "GuestAttributesEntry": { + "description": "A guest attributes namespace/key/value entry.", + "id": "GuestAttributesEntry", + "properties": { + "key": { + "description": "Key for the guest attribute entry.", + "type": "string" + }, + "namespace": { + "description": "Namespace for the guest attribute entry.", + "type": "string" + }, + "value": { + "description": "Value for the guest attribute entry.", + "type": "string" + } + }, + "type": "object" + }, + "GuestAttributesValue": { + "description": "Array of guest attribute namespace/key/value tuples.", + "id": "GuestAttributesValue", + "properties": { + "items": { + "items": { + "$ref": "GuestAttributesEntry" }, - "parameterOrder": [ - "project", - "zone", - "resource" + "type": "array" + } + }, + "type": "object" + }, + "GuestOsFeature": { + "description": "Guest OS features.", + "id": "GuestOsFeature", + "properties": { + "type": { + "description": "The ID of a supported feature. To add multiple values, use commas to\nseparate values. Set to one or more of the following values:\n \n - VIRTIO_SCSI_MULTIQUEUE\n - WINDOWS\n - MULTI_IP_SUBNET\n - UEFI_COMPATIBLE\n - GVNIC\n - SEV_CAPABLE\n - SUSPEND_RESUME_COMPATIBLE\n - SEV_LIVE_MIGRATABLE_V2\n - SEV_SNP_CAPABLE\n - TDX_CAPABLE\n - IDPF\n - SNP_SVSM_CAPABLE\n - CCA_CAPABLE\n\n\nFor more information, see\nEnabling guest operating system features.", + "enum": [ + "BARE_METAL_LINUX_COMPATIBLE", + "CCA_CAPABLE", + "FEATURE_TYPE_UNSPECIFIED", + "GVNIC", + "IDPF", + "MULTI_IP_SUBNET", + "SECURE_BOOT", + "SEV_CAPABLE", + "SEV_LIVE_MIGRATABLE", + "SEV_LIVE_MIGRATABLE_V2", + "SEV_SNP_CAPABLE", + "SNP_SVSM_CAPABLE", + "TDX_CAPABLE", + "UEFI_COMPATIBLE", + "VIRTIO_SCSI_MULTIQUEUE", + "WINDOWS" ], - "request": { - "$ref": "ZoneSetPolicyRequest" - }, - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "" ], - "description": "Sets the access control policy on the specified resource. Replaces any existing policy." + "type": "string" + } + }, + "type": "object" + }, + "HTTP2HealthCheck": { + "id": "HTTP2HealthCheck", + "properties": { + "host": { + "description": "The value of the host header in the HTTP/2 health check request. If left\nempty (default value), the host header is set to the destination IP address\nto which health check packets are sent. The destination IP address depends\non the type of load balancer. For details, see:\nhttps://cloud.google.com/load-balancing/docs/health-check-concepts#hc-packet-dest", + "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" + "port": { + "description": "The TCP port number to which the health check prober sends packets. The\ndefault value is 443. Valid values are 1 through65535.", + "format": "int32", + "type": "integer" + }, + "portName": { + "description": "Not supported.", + "type": "string" + }, + "portSpecification": { + "description": "Specifies how a port is selected for health checking. Can be one of the\nfollowing values: \nUSE_FIXED_PORT: Specifies a port number explicitly using theport field in the health check. Supported by backend services\nfor passthrough load balancers and backend services for proxy load\nbalancers. Not supported by target pools. The health check supports all\nbackends supported by the backend service provided the backend can be\nhealth checked. For example, GCE_VM_IP network endpoint\ngroups, GCE_VM_IP_PORT network endpoint groups, and instance\ngroup backends. \n USE_NAMED_PORT: Not supported. \nUSE_SERVING_PORT: Provides an indirect method of specifying\nthe health check port by referring to the backend service. Only supported\nby backend services for proxy load balancers. Not supported by target\npools. Not supported by backend services for passthrough load balancers.\nSupports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group\nbackends.\n\nFor GCE_VM_IP_PORT network endpoint group backends, the health\ncheck uses the port number specified for each endpoint in the network\nendpoint group. For instance group backends, the health check uses the\nport number determined by looking up the backend service's named port in\nthe instance group's list of named ports.", + "enum": [ + "USE_FIXED_PORT", + "USE_NAMED_PORT", + "USE_SERVING_PORT" ], - "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" + "enumDescriptions": [ + "The port number in the health check's port is used for health\nchecking. Applies to network endpoint group and instance group backends.", + "Not supported.", + "For network endpoint group backends, the health check uses the port number\nspecified on each endpoint in the network endpoint group. For instance\ngroup backends, the health check uses the port number specified for the\nbackend service's named port defined in the instance group's named ports." ], - "description": "Returns permissions that a caller has on the specified resource." + "type": "string" }, - "performMaintenance": { - "id": "compute.reservations.performMaintenance", - "path": "projects/{project}/zones/{zone}/reservations/{reservation}/performMaintenance", - "flatPath": "projects/{project}/zones/{zone}/reservations/{reservation}/performMaintenance", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for 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" - }, - "reservation": { - "description": "The name of the reservation. Name should conform to RFC1035 or be a resource ID.", - "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. Zone name should conform to RFC1035.", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "reservation" + "proxyHeader": { + "description": "Specifies the type of proxy header to append before sending data to the\nbackend, either NONE or PROXY_V1. The default\nis NONE.", + "enum": [ + "NONE", + "PROXY_V1" ], - "request": { - "$ref": "ReservationsPerformMaintenanceRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "", + "" ], - "description": "Perform maintenance on an extended reservation" + "type": "string" + }, + "requestPath": { + "description": "The request path of the HTTP/2 health check request. The default value is/. Must comply withRFC3986.", + "type": "string" + }, + "response": { + "description": "Creates a content-based HTTP/2 health check. In addition to the required\nHTTP 200 (OK) status code, you can configure the health check to pass only\nwhen the backend sends this specific ASCII response string within the first\n1024 bytes of the HTTP response body. For details, see:\nhttps://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-http", + "type": "string" } - } + }, + "type": "object" }, - "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" + "HTTPHealthCheck": { + "id": "HTTPHealthCheck", + "properties": { + "host": { + "description": "The value of the host header in the HTTP health check request. If left\nempty (default value), the host header is set to the destination IP address\nto which health check packets are sent. The destination IP address depends\non the type of load balancer. For details, see:\nhttps://cloud.google.com/load-balancing/docs/health-check-concepts#hc-packet-dest", + "type": "string" + }, + "port": { + "description": "The TCP port number to which the health check prober sends packets. The\ndefault value is 80. Valid values are 1 through65535.", + "format": "int32", + "type": "integer" + }, + "portName": { + "description": "Not supported.", + "type": "string" + }, + "portSpecification": { + "description": "Specifies how a port is selected for health checking. Can be one of the\nfollowing values: \nUSE_FIXED_PORT: Specifies a port number explicitly using theport field in the health check. Supported by backend services\nfor passthrough load balancers and backend services for proxy load\nbalancers. Also supported in legacy HTTP health checks for target pools.\nThe health check supports all backends supported by the backend service\nprovided the backend can be health checked. For example,GCE_VM_IP network endpoint groups, GCE_VM_IP_PORT\nnetwork endpoint groups, and instance group backends. \nUSE_NAMED_PORT: Not supported. \nUSE_SERVING_PORT: Provides an indirect method of specifying\nthe health check port by referring to the backend service. Only supported\nby backend services for proxy load balancers. Not supported by target\npools. Not supported by backend services for pass-through load balancers.\nSupports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group\nbackends.\n\nFor GCE_VM_IP_PORT network endpoint group backends, the health\ncheck uses the port number specified for each endpoint in the network\nendpoint group. For instance group backends, the health check uses the\nport number determined by looking up the backend service's named port in\nthe instance group's list of named ports.", + "enum": [ + "USE_FIXED_PORT", + "USE_NAMED_PORT", + "USE_SERVING_PORT" + ], + "enumDescriptions": [ + "The port number in the health check's port is used for health\nchecking. Applies to network endpoint group and instance group backends.", + "Not supported.", + "For network endpoint group backends, the health check uses the port number\nspecified on each endpoint in the network endpoint group. For instance\ngroup backends, the health check uses the port number specified for the\nbackend service's named port defined in the instance group's named ports." + ], + "type": "string" + }, + "proxyHeader": { + "description": "Specifies the type of proxy header to append before sending data to the\nbackend, either NONE or PROXY_V1. The default\nis NONE.", + "enum": [ + "NONE", + "PROXY_V1" + ], + "enumDescriptions": [ + "", + "" + ], + "type": "string" + }, + "requestPath": { + "description": "The request path of the HTTP health check request. The default value is/. Must comply withRFC3986.", + "type": "string" + }, + "response": { + "description": "Creates a content-based HTTP health check. In addition to the required\nHTTP 200 (OK) status code, you can configure the health check to pass only\nwhen the backend sends this specific ASCII response string within the first\n1024 bytes of the HTTP response body. For details, see:\nhttps://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-http", + "type": "string" + } + }, + "type": "object" + }, + "HTTPSHealthCheck": { + "id": "HTTPSHealthCheck", + "properties": { + "host": { + "description": "The value of the host header in the HTTPS health check request. If left\nempty (default value), the host header is set to the destination IP address\nto which health check packets are sent. The destination IP address depends\non the type of load balancer. For details, see:\nhttps://cloud.google.com/load-balancing/docs/health-check-concepts#hc-packet-dest", + "type": "string" + }, + "port": { + "description": "The TCP port number to which the health check prober sends packets. The\ndefault value is 443. Valid values are 1 through65535.", + "format": "int32", + "type": "integer" + }, + "portName": { + "description": "Not supported.", + "type": "string" + }, + "portSpecification": { + "description": "Specifies how a port is selected for health checking. Can be one of the\nfollowing values: \nUSE_FIXED_PORT: Specifies a port number explicitly using theport field in the health check. Supported by backend services\nfor passthrough load balancers and backend services for proxy load\nbalancers. Not supported by target pools. The health check supports all\nbackends supported by the backend service provided the backend can be\nhealth checked. For example, GCE_VM_IP network endpoint\ngroups, GCE_VM_IP_PORT network endpoint groups, and instance\ngroup backends. \n USE_NAMED_PORT: Not supported. \nUSE_SERVING_PORT: Provides an indirect method of specifying\nthe health check port by referring to the backend service. Only supported\nby backend services for proxy load balancers. Not supported by target\npools. Not supported by backend services for passthrough load balancers.\nSupports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group\nbackends.\n\nFor GCE_VM_IP_PORT network endpoint group backends, the health\ncheck uses the port number specified for each endpoint in the network\nendpoint group. For instance group backends, the health check uses the\nport number determined by looking up the backend service's named port in\nthe instance group's list of named ports.", + "enum": [ + "USE_FIXED_PORT", + "USE_NAMED_PORT", + "USE_SERVING_PORT" + ], + "enumDescriptions": [ + "The port number in the health check's port is used for health\nchecking. Applies to network endpoint group and instance group backends.", + "Not supported.", + "For network endpoint group backends, the health check uses the port number\nspecified on each endpoint in the network endpoint group. For instance\ngroup backends, the health check uses the port number specified for the\nbackend service's named port defined in the instance group's named ports." + ], + "type": "string" + }, + "proxyHeader": { + "description": "Specifies the type of proxy header to append before sending data to the\nbackend, either NONE or PROXY_V1. The default\nis NONE.", + "enum": [ + "NONE", + "PROXY_V1" ], - "response": { - "$ref": "InstanceGroupList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "", + "" ], - "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." + "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", + "requestPath": { + "description": "The request path of the HTTPS health check request. The default value is/. Must comply withRFC3986.", + "type": "string" + }, + "response": { + "description": "Creates a content-based HTTPS health check. In addition to the required\nHTTP 200 (OK) status code, you can configure the health check to pass only\nwhen the backend sends this specific ASCII response string within the first\n1024 bytes of the HTTP response body. For details, see:\nhttps://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-http", + "type": "string" + } + }, + "type": "object" + }, + "HealthAggregationPoliciesScopedList": { + "id": "HealthAggregationPoliciesScopedList", + "properties": { + "healthAggregationPolicies": { + "description": "A list of HealthAggregationPolicys contained in this scope.", + "items": { + "$ref": "HealthAggregationPolicy" + }, + "type": "array" + }, + "warning": { + "description": "Informational warning which replaces the list of health aggregation\npolicies when the list is empty.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "pageToken": { - "description": "Specifies a page token 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{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" } }, - "parameterOrder": [ - "project" + "type": "object" + } + }, + "type": "object" + }, + "HealthAggregationPolicy": { + "description": "Represents a health aggregation policy.\n\nA health aggregation policy resource defines a policy to aggregate health.\n\nFor more information, see\nHealth checks overview.", + "id": "HealthAggregationPolicy", + "properties": { + "creationTimestamp": { + "description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you\ncreate the resource.", + "type": "string" + }, + "fingerprint": { + "description": "Fingerprint of this resource. A hash of the contents stored in this object.\nThis field is used in optimistic locking. This field will be ignored when\ninserting a HealthAggregationPolicy. An up-to-date fingerprint\nmust be provided in order to patch the HealthAggregationPolicy; Otherwise,\nthe request will fail with error 412 conditionNotMet. To see\nthe latest fingerprint, make a get() request to retrieve the\nHealthAggregationPolicy.", + "format": "byte", + "type": "string" + }, + "healthyPercentThreshold": { + "description": "Can only be set if the policyType field isBACKEND_SERVICE_POLICY. Specifies the threshold (as a\npercentage) of healthy endpoints required in order to consider the\naggregated health result HEALTHY. Defaults to 60. Must be in\nrange [0, 100]. Not applicable if the policyType field isDNB_PUBLIC_IP_POLICY. Can be mutated. This field is optional,\nand will be set to the default if unspecified. Note that both this\nthreshold and minHealthyThreshold must be satisfied in order\nfor HEALTHY to be the aggregated result. \"Endpoints\" refers to network\nendpoints within a Network Endpoint Group or instances within an Instance\nGroup.", + "format": "uint32", + "type": "integer" + }, + "id": { + "description": "Output only. [Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "format": "uint64", + "readOnly": true, + "type": "string" + }, + "kind": { + "default": "compute#healthAggregationPolicy", + "description": "Output only. [Output Only] Type of the resource. Alwayscompute#healthAggregationPolicy for health aggregation\npolicies.", + "readOnly": true, + "type": "string" + }, + "minHealthyThreshold": { + "description": "Can only be set if the policyType field isBACKEND_SERVICE_POLICY. Specifies the minimum number of\nhealthy endpoints required in order to consider the aggregated health\nresult HEALTHY. Defaults to 1. Must be positive. Not\napplicable if the policyType field isDNB_PUBLIC_IP_POLICY. Can be mutated. This field is optional,\nand will be set to the default if unspecified. Note that both this\nthreshold and healthyPercentThreshold must be satisfied in\norder for HEALTHY to be the aggregated result. \"Endpoints\" refers to\nnetwork endpoints within a Network Endpoint Group or instances within an\nInstance Group.", + "format": "uint32", + "type": "integer" + }, + "name": { + "description": "Name of the resource. Provided by the client when the resource is created.\nThe name must be 1-63 characters long, and comply withRFC1035.\nSpecifically, the name must be 1-63 characters long and match the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first\ncharacter must be a lowercase letter, and all following characters must\nbe a dash, lowercase letter, or digit, except the last character, which\ncannot be a dash.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "policyType": { + "description": "Specifies the type of the healthAggregationPolicy. The only allowed value\nfor global resources is DNS_PUBLIC_IP_POLICY. The only allowed\nvalue for regional resources is BACKEND_SERVICE_POLICY. Must\nbe specified when the healthAggregationPolicy is created, and cannot be\nmutated.", + "enum": [ + "BACKEND_SERVICE_POLICY", + "DNS_PUBLIC_IP_POLICY" ], - "response": { - "$ref": "InstanceGroupAggregatedList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "", + "" ], - "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`." + "type": "string" }, - "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" - } + "region": { + "description": "Output only. [Output Only] URL of the region where the health aggregation policy\nresides. This field applies only to the regional resource. You must specify\nthis field as part of the HTTP request URL. It is not settable as a field\nin the request body.", + "readOnly": true, + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for the resource.", + "readOnly": true, + "type": "string" + }, + "selfLinkWithId": { + "description": "Output only. [Output Only] Server-defined URL with id for the resource.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "HealthAggregationPolicyAggregatedList": { + "description": "Contains a list of HealthAggregationPoliciesScopedList.", + "id": "HealthAggregationPolicyAggregatedList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "additionalProperties": { + "$ref": "HealthAggregationPoliciesScopedList", + "description": "Name of the scope containing this set of HealthAggregationPolicies." }, - "parameterOrder": [ - "project", - "zone", - "instanceGroup" - ], - "response": { - "$ref": "InstanceGroup" + "description": "A list of HealthAggregationPoliciesScopedList resources.", + "type": "object" + }, + "kind": { + "default": "compute#healthAggregationPolicyAggregatedList", + "description": "Output only. Type of resource.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "unreachables": { + "description": "Output only. [Output Only] Unreachable resources.", + "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": "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." + "readOnly": true, + "type": "array" }, - "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, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "zone": { - "description": "The name of the zone where you want to create the instance group.", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project", - "zone" - ], - "request": { - "$ref": "InstanceGroup" - }, - "response": { - "$ref": "Operation" + "type": "object" + } + }, + "type": "object" + }, + "HealthAggregationPolicyList": { + "id": "HealthAggregationPolicyList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of HealthAggregationPolicy resources.", + "items": { + "$ref": "HealthAggregationPolicy" }, - "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." + "type": "array" }, - "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, + "kind": { + "default": "compute#healthAggregationPolicyList", + "description": "Output only. [Output Only] Type of the resource. Alwayscompute#healthAggregationPolicy for health aggregation\npolicies.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue 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.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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" } }, - "parameterOrder": [ - "project", - "zone", - "instanceGroup" - ], - "response": { - "$ref": "Operation" + "type": "object" + } + }, + "type": "object" + }, + "HealthCheck": { + "description": "Represents a health check resource.\n\nGoogle Compute Engine has two health check resources:\n\n* [Regional](/compute/docs/reference/rest/v1/regionHealthChecks)\n* [Global](/compute/docs/reference/rest/v1/healthChecks)\n\nThese health check resources can be used for load balancing and for\nautohealing VMs in a managed instance group (MIG).\n\n**Load balancing**\n\nHealth check requirements vary depending on the type of load balancer. For\ndetails about the type of health check supported for\neach load balancer and corresponding backend type,\nsee Health\nchecks overview: Load balancer guide.\n\n**Autohealing in MIGs**\n\nThe health checks that you use for autohealing VMs in a MIG can be either\nregional or global. For more information, see Set up an\napplication health check and autohealing.\n\nFor more information, seeHealth checks\noverview.", + "id": "HealthCheck", + "properties": { + "checkIntervalSec": { + "description": "How often (in seconds) to send a health check. The default value is 5\nseconds.", + "format": "int32", + "type": "integer" + }, + "creationTimestamp": { + "description": "Output only. [Output Only] Creation timestamp in3339\ntext format.", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you\ncreate the resource.", + "type": "string" + }, + "grpcHealthCheck": { + "$ref": "GRPCHealthCheck" + }, + "grpcTlsHealthCheck": { + "$ref": "GRPCTLSHealthCheck" + }, + "healthyThreshold": { + "description": "A so-far unhealthy instance will be marked healthy after this\nmany consecutive successes. The default value is 2.", + "format": "int32", + "type": "integer" + }, + "http2HealthCheck": { + "$ref": "HTTP2HealthCheck" + }, + "httpHealthCheck": { + "$ref": "HTTPHealthCheck" + }, + "httpsHealthCheck": { + "$ref": "HTTPSHealthCheck" + }, + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "format": "uint64", + "type": "string" + }, + "kind": { + "default": "compute#healthCheck", + "description": "Output only. Type of the resource.", + "readOnly": true, + "type": "string" + }, + "logConfig": { + "$ref": "HealthCheckLogConfig", + "description": "Configure logging on this health check." + }, + "name": { + "description": "Name of the resource. Provided by the client when the resource is created.\nThe name must be 1-63 characters long, and comply withRFC1035.\nFor example, a name that is 1-63 characters long, matches the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?`, and otherwise complies with\nRFC1035. This regular expression describes a name where the first\ncharacter is a lowercase letter, and all following characters are a dash,\nlowercase 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" + }, + "region": { + "description": "Output only. [Output Only] Region where the health check resides. Not applicable to\nglobal health checks.", + "readOnly": true, + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" + }, + "sourceRegions": { + "description": "The list of cloud regions from which health checks are performed. If any\nregions are specified, then exactly 3 regions should be specified. The\nregion names must be valid names of Google Cloud regions.\nThis can only be set for global health check.\nIf this list is non-empty, then there are restrictions\non what other health check fields are supported and what other resources\ncan use this health check:\n \n - SSL, HTTP2, GRPC, and GRPC_WITH_TLS protocols are not supported.\n - The TCP request field is not supported.\n - The proxyHeader field for HTTP, HTTPS, and TCP is not\n supported.\n - The checkIntervalSec field must be at least 30.\n - The health check cannot be used with BackendService nor with managed\n instance group auto-healing.", + "items": { + "type": "string" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "type": "array" + }, + "sslHealthCheck": { + "$ref": "SSLHealthCheck" + }, + "tcpHealthCheck": { + "$ref": "TCPHealthCheck" + }, + "timeoutSec": { + "description": "How long (in seconds) to wait before claiming failure. The default value is\n5 seconds. It is invalid for timeoutSec to have greater\nvalue than checkIntervalSec.", + "format": "int32", + "type": "integer" + }, + "type": { + "description": "Specifies the type of the healthCheck, either TCP,SSL, HTTP, HTTPS,HTTP2, GRPC or GRPC_WITH_TLS.\nExactly one of the protocol-specific health check fields must be specified,\nwhich must match type field.", + "enum": [ + "GRPC", + "GRPC_WITH_TLS", + "HTTP", + "HTTP2", + "HTTPS", + "INVALID", + "SSL", + "TCP" + ], + "enumDescriptions": [ + "", + "", + "", + "", + "", + "", + "", + "" ], - "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." + "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, + "unhealthyThreshold": { + "description": "A so-far healthy instance will be marked unhealthy after this many\nconsecutive failures. The default value is 2.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, + "HealthCheckList": { + "description": "Contains a list of HealthCheck resources.", + "id": "HealthCheckList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of HealthCheck resources.", + "items": { + "$ref": "HealthCheck" + }, + "type": "array" + }, + "kind": { + "default": "compute#healthCheckList", + "description": "Output only. Type of resource.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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" } }, - "parameterOrder": [ - "project", - "zone", - "instanceGroup" - ], - "request": { - "$ref": "InstanceGroupsAddInstancesRequest" - }, - "response": { - "$ref": "Operation" + "type": "object" + } + }, + "type": "object" + }, + "HealthCheckLogConfig": { + "description": "Configuration of logging on a health check. If logging is enabled, logs\nwill be exported to Stackdriver.", + "id": "HealthCheckLogConfig", + "properties": { + "enable": { + "description": "Indicates whether or not to export logs. This is false by default, which\nmeans no health check logging will be done.", + "type": "boolean" + } + }, + "type": "object" + }, + "HealthCheckReference": { + "description": "A full or valid partial URL to a health check. For example, the following are\nvalid URLs:\n \n - https://www.googleapis.com/compute/beta/projects/project-id/global/httpHealthChecks/health-check\n - projects/project-id/global/httpHealthChecks/health-check\n - global/httpHealthChecks/health-check", + "id": "HealthCheckReference", + "properties": { + "healthCheck": { + "type": "string" + } + }, + "type": "object" + }, + "HealthCheckService": { + "description": "Represents a Health-Check as a Service resource.", + "id": "HealthCheckService", + "properties": { + "creationTimestamp": { + "description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you\ncreate the resource.", + "type": "string" + }, + "fingerprint": { + "description": "Fingerprint of this resource. A hash of the contents stored in this object.\nThis field is used in optimistic locking. This field will be ignored when\ninserting a HealthCheckService. An up-to-date fingerprint must\nbe provided in order to patch/update the HealthCheckService; Otherwise, the\nrequest will fail with error 412 conditionNotMet. To see the\nlatest fingerprint, make a get() request to retrieve the\nHealthCheckService.", + "format": "byte", + "type": "string" + }, + "healthChecks": { + "description": "A list of URLs to the HealthCheck resources. Must have\nat least one HealthCheck, and not more than 10 for regionalHealthCheckService, and not more than 1 for globalHealthCheckService.HealthCheck resources must haveportSpecification=USE_SERVING_PORT orportSpecification=USE_FIXED_PORT. For\nregional HealthCheckService, theHealthCheck must be regional and in the same\nregion. For global HealthCheckService,HealthCheck must be global. Mix of regional and globalHealthChecks is not supported. Multiple regionalHealthChecks must belong to the same region. RegionalHealthChecks must belong to the same region as zones ofNetworkEndpointGroups. For globalHealthCheckService using globalINTERNET_IP_PORT NetworkEndpointGroups, the\nglobal HealthChecks must specify sourceRegions,\nand HealthChecks that specify sourceRegions can\nonly be used with global INTERNET_IP_PORTNetworkEndpointGroups.", + "items": { + "type": "string" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "type": "array" + }, + "healthStatusAggregationPolicy": { + "description": "Optional. Policy for how the results from multiple health checks\nfor the same endpoint are aggregated. Defaults to NO_AGGREGATION\nif unspecified.\n \n - NO_AGGREGATION. An EndpointHealth message is\n returned for each pair in the health check\n service.\n - AND. If any health check of an endpoint reportsUNHEALTHY, then UNHEALTHY is theHealthState of the endpoint. If all health checks reportHEALTHY, the HealthState of the endpoint isHEALTHY.\n\n.\nThis is only allowed with regional HealthCheckService.", + "enum": [ + "AND", + "NO_AGGREGATION" + ], + "enumDescriptions": [ + "If any backend's health check reports UNHEALTHY,\nthen UNHEALTHY is the HealthState of\nthe entire health check service. If all backend's are healthy,\nthe HealthState of the health check service isHEALTHY.", + "An EndpointHealth message is returned for each\nbackend in the health check service." ], - "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." + "type": "string" }, - "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" - }, - "zone": { - "description": "The name of the zone where the instance group is located.", - "location": "path", - "required": true, - "type": "string" - } + "id": { + "description": "Output only. [Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "format": "uint64", + "readOnly": true, + "type": "string" + }, + "kind": { + "default": "compute#healthCheckService", + "description": "Output only. [Output only] Type of the resource. Alwayscompute#healthCheckServicefor health check services.", + "readOnly": true, + "type": "string" + }, + "name": { + "description": "Name of the resource. The name must be 1-63 characters long, and comply\nwith RFC1035. Specifically, the name must be 1-63 characters\nlong and match the regular expression\n`[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character\nmust be a lowercase letter, and all following characters must be a dash,\nlowercase letter, or digit, except the last character, which cannot be a\ndash.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "networkEndpointGroups": { + "description": "A list of URLs to the NetworkEndpointGroup\nresources. Must not have more than 100. For regionalHealthCheckService, NEGs must be in\nzones in the region of the HealthCheckService. For globalHealthCheckServices, the NetworkEndpointGroups\nmust be global INTERNET_IP_PORT.", + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "zone", - "instanceGroup" - ], - "request": { - "$ref": "InstanceGroupsRemoveInstancesRequest" + "type": "array" + }, + "notificationEndpoints": { + "description": "A list of URLs to the NotificationEndpoint\nresources. Must not have more than 10. A list of endpoints for\nreceiving notifications of change in health status. For regionalHealthCheckService,NotificationEndpoint must be regional and in the\nsame region. For global HealthCheckService,NotificationEndpoint must be global.", + "items": { + "type": "string" }, - "response": { - "$ref": "Operation" + "type": "array" + }, + "region": { + "description": "Output only. [Output Only] URL of the region where the health check service\nresides. This field is not applicable to global health check services.\nYou must specify this field as part of the HTTP request URL. It is\nnot settable as a field in the request body.", + "readOnly": true, + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for the resource.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "HealthCheckServiceAggregatedList": { + "description": "Contains a list of HealthCheckServicesScopedList.", + "id": "HealthCheckServiceAggregatedList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "additionalProperties": { + "$ref": "HealthCheckServicesScopedList", + "description": "Name of the scope containing this set of HealthCheckServices." }, - "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." + "description": "A list of HealthCheckServicesScopedList resources.", + "type": "object" }, - "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, + "kind": { + "default": "compute#healthCheckServiceAggregatedList", + "description": "Output only. Type of resource.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "unreachables": { + "description": "Output only. [Output Only] Unreachable resources.", + "items": { + "type": "string" + }, + "readOnly": true, + "type": "array" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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" } }, - "parameterOrder": [ - "project", - "zone", - "instanceGroup" - ], - "request": { - "$ref": "InstanceGroupsListInstancesRequest" - }, - "response": { - "$ref": "InstanceGroupsListInstances" + "type": "object" + } + }, + "type": "object" + }, + "HealthCheckServiceReference": { + "description": "A full or valid partial URL to a health check service. For example, the\nfollowing are valid URLs:\n \n - https://www.googleapis.com/compute/beta/projects/project-id/regions/us-west1/healthCheckServices/health-check-service\n - projects/project-id/regions/us-west1/healthCheckServices/health-check-service\n - regions/us-west1/healthCheckServices/health-check-service", + "id": "HealthCheckServiceReference", + "properties": { + "healthCheckService": { + "type": "string" + } + }, + "type": "object" + }, + "HealthCheckServicesList": { + "id": "HealthCheckServicesList", + "properties": { + "id": { + "description": "Output only. [Output Only] Unique identifier for the resource; defined by the server.", + "readOnly": true, + "type": "string" + }, + "items": { + "description": "Output only. A list of HealthCheckService resources.", + "items": { + "$ref": "HealthCheckService" }, - "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." + "readOnly": true, + "type": "array" }, - "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, + "kind": { + "default": "compute#healthCheckServicesList", + "description": "Output only. [Output Only] Type of the resource. Alwayscompute#healthCheckServicesList for lists of\nHealthCheckServices.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "Output only. [Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "readOnly": true, + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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" } }, - "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." + "type": "object" } - } + }, + "type": "object" }, - "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", + "HealthCheckServicesScopedList": { + "id": "HealthCheckServicesScopedList", + "properties": { + "resources": { + "description": "A list of HealthCheckServices contained in this scope.", + "items": { + "$ref": "HealthCheckService" + }, + "type": "array" + }, + "warning": { + "description": "Informational warning which replaces the list of\nbackend services when the list is empty.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "region": { - "description": "Name of the region scoping this request.", - "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" } }, - "parameterOrder": [ - "project", - "region" - ], - "response": { - "$ref": "RegionInstanceGroupList" + "type": "object" + } + }, + "type": "object" + }, + "HealthChecksAggregatedList": { + "id": "HealthChecksAggregatedList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "additionalProperties": { + "$ref": "HealthChecksScopedList", + "description": "Name of the scope containing this set of HealthChecks." }, - "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." + "description": "A list of HealthChecksScopedList resources.", + "type": "object" }, - "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, + "kind": { + "default": "compute#healthChecksAggregatedList", + "description": "Output only. Type of resource.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "unreachables": { + "description": "Output only. [Output Only] Unreachable resources.", + "items": { + "type": "string" + }, + "readOnly": true, + "type": "array" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "region": { - "description": "Name of the region scoping this request.", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project", - "region", - "instanceGroup" - ], - "response": { - "$ref": "InstanceGroup" + "type": "object" + } + }, + "type": "object" + }, + "HealthChecksScopedList": { + "id": "HealthChecksScopedList", + "properties": { + "healthChecks": { + "description": "A list of HealthChecks contained in this scope.", + "items": { + "$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 instance group resource." + "type": "array" }, - "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", + "warning": { + "description": "Informational warning which replaces the list of\nbackend services when the list is empty.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "region": { - "description": "Name of the region scoping this request.", - "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" } }, - "parameterOrder": [ - "project", - "region", - "instanceGroup" + "type": "object" + } + }, + "type": "object" + }, + "HealthSource": { + "description": "Represents a health source.\n\nA health source resource specifies the source resources and the health\naggregation policy applied to the source resources to determine the\naggregated health status.", + "id": "HealthSource", + "properties": { + "creationTimestamp": { + "description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you\ncreate the resource.", + "type": "string" + }, + "fingerprint": { + "description": "Fingerprint of this resource. A hash of the contents stored in this object.\nThis field is used in optimistic locking. This field will be ignored when\ninserting a HealthSource. An up-to-date fingerprint\nmust be provided in order to patch the HealthSource; Otherwise, the request\nwill fail with error 412 conditionNotMet. To see the latest\nfingerprint, make a get() request to retrieve the\nHealthSource.", + "format": "byte", + "type": "string" + }, + "healthAggregationPolicy": { + "description": "URL to the HealthAggregationPolicy resource. Must be set. Must\nbe regional and in the same region as the HealthSource. Can be\nmutated.", + "type": "string" + }, + "id": { + "description": "Output only. [Output Only] A unique identifier for this resource type. The server\ngenerates this identifier.", + "format": "uint64", + "readOnly": true, + "type": "string" + }, + "kind": { + "default": "compute#healthSource", + "description": "Output only. [Output Only] Type of the resource. Alwayscompute#healthSource for health sources.", + "readOnly": true, + "type": "string" + }, + "name": { + "description": "Name of the resource. Provided by the client when the resource is created.\nThe name must be 1-63 characters long, and comply withRFC1035.\nSpecifically, the name must be 1-63 characters long and match the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first\ncharacter must be a lowercase letter, and all following characters must\nbe a dash, lowercase letter, or digit, except the last character, which\ncannot be a dash.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "region": { + "description": "Output only. [Output Only] URL of the region where the health source resides.\nThis field applies only to the regional resource. You must specify this\nfield as part of the HTTP request URL. It is not settable as a field in\nthe request body.", + "readOnly": true, + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for the resource.", + "readOnly": true, + "type": "string" + }, + "selfLinkWithId": { + "description": "Output only. [Output Only] Server-defined URL with id for the resource.", + "readOnly": true, + "type": "string" + }, + "sourceType": { + "description": "Specifies the type of the HealthSource. The only allowed value\nis BACKEND_SERVICE. Must be specified when theHealthSource is created, and cannot be mutated.", + "enum": [ + "BACKEND_SERVICE" ], - "request": { - "$ref": "RegionInstanceGroupsListInstancesRequest" + "enumDescriptions": [ + "" + ], + "type": "string" + }, + "sources": { + "description": "URLs to the source resources. Must be size 1. Must be aBackendService if\nthe sourceType is BACKEND_SERVICE. TheBackendService must have load balancing schemeINTERNAL or INTERNAL_MANAGED and must be regional\nand in the same region as the HealthSource (cross-region\ndeployment for INTERNAL_MANAGED is not supported). TheBackendService may use only IGs, MIGs, or NEGs of typeGCE_VM_IP or GCE_VM_IP_PORT. TheBackendService may not use haPolicy. Can be\nmutated.", + "items": { + "type": "string" }, - "response": { - "$ref": "RegionInstanceGroupsListInstances" + "type": "array" + } + }, + "type": "object" + }, + "HealthSourceAggregatedList": { + "description": "Contains a list of HealthSourcesScopedList.", + "id": "HealthSourceAggregatedList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "additionalProperties": { + "$ref": "HealthSourcesScopedList", + "description": "Name of the scope containing this set of HealthSources." }, - "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." + "description": "A list of HealthSourcesScopedList resources.", + "type": "object" }, - "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, + "kind": { + "default": "compute#healthSourceAggregatedList", + "description": "Output only. Type of resource.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "unreachables": { + "description": "Output only. [Output Only] Unreachable resources.", + "items": { + "type": "string" + }, + "readOnly": true, + "type": "array" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. 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" } }, - "parameterOrder": [ - "project", - "region", - "instanceGroup" + "type": "object" + } + }, + "type": "object" + }, + "HealthSourceHealth": { + "description": "Response message for RegionHealthSources.GetHealth", + "id": "HealthSourceHealth", + "properties": { + "healthState": { + "description": "Health state of the HealthSource.", + "enum": [ + "HEALTHY", + "UNHEALTHY", + "UNKNOWN" ], - "request": { - "$ref": "RegionInstanceGroupsSetNamedPortsRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "", + "", + "" ], - "description": "Sets the named ports for the specified regional instance group." + "type": "string" + }, + "kind": { + "default": "compute#healthSourceHealth", + "description": "Output only. [Output Only] Type of resource. Alwayscompute#healthSourceHealth for the health of health sources.", + "readOnly": true, + "type": "string" + }, + "sources": { + "description": "Health state details of the sources.", + "items": { + "$ref": "HealthSourcesGetHealthResponseSourceInfo" + }, + "type": "array" } - } + }, + "type": "object" }, - "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, + "HealthSourceList": { + "id": "HealthSourceList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of HealthSource resources.", + "items": { + "$ref": "HealthSource" + }, + "type": "array" + }, + "kind": { + "default": "compute#healthSourceList", + "description": "Output only. [Output Only] Type of the resource. Alwayscompute#healthSource for health sources.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue 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.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "zone": { - "description": "The name of the zone where the managed instance group is located.", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project", - "zone" - ], - "response": { - "$ref": "InstanceGroupManagerList" + "type": "object" + } + }, + "type": "object" + }, + "HealthSourcesGetHealthResponseSourceInfo": { + "id": "HealthSourcesGetHealthResponseSourceInfo", + "properties": { + "backends": { + "description": "Represents an instance group or network endpoint group behind the source\nbackend service. Only used if the sourceType of the regionHealthSource\nis BACKEND_SERVICE.", + "items": { + "$ref": "HealthSourcesGetHealthResponseSourceInfoBackendInfo" }, - "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." + "type": "array" }, - "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", + "forwardingRule": { + "description": "Fully qualified URL of the forwarding rule associated with the source\nresource if it is a L4ILB backend service.", + "type": "string" + }, + "source": { + "description": "Fully qualified URL of the associated source resource. This is always a\nbackend service URL.", + "type": "string" + } + }, + "type": "object" + }, + "HealthSourcesGetHealthResponseSourceInfoBackendInfo": { + "id": "HealthSourcesGetHealthResponseSourceInfoBackendInfo", + "properties": { + "endpointCount": { + "description": "Total number of endpoints when determining the health of the\nregionHealthSource.", + "format": "int32", + "type": "integer" + }, + "group": { + "description": "Fully qualified URL of an instance group or network endpoint group\nbehind the source backend service.", + "type": "string" + }, + "healthyEndpointCount": { + "description": "Number of endpoints considered healthy when determining health of the\nregionHealthSource.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, + "HealthSourcesScopedList": { + "id": "HealthSourcesScopedList", + "properties": { + "healthSources": { + "description": "A list of HealthSources contained in this scope.", + "items": { + "$ref": "HealthSource" + }, + "type": "array" + }, + "warning": { + "description": "Informational warning which replaces the list of\nhealth sources when the list is empty.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "pageToken": { - "description": "Specifies a page token 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{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" } }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "InstanceGroupManagerAggregatedList" + "type": "object" + } + }, + "type": "object" + }, + "HealthStatus": { + "id": "HealthStatus", + "properties": { + "annotations": { + "additionalProperties": { + "type": "string" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "description": "Metadata defined as annotations for network endpoint.", + "type": "object" + }, + "forwardingRule": { + "description": "URL of the forwarding rule associated with the health status of the\ninstance.", + "type": "string" + }, + "forwardingRuleIp": { + "description": "A forwarding rule IP address assigned to this instance.", + "type": "string" + }, + "healthState": { + "description": "Health state of the IPv4 address of the instance.", + "enum": [ + "HEALTHY", + "UNHEALTHY" + ], + "enumDescriptions": [ + "", + "" ], - "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`." + "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" + "instance": { + "description": "URL of the instance resource.", + "type": "string" + }, + "ipAddress": { + "description": "For target pool based Network Load Balancing, it indicates the forwarding\nrule's IP address assigned to this instance. For other types of load\nbalancing, the field indicates VM internal ip.", + "type": "string" + }, + "ipv6Address": { + "type": "string" + }, + "ipv6HealthState": { + "description": "Health state of the IPv6 address of the instance.", + "enum": [ + "HEALTHY", + "UNHEALTHY" ], - "response": { - "$ref": "InstanceGroupManager" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "", + "" ], - "description": "Returns all of the details about the specified managed instance group." + "type": "string" }, - "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" + "port": { + "description": "The named port of the instance group, not necessarily the port that is\nhealth-checked.", + "format": "int32", + "type": "integer" + }, + "weight": { + "type": "string" + }, + "weightError": { + "enum": [ + "INVALID_WEIGHT", + "MISSING_WEIGHT", + "UNAVAILABLE_WEIGHT", + "WEIGHT_NONE" ], - "request": { - "$ref": "InstanceGroupManager" + "enumDescriptions": [ + "The response to a Health Check probe had the HTTP response header field\nX-Load-Balancing-Endpoint-Weight, but its content was invalid (i.e., not\na non-negative single-precision floating-point number in decimal string\nrepresentation).", + "The response to a Health Check probe did not have the HTTP response\nheader field X-Load-Balancing-Endpoint-Weight.", + "This is the value when the accompanied health status is either TIMEOUT\n(i.e.,the Health Check probe was not able to get a response in time) or\nUNKNOWN. For the latter, it should be typically because there has not\nbeen sufficient time to parse and report the weight for a new backend\n(which is with 0.0.0.0 ip address). However, it can be also due to an\noutage case for which the health status is explicitly reset to UNKNOWN.", + "This is the default value when WeightReportMode is DISABLE,\nand is also the initial value when WeightReportMode has just updated to\nENABLE or DRY_RUN and there has not been\nsufficient time to parse and report the backend weight." + ], + "type": "string" + } + }, + "type": "object" + }, + "HealthStatusForNetworkEndpoint": { + "id": "HealthStatusForNetworkEndpoint", + "properties": { + "backendService": { + "$ref": "BackendServiceReference", + "description": "URL of the backend service associated with the health state of the network\nendpoint." + }, + "forwardingRule": { + "$ref": "ForwardingRuleReference", + "description": "URL of the forwarding rule associated with the health state of the network\nendpoint." + }, + "healthCheck": { + "$ref": "HealthCheckReference", + "description": "URL of the health check associated with the health state of the network\nendpoint." + }, + "healthCheckService": { + "$ref": "HealthCheckServiceReference", + "description": "URL of the health check service associated with the health state of the\nnetwork endpoint." + }, + "healthState": { + "description": "Health state of the network endpoint determined based on the health checks\nconfigured.", + "enum": [ + "DRAINING", + "HEALTHY", + "UNHEALTHY", + "UNKNOWN" + ], + "enumDescriptions": [ + "Endpoint is being drained.", + "Endpoint is healthy.", + "Endpoint is unhealthy.", + "Health status of the endpoint is unknown." + ], + "type": "string" + }, + "ipv6HealthState": { + "description": "Health state of the ipv6 network endpoint determined based on the health\nchecks configured.", + "enum": [ + "DRAINING", + "HEALTHY", + "UNHEALTHY", + "UNKNOWN" + ], + "enumDescriptions": [ + "Endpoint is being drained.", + "Endpoint is healthy.", + "Endpoint is unhealthy.", + "Health status of the endpoint is unknown." + ], + "type": "string" + } + }, + "type": "object" + }, + "Help": { + "description": "Provides links to documentation or for performing an out of band action.\n\nFor example, if a quota check failed with an error indicating the calling\nproject hasn't enabled the accessed service, this can contain a URL pointing\ndirectly to the right place in the developer console to flip the bit.", + "id": "Help", + "properties": { + "links": { + "description": "URL(s) pointing to additional information on handling the current error.", + "items": { + "$ref": "HelpLink" }, - "response": { - "$ref": "Operation" + "type": "array" + } + }, + "type": "object" + }, + "HelpLink": { + "description": "Describes a URL link.", + "id": "HelpLink", + "properties": { + "description": { + "description": "Describes what the link offers.", + "type": "string" + }, + "url": { + "description": "The URL of the link.", + "type": "string" + } + }, + "type": "object" + }, + "Host": { + "description": "Represents a host resource.", + "id": "Host", + "properties": { + "aliasLinks": { + "description": "Output only. All aliases for this resource.\ne.g.\nprojects/123/zones/us-centra1-a/reservation/r1/reservationBlock/b1/hosts/h1", + "items": { + "type": "string" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "readOnly": true, + "type": "array" + }, + "creationTimestamp": { + "description": "Output only. The creation timestamp, formatted asRFC3339 text.", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "An optional description of this resource.", + "type": "string" + }, + "id": { + "description": "Output only. The unique identifier for this resource. This identifier is\ndefined by the server.", + "format": "uint64", + "readOnly": true, + "type": "string" + }, + "kind": { + "default": "compute#host", + "description": "Output only. The type of resource. Alwayscompute#host for hosts.", + "readOnly": true, + "type": "string" + }, + "name": { + "description": "Output only. The name of the host.", + "readOnly": true, + "type": "string" + }, + "selfLink": { + "description": "Output only. The self link of the host.", + "readOnly": true, + "type": "string" + }, + "selfLinkWithId": { + "description": "Output only. The self link with id of the host.", + "readOnly": true, + "type": "string" + }, + "state": { + "description": "Output only. The state of the host.", + "enum": [ + "ACTIVE", + "CREATING", + "DELETING", + "STATE_UNSPECIFIED", + "UNAVAILABLE" + ], + "enumDescriptions": [ + "The host has allocated all its resources.", + "The resources are being allocated for the host.", + "The host is currently being deleted.", + "", + "The host is currently unavailable." ], - "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." + "readOnly": true, + "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" - } + "status": { + "$ref": "HostStatus", + "description": "Output only. The status of the host", + "readOnly": true + }, + "zone": { + "description": "Output only. The zone in which the host resides.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "HostPhysicalTopology": { + "id": "HostPhysicalTopology", + "properties": { + "block": { + "description": "The unique identifier of the capacity block within the cluster.", + "type": "string" + }, + "cluster": { + "description": "The cluster name of the reservation sub-block.", + "type": "string" + }, + "host": { + "description": "The unique identifier of the capacity host within the capacity sub-block.", + "type": "string" + }, + "subBlock": { + "description": "The unique identifier of the capacity sub-block within the capacity\nblock.", + "type": "string" + } + }, + "type": "object" + }, + "HostRule": { + "description": "UrlMaps\nA host-matching rule for a URL. If matched, will use the namedPathMatcher to select the BackendService.", + "id": "HostRule", + "properties": { + "description": { + "description": "An optional description of this resource. Provide this property when you\ncreate the resource.", + "type": "string" + }, + "hosts": { + "description": "The list of host patterns to match. They must be valid hostnames with\noptional port numbers in the format host:port.* matches any string of ([a-z0-9-.]*). In\nthat case, * must be the first character, and if followed by\nanything, the immediate following character must be either -\nor ..\n\n* based matching is not supported when the URL map is bound\nto a target gRPC proxy that has the validateForProxyless field\nset to true.", + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "zone", - "instanceGroupManager" - ], - "request": { - "$ref": "InstanceGroupManager" + "type": "array" + }, + "pathMatcher": { + "description": "The name of the PathMatcher to use to match the path portion\nof the URL if the hostRule matches the URL's host portion.", + "type": "string" + } + }, + "type": "object" + }, + "HostStatus": { + "id": "HostStatus", + "properties": { + "physicalTopology": { + "$ref": "HostPhysicalTopology", + "description": "Output only. The physical topology of the reservation sub-block, if\npresent", + "readOnly": true + }, + "runningInstances": { + "description": "Output only. The URIs of the instances currently running on this host.", + "items": { + "type": "string" }, - "response": { - "$ref": "Operation" + "readOnly": true, + "type": "array" + } + }, + "type": "object" + }, + "HostsGetVersionRequest": { + "id": "HostsGetVersionRequest", + "properties": { + "sbomSelections": { + "description": "The SBOM selection to return. Duplicate values in the list will be ignored.", + "items": { + "enum": [ + "SBOM_SELECTION_CURRENT", + "SBOM_SELECTION_TARGET", + "SBOM_SELECTION_UNSPECIFIED" + ], + "enumDescriptions": [ + "", + "", + "" + ], + "type": "string" }, - "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." + "type": "array" + } + }, + "type": "object" + }, + "HostsListResponse": { + "id": "HostsListResponse", + "properties": { + "etag": { + "type": "string" }, - "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" - } + "id": { + "description": "The unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of host resources.", + "items": { + "$ref": "Host" }, - "parameterOrder": [ - "project", - "zone", - "instanceGroupManager" - ], - "response": { - "$ref": "Operation" + "type": "array" + }, + "kind": { + "default": "compute#hostList", + "description": "The type of resource. Always compute#host for a list of hosts.", + "type": "string" + }, + "nextPageToken": { + "description": "This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "The server-defined URL for this resource.", + "type": "string" + }, + "unreachables": { + "description": "Unreachable resources.\nend_interface: MixerListResponseWithEtagBuilder", + "items": { + "type": "string" }, - "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." + "type": "array" }, - "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, + "warning": { + "description": "An informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "zone": { - "description": "The name of the zone where the managed instance group is located.", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project", - "zone", - "instanceGroupManager" - ], - "request": { - "$ref": "InstanceGroupManagersDeleteInstancesRequest" + "type": "object" + } + }, + "type": "object" + }, + "HttpFaultAbort": { + "description": "Specification for how requests are aborted as part of fault injection.", + "id": "HttpFaultAbort", + "properties": { + "httpStatus": { + "description": "The HTTP status code used to abort the request.\n\nThe value must be from 200 to 599 inclusive.\n\nFor gRPC protocol, the gRPC status code is mapped to HTTP status code\naccording to this \nmapping table. HTTP status 200 is mapped to gRPC status\nUNKNOWN. Injecting an OK status is currently not supported by\nTraffic Director.", + "format": "uint32", + "type": "integer" + }, + "percentage": { + "description": "The percentage of traffic for connections, operations, or requests\nthat is aborted as part of fault injection.\n\nThe value must be from 0.0 to 100.0 inclusive.", + "format": "double", + "type": "number" + } + }, + "type": "object" + }, + "HttpFaultDelay": { + "description": "Specifies the delay introduced by the load balancer before forwarding the\nrequest to the backend service as part of fault injection.", + "id": "HttpFaultDelay", + "properties": { + "fixedDelay": { + "$ref": "Duration", + "description": "Specifies the value of the fixed delay interval." + }, + "percentage": { + "description": "The percentage of traffic for connections, operations, or requests for\nwhich a delay is introduced as part of fault injection.\n\nThe value must be from 0.0 to 100.0 inclusive.", + "format": "double", + "type": "number" + } + }, + "type": "object" + }, + "HttpFaultInjection": { + "description": "The specification for fault injection introduced into traffic to test\nthe resiliency of clients to backend service failure. As part of fault\ninjection, when clients send requests to a backend service, delays can be\nintroduced by the load balancer on a percentage of requests before sending\nthose request to the backend service. Similarly requests from clients can be\naborted by the load balancer for a percentage of requests.", + "id": "HttpFaultInjection", + "properties": { + "abort": { + "$ref": "HttpFaultAbort", + "description": "The specification for how client requests are aborted as part of fault\ninjection." + }, + "delay": { + "$ref": "HttpFaultDelay", + "description": "The specification for how client requests are delayed as part of fault\ninjection, before being sent to a backend service." + } + }, + "type": "object" + }, + "HttpHeaderAction": { + "description": "The request and response header transformations that take effect before\nthe request is passed along to the selected backendService.", + "id": "HttpHeaderAction", + "properties": { + "requestHeadersToAdd": { + "description": "Headers to add to a matching request before forwarding the request to thebackendService.", + "items": { + "$ref": "HttpHeaderOption" }, - "response": { - "$ref": "Operation" + "type": "array" + }, + "requestHeadersToRemove": { + "description": "A list of header names for headers that need to be removed from the\nrequest before forwarding the request to the backendService.", + "items": { + "type": "string" }, - "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." + "type": "array" }, - "suspendInstances": { - "id": "compute.instanceGroupManagers.suspendInstances", - "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/suspendInstances", - "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/suspendInstances", - "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" - } + "responseHeadersToAdd": { + "description": "Headers to add the response before sending the response back to the\nclient.", + "items": { + "$ref": "HttpHeaderOption" }, - "parameterOrder": [ - "project", - "zone", - "instanceGroupManager" - ], - "request": { - "$ref": "InstanceGroupManagersSuspendInstancesRequest" + "type": "array" + }, + "responseHeadersToRemove": { + "description": "A list of header names for headers that need to be removed from the\nresponse before sending the response back to the client.", + "items": { + "type": "string" }, - "response": { - "$ref": "Operation" + "type": "array" + } + }, + "type": "object" + }, + "HttpHeaderMatch": { + "description": "matchRule criteria for request header matches.", + "id": "HttpHeaderMatch", + "properties": { + "exactMatch": { + "description": "The value should exactly match contents of exactMatch.\n\nOnly one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.", + "type": "string" + }, + "headerName": { + "description": "The name of the HTTP header to match.\n\nFor matching against the HTTP request's authority, use a headerMatch\nwith the header name \":authority\".\n\nFor matching a request's method, use the headerName \":method\".\n\nWhen the URL map is bound to a target gRPC proxy that has\nthe validateForProxyless field set to true, only\nnon-binary\nuser-specified custom metadata and the `content-type` header are supported.\nThe following transport-level headers cannot be used in header matching\nrules:\n`:authority`, `:method`, `:path`, `:scheme`, `user-agent`,\n`accept-encoding`, `content-encoding`, `grpc-accept-encoding`,\n`grpc-encoding`, `grpc-previous-rpc-attempts`, `grpc-tags-bin`,\n`grpc-timeout` and `grpc-trace-bin`.", + "type": "string" + }, + "invertMatch": { + "description": "If set to false, the headerMatch is considered a\nmatch if the preceding match criteria are met. If set to true,\nthe headerMatch is considered a match if the preceding\nmatch criteria are NOT met.\n\nThe default setting is false.", + "type": "boolean" + }, + "prefixMatch": { + "description": "The value of the header must start with the contents ofprefixMatch.\n\nOnly one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.", + "type": "string" + }, + "presentMatch": { + "description": "A header with the contents of headerName must exist. The\nmatch takes place whether or not the request's header has a value.\n\nOnly one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.", + "type": "boolean" + }, + "rangeMatch": { + "$ref": "Int64RangeMatch", + "description": "The header value must be an integer and its value must be in the range\nspecified in rangeMatch. If the header does not contain an\ninteger, number or is empty, the match fails.\n\nFor example for a range [-5, 0]\n \n \n - -3 will match.\n - 0 will not match.\n - 0.25 will not match.\n - -3someString will not match.\n\nOnly one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.\n\nrangeMatch is not supported for load balancers\nthat have loadBalancingScheme set to EXTERNAL." + }, + "regexMatch": { + "description": "The value of the header must match the regular expression specified inregexMatch.\nFor more information about regular expression syntax, see Syntax.\n\nFor matching against a port specified in the HTTP request, use a\nheaderMatch with headerName set to PORT and a regular expression that\nsatisfies the RFC2616 Host header's port specifier.\n\nOnly one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.\n\nRegular expressions can only be used when the loadBalancingScheme is\nset to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED\n(regional scope) or INTERNAL_MANAGED.", + "type": "string" + }, + "suffixMatch": { + "description": "The value of the header must end with the contents ofsuffixMatch.\n\nOnly one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.", + "type": "string" + } + }, + "type": "object" + }, + "HttpHeaderOption": { + "description": "Specification determining how headers are added to requests or responses.", + "id": "HttpHeaderOption", + "properties": { + "headerName": { + "description": "The name of the header.", + "type": "string" + }, + "headerValue": { + "description": "The value of the header to add.", + "type": "string" + }, + "replace": { + "description": "If false, headerValue is appended to any values\nthat already\nexist for the header. If true, headerValue is set for the\nheader, discarding any values that were set for that header.\n\nThe default value is true,\nunless a variable is present in headerValue,\nin which case the default value is false.\n.", + "type": "boolean" + } + }, + "type": "object" + }, + "HttpHealthCheck": { + "description": "Represents a legacy HTTP Health Check resource.\n\nLegacy HTTP health checks are now only required by target pool-based network\nload balancers. For all other load balancers, including backend service-based\nnetwork load balancers, and for managed instance group auto-healing, you must\nuse modern (non-legacy) health checks.\n\nFor more information, seeHealth checks\noverview.", + "id": "HttpHealthCheck", + "properties": { + "checkIntervalSec": { + "description": "How often (in seconds) to send a health check. The default value is5 seconds.", + "format": "int32", + "type": "integer" + }, + "creationTimestamp": { + "description": "[Output Only] Creation timestamp inRFC3339\ntext format.", + "type": "string" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you\ncreate the resource.", + "type": "string" + }, + "healthyThreshold": { + "description": "A so-far unhealthy instance will be marked healthy after this\nmany consecutive successes. The default value is 2.", + "format": "int32", + "type": "integer" + }, + "host": { + "description": "The value of the host header in the HTTP health check request. If left\nempty (default value), the public IP on behalf of which this health check\nis performed will be used.", + "type": "string" + }, + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "format": "uint64", + "type": "string" + }, + "kind": { + "default": "compute#httpHealthCheck", + "description": "Output only. [Output Only] Type of the resource. Alwayscompute#httpHealthCheck for HTTP health checks.", + "readOnly": true, + "type": "string" + }, + "name": { + "description": "Name of the resource. Provided by the client when the resource is created.\nThe name must be 1-63 characters long, and comply withRFC1035.\nSpecifically, the name must be 1-63 characters long and match the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first\ncharacter must be a lowercase letter, and all following characters must\nbe a dash, lowercase letter, or digit, except the last character, which\ncannot be a dash.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "port": { + "description": "The TCP port number for the HTTP health check request. The default value is80.", + "format": "int32", + "type": "integer" + }, + "requestPath": { + "description": "The request path of the HTTP health check request. The default value is/. This field does not support query\nparameters. Must comply withRFC3986.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" + }, + "timeoutSec": { + "description": "How long (in seconds) to wait before claiming failure. The default value is5 seconds. It is invalid for timeoutSec to have\ngreater value than checkIntervalSec.", + "format": "int32", + "type": "integer" + }, + "unhealthyThreshold": { + "description": "A so-far healthy instance will be marked unhealthy after this\nmany consecutive failures. The default value is 2.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, + "HttpHealthCheckList": { + "description": "Contains a list of HttpHealthCheck resources.", + "id": "HttpHealthCheckList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of HttpHealthCheck resources.", + "items": { + "$ref": "HttpHealthCheck" }, - "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 suspended. You can only specify instances that are running in this request. This method reduces the targetSize and increases the targetSuspendedSize of the managed instance group by the number of instances that you suspend. The suspendInstances operation is marked DONE if the suspendInstances request is successful. The underlying actions take additional time. You must separately verify the status of the SUSPENDING action with the listmanagedinstances method. If the standbyPolicy.initialDelaySec field is set, the group delays suspension of the instances until initialDelaySec have passed from instance.creationTimestamp (that is, when the instance was created). This delay gives your application time to set itself up and initialize on the instance. If more than initialDelaySec seconds have passed since instance.creationTimestamp when this method is called, there will be zero delay. 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 suspended. Suspended instances can be resumed using the resumeInstances method. You can specify a maximum of 1000 instances with this method per request." + "type": "array" }, - "resumeInstances": { - "id": "compute.instanceGroupManagers.resumeInstances", - "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/resumeInstances", - "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/resumeInstances", - "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, + "kind": { + "default": "compute#httpHealthCheckList", + "description": "Output only. Type of resource.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "zone": { - "description": "The name of the zone where the managed instance group is located.", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project", - "zone", - "instanceGroupManager" - ], - "request": { - "$ref": "InstanceGroupManagersResumeInstancesRequest" - }, - "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 resumed. This method increases the targetSize and decreases the targetSuspendedSize of the managed instance group by the number of instances that you resume. The resumeInstances operation is marked DONE if the resumeInstances request is successful. The underlying actions take additional time. You must separately verify the status of the RESUMING action with the listmanagedinstances method. In this request, you can only specify instances that are suspended. For example, if an instance was previously suspended using the suspendInstances method, it can be resumed using the resumeInstances method. If a health check is attached to the managed instance group, the specified instances will be verified as healthy after they are resumed. You can specify a maximum of 1000 instances with this method per request." + "type": "object" + } + }, + "type": "object" + }, + "HttpQueryParameterMatch": { + "description": "HttpRouteRuleMatch criteria for a request's query parameter.", + "id": "HttpQueryParameterMatch", + "properties": { + "exactMatch": { + "description": "The queryParameterMatch matches if the value of the\nparameter exactly matches the contents of exactMatch.\n\nOnly one of presentMatch, exactMatch, orregexMatch must be set.", + "type": "string" }, - "stopInstances": { - "id": "compute.instanceGroupManagers.stopInstances", - "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/stopInstances", - "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/stopInstances", - "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" + "name": { + "description": "The name of the query parameter to match. The query parameter must exist in\nthe request, in the absence of which the request match fails.", + "type": "string" + }, + "presentMatch": { + "description": "Specifies that the queryParameterMatch matches if the\nrequest contains the query parameter, irrespective of whether the\nparameter has a value or not.\n\nOnly one of presentMatch, exactMatch, orregexMatch must be set.", + "type": "boolean" + }, + "regexMatch": { + "description": "The queryParameterMatch matches if the value of the\nparameter matches the regular expression specified byregexMatch. For\nmore information about regular expression syntax, see Syntax.\n\nOnly one of presentMatch, exactMatch, orregexMatch must be set.\n\nRegular expressions can only be used when the loadBalancingScheme is\nset to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED\n(regional scope) or INTERNAL_MANAGED.", + "type": "string" + } + }, + "type": "object" + }, + "HttpRedirectAction": { + "description": "Specifies settings for an HTTP redirect.", + "id": "HttpRedirectAction", + "properties": { + "hostRedirect": { + "description": "The host that is used in the redirect response instead of the one that\nwas supplied in the request.\n\nThe value must be from 1 to 255\ncharacters.", + "type": "string" + }, + "httpsRedirect": { + "description": "If set to true, the URL scheme in the redirected request is\nset to HTTPS.\nIf set to false, the URL scheme of the redirected request\nremains the same as that of the request.\n\nThis must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.\n\nThe default is set to false.", + "type": "boolean" + }, + "pathRedirect": { + "description": "The path that is used in the redirect response instead of the one\nthat was supplied in the request.\n\npathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is\nsupplied, the path of the original request is used for the redirect.\n\nThe value must be from 1 to 1024 characters.", + "type": "string" + }, + "prefixRedirect": { + "description": "The prefix that replaces the prefixMatch specified in\nthe HttpRouteRuleMatch, retaining the remaining portion\nof the URL before redirecting the request.\n\nprefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is\nsupplied, the path of the original request is used for the redirect.\n\nThe value must be from 1 to 1024 characters.", + "type": "string" + }, + "redirectResponseCode": { + "description": "The HTTP Status code to use for this RedirectAction.\n\nSupported values are:\n \n - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds\n to 301.\n - FOUND, which corresponds to 302.\n - SEE_OTHER which corresponds to 303.\n - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request\n method is retained.\n - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request\n method is retained.", + "enum": [ + "FOUND", + "MOVED_PERMANENTLY_DEFAULT", + "PERMANENT_REDIRECT", + "SEE_OTHER", + "TEMPORARY_REDIRECT" ], - "request": { - "$ref": "InstanceGroupManagersStopInstancesRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "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": "Flags the specified instances in the managed instance group to be immediately stopped. You can only specify instances that are running in this request. This method reduces the targetSize and increases the targetStoppedSize of the managed instance group by the number of instances that you stop. The stopInstances operation is marked DONE if the stopInstances request is successful. The underlying actions take additional time. You must separately verify the status of the STOPPING action with the listmanagedinstances method. If the standbyPolicy.initialDelaySec field is set, the group delays stopping the instances until initialDelaySec have passed from instance.creationTimestamp (that is, when the instance was created). This delay gives your application time to set itself up and initialize on the instance. If more than initialDelaySec seconds have passed since instance.creationTimestamp when this method is called, there will be zero delay. 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 stopped. Stopped instances can be started using the startInstances method. You can specify a maximum of 1000 instances with this method per request." + "type": "string" }, - "startInstances": { - "id": "compute.instanceGroupManagers.startInstances", - "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/startInstances", - "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/startInstances", - "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": "InstanceGroupManagersStartInstancesRequest" - }, - "response": { - "$ref": "Operation" + "stripQuery": { + "description": "If set to true, any accompanying query portion of the original\nURL is\nremoved before redirecting the request. If set to false, the\nquery portion of the original URL is retained.\n\nThe default is set to false.", + "type": "boolean" + } + }, + "type": "object" + }, + "HttpRetryPolicy": { + "description": "The retry policy associates with HttpRouteRule", + "id": "HttpRetryPolicy", + "properties": { + "numRetries": { + "description": "Specifies the allowed number retries. This number must be > 0.\nIf not specified, defaults to 1.", + "format": "uint32", + "type": "integer" + }, + "perTryTimeout": { + "$ref": "Duration", + "description": "Specifies a non-zero timeout per retry attempt.\n\nIf not specified, will use the timeout set in theHttpRouteAction field.\nIf timeout in the HttpRouteAction field is not set, this field\nuses the largest timeout\namong all backend services associated with the route.\n\nNot supported when the URL map is bound to a target gRPC proxy that\nhas the validateForProxyless field set to true." + }, + "retryConditions": { + "description": "Specifies one or more conditions when this retry policy applies. Valid\nvalues are:\n \n - 5xx: retry is attempted if the instance or endpoint\n responds with any 5xx response code, or if the instance or\n endpoint does not respond at all. For example, disconnects, reset, read\n timeout, connection failure, and refused streams.\n - gateway-error: Similar to 5xx, but only\n applies to response codes 502, 503 or504.\n - connect-failure: a retry is attempted on failures\n connecting to the instance or endpoint. For example, connection\n timeouts.\n - retriable-4xx: a retry is attempted if the instance\n or endpoint responds with a 4xx response code.\n The only error that you can retry is error code 409.\n - refused-stream: a retry is attempted if the instance\n or endpoint resets the stream with a REFUSED_STREAM error\n code. This reset type indicates that it is safe to retry.\n - cancelled: a retry is attempted if the gRPC status\n code in the response header is set to cancelled.\n - deadline-exceeded: a retry is attempted if the gRPC\n status code in the response header is set todeadline-exceeded.\n - internal: a retry is attempted if the gRPC\n status code in the response header is set tointernal.\n - resource-exhausted: a retry is attempted if the gRPC\n status code in the response header is set toresource-exhausted.\n - unavailable: a retry is attempted if the gRPC\n status code in the response header is set tounavailable.\n\nOnly the following codes are supported when the URL map is bound to\ntarget gRPC proxy that has validateForProxyless field set to true.\n \n - cancelled\n - deadline-exceeded\n - internal\n - resource-exhausted\n - unavailable", + "items": { + "type": "string" }, - "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 started. This method increases the targetSize and decreases the targetStoppedSize of the managed instance group by the number of instances that you start. The startInstances operation is marked DONE if the startInstances request is successful. The underlying actions take additional time. You must separately verify the status of the STARTING action with the listmanagedinstances method. In this request, you can only specify instances that are stopped. For example, if an instance was previously stopped using the stopInstances method, it can be started using the startInstances method. If a health check is attached to the managed instance group, the specified instances will be verified as healthy after they are started. You can specify a maximum of 1000 instances with this method per request." + "type": "array" + } + }, + "type": "object" + }, + "HttpRouteAction": { + "id": "HttpRouteAction", + "properties": { + "cachePolicy": { + "$ref": "CachePolicy", + "description": "Specifies the cache policy configuration for matched traffic. Available\nonly for Global `EXTERNAL_MANAGED` load balancer schemes. At least one\nproperty must be specified. This policy cannot be specified if any target\nbackend has Identity-Aware Proxy enabled." }, - "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" - } + "corsPolicy": { + "$ref": "CorsPolicy", + "description": "The specification for allowing client-side cross-origin requests. For more\ninformation about the W3C recommendation for cross-origin resource sharing\n(CORS), see Fetch API Living\nStandard.\n\nNot supported when the URL map is bound to a target gRPC proxy." + }, + "faultInjectionPolicy": { + "$ref": "HttpFaultInjection", + "description": "The specification for fault injection introduced into traffic to test\nthe resiliency of clients to backend service failure. As part of fault\ninjection, when clients send requests to a backend service, delays can be\nintroduced by a load balancer on a percentage of requests before sending\nthose requests to the backend service. Similarly requests from clients can\nbe aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients\nthat are configured with a fault_injection_policy if:\n1. The traffic is generated by fault injection AND\n2. The fault injection is not a delay fault injection.\nFault injection is not supported with the classic Application Load Balancer\n. To see which load balancers support fault injection,\nsee Load\nbalancing: Routing and traffic management features." + }, + "maxStreamDuration": { + "$ref": "Duration", + "description": "Specifies the maximum duration (timeout) for streams on the selected route.\nUnlike the timeout field where the timeout duration starts\nfrom the time the request has been fully processed (known as*end-of-stream*),\nthe duration in this field is computed from the beginning of the stream\nuntil the response has been processed, including all retries. A\nstream that does not complete in this duration is closed.\n\nIf not specified, this field uses the maximummaxStreamDuration value among all backend services associated\nwith the route.\n\nThis field is only allowed if the Url map is used with backend services\nwith loadBalancingScheme set toINTERNAL_SELF_MANAGED." + }, + "requestMirrorPolicy": { + "$ref": "RequestMirrorPolicy", + "description": "Specifies the policy on how requests intended for the route's backends\nare shadowed to a separate mirrored backend service. The load balancer does\nnot wait for responses from the shadow service. Before sending traffic\nto the shadow service, the host / authority header is suffixed with-shadow.\n\nNot supported when the URL map is bound to a target gRPC proxy that\nhas the validateForProxyless field set to true." + }, + "retryPolicy": { + "$ref": "HttpRetryPolicy", + "description": "Specifies the retry policy associated with this route." + }, + "timeout": { + "$ref": "Duration", + "description": "Specifies the timeout for the selected route. Timeout is computed from the\ntime the request has been fully processed (known as *end-of-stream*)\nup until the response has been processed. Timeout includes\nall retries.\n\nIf not specified, this field uses the largest timeout among all backend\nservices associated with the route.\n\nNot supported when the URL map is bound to a target gRPC proxy that\nhas validateForProxyless field set to true." + }, + "urlRewrite": { + "$ref": "UrlRewrite", + "description": "The spec to modify the URL of the request, before forwarding the request\nto the matched service.\n\n urlRewrite is the only action supported in UrlMaps\nfor classic Application Load Balancers.\n\nNot supported when the URL map is bound to a target gRPC proxy that\nhas the validateForProxyless field set to true." + }, + "weightedBackendServices": { + "description": "A list of weighted backend services to send traffic to when a route match\noccurs. The weights determine the fraction of traffic that flows to\ntheir corresponding backend service. If all traffic needs to\ngo to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.\n\nAfter a backend service is identified and before forwarding\nthe request to\nthe backend service, advanced routing actions such as URL rewrites and\nheader transformations are applied depending on additional settings\nspecified in this HttpRouteAction.", + "items": { + "$ref": "WeightedBackendService" }, - "parameterOrder": [ - "project", - "zone", - "instanceGroupManager" - ], - "request": { - "$ref": "InstanceGroupManagersAbandonInstancesRequest" + "type": "array" + } + }, + "type": "object" + }, + "HttpRouteRule": { + "description": "The HttpRouteRule setting specifies how to match an HTTP request\nand the corresponding routing action that load balancing proxies perform.", + "id": "HttpRouteRule", + "properties": { + "customErrorResponsePolicy": { + "$ref": "CustomErrorResponsePolicy", + "description": "customErrorResponsePolicy specifies how the Load\nBalancer returns error responses when BackendServiceorBackendBucket responds with an error. \n\nIf a policy for an\nerror code is not configured for the RouteRule, a policy for\nthe error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If\none is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy\nconfigured in UrlMap.defaultCustomErrorResponsePolicy takes\neffect. \n\nFor example, consider a UrlMap with the following configuration:\n \n \n - UrlMap.defaultCustomErrorResponsePolicy are configured\n with policies for 5xx and 4xx errors\n - A RouteRule for /coming_soon/ is configured for the\n error code 404.\n\nIf the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher's policy\ntakes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,\nthe policy in RouteRule.customErrorResponsePolicy takes\neffect. If any of the requests in this example encounter a 500\nerror code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect. \n\nWhen\nused in conjunction withrouteRules.routeAction.retryPolicy, retries take\nprecedence. Only once all retries are exhausted, thecustomErrorResponsePolicy is applied. While attempting\na retry, if load balancer is successful in reaching the\nservice, the customErrorResponsePolicy is ignored and\nthe response from the service is returned to the client.\n\ncustomErrorResponsePolicy is supported only for\nglobal external Application Load Balancers." + }, + "description": { + "description": "The short description conveying the intent of this routeRule.\n\n\nThe description can have a maximum length of 1024 characters.", + "type": "string" + }, + "headerAction": { + "$ref": "HttpHeaderAction", + "description": "Specifies changes to request and response headers that need to take effect\nfor the selected backendService.\n\nThe headerAction value specified here is applied before the\nmatching pathMatchers[].headerAction and afterpathMatchers[].routeRules[].routeAction.weightedBackendService.backendServiceWeightAction[].headerAction\n\nHeaderAction is not supported for load balancers\nthat have\ntheir loadBalancingScheme set to EXTERNAL.\n\nNot supported when the URL map is bound to a target gRPC proxy that\nhas validateForProxyless field set to true." + }, + "matchRules": { + "description": "The list of criteria for matching attributes of a request to thisrouteRule. This list has OR semantics: the request matches\nthis routeRule when any of thematchRules are satisfied. However predicates within\na given matchRule have AND semantics. All predicates\nwithin a matchRule must match for the request to\nmatch the rule.", + "items": { + "$ref": "HttpRouteRuleMatch" }, - "response": { - "$ref": "Operation" + "type": "array" + }, + "priority": { + "description": "For routeRules within a given pathMatcher,\npriority determines the order in which a load balancer interpretsrouteRules. RouteRules are evaluated in order\nof priority, from the lowest to highest number. The priority of a\nrule decreases as its number increases (1, 2, 3, N+1). The first rule\nthat matches the request is applied.\n\n\nYou cannot configure two or more routeRules with the same priority.\nPriority for each rule must be set to a number from 0 to 2147483647\ninclusive.\n\n\nPriority numbers can have gaps, which enable you to add or remove rules\nin the future without affecting the rest of the rules. For example, 1, 2,\n3, 4, 5, 9, 12, 16 is a valid series of priority numbers to which you\ncould add rules numbered from 6 to 8, 10 to 11, and 13 to 15 in the future\nwithout any impact on existing rules.", + "format": "int32", + "type": "integer" + }, + "routeAction": { + "$ref": "HttpRouteAction", + "description": "In response to a matching matchRule, the load balancer\nperforms advanced routing actions, such as URL rewrites and header\ntransformations, before forwarding the request to the selected backend.\n\n\nOnly one of urlRedirect, service orrouteAction.weightedBackendService can be set.\n\n\nURL maps for classic Application Load Balancers only support\nthe urlRewrite action within a route rule'srouteAction." + }, + "service": { + "description": "The full or partial URL of the backend service resource to which traffic\nis directed if this rule is matched. If routeAction is\nalso specified, advanced routing actions, such as URL rewrites,\ntake effect before sending the request to the backend.\n\n\nOnly one of urlRedirect, service orrouteAction.weightedBackendService can be set.", + "type": "string" + }, + "urlRedirect": { + "$ref": "HttpRedirectAction", + "description": "When this rule is matched, the request is redirected to a URL\nspecified by urlRedirect.\n\n\nOnly one of urlRedirect, service orrouteAction.weightedBackendService can be set.\n\n\nNot supported when the URL map is bound to a target gRPC proxy." + } + }, + "type": "object" + }, + "HttpRouteRuleMatch": { + "description": "HttpRouteRuleMatch specifies a set of criteria for matching\nrequests to an HttpRouteRule. All specified criteria must\nbe satisfied for a match to occur.", + "id": "HttpRouteRuleMatch", + "properties": { + "fullPathMatch": { + "description": "For satisfying the matchRule condition, the path of the\nrequest must exactly match the value specified infullPathMatch after removing any query parameters and anchor\nthat may be part of the original URL.\n\nfullPathMatch must be from 1 to 1024 characters.\n\nOnly one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be\nspecified.", + "type": "string" + }, + "headerMatches": { + "description": "Specifies a list of header match criteria, all of which must match\ncorresponding headers in the request.", + "items": { + "$ref": "HttpHeaderMatch" }, - "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." + "type": "array" }, - "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" - } + "ignoreCase": { + "description": "Specifies that prefixMatch and fullPathMatch\nmatches are case sensitive.\n\nThe default value is false.\n\nignoreCase must not be used with regexMatch.\n\nNot supported when the URL map is bound to a target gRPC proxy.", + "type": "boolean" + }, + "metadataFilters": { + "description": "Opaque filter criteria used by the load balancer to restrict routing\nconfiguration to a limited set of xDS\ncompliant clients. In their xDS requests to the load balancer, xDS clients\npresent node\nmetadata. When there is a match, the relevant routing configuration\nis made available to those proxies.\n\nFor each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least one of thefilterLabels must match the corresponding label provided in\nthe metadata. If its filterMatchCriteria is set to\nMATCH_ALL, then all of its filterLabels must match with\ncorresponding labels provided in the metadata. If multiple\nmetadata filters are specified, all of them need to be\nsatisfied in order to be considered a match.\n\nmetadataFilters specified here is applied after those\nspecified in ForwardingRule that refers to theUrlMap this HttpRouteRuleMatch belongs to.\n\nmetadataFilters only applies to load balancers that haveloadBalancingScheme set toINTERNAL_SELF_MANAGED.\n\nNot supported when the URL map is bound to a target gRPC proxy that\nhas validateForProxyless field set to true.", + "items": { + "$ref": "MetadataFilter" }, - "parameterOrder": [ - "project", - "zone", - "instanceGroupManager" - ], - "request": { - "$ref": "InstanceGroupManagersRecreateInstancesRequest" + "type": "array" + }, + "pathTemplateMatch": { + "description": "If specified, this field defines a path template pattern that must match\nthe :path header after the query string is removed.\n\nA path template pattern can include variables and wildcards.\nVariables are enclosed in curly braces, for example{variable_name}. Wildcards include * that\nmatches a single path segment, and ** that matches zero or\nmore path segments. The pattern must follow these rules:\n\n \n - The value must be between 1 and 1024 characters.\n - The pattern must start with a leading slash (\"/\").\n - No more than 5 operators (variables or wildcards) may appear in\n the pattern.\n\nPrecisely one ofprefixMatch, fullPathMatch,regexMatch, or pathTemplateMatch must be\nset.", + "type": "string" + }, + "prefixMatch": { + "description": "For satisfying the matchRule condition, the request's\npath must begin with the specified prefixMatch.prefixMatch must begin with a /.\n\nThe value must be from 1 to 1024 characters.\n\nThe * character inside a prefix match is\ntreated as a literal character, not as a wildcard.\n\nOnly one of prefixMatch, fullPathMatch,regexMatch or path_template_match can be\nused within a matchRule.", + "type": "string" + }, + "queryParameterMatches": { + "description": "Specifies a list of query parameter match criteria, all of which must\nmatch corresponding query parameters in the request.\n\nNot supported when the URL map is bound to a target gRPC proxy.", + "items": { + "$ref": "HttpQueryParameterMatch" }, - "response": { - "$ref": "Operation" + "type": "array" + }, + "regexMatch": { + "description": "For satisfying the matchRule condition, the path of the\nrequest must satisfy the regular expression specified inregexMatch after removing any query parameters and anchor\nsupplied with the original URL. For\nmore information about regular expression syntax, see Syntax.\n\nOnly one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be\nspecified.\n\nRegular expressions can only be used when the loadBalancingScheme is\nset to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED\n(regional scope) or INTERNAL_MANAGED.", + "type": "string" + } + }, + "type": "object" + }, + "HttpsHealthCheck": { + "description": "Represents a legacy HTTPS Health Check resource.\n\nLegacy HTTPS health checks have been deprecated. If you are using a target\npool-based network load balancer, you must use a legacy HTTP (not HTTPS)\nhealth check. For all other load balancers, including backend service-based\nnetwork load balancers, and for managed instance group auto-healing, you must\nuse modern (non-legacy) health checks.\n\nFor more information, seeHealth checks\noverview.", + "id": "HttpsHealthCheck", + "properties": { + "checkIntervalSec": { + "description": "How often (in seconds) to send a health check. The default value is 5\nseconds.", + "format": "int32", + "type": "integer" + }, + "creationTimestamp": { + "description": "[Output Only] Creation timestamp inRFC3339\ntext format.", + "type": "string" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you\ncreate the resource.", + "type": "string" + }, + "healthyThreshold": { + "description": "A so-far unhealthy instance will be marked healthy after this\nmany consecutive successes. The default value is 2.", + "format": "int32", + "type": "integer" + }, + "host": { + "description": "The value of the host header in the HTTPS health check request. If left\nempty (default value), the public IP on behalf of which this health check\nis performed will be used.", + "type": "string" + }, + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "format": "uint64", + "type": "string" + }, + "kind": { + "default": "compute#httpsHealthCheck", + "description": "Output only. Type of the resource.", + "readOnly": true, + "type": "string" + }, + "name": { + "description": "Name of the resource. Provided by the client when the resource is created.\nThe name must be 1-63 characters long, and comply withRFC1035.\nSpecifically, the name must be 1-63 characters long and match the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first\ncharacter must be a lowercase letter, and all following characters must\nbe a dash, lowercase letter, or digit, except the last character, which\ncannot be a dash.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "port": { + "description": "The TCP port number for the HTTPS health check request. The default value\nis 443.", + "format": "int32", + "type": "integer" + }, + "requestPath": { + "description": "The request path of the HTTPS health check request. The default value is\n\"/\". Must comply withRFC3986.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" + }, + "timeoutSec": { + "description": "How long (in seconds) to wait before claiming failure. The default value is\n5 seconds. It is invalid for timeoutSec to have a greater value than\ncheckIntervalSec.", + "format": "int32", + "type": "integer" + }, + "unhealthyThreshold": { + "description": "A so-far healthy instance will be marked unhealthy after this\nmany consecutive failures. The default value is 2.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, + "HttpsHealthCheckList": { + "description": "Contains a list of HttpsHealthCheck resources.", + "id": "HttpsHealthCheckList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of HttpsHealthCheck resources.", + "items": { + "$ref": "HttpsHealthCheck" }, - "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." + "type": "array" }, - "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", + "kind": { + "default": "compute#httpsHealthCheckList", + "description": "Output only. Type of resource.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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" + "data": { + "description": "[Output Only] Metadata about this warning in key:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "zone": { - "description": "The name of the zone where the managed instance group is located.", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project", - "zone", - "instanceGroupManager", - "size" + "type": "object" + } + }, + "type": "object" + }, + "Image": { + "description": "Represents an Image resource.\n\nYou can use images to create boot disks for your VM instances.\nFor more information, read Images.", + "id": "Image", + "properties": { + "architecture": { + "description": "The architecture of the image. Valid values are\nARM64 or X86_64.", + "enum": [ + "ARCHITECTURE_UNSPECIFIED", + "ARM64", + "X86_64" ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "Default value indicating Architecture is not set.", + "Machines with architecture ARM64", + "Machines with architecture X86_64" ], - "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." + "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" + "archiveSizeBytes": { + "description": "Size of the image tar.gz archive stored in Google Cloud\nStorage (in bytes).", + "format": "int64", + "type": "string" + }, + "creationTimestamp": { + "description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", + "readOnly": true, + "type": "string" + }, + "deprecated": { + "$ref": "DeprecationStatus", + "description": "Output only. The deprecation status associated with this image.", + "readOnly": true + }, + "description": { + "description": "An optional description of this resource. Provide this property when you\ncreate the resource.", + "type": "string" + }, + "diskSizeGb": { + "description": "Size of the image when restored onto a persistent disk (in GB).", + "format": "int64", + "type": "string" + }, + "enableConfidentialCompute": { + "description": "Output only. Whether this image is created from a confidential compute mode disk.\n[Output Only]: This field is not set by user, but from source disk.", + "readOnly": true, + "type": "boolean" + }, + "family": { + "description": "The name of the image family to which this image belongs. The image\nfamily name can be from a publicly managed image family provided by\nCompute Engine, or from a custom image family you create. For example,centos-stream-9 is a publicly available image family.\nFor more information, see Image\nfamily best practices.\n\nWhen creating disks, you can specify an image family instead of a specific\nimage name. The image family always returns its latest image that is not\ndeprecated. The name of the image family must comply with RFC1035.", + "type": "string" + }, + "guestOsFeatures": { + "description": "A list of features to enable on the guest operating system. Applicable\nonly for bootable images. To see a list of available options, see theguestOSfeatures[].type parameter.", + "items": { + "$ref": "GuestOsFeature" }, - "response": { - "$ref": "Operation" + "type": "array" + }, + "id": { + "description": "Output only. [Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "format": "uint64", + "readOnly": true, + "type": "string" + }, + "imageEncryptionKey": { + "$ref": "CustomerEncryptionKey", + "description": "Encrypts the image using acustomer-supplied\nencryption key.\n\nAfter you encrypt an image with a customer-supplied key, you must provide\nthe same key if you use the image later (e.g. to create a disk from\nthe image).\n\nCustomer-supplied encryption keys do not protect access to metadata\nof the disk.\n\nIf you do not provide an encryption key when creating the image, then the\ndisk will be encrypted using an automatically generated key and you do not\nneed to provide a key to use the image later." + }, + "kind": { + "default": "compute#image", + "description": "Output only. [Output Only] Type of the resource. Always compute#image for\nimages.", + "readOnly": true, + "type": "string" + }, + "labelFingerprint": { + "description": "A fingerprint for the labels being applied to this image, which is\nessentially a hash of the labels used for optimistic locking. The\nfingerprint is initially generated by Compute Engine and changes after\nevery request to modify or update labels. You must always provide an\nup-to-date fingerprint hash in order to update or change labels,\notherwise the request will fail with error412 conditionNotMet.\n\nTo see the latest fingerprint, make a get() request to\nretrieve an image.", + "format": "byte", + "type": "string" + }, + "labels": { + "additionalProperties": { + "type": "string" }, - "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." + "description": "Labels to apply to this image. These can be later modified by\nthe setLabels method.", + "type": "object" }, - "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" - } + "licenseCodes": { + "description": "Integer license codes indicating which licenses are attached to this image.", + "items": { + "format": "int64", + "type": "string" }, - "parameterOrder": [ - "project", - "zone", - "instanceGroupManager" - ], - "request": { - "$ref": "InstanceGroupManagersSetTargetPoolsRequest" + "type": "array" + }, + "licenses": { + "description": "Any applicable license URI.", + "items": { + "type": "string" }, - "response": { - "$ref": "Operation" + "type": "array" + }, + "name": { + "annotations": { + "required": [ + "compute.images.insert" + ] }, - "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." + "description": "Name of the resource; provided by the client when the resource is created.\nThe name must be 1-63 characters long, and comply withRFC1035.\nSpecifically, the name must be 1-63 characters long and match the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first\ncharacter must be a lowercase letter, and all following characters must be\na dash, lowercase letter, or digit, except the last character, which cannot\nbe a dash.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "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", + "params": { + "$ref": "ImageParams", + "description": "Input only. [Input Only] Additional params passed with the request, but not persisted\nas part of resource payload." + }, + "rawDisk": { + "description": "The parameters of the raw disk image.", + "properties": { + "containerType": { + "description": "The format used to encode and transmit the block device, which should beTAR. This is just a container and transmission format and not\na runtime format. Provided by the client when the disk image is created.", + "enum": [ + "TAR" + ], + "enumDescriptions": [ + "" + ], "type": "string" }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{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": { + "deprecated": true, + "description": "[Deprecated] This field is deprecated.\nAn optional SHA1 checksum of the disk image before unpackaging provided\nby the client when the disk image is created.", + "pattern": "[a-f0-9]{40}", "type": "string" }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, 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, + "source": { + "description": "The full Google Cloud Storage URL or Artifact Registry path where the raw\ndisk image archive is stored.\nThe following are valid formats:\n \n - https://storage.googleapis.com/bucket_name/image_archive_name\n - https://storage.googleapis.com/bucket_name/folder_name/image_archive_name\n - projects/project/locations/location/repositories/repo/packages/package/versions/version_id\n - projects/project/locations/location/repositories/repo/packages/package/versions/version_id@dirsum_sha256:hex_value\n\n\n\nIn order to create an image, you must provide the full or partial URL of\none of the following:\n \n - The rawDisk.source URL \n - The sourceDisk URL \n - The sourceImage URL \n - The sourceSnapshot URL", "type": "string" } }, - "parameterOrder": [ - "project", - "zone", - "instanceGroupManager" + "type": "object" + }, + "satisfiesPzi": { + "description": "Output only. Reserved for future use.", + "readOnly": true, + "type": "boolean" + }, + "satisfiesPzs": { + "description": "Output only. [Output Only] Reserved for future use.", + "readOnly": true, + "type": "boolean" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for the resource.", + "readOnly": true, + "type": "string" + }, + "shieldedInstanceInitialState": { + "$ref": "InitialStateConfig", + "description": "Set the secure boot keys of shielded instance." + }, + "sourceDisk": { + "description": "URL of the source disk used to create this image.\nFor example, the following are valid values:\n \n - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk \n - projects/project/zones/zone/disks/disk \n - zones/zone/disks/disk\n\n\n\nIn order to create an image, you must provide the full or partial URL of\none of the following:\n \n - The rawDisk.source URL \n - The sourceDisk URL \n - The sourceImage URL \n - The sourceSnapshot URL", + "type": "string" + }, + "sourceDiskEncryptionKey": { + "$ref": "CustomerEncryptionKey", + "description": "Thecustomer-supplied\nencryption key of the source disk. Required if the source disk is\nprotected by a customer-supplied encryption key." + }, + "sourceDiskId": { + "description": "Output only. [Output Only]\nThe ID value of the disk used to create this image. This value may be used\nto determine whether the image was taken from the current or a previous\ninstance of a given disk name.", + "readOnly": true, + "type": "string" + }, + "sourceImage": { + "description": "URL of the source image used to create this image.\nThe following are valid formats for the URL:\n \n - https://www.googleapis.com/compute/v1/projects/project_id/global/\n images/image_name\n - projects/project_id/global/images/image_name\n\n\n\nIn order to create an image, you must provide the full or partial URL of\none of the following:\n \n - The rawDisk.source URL \n - The sourceDisk URL \n - The sourceImage URL \n - The sourceSnapshot URL", + "type": "string" + }, + "sourceImageEncryptionKey": { + "$ref": "CustomerEncryptionKey", + "description": "The customer-supplied encryption key of the source image. Required if the\nsource image is protected by a customer-supplied encryption key." + }, + "sourceImageId": { + "description": "Output only. [Output Only]\nThe ID value of the image used to create this image. This value may be used\nto determine whether the image was taken from the current or a previous\ninstance of a given image name.", + "readOnly": true, + "type": "string" + }, + "sourceSnapshot": { + "description": "URL of the source snapshot used to create this image.\nThe following are valid formats for the URL:\n \n - https://www.googleapis.com/compute/v1/projects/project_id/global/\n snapshots/snapshot_name\n - projects/project_id/global/snapshots/snapshot_name\n\n\n\nIn order to create an image, you must provide the full or partial URL of\none of the following:\n \n - The rawDisk.source URL \n - The sourceDisk URL \n - The sourceImage URL \n - The sourceSnapshot URL", + "type": "string" + }, + "sourceSnapshotEncryptionKey": { + "$ref": "CustomerEncryptionKey", + "description": "The customer-supplied encryption key of the source snapshot. Required if\nthe source snapshot is protected by a customer-supplied encryption key." + }, + "sourceSnapshotId": { + "description": "Output only. [Output Only]\nThe ID value of the snapshot used to create this image. This value may be\nused to determine whether the snapshot was taken from the current or a\nprevious instance of a given snapshot name.", + "readOnly": true, + "type": "string" + }, + "sourceType": { + "default": "RAW", + "description": "The type of the image used to create this disk. The\ndefault and only valid value is RAW.", + "enum": [ + "RAW" ], - "response": { - "$ref": "InstanceGroupManagersListManagedInstancesResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "" ], - "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`." + "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" + "status": { + "description": "Output only. [Output Only] The status of the image. An image can be used to create other\nresources, such as instances, only after the image has been successfully\ncreated and the status is set to READY. Possible\nvalues are FAILED, PENDING, orREADY.", + "enum": [ + "DELETING", + "FAILED", + "PENDING", + "READY" ], - "response": { - "$ref": "InstanceGroupManagersListErrorsResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "Image is deleting.", + "Image creation failed due to an error.", + "Image hasn't been created as yet.", + "Image has been successfully created." ], - "description": "Lists all errors thrown by actions on instances for a given managed instance group. The filter and orderBy query parameters are not supported." + "readOnly": true, + "type": "string" }, - "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, + "storageLocations": { + "description": "Cloud Storage bucket storage location of the image (regional or\nmulti-regional).", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, + "ImageFamilyView": { + "id": "ImageFamilyView", + "properties": { + "image": { + "$ref": "Image", + "description": "The latest image that is part of the specified image family in the\nrequested location, and that is not deprecated." + } + }, + "type": "object" + }, + "ImageList": { + "description": "Contains a list of images.", + "id": "ImageList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of Image resources.", + "items": { + "$ref": "Image" + }, + "type": "array" + }, + "kind": { + "default": "compute#imageList", + "description": "Output only. Type of resource.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "zone": { - "description": "The name of the zone 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" } }, - "parameterOrder": [ - "project", - "zone", - "instanceGroupManager" - ], - "response": { - "$ref": "InstanceGroupManagersListPerInstanceConfigsResp" + "type": "object" + } + }, + "type": "object" + }, + "ImageParams": { + "description": "Additional image params.", + "id": "ImageParams", + "properties": { + "resourceManagerTags": { + "additionalProperties": { + "type": "string" }, - "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." + "description": "Input only. Resource manager tags to be bound to the image. Tag keys and values have\nthe same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in\nnamespaced format such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT &\nPATCH) when empty.", + "type": "object" + } + }, + "type": "object" + }, + "InitialStateConfig": { + "description": "Initial State for shielded instance,\nthese are public keys which are safe to store in public", + "id": "InitialStateConfig", + "properties": { + "dbs": { + "description": "The Key Database (db).", + "items": { + "$ref": "FileContentBuffer" + }, + "type": "array" }, - "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" - } + "dbxs": { + "description": "The forbidden key database (dbx).", + "items": { + "$ref": "FileContentBuffer" }, - "parameterOrder": [ - "project", - "zone", - "instanceGroupManager" - ], - "request": { - "$ref": "InstanceGroupManagersUpdatePerInstanceConfigsReq" + "type": "array" + }, + "keks": { + "description": "The Key Exchange Key (KEK).", + "items": { + "$ref": "FileContentBuffer" }, - "response": { - "$ref": "Operation" + "type": "array" + }, + "pk": { + "$ref": "FileContentBuffer", + "description": "The Platform Key (PK)." + } + }, + "type": "object" + }, + "Instance": { + "description": "Represents an Instance resource.\n\nAn instance is a virtual machine that is hosted on Google Cloud Platform.\nFor more information, readVirtual Machine Instances.", + "id": "Instance", + "properties": { + "advancedMachineFeatures": { + "$ref": "AdvancedMachineFeatures", + "description": "Controls for advanced machine-related behavior features." + }, + "canIpForward": { + "description": "Allows this instance to send and receive packets with non-matching\ndestination or source IPs. This is required if you plan to use this\ninstance to forward routes. For more information, seeEnabling IP Forwarding.", + "type": "boolean" + }, + "confidentialInstanceConfig": { + "$ref": "ConfidentialInstanceConfig" + }, + "cpuPlatform": { + "description": "Output only. [Output Only] The CPU platform used by this instance.", + "readOnly": true, + "type": "string" + }, + "creationTimestamp": { + "description": "Output only. [Output Only] Creation timestamp inRFC3339 text format.", + "readOnly": true, + "type": "string" + }, + "deletionProtection": { + "description": "Whether the resource should be protected against deletion.", + "type": "boolean" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you\ncreate the resource.", + "type": "string" + }, + "disks": { + "description": "Array of disks associated with this instance. Persistent disks must be\ncreated before you can assign them.", + "items": { + "$ref": "AttachedDisk" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "type": "array" + }, + "displayDevice": { + "$ref": "DisplayDevice", + "description": "Enables display device for the instance." + }, + "fingerprint": { + "description": "Specifies a fingerprint for this resource, which is essentially a hash of\nthe instance's contents and used for optimistic locking. The\nfingerprint is initially generated by Compute Engine and changes after\nevery request to modify or update the instance. You must always provide an\nup-to-date fingerprint hash in order to update the instance.\n\nTo see the latest fingerprint, make get() request to the\ninstance.", + "format": "byte", + "type": "string" + }, + "guestAccelerators": { + "description": "A list of the type and count of accelerator cards attached to the instance.", + "items": { + "$ref": "AcceleratorConfig" + }, + "type": "array" + }, + "hostname": { + "description": "Specifies the hostname of the instance. The specified hostname must be\nRFC1035 compliant. If hostname is not specified, the default hostname is\n[INSTANCE_NAME].c.[PROJECT_ID].internal when using the global DNS, and\n[INSTANCE_NAME].[ZONE].c.[PROJECT_ID].internal when using zonal DNS.", + "type": "string" + }, + "id": { + "description": "Output only. [Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "format": "uint64", + "readOnly": true, + "type": "string" + }, + "instanceEncryptionKey": { + "$ref": "CustomerEncryptionKey", + "description": "Encrypts suspended data for an instance with acustomer-managed\nencryption key.\n\nIf you are creating a new instance, this field will encrypt the local SSD\nand in-memory contents of the instance during the suspend operation.\n\nIf you do not provide an encryption key when creating the instance, then\nthe local SSD and in-memory contents will be encrypted using\nan automatically generated key during the suspend operation." + }, + "keyRevocationActionType": { + "description": "KeyRevocationActionType of the instance. Supported options are \"STOP\" and\n\"NONE\". The default value is \"NONE\" if it is not specified.", + "enum": [ + "KEY_REVOCATION_ACTION_TYPE_UNSPECIFIED", + "NONE", + "STOP" ], - "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." + "enumDescriptions": [ + "Default value. This value is unused.", + "Indicates user chose no operation.", + "Indicates user chose to opt for VM shutdown on key revocation." + ], + "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" - } + "kind": { + "default": "compute#instance", + "description": "Output only. [Output Only] Type of the resource. Always compute#instance\nfor instances.", + "readOnly": true, + "type": "string" + }, + "labelFingerprint": { + "description": "A fingerprint for this request, which is essentially a hash of\nthe label's contents and used for optimistic locking. The\nfingerprint is initially generated by Compute Engine and changes after\nevery request to modify or update labels. You must always provide an\nup-to-date fingerprint hash in order to update or change labels.\n\nTo see the latest fingerprint, make get() request to the\ninstance.", + "format": "byte", + "type": "string" + }, + "labels": { + "additionalProperties": { + "type": "string" }, - "parameterOrder": [ - "project", - "zone", - "instanceGroupManager" + "description": "Labels to apply to this instance. These can be later modified by\nthe setLabels method.", + "type": "object" + }, + "lastStartTimestamp": { + "description": "Output only. [Output Only] Last start timestamp inRFC3339 text format.", + "readOnly": true, + "type": "string" + }, + "lastStopTimestamp": { + "description": "Output only. [Output Only] Last stop timestamp inRFC3339 text format.", + "readOnly": true, + "type": "string" + }, + "lastSuspendedTimestamp": { + "description": "Output only. [Output Only] Last suspended timestamp inRFC3339 text format.", + "readOnly": true, + "type": "string" + }, + "localSsdEncryptionMode": { + "description": "Specifies which method should be used for encrypting the\nLocal SSDs attached to the VM.", + "enum": [ + "EPHEMERAL_KEY_ENCRYPTION", + "LOCAL_SSD_ENCRYPTION_MODE_UNSPECIFIED", + "STANDARD_ENCRYPTION" ], - "request": { - "$ref": "InstanceGroupManagersPatchPerInstanceConfigsReq" + "enumDescriptions": [ + "The given VM will opt-in for using ephemeral key for\nencryption of Local SSDs.\nThe Local SSDs will not be able to recover data in case of VM\ncrash.", + "The given VM will be encrypted using keys managed by the cloud\ninfrastructure and the keys will be deleted when the VM is\ndeleted.", + "The given VM will be encrypted using keys managed by the cloud\ninfrastructure and the keys will be deleted when the VM is\ndeleted." + ], + "type": "string" + }, + "machineType": { + "description": "Full or partial URL of the machine type resource to use for this instance,\nin the format:zones/zone/machineTypes/machine-type. This is provided by the client\nwhen the instance is created. For example, the following is a valid partial\nurl to a predefined\nmachine type:\n\nzones/us-central1-f/machineTypes/n1-standard-1\n\n\nTo create acustom\nmachine type, provide a URL to a machine type in the following format,\nwhere CPUS is 1 or an even number up to 32 (2,\n4, 6, ... 24, etc), and MEMORY is the total\nmemory for this instance. Memory must be a multiple of 256 MB and must\nbe supplied in MB (e.g. 5 GB of memory is 5120 MB):\n\nzones/zone/machineTypes/custom-CPUS-MEMORY\n\n\nFor example: zones/us-central1-f/machineTypes/custom-4-5120\n\nFor a full list of restrictions, read theSpecifications\nfor custom machine types.", + "type": "string" + }, + "metadata": { + "$ref": "Metadata", + "description": "The metadata key/value pairs assigned\nto this instance. This includes metadata keys that were explicitly defined\nfor the instance." + }, + "minCpuPlatform": { + "description": "Specifies aminimum CPU\nplatform for the VM instance. Applicable values are the friendly names\nof CPU platforms, such as minCpuPlatform: \"Intel\nHaswell\" or minCpuPlatform: \"Intel Sandy\nBridge\".", + "type": "string" + }, + "name": { + "annotations": { + "required": [ + "compute.instances.insert" + ] }, - "response": { - "$ref": "Operation" + "description": "The name of the resource, provided by the client when initially creating\nthe resource. The resource name must be 1-63 characters long, and comply\nwithRFC1035.\nSpecifically, the name must be 1-63 characters long and match the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first\ncharacter must be a lowercase letter, and all following characters must be\na dash, lowercase letter, or digit, except the last character, which cannot\nbe a dash.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "networkInterfaces": { + "description": "An array of network configurations for this instance. These specify how\ninterfaces are configured to interact with other network services, such as\nconnecting to the internet. Multiple interfaces are supported\nper instance.", + "items": { + "$ref": "NetworkInterface" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "type": "array" + }, + "networkPerformanceConfig": { + "$ref": "NetworkPerformanceConfig" + }, + "params": { + "$ref": "InstanceParams", + "description": "Input only. [Input Only] Additional params passed with the request, but not persisted\nas part of resource payload." + }, + "privateIpv6GoogleAccess": { + "description": "The private IPv6 google access type for the VM.\nIf not specified, use INHERIT_FROM_SUBNETWORK as default.", + "enum": [ + "ENABLE_BIDIRECTIONAL_ACCESS_TO_GOOGLE", + "ENABLE_OUTBOUND_VM_ACCESS_TO_GOOGLE", + "INHERIT_FROM_SUBNETWORK" ], - "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." + "enumDescriptions": [ + "Bidirectional private IPv6 access to/from Google services. If\nspecified, the subnetwork who is attached to the instance's default network\ninterface will be assigned an internal IPv6 prefix if it doesn't have\nbefore.", + "Outbound private IPv6 access from VMs in this subnet to Google services. If\nspecified, the subnetwork who is attached to the instance's default network\ninterface will be assigned an internal IPv6 prefix if it doesn't have\nbefore.", + "Each network interface inherits PrivateIpv6GoogleAccess from its\nsubnetwork." + ], + "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" - } + "reservationAffinity": { + "$ref": "ReservationAffinity", + "description": "Specifies the reservations that this instance can consume from." + }, + "resourcePolicies": { + "description": "Resource policies applied to this instance.", + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "zone", - "instanceGroupManager" + "type": "array" + }, + "resourceStatus": { + "$ref": "ResourceStatus", + "description": "Output only. [Output Only] Specifies values set for instance attributes as\ncompared to the values requested by user in the corresponding input only\nfield.", + "readOnly": true + }, + "satisfiesPzi": { + "description": "Output only. [Output Only] Reserved for future use.", + "readOnly": true, + "type": "boolean" + }, + "satisfiesPzs": { + "description": "Output only. [Output Only] Reserved for future use.", + "readOnly": true, + "type": "boolean" + }, + "scheduling": { + "$ref": "Scheduling", + "description": "Sets the scheduling options for this instance." + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "serviceAccounts": { + "description": "A list of service accounts, with their specified scopes, authorized for\nthis instance. Only one service account per VM instance is supported.\n\nService accounts generate access tokens that can be accessed\nthrough the metadata server and used to authenticate applications on the\ninstance. SeeService Accounts\nfor more information.", + "items": { + "$ref": "ServiceAccount" + }, + "type": "array" + }, + "shieldedInstanceConfig": { + "$ref": "ShieldedInstanceConfig" + }, + "shieldedInstanceIntegrityPolicy": { + "$ref": "ShieldedInstanceIntegrityPolicy" + }, + "sourceMachineImage": { + "description": "Source machine image", + "type": "string" + }, + "sourceMachineImageEncryptionKey": { + "$ref": "CustomerEncryptionKey", + "description": "Source machine image encryption key when creating an instance from a\nmachine image." + }, + "startRestricted": { + "description": "Output only. [Output Only] Whether a VM has been restricted for start because Compute\nEngine has detected suspicious activity.", + "readOnly": true, + "type": "boolean" + }, + "status": { + "description": "Output only. [Output Only] The status of the instance. One of the\nfollowing values: PROVISIONING, STAGING,RUNNING, STOPPING, SUSPENDING,SUSPENDED, REPAIRING, andTERMINATED. For more information about the status of the\ninstance, see \nInstance life cycle.", + "enum": [ + "DEPROVISIONING", + "PENDING", + "PENDING_STOP", + "PROVISIONING", + "REPAIRING", + "RUNNING", + "STAGING", + "STOPPED", + "STOPPING", + "SUSPENDED", + "SUSPENDING", + "TERMINATED" ], - "request": { - "$ref": "InstanceGroupManagersDeletePerInstanceConfigsReq" + "enumDescriptions": [ + "The instance is halted and we are performing tear down tasks like network\ndeprogramming, releasing quota, IP, tearing down disks etc.", + "For Flex Start provisioning instance is waiting for available capacity\nfrom Dynamic Workload Scheduler (DWS).", + "The instance is gracefully shutting down.", + "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\nis 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\nfailure)." + ], + "readOnly": true, + "type": "string" + }, + "statusMessage": { + "description": "Output only. [Output Only] An optional, human-readable explanation of the status.", + "readOnly": true, + "type": "string" + }, + "tags": { + "$ref": "Tags", + "description": "Tags to apply to this instance. Tags are used to identify valid\nsources or targets for network firewalls and are specified by the client\nduring instance creation. The tags can be later modified by the setTags\nmethod. Each tag within the list must comply withRFC1035.\nMultiple tags can be specified via the 'tags.items' field." + }, + "workloadIdentityConfig": { + "$ref": "WorkloadIdentityConfig" + }, + "zone": { + "description": "Output only. [Output Only] URL of the zone where the instance resides.\nYou must specify this field as part of the HTTP request URL. It is\nnot settable as a field in the request body.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "InstanceAggregatedList": { + "id": "InstanceAggregatedList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "additionalProperties": { + "$ref": "InstancesScopedList", + "description": "[Output Only] Name of the scope containing this set of instances." }, - "response": { - "$ref": "Operation" + "description": "An object that contains a list of instances scoped by zone.", + "type": "object" + }, + "kind": { + "default": "compute#instanceAggregatedList", + "description": "Output only. [Output Only] Type of resource. Alwayscompute#instanceAggregatedList for aggregated lists of\nInstance resources.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "unreachables": { + "description": "Output only. [Output Only] Unreachable resources.", + "items": { + "type": "string" }, - "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." + "readOnly": true, + "type": "array" }, - "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, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "zone": { - "description": "The name of the zone where the managed instance group is located. Should conform to RFC1035.", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project", - "zone", - "instanceGroupManager" - ], - "request": { - "$ref": "InstanceGroupManagersApplyUpdatesRequest" + "type": "object" + } + }, + "type": "object" + }, + "InstanceConsumptionData": { + "id": "InstanceConsumptionData", + "properties": { + "consumptionInfo": { + "$ref": "InstanceConsumptionInfo", + "description": "Output only. Resources consumed by the instance.", + "readOnly": true + }, + "instance": { + "description": "Output only. Server-defined URL for the instance.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "InstanceConsumptionInfo": { + "id": "InstanceConsumptionInfo", + "properties": { + "guestCpus": { + "description": "Output only. The number of virtual CPUs that are available to the instance.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "localSsdGb": { + "description": "Output only. The amount of local SSD storage available to the instance,\ndefined in GiB.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "memoryMb": { + "description": "Output only. The amount of physical memory available to the instance,\ndefined in MiB.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "minNodeCpus": { + "description": "Output only. The minimal guaranteed number of virtual CPUs that are reserved.", + "format": "int32", + "readOnly": true, + "type": "integer" + } + }, + "type": "object" + }, + "InstanceFlexibilityPolicy": { + "description": "A flexible specification of machine types for instances to create.", + "id": "InstanceFlexibilityPolicy", + "properties": { + "instanceSelections": { + "additionalProperties": { + "$ref": "InstanceFlexibilityPolicyInstanceSelection" }, - "response": { - "$ref": "Operation" + "description": "Specification of alternative, flexible instance subsets.\nOne of them will be selected to create the instances\nbased on various criteria, like:\n- ranks,\n- location policy,\n- current capacity,\n- available reservations (you can specify affinity in\nInstanceProperties),\n- SWAN/GOOSE limitations.\nKey is an arbitrary, unique RFC1035 string that identifies the instance\nselection.", + "type": "object" + } + }, + "type": "object" + }, + "InstanceFlexibilityPolicyInstanceSelection": { + "description": "Specification of machine type to use. Every position inside this message\nis an alternative.\nThe count specified in the shape flexibility must not exceed the number\nof entries in per_instance_properties or the capacity of the\nname_pattern, if used.", + "id": "InstanceFlexibilityPolicyInstanceSelection", + "properties": { + "disks": { + "description": "Disks to be attached to the instances created from in this selection.\nThey override the disks specified in the instance properties.", + "items": { + "$ref": "AttachedDisk" }, - "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." + "type": "array" }, - "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" - } + "machineTypes": { + "description": "Alternative machine types to use for instances that are created from\nthese properties. This field only accepts a machine type names, for\nexample `n2-standard-4` and not URLs or partial URLs.", + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "zone", - "instanceGroupManager" - ], - "request": { - "$ref": "InstanceGroupManagersCreateInstancesRequest" + "type": "array" + }, + "minCpuPlatform": { + "description": "Name of the minimum CPU platform to be used by this instance selection.\ne.g. 'Intel Ice Lake'.", + "type": "string" + }, + "rank": { + "description": "Rank when prioritizing the shape flexibilities.\nThe instance selections with rank are considered\nfirst, in the ascending order of the rank.\nIf not set, defaults to 0.", + "format": "int64", + "type": "string" + } + }, + "type": "object" + }, + "InstanceGroup": { + "description": "Represents an Instance Group resource.\n\nInstance Groups can be used to configure a target forload\nbalancing.\n\nInstance groups can either be managed or unmanaged.\n\nTo create \nmanaged instance groups, use the instanceGroupManager orregionInstanceGroupManager resource instead.\n\nUse zonal unmanaged instance groups if you need to applyload\nbalancing to groups of heterogeneous instances or if you need to manage\nthe instances yourself. You cannot create regional unmanaged instance groups.\n\nFor more information, readInstance\ngroups.", + "id": "InstanceGroup", + "properties": { + "creationTimestamp": { + "description": "Output only. [Output Only] The creation timestamp for this instance group inRFC3339\ntext format.", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you\ncreate the resource.", + "type": "string" + }, + "fingerprint": { + "description": "Output only. [Output Only] The fingerprint of the named ports. The system\nuses this fingerprint to detect conflicts when multiple users change the\nnamed ports concurrently.", + "format": "byte", + "readOnly": true, + "type": "string" + }, + "id": { + "description": "Output only. [Output Only] A unique identifier for this instance group, generated\nby the server.", + "format": "uint64", + "readOnly": true, + "type": "string" + }, + "kind": { + "default": "compute#instanceGroup", + "description": "Output only. [Output Only] The resource type, which is alwayscompute#instanceGroup for instance groups.", + "readOnly": true, + "type": "string" + }, + "name": { + "annotations": { + "required": [ + "compute.instanceGroups.insert" + ] }, - "response": { - "$ref": "Operation" + "description": "The name of the instance group. The name must be 1-63 characters\nlong, and comply withRFC1035.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "namedPorts": { + "description": "Optional. Assigns a name to a port number. For example:{name: \"http\", port: 80}\n\nThis\nallows the system to reference ports by the assigned name instead of a\nport number. Named ports can also contain multiple ports. For example:[{name: \"app1\", port: 8080}, {name:\n\"app1\", port: 8081}, {name: \"app2\", port:\n8082}]\n\nNamed ports apply to all instances in this instance group.", + "items": { + "$ref": "NamedPort" }, - "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." + "type": "array" + }, + "network": { + "description": "[Output Only] The URL of the network to which all instances in the\ninstance group belong. If your instance has multiple network interfaces,\nthen the network and subnetwork fields only refer to the\nnetwork and subnet used by your primary interface (nic0).", + "type": "string" + }, + "region": { + "description": "Output only. [Output Only] The URL of theregion\nwhere the instance group is located (for regional resources).", + "readOnly": true, + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] The URL for this instance group. The server generates\nthis URL.", + "readOnly": true, + "type": "string" + }, + "size": { + "description": "Output only. [Output Only] The total number of instances in the instance group.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "subnetwork": { + "description": "Output only. [Output Only] The URL of the subnetwork to which all instances in the\ninstance group belong. If your instance has multiple network interfaces,\nthen the network and subnetwork fields only refer to the\nnetwork and subnet used by your primary interface (nic0).", + "readOnly": true, + "type": "string" + }, + "zone": { + "description": "Output only. [Output Only] The URL of thezone\nwhere the instance group is located (for zonal resources).", + "readOnly": true, + "type": "string" } - } + }, + "type": "object" }, - "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" - } + "InstanceGroupAggregatedList": { + "id": "InstanceGroupAggregatedList", + "properties": { + "id": { + "description": "Output only. [Output Only] Unique identifier for the resource; defined by the server.", + "readOnly": true, + "type": "string" + }, + "items": { + "additionalProperties": { + "$ref": "InstanceGroupsScopedList", + "description": "The name of the scope that contains this set of instance groups." }, - "parameterOrder": [ - "project", - "zone", - "instanceGroupManager", - "resizeRequest" - ], - "response": { - "$ref": "InstanceGroupManagerResizeRequest" + "description": "A list of InstanceGroupsScopedList resources.", + "type": "object" + }, + "kind": { + "default": "compute#instanceGroupAggregatedList", + "description": "Output only. [Output Only] The resource type, which is alwayscompute#instanceGroupAggregatedList for aggregated lists of\ninstance groups.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "Output only. [Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "readOnly": true, + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "unreachables": { + "description": "Output only. [Output Only] Unreachable resources.", + "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": "Returns all of the details about the specified resize request." + "readOnly": true, + "type": "array" }, - "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, + "warning": { + "description": "Output only. [Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project", - "zone", - "instanceGroupManager" - ], - "request": { - "$ref": "InstanceGroupManagerResizeRequest" - }, - "response": { - "$ref": "Operation" + "readOnly": true, + "type": "object" + } + }, + "type": "object" + }, + "InstanceGroupList": { + "description": "A list of InstanceGroup resources.", + "id": "InstanceGroupList", + "properties": { + "id": { + "description": "Output only. [Output Only] Unique identifier for the resource; defined by the server.", + "readOnly": true, + "type": "string" + }, + "items": { + "description": "A list of InstanceGroup resources.", + "items": { + "$ref": "InstanceGroup" }, - "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." + "type": "array" }, - "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, + "kind": { + "default": "compute#instanceGroupList", + "description": "Output only. [Output Only] The resource type, which is alwayscompute#instanceGroupList for instance group lists.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "Output only. [Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "readOnly": true, + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "warning": { + "description": "Output only. [Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "zone": { - "description": "The name of the zone where the managed instance group is located. The name should conform to RFC1035.", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project", - "zone", - "instanceGroupManager" - ], - "response": { - "$ref": "InstanceGroupManagerResizeRequestsListResponse" + "readOnly": true, + "type": "object" + } + }, + "type": "object" + }, + "InstanceGroupManager": { + "description": "Represents a Managed Instance Group resource.\n\nAn instance group is a collection of VM instances that you can manage as a\nsingle entity. For more information, readInstance groups.\n\nFor zonal Managed Instance Group, use the instanceGroupManagers\nresource.\n\nFor regional Managed Instance Group, use theregionInstanceGroupManagers resource.", + "id": "InstanceGroupManager", + "properties": { + "allInstancesConfig": { + "$ref": "InstanceGroupManagerAllInstancesConfig", + "description": "Specifies configuration that overrides the instance template configuration\nfor the group." + }, + "autoHealingPolicies": { + "description": "The autohealing policy for this managed instance group. You can specify\nonly one value.", + "items": { + "$ref": "InstanceGroupManagerAutoHealingPolicy" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "type": "array" + }, + "baseInstanceName": { + "description": "The base instance name is a prefix that you want to attach to the names of\nall VMs in a MIG. The maximum character length is 58 and the name must\ncomply with RFC1035 format.\n\nWhen a VM is created in the group, the MIG appends a hyphen and a random\nfour-character string to the base instance name. If you want the MIG to\nassign sequential numbers instead of a random string, then end the base\ninstance name with a hyphen followed by one or more hash symbols. The hash\nsymbols indicate the number of digits. For example, a base instance name of\n\"vm-###\" results in \"vm-001\" as a VM name.\n@pattern\n[a-z](([-a-z0-9]{0,57})|([-a-z0-9]{0,51}-#{1,10}(\\\\[[0-9]{1,10}\\\\])?))", + "type": "string" + }, + "creationTimestamp": { + "description": "Output only. The creation timestamp for this managed instance group inRFC3339\ntext format.", + "readOnly": true, + "type": "string" + }, + "currentActions": { + "$ref": "InstanceGroupManagerActionsSummary", + "description": "Output only. The list of instance actions and the number of instances\nin this managed instance group that are scheduled for each of those\nactions.", + "readOnly": true + }, + "description": { + "description": "An optional description of this resource.", + "type": "string" + }, + "distributionPolicy": { + "$ref": "DistributionPolicy", + "description": "Policy specifying the intended distribution of managed instances across\nzones in a regional managed instance group." + }, + "fingerprint": { + "description": "Fingerprint of this resource. This field may be used in optimistic locking.\nIt will be ignored when inserting an InstanceGroupManager. An up-to-date\nfingerprint must be provided in order to update the InstanceGroupManager,\notherwise the request will fail with error412 conditionNotMet.\n\nTo see the latest fingerprint, make a get() request to\nretrieve an InstanceGroupManager.", + "format": "byte", + "type": "string" + }, + "id": { + "description": "Output only. A unique identifier for this resource type. The server\ngenerates this identifier.", + "format": "uint64", + "readOnly": true, + "type": "string" + }, + "instanceFlexibilityPolicy": { + "$ref": "InstanceGroupManagerInstanceFlexibilityPolicy", + "description": "Instance flexibility allowing MIG to create VMs from multiple\ntypes of machines.\nInstance flexibility configuration on MIG overrides instance\ntemplate configuration." + }, + "instanceGroup": { + "description": "Output only. The URL of the Instance Group resource.", + "readOnly": true, + "type": "string" + }, + "instanceLifecyclePolicy": { + "$ref": "InstanceGroupManagerInstanceLifecyclePolicy", + "description": "The repair policy for this managed instance group." + }, + "instanceTemplate": { + "description": "The URL of the instance template that is specified for this managed\ninstance group. The group uses this template to create all new instances\nin the managed instance group. The templates for existing instances in the\ngroup do not change unless you run recreateInstances, runapplyUpdatesToInstances, or set the group'supdatePolicy.type to PROACTIVE.", + "type": "string" + }, + "kind": { + "default": "compute#instanceGroupManager", + "description": "Output only. The resource type, which is alwayscompute#instanceGroupManager for managed instance groups.", + "readOnly": true, + "type": "string" + }, + "listManagedInstancesResults": { + "description": "Pagination behavior of the listManagedInstances API method for\nthis managed instance group.", + "enum": [ + "PAGELESS", + "PAGINATED" + ], + "enumDescriptions": [ + "(Default) Pagination is disabled for the group'slistManagedInstances API method. maxResults\nand pageToken query parameters are ignored and all\ninstances are returned in a single response.", + "Pagination is enabled for the group's listManagedInstances\nAPI method. maxResults and pageToken query\nparameters are respected." ], - "description": "Retrieves a list of resize requests that are contained in the managed instance group." + "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" - } + "name": { + "annotations": { + "required": [ + "compute.instanceGroupManagers.insert", + "compute.regionInstanceGroupManagers.insert" + ] }, - "parameterOrder": [ - "project", - "zone", - "instanceGroupManager", - "resizeRequest" - ], - "response": { - "$ref": "Operation" + "description": "The name of the managed instance group. The name must be 1-63 characters\nlong, and comply withRFC1035.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "namedPorts": { + "description": "[Output Only] Named ports configured on the Instance Groups complementary\nto this Instance Group Manager.", + "items": { + "$ref": "NamedPort" }, - "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." + "type": "array" }, - "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" - } + "region": { + "description": "Output only. [Output Only] The URL of theregion\nwhere the managed instance group resides (for regional resources).", + "readOnly": true, + "type": "string" + }, + "resourcePolicies": { + "$ref": "InstanceGroupManagerResourcePolicies", + "description": "Resource policies for this managed instance group." + }, + "satisfiesPzi": { + "description": "Output only. Reserved for future use.", + "readOnly": true, + "type": "boolean" + }, + "satisfiesPzs": { + "description": "Output only. Reserved for future use.", + "readOnly": true, + "type": "boolean" + }, + "selfLink": { + "description": "Output only. The URL for this managed instance group. The server defines\nthis URL.", + "readOnly": true, + "type": "string" + }, + "standbyPolicy": { + "$ref": "InstanceGroupManagerStandbyPolicy", + "description": "Standby policy for stopped and suspended instances." + }, + "statefulPolicy": { + "$ref": "StatefulPolicy", + "description": "Stateful configuration for this Instanced Group Manager" + }, + "status": { + "$ref": "InstanceGroupManagerStatus", + "description": "Output only. The status of this managed instance group.", + "readOnly": true + }, + "targetPools": { + "description": "The URLs for all TargetPool resources to which instances in theinstanceGroup field are added. The target pools automatically\napply to all of the instances in the managed instance group.", + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "zone", - "instanceGroupManager", - "resizeRequest" - ], - "response": { - "$ref": "Operation" + "type": "array" + }, + "targetSize": { + "annotations": { + "required": [ + "compute.instanceGroupManagers.insert", + "compute.regionInstanceGroupManagers.insert" + ] }, - "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." + "description": "The target number of running instances for this managed instance group.\nYou can reduce this number by using the instanceGroupManager\ndeleteInstances or abandonInstances methods. Resizing the group also\nchanges this number.", + "format": "int32", + "type": "integer" + }, + "targetSizePolicy": { + "$ref": "InstanceGroupManagerTargetSizePolicy", + "description": "The policy that specifies how the MIG creates its VMs to achieve the target\nsize." + }, + "targetStoppedSize": { + "description": "The target number of stopped instances for this managed instance group.\nThis number changes when you: \n \n - Stop instance using the stopInstances\n method or start instances using the startInstances\n method.\n - Manually change the targetStoppedSize using the update\n method.", + "format": "int32", + "type": "integer" + }, + "targetSuspendedSize": { + "description": "The target number of suspended instances for this managed instance group.\nThis number changes when you: \n \n - Suspend instance using the suspendInstances\n method or resume instances using the resumeInstances\n method.\n - Manually change the targetSuspendedSize using the update\n method.", + "format": "int32", + "type": "integer" + }, + "updatePolicy": { + "$ref": "InstanceGroupManagerUpdatePolicy", + "description": "The update policy for this managed instance group." + }, + "versions": { + "description": "Specifies the instance templates used by this managed instance group to\ncreate instances.\n\nEach version is defined by an instanceTemplate and aname. Every version can appear at most once per instance\ngroup. This field overrides the top-level instanceTemplate\nfield. Read more about therelationships\nbetween these fields. Exactly one version must leave thetargetSize field unset. That version will be applied to all\nremaining instances. For more information, read aboutcanary\nupdates.", + "items": { + "$ref": "InstanceGroupManagerVersion" + }, + "type": "array" + }, + "zone": { + "description": "Output only. The URL of azone\nwhere the managed instance group is located (for zonal resources).", + "readOnly": true, + "type": "string" } - } + }, + "type": "object" }, - "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" - } + "InstanceGroupManagerActionsSummary": { + "id": "InstanceGroupManagerActionsSummary", + "properties": { + "abandoning": { + "description": "Output only. The total number of instances in the managed instance group\nthat are scheduled to be abandoned. Abandoning an instance removes it\nfrom the managed instance group without deleting it.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "creating": { + "description": "Output only. The number of instances in the managed instance group that\nare scheduled to be created or are currently being created. If the group\nfails to create any of these instances, it tries again until it creates\nthe instance successfully.\n\nIf you have disabled creation retries, this field will not be populated;\ninstead, the creatingWithoutRetries field will be populated.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "creatingWithoutRetries": { + "description": "Output only. The number of instances that the managed instance group\nwill attempt to create. The group attempts to create each instance\nonly once. If the group fails to create any of these instances, it\ndecreases the group's targetSize value accordingly.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "deleting": { + "description": "Output only. The number of instances in the managed instance group that\nare scheduled to be deleted or are currently being deleted.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "none": { + "description": "Output only. The number of instances in the managed instance group that\nare running and have no scheduled actions.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "recreating": { + "description": "Output only. The number of instances in the managed instance group that\nare scheduled to be recreated or are currently being being recreated.\nRecreating an instance deletes the existing root persistent disk\nand creates a new disk from the image that is defined in the\ninstance template.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "refreshing": { + "description": "Output only. The number of instances in the managed instance group that\nare being reconfigured with properties that do not require a restart\nor a recreate action. For example, setting or removing target\npools for the instance.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "restarting": { + "description": "Output only. The number of instances in the managed instance group that\nare scheduled to be restarted or are currently being restarted.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "resuming": { + "description": "Output only. The number of instances in the managed instance group that\nare scheduled to be resumed or are currently being resumed.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "starting": { + "description": "Output only. The number of instances in the managed instance group that\nare scheduled to be started or are currently being started.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "stopping": { + "description": "Output only. The number of instances in the managed instance group that\nare scheduled to be stopped or are currently being stopped.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "suspending": { + "description": "Output only. The number of instances in the managed instance group that\nare scheduled to be suspended or are currently being suspended.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "verifying": { + "description": "Output only. The number of instances in the managed instance group that\nare being verified. See the managedInstances[].currentAction\nproperty in the listManagedInstances method documentation.", + "format": "int32", + "readOnly": true, + "type": "integer" + } + }, + "type": "object" + }, + "InstanceGroupManagerAggregatedList": { + "id": "InstanceGroupManagerAggregatedList", + "properties": { + "id": { + "description": "Output only. Unique identifier for the resource; defined by the server.", + "readOnly": true, + "type": "string" + }, + "items": { + "additionalProperties": { + "$ref": "InstanceGroupManagersScopedList", + "description": "Output only. The name of the scope that contains this set of managed instance groups." }, - "parameterOrder": [ - "project", - "region" - ], - "response": { - "$ref": "RegionInstanceGroupManagerList" + "description": "A list of InstanceGroupManagersScopedList resources.", + "type": "object" + }, + "kind": { + "default": "compute#instanceGroupManagerAggregatedList", + "description": "Output only. The resource type, which is alwayscompute#instanceGroupManagerAggregatedList for an aggregated\nlist of managed instance groups.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "Output only. This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "readOnly": true, + "type": "string" + }, + "selfLink": { + "description": "Output only. Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "unreachables": { + "description": "Output only. Unreachable resources.", + "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 the list of managed instance groups that are contained within the specified region." + "readOnly": true, + "type": "array" }, - "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, + "warning": { + "description": "Output only. Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "region": { - "description": "Name of the region scoping this request.", - "location": "path", - "required": true, + "data": { + "description": "[Output Only] Metadata about this warning in key:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" + }, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project", - "region", - "instanceGroupManager" - ], - "response": { - "$ref": "InstanceGroupManager" + "readOnly": true, + "type": "object" + } + }, + "type": "object" + }, + "InstanceGroupManagerAllInstancesConfig": { + "id": "InstanceGroupManagerAllInstancesConfig", + "properties": { + "properties": { + "$ref": "InstancePropertiesPatch", + "description": "Properties to set on all instances in the group.\n\nYou can add or modify properties using theinstanceGroupManagers.patch orregionInstanceGroupManagers.patch. After settingallInstancesConfig on the group, you must update the group's\ninstances to apply the configuration. To apply the configuration, set the\ngroup's updatePolicy.type field to use proactive updates or\nuse the applyUpdatesToInstances method." + } + }, + "type": "object" + }, + "InstanceGroupManagerAutoHealingPolicy": { + "id": "InstanceGroupManagerAutoHealingPolicy", + "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\ninitialize and run its startup script. During a VM's initial delay\nperiod, the MIG ignores unsuccessful health checks because the VM might\nbe in the startup process. This prevents the MIG from prematurely\nrecreating a VM. If the health check receives a healthy response during\nthe initial delay, it indicates that the startup process is complete and\nthe VM is ready. The value of initial delay must be between 0 and 3600\nseconds. The default value is 0.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, + "InstanceGroupManagerInstanceFlexibilityPolicy": { + "id": "InstanceGroupManagerInstanceFlexibilityPolicy", + "properties": { + "instanceSelections": { + "additionalProperties": { + "$ref": "InstanceGroupManagerInstanceFlexibilityPolicyInstanceSelection" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "description": "Named instance selections configuring properties that the group will use\nwhen creating new VMs.", + "type": "object" + } + }, + "type": "object" + }, + "InstanceGroupManagerInstanceFlexibilityPolicyInstanceSelection": { + "id": "InstanceGroupManagerInstanceFlexibilityPolicyInstanceSelection", + "properties": { + "machineTypes": { + "description": "Full machine-type names, e.g. \"n1-standard-16\".", + "items": { + "type": "string" + }, + "type": "array" + }, + "rank": { + "description": "Preference of this instance selection. Lower number means higher\npreference. MIG will first try to create a VM based on the machine-type\nwith lowest rank and fallback to next rank based on availability.\nMachine types and instance selections with the same rank have the same\npreference.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, + "InstanceGroupManagerInstanceLifecyclePolicy": { + "id": "InstanceGroupManagerInstanceLifecyclePolicy", + "properties": { + "defaultActionOnFailure": { + "description": "The action that a MIG performs on a failed VM. If the value of the\nonFailedHealthCheck field is `DEFAULT_ACTION`, then the same action also\napplies to the VMs on which your application fails a health check.\nValid values are \n \n - REPAIR (default): MIG automatically repairs a failed VM\n by recreating it. For more information, see About\n repairing VMs in a MIG.\n - DO_NOTHING: MIG does not repair a failed VM.", + "enum": [ + "DO_NOTHING", + "REPAIR" + ], + "enumDescriptions": [ + "MIG does not repair a failed VM.", + "(default): MIG automatically repairs a failed VM by recreating it.\nFor more information, see About\nrepairing VMs in a MIG." ], - "description": "Returns all of the details about the specified managed instance group." + "type": "string" }, - "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" + "forceUpdateOnRepair": { + "description": "A bit indicating whether to forcefully apply the group's latest\nconfiguration when repairing a VM. Valid options are:\n\n \n \n - NO (default): If configuration updates are available, they are not\n forcefully applied during repair. Instead, configuration updates are\n applied according to the group's update policy.\n \n - YES: If configuration updates are available, they are applied\n during repair.", + "enum": [ + "NO", + "YES" ], - "request": { + "enumDescriptions": [ + "", + "" + ], + "type": "string" + }, + "onFailedHealthCheck": { + "description": "The action that a MIG performs on an unhealthy VM. A VM is marked as\nunhealthy when the application running on that VM fails a health check.\nValid values are:\n \n - DEFAULT_ACTION (default): MIG uses the same action\n configured for instanceLifecyclePolicy.defaultActionOnFailure field.\n - REPAIR: MIG automatically repairs an unhealthy VM by\n recreating it.\n - DO_NOTHING: MIG doesn't repair an unhealthy VM.\n For more information, see \n About repairing VMs in a MIG.", + "enum": [ + "DEFAULT_ACTION", + "DO_NOTHING", + "REPAIR" + ], + "enumDescriptions": [ + "(Default) MIG uses the same action configured for\ninstanceLifecyclePolicy.defaultActionOnFailure field.", + "MIG doesn't repair an unhealthy VM.", + "MIG automatically repairs an unhealthy VM by recreating it." + ], + "type": "string" + }, + "onRepair": { + "$ref": "InstanceGroupManagerInstanceLifecyclePolicyOnRepair", + "description": "Configuration for VM repairs in the MIG." + } + }, + "type": "object" + }, + "InstanceGroupManagerInstanceLifecyclePolicyOnRepair": { + "description": "Configuration for VM repairs in the MIG.", + "id": "InstanceGroupManagerInstanceLifecyclePolicyOnRepair", + "properties": { + "allowChangingZone": { + "description": "Specifies whether the MIG can change a VM's zone during a repair.\nValid values are:\n \n - NO (default): MIG cannot change a VM's zone during a\n repair.\n - YES: MIG can select a different zone for the VM during\n a repair.", + "enum": [ + "NO", + "YES" + ], + "enumDescriptions": [ + "[Default] MIG cannot change a VM's zone during a repair.", + "MIG can select a different zone for the VM during a repair." + ], + "type": "string" + } + }, + "type": "object" + }, + "InstanceGroupManagerList": { + "description": "[Output Only] A list of managed instance groups.", + "id": "InstanceGroupManagerList", + "properties": { + "id": { + "description": "Output only. Unique identifier for the resource; defined by the server.", + "readOnly": true, + "type": "string" + }, + "items": { + "description": "A list of InstanceGroupManager resources.", + "items": { "$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." + "type": "array" }, - "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, + "kind": { + "default": "compute#instanceGroupManagerList", + "description": "Output only. The resource type, which is always compute#instanceGroupManagerList for a\nlist of managed instance groups.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "Output only. This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "readOnly": true, + "type": "string" + }, + "selfLink": { + "description": "Output only. Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "warning": { + "description": "Output only. Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. 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" } }, - "parameterOrder": [ - "project", - "region", - "instanceGroupManager" - ], - "request": { - "$ref": "InstanceGroupManager" + "readOnly": true, + "type": "object" + } + }, + "type": "object" + }, + "InstanceGroupManagerResizeRequest": { + "description": "InstanceGroupManagerResizeRequest represents a request to create\na number of VMs: either immediately or by queuing the request for the\nspecified time. This resize request is nested under InstanceGroupManager\nand the VMs created by this request are added to the owning\nInstanceGroupManager.", + "id": "InstanceGroupManagerResizeRequest", + "properties": { + "creationTimestamp": { + "description": "Output only. The creation timestamp for this resize request inRFC3339\ntext format.", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "An optional description of this resource.", + "type": "string" + }, + "id": { + "description": "Output only. A unique identifier for this resource type. The server generates this\nidentifier.", + "format": "uint64", + "readOnly": true, + "type": "string" + }, + "instances": { + "description": "The names of instances to be created by this resize request. The number of\nnames specified determines the number of instances to create. The group's\ntarget size will be increased by this number. This field cannot be used\ntogether with 'resize_by'.", + "items": { + "$ref": "PerInstanceConfig" }, - "response": { - "$ref": "Operation" + "type": "array" + }, + "kind": { + "default": "compute#instanceGroupManagerResizeRequest", + "description": "Output only. The resource type, which is alwayscompute#instanceGroupManagerResizeRequest for resize requests.", + "readOnly": true, + "type": "string" + }, + "name": { + "annotations": { + "required": [ + "compute.instanceGroupManagerResizeRequests.insert" + ] }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "description": "The name of this resize request. The name must be 1-63 characters\nlong, and comply withRFC1035.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "region": { + "description": "Output only. The URL of a region\nwhere the resize request is located. Populated only for regional resize\nrequests.", + "readOnly": true, + "type": "string" + }, + "requestedRunDuration": { + "$ref": "Duration", + "description": "Requested run duration for instances that will be created by this request.\nAt the end of the run duration instance will be deleted." + }, + "resizeBy": { + "description": "The number of instances to be created by this resize request. The group's\ntarget size will be increased by this number. This field cannot be used\ntogether with 'instances'.", + "format": "int32", + "type": "integer" + }, + "selfLink": { + "description": "Output only. The URL for this resize request. The server defines this URL.", + "readOnly": true, + "type": "string" + }, + "selfLinkWithId": { + "description": "Output only. Server-defined URL for this resource with the resource id.", + "readOnly": true, + "type": "string" + }, + "state": { + "description": "Output only. Current state of the request.", + "enum": [ + "ACCEPTED", + "CANCELLED", + "CREATING", + "FAILED", + "STATE_UNSPECIFIED", + "SUCCEEDED" ], - "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." + "enumDescriptions": [ + "The request was created successfully and was accepted for provisioning\nwhen 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\nduring provisioning, any VMs that were created during provisioning are\nrolled back and removed from the MIG.", + "Default value. This value should never be returned.", + "The request succeeded." + ], + "readOnly": true, + "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" + "status": { + "$ref": "InstanceGroupManagerResizeRequestStatus", + "description": "Output only. Status of the request.", + "readOnly": true + }, + "zone": { + "description": "Output only. The URL of a zone\nwhere the resize request is located. Populated only for zonal resize\nrequests.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "InstanceGroupManagerResizeRequestStatus": { + "id": "InstanceGroupManagerResizeRequestStatus", + "properties": { + "error": { + "description": "Output only. Fatal errors encountered during the queueing or provisioning phases of\nthe ResizeRequest that caused the transition to the FAILED state.\nContrary to the last_attempt errors, this field is final and errors are\nnever removed from here, as the ResizeRequest is not going to retry.", + "properties": { + "errors": { + "description": "[Output Only] The array of errors encountered while processing this\noperation.", + "items": { + "description": "Represents a single error encountered during the processing of an\noperation.", + "properties": { + "code": { + "description": "[Output Only] The error type identifier for this error.", + "type": "string" + }, + "errorDetails": { + "description": "[Output Only] An optional list of messages that contain the error\ndetails. There is a set of defined message types to use for providing\ndetails.The syntax depends on the error code. For example,\nQuotaExceededInfo will have details when the error code is\nQUOTA_EXCEEDED.", + "items": { + "description": "Container for structured error details providing additional context\nspecific to the encountered error code.", + "properties": { + "errorInfo": { + "$ref": "ErrorInfo", + "description": "Error information containing structured domain, reason, and metadata." + }, + "help": { + "$ref": "Help", + "description": "Links and information to help the user resolve the error." + }, + "localizedMessage": { + "$ref": "LocalizedMessage", + "description": "A localized human-readable error message intended for end users." + }, + "quotaInfo": { + "$ref": "QuotaExceededInfo", + "description": "Details about quota limits and metrics when a quota is exceeded." + } + }, + "type": "object" + }, + "type": "array" + }, + "location": { + "description": "[Output Only] Indicates the field in the request that caused the error.\nThis property is optional.", + "type": "string" + }, + "message": { + "description": "[Output Only] An optional, human-readable error message.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" } }, - "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." + "readOnly": true, + "type": "object" }, - "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" + "lastAttempt": { + "$ref": "InstanceGroupManagerResizeRequestStatusLastAttempt", + "description": "Output only. Information about the last attempt to fulfill the request. The value is\ntemporary since the ResizeRequest can retry, as long as it's still active\nand the last attempt value can either be cleared or replaced with a\ndifferent error. Since ResizeRequest retries infrequently, the value may\nbe stale and no longer show an active problem. The value is cleared when\nResizeRequest transitions to the final state (becomes inactive). If the\nfinal state is FAILED the error describing it will be stored in the\n\"error\" field only.", + "readOnly": true + } + }, + "type": "object" + }, + "InstanceGroupManagerResizeRequestStatusLastAttempt": { + "id": "InstanceGroupManagerResizeRequestStatusLastAttempt", + "properties": { + "error": { + "description": "Output only. Errors that prevented the ResizeRequest to be fulfilled.", + "properties": { + "errors": { + "description": "[Output Only] The array of errors encountered while processing this\noperation.", + "items": { + "description": "Represents a single error encountered during the processing of an\noperation.", + "properties": { + "code": { + "description": "[Output Only] The error type identifier for this error.", + "type": "string" + }, + "errorDetails": { + "description": "[Output Only] An optional list of messages that contain the error\ndetails. There is a set of defined message types to use for providing\ndetails.The syntax depends on the error code. For example,\nQuotaExceededInfo will have details when the error code is\nQUOTA_EXCEEDED.", + "items": { + "description": "Container for structured error details providing additional context\nspecific to the encountered error code.", + "properties": { + "errorInfo": { + "$ref": "ErrorInfo", + "description": "Error information containing structured domain, reason, and metadata." + }, + "help": { + "$ref": "Help", + "description": "Links and information to help the user resolve the error." + }, + "localizedMessage": { + "$ref": "LocalizedMessage", + "description": "A localized human-readable error message intended for end users." + }, + "quotaInfo": { + "$ref": "QuotaExceededInfo", + "description": "Details about quota limits and metrics when a quota is exceeded." + } + }, + "type": "object" + }, + "type": "array" + }, + "location": { + "description": "[Output Only] Indicates the field in the request that caused the error.\nThis property is optional.", + "type": "string" + }, + "message": { + "description": "[Output Only] An optional, human-readable error message.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" } }, - "parameterOrder": [ - "project", - "region", - "instanceGroupManager" - ], - "request": { - "$ref": "RegionInstanceGroupManagersDeleteInstancesRequest" - }, - "response": { - "$ref": "Operation" + "readOnly": true, + "type": "object" + } + }, + "type": "object" + }, + "InstanceGroupManagerResizeRequestsListResponse": { + "description": "[Output Only] A list of resize requests.", + "id": "InstanceGroupManagerResizeRequestsListResponse", + "properties": { + "id": { + "description": "Output only. Unique identifier for the resource; defined by the server.", + "readOnly": true, + "type": "string" + }, + "items": { + "description": "A list of resize request resources.", + "items": { + "$ref": "InstanceGroupManagerResizeRequest" }, - "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." + "type": "array" }, - "suspendInstances": { - "id": "compute.regionInstanceGroupManagers.suspendInstances", - "path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/suspendInstances", - "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/suspendInstances", - "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, + "kind": { + "default": "compute#instanceGroupManagerResizeRequestList", + "description": "Output only. Type of the resource. Alwayscompute#instanceGroupManagerResizeRequestList for\na list of resize requests.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "Output only. This token allows you to get the next page of results for list requests.\nIf the number of results is larger than maxResults, use thenextPageToken as a value for the query parameterpageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "readOnly": true, + "type": "string" + }, + "selfLink": { + "description": "Output only. Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "warning": { + "description": "Output only. Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. 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" } }, - "parameterOrder": [ - "project", - "region", - "instanceGroupManager" + "readOnly": true, + "type": "object" + } + }, + "type": "object" + }, + "InstanceGroupManagerResourcePolicies": { + "id": "InstanceGroupManagerResourcePolicies", + "properties": { + "workloadPolicy": { + "description": "The URL of the workload policy that is specified for this managed\ninstance group.\nIt can be a full or partial URL. For example, the following are\nall valid URLs to a workload policy: \n \n \n - https://www.googleapis.com/compute/v1/projects/project/regions/region/resourcePolicies/resourcePolicy\n - projects/project/regions/region/resourcePolicies/resourcePolicy\n - regions/region/resourcePolicies/resourcePolicy", + "type": "string" + } + }, + "type": "object" + }, + "InstanceGroupManagerStandbyPolicy": { + "id": "InstanceGroupManagerStandbyPolicy", + "properties": { + "initialDelaySec": { + "description": "Specifies the number of seconds that the MIG should wait to suspend or\nstop a VM after that VM was created. The initial delay gives the\ninitialization script the time to prepare your VM for a quick scale out.\nThe value of initial delay must be between 0 and 3600 seconds. The\ndefault value is 0.", + "format": "int32", + "type": "integer" + }, + "mode": { + "description": "Defines how a MIG resumes or starts VMs from a standby pool when the\ngroup scales out. The default mode is `MANUAL`.", + "enum": [ + "MANUAL", + "SCALE_OUT_POOL" ], - "request": { - "$ref": "RegionInstanceGroupManagersSuspendInstancesRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "MIG does not automatically resume or start VMs in the standby pool when\nthe group scales out.", + "MIG automatically resumes or starts VMs in the standby pool when the\ngroup scales out, and replenishes the standby pool afterwards." ], - "description": "Flags the specified instances in the managed instance group to be immediately suspended. You can only specify instances that are running in this request. This method reduces the targetSize and increases the targetSuspendedSize of the managed instance group by the number of instances that you suspend. The suspendInstances operation is marked DONE if the suspendInstances request is successful. The underlying actions take additional time. You must separately verify the status of the SUSPENDING action with the listmanagedinstances method. If the standbyPolicy.initialDelaySec field is set, the group delays suspension of the instances until initialDelaySec have passed from instance.creationTimestamp (that is, when the instance was created). This delay gives your application time to set itself up and initialize on the instance. If more than initialDelaySec seconds have passed since instance.creationTimestamp when this method is called, there will be zero delay. 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 suspended. Suspended instances can be resumed using the resumeInstances method. You can specify a maximum of 1000 instances with this method per request." + "type": "string" + } + }, + "type": "object" + }, + "InstanceGroupManagerStatus": { + "id": "InstanceGroupManagerStatus", + "properties": { + "allInstancesConfig": { + "$ref": "InstanceGroupManagerStatusAllInstancesConfig", + "description": "Output only. Status of all-instances configuration on the group.", + "readOnly": true }, - "resumeInstances": { - "id": "compute.regionInstanceGroupManagers.resumeInstances", - "path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/resumeInstances", - "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/resumeInstances", - "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" - } + "appliedAcceleratorTopologies": { + "description": "Output only. The accelerator topology applied to this MIG.\nCurrently only one accelerator topology is supported.", + "items": { + "$ref": "InstanceGroupManagerStatusAcceleratorTopology" }, - "parameterOrder": [ - "project", - "region", - "instanceGroupManager" + "readOnly": true, + "type": "array" + }, + "autoscaler": { + "description": "Output only. The URL of theAutoscaler\nthat targets this instance group manager.", + "readOnly": true, + "type": "string" + }, + "bulkInstanceOperation": { + "$ref": "InstanceGroupManagerStatusBulkInstanceOperation", + "description": "Output only. The status of bulk instance operation.", + "readOnly": true + }, + "currentInstanceStatuses": { + "$ref": "InstanceGroupManagerStatusInstanceStatusSummary", + "description": "Output only. The list of instance statuses and the number of instances\nin this managed instance group that have the status. Currently only shown\nfor TPU MIGs", + "readOnly": true + }, + "isStable": { + "description": "Output only. A bit indicating whether the managed instance group is in a\nstable state. A stable state means that: none of the instances in the\nmanaged instance group is currently undergoing any type of change (for\nexample, creation, restart, or deletion); no future changes are scheduled\nfor instances in the managed instance group; and the managed instance\ngroup itself is not being modified.", + "readOnly": true, + "type": "boolean" + }, + "stateful": { + "$ref": "InstanceGroupManagerStatusStateful", + "description": "Output only. Stateful status of the given Instance Group Manager.", + "readOnly": true + }, + "versionTarget": { + "$ref": "InstanceGroupManagerStatusVersionTarget", + "description": "Output only. A status of consistency of Instances' versions with their\ntarget version specified by version field on Instance Group\nManager.", + "readOnly": true + } + }, + "type": "object" + }, + "InstanceGroupManagerStatusAcceleratorTopology": { + "id": "InstanceGroupManagerStatusAcceleratorTopology", + "properties": { + "acceleratorTopology": { + "description": "Output only. Topology in the format of: \"16x16\", \"4x4x4\", etc.\nThe value is the same as configured in the WorkloadPolicy.", + "readOnly": true, + "type": "string" + }, + "state": { + "description": "Output only. The state of the accelerator topology.", + "enum": [ + "ACTIVATING", + "ACTIVE", + "DEACTIVATING", + "FAILED", + "INCOMPLETE", + "REACTIVATING" ], - "request": { - "$ref": "RegionInstanceGroupManagersResumeInstancesRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "The accelerator topology is being activated.", + "The accelerator topology is active.", + "The accelerator topology is being deactivated.", + "The accelerator topology failed.", + "The configuration is incomplete and the accelerator topology cannot\nbe activated due to insufficient number of running VMs.", + "The accelerator topology is being reactivated." ], - "description": "Flags the specified instances in the managed instance group to be resumed. This method increases the targetSize and decreases the targetSuspendedSize of the managed instance group by the number of instances that you resume. The resumeInstances operation is marked DONE if the resumeInstances request is successful. The underlying actions take additional time. You must separately verify the status of the RESUMING action with the listmanagedinstances method. In this request, you can only specify instances that are suspended. For example, if an instance was previously suspended using the suspendInstances method, it can be resumed using the resumeInstances method. If a health check is attached to the managed instance group, the specified instances will be verified as healthy after they are resumed. You can specify a maximum of 1000 instances with this method per request." + "readOnly": true, + "type": "string" }, - "stopInstances": { - "id": "compute.regionInstanceGroupManagers.stopInstances", - "path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/stopInstances", - "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/stopInstances", - "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" + "stateDetails": { + "$ref": "InstanceGroupManagerStatusAcceleratorTopologyAcceleratorTopologyStateDetails", + "description": "Output only. The result of the latest accelerator topology state\ncheck.", + "readOnly": true + } + }, + "type": "object" + }, + "InstanceGroupManagerStatusAcceleratorTopologyAcceleratorTopologyStateDetails": { + "id": "InstanceGroupManagerStatusAcceleratorTopologyAcceleratorTopologyStateDetails", + "properties": { + "error": { + "description": "Output only. Encountered errors.", + "properties": { + "errors": { + "description": "[Output Only] The array of errors encountered while processing this\noperation.", + "items": { + "description": "Represents a single error encountered during the processing of an\noperation.", + "properties": { + "code": { + "description": "[Output Only] The error type identifier for this error.", + "type": "string" + }, + "errorDetails": { + "description": "[Output Only] An optional list of messages that contain the error\ndetails. There is a set of defined message types to use for providing\ndetails.The syntax depends on the error code. For example,\nQuotaExceededInfo will have details when the error code is\nQUOTA_EXCEEDED.", + "items": { + "description": "Container for structured error details providing additional context\nspecific to the encountered error code.", + "properties": { + "errorInfo": { + "$ref": "ErrorInfo", + "description": "Error information containing structured domain, reason, and metadata." + }, + "help": { + "$ref": "Help", + "description": "Links and information to help the user resolve the error." + }, + "localizedMessage": { + "$ref": "LocalizedMessage", + "description": "A localized human-readable error message intended for end users." + }, + "quotaInfo": { + "$ref": "QuotaExceededInfo", + "description": "Details about quota limits and metrics when a quota is exceeded." + } + }, + "type": "object" + }, + "type": "array" + }, + "location": { + "description": "[Output Only] Indicates the field in the request that caused the error.\nThis property is optional.", + "type": "string" + }, + "message": { + "description": "[Output Only] An optional, human-readable error message.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" } }, - "parameterOrder": [ - "project", - "region", - "instanceGroupManager" - ], - "request": { - "$ref": "RegionInstanceGroupManagersStopInstancesRequest" - }, - "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 stopped. You can only specify instances that are running in this request. This method reduces the targetSize and increases the targetStoppedSize of the managed instance group by the number of instances that you stop. The stopInstances operation is marked DONE if the stopInstances request is successful. The underlying actions take additional time. You must separately verify the status of the STOPPING action with the listmanagedinstances method. If the standbyPolicy.initialDelaySec field is set, the group delays stopping the instances until initialDelaySec have passed from instance.creationTimestamp (that is, when the instance was created). This delay gives your application time to set itself up and initialize on the instance. If more than initialDelaySec seconds have passed since instance.creationTimestamp when this method is called, there will be zero delay. 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 stopped. Stopped instances can be started using the startInstances method. You can specify a maximum of 1000 instances with this method per request." + "readOnly": true, + "type": "object" }, - "startInstances": { - "id": "compute.regionInstanceGroupManagers.startInstances", - "path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/startInstances", - "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/startInstances", - "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" + "timestamp": { + "description": "Output only. Timestamp is shown only if there is an error. The field\nhas // RFC3339 //\ntext format.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "InstanceGroupManagerStatusAllInstancesConfig": { + "id": "InstanceGroupManagerStatusAllInstancesConfig", + "properties": { + "currentRevision": { + "description": "Output only. Current all-instances configuration revision.\nThis value is in RFC3339 text format.", + "readOnly": true, + "type": "string" + }, + "effective": { + "description": "Output only. A bit indicating whether this configuration has\nbeen applied to all managed instances in the group.", + "readOnly": true, + "type": "boolean" + } + }, + "type": "object" + }, + "InstanceGroupManagerStatusBulkInstanceOperation": { + "description": "Bulk instance operation is the creation of VMs in a MIG when the\ntargetSizePolicy.mode is set to BULK.", + "id": "InstanceGroupManagerStatusBulkInstanceOperation", + "properties": { + "inProgress": { + "description": "Output only. Informs whether bulk instance operation is in progress.", + "readOnly": true, + "type": "boolean" + }, + "lastProgressCheck": { + "$ref": "InstanceGroupManagerStatusBulkInstanceOperationLastProgressCheck", + "description": "Output only. Information from the last progress check of bulk instance\noperation.", + "readOnly": true + } + }, + "type": "object" + }, + "InstanceGroupManagerStatusBulkInstanceOperationLastProgressCheck": { + "id": "InstanceGroupManagerStatusBulkInstanceOperationLastProgressCheck", + "properties": { + "error": { + "description": "Output only. Errors encountered during bulk instance operation.", + "properties": { + "errors": { + "description": "[Output Only] The array of errors encountered while processing this\noperation.", + "items": { + "description": "Represents a single error encountered during the processing of an\noperation.", + "properties": { + "code": { + "description": "[Output Only] The error type identifier for this error.", + "type": "string" + }, + "errorDetails": { + "description": "[Output Only] An optional list of messages that contain the error\ndetails. There is a set of defined message types to use for providing\ndetails.The syntax depends on the error code. For example,\nQuotaExceededInfo will have details when the error code is\nQUOTA_EXCEEDED.", + "items": { + "description": "Container for structured error details providing additional context\nspecific to the encountered error code.", + "properties": { + "errorInfo": { + "$ref": "ErrorInfo", + "description": "Error information containing structured domain, reason, and metadata." + }, + "help": { + "$ref": "Help", + "description": "Links and information to help the user resolve the error." + }, + "localizedMessage": { + "$ref": "LocalizedMessage", + "description": "A localized human-readable error message intended for end users." + }, + "quotaInfo": { + "$ref": "QuotaExceededInfo", + "description": "Details about quota limits and metrics when a quota is exceeded." + } + }, + "type": "object" + }, + "type": "array" + }, + "location": { + "description": "[Output Only] Indicates the field in the request that caused the error.\nThis property is optional.", + "type": "string" + }, + "message": { + "description": "[Output Only] An optional, human-readable error message.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" } }, - "parameterOrder": [ - "project", - "region", - "instanceGroupManager" + "readOnly": true, + "type": "object" + }, + "timestamp": { + "description": "Output only. Timestamp of the last progress check of bulk instance\noperation. Timestamp is in RFC3339 text format.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "InstanceGroupManagerStatusInstanceStatusSummary": { + "description": "The list of instance statuses and the number of instances in this managed\ninstance group that have the status. For more information about how to\ninterpret each status check the instance lifecycle documentation.\nCurrently only shown for TPU MIGs.", + "id": "InstanceGroupManagerStatusInstanceStatusSummary", + "properties": { + "deprovisioning": { + "description": "Output only. The number of instances in the managed instance group\nthat have DEPROVISIONING status.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "nonExistent": { + "description": "Output only. The number of instances that have not been created yet or\nhave been deleted. Includes only instances that would be shown in the\nlistManagedInstances method and not all instances that have been\ndeleted in the lifetime of the MIG.\nDoes not include FlexStart instances that are waiting for the resources\navailability, they are considered as 'pending'.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "pending": { + "description": "Output only. The number of instances in the managed instance group\nthat have PENDING status, that is FlexStart instances that are waiting\nfor resources. Instances that do not exist because of the other reasons\nare counted as 'non_existent'.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "pendingStop": { + "description": "Output only. The number of instances in the managed instance group\nthat have PENDING_STOP status.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "provisioning": { + "description": "Output only. The number of instances in the managed instance group\nthat have PROVISIONING status.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "repairing": { + "description": "Output only. The number of instances in the managed instance group\nthat have REPAIRING status.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "running": { + "description": "Output only. The number of instances in the managed instance group\nthat have RUNNING status.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "staging": { + "description": "Output only. The number of instances in the managed instance group\nthat have STAGING status.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "stopped": { + "description": "Output only. The number of instances in the managed instance group\nthat have STOPPED status.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "stopping": { + "description": "Output only. The number of instances in the managed instance group\nthat have STOPPING status.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "suspended": { + "description": "Output only. The number of instances in the managed instance group\nthat have SUSPENDED status.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "suspending": { + "description": "Output only. The number of instances in the managed instance group\nthat have SUSPENDING status.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "terminated": { + "description": "Output only. The number of instances in the managed instance group\nthat have TERMINATED status.", + "format": "int32", + "readOnly": true, + "type": "integer" + } + }, + "type": "object" + }, + "InstanceGroupManagerStatusStateful": { + "id": "InstanceGroupManagerStatusStateful", + "properties": { + "hasStatefulConfig": { + "description": "Output only. A bit indicating whether the managed instance group\nhas stateful configuration, that is, if you have configured any items\nin a stateful policy or in per-instance configs.\nThe group might report that it has no stateful configuration even when\nthere is still some preserved state on a managed instance, for example,\nif you have deleted all PICs but not yet applied those deletions.", + "readOnly": true, + "type": "boolean" + }, + "perInstanceConfigs": { + "$ref": "InstanceGroupManagerStatusStatefulPerInstanceConfigs", + "description": "Output only. Status of per-instance configurations on the instances.", + "readOnly": true + } + }, + "type": "object" + }, + "InstanceGroupManagerStatusStatefulPerInstanceConfigs": { + "id": "InstanceGroupManagerStatusStatefulPerInstanceConfigs", + "properties": { + "allEffective": { + "description": "Output only. A bit indicating if all of the group's per-instance configurations\n(listed in the output of a listPerInstanceConfigs API call) have\nstatus EFFECTIVE or there are no per-instance-configs.", + "readOnly": true, + "type": "boolean" + } + }, + "type": "object" + }, + "InstanceGroupManagerStatusVersionTarget": { + "id": "InstanceGroupManagerStatusVersionTarget", + "properties": { + "isReached": { + "description": "Output only. A bit indicating whether version target has been reached\nin this managed instance group, i.e. all instances are in their target\nversion. Instances' target version are specified byversion field on Instance Group Manager.", + "readOnly": true, + "type": "boolean" + } + }, + "type": "object" + }, + "InstanceGroupManagerTargetSizePolicy": { + "id": "InstanceGroupManagerTargetSizePolicy", + "properties": { + "mode": { + "description": "The mode of target size policy based on which the MIG creates its VMs\nindividually or all at once.", + "enum": [ + "BULK", + "INDIVIDUAL", + "UNSPECIFIED_MODE" + ], + "enumDescriptions": [ + "The mode in which the MIG creates VMs all at once. In this mode, if the\nMIG is unable to create even one VM, the MIG waits until all VMs can be\ncreated at the same time.", + "The mode in which the MIG creates VMs individually. In this mode, if\nthe MIG is unable to create a VM, the MIG will continue to create the\nother VMs in the group. This is the default mode.", + "If mode is unspecified, MIG will behave as in the default `INDIVIDUAL`\nmode." + ], + "type": "string" + } + }, + "type": "object" + }, + "InstanceGroupManagerUpdatePolicy": { + "id": "InstanceGroupManagerUpdatePolicy", + "properties": { + "instanceRedistributionType": { + "description": "The \ninstance redistribution policy for regional managed instance groups.\nValid values are: \n \n - PROACTIVE (default): The group attempts to maintain an\n even distribution of VM instances across zones in the region.\n - NONE: For non-autoscaled groups, proactive\n redistribution is disabled.", + "enum": [ + "NONE", + "PROACTIVE" ], - "request": { - "$ref": "RegionInstanceGroupManagersStartInstancesRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "No action is being proactively performed in order to bring this IGM\nto its target instance distribution.", + "This IGM will actively converge to its target instance distribution." ], - "description": "Flags the specified instances in the managed instance group to be started. This method increases the targetSize and decreases the targetStoppedSize of the managed instance group by the number of instances that you start. The startInstances operation is marked DONE if the startInstances request is successful. The underlying actions take additional time. You must separately verify the status of the STARTING action with the listmanagedinstances method. In this request, you can only specify instances that are stopped. For example, if an instance was previously stopped using the stopInstances method, it can be started using the startInstances method. If a health check is attached to the managed instance group, the specified instances will be verified as healthy after they are started. You can specify a maximum of 1000 instances with this method per request." + "type": "string" }, - "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" + "maxSurge": { + "$ref": "FixedOrPercent", + "description": "The maximum number of instances that can be created above the specifiedtargetSize during the update process. This value can be\neither a fixed number or, if the group has 10 or more instances, a\npercentage. If you set a percentage, the number of instances is rounded\nif necessary. The default value for maxSurge is a fixed\nvalue equal to the number of zones in which the managed instance group\noperates.\n\nAt least one of either maxSurge ormaxUnavailable must be greater than 0. Learn more about maxSurge." + }, + "maxUnavailable": { + "$ref": "FixedOrPercent", + "description": "The maximum number of instances that can be unavailable during the update\nprocess. An instance is considered available if all of the following\nconditions are satisfied:\n\n \n \n - The instance's status is\n RUNNING. \n - If there is a health\n check on the instance group, the instance's health check status\n must be HEALTHY at least once. If there is no health check\n on the group, then the instance only needs to have a status of\n RUNNING to be considered available.\n\n\nThis value can be either a fixed number or, if the group has 10 or more\ninstances, a percentage. If you set a percentage, the number of instances\nis rounded if necessary. The default value formaxUnavailable is a fixed value equal to the number of zones\nin which the managed instance group operates.\n\nAt least one of either maxSurge ormaxUnavailable must be greater than 0. Learn more about maxUnavailable." + }, + "minimalAction": { + "description": "Minimal action to be taken on an instance. Use this option to minimize\ndisruption as much as possible or to apply a more disruptive action than\nis necessary.\n \n - To limit disruption as much as possible, set the minimal action toREFRESH. If your update requires a more disruptive action,\n Compute Engine performs the necessary action to execute the update.\n - To apply a more disruptive action than is strictly necessary, set the\n minimal action to RESTART or REPLACE. For\n example, Compute Engine does not need to restart a VM to change its\n metadata. But if your application reads instance metadata only when a VM\n is restarted, you can set the minimal action to RESTART in\n order to pick up metadata changes.", + "enum": [ + "NONE", + "REFRESH", + "REPLACE", + "RESTART" ], - "request": { - "$ref": "RegionInstanceGroupManagersAbandonInstancesRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "Do not perform any action.", + "Do not stop the instance.", + "(Default.) Replace the instance according to the replacement method\noption.", + "Stop the instance and start it again." ], - "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." + "type": "string" }, - "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" + "mostDisruptiveAllowedAction": { + "description": "Most disruptive action that is allowed to be taken on an instance.\nYou can specify either NONE to forbid any actions,REFRESH to avoid restarting the VM and to limit disruption\nas much as possible. RESTART to allow actions that can be\napplied without instance replacing or REPLACE to allow all\npossible actions. If the Updater determines that the minimal update\naction needed is more disruptive than most disruptive allowed action you\nspecify it will not perform the update at all.", + "enum": [ + "NONE", + "REFRESH", + "REPLACE", + "RESTART" ], - "request": { - "$ref": "RegionInstanceGroupManagersRecreateRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "Do not perform any action.", + "Do not stop the instance.", + "(Default.) Replace the instance according to the replacement method\noption.", + "Stop the instance and start it again." ], - "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." + "type": "string" }, - "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" + "replacementMethod": { + "description": "What action should be used to replace instances.\nSee minimal_action.REPLACE", + "enum": [ + "RECREATE", + "SUBSTITUTE" ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "Instances will be recreated (with the same name)", + "Default option: instances will be deleted and created (with a new name)" ], - "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." + "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" + "type": { + "description": "The type\nof update process. You can specify either PROACTIVE so\nthat the MIG automatically updates VMs to the latest configurations orOPPORTUNISTIC so that you can select the VMs that you want\nto update.", + "enum": [ + "OPPORTUNISTIC", + "PROACTIVE" ], - "request": { - "$ref": "RegionInstanceGroupManagersSetTemplateRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "MIG will apply new configurations\nto existing VMs only when you selectively target specific or all VMs to\nbe updated.", + "MIG will automatically apply new configurations\nto all or a subset of existing VMs and also to new VMs that are added\nto the group." ], - "description": "Sets the instance template to use when creating new instances or recreating instances in this group. Existing instances are not affected." + "type": "string" + } + }, + "type": "object" + }, + "InstanceGroupManagerVersion": { + "id": "InstanceGroupManagerVersion", + "properties": { + "instanceTemplate": { + "description": "The URL of the instance template that is specified for this managed\ninstance group. The group uses this template to create new instances in\nthe managed instance group until the `targetSize` for this version is\nreached. The templates for existing instances in the group do not change\nunless you run recreateInstances, runapplyUpdatesToInstances, or set the group'supdatePolicy.type to PROACTIVE; in those cases,\nexisting instances are updated until the `targetSize` for this version is\nreached.", + "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" + "name": { + "description": "Name of the version. Unique among all versions in the scope of this\nmanaged instance group.", + "type": "string" + }, + "targetSize": { + "$ref": "FixedOrPercent", + "description": "Specifies the intended number of instances to be created from theinstanceTemplate. The final number of instances created\nfrom the template will be equal to:\n \n \n - If expressed as a fixed number, the minimum of either\n targetSize.fixed or\n instanceGroupManager.targetSize is used.\n - if expressed as a percent, the targetSize\n would be (targetSize.percent/100 *\n InstanceGroupManager.targetSize) If there is a remainder, the\n number is rounded.\n \n If unset, this version will update any remaining instances not\nupdated by another version. ReadStarting\na canary update for more information." + } + }, + "type": "object" + }, + "InstanceGroupManagersAbandonInstancesRequest": { + "id": "InstanceGroupManagersAbandonInstancesRequest", + "properties": { + "instances": { + "description": "The URLs of one or more instances to abandon. This can be a full URL or\na partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].", + "items": { + "type": "string" }, - "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." + "type": "array" + } + }, + "type": "object" + }, + "InstanceGroupManagersApplyUpdatesRequest": { + "description": "InstanceGroupManagers.applyUpdatesToInstances", + "id": "InstanceGroupManagersApplyUpdatesRequest", + "properties": { + "allInstances": { + "description": "Flag to update all instances instead of specified list of \"instances\".\nIf the flag is set to true then the instances may not be specified\nin the request.", + "type": "boolean" }, - "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" - } + "instances": { + "description": "The list of URLs of one or more instances for which you want to apply\nupdates. Each URL can be a full URL or a partial URL, such aszones/[ZONE]/instances/[INSTANCE_NAME].", + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "region", - "instanceGroupManager" + "type": "array" + }, + "minimalAction": { + "description": "The minimal action that you want to perform on each instance during the\nupdate:\n \n \n - REPLACE: At minimum, delete the instance and create it\n again. \n - RESTART: Stop the instance and start it\n again. \n - REFRESH: Do not stop the instance and limit\n disruption as much as possible. \n - NONE: Do not\n disrupt the instance at all.\n\n\nBy default, the minimum action is NONE. If your update\nrequires a more disruptive action than you set with this flag, the\nnecessary action is performed to execute the update.", + "enum": [ + "NONE", + "REFRESH", + "REPLACE", + "RESTART" ], - "response": { - "$ref": "RegionInstanceGroupManagersListInstancesResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "Do not perform any action.", + "Do not stop the instance.", + "(Default.) Replace the instance according to the replacement method\noption.", + "Stop the instance and start it again." ], - "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`." + "type": "string" }, - "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" + "mostDisruptiveAllowedAction": { + "description": "The most disruptive action that you want to perform on each instance during\nthe update:\n \n \n - REPLACE: Delete the instance and create it again.\n - RESTART: Stop the instance and start it again.\n - REFRESH: Do not stop the instance and limit disruption\n as much as possible. \n - NONE: Do not disrupt the\n instance at all.\n\n\nBy default, the most disruptive allowed action is REPLACE. If\nyour update requires a more disruptive action than you set with this flag,\nthe update request will fail.", + "enum": [ + "NONE", + "REFRESH", + "REPLACE", + "RESTART" ], - "response": { - "$ref": "RegionInstanceGroupManagersListErrorsResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "Do not perform any action.", + "Do not stop the instance.", + "(Default.) Replace the instance according to the replacement method\noption.", + "Stop the instance and start it again." ], - "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" - }, - "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" - } + "type": "string" + } + }, + "type": "object" + }, + "InstanceGroupManagersCreateInstancesRequest": { + "description": "InstanceGroupManagers.createInstances", + "id": "InstanceGroupManagersCreateInstancesRequest", + "properties": { + "instances": { + "description": "[Required] List of specifications of per-instance configs.", + "items": { + "$ref": "PerInstanceConfig" }, - "parameterOrder": [ - "project", - "region", - "instanceGroupManager" - ], - "response": { - "$ref": "RegionInstanceGroupManagersListInstanceConfigsResp" + "type": "array" + } + }, + "type": "object" + }, + "InstanceGroupManagersDeleteInstancesRequest": { + "id": "InstanceGroupManagersDeleteInstancesRequest", + "properties": { + "instances": { + "description": "The URLs of one or more instances to delete. This can be a full URL or\na partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].\nQueued instances do not have URL and can be deleted only by name.\nOne cannot specify both URLs and names in a single request.", + "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": "Lists all of the per-instance configurations defined for the managed instance group. The orderBy query parameter is not supported." + "type": "array" }, - "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" - } + "skipInstancesOnValidationError": { + "description": "Specifies whether the request should proceed despite the inclusion of\ninstances that are not members of the group or that are already in the\nprocess of being deleted or abandoned. If this field is set to `false` and\nsuch an instance is specified in the request, the operation fails. The\noperation always fails if the request contains a malformed instance URL or\na reference to an instance that exists in a zone or region other than the\ngroup's zone or region.", + "type": "boolean" + } + }, + "type": "object" + }, + "InstanceGroupManagersDeletePerInstanceConfigsReq": { + "description": "InstanceGroupManagers.deletePerInstanceConfigs", + "id": "InstanceGroupManagersDeletePerInstanceConfigsReq", + "properties": { + "names": { + "description": "The list of instance names for which we want to delete per-instance configs\non this managed instance group.", + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "region", - "instanceGroupManager" - ], - "request": { - "$ref": "RegionInstanceGroupManagerUpdateInstanceConfigReq" + "type": "array" + } + }, + "type": "object" + }, + "InstanceGroupManagersListErrorsResponse": { + "id": "InstanceGroupManagersListErrorsResponse", + "properties": { + "items": { + "description": "Output only. The list of errors of the managed instance group.", + "items": { + "$ref": "InstanceManagedByIgmError" }, - "response": { - "$ref": "Operation" + "readOnly": true, + "type": "array" + }, + "nextPageToken": { + "description": "Output only. This token allows you to get the next page of results for list requests.\nIf the number of results is larger than maxResults\n, then use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "InstanceGroupManagersListManagedInstancesResponse": { + "id": "InstanceGroupManagersListManagedInstancesResponse", + "properties": { + "managedInstances": { + "description": "Output only. [Output Only] The list of instances in the managed instance group.", + "items": { + "$ref": "ManagedInstance" }, - "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." + "readOnly": true, + "type": "array" }, - "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, + "nextPageToken": { + "description": "Output only. [Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "InstanceGroupManagersListPerInstanceConfigsResp": { + "id": "InstanceGroupManagersListPerInstanceConfigsResp", + "properties": { + "items": { + "description": "Output only. [Output Only] The list of PerInstanceConfig.", + "items": { + "$ref": "PerInstanceConfig" + }, + "readOnly": true, + "type": "array" + }, + "nextPageToken": { + "description": "Output only. [Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "readOnly": true, + "type": "string" + }, + "warning": { + "description": "Output only. [Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "region": { - "description": "Name of the region scoping this request, should conform to RFC1035.", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. 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" } }, - "parameterOrder": [ - "project", - "region", - "instanceGroupManager" - ], - "request": { - "$ref": "RegionInstanceGroupManagerPatchInstanceConfigReq" + "readOnly": true, + "type": "object" + } + }, + "type": "object" + }, + "InstanceGroupManagersPatchPerInstanceConfigsReq": { + "description": "InstanceGroupManagers.patchPerInstanceConfigs", + "id": "InstanceGroupManagersPatchPerInstanceConfigsReq", + "properties": { + "perInstanceConfigs": { + "description": "The list of per-instance configurations to insert or patch on this managed\ninstance group.", + "items": { + "$ref": "PerInstanceConfig" }, - "response": { - "$ref": "Operation" + "type": "array" + } + }, + "type": "object" + }, + "InstanceGroupManagersRecreateInstancesRequest": { + "id": "InstanceGroupManagersRecreateInstancesRequest", + "properties": { + "instances": { + "description": "The URLs of one or more instances to recreate. This can be a full URL or\na partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].", + "items": { + "type": "string" }, - "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." + "type": "array" + } + }, + "type": "object" + }, + "InstanceGroupManagersResumeInstancesRequest": { + "id": "InstanceGroupManagersResumeInstancesRequest", + "properties": { + "instances": { + "description": "The URLs of one or more instances to resume. This can be a full URL or\na partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, + "InstanceGroupManagersScopedList": { + "id": "InstanceGroupManagersScopedList", + "properties": { + "instanceGroupManagers": { + "description": "Output only. The list of managed instance groups that are contained in the specified\nproject and zone.", + "items": { + "$ref": "InstanceGroupManager" + }, + "readOnly": true, + "type": "array" }, - "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, + "warning": { + "description": "Output only. The warning that replaces the list of managed instance groups when the list\nis empty.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "region": { - "description": "Name of the region scoping this request, should conform to RFC1035.", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project", - "region", - "instanceGroupManager" - ], - "request": { - "$ref": "RegionInstanceGroupManagerDeleteInstanceConfigReq" + "readOnly": true, + "type": "object" + } + }, + "type": "object" + }, + "InstanceGroupManagersSetInstanceTemplateRequest": { + "id": "InstanceGroupManagersSetInstanceTemplateRequest", + "properties": { + "instanceTemplate": { + "description": "The URL of the instance template that is specified for this managed\ninstance group. The group uses this template to create all new instances\nin the managed instance group. The templates for existing instances in the\ngroup do not change unless you run recreateInstances, runapplyUpdatesToInstances, or set the group'supdatePolicy.type to PROACTIVE.", + "type": "string" + } + }, + "type": "object" + }, + "InstanceGroupManagersSetTargetPoolsRequest": { + "id": "InstanceGroupManagersSetTargetPoolsRequest", + "properties": { + "fingerprint": { + "description": "The fingerprint of the target pools information. Use this optional\nproperty to prevent conflicts when multiple users change the target pools\nsettings concurrently. Obtain the fingerprint with theinstanceGroupManagers.get\nmethod. Then, include the fingerprint in your request to ensure that you\ndo not overwrite changes that were applied from another\nconcurrent request.", + "format": "byte", + "type": "string" + }, + "targetPools": { + "description": "The list of target pool URLs that instances in this managed instance group\nbelong to. The managed instance group applies these target pools to all\nof the instances in the group. Existing instances and new instances in the\ngroup all receive these target pool settings.", + "items": { + "type": "string" }, - "response": { - "$ref": "Operation" + "type": "array" + } + }, + "type": "object" + }, + "InstanceGroupManagersStartInstancesRequest": { + "id": "InstanceGroupManagersStartInstancesRequest", + "properties": { + "instances": { + "description": "The URLs of one or more instances to start. This can be a full URL or\na partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].", + "items": { + "type": "string" }, - "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." + "type": "array" + } + }, + "type": "object" + }, + "InstanceGroupManagersStopInstancesRequest": { + "id": "InstanceGroupManagersStopInstancesRequest", + "properties": { + "forceStop": { + "description": "If this flag is set to true, the Instance Group Manager will proceed to\nstop the instances, skipping initialization on them.", + "type": "boolean" }, - "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" - } + "instances": { + "description": "The URLs of one or more instances to stop. This can be a full URL or\na partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].", + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "region", - "instanceGroupManager" - ], - "request": { - "$ref": "RegionInstanceGroupManagersApplyUpdatesRequest" + "type": "array" + } + }, + "type": "object" + }, + "InstanceGroupManagersSuspendInstancesRequest": { + "id": "InstanceGroupManagersSuspendInstancesRequest", + "properties": { + "forceSuspend": { + "description": "If this flag is set to true, the Instance Group Manager will proceed to\nsuspend the instances, skipping initialization on them.", + "type": "boolean" + }, + "instances": { + "description": "The URLs of one or more instances to suspend. This can be a full URL or\na partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].", + "items": { + "type": "string" }, - "response": { - "$ref": "Operation" + "type": "array" + } + }, + "type": "object" + }, + "InstanceGroupManagersUpdatePerInstanceConfigsReq": { + "description": "InstanceGroupManagers.updatePerInstanceConfigs", + "id": "InstanceGroupManagersUpdatePerInstanceConfigsReq", + "properties": { + "perInstanceConfigs": { + "description": "The list of per-instance configurations to insert or patch on this managed\ninstance group.", + "items": { + "$ref": "PerInstanceConfig" + }, + "type": "array" + } + }, + "type": "object" + }, + "InstanceGroupsAddInstancesRequest": { + "id": "InstanceGroupsAddInstancesRequest", + "properties": { + "instances": { + "description": "The list of instances to add to the instance group.", + "items": { + "$ref": "InstanceReference" + }, + "type": "array" + } + }, + "type": "object" + }, + "InstanceGroupsListInstances": { + "id": "InstanceGroupsListInstances", + "properties": { + "id": { + "description": "Output only. [Output Only] Unique identifier for the resource; defined by the server.", + "readOnly": true, + "type": "string" + }, + "items": { + "description": "A list of InstanceWithNamedPorts resources.", + "items": { + "$ref": "InstanceWithNamedPorts" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Apply updates to selected instances the managed instance group." + "type": "array" }, - "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, + "kind": { + "default": "compute#instanceGroupsListInstances", + "description": "Output only. [Output Only] The resource type, which is alwayscompute#instanceGroupsListInstances for the list of instances\nin the specified instance group.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "Output only. [Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "readOnly": true, + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "warning": { + "description": "Output only. [Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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" + "data": { + "description": "[Output Only] Metadata about this warning in key:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same 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", + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project", - "region", - "instanceGroupManager" + "readOnly": true, + "type": "object" + } + }, + "type": "object" + }, + "InstanceGroupsListInstancesRequest": { + "id": "InstanceGroupsListInstancesRequest", + "properties": { + "instanceState": { + "description": "A filter for the state of the instances in the instance group. Valid\noptions are ALL or RUNNING. If you do not specify\nthis parameter the list includes all instances regardless of their state.", + "enum": [ + "ALL", + "RUNNING" ], - "request": { - "$ref": "RegionInstanceGroupManagersCreateInstancesRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "Includes all instances in the generated list regardless of their state.", + "Includes instances in the generated list only if they have a RUNNING\nstate." ], - "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." + "type": "string" } - } + }, + "type": "object" }, - "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" - } + "InstanceGroupsRemoveInstancesRequest": { + "id": "InstanceGroupsRemoveInstancesRequest", + "properties": { + "instances": { + "description": "The list of instances to remove from the instance group.", + "items": { + "$ref": "InstanceReference" }, - "parameterOrder": [ - "project", - "zone" - ], - "response": { - "$ref": "AutoscalerList" + "type": "array" + } + }, + "type": "object" + }, + "InstanceGroupsScopedList": { + "id": "InstanceGroupsScopedList", + "properties": { + "instanceGroups": { + "description": "Output only. [Output Only] The list ofinstance\ngroups that are contained in this scope.", + "items": { + "$ref": "InstanceGroup" }, - "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." + "readOnly": true, + "type": "array" }, - "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", + "warning": { + "description": "Output only. [Output Only] An informational warning that replaces the list of\ninstance groups when the list is empty.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "pageToken": { - "description": "Specifies a page token 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{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" } }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "AutoscalerAggregatedList" + "readOnly": true, + "type": "object" + } + }, + "type": "object" + }, + "InstanceGroupsSetNamedPortsRequest": { + "id": "InstanceGroupsSetNamedPortsRequest", + "properties": { + "fingerprint": { + "description": "The fingerprint of the named ports information for this instance group.\nUse this optional property to prevent conflicts when multiple users change\nthe named ports settings concurrently. Obtain the fingerprint with theinstanceGroups.get\nmethod. Then, include the fingerprint in your request to ensure that you\ndo not overwrite changes that were applied from another concurrent request.\nA request with an incorrect fingerprint will fail with error412 conditionNotMet.", + "format": "byte", + "type": "string" + }, + "namedPorts": { + "description": "The list of named ports to set for this instance group.", + "items": { + "$ref": "NamedPort" }, - "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`." + "type": "array" + } + }, + "type": "object" + }, + "InstanceList": { + "description": "Contains a list of instances.", + "id": "InstanceList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "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, + "items": { + "description": "A list of Instance resources.", + "items": { + "$ref": "Instance" + }, + "type": "array" + }, + "kind": { + "default": "compute#instanceList", + "description": "Output only. [Output Only] Type of resource. Always compute#instanceList\nfor lists of Instance resources.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "zone": { - "description": "Name of the zone 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" } }, - "parameterOrder": [ - "project", - "zone", - "autoscaler" - ], - "response": { - "$ref": "Autoscaler" + "type": "object" + } + }, + "type": "object" + }, + "InstanceListReferrers": { + "description": "Contains a list of instance referrers.", + "id": "InstanceListReferrers", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of Reference resources.", + "items": { + "$ref": "Reference" }, - "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." + "type": "array" }, - "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, + "kind": { + "default": "compute#instanceListReferrers", + "description": "Output only. [Output Only] Type of resource. Alwayscompute#instanceListReferrers for lists of Instance referrers.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "zone": { - "description": "Name of the zone 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" } }, - "parameterOrder": [ - "project", - "zone" + "type": "object" + } + }, + "type": "object" + }, + "InstanceManagedByIgmError": { + "id": "InstanceManagedByIgmError", + "properties": { + "error": { + "$ref": "InstanceManagedByIgmErrorManagedInstanceError", + "description": "Output only. Contents of the error.", + "readOnly": true + }, + "instanceActionDetails": { + "$ref": "InstanceManagedByIgmErrorInstanceActionDetails", + "description": "Output only. Details of the instance action that triggered this error.\nMay be null, if the error was not caused by an action on an instance.\nThis field is optional.", + "readOnly": true + }, + "timestamp": { + "description": "Output only. The time that this error occurred. This value is in RFC3339 text format.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "InstanceManagedByIgmErrorInstanceActionDetails": { + "id": "InstanceManagedByIgmErrorInstanceActionDetails", + "properties": { + "action": { + "description": "Output only. Action that managed instance group was executing on the instance when the\nerror occurred. Possible values:", + "enum": [ + "ABANDONING", + "CREATING", + "CREATING_WITHOUT_RETRIES", + "DELETING", + "NONE", + "RECREATING", + "REFRESHING", + "RESTARTING", + "RESUMING", + "STARTING", + "STOPPING", + "SUSPENDING", + "VERIFYING" ], - "request": { - "$ref": "Autoscaler" + "enumDescriptions": [ + "The managed instance group is abandoning this instance. The instance\nwill be removed from the instance group and from any target pools that\nare associated with this group.", + "The managed instance group is creating this instance. If the group\nfails to create this instance, it will try again until it is\nsuccessful.", + "The managed instance group is attempting to create this instance\nonly once. If the group fails to create this instance, it does\nnot try again and the group's targetSize value is\ndecreased.", + "The managed instance group is permanently deleting this instance.", + "The managed instance group has not scheduled any actions for this\ninstance.", + "The managed instance group is recreating this instance.", + "The managed instance group is applying configuration changes to the\ninstance without stopping it. For example, the group can update the\ntarget 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.\nVerification happens every time the instance is (re)created or restarted\nand consists of:\n 1. Waiting until health check specified as part of this managed instance\n group's autohealing policy reports HEALTHY.\n Note: Applies only if autohealing policy has a health check specified\n 2. Waiting for addition verification steps performed as post-instance\n creation (subject to future extensions)." + ], + "readOnly": true, + "type": "string" + }, + "instance": { + "description": "Output only. The URL of the instance. The URL can be set even if the instance has not\nyet been created.", + "readOnly": true, + "type": "string" + }, + "version": { + "$ref": "ManagedInstanceVersion", + "description": "Output only. Version this instance was created from, or was being\ncreated from, but the creation failed. Corresponds to one of the versions\nthat were set on the Instance Group Manager resource at the time this\ninstance was being created.", + "readOnly": true + } + }, + "type": "object" + }, + "InstanceManagedByIgmErrorManagedInstanceError": { + "id": "InstanceManagedByIgmErrorManagedInstanceError", + "properties": { + "code": { + "description": "Output only. Error code.", + "readOnly": true, + "type": "string" + }, + "message": { + "description": "Output only. Error message.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "InstanceMoveRequest": { + "id": "InstanceMoveRequest", + "properties": { + "destinationZone": { + "description": "The URL of the destination zone to move the instance. This can be a full or\npartial URL. For example, the following are all valid URLs to a zone:\n \n - https://www.googleapis.com/compute/v1/projects/project/zones/zone \n - projects/project/zones/zone \n - zones/zone", + "type": "string" + }, + "targetInstance": { + "description": "The URL of the target instance to move. This can be a full or partial URL.\nFor example, the following are all valid URLs to an instance:\n \n - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/instance \n - projects/project/zones/zone/instances/instance \n - zones/zone/instances/instance", + "type": "string" + } + }, + "type": "object" + }, + "InstanceParams": { + "description": "Additional instance params.", + "id": "InstanceParams", + "properties": { + "requestValidForDuration": { + "$ref": "Duration", + "description": "Relative deadline for waiting for capacity. Relevant only for\nInstances.Insert API." + }, + "resourceManagerTags": { + "additionalProperties": { + "type": "string" }, - "response": { - "$ref": "Operation" + "description": "Input only. Resource manager tags to be bound to the instance. Tag keys and values\nhave the same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in\nnamespaced format such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT &\nPATCH) when empty.", + "type": "object" + } + }, + "type": "object" + }, + "InstanceProperties": { + "id": "InstanceProperties", + "properties": { + "advancedMachineFeatures": { + "$ref": "AdvancedMachineFeatures", + "description": "Controls for advanced machine-related behavior features.\nNote that for MachineImage, this is not supported yet." + }, + "canIpForward": { + "description": "Enables instances created based on these properties to send packets with\nsource IP addresses other than their own and receive packets with\ndestination IP addresses other than their own. If these instances will be\nused as an IP gateway or it will be set as the next-hop in a Route\nresource, specify true. If unsure, leave this set tofalse. See theEnable IP forwarding\ndocumentation for more information.", + "type": "boolean" + }, + "confidentialInstanceConfig": { + "$ref": "ConfidentialInstanceConfig", + "description": "Specifies the Confidential Instance options.\nNote that for MachineImage, this is not supported yet." + }, + "description": { + "description": "An optional text description for the instances that are created from these\nproperties.", + "type": "string" + }, + "disks": { + "description": "An array of disks that are associated with the instances that are created\nfrom these properties.", + "items": { + "$ref": "AttachedDisk" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "type": "array" + }, + "guestAccelerators": { + "description": "A list of guest accelerator cards' type and count to use for instances\ncreated from these properties.", + "items": { + "$ref": "AcceleratorConfig" + }, + "type": "array" + }, + "keyRevocationActionType": { + "description": "KeyRevocationActionType of the instance. Supported options are \"STOP\" and\n\"NONE\". The default value is \"NONE\" if it is not specified.", + "enum": [ + "KEY_REVOCATION_ACTION_TYPE_UNSPECIFIED", + "NONE", + "STOP" + ], + "enumDescriptions": [ + "Default value. This value is unused.", + "Indicates user chose no operation.", + "Indicates user chose to opt for VM shutdown on key revocation." ], - "description": "Creates an autoscaler in the specified project using the data included in the request." + "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" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request 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" - } + "labels": { + "additionalProperties": { + "type": "string" }, - "parameterOrder": [ - "project", - "zone" + "description": "Labels to apply to instances that are created from these properties.", + "type": "object" + }, + "localSsdEncryptionMode": { + "description": "Specifies which method should be used for encrypting the\nLocal SSDs attached to the VM.", + "enum": [ + "EPHEMERAL_KEY_ENCRYPTION", + "LOCAL_SSD_ENCRYPTION_MODE_UNSPECIFIED", + "STANDARD_ENCRYPTION" ], - "request": { - "$ref": "Autoscaler" + "enumDescriptions": [ + "The given VM will opt-in for using ephemeral key for\nencryption of Local SSDs.\nThe Local SSDs will not be able to recover data in case of VM\ncrash.", + "The given VM will be encrypted using keys managed by the cloud\ninfrastructure and the keys will be deleted when the VM is\ndeleted.", + "The given VM will be encrypted using keys managed by the cloud\ninfrastructure and the keys will be deleted when the VM is\ndeleted." + ], + "type": "string" + }, + "machineType": { + "annotations": { + "required": [ + "compute.instanceTemplates.insert" + ] }, - "response": { - "$ref": "Operation" + "description": "The machine type to use for instances that are created from these\nproperties.\nThis field only accepts a machine type name, for example `n2-standard-4`.\nIf you use the machine type full or partial URL, for example\n`projects/my-l7ilb-project/zones/us-central1-a/machineTypes/n2-standard-4`,\nthe request will result in an `INTERNAL_ERROR`.", + "type": "string" + }, + "metadata": { + "$ref": "Metadata", + "description": "The metadata key/value pairs to assign to instances that are created from\nthese properties. These pairs can consist of custom metadata or predefined\nkeys. SeeProject and\ninstance metadata for more information." + }, + "minCpuPlatform": { + "description": "Minimum cpu/platform to be used by instances. The instance may be\nscheduled on the specified or newer cpu/platform. Applicable values are the\nfriendly names of CPU platforms, such asminCpuPlatform: \"Intel Haswell\" orminCpuPlatform: \"Intel Sandy Bridge\". For more\ninformation, read Specifying a\nMinimum CPU Platform.", + "type": "string" + }, + "networkInterfaces": { + "description": "An array of network access configurations for this interface.", + "items": { + "$ref": "NetworkInterface" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "type": "array" + }, + "networkPerformanceConfig": { + "$ref": "NetworkPerformanceConfig", + "description": "Note that for MachineImage, this is not supported yet." + }, + "privateIpv6GoogleAccess": { + "description": "The private IPv6 google access type for VMs.\nIf not specified, use INHERIT_FROM_SUBNETWORK as default.\nNote that for MachineImage, this is not supported yet.", + "enum": [ + "ENABLE_BIDIRECTIONAL_ACCESS_TO_GOOGLE", + "ENABLE_OUTBOUND_VM_ACCESS_TO_GOOGLE", + "INHERIT_FROM_SUBNETWORK" + ], + "enumDescriptions": [ + "Bidirectional private IPv6 access to/from Google services. If\nspecified, the subnetwork who is attached to the instance's default network\ninterface will be assigned an internal IPv6 prefix if it doesn't have\nbefore.", + "Outbound private IPv6 access from VMs in this subnet to Google services. If\nspecified, the subnetwork who is attached to the instance's default network\ninterface will be assigned an internal IPv6 prefix if it doesn't have\nbefore.", + "Each network interface inherits PrivateIpv6GoogleAccess from its\nsubnetwork." ], - "description": "Updates an autoscaler in the specified project using the data included in the request." + "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" - } + "reservationAffinity": { + "$ref": "ReservationAffinity", + "description": "Specifies the reservations that instances can consume from.\nNote that for MachineImage, this is not supported yet." + }, + "resourceManagerTags": { + "additionalProperties": { + "type": "string" }, - "parameterOrder": [ - "project", - "zone" - ], - "request": { - "$ref": "Autoscaler" + "description": "Input only. Resource manager tags to be bound to the instance. Tag keys and values\nhave the same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in\nnamespaced format such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT &\nPATCH) when empty.", + "type": "object" + }, + "resourcePolicies": { + "description": "Resource policies (names, not URLs) applied to instances created from\nthese properties.\nNote that for MachineImage, this is not supported yet.", + "items": { + "type": "string" }, - "response": { - "$ref": "Operation" + "type": "array" + }, + "scheduling": { + "$ref": "Scheduling", + "description": "Specifies the scheduling options for the instances that are created from\nthese properties." + }, + "serviceAccounts": { + "description": "A list of service accounts with specified scopes. Access tokens for these\nservice accounts are available to the instances that are created from\nthese properties. Use metadata queries to obtain the access tokens for\nthese instances.", + "items": { + "$ref": "ServiceAccount" }, - "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." + "type": "array" }, - "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" - } + "shieldedInstanceConfig": { + "$ref": "ShieldedInstanceConfig", + "description": "Note that for MachineImage, this is not supported yet." + }, + "tags": { + "$ref": "Tags", + "description": "A list of tags to apply to the instances that are created from these\nproperties. The tags identify valid sources or targets for network\nfirewalls. The setTags method can modify this list of tags. Each tag within\nthe list must comply with RFC1035." + }, + "workloadIdentityConfig": { + "$ref": "WorkloadIdentityConfig" + } + }, + "type": "object" + }, + "InstancePropertiesPatch": { + "description": "Represents the change that you want to make to the instance properties.", + "id": "InstancePropertiesPatch", + "properties": { + "labels": { + "additionalProperties": { + "type": "string" }, - "parameterOrder": [ - "project", - "zone", - "autoscaler" - ], - "response": { - "$ref": "Operation" + "description": "The label key-value pairs that you want to patch onto the instance.", + "type": "object" + }, + "metadata": { + "additionalProperties": { + "type": "string" + }, + "description": "The metadata key-value pairs that you want to patch onto the instance. For\nmore information, see Project and\ninstance metadata.", + "type": "object" + } + }, + "type": "object" + }, + "InstanceReference": { + "id": "InstanceReference", + "properties": { + "instance": { + "description": "The URL for a specific instance.\n@required compute.instancegroups.addInstances/removeInstances", + "type": "string" + } + }, + "type": "object" + }, + "InstanceSettings": { + "description": "Represents a Instance Settings resource. You can use instance settings to\nconfigure default settings for Compute Engine VM instances. For example, you\ncan use it to configure default machine type of Compute Engine VM instances.", + "id": "InstanceSettings", + "properties": { + "fingerprint": { + "description": "Specifies a fingerprint for instance settings, which is essentially a hash\nof the instance settings resource's contents and used for optimistic\nlocking. The fingerprint is initially generated by Compute Engine and\nchanges after every request to modify or update the instance settings\nresource. You must always provide an up-to-date fingerprint hash in order\nto update or change the resource, otherwise the request will fail with\nerror 412 conditionNotMet.\n\nTo see the latest fingerprint, make a get() request to\nretrieve the resource.", + "format": "byte", + "type": "string" + }, + "kind": { + "default": "compute#instanceSettings", + "description": "Output only. [Output Only] Type of the resource. Alwayscompute#instance_settings for instance settings.", + "readOnly": true, + "type": "string" + }, + "metadata": { + "$ref": "InstanceSettingsMetadata", + "description": "The metadata key/value pairs assigned to all the instances in the\ncorresponding scope." + }, + "zone": { + "description": "Output only. [Output Only] URL of the zone where the resource resides\nYou must specify this field as part of the HTTP request URL. It is not\nsettable as a field in the request body.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "InstanceSettingsMetadata": { + "id": "InstanceSettingsMetadata", + "properties": { + "items": { + "additionalProperties": { + "type": "string" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified autoscaler." + "description": "A metadata key/value items map.\nThe total size of all keys and values must be less than 512KB.", + "type": "object" + }, + "kind": { + "default": "compute#metadata", + "description": "Output only. [Output Only] Type of the resource. Always compute#metadata\nfor metadata.", + "readOnly": true, + "type": "string" } - } + }, + "type": "object" }, - "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" - } + "InstanceTemplate": { + "description": "Represents an Instance Template resource.\n\nGoogle Compute Engine has two Instance Template resources:\n\n* [Global](/compute/docs/reference/rest/v1/instanceTemplates)\n* [Regional](/compute/docs/reference/rest/v1/regionInstanceTemplates)\n\nYou can reuse a global instance template in\ndifferent regions whereas you can use a regional instance template in a\nspecified region only. If you want to reduce cross-region dependency or\nachieve data residency, use a regional instance template.\n\nTo create VMs, managed instance groups, and reservations, you can use either\nglobal or regional instance templates.\n\nFor more information, readInstance Templates.", + "id": "InstanceTemplate", + "properties": { + "creationTimestamp": { + "description": "Output only. [Output Only] The creation timestamp for this instance template inRFC3339\ntext format.", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you\ncreate the resource.", + "type": "string" + }, + "id": { + "description": "Output only. [Output Only] A unique identifier for this instance template. The server\ndefines this identifier.", + "format": "uint64", + "readOnly": true, + "type": "string" + }, + "kind": { + "default": "compute#instanceTemplate", + "description": "Output only. [Output Only] The resource type, which is alwayscompute#instanceTemplate for instance templates.", + "readOnly": true, + "type": "string" + }, + "name": { + "annotations": { + "required": [ + "compute.instanceTemplates.insert" + ] }, - "parameterOrder": [ - "project", - "region" - ], - "response": { - "$ref": "RegionAutoscalerList" + "description": "Name of the resource; provided by the client when the resource is created.\nThe name must be 1-63 characters long, and comply withRFC1035.\nSpecifically, the name must be 1-63 characters long and match the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first\ncharacter must be a lowercase letter, and all following characters must be\na dash, lowercase letter, or digit, except the last character, which cannot\nbe a dash.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "properties": { + "$ref": "InstanceProperties", + "description": "The instance properties for this instance template." + }, + "region": { + "description": "Output only. [Output Only] URL of the region where the instance template resides. Only\napplicable for regional resources.", + "readOnly": true, + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] The URL for this instance template. The server defines this\nURL.", + "readOnly": true, + "type": "string" + }, + "sourceInstance": { + "description": "The source instance used to create the template. You can provide this as a\npartial or full URL to the resource. For example, the following are valid\nvalues:\n \n \n - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/instance \n - projects/project/zones/zone/instances/instance", + "type": "string" + }, + "sourceInstanceParams": { + "$ref": "SourceInstanceParams", + "description": "The source instance params to use to create this instance template." + } + }, + "type": "object" + }, + "InstanceTemplateAggregatedList": { + "description": "Contains a list of InstanceTemplatesScopedList.", + "id": "InstanceTemplateAggregatedList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "additionalProperties": { + "$ref": "InstanceTemplatesScopedList", + "description": "The name of the scope that contains this set of instance templates." }, - "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." + "description": "A list of InstanceTemplatesScopedList resources.", + "type": "object" }, - "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, + "kind": { + "default": "compute#instanceTemplateAggregatedList", + "description": "Output only. Type of resource.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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" } }, - "parameterOrder": [ - "project", - "region", - "autoscaler" - ], - "response": { - "$ref": "Autoscaler" + "type": "object" + } + }, + "type": "object" + }, + "InstanceTemplateList": { + "description": "A list of instance templates.", + "id": "InstanceTemplateList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of InstanceTemplate resources.", + "items": { + "$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 autoscaler." + "type": "array" }, - "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, + "kind": { + "default": "compute#instanceTemplateList", + "description": "Output only. [Output Only] The resource type, which is alwayscompute#instanceTemplatesListResponse for instance template\nlists.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. 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" } }, - "parameterOrder": [ - "project", - "region" - ], - "request": { - "$ref": "Autoscaler" - }, - "response": { - "$ref": "Operation" + "type": "object" + } + }, + "type": "object" + }, + "InstanceTemplatesScopedList": { + "id": "InstanceTemplatesScopedList", + "properties": { + "instanceTemplates": { + "description": "[Output Only] A list of instance templates that are contained within\nthe specified project and zone.", + "items": { + "$ref": "InstanceTemplate" }, - "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." + "type": "array" }, - "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, + "warning": { + "description": "[Output Only] An informational warning that replaces the list of instance\ntemplates when the list is empty.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. 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" } }, - "parameterOrder": [ - "project", - "region" + "type": "object" + } + }, + "type": "object" + }, + "InstanceWithNamedPorts": { + "id": "InstanceWithNamedPorts", + "properties": { + "instance": { + "description": "Output only. [Output Only] The URL of the instance.", + "readOnly": true, + "type": "string" + }, + "namedPorts": { + "description": "Output only. [Output Only] The named ports that belong to this instance group.", + "items": { + "$ref": "NamedPort" + }, + "readOnly": true, + "type": "array" + }, + "status": { + "description": "Output only. [Output Only] The status of the instance.", + "enum": [ + "DEPROVISIONING", + "PENDING", + "PENDING_STOP", + "PROVISIONING", + "REPAIRING", + "RUNNING", + "STAGING", + "STOPPED", + "STOPPING", + "SUSPENDED", + "SUSPENDING", + "TERMINATED" ], - "request": { - "$ref": "Autoscaler" + "enumDescriptions": [ + "The instance is halted and we are performing tear down tasks like network\ndeprogramming, releasing quota, IP, tearing down disks etc.", + "For Flex Start provisioning instance is waiting for available capacity\nfrom Dynamic Workload Scheduler (DWS).", + "The instance is gracefully shutting down.", + "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\nis 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\nfailure)." + ], + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "InstancesAddResourcePoliciesRequest": { + "id": "InstancesAddResourcePoliciesRequest", + "properties": { + "resourcePolicies": { + "description": "Resource policies to be added to this instance.", + "items": { + "type": "string" }, - "response": { - "$ref": "Operation" + "type": "array" + } + }, + "type": "object" + }, + "InstancesBulkInsertOperationMetadata": { + "id": "InstancesBulkInsertOperationMetadata", + "properties": { + "perLocationStatus": { + "additionalProperties": { + "$ref": "BulkInsertOperationStatus" }, - "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.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" - } + "description": "Status information per location (location name is key).\nExample key: zones/us-central1-a", + "type": "object" + } + }, + "type": "object" + }, + "InstancesGetEffectiveFirewallsResponse": { + "id": "InstancesGetEffectiveFirewallsResponse", + "properties": { + "firewallPolicys": { + "description": "[Output Only] Effective firewalls from firewall policies.", + "items": { + "$ref": "InstancesGetEffectiveFirewallsResponseEffectiveFirewallPolicy" }, - "parameterOrder": [ - "project", - "region" - ], - "request": { - "$ref": "Autoscaler" + "type": "array" + }, + "firewalls": { + "description": "Effective firewalls on the instance.", + "items": { + "$ref": "Firewall" }, - "response": { - "$ref": "Operation" + "type": "array" + } + }, + "type": "object" + }, + "InstancesGetEffectiveFirewallsResponseEffectiveFirewallPolicy": { + "id": "InstancesGetEffectiveFirewallsResponseEffectiveFirewallPolicy", + "properties": { + "displayName": { + "deprecated": true, + "description": "Output only. [Output Only] Deprecated, please use short name instead. The display name\nof the firewall policy.", + "readOnly": true, + "type": "string" + }, + "name": { + "description": "Output only. [Output Only] The name of the firewall policy.", + "readOnly": true, + "type": "string" + }, + "packetMirroringRules": { + "description": "Output only. [Output Only] The packet mirroring rules that apply to the instance.", + "items": { + "$ref": "FirewallPolicyRule" }, - "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." + "readOnly": true, + "type": "array" }, - "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" - } + "priority": { + "description": "Output only. [Output only] Priority of firewall policy association. Not applicable for\ntype=HIERARCHY.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "rules": { + "description": "[Output Only] The rules that apply to the instance. Only rules that\ntarget the specific VM instance are returned if target service accounts\nor target secure tags are specified in the rules.", + "items": { + "$ref": "FirewallPolicyRule" }, - "parameterOrder": [ - "project", - "region", - "autoscaler" + "type": "array" + }, + "shortName": { + "description": "Output only. [Output Only] The short name of the firewall policy.", + "readOnly": true, + "type": "string" + }, + "type": { + "description": "Output only. [Output Only] The type of the firewall policy. Can be one of HIERARCHY,\nNETWORK, NETWORK_REGIONAL, SYSTEM_GLOBAL, SYSTEM_REGIONAL.", + "enum": [ + "HIERARCHY", + "NETWORK", + "NETWORK_REGIONAL", + "SYSTEM_GLOBAL", + "SYSTEM_REGIONAL", + "UNSPECIFIED" ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "", + "", + "", + "", + "", + "" ], - "description": "Deletes the specified autoscaler." + "readOnly": true, + "type": "string" } - } + }, + "type": "object" }, - "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" - } + "InstancesRemoveResourcePoliciesRequest": { + "id": "InstancesRemoveResourcePoliciesRequest", + "properties": { + "resourcePolicies": { + "description": "Resource policies to be removed from this instance.", + "items": { + "type": "string" }, - "parameterOrder": [ - "project" + "type": "array" + } + }, + "type": "object" + }, + "InstancesReportHostAsFaultyRequest": { + "id": "InstancesReportHostAsFaultyRequest", + "properties": { + "disruptionSchedule": { + "description": "The disruption schedule for the VM. Required field, only allows IMMEDIATE.", + "enum": [ + "DISRUPTION_SCHEDULE_UNSPECIFIED", + "FUTURE", + "IMMEDIATE" ], - "response": { - "$ref": "BackendBucketList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "Not used. Required as per aip/126.", + "Delay disruption for caller control. Will be default soon.", + "Default value. Disrupt the VM immediately." ], - "description": "Retrieves the list of BackendBucket resources available to the specified project." + "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" - } + "faultReasons": { + "items": { + "$ref": "InstancesReportHostAsFaultyRequestFaultReason" }, - "parameterOrder": [ - "project", - "backendBucket" + "type": "array" + } + }, + "type": "object" + }, + "InstancesReportHostAsFaultyRequestFaultReason": { + "id": "InstancesReportHostAsFaultyRequestFaultReason", + "properties": { + "behavior": { + "enum": [ + "BEHAVIOR_UNSPECIFIED", + "CHIP_ERROR", + "PERFORMANCE", + "SILENT_DATA_CORRUPTION", + "UNRECOVERABLE_GPU_ERROR" ], - "response": { - "$ref": "BackendBucket" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "Public reportable behaviors", + "Any GPU or TPU errors or faults where the accelerator becomes unusable", + "", + "", + "Unrecoverable GPU error identified by an XID" ], - "description": "Returns the specified BackendBucket 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" + "description": { + "type": "string" + } + }, + "type": "object" + }, + "InstancesScopedList": { + "id": "InstancesScopedList", + "properties": { + "instances": { + "description": "[Output Only] A list of instances contained in this scope.", + "items": { + "$ref": "Instance" }, - "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." + "type": "array" }, - "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, + "warning": { + "description": "[Output Only] Informational warning which replaces the list of instances\nwhen the list is empty.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. 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" } }, - "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." + "type": "object" + } + }, + "type": "object" + }, + "InstancesSetLabelsRequest": { + "id": "InstancesSetLabelsRequest", + "properties": { + "labelFingerprint": { + "description": "Fingerprint of the previous set of labels for this resource,\nused to prevent conflicts. Provide the latest fingerprint value when making\na request to add or change labels.", + "format": "byte", + "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" + "labels": { + "additionalProperties": { + "type": "string" }, - "response": { - "$ref": "Operation" + "type": "object" + } + }, + "type": "object" + }, + "InstancesSetMachineResourcesRequest": { + "id": "InstancesSetMachineResourcesRequest", + "properties": { + "guestAccelerators": { + "description": "A list of the type and count of accelerator cards attached to the instance.", + "items": { + "$ref": "AcceleratorConfig" }, - "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." + "type": "array" + } + }, + "type": "object" + }, + "InstancesSetMachineTypeRequest": { + "id": "InstancesSetMachineTypeRequest", + "properties": { + "machineType": { + "description": "Full or partial URL of the machine type resource. See Machine Types for a full list of\nmachine types. For example:zones/us-central1-f/machineTypes/n1-standard-1", + "type": "string" + } + }, + "type": "object" + }, + "InstancesSetMinCpuPlatformRequest": { + "id": "InstancesSetMinCpuPlatformRequest", + "properties": { + "minCpuPlatform": { + "description": "Minimum cpu/platform this instance should be started at.", + "type": "string" + } + }, + "type": "object" + }, + "InstancesSetNameRequest": { + "id": "InstancesSetNameRequest", + "properties": { + "currentName": { + "description": "The current name of this resource, used to prevent conflicts. Provide the\nlatest name when making a request to change name.", + "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" + "name": { + "description": "The name to be applied to the instance. Needs to be RFC 1035 compliant.", + "type": "string" + } + }, + "type": "object" + }, + "InstancesSetSecurityPolicyRequest": { + "id": "InstancesSetSecurityPolicyRequest", + "properties": { + "networkInterfaces": { + "description": "The network interfaces that the security policy will be applied to. Network\ninterfaces use the nicN naming format. You can only set a\nsecurity policy for network interfaces with an access config.", + "items": { + "type": "string" }, - "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." + "type": "array" }, - "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" + "securityPolicy": { + "description": "A full or partial URL to a security policy to add to this instance.\nIf this field is set to an empty string it will remove the associated\nsecurity policy.", + "type": "string" + } + }, + "type": "object" + }, + "InstancesSetServiceAccountRequest": { + "id": "InstancesSetServiceAccountRequest", + "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.", + "items": { + "type": "string" }, - "response": { - "$ref": "Operation" + "type": "array" + } + }, + "type": "object" + }, + "InstancesStartWithEncryptionKeyRequest": { + "id": "InstancesStartWithEncryptionKeyRequest", + "properties": { + "disks": { + "description": "Array of disks associated with this instance that are protected with acustomer-supplied\nencryption key.\n\nIn order to start the instance, the disk url and its corresponding key must\nbe provided.\n\nIf the disk is not protected with a customer-supplied encryption key it\nshould not be specified.", + "items": { + "$ref": "CustomerEncryptionKeyProtectedDisk" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "type": "array" + } + }, + "type": "object" + }, + "InstantSnapshot": { + "description": "Represents a InstantSnapshot resource.\n\nYou can use instant snapshots to create disk rollback points quickly..", + "id": "InstantSnapshot", + "properties": { + "architecture": { + "description": "Output only. [Output Only] The architecture of the instant snapshot. Valid values are\nARM64 or X86_64.", + "enum": [ + "ARCHITECTURE_UNSPECIFIED", + "ARM64", + "X86_64" ], - "description": "Adds a key for validating requests with signed URLs for this backend bucket." + "enumDescriptions": [ + "Default value indicating Architecture is not set.", + "Machines with architecture ARM64", + "Machines with architecture X86_64" + ], + "readOnly": true, + "type": "string" }, - "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" - } + "creationTimestamp": { + "description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you\ncreate the resource.", + "type": "string" + }, + "diskSizeGb": { + "description": "Output only. [Output Only] Size of the source disk, specified in GB.", + "format": "int64", + "readOnly": true, + "type": "string" + }, + "id": { + "description": "Output only. [Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "format": "uint64", + "readOnly": true, + "type": "string" + }, + "kind": { + "default": "compute#instantSnapshot", + "description": "Output only. [Output Only] Type of the resource. Alwayscompute#instantSnapshot for InstantSnapshot resources.", + "readOnly": true, + "type": "string" + }, + "labelFingerprint": { + "description": "A fingerprint for the labels being applied to this InstantSnapshot, which\nis essentially a hash of the labels set used for optimistic locking. The\nfingerprint is initially generated by Compute Engine and changes after\nevery request to modify or update labels. You must always provide an\nup-to-date fingerprint hash in order to update or change labels,\notherwise the request will fail with error412 conditionNotMet.\n\nTo see the latest fingerprint, make a get() request to\nretrieve a InstantSnapshot.", + "format": "byte", + "type": "string" + }, + "labels": { + "additionalProperties": { + "type": "string" }, - "parameterOrder": [ - "project", - "backendBucket", - "keyName" + "description": "Labels to apply to this InstantSnapshot. These can be later modified by\nthe setLabels method.\nLabel values may be empty.", + "type": "object" + }, + "name": { + "description": "Name of the resource; provided by the client when the resource is created.\nThe name must be 1-63 characters long, and comply withRFC1035.\nSpecifically, the name must be 1-63 characters long and match the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first\ncharacter must be a lowercase letter, and all following characters must be\na dash, lowercase letter, or digit, except the last character, which cannot\nbe a dash.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "params": { + "$ref": "InstantSnapshotParams", + "description": "Input only. Additional params passed with the request, but not persisted\nas part of resource payload." + }, + "region": { + "description": "Output only. [Output Only] URL of the region where the instant snapshot resides.\nYou must specify this field as part of the HTTP request URL. It is\nnot settable as a field in the request body.", + "readOnly": true, + "type": "string" + }, + "resourceStatus": { + "$ref": "InstantSnapshotResourceStatus", + "description": "Output only. [Output Only] Status information for the instant snapshot resource.", + "readOnly": true + }, + "satisfiesPzi": { + "description": "Output only. Reserved for future use.", + "readOnly": true, + "type": "boolean" + }, + "satisfiesPzs": { + "description": "Output only. [Output Only] Reserved for future use.", + "readOnly": true, + "type": "boolean" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for the resource.", + "readOnly": true, + "type": "string" + }, + "selfLinkWithId": { + "description": "Output only. [Output Only] Server-defined URL for this resource's resource id.", + "readOnly": true, + "type": "string" + }, + "sourceDisk": { + "description": "URL of the source disk used to create this instant snapshot.\nNote that the source disk must be in the same zone/region as the\ninstant snapshot to be created. This can be a full or valid partial URL.\nFor example, the following are valid values:\n \n \n - \n https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk\n \n - \n https://www.googleapis.com/compute/v1/projects/project/regions/region/disks/disk\n \n - \n projects/project/zones/zone/disks/disk\n \n - \n projects/project/regions/region/disks/disk\n \n - \n zones/zone/disks/disk\n \n - \n regions/region/disks/disk", + "type": "string" + }, + "sourceDiskId": { + "description": "Output only. [Output Only] The ID value of the disk used to create this InstantSnapshot.\nThis value may be used to determine whether the InstantSnapshot\nwas taken from the current or a previous instance of a given disk name.", + "readOnly": true, + "type": "string" + }, + "sourceInstantSnapshotGroup": { + "description": "Output only. [Output Only] URL of the source instant snapshot this instant snapshot is\npart of. Note that the source instant snapshot group must be in the same\nzone/region as the instant snapshot to be created. This can be a full or\nvalid partial URL.", + "readOnly": true, + "type": "string" + }, + "sourceInstantSnapshotGroupId": { + "description": "Output only. [Output Only] The ID value of the source instant snapshot group this\nInstantSnapshot is part of. This value may be used to determine whether the\nInstantSnapshot was created as part of an InstantSnapshotGroup creation.", + "readOnly": true, + "type": "string" + }, + "status": { + "description": "Output only. [Output Only] The status of the instantSnapshot. This can beCREATING, DELETING, FAILED, orREADY.", + "enum": [ + "CREATING", + "DELETING", + "FAILED", + "READY", + "UNAVAILABLE" ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "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\nDisk restoration" ], - "description": "Deletes a key for validating requests with signed URLs for this backend bucket." + "readOnly": true, + "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" + "zone": { + "description": "Output only. [Output Only] URL of the zone where the instant snapshot resides.\nYou must specify this field as part of the HTTP request URL. It is\nnot settable as a field in the request body.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "InstantSnapshotAggregatedList": { + "id": "InstantSnapshotAggregatedList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "additionalProperties": { + "$ref": "InstantSnapshotsScopedList", + "description": "[Output Only] Name of the scope containing this set of instantSnapshots." }, - "response": { - "$ref": "Operation" + "description": "A list of InstantSnapshotsScopedList resources.", + "type": "object" + }, + "kind": { + "default": "compute#instantSnapshotAggregatedList", + "description": "Output only. [Output Only] Type of resource. Alwayscompute#instantSnapshotAggregatedList for aggregated lists of\ninstantSnapshots.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "unreachables": { + "description": "Output only. [Output Only] Unreachable resources.", + "items": { + "type": "string" }, - "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." + "readOnly": true, + "type": "array" }, - "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, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" + }, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project", - "resource" + "type": "object" + } + }, + "type": "object" + }, + "InstantSnapshotGroup": { + "description": "Represents an InstantSnapshotGroup resource.\n\nAn instant snapshot group is a set of instant snapshots that represents a\npoint in time state of a consistency group.", + "id": "InstantSnapshotGroup", + "properties": { + "creationTimestamp": { + "description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "Optional. An optional description of this resource. Provide this property when you\ncreate the resource.", + "type": "string" + }, + "id": { + "description": "Output only. [Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "format": "uint64", + "readOnly": true, + "type": "string" + }, + "kind": { + "default": "compute#instantSnapshotGroup", + "description": "Output only. [Output Only] Type of the resource. Alwayscompute#instantSnapshotGroup for InstantSnapshotGroup\nresources.", + "readOnly": true, + "type": "string" + }, + "name": { + "description": "Identifier. Name of the resource; provided by the client when the resource is created.\nThe name must be 1-63 characters long, and comply withRFC1035.\nSpecifically, the name must be 1-63 characters long and match the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first\ncharacter must be a lowercase letter, and all following characters must be\na dash, lowercase letter, or digit, except the last character, which cannot\nbe a dash.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "region": { + "description": "Output only. [Output Only] URL of the region where the instant snapshot group resides.\nYou must specify this field as part of the HTTP request URL. It is\nnot settable as a field in the request body.", + "readOnly": true, + "type": "string" + }, + "resourceStatus": { + "$ref": "InstantSnapshotGroupResourceStatus", + "readOnly": true + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for the resource.", + "readOnly": true, + "type": "string" + }, + "selfLinkWithId": { + "description": "Output only. [Output Only] Server-defined URL for this resource's resource id.", + "readOnly": true, + "type": "string" + }, + "sourceConsistencyGroup": { + "type": "string" + }, + "status": { + "description": "Output only. [Output Only]", + "enum": [ + "CREATING", + "DELETING", + "FAILED", + "INVALID", + "READY", + "UNKNOWN" ], - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "", + "", + "", + "", + "", + "" ], - "description": "Gets the access control policy for a resource. May be empty if no such policy or resource exists." + "readOnly": true, + "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" + "zone": { + "description": "Output only. [Output Only] URL of the zone where the instant snapshot group resides.\nYou must specify this field as part of the HTTP request URL. It is\nnot settable as a field in the request body.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "InstantSnapshotGroupParameters": { + "id": "InstantSnapshotGroupParameters", + "properties": { + "sourceInstantSnapshotGroup": { + "description": "The source instant snapshot group used to create disks. You can provide\nthis as a partial or full URL to the resource. For example, the following\nare valid values:\n \n \n - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instantSnapshotGroups/instantSnapshotGroup\n - projects/project/zones/zone/instantSnapshotGroups/instantSnapshotGroup\n - zones/zone/instantSnapshotGroups/instantSnapshotGroup", + "type": "string" + } + }, + "type": "object" + }, + "InstantSnapshotGroupResourceStatus": { + "id": "InstantSnapshotGroupResourceStatus", + "properties": { + "consistencyMembershipResolutionTime": { + "description": "Output only. [Output Only]", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "sourceInfo": { + "$ref": "InstantSnapshotGroupSourceInfo", + "description": "Output only. [Output Only]", + "readOnly": true + } + }, + "type": "object" + }, + "InstantSnapshotGroupSourceInfo": { + "id": "InstantSnapshotGroupSourceInfo", + "properties": { + "consistencyGroup": { + "readOnly": true, + "type": "string" + }, + "consistencyGroupId": { + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "InstantSnapshotList": { + "description": "Contains a list of InstantSnapshot resources.", + "id": "InstantSnapshotList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of InstantSnapshot resources.", + "items": { + "$ref": "InstantSnapshot" }, - "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." + "type": "array" }, - "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, + "kind": { + "default": "compute#instantSnapshotList", + "description": "Output only. Type of resource.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" + }, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project", - "resource" - ], - "request": { - "$ref": "TestPermissionsRequest" - }, - "response": { - "$ref": "TestPermissionsResponse" + "type": "object" + } + }, + "type": "object" + }, + "InstantSnapshotParams": { + "description": "Additional instant snapshot params.", + "id": "InstantSnapshotParams", + "properties": { + "resourceManagerTags": { + "additionalProperties": { + "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 permissions that a caller has on the specified resource." + "description": "Input only. Resource manager tags to be bound to the instant snapshot. Tag keys and\nvalues have the same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in\nnamespaced format such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT &\nPATCH) when empty.", + "type": "object" } - } + }, + "type": "object" }, - "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", + "InstantSnapshotResourceStatus": { + "id": "InstantSnapshotResourceStatus", + "properties": { + "storageSizeBytes": { + "description": "[Output Only] The storage size of this instant snapshot.", + "format": "int64", + "type": "string" + } + }, + "type": "object" + }, + "InstantSnapshotsScopedList": { + "id": "InstantSnapshotsScopedList", + "properties": { + "instantSnapshots": { + "description": "[Output Only] A list of instantSnapshots contained in this scope.", + "items": { + "$ref": "InstantSnapshot" + }, + "type": "array" + }, + "warning": { + "description": "[Output Only] Informational warning which replaces the list of\ninstantSnapshots when the list is empty.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "pageToken": { - "description": "Specifies a page token 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{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" } }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "BackendServiceList" + "type": "object" + } + }, + "type": "object" + }, + "Int64RangeMatch": { + "description": "HttpRouteRuleMatch criteria for field values that must stay\nwithin the specified integer range.", + "id": "Int64RangeMatch", + "properties": { + "rangeEnd": { + "description": "The end of the range (exclusive) in signed long integer format.", + "format": "int64", + "type": "string" + }, + "rangeStart": { + "description": "The start of the range (inclusive) in signed long integer format.", + "format": "int64", + "type": "string" + } + }, + "type": "object" + }, + "Interconnect": { + "description": "Represents an Interconnect resource.\n\nAn Interconnect resource is a dedicated connection between the Google\nCloud network and your on-premises network. For more information, read the\nDedicated Interconnect Overview.", + "id": "Interconnect", + "properties": { + "aaiEnabled": { + "description": "Enable or disable the application awareness feature on this Cloud\nInterconnect.", + "type": "boolean" + }, + "adminEnabled": { + "description": "Administrative status of the interconnect. When this is set to true, the\nInterconnect is functional and can carry traffic.\nWhen set to false, no packets can be carried over the interconnect and\nno BGP routes are exchanged over it. By default, the status is set to true.", + "type": "boolean" + }, + "applicationAwareInterconnect": { + "$ref": "InterconnectApplicationAwareInterconnect", + "description": "Configuration information for application awareness on this Cloud\nInterconnect." + }, + "availableFeatures": { + "description": "[Output only] List of features available for this Interconnect connection,\nwhich can take one of the following values:\n \n - IF_MACSEC: If present, then the Interconnect connection is\n provisioned on MACsec capable hardware ports. If not present, then the\n Interconnect connection is provisioned on non-MACsec capable ports. Any\n attempt to enable MACsec will fail.\n - IF_CROSS_SITE_NETWORK: If present, then the Interconnect connection is\n provisioned exclusively for Cross-Site Networking. Any attempt to configure\n VLAN attachments will fail. If not present, then the Interconnect\n connection is not provisioned for Cross-Site Networking. Any attempt to use\n it for Cross-Site Networking will fail.", + "items": { + "enum": [ + "IF_CROSS_SITE_NETWORK", + "IF_L2_FORWARDING", + "IF_MACSEC" + ], + "enumDescriptions": [ + "Cross-Site Networking", + "L2 Interconnect Attachment Forwarding", + "Media Access Control security (MACsec)" + ], + "type": "string" + }, + "type": "array" + }, + "circuitInfos": { + "description": "Output only. [Output Only] A list of CircuitInfo objects, that describe the individual\ncircuits in this LAG.", + "items": { + "$ref": "InterconnectCircuitInfo" + }, + "readOnly": true, + "type": "array" + }, + "creationTimestamp": { + "description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", + "readOnly": true, + "type": "string" + }, + "customerName": { + "description": "Customer name, to put in the Letter of Authorization as the party\nauthorized to request a crossconnect.", + "type": "string" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you\ncreate the resource.", + "type": "string" + }, + "effectiveLocation": { + "description": "Output only. URL of the InterconnectLocation object that represents where\nthis connection is to be provisioned. By default it will be the same as the\nlocation field.", + "readOnly": true, + "type": "string" + }, + "expectedOutages": { + "description": "Output only. [Output Only] A list of outages expected for this Interconnect.", + "items": { + "$ref": "InterconnectOutageNotification" + }, + "readOnly": true, + "type": "array" + }, + "googleIpAddress": { + "description": "Output only. [Output Only] IP address configured on the Google side of the Interconnect\nlink. This can be used only for ping tests.", + "readOnly": true, + "type": "string" + }, + "googleReferenceId": { + "description": "Output only. [Output Only] Google reference ID to be used when raising support tickets\nwith Google or otherwise to debug backend connectivity issues.", + "readOnly": true, + "type": "string" + }, + "id": { + "description": "Output only. [Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "format": "uint64", + "readOnly": true, + "type": "string" + }, + "interconnectAttachments": { + "description": "Output only. [Output Only] A list of the URLs of all InterconnectAttachments configured\nto use this Interconnect.", + "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 the list of BackendService resources available to the specified project." + "readOnly": true, + "type": "array" }, - "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" - } + "interconnectGroups": { + "description": "Output only. [Output Only] URLs of InterconnectGroups that include this Interconnect.\nOrder is arbitrary and items are unique.", + "items": { + "type": "string" }, - "parameterOrder": [ - "project" + "readOnly": true, + "type": "array" + }, + "interconnectType": { + "description": "Type of interconnect, which can take one of the following values:\n \n - PARTNER: A partner-managed interconnection shared between customers\n though a partner.\n - DEDICATED: A dedicated physical interconnection with the\n customer.\n\n\nNote that a value IT_PRIVATE has been deprecated in favor of DEDICATED.", + "enum": [ + "DEDICATED", + "IT_PRIVATE", + "PARTNER" ], - "response": { - "$ref": "BackendServiceAggregatedList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "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": "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`." + "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" - } + "kind": { + "default": "compute#interconnect", + "description": "Output only. [Output Only] Type of the resource. Alwayscompute#interconnect for interconnects.", + "readOnly": true, + "type": "string" + }, + "labelFingerprint": { + "description": "A fingerprint for the labels being applied to this Interconnect, which\nis essentially a hash of the labels set used for optimistic locking. The\nfingerprint is initially generated by Compute Engine and changes after\nevery request to modify or update labels. You must always provide an\nup-to-date fingerprint hash in order to update or change labels,\notherwise the request will fail with error412 conditionNotMet.\n\nTo see the latest fingerprint, make a get() request to\nretrieve an Interconnect.", + "format": "byte", + "type": "string" + }, + "labels": { + "additionalProperties": { + "type": "string" }, - "parameterOrder": [ - "project" + "description": "Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035.\nLabel values may be empty.", + "type": "object" + }, + "linkType": { + "description": "Type of link requested, which can take one of the following values:\n \n - LINK_TYPE_ETHERNET_10G_LR: A 10G Ethernet with LR optics\n - LINK_TYPE_ETHERNET_100G_LR: A 100G Ethernet with LR optics.\n - LINK_TYPE_ETHERNET_400G_LR4: A 400G Ethernet with LR4 optics.\n\n\n Note that this field indicates the speed of each of\nthe links in the bundle, not the speed of the entire bundle.", + "enum": [ + "LINK_TYPE_ETHERNET_100G_LR", + "LINK_TYPE_ETHERNET_10G_LR", + "LINK_TYPE_ETHERNET_400G_LR4" ], - "response": { - "$ref": "BackendServiceListUsable" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "100G Ethernet, LR Optics.", + "10G Ethernet, LR Optics.\n[(rate_bps) = 10000000000];", + "400G Ethernet, LR4 Optics." ], - "description": "Retrieves a list of all usable backend services in the specified project." + "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" - } + "location": { + "description": "URL of the InterconnectLocation object that represents where this\nconnection is to be provisioned.", + "type": "string" + }, + "macsec": { + "$ref": "InterconnectMacsec", + "description": "Configuration that enables Media Access Control security (MACsec) on the\nCloud Interconnect connection between Google and your on-premises router." + }, + "macsecEnabled": { + "description": "Enable or disable MACsec on this Interconnect connection. MACsec enablement\nfails if the MACsec object is not specified.", + "type": "boolean" + }, + "name": { + "annotations": { + "required": [ + "compute.interconnects.insert" + ] }, - "parameterOrder": [ - "project", - "backendService" + "description": "Name of the resource. Provided by the client when the resource is created.\nThe name must be 1-63 characters long, and comply withRFC1035.\nSpecifically, the name must be 1-63 characters long and match the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first\ncharacter must be a lowercase letter, and all following characters must be\na dash, lowercase letter, or digit, except the last character, which cannot\nbe a dash.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "nocContactEmail": { + "description": "Email address to contact the customer NOC for operations and maintenance\nnotifications regarding this Interconnect. If specified, this will be used\nfor notifications in addition to all other forms described, such as\nCloud Monitoring logs alerting and Cloud Notifications. This field is\nrequired for users who sign up for Cloud Interconnect using\nworkforce identity federation.", + "type": "string" + }, + "operationalStatus": { + "description": "Output only. [Output Only] The current status of this Interconnect's functionality,\nwhich can take one of the following values:\n \n - OS_ACTIVE: A valid Interconnect, which is turned up and is ready to\n use. Attachments may be provisioned on this Interconnect.\n\n- OS_UNPROVISIONED: An Interconnect that has not completed turnup. No\nattachments may be provisioned on this Interconnect.\n- OS_UNDER_MAINTENANCE: An Interconnect that is undergoing internal\nmaintenance. No attachments may be provisioned or updated on this\nInterconnect.", + "enum": [ + "OS_ACTIVE", + "OS_UNPROVISIONED" ], - "response": { - "$ref": "BackendService" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "The interconnect is valid, turned up, and ready to use. Attachments may\nbe provisioned on this interconnect.", + "The interconnect has not completed turnup. No attachments may be\nprovisioned on this interconnect." ], - "description": "Returns the specified BackendService resource." + "readOnly": true, + "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" - } + "params": { + "$ref": "InterconnectParams", + "description": "Input only. [Input Only] Additional params passed with the request, but not persisted\nas part of resource payload." + }, + "peerIpAddress": { + "description": "Output only. [Output Only] IP address configured on the customer side of the\nInterconnect link. The customer should configure this IP address during\nturnup when prompted by Google NOC. This can be used only for ping tests.", + "readOnly": true, + "type": "string" + }, + "provisionedLinkCount": { + "description": "Output only. [Output Only] Number of links actually provisioned in this interconnect.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "remoteLocation": { + "description": "Indicates that this is a Cross-Cloud Interconnect. This field specifies the\nlocation outside of Google's network that the interconnect is connected to.", + "type": "string" + }, + "requestedFeatures": { + "description": "Optional. This parameter can be provided only with Interconnect INSERT. It\nisn't valid for Interconnect PATCH. List of features requested for this\nInterconnect connection, which can take one of the following values:\n \n - IF_MACSEC: If specified, then the connection is created on MACsec\n capable hardware ports. If not specified, non-MACsec capable ports will\n also be considered.\n - IF_CROSS_SITE_NETWORK: If specified, then the connection is created\n exclusively for Cross-Site Networking. The connection can not be used for\n Cross-Site Networking unless this feature is specified.", + "items": { + "enum": [ + "IF_CROSS_SITE_NETWORK", + "IF_L2_FORWARDING", + "IF_MACSEC" + ], + "enumDescriptions": [ + "Cross-Site Networking", + "L2 Interconnect Attachment Forwarding", + "Media Access Control security (MACsec)" + ], + "type": "string" }, - "parameterOrder": [ - "project" + "type": "array" + }, + "requestedLinkCount": { + "description": "Target number of physical links in the link bundle, as requested by the\ncustomer.", + "format": "int32", + "type": "integer" + }, + "satisfiesPzs": { + "description": "Output only. [Output Only] Reserved for future use.", + "readOnly": true, + "type": "boolean" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for the resource.", + "readOnly": true, + "type": "string" + }, + "state": { + "description": "Output only. [Output Only] The current state of Interconnect functionality, which can\ntake one of the following values:\n \n - ACTIVE: The Interconnect is valid, turned up and ready to use.\n Attachments may be provisioned on this Interconnect.\n - UNPROVISIONED: The Interconnect has not completed turnup. No\n attachments may be provisioned on this Interconnect.\n - UNDER_MAINTENANCE: The Interconnect is undergoing internal maintenance.\n No attachments may be provisioned or updated on this\n Interconnect.", + "enum": [ + "ACTIVE", + "UNPROVISIONED" ], - "request": { - "$ref": "BackendService" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "The interconnect is valid, turned up, and ready to use. Attachments may\nbe provisioned on this interconnect.", + "The interconnect has not completed turnup. No attachments may be\nprovisioned on this interconnect." ], - "description": "Creates a BackendService resource in the specified project using the data included in the request. For more information, see Backend services overview ." + "readOnly": true, + "type": "string" }, - "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" - } + "subzone": { + "description": "To be deprecated.", + "enum": [ + "SUBZONE_A", + "SUBZONE_B" + ], + "enumDescriptions": [ + "Subzone A.", + "Subzone B." + ], + "type": "string" + }, + "wireGroups": { + "description": "Output only. [Output Only] A list of the URLs of all CrossSiteNetwork WireGroups\nconfigured to use this Interconnect. The Interconnect cannot be deleted if\nthis list is non-empty.", + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "backendService" + "readOnly": true, + "type": "array" + } + }, + "type": "object" + }, + "InterconnectApplicationAwareInterconnect": { + "description": "Configuration information for application awareness on this Cloud\nInterconnect.", + "id": "InterconnectApplicationAwareInterconnect", + "properties": { + "bandwidthPercentagePolicy": { + "$ref": "InterconnectApplicationAwareInterconnectBandwidthPercentagePolicy" + }, + "profileDescription": { + "description": "Description for the application awareness profile on this Cloud\nInterconnect.", + "type": "string" + }, + "shapeAveragePercentages": { + "description": "Optional field to specify a list of shape average percentages to be\napplied in conjunction with StrictPriorityPolicy or\nBandwidthPercentagePolicy.", + "items": { + "$ref": "InterconnectApplicationAwareInterconnectBandwidthPercentage" + }, + "type": "array" + }, + "strictPriorityPolicy": { + "$ref": "InterconnectApplicationAwareInterconnectStrictPriorityPolicy" + } + }, + "type": "object" + }, + "InterconnectApplicationAwareInterconnectBandwidthPercentage": { + "description": "Specify bandwidth percentages [1-100] for various traffic classes in\nBandwidthPercentagePolicy. The sum of all percentages must equal 100.\nAll traffic classes must have a percentage value specified.", + "id": "InterconnectApplicationAwareInterconnectBandwidthPercentage", + "properties": { + "percentage": { + "description": "Bandwidth percentage for a specific traffic class.", + "format": "uint32", + "type": "integer" + }, + "trafficClass": { + "description": "TrafficClass whose bandwidth percentage is being specified.", + "enum": [ + "TC1", + "TC2", + "TC3", + "TC4", + "TC5", + "TC6" ], - "response": { - "$ref": "Operation" + "enumDescriptions": [ + "Traffic Class 1, corresponding to DSCP ranges (0-7) 000xxx.", + "Traffic Class 2, corresponding to DSCP ranges (8-15) 001xxx.", + "Traffic Class 3, corresponding to DSCP ranges (16-23) 010xxx.", + "Traffic Class 4, corresponding to DSCP ranges (24-31) 011xxx.", + "Traffic Class 5, corresponding to DSCP ranges (32-47) 10xxxx.", + "Traffic Class 6, corresponding to DSCP ranges (48-63) 11xxxx." + ], + "type": "string" + } + }, + "type": "object" + }, + "InterconnectApplicationAwareInterconnectBandwidthPercentagePolicy": { + "id": "InterconnectApplicationAwareInterconnectBandwidthPercentagePolicy", + "properties": { + "bandwidthPercentages": { + "description": "Specify bandwidth percentages for various traffic classes for queuing\ntype Bandwidth Percent.", + "items": { + "$ref": "InterconnectApplicationAwareInterconnectBandwidthPercentage" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "type": "array" + } + }, + "type": "object" + }, + "InterconnectApplicationAwareInterconnectStrictPriorityPolicy": { + "description": "Specify configuration for StrictPriorityPolicy.", + "id": "InterconnectApplicationAwareInterconnectStrictPriorityPolicy", + "properties": {}, + "type": "object" + }, + "InterconnectAttachment": { + "description": "Represents an Interconnect Attachment (VLAN) resource.\n\nYou can use Interconnect attachments (VLANS) to connect your Virtual Private\nCloud networks to your on-premises networks through an Interconnect.\nFor more information, read\nCreating VLAN Attachments.", + "id": "InterconnectAttachment", + "properties": { + "adminEnabled": { + "description": "Determines whether this Attachment will carry packets.\nNot present for PARTNER_PROVIDER.", + "type": "boolean" + }, + "attachmentGroup": { + "description": "Output only. [Output Only] URL of the AttachmentGroup that includes this Attachment.", + "readOnly": true, + "type": "string" + }, + "bandwidth": { + "description": "Provisioned bandwidth capacity for the interconnect attachment. For\nattachments of type DEDICATED, the user can set the bandwidth.\nFor attachments of type PARTNER, the Google Partner that is operating\nthe interconnect must set the bandwidth.\nOutput only for PARTNER type, mutable for PARTNER_PROVIDER and DEDICATED,\nand can take one of the following values:\n \n - BPS_50M: 50 Mbit/s\n - BPS_100M: 100 Mbit/s\n - BPS_200M: 200 Mbit/s\n - BPS_300M: 300 Mbit/s\n - BPS_400M: 400 Mbit/s\n - BPS_500M: 500 Mbit/s\n - BPS_1G: 1 Gbit/s\n - BPS_2G: 2 Gbit/s\n - BPS_5G: 5 Gbit/s\n - BPS_10G: 10 Gbit/s\n - BPS_20G: 20 Gbit/s\n - BPS_50G: 50 Gbit/s\n - BPS_100G: 100 Gbit/s\n - BPS_400G: 400 Gbit/s", + "enum": [ + "BPS_100G", + "BPS_100M", + "BPS_10G", + "BPS_1G", + "BPS_200M", + "BPS_20G", + "BPS_2G", + "BPS_300M", + "BPS_400G", + "BPS_400M", + "BPS_500M", + "BPS_50G", + "BPS_50M", + "BPS_5G" + ], + "enumDescriptions": [ + "100 Gbit/s", + "100 Mbit/s", + "10 Gbit/s", + "1 Gbit/s", + "200 Mbit/s", + "20 Gbit/s", + "2 Gbit/s", + "300 Mbit/s", + "400 Gbit/s", + "400 Mbit/s", + "500 Mbit/s", + "50 Gbit/s", + "50 Mbit/s", + "5 Gbit/s" ], - "description": "Deletes the specified BackendService resource." + "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" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } + "candidateCloudRouterIpAddress": { + "description": "Single IPv4 address + prefix length to be configured on the cloud router\ninterface for this interconnect attachment.\n \n - Both candidate_cloud_router_ip_address and\n candidate_customer_router_ip_address fields must be set or both must be\n unset.\n - Prefix length of both candidate_cloud_router_ip_address and\n candidate_customer_router_ip_address must be the same.\n - Max prefix length is 31.", + "type": "string" + }, + "candidateCloudRouterIpv6Address": { + "description": "Single IPv6 address + prefix length to be configured on the cloud router\ninterface for this interconnect attachment.\n \n - Both candidate_cloud_router_ipv6_address and\n candidate_customer_router_ipv6_address fields must be set or both must be\n unset.\n - Prefix length of both candidate_cloud_router_ipv6_address and\n candidate_customer_router_ipv6_address must be the same.\n - Max prefix length is 126.", + "type": "string" + }, + "candidateCustomerRouterIpAddress": { + "description": "Single IPv4 address + prefix length to be configured on the customer router\ninterface for this interconnect attachment.", + "type": "string" + }, + "candidateCustomerRouterIpv6Address": { + "description": "Single IPv6 address + prefix length to be configured on the customer router\ninterface for this interconnect attachment.", + "type": "string" + }, + "candidateIpv6Subnets": { + "description": "This field is not available.", + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "backendService" - ], - "request": { - "$ref": "BackendService" + "type": "array" + }, + "candidateSubnets": { + "description": "Input only. Up to 16 candidate prefixes that can be used to restrict the allocation\nof cloudRouterIpAddress and customerRouterIpAddress for this attachment.\nAll prefixes must be within link-local address space (169.254.0.0/16) and\nmust be /29 or shorter (/28, /27, etc). Google will attempt to select an\nunused /29 from the supplied candidate prefix(es). The request will fail if\nall possible /29s are in use on Google's edge. If not supplied, Google will\nrandomly select an unused /29 from all of link-local space.", + "items": { + "type": "string" }, - "response": { - "$ref": "Operation" + "type": "array" + }, + "cloudRouterIpAddress": { + "description": "Output only. [Output Only] IPv4 address + prefix length to be configured on Cloud Router\nInterface for this interconnect attachment.", + "readOnly": true, + "type": "string" + }, + "cloudRouterIpv6Address": { + "description": "Output only. [Output Only] IPv6 address + prefix length to be configured on Cloud\nRouter Interface for this interconnect attachment.", + "readOnly": true, + "type": "string" + }, + "cloudRouterIpv6InterfaceId": { + "description": "This field is not available.", + "type": "string" + }, + "configurationConstraints": { + "$ref": "InterconnectAttachmentConfigurationConstraints", + "description": "Output only. [Output Only] Constraints for this attachment, if any. The attachment does\nnot work if these constraints are not met.", + "readOnly": true + }, + "creationTimestamp": { + "description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", + "readOnly": true, + "type": "string" + }, + "customerRouterIpAddress": { + "description": "Output only. [Output Only] IPv4 address + prefix length to be configured on the customer\nrouter subinterface for this interconnect attachment.", + "readOnly": true, + "type": "string" + }, + "customerRouterIpv6Address": { + "description": "Output only. [Output Only] IPv6 address + prefix length to be configured on the\ncustomer router subinterface for this interconnect attachment.", + "readOnly": true, + "type": "string" + }, + "customerRouterIpv6InterfaceId": { + "description": "This field is not available.", + "type": "string" + }, + "dataplaneVersion": { + "description": "Output only. [Output Only] Dataplane version for this InterconnectAttachment. This\nfield is only present for Dataplane version 2 and higher. Absence of this\nfield in the API output indicates that the Dataplane is version 1.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "description": { + "description": "An optional description of this resource.", + "type": "string" + }, + "edgeAvailabilityDomain": { + "description": "Input only. Desired availability domain for the attachment. Only available for type\nPARTNER, at creation time, and can take one of the following values:\n \n - AVAILABILITY_DOMAIN_ANY\n - AVAILABILITY_DOMAIN_1\n - AVAILABILITY_DOMAIN_2\n\n\nFor improved reliability, customers should configure a pair of attachments,\none per availability domain. The selected availability domain will be\nprovided to the Partner via the pairing key, so that the provisioned\ncircuit will lie in the specified domain. If not specified, the value will\ndefault to AVAILABILITY_DOMAIN_ANY.", + "enum": [ + "AVAILABILITY_DOMAIN_1", + "AVAILABILITY_DOMAIN_2", + "AVAILABILITY_DOMAIN_ANY" + ], + "enumDescriptions": [ + "", + "", + "" + ], + "type": "string" + }, + "encryption": { + "description": "Indicates the user-supplied encryption option of this VLAN attachment\n(interconnectAttachment). Can only be specified at attachment creation\nfor PARTNER or DEDICATED attachments.\nPossible values are:\n \n - NONE - This is the default value, which means that the\n VLAN attachment carries unencrypted traffic. VMs are able to send\n traffic to, or receive traffic from, such a VLAN attachment.\n - IPSEC - The VLAN attachment carries only encrypted\n traffic that is encrypted by an IPsec device, such as an HA VPN gateway or\n third-party IPsec VPN. VMs cannot directly send traffic to, or receive\n traffic from, such a VLAN attachment. To use *HA VPN over Cloud\n Interconnect*, the VLAN attachment must be created with this\n option.", + "enum": [ + "IPSEC", + "NONE" + ], + "enumDescriptions": [ + "The interconnect attachment will carry only encrypted traffic that is\nencrypted by an IPsec device such as HA VPN gateway;\nVMs cannot directly send traffic to or receive traffic from such an\ninterconnect attachment. To use HA VPN over Cloud Interconnect,\nthe interconnect attachment must be created with this option.", + "This is the default value, which means the Interconnect Attachment will\ncarry unencrypted traffic. VMs will be able to send traffic to or receive\ntraffic from such interconnect attachment." + ], + "type": "string" + }, + "googleReferenceId": { + "deprecated": true, + "description": "Output only. [Output Only] Google reference ID, to be used when raising support tickets\nwith Google or otherwise to debug backend connectivity issues.\n[Deprecated] This field is not used.", + "readOnly": true, + "type": "string" + }, + "id": { + "description": "Output only. [Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "format": "uint64", + "readOnly": true, + "type": "string" + }, + "interconnect": { + "description": "URL of the underlying Interconnect object that this attachment's traffic\nwill traverse through.", + "type": "string" + }, + "ipsecInternalAddresses": { + "description": "A list of URLs of addresses that have been reserved for the VLAN\nattachment. Used only for the VLAN attachment that has the encryption\noption as IPSEC. The addresses must be regional internal IP address ranges.\nWhen creating an HA VPN gateway over the VLAN attachment, if the attachment\nis configured to use a regional internal IP address, then the VPN gateway's\nIP address is allocated from the IP address range specified here. For\nexample, if the HA VPN gateway's interface 0 is paired to this VLAN\nattachment, then a regional internal IP address for the VPN gateway\ninterface 0 will be allocated from the IP address specified for this\nVLAN attachment.\nIf this field is not specified when creating the VLAN attachment, then\nlater on when creating an HA VPN gateway on this VLAN attachment, the HA\nVPN gateway's IP address is allocated from the regional external IP address\npool.", + "items": { + "type": "string" }, - "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." + "type": "array" }, - "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" - } + "kind": { + "default": "compute#interconnectAttachment", + "description": "Output only. [Output Only] Type of the resource. Alwayscompute#interconnectAttachment for interconnect attachments.", + "readOnly": true, + "type": "string" + }, + "l2Forwarding": { + "$ref": "InterconnectAttachmentL2Forwarding", + "description": "L2 Interconnect Attachment related config. This field is required if the\ntype is L2_DEDICATED.\n\nThe configuration specifies how VLAN tags (like dot1q, qinq, or dot1ad)\nwithin L2 packets are mapped to the destination appliances IP addresses.\nThe packet is then encapsulated with the appliance IP address and sent to\nthe edge appliance." + }, + "labelFingerprint": { + "description": "A fingerprint for the labels being applied to this InterconnectAttachment,\nwhich is essentially a hash of the labels set used for optimistic locking.\nThe fingerprint is initially generated by Compute Engine and changes after\nevery request to modify or update labels. You must always provide an\nup-to-date fingerprint hash in order to update or change labels,\notherwise the request will fail with error412 conditionNotMet.\n\nTo see the latest fingerprint, make a get() request to\nretrieve an InterconnectAttachment.", + "format": "byte", + "type": "string" + }, + "labels": { + "additionalProperties": { + "type": "string" }, - "parameterOrder": [ - "project", - "backendService" + "description": "Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035.\nLabel values may be empty.", + "type": "object" + }, + "mtu": { + "description": "Maximum Transmission Unit (MTU), in bytes, of packets passing through this\ninterconnect attachment.\nValid values are 1440, 1460, 1500, and 8896. If not specified,\nthe value will default to 1440.", + "format": "int32", + "type": "integer" + }, + "name": { + "description": "Name of the resource. Provided by the client when the resource is created.\nThe name must be 1-63 characters long, and comply withRFC1035.\nSpecifically, the name must be 1-63 characters long and match the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first\ncharacter must be a lowercase letter, and all following characters must\nbe a dash, lowercase letter, or digit, except the last character, which\ncannot be a dash.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "operationalStatus": { + "description": "Output only. [Output Only] The current status of whether or not this interconnect\nattachment is functional, which can take one of the following values:\n \n - OS_ACTIVE: The attachment has been turned up and is ready to\n use. \n - OS_UNPROVISIONED: The attachment is not ready to use yet,\n because turnup is not complete.", + "enum": [ + "OS_ACTIVE", + "OS_UNPROVISIONED" ], - "request": { - "$ref": "BackendService" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "Indicates that attachment has been turned up and is ready to\nuse.", + "Indicates that attachment is not ready to use yet, because\nturnup is not complete." ], - "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." + "readOnly": true, + "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" + "pairingKey": { + "description": "[Output only for type PARTNER. Input only for PARTNER_PROVIDER. Not\npresent for DEDICATED].\nThe opaque identifier of a PARTNER attachment used to initiate\nprovisioning with a selected partner.\nOf the form \"XXXXX/region/domain\"", + "type": "string" + }, + "params": { + "$ref": "InterconnectAttachmentParams", + "description": "Input only. [Input Only] Additional params passed with the request, but not persisted\nas part of resource payload." + }, + "partnerAsn": { + "description": "Optional BGP ASN for the router supplied by a Layer 3 Partner if they\nconfigured BGP on behalf of the customer.\nOutput only for PARTNER type, input only for PARTNER_PROVIDER, not\navailable for DEDICATED.", + "format": "int64", + "type": "string" + }, + "partnerMetadata": { + "$ref": "InterconnectAttachmentPartnerMetadata", + "description": "Informational metadata about Partner attachments from Partners to display\nto customers.\nOutput only for PARTNER type, mutable for PARTNER_PROVIDER, not\navailable for DEDICATED." + }, + "privateInterconnectInfo": { + "$ref": "InterconnectAttachmentPrivateInfo", + "description": "Output only. [Output Only] Information specific to an InterconnectAttachment.\nThis property is populated if the interconnect that\nthis is attached to is of type DEDICATED.", + "readOnly": true + }, + "region": { + "description": "Output only. [Output Only] URL of the region where the regional interconnect attachment\nresides.\nYou must specify this field as part of the HTTP request URL. It is\nnot settable as a field in the request body.", + "readOnly": true, + "type": "string" + }, + "remoteService": { + "description": "Output only. [Output Only]\nIf the attachment is on a Cross-Cloud Interconnect connection, this field\ncontains the interconnect's remote location service provider. Example\nvalues: \"Amazon Web Services\" \"Microsoft Azure\".\n\nThe field is set only for attachments on Cross-Cloud Interconnect\nconnections. Its value is copied from the InterconnectRemoteLocation\nremoteService field.", + "readOnly": true, + "type": "string" + }, + "router": { + "description": "URL of the Cloud Router to be used for dynamic routing. This router must be\nin the same region as this InterconnectAttachment. The\nInterconnectAttachment will automatically connect the Interconnect to the\nnetwork & region within which the Cloud Router is configured.", + "type": "string" + }, + "satisfiesPzs": { + "description": "Output only. [Output Only] Reserved for future use.", + "readOnly": true, + "type": "boolean" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for the resource.", + "readOnly": true, + "type": "string" + }, + "stackType": { + "description": "The stack type for this interconnect attachment to identify whether the\nIPv6 feature is enabled or not. If not specified, IPV4_ONLY\nwill be used.\n\nThis field can be both set at interconnect attachments creation and\nupdate interconnect attachment operations.", + "enum": [ + "IPV4_IPV6", + "IPV4_ONLY" ], - "request": { - "$ref": "SignedUrlKey" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "The interconnect attachment can have both IPv4 and IPv6 addresses.", + "The interconnect attachment will only be assigned IPv4 addresses." ], - "description": "Adds a key for validating requests with signed URLs for this backend service." + "type": "string" }, - "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" + "state": { + "description": "Output only. [Output Only] The current state of this attachment's functionality.\nEnum values ACTIVE and UNPROVISIONED are shared by DEDICATED/PRIVATE,\nPARTNER, and PARTNER_PROVIDER interconnect attachments, while enum values\nPENDING_PARTNER, PARTNER_REQUEST_RECEIVED, and PENDING_CUSTOMER are used\nfor only PARTNER and PARTNER_PROVIDER interconnect attachments.\nThis state can take one of the following values:\n \n - ACTIVE: The attachment has been turned up and is ready to use.\n - UNPROVISIONED: The attachment is not ready to use yet, because turnup\n is not complete.\n - PENDING_PARTNER: A newly-created PARTNER attachment that has not yet\n been configured on the Partner side.\n - PARTNER_REQUEST_RECEIVED: A PARTNER attachment is in the process of\n provisioning after a PARTNER_PROVIDER attachment was created that\n references it. \n - PENDING_CUSTOMER: A PARTNER or PARTNER_PROVIDER\n attachment that is waiting for a customer to activate it. \n - DEFUNCT:\n The attachment was deleted externally and is no longer functional. This\n could be because the associated Interconnect was removed, or because the\n other side of a Partner attachment was deleted.", + "enum": [ + "ACTIVE", + "DEFUNCT", + "PARTNER_REQUEST_RECEIVED", + "PENDING_CUSTOMER", + "PENDING_PARTNER", + "STATE_UNSPECIFIED", + "UNPROVISIONED" ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "Indicates that attachment has been turned up and is ready to use.", + "The attachment was deleted externally and is no longer functional.\nThis could be because the associated Interconnect was wiped out,\nor because the other side of a Partner attachment was deleted.", + "A PARTNER attachment is in the process of provisioning after a\nPARTNER_PROVIDER attachment was created that references it.", + "PARTNER or PARTNER_PROVIDER attachment that is waiting for the customer\nto activate.", + "A newly created PARTNER attachment that has not yet been configured on\nthe Partner side.", + "", + "Indicates that attachment is not ready to use yet, because turnup is not\ncomplete." ], - "description": "Deletes a key for validating requests with signed URLs for this backend service." + "readOnly": true, + "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" + "subnetLength": { + "description": "Input only. Length of the IPv4 subnet mask.\nAllowed values:\n \n \n - 29 (default)\n - 30\n\nThe default value is 29, except for Cross-Cloud Interconnect\nconnections that use an InterconnectRemoteLocation with a\nconstraints.subnetLengthRange.min equal to 30. For example,\nconnections that use an Azure remote location fall into this\ncategory. In these cases, the default value is 30, and requesting\n29 returns an error.\n\nWhere both 29 and 30 are allowed, 29 is preferred, because it gives\nGoogle Cloud Support more debugging visibility.", + "format": "int32", + "type": "integer" + }, + "type": { + "description": "The type of interconnect attachment this is, which can take one of the\nfollowing values:\n \n - DEDICATED: an attachment to a Dedicated Interconnect.\n - PARTNER: an attachment to a Partner Interconnect, created by the\n customer.\n - PARTNER_PROVIDER: an attachment to a Partner Interconnect, created by\n the partner.\n\n- L2_DEDICATED: a L2 attachment to a Dedicated Interconnect.", + "enum": [ + "DEDICATED", + "L2_DEDICATED", + "PARTNER", + "PARTNER_PROVIDER" ], - "request": { - "$ref": "SecurityPolicyReference" + "enumDescriptions": [ + "Attachment to a dedicated interconnect.", + "Attachment to a dedicated interconnect, forwarding L2 packets.", + "Attachment to a partner interconnect, created by the customer.", + "Attachment to a partner interconnect, created by the partner." + ], + "type": "string" + }, + "vlanTag8021q": { + "description": "The IEEE 802.1Q VLAN tag for this attachment, in the range 2-4093.\nOnly specified at creation time.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, + "InterconnectAttachmentAggregatedList": { + "id": "InterconnectAttachmentAggregatedList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "additionalProperties": { + "$ref": "InterconnectAttachmentsScopedList", + "description": "Name of the scope containing this set of interconnect attachments." }, - "response": { - "$ref": "Operation" + "description": "A list of InterconnectAttachmentsScopedList resources.", + "type": "object" + }, + "kind": { + "default": "compute#interconnectAttachmentAggregatedList", + "description": "Output only. [Output Only] Type of resource. Alwayscompute#interconnectAttachmentAggregatedList for aggregated\nlists of interconnect attachments.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "unreachables": { + "description": "Output only. [Output Only] Unreachable resources.", + "items": { + "type": "string" }, - "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" + "readOnly": true, + "type": "array" }, - "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, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. 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" } }, - "parameterOrder": [ - "project", - "backendService" + "type": "object" + } + }, + "type": "object" + }, + "InterconnectAttachmentConfigurationConstraints": { + "id": "InterconnectAttachmentConfigurationConstraints", + "properties": { + "bgpMd5": { + "description": "Output only. [Output Only] Whether the attachment's BGP session\nrequires/allows/disallows BGP MD5 authentication. This can take one of\nthe following values: MD5_OPTIONAL, MD5_REQUIRED, MD5_UNSUPPORTED.\n\nFor example, a Cross-Cloud Interconnect connection to a remote cloud\nprovider that requires BGP MD5 authentication has the\ninterconnectRemoteLocation attachment_configuration_constraints.bgp_md5\nfield set to MD5_REQUIRED, and that property is propagated to the\nattachment. Similarly, if BGP MD5 is MD5_UNSUPPORTED, an error is\nreturned if MD5 is requested.", + "enum": [ + "MD5_OPTIONAL", + "MD5_REQUIRED", + "MD5_UNSUPPORTED" ], - "request": { - "$ref": "SecurityPolicyReference" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "MD5_OPTIONAL: BGP MD5 authentication is supported and can optionally be\nconfigured.", + "MD5_REQUIRED: BGP MD5 authentication must be configured.", + "MD5_UNSUPPORTED: BGP MD5 authentication must not be configured" ], - "description": "Sets the edge security policy for the specified backend service." + "readOnly": true, + "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" - } + "bgpPeerAsnRanges": { + "description": "Output only. [Output Only] List of ASN ranges that the remote location is known to\nsupport. Formatted as an array of inclusive ranges {min: min-value, max:\nmax-value}. For example, [{min: 123, max: 123}, {min: 64512, max: 65534}]\nallows the peer ASN to be 123 or anything in the range 64512-65534.\n\nThis field is only advisory. Although the API accepts other ranges, these\nare the ranges that we recommend.", + "items": { + "$ref": "InterconnectAttachmentConfigurationConstraintsBgpPeerASNRange" }, - "parameterOrder": [ - "project", - "backendService" + "readOnly": true, + "type": "array" + } + }, + "type": "object" + }, + "InterconnectAttachmentConfigurationConstraintsBgpPeerASNRange": { + "id": "InterconnectAttachmentConfigurationConstraintsBgpPeerASNRange", + "properties": { + "max": { + "format": "uint32", + "type": "integer" + }, + "min": { + "format": "uint32", + "type": "integer" + } + }, + "type": "object" + }, + "InterconnectAttachmentGroup": { + "description": "An interconnect attachment group resource allows customers to create,\nanalyze, and expand highly available deployments.", + "id": "InterconnectAttachmentGroup", + "properties": { + "attachments": { + "additionalProperties": { + "$ref": "InterconnectAttachmentGroupAttachment" + }, + "description": "Attachments in the AttachmentGroup. Keys are arbitrary user-specified\nstrings. Users are encouraged, but not required, to use their preferred\nformat for resource links as keys.\nNote that there are add-members and remove-members methods in gcloud.\nThe size of this map is limited by an \"Attachments per group\" quota.", + "type": "object" + }, + "configured": { + "$ref": "InterconnectAttachmentGroupConfigured", + "readOnly": true + }, + "creationTimestamp": { + "description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you\ncreate the resource.", + "type": "string" + }, + "etag": { + "description": "Opaque system-generated token that uniquely identifies the configuration.\nIf provided when patching a configuration in update mode, the provided\ntoken must match the current token or the update is rejected. This provides\na reliable means of doing read-modify-write (optimistic locking) as\ndescribed byAIP 154.", + "type": "string" + }, + "id": { + "description": "Output only. [Output Only] The unique identifier for the resource type. The server\ngenerates this identifier.", + "format": "uint64", + "readOnly": true, + "type": "string" + }, + "intent": { + "$ref": "InterconnectAttachmentGroupIntent" + }, + "interconnectGroup": { + "description": "The URL of an InterconnectGroup that groups these Attachments'\nInterconnects. Customers do not need to set this unless directed by\nGoogle Support.", + "type": "string" + }, + "kind": { + "default": "compute#interconnectAttachmentGroup", + "description": "Output only. [Output Only] Type of the resource. Always\ncompute#interconnectAttachmentGroup.", + "readOnly": true, + "type": "string" + }, + "logicalStructure": { + "$ref": "InterconnectAttachmentGroupLogicalStructure", + "readOnly": true + }, + "name": { + "description": "Name of the resource. Provided by the client when the resource is created.\nThe name must be 1-63 characters long, and comply withRFC1035.\nSpecifically, the name must be 1-63 characters long and match the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first\ncharacter must be a lowercase letter, and all following characters must\nbe a dash, lowercase letter, or digit, except the last character, which\ncannot be a dash.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for the resource.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "InterconnectAttachmentGroupAttachment": { + "description": "An Attachment in this AttachmentGroup.", + "id": "InterconnectAttachmentGroupAttachment", + "properties": { + "attachment": { + "type": "string" + } + }, + "type": "object" + }, + "InterconnectAttachmentGroupConfigured": { + "description": "[Output Only] The redundancy this group is configured to support. The way a\nuser queries what SLA their Attachment gets is by looking at this field of\nthe Attachment's AttachmentGroup.", + "id": "InterconnectAttachmentGroupConfigured", + "properties": { + "availabilitySla": { + "$ref": "InterconnectAttachmentGroupConfiguredAvailabilitySLA", + "readOnly": true + } + }, + "type": "object" + }, + "InterconnectAttachmentGroupConfiguredAvailabilitySLA": { + "description": "[Output Only] Which SLA this group is configured to support, and why this\ngroup does or does not meet that SLA's requirements.", + "id": "InterconnectAttachmentGroupConfiguredAvailabilitySLA", + "properties": { + "effectiveSla": { + "enum": [ + "EFFECTIVE_SLA_UNSPECIFIED", + "NO_SLA", + "PRODUCTION_CRITICAL", + "PRODUCTION_NON_CRITICAL" ], - "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" + "enumDescriptions": [ + "", + "", + "", + "" ], - "description": "Gets the most recent health check results for this BackendService. Example request body: { \"group\": \"/zones/us-east1-b/instanceGroups/lb-backend-example\" }" + "readOnly": 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" - } + "intendedSlaBlockers": { + "items": { + "$ref": "InterconnectAttachmentGroupConfiguredAvailabilitySLAIntendedSlaBlockers" }, - "parameterOrder": [ - "project", - "resource" - ], - "response": { - "$ref": "Policy" + "readOnly": true, + "type": "array" + } + }, + "type": "object" + }, + "InterconnectAttachmentGroupConfiguredAvailabilitySLAIntendedSlaBlockers": { + "description": "[Output Only] Reasons why configuration.availabilitySLA.sla differs from\nintent.availabilitySLA. This list is empty if and only if those are the\nsame.", + "id": "InterconnectAttachmentGroupConfiguredAvailabilitySLAIntendedSlaBlockers", + "properties": { + "attachments": { + "description": "Output only. [Output Only] URLs of any particular Attachments to explain this\nblocker in more detail.", + "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": "Gets the access control policy for a resource. May be empty if no such policy or resource exists." + "readOnly": true, + "type": "array" }, - "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" + "blockerType": { + "enum": [ + "BLOCKER_TYPE_UNSPECIFIED", + "INCOMPATIBLE_METROS", + "INCOMPATIBLE_REGIONS", + "MISSING_GLOBAL_ROUTING", + "NO_ATTACHMENTS", + "NO_ATTACHMENTS_IN_METRO_AND_ZONE", + "OTHER" ], - "request": { - "$ref": "GlobalSetPolicyRequest" - }, - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "", + "", + "", + "", + "", + "", + "" ], - "description": "Sets the access control policy on the specified resource. Replaces any existing policy." + "readOnly": true, + "type": "string" }, - "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" - } + "documentationLink": { + "description": "Output only. [Output Only] The url of Google Cloud public documentation explaining\nthis requirement. This is set for every type of requirement.", + "readOnly": true, + "type": "string" + }, + "explanation": { + "description": "Output only. [Output Only] A human-readable explanation of this requirement and\nwhy it's not met. This is set for every type of requirement.", + "readOnly": true, + "type": "string" + }, + "metros": { + "description": "Output only. [Output Only] Metros used to explain this blocker in more detail.\nThese are three-letter lowercase strings like \"iad\". This will be set\nfor some blockers (like NO_ATTACHMENTS_IN_METRO_AND_ZONE) but does\nnot apply to others.", + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "resource" - ], - "request": { - "$ref": "TestPermissionsRequest" + "readOnly": true, + "type": "array" + }, + "regions": { + "description": "Output only. [Output Only] Regions used to explain this blocker in more\ndetail. These are region names formatted like \"us-central1\". This\nwill be set for some blockers (like INCOMPATIBLE_REGIONS) but does\nnot apply to others.", + "items": { + "type": "string" }, - "response": { - "$ref": "TestPermissionsResponse" + "readOnly": true, + "type": "array" + }, + "zones": { + "description": "Output only. [Output Only] Zones used to explain this blocker in more detail.\nFormat is \"zone1\" and/or \"zone2\". This will be set for some blockers\n(like MISSING_ZONE) but does not apply to others.", + "items": { + "type": "string" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "readOnly": true, + "type": "array" + } + }, + "type": "object" + }, + "InterconnectAttachmentGroupIntent": { + "description": "The user's intent for this AttachmentGroup. This is the only required field\nbesides the name that must be specified on group creation.", + "id": "InterconnectAttachmentGroupIntent", + "properties": { + "availabilitySla": { + "enum": [ + "AVAILABILITY_SLA_UNSPECIFIED", + "NO_SLA", + "PRODUCTION_CRITICAL", + "PRODUCTION_NON_CRITICAL" + ], + "enumDescriptions": [ + "", + "", + "", + "" ], - "description": "Returns permissions that a caller has on the specified resource." + "type": "string" } - } + }, + "type": "object" }, - "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" - } + "InterconnectAttachmentGroupLogicalStructure": { + "description": "[Output Only] An analysis of the logical layout of Attachments in this\ngroup. Every Attachment in the group is shown once in this structure.", + "id": "InterconnectAttachmentGroupLogicalStructure", + "properties": { + "regions": { + "items": { + "$ref": "InterconnectAttachmentGroupLogicalStructureRegion" }, - "parameterOrder": [ - "project", - "region" - ], - "response": { - "$ref": "BackendServiceList" + "readOnly": true, + "type": "array" + } + }, + "type": "object" + }, + "InterconnectAttachmentGroupLogicalStructureRegion": { + "description": "[Output Only] The regions Attachments in this group are in.", + "id": "InterconnectAttachmentGroupLogicalStructureRegion", + "properties": { + "metros": { + "items": { + "$ref": "InterconnectAttachmentGroupLogicalStructureRegionMetro" }, - "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." + "readOnly": true, + "type": "array" }, - "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" - } + "region": { + "description": "Output only. [Output Only] The name of a region, like \"us-central1\".", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "InterconnectAttachmentGroupLogicalStructureRegionMetro": { + "description": "[Output Only] The metros of Attachments in this group in this region.", + "id": "InterconnectAttachmentGroupLogicalStructureRegionMetro", + "properties": { + "facilities": { + "items": { + "$ref": "InterconnectAttachmentGroupLogicalStructureRegionMetroFacility" }, - "parameterOrder": [ - "project", - "region" - ], - "response": { - "$ref": "BackendServiceListUsable" + "readOnly": true, + "type": "array" + }, + "metro": { + "description": "Output only. [Output Only] The name of the metro, as a three-letter lowercase\nstring like \"iad\". This is the first component of the location of an\nInterconnect.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "InterconnectAttachmentGroupLogicalStructureRegionMetroFacility": { + "description": "[Output Only] The facilities used for this group's Attachments'\nInterconnects.", + "id": "InterconnectAttachmentGroupLogicalStructureRegionMetroFacility", + "properties": { + "facility": { + "description": "Output only. [Output Only] The name of a facility, like \"iad-1234\".", + "readOnly": true, + "type": "string" + }, + "zones": { + "items": { + "$ref": "InterconnectAttachmentGroupLogicalStructureRegionMetroFacilityZone" }, - "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." + "readOnly": true, + "type": "array" + } + }, + "type": "object" + }, + "InterconnectAttachmentGroupLogicalStructureRegionMetroFacilityZone": { + "description": "[Output Only] The zones that Attachments in this group are present\nin, in the given facilities. This is inherited from their\nInterconnects.", + "id": "InterconnectAttachmentGroupLogicalStructureRegionMetroFacilityZone", + "properties": { + "attachments": { + "description": "Output only. [Output Only] URLs of Attachments in the given zone, to the given\nregion, on Interconnects in the given facility and metro. Every\nAttachment in the AG has such an entry.", + "items": { + "type": "string" + }, + "readOnly": true, + "type": "array" }, - "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" - } + "zone": { + "description": "Output only. [Output Only] The name of a zone, either \"zone1\" or \"zone2\".", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "InterconnectAttachmentGroupsGetOperationalStatusResponse": { + "description": "Response for the InterconnectAttachmentGroupsGetOperationalStatusResponse.", + "id": "InterconnectAttachmentGroupsGetOperationalStatusResponse", + "properties": { + "etag": { + "type": "string" + }, + "result": { + "$ref": "InterconnectAttachmentGroupsOperationalStatus" + } + }, + "type": "object" + }, + "InterconnectAttachmentGroupsListResponse": { + "id": "InterconnectAttachmentGroupsListResponse", + "properties": { + "etag": { + "type": "string" + }, + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of InterconnectAttachmentGroup resources.", + "items": { + "$ref": "InterconnectAttachmentGroup" }, - "parameterOrder": [ - "project", - "region", - "backendService" - ], - "response": { - "$ref": "BackendService" + "type": "array" + }, + "kind": { + "default": "compute#interconnectAttachmentGroup", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "unreachables": { + "description": "Output only. [Output Only] Unreachable resources.\nend_interface:\nMixerListResponseWithEtagBuilder", + "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": "Returns the specified regional BackendService resource." + "readOnly": true, + "type": "array" }, - "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, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. 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" } }, - "parameterOrder": [ - "project", - "region" - ], - "request": { - "$ref": "BackendService" - }, - "response": { - "$ref": "Operation" + "type": "object" + } + }, + "type": "object" + }, + "InterconnectAttachmentGroupsOperationalStatus": { + "id": "InterconnectAttachmentGroupsOperationalStatus", + "properties": { + "attachmentStatuses": { + "items": { + "$ref": "InterconnectAttachmentGroupsOperationalStatusAttachmentStatus" }, - "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." + "readOnly": true, + "type": "array" }, - "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." + "configured": { + "$ref": "InterconnectAttachmentGroupConfigured", + "readOnly": true }, - "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" + "groupStatus": { + "description": "Output only. Summarizes the status of the group.", + "enum": [ + "DEGRADED", + "FULLY_DOWN", + "FULLY_UP", + "UNSPECIFIED" ], - "request": { - "$ref": "BackendService" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "", + "", + "", + "" ], - "description": "Updates the specified regional BackendService resource with the data included in the request. For more information, see Backend services overview ." + "readOnly": true, + "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" - }, - "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" + "intent": { + "$ref": "InterconnectAttachmentGroupIntent", + "readOnly": true + }, + "operational": { + "$ref": "InterconnectAttachmentGroupConfigured", + "description": "Output only. The operational state of the group, including only active Attachments.", + "readOnly": true + } + }, + "type": "object" + }, + "InterconnectAttachmentGroupsOperationalStatusAttachmentStatus": { + "description": "The status of one Attachment in the group. List order is arbitrary.", + "id": "InterconnectAttachmentGroupsOperationalStatusAttachmentStatus", + "properties": { + "adminEnabled": { + "description": "Output only. Whether this Attachment is enabled. This becomes false when the customer\ndrains their Attachment.", + "readOnly": true, + "type": "boolean" + }, + "attachment": { + "description": "Output only. The URL of the Attachment being described.", + "readOnly": true, + "type": "string" + }, + "isActive": { + "description": "Output only. Whether this Attachment is participating in the redundant configuration.\nThis will be ACTIVE if and only if the status below is CONNECTION_UP.\nAny INACTIVE Attachments are excluded from the analysis that generates\noperational.availabilitySLA.", + "enum": [ + "ACTIVE", + "INACTIVE", + "UNSPECIFIED" ], - "request": { - "$ref": "BackendService" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "", + "", + "" ], - "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." + "readOnly": true, + "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" + "status": { + "description": "Output only. Whether this Attachment is active, and if so, whether BGP is up.", + "enum": [ + "ATTACHMENT_STATUS_UNKNOWN", + "CONNECTION_DISABLED", + "CONNECTION_DOWN", + "CONNECTION_UP", + "DEFUNCT", + "IPSEC_CONFIGURATION_NEEDED_STATUS", + "IPSEC_READY_TO_RESUME_FLOW_STATUS", + "IPV4_DOWN_IPV6_UP", + "IPV4_UP_IPV6_DOWN", + "PARTNER_REQUEST_RECEIVED", + "PENDING_CUSTOMER", + "PENDING_PARTNER", + "PROVISIONED", + "ROUTER_CONFIGURATION_BROKEN", + "UNPROVISIONED" ], - "request": { - "$ref": "SecurityPolicyReference" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "" ], - "description": "Sets the Google Cloud Armor security policy for the specified backend service. For more information, see Google Cloud Armor Overview" + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "InterconnectAttachmentL2Forwarding": { + "description": "L2 Interconnect Attachment related configuration.", + "id": "InterconnectAttachmentL2Forwarding", + "properties": { + "applianceMappings": { + "additionalProperties": { + "$ref": "InterconnectAttachmentL2ForwardingApplianceMapping" + }, + "description": "Optional. A map of VLAN tags to appliances and optional inner mapping\nrules. If VLANs are not explicitly mapped to any appliance, the\ndefaultApplianceIpAddress is used.\n\nEach VLAN tag can be a single number or a range of numbers in the range\nof 1 to 4094, e.g., \"1\" or \"4001-4094\". Non-empty and non-overlapping\nVLAN tag ranges are enforced, and violating operations will be rejected.\n\nThe VLAN tags in the Ethernet header must use an ethertype value of\n0x88A8 or 0x8100.", + "type": "object" }, - "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" - } + "defaultApplianceIpAddress": { + "description": "Optional. A single IPv4 or IPv6 address used as the default destination\nIP when there is no VLAN mapping result found.\n\nUnset field (null-value) indicates the unmatched packet should be\ndropped.", + "type": "string" + }, + "geneveHeader": { + "$ref": "InterconnectAttachmentL2ForwardingGeneveHeader", + "description": "Optional. It represents the structure of a Geneve (Generic Network\nVirtualization Encapsulation) header, as defined in RFC8926. It encapsulates packets from various\nprotocols (e.g., Ethernet, IPv4, IPv6) for use in network virtualization\nenvironments." + }, + "network": { + "description": "Required. Resource URL of the network to which this attachment belongs.", + "type": "string" + }, + "tunnelEndpointIpAddress": { + "description": "Required. A single IPv4 or IPv6 address. This address will be used as the\nsource IP address for packets sent to the appliances, and must be used as\nthe destination IP address for packets that should be sent out through\nthis attachment.", + "type": "string" + } + }, + "type": "object" + }, + "InterconnectAttachmentL2ForwardingApplianceMapping": { + "description": "Two-level VLAN-to-Appliance mapping rule.", + "id": "InterconnectAttachmentL2ForwardingApplianceMapping", + "properties": { + "applianceIpAddress": { + "description": "Optional. A single IPv4 or IPv6 address used as the destination IP\naddress for ingress packets that match on a VLAN tag, but do not match\na more specific inner VLAN tag.\n\nUnset field (null-value) indicates both VLAN tags are required to be\nmapped. Otherwise, defaultApplianceIpAddress is used.", + "type": "string" + }, + "innerVlanToApplianceMappings": { + "description": "Optional. Used to match against the inner VLAN when the packet\ncontains two VLAN tags.\n\nA list of mapping rules from inner VLAN tags to IP addresses. If the\ninner VLAN is not explicitly mapped to an IP address range, the\napplianceIpAddress is used.", + "items": { + "$ref": "InterconnectAttachmentL2ForwardingApplianceMappingInnerVlanToApplianceMapping" }, - "parameterOrder": [ - "project", - "region", - "backendService" - ], - "request": { - "$ref": "ResourceGroupReference" + "type": "array" + }, + "name": { + "description": "Optional. The name of this appliance mapping rule.", + "type": "string" + } + }, + "type": "object" + }, + "InterconnectAttachmentL2ForwardingApplianceMappingInnerVlanToApplianceMapping": { + "description": "The inner VLAN-to-Appliance mapping.", + "id": "InterconnectAttachmentL2ForwardingApplianceMappingInnerVlanToApplianceMapping", + "properties": { + "innerApplianceIpAddress": { + "description": "Required in this object. A single IPv4 or IPv6 address used as the\ndestination IP address for ingress packets that match on both VLAN\ntags.", + "type": "string" + }, + "innerVlanTags": { + "description": "Required in this object. Used to match the inner VLAN tag on the\npacket. Each entry can be a single number or a range of numbers in\nthe range of 1 to 4094, e.g., [\"1\", \"4001-4094\"] is valid. Non-empty\nand Non-overlapping VLAN tag ranges are enforced, and violating\noperations will be rejected.\n\nThe inner VLAN tags must have an ethertype value of 0x8100.", + "items": { + "type": "string" }, - "response": { - "$ref": "BackendServiceGroupHealth" + "type": "array" + } + }, + "type": "object" + }, + "InterconnectAttachmentL2ForwardingGeneveHeader": { + "description": "GeneveHeader related configurations.", + "id": "InterconnectAttachmentL2ForwardingGeneveHeader", + "properties": { + "vni": { + "description": "Optional. VNI is a 24-bit unique virtual network identifier, from 0 to\n16,777,215.", + "format": "uint32", + "type": "integer" + } + }, + "type": "object" + }, + "InterconnectAttachmentList": { + "description": "Response to the list request, and contains a list of interconnect\nattachments.", + "id": "InterconnectAttachmentList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of InterconnectAttachment resources.", + "items": { + "$ref": "InterconnectAttachment" }, - "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." + "type": "array" }, - "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, + "kind": { + "default": "compute#interconnectAttachmentList", + "description": "Output only. [Output Only] Type of resource. Alwayscompute#interconnectAttachmentList for lists of interconnect\nattachments.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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" } }, - "parameterOrder": [ - "project", - "region", - "resource" - ], - "response": { - "$ref": "Policy" + "type": "object" + } + }, + "type": "object" + }, + "InterconnectAttachmentParams": { + "description": "Additional interconnect attachment parameters.", + "id": "InterconnectAttachmentParams", + "properties": { + "resourceManagerTags": { + "additionalProperties": { + "type": "string" }, - "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": "Tag keys/values directly bound to this resource.\nTag keys and values have the same definition as resource\nmanager tags. The field is allowed for INSERT\nonly. The keys/values to set on the resource should be specified in\neither ID { : } or Namespaced format\n{ : }.\nFor example the following are valid inputs:\n* {\"tagKeys/333\" : \"tagValues/444\", \"tagKeys/123\" : \"tagValues/456\"}\n* {\"123/environment\" : \"production\", \"345/abc\" : \"xyz\"}\nNote:\n* Invalid combinations of ID & namespaced format is not supported. For\n instance: {\"123/environment\" : \"tagValues/444\"} is invalid.\n* Inconsistent format is not supported. For instance:\n {\"tagKeys/333\" : \"tagValues/444\", \"123/env\" : \"prod\"} is invalid.", + "type": "object" + } + }, + "type": "object" + }, + "InterconnectAttachmentPartnerMetadata": { + "description": "Informational metadata about Partner attachments from Partners to display\nto customers. These fields are propagated from PARTNER_PROVIDER\nattachments to their corresponding PARTNER attachments.", + "id": "InterconnectAttachmentPartnerMetadata", + "properties": { + "interconnectName": { + "description": "Plain text name of the Interconnect this attachment is connected to, as\ndisplayed in the Partner's portal. For instance \"Chicago 1\".\nThis value may be validated to match approved Partner values.", + "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, + "partnerName": { + "description": "Plain text name of the Partner providing this attachment.\nThis 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\nthis to be a deep link to the specific resource on the Partner portal.\nThis value may be validated to match approved Partner values.", + "type": "string" + } + }, + "type": "object" + }, + "InterconnectAttachmentPrivateInfo": { + "description": "Information for an interconnect attachment when this belongs to an\ninterconnect of type DEDICATED.", + "id": "InterconnectAttachmentPrivateInfo", + "properties": { + "tag8021q": { + "description": "[Output Only] 802.1q encapsulation tag to be used for traffic between\nGoogle and the customer, going to and from this network and region.", + "format": "uint32", + "type": "integer" + } + }, + "type": "object" + }, + "InterconnectAttachmentsScopedList": { + "id": "InterconnectAttachmentsScopedList", + "properties": { + "interconnectAttachments": { + "description": "A list of interconnect attachments contained in this scope.", + "items": { + "$ref": "InterconnectAttachment" + }, + "type": "array" + }, + "warning": { + "description": "Informational warning which replaces the list of addresses when\nthe list is empty.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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" } }, - "parameterOrder": [ - "project", - "region", - "resource" - ], - "request": { - "$ref": "RegionSetPolicyRequest" - }, - "response": { - "$ref": "Policy" + "type": "object" + } + }, + "type": "object" + }, + "InterconnectCircuitInfo": { + "description": "Describes a single physical circuit between the Customer and Google.\nCircuitInfo objects are created by Google, so all fields are output only.", + "id": "InterconnectCircuitInfo", + "properties": { + "customerDemarcId": { + "description": "Customer-side demarc ID for this circuit.", + "type": "string" + }, + "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\nprovided by Google to the customer in the LOA.", + "type": "string" + } + }, + "type": "object" + }, + "InterconnectDiagnostics": { + "description": "Diagnostics information about the Interconnect connection, which contains\ndetailed and current technical information about Google's side of the\nconnection.", + "id": "InterconnectDiagnostics", + "properties": { + "arpCaches": { + "description": "A list of InterconnectDiagnostics.ARPEntry objects,\ndescribing individual neighbors currently seen by the Google router in\nthe ARP cache for the Interconnect.\nThis will be empty when the Interconnect is not bundled.", + "items": { + "$ref": "InterconnectDiagnosticsARPEntry" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "type": "array" + }, + "bundleAggregationType": { + "description": "The aggregation type of the bundle interface.", + "enum": [ + "BUNDLE_AGGREGATION_TYPE_LACP", + "BUNDLE_AGGREGATION_TYPE_STATIC" + ], + "enumDescriptions": [ + "LACP is enabled.", + "LACP is disabled." ], - "description": "Sets the access control policy on the specified resource. Replaces any existing policy." + "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" + "bundleOperationalStatus": { + "description": "The operational status of the bundle interface.", + "enum": [ + "BUNDLE_OPERATIONAL_STATUS_DOWN", + "BUNDLE_OPERATIONAL_STATUS_UP" ], - "request": { - "$ref": "TestPermissionsRequest" - }, - "response": { - "$ref": "TestPermissionsResponse" + "enumDescriptions": [ + "If bundleAggregationType is LACP: LACP is not established and/or all\nlinks in the bundle have DOWN operational status. If\nbundleAggregationType is STATIC: one or more links in the bundle has\nDOWN operational status.", + "If bundleAggregationType is LACP: LACP is established and at least one\nlink in the bundle has UP operational status. If bundleAggregationType\nis STATIC: all links in the bundle (typically just one) have UP\noperational status." + ], + "type": "string" + }, + "links": { + "description": "A list of InterconnectDiagnostics.LinkStatus objects,\ndescribing the status for each link on the Interconnect.", + "items": { + "$ref": "InterconnectDiagnosticsLinkStatus" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "type": "array" + }, + "macAddress": { + "description": "The MAC address of the Interconnect's bundle interface.", + "type": "string" + } + }, + "type": "object" + }, + "InterconnectDiagnosticsARPEntry": { + "description": "Describing the ARP neighbor entries seen on this link", + "id": "InterconnectDiagnosticsARPEntry", + "properties": { + "ipAddress": { + "description": "The IP address of this ARP neighbor.", + "type": "string" + }, + "macAddress": { + "description": "The MAC address of this ARP neighbor.", + "type": "string" + } + }, + "type": "object" + }, + "InterconnectDiagnosticsLinkLACPStatus": { + "id": "InterconnectDiagnosticsLinkLACPStatus", + "properties": { + "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" + }, + "state": { + "description": "The state of a LACP link, which can take one of the following values:\n \n - ACTIVE: The link is configured and active within the bundle.\n - DETACHED: The link is not configured within the bundle. This means\n that the rest of the object should be empty.", + "enum": [ + "ACTIVE", + "DETACHED" + ], + "enumDescriptions": [ + "The link is configured and active within the bundle.", + "The link is not configured within the bundle, this means the rest of\nthe object should be empty." ], - "description": "Returns permissions that a caller has on the specified resource." + "type": "string" } - } + }, + "type": "object" }, - "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" + "InterconnectDiagnosticsLinkOpticalPower": { + "id": "InterconnectDiagnosticsLinkOpticalPower", + "properties": { + "state": { + "description": "The status of the current value when compared to the warning and alarm\nlevels for the receiving or transmitting transceiver. Possible states\ninclude:\n \n \n - OK: The value has not crossed a warning threshold.\n - LOW_WARNING: The value has crossed below the low\n warning threshold. \n - HIGH_WARNING: The value has\n crossed above the high warning threshold.\n - LOW_ALARM: The value has crossed below the low alarm\n threshold.\n - HIGH_ALARM: The value has crossed above the high alarm\n threshold.", + "enum": [ + "HIGH_ALARM", + "HIGH_WARNING", + "LOW_ALARM", + "LOW_WARNING", + "OK" ], - "response": { - "$ref": "CommitmentList" + "enumDescriptions": [ + "The value has crossed above the high alarm threshold.", + "The value of the current optical power has crossed above the high\nwarning threshold.", + "The value of the current optical power has crossed below the low alarm\nthreshold.", + "The value of the current optical power has crossed below the low\nwarning threshold.", + "The value of the current optical power has not crossed a warning\nthreshold." + ], + "type": "string" + }, + "value": { + "description": "Value of the current receiving or transmitting optical power, read in\ndBm. Take a known good optical value, give it a 10% margin and trigger\nwarnings relative to that value. In general, a -7dBm warning and a -11dBm\nalarm are good optical value estimates for most links.", + "format": "float", + "type": "number" + } + }, + "type": "object" + }, + "InterconnectDiagnosticsLinkStatus": { + "id": "InterconnectDiagnosticsLinkStatus", + "properties": { + "arpCaches": { + "description": "A list of InterconnectDiagnostics.ARPEntry objects,\ndescribing the ARP neighbor entries seen on this link.\nThis will be empty if the link is bundled", + "items": { + "$ref": "InterconnectDiagnosticsARPEntry" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "type": "array" + }, + "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" + }, + "lacpStatus": { + "$ref": "InterconnectDiagnosticsLinkLACPStatus" + }, + "macsec": { + "$ref": "InterconnectDiagnosticsMacsecStatus", + "description": "Describes the status of MACsec encryption on this link." + }, + "operationalStatus": { + "description": "The operational status of the link.", + "enum": [ + "LINK_OPERATIONAL_STATUS_DOWN", + "LINK_OPERATIONAL_STATUS_UP" + ], + "enumDescriptions": [ + "The interface is unable to communicate with the remote end.", + "The interface has low level communication with the remote end." ], - "description": "Retrieves a list of commitments contained within the specified region." + "type": "string" }, - "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" - } + "receivingOpticalPower": { + "$ref": "InterconnectDiagnosticsLinkOpticalPower", + "description": "An InterconnectDiagnostics.LinkOpticalPower object,\ndescribing the current value and status of the received light level." + }, + "transmittingOpticalPower": { + "$ref": "InterconnectDiagnosticsLinkOpticalPower", + "description": "An InterconnectDiagnostics.LinkOpticalPower object,\ndescribing the current value and status of the transmitted light level." + } + }, + "type": "object" + }, + "InterconnectDiagnosticsMacsecStatus": { + "description": "Describes the status of MACsec encryption on the link.", + "id": "InterconnectDiagnosticsMacsecStatus", + "properties": { + "ckn": { + "description": "Indicates the Connectivity Association Key Name (CKN)\ncurrently being used if MACsec is operational.", + "type": "string" + }, + "operational": { + "description": "Indicates whether or not MACsec is operational on this link.", + "type": "boolean" + } + }, + "type": "object" + }, + "InterconnectGroup": { + "description": "An interconnect group resource allows customers to create, analyze, and\nexpand their redundant connections.", + "id": "InterconnectGroup", + "properties": { + "configured": { + "$ref": "InterconnectGroupConfigured", + "readOnly": true + }, + "creationTimestamp": { + "description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you\ncreate the resource.", + "type": "string" + }, + "etag": { + "description": "Opaque system-generated token that uniquely identifies the configuration.\nIf provided when patching a configuration in update mode, the provided\ntoken must match the current token or the update is rejected. This provides\na reliable means of doing read-modify-write (optimistic locking) as\ndescribed by AIP 154.", + "type": "string" + }, + "id": { + "description": "Output only. [Output Only] The unique identifier for the resource type. The server\ngenerates this identifier.", + "format": "uint64", + "readOnly": true, + "type": "string" + }, + "intent": { + "$ref": "InterconnectGroupIntent" + }, + "interconnects": { + "additionalProperties": { + "$ref": "InterconnectGroupInterconnect" }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "CommitmentAggregatedList" + "description": "Interconnects in the InterconnectGroup. Keys are arbitrary user-specified\nstrings. Users are encouraged, but not required, to use their preferred\nformat for resource links as keys.\nNote that there are add-members and remove-members methods in gcloud.\nThe size of this map is limited by an \"Interconnects per group\" quota.", + "type": "object" + }, + "kind": { + "default": "compute#InterconnectGroup", + "description": "Output only. [Output Only] Type of the resource. Always compute#InterconnectGroup", + "readOnly": true, + "type": "string" + }, + "name": { + "annotations": { + "required": [ + "compute.interconnectGroups.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 commitments by region. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." + "description": "Name of the resource. Provided by the client when the resource is created.\nThe name must be 1-63 characters long, and comply withRFC1035.\nSpecifically, the name must be 1-63 characters long and match the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first\ncharacter must be a lowercase letter, and all following characters must\nbe a dash, lowercase letter, or digit, except the last character, which\ncannot be a dash.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" }, - "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" - } + "physicalStructure": { + "$ref": "InterconnectGroupPhysicalStructure", + "readOnly": true + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for the resource.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "InterconnectGroupConfigured": { + "description": "[Output Only] The status of the group as configured. This has the same\nstructure as the operational field reported by the OperationalStatus\nmethod, but does not take into account the operational status of each\nresource.", + "id": "InterconnectGroupConfigured", + "properties": { + "topologyCapability": { + "$ref": "InterconnectGroupConfiguredTopologyCapability", + "readOnly": true + } + }, + "type": "object" + }, + "InterconnectGroupConfiguredTopologyCapability": { + "description": "[Output Only] How reliable this topology is configured to be, and why\nthis group does or does not meet the requirements for the intended\ncapability.", + "id": "InterconnectGroupConfiguredTopologyCapability", + "properties": { + "intendedCapabilityBlockers": { + "items": { + "$ref": "InterconnectGroupConfiguredTopologyCapabilityIntendedCapabilityBlockers" }, - "parameterOrder": [ - "project", - "region", - "commitment" + "readOnly": true, + "type": "array" + }, + "supportedSla": { + "enum": [ + "NO_SLA", + "PRODUCTION_CRITICAL", + "PRODUCTION_NON_CRITICAL", + "UNSPECIFIED" ], - "response": { - "$ref": "Commitment" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "", + "", + "", + "" + ], + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "InterconnectGroupConfiguredTopologyCapabilityIntendedCapabilityBlockers": { + "description": "[Output Only] Reasons why configuration.topologyCapability.sla differs\nfrom intent.topologyCapability. This list is empty if and only if those\nare the same.", + "id": "InterconnectGroupConfiguredTopologyCapabilityIntendedCapabilityBlockers", + "properties": { + "blockerType": { + "enum": [ + "INCOMPATIBLE_METROS", + "NOT_AVAILABLE", + "NO_INTERCONNECTS", + "NO_INTERCONNECTS_IN_METRO_AND_ZONE", + "OTHER", + "UNSPECIFIED" + ], + "enumDescriptions": [ + "", + "", + "", + "", + "", + "" ], - "description": "Returns the specified commitment resource." + "readOnly": true, + "type": "string" }, - "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" - } + "documentationLink": { + "description": "Output only. [Output Only] The url of Google Cloud public documentation explaining\nthis requirement. This is set for every type of requirement.", + "readOnly": true, + "type": "string" + }, + "explanation": { + "description": "Output only. [Output Only] A human-readable explanation of this requirement and\nwhy it's not met. This is set for every type of requirement.", + "readOnly": true, + "type": "string" + }, + "facilities": { + "description": "Output only. [Output Only] Facilities used to explain this blocker in more detail.\nLike physicalStructure.metros.facilities.facility, this is a numeric\nstring like \"5467\".", + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "region" - ], - "request": { - "$ref": "Commitment" + "readOnly": true, + "type": "array" + }, + "interconnects": { + "description": "Output only. [Output Only] Interconnects used to explain this blocker in more\ndetail.", + "items": { + "type": "string" }, - "response": { - "$ref": "Operation" + "readOnly": true, + "type": "array" + }, + "metros": { + "description": "Output only. [Output Only] Metros used to explain this blocker in more detail.\nThese are three-letter lowercase strings like \"iad\". A blocker like\nINCOMPATIBLE_METROS will specify the problematic metros in this\nfield.", + "items": { + "type": "string" }, - "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." + "readOnly": true, + "type": "array" }, - "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 that you want 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 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" - } + "zones": { + "description": "Output only. [Output Only] Zones used to explain this blocker in more detail.\nZone names are \"zone1\" and/or \"zone2\".", + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "region", - "commitment" + "readOnly": true, + "type": "array" + } + }, + "type": "object" + }, + "InterconnectGroupIntent": { + "description": "The user's intent for this group. This is the only required field besides\nthe name that must be specified on group creation.", + "id": "InterconnectGroupIntent", + "properties": { + "topologyCapability": { + "enum": [ + "NO_SLA", + "PRODUCTION_CRITICAL", + "PRODUCTION_NON_CRITICAL", + "UNSPECIFIED" ], - "request": { - "$ref": "Commitment" + "enumDescriptions": [ + "", + "", + "", + "" + ], + "type": "string" + } + }, + "type": "object" + }, + "InterconnectGroupInterconnect": { + "description": "An Interconnect in this InterconnectGroup.", + "id": "InterconnectGroupInterconnect", + "properties": { + "interconnect": { + "description": "The URL of an Interconnect in this group. All Interconnects in the group\nare unique.", + "type": "string" + } + }, + "type": "object" + }, + "InterconnectGroupPhysicalStructure": { + "description": "[Output Only] An analysis of the physical layout of Interconnects in this\ngroup. Every Interconnect in the group is shown once in this structure.", + "id": "InterconnectGroupPhysicalStructure", + "properties": { + "metros": { + "items": { + "$ref": "InterconnectGroupPhysicalStructureMetros" }, - "response": { - "$ref": "Operation" + "readOnly": true, + "type": "array" + } + }, + "type": "object" + }, + "InterconnectGroupPhysicalStructureMetros": { + "description": "[Output Only] The metros Interconnects in this group are in.", + "id": "InterconnectGroupPhysicalStructureMetros", + "properties": { + "facilities": { + "items": { + "$ref": "InterconnectGroupPhysicalStructureMetrosFacilities" }, - "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 updated: auto_renew and plan." + "readOnly": true, + "type": "array" + }, + "metro": { + "description": "Output only. [Output Only] The name of the metro, as a three-letter lowercase string\nlike \"iad\". This is the first component of the location of\nInterconnects underneath this.", + "readOnly": true, + "type": "string" } - } + }, + "type": "object" }, - "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" - } + "InterconnectGroupPhysicalStructureMetrosFacilities": { + "description": "[Output Only] The facilities Interconnects in this metro are present\nin.", + "id": "InterconnectGroupPhysicalStructureMetrosFacilities", + "properties": { + "facility": { + "description": "Output only. [Output Only] The ID of this facility, as a numeric string like\n\"5467\". This is the third component of the location of Interconnects\nin this facility.", + "readOnly": true, + "type": "string" + }, + "zones": { + "items": { + "$ref": "InterconnectGroupPhysicalStructureMetrosFacilitiesZones" }, - "parameterOrder": [ - "project", - "zone" + "readOnly": true, + "type": "array" + } + }, + "type": "object" + }, + "InterconnectGroupPhysicalStructureMetrosFacilitiesZones": { + "description": "[Output Only] The zones that Interconnects in this facility are\npresent in.", + "id": "InterconnectGroupPhysicalStructureMetrosFacilitiesZones", + "properties": { + "interconnects": { + "description": "Output only. [Output Only] URLs of Interconnects in this redundancy group in the\ngiven metro, facility, and zone.", + "items": { + "type": "string" + }, + "readOnly": true, + "type": "array" + }, + "zone": { + "description": "Output only. [Output Only] The name of the zone, either \"zone1\" or \"zone2\".\nThis is the second component of the location of Interconnects in\nthis facility.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "InterconnectGroupsCreateMembers": { + "id": "InterconnectGroupsCreateMembers", + "properties": { + "intentMismatchBehavior": { + "description": "How to behave when configured.topologyCapability.supportedSLA would not\nequal intent.topologyCapability after this call.", + "enum": [ + "CREATE", + "REJECT", + "UNSPECIFIED" ], - "response": { - "$ref": "DiskTypeList" + "enumDescriptions": [ + "", + "", + "" + ], + "type": "string" + }, + "interconnects": { + "items": { + "$ref": "InterconnectGroupsCreateMembersInterconnectInput" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "type": "array" + }, + "templateInterconnect": { + "$ref": "InterconnectGroupsCreateMembersInterconnectInput", + "description": "Parameters for the Interconnects to create." + } + }, + "type": "object" + }, + "InterconnectGroupsCreateMembersInterconnectInput": { + "id": "InterconnectGroupsCreateMembersInterconnectInput", + "properties": { + "adminEnabled": { + "description": "Administrative status of the interconnect. When this is set to true, the\nInterconnect is functional and can carry traffic.\nWhen set to false, no packets can be carried over the interconnect and\nno BGP routes are exchanged over it. By default, the status is set to\ntrue.", + "type": "boolean" + }, + "customerName": { + "description": "Customer name, to put in the Letter of Authorization as the party\nauthorized to request a crossconnect.", + "type": "string" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you\ncreate the resource.", + "type": "string" + }, + "facility": { + "description": "A zone-free location to use for all Interconnects created in this call,\nlike \"iad-1234\".", + "type": "string" + }, + "interconnectType": { + "description": "Type of interconnect, which can take one of the following values:\n \n - PARTNER: A partner-managed interconnection shared between\n customers though a partner. \n - DEDICATED: A dedicated physical\n interconnection with the customer.\n\n Note that a value IT_PRIVATE\nhas been deprecated in favor of DEDICATED.", + "enum": [ + "DEDICATED", + "IT_PRIVATE", + "PARTNER" + ], + "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": "Retrieves a list of disk types available to the specified project." + "type": "string" }, - "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" - } + "linkType": { + "description": "Type of link requested, which can take one of the following values:\n \n - LINK_TYPE_ETHERNET_10G_LR: A 10G Ethernet with LR optics\n - LINK_TYPE_ETHERNET_100G_LR: A 100G Ethernet with LR optics.\n - LINK_TYPE_ETHERNET_400G_LR4: A 400G Ethernet with LR4\n optics.\n\n Note that this field indicates the speed of each of the\nlinks in the bundle, not the speed of the entire bundle.", + "enum": [ + "LINK_TYPE_ETHERNET_100G_LR", + "LINK_TYPE_ETHERNET_10G_LR", + "LINK_TYPE_ETHERNET_400G_LR4" + ], + "enumDescriptions": [ + "100G Ethernet, LR Optics.", + "10G Ethernet, LR Optics.\n[(rate_bps) = 10000000000];", + "400G Ethernet, LR4 Optics." + ], + "type": "string" + }, + "name": { + "description": "Name of the Interconnects to be created. This must be specified on the\ntemplate and/or on each individual interconnect. The name, if not empty,\nmust be 1-63 characters long, and comply with RFC1035.\nSpecifically, any nonempty name must be 1-63 characters long and match\nthe regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first\ncharacter must be a lowercase letter, and all following characters must\nbe a dash, lowercase letter, or digit, except the last character, which\ncannot be a dash.", + "type": "string" + }, + "nocContactEmail": { + "description": "Email address to contact the customer NOC for operations and maintenance\nnotifications regarding this Interconnect. If specified, this will be\nused for notifications in addition to all other forms described, such as\nCloud Monitoring logs alerting and Cloud Notifications. This field is\nrequired for users who sign up for Cloud Interconnect using\nworkforce identity federation.", + "type": "string" + }, + "remoteLocation": { + "description": "Indicates that this is a Cross-Cloud Interconnect. This field specifies\nthe location outside of Google's network that the interconnect is\nconnected to.", + "type": "string" + }, + "requestedFeatures": { + "description": "Optional. List of features requested for this Interconnect connection,\nwhich can take one of the following values:\n \n - IF_MACSEC: If specified, then the connection is created on MACsec\n capable hardware ports. If not specified, non-MACsec capable ports will\n also be considered.\n - IF_CROSS_SITE_NETWORK: If specified, then the connection is created\n exclusively for Cross-Site Networking. The connection can not be used for\n Cross-Site Networking unless this feature is specified.", + "items": { + "enum": [ + "IF_CROSS_SITE_NETWORK", + "IF_L2_FORWARDING", + "IF_MACSEC" + ], + "enumDescriptions": [ + "Cross-Site Networking", + "L2 Interconnect Attachment Forwarding", + "Media Access Control security (MACsec)" + ], + "type": "string" + }, + "type": "array" + }, + "requestedLinkCount": { + "description": "Target number of physical links in the link bundle, as requested by the\ncustomer.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, + "InterconnectGroupsCreateMembersRequest": { + "id": "InterconnectGroupsCreateMembersRequest", + "properties": { + "request": { + "$ref": "InterconnectGroupsCreateMembers" + } + }, + "type": "object" + }, + "InterconnectGroupsGetOperationalStatusResponse": { + "description": "Response for the InterconnectGroupsGetOperationalStatusResponse.", + "id": "InterconnectGroupsGetOperationalStatusResponse", + "properties": { + "etag": { + "type": "string" + }, + "result": { + "$ref": "InterconnectGroupsOperationalStatus" + } + }, + "type": "object" + }, + "InterconnectGroupsListResponse": { + "id": "InterconnectGroupsListResponse", + "properties": { + "etag": { + "type": "string" + }, + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of InterconnectGroup resources.", + "items": { + "$ref": "InterconnectGroup" }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "DiskTypeAggregatedList" + "type": "array" + }, + "kind": { + "default": "compute#InterconnectGroup", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "unreachables": { + "description": "Output only. [Output Only] Unreachable resources.\nend_interface: MixerListResponseWithEtagBuilder", + "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 an aggregated list of disk types. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." + "readOnly": true, + "type": "array" }, - "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, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "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." + "type": "object" } - } + }, + "type": "object" }, - "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" + "InterconnectGroupsOperationalStatus": { + "description": "Request to get the status of the interconnect group with extra detail.", + "id": "InterconnectGroupsOperationalStatus", + "properties": { + "configured": { + "$ref": "InterconnectGroupConfigured", + "description": "Output only. The configuration analysis, as returned by Get.", + "readOnly": true + }, + "groupStatus": { + "description": "Output only. Summarizes the status of the group.", + "enum": [ + "DEGRADED", + "FULLY_DOWN", + "FULLY_UP", + "GROUPS_STATUS_UNSPECIFIED" ], - "response": { - "$ref": "RegionDiskTypeList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "", + "", + "", + "" ], - "description": "Retrieves a list of regional disk types available to the specified project." + "readOnly": true, + "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" - }, - "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" - } + "intent": { + "$ref": "InterconnectGroupIntent", + "description": "Output only. The intent of the resource, as returned by Get.", + "readOnly": true + }, + "interconnectStatuses": { + "items": { + "$ref": "InterconnectGroupsOperationalStatusInterconnectStatus" }, - "parameterOrder": [ - "project", - "region", - "diskType" + "readOnly": true, + "type": "array" + }, + "operational": { + "$ref": "InterconnectGroupConfigured", + "description": "Output only. The operational state of the group, including only active Interconnects.", + "readOnly": true + } + }, + "type": "object" + }, + "InterconnectGroupsOperationalStatusInterconnectStatus": { + "description": "The status of one Interconnect in the group. The order is arbitrary.", + "id": "InterconnectGroupsOperationalStatusInterconnectStatus", + "properties": { + "adminEnabled": { + "description": "Output only. Whether the Interconnect is enabled.", + "readOnly": true, + "type": "boolean" + }, + "diagnostics": { + "$ref": "InterconnectDiagnostics", + "description": "Output only. The diagnostics of the Interconnect, as returned by the existing\nget-diagnostics method.", + "readOnly": true + }, + "interconnect": { + "description": "Output only. The URL of the Interconnect being described.", + "readOnly": true, + "type": "string" + }, + "isActive": { + "description": "Output only. Whether this interconnect is participating in the redundant\nconfiguration.", + "enum": [ + "ACTIVE", + "INACTIVE", + "IS_ACTIVE_UNSPECIFIED" ], - "response": { - "$ref": "DiskType" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "", + "", + "" ], - "description": "Returns the specified regional disk type." + "readOnly": true, + "type": "string" } - } + }, + "type": "object" }, - "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" + "InterconnectList": { + "description": "Response to the list request, and contains a list of interconnects.", + "id": "InterconnectList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of Interconnect resources.", + "items": { + "$ref": "Interconnect" }, - "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." + "type": "array" }, - "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, + "kind": { + "default": "compute#interconnectList", + "description": "Output only. [Output Only] Type of resource. Alwayscompute#interconnectList for lists of interconnects.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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" + "message": { + "description": "[Output Only] A human-readable description of the warning code.", + "type": "string" } }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "InterconnectAttachmentAggregatedList" + "type": "object" + } + }, + "type": "object" + }, + "InterconnectLocation": { + "description": "Represents an Interconnect Attachment (VLAN) Location resource.\n\nYou can use this resource to find location details about an Interconnect\nattachment (VLAN). For more information about interconnect attachments, read\nCreating VLAN Attachments.", + "id": "InterconnectLocation", + "properties": { + "address": { + "description": "Output only. [Output Only] The postal address of the Point of Presence, each line in\nthe address is separated by a newline character.", + "readOnly": true, + "type": "string" + }, + "availabilityZone": { + "description": "[Output Only] Availability zone for this InterconnectLocation. Within a\nmetropolitan area (metro), maintenance will not be simultaneously scheduled\nin more than one availability zone. Example: \"zone1\" or \"zone2\".", + "type": "string" + }, + "availableFeatures": { + "description": "[Output only] List of features available at this InterconnectLocation,\nwhich can take one of the following values:\n \n - IF_MACSEC\n - IF_CROSS_SITE_NETWORK", + "items": { + "enum": [ + "IF_CROSS_SITE_NETWORK", + "IF_L2_FORWARDING", + "IF_MACSEC" + ], + "enumDescriptions": [ + "Cross-Site Networking", + "L2 Interconnect Attachment Forwarding", + "Media Access Control security (MACsec)" + ], + "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 an aggregated list of interconnect attachments. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." + "type": "array" }, - "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" - } + "availableLinkTypes": { + "description": "[Output only] List of link types available at this InterconnectLocation,\nwhich can take one of the following values:\n \n - LINK_TYPE_ETHERNET_10G_LR\n - LINK_TYPE_ETHERNET_100G_LR\n - LINK_TYPE_ETHERNET_400G_LR4", + "items": { + "enum": [ + "LINK_TYPE_ETHERNET_100G_LR", + "LINK_TYPE_ETHERNET_10G_LR", + "LINK_TYPE_ETHERNET_400G_LR4" + ], + "enumDescriptions": [ + "100G Ethernet, LR Optics.", + "10G Ethernet, LR Optics.\n[(rate_bps) = 10000000000];", + "400G Ethernet, LR4 Optics." + ], + "type": "string" }, - "parameterOrder": [ - "project", - "region", - "interconnectAttachment" + "type": "array" + }, + "city": { + "description": "[Output Only] Metropolitan area designator that indicates which city an\ninterconnect is located.\nFor example: \"Chicago, IL\", \"Amsterdam, Netherlands\".", + "type": "string" + }, + "continent": { + "description": "[Output Only] Continent for this location, which can take one of the\nfollowing values:\n \n - AFRICA\n - ASIA_PAC\n - EUROPE\n - NORTH_AMERICA\n - SOUTH_AMERICA", + "enum": [ + "AFRICA", + "ASIA_PAC", + "C_AFRICA", + "C_ASIA_PAC", + "C_EUROPE", + "C_NORTH_AMERICA", + "C_SOUTH_AMERICA", + "EUROPE", + "NORTH_AMERICA", + "SOUTH_AMERICA" ], - "response": { - "$ref": "InterconnectAttachment" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "", + "", + "", + "", + "", + "", + "", + "", + "", + "" ], - "description": "Returns the specified interconnect attachment." + "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" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request 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" - } + "creationTimestamp": { + "description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", + "readOnly": true, + "type": "string" + }, + "crossSiteInterconnectInfos": { + "description": "[Output Only] A list of InterconnectLocation.CrossSiteInterconnectInfo\nobjects, that describe where Cross-Site Interconnect wires may connect to\nfrom this location and associated connection parameters. Cross-Site\nInterconnect isn't allowed to locations which are not listed.", + "items": { + "$ref": "InterconnectLocationCrossSiteInterconnectInfo" }, - "parameterOrder": [ - "project", - "region" - ], - "request": { - "$ref": "InterconnectAttachment" + "type": "array" + }, + "description": { + "description": "Output only. [Output Only] An optional description of the resource.", + "readOnly": true, + "type": "string" + }, + "facilityProvider": { + "description": "Output only. [Output Only] The name of the provider for this facility (e.g., EQUINIX).", + "readOnly": true, + "type": "string" + }, + "facilityProviderFacilityId": { + "description": "Output only. [Output Only] A provider-assigned Identifier for this facility (e.g.,\nAshburn-DC1).", + "readOnly": true, + "type": "string" + }, + "id": { + "description": "Output only. [Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "format": "uint64", + "readOnly": true, + "type": "string" + }, + "kind": { + "default": "compute#interconnectLocation", + "description": "Output only. [Output Only] Type of the resource. Alwayscompute#interconnectLocation for interconnect locations.", + "readOnly": true, + "type": "string" + }, + "name": { + "description": "Output only. [Output Only] Name of the resource.", + "readOnly": true, + "type": "string" + }, + "peeringdbFacilityId": { + "description": "Output only. [Output Only] The peeringdb identifier for this facility (corresponding\nwith a netfac type in peeringdb).", + "readOnly": true, + "type": "string" + }, + "regionInfos": { + "description": "Output only. [Output Only] A list of InterconnectLocation.RegionInfo objects, that\ndescribe parameters pertaining to the relation between this\nInterconnectLocation and various Google Cloud regions.", + "items": { + "$ref": "InterconnectLocationRegionInfo" }, - "response": { - "$ref": "Operation" + "readOnly": true, + "type": "array" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for the resource.", + "readOnly": true, + "type": "string" + }, + "singleRegionProductionCriticalPeerLocations": { + "description": "Output only. [Output Only] URLs of the other locations that can pair up with this\nlocation to support Single-Region 99.99% SLA. E.g. iad-zone1-1 and\niad-zone2-5467 are Single-Region 99.99% peer locations of each other.", + "items": { + "type": "string" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "readOnly": true, + "type": "array" + }, + "status": { + "description": "[Output Only] The status of this InterconnectLocation, which can take one\nof the following values:\n \n - CLOSED: The InterconnectLocation is closed and is unavailable for\n provisioning new Interconnects.\n - AVAILABLE: The InterconnectLocation is available for provisioning new\n Interconnects.", + "enum": [ + "AVAILABLE", + "CLOSED" + ], + "enumDescriptions": [ + "The InterconnectLocation is available for provisioning new Interconnects.", + "The InterconnectLocation is closed for provisioning new Interconnects." ], - "description": "Creates an InterconnectAttachment in the specified project using the data included in the request." + "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, + "supportsPzs": { + "description": "Output only. [Output Only] Reserved for future use.", + "readOnly": true, + "type": "boolean" + } + }, + "type": "object" + }, + "InterconnectLocationCrossSiteInterconnectInfo": { + "description": "Information about Cross-Site Interconnect wires which may be created\nbetween the containing location and another remote location.", + "id": "InterconnectLocationCrossSiteInterconnectInfo", + "properties": { + "city": { + "description": "Output only. The remote location for Cross-Site Interconnect wires. This specifies an\nInterconnectLocation city (metropolitan area designator), which itself\nmay match multiple InterconnectLocations.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "InterconnectLocationList": { + "description": "Response to the list request, and contains a list of interconnect locations.", + "id": "InterconnectLocationList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of InterconnectLocation resources.", + "items": { + "$ref": "InterconnectLocation" + }, + "type": "array" + }, + "kind": { + "default": "compute#interconnectLocationList", + "description": "Output only. [Output Only] Type of resource. Alwayscompute#interconnectLocationList for lists of interconnect\nlocations.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. 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" } }, - "parameterOrder": [ - "project", - "region", - "interconnectAttachment" + "type": "object" + } + }, + "type": "object" + }, + "InterconnectLocationRegionInfo": { + "description": "Information about any potential InterconnectAttachments between an\nInterconnect at a specific InterconnectLocation, and a specific Cloud\nRegion.", + "id": "InterconnectLocationRegionInfo", + "properties": { + "expectedRttMs": { + "description": "Output only. Expected round-trip time in milliseconds, from this InterconnectLocation\nto a VM in this region.", + "format": "int64", + "readOnly": true, + "type": "string" + }, + "l2ForwardingEnabled": { + "description": "Output only. Identifies whether L2 Interconnect Attachments can be created in this\nregion for interconnects that are in this location.", + "readOnly": true, + "type": "boolean" + }, + "locationPresence": { + "description": "Output only. Identifies the network presence of this location.", + "enum": [ + "GLOBAL", + "LOCAL_REGION", + "LP_GLOBAL", + "LP_LOCAL_REGION" ], - "request": { - "$ref": "InterconnectAttachment" + "enumDescriptions": [ + "This region is not in any common network presence with this\nInterconnectLocation.", + "This region shares the same regional network presence as this\nInterconnectLocation.", + "[Deprecated] This region is not in any common network presence with\nthis InterconnectLocation.", + "[Deprecated] This region shares the same regional network presence as\nthis InterconnectLocation." + ], + "readOnly": true, + "type": "string" + }, + "region": { + "description": "Output only. URL for the region of this location.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "InterconnectMacsec": { + "description": "Configuration information for enabling Media Access Control security\n(MACsec) on this Cloud Interconnect connection between Google and your\non-premises router.", + "id": "InterconnectMacsec", + "properties": { + "failOpen": { + "description": "If set to true, the Interconnect connection is configured with ashould-secure MACsec security policy, that allows the Google\nrouter to fallback to cleartext traffic if the MKA session cannot be\nestablished. By default, the Interconnect connection is configured with amust-secure security policy that drops all traffic if the\nMKA session cannot be established with your router.", + "type": "boolean" + }, + "preSharedKeys": { + "description": "Required. A keychain placeholder describing a set of named key objects\nalong with their start times. A MACsec CKN/CAK is generated for each\nkey in the key chain. Google router automatically picks the key with\nthe most recent startTime when establishing or re-establishing a MACsec\nsecure link.", + "items": { + "$ref": "InterconnectMacsecPreSharedKey" }, - "response": { - "$ref": "Operation" + "type": "array" + } + }, + "type": "object" + }, + "InterconnectMacsecConfig": { + "description": "MACsec configuration information for the Interconnect connection. Contains\nthe generated Connectivity Association Key Name (CKN) and the key (CAK) for\nthis Interconnect connection.", + "id": "InterconnectMacsecConfig", + "properties": { + "preSharedKeys": { + "description": "A keychain placeholder describing a set of named key objects\nalong with their start times. A MACsec CKN/CAK is generated for each key in\nthe key chain. Google router automatically picks the key with the most\nrecent startTime when establishing or re-establishing a MACsec secure link.", + "items": { + "$ref": "InterconnectMacsecConfigPreSharedKey" }, - "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." + "type": "array" + } + }, + "type": "object" + }, + "InterconnectMacsecConfigPreSharedKey": { + "description": "Describes a pre-shared key used to setup MACsec in static connectivity\nassociation key (CAK) mode.", + "id": "InterconnectMacsecConfigPreSharedKey", + "properties": { + "cak": { + "description": "An auto-generated Connectivity Association Key (CAK) for this key.", + "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" - } + "ckn": { + "description": "An auto-generated Connectivity Association Key Name (CKN) for this key.", + "type": "string" + }, + "name": { + "description": "User provided name for this pre-shared key.", + "type": "string" + }, + "startTime": { + "description": "User provided timestamp on or after which this key is valid.", + "type": "string" + } + }, + "type": "object" + }, + "InterconnectMacsecPreSharedKey": { + "description": "Describes a pre-shared key used to setup MACsec in static connectivity\nassociation key (CAK) mode.", + "id": "InterconnectMacsecPreSharedKey", + "properties": { + "name": { + "description": "Required. A name for this pre-shared key.\nThe name must be 1-63 characters long, and comply withRFC1035. Specifically, the name must be 1-63\ncharacters long and match the regular expression\n`[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a\nlowercase letter, and all following characters must be a dash,\nlowercase letter, or digit, except the last character, which cannot be\na dash.", + "type": "string" + }, + "startTime": { + "description": "A RFC3339 timestamp on or after which the key is\nvalid. startTime can be in the future. If the keychain has a single\nkey, startTime can be omitted. If the keychain has multiple keys,\nstartTime is mandatory for each key. The start times of keys must be in\nincreasing order. The start times of two consecutive keys must be\nat least 6 hours apart.", + "type": "string" + } + }, + "type": "object" + }, + "InterconnectOutageNotification": { + "description": "Description of a planned outage on this Interconnect.", + "id": "InterconnectOutageNotification", + "properties": { + "affectedCircuits": { + "description": "If issue_type is IT_PARTIAL_OUTAGE, a list of the Google-side circuit\nIDs that will be affected.", + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "region", - "interconnectAttachment" + "type": "array" + }, + "description": { + "description": "A description about the purpose of the outage.", + "type": "string" + }, + "endTime": { + "description": "Scheduled end time for the outage (milliseconds since Unix\nepoch).", + "format": "int64", + "type": "string" + }, + "issueType": { + "description": "Form this outage is expected to take, which can take one of the following\nvalues:\n \n - OUTAGE: The Interconnect may be completely out of service for\n some or all of the specified window.\n - PARTIAL_OUTAGE: Some circuits comprising the Interconnect as a whole\n should remain up, but with reduced bandwidth.\n\n\nNote that the versions of this enum prefixed with \"IT_\" have been\ndeprecated in favor of the unprefixed values.", + "enum": [ + "IT_OUTAGE", + "IT_PARTIAL_OUTAGE", + "OUTAGE", + "PARTIAL_OUTAGE" ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "[Deprecated] The Interconnect may be completely out of service for some\nor all of the specified window.", + "[Deprecated] Some circuits comprising the Interconnect will be out of\nservice during the expected window. The interconnect as a whole should\nremain up, albeit with reduced bandwidth.", + "The Interconnect may be completely out of service for some or all of\nthe specified window.", + "Some circuits comprising the Interconnect will be out of service during\nthe expected window. The interconnect as a whole should remain\nup, albeit with reduced bandwidth." ], - "description": "Deletes the specified interconnect attachment." + "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" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request 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" + "name": { + "description": "Unique identifier for this outage notification.", + "type": "string" + }, + "source": { + "description": "The party that generated this notification, which can take the following\nvalue:\n \n - GOOGLE: this notification as generated by Google.\n\n\nNote that the value of NSRC_GOOGLE has been deprecated in favor of\nGOOGLE.", + "enum": [ + "GOOGLE", + "NSRC_GOOGLE" ], - "request": { - "$ref": "RegionSetLabelsRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "This notification was generated by Google.", + "[Deprecated] This notification was generated by Google." + ], + "type": "string" + }, + "startTime": { + "description": "Scheduled start time for the outage (milliseconds since Unix\nepoch).", + "format": "int64", + "type": "string" + }, + "state": { + "description": "State of this notification, which can take one of the following values:\n \n - ACTIVE: This outage notification is active. The event could be in\n the past, present, or future. See start_time and end_time for\n scheduling.\n - CANCELLED: The outage associated with this notification was cancelled\n before the outage was due to start.\n - COMPLETED: The outage associated with this notification is complete.\n\n\nNote that the versions of this enum prefixed with \"NS_\" have been\ndeprecated in favor of the unprefixed values.", + "enum": [ + "ACTIVE", + "CANCELLED", + "COMPLETED", + "NS_ACTIVE", + "NS_CANCELED" ], - "description": "Sets the labels on an InterconnectAttachment. To learn more about labels, read the Labeling Resources documentation." + "enumDescriptions": [ + "This outage notification is active. The event could be in the future,\npresent, or past. See start_time and end_time for scheduling.", + "The outage associated with this notification was cancelled before the\noutage was due to start.", + "The outage associated with this notification is complete.", + "[Deprecated] This outage notification is active. The event could be in\nthe future, present, or past. See start_time and end_time for\nscheduling.", + "[Deprecated] The outage associated with this notification was canceled\nbefore the outage was due to start." + ], + "type": "string" } - } + }, + "type": "object" }, - "interconnectAttachmentGroups": { - "methods": { - "list": { - "id": "compute.interconnectAttachmentGroups.list", - "path": "projects/{project}/global/interconnectAttachmentGroups", - "flatPath": "projects/{project}/global/interconnectAttachmentGroups", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not 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" - } + "InterconnectParams": { + "description": "Additional interconnect parameters.", + "id": "InterconnectParams", + "properties": { + "resourceManagerTags": { + "additionalProperties": { + "type": "string" }, - "parameterOrder": [ - "project" + "description": "Tag keys/values directly bound to this resource.\nTag keys and values have the same definition as resource\nmanager tags. The field is allowed for INSERT\nonly. The keys/values to set on the resource should be specified in\neither ID { : } or Namespaced format\n{ : }.\nFor example the following are valid inputs:\n* {\"tagKeys/333\" : \"tagValues/444\", \"tagKeys/123\" : \"tagValues/456\"}\n* {\"123/environment\" : \"production\", \"345/abc\" : \"xyz\"}\nNote:\n* Invalid combinations of ID & namespaced format is not supported. For\n instance: {\"123/environment\" : \"tagValues/444\"} is invalid.\n* Inconsistent format is not supported. For instance:\n {\"tagKeys/333\" : \"tagValues/444\", \"123/env\" : \"prod\"} is invalid.", + "type": "object" + } + }, + "type": "object" + }, + "InterconnectRemoteLocation": { + "description": "Represents a Cross-Cloud Interconnect Remote Location resource.\n\nYou can use this resource to find remote location details about an\nInterconnect attachment (VLAN).", + "id": "InterconnectRemoteLocation", + "properties": { + "address": { + "description": "Output only. [Output Only] The postal address of the Point of Presence, each line in\nthe address is separated by a newline character.", + "readOnly": true, + "type": "string" + }, + "attachmentConfigurationConstraints": { + "$ref": "InterconnectAttachmentConfigurationConstraints", + "description": "Output only. [Output Only] Subset of fields from InterconnectAttachment's\n|configurationConstraints| field that apply to all attachments for this\nremote location.", + "readOnly": true + }, + "city": { + "description": "Output only. [Output Only] Metropolitan area designator that indicates which city an\ninterconnect is located.\nFor example: \"Chicago, IL\", \"Amsterdam, Netherlands\".", + "readOnly": true, + "type": "string" + }, + "constraints": { + "$ref": "InterconnectRemoteLocationConstraints", + "description": "Output only. [Output Only] Constraints on the parameters for creating Cross-Cloud\nInterconnect and associated InterconnectAttachments.", + "readOnly": true + }, + "continent": { + "description": "Output only. [Output Only] Continent for this location, which can take one of the\nfollowing values:\n \n - AFRICA\n - ASIA_PAC\n - EUROPE\n - NORTH_AMERICA\n - SOUTH_AMERICA", + "enum": [ + "AFRICA", + "ASIA_PAC", + "EUROPE", + "NORTH_AMERICA", + "SOUTH_AMERICA" ], - "response": { - "$ref": "InterconnectAttachmentGroupsListResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "", + "", + "", + "", + "" ], - "description": "Lists the InterconnectAttachmentGroups for a project in the given scope." + "readOnly": true, + "type": "string" }, - "get": { - "id": "compute.interconnectAttachmentGroups.get", - "path": "projects/{project}/global/interconnectAttachmentGroups/{interconnectAttachmentGroup}", - "flatPath": "projects/{project}/global/interconnectAttachmentGroups/{interconnectAttachmentGroup}", - "httpMethod": "GET", - "parameters": { - "interconnectAttachmentGroup": { - "description": "Name of the InterconnectAttachmentGroup 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", - "interconnectAttachmentGroup" + "creationTimestamp": { + "description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "Output only. [Output Only] An optional description of the resource.", + "readOnly": true, + "type": "string" + }, + "facilityProvider": { + "description": "Output only. [Output Only] The name of the provider for this facility (e.g., EQUINIX).", + "readOnly": true, + "type": "string" + }, + "facilityProviderFacilityId": { + "description": "Output only. [Output Only] A provider-assigned Identifier for this facility (e.g.,\nAshburn-DC1).", + "readOnly": true, + "type": "string" + }, + "id": { + "description": "Output only. [Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "format": "uint64", + "readOnly": true, + "type": "string" + }, + "kind": { + "default": "compute#interconnectRemoteLocation", + "description": "Output only. [Output Only] Type of the resource. Alwayscompute#interconnectRemoteLocation for interconnect remote\nlocations.", + "readOnly": true, + "type": "string" + }, + "lacp": { + "description": "Output only. [Output Only] Link Aggregation Control Protocol (LACP) constraints, which\ncan take one of the following values: LACP_SUPPORTED, LACP_UNSUPPORTED", + "enum": [ + "LACP_SUPPORTED", + "LACP_UNSUPPORTED" ], - "response": { - "$ref": "InterconnectAttachmentGroup" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "LACP_SUPPORTED: LACP is supported, and enabled by default on\nthe Cross-Cloud Interconnect.", + "LACP_UNSUPPORTED: LACP is not supported and is not be enabled on this\nport. GetDiagnostics shows bundleAggregationType as \"static\". GCP does\nnot support LAGs without LACP, so requestedLinkCount must be 1." ], - "description": "Returns the specified InterconnectAttachmentGroup resource in the given scope." + "readOnly": true, + "type": "string" }, - "insert": { - "id": "compute.interconnectAttachmentGroups.insert", - "path": "projects/{project}/global/interconnectAttachmentGroups", - "flatPath": "projects/{project}/global/interconnectAttachmentGroups", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating 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" - } + "maxLagSize100Gbps": { + "description": "Output only. [Output Only]\nThe maximum number of 100 Gbps ports supported in a link aggregation group\n(LAG). When linkType is 100 Gbps, requestedLinkCount cannot exceed\nmax_lag_size_100_gbps.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "maxLagSize10Gbps": { + "description": "Output only. [Output Only]\nThe maximum number of 10 Gbps ports supported in a link aggregation group\n(LAG). When linkType is 10 Gbps, requestedLinkCount cannot exceed\nmax_lag_size_10_gbps.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "maxLagSize400Gbps": { + "description": "Output only. [Output Only]\nThe maximum number of 400 Gbps ports supported in a link aggregation group\n(LAG). When linkType is 400 Gbps, requestedLinkCount cannot exceed\nmax_lag_size_400_gbps.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "name": { + "description": "Output only. [Output Only] Name of the resource.", + "readOnly": true, + "type": "string" + }, + "peeringdbFacilityId": { + "description": "Output only. [Output Only] The peeringdb identifier for this facility (corresponding\nwith a netfac type in peeringdb).", + "readOnly": true, + "type": "string" + }, + "permittedConnections": { + "description": "Output only. [Output Only] Permitted connections.", + "items": { + "$ref": "InterconnectRemoteLocationPermittedConnections" }, - "parameterOrder": [ - "project" + "readOnly": true, + "type": "array" + }, + "remoteService": { + "description": "Output only. [Output Only] Indicates the service provider present at the remote\nlocation. Example values: \"Amazon Web Services\", \"Microsoft Azure\".", + "readOnly": true, + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for the resource.", + "readOnly": true, + "type": "string" + }, + "status": { + "description": "Output only. [Output Only] The status of this InterconnectRemoteLocation, which can take\none of the following values:\n \n - CLOSED: The InterconnectRemoteLocation is closed and is unavailable\n for provisioning new Cross-Cloud Interconnects. \n - AVAILABLE: The\n InterconnectRemoteLocation is available for provisioning new\n Cross-Cloud Interconnects.", + "enum": [ + "AVAILABLE", + "CLOSED" ], - "request": { - "$ref": "InterconnectAttachmentGroup" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "The InterconnectRemoteLocation is available for provisioning new\nCross-Cloud Interconnects.", + "The InterconnectRemoteLocation is closed for provisioning new\nCross-Cloud Interconnects." + ], + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "InterconnectRemoteLocationConstraints": { + "id": "InterconnectRemoteLocationConstraints", + "properties": { + "portPairRemoteLocation": { + "description": "Output only. [Output Only] Port pair remote location constraints, which can take one\nof the following values: PORT_PAIR_UNCONSTRAINED_REMOTE_LOCATION,\nPORT_PAIR_MATCHING_REMOTE_LOCATION.\n\nGoogle Cloud API refers only to individual ports, but the UI uses this\nfield when ordering a pair of ports, to prevent users from accidentally\nordering something that is incompatible with their cloud provider.\nSpecifically, when ordering a redundant pair of Cross-Cloud Interconnect\nports, and one of them uses a remote location with\nportPairMatchingRemoteLocation set to matching, the UI requires that\nboth ports use the same remote location.", + "enum": [ + "PORT_PAIR_MATCHING_REMOTE_LOCATION", + "PORT_PAIR_UNCONSTRAINED_REMOTE_LOCATION" + ], + "enumDescriptions": [ + "If PORT_PAIR_MATCHING_REMOTE_LOCATION, the remote cloud provider\nallocates ports in pairs, and the user should choose the same remote\nlocation for both ports.", + "If PORT_PAIR_UNCONSTRAINED_REMOTE_LOCATION, a user may opt to provision\na redundant pair of Cross-Cloud Interconnects using two different\nremote locations in the same city." ], - "description": "Creates a InterconnectAttachmentGroup in the specified project in the given scope using the parameters that are included in the request." + "readOnly": true, + "type": "string" }, - "delete": { - "id": "compute.interconnectAttachmentGroups.delete", - "path": "projects/{project}/global/interconnectAttachmentGroups/{interconnectAttachmentGroup}", - "flatPath": "projects/{project}/global/interconnectAttachmentGroups/{interconnectAttachmentGroup}", - "httpMethod": "DELETE", - "parameters": { - "interconnectAttachmentGroup": { - "description": "Name of the InterconnectAttachmentGroup 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). end_interface: MixerMutationRequestBuilder", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "interconnectAttachmentGroup" + "portPairVlan": { + "description": "Output only. [Output Only] Port pair VLAN constraints, which can take one of the\nfollowing values: PORT_PAIR_UNCONSTRAINED_VLAN, PORT_PAIR_MATCHING_VLAN", + "enum": [ + "PORT_PAIR_MATCHING_VLAN", + "PORT_PAIR_UNCONSTRAINED_VLAN" ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "If PORT_PAIR_MATCHING_VLAN, the Interconnect for this attachment is\npart of a pair of ports that should have matching VLAN allocations.\nThis occurs with Cross-Cloud Interconnect to Azure remote locations.\nWhile GCP's API does not explicitly group pairs of ports, the UI uses\nthis field to ensure matching VLAN ids when configuring a redundant\nVLAN pair.", + "PORT_PAIR_UNCONSTRAINED_VLAN means there is no constraint." ], - "description": "Deletes the specified InterconnectAttachmentGroup in the given scope" + "readOnly": true, + "type": "string" }, - "patch": { - "id": "compute.interconnectAttachmentGroups.patch", - "path": "projects/{project}/global/interconnectAttachmentGroups/{interconnectAttachmentGroup}", - "flatPath": "projects/{project}/global/interconnectAttachmentGroups/{interconnectAttachmentGroup}", - "httpMethod": "PATCH", - "parameters": { - "interconnectAttachmentGroup": { - "description": "Name of the InterconnectAttachmentGroup resource to patch.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, + "subnetLengthRange": { + "$ref": "InterconnectRemoteLocationConstraintsSubnetLengthRange", + "description": "Output only. [Output Only]\n\n[min-length, max-length] \n\nThe minimum and maximum value (inclusive) for the IPv4 subnet\nlength.\n\n For example, an interconnectRemoteLocation for Azure has {min: 30,\nmax:\n30} because Azure requires /30 subnets. \n\nThis range specifies the values supported by both cloud providers.\nInterconnect currently supports /29 and /30 IPv4 subnet lengths. If a\nremote cloud has no constraint on IPv4 subnet length, the range would\nthus be {min: 29, max: 30}.", + "readOnly": true + } + }, + "type": "object" + }, + "InterconnectRemoteLocationConstraintsSubnetLengthRange": { + "id": "InterconnectRemoteLocationConstraintsSubnetLengthRange", + "properties": { + "max": { + "format": "int32", + "type": "integer" + }, + "min": { + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, + "InterconnectRemoteLocationList": { + "description": "Response to the list request, and contains a list of interconnect remote\nlocations.", + "id": "InterconnectRemoteLocationList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of InterconnectRemoteLocation resources.", + "items": { + "$ref": "InterconnectRemoteLocation" + }, + "type": "array" + }, + "kind": { + "default": "compute#interconnectRemoteLocationList", + "description": "Output only. [Output Only] Type of resource. Alwayscompute#interconnectRemoteLocationList for lists of\ninterconnect remote locations.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token lets you get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating 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", + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" - }, - "updateMask": { - "description": "The list of fields to update.", - "location": "query", - "type": "string", - "format": "google-fieldmask" } }, - "parameterOrder": [ - "project", - "interconnectAttachmentGroup" - ], - "request": { - "$ref": "InterconnectAttachmentGroup" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Patches the specified InterconnectAttachmentGroup resource with the data included in the request. This method supports PATCH semantics and uses JSON merge patch format and processing rules." + "type": "object" + } + }, + "type": "object" + }, + "InterconnectRemoteLocationPermittedConnections": { + "id": "InterconnectRemoteLocationPermittedConnections", + "properties": { + "interconnectLocation": { + "description": "Output only. [Output Only] URL of an Interconnect location that is permitted to\nconnect to this Interconnect remote location.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "InterconnectsGetDiagnosticsResponse": { + "description": "Response for the InterconnectsGetDiagnosticsRequest.", + "id": "InterconnectsGetDiagnosticsResponse", + "properties": { + "result": { + "$ref": "InterconnectDiagnostics" + } + }, + "type": "object" + }, + "InterconnectsGetMacsecConfigResponse": { + "description": "Response for the InterconnectsGetMacsecConfigRequest.", + "id": "InterconnectsGetMacsecConfigResponse", + "properties": { + "etag": { + "description": "end_interface: MixerGetResponseWithEtagBuilder", + "type": "string" }, - "getIamPolicy": { - "id": "compute.interconnectAttachmentGroups.getIamPolicy", - "path": "projects/{project}/global/interconnectAttachmentGroups/{resource}/getIamPolicy", - "flatPath": "projects/{project}/global/interconnectAttachmentGroups/{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" - } + "result": { + "$ref": "InterconnectMacsecConfig" + } + }, + "type": "object" + }, + "License": { + "description": "Represents a License resource.\n\nA License represents billing and aggregate usage data forpublic andmarketplace images.\n *Caution* This resource is intended for\nuse only by third-party partners who are creatingCloud Marketplace\nimages.", + "id": "License", + "properties": { + "allowedReplacementLicenses": { + "description": "Specifies licenseCodes of licenses that can replace this license. Note:\nsuch replacements are allowed even if removable_from_disk is false.", + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "resource" - ], - "response": { - "$ref": "Policy" + "type": "array" + }, + "appendableToDisk": { + "description": "If true, this license can be appended to an existing disk's set of\nlicenses.", + "type": "boolean" + }, + "chargesUseFee": { + "description": "[Output Only] Deprecated. This field no longer reflects whether a license\ncharges a usage fee.", + "type": "boolean" + }, + "creationTimestamp": { + "description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "An optional textual description of the resource; provided by the client\nwhen the resource is created.", + "type": "string" + }, + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "format": "uint64", + "type": "string" + }, + "incompatibleLicenses": { + "description": "Specifies licenseCodes of licenses that are incompatible with this license.\nIf a license is incompatible with this license, it cannot be attached to\nthe same disk or image.", + "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": "Gets the access control policy for a resource. May be empty if no such policy or resource exists." + "type": "array" }, - "setIamPolicy": { - "id": "compute.interconnectAttachmentGroups.setIamPolicy", - "path": "projects/{project}/global/interconnectAttachmentGroups/{resource}/setIamPolicy", - "flatPath": "projects/{project}/global/interconnectAttachmentGroups/{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" - } + "kind": { + "default": "compute#license", + "description": "Output only. [Output Only] Type of resource. Always compute#license for\nlicenses.", + "readOnly": true, + "type": "string" + }, + "licenseCode": { + "description": "[Output Only] The unique code used to attach this license to images,\nsnapshots, and disks.", + "format": "uint64", + "type": "string" + }, + "minimumRetention": { + "$ref": "Duration", + "description": "If set, this license will be unable to be removed or replaced once attached\nto a disk until the minimum_retention period has passed." + }, + "multiTenantOnly": { + "description": "If true, this license can only be used on VMs on multi tenant nodes.", + "type": "boolean" + }, + "name": { + "annotations": { + "required": [ + "compute.images.insert" + ] }, - "parameterOrder": [ - "project", - "resource" - ], - "request": { - "$ref": "GlobalSetPolicyRequest" + "description": "Name of the resource. The name must be 1-63 characters long and\ncomply withRFC1035.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "osLicense": { + "description": "If true, indicates this is an OS license. Only one OS license can be\nattached to a disk or image at a time.", + "type": "boolean" + }, + "params": { + "$ref": "LicenseParams", + "description": "Input only. Additional params passed with the request, but not persisted\nas part of resource payload." + }, + "removableFromDisk": { + "description": "If true, this license can be removed from a disk's set of licenses, with no\nreplacement license needed.", + "type": "boolean" + }, + "requiredCoattachedLicenses": { + "description": "Specifies the set of permissible coattached licenseCodes of licenses that\nsatisfy the coattachment requirement of this license. At least one license\nfrom the set must be attached to the same disk or image as this license.", + "items": { + "type": "string" }, - "response": { - "$ref": "Policy" + "type": "array" + }, + "resourceRequirements": { + "$ref": "LicenseResourceRequirements", + "description": "[Input Only] Deprecated." + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for the resource.", + "readOnly": true, + "type": "string" + }, + "selfLinkWithId": { + "description": "Output only. [Output Only] Server-defined URL for this resource with the resource id.", + "readOnly": true, + "type": "string" + }, + "soleTenantOnly": { + "description": "If true, this license can only be used on VMs on sole tenant nodes.", + "type": "boolean" + }, + "transferable": { + "description": "If false, licenses will not be copied from the source resource when\ncreating an image from a disk, disk from snapshot, or snapshot from disk.", + "type": "boolean" + }, + "updateTimestamp": { + "description": "Output only. [Output Only] Last update timestamp inRFC3339\ntext format.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "LicenseCode": { + "description": "Represents a License Code resource.\n\nA License Code is a unique identifier used to represent alicense\nresource.\n *Caution* This resource is intended for\nuse only by third-party partners who are creatingCloud Marketplace\nimages.", + "id": "LicenseCode", + "properties": { + "allowedReplacementLicenses": { + "description": "Specifies licenseCodes of licenses that can replace this license. Note:\nsuch replacements are allowed even if removable_from_disk is false.", + "items": { + "type": "string" }, - "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." + "type": "array" }, - "testIamPermissions": { - "id": "compute.interconnectAttachmentGroups.testIamPermissions", - "path": "projects/{project}/global/interconnectAttachmentGroups/{resource}/testIamPermissions", - "flatPath": "projects/{project}/global/interconnectAttachmentGroups/{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" - } + "appendableToDisk": { + "description": "If true, this license can be appended to an existing disk's set of\nlicenses.", + "type": "boolean" + }, + "creationTimestamp": { + "description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "Output only. [Output Only] Description of this License Code.", + "readOnly": true, + "type": "string" + }, + "id": { + "description": "Output only. [Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "format": "uint64", + "readOnly": true, + "type": "string" + }, + "incompatibleLicenses": { + "description": "Specifies licenseCodes of licenses that are incompatible with this license.\nIf a license is incompatible with this license, it cannot be attached to\nthe same disk or image.", + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "resource" - ], - "request": { - "$ref": "TestPermissionsRequest" + "type": "array" + }, + "kind": { + "default": "compute#licenseCode", + "description": "Output only. [Output Only] Type of resource. Always compute#licenseCode for\nlicenses.", + "readOnly": true, + "type": "string" + }, + "licenseAlias": { + "description": "[Output Only] URL and description aliases of Licenses with the same\nLicense Code.", + "items": { + "$ref": "LicenseCodeLicenseAlias" }, - "response": { - "$ref": "TestPermissionsResponse" + "type": "array" + }, + "minimumRetention": { + "$ref": "Duration", + "description": "If set, this license will be unable to be removed or replaced once attached\nto a disk until the minimum_retention period has passed." + }, + "multiTenantOnly": { + "description": "If true, this license can only be used on VMs on multi tenant nodes.", + "type": "boolean" + }, + "name": { + "annotations": { + "required": [ + "compute.licenses.insert" + ] }, - "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": "Output only. [Output Only] Name of the resource. The name is 1-20 characters long and\nmust be a valid 64 bit integer.", + "pattern": "[0-9]{0,20}?", + "readOnly": true, + "type": "string" }, - "getOperationalStatus": { - "id": "compute.interconnectAttachmentGroups.getOperationalStatus", - "path": "projects/{project}/global/interconnectAttachmentGroups/{interconnectAttachmentGroup}/getOperationalStatus", - "flatPath": "projects/{project}/global/interconnectAttachmentGroups/{interconnectAttachmentGroup}/getOperationalStatus", - "httpMethod": "GET", - "parameters": { - "interconnectAttachmentGroup": { - "description": "Name of the interconnectAttachmentGroup 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" - } + "osLicense": { + "description": "If true, indicates this is an OS license. Only one OS license can be\nattached to a disk or image at a time.", + "type": "boolean" + }, + "removableFromDisk": { + "description": "If true, this license can be removed from a disk's set of licenses, with no\nreplacement license needed.", + "type": "boolean" + }, + "requiredCoattachedLicenses": { + "description": "Specifies the set of permissible coattached licenseCodes of licenses that\nsatisfy the coattachment requirement of this license. At least one license\nfrom the set must be attached to the same disk or image as this license.", + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "interconnectAttachmentGroup" + "type": "array" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for the resource.", + "readOnly": true, + "type": "string" + }, + "soleTenantOnly": { + "description": "If true, this license can only be used on VMs on sole tenant nodes.", + "type": "boolean" + }, + "state": { + "description": "Output only. [Output Only] Current state of this License Code.", + "enum": [ + "DISABLED", + "ENABLED", + "RESTRICTED", + "STATE_UNSPECIFIED", + "TERMINATED" ], - "response": { - "$ref": "InterconnectAttachmentGroupsGetOperationalStatusResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "Machines are not allowed to attach boot disks with this License Code.\nRequests 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." ], - "description": "Returns the InterconnectAttachmentStatuses for the specified InterconnectAttachmentGroup resource." + "readOnly": true, + "type": "string" + }, + "transferable": { + "description": "Output only. [Output Only] If true, the license will remain attached when creating\nimages or snapshots from disks. Otherwise, the license is not transferred.", + "readOnly": true, + "type": "boolean" + }, + "updateTimestamp": { + "description": "Output only. [Output Only] Last update timestamp inRFC3339\ntext format.", + "readOnly": true, + "type": "string" } - } + }, + "type": "object" }, - "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" + "LicenseCodeLicenseAlias": { + "id": "LicenseCodeLicenseAlias", + "properties": { + "description": { + "description": "Output only. [Output Only] Description of this License Code.", + "readOnly": true, + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] URL of license corresponding to this License Code.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "LicenseParams": { + "description": "Additional license params.", + "id": "LicenseParams", + "properties": { + "resourceManagerTags": { + "additionalProperties": { + "type": "string" }, - "response": { - "$ref": "Operation" + "description": "Input only. Resource manager tags to be bound to the license. Tag keys and values\nhave the same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in\nnamespaced format such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT &\nPATCH) when empty.", + "type": "object" + } + }, + "type": "object" + }, + "LicenseResourceCommitment": { + "description": "Commitment for a particular license resource.", + "id": "LicenseResourceCommitment", + "properties": { + "amount": { + "description": "The number of licenses you plan to purchase.", + "format": "int64", + "type": "string" + }, + "coresPerLicense": { + "description": "The number of cores per license.", + "type": "string" + }, + "license": { + "description": "The applicable license URI.", + "type": "string" + } + }, + "type": "object" + }, + "LicenseResourceRequirements": { + "id": "LicenseResourceRequirements", + "properties": { + "minGuestCpuCount": { + "description": "[Input Only] Deprecated. This field no longer reflects the minimum number\nof guest cpus required to use the Instance.", + "format": "int32", + "type": "integer" + }, + "minMemoryMb": { + "description": "[Input Only] Deprecated. This field no longer reflects the minimum memory\nrequired to use the Instance.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, + "LicensesListResponse": { + "id": "LicensesListResponse", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of License resources.", + "items": { + "$ref": "License" }, - "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." + "type": "array" }, - "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", + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "pageToken": { - "description": "Specifies a page token 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{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" } }, - "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." + "type": "object" + } + }, + "type": "object" + }, + "ListInstantSnapshotGroups": { + "description": "Contains a list of InstantSnapshotGroup resources.", + "id": "ListInstantSnapshotGroups", + "properties": { + "etag": { + "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." + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" }, - "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" + "items": { + "description": "A list of InstantSnapshotGroup resources.", + "items": { + "$ref": "InstantSnapshotGroup" }, - "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." + "type": "array" }, - "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" + "kind": { + "default": "compute#instantSnapshotGroupsList", + "description": "Output only. Type of resource.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "unreachables": { + "description": "Output only. [Output Only] Unreachable resources.\nend_interface: MixerListResponseWithEtagBuilder", + "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": "Returns the specified Interconnect. Get a list of available Interconnects by making a list() request." + "readOnly": true, + "type": "array" }, - "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, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. 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" } }, - "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." + "type": "object" + } + }, + "type": "object" + }, + "LocalDisk": { + "id": "LocalDisk", + "properties": { + "diskCount": { + "description": "Specifies the number of such disks.", + "format": "int32", + "type": "integer" }, - "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" - } + "diskSizeGb": { + "description": "Specifies the size of the disk in base-2 GB.", + "format": "int32", + "type": "integer" + }, + "diskType": { + "description": "Specifies the desired disk type on the node. This disk type must be a\nlocal storage type (e.g.: local-ssd).\nNote that for nodeTemplates, this should be the name of the disk type and\nnot its URL.", + "type": "string" + } + }, + "type": "object" + }, + "LocalizedMessage": { + "description": "Provides a localized error message that is safe to return to the user\nwhich can be attached to an RPC error.", + "id": "LocalizedMessage", + "properties": { + "locale": { + "description": "The locale used following the specification defined at\nhttps://www.rfc-editor.org/rfc/bcp/bcp47.txt.\nExamples are: \"en-US\", \"fr-CH\", \"es-MX\"", + "type": "string" + }, + "message": { + "description": "The localized error message in the above locale.", + "type": "string" + } + }, + "type": "object" + }, + "LocationPolicy": { + "description": "Configuration for location policy among multiple possible locations\n(e.g. preferences for zone selection among zones in a single region).", + "id": "LocationPolicy", + "properties": { + "locations": { + "additionalProperties": { + "$ref": "LocationPolicyLocation" }, - "parameterOrder": [ - "project", - "interconnect" + "description": "Location configurations mapped by location name.\nCurrently only zone names are supported and must be represented as valid\ninternal URLs, such as zones/us-central1-a.\nThe bulkInsert operation doesn't create instances in an AI zone, even if\nan AI zone is available in the specified region. For example, if you set a\nDENY preference for us-central1-a, Compute Engine will consider\nus-central1-b and us-central1-c for instance creation, but not\nus-central1-ai1a. Also, you can't use the locations[] configuration to\nallow instance creation in an AI zone. To include an AI zone in bulkInsert\noperations, use the locationPolicy.zones[] field.", + "type": "object" + }, + "targetShape": { + "description": "Strategy for distributing VMs across zones in a region.", + "enum": [ + "ANY", + "ANY_SINGLE_ZONE", + "BALANCED" ], - "request": { - "$ref": "Interconnect" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "GCE picks zones for creating VM instances to fulfill the requested\nnumber of VMs within present resource constraints and to maximize\nutilization of unused zonal reservations. Recommended for batch workloads\nthat do not require high availability.", + "GCE always selects a single zone for all the VMs, optimizing for resource\nquotas, available reservations and general capacity. Recommended for\nbatch workloads that cannot tollerate distribution over multiple zones.\nThis the default shape in Bulk Insert and Capacity Advisor APIs.", + "GCE prioritizes acquisition of resources, scheduling VMs in zones\nwhere resources are available while distributing VMs as evenly as\npossible across allowed zones to minimize the impact of zonal failure.\nRecommended for highly available serving workloads." ], - "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." + "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" - } + "zones": { + "description": "The bulkInsert operation applies any preferences set in the locations\nfield to the specific zones listed in the zones field if the same zones\nare specified in both fields.", + "items": { + "$ref": "LocationPolicyZoneConfiguration" }, - "parameterOrder": [ - "project", - "resource" + "type": "array" + } + }, + "type": "object" + }, + "LocationPolicyLocation": { + "id": "LocationPolicyLocation", + "properties": { + "constraints": { + "$ref": "LocationPolicyLocationConstraints", + "description": "Constraints that the caller requires on the result distribution\nin this zone." + }, + "preference": { + "description": "Preference for a given location. Set to either ALLOW orDENY.", + "enum": [ + "ALLOW", + "DENY", + "PREFERENCE_UNSPECIFIED" ], - "request": { - "$ref": "GlobalSetLabelsRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "Location is allowed for use.", + "Location is prohibited.", + "Default value, unused." ], - "description": "Sets the labels on an Interconnect. To learn more about labels, read the Labeling Resources documentation." + "type": "string" } - } + }, + "type": "object" }, - "interconnectGroups": { - "methods": { - "list": { - "id": "compute.interconnectGroups.list", - "path": "projects/{project}/global/interconnectGroups", - "flatPath": "projects/{project}/global/interconnectGroups", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not 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": "InterconnectGroupsListResponse" + "LocationPolicyLocationConstraints": { + "description": "Per-zone constraints on location policy for this zone.", + "id": "LocationPolicyLocationConstraints", + "properties": { + "maxCount": { + "description": "Maximum number of items that are allowed to be placed in this zone.\nThe value must be non-negative.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, + "LocationPolicyZoneConfiguration": { + "id": "LocationPolicyZoneConfiguration", + "properties": { + "zone": { + "description": "The URL of the zone.\nThe zone must exist in the region where the request is called.\nZones must be represented as valid partial URLs,\nsuch as zones/us-central1-a.", + "type": "string" + } + }, + "type": "object" + }, + "MachineImage": { + "description": "Represents a machine image resource.\n\nA machine image is a Compute Engine resource that stores all the\nconfiguration, metadata, permissions, and data from one or more disks\nrequired to create a Virtual machine (VM) instance. For more information, seeMachine images.", + "id": "MachineImage", + "properties": { + "creationTimestamp": { + "description": "Output only. [Output Only] The creation timestamp for this machine image inRFC3339\ntext format.", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you\ncreate the resource.", + "type": "string" + }, + "guestFlush": { + "description": "[Input Only] Whether to attempt an application consistent machine image by\ninforming the OS to prepare for the snapshot process.", + "type": "boolean" + }, + "id": { + "description": "Output only. [Output Only] A unique identifier for this machine image. The server\ndefines this identifier.", + "format": "uint64", + "readOnly": true, + "type": "string" + }, + "instanceProperties": { + "$ref": "InstanceProperties", + "description": "[Output Only] Properties of source instance" + }, + "kind": { + "default": "compute#machineImage", + "description": "Output only. [Output Only] The resource type, which is alwayscompute#machineImage for machine image.", + "readOnly": true, + "type": "string" + }, + "labelFingerprint": { + "description": "A fingerprint for the labels being applied to this machine image, which is\nessentially a hash of the labels set used for optimistic locking. The\nfingerprint is initially generated by Compute Engine and changes after\nevery request to modify or update labels. You must always provide an\nup-to-date fingerprint hash in order to update or change labels.\n\nTo see the latest fingerprint, make get() request to the\nmachine image.", + "format": "byte", + "type": "string" + }, + "labels": { + "additionalProperties": { + "type": "string" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Lists the InterconnectGroups for a project in the given scope." + "description": "Labels to apply to this machine image. These can be later modified by\nthe setLabels method.", + "type": "object" }, - "get": { - "id": "compute.interconnectGroups.get", - "path": "projects/{project}/global/interconnectGroups/{interconnectGroup}", - "flatPath": "projects/{project}/global/interconnectGroups/{interconnectGroup}", - "httpMethod": "GET", - "parameters": { - "interconnectGroup": { - "description": "Name of the InterconnectGroup 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" - } + "machineImageEncryptionKey": { + "$ref": "CustomerEncryptionKey", + "description": "Encrypts the machine image using acustomer-supplied\nencryption key.\n\nAfter you encrypt a machine image using a customer-supplied key, you must\nprovide the same key if you use the machine image later. For example, you\nmust provide the encryption key when you create an instance from the\nencrypted machine image in a future request.\n\nCustomer-supplied encryption keys do not protect access to metadata of the\nmachine image.\n\nIf you do not provide an encryption key when creating the machine image,\nthen the machine image will be encrypted using an automatically generated\nkey and you do not need to provide a key to use the machine image later." + }, + "name": { + "annotations": { + "required": [ + "compute.machineImages.insert" + ] }, - "parameterOrder": [ - "project", - "interconnectGroup" - ], - "response": { - "$ref": "InterconnectGroup" + "description": "Name of the resource; provided by the client when the resource is created.\nThe name must be 1-63 characters long, and comply withRFC1035.\nSpecifically, the name must be 1-63 characters long and match the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first\ncharacter must be a lowercase letter, and all following characters must be\na dash, lowercase letter, or digit, except the last character, which cannot\nbe a dash.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "params": { + "$ref": "MachineImageParams", + "description": "Input only. [Input Only] Additional parameters that are passed in the request, but are\nnot persisted in the resource." + }, + "satisfiesPzi": { + "description": "Output only. Reserved for future use.", + "readOnly": true, + "type": "boolean" + }, + "satisfiesPzs": { + "description": "Output only. [Output Only] Reserved for future use.", + "readOnly": true, + "type": "boolean" + }, + "savedDisks": { + "description": "Output only. An array of Machine Image specific properties for disks attached to the\nsource instance", + "items": { + "$ref": "SavedDisk" }, - "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 InterconnectGroup resource in the given scope." + "readOnly": true, + "type": "array" }, - "insert": { - "id": "compute.interconnectGroups.insert", - "path": "projects/{project}/global/interconnectGroups", - "flatPath": "projects/{project}/global/interconnectGroups", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating 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" - } + "selfLink": { + "description": "Output only. [Output Only] The URL for this machine image. The server defines this URL.", + "readOnly": true, + "type": "string" + }, + "sourceDiskEncryptionKeys": { + "description": "[Input Only] Thecustomer-supplied\nencryption key of the disks attached to the source instance. Required\nif the source disk is protected by a customer-supplied encryption key.", + "items": { + "$ref": "SourceDiskEncryptionKey" }, - "parameterOrder": [ - "project" + "type": "array" + }, + "sourceInstance": { + "description": "The source instance used to create the machine image. You can provide this\nas a partial or full URL to the resource. For example, the following are\nvalid values: \n \n \n - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/instance \n - projects/project/zones/zone/instances/instance", + "type": "string" + }, + "sourceInstanceProperties": { + "$ref": "SourceInstanceProperties", + "description": "Output only. [Output Only] DEPRECATED: Please use instance_properties\ninstead for source instance related properties. New properties will not be\nadded to this field.", + "readOnly": true + }, + "status": { + "description": "Output only. [Output Only] The status of the machine image. One of the following values:INVALID, CREATING, READY,DELETING, and UPLOADING.", + "enum": [ + "CREATING", + "DELETING", + "INVALID", + "READY", + "UPLOADING" ], - "request": { - "$ref": "InterconnectGroup" + "enumDescriptions": [ + "", + "", + "", + "", + "" + ], + "readOnly": true, + "type": "string" + }, + "storageLocations": { + "description": "The regional or multi-regional Cloud Storage bucket location where themachine image is\nstored.", + "items": { + "type": "string" }, - "response": { - "$ref": "Operation" + "type": "array" + }, + "totalStorageBytes": { + "description": "Output only. [Output Only] Total size of the storage used by the machine image.", + "format": "int64", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "MachineImageList": { + "description": "A list of machine images.", + "id": "MachineImageList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of MachineImage resources.", + "items": { + "$ref": "MachineImage" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Creates a InterconnectGroup in the specified project in the given scope using the parameters that are included in the request." + "type": "array" }, - "delete": { - "id": "compute.interconnectGroups.delete", - "path": "projects/{project}/global/interconnectGroups/{interconnectGroup}", - "flatPath": "projects/{project}/global/interconnectGroups/{interconnectGroup}", - "httpMethod": "DELETE", - "parameters": { - "interconnectGroup": { - "description": "Name of the InterconnectGroup resource to delete.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, + "kind": { + "default": "compute#machineImageList", + "description": "Output only. [Output Only] The resource type, which is alwayscompute#machineImagesListResponse for machine image lists.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating 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", + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project", - "interconnectGroup" - ], - "response": { - "$ref": "Operation" + "type": "object" + } + }, + "type": "object" + }, + "MachineImageParams": { + "description": "Machine Image parameters", + "id": "MachineImageParams", + "properties": { + "resourceManagerTags": { + "additionalProperties": { + "type": "string" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified InterconnectGroup in the given scope" - }, - "patch": { - "id": "compute.interconnectGroups.patch", - "path": "projects/{project}/global/interconnectGroups/{interconnectGroup}", - "flatPath": "projects/{project}/global/interconnectGroups/{interconnectGroup}", - "httpMethod": "PATCH", - "parameters": { - "interconnectGroup": { - "description": "Name of the InterconnectGroup 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). end_interface: MixerMutationRequestBuilder", - "location": "query", - "type": "string" + "description": "Input only. Resource manager tags to be bound to the machine image. Tag keys and values\nhave the same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in\nnamespaced format such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT &\nPATCH) when empty.", + "type": "object" + } + }, + "type": "object" + }, + "MachineType": { + "description": "Represents a Machine Type resource.\n\nYou can use specific machine types for your VM instances based on performance\nand pricing requirements. For more information, readMachine Types.", + "id": "MachineType", + "properties": { + "accelerators": { + "description": "[Output Only] A list of accelerator configurations assigned to this\nmachine type.", + "items": { + "properties": { + "guestAcceleratorCount": { + "description": "Number of accelerator cards exposed to the guest.", + "format": "int32", + "type": "integer" + }, + "guestAcceleratorType": { + "description": "The accelerator type resource name, not a full URL, e.g.nvidia-tesla-t4.", + "type": "string" + } }, - "updateMask": { - "description": "The list of fields to update.", - "location": "query", - "type": "string", - "format": "google-fieldmask" - } + "type": "object" }, - "parameterOrder": [ - "project", - "interconnectGroup" + "type": "array" + }, + "architecture": { + "description": "[Output Only] The architecture of the machine type.", + "enum": [ + "ARCHITECTURE_UNSPECIFIED", + "ARM64", + "X86_64" ], - "request": { - "$ref": "InterconnectGroup" + "enumDescriptions": [ + "Default value indicating Architecture is not set.", + "Machines with architecture ARM64", + "Machines with architecture X86_64" + ], + "type": "string" + }, + "bundledLocalSsds": { + "$ref": "BundledLocalSsds", + "description": "[Output Only] The configuration of bundled local SSD for the machine type." + }, + "creationTimestamp": { + "description": "[Output Only] Creation timestamp inRFC3339\ntext format.", + "type": "string" + }, + "deprecated": { + "$ref": "DeprecationStatus", + "description": "[Output Only] The deprecation status associated with this machine type.\nOnly applicable if the machine type is unavailable." + }, + "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\ninstance.", + "format": "int32", + "type": "integer" + }, + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "format": "uint64", + "type": "string" + }, + "imageSpaceGb": { + "description": "[Deprecated] This property is deprecated and will never be populated with\nany relevant values.", + "format": "int32", + "type": "integer" + }, + "isSharedCpu": { + "description": "[Output Only] Whether this machine type has a shared CPU. SeeShared-core machine\ntypes for more information.", + "type": "boolean" + }, + "kind": { + "default": "compute#machineType", + "description": "Output only. [Output Only] The type of the resource. Alwayscompute#machineType for machine types.", + "readOnly": true, + "type": "string" + }, + "maximumPersistentDisks": { + "description": "[Output Only] Maximum persistent disks allowed.", + "format": "int32", + "type": "integer" + }, + "maximumPersistentDisksSizeGb": { + "description": "[Output Only] Maximum total persistent disks size (GB) allowed.", + "format": "int64", + "type": "string" + }, + "memoryMb": { + "description": "[Output Only] The amount of physical memory available to the instance,\ndefined in MB.", + "format": "int32", + "type": "integer" + }, + "name": { + "description": "[Output Only] Name of the resource.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" + }, + "zone": { + "description": "[Output Only] The name of the zone where the machine type resides,\nsuch as us-central1-a.", + "type": "string" + } + }, + "type": "object" + }, + "MachineTypeAggregatedList": { + "id": "MachineTypeAggregatedList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "additionalProperties": { + "$ref": "MachineTypesScopedList", + "description": "[Output Only] Name of the scope containing this set of machine types." }, - "response": { - "$ref": "Operation" + "description": "A list of MachineTypesScopedList resources.", + "type": "object" + }, + "kind": { + "default": "compute#machineTypeAggregatedList", + "description": "Output only. [Output Only] Type of resource. Alwayscompute#machineTypeAggregatedList for aggregated lists of\nmachine types.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "unreachables": { + "description": "Output only. [Output Only] Unreachable resources.", + "items": { + "type": "string" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Patches the specified InterconnectGroup resource with the data included in the request. This method supports PATCH semantics and uses JSON merge patch format and processing rules." + "readOnly": true, + "type": "array" }, - "getOperationalStatus": { - "id": "compute.interconnectGroups.getOperationalStatus", - "path": "projects/{project}/global/interconnectGroups/{interconnectGroup}/getOperationalStatus", - "flatPath": "projects/{project}/global/interconnectGroups/{interconnectGroup}/getOperationalStatus", - "httpMethod": "GET", - "parameters": { - "interconnectGroup": { - "description": "Name of the interconnectGroup resource to query.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, + "data": { + "description": "[Output Only] Metadata about this warning in key:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" + }, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project", - "interconnectGroup" - ], - "response": { - "$ref": "InterconnectGroupsGetOperationalStatusResponse" + "type": "object" + } + }, + "type": "object" + }, + "MachineTypeList": { + "description": "Contains a list of machine types.", + "id": "MachineTypeList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of MachineType resources.", + "items": { + "$ref": "MachineType" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns the interconnectStatuses for the specified InterconnectGroup." + "type": "array" }, - "getIamPolicy": { - "id": "compute.interconnectGroups.getIamPolicy", - "path": "projects/{project}/global/interconnectGroups/{resource}/getIamPolicy", - "flatPath": "projects/{project}/global/interconnectGroups/{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, + "kind": { + "default": "compute#machineTypeList", + "description": "Output only. [Output Only] Type of resource. Always compute#machineTypeList\nfor lists of machine types.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" + }, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project", - "resource" - ], - "response": { - "$ref": "Policy" + "type": "object" + } + }, + "type": "object" + }, + "MachineTypesScopedList": { + "id": "MachineTypesScopedList", + "properties": { + "machineTypes": { + "description": "[Output Only] A list of machine types contained in this scope.", + "items": { + "$ref": "MachineType" }, - "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": "array" }, - "setIamPolicy": { - "id": "compute.interconnectGroups.setIamPolicy", - "path": "projects/{project}/global/interconnectGroups/{resource}/setIamPolicy", - "flatPath": "projects/{project}/global/interconnectGroups/{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, + "warning": { + "description": "[Output Only] An informational warning that appears when the machine types\nlist is empty.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" + }, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project", - "resource" + "type": "object" + } + }, + "type": "object" + }, + "ManagedInstance": { + "description": "A Managed Instance resource.", + "id": "ManagedInstance", + "properties": { + "currentAction": { + "description": "Output only. [Output Only] The current action that the managed instance group has\nscheduled for the instance. Possible values:\n \n - NONE The instance is running, and the managed\n instance group does not have any scheduled actions for this instance.\n - CREATING The managed instance group is creating this\n instance. If the group fails to create this instance, it will try again\n until it is successful.\n - CREATING_WITHOUT_RETRIES The managed instance group\n is attempting to create this instance only once. If the group fails\n to create this instance, it does not try again and the group'stargetSize value is decreased instead.\n - RECREATING The managed instance group is recreating\n this instance.\n - DELETING The managed instance group is permanently\n deleting this instance.\n - ABANDONING The managed instance group is abandoning\n this instance. The instance will be removed from the instance group\n and from any target pools that are associated with this group.\n - RESTARTING The managed instance group is restarting\n the instance.\n - REFRESHING The managed instance group is applying\n configuration changes to the instance without stopping it. For example,\n the group can update the target pool list for an instance without\n stopping that instance.\n - VERIFYING The managed instance group has created the\n instance and it is in the process of being verified.", + "enum": [ + "ABANDONING", + "CREATING", + "CREATING_WITHOUT_RETRIES", + "DELETING", + "NONE", + "RECREATING", + "REFRESHING", + "RESTARTING", + "RESUMING", + "STARTING", + "STOPPING", + "SUSPENDING", + "VERIFYING" ], - "request": { - "$ref": "GlobalSetPolicyRequest" - }, - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "The managed instance group is abandoning this instance. The instance\nwill be removed from the instance group and from any target pools that\nare associated with this group.", + "The managed instance group is creating this instance. If the group\nfails to create this instance, it will try again until it is\nsuccessful.", + "The managed instance group is attempting to create this instance\nonly once. If the group fails to create this instance, it does\nnot try again and the group's targetSize value is\ndecreased.", + "The managed instance group is permanently deleting this instance.", + "The managed instance group has not scheduled any actions for this\ninstance.", + "The managed instance group is recreating this instance.", + "The managed instance group is applying configuration changes to the\ninstance without stopping it. For example, the group can update the\ntarget 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.\nVerification happens every time the instance is (re)created or restarted\nand consists of:\n 1. Waiting until health check specified as part of this managed instance\n group's autohealing policy reports HEALTHY.\n Note: Applies only if autohealing policy has a health check specified\n 2. Waiting for addition verification steps performed as post-instance\n creation (subject to future extensions)." ], - "description": "Sets the access control policy on the specified resource. Replaces any existing policy." + "readOnly": true, + "type": "string" }, - "testIamPermissions": { - "id": "compute.interconnectGroups.testIamPermissions", - "path": "projects/{project}/global/interconnectGroups/{resource}/testIamPermissions", - "flatPath": "projects/{project}/global/interconnectGroups/{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" - } + "id": { + "description": "Output only. [Output only] The unique identifier for this resource. This field is empty\nwhen instance does not exist.", + "format": "uint64", + "readOnly": true, + "type": "string" + }, + "instance": { + "description": "Output only. [Output Only] The URL of the instance. The URL can exist even if the\ninstance has not yet been created.", + "readOnly": true, + "type": "string" + }, + "instanceHealth": { + "description": "Output only. [Output Only] Health state of the instance per health-check.", + "items": { + "$ref": "ManagedInstanceInstanceHealth" }, - "parameterOrder": [ - "project", - "resource" + "readOnly": true, + "type": "array" + }, + "instanceStatus": { + "description": "Output only. [Output Only] The status of the instance. This field is empty when\nthe instance does not exist.", + "enum": [ + "DEPROVISIONING", + "PENDING", + "PENDING_STOP", + "PROVISIONING", + "REPAIRING", + "RUNNING", + "STAGING", + "STOPPED", + "STOPPING", + "SUSPENDED", + "SUSPENDING", + "TERMINATED" ], - "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" + "enumDescriptions": [ + "The instance is halted and we are performing tear down tasks like network\ndeprogramming, releasing quota, IP, tearing down disks etc.", + "For Flex Start provisioning instance is waiting for available capacity\nfrom Dynamic Workload Scheduler (DWS).", + "The instance is gracefully shutting down.", + "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\nis 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\nfailure)." ], - "description": "Returns permissions that a caller has on the specified resource." + "readOnly": true, + "type": "string" }, - "createMembers": { - "id": "compute.interconnectGroups.createMembers", - "path": "projects/{project}/global/interconnectGroups/{interconnectGroup}/createMembers", - "flatPath": "projects/{project}/global/interconnectGroups/{interconnectGroup}/createMembers", - "httpMethod": "POST", - "parameters": { - "interconnectGroup": { - "description": "Name of the group resource to create members 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" - } - }, - "parameterOrder": [ - "project", - "interconnectGroup" + "lastAttempt": { + "$ref": "ManagedInstanceLastAttempt", + "description": "Output only. [Output Only] Information about the last attempt to create or delete\nthe instance.", + "readOnly": true + }, + "name": { + "description": "Output only. [Output Only] The name of the instance. The name always exists even if the\ninstance has not yet been created.", + "readOnly": true, + "type": "string" + }, + "preservedStateFromConfig": { + "$ref": "PreservedState", + "description": "Output only. [Output Only] Preserved state applied from per-instance config\nfor this instance.", + "readOnly": true + }, + "preservedStateFromPolicy": { + "$ref": "PreservedState", + "description": "Output only. [Output Only] Preserved state generated based on stateful policy\nfor this instance.", + "readOnly": true + }, + "propertiesFromFlexibilityPolicy": { + "$ref": "ManagedInstancePropertiesFromFlexibilityPolicy", + "description": "Output only. [Output Only] Instance properties selected for this instance resulting from\nInstanceFlexibilityPolicy.", + "readOnly": true + }, + "scheduling": { + "$ref": "ManagedInstanceScheduling", + "description": "Output only. Information about the termination timestamp of the instance, if applicable.", + "readOnly": true + }, + "shutdownDetails": { + "$ref": "ManagedInstanceShutdownDetails", + "description": "Output only. Specifies the graceful shutdown details if the instance is in\n`PENDING_STOP` state or there is a programmed stop scheduled.", + "readOnly": true + }, + "version": { + "$ref": "ManagedInstanceVersion", + "description": "Output only. [Output Only] Intended version of this instance.", + "readOnly": true + } + }, + "type": "object" + }, + "ManagedInstanceInstanceHealth": { + "id": "ManagedInstanceInstanceHealth", + "properties": { + "detailedHealthState": { + "description": "Output only. [Output Only] The current detailed instance health state.", + "enum": [ + "DRAINING", + "HEALTHY", + "TIMEOUT", + "UNHEALTHY", + "UNKNOWN" ], - "request": { - "$ref": "InterconnectGroupsCreateMembersRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "The instance is being drained. The existing connections to the instance\nhave time to complete, but the new ones are being refused.", + "The instance is reachable i.e. a connection to the application health\nchecking endpoint can be established, and conforms to the requirements\ndefined by the health check.", + "The instance is unreachable i.e. a connection to the application health\nchecking endpoint cannot be established, or the server does not respond\nwithin the specified timeout.", + "The instance is reachable, but does not conform to the requirements\ndefined by the health check.", + "The health checking system is aware of the instance but its health is\nnot known at the moment." ], - "description": "Create Interconnects with redundancy by creating them in a specified interconnect group." + "readOnly": true, + "type": "string" + }, + "healthCheck": { + "description": "Output only. [Output Only] The URL for the health check that verifies whether the\ninstance is healthy.", + "readOnly": true, + "type": "string" } - } + }, + "type": "object" }, - "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" + "ManagedInstanceLastAttempt": { + "id": "ManagedInstanceLastAttempt", + "properties": { + "errors": { + "description": "Output only. [Output Only] Encountered errors during the last attempt to create or\ndelete the instance.", + "properties": { + "errors": { + "description": "[Output Only] The array of errors encountered while processing this\noperation.", + "items": { + "description": "Represents a single error encountered during the processing of an\noperation.", + "properties": { + "code": { + "description": "[Output Only] The error type identifier for this error.", + "type": "string" + }, + "errorDetails": { + "description": "[Output Only] An optional list of messages that contain the error\ndetails. There is a set of defined message types to use for providing\ndetails.The syntax depends on the error code. For example,\nQuotaExceededInfo will have details when the error code is\nQUOTA_EXCEEDED.", + "items": { + "description": "Container for structured error details providing additional context\nspecific to the encountered error code.", + "properties": { + "errorInfo": { + "$ref": "ErrorInfo", + "description": "Error information containing structured domain, reason, and metadata." + }, + "help": { + "$ref": "Help", + "description": "Links and information to help the user resolve the error." + }, + "localizedMessage": { + "$ref": "LocalizedMessage", + "description": "A localized human-readable error message intended for end users." + }, + "quotaInfo": { + "$ref": "QuotaExceededInfo", + "description": "Details about quota limits and metrics when a quota is exceeded." + } + }, + "type": "object" + }, + "type": "array" + }, + "location": { + "description": "[Output Only] Indicates the field in the request that caused the error.\nThis property is optional.", + "type": "string" + }, + "message": { + "description": "[Output Only] An optional, human-readable error message.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" } }, - "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." + "readOnly": true, + "type": "object" + } + }, + "type": "object" + }, + "ManagedInstancePropertiesFromFlexibilityPolicy": { + "id": "ManagedInstancePropertiesFromFlexibilityPolicy", + "properties": { + "machineType": { + "description": "Output only. The machine type to be used for this instance.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "ManagedInstanceScheduling": { + "id": "ManagedInstanceScheduling", + "properties": { + "gracefulShutdownTimestamp": { + "description": "Output only. The timestamp at which the underlying instance will be\ntriggered for graceful shutdown if it is configured. This is in RFC3339 text format.", + "format": "google-datetime", + "readOnly": true, + "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" + "terminationTimestamp": { + "description": "Output only. The timestamp at which the managed instance will be terminated. This is\nin RFC3339 text\nformat.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "ManagedInstanceShutdownDetails": { + "id": "ManagedInstanceShutdownDetails", + "properties": { + "maxDuration": { + "$ref": "Duration", + "description": "Output only. The duration for graceful shutdown. Only applicable when the instance is\nin `PENDING_STOP` state.", + "readOnly": true + }, + "requestTimestamp": { + "description": "Output only. Past timestamp indicating the beginning of `PENDING_STOP` state of\ninstance in RFC3339\ntext format.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "ManagedInstanceVersion": { + "id": "ManagedInstanceVersion", + "properties": { + "instanceTemplate": { + "description": "Output only. [Output Only] The intended template of the instance. This field is empty\nwhen current_action is one of { DELETING, ABANDONING }.", + "readOnly": true, + "type": "string" + }, + "name": { + "description": "Output only. [Output Only] Name of the version.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "Metadata": { + "description": "A metadata key/value entry.", + "id": "Metadata", + "properties": { + "fingerprint": { + "description": "Specifies a fingerprint for this request, which is essentially a hash of\nthe metadata's contents and used for optimistic locking. The\nfingerprint is initially generated by Compute Engine and changes after\nevery request to modify or update metadata. You must always provide an\nup-to-date fingerprint hash in order to update or change metadata,\notherwise the request will fail with error412 conditionNotMet.\n\nTo see the latest fingerprint, make a get() request to\nretrieve the resource.", + "format": "byte", + "type": "string" + }, + "items": { + "description": "Array of key/value pairs. The total size of all keys and values must be\nless than 512 KB.", + "items": { + "description": "Metadata", + "properties": { + "key": { + "annotations": { + "required": [ + "compute.instances.insert", + "compute.projects.setCommonInstanceMetadata" + ] + }, + "description": "Key for the metadata entry. Keys must conform to the following\nregexp: [a-zA-Z0-9-_]+, and be less than 128 bytes in length.\nThis is reflected as part of a URL in the metadata server. Additionally, to\navoid ambiguity, keys must not conflict with any other metadata keys\nfor the project.", + "pattern": "[a-zA-Z0-9-_]{1,128}", + "type": "string" + }, + "value": { + "annotations": { + "required": [ + "compute.instances.insert", + "compute.projects.setCommonInstanceMetadata" + ] + }, + "description": "Value for the metadata entry. These are free-form strings, and only\nhave meaning as interpreted by the image running in the instance. The\nonly restriction placed on values is that their size must be less than\nor equal to 262144 bytes (256 KiB).", + "type": "string" + } }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, 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" + "type": "object" }, - "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." + "type": "array" }, - "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" - } + "kind": { + "default": "compute#metadata", + "description": "Output only. [Output Only] Type of the resource. Always compute#metadata\nfor metadata.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "MetadataFilter": { + "description": "Opaque filter criteria used by load balancers to restrict routing\nconfiguration to a limited set of load balancing proxies. Proxies and\nsidecars involved in load balancing would typically present metadata to the\nload balancers that need to match criteria specified here. If a match takes\nplace, the relevant configuration is made available to those\nproxies.\n\nFor each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least\none of thefilterLabels must match the corresponding label provided in\nthe metadata. If its filterMatchCriteria is set to\nMATCH_ALL, then all of its filterLabels must match with\ncorresponding labels provided in the metadata.\n\nAn example for using metadataFilters would be: if\nload balancing involves\nEnvoys, they receive routing configuration when values inmetadataFilters match values supplied in of their XDS requests to loadbalancers.", + "id": "MetadataFilter", + "properties": { + "filterLabels": { + "description": "The list of label value pairs that must match labels in the provided\nmetadata based on filterMatchCriteria\n\nThis list must not be empty and can have at the most 64 entries.", + "items": { + "$ref": "MetadataFilterLabelMatch" }, - "parameterOrder": [ - "project", - "externalVpnGateway" + "type": "array" + }, + "filterMatchCriteria": { + "description": "Specifies how individual filter label matches\nwithin the list of filterLabels and contributes toward the\noverall metadataFilter match.\n\n Supported values are:\n \n - MATCH_ANY: at least one of the filterLabels\n must have a matching label in the provided metadata.\n - MATCH_ALL: all filterLabels must have\n matching labels in the provided metadata.", + "enum": [ + "MATCH_ALL", + "MATCH_ANY", + "NOT_SET" ], - "response": { - "$ref": "ExternalVpnGateway" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "Specifies that all filterLabels must match for themetadataFilter to be considered a match.", + "Specifies that any filterLabel must match for themetadataFilter to be considered a match.", + "Indicates that the match criteria was not set. AmetadataFilter must never be created with this value." ], - "description": "Returns the specified externalVpnGateway. Get a list of available externalVpnGateways by making a list() request." + "type": "string" + } + }, + "type": "object" + }, + "MetadataFilterLabelMatch": { + "description": "MetadataFilter label name value pairs that are expected\nto match corresponding labels presented as metadata to the load balancer.", + "id": "MetadataFilterLabelMatch", + "properties": { + "name": { + "description": "Name of metadata label.\n\n The name can have a maximum length of 1024 characters and must be at\nleast 1 character long.", + "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" - } + "value": { + "description": "The value of the label must match the specified value.\n\nvalue can have a maximum length of 1024 characters.", + "type": "string" + } + }, + "type": "object" + }, + "NamedPort": { + "description": "The named port. For example: <\"http\", 80>.", + "id": "NamedPort", + "properties": { + "name": { + "description": "The name for this named port.\nThe name must be 1-63 characters long, and comply withRFC1035.", + "type": "string" + }, + "port": { + "description": "The port number, which can be a value between 1 and 65535.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, + "NamedSet": { + "id": "NamedSet", + "properties": { + "description": { + "description": "An optional description of named set.", + "type": "string" + }, + "elements": { + "description": "CEL expressions that are comparable to constructs of this set's type\n(see Policy Language).", + "items": { + "$ref": "Expr" }, - "parameterOrder": [ - "project", - "externalVpnGateway" + "type": "array" + }, + "fingerprint": { + "description": "A fingerprint for the Named Set being applied to this Router, which is\nessentially a hash of the Named Set used for optimistic locking.\nThe fingerprint is initially generated by Compute Engine and changes\nafter every request to modify or update the Named Set. You must always\nprovide an up-to-date fingerprint hash in order to update or change\nlabels.\n\nTo see the latest fingerprint, make a getNamedSet() request\nto retrieve a Named Set.", + "format": "byte", + "type": "string" + }, + "name": { + "description": "This set's name, which must be a resource ID segment and unique within all\nnamed sets owned by the Router. Name should conform to RFC1035.", + "type": "string" + }, + "type": { + "description": "This named set's type", + "enum": [ + "NAMED_SET_TYPE_COMMUNITY", + "NAMED_SET_TYPE_PREFIX" ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "The Named Set is a Community Named Set.", + "The Named Set is a Prefix Named Set." ], - "description": "Deletes the specified externalVpnGateway." - }, - "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" - } + "type": "string" + } + }, + "type": "object" + }, + "NatIpInfo": { + "description": "Contains NAT IP information of a NAT config (i.e. usage status, mode).", + "id": "NatIpInfo", + "properties": { + "natIpInfoMappings": { + "description": "Output only. A list of all NAT IPs assigned to this NAT config.", + "items": { + "$ref": "NatIpInfoNatIpInfoMapping" }, - "parameterOrder": [ - "project", - "resource" + "readOnly": true, + "type": "array" + }, + "natName": { + "description": "Output only. Name of the NAT config which the NAT IP belongs to.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "NatIpInfoNatIpInfoMapping": { + "description": "Contains information of a NAT IP.", + "id": "NatIpInfoNatIpInfoMapping", + "properties": { + "mode": { + "description": "Output only. Specifies whether NAT IP is auto or manual.", + "enum": [ + "AUTO", + "MANUAL" ], - "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" + "enumDescriptions": [ + "", + "" ], - "description": "Returns permissions that a caller has on the specified resource." + "readOnly": true, + "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" + "natIp": { + "description": "Output only. NAT IP address. For example: 203.0.113.11.", + "readOnly": true, + "type": "string" + }, + "usage": { + "description": "Output only. Specifies whether NAT IP is currently serving at least one endpoint or\nnot.", + "enum": [ + "IN_USE", + "UNUSED" ], - "request": { - "$ref": "GlobalSetLabelsRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "", + "" ], - "description": "Sets the labels on an ExternalVpnGateway. To learn more about labels, read the Labeling Resources documentation." + "readOnly": true, + "type": "string" } - } + }, + "type": "object" }, - "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" - } + "NatIpInfoResponse": { + "id": "NatIpInfoResponse", + "properties": { + "result": { + "description": "[Output Only] A list of NAT IP information.", + "items": { + "$ref": "NatIpInfo" }, - "parameterOrder": [ - "project" + "type": "array" + } + }, + "type": "object" + }, + "Network": { + "description": "Represents a VPC Network resource.\n\nNetworks connect resources to each other and to the internet. For more\ninformation, readVirtual Private Cloud (VPC) Network.", + "id": "Network", + "properties": { + "IPv4Range": { + "deprecated": true, + "description": "Deprecated in favor of subnet mode networks.\nThe range of internal addresses that are legal on this network. This\nrange is aCIDR specification, for example:192.168.0.0/16. Provided by the client when the network is\ncreated.", + "pattern": "[0-9]{1,3}(?:\\.[0-9]{1,3}){3}/[0-9]{1,2}", + "type": "string" + }, + "autoCreateSubnetworks": { + "description": "Must be set to create a VPC network. If not set, a legacy network is\ncreated.\n\nWhen set to true, the VPC network is created in auto mode.\nWhen set to false, the VPC network is created in custom mode.\n\nAn auto mode VPC network starts with one subnet per region. Each subnet\nhas a predetermined range as described inAuto mode VPC network IP ranges.\n\nFor custom mode VPC networks, you can add subnets using the subnetworksinsert\nmethod.", + "type": "boolean" + }, + "creationTimestamp": { + "description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "An optional description of this resource. Provide this field when you\ncreate the resource.", + "type": "string" + }, + "enableUlaInternalIpv6": { + "description": "Enable ULA internal ipv6 on this network. Enabling this feature will assign\na /48 from google defined ULA prefix fd20::/20.\n.", + "type": "boolean" + }, + "firewallPolicy": { + "description": "Output only. [Output Only] URL of the firewall policy the network is associated with.", + "readOnly": true, + "type": "string" + }, + "gatewayIPv4": { + "description": "[Output Only] The gateway address for default routing out of the network,\nselected by Google Cloud.", + "pattern": "[0-9]{1,3}(?:\\.[0-9]{1,3}){3}", + "type": "string" + }, + "id": { + "description": "Output only. [Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "format": "uint64", + "readOnly": true, + "type": "string" + }, + "internalIpv6Range": { + "description": "When enabling ula internal ipv6, caller optionally can specify the /48\nrange they want from the google defined ULA prefix fd20::/20. The input\nmust be a valid /48 ULA IPv6 address and must be within the fd20::/20.\nOperation will fail if the speficied /48 is already in used by another\nresource. If the field is not speficied, then a /48 range will be randomly\nallocated from fd20::/20 and returned via this field.\n.", + "type": "string" + }, + "kind": { + "default": "compute#network", + "description": "Output only. [Output Only] Type of the resource. Always compute#network for\nnetworks.", + "readOnly": true, + "type": "string" + }, + "mtu": { + "description": "Maximum Transmission Unit in bytes.\nThe minimum value for this field is 1300 and the maximum value is 8896.\nThe suggested value is 1500, which is the default MTU used on the\nInternet, or 8896 if you want to use Jumbo frames. If unspecified, the\nvalue defaults to 1460.", + "format": "int32", + "type": "integer" + }, + "name": { + "annotations": { + "required": [ + "compute.networks.insert" + ] + }, + "description": "Name of the resource. Provided by the client when the resource is created.\nThe name must be 1-63 characters long, and comply withRFC1035.\nSpecifically, the name must be 1-63 characters long and match the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?`. The first character must be a\nlowercase letter, and all following characters (except for the last\ncharacter) must be a dash, lowercase letter, or digit. The last character\nmust be a lowercase letter or digit.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "networkFirewallPolicyEnforcementOrder": { + "description": "The network firewall policy enforcement order. Can be either\nAFTER_CLASSIC_FIREWALL or BEFORE_CLASSIC_FIREWALL. Defaults to\nAFTER_CLASSIC_FIREWALL if the field is not specified.", + "enum": [ + "AFTER_CLASSIC_FIREWALL", + "BEFORE_CLASSIC_FIREWALL" + ], + "enumDescriptions": [ + "", + "" ], - "response": { - "$ref": "ForwardingRuleList" + "type": "string" + }, + "networkProfile": { + "description": "A full or partial URL of the network profile to apply to this network.\nThis field can be set only at resource creation time. For example, the\nfollowing are valid URLs: \n \n - https://www.googleapis.com/compute/{api_version}/projects/{project_id}/global/networkProfiles/{network_profile_name}\n - projects/{project_id}/global/networkProfiles/{network_profile_name}", + "type": "string" + }, + "params": { + "$ref": "NetworkParams", + "description": "Input only. [Input Only] Additional params passed with the request, but not persisted\nas part of resource payload." + }, + "peerings": { + "description": "Output only. [Output Only] A list of network peerings for the resource.", + "items": { + "$ref": "NetworkPeering" }, - "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." + "readOnly": true, + "type": "array" }, - "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" - } + "routingConfig": { + "$ref": "NetworkRoutingConfig", + "description": "The network-level routing configuration for this network. Used by Cloud\nRouter to determine what type of network-wide routing behavior to enforce." + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" + }, + "selfLinkWithId": { + "description": "Output only. [Output Only] Server-defined URL for this resource with the resource id.", + "readOnly": true, + "type": "string" + }, + "subnetworks": { + "description": "[Output Only] Server-defined fully-qualified URLs for all subnetworks\nin this VPC network.", + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "forwardingRule" - ], - "response": { - "$ref": "ForwardingRule" + "type": "array" + } + }, + "type": "object" + }, + "NetworkAttachment": { + "description": "NetworkAttachments\nA network attachment resource ...", + "id": "NetworkAttachment", + "properties": { + "connectionEndpoints": { + "description": "Output only. [Output Only] An array of connections for all the producers connected\nto this network attachment.", + "items": { + "$ref": "NetworkAttachmentConnectedEndpoint" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "readOnly": true, + "type": "array" + }, + "connectionPreference": { + "enum": [ + "ACCEPT_AUTOMATIC", + "ACCEPT_MANUAL", + "INVALID" + ], + "enumDescriptions": [ + "", + "", + "" ], - "description": "Returns the specified GlobalForwardingRule resource. Gets a list of available forwarding rules by making a list() request." + "type": "string" }, - "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" - } + "creationTimestamp": { + "description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you\ncreate the resource.", + "type": "string" + }, + "fingerprint": { + "description": "Fingerprint of this resource. A hash of the contents stored\nin this object. This field is used in optimistic locking. An up-to-date\nfingerprint must be provided in order to patch.", + "format": "byte", + "type": "string" + }, + "id": { + "description": "Output only. [Output Only] The unique identifier for the resource type. The server\ngenerates this identifier.", + "format": "uint64", + "readOnly": true, + "type": "string" + }, + "kind": { + "default": "compute#networkAttachment", + "description": "Output only. [Output Only] Type of the resource.", + "readOnly": true, + "type": "string" + }, + "name": { + "annotations": { + "required": [ + "compute.networkAttachments.insert" + ] }, - "parameterOrder": [ - "project" - ], - "request": { - "$ref": "ForwardingRule" + "description": "Name of the resource. Provided by the client when the resource is created.\nThe name must be 1-63 characters long, and comply withRFC1035.\nSpecifically, the name must be 1-63 characters long and match the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first\ncharacter must be a lowercase letter, and all following characters must\nbe a dash, lowercase letter, or digit, except the last character, which\ncannot be a dash.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "network": { + "description": "Output only. [Output Only] The URL of the network which the Network Attachment\nbelongs to. Practically it is inferred by fetching the network of the first\nsubnetwork associated. Because it is required that all the subnetworks must\nbe from the same network, it is assured that the Network Attachment belongs\nto the same network as all the subnetworks.", + "readOnly": true, + "type": "string" + }, + "producerAcceptLists": { + "description": "Projects or service class ids that are allowed to connect to this network\nattachment. The project can be specified using its id or number. Service\nclass id can be specified as \"serviceclasses/{service_class_id}\".", + "items": { + "type": "string" }, - "response": { - "$ref": "Operation" + "type": "array" + }, + "producerRejectLists": { + "description": "Projects or service class ids that are not allowed to connect to this\nnetwork attachment. The project can be specified using its id or number.\nService class id can be specified as \"serviceclasses/{service_class_id}\".", + "items": { + "type": "string" }, - "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." + "type": "array" }, - "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" - } + "region": { + "description": "Output only. [Output Only] URL of the region where the network attachment resides.\nThis field applies only to the region resource. You must specify this\nfield as part of the HTTP request URL. It is not settable as a field in\nthe request body.", + "readOnly": true, + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for the resource.", + "readOnly": true, + "type": "string" + }, + "selfLinkWithId": { + "description": "Output only. [Output Only] Server-defined URL for this resource's resource id.", + "readOnly": true, + "type": "string" + }, + "subnetworks": { + "description": "An array of URLs where each entry is the URL of a subnet\nprovided by the service consumer to use for\nendpoints in the producers that connect to this network attachment.", + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "forwardingRule" - ], - "response": { - "$ref": "Operation" + "type": "array" + } + }, + "type": "object" + }, + "NetworkAttachmentAggregatedList": { + "description": "Contains a list of NetworkAttachmentsScopedList.", + "id": "NetworkAttachmentAggregatedList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "additionalProperties": { + "$ref": "NetworkAttachmentsScopedList", + "description": "Name of the scope containing this set of NetworkAttachments." }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified GlobalForwardingRule resource." + "description": "A list of NetworkAttachmentsScopedList resources.", + "type": "object" }, - "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, + "kind": { + "default": "compute#networkAttachmentAggregatedList", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue 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.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. 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" } }, - "parameterOrder": [ - "project", - "forwardingRule" - ], - "request": { - "$ref": "TargetReference" - }, - "response": { - "$ref": "Operation" + "type": "object" + } + }, + "type": "object" + }, + "NetworkAttachmentConnectedEndpoint": { + "description": "[Output Only] A connection connected to this network attachment.", + "id": "NetworkAttachmentConnectedEndpoint", + "properties": { + "ipAddress": { + "description": "The IPv4 address assigned to the producer instance network interface.\nThis value will be a range in case of Serverless.", + "type": "string" + }, + "ipv6Address": { + "description": "The IPv6 address assigned to the producer instance network interface.\nThis is only assigned when the stack types of both the instance network\ninterface and the consumer subnet are IPv4_IPv6.", + "type": "string" + }, + "projectIdOrNum": { + "description": "The project id or number of the interface to which the IP was assigned.", + "type": "string" + }, + "secondaryIpCidrRanges": { + "description": "Alias IP ranges from the same subnetwork.", + "items": { + "type": "string" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "type": "array" + }, + "serviceClassId": { + "description": "The service class id of the producer service to which the IP was\nassigned.", + "type": "string" + }, + "status": { + "description": "The status of a connected endpoint to this network attachment.", + "enum": [ + "ACCEPTED", + "CLOSED", + "NEEDS_ATTENTION", + "PENDING", + "REJECTED", + "STATUS_UNSPECIFIED" + ], + "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\nfrom the producer to reach its VPC.", + "The consumer prohibits traffic from the producer to reach its VPC.", + "" ], - "description": "Changes target URL for the GlobalForwardingRule resource. The new target should be of the same type as the old target." + "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, + "subnetwork": { + "description": "The subnetwork used to assign the IP to the producer\ninstance network interface.", + "type": "string" + }, + "subnetworkCidrRange": { + "description": "Output only. [Output Only] The CIDR range of the subnet from which the IPv4 internal\nIP was allocated from.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "NetworkAttachmentList": { + "id": "NetworkAttachmentList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of NetworkAttachment resources.", + "items": { + "$ref": "NetworkAttachment" + }, + "type": "array" + }, + "kind": { + "default": "compute#networkAttachmentList", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue 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.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. 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" } }, - "parameterOrder": [ - "project", - "forwardingRule" - ], - "request": { - "$ref": "ForwardingRule" - }, - "response": { - "$ref": "Operation" + "type": "object" + } + }, + "type": "object" + }, + "NetworkAttachmentsScopedList": { + "id": "NetworkAttachmentsScopedList", + "properties": { + "networkAttachments": { + "description": "A list of NetworkAttachments contained in this scope.", + "items": { + "$ref": "NetworkAttachment" }, - "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." + "type": "array" }, - "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, + "warning": { + "description": "Informational warning which replaces the list of\nnetwork attachments when the list is empty.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" + }, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "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." + "type": "object" } - } + }, + "type": "object" }, - "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", + "NetworkEdgeSecurityService": { + "description": "Represents a Google Cloud Armor network edge security service resource.", + "id": "NetworkEdgeSecurityService", + "properties": { + "creationTimestamp": { + "description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you\ncreate the resource.", + "type": "string" + }, + "fingerprint": { + "description": "Fingerprint of this resource. A hash of the contents stored in this object.\nThis field is used in optimistic locking. This field will be ignored when\ninserting a NetworkEdgeSecurityService. An up-to-date fingerprint must be\nprovided in order to update the NetworkEdgeSecurityService,\notherwise the request will fail with error412 conditionNotMet.\n\nTo see the latest fingerprint, make a get() request to\nretrieve a NetworkEdgeSecurityService.", + "format": "byte", + "type": "string" + }, + "id": { + "description": "Output only. [Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "format": "uint64", + "readOnly": true, + "type": "string" + }, + "kind": { + "default": "compute#networkEdgeSecurityService", + "description": "Output only. [Output only] Type of the resource. Alwayscompute#networkEdgeSecurityService for\nNetworkEdgeSecurityServices", + "readOnly": true, + "type": "string" + }, + "name": { + "description": "Name of the resource. Provided by the client when the resource is created.\nThe name must be 1-63 characters long, and comply withRFC1035.\nSpecifically, the name must be 1-63 characters long and match the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first\ncharacter must be a lowercase letter, and all following characters must\nbe a dash, lowercase letter, or digit, except the last character, which\ncannot be a dash.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "region": { + "description": "Output only. [Output Only] URL of the region where the resource resides. You must\nspecify this field as part of the HTTP request URL. It is not settable as a\nfield in the request body.", + "readOnly": true, + "type": "string" + }, + "securityPolicy": { + "description": "The resource URL for the network edge security service associated with this\nnetwork edge security service.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for the resource.", + "readOnly": true, + "type": "string" + }, + "selfLinkWithId": { + "description": "Output only. [Output Only] Server-defined URL for this resource with the resource id.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "NetworkEdgeSecurityServiceAggregatedList": { + "id": "NetworkEdgeSecurityServiceAggregatedList", + "properties": { + "etag": { + "type": "string" + }, + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "additionalProperties": { + "$ref": "NetworkEdgeSecurityServicesScopedList", + "description": "Name of the scope containing this set of security policies." + }, + "description": "A list of NetworkEdgeSecurityServicesScopedList resources.", + "type": "object" + }, + "kind": { + "default": "compute#networkEdgeSecurityServiceAggregatedList", + "description": "Output only. [Output Only] Type of resource. Alwayscompute#networkEdgeSecurityServiceAggregatedList for lists of\nNetwork Edge Security Services.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "unreachables": { + "description": "Output only. [Output Only] Unreachable resources.", + "items": { + "type": "string" + }, + "readOnly": true, + "type": "array" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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" } }, - "parameterOrder": [ - "project", - "region" - ], - "response": { - "$ref": "ForwardingRuleList" + "type": "object" + } + }, + "type": "object" + }, + "NetworkEdgeSecurityServicesScopedList": { + "id": "NetworkEdgeSecurityServicesScopedList", + "properties": { + "networkEdgeSecurityServices": { + "description": "A list of NetworkEdgeSecurityServices contained in this scope.", + "items": { + "$ref": "NetworkEdgeSecurityService" }, - "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." + "type": "array" }, - "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", + "warning": { + "description": "Informational warning which replaces the list of\nsecurity policies when the list is empty.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "pageToken": { - "description": "Specifies a page token 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{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" } }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "ForwardingRuleAggregatedList" + "type": "object" + } + }, + "type": "object" + }, + "NetworkEndpoint": { + "description": "The network endpoint.", + "id": "NetworkEndpoint", + "properties": { + "annotations": { + "additionalProperties": { + "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 an aggregated list of forwarding rules. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." + "description": "Optional metadata defined as annotations on the network endpoint.", + "type": "object" }, - "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" - } + "clientDestinationPort": { + "description": "Represents the port number to which PSC consumer sends packets.\n\nOptional. Only valid for network endpoint groups created withGCE_VM_IP_PORTMAP endpoint type.", + "format": "int32", + "type": "integer" + }, + "fqdn": { + "description": "Optional fully qualified domain name of network endpoint. This can only be\nspecified when NetworkEndpointGroup.network_endpoint_type isNON_GCP_FQDN_PORT.", + "type": "string" + }, + "instance": { + "description": "The name or a URL of VM instance of this network endpoint.\nOptional, the field presence depends on the network endpoint type. The\nfield is required for network endpoints of type GCE_VM_IP andGCE_VM_IP_PORT.\n\nThe instance must be in the same zone of network endpoint group (for zonal\nNEGs) or in the zone within the region of the NEG (for regional NEGs).\nIf the ipAddress is specified, it must belongs to the VM\ninstance.\n\nThe name must be 1-63 characters long, and comply withRFC1035\nor be a valid URL pointing to an existing instance.", + "type": "string" + }, + "ipAddress": { + "description": "Optional IPv4 address of network endpoint. The IP address must belong to a\nVM in Compute Engine (either the primary IP or as part of an aliased IP\nrange). If the IP address is not specified, then the primary IP address for\nthe VM instance in the network that the network endpoint group belongs to\nwill be used.\n\nThis field is redundant and need not be set for network endpoints of typeGCE_VM_IP. If set, it must be set to the primary internal IP\naddress of the attached VM instance that matches the subnetwork of the NEG.\nThe primary internal IP address from any NIC of a multi-NIC VM instance can\nbe added to a NEG as long as it matches the NEG subnetwork.", + "type": "string" + }, + "ipv6Address": { + "description": "Optional IPv6 address of network endpoint.", + "type": "string" + }, + "port": { + "description": "Optional port number of network endpoint. If not specified, the\ndefaultPort for the network endpoint group will be used.\n\nThis field can not be set for network endpoints of typeGCE_VM_IP.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, + "NetworkEndpointGroup": { + "description": "Represents a collection of network endpoints.\n\nA network endpoint group (NEG) defines how a set of endpoints should be\nreached, whether they are reachable, and where they are located.\nFor more information about using NEGs for different use cases, seeNetwork endpoint groups overview.\n\nNote: Use the following APIs to manage network endpoint groups:\n \n - \n To manage NEGs with zonal scope (such as zonal NEGs, hybrid connectivity\n NEGs): zonal\n API\n - \n To manage NEGs with regional scope (such as regional internet NEGs,\n serverless NEGs, Private Service Connect NEGs): regional\n API\n - \n To manage NEGs with global scope (such as global internet NEGs):global\n API", + "id": "NetworkEndpointGroup", + "properties": { + "annotations": { + "additionalProperties": { + "type": "string" }, - "parameterOrder": [ - "project", - "region", - "forwardingRule" + "description": "Optional. Metadata defined as annotations on the network endpoint group.", + "type": "object" + }, + "appEngine": { + "$ref": "NetworkEndpointGroupAppEngine", + "description": "Optional. Only valid when networkEndpointType isSERVERLESS. Only one of cloudRun,appEngine or cloudFunction may be set." + }, + "cloudFunction": { + "$ref": "NetworkEndpointGroupCloudFunction", + "description": "Optional. Only valid when networkEndpointType isSERVERLESS. Only one of cloudRun,appEngine or cloudFunction may be set." + }, + "cloudRun": { + "$ref": "NetworkEndpointGroupCloudRun", + "description": "Optional. Only valid when networkEndpointType isSERVERLESS. Only one of cloudRun,appEngine or cloudFunction may be set." + }, + "creationTimestamp": { + "description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", + "readOnly": true, + "type": "string" + }, + "defaultPort": { + "description": "The default port used if the port number is not specified in the network\nendpoint.\n\nOptional. If the network endpoint type is either GCE_VM_IP,SERVERLESS or PRIVATE_SERVICE_CONNECT, this\nfield must not be specified.", + "format": "int32", + "type": "integer" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you\ncreate the resource.", + "type": "string" + }, + "id": { + "description": "Output only. [Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "format": "uint64", + "readOnly": true, + "type": "string" + }, + "kind": { + "default": "compute#networkEndpointGroup", + "description": "Output only. [Output Only] Type of the resource. Alwayscompute#networkEndpointGroup for network endpoint group.", + "readOnly": true, + "type": "string" + }, + "name": { + "description": "Name of the resource; provided by the client when the resource is created.\nThe name must be 1-63 characters long, and comply withRFC1035.\nSpecifically, the name must be 1-63 characters long and match the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first\ncharacter must be a lowercase letter, and all following characters must be\na dash, lowercase letter, or digit, except the last character, which cannot\nbe a dash.", + "type": "string" + }, + "network": { + "description": "The URL of the network to which all network endpoints in the NEG belong.\nFor networkEndpointType GCE_VM_IP_PORT,GCE_VM_IP_PORTMAP or NON_GCP_PRIVATE_IP_PORT,\nif this field is not specified, a default network will be used.\nThis field cannot be set for NEGs with networkEndpointType set toSERVERLESS or PRIVATE_SERVICE_CONNECT and for\nglobal NEGs.\nFor all other network endpoint types, this field is required.", + "type": "string" + }, + "networkEndpointType": { + "description": "Type of network endpoints in this network endpoint group. Can be one ofGCE_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.", + "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" ], - "response": { - "$ref": "ForwardingRule" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "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\nPort.", + "The network endpoint is represented by fully qualified domain name and\nport.", + "The network endpoint is represented by an internet IP address and port.", + "The network endpoint is represented by an IP address and port. The\nendpoint belongs to a VM or pod running in a customer's on-premises.", + "The network endpoint is either public Google APIs or\nservices exposed by other GCP Project with a Service Attachment.\nThe connection is set up by private service connect", + "The network endpoint is handled by specified serverless infrastructure." ], - "description": "Returns the specified ForwardingRule resource." + "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, + "pscData": { + "$ref": "NetworkEndpointGroupPscData", + "description": "Optional. Only valid when networkEndpointType isPRIVATE_SERVICE_CONNECT." + }, + "pscTargetService": { + "description": "The target service url used to set up private service connection to\na Google API or a PSC Producer Service Attachment.\nAn example value is: asia-northeast3-cloudkms.googleapis.com.\n\nOptional. Only valid when networkEndpointType isPRIVATE_SERVICE_CONNECT.", + "type": "string" + }, + "region": { + "description": "Output only. [Output Only] The URL of theregion\nwhere the network endpoint group is located.", + "readOnly": true, + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for the resource.", + "readOnly": true, + "type": "string" + }, + "size": { + "description": "Output only. [Output only] Number of network endpoints in the network endpoint group.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "subnetwork": { + "description": "Optional URL of the subnetwork to which all network endpoints in the NEG\nbelong.", + "type": "string" + }, + "zone": { + "description": "Output only. [Output Only] The URL of thezone\nwhere the network endpoint group is located.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "NetworkEndpointGroupAggregatedList": { + "id": "NetworkEndpointGroupAggregatedList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "additionalProperties": { + "$ref": "NetworkEndpointGroupsScopedList", + "description": "The name of the scope that contains this set of network endpoint groups." + }, + "description": "A list of NetworkEndpointGroupsScopedList resources.", + "type": "object" + }, + "kind": { + "default": "compute#networkEndpointGroupAggregatedList", + "description": "Output only. [Output Only] The resource type, which is alwayscompute#networkEndpointGroupAggregatedList for aggregated\nlists of network endpoint groups.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "unreachables": { + "description": "Output only. [Output Only] Unreachable resources.", + "items": { + "type": "string" + }, + "readOnly": true, + "type": "array" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. 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" } }, - "parameterOrder": [ - "project", - "region" - ], - "request": { - "$ref": "ForwardingRule" - }, - "response": { - "$ref": "Operation" + "type": "object" + } + }, + "type": "object" + }, + "NetworkEndpointGroupAppEngine": { + "description": "Configuration for an App Engine network endpoint group (NEG).\nThe service is optional, may be provided explicitly or in the\nURL mask. The version is optional and can only be provided\nexplicitly or in the URL mask when service is present.\n\nNote: App Engine service must be in the same project and located in the\nsame region as the Serverless NEG.", + "id": "NetworkEndpointGroupAppEngine", + "properties": { + "service": { + "description": "Optional serving service.\n\nThe service name is case-sensitive and must be 1-63\ncharacters long.\n\nExample value: default, my-service.", + "type": "string" + }, + "urlMask": { + "description": "An URL\nmask is one of the main components of the Cloud Function.\n\nA template to parse service and version fields\nfrom a request URL. URL mask allows for routing to multiple App Engine\nservices without having to create multiple Network Endpoint Groups and\nbackend services.\n\nFor example, the request URLsfoo1-dot-appname.appspot.com/v1 andfoo1-dot-appname.appspot.com/v2 can be backed by the same\nServerless NEG with URL mask-dot-appname.appspot.com/.\nThe URL mask will parse them to { service = \"foo1\", version = \"v1\"\n} and { service = \"foo1\", version = \"v2\" }\nrespectively.", + "type": "string" + }, + "version": { + "description": "Optional serving version.\n\nThe version name is case-sensitive and must be 1-100\ncharacters long.\n\nExample value: v1, v2.", + "type": "string" + } + }, + "type": "object" + }, + "NetworkEndpointGroupCloudFunction": { + "description": "Configuration for a Cloud Function network endpoint group (NEG).\nThe function must be provided explicitly or in the URL mask.\n\nNote: Cloud Function must be in the same project and located in the same\nregion as the Serverless NEG.", + "id": "NetworkEndpointGroupCloudFunction", + "properties": { + "function": { + "description": "A user-defined name of the Cloud Function.\n\nThe function name is case-sensitive and must be 1-63\ncharacters long.\n\nExample value: func1.", + "type": "string" + }, + "urlMask": { + "description": "An URL\nmask is one of the main components of the Cloud Function.\n\nA template to parse function field from a request URL. URL\nmask allows for routing to multiple Cloud Functions without having to\ncreate multiple Network Endpoint Groups and backend services.\n\nFor example, request URLs mydomain.com/function1 andmydomain.com/function2 can be backed by the same\nServerless NEG with URL mask /. The URL\nmask will parse them to { function = \"function1\" } and{ function = \"function2\" } respectively.", + "type": "string" + } + }, + "type": "object" + }, + "NetworkEndpointGroupCloudRun": { + "description": "Configuration for a Cloud Run network endpoint group (NEG).\nThe service must be provided explicitly or in the URL mask.\nThe tag is optional, may be provided explicitly or in the URL\nmask.\n\nNote: Cloud Run service must be in the same project and located in the same\nregion as the Serverless NEG.", + "id": "NetworkEndpointGroupCloudRun", + "properties": { + "service": { + "description": "Cloud Run service is the main resource of Cloud Run.\n\nThe service must be 1-63 characters long, and comply withRFC1035.\n\nExample value: \"run-service\".", + "type": "string" + }, + "tag": { + "description": "Optional Cloud Run tag represents the \"named-revision\" to provide additional\nfine-grained traffic routing information.\n\nThe tag must be 1-63 characters long, and comply withRFC1035.\n\nExample value: \"revision-0010\".", + "type": "string" + }, + "urlMask": { + "description": "An URL\nmask is one of the main components of the Cloud Function.\n\nA template to parse and fields from a request URL. URL mask allows for\nrouting to multiple Run services without having to create multiple\nnetwork endpoint groups and backend services.\n\nFor example, request URLs foo1.domain.com/bar1 andfoo1.domain.com/bar2 can be backed by the same Serverless\nNetwork Endpoint Group (NEG) with URL mask.domain.com/. The URL mask will\nparse them to { service=\"bar1\", tag=\"foo1\" } and {\nservice=\"bar2\", tag=\"foo2\" } respectively.", + "type": "string" + } + }, + "type": "object" + }, + "NetworkEndpointGroupList": { + "id": "NetworkEndpointGroupList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of NetworkEndpointGroup resources.", + "items": { + "$ref": "NetworkEndpointGroup" }, - "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." + "type": "array" }, - "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, + "kind": { + "default": "compute#networkEndpointGroupList", + "description": "Output only. [Output Only] The resource type, which is alwayscompute#networkEndpointGroupList for network endpoint group\nlists.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. 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" } }, - "parameterOrder": [ - "project", - "region", - "forwardingRule" + "type": "object" + } + }, + "type": "object" + }, + "NetworkEndpointGroupPscData": { + "description": "All data that is specifically relevant to only network endpoint groups of\ntype PRIVATE_SERVICE_CONNECT.", + "id": "NetworkEndpointGroupPscData", + "properties": { + "consumerPscAddress": { + "description": "Output only. [Output Only] Address allocated from given subnetwork for PSC. This IP\naddress acts as a VIP for a PSC NEG, allowing it to act as an endpoint in\nL7 PSC-XLB.", + "readOnly": true, + "type": "string" + }, + "producerPort": { + "description": "The psc producer port is used to connect PSC NEG with specific port on\nthe PSC Producer side; should only be used for the\nPRIVATE_SERVICE_CONNECT NEG type", + "format": "int32", + "type": "integer" + }, + "pscConnectionId": { + "description": "Output only. [Output Only] The PSC connection id of the PSC Network Endpoint Group\nConsumer.", + "format": "uint64", + "readOnly": true, + "type": "string" + }, + "pscConnectionStatus": { + "description": "Output only. [Output Only] The connection status of the PSC Forwarding Rule.", + "enum": [ + "ACCEPTED", + "CLOSED", + "NEEDS_ATTENTION", + "PENDING", + "REJECTED", + "STATUS_UNSPECIFIED" ], - "response": { - "$ref": "Operation" + "enumDescriptions": [ + "The connection has been accepted by the producer.", + "The connection has been closed by the producer and will not serve\ntraffic going forward.", + "The connection has been accepted by the producer, but the producer\nneeds to take further action before the forwarding rule can serve\ntraffic.", + "The connection is pending acceptance by the producer.", + "The connection has been rejected by the producer.", + "" + ], + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "NetworkEndpointGroupsAttachEndpointsRequest": { + "id": "NetworkEndpointGroupsAttachEndpointsRequest", + "properties": { + "networkEndpoints": { + "description": "The list of network endpoints to be attached.", + "items": { + "$ref": "NetworkEndpoint" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "type": "array" + } + }, + "type": "object" + }, + "NetworkEndpointGroupsDetachEndpointsRequest": { + "id": "NetworkEndpointGroupsDetachEndpointsRequest", + "properties": { + "networkEndpoints": { + "description": "The list of network endpoints to be detached.", + "items": { + "$ref": "NetworkEndpoint" + }, + "type": "array" + } + }, + "type": "object" + }, + "NetworkEndpointGroupsListEndpointsRequest": { + "id": "NetworkEndpointGroupsListEndpointsRequest", + "properties": { + "healthStatus": { + "description": "Optional query parameter for showing the health status of each network\nendpoint. Valid options are SKIP or SHOW. If you\ndon't specify this parameter, the health status of network endpoints will\nnot be provided.", + "enum": [ + "SHOW", + "SKIP" ], - "description": "Deletes the specified ForwardingRule resource." + "enumDescriptions": [ + "Show the health status for each network endpoint. Impacts latency of the\ncall.", + "Health status for network endpoints will not be provided." + ], + "type": "string" + } + }, + "type": "object" + }, + "NetworkEndpointGroupsListNetworkEndpoints": { + "id": "NetworkEndpointGroupsListNetworkEndpoints", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "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, + "items": { + "description": "A list of NetworkEndpointWithHealthStatus resources.", + "items": { + "$ref": "NetworkEndpointWithHealthStatus" + }, + "type": "array" + }, + "kind": { + "default": "compute#networkEndpointGroupsListNetworkEndpoints", + "description": "Output only. [Output Only] The resource type, which is alwayscompute#networkEndpointGroupsListNetworkEndpoints for the list\nof network endpoints in the specified network endpoint group.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. 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" } }, - "parameterOrder": [ - "project", - "region", - "forwardingRule" - ], - "request": { - "$ref": "TargetReference" - }, - "response": { - "$ref": "Operation" + "type": "object" + } + }, + "type": "object" + }, + "NetworkEndpointGroupsScopedList": { + "id": "NetworkEndpointGroupsScopedList", + "properties": { + "networkEndpointGroups": { + "description": "Output only. [Output Only] The list ofnetwork\nendpoint groups that are contained in this scope.", + "items": { + "$ref": "NetworkEndpointGroup" }, - "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." + "readOnly": true, + "type": "array" }, - "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, + "warning": { + "description": "Output only. [Output Only] An informational warning that replaces the list of network\nendpoint groups when the list is empty.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. 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" } }, - "parameterOrder": [ - "project", - "region", - "forwardingRule" - ], - "request": { - "$ref": "ForwardingRule" + "readOnly": true, + "type": "object" + } + }, + "type": "object" + }, + "NetworkEndpointWithHealthStatus": { + "id": "NetworkEndpointWithHealthStatus", + "properties": { + "healths": { + "description": "Output only. [Output only] The health status of network endpoint.\n\nOptional. Displayed only if the network endpoint has centralized health\nchecking configured.", + "items": { + "$ref": "HealthStatusForNetworkEndpoint" }, - "response": { - "$ref": "Operation" + "readOnly": true, + "type": "array" + }, + "networkEndpoint": { + "$ref": "NetworkEndpoint", + "description": "Output only. [Output only] The network endpoint.", + "readOnly": true + } + }, + "type": "object" + }, + "NetworkFirewallPolicyAggregatedList": { + "id": "NetworkFirewallPolicyAggregatedList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "additionalProperties": { + "$ref": "FirewallPoliciesScopedList", + "description": "Name of the scope containing this set of addresses." }, - "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." + "description": "A list of FirewallPoliciesScopedList resources.", + "type": "object" }, - "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, + "kind": { + "default": "compute#networkFirewallPolicyAggregatedList", + "description": "Output only. [Output Only] Type of resource. Alwayscompute#networkFirewallPoliciesAggregatedList for lists of\nnetwork firewall policies.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "unreachables": { + "description": "Output only. [Output Only] Unreachable resources.", + "items": { + "type": "string" + }, + "readOnly": true, + "type": "array" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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" } }, - "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." + "type": "object" } - } + }, + "type": "object" }, - "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" - } + "NetworkInterface": { + "description": "A network interface resource attached to an instance.", + "id": "NetworkInterface", + "properties": { + "accessConfigs": { + "description": "An array of configurations for this interface. Currently, only one access\nconfig, ONE_TO_ONE_NAT, is supported. If there are noaccessConfigs specified, then this instance will have\nno external internet access.", + "items": { + "$ref": "AccessConfig" }, - "parameterOrder": [ - "project", - "region" - ], - "response": { - "$ref": "HealthCheckServicesList" + "type": "array" + }, + "aliasIpRanges": { + "description": "An array of alias IP ranges for this network interface.\nYou can only specify this field for network interfaces in VPC networks.", + "items": { + "$ref": "AliasIpRange" }, - "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." + "type": "array" }, - "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" - } + "aliasIpv6Ranges": { + "description": "An array of alias IPv6 ranges for this network interface.\nYou can only specify this field for network interfaces in VPC networks.", + "items": { + "$ref": "AliasIpRange" }, - "parameterOrder": [ - "project", - "region", - "healthCheckService" + "type": "array" + }, + "enableVpcScopedDns": { + "description": "Optional. If true, DNS resolution will be enabled over this interface. Only valid\nwith network_attachment.", + "type": "boolean" + }, + "fingerprint": { + "description": "Fingerprint hash of contents stored in this network interface.\nThis field will be ignored when inserting an Instance or\nadding a NetworkInterface. An up-to-date\nfingerprint must be provided in order to update theNetworkInterface. The request will fail with error400 Bad Request if the fingerprint is not provided, or412 Precondition Failed if the fingerprint is out of date.", + "format": "byte", + "type": "string" + }, + "igmpQuery": { + "description": "Indicate whether igmp query is enabled on the network interface\nor not. If enabled, also indicates the version of IGMP supported.", + "enum": [ + "IGMP_QUERY_DISABLED", + "IGMP_QUERY_V2" ], - "response": { - "$ref": "HealthCheckService" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "The network interface has disabled IGMP query.", + "The network interface has enabled IGMP query - v2." ], - "description": "Returns the specified regional HealthCheckService resource." + "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" - } + "internalIpv6PrefixLength": { + "description": "The prefix length of the primary internal IPv6 range.", + "format": "int32", + "type": "integer" + }, + "ipv6AccessConfigs": { + "description": "An array of IPv6 access configurations for this interface. Currently, only\none IPv6 access config, DIRECT_IPV6, is supported. If there\nis no ipv6AccessConfig specified, then this instance will\nhave no external IPv6 Internet access.", + "items": { + "$ref": "AccessConfig" }, - "parameterOrder": [ - "project", - "region" + "type": "array" + }, + "ipv6AccessType": { + "description": "Output only. [Output Only] One of EXTERNAL, INTERNAL to indicate whether the IP can be\naccessed from the Internet. This field is always inherited from its\nsubnetwork.\n\nValid only if stackType is IPV4_IPV6.", + "enum": [ + "EXTERNAL", + "INTERNAL" ], - "request": { - "$ref": "HealthCheckService" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "This network interface can have external IPv6.", + "This network interface can have internal IPv6." ], - "description": "Creates a regional HealthCheckService resource in the specified project and region using the data included in the request." + "readOnly": true, + "type": "string" }, - "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" + "ipv6Address": { + "description": "An IPv6 internal network address for this network interface. To\nuse a static internal IP address, it must be unused and in the same region\nas the instance's zone. If not specified, Google Cloud will automatically\nassign an internal IPv6 address from the instance's subnetwork.", + "type": "string" + }, + "kind": { + "default": "compute#networkInterface", + "description": "Output only. [Output Only] Type of the resource. Alwayscompute#networkInterface for network interfaces.", + "readOnly": true, + "type": "string" + }, + "name": { + "description": "[Output Only] The name of the network interface, which is generated by the\nserver. For a VM, the network interface uses the nicN naming\nformat. Where N is a value between 0 and7. The default interface value is nic0.", + "type": "string" + }, + "network": { + "description": "URL of the VPC network resource for this instance. When creating an\ninstance, if neither the network nor the subnetwork is specified, the\ndefault network global/networks/default is used. If the\nselected project doesn't have the default network, you must specify a\nnetwork or subnet. If the network is not specified but the subnetwork is\nspecified, the network is inferred.\n\nIf you specify this property, you can specify the network as\na full or partial URL. For example, the following are all valid URLs:\n \n \n - https://www.googleapis.com/compute/v1/projects/project/global/networks/network\n - projects/project/global/networks/network\n - global/networks/default", + "type": "string" + }, + "networkAttachment": { + "description": "The URL of the network attachment that this interface should connect\nto in the following format:\nprojects/{project_number}/regions/{region_name}/networkAttachments/{network_attachment_name}.", + "type": "string" + }, + "networkIP": { + "description": "An IPv4 internal IP address to assign to the instance for this network\ninterface. If not specified by the user, an unused internal IP is\nassigned by the system.", + "type": "string" + }, + "nicType": { + "description": "The type of vNIC to be used on this interface. This may be gVNIC or\nVirtioNet.", + "enum": [ + "GVNIC", + "IDPF", + "IRDMA", + "MRDMA", + "UNSPECIFIED_NIC_TYPE", + "VIRTIO_NET" ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "GVNIC", + "IDPF", + "IRDMA", + "MRDMA", + "No type specified.", + "VIRTIO" ], - "description": "Deletes the specified regional HealthCheckService." + "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" + "parentNicName": { + "description": "Name of the parent network interface of a dynamic network interface.", + "type": "string" + }, + "queueCount": { + "description": "The networking queue count that's specified by users for the network\ninterface. Both Rx and Tx queues will be set to this number. It'll be empty\nif not specified by the users.", + "format": "int32", + "type": "integer" + }, + "serviceClassId": { + "description": "Optional. Producer Service's Service class Id for the region of this network\ninterface. Can only be used with network_attachment. It is not possible to\nuse on its own however, network_attachment can be used without\nservice_class_id.", + "type": "string" + }, + "stackType": { + "description": "The stack type for this network interface. To assign only IPv4 addresses,\nuse IPV4_ONLY. To assign both IPv4 and IPv6 addresses, useIPV4_IPV6. If not specified, IPV4_ONLY is used.\n\nThis field can be both set at instance creation and update network\ninterface operations.", + "enum": [ + "IPV4_IPV6", + "IPV4_ONLY", + "IPV6_ONLY" ], - "request": { - "$ref": "HealthCheckService" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "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." ], - "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." + "type": "string" + }, + "subnetwork": { + "description": "The URL of the Subnetwork resource for this instance. If the network\nresource is inlegacy\nmode, do not specify this field. If the network is in auto subnet\nmode, specifying the subnetwork is optional. If the network is in custom\nsubnet mode, specifying the subnetwork is required. If you specify this\nfield, you can specify the subnetwork as a full or partial URL. For\nexample, the following are all valid URLs:\n \n \n - https://www.googleapis.com/compute/v1/projects/project/regions/region/subnetworks/subnetwork \n - regions/region/subnetworks/subnetwork", + "type": "string" + }, + "vlan": { + "description": "VLAN tag of a dynamic network interface, must be an integer in the range\nfrom 2 to 255 inclusively.", + "format": "int32", + "type": "integer" } - } + }, + "type": "object" }, - "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" + "NetworkList": { + "description": "Contains a list of networks.", + "id": "NetworkList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of Network resources.", + "items": { + "$ref": "Network" }, - "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." + "type": "array" }, - "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", + "kind": { + "default": "compute#networkList", + "description": "Output only. [Output Only] Type of resource. Always compute#networkList for\nlists of networks.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "pageToken": { - "description": "Specifies a page token 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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" } }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "HealthChecksAggregatedList" + "type": "object" + } + }, + "type": "object" + }, + "NetworkParams": { + "description": "Additional network parameters.", + "id": "NetworkParams", + "properties": { + "resourceManagerTags": { + "additionalProperties": { + "type": "string" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "description": "Tag keys/values directly bound to this resource.\nTag keys and values have the same definition as resource\nmanager tags. The field is allowed for INSERT\nonly. The keys/values to set on the resource should be specified in\neither ID { : } or Namespaced format\n{ : }.\nFor example the following are valid inputs:\n* {\"tagKeys/333\" : \"tagValues/444\", \"tagKeys/123\" : \"tagValues/456\"}\n* {\"123/environment\" : \"production\", \"345/abc\" : \"xyz\"}\nNote:\n* Invalid combinations of ID & namespaced format is not supported. For\n instance: {\"123/environment\" : \"tagValues/444\"} is invalid.", + "type": "object" + } + }, + "type": "object" + }, + "NetworkPeering": { + "description": "A network peering attached to a network resource. The message includes the\npeering name, peer network, peering state, and a flag indicating whether\nGoogle Compute Engine should automatically create routes for the peering.", + "id": "NetworkPeering", + "properties": { + "autoCreateRoutes": { + "description": "This field will be deprecated soon. Use theexchange_subnet_routes field instead.\nIndicates whether full mesh connectivity is created and managed\nautomatically between peered networks. Currently this field should always\nbe true since Google Compute Engine will automatically create and manage\nsubnetwork routes between two networks when peering state isACTIVE.", + "type": "boolean" + }, + "connectionStatus": { + "$ref": "NetworkPeeringConnectionStatus", + "description": "Output only. [Output Only] The effective state of the peering connection\nas a whole.", + "readOnly": true + }, + "exchangeSubnetRoutes": { + "description": "Indicates whether full mesh connectivity is created and managed\nautomatically between peered networks. Currently this field should always\nbe true since Google Compute Engine will automatically create and manage\nsubnetwork routes between two networks when peering state isACTIVE.", + "type": "boolean" + }, + "exportCustomRoutes": { + "description": "Whether to export the custom routes to peer network. The default value is\nfalse.", + "type": "boolean" + }, + "exportSubnetRoutesWithPublicIp": { + "description": "Whether subnet routes with public IP range are exported. The default value\nis true, all subnet routes are exported.IPv4\nspecial-use ranges are always\nexported to peers and are not controlled by this field.", + "type": "boolean" + }, + "importCustomRoutes": { + "description": "Whether to import the custom routes from peer network. The default value is\nfalse.", + "type": "boolean" + }, + "importSubnetRoutesWithPublicIp": { + "description": "Whether subnet routes with public IP range are imported. The default value\nis false.IPv4\nspecial-use ranges are always\nimported from peers and are not controlled by this field.", + "type": "boolean" + }, + "name": { + "description": "Name of this peering. Provided by the client when the peering is created.\nThe name must comply withRFC1035.\nSpecifically, the name must be 1-63 characters long and match regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?`. The first character must be a\nlowercase letter, and all the following characters must be a dash,\nlowercase letter, or digit, except the last character, which cannot be a\ndash.", + "type": "string" + }, + "network": { + "description": "The URL of the peer network. It can be either full URL or partial URL. The\npeer network may belong to a different project. If the partial URL does not\ncontain project, it is assumed that the peer network is in the same project\nas the current network.", + "type": "string" + }, + "peerMtu": { + "description": "Output only. [Output Only] Maximum Transmission Unit in bytes of the peer network.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "stackType": { + "description": "Which IP version(s) of traffic and routes are allowed to be imported or\nexported between peer networks. The default value is IPV4_ONLY.", + "enum": [ + "IPV4_IPV6", + "IPV4_ONLY" + ], + "enumDescriptions": [ + "This Peering will allow IPv4 traffic and routes to be\nexchanged. Additionally if the matching peering is\nIPV4_IPV6, IPv6 traffic and routes will be exchanged as\nwell.", + "This Peering will only allow IPv4 traffic and routes to be\nexchanged, even if the matching peering is IPV4_IPV6." ], - "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`." + "type": "string" }, - "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" + "state": { + "description": "Output only. [Output Only] State for the peering.", + "enum": [ + "ACTIVE", + "INACTIVE" ], - "response": { - "$ref": "HealthCheck" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "Matching configuration exists on the peer.", + "There is no matching configuration on the peer, including the case when\npeer does not exist." ], - "description": "Returns the specified HealthCheck resource." + "readOnly": true, + "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" + "stateDetails": { + "description": "Output only. [Output Only] Details about the current state of the peering.", + "readOnly": true, + "type": "string" + }, + "updateStrategy": { + "description": "The update strategy determines the semantics for updates and deletes to the\npeering connection configuration.", + "enum": [ + "CONSENSUS", + "INDEPENDENT", + "UNSPECIFIED" ], - "request": { - "$ref": "HealthCheck" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "Updates are reflected in the local peering but aren't applied to the\npeering connection until a complementary change is made to the\nmatching peering.\nTo delete a peering with the consensus update strategy, both the peerings\nmust request the deletion of the peering before the peering can be\ndeleted.", + "In this mode, changes to the peering configuration can\nbe unilaterally altered by changing either side of the peering.\nThis is the default value if the field is unspecified.", + "Peerings with update strategy UNSPECIFIED are created with\nupdate strategy INDEPENDENT." ], - "description": "Creates a HealthCheck resource in the specified project using the data included in the request." + "type": "string" + } + }, + "type": "object" + }, + "NetworkPeeringConnectionStatus": { + "description": "[Output Only] Describes the state of a peering connection, not just the\nlocal peering. This field provides information about the effective settings\nfor the connection as a whole, including pending delete/update requests for\nCONSENSUS peerings.", + "id": "NetworkPeeringConnectionStatus", + "properties": { + "consensusState": { + "$ref": "NetworkPeeringConnectionStatusConsensusState", + "description": "The consensus state contains information about the status of update\nand delete for a consensus peering connection." }, - "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" + "trafficConfiguration": { + "$ref": "NetworkPeeringConnectionStatusTrafficConfiguration", + "description": "The active connectivity settings for the peering connection based on the\nsettings of the network peerings." + }, + "updateStrategy": { + "description": "The update strategy determines the update/delete semantics for this\npeering connection.", + "enum": [ + "CONSENSUS", + "INDEPENDENT", + "UNSPECIFIED" ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "Updates are reflected in the local peering but aren't applied to the\npeering connection until a complementary change is made to the\nmatching peering.\nTo delete a peering with the consensus update strategy, both the peerings\nmust request the deletion of the peering before the peering can be\ndeleted.", + "In this mode, changes to the peering configuration can\nbe unilaterally altered by changing either side of the peering.\nThis is the default value if the field is unspecified.", + "Peerings with update strategy UNSPECIFIED are created with\nupdate strategy INDEPENDENT." + ], + "type": "string" + } + }, + "type": "object" + }, + "NetworkPeeringConnectionStatusConsensusState": { + "description": "The status of update/delete for a consensus peering connection. Only set\nwhen connection_status.update_strategy isCONSENSUS or a network peering is proposing to update the\nstrategy to CONSENSUS.", + "id": "NetworkPeeringConnectionStatusConsensusState", + "properties": { + "deleteStatus": { + "description": "The status of the delete request.", + "enum": [ + "DELETE_ACKNOWLEDGED", + "DELETE_STATUS_UNSPECIFIED", + "LOCAL_CANCEL_REQUESTED", + "LOCAL_DELETE_REQUESTED", + "PEER_CANCEL_REQUESTED", + "PEER_DELETE_REQUESTED" + ], + "enumDescriptions": [ + "Both network admins have agreed this consensus peering connection can\nbe deleted.", + "", + "The local network admin requested to cancel their delete request\nafter DELETE_ACKNOWLEDGED.", + "Network admin has requested deletion of this peering connection.", + "The peer network admin requested to cancel their delete request after\nDELETE_ACKNOWLEDGED.", + "The peer network admin has requested deletion of this peering\nconnection." ], - "description": "Deletes the specified HealthCheck resource." + "type": "string" }, - "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" + "updateStatus": { + "description": "The status of the update request.", + "enum": [ + "IN_SYNC", + "PENDING_LOCAL_ACKNOWLEDMENT", + "PENDING_PEER_ACKNOWLEDGEMENT", + "UPDATE_STATUS_UNSPECIFIED" ], - "request": { - "$ref": "HealthCheck" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "No pending configuration update proposals to the peering connection.", + "The peer network admin has made an updatePeering call. The change is\nawaiting acknowledgment from this peering's network admin.", + "The local network admin has made an updatePeering call. The change\nis awaiting acknowledgment from the peer network admin.", + "" ], - "description": "Updates a HealthCheck resource in the specified project using the data included in the request." + "type": "string" + } + }, + "type": "object" + }, + "NetworkPeeringConnectionStatusTrafficConfiguration": { + "id": "NetworkPeeringConnectionStatusTrafficConfiguration", + "properties": { + "exportCustomRoutesToPeer": { + "description": "Whether custom routes are being exported to the peer network.", + "type": "boolean" }, - "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" + "exportSubnetRoutesWithPublicIpToPeer": { + "description": "Whether subnet routes with public IP ranges are being exported to the\npeer network.", + "type": "boolean" + }, + "importCustomRoutesFromPeer": { + "description": "Whether custom routes are being imported from the peer network.", + "type": "boolean" + }, + "importSubnetRoutesWithPublicIpFromPeer": { + "description": "Whether subnet routes with public IP ranges are being imported\nfrom the peer network.", + "type": "boolean" + }, + "stackType": { + "description": "Which IP version(s) of traffic and routes are being imported or\nexported between peer networks.", + "enum": [ + "IPV4_IPV6", + "IPV4_ONLY" ], - "request": { - "$ref": "HealthCheck" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "This Peering will allow IPv4 traffic and routes to be\nexchanged. Additionally if the matching peering is\nIPV4_IPV6, IPv6 traffic and routes will be exchanged as\nwell.", + "This Peering will only allow IPv4 traffic and routes to be\nexchanged, even if the matching peering is IPV4_IPV6." ], - "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." + "type": "string" } - } + }, + "type": "object" }, - "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" + "NetworkPerformanceConfig": { + "id": "NetworkPerformanceConfig", + "properties": { + "totalEgressBandwidthTier": { + "enum": [ + "DEFAULT", + "TIER_1" ], - "response": { - "$ref": "HealthCheckList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "", + "" ], - "description": "Retrieves the list of HealthCheck resources available to the specified project." + "type": "string" + } + }, + "type": "object" + }, + "NetworkProfile": { + "description": "NetworkProfile represents a Google managed network profile resource.", + "id": "NetworkProfile", + "properties": { + "creationTimestamp": { + "description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", + "readOnly": true, + "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" + "description": { + "description": "Output only. [Output Only] An optional description of this resource.", + "readOnly": true, + "type": "string" + }, + "features": { + "$ref": "NetworkProfileNetworkFeatures", + "description": "Output only. [Output Only] Features supported by the network.", + "readOnly": true + }, + "id": { + "description": "Output only. [Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "format": "uint64", + "readOnly": true, + "type": "string" + }, + "kind": { + "default": "compute#networkProfile", + "description": "Output only. [Output Only] Type of the resource. Alwayscompute#networkProfile for network profiles.", + "readOnly": true, + "type": "string" + }, + "location": { + "$ref": "NetworkProfileLocation", + "description": "Output only. [Output Only] Location to which the network is restricted.", + "readOnly": true + }, + "name": { + "description": "Output only. [Output Only] Name of the resource.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "readOnly": true, + "type": "string" + }, + "profileType": { + "$ref": "NetworkProfileProfileType", + "description": "Output only. [Output Only] Type of the network profile.", + "readOnly": true + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for the resource.", + "readOnly": true, + "type": "string" + }, + "selfLinkWithId": { + "description": "Output only. [Output Only] Server-defined URL for this resource with the resource id.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "NetworkProfileLocation": { + "id": "NetworkProfileLocation", + "properties": { + "name": { + "type": "string" + }, + "scope": { + "enum": [ + "REGION", + "ZONE" ], - "response": { - "$ref": "HealthCheck" + "enumDescriptions": [ + "", + "" + ], + "type": "string" + } + }, + "type": "object" + }, + "NetworkProfileNetworkFeatures": { + "id": "NetworkProfileNetworkFeatures", + "properties": { + "addressPurposes": { + "description": "Specifies what address purposes are supported. If empty, all address\npurposes are supported.", + "items": { + "enum": [ + "DNS_RESOLVER", + "GCE_ENDPOINT", + "IPSEC_INTERCONNECT", + "NAT_AUTO", + "PRIVATE_SERVICE_CONNECT", + "SERVERLESS", + "SHARED_LOADBALANCER_VIP", + "VPC_PEERING" + ], + "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\nthat is used in HA VPN over Cloud Interconnect. This regional\ninternal IP address range must not overlap with any IP address range\nof subnet/route in the VPC network and its peering networks. After the\nVLAN attachment is created with the reserved IP address range, when\ncreating a new VPN gateway, its interface IP address is allocated\nfrom 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\nService Connect. This purpose can be specified only forGLOBAL 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\nLoad Balancer forwarding rules.", + "IP range for peer networks." + ], + "type": "string" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "type": "array" + }, + "allowAddressCreation": { + "description": "Specifies whether address creation is allowed.", + "enum": [ + "ADDRESS_CREATION_ALLOWED", + "ADDRESS_CREATION_BLOCKED" + ], + "enumDescriptions": [ + "", + "" ], - "description": "Returns the specified HealthCheck 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" + "allowAliasIpRanges": { + "description": "Specifies whether alias IP ranges (and secondary address ranges) are\nallowed.", + "enum": [ + "ALIAS_IP_RANGES_ALLOWED", + "ALIAS_IP_RANGES_BLOCKED" ], - "request": { - "$ref": "HealthCheck" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "", + "" ], - "description": "Creates a HealthCheck resource in the specified project using the data included in the request." + "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" + "allowAutoModeSubnet": { + "description": "Specifies whether auto mode subnet creation is allowed.", + "enum": [ + "AUTO_MODE_SUBNET_ALLOWED", + "AUTO_MODE_SUBNET_BLOCKED" ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "", + "" ], - "description": "Deletes the specified HealthCheck resource." + "type": "string" }, - "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" + "allowClassDFirewalls": { + "description": "Specifies whether firewalls for Class D address ranges are supported.", + "enum": [ + "CLASS_D_FIREWALLS_ALLOWED", + "CLASS_D_FIREWALLS_BLOCKED" ], - "request": { - "$ref": "HealthCheck" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "", + "" ], - "description": "Updates a HealthCheck resource in the specified project using the data included in the request." + "type": "string" }, - "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" + "allowCloudNat": { + "description": "Specifies whether cloud NAT creation is allowed.", + "enum": [ + "CLOUD_NAT_ALLOWED", + "CLOUD_NAT_BLOCKED" ], - "request": { - "$ref": "HealthCheck" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "", + "" ], - "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." - } - } - }, - "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" + "type": "string" + }, + "allowCloudRouter": { + "description": "Specifies whether cloud router creation is allowed.", + "enum": [ + "CLOUD_ROUTER_ALLOWED", + "CLOUD_ROUTER_BLOCKED" ], - "response": { - "$ref": "HttpHealthCheckList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "", + "" ], - "description": "Retrieves the list of HttpHealthCheck resources available to the specified project." + "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" + "allowDefaultNicAttachment": { + "description": "Specifies whether default NIC attachment is allowed.", + "enum": [ + "DEFAULT_NIC_ATTACHMENT_ALLOWED", + "DEFAULT_NIC_ATTACHMENT_BLOCKED" ], - "response": { - "$ref": "HttpHealthCheck" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "", + "" ], - "description": "Returns the specified HttpHealthCheck resource." + "type": "string" }, - "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" + "allowExternalIpAccess": { + "description": "Specifies whether VMs are allowed to have external IP access on network\ninterfaces connected to this VPC.", + "enum": [ + "EXTERNAL_IP_ACCESS_ALLOWED", + "EXTERNAL_IP_ACCESS_BLOCKED" ], - "request": { - "$ref": "HttpHealthCheck" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "", + "" ], - "description": "Creates a HttpHealthCheck resource in the specified project using the data included in the request." + "type": "string" }, - "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" + "allowFirewallPolicy": { + "description": "Specifies whether firewall policy can be attached to the network.", + "enum": [ + "FIREWALL_POLICY_ALLOWED", + "FIREWALL_POLICY_BLOCKED" ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "", + "" ], - "description": "Deletes the specified HttpHealthCheck resource." + "type": "string" }, - "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" + "allowInterconnect": { + "description": "Specifies whether Cloud Interconnect creation is allowed.", + "enum": [ + "INTERCONNECT_ALLOWED", + "INTERCONNECT_BLOCKED" ], - "request": { - "$ref": "HttpHealthCheck" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "", + "" ], - "description": "Updates a HttpHealthCheck resource in the specified project using the data included in the request." + "type": "string" }, - "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" + "allowIpForwarding": { + "description": "Specifies whether IP forwarding is allowed.", + "enum": [ + "IP_FORWARDING_ALLOWED", + "IP_FORWARDING_BLOCKED" ], - "request": { - "$ref": "HttpHealthCheck" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "", + "" + ], + "type": "string" + }, + "allowLoadBalancing": { + "description": "Specifies whether cloud load balancing is allowed.", + "enum": [ + "LOAD_BALANCING_ALLOWED", + "LOAD_BALANCING_BLOCKED" + ], + "enumDescriptions": [ + "", + "" + ], + "type": "string" + }, + "allowMultiNicInSameNetwork": { + "description": "Specifies whether multi-nic in the same network is allowed.", + "enum": [ + "MULTI_NIC_IN_SAME_NETWORK_ALLOWED", + "MULTI_NIC_IN_SAME_NETWORK_BLOCKED" + ], + "enumDescriptions": [ + "", + "" + ], + "type": "string" + }, + "allowMultiNicInSameSubnetwork": { + "description": "Specifies whether multi-nic in the same subnetwork is allowed.", + "enum": [ + "MULTI_NIC_IN_SAME_SUBNETWORK_ALLOWED", + "MULTI_NIC_IN_SAME_SUBNETWORK_BLOCKED" ], - "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" + "enumDescriptions": [ + "", + "" ], - "response": { - "$ref": "HttpsHealthCheckList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "type": "string" + }, + "allowMulticast": { + "description": "Specifies whether multicast is allowed.", + "enum": [ + "MULTICAST_ALLOWED", + "MULTICAST_BLOCKED" ], - "description": "Retrieves the list of HttpsHealthCheck resources available to the specified project." + "enumDescriptions": [ + "", + "" + ], + "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" + "allowNcc": { + "description": "Specifies whether NCC is allowed.", + "enum": [ + "NCC_ALLOWED", + "NCC_BLOCKED" ], - "response": { - "$ref": "HttpsHealthCheck" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "", + "" ], - "description": "Returns the specified HttpsHealthCheck 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" + "allowNetworkMigration": { + "description": "Specifies whether VM network migration is allowed.", + "enum": [ + "NETWORK_MIGRATION_ALLOWED", + "NETWORK_MIGRATION_BLOCKED" ], - "request": { - "$ref": "HttpsHealthCheck" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "", + "" ], - "description": "Creates a HttpsHealthCheck resource in the specified project using the data included in the request." + "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" + "allowPacketMirroring": { + "description": "Specifies whether Packet Mirroring 1.0 is supported.", + "enum": [ + "PACKET_MIRRORING_ALLOWED", + "PACKET_MIRRORING_BLOCKED" ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "", + "" ], - "description": "Deletes the specified HttpsHealthCheck resource." + "type": "string" }, - "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" + "allowPrivateGoogleAccess": { + "description": "Specifies whether private Google access is allowed.", + "enum": [ + "PRIVATE_GOOGLE_ACCESS_ALLOWED", + "PRIVATE_GOOGLE_ACCESS_BLOCKED" ], - "request": { - "$ref": "HttpsHealthCheck" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "", + "" ], - "description": "Updates a HttpsHealthCheck resource in the specified project using the data included in the request." + "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" + "allowPsc": { + "description": "Specifies whether PSC creation is allowed.", + "enum": [ + "PSC_ALLOWED", + "PSC_BLOCKED" ], - "request": { - "$ref": "HttpsHealthCheck" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "", + "" ], - "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." - } - } - }, - "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" + "type": "string" + }, + "allowSameNetworkUnicast": { + "description": "Specifies whether unicast within the same network is allowed.", + "enum": [ + "SAME_NETWORK_UNICAST_ALLOWED", + "SAME_NETWORK_UNICAST_BLOCKED" ], - "response": { - "$ref": "InstanceTemplateList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "", + "" ], - "description": "Retrieves a list of instance templates that are contained within the specified project." + "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" + "allowStaticRoutes": { + "description": "Specifies whether static route creation is allowed.", + "enum": [ + "STATIC_ROUTES_ALLOWED", + "STATIC_ROUTES_BLOCKED" ], - "response": { - "$ref": "InstanceTemplate" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "", + "" ], - "description": "Returns the specified instance template." + "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" + "allowSubInterfaces": { + "description": "Specifies whether sub interfaces are allowed.", + "enum": [ + "SUBINTERFACES_ALLOWED", + "SUBINTERFACES_BLOCKED" ], - "request": { - "$ref": "InstanceTemplate" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "", + "" ], - "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." + "type": "string" }, - "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" + "allowSubnetworkCreation": { + "description": "Specifies whether subnetwork creation is allowed.", + "enum": [ + "SUBNETWORK_CREATION_ALLOWED", + "SUBNETWORK_CREATION_BLOCKED" ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "", + "" ], - "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." + "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" + "allowVpcFirewallRules": { + "description": "Specifies whether VPC firewall rules can be created under the network.", + "enum": [ + "VPC_FIREWALL_RULES_ALLOWED", + "VPC_FIREWALL_RULES_BLOCKED" ], - "response": { - "$ref": "InstanceTemplateAggregatedList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "", + "" + ], + "type": "string" + }, + "allowVpcPeering": { + "description": "Specifies whether VPC peering is allowed.", + "enum": [ + "VPC_PEERING_ALLOWED", + "VPC_PEERING_BLOCKED" + ], + "enumDescriptions": [ + "", + "" ], - "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`." + "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" + "allowVpn": { + "description": "Specifies whether VPN creation is allowed.", + "enum": [ + "VPN_ALLOWED", + "VPN_BLOCKED" ], - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "", + "" ], - "description": "Gets the access control policy for a resource. May be empty if no such policy or resource exists." + "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" - } + "firewallPolicyTypes": { + "items": { + "enum": [ + "RDMA_ROCE_POLICY", + "ULL_POLICY", + "VPC_POLICY" + ], + "enumDescriptions": [ + "", + "", + "" + ], + "type": "string" }, - "parameterOrder": [ - "project", - "resource" + "type": "array" + }, + "interfaceTypes": { + "description": "If set, limits the interface types that the network supports. If\nempty, all interface types are supported.", + "items": { + "enum": [ + "GVNIC", + "IDPF", + "IRDMA", + "MRDMA", + "UNSPECIFIED_NIC_TYPE", + "VIRTIO_NET" + ], + "enumDescriptions": [ + "GVNIC", + "IDPF", + "IRDMA", + "MRDMA", + "No type specified.", + "VIRTIO" + ], + "type": "string" + }, + "type": "array" + }, + "multicast": { + "description": "Specifies which type of multicast is supported.", + "enum": [ + "MULTICAST_SDN", + "MULTICAST_ULL" ], - "request": { - "$ref": "GlobalSetPolicyRequest" + "enumDescriptions": [ + "", + "" + ], + "type": "string" + }, + "predefinedNetworkInternalIpv6Range": { + "description": "Specifies a predefined internal IPv6 range for the network.", + "type": "string" + }, + "predefinedSubnetworkRanges": { + "description": "Predefined subnetwork ranges for the network.", + "items": { + "$ref": "NetworkProfileNetworkFeaturesPredefinedSubnetworkRange" }, - "response": { - "$ref": "Policy" + "type": "array" + }, + "subnetPurposes": { + "description": "Specifies which subnetwork purposes are supported.", + "items": { + "enum": [ + "SUBNET_PURPOSE_CUSTOM_HARDWARE", + "SUBNET_PURPOSE_PRIVATE" + ], + "enumDescriptions": [ + "", + "" + ], + "type": "string" }, - "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." + "type": "array" }, - "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" - } + "subnetStackTypes": { + "description": "Specifies which subnetwork stack types are supported.", + "items": { + "enum": [ + "SUBNET_STACK_TYPE_IPV4_IPV6", + "SUBNET_STACK_TYPE_IPV4_ONLY", + "SUBNET_STACK_TYPE_IPV6_ONLY" + ], + "enumDescriptions": [ + "", + "", + "" + ], + "type": "string" }, - "parameterOrder": [ - "project", - "resource" - ], - "request": { - "$ref": "TestPermissionsRequest" + "type": "array" + }, + "subnetworkPurposes": { + "description": "Output only. Specifies which subnetwork purposes are supported.", + "items": { + "enum": [ + "GLOBAL_MANAGED_PROXY", + "INTERNAL_HTTPS_LOAD_BALANCER", + "PEER_MIGRATION", + "PRIVATE", + "PRIVATE_NAT", + "PRIVATE_RFC_1918", + "PRIVATE_SERVICE_CONNECT", + "REGIONAL_MANAGED_PROXY" + ], + "enumDescriptions": [ + "Subnet reserved for Global Envoy-based Load Balancing.", + "Subnet reserved for Internal HTTP(S) Load Balancing. This is a legacy\npurpose, please use REGIONAL_MANAGED_PROXY instead.", + "Subnetwork will be used for Migration from one peered VPC to another.\n(a transient state of subnetwork\nwhile migrating resources from one project to another).", + "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." + ], + "type": "string" }, - "response": { - "$ref": "TestPermissionsResponse" + "readOnly": true, + "type": "array" + }, + "subnetworkStackTypes": { + "description": "Output only. Specifies which subnetwork stack types are supported.", + "items": { + "enum": [ + "IPV4_IPV6", + "IPV4_ONLY", + "IPV6_ONLY" + ], + "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." + ], + "type": "string" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "readOnly": true, + "type": "array" + }, + "unicast": { + "description": "Specifies which type of unicast is supported.", + "enum": [ + "UNICAST_SDN", + "UNICAST_ULL" ], - "description": "Returns permissions that a caller has on the specified resource." + "enumDescriptions": [ + "", + "" + ], + "type": "string" } - } + }, + "type": "object" }, - "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" + "NetworkProfileNetworkFeaturesPredefinedSubnetworkRange": { + "id": "NetworkProfileNetworkFeaturesPredefinedSubnetworkRange", + "properties": { + "ipv6Range": { + "description": "The IPv6 range of the predefined subnetwork.", + "type": "string" + }, + "namePrefix": { + "description": "The naming prefix of the predefined subnetwork.", + "type": "string" + } + }, + "type": "object" + }, + "NetworkProfileProfileType": { + "id": "NetworkProfileProfileType", + "properties": { + "networkType": { + "enum": [ + "RDMA", + "ULL", + "VPC" ], - "response": { - "$ref": "InstanceTemplateList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "RDMA network.", + "ULL network.", + "VPC network." ], - "description": "Retrieves a list of instance templates that are contained within the specified project and region." + "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" + "rdmaSubtype": { + "enum": [ + "FALCON", + "ROCE", + "ROCE_METAL" ], - "response": { - "$ref": "InstanceTemplate" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "RDMA over Falcon.", + "RDMA over Converged Ethernet (RoCE).", + "RDMA over Converged Ethernet (RoCE) for Bare Metal." ], - "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" - }, - "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" + "ullSubtype": { + "enum": [ + "OPERATOR", + "PARTICIPANT" ], - "request": { - "$ref": "InstanceTemplate" + "enumDescriptions": [ + "Exchange operator.", + "Exchange participant." + ], + "type": "string" + }, + "vpcSubtype": { + "enum": [ + "REGIONAL" + ], + "enumDescriptions": [ + "Regionally bound VPC network." + ], + "type": "string" + } + }, + "type": "object" + }, + "NetworkProfilesListResponse": { + "description": "Contains a list of network profiles.", + "id": "NetworkProfilesListResponse", + "properties": { + "etag": { + "type": "string" + }, + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of NetworkProfile resources.", + "items": { + "$ref": "NetworkProfile" }, - "response": { - "$ref": "Operation" + "type": "array" + }, + "kind": { + "default": "compute#networkProfileList", + "description": "Output only. [Output Only] Type of resource. Alwayscompute#networkProfileList for network profiles.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value\nfor\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken\nto\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "unreachables": { + "description": "Output only. [Output Only] Unreachable resources.\nend_interface: MixerListResponseWithEtagBuilder", + "items": { + "type": "string" }, - "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." + "readOnly": true, + "type": "array" }, - "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, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. 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" } }, - "parameterOrder": [ - "project", - "region", - "instanceTemplate" + "type": "object" + } + }, + "type": "object" + }, + "NetworkRoutingConfig": { + "description": "A routing configuration attached to a network resource. The message\nincludes the list of routers associated with the network, and a flag\nindicating the type of routing behavior to enforce network-wide.", + "id": "NetworkRoutingConfig", + "properties": { + "bgpAlwaysCompareMed": { + "description": "Enable comparison of Multi-Exit Discriminators (MED) across routes with\ndifferent neighbor ASNs when using the STANDARD BGP best path selection\nalgorithm.", + "type": "boolean" + }, + "bgpBestPathSelectionMode": { + "description": "The BGP best path selection algorithm to be employed within this network\nfor dynamic routes learned by Cloud Routers. Can be LEGACY\n(default) or STANDARD.", + "enum": [ + "LEGACY", + "STANDARD" ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "", + "" + ], + "type": "string" + }, + "bgpInterRegionCost": { + "description": "Allows to define a preferred approach for handling inter-region cost in\nthe selection process when using the STANDARD BGP best path\nselection algorithm. Can be DEFAULT orADD_COST_TO_MED.", + "enum": [ + "ADD_COST_TO_MED", + "DEFAULT" + ], + "enumDescriptions": [ + "", + "" ], - "description": "Deletes the specified instance template. Deleting an instance template is permanent and cannot be undone." + "type": "string" + }, + "effectiveBgpAlwaysCompareMed": { + "description": "Output only. [Output Only] Effective value of the bgp_always_compare_med\nfield.", + "readOnly": true, + "type": "boolean" + }, + "effectiveBgpInterRegionCost": { + "description": "Output only. [Output Only] Effective value of the bgp_inter_region_cost\nfield.", + "enum": [ + "ADD_COST_TO_MED", + "DEFAULT" + ], + "enumDescriptions": [ + "", + "" + ], + "readOnly": true, + "type": "string" + }, + "routingMode": { + "description": "The network-wide routing mode to use. If set to REGIONAL,\nthis network's Cloud Routers will only advertise routes with subnets\nof this network in the same region as the router. If set toGLOBAL, this network's Cloud Routers will advertise\nroutes with all subnets of this network, across regions.", + "enum": [ + "GLOBAL", + "REGIONAL" + ], + "enumDescriptions": [ + "", + "" + ], + "type": "string" } - } + }, + "type": "object" }, - "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" - } + "NetworksAddPeeringRequest": { + "id": "NetworksAddPeeringRequest", + "properties": { + "autoCreateRoutes": { + "description": "This field will be deprecated soon. Useexchange_subnet_routes in network_peering\ninstead.\nIndicates whether full mesh connectivity is created and managed\nautomatically between peered networks. Currently this field should always\nbe true since Google Compute Engine will automatically create and manage\nsubnetwork routes between two networks when peering state isACTIVE.", + "type": "boolean" + }, + "name": { + "annotations": { + "required": [ + "compute.networks.addPeering" + ] }, - "parameterOrder": [ - "project", - "zone" - ], - "response": { - "$ref": "InstanceSettings" + "description": "Name of the peering, which should conform to RFC1035.", + "type": "string" + }, + "networkPeering": { + "$ref": "NetworkPeering", + "description": "Network peering parameters.\nIn order to specify route policies for peering using import and export\ncustom routes, you must specify all peering related parameters\n(name, peer network,exchange_subnet_routes) in the network_peering\nfield.\nThe corresponding fields in NetworksAddPeeringRequest will be\ndeprecated soon." + }, + "peerNetwork": { + "description": "URL of the peer network. It can be either full URL or partial URL. The\npeer network may belong to a different project. If the partial URL does not\ncontain project, it is assumed that the peer network is in the same project\nas the current network.", + "type": "string" + } + }, + "type": "object" + }, + "NetworksCancelRequestRemovePeeringRequest": { + "id": "NetworksCancelRequestRemovePeeringRequest", + "properties": { + "name": { + "description": "Name of the peering, which should conform to RFC1035.", + "type": "string" + } + }, + "type": "object" + }, + "NetworksGetEffectiveFirewallsResponse": { + "id": "NetworksGetEffectiveFirewallsResponse", + "properties": { + "firewallPolicys": { + "description": "[Output Only] Effective firewalls from firewall policy. It returns Global\nNetwork Firewall Policies and Hierarchical Firewall Policies. UseregionNetworkFirewallPolicies.getEffectiveFirewalls to get\nRegional Network Firewall Policies as well.", + "items": { + "$ref": "NetworksGetEffectiveFirewallsResponseEffectiveFirewallPolicy" }, - "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." + "type": "array" }, - "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" - } + "firewalls": { + "description": "Effective firewalls on the network.", + "items": { + "$ref": "Firewall" }, - "parameterOrder": [ - "project", - "zone" - ], - "request": { - "$ref": "InstanceSettings" + "type": "array" + } + }, + "type": "object" + }, + "NetworksGetEffectiveFirewallsResponseEffectiveFirewallPolicy": { + "id": "NetworksGetEffectiveFirewallsResponseEffectiveFirewallPolicy", + "properties": { + "displayName": { + "deprecated": true, + "description": "Output only. [Output Only] Deprecated, please use short name instead. The display name\nof the firewall policy.", + "readOnly": true, + "type": "string" + }, + "name": { + "description": "Output only. [Output Only] The name of the firewall policy.", + "readOnly": true, + "type": "string" + }, + "packetMirroringRules": { + "description": "Output only. [Output Only] The packet mirroring rules that apply to the network.", + "items": { + "$ref": "FirewallPolicyRule" }, - "response": { - "$ref": "Operation" + "readOnly": true, + "type": "array" + }, + "priority": { + "description": "Output only. [Output only] Priority of firewall policy association. Not applicable for\ntype=HIERARCHY.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "rules": { + "description": "[Output Only] The rules that apply to the network.", + "items": { + "$ref": "FirewallPolicyRule" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "type": "array" + }, + "shortName": { + "description": "Output only. [Output Only] The short name of the firewall policy.", + "readOnly": true, + "type": "string" + }, + "type": { + "description": "Output only. [Output Only] The type of the firewall policy.", + "enum": [ + "HIERARCHY", + "NETWORK", + "SYSTEM", + "UNSPECIFIED" + ], + "enumDescriptions": [ + "", + "", + "", + "" ], - "description": "Patch Instance settings" + "readOnly": true, + "type": "string" } - } + }, + "type": "object" }, - "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" + "NetworksRemovePeeringRequest": { + "id": "NetworksRemovePeeringRequest", + "properties": { + "name": { + "description": "Name of the peering, which should conform to RFC1035.", + "type": "string" + } + }, + "type": "object" + }, + "NetworksRequestRemovePeeringRequest": { + "id": "NetworksRequestRemovePeeringRequest", + "properties": { + "name": { + "description": "Name of the peering, which should conform to RFC1035.", + "type": "string" + } + }, + "type": "object" + }, + "NetworksUpdatePeeringRequest": { + "id": "NetworksUpdatePeeringRequest", + "properties": { + "networkPeering": { + "$ref": "NetworkPeering" + } + }, + "type": "object" + }, + "NodeGroup": { + "description": "Represents a sole-tenant Node Group resource.\n\nA sole-tenant node is a physical server that is dedicated to\nhosting VM instances only for your specific project. Use sole-tenant nodes to\nkeep your instances physically separated from instances in other projects, or\nto group your instances together on the same host hardware. For more\ninformation, readSole-tenant nodes.", + "id": "NodeGroup", + "properties": { + "autoscalingPolicy": { + "$ref": "NodeGroupAutoscalingPolicy", + "description": "Specifies how autoscaling should behave." + }, + "creationTimestamp": { + "description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you\ncreate the resource.", + "type": "string" + }, + "fingerprint": { + "format": "byte", + "type": "string" + }, + "id": { + "description": "Output only. [Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "format": "uint64", + "readOnly": true, + "type": "string" + }, + "kind": { + "default": "compute#nodeGroup", + "description": "Output only. [Output Only] The type of the resource. Alwayscompute#nodeGroup for node group.", + "readOnly": true, + "type": "string" + }, + "locationHint": { + "description": "An opaque location hint used to place the Node close to other\nresources.\nThis field is for use by internal tools that use the public API.\nThe location hint here on the NodeGroup overrides any location_hint\npresent in the NodeTemplate.", + "type": "string" + }, + "maintenanceInterval": { + "description": "Specifies the frequency of planned maintenance events. The accepted values\nare: `AS_NEEDED` and `RECURRENT`.", + "enum": [ + "AS_NEEDED", + "RECURRENT" ], - "response": { - "$ref": "InstantSnapshotList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "VMs are eligible to receive infrastructure and hypervisor updates as they\nbecome available. This may result in more maintenance operations (live\nmigrations or terminations) for the VM than the PERIODIC andRECURRENT options.", + "VMs receive infrastructure and hypervisor updates on a periodic basis,\nminimizing the number of maintenance operations (live migrations or\nterminations) on an individual VM. This may mean a VM will take longer\nto receive an update than if it was configured forAS_NEEDED. Security updates will still be applied as soon\nas they are available. RECURRENT is used for GEN3 and Slice\nof Hardware VMs." ], - "description": "Retrieves the list of InstantSnapshot resources contained within the specified zone." + "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, + "maintenancePolicy": { + "description": "Specifies how to handle instances when a node in the group undergoes\nmaintenance. Set to one of: DEFAULT,RESTART_IN_PLACE, or MIGRATE_WITHIN_NODE_GROUP.\nThe default value is DEFAULT. For more information, see\nMaintenance policies.", + "enum": [ + "DEFAULT", + "MAINTENANCE_POLICY_UNSPECIFIED", + "MIGRATE_WITHIN_NODE_GROUP", + "RESTART_IN_PLACE" + ], + "enumDescriptions": [ + "Allow the node and corresponding instances to retain default\nmaintenance behavior.", + "", + "When maintenance must be done on a node, the instances on that node will\nbe moved to other nodes in the group.\nInstances with onHostMaintenance = MIGRATE will live migrate to their\ndestinations while instances with onHostMaintenance = TERMINATE will\nterminate and then restart on their destination nodes if\nautomaticRestart = true.", + "Instances in this group will restart on the same node when maintenance\nhas completed. Instances must have onHostMaintenance = TERMINATE, and\nthey will only restart if automaticRestart = true." + ], + "type": "string" + }, + "maintenanceWindow": { + "$ref": "NodeGroupMaintenanceWindow" + }, + "name": { + "description": "The name of the resource, provided by the client when initially creating\nthe resource. The resource name must be 1-63 characters long, and comply\nwithRFC1035.\nSpecifically, the name must be 1-63 characters long and match the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first\ncharacter must be a lowercase letter, and all following characters must be\na dash, lowercase letter, or digit, except the last character, which cannot\nbe a dash.", + "type": "string" + }, + "nodeTemplate": { + "description": "URL of the node template to create the node group from.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for the resource.", + "readOnly": true, + "type": "string" + }, + "shareSettings": { + "$ref": "ShareSettings", + "description": "Share-settings for the node group" + }, + "size": { + "description": "Output only. [Output Only] The total number of nodes in the node group.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "status": { + "enum": [ + "CREATING", + "DELETING", + "INVALID", + "READY" + ], + "enumDescriptions": [ + "", + "", + "", + "" + ], + "readOnly": true, + "type": "string" + }, + "zone": { + "description": "Output only. [Output Only] The name of the zone where the node group resides,\nsuch as us-central1-a.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "NodeGroupAggregatedList": { + "id": "NodeGroupAggregatedList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "additionalProperties": { + "$ref": "NodeGroupsScopedList", + "description": "[Output Only] Name of the scope containing this set of node groups." + }, + "description": "A list of NodeGroupsScopedList resources.", + "type": "object" + }, + "kind": { + "default": "compute#nodeGroupAggregatedList", + "description": "Output only. [Output Only] Type of resource.Alwayscompute#nodeGroupAggregatedList for aggregated lists of node\ngroups.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "unreachables": { + "description": "Output only. [Output Only] Unreachable resources.", + "items": { + "type": "string" + }, + "readOnly": true, + "type": "array" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project", - "zone", - "instantSnapshot" + "type": "object" + } + }, + "type": "object" + }, + "NodeGroupAutoscalingPolicy": { + "id": "NodeGroupAutoscalingPolicy", + "properties": { + "maxNodes": { + "description": "The maximum number of nodes that the group should have. Must be set if\nautoscaling is enabled. Maximum value allowed is 100.", + "format": "int32", + "type": "integer" + }, + "minNodes": { + "description": "The minimum number of nodes that the group should have.", + "format": "int32", + "type": "integer" + }, + "mode": { + "description": "The autoscaling mode. Set to one of: ON, OFF,\nor ONLY_SCALE_OUT. For more information, see \nAutoscaler modes.", + "enum": [ + "MODE_UNSPECIFIED", + "OFF", + "ON", + "ONLY_SCALE_OUT" ], - "response": { - "$ref": "InstantSnapshot" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "", + "Autoscaling is disabled.", + "Autocaling is fully enabled.", + "Autoscaling will only scale out and will not remove nodes." ], - "description": "Returns the specified InstantSnapshot resource in the specified zone." + "type": "string" + } + }, + "type": "object" + }, + "NodeGroupList": { + "description": "Contains a list of nodeGroups.", + "id": "NodeGroupList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "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" + "items": { + "description": "A list of NodeGroup resources.", + "items": { + "$ref": "NodeGroup" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Creates an instant snapshot in the specified zone." + "type": "array" }, - "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", + "kind": { + "default": "compute#nodeGroupList", + "description": "Output only. [Output Only] Type of resource.Always compute#nodeGroupList\nfor lists of node groups.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "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." + "type": "object" + } + }, + "type": "object" + }, + "NodeGroupMaintenanceWindow": { + "description": "Time window specified for daily maintenance operations. GCE's internal\nmaintenance will be performed within this window.", + "id": "NodeGroupMaintenanceWindow", + "properties": { + "maintenanceDuration": { + "$ref": "Duration", + "description": "Output only. [Output only] A predetermined duration for the window, automatically\nchosen to be the smallest possible in the given scenario.", + "readOnly": true }, - "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" - } + "startTime": { + "description": "Start time of the window. This must be in UTC format that resolves to one\nof 00:00, 04:00, 08:00,12:00, 16:00, or 20:00. For\nexample, both 13:00-5 and 08:00 are valid.", + "type": "string" + } + }, + "type": "object" + }, + "NodeGroupNode": { + "id": "NodeGroupNode", + "properties": { + "accelerators": { + "description": "Accelerators for this node.", + "items": { + "$ref": "AcceleratorConfig" }, - "parameterOrder": [ - "project", - "zone", - "instantSnapshot" + "type": "array" + }, + "consumedResources": { + "$ref": "InstanceConsumptionInfo", + "description": "Output only. Node resources that are reserved by all instances.", + "readOnly": true + }, + "cpuOvercommitType": { + "description": "CPU overcommit.", + "enum": [ + "CPU_OVERCOMMIT_TYPE_UNSPECIFIED", + "ENABLED", + "NONE" ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "", + "", + "" ], - "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." + "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" - }, - "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" - } + "disks": { + "description": "Local disk configurations.", + "items": { + "$ref": "LocalDisk" }, - "parameterOrder": [ - "project", - "zone", - "resource" - ], - "response": { - "$ref": "Policy" + "type": "array" + }, + "instanceConsumptionData": { + "description": "Output only. Instance data that shows consumed resources on the node.", + "items": { + "$ref": "InstanceConsumptionData" }, - "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." + "readOnly": true, + "type": "array" }, - "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" - } + "instances": { + "description": "Instances scheduled on this node.", + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "zone", - "resource" + "type": "array" + }, + "name": { + "description": "The name of the node.", + "type": "string" + }, + "nodeType": { + "description": "The type of this node.", + "type": "string" + }, + "satisfiesPzs": { + "description": "Output only. [Output Only] Reserved for future use.", + "readOnly": true, + "type": "boolean" + }, + "serverBinding": { + "$ref": "ServerBinding", + "description": "Binding properties for the physical server." + }, + "serverId": { + "description": "Server ID associated with this node.", + "type": "string" + }, + "status": { + "enum": [ + "CREATING", + "DELETING", + "INVALID", + "READY", + "REPAIRING" ], - "request": { - "$ref": "ZoneSetPolicyRequest" + "enumDescriptions": [ + "", + "", + "", + "", + "" + ], + "type": "string" + }, + "totalResources": { + "$ref": "InstanceConsumptionInfo", + "description": "Output only. Total amount of available resources on the node.", + "readOnly": true + }, + "upcomingMaintenance": { + "$ref": "UpcomingMaintenance", + "description": "Output only. [Output Only] The information about an upcoming maintenance event.", + "readOnly": true + } + }, + "type": "object" + }, + "NodeGroupsAddNodesRequest": { + "id": "NodeGroupsAddNodesRequest", + "properties": { + "additionalNodeCount": { + "description": "Count of additional nodes to be added to the node group.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, + "NodeGroupsDeleteNodesRequest": { + "id": "NodeGroupsDeleteNodesRequest", + "properties": { + "nodes": { + "description": "Names of the nodes to delete.", + "items": { + "type": "string" }, - "response": { - "$ref": "Policy" + "type": "array" + } + }, + "type": "object" + }, + "NodeGroupsListNodes": { + "id": "NodeGroupsListNodes", + "properties": { + "id": { + "description": "Output only. [Output Only] Unique identifier for the resource; defined by the server.", + "readOnly": true, + "type": "string" + }, + "items": { + "description": "A list of Node resources.", + "items": { + "$ref": "NodeGroupNode" }, - "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." + "type": "array" + }, + "kind": { + "default": "compute#nodeGroupsListNodes", + "description": "Output only. [Output Only] The resource type, which is alwayscompute.nodeGroupsListNodes for the list of nodes in the\nspecified node group.", + "readOnly": true, + "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, + "nextPageToken": { + "description": "Output only. [Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "readOnly": true, + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "warning": { + "description": "Output only. [Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project", - "zone", - "resource" - ], - "request": { - "$ref": "TestPermissionsRequest" + "readOnly": true, + "type": "object" + } + }, + "type": "object" + }, + "NodeGroupsPerformMaintenanceRequest": { + "id": "NodeGroupsPerformMaintenanceRequest", + "properties": { + "nodes": { + "description": "[Required] List of nodes affected by the call.", + "items": { + "type": "string" }, - "response": { - "$ref": "TestPermissionsResponse" + "type": "array" + }, + "startTime": { + "description": "The start time of the schedule. The timestamp is an RFC3339 string.", + "type": "string" + } + }, + "type": "object" + }, + "NodeGroupsScopedList": { + "id": "NodeGroupsScopedList", + "properties": { + "nodeGroups": { + "description": "[Output Only] A list of node groups contained in this scope.", + "items": { + "$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 permissions that a caller has on the specified resource." + "type": "array" }, - "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", + "warning": { + "description": "[Output Only] An informational warning that appears when the nodeGroup\nlist is empty.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "pageToken": { - "description": "Specifies a page token 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{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" } }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "InstantSnapshotAggregatedList" + "type": "object" + } + }, + "type": "object" + }, + "NodeGroupsSetNodeTemplateRequest": { + "id": "NodeGroupsSetNodeTemplateRequest", + "properties": { + "nodeTemplate": { + "description": "Full or partial URL of the node template resource to be updated for this\nnode group.", + "type": "string" + } + }, + "type": "object" + }, + "NodeGroupsSimulateMaintenanceEventRequest": { + "id": "NodeGroupsSimulateMaintenanceEventRequest", + "properties": { + "nodes": { + "description": "Names of the nodes to go under maintenance simulation.", + "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 an aggregated list of instantSnapshots. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." + "type": "array" } - } + }, + "type": "object" }, - "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" - } + "NodeTemplate": { + "description": "Represent a sole-tenant Node Template resource.\n\nYou can use a template to define properties for nodes in a node group. For\nmore information, readCreating node groups\nand instances.", + "id": "NodeTemplate", + "properties": { + "accelerators": { + "items": { + "$ref": "AcceleratorConfig" }, - "parameterOrder": [ - "project", - "region" + "type": "array" + }, + "cpuOvercommitType": { + "description": "CPU overcommit.", + "enum": [ + "CPU_OVERCOMMIT_TYPE_UNSPECIFIED", + "ENABLED", + "NONE" ], - "response": { - "$ref": "InstantSnapshotList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "", + "", + "" ], - "description": "Retrieves the list of InstantSnapshot resources contained within the specified region." + "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" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-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" - ], - "response": { - "$ref": "InstantSnapshot" + "creationTimestamp": { + "description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you\ncreate the resource.", + "type": "string" + }, + "disks": { + "items": { + "$ref": "LocalDisk" }, - "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." + "type": "array" }, - "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" - } + "id": { + "description": "Output only. [Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "format": "uint64", + "readOnly": true, + "type": "string" + }, + "kind": { + "default": "compute#nodeTemplate", + "description": "Output only. [Output Only] The type of the resource. Alwayscompute#nodeTemplate for node templates.", + "readOnly": true, + "type": "string" + }, + "name": { + "description": "The name of the resource, provided by the client when initially creating\nthe resource. The resource name must be 1-63 characters long, and comply\nwithRFC1035.\nSpecifically, the name must be 1-63 characters long and match the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first\ncharacter must be a lowercase letter, and all following characters must be\na dash, lowercase letter, or digit, except the last character, which\ncannot be a dash.", + "type": "string" + }, + "nodeAffinityLabels": { + "additionalProperties": { + "type": "string" }, - "parameterOrder": [ - "project", - "region" + "description": "Labels to use for node affinity, which will be used in instance scheduling.", + "type": "object" + }, + "nodeType": { + "description": "The node type to use for nodes group that are created from this template.", + "type": "string" + }, + "nodeTypeFlexibility": { + "$ref": "NodeTemplateNodeTypeFlexibility", + "description": "Do not use. Instead, use the node_type property." + }, + "region": { + "description": "Output only. [Output Only] The name of the region where the node template resides,\nsuch as us-central1.", + "readOnly": true, + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for the resource.", + "readOnly": true, + "type": "string" + }, + "serverBinding": { + "$ref": "ServerBinding", + "description": "Sets the binding properties for the physical server. Valid values include:\n \n - *[Default]* RESTART_NODE_ON_ANY_SERVER:\n Restarts VMs on any available\n physical server\n - RESTART_NODE_ON_MINIMAL_SERVER: Restarts VMs on the same\n physical server whenever possible\n\n\n\nSee Sole-tenant\nnode options for more information." + }, + "status": { + "description": "Output only. [Output Only] The status of the node template. One of the following values:CREATING, READY, and DELETING.", + "enum": [ + "CREATING", + "DELETING", + "INVALID", + "READY" ], - "request": { - "$ref": "InstantSnapshot" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "Resources are being allocated.", + "The node template is currently being deleted.", + "Invalid status.", + "The node template is ready." ], - "description": "Creates an instant snapshot in the specified region." + "readOnly": true, + "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" + "statusMessage": { + "description": "Output only. [Output Only] An optional, human-readable explanation of the status.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "NodeTemplateAggregatedList": { + "id": "NodeTemplateAggregatedList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "additionalProperties": { + "$ref": "NodeTemplatesScopedList", + "description": "[Output Only] Name of the scope containing this set of node templates." }, - "response": { - "$ref": "Operation" + "description": "A list of NodeTemplatesScopedList resources.", + "type": "object" + }, + "kind": { + "default": "compute#nodeTemplateAggregatedList", + "description": "Output only. [Output Only] Type of resource.Alwayscompute#nodeTemplateAggregatedList for aggregated lists of\nnode templates.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "unreachables": { + "description": "Output only. [Output Only] Unreachable resources.", + "items": { + "type": "string" }, - "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." + "readOnly": true, + "type": "array" }, - "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, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. 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" } }, - "parameterOrder": [ - "project", - "region", - "instantSnapshot" - ], - "response": { - "$ref": "Operation" + "type": "object" + } + }, + "type": "object" + }, + "NodeTemplateList": { + "description": "Contains a list of node templates.", + "id": "NodeTemplateList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of NodeTemplate resources.", + "items": { + "$ref": "NodeTemplate" }, - "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." + "type": "array" }, - "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, + "kind": { + "default": "compute#nodeTemplateList", + "description": "Output only. [Output Only] Type of resource.Always compute#nodeTemplateList\nfor lists of node templates.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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" } }, - "parameterOrder": [ - "project", - "region", - "resource" - ], - "response": { - "$ref": "Policy" + "type": "object" + } + }, + "type": "object" + }, + "NodeTemplateNodeTypeFlexibility": { + "id": "NodeTemplateNodeTypeFlexibility", + "properties": { + "cpus": { + "type": "string" + }, + "localSsd": { + "type": "string" + }, + "memory": { + "type": "string" + } + }, + "type": "object" + }, + "NodeTemplatesScopedList": { + "id": "NodeTemplatesScopedList", + "properties": { + "nodeTemplates": { + "description": "[Output Only] A list of node templates contained in this scope.", + "items": { + "$ref": "NodeTemplate" }, - "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": "array" }, - "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, + "warning": { + "description": "[Output Only] An informational warning that appears when the node templates\nlist is empty.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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" } }, - "parameterOrder": [ - "project", - "region", - "resource" - ], - "request": { - "$ref": "RegionSetPolicyRequest" + "type": "object" + } + }, + "type": "object" + }, + "NodeType": { + "description": "Represent a sole-tenant Node Type resource.\n\nEach node within a node group must have a node type. A node type specifies\nthe total amount of cores and memory for that node. Currently, the only\navailable node type is n1-node-96-624 node type that has 96\nvCPUs and 624 GB of memory, available in multiple zones. For more information\nreadNode types.", + "id": "NodeType", + "properties": { + "cpuPlatform": { + "description": "[Output Only] The CPU platform used by this node type.", + "type": "string" + }, + "creationTimestamp": { + "description": "[Output Only] Creation timestamp inRFC3339\ntext format.", + "type": "string" + }, + "deprecated": { + "$ref": "DeprecationStatus", + "description": "[Output Only] The deprecation status associated with this node type." + }, + "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 node\ntype.", + "format": "int32", + "type": "integer" + }, + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "format": "uint64", + "type": "string" + }, + "kind": { + "default": "compute#nodeType", + "description": "Output only. [Output Only] The type of the resource. Alwayscompute#nodeType for node types.", + "readOnly": true, + "type": "string" + }, + "localSsdGb": { + "description": "[Output Only] Local SSD available to the node type, defined in GB.", + "format": "int32", + "type": "integer" + }, + "maxVms": { + "description": "Output only. [Output Only] Maximum number of VMs that can be created for this node type.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "memoryMb": { + "description": "[Output Only] The amount of physical memory available to the node type,\ndefined in MB.", + "format": "int32", + "type": "integer" + }, + "name": { + "description": "[Output Only] Name of the resource.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for the resource.", + "readOnly": true, + "type": "string" + }, + "zone": { + "description": "Output only. [Output Only] The name of the zone where the node type resides,\nsuch as us-central1-a.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "NodeTypeAggregatedList": { + "id": "NodeTypeAggregatedList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "additionalProperties": { + "$ref": "NodeTypesScopedList", + "description": "[Output Only] Name of the scope containing this set of node types." }, - "response": { - "$ref": "Policy" + "description": "A list of NodeTypesScopedList resources.", + "type": "object" + }, + "kind": { + "default": "compute#nodeTypeAggregatedList", + "description": "Output only. [Output Only] Type of resource.Alwayscompute#nodeTypeAggregatedList for aggregated lists of node\ntypes.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "unreachables": { + "description": "Output only. [Output Only] Unreachable resources.", + "items": { + "type": "string" }, - "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." + "readOnly": true, + "type": "array" }, - "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, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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" } }, - "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." + "type": "object" } - } + }, + "type": "object" }, - "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", + "NodeTypeList": { + "description": "Contains a list of node types.", + "id": "NodeTypeList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of NodeType resources.", + "items": { + "$ref": "NodeType" + }, + "type": "array" + }, + "kind": { + "default": "compute#nodeTypeList", + "description": "Output only. [Output Only] Type of resource.Always compute#nodeTypeList for\nlists of node types.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "pageToken": { - "description": "Specifies a page token 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{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" } }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "InterconnectLocationList" + "type": "object" + } + }, + "type": "object" + }, + "NodeTypesScopedList": { + "id": "NodeTypesScopedList", + "properties": { + "nodeTypes": { + "description": "[Output Only] A list of node types contained in this scope.", + "items": { + "$ref": "NodeType" }, - "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." + "type": "array" }, - "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, + "warning": { + "description": "[Output Only] An informational warning that appears when the node types\nlist is empty.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, + "data": { + "description": "[Output Only] Metadata about this warning in key:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" + }, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "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." + "type": "object" } - } + }, + "type": "object" }, - "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" - } + "NotificationEndpoint": { + "description": "Represents a notification endpoint.\n\nA notification endpoint resource defines an endpoint to receive notifications\nwhen there are status changes detected by the associated health check\nservice.\n\nFor more information, see\nHealth checks overview.", + "id": "NotificationEndpoint", + "properties": { + "creationTimestamp": { + "description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you\ncreate the resource.", + "type": "string" + }, + "grpcSettings": { + "$ref": "NotificationEndpointGrpcSettings", + "description": "Settings of the gRPC notification endpoint including the endpoint URL and\nthe retry duration." + }, + "id": { + "description": "Output only. [Output Only] A unique identifier for this resource type. The server\ngenerates this identifier.", + "format": "uint64", + "readOnly": true, + "type": "string" + }, + "kind": { + "default": "compute#notificationEndpoint", + "description": "Output only. [Output Only] Type of the resource. Alwayscompute#notificationEndpoint for notification endpoints.", + "readOnly": true, + "type": "string" + }, + "name": { + "description": "Name of the resource. Provided by the client when the resource is created.\nThe name must be 1-63 characters long, and comply withRFC1035.\nSpecifically, the name must be 1-63 characters long and match the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first\ncharacter must be a lowercase letter, and all following characters must\nbe a dash, lowercase letter, or digit, except the last character, which\ncannot be a dash.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "region": { + "description": "Output only. [Output Only] URL of the region where the notification endpoint resides.\nThis field applies only to the regional resource. You must specify this\nfield as part of the HTTP request URL. It is not settable as a field in\nthe request body.", + "readOnly": true, + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for the resource.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "NotificationEndpointAggregatedList": { + "description": "Contains a list of NotificationEndpointsScopedList.", + "id": "NotificationEndpointAggregatedList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "additionalProperties": { + "$ref": "NotificationEndpointsScopedList", + "description": "Name of the scope containing this set of NotificationEndpoints." }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "InterconnectRemoteLocationList" + "description": "A list of NotificationEndpointsScopedList resources.", + "type": "object" + }, + "kind": { + "default": "compute#notificationEndpointAggregatedList", + "description": "Output only. Type of resource.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "unreachables": { + "description": "Output only. [Output Only] Unreachable resources.", + "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 the list of interconnect remote locations available to the specified project." + "readOnly": true, + "type": "array" }, - "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, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, + "data": { + "description": "[Output Only] Metadata about this warning in key:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" + }, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "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." + "type": "object" } - } + }, + "type": "object" }, - "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, + "NotificationEndpointGrpcSettings": { + "description": "Represents a gRPC setting that describes one gRPC notification endpoint and\nthe retry duration attempting to send notification to this endpoint.", + "id": "NotificationEndpointGrpcSettings", + "properties": { + "authority": { + "description": "Optional. If specified, this field is used to set the authority header by\nthe sender of notifications. See\nhttps://tools.ietf.org/html/rfc7540#section-8.1.2.3", + "type": "string" + }, + "endpoint": { + "description": "Endpoint to which gRPC notifications are sent. This must be a valid\ngRPCLB DNS name.", + "type": "string" + }, + "payloadName": { + "description": "Optional. If specified, this field is used to populate the \"name\" field\nin gRPC requests.", + "type": "string" + }, + "resendInterval": { + "$ref": "Duration", + "description": "Optional. This field is used to configure how often to send a full update\nof all non-healthy backends. If unspecified, full updates are not sent.\nIf specified, must be in the range between 600 seconds to 3600 seconds.\nNanos are disallowed. Can only be set for regional notification\nendpoints." + }, + "retryDurationSec": { + "description": "How much time (in seconds) is spent attempting notification retries\nuntil a successful response is received. Default is 30s. Limit is 20m\n(1200s). Must be a positive number.", + "format": "uint32", + "type": "integer" + } + }, + "type": "object" + }, + "NotificationEndpointList": { + "id": "NotificationEndpointList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of NotificationEndpoint resources.", + "items": { + "$ref": "NotificationEndpoint" + }, + "type": "array" + }, + "kind": { + "default": "compute#notificationEndpointList", + "description": "Output only. [Output Only] Type of the resource. Alwayscompute#notificationEndpoint for notification endpoints.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue 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.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, + "data": { + "description": "[Output Only] Metadata about this warning in key:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" + }, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project", - "licenseCode" - ], - "response": { - "$ref": "LicenseCode" + "type": "object" + } + }, + "type": "object" + }, + "NotificationEndpointsScopedList": { + "id": "NotificationEndpointsScopedList", + "properties": { + "resources": { + "description": "A list of NotificationEndpoints contained in this scope.", + "items": { + "$ref": "NotificationEndpoint" }, - "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. " + "type": "array" }, - "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, + "warning": { + "description": "Informational warning which replaces the list of\nnotification endpoints when the list is empty.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" + }, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "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. " + "type": "object" } - } + }, + "type": "object" }, - "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" + "Operation": { + "description": "Represents an Operation resource.\n\nGoogle Compute Engine has three Operation resources:\n\n* [Global](/compute/docs/reference/rest/v1/globalOperations)\n* [Regional](/compute/docs/reference/rest/v1/regionOperations)\n* [Zonal](/compute/docs/reference/rest/v1/zoneOperations)\n\nYou can use an operation resource to manage asynchronous API requests.\nFor more information, readHandling\nAPI responses.\n\nOperations can be global, regional or zonal.\n \n - For global operations, use the `globalOperations`\n resource. \n - For regional operations, use the\n `regionOperations` resource. \n - For zonal operations, use\n the `zoneOperations` resource.\n\n\n\nFor more information, read\nGlobal, Regional, and Zonal Resources.\n\nNote that completed Operation resources have a limited \nretention period.", + "id": "Operation", + "properties": { + "clientOperationId": { + "description": "[Output Only] The value of `requestId` if you provided it in the request.\nNot present otherwise.", + "type": "string" + }, + "creationTimestamp": { + "description": "[Deprecated] This field is deprecated.", + "type": "string" + }, + "description": { + "description": "[Output Only] A textual description of the operation, which is\nset when the operation is created.", + "type": "string" + }, + "endTime": { + "description": "[Output Only] The time that this operation was completed. This value is inRFC3339\ntext format.", + "type": "string" + }, + "error": { + "description": "[Output Only] If errors are generated during processing of the operation,\nthis field will be populated.", + "properties": { + "errors": { + "description": "[Output Only] The array of errors encountered while processing this\noperation.", + "items": { + "description": "Represents a single error encountered during the processing of an\noperation.", + "properties": { + "code": { + "description": "[Output Only] The error type identifier for this error.", + "type": "string" + }, + "errorDetails": { + "description": "[Output Only] An optional list of messages that contain the error\ndetails. There is a set of defined message types to use for providing\ndetails.The syntax depends on the error code. For example,\nQuotaExceededInfo will have details when the error code is\nQUOTA_EXCEEDED.", + "items": { + "description": "Container for structured error details providing additional context\nspecific to the encountered error code.", + "properties": { + "errorInfo": { + "$ref": "ErrorInfo", + "description": "Error information containing structured domain, reason, and metadata." + }, + "help": { + "$ref": "Help", + "description": "Links and information to help the user resolve the error." + }, + "localizedMessage": { + "$ref": "LocalizedMessage", + "description": "A localized human-readable error message intended for end users." + }, + "quotaInfo": { + "$ref": "QuotaExceededInfo", + "description": "Details about quota limits and metrics when a quota is exceeded." + } + }, + "type": "object" + }, + "type": "array" + }, + "location": { + "description": "[Output Only] Indicates the field in the request that caused the error.\nThis property is optional.", + "type": "string" + }, + "message": { + "description": "[Output Only] An optional, human-readable error message.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" } }, - "parameterOrder": [ - "project", - "license" + "type": "object" + }, + "getVersionOperationMetadata": { + "$ref": "GetVersionOperationMetadata" + }, + "httpErrorMessage": { + "description": "[Output Only] If the operation fails, this field contains the HTTP error\nmessage that was returned, such as `NOT FOUND`.", + "type": "string" + }, + "httpErrorStatusCode": { + "description": "[Output Only] If the operation fails, this field contains the HTTP error\nstatus code that was returned. For example, a `404` means the\nresource was not found.", + "format": "int32", + "type": "integer" + }, + "id": { + "description": "[Output Only] The unique identifier for the operation. This identifier is\ndefined by the server.", + "format": "uint64", + "type": "string" + }, + "insertTime": { + "description": "[Output Only] The time that this operation was requested.\nThis value is inRFC3339\ntext format.", + "type": "string" + }, + "instancesBulkInsertOperationMetadata": { + "$ref": "InstancesBulkInsertOperationMetadata" + }, + "kind": { + "default": "compute#operation", + "description": "Output only. [Output Only] Type of the resource. Always `compute#operation` for\nOperation resources.", + "readOnly": true, + "type": "string" + }, + "name": { + "description": "[Output Only] Name of the operation.", + "type": "string" + }, + "operationGroupId": { + "description": "Output only. [Output Only] An ID that represents a group of operations, such as when a\ngroup of operations results from a `bulkInsert` API request.", + "readOnly": true, + "type": "string" + }, + "operationType": { + "description": "[Output Only] The type of operation, such as `insert`,\n`update`, or `delete`, and so on.", + "type": "string" + }, + "progress": { + "description": "[Output Only] An optional progress indicator that ranges from 0 to 100.\nThere is no requirement that this be linear or support any granularity of\noperations. This should not be used to guess when the operation will be\ncomplete. This number should monotonically increase as the operation\nprogresses.", + "format": "int32", + "type": "integer" + }, + "region": { + "description": "[Output Only] The URL of the region where the operation resides. Only\napplicable when performing regional operations.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" + }, + "setCommonInstanceMetadataOperationMetadata": { + "$ref": "SetCommonInstanceMetadataOperationMetadata", + "description": "Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,\nthis field will contain information on all underlying zonal actions and\ntheir state.", + "readOnly": true + }, + "startTime": { + "description": "[Output Only] The time that this operation was started by the server.\nThis value is inRFC3339\ntext format.", + "type": "string" + }, + "status": { + "description": "[Output Only] The status of the operation, which can be one of the\nfollowing:\n`PENDING`, `RUNNING`, or `DONE`.", + "enum": [ + "DONE", + "PENDING", + "RUNNING" ], - "response": { - "$ref": "License" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "The operation has completed processing successfully or with an error.", + "The operation is waiting to be processed.", + "The operation is actively being processed." ], - "description": "Returns the specified License resource. *Caution* This resource is intended for use only by third-party partners who are creating Cloud Marketplace images. " + "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" + "statusMessage": { + "description": "[Output Only] An optional textual description of the current status of the\noperation.", + "type": "string" + }, + "targetId": { + "description": "[Output Only] The unique target ID, which identifies a specific incarnation\nof the target resource.", + "format": "uint64", + "type": "string" + }, + "targetLink": { + "description": "[Output Only] The URL of the resource that the operation modifies. For\noperations related to creating a snapshot, this points to the disk\nthat the snapshot was created from.", + "type": "string" + }, + "user": { + "description": "[Output Only] User who requested the operation, for example:\n`user@example.com` or\n`alice_smith_identifier (global/workforcePools/example-com-us-employees)`.", + "type": "string" + }, + "warnings": { + "description": "[Output Only] If warning messages are generated during processing of the\noperation, this field will be populated.", + "items": { + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "type": "string" + }, + "data": { + "description": "[Output Only] Metadata about this warning in key:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" + }, + "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" - } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "LicensesListResponse" + "type": "object" }, - "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. " + "type": "array" }, - "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" - } + "zone": { + "description": "[Output Only] The URL of the zone where the operation resides. Only\napplicable when performing per-zone operations.", + "type": "string" + } + }, + "type": "object" + }, + "OperationAggregatedList": { + "id": "OperationAggregatedList", + "properties": { + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "type": "string" + }, + "items": { + "additionalProperties": { + "$ref": "OperationsScopedList", + "description": "[Output Only] Name of the scope containing this set of operations." }, - "parameterOrder": [ - "project", - "license" - ], - "response": { - "$ref": "Operation" + "description": "[Output Only] A map of scoped operation lists.", + "type": "object" + }, + "kind": { + "default": "compute#operationAggregatedList", + "description": "Output only. [Output Only] Type of resource. Always `compute#operationAggregatedList`\nfor aggregated lists of operations.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger than\n`maxResults`, use the `nextPageToken` as a value for\nthe query parameter `pageToken` in the next list request.\nSubsequent list requests will have their own `nextPageToken` to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "unreachables": { + "description": "Output only. [Output Only] Unreachable resources.", + "items": { + "type": "string" }, - "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. " + "readOnly": true, + "type": "array" }, - "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, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", + "data": { + "description": "[Output Only] Metadata about this warning in key:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" + }, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project" - ], - "request": { - "$ref": "License" - }, - "response": { + "type": "object" + } + }, + "type": "object" + }, + "OperationList": { + "description": "Contains a list of Operation resources.", + "id": "OperationList", + "properties": { + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "type": "string" + }, + "items": { + "description": "[Output Only] A list of Operation resources.", + "items": { "$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. " + "type": "array" }, - "update": { - "id": "compute.licenses.update", - "path": "projects/{project}/global/licenses/{license}", - "flatPath": "projects/{project}/global/licenses/{license}", - "httpMethod": "PATCH", - "parameters": { - "license": { - "description": "The license 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, + "kind": { + "default": "compute#operationList", + "description": "Output only. [Output Only] Type of resource. Always `compute#operations` for Operations\nresource.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger than\n`maxResults`, use the `nextPageToken` as a value for\nthe query parameter `pageToken` in the next list request.\nSubsequent list requests will have their own `nextPageToken` to\ncontinue 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.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. 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" - }, - "updateMask": { - "description": "update_mask indicates fields to be updated as part of this request.", - "location": "query", - "type": "string", - "format": "google-fieldmask" } }, - "parameterOrder": [ - "project", - "license" - ], - "request": { - "$ref": "License" - }, - "response": { + "type": "object" + } + }, + "type": "object" + }, + "OperationsScopedList": { + "id": "OperationsScopedList", + "properties": { + "operations": { + "description": "[Output Only] A list of operations contained in this scope.", + "items": { "$ref": "Operation" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Updates 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. " + "type": "array" }, - "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, + "warning": { + "description": "[Output Only] Informational warning which replaces the list of operations\nwhen the list is empty.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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" + "data": { + "description": "[Output Only] Metadata about this warning in key:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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" } }, - "parameterOrder": [ - "project", - "resource" - ], - "request": { - "$ref": "GlobalSetPolicyRequest" - }, - "response": { - "$ref": "Policy" + "type": "object" + } + }, + "type": "object" + }, + "OrganizationSecurityPoliciesListAssociationsResponse": { + "id": "OrganizationSecurityPoliciesListAssociationsResponse", + "properties": { + "associations": { + "description": "A list of associations.", + "items": { + "$ref": "SecurityPolicyAssociation" }, - "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. " + "type": "array" }, - "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. " + "kind": { + "default": "compute#organizationSecurityPoliciesListAssociationsResponse", + "description": "Output only. [Output Only] Type of securityPolicy associations. Alwayscompute#organizationSecurityPoliciesListAssociations for lists\nof securityPolicy associations.", + "readOnly": true, + "type": "string" } - } + }, + "type": "object" }, - "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" + "OutlierDetection": { + "description": "Settings controlling the eviction of unhealthy hosts from the load balancing\npool for the backend service.", + "id": "OutlierDetection", + "properties": { + "baseEjectionTime": { + "$ref": "Duration", + "description": "The base time that a backend endpoint is ejected for. Defaults to 30000ms\nor 30s.\n\nAfter a backend endpoint is returned back to the load balancing pool, it\ncan be ejected again in another ejection analysis. Thus, the total ejection\ntime is equal to the base ejection time multiplied by the number of times\nthe backend endpoint has been ejected. Defaults to 30000ms or 30s." + }, + "consecutiveErrors": { + "description": "Number of consecutive errors before a backend endpoint is ejected from the\nload balancing pool. When the backend endpoint is accessed over HTTP, a 5xx\nreturn code qualifies as an error. Defaults to 5.", + "format": "int32", + "type": "integer" + }, + "consecutiveGatewayFailure": { + "description": "The number of consecutive gateway failures (502, 503, 504 status or\nconnection errors that are mapped to one of those status codes) before a\nconsecutive gateway failure ejection occurs. Defaults to 3.", + "format": "int32", + "type": "integer" + }, + "enforcingConsecutiveErrors": { + "description": "The percentage chance that a backend endpoint will be ejected when an\noutlier status is detected through consecutive 5xx. This setting can be\nused to disable ejection or to ramp it up slowly. Defaults to 0.", + "format": "int32", + "type": "integer" + }, + "enforcingConsecutiveGatewayFailure": { + "description": "The percentage chance that a backend endpoint will be ejected when an\noutlier status is detected through consecutive gateway failures. This\nsetting can be used to disable ejection or to ramp it up slowly. Defaults\nto 100.", + "format": "int32", + "type": "integer" + }, + "enforcingSuccessRate": { + "description": "The percentage chance that a backend endpoint will be ejected when an\noutlier status is detected through success rate statistics. This setting\ncan be used to disable ejection or to ramp it up slowly. Defaults to 100.\n\nNot supported when the backend service uses Serverless NEG.", + "format": "int32", + "type": "integer" + }, + "interval": { + "$ref": "Duration", + "description": "Time interval between ejection analysis sweeps. This can result in both new\nejections and backend endpoints being returned to service. The interval is\nequal to the number of seconds as defined in\noutlierDetection.interval.seconds plus the number of nanoseconds as defined\nin outlierDetection.interval.nanos. Defaults to 1 second." + }, + "maxEjectionPercent": { + "description": "Maximum percentage of backend endpoints in the load balancing pool for the\nbackend service that can be ejected if the ejection conditions are met.\nDefaults to 50%.", + "format": "int32", + "type": "integer" + }, + "successRateMinimumHosts": { + "description": "The number of backend endpoints in the load balancing pool that must have\nenough request volume to detect success rate outliers. If the number of\nbackend endpoints is fewer than this setting, outlier detection via success\nrate statistics is not performed for any backend endpoint in the load\nbalancing pool. Defaults to 5.\n\nNot supported when the backend service uses Serverless NEG.", + "format": "int32", + "type": "integer" + }, + "successRateRequestVolume": { + "description": "The minimum number of total requests that must be collected in one interval\n(as defined by the interval duration above) to include this backend\nendpoint in success rate based outlier detection. If the volume is lower\nthan this setting, outlier detection via success rate statistics is not\nperformed for that backend endpoint. Defaults to 100.\n\nNot supported when the backend service uses Serverless NEG.", + "format": "int32", + "type": "integer" + }, + "successRateStdevFactor": { + "description": "This factor is used to determine the ejection threshold for success rate\noutlier ejection. The ejection threshold is the difference between the mean\nsuccess rate, and the product of this factor and the standard deviation of\nthe mean success rate: mean - (stdev * successRateStdevFactor). This factor\nis divided by a thousand to get a double. That is, if the desired factor\nis 1.9, the runtime value should be 1900. Defaults to 1900.\n\nNot supported when the backend service uses Serverless NEG.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, + "PacketIntervals": { + "description": "Next free: 7", + "id": "PacketIntervals", + "properties": { + "avgMs": { + "description": "Average observed inter-packet interval in milliseconds.", + "format": "int64", + "type": "string" + }, + "duration": { + "description": "From how long ago in the past these intervals were observed.", + "enum": [ + "DURATION_UNSPECIFIED", + "HOUR", + "MAX", + "MINUTE" ], - "response": { - "$ref": "MachineImageList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "", + "", + "From BfdSession object creation time.", + "" ], - "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" + "maxMs": { + "description": "Maximum observed inter-packet interval in milliseconds.", + "format": "int64", + "type": "string" + }, + "minMs": { + "description": "Minimum observed inter-packet interval in milliseconds.", + "format": "int64", + "type": "string" + }, + "numIntervals": { + "description": "Number of inter-packet intervals from which these statistics were derived.", + "format": "int64", + "type": "string" + }, + "type": { + "description": "The type of packets for which inter-packet intervals were computed.", + "enum": [ + "LOOPBACK", + "RECEIVE", + "TRANSMIT", + "TYPE_UNSPECIFIED" ], - "response": { - "$ref": "MachineImage" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "Only applies to Echo packets. This shows the intervals between sending\nand receiving the same packet.", + "Intervals between received packets.", + "Intervals between transmitted packets.", + "" ], - "description": "Returns the specified machine image." + "type": "string" + } + }, + "type": "object" + }, + "PacketMirroring": { + "description": "Represents a Packet Mirroring resource.\n\nPacket Mirroring clones the traffic of specified instances in your Virtual\nPrivate Cloud (VPC) network and forwards it to a collector destination,\nsuch as an instance group of an internal TCP/UDP load balancer, for analysis\nor examination.\nFor more information about setting up Packet Mirroring, seeUsing Packet Mirroring.", + "id": "PacketMirroring", + "properties": { + "collectorIlb": { + "$ref": "PacketMirroringForwardingRuleInfo", + "description": "The Forwarding Rule resource of typeloadBalancingScheme=INTERNAL that will be used as collector\nfor mirrored traffic.\nThe specified forwarding rule must have isMirroringCollector\nset to true." }, - "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" + "creationTimestamp": { + "description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you\ncreate the resource.", + "type": "string" + }, + "enable": { + "description": "Indicates whether or not this packet mirroring takes effect.\nIf set to FALSE, this packet mirroring policy will not be enforced on the\nnetwork.\n\nThe default is TRUE.", + "enum": [ + "FALSE", + "TRUE" ], - "request": { - "$ref": "MachineImage" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "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." + "type": "string" }, - "setLabels": { - "id": "compute.machineImages.setLabels", - "path": "projects/{project}/global/machineImages/{resource}/setLabels", - "flatPath": "projects/{project}/global/machineImages/{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" - } + "filter": { + "$ref": "PacketMirroringFilter", + "description": "Filter for mirrored traffic. If unspecified, all IPv4 traffic is mirrored." + }, + "id": { + "description": "Output only. [Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "format": "uint64", + "readOnly": true, + "type": "string" + }, + "kind": { + "default": "compute#packetMirroring", + "description": "Output only. [Output Only] Type of the resource. Alwayscompute#packetMirroring for packet mirrorings.", + "readOnly": true, + "type": "string" + }, + "mirroredResources": { + "$ref": "PacketMirroringMirroredResourceInfo", + "description": "PacketMirroring mirroredResourceInfos.\nMirroredResourceInfo specifies a set of mirrored VM instances, subnetworks\nand/or tags for which traffic from/to all VM instances will be mirrored." + }, + "name": { + "annotations": { + "required": [ + "compute.packetMirrorings.insert" + ] }, - "parameterOrder": [ - "project", - "resource" - ], - "request": { - "$ref": "GlobalSetLabelsRequest" + "description": "Name of the resource; provided by the client when the resource is created.\nThe name must be 1-63 characters long, and comply withRFC1035.\nSpecifically, the name must be 1-63 characters long and match the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first\ncharacter must be a lowercase letter, and all following characters must be\na dash, lowercase letter, or digit, except the last character, which cannot\nbe a dash.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "network": { + "$ref": "PacketMirroringNetworkInfo", + "annotations": { + "required": [ + "compute.packetMirrorings.insert" + ] }, - "response": { - "$ref": "Operation" + "description": "Specifies the mirrored VPC network. Only packets in this network will be\nmirrored. All mirrored VMs should have a NIC in the given network.\nAll mirrored subnetworks should belong to the given network." + }, + "priority": { + "description": "The priority of applying this configuration. Priority is used to break ties\nin cases where there is more than one matching rule. In the case of two\nrules that apply for a given Instance, the one with the lowest-numbered\npriority value wins.\n\nDefault value is 1000. Valid range is 0 through 65535.", + "format": "uint32", + "type": "integer" + }, + "region": { + "description": "[Output Only] URI of the region where the packetMirroring resides.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for the resource.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "PacketMirroringAggregatedList": { + "description": "Contains a list of packetMirrorings.", + "id": "PacketMirroringAggregatedList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "additionalProperties": { + "$ref": "PacketMirroringsScopedList", + "description": "Name of the scope containing this set of packetMirrorings." }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Sets the labels on a machine image. To learn more about labels, read the Labeling Resources documentation." + "description": "A list of PacketMirroring resources.", + "type": "object" }, - "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, + "kind": { + "default": "compute#packetMirroringAggregatedList", + "description": "Output only. Type of resource.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "unreachables": { + "description": "Output only. [Output Only] Unreachable resources.", + "items": { + "type": "string" + }, + "readOnly": true, + "type": "array" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. 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" } }, - "parameterOrder": [ - "project", - "machineImage" - ], - "response": { - "$ref": "Operation" + "type": "object" + } + }, + "type": "object" + }, + "PacketMirroringFilter": { + "id": "PacketMirroringFilter", + "properties": { + "IPProtocols": { + "description": "Protocols that apply as filter on mirrored traffic.\nIf no protocols are specified, all traffic that matches the specified\nCIDR ranges is mirrored.\nIf neither cidrRanges nor IPProtocols is specified, all IPv4 traffic is\nmirrored.", + "items": { + "type": "string" }, - "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." + "type": "array" }, - "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" - } + "cidrRanges": { + "description": "One or more IPv4 or IPv6 CIDR ranges that apply as filters on the source\n(ingress) or destination (egress) IP in the IP header. If no ranges are\nspecified, all IPv4 traffic that matches the specified IPProtocols is\nmirrored. If neither cidrRanges nor IPProtocols is specified, all IPv4\ntraffic is mirrored. To mirror all IPv4 and IPv6 traffic, use\n\"0.0.0.0/0,::/0\".", + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "resource" + "type": "array" + }, + "direction": { + "description": "Direction of traffic to mirror, either INGRESS, EGRESS, or BOTH.\nThe default is BOTH.", + "enum": [ + "BOTH", + "EGRESS", + "INGRESS" ], - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "Default, both directions are mirrored.", + "Only egress traffic is mirrored.", + "Only ingress traffic is mirrored." ], - "description": "Gets the access control policy for a resource. May be empty if no such policy or resource exists." + "type": "string" + } + }, + "type": "object" + }, + "PacketMirroringForwardingRuleInfo": { + "id": "PacketMirroringForwardingRuleInfo", + "properties": { + "canonicalUrl": { + "description": "Output only. [Output Only] Unique identifier for the forwarding rule; defined by the\nserver.", + "readOnly": true, + "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" + "url": { + "description": "Resource URL to the forwarding rule representing the ILB\nconfigured as destination of the mirrored traffic.", + "type": "string" + } + }, + "type": "object" + }, + "PacketMirroringList": { + "description": "Contains a list of PacketMirroring resources.", + "id": "PacketMirroringList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of PacketMirroring resources.", + "items": { + "$ref": "PacketMirroring" }, - "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." + "type": "array" }, - "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, + "kind": { + "default": "compute#packetMirroringList", + "description": "Output only. [Output Only] Type of resource. Always compute#packetMirroring\nfor packetMirrorings.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" + }, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "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." + "type": "object" } - } + }, + "type": "object" }, - "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" - } + "PacketMirroringMirroredResourceInfo": { + "id": "PacketMirroringMirroredResourceInfo", + "properties": { + "instances": { + "description": "A set of virtual machine instances that are being mirrored.\nThey must live in zones contained in the same region as this\npacketMirroring.\n\nNote that this config will apply only to those network interfaces of the\nInstances that belong to the network specified in this packetMirroring.\n\nYou may specify a maximum of 50 Instances.", + "items": { + "$ref": "PacketMirroringMirroredResourceInfoInstanceInfo" }, - "parameterOrder": [ - "project", - "zone" - ], - "response": { - "$ref": "MachineTypeList" + "type": "array" + }, + "subnetworks": { + "description": "A set of subnetworks for which traffic from/to all VM instances will be\nmirrored. They must live in the same region as this packetMirroring.\n\nYou may specify a maximum of 5 subnetworks.", + "items": { + "$ref": "PacketMirroringMirroredResourceInfoSubnetInfo" }, - "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." + "type": "array" }, - "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" - } + "tags": { + "description": "A set of mirrored tags. Traffic from/to all VM instances that have one or\nmore of these tags will be mirrored.", + "items": { + "type": "string" }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "MachineTypeAggregatedList" + "type": "array" + } + }, + "type": "object" + }, + "PacketMirroringMirroredResourceInfoInstanceInfo": { + "id": "PacketMirroringMirroredResourceInfoInstanceInfo", + "properties": { + "canonicalUrl": { + "description": "Output only. [Output Only] Unique identifier for the instance; defined by the\nserver.", + "readOnly": true, + "type": "string" + }, + "url": { + "description": "Resource URL to the virtual machine instance which is being mirrored.", + "type": "string" + } + }, + "type": "object" + }, + "PacketMirroringMirroredResourceInfoSubnetInfo": { + "id": "PacketMirroringMirroredResourceInfoSubnetInfo", + "properties": { + "canonicalUrl": { + "description": "Output only. [Output Only] Unique identifier for the subnetwork; defined by the\nserver.", + "readOnly": true, + "type": "string" + }, + "url": { + "description": "Resource URL to the subnetwork for which\ntraffic from/to all VM instances will be mirrored.", + "type": "string" + } + }, + "type": "object" + }, + "PacketMirroringNetworkInfo": { + "id": "PacketMirroringNetworkInfo", + "properties": { + "canonicalUrl": { + "description": "Output only. [Output Only] Unique identifier for the network; defined by the server.", + "readOnly": true, + "type": "string" + }, + "url": { + "description": "URL of the network resource.", + "type": "string" + } + }, + "type": "object" + }, + "PacketMirroringsScopedList": { + "id": "PacketMirroringsScopedList", + "properties": { + "packetMirrorings": { + "description": "A list of packetMirrorings contained in this scope.", + "items": { + "$ref": "PacketMirroring" }, - "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`." + "type": "array" }, - "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, + "warning": { + "description": "Informational warning which replaces the list of packetMirrorings when the\nlist is empty.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "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" - ], - "description": "Returns the specified machine type." + "type": "object" } - } + }, + "type": "object" }, - "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" - } + "PathMatcher": { + "description": "A matcher for the path portion of the URL. The BackendService\nfrom the longest-matched rule will serve the URL. If no rule was matched, the\ndefault service is used.", + "id": "PathMatcher", + "properties": { + "defaultCustomErrorResponsePolicy": { + "$ref": "CustomErrorResponsePolicy", + "description": "defaultCustomErrorResponsePolicy specifies how the Load\nBalancer returns error responses when BackendServiceorBackendBucket responds with an error. \n\nThis policy takes\neffect at the PathMatcher level and applies only when no\npolicy has been defined for the error code at lower levels likeRouteRule and PathRule within thisPathMatcher. If an error code does not have a policy defined\nin defaultCustomErrorResponsePolicy, then a policy defined for\nthe error code in UrlMap.defaultCustomErrorResponsePolicy\ntakes effect. \n\nFor example, consider a UrlMap with the following\nconfiguration:\n \n \n - UrlMap.defaultCustomErrorResponsePolicy is configured\n with policies for 5xx and 4xx errors\n - A RouteRule for /coming_soon/ is configured for the\n error code 404.\n\nIf the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher's policy\ntakes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,\nthe policy in RouteRule.customErrorResponsePolicy takes\neffect. If any of the requests in this example encounter a 500\nerror code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect. \n\nWhen\nused in conjunction withpathMatcher.defaultRouteAction.retryPolicy, retries take\nprecedence. Only once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting\na retry, if load balancer is successful in reaching the\nservice, the defaultCustomErrorResponsePolicy is ignored and\nthe response from the service is returned to the client.\n\ndefaultCustomErrorResponsePolicy is supported only for\nglobal external Application Load Balancers." + }, + "defaultRouteAction": { + "$ref": "HttpRouteAction", + "description": "defaultRouteAction takes effect when none of the \npathRules or routeRules match. The load balancer\nperforms advanced routing actions, such as URL rewrites and\nheader transformations, before forwarding the request to the\nselected backend.\n\n\nOnly one of defaultUrlRedirect, defaultService\nor defaultRouteAction.weightedBackendService can be set.\n\n\nURL maps for classic Application Load Balancers only support\nthe urlRewrite action within a path matcher'sdefaultRouteAction." + }, + "defaultService": { + "description": "The full or partial URL to the BackendService resource. This\nURL is used if none of the pathRules orrouteRules defined by this PathMatcher are\nmatched. For example, the\nfollowing are all valid URLs to a BackendService resource:\n \n \n - https://www.googleapis.com/compute/v1/projects/project/global/backendServices/backendService\n - compute/v1/projects/project/global/backendServices/backendService\n - global/backendServices/backendService\n\n\nIf defaultRouteAction is also specified, advanced\nrouting actions, such as URL rewrites, take effect before sending the\nrequest to the backend.\n\n\nOnly one of defaultUrlRedirect, defaultService\nor defaultRouteAction.weightedBackendService can be set.\n\n\nAuthorization requires one or more of the following Google IAM permissions on the\nspecified resource default_service: \n \n \n - compute.backendBuckets.use\n - compute.backendServices.use", + "type": "string" + }, + "defaultUrlRedirect": { + "$ref": "HttpRedirectAction", + "description": "When none of the specified pathRules orrouteRules match, the request is redirected to a URL specified\nby defaultUrlRedirect.\n\n\nOnly one of defaultUrlRedirect, defaultService\nor defaultRouteAction.weightedBackendService can be set.\n\n\nNot supported when the URL map is bound to a target gRPC proxy." + }, + "description": { + "description": "An optional description of this resource. Provide this property when you\ncreate the resource.", + "type": "string" + }, + "headerAction": { + "$ref": "HttpHeaderAction", + "description": "Specifies changes to request and response headers that need to take effect\nfor the selected backend service.\n\nHeaderAction specified here are applied after the matchingHttpRouteRule HeaderAction and before theHeaderAction in the UrlMap\n\nHeaderAction is not supported for load balancers\nthat have\ntheir loadBalancingScheme set to EXTERNAL.\n\nNot supported when the URL map is bound to a target gRPC proxy that\nhas validateForProxyless field set to true." + }, + "name": { + "description": "The name to which this PathMatcher is referred by theHostRule.", + "type": "string" + }, + "pathRules": { + "description": "The list of path rules. Use this list instead of routeRules\nwhen routing based on simple path matching is all that's required. A path\nrule can only include a wildcard character (*) after a\nforward slash character (\"/\").\n\nThe order by which path rules are specified does not matter.\nMatches are always done on the longest-path-first basis.\n\nFor example: a pathRule with a path /a/b/c/* will match\nbefore /a/b/* irrespective of the order in which those paths appear in this\nlist.\n\nWithin a given pathMatcher, only one ofpathRules or routeRules must be set.", + "items": { + "$ref": "PathRule" }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "NetworkAttachmentAggregatedList" + "type": "array" + }, + "routeRules": { + "description": "The list of HTTP route rules. Use this list instead ofpathRules when advanced route matching and routing actions are\ndesired. routeRules are evaluated in order of priority, from\nthe lowest to highest number.\n\nWithin a given pathMatcher, you can set only one ofpathRules or routeRules.", + "items": { + "$ref": "HttpRouteRule" }, - "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 NetworkAttachment resources, regional and global, available to the specified project. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." + "type": "array" + } + }, + "type": "object" + }, + "PathRule": { + "description": "A path-matching rule for a URL. If matched, will use the specifiedBackendService to handle the traffic arriving at this URL.", + "id": "PathRule", + "properties": { + "customErrorResponsePolicy": { + "$ref": "CustomErrorResponsePolicy", + "description": "customErrorResponsePolicy specifies how the Load\nBalancer returns error responses when BackendServiceorBackendBucket responds with an error. \n\nIf a policy for an\nerror code is not configured for the PathRule, a policy for\nthe error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If\none is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy\nconfigured in UrlMap.defaultCustomErrorResponsePolicy takes\neffect. \n\nFor example, consider a UrlMap with the following configuration:\n \n \n - UrlMap.defaultCustomErrorResponsePolicy are configured\n with policies for 5xx and 4xx errors\n - A PathRule for /coming_soon/ is configured for the error\n code 404.\n\nIf the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher's policy\ntakes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,\nthe policy in PathRule.customErrorResponsePolicy takes\neffect. If any of the requests in this example encounter a 500\nerror code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.\n\ncustomErrorResponsePolicy is supported only for\nglobal external Application Load Balancers." }, - "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" - } + "paths": { + "description": "The list of path patterns to match. Each must start with /\nand the only place a * is allowed is at the end following\na /. The string fed to the path matcher does not include\nany text after the first ? or #, and\nthose chars are not allowed here.", + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "region" + "type": "array" + }, + "routeAction": { + "$ref": "HttpRouteAction", + "description": "In response to a matching path, the load balancer\nperforms advanced routing actions, such as URL rewrites and header\ntransformations, before forwarding the request to the selected\nbackend.\n\n\nOnly one of urlRedirect, service orrouteAction.weightedBackendService can be set.\n\n\nURL maps for classic Application Load Balancers only support\nthe urlRewrite action within a path rule'srouteAction." + }, + "service": { + "description": "The full or partial URL of the backend service resource to which traffic\nis directed if this rule is matched. If routeAction is\nalso specified, advanced routing actions, such as URL rewrites,\ntake effect before sending the request to the backend.\n\n\nOnly one of urlRedirect, service orrouteAction.weightedBackendService can be set.", + "type": "string" + }, + "urlRedirect": { + "$ref": "HttpRedirectAction", + "description": "When a path pattern is matched, the request is redirected to a URL\nspecified by urlRedirect.\n\n\nOnly one of urlRedirect, service orrouteAction.weightedBackendService can be set.\n\n\nNot supported when the URL map is bound to a target gRPC proxy." + } + }, + "type": "object" + }, + "PerInstanceConfig": { + "id": "PerInstanceConfig", + "properties": { + "fingerprint": { + "description": "Fingerprint of this per-instance config. This field can be used in\noptimistic locking. It is ignored when inserting a per-instance\nconfig. An up-to-date fingerprint must be provided in order to update an\nexisting per-instance configuration or the field needs to be unset.", + "format": "byte", + "type": "string" + }, + "name": { + "description": "The name of a per-instance configuration and its corresponding instance.\nServes as a merge key during UpdatePerInstanceConfigs\noperations, that is, if a per-instance configuration with the same name\nexists then it will be updated, otherwise a new one will be created for the\nVM instance with the same name. An attempt to create a per-instance\nconfiguration for a VM instance that either doesn't exist or is not part\nof the group will result in an error.", + "type": "string" + }, + "preservedState": { + "$ref": "PreservedState", + "description": "The intended preserved state for the given instance. Does not contain\npreserved state generated from a stateful policy." + }, + "status": { + "description": "The status of applying this per-instance configuration on the corresponding\nmanaged instance.", + "enum": [ + "APPLYING", + "DELETING", + "EFFECTIVE", + "NONE", + "UNAPPLIED", + "UNAPPLIED_DELETION" + ], + "enumDescriptions": [ + "The per-instance configuration is being applied to the instance, but is\nnot yet effective, possibly waiting for the instance to, for example,REFRESH.", + "The per-instance configuration deletion is being applied on the instance,\npossibly waiting for the instance to, for example, REFRESH.", + "The per-instance configuration is effective on the instance, meaning that\nall disks, ips and metadata specified in this configuration are attached\nor set on the instance.", + "*[Default]* The default status, when no per-instance configuration\nexists.", + "The per-instance configuration is set on an instance but not been applied\nyet.", + "The per-instance configuration has been deleted, but the deletion is not\nyet applied." + ], + "type": "string" + } + }, + "type": "object" + }, + "PeriodicPartialMaintenanceSchedule": { + "description": "The periodic partial maintenance schedule includes 52 weeks worth of\nmaintenance windows.\nLINT.IfChange(PeriodicPartialMaintenanceSchedule)", + "id": "PeriodicPartialMaintenanceSchedule", + "properties": { + "subType": { + "description": "The maintenance type in which the zone is during the given window.", + "enum": [ + "MAINTENANCE_SUBTYPE_UNSPECIFIED", + "MAINTENANCE_TYPE_CUSTOMER_MAINTENANCE", + "MAINTENANCE_TYPE_DISRUPTIVE_UPGRADE", + "MAINTENANCE_TYPE_STABLE", + "MAINTENANCE_TYPE_TRANSITION" ], - "response": { - "$ref": "NetworkAttachmentList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "Default value.", + "A dedicated window for customers to perform their own maintenance. This\noften runs concurrently with a DISRUPTIVE_UPGRADE.", + "For disruptive updates, including host machine kernel or firmware\nupgrades.", + "A post-maintenance window for customers to conduct final testing and\nperformance validation before resuming full business operations.", + "For preliminary, non-disruptive tasks such as key rotations." ], - "description": "Lists the NetworkAttachments for a project in the given scope." + "type": "string" }, - "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" + "targetResource": { + "description": "The target resource that the maintenance window is for.\nFor example, \"projects/my-project/zones/us-central1-a\".", + "type": "string" + }, + "type": { + "enum": [ + "MAINTENANCE_TYPE_UNSPECIFIED", + "PRIVATE_ZONE_MAINTENANCE" ], - "response": { - "$ref": "NetworkAttachment" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "Default value.", + "The zone is in a private maintenance window." ], - "description": "Returns the specified NetworkAttachment resource in the given scope." + "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" + "windowEndTime": { + "$ref": "DateTime", + "description": "The end civil timestamp of the window (not inclusive).\nThis contains a time zone." + }, + "windowStartTime": { + "$ref": "DateTime", + "description": "The start civil timestamp of the window.\nThis contains a time zone." + } + }, + "type": "object" + }, + "Policy": { + "description": "An Identity and Access Management (IAM) policy, which specifies access\ncontrols for Google Cloud resources.\n\n\nA `Policy` is a collection of `bindings`. A `binding` binds one or more\n`members`, or principals, to a single `role`. Principals can be user\naccounts, service accounts, Google groups, and domains (such as G Suite). A\n`role` is a named list of permissions; each `role` can be an IAM predefined\nrole or a user-created custom role.\n\nFor some types of Google Cloud resources, a `binding` can also specify a\n`condition`, which is a logical expression that allows access to a resource\nonly if the expression evaluates to `true`. A condition can add constraints\nbased on attributes of the request, the resource, or both. To learn which\nresources support conditions in their IAM policies, see the\n[IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).\n\n**JSON example:**\n\n```\n {\n \"bindings\": [\n {\n \"role\": \"roles/resourcemanager.organizationAdmin\",\n \"members\": [\n \"user:mike@example.com\",\n \"group:admins@example.com\",\n \"domain:google.com\",\n \"serviceAccount:my-project-id@appspot.gserviceaccount.com\"\n ]\n },\n {\n \"role\": \"roles/resourcemanager.organizationViewer\",\n \"members\": [\n \"user:eve@example.com\"\n ],\n \"condition\": {\n \"title\": \"expirable access\",\n \"description\": \"Does not grant access after Sep 2020\",\n \"expression\": \"request.time < timestamp('2020-10-01T00:00:00.000Z')\",\n }\n }\n ],\n \"etag\": \"BwWWja0YfJA=\",\n \"version\": 3\n }\n```\n\n**YAML example:**\n\n```\n bindings:\n - members:\n - user:mike@example.com\n - group:admins@example.com\n - domain:google.com\n - serviceAccount:my-project-id@appspot.gserviceaccount.com\n role: roles/resourcemanager.organizationAdmin\n - members:\n - user:eve@example.com\n role: roles/resourcemanager.organizationViewer\n condition:\n title: expirable access\n description: Does not grant access after Sep 2020\n expression: request.time < timestamp('2020-10-01T00:00:00.000Z')\n etag: BwWWja0YfJA=\n version: 3\n```\n\nFor a description of IAM and its features, see the\n[IAM documentation](https://cloud.google.com/iam/docs/).", + "id": "Policy", + "properties": { + "auditConfigs": { + "description": "Specifies cloud audit logging configuration for this policy.", + "items": { + "$ref": "AuditConfig" }, - "response": { - "$ref": "Operation" + "type": "array" + }, + "bindings": { + "description": "Associates a list of `members`, or principals, with a `role`. Optionally,\nmay specify a `condition` that determines how and when the `bindings` are\napplied. Each of the `bindings` must contain at least one principal.\n\nThe `bindings` in a `Policy` can refer to up to 1,500 principals; up to 250\nof these principals can be Google groups. Each occurrence of a principal\ncounts towards these limits. For example, if the `bindings` grant 50\ndifferent roles to `user:alice@example.com`, and not to any other\nprincipal, then you can add another 1,450 principals to the `bindings` in\nthe `Policy`.", + "items": { + "$ref": "Binding" }, - "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": "array" }, - "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" - } + "etag": { + "description": "`etag` is used for optimistic concurrency control as a way to help\nprevent simultaneous updates of a policy from overwriting each other.\nIt is strongly suggested that systems make use of the `etag` in the\nread-modify-write cycle to perform policy updates in order to avoid race\nconditions: An `etag` is returned in the response to `getIamPolicy`, and\nsystems are expected to put that etag in the request to `setIamPolicy` to\nensure that their change will be applied to the same version of the policy.\n\n**Important:** If you use IAM Conditions, you must include the `etag` field\nwhenever you call `setIamPolicy`. If you omit this field, then IAM allows\nyou to overwrite a version `3` policy with a version `1` policy, and all of\nthe conditions in the version `3` policy are lost.", + "format": "byte", + "type": "string" + }, + "version": { + "description": "Specifies the format of the policy.\n\nValid values are `0`, `1`, and `3`. Requests that specify an invalid value\nare rejected.\n\nAny operation that affects conditional role bindings must specify version\n`3`. This requirement applies to the following operations:\n\n* Getting a policy that includes a conditional role binding\n* Adding a conditional role binding to a policy\n* Changing a conditional role binding in a policy\n* Removing any role binding, with or without a condition, from a policy\n that includes conditions\n\n**Important:** If you use IAM Conditions, you must include the `etag` field\nwhenever you call `setIamPolicy`. If you omit this field, then IAM allows\nyou to overwrite a version `3` policy with a version `1` policy, and all of\nthe conditions in the version `3` policy are lost.\n\nIf a policy does not include any conditions, operations on that policy may\nspecify any valid version or leave the field unset.\n\nTo learn which resources support conditions in their IAM policies, see the\n[IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, + "PreconfiguredWafSet": { + "id": "PreconfiguredWafSet", + "properties": { + "expressionSets": { + "description": "List of entities that are currently supported for WAF rules.", + "items": { + "$ref": "WafExpressionSet" }, - "parameterOrder": [ - "project", - "region", - "networkAttachment" - ], - "response": { - "$ref": "Operation" + "type": "array" + } + }, + "type": "object" + }, + "PreservedState": { + "description": "Preserved state for a given instance.", + "id": "PreservedState", + "properties": { + "disks": { + "additionalProperties": { + "$ref": "PreservedStatePreservedDisk" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified NetworkAttachment in the given scope" + "description": "Preserved disks defined for this instance.\nThis map is keyed with the device names of the disks.", + "type": "object" }, - "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" - } + "externalIPs": { + "additionalProperties": { + "$ref": "PreservedStatePreservedNetworkIp" }, - "parameterOrder": [ - "project", - "region", - "networkAttachment" - ], - "request": { - "$ref": "NetworkAttachment" + "description": "Preserved external IPs defined for this instance.\nThis map is keyed with the name of the network interface.", + "type": "object" + }, + "internalIPs": { + "additionalProperties": { + "$ref": "PreservedStatePreservedNetworkIp" }, - "response": { - "$ref": "Operation" + "description": "Preserved internal IPs defined for this instance.\nThis map is keyed with the name of the network interface.", + "type": "object" + }, + "metadata": { + "additionalProperties": { + "type": "string" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "description": "Preserved metadata defined for this instance.", + "type": "object" + } + }, + "type": "object" + }, + "PreservedStatePreservedDisk": { + "id": "PreservedStatePreservedDisk", + "properties": { + "autoDelete": { + "description": "These stateful disks will never be deleted during autohealing,\nupdate, instance recreate operations. This flag is used to configure\nif the disk should be deleted after it is no longer used by the group,\ne.g. when the given instance or the whole MIG is deleted.\nNote: disks attached in READ_ONLY mode cannot be\nauto-deleted.", + "enum": [ + "NEVER", + "ON_PERMANENT_INSTANCE_DELETION" + ], + "enumDescriptions": [ + "", + "" ], - "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." + "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" + "mode": { + "description": "The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the\ndisk in READ_WRITE mode.", + "enum": [ + "READ_ONLY", + "READ_WRITE" ], - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "Attaches this disk in read-only mode. Multiple VM instances can use\na disk in READ_ONLY mode at a time.", + "*[Default]* Attaches this disk in READ_WRITE mode. Only\none VM instance at a time can be attached to a disk inREAD_WRITE mode." ], - "description": "Gets the access control policy for a resource. May be empty if no such policy or resource exists." + "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" + "source": { + "description": "The URL of the disk resource that is stateful and should be attached\nto the VM instance.", + "type": "string" + } + }, + "type": "object" + }, + "PreservedStatePreservedNetworkIp": { + "id": "PreservedStatePreservedNetworkIp", + "properties": { + "autoDelete": { + "description": "These stateful IPs will never be released during autohealing,\nupdate or VM instance recreate operations.\nThis flag is used to configure if the IP reservation should be deleted\nafter it is no longer used by the group, e.g. when the given instance\nor the whole group is deleted.", + "enum": [ + "NEVER", + "ON_PERMANENT_INSTANCE_DELETION" ], - "request": { - "$ref": "RegionSetPolicyRequest" + "enumDescriptions": [ + "", + "" + ], + "type": "string" + }, + "ipAddress": { + "$ref": "PreservedStatePreservedNetworkIpIpAddress", + "description": "Ip address representation" + } + }, + "type": "object" + }, + "PreservedStatePreservedNetworkIpIpAddress": { + "id": "PreservedStatePreservedNetworkIpIpAddress", + "properties": { + "address": { + "description": "The URL of the reservation for this IP address.", + "type": "string" + }, + "literal": { + "description": "An IPv4 internal network address to assign to the instance for this\nnetwork interface.", + "type": "string" + } + }, + "type": "object" + }, + "PreviewFeature": { + "description": "Represents a single Google Compute Engine preview feature.", + "id": "PreviewFeature", + "properties": { + "activationStatus": { + "description": "Specifies whether the feature is enabled or disabled.", + "enum": [ + "ACTIVATION_STATE_UNSPECIFIED", + "DISABLED", + "ENABLED" + ], + "enumDescriptions": [ + "", + "", + "" + ], + "type": "string" + }, + "creationTimestamp": { + "description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "Output only. [Output Only] Description of the feature.", + "readOnly": true, + "type": "string" + }, + "id": { + "description": "Output only. [Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "format": "uint64", + "readOnly": true, + "type": "string" + }, + "kind": { + "default": "compute#previewFeature", + "description": "Output only. [Output only] The type of the feature. Always \"compute#previewFeature\" for\npreview features.", + "readOnly": true, + "type": "string" + }, + "name": { + "description": "Name of the feature.", + "type": "string" + }, + "rolloutOperation": { + "$ref": "PreviewFeatureRolloutOperation", + "description": "Rollout operation of the feature." + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for the resource.", + "readOnly": true, + "type": "string" + }, + "status": { + "$ref": "PreviewFeatureStatus", + "description": "Output only. [Output only] Status of the feature.", + "readOnly": true + } + }, + "type": "object" + }, + "PreviewFeatureList": { + "id": "PreviewFeatureList", + "properties": { + "etag": { + "type": "string" + }, + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of PreviewFeature resources.", + "items": { + "$ref": "PreviewFeature" }, - "response": { - "$ref": "Policy" + "type": "array" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "unreachables": { + "description": "Output only. [Output Only] Unreachable resources.\nend_interface: MixerListResponseWithEtagBuilder", + "items": { + "type": "string" }, - "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." + "readOnly": true, + "type": "array" }, - "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, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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" } }, - "parameterOrder": [ - "project", - "region", - "resource" + "type": "object" + } + }, + "type": "object" + }, + "PreviewFeatureRolloutOperation": { + "description": "Represents the rollout operation", + "id": "PreviewFeatureRolloutOperation", + "properties": { + "rolloutInput": { + "$ref": "PreviewFeatureRolloutOperationRolloutInput", + "description": "Input only. The input for the rollout operation." + } + }, + "type": "object" + }, + "PreviewFeatureRolloutOperationRolloutInput": { + "description": "Represents the input for the rollout operation.", + "id": "PreviewFeatureRolloutOperationRolloutInput", + "properties": { + "name": { + "description": "The name of the rollout plan\nEx.\norganizations//locations/global/rolloutPlans/\nEx.\nfolders//locations/global/rolloutPlans/\nEx.\nprojects//locations/global/rolloutPlans/.", + "type": "string" + }, + "predefinedRolloutPlan": { + "description": "Predefined rollout plan.", + "enum": [ + "ROLLOUT_PLAN_FAST_ROLLOUT", + "ROLLOUT_PLAN_TWO_DAY_ROLLOUT", + "ROLLOUT_PLAN_UNSPECIFIED" ], - "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" + "enumDescriptions": [ + "", + "", + "" ], - "description": "Returns permissions that a caller has on the specified resource." + "type": "string" } - } + }, + "type": "object" }, - "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" + "PreviewFeatureStatus": { + "description": "[Output Only] The status of the feature.", + "id": "PreviewFeatureStatus", + "properties": { + "description": { + "description": "Output only. [Output Only] The description of the feature.", + "readOnly": true, + "type": "string" + }, + "helpLink": { + "description": "Output only. [Output Only] Link to the public documentation for the feature.", + "readOnly": true, + "type": "string" + }, + "releaseStatus": { + "$ref": "PreviewFeatureStatusReleaseStatus" + } + }, + "type": "object" + }, + "PreviewFeatureStatusReleaseStatus": { + "description": "[Output Only] The release status of the feature.", + "id": "PreviewFeatureStatusReleaseStatus", + "properties": { + "stage": { + "description": "Output only. [Output Only] The stage of the feature.", + "enum": [ + "DEPRECATED", + "GA", + "PREVIEW", + "STAGE_UNSPECIFIED" ], - "response": { - "$ref": "NetworkEdgeSecurityService" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "", + "", + "", + "" ], - "description": "Gets a specified NetworkEdgeSecurityService." + "readOnly": true, + "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" + "updateDate": { + "$ref": "Date", + "description": "Output only. The last date when a feature transitioned between ReleaseStatuses.", + "readOnly": true + } + }, + "type": "object" + }, + "Project": { + "description": "Represents a Project resource.\n\nA project is used to organize resources in a Google Cloud Platform\nenvironment. For more information, read about the \nResource Hierarchy.", + "id": "Project", + "properties": { + "cloudArmorTier": { + "description": "Output only. [Output Only] The Cloud Armor tier for this project. It can be one of the\nfollowing values: CA_STANDARD,CA_ENTERPRISE_PAYGO.\n\nIf this field is not specified, it is assumed to beCA_STANDARD.", + "enum": [ + "CA_ENTERPRISE_ANNUAL", + "CA_ENTERPRISE_PAYGO", + "CA_STANDARD" ], - "request": { - "$ref": "NetworkEdgeSecurityService" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "Enterprise tier protection billed annually.", + "Enterprise tier protection billed monthly.", + "Standard protection." ], - "description": "Creates a new service in the specified project using the data included in the request." + "readOnly": true, + "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" + "commonInstanceMetadata": { + "$ref": "Metadata", + "description": "Metadata key/value pairs available to all instances contained in this\nproject. See Custom\nmetadata for more information." + }, + "creationTimestamp": { + "description": "[Output Only] Creation timestamp inRFC3339\ntext format.", + "type": "string" + }, + "defaultNetworkTier": { + "description": "This signifies the default network tier used for configuring resources of\nthe project and can only take the following values:PREMIUM, STANDARD. Initially the default network\ntier is PREMIUM.", + "enum": [ + "FIXED_STANDARD", + "PREMIUM", + "STANDARD", + "STANDARD_OVERRIDES_FIXED_STANDARD" ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "Public internet quality with fixed bandwidth.", + "High quality, Google-grade network tier, support for all networking\nproducts.", + "Public internet quality, only limited support for other networking\nproducts.", + "(Output only) Temporary tier for FIXED_STANDARD when fixed standard tier\nis expired or not configured." ], - "description": "Deletes the specified service." + "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" + "defaultServiceAccount": { + "description": "[Output Only] Default service account used by VMs running in this project.", + "type": "string" + }, + "description": { + "description": "An optional textual description of the resource.", + "type": "string" + }, + "enabledFeatures": { + "description": "An optional list of restricted features enabled for use on this project.", + "items": { + "type": "string" }, - "response": { - "$ref": "Operation" + "type": "array" + }, + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server. This is *not* the project ID, and is\njust a unique ID used by Compute Engine to identify resources.", + "format": "uint64", + "type": "string" + }, + "kind": { + "default": "compute#project", + "description": "Output only. [Output Only] Type of the resource. Always compute#project for\nprojects.", + "readOnly": true, + "type": "string" + }, + "name": { + "description": "The project ID. For example: my-example-project. Use the\nproject ID to make requests to Compute Engine.", + "type": "string" + }, + "quotas": { + "description": "[Output Only] Quotas assigned to this project.", + "items": { + "$ref": "Quota" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "type": "array" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" + }, + "usageExportLocation": { + "$ref": "UsageExportLocation", + "description": "An optional naming prefix for daily usage reports and the Google Cloud\nStorage bucket where they are stored." + }, + "vmDnsSetting": { + "description": "Output only. [Output Only] Default internal DNS setting used by VMs running in\nthis project.", + "enum": [ + "GLOBAL_DEFAULT", + "UNSPECIFIED_VM_DNS_SETTING", + "ZONAL_DEFAULT", + "ZONAL_ONLY" + ], + "enumDescriptions": [ + "", + "", + "", + "" ], - "description": "Patches the specified policy with the data included in the request." + "readOnly": true, + "type": "string" }, - "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" + "xpnProjectStatus": { + "description": "[Output Only] The role this project has in a shared VPC configuration.\nCurrently, only projects with the host role, which is specified by the\nvalue HOST, are differentiated.", + "enum": [ + "HOST", + "UNSPECIFIED_XPN_PROJECT_STATUS" ], - "response": { - "$ref": "NetworkEdgeSecurityServiceAggregatedList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "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`." + "type": "string" } - } + }, + "type": "object" }, - "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." + "ProjectsDisableXpnResourceRequest": { + "id": "ProjectsDisableXpnResourceRequest", + "properties": { + "xpnResource": { + "$ref": "XpnResourceId", + "description": "Service resource (a.k.a service project) ID." + } + }, + "type": "object" + }, + "ProjectsEnableXpnResourceRequest": { + "id": "ProjectsEnableXpnResourceRequest", + "properties": { + "xpnResource": { + "$ref": "XpnResourceId", + "description": "Service resource (a.k.a service project) ID." + } + }, + "type": "object" + }, + "ProjectsGetXpnResources": { + "id": "ProjectsGetXpnResources", + "properties": { + "kind": { + "default": "compute#projectsGetXpnResources", + "description": "Output only. [Output Only] Type of resource. Alwayscompute#projectsGetXpnResources for lists of service resources\n(a.k.a service projects)", + "readOnly": true, + "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" - } + "nextPageToken": { + "description": "Output only. [Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "readOnly": true, + "type": "string" + }, + "resources": { + "description": "Service resources (a.k.a service projects) attached to this project as\ntheir shared VPC host.", + "items": { + "$ref": "XpnResourceId" }, - "parameterOrder": [ - "project" + "type": "array" + } + }, + "type": "object" + }, + "ProjectsListXpnHostsRequest": { + "id": "ProjectsListXpnHostsRequest", + "properties": { + "organization": { + "description": "Optional organization ID managed by Cloud Resource Manager, for which to\nlist shared VPC host projects. If not specified, the organization will be\ninferred from the project.", + "type": "string" + } + }, + "type": "object" + }, + "ProjectsSetCloudArmorTierRequest": { + "id": "ProjectsSetCloudArmorTierRequest", + "properties": { + "cloudArmorTier": { + "description": "Managed protection tier to be set.", + "enum": [ + "CA_ENTERPRISE_ANNUAL", + "CA_ENTERPRISE_PAYGO", + "CA_STANDARD" ], - "response": { - "$ref": "NetworkEndpointGroupAggregatedList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "Enterprise tier protection billed annually.", + "Enterprise tier protection billed monthly.", + "Standard protection." ], - "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" + "type": "string" + } + }, + "type": "object" + }, + "ProjectsSetDefaultNetworkTierRequest": { + "id": "ProjectsSetDefaultNetworkTierRequest", + "properties": { + "networkTier": { + "description": "Default network tier to be set.", + "enum": [ + "FIXED_STANDARD", + "PREMIUM", + "STANDARD", + "STANDARD_OVERRIDES_FIXED_STANDARD" ], - "response": { - "$ref": "NetworkEndpointGroup" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "Public internet quality with fixed bandwidth.", + "High quality, Google-grade network tier, support for all networking\nproducts.", + "Public internet quality, only limited support for other networking\nproducts.", + "(Output only) Temporary tier for FIXED_STANDARD when fixed standard tier\nis expired or not configured." ], - "description": "Returns the specified network endpoint group." - }, - "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" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request 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 network endpoint group. It should comply with RFC1035.", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone" + "type": "string" + } + }, + "type": "object" + }, + "PublicAdvertisedPrefix": { + "description": "A public advertised prefix represents an aggregated IP prefix or netblock\nwhich customers bring to cloud. The IP prefix is a single unit of route\nadvertisement and is announced globally to the internet.", + "id": "PublicAdvertisedPrefix", + "properties": { + "byoipApiVersion": { + "description": "Output only. [Output Only] The version of BYOIP API.", + "enum": [ + "V1", + "V2" ], - "request": { - "$ref": "NetworkEndpointGroup" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "This public advertised prefix can be used to create both regional and\nglobal public delegated prefixes. It usually takes 4 weeks to create or\ndelete a public delegated prefix. The BGP status cannot be changed.", + "This public advertised prefix can only be used to create regional public\ndelegated prefixes. Public delegated prefix creation and deletion takes\nminutes and the BGP status can be modified." ], - "description": "Creates a network endpoint group in the specified project using the parameters that are included in the request." + "readOnly": true, + "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" + "creationTimestamp": { + "description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you\ncreate the resource.", + "type": "string" + }, + "dnsVerificationIp": { + "description": "The address to be used for reverse DNS verification.", + "type": "string" + }, + "fingerprint": { + "description": "Fingerprint of this resource. A hash of the contents stored in this object.\nThis field is used in optimistic locking. This field will be ignored when\ninserting a new PublicAdvertisedPrefix. An up-to-date\nfingerprint must be provided in order to update thePublicAdvertisedPrefix, otherwise the request will fail with\nerror 412 conditionNotMet.\n\nTo see the latest fingerprint, make a get() request to\nretrieve a PublicAdvertisedPrefix.", + "format": "byte", + "type": "string" + }, + "id": { + "description": "Output only. [Output Only] The unique identifier for the resource type. The server\ngenerates this identifier.", + "format": "uint64", + "readOnly": true, + "type": "string" + }, + "ipCidrRange": { + "description": "The address range, in CIDR format, represented by this public advertised\nprefix.", + "type": "string" + }, + "ipv6AccessType": { + "description": "The internet access type for IPv6 Public Advertised Prefixes.", + "enum": [ + "EXTERNAL", + "INTERNAL" ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "Default IPv6 access type. The prefix will be announced to the internet.\nAll children Public Delegated Prefixes will have IPv6 access type as\nEXTERNAL.", + "The prefix will not be announced to the internet. Prefix will be used\nprivately within Cloud. All children Public Delegated Prefixes\nwill have IPv6 access type as INTERNAL." ], - "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." + "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" - } + "kind": { + "default": "compute#publicAdvertisedPrefix", + "description": "Output only. [Output Only] Type of the resource. Alwayscompute#publicAdvertisedPrefix for public advertised prefixes.", + "readOnly": true, + "type": "string" + }, + "name": { + "annotations": { + "required": [ + "compute.publicAdvertisedPrefixes.insert" + ] }, - "parameterOrder": [ - "project", - "zone", - "networkEndpointGroup" + "description": "Name of the resource. Provided by the client when the resource is created.\nThe name must be 1-63 characters long, and comply withRFC1035.\nSpecifically, the name must be 1-63 characters long and match the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first\ncharacter must be a lowercase letter, and all following characters must\nbe a dash, lowercase letter, or digit, except the last character, which\ncannot be a dash.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "pdpScope": { + "description": "Specifies how child public delegated prefix will be scoped. It could\nbe one of following values:\n \n \n - `REGIONAL`: The public delegated prefix is regional only. The\n provisioning will take a few minutes.\n - `GLOBAL`: The public delegated prefix is global only. The\n provisioning will take ~4 weeks.\n - `GLOBAL_AND_REGIONAL` [output only]: The public delegated prefixes is\n BYOIP V1 legacy prefix. This is output only value and no longer\n supported in BYOIP V2.", + "enum": [ + "GLOBAL", + "GLOBAL_AND_REGIONAL", + "REGIONAL" ], - "request": { - "$ref": "NetworkEndpointGroupsAttachEndpointsRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "The public delegated prefix is global only. The provisioning will take ~4\nweeks.", + "The public delegated prefixes is BYOIP V1 legacy prefix. This is output\nonly value and no longer supported in BYOIP V2.", + "The public delegated prefix is regional only. The provisioning will take\na few minutes." ], - "description": "Attach a list of network endpoints to the specified network endpoint group." + "type": "string" }, - "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" - } + "publicDelegatedPrefixs": { + "description": "Output only. [Output Only] The list of public delegated prefixes that exist for this\npublic advertised prefix.", + "items": { + "$ref": "PublicAdvertisedPrefixPublicDelegatedPrefix" }, - "parameterOrder": [ - "project", - "zone", - "networkEndpointGroup" + "readOnly": true, + "type": "array" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for the resource.", + "readOnly": true, + "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:\n \n \n - `INITIAL`: RPKI validation is complete.\n - `PTR_CONFIGURED`: User has configured the PTR.\n - `VALIDATED`: Reverse DNS lookup is successful.\n - `REVERSE_DNS_LOOKUP_FAILED`: Reverse DNS lookup failed.\n - `PREFIX_CONFIGURATION_IN_PROGRESS`: The prefix is being\n configured.\n - `PREFIX_CONFIGURATION_COMPLETE`: The prefix is fully configured.\n - `PREFIX_REMOVAL_IN_PROGRESS`: The prefix is being removed.", + "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" ], - "request": { - "$ref": "NetworkEndpointGroupsDetachEndpointsRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "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": "Detach a list of network endpoints from the specified network endpoint group." + "type": "string" + } + }, + "type": "object" + }, + "PublicAdvertisedPrefixList": { + "id": "PublicAdvertisedPrefixList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "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" + "items": { + "description": "A list of PublicAdvertisedPrefix resources.", + "items": { + "$ref": "PublicAdvertisedPrefix" }, - "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." + "type": "array" }, - "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, + "kind": { + "default": "compute#publicAdvertisedPrefixList", + "description": "Output only. [Output Only] Type of the resource. Alwayscompute#publicAdvertisedPrefix for public advertised prefixes.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue 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.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project", - "zone", - "resource" + "type": "object" + } + }, + "type": "object" + }, + "PublicAdvertisedPrefixPublicDelegatedPrefix": { + "description": "Represents a CIDR range which can be used to assign addresses.", + "id": "PublicAdvertisedPrefixPublicDelegatedPrefix", + "properties": { + "ipRange": { + "description": "The IP address range of the public delegated prefix", + "type": "string" + }, + "name": { + "description": "The name of the public delegated prefix", + "type": "string" + }, + "project": { + "description": "The project number of the public delegated prefix", + "type": "string" + }, + "region": { + "description": "The region of the public delegated prefix if it is regional. If absent,\nthe prefix is global.", + "type": "string" + }, + "status": { + "description": "The status of the public delegated prefix. Possible values are:\n INITIALIZING: The public delegated prefix is being initialized and\n addresses cannot be created yet.\n ANNOUNCED: The public delegated prefix is active.", + "type": "string" + } + }, + "type": "object" + }, + "PublicDelegatedPrefix": { + "description": "A PublicDelegatedPrefix resource represents an IP block within a\nPublicAdvertisedPrefix that is configured within a single cloud scope\n(global or region). IPs in the block can be allocated to resources within\nthat scope. Public delegated prefixes may be further broken up into\nsmaller IP blocks in the same scope as the parent block.", + "id": "PublicDelegatedPrefix", + "properties": { + "allocatablePrefixLength": { + "description": "The allocatable prefix length supported by this public delegated prefix.\nThis field is optional and cannot be set for prefixes in DELEGATION mode.\nIt cannot be set for IPv4 prefixes either, and it always defaults to 32.", + "format": "int32", + "type": "integer" + }, + "byoipApiVersion": { + "description": "Output only. [Output Only] The version of BYOIP API.", + "enum": [ + "V1", + "V2" ], - "request": { - "$ref": "TestPermissionsRequest" + "enumDescriptions": [ + "This public delegated prefix usually takes 4 weeks to delete, and the BGP\nstatus cannot be changed. Announce and Withdraw APIs can not be used on\nthis prefix.", + "This public delegated prefix takes minutes to delete. Announce and\nWithdraw APIs can be used on this prefix to change the BGP status." + ], + "readOnly": true, + "type": "string" + }, + "creationTimestamp": { + "description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you\ncreate the resource.", + "type": "string" + }, + "enableEnhancedIpv4Allocation": { + "description": "Output only. [Output Only] Whether this PDP supports enhanced IPv4 allocations.\nApplicable for IPv4 PDPs only.", + "readOnly": true, + "type": "boolean" + }, + "fingerprint": { + "description": "Fingerprint of this resource. A hash of the contents stored in this object.\nThis field is used in optimistic locking. This field will be ignored when\ninserting a new PublicDelegatedPrefix. An up-to-date\nfingerprint must be provided in order to update thePublicDelegatedPrefix, otherwise the request will fail with\nerror 412 conditionNotMet.\n\nTo see the latest fingerprint, make a get() request to\nretrieve a PublicDelegatedPrefix.", + "format": "byte", + "type": "string" + }, + "id": { + "description": "Output only. [Output Only] The unique identifier for the resource type. The server\ngenerates this identifier.", + "format": "uint64", + "readOnly": true, + "type": "string" + }, + "ipCidrRange": { + "description": "The IP address range, in CIDR format, represented by this public\ndelegated prefix.", + "type": "string" + }, + "ipv6AccessType": { + "description": "Output only. [Output Only] The internet access type for IPv6 Public Delegated Prefixes.\nInherited from parent prefix.", + "enum": [ + "EXTERNAL", + "INTERNAL" + ], + "enumDescriptions": [ + "The parent public advertised prefix will be announced to the internet.\nAll children public delegated prefixes will have IPv6 access type as\nEXTERNAL.", + "The parent public advertised prefix will not be announced to the\ninternet. Prefix will be used privately within Cloud. All children\npublic delegated prefixes will have IPv6 access type as INTERNAL." + ], + "readOnly": true, + "type": "string" + }, + "isLiveMigration": { + "description": "If true, the prefix will be live migrated.", + "type": "boolean" + }, + "kind": { + "default": "compute#publicDelegatedPrefix", + "description": "Output only. [Output Only] Type of the resource. Alwayscompute#publicDelegatedPrefix for public delegated prefixes.", + "readOnly": true, + "type": "string" + }, + "mode": { + "description": "The public delegated prefix mode for IPv6 only.", + "enum": [ + "DELEGATION", + "EXTERNAL_IPV6_FORWARDING_RULE_CREATION", + "EXTERNAL_IPV6_SUBNETWORK_CREATION", + "INTERNAL_IPV6_SUBNETWORK_CREATION" + ], + "enumDescriptions": [ + "The public delegated prefix is used for further sub-delegation only. Such\nprefixes cannot set allocatablePrefixLength.", + "The public delegated prefix is used for creating forwarding rules only.\nSuch prefixes cannot set publicDelegatedSubPrefixes. Parent public\ndelegated prefix must have IPv6 access type as EXTERNAL.", + "The public delegated prefix is used for creating dual-mode subnetworks\nonly. Such prefixes cannot set publicDelegatedSubPrefixes. Parent public\ndelegated prefix must have IPv6 access type as EXTERNAL.", + "The public delegated prefix is used for creating dual stack or IPv6-only\nsubnetwork with internal access only. Such prefixes cannot set\npublicDelegatedSubPrefixes and allocatablePrefixLength. Parent public\ndelegated prefix must have IPv6 access type as INTERNAL." + ], + "type": "string" + }, + "name": { + "annotations": { + "required": [ + "compute.publicDelegatedPrefixes.insert" + ] }, - "response": { - "$ref": "TestPermissionsResponse" + "description": "Name of the resource. Provided by the client when the resource is created.\nThe name must be 1-63 characters long, and comply withRFC1035.\nSpecifically, the name must be 1-63 characters long and match the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first\ncharacter must be a lowercase letter, and all following characters must\nbe a dash, lowercase letter, or digit, except the last character, which\ncannot be a dash.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "parentPrefix": { + "description": "The URL of parent prefix. Either PublicAdvertisedPrefix or\nPublicDelegatedPrefix.", + "type": "string" + }, + "publicDelegatedSubPrefixs": { + "description": "The list of sub public delegated prefixes that exist for this public\ndelegated prefix.", + "items": { + "$ref": "PublicDelegatedPrefixPublicDelegatedSubPrefix" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "type": "array" + }, + "region": { + "description": "Output only. [Output Only] URL of the region where the public delegated prefix resides.\nThis field applies only to the region resource. You must specify this\nfield as part of the HTTP request URL. It is not settable as a field in\nthe request body.", + "readOnly": true, + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for the resource.", + "readOnly": true, + "type": "string" + }, + "status": { + "description": "[Output Only] The status of the public delegated prefix, which can be one\nof following values:\n \n \n - `INITIALIZING` The public delegated prefix is being initialized and\n addresses cannot be created yet.\n - `READY_TO_ANNOUNCE` The public delegated prefix is a live migration\n prefix and is active.\n - `ANNOUNCED` The public delegated prefix is announced and ready to\n use.\n - `DELETING` The public delegated prefix is being deprovsioned.\n - `ACTIVE` The public delegated prefix is ready to use.", + "enum": [ + "ACTIVE", + "ANNOUNCED", + "ANNOUNCED_TO_GOOGLE", + "ANNOUNCED_TO_INTERNET", + "DELETING", + "INITIALIZING", + "READY_TO_ANNOUNCE" + ], + "enumDescriptions": [ + "The public delegated prefix is ready to use.", + "The public delegated prefix is announced and ready to use.", + "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\ncreated yet.", + "The public delegated prefix is currently withdrawn but ready to be\nannounced." ], - "description": "Returns permissions that a caller has on the specified resource." + "type": "string" } - } + }, + "type": "object" }, - "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." + "PublicDelegatedPrefixAggregatedList": { + "id": "PublicDelegatedPrefixAggregatedList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "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" - } + "items": { + "additionalProperties": { + "$ref": "PublicDelegatedPrefixesScopedList", + "description": "[Output Only] Name of the scope containing this set of\nPublicDelegatedPrefixes." }, - "parameterOrder": [ - "project", - "networkEndpointGroup" - ], - "response": { - "$ref": "NetworkEndpointGroup" + "description": "A list of PublicDelegatedPrefixesScopedList resources.", + "type": "object" + }, + "kind": { + "default": "compute#publicDelegatedPrefixAggregatedList", + "description": "Output only. [Output Only] Type of the resource. Alwayscompute#publicDelegatedPrefixAggregatedList for aggregated\nlists of public delegated prefixes.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "unreachables": { + "description": "Output only. [Output Only] Unreachable resources.", + "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": "Returns the specified network endpoint group." + "readOnly": true, + "type": "array" }, - "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, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", + "data": { + "description": "[Output Only] Metadata about this warning in key:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" + }, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project" - ], - "request": { - "$ref": "NetworkEndpointGroup" - }, - "response": { - "$ref": "Operation" + "type": "object" + } + }, + "type": "object" + }, + "PublicDelegatedPrefixList": { + "id": "PublicDelegatedPrefixList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of PublicDelegatedPrefix resources.", + "items": { + "$ref": "PublicDelegatedPrefix" }, - "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." + "type": "array" }, - "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, + "kind": { + "default": "compute#publicDelegatedPrefixList", + "description": "Output only. [Output Only] Type of the resource. Alwayscompute#publicDelegatedPrefixList for public delegated\nprefixes.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue 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.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. 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" } }, - "parameterOrder": [ - "project", - "networkEndpointGroup" + "type": "object" + } + }, + "type": "object" + }, + "PublicDelegatedPrefixPublicDelegatedSubPrefix": { + "description": "Represents a sub PublicDelegatedPrefix.", + "id": "PublicDelegatedPrefixPublicDelegatedSubPrefix", + "properties": { + "allocatablePrefixLength": { + "description": "The allocatable prefix length supported by this PublicDelegatedSubPrefix.", + "format": "int32", + "type": "integer" + }, + "delegateeProject": { + "description": "Name of the project scoping this PublicDelegatedSubPrefix.", + "type": "string" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you\ncreate the resource.", + "type": "string" + }, + "enableEnhancedIpv4Allocation": { + "description": "Output only. [Output Only] Whether this PDP supports enhanced IPv4 allocations.\nApplicable for IPv4 PDPs only.", + "readOnly": true, + "type": "boolean" + }, + "ipCidrRange": { + "description": "The IP address range, in CIDR format, represented by this sub public\ndelegated prefix.", + "type": "string" + }, + "ipv6AccessType": { + "description": "Output only. [Output Only] The internet access type for IPv6 Public Delegated Sub\nPrefixes. Inherited from parent prefix.", + "enum": [ + "EXTERNAL", + "INTERNAL" ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "The parent public advertised prefix will be announced to the internet.\nAll children public delegated prefixes will have IPv6 access type as\nEXTERNAL.", + "The parent public advertised prefix will not be announced to the\ninternet. Prefix will be used privately within Cloud. All children\npublic delegated prefixes will have IPv6 access type as INTERNAL." ], - "description": "Deletes the specified network endpoint group.Note that the NEG cannot be deleted if there are backend services referencing it." + "readOnly": true, + "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, + "isAddress": { + "description": "Whether the sub prefix is delegated to create Address resources in the\ndelegatee project.", + "type": "boolean" + }, + "mode": { + "description": "The PublicDelegatedSubPrefix mode for IPv6 only.", + "enum": [ + "DELEGATION", + "EXTERNAL_IPV6_FORWARDING_RULE_CREATION", + "EXTERNAL_IPV6_SUBNETWORK_CREATION", + "INTERNAL_IPV6_SUBNETWORK_CREATION" + ], + "enumDescriptions": [ + "The public delegated prefix is used for further sub-delegation only. Such\nprefixes cannot set allocatablePrefixLength.", + "The public delegated prefix is used for creating forwarding rules only.\nSuch prefixes cannot set publicDelegatedSubPrefixes. Parent public\ndelegated prefix must have IPv6 access type as EXTERNAL.", + "The public delegated prefix is used for creating dual-mode subnetworks\nonly. Such prefixes cannot set publicDelegatedSubPrefixes. Parent public\ndelegated prefix must have IPv6 access type as EXTERNAL.", + "The public delegated prefix is used for creating dual stack or IPv6-only\nsubnetwork with internal access only. Such prefixes cannot set\npublicDelegatedSubPrefixes and allocatablePrefixLength. Parent public\ndelegated prefix must have IPv6 access type as INTERNAL." + ], + "type": "string" + }, + "name": { + "description": "The name of the sub public delegated prefix.", + "type": "string" + }, + "region": { + "description": "Output only. [Output Only] The region of the sub public delegated prefix if it is\nregional. If absent, the sub prefix is global.", + "readOnly": true, + "type": "string" + }, + "status": { + "description": "Output only. [Output Only] The status of the sub public delegated prefix.", + "enum": [ + "ACTIVE", + "INACTIVE" + ], + "enumDescriptions": [ + "", + "" + ], + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "PublicDelegatedPrefixesScopedList": { + "id": "PublicDelegatedPrefixesScopedList", + "properties": { + "publicDelegatedPrefixes": { + "description": "[Output Only] A list of PublicDelegatedPrefixes contained in this scope.", + "items": { + "$ref": "PublicDelegatedPrefix" + }, + "type": "array" + }, + "warning": { + "description": "[Output Only] Informational warning which replaces the list of\npublic delegated prefixes when the list is empty.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. 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" } }, - "parameterOrder": [ - "project", - "networkEndpointGroup" + "type": "object" + } + }, + "type": "object" + }, + "Quota": { + "description": "A quotas entry.", + "id": "Quota", + "properties": { + "limit": { + "description": "[Output Only] Quota limit for this metric.", + "format": "double", + "type": "number" + }, + "metric": { + "description": "[Output Only] Name of the quota metric.", + "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" ], - "request": { - "$ref": "GlobalNetworkEndpointGroupsAttachEndpointsRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "Guest CPUs", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "The total number of snapshots allowed for a single project.", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "" ], - "description": "Attach a network endpoint to the specified network endpoint group." + "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." + "owner": { + "description": "[Output Only] Owning resource. This is the resource on which this quota\nis applied.", + "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" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[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." + "usage": { + "description": "[Output Only] Current usage of this metric.", + "format": "double", + "type": "number" } - } + }, + "type": "object" }, - "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" + "QuotaExceededInfo": { + "description": "Additional details for quota exceeded error for resource quota.", + "id": "QuotaExceededInfo", + "properties": { + "dimensions": { + "additionalProperties": { + "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 list of regional network endpoint groups available to the specified project in the given region." + "description": "The map holding related quota dimensions.", + "type": "object" }, - "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." + "futureLimit": { + "description": "Future quota limit being rolled out. The limit's unit depends on the quota\n type or metric.", + "format": "double", + "type": "number" }, - "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." + "limit": { + "description": "Current effective quota limit. The limit's unit depends on the quota type\nor metric.", + "format": "double", + "type": "number" }, - "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." + "limitName": { + "description": "The name of the quota limit.", + "type": "string" }, - "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." + "metricName": { + "description": "The Compute Engine quota metric name.", + "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" - }, - "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" + "rolloutStatus": { + "description": "Rollout status of the future quota limit.", + "enum": [ + "IN_PROGRESS", + "ROLLOUT_STATUS_UNSPECIFIED" ], - "request": { - "$ref": "RegionNetworkEndpointGroupsDetachEndpointsRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "IN_PROGRESS - A rollout is in process which will change the limit value\nto future limit.", + "ROLLOUT_STATUS_UNSPECIFIED - Rollout status is not specified. The default\nvalue." ], - "description": "Detach the network endpoint from the specified network endpoint group." + "type": "string" + } + }, + "type": "object" + }, + "Reference": { + "description": "Represents a reference to a resource.", + "id": "Reference", + "properties": { + "kind": { + "default": "compute#reference", + "description": "Output only. [Output Only] Type of the resource. Always compute#reference\nfor references.", + "readOnly": true, + "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" - }, - "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" - ], - "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." + "referenceType": { + "description": "A description of the reference type with no implied semantics. Possible\nvalues include:\n \n \n 1. MEMBER_OF", + "type": "string" + }, + "referrer": { + "description": "URL of the resource which refers to the target.", + "type": "string" + }, + "target": { + "description": "URL of the resource to which this reference points.", + "type": "string" + } + }, + "type": "object" + }, + "RegexRewrite": { + "description": "The spec for modifying the path using a regular expression.", + "id": "RegexRewrite", + "properties": { + "pathPattern": { + "description": "Required. The regular expression used to match against the URL path.\nIt uses RE2 syntax with the following constraints:\n \n \n - Any single character operators\n - Groups are allowed to have only submatch operator inside\n - Groups are allowed only without any char repetition, e.g.\n .*\n - Any char repetition, e.g. .*, is\n only allowed to be used in a single regex together with:\n \n \n - Empty string operators\n - Other repetitions\n - Ranges\n - Repetitions of ranges\n \n \n - Ranges are only allowed to have:\n \n \n - Character range\n - Digits range\n - Symbols listed in characters allowed for ranges", + "type": "string" + }, + "pathSubstitution": { + "description": "Required. Required when path pattern is specified. Used to rewrite matching parts of\nthe path.", + "type": "string" } - } + }, + "type": "object" }, - "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", + "Region": { + "description": "Represents a Region resource.\n\nA region is a geographical area where a resource is located. For more\ninformation, readRegions\nand Zones.", + "id": "Region", + "properties": { + "creationTimestamp": { + "description": "[Output Only] Creation timestamp inRFC3339\ntext format.", + "type": "string" + }, + "deprecated": { + "$ref": "DeprecationStatus", + "description": "[Output Only] The deprecation status associated with this region." + }, + "description": { + "description": "[Output Only] Textual description of the resource.", + "type": "string" + }, + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "format": "uint64", + "type": "string" + }, + "kind": { + "default": "compute#region", + "description": "Output only. [Output Only] Type of the resource. Always compute#region for\nregions.", + "readOnly": true, + "type": "string" + }, + "name": { + "description": "[Output Only] Name of the resource.", + "type": "string" + }, + "quotaStatusWarning": { + "description": "Output only. [Output Only] Warning of fetching the `quotas` field for this region. This\nfield is populated only if fetching of the `quotas` field fails.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "pageToken": { - "description": "Specifies a page token 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{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" } }, - "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." + "readOnly": true, + "type": "object" }, - "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" - } + "quotas": { + "description": "[Output Only] Quotas assigned to this region.", + "items": { + "$ref": "Quota" }, - "parameterOrder": [ - "project", - "network" + "type": "array" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" + }, + "status": { + "description": "[Output Only] Status of the region, either UP orDOWN.", + "enum": [ + "DOWN", + "UP" ], - "response": { - "$ref": "Network" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "", + "" ], - "description": "Returns the specified network." + "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" + "supportsPzs": { + "description": "Output only. [Output Only] Reserved for future use.", + "readOnly": true, + "type": "boolean" + }, + "zones": { + "description": "[Output Only] A list of zones available in this region, in the form of\nresource URLs.", + "items": { + "type": "string" }, - "response": { - "$ref": "Operation" + "type": "array" + } + }, + "type": "object" + }, + "RegionAddressesMoveRequest": { + "id": "RegionAddressesMoveRequest", + "properties": { + "description": { + "description": "An optional destination address description if intended to be different\nfrom the source.", + "type": "string" + }, + "destinationAddress": { + "description": "The URL of the destination address to move to. This can be a full or\npartial URL. For example, the following are all valid URLs to a address:\n \n - https://www.googleapis.com/compute/v1/projects/project/regions/region/addresses/address \n - projects/project/regions/region/addresses/address\n\n\nNote that destination project must be different from the source project. So/regions/region/addresses/address is not valid partial url.", + "type": "string" + } + }, + "type": "object" + }, + "RegionAutoscalerList": { + "description": "Contains a list of autoscalers.", + "id": "RegionAutoscalerList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of Autoscaler resources.", + "items": { + "$ref": "Autoscaler" }, - "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." + "type": "array" }, - "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, + "kind": { + "default": "compute#regionAutoscalerList", + "description": "Output only. Type of resource.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. 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" } }, - "parameterOrder": [ - "project", - "network" - ], - "response": { - "$ref": "Operation" + "type": "object" + } + }, + "type": "object" + }, + "RegionDiskTypeList": { + "id": "RegionDiskTypeList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of DiskType resources.", + "items": { + "$ref": "DiskType" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified network." + "type": "array" }, - "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, + "kind": { + "default": "compute#regionDiskTypeList", + "description": "Output only. [Output Only] Type of resource. Alwayscompute#regionDiskTypeList for region disk types.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. 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" } }, - "parameterOrder": [ - "project", - "network" - ], - "request": { - "$ref": "Network" + "type": "object" + } + }, + "type": "object" + }, + "RegionDiskUpdateKmsKeyRequest": { + "id": "RegionDiskUpdateKmsKeyRequest", + "properties": { + "kmsKeyName": { + "description": "Optional. The new KMS key to replace the current one on the disk. If empty, the disk\nwill be re-encrypted using the primary version of the disk's current KMS\nkey.\n\nThe KMS key can be provided in the following formats:\n \n \n - projects/project_id/locations/location/keyRings/key_ring/cryptoKeys/key\n\n\nWhere project is the project ID or\nproject number.", + "type": "string" + } + }, + "type": "object" + }, + "RegionDisksAddResourcePoliciesRequest": { + "id": "RegionDisksAddResourcePoliciesRequest", + "properties": { + "resourcePolicies": { + "description": "Resource policies to be added to this disk.", + "items": { + "type": "string" }, - "response": { - "$ref": "Operation" + "type": "array" + } + }, + "type": "object" + }, + "RegionDisksRemoveResourcePoliciesRequest": { + "id": "RegionDisksRemoveResourcePoliciesRequest", + "properties": { + "resourcePolicies": { + "description": "Resource policies to be removed from this disk.", + "items": { + "type": "string" }, - "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." + "type": "array" + } + }, + "type": "object" + }, + "RegionDisksResizeRequest": { + "id": "RegionDisksResizeRequest", + "properties": { + "sizeGb": { + "description": "The new size of the regional persistent disk, which is specified in GB.", + "format": "int64", + "type": "string" + } + }, + "type": "object" + }, + "RegionDisksStartAsyncReplicationRequest": { + "id": "RegionDisksStartAsyncReplicationRequest", + "properties": { + "asyncSecondaryDisk": { + "description": "The secondary disk to start asynchronous replication to.\nYou can provide this as a partial or full URL to the resource. For example,\nthe following are valid values:\n \n \n - \n https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk\n \n - \n https://www.googleapis.com/compute/v1/projects/project/regions/region/disks/disk\n \n - \n projects/project/zones/zone/disks/disk\n \n - \n projects/project/regions/region/disks/disk\n \n - \n zones/zone/disks/disk\n \n - \n regions/region/disks/disk", + "type": "string" + } + }, + "type": "object" + }, + "RegionInstanceGroupList": { + "description": "Contains a list of InstanceGroup resources.", + "id": "RegionInstanceGroupList", + "properties": { + "id": { + "description": "Output only. [Output Only] Unique identifier for the resource; defined by the server.", + "readOnly": true, + "type": "string" }, - "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, + "items": { + "description": "A list of InstanceGroup resources.", + "items": { + "$ref": "InstanceGroup" + }, + "type": "array" + }, + "kind": { + "default": "compute#regionInstanceGroupList", + "description": "Output only. The resource type.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "Output only. [Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "readOnly": true, + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "warning": { + "description": "Output only. [Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. 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" } }, - "parameterOrder": [ - "project", - "network" - ], - "request": { - "$ref": "NetworksUpdatePeeringRequest" + "readOnly": true, + "type": "object" + } + }, + "type": "object" + }, + "RegionInstanceGroupManagerDeleteInstanceConfigReq": { + "description": "RegionInstanceGroupManagers.deletePerInstanceConfigs", + "id": "RegionInstanceGroupManagerDeleteInstanceConfigReq", + "properties": { + "names": { + "description": "The list of instance names for which we want to delete per-instance configs\non this managed instance group.", + "items": { + "type": "string" }, - "response": { - "$ref": "Operation" + "type": "array" + } + }, + "type": "object" + }, + "RegionInstanceGroupManagerList": { + "description": "Contains a list of managed instance groups.", + "id": "RegionInstanceGroupManagerList", + "properties": { + "id": { + "description": "Output only. Unique identifier for the resource; defined by the server.", + "readOnly": true, + "type": "string" + }, + "items": { + "description": "A list of InstanceGroupManager resources.", + "items": { + "$ref": "InstanceGroupManager" }, - "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." + "type": "array" }, - "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, + "kind": { + "default": "compute#regionInstanceGroupManagerList", + "description": "Output only. The resource type, which is always compute#instanceGroupManagerList for a\nlist of managed instance groups that exist in th regional scope.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "Output only. This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "readOnly": true, + "type": "string" + }, + "selfLink": { + "description": "Output only. Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "warning": { + "description": "Output only. Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. 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" } }, - "parameterOrder": [ - "project", - "network" - ], - "request": { - "$ref": "NetworksAddPeeringRequest" + "readOnly": true, + "type": "object" + } + }, + "type": "object" + }, + "RegionInstanceGroupManagerPatchInstanceConfigReq": { + "description": "RegionInstanceGroupManagers.patchPerInstanceConfigs", + "id": "RegionInstanceGroupManagerPatchInstanceConfigReq", + "properties": { + "perInstanceConfigs": { + "description": "The list of per-instance configurations to insert or patch on this managed\ninstance group.", + "items": { + "$ref": "PerInstanceConfig" }, - "response": { - "$ref": "Operation" + "type": "array" + } + }, + "type": "object" + }, + "RegionInstanceGroupManagerResizeRequestsListResponse": { + "id": "RegionInstanceGroupManagerResizeRequestsListResponse", + "properties": { + "etag": { + "type": "string" + }, + "id": { + "description": "Output only. Unique identifier for the resource; defined by the server.", + "readOnly": true, + "type": "string" + }, + "items": { + "description": "A list of Resize Request resources.", + "items": { + "$ref": "InstanceGroupManagerResizeRequest" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Adds a peering to the specified network." + "type": "array" }, - "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, + "kind": { + "default": "compute#regionInstanceGroupManagerResizeRequestList", + "description": "Output only. Type of the resource. Alwayscompute#regionInstanceGroupManagerResizeRequestList for\na list of Resize Requests.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "Output only. This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "readOnly": true, + "type": "string" + }, + "selfLink": { + "description": "Output only. Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "unreachables": { + "description": "Output only. Unreachable resources.\nend_interface: MixerListResponseWithEtagBuilder", + "items": { + "type": "string" + }, + "readOnly": true, + "type": "array" + }, + "warning": { + "description": "Output only. Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. 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" } }, - "parameterOrder": [ - "project", - "network" - ], - "request": { - "$ref": "NetworksRemovePeeringRequest" + "readOnly": true, + "type": "object" + } + }, + "type": "object" + }, + "RegionInstanceGroupManagerUpdateInstanceConfigReq": { + "description": "RegionInstanceGroupManagers.updatePerInstanceConfigs", + "id": "RegionInstanceGroupManagerUpdateInstanceConfigReq", + "properties": { + "perInstanceConfigs": { + "description": "The list of per-instance configurations to insert or patch on this managed\ninstance group.", + "items": { + "$ref": "PerInstanceConfig" }, - "response": { - "$ref": "Operation" + "type": "array" + } + }, + "type": "object" + }, + "RegionInstanceGroupManagersAbandonInstancesRequest": { + "id": "RegionInstanceGroupManagersAbandonInstancesRequest", + "properties": { + "instances": { + "description": "The URLs of one or more instances to abandon. This can be a full URL or\na partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].", + "items": { + "type": "string" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Removes a peering from the specified network." + "type": "array" + } + }, + "type": "object" + }, + "RegionInstanceGroupManagersApplyUpdatesRequest": { + "description": "RegionInstanceGroupManagers.applyUpdatesToInstances", + "id": "RegionInstanceGroupManagersApplyUpdatesRequest", + "properties": { + "allInstances": { + "description": "Flag to update all instances instead of specified list of \"instances\".\nIf the flag is set to true then the instances may not be specified\nin the request.", + "type": "boolean" }, - "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" + "instances": { + "description": "The list of URLs of one or more instances for which you want to apply\nupdates. Each URL can be a full URL or a partial URL, such aszones/[ZONE]/instances/[INSTANCE_NAME].", + "items": { + "type": "string" }, - "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." + "type": "array" }, - "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" + "minimalAction": { + "description": "The minimal action that you want to perform on each instance during the\nupdate:\n \n \n - REPLACE: At minimum, delete the instance and create it\n again. \n - RESTART: Stop the instance and start it\n again. \n - REFRESH: Do not stop the instance and limit\n disruption as much as possible. \n - NONE: Do not\n disrupt the instance at all.\n\n\nBy default, the minimum action is NONE. If your update\nrequires a more disruptive action than you set with this flag, the\nnecessary action is performed to execute the update.", + "enum": [ + "NONE", + "REFRESH", + "REPLACE", + "RESTART" ], - "response": { - "$ref": "NetworksGetEffectiveFirewallsResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "Do not perform any action.", + "Do not stop the instance.", + "(Default.) Replace the instance according to the replacement method\noption.", + "Stop the instance and start it again." ], - "description": "Returns the effective firewalls on a given network." + "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", - "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" + "mostDisruptiveAllowedAction": { + "description": "The most disruptive action that you want to perform on each instance during\nthe update:\n \n \n - REPLACE: Delete the instance and create it again.\n - RESTART: Stop the instance and start it again.\n - REFRESH: Do not stop the instance and limit disruption\n as much as possible. \n - NONE: Do not disrupt the\n instance at all.\n\n\nBy default, the most disruptive allowed action is REPLACE. If\nyour update requires a more disruptive action than you set with this flag,\nthe update request will fail.", + "enum": [ + "NONE", + "REFRESH", + "REPLACE", + "RESTART" ], - "response": { - "$ref": "ExchangedPeeringRoutesList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "Do not perform any action.", + "Do not stop the instance.", + "(Default.) Replace the instance according to the replacement method\noption.", + "Stop the instance and start it again." ], - "description": "Lists the peering routes exchanged over peering connection." + "type": "string" } - } + }, + "type": "object" }, - "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" - } + "RegionInstanceGroupManagersCreateInstancesRequest": { + "description": "RegionInstanceGroupManagers.createInstances", + "id": "RegionInstanceGroupManagersCreateInstancesRequest", + "properties": { + "instances": { + "description": "[Required] List of specifications of per-instance configs.", + "items": { + "$ref": "PerInstanceConfig" }, - "parameterOrder": [ - "project", - "zone" - ], - "response": { - "$ref": "NodeGroupList" + "type": "array" + } + }, + "type": "object" + }, + "RegionInstanceGroupManagersDeleteInstancesRequest": { + "id": "RegionInstanceGroupManagersDeleteInstancesRequest", + "properties": { + "instances": { + "description": "The URLs of one or more instances to delete. This can be a full URL or\na partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].", + "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 node groups available to the specified project. Note: use nodeGroups.listNodes for more details about each group." + "type": "array" }, - "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" + "skipInstancesOnValidationError": { + "description": "Specifies whether the request should proceed despite the inclusion of\ninstances that are not members of the group or that are already in the\nprocess of being deleted or abandoned. If this field is set to `false` and\nsuch an instance is specified in the request, the operation fails. The\noperation always fails if the request contains a malformed instance URL or\na reference to an instance that exists in a zone or region other than the\ngroup's zone or region.", + "type": "boolean" + } + }, + "type": "object" + }, + "RegionInstanceGroupManagersListErrorsResponse": { + "id": "RegionInstanceGroupManagersListErrorsResponse", + "properties": { + "items": { + "description": "[Output Only] The list of errors of the managed instance group.", + "items": { + "$ref": "InstanceManagedByIgmError" }, - "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`." + "type": "array" }, - "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" + "nextPageToken": { + "description": "Output only. [Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "RegionInstanceGroupManagersListInstanceConfigsResp": { + "id": "RegionInstanceGroupManagersListInstanceConfigsResp", + "properties": { + "items": { + "description": "Output only. [Output Only] The list of PerInstanceConfig.", + "items": { + "$ref": "PerInstanceConfig" }, - "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." + "readOnly": true, + "type": "array" }, - "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, + "nextPageToken": { + "description": "Output only. [Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "readOnly": true, + "type": "string" + }, + "warning": { + "description": "Output only. [Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project", - "zone", - "initialNodeCount" - ], - "request": { - "$ref": "NodeGroup" + "readOnly": true, + "type": "object" + } + }, + "type": "object" + }, + "RegionInstanceGroupManagersListInstancesResponse": { + "id": "RegionInstanceGroupManagersListInstancesResponse", + "properties": { + "managedInstances": { + "description": "A list of managed instances.", + "items": { + "$ref": "ManagedInstance" }, - "response": { - "$ref": "Operation" + "type": "array" + }, + "nextPageToken": { + "description": "Output only. [Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "RegionInstanceGroupManagersRecreateRequest": { + "id": "RegionInstanceGroupManagersRecreateRequest", + "properties": { + "instances": { + "description": "The URLs of one or more instances to recreate. This can be a full URL or\na partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].", + "items": { + "type": "string" }, - "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." + "type": "array" + } + }, + "type": "object" + }, + "RegionInstanceGroupManagersResumeInstancesRequest": { + "id": "RegionInstanceGroupManagersResumeInstancesRequest", + "properties": { + "instances": { + "description": "The URLs of one or more instances to resume. This can be a full URL or\na partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, + "RegionInstanceGroupManagersSetTargetPoolsRequest": { + "id": "RegionInstanceGroupManagersSetTargetPoolsRequest", + "properties": { + "fingerprint": { + "description": "Fingerprint of the target pools information, which is a hash of the\ncontents. This field is used for optimistic locking when you update the\ntarget pool entries. This field is optional.", + "format": "byte", + "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" - } + "targetPools": { + "description": "The URL of all TargetPool resources to which instances in theinstanceGroup field are added. The target pools automatically\napply to all of the instances in the managed instance group.", + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "zone", - "nodeGroup" - ], - "response": { - "$ref": "Operation" + "type": "array" + } + }, + "type": "object" + }, + "RegionInstanceGroupManagersSetTemplateRequest": { + "id": "RegionInstanceGroupManagersSetTemplateRequest", + "properties": { + "instanceTemplate": { + "description": "URL of the InstanceTemplate resource from which all new instances will be\ncreated.", + "type": "string" + } + }, + "type": "object" + }, + "RegionInstanceGroupManagersStartInstancesRequest": { + "id": "RegionInstanceGroupManagersStartInstancesRequest", + "properties": { + "instances": { + "description": "The URLs of one or more instances to start. This can be a full URL or\na partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].", + "items": { + "type": "string" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified NodeGroup resource." + "type": "array" + } + }, + "type": "object" + }, + "RegionInstanceGroupManagersStopInstancesRequest": { + "id": "RegionInstanceGroupManagersStopInstancesRequest", + "properties": { + "forceStop": { + "description": "If this flag is set to true, the Instance Group Manager will proceed to\nstop the instances, skipping initialization on them.", + "type": "boolean" }, - "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" - } + "instances": { + "description": "The URLs of one or more instances to stop. This can be a full URL or\na partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].", + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "zone", - "nodeGroup" - ], - "request": { - "$ref": "NodeGroupsAddNodesRequest" + "type": "array" + } + }, + "type": "object" + }, + "RegionInstanceGroupManagersSuspendInstancesRequest": { + "id": "RegionInstanceGroupManagersSuspendInstancesRequest", + "properties": { + "forceSuspend": { + "description": "If this flag is set to true, the Instance Group Manager will proceed to\nsuspend the instances, skipping initialization on them.", + "type": "boolean" + }, + "instances": { + "description": "The URLs of one or more instances to suspend. This can be a full URL or\na partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].", + "items": { + "type": "string" }, - "response": { - "$ref": "Operation" + "type": "array" + } + }, + "type": "object" + }, + "RegionInstanceGroupsListInstances": { + "id": "RegionInstanceGroupsListInstances", + "properties": { + "id": { + "description": "Output only. [Output Only] Unique identifier for the resource; defined by the server.", + "readOnly": true, + "type": "string" + }, + "items": { + "description": "A list of InstanceWithNamedPorts resources.", + "items": { + "$ref": "InstanceWithNamedPorts" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Adds specified number of nodes to the node group." + "type": "array" }, - "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, + "kind": { + "default": "compute#regionInstanceGroupsListInstances", + "description": "Output only. The resource type.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "Output only. [Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "readOnly": true, + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "warning": { + "description": "Output only. [Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project", - "zone", - "nodeGroup" + "readOnly": true, + "type": "object" + } + }, + "type": "object" + }, + "RegionInstanceGroupsListInstancesRequest": { + "id": "RegionInstanceGroupsListInstancesRequest", + "properties": { + "instanceState": { + "description": "Instances in which state should be returned. Valid options are:\n'ALL', 'RUNNING'. By default, it lists all instances.", + "enum": [ + "ALL", + "RUNNING" ], - "request": { - "$ref": "NodeGroupsDeleteNodesRequest" + "enumDescriptions": [ + "Matches any status of the instances, running, non-running and others.", + "Instance is in RUNNING state if it is running." + ], + "type": "string" + }, + "portName": { + "description": "Name of port user is interested in. It is optional. If it is set, only\ninformation about this ports will be returned. If it is not set, all the\nnamed ports will be returned.\nAlways lists all instances.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + } + }, + "type": "object" + }, + "RegionInstanceGroupsSetNamedPortsRequest": { + "id": "RegionInstanceGroupsSetNamedPortsRequest", + "properties": { + "fingerprint": { + "description": "The fingerprint of the named ports information for this instance group.\nUse this optional property to prevent conflicts when multiple users change\nthe named ports settings concurrently. Obtain the fingerprint with theinstanceGroups.get\nmethod. Then, include the fingerprint in your request to ensure that you\ndo not overwrite changes that were applied from another\nconcurrent request.", + "format": "byte", + "type": "string" + }, + "namedPorts": { + "description": "The list of named ports to set for this instance group.", + "items": { + "$ref": "NamedPort" }, - "response": { - "$ref": "Operation" + "type": "array" + } + }, + "type": "object" + }, + "RegionList": { + "description": "Contains a list of region resources.", + "id": "RegionList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of Region resources.", + "items": { + "$ref": "Region" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes specified nodes from the node group." + "type": "array" }, - "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, + "kind": { + "default": "compute#regionList", + "description": "Output only. [Output Only] Type of resource. Always compute#regionList for\nlists of regions.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "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." - }, - "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" - } + "type": "object" + } + }, + "type": "object" + }, + "RegionNetworkEndpointGroupsAttachEndpointsRequest": { + "id": "RegionNetworkEndpointGroupsAttachEndpointsRequest", + "properties": { + "networkEndpoints": { + "description": "The list of network endpoints to be attached.", + "items": { + "$ref": "NetworkEndpoint" }, - "parameterOrder": [ - "project", - "zone", - "nodeGroup" - ], - "request": { - "$ref": "NodeGroupsSetNodeTemplateRequest" + "type": "array" + } + }, + "type": "object" + }, + "RegionNetworkEndpointGroupsDetachEndpointsRequest": { + "id": "RegionNetworkEndpointGroupsDetachEndpointsRequest", + "properties": { + "networkEndpoints": { + "description": "The list of network endpoints to be detached.", + "items": { + "$ref": "NetworkEndpoint" }, - "response": { - "$ref": "Operation" + "type": "array" + } + }, + "type": "object" + }, + "RegionNetworkFirewallPoliciesGetEffectiveFirewallsResponse": { + "id": "RegionNetworkFirewallPoliciesGetEffectiveFirewallsResponse", + "properties": { + "firewallPolicys": { + "description": "Output only. [Output only] Effective firewalls from firewall policy. It applies to\nRegional Network Firewall Policies in the specified region, Global Network\nFirewall Policies and Hierachial Firewall Policies which are associated\nwith the network.", + "items": { + "$ref": "RegionNetworkFirewallPoliciesGetEffectiveFirewallsResponseEffectiveFirewallPolicy" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Updates the node template of the node group." + "readOnly": true, + "type": "array" }, - "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" + "firewalls": { + "description": "Effective firewalls on the network.", + "items": { + "$ref": "Firewall" }, - "response": { - "$ref": "Operation" + "type": "array" + } + }, + "type": "object" + }, + "RegionNetworkFirewallPoliciesGetEffectiveFirewallsResponseEffectiveFirewallPolicy": { + "id": "RegionNetworkFirewallPoliciesGetEffectiveFirewallsResponseEffectiveFirewallPolicy", + "properties": { + "displayName": { + "description": "Output only. [Output Only] The display name of the firewall policy.", + "readOnly": true, + "type": "string" + }, + "name": { + "description": "Output only. [Output Only] The name of the firewall policy.", + "readOnly": true, + "type": "string" + }, + "packetMirroringRules": { + "description": "Output only. [Output only] The packet mirroring rules that apply to the network.", + "items": { + "$ref": "FirewallPolicyRule" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Updates the specified node group." + "readOnly": true, + "type": "array" }, - "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" - } + "priority": { + "description": "Output only. [Output only] Priority of firewall policy association. Not applicable for\ntype=HIERARCHY.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "rules": { + "description": "Output only. [Output only] The rules that apply to the network.", + "items": { + "$ref": "FirewallPolicyRule" }, - "parameterOrder": [ - "project", - "zone", - "nodeGroup" + "readOnly": true, + "type": "array" + }, + "type": { + "description": "Output only. [Output Only] The type of the firewall policy. Can be one of HIERARCHY,\nNETWORK, NETWORK_REGIONAL, SYSTEM_GLOBAL, SYSTEM_REGIONAL.", + "enum": [ + "HIERARCHY", + "NETWORK", + "NETWORK_REGIONAL", + "SYSTEM_GLOBAL", + "SYSTEM_REGIONAL", + "UNSPECIFIED" ], - "request": { - "$ref": "NodeGroupsSimulateMaintenanceEventRequest" + "enumDescriptions": [ + "", + "", + "", + "", + "", + "" + ], + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "RegionSetLabelsRequest": { + "id": "RegionSetLabelsRequest", + "properties": { + "labelFingerprint": { + "description": "The fingerprint of the previous set of labels for this resource,\nused to detect conflicts. The fingerprint is initially generated by Compute\nEngine and changes after every request to modify or update labels. You must\nalways provide an up-to-date fingerprint hash in order to update or change\nlabels. Make a get() request to the resource to get the latest\nfingerprint.", + "format": "byte", + "type": "string" + }, + "labels": { + "additionalProperties": { + "type": "string" }, - "response": { - "$ref": "Operation" + "description": "The labels to set for this resource.", + "type": "object" + } + }, + "type": "object" + }, + "RegionSetPolicyRequest": { + "id": "RegionSetPolicyRequest", + "properties": { + "bindings": { + "description": "Flatten Policy to create a backwacd compatible wire-format.\nDeprecated. Use 'policy' to specify bindings.", + "items": { + "$ref": "Binding" }, - "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." + "type": "array" }, - "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" - } + "etag": { + "description": "Flatten Policy to create a backward compatible wire-format.\nDeprecated. Use 'policy' to specify the etag.", + "format": "byte", + "type": "string" + }, + "policy": { + "$ref": "Policy", + "description": "REQUIRED: The complete policy to be applied to the 'resource'. The size of\nthe policy is limited to a few 10s of KB. An empty policy is in general a\nvalid policy but certain services (like Projects) might reject them." + } + }, + "type": "object" + }, + "RegionSnapshotUpdateKmsKeyRequest": { + "id": "RegionSnapshotUpdateKmsKeyRequest", + "properties": { + "kmsKeyName": { + "description": "Optional. The new KMS key to replace the current one on the snapshot. If empty, the\nsnapshot will be re-encrypted using the primary version of the snapshot's\ncurrent KMS key.\n\nThe KMS key can be provided in the following formats:\n \n \n - projects/project_id/locations/region/keyRings/region/cryptoKeys/key", + "type": "string" + } + }, + "type": "object" + }, + "RegionTargetHttpsProxiesSetSslCertificatesRequest": { + "id": "RegionTargetHttpsProxiesSetSslCertificatesRequest", + "properties": { + "sslCertificates": { + "description": "New set of SslCertificate resources to associate\nwith this TargetHttpsProxy resource.", + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "zone", - "nodeGroup" - ], - "request": { - "$ref": "NodeGroupsPerformMaintenanceRequest" + "type": "array" + } + }, + "type": "object" + }, + "RegionUrlMapsValidateRequest": { + "id": "RegionUrlMapsValidateRequest", + "properties": { + "resource": { + "$ref": "UrlMap", + "description": "Content of the UrlMap to be validated." + } + }, + "type": "object" + }, + "ReliabilityRisk": { + "description": "Represents a ReliabilityRisk resource.", + "id": "ReliabilityRisk", + "properties": { + "creationTimestamp": { + "description": "Output only. [Output Only] Creation timestamp in RFC3339\ntext format.", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "An optional textual description of the resource; provided when the\nresource is created.", + "type": "string" + }, + "details": { + "$ref": "RiskDetails", + "description": "[Output Only] Details of the reliability risk resource" + }, + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "format": "uint64", + "type": "string" + }, + "kind": { + "default": "compute#reliabilityRisk", + "description": "Output only. [Output Only] Type of resource. Always compute#reliabilityRisk\nfor reliability risks.", + "readOnly": true, + "type": "string" + }, + "name": { + "description": "Name of the resource. The name must be 1-63 characters long and\ncomply with RFC1035.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "recommendation": { + "$ref": "RiskRecommendation", + "description": "The recommendation to mitigate the risk." + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for the resource.", + "readOnly": true, + "type": "string" + }, + "selfLinkWithId": { + "description": "Output only. [Output Only] Server-defined URL for this resource with the resource id.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "ReliabilityRisksListResponse": { + "description": "Response message for the List method of ReliabilityRisksService.", + "id": "ReliabilityRisksListResponse", + "properties": { + "etag": { + "description": "[Output Only] An ETag of the resource.", + "type": "string" + }, + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of ReliabilityRisk resources.", + "items": { + "$ref": "ReliabilityRisk" }, - "response": { - "$ref": "Operation" + "type": "array" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "unreachables": { + "description": "Output only. [Output Only] Unreachable resources.\nend_interface: MixerListResponseWithEtagBuilder", + "items": { + "type": "string" }, - "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." + "readOnly": true, + "type": "array" }, - "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, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project", - "zone", - "resource" + "type": "object" + } + }, + "type": "object" + }, + "RequestMirrorPolicy": { + "description": "A policy that specifies how requests intended for the route's backends\nare shadowed to a separate mirrored backend service. The load balancer\ndoesn't wait for responses from the shadow service. Before sending traffic\nto the shadow service, the host or authority header is suffixed with-shadow.", + "id": "RequestMirrorPolicy", + "properties": { + "backendService": { + "description": "The full or partial URL to the BackendService resource being\nmirrored to.\n\nThe backend service configured for a mirroring\npolicy must reference backends that are of the same type as the original\nbackend service matched in the URL map.\n\nServerless NEG backends are not currently supported as a mirrored\nbackend service.", + "type": "string" + }, + "mirrorPercent": { + "description": "The percentage of requests to be mirrored to `backend_service`.", + "format": "double", + "type": "number" + } + }, + "type": "object" + }, + "Reservation": { + "description": "Represents a reservation resource. A reservation ensures that capacity is\nheld in a specific zone even if the reserved VMs are not running. For more\ninformation, read Reserving zonal\nresources.", + "id": "Reservation", + "properties": { + "advancedDeploymentControl": { + "$ref": "ReservationAdvancedDeploymentControl", + "description": "Advanced control for cluster management, applicable only to DENSE\ndeployment type reservations." + }, + "aggregateReservation": { + "$ref": "AllocationAggregateReservation", + "description": "Reservation for aggregated resources, providing shape flexibility." + }, + "commitment": { + "description": "Output only. [Output Only] Full or partial URL to a parent commitment. This field\ndisplays for reservations that are tied to a commitment.", + "readOnly": true, + "type": "string" + }, + "confidentialComputeType": { + "enum": [ + "CONFIDENTIAL_COMPUTE_TYPE_TDX", + "CONFIDENTIAL_COMPUTE_TYPE_UNSPECIFIED" ], - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "Intel Trust Domain Extensions.", + "" ], - "description": "Gets the access control policy for a resource. May be empty if no such policy or resource exists." + "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" + "creationTimestamp": { + "description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", + "readOnly": true, + "type": "string" + }, + "deleteAfterDuration": { + "$ref": "Duration", + "description": "Duration time relative to reservation creation when Compute Engine will\nautomatically delete this resource." + }, + "deleteAtTime": { + "description": "Absolute time in future when the reservation will be\n auto-deleted by Compute Engine. Timestamp is represented inRFC3339 text format.", + "type": "string" + }, + "deploymentType": { + "description": "Specifies the deployment strategy for this reservation.", + "enum": [ + "DENSE", + "DEPLOYMENT_TYPE_UNSPECIFIED" ], - "request": { - "$ref": "ZoneSetPolicyRequest" - }, - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "The reserved capacity is made up of densely deployed reservation blocks.", + "" ], - "description": "Sets the access control policy on the specified resource. Replaces any existing policy." + "type": "string" }, - "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" - ], - "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\ncreate the resource.", + "type": "string" + }, + "earlyAccessMaintenance": { + "description": "Indicates the early access maintenance for the reservation.\nIf this field is absent or set to NO_EARLY_ACCESS, the reservation is not\nenrolled in early access maintenance and the standard notice applies.", + "enum": [ + "NO_EARLY_ACCESS", + "WAVE1", + "WAVE2" ], - "description": "Returns permissions that a caller has on the specified resource." - } - } - }, - "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" + "enumDescriptions": [ + "No early access.", + "Wave 1: Fastest notification period", + "Wave 2: Medium notification period" ], - "response": { - "$ref": "NodeTemplateList" + "type": "string" + }, + "enableEmergentMaintenance": { + "description": "Indicates whether Compute Engine allows unplanned maintenance for your VMs;\nfor example, to fix hardware errors.", + "type": "boolean" + }, + "id": { + "description": "Output only. [Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "format": "uint64", + "readOnly": true, + "type": "string" + }, + "kind": { + "default": "compute#reservation", + "description": "Output only. [Output Only] Type of the resource. Alwayscompute#reservations for reservations.", + "readOnly": true, + "type": "string" + }, + "linkedCommitments": { + "description": "Output only. [Output Only] Full or partial URL to parent commitments. This field\ndisplays for reservations that are tied to multiple commitments.", + "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 node templates available to the specified project." + "readOnly": true, + "type": "array" }, - "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", - "format": "int64" - } + "name": { + "annotations": { + "required": [ + "compute.instances.insert" + ] }, - "parameterOrder": [ - "project" + "description": "The name of the resource, provided by the client when initially creating\nthe resource. The resource name must be 1-63 characters long, and comply\nwithRFC1035.\nSpecifically, the name must be 1-63 characters long and match the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first\ncharacter must be a lowercase letter, and all following characters must be\na dash, lowercase letter, or digit, except the last character, which cannot\nbe a dash.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "params": { + "$ref": "ReservationParams", + "description": "Input only. Additional params passed with the request, but not persisted\nas part of resource payload." + }, + "protectionTier": { + "description": "Protection tier for the workload which specifies the workload expectations\nin the event of infrastructure failures at data center (e.g. power\nand/or cooling failures).", + "enum": [ + "CAPACITY_OPTIMIZED", + "PROTECTION_TIER_UNSPECIFIED", + "STANDARD" ], - "response": { - "$ref": "NodeTemplateAggregatedList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "CAPACITY_OPTIMIZED capacity leverages redundancies (e.g. power, cooling)\nat the data center during normal operating conditions. In the event of\ninfrastructure failures at data center (e.g. power and/or cooling\nfailures), this workload may be disrupted. As a consequence, it has a\nweaker availability SLO than STANDARD.", + "Unspecified protection tier.", + "STANDARD protection for workload that should be protected by redundancies\n(e.g. power, cooling) at the data center level. In the event of\ninfrastructure failures at data center (e.g. power and/or cooling\nfailures), this workload is expected to continue as normal using the\nredundancies." ], - "description": "Retrieves an aggregated list of node templates. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." + "type": "string" }, - "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" - } + "reservationSharingPolicy": { + "$ref": "AllocationReservationSharingPolicy", + "description": "Specify the reservation sharing policy. If unspecified, the reservation\nwill not be shared with Google Cloud managed services." + }, + "resourceMetadata": { + "$ref": "ResourceMetadata", + "description": "Output only. [Output Only] Contains standard resource metadata for an Allocation\nresource. It is populated for each instance of the Allocation\nresource, and includes the api_version the\ninstance was retrieved through, and its canonical\nresource_type name.", + "readOnly": true + }, + "resourcePolicies": { + "additionalProperties": { + "type": "string" }, - "parameterOrder": [ - "project", - "region", - "nodeTemplate" + "description": "Resource policies to be added to this reservation. The key is defined by\nuser, and the value is resource policy url. This is to define placement\npolicy with reservation.", + "type": "object" + }, + "resourceStatus": { + "$ref": "AllocationResourceStatus", + "description": "Output only. [Output Only] Status information for Reservation resource.", + "readOnly": true + }, + "satisfiesPzs": { + "description": "Output only. [Output Only] Reserved for future use.", + "readOnly": true, + "type": "boolean" + }, + "schedulingType": { + "description": "The type of maintenance for the reservation.", + "enum": [ + "GROUPED", + "GROUP_MAINTENANCE_TYPE_UNSPECIFIED", + "INDEPENDENT" ], - "response": { - "$ref": "NodeTemplate" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "Maintenance on all reserved instances in the reservation is synchronized.", + "Unknown maintenance type.", + "Maintenance is not synchronized for this reservation. Instead, each\ninstance has its own maintenance window." ], - "description": "Returns the specified node template." + "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" + "selfLink": { + "description": "Output only. [Output Only] Server-defined fully-qualified URL for this resource.", + "readOnly": true, + "type": "string" + }, + "shareSettings": { + "$ref": "ShareSettings", + "description": "Specify share-settings to create a shared reservation. This property is\noptional. For more information about the syntax and options for this\nfield and its subfields, see the guide for creating\na shared reservation." + }, + "specificReservation": { + "$ref": "AllocationSpecificSKUReservation", + "description": "Reservation for instances with specific machine shapes." + }, + "specificReservationRequired": { + "description": "Indicates whether the reservation can be consumed by VMs with affinity\nfor \"any\" reservation. If the field is set, then only VMs that target\nthe reservation by name can consume from this reservation.", + "type": "boolean" + }, + "status": { + "description": "Output only. [Output Only] The status of the reservation.\n \n \n - CREATING: Reservation resources are being\n allocated.\n - READY: Reservation resources have been allocated,\n and the reservation is ready for use.\n - DELETING: Reservation deletion is in progress.\n - UPDATING: Reservation update is in progress.", + "enum": [ + "CREATING", + "DELETING", + "INVALID", + "READY", + "UPDATING" ], - "request": { - "$ref": "NodeTemplate" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "Reservation resources are being allocated.", + "Reservation deletion is in progress.", + "", + "Reservation resources have been allocated, and the reservation is ready\nfor use.", + "Reservation update is in progress." ], - "description": "Creates a NodeTemplate resource in the specified project using the data included in the request." + "readOnly": true, + "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" - }, - "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", - "nodeTemplate" + "zone": { + "description": "Zone in which the reservation resides. A zone must be provided if the\nreservation is created within a commitment.", + "type": "string" + } + }, + "type": "object" + }, + "ReservationAdvancedDeploymentControl": { + "description": "Advance control for cluster management, applicable only to DENSE deployment\ntype reservations.", + "id": "ReservationAdvancedDeploymentControl", + "properties": { + "reservationOperationalMode": { + "description": "Indicates chosen reservation operational mode for the reservation.", + "enum": [ + "ALL_CAPACITY", + "HIGHLY_AVAILABLE_CAPACITY", + "RESERVATION_OPERATIONAL_MODE_UNSPECIFIED" ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "Google Cloud does not manage the failure of machines, but provides\nadditional capacity, which is not guaranteed to be available.", + "Google Cloud manages the failure of machines to provide high\navailability.", + "" + ], + "type": "string" + } + }, + "type": "object" + }, + "ReservationAffinity": { + "description": "Specifies the reservations that this instance can consume from.", + "id": "ReservationAffinity", + "properties": { + "consumeReservationType": { + "description": "Specifies the type of reservation from which this instance can consume\nresources: ANY_RESERVATION (default),SPECIFIC_RESERVATION, or NO_RESERVATION. See\nConsuming reserved instances for examples.", + "enum": [ + "ANY_RESERVATION", + "NO_RESERVATION", + "SPECIFIC_RESERVATION", + "UNSPECIFIED" + ], + "enumDescriptions": [ + "Consume any allocation available.", + "Do not consume from any allocated capacity.", + "Must consume from a specific reservation. Must specify key value fields\nfor specifying the reservations.", + "" ], - "description": "Deletes the specified NodeTemplate resource." + "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" - } + "key": { + "description": "Corresponds to the label key of a reservation resource. To target aSPECIFIC_RESERVATION by name, specifygoogleapis.com/reservation-name as the key and specify\nthe name of your reservation as its value.", + "type": "string" + }, + "values": { + "description": "Corresponds to the label values of a reservation resource. This can be\neither a name to a reservation in the same project or\n\"projects/different-project/reservations/some-reservation-name\" to target a\nshared reservation in the same zone but in a different project.", + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "region", - "resource" - ], - "response": { - "$ref": "Policy" + "type": "array" + } + }, + "type": "object" + }, + "ReservationAggregatedList": { + "description": "Contains a list of reservations.", + "id": "ReservationAggregatedList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "additionalProperties": { + "$ref": "ReservationsScopedList", + "description": "Name of the scope containing this set of reservations." }, - "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": "A list of Allocation resources.", + "type": "object" }, - "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, + "kind": { + "default": "compute#reservationAggregatedList", + "description": "Output only. Type of resource.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "unreachables": { + "description": "Output only. [Output Only] Unreachable resources.", + "items": { + "type": "string" + }, + "readOnly": true, + "type": "array" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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" } }, - "parameterOrder": [ - "project", - "region", - "resource" + "type": "object" + } + }, + "type": "object" + }, + "ReservationBlock": { + "description": "Represents a reservation block resource.", + "id": "ReservationBlock", + "properties": { + "count": { + "description": "Output only. [Output Only] The number of resources that are allocated in this\nreservation block.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "creationTimestamp": { + "description": "Output only. [Output Only] Creation timestamp inRFC3339 text format.", + "readOnly": true, + "type": "string" + }, + "healthInfo": { + "$ref": "ReservationBlockHealthInfo", + "description": "Output only. [Output Only] Health information for the reservation block.", + "readOnly": true + }, + "id": { + "description": "Output only. [Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "format": "uint64", + "readOnly": true, + "type": "string" + }, + "inUseCount": { + "description": "Output only. [Output Only] The number of instances that are currently in use on this\nreservation block.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "inUseHostCount": { + "description": "Output only. Number of hosts currently in use. If there is one or more Instances running\non the host, it is considered in use.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "kind": { + "default": "compute#reservationBlock", + "description": "Output only. [Output Only] Type of the resource. Alwayscompute#reservationBlock for reservation blocks.", + "readOnly": true, + "type": "string" + }, + "name": { + "description": "Output only. [Output Only] The name of this reservation block generated by Google\nCompute Engine. The name must be 1-63 characters long, and comply with\nRFC1035 @pattern [a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "readOnly": true, + "type": "string" + }, + "physicalTopology": { + "$ref": "ReservationBlockPhysicalTopology", + "description": "Output only. [Output Only] The physical topology of the reservation block.", + "readOnly": true + }, + "reservationMaintenance": { + "$ref": "GroupMaintenanceInfo", + "description": "Output only. [Output Only] Maintenance information for this reservation block.", + "readOnly": true + }, + "reservationSubBlockCount": { + "description": "Output only. [Output Only] The number of reservation subBlocks associated with this\nreservation block.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "reservationSubBlockInUseCount": { + "description": "Output only. [Output Only] The number of in-use reservation subBlocks associated with\nthis reservation block. If at least one VM is running on a subBlock, it is\nconsidered in-use.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined fully-qualified URL for this resource.", + "readOnly": true, + "type": "string" + }, + "selfLinkWithId": { + "description": "Output only. [Output Only] Server-defined URL for this resource with the resource id.", + "readOnly": true, + "type": "string" + }, + "status": { + "description": "Output only. [Output Only] Status of the reservation block.", + "enum": [ + "CREATING", + "DELETING", + "INVALID", + "READY" ], - "request": { - "$ref": "RegionSetPolicyRequest" - }, - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "Resources are being allocated for the reservation block.", + "Reservation block is currently being deleted.", + "", + "Reservation block has allocated all its resources." ], - "description": "Sets the access control policy on the specified resource. Replaces any existing policy." + "readOnly": true, + "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" + "zone": { + "description": "Output only. [Output Only] Zone in which the reservation block resides.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "ReservationBlockHealthInfo": { + "description": "Health information for the reservation block.", + "id": "ReservationBlockHealthInfo", + "properties": { + "degradedSubBlockCount": { + "description": "The number of subBlocks that are degraded.", + "format": "int32", + "type": "integer" + }, + "healthStatus": { + "description": "The health status of the reservation block.", + "enum": [ + "DEGRADED", + "HEALTHY", + "HEALTH_STATUS_UNSPECIFIED" ], - "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" + "enumDescriptions": [ + "The reservation block is degraded.", + "The reservation block is healthy.", + "The health status of the reservation block is unspecified." ], - "description": "Returns permissions that a caller has on the specified resource." + "type": "string" + }, + "healthySubBlockCount": { + "description": "The number of subBlocks that are healthy.", + "format": "int32", + "type": "integer" } - } + }, + "type": "object" }, - "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, + "ReservationBlockPhysicalTopology": { + "id": "ReservationBlockPhysicalTopology", + "properties": { + "block": { + "description": "The hash of the capacity block within the cluster.", + "type": "string" + }, + "cluster": { + "description": "The cluster name of the reservation block.", + "type": "string" + }, + "instances": { + "description": "Output only. The detailed instances information for a given Block", + "items": { + "$ref": "ReservationBlockPhysicalTopologyInstance" + }, + "readOnly": true, + "type": "array" + } + }, + "type": "object" + }, + "ReservationBlockPhysicalTopologyInstance": { + "description": "The instances information for a given Block", + "id": "ReservationBlockPhysicalTopologyInstance", + "properties": { + "instanceId": { + "description": "The InstanceId of the instance", + "format": "uint64", + "type": "string" + }, + "physicalHostTopology": { + "$ref": "ReservationBlockPhysicalTopologyInstancePhysicalHostTopology", + "description": "Output only. The PhysicalHostTopology of instances within a Block resource.", + "readOnly": true + }, + "projectId": { + "description": "Project where the instance lives", + "format": "uint64", + "type": "string" + } + }, + "type": "object" + }, + "ReservationBlockPhysicalTopologyInstancePhysicalHostTopology": { + "description": "The PhysicalHostTopology of the instance within a Block resource.", + "id": "ReservationBlockPhysicalTopologyInstancePhysicalHostTopology", + "properties": { + "host": { + "description": "Host hash for a given instance", + "type": "string" + }, + "subBlock": { + "description": "Sub block hash for a given instance", + "type": "string" + } + }, + "type": "object" + }, + "ReservationBlocksGetResponse": { + "id": "ReservationBlocksGetResponse", + "properties": { + "resource": { + "$ref": "ReservationBlock" + } + }, + "type": "object" + }, + "ReservationBlocksListResponse": { + "description": "A list of reservation blocks under a single reservation.", + "id": "ReservationBlocksListResponse", + "properties": { + "id": { + "description": "Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of reservation block resources.", + "items": { + "$ref": "ReservationBlock" + }, + "type": "array" + }, + "kind": { + "default": "compute#reservationBlock", + "description": "Type of the resource. Alwayscompute#reservationBlock for a list of reservation blocks.", + "type": "string" + }, + "nextPageToken": { + "description": "This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "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." + "type": "object" + } + }, + "type": "object" + }, + "ReservationList": { + "id": "ReservationList", + "properties": { + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "type": "string" }, - "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" + "items": { + "description": "[Output Only] A list of Allocation resources.", + "items": { + "$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 an aggregated list of node types. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." + "type": "array" }, - "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, + "kind": { + "default": "compute#reservationList", + "description": "Output only. [Output Only] Type of resource.Always compute#reservationsList\nfor listsof reservations", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "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." + "type": "object" } - } + }, + "type": "object" }, - "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" + "ReservationParams": { + "description": "Additional reservation params.", + "id": "ReservationParams", + "properties": { + "resourceManagerTags": { + "additionalProperties": { + "type": "string" }, - "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." + "description": "Input only. Resource manager tags to be bound to the reservation. Tag keys and\nvalues have the same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in\nnamespaced format such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT &\nPATCH) when empty.", + "type": "object" + } + }, + "type": "object" + }, + "ReservationSlot": { + "description": "Represents a reservation slot resource.", + "id": "ReservationSlot", + "properties": { + "creationTimestamp": { + "description": "Output only. [Output Only] The creation timestamp, formatted asRFC3339 text.", + "readOnly": true, + "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" + "id": { + "description": "Output only. [Output Only] The unique identifier for this resource. This identifier is\ndefined by the server.", + "format": "uint64", + "readOnly": true, + "type": "string" + }, + "kind": { + "default": "compute#reservationSlot", + "description": "Output only. [Output Only] The type of resource. Alwayscompute#reservationSlot for reservation slots.", + "readOnly": true, + "type": "string" + }, + "name": { + "description": "Output only. [Output Only] The name of the reservation slot.", + "readOnly": true, + "type": "string" + }, + "physicalTopology": { + "$ref": "ReservationSlotPhysicalTopology", + "deprecated": true, + "description": "Output only. [Output Only] The physical topology of the reservation slot.", + "readOnly": true + }, + "selfLink": { + "description": "Output only. [Output Only] A server-defined fully-qualified URL for this resource.", + "readOnly": true, + "type": "string" + }, + "selfLinkWithId": { + "description": "Output only. [Output Only] A server-defined URL for this resource with the resource ID.", + "readOnly": true, + "type": "string" + }, + "shareSettings": { + "$ref": "ShareSettings", + "description": "Specify share settings to create a shared slot. Set to empty\nto inherit the share settings from a parent resource." + }, + "state": { + "description": "Output only. [Output Only] The state of the reservation slot.", + "enum": [ + "ACTIVE", + "CREATING", + "DELETING", + "STATE_UNSPECIFIED", + "UNAVAILABLE" ], - "response": { - "$ref": "NotificationEndpoint" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "The reservation slot has allocated all its resources.", + "The resources are being allocated for the reservation slot.", + "The reservation slot is currently being deleted.", + "", + "The reservation slot is currently unavailable." ], - "description": "Returns the specified NotificationEndpoint resource in the given region." + "readOnly": true, + "type": "string" }, - "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" + "status": { + "$ref": "ReservationSlotStatus", + "description": "Output only. [Output Only] The status of the reservation slot.", + "readOnly": true + }, + "zone": { + "description": "Output only. [Output Only] The zone in which the reservation slot resides.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "ReservationSlotPhysicalTopology": { + "id": "ReservationSlotPhysicalTopology", + "properties": { + "block": { + "description": "The unique identifier of the capacity block within the cluster.", + "type": "string" + }, + "cluster": { + "description": "The cluster name of the reservation sub-block.", + "type": "string" + }, + "host": { + "description": "The unique identifier of the capacity host within the capacity sub-block.", + "type": "string" + }, + "subBlock": { + "description": "The unique identifier of the capacity sub-block within the capacity\nblock.", + "type": "string" + } + }, + "type": "object" + }, + "ReservationSlotStatus": { + "id": "ReservationSlotStatus", + "properties": { + "physicalTopology": { + "$ref": "ReservationSlotPhysicalTopology", + "description": "Output only. [Output Only] The physical topology of the reservation sub-block.", + "readOnly": true + }, + "rdmaIpAddresses": { + "description": "Output only. The RDMA IP address of the physical host.", + "items": { + "type": "string" }, - "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." + "readOnly": true, + "type": "array" }, - "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" - } + "runningInstances": { + "description": "Output only. The URIs of the instances currently running on this slot.", + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "region", - "notificationEndpoint" - ], - "response": { - "$ref": "Operation" + "readOnly": true, + "type": "array" + } + }, + "type": "object" + }, + "ReservationSlotsGetResponse": { + "id": "ReservationSlotsGetResponse", + "properties": { + "resource": { + "$ref": "ReservationSlot" + } + }, + "type": "object" + }, + "ReservationSlotsGetVersionRequest": { + "id": "ReservationSlotsGetVersionRequest", + "properties": { + "sbomSelections": { + "description": "The SBOM selection to return. Duplicate values in the list will be ignored.", + "items": { + "enum": [ + "SBOM_SELECTION_CURRENT", + "SBOM_SELECTION_TARGET", + "SBOM_SELECTION_UNSPECIFIED" + ], + "enumDescriptions": [ + "", + "", + "" + ], + "type": "string" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified NotificationEndpoint in the given region" + "type": "array" } - } + }, + "type": "object" }, - "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" + "ReservationSlotsListResponse": { + "description": "A list of reservation slots within a single reservation.", + "id": "ReservationSlotsListResponse", + "properties": { + "id": { + "description": "The unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of reservation slot resources.", + "items": { + "$ref": "ReservationSlot" }, - "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." + "type": "array" }, - "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, + "kind": { + "default": "compute#reservationSlot", + "description": "The type of resource. Alwayscompute#reservationSlot for a list of reservation\nslots.", + "type": "string" + }, + "nextPageToken": { + "description": "This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "The server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "An informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. 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" } }, - "parameterOrder": [ - "project", - "region" + "type": "object" + } + }, + "type": "object" + }, + "ReservationSubBlock": { + "description": "Represents a reservation subBlock resource.", + "id": "ReservationSubBlock", + "properties": { + "acceleratorTopologiesInfo": { + "$ref": "AcceleratorTopologiesInfo", + "description": "Output only. [Output Only] Slice info for the reservation subBlock.", + "readOnly": true + }, + "count": { + "description": "Output only. [Output Only] The number of hosts that are allocated in this\nreservation subBlock.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "creationTimestamp": { + "description": "Output only. [Output Only] Creation timestamp inRFC3339 text format.", + "readOnly": true, + "type": "string" + }, + "healthInfo": { + "$ref": "ReservationSubBlockHealthInfo", + "description": "Output only. [Output Only] Health information for the reservation subBlock.", + "readOnly": true + }, + "id": { + "description": "Output only. [Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "format": "uint64", + "readOnly": true, + "type": "string" + }, + "inUseCount": { + "description": "Output only. [Output Only] The number of instances that are currently in use on this\nreservation subBlock.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "inUseHostCount": { + "description": "Output only. Number of hosts currently in use. If there is one or more Instances running\non the host, it is considered in use.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "kind": { + "default": "compute#reservationSubBlock", + "description": "Output only. [Output Only] Type of the resource. Alwayscompute#reservationSubBlock for reservation subBlocks.", + "readOnly": true, + "type": "string" + }, + "name": { + "description": "Output only. [Output Only] The name of this reservation subBlock generated by Google\nCompute Engine. The name must be 1-63 characters long, and comply with\nRFC1035 @pattern [a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "readOnly": true, + "type": "string" + }, + "physicalTopology": { + "$ref": "ReservationSubBlockPhysicalTopology", + "description": "Output only. [Output Only] The physical topology of the reservation subBlock.", + "readOnly": true + }, + "reservationSubBlockMaintenance": { + "$ref": "GroupMaintenanceInfo", + "description": "Output only. Maintenance information for this reservation subBlock.", + "readOnly": true + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined fully-qualified URL for this resource.", + "readOnly": true, + "type": "string" + }, + "selfLinkWithId": { + "description": "Output only. [Output Only] Server-defined URL for this resource with the resource id.", + "readOnly": true, + "type": "string" + }, + "status": { + "description": "Output only. [Output Only] Status of the reservation subBlock.", + "enum": [ + "CREATING", + "DELETING", + "INVALID", + "READY" ], - "request": { - "$ref": "PacketMirroring" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "Resources are being allocated for the reservation subBlock.", + "Reservation subBlock is currently being deleted.", + "", + "Reservation subBlock has allocated all its resources." ], - "description": "Creates a PacketMirroring resource in the specified project and region using the data included in the request." + "readOnly": true, + "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" + "zone": { + "description": "Output only. [Output Only] Zone in which the reservation subBlock resides.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "ReservationSubBlockHealthInfo": { + "description": "Health information for the reservation subBlock.", + "id": "ReservationSubBlockHealthInfo", + "properties": { + "degradedHostCount": { + "description": "The number of degraded hosts in the reservation subBlock.", + "format": "int32", + "type": "integer" + }, + "degradedInfraCount": { + "description": "The number of degraded infrastructure (e.g NV link domain) in the\nreservation subblock.", + "format": "int32", + "type": "integer" + }, + "healthStatus": { + "description": "The health status of the reservation subBlock.", + "enum": [ + "DEGRADED", + "HEALTHY", + "HEALTH_STATUS_UNSPECIFIED" ], - "request": { - "$ref": "PacketMirroring" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "The reservation subBlock is degraded.", + "The reservation subBlock is healthy.", + "The health status of the reservation subBlock is unspecified." ], - "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." + "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" - } + "healthyHostCount": { + "description": "The number of healthy hosts in the reservation subBlock.", + "format": "int32", + "type": "integer" + }, + "healthyInfraCount": { + "description": "The number of healthy infrastructure (e.g NV link domain) in the\nreservation subblock.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, + "ReservationSubBlockPhysicalTopology": { + "id": "ReservationSubBlockPhysicalTopology", + "properties": { + "block": { + "description": "The hash of the capacity block within the cluster.", + "type": "string" + }, + "cluster": { + "description": "The cluster name of the reservation subBlock.", + "type": "string" + }, + "subBlock": { + "description": "The hash of the capacity sub-block within the capacity block.", + "type": "string" + } + }, + "type": "object" + }, + "ReservationSubBlocksGetResponse": { + "id": "ReservationSubBlocksGetResponse", + "properties": { + "resource": { + "$ref": "ReservationSubBlock" + } + }, + "type": "object" + }, + "ReservationSubBlocksGetVersionRequest": { + "id": "ReservationSubBlocksGetVersionRequest", + "properties": { + "sbomSelections": { + "description": "The SBOM selection to return.", + "items": { + "enum": [ + "SBOM_SELECTION_CURRENT", + "SBOM_SELECTION_TARGET", + "SBOM_SELECTION_UNSPECIFIED" + ], + "enumDescriptions": [ + "", + "", + "" + ], + "type": "string" }, - "parameterOrder": [ - "project", - "region", - "packetMirroring" - ], - "response": { - "$ref": "Operation" + "type": "array" + } + }, + "type": "object" + }, + "ReservationSubBlocksListResponse": { + "description": "A list of reservation subBlocks under a single reservation.", + "id": "ReservationSubBlocksListResponse", + "properties": { + "id": { + "description": "Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of reservation subBlock resources.", + "items": { + "$ref": "ReservationSubBlock" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified PacketMirroring resource." + "type": "array" }, - "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, + "kind": { + "default": "compute#reservationSubBlock", + "description": "Type of the resource. Alwayscompute#reservationSubBlock for a list of reservation\nsubBlocks.", + "type": "string" + }, + "nextPageToken": { + "description": "This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" + "message": { + "description": "[Output Only] A human-readable description of the warning code.", + "type": "string" } }, - "parameterOrder": [ - "project", - "region" + "type": "object" + } + }, + "type": "object" + }, + "ReservationSubBlocksReportFaultyRequest": { + "id": "ReservationSubBlocksReportFaultyRequest", + "properties": { + "disruptionSchedule": { + "description": "The disruption schedule for the subBlock.", + "enum": [ + "DISRUPTION_SCHEDULE_UNSPECIFIED", + "IMMEDIATE" ], - "response": { - "$ref": "PacketMirroringList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "", + "All VMs will be disrupted immediately." ], - "description": "Retrieves a list of PacketMirroring resources available to the specified project and region." + "type": "string" }, - "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" + "failureComponent": { + "description": "The component that experienced the fault.", + "enum": [ + "FAILURE_COMPONENT_UNSPECIFIED", + "MULTIPLE_FAULTY_HOSTS", + "NVLINK_SWITCH" ], - "response": { - "$ref": "PacketMirroringAggregatedList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "", + "Multiple hosts experienced the fault.", + "The NVLink switch experienced the fault." ], - "description": "Retrieves an aggregated list of packetMirrorings. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." + "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" - }, - "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" - } + "faultReasons": { + "description": "The reasons for the fault experienced with the subBlock.", + "items": { + "$ref": "ReservationSubBlocksReportFaultyRequestFaultReason" }, - "parameterOrder": [ - "project", - "region", - "resource" + "type": "array" + } + }, + "type": "object" + }, + "ReservationSubBlocksReportFaultyRequestFaultReason": { + "description": "The reason for the fault experienced with the subBlock.", + "id": "ReservationSubBlocksReportFaultyRequestFaultReason", + "properties": { + "behavior": { + "description": "The behavior of the fault experienced with the subBlock.", + "enum": [ + "FAULT_BEHAVIOR_UNSPECIFIED", + "GPU_ERROR", + "PERFORMANCE", + "SILENT_DATA_CORRUPTION", + "SWITCH_FAILURE" ], - "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" + "enumDescriptions": [ + "", + "The subBlock experienced a GPU error.", + "The subBlock experienced performance issues.", + "The subBlock experienced silent data corruption.", + "The subBlock experienced a switch failure." ], - "description": "Returns permissions that a caller has on the specified resource." + "type": "string" + }, + "description": { + "description": "The description of the fault experienced with the subBlock.", + "type": "string" } - } + }, + "type": "object" }, - "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" + "ReservationsBlocksPerformMaintenanceRequest": { + "id": "ReservationsBlocksPerformMaintenanceRequest", + "properties": { + "maintenanceScope": { + "description": "Specifies if all, running or unused hosts are in scope for this request.", + "enum": [ + "ALL", + "MAINTENANCE_SCOPE_UNSPECIFIED", + "RUNNING_VMS", + "UNUSED_CAPACITY" ], - "response": { - "$ref": "Project" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "Trigger maintenance for all hosts belonging to this reservation\nirrespective of whether VMs are running on them or not.", + "Internal only", + "Trigger maintenance only on the hosts belonging to this reservation which\nhave VMs running on them.", + "Trigger maintenance only on the hosts belonging to this reservation which\ndo not have any VMs running on them. This is not allowed for Standard ExR" ], - "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." - }, - "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" + "type": "string" + } + }, + "type": "object" + }, + "ReservationsPerformMaintenanceRequest": { + "id": "ReservationsPerformMaintenanceRequest", + "properties": { + "maintenanceScope": { + "description": "Specifies if all, running or unused hosts are in scope for this request.", + "enum": [ + "ALL", + "MAINTENANCE_SCOPE_UNSPECIFIED", + "RUNNING_VMS", + "UNUSED_CAPACITY" ], - "request": { - "$ref": "Metadata" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "Trigger maintenance for all hosts belonging to this reservation\nirrespective of whether VMs are running on them or not.", + "Internal only", + "Trigger maintenance only on the hosts belonging to this reservation which\nhave VMs running on them.", + "Trigger maintenance only on the hosts belonging to this reservation which\ndo not have any VMs running on them. This is not allowed for Standard ExR" ], - "description": "Sets metadata common to all instances within the specified project using the data included in the request." + "type": "string" + } + }, + "type": "object" + }, + "ReservationsResizeRequest": { + "id": "ReservationsResizeRequest", + "properties": { + "specificSkuCount": { + "description": "Number of allocated resources can be resized with minimum = 1 and\nmaximum = 1000.", + "format": "int64", + "type": "string" + } + }, + "type": "object" + }, + "ReservationsScopedList": { + "id": "ReservationsScopedList", + "properties": { + "reservations": { + "description": "A list of reservations contained in this scope.", + "items": { + "$ref": "Reservation" + }, + "type": "array" }, - "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, + "warning": { + "description": "Informational warning which replaces the list of reservations when\nthe list is empty.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", + "data": { + "description": "[Output Only] Metadata about this warning in key:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" + }, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project" + "type": "object" + } + }, + "type": "object" + }, + "ResourceCommitment": { + "description": "Commitment for a particular hardware resource (a commitment is composed of\none or more of these).", + "id": "ResourceCommitment", + "properties": { + "acceleratorType": { + "description": "Name of the accelerator type or GPU resource. Specify this field only when\nthe type of hardware resource is ACCELERATOR.", + "type": "string" + }, + "amount": { + "description": "The quantity of the hardware resource that you want to commit to purchasing\n(in a type-dependent unit).\n \n - For vCPUs, you must specify an integer value.\n - For memory, you specify the amount of MB that you want. The value you\n specify must be a multiple of 256 MB, with up to 6.5 GB of\n memory per every vCPU.\n - For GPUs, you must specify an integer value.\n - For Local SSD disks, you must specify the amount in GB. The size of a\n single Local SSD disk is 375 GB.", + "format": "int64", + "type": "string" + }, + "type": { + "description": "The type of hardware resource that you want to specify.\nYou can specify any of the following values:\n \n - VCPU\n - MEMORY\n - LOCAL_SSD\n - ACCELERATOR\n\n\n\nSpecify as a separate entry in the list for each\nindividual resource type.", + "enum": [ + "ACCELERATOR", + "LOCAL_SSD", + "MEMORY", + "UNSPECIFIED", + "VCPU" ], - "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" + "enumDescriptions": [ + "", + "", + "", + "", + "" ], - "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." + "type": "string" + } + }, + "type": "object" + }, + "ResourceGroupReference": { + "id": "ResourceGroupReference", + "properties": { + "group": { + "description": "A URI referencing one of the instance groups or network endpoint groups\nlisted in the backend service.", + "type": "string" + } + }, + "type": "object" + }, + "ResourceMetadata": { + "description": "Standardized resource metadata common to all compute resources.", + "id": "ResourceMetadata", + "properties": { + "apiVersion": { + "description": "The version of the API interface that this resource was retrieved through.\nFor example, `\"2025-01-01\"` or `\"2025-01-01-preview\"`.", + "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, + "resourceType": { + "description": "The canonical resource type name in the format of a resource type\nas defined by [AIP-123](https://google.aip.dev/123).\nFor example, `\"compute.googleapis.com/Instance\"`.", + "type": "string" + } + }, + "type": "object" + }, + "ResourcePoliciesScopedList": { + "id": "ResourcePoliciesScopedList", + "properties": { + "resourcePolicies": { + "description": "A list of resourcePolicies contained in this scope.", + "items": { + "$ref": "ResourcePolicy" + }, + "type": "array" + }, + "warning": { + "description": "Informational warning which replaces the list of resourcePolicies when\nthe list is empty.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", + "data": { + "description": "[Output Only] Metadata about this warning in key:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" + }, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "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." + "type": "object" + } + }, + "type": "object" + }, + "ResourcePolicy": { + "description": "Represents a Resource Policy resource. You can use resource policies to\nschedule actions for some Compute Engine resources. For example, you can\nuse them toschedule persistent disk\nsnapshots.", + "id": "ResourcePolicy", + "properties": { + "creationTimestamp": { + "description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", + "readOnly": true, + "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" - } + "description": { + "type": "string" + }, + "diskConsistencyGroupPolicy": { + "$ref": "ResourcePolicyDiskConsistencyGroupPolicy", + "description": "Resource policy for disk consistency groups." + }, + "groupPlacementPolicy": { + "$ref": "ResourcePolicyGroupPlacementPolicy", + "description": "Resource policy for instances for placement configuration." + }, + "id": { + "description": "Output only. [Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "format": "uint64", + "readOnly": true, + "type": "string" + }, + "instanceSchedulePolicy": { + "$ref": "ResourcePolicyInstanceSchedulePolicy", + "description": "Resource policy for scheduling instance operations." + }, + "kind": { + "default": "compute#resourcePolicy", + "description": "Output only. [Output Only] Type of the resource. Alwayscompute#resource_policies for resource policies.", + "readOnly": true, + "type": "string" + }, + "name": { + "annotations": { + "required": [ + "compute.instances.insert" + ] }, - "parameterOrder": [ - "project" + "description": "The name of the resource, provided by the client when initially creating\nthe resource. The resource name must be 1-63 characters long, and comply\nwithRFC1035.\nSpecifically, the name must be 1-63 characters long and match the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first\ncharacter must be a lowercase letter, and all following characters must be\na dash, lowercase letter, or digit, except the last character, which cannot\nbe a dash.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "region": { + "readOnly": true, + "type": "string" + }, + "resourceStatus": { + "$ref": "ResourcePolicyResourceStatus", + "description": "Output only. [Output Only] The system status of the resource policy.", + "readOnly": true + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined fully-qualified URL for this resource.", + "readOnly": true, + "type": "string" + }, + "snapshotSchedulePolicy": { + "$ref": "ResourcePolicySnapshotSchedulePolicy", + "description": "Resource policy for persistent disks for creating snapshots." + }, + "status": { + "description": "Output only. [Output Only] The status of resource policy creation.", + "enum": [ + "CREATING", + "DELETING", + "EXPIRED", + "INVALID", + "READY" ], - "request": { - "$ref": "DiskMoveRequest" + "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." + ], + "readOnly": true, + "type": "string" + }, + "workloadPolicy": { + "$ref": "ResourcePolicyWorkloadPolicy", + "description": "Resource policy for defining instance placement for MIGs." + } + }, + "type": "object" + }, + "ResourcePolicyAggregatedList": { + "description": "Contains a list of resourcePolicies.", + "id": "ResourcePolicyAggregatedList", + "properties": { + "etag": { + "type": "string" + }, + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "additionalProperties": { + "$ref": "ResourcePoliciesScopedList", + "description": "Name of the scope containing this set of resourcePolicies." }, - "response": { - "$ref": "Operation" + "description": "A list of ResourcePolicy resources.", + "type": "object" + }, + "kind": { + "default": "compute#resourcePolicyAggregatedList", + "description": "Output only. Type of resource.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "unreachables": { + "description": "Output only. [Output Only] Unreachable resources.", + "items": { + "type": "string" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Moves a persistent disk from one zone to another." + "readOnly": true, + "type": "array" }, - "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", + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "pageToken": { - "description": "Specifies a page token 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{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" } }, - "parameterOrder": [ - "project" + "type": "object" + } + }, + "type": "object" + }, + "ResourcePolicyDailyCycle": { + "description": "Time window specified for daily operations.", + "id": "ResourcePolicyDailyCycle", + "properties": { + "daysInCycle": { + "description": "Defines a schedule with units measured in days. The value determines\nhow many days pass between the start of each cycle.", + "format": "int32", + "type": "integer" + }, + "duration": { + "description": "Output only. [Output only] A predetermined duration for the window, automatically\nchosen to be the smallest possible in the given scenario.", + "readOnly": true, + "type": "string" + }, + "startTime": { + "description": "Start time of the window. This must be in UTC format that resolves to one\nof 00:00, 04:00, 08:00,12:00, 16:00, or 20:00. For\nexample, both 13:00-5 and 08:00 are valid.", + "type": "string" + } + }, + "type": "object" + }, + "ResourcePolicyDiskConsistencyGroupPolicy": { + "description": "Resource policy for disk consistency groups.", + "id": "ResourcePolicyDiskConsistencyGroupPolicy", + "properties": {}, + "type": "object" + }, + "ResourcePolicyGroupPlacementPolicy": { + "description": "A GroupPlacementPolicy specifies resource placement configuration.\nIt specifies the failure bucket separation", + "id": "ResourcePolicyGroupPlacementPolicy", + "properties": { + "acceleratorTopologyMode": { + "description": "Specifies the connection mode for the accelerator topology. If not\nspecified, the default is AUTO_CONNECT.", + "enum": [ + "AUTO_CONNECT", + "PROVISION_ONLY" ], - "request": { - "$ref": "ProjectsListXpnHostsRequest" - }, - "response": { - "$ref": "XpnHostList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "The interconnected chips are pre-configured at the time of VM creation.", + "The interconnected chips are connected on demand. At the time of VM\ncreation, the chips are not connected." ], - "description": "Lists all shared VPC host projects visible to the user in an organization." + "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" + "availabilityDomainCount": { + "description": "The number of availability domains to spread instances across. If two\ninstances are in different availability domain, they are not in the same\nlow latency network.", + "format": "int32", + "type": "integer" + }, + "collocation": { + "description": "Specifies network collocation", + "enum": [ + "COLLOCATED", + "UNSPECIFIED_COLLOCATION" ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "", + "" ], - "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, + "gpuTopology": { + "description": "Specifies the shape of the GPU slice, in slice based GPU families eg.\nA4X.", + "type": "string" + }, + "vmCount": { + "description": "Number of VMs in this placement group. Google does not recommend that you\nuse this field unless you use a compact policy and you want your policy\nto work only if it contains this exact number of VMs.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, + "ResourcePolicyHourlyCycle": { + "description": "Time window specified for hourly operations.", + "id": "ResourcePolicyHourlyCycle", + "properties": { + "duration": { + "description": "Output only. [Output only] Duration of the time window, automatically chosen to be\nsmallest possible in the given scenario.", + "readOnly": true, + "type": "string" + }, + "hoursInCycle": { + "description": "Defines a schedule with units measured in hours. The value determines\nhow many hours pass between the start of each cycle.", + "format": "int32", + "type": "integer" + }, + "startTime": { + "description": "Time within the window to start the operations.\nIt must be in format \"HH:MM\", where HH : [00-23] and MM : [00-00] GMT.", + "type": "string" + } + }, + "type": "object" + }, + "ResourcePolicyInstanceSchedulePolicy": { + "description": "An InstanceSchedulePolicy specifies when and how frequent certain\noperations are performed on the instance.", + "id": "ResourcePolicyInstanceSchedulePolicy", + "properties": { + "expirationTime": { + "description": "The expiration time of the schedule. The timestamp is an RFC3339 string.", + "type": "string" + }, + "startTime": { + "description": "The start time of the schedule. The timestamp is an RFC3339 string.", + "type": "string" + }, + "timeZone": { + "description": "Specifies the time zone to be used in interpreting Schedule.schedule.\nThe value of this field must be a time zone name from the tz database:\nhttps://wikipedia.org/wiki/Tz_database.", + "type": "string" + }, + "vmStartSchedule": { + "$ref": "ResourcePolicyInstanceSchedulePolicySchedule", + "description": "Specifies the schedule for starting instances." + }, + "vmStopSchedule": { + "$ref": "ResourcePolicyInstanceSchedulePolicySchedule", + "description": "Specifies the schedule for stopping instances." + } + }, + "type": "object" + }, + "ResourcePolicyInstanceSchedulePolicySchedule": { + "description": "Schedule for an instance operation.", + "id": "ResourcePolicyInstanceSchedulePolicySchedule", + "properties": { + "schedule": { + "description": "Specifies the frequency for the operation, using the unix-cron format.", + "type": "string" + } + }, + "type": "object" + }, + "ResourcePolicyList": { + "id": "ResourcePolicyList", + "properties": { + "etag": { + "type": "string" + }, + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "type": "string" + }, + "items": { + "description": "[Output Only] A list of ResourcePolicy resources.", + "items": { + "$ref": "ResourcePolicy" + }, + "type": "array" + }, + "kind": { + "default": "compute#resourcePolicyList", + "description": "Output only. [Output Only] Type of resource.Alwayscompute#resourcePoliciesList for listsof resourcePolicies", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must 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." - }, - "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" + "data": { + "description": "[Output Only] Metadata about this warning in key:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. 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" } }, - "parameterOrder": [ - "project" + "type": "object" + } + }, + "type": "object" + }, + "ResourcePolicyResourceStatus": { + "description": "Contains output only fields.\nUse this sub-message for all output fields set on ResourcePolicy.\nThe internal structure of this \"status\" field should mimic the structure\nof ResourcePolicy proto specification.", + "id": "ResourcePolicyResourceStatus", + "properties": { + "instanceSchedulePolicy": { + "$ref": "ResourcePolicyResourceStatusInstanceSchedulePolicyStatus", + "description": "Output only. [Output Only] Specifies a set of output values reffering to\nthe instance_schedule_policy system status.\nThis field should have the same name as corresponding policy field.", + "readOnly": true + } + }, + "type": "object" + }, + "ResourcePolicyResourceStatusInstanceSchedulePolicyStatus": { + "id": "ResourcePolicyResourceStatusInstanceSchedulePolicyStatus", + "properties": { + "lastRunStartTime": { + "description": "Output only. [Output Only] The last time the schedule successfully ran.\nThe timestamp is an RFC3339 string.", + "readOnly": true, + "type": "string" + }, + "nextRunStartTime": { + "description": "Output only. [Output Only] The next time the schedule is planned to run.\nThe actual time might be slightly different.\nThe timestamp is an RFC3339 string.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "ResourcePolicySnapshotSchedulePolicy": { + "description": "A snapshot schedule policy specifies when and how frequently snapshots are\nto be created for the target disk. Also specifies how many and how long\nthese scheduled snapshots should be retained.", + "id": "ResourcePolicySnapshotSchedulePolicy", + "properties": { + "retentionPolicy": { + "$ref": "ResourcePolicySnapshotSchedulePolicyRetentionPolicy", + "description": "Retention policy applied to snapshots created by this resource policy." + }, + "schedule": { + "$ref": "ResourcePolicySnapshotSchedulePolicySchedule", + "description": "A Vm Maintenance Policy specifies what kind of infrastructure\nmaintenance we are allowed to perform on this VM and when. Schedule\nthat is applied to disks covered by this policy." + }, + "snapshotProperties": { + "$ref": "ResourcePolicySnapshotSchedulePolicySnapshotProperties", + "description": "Properties with which snapshots are created such as labels, encryption\nkeys." + } + }, + "type": "object" + }, + "ResourcePolicySnapshotSchedulePolicyRetentionPolicy": { + "description": "Policy for retention of scheduled snapshots.", + "id": "ResourcePolicySnapshotSchedulePolicyRetentionPolicy", + "properties": { + "maxRetentionDays": { + "description": "Maximum age of the snapshot that is allowed to be kept.", + "format": "int32", + "type": "integer" + }, + "onSourceDiskDelete": { + "description": "Specifies the behavior to apply to scheduled snapshots when\nthe source disk is deleted.", + "enum": [ + "APPLY_RETENTION_POLICY", + "KEEP_AUTO_SNAPSHOTS", + "UNSPECIFIED_ON_SOURCE_DISK_DELETE" ], - "request": { - "$ref": "ProjectsEnableXpnResourceRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "", + "", + "" ], - "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": "string" + } + }, + "type": "object" + }, + "ResourcePolicySnapshotSchedulePolicySchedule": { + "description": "A schedule for disks where the schedueled operations are performed.", + "id": "ResourcePolicySnapshotSchedulePolicySchedule", + "properties": { + "dailySchedule": { + "$ref": "ResourcePolicyDailyCycle" }, - "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" + "hourlySchedule": { + "$ref": "ResourcePolicyHourlyCycle" + }, + "weeklySchedule": { + "$ref": "ResourcePolicyWeeklyCycle" + } + }, + "type": "object" + }, + "ResourcePolicySnapshotSchedulePolicySnapshotProperties": { + "description": "Specified snapshot properties for scheduled snapshots created by this\npolicy.", + "id": "ResourcePolicySnapshotSchedulePolicySnapshotProperties", + "properties": { + "chainName": { + "description": "Chain name that the snapshot is created in.", + "type": "string" + }, + "guestFlush": { + "description": "Indication to perform a 'guest aware' snapshot.", + "type": "boolean" + }, + "labels": { + "additionalProperties": { + "type": "string" }, - "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." + "description": "Labels to apply to scheduled snapshots. These can be later modified\nby the setLabels method. Label values may be empty.", + "type": "object" }, - "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" - } + "storageLocations": { + "description": "Cloud Storage bucket storage location of the auto snapshot (regional or\nmulti-regional).", + "items": { + "type": "string" }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "Project" + "type": "array" + } + }, + "type": "object" + }, + "ResourcePolicyWeeklyCycle": { + "description": "Time window specified for weekly operations.", + "id": "ResourcePolicyWeeklyCycle", + "properties": { + "dayOfWeeks": { + "description": "Up to 7 intervals/windows, one for each day of the week.", + "items": { + "$ref": "ResourcePolicyWeeklyCycleDayOfWeek" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "type": "array" + } + }, + "type": "object" + }, + "ResourcePolicyWeeklyCycleDayOfWeek": { + "id": "ResourcePolicyWeeklyCycleDayOfWeek", + "properties": { + "day": { + "description": "Defines a schedule that runs on specific days of the week. Specify\none or more days. The following options are available:\nMONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.", + "enum": [ + "FRIDAY", + "INVALID", + "MONDAY", + "SATURDAY", + "SUNDAY", + "THURSDAY", + "TUESDAY", + "WEDNESDAY" + ], + "enumDescriptions": [ + "", + "", + "", + "", + "", + "", + "", + "" ], - "description": "Gets the shared VPC host project that this project links to. May be empty if no link exists." + "type": "string" }, - "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" + "duration": { + "description": "Output only. [Output only] Duration of the time window, automatically chosen to be\nsmallest possible in the given scenario.", + "readOnly": true, + "type": "string" + }, + "startTime": { + "description": "Time within the window to start the operations.\nIt must be in format \"HH:MM\", where HH : [00-23] and MM : [00-00] GMT.", + "type": "string" + } + }, + "type": "object" + }, + "ResourcePolicyWorkloadPolicy": { + "description": "Represents the workload policy.", + "id": "ResourcePolicyWorkloadPolicy", + "properties": { + "acceleratorTopology": { + "description": "Specifies the topology required to create a partition for VMs that have\ninterconnected GPUs.", + "type": "string" + }, + "acceleratorTopologyMode": { + "description": "Specifies the connection mode for the accelerator topology. If not\nspecified, the default is AUTO_CONNECT.", + "enum": [ + "AUTO_CONNECT", + "PROVISION_ONLY" ], - "response": { - "$ref": "ProjectsGetXpnResources" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "The interconnected chips are pre-configured at the time of VM creation.", + "The interconnected chips are connected on demand. At the time of VM\ncreation, the chips are not connected." ], - "description": "Gets service resources (a.k.a service project) associated with this host project." + "type": "string" }, - "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" + "maxTopologyDistance": { + "description": "Specifies the maximum distance between instances.", + "enum": [ + "BLOCK", + "CLUSTER", + "SUBBLOCK" ], - "request": { - "$ref": "ProjectsSetDefaultNetworkTierRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "VMs must be provisioned in the same block.", + "VMs must be provisioned in the same cluster.", + "VMs must be provisioned in the same subblock." ], - "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." + "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" - } - }, - "parameterOrder": [ - "project" + "type": { + "description": "Specifies the intent of the instance placement in the MIG.", + "enum": [ + "HIGH_AVAILABILITY", + "HIGH_THROUGHPUT" ], - "request": { - "$ref": "ProjectsSetCloudArmorTierRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "MIG spreads out the instances as much as possible for high availability.", + "MIG provisions instances as close to each other as possible for high\nthroughput." ], - "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." + "type": "string" } - } + }, + "type": "object" }, - "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" + "ResourceStatus": { + "description": "Contains output only fields.\nUse this sub-message for actual values set on Instance attributes as compared\nto the value requested by the user (intent) in their instance CRUD calls.", + "id": "ResourceStatus", + "properties": { + "effectiveInstanceMetadata": { + "$ref": "ResourceStatusEffectiveInstanceMetadata", + "description": "Output only. [Output Only] Effective metadata is a field that consolidates project,\nzonal instance settings, and instance-level predefined metadata keys to\nprovide the overridden value for those metadata keys at the instance level.", + "readOnly": true + }, + "physicalHost": { + "description": "Output only. [Output Only] The precise location of your instance within the zone's data\ncenter, including the block, sub-block, and host. The field is formatted as\nfollows: blockId/subBlockId/hostId.", + "readOnly": true, + "type": "string" + }, + "physicalHostTopology": { + "$ref": "ResourceStatusPhysicalHostTopology", + "description": "Output only. [Output Only] A series of fields containing the global name of the Compute\nEngine cluster, as well as the ID of the block, sub-block, and host on\nwhich the running instance is located.", + "readOnly": true + }, + "reservationConsumptionInfo": { + "$ref": "ResourceStatusReservationConsumptionInfo", + "description": "Output only. [Output Only] Reservation information that the instance is consuming from.", + "readOnly": true + }, + "scheduling": { + "$ref": "ResourceStatusScheduling" + }, + "shutdownDetails": { + "$ref": "ResourceStatusShutdownDetails", + "description": "Output only. [Output Only] Details about the instance stopping state.", + "readOnly": true + }, + "upcomingMaintenance": { + "$ref": "UpcomingMaintenance", + "readOnly": true + } + }, + "type": "object" + }, + "ResourceStatusEffectiveInstanceMetadata": { + "description": "Effective values of predefined metadata keys for an instance.", + "id": "ResourceStatusEffectiveInstanceMetadata", + "properties": { + "blockProjectSshKeysMetadataValue": { + "description": "Effective block-project-ssh-keys value at Instance level.", + "type": "boolean" + }, + "enableGuestAttributesMetadataValue": { + "description": "Effective enable-guest-attributes value at Instance level.", + "type": "boolean" + }, + "enableOsInventoryMetadataValue": { + "description": "Effective enable-os-inventory value at Instance level.", + "type": "boolean" + }, + "enableOsconfigMetadataValue": { + "description": "Effective enable-osconfig value at Instance level.", + "type": "boolean" + }, + "enableOsloginMetadataValue": { + "description": "Effective enable-oslogin value at Instance level.", + "type": "boolean" + }, + "gceContainerDeclarationMetadataValue": { + "description": "Effective gce-container-declaration value at Instance level.", + "type": "boolean" + }, + "serialPortEnableMetadataValue": { + "description": "Effective serial-port-enable value at Instance level.", + "type": "boolean" + }, + "serialPortLoggingEnableMetadataValue": { + "description": "Effective serial-port-logging-enable value at Instance level.", + "type": "boolean" + }, + "vmDnsSettingMetadataValue": { + "description": "Effective VM DNS setting at Instance level.", + "type": "string" + } + }, + "type": "object" + }, + "ResourceStatusPhysicalHostTopology": { + "description": "Represents the physical host topology of the host on which the VM is\nrunning.", + "id": "ResourceStatusPhysicalHostTopology", + "properties": { + "additionalAttributes": { + "$ref": "ResourceStatusPhysicalHostTopologyAdditionalAttributes", + "description": "Output only. [Output Only] Additional location information of the running instance.", + "readOnly": true + }, + "block": { + "description": "[Output Only] The ID of the block in which the running instance is\nlocated. Instances within the same block experience low network latency.", + "type": "string" + }, + "cluster": { + "description": "[Output Only] The global name of the Compute Engine cluster where the\nrunning instance is located.", + "type": "string" + }, + "host": { + "description": "[Output Only] The ID of the host on which the running instance is located.\nInstances on the same host experience the lowest possible network\nlatency.", + "type": "string" + }, + "subblock": { + "description": "[Output Only] The ID of the sub-block in which the running instance is\nlocated. Instances in the same sub-block experience lower network latency\nthan instances in the same block.", + "type": "string" + } + }, + "type": "object" + }, + "ResourceStatusPhysicalHostTopologyAdditionalAttributes": { + "description": "Additional location information of the running instance.", + "id": "ResourceStatusPhysicalHostTopologyAdditionalAttributes", + "properties": { + "acceleratorTopologyIds": { + "additionalProperties": { + "type": "string" }, - "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." + "description": "Output only. The IDs of the accelerator topologies the instance belongs to. For\nexample\nThe key will be topologies like \"4x4\", \"2x2x2\" and the value will be\nthe location ID of the topologies.", + "readOnly": true, + "type": "object" + } + }, + "type": "object" + }, + "ResourceStatusReservationConsumptionInfo": { + "description": "Reservation consumption information that the instance is consuming from.", + "id": "ResourceStatusReservationConsumptionInfo", + "properties": { + "consumedReservation": { + "description": "Output only. [Output Only] The full resource name of the reservation that this\ninstance is consuming from.", + "readOnly": true, + "type": "string" + }, + "consumedReservationBlock": { + "description": "Output only. [Output Only] The full resource name of the reservation block that this\ninstance is consuming from.", + "readOnly": true, + "type": "string" + }, + "consumedReservationSubBlock": { + "description": "Output only. [Output Only] The full resource name of the reservation sub-block that\nthis instance is consuming from.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "ResourceStatusScheduling": { + "id": "ResourceStatusScheduling", + "properties": { + "availabilityDomain": { + "description": "Specifies the availability domain to place the instance in. The value\nmust be a number between 1 and the number of availability domains\nspecified in the spread placement policy attached to the instance.", + "format": "int32", + "type": "integer" + }, + "gracefulShutdownTimestamp": { + "description": "Output only. Specifies the timestamp, when the instance will start graceful shutdown\nprocess, in RFC3339 text format.", + "readOnly": true, + "type": "string" + }, + "terminationTimestamp": { + "description": "Time in future when the instance will be terminated inRFC3339 text format.", + "type": "string" + } + }, + "type": "object" + }, + "ResourceStatusShutdownDetails": { + "description": "Specifies if the instance is in `PENDING_STOP` state or there is a\nprogrammed stop scheduled.", + "id": "ResourceStatusShutdownDetails", + "properties": { + "maxDuration": { + "$ref": "Duration", + "description": "The duration for graceful shutdown. Only applicable when\n`stop_state=PENDING_STOP`." }, - "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" + "requestTimestamp": { + "description": "Past timestamp indicating the beginning of current `stopState` in RFC3339 text format.", + "type": "string" + }, + "stopState": { + "description": "Current stopping state of the instance.", + "enum": [ + "PENDING_STOP", + "STOPPING" ], - "response": { - "$ref": "PublicAdvertisedPrefix" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "The instance is gracefully shutting down.", + "The instance is stopping." ], - "description": "Returns the specified PublicAdvertisedPrefix resource." + "type": "string" }, - "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" + "targetState": { + "description": "Target instance state.", + "enum": [ + "DELETED", + "STOPPED" ], - "request": { - "$ref": "PublicAdvertisedPrefix" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "The instance will be deleted.", + "The instance will be stopped." ], - "description": "Creates a PublicAdvertisedPrefix in the specified project using the parameters that are included in the request." + "type": "string" + } + }, + "type": "object" + }, + "RiskDetails": { + "description": "Detailed insights and metrics about a detected reliability risk.", + "id": "RiskDetails", + "properties": { + "duration": { + "description": "The duration of the risk since it was detected.", + "format": "google-duration", + "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" + "globalDnsInsight": { + "$ref": "RiskDetailsGlobalDnsInsight", + "description": "Insight details for global DNS risk." + }, + "lastUpdateTimestamp": { + "description": "The last time the risk was updated.", + "format": "google-datetime", + "type": "string" + }, + "severity": { + "description": "The severity of the risk.", + "enum": [ + "CRITICAL", + "HIGH", + "LOW", + "MEDIUM", + "SEVERITY_UNSPECIFIED" ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "Critical severity.", + "High severity.", + "Low severity.", + "Medium severity.", + "No severity specified. The default value." ], - "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" + "type": { + "description": "The type of risk.", + "enum": [ + "GLOBAL_DNS", + "RISK_TYPE_UNSPECIFIED" ], - "request": { - "$ref": "PublicAdvertisedPrefix" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "Risk type related to global DNS.", + "Default value. This value is unused." ], - "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." + "type": "string" + } + }, + "type": "object" + }, + "RiskDetailsGlobalDnsInsight": { + "description": "Detailed insights for a global DNS reliability risk.", + "id": "RiskDetailsGlobalDnsInsight", + "properties": { + "projectDefaultIsGlobalDns": { + "description": "Indicates whether the project's default DNS setting is global DNS.", + "type": "boolean" }, - "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" + "queryObservationWindow": { + "description": "The observation window for the query counts.", + "format": "google-duration", + "type": "string" + }, + "riskyQueryCount": { + "description": "The number of queries that are risky. This is always less than or\nequal to total_query_count.", + "format": "int64", + "type": "string" + }, + "totalQueryCount": { + "description": "The total number of queries in the observation window.", + "format": "int64", + "type": "string" + } + }, + "type": "object" + }, + "RiskRecommendation": { + "description": "Recommendation for mitigating a reliability risk, including a reference URL.", + "id": "RiskRecommendation", + "properties": { + "content": { + "description": "Mitigation guide for the risk.", + "type": "string" + }, + "referenceUrl": { + "description": "URL referencing a more detailed mitigation guide.", + "type": "string" + } + }, + "type": "object" + }, + "Rollout": { + "description": "Rollout resource.\n\nA Rollout is a specific instance of a RolloutPlan. It represents a single\nexecution of a strategy to roll out a specific resource. It also provides\nAPIs to interact with the rollout.", + "id": "Rollout", + "properties": { + "cancellationTime": { + "description": "Output only. The timestamp at which the Rollout was cancelled.", + "readOnly": true, + "type": "string" + }, + "completionTime": { + "description": "Output only. The timestamp at which the Rollout was completed.", + "readOnly": true, + "type": "string" + }, + "creationTimestamp": { + "description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", + "readOnly": true, + "type": "string" + }, + "currentWaveNumber": { + "description": "Output only. The number of the currently running wave.\nEx. 1", + "format": "int64", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you\ncreate the resource.", + "type": "string" + }, + "etag": { + "description": "Output only. etag of the Rollout\nEx. abc1234", + "readOnly": true, + "type": "string" + }, + "id": { + "description": "Output only. [Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "format": "uint64", + "readOnly": true, + "type": "string" + }, + "kind": { + "default": "compute#rollout", + "description": "Output only. [Output Only] Type of the resource. Always compute#rollout\nfor rollouts.", + "readOnly": true, + "type": "string" + }, + "name": { + "description": "Name of the resource. Provided by the client when the resource is created.\nThe name must be 1-63 characters long, and comply withRFC1035.\nSpecifically, the name must be 1-63 characters long and match the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?`\nwhich means the first character must be a lowercase letter, and all\nfollowing characters must be a dash, lowercase letter, or digit, except\nthe last character, which cannot be a dash.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "pauseTime": { + "description": "Output only. The timestamp at which the Rollout was paused.", + "readOnly": true, + "type": "string" + }, + "resumeTime": { + "description": "Output only. The timestamp at which the Rollout was resumed.", + "readOnly": true, + "type": "string" + }, + "rolloutEntity": { + "$ref": "RolloutRolloutEntity", + "description": "Required. The resource being rolled out." + }, + "rolloutPlan": { + "description": "Required. Rollout Plan used to model the Rollout.\nEx. compute.googleapis.com/v1/projects/1234/rolloutPlans/rp1", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined fully-qualified URL for this resource.", + "readOnly": true, + "type": "string" + }, + "selfLinkWithId": { + "description": "Output only. [Output Only] Server-defined URL for this resource's resource id.", + "readOnly": true, + "type": "string" + }, + "state": { + "description": "Output only. The current state of the Rollout.", + "enum": [ + "CANCELLED", + "CANCELLING", + "CANCEL_FAILED", + "COMPLETED", + "COMPLETE_FAILED", + "COMPLETING", + "FAILED", + "PAUSED", + "PAUSE_FAILED", + "PAUSING", + "PROCESSING", + "READY", + "RESUMING", + "ROLLBACK_WAVE_FAILED", + "ROLLING_BACK", + "STATE_UNSPECIFIED", + "UNINITIALIZED", + "WAVE_FAILED" ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "The rollout is in a failure terminal state.", + "The rollout is being cancelled.", + "An attempted cancel operation was unsuccessful.", + "The rollout is in a successful terminal state.", + "An attempted complete operation was unsuccessful.", + "The rollout is being marked as completed.", + "The rollout completed with failures.", + "The rollout is paused.", + "An attempted pause operation was unsuccessful.", + "The rollout is being paused.", + "A wave is being processed by the product.", + "The rollout has been successfully initialized and is ready to start.", + "The rollout is being resumed after being paused.", + "An attempted rollback operation failed to complete successfully.", + "A wave rollback is in progress for this rollout.", + "Undefined default state. Should never be exposed to users.", + "The rollout has been created but is not yet ready to be started.", + "The product failed to process the wave." ], - "description": "Announces the specified PublicAdvertisedPrefix" + "readOnly": true, + "type": "string" }, - "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" + "waveDetails": { + "description": "Output only. Details about each wave of the rollout.", + "items": { + "$ref": "RolloutWaveDetails" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Withdraws the specified PublicAdvertisedPrefix" + "readOnly": true, + "type": "array" } - } + }, + "type": "object" }, - "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" + "RolloutPlan": { + "description": "RolloutPlan resource.\n\nA RolloutPlan is the customer-defined strategy to divide a large-scale change\ninto smaller increments, referred to as \"waves\". Each wave targets a specific\nportion of the overall affected area and defines criteria that must be met\nbefore progressing to the subsequent wave.", + "id": "RolloutPlan", + "properties": { + "creationTimestamp": { + "description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you\ncreate the resource.", + "type": "string" + }, + "id": { + "description": "Output only. [Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "format": "uint64", + "readOnly": true, + "type": "string" + }, + "kind": { + "default": "compute#rolloutPlan", + "description": "Output only. [Output Only] Type of the resource. Always compute#rolloutPlan\nfor rolloutPlans.", + "readOnly": true, + "type": "string" + }, + "locationScope": { + "description": "The location scope of the rollout plan. If not specified, the location\nscope is considered as ZONAL.", + "enum": [ + "LOCATION_SCOPE_UNSPECIFIED", + "REGIONAL", + "ZONAL" ], - "response": { - "$ref": "PublicDelegatedPrefixList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "Unspecified value. Considered as ZONAL.", + "Regional scope.", + "Zonal scope." ], - "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" + "name": { + "annotations": { + "required": [ + "compute.rolloutPlans.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 global PublicDelegatedPrefix resource." + "description": "Name of the resource. Provided by the client when the resource is created.\nThe name must be 1-63 characters long, and comply withRFC1035.\nSpecifically, the name must be 1-63 characters long and match the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?`\nwhich means the first character must be a lowercase letter, and all\nfollowing characters must be a dash, lowercase letter, or digit, except\nthe last character, which cannot be a dash.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" }, - "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" - } + "selfLink": { + "description": "Output only. [Output Only] Server-defined fully-qualified URL for this resource.", + "readOnly": true, + "type": "string" + }, + "selfLinkWithId": { + "description": "Output only. [Output Only] Server-defined URL for this resource's resource id.", + "readOnly": true, + "type": "string" + }, + "waves": { + "description": "Required. The waves included in this rollout plan.", + "items": { + "$ref": "RolloutPlanWave" }, - "parameterOrder": [ - "project" - ], - "request": { - "$ref": "PublicDelegatedPrefix" + "type": "array" + } + }, + "type": "object" + }, + "RolloutPlanWave": { + "description": "A single wave in a rollout plan.", + "id": "RolloutPlanWave", + "properties": { + "displayName": { + "description": "Optional. The display name of this wave of the rollout plan.", + "type": "string" + }, + "number": { + "description": "Output only. The wave number.", + "format": "int64", + "readOnly": true, + "type": "string" + }, + "orchestrationOptions": { + "$ref": "RolloutPlanWaveOrchestrationOptions", + "description": "Optional. The orchestration options for this wave." + }, + "selectors": { + "description": "Required. The selectors for this wave. There is a logical AND between each selector\ndefined in a wave, so a resource must satisfy the criteria of *all* the\nspecified selectors to be in scope for the wave.", + "items": { + "$ref": "RolloutPlanWaveSelector" }, - "response": { - "$ref": "Operation" + "type": "array" + }, + "validation": { + "$ref": "RolloutPlanWaveValidation", + "description": "Required. The validation to be performed at the end of this wave." + } + }, + "type": "object" + }, + "RolloutPlanWaveOrchestrationOptions": { + "description": "Options to control the pace of orchestration of a wave. These options are\nrequired only if the resource being rolled out follows the Orchestrated\npattern.", + "id": "RolloutPlanWaveOrchestrationOptions", + "properties": { + "delays": { + "description": "Optional. Delays, if any, to be added between batches of projects. We allow\nmultiple Delays to be specified, letting users set separate delays\nbetween batches of projects corresponding to different locations and\nbatches of projects corresponding to the same location.", + "items": { + "$ref": "RolloutPlanWaveOrchestrationOptionsDelay" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "type": "array" + }, + "maxConcurrentLocations": { + "description": "Optional. Maximum number of locations to be orchestrated in parallel.", + "format": "int64", + "type": "string" + }, + "maxConcurrentResourcesPerLocation": { + "description": "Optional. Maximum number of resources to be orchestrated per location in\nparallel.", + "format": "int64", + "type": "string" + } + }, + "type": "object" + }, + "RolloutPlanWaveOrchestrationOptionsDelay": { + "description": "Options to control the delay, if any, between batches of projects.", + "id": "RolloutPlanWaveOrchestrationOptionsDelay", + "properties": { + "delimiter": { + "description": "Optional. Controls whether the delay should only be added between batches of\nprojects corresponding to different locations, or also between\nbatches of projects corresponding to the same location.\n\nMust be set to DELIMITER_UNSPECIFIED if no delay is to be added.", + "enum": [ + "DELIMITER_BATCH", + "DELIMITER_LOCATION", + "DELIMITER_UNSPECIFIED" + ], + "enumDescriptions": [ + "The delay will also be added between batches of projects\ncorresponding to the same location.", + "The delay will only be added between batches of projects\ncorresponding to different locations.", + "No delay will be added between batches of projects. Processing will\ncontinue with the next batch as soon as the previous batch of LROs\nis done." ], - "description": "Creates a global PublicDelegatedPrefix in the specified project using the parameters that are included in the request." + "type": "string" }, - "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" + "duration": { + "description": "Optional. The duration of the delay, if any, to be added between batches of\nprojects. A zero duration corresponds to no delay.", + "format": "google-duration", + "type": "string" + }, + "type": { + "description": "Optional. Controls whether the specified duration is to be added at the end of\neach batch, or if the total processing time for each batch will be\npadded if needed to meet the specified duration.\n\nMust be set to TYPE_UNSPECIFIED if no delay is to be added.", + "enum": [ + "TYPE_MINIMUM", + "TYPE_OFFSET", + "TYPE_UNSPECIFIED" ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "The total processing time for each batch of projects will be padded\nif needed to meet the specified delay duration.", + "The specified delay will directly be added after each batch of\nprojects as specified by the delimiter.", + "No delay will be added between batches of projects. Processing will\ncontinue with the next batch as soon as the previous batch of LROs\nis done." ], - "description": "Deletes the specified global PublicDelegatedPrefix." + "type": "string" + } + }, + "type": "object" + }, + "RolloutPlanWaveSelector": { + "description": "A selector which specifies what resource(s) are included in a given wave.", + "id": "RolloutPlanWaveSelector", + "properties": { + "locationSelector": { + "$ref": "RolloutPlanWaveSelectorLocationSelector", + "description": "Optional. Roll out to resources by Cloud locations." }, - "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" - } + "resourceHierarchySelector": { + "$ref": "RolloutPlanWaveSelectorResourceHierarchySelector", + "description": "Optional. Roll out to resources by Cloud Resource Manager resource hierarchy." + } + }, + "type": "object" + }, + "RolloutPlanWaveSelectorLocationSelector": { + "description": "Roll out to resources by location.", + "id": "RolloutPlanWaveSelectorLocationSelector", + "properties": { + "includedLocations": { + "description": "Optional. Example: \"us-central1-a\"", + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "publicDelegatedPrefix" - ], - "request": { - "$ref": "PublicDelegatedPrefix" + "type": "array" + } + }, + "type": "object" + }, + "RolloutPlanWaveSelectorResourceHierarchySelector": { + "description": "Roll out to resources by Cloud Resource Manager resource hierarchy\nnodes such as projects, folders, orgs.", + "id": "RolloutPlanWaveSelectorResourceHierarchySelector", + "properties": { + "includedFolders": { + "description": "Optional. Format: \"folders/{folder_id}\"", + "items": { + "type": "string" }, - "response": { - "$ref": "Operation" + "type": "array" + }, + "includedOrganizations": { + "description": "Optional. Format: \"organizations/{organization_id}\"", + "items": { + "type": "string" }, - "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." + "type": "array" + }, + "includedProjects": { + "description": "Optional. Format: \"projects/{project_id}\"", + "items": { + "type": "string" + }, + "type": "array" } - } + }, + "type": "object" }, - "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" - } + "RolloutPlanWaveValidation": { + "description": "The validation to be performed before progressing to the next wave.", + "id": "RolloutPlanWaveValidation", + "properties": { + "timeBasedValidationMetadata": { + "$ref": "RolloutPlanWaveValidationTimeBasedValidationMetadata", + "description": "Optional. Metadata required if type = \"time\"." + }, + "type": { + "description": "Required. The type of the validation. If a type of validation is associated with\na metadata object, the appropriate metadata field mapping to the\nvalidation type must be provided in the validation message. Possible\nvalues are in quotes below alongside an explanation:\n \"manual\": The system waits for an end-user approval API before\n progressing to the next wave.\n \"time\": The system waits for a user specified duration before\n progressing to the next wave. TimeBasedValidation must be provided.", + "type": "string" + } + }, + "type": "object" + }, + "RolloutPlanWaveValidationTimeBasedValidationMetadata": { + "description": "Metadata required if type = \"time\".", + "id": "RolloutPlanWaveValidationTimeBasedValidationMetadata", + "properties": { + "waitDuration": { + "description": "Optional. The duration that the system waits in between waves. This wait starts\nafter all changes in the wave are rolled out.", + "format": "google-duration", + "type": "string" + } + }, + "type": "object" + }, + "RolloutPlansListResponse": { + "description": "Contains a list of RolloutPlan resources.", + "id": "RolloutPlansListResponse", + "properties": { + "etag": { + "type": "string" + }, + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of RolloutPlan resources.", + "items": { + "$ref": "RolloutPlan" }, - "parameterOrder": [ - "project", - "region" - ], - "response": { - "$ref": "PublicDelegatedPrefixList" + "type": "array" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "unreachables": { + "description": "Output only. [Output Only] Unreachable resources.\nend_interface: MixerListResponseWithEtagBuilder", + "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": "Lists the PublicDelegatedPrefixes for a project in the given region." + "readOnly": true, + "type": "array" }, - "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, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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" + "data": { + "description": "[Output Only] Metadata about this warning in key:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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" } }, - "parameterOrder": [ - "project", - "region", - "publicDelegatedPrefix" - ], - "response": { - "$ref": "PublicDelegatedPrefix" + "type": "object" + } + }, + "type": "object" + }, + "RolloutRolloutEntity": { + "description": "Specifications of the resource to roll out.", + "id": "RolloutRolloutEntity", + "properties": { + "orchestratedEntity": { + "$ref": "RolloutRolloutEntityOrchestratedEntity", + "description": "Optional. Entity details for products using the Orchestrated Integration model." + } + }, + "type": "object" + }, + "RolloutRolloutEntityOrchestratedEntity": { + "description": "This message is used if the resource type follows the Orchestrated\nintegration model with ProgressiveRollout.", + "id": "RolloutRolloutEntityOrchestratedEntity", + "properties": { + "conflictBehavior": { + "description": "Required. Specifies the behavior of the Rollout if an out of band update is\ndetected in a project during a Rollout. It can be one of the following\nvalues:\n1) overwrite : Overwrite the local value with the rollout value.\n2) no_overwrite : Do not overwrite the local value with the rollout\nvalue.", + "type": "string" + }, + "orchestrationAction": { + "description": "Required. Orchestration action during the Rollout. It can be one of the following\nvalues:\n1) \"update\": Resources will be updated by the rollout.\n2) \"delete\": Resources will be deleted by the rollout.", + "type": "string" + }, + "orchestrationSource": { + "description": "Required. Fully qualified resource name of the resource which contains the source\nof truth of the configuration being rolled out across\nlocations/projects. For example, in the case of a global Rollout which\nis applied across regions, this contains the name of the global\nresource created by the user which contains a payload for a resource\nthat is orchestrated across regions. This follows the following format:\n//.googleapis.com/projects//locations/global//\ne.g.\n//osconfig.googleapis.com/projects/1/locations/global/policyOrchestrators/po1", + "type": "string" + } + }, + "type": "object" + }, + "RolloutWaveDetails": { + "description": "Additional metadata about the status of each wave provided by the server.", + "id": "RolloutWaveDetails", + "properties": { + "orchestratedWaveDetails": { + "$ref": "RolloutWaveDetailsOrchestratedWaveDetails", + "description": "Output only. Additional details of the wave for products using the Orchestrated\nIntegration model.", + "readOnly": true + }, + "waveDisplayName": { + "description": "Output only. Wave name.\nEx. wave1", + "readOnly": true, + "type": "string" + }, + "waveNumber": { + "description": "Output only. System generated number for the wave.", + "format": "int64", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "RolloutWaveDetailsOrchestratedWaveDetails": { + "description": "Details of the wave for products using the Orchestrated integration\nmodel.", + "id": "RolloutWaveDetailsOrchestratedWaveDetails", + "properties": { + "completedResourcesCount": { + "description": "Output only. Resource completed so far.", + "format": "int64", + "readOnly": true, + "type": "string" + }, + "estimatedCompletionTime": { + "description": "Output only. Estimated timestamp at which the wave will complete. Extrapolated from\ncurrent progress.", + "readOnly": true, + "type": "string" + }, + "estimatedTotalResourcesCount": { + "description": "Output only. Estimated total count of resources.", + "format": "int64", + "readOnly": true, + "type": "string" + }, + "failedLocations": { + "description": "Output only. Locations that failed during orchestration, and ProgressiveRollout\nstopped retrying. There may be some successful resources rolled out in\nthe wave as the location may have failed later in the Rollout.", + "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": "Returns the specified PublicDelegatedPrefix resource in the given region." + "readOnly": true, + "type": "array" }, - "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" - } + "failedResourcesCount": { + "description": "Output only. Resources failed.", + "format": "int64", + "readOnly": true, + "type": "string" + }, + "locationStatus": { + "additionalProperties": { + "$ref": "RolloutWaveDetailsOrchestratedWaveDetailsLocationStatus" }, - "parameterOrder": [ - "project", - "region" + "description": "Output only. Status of each location in the wave. Map keys (locations) must be\nspecified like \"us-east1\" or \"asia-west1-a\".", + "readOnly": true, + "type": "object" + } + }, + "type": "object" + }, + "RolloutWaveDetailsOrchestratedWaveDetailsLocationStatus": { + "description": "Represents the status of a location in a wave.", + "id": "RolloutWaveDetailsOrchestratedWaveDetailsLocationStatus", + "properties": { + "state": { + "description": "Output only. Location state of the wave.", + "enum": [ + "STATE_FAILED", + "STATE_IN_PROGRESS", + "STATE_PENDING", + "STATE_SKIPPED", + "STATE_SUCCEEDED", + "STATE_UNSPECIFIED" ], - "request": { - "$ref": "PublicDelegatedPrefix" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "Work on the wave failed.", + "Work on the wave is in progress.", + "Work on the wave is pending.", + "Work on the wave was canceled or skipped.", + "Work on the wave succeeded.", + "Undefined default state. Should never be exposed to users." ], - "description": "Creates a PublicDelegatedPrefix in the specified project in the given region using the parameters that are included in the request." + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "RolloutsListResponse": { + "id": "RolloutsListResponse", + "properties": { + "etag": { + "type": "string" }, - "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" - } + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of Rollout resources.", + "items": { + "$ref": "Rollout" }, - "parameterOrder": [ - "project", - "region", - "publicDelegatedPrefix" - ], - "response": { - "$ref": "Operation" + "type": "array" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "unreachables": { + "description": "Output only. [Output Only] Unreachable resources.\nend_interface: MixerListResponseWithEtagBuilder", + "items": { + "type": "string" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified PublicDelegatedPrefix in the given region." + "readOnly": true, + "type": "array" }, - "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, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. 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" } }, - "parameterOrder": [ - "project", - "region", - "publicDelegatedPrefix" - ], - "request": { - "$ref": "PublicDelegatedPrefix" + "type": "object" + } + }, + "type": "object" + }, + "Route": { + "description": "Represents a Route resource.\n\nA route defines a path from VM instances in the VPC network to a specific\ndestination. This destination can be inside or outside the VPC network.\nFor more information, read theRoutes overview.", + "id": "Route", + "properties": { + "asPaths": { + "description": "Output only. [Output Only] AS path.", + "items": { + "$ref": "RouteAsPath" }, - "response": { - "$ref": "Operation" + "readOnly": true, + "type": "array" + }, + "creationTimestamp": { + "description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "An optional description of this resource. Provide this field when you\ncreate the resource.", + "type": "string" + }, + "destRange": { + "annotations": { + "required": [ + "compute.routes.insert" + ] }, - "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." + "description": "The destination range of outgoing packets that this route applies to. Both\nIPv4 and IPv6 are supported.\nMust specify an IPv4 range (e.g. 192.0.2.0/24) or an IPv6 range in RFC 4291\nformat (e.g. 2001:db8::/32). IPv6 range will be displayed using RFC 5952\ncompressed format.", + "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" - } + "id": { + "description": "Output only. [Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "format": "uint64", + "readOnly": true, + "type": "string" + }, + "kind": { + "default": "compute#route", + "description": "Output only. [Output Only] Type of this resource. Always compute#routes for\nRoute resources.", + "readOnly": true, + "type": "string" + }, + "name": { + "annotations": { + "required": [ + "compute.routes.insert" + ] }, - "parameterOrder": [ - "project", - "region", - "publicDelegatedPrefix" + "description": "Name of the resource. Provided by the client when the resource is created.\nThe name must be 1-63 characters long, and comply withRFC1035.\nSpecifically, the name must be 1-63 characters long and match the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?`. The first character must be a\nlowercase letter, and all following characters (except for the last\ncharacter) must be a dash, lowercase letter, or digit. The last character\nmust be a lowercase letter or digit.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "network": { + "annotations": { + "required": [ + "compute.routes.insert" + ] + }, + "description": "Fully-qualified URL of the network that this route applies to.", + "type": "string" + }, + "nextHopGateway": { + "description": "The URL to a gateway that should handle matching packets.\nYou can only specify the internet gateway using a full or\npartial valid URL: projects/project/global/gateways/default-internet-gateway", + "type": "string" + }, + "nextHopHub": { + "description": "Output only. [Output Only] The full resource name of the Network Connectivity Center hub\nthat will handle matching packets.", + "readOnly": true, + "type": "string" + }, + "nextHopIlb": { + "description": "The URL to a forwarding rule of typeloadBalancingScheme=INTERNAL that should handle matching\npackets or the IP address of the forwarding Rule.\nFor example, the following are all valid URLs:\n \n \n - https://www.googleapis.com/compute/v1/projects/project/regions/region/forwardingRules/forwardingRule \n - regions/region/forwardingRules/forwardingRule\n\n\nIf an IP address is provided, must specify an IPv4 address in dot-decimal\nnotation or an IPv6 address in RFC 4291 format. For example, the following\nare all valid IP addresses:\n \n \n - 10.128.0.56\n - 2001:db8::2d9:51:0:0\n - 2001:db8:0:0:2d9:51:0:0\n\n\nIPv6 addresses will be displayed using RFC 5952 compressed format (e.g.\n2001:db8::2d9:51:0:0). Should never be an IPv4-mapped IPv6 address.", + "type": "string" + }, + "nextHopInstance": { + "description": "The URL to an instance that should handle matching packets. You can specify\nthis as a full or partial URL.\nFor example: \nhttps://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/", + "type": "string" + }, + "nextHopInterRegionCost": { + "description": "Output only. [Output only] Internal fixed region-to-region cost that Google Cloud\ncalculates based on factors such as network performance, distance, and\navailable bandwidth between regions.", + "format": "uint32", + "readOnly": true, + "type": "integer" + }, + "nextHopInterconnectAttachment": { + "description": "Output only. [Output Only] The URL to an InterconnectAttachment which is the next hop\nfor the route.\nThis field will only be populated for dynamic routes generated by\nCloud Router with a linked interconnectAttachment or the static route\ngenerated by each L2 Interconnect Attachment.", + "readOnly": true, + "type": "string" + }, + "nextHopIp": { + "description": "The network IP address of an instance that should handle matching packets.\nBoth IPv6 address and IPv4 addresses are supported.\nMust specify an IPv4 address in dot-decimal notation (e.g. 192.0.2.99) or\nan IPv6 address in RFC 4291 format (e.g. 2001:db8::2d9:51:0:0 or\n2001:db8:0:0:2d9:51:0:0). IPv6 addresses will be displayed using RFC 5952\ncompressed format (e.g. 2001:db8::2d9:51:0:0). Should never be an\nIPv4-mapped IPv6 address.", + "type": "string" + }, + "nextHopMed": { + "description": "Output only. [Output Only] Multi-Exit Discriminator, a BGP route metric that indicates\nthe desirability of a particular route in a network.", + "format": "uint32", + "readOnly": true, + "type": "integer" + }, + "nextHopNetwork": { + "description": "The URL of the local network if it should handle matching packets.", + "type": "string" + }, + "nextHopOrigin": { + "description": "Output only. [Output Only] Indicates the origin of the route. Can be IGP\n(Interior Gateway Protocol), EGP (Exterior Gateway Protocol),\nor INCOMPLETE.", + "enum": [ + "EGP", + "IGP", + "INCOMPLETE" ], - "response": { - "$ref": "Operation" + "enumDescriptions": [ + "", + "", + "" + ], + "readOnly": true, + "type": "string" + }, + "nextHopPeering": { + "description": "Output only. [Output Only] The network peering name that should handle matching packets,\nwhich should conform to RFC1035.", + "readOnly": true, + "type": "string" + }, + "nextHopVpnTunnel": { + "description": "The URL to a VpnTunnel that should handle matching packets.", + "type": "string" + }, + "params": { + "$ref": "RouteParams", + "description": "Input only. [Input Only] Additional params passed with the request, but not persisted\nas part of resource payload." + }, + "priority": { + "annotations": { + "required": [ + "compute.routes.insert" + ] }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "description": "The priority of this route. Priority is used to break ties in cases\nwhere there is more than one matching route of equal prefix length. In\ncases where multiple routes have equal prefix length, the one with the\nlowest-numbered priority value wins. The default value is `1000`. The\npriority value must be from `0` to `65535`, inclusive.", + "format": "uint32", + "type": "integer" + }, + "routeStatus": { + "description": "[Output only] The status of the route. This status applies to\ndynamic routes learned by Cloud Routers. It is also applicable to routes\nundergoing migration.", + "enum": [ + "ACTIVE", + "DROPPED", + "INACTIVE", + "PENDING" + ], + "enumDescriptions": [ + "This route is processed and active.", + "The route is dropped due to the VPC exceeding the dynamic route limit.\n For dynamic route limit, please refer to the\nLearned route example", + "This route is processed but inactive due to failure from the backend. The\nbackend may have rejected the route", + "This route is being processed internally. The status will change once\nprocessed." ], - "description": "Announces the specified PublicDelegatedPrefix in the given region." + "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" + "routeType": { + "description": "Output only. [Output Only] The type of this route, which can be one of the following\nvalues:\n- 'TRANSIT' for a transit route that this router learned from\nanother Cloud Router and will readvertise to one of its BGP peers \n- 'SUBNET' for a route from a subnet of the VPC \n- 'BGP' for a route learned from a BGP peer of this router \n- 'STATIC' for a static route", + "enum": [ + "BGP", + "STATIC", + "SUBNET", + "TRANSIT" + ], + "enumDescriptions": [ + "", + "", + "", + "" + ], + "readOnly": true, + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined fully-qualified URL for this resource.", + "type": "string" + }, + "tags": { + "description": "A list of instance tags to which this route applies.", + "items": { + "type": "string" + }, + "type": "array" + }, + "warnings": { + "description": "Output only. [Output Only] If potential misconfigurations are detected for this\nroute, this field will be populated with warning messages.", + "items": { + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "type": "string" + }, + "data": { + "description": "[Output Only] Metadata about this warning in key:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" + }, + "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" - } + "type": "object" }, - "parameterOrder": [ - "project", - "region", - "publicDelegatedPrefix" - ], - "response": { - "$ref": "Operation" + "readOnly": true, + "type": "array" + } + }, + "type": "object" + }, + "RouteAsPath": { + "id": "RouteAsPath", + "properties": { + "asLists": { + "description": "[Output Only] The AS numbers of the AS Path.", + "items": { + "format": "uint32", + "type": "integer" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "type": "array" + }, + "pathSegmentType": { + "description": "[Output Only] The type of the AS Path, which can be one of the following\nvalues: \n- 'AS_SET': unordered set of autonomous systems that the route\nin has traversed \n- 'AS_SEQUENCE': ordered set of autonomous\nsystems that the route has traversed \n- 'AS_CONFED_SEQUENCE':\nordered set of Member Autonomous Systems in the local confederation that\nthe route has traversed \n- 'AS_CONFED_SET': unordered set of\nMember Autonomous Systems in the local confederation that the route has\ntraversed", + "enum": [ + "AS_CONFED_SEQUENCE", + "AS_CONFED_SET", + "AS_SEQUENCE", + "AS_SET" ], - "description": "Withdraws the specified PublicDelegatedPrefix in the given region." + "enumDescriptions": [ + "", + "", + "", + "" + ], + "type": "string" + } + }, + "type": "object" + }, + "RouteList": { + "description": "Contains a list of Route resources.", + "id": "RouteList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" }, - "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", + "items": { + "description": "A list of Route resources.", + "items": { + "$ref": "Route" + }, + "type": "array" + }, + "kind": { + "default": "compute#routeList", + "description": "Output only. Type of resource.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "pageToken": { - "description": "Specifies a page token 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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" } }, - "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`." + "type": "object" } - } + }, + "type": "object" }, - "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" + "RouteParams": { + "description": "Additional route parameters.", + "id": "RouteParams", + "properties": { + "resourceManagerTags": { + "additionalProperties": { + "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 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." + "description": "Tag keys/values directly bound to this resource.\nTag keys and values have the same definition as resource\nmanager tags. The field is allowed for INSERT\nonly. The keys/values to set on the resource should be specified in\neither ID { : } or Namespaced format\n{ : }.\nFor example the following are valid inputs:\n* {\"tagKeys/333\" : \"tagValues/444\", \"tagKeys/123\" : \"tagValues/456\"}\n* {\"123/environment\" : \"production\", \"345/abc\" : \"xyz\"}\nNote:\n* Invalid combinations of ID & namespaced format is not supported. For\n instance: {\"123/environment\" : \"tagValues/444\"} is invalid.", + "type": "object" + } + }, + "type": "object" + }, + "RoutePolicy": { + "id": "RoutePolicy", + "properties": { + "description": { + "description": "An optional description of route policy.", + "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" - } + "fingerprint": { + "description": "A fingerprint for the Route Policy being applied to this Router, which is\nessentially a hash of the Route Policy used for optimistic locking.\nThe fingerprint is initially generated by Compute Engine and changes\nafter every request to modify or update Route Policy. You must always\nprovide an up-to-date fingerprint hash in order to update or change\nlabels.\n\nTo see the latest fingerprint, make a getRoutePolicy() request\nto retrieve a Route Policy.", + "format": "byte", + "type": "string" + }, + "name": { + "description": "Route Policy name, which must be a resource ID segment and unique\nwithin all the router's Route Policies. Name should conform to RFC1035.", + "type": "string" + }, + "terms": { + "description": "List of terms (the order in the list is not important, they are evaluated\nin order of priority). Order of policies is not retained and might change\nwhen getting policy later.", + "items": { + "$ref": "RoutePolicyPolicyTerm" }, - "parameterOrder": [ - "project", - "region" + "type": "array" + }, + "type": { + "enum": [ + "ROUTE_POLICY_TYPE_EXPORT", + "ROUTE_POLICY_TYPE_IMPORT" ], - "response": { - "$ref": "Region" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "The Route Policy is an Export Policy.", + "The Route Policy is an Import Policy." ], - "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." + "type": "string" } - } + }, + "type": "object" }, - "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" - } + "RoutePolicyPolicyTerm": { + "id": "RoutePolicyPolicyTerm", + "properties": { + "actions": { + "description": "CEL expressions to evaluate to modify a route when this term matches.", + "items": { + "$ref": "Expr" }, - "parameterOrder": [ - "project", - "region" - ], - "response": { - "$ref": "SubnetworkList" + "type": "array" + }, + "match": { + "$ref": "Expr", + "description": "CEL expression evaluated against a route to determine if this term\napplies. When not set, the term applies to all\nroutes." + }, + "priority": { + "description": "The evaluation priority for this term, which must be between 0\n(inclusive) and 2^31 (exclusive), and unique within the list.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, + "Router": { + "description": "Represents a Cloud Router resource.\n\nFor more information about Cloud Router, read theCloud\nRouter overview.", + "id": "Router", + "properties": { + "bgp": { + "$ref": "RouterBgp", + "description": "BGP information specific to this router." + }, + "bgpPeers": { + "description": "BGP information that must be configured into the routing stack to\nestablish BGP peering. This information must specify the peer ASN and\neither the interface name, IP address, or peer IP address. Please refer toRFC4273.", + "items": { + "$ref": "RouterBgpPeer" }, - "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." + "type": "array" }, - "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" - } + "creationTimestamp": { + "description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you\ncreate the resource.", + "type": "string" + }, + "encryptedInterconnectRouter": { + "description": "Indicates if a router is dedicated for use with encrypted VLAN\nattachments (interconnectAttachments).", + "type": "boolean" + }, + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "format": "uint64", + "type": "string" + }, + "interfaces": { + "description": "Router interfaces.\nTo create a BGP peer that uses a router interface,\nthe interface must have one of the following fields specified:\n \n - linkedVpnTunnel\n - linkedInterconnectAttachment\n - subnetwork\n\n\nYou can create a router interface without any of these fields specified.\nHowever, you cannot create a BGP peer that uses that interface.", + "items": { + "$ref": "RouterInterface" }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "SubnetworkAggregatedList" + "type": "array" + }, + "kind": { + "default": "compute#router", + "description": "Output only. [Output Only] Type of resource. Always compute#router for\nrouters.", + "readOnly": true, + "type": "string" + }, + "md5AuthenticationKeys": { + "description": "Keys used for MD5 authentication.", + "items": { + "$ref": "RouterMd5AuthenticationKey" }, - "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`." + "type": "array" }, - "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" - } + "name": { + "annotations": { + "required": [ + "compute.routers.insert" + ] }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "UsableSubnetworksAggregatedList" + "description": "Name of the resource. Provided by the client when the resource is created.\nThe name must be 1-63 characters long, and comply withRFC1035.\nSpecifically, the name must be 1-63 characters long and match the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first\ncharacter must be a lowercase letter, and all following characters must\nbe a dash, lowercase letter, or digit, except the last character, which\ncannot be a dash.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "nats": { + "description": "A list of NAT services created in this router.", + "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": "Retrieves an aggregated list of all usable subnetworks in the project." + "type": "array" }, - "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, + "nccGateway": { + "description": "URI of the ncc_gateway to which this router associated.", + "type": "string" + }, + "network": { + "annotations": { + "required": [ + "compute.routers.insert", + "compute.routers.update" + ] + }, + "description": "URI of the network to which this router belongs.", + "type": "string" + }, + "params": { + "$ref": "RouterParams", + "description": "Input only. [Input Only] Additional params passed with the request, but not persisted\nas part of resource payload." + }, + "region": { + "description": "[Output Only] URI of the region where the router resides.\nYou must specify this field as part of the HTTP request URL. It is\nnot settable as a field in the request body.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" + } + }, + "type": "object" + }, + "RouterAdvertisedIpRange": { + "description": "Description-tagged IP ranges for the router to advertise.", + "id": "RouterAdvertisedIpRange", + "properties": { + "description": { + "description": "User-specified description for the IP range.", + "type": "string" + }, + "range": { + "description": "The IP range to advertise. The value must be a CIDR-formatted string.", + "type": "string" + } + }, + "type": "object" + }, + "RouterAggregatedList": { + "description": "Contains a list of routers.", + "id": "RouterAggregatedList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "additionalProperties": { + "$ref": "RoutersScopedList", + "description": "Name of the scope containing this set of routers." + }, + "description": "A list of Router resources.", + "type": "object" + }, + "kind": { + "default": "compute#routerAggregatedList", + "description": "Output only. Type of resource.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "unreachables": { + "description": "Output only. [Output Only] Unreachable resources.", + "items": { + "type": "string" + }, + "readOnly": true, + "type": "array" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project", - "region", - "subnetwork" + "type": "object" + } + }, + "type": "object" + }, + "RouterBgp": { + "id": "RouterBgp", + "properties": { + "advertiseMode": { + "description": "User-specified flag to indicate which mode to use for advertisement.\nThe options are DEFAULT or CUSTOM.", + "enum": [ + "CUSTOM", + "DEFAULT" ], - "response": { - "$ref": "Subnetwork" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "", + "" ], - "description": "Returns the specified subnetwork." + "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" - } + "advertisedGroups": { + "description": "User-specified list of prefix groups to advertise in custom mode.\nThis field can only be populated if advertise_mode is CUSTOM and\nis advertised to all peers of the router.\nThese groups will be advertised in addition to any specified prefixes.\nLeave this field blank to advertise no custom groups.", + "items": { + "enum": [ + "ALL_SUBNETS" + ], + "enumDescriptions": [ + "Advertise all available subnets (including peer VPC subnets)." + ], + "type": "string" }, - "parameterOrder": [ - "project", - "region" + "type": "array" + }, + "advertisedIpRanges": { + "description": "User-specified list of individual IP ranges to advertise in custom mode.\nThis field can only be populated if advertise_mode is CUSTOM and\nis advertised to all peers of the router.\nThese IP ranges will be advertised in addition to any specified groups.\nLeave this field blank to advertise no custom IP ranges.", + "items": { + "$ref": "RouterAdvertisedIpRange" + }, + "type": "array" + }, + "asn": { + "description": "Local BGP Autonomous System Number (ASN).\nMust be anRFC6996 private ASN, either 16-bit or 32-bit. The\nvalue will be fixed for this router resource. All VPN tunnels that link\nto this router will have the same local ASN.", + "format": "uint32", + "type": "integer" + }, + "identifierRange": { + "description": "Explicitly specifies a range of valid BGP Identifiers for this Router. It\nis provided as a link-local IPv4 range (from 169.254.0.0/16), of size at\nleast /30, even if the BGP sessions are over IPv6. It must not overlap\nwith any IPv4 BGP session ranges.\n\n\nOther vendors commonly call this \"router ID\".", + "type": "string" + }, + "keepaliveInterval": { + "description": "The interval in seconds between BGP keepalive messages that are\nsent to the peer.\n\n\nHold time is three times the interval at which keepalive messages are\nsent, and the hold time is the maximum number of seconds allowed to\nelapse between successive keepalive messages that BGP receives from a\npeer.\n\n\nBGP will use the smaller of either the local hold time value or the\npeer's hold time value as the hold time for the BGP connection between\nthe two peers.\n\n\nIf set, this value must be between 20 and 60. The default is 20.", + "format": "uint32", + "type": "integer" + } + }, + "type": "object" + }, + "RouterBgpPeer": { + "id": "RouterBgpPeer", + "properties": { + "advertiseMode": { + "description": "User-specified flag to indicate which mode to use for advertisement.", + "enum": [ + "CUSTOM", + "DEFAULT" ], - "request": { - "$ref": "Subnetwork" + "enumDescriptions": [ + "", + "" + ], + "type": "string" + }, + "advertisedGroups": { + "description": "User-specified list of prefix groups to advertise in custom mode,\nwhich currently supports the following option:\n \n - ALL_SUBNETS: Advertises all of the router's own VPC subnets. This\n excludes any routes learned for subnets that use\n VPC Network Peering.\n\n\nNote that this field can only be populated if advertise_mode is CUSTOM\nand overrides the list defined for the router (in the \"bgp\" message).\nThese groups are advertised in addition to any specified prefixes.\nLeave this field blank to advertise no custom groups.", + "items": { + "enum": [ + "ALL_SUBNETS" + ], + "enumDescriptions": [ + "Advertise all available subnets (including peer VPC subnets)." + ], + "type": "string" }, - "response": { - "$ref": "Operation" + "type": "array" + }, + "advertisedIpRanges": { + "description": "User-specified list of individual IP ranges to advertise in custom mode.\nThis field can only be populated if advertise_mode is CUSTOM and\noverrides the list defined for the router (in the \"bgp\" message).\nThese IP ranges are advertised in addition to any specified groups.\nLeave this field blank to advertise no custom IP ranges.", + "items": { + "$ref": "RouterAdvertisedIpRange" }, - "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." + "type": "array" }, - "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" - } + "advertisedRoutePriority": { + "description": "The priority of routes advertised to this BGP peer. Where there is more\nthan one matching route of maximum length, the routes with the lowest\npriority value win.", + "format": "uint32", + "type": "integer" + }, + "bfd": { + "$ref": "RouterBgpPeerBfd", + "description": "BFD configuration for the BGP peering." + }, + "customLearnedIpRanges": { + "description": "A list of user-defined custom learned route IP address ranges for a BGP\nsession.", + "items": { + "$ref": "RouterBgpPeerCustomLearnedIpRange" }, - "parameterOrder": [ - "project", - "region", - "subnetwork" + "type": "array" + }, + "customLearnedRoutePriority": { + "description": "The user-defined custom learned route priority for a BGP session. This\nvalue is applied to all custom learned route ranges for the session.\nYou can choose a value from `0` to `65335`. If you don't provide a\nvalue, Google Cloud assigns a priority of `100` to the ranges.", + "format": "int32", + "type": "integer" + }, + "enable": { + "description": "The status of the BGP peer connection.\n\n\nIf set to FALSE, any active session with the peer is terminated and\nall associated routing information is removed. If set to TRUE, the\npeer connection can be established with routing information. The default\nis TRUE.", + "enum": [ + "FALSE", + "TRUE" ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "", + "" ], - "description": "Deletes the specified subnetwork." + "type": "string" }, - "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" - } + "enableIpv4": { + "description": "Enable IPv4 traffic over BGP Peer. It is enabled by default if\nthe peerIpAddress is version 4.", + "type": "boolean" + }, + "enableIpv6": { + "description": "Enable IPv6 traffic over BGP Peer. It is enabled by default if the\npeerIpAddress is version 6.", + "type": "boolean" + }, + "exportPolicies": { + "description": "List of export policies applied to this peer, in the order they must be\nevaluated. The name must correspond to an existing policy that has\nROUTE_POLICY_TYPE_EXPORT type.", + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "region", - "subnetwork" + "type": "array" + }, + "importPolicies": { + "description": "List of import policies applied to this peer, in the order they must be\nevaluated. The name must correspond to an existing policy that has\nROUTE_POLICY_TYPE_IMPORT type.", + "items": { + "type": "string" + }, + "type": "array" + }, + "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" + }, + "ipv4NexthopAddress": { + "description": "IPv4 address of the interface inside Google Cloud Platform.", + "type": "string" + }, + "ipv6NexthopAddress": { + "description": "IPv6 address of the interface inside Google Cloud Platform.", + "type": "string" + }, + "managementType": { + "description": "Output only. [Output Only] The resource that configures and manages this BGP peer.\n \n - MANAGED_BY_USER is the default value and can be managed by you\n or other users\n - MANAGED_BY_ATTACHMENT is a BGP peer that is configured and managed\n by Cloud Interconnect, specifically by an InterconnectAttachment of type\n PARTNER. Google automatically creates, updates, and deletes this type of\n BGP peer when the PARTNER InterconnectAttachment is created, updated,\n or deleted.", + "enum": [ + "MANAGED_BY_ATTACHMENT", + "MANAGED_BY_USER" ], - "request": { - "$ref": "SubnetworksExpandIpCidrRangeRequest" + "enumDescriptions": [ + "The BGP peer is automatically created for PARTNER type\nInterconnectAttachment; Google will automatically create/delete\nthis BGP peer when the PARTNER InterconnectAttachment is\ncreated/deleted, and Google will update the ipAddress and\npeerIpAddress when the PARTNER InterconnectAttachment is provisioned.\nThis type of BGP peer cannot be created or deleted, but can be\nmodified for all fields except for name, ipAddress and peerIpAddress.", + "Default value, the BGP peer is manually created and managed by user." + ], + "readOnly": true, + "type": "string" + }, + "md5AuthenticationKeyName": { + "description": "Present if MD5 authentication is enabled for the peering. Must be the\nname of one of the entries in the Router.md5_authentication_keys. The\nfield must comply with RFC1035.", + "type": "string" + }, + "name": { + "annotations": { + "required": [ + "compute.routers.insert" + ] }, - "response": { - "$ref": "Operation" + "description": "Name of this BGP peer.\nThe name must be 1-63 characters long, and comply withRFC1035. Specifically, the name must be 1-63\ncharacters long and match the regular expression\n`[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a\nlowercase letter, and all following characters must be a dash, lowercase\nletter, or digit, except the last character, which cannot be a dash.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "peerAsn": { + "annotations": { + "required": [ + "compute.routers.insert" + ] }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "description": "Peer BGP Autonomous System Number (ASN). Each BGP interface may use\na different value.", + "format": "uint32", + "type": "integer" + }, + "peerIpAddress": { + "description": "IP address of the BGP interface outside Google Cloud Platform.", + "type": "string" + }, + "peerIpv4NexthopAddress": { + "description": "IPv4 address of the BGP interface outside Google Cloud Platform.", + "type": "string" + }, + "peerIpv6NexthopAddress": { + "description": "IPv6 address of the BGP interface outside Google Cloud Platform.", + "type": "string" + }, + "routerApplianceInstance": { + "description": "URI of the VM instance that is used as third-party router\nappliances such as Next Gen Firewalls, Virtual Routers, or Router\nAppliances. The VM instance must be located in zones contained in the\nsame region as this Cloud Router.\nThe VM instance is the peer side of the BGP session.", + "type": "string" + } + }, + "type": "object" + }, + "RouterBgpPeerBfd": { + "id": "RouterBgpPeerBfd", + "properties": { + "minReceiveInterval": { + "description": "The minimum interval, in milliseconds, between BFD control packets\nreceived from the peer router. The actual value is negotiated between\nthe two routers and is equal to the greater of this value and the\ntransmit interval of the other router.\n\n\nIf set, this value must be between 1000 and 30000.\n\n\nThe default is 1000.", + "format": "uint32", + "type": "integer" + }, + "minTransmitInterval": { + "description": "The minimum interval, in milliseconds, between BFD control packets\ntransmitted to the peer router. The actual value is negotiated between\nthe two routers and is equal to the greater of this value and the\ncorresponding receive interval of the other router.\n\n\nIf set, this value must be between 1000 and 30000.\n\n\nThe default is 1000.", + "format": "uint32", + "type": "integer" + }, + "multiplier": { + "description": "The number of consecutive BFD packets that must be missed\nbefore BFD declares that a peer is unavailable.\n\n\nIf set, the value must be a value between 5 and 16.\n\n\nThe default is 5.", + "format": "uint32", + "type": "integer" + }, + "sessionInitializationMode": { + "description": "The BFD session initialization mode for this BGP peer.\n\n\nIf set to ACTIVE, the Cloud Router will initiate the BFD session for\nthis BGP peer. If set to PASSIVE, the Cloud Router will wait for the\npeer router to initiate the BFD session for this BGP peer. If set to\nDISABLED, BFD is disabled for this BGP peer. The default is DISABLED.", + "enum": [ + "ACTIVE", + "DISABLED", + "PASSIVE" + ], + "enumDescriptions": [ + "", + "", + "" ], - "description": "Expands the IP CIDR range of the subnetwork to a specified value." + "type": "string" + } + }, + "type": "object" + }, + "RouterBgpPeerCustomLearnedIpRange": { + "id": "RouterBgpPeerCustomLearnedIpRange", + "properties": { + "range": { + "description": "The custom learned route IP address range. Must be a valid\nCIDR-formatted prefix. If an IP address is provided without a subnet\nmask, it is interpreted as, for IPv4, a `/32` singular IP address\nrange, and, for IPv6, `/128`.", + "type": "string" + } + }, + "type": "object" + }, + "RouterInterface": { + "id": "RouterInterface", + "properties": { + "ipRange": { + "description": "IP address and range of the interface.\n \n - For Internet Protocol version 4 (IPv4), the IP range must be in theRFC3927 link-local IP address space. The value must\n be a CIDR-formatted string, for example, 169.254.0.1/30.\n Note: Do not truncate the IP address, as it represents the IP address of\n the interface. \n - For Internet Protocol version 6 (IPv6), the value\n must be a unique local address (ULA) range from fdff:1::/64\n with a mask length of 126 or less. This value should be a CIDR-formatted\n string, for example, fdff:1::1/112. Within the router's\n VPC, this IPv6 prefix will be reserved exclusively for this connection\n and cannot be used for any other purpose.", + "type": "string" }, - "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, + "ipVersion": { + "description": "IP version of this interface.", + "enum": [ + "IPV4", + "IPV6" + ], + "enumDescriptions": [ + "", + "" + ], + "type": "string" + }, + "linkedInterconnectAttachment": { + "description": "URI of the linked Interconnect attachment. It must be in the same region\nas the router. Each interface can have one linked resource, which can be\na VPN tunnel, an Interconnect attachment, or a subnetwork.", + "type": "string" + }, + "linkedVpnTunnel": { + "description": "URI of the linked VPN tunnel, which must be in the same region as the\nrouter. Each interface can have one linked resource, which can be\na VPN tunnel, an Interconnect attachment, or a subnetwork.", + "type": "string" + }, + "managementType": { + "description": "Output only. [Output Only] The resource that configures and manages this interface.\n \n - MANAGED_BY_USER is the default value and can be managed directly\n by users.\n - MANAGED_BY_ATTACHMENT is an interface that is configured and\n managed by Cloud Interconnect, specifically, by an InterconnectAttachment\n of type PARTNER. Google automatically creates, updates, and deletes\n this type of interface when the PARTNER InterconnectAttachment is\n created, updated, or deleted.", + "enum": [ + "MANAGED_BY_ATTACHMENT", + "MANAGED_BY_USER" + ], + "enumDescriptions": [ + "The interface is automatically created for PARTNER type\nInterconnectAttachment, Google will automatically create/update/delete\nthis interface when the PARTNER InterconnectAttachment is\ncreated/provisioned/deleted.\nThis type of interface cannot be manually managed by user.", + "Default value, the interface is manually created and managed by user." + ], + "readOnly": true, + "type": "string" + }, + "name": { + "annotations": { + "required": [ + "compute.routers.insert" + ] + }, + "description": "Name of this interface entry.\nThe name must be 1-63 characters long, and comply withRFC1035. Specifically, the name must be 1-63\ncharacters long and match the regular expression\n`[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a\nlowercase letter, and all following characters must be a dash, lowercase\nletter, or digit, except the last character, which cannot be a dash.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "privateIpAddress": { + "description": "The regional private internal IP address that is used to establish\nBGP sessions to a VM instance acting as a third-party\nRouter Appliance, such as a Next Gen Firewall, a Virtual Router, or\nan SD-WAN VM.", + "type": "string" + }, + "redundantInterface": { + "description": "Name of the interface that will be redundant with the current interface\nyou are creating. The redundantInterface must belong to the same Cloud\nRouter as the interface here. To establish the BGP session to a Router\nAppliance VM, you must create two BGP peers. The two BGP peers must be\nattached to two separate interfaces that are redundant with each other.\nThe redundant_interface must be 1-63 characters long, and comply withRFC1035. Specifically, the redundant_interface must\nbe 1-63 characters long and match the regular expression\n`[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a\nlowercase letter, and all following characters must be a dash, lowercase\nletter, 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\nmust be in the same region as the Cloud Router.\nWhen you establish a BGP session to a VM instance using this interface,\nthe VM instance must belong to the same subnetwork as the subnetwork\nspecified here.", + "type": "string" + } + }, + "type": "object" + }, + "RouterList": { + "description": "Contains a list of Router resources.", + "id": "RouterList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of Router resources.", + "items": { + "$ref": "Router" + }, + "type": "array" + }, + "kind": { + "default": "compute#routerList", + "description": "Output only. [Output Only] Type of resource. Always compute#router for\nrouters.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project", - "region", - "subnetwork" - ], - "request": { - "$ref": "Subnetwork" + "type": "object" + } + }, + "type": "object" + }, + "RouterMd5AuthenticationKey": { + "id": "RouterMd5AuthenticationKey", + "properties": { + "key": { + "annotations": { + "required": [ + "compute.routers.insert" + ] }, - "response": { - "$ref": "Operation" + "description": "[Input only] Value of the key.\n\nFor patch and update calls, it can be skipped to\ncopy the value from the previous configuration. This is allowed if the\nkey with the same name existed before the operation. Maximum length is 80\ncharacters. Can only contain printable ASCII characters.", + "type": "string" + }, + "name": { + "annotations": { + "required": [ + "compute.routers.insert", + "compute.routers.update" + ] }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "description": "Name used to identify the key.\n\nMust be unique within a router. Must be referenced by exactly\none bgpPeer. Must comply withRFC1035.", + "type": "string" + } + }, + "type": "object" + }, + "RouterNat": { + "description": "Represents a Nat resource. It enables the VMs within the specified\nsubnetworks to access Internet without external IP addresses. It specifies\na list of subnetworks (and the ranges within) that want to use NAT.\nCustomers can also provide the external IPs that would be used for NAT. GCP\nwould auto-allocate ephemeral IPs if no external IPs are provided.", + "id": "RouterNat", + "properties": { + "autoNetworkTier": { + "description": "The network tier to use when automatically reserving NAT IP addresses.\nMust be one of: PREMIUM, STANDARD.\nIf not specified, then the current \nproject-level default tier is used.", + "enum": [ + "FIXED_STANDARD", + "PREMIUM", + "STANDARD", + "STANDARD_OVERRIDES_FIXED_STANDARD" ], - "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." + "enumDescriptions": [ + "Public internet quality with fixed bandwidth.", + "High quality, Google-grade network tier, support for all networking\nproducts.", + "Public internet quality, only limited support for other networking\nproducts.", + "(Output only) Temporary tier for FIXED_STANDARD when fixed standard tier\nis expired or not configured." + ], + "type": "string" }, - "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" - } + "drainNatIps": { + "description": "A list of URLs of the IP resources to be drained. These IPs\nmust be valid static external IPs that have been assigned to the NAT.\nThese IPs should be used for updating/patching a NAT only.", + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "region", - "resource" - ], - "response": { - "$ref": "Policy" + "type": "array" + }, + "effectiveTcpTimeWaitTimeoutSec": { + "description": "Output only. Effective timeout (in seconds) for TCP connections that are in TIME_WAIT\nstate. This value is equal to tcp_time_wait_timeout_sec.\nIf tcp_time_wait_timeout_sec isn't set, the effective timeout is 30s or\n120s. The field is output only.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "enableDynamicPortAllocation": { + "description": "Enable Dynamic Port Allocation.\n\n\nIf not specified, it is disabled by default.\n\n\nIf set to true,\n \n - Dynamic Port Allocation will be enabled on this NAT\n config.\n - enableEndpointIndependentMapping cannot be set to true.\n - If minPorts is set, minPortsPerVm must be set to a\n power of two greater than or equal to 32. If minPortsPerVm is not set, a\n minimum of 32 ports will be allocated to a VM from this NAT\n config.", + "type": "boolean" + }, + "enableEndpointIndependentMapping": { + "type": "boolean" + }, + "endpointTypes": { + "description": "List of NAT-ted endpoint types supported by the Nat Gateway. If the list\nis empty, then it will be equivalent to include ENDPOINT_TYPE_VM", + "items": { + "enum": [ + "ENDPOINT_TYPE_MANAGED_PROXY_LB", + "ENDPOINT_TYPE_SWG", + "ENDPOINT_TYPE_VM" + ], + "enumDescriptions": [ + "This is used for regional Application Load Balancers (internal and\nexternal) and regional proxy Network Load Balancers (internal and\nexternal) endpoints.", + "This is used for Secure Web Gateway endpoints.", + "This is the default." + ], + "type": "string" }, - "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": "array" }, - "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" - } + "icmpIdleTimeoutSec": { + "description": "Timeout (in seconds) for ICMP connections. Defaults to 30s if not set.", + "format": "int32", + "type": "integer" + }, + "logConfig": { + "$ref": "RouterNatLogConfig", + "description": "Configure logging on this NAT." + }, + "maxPortsPerVm": { + "description": "Maximum number of ports allocated to a VM from this NAT config when\nDynamic Port Allocation is enabled.\n\n\nIf Dynamic Port Allocation is not enabled, this field has no effect.\n\n\nIf Dynamic Port Allocation is enabled, and this field is set, it must be\nset to a power of two greater than minPortsPerVm, or 64 if minPortsPerVm\nis not set.\n\n\nIf Dynamic Port Allocation is enabled and this field is not set,\na maximum of 65536 ports will be allocated to a VM from this NAT\nconfig.", + "format": "int32", + "type": "integer" + }, + "minPortsPerVm": { + "description": "Minimum number of ports allocated to a VM from this NAT config. If not\nset, a default number of ports is allocated to a VM. This is rounded\nup to the nearest power of 2. For example, if the value of this field is\n50, at least 64 ports are allocated to a VM.", + "format": "int32", + "type": "integer" + }, + "name": { + "description": "Unique name of this Nat service.\nThe name must be 1-63 characters long and comply withRFC1035.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "nat64Subnetworks": { + "description": "List of Subnetwork resources whose traffic should be translated by NAT64\nGateway. It is used only when LIST_OF_IPV6_SUBNETWORKS is\nselected for the SubnetworkIpRangeToNat64Option above.", + "items": { + "$ref": "RouterNatSubnetworkToNat64" }, - "parameterOrder": [ - "project", - "region", - "resource" + "type": "array" + }, + "natIpAllocateOption": { + "description": "Specify the NatIpAllocateOption, which can take one of the following\nvalues: \n \n - MANUAL_ONLY: Uses only Nat IP addresses provided by\n customers. When there are not enough specified Nat IPs, the Nat service\n fails for new VMs.\n - AUTO_ONLY: Nat IPs are allocated by Google Cloud Platform; customers\n can't specify any Nat IPs. When choosing AUTO_ONLY, then nat_ip should\n be empty.", + "enum": [ + "AUTO_ONLY", + "MANUAL_ONLY" ], - "request": { - "$ref": "RegionSetPolicyRequest" + "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\nenough then the Nat service fails for new VMs." + ], + "type": "string" + }, + "natIps": { + "description": "A list of URLs of the IP resources used for this Nat service. These IP\naddresses must be valid static external IP addresses assigned to the\nproject.", + "items": { + "type": "string" }, - "response": { - "$ref": "Policy" + "type": "array" + }, + "rules": { + "description": "A list of rules associated with this NAT.", + "items": { + "$ref": "RouterNatRule" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "type": "array" + }, + "sourceSubnetworkIpRangesToNat": { + "description": "Specify the Nat option, which can take one of the following values:\n \n - ALL_SUBNETWORKS_ALL_IP_RANGES: All of the IP ranges in every\n Subnetwork are allowed to Nat.\n - ALL_SUBNETWORKS_ALL_PRIMARY_IP_RANGES: All of the primary IP ranges\n in every Subnetwork are allowed to Nat.\n - LIST_OF_SUBNETWORKS: A list of Subnetworks are allowed to Nat\n (specified in the field subnetwork below)\n\n\nThe default is SUBNETWORK_IP_RANGE_TO_NAT_OPTION_UNSPECIFIED.\nNote that if this field contains ALL_SUBNETWORKS_ALL_IP_RANGES then there\nshould not be any other Router.Nat section in any Router for this network\nin this region.", + "enum": [ + "ALL_SUBNETWORKS_ALL_IP_RANGES", + "ALL_SUBNETWORKS_ALL_PRIMARY_IP_RANGES", + "LIST_OF_SUBNETWORKS" + ], + "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\nsubnetwork below)" ], - "description": "Sets the access control policy on the specified resource. Replaces any existing policy." + "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" - } + "sourceSubnetworkIpRangesToNat64": { + "description": "Specify the Nat option for NAT64, which can take one of the following\nvalues: \n \n - ALL_IPV6_SUBNETWORKS: All of the IP ranges in\n every Subnetwork are allowed to Nat.\n - LIST_OF_IPV6_SUBNETWORKS: A list of Subnetworks are allowed to Nat\n (specified in the field nat64_subnetwork below)\n\n\nThe default is NAT64_OPTION_UNSPECIFIED.\nNote that if this field contains NAT64_ALL_V6_SUBNETWORKS no other\nRouter.Nat section in this region can also enable NAT64 for any\nSubnetworks in this network. Other Router.Nat sections can still be\npresent to enable NAT44 only.", + "enum": [ + "ALL_IPV6_SUBNETWORKS", + "LIST_OF_IPV6_SUBNETWORKS" + ], + "enumDescriptions": [ + "NAT64 is enabled for all the IPv6 subnet ranges.\nIn dual stack subnets, NAT64 will only be enabled for IPv6-only VMs.", + "NAT64 is enabled for a list of IPv6 subnet ranges.\nIn dual stack subnets, NAT64 will only be enabled for IPv6-only VMs.\nIf this option is used, the nat64_subnetworks field must be specified." + ], + "type": "string" + }, + "subnetworks": { + "description": "A list of Subnetwork resources whose traffic should be translated by NAT\nGateway. It is used only when LIST_OF_SUBNETWORKS is selected for the\nSubnetworkIpRangeToNatOption above.", + "items": { + "$ref": "RouterNatSubnetworkToNat" }, - "parameterOrder": [ - "project", - "region", - "resource" + "type": "array" + }, + "tcpEstablishedIdleTimeoutSec": { + "description": "Timeout (in seconds) for TCP established connections. Defaults to 1200s\nif not set.", + "format": "int32", + "type": "integer" + }, + "tcpTimeWaitTimeoutSec": { + "description": "Timeout (in seconds) for TCP connections that are in TIME_WAIT state.\nDefaults to 120s if not set.", + "format": "int32", + "type": "integer" + }, + "tcpTransitoryIdleTimeoutSec": { + "description": "Timeout (in seconds) for TCP transitory connections. Defaults to 30s if\nnot set.", + "format": "int32", + "type": "integer" + }, + "type": { + "description": "Indicates whether this NAT is used for public or private IP\ntranslation. If unspecified, it defaults to PUBLIC.", + "enum": [ + "PRIVATE", + "PUBLIC" ], - "request": { - "$ref": "TestPermissionsRequest" + "enumDescriptions": [ + "NAT used for private IP translation.", + "NAT used for public IP translation.\nThis is the default." + ], + "type": "string" + }, + "udpIdleTimeoutSec": { + "description": "Timeout (in seconds) for UDP connections. Defaults to 30s if not set.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, + "RouterNatLogConfig": { + "description": "Configuration of logging on a NAT.", + "id": "RouterNatLogConfig", + "properties": { + "enable": { + "description": "Indicates whether or not to export logs. This is false by default.", + "type": "boolean" + }, + "filter": { + "description": "Specify the desired filtering of logs on this NAT. If unspecified,\nlogs are exported for all connections handled by this NAT.\nThis option can take one of the following values:\n \n - ERRORS_ONLY: Export logs only for connection failures.\n - TRANSLATIONS_ONLY: Export logs only for successful\n connections.\n - ALL: Export logs for all connections, successful and\n unsuccessful.", + "enum": [ + "ALL", + "ERRORS_ONLY", + "TRANSLATIONS_ONLY" + ], + "enumDescriptions": [ + "Export logs for all (successful and unsuccessful) connections.", + "Export logs for connection failures only.", + "Export logs for successful connections only." + ], + "type": "string" + } + }, + "type": "object" + }, + "RouterNatRule": { + "id": "RouterNatRule", + "properties": { + "action": { + "$ref": "RouterNatRuleAction", + "description": "The action to be enforced for traffic that matches this rule." + }, + "description": { + "description": "An optional description of this rule.", + "type": "string" + }, + "match": { + "description": "CEL expression that specifies the match condition that egress traffic\nfrom a VM is evaluated against. If it evaluates to true, the\ncorresponding `action` is enforced.\n\nThe following examples are valid match expressions for public NAT:\n\n`inIpRange(destination.ip, '1.1.0.0/16') || inIpRange(destination.ip,\n '2.2.0.0/16')`\n\n`destination.ip == '1.1.0.1' || destination.ip == '8.8.8.8'`\n\nThe following example is a valid match expression for private NAT:\n\n`nexthop.hub ==\n'//networkconnectivity.googleapis.com/projects/my-project/locations/global/hubs/hub-1'`", + "type": "string" + }, + "ruleNumber": { + "description": "An integer uniquely identifying a rule in the list. The rule number\nmust be a positive value between 0 and 65000, and\nmust be unique among rules within a NAT.", + "format": "uint32", + "type": "integer" + } + }, + "type": "object" + }, + "RouterNatRuleAction": { + "id": "RouterNatRuleAction", + "properties": { + "sourceNatActiveIps": { + "description": "A list of URLs of the IP resources used for this NAT rule. These IP\naddresses must be valid static external IP addresses assigned to the\nproject.\nThis field is used for public NAT.", + "items": { + "type": "string" }, - "response": { - "$ref": "TestPermissionsResponse" + "type": "array" + }, + "sourceNatActiveRanges": { + "description": "A list of URLs of the subnetworks used as source ranges for this\nNAT Rule. These subnetworks must have purpose set to PRIVATE_NAT.\nThis field is used for private NAT.", + "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": "Returns permissions that a caller has on the specified resource." + "type": "array" }, - "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" - } + "sourceNatDrainIps": { + "description": "A list of URLs of the IP resources to be drained. These IPs\nmust be valid static external IPs that have been assigned to the NAT.\nThese IPs should be used for updating/patching a NAT rule only.\nThis field is used for public NAT.", + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "region", - "subnetwork" - ], - "request": { - "$ref": "SubnetworksSetPrivateIpGoogleAccessRequest" + "type": "array" + }, + "sourceNatDrainRanges": { + "description": "A list of URLs of subnetworks representing source ranges to be\ndrained. This is only supported on patch/update, and these\nsubnetworks must have previously been used as active ranges in this\nNAT Rule.\nThis field is used for private NAT.", + "items": { + "type": "string" }, - "response": { - "$ref": "Operation" + "type": "array" + } + }, + "type": "object" + }, + "RouterNatSubnetworkToNat": { + "description": "Defines the IP ranges that want to use NAT for a subnetwork.", + "id": "RouterNatSubnetworkToNat", + "properties": { + "name": { + "description": "URL for the subnetwork resource that will use NAT.", + "type": "string" + }, + "secondaryIpRangeNames": { + "description": "A list of the secondary ranges of the Subnetwork that are allowed to\nuse NAT. This can be populated only if \"LIST_OF_SECONDARY_IP_RANGES\"\nis one of the values in source_ip_ranges_to_nat.", + "items": { + "type": "string" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Set whether VMs in this subnet can access Google services without assigning external IP addresses through Private Google Access." + "type": "array" + }, + "sourceIpRangesToNat": { + "description": "Specify the options for NAT ranges in the Subnetwork. All\noptions of a single value are valid except\nNAT_IP_RANGE_OPTION_UNSPECIFIED.\nThe only valid option with multiple values is: [\"PRIMARY_IP_RANGE\",\n\"LIST_OF_SECONDARY_IP_RANGES\"]\nDefault: [ALL_IP_RANGES]", + "items": { + "enum": [ + "ALL_IP_RANGES", + "LIST_OF_SECONDARY_IP_RANGES", + "PRIMARY_IP_RANGE" + ], + "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." + ], + "type": "string" + }, + "type": "array" } - } + }, + "type": "object" }, - "networkProfiles": { - "methods": { - "list": { - "id": "compute.networkProfiles.list", - "path": "projects/{project}/global/networkProfiles", - "flatPath": "projects/{project}/global/networkProfiles", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not 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" - } + "RouterNatSubnetworkToNat64": { + "description": "Specifies a subnetwork to enable NAT64.", + "id": "RouterNatSubnetworkToNat64", + "properties": { + "name": { + "description": "URL for the subnetwork resource that will use NAT64.", + "type": "string" + } + }, + "type": "object" + }, + "RouterParams": { + "description": "Additional router parameters.", + "id": "RouterParams", + "properties": { + "resourceManagerTags": { + "additionalProperties": { + "type": "string" }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "NetworkProfilesListResponse" + "description": "Tag keys/values directly bound to this resource.\nThe field is allowed for INSERT\nonly. The keys/values to set on the resource should be specified in\neither ID { : } or Namespaced format\n{ : }.\nFor example the following are valid inputs:\n* {\"tagKeys/333\" : \"tagValues/444\", \"tagKeys/123\" : \"tagValues/456\"}\n* {\"123/environment\" : \"production\", \"345/abc\" : \"xyz\"}\nNote:\n* Invalid combinations of ID & namespaced format is not supported. For\n instance: {\"123/environment\" : \"tagValues/444\"} is invalid.\n* Inconsistent format is not supported. For instance:\n {\"tagKeys/333\" : \"tagValues/444\", \"123/env\" : \"prod\"} is invalid.", + "type": "object" + } + }, + "type": "object" + }, + "RouterStatus": { + "id": "RouterStatus", + "properties": { + "bestRoutes": { + "description": "A list of the best dynamic routes for this Cloud Router's Virtual Private\nCloud (VPC) network in the same region as this Cloud Router.\n\nLists all of the best routes per prefix that are programmed into this\nregion's VPC data plane.\n\nWhen global dynamic routing mode is turned on in the VPC network, this list\ncan include cross-region dynamic routes from Cloud Routers in other\nregions.", + "items": { + "$ref": "Route" + }, + "type": "array" + }, + "bestRoutesForRouter": { + "description": "A list of the best BGP routes learned by this Cloud Router.\n\nIt is possible that routes listed might not be programmed into the data\nplane, if the Google Cloud control plane finds a more optimal route for a\nprefix than a route learned by this Cloud Router.", + "items": { + "$ref": "Route" }, - "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 network profiles available to the specified project." + "type": "array" }, - "get": { - "id": "compute.networkProfiles.get", - "path": "projects/{project}/global/networkProfiles/{networkProfile}", - "flatPath": "projects/{project}/global/networkProfiles/{networkProfile}", - "httpMethod": "GET", - "parameters": { - "networkProfile": { - "description": "Name of the network profile 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" - } + "bgpPeerStatus": { + "items": { + "$ref": "RouterStatusBgpPeerStatus" }, - "parameterOrder": [ - "project", - "networkProfile" - ], - "response": { - "$ref": "NetworkProfile" + "type": "array" + }, + "natStatus": { + "items": { + "$ref": "RouterStatusNatStatus" }, - "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 profile." + "type": "array" + }, + "nccGateway": { + "description": "URI of the ncc_gateway to which this router associated.", + "type": "string" + }, + "network": { + "description": "URI of the network to which this router belongs.", + "type": "string" } - } + }, + "type": "object" }, - "reservationBlocks": { - "methods": { - "get": { - "id": "compute.reservationBlocks.get", - "path": "projects/{project}/zones/{zone}/reservations/{reservation}/reservationBlocks/{reservationBlock}", - "flatPath": "projects/{project}/zones/{zone}/reservations/{reservation}/reservationBlocks/{reservationBlock}", - "httpMethod": "GET", - "parameters": { - "project": { - "description": "Project ID for this request.", - "location": "path", - "required": true, - "type": "string" - }, - "reservation": { - "description": "The name of the reservation. Name should conform to RFC1035 or be a resource ID.", - "location": "path", - "required": true, - "type": "string" - }, - "reservationBlock": { - "description": "The name of the reservation block. Name should conform to RFC1035 or be a resource ID.", - "location": "path", - "required": true, - "type": "string" - }, - "zone": { - "description": "Name of the zone for this request. Zone name should conform to RFC1035.", - "location": "path", - "required": true, - "type": "string" - } + "RouterStatusBgpPeerStatus": { + "id": "RouterStatusBgpPeerStatus", + "properties": { + "advertisedRoutes": { + "description": "Routes that were advertised to the remote BGP peer", + "items": { + "$ref": "Route" }, - "parameterOrder": [ - "project", - "zone", - "reservation", - "reservationBlock" + "type": "array" + }, + "bfdStatus": { + "$ref": "BfdStatus" + }, + "enableIpv4": { + "description": "Output only. Enable IPv4 traffic over BGP Peer.\nIt is enabled by default if the peerIpAddress is version 4.", + "readOnly": true, + "type": "boolean" + }, + "enableIpv6": { + "description": "Output only. Enable IPv6 traffic over BGP Peer.\nIt is enabled by default if the peerIpAddress is version 6.", + "readOnly": true, + "type": "boolean" + }, + "ipAddress": { + "description": "Output only. IP address of the local BGP interface.", + "readOnly": true, + "type": "string" + }, + "ipv4NexthopAddress": { + "description": "Output only. IPv4 address of the local BGP interface.", + "readOnly": true, + "type": "string" + }, + "ipv6NexthopAddress": { + "description": "Output only. IPv6 address of the local BGP interface.", + "readOnly": true, + "type": "string" + }, + "linkedVpnTunnel": { + "description": "Output only. URL of the VPN tunnel that this BGP peer controls.", + "readOnly": true, + "type": "string" + }, + "md5AuthEnabled": { + "description": "Informs whether MD5 authentication is enabled on this BGP peer.", + "type": "boolean" + }, + "name": { + "description": "Output only. Name of this BGP peer. Unique within the Routers resource.", + "readOnly": true, + "type": "string" + }, + "numLearnedRoutes": { + "description": "Output only. Number of routes learned from the remote BGP Peer.", + "format": "uint32", + "readOnly": true, + "type": "integer" + }, + "peerIpAddress": { + "description": "Output only. IP address of the remote BGP interface.", + "readOnly": true, + "type": "string" + }, + "peerIpv4NexthopAddress": { + "description": "Output only. IPv4 address of the remote BGP interface.", + "readOnly": true, + "type": "string" + }, + "peerIpv6NexthopAddress": { + "description": "Output only. IPv6 address of the remote BGP interface.", + "readOnly": true, + "type": "string" + }, + "routerApplianceInstance": { + "description": "Output only. [Output only] URI of the VM instance that is used as third-party router\nappliances such as Next Gen Firewalls, Virtual Routers, or Router\nAppliances.\nThe VM instance is the peer side of the BGP session.", + "readOnly": true, + "type": "string" + }, + "state": { + "description": "Output only. The state of the BGP session. For a list of possible values for this\nfield, seeBGP session states.", + "readOnly": true, + "type": "string" + }, + "status": { + "description": "Output only. Status of the BGP peer: {UP, DOWN}", + "enum": [ + "DOWN", + "UNKNOWN", + "UP" ], - "response": { - "$ref": "ReservationBlocksGetResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "", + "", + "" ], - "description": "Retrieves information about the specified reservation block." + "readOnly": true, + "type": "string" }, - "list": { - "id": "compute.reservationBlocks.list", - "path": "projects/{project}/zones/{zone}/reservations/{reservation}/reservationBlocks", - "flatPath": "projects/{project}/zones/{zone}/reservations/{reservation}/reservationBlocks", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not 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.", - "location": "path", - "required": true, - "type": "string" - }, - "reservation": { - "description": "The name of the reservation. Name should conform to RFC1035 or be a resource ID.", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, 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. Zone name should conform to RFC1035.", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "reservation" + "statusReason": { + "description": "Indicates why particular status was returned.", + "enum": [ + "IPV4_PEER_ON_IPV6_ONLY_CONNECTION", + "IPV6_PEER_ON_IPV4_ONLY_CONNECTION", + "MD5_AUTH_INTERNAL_PROBLEM", + "STATUS_REASON_UNSPECIFIED" ], - "response": { - "$ref": "ReservationBlocksListResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "BGP peer disabled because it requires IPv4 but the underlying\nconnection is IPv6-only.", + "BGP peer disabled because it requires IPv6 but the underlying\nconnection is IPv4-only.", + "Indicates internal problems with configuration of MD5 authentication.\nThis particular reason can only be returned when md5AuthEnabled is true\nand status is DOWN.", + "" ], - "description": "Retrieves a list of reservation blocks under a single reservation." + "type": "string" }, - "performMaintenance": { - "id": "compute.reservationBlocks.performMaintenance", - "path": "projects/{project}/zones/{zone}/reservations/{reservation}/reservationBlocks/{reservationBlock}/performMaintenance", - "flatPath": "projects/{project}/zones/{zone}/reservations/{reservation}/reservationBlocks/{reservationBlock}/performMaintenance", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for 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" - }, - "reservation": { - "description": "The name of the reservation. Name should conform to RFC1035 or be a resource ID.", - "location": "path", - "required": true, - "type": "string" - }, - "reservationBlock": { - "description": "The name of the reservation block. Name should conform to RFC1035 or be a resource ID.", - "location": "path", - "required": true, - "type": "string" - }, - "zone": { - "description": "Name of the zone for this request. Zone name should conform to RFC1035.", - "location": "path", - "required": true, - "type": "string" - } + "uptime": { + "description": "Output only. Time this session has been up.\nFormat:\n 14 years, 51 weeks, 6 days, 23 hours, 59 minutes, 59 seconds", + "readOnly": true, + "type": "string" + }, + "uptimeSeconds": { + "description": "Output only. Time this session has been up, in seconds.\nFormat:\n 145", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "RouterStatusNatStatus": { + "description": "Status of a NAT contained in this router.", + "id": "RouterStatusNatStatus", + "properties": { + "autoAllocatedNatIps": { + "description": "Output only. A list of IPs auto-allocated for NAT. Example: [\"1.1.1.1\", \"129.2.16.89\"]", + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "zone", - "reservation", - "reservationBlock" - ], - "request": { - "$ref": "ReservationsBlocksPerformMaintenanceRequest" + "readOnly": true, + "type": "array" + }, + "drainAutoAllocatedNatIps": { + "description": "Output only. A list of IPs auto-allocated for NAT that are in drain mode.\nExample: [\"1.1.1.1\", \"179.12.26.133\"].", + "items": { + "type": "string" }, - "response": { - "$ref": "Operation" + "readOnly": true, + "type": "array" + }, + "drainUserAllocatedNatIps": { + "description": "Output only. A list of IPs user-allocated for NAT that are in drain mode.\nExample: [\"1.1.1.1\", \"179.12.26.133\"].", + "items": { + "type": "string" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Allows customers to perform maintenance on a reservation block" - } - } - }, - "reservationSubBlocks": { - "methods": { - "get": { - "id": "compute.reservationSubBlocks.get", - "path": "projects/{project}/zones/{zone}/{parentName}/reservationSubBlocks/{reservationSubBlock}", - "flatPath": "projects/{project}/zones/{zone}/{parentName}/reservationSubBlocks/{reservationSubBlock}", - "httpMethod": "GET", - "parameters": { - "parentName": { - "description": "The name of the parent reservation and parent block. In the format of reservations/{reservation_name}/reservationBlocks/{reservation_block_name}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "location": "path", - "required": true, - "type": "string" - }, - "reservationSubBlock": { - "description": "The name of the reservation subBlock. Name should conform to RFC1035 or be a resource ID.", - "location": "path", - "required": true, - "type": "string" - }, - "zone": { - "description": "Name of the zone for this request. Zone name should conform to RFC1035.", - "location": "path", - "required": true, - "type": "string" - } + "readOnly": true, + "type": "array" + }, + "minExtraNatIpsNeeded": { + "description": "Output only. The number of extra IPs to allocate. This will be greater than 0 only if\nuser-specified IPs are NOT enough to allow all configured VMs to use NAT.\nThis value is meaningful only when auto-allocation of NAT IPs is *not*\nused.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "name": { + "description": "Output only. Unique name of this NAT.", + "readOnly": true, + "type": "string" + }, + "numVmEndpointsWithNatMappings": { + "description": "Output only. Number of VM endpoints (i.e., Nics) that can use NAT.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "ruleStatus": { + "description": "Status of rules in this NAT.", + "items": { + "$ref": "RouterStatusNatStatusNatRuleStatus" }, - "parameterOrder": [ - "project", - "zone", - "parentName", - "reservationSubBlock" - ], - "response": { - "$ref": "ReservationSubBlocksGetResponse" + "type": "array" + }, + "userAllocatedNatIpResources": { + "description": "Output only. A list of fully qualified URLs of reserved IP address resources.", + "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 information about the specified reservation subBlock." + "readOnly": true, + "type": "array" }, - "list": { - "id": "compute.reservationSubBlocks.list", - "path": "projects/{project}/zones/{zone}/{parentName}/reservationSubBlocks", - "flatPath": "projects/{project}/zones/{zone}/{parentName}/reservationSubBlocks", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not 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" - }, - "parentName": { - "description": "The name of the parent reservation and parent block. In the format of reservations/{reservation_name}/reservationBlocks/{reservation_block_name}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for 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" - }, - "zone": { - "description": "Name of the zone for this request. Zone name should conform to RFC1035.", - "location": "path", - "required": true, - "type": "string" - } + "userAllocatedNatIps": { + "description": "Output only. A list of IPs user-allocated for NAT.\nThey will be raw IP strings like \"179.12.26.133\".", + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "zone", - "parentName" - ], - "response": { - "$ref": "ReservationSubBlocksListResponse" + "readOnly": true, + "type": "array" + } + }, + "type": "object" + }, + "RouterStatusNatStatusNatRuleStatus": { + "description": "Status of a NAT Rule contained in this NAT.", + "id": "RouterStatusNatStatusNatRuleStatus", + "properties": { + "activeNatIps": { + "description": "Output only. A list of active IPs for NAT.\nExample: [\"1.1.1.1\", \"179.12.26.133\"].", + "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 reservation subBlocks under a single reservation." + "readOnly": true, + "type": "array" + }, + "drainNatIps": { + "description": "Output only. A list of IPs for NAT that are in drain mode.\nExample: [\"1.1.1.1\", \"179.12.26.133\"].", + "items": { + "type": "string" + }, + "readOnly": true, + "type": "array" + }, + "minExtraIpsNeeded": { + "description": "Output only. The number of extra IPs to allocate. This will be greater than 0 only\nif the existing IPs in this NAT Rule are NOT enough to allow all\nconfigured VMs to use NAT.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "numVmEndpointsWithNatMappings": { + "description": "Output only. Number of VM endpoints (i.e., NICs) that have NAT Mappings from this\nNAT Rule.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "ruleNumber": { + "description": "Output only. Rule number of the rule.", + "format": "int32", + "readOnly": true, + "type": "integer" } - } + }, + "type": "object" }, - "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" - } + "RouterStatusResponse": { + "id": "RouterStatusResponse", + "properties": { + "kind": { + "default": "compute#routerStatusResponse", + "description": "Output only. Type of resource.", + "readOnly": true, + "type": "string" + }, + "result": { + "$ref": "RouterStatus" + } + }, + "type": "object" + }, + "RoutersGetNamedSetResponse": { + "id": "RoutersGetNamedSetResponse", + "properties": { + "etag": { + "description": "end_interface: MixerGetResponseWithEtagBuilder", + "type": "string" + }, + "resource": { + "$ref": "NamedSet" + } + }, + "type": "object" + }, + "RoutersGetRoutePolicyResponse": { + "id": "RoutersGetRoutePolicyResponse", + "properties": { + "resource": { + "$ref": "RoutePolicy" + } + }, + "type": "object" + }, + "RoutersListBgpRoutes": { + "id": "RoutersListBgpRoutes", + "properties": { + "etag": { + "type": "string" + }, + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "type": "string" + }, + "kind": { + "default": "compute#routersListBgpRoutes", + "description": "Output only. [Output Only] Type of resource. Alwayscompute#routersListBgpRoutes for lists of bgp routes.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "result": { + "description": "[Output Only] A list of bgp routes.", + "items": { + "$ref": "BgpRoute" }, - "parameterOrder": [ - "project", - "region" - ], - "response": { - "$ref": "ResourcePolicyList" + "type": "array" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "unreachables": { + "description": "Output only. [Output Only] Unreachable resources.", + "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": "A list all the resource policies that have been configured for the specified project in specified region." + "readOnly": true, + "type": "array" }, - "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", + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "pageToken": { - "description": "Specifies a page token 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{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" } }, - "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`." + "type": "object" + } + }, + "type": "object" + }, + "RoutersListNamedSets": { + "id": "RoutersListNamedSets", + "properties": { + "etag": { + "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" - }, - "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" - }, - "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" - } + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "type": "string" + }, + "kind": { + "default": "compute#routersListNamedSets", + "description": "Output only. [Output Only] Type of resource. Alwayscompute#routersListNamedSets for lists of named sets.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "result": { + "description": "[Output Only] A list of named sets.", + "items": { + "$ref": "NamedSet" }, - "parameterOrder": [ - "project", - "region", - "resourcePolicy" - ], - "response": { - "$ref": "ResourcePolicy" + "type": "array" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "unreachables": { + "description": "Output only. [Output Only] Unreachable resources.", + "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 all information of the specified resource policy." + "readOnly": true, + "type": "array" }, - "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, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. 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" } }, - "parameterOrder": [ - "project", - "region" - ], - "request": { - "$ref": "ResourcePolicy" + "type": "object" + } + }, + "type": "object" + }, + "RoutersListRoutePolicies": { + "id": "RoutersListRoutePolicies", + "properties": { + "etag": { + "type": "string" + }, + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "type": "string" + }, + "kind": { + "default": "compute#routersListRoutePolicies", + "description": "Output only. [Output Only] Type of resource. Alwayscompute#routersListRoutePolicies for lists of route policies.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "result": { + "description": "[Output Only] A list of route policies.", + "items": { + "$ref": "RoutePolicy" }, - "response": { - "$ref": "Operation" + "type": "array" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "unreachables": { + "description": "Output only. [Output Only] Unreachable resources.", + "items": { + "type": "string" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Creates a new resource policy." + "readOnly": true, + "type": "array" }, - "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, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project", - "region", - "resourcePolicy" - ], - "response": { - "$ref": "Operation" + "type": "object" + } + }, + "type": "object" + }, + "RoutersPreviewResponse": { + "id": "RoutersPreviewResponse", + "properties": { + "resource": { + "$ref": "Router", + "description": "Preview of given router." + } + }, + "type": "object" + }, + "RoutersScopedList": { + "id": "RoutersScopedList", + "properties": { + "routers": { + "description": "A list of routers contained in this scope.", + "items": { + "$ref": "Router" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified resource policy." + "type": "array" }, - "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, + "warning": { + "description": "Informational warning which replaces the list of routers when\nthe list is empty.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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" } }, - "parameterOrder": [ - "project", - "region", - "resourcePolicy" + "type": "object" + } + }, + "type": "object" + }, + "SSLHealthCheck": { + "id": "SSLHealthCheck", + "properties": { + "port": { + "description": "The TCP port number to which the health check prober sends packets. The\ndefault value is 443. Valid values are 1 through65535.", + "format": "int32", + "type": "integer" + }, + "portName": { + "description": "Not supported.", + "type": "string" + }, + "portSpecification": { + "description": "Specifies how a port is selected for health checking. Can be one of the\nfollowing values: \nUSE_FIXED_PORT: Specifies a port number explicitly using theport field in the health check. Supported by backend services\nfor passthrough load balancers and backend services for proxy load\nbalancers. Not supported by target pools. The health check supports all\nbackends supported by the backend service provided the backend can be\nhealth checked. For example, GCE_VM_IP network endpoint\ngroups, GCE_VM_IP_PORT network endpoint groups, and instance\ngroup backends. \n USE_NAMED_PORT: Not supported. \nUSE_SERVING_PORT: Provides an indirect method of specifying\nthe health check port by referring to the backend service. Only supported\nby backend services for proxy load balancers. Not supported by target\npools. Not supported by backend services for passthrough load balancers.\nSupports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group\nbackends.\n\nFor GCE_VM_IP_PORT network endpoint group backends, the health\ncheck uses the port number specified for each endpoint in the network\nendpoint group. For instance group backends, the health check uses the\nport number determined by looking up the backend service's named port in\nthe instance group's list of named ports.", + "enum": [ + "USE_FIXED_PORT", + "USE_NAMED_PORT", + "USE_SERVING_PORT" ], - "request": { - "$ref": "ResourcePolicy" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "The port number in the health check's port is used for health\nchecking. Applies to network endpoint group and instance group backends.", + "Not supported.", + "For network endpoint group backends, the health check uses the port number\nspecified on each endpoint in the network endpoint group. For instance\ngroup backends, the health check uses the port number specified for the\nbackend service's named port defined in the instance group's named ports." ], - "description": "Modify the specified resource policy." + "type": "string" }, - "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" - }, - "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" + "proxyHeader": { + "description": "Specifies the type of proxy header to append before sending data to the\nbackend, either NONE or PROXY_V1. The default\nis NONE.", + "enum": [ + "NONE", + "PROXY_V1" ], - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "", + "" ], - "description": "Gets the access control policy for a resource. May be empty if no such policy or resource exists." + "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" - } + "request": { + "description": "Instructs the health check prober to send this exact ASCII string, up to\n1024 bytes in length, after establishing the TCP connection and SSL\nhandshake.", + "type": "string" + }, + "response": { + "description": "Creates a content-based SSL health check. In addition to establishing a\nTCP connection and the TLS handshake, you can configure the health check to\npass only when the backend sends this exact response ASCII string, up to\n1024 bytes in length. For details, see:\nhttps://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-ssl-tcp", + "type": "string" + } + }, + "type": "object" + }, + "SavedAttachedDisk": { + "description": "DEPRECATED: Please use compute#savedDisk instead.\nAn instance-attached disk resource.", + "id": "SavedAttachedDisk", + "properties": { + "autoDelete": { + "description": "Specifies whether the disk will be auto-deleted when the instance is\ndeleted (but not when the disk is detached from the instance).", + "type": "boolean" + }, + "boot": { + "description": "Indicates that this is a boot disk. The virtual machine will use the first\npartition of the disk for its root filesystem.", + "type": "boolean" + }, + "deviceName": { + "description": "Specifies the name of the disk attached to the source instance.", + "type": "string" + }, + "diskEncryptionKey": { + "$ref": "CustomerEncryptionKey", + "description": "The encryption key for the disk." + }, + "diskSizeGb": { + "description": "The size of the disk in base-2 GB.", + "format": "int64", + "type": "string" + }, + "diskType": { + "description": "Output only. [Output Only] URL of the disk type resource. For example:projects/project/zones/zone/diskTypes/pd-standard or\npd-ssd", + "readOnly": true, + "type": "string" + }, + "guestOsFeatures": { + "description": "A list of features to enable on the guest operating system. Applicable only\nfor bootable images. Read\nEnabling guest operating system features to see a list of available\noptions.", + "items": { + "$ref": "GuestOsFeature" }, - "parameterOrder": [ - "project", - "region", - "resource" + "type": "array" + }, + "index": { + "description": "Output only. Specifies zero-based index of the disk that is attached to the source\ninstance.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "interface": { + "description": "Specifies the disk interface to use for attaching this disk, which is\neither SCSI or NVME.", + "enum": [ + "NVME", + "SCSI" ], - "request": { - "$ref": "RegionSetPolicyRequest" - }, - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "", + "" ], - "description": "Sets the access control policy on the specified resource. Replaces any existing policy." + "type": "string" }, - "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" - } + "kind": { + "default": "compute#savedAttachedDisk", + "description": "Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.", + "readOnly": true, + "type": "string" + }, + "licenses": { + "description": "Output only. [Output Only] Any valid publicly visible licenses.", + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "region", - "resource" + "readOnly": true, + "type": "array" + }, + "mode": { + "description": "The mode in which this disk is attached to the source instance, eitherREAD_WRITE or READ_ONLY.", + "enum": [ + "READ_ONLY", + "READ_WRITE" ], - "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" + "enumDescriptions": [ + "Attaches this disk in read-only mode. Multiple virtual machines can use\na disk in read-only mode at a time.", + "*[Default]* Attaches this disk in read-write mode. Only one\nvirtual machine at a time can be attached to a disk in read-write mode." ], - "description": "Returns permissions that a caller has on the specified resource." - } - } - }, - "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" + "type": "string" + }, + "source": { + "description": "Specifies a URL of the disk attached to the source instance.", + "type": "string" + }, + "storageBytes": { + "description": "Output only. [Output Only] A size of the storage used by the disk's snapshot by this\nmachine image.", + "format": "int64", + "readOnly": true, + "type": "string" + }, + "storageBytesStatus": { + "description": "Output only. [Output Only] An indicator whether storageBytes is in a\nstable state or it is being adjusted as a result of shared storage\nreallocation. This status can either be UPDATING, meaning\nthe size of the snapshot is being updated, or UP_TO_DATE,\nmeaning the size of the snapshot is up-to-date.", + "enum": [ + "UPDATING", + "UP_TO_DATE" ], - "response": { - "$ref": "RouteList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "", + "" ], - "description": "Retrieves the list of Route resources available to the specified project." + "readOnly": true, + "type": "string" }, - "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" + "type": { + "description": "Specifies the type of the attached disk, either SCRATCH orPERSISTENT.", + "enum": [ + "PERSISTENT", + "SCRATCH" + ], + "enumDescriptions": [ + "", + "" + ], + "type": "string" + } + }, + "type": "object" + }, + "SavedDisk": { + "description": "An instance-attached disk resource.", + "id": "SavedDisk", + "properties": { + "architecture": { + "description": "Output only. [Output Only] The architecture of the attached disk.", + "enum": [ + "ARCHITECTURE_UNSPECIFIED", + "ARM64", + "X86_64" ], - "response": { - "$ref": "Route" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "Default value indicating Architecture is not set.", + "Machines with architecture ARM64", + "Machines with architecture X86_64" ], - "description": "Returns the specified Route resource." + "readOnly": true, + "type": "string" }, - "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" + "kind": { + "default": "compute#savedDisk", + "description": "Output only. [Output Only] Type of the resource. Always compute#savedDisk\nfor attached disks.", + "readOnly": true, + "type": "string" + }, + "sourceDisk": { + "description": "Output only. Specifies a URL of the disk attached to the source instance.", + "readOnly": true, + "type": "string" + }, + "storageBytes": { + "description": "Output only. [Output Only] Size of the individual disk snapshot used by this machine\nimage.", + "format": "int64", + "readOnly": true, + "type": "string" + }, + "storageBytesStatus": { + "description": "Output only. [Output Only] An indicator whether storageBytes is in a\nstable state or it is being adjusted as a result of shared storage\nreallocation. This status can either be UPDATING, meaning\nthe size of the snapshot is being updated, or UP_TO_DATE,\nmeaning the size of the snapshot is up-to-date.", + "enum": [ + "UPDATING", + "UP_TO_DATE" ], - "request": { - "$ref": "Route" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "", + "" ], - "description": "Creates a Route resource in the specified project using the data included in the request." + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "ScalingScheduleStatus": { + "id": "ScalingScheduleStatus", + "properties": { + "lastStartTime": { + "description": "[Output Only] The last time the scaling schedule became active.\nNote: this is a timestamp when a schedule actually became active, not when\nit was planned to do so.\nThe timestamp is in RFC3339\ntext format.", + "type": "string" }, - "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" + "nextStartTime": { + "description": "[Output Only] The next time the scaling schedule is to become active.\nNote: this is a timestamp when a schedule is planned to run, but the actual\ntime might be slightly different.\nThe timestamp is in RFC3339\ntext format.", + "type": "string" + }, + "state": { + "description": "[Output Only] The current state of a scaling schedule.", + "enum": [ + "ACTIVE", + "DISABLED", + "OBSOLETE", + "READY" ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "The current autoscaling recommendation is influenced by this scaling\nschedule.", + "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\nschedule." ], - "description": "Deletes the specified Route resource." + "type": "string" } - } + }, + "type": "object" }, - "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" + "Scheduling": { + "description": "Sets the scheduling options for an Instance.", + "id": "Scheduling", + "properties": { + "automaticRestart": { + "description": "Specifies whether the instance should be automatically restarted if it is\nterminated by Compute Engine (not terminated by a user). You can only set\nthe automatic restart option for standard instances.Preemptible instances\ncannot be automatically restarted.\n\nBy default, this is set to true so an instance is\nautomatically restarted if it is terminated by Compute Engine.", + "type": "boolean" + }, + "availabilityDomain": { + "description": "Specifies the availability domain to place the instance in. The value\nmust be a number between 1 and the number of availability domains\nspecified in the spread placement policy attached to the instance.", + "format": "int32", + "type": "integer" + }, + "gracefulShutdown": { + "$ref": "SchedulingGracefulShutdown" + }, + "hostErrorTimeoutSeconds": { + "description": "Specify the time in seconds for host error detection, the value must be\nwithin the range of [90, 330] with the increment of 30, if unset, the\ndefault behavior of host error recovery will be used.", + "format": "int32", + "type": "integer" + }, + "instanceTerminationAction": { + "description": "Specifies the termination action for the instance.", + "enum": [ + "DELETE", + "INSTANCE_TERMINATION_ACTION_UNSPECIFIED", + "STOP" ], - "response": { - "$ref": "Router" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "Delete the VM.", + "Default value. This value is unused.", + "Stop the VM without storing in-memory content. default action." ], - "description": "Returns the specified Router resource." + "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" - } + "localSsdRecoveryTimeout": { + "$ref": "Duration", + "description": "Specifies the maximum amount of time a Local Ssd Vm should wait while\nrecovery of the Local Ssd state is attempted. Its value should be in\nbetween 0 and 168 hours with hour granularity and the default value being 1\nhour." + }, + "locationHint": { + "description": "An opaque location hint used to place the instance close to other\nresources.\nThis field is for use by internal tools that use the public API.", + "type": "string" + }, + "maxRunDuration": { + "$ref": "Duration", + "description": "Specifies the max run duration for the given instance. If specified,\nthe instance termination action will be performed at the end of the run\nduration." + }, + "minNodeCpus": { + "description": "The minimum number of virtual CPUs this instance will consume when running\non a sole-tenant node.", + "format": "int32", + "type": "integer" + }, + "nodeAffinities": { + "description": "A set of node affinity and anti-affinity configurations. Refer toConfiguring node\naffinity for more information.\nOverrides reservationAffinity.", + "items": { + "$ref": "SchedulingNodeAffinity" }, - "parameterOrder": [ - "project", - "region" + "type": "array" + }, + "onHostMaintenance": { + "description": "Defines the maintenance behavior for this instance. For standard instances,\nthe default behavior is MIGRATE. Forpreemptible instances,\nthe default and only possible behavior is TERMINATE. For more\ninformation, see\n Set\n VM host maintenance policy.", + "enum": [ + "MIGRATE", + "TERMINATE" ], - "request": { - "$ref": "Router" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "*[Default]* Allows Compute Engine to automatically migrate instances\nout of the way of maintenance events.", + "Tells Compute Engine to terminate and (optionally) restart the instance\naway from the maintenance activity. If you would like your instance to be\nrestarted, set the automaticRestart flag to true. Your\ninstance may be restarted more than once, and it may be restarted outside\nthe window of maintenance events." ], - "description": "Creates a Router resource in the specified project and region using the data included in the request." + "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" + "onInstanceStopAction": { + "$ref": "SchedulingOnInstanceStopAction" + }, + "preemptible": { + "description": "Defines whether the instance is preemptible. This can only be set during\ninstance creation or while the instance isstopped and\ntherefore, in a `TERMINATED` state. SeeInstance Life\nCycle for more information on the possible instance states.", + "type": "boolean" + }, + "preemptionNoticeDuration": { + "$ref": "Duration", + "description": "Specifies the Metadata Service preemption notice duration before the GCE ACPI G2\nSoft Off signal is triggered for Spot VMs only. If not specified,\nthere will be no wait before the G2 Soft Off signal is triggered." + }, + "provisioningModel": { + "description": "Specifies the provisioning model of the instance.", + "enum": [ + "FLEX_START", + "RESERVATION_BOUND", + "SPOT", + "STANDARD" ], - "request": { - "$ref": "Router" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "Instance is provisioned using the Flex Start provisioning model and\nhas a limited runtime.", + "Bound to the lifecycle of the reservation in which it is provisioned.", + "Heavily discounted, no guaranteed runtime.", + "Standard provisioning with user controlled runtime, no discounts." ], - "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." + "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" + "skipGuestOsShutdown": { + "description": "Default is false and there will be 120 seconds between GCE ACPI G2 Soft\nOff and ACPI G3 Mechanical\nOff for Standard VMs and 30 seconds for Spot VMs.", + "type": "boolean" + }, + "terminationTime": { + "description": "Specifies the timestamp, when the instance will be terminated, inRFC3339 text format. If specified, the instance\ntermination action will be performed at the termination time.", + "type": "string" + } + }, + "type": "object" + }, + "SchedulingGracefulShutdown": { + "description": "The configuration for gracefully shutting down the instance.", + "id": "SchedulingGracefulShutdown", + "properties": { + "enabled": { + "description": "Opts-in for graceful shutdown.", + "type": "boolean" + }, + "maxDuration": { + "$ref": "Duration", + "description": "The time allotted for the instance to gracefully shut down. If the\ngraceful shutdown isn't complete after this time, then the instance\ntransitions to the STOPPING state." + } + }, + "type": "object" + }, + "SchedulingNodeAffinity": { + "description": "Node Affinity: the configuration of desired nodes onto which this Instance\n could be scheduled.", + "id": "SchedulingNodeAffinity", + "properties": { + "key": { + "description": "Corresponds to the label key of Node resource.", + "type": "string" + }, + "operator": { + "description": "Defines the operation of node selection. Valid operators areIN for affinity and NOT_IN for anti-affinity.", + "enum": [ + "IN", + "NOT_IN", + "OPERATOR_UNSPECIFIED" ], - "request": { - "$ref": "Router" + "enumDescriptions": [ + "Requires Compute Engine to seek for matched nodes.", + "Requires Compute Engine to avoid certain nodes.", + "" + ], + "type": "string" + }, + "values": { + "description": "Corresponds to the label values of Node resource.", + "items": { + "type": "string" }, - "response": { - "$ref": "Operation" + "type": "array" + } + }, + "type": "object" + }, + "SchedulingOnInstanceStopAction": { + "description": "Defines the behaviour for instances with the instance_termination_actionSTOP.", + "id": "SchedulingOnInstanceStopAction", + "properties": { + "discardLocalSsd": { + "description": "If true, the contents of any attached Local SSD disks will be discarded\nelse, the Local SSD data will be preserved when the instance is stopped\nat the end of the run duration/termination time.", + "type": "boolean" + } + }, + "type": "object" + }, + "Screenshot": { + "description": "An instance's screenshot.", + "id": "Screenshot", + "properties": { + "contents": { + "description": "[Output Only] The Base64-encoded screenshot data.", + "type": "string" + }, + "kind": { + "default": "compute#screenshot", + "description": "Output only. [Output Only] Type of the resource. Always compute#screenshot\nfor the screenshots.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "SecurityPoliciesAggregatedList": { + "id": "SecurityPoliciesAggregatedList", + "properties": { + "etag": { + "type": "string" + }, + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "additionalProperties": { + "$ref": "SecurityPoliciesScopedList", + "description": "Name of the scope containing this set of security policies." }, - "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": "A list of SecurityPoliciesScopedList resources.", + "type": "object" }, - "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, + "kind": { + "default": "compute#securityPoliciesAggregatedList", + "description": "Output only. [Output Only] Type of resource. Alwayscompute#securityPolicyAggregatedList for lists of Security\nPolicies.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "unreachables": { + "description": "Output only. [Output Only] Unreachable resources.", + "items": { + "type": "string" + }, + "readOnly": true, + "type": "array" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project", - "region", - "router" - ], - "response": { - "$ref": "Operation" + "type": "object" + } + }, + "type": "object" + }, + "SecurityPoliciesListPreconfiguredExpressionSetsResponse": { + "id": "SecurityPoliciesListPreconfiguredExpressionSetsResponse", + "properties": { + "preconfiguredExpressionSets": { + "$ref": "SecurityPoliciesWafConfig" + } + }, + "type": "object" + }, + "SecurityPoliciesScopedList": { + "id": "SecurityPoliciesScopedList", + "properties": { + "securityPolicies": { + "description": "A list of SecurityPolicies contained in this scope.", + "items": { + "$ref": "SecurityPolicy" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified Router resource." + "type": "array" }, - "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", + "warning": { + "description": "Informational warning which replaces the list of\nsecurity policies when the list is empty.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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" } }, - "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." + "type": "object" + } + }, + "type": "object" + }, + "SecurityPoliciesWafConfig": { + "id": "SecurityPoliciesWafConfig", + "properties": { + "wafRules": { + "$ref": "PreconfiguredWafSet" + } + }, + "type": "object" + }, + "SecurityPolicy": { + "description": "Represents a Google Cloud Armor security policy resource.\n\nOnly external backend services that use load balancers can\nreference a security policy. For more information, see\nGoogle Cloud Armor security policy overview.", + "id": "SecurityPolicy", + "properties": { + "adaptiveProtectionConfig": { + "$ref": "SecurityPolicyAdaptiveProtectionConfig" }, - "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" - } + "advancedOptionsConfig": { + "$ref": "SecurityPolicyAdvancedOptionsConfig" + }, + "associations": { + "description": "A list of associations that belong to this policy.", + "items": { + "$ref": "SecurityPolicyAssociation" }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "RouterAggregatedList" + "type": "array" + }, + "creationTimestamp": { + "description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", + "readOnly": true, + "type": "string" + }, + "ddosProtectionConfig": { + "$ref": "SecurityPolicyDdosProtectionConfig" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you\ncreate the resource.", + "type": "string" + }, + "fingerprint": { + "description": "Specifies a fingerprint for this resource, which is essentially a hash of\nthe metadata's contents and used for optimistic locking. The\nfingerprint is initially generated by Compute Engine and changes after\nevery request to modify or update metadata. You must always provide an\nup-to-date fingerprint hash in order to update or change metadata,\notherwise the request will fail with error412 conditionNotMet.\n\nTo see the latest fingerprint, make get() request to the\nsecurity policy.", + "format": "byte", + "type": "string" + }, + "id": { + "description": "Output only. [Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "format": "uint64", + "readOnly": true, + "type": "string" + }, + "kind": { + "default": "compute#securityPolicy", + "description": "Output only. [Output only] Type of the resource. Alwayscompute#securityPolicyfor security policies", + "readOnly": true, + "type": "string" + }, + "labelFingerprint": { + "description": "A fingerprint for the labels being applied to this security policy, which\nis essentially a hash of the labels set used for optimistic locking. The\nfingerprint is initially generated by Compute Engine and changes after\nevery request to modify or update labels. You must always provide an\nup-to-date fingerprint hash in order to update or change labels.\n\nTo see the latest fingerprint, make get() request to the\nsecurity policy.", + "format": "byte", + "type": "string" + }, + "labels": { + "additionalProperties": { + "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 an aggregated list of routers. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." + "description": "Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035.\nLabel values may be empty.", + "type": "object" }, - "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" - } + "name": { + "description": "Name of the resource. Provided by the client when the resource is created.\nThe name must be 1-63 characters long, and comply withRFC1035.\nSpecifically, the name must be 1-63 characters long and match the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first\ncharacter must be a lowercase letter, and all following characters must\nbe a dash, lowercase letter, or digit, except the last character, which\ncannot be a dash.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "parent": { + "description": "Output only. [Output Only] The parent of the security policy.", + "readOnly": true, + "type": "string" + }, + "recaptchaOptionsConfig": { + "$ref": "SecurityPolicyRecaptchaOptionsConfig" + }, + "region": { + "description": "Output only. [Output Only] URL of the region where the regional security policy\nresides. This field is not applicable to global security policies.", + "readOnly": true, + "type": "string" + }, + "rules": { + "description": "A list of rules that belong to this policy.\nThere must always be a default rule which is a rule with priority\n2147483647 and match all condition (for the match condition this means\nmatch \"*\" for srcIpRanges and for the networkMatch condition every field\nmust be either match \"*\" or not set). If no rules are provided when\ncreating a security policy, a default rule with action \"allow\" will be\nadded.", + "items": { + "$ref": "SecurityPolicyRule" }, - "parameterOrder": [ - "project", - "region", - "router" + "type": "array" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for the resource.", + "readOnly": true, + "type": "string" + }, + "shortName": { + "description": "User-provided name of the organization security policy. The name should be\nunique in the organization in which the security policy is created. This\nshould only be used when SecurityPolicyType is CLOUD_ARMOR.\nThe name must be 1-63 characters long, and comply with\nhttps://www.ietf.org/rfc/rfc1035.txt. Specifically, the name must be 1-63\ncharacters long and match the regular expression\n`[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a\nlowercase letter, and all following characters must be a dash, lowercase\nletter, or digit, except the last character, which cannot be a dash.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "type": { + "description": "The type indicates the intended use of the security policy.\n \n - CLOUD_ARMOR: Cloud Armor backend security policies can\n be configured to filter incoming HTTP requests targeting backend services.\n They filter requests before they hit the origin servers.\n - CLOUD_ARMOR_EDGE: Cloud Armor edge security policies can\n be configured to filter incoming HTTP requests targeting backend services\n (including Cloud CDN-enabled) as well as backend buckets (Cloud Storage).\n They filter requests before the request is served from Google's cache.\n - CLOUD_ARMOR_INTERNAL_SERVICE (preview only): Cloud Armor\n internal service policies can be configured to filter HTTP requests\n targeting services managed by Traffic Director in a service mesh. They\n filter requests before the request is served from the application.\n\n- CLOUD_ARMOR_NETWORK: Cloud Armor network policies\ncan be configured to filter packets targeting network load balancing\nresources such as backend services, target pools, target instances, and\ninstances with external IPs. They filter requests before the request is\nserved from the application.\n\n\nThis field can be set only at resource creation time.", + "enum": [ + "CLOUD_ARMOR", + "CLOUD_ARMOR_EDGE", + "CLOUD_ARMOR_NETWORK" ], - "response": { - "$ref": "RouterStatusResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "", + "", + "" ], - "description": "Retrieves runtime information of the specified router." + "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" - } + "userDefinedFields": { + "description": "Definitions of user-defined fields for CLOUD_ARMOR_NETWORK policies. A\nuser-defined field consists of up to 4 bytes extracted from a fixed offset\nin the packet, relative to the IPv4, IPv6, TCP, or UDP header, with an\noptional mask to select certain bits. Rules may then specify matching\nvalues for these fields.\n\nExample:\n\n userDefinedFields:\n - name: \"ipv4_fragment_offset\"\n base: IPV4\n offset: 6\n size: 2\n mask: \"0x1fff\"", + "items": { + "$ref": "SecurityPolicyUserDefinedField" }, - "parameterOrder": [ - "project", - "region", - "router" + "type": "array" + } + }, + "type": "object" + }, + "SecurityPolicyAdaptiveProtectionConfig": { + "description": "Configuration options for Cloud Armor Adaptive Protection (CAAP).", + "id": "SecurityPolicyAdaptiveProtectionConfig", + "properties": { + "layer7DdosDefenseConfig": { + "$ref": "SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfig", + "description": "If set to true, enables Cloud Armor Machine Learning." + } + }, + "type": "object" + }, + "SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfig": { + "description": "Configuration options for L7 DDoS detection.\nThis field is only supported in Global Security Policies of type\nCLOUD_ARMOR.", + "id": "SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfig", + "properties": { + "enable": { + "description": "If set to true, enables CAAP for L7 DDoS detection.\nThis field is only supported in Global Security Policies of type\nCLOUD_ARMOR.", + "type": "boolean" + }, + "ruleVisibility": { + "description": "Rule visibility can be one of the following:\nSTANDARD - opaque rules. (default)\nPREMIUM - transparent rules.\nThis field is only supported in Global Security Policies of type\nCLOUD_ARMOR.", + "enum": [ + "PREMIUM", + "STANDARD" ], - "response": { - "$ref": "VmEndpointNatMappingsList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "", + "" ], - "description": "Retrieves runtime Nat mapping information of VM endpoints." + "type": "string" + }, + "thresholdConfigs": { + "description": "Configuration options for layer7 adaptive protection for various\ncustomizable thresholds.", + "items": { + "$ref": "SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfigThresholdConfig" + }, + "type": "array" + } + }, + "type": "object" + }, + "SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfigThresholdConfig": { + "id": "SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfigThresholdConfig", + "properties": { + "autoDeployConfidenceThreshold": { + "format": "float", + "type": "number" + }, + "autoDeployExpirationSec": { + "format": "int32", + "type": "integer" + }, + "autoDeployImpactedBaselineThreshold": { + "format": "float", + "type": "number" + }, + "autoDeployLoadThreshold": { + "format": "float", + "type": "number" + }, + "detectionAbsoluteQps": { + "format": "float", + "type": "number" + }, + "detectionLoadThreshold": { + "format": "float", + "type": "number" }, - "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" - } + "detectionRelativeToBaselineQps": { + "format": "float", + "type": "number" + }, + "name": { + "description": "The name must be 1-63 characters long, and comply withRFC1035.\nThe name must be unique within the security policy.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "trafficGranularityConfigs": { + "description": "Configuration options for enabling Adaptive Protection to operate\non specified granular traffic units.", + "items": { + "$ref": "SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfigThresholdConfigTrafficGranularityConfig" }, - "parameterOrder": [ - "project", - "region", - "router" + "type": "array" + } + }, + "type": "object" + }, + "SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfigThresholdConfigTrafficGranularityConfig": { + "description": "Configurations to specifc granular traffic units processed by\nAdaptive Protection.", + "id": "SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfigThresholdConfigTrafficGranularityConfig", + "properties": { + "enableEachUniqueValue": { + "description": "If enabled, traffic matching each unique value for the specified\ntype constitutes a separate traffic unit.\nIt can only be set to true if `value` is empty.", + "type": "boolean" + }, + "type": { + "description": "Type of this configuration.", + "enum": [ + "HTTP_HEADER_HOST", + "HTTP_PATH", + "UNSPECIFIED_TYPE" ], - "response": { - "$ref": "NatIpInfoResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "", + "", + "" ], - "description": "Retrieves runtime NAT IP information." + "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" + "value": { + "description": "Requests that match this value constitute a granular traffic unit.", + "type": "string" + } + }, + "type": "object" + }, + "SecurityPolicyAdvancedOptionsConfig": { + "id": "SecurityPolicyAdvancedOptionsConfig", + "properties": { + "jsonCustomConfig": { + "$ref": "SecurityPolicyAdvancedOptionsConfigJsonCustomConfig", + "description": "Custom configuration to apply the JSON parsing. Only applicable when\njson_parsing is set to STANDARD." + }, + "jsonParsing": { + "enum": [ + "DISABLED", + "STANDARD", + "STANDARD_WITH_GRAPHQL" ], - "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" + "enumDescriptions": [ + "", + "", + "" ], - "description": "Preview fields auto-generated during router create and update operations. Calling this method does NOT create or update the router." + "type": "string" }, - "updateRoutePolicy": { - "id": "compute.routers.updateRoutePolicy", - "path": "projects/{project}/regions/{region}/routers/{router}/updateRoutePolicy", - "flatPath": "projects/{project}/regions/{region}/routers/{router}/updateRoutePolicy", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,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 where Route Policy is defined.", - "pattern": "[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" + "logLevel": { + "enum": [ + "NORMAL", + "VERBOSE" ], - "request": { - "$ref": "RoutePolicy" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "", + "" ], - "description": "Updates or creates new Route Policy" + "type": "string" }, - "patchRoutePolicy": { - "id": "compute.routers.patchRoutePolicy", - "path": "projects/{project}/regions/{region}/routers/{router}/patchRoutePolicy", - "flatPath": "projects/{project}/regions/{region}/routers/{router}/patchRoutePolicy", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,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 where Route Policy is defined.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } + "requestBodyInspectionSize": { + "description": "The maximum request size chosen by the customer with Waf enabled.\nValues supported are \"8KB\", \"16KB, \"32KB\", \"48KB\" and \"64KB\".\nValues are case insensitive.", + "type": "string" + }, + "userIpRequestHeaders": { + "description": "An optional list of case-insensitive request header names to use for\nresolving the callers client IP address.", + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "region", - "router" - ], - "request": { - "$ref": "RoutePolicy" + "type": "array" + } + }, + "type": "object" + }, + "SecurityPolicyAdvancedOptionsConfigJsonCustomConfig": { + "id": "SecurityPolicyAdvancedOptionsConfigJsonCustomConfig", + "properties": { + "contentTypes": { + "description": "A list of custom Content-Type header values to apply the JSON parsing.\n\nAs per RFC 1341, a Content-Type header value has the following format:\n\nContent-Type := type \"/\" subtype *[\";\" parameter]\n\nWhen configuring a custom Content-Type header value, only the\ntype/subtype needs to be specified, and the parameters should be\nexcluded.", + "items": { + "type": "string" }, - "response": { - "$ref": "Operation" + "type": "array" + } + }, + "type": "object" + }, + "SecurityPolicyAssociation": { + "id": "SecurityPolicyAssociation", + "properties": { + "attachmentId": { + "description": "The resource that the security policy is attached to.", + "type": "string" + }, + "displayName": { + "deprecated": true, + "description": "Output only. [Output Only] The display name of the security policy of the association.", + "readOnly": true, + "type": "string" + }, + "excludedFolders": { + "description": "A list of folders to exclude from the security policy.", + "items": { + "type": "string" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Patches Route Policy" + "type": "array" }, - "deleteRoutePolicy": { - "id": "compute.routers.deleteRoutePolicy", - "path": "projects/{project}/regions/{region}/routers/{router}/deleteRoutePolicy", - "flatPath": "projects/{project}/regions/{region}/routers/{router}/deleteRoutePolicy", - "httpMethod": "POST", - "parameters": { - "policy": { - "description": "The Policy name for this request. Name must 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" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request 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 where Route Policy is defined.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } + "excludedProjects": { + "description": "A list of projects to exclude from the security policy.", + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "region", - "router" + "type": "array" + }, + "name": { + "description": "The name for an association.", + "type": "string" + }, + "securityPolicyId": { + "description": "Output only. [Output Only] The security policy ID of the association.", + "readOnly": true, + "type": "string" + }, + "shortName": { + "description": "Output only. [Output Only] The short name of the security policy of the association.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "SecurityPolicyDdosProtectionConfig": { + "id": "SecurityPolicyDdosProtectionConfig", + "properties": { + "ddosAdaptiveProtection": { + "enum": [ + "DDOS_ADAPTIVE_PROTECTION_UNSPECIFIED", + "DISABLED", + "ENABLED", + "PREVIEW", + "UNSPECIFIED_ADAPTIVE_PROTECTION" ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDeprecated": [ + false, + false, + false, + false, + true + ], + "enumDescriptions": [ + "", + "", + "", + "", + "" ], - "description": "Deletes Route Policy" + "type": "string" }, - "getRoutePolicy": { - "id": "compute.routers.getRoutePolicy", - "path": "projects/{project}/regions/{region}/routers/{router}/getRoutePolicy", - "flatPath": "projects/{project}/regions/{region}/routers/{router}/getRoutePolicy", - "httpMethod": "GET", - "parameters": { - "policy": { - "description": "The Policy name for this request. Name must 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 the route policy. The name should conform to RFC1035.", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "router" + "ddosImpactedBaselineThreshold": { + "description": "DDoS Protection for Network Load Balancers (and VMs with public IPs)\nbuilds DDoS mitigations that minimize collateral damage. It quantifies\nthis as the fraction of a non-abuse baseline that's inadvertently\nblocked.\n\nRules whose collateral damage exceeds ddosImpactedBaselineThreshold will\nnot be deployed. Using a lower value will prioritize keeping collateral\ndamage low, possibly at the cost of its effectiveness in rate limiting\nsome or all of the attack. It should typically be unset, so Advanced DDoS\n(and Adaptive Protection) uses the best mitigation it can find. Setting\nthe threshold is advised if there are logs for false positive detections\nwith high collateral damage, and will cause Advanced DDoS to attempt to\nfind a less aggressive rule that satisfies the constraint. If a suitable\nrule cannot be found, the system falls back to either no mitigation for\nsmaller attacks or broader network throttles for larger ones.", + "format": "float", + "type": "number" + }, + "ddosProtection": { + "enum": [ + "ADVANCED", + "ADVANCED_PREVIEW", + "STANDARD" ], - "response": { - "$ref": "RoutersGetRoutePolicyResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "", + "", + "" ], - "description": "Returns specified Route Policy" + "type": "string" + } + }, + "type": "object" + }, + "SecurityPolicyList": { + "id": "SecurityPolicyList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" }, - "listRoutePolicies": { - "id": "compute.routers.listRoutePolicies", - "path": "projects/{project}/regions/{region}/routers/{router}/listRoutePolicies", - "flatPath": "projects/{project}/regions/{region}/routers/{router}/listRoutePolicies", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not 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" - }, - "router": { - "description": "Name or id of the resource for this request. Name should conform to RFC1035.", - "pattern": "[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": "RoutersListRoutePolicies" + "items": { + "description": "A list of SecurityPolicy resources.", + "items": { + "$ref": "SecurityPolicy" }, - "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 route policy subresources available to the specified project." + "type": "array" }, - "listBgpRoutes": { - "id": "compute.routers.listBgpRoutes", - "path": "projects/{project}/regions/{region}/routers/{router}/listBgpRoutes", - "flatPath": "projects/{project}/regions/{region}/routers/{router}/listBgpRoutes", - "httpMethod": "GET", - "parameters": { - "addressFamily": { - "description": "(Required) limit results to this address family (either IPv4 or IPv6)", - "default": "UNSPECIFIED_IP_VERSION", - "location": "query", - "type": "string", + "kind": { + "default": "compute#securityPolicyList", + "description": "Output only. [Output Only] Type of resource. Alwayscompute#securityPolicyList for listsof securityPolicies", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], "enumDescriptions": [ - "", - "", - "" + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." ], - "enum": [ - "IPV4", - "IPV6", - "UNSPECIFIED_IP_VERSION" - ] - }, - "destinationPrefix": { - "description": "Limit results to destinations that are subnets of this CIDR range", - "location": "query", - "type": "string" - }, - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not 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" - }, - "peer": { - "description": "(Required) limit results to the BGP peer with the given name. Name should conform to RFC1035.", - "location": "query", - "type": "string" - }, - "policyApplied": { - "description": "When true, the method returns post-policy routes. Otherwise, it returns pre-policy routes.", - "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" - }, - "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" - }, - "routeType": { - "description": "(Required) limit results to this type of route (either LEARNED or ADVERTISED)", - "default": "UNSPECIFIED_ROUTE_TYPE", - "location": "query", - "type": "string", - "enumDescriptions": [ - "", - "", - "" - ], - "enum": [ - "ADVERTISED", - "LEARNED", - "UNSPECIFIED_ROUTE_TYPE" - ] + "data": { + "description": "[Output Only] Metadata about this warning in key:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "router": { - "description": "Name or id of the resource for this request. Name should conform to RFC1035.", - "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" } }, - "parameterOrder": [ - "project", - "region", - "router" - ], - "response": { - "$ref": "RoutersListBgpRoutes" + "type": "object" + } + }, + "type": "object" + }, + "SecurityPolicyRecaptchaOptionsConfig": { + "id": "SecurityPolicyRecaptchaOptionsConfig", + "properties": { + "redirectSiteKey": { + "description": "An optional field to supply a reCAPTCHA site key to be used for all the\nrules using the redirect action with the type of GOOGLE_RECAPTCHA under\nthe security policy. The specified site key needs to be created from the\nreCAPTCHA API. The user is responsible for the validity of the specified\nsite key. If not specified, a Google-managed site key is used.\nThis field is only supported in Global Security Policies of type\nCLOUD_ARMOR.", + "type": "string" + } + }, + "type": "object" + }, + "SecurityPolicyReference": { + "id": "SecurityPolicyReference", + "properties": { + "securityPolicy": { + "type": "string" + } + }, + "type": "object" + }, + "SecurityPolicyRule": { + "description": "Represents a rule that describes one or more match conditions along with\nthe action to be taken when traffic matches this condition (allow or deny).", + "id": "SecurityPolicyRule", + "properties": { + "action": { + "description": "The Action to perform when the rule is matched.\nThe following are the valid actions:\n \n - allow: allow access to target.\n - deny(STATUS): deny access to target, returns the\n HTTP response code specified. Valid values for `STATUS`\n are 403, 404, and 502.\n - rate_based_ban: limit client traffic to the configured\n threshold and ban the client if the traffic exceeds the threshold.\n Configure parameters for this action in RateLimitOptions. Requires\n rate_limit_options to be set.\n - redirect: redirect to a different target. This can\n either be an internal reCAPTCHA redirect, or an external URL-based\n redirect via a 302 response. Parameters for this action can be configured\n via redirectOptions. This action is only supported in Global Security\n Policies of type CLOUD_ARMOR.\n - throttle: limit\n client traffic to the configured threshold. Configure parameters for this\n action in rateLimitOptions. Requires rate_limit_options to be set for\n this.\n - fairshare (preview only): when traffic reaches the\n threshold limit, requests from the clients matching this rule begin to be\n rate-limited using the Fair Share algorithm. This action is only allowed\n in security policies of type `CLOUD_ARMOR_INTERNAL_SERVICE`.", + "type": "string" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you\ncreate the resource.", + "type": "string" + }, + "headerAction": { + "$ref": "SecurityPolicyRuleHttpHeaderAction", + "description": "Optional, additional actions that are performed on headers.\nThis field is only supported in Global Security Policies of type\nCLOUD_ARMOR." + }, + "kind": { + "default": "compute#securityPolicyRule", + "description": "Output only. [Output only] Type of the resource. Alwayscompute#securityPolicyRule for security policy rules", + "readOnly": true, + "type": "string" + }, + "match": { + "$ref": "SecurityPolicyRuleMatcher", + "description": "A match condition that incoming traffic is evaluated against.\nIf it evaluates to true, the corresponding 'action' is enforced." + }, + "networkMatch": { + "$ref": "SecurityPolicyRuleNetworkMatcher", + "description": "A match condition that incoming packets are evaluated against for\nCLOUD_ARMOR_NETWORK security policies. If it matches, the corresponding\n'action' is enforced.\n\nThe match criteria for a rule consists of built-in match fields (like\n'srcIpRanges') and potentially multiple user-defined match fields\n('userDefinedFields').\n\nField values may be extracted directly from the packet or derived from it\n(e.g. 'srcRegionCodes'). Some fields may not be present in every packet\n(e.g. 'srcPorts'). A user-defined field is only present if the base\nheader is found in the packet and the entire field is in bounds.\n\nEach match field may specify which values can match it, listing one or\nmore ranges, prefixes, or exact values that are considered a match for\nthe field. A field value must be present in order to match a specified\nmatch field. If no match values are specified for a match field, then any\nfield value is considered to match it, and it's not required to be\npresent. For strings specifying '*' is also equivalent to match all.\n\nFor a packet to match a rule, all specified match fields must match the\ncorresponding field values derived from the packet.\n\nExample:\n\nnetworkMatch:\n srcIpRanges:\n - \"192.0.2.0/24\"\n - \"198.51.100.0/24\"\n userDefinedFields:\n - name: \"ipv4_fragment_offset\"\n values:\n - \"1-0x1fff\"\n\nThe above match condition matches packets with a source IP in\n192.0.2.0/24 or 198.51.100.0/24 and a user-defined field named\n\"ipv4_fragment_offset\" with a value between 1 and 0x1fff inclusive." + }, + "preconfiguredWafConfig": { + "$ref": "SecurityPolicyRulePreconfiguredWafConfig", + "description": "Preconfigured WAF configuration to be applied for the rule. If the rule\ndoes not evaluate preconfigured WAF rules, i.e., if\nevaluatePreconfiguredWaf() is not used, this field will have no effect." + }, + "preview": { + "description": "If set to true, the specified action is not enforced.", + "type": "boolean" + }, + "priority": { + "description": "An integer indicating the priority of a rule in the list. The priority\nmust be a positive value between 0 and 2147483647.\nRules are evaluated from highest to lowest priority where 0 is the\nhighest priority and 2147483647 is the lowest priority.", + "format": "int32", + "type": "integer" + }, + "rateLimitOptions": { + "$ref": "SecurityPolicyRuleRateLimitOptions", + "description": "Must be specified if the action is \"rate_based_ban\" or \"throttle\" or\n\"fairshare\". Cannot be specified for any other actions." + }, + "redirectOptions": { + "$ref": "SecurityPolicyRuleRedirectOptions", + "description": "Parameters defining the redirect action. Cannot be specified for any\nother actions.\nThis field is only supported in Global Security Policies of type\nCLOUD_ARMOR." + } + }, + "type": "object" + }, + "SecurityPolicyRuleHttpHeaderAction": { + "id": "SecurityPolicyRuleHttpHeaderAction", + "properties": { + "requestHeadersToAdds": { + "description": "The list of request headers to add or overwrite if they're already\npresent.", + "items": { + "$ref": "SecurityPolicyRuleHttpHeaderActionHttpHeaderOption" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "type": "array" + } + }, + "type": "object" + }, + "SecurityPolicyRuleHttpHeaderActionHttpHeaderOption": { + "id": "SecurityPolicyRuleHttpHeaderActionHttpHeaderOption", + "properties": { + "headerName": { + "description": "The name of the header to set.", + "type": "string" + }, + "headerValue": { + "description": "The value to set the named header to.", + "type": "string" + } + }, + "type": "object" + }, + "SecurityPolicyRuleMatcher": { + "description": "Represents a match condition that incoming traffic is evaluated against.\nExactly one field must be specified.", + "id": "SecurityPolicyRuleMatcher", + "properties": { + "config": { + "$ref": "SecurityPolicyRuleMatcherConfig", + "description": "The configuration options available when specifying versioned_expr.\nThis field must be specified if versioned_expr is specified and cannot\nbe specified if versioned_expr is not specified." + }, + "expr": { + "$ref": "Expr", + "description": "User defined CEVAL expression.\nA CEVAL expression is used to specify match criteria such as origin.ip,\nsource.region_code and contents in the request header.\nExpressions containing `evaluateThreatIntelligence` require a Cloud\nArmor Enterprise subscription and are not supported in Edge Policies\nnor in Regional Policies. Expressions containing\n`evaluatePreconfiguredExpr('sourceiplist-*')` require a Cloud Armor\nEnterprise subscription and are only supported in Global Security\nPolicies." + }, + "exprOptions": { + "$ref": "SecurityPolicyRuleMatcherExprOptions", + "description": "The configuration options available when specifying a user defined\nCEVAL expression (i.e., 'expr')." + }, + "versionedExpr": { + "description": "Preconfigured versioned expression.\nIf this field is specified, config must also be specified.\nAvailable preconfigured expressions along with their requirements are:\nSRC_IPS_V1 - must specify the corresponding src_ip_range field in\nconfig.", + "enum": [ + "SRC_IPS_V1" ], - "description": "Retrieves a list of router bgp routes available to the specified project." + "enumDescriptions": [ + "Matches the source IP address of a request to the IP ranges supplied\nin config." + ], + "type": "string" } - } + }, + "type": "object" }, - "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" - } + "SecurityPolicyRuleMatcherConfig": { + "id": "SecurityPolicyRuleMatcherConfig", + "properties": { + "srcIpRanges": { + "description": "CIDR IP address range.\nMaximum number of src_ip_ranges allowed is 10.", + "items": { + "type": "string" }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "ServiceAttachmentAggregatedList" + "type": "array" + } + }, + "type": "object" + }, + "SecurityPolicyRuleMatcherExprOptions": { + "id": "SecurityPolicyRuleMatcherExprOptions", + "properties": { + "recaptchaOptions": { + "$ref": "SecurityPolicyRuleMatcherExprOptionsRecaptchaOptions", + "description": "reCAPTCHA configuration options to be applied for the rule. If the\nrule does not evaluate reCAPTCHA tokens, this field has no effect." + } + }, + "type": "object" + }, + "SecurityPolicyRuleMatcherExprOptionsRecaptchaOptions": { + "id": "SecurityPolicyRuleMatcherExprOptionsRecaptchaOptions", + "properties": { + "actionTokenSiteKeys": { + "description": "A list of site keys to be used during the validation of reCAPTCHA\naction-tokens. The provided site keys need to be created from\nreCAPTCHA API under the same project where the security policy is\ncreated.", + "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 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`." + "type": "array" }, - "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" - } + "sessionTokenSiteKeys": { + "description": "A list of site keys to be used during the validation of reCAPTCHA\nsession-tokens. The provided site keys need to be created from\nreCAPTCHA API under the same project where the security policy is\ncreated.", + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "region" - ], - "response": { - "$ref": "ServiceAttachmentList" + "type": "array" + } + }, + "type": "object" + }, + "SecurityPolicyRuleNetworkMatcher": { + "description": "Represents a match condition that incoming network traffic is evaluated\nagainst.", + "id": "SecurityPolicyRuleNetworkMatcher", + "properties": { + "destIpRanges": { + "description": "Destination IPv4/IPv6 addresses or CIDR prefixes, in standard text\nformat.", + "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": "Lists the ServiceAttachments for a project in the given scope." + "type": "array" }, - "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" - } + "destPorts": { + "description": "Destination port numbers for TCP/UDP/SCTP. Each element can be a 16-bit\nunsigned decimal number (e.g. \"80\") or range (e.g. \"0-1023\").", + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "region", - "serviceAttachment" - ], - "response": { - "$ref": "ServiceAttachment" + "type": "array" + }, + "ipProtocols": { + "description": "IPv4 protocol / IPv6 next header (after extension headers). Each\nelement can be an 8-bit unsigned decimal number (e.g. \"6\"), range (e.g.\n\"253-254\"), or one of the following protocol names: \"tcp\", \"udp\",\n\"icmp\", \"esp\", \"ah\", \"ipip\", or \"sctp\".", + "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": "Returns the specified ServiceAttachment resource in the given scope." + "type": "array" }, - "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" - } + "srcAsns": { + "description": "BGP Autonomous System Number associated with the source IP address.", + "items": { + "format": "uint32", + "type": "integer" }, - "parameterOrder": [ - "project", - "region" - ], - "request": { - "$ref": "ServiceAttachment" + "type": "array" + }, + "srcIpRanges": { + "description": "Source IPv4/IPv6 addresses or CIDR prefixes, in standard text format.", + "items": { + "type": "string" }, - "response": { - "$ref": "Operation" + "type": "array" + }, + "srcPorts": { + "description": "Source port numbers for TCP/UDP/SCTP. Each element can be a 16-bit\nunsigned decimal number (e.g. \"80\") or range (e.g. \"0-1023\").", + "items": { + "type": "string" }, - "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." + "type": "array" }, - "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" - } + "srcRegionCodes": { + "description": "Two-letter ISO 3166-1 alpha-2 country code associated with the source\nIP address.", + "items": { + "type": "string" + }, + "type": "array" + }, + "userDefinedFields": { + "description": "User-defined fields. Each element names a defined field and lists the\nmatching values for that field.", + "items": { + "$ref": "SecurityPolicyRuleNetworkMatcherUserDefinedFieldMatch" + }, + "type": "array" + } + }, + "type": "object" + }, + "SecurityPolicyRuleNetworkMatcherUserDefinedFieldMatch": { + "id": "SecurityPolicyRuleNetworkMatcherUserDefinedFieldMatch", + "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\ndecimal or hexadecimal (starting with \"0x\") number (e.g. \"64\") or\nrange (e.g. \"0x400-0x7ff\").", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, + "SecurityPolicyRulePreconfiguredWafConfig": { + "id": "SecurityPolicyRulePreconfiguredWafConfig", + "properties": { + "exclusions": { + "description": "A list of exclusions to apply during preconfigured WAF evaluation.", + "items": { + "$ref": "SecurityPolicyRulePreconfiguredWafConfigExclusion" }, - "parameterOrder": [ - "project", - "region", - "serviceAttachment" - ], - "response": { - "$ref": "Operation" + "type": "array" + } + }, + "type": "object" + }, + "SecurityPolicyRulePreconfiguredWafConfigExclusion": { + "id": "SecurityPolicyRulePreconfiguredWafConfigExclusion", + "properties": { + "requestCookiesToExclude": { + "description": "A list of request cookie names whose value will be excluded from\ninspection during preconfigured WAF evaluation.", + "items": { + "$ref": "SecurityPolicyRulePreconfiguredWafConfigExclusionFieldParams" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified ServiceAttachment in the given scope" + "type": "array" }, - "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" - } + "requestHeadersToExclude": { + "description": "A list of request header names whose value will be excluded from\ninspection during preconfigured WAF evaluation.", + "items": { + "$ref": "SecurityPolicyRulePreconfiguredWafConfigExclusionFieldParams" }, - "parameterOrder": [ - "project", - "region", - "serviceAttachment" - ], - "request": { - "$ref": "ServiceAttachment" + "type": "array" + }, + "requestQueryParamsToExclude": { + "description": "A list of request query parameter names whose value will be excluded\nfrom inspection during preconfigured WAF evaluation. Note that the\nparameter can be in the query string or in the POST body.", + "items": { + "$ref": "SecurityPolicyRulePreconfiguredWafConfigExclusionFieldParams" }, - "response": { - "$ref": "Operation" + "type": "array" + }, + "requestUrisToExclude": { + "description": "A list of request URIs from the request line to be excluded from\ninspection during preconfigured WAF evaluation. When specifying this\nfield, the query or fragment part should be excluded.", + "items": { + "$ref": "SecurityPolicyRulePreconfiguredWafConfigExclusionFieldParams" }, - "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." + "type": "array" }, - "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" - } + "targetRuleIds": { + "description": "A list of target rule IDs under the WAF rule set to apply the\npreconfigured WAF exclusion. If omitted, it refers to all the rule\nIDs under the WAF rule set.", + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "region", - "resource" + "type": "array" + }, + "targetRuleSet": { + "description": "Target WAF rule set to apply the preconfigured WAF exclusion.", + "type": "string" + } + }, + "type": "object" + }, + "SecurityPolicyRulePreconfiguredWafConfigExclusionFieldParams": { + "id": "SecurityPolicyRulePreconfiguredWafConfigExclusionFieldParams", + "properties": { + "op": { + "description": "The match operator for the field.", + "enum": [ + "CONTAINS", + "ENDS_WITH", + "EQUALS", + "EQUALS_ANY", + "STARTS_WITH" ], - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "The operator matches if the field value contains the specified\nvalue.", + "The operator matches if the field value ends with the specified\nvalue.", + "The operator matches if the field value equals the specified\nvalue.", + "The operator matches if the field value is any value.", + "The operator matches if the field value starts with the specified\nvalue." ], - "description": "Gets the access control policy for a resource. May be empty if no such policy or resource exists." + "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" + "val": { + "description": "The value of the field.", + "type": "string" + } + }, + "type": "object" + }, + "SecurityPolicyRuleRateLimitOptions": { + "id": "SecurityPolicyRuleRateLimitOptions", + "properties": { + "banDurationSec": { + "description": "Can only be specified if the action for the rule is\n\"rate_based_ban\". If specified, determines the time (in seconds)\nthe traffic will continue to be banned by the rate limit after the\nrate falls below the threshold.", + "format": "int32", + "type": "integer" + }, + "banThreshold": { + "$ref": "SecurityPolicyRuleRateLimitOptionsThreshold", + "description": "Can only be specified if the action for the rule is\n\"rate_based_ban\". If specified, the key will be banned for the\nconfigured 'ban_duration_sec' when the number of requests that exceed\nthe 'rate_limit_threshold' also exceed this 'ban_threshold'." + }, + "conformAction": { + "description": "Action to take for requests that are under the configured rate limit\nthreshold. Valid option is \"allow\" only.", + "type": "string" + }, + "enforceOnKey": { + "description": "Determines the key to enforce the rate_limit_threshold on. Possible\nvalues are:\n \n - ALL: A single rate limit threshold is applied to all\n the requests matching this rule. This is the default value if\n \"enforceOnKey\" is not configured.\n - IP: The source IP address of\n the request is the key. Each IP has this limit enforced\n separately.\n - HTTP_HEADER: The value of the HTTP\n header whose name is configured under \"enforceOnKeyName\". The key\n value is truncated to the first 128 bytes of the header value. If no\n such header is present in the request, the key type defaults toALL.\n - XFF_IP: The first IP address (i.e. the\n originating client IP address) specified in the list of IPs under\n X-Forwarded-For HTTP header. If no such header is present or the value\n is not a valid IP, the key defaults to the source IP address of\n the request i.e. key type IP.\n - HTTP_COOKIE: The value of the HTTP\n cookie whose name is configured under \"enforceOnKeyName\". The key\n value is truncated to the first 128 bytes of the cookie value. If no\n such cookie is present in the request, the key type defaults toALL.\n - HTTP_PATH: The URL path of the HTTP request. The key\n value is truncated to the first 128 bytes. \n - SNI: Server name indication in the TLS session of the\n HTTPS request. The key value is truncated to the first 128 bytes. The\n key type defaults to ALL on a HTTP session. \n - REGION_CODE: The country/region from which the request\n originates. \n - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the\n client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the\n key type defaults to ALL. \n - USER_IP: The IP address of the originating client,\n which is resolved based on \"userIpRequestHeaders\" configured with the\n security policy. If there is no \"userIpRequestHeaders\" configuration or\n an IP address cannot be resolved from it, the key type defaults toIP. \n - ASN: The autonomous system number of the originating\n client. If not available, the key type defaults toALL.\n - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the\n client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the\n key type defaults to ALL. \n\n\nFor \"fairshare\" action, this value is limited to ALL i.e. a single rate\nlimit threshold is enforced for all the requests matching the rule.", + "enum": [ + "ALL", + "ASN", + "HTTP_COOKIE", + "HTTP_HEADER", + "HTTP_PATH", + "IP", + "REGION_CODE", + "SNI", + "TLS_JA3_FINGERPRINT", + "TLS_JA4_FINGERPRINT", + "USER_IP", + "XFF_IP" ], - "request": { - "$ref": "RegionSetPolicyRequest" - }, - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "" ], - "description": "Sets the access control policy on the specified resource. Replaces any existing policy." + "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" - }, - "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" - } + "enforceOnKeyConfigs": { + "description": "If specified, any combination of values of\nenforce_on_key_type/enforce_on_key_name is treated as the key on which\nratelimit threshold/action is enforced. You can specify up to 3\nenforce_on_key_configs. If enforce_on_key_configs is specified,\nenforce_on_key must not be specified.", + "items": { + "$ref": "SecurityPolicyRuleRateLimitOptionsEnforceOnKeyConfig" }, - "parameterOrder": [ - "project", - "region", - "resource" + "type": "array" + }, + "enforceOnKeyName": { + "description": "Rate limit key name applicable only for the following key types:\nHTTP_HEADER -- Name of the HTTP header whose value is taken as the key\nvalue.\nHTTP_COOKIE -- Name of the HTTP cookie whose value is taken as the key\nvalue.", + "type": "string" + }, + "exceedAction": { + "description": "Action to take for requests that are above the configured rate limit\nthreshold, to either deny with a specified HTTP response code, or\nredirect to a different endpoint.\nValid options are `deny(STATUS)`, where valid values for\n`STATUS` are 403, 404, 429, and 502, and\n`redirect`, where the redirect parameters come from\n`exceedRedirectOptions` below.\nThe `redirect` action is only supported in Global Security Policies of\ntype CLOUD_ARMOR.", + "type": "string" + }, + "exceedRedirectOptions": { + "$ref": "SecurityPolicyRuleRedirectOptions", + "description": "Parameters defining the redirect action that is used as the exceed\naction. Cannot be specified if the exceed action is not redirect.\nThis field is only supported in Global Security Policies of type\nCLOUD_ARMOR." + }, + "rateLimitThreshold": { + "$ref": "SecurityPolicyRuleRateLimitOptionsThreshold", + "description": "Threshold at which to begin ratelimiting." + } + }, + "type": "object" + }, + "SecurityPolicyRuleRateLimitOptionsEnforceOnKeyConfig": { + "id": "SecurityPolicyRuleRateLimitOptionsEnforceOnKeyConfig", + "properties": { + "enforceOnKeyName": { + "description": "Rate limit key name applicable only for the following key types:\nHTTP_HEADER -- Name of the HTTP header whose value is taken as the\nkey value. HTTP_COOKIE -- Name of the HTTP cookie whose value is\ntaken as the key value.", + "type": "string" + }, + "enforceOnKeyType": { + "description": "Determines the key to enforce the rate_limit_threshold on. Possible\nvalues are:\n \n - ALL: A single rate limit threshold is applied to all\n the requests matching this rule. This is the default value if\n \"enforceOnKeyConfigs\" is not configured.\n - IP: The source IP address of\n the request is the key. Each IP has this limit enforced\n separately.\n - HTTP_HEADER: The value of the HTTP\n header whose name is configured under \"enforceOnKeyName\". The key\n value is truncated to the first 128 bytes of the header value. If no\n such header is present in the request, the key type defaults toALL.\n - XFF_IP: The first IP address (i.e. the\n originating client IP address) specified in the list of IPs under\n X-Forwarded-For HTTP header. If no such header is present or the\n value is not a valid IP, the key defaults to the source IP address of\n the request i.e. key type IP.\n - HTTP_COOKIE: The value of the HTTP\n cookie whose name is configured under \"enforceOnKeyName\". The key\n value is truncated to the first 128 bytes of the cookie value. If no\n such cookie is present in the request, the key type defaults toALL.\n - HTTP_PATH: The URL path of the HTTP request. The key\n value is truncated to the first 128 bytes. \n - SNI: Server name indication in the TLS session of\n the HTTPS request. The key value is truncated to the first 128 bytes.\n The key type defaults to ALL on a HTTP session. \n - REGION_CODE: The country/region from which the\n request originates. \n - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the\n client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the\n key type defaults to ALL. \n - USER_IP: The IP address of the originating client,\n which is resolved based on \"userIpRequestHeaders\" configured with the\n security policy. If there is no \"userIpRequestHeaders\" configuration\n or an IP address cannot be resolved from it, the key type defaults toIP. \n - ASN: The autonomous system number of the originating\n client. If not available, the key type defaults toALL.\n - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the\n client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the\n key type defaults to ALL.", + "enum": [ + "ALL", + "ASN", + "HTTP_COOKIE", + "HTTP_HEADER", + "HTTP_PATH", + "IP", + "REGION_CODE", + "SNI", + "TLS_JA3_FINGERPRINT", + "TLS_JA4_FINGERPRINT", + "USER_IP", + "XFF_IP" ], - "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" + "enumDescriptions": [ + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "" ], - "description": "Returns permissions that a caller has on the specified resource." + "type": "string" } - } + }, + "type": "object" }, - "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" - } + "SecurityPolicyRuleRateLimitOptionsThreshold": { + "id": "SecurityPolicyRuleRateLimitOptionsThreshold", + "properties": { + "count": { + "description": "Number of HTTP(S) requests for calculating the threshold.", + "format": "int32", + "type": "integer" + }, + "intervalSec": { + "description": "Interval over which the threshold is computed.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, + "SecurityPolicyRuleRedirectOptions": { + "id": "SecurityPolicyRuleRedirectOptions", + "properties": { + "target": { + "description": "Target for the redirect action. This is required if the type is\nEXTERNAL_302 and cannot be specified for GOOGLE_RECAPTCHA.", + "type": "string" + }, + "type": { + "description": "Type of the redirect action. Possible values are:\n \n - GOOGLE_RECAPTCHA: redirect to reCAPTCHA for manual\n challenge assessment.\n - EXTERNAL_302: redirect to a different URL via a 302\n response.", + "enum": [ + "EXTERNAL_302", + "GOOGLE_RECAPTCHA" + ], + "enumDescriptions": [ + "", + "" + ], + "type": "string" + } + }, + "type": "object" + }, + "SecurityPolicyUserDefinedField": { + "id": "SecurityPolicyUserDefinedField", + "properties": { + "base": { + "description": "The base relative to which 'offset' is measured. Possible values are:\n \n - IPV4: Points to the beginning of the IPv4 header.\n - IPV6: Points to the beginning of the IPv6 header.\n - TCP: Points to the beginning of the TCP header, skipping\n over any IPv4 options or IPv6 extension headers. Not present for\n non-first fragments.\n - UDP: Points to the beginning of the UDP header, skipping\n over any IPv4 options or IPv6 extension headers. Not present for\n non-first fragments.\n\n\nrequired", + "enum": [ + "IPV4", + "IPV6", + "TCP", + "UDP" + ], + "enumDescriptions": [ + "", + "", + "", + "" + ], + "type": "string" + }, + "mask": { + "description": "If specified, apply this mask (bitwise AND) to the field to ignore bits\nbefore matching. Encoded as a hexadecimal number (starting with \"0x\").\nThe last byte of the field (in network byte order) corresponds to the\nleast significant byte of the mask.", + "type": "string" + }, + "name": { + "description": "The name of this field. Must be unique within the policy.", + "type": "string" + }, + "offset": { + "description": "Offset of the first byte of the field (in network byte order) relative to\n'base'.", + "format": "int32", + "type": "integer" + }, + "size": { + "description": "Size of the field in bytes. Valid values: 1-4.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, + "SecuritySettings": { + "description": "The authentication and authorization settings for a BackendService.", + "id": "SecuritySettings", + "properties": { + "awsV4Authentication": { + "$ref": "AWSV4Signature", + "description": "The configuration needed to generate a signature for access to private\nstorage buckets that support AWS's Signature Version 4 for authentication.\nAllowed only for INTERNET_IP_PORT and INTERNET_FQDN_PORT NEG backends." + }, + "clientTlsPolicy": { + "description": "Optional. A URL referring to a networksecurity.ClientTlsPolicy resource\nthat describes how clients should authenticate with this service's\nbackends.\n\n clientTlsPolicy only applies to a globalBackendService with the loadBalancingScheme set\nto INTERNAL_SELF_MANAGED.\n\n If left blank, communications are not encrypted.", + "type": "string" + }, + "subjectAltNames": { + "description": "Optional. A list of Subject Alternative Names (SANs) that the client\nverifies during a mutual TLS handshake with an server/endpoint for thisBackendService. When the server presents its X.509 certificate\nto the client, the client inspects the certificate'ssubjectAltName field. If the field contains one of the\nspecified values, the communication continues. Otherwise, it fails. This\nadditional check enables the client to verify that the server is authorized\nto run the requested service.\n\n Note that the contents of the server\ncertificate's subjectAltName field are configured by the\nPublic Key Infrastructure which provisions server identities.\n\n Only applies to a global BackendService withloadBalancingScheme set to INTERNAL_SELF_MANAGED.\nOnly applies when BackendService has an attachedclientTlsPolicy with clientCertificate (mTLS\nmode).", + "items": { + "type": "string" }, - "parameterOrder": [ - "project" + "type": "array" + } + }, + "type": "object" + }, + "SerialPortOutput": { + "description": "An instance serial console output.", + "id": "SerialPortOutput", + "properties": { + "contents": { + "description": "[Output Only] The contents of the console output.", + "type": "string" + }, + "kind": { + "default": "compute#serialPortOutput", + "description": "Output only. [Output Only] Type of the resource. Alwayscompute#serialPortOutput for serial port output.", + "readOnly": true, + "type": "string" + }, + "next": { + "description": "[Output Only] The position of the next byte of content, regardless of\nwhether the content exists, following the output returned in the `contents`\nproperty. Use this value in the next request as the start\nparameter.", + "format": "int64", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "start": { + "description": "The starting byte position of the output that was returned.\nThis should match the start parameter sent with the request.\nIf the serial console output exceeds the size of the buffer (1 MB), older\noutput is overwritten by newer content. The output start value will\nindicate the byte position of the output that was returned, which might be\ndifferent than the `start` value that was specified in the request.", + "format": "int64", + "type": "string" + } + }, + "type": "object" + }, + "ServerBinding": { + "id": "ServerBinding", + "properties": { + "type": { + "enum": [ + "RESTART_NODE_ON_ANY_SERVER", + "RESTART_NODE_ON_MINIMAL_SERVERS", + "SERVER_BINDING_TYPE_UNSPECIFIED" ], - "response": { - "$ref": "SnapshotSettings" + "enumDescriptions": [ + "Node may associate with any physical server over its lifetime.", + "Node may associate with minimal physical servers over its lifetime.", + "" + ], + "type": "string" + } + }, + "type": "object" + }, + "ServiceAccount": { + "description": "A service account.", + "id": "ServiceAccount", + "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.", + "items": { + "type": "string" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "type": "array" + } + }, + "type": "object" + }, + "ServiceAttachment": { + "description": "Represents a ServiceAttachment resource.\n\nA service attachment represents a service that a producer has exposed.\nIt encapsulates the load balancer which fronts the service runs and\na list of NAT IP ranges that the producers uses to represent\nthe consumers connecting to the service.", + "id": "ServiceAttachment", + "properties": { + "connectedEndpoints": { + "description": "Output only. [Output Only] An array of connections for all the consumers connected to\nthis service attachment.", + "items": { + "$ref": "ServiceAttachmentConnectedEndpoint" + }, + "readOnly": true, + "type": "array" + }, + "connectionPreference": { + "description": "The connection preference of service attachment. The value can be set\nto ACCEPT_AUTOMATIC. An ACCEPT_AUTOMATIC\nservice attachment is one that always accepts the connection from consumer\nforwarding rules.", + "enum": [ + "ACCEPT_AUTOMATIC", + "ACCEPT_MANUAL", + "CONNECTION_PREFERENCE_UNSPECIFIED" + ], + "enumDescriptions": [ + "", + "", + "" ], - "description": "Get snapshot settings." + "type": "string" + }, + "consumerAcceptLists": { + "description": "Specifies which consumer projects or networks are allowed to connect to the\nservice attachment. Each project or network has a connection limit. A given\nservice attachment can manage connections at either the project or network\nlevel. Therefore, both the accept and reject lists for a given service\nattachment must contain either only projects or only networks or only\nendpoints.", + "items": { + "$ref": "ServiceAttachmentConsumerProjectLimit" + }, + "type": "array" + }, + "consumerRejectLists": { + "description": "Specifies a list of projects or networks that are not allowed to connect to\nthis service attachment. The project can be specified using its project ID\nor project number and the network can be specified using its URL. A given\nservice attachment can manage connections at either the project or network\nlevel. Therefore, both the reject and accept lists for a given service\nattachment must contain either only projects or only networks.", + "items": { + "type": "string" + }, + "type": "array" + }, + "creationTimestamp": { + "description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you\ncreate the resource.", + "type": "string" + }, + "domainNames": { + "description": "If specified, the domain name will be used during the integration between\nthe PSC connected endpoints and the Cloud DNS. For example, this is a valid\ndomain name: \"p.mycompany.com.\". Current max number of domain names\nsupported is 1.", + "items": { + "type": "string" + }, + "type": "array" + }, + "enableProxyProtocol": { + "description": "If true, enable the proxy protocol which is for supplying client TCP/IP\naddress data in TCP connections that traverse proxies on their way to\ndestination servers.", + "type": "boolean" + }, + "fingerprint": { + "description": "Fingerprint of this resource. A hash of the contents stored in this object.\nThis field is used in optimistic locking. This field will be ignored when\ninserting a ServiceAttachment. An up-to-date fingerprint must\nbe provided in order to patch/update the ServiceAttachment; otherwise, the\nrequest will fail with error 412 conditionNotMet. To see the\nlatest fingerprint, make a get() request to retrieve the\nServiceAttachment.", + "format": "byte", + "type": "string" + }, + "id": { + "description": "Output only. [Output Only] The unique identifier for the resource type. The server\ngenerates this identifier.", + "format": "uint64", + "readOnly": true, + "type": "string" + }, + "kind": { + "default": "compute#serviceAttachment", + "description": "Output only. [Output Only] Type of the resource. Alwayscompute#serviceAttachment for service attachments.", + "readOnly": true, + "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" - } + "metadata": { + "additionalProperties": { + "type": "string" }, - "parameterOrder": [ - "project" - ], - "request": { - "$ref": "SnapshotSettings" + "description": "Metadata of the service attachment.", + "type": "object" + }, + "name": { + "annotations": { + "required": [ + "compute.serviceAttachments.insert" + ] }, - "response": { - "$ref": "Operation" + "description": "Name of the resource. Provided by the client when the resource is created.\nThe name must be 1-63 characters long, and comply withRFC1035.\nSpecifically, the name must be 1-63 characters long and match the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first\ncharacter must be a lowercase letter, and all following characters must\nbe a dash, lowercase letter, or digit, except the last character, which\ncannot be a dash.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "natIpsPerEndpoint": { + "description": "The number of NAT IP addresses to be allocated per connected endpoint.\nIf not specified, the default value is 1.", + "format": "uint32", + "type": "integer" + }, + "natSubnets": { + "description": "An array of URLs where each entry is the URL of a subnet provided\nby the service producer to use for NAT in this service attachment.", + "items": { + "type": "string" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Patch snapshot settings." + "type": "array" + }, + "producerForwardingRule": { + "deprecated": true, + "description": "The URL of a forwarding rule with loadBalancingScheme INTERNAL* that is\nserving the endpoint identified by this service attachment.", + "type": "string" + }, + "propagatedConnectionLimit": { + "description": "The number of consumer spokes that connected Private Service Connect\nendpoints can be propagated to through Network Connectivity Center. This\nlimit lets the service producer limit how many propagated Private Service\nConnect connections can be established to this service attachment from a\nsingle consumer.\n\nIf the connection preference of the service attachment is ACCEPT_MANUAL,\nthe limit applies to each project or network that is listed in the consumer\naccept list. If the connection preference of the service attachment is\nACCEPT_AUTOMATIC, the limit applies to each project that contains a\nconnected endpoint.\n\nIf unspecified, the default propagated connection limit is 250.", + "format": "uint32", + "type": "integer" + }, + "pscServiceAttachmentId": { + "$ref": "Uint128", + "description": "Output only. [Output Only] An 128-bit global unique ID of the PSC service attachment.", + "readOnly": true + }, + "reconcileConnections": { + "description": "This flag determines whether a consumer accept/reject list change can\nreconcile the statuses of existing ACCEPTED or REJECTED PSC endpoints.\n \n \n - If false, connection policy update will only affect existing PENDING\n PSC endpoints. Existing ACCEPTED/REJECTED endpoints will remain untouched\n regardless how the connection policy is modified . \n - If true,\n update will affect both PENDING and ACCEPTED/REJECTED PSC endpoints. For\n example, an ACCEPTED PSC endpoint will be moved to REJECTED if its project\n is added to the reject list.\n\n\nFor newly created service attachment, this boolean defaults to false.", + "type": "boolean" + }, + "region": { + "description": "Output only. [Output Only] URL of the region where the service attachment resides.\nThis field applies only to the region resource. You must specify this\nfield as part of the HTTP request URL. It is not settable as a field in\nthe request body.", + "readOnly": true, + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for the resource.", + "readOnly": true, + "type": "string" + }, + "targetService": { + "description": "The URL of a service serving the endpoint identified by this service\nattachment.", + "type": "string" } - } + }, + "type": "object" }, - "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" - } + "ServiceAttachmentAggregatedList": { + "description": "Contains a list of ServiceAttachmentsScopedList.", + "id": "ServiceAttachmentAggregatedList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "additionalProperties": { + "$ref": "ServiceAttachmentsScopedList", + "description": "Name of the scope containing this set of ServiceAttachments." }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "SslCertificateList" + "description": "A list of ServiceAttachmentsScopedList resources.", + "type": "object" + }, + "kind": { + "default": "compute#serviceAttachmentAggregatedList", + "description": "Output only. Type of resource.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "unreachables": { + "description": "Output only. [Output Only] Unreachable resources.", + "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 the list of SslCertificate resources available to the specified project." + "readOnly": true, + "type": "array" }, - "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, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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, + "data": { + "description": "[Output Only] Metadata about this warning in key:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" + }, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "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." + "type": "object" + } + }, + "type": "object" + }, + "ServiceAttachmentConnectedEndpoint": { + "description": "[Output Only] A connection connected to this service attachment.", + "id": "ServiceAttachmentConnectedEndpoint", + "properties": { + "consumerNetwork": { + "description": "The url of the consumer network.", + "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" - } + "endpoint": { + "description": "The url of a connected endpoint.", + "type": "string" + }, + "endpointWithId": { + "description": "The url of a connected endpoint with resource id.", + "type": "string" + }, + "natIps": { + "description": "NAT IPs of the connected PSC endpoint and those of other endpoints\npropagated from it.", + "items": { + "type": "string" }, - "parameterOrder": [ - "project" + "type": "array" + }, + "propagatedConnectionCount": { + "description": "The number of consumer Network Connectivity Center spokes that the\nconnected Private Service Connect endpoint has propagated to.", + "format": "uint32", + "type": "integer" + }, + "pscConnectionId": { + "description": "The PSC connection id of the connected endpoint.", + "format": "uint64", + "type": "string" + }, + "status": { + "description": "The status of a connected endpoint to this service attachment.", + "enum": [ + "ACCEPTED", + "CLOSED", + "NEEDS_ATTENTION", + "PENDING", + "REJECTED", + "STATUS_UNSPECIFIED" ], - "request": { - "$ref": "SslCertificate" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "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\nneeds to take further action before the forwarding rule can serve\ntraffic.", + "The connection is pending acceptance by the producer.", + "The consumer is still connected but not using the connection.", + "" ], - "description": "Creates a SslCertificate resource in the specified project using the data included in the request." + "type": "string" + } + }, + "type": "object" + }, + "ServiceAttachmentConsumerProjectLimit": { + "id": "ServiceAttachmentConsumerProjectLimit", + "properties": { + "connectionLimit": { + "description": "The value of the limit to set. For endpoint_url, the limit should be no\nmore than 1.", + "format": "uint32", + "type": "integer" }, - "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" + "endpointUrl": { + "description": "The URL for the PSC endpoint to accept", + "type": "string" + }, + "networkUrl": { + "description": "The network URL for the network to set the limit for.", + "type": "string" + }, + "projectIdOrNum": { + "description": "The project id or number for the project to set the limit for.", + "type": "string" + } + }, + "type": "object" + }, + "ServiceAttachmentList": { + "id": "ServiceAttachmentList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of ServiceAttachment resources.", + "items": { + "$ref": "ServiceAttachment" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified SslCertificate resource." + "type": "array" }, - "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", + "kind": { + "default": "compute#serviceAttachmentList", + "description": "Output only. [Output Only] Type of the resource. Alwayscompute#serviceAttachment for service attachments.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue 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.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "pageToken": { - "description": "Specifies a page token 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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" } }, - "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`." + "type": "object" } - } + }, + "type": "object" }, - "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" + "ServiceAttachmentsScopedList": { + "id": "ServiceAttachmentsScopedList", + "properties": { + "serviceAttachments": { + "description": "A list of ServiceAttachments contained in this scope.", + "items": { + "$ref": "ServiceAttachment" }, - "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." + "type": "array" }, - "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, + "warning": { + "description": "Informational warning which replaces the list of\nservice attachments when the list is empty.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "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." + "type": "object" + } + }, + "type": "object" + }, + "SetCommonInstanceMetadataOperationMetadata": { + "id": "SetCommonInstanceMetadataOperationMetadata", + "properties": { + "clientOperationId": { + "description": "[Output Only] The client operation id.", + "type": "string" }, - "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" + "perLocationOperations": { + "additionalProperties": { + "$ref": "SetCommonInstanceMetadataOperationMetadataPerLocationOperationInfo" }, - "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" + "description": "[Output Only] Status information per location (location name is key).\nExample key: zones/us-central1-a", + "type": "object" + } + }, + "type": "object" + }, + "SetCommonInstanceMetadataOperationMetadataPerLocationOperationInfo": { + "id": "SetCommonInstanceMetadataOperationMetadataPerLocationOperationInfo", + "properties": { + "error": { + "$ref": "Status", + "description": "[Output Only] If state is `ABANDONED` or `FAILED`, this field is\npopulated." }, - "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" + "state": { + "description": "[Output Only] Status of the action, which can be one of the following:\n`PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.", + "enum": [ + "ABANDONED", + "DONE", + "FAILED", + "PROPAGATED", + "PROPAGATING", + "UNSPECIFIED" ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "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": "Deletes the specified SslCertificate resource in the region." + "type": "string" } - } + }, + "type": "object" }, - "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" - } + "ShareSettings": { + "description": "The share setting for reservations and sole tenancy node groups.", + "id": "ShareSettings", + "properties": { + "projectMap": { + "additionalProperties": { + "$ref": "ShareSettingsProjectConfig" }, - "parameterOrder": [ - "project" + "description": "A map of project id and project config. This is only valid when\nshare_type's value is SPECIFIC_PROJECTS.", + "type": "object" + }, + "shareType": { + "description": "Type of sharing for this shared-reservation", + "enum": [ + "LOCAL", + "ORGANIZATION", + "SHARE_TYPE_UNSPECIFIED", + "SPECIFIC_PROJECTS" ], - "response": { - "$ref": "SslPoliciesList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "Default value.", + "Shared-reservation is open to entire Organization", + "Default value. This value is unused.", + "Shared-reservation is open to specific projects" ], - "description": "Lists all the SSL policies that have been configured for the specified project." + "type": "string" + } + }, + "type": "object" + }, + "ShareSettingsProjectConfig": { + "description": "Config for each project in the share settings.", + "id": "ShareSettingsProjectConfig", + "properties": { + "projectId": { + "description": "The project ID, should be same as the key of this project config in the\nparent map.", + "type": "string" + } + }, + "type": "object" + }, + "ShieldedInstanceConfig": { + "description": "A set of Shielded Instance options.", + "id": "ShieldedInstanceConfig", + "properties": { + "enableIntegrityMonitoring": { + "description": "Defines whether the instance has integrity monitoring enabled.Enabled by\ndefault.", + "type": "boolean" }, - "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" + "enableSecureBoot": { + "description": "Defines whether the instance has Secure Boot enabled.Disabled by\ndefault.", + "type": "boolean" + }, + "enableVtpm": { + "description": "Defines whether the instance has the vTPM enabled.Enabled by\ndefault.", + "type": "boolean" + } + }, + "type": "object" + }, + "ShieldedInstanceIdentity": { + "description": "A Shielded Instance Identity.", + "id": "ShieldedInstanceIdentity", + "properties": { + "eccP256EncryptionKey": { + "$ref": "ShieldedInstanceIdentityEntry", + "description": "An Endorsement Key (EK) made by the ECC P256 algorithm\nissued to the Shielded Instance's vTPM." + }, + "eccP256SigningKey": { + "$ref": "ShieldedInstanceIdentityEntry", + "description": "An Attestation Key (AK) made by the ECC P256 algorithm\nissued to the Shielded Instance's vTPM." + }, + "encryptionKey": { + "$ref": "ShieldedInstanceIdentityEntry", + "description": "An Endorsement Key (EK) made by the RSA 2048 algorithm\nissued to the Shielded Instance's vTPM." + }, + "kind": { + "default": "compute#shieldedInstanceIdentity", + "description": "Output only. [Output Only] Type of the resource. Alwayscompute#shieldedInstanceIdentity for shielded Instance\nidentity entry.", + "readOnly": true, + "type": "string" + }, + "signingKey": { + "$ref": "ShieldedInstanceIdentityEntry", + "description": "An Attestation Key (AK) made by the RSA 2048 algorithm\nissued to the Shielded Instance's vTPM." + } + }, + "type": "object" + }, + "ShieldedInstanceIdentityEntry": { + "description": "A Shielded Instance Identity Entry.", + "id": "ShieldedInstanceIdentityEntry", + "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" + } + }, + "type": "object" + }, + "ShieldedInstanceIntegrityPolicy": { + "description": "The policy describes the baseline against which\nInstance boot integrity is measured.", + "id": "ShieldedInstanceIntegrityPolicy", + "properties": { + "updateAutoLearnPolicy": { + "description": "Updates the integrity policy baseline using the\nmeasurements from the VM instance's most recent boot.", + "type": "boolean" + } + }, + "type": "object" + }, + "SignedUrlKey": { + "description": "Represents a customer-supplied Signing Key used by Cloud CDN Signed URLs", + "id": "SignedUrlKey", + "properties": { + "keyName": { + "description": "Name of the key. The name must be 1-63 characters long, and comply withRFC1035.\nSpecifically, the name must be 1-63 characters long and match the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first\ncharacter must be a lowercase letter, and all following characters must\nbe a dash, lowercase letter, or digit, except the last character, which\ncannot 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 validRFC\n4648 Section 5 base64url encoded string.", + "type": "string" + } + }, + "type": "object" + }, + "Snapshot": { + "description": "Represents a Persistent Disk Snapshot resource.\n\nYou can use snapshots to back up data on a regular interval. For more\ninformation, read Creating\npersistent disk snapshots.", + "id": "Snapshot", + "properties": { + "architecture": { + "description": "Output only. [Output Only] The architecture of the snapshot. Valid values are\nARM64 or X86_64.", + "enum": [ + "ARCHITECTURE_UNSPECIFIED", + "ARM64", + "X86_64" ], - "response": { - "$ref": "SslPolicy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "Default value indicating Architecture is not set.", + "Machines with architecture ARM64", + "Machines with architecture X86_64" ], - "description": "Lists all of the ordered rules present in a single specified policy." + "readOnly": true, + "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" - } + "autoCreated": { + "description": "Output only. [Output Only] Set to true if snapshots are automatically created by\napplying resource policy on the target disk.", + "readOnly": true, + "type": "boolean" + }, + "chainName": { + "description": "Creates the new snapshot in the snapshot chain labeled with the\nspecified name. The chain name must be 1-63 characters long and comply\nwith RFC1035. This is an uncommon option only for advanced service\nowners who needs to create separate snapshot chains, for example,\nfor chargeback tracking. When you describe your snapshot resource, this\nfield is visible only if it has a non-empty value.", + "type": "string" + }, + "creationSizeBytes": { + "description": "Output only. [Output Only] Size in bytes of the snapshot at creation time.", + "format": "int64", + "readOnly": true, + "type": "string" + }, + "creationTimestamp": { + "description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you\ncreate the resource.", + "type": "string" + }, + "diskSizeGb": { + "description": "Output only. [Output Only] Size of the source disk, specified in GB.", + "format": "int64", + "readOnly": true, + "type": "string" + }, + "downloadBytes": { + "description": "Output only. [Output Only] Number of bytes downloaded to restore a snapshot to a disk.", + "format": "int64", + "readOnly": true, + "type": "string" + }, + "enableConfidentialCompute": { + "description": "Output only. Whether this snapshot is created from a confidential compute mode disk.\n[Output Only]: This field is not set by user, but from source disk.", + "readOnly": true, + "type": "boolean" + }, + "guestFlush": { + "description": "[Input Only] Whether to attempt an application consistent snapshot by\ninforming the OS to prepare for the snapshot process.", + "type": "boolean" + }, + "guestOsFeatures": { + "description": "Output only. [Output Only] A list of features to enable on the guest operating system.\nApplicable only for bootable images. Read \nEnabling guest operating system features to see a list of available\noptions.", + "items": { + "$ref": "GuestOsFeature" }, - "parameterOrder": [ - "project" - ], - "request": { - "$ref": "SslPolicy" + "readOnly": true, + "type": "array" + }, + "id": { + "description": "Output only. [Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "format": "uint64", + "readOnly": true, + "type": "string" + }, + "kind": { + "default": "compute#snapshot", + "description": "Output only. [Output Only] Type of the resource. Always compute#snapshot\nfor Snapshot resources.", + "readOnly": true, + "type": "string" + }, + "labelFingerprint": { + "description": "A fingerprint for the labels being applied to this snapshot, which is\nessentially a hash of the labels set used for optimistic locking. The\nfingerprint is initially generated by Compute Engine and changes after\nevery request to modify or update labels. You must always provide an\nup-to-date fingerprint hash in order to update or change labels,\notherwise the request will fail with error412 conditionNotMet.\n\nTo see the latest fingerprint, make a get() request to\nretrieve a snapshot.", + "format": "byte", + "type": "string" + }, + "labels": { + "additionalProperties": { + "type": "string" }, - "response": { - "$ref": "Operation" + "description": "Labels to apply to this snapshot. These can be later modified by\nthe setLabels method.\nLabel values may be empty.", + "type": "object" + }, + "licenseCodes": { + "description": "Output only. [Output Only] Integer license codes indicating which licenses are attached\nto this snapshot.", + "items": { + "format": "int64", + "type": "string" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Returns the specified SSL policy resource." + "readOnly": true, + "type": "array" }, - "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" - } + "licenses": { + "description": "Output only. [Output Only] A list of public visible licenses that apply to this\nsnapshot. This can be because the original image had licenses attached\n(such as a Windows image).", + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "sslPolicy" - ], - "response": { - "$ref": "Operation" + "readOnly": true, + "type": "array" + }, + "locationHint": { + "description": "An opaque location hint used to place the snapshot close to other\nresources.\nThis field is for use by internal tools that use the public API.", + "type": "string" + }, + "name": { + "annotations": { + "required": [ + "compute.disks.createSnapshot", + "compute.snapshots.insert" + ] }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "description": "Name of the resource; provided by the client when the resource is created.\nThe name must be 1-63 characters long, and comply withRFC1035.\nSpecifically, the name must be 1-63 characters long and match the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first\ncharacter must be a lowercase letter, and all following characters must be\na dash, lowercase letter, or digit, except the last character, which cannot\nbe a dash.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "params": { + "$ref": "SnapshotParams", + "description": "Input only. [Input Only] Additional params passed with the request, but not persisted\nas part of resource payload." + }, + "region": { + "description": "Output only. [Output Only] URL of the region where the snapshot resides. Only applicable\nfor regional snapshots.", + "readOnly": true, + "type": "string" + }, + "satisfiesPzi": { + "description": "Output only. Reserved for future use.", + "readOnly": true, + "type": "boolean" + }, + "satisfiesPzs": { + "description": "Output only. [Output Only] Reserved for future use.", + "readOnly": true, + "type": "boolean" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for the resource.", + "readOnly": true, + "type": "string" + }, + "snapshotEncryptionKey": { + "$ref": "CustomerEncryptionKey", + "description": "Encrypts the snapshot using acustomer-supplied\nencryption key.\n\nAfter you encrypt a snapshot using a customer-supplied key, you must\nprovide the same key if you use the snapshot later. For example, you must\nprovide the encryption key when you create a disk from the encrypted\nsnapshot in a future request.\n\nCustomer-supplied encryption keys do not protect access to metadata\nof the snapshot.\n\nIf you do not provide an encryption key when creating the snapshot, then\nthe snapshot will be encrypted using an automatically generated key and you\ndo not need to provide a key to use the snapshot later." + }, + "snapshotGroupId": { + "description": "Output only. [Output Only] The unique ID of the snapshot group that this snapshot\nbelongs to. The usage of snapshot group feature is restricted.", + "readOnly": true, + "type": "string" + }, + "snapshotGroupName": { + "description": "Output only. [Output only] The snapshot group that this snapshot belongs to. The usage\nof snapshot group feature is restricted.", + "readOnly": true, + "type": "string" + }, + "snapshotType": { + "description": "Indicates the type of the snapshot.", + "enum": [ + "ARCHIVE", + "STANDARD" + ], + "enumDescriptions": [ + "", + "" ], - "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." + "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" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request 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", - "sslPolicy" + "sourceDisk": { + "description": "The source disk used to create this snapshot.", + "type": "string" + }, + "sourceDiskEncryptionKey": { + "$ref": "CustomerEncryptionKey", + "description": "The customer-supplied\nencryption key of the source disk. Required if the source disk is\nprotected by a customer-supplied encryption key." + }, + "sourceDiskForRecoveryCheckpoint": { + "description": "The source disk whose recovery checkpoint will be used to create this\nsnapshot.", + "type": "string" + }, + "sourceDiskId": { + "description": "Output only. [Output Only] The ID value of the disk used to create this snapshot. This\nvalue may be used to determine whether the snapshot was taken from the\ncurrent or a previous instance of a given disk name.", + "readOnly": true, + "type": "string" + }, + "sourceInstantSnapshot": { + "description": "The source instant snapshot used to create this snapshot. You can provide\nthis as a partial or full URL to the resource. For example, the following\nare valid values:\n \n \n - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instantSnapshots/instantSnapshot\n - projects/project/zones/zone/instantSnapshots/instantSnapshot \n - zones/zone/instantSnapshots/instantSnapshot", + "type": "string" + }, + "sourceInstantSnapshotEncryptionKey": { + "$ref": "CustomerEncryptionKey", + "description": "Customer provided encryption key when creating Snapshot from Instant\nSnapshot." + }, + "sourceInstantSnapshotId": { + "description": "Output only. [Output Only] The unique ID of the instant snapshot used to create this\nsnapshot. This value identifies the exact instant snapshot that was used to\ncreate this snapshot. For example, if you created the snapshot from an\ninstant snapshot that was later deleted and recreated under the same name,\nthe source instant snapshot ID would identify the exact instant snapshot\nthat was used.", + "readOnly": true, + "type": "string" + }, + "sourceSnapshotSchedulePolicy": { + "description": "Output only. [Output Only] URL of the resource policy which created this\nscheduled snapshot.", + "readOnly": true, + "type": "string" + }, + "sourceSnapshotSchedulePolicyId": { + "description": "Output only. [Output Only] ID of the resource policy which created this\nscheduled snapshot.", + "readOnly": true, + "type": "string" + }, + "status": { + "description": "Output only. [Output Only] The status of the snapshot. This can beCREATING, DELETING, FAILED,READY, or UPLOADING.", + "enum": [ + "CREATING", + "DELETING", + "FAILED", + "READY", + "UPLOADING" ], - "request": { - "$ref": "SslPolicy" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "Snapshot creation is in progress.", + "Snapshot is currently being deleted.", + "Snapshot creation failed.", + "Snapshot has been created successfully.", + "Snapshot is being uploaded." ], - "description": "Patches the specified SSL policy with the data included in the request." + "readOnly": true, + "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" + "storageBytes": { + "description": "Output only. [Output Only] A size of the storage used by the snapshot. As snapshots\nshare storage, this number is expected to change with snapshot\ncreation/deletion.", + "format": "int64", + "readOnly": true, + "type": "string" + }, + "storageBytesStatus": { + "description": "Output only. [Deprecated] Instead, check the storageBytes field. After\nsnapshot creation, the storageBytesStatus field is alwaysUP_TO_DATE.\n[Output Only] An indicator whether storageBytes is in a\nstable state or it is being adjusted as a result of shared storage\nreallocation. This status can either be unset, meaning the snapshot is\nbeing created, or UP_TO_DATE, meaning the size of the snapshot\nis up-to-date.", + "enum": [ + "UPDATING", + "UP_TO_DATE" ], - "response": { - "$ref": "SslPoliciesListAvailableFeaturesResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "", + "" ], - "description": "Lists all features that can be specified in the SSL policy when using custom profile." + "readOnly": true, + "type": "string" }, - "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" - } + "storageLocations": { + "description": "Cloud Storage bucket storage location of the snapshot (regional or\nmulti-regional).", + "items": { + "type": "string" }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "SslPoliciesAggregatedList" + "type": "array" + } + }, + "type": "object" + }, + "SnapshotGroupParameters": { + "id": "SnapshotGroupParameters", + "properties": { + "replicaZones": { + "description": "URLs of the zones where disks should be replicated to. Only applicable\nfor regional resources.", + "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 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`." + "type": "array" + }, + "sourceSnapshotGroup": { + "description": "The source snapshot group used to create disks. You can provide this as a\npartial or full URL to the resource. For example, the following are valid\nvalues:\n \n \n - https://www.googleapis.com/compute/v1/projects/project/global/snapshotGroups/snapshotGroup \n - projects/project/global/snapshotGroups/snapshotGroup\n - global/snapshotGroups/snapshotGroup", + "type": "string" + }, + "type": { + "description": "URL of the disk type resource describing which disk type to use to create\ndisks. Provide this when creating the disk. For example:projects/project/zones/zone/diskTypes/pd-ssd. See Persistent disk\ntypes.", + "type": "string" } - } + }, + "type": "object" }, - "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", + "SnapshotList": { + "description": "Contains a list of Snapshot resources.", + "id": "SnapshotList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of Snapshot resources.", + "items": { + "$ref": "Snapshot" + }, + "type": "array" + }, + "kind": { + "default": "compute#snapshotList", + "description": "Output only. Type of resource.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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" } }, - "parameterOrder": [ - "project", - "region" - ], - "response": { - "$ref": "SslPoliciesList" + "type": "object" + } + }, + "type": "object" + }, + "SnapshotParams": { + "description": "Additional snapshot params.", + "id": "SnapshotParams", + "properties": { + "resourceManagerTags": { + "additionalProperties": { + "type": "string" }, - "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." + "description": "Input only. Resource manager tags to be bound to the snapshot. Tag keys and values have\nthe same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in\nnamespaced format such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT &\nPATCH) when empty.", + "type": "object" + } + }, + "type": "object" + }, + "SnapshotSettings": { + "id": "SnapshotSettings", + "properties": { + "accessLocation": { + "$ref": "SnapshotSettingsAccessLocation", + "description": "(Regional snapshots use only)Policy of which location is allowed to access\nsnapshot." }, - "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" - } + "storageLocation": { + "$ref": "SnapshotSettingsStorageLocationSettings", + "description": "Policy of which storage location is going to be resolved, and additional\ndata that particularizes how the policy is going to be carried out." + } + }, + "type": "object" + }, + "SnapshotSettingsAccessLocation": { + "id": "SnapshotSettingsAccessLocation", + "properties": { + "locations": { + "additionalProperties": { + "$ref": "SnapshotSettingsAccessLocationAccessLocationPreference" }, - "parameterOrder": [ - "project", - "region", - "sslPolicy" + "description": "List of regions that can restore a regional\n snapshot from the current region", + "type": "object" + }, + "policy": { + "description": "Policy of which location is allowed to access snapshot.", + "enum": [ + "ALL_REGIONS", + "POLICY_UNSPECIFIED", + "SPECIFIC_REGIONS" ], - "response": { - "$ref": "SslPolicy" + "enumDescriptions": [ + "Any regions will be able to access the source location.", + "", + "Only allowlisted regions will be able to restore region scoped\nsnapshots" + ], + "type": "string" + } + }, + "type": "object" + }, + "SnapshotSettingsAccessLocationAccessLocationPreference": { + "description": "A structure for specifying an allowed target region.", + "id": "SnapshotSettingsAccessLocationAccessLocationPreference", + "properties": { + "region": { + "description": "Accessible region name", + "type": "string" + } + }, + "type": "object" + }, + "SnapshotSettingsStorageLocationSettings": { + "id": "SnapshotSettingsStorageLocationSettings", + "properties": { + "locations": { + "additionalProperties": { + "$ref": "SnapshotSettingsStorageLocationSettingsStorageLocationPreference" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "description": "When the policy is SPECIFIC_LOCATIONS, snapshots will be stored\nin the locations listed in this field. Keys are Cloud Storage bucket\nlocations. Only one location can be specified.", + "type": "object" + }, + "policy": { + "description": "The chosen location policy.", + "enum": [ + "LOCAL_REGION", + "NEAREST_MULTI_REGION", + "SPECIFIC_LOCATIONS", + "STORAGE_LOCATION_POLICY_UNSPECIFIED" + ], + "enumDescriptions": [ + "Store snapshot in the same region as with the originating disk.\nNo additional parameters are needed.", + "Store snapshot in the nearest multi region Cloud Storage bucket,\nrelative to the originating disk. No additional parameters are needed.", + "Store snapshot in the specific locations, as specified by the user.\nThe list of regions to store must be defined under the `locations`\nfield.", + "" ], - "description": "Lists all of the ordered rules present in a single specified policy." + "type": "string" + } + }, + "type": "object" + }, + "SnapshotSettingsStorageLocationSettingsStorageLocationPreference": { + "description": "A structure for specifying storage locations.", + "id": "SnapshotSettingsStorageLocationSettingsStorageLocationPreference", + "properties": { + "name": { + "description": "Name of the location. It should be one of the Cloud Storage buckets.\nOnly one location can be specified.", + "type": "string" + } + }, + "type": "object" + }, + "SnapshotUpdateKmsKeyRequest": { + "id": "SnapshotUpdateKmsKeyRequest", + "properties": { + "kmsKeyName": { + "description": "Optional. The new KMS key to replace the current one on the snapshot. If empty, the\nsnapshot will be re-encrypted using the primary version of the snapshot's\ncurrent KMS key.\n\nThe KMS key can be provided in the following formats:\n \n \n - projects/project_id/locations/region/keyRings/key_ring/cryptoKeys/key", + "type": "string" + } + }, + "type": "object" + }, + "SourceDiskEncryptionKey": { + "id": "SourceDiskEncryptionKey", + "properties": { + "diskEncryptionKey": { + "$ref": "CustomerEncryptionKey", + "description": "Thecustomer-supplied\nencryption key of the source disk. Required if the source disk is\nprotected by a customer-supplied encryption key." }, - "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" - } + "sourceDisk": { + "description": "URL of the disk attached to the source instance. This can be a full or\nvalid partial URL. For example, the following are valid values:\n \n \n - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk \n - projects/project/zones/zone/disks/disk \n - zones/zone/disks/disk", + "type": "string" + } + }, + "type": "object" + }, + "SourceInstanceParams": { + "description": "A specification of the parameters to use when creating the instance template\nfrom a source instance.", + "id": "SourceInstanceParams", + "properties": { + "diskConfigs": { + "description": "Attached disks configuration. If not provided, defaults are applied:\nFor boot disk and any other R/W disks, the source images for each disk\nwill be used. For read-only disks, they will be attached in read-only\nmode. Local SSD disks will be created as blank volumes.", + "items": { + "$ref": "DiskInstantiationConfig" }, - "parameterOrder": [ - "project", - "region" - ], - "request": { - "$ref": "SslPolicy" + "type": "array" + } + }, + "type": "object" + }, + "SourceInstanceProperties": { + "description": "DEPRECATED: Please use compute#instanceProperties instead.\nNew properties will not be added to this field.", + "id": "SourceInstanceProperties", + "properties": { + "canIpForward": { + "description": "Enables instances created based on this machine image to send packets with\nsource IP addresses other than their own and receive packets with\ndestination IP addresses other than their own. If these instances will be\nused as an IP gateway or it will be set as the next-hop in a Route\nresource, specify true. If unsure, leave this set tofalse. See theEnable IP forwarding\ndocumentation for more information.", + "type": "boolean" + }, + "deletionProtection": { + "description": "Whether the instance created from this machine image should be protected\nagainst deletion.", + "type": "boolean" + }, + "description": { + "description": "An optional text description for the instances that are created from this\nmachine image.", + "type": "string" + }, + "disks": { + "description": "An array of disks that are associated with the instances that are created\nfrom this machine image.", + "items": { + "$ref": "SavedAttachedDisk" }, - "response": { - "$ref": "Operation" + "type": "array" + }, + "guestAccelerators": { + "description": "A list of guest accelerator cards' type and count to use for instances\ncreated from this machine image.", + "items": { + "$ref": "AcceleratorConfig" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "type": "array" + }, + "keyRevocationActionType": { + "description": "KeyRevocationActionType of the instance. Supported options are \"STOP\" and\n\"NONE\". The default value is \"NONE\" if it is not specified.", + "enum": [ + "KEY_REVOCATION_ACTION_TYPE_UNSPECIFIED", + "NONE", + "STOP" + ], + "enumDescriptions": [ + "Default value. This value is unused.", + "Indicates user chose no operation.", + "Indicates user chose to opt for VM shutdown on key revocation." ], - "description": "Creates a new policy in the specified project and region using the data included in the request." + "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" - } + "labels": { + "additionalProperties": { + "type": "string" }, - "parameterOrder": [ - "project", - "region", - "sslPolicy" - ], - "response": { - "$ref": "Operation" + "description": "Labels to apply to instances that are created from this machine image.", + "type": "object" + }, + "machineType": { + "description": "The machine type to use for instances that are created from this machine\nimage.", + "type": "string" + }, + "metadata": { + "$ref": "Metadata", + "description": "The metadata key/value pairs to assign to instances that are created from\nthis machine image. These pairs can consist of custom metadata or\npredefined keys. SeeProject and\ninstance metadata for more information." + }, + "minCpuPlatform": { + "description": "Minimum cpu/platform to be used by instances created from this machine\nimage. The instance may be scheduled on the specified or newer\ncpu/platform. Applicable values are the friendly names of CPU platforms,\nsuch as minCpuPlatform: \"Intel Haswell\" orminCpuPlatform: \"Intel Sandy Bridge\". For more\ninformation, read Specifying a\nMinimum CPU Platform.", + "type": "string" + }, + "networkInterfaces": { + "description": "An array of network access configurations for this interface.", + "items": { + "$ref": "NetworkInterface" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "type": "array" + }, + "postKeyRevocationActionType": { + "description": "PostKeyRevocationActionType of the instance.", + "enum": [ + "NOOP", + "POST_KEY_REVOCATION_ACTION_TYPE_UNSPECIFIED", + "SHUTDOWN" + ], + "enumDescriptions": [ + "Indicates user chose no operation.", + "Default value. This value is unused.", + "Indicates user chose to opt for VM shutdown on key revocation." ], - "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." + "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" - } + "scheduling": { + "$ref": "Scheduling", + "description": "Specifies the scheduling options for the instances that are created from\nthis machine image." + }, + "serviceAccounts": { + "description": "A list of service accounts with specified scopes. Access tokens for these\nservice accounts are available to the instances that are created from this\nmachine image. Use metadata queries to obtain the access tokens for these\ninstances.", + "items": { + "$ref": "ServiceAccount" }, - "parameterOrder": [ - "project", - "region", - "sslPolicy" + "type": "array" + }, + "tags": { + "$ref": "Tags", + "description": "A list of tags to apply to the instances that are created from this machine\nimage. The tags identify valid sources or targets for network firewalls.\nThe setTags method can modify this list of tags. Each tag within the list\nmust comply withRFC1035." + } + }, + "type": "object" + }, + "SslCertificate": { + "description": "Represents an SSL certificate resource.\n\nGoogle Compute Engine has two SSL certificate resources:\n\n* [Global](/compute/docs/reference/rest/v1/sslCertificates)\n* [Regional](/compute/docs/reference/rest/v1/regionSslCertificates)\n\n\nThe global SSL certificates (sslCertificates) are used by:\n \n - Global external Application Load Balancers\n - Classic Application Load Balancers\n - Proxy Network Load Balancers (with target SSL proxies)\n\n\n\nThe regional SSL certificates (regionSslCertificates) are used\nby:\n \n - Regional external Application Load Balancers\n - Regional internal Application Load Balancers\n\n\n\nOptionally, certificate file contents that you upload can contain a set of up\nto five PEM-encoded certificates.\nThe API call creates an object (sslCertificate) that holds this data.\nYou can use SSL keys and certificates to secure connections to a load\nbalancer.\nFor more information, read \nCreating and using SSL certificates,SSL certificates\nquotas and limits, and\nTroubleshooting SSL certificates.", + "id": "SslCertificate", + "properties": { + "certificate": { + "description": "A value read into memory from a certificate file. The certificate file must\nbe in PEM format. The certificate chain must be no greater than 5 certs\nlong. The chain must include at least one intermediate cert.", + "type": "string" + }, + "creationTimestamp": { + "description": "[Output Only] Creation timestamp inRFC3339\ntext format.", + "type": "string" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you\ncreate the resource.", + "type": "string" + }, + "expireTime": { + "description": "Output only. [Output Only] Expire time of the certificate. RFC3339", + "readOnly": true, + "type": "string" + }, + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "format": "uint64", + "type": "string" + }, + "kind": { + "default": "compute#sslCertificate", + "description": "Output only. [Output Only] Type of the resource. Alwayscompute#sslCertificate for SSL certificates.", + "readOnly": true, + "type": "string" + }, + "managed": { + "$ref": "SslCertificateManagedSslCertificate", + "description": "Configuration and status of a managed SSL certificate." + }, + "name": { + "description": "Name of the resource. Provided by the client when the resource is created.\nThe name must be 1-63 characters long, and comply withRFC1035.\nSpecifically, the name must be 1-63 characters long and match the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first\ncharacter must be a lowercase letter, and all following characters must\nbe a dash, lowercase letter, or digit, except the last character, which\ncannot be a dash.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "privateKey": { + "description": "A value read into memory from a write-only private key file. The private\nkey file must be in PEM format. For security, only insert\nrequests include this field.", + "type": "string" + }, + "region": { + "description": "Output only. [Output Only] URL of the region where the regional SSL Certificate\nresides. This field is not applicable to global SSL Certificate.", + "readOnly": true, + "type": "string" + }, + "selfLink": { + "description": "[Output only] Server-defined URL for the resource.", + "type": "string" + }, + "selfManaged": { + "$ref": "SslCertificateSelfManagedSslCertificate", + "description": "Configuration and status of a self-managed SSL certificate." + }, + "subjectAlternativeNames": { + "description": "Output only. [Output Only] Domains associated with the certificate via Subject\nAlternative Name.", + "items": { + "type": "string" + }, + "readOnly": true, + "type": "array" + }, + "type": { + "description": "(Optional) Specifies the type of SSL certificate, either \"SELF_MANAGED\" or\n\"MANAGED\". If not specified, the certificate is self-managed and the fieldscertificate and private_key are used.", + "enum": [ + "MANAGED", + "SELF_MANAGED", + "TYPE_UNSPECIFIED" ], - "request": { - "$ref": "SslPolicy" + "enumDescriptions": [ + "Google-managed SSLCertificate.", + "Certificate uploaded by user.", + "" + ], + "type": "string" + } + }, + "type": "object" + }, + "SslCertificateAggregatedList": { + "id": "SslCertificateAggregatedList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "additionalProperties": { + "$ref": "SslCertificatesScopedList", + "description": "Name of the scope containing this set of SslCertificates." }, - "response": { - "$ref": "Operation" + "description": "A list of SslCertificatesScopedList resources.", + "type": "object" + }, + "kind": { + "default": "compute#sslCertificateAggregatedList", + "description": "Output only. [Output Only] Type of resource. Alwayscompute#sslCertificateAggregatedList for lists of SSL\nCertificates.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "unreachables": { + "description": "Output only. [Output Only] Unreachable resources.", + "items": { + "type": "string" }, - "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." + "readOnly": true, + "type": "array" }, - "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", + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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" } }, - "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." + "type": "object" } - } + }, + "type": "object" }, - "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" + "SslCertificateList": { + "description": "Contains a list of SslCertificate resources.", + "id": "SslCertificateList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of SslCertificate resources.", + "items": { + "$ref": "SslCertificate" }, - "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." + "type": "array" }, - "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", + "kind": { + "default": "compute#sslCertificateList", + "description": "Output only. Type of resource.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "pageToken": { - "description": "Specifies a page token 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{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" } }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "StoragePoolTypeAggregatedList" + "type": "object" + } + }, + "type": "object" + }, + "SslCertificateManagedSslCertificate": { + "description": "Configuration and status of a managed SSL certificate.", + "id": "SslCertificateManagedSslCertificate", + "properties": { + "domainStatus": { + "additionalProperties": { + "enum": [ + "ACTIVE", + "DOMAIN_STATUS_UNSPECIFIED", + "FAILED_CAA_CHECKING", + "FAILED_CAA_FORBIDDEN", + "FAILED_NOT_VISIBLE", + "FAILED_RATE_LIMITED", + "PROVISIONING" + ], + "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\ndomain.", + "There seems to be problem with the user's DNS or load balancer\nconfiguration for this domain.", + "Reached rate-limit for certificates per top-level private domain.", + "Certificate provisioning for this domain is under way. GCP will\nattempt to provision the first certificate." + ], + "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 an aggregated list of storage pool types. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." + "description": "Output only. [Output only] Detailed statuses of the domains specified for managed\ncertificate resource.", + "readOnly": true, + "type": "object" }, - "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" - }, - "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" - }, - "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" - } + "domains": { + "description": "The domains for which a managed SSL certificate will be generated. Each\nGoogle-managed SSL certificate supports up to the [maximum number of\ndomains per Google-managed SSL\ncertificate](/load-balancing/docs/quotas#ssl_certificates).", + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "zone", - "storagePoolType" + "type": "array" + }, + "status": { + "description": "Output only. [Output only] Status of the managed certificate resource.", + "enum": [ + "ACTIVE", + "MANAGED_CERTIFICATE_STATUS_UNSPECIFIED", + "PROVISIONING", + "PROVISIONING_FAILED", + "PROVISIONING_FAILED_PERMANENTLY", + "RENEWAL_FAILED" ], - "response": { - "$ref": "StoragePoolType" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "The certificate management is working, and a certificate has been\nprovisioned.", + "", + "The certificate management is working. GCP will attempt to provision\nthe first certificate.", + "Certificate provisioning failed due to an issue with the DNS\nor load balancing configuration.\nFor details of which domain failed, consult domain_status field.", + "Certificate provisioning failed due to an issue with the DNS\nor load balancing configuration. It won't be retried. To try again\ndelete and create a new managed SslCertificate resource.\nFor details of which domain failed, consult domain_status field.", + "Renewal of the certificate has failed due to an issue with the DNS\nor load balancing configuration. The existing cert is still serving;\nhowever, it will expire shortly. To provision a renewed certificate,\ndelete and create a new managed SslCertificate resource.\nFor details on which domain failed, consult domain_status field." ], - "description": "Returns the specified storage pool type." + "readOnly": true, + "type": "string" } - } + }, + "type": "object" }, - "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, + "SslCertificateSelfManagedSslCertificate": { + "description": "Configuration and status of a self-managed SSL certificate.", + "id": "SslCertificateSelfManagedSslCertificate", + "properties": { + "certificate": { + "description": "A local certificate file. The certificate must be in\nPEM format. The certificate chain must be no greater than 5 certs\nlong. The chain must include at least one intermediate cert.", + "type": "string" + }, + "privateKey": { + "description": "A write-only private key in PEM format. Only insert\nrequests will include this field.", + "type": "string" + } + }, + "type": "object" + }, + "SslCertificatesScopedList": { + "id": "SslCertificatesScopedList", + "properties": { + "sslCertificates": { + "description": "List of SslCertificates contained in this scope.", + "items": { + "$ref": "SslCertificate" + }, + "type": "array" + }, + "warning": { + "description": "Informational warning which replaces the list of\nbackend services when the list is empty.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "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." + "type": "object" + } + }, + "type": "object" + }, + "SslPoliciesAggregatedList": { + "id": "SslPoliciesAggregatedList", + "properties": { + "etag": { + "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" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[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" - } + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "additionalProperties": { + "$ref": "SslPoliciesScopedList", + "description": "Name of the scope containing this set of SSL policies." }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "StoragePoolAggregatedList" + "description": "A list of SslPoliciesScopedList resources.", + "type": "object" + }, + "kind": { + "default": "compute#sslPoliciesAggregatedList", + "description": "Output only. [Output Only] Type of resource. Alwayscompute#sslPolicyAggregatedList for lists of SSL Policies.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "unreachables": { + "description": "Output only. [Output Only] Unreachable resources.", + "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 an aggregated list of storage pools. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." + "readOnly": true, + "type": "array" }, - "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, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project", - "zone", - "storagePool" - ], - "response": { - "$ref": "StoragePool" + "type": "object" + } + }, + "type": "object" + }, + "SslPoliciesList": { + "id": "SslPoliciesList", + "properties": { + "id": { + "description": "Output only. [Output Only] Unique identifier for the resource; defined by the server.", + "readOnly": true, + "type": "string" + }, + "items": { + "description": "Output only. A list of SslPolicy resources.", + "items": { + "$ref": "SslPolicy" }, - "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." + "readOnly": true, + "type": "array" }, - "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, + "kind": { + "default": "compute#sslPoliciesList", + "description": "Output only. [Output Only] Type of the resource. Alwayscompute#sslPoliciesList for lists of sslPolicies.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "Output only. [Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "readOnly": true, + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project", - "zone" - ], - "request": { - "$ref": "StoragePool" + "type": "object" + } + }, + "type": "object" + }, + "SslPoliciesListAvailableFeaturesResponse": { + "id": "SslPoliciesListAvailableFeaturesResponse", + "properties": { + "features": { + "items": { + "type": "string" }, - "response": { - "$ref": "Operation" + "type": "array" + } + }, + "type": "object" + }, + "SslPoliciesScopedList": { + "id": "SslPoliciesScopedList", + "properties": { + "sslPolicies": { + "description": "A list of SslPolicies contained in this scope.", + "items": { + "$ref": "SslPolicy" }, - "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." + "type": "array" }, - "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", + "warning": { + "description": "Informational warning which replaces the list of\nSSL policies when the list is empty.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "storagePool": { - "description": "Name of the storage pool to delete.", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project", - "zone", - "storagePool" - ], - "response": { - "$ref": "Operation" + "type": "object" + } + }, + "type": "object" + }, + "SslPolicy": { + "description": "Represents an SSL Policy resource.\n\nUse SSL policies to control SSL features, such as versions and cipher\nsuites, that are offered by Application Load Balancers and proxy Network Load\nBalancers. For more information, read \nSSL policies overview.", + "id": "SslPolicy", + "properties": { + "creationTimestamp": { + "description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", + "readOnly": true, + "type": "string" + }, + "customFeatures": { + "description": "A list of features enabled when the selected profile is CUSTOM. The\n method returns the set of features that can be\nspecified in this list. This field must be empty if the profile is notCUSTOM.", + "items": { + "type": "string" }, - "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." + "type": "array" }, - "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" - } + "description": { + "description": "An optional description of this resource. Provide this property when you\ncreate the resource.", + "type": "string" + }, + "enabledFeatures": { + "description": "Output only. [Output Only] The list of features enabled in the SSL policy.", + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "zone", - "resource" + "readOnly": true, + "type": "array" + }, + "fingerprint": { + "description": "Fingerprint of this resource. A hash of the contents stored in this object.\nThis field is used in optimistic locking. This field will be ignored when\ninserting a SslPolicy. An up-to-date fingerprint must be\nprovided in order to update the SslPolicy, otherwise the\nrequest will fail with error 412 conditionNotMet.\n\nTo see the latest fingerprint, make a get() request to\nretrieve an SslPolicy.", + "format": "byte", + "type": "string" + }, + "id": { + "description": "Output only. [Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "format": "uint64", + "readOnly": true, + "type": "string" + }, + "kind": { + "default": "compute#sslPolicy", + "description": "Output only. [Output only] Type of the resource. Alwayscompute#sslPolicyfor SSL policies.", + "readOnly": true, + "type": "string" + }, + "minTlsVersion": { + "description": "The minimum version of SSL protocol that can be used by the clients to\nestablish a connection with the load balancer. This can be one ofTLS_1_0, TLS_1_1, TLS_1_2,TLS_1_3. When set to TLS_1_3, the profile field\nmust be set to RESTRICTED.", + "enum": [ + "TLS_1_0", + "TLS_1_1", + "TLS_1_2", + "TLS_1_3" ], - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "TLS 1.0", + "TLS 1.1", + "TLS 1.2", + "TLS 1.3" ], - "description": "Gets the access control policy for a resource. May be empty if no such policy or resource exists." + "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" - }, - "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" + "name": { + "description": "Name of the resource. The name must be 1-63 characters long, and comply\nwith RFC1035. Specifically, the name must be 1-63 characters\nlong and match the regular expression\n`[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character\nmust be a lowercase letter, and all following characters must be a dash,\nlowercase letter, or digit, except the last character, which cannot be a\ndash.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "postQuantumKeyExchange": { + "description": "One of DEFAULT, ENABLED, orDEFERRED. Controls whether the load balancer negotiates\nX25519MLKEM768 key exchange when clients advertise support for it. When set\nto DEFAULT, or if no SSL Policy is attached to the target\nproxy, the load balancer disallows X25519MLKEM768 key exchange before\nOctober 2026, and allows it afterward. When set to ENABLED,\nthe load balancer allows X25519MLKEM768 key exchange. When set toDEFERRED, the load balancer disallows X25519MLKEM768 key\nexchange until October 2027, and allows it afterward.", + "enum": [ + "DEFAULT", + "DEFERRED", + "ENABLED" ], - "request": { - "$ref": "ZoneSetPolicyRequest" - }, - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "Default behavior: disabled until October 2026, enabled afterward.", + "Disabled until October 2027, enabled afterward.", + "Enabled now." ], - "description": "Sets the access control policy on the specified resource. Replaces any existing policy." + "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" + "profile": { + "description": "Profile specifies the set of SSL features that can be used by the load\nbalancer when negotiating SSL with clients. This can be one ofCOMPATIBLE, MODERN, RESTRICTED,FIPS_202205, or CUSTOM. If usingCUSTOM, the set of SSL features to enable must be specified in\nthe customFeatures field. If using FIPS_202205,\nthe min_tls_version field must be set to TLS_1_2.", + "enum": [ + "COMPATIBLE", + "CUSTOM", + "FIPS_202205", + "MODERN", + "RESTRICTED" + ], + "enumDescriptions": [ + "Compatible profile. Allows the broadset set of clients, even those which\nsupport only out-of-date SSL features to negotiate with the load\nbalancer.", + "Custom profile. Allow only the set of allowed SSL features specified in\nthe customFeatures field.", + "FIPS compatible profile. Supports a reduced set of SSL features,\nintended to meet FIPS 140-3 compliance requirements.", + "Modern profile. Supports a wide set of SSL features, allowing modern\nclients to negotiate SSL with the load balancer.", + "Restricted profile. Supports a reduced set of SSL features, intended to\nmeet stricter compliance requirements." + ], + "type": "string" + }, + "region": { + "description": "Output only. [Output Only] URL of the region where the regional SSL policy\nresides. This field is not applicable to global SSL policies.", + "readOnly": true, + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for the resource.", + "readOnly": true, + "type": "string" + }, + "warnings": { + "description": "Output only. [Output Only] If potential misconfigurations are detected for this\nSSL policy, this field will be populated with warning messages.", + "items": { + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "type": "string" + }, + "data": { + "description": "[Output Only] Metadata about this warning in key:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" + }, + "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" - } + "type": "object" }, - "parameterOrder": [ - "project", - "zone", - "resource" - ], - "request": { - "$ref": "TestPermissionsRequest" + "readOnly": true, + "type": "array" + } + }, + "type": "object" + }, + "SslPolicyReference": { + "id": "SslPolicyReference", + "properties": { + "sslPolicy": { + "type": "string" + } + }, + "type": "object" + }, + "StatefulPolicy": { + "id": "StatefulPolicy", + "properties": { + "preservedState": { + "$ref": "StatefulPolicyPreservedState" + } + }, + "type": "object" + }, + "StatefulPolicyPreservedState": { + "description": "Configuration of preserved resources.", + "id": "StatefulPolicyPreservedState", + "properties": { + "disks": { + "additionalProperties": { + "$ref": "StatefulPolicyPreservedStateDiskDevice" }, - "response": { - "$ref": "TestPermissionsResponse" + "description": "Disks created on the instances that will be preserved on instance\ndelete, update, etc. This map is keyed with the device names of\nthe disks.", + "type": "object" + }, + "externalIPs": { + "additionalProperties": { + "$ref": "StatefulPolicyPreservedStateNetworkIp" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "description": "External network IPs assigned to the instances that will be preserved on\ninstance delete, update, etc. This map is keyed with the network\ninterface name.", + "type": "object" + }, + "internalIPs": { + "additionalProperties": { + "$ref": "StatefulPolicyPreservedStateNetworkIp" + }, + "description": "Internal network IPs assigned to the instances that will be preserved on\ninstance delete, update, etc. This map is keyed with the network\ninterface name.", + "type": "object" + } + }, + "type": "object" + }, + "StatefulPolicyPreservedStateDiskDevice": { + "id": "StatefulPolicyPreservedStateDiskDevice", + "properties": { + "autoDelete": { + "description": "These stateful disks will never be deleted during autohealing,\nupdate or VM instance recreate operations.\nThis flag is used to configure if the disk should be deleted after it\nis no longer used by the group, e.g. when the given instance or\nthe whole group is deleted. Note: disks attached inREAD_ONLY mode cannot be auto-deleted.", + "enum": [ + "NEVER", + "ON_PERMANENT_INSTANCE_DELETION" + ], + "enumDescriptions": [ + "", + "" + ], + "type": "string" + } + }, + "type": "object" + }, + "StatefulPolicyPreservedStateNetworkIp": { + "id": "StatefulPolicyPreservedStateNetworkIp", + "properties": { + "autoDelete": { + "description": "These stateful IPs will never be released during autohealing,\nupdate or VM instance recreate operations.\nThis flag is used to configure if the IP reservation should be deleted\nafter it is no longer used by the group, e.g. when the given instance\nor the whole group is deleted.", + "enum": [ + "NEVER", + "ON_PERMANENT_INSTANCE_DELETION" + ], + "enumDescriptions": [ + "", + "" ], - "description": "Returns permissions that a caller has on the specified resource." + "type": "string" + } + }, + "type": "object" + }, + "Status": { + "description": "The `Status` type defines a logical error model that is suitable for\ndifferent programming environments, including REST APIs and RPC APIs. It is\nused by [gRPC](https://github.com/grpc). Each `Status` message contains\nthree pieces of data: error code, error message, and error details.\n\nYou can find out more about this error model and how to work with it in the\n[API Design Guide](https://cloud.google.com/apis/design/errors).", + "id": "Status", + "properties": { + "code": { + "description": "The status code, which should be an enum value of google.rpc.Code.", + "format": "int32", + "type": "integer" }, - "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" + "details": { + "description": "A list of messages that carry the error details. There is a common set of\nmessage types for APIs to use.", + "items": { + "additionalProperties": { + "description": "Properties of the object. Contains field @type with type URL.", + "type": "any" }, - "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" - } + "format": "google.protobuf.Any", + "type": "object" }, - "parameterOrder": [ - "project", - "zone", - "storagePool" + "type": "array" + }, + "message": { + "description": "A developer-facing error message, which should be in English. Any\nuser-facing error message should be localized and sent in the\ngoogle.rpc.Status.details field, or localized by the client.", + "type": "string" + } + }, + "type": "object" + }, + "StoragePool": { + "description": "Represents a zonal storage pool resource.", + "id": "StoragePool", + "properties": { + "capacityProvisioningType": { + "description": "Provisioning type of the byte capacity of the pool.", + "enum": [ + "ADVANCED", + "STANDARD", + "UNSPECIFIED" ], - "request": { - "$ref": "StoragePool" + "enumDescriptions": [ + "Advanced provisioning \"thinly\" allocates the related resource.", + "Standard provisioning allocates the related resource for the pool\ndisks' exclusive use.", + "" + ], + "type": "string" + }, + "creationTimestamp": { + "description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you\ncreate the resource.", + "type": "string" + }, + "exapoolProvisionedCapacityGb": { + "$ref": "StoragePoolExapoolProvisionedCapacityGb", + "description": "Provisioned capacities for each SKU for this Exapool in GiB" + }, + "id": { + "description": "Output only. [Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "format": "uint64", + "readOnly": true, + "type": "string" + }, + "kind": { + "default": "compute#storagePool", + "description": "Output only. [Output Only] Type of the resource. Always compute#storagePool\nfor storage pools.", + "readOnly": true, + "type": "string" + }, + "labelFingerprint": { + "description": "A fingerprint for the labels being applied to this storage pool, which is\nessentially a hash of the labels set used for optimistic locking. The\nfingerprint is initially generated by Compute Engine and changes after\nevery request to modify or update labels. You must always provide an\nup-to-date fingerprint hash in order to update or change labels,\notherwise the request will fail with error412 conditionNotMet.\n\nTo see the latest fingerprint, make a get() request to\nretrieve a storage pool.", + "format": "byte", + "type": "string" + }, + "labels": { + "additionalProperties": { + "type": "string" }, - "response": { - "$ref": "Operation" + "description": "Labels to apply to this storage pool. These can be later modified by\nthe setLabels method.", + "type": "object" + }, + "name": { + "annotations": { + "required": [ + "compute.storagePools.insert" + ] }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "description": "Name of the resource. Provided by the client when the resource is created.\nThe name must be 1-63 characters long, and comply withRFC1035.\nSpecifically, the name must be 1-63 characters long and match the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?`\nwhich means the first character must be a lowercase letter, and all\nfollowing characters must be a dash, lowercase letter, or digit, except\nthe last character, which cannot be a dash.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "params": { + "$ref": "StoragePoolParams", + "description": "Input only. Additional params passed with the request, but not persisted\nas part of resource payload." + }, + "performanceProvisioningType": { + "description": "Provisioning type of the performance-related parameters of the pool,\nsuch as throughput and IOPS.", + "enum": [ + "ADVANCED", + "STANDARD", + "UNSPECIFIED" + ], + "enumDescriptions": [ + "Advanced provisioning \"thinly\" allocates the related resource.", + "Standard provisioning allocates the related resource for the pool\ndisks' 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." + "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" - }, - "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" - } + "poolProvisionedCapacityGb": { + "annotations": { + "required": [ + "compute.storagePools.insert" + ] }, - "parameterOrder": [ - "project", - "zone", - "storagePool" + "description": "Size of the storage pool in GiB. For more information about the size\nlimits, see https://cloud.google.com/compute/docs/disks/storage-pools.", + "format": "int64", + "type": "string" + }, + "poolProvisionedIops": { + "description": "Provisioned IOPS of the storage pool. Only relevant if the storage pool\ntype is hyperdisk-balanced.", + "format": "int64", + "type": "string" + }, + "poolProvisionedThroughput": { + "description": "Provisioned throughput of the storage pool in MiB/s. Only relevant if the\nstorage pool type is hyperdisk-balanced or hyperdisk-throughput.", + "format": "int64", + "type": "string" + }, + "resourceStatus": { + "$ref": "StoragePoolResourceStatus", + "description": "Output only. [Output Only] Status information for the storage pool resource.", + "readOnly": true + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined fully-qualified URL for this resource.", + "readOnly": true, + "type": "string" + }, + "selfLinkWithId": { + "description": "Output only. [Output Only] Server-defined URL for this resource's resource id.", + "readOnly": true, + "type": "string" + }, + "shareSettings": { + "$ref": "StoragePoolShareSettings", + "description": "Share settings for the storage pool." + }, + "state": { + "description": "Output only. [Output Only] The status of storage pool creation.\n \n \n - CREATING: Storage pool is provisioning.\n storagePool.\n - FAILED: Storage pool creation failed.\n - READY: Storage pool is ready for use.\n - DELETING: Storage pool is deleting.", + "enum": [ + "CREATING", + "DELETING", + "FAILED", + "READY" ], - "response": { - "$ref": "StoragePoolListDisks" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "StoragePool is provisioning", + "StoragePool is deleting.", + "StoragePool creation failed.", + "StoragePool is ready for use." ], - "description": "Lists the disks in a specified storage pool." + "readOnly": true, + "type": "string" + }, + "status": { + "$ref": "StoragePoolResourceStatus", + "description": "Output only. [Output Only] Status information for the storage pool resource.", + "readOnly": true + }, + "storagePoolType": { + "description": "Type of the storage pool.", + "type": "string" + }, + "zone": { + "description": "Output only. [Output Only] URL of the zone where the storage pool resides.\nYou must specify this field as part of the HTTP request URL. It is\nnot settable as a field in the request body.", + "readOnly": true, + "type": "string" } - } + }, + "type": "object" }, - "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" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[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" - } + "StoragePoolAggregatedList": { + "id": "StoragePoolAggregatedList", + "properties": { + "etag": { + "type": "string" + }, + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "additionalProperties": { + "$ref": "StoragePoolsScopedList", + "description": "[Output Only] Name of the scope containing this set of storage pool." }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "TargetGrpcProxyList" + "description": "A list of StoragePoolsScopedList resources.", + "type": "object" + }, + "kind": { + "default": "compute#storagePoolAggregatedList", + "description": "Output only. [Output Only] Type of resource. Alwayscompute#storagePoolAggregatedList for aggregated lists of\nstorage pools.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "unreachables": { + "description": "Output only. [Output Only] Unreachable resources.", + "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": "Lists the TargetGrpcProxies for a project in the given scope." + "readOnly": true, + "type": "array" }, - "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, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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, + "data": { + "description": "[Output Only] Metadata about this warning in key:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" + }, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project", - "targetGrpcProxy" - ], - "response": { - "$ref": "TargetGrpcProxy" + "type": "object" + } + }, + "type": "object" + }, + "StoragePoolDisk": { + "id": "StoragePoolDisk", + "properties": { + "attachedInstances": { + "description": "Output only. [Output Only] Instances this disk is attached to.", + "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": "Returns the specified TargetGrpcProxy resource in the given scope." + "readOnly": true, + "type": "array" }, - "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" - } + "creationTimestamp": { + "description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", + "readOnly": true, + "type": "string" + }, + "disk": { + "description": "Output only. [Output Only] The URL of the disk.", + "readOnly": true, + "type": "string" + }, + "name": { + "description": "Output only. [Output Only] The name of the disk.", + "readOnly": true, + "type": "string" + }, + "provisionedIops": { + "description": "Output only. [Output Only] The number of IOPS provisioned for the disk.", + "format": "int64", + "readOnly": true, + "type": "string" + }, + "provisionedThroughput": { + "description": "Output only. [Output Only] The throughput provisioned for the disk.", + "format": "int64", + "readOnly": true, + "type": "string" + }, + "resourcePolicies": { + "description": "Output only. [Output Only] Resource policies applied to disk for automatic snapshot\ncreations.", + "items": { + "type": "string" }, - "parameterOrder": [ - "project" + "readOnly": true, + "type": "array" + }, + "sizeGb": { + "description": "Output only. [Output Only] The disk size, in GB.", + "format": "int64", + "readOnly": true, + "type": "string" + }, + "status": { + "description": "Output only. [Output Only] The disk status.", + "enum": [ + "CREATING", + "DELETING", + "FAILED", + "READY", + "RESTORING", + "UNAVAILABLE" ], - "request": { - "$ref": "TargetGrpcProxy" + "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\ndetached." + ], + "readOnly": true, + "type": "string" + }, + "type": { + "description": "Output only. [Output Only] The disk type.", + "readOnly": true, + "type": "string" + }, + "usedBytes": { + "description": "Output only. [Output Only] Amount of disk space used.", + "format": "int64", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "StoragePoolExapoolProvisionedCapacityGb": { + "description": "Exapool provisioned capacities for each SKU type", + "id": "StoragePoolExapoolProvisionedCapacityGb", + "properties": { + "capacityOptimized": { + "description": "Size, in GiB, of provisioned capacity-optimized capacity for this Exapool", + "format": "int64", + "type": "string" + }, + "readOptimized": { + "description": "Size, in GiB, of provisioned read-optimized capacity for this Exapool", + "format": "int64", + "type": "string" + }, + "writeOptimized": { + "description": "Size, in GiB, of provisioned write-optimized capacity for this Exapool", + "format": "int64", + "type": "string" + } + }, + "type": "object" + }, + "StoragePoolList": { + "description": "A list of StoragePool resources.", + "id": "StoragePoolList", + "properties": { + "etag": { + "type": "string" + }, + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of StoragePool resources.", + "items": { + "$ref": "StoragePool" }, - "response": { - "$ref": "Operation" + "type": "array" + }, + "kind": { + "default": "compute#storagePoolList", + "description": "Output only. [Output Only] Type of resource. Always compute#storagePoolList\nfor lists of storagePools.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "unreachables": { + "description": "Output only. [Output Only] Unreachable resources.\nend_interface: MixerListResponseWithEtagBuilder", + "items": { + "type": "string" }, - "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." + "readOnly": true, + "type": "array" }, - "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, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project", - "targetGrpcProxy" - ], - "response": { - "$ref": "Operation" + "type": "object" + } + }, + "type": "object" + }, + "StoragePoolListDisks": { + "id": "StoragePoolListDisks", + "properties": { + "etag": { + "type": "string" + }, + "id": { + "description": "Output only. [Output Only] Unique identifier for the resource; defined by the server.", + "readOnly": true, + "type": "string" + }, + "items": { + "description": "A list of StoragePoolDisk resources.", + "items": { + "$ref": "StoragePoolDisk" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified TargetGrpcProxy in the given scope" + "type": "array" }, - "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, + "kind": { + "default": "compute#storagePoolListDisks", + "description": "Output only. [Output Only] Type of resource. Alwayscompute#storagePoolListDisks for lists of disks in a\nstoragePool.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "Output only. [Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "readOnly": true, + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "unreachables": { + "description": "Output only. [Output Only] Unreachable resources.\nend_interface: MixerListResponseWithEtagBuilder", + "items": { + "type": "string" + }, + "readOnly": true, + "type": "array" + }, + "warning": { + "description": "Output only. [Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project", - "targetGrpcProxy" - ], - "request": { - "$ref": "TargetGrpcProxy" + "readOnly": true, + "type": "object" + } + }, + "type": "object" + }, + "StoragePoolParams": { + "description": "Additional storage pool params.", + "id": "StoragePoolParams", + "properties": { + "resourceManagerTags": { + "additionalProperties": { + "type": "string" }, - "response": { - "$ref": "Operation" + "description": "Input only. Resource manager tags to be bound to the storage pool. Tag keys and values\nhave the same definition as resource\nmanager tags. Keys and values can be either in numeric format,\nsuch as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in\nnamespaced format such as `{org_id|project_id}/{tag_key_short_name}` and\n`{tag_value_short_name}`. The field is ignored (both PUT &\nPATCH) when empty.", + "type": "object" + } + }, + "type": "object" + }, + "StoragePoolResourceStatus": { + "description": "[Output Only] Contains output only fields.", + "id": "StoragePoolResourceStatus", + "properties": { + "diskCount": { + "description": "[Output Only] Number of disks used.", + "format": "int64", + "type": "string" + }, + "exapoolMaxReadIops": { + "description": "Output only. [Output Only] Maximum allowed read IOPS for this Exapool.", + "format": "int64", + "readOnly": true, + "type": "string" + }, + "exapoolMaxReadThroughput": { + "description": "Output only. [Output Only] Maximum allowed read throughput in MiB/s for\nthis Exapool.", + "format": "int64", + "readOnly": true, + "type": "string" + }, + "exapoolMaxWriteIops": { + "description": "Output only. [Output Only] Maximum allowed write IOPS for this Exapool.", + "format": "int64", + "readOnly": true, + "type": "string" + }, + "exapoolMaxWriteThroughput": { + "description": "Output only. [Output Only] Maximum allowed write throughput in MiB/s\nfor this Exapool.", + "format": "int64", + "readOnly": true, + "type": "string" + }, + "lastResizeTimestamp": { + "description": "Output only. [Output Only] Timestamp of the last successful resize inRFC3339 text format.", + "readOnly": true, + "type": "string" + }, + "maxTotalProvisionedDiskCapacityGb": { + "description": "[Output Only] Maximum allowed aggregate disk size in GiB.", + "format": "int64", + "type": "string" + }, + "poolUsedCapacityBytes": { + "description": "[Output Only] Space used by data stored in disks within the storage pool\n(in bytes). This will reflect the total number of bytes written to the\ndisks in the pool, in contrast to the capacity of those disks.", + "format": "int64", + "type": "string" + }, + "poolUsedIops": { + "description": "[Output Only] Sum of all the disks' provisioned IOPS, minus some amount\nthat is allowed per disk that is not counted towards pool's IOPS\ncapacity. For more information, see\nhttps://cloud.google.com/compute/docs/disks/storage-pools.", + "format": "int64", + "type": "string" + }, + "poolUsedThroughput": { + "description": "[Output Only] Sum of all the disks' provisioned throughput in MiB/s.", + "format": "int64", + "type": "string" + }, + "poolUserWrittenBytes": { + "description": "[Output Only] Amount of data written into the pool, before it is\ncompacted.", + "format": "int64", + "type": "string" + }, + "totalProvisionedDiskCapacityGb": { + "description": "[Output Only] Sum of all the disks' provisioned capacity (in GiB) in\nthis storage pool. A disk's provisioned capacity is the same as its total\ncapacity.", + "format": "int64", + "type": "string" + }, + "totalProvisionedDiskIops": { + "description": "[Output Only] Sum of all the disks' provisioned IOPS.", + "format": "int64", + "type": "string" + }, + "totalProvisionedDiskThroughput": { + "description": "[Output Only] Sum of all the disks' provisioned throughput in MiB/s,\nminus some amount that is allowed per disk that is not counted towards\npool's throughput capacity.", + "format": "int64", + "type": "string" + } + }, + "type": "object" + }, + "StoragePoolShareSettings": { + "description": "Share settings for the storage pool.", + "id": "StoragePoolShareSettings", + "properties": { + "projectMap": { + "additionalProperties": { + "$ref": "StoragePoolShareSettingsProjectConfig" }, - "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": "A map of project id and project config.", + "type": "object" } - } + }, + "type": "object" }, - "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" - } + "StoragePoolShareSettingsProjectConfig": { + "description": "Config for each project in the share settings.", + "id": "StoragePoolShareSettingsProjectConfig", + "properties": { + "projectId": { + "description": "The project ID, should be same as the key of this project config in the\nparent map.", + "type": "string" + } + }, + "type": "object" + }, + "StoragePoolType": { + "id": "StoragePoolType", + "properties": { + "creationTimestamp": { + "description": "[Output Only] Creation timestamp inRFC3339\ntext format.", + "type": "string" + }, + "deprecated": { + "$ref": "DeprecationStatus", + "description": "[Output Only] The deprecation status associated with this storage pool\ntype." + }, + "description": { + "description": "[Output Only] An optional description of this resource.", + "type": "string" + }, + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "format": "uint64", + "type": "string" + }, + "kind": { + "default": "compute#storagePoolType", + "description": "Output only. [Output Only] Type of the resource. Alwayscompute#storagePoolType for storage pool types.", + "readOnly": true, + "type": "string" + }, + "maxPoolProvisionedCapacityGb": { + "description": "[Output Only] Maximum storage pool size in GB.", + "format": "int64", + "type": "string" + }, + "maxPoolProvisionedIops": { + "description": "[Output Only] Maximum provisioned IOPS.", + "format": "int64", + "type": "string" + }, + "maxPoolProvisionedThroughput": { + "description": "[Output Only] Maximum provisioned throughput.", + "format": "int64", + "type": "string" + }, + "minPoolProvisionedCapacityGb": { + "description": "[Output Only] Minimum storage pool size in GB.", + "format": "int64", + "type": "string" + }, + "minPoolProvisionedIops": { + "description": "[Output Only] Minimum provisioned IOPS.", + "format": "int64", + "type": "string" + }, + "minPoolProvisionedThroughput": { + "description": "[Output Only] Minimum provisioned throughput.", + "format": "int64", + "type": "string" + }, + "minSizeGb": { + "description": "[Deprecated] This field is deprecated. Use minPoolProvisionedCapacityGb\ninstead.", + "format": "int64", + "type": "string" + }, + "name": { + "description": "[Output Only] Name of the resource.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" + }, + "selfLinkWithId": { + "description": "Output only. [Output Only] Server-defined URL for this resource with the resource id.", + "readOnly": true, + "type": "string" + }, + "supportedDiskTypes": { + "description": "[Output Only] The list of disk types supported in this storage pool type.", + "items": { + "type": "string" }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "TargetHttpProxyList" + "type": "array" + }, + "zone": { + "description": "[Output Only] URL of the zone where the storage pool type resides.\nYou must specify this field as part of the HTTP request URL. It is\nnot settable as a field in the request body.", + "type": "string" + } + }, + "type": "object" + }, + "StoragePoolTypeAggregatedList": { + "id": "StoragePoolTypeAggregatedList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "additionalProperties": { + "$ref": "StoragePoolTypesScopedList", + "description": "[Output Only] Name of the scope containing this set of storage pool types." }, - "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." + "description": "A list of StoragePoolTypesScopedList resources.", + "type": "object" }, - "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, + "kind": { + "default": "compute#storagePoolTypeAggregatedList", + "description": "Output only. [Output Only] Type of resource. Alwayscompute#storagePoolTypeAggregatedList.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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." - }, - "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" + "data": { + "description": "[Output Only] Metadata about this warning in key:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. 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" } }, - "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." + "type": "object" + } + }, + "type": "object" + }, + "StoragePoolTypeList": { + "description": "Contains a list of storage pool types.", + "id": "StoragePoolTypeList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "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" + "items": { + "description": "A list of StoragePoolType resources.", + "items": { + "$ref": "StoragePoolType" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified TargetHttpProxy resource." + "type": "array" }, - "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, + "kind": { + "default": "compute#storagePoolTypeList", + "description": "Output only. [Output Only] Type of resource. Alwayscompute#storagePoolTypeList for storage pool types.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project", - "targetHttpProxy" - ], - "request": { - "$ref": "TargetHttpProxy" - }, - "response": { - "$ref": "Operation" + "type": "object" + } + }, + "type": "object" + }, + "StoragePoolTypesScopedList": { + "id": "StoragePoolTypesScopedList", + "properties": { + "storagePoolTypes": { + "description": "[Output Only] A list of storage pool types contained in this scope.", + "items": { + "$ref": "StoragePoolType" }, - "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." + "type": "array" }, - "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, + "warning": { + "description": "[Output Only] Informational warning which replaces the list of storage pool\ntypes when the list is empty.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project", - "targetHttpProxy" - ], - "request": { - "$ref": "UrlMapReference" - }, - "response": { - "$ref": "Operation" + "type": "object" + } + }, + "type": "object" + }, + "StoragePoolsScopedList": { + "id": "StoragePoolsScopedList", + "properties": { + "storagePools": { + "description": "[Output Only] A list of storage pool contained in this scope.", + "items": { + "$ref": "StoragePool" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Changes the URL map for TargetHttpProxy." + "type": "array" }, - "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, + "warning": { + "description": "[Output Only] Informational warning which replaces the list of storage pool\nwhen the list is empty.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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" + "message": { + "description": "[Output Only] A human-readable description of the warning code.", + "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`." + "type": "object" } - } + }, + "type": "object" }, - "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" + "Subnetwork": { + "description": "Represents a Subnetwork resource.\n\nA subnetwork (also known as a subnet) is a logical partition of a Virtual\nPrivate Cloud network with one primary IP range and zero or more secondary\nIP ranges. For more information, read\nVirtual Private Cloud (VPC) Network.", + "id": "Subnetwork", + "properties": { + "allowSubnetCidrRoutesOverlap": { + "description": "Whether this subnetwork's ranges can conflict with existing custom routes.\nSetting this to true allows this subnetwork's primary and secondary ranges\nto overlap with (and contain) custom routes that have already been\nconfigured on the corresponding network.\n\nFor example if a static route has range 10.1.0.0/16, a subnet\nrange 10.0.0.0/8 could only be created if allow_conflicting_routes=true.\n\nOverlapping is only allowed on subnetwork operations; routes\nwhose ranges conflict with this subnetwork's ranges won't be allowed unless\nroute.allow_conflicting_subnetworks is set to true.\n\nTypically packets destined to IPs within the subnetwork (which may contain\nprivate/sensitive data) are prevented from leaving the virtual network.\nSetting this field to true will disable this feature.\n\nThe default value is false and applies to all existing subnetworks and\nautomatically created subnetworks.", + "type": "boolean" + }, + "creationTimestamp": { + "description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you\ncreate the resource. This field can be set only at resource creation time.", + "type": "string" + }, + "enableFlowLogs": { + "description": "Whether to enable flow logging for this subnetwork. If this field is not\nexplicitly set, it will not appear in get listings. If not set\nthe default behavior is determined by the org policy, if there is no org\npolicy specified, then it will default to disabled. This field isn't\nsupported if the subnet purpose field is set toREGIONAL_MANAGED_PROXY. It is recommended to uselogConfig.enable field instead.", + "type": "boolean" + }, + "externalIpv6Prefix": { + "description": "The external IPv6 address range that is owned by this\nsubnetwork.", + "type": "string" + }, + "fingerprint": { + "description": "Fingerprint of this resource. A hash of the contents stored in this object.\nThis field is used in optimistic locking. This field will be ignored when\ninserting a Subnetwork. An up-to-date fingerprint must be\nprovided in order to update the Subnetwork, otherwise the\nrequest will fail with error 412 conditionNotMet.\n\nTo see the latest fingerprint, make a get() request to\nretrieve a Subnetwork.", + "format": "byte", + "type": "string" + }, + "gatewayAddress": { + "description": "Output only. [Output Only] The gateway address for default routes to reach destination\naddresses outside this subnetwork.", + "readOnly": true, + "type": "string" + }, + "id": { + "description": "Output only. [Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "format": "uint64", + "readOnly": true, + "type": "string" + }, + "internalIpv6Prefix": { + "description": "The internal IPv6 address range that is owned by this\nsubnetwork.", + "type": "string" + }, + "ipCidrRange": { + "description": "The range of internal addresses that are owned by this subnetwork.\nProvide this property when you create the subnetwork. For example,10.0.0.0/8 or 100.64.0.0/10. Ranges must\nbe unique and non-overlapping within a network. Only IPv4 is supported.\nThis field is set at resource creation time. The range can be any range\nlisted in theValid\nranges list. The range can be expanded after creation usingexpandIpCidrRange.", + "type": "string" + }, + "ipCollection": { + "description": "Reference to the source of IP, like a PublicDelegatedPrefix\n(PDP) for BYOIP. The PDP must be a sub-PDP in\nEXTERNAL_IPV6_SUBNETWORK_CREATION or INTERNAL_IPV6_SUBNETWORK_CREATION\nmode.\n\nUse one of the following formats to specify a sub-PDP when creating a dual\nstack or IPv6-only subnetwork with external access using BYOIP:\n \n - \n Full resource URL, as inhttps://www.googleapis.com/compute/v1/projects/projectId/regions/region/publicDelegatedPrefixes/sub-pdp-name\n - \n Partial URL, as in\n \n \n - projects/projectId/regions/region/publicDelegatedPrefixes/sub-pdp-name\n - regions/region/publicDelegatedPrefixes/sub-pdp-name", + "type": "string" + }, + "ipv6AccessType": { + "description": "The access type of IPv6 address this subnet holds. It's immutable and can\nonly be specified during creation or the first time the subnet is updated\ninto IPV4_IPV6 dual stack.", + "enum": [ + "EXTERNAL", + "INTERNAL" ], - "response": { - "$ref": "TargetHttpProxyList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "VMs on this subnet will be assigned IPv6 addresses that are accessible\nvia the Internet, as well as the VPC network.", + "VMs on this subnet will be assigned IPv6 addresses that are only\naccessible over the VPC network." ], - "description": "Retrieves the list of TargetHttpProxy resources available to the specified project in the specified region." + "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" + "ipv6CidrRange": { + "description": "Output only. [Output Only] This field is for internal use.", + "readOnly": true, + "type": "string" + }, + "ipv6GceEndpoint": { + "description": "Output only. [Output Only] Possible endpoints of this subnetwork. It can be one of the\nfollowing:\n \n - VM_ONLY: The subnetwork can be used for creating instances and\n IPv6 addresses with VM endpoint type. Such a subnetwork gets external IPv6\n ranges from a public delegated prefix and cannot be used to create NetLb.\n - VM_AND_FR: The subnetwork can be used for creating both VM\n instances and Forwarding Rules. It can also be used to reserve IPv6\n addresses with both VM and FR endpoint types. Such a subnetwork gets its\n IPv6 range from Google IP Pool directly.", + "enum": [ + "VM_AND_FR", + "VM_ONLY" ], - "response": { - "$ref": "TargetHttpProxy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "", + "" ], - "description": "Returns the specified TargetHttpProxy resource in the specified region." + "readOnly": true, + "type": "string" }, - "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" + "kind": { + "default": "compute#subnetwork", + "description": "Output only. [Output Only] Type of the resource. Always compute#subnetwork\nfor Subnetwork resources.", + "readOnly": true, + "type": "string" + }, + "logConfig": { + "$ref": "SubnetworkLogConfig", + "description": "This field denotes the VPC flow logging options for this subnetwork.\nIf logging is enabled, logs are exported to Cloud Logging." + }, + "name": { + "description": "The name of the resource, provided by the client when initially creating\nthe resource. The name must be 1-63 characters long, and comply withRFC1035.\nSpecifically, the name must be 1-63 characters long and match the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first\ncharacter must be a lowercase letter, and all following characters must\nbe a dash, lowercase letter, or digit, except the last character, which\ncannot be a dash.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "network": { + "description": "The URL of the network to which this subnetwork belongs, provided by the\nclient when initially creating the subnetwork. This field can be set only\nat resource creation time.", + "type": "string" + }, + "params": { + "$ref": "SubnetworkParams", + "description": "Input only. [Input Only] Additional params passed with the request, but not persisted\nas part of resource payload." + }, + "privateIpGoogleAccess": { + "description": "Whether the VMs in this subnet can access Google services without assigned\nexternal IP addresses. This field can be both set at resource creation\ntime and updated using setPrivateIpGoogleAccess.", + "type": "boolean" + }, + "privateIpv6GoogleAccess": { + "description": "This field is for internal use.\n\nThis field can be both set at resource creation time and updated usingpatch.", + "enum": [ + "DISABLE_GOOGLE_ACCESS", + "ENABLE_BIDIRECTIONAL_ACCESS_TO_GOOGLE", + "ENABLE_OUTBOUND_VM_ACCESS_TO_GOOGLE" ], - "request": { - "$ref": "TargetHttpProxy" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "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": "Creates a TargetHttpProxy resource in the specified project and region using the data included in the request." + "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" + "purpose": { + "enum": [ + "GLOBAL_MANAGED_PROXY", + "INTERNAL_HTTPS_LOAD_BALANCER", + "PEER_MIGRATION", + "PRIVATE", + "PRIVATE_NAT", + "PRIVATE_RFC_1918", + "PRIVATE_SERVICE_CONNECT", + "REGIONAL_MANAGED_PROXY" ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "Subnet reserved for Global Envoy-based Load Balancing.", + "Subnet reserved for Internal HTTP(S) Load Balancing. This is a legacy\npurpose, please use REGIONAL_MANAGED_PROXY instead.", + "Subnetwork will be used for Migration from one peered VPC to another.\n(a transient state of subnetwork\nwhile migrating resources from one project to another).", + "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." ], - "description": "Deletes the specified TargetHttpProxy resource." + "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" - } + "region": { + "description": "URL of the region where the Subnetwork resides. This\nfield can be set only at resource creation time.", + "type": "string" + }, + "reservedInternalRange": { + "description": "The URL of the reserved internal range.", + "type": "string" + }, + "resolveSubnetMask": { + "description": "Configures subnet mask resolution for this subnetwork.", + "enum": [ + "ARP_ALL_RANGES", + "ARP_PRIMARY_RANGE" + ], + "enumDescriptions": [ + "All ranges assigned to the VM NIC will respond to ARP.", + "Only the primary range of the VM NIC will respond to ARP." + ], + "type": "string" + }, + "role": { + "description": "The role of subnetwork. Currently, this field is only used when\npurpose is set to GLOBAL_MANAGED_PROXY orREGIONAL_MANAGED_PROXY. The value can be set toACTIVE or BACKUP. An ACTIVE\nsubnetwork is one that is currently being used for Envoy-based load\nbalancers in a region. A BACKUP subnetwork is one that is\nready to be promoted to ACTIVE or is currently draining.\nThis field can be updated with a patch request.", + "enum": [ + "ACTIVE", + "BACKUP" + ], + "enumDescriptions": [ + "The ACTIVE subnet that is currently used.", + "The BACKUP subnet that could be promoted to ACTIVE." + ], + "type": "string" + }, + "secondaryIpRanges": { + "description": "An array of configurations for secondary IP ranges for VM instances\ncontained in this subnetwork. The primary IP of such VM must belong to the\nprimary ipCidrRange of the subnetwork. The alias IPs may belong to either\nprimary or secondary ranges. This field can be updated with apatch request. Supports both IPv4 and IPv6 ranges.", + "items": { + "$ref": "SubnetworkSecondaryRange" }, - "parameterOrder": [ - "project", - "region", - "targetHttpProxy" + "type": "array" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" + }, + "stackType": { + "description": "The stack type for the subnet. If set to IPV4_ONLY, new VMs\nin the subnet are assigned IPv4 addresses only. If set toIPV4_IPV6, new VMs in the subnet can be assigned both IPv4 and\nIPv6 addresses. If not specified, IPV4_ONLY is used.\n\nThis field can be both set at resource creation time and updated usingpatch.", + "enum": [ + "IPV4_IPV6", + "IPV4_ONLY", + "IPV6_ONLY" ], - "request": { - "$ref": "UrlMapReference" + "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." + ], + "type": "string" + }, + "state": { + "description": "Output only. [Output Only] The state of the subnetwork, which can be one of the\nfollowing values:READY: Subnetwork is created and ready to useDRAINING: only applicable to subnetworks that have the\npurpose set to INTERNAL_HTTPS_LOAD_BALANCER and indicates that\nconnections to the load balancer are being drained. A subnetwork that is\ndraining cannot be used or modified until it reaches a status ofREADY", + "enum": [ + "DRAINING", + "READY" + ], + "enumDescriptions": [ + "Subnetwork is being drained.", + "Subnetwork is ready for use." + ], + "readOnly": true, + "type": "string" + }, + "systemReservedExternalIpv6Ranges": { + "description": "Output only. [Output Only] The array of external IPv6 network ranges reserved from\nthe subnetwork's external IPv6 range for system use.", + "items": { + "type": "string" }, - "response": { - "$ref": "Operation" + "readOnly": true, + "type": "array" + }, + "systemReservedInternalIpv6Ranges": { + "description": "Output only. [Output Only] The array of internal IPv6 network ranges reserved from\nthe subnetwork's internal IPv6 range for system use.", + "items": { + "type": "string" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Changes the URL map for TargetHttpProxy." + "readOnly": true, + "type": "array" + }, + "utilizationDetails": { + "$ref": "SubnetworkUtilizationDetails", + "description": "Output only. [Output Only] The current IP utilization of all subnetwork ranges. Contains\nthe total number of allocated and free IPs in each range.", + "readOnly": true } - } + }, + "type": "object" }, - "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", + "SubnetworkAggregatedList": { + "id": "SubnetworkAggregatedList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "additionalProperties": { + "$ref": "SubnetworksScopedList", + "description": "Name of the scope containing this set of Subnetworks." + }, + "description": "A list of SubnetworksScopedList resources.", + "type": "object" + }, + "kind": { + "default": "compute#subnetworkAggregatedList", + "description": "Output only. [Output Only] Type of resource. Alwayscompute#subnetworkAggregatedList for aggregated lists of\nsubnetworks.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "unreachables": { + "description": "Output only. [Output Only] Unreachable resources.", + "items": { + "type": "string" + }, + "readOnly": true, + "type": "array" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "pageToken": { - "description": "Specifies a page token 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{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" } }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "TargetHttpsProxyList" + "type": "object" + } + }, + "type": "object" + }, + "SubnetworkList": { + "description": "Contains a list of Subnetwork resources.", + "id": "SubnetworkList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of Subnetwork resources.", + "items": { + "$ref": "Subnetwork" }, - "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." + "type": "array" }, - "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", + "kind": { + "default": "compute#subnetworkList", + "description": "Output only. [Output Only] Type of resource. Always compute#subnetworkList\nfor lists of subnetworks.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "pageToken": { - "description": "Specifies a page token 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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" } }, - "parameterOrder": [ - "project" + "type": "object" + } + }, + "type": "object" + }, + "SubnetworkLogConfig": { + "description": "The available logging options for this subnetwork.", + "id": "SubnetworkLogConfig", + "properties": { + "aggregationInterval": { + "description": "Can only be specified if VPC flow logging for this subnetwork is enabled.\nToggles the aggregation interval for collecting flow logs. Increasing the\ninterval time will reduce the amount of generated flow logs for long\nlasting connections. Default is an interval of 5 seconds per connection.", + "enum": [ + "INTERVAL_10_MIN", + "INTERVAL_15_MIN", + "INTERVAL_1_MIN", + "INTERVAL_30_SEC", + "INTERVAL_5_MIN", + "INTERVAL_5_SEC" ], - "response": { - "$ref": "TargetHttpsProxyAggregatedList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "", + "", + "", + "", + "", + "" ], - "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`." + "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" + "enable": { + "description": "Whether to enable flow logging for this subnetwork. If this field is not\nexplicitly set, it will not appear in get listings. If not\nset the default behavior is determined by the org policy, if there is no\norg policy specified, then it will default to disabled.\nFlow logging isn't supported if the subnet purpose field is\nset to REGIONAL_MANAGED_PROXY.", + "type": "boolean" + }, + "filterExpr": { + "description": "Can only be specified if VPC flow logs for this subnetwork is enabled.\nThe filter expression is used to define which VPC flow logs should be\nexported to Cloud Logging.", + "type": "string" + }, + "flowSampling": { + "description": "Can only be specified if VPC flow logging for this subnetwork is enabled.\nThe value of the field must be in [0, 1]. Set the sampling rate of VPC\nflow logs within the subnetwork where 1.0 means all collected logs are\nreported and 0.0 means no logs are reported. Default is 0.5 unless\notherwise specified by the org policy, which means half of all collected\nlogs are reported.", + "format": "float", + "type": "number" + }, + "metadata": { + "description": "Can only be specified if VPC flow logs for this subnetwork is enabled.\nConfigures whether all, none or a subset of metadata fields should be\nadded to the reported VPC flow logs. Default isEXCLUDE_ALL_METADATA.", + "enum": [ + "CUSTOM_METADATA", + "EXCLUDE_ALL_METADATA", + "INCLUDE_ALL_METADATA" ], - "response": { - "$ref": "TargetHttpsProxy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "", + "", + "" ], - "description": "Returns the specified TargetHttpsProxy resource." + "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" - } + "metadataFields": { + "description": "Can only be specified if VPC flow logs for this subnetwork is enabled and\n\"metadata\" was set to CUSTOM_METADATA.", + "items": { + "type": "string" }, - "parameterOrder": [ - "project" + "type": "array" + } + }, + "type": "object" + }, + "SubnetworkParams": { + "description": "Additional subnetwork parameters.", + "id": "SubnetworkParams", + "properties": { + "resourceManagerTags": { + "additionalProperties": { + "type": "string" + }, + "description": "Tag keys/values directly bound to this resource.\nTag keys and values have the same definition as resource\nmanager tags. The field is allowed for INSERT\nonly. The keys/values to set on the resource should be specified in\neither ID { : } or Namespaced format\n{ : }.\nFor example the following are valid inputs:\n* {\"tagKeys/333\" : \"tagValues/444\", \"tagKeys/123\" : \"tagValues/456\"}\n* {\"123/environment\" : \"production\", \"345/abc\" : \"xyz\"}\nNote:\n* Invalid combinations of ID & namespaced format is not supported. For\n instance: {\"123/environment\" : \"tagValues/444\"} is invalid.", + "type": "object" + } + }, + "type": "object" + }, + "SubnetworkSecondaryRange": { + "description": "Represents a secondary IP range of a subnetwork.", + "id": "SubnetworkSecondaryRange", + "properties": { + "ipCidrRange": { + "description": "The range of IP addresses belonging to this subnetwork secondary range.\nProvide this property when you create the subnetwork. Ranges must be\nunique and non-overlapping with all primary and secondary IP ranges\nwithin a network. Both IPv4 and IPv6 ranges are supported. For IPv4,\nthe range can be any range listed in theValid\nranges list.\n\nFor IPv6:\nThe range must have a /64 prefix length.\nThe range must be omitted, for auto-allocation from Google-defined ULA\nIPv6 range.\nFor BYOGUA internal IPv6 secondary range, the range may be specified\nalong with the `ipCollection` field.\nIf an `ipCollection` is specified, the requested ip_cidr_range must lie\nwithin the range of the PDP referenced by the `ipCollection` field for\nallocation.\nIf `ipCollection` field is specified, but ip_cidr_range is not,\nthe range is auto-allocated from the PDP referenced by the `ipCollection`\nfield.", + "type": "string" + }, + "ipCollection": { + "description": "Reference to a Public Delegated Prefix (PDP) for BYOIP.\nThis field should be specified for configuring BYOGUA internal IPv6\nsecondary range.\nWhen specified along with the ip_cidr_range, the ip_cidr_range must lie\nwithin the PDP referenced by the `ipCollection` field.\nWhen specified without the ip_cidr_range, the range is auto-allocated\nfrom the PDP referenced by the `ipCollection` field.", + "type": "string" + }, + "ipVersion": { + "enum": [ + "IPV4", + "IPV6", + "IP_VERSION_UNSPECIFIED" ], - "request": { - "$ref": "TargetHttpsProxy" + "enumDescriptions": [ + "", + "", + "Treated as IPV4 for backward-compatibility." + ], + "type": "string" + }, + "rangeName": { + "description": "The name associated with this subnetwork secondary range, used when adding\nan alias IP/IPv6 range to a VM instance.\nThe name must be 1-63 characters long, and comply withRFC1035.\nThe name must be unique within the subnetwork.", + "type": "string" + }, + "reservedInternalRange": { + "description": "The URL of the reserved internal range. Only IPv4 is supported.", + "type": "string" + } + }, + "type": "object" + }, + "SubnetworkUtilizationDetails": { + "description": "The current IP utilization of all subnetwork ranges. Contains the total\nnumber of allocated and free IPs in each range.", + "id": "SubnetworkUtilizationDetails", + "properties": { + "externalIpv6InstanceUtilization": { + "$ref": "SubnetworkUtilizationDetailsIPV6Utilization", + "description": "Utilizations of external IPV6 IP range." + }, + "externalIpv6LbUtilization": { + "$ref": "SubnetworkUtilizationDetailsIPV6Utilization", + "description": "Utilizations of external IPV6 IP range for NetLB." + }, + "internalIpv6Utilization": { + "$ref": "SubnetworkUtilizationDetailsIPV6Utilization", + "description": "Utilizations of internal IPV6 IP range." + }, + "ipv4Utilizations": { + "description": "Utilizations of all IPV4 IP ranges. For primary ranges, the range name\nwill be empty.", + "items": { + "$ref": "SubnetworkUtilizationDetailsIPV4Utilization" }, - "response": { - "$ref": "Operation" + "type": "array" + } + }, + "type": "object" + }, + "SubnetworkUtilizationDetailsIPV4Utilization": { + "description": "The IPV4 utilization of a single IP range.", + "id": "SubnetworkUtilizationDetailsIPV4Utilization", + "properties": { + "rangeName": { + "description": "Will be set for secondary range. Empty for primary IPv4 range.", + "type": "string" + }, + "totalAllocatedIp": { + "format": "int64", + "type": "string" + }, + "totalFreeIp": { + "format": "int64", + "type": "string" + } + }, + "type": "object" + }, + "SubnetworkUtilizationDetailsIPV6Utilization": { + "description": "The IPV6 utilization of a single IP range.", + "id": "SubnetworkUtilizationDetailsIPV6Utilization", + "properties": { + "totalAllocatedIp": { + "$ref": "Uint128" + }, + "totalFreeIp": { + "$ref": "Uint128" + } + }, + "type": "object" + }, + "SubnetworksExpandIpCidrRangeRequest": { + "id": "SubnetworksExpandIpCidrRangeRequest", + "properties": { + "ipCidrRange": { + "description": "The IP (in CIDR format or netmask) of internal addresses that are legal on\nthis Subnetwork. This range should be disjoint from other subnetworks\nwithin this network. This range can only be larger than (i.e. a superset\nof) the range previously defined before the update.", + "type": "string" + } + }, + "type": "object" + }, + "SubnetworksScopedList": { + "id": "SubnetworksScopedList", + "properties": { + "subnetworks": { + "description": "A list of subnetworks contained in this scope.", + "items": { + "$ref": "Subnetwork" }, - "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." + "type": "array" }, - "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, + "warning": { + "description": "An informational warning that appears when the list of addresses\nis empty.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "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." + "type": "object" + } + }, + "type": "object" + }, + "SubnetworksScopedWarning": { + "id": "SubnetworksScopedWarning", + "properties": { + "scopeName": { + "description": "Name of the scope containing this set of Subnetworks.", + "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, + "warning": { + "description": "An informational warning about unreachable scope", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project", - "targetHttpsProxy" + "type": "object" + } + }, + "type": "object" + }, + "SubnetworksSetPrivateIpGoogleAccessRequest": { + "id": "SubnetworksSetPrivateIpGoogleAccessRequest", + "properties": { + "privateIpGoogleAccess": { + "type": "boolean" + } + }, + "type": "object" + }, + "Subsetting": { + "description": "Subsetting configuration for this BackendService.\nCurrently this is applicable only for Internal TCP/UDP load balancing,\nInternal HTTP(S) load balancing and Traffic Director.", + "id": "Subsetting", + "properties": { + "policy": { + "enum": [ + "CONSISTENT_HASH_SUBSETTING", + "NONE" ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "Subsetting based on consistent hashing.\n\nFor Traffic Director, the number of backends per backend group\n(the subset size) is based on the `subset_size` parameter.\n\nFor Internal HTTP(S) load balancing, the number of backends per backend\ngroup (the subset size) is dynamically adjusted in two cases:\n- As the number of proxy instances participating in Internal HTTP(S) load\n balancing increases, the subset size decreases.\n- When the total number of backends in a network exceeds the capacity of\n a single proxy instance, subset sizes are reduced automatically for\n each service that has backend subsetting enabled.", + "No Subsetting.\n\nClients may open connections and send traffic to all backends of this\nbackend service. This can lead to performance issues if there is\nsubstantial imbalance in the count of clients and backends." ], - "description": "Deletes the specified TargetHttpsProxy resource." + "type": "string" + } + }, + "type": "object" + }, + "TCPHealthCheck": { + "id": "TCPHealthCheck", + "properties": { + "port": { + "description": "The TCP port number to which the health check prober sends packets. The\ndefault value is 80. Valid values are 1 through65535.", + "format": "int32", + "type": "integer" }, - "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" + "portName": { + "description": "Not supported.", + "type": "string" + }, + "portSpecification": { + "description": "Specifies how a port is selected for health checking. Can be one of the\nfollowing values: \nUSE_FIXED_PORT: Specifies a port number explicitly using theport field in the health check. Supported by backend services\nfor passthrough load balancers and backend services for proxy load\nbalancers. Not supported by target pools. The health check supports all\nbackends supported by the backend service provided the backend can be\nhealth checked. For example, GCE_VM_IP network endpoint\ngroups, GCE_VM_IP_PORT network endpoint groups, and instance\ngroup backends. \nUSE_NAMED_PORT: Not supported. \nUSE_SERVING_PORT: Provides an indirect method of specifying\nthe health check port by referring to the backend service. Only supported\nby backend services for proxy load balancers. Not supported by target\npools. Not supported by backend services for passthrough load balancers.\nSupports all backends that can be health checked; for example,GCE_VM_IP_PORT network endpoint groups and instance group\nbackends.\n\nFor GCE_VM_IP_PORT network endpoint group backends, the health\ncheck uses the port number specified for each endpoint in the network\nendpoint group. For instance group backends, the health check uses the\nport number determined by looking up the backend service's named port in\nthe instance group's list of named ports.", + "enum": [ + "USE_FIXED_PORT", + "USE_NAMED_PORT", + "USE_SERVING_PORT" ], - "request": { - "$ref": "UrlMapReference" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "The port number in the health check's port is used for health\nchecking. Applies to network endpoint group and instance group backends.", + "Not supported.", + "For network endpoint group backends, the health check uses the port number\nspecified on each endpoint in the network endpoint group. For instance\ngroup backends, the health check uses the port number specified for the\nbackend service's named port defined in the instance group's named ports." ], - "description": "Changes the URL map for TargetHttpsProxy." + "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" + "proxyHeader": { + "description": "Specifies the type of proxy header to append before sending data to the\nbackend, either NONE or PROXY_V1. The default\nis NONE.", + "enum": [ + "NONE", + "PROXY_V1" ], - "request": { - "$ref": "TargetHttpsProxiesSetSslCertificatesRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "", + "" ], - "description": "Replaces SslCertificates for TargetHttpsProxy." + "type": "string" }, - "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" - } + "request": { + "description": "Instructs the health check prober to send this exact ASCII string, up to\n1024 bytes in length, after establishing the TCP connection.", + "type": "string" + }, + "response": { + "description": "Creates a content-based TCP health check. In addition to establishing a\nTCP connection, you can configure the health check to pass only when the\nbackend sends this exact response ASCII string, up to 1024 bytes in length.\nFor details, see:\nhttps://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-ssl-tcp", + "type": "string" + } + }, + "type": "object" + }, + "Tags": { + "description": "A set of instance tags.", + "id": "Tags", + "properties": { + "fingerprint": { + "description": "Specifies a fingerprint for this request, which is essentially a hash of\nthe tags' contents and used for optimistic locking. The\nfingerprint is initially generated by Compute Engine and changes after\nevery request to modify or update tags. You must always provide an\nup-to-date fingerprint hash in order to update or change tags.\n\nTo see the latest fingerprint, make get() request to the\ninstance.", + "format": "byte", + "type": "string" + }, + "items": { + "description": "An array of tags. Each tag must be 1-63 characters long, and comply\nwith RFC1035.", + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "targetHttpsProxy" - ], - "request": { - "$ref": "TargetHttpsProxiesSetCertificateMapRequest" + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "array" + } + }, + "type": "object" + }, + "TargetGrpcProxy": { + "description": "Represents a Target gRPC Proxy resource.\n\nA target gRPC proxy is a component of load balancers intended for\nload balancing gRPC traffic. Only global forwarding rules with load balancing\nscheme INTERNAL_SELF_MANAGED can reference a target gRPC proxy. The target\ngRPC Proxy references a URL map that specifies how traffic is routed to\ngRPC backend services.", + "id": "TargetGrpcProxy", + "properties": { + "creationTimestamp": { + "description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you\ncreate the resource.", + "type": "string" + }, + "fingerprint": { + "description": "Fingerprint of this resource. A hash of the contents stored in this object.\nThis field is used in optimistic locking. This field will be ignored when\ninserting a TargetGrpcProxy. An up-to-date fingerprint must\nbe provided in order to patch/update the TargetGrpcProxy; otherwise, the\nrequest will fail with error 412 conditionNotMet. To see the\nlatest fingerprint, make a get() request to retrieve the\nTargetGrpcProxy.", + "format": "byte", + "type": "string" + }, + "id": { + "description": "Output only. [Output Only] The unique identifier for the resource type. The server\ngenerates this identifier.", + "format": "uint64", + "readOnly": true, + "type": "string" + }, + "kind": { + "default": "compute#targetGrpcProxy", + "description": "Output only. [Output Only] Type of the resource. Alwayscompute#targetGrpcProxy for target grpc proxies.", + "readOnly": true, + "type": "string" + }, + "name": { + "annotations": { + "required": [ + "compute.targetGrpcProxies.insert" + ] }, - "response": { - "$ref": "Operation" + "description": "Name of the resource. Provided by the client when the resource is created.\nThe name must be 1-63 characters long, and comply withRFC1035.\nSpecifically, the name must be 1-63 characters long and match the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first\ncharacter must be a lowercase letter, and all following characters must\nbe a dash, lowercase letter, or digit, except the last character, which\ncannot be a dash.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for the resource.", + "readOnly": true, + "type": "string" + }, + "selfLinkWithId": { + "description": "Output only. [Output Only] Server-defined URL with id for the resource.", + "readOnly": true, + "type": "string" + }, + "urlMap": { + "description": "URL to the UrlMap resource that defines the mapping from URL to the\nBackendService. The protocol field in the BackendService must be set to\nGRPC.", + "type": "string" + }, + "validateForProxyless": { + "description": "If true, indicates that the BackendServices referenced by the urlMap may be\naccessed by gRPC applications without using a sidecar proxy. This will\nenable configuration checks on urlMap and its referenced BackendServices to\nnot allow unsupported features. A gRPC application must use\n\"xds:///\" scheme in the target URI of the service it is\nconnecting to.\nIf false, indicates that the BackendServices referenced by the urlMap will\nbe accessed by gRPC applications via a sidecar proxy. In this case, a gRPC\napplication must not use \"xds:///\" scheme in the target URI of\nthe service it is connecting to", + "type": "boolean" + } + }, + "type": "object" + }, + "TargetGrpcProxyList": { + "id": "TargetGrpcProxyList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of TargetGrpcProxy resources.", + "items": { + "$ref": "TargetGrpcProxy" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Changes the Certificate Map for TargetHttpsProxy." + "type": "array" }, - "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, + "kind": { + "default": "compute#targetGrpcProxyList", + "description": "Output only. [Output Only] Type of the resource. Alwayscompute#targetGrpcProxy for target grpc proxies.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue 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.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project", - "targetHttpsProxy" - ], - "request": { - "$ref": "SslPolicyReference" - }, - "response": { - "$ref": "Operation" + "type": "object" + } + }, + "type": "object" + }, + "TargetHttpProxiesScopedList": { + "id": "TargetHttpProxiesScopedList", + "properties": { + "targetHttpProxies": { + "description": "A list of TargetHttpProxies contained in this scope.", + "items": { + "$ref": "TargetHttpProxy" }, - "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." + "type": "array" }, - "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, + "warning": { + "description": "Informational warning which replaces the list of\nbackend services when the list is empty.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "targetHttpsProxy": { - "description": "Name of the TargetHttpsProxy resource to set the QUIC override policy for. The name should conform to RFC1035.", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project", - "targetHttpsProxy" - ], - "request": { - "$ref": "TargetHttpsProxiesSetQuicOverrideRequest" + "type": "object" + } + }, + "type": "object" + }, + "TargetHttpProxy": { + "description": "Represents a Target HTTP Proxy resource.\n\nGoogle Compute Engine has two Target HTTP Proxy resources:\n\n* [Global](/compute/docs/reference/rest/v1/targetHttpProxies)\n* [Regional](/compute/docs/reference/rest/v1/regionTargetHttpProxies)\n\nA target HTTP proxy is a component of Google Cloud HTTP load balancers.\n\n* targetHttpProxies are used by global external Application Load Balancers,\n classic Application Load Balancers, cross-region internal Application Load\n Balancers, and Traffic Director.\n* regionTargetHttpProxies are used by regional internal Application Load\n Balancers and regional external Application Load Balancers.\n\nForwarding rules reference a target HTTP proxy, and the target proxy\nthen references a URL map. For more information, readUsing Target Proxies\nand \nForwarding rule concepts.", + "id": "TargetHttpProxy", + "properties": { + "creationTimestamp": { + "description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you\ncreate the resource.", + "type": "string" + }, + "fingerprint": { + "description": "Fingerprint of this resource. A hash of the contents stored in this object.\nThis field is used in optimistic locking. This field will be ignored when\ninserting a TargetHttpProxy. An up-to-date fingerprint must\nbe provided in order to patch/update the TargetHttpProxy; otherwise, the\nrequest will fail with error 412 conditionNotMet. To see the\nlatest fingerprint, make a get() request to retrieve the\nTargetHttpProxy.", + "format": "byte", + "type": "string" + }, + "httpKeepAliveTimeoutSec": { + "description": "Specifies how long to keep a connection open, after completing a response,\nwhile there is no matching traffic (in seconds). If an HTTP keep-alive is\nnot specified, a default value (610 seconds) will be used.\n\nFor global external Application Load Balancers, the minimum allowed value\nis 5 seconds and the maximum allowed value is 1200 seconds.\n\nFor classic Application Load Balancers, this option is not supported.", + "format": "int32", + "type": "integer" + }, + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "format": "uint64", + "type": "string" + }, + "kind": { + "default": "compute#targetHttpProxy", + "description": "Output only. [Output Only] Type of resource. Always compute#targetHttpProxy\nfor target HTTP proxies.", + "readOnly": true, + "type": "string" + }, + "name": { + "description": "Name of the resource. Provided by the client when the resource is created.\nThe name must be 1-63 characters long, and comply withRFC1035.\nSpecifically, the name must be 1-63 characters long and match the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first\ncharacter must be a lowercase letter, and all following characters must\nbe a dash, lowercase letter, or digit, except the last character, which\ncannot be a dash.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "proxyBind": { + "description": "This field only applies when the forwarding rule that references this\ntarget proxy has a loadBalancingScheme set toINTERNAL_SELF_MANAGED.\n\nWhen this field is set to true, Envoy proxies set up inbound\ntraffic interception and bind to the IP address and port specified in the\nforwarding rule. This is generally useful when using Traffic Director to\nconfigure Envoy as a gateway or middle proxy (in other words, not a\nsidecar proxy). The Envoy proxy listens for inbound requests and handles\nrequests when it receives them.\n\nThe default is false.", + "type": "boolean" + }, + "region": { + "description": "Output only. [Output Only] URL of the region where the regional Target HTTP Proxy\nresides. This field is not applicable to global Target HTTP Proxies.", + "readOnly": true, + "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\nthe BackendService.", + "type": "string" + } + }, + "type": "object" + }, + "TargetHttpProxyAggregatedList": { + "id": "TargetHttpProxyAggregatedList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "additionalProperties": { + "$ref": "TargetHttpProxiesScopedList", + "description": "Name of the scope containing this set of TargetHttpProxies." }, - "response": { - "$ref": "Operation" + "description": "A list of TargetHttpProxiesScopedList resources.", + "type": "object" + }, + "kind": { + "default": "compute#targetHttpProxyAggregatedList", + "description": "Output only. [Output Only] Type of resource. Alwayscompute#targetHttpProxyAggregatedList for lists of Target HTTP\nProxies.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "unreachables": { + "description": "Output only. [Output Only] Unreachable resources.", + "items": { + "type": "string" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Sets the QUIC override policy for TargetHttpsProxy." + "readOnly": true, + "type": "array" } - } + }, + "type": "object" }, - "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", + "TargetHttpProxyList": { + "description": "A list of TargetHttpProxy resources.", + "id": "TargetHttpProxyList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of TargetHttpProxy resources.", + "items": { + "$ref": "TargetHttpProxy" + }, + "type": "array" + }, + "kind": { + "default": "compute#targetHttpProxyList", + "description": "Output only. Type of resource. Always compute#targetHttpProxyList for lists\nof target HTTP proxies.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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" } }, - "parameterOrder": [ - "project", - "region" - ], - "response": { - "$ref": "TargetHttpsProxyList" + "type": "object" + } + }, + "type": "object" + }, + "TargetHttpsProxiesScopedList": { + "id": "TargetHttpsProxiesScopedList", + "properties": { + "targetHttpsProxies": { + "description": "A list of TargetHttpsProxies contained in this scope.", + "items": { + "$ref": "TargetHttpsProxy" }, - "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." + "type": "array" }, - "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, + "warning": { + "description": "Informational warning which replaces the list of\nbackend services when the list is empty.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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, + "data": { + "description": "[Output Only] Metadata about this warning in key:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" + }, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project", - "region", - "targetHttpsProxy" + "type": "object" + } + }, + "type": "object" + }, + "TargetHttpsProxiesSetCertificateMapRequest": { + "id": "TargetHttpsProxiesSetCertificateMapRequest", + "properties": { + "certificateMap": { + "description": "URL of the Certificate Map to associate with this TargetHttpsProxy.\n\n Accepted format is//certificatemanager.googleapis.com/projects/{project}/locations/{location}/certificateMaps/{resourceName}.", + "type": "string" + } + }, + "type": "object" + }, + "TargetHttpsProxiesSetQuicOverrideRequest": { + "id": "TargetHttpsProxiesSetQuicOverrideRequest", + "properties": { + "quicOverride": { + "description": "QUIC policy for the TargetHttpsProxy resource.", + "enum": [ + "DISABLE", + "ENABLE", + "NONE" ], - "response": { - "$ref": "TargetHttpsProxy" + "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\nno QUIC override has been specified in the request." + ], + "type": "string" + } + }, + "type": "object" + }, + "TargetHttpsProxiesSetSslCertificatesRequest": { + "id": "TargetHttpsProxiesSetSslCertificatesRequest", + "properties": { + "sslCertificates": { + "description": "New set of SslCertificate resources to associate\nwith this TargetHttpsProxy resource. At least one SSL\ncertificate must be specified. Currently, you may specify up to 15 SSL\ncertificates.", + "items": { + "type": "string" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "type": "array" + } + }, + "type": "object" + }, + "TargetHttpsProxy": { + "description": "Represents a Target HTTPS Proxy resource.\n\nGoogle Compute Engine has two Target HTTPS Proxy resources:\n\n* [Global](/compute/docs/reference/rest/v1/targetHttpsProxies)\n* [Regional](/compute/docs/reference/rest/v1/regionTargetHttpsProxies)\n\nA target HTTPS proxy is a component of Google Cloud HTTPS load balancers.\n\n* targetHttpsProxies are used by global external Application Load Balancers,\n classic Application Load Balancers, cross-region internal Application Load\n Balancers, and Traffic Director.\n* regionTargetHttpsProxies are used by regional internal Application Load\n Balancers and regional external Application Load Balancers.\n\nForwarding rules reference a target HTTPS proxy, and the target proxy\nthen references a URL map. For more information, readUsing Target Proxies\nand \nForwarding rule concepts.", + "id": "TargetHttpsProxy", + "properties": { + "authorizationPolicy": { + "description": "Optional. A URL referring to a networksecurity.AuthorizationPolicy resource\nthat describes how the proxy should authorize inbound traffic. If left\nblank, access will not be restricted by an authorization policy.\n\n Refer to the AuthorizationPolicy resource for additional\ndetails.\n\n authorizationPolicy only applies to a globalTargetHttpsProxy attached toglobalForwardingRules with theloadBalancingScheme set to INTERNAL_SELF_MANAGED.\n\n Note: This field currently has no impact.", + "type": "string" + }, + "certificateMap": { + "description": "URL of a certificate map that identifies a certificate map associated with\nthe given target proxy.\nThis field can only be set for Global external Application Load Balancer or\nClassic Application Load Balancer. For other products use Certificate\nManager Certificates instead.\n\nIf set, sslCertificates will be ignored.\n\n Accepted format is//certificatemanager.googleapis.com/projects/{project}/locations/{location}/certificateMaps/{resourceName}.", + "type": "string" + }, + "creationTimestamp": { + "description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you\ncreate the resource.", + "type": "string" + }, + "fingerprint": { + "description": "Fingerprint of this resource. A hash of the contents stored in this object.\nThis field is used in optimistic locking. This field will be ignored when\ninserting a TargetHttpsProxy. An up-to-date fingerprint must\nbe provided in order to patch the TargetHttpsProxy; otherwise, the request\nwill fail with error 412 conditionNotMet. To see the latest\nfingerprint, make a get() request to retrieve the\nTargetHttpsProxy.", + "format": "byte", + "type": "string" + }, + "httpKeepAliveTimeoutSec": { + "description": "Specifies how long to keep a connection open, after completing a response,\nwhile there is no matching traffic (in seconds). If an HTTP keep-alive is\nnot specified, a default value (610 seconds) will be used.\n\nFor global external Application Load Balancers, the minimum allowed value\nis 5 seconds and the maximum allowed value is 1200 seconds.\n\nFor classic Application Load Balancers, this option is not supported.", + "format": "int32", + "type": "integer" + }, + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "format": "uint64", + "type": "string" + }, + "kind": { + "default": "compute#targetHttpsProxy", + "description": "Output only. [Output Only] Type of resource. Alwayscompute#targetHttpsProxy for target HTTPS proxies.", + "readOnly": true, + "type": "string" + }, + "name": { + "description": "Name of the resource. Provided by the client when the resource is created.\nThe name must be 1-63 characters long, and comply withRFC1035.\nSpecifically, the name must be 1-63 characters long and match the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first\ncharacter must be a lowercase letter, and all following characters must\nbe a dash, lowercase letter, or digit, except the last character, which\ncannot be a dash.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "proxyBind": { + "description": "This field only applies when the forwarding rule that references this\ntarget proxy has a loadBalancingScheme set toINTERNAL_SELF_MANAGED.\n\nWhen this field is set to true, Envoy proxies set up inbound\ntraffic interception and bind to the IP address and port specified in the\nforwarding rule. This is generally useful when using Traffic Director to\nconfigure Envoy as a gateway or middle proxy (in other words, not a\nsidecar proxy). The Envoy proxy listens for inbound requests and handles\nrequests when it receives them.\n\nThe default is false.", + "type": "boolean" + }, + "quicOverride": { + "description": "Specifies the QUIC override policy for this TargetHttpsProxy resource. This\nsetting determines whether the load balancer attempts to negotiate QUIC\nwith clients.\nYou can specify NONE, ENABLE, orDISABLE.\n \n - When quic-override is set to NONE,\n Google manages whether QUIC is used.\n - When quic-override is set to ENABLE, the\n load balancer uses QUIC when possible.\n - When quic-override is set to DISABLE, the\n load balancer doesn't use QUIC.\n - If the quic-override flag is not specified,NONE is implied.", + "enum": [ + "DISABLE", + "ENABLE", + "NONE" ], - "description": "Returns the specified TargetHttpsProxy resource in the specified region." + "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\nno QUIC override has been specified in the request." + ], + "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" - } + "region": { + "description": "Output only. [Output Only] URL of the region where the regional TargetHttpsProxy\nresides. This field is not applicable to global TargetHttpsProxies.", + "readOnly": true, + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" + }, + "serverTlsPolicy": { + "description": "Optional. A URL referring to a networksecurity.ServerTlsPolicy resource\nthat describes how the proxy should authenticate inbound traffic.\n\n serverTlsPolicy only applies to a globalTargetHttpsProxy attached toglobalForwardingRules with theloadBalancingScheme set to INTERNAL_SELF_MANAGED\nor EXTERNAL orEXTERNAL_MANAGED or INTERNAL_MANAGED.\nIt also applies to a regional TargetHttpsProxy attached to\nregional forwardingRules with theloadBalancingScheme set to EXTERNAL_MANAGED orINTERNAL_MANAGED. For details whichServerTlsPolicy resources are accepted withINTERNAL_SELF_MANAGED and which with EXTERNAL,INTERNAL_MANAGED, EXTERNAL_MANAGEDloadBalancingScheme consult ServerTlsPolicy\ndocumentation.\n\n If left blank, communications are not encrypted.", + "type": "string" + }, + "sslCertificates": { + "description": "URLs to SslCertificate resources that are used to authenticate\nconnections between users and the load balancer. At least one SSL\ncertificate must be specified. SslCertificates do not apply when the load\nbalancing scheme is set to INTERNAL_SELF_MANAGED.\n\nThe URLs should refer to a SSL Certificate resource or Certificate Manager\nCertificate resource. Mixing Classic Certificates and Certificate Manager\nCertificates is not allowed. Certificate Manager Certificates must include\nthe certificatemanager API namespace. Using Certificate Manager\nCertificates in this field is not supported by Global external Application\nLoad Balancer or Classic Application Load Balancer, use certificate_map\ninstead.\n\nCurrently, you may specify up to 15 Classic SSL Certificates or up to 100\nCertificate Manager Certificates.\n\nCertificate Manager Certificates accepted formats are:\n \n - //certificatemanager.googleapis.com/projects/{project}/locations/{location}/certificates/{resourceName}.\n - https://certificatemanager.googleapis.com/v1alpha1/projects/{project}/locations/{location}/certificates/{resourceName}.", + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "region" + "type": "array" + }, + "sslPolicy": { + "description": "URL of SslPolicy resource that will be associated with the TargetHttpsProxy\nresource. If not set, the TargetHttpsProxy resource has no\nSSL policy configured.", + "type": "string" + }, + "tlsEarlyData": { + "description": "Specifies whether TLS 1.3 0-RTT Data (\"Early Data\") should be accepted\nfor this service. Early Data allows a TLS resumption handshake to include\nthe initial application payload (a HTTP request) alongside the handshake,\nreducing the effective round trips to \"zero\". This applies to TLS 1.3\nconnections over TCP (HTTP/2) as well as over UDP (QUIC/h3).\n\n\nThis can improve application performance, especially on networks where\ninterruptions may be common, such as on mobile.\n\n\nRequests with Early Data will have the \"Early-Data\" HTTP header set on\nthe request, with a value of \"1\", to allow the backend to determine whether\nEarly Data was included.\n\n\nNote: TLS Early Data may allow requests to be replayed, as the data is\nsent to the backend before the handshake has fully completed. Applications\nthat allow idempotent HTTP methods to make non-idempotent changes, such as\na GET request updating a database, should not accept Early Data on those\nrequests, and reject requests with the \"Early-Data: 1\" HTTP header by\nreturning a HTTP 425 (Too Early) status code, in order to remain RFC\ncompliant.\n\n\nThe default value is DISABLED.", + "enum": [ + "DISABLED", + "PERMISSIVE", + "STRICT", + "UNRESTRICTED" ], - "request": { - "$ref": "TargetHttpsProxy" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "TLS 1.3 Early Data is not advertised, and any (invalid) attempts to send\nEarly Data will be rejected by closing the connection.", + "This enables TLS 1.3 0-RTT, and only allows Early Data to be included on\nrequests with safe HTTP methods (GET, HEAD, OPTIONS, TRACE). This mode\ndoes not enforce any other limitations for requests with Early Data. The\napplication owner should validate that Early Data is acceptable for a\ngiven request path.", + "This enables TLS 1.3 0-RTT, and only allows Early Data to be included on\nrequests with safe HTTP methods (GET, HEAD, OPTIONS, TRACE) without query\nparameters. Requests that send Early Data with non-idempotent HTTP\nmethods or with query parameters will be rejected with a HTTP 425.", + "This enables TLS 1.3 Early Data for requests with any HTTP method\nincluding non-idempotent methods list POST. This mode does not enforce\nany other limitations. This may be valuable for gRPC use cases. However,\nwe do not recommend this method unless you have evaluated your security\nstance and mitigated the risk of replay attacks using other mechanisms." ], - "description": "Creates a TargetHttpsProxy resource in the specified project and region using the data included in the request." + "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" - } + "urlMap": { + "description": "A fully-qualified or valid partial URL to the UrlMap resource that defines\nthe mapping from URL to the BackendService. For example, the following are\nall valid URLs for specifying a URL map:\n \n - https://www.googleapis.compute/v1/projects/project/global/urlMaps/url-map \n - projects/project/global/urlMaps/url-map \n - global/urlMaps/url-map", + "type": "string" + } + }, + "type": "object" + }, + "TargetHttpsProxyAggregatedList": { + "id": "TargetHttpsProxyAggregatedList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "additionalProperties": { + "$ref": "TargetHttpsProxiesScopedList", + "description": "Name of the scope containing this set of TargetHttpsProxies." }, - "parameterOrder": [ - "project", - "region", - "targetHttpsProxy" - ], - "response": { - "$ref": "Operation" + "description": "A list of TargetHttpsProxiesScopedList resources.", + "type": "object" + }, + "kind": { + "default": "compute#targetHttpsProxyAggregatedList", + "description": "Output only. [Output Only] Type of resource. Alwayscompute#targetHttpsProxyAggregatedList for lists of Target\nHTTP Proxies.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "unreachables": { + "description": "Output only. [Output Only] Unreachable resources.", + "items": { + "type": "string" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified TargetHttpsProxy resource." + "readOnly": true, + "type": "array" }, - "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, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project", - "region", - "targetHttpsProxy" - ], - "request": { + "type": "object" + } + }, + "type": "object" + }, + "TargetHttpsProxyList": { + "description": "Contains a list of TargetHttpsProxy resources.", + "id": "TargetHttpsProxyList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of TargetHttpsProxy resources.", + "items": { "$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." + "type": "array" }, - "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, + "kind": { + "default": "compute#targetHttpsProxyList", + "description": "Output only. Type of resource. Always compute#targetHttpsProxyList for\nlists of target HTTPS proxies.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project", - "region", - "targetHttpsProxy" + "type": "object" + } + }, + "type": "object" + }, + "TargetInstance": { + "description": "Represents a Target Instance resource.\n\nYou can use a target instance to handle traffic for one or more forwarding\nrules, which is ideal for forwarding protocol traffic that is managed by a\nsingle source. For example, ESP, AH, TCP, or UDP.\nFor more information, readTarget\ninstances.", + "id": "TargetInstance", + "properties": { + "creationTimestamp": { + "description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you\ncreate the resource.", + "type": "string" + }, + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "format": "uint64", + "type": "string" + }, + "instance": { + "description": "A URL to the virtual machine instance that handles traffic for this target\ninstance. When creating a target instance, you can provide the\nfully-qualified URL or a valid partial URL to the desired virtual machine.\nFor example, the following are all valid URLs:\n \n - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/instance \n - projects/project/zones/zone/instances/instance \n - zones/zone/instances/instance", + "type": "string" + }, + "kind": { + "default": "compute#targetInstance", + "description": "Output only. [Output Only] The type of the resource. Alwayscompute#targetInstance for target instances.", + "readOnly": true, + "type": "string" + }, + "name": { + "description": "Name of the resource. Provided by the client when the resource is created.\nThe name must be 1-63 characters long, and comply withRFC1035.\nSpecifically, the name must be 1-63 characters long and match the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first\ncharacter must be a lowercase letter, and all following characters must\nbe a dash, lowercase letter, or digit, except the last character, which\ncannot be a dash.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "natPolicy": { + "description": "Must have a value of NO_NAT.\nProtocol forwarding delivers packets while preserving the destination IP\naddress of the forwarding rule referencing the target instance.", + "enum": [ + "NO_NAT" ], - "request": { - "$ref": "UrlMapReference" + "enumDescriptions": [ + "No NAT performed." + ], + "type": "string" + }, + "network": { + "description": "The URL of the network this target instance uses to forward traffic.\nIf not specified, the traffic will be forwarded to the network that\nthe default network interface belongs to.", + "type": "string" + }, + "securityPolicy": { + "description": "[Output Only] The resource URL for the security policy associated with this\ntarget instance.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" + }, + "zone": { + "description": "Output only. [Output Only] URL of the zone where the target instance resides.\nYou must specify this field as part of the HTTP request URL. It is\nnot settable as a field in the request body.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "TargetInstanceAggregatedList": { + "id": "TargetInstanceAggregatedList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "additionalProperties": { + "$ref": "TargetInstancesScopedList", + "description": "Name of the scope containing this set of target instances." }, - "response": { - "$ref": "Operation" + "description": "A list of TargetInstance resources.", + "type": "object" + }, + "kind": { + "default": "compute#targetInstanceAggregatedList", + "description": "Output only. Type of resource.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "unreachables": { + "description": "Output only. [Output Only] Unreachable resources.", + "items": { + "type": "string" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Changes the URL map for TargetHttpsProxy." + "readOnly": true, + "type": "array" }, - "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, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "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." + "type": "object" } - } + }, + "type": "object" }, - "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, + "TargetInstanceList": { + "description": "Contains a list of TargetInstance resources.", + "id": "TargetInstanceList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of TargetInstance resources.", + "items": { + "$ref": "TargetInstance" + }, + "type": "array" + }, + "kind": { + "default": "compute#targetInstanceList", + "description": "Output only. Type of resource.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "zone": { - "description": "Name of the zone 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" } }, - "parameterOrder": [ - "project", - "zone" - ], - "response": { - "$ref": "TargetInstanceList" + "type": "object" + } + }, + "type": "object" + }, + "TargetInstancesScopedList": { + "id": "TargetInstancesScopedList", + "properties": { + "targetInstances": { + "description": "A list of target instances contained in this scope.", + "items": { + "$ref": "TargetInstance" }, - "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." + "type": "array" }, - "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", + "warning": { + "description": "Informational warning which replaces the list of addresses when\nthe list is empty.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "pageToken": { - "description": "Specifies a page token 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{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" } }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "TargetInstanceAggregatedList" + "type": "object" + } + }, + "type": "object" + }, + "TargetPool": { + "description": "Represents a Target Pool resource.\n\nTarget pools are used with external passthrough Network Load Balancers.\nA target pool references member instances, an associated legacy\nHttpHealthCheck resource, and, optionally, a backup target pool.\nFor more information, readUsing target pools.", + "id": "TargetPool", + "properties": { + "backupPool": { + "description": "The server-defined URL for the resource. This field is applicable only when\nthe containing target pool is serving a forwarding rule as the primary\npool, and its failoverRatio field is properly set to a value\nbetween [0, 1].\nbackupPool and failoverRatio together define\nthe fallback behavior of the primary target pool: if the ratio of the\nhealthy instances in the primary pool is at or belowfailoverRatio, traffic arriving at the load-balanced\nIP will be directed to the backup pool.\n\nIn case where failoverRatio and backupPool\nare not set, or all the instances in the backup pool are unhealthy,\nthe traffic will be directed back to the primary pool in the \"force\"\nmode, where traffic will be spread to the healthy instances with the\nbest effort, or to all instances when no instance is healthy.", + "type": "string" + }, + "creationTimestamp": { + "description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you\ncreate the resource.", + "type": "string" + }, + "failoverRatio": { + "description": "This field is applicable only when the containing target pool is serving a\nforwarding rule as the primary pool (i.e., not as a backup pool to some\nother target pool). The value of the field must be in [0, 1].\n\nIf set, backupPool must also be set. They together define\nthe fallback behavior of the primary target pool: if the ratio of the\nhealthy instances in the primary pool is at or below this number,\ntraffic arriving at the load-balanced IP will be directed to the\nbackup pool.\n\nIn case where failoverRatio is not set or all the\ninstances in the backup pool are unhealthy, the traffic will be\ndirected back to the primary pool in the \"force\" mode, where traffic\nwill be spread to the healthy instances with the\nbest effort, or to all instances when no instance is healthy.", + "format": "float", + "type": "number" + }, + "healthChecks": { + "description": "The URL of the HttpHealthCheck resource. A member instance in this\npool is considered healthy if and only if the health checks pass.\nOnly legacy HttpHealthChecks are supported. Only one health check may be\nspecified.", + "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 an aggregated list of target instances. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." + "type": "array" }, - "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" - } + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "format": "uint64", + "type": "string" + }, + "instances": { + "description": "A list of resource URLs to the virtual machine instances serving this pool.\nThey must live in zones contained in the same region as this pool.", + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "zone", - "targetInstance" + "type": "array" + }, + "kind": { + "default": "compute#targetPool", + "description": "Output only. [Output Only] Type of the resource. Always compute#targetPool\nfor target pools.", + "readOnly": true, + "type": "string" + }, + "name": { + "description": "Name of the resource. Provided by the client when the resource is created.\nThe name must be 1-63 characters long, and comply withRFC1035.\nSpecifically, the name must be 1-63 characters long and match the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first\ncharacter must be a lowercase letter, and all following characters must\nbe a dash, lowercase letter, or digit, except the last character, which\ncannot be a dash.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "region": { + "description": "Output only. [Output Only] URL of the region where the target pool resides.", + "readOnly": true, + "type": "string" + }, + "securityPolicy": { + "description": "[Output Only] The resource URL for the security policy associated with this\ntarget pool.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" + }, + "sessionAffinity": { + "description": "Session affinity option, must be one of the following values: \nNONE: Connections from the same client IP may go to any\n instance in the pool. \nCLIENT_IP: Connections from the same client IP will go\n to the same instance in\n the pool while that instance remains healthy. \nCLIENT_IP_PROTO: Connections from the same client IP\n with the same IP protocol will go to the same instance in the\n pool while that instance remains healthy.", + "enum": [ + "CLIENT_IP", + "CLIENT_IP_NO_DESTINATION", + "CLIENT_IP_PORT_PROTO", + "CLIENT_IP_PROTO", + "GENERATED_COOKIE", + "HEADER_FIELD", + "HTTP_COOKIE", + "NONE", + "STRONG_COOKIE_AFFINITY" ], - "response": { - "$ref": "TargetInstance" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "2-tuple hash on packet's source and destination IP addresses. Connections\nfrom the same source IP address to the same destination IP address will be\nserved by the same backend VM while that VM remains healthy.", + "1-tuple hash only on packet's source IP address. Connections from the\nsame source IP address will be served by the same backend VM while that VM\nremains healthy. This option can only be used for Internal TCP/UDP\nLoad Balancing.", + "5-tuple hash on packet's source and destination IP addresses, IP protocol,\nand source and destination ports. Connections for the same IP protocol\nfrom the same source IP address and port to the same destination IP address\nand port will be served by the same backend VM while that VM remains\nhealthy. This option cannot be used for HTTP(S) load balancing.", + "3-tuple hash on packet's source and destination IP addresses, and IP\nprotocol. Connections for the same IP protocol from the same source IP\naddress to the same destination IP address will be served by the same\nbackend VM while that VM remains healthy. This option cannot be used for\nHTTP(S) load balancing.", + "Hash based on a cookie generated by the L7 loadbalancer.\nOnly 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\nto any instance in the pool.", + "Strong cookie-based affinity. Connections bearing the same cookie will be\nserved by the same backend VM while that VM remains healthy, as long as the\ncookie has not expired." ], - "description": "Returns the specified TargetInstance resource." + "type": "string" + } + }, + "type": "object" + }, + "TargetPoolAggregatedList": { + "id": "TargetPoolAggregatedList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "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" + "items": { + "additionalProperties": { + "$ref": "TargetPoolsScopedList", + "description": "Name of the scope containing this set of target pools." }, - "response": { - "$ref": "Operation" + "description": "A list of TargetPool resources.", + "type": "object" + }, + "kind": { + "default": "compute#targetPoolAggregatedList", + "description": "Output only. [Output Only] Type of resource. Alwayscompute#targetPoolAggregatedList for aggregated lists of\ntarget pools.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "unreachables": { + "description": "Output only. [Output Only] Unreachable resources.", + "items": { + "type": "string" }, - "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." + "readOnly": true, + "type": "array" }, - "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", + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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" + "data": { + "description": "[Output Only] Metadata about this warning in key:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "zone": { - "description": "Name of the zone 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" } }, - "parameterOrder": [ - "project", - "zone", - "targetInstance" - ], - "response": { - "$ref": "Operation" + "type": "object" + } + }, + "type": "object" + }, + "TargetPoolInstanceHealth": { + "id": "TargetPoolInstanceHealth", + "properties": { + "healthStatus": { + "items": { + "$ref": "HealthStatus" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified TargetInstance resource." + "type": "array" }, - "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", + "kind": { + "default": "compute#targetPoolInstanceHealth", + "description": "Output only. [Output Only] Type of resource. Alwayscompute#targetPoolInstanceHealth when checking the health of\nan instance.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "TargetPoolList": { + "description": "Contains a list of TargetPool resources.", + "id": "TargetPoolList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of TargetPool resources.", + "items": { + "$ref": "TargetPool" + }, + "type": "array" + }, + "kind": { + "default": "compute#targetPoolList", + "description": "Output only. [Output Only] Type of resource. Always compute#targetPoolList\nfor lists of target pools.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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" + "data": { + "description": "[Output Only] Metadata about this warning in key:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "zone": { - "description": "Name of the zone 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" } }, - "parameterOrder": [ - "project", - "zone", - "targetInstance" - ], - "request": { - "$ref": "SecurityPolicyReference" + "type": "object" + } + }, + "type": "object" + }, + "TargetPoolsAddHealthCheckRequest": { + "id": "TargetPoolsAddHealthCheckRequest", + "properties": { + "healthChecks": { + "description": "The HttpHealthCheck to add to the target pool.", + "items": { + "$ref": "HealthCheckReference" }, - "response": { - "$ref": "Operation" + "type": "array" + } + }, + "type": "object" + }, + "TargetPoolsAddInstanceRequest": { + "id": "TargetPoolsAddInstanceRequest", + "properties": { + "instances": { + "description": "A full or partial URL to an instance to add to this target pool. This can\nbe a full or partial URL. For example, the following are valid URLs: \n \n - https://www.googleapis.com/compute/v1/projects/project-id/zones/zone/instances/instance-name \n - projects/project-id/zones/zone/instances/instance-name \n - zones/zone/instances/instance-name", + "items": { + "$ref": "InstanceReference" }, - "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" + "type": "array" } - } + }, + "type": "object" }, - "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" - } + "TargetPoolsRemoveHealthCheckRequest": { + "id": "TargetPoolsRemoveHealthCheckRequest", + "properties": { + "healthChecks": { + "description": "Health check URL to be removed. This can be a full or valid partial URL.\nFor example, the following are valid URLs:\n \n - https://www.googleapis.com/compute/beta/projects/project/global/httpHealthChecks/health-check \n - projects/project/global/httpHealthChecks/health-check\n - global/httpHealthChecks/health-check", + "items": { + "$ref": "HealthCheckReference" }, - "parameterOrder": [ - "project", - "region" - ], - "response": { - "$ref": "TargetPoolList" + "type": "array" + } + }, + "type": "object" + }, + "TargetPoolsRemoveInstanceRequest": { + "id": "TargetPoolsRemoveInstanceRequest", + "properties": { + "instances": { + "description": "URLs of the instances to be removed from target pool.", + "items": { + "$ref": "InstanceReference" }, - "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." + "type": "array" + } + }, + "type": "object" + }, + "TargetPoolsScopedList": { + "id": "TargetPoolsScopedList", + "properties": { + "targetPools": { + "description": "A list of target pools contained in this scope.", + "items": { + "$ref": "TargetPool" + }, + "type": "array" }, - "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", + "warning": { + "description": "Informational warning which replaces the list of addresses when\nthe list is empty.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "pageToken": { - "description": "Specifies a page token 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{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" } }, - "parameterOrder": [ - "project" + "type": "object" + } + }, + "type": "object" + }, + "TargetReference": { + "id": "TargetReference", + "properties": { + "target": { + "type": "string" + } + }, + "type": "object" + }, + "TargetSslProxiesSetBackendServiceRequest": { + "id": "TargetSslProxiesSetBackendServiceRequest", + "properties": { + "service": { + "description": "The URL of the new BackendService resource for the targetSslProxy.", + "type": "string" + } + }, + "type": "object" + }, + "TargetSslProxiesSetCertificateMapRequest": { + "id": "TargetSslProxiesSetCertificateMapRequest", + "properties": { + "certificateMap": { + "description": "URL of the Certificate Map to associate with this TargetSslProxy.\n\n Accepted format is//certificatemanager.googleapis.com/projects/{project}/locations/{location}/certificateMaps/{resourceName}.", + "type": "string" + } + }, + "type": "object" + }, + "TargetSslProxiesSetProxyHeaderRequest": { + "id": "TargetSslProxiesSetProxyHeaderRequest", + "properties": { + "proxyHeader": { + "description": "The new type of proxy header to append before sending data to the\nbackend. NONE or PROXY_V1 are allowed.", + "enum": [ + "NONE", + "PROXY_V1" ], - "response": { - "$ref": "TargetPoolAggregatedList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "", + "" ], - "description": "Retrieves an aggregated list of target pools. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." - }, - "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" - } + "type": "string" + } + }, + "type": "object" + }, + "TargetSslProxiesSetSslCertificatesRequest": { + "id": "TargetSslProxiesSetSslCertificatesRequest", + "properties": { + "sslCertificates": { + "description": "New set of URLs to SslCertificate resources to associate with this\nTargetSslProxy. At least one SSL certificate must be specified.\nCurrently, you may specify up to 15 SSL certificates.", + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "region", - "targetPool" + "type": "array" + } + }, + "type": "object" + }, + "TargetSslProxy": { + "description": "Represents a Target SSL Proxy resource.\n\nA target SSL proxy is a component of a Proxy Network Load Balancer.\nThe forwarding rule references the target SSL proxy, and the target proxy\nthen references a backend service. For more information, readProxy Network\nLoad Balancer overview.", + "id": "TargetSslProxy", + "properties": { + "certificateMap": { + "description": "URL of a certificate map that identifies a certificate map associated with\nthe given target proxy.\nThis field can only be set for global target proxies.\nIf set, sslCertificates will be ignored.\n\n Accepted format is//certificatemanager.googleapis.com/projects/{project}/locations/{location}/certificateMaps/{resourceName}.", + "type": "string" + }, + "creationTimestamp": { + "description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you\ncreate the resource.", + "type": "string" + }, + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "format": "uint64", + "type": "string" + }, + "kind": { + "default": "compute#targetSslProxy", + "description": "Output only. [Output Only] Type of the resource. Alwayscompute#targetSslProxy for target SSL proxies.", + "readOnly": true, + "type": "string" + }, + "name": { + "description": "Name of the resource. Provided by the client when the resource is created.\nThe name must be 1-63 characters long, and comply withRFC1035.\nSpecifically, the name must be 1-63 characters long and match the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first\ncharacter must be a lowercase letter, and all following characters must\nbe a dash, lowercase letter, or digit, except the last character, which\ncannot be a dash.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "proxyHeader": { + "description": "Specifies the type of proxy header to append before sending data to the\nbackend, either NONE or PROXY_V1. The default\nis NONE.", + "enum": [ + "NONE", + "PROXY_V1" ], - "response": { - "$ref": "TargetPool" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "", + "" ], - "description": "Returns the specified target pool." + "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" + "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\nauthenticate connections to Backends. At least one SSL certificate\nmust be specified. Currently, you may specify up to 15 SSL certificates.\nsslCertificates do not apply when the load balancing scheme is set to\nINTERNAL_SELF_MANAGED.", + "items": { + "type": "string" }, - "response": { - "$ref": "Operation" + "type": "array" + }, + "sslPolicy": { + "description": "URL of SslPolicy resource that will be associated with the TargetSslProxy\nresource. If not set, the TargetSslProxy resource will not have any\nSSL policy configured.", + "type": "string" + } + }, + "type": "object" + }, + "TargetSslProxyList": { + "description": "Contains a list of TargetSslProxy resources.", + "id": "TargetSslProxyList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of TargetSslProxy resources.", + "items": { + "$ref": "TargetSslProxy" }, - "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." + "type": "array" }, - "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, + "kind": { + "default": "compute#targetSslProxyList", + "description": "Output only. Type of resource.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project", - "region", - "targetPool" - ], - "response": { - "$ref": "Operation" + "type": "object" + } + }, + "type": "object" + }, + "TargetTcpProxiesScopedList": { + "id": "TargetTcpProxiesScopedList", + "properties": { + "targetTcpProxies": { + "description": "A list of TargetTcpProxies contained in this scope.", + "items": { + "$ref": "TargetTcpProxy" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified target pool." + "type": "array" }, - "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, + "warning": { + "description": "Informational warning which replaces the list of\nbackend services when the list is empty.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project", - "region", - "targetPool" + "type": "object" + } + }, + "type": "object" + }, + "TargetTcpProxiesSetBackendServiceRequest": { + "id": "TargetTcpProxiesSetBackendServiceRequest", + "properties": { + "service": { + "description": "The URL of the new BackendService resource for the targetTcpProxy.", + "type": "string" + } + }, + "type": "object" + }, + "TargetTcpProxiesSetProxyHeaderRequest": { + "id": "TargetTcpProxiesSetProxyHeaderRequest", + "properties": { + "proxyHeader": { + "description": "The new type of proxy header to append before sending data to the\nbackend. NONE or PROXY_V1 are allowed.", + "enum": [ + "NONE", + "PROXY_V1" ], - "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" + "enumDescriptions": [ + "", + "" ], - "description": "Gets the most recent health check results for each IP for the instance that is referenced by the given target pool." + "type": "string" + } + }, + "type": "object" + }, + "TargetTcpProxy": { + "description": "Represents a Target TCP Proxy resource.\n\nA target TCP proxy is a component of a Proxy Network Load Balancer.\nThe forwarding rule references the target TCP proxy, and the target proxy\nthen references a backend service. For more information, readProxy Network\nLoad Balancer overview.", + "id": "TargetTcpProxy", + "properties": { + "creationTimestamp": { + "description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", + "readOnly": true, + "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" + "description": { + "description": "An optional description of this resource. Provide this property when you\ncreate the resource.", + "type": "string" + }, + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "format": "uint64", + "type": "string" + }, + "kind": { + "default": "compute#targetTcpProxy", + "description": "Output only. [Output Only] Type of the resource. Alwayscompute#targetTcpProxy for target TCP proxies.", + "readOnly": true, + "type": "string" + }, + "loadBalancingScheme": { + "description": "Specifies the type of load balancing scheme used by this target proxy.", + "enum": [ + "EXTERNAL", + "EXTERNAL_MANAGED", + "INTERNAL_MANAGED", + "LOAD_BALANCING_SCHEME_UNSPECIFIED" ], - "request": { - "$ref": "TargetPoolsAddHealthCheckRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "", + "", + "", + "" ], - "description": "Adds health check URLs to a target pool." + "type": "string" }, - "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" + "name": { + "description": "Name of the resource. Provided by the client when the resource is created.\nThe name must be 1-63 characters long, and comply withRFC1035.\nSpecifically, the name must be 1-63 characters long and match the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first\ncharacter must be a lowercase letter, and all following characters must\nbe a dash, lowercase letter, or digit, except the last character, which\ncannot be a dash.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "proxyBind": { + "description": "This field only applies when the forwarding rule that references this\ntarget proxy has a loadBalancingScheme set toINTERNAL_SELF_MANAGED.\n\nWhen this field is set to true, Envoy proxies set up inbound\ntraffic interception and bind to the IP address and port specified in the\nforwarding rule. This is generally useful when using Traffic Director to\nconfigure Envoy as a gateway or middle proxy (in other words, not a\nsidecar proxy). The Envoy proxy listens for inbound requests and handles\nrequests when it receives them.\n\nThe default is false.", + "type": "boolean" + }, + "proxyHeader": { + "description": "Specifies the type of proxy header to append before sending data to the\nbackend, either NONE or PROXY_V1. The default\nis NONE.", + "enum": [ + "NONE", + "PROXY_V1" ], - "request": { - "$ref": "TargetPoolsRemoveHealthCheckRequest" + "enumDescriptions": [ + "", + "" + ], + "type": "string" + }, + "region": { + "description": "Output only. [Output Only] URL of the region where the regional TCP proxy resides.\nThis field is not applicable to global TCP proxy.", + "readOnly": true, + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" + }, + "service": { + "description": "URL to the BackendService resource.", + "type": "string" + } + }, + "type": "object" + }, + "TargetTcpProxyAggregatedList": { + "id": "TargetTcpProxyAggregatedList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "additionalProperties": { + "$ref": "TargetTcpProxiesScopedList", + "description": "Name of the scope containing this set of TargetTcpProxies." }, - "response": { - "$ref": "Operation" + "description": "A list of TargetTcpProxiesScopedList resources.", + "type": "object" + }, + "kind": { + "default": "compute#targetTcpProxyAggregatedList", + "description": "Output only. [Output Only] Type of resource. Alwayscompute#targetTcpProxyAggregatedList for lists of Target\nTCP Proxies.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "unreachables": { + "description": "Output only. [Output Only] Unreachable resources.", + "items": { + "type": "string" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Removes health check URL from a target pool." + "readOnly": true, + "type": "array" }, - "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", + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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, + "data": { + "description": "[Output Only] Metadata about this warning in key:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" + }, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project", - "region", - "targetPool" - ], - "request": { - "$ref": "TargetPoolsAddInstanceRequest" - }, - "response": { - "$ref": "Operation" + "type": "object" + } + }, + "type": "object" + }, + "TargetTcpProxyList": { + "description": "Contains a list of TargetTcpProxy resources.", + "id": "TargetTcpProxyList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of TargetTcpProxy resources.", + "items": { + "$ref": "TargetTcpProxy" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Adds an instance to a target pool." + "type": "array" }, - "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, + "kind": { + "default": "compute#targetTcpProxyList", + "description": "Output only. Type of resource.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "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." + "type": "object" + } + }, + "type": "object" + }, + "TargetVpnGateway": { + "description": "Represents a Target VPN Gateway resource.\n\nThe target VPN gateway resource represents a Classic Cloud VPN gateway.\nFor more information, read thethe\nCloud VPN Overview.", + "id": "TargetVpnGateway", + "properties": { + "creationTimestamp": { + "description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", + "readOnly": true, + "type": "string" }, - "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" - } + "description": { + "description": "An optional description of this resource. Provide this property when you\ncreate the resource.", + "type": "string" + }, + "forwardingRules": { + "description": "[Output Only] A list of URLs to the ForwardingRule resources.\nForwardingRules are created usingcompute.forwardingRules.insert and associated with a VPN\ngateway.", + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "region", - "targetPool" - ], - "request": { - "$ref": "TargetReference" + "type": "array" + }, + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "format": "uint64", + "type": "string" + }, + "kind": { + "default": "compute#targetVpnGateway", + "description": "Output only. [Output Only] Type of resource. Alwayscompute#targetVpnGateway for target VPN gateways.", + "readOnly": true, + "type": "string" + }, + "labelFingerprint": { + "description": "A fingerprint for the labels being applied to this TargetVpnGateway, which\nis essentially a hash of the labels set used for optimistic locking. The\nfingerprint is initially generated by Compute Engine and changes after\nevery request to modify or update labels. You must always provide an\nup-to-date fingerprint hash in order to update or change labels,\notherwise the request will fail with error412 conditionNotMet.\n\nTo see the latest fingerprint, make a get() request to\nretrieve a TargetVpnGateway.", + "format": "byte", + "type": "string" + }, + "labels": { + "additionalProperties": { + "type": "string" }, - "response": { - "$ref": "Operation" + "description": "Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035.\nLabel values may be empty.", + "type": "object" + }, + "name": { + "annotations": { + "required": [ + "compute.targetVpnGateways.insert" + ] }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Changes a backup target pool's configurations." + "description": "Name of the resource. Provided by the client when the resource is created.\nThe name must be 1-63 characters long, and comply withRFC1035.\nSpecifically, the name must be 1-63 characters long and match the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first\ncharacter must be a lowercase letter, and all following characters must\nbe a dash, lowercase letter, or digit, except the last character, which\ncannot be a dash.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "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" - } + "network": { + "annotations": { + "required": [ + "compute.targetVpnGateways.insert" + ] }, - "parameterOrder": [ - "project", - "region", - "targetPool" + "description": "URL of the network to which this VPN gateway is attached. Provided by the\nclient when the VPN gateway is created.", + "type": "string" + }, + "params": { + "$ref": "TargetVpnGatewayParams", + "description": "Input only. [Input Only] Additional params passed with the request, but not persisted\nas part of resource payload." + }, + "region": { + "description": "[Output Only] URL of the region where the target VPN gateway resides.\nYou must specify this field as part of the HTTP request URL. It is\nnot settable as a field in the request body.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" + }, + "status": { + "description": "[Output Only] The status of the VPN gateway,\nwhich can be one of the following: CREATING, READY, FAILED, or DELETING.", + "enum": [ + "CREATING", + "DELETING", + "FAILED", + "READY" ], - "request": { - "$ref": "SecurityPolicyReference" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "", + "", + "", + "" ], - "description": "Sets the Google Cloud Armor security policy for the specified target pool. For more information, see Google Cloud Armor Overview" + "type": "string" + }, + "tunnels": { + "description": "[Output Only] A list of URLs to VpnTunnel resources. VpnTunnels are\ncreated using the compute.vpntunnels.insert method and\nassociated with a VPN gateway.", + "items": { + "type": "string" + }, + "type": "array" } - } + }, + "type": "object" }, - "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" - } + "TargetVpnGatewayAggregatedList": { + "id": "TargetVpnGatewayAggregatedList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "additionalProperties": { + "$ref": "TargetVpnGatewaysScopedList", + "description": "[Output Only] Name of the scope containing this set of target VPN gateways." }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "TargetSslProxyList" + "description": "A list of TargetVpnGateway resources.", + "type": "object" + }, + "kind": { + "default": "compute#targetVpnGatewayAggregatedList", + "description": "Output only. [Output Only] Type of resource. Alwayscompute#targetVpnGateway for target VPN gateways.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "unreachables": { + "description": "Output only. [Output Only] Unreachable resources.", + "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 the list of TargetSslProxy resources available to the specified project." + "readOnly": true, + "type": "array" }, - "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, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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" + "data": { + "description": "[Output Only] Metadata about this warning in key:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. 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" } }, - "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." + "type": "object" + } + }, + "type": "object" + }, + "TargetVpnGatewayList": { + "description": "Contains a list of TargetVpnGateway resources.", + "id": "TargetVpnGatewayList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "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" + "items": { + "description": "A list of TargetVpnGateway resources.", + "items": { + "$ref": "TargetVpnGateway" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified TargetSslProxy resource." + "type": "array" }, - "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, + "kind": { + "default": "compute#targetVpnGatewayList", + "description": "Output only. [Output Only] Type of resource. Alwayscompute#targetVpnGateway for target VPN gateways.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project", - "targetSslProxy" - ], - "request": { - "$ref": "TargetSslProxiesSetBackendServiceRequest" + "type": "object" + } + }, + "type": "object" + }, + "TargetVpnGatewayParams": { + "id": "TargetVpnGatewayParams", + "properties": { + "resourceManagerTags": { + "additionalProperties": { + "type": "string" }, - "response": { - "$ref": "Operation" + "description": "Tag keys/values directly bound to this resource.\nTag keys and values have the same definition as resource\nmanager tags. The field is allowed for INSERT\nonly. The keys/values to set on the resource should be specified in\neither ID { : } or Namespaced format\n{ : }.\nFor example the following are valid inputs:\n* {\"tagKeys/333\" : \"tagValues/444\", \"tagKeys/123\" : \"tagValues/456\"}\n* {\"123/environment\" : \"production\", \"345/abc\" : \"xyz\"}\nNote:\n* Invalid combinations of ID & namespaced format is not supported. For\n instance: {\"123/environment\" : \"tagValues/444\"} is invalid.\n* Inconsistent format is not supported. For instance:\n {\"tagKeys/333\" : \"tagValues/444\", \"123/env\" : \"prod\"} is invalid.", + "type": "object" + } + }, + "type": "object" + }, + "TargetVpnGatewaysScopedList": { + "id": "TargetVpnGatewaysScopedList", + "properties": { + "targetVpnGateways": { + "description": "[Output Only] A list of target VPN gateways contained in this scope.", + "items": { + "$ref": "TargetVpnGateway" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Changes the BackendService for TargetSslProxy." + "type": "array" }, - "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, + "warning": { + "description": "[Output Only] Informational warning which replaces the list of addresses\nwhen the list is empty.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project", - "targetSslProxy" - ], - "request": { - "$ref": "TargetSslProxiesSetSslCertificatesRequest" + "type": "object" + } + }, + "type": "object" + }, + "TestFailure": { + "id": "TestFailure", + "properties": { + "actualOutputUrl": { + "description": "The actual output URL evaluated by a load balancer containing the scheme,\nhost, path and query parameters.", + "type": "string" + }, + "actualRedirectResponseCode": { + "description": "Actual HTTP status code for rule with `urlRedirect`\ncalculated by load balancer", + "format": "int32", + "type": "integer" + }, + "actualService": { + "description": "BackendService or BackendBucket returned by load\nbalancer.", + "type": "string" + }, + "expectedOutputUrl": { + "description": "The expected output URL evaluated by a load balancer containing the scheme,\nhost, path and query parameters.", + "type": "string" + }, + "expectedRedirectResponseCode": { + "description": "Expected HTTP status code for rule with `urlRedirect`\ncalculated by load balancer", + "format": "int32", + "type": "integer" + }, + "expectedService": { + "description": "Expected BackendService or BackendBucket resource\nthe given URL should be mapped to.", + "type": "string" + }, + "headers": { + "description": "HTTP headers of the request.", + "items": { + "$ref": "UrlMapTestHeader" }, - "response": { - "$ref": "Operation" + "type": "array" + }, + "host": { + "description": "Host portion of the URL.", + "type": "string" + }, + "path": { + "description": "Path portion including query parameters in the URL.", + "type": "string" + } + }, + "type": "object" + }, + "TestPermissionsRequest": { + "id": "TestPermissionsRequest", + "properties": { + "permissions": { + "description": "The set of permissions to check for the 'resource'. Permissions with\nwildcards (such as '*' or 'storage.*') are not allowed.", + "items": { + "type": "string" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Changes SslCertificates for TargetSslProxy." + "type": "array" + } + }, + "type": "object" + }, + "TestPermissionsResponse": { + "id": "TestPermissionsResponse", + "properties": { + "permissions": { + "description": "A subset of `TestPermissionsRequest.permissions` that the caller is\nallowed.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, + "TimeZone": { + "description": "Represents a time zone from the\n[IANA Time Zone Database](https://www.iana.org/time-zones).", + "id": "TimeZone", + "properties": { + "id": { + "description": "IANA Time Zone Database time zone. For example \"America/New_York\".", + "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" - } + "version": { + "description": "Optional. IANA Time Zone Database version number. For example \"2019a\".", + "type": "string" + } + }, + "type": "object" + }, + "Uint128": { + "id": "Uint128", + "properties": { + "high": { + "format": "uint64", + "type": "string" + }, + "low": { + "format": "uint64", + "type": "string" + } + }, + "type": "object" + }, + "UpcomingMaintenance": { + "description": "Upcoming Maintenance notification information.", + "id": "UpcomingMaintenance", + "properties": { + "canReschedule": { + "description": "Indicates if the maintenance can be customer triggered.", + "type": "boolean" + }, + "latestWindowStartTime": { + "description": "The latest time for the planned maintenance window to start.\nThis timestamp value is in RFC3339 text format.", + "type": "string" + }, + "maintenanceOnShutdown": { + "description": "Indicates whether the UpcomingMaintenance will be triggered on VM shutdown.", + "type": "boolean" + }, + "maintenanceReasons": { + "description": "The reasons for the maintenance. Only valid for vms.", + "items": { + "enum": [ + "FAILURE_DISK", + "FAILURE_GPU", + "FAILURE_GPU_MULTIPLE_FAULTY_HOSTS_CUSTOMER_REPORTED", + "FAILURE_GPU_NVLINK_SWITCH_CUSTOMER_REPORTED", + "FAILURE_GPU_TEMPERATURE", + "FAILURE_GPU_XID", + "FAILURE_INFRA", + "FAILURE_INTERFACE", + "FAILURE_MEMORY", + "FAILURE_NETWORK", + "FAILURE_NVLINK", + "FAILURE_REDUNDANT_HARDWARE_FAULT", + "FAILURE_TPU", + "INFRASTRUCTURE_RELOCATION", + "MAINTENANCE_REASON_UNKNOWN", + "PLANNED_NETWORK_UPDATE", + "PLANNED_UPDATE" + ], + "enumDescriptions": [ + "Maintenance due to disk errors.", + "Maintenance due to GPU errors.", + "Maintenance due to customer reported multiple faulty hosts via R&R\nSubblock API.", + "Maintenance due to customer reported NVLink switch failure via R&R\nSubblock API.", + "Maintenance due to high GPU temperature.", + "Maintenance due to GPU xid failure.", + "Maintenance due to infrastructure errors.", + "Maintenance due to interface errors.", + "Maintenance due to memory errors.", + "Maintenance due to network errors.", + "Maintenance due to NVLink failure.", + "Maintenance due to redundant hardware fault.", + "Maintenance due to TPU errors.", + "Maintenance due to infrastructure relocation.", + "Unknown maintenance reason. Do not use this value.", + "Maintenance due to planned network update.", + "Maintenance due to planned update to the instance." + ], + "type": "string" }, - "parameterOrder": [ - "project", - "targetSslProxy" + "type": "array" + }, + "maintenanceStatus": { + "enum": [ + "ONGOING", + "PENDING", + "UNKNOWN" ], - "request": { - "$ref": "TargetSslProxiesSetCertificateMapRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "There is ongoing maintenance on this VM.", + "There is pending maintenance.", + "Unknown maintenance status. Do not use this value." ], - "description": "Changes the Certificate Map for TargetSslProxy." + "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" + "type": { + "description": "Defines the type of maintenance.", + "enum": [ + "MULTIPLE", + "SCHEDULED", + "UNKNOWN_TYPE", + "UNSCHEDULED" ], - "request": { - "$ref": "TargetSslProxiesSetProxyHeaderRequest" + "enumDescriptions": [ + "Multiple maintenance types in one window.\nThis is only intended to be used for groups.", + "Scheduled maintenance (e.g. maintenance after uptime guarantee is\ncomplete).", + "No type specified. Do not use this value.", + "Unscheduled maintenance (e.g. emergency maintenance during\nuptime guarantee)." + ], + "type": "string" + }, + "windowEndTime": { + "description": "The time by which the maintenance disruption will be completed.\nThis timestamp value is in RFC3339 text format.", + "type": "string" + }, + "windowStartTime": { + "description": "The current start time of the maintenance window.\nThis timestamp value is in RFC3339 text format.", + "type": "string" + } + }, + "type": "object" + }, + "UrlMap": { + "description": "Represents a URL Map resource.\n\nCompute Engine has two URL Map resources:\n\n* [Global](/compute/docs/reference/rest/v1/urlMaps)\n* [Regional](/compute/docs/reference/rest/v1/regionUrlMaps)\n\nA URL map resource is a component of certain types of cloud load balancers\nand Traffic Director:\n\n* urlMaps are used by global external Application Load\nBalancers, classic Application Load Balancers, and cross-region internal\nApplication Load Balancers.\n* regionUrlMaps are used by internal Application Load Balancers,\nregional external Application Load Balancers and regional internal\nApplication Load Balancers.\n\nFor a list of supported URL map features by the load balancer type, see the\nLoad balancing features: Routing and traffic management table.\n\nFor a list of supported URL map features for Traffic Director, see the\nTraffic Director features: Routing and traffic management table.\n\nThis resource defines mappings from hostnames and URL paths to either a\nbackend service or a backend bucket.\n\nTo use the global urlMaps resource, the backend service must\nhave a loadBalancingScheme of either EXTERNAL,EXTERNAL_MANAGED, or INTERNAL_SELF_MANAGED. To use\nthe regionUrlMaps resource, the backend service must have aloadBalancingScheme of INTERNAL_MANAGED. For more\ninformation, read URL\nMap Concepts.", + "id": "UrlMap", + "properties": { + "creationTimestamp": { + "description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", + "readOnly": true, + "type": "string" + }, + "defaultCustomErrorResponsePolicy": { + "$ref": "CustomErrorResponsePolicy", + "description": "defaultCustomErrorResponsePolicy specifies how the Load\nBalancer returns error responses when BackendServiceorBackendBucket responds with an error. \n\nThis policy takes\neffect at the load balancer level and applies only when no policy has been\ndefined for the error code at lower levels like PathMatcher, RouteRule and\nPathRule within this UrlMap. \n\nFor example, consider a UrlMap with the\nfollowing configuration:\n \n \n - defaultCustomErrorResponsePolicy containing policies for\n responding to 5xx and 4xx errors\n - A PathMatcher configured for *.example.com has\n defaultCustomErrorResponsePolicy for 4xx.\n\nIf a request for http://www.example.com/ encounters a404, the policy inpathMatcher.defaultCustomErrorResponsePolicy will be enforced.\nWhen the request for http://www.example.com/ encounters a502, the policy inUrlMap.defaultCustomErrorResponsePolicy will be enforced. When\na request that does not match any host in *.example.com such\nas http://www.myotherexample.com/, encounters a404, UrlMap.defaultCustomErrorResponsePolicy\ntakes effect. \n\nWhen used in conjunction withdefaultRouteAction.retryPolicy, retries take precedence. Only\nonce all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting\na retry, if load balancer is successful in reaching the\nservice, the defaultCustomErrorResponsePolicy is ignored and\nthe response from the service is returned to the client.\n\ndefaultCustomErrorResponsePolicy is supported only for\nglobal external Application Load Balancers." + }, + "defaultRouteAction": { + "$ref": "HttpRouteAction", + "description": "defaultRouteAction takes effect when none of the \nhostRules match. The load balancer performs advanced routing\nactions, such as URL rewrites and header transformations, before forwarding\nthe request to the selected backend.\n\n\nOnly one of defaultUrlRedirect, defaultService\nor defaultRouteAction.weightedBackendService can be set.\n\n\n URL maps for classic Application Load Balancers only support\nthe urlRewrite action within defaultRouteAction.\n\n\ndefaultRouteAction has no effect when the URL map is bound\nto a target gRPC proxy that has the validateForProxyless field\nset to true." + }, + "defaultService": { + "description": "The full or partial URL of the defaultService resource to\nwhich traffic is directed if none of the hostRules match.\nIf defaultRouteAction is also specified, advanced\nrouting actions, such as URL rewrites, take effect before sending the\nrequest to the backend.\n\n\nOnly one of defaultUrlRedirect, defaultService\nor defaultRouteAction.weightedBackendService can be set.\n\n\ndefaultService has no effect when the URL map is bound\nto a target gRPC proxy that has the validateForProxyless field\nset to true.", + "type": "string" + }, + "defaultUrlRedirect": { + "$ref": "HttpRedirectAction", + "description": "When none of the specified hostRules match, the request\nis redirected to a URL specified by defaultUrlRedirect.\n\n\nOnly one of defaultUrlRedirect, defaultService\nor defaultRouteAction.weightedBackendService can be set.\n\n\nNot supported when the URL map is bound to a target gRPC proxy." + }, + "description": { + "description": "An optional description of this resource. Provide this property when you\ncreate the resource.", + "type": "string" + }, + "fingerprint": { + "description": "Fingerprint of this resource. A hash of the contents stored in this object.\nThis field is used in optimistic locking. This field is ignored when\ninserting a UrlMap. An up-to-date fingerprint must be provided\nin order to update the UrlMap, otherwise the request will\nfail with error 412 conditionNotMet.\n\nTo see the latest fingerprint, make a get() request to\nretrieve a UrlMap.", + "format": "byte", + "type": "string" + }, + "headerAction": { + "$ref": "HttpHeaderAction", + "description": "Specifies changes to request and response headers that need to take effect\nfor the selected backendService.\n\nThe headerAction specified here take effect afterheaderAction specified under pathMatcher.\n\nheaderAction is not supported for load balancers\nthat have\ntheir loadBalancingScheme set to EXTERNAL.\n\nNot supported when the URL map is bound to a target gRPC proxy that\nhas validateForProxyless field set to true." + }, + "hostRules": { + "description": "The list of host rules to use against the URL.", + "items": { + "$ref": "HostRule" }, - "response": { - "$ref": "Operation" + "type": "array" + }, + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "format": "uint64", + "type": "string" + }, + "kind": { + "default": "compute#urlMap", + "description": "Output only. [Output Only] Type of the resource. Always compute#urlMaps for\nurl maps.", + "readOnly": true, + "type": "string" + }, + "name": { + "description": "Name of the resource. Provided by the client when the resource is created.\nThe name must be 1-63 characters long, and comply withRFC1035.\nSpecifically, the name must be 1-63 characters long and match the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first\ncharacter must be a lowercase letter, and all following characters must\nbe a dash, lowercase letter, or digit, except the last character, which\ncannot be a dash.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "pathMatchers": { + "description": "The list of named PathMatchers to use against the URL.", + "items": { + "$ref": "PathMatcher" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Changes the ProxyHeaderType for TargetSslProxy." + "type": "array" }, - "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, + "region": { + "description": "Output only. [Output Only] URL of the region where the regional URL map resides.\nThis field is not applicable to global URL maps.\nYou must specify this field as part of the HTTP request URL. It is\nnot settable as a field in the request body.", + "readOnly": true, + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" + }, + "tests": { + "description": "The list of expected URL mapping tests. Request to update theUrlMap succeeds only if all test cases pass. You can specify a\nmaximum of 100 tests per UrlMap.\n\nNot supported when the URL map is bound to a target gRPC proxy that\nhas validateForProxyless field set to true.", + "items": { + "$ref": "UrlMapTest" + }, + "type": "array" + } + }, + "type": "object" + }, + "UrlMapList": { + "description": "Contains a list of UrlMap resources.", + "id": "UrlMapList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of UrlMap resources.", + "items": { + "$ref": "UrlMap" + }, + "type": "array" + }, + "kind": { + "default": "compute#urlMapList", + "description": "Output only. Type of resource.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project", - "targetSslProxy" - ], - "request": { - "$ref": "SslPolicyReference" + "type": "object" + } + }, + "type": "object" + }, + "UrlMapReference": { + "id": "UrlMapReference", + "properties": { + "urlMap": { + "type": "string" + } + }, + "type": "object" + }, + "UrlMapTest": { + "description": "Message for the expected URL mappings.", + "id": "UrlMapTest", + "properties": { + "description": { + "description": "Description of this test case.", + "type": "string" + }, + "expectedOutputUrl": { + "description": "The expected output URL evaluated by the load balancer\ncontaining the scheme, host, path and query parameters.\n\nFor rules that forward requests to backends, the test passes only whenexpectedOutputUrl matches the request forwarded by\nthe load balancer to backends. For rules with urlRewrite,\nthe test verifies that the forwarded request matcheshostRewrite and pathPrefixRewrite in theurlRewrite action. When service is specified,expectedOutputUrl`s scheme is ignored.\n\nFor rules with urlRedirect, the test passes only ifexpectedOutputUrl matches the URL in the load balancer's\nredirect response. If urlRedirect specifieshttps_redirect, the test passes only if the scheme inexpectedOutputUrl is also set to HTTPS.\nIf urlRedirect specifies strip_query, the test\npasses only if expectedOutputUrl does not contain any query\nparameters. \n\nexpectedOutputUrl is optional whenservice is specified.", + "type": "string" + }, + "expectedRedirectResponseCode": { + "description": "For rules with urlRedirect, the test passes only ifexpectedRedirectResponseCode matches the HTTP status code in\nload balancer's redirect response.\n\nexpectedRedirectResponseCode cannot be set whenservice is set.", + "format": "int32", + "type": "integer" + }, + "headers": { + "description": "HTTP headers for this request. If headers contains\na host header, then host must also match the header value.", + "items": { + "$ref": "UrlMapTestHeader" }, - "response": { - "$ref": "Operation" + "type": "array" + }, + "host": { + "description": "Host portion of the URL. If headers contains a host header,\nthen host must also match the header value.", + "type": "string" + }, + "path": { + "description": "Path portion of the URL.", + "type": "string" + }, + "service": { + "description": "Expected BackendService or BackendBucket resource\nthe given URL should be mapped to. \n\nThe service field cannot\nbe set if expectedRedirectResponseCode is set.", + "type": "string" + } + }, + "type": "object" + }, + "UrlMapTestHeader": { + "description": "HTTP headers used in UrlMapTests.", + "id": "UrlMapTestHeader", + "properties": { + "name": { + "description": "Header name.", + "type": "string" + }, + "value": { + "description": "Header value.", + "type": "string" + } + }, + "type": "object" + }, + "UrlMapValidationResult": { + "description": "Message representing the validation result for a UrlMap.", + "id": "UrlMapValidationResult", + "properties": { + "loadErrors": { + "items": { + "type": "string" }, - "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." + "type": "array" + }, + "loadSucceeded": { + "description": "Whether the given UrlMap can be successfully loaded.\nIf false, 'loadErrors' indicates the reasons.", + "type": "boolean" + }, + "testFailures": { + "items": { + "$ref": "TestFailure" + }, + "type": "array" + }, + "testPassed": { + "description": "If successfully loaded, this field indicates whether the test passed.\nIf false, 'testFailures's indicate the reason of failure.", + "type": "boolean" } - } + }, + "type": "object" }, - "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" - } + "UrlMapsAggregatedList": { + "id": "UrlMapsAggregatedList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "additionalProperties": { + "$ref": "UrlMapsScopedList", + "description": "Name of the scope containing this set of UrlMaps." }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "TargetTcpProxyList" + "description": "A list of UrlMapsScopedList resources.", + "type": "object" + }, + "kind": { + "default": "compute#urlMapsAggregatedList", + "description": "Output only. Type of resource.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "unreachables": { + "description": "Output only. [Output Only] Unreachable resources.", + "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 the list of TargetTcpProxy resources available to the specified project." + "readOnly": true, + "type": "array" }, - "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", + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "pageToken": { - "description": "Specifies a page token 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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" } }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "TargetTcpProxyAggregatedList" + "type": "object" + } + }, + "type": "object" + }, + "UrlMapsScopedList": { + "id": "UrlMapsScopedList", + "properties": { + "urlMaps": { + "description": "A list of UrlMaps contained in this scope.", + "items": { + "$ref": "UrlMap" }, - "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`." + "type": "array" }, - "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, + "warning": { + "description": "Informational warning which replaces the list of\nbackend services when the list is empty.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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, + "data": { + "description": "[Output Only] Metadata about this warning in key:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" + }, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project", - "targetTcpProxy" - ], - "response": { - "$ref": "TargetTcpProxy" + "type": "object" + } + }, + "type": "object" + }, + "UrlMapsValidateRequest": { + "id": "UrlMapsValidateRequest", + "properties": { + "loadBalancingSchemes": { + "description": "Specifies the load balancer type(s) this validation request is for. UseEXTERNAL_MANAGED for global external Application Load\nBalancers and regional external Application Load Balancers.\nUse EXTERNAL for classic Application Load Balancers.\n\nUse INTERNAL_MANAGED for internal Application Load Balancers. For more\ninformation, refer to Choosing\na load balancer.\n\nIf unspecified, the load balancing scheme will be inferred from the backend\nservice resources this URL map references. If that can not be inferred (for\nexample, this URL map only references backend buckets, or this Url map is\nfor rewrites and redirects only and doesn't reference any backends),EXTERNAL will be used as the default type.\n\nIf specified, the scheme(s) must not conflict with the load balancing\nscheme of the backend service resources this Url map references.", + "items": { + "enum": [ + "EXTERNAL", + "EXTERNAL_MANAGED", + "LOAD_BALANCING_SCHEME_UNSPECIFIED" + ], + "enumDescriptions": [ + "Signifies that this will be used for classic Application Load Balancers.", + "Signifies that this will be used for Envoy-based global external\nApplication Load Balancers.", + "If unspecified, the validation will try to infer the scheme from the\nbackend service resources this Url map references. If the inference is not\npossible, EXTERNAL will be used as the default type." + ], + "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 TargetTcpProxy resource." + "type": "array" }, - "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" + "resource": { + "$ref": "UrlMap", + "description": "Content of the UrlMap to be validated." + } + }, + "type": "object" + }, + "UrlMapsValidateResponse": { + "id": "UrlMapsValidateResponse", + "properties": { + "result": { + "$ref": "UrlMapValidationResult" + } + }, + "type": "object" + }, + "UrlRewrite": { + "description": "The spec for modifying the path before sending the request to the matched\nbackend service.", + "id": "UrlRewrite", + "properties": { + "hostRewrite": { + "description": "Before forwarding the request to the selected service, the request's\nhost header is replaced with contents of hostRewrite.\n\nThe value must be from 1 to 255 characters.", + "type": "string" + }, + "pathPrefixRewrite": { + "description": "Before forwarding the request to the selected backend service, the\nmatching portion of the request's path is replaced bypathPrefixRewrite.\n\nThe value must be from 1 to 1024 characters.", + "type": "string" + }, + "pathTemplateRewrite": { + "description": "If specified, the pattern rewrites the URL path (based on the :path\nheader) using the HTTP template syntax. \n\nA corresponding\npath_template_match must be specified. Any template variables must exist in\nthe path_template_match field. \n \n \n - -At least one variable must be specified in the path_template_match\n field \n - You can omit variables from the rewritten URL\n - The * and ** operators cannot be matched\n unless they have a corresponding variable name - e.g.\n {format=*} or {var=**}.\n\nFor example, a path_template_match of /static/{format=**}\ncould be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a\nrewrite, so that /{country}/{format}/{suffix=**} can be\nrewritten as /content/{format}/{country}/{suffix}. \n\nAt least\none non-empty routeRules[].matchRules[].path_template_match is\nrequired. \n\nOnly one of path_prefix_rewrite orpath_template_rewrite may be specified.", + "type": "string" + }, + "regexRewrite": { + "$ref": "RegexRewrite", + "description": "The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified." + } + }, + "type": "object" + }, + "UsableSubnetwork": { + "description": "Subnetwork which the current user has compute.subnetworks.use permission on.", + "id": "UsableSubnetwork", + "properties": { + "externalIpv6Prefix": { + "description": "Output only. [Output Only] The external IPv6 address range that is assigned to this\nsubnetwork.", + "readOnly": true, + "type": "string" + }, + "internalIpv6Prefix": { + "description": "Output only. [Output Only] The internal IPv6 address range that is assigned to this\nsubnetwork.", + "readOnly": true, + "type": "string" + }, + "ipCidrRange": { + "description": "The range of internal addresses that are owned by this subnetwork.", + "type": "string" + }, + "ipv6AccessType": { + "description": "The access type of IPv6 address this subnet holds. It's immutable and can\nonly be specified during creation or the first time the subnet is updated\ninto IPV4_IPV6 dual stack.", + "enum": [ + "EXTERNAL", + "INTERNAL" ], - "request": { - "$ref": "TargetTcpProxy" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "VMs on this subnet will be assigned IPv6 addresses that are accessible\nvia the Internet, as well as the VPC network.", + "VMs on this subnet will be assigned IPv6 addresses that are only\naccessible over the VPC network." ], - "description": "Creates a TargetTcpProxy resource in the specified project using the data included in the request." + "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" + "network": { + "description": "Network URL.", + "type": "string" + }, + "purpose": { + "enum": [ + "GLOBAL_MANAGED_PROXY", + "INTERNAL_HTTPS_LOAD_BALANCER", + "PEER_MIGRATION", + "PRIVATE", + "PRIVATE_NAT", + "PRIVATE_RFC_1918", + "PRIVATE_SERVICE_CONNECT", + "REGIONAL_MANAGED_PROXY" ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "Subnet reserved for Global Envoy-based Load Balancing.", + "Subnet reserved for Internal HTTP(S) Load Balancing. This is a legacy\npurpose, please use REGIONAL_MANAGED_PROXY instead.", + "Subnetwork will be used for Migration from one peered VPC to another.\n(a transient state of subnetwork\nwhile migrating resources from one project to another).", + "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." ], - "description": "Deletes the specified TargetTcpProxy resource." + "type": "string" }, - "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" + "role": { + "description": "The role of subnetwork. Currently, this field is only used when\npurpose is set to GLOBAL_MANAGED_PROXY orREGIONAL_MANAGED_PROXY. The value can be set toACTIVE or BACKUP. An ACTIVE\nsubnetwork is one that is currently being used for Envoy-based load\nbalancers in a region. A BACKUP subnetwork is one that is\nready to be promoted to ACTIVE or is currently draining.\nThis field can be updated with a patch request.", + "enum": [ + "ACTIVE", + "BACKUP" ], - "request": { - "$ref": "TargetTcpProxiesSetBackendServiceRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "The ACTIVE subnet that is currently used.", + "The BACKUP subnet that could be promoted to ACTIVE." ], - "description": "Changes the BackendService for TargetTcpProxy." + "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" - } + "secondaryIpRanges": { + "description": "Secondary IP ranges.", + "items": { + "$ref": "UsableSubnetworkSecondaryRange" }, - "parameterOrder": [ - "project", - "targetTcpProxy" + "type": "array" + }, + "stackType": { + "description": "The stack type for the subnet. If set to IPV4_ONLY, new VMs\nin the subnet are assigned IPv4 addresses only. If set toIPV4_IPV6, new VMs in the subnet can be assigned both IPv4 and\nIPv6 addresses. If not specified, IPV4_ONLY is used.\n\nThis field can be both set at resource creation time and updated usingpatch.", + "enum": [ + "IPV4_IPV6", + "IPV4_ONLY", + "IPV6_ONLY" ], - "request": { - "$ref": "TargetTcpProxiesSetProxyHeaderRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "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": "Changes the ProxyHeaderType for TargetTcpProxy." + "type": "string" + }, + "subnetwork": { + "description": "Subnetwork URL.", + "type": "string" } - } + }, + "type": "object" }, - "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" + "UsableSubnetworkSecondaryRange": { + "description": "Secondary IP range of a usable subnetwork.", + "id": "UsableSubnetworkSecondaryRange", + "properties": { + "ipCidrRange": { + "description": "The range of IP addresses belonging to this subnetwork secondary range.\nCan be Ipv4 or Ipv6 range.", + "type": "string" + }, + "rangeName": { + "description": "The name associated with this subnetwork secondary range, used when adding\nan alias IP range to a VM instance.\nThe name must be 1-63 characters long, and comply withRFC1035.\nThe name must be unique within the subnetwork.", + "type": "string" + } + }, + "type": "object" + }, + "UsableSubnetworksAggregatedList": { + "id": "UsableSubnetworksAggregatedList", + "properties": { + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "type": "string" + }, + "items": { + "description": "[Output] A list of usable subnetwork URLs.", + "items": { + "$ref": "UsableSubnetwork" }, - "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." + "type": "array" }, - "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" - } + "kind": { + "default": "compute#usableSubnetworksAggregatedList", + "description": "Output only. [Output Only] Type of resource. Alwayscompute#usableSubnetworksAggregatedList for aggregated lists\nof usable subnetworks.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.\nIn special cases listUsable may return 0 subnetworks andnextPageToken which still should be used to get the\nnext page of results.", + "type": "string" + }, + "scopedWarnings": { + "description": "Output only. [Output Only] Informational warning messages for failures encountered from\nscopes.", + "items": { + "$ref": "SubnetworksScopedWarning" }, - "parameterOrder": [ - "project", - "region", - "targetTcpProxy" - ], - "response": { - "$ref": "TargetTcpProxy" + "readOnly": true, + "type": "array" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "unreachables": { + "description": "Output only. [Output Only] Unreachable resources.", + "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": "Returns the specified TargetTcpProxy resource." + "readOnly": true, + "type": "array" }, - "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, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. 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" } }, - "parameterOrder": [ - "project", - "region" - ], - "request": { - "$ref": "TargetTcpProxy" + "type": "object" + } + }, + "type": "object" + }, + "UsageExportLocation": { + "description": "The location in Cloud Storage and naming method of the daily usage\nreport. Contains bucket_name and report_name prefix.", + "id": "UsageExportLocation", + "properties": { + "bucketName": { + "description": "The name of an existing bucket in Cloud Storage where the usage report\nobject is stored. The Google Service Account is granted write access to\nthis bucket. This can either be the bucket name by itself, such asexample-bucket, or the bucket name with gs://\nor https://storage.googleapis.com/ in front of it, such\nas gs://example-bucket.", + "type": "string" + }, + "reportNamePrefix": { + "description": "An optional prefix for the name of the usage report object stored inbucketName. If not supplied, defaults tousage_gce. The report is stored as a CSV file namedreport_name_prefix_gce_YYYYMMDD.csv whereYYYYMMDD is the day of the usage according to Pacific Time.\nIf you supply a prefix, it should conform to Cloud Storageobject naming\nconventions.", + "type": "string" + } + }, + "type": "object" + }, + "VmEndpointNatMappings": { + "description": "Contain information of Nat mapping for a VM endpoint (i.e., NIC).", + "id": "VmEndpointNatMappings", + "properties": { + "instanceName": { + "description": "Output only. Name of the VM instance which the endpoint belongs to", + "readOnly": true, + "type": "string" + }, + "interfaceNatMappings": { + "items": { + "$ref": "VmEndpointNatMappingsInterfaceNatMappings" }, - "response": { - "$ref": "Operation" + "readOnly": true, + "type": "array" + } + }, + "type": "object" + }, + "VmEndpointNatMappingsInterfaceNatMappings": { + "description": "Contain information of Nat mapping for an interface of this endpoint.", + "id": "VmEndpointNatMappingsInterfaceNatMappings", + "properties": { + "drainNatIpPortRanges": { + "description": "Output only. List of all drain IP:port-range mappings assigned to this interface.\nThese ranges are inclusive, that is, both the first and the last\nports can be used for NAT. Example: [\"2.2.2.2:12345-12355\",\n\"1.1.1.1:2234-2234\"].", + "items": { + "type": "string" }, - "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." + "readOnly": true, + "type": "array" }, - "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" - } + "natIpPortRanges": { + "description": "Output only. A list of all IP:port-range mappings assigned to this interface.\nThese ranges are inclusive, that is, both the first and the last\nports can be used for NAT. Example: [\"2.2.2.2:12345-12355\",\n\"1.1.1.1:2234-2234\"].", + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "region", - "targetTcpProxy" - ], - "response": { - "$ref": "Operation" + "readOnly": true, + "type": "array" + }, + "numTotalDrainNatPorts": { + "description": "Output only. Total number of drain ports across all NAT IPs allocated to this\ninterface. It equals to the aggregated port number in the field\ndrain_nat_ip_port_ranges.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "numTotalNatPorts": { + "description": "Output only. Total number of ports across all NAT IPs allocated to this interface.\nIt equals to the aggregated port number in the field nat_ip_port_ranges.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "ruleMappings": { + "description": "Output only. Information about mappings provided by rules in this NAT.", + "items": { + "$ref": "VmEndpointNatMappingsInterfaceNatMappingsNatRuleMappings" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified TargetTcpProxy resource." + "readOnly": true, + "type": "array" + }, + "sourceAliasIpRange": { + "description": "Output only. Alias IP range for this interface endpoint.\nIt will be a private (RFC 1918) IP range.\nExamples: \"10.33.4.55/32\", or \"192.168.5.0/24\".", + "readOnly": true, + "type": "string" + }, + "sourceVirtualIp": { + "description": "Output only. Primary IP of the VM for this NIC.", + "readOnly": true, + "type": "string" } - } + }, + "type": "object" }, - "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" + "VmEndpointNatMappingsInterfaceNatMappingsNatRuleMappings": { + "description": "Contains information of NAT Mappings provided by a NAT Rule.", + "id": "VmEndpointNatMappingsInterfaceNatMappingsNatRuleMappings", + "properties": { + "drainNatIpPortRanges": { + "description": "Output only. List of all drain IP:port-range mappings assigned to this interface\nby this rule.\nThese ranges are inclusive, that is, both the first and the last\nports can be used for NAT. Example: [\"2.2.2.2:12345-12355\",\n\"1.1.1.1:2234-2234\"].", + "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 target VPN gateways available to the specified project and region." + "readOnly": true, + "type": "array" }, - "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" - } + "natIpPortRanges": { + "description": "Output only. A list of all IP:port-range mappings assigned to this interface by this\nrule.\nThese ranges are inclusive, that is, both the first and the last\nports can be used for NAT. Example: [\"2.2.2.2:12345-12355\",\n\"1.1.1.1:2234-2234\"].", + "items": { + "type": "string" }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "TargetVpnGatewayAggregatedList" + "readOnly": true, + "type": "array" + }, + "numTotalDrainNatPorts": { + "description": "Output only. Total number of drain ports across all NAT IPs allocated to this\ninterface by this rule.\nIt equals the aggregated port number in the field\ndrain_nat_ip_port_ranges.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "numTotalNatPorts": { + "description": "Output only. Total number of ports across all NAT IPs allocated to this interface\nby this rule.\nIt equals the aggregated port number in the field nat_ip_port_ranges.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "ruleNumber": { + "description": "Output only. Rule number of the NAT Rule.", + "format": "int32", + "readOnly": true, + "type": "integer" + } + }, + "type": "object" + }, + "VmEndpointNatMappingsList": { + "description": "Contains a list of VmEndpointNatMappings.", + "id": "VmEndpointNatMappingsList", + "properties": { + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "type": "string" + }, + "kind": { + "default": "compute#vmEndpointNatMappingsList", + "description": "Output only. [Output Only] Type of resource. Alwayscompute#vmEndpointNatMappingsList for lists of Nat mappings of\nVM endpoints.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "result": { + "description": "[Output Only] A list of Nat mapping information of VM endpoints.", + "items": { + "$ref": "VmEndpointNatMappings" }, - "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`." + "type": "array" }, - "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, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project", - "region", - "targetVpnGateway" - ], - "response": { - "$ref": "TargetVpnGateway" + "type": "object" + } + }, + "type": "object" + }, + "VmExtensionPoliciesScopedList": { + "id": "VmExtensionPoliciesScopedList", + "properties": { + "vmExtensionPolicies": { + "description": "List of VmExtensionPolicy resources contained in this scope.", + "items": { + "$ref": "VmExtensionPolicy" }, - "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." + "type": "array" }, - "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, + "warning": { + "description": "Informational warning which replaces the list of\nbackend services when the list is empty.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. 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" } }, - "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." + "type": "object" + } + }, + "type": "object" + }, + "VmExtensionPolicy": { + "description": "Represents a VM extension policy.", + "id": "VmExtensionPolicy", + "properties": { + "creationTimestamp": { + "description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", + "readOnly": true, + "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" - } + "description": { + "description": "An optional description of this resource.", + "type": "string" + }, + "extensionPolicies": { + "additionalProperties": { + "$ref": "VmExtensionPolicyExtensionPolicy" }, - "parameterOrder": [ - "project", - "region", - "targetVpnGateway" - ], - "response": { - "$ref": "Operation" + "description": "Required. A map of extension names (for example, \"ops-agent\") to their corresponding\npolicy configurations.", + "type": "object" + }, + "globalResourceLink": { + "description": "Optional. Output only. [Output Only] Link to the global policy that manages this zone policy, if\napplicable.", + "readOnly": true, + "type": "string" + }, + "id": { + "description": "Output only. [Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "format": "uint64", + "readOnly": true, + "type": "string" + }, + "instanceSelectors": { + "description": "Optional. Selectors to target VMs for this policy. VMs are selected if they match\n*any* of the provided selectors (logical OR). If this list is empty, the\npolicy applies to all VMs.", + "items": { + "$ref": "VmExtensionPolicyInstanceSelector" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified target VPN gateway." + "type": "array" }, - "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" - } + "kind": { + "default": "compute#vmExtensionPolicy", + "description": "Output only. [Output Only] Type of the resource. Alwayscompute#vmExtensionPolicy.", + "readOnly": true, + "type": "string" + }, + "managedByGlobal": { + "description": "Optional. Output only. [Output Only] Indicates if this policy is managed by a global policy.", + "readOnly": true, + "type": "boolean" + }, + "name": { + "annotations": { + "required": [ + "compute.zoneVmExtensionPolicies.insert" + ] }, - "parameterOrder": [ - "project", - "region", - "resource" + "description": "Name of the resource. Provided by the client when the resource is created.\nThe name must be 1-63 characters long, and comply withRFC1035.\nSpecifically, the name must be 1-63 characters long and match the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?`\nwhich means the first character must be a lowercase letter, and all\nfollowing characters must be a dash, lowercase letter, or digit, except\nthe last character, which cannot be a dash.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "priority": { + "description": "Optional. Priority of this policy. Used to resolve conflicts when multiple policies\napply to the same extension.\nThe policy priority is an integer from 0 to 65535, inclusive. Lower\nintegers indicate higher priorities. If you do not specify a priority when\ncreating a rule, it is assigned a priority of 1000. If priorities are\nequal, the policy with the most recent creation timestamp takes precedence.", + "format": "int32", + "type": "integer" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined fully-qualified URL for this resource.", + "readOnly": true, + "type": "string" + }, + "selfLinkWithId": { + "description": "Output only. [Output Only] Server-defined URL for this resource's resource id.", + "readOnly": true, + "type": "string" + }, + "state": { + "description": "Optional. Output only. [Output Only] Current state of the policy: ACTIVE or DELETING.", + "enum": [ + "ACTIVE", + "DELETING", + "STATE_UNSPECIFIED" ], - "request": { - "$ref": "RegionSetLabelsRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "The policy is active and applied to matching VMs.\nNewly created VMs that match the policy will also receive the\nextension policy.", + "The policy is in the process of being deleted. After the extension is\nremoved from all matching VMs, the policy will be deleted.", + "Default value. Do not use." ], - "description": "Sets the labels on a TargetVpnGateway. To learn more about labels, read the Labeling Resources documentation." + "readOnly": true, + "type": "string" + }, + "updateTimestamp": { + "description": "Output only. [Output Only] Update timestamp inRFC3339\ntext format.", + "readOnly": true, + "type": "string" } - } + }, + "type": "object" }, - "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" - } + "VmExtensionPolicyAggregatedListResponse": { + "description": "Response for the aggregated list of VM extension policies.", + "id": "VmExtensionPolicyAggregatedListResponse", + "properties": { + "etag": { + "type": "string" + }, + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "additionalProperties": { + "$ref": "VmExtensionPoliciesScopedList", + "description": "Name of the scope containing this set of VmExtensionPolicies." }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "UrlMapList" + "description": "A list of VmExtensionPoliciesScopedList resources.", + "type": "object" + }, + "kind": { + "default": "compute#VmExtensionPolicyAggregatedList", + "description": "Output only. [Output Only] Type of resource. Alwayscompute#VmExtensionPolicyAggregatedList for lists of\nVmExtensionPolicies.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "unreachables": { + "description": "Output only. [Output Only] Unreachable resources.", + "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 the list of UrlMap resources available to the specified project." + "readOnly": true, + "type": "array" }, - "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", + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "pageToken": { - "description": "Specifies a page token 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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" } }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "UrlMapsAggregatedList" + "type": "object" + } + }, + "type": "object" + }, + "VmExtensionPolicyExtensionPolicy": { + "description": "Configuration for a specific VM extension.", + "id": "VmExtensionPolicyExtensionPolicy", + "properties": { + "pinnedVersion": { + "description": "Optional. The specific version of the extension to install. If not set, the latest\nversion is used.", + "type": "string" + }, + "stringConfig": { + "description": "Optional. String-based configuration data for the extension.", + "type": "string" + } + }, + "type": "object" + }, + "VmExtensionPolicyInstanceSelector": { + "description": "Defines how to select VMs to apply a zone VM extension policy.", + "id": "VmExtensionPolicyInstanceSelector", + "properties": { + "labelSelector": { + "$ref": "VmExtensionPolicyLabelSelector", + "description": "Optional. LabelSelector selects VMs based on their labels." + } + }, + "type": "object" + }, + "VmExtensionPolicyLabelSelector": { + "description": "A LabelSelector is applied to a VM only if it matches all the specified\nlabels.", + "id": "VmExtensionPolicyLabelSelector", + "properties": { + "inclusionLabels": { + "additionalProperties": { + "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 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`." + "description": "Optional. A map of key-value pairs representing VM labels.\nVMs must have all of the labels specified in this map to be selected\n(logical AND).\n\ne.g. If the `inclusion_labels` are {(\"key1\", \"value1\"), (\"key2\",\n\"value2\")}, the VM labels must contain both (\"key1\", \"value1\") and\n(\"key2\", \"value2\") to be selected. If the VM labels are (\"key1\",\n\"value1\") and (\"something\", \"else\"), it will not be selected.\n\nIf the map is empty, it's considered a match.", + "type": "object" + } + }, + "type": "object" + }, + "VmExtensionPolicyList": { + "id": "VmExtensionPolicyList", + "properties": { + "etag": { + "description": "Output only. [Output Only] Fingerprint of this resource. A hash of the contents stored\nin this object. This field is used in optimistic locking. This field will\nbe ignored when inserting a VmExtensionPolicy. An up-to-date\nfingerprint must be provided in order to update the VmExtensionPolicy.\n\nTo see the latest value of the fingerprint, make a get() request to\nretrieve a VmExtensionPolicy.", + "readOnly": true, + "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" - } + "id": { + "description": "Output only. [Output Only] Unique identifier for the resource; defined by the server.", + "readOnly": true, + "type": "string" + }, + "items": { + "description": "Output only. [Output Only] A list of VM extension policy resources.", + "items": { + "$ref": "VmExtensionPolicy" }, - "parameterOrder": [ - "project", - "urlMap" - ], - "response": { - "$ref": "UrlMap" + "readOnly": true, + "type": "array" + }, + "kind": { + "default": "compute#vmExtensionPolicyList", + "description": "Output only. Type of resource.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "Output only. [Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "readOnly": true, + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "unreachables": { + "description": "Output only. [Output Only] Unreachable resources.", + "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": "Returns the specified UrlMap resource." + "readOnly": true, + "type": "array" }, - "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, + "warning": { + "description": "Output only. [Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", + "data": { + "description": "[Output Only] Metadata about this warning in key:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" + }, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project" + "readOnly": true, + "type": "object" + } + }, + "type": "object" + }, + "VpnGateway": { + "description": "Represents a HA VPN gateway.\n\nHA VPN is a high-availability (HA) Cloud VPN solution that lets you securely\nconnect your on-premises network to your Google Cloud Virtual Private Cloud\nnetwork through an IPsec VPN connection in a single region.\nFor more information about Cloud HA VPN solutions, see\nCloud VPN topologies .", + "id": "VpnGateway", + "properties": { + "creationTimestamp": { + "description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you\ncreate the resource.", + "type": "string" + }, + "gatewayIpVersion": { + "description": "The IP family of the gateway IPs for the HA-VPN gateway interfaces. If not\nspecified, IPV4 will be used.", + "enum": [ + "IPV4", + "IPV6" ], - "request": { - "$ref": "UrlMap" + "enumDescriptions": [ + "Every HA-VPN gateway interface is configured with an IPv4 address.", + "Every HA-VPN gateway interface is configured with an IPv6 address." + ], + "type": "string" + }, + "id": { + "description": "Output only. [Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "format": "uint64", + "readOnly": true, + "type": "string" + }, + "kind": { + "default": "compute#vpnGateway", + "description": "Output only. [Output Only] Type of resource. Always compute#vpnGateway for\nVPN gateways.", + "readOnly": true, + "type": "string" + }, + "labelFingerprint": { + "description": "A fingerprint for the labels being applied to this VpnGateway, which\nis essentially a hash of the labels set used for optimistic locking. The\nfingerprint is initially generated by Compute Engine and changes after\nevery request to modify or update labels. You must always provide an\nup-to-date fingerprint hash in order to update or change labels,\notherwise the request will fail with error412 conditionNotMet.\n\nTo see the latest fingerprint, make a get() request to\nretrieve a VpnGateway.", + "format": "byte", + "type": "string" + }, + "labels": { + "additionalProperties": { + "type": "string" }, - "response": { - "$ref": "Operation" + "description": "Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035.\nLabel values may be empty.", + "type": "object" + }, + "name": { + "annotations": { + "required": [ + "compute.vpnGateways.insert" + ] }, - "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." + "description": "Name of the resource. Provided by the client when the resource is created.\nThe name must be 1-63 characters long, and comply withRFC1035.\nSpecifically, the name must be 1-63 characters long and match the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first\ncharacter must be a lowercase letter, and all following characters must\nbe a dash, lowercase letter, or digit, except the last character, which\ncannot be a dash.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "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" - } + "network": { + "annotations": { + "required": [ + "compute.vpnGateways.insert" + ] }, - "parameterOrder": [ - "project", - "urlMap" + "description": "URL of the network to which this VPN gateway is attached. Provided by the\nclient when the VPN gateway is created.", + "type": "string" + }, + "params": { + "$ref": "VpnGatewayParams", + "description": "Input only. [Input Only] Additional params passed with the request, but not persisted\nas part of resource payload." + }, + "region": { + "description": "Output only. [Output Only] URL of the region where the VPN gateway resides.", + "readOnly": true, + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for the resource.", + "readOnly": true, + "type": "string" + }, + "stackType": { + "description": "The stack type for this VPN gateway to identify the IP protocols that are\nenabled. Possible values are: IPV4_ONLY,IPV4_IPV6, IPV6_ONLY. If not specified,IPV4_ONLY is used if the gateway IP version isIPV4, or IPV4_IPV6 if the gateway IP version isIPV6.", + "enum": [ + "IPV4_IPV6", + "IPV4_ONLY", + "IPV6_ONLY" ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "Enable VPN gateway with both IPv4 and IPv6 protocols.", + "Enable VPN gateway with only IPv4 protocol.", + "Enable VPN gateway with only IPv6 protocol." ], - "description": "Deletes the specified UrlMap resource." + "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" - } + "vpnInterfaces": { + "description": "The list of VPN interfaces associated with this VPN gateway.", + "items": { + "$ref": "VpnGatewayVpnGatewayInterface" }, - "parameterOrder": [ - "project", - "urlMap" - ], - "request": { - "$ref": "UrlMap" + "type": "array" + } + }, + "type": "object" + }, + "VpnGatewayAggregatedList": { + "id": "VpnGatewayAggregatedList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "additionalProperties": { + "$ref": "VpnGatewaysScopedList", + "description": "[Output Only] Name of the scope containing this set of VPN gateways." }, - "response": { - "$ref": "Operation" + "description": "A list of VpnGateway resources.", + "type": "object" + }, + "kind": { + "default": "compute#vpnGatewayAggregatedList", + "description": "Output only. [Output Only] Type of resource. Always compute#vpnGateway for\nVPN gateways.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "unreachables": { + "description": "Output only. [Output Only] Unreachable resources.", + "items": { + "type": "string" }, - "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." + "readOnly": true, + "type": "array" }, - "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", + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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." - }, - "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" + "data": { + "description": "[Output Only] Metadata about this warning in key:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project", - "urlMap" - ], - "request": { - "$ref": "UrlMapsValidateRequest" - }, - "response": { - "$ref": "UrlMapsValidateResponse" + "type": "object" + } + }, + "type": "object" + }, + "VpnGatewayList": { + "description": "Contains a list of VpnGateway resources.", + "id": "VpnGatewayList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of VpnGateway resources.", + "items": { + "$ref": "VpnGateway" }, - "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." + "type": "array" }, - "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, + "kind": { + "default": "compute#vpnGatewayList", + "description": "Output only. [Output Only] Type of resource. Always compute#vpnGateway for\nVPN gateways.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project", - "urlMap" - ], - "request": { - "$ref": "CacheInvalidationRule" - }, - "response": { - "$ref": "Operation" + "type": "object" + } + }, + "type": "object" + }, + "VpnGatewayParams": { + "id": "VpnGatewayParams", + "properties": { + "resourceManagerTags": { + "additionalProperties": { + "type": "string" }, - "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)." + "description": "Tag keys/values directly bound to this resource.\nTag keys and values have the same definition as resource\nmanager tags. The field is allowed for INSERT\nonly. The keys/values to set on the resource should be specified in\neither ID { : } or Namespaced format\n{ : }.\nFor example the following are valid inputs:\n* {\"tagKeys/333\" : \"tagValues/444\", \"tagKeys/123\" : \"tagValues/456\"}\n* {\"123/environment\" : \"production\", \"345/abc\" : \"xyz\"}\nNote:\n* Invalid combinations of ID & namespaced format is not supported. For\n instance: {\"123/environment\" : \"tagValues/444\"} is invalid.\n* Inconsistent format is not supported. For instance:\n {\"tagKeys/333\" : \"tagValues/444\", \"123/env\" : \"prod\"} is invalid.", + "type": "object" } - } + }, + "type": "object" }, - "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" - } + "VpnGatewayStatus": { + "id": "VpnGatewayStatus", + "properties": { + "vpnConnections": { + "description": "Output only. List of VPN connection for this VpnGateway.", + "items": { + "$ref": "VpnGatewayStatusVpnConnection" }, - "parameterOrder": [ - "project", - "region" + "readOnly": true, + "type": "array" + } + }, + "type": "object" + }, + "VpnGatewayStatusHighAvailabilityRequirementState": { + "description": "Describes the high availability requirement state for the VPN connection\nbetween this Cloud VPN gateway and a peer gateway.", + "id": "VpnGatewayStatusHighAvailabilityRequirementState", + "properties": { + "state": { + "description": "Indicates the high availability requirement state for the VPN connection.\nValid values are CONNECTION_REDUNDANCY_MET,CONNECTION_REDUNDANCY_NOT_MET.", + "enum": [ + "CONNECTION_REDUNDANCY_MET", + "CONNECTION_REDUNDANCY_NOT_MET" ], - "response": { - "$ref": "UrlMapList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "VPN tunnels are configured with adequate redundancy from Cloud VPN\ngateway to the peer VPN gateway. For both GCP-to-non-GCP and GCP-to-GCP\nconnections, the adequate redundancy is a pre-requirement for users to\nget 99.99% availability on GCP side; please note that for any\nconnection, end-to-end 99.99% availability is subject to proper\nconfiguration on the peer VPN gateway.", + "VPN tunnels are not configured with adequate redundancy from the Cloud\nVPN gateway to the peer gateway" ], - "description": "Retrieves the list of UrlMap resources available to the specified project in the specified region." + "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" + "unsatisfiedReason": { + "description": "Indicates the reason why the VPN connection does not meet the high\navailability redundancy criteria/requirement.\nValid values is INCOMPLETE_TUNNELS_COVERAGE.", + "enum": [ + "INCOMPLETE_TUNNELS_COVERAGE" ], - "response": { - "$ref": "UrlMap" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "" ], - "description": "Returns the specified UrlMap resource." + "type": "string" + } + }, + "type": "object" + }, + "VpnGatewayStatusTunnel": { + "description": "Contains some information about a VPN tunnel.", + "id": "VpnGatewayStatusTunnel", + "properties": { + "localGatewayInterface": { + "description": "Output only. The VPN gateway interface this VPN tunnel is associated with.", + "format": "uint32", + "readOnly": true, + "type": "integer" }, - "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, + "peerGatewayInterface": { + "description": "Output only. The peer gateway interface this VPN tunnel is connected to, the peer\ngateway could either be an external VPN gateway or a Google Cloud\nVPN gateway.", + "format": "uint32", + "readOnly": true, + "type": "integer" + }, + "tunnelUrl": { + "description": "Output only. URL reference to the VPN tunnel.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "VpnGatewayStatusVpnConnection": { + "description": "A VPN connection contains all VPN tunnels connected from this VpnGateway\nto the same peer gateway. The peer gateway could either be an external VPN\ngateway or a Google Cloud VPN gateway.", + "id": "VpnGatewayStatusVpnConnection", + "properties": { + "peerExternalGateway": { + "description": "Output only. URL reference to the peer external VPN gateways to which the VPN tunnels\nin this VPN connection are connected.\nThis field is mutually exclusive with peer_gcp_gateway.", + "readOnly": true, + "type": "string" + }, + "peerGcpGateway": { + "description": "Output only. URL reference to the peer side VPN gateways to which the VPN tunnels in\nthis VPN connection are connected.\nThis field is mutually exclusive with peer_gcp_gateway.", + "readOnly": true, + "type": "string" + }, + "state": { + "$ref": "VpnGatewayStatusHighAvailabilityRequirementState", + "description": "HighAvailabilityRequirementState for the VPN connection." + }, + "tunnels": { + "description": "List of VPN tunnels that are in this VPN connection.", + "items": { + "$ref": "VpnGatewayStatusTunnel" + }, + "type": "array" + } + }, + "type": "object" + }, + "VpnGatewayVpnGatewayInterface": { + "description": "A VPN gateway interface.", + "id": "VpnGatewayVpnGatewayInterface", + "properties": { + "id": { + "description": "Output only. [Output Only] Numeric identifier for this VPN interface associated with\nthe VPN gateway.", + "format": "uint32", + "readOnly": true, + "type": "integer" + }, + "interconnectAttachment": { + "description": "URL of the VLAN attachment (interconnectAttachment) resource for this\nVPN gateway interface. When the value of this field is present, the VPN\ngateway is used for HA VPN over Cloud Interconnect; all egress\nor ingress traffic for this VPN gateway interface goes through the\nspecified VLAN attachment resource.", + "type": "string" + }, + "ipAddress": { + "description": "Output only. [Output Only] IP address for this VPN interface associated with the VPN\ngateway.\nThe IP address could be either a regional external IP address or\na regional internal IP address. The two IP addresses for a VPN gateway\nmust be all regional external or regional internal IP addresses. There\ncannot be a mix of regional external IP addresses and regional internal\nIP addresses. For HA VPN over Cloud Interconnect, the IP addresses\nfor both interfaces could either be regional internal IP addresses or\nregional external IP addresses. For regular (non HA VPN over Cloud\nInterconnect) HA VPN tunnels, the IP address must be a regional external\nIP address.", + "readOnly": true, + "type": "string" + }, + "ipv6Address": { + "description": "Output only. [Output Only] IPv6 address for this VPN interface associated with the VPN\ngateway.\nThe IPv6 address must be a regional external IPv6 address. The format is\nRFC 5952 format (e.g. 2001:db8::2d9:51:0:0).", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "VpnGatewaysGetStatusResponse": { + "id": "VpnGatewaysGetStatusResponse", + "properties": { + "result": { + "$ref": "VpnGatewayStatus" + } + }, + "type": "object" + }, + "VpnGatewaysScopedList": { + "id": "VpnGatewaysScopedList", + "properties": { + "vpnGateways": { + "description": "[Output Only] A list of VPN gateways contained in this scope.", + "items": { + "$ref": "VpnGateway" + }, + "type": "array" + }, + "warning": { + "description": "[Output Only] Informational warning which replaces the list of addresses\nwhen the list is empty.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "requestId": { - "description": "begin_interface: MixerMutationRequestBuilder Request ID to support idempotency.", - "location": "query", + "data": { + "description": "[Output Only] Metadata about this warning in key:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" + }, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project", - "region" - ], - "request": { - "$ref": "UrlMap" - }, - "response": { - "$ref": "Operation" + "type": "object" + } + }, + "type": "object" + }, + "VpnTunnel": { + "description": "Represents a Cloud VPN Tunnel resource.\n\nFor more information about VPN, read the\nthe Cloud VPN Overview.", + "id": "VpnTunnel", + "properties": { + "cipherSuite": { + "$ref": "VpnTunnelCipherSuite", + "description": "User specified list of ciphers to use for the phase 1 and phase 2 of the\nIKE protocol." + }, + "creationTimestamp": { + "description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you\ncreate the resource.", + "type": "string" + }, + "detailedStatus": { + "description": "[Output Only] Detailed status message for the VPN tunnel.", + "type": "string" + }, + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "format": "uint64", + "type": "string" + }, + "ikeVersion": { + "description": "IKE protocol version to use when establishing the VPN tunnel with the peer\nVPN gateway. Acceptable IKE versions are 1 or 2.\nThe default version is 2.", + "format": "int32", + "type": "integer" + }, + "kind": { + "default": "compute#vpnTunnel", + "description": "Output only. [Output Only] Type of resource. Always compute#vpnTunnel for\nVPN tunnels.", + "readOnly": true, + "type": "string" + }, + "labelFingerprint": { + "description": "A fingerprint for the labels being applied to this VpnTunnel, which is\nessentially a hash of the labels set used for optimistic locking. The\nfingerprint is initially generated by Compute Engine and changes after\nevery request to modify or update labels. You must always provide an\nup-to-date fingerprint hash in order to update or change labels,\notherwise the request will fail with error412 conditionNotMet.\n\nTo see the latest fingerprint, make a get() request to\nretrieve a VpnTunnel.", + "format": "byte", + "type": "string" + }, + "labels": { + "additionalProperties": { + "type": "string" }, - "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." + "description": "Labels for this resource. These can only be added or modified by thesetLabels method. Each label key/value pair must comply withRFC1035.\nLabel values may be empty.", + "type": "object" }, - "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" - } + "localTrafficSelector": { + "description": "Local traffic selector to use when establishing the VPN tunnel with the\npeer VPN gateway. The value should be a CIDR formatted string, for\nexample: 192.168.0.0/16. The ranges must be disjoint.\nOnly IPv4 is supported for Classic VPN tunnels. This field is output only\nfor HA VPN tunnels.", + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "region", - "urlMap" - ], - "response": { - "$ref": "Operation" + "type": "array" + }, + "name": { + "annotations": { + "required": [ + "compute.vpnTunnels.insert" + ] }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified UrlMap resource." + "description": "Name of the resource. Provided by the client when the resource is created.\nThe name must be 1-63 characters long, and comply withRFC1035.\nSpecifically, the name must be 1-63 characters long and match the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first\ncharacter must be a lowercase letter, and all following characters must\nbe a dash, lowercase letter, or digit, except the last character, which\ncannot be a dash.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "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" - } + "params": { + "$ref": "VpnTunnelParams", + "description": "Input only. [Input Only] Additional params passed with the request, but not persisted\nas part of resource payload." + }, + "peerExternalGateway": { + "description": "URL of the peer side external VPN gateway to which this VPN tunnel is\nconnected.\nProvided by the client when the VPN tunnel is created.\nThis 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\nconnected. Provided by the client when the VPN tunnel is created.\nPossible values are: `0`, `1`, `2`, `3`. The number of IDs in use\ndepends on the external VPN gateway redundancy type.", + "format": "int32", + "type": "integer" + }, + "peerGcpGateway": { + "description": "URL of the peer side HA VPN gateway to which this VPN tunnel\nis connected. Provided by the client when the VPN tunnel is created.\nThis field can be used when creating highly available VPN from VPC network\nto VPC network, the field is exclusive with the field peerExternalGateway.\nIf provided, the VPN tunnel will automatically use the same\nvpnGatewayInterface ID in the peer Google Cloud VPN gateway.", + "type": "string" + }, + "peerIp": { + "description": "IP address of the peer VPN gateway. Only IPv4 is supported. This field can\nbe set only for Classic VPN tunnels.", + "type": "string" + }, + "region": { + "description": "[Output Only] URL of the region where the VPN tunnel resides.\nYou must specify this field as part of the HTTP request URL. It is\nnot settable as a field in the request body.", + "type": "string" + }, + "remoteTrafficSelector": { + "description": "Remote traffic selectors to use when establishing the VPN tunnel with\nthe peer VPN gateway. The value should be a CIDR formatted string,\nfor example: 192.168.0.0/16. The ranges should be disjoint. Only IPv4 is\nsupported for Classic VPN tunnels. This field is output only for HA VPN\ntunnels.", + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "region", - "urlMap" + "type": "array" + }, + "router": { + "description": "URL of the router resource to be used for dynamic routing.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" + }, + "sharedSecret": { + "description": "Shared secret used to set the secure session between the Cloud VPN gateway\nand 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\nfollowing:\n \n - PROVISIONING: Resource is being allocated for the VPN tunnel.\n - WAITING_FOR_FULL_CONFIG: Waiting to receive all VPN-related configs\n from\n the user. Network, TargetVpnGateway, VpnTunnel, ForwardingRule, and Route\n resources are needed to setup the VPN tunnel.\n - FIRST_HANDSHAKE: Successful first handshake with the peer VPN.\n - ESTABLISHED: Secure session is successfully established with the peer\n VPN. \n - NETWORK_ERROR: Deprecated, replaced by\n NO_INCOMING_PACKETS \n - AUTHORIZATION_ERROR: Auth error (for example,\n bad shared secret). \n - NEGOTIATION_FAILURE: Handshake failed.\n - DEPROVISIONING: Resources are being deallocated for the VPN\n tunnel. \n - FAILED: Tunnel creation has failed and the tunnel is not\n ready to be used. \n - NO_INCOMING_PACKETS: No incoming packets from\n peer. \n - REJECTED: Tunnel configuration was rejected, can be result\n of being denied access. \n - ALLOCATING_RESOURCES: Cloud VPN is in the\n process of allocating all required resources.\n - STOPPED: Tunnel is stopped due to its Forwarding Rules being deleted\n for Classic VPN tunnels or the project is in frozen state.\n - PEER_IDENTITY_MISMATCH: Peer identity does not match peer IP,\n probably behind NAT. \n - TS_NARROWING_NOT_ALLOWED: Traffic selector\n narrowing not allowed for an HA-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" ], - "request": { - "$ref": "UrlMap" + "enumDescriptions": [ + "Cloud VPN is in the process of allocating all required resources\n(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,\nTargetVpnGateway, VpnTunnel, ForwardingRule and Route resources are\nneeded to setup VPN tunnel." + ], + "type": "string" + }, + "targetVpnGateway": { + "description": "URL of the Target VPN gateway with which this VPN tunnel is associated.\nProvided by the client when the VPN tunnel is created.\nThis 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.\nProvided by the client when the VPN tunnel is created. This must be\nused (instead of target_vpn_gateway) if a High Availability VPN gateway\nresource is created.", + "type": "string" + }, + "vpnGatewayInterface": { + "description": "The interface ID of the VPN gateway with which this VPN tunnel is\nassociated.\nPossible values are: `0`, `1`.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, + "VpnTunnelAggregatedList": { + "id": "VpnTunnelAggregatedList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "additionalProperties": { + "$ref": "VpnTunnelsScopedList", + "description": "Name of the scope containing this set of VPN tunnels." }, - "response": { - "$ref": "Operation" + "description": "A list of VpnTunnelsScopedList resources.", + "type": "object" + }, + "kind": { + "default": "compute#vpnTunnelAggregatedList", + "description": "Output only. [Output Only] Type of resource. Always compute#vpnTunnel for\nVPN tunnels.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "unreachables": { + "description": "Output only. [Output Only] Unreachable resources.", + "items": { + "type": "string" }, - "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." + "readOnly": true, + "type": "array" }, - "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, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "requestId": { - "description": "begin_interface: MixerMutationRequestBuilder Request ID to support idempotency.", - "location": "query", - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project", - "region", - "urlMap" - ], - "request": { - "$ref": "UrlMap" - }, - "response": { - "$ref": "Operation" + "type": "object" + } + }, + "type": "object" + }, + "VpnTunnelCipherSuite": { + "id": "VpnTunnelCipherSuite", + "properties": { + "phase1": { + "$ref": "VpnTunnelPhase1Algorithms" + }, + "phase2": { + "$ref": "VpnTunnelPhase2Algorithms" + } + }, + "type": "object" + }, + "VpnTunnelList": { + "description": "Contains a list of VpnTunnel resources.", + "id": "VpnTunnelList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of VpnTunnel resources.", + "items": { + "$ref": "VpnTunnel" }, - "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." + "type": "array" }, - "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, + "kind": { + "default": "compute#vpnTunnelList", + "description": "Output only. [Output Only] Type of resource. Always compute#vpnTunnel for\nVPN tunnels.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project", - "region", - "urlMap" - ], - "request": { - "$ref": "RegionUrlMapsValidateRequest" - }, - "response": { - "$ref": "UrlMapsValidateResponse" + "type": "object" + } + }, + "type": "object" + }, + "VpnTunnelParams": { + "id": "VpnTunnelParams", + "properties": { + "resourceManagerTags": { + "additionalProperties": { + "type": "string" }, - "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." + "description": "Tag keys/values directly bound to this resource.\nTag keys and values have the same definition as resource\nmanager tags. The field is allowed for INSERT\nonly. The keys/values to set on the resource should be specified in\neither ID { : } or Namespaced format\n{ : }.\nFor example the following are valid inputs:\n* {\"tagKeys/333\" : \"tagValues/444\", \"tagKeys/123\" : \"tagValues/456\"}\n* {\"123/environment\" : \"production\", \"345/abc\" : \"xyz\"}\nNote:\n* Invalid combinations of ID & namespaced format is not supported. For\n instance: {\"123/environment\" : \"tagValues/444\"} is invalid.\n* Inconsistent format is not supported. For instance:\n {\"tagKeys/333\" : \"tagValues/444\", \"123/env\" : \"prod\"} is invalid.", + "type": "object" } - } + }, + "type": "object" }, - "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" - } + "VpnTunnelPhase1Algorithms": { + "id": "VpnTunnelPhase1Algorithms", + "properties": { + "dh": { + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "region" - ], - "response": { - "$ref": "VpnGatewayList" + "type": "array" + }, + "encryption": { + "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 VPN gateways available to the specified project and region." + "type": "array" }, - "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" - } + "integrity": { + "items": { + "type": "string" }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "VpnGatewayAggregatedList" + "type": "array" + }, + "prf": { + "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 an aggregated list of VPN gateways. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." + "type": "array" + } + }, + "type": "object" + }, + "VpnTunnelPhase2Algorithms": { + "id": "VpnTunnelPhase2Algorithms", + "properties": { + "encryption": { + "items": { + "type": "string" + }, + "type": "array" }, - "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" - } + "integrity": { + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "region", - "vpnGateway" - ], - "response": { - "$ref": "VpnGateway" + "type": "array" + }, + "pfs": { + "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": "Returns the specified VPN gateway." + "type": "array" + } + }, + "type": "object" + }, + "VpnTunnelsScopedList": { + "id": "VpnTunnelsScopedList", + "properties": { + "vpnTunnels": { + "description": "A list of VPN tunnels contained in this scope.", + "items": { + "$ref": "VpnTunnel" + }, + "type": "array" }, - "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, + "warning": { + "description": "Informational warning which replaces the list of addresses when\nthe list is empty.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" } }, - "parameterOrder": [ - "project", - "region", - "vpnGateway" - ], - "response": { - "$ref": "VpnGatewaysGetStatusResponse" + "type": "object" + } + }, + "type": "object" + }, + "WafExpressionSet": { + "id": "WafExpressionSet", + "properties": { + "aliases": { + "description": "A list of alternate IDs. The format should be:\n- E.g. XSS-stable\nGeneric suffix like \"stable\" is particularly useful if a policy\nlikes to avail newer set of expressions without having to change\nthe policy.\nA given alias name can't be used for more than one entity set.", + "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": "Returns the status for the specified VPN gateway." + "type": "array" }, - "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" - } + "expressions": { + "description": "List of available expressions.", + "items": { + "$ref": "WafExpressionSetExpression" }, - "parameterOrder": [ - "project", - "region" - ], - "request": { - "$ref": "VpnGateway" + "type": "array" + }, + "id": { + "description": "Google specified expression set ID. The format should be:\n- E.g. XSS-20170329\nrequired", + "type": "string" + } + }, + "type": "object" + }, + "WafExpressionSetExpression": { + "id": "WafExpressionSetExpression", + "properties": { + "id": { + "description": "Expression ID should uniquely identify the origin of the expression.\nE.g. owasp-crs-v020901-id973337 identifies Owasp core rule set\nversion 2.9.1 rule id 973337.\nThe ID could be used to determine the individual attack definition\nthat has been detected. It could also be used to exclude it from\nthe policy in case of false positive.\nrequired", + "type": "string" + }, + "sensitivity": { + "description": "The sensitivity value associated with the WAF rule ID. This corresponds\nto the ModSecurity paranoia level, ranging from 1 to 4. 0 is reserved for\nopt-in only rules.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, + "WeightedBackendService": { + "description": "In contrast to a single BackendService in \nHttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across\nmultiple backend services. The volume of traffic for each\nbackend service is proportional to the weight specified\nin each WeightedBackendService", + "id": "WeightedBackendService", + "properties": { + "backendService": { + "description": "The full or partial URL to the default BackendService\nresource. Before\nforwarding the request to backendService, the load balancer\napplies any relevant headerActions specified as part of thisbackendServiceWeight.", + "type": "string" + }, + "headerAction": { + "$ref": "HttpHeaderAction", + "description": "Specifies changes to request and response headers that need to take\neffect for the selected backendService.\n\nheaderAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.\n\nheaderAction is not supported for load balancers that have\ntheir loadBalancingScheme set to EXTERNAL.\n\nNot supported when the URL map is bound to a target gRPC proxy that\nhas validateForProxyless field set to true." + }, + "weight": { + "description": "Specifies the fraction of traffic sent to a backend service,\ncomputed asweight / (sum of all weightedBackendService weights in routeAction).\n\nThe selection of a backend service is determined only for new traffic.\nOnce a user's request has been directed to a backend service,\nsubsequent requests are sent to the same backend service as\ndetermined by the backend service's session affinity policy.\nDon't configure session affinity if you're using weighted traffic\nsplitting. If you do, the weighted traffic splitting configuration takes\nprecedence.\n\nThe value must be from 0 to 1000.", + "format": "uint32", + "type": "integer" + } + }, + "type": "object" + }, + "Wire": { + "description": "A pseudowire that connects two Interconnect connections.", + "id": "Wire", + "properties": { + "adminEnabled": { + "description": "Output only. [Output Only] Indicates whether the wire is enabled.\nWhen false, the wire is disabled. When true and when the wire group of\nthe wire is also enabled, the wire is enabled. Defaults to true.", + "readOnly": true, + "type": "boolean" + }, + "endpoints": { + "description": "Output only. Wire endpoints are specific Interconnect connections.", + "items": { + "$ref": "WireEndpoint" }, - "response": { - "$ref": "Operation" + "readOnly": true, + "type": "array" + }, + "label": { + "description": "Output only. [Output Only] A label that identifies the wire. The format of this label\ncombines the existing labels of the wire group endpoints and Interconnect\nconnections used by this wire in alphabetical order as follows:\n`ENDPOINT_A+CONNECTION_A1,ENDPOINT_B+CONNECTION_B1`, where:\n \n - ENDPOINT_A and ENDPOINT_B: are the labels\n that you entered as map keys when you specified the wire group endpoint\n objects.\n - CONNECTION_A1 and CONNECTION_B1: are the\n labels that you entered as map keys when you specified the wire group\n Interconnect objects.", + "readOnly": true, + "type": "string" + }, + "wireProperties": { + "$ref": "WireProperties", + "description": "Output only. [Output Only] Properties of the wire.", + "readOnly": true + } + }, + "type": "object" + }, + "WireEndpoint": { + "description": "Wire endpoints are specific Interconnect connections.", + "id": "WireEndpoint", + "properties": { + "interconnect": { + "readOnly": true, + "type": "string" + }, + "vlanTag": { + "format": "int32", + "readOnly": true, + "type": "integer" + } + }, + "type": "object" + }, + "WireGroup": { + "description": "A resource that represents a group of redundant wires.", + "id": "WireGroup", + "properties": { + "adminEnabled": { + "description": "Indicates whether the wires in the wire group are enabled. When false, the\nwires in the wire group are disabled. When true and when\nthere is simultaneously no wire-specific override of `adminEnabled` to\nfalse, a given wire is enabled. Defaults to true.", + "type": "boolean" + }, + "creationTimestamp": { + "description": "Output only. [Output Only] Creation timestamp inRFC3339\ntext format.", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "An optional description of the wire group.", + "type": "string" + }, + "endpoints": { + "additionalProperties": { + "$ref": "WireGroupEndpoint" }, - "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." + "description": "A map that contains the logical endpoints of the wire group. Specify\nkey-value pairs for the map as follows:\n \n - Key: an RFC1035 user-specified label.\n - Value: an Endpoint object.", + "type": "object" }, - "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" - } + "id": { + "description": "Output only. [Output Only] The unique identifier for the resource type. The server\ngenerates this identifier.", + "format": "uint64", + "readOnly": true, + "type": "string" + }, + "kind": { + "default": "compute#wireGroup", + "description": "Output only. [Output Only] Type of the resource. Alwayscompute#wireGroups for wire groups.", + "readOnly": true, + "type": "string" + }, + "name": { + "description": "Name of the resource. Provided by the client when the resource is created.\nThe name must be 1-63 characters long, and comply withRFC1035.\nSpecifically, the name must be 1-63 characters long and match the regular\nexpression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first\ncharacter must be a lowercase letter, and all following characters must\nbe a dash, lowercase letter, or digit, except the last character, which\ncannot be a dash.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "reconciling": { + "description": "Output only. [Output Only] Indicates whether there are wire changes yet to be processed.", + "readOnly": true, + "type": "boolean" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for the resource.", + "readOnly": true, + "type": "string" + }, + "topology": { + "$ref": "WireGroupTopology", + "description": "Output only. Topology details for the wire group configuration.", + "readOnly": true + }, + "wireProperties": { + "$ref": "WireProperties", + "description": "Properties for all wires in the wire group." + }, + "wires": { + "description": "Output only. The single/redundant wire(s) managed by the wire group.", + "items": { + "$ref": "Wire" }, - "parameterOrder": [ - "project", - "region", - "vpnGateway" - ], - "response": { - "$ref": "Operation" + "readOnly": true, + "type": "array" + } + }, + "type": "object" + }, + "WireGroupEndpoint": { + "description": "A logical endpoint for the wire group. An endpoint represents a metro that\ncontains redundant Interconnect connections. A wire group is created\nbetween two endpoints.", + "id": "WireGroupEndpoint", + "properties": { + "interconnects": { + "additionalProperties": { + "$ref": "WireGroupEndpointInterconnect" }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified VPN gateway." + "description": "A map that contains the redundant Interconnect connections. Specify\nkey-value pairs for the map as follows:\n \n - Key: an RFC1035 user-specified label.\n - Value: an Interconnect object.", + "type": "object" + } + }, + "type": "object" + }, + "WireGroupEndpointInterconnect": { + "description": "The redundant Interconnect connections for this endpoint.", + "id": "WireGroupEndpointInterconnect", + "properties": { + "interconnect": { + "description": "Required. An Interconnect connection. You can specify the connection as\na partial or full URL. If the connection is in a different project from\nthe cross-site network, use a format that specifies the project. See\nthe following examples of partial and full URLs:\n \n \n \n global/interconnects/NAME\n \n \n projects/PROJECT_ID/global/interconnects/NAME\n \n - \n https://compute.googleapis.com/compute/projects/PROJECT_ID/global/interconnects/NAME", + "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" - } + "vlanTags": { + "description": "Required. To configure the wire group for VLAN mode, enter a VLAN tag,\nwhich is a number from `2` to `4093`. You can autoallocate a tag by\nentering `0`. To configure the wire group for port mode, enter `-1`.\nReview the following guidelines:\n \n - A VLAN tag must be unique for an Interconnect connection across all\n attachments and wire groups.\n - Both endpoints of a wire must use the same VLAN tag value.\n - Single wire and redundant type wire groups must have only one\n VLAN tag.\n - Port mode pseudowires must have a single VLAN tag with a value of\n `-1` for both endpoints.\n - Box and cross type wire groups must have two VLAN tags. The first\n is for the same-zone pseudowire, and the second is for the cross-zone\n pseudowire.", + "items": { + "format": "int32", + "type": "integer" }, - "parameterOrder": [ - "project", - "region", - "resource" - ], - "request": { - "$ref": "TestPermissionsRequest" + "type": "array" + } + }, + "type": "object" + }, + "WireGroupList": { + "description": "Response for the list request.", + "id": "WireGroupList", + "properties": { + "etag": { + "type": "string" + }, + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of wire group resources.", + "items": { + "$ref": "WireGroup" }, - "response": { - "$ref": "TestPermissionsResponse" + "type": "array" + }, + "kind": { + "default": "compute#wireGroup", + "description": "Output only. [Output Only] Type of the resource. Alwayscompute#wireGroups for wire groups.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "unreachables": { + "description": "Output only. [Output Only] Unreachable resources.\nend_interface: MixerListResponseWithEtagBuilder", + "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": "Returns permissions that a caller has on the specified resource." + "readOnly": true, + "type": "array" }, - "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, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "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" } }, - "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." + "type": "object" } - } + }, + "type": "object" }, - "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" - } + "WireGroupTopology": { + "description": "Topology details for the wire group.", + "id": "WireGroupTopology", + "properties": { + "endpoints": { + "description": "Output only. Topology details for all endpoints in the wire group.", + "items": { + "$ref": "WireGroupTopologyEndpoint" }, - "parameterOrder": [ - "project", - "region" + "readOnly": true, + "type": "array" + } + }, + "type": "object" + }, + "WireGroupTopologyEndpoint": { + "description": "Topology details for a single wire group endpoint.", + "id": "WireGroupTopologyEndpoint", + "properties": { + "city": { + "description": "Output only. The InterconnectLocation.city (metropolitan area designator) that all\ninterconnects are located in.", + "readOnly": true, + "type": "string" + }, + "label": { + "description": "Output only. Endpoint label from the wire group.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "WireProperties": { + "description": "The properties of a wire.", + "id": "WireProperties", + "properties": { + "bandwidthAllocation": { + "description": "The configuration of the bandwidth allocation, one of the following:\n \n - ALLOCATE_PER_WIRE: configures a separate unmetered bandwidth allocation\n (and associated charges) for each wire in the group.\n - SHARED_WITH_WIRE_GROUP: this is the default behavior, which configures\n one unmetered bandwidth allocation for the wire group. The unmetered\n bandwidth is divided equally across each wire in the group, but dynamic\n throttling reallocates unused unmetered bandwidth from unused or underused\n wires to other wires in the group.", + "enum": [ + "ALLOCATE_PER_WIRE", + "SHARED_WITH_WIRE_GROUP" ], - "response": { - "$ref": "VpnTunnelList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "Configures a separate unmetered bandwidth allocation (and associated\ncharges) for each wire in the group.", + "This is the default behavior. Configures one unmetered bandwidth\nallocation for the wire group. The unmetered bandwidth is divided equally\nacross each wire in the group, but dynamic throttling reallocates unused\nunmetered bandwidth from unused or underused wires to other wires in the\ngroup." ], - "description": "Retrieves a list of VpnTunnel resources contained in the specified project and region." + "type": "string" }, - "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" + "bandwidthUnmetered": { + "description": "The unmetered bandwidth in Gigabits per second, using decimal units. `10`\nis 10 Gbps, `100` is 100 Gbps. The bandwidth must be greater than 0.", + "format": "int64", + "type": "string" + }, + "faultResponse": { + "description": "Response when a fault is detected in a pseudowire:\n \n - NONE: default.\n - DISABLE_PORT: set the port line protocol down when inline probes\n detect a fault. This setting is only permitted on port mode\n pseudowires.", + "enum": [ + "DISABLE_PORT", + "NONE" ], - "response": { - "$ref": "VpnTunnelAggregatedList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enumDescriptions": [ + "Set the port line protocol down when inline probes detect a fault. This\nsetting is only permitted on port mode pseudowires.", + "Default." ], - "description": "Retrieves an aggregated list of VPN tunnels. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." + "type": "string" + } + }, + "type": "object" + }, + "WorkloadIdentityConfig": { + "id": "WorkloadIdentityConfig", + "properties": { + "identity": { + "type": "string" }, - "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" + "identityCertificateEnabled": { + "type": "boolean" + } + }, + "type": "object" + }, + "XpnHostList": { + "id": "XpnHostList", + "properties": { + "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.", + "items": { + "$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 VpnTunnel resource." + "type": "array" }, - "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, + "kind": { + "default": "compute#xpnHostList", + "description": "Output only. [Output Only] Type of resource. Always compute#xpnHostList for\nlists of shared VPC hosts.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. 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" } }, - "parameterOrder": [ - "project", - "region" - ], - "request": { - "$ref": "VpnTunnel" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Creates a VpnTunnel resource in the specified project and region using the data included in the request." + "type": "object" + } + }, + "type": "object" + }, + "XpnResourceId": { + "description": "Service resource (a.k.a service project) ID.", + "id": "XpnResourceId", + "properties": { + "id": { + "description": "The ID of the service resource. In the case of projects, this field\nsupports project id (e.g., my-project-123) and project number\n(e.g. 12345678).", + "type": "string" }, - "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" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request 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" - } - }, - "parameterOrder": [ - "project", - "region", - "vpnTunnel" + "type": { + "description": "The type of the service resource.", + "enum": [ + "PROJECT", + "XPN_RESOURCE_TYPE_UNSPECIFIED" ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "", + "" ], - "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" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request 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" + } + }, + "type": "object" + }, + "Zone": { + "description": "Represents a Zone resource.\n\nA zone is a deployment area. These deployment areas are subsets of a region.\nFor example the zone us-east1-b is located in theus-east1 region. For more information, readRegions and\nZones.", + "id": "Zone", + "properties": { + "availableCpuPlatforms": { + "description": "[Output Only] Available cpu/platform selections for the zone.", + "items": { + "type": "string" }, - "parameterOrder": [ - "project", - "region", - "resource" + "type": "array" + }, + "creationTimestamp": { + "description": "[Output Only] Creation timestamp inRFC3339\ntext format.", + "type": "string" + }, + "deprecated": { + "$ref": "DeprecationStatus", + "description": "[Output Only] The deprecation status associated with this zone." + }, + "description": { + "description": "[Output Only] Textual description of the resource.", + "type": "string" + }, + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "format": "uint64", + "type": "string" + }, + "kind": { + "default": "compute#zone", + "description": "Output only. [Output Only] Type of the resource. Always compute#zone for\nzones.", + "readOnly": true, + "type": "string" + }, + "name": { + "description": "[Output Only] Name of the resource.", + "type": "string" + }, + "region": { + "description": "[Output Only] Full URL reference to the region which hosts the zone.", + "type": "string" + }, + "resourceStatus": { + "$ref": "ZoneResourceStatus", + "readOnly": true + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" + }, + "status": { + "description": "[Output Only] Status of the zone, either UP orDOWN.", + "enum": [ + "DOWN", + "UP" ], - "request": { - "$ref": "RegionSetLabelsRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enumDescriptions": [ + "", + "" ], - "description": "Sets the labels on a VpnTunnel. To learn more about labels, read the Labeling Resources documentation." + "type": "string" + }, + "supportsPzs": { + "description": "Output only. [Output Only] Reserved for future use.", + "readOnly": true, + "type": "boolean" } - } + }, + "type": "object" }, - "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", + "ZoneList": { + "description": "Contains a list of zone resources.", + "id": "ZoneList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of Zone resources.", + "items": { + "$ref": "Zone" + }, + "type": "array" + }, + "kind": { + "default": "compute#zoneList", + "description": "Output only. Type of resource.", + "readOnly": true, + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for this resource.", + "readOnly": true, + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], "type": "string" }, - "pageToken": { - "description": "Specifies a page token 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:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{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" } }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "ZoneList" + "type": "object" + } + }, + "type": "object" + }, + "ZoneResourceStatus": { + "id": "ZoneResourceStatus", + "properties": { + "upcomingMaintenances": { + "description": "Output only. [Output Only] The upcoming maintenance schedule.", + "items": { + "$ref": "PeriodicPartialMaintenanceSchedule" }, - "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." + "readOnly": true, + "type": "array" + } + }, + "type": "object" + }, + "ZoneSetLabelsRequest": { + "id": "ZoneSetLabelsRequest", + "properties": { + "labelFingerprint": { + "description": "The fingerprint of the previous set of labels for this resource,\nused to detect conflicts. The fingerprint is initially generated by Compute\nEngine and changes after every request to modify or update labels. You must\nalways provide an up-to-date fingerprint hash in order to update or change\nlabels. Make a get() request to the resource to get the latest\nfingerprint.", + "format": "byte", + "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" + "labels": { + "additionalProperties": { + "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 Zone resource." + "description": "The labels to set for this resource.", + "type": "object" } - } + }, + "type": "object" }, - "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" - } + "ZoneSetNestedPolicyRequest": { + "id": "ZoneSetNestedPolicyRequest", + "properties": { + "bindings": { + "description": "Flatten Policy to create a backwacd compatible wire-format.\nDeprecated. Use 'policy' to specify bindings.", + "items": { + "$ref": "Binding" }, - "parameterOrder": [ - "project", - "region" - ], - "response": { - "$ref": "ZoneList" + "type": "array" + }, + "etag": { + "description": "Flatten Policy to create a backward compatible wire-format.\nDeprecated. Use 'policy' to specify the etag.", + "format": "byte", + "type": "string" + }, + "policy": { + "$ref": "Policy", + "description": "REQUIRED: The complete policy to be applied to the 'resource'. The size of\nthe policy is limited to a few 10s of KB. An empty policy is in general a\nvalid policy but certain services (like Projects) might reject them." + } + }, + "type": "object" + }, + "ZoneSetPolicyRequest": { + "id": "ZoneSetPolicyRequest", + "properties": { + "bindings": { + "description": "Flatten Policy to create a backwacd compatible wire-format.\nDeprecated. Use 'policy' to specify bindings.", + "items": { + "$ref": "Binding" }, - "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 under the specific region available to the specified project." + "type": "array" + }, + "etag": { + "description": "Flatten Policy to create a backward compatible wire-format.\nDeprecated. Use 'policy' to specify the etag.", + "format": "byte", + "type": "string" + }, + "policy": { + "$ref": "Policy", + "description": "REQUIRED: The complete policy to be applied to the 'resource'. The size of\nthe policy is limited to a few 10s of KB. An empty policy is in general a\nvalid policy but certain services (like Projects) might reject them." } - } + }, + "type": "object" } - } + }, + "servicePath": "compute/v1/", + "serviceVersion": "v1", + "title": "Compute Engine API", + "version": "v1" } diff --git a/generator/discovery/update_discovery_doc.sh b/generator/discovery/update_discovery_doc.sh index 606319667af54..fa5671923ffa3 100755 --- a/generator/discovery/update_discovery_doc.sh +++ b/generator/discovery/update_discovery_doc.sh @@ -50,20 +50,42 @@ function add_service_directory() { n # skip "cmake-format: sort" line a\ "${service_dir}" } +EOT + sed -i -f - "${PROJECT_ROOT}/${COMPUTE_SERVICE_DIRS_BZL_RELATIVE_PATH}" < 0)); then - cat 1>&2 < 0)); do + case "$1" in + --create-branch=true) + CREATE_BRANCH=true + shift + ;; + --create-branch=false | --no-create-branch) + CREATE_BRANCH=false + shift + ;; + *) + cat 1>&2 <. EOM - exit 1 -fi + exit 1 + ;; + esac +done +readonly CREATE_BRANCH -readonly COMPUTE_DISCOVERY_DOCUMENT_URL="https://www.googleapis.com/discovery/v1/apis/compute/v1/rest" +readonly COMPUTE_DISCOVERY_DOCUMENT_URL="https://raw.githubusercontent.com/googleapis/discovery-artifact-manager/master/discoveries/compute.v1.json" readonly COMPUTE_DISCOVERY_JSON_RELATIVE_PATH="generator/discovery/compute_public_google_rest_v1.json" readonly GENERATOR_CONFIG_RELATIVE_PATH="generator/generator_config.textproto" readonly COMPUTE_SERVICE_DIRS_CMAKE_RELATIVE_PATH="google/cloud/compute/service_dirs.cmake" @@ -72,10 +94,11 @@ readonly COMPUTE_SERVICE_DIRS_BZL_RELATIVE_PATH="google/cloud/compute/service_di io::log_h2 "Fetching discovery document from ${COMPUTE_DISCOVERY_DOCUMENT_URL}" curl "${COMPUTE_DISCOVERY_DOCUMENT_URL}" >"${PROJECT_ROOT}/${COMPUTE_DISCOVERY_JSON_RELATIVE_PATH}" -# TODO(#14028): Make branch creation optional. REVISION=$(sed -En 's/ \"revision\": \"([[:digit:]]+)\",/\1/p' "${PROJECT_ROOT}/${COMPUTE_DISCOVERY_JSON_RELATIVE_PATH}") readonly REVISION -io::run git checkout -B update_compute_discovery_circa_"${REVISION}" +if [[ "${CREATE_BRANCH}" == "true" ]]; then + io::run git checkout -B update_compute_discovery_circa_"${REVISION}" +fi io::log_h2 "Adding updated Discovery JSON ${COMPUTE_DISCOVERY_JSON_RELATIVE_PATH}" git commit -m"chore(compute): update discovery doc circa ${REVISION}" \ @@ -126,7 +149,8 @@ if [[ -n "${NEW_FILES}" ]]; then done io::log_yellow "Adding new directories to ${COMPUTE_SERVICE_DIRS_BZL_RELATIVE_PATH}" - cmake -DGOOGLE_CLOUD_CPP_ENABLE=compute -S . -B ./cmake-build-debug + CMAKE_BUILD_DIR=$(mktemp -d) + cmake -DGOOGLE_CLOUD_CPP_ENABLE=compute -S . -B "${CMAKE_BUILD_DIR}" git commit -m"Update generator_config.textproto and service_dirs files" \ "${PROJECT_ROOT}/${GENERATOR_CONFIG_RELATIVE_PATH}" \ @@ -134,4 +158,4 @@ if [[ -n "${NEW_FILES}" ]]; then "${PROJECT_ROOT}/${COMPUTE_SERVICE_DIRS_BZL_RELATIVE_PATH}" fi -git commit -m"Update generated code" . +git add -A . && git commit -m"Update generated code" diff --git a/generator/generator_config.textproto b/generator/generator_config.textproto index 21697fd84f4eb..987b4c15f8497 100644 --- a/generator/generator_config.textproto +++ b/generator/generator_config.textproto @@ -1793,6 +1793,195 @@ discovery_products { generate_grpc_transport: false } + rest_services { + service_proto_path: "google/cloud/compute/advice/v1/advice.proto" + product_path: "google/cloud/compute/advice/v1" + initial_copyright_year: "2026" + retryable_status_codes: ["kUnavailable"] + generate_rest_transport: true + generate_grpc_transport: false + } + + rest_services { + service_proto_path: "google/cloud/compute/cross_site_networks/v1/cross_site_networks.proto" + product_path: "google/cloud/compute/cross_site_networks/v1" + initial_copyright_year: "2026" + retryable_status_codes: ["kUnavailable"] + generate_rest_transport: true + generate_grpc_transport: false + } + + rest_services { + service_proto_path: "google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies.proto" + product_path: "google/cloud/compute/global_vm_extension_policies/v1" + initial_copyright_year: "2026" + retryable_status_codes: ["kUnavailable"] + generate_rest_transport: true + generate_grpc_transport: false + } + + rest_services { + service_proto_path: "google/cloud/compute/hosts/v1/hosts.proto" + product_path: "google/cloud/compute/hosts/v1" + initial_copyright_year: "2026" + retryable_status_codes: ["kUnavailable"] + generate_rest_transport: true + generate_grpc_transport: false + } + + rest_services { + service_proto_path: "google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups.proto" + product_path: "google/cloud/compute/instant_snapshot_groups/v1" + initial_copyright_year: "2026" + retryable_status_codes: ["kUnavailable"] + generate_rest_transport: true + generate_grpc_transport: false + } + + rest_services { + service_proto_path: "google/cloud/compute/organization_security_policies/v1/organization_security_policies.proto" + product_path: "google/cloud/compute/organization_security_policies/v1" + initial_copyright_year: "2026" + retryable_status_codes: ["kUnavailable"] + generate_rest_transport: true + generate_grpc_transport: false + } + + rest_services { + service_proto_path: "google/cloud/compute/preview_features/v1/preview_features.proto" + product_path: "google/cloud/compute/preview_features/v1" + initial_copyright_year: "2026" + retryable_status_codes: ["kUnavailable"] + generate_rest_transport: true + generate_grpc_transport: false + } + + rest_services { + service_proto_path: "google/cloud/compute/region_backend_buckets/v1/region_backend_buckets.proto" + product_path: "google/cloud/compute/region_backend_buckets/v1" + initial_copyright_year: "2026" + retryable_status_codes: ["kUnavailable"] + generate_rest_transport: true + generate_grpc_transport: false + } + + rest_services { + service_proto_path: "google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks.proto" + product_path: "google/cloud/compute/region_composite_health_checks/v1" + initial_copyright_year: "2026" + retryable_status_codes: ["kUnavailable"] + generate_rest_transport: true + generate_grpc_transport: false + } + + rest_services { + service_proto_path: "google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies.proto" + product_path: "google/cloud/compute/region_health_aggregation_policies/v1" + initial_copyright_year: "2026" + retryable_status_codes: ["kUnavailable"] + generate_rest_transport: true + generate_grpc_transport: false + } + + rest_services { + service_proto_path: "google/cloud/compute/region_health_sources/v1/region_health_sources.proto" + product_path: "google/cloud/compute/region_health_sources/v1" + initial_copyright_year: "2026" + retryable_status_codes: ["kUnavailable"] + generate_rest_transport: true + generate_grpc_transport: false + } + + rest_services { + service_proto_path: "google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests.proto" + product_path: "google/cloud/compute/region_instance_group_manager_resize_requests/v1" + initial_copyright_year: "2026" + retryable_status_codes: ["kUnavailable"] + generate_rest_transport: true + generate_grpc_transport: false + } + + rest_services { + service_proto_path: "google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups.proto" + product_path: "google/cloud/compute/region_instant_snapshot_groups/v1" + initial_copyright_year: "2026" + retryable_status_codes: ["kUnavailable"] + generate_rest_transport: true + generate_grpc_transport: false + } + + rest_services { + service_proto_path: "google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings.proto" + product_path: "google/cloud/compute/region_snapshot_settings/v1" + initial_copyright_year: "2026" + retryable_status_codes: ["kUnavailable"] + generate_rest_transport: true + generate_grpc_transport: false + } + + rest_services { + service_proto_path: "google/cloud/compute/region_snapshots/v1/region_snapshots.proto" + product_path: "google/cloud/compute/region_snapshots/v1" + initial_copyright_year: "2026" + retryable_status_codes: ["kUnavailable"] + generate_rest_transport: true + generate_grpc_transport: false + } + + rest_services { + service_proto_path: "google/cloud/compute/reliability_risks/v1/reliability_risks.proto" + product_path: "google/cloud/compute/reliability_risks/v1" + initial_copyright_year: "2026" + retryable_status_codes: ["kUnavailable"] + generate_rest_transport: true + generate_grpc_transport: false + } + + rest_services { + service_proto_path: "google/cloud/compute/reservation_slots/v1/reservation_slots.proto" + product_path: "google/cloud/compute/reservation_slots/v1" + initial_copyright_year: "2026" + retryable_status_codes: ["kUnavailable"] + generate_rest_transport: true + generate_grpc_transport: false + } + + rest_services { + service_proto_path: "google/cloud/compute/rollout_plans/v1/rollout_plans.proto" + product_path: "google/cloud/compute/rollout_plans/v1" + initial_copyright_year: "2026" + retryable_status_codes: ["kUnavailable"] + generate_rest_transport: true + generate_grpc_transport: false + } + + rest_services { + service_proto_path: "google/cloud/compute/rollouts/v1/rollouts.proto" + product_path: "google/cloud/compute/rollouts/v1" + initial_copyright_year: "2026" + retryable_status_codes: ["kUnavailable"] + generate_rest_transport: true + generate_grpc_transport: false + } + + rest_services { + service_proto_path: "google/cloud/compute/wire_groups/v1/wire_groups.proto" + product_path: "google/cloud/compute/wire_groups/v1" + initial_copyright_year: "2026" + retryable_status_codes: ["kUnavailable"] + generate_rest_transport: true + generate_grpc_transport: false + } + + rest_services { + service_proto_path: "google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies.proto" + product_path: "google/cloud/compute/zone_vm_extension_policies/v1" + initial_copyright_year: "2026" + retryable_status_codes: ["kUnavailable"] + generate_rest_transport: true + generate_grpc_transport: false + } + # update_discovery_doc.sh additions } diff --git a/generator/internal/discovery_resource.cc b/generator/internal/discovery_resource.cc index 6b3761a04e46d..7dd37940fb2f4 100644 --- a/generator/internal/discovery_resource.cc +++ b/generator/internal/discovery_resource.cc @@ -23,6 +23,7 @@ #include "absl/strings/str_replace.h" #include "absl/strings/str_split.h" #include +#include namespace google { namespace cloud { @@ -335,6 +336,11 @@ StatusOr DiscoveryResource::JsonToProtobufService( std::string method_description = method_json.value("description", ""); if (!method_description.empty()) { + static std::regex const kRelativeLinkRegex( + R"(\]\(/([a-zA-Z0-9_#/-]+)\))"); + method_description = + std::regex_replace(method_description, kRelativeLinkRegex, + "](https://cloud.google.com/$1)"); rpc_text.push_back(FormatCommentBlock(method_description, 1)); } auto constexpr kMethodLinkComments = diff --git a/generator/internal/discovery_type_vertex.cc b/generator/internal/discovery_type_vertex.cc index 5ea415d89b2b4..82a574dfa4936 100644 --- a/generator/internal/discovery_type_vertex.cc +++ b/generator/internal/discovery_type_vertex.cc @@ -24,6 +24,7 @@ #include "google/protobuf/descriptor.pb.h" #include #include +#include #include namespace google { @@ -413,15 +414,24 @@ DiscoveryTypeVertex::FormatProperties( // NOLINT(misc-no-recursion) } } +namespace { +std::string FormatDocDescription(std::string description) { + static std::regex const kRelativeLinkRegex(R"(\]\(/([a-zA-Z0-9_#/-]+)\))"); + description = std::regex_replace(description, kRelativeLinkRegex, + "](https://cloud.google.com/$1)"); + // Replace the $ in the description with $$ so the protoc compiler + // will emit a $ instead of trying to perform a substitution. + absl::StrReplaceAll({{"$", "$$"}}, &description); + return description; +} +} // namespace + std::string DiscoveryTypeVertex::FormatMessageDescription( nlohmann::json const& field, int indent_level) { std::string description; if (field.contains("description")) { - auto sanitized_description = std::string(field["description"]); - // Replace the $ in the description with $$ so the protoc compiler - // will emit a $ instead of trying to perform a substitution. - // because protobuf will interpret it as message substitution. - absl::StrReplaceAll({{"$", "$$"}}, &sanitized_description); + auto sanitized_description = + FormatDocDescription(std::string(field["description"])); description = absl::StrCat( FormatCommentBlock(std::string(sanitized_description), indent_level), "\n"); @@ -433,8 +443,9 @@ std::string DiscoveryTypeVertex::FormatMessageDescription( std::vector> enum_comments; for (nlohmann::json::size_type i = 0; i < enum_field.size(); ++i) { if (i < enum_descriptions.size()) { - enum_comments.emplace_back(std::string(enum_field[i]), - std::string(enum_descriptions[i])); + enum_comments.emplace_back( + std::string(enum_field[i]), + FormatDocDescription(std::string(enum_descriptions[i]))); } else { enum_comments.emplace_back(std::string(enum_field[i]), ""); } @@ -549,9 +560,11 @@ StatusOr DiscoveryTypeVertex::JsonToProtobufMessage( int indent_level = 0; std::string proto; if (json_.contains("description")) { + auto sanitized_description = + FormatDocDescription(std::string(json_["description"])); absl::StrAppend( &proto, - FormatCommentBlock(std::string(json_["description"]), indent_level), + FormatCommentBlock(std::string(sanitized_description), indent_level), "\n"); } auto message = diff --git a/generator/internal/discovery_type_vertex_test.cc b/generator/internal/discovery_type_vertex_test.cc index 41fd232967427..45337e1dbec44 100644 --- a/generator/internal/discovery_type_vertex_test.cc +++ b/generator/internal/discovery_type_vertex_test.cc @@ -96,6 +96,18 @@ TEST(DiscoveryTypeVertexTest, FormatMessageDescriptionWithDollarSigns) { Eq("// Example: `sample_table$$20190123`\n")); } +TEST(DiscoveryTypeVertexTest, FormatMessageDescriptionWithRelativeLinks) { + auto constexpr kDescription = + "For more information, see the [known " + "issue](/compute/docs/troubleshooting/known-issues#foo)."; + auto const json = nlohmann::json{{"description", kDescription}}; + EXPECT_EQ(DiscoveryTypeVertex::FormatMessageDescription(json, 0), + "// For more information, see the [known\n" + "// " + "issue](https://cloud.google.com/compute/docs/troubleshooting/" + "known-issues#foo).\n"); +} + TEST(DiscoveryTypeVertexTest, FormatFieldOptionsEmpty) { auto constexpr kOptionalEmptyFieldJson = R"""({})"""; auto json = nlohmann::json::parse(kOptionalEmptyFieldJson, nullptr, false); diff --git a/google/cloud/compute/accelerator_types/v1/accelerator_types_client.h b/google/cloud/compute/accelerator_types/v1/accelerator_types_client.h index f6756f39e144c..40132d2e9630f 100644 --- a/google/cloud/compute/accelerator_types/v1/accelerator_types_client.h +++ b/google/cloud/compute/accelerator_types/v1/accelerator_types_client.h @@ -90,9 +90,10 @@ class AcceleratorTypesClient { // clang-format off /// - /// Retrieves an aggregated list of accelerator types. To prevent failure, - /// Google recommends that you set the `returnPartialSuccess` parameter to - /// `true`. + /// Retrieves an aggregated list of accelerator types. + /// + /// To prevent failure, it is recommended that you set the + /// `returnPartialSuccess` parameter to `true`. /// https://cloud.google.com/compute/docs/reference/rest/v1/acceleratorTypes/aggregatedList /// /// @param project Project ID for this request. @@ -118,8 +119,8 @@ class AcceleratorTypesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.accelerator_types.v1.AggregatedListAcceleratorTypesRequest]: @cloud_cpp_reference_link{google/cloud/compute/accelerator_types/v1/accelerator_types.proto#L73} - /// [google.cloud.cpp.compute.v1.AcceleratorTypesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_002.proto#L285} + /// [google.cloud.cpp.compute.accelerator_types.v1.AggregatedListAcceleratorTypesRequest]: @cloud_cpp_reference_link{google/cloud/compute/accelerator_types/v1/accelerator_types.proto#L74} + /// [google.cloud.cpp.compute.v1.AcceleratorTypesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_003.proto#L339} /// // clang-format on StreamRange GetAcceleratorType( @@ -225,8 +227,8 @@ class AcceleratorTypesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.accelerator_types.v1.GetAcceleratorTypeRequest]: @cloud_cpp_reference_link{google/cloud/compute/accelerator_types/v1/accelerator_types.proto#L155} - /// [google.cloud.cpp.compute.v1.AcceleratorType]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_002.proto#L30} + /// [google.cloud.cpp.compute.accelerator_types.v1.GetAcceleratorTypeRequest]: @cloud_cpp_reference_link{google/cloud/compute/accelerator_types/v1/accelerator_types.proto#L189} + /// [google.cloud.cpp.compute.v1.AcceleratorType]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_003.proto#L32} /// // clang-format on StatusOr GetAcceleratorType( @@ -264,8 +266,8 @@ class AcceleratorTypesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.accelerator_types.v1.ListAcceleratorTypesRequest]: @cloud_cpp_reference_link{google/cloud/compute/accelerator_types/v1/accelerator_types.proto#L169} - /// [google.cloud.cpp.compute.v1.AcceleratorType]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_002.proto#L30} + /// [google.cloud.cpp.compute.accelerator_types.v1.ListAcceleratorTypesRequest]: @cloud_cpp_reference_link{google/cloud/compute/accelerator_types/v1/accelerator_types.proto#L203} + /// [google.cloud.cpp.compute.v1.AcceleratorType]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_003.proto#L32} /// // clang-format on StreamRange @@ -306,8 +308,8 @@ class AcceleratorTypesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.accelerator_types.v1.ListAcceleratorTypesRequest]: @cloud_cpp_reference_link{google/cloud/compute/accelerator_types/v1/accelerator_types.proto#L169} - /// [google.cloud.cpp.compute.v1.AcceleratorType]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_002.proto#L30} + /// [google.cloud.cpp.compute.accelerator_types.v1.ListAcceleratorTypesRequest]: @cloud_cpp_reference_link{google/cloud/compute/accelerator_types/v1/accelerator_types.proto#L203} + /// [google.cloud.cpp.compute.v1.AcceleratorType]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_003.proto#L32} /// // clang-format on StreamRange 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 ffb487ab234e8..ba8378a0ae341 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 @@ -26,8 +26,9 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ACCELERATOR_TYPES_V1_ACCELERATOR_TYPES_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include "google/cloud/compute/v1/internal/common_002.pb.h" -#include "google/cloud/compute/v1/internal/common_023.pb.h" +#include "google/cloud/compute/v1/internal/common_003.pb.h" +#include "google/cloud/compute/v1/internal/common_032.pb.h" +#include "google/cloud/compute/v1/internal/common_134.pb.h" // 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_client.cc b/google/cloud/compute/addresses/v1/addresses_client.cc index e196403d874ad..c97ecb9c1b7be 100644 --- a/google/cloud/compute/addresses/v1/addresses_client.cc +++ b/google/cloud/compute/addresses/v1/addresses_client.cc @@ -304,6 +304,32 @@ AddressesClient::SetLabels( return connection_->SetLabels(operation); } +StatusOr +AddressesClient::TestIamPermissions( + std::string const& project, std::string const& region, + std::string const& resource, + google::cloud::cpp::compute::v1::TestPermissionsRequest const& + test_permissions_request_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::addresses::v1::TestIamPermissionsRequest request; + request.set_project(project); + request.set_region(region); + request.set_resource(resource); + *request.mutable_test_permissions_request_resource() = + test_permissions_request_resource; + return connection_->TestIamPermissions(request); +} + +StatusOr +AddressesClient::TestIamPermissions( + google::cloud::cpp::compute::addresses::v1::TestIamPermissionsRequest const& + request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->TestIamPermissions(request); +} + GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END } // namespace compute_addresses_v1 } // namespace cloud diff --git a/google/cloud/compute/addresses/v1/addresses_client.h b/google/cloud/compute/addresses/v1/addresses_client.h index 267037203dd64..68db23e2e8a1f 100644 --- a/google/cloud/compute/addresses/v1/addresses_client.h +++ b/google/cloud/compute/addresses/v1/addresses_client.h @@ -88,8 +88,10 @@ class AddressesClient { // clang-format off /// - /// Retrieves an aggregated list of addresses. To prevent failure, Google - /// recommends that you set the `returnPartialSuccess` parameter to `true`. + /// Retrieves an aggregated list of addresses. + /// + /// To prevent failure, it is recommended that you set the + /// `returnPartialSuccess` parameter to `true`. /// https://cloud.google.com/compute/docs/reference/rest/v1/addresses/aggregatedList /// /// @param project Project ID for this request. @@ -115,8 +117,8 @@ class AddressesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.addresses.v1.AggregatedListAddressesRequest]: @cloud_cpp_reference_link{google/cloud/compute/addresses/v1/addresses.proto#L125} - /// [google.cloud.cpp.compute.v1.AddressesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_005.proto#L137} + /// [google.cloud.cpp.compute.addresses.v1.AggregatedListAddressesRequest]: @cloud_cpp_reference_link{google/cloud/compute/addresses/v1/addresses.proto#L141} + /// [google.cloud.cpp.compute.v1.AddressesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_006.proto#L159} /// // clang-format on StreamRange> DeleteAddress( @@ -249,7 +253,7 @@ class AddressesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.addresses.v1.DeleteAddressRequest]: @cloud_cpp_reference_link{google/cloud/compute/addresses/v1/addresses.proto#L207} + /// [google.cloud.cpp.compute.addresses.v1.DeleteAddressRequest]: @cloud_cpp_reference_link{google/cloud/compute/addresses/v1/addresses.proto#L256} /// // clang-format on future> DeleteAddress( @@ -308,8 +312,8 @@ class AddressesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.addresses.v1.GetAddressRequest]: @cloud_cpp_reference_link{google/cloud/compute/addresses/v1/addresses.proto#L240} - /// [google.cloud.cpp.compute.v1.Address]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_004.proto#L30} + /// [google.cloud.cpp.compute.addresses.v1.GetAddressRequest]: @cloud_cpp_reference_link{google/cloud/compute/addresses/v1/addresses.proto#L292} + /// [google.cloud.cpp.compute.v1.Address]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_005.proto#L35} /// // clang-format on StatusOr GetAddress( @@ -340,8 +344,8 @@ class AddressesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.addresses.v1.GetAddressRequest]: @cloud_cpp_reference_link{google/cloud/compute/addresses/v1/addresses.proto#L240} - /// [google.cloud.cpp.compute.v1.Address]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_004.proto#L30} + /// [google.cloud.cpp.compute.addresses.v1.GetAddressRequest]: @cloud_cpp_reference_link{google/cloud/compute/addresses/v1/addresses.proto#L292} + /// [google.cloud.cpp.compute.v1.Address]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_005.proto#L35} /// // clang-format on StatusOr GetAddress( @@ -378,7 +382,7 @@ class AddressesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.addresses.v1.InsertAddressRequest]: @cloud_cpp_reference_link{google/cloud/compute/addresses/v1/addresses.proto#L255} + /// [google.cloud.cpp.compute.addresses.v1.InsertAddressRequest]: @cloud_cpp_reference_link{google/cloud/compute/addresses/v1/addresses.proto#L307} /// // clang-format on future> InsertAddress( @@ -434,7 +438,7 @@ class AddressesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.addresses.v1.InsertAddressRequest]: @cloud_cpp_reference_link{google/cloud/compute/addresses/v1/addresses.proto#L255} + /// [google.cloud.cpp.compute.addresses.v1.InsertAddressRequest]: @cloud_cpp_reference_link{google/cloud/compute/addresses/v1/addresses.proto#L307} /// // clang-format on future> InsertAddress( @@ -474,7 +478,8 @@ class AddressesClient { // clang-format off /// - /// Retrieves a list of addresses contained within the specified region. + /// Retrieves a list of addresses contained within + /// the specified region. /// https://cloud.google.com/compute/docs/reference/rest/v1/addresses/list /// /// @param project Project ID for this request. @@ -501,8 +506,8 @@ class AddressesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.addresses.v1.ListAddressesRequest]: @cloud_cpp_reference_link{google/cloud/compute/addresses/v1/addresses.proto#L288} - /// [google.cloud.cpp.compute.v1.Address]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_004.proto#L30} + /// [google.cloud.cpp.compute.addresses.v1.ListAddressesRequest]: @cloud_cpp_reference_link{google/cloud/compute/addresses/v1/addresses.proto#L343} + /// [google.cloud.cpp.compute.v1.Address]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_005.proto#L35} /// // clang-format on StreamRange ListAddresses( @@ -510,7 +515,8 @@ class AddressesClient { // clang-format off /// - /// Retrieves a list of addresses contained within the specified region. + /// Retrieves a list of addresses contained within + /// the specified region. /// https://cloud.google.com/compute/docs/reference/rest/v1/addresses/list /// /// @param request Unary RPCs, such as the one wrapped by this @@ -541,8 +547,8 @@ class AddressesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.addresses.v1.ListAddressesRequest]: @cloud_cpp_reference_link{google/cloud/compute/addresses/v1/addresses.proto#L288} - /// [google.cloud.cpp.compute.v1.Address]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_004.proto#L30} + /// [google.cloud.cpp.compute.addresses.v1.ListAddressesRequest]: @cloud_cpp_reference_link{google/cloud/compute/addresses/v1/addresses.proto#L343} + /// [google.cloud.cpp.compute.v1.Address]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_005.proto#L35} /// // clang-format on StreamRange ListAddresses( @@ -578,7 +584,7 @@ class AddressesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.addresses.v1.MoveRequest]: @cloud_cpp_reference_link{google/cloud/compute/addresses/v1/addresses.proto#L360} + /// [google.cloud.cpp.compute.addresses.v1.MoveRequest]: @cloud_cpp_reference_link{google/cloud/compute/addresses/v1/addresses.proto#L448} /// // clang-format on future> Move( @@ -637,7 +643,7 @@ class AddressesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.addresses.v1.MoveRequest]: @cloud_cpp_reference_link{google/cloud/compute/addresses/v1/addresses.proto#L360} + /// [google.cloud.cpp.compute.addresses.v1.MoveRequest]: @cloud_cpp_reference_link{google/cloud/compute/addresses/v1/addresses.proto#L448} /// // clang-format on future> Move( @@ -675,8 +681,8 @@ class AddressesClient { // clang-format off /// - /// Sets the labels on an Address. To learn more about labels, read the - /// Labeling Resources documentation. + /// Sets the labels on an Address. To learn more about labels, read theLabeling + /// Resources documentation. /// https://cloud.google.com/compute/docs/reference/rest/v1/addresses/setLabels /// /// @param project Project ID for this request. @@ -703,7 +709,7 @@ class AddressesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.addresses.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/addresses/v1/addresses.proto#L398} + /// [google.cloud.cpp.compute.addresses.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/addresses/v1/addresses.proto#L489} /// // clang-format on future> SetLabels( @@ -733,8 +739,8 @@ class AddressesClient { // clang-format off /// - /// Sets the labels on an Address. To learn more about labels, read the - /// Labeling Resources documentation. + /// Sets the labels on an Address. To learn more about labels, read theLabeling + /// Resources documentation. /// https://cloud.google.com/compute/docs/reference/rest/v1/addresses/setLabels /// /// @param request Unary RPCs, such as the one wrapped by this @@ -763,7 +769,7 @@ class AddressesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.addresses.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/addresses/v1/addresses.proto#L398} + /// [google.cloud.cpp.compute.addresses.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/addresses/v1/addresses.proto#L489} /// // clang-format on future> SetLabels( @@ -801,6 +807,73 @@ class AddressesClient { google::cloud::cpp::compute::v1::Operation const& operation, Options opts = {}); + // clang-format off + /// + /// Returns permissions that a caller has on the specified resource. + /// https://cloud.google.com/compute/docs/reference/rest/v1/addresses/testIamPermissions + /// + /// @param project Project ID for this request. + /// @param region The name of the region for this request. + /// @param resource Name or id of the resource for this request. + /// @param test_permissions_request_resource The TestPermissionsRequest for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.TestPermissionsResponse]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.addresses.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/addresses/v1/addresses.proto#L530} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} + /// + // clang-format on + StatusOr + TestIamPermissions( + std::string const& project, std::string const& region, + std::string const& resource, + google::cloud::cpp::compute::v1::TestPermissionsRequest const& + test_permissions_request_resource, + Options opts = {}); + + // clang-format off + /// + /// Returns permissions that a caller has on the specified resource. + /// https://cloud.google.com/compute/docs/reference/rest/v1/addresses/testIamPermissions + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.addresses.v1.TestIamPermissionsRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.TestPermissionsResponse]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.addresses.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/addresses/v1/addresses.proto#L530} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} + /// + // clang-format on + StatusOr + TestIamPermissions(google::cloud::cpp::compute::addresses::v1:: + TestIamPermissionsRequest const& request, + Options opts = {}); + private: std::shared_ptr connection_; Options options_; diff --git a/google/cloud/compute/addresses/v1/addresses_connection.cc b/google/cloud/compute/addresses/v1/addresses_connection.cc index 9838a349811e5..b2d17532f964d 100644 --- a/google/cloud/compute/addresses/v1/addresses_connection.cc +++ b/google/cloud/compute/addresses/v1/addresses_connection.cc @@ -154,6 +154,13 @@ AddressesConnection::SetLabels( Status(StatusCode::kUnimplemented, "not implemented")); } +StatusOr +AddressesConnection::TestIamPermissions( + google::cloud::cpp::compute::addresses::v1:: + TestIamPermissionsRequest const&) { + return Status(StatusCode::kUnimplemented, "not implemented"); +} + GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END } // namespace compute_addresses_v1 } // namespace cloud diff --git a/google/cloud/compute/addresses/v1/addresses_connection.h b/google/cloud/compute/addresses/v1/addresses_connection.h index e06856afb8acc..4255770c24fe0 100644 --- a/google/cloud/compute/addresses/v1/addresses_connection.h +++ b/google/cloud/compute/addresses/v1/addresses_connection.h @@ -244,6 +244,10 @@ class AddressesConnection { virtual future> SetLabels(google::cloud::cpp::compute::v1::Operation const& operation); + + virtual StatusOr + TestIamPermissions(google::cloud::cpp::compute::addresses::v1:: + TestIamPermissionsRequest const& request); }; GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END diff --git a/google/cloud/compute/addresses/v1/addresses_connection_idempotency_policy.cc b/google/cloud/compute/addresses/v1/addresses_connection_idempotency_policy.cc index 3870b6975bb2a..28a215544394f 100644 --- a/google/cloud/compute/addresses/v1/addresses_connection_idempotency_policy.cc +++ b/google/cloud/compute/addresses/v1/addresses_connection_idempotency_policy.cc @@ -71,6 +71,12 @@ Idempotency AddressesConnectionIdempotencyPolicy::SetLabels( return Idempotency::kNonIdempotent; } +Idempotency AddressesConnectionIdempotencyPolicy::TestIamPermissions( + google::cloud::cpp::compute::addresses::v1:: + TestIamPermissionsRequest const&) { + return Idempotency::kNonIdempotent; +} + std::unique_ptr MakeDefaultAddressesConnectionIdempotencyPolicy() { return std::make_unique(); diff --git a/google/cloud/compute/addresses/v1/addresses_connection_idempotency_policy.h b/google/cloud/compute/addresses/v1/addresses_connection_idempotency_policy.h index c4449b9e64435..ba9ba4d2b7a82 100644 --- a/google/cloud/compute/addresses/v1/addresses_connection_idempotency_policy.h +++ b/google/cloud/compute/addresses/v1/addresses_connection_idempotency_policy.h @@ -61,6 +61,10 @@ class AddressesConnectionIdempotencyPolicy { virtual google::cloud::Idempotency SetLabels( google::cloud::cpp::compute::addresses::v1::SetLabelsRequest const& request); + + virtual google::cloud::Idempotency TestIamPermissions( + google::cloud::cpp::compute::addresses::v1:: + TestIamPermissionsRequest const& request); }; std::unique_ptr diff --git a/google/cloud/compute/addresses/v1/addresses_proto_export.h b/google/cloud/compute/addresses/v1/addresses_proto_export.h index 7ccf3339454b3..d01138b821eb0 100644 --- a/google/cloud/compute/addresses/v1/addresses_proto_export.h +++ b/google/cloud/compute/addresses/v1/addresses_proto_export.h @@ -26,10 +26,11 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ADDRESSES_V1_ADDRESSES_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include "google/cloud/compute/v1/internal/common_004.pb.h" #include "google/cloud/compute/v1/internal/common_005.pb.h" -#include "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_107.pb.h" +#include "google/cloud/compute/v1/internal/common_006.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_125.pb.h" +#include "google/cloud/compute/v1/internal/common_171.pb.h" // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ADDRESSES_V1_ADDRESSES_PROTO_EXPORT_H diff --git a/google/cloud/compute/addresses/v1/internal/addresses_rest_connection_impl.cc b/google/cloud/compute/addresses/v1/internal/addresses_rest_connection_impl.cc index 0677eb493a80f..265be4a0613f8 100644 --- a/google/cloud/compute/addresses/v1/internal/addresses_rest_connection_impl.cc +++ b/google/cloud/compute/addresses/v1/internal/addresses_rest_connection_impl.cc @@ -663,6 +663,22 @@ AddressesRestConnectionImpl::SetLabels( }); } +StatusOr +AddressesRestConnectionImpl::TestIamPermissions( + google::cloud::cpp::compute::addresses::v1::TestIamPermissionsRequest const& + request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->TestIamPermissions(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::addresses::v1:: + TestIamPermissionsRequest const& request) { + return stub_->TestIamPermissions(rest_context, options, request); + }, + *current, request, __func__); +} + GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END } // namespace compute_addresses_v1_internal } // namespace cloud diff --git a/google/cloud/compute/addresses/v1/internal/addresses_rest_connection_impl.h b/google/cloud/compute/addresses/v1/internal/addresses_rest_connection_impl.h index 4375ec5e5f1ce..e7533476e34d5 100644 --- a/google/cloud/compute/addresses/v1/internal/addresses_rest_connection_impl.h +++ b/google/cloud/compute/addresses/v1/internal/addresses_rest_connection_impl.h @@ -112,6 +112,10 @@ class AddressesRestConnectionImpl future> SetLabels( google::cloud::cpp::compute::v1::Operation const& operation) override; + StatusOr + TestIamPermissions(google::cloud::cpp::compute::addresses::v1:: + TestIamPermissionsRequest const& request) override; + private: static std::unique_ptr retry_policy(Options const& options) { diff --git a/google/cloud/compute/addresses/v1/internal/addresses_rest_logging_decorator.cc b/google/cloud/compute/addresses/v1/internal/addresses_rest_logging_decorator.cc index fbaa0577ea263..22c3fad8c9b09 100644 --- a/google/cloud/compute/addresses/v1/internal/addresses_rest_logging_decorator.cc +++ b/google/cloud/compute/addresses/v1/internal/addresses_rest_logging_decorator.cc @@ -210,6 +210,20 @@ AddressesRestLogging::SetLabels( rest_context, options, request, __func__, tracing_options_); } +StatusOr +AddressesRestLogging::TestIamPermissions( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::addresses::v1::TestIamPermissionsRequest const& + request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::addresses::v1:: + TestIamPermissionsRequest const& request) { + return child_->TestIamPermissions(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + future> AddressesRestLogging::AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/addresses/v1/internal/addresses_rest_logging_decorator.h b/google/cloud/compute/addresses/v1/internal/addresses_rest_logging_decorator.h index ec6b11bbb8a95..518cf0ff2ef8c 100644 --- a/google/cloud/compute/addresses/v1/internal/addresses_rest_logging_decorator.h +++ b/google/cloud/compute/addresses/v1/internal/addresses_rest_logging_decorator.h @@ -115,6 +115,12 @@ class AddressesRestLogging : public AddressesRestStub { google::cloud::cpp::compute::addresses::v1::SetLabelsRequest const& request) override; + StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::addresses::v1:: + TestIamPermissionsRequest const& request) override; + future> AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/addresses/v1/internal/addresses_rest_metadata_decorator.cc b/google/cloud/compute/addresses/v1/internal/addresses_rest_metadata_decorator.cc index 98fdcca0785f6..37201a0857157 100644 --- a/google/cloud/compute/addresses/v1/internal/addresses_rest_metadata_decorator.cc +++ b/google/cloud/compute/addresses/v1/internal/addresses_rest_metadata_decorator.cc @@ -147,6 +147,15 @@ AddressesRestMetadata::SetLabels( return child_->SetLabels(rest_context, options, request); } +StatusOr +AddressesRestMetadata::TestIamPermissions( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::addresses::v1::TestIamPermissionsRequest const& + request) { + SetMetadata(rest_context, options); + return child_->TestIamPermissions(rest_context, options, request); +} + future> AddressesRestMetadata::AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/addresses/v1/internal/addresses_rest_metadata_decorator.h b/google/cloud/compute/addresses/v1/internal/addresses_rest_metadata_decorator.h index 14d1d54796646..0879b2e72d3c8 100644 --- a/google/cloud/compute/addresses/v1/internal/addresses_rest_metadata_decorator.h +++ b/google/cloud/compute/addresses/v1/internal/addresses_rest_metadata_decorator.h @@ -114,6 +114,12 @@ class AddressesRestMetadata : public AddressesRestStub { google::cloud::cpp::compute::addresses::v1::SetLabelsRequest const& request) override; + StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::addresses::v1:: + TestIamPermissionsRequest const& request) override; + google::cloud::future> AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/addresses/v1/internal/addresses_rest_stub.cc b/google/cloud/compute/addresses/v1/internal/addresses_rest_stub.cc index 0ba9642434deb..c545833f06302 100644 --- a/google/cloud/compute/addresses/v1/internal/addresses_rest_stub.cc +++ b/google/cloud/compute/addresses/v1/internal/addresses_rest_stub.cc @@ -344,6 +344,25 @@ DefaultAddressesRestStub::SetLabels( std::move(query_params)); } +StatusOr +DefaultAddressesRestStub::TestIamPermissions( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::addresses::v1::TestIamPermissionsRequest const& + request) { + std::vector> query_params; + return rest_internal::Post< + google::cloud::cpp::compute::v1::TestPermissionsResponse>( + *service_, rest_context, request.test_permissions_request_resource(), + false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "regions", "/", + request.region(), "/", "addresses", "/", request.resource(), + "/", "testIamPermissions"), + std::move(query_params)); +} + future> DefaultAddressesRestStub::AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/addresses/v1/internal/addresses_rest_stub.h b/google/cloud/compute/addresses/v1/internal/addresses_rest_stub.h index 4918d07bcd167..e5474f776c544 100644 --- a/google/cloud/compute/addresses/v1/internal/addresses_rest_stub.h +++ b/google/cloud/compute/addresses/v1/internal/addresses_rest_stub.h @@ -112,6 +112,12 @@ class AddressesRestStub { google::cloud::cpp::compute::addresses::v1::SetLabelsRequest const& request) = 0; + virtual StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::addresses::v1:: + TestIamPermissionsRequest const& request) = 0; + virtual future> AsyncGetOperation( google::cloud::CompletionQueue& cq, @@ -210,6 +216,12 @@ class DefaultAddressesRestStub : public AddressesRestStub { google::cloud::cpp::compute::addresses::v1::SetLabelsRequest const& request) override; + StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::addresses::v1:: + TestIamPermissionsRequest const& request) override; + future> AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/addresses/v1/internal/addresses_tracing_connection.cc b/google/cloud/compute/addresses/v1/internal/addresses_tracing_connection.cc index 42f2867024dfd..344c9630c2f90 100644 --- a/google/cloud/compute/addresses/v1/internal/addresses_tracing_connection.cc +++ b/google/cloud/compute/addresses/v1/internal/addresses_tracing_connection.cc @@ -184,6 +184,16 @@ AddressesTracingConnection::SetLabels( return internal::EndSpan(std::move(span), child_->SetLabels(operation)); } +StatusOr +AddressesTracingConnection::TestIamPermissions( + google::cloud::cpp::compute::addresses::v1::TestIamPermissionsRequest const& + request) { + auto span = internal::MakeSpan( + "compute_addresses_v1::AddressesConnection::TestIamPermissions"); + auto scope = opentelemetry::trace::Scope(span); + return internal::EndSpan(*span, child_->TestIamPermissions(request)); +} + std::shared_ptr MakeAddressesTracingConnection( std::shared_ptr conn) { diff --git a/google/cloud/compute/addresses/v1/internal/addresses_tracing_connection.h b/google/cloud/compute/addresses/v1/internal/addresses_tracing_connection.h index e2b12ab96f45d..b01ea3359a5a1 100644 --- a/google/cloud/compute/addresses/v1/internal/addresses_tracing_connection.h +++ b/google/cloud/compute/addresses/v1/internal/addresses_tracing_connection.h @@ -100,6 +100,10 @@ class AddressesTracingConnection future> SetLabels( google::cloud::cpp::compute::v1::Operation const& operation) override; + StatusOr + TestIamPermissions(google::cloud::cpp::compute::addresses::v1:: + TestIamPermissionsRequest const& request) override; + private: std::shared_ptr child_; }; diff --git a/google/cloud/compute/addresses/v1/mocks/mock_addresses_connection.h b/google/cloud/compute/addresses/v1/mocks/mock_addresses_connection.h index c1a2a48b0fe37..f9d24ddbc9900 100644 --- a/google/cloud/compute/addresses/v1/mocks/mock_addresses_connection.h +++ b/google/cloud/compute/addresses/v1/mocks/mock_addresses_connection.h @@ -232,6 +232,13 @@ class MockAddressesConnection SetLabels, (google::cloud::cpp::compute::v1::Operation const& operation), (override)); + + MOCK_METHOD( + StatusOr, + TestIamPermissions, + (google::cloud::cpp::compute::addresses::v1:: + TestIamPermissionsRequest const& request), + (override)); }; GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END diff --git a/google/cloud/compute/advice/v1/advice_client.cc b/google/cloud/compute/advice/v1/advice_client.cc new file mode 100644 index 0000000000000..c569376ad447f --- /dev/null +++ b/google/cloud/compute/advice/v1/advice_client.cc @@ -0,0 +1,61 @@ +// Copyright 2026 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. +// source: google/cloud/compute/advice/v1/advice.proto + +#include "google/cloud/compute/advice/v1/advice_client.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_advice_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +AdviceClient::AdviceClient(std::shared_ptr connection, + Options opts) + : connection_(std::move(connection)), + options_( + internal::MergeOptions(std::move(opts), connection_->options())) {} +AdviceClient::~AdviceClient() = default; + +StatusOr +AdviceClient::CalendarMode( + std::string const& project, std::string const& region, + google::cloud::cpp::compute::v1::CalendarModeAdviceRequest const& + calendar_mode_advice_request_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::advice::v1::CalendarModeRequest request; + request.set_project(project); + request.set_region(region); + *request.mutable_calendar_mode_advice_request_resource() = + calendar_mode_advice_request_resource; + return connection_->CalendarMode(request); +} + +StatusOr +AdviceClient::CalendarMode( + google::cloud::cpp::compute::advice::v1::CalendarModeRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->CalendarMode(request); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_advice_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/advice/v1/advice_client.h b/google/cloud/compute/advice/v1/advice_client.h new file mode 100644 index 0000000000000..24aa4add0b7aa --- /dev/null +++ b/google/cloud/compute/advice/v1/advice_client.h @@ -0,0 +1,168 @@ +// Copyright 2026 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. +// source: google/cloud/compute/advice/v1/advice.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ADVICE_V1_ADVICE_CLIENT_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ADVICE_V1_ADVICE_CLIENT_H + +#include "google/cloud/compute/advice/v1/advice_rest_connection.h" +#include "google/cloud/future.h" +#include "google/cloud/options.h" +#include "google/cloud/polling_policy.h" +#include "google/cloud/status_or.h" +#include "google/cloud/version.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_advice_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/// +/// Service for the advice resource. +/// https://cloud.google.com/compute/docs/reference/rest/v1/advice +/// +/// @par Equality +/// +/// Instances of this class created via copy-construction or copy-assignment +/// always compare equal. Instances created with equal +/// `std::shared_ptr<*Connection>` objects compare equal. Objects that compare +/// equal share the same underlying resources. +/// +/// @par Performance +/// +/// Creating a new instance of this class is a relatively expensive operation, +/// new objects establish new connections to the service. In contrast, +/// copy-construction, move-construction, and the corresponding assignment +/// operations are relatively efficient as the copies share all underlying +/// resources. +/// +/// @par Thread Safety +/// +/// Concurrent access to different instances of this class, even if they compare +/// equal, is guaranteed to work. Two or more threads operating on the same +/// instance of this class is not guaranteed to work. Since copy-construction +/// and move-construction is a relatively efficient operation, consider using +/// such a copy when using this class from multiple threads. +/// +class AdviceClient { + public: + explicit AdviceClient(std::shared_ptr connection, + Options opts = {}); + ~AdviceClient(); + + ///@{ + /// @name Copy and move support + AdviceClient(AdviceClient const&) = default; + AdviceClient& operator=(AdviceClient const&) = default; + AdviceClient(AdviceClient&&) = default; + AdviceClient& operator=(AdviceClient&&) = default; + ///@} + + ///@{ + /// @name Equality + friend bool operator==(AdviceClient const& a, AdviceClient const& b) { + return a.connection_ == b.connection_; + } + friend bool operator!=(AdviceClient const& a, AdviceClient const& b) { + return !(a == b); + } + ///@} + + // clang-format off + /// + /// Advise how, where and when to create the requested amount of instances + /// with specified accelerators, within the specified time and location limits. + /// The method recommends creating future reservations for the requested + /// resources. + /// https://cloud.google.com/compute/docs/reference/rest/v1/advice/calendarMode + /// + /// @param project Project ID for this request. + /// @param region Name of the region for this request. + /// @param calendar_mode_advice_request_resource The CalendarModeAdviceRequest for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.CalendarModeAdviceResponse]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.advice.v1.CalendarModeRequest]: @cloud_cpp_reference_link{google/cloud/compute/advice/v1/advice.proto#L54} + /// [google.cloud.cpp.compute.v1.CalendarModeAdviceResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_024.proto#L38} + /// + // clang-format on + StatusOr + CalendarMode(std::string const& project, std::string const& region, + google::cloud::cpp::compute::v1::CalendarModeAdviceRequest const& + calendar_mode_advice_request_resource, + Options opts = {}); + + // clang-format off + /// + /// Advise how, where and when to create the requested amount of instances + /// with specified accelerators, within the specified time and location limits. + /// The method recommends creating future reservations for the requested + /// resources. + /// https://cloud.google.com/compute/docs/reference/rest/v1/advice/calendarMode + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.advice.v1.CalendarModeRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.CalendarModeAdviceResponse]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.advice.v1.CalendarModeRequest]: @cloud_cpp_reference_link{google/cloud/compute/advice/v1/advice.proto#L54} + /// [google.cloud.cpp.compute.v1.CalendarModeAdviceResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_024.proto#L38} + /// + // clang-format on + StatusOr + CalendarMode( + google::cloud::cpp::compute::advice::v1::CalendarModeRequest const& + request, + Options opts = {}); + + private: + std::shared_ptr connection_; + Options options_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_advice_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ADVICE_V1_ADVICE_CLIENT_H diff --git a/google/cloud/compute/advice/v1/advice_connection.cc b/google/cloud/compute/advice/v1/advice_connection.cc new file mode 100644 index 0000000000000..7a5f1c0b0fcf4 --- /dev/null +++ b/google/cloud/compute/advice/v1/advice_connection.cc @@ -0,0 +1,47 @@ +// Copyright 2026 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. +// source: google/cloud/compute/advice/v1/advice.proto + +#include "google/cloud/compute/advice/v1/advice_connection.h" +#include "google/cloud/compute/advice/v1/advice_options.h" +#include "google/cloud/compute/advice/v1/internal/advice_option_defaults.h" +#include "google/cloud/compute/advice/v1/internal/advice_tracing_connection.h" +#include "google/cloud/background_threads.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/grpc_options.h" +#include "google/cloud/internal/unified_grpc_credentials.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_advice_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +AdviceConnection::~AdviceConnection() = default; + +StatusOr +AdviceConnection::CalendarMode( + google::cloud::cpp::compute::advice::v1::CalendarModeRequest const&) { + return Status(StatusCode::kUnimplemented, "not implemented"); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_advice_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/advice/v1/advice_connection.h b/google/cloud/compute/advice/v1/advice_connection.h new file mode 100644 index 0000000000000..67c5c400c9c77 --- /dev/null +++ b/google/cloud/compute/advice/v1/advice_connection.h @@ -0,0 +1,191 @@ +// Copyright 2026 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. +// source: google/cloud/compute/advice/v1/advice.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ADVICE_V1_ADVICE_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ADVICE_V1_ADVICE_CONNECTION_H + +#include "google/cloud/compute/advice/v1/advice.pb.h" +#include "google/cloud/compute/advice/v1/advice_connection_idempotency_policy.h" +#include "google/cloud/compute/advice/v1/internal/advice_retry_traits.h" +#include "google/cloud/backoff_policy.h" +#include "google/cloud/internal/retry_policy_impl.h" +#include "google/cloud/options.h" +#include "google/cloud/status_or.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_advice_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/// The retry policy for `AdviceConnection`. +class AdviceRetryPolicy : public ::google::cloud::RetryPolicy { + public: + /// Creates a new instance of the policy, reset to the initial state. + virtual std::unique_ptr clone() const = 0; +}; + +/** + * A retry policy for `AdviceConnection` based on counting errors. + * + * This policy stops retrying if: + * - An RPC returns a non-transient error. + * - More than a prescribed number of transient failures is detected. + * + * In this class the following status codes are treated as transient errors: + * - [`kUnavailable`](@ref google::cloud::StatusCode) + */ +class AdviceLimitedErrorCountRetryPolicy : public AdviceRetryPolicy { + public: + /** + * Create an instance that tolerates up to @p maximum_failures transient + * errors. + * + * @note Disable the retry loop by providing an instance of this policy with + * @p maximum_failures == 0. + */ + explicit AdviceLimitedErrorCountRetryPolicy(int maximum_failures) + : impl_(maximum_failures) {} + + AdviceLimitedErrorCountRetryPolicy( + AdviceLimitedErrorCountRetryPolicy&& rhs) noexcept + : AdviceLimitedErrorCountRetryPolicy(rhs.maximum_failures()) {} + AdviceLimitedErrorCountRetryPolicy( + AdviceLimitedErrorCountRetryPolicy const& rhs) noexcept + : AdviceLimitedErrorCountRetryPolicy(rhs.maximum_failures()) {} + + int maximum_failures() const { return impl_.maximum_failures(); } + + bool OnFailure(Status const& status) override { + return impl_.OnFailure(status); + } + bool IsExhausted() const override { return impl_.IsExhausted(); } + bool IsPermanentFailure(Status const& status) const override { + return impl_.IsPermanentFailure(status); + } + std::unique_ptr clone() const override { + return std::make_unique( + maximum_failures()); + } + + // This is provided only for backwards compatibility. + using BaseType = AdviceRetryPolicy; + + private: + google::cloud::internal::LimitedErrorCountRetryPolicy< + compute_advice_v1_internal::AdviceRetryTraits> + impl_; +}; + +/** + * A retry policy for `AdviceConnection` based on elapsed time. + * + * This policy stops retrying if: + * - An RPC returns a non-transient error. + * - The elapsed time in the retry loop exceeds a prescribed duration. + * + * In this class the following status codes are treated as transient errors: + * - [`kUnavailable`](@ref google::cloud::StatusCode) + */ +class AdviceLimitedTimeRetryPolicy : public AdviceRetryPolicy { + public: + /** + * Constructor given a `std::chrono::duration<>` object. + * + * @tparam DurationRep a placeholder to match the `Rep` tparam for @p + * duration's type. The semantics of this template parameter are + * documented in `std::chrono::duration<>`. In brief, the underlying + * arithmetic type used to store the number of ticks. For our purposes it + * is simply a formal parameter. + * @tparam DurationPeriod a placeholder to match the `Period` tparam for @p + * duration's type. The semantics of this template parameter are + * documented in `std::chrono::duration<>`. In brief, the length of the + * tick in seconds, expressed as a `std::ratio<>`. For our purposes it is + * simply a formal parameter. + * @param maximum_duration the maximum time allowed before the policy expires. + * While the application can express this time in any units they desire, + * the class truncates to milliseconds. + * + * @see https://en.cppreference.com/w/cpp/chrono/duration for more information + * about `std::chrono::duration`. + */ + template + explicit AdviceLimitedTimeRetryPolicy( + std::chrono::duration maximum_duration) + : impl_(maximum_duration) {} + + AdviceLimitedTimeRetryPolicy(AdviceLimitedTimeRetryPolicy&& rhs) noexcept + : AdviceLimitedTimeRetryPolicy(rhs.maximum_duration()) {} + AdviceLimitedTimeRetryPolicy(AdviceLimitedTimeRetryPolicy const& rhs) noexcept + : AdviceLimitedTimeRetryPolicy(rhs.maximum_duration()) {} + + std::chrono::milliseconds maximum_duration() const { + return impl_.maximum_duration(); + } + + bool OnFailure(Status const& status) override { + return impl_.OnFailure(status); + } + bool IsExhausted() const override { return impl_.IsExhausted(); } + bool IsPermanentFailure(Status const& status) const override { + return impl_.IsPermanentFailure(status); + } + std::unique_ptr clone() const override { + return std::make_unique(maximum_duration()); + } + + // This is provided only for backwards compatibility. + using BaseType = AdviceRetryPolicy; + + private: + google::cloud::internal::LimitedTimeRetryPolicy< + compute_advice_v1_internal::AdviceRetryTraits> + impl_; +}; + +/** + * The `AdviceConnection` object for `AdviceClient`. + * + * This interface defines virtual methods for each of the user-facing overload + * sets in `AdviceClient`. This allows users to inject custom behavior + * (e.g., with a Google Mock object) when writing tests that use objects of type + * `AdviceClient`. + * + * To create a concrete instance, see `MakeAdviceConnection()`. + * + * For mocking, see `compute_advice_v1_mocks::MockAdviceConnection`. + */ +class AdviceConnection { + public: + virtual ~AdviceConnection() = 0; + + virtual Options options() { return Options{}; } + + virtual StatusOr + CalendarMode( + google::cloud::cpp::compute::advice::v1::CalendarModeRequest const& + request); +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_advice_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ADVICE_V1_ADVICE_CONNECTION_H diff --git a/google/cloud/compute/advice/v1/advice_connection_idempotency_policy.cc b/google/cloud/compute/advice/v1/advice_connection_idempotency_policy.cc new file mode 100644 index 0000000000000..fae46c272b3b3 --- /dev/null +++ b/google/cloud/compute/advice/v1/advice_connection_idempotency_policy.cc @@ -0,0 +1,50 @@ +// Copyright 2026 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. +// source: google/cloud/compute/advice/v1/advice.proto + +#include "google/cloud/compute/advice/v1/advice_connection_idempotency_policy.h" +#include + +namespace google { +namespace cloud { +namespace compute_advice_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +using ::google::cloud::Idempotency; + +AdviceConnectionIdempotencyPolicy::~AdviceConnectionIdempotencyPolicy() = + default; + +std::unique_ptr +AdviceConnectionIdempotencyPolicy::clone() const { + return std::make_unique(*this); +} + +Idempotency AdviceConnectionIdempotencyPolicy::CalendarMode( + google::cloud::cpp::compute::advice::v1::CalendarModeRequest const&) { + return Idempotency::kNonIdempotent; +} + +std::unique_ptr +MakeDefaultAdviceConnectionIdempotencyPolicy() { + return std::make_unique(); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_advice_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/advice/v1/advice_connection_idempotency_policy.h b/google/cloud/compute/advice/v1/advice_connection_idempotency_policy.h new file mode 100644 index 0000000000000..c1dfd7c433a17 --- /dev/null +++ b/google/cloud/compute/advice/v1/advice_connection_idempotency_policy.h @@ -0,0 +1,52 @@ +// Copyright 2026 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. +// source: google/cloud/compute/advice/v1/advice.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ADVICE_V1_ADVICE_CONNECTION_IDEMPOTENCY_POLICY_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ADVICE_V1_ADVICE_CONNECTION_IDEMPOTENCY_POLICY_H + +#include "google/cloud/compute/advice/v1/advice.pb.h" +#include "google/cloud/idempotency.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_advice_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class AdviceConnectionIdempotencyPolicy { + public: + virtual ~AdviceConnectionIdempotencyPolicy(); + + /// Create a new copy of this object. + virtual std::unique_ptr clone() const; + + virtual google::cloud::Idempotency CalendarMode( + google::cloud::cpp::compute::advice::v1::CalendarModeRequest const& + request); +}; + +std::unique_ptr +MakeDefaultAdviceConnectionIdempotencyPolicy(); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_advice_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ADVICE_V1_ADVICE_CONNECTION_IDEMPOTENCY_POLICY_H diff --git a/google/cloud/compute/advice/v1/advice_options.h b/google/cloud/compute/advice/v1/advice_options.h new file mode 100644 index 0000000000000..1b7f3ab2afbe1 --- /dev/null +++ b/google/cloud/compute/advice/v1/advice_options.h @@ -0,0 +1,75 @@ +// Copyright 2026 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. +// source: google/cloud/compute/advice/v1/advice.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ADVICE_V1_ADVICE_OPTIONS_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ADVICE_V1_ADVICE_OPTIONS_H + +#include "google/cloud/compute/advice/v1/advice_connection.h" +#include "google/cloud/compute/advice/v1/advice_connection_idempotency_policy.h" +#include "google/cloud/backoff_policy.h" +#include "google/cloud/options.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_advice_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/** + * Use with `google::cloud::Options` to configure the retry policy. + * + * @ingroup google-cloud-compute-options + */ +struct AdviceRetryPolicyOption { + using Type = std::shared_ptr; +}; + +/** + * Use with `google::cloud::Options` to configure the backoff policy. + * + * @ingroup google-cloud-compute-options + */ +struct AdviceBackoffPolicyOption { + using Type = std::shared_ptr; +}; + +/** + * Use with `google::cloud::Options` to configure which operations are retried. + * + * @ingroup google-cloud-compute-options + */ +struct AdviceConnectionIdempotencyPolicyOption { + using Type = std::shared_ptr; +}; + +/** + * The options applicable to Advice. + * + * @ingroup google-cloud-compute-options + */ +using AdvicePolicyOptionList = + OptionList; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_advice_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ADVICE_V1_ADVICE_OPTIONS_H diff --git a/google/cloud/compute/advice/v1/advice_proto_export.h b/google/cloud/compute/advice/v1/advice_proto_export.h new file mode 100644 index 0000000000000..e85417950861a --- /dev/null +++ b/google/cloud/compute/advice/v1/advice_proto_export.h @@ -0,0 +1,32 @@ +// Copyright 2026 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_ADVICE_V1_ADVICE_PROTO_EXPORT_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ADVICE_V1_ADVICE_PROTO_EXPORT_H + +// IWYU pragma: begin_exports +#include "google/cloud/compute/v1/internal/common_024.pb.h" +// IWYU pragma: end_exports + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ADVICE_V1_ADVICE_PROTO_EXPORT_H diff --git a/google/cloud/compute/advice/v1/advice_rest_connection.cc b/google/cloud/compute/advice/v1/advice_rest_connection.cc new file mode 100644 index 0000000000000..78a27452f0456 --- /dev/null +++ b/google/cloud/compute/advice/v1/advice_rest_connection.cc @@ -0,0 +1,55 @@ +// Copyright 2026 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. +// source: google/cloud/compute/advice/v1/advice.proto + +#include "google/cloud/compute/advice/v1/advice_rest_connection.h" +#include "google/cloud/compute/advice/v1/advice_options.h" +#include "google/cloud/compute/advice/v1/internal/advice_option_defaults.h" +#include "google/cloud/compute/advice/v1/internal/advice_rest_connection_impl.h" +#include "google/cloud/compute/advice/v1/internal/advice_rest_stub_factory.h" +#include "google/cloud/compute/advice/v1/internal/advice_tracing_connection.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/internal/rest_background_threads_impl.h" +#include "google/cloud/internal/rest_options.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_advice_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +std::shared_ptr MakeAdviceConnectionRest(Options options) { + internal::CheckExpectedOptions< + CommonOptionList, RestOptionList, UnifiedCredentialsOptionList, + rest_internal::TargetApiVersionOption, AdvicePolicyOptionList>(options, + __func__); + options = + compute_advice_v1_internal::AdviceDefaultOptions(std::move(options)); + auto background = std::make_unique< + rest_internal::AutomaticallyCreatedRestBackgroundThreads>(); + auto stub = compute_advice_v1_internal::CreateDefaultAdviceRestStub(options); + return compute_advice_v1_internal::MakeAdviceTracingConnection( + std::make_shared( + std::move(background), std::move(stub), std::move(options))); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_advice_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/advice/v1/advice_rest_connection.h b/google/cloud/compute/advice/v1/advice_rest_connection.h new file mode 100644 index 0000000000000..dcf6d53069d3e --- /dev/null +++ b/google/cloud/compute/advice/v1/advice_rest_connection.h @@ -0,0 +1,64 @@ +// Copyright 2026 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. +// source: google/cloud/compute/advice/v1/advice.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ADVICE_V1_ADVICE_REST_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ADVICE_V1_ADVICE_REST_CONNECTION_H + +#include "google/cloud/compute/advice/v1/advice_connection.h" +#include "google/cloud/options.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_advice_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/** + * A factory function to construct an object of type `AdviceConnection` + * that uses REST over HTTP as transport in lieu of gRPC. REST transport should + * only be used for services that do not support gRPC or if the existing network + * configuration precludes using gRPC. + * + * The returned connection object should not be used directly; instead it + * should be passed as an argument to the constructor of AdviceClient. + * + * The optional @p options argument may be used to configure aspects of the + * returned `AdviceConnection`. Expected options are any of the types in + * the following option lists: + * + * - `google::cloud::CommonOptionList` + * - `google::cloud::RestOptionList` + * - `google::cloud::UnifiedCredentialsOptionList` + * - `google::cloud::compute_advice_v1::AdvicePolicyOptionList` + * + * @note Unexpected options will be ignored. To log unexpected options instead, + * set `GOOGLE_CLOUD_CPP_ENABLE_CLOG=yes` in the environment. + * + * @param options (optional) Configure the `AdviceConnection` created by + * this function. + */ +std::shared_ptr MakeAdviceConnectionRest( + Options options = {}); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_advice_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ADVICE_V1_ADVICE_REST_CONNECTION_H diff --git a/google/cloud/compute/advice/v1/internal/advice_option_defaults.cc b/google/cloud/compute/advice/v1/internal/advice_option_defaults.cc new file mode 100644 index 0000000000000..f678686201cfd --- /dev/null +++ b/google/cloud/compute/advice/v1/internal/advice_option_defaults.cc @@ -0,0 +1,66 @@ +// Copyright 2026 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. +// source: google/cloud/compute/advice/v1/advice.proto + +#include "google/cloud/compute/advice/v1/internal/advice_option_defaults.h" +#include "google/cloud/compute/advice/v1/advice_connection.h" +#include "google/cloud/compute/advice/v1/advice_options.h" +#include "google/cloud/internal/populate_common_options.h" +#include "google/cloud/internal/populate_grpc_options.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_advice_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +namespace { +auto constexpr kBackoffScaling = 2.0; +} // namespace + +Options AdviceDefaultOptions(Options options) { + options = internal::PopulateCommonOptions( + std::move(options), "GOOGLE_CLOUD_CPP_ADVICE_ENDPOINT", "", + "GOOGLE_CLOUD_CPP_ADVICE_AUTHORITY", "compute.googleapis.com"); + options = internal::PopulateGrpcOptions(std::move(options)); + if (!options.has()) { + options.set( + compute_advice_v1::AdviceLimitedTimeRetryPolicy( + std::chrono::minutes(10)) + .clone()); + } + if (!options.has()) { + options.set( + ExponentialBackoffPolicy( + std::chrono::seconds(0), std::chrono::seconds(1), + std::chrono::minutes(5), kBackoffScaling, kBackoffScaling) + .clone()); + } + if (!options + .has()) { + options.set( + compute_advice_v1::MakeDefaultAdviceConnectionIdempotencyPolicy()); + } + + return options; +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_advice_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/advice/v1/internal/advice_option_defaults.h b/google/cloud/compute/advice/v1/internal/advice_option_defaults.h new file mode 100644 index 0000000000000..8bb4789a86572 --- /dev/null +++ b/google/cloud/compute/advice/v1/internal/advice_option_defaults.h @@ -0,0 +1,37 @@ +// Copyright 2026 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. +// source: google/cloud/compute/advice/v1/advice.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ADVICE_V1_INTERNAL_ADVICE_OPTION_DEFAULTS_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ADVICE_V1_INTERNAL_ADVICE_OPTION_DEFAULTS_H + +#include "google/cloud/options.h" +#include "google/cloud/version.h" + +namespace google { +namespace cloud { +namespace compute_advice_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +Options AdviceDefaultOptions(Options options); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_advice_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ADVICE_V1_INTERNAL_ADVICE_OPTION_DEFAULTS_H diff --git a/google/cloud/compute/advice/v1/internal/advice_rest_connection_impl.cc b/google/cloud/compute/advice/v1/internal/advice_rest_connection_impl.cc new file mode 100644 index 0000000000000..c513adef36edd --- /dev/null +++ b/google/cloud/compute/advice/v1/internal/advice_rest_connection_impl.cc @@ -0,0 +1,61 @@ +// Copyright 2026 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. +// source: google/cloud/compute/advice/v1/advice.proto + +#include "google/cloud/compute/advice/v1/internal/advice_rest_connection_impl.h" +#include "google/cloud/compute/advice/v1/internal/advice_rest_stub_factory.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/internal/rest_retry_loop.h" +#include "google/cloud/rest_options.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_advice_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +AdviceRestConnectionImpl::AdviceRestConnectionImpl( + std::unique_ptr background, + std::shared_ptr stub, + Options options) + : background_(std::move(background)), + stub_(std::move(stub)), + options_(internal::MergeOptions(std::move(options), + AdviceConnection::options())) {} + +StatusOr +AdviceRestConnectionImpl::CalendarMode( + google::cloud::cpp::compute::advice::v1::CalendarModeRequest const& + request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->CalendarMode(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::advice::v1::CalendarModeRequest const& + request) { + return stub_->CalendarMode(rest_context, options, request); + }, + *current, request, __func__); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_advice_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/advice/v1/internal/advice_rest_connection_impl.h b/google/cloud/compute/advice/v1/internal/advice_rest_connection_impl.h new file mode 100644 index 0000000000000..7bcb5e2a47477 --- /dev/null +++ b/google/cloud/compute/advice/v1/internal/advice_rest_connection_impl.h @@ -0,0 +1,82 @@ +// Copyright 2026 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. +// source: google/cloud/compute/advice/v1/advice.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ADVICE_V1_INTERNAL_ADVICE_REST_CONNECTION_IMPL_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ADVICE_V1_INTERNAL_ADVICE_REST_CONNECTION_IMPL_H + +#include "google/cloud/compute/advice/v1/advice_connection.h" +#include "google/cloud/compute/advice/v1/advice_connection_idempotency_policy.h" +#include "google/cloud/compute/advice/v1/advice_options.h" +#include "google/cloud/compute/advice/v1/internal/advice_rest_stub.h" +#include "google/cloud/compute/advice/v1/internal/advice_retry_traits.h" +#include "google/cloud/background_threads.h" +#include "google/cloud/backoff_policy.h" +#include "google/cloud/options.h" +#include "google/cloud/status_or.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_advice_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class AdviceRestConnectionImpl : public compute_advice_v1::AdviceConnection { + public: + ~AdviceRestConnectionImpl() override = default; + + AdviceRestConnectionImpl( + std::unique_ptr background, + std::shared_ptr stub, + Options options); + + Options options() override { return options_; } + + StatusOr + CalendarMode( + google::cloud::cpp::compute::advice::v1::CalendarModeRequest const& + request) override; + + private: + static std::unique_ptr retry_policy( + Options const& options) { + return options.get()->clone(); + } + + static std::unique_ptr backoff_policy(Options const& options) { + return options.get()->clone(); + } + + static std::unique_ptr + idempotency_policy(Options const& options) { + return options + .get() + ->clone(); + } + + std::unique_ptr background_; + std::shared_ptr stub_; + Options options_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_advice_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ADVICE_V1_INTERNAL_ADVICE_REST_CONNECTION_IMPL_H diff --git a/google/cloud/compute/advice/v1/internal/advice_rest_logging_decorator.cc b/google/cloud/compute/advice/v1/internal/advice_rest_logging_decorator.cc new file mode 100644 index 0000000000000..0a93cb388df97 --- /dev/null +++ b/google/cloud/compute/advice/v1/internal/advice_rest_logging_decorator.cc @@ -0,0 +1,54 @@ +// Copyright 2026 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. +// source: google/cloud/compute/advice/v1/advice.proto + +#include "google/cloud/compute/advice/v1/internal/advice_rest_logging_decorator.h" +#include "google/cloud/internal/log_wrapper.h" +#include "google/cloud/status_or.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_advice_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +AdviceRestLogging::AdviceRestLogging(std::shared_ptr child, + TracingOptions tracing_options, + std::set components) + : child_(std::move(child)), + tracing_options_(std::move(tracing_options)), + components_(std::move(components)) {} + +StatusOr +AdviceRestLogging::CalendarMode( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::advice::v1::CalendarModeRequest const& + request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::advice::v1::CalendarModeRequest const& + request) { + return child_->CalendarMode(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_advice_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/advice/v1/internal/advice_rest_logging_decorator.h b/google/cloud/compute/advice/v1/internal/advice_rest_logging_decorator.h new file mode 100644 index 0000000000000..17c10f96d8999 --- /dev/null +++ b/google/cloud/compute/advice/v1/internal/advice_rest_logging_decorator.h @@ -0,0 +1,62 @@ +// Copyright 2026 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. +// source: google/cloud/compute/advice/v1/advice.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ADVICE_V1_INTERNAL_ADVICE_REST_LOGGING_DECORATOR_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ADVICE_V1_INTERNAL_ADVICE_REST_LOGGING_DECORATOR_H + +#include "google/cloud/compute/advice/v1/advice.pb.h" +#include "google/cloud/compute/advice/v1/internal/advice_rest_stub.h" +#include "google/cloud/future.h" +#include "google/cloud/internal/rest_context.h" +#include "google/cloud/tracing_options.h" +#include "google/cloud/version.h" +#include +#include +#include + +namespace google { +namespace cloud { +namespace compute_advice_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class AdviceRestLogging : public AdviceRestStub { + public: + ~AdviceRestLogging() override = default; + AdviceRestLogging(std::shared_ptr child, + TracingOptions tracing_options, + std::set components); + + StatusOr + CalendarMode( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::advice::v1::CalendarModeRequest const& + request) override; + + private: + std::shared_ptr child_; + TracingOptions tracing_options_; + std::set components_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_advice_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ADVICE_V1_INTERNAL_ADVICE_REST_LOGGING_DECORATOR_H diff --git a/google/cloud/compute/advice/v1/internal/advice_rest_metadata_decorator.cc b/google/cloud/compute/advice/v1/internal/advice_rest_metadata_decorator.cc new file mode 100644 index 0000000000000..d78f4addc0484 --- /dev/null +++ b/google/cloud/compute/advice/v1/internal/advice_rest_metadata_decorator.cc @@ -0,0 +1,60 @@ +// Copyright 2026 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. +// source: google/cloud/compute/advice/v1/advice.proto + +#include "google/cloud/compute/advice/v1/internal/advice_rest_metadata_decorator.h" +#include "google/cloud/internal/api_client_header.h" +#include "google/cloud/internal/rest_set_metadata.h" +#include "google/cloud/status_or.h" +#include "absl/strings/str_cat.h" +#include "absl/strings/str_format.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_advice_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +AdviceRestMetadata::AdviceRestMetadata(std::shared_ptr child, + std::string api_client_header) + : child_(std::move(child)), + api_client_header_( + api_client_header.empty() + ? google::cloud::internal::GeneratedLibClientHeader() + : std::move(api_client_header)) {} + +StatusOr +AdviceRestMetadata::CalendarMode( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::advice::v1::CalendarModeRequest const& + request) { + SetMetadata(rest_context, options); + return child_->CalendarMode(rest_context, options, request); +} + +void AdviceRestMetadata::SetMetadata(rest_internal::RestContext& rest_context, + Options const& options, + std::vector const& params) { + google::cloud::rest_internal::SetMetadata(rest_context, options, params, + api_client_header_); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_advice_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/advice/v1/internal/advice_rest_metadata_decorator.h b/google/cloud/compute/advice/v1/internal/advice_rest_metadata_decorator.h new file mode 100644 index 0000000000000..923a4709aa2f9 --- /dev/null +++ b/google/cloud/compute/advice/v1/internal/advice_rest_metadata_decorator.h @@ -0,0 +1,62 @@ +// Copyright 2026 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. +// source: google/cloud/compute/advice/v1/advice.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ADVICE_V1_INTERNAL_ADVICE_REST_METADATA_DECORATOR_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ADVICE_V1_INTERNAL_ADVICE_REST_METADATA_DECORATOR_H + +#include "google/cloud/compute/advice/v1/advice.pb.h" +#include "google/cloud/compute/advice/v1/internal/advice_rest_stub.h" +#include "google/cloud/future.h" +#include "google/cloud/rest_options.h" +#include "google/cloud/version.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_advice_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class AdviceRestMetadata : public AdviceRestStub { + public: + ~AdviceRestMetadata() override = default; + explicit AdviceRestMetadata(std::shared_ptr child, + std::string api_client_header = ""); + + StatusOr + CalendarMode( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::advice::v1::CalendarModeRequest const& + request) override; + + private: + void SetMetadata(rest_internal::RestContext& rest_context, + Options const& options, + std::vector const& params = {}); + + std::shared_ptr child_; + std::string api_client_header_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_advice_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ADVICE_V1_INTERNAL_ADVICE_REST_METADATA_DECORATOR_H diff --git a/google/cloud/compute/advice/v1/internal/advice_rest_stub.cc b/google/cloud/compute/advice/v1/internal/advice_rest_stub.cc new file mode 100644 index 0000000000000..94f5c9cc50505 --- /dev/null +++ b/google/cloud/compute/advice/v1/internal/advice_rest_stub.cc @@ -0,0 +1,63 @@ +// Copyright 2026 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. +// source: google/cloud/compute/advice/v1/advice.proto + +#include "google/cloud/compute/advice/v1/internal/advice_rest_stub.h" +#include "google/cloud/compute/advice/v1/advice.pb.h" +#include "google/cloud/common_options.h" +#include "google/cloud/internal/rest_stub_helpers.h" +#include "google/cloud/status_or.h" +#include "absl/strings/str_cat.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_advice_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +DefaultAdviceRestStub::DefaultAdviceRestStub(Options options) + : service_(rest_internal::MakePooledRestClient( + options.get(), options)), + options_(std::move(options)) {} + +DefaultAdviceRestStub::DefaultAdviceRestStub( + std::shared_ptr service, Options options) + : service_(std::move(service)), options_(std::move(options)) {} + +StatusOr +DefaultAdviceRestStub::CalendarMode( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::advice::v1::CalendarModeRequest const& + request) { + std::vector> query_params; + return rest_internal::Post< + google::cloud::cpp::compute::v1::CalendarModeAdviceResponse>( + *service_, rest_context, request.calendar_mode_advice_request_resource(), + false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "regions", "/", + request.region(), "/", "advice", "/", "calendarMode"), + std::move(query_params)); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_advice_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/advice/v1/internal/advice_rest_stub.h b/google/cloud/compute/advice/v1/internal/advice_rest_stub.h new file mode 100644 index 0000000000000..fdfcf10e69705 --- /dev/null +++ b/google/cloud/compute/advice/v1/internal/advice_rest_stub.h @@ -0,0 +1,72 @@ +// Copyright 2026 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. +// source: google/cloud/compute/advice/v1/advice.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ADVICE_V1_INTERNAL_ADVICE_REST_STUB_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ADVICE_V1_INTERNAL_ADVICE_REST_STUB_H + +#include "google/cloud/compute/advice/v1/advice.pb.h" +#include "google/cloud/completion_queue.h" +#include "google/cloud/internal/rest_client.h" +#include "google/cloud/internal/rest_context.h" +#include "google/cloud/status_or.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_advice_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class AdviceRestStub { + public: + virtual ~AdviceRestStub() = default; + + virtual StatusOr + CalendarMode( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::advice::v1::CalendarModeRequest const& + request) = 0; +}; + +class DefaultAdviceRestStub : public AdviceRestStub { + public: + ~DefaultAdviceRestStub() override = default; + + explicit DefaultAdviceRestStub(Options options); + DefaultAdviceRestStub(std::shared_ptr service, + Options options); + + StatusOr + CalendarMode( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::advice::v1::CalendarModeRequest const& + request) override; + + private: + std::shared_ptr service_; + Options options_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_advice_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ADVICE_V1_INTERNAL_ADVICE_REST_STUB_H diff --git a/google/cloud/compute/advice/v1/internal/advice_rest_stub_factory.cc b/google/cloud/compute/advice/v1/internal/advice_rest_stub_factory.cc new file mode 100644 index 0000000000000..589a51d9cdcf1 --- /dev/null +++ b/google/cloud/compute/advice/v1/internal/advice_rest_stub_factory.cc @@ -0,0 +1,56 @@ +// Copyright 2026 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. +// source: google/cloud/compute/advice/v1/advice.proto + +#include "google/cloud/compute/advice/v1/internal/advice_rest_stub_factory.h" +#include "google/cloud/compute/advice/v1/internal/advice_rest_logging_decorator.h" +#include "google/cloud/compute/advice/v1/internal/advice_rest_metadata_decorator.h" +#include "google/cloud/compute/advice/v1/internal/advice_rest_stub.h" +#include "google/cloud/common_options.h" +#include "google/cloud/internal/algorithm.h" +#include "google/cloud/internal/populate_rest_options.h" +#include "google/cloud/log.h" +#include "google/cloud/options.h" +#include "google/cloud/rest_options.h" +#include "absl/strings/match.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_advice_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +std::shared_ptr CreateDefaultAdviceRestStub( + Options const& options) { + auto opts = internal::PopulateRestOptions(options); + std::shared_ptr stub = + std::make_shared(std::move(opts)); + stub = std::make_shared(std::move(stub)); + if (internal::Contains(options.get(), "rpc")) { + GCP_LOG(INFO) << "Enabled logging for REST rpc calls"; + stub = std::make_shared( + std::move(stub), options.get(), + options.get()); + } + return stub; +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_advice_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/advice/v1/internal/advice_rest_stub_factory.h b/google/cloud/compute/advice/v1/internal/advice_rest_stub_factory.h new file mode 100644 index 0000000000000..e4fa148fe0903 --- /dev/null +++ b/google/cloud/compute/advice/v1/internal/advice_rest_stub_factory.h @@ -0,0 +1,40 @@ +// Copyright 2026 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. +// source: google/cloud/compute/advice/v1/advice.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ADVICE_V1_INTERNAL_ADVICE_REST_STUB_FACTORY_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ADVICE_V1_INTERNAL_ADVICE_REST_STUB_FACTORY_H + +#include "google/cloud/compute/advice/v1/internal/advice_rest_stub.h" +#include "google/cloud/options.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_advice_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +std::shared_ptr CreateDefaultAdviceRestStub( + Options const& options); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_advice_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ADVICE_V1_INTERNAL_ADVICE_REST_STUB_FACTORY_H diff --git a/google/cloud/compute/advice/v1/internal/advice_retry_traits.h b/google/cloud/compute/advice/v1/internal/advice_retry_traits.h new file mode 100644 index 0000000000000..b22dbcc8bed84 --- /dev/null +++ b/google/cloud/compute/advice/v1/internal/advice_retry_traits.h @@ -0,0 +1,43 @@ +// Copyright 2026 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. +// source: google/cloud/compute/advice/v1/advice.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ADVICE_V1_INTERNAL_ADVICE_RETRY_TRAITS_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ADVICE_V1_INTERNAL_ADVICE_RETRY_TRAITS_H + +#include "google/cloud/status.h" +#include "google/cloud/version.h" + +namespace google { +namespace cloud { +namespace compute_advice_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/// Define the gRPC status code semantics for retrying requests. +struct AdviceRetryTraits { + static bool IsPermanentFailure(google::cloud::Status const& status) { + return status.code() != StatusCode::kOk && + status.code() != StatusCode::kUnavailable; + } +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_advice_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ADVICE_V1_INTERNAL_ADVICE_RETRY_TRAITS_H diff --git a/google/cloud/compute/advice/v1/internal/advice_sources.cc b/google/cloud/compute/advice/v1/internal/advice_sources.cc new file mode 100644 index 0000000000000..b70db497d8eb7 --- /dev/null +++ b/google/cloud/compute/advice/v1/internal/advice_sources.cc @@ -0,0 +1,31 @@ +// Copyright 2026 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. +// source: google/cloud/compute/advice/v1/advice.proto + +// NOLINTBEGIN(bugprone-suspicious-include) +#include "google/cloud/compute/advice/v1/advice_client.cc" +#include "google/cloud/compute/advice/v1/advice_connection.cc" +#include "google/cloud/compute/advice/v1/advice_connection_idempotency_policy.cc" +#include "google/cloud/compute/advice/v1/advice_rest_connection.cc" +#include "google/cloud/compute/advice/v1/internal/advice_option_defaults.cc" +#include "google/cloud/compute/advice/v1/internal/advice_rest_connection_impl.cc" +#include "google/cloud/compute/advice/v1/internal/advice_rest_logging_decorator.cc" +#include "google/cloud/compute/advice/v1/internal/advice_rest_metadata_decorator.cc" +#include "google/cloud/compute/advice/v1/internal/advice_rest_stub.cc" +#include "google/cloud/compute/advice/v1/internal/advice_rest_stub_factory.cc" +#include "google/cloud/compute/advice/v1/internal/advice_tracing_connection.cc" +// NOLINTEND(bugprone-suspicious-include) diff --git a/google/cloud/compute/advice/v1/internal/advice_tracing_connection.cc b/google/cloud/compute/advice/v1/internal/advice_tracing_connection.cc new file mode 100644 index 0000000000000..891ade736ff5b --- /dev/null +++ b/google/cloud/compute/advice/v1/internal/advice_tracing_connection.cc @@ -0,0 +1,55 @@ +// Copyright 2026 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. +// source: google/cloud/compute/advice/v1/advice.proto + +#include "google/cloud/compute/advice/v1/internal/advice_tracing_connection.h" +#include "google/cloud/internal/opentelemetry.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_advice_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +AdviceTracingConnection::AdviceTracingConnection( + std::shared_ptr child) + : child_(std::move(child)) {} + +StatusOr +AdviceTracingConnection::CalendarMode( + google::cloud::cpp::compute::advice::v1::CalendarModeRequest const& + request) { + auto span = + internal::MakeSpan("compute_advice_v1::AdviceConnection::CalendarMode"); + auto scope = opentelemetry::trace::Scope(span); + return internal::EndSpan(*span, child_->CalendarMode(request)); +} + +std::shared_ptr +MakeAdviceTracingConnection( + std::shared_ptr conn) { + if (internal::TracingEnabled(conn->options())) { + conn = std::make_shared(std::move(conn)); + } + return conn; +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_advice_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/advice/v1/internal/advice_tracing_connection.h b/google/cloud/compute/advice/v1/internal/advice_tracing_connection.h new file mode 100644 index 0000000000000..c3c0576f5c743 --- /dev/null +++ b/google/cloud/compute/advice/v1/internal/advice_tracing_connection.h @@ -0,0 +1,64 @@ +// Copyright 2026 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. +// source: google/cloud/compute/advice/v1/advice.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ADVICE_V1_INTERNAL_ADVICE_TRACING_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ADVICE_V1_INTERNAL_ADVICE_TRACING_CONNECTION_H + +#include "google/cloud/compute/advice/v1/advice_connection.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_advice_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class AdviceTracingConnection : public compute_advice_v1::AdviceConnection { + public: + ~AdviceTracingConnection() override = default; + + explicit AdviceTracingConnection( + std::shared_ptr child); + + Options options() override { return child_->options(); } + + StatusOr + CalendarMode( + google::cloud::cpp::compute::advice::v1::CalendarModeRequest const& + request) override; + + private: + std::shared_ptr child_; +}; + +/** + * Conditionally applies the tracing decorator to the given connection. + * + * The connection is only decorated if tracing is enabled (as determined by the + * connection's options). + */ +std::shared_ptr +MakeAdviceTracingConnection( + std::shared_ptr conn); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_advice_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ADVICE_V1_INTERNAL_ADVICE_TRACING_CONNECTION_H diff --git a/google/cloud/compute/advice/v1/mocks/mock_advice_connection.h b/google/cloud/compute/advice/v1/mocks/mock_advice_connection.h new file mode 100644 index 0000000000000..3934c25824531 --- /dev/null +++ b/google/cloud/compute/advice/v1/mocks/mock_advice_connection.h @@ -0,0 +1,62 @@ +// Copyright 2026 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. +// source: google/cloud/compute/advice/v1/advice.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ADVICE_V1_MOCKS_MOCK_ADVICE_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ADVICE_V1_MOCKS_MOCK_ADVICE_CONNECTION_H + +#include "google/cloud/compute/advice/v1/advice_connection.h" +#include + +namespace google { +namespace cloud { +namespace compute_advice_v1_mocks { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/** + * A class to mock `AdviceConnection`. + * + * Application developers may want to test their code with simulated responses, + * including errors, from an object of type `AdviceClient`. To do so, + * construct an object of type `AdviceClient` with an instance of this + * class. Then use the Google Test framework functions to program the behavior + * of this mock. + * + * @see [This example][bq-mock] for how to test your application with GoogleTest. + * While the example showcases types from the BigQuery library, the underlying + * principles apply for any pair of `*Client` and `*Connection`. + * + * [bq-mock]: @cloud_cpp_docs_link{bigquery,bigquery-read-mock} + */ +class MockAdviceConnection : public compute_advice_v1::AdviceConnection { + public: + MOCK_METHOD(Options, options, (), (override)); + + MOCK_METHOD( + StatusOr, + CalendarMode, + (google::cloud::cpp::compute::advice::v1::CalendarModeRequest const& + request), + (override)); +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_advice_v1_mocks +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ADVICE_V1_MOCKS_MOCK_ADVICE_CONNECTION_H diff --git a/google/cloud/compute/advice/v1/samples/advice_client_samples.cc b/google/cloud/compute/advice/v1/samples/advice_client_samples.cc new file mode 100644 index 0000000000000..1522fc7a49213 --- /dev/null +++ b/google/cloud/compute/advice/v1/samples/advice_client_samples.cc @@ -0,0 +1,180 @@ +// Copyright 2026 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. +// source: google/cloud/compute/advice/v1/advice.proto + +#include "google/cloud/compute/advice/v1/advice_client.h" +#include "google/cloud/compute/advice/v1/advice_connection_idempotency_policy.h" +#include "google/cloud/compute/advice/v1/advice_options.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/internal/getenv.h" +#include "google/cloud/testing_util/example_driver.h" +#include "google/cloud/universe_domain.h" +#include +#include +#include +#include + +// clang-format off +// main-dox-marker: compute_advice_v1::AdviceClient +// clang-format on +namespace { + +void SetClientEndpoint(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-endpoint"}; + } + //! [set-client-endpoint] + // This configuration is common with Private Google Access: + // https://cloud.google.com/vpc/docs/private-google-access + auto options = google::cloud::Options{}.set( + "private.googleapis.com"); + auto vpc_client = google::cloud::compute_advice_v1::AdviceClient( + google::cloud::compute_advice_v1::MakeAdviceConnectionRest(options)); + //! [set-client-endpoint] +} + +void SetClientUniverseDomain(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-universe-domain"}; + } + //! [set-client-universe-domain] + google::cloud::Options options; + + // AddUniverseDomainOption interrogates the UnifiedCredentialsOption, if set, + // in the provided Options for the Universe Domain associated with the + // credentials and adds it to the set of Options. + // If no UnifiedCredentialsOption is set, GoogleDefaultCredentials are used. + auto ud_options = google::cloud::AddUniverseDomainOption(std::move(options)); + + if (!ud_options.ok()) throw std::move(ud_options).status(); + auto ud_client = google::cloud::compute_advice_v1::AdviceClient( + google::cloud::compute_advice_v1::MakeAdviceConnectionRest(*ud_options)); + //! [set-client-universe-domain] +} + +//! [custom-idempotency-policy] +class CustomIdempotencyPolicy : public google::cloud::compute_advice_v1:: + AdviceConnectionIdempotencyPolicy { + public: + ~CustomIdempotencyPolicy() override = default; + std::unique_ptr< + google::cloud::compute_advice_v1::AdviceConnectionIdempotencyPolicy> + clone() const override { + return std::make_unique(*this); + } + // Override inherited functions to define as needed. +}; +//! [custom-idempotency-policy] + +void SetRetryPolicy(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-retry-policy"}; + } + //! [set-retry-policy] + auto options = + google::cloud::Options{} + .set( + CustomIdempotencyPolicy().clone()) + .set( + google::cloud::compute_advice_v1:: + AdviceLimitedErrorCountRetryPolicy(3) + .clone()) + .set( + google::cloud::ExponentialBackoffPolicy( + /*initial_delay=*/std::chrono::milliseconds(200), + /*maximum_delay=*/std::chrono::seconds(45), + /*scaling=*/2.0) + .clone()); + auto connection = + google::cloud::compute_advice_v1::MakeAdviceConnectionRest(options); + + // c1 and c2 share the same retry policies + auto c1 = google::cloud::compute_advice_v1::AdviceClient(connection); + auto c2 = google::cloud::compute_advice_v1::AdviceClient(connection); + + // You can override any of the policies in a new client. This new client + // will share the policies from c1 (or c2) *except* for the retry policy. + auto c3 = google::cloud::compute_advice_v1::AdviceClient( + connection, + google::cloud::Options{} + .set( + google::cloud::compute_advice_v1::AdviceLimitedTimeRetryPolicy( + std::chrono::minutes(5)) + .clone())); + + // You can also override the policies in a single call: + // c3.SomeRpc(..., google::cloud::Options{} + // .set( + // google::cloud::compute_advice_v1::AdviceLimitedErrorCountRetryPolicy(10).clone())); + //! [set-retry-policy] +} + +void WithServiceAccount(std::vector const& argv) { + if (argv.size() != 1 || argv[0] == "--help") { + throw google::cloud::testing_util::Usage{"with-service-account "}; + } + //! [with-service-account] + [](std::string const& keyfile) { + auto is = std::ifstream(keyfile); + is.exceptions(std::ios::badbit); // Minimal error handling in examples + auto contents = std::string(std::istreambuf_iterator(is.rdbuf()), {}); + auto options = + google::cloud::Options{}.set( + google::cloud::MakeServiceAccountCredentials(contents)); + return google::cloud::compute_advice_v1::AdviceClient( + google::cloud::compute_advice_v1::MakeAdviceConnectionRest(options)); + } + //! [with-service-account] + (argv.at(0)); +} + +void AutoRun(std::vector const& argv) { + namespace examples = ::google::cloud::testing_util; + using ::google::cloud::internal::GetEnv; + if (!argv.empty()) throw examples::Usage{"auto"}; + examples::CheckEnvironmentVariablesAreSet( + {"GOOGLE_CLOUD_CPP_TEST_SERVICE_ACCOUNT_KEYFILE"}); + auto const keyfile = + GetEnv("GOOGLE_CLOUD_CPP_TEST_SERVICE_ACCOUNT_KEYFILE").value(); + + std::cout << "\nRunning SetClientEndpoint() example" << std::endl; + SetClientEndpoint({}); + + std::cout << "\nRunning SetRetryPolicy() example" << std::endl; + SetRetryPolicy({}); + + std::cout << "\nRunning WithServiceAccount() example" << std::endl; + WithServiceAccount({keyfile}); + + std::cout << "\nRunning SetClientUniverseDomain() example" << std::endl; + SetClientUniverseDomain({}); +} + +} // namespace + +int main(int argc, char* argv[]) { // NOLINT(bugprone-exception-escape) + google::cloud::testing_util::Example example({ + {"set-client-endpoint", SetClientEndpoint}, + {"set-retry-policy", SetRetryPolicy}, + {"with-service-account", WithServiceAccount}, + {"set-client-universe-domain", SetClientUniverseDomain}, + {"auto", AutoRun}, + }); + return example.Run(argc, argv); +} diff --git a/google/cloud/compute/autoscalers/v1/autoscalers_client.cc b/google/cloud/compute/autoscalers/v1/autoscalers_client.cc index a16eafe45bd5b..c7c74e154d004 100644 --- a/google/cloud/compute/autoscalers/v1/autoscalers_client.cc +++ b/google/cloud/compute/autoscalers/v1/autoscalers_client.cc @@ -249,6 +249,33 @@ AutoscalersClient::PatchAutoscaler( return connection_->PatchAutoscaler(operation); } +StatusOr +AutoscalersClient::TestIamPermissions( + std::string const& project, std::string const& zone, + std::string const& resource, + google::cloud::cpp::compute::v1::TestPermissionsRequest const& + test_permissions_request_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::autoscalers::v1::TestIamPermissionsRequest + request; + request.set_project(project); + request.set_zone(zone); + request.set_resource(resource); + *request.mutable_test_permissions_request_resource() = + test_permissions_request_resource; + return connection_->TestIamPermissions(request); +} + +StatusOr +AutoscalersClient::TestIamPermissions( + google::cloud::cpp::compute::autoscalers::v1:: + TestIamPermissionsRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->TestIamPermissions(request); +} + future> AutoscalersClient::UpdateAutoscaler( std::string const& project, std::string const& zone, diff --git a/google/cloud/compute/autoscalers/v1/autoscalers_client.h b/google/cloud/compute/autoscalers/v1/autoscalers_client.h index 26b4f99e3eb60..dda7acca74e2e 100644 --- a/google/cloud/compute/autoscalers/v1/autoscalers_client.h +++ b/google/cloud/compute/autoscalers/v1/autoscalers_client.h @@ -90,8 +90,10 @@ class AutoscalersClient { // clang-format off /// - /// Retrieves an aggregated list of autoscalers. To prevent failure, Google - /// recommends that you set the `returnPartialSuccess` parameter to `true`. + /// Retrieves an aggregated list of autoscalers. + /// + /// To prevent failure, it is recommended that you set the + /// `returnPartialSuccess` parameter to `true`. /// https://cloud.google.com/compute/docs/reference/rest/v1/autoscalers/aggregatedList /// /// @param project Project ID for this request. @@ -117,8 +119,8 @@ class AutoscalersClient { /// [`future`]: @ref google::cloud::future /// [`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_009.proto#L247} + /// [google.cloud.cpp.compute.autoscalers.v1.AggregatedListAutoscalersRequest]: @cloud_cpp_reference_link{google/cloud/compute/autoscalers/v1/autoscalers.proto#L142} + /// [google.cloud.cpp.compute.v1.AutoscalersScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_011.proto#L290} /// // clang-format on StreamRange> DeleteAutoscaler( @@ -250,7 +254,7 @@ class AutoscalersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.autoscalers.v1.DeleteAutoscalerRequest]: @cloud_cpp_reference_link{google/cloud/compute/autoscalers/v1/autoscalers.proto#L207} + /// [google.cloud.cpp.compute.autoscalers.v1.DeleteAutoscalerRequest]: @cloud_cpp_reference_link{google/cloud/compute/autoscalers/v1/autoscalers.proto#L257} /// // clang-format on future> DeleteAutoscaler( @@ -309,8 +313,8 @@ class AutoscalersClient { /// [`future`]: @ref google::cloud::future /// [`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_008.proto#L34} + /// [google.cloud.cpp.compute.autoscalers.v1.GetAutoscalerRequest]: @cloud_cpp_reference_link{google/cloud/compute/autoscalers/v1/autoscalers.proto#L293} + /// [google.cloud.cpp.compute.v1.Autoscaler]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_010.proto#L43} /// // clang-format on StatusOr GetAutoscaler( @@ -341,8 +345,8 @@ class AutoscalersClient { /// [`future`]: @ref google::cloud::future /// [`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_008.proto#L34} + /// [google.cloud.cpp.compute.autoscalers.v1.GetAutoscalerRequest]: @cloud_cpp_reference_link{google/cloud/compute/autoscalers/v1/autoscalers.proto#L293} + /// [google.cloud.cpp.compute.v1.Autoscaler]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_010.proto#L43} /// // clang-format on StatusOr GetAutoscaler( @@ -352,8 +356,8 @@ class AutoscalersClient { // clang-format off /// - /// Creates an autoscaler in the specified project using the data included in - /// the request. + /// Creates an autoscaler in the specified project using the data + /// included in the request. /// https://cloud.google.com/compute/docs/reference/rest/v1/autoscalers/insert /// /// @param project Project ID for this request. @@ -379,7 +383,7 @@ class AutoscalersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.autoscalers.v1.InsertAutoscalerRequest]: @cloud_cpp_reference_link{google/cloud/compute/autoscalers/v1/autoscalers.proto#L254} + /// [google.cloud.cpp.compute.autoscalers.v1.InsertAutoscalerRequest]: @cloud_cpp_reference_link{google/cloud/compute/autoscalers/v1/autoscalers.proto#L307} /// // clang-format on future> InsertAutoscaler( @@ -405,8 +409,8 @@ class AutoscalersClient { // clang-format off /// - /// Creates an autoscaler in the specified project using the data included in - /// the request. + /// Creates an autoscaler in the specified project using the data + /// included in the request. /// https://cloud.google.com/compute/docs/reference/rest/v1/autoscalers/insert /// /// @param request Unary RPCs, such as the one wrapped by this @@ -435,7 +439,7 @@ class AutoscalersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.autoscalers.v1.InsertAutoscalerRequest]: @cloud_cpp_reference_link{google/cloud/compute/autoscalers/v1/autoscalers.proto#L254} + /// [google.cloud.cpp.compute.autoscalers.v1.InsertAutoscalerRequest]: @cloud_cpp_reference_link{google/cloud/compute/autoscalers/v1/autoscalers.proto#L307} /// // clang-format on future> InsertAutoscaler( @@ -475,7 +479,8 @@ class AutoscalersClient { // clang-format off /// - /// Retrieves a list of autoscalers contained within the specified zone. + /// Retrieves a list of autoscalers contained within + /// the specified zone. /// https://cloud.google.com/compute/docs/reference/rest/v1/autoscalers/list /// /// @param project Project ID for this request. @@ -502,8 +507,8 @@ class AutoscalersClient { /// [`future`]: @ref google::cloud::future /// [`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_008.proto#L34} + /// [google.cloud.cpp.compute.autoscalers.v1.ListAutoscalersRequest]: @cloud_cpp_reference_link{google/cloud/compute/autoscalers/v1/autoscalers.proto#L343} + /// [google.cloud.cpp.compute.v1.Autoscaler]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_010.proto#L43} /// // clang-format on StreamRange ListAutoscalers( @@ -511,7 +516,8 @@ class AutoscalersClient { // clang-format off /// - /// Retrieves a list of autoscalers contained within the specified zone. + /// Retrieves a list of autoscalers contained within + /// the specified zone. /// https://cloud.google.com/compute/docs/reference/rest/v1/autoscalers/list /// /// @param request Unary RPCs, such as the one wrapped by this @@ -542,8 +548,8 @@ class AutoscalersClient { /// [`future`]: @ref google::cloud::future /// [`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_008.proto#L34} + /// [google.cloud.cpp.compute.autoscalers.v1.ListAutoscalersRequest]: @cloud_cpp_reference_link{google/cloud/compute/autoscalers/v1/autoscalers.proto#L343} + /// [google.cloud.cpp.compute.v1.Autoscaler]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_010.proto#L43} /// // clang-format on StreamRange ListAutoscalers( @@ -553,8 +559,9 @@ class AutoscalersClient { // clang-format off /// - /// Updates an autoscaler in the specified project using the data included in - /// the request. This method supports PATCH semantics and uses the JSON merge + /// Updates an autoscaler in the specified project using the data + /// included in the request. This method supportsPATCH + /// semantics and uses theJSON merge /// patch format and processing rules. /// https://cloud.google.com/compute/docs/reference/rest/v1/autoscalers/patch /// @@ -581,7 +588,7 @@ class AutoscalersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.autoscalers.v1.PatchAutoscalerRequest]: @cloud_cpp_reference_link{google/cloud/compute/autoscalers/v1/autoscalers.proto#L358} + /// [google.cloud.cpp.compute.autoscalers.v1.PatchAutoscalerRequest]: @cloud_cpp_reference_link{google/cloud/compute/autoscalers/v1/autoscalers.proto#L447} /// // clang-format on future> PatchAutoscaler( @@ -607,8 +614,9 @@ class AutoscalersClient { // clang-format off /// - /// Updates an autoscaler in the specified project using the data included in - /// the request. This method supports PATCH semantics and uses the JSON merge + /// Updates an autoscaler in the specified project using the data + /// included in the request. This method supportsPATCH + /// semantics and uses theJSON merge /// patch format and processing rules. /// https://cloud.google.com/compute/docs/reference/rest/v1/autoscalers/patch /// @@ -638,7 +646,7 @@ class AutoscalersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.autoscalers.v1.PatchAutoscalerRequest]: @cloud_cpp_reference_link{google/cloud/compute/autoscalers/v1/autoscalers.proto#L358} + /// [google.cloud.cpp.compute.autoscalers.v1.PatchAutoscalerRequest]: @cloud_cpp_reference_link{google/cloud/compute/autoscalers/v1/autoscalers.proto#L447} /// // clang-format on future> PatchAutoscaler( @@ -678,8 +686,75 @@ class AutoscalersClient { // clang-format off /// - /// Updates an autoscaler in the specified project using the data included in - /// the request. + /// Returns permissions that a caller has on the specified resource. + /// https://cloud.google.com/compute/docs/reference/rest/v1/autoscalers/testIamPermissions + /// + /// @param project Project ID for this request. + /// @param zone The name of the zone for this request. + /// @param resource Name or id of the resource for this request. + /// @param test_permissions_request_resource The TestPermissionsRequest for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.TestPermissionsResponse]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.autoscalers.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/autoscalers/v1/autoscalers.proto#L486} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} + /// + // clang-format on + StatusOr + TestIamPermissions( + std::string const& project, std::string const& zone, + std::string const& resource, + google::cloud::cpp::compute::v1::TestPermissionsRequest const& + test_permissions_request_resource, + Options opts = {}); + + // clang-format off + /// + /// Returns permissions that a caller has on the specified resource. + /// https://cloud.google.com/compute/docs/reference/rest/v1/autoscalers/testIamPermissions + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.autoscalers.v1.TestIamPermissionsRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.TestPermissionsResponse]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.autoscalers.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/autoscalers/v1/autoscalers.proto#L486} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} + /// + // clang-format on + StatusOr + TestIamPermissions(google::cloud::cpp::compute::autoscalers::v1:: + TestIamPermissionsRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// Updates an autoscaler in the specified project using the data + /// included in the request. /// https://cloud.google.com/compute/docs/reference/rest/v1/autoscalers/update /// /// @param project Project ID for this request. @@ -705,7 +780,7 @@ class AutoscalersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.autoscalers.v1.UpdateAutoscalerRequest]: @cloud_cpp_reference_link{google/cloud/compute/autoscalers/v1/autoscalers.proto#L394} + /// [google.cloud.cpp.compute.autoscalers.v1.UpdateAutoscalerRequest]: @cloud_cpp_reference_link{google/cloud/compute/autoscalers/v1/autoscalers.proto#L504} /// // clang-format on future> UpdateAutoscaler( @@ -731,8 +806,8 @@ class AutoscalersClient { // clang-format off /// - /// Updates an autoscaler in the specified project using the data included in - /// the request. + /// Updates an autoscaler in the specified project using the data + /// included in the request. /// https://cloud.google.com/compute/docs/reference/rest/v1/autoscalers/update /// /// @param request Unary RPCs, such as the one wrapped by this @@ -761,7 +836,7 @@ class AutoscalersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.autoscalers.v1.UpdateAutoscalerRequest]: @cloud_cpp_reference_link{google/cloud/compute/autoscalers/v1/autoscalers.proto#L394} + /// [google.cloud.cpp.compute.autoscalers.v1.UpdateAutoscalerRequest]: @cloud_cpp_reference_link{google/cloud/compute/autoscalers/v1/autoscalers.proto#L504} /// // clang-format on future> UpdateAutoscaler( diff --git a/google/cloud/compute/autoscalers/v1/autoscalers_connection.cc b/google/cloud/compute/autoscalers/v1/autoscalers_connection.cc index 16d2b91e4c9b4..137654c17d1e6 100644 --- a/google/cloud/compute/autoscalers/v1/autoscalers_connection.cc +++ b/google/cloud/compute/autoscalers/v1/autoscalers_connection.cc @@ -135,6 +135,13 @@ AutoscalersConnection::PatchAutoscaler( Status(StatusCode::kUnimplemented, "not implemented")); } +StatusOr +AutoscalersConnection::TestIamPermissions( + google::cloud::cpp::compute::autoscalers::v1:: + TestIamPermissionsRequest const&) { + return Status(StatusCode::kUnimplemented, "not implemented"); +} + future> AutoscalersConnection::UpdateAutoscaler( google::cloud::cpp::compute::autoscalers::v1:: diff --git a/google/cloud/compute/autoscalers/v1/autoscalers_connection.h b/google/cloud/compute/autoscalers/v1/autoscalers_connection.h index 6a596effbd0bf..913c228c30ab8 100644 --- a/google/cloud/compute/autoscalers/v1/autoscalers_connection.h +++ b/google/cloud/compute/autoscalers/v1/autoscalers_connection.h @@ -231,6 +231,10 @@ class AutoscalersConnection { virtual future> PatchAutoscaler(google::cloud::cpp::compute::v1::Operation const& operation); + virtual StatusOr + TestIamPermissions(google::cloud::cpp::compute::autoscalers::v1:: + TestIamPermissionsRequest const& request); + virtual future> UpdateAutoscaler(google::cloud::cpp::compute::autoscalers::v1:: UpdateAutoscalerRequest const& request); diff --git a/google/cloud/compute/autoscalers/v1/autoscalers_connection_idempotency_policy.cc b/google/cloud/compute/autoscalers/v1/autoscalers_connection_idempotency_policy.cc index 0ee42b799597f..be51bbe345456 100644 --- a/google/cloud/compute/autoscalers/v1/autoscalers_connection_idempotency_policy.cc +++ b/google/cloud/compute/autoscalers/v1/autoscalers_connection_idempotency_policy.cc @@ -69,6 +69,12 @@ Idempotency AutoscalersConnectionIdempotencyPolicy::PatchAutoscaler( return Idempotency::kNonIdempotent; } +Idempotency AutoscalersConnectionIdempotencyPolicy::TestIamPermissions( + google::cloud::cpp::compute::autoscalers::v1:: + TestIamPermissionsRequest const&) { + return Idempotency::kNonIdempotent; +} + Idempotency AutoscalersConnectionIdempotencyPolicy::UpdateAutoscaler( google::cloud::cpp::compute::autoscalers::v1:: UpdateAutoscalerRequest const&) { diff --git a/google/cloud/compute/autoscalers/v1/autoscalers_connection_idempotency_policy.h b/google/cloud/compute/autoscalers/v1/autoscalers_connection_idempotency_policy.h index 7369d904468dc..e83edb3917257 100644 --- a/google/cloud/compute/autoscalers/v1/autoscalers_connection_idempotency_policy.h +++ b/google/cloud/compute/autoscalers/v1/autoscalers_connection_idempotency_policy.h @@ -60,6 +60,10 @@ class AutoscalersConnectionIdempotencyPolicy { google::cloud::cpp::compute::autoscalers::v1:: PatchAutoscalerRequest const& request); + virtual google::cloud::Idempotency TestIamPermissions( + google::cloud::cpp::compute::autoscalers::v1:: + TestIamPermissionsRequest const& request); + virtual google::cloud::Idempotency UpdateAutoscaler( google::cloud::cpp::compute::autoscalers::v1:: UpdateAutoscalerRequest const& request); diff --git a/google/cloud/compute/autoscalers/v1/autoscalers_proto_export.h b/google/cloud/compute/autoscalers/v1/autoscalers_proto_export.h index 16ac4b159f05c..e82e876760bd2 100644 --- a/google/cloud/compute/autoscalers/v1/autoscalers_proto_export.h +++ b/google/cloud/compute/autoscalers/v1/autoscalers_proto_export.h @@ -26,10 +26,11 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_AUTOSCALERS_V1_AUTOSCALERS_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include "google/cloud/compute/v1/internal/common_008.pb.h" -#include "google/cloud/compute/v1/internal/common_009.pb.h" -#include "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_040.pb.h" +#include "google/cloud/compute/v1/internal/common_010.pb.h" +#include "google/cloud/compute/v1/internal/common_011.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_049.pb.h" +#include "google/cloud/compute/v1/internal/common_171.pb.h" // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_AUTOSCALERS_V1_AUTOSCALERS_PROTO_EXPORT_H diff --git a/google/cloud/compute/autoscalers/v1/internal/autoscalers_rest_connection_impl.cc b/google/cloud/compute/autoscalers/v1/internal/autoscalers_rest_connection_impl.cc index 959cfca801c13..d3c33d8742332 100644 --- a/google/cloud/compute/autoscalers/v1/internal/autoscalers_rest_connection_impl.cc +++ b/google/cloud/compute/autoscalers/v1/internal/autoscalers_rest_connection_impl.cc @@ -533,6 +533,22 @@ AutoscalersRestConnectionImpl::PatchAutoscaler( }); } +StatusOr +AutoscalersRestConnectionImpl::TestIamPermissions( + google::cloud::cpp::compute::autoscalers::v1:: + TestIamPermissionsRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->TestIamPermissions(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::autoscalers::v1:: + TestIamPermissionsRequest const& request) { + return stub_->TestIamPermissions(rest_context, options, request); + }, + *current, request, __func__); +} + future> AutoscalersRestConnectionImpl::UpdateAutoscaler( google::cloud::cpp::compute::autoscalers::v1::UpdateAutoscalerRequest const& diff --git a/google/cloud/compute/autoscalers/v1/internal/autoscalers_rest_connection_impl.h b/google/cloud/compute/autoscalers/v1/internal/autoscalers_rest_connection_impl.h index fe60e6d32f5ac..48b988063cd87 100644 --- a/google/cloud/compute/autoscalers/v1/internal/autoscalers_rest_connection_impl.h +++ b/google/cloud/compute/autoscalers/v1/internal/autoscalers_rest_connection_impl.h @@ -98,6 +98,10 @@ class AutoscalersRestConnectionImpl future> PatchAutoscaler( google::cloud::cpp::compute::v1::Operation const& operation) override; + StatusOr + TestIamPermissions(google::cloud::cpp::compute::autoscalers::v1:: + TestIamPermissionsRequest const& request) override; + future> UpdateAutoscaler( google::cloud::cpp::compute::autoscalers::v1:: UpdateAutoscalerRequest const& request) override; diff --git a/google/cloud/compute/autoscalers/v1/internal/autoscalers_rest_logging_decorator.cc b/google/cloud/compute/autoscalers/v1/internal/autoscalers_rest_logging_decorator.cc index 3045808c8115d..ad8c0cda9921c 100644 --- a/google/cloud/compute/autoscalers/v1/internal/autoscalers_rest_logging_decorator.cc +++ b/google/cloud/compute/autoscalers/v1/internal/autoscalers_rest_logging_decorator.cc @@ -179,6 +179,20 @@ AutoscalersRestLogging::PatchAutoscaler( rest_context, options, request, __func__, tracing_options_); } +StatusOr +AutoscalersRestLogging::TestIamPermissions( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::autoscalers::v1:: + TestIamPermissionsRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::autoscalers::v1:: + TestIamPermissionsRequest const& request) { + return child_->TestIamPermissions(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + future> AutoscalersRestLogging::AsyncUpdateAutoscaler( CompletionQueue& cq, diff --git a/google/cloud/compute/autoscalers/v1/internal/autoscalers_rest_logging_decorator.h b/google/cloud/compute/autoscalers/v1/internal/autoscalers_rest_logging_decorator.h index 5b814a57e5cdb..8265db1e5ef49 100644 --- a/google/cloud/compute/autoscalers/v1/internal/autoscalers_rest_logging_decorator.h +++ b/google/cloud/compute/autoscalers/v1/internal/autoscalers_rest_logging_decorator.h @@ -103,6 +103,12 @@ class AutoscalersRestLogging : public AutoscalersRestStub { google::cloud::cpp::compute::autoscalers::v1:: PatchAutoscalerRequest const& request) override; + StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::autoscalers::v1:: + TestIamPermissionsRequest const& request) override; + future> AsyncUpdateAutoscaler( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/autoscalers/v1/internal/autoscalers_rest_metadata_decorator.cc b/google/cloud/compute/autoscalers/v1/internal/autoscalers_rest_metadata_decorator.cc index 5529940ed838f..23b382371cc12 100644 --- a/google/cloud/compute/autoscalers/v1/internal/autoscalers_rest_metadata_decorator.cc +++ b/google/cloud/compute/autoscalers/v1/internal/autoscalers_rest_metadata_decorator.cc @@ -128,6 +128,15 @@ AutoscalersRestMetadata::PatchAutoscaler( return child_->PatchAutoscaler(rest_context, options, request); } +StatusOr +AutoscalersRestMetadata::TestIamPermissions( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::autoscalers::v1:: + TestIamPermissionsRequest const& request) { + SetMetadata(rest_context, options); + return child_->TestIamPermissions(rest_context, options, request); +} + future> AutoscalersRestMetadata::AsyncUpdateAutoscaler( CompletionQueue& cq, diff --git a/google/cloud/compute/autoscalers/v1/internal/autoscalers_rest_metadata_decorator.h b/google/cloud/compute/autoscalers/v1/internal/autoscalers_rest_metadata_decorator.h index d748627b19c48..457cc1dcf3909 100644 --- a/google/cloud/compute/autoscalers/v1/internal/autoscalers_rest_metadata_decorator.h +++ b/google/cloud/compute/autoscalers/v1/internal/autoscalers_rest_metadata_decorator.h @@ -100,6 +100,12 @@ class AutoscalersRestMetadata : public AutoscalersRestStub { google::cloud::cpp::compute::autoscalers::v1:: PatchAutoscalerRequest const& request) override; + StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::autoscalers::v1:: + TestIamPermissionsRequest const& request) override; + google::cloud::future> AsyncUpdateAutoscaler( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/autoscalers/v1/internal/autoscalers_rest_stub.cc b/google/cloud/compute/autoscalers/v1/internal/autoscalers_rest_stub.cc index 7f13490b072d9..161dd3eecb36a 100644 --- a/google/cloud/compute/autoscalers/v1/internal/autoscalers_rest_stub.cc +++ b/google/cloud/compute/autoscalers/v1/internal/autoscalers_rest_stub.cc @@ -286,6 +286,25 @@ DefaultAutoscalersRestStub::PatchAutoscaler( std::move(query_params)); } +StatusOr +DefaultAutoscalersRestStub::TestIamPermissions( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::autoscalers::v1:: + TestIamPermissionsRequest const& request) { + std::vector> query_params; + return rest_internal::Post< + google::cloud::cpp::compute::v1::TestPermissionsResponse>( + *service_, rest_context, request.test_permissions_request_resource(), + false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "zones", "/", + request.zone(), "/", "autoscalers", "/", request.resource(), + "/", "testIamPermissions"), + std::move(query_params)); +} + future> DefaultAutoscalersRestStub::AsyncUpdateAutoscaler( CompletionQueue& cq, diff --git a/google/cloud/compute/autoscalers/v1/internal/autoscalers_rest_stub.h b/google/cloud/compute/autoscalers/v1/internal/autoscalers_rest_stub.h index c6569984ee812..7a5f4c325a6ad 100644 --- a/google/cloud/compute/autoscalers/v1/internal/autoscalers_rest_stub.h +++ b/google/cloud/compute/autoscalers/v1/internal/autoscalers_rest_stub.h @@ -98,6 +98,12 @@ class AutoscalersRestStub { google::cloud::cpp::compute::autoscalers::v1:: PatchAutoscalerRequest const& request) = 0; + virtual StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::autoscalers::v1:: + TestIamPermissionsRequest const& request) = 0; + virtual future> AsyncUpdateAutoscaler( google::cloud::CompletionQueue& cq, @@ -198,6 +204,12 @@ class DefaultAutoscalersRestStub : public AutoscalersRestStub { google::cloud::cpp::compute::autoscalers::v1:: PatchAutoscalerRequest const& request) override; + StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::autoscalers::v1:: + TestIamPermissionsRequest const& request) override; + future> AsyncUpdateAutoscaler( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/autoscalers/v1/internal/autoscalers_tracing_connection.cc b/google/cloud/compute/autoscalers/v1/internal/autoscalers_tracing_connection.cc index 63e0aa9602558..fe3164f378164 100644 --- a/google/cloud/compute/autoscalers/v1/internal/autoscalers_tracing_connection.cc +++ b/google/cloud/compute/autoscalers/v1/internal/autoscalers_tracing_connection.cc @@ -164,6 +164,16 @@ AutoscalersTracingConnection::PatchAutoscaler( return internal::EndSpan(std::move(span), child_->PatchAutoscaler(operation)); } +StatusOr +AutoscalersTracingConnection::TestIamPermissions( + google::cloud::cpp::compute::autoscalers::v1:: + TestIamPermissionsRequest const& request) { + auto span = internal::MakeSpan( + "compute_autoscalers_v1::AutoscalersConnection::TestIamPermissions"); + auto scope = opentelemetry::trace::Scope(span); + return internal::EndSpan(*span, child_->TestIamPermissions(request)); +} + future> AutoscalersTracingConnection::UpdateAutoscaler( google::cloud::cpp::compute::autoscalers::v1::UpdateAutoscalerRequest const& diff --git a/google/cloud/compute/autoscalers/v1/internal/autoscalers_tracing_connection.h b/google/cloud/compute/autoscalers/v1/internal/autoscalers_tracing_connection.h index 7b1847d4cb931..9d2e899fb86f9 100644 --- a/google/cloud/compute/autoscalers/v1/internal/autoscalers_tracing_connection.h +++ b/google/cloud/compute/autoscalers/v1/internal/autoscalers_tracing_connection.h @@ -85,6 +85,10 @@ class AutoscalersTracingConnection future> PatchAutoscaler( google::cloud::cpp::compute::v1::Operation const& operation) override; + StatusOr + TestIamPermissions(google::cloud::cpp::compute::autoscalers::v1:: + TestIamPermissionsRequest const& request) override; + future> UpdateAutoscaler( google::cloud::cpp::compute::autoscalers::v1:: UpdateAutoscalerRequest const& request) override; diff --git a/google/cloud/compute/autoscalers/v1/mocks/mock_autoscalers_connection.h b/google/cloud/compute/autoscalers/v1/mocks/mock_autoscalers_connection.h index fda7bdec4b24c..6165d2da2c988 100644 --- a/google/cloud/compute/autoscalers/v1/mocks/mock_autoscalers_connection.h +++ b/google/cloud/compute/autoscalers/v1/mocks/mock_autoscalers_connection.h @@ -192,6 +192,13 @@ class MockAutoscalersConnection (google::cloud::cpp::compute::v1::Operation const& operation), (override)); + MOCK_METHOD( + StatusOr, + TestIamPermissions, + (google::cloud::cpp::compute::autoscalers::v1:: + TestIamPermissionsRequest const& request), + (override)); + /// To disambiguate calls, use: /// /// @code diff --git a/google/cloud/compute/backend_buckets/v1/backend_buckets_client.cc b/google/cloud/compute/backend_buckets/v1/backend_buckets_client.cc index 7b4dee47d7024..c3c760db41764 100644 --- a/google/cloud/compute/backend_buckets/v1/backend_buckets_client.cc +++ b/google/cloud/compute/backend_buckets/v1/backend_buckets_client.cc @@ -88,6 +88,27 @@ BackendBucketsClient::AddSignedUrlKey( return connection_->AddSignedUrlKey(operation); } +StreamRange> +BackendBucketsClient::AggregatedListBackendBuckets(std::string const& project, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::backend_buckets::v1:: + AggregatedListBackendBucketsRequest request; + request.set_project(project); + return connection_->AggregatedListBackendBuckets(request); +} + +StreamRange> +BackendBucketsClient::AggregatedListBackendBuckets( + google::cloud::cpp::compute::backend_buckets::v1:: + AggregatedListBackendBucketsRequest request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->AggregatedListBackendBuckets(std::move(request)); +} + future> BackendBucketsClient::DeleteBackendBucket(std::string const& project, std::string const& backend_bucket, @@ -306,6 +327,22 @@ BackendBucketsClient::ListBackendBuckets( return connection_->ListBackendBuckets(std::move(request)); } +StreamRange +BackendBucketsClient::ListUsable(std::string const& project, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::backend_buckets::v1::ListUsableRequest request; + request.set_project(project); + return connection_->ListUsable(request); +} + +StreamRange +BackendBucketsClient::ListUsable( + google::cloud::cpp::compute::backend_buckets::v1::ListUsableRequest request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->ListUsable(std::move(request)); +} + future> BackendBucketsClient::PatchBackendBucket( std::string const& project, std::string const& backend_bucket, 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 bb0c441bf0197..caf09c9653010 100644 --- a/google/cloud/compute/backend_buckets/v1/backend_buckets_client.h +++ b/google/cloud/compute/backend_buckets/v1/backend_buckets_client.h @@ -26,6 +26,7 @@ #include "google/cloud/polling_policy.h" #include "google/cloud/status_or.h" #include "google/cloud/version.h" +#include #include #include @@ -117,7 +118,7 @@ class BackendBucketsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.backend_buckets.v1.AddSignedUrlKeyRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_buckets/v1/backend_buckets.proto#L197} + /// [google.cloud.cpp.compute.backend_buckets.v1.AddSignedUrlKeyRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_buckets/v1/backend_buckets.proto#L223} /// // clang-format on future> AddSignedUrlKey( @@ -175,7 +176,7 @@ class BackendBucketsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.backend_buckets.v1.AddSignedUrlKeyRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_buckets/v1/backend_buckets.proto#L197} + /// [google.cloud.cpp.compute.backend_buckets.v1.AddSignedUrlKeyRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_buckets/v1/backend_buckets.proto#L223} /// // clang-format on future> AddSignedUrlKey( @@ -213,6 +214,94 @@ class BackendBucketsClient { google::cloud::cpp::compute::v1::Operation const& operation, Options opts = {}); + // clang-format off + /// + /// Retrieves the list of all BackendBucket resources, regional and global, + /// available to the specified project. + /// + /// To prevent failure, it is recommended that you set the + /// `returnPartialSuccess` parameter to `true`. + /// https://cloud.google.com/compute/docs/reference/rest/v1/backendBuckets/aggregatedList + /// + /// @param project Name of the project scoping this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return a [StreamRange](@ref google::cloud::StreamRange) + /// to iterate of the results. See the documentation of this type for + /// details. In brief, this class has `begin()` and `end()` member + /// functions returning a iterator class meeting the + /// [input iterator requirements]. The value type for this iterator is a + /// [`StatusOr`] as the iteration may fail even after some values are + /// retrieved successfully, for example, if there is a network disconnect. + /// An empty set of results does not indicate an error, it indicates + /// that there are no resources meeting the request criteria. + /// On a successful iteration the `StatusOr` contains elements of type + /// [google.cloud.cpp.compute.v1.BackendBucketsScopedList], or rather, + /// the C++ class generated by Protobuf from that type. Please consult the + /// Protobuf documentation for details on the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.backend_buckets.v1.AggregatedListBackendBucketsRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_buckets/v1/backend_buckets.proto#L257} + /// [google.cloud.cpp.compute.v1.BackendBucketsScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_013.proto#L154} + /// + // clang-format on + StreamRange> + AggregatedListBackendBuckets(std::string const& project, Options opts = {}); + + // clang-format off + /// + /// Retrieves the list of all BackendBucket resources, regional and global, + /// available to the specified project. + /// + /// To prevent failure, it is recommended that you set the + /// `returnPartialSuccess` parameter to `true`. + /// https://cloud.google.com/compute/docs/reference/rest/v1/backendBuckets/aggregatedList + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.backend_buckets.v1.AggregatedListBackendBucketsRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return a [StreamRange](@ref google::cloud::StreamRange) + /// to iterate of the results. See the documentation of this type for + /// details. In brief, this class has `begin()` and `end()` member + /// functions returning a iterator class meeting the + /// [input iterator requirements]. The value type for this iterator is a + /// [`StatusOr`] as the iteration may fail even after some values are + /// retrieved successfully, for example, if there is a network disconnect. + /// An empty set of results does not indicate an error, it indicates + /// that there are no resources meeting the request criteria. + /// On a successful iteration the `StatusOr` contains elements of type + /// [google.cloud.cpp.compute.v1.BackendBucketsScopedList], or rather, + /// the C++ class generated by Protobuf from that type. Please consult the + /// Protobuf documentation for details on the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.backend_buckets.v1.AggregatedListBackendBucketsRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_buckets/v1/backend_buckets.proto#L257} + /// [google.cloud.cpp.compute.v1.BackendBucketsScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_013.proto#L154} + /// + // clang-format on + StreamRange> + AggregatedListBackendBuckets( + google::cloud::cpp::compute::backend_buckets::v1:: + AggregatedListBackendBucketsRequest request, + Options opts = {}); + // clang-format off /// /// Deletes the specified BackendBucket resource. @@ -240,7 +329,7 @@ class BackendBucketsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.backend_buckets.v1.DeleteBackendBucketRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_buckets/v1/backend_buckets.proto#L228} + /// [google.cloud.cpp.compute.backend_buckets.v1.DeleteBackendBucketRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_buckets/v1/backend_buckets.proto#L372} /// // clang-format on future> @@ -293,7 +382,7 @@ class BackendBucketsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.backend_buckets.v1.DeleteBackendBucketRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_buckets/v1/backend_buckets.proto#L228} + /// [google.cloud.cpp.compute.backend_buckets.v1.DeleteBackendBucketRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_buckets/v1/backend_buckets.proto#L372} /// // clang-format on future> @@ -362,7 +451,7 @@ class BackendBucketsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.backend_buckets.v1.DeleteSignedUrlKeyRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_buckets/v1/backend_buckets.proto#L254} + /// [google.cloud.cpp.compute.backend_buckets.v1.DeleteSignedUrlKeyRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_buckets/v1/backend_buckets.proto#L401} /// // clang-format on future> @@ -417,7 +506,7 @@ class BackendBucketsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.backend_buckets.v1.DeleteSignedUrlKeyRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_buckets/v1/backend_buckets.proto#L254} + /// [google.cloud.cpp.compute.backend_buckets.v1.DeleteSignedUrlKeyRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_buckets/v1/backend_buckets.proto#L401} /// // clang-format on future> @@ -476,8 +565,8 @@ class BackendBucketsClient { /// [`future`]: @ref google::cloud::future /// [`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_010.proto#L27} + /// [google.cloud.cpp.compute.backend_buckets.v1.GetBackendBucketRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_buckets/v1/backend_buckets.proto#L435} + /// [google.cloud.cpp.compute.v1.BackendBucket]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_012.proto#L28} /// // clang-format on StatusOr GetBackendBucket( @@ -508,8 +597,8 @@ class BackendBucketsClient { /// [`future`]: @ref google::cloud::future /// [`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_010.proto#L27} + /// [google.cloud.cpp.compute.backend_buckets.v1.GetBackendBucketRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_buckets/v1/backend_buckets.proto#L435} + /// [google.cloud.cpp.compute.v1.BackendBucket]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_012.proto#L28} /// // clang-format on StatusOr GetBackendBucket( @@ -538,8 +627,8 @@ class BackendBucketsClient { /// [`future`]: @ref google::cloud::future /// [`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_007.proto#L178} + /// [google.cloud.cpp.compute.backend_buckets.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_buckets/v1/backend_buckets.proto#L446} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr GetIamPolicy( @@ -571,8 +660,8 @@ class BackendBucketsClient { /// [`future`]: @ref google::cloud::future /// [`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_007.proto#L178} + /// [google.cloud.cpp.compute.backend_buckets.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_buckets/v1/backend_buckets.proto#L446} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr GetIamPolicy( @@ -582,8 +671,8 @@ class BackendBucketsClient { // clang-format off /// - /// Creates a BackendBucket resource in the specified project using the data - /// included in the request. + /// Creates a BackendBucket resource in the specified project using + /// the data included in the request. /// https://cloud.google.com/compute/docs/reference/rest/v1/backendBuckets/insert /// /// @param project Project ID for this request. @@ -608,7 +697,7 @@ class BackendBucketsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.backend_buckets.v1.InsertBackendBucketRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_buckets/v1/backend_buckets.proto#L311} + /// [google.cloud.cpp.compute.backend_buckets.v1.InsertBackendBucketRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_buckets/v1/backend_buckets.proto#L461} /// // clang-format on future> @@ -636,8 +725,8 @@ class BackendBucketsClient { // clang-format off /// - /// Creates a BackendBucket resource in the specified project using the data - /// included in the request. + /// Creates a BackendBucket resource in the specified project using + /// the data included in the request. /// https://cloud.google.com/compute/docs/reference/rest/v1/backendBuckets/insert /// /// @param request Unary RPCs, such as the one wrapped by this @@ -666,7 +755,7 @@ class BackendBucketsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.backend_buckets.v1.InsertBackendBucketRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_buckets/v1/backend_buckets.proto#L311} + /// [google.cloud.cpp.compute.backend_buckets.v1.InsertBackendBucketRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_buckets/v1/backend_buckets.proto#L461} /// // clang-format on future> @@ -734,8 +823,8 @@ class BackendBucketsClient { /// [`future`]: @ref google::cloud::future /// [`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_010.proto#L27} + /// [google.cloud.cpp.compute.backend_buckets.v1.ListBackendBucketsRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_buckets/v1/backend_buckets.proto#L490} + /// [google.cloud.cpp.compute.v1.BackendBucket]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_012.proto#L28} /// // clang-format on StreamRange @@ -775,8 +864,8 @@ class BackendBucketsClient { /// [`future`]: @ref google::cloud::future /// [`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_010.proto#L27} + /// [google.cloud.cpp.compute.backend_buckets.v1.ListBackendBucketsRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_buckets/v1/backend_buckets.proto#L490} + /// [google.cloud.cpp.compute.v1.BackendBucket]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_012.proto#L28} /// // clang-format on StreamRange @@ -784,11 +873,89 @@ class BackendBucketsClient { ListBackendBucketsRequest request, Options opts = {}); + // clang-format off + /// + /// Retrieves a list of all usable backend buckets in the specified project. + /// https://cloud.google.com/compute/docs/reference/rest/v1/backendBuckets/listUsable + /// + /// @param project Project ID for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return a [StreamRange](@ref google::cloud::StreamRange) + /// to iterate of the results. See the documentation of this type for + /// details. In brief, this class has `begin()` and `end()` member + /// functions returning a iterator class meeting the + /// [input iterator requirements]. The value type for this iterator is a + /// [`StatusOr`] as the iteration may fail even after some values are + /// retrieved successfully, for example, if there is a network disconnect. + /// An empty set of results does not indicate an error, it indicates + /// that there are no resources meeting the request criteria. + /// On a successful iteration the `StatusOr` contains elements of type + /// [google.cloud.cpp.compute.v1.BackendBucket], or rather, + /// the C++ class generated by Protobuf from that type. Please consult the + /// Protobuf documentation for details on the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.backend_buckets.v1.ListUsableRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_buckets/v1/backend_buckets.proto#L591} + /// [google.cloud.cpp.compute.v1.BackendBucket]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_012.proto#L28} + /// + // clang-format on + StreamRange ListUsable( + std::string const& project, Options opts = {}); + + // clang-format off + /// + /// Retrieves a list of all usable backend buckets in the specified project. + /// https://cloud.google.com/compute/docs/reference/rest/v1/backendBuckets/listUsable + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.backend_buckets.v1.ListUsableRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return a [StreamRange](@ref google::cloud::StreamRange) + /// to iterate of the results. See the documentation of this type for + /// details. In brief, this class has `begin()` and `end()` member + /// functions returning a iterator class meeting the + /// [input iterator requirements]. The value type for this iterator is a + /// [`StatusOr`] as the iteration may fail even after some values are + /// retrieved successfully, for example, if there is a network disconnect. + /// An empty set of results does not indicate an error, it indicates + /// that there are no resources meeting the request criteria. + /// On a successful iteration the `StatusOr` contains elements of type + /// [google.cloud.cpp.compute.v1.BackendBucket], or rather, + /// the C++ class generated by Protobuf from that type. Please consult the + /// Protobuf documentation for details on the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.backend_buckets.v1.ListUsableRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_buckets/v1/backend_buckets.proto#L591} + /// [google.cloud.cpp.compute.v1.BackendBucket]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_012.proto#L28} + /// + // clang-format on + StreamRange ListUsable( + google::cloud::cpp::compute::backend_buckets::v1::ListUsableRequest + request, + Options opts = {}); + // clang-format off /// /// 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. + /// request. This method supportsPATCH + /// semantics and uses theJSON merge + /// patch format and processing rules. /// https://cloud.google.com/compute/docs/reference/rest/v1/backendBuckets/patch /// /// @param project Project ID for this request. @@ -814,7 +981,7 @@ class BackendBucketsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.backend_buckets.v1.PatchBackendBucketRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_buckets/v1/backend_buckets.proto#L405} + /// [google.cloud.cpp.compute.backend_buckets.v1.PatchBackendBucketRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_buckets/v1/backend_buckets.proto#L692} /// // clang-format on future> @@ -844,8 +1011,9 @@ class BackendBucketsClient { // clang-format off /// /// 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. + /// request. This method supportsPATCH + /// semantics and uses theJSON merge + /// patch format and processing rules. /// https://cloud.google.com/compute/docs/reference/rest/v1/backendBuckets/patch /// /// @param request Unary RPCs, such as the one wrapped by this @@ -874,7 +1042,7 @@ class BackendBucketsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.backend_buckets.v1.PatchBackendBucketRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_buckets/v1/backend_buckets.proto#L405} + /// [google.cloud.cpp.compute.backend_buckets.v1.PatchBackendBucketRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_buckets/v1/backend_buckets.proto#L692} /// // clang-format on future> @@ -942,7 +1110,7 @@ class BackendBucketsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.backend_buckets.v1.SetEdgeSecurityPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_buckets/v1/backend_buckets.proto#L435} + /// [google.cloud.cpp.compute.backend_buckets.v1.SetEdgeSecurityPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_buckets/v1/backend_buckets.proto#L725} /// // clang-format on future> @@ -1000,7 +1168,7 @@ class BackendBucketsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.backend_buckets.v1.SetEdgeSecurityPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_buckets/v1/backend_buckets.proto#L435} + /// [google.cloud.cpp.compute.backend_buckets.v1.SetEdgeSecurityPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_buckets/v1/backend_buckets.proto#L725} /// // clang-format on future> @@ -1041,8 +1209,8 @@ class BackendBucketsClient { // clang-format off /// - /// Sets the access control policy on the specified resource. Replaces any - /// existing policy. + /// Sets the access control policy on the specified resource. + /// Replaces any existing policy. /// https://cloud.google.com/compute/docs/reference/rest/v1/backendBuckets/setIamPolicy /// /// @param project Project ID for this request. @@ -1061,8 +1229,8 @@ class BackendBucketsClient { /// [`future`]: @ref google::cloud::future /// [`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_007.proto#L178} + /// [google.cloud.cpp.compute.backend_buckets.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_buckets/v1/backend_buckets.proto#L760} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr SetIamPolicy( @@ -1073,8 +1241,8 @@ class BackendBucketsClient { // clang-format off /// - /// Sets the access control policy on the specified resource. Replaces any - /// existing policy. + /// Sets the access control policy on the specified resource. + /// Replaces any existing policy. /// https://cloud.google.com/compute/docs/reference/rest/v1/backendBuckets/setIamPolicy /// /// @param request Unary RPCs, such as the one wrapped by this @@ -1096,8 +1264,8 @@ class BackendBucketsClient { /// [`future`]: @ref google::cloud::future /// [`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_007.proto#L178} + /// [google.cloud.cpp.compute.backend_buckets.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_buckets/v1/backend_buckets.proto#L760} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr SetIamPolicy( @@ -1126,8 +1294,8 @@ class BackendBucketsClient { /// [`future`]: @ref google::cloud::future /// [`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_145.proto#L30} + /// [google.cloud.cpp.compute.backend_buckets.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_buckets/v1/backend_buckets.proto#L776} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} /// // clang-format on StatusOr @@ -1161,8 +1329,8 @@ class BackendBucketsClient { /// [`future`]: @ref google::cloud::future /// [`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_145.proto#L30} + /// [google.cloud.cpp.compute.backend_buckets.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_buckets/v1/backend_buckets.proto#L776} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} /// // clang-format on StatusOr @@ -1199,7 +1367,7 @@ class BackendBucketsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.backend_buckets.v1.UpdateBackendBucketRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_buckets/v1/backend_buckets.proto#L498} + /// [google.cloud.cpp.compute.backend_buckets.v1.UpdateBackendBucketRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_buckets/v1/backend_buckets.proto#L791} /// // clang-format on future> @@ -1258,7 +1426,7 @@ class BackendBucketsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.backend_buckets.v1.UpdateBackendBucketRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_buckets/v1/backend_buckets.proto#L498} + /// [google.cloud.cpp.compute.backend_buckets.v1.UpdateBackendBucketRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_buckets/v1/backend_buckets.proto#L791} /// // clang-format on future> diff --git a/google/cloud/compute/backend_buckets/v1/backend_buckets_connection.cc b/google/cloud/compute/backend_buckets/v1/backend_buckets_connection.cc index e1d1fd2ff91ea..d54b5fc431e5f 100644 --- a/google/cloud/compute/backend_buckets/v1/backend_buckets_connection.cc +++ b/google/cloud/compute/backend_buckets/v1/backend_buckets_connection.cc @@ -61,6 +61,16 @@ BackendBucketsConnection::AddSignedUrlKey( Status(StatusCode::kUnimplemented, "not implemented")); } +StreamRange> +BackendBucketsConnection::AggregatedListBackendBuckets( + google::cloud::cpp::compute::backend_buckets::v1:: + AggregatedListBackendBucketsRequest) { // NOLINT(performance-unnecessary-value-param) + return google::cloud::internal::MakeUnimplementedPaginationRange>>(); +} + future> BackendBucketsConnection::DeleteBackendBucket( google::cloud::cpp::compute::backend_buckets::v1:: @@ -158,6 +168,14 @@ BackendBucketsConnection::ListBackendBuckets( StreamRange>(); } +StreamRange +BackendBucketsConnection::ListUsable( + google::cloud::cpp::compute::backend_buckets::v1:: + ListUsableRequest) { // NOLINT(performance-unnecessary-value-param) + return google::cloud::internal::MakeUnimplementedPaginationRange< + StreamRange>(); +} + future> BackendBucketsConnection::PatchBackendBucket( google::cloud::cpp::compute::backend_buckets::v1:: diff --git a/google/cloud/compute/backend_buckets/v1/backend_buckets_connection.h b/google/cloud/compute/backend_buckets/v1/backend_buckets_connection.h index 2ab9fe847ef94..c70651f4bb98b 100644 --- a/google/cloud/compute/backend_buckets/v1/backend_buckets_connection.h +++ b/google/cloud/compute/backend_buckets/v1/backend_buckets_connection.h @@ -197,6 +197,12 @@ class BackendBucketsConnection { virtual future> AddSignedUrlKey(google::cloud::cpp::compute::v1::Operation const& operation); + virtual StreamRange> + AggregatedListBackendBuckets( + google::cloud::cpp::compute::backend_buckets::v1:: + AggregatedListBackendBucketsRequest request); + virtual future> DeleteBackendBucket(google::cloud::cpp::compute::backend_buckets::v1:: DeleteBackendBucketRequest const& request); @@ -248,6 +254,10 @@ class BackendBucketsConnection { ListBackendBuckets(google::cloud::cpp::compute::backend_buckets::v1:: ListBackendBucketsRequest request); + virtual StreamRange + ListUsable(google::cloud::cpp::compute::backend_buckets::v1::ListUsableRequest + request); + virtual future> PatchBackendBucket(google::cloud::cpp::compute::backend_buckets::v1:: PatchBackendBucketRequest const& request); diff --git a/google/cloud/compute/backend_buckets/v1/backend_buckets_connection_idempotency_policy.cc b/google/cloud/compute/backend_buckets/v1/backend_buckets_connection_idempotency_policy.cc index 1dcc52c8226b9..6e80e481acc0e 100644 --- a/google/cloud/compute/backend_buckets/v1/backend_buckets_connection_idempotency_policy.cc +++ b/google/cloud/compute/backend_buckets/v1/backend_buckets_connection_idempotency_policy.cc @@ -40,6 +40,13 @@ Idempotency BackendBucketsConnectionIdempotencyPolicy::AddSignedUrlKey( return Idempotency::kNonIdempotent; } +Idempotency +BackendBucketsConnectionIdempotencyPolicy::AggregatedListBackendBuckets( + google::cloud::cpp::compute::backend_buckets::v1:: + AggregatedListBackendBucketsRequest) { // NOLINT + return Idempotency::kIdempotent; +} + Idempotency BackendBucketsConnectionIdempotencyPolicy::DeleteBackendBucket( google::cloud::cpp::compute::backend_buckets::v1:: DeleteBackendBucketRequest const&) { @@ -76,6 +83,12 @@ Idempotency BackendBucketsConnectionIdempotencyPolicy::ListBackendBuckets( return Idempotency::kIdempotent; } +Idempotency BackendBucketsConnectionIdempotencyPolicy::ListUsable( + google::cloud::cpp::compute::backend_buckets::v1:: + ListUsableRequest) { // NOLINT + return Idempotency::kIdempotent; +} + Idempotency BackendBucketsConnectionIdempotencyPolicy::PatchBackendBucket( google::cloud::cpp::compute::backend_buckets::v1:: PatchBackendBucketRequest const&) { diff --git a/google/cloud/compute/backend_buckets/v1/backend_buckets_connection_idempotency_policy.h b/google/cloud/compute/backend_buckets/v1/backend_buckets_connection_idempotency_policy.h index 3599e6ad76d4f..d09daa2f42ff8 100644 --- a/google/cloud/compute/backend_buckets/v1/backend_buckets_connection_idempotency_policy.h +++ b/google/cloud/compute/backend_buckets/v1/backend_buckets_connection_idempotency_policy.h @@ -41,6 +41,10 @@ class BackendBucketsConnectionIdempotencyPolicy { google::cloud::cpp::compute::backend_buckets::v1:: AddSignedUrlKeyRequest const& request); + virtual google::cloud::Idempotency AggregatedListBackendBuckets( + google::cloud::cpp::compute::backend_buckets::v1:: + AggregatedListBackendBucketsRequest request); + virtual google::cloud::Idempotency DeleteBackendBucket( google::cloud::cpp::compute::backend_buckets::v1:: DeleteBackendBucketRequest const& request); @@ -65,6 +69,10 @@ class BackendBucketsConnectionIdempotencyPolicy { google::cloud::cpp::compute::backend_buckets::v1:: ListBackendBucketsRequest request); + virtual google::cloud::Idempotency ListUsable( + google::cloud::cpp::compute::backend_buckets::v1::ListUsableRequest + request); + virtual google::cloud::Idempotency PatchBackendBucket( google::cloud::cpp::compute::backend_buckets::v1:: PatchBackendBucketRequest const& request); 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 3e8399bd2ecec..e1a390487bf48 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,15 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_BACKEND_BUCKETS_V1_BACKEND_BUCKETS_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include "google/cloud/compute/v1/internal/common_007.pb.h" -#include "google/cloud/compute/v1/internal/common_010.pb.h" -#include "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_031.pb.h" -#include "google/cloud/compute/v1/internal/common_047.pb.h" -#include "google/cloud/compute/v1/internal/common_118.pb.h" -#include "google/cloud/compute/v1/internal/common_121.pb.h" +#include "google/cloud/compute/v1/internal/common_009.pb.h" +#include "google/cloud/compute/v1/internal/common_012.pb.h" +#include "google/cloud/compute/v1/internal/common_013.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_040.pb.h" +#include "google/cloud/compute/v1/internal/common_057.pb.h" +#include "google/cloud/compute/v1/internal/common_142.pb.h" #include "google/cloud/compute/v1/internal/common_145.pb.h" +#include "google/cloud/compute/v1/internal/common_171.pb.h" // 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_buckets/v1/internal/backend_buckets_rest_connection_impl.cc b/google/cloud/compute/backend_buckets/v1/internal/backend_buckets_rest_connection_impl.cc index ded1fe3941703..29e07aec6ac3c 100644 --- a/google/cloud/compute/backend_buckets/v1/internal/backend_buckets_rest_connection_impl.cc +++ b/google/cloud/compute/backend_buckets/v1/internal/backend_buckets_rest_connection_impl.cc @@ -171,6 +171,48 @@ BackendBucketsRestConnectionImpl::AddSignedUrlKey( }); } +StreamRange> +BackendBucketsRestConnectionImpl::AggregatedListBackendBuckets( + google::cloud::cpp::compute::backend_buckets::v1:: + AggregatedListBackendBucketsRequest request) { + request.clear_page_token(); + auto current = google::cloud::internal::SaveCurrentOptions(); + auto idempotency = + idempotency_policy(*current)->AggregatedListBackendBuckets(request); + char const* function_name = __func__; + return google::cloud::internal::MakePaginationRange>>( + current, std::move(request), + [idempotency, function_name, stub = stub_, + retry = std::shared_ptr< + compute_backend_buckets_v1::BackendBucketsRetryPolicy>( + retry_policy(*current)), + backoff = std::shared_ptr(backoff_policy(*current))]( + Options const& options, + google::cloud::cpp::compute::backend_buckets::v1:: + AggregatedListBackendBucketsRequest const& r) { + return google::cloud::rest_internal::RestRetryLoop( + retry->clone(), backoff->clone(), idempotency, + [stub](rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::backend_buckets::v1:: + AggregatedListBackendBucketsRequest const& request) { + return stub->AggregatedListBackendBuckets(rest_context, options, + request); + }, + options, r, function_name); + }, + [](google::cloud::cpp::compute::v1::BackendBucketAggregatedList r) { + std::vector> + result(r.items().size()); + auto& messages = *r.mutable_items(); + std::move(messages.begin(), messages.end(), result.begin()); + return result; + }); +} + future> BackendBucketsRestConnectionImpl::DeleteBackendBucket( google::cloud::cpp::compute::backend_buckets::v1:: @@ -621,6 +663,43 @@ BackendBucketsRestConnectionImpl::ListBackendBuckets( }); } +StreamRange +BackendBucketsRestConnectionImpl::ListUsable( + google::cloud::cpp::compute::backend_buckets::v1::ListUsableRequest + request) { + request.clear_page_token(); + auto current = google::cloud::internal::SaveCurrentOptions(); + auto idempotency = idempotency_policy(*current)->ListUsable(request); + char const* function_name = __func__; + return google::cloud::internal::MakePaginationRange< + StreamRange>( + current, std::move(request), + [idempotency, function_name, stub = stub_, + retry = std::shared_ptr< + compute_backend_buckets_v1::BackendBucketsRetryPolicy>( + retry_policy(*current)), + backoff = std::shared_ptr(backoff_policy(*current))]( + Options const& options, google::cloud::cpp::compute::backend_buckets:: + v1::ListUsableRequest const& r) { + return google::cloud::rest_internal::RestRetryLoop( + retry->clone(), backoff->clone(), idempotency, + [stub](rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::backend_buckets::v1:: + ListUsableRequest const& request) { + return stub->ListUsable(rest_context, options, request); + }, + options, r, function_name); + }, + [](google::cloud::cpp::compute::v1::BackendBucketListUsable r) { + std::vector result( + r.items().size()); + auto& messages = *r.mutable_items(); + std::move(messages.begin(), messages.end(), result.begin()); + return result; + }); +} + future> BackendBucketsRestConnectionImpl::PatchBackendBucket( google::cloud::cpp::compute::backend_buckets::v1:: diff --git a/google/cloud/compute/backend_buckets/v1/internal/backend_buckets_rest_connection_impl.h b/google/cloud/compute/backend_buckets/v1/internal/backend_buckets_rest_connection_impl.h index a714e33c7b09a..645433d3aec49 100644 --- a/google/cloud/compute/backend_buckets/v1/internal/backend_buckets_rest_connection_impl.h +++ b/google/cloud/compute/backend_buckets/v1/internal/backend_buckets_rest_connection_impl.h @@ -63,6 +63,12 @@ class BackendBucketsRestConnectionImpl future> AddSignedUrlKey( google::cloud::cpp::compute::v1::Operation const& operation) override; + StreamRange> + AggregatedListBackendBuckets( + google::cloud::cpp::compute::backend_buckets::v1:: + AggregatedListBackendBucketsRequest request) override; + future> DeleteBackendBucket(google::cloud::cpp::compute::backend_buckets::v1:: DeleteBackendBucketRequest const& request) override; @@ -111,6 +117,10 @@ class BackendBucketsRestConnectionImpl ListBackendBuckets(google::cloud::cpp::compute::backend_buckets::v1:: ListBackendBucketsRequest request) override; + StreamRange ListUsable( + google::cloud::cpp::compute::backend_buckets::v1::ListUsableRequest + request) override; + future> PatchBackendBucket(google::cloud::cpp::compute::backend_buckets::v1:: PatchBackendBucketRequest const& request) override; diff --git a/google/cloud/compute/backend_buckets/v1/internal/backend_buckets_rest_logging_decorator.cc b/google/cloud/compute/backend_buckets/v1/internal/backend_buckets_rest_logging_decorator.cc index 8c9b9d7868e37..63614fa2d2f2d 100644 --- a/google/cloud/compute/backend_buckets/v1/internal/backend_buckets_rest_logging_decorator.cc +++ b/google/cloud/compute/backend_buckets/v1/internal/backend_buckets_rest_logging_decorator.cc @@ -68,6 +68,21 @@ BackendBucketsRestLogging::AddSignedUrlKey( rest_context, options, request, __func__, tracing_options_); } +StatusOr +BackendBucketsRestLogging::AggregatedListBackendBuckets( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::backend_buckets::v1:: + AggregatedListBackendBucketsRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::backend_buckets::v1:: + AggregatedListBackendBucketsRequest const& request) { + return child_->AggregatedListBackendBuckets(rest_context, options, + request); + }, + rest_context, options, request, __func__, tracing_options_); +} + future> BackendBucketsRestLogging::AsyncDeleteBackendBucket( CompletionQueue& cq, @@ -212,6 +227,20 @@ BackendBucketsRestLogging::ListBackendBuckets( rest_context, options, request, __func__, tracing_options_); } +StatusOr +BackendBucketsRestLogging::ListUsable( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::backend_buckets::v1::ListUsableRequest const& + request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::backend_buckets::v1:: + ListUsableRequest const& request) { + return child_->ListUsable(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + future> BackendBucketsRestLogging::AsyncPatchBackendBucket( CompletionQueue& cq, diff --git a/google/cloud/compute/backend_buckets/v1/internal/backend_buckets_rest_logging_decorator.h b/google/cloud/compute/backend_buckets/v1/internal/backend_buckets_rest_logging_decorator.h index 68ab2f27e797b..4278a09730b4e 100644 --- a/google/cloud/compute/backend_buckets/v1/internal/backend_buckets_rest_logging_decorator.h +++ b/google/cloud/compute/backend_buckets/v1/internal/backend_buckets_rest_logging_decorator.h @@ -56,6 +56,13 @@ class BackendBucketsRestLogging : public BackendBucketsRestStub { google::cloud::cpp::compute::backend_buckets::v1:: AddSignedUrlKeyRequest const& request) override; + StatusOr + AggregatedListBackendBuckets( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::backend_buckets::v1:: + AggregatedListBackendBucketsRequest const& request) override; + future> AsyncDeleteBackendBucket( google::cloud::CompletionQueue& cq, @@ -116,6 +123,12 @@ class BackendBucketsRestLogging : public BackendBucketsRestStub { google::cloud::cpp::compute::backend_buckets::v1:: ListBackendBucketsRequest const& request) override; + StatusOr ListUsable( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::backend_buckets::v1::ListUsableRequest const& + request) override; + future> AsyncPatchBackendBucket( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/backend_buckets/v1/internal/backend_buckets_rest_metadata_decorator.cc b/google/cloud/compute/backend_buckets/v1/internal/backend_buckets_rest_metadata_decorator.cc index b5541093271aa..c8b827f22fb59 100644 --- a/google/cloud/compute/backend_buckets/v1/internal/backend_buckets_rest_metadata_decorator.cc +++ b/google/cloud/compute/backend_buckets/v1/internal/backend_buckets_rest_metadata_decorator.cc @@ -60,6 +60,15 @@ BackendBucketsRestMetadata::AddSignedUrlKey( return child_->AddSignedUrlKey(rest_context, options, request); } +StatusOr +BackendBucketsRestMetadata::AggregatedListBackendBuckets( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::backend_buckets::v1:: + AggregatedListBackendBucketsRequest const& request) { + SetMetadata(rest_context, options); + return child_->AggregatedListBackendBuckets(rest_context, options, request); +} + future> BackendBucketsRestMetadata::AsyncDeleteBackendBucket( CompletionQueue& cq, @@ -150,6 +159,15 @@ BackendBucketsRestMetadata::ListBackendBuckets( return child_->ListBackendBuckets(rest_context, options, request); } +StatusOr +BackendBucketsRestMetadata::ListUsable( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::backend_buckets::v1::ListUsableRequest const& + request) { + SetMetadata(rest_context, options); + return child_->ListUsable(rest_context, options, request); +} + future> BackendBucketsRestMetadata::AsyncPatchBackendBucket( CompletionQueue& cq, diff --git a/google/cloud/compute/backend_buckets/v1/internal/backend_buckets_rest_metadata_decorator.h b/google/cloud/compute/backend_buckets/v1/internal/backend_buckets_rest_metadata_decorator.h index 660359ad74c88..dc42190195626 100644 --- a/google/cloud/compute/backend_buckets/v1/internal/backend_buckets_rest_metadata_decorator.h +++ b/google/cloud/compute/backend_buckets/v1/internal/backend_buckets_rest_metadata_decorator.h @@ -54,6 +54,13 @@ class BackendBucketsRestMetadata : public BackendBucketsRestStub { google::cloud::cpp::compute::backend_buckets::v1:: AddSignedUrlKeyRequest const& request) override; + StatusOr + AggregatedListBackendBuckets( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::backend_buckets::v1:: + AggregatedListBackendBucketsRequest const& request) override; + google::cloud::future> AsyncDeleteBackendBucket( google::cloud::CompletionQueue& cq, @@ -114,6 +121,12 @@ class BackendBucketsRestMetadata : public BackendBucketsRestStub { google::cloud::cpp::compute::backend_buckets::v1:: ListBackendBucketsRequest const& request) override; + StatusOr ListUsable( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::backend_buckets::v1::ListUsableRequest const& + request) override; + google::cloud::future> AsyncPatchBackendBucket( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/backend_buckets/v1/internal/backend_buckets_rest_stub.cc b/google/cloud/compute/backend_buckets/v1/internal/backend_buckets_rest_stub.cc index cdc795a8900c4..587eb2efd1931 100644 --- a/google/cloud/compute/backend_buckets/v1/internal/backend_buckets_rest_stub.cc +++ b/google/cloud/compute/backend_buckets/v1/internal/backend_buckets_rest_stub.cc @@ -103,6 +103,36 @@ DefaultBackendBucketsRestStub::AddSignedUrlKey( std::move(query_params)); } +StatusOr +DefaultBackendBucketsRestStub::AggregatedListBackendBuckets( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::backend_buckets::v1:: + AggregatedListBackendBucketsRequest const& request) { + std::vector> query_params; + query_params.push_back({"filter", request.filter()}); + query_params.push_back( + {"include_all_scopes", (request.include_all_scopes() ? "1" : "0")}); + query_params.push_back( + {"max_results", std::to_string(request.max_results())}); + query_params.push_back({"order_by", request.order_by()}); + query_params.push_back({"page_token", request.page_token()}); + query_params.push_back({"return_partial_success", + (request.return_partial_success() ? "1" : "0")}); + query_params.push_back( + {"service_project_number", request.service_project_number()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Get< + google::cloud::cpp::compute::v1::BackendBucketAggregatedList>( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "aggregated", "/", + "backendBuckets"), + std::move(query_params)); +} + future> DefaultBackendBucketsRestStub::AsyncDeleteBackendBucket( CompletionQueue& cq, @@ -330,6 +360,32 @@ DefaultBackendBucketsRestStub::ListBackendBuckets( std::move(query_params)); } +StatusOr +DefaultBackendBucketsRestStub::ListUsable( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::backend_buckets::v1::ListUsableRequest const& + request) { + std::vector> query_params; + query_params.push_back({"filter", request.filter()}); + query_params.push_back( + {"max_results", std::to_string(request.max_results())}); + query_params.push_back({"order_by", request.order_by()}); + query_params.push_back({"page_token", request.page_token()}); + query_params.push_back({"return_partial_success", + (request.return_partial_success() ? "1" : "0")}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Get< + google::cloud::cpp::compute::v1::BackendBucketListUsable>( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "global", "/", + "backendBuckets", "/", "listUsable"), + std::move(query_params)); +} + future> DefaultBackendBucketsRestStub::AsyncPatchBackendBucket( CompletionQueue& cq, diff --git a/google/cloud/compute/backend_buckets/v1/internal/backend_buckets_rest_stub.h b/google/cloud/compute/backend_buckets/v1/internal/backend_buckets_rest_stub.h index d607a319a6ef2..9757ce26cd5bd 100644 --- a/google/cloud/compute/backend_buckets/v1/internal/backend_buckets_rest_stub.h +++ b/google/cloud/compute/backend_buckets/v1/internal/backend_buckets_rest_stub.h @@ -51,6 +51,13 @@ class BackendBucketsRestStub { google::cloud::cpp::compute::backend_buckets::v1:: AddSignedUrlKeyRequest const& request) = 0; + virtual StatusOr + AggregatedListBackendBuckets( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::backend_buckets::v1:: + AggregatedListBackendBucketsRequest const& request) = 0; + virtual future> AsyncDeleteBackendBucket( google::cloud::CompletionQueue& cq, @@ -111,6 +118,13 @@ class BackendBucketsRestStub { google::cloud::cpp::compute::backend_buckets::v1:: ListBackendBucketsRequest const& request) = 0; + virtual StatusOr + ListUsable( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::backend_buckets::v1::ListUsableRequest const& + request) = 0; + virtual future> AsyncPatchBackendBucket( google::cloud::CompletionQueue& cq, @@ -204,6 +218,13 @@ class DefaultBackendBucketsRestStub : public BackendBucketsRestStub { google::cloud::cpp::compute::backend_buckets::v1:: AddSignedUrlKeyRequest const& request) override; + StatusOr + AggregatedListBackendBuckets( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::backend_buckets::v1:: + AggregatedListBackendBucketsRequest const& request) override; + future> AsyncDeleteBackendBucket( google::cloud::CompletionQueue& cq, @@ -264,6 +285,12 @@ class DefaultBackendBucketsRestStub : public BackendBucketsRestStub { google::cloud::cpp::compute::backend_buckets::v1:: ListBackendBucketsRequest const& request) override; + StatusOr ListUsable( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::backend_buckets::v1::ListUsableRequest const& + request) override; + future> AsyncPatchBackendBucket( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/backend_buckets/v1/internal/backend_buckets_tracing_connection.cc b/google/cloud/compute/backend_buckets/v1/internal/backend_buckets_tracing_connection.cc index 6d9fce1a05ff4..f1745d488fc05 100644 --- a/google/cloud/compute/backend_buckets/v1/internal/backend_buckets_tracing_connection.cc +++ b/google/cloud/compute/backend_buckets/v1/internal/backend_buckets_tracing_connection.cc @@ -61,6 +61,21 @@ BackendBucketsTracingConnection::AddSignedUrlKey( return internal::EndSpan(std::move(span), child_->AddSignedUrlKey(operation)); } +StreamRange> +BackendBucketsTracingConnection::AggregatedListBackendBuckets( + google::cloud::cpp::compute::backend_buckets::v1:: + AggregatedListBackendBucketsRequest request) { + auto span = internal::MakeSpan( + "compute_backend_buckets_v1::BackendBucketsConnection::" + "AggregatedListBackendBuckets"); + internal::OTelScope scope(span); + auto sr = child_->AggregatedListBackendBuckets(std::move(request)); + return internal::MakeTracedStreamRange>( + std::move(span), std::move(sr)); +} + future> BackendBucketsTracingConnection::DeleteBackendBucket( google::cloud::cpp::compute::backend_buckets::v1:: @@ -200,6 +215,19 @@ BackendBucketsTracingConnection::ListBackendBuckets( std::move(sr)); } +StreamRange +BackendBucketsTracingConnection::ListUsable( + google::cloud::cpp::compute::backend_buckets::v1::ListUsableRequest + request) { + auto span = internal::MakeSpan( + "compute_backend_buckets_v1::BackendBucketsConnection::ListUsable"); + internal::OTelScope scope(span); + auto sr = child_->ListUsable(std::move(request)); + return internal::MakeTracedStreamRange< + google::cloud::cpp::compute::v1::BackendBucket>(std::move(span), + std::move(sr)); +} + future> BackendBucketsTracingConnection::PatchBackendBucket( google::cloud::cpp::compute::backend_buckets::v1:: diff --git a/google/cloud/compute/backend_buckets/v1/internal/backend_buckets_tracing_connection.h b/google/cloud/compute/backend_buckets/v1/internal/backend_buckets_tracing_connection.h index e74d0931b01e1..037799f100f78 100644 --- a/google/cloud/compute/backend_buckets/v1/internal/backend_buckets_tracing_connection.h +++ b/google/cloud/compute/backend_buckets/v1/internal/backend_buckets_tracing_connection.h @@ -50,6 +50,12 @@ class BackendBucketsTracingConnection future> AddSignedUrlKey( google::cloud::cpp::compute::v1::Operation const& operation) override; + StreamRange> + AggregatedListBackendBuckets( + google::cloud::cpp::compute::backend_buckets::v1:: + AggregatedListBackendBucketsRequest request) override; + future> DeleteBackendBucket(google::cloud::cpp::compute::backend_buckets::v1:: DeleteBackendBucketRequest const& request) override; @@ -98,6 +104,10 @@ class BackendBucketsTracingConnection ListBackendBuckets(google::cloud::cpp::compute::backend_buckets::v1:: ListBackendBucketsRequest request) override; + StreamRange ListUsable( + google::cloud::cpp::compute::backend_buckets::v1::ListUsableRequest + request) override; + future> PatchBackendBucket(google::cloud::cpp::compute::backend_buckets::v1:: PatchBackendBucketRequest const& request) override; diff --git a/google/cloud/compute/backend_buckets/v1/mocks/mock_backend_buckets_connection.h b/google/cloud/compute/backend_buckets/v1/mocks/mock_backend_buckets_connection.h index d6886f787bb43..199cca36f61af 100644 --- a/google/cloud/compute/backend_buckets/v1/mocks/mock_backend_buckets_connection.h +++ b/google/cloud/compute/backend_buckets/v1/mocks/mock_backend_buckets_connection.h @@ -88,6 +88,14 @@ class MockBackendBucketsConnection (google::cloud::cpp::compute::v1::Operation const& operation), (override)); + MOCK_METHOD( + (StreamRange>), + AggregatedListBackendBuckets, + (google::cloud::cpp::compute::backend_buckets::v1:: + AggregatedListBackendBucketsRequest request), + (override)); + /// To disambiguate calls, use: /// /// @code @@ -228,6 +236,12 @@ class MockBackendBucketsConnection ListBackendBucketsRequest request), (override)); + MOCK_METHOD( + (StreamRange), ListUsable, + (google::cloud::cpp::compute::backend_buckets::v1::ListUsableRequest + request), + (override)); + /// To disambiguate calls, use: /// /// @code diff --git a/google/cloud/compute/backend_services/v1/backend_services_client.cc b/google/cloud/compute/backend_services/v1/backend_services_client.cc index 13885788cdea2..47556fc84cfd4 100644 --- a/google/cloud/compute/backend_services/v1/backend_services_client.cc +++ b/google/cloud/compute/backend_services/v1/backend_services_client.cc @@ -236,6 +236,25 @@ BackendServicesClient::GetBackendService( return connection_->GetBackendService(request); } +Status BackendServicesClient::GetEffectiveSecurityPolicies( + std::string const& project, std::string const& backend_service, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::backend_services::v1:: + GetEffectiveSecurityPoliciesRequest request; + request.set_project(project); + request.set_backend_service(backend_service); + return connection_->GetEffectiveSecurityPolicies(request); +} + +Status BackendServicesClient::GetEffectiveSecurityPolicies( + google::cloud::cpp::compute::backend_services::v1:: + GetEffectiveSecurityPoliciesRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->GetEffectiveSecurityPolicies(request); +} + StatusOr BackendServicesClient::GetHealth( std::string const& project, std::string const& backend_service, 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 9499b66b71f2b..04adf40031af7 100644 --- a/google/cloud/compute/backend_services/v1/backend_services_client.h +++ b/google/cloud/compute/backend_services/v1/backend_services_client.h @@ -118,7 +118,7 @@ class BackendServicesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.backend_services.v1.AddSignedUrlKeyRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_services/v1/backend_services.proto#L250} + /// [google.cloud.cpp.compute.backend_services.v1.AddSignedUrlKeyRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_services/v1/backend_services.proto#L274} /// // clang-format on future> AddSignedUrlKey( @@ -177,7 +177,7 @@ class BackendServicesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.backend_services.v1.AddSignedUrlKeyRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_services/v1/backend_services.proto#L250} + /// [google.cloud.cpp.compute.backend_services.v1.AddSignedUrlKeyRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_services/v1/backend_services.proto#L274} /// // clang-format on future> AddSignedUrlKey( @@ -218,8 +218,10 @@ class BackendServicesClient { // clang-format off /// /// 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`. + /// available to the specified project. + /// + /// To prevent failure, it is recommended that you set the + /// `returnPartialSuccess` parameter to `true`. /// https://cloud.google.com/compute/docs/reference/rest/v1/backendServices/aggregatedList /// /// @param project Name of the project scoping this request. @@ -245,8 +247,8 @@ class BackendServicesClient { /// [`future`]: @ref google::cloud::future /// [`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_011.proto#L137} + /// [google.cloud.cpp.compute.backend_services.v1.AggregatedListBackendServicesRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_services/v1/backend_services.proto#L308} + /// [google.cloud.cpp.compute.v1.BackendServicesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_014.proto#L158} /// // clang-format on StreamRange> @@ -379,7 +383,7 @@ class BackendServicesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.backend_services.v1.DeleteBackendServiceRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_services/v1/backend_services.proto#L363} + /// [google.cloud.cpp.compute.backend_services.v1.DeleteBackendServiceRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_services/v1/backend_services.proto#L423} /// // clang-format on future> @@ -448,7 +452,7 @@ class BackendServicesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.backend_services.v1.DeleteSignedUrlKeyRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_services/v1/backend_services.proto#L389} + /// [google.cloud.cpp.compute.backend_services.v1.DeleteSignedUrlKeyRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_services/v1/backend_services.proto#L452} /// // clang-format on future> @@ -504,7 +508,7 @@ class BackendServicesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.backend_services.v1.DeleteSignedUrlKeyRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_services/v1/backend_services.proto#L389} + /// [google.cloud.cpp.compute.backend_services.v1.DeleteSignedUrlKeyRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_services/v1/backend_services.proto#L452} /// // clang-format on future> @@ -563,8 +567,8 @@ class BackendServicesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.backend_services.v1.GetBackendServiceRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_services/v1/backend_services.proto#L420} - /// [google.cloud.cpp.compute.v1.BackendService]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_000.proto#L187} + /// [google.cloud.cpp.compute.backend_services.v1.GetBackendServiceRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_services/v1/backend_services.proto#L486} + /// [google.cloud.cpp.compute.v1.BackendService]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_000.proto#L282} /// // clang-format on StatusOr GetBackendService( @@ -595,8 +599,8 @@ class BackendServicesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.backend_services.v1.GetBackendServiceRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_services/v1/backend_services.proto#L420} - /// [google.cloud.cpp.compute.v1.BackendService]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_000.proto#L187} + /// [google.cloud.cpp.compute.backend_services.v1.GetBackendServiceRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_services/v1/backend_services.proto#L486} + /// [google.cloud.cpp.compute.v1.BackendService]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_000.proto#L282} /// // clang-format on StatusOr GetBackendService( @@ -606,9 +610,69 @@ class BackendServicesClient { // clang-format off /// - /// Gets the most recent health check results for this BackendService. Example - /// request body: { "group": - /// "/zones/us-east1-b/instanceGroups/lb-backend-example" } + /// Returns effective security policies applied to this backend service. + /// https://cloud.google.com/compute/docs/reference/rest/v1/backendServices/getEffectiveSecurityPolicies + /// + /// @param project Project ID for this request. + /// @param backend_service Name of the Backend Service for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return a [`Status`] object. If the request failed, the + /// status contains the details of the failure. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.backend_services.v1.GetEffectiveSecurityPoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_services/v1/backend_services.proto#L497} + /// + // clang-format on + Status GetEffectiveSecurityPolicies(std::string const& project, + std::string const& backend_service, + Options opts = {}); + + // clang-format off + /// + /// Returns effective security policies applied to this backend service. + /// https://cloud.google.com/compute/docs/reference/rest/v1/backendServices/getEffectiveSecurityPolicies + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.backend_services.v1.GetEffectiveSecurityPoliciesRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return a [`Status`] object. If the request failed, the + /// status contains the details of the failure. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.backend_services.v1.GetEffectiveSecurityPoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_services/v1/backend_services.proto#L497} + /// + // clang-format on + Status GetEffectiveSecurityPolicies( + google::cloud::cpp::compute::backend_services::v1:: + GetEffectiveSecurityPoliciesRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// Gets the most recent health check results for this + /// BackendService. + /// + /// Example request body: + /// + /// { + /// "group": "/zones/us-east1-b/instanceGroups/lb-backend-example" + /// } /// https://cloud.google.com/compute/docs/reference/rest/v1/backendServices/getHealth /// /// @param project @@ -627,8 +691,8 @@ class BackendServicesClient { /// [`future`]: @ref google::cloud::future /// [`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#L930} + /// [google.cloud.cpp.compute.backend_services.v1.GetHealthRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_services/v1/backend_services.proto#L508} + /// [google.cloud.cpp.compute.v1.BackendServiceGroupHealth]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_000.proto#L1272} /// // clang-format on StatusOr @@ -639,9 +703,14 @@ class BackendServicesClient { // clang-format off /// - /// Gets the most recent health check results for this BackendService. Example - /// request body: { "group": - /// "/zones/us-east1-b/instanceGroups/lb-backend-example" } + /// Gets the most recent health check results for this + /// BackendService. + /// + /// Example request body: + /// + /// { + /// "group": "/zones/us-east1-b/instanceGroups/lb-backend-example" + /// } /// https://cloud.google.com/compute/docs/reference/rest/v1/backendServices/getHealth /// /// @param request Unary RPCs, such as the one wrapped by this @@ -663,8 +732,8 @@ class BackendServicesClient { /// [`future`]: @ref google::cloud::future /// [`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#L930} + /// [google.cloud.cpp.compute.backend_services.v1.GetHealthRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_services/v1/backend_services.proto#L508} + /// [google.cloud.cpp.compute.v1.BackendServiceGroupHealth]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_000.proto#L1272} /// // clang-format on StatusOr @@ -694,8 +763,8 @@ class BackendServicesClient { /// [`future`]: @ref google::cloud::future /// [`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_007.proto#L178} + /// [google.cloud.cpp.compute.backend_services.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_services/v1/backend_services.proto#L522} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr GetIamPolicy( @@ -727,8 +796,8 @@ class BackendServicesClient { /// [`future`]: @ref google::cloud::future /// [`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_007.proto#L178} + /// [google.cloud.cpp.compute.backend_services.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_services/v1/backend_services.proto#L522} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr GetIamPolicy( @@ -738,9 +807,9 @@ class BackendServicesClient { // clang-format off /// - /// Creates a BackendService resource in the specified project using the data - /// included in the request. For more information, see Backend services - /// overview . + /// Creates a BackendService resource in the specified project using + /// the data included in the request. For more information, see + /// Backend services overview. /// https://cloud.google.com/compute/docs/reference/rest/v1/backendServices/insert /// /// @param project Project ID for this request. @@ -765,7 +834,7 @@ class BackendServicesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.backend_services.v1.InsertBackendServiceRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_services/v1/backend_services.proto#L460} + /// [google.cloud.cpp.compute.backend_services.v1.InsertBackendServiceRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_services/v1/backend_services.proto#L537} /// // clang-format on future> @@ -793,9 +862,9 @@ class BackendServicesClient { // clang-format off /// - /// Creates a BackendService resource in the specified project using the data - /// included in the request. For more information, see Backend services - /// overview . + /// Creates a BackendService resource in the specified project using + /// the data included in the request. For more information, see + /// Backend services overview. /// https://cloud.google.com/compute/docs/reference/rest/v1/backendServices/insert /// /// @param request Unary RPCs, such as the one wrapped by this @@ -824,7 +893,7 @@ class BackendServicesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.backend_services.v1.InsertBackendServiceRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_services/v1/backend_services.proto#L460} + /// [google.cloud.cpp.compute.backend_services.v1.InsertBackendServiceRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_services/v1/backend_services.proto#L537} /// // clang-format on future> @@ -892,8 +961,8 @@ class BackendServicesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.backend_services.v1.ListBackendServicesRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_services/v1/backend_services.proto#L486} - /// [google.cloud.cpp.compute.v1.BackendService]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_000.proto#L187} + /// [google.cloud.cpp.compute.backend_services.v1.ListBackendServicesRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_services/v1/backend_services.proto#L566} + /// [google.cloud.cpp.compute.v1.BackendService]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_000.proto#L282} /// // clang-format on StreamRange @@ -933,8 +1002,8 @@ class BackendServicesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.backend_services.v1.ListBackendServicesRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_services/v1/backend_services.proto#L486} - /// [google.cloud.cpp.compute.v1.BackendService]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_000.proto#L187} + /// [google.cloud.cpp.compute.backend_services.v1.ListBackendServicesRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_services/v1/backend_services.proto#L566} + /// [google.cloud.cpp.compute.v1.BackendService]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_000.proto#L282} /// // clang-format on StreamRange @@ -944,7 +1013,10 @@ class BackendServicesClient { // clang-format off /// - /// Retrieves a list of all usable backend services in the specified project. + /// Retrieves a list of all usable backend services for Application Load + /// Balancers and Proxy Network Load Balancers in the specified project. + /// Backend services for external and internal passthrough Network Load + /// Balancers are not included in the response. /// https://cloud.google.com/compute/docs/reference/rest/v1/backendServices/listUsable /// /// @param project Project ID for this request. @@ -970,8 +1042,8 @@ class BackendServicesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.backend_services.v1.ListUsableRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_services/v1/backend_services.proto#L554} - /// [google.cloud.cpp.compute.v1.BackendService]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_000.proto#L187} + /// [google.cloud.cpp.compute.backend_services.v1.ListUsableRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_services/v1/backend_services.proto#L667} + /// [google.cloud.cpp.compute.v1.BackendService]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_000.proto#L282} /// // clang-format on StreamRange ListUsable( @@ -979,7 +1051,10 @@ class BackendServicesClient { // clang-format off /// - /// Retrieves a list of all usable backend services in the specified project. + /// Retrieves a list of all usable backend services for Application Load + /// Balancers and Proxy Network Load Balancers in the specified project. + /// Backend services for external and internal passthrough Network Load + /// Balancers are not included in the response. /// https://cloud.google.com/compute/docs/reference/rest/v1/backendServices/listUsable /// /// @param request Unary RPCs, such as the one wrapped by this @@ -1010,8 +1085,8 @@ class BackendServicesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.backend_services.v1.ListUsableRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_services/v1/backend_services.proto#L554} - /// [google.cloud.cpp.compute.v1.BackendService]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_000.proto#L187} + /// [google.cloud.cpp.compute.backend_services.v1.ListUsableRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_services/v1/backend_services.proto#L667} + /// [google.cloud.cpp.compute.v1.BackendService]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_000.proto#L282} /// // clang-format on StreamRange ListUsable( @@ -1022,9 +1097,10 @@ class BackendServicesClient { // clang-format off /// /// 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. + /// request. For more information, see + /// Backend services overview. This method + /// supports PATCH semantics and uses the JSON merge + /// patch format and processing rules. /// https://cloud.google.com/compute/docs/reference/rest/v1/backendServices/patch /// /// @param project Project ID for this request. @@ -1050,7 +1126,7 @@ class BackendServicesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.backend_services.v1.PatchBackendServiceRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_services/v1/backend_services.proto#L622} + /// [google.cloud.cpp.compute.backend_services.v1.PatchBackendServiceRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_services/v1/backend_services.proto#L768} /// // clang-format on future> @@ -1081,9 +1157,10 @@ class BackendServicesClient { // clang-format off /// /// 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. + /// request. For more information, see + /// Backend services overview. This method + /// supports PATCH semantics and uses the JSON merge + /// patch format and processing rules. /// https://cloud.google.com/compute/docs/reference/rest/v1/backendServices/patch /// /// @param request Unary RPCs, such as the one wrapped by this @@ -1112,7 +1189,7 @@ class BackendServicesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.backend_services.v1.PatchBackendServiceRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_services/v1/backend_services.proto#L622} + /// [google.cloud.cpp.compute.backend_services.v1.PatchBackendServiceRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_services/v1/backend_services.proto#L768} /// // clang-format on future> @@ -1180,7 +1257,7 @@ class BackendServicesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.backend_services.v1.SetEdgeSecurityPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_services/v1/backend_services.proto#L652} + /// [google.cloud.cpp.compute.backend_services.v1.SetEdgeSecurityPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_services/v1/backend_services.proto#L801} /// // clang-format on future> @@ -1239,7 +1316,7 @@ class BackendServicesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.backend_services.v1.SetEdgeSecurityPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_services/v1/backend_services.proto#L652} + /// [google.cloud.cpp.compute.backend_services.v1.SetEdgeSecurityPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_services/v1/backend_services.proto#L801} /// // clang-format on future> @@ -1280,8 +1357,8 @@ class BackendServicesClient { // clang-format off /// - /// Sets the access control policy on the specified resource. Replaces any - /// existing policy. + /// Sets the access control policy on the specified resource. + /// Replaces any existing policy. /// https://cloud.google.com/compute/docs/reference/rest/v1/backendServices/setIamPolicy /// /// @param project Project ID for this request. @@ -1300,8 +1377,8 @@ class BackendServicesClient { /// [`future`]: @ref google::cloud::future /// [`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_007.proto#L178} + /// [google.cloud.cpp.compute.backend_services.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_services/v1/backend_services.proto#L836} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr SetIamPolicy( @@ -1312,8 +1389,8 @@ class BackendServicesClient { // clang-format off /// - /// Sets the access control policy on the specified resource. Replaces any - /// existing policy. + /// Sets the access control policy on the specified resource. + /// Replaces any existing policy. /// https://cloud.google.com/compute/docs/reference/rest/v1/backendServices/setIamPolicy /// /// @param request Unary RPCs, such as the one wrapped by this @@ -1335,8 +1412,8 @@ class BackendServicesClient { /// [`future`]: @ref google::cloud::future /// [`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_007.proto#L178} + /// [google.cloud.cpp.compute.backend_services.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_services/v1/backend_services.proto#L836} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr SetIamPolicy( @@ -1347,7 +1424,8 @@ class BackendServicesClient { // clang-format off /// /// Sets the Google Cloud Armor security policy for the specified backend - /// service. For more information, see Google Cloud Armor Overview + /// service. For more information, seeGoogle + /// Cloud Armor Overview /// https://cloud.google.com/compute/docs/reference/rest/v1/backendServices/setSecurityPolicy /// /// @param project Project ID for this request. @@ -1374,7 +1452,7 @@ class BackendServicesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.backend_services.v1.SetSecurityPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_services/v1/backend_services.proto#L700} + /// [google.cloud.cpp.compute.backend_services.v1.SetSecurityPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_services/v1/backend_services.proto#L852} /// // clang-format on future> @@ -1405,7 +1483,8 @@ class BackendServicesClient { // clang-format off /// /// Sets the Google Cloud Armor security policy for the specified backend - /// service. For more information, see Google Cloud Armor Overview + /// service. For more information, seeGoogle + /// Cloud Armor Overview /// https://cloud.google.com/compute/docs/reference/rest/v1/backendServices/setSecurityPolicy /// /// @param request Unary RPCs, such as the one wrapped by this @@ -1434,7 +1513,7 @@ class BackendServicesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.backend_services.v1.SetSecurityPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_services/v1/backend_services.proto#L700} + /// [google.cloud.cpp.compute.backend_services.v1.SetSecurityPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_services/v1/backend_services.proto#L852} /// // clang-format on future> @@ -1493,8 +1572,8 @@ class BackendServicesClient { /// [`future`]: @ref google::cloud::future /// [`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_145.proto#L30} + /// [google.cloud.cpp.compute.backend_services.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_services/v1/backend_services.proto#L887} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} /// // clang-format on StatusOr @@ -1528,8 +1607,8 @@ class BackendServicesClient { /// [`future`]: @ref google::cloud::future /// [`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_145.proto#L30} + /// [google.cloud.cpp.compute.backend_services.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_services/v1/backend_services.proto#L887} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} /// // clang-format on StatusOr @@ -1540,7 +1619,8 @@ class BackendServicesClient { // clang-format off /// /// Updates the specified BackendService resource with the data included in the - /// request. For more information, see Backend services overview. + /// request. For more information, seeBackend + /// services overview. /// https://cloud.google.com/compute/docs/reference/rest/v1/backendServices/update /// /// @param project Project ID for this request. @@ -1566,7 +1646,7 @@ class BackendServicesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.backend_services.v1.UpdateBackendServiceRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_services/v1/backend_services.proto#L747} + /// [google.cloud.cpp.compute.backend_services.v1.UpdateBackendServiceRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_services/v1/backend_services.proto#L902} /// // clang-format on future> @@ -1597,7 +1677,8 @@ class BackendServicesClient { // clang-format off /// /// Updates the specified BackendService resource with the data included in the - /// request. For more information, see Backend services overview. + /// request. For more information, seeBackend + /// services overview. /// https://cloud.google.com/compute/docs/reference/rest/v1/backendServices/update /// /// @param request Unary RPCs, such as the one wrapped by this @@ -1626,7 +1707,7 @@ class BackendServicesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.backend_services.v1.UpdateBackendServiceRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_services/v1/backend_services.proto#L747} + /// [google.cloud.cpp.compute.backend_services.v1.UpdateBackendServiceRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_services/v1/backend_services.proto#L902} /// // clang-format on future> diff --git a/google/cloud/compute/backend_services/v1/backend_services_connection.cc b/google/cloud/compute/backend_services/v1/backend_services_connection.cc index f7d8212330144..87830dcd2dd9a 100644 --- a/google/cloud/compute/backend_services/v1/backend_services_connection.cc +++ b/google/cloud/compute/backend_services/v1/backend_services_connection.cc @@ -128,6 +128,12 @@ BackendServicesConnection::GetBackendService( return Status(StatusCode::kUnimplemented, "not implemented"); } +Status BackendServicesConnection::GetEffectiveSecurityPolicies( + google::cloud::cpp::compute::backend_services::v1:: + GetEffectiveSecurityPoliciesRequest const&) { + return Status(StatusCode::kUnimplemented, "not implemented"); +} + StatusOr BackendServicesConnection::GetHealth( google::cloud::cpp::compute::backend_services::v1:: diff --git a/google/cloud/compute/backend_services/v1/backend_services_connection.h b/google/cloud/compute/backend_services/v1/backend_services_connection.h index 734e2a613b550..cbdf537088b61 100644 --- a/google/cloud/compute/backend_services/v1/backend_services_connection.h +++ b/google/cloud/compute/backend_services/v1/backend_services_connection.h @@ -234,6 +234,10 @@ class BackendServicesConnection { GetBackendService(google::cloud::cpp::compute::backend_services::v1:: GetBackendServiceRequest const& request); + virtual Status GetEffectiveSecurityPolicies( + google::cloud::cpp::compute::backend_services::v1:: + GetEffectiveSecurityPoliciesRequest const& request); + virtual StatusOr GetHealth( google::cloud::cpp::compute::backend_services::v1::GetHealthRequest const& diff --git a/google/cloud/compute/backend_services/v1/backend_services_connection_idempotency_policy.cc b/google/cloud/compute/backend_services/v1/backend_services_connection_idempotency_policy.cc index 987f9c7412b0a..b522a135d2c71 100644 --- a/google/cloud/compute/backend_services/v1/backend_services_connection_idempotency_policy.cc +++ b/google/cloud/compute/backend_services/v1/backend_services_connection_idempotency_policy.cc @@ -65,6 +65,13 @@ Idempotency BackendServicesConnectionIdempotencyPolicy::GetBackendService( return Idempotency::kIdempotent; } +Idempotency +BackendServicesConnectionIdempotencyPolicy::GetEffectiveSecurityPolicies( + google::cloud::cpp::compute::backend_services::v1:: + GetEffectiveSecurityPoliciesRequest const&) { + return Idempotency::kIdempotent; +} + Idempotency BackendServicesConnectionIdempotencyPolicy::GetHealth( google::cloud::cpp::compute::backend_services::v1:: GetHealthRequest const&) { diff --git a/google/cloud/compute/backend_services/v1/backend_services_connection_idempotency_policy.h b/google/cloud/compute/backend_services/v1/backend_services_connection_idempotency_policy.h index dbac8ebc9db2c..1ca6cddf195ad 100644 --- a/google/cloud/compute/backend_services/v1/backend_services_connection_idempotency_policy.h +++ b/google/cloud/compute/backend_services/v1/backend_services_connection_idempotency_policy.h @@ -57,6 +57,10 @@ class BackendServicesConnectionIdempotencyPolicy { google::cloud::cpp::compute::backend_services::v1:: GetBackendServiceRequest const& request); + virtual google::cloud::Idempotency GetEffectiveSecurityPolicies( + google::cloud::cpp::compute::backend_services::v1:: + GetEffectiveSecurityPoliciesRequest const& request); + virtual google::cloud::Idempotency GetHealth( google::cloud::cpp::compute::backend_services::v1::GetHealthRequest const& request); 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 e6336f1942e21..8a84f5b199380 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 "google/cloud/compute/v1/internal/common_000.pb.h" -#include "google/cloud/compute/v1/internal/common_007.pb.h" -#include "google/cloud/compute/v1/internal/common_011.pb.h" -#include "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_029.pb.h" -#include "google/cloud/compute/v1/internal/common_031.pb.h" -#include "google/cloud/compute/v1/internal/common_047.pb.h" -#include "google/cloud/compute/v1/internal/common_052.pb.h" -#include "google/cloud/compute/v1/internal/common_118.pb.h" -#include "google/cloud/compute/v1/internal/common_121.pb.h" +#include "google/cloud/compute/v1/internal/common_009.pb.h" +#include "google/cloud/compute/v1/internal/common_014.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_038.pb.h" +#include "google/cloud/compute/v1/internal/common_040.pb.h" +#include "google/cloud/compute/v1/internal/common_057.pb.h" +#include "google/cloud/compute/v1/internal/common_065.pb.h" +#include "google/cloud/compute/v1/internal/common_142.pb.h" #include "google/cloud/compute/v1/internal/common_145.pb.h" +#include "google/cloud/compute/v1/internal/common_171.pb.h" // 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/backend_services/v1/internal/backend_services_rest_connection_impl.cc b/google/cloud/compute/backend_services/v1/internal/backend_services_rest_connection_impl.cc index f635a56095a97..702a8d89f7f6e 100644 --- a/google/cloud/compute/backend_services/v1/internal/backend_services_rest_connection_impl.cc +++ b/google/cloud/compute/backend_services/v1/internal/backend_services_rest_connection_impl.cc @@ -485,6 +485,22 @@ BackendServicesRestConnectionImpl::GetBackendService( *current, request, __func__); } +Status BackendServicesRestConnectionImpl::GetEffectiveSecurityPolicies( + google::cloud::cpp::compute::backend_services::v1:: + GetEffectiveSecurityPoliciesRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->GetEffectiveSecurityPolicies(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::backend_services::v1:: + GetEffectiveSecurityPoliciesRequest const& request) { + return stub_->GetEffectiveSecurityPolicies(rest_context, options, + request); + }, + *current, request, __func__); +} + StatusOr BackendServicesRestConnectionImpl::GetHealth( google::cloud::cpp::compute::backend_services::v1::GetHealthRequest const& diff --git a/google/cloud/compute/backend_services/v1/internal/backend_services_rest_connection_impl.h b/google/cloud/compute/backend_services/v1/internal/backend_services_rest_connection_impl.h index c24e2e3dae62d..05ee3d48a0cb2 100644 --- a/google/cloud/compute/backend_services/v1/internal/backend_services_rest_connection_impl.h +++ b/google/cloud/compute/backend_services/v1/internal/backend_services_rest_connection_impl.h @@ -97,6 +97,10 @@ class BackendServicesRestConnectionImpl google::cloud::cpp::compute::backend_services::v1:: GetBackendServiceRequest const& request) override; + Status GetEffectiveSecurityPolicies( + google::cloud::cpp::compute::backend_services::v1:: + GetEffectiveSecurityPoliciesRequest const& request) override; + StatusOr GetHealth( google::cloud::cpp::compute::backend_services::v1::GetHealthRequest const& diff --git a/google/cloud/compute/backend_services/v1/internal/backend_services_rest_logging_decorator.cc b/google/cloud/compute/backend_services/v1/internal/backend_services_rest_logging_decorator.cc index 5d07e224f1b53..8255efac65b9c 100644 --- a/google/cloud/compute/backend_services/v1/internal/backend_services_rest_logging_decorator.cc +++ b/google/cloud/compute/backend_services/v1/internal/backend_services_rest_logging_decorator.cc @@ -165,6 +165,20 @@ BackendServicesRestLogging::GetBackendService( rest_context, options, request, __func__, tracing_options_); } +Status BackendServicesRestLogging::GetEffectiveSecurityPolicies( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::backend_services::v1:: + GetEffectiveSecurityPoliciesRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::backend_services::v1:: + GetEffectiveSecurityPoliciesRequest const& request) { + return child_->GetEffectiveSecurityPolicies(rest_context, options, + request); + }, + rest_context, options, request, __func__, tracing_options_); +} + StatusOr BackendServicesRestLogging::GetHealth( rest_internal::RestContext& rest_context, Options const& options, diff --git a/google/cloud/compute/backend_services/v1/internal/backend_services_rest_logging_decorator.h b/google/cloud/compute/backend_services/v1/internal/backend_services_rest_logging_decorator.h index 92471d616240b..e53bb5574b0ad 100644 --- a/google/cloud/compute/backend_services/v1/internal/backend_services_rest_logging_decorator.h +++ b/google/cloud/compute/backend_services/v1/internal/backend_services_rest_logging_decorator.h @@ -97,6 +97,12 @@ class BackendServicesRestLogging : public BackendServicesRestStub { google::cloud::cpp::compute::backend_services::v1:: GetBackendServiceRequest const& request) override; + Status GetEffectiveSecurityPolicies( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::backend_services::v1:: + GetEffectiveSecurityPoliciesRequest const& request) override; + StatusOr GetHealth( google::cloud::rest_internal::RestContext& rest_context, diff --git a/google/cloud/compute/backend_services/v1/internal/backend_services_rest_metadata_decorator.cc b/google/cloud/compute/backend_services/v1/internal/backend_services_rest_metadata_decorator.cc index cd3e8bbb8a069..51aefd105bd55 100644 --- a/google/cloud/compute/backend_services/v1/internal/backend_services_rest_metadata_decorator.cc +++ b/google/cloud/compute/backend_services/v1/internal/backend_services_rest_metadata_decorator.cc @@ -120,6 +120,14 @@ BackendServicesRestMetadata::GetBackendService( return child_->GetBackendService(rest_context, options, request); } +Status BackendServicesRestMetadata::GetEffectiveSecurityPolicies( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::backend_services::v1:: + GetEffectiveSecurityPoliciesRequest const& request) { + SetMetadata(rest_context, options); + return child_->GetEffectiveSecurityPolicies(rest_context, options, request); +} + StatusOr BackendServicesRestMetadata::GetHealth( rest_internal::RestContext& rest_context, Options const& options, diff --git a/google/cloud/compute/backend_services/v1/internal/backend_services_rest_metadata_decorator.h b/google/cloud/compute/backend_services/v1/internal/backend_services_rest_metadata_decorator.h index cc6816c86b0a9..c73134a9f59fa 100644 --- a/google/cloud/compute/backend_services/v1/internal/backend_services_rest_metadata_decorator.h +++ b/google/cloud/compute/backend_services/v1/internal/backend_services_rest_metadata_decorator.h @@ -95,6 +95,12 @@ class BackendServicesRestMetadata : public BackendServicesRestStub { google::cloud::cpp::compute::backend_services::v1:: GetBackendServiceRequest const& request) override; + Status GetEffectiveSecurityPolicies( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::backend_services::v1:: + GetEffectiveSecurityPoliciesRequest const& request) override; + StatusOr GetHealth( google::cloud::rest_internal::RestContext& rest_context, diff --git a/google/cloud/compute/backend_services/v1/internal/backend_services_rest_stub.cc b/google/cloud/compute/backend_services/v1/internal/backend_services_rest_stub.cc index 63c7c257fad2d..33c90766a3dfe 100644 --- a/google/cloud/compute/backend_services/v1/internal/backend_services_rest_stub.cc +++ b/google/cloud/compute/backend_services/v1/internal/backend_services_rest_stub.cc @@ -257,6 +257,22 @@ DefaultBackendServicesRestStub::GetBackendService( std::move(query_params)); } +Status DefaultBackendServicesRestStub::GetEffectiveSecurityPolicies( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::backend_services::v1:: + GetEffectiveSecurityPoliciesRequest const& request) { + std::vector> query_params; + return rest_internal::Get( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "global", "/", + "backendServices", "/", request.backend_service(), "/", + "getEffectiveSecurityPolicies"), + std::move(query_params)); +} + StatusOr DefaultBackendServicesRestStub::GetHealth( google::cloud::rest_internal::RestContext& rest_context, diff --git a/google/cloud/compute/backend_services/v1/internal/backend_services_rest_stub.h b/google/cloud/compute/backend_services/v1/internal/backend_services_rest_stub.h index de1f44a8bebd0..a61fa0673cbfa 100644 --- a/google/cloud/compute/backend_services/v1/internal/backend_services_rest_stub.h +++ b/google/cloud/compute/backend_services/v1/internal/backend_services_rest_stub.h @@ -93,6 +93,12 @@ class BackendServicesRestStub { google::cloud::cpp::compute::backend_services::v1:: GetBackendServiceRequest const& request) = 0; + virtual Status GetEffectiveSecurityPolicies( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::backend_services::v1:: + GetEffectiveSecurityPoliciesRequest const& request) = 0; + virtual StatusOr GetHealth( google::cloud::rest_internal::RestContext& rest_context, @@ -280,6 +286,12 @@ class DefaultBackendServicesRestStub : public BackendServicesRestStub { google::cloud::cpp::compute::backend_services::v1:: GetBackendServiceRequest const& request) override; + Status GetEffectiveSecurityPolicies( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::backend_services::v1:: + GetEffectiveSecurityPoliciesRequest const& request) override; + StatusOr GetHealth( google::cloud::rest_internal::RestContext& rest_context, diff --git a/google/cloud/compute/backend_services/v1/internal/backend_services_tracing_connection.cc b/google/cloud/compute/backend_services/v1/internal/backend_services_tracing_connection.cc index dcb5076fc6566..d27b1c280f28b 100644 --- a/google/cloud/compute/backend_services/v1/internal/backend_services_tracing_connection.cc +++ b/google/cloud/compute/backend_services/v1/internal/backend_services_tracing_connection.cc @@ -161,6 +161,17 @@ BackendServicesTracingConnection::GetBackendService( return internal::EndSpan(*span, child_->GetBackendService(request)); } +Status BackendServicesTracingConnection::GetEffectiveSecurityPolicies( + google::cloud::cpp::compute::backend_services::v1:: + GetEffectiveSecurityPoliciesRequest const& request) { + auto span = internal::MakeSpan( + "compute_backend_services_v1::BackendServicesConnection::" + "GetEffectiveSecurityPolicies"); + auto scope = opentelemetry::trace::Scope(span); + return internal::EndSpan(*span, + child_->GetEffectiveSecurityPolicies(request)); +} + StatusOr BackendServicesTracingConnection::GetHealth( google::cloud::cpp::compute::backend_services::v1::GetHealthRequest const& diff --git a/google/cloud/compute/backend_services/v1/internal/backend_services_tracing_connection.h b/google/cloud/compute/backend_services/v1/internal/backend_services_tracing_connection.h index dbe1cc35cd8f0..0d71c987e1acc 100644 --- a/google/cloud/compute/backend_services/v1/internal/backend_services_tracing_connection.h +++ b/google/cloud/compute/backend_services/v1/internal/backend_services_tracing_connection.h @@ -84,6 +84,10 @@ class BackendServicesTracingConnection google::cloud::cpp::compute::backend_services::v1:: GetBackendServiceRequest const& request) override; + Status GetEffectiveSecurityPolicies( + google::cloud::cpp::compute::backend_services::v1:: + GetEffectiveSecurityPoliciesRequest const& request) override; + StatusOr GetHealth( google::cloud::cpp::compute::backend_services::v1::GetHealthRequest const& diff --git a/google/cloud/compute/backend_services/v1/mocks/mock_backend_services_connection.h b/google/cloud/compute/backend_services/v1/mocks/mock_backend_services_connection.h index 7b09990eafe59..1f4a4eb388905 100644 --- a/google/cloud/compute/backend_services/v1/mocks/mock_backend_services_connection.h +++ b/google/cloud/compute/backend_services/v1/mocks/mock_backend_services_connection.h @@ -184,6 +184,11 @@ class MockBackendServicesConnection GetBackendServiceRequest const& request), (override)); + MOCK_METHOD(Status, GetEffectiveSecurityPolicies, + (google::cloud::cpp::compute::backend_services::v1:: + GetEffectiveSecurityPoliciesRequest const& request), + (override)); + MOCK_METHOD( StatusOr, GetHealth, diff --git a/google/cloud/compute/cross_site_networks/v1/cross_site_networks_client.cc b/google/cloud/compute/cross_site_networks/v1/cross_site_networks_client.cc new file mode 100644 index 0000000000000..6080e47f302f1 --- /dev/null +++ b/google/cloud/compute/cross_site_networks/v1/cross_site_networks_client.cc @@ -0,0 +1,242 @@ +// Copyright 2026 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. +// source: google/cloud/compute/cross_site_networks/v1/cross_site_networks.proto + +#include "google/cloud/compute/cross_site_networks/v1/cross_site_networks_client.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_cross_site_networks_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +CrossSiteNetworksClient::CrossSiteNetworksClient( + std::shared_ptr connection, Options opts) + : connection_(std::move(connection)), + options_( + internal::MergeOptions(std::move(opts), connection_->options())) {} +CrossSiteNetworksClient::~CrossSiteNetworksClient() = default; + +future> +CrossSiteNetworksClient::DeleteCrossSiteNetwork( + std::string const& project, std::string const& cross_site_network, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::cross_site_networks::v1:: + DeleteCrossSiteNetworkRequest request; + request.set_project(project); + request.set_cross_site_network(cross_site_network); + return connection_->DeleteCrossSiteNetwork(request); +} + +StatusOr +CrossSiteNetworksClient::DeleteCrossSiteNetwork( + NoAwaitTag, std::string const& project, + std::string const& cross_site_network, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::cross_site_networks::v1:: + DeleteCrossSiteNetworkRequest request; + request.set_project(project); + request.set_cross_site_network(cross_site_network); + return connection_->DeleteCrossSiteNetwork(NoAwaitTag{}, request); +} + +future> +CrossSiteNetworksClient::DeleteCrossSiteNetwork( + google::cloud::cpp::compute::cross_site_networks::v1:: + DeleteCrossSiteNetworkRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->DeleteCrossSiteNetwork(request); +} + +StatusOr +CrossSiteNetworksClient::DeleteCrossSiteNetwork( + NoAwaitTag, + google::cloud::cpp::compute::cross_site_networks::v1:: + DeleteCrossSiteNetworkRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->DeleteCrossSiteNetwork(NoAwaitTag{}, request); +} + +future> +CrossSiteNetworksClient::DeleteCrossSiteNetwork( + google::cloud::cpp::compute::v1::Operation const& operation, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->DeleteCrossSiteNetwork(operation); +} + +StatusOr +CrossSiteNetworksClient::GetCrossSiteNetwork( + std::string const& project, std::string const& cross_site_network, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::cross_site_networks::v1:: + GetCrossSiteNetworkRequest request; + request.set_project(project); + request.set_cross_site_network(cross_site_network); + return connection_->GetCrossSiteNetwork(request); +} + +StatusOr +CrossSiteNetworksClient::GetCrossSiteNetwork( + google::cloud::cpp::compute::cross_site_networks::v1:: + GetCrossSiteNetworkRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->GetCrossSiteNetwork(request); +} + +future> +CrossSiteNetworksClient::InsertCrossSiteNetwork( + std::string const& project, + google::cloud::cpp::compute::v1::CrossSiteNetwork const& + cross_site_network_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::cross_site_networks::v1:: + InsertCrossSiteNetworkRequest request; + request.set_project(project); + *request.mutable_cross_site_network_resource() = cross_site_network_resource; + return connection_->InsertCrossSiteNetwork(request); +} + +StatusOr +CrossSiteNetworksClient::InsertCrossSiteNetwork( + NoAwaitTag, std::string const& project, + google::cloud::cpp::compute::v1::CrossSiteNetwork const& + cross_site_network_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::cross_site_networks::v1:: + InsertCrossSiteNetworkRequest request; + request.set_project(project); + *request.mutable_cross_site_network_resource() = cross_site_network_resource; + return connection_->InsertCrossSiteNetwork(NoAwaitTag{}, request); +} + +future> +CrossSiteNetworksClient::InsertCrossSiteNetwork( + google::cloud::cpp::compute::cross_site_networks::v1:: + InsertCrossSiteNetworkRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->InsertCrossSiteNetwork(request); +} + +StatusOr +CrossSiteNetworksClient::InsertCrossSiteNetwork( + NoAwaitTag, + google::cloud::cpp::compute::cross_site_networks::v1:: + InsertCrossSiteNetworkRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->InsertCrossSiteNetwork(NoAwaitTag{}, request); +} + +future> +CrossSiteNetworksClient::InsertCrossSiteNetwork( + google::cloud::cpp::compute::v1::Operation const& operation, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->InsertCrossSiteNetwork(operation); +} + +StreamRange +CrossSiteNetworksClient::ListCrossSiteNetworks(std::string const& project, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::cross_site_networks::v1:: + ListCrossSiteNetworksRequest request; + request.set_project(project); + return connection_->ListCrossSiteNetworks(request); +} + +StreamRange +CrossSiteNetworksClient::ListCrossSiteNetworks( + google::cloud::cpp::compute::cross_site_networks::v1:: + ListCrossSiteNetworksRequest request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->ListCrossSiteNetworks(std::move(request)); +} + +future> +CrossSiteNetworksClient::PatchCrossSiteNetwork( + std::string const& project, std::string const& cross_site_network, + std::string const& update_mask, + google::cloud::cpp::compute::v1::CrossSiteNetwork const& + cross_site_network_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::cross_site_networks::v1:: + PatchCrossSiteNetworkRequest request; + request.set_project(project); + request.set_cross_site_network(cross_site_network); + request.set_update_mask(update_mask); + *request.mutable_cross_site_network_resource() = cross_site_network_resource; + return connection_->PatchCrossSiteNetwork(request); +} + +StatusOr +CrossSiteNetworksClient::PatchCrossSiteNetwork( + NoAwaitTag, std::string const& project, + std::string const& cross_site_network, std::string const& update_mask, + google::cloud::cpp::compute::v1::CrossSiteNetwork const& + cross_site_network_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::cross_site_networks::v1:: + PatchCrossSiteNetworkRequest request; + request.set_project(project); + request.set_cross_site_network(cross_site_network); + request.set_update_mask(update_mask); + *request.mutable_cross_site_network_resource() = cross_site_network_resource; + return connection_->PatchCrossSiteNetwork(NoAwaitTag{}, request); +} + +future> +CrossSiteNetworksClient::PatchCrossSiteNetwork( + google::cloud::cpp::compute::cross_site_networks::v1:: + PatchCrossSiteNetworkRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->PatchCrossSiteNetwork(request); +} + +StatusOr +CrossSiteNetworksClient::PatchCrossSiteNetwork( + NoAwaitTag, + google::cloud::cpp::compute::cross_site_networks::v1:: + PatchCrossSiteNetworkRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->PatchCrossSiteNetwork(NoAwaitTag{}, request); +} + +future> +CrossSiteNetworksClient::PatchCrossSiteNetwork( + google::cloud::cpp::compute::v1::Operation const& operation, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->PatchCrossSiteNetwork(operation); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_cross_site_networks_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/cross_site_networks/v1/cross_site_networks_client.h b/google/cloud/compute/cross_site_networks/v1/cross_site_networks_client.h new file mode 100644 index 0000000000000..8d62aa93546fa --- /dev/null +++ b/google/cloud/compute/cross_site_networks/v1/cross_site_networks_client.h @@ -0,0 +1,619 @@ +// Copyright 2026 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. +// source: google/cloud/compute/cross_site_networks/v1/cross_site_networks.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_CROSS_SITE_NETWORKS_V1_CROSS_SITE_NETWORKS_CLIENT_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_CROSS_SITE_NETWORKS_V1_CROSS_SITE_NETWORKS_CLIENT_H + +#include "google/cloud/compute/cross_site_networks/v1/cross_site_networks_rest_connection.h" +#include "google/cloud/future.h" +#include "google/cloud/no_await_tag.h" +#include "google/cloud/options.h" +#include "google/cloud/polling_policy.h" +#include "google/cloud/status_or.h" +#include "google/cloud/version.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_cross_site_networks_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/// +/// Service for the crossSiteNetworks resource. +/// https://cloud.google.com/compute/docs/reference/rest/v1/crossSiteNetworks +/// +/// @par Equality +/// +/// Instances of this class created via copy-construction or copy-assignment +/// always compare equal. Instances created with equal +/// `std::shared_ptr<*Connection>` objects compare equal. Objects that compare +/// equal share the same underlying resources. +/// +/// @par Performance +/// +/// Creating a new instance of this class is a relatively expensive operation, +/// new objects establish new connections to the service. In contrast, +/// copy-construction, move-construction, and the corresponding assignment +/// operations are relatively efficient as the copies share all underlying +/// resources. +/// +/// @par Thread Safety +/// +/// Concurrent access to different instances of this class, even if they compare +/// equal, is guaranteed to work. Two or more threads operating on the same +/// instance of this class is not guaranteed to work. Since copy-construction +/// and move-construction is a relatively efficient operation, consider using +/// such a copy when using this class from multiple threads. +/// +class CrossSiteNetworksClient { + public: + explicit CrossSiteNetworksClient( + std::shared_ptr connection, + Options opts = {}); + ~CrossSiteNetworksClient(); + + ///@{ + /// @name Copy and move support + CrossSiteNetworksClient(CrossSiteNetworksClient const&) = default; + CrossSiteNetworksClient& operator=(CrossSiteNetworksClient const&) = default; + CrossSiteNetworksClient(CrossSiteNetworksClient&&) = default; + CrossSiteNetworksClient& operator=(CrossSiteNetworksClient&&) = default; + ///@} + + ///@{ + /// @name Equality + friend bool operator==(CrossSiteNetworksClient const& a, + CrossSiteNetworksClient const& b) { + return a.connection_ == b.connection_; + } + friend bool operator!=(CrossSiteNetworksClient const& a, + CrossSiteNetworksClient const& b) { + return !(a == b); + } + ///@} + + // clang-format off + /// + /// Deletes the specified cross-site network in the given scope. + /// https://cloud.google.com/compute/docs/reference/rest/v1/crossSiteNetworks/delete + /// + /// @param project Project ID for this request. + /// @param cross_site_network Name of the cross-site network to delete. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.cross_site_networks.v1.DeleteCrossSiteNetworkRequest]: @cloud_cpp_reference_link{google/cloud/compute/cross_site_networks/v1/cross_site_networks.proto#L103} + /// + // clang-format on + future> + DeleteCrossSiteNetwork(std::string const& project, + std::string const& cross_site_network, + Options opts = {}); + + // clang-format off + /// + /// @copybrief DeleteCrossSiteNetwork + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr DeleteCrossSiteNetwork( + NoAwaitTag, std::string const& project, + std::string const& cross_site_network, Options opts = {}); + + // clang-format off + /// + /// Deletes the specified cross-site network in the given scope. + /// https://cloud.google.com/compute/docs/reference/rest/v1/crossSiteNetworks/delete + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.cross_site_networks.v1.DeleteCrossSiteNetworkRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.cross_site_networks.v1.DeleteCrossSiteNetworkRequest]: @cloud_cpp_reference_link{google/cloud/compute/cross_site_networks/v1/cross_site_networks.proto#L103} + /// + // clang-format on + future> + DeleteCrossSiteNetwork(google::cloud::cpp::compute::cross_site_networks::v1:: + DeleteCrossSiteNetworkRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief DeleteCrossSiteNetwork + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr DeleteCrossSiteNetwork( + NoAwaitTag, + google::cloud::cpp::compute::cross_site_networks::v1:: + DeleteCrossSiteNetworkRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief DeleteCrossSiteNetwork + /// + /// This method accepts a `google::cloud::cpp::compute::v1::Operation` that corresponds + /// to a previously started Long Running Operation (LRO) and polls the status + /// of the LRO in the background. + /// + // clang-format on + future> + DeleteCrossSiteNetwork( + google::cloud::cpp::compute::v1::Operation const& operation, + Options opts = {}); + + // clang-format off + /// + /// Returns the specified cross-site network in the given scope. + /// https://cloud.google.com/compute/docs/reference/rest/v1/crossSiteNetworks/get + /// + /// @param project Project ID for this request. + /// @param cross_site_network Name of the cross-site network to return. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.CrossSiteNetwork]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.cross_site_networks.v1.GetCrossSiteNetworkRequest]: @cloud_cpp_reference_link{google/cloud/compute/cross_site_networks/v1/cross_site_networks.proto#L133} + /// [google.cloud.cpp.compute.v1.CrossSiteNetwork]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_027.proto#L28} + /// + // clang-format on + StatusOr + GetCrossSiteNetwork(std::string const& project, + std::string const& cross_site_network, Options opts = {}); + + // clang-format off + /// + /// Returns the specified cross-site network in the given scope. + /// https://cloud.google.com/compute/docs/reference/rest/v1/crossSiteNetworks/get + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.cross_site_networks.v1.GetCrossSiteNetworkRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.CrossSiteNetwork]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.cross_site_networks.v1.GetCrossSiteNetworkRequest]: @cloud_cpp_reference_link{google/cloud/compute/cross_site_networks/v1/cross_site_networks.proto#L133} + /// [google.cloud.cpp.compute.v1.CrossSiteNetwork]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_027.proto#L28} + /// + // clang-format on + StatusOr + GetCrossSiteNetwork(google::cloud::cpp::compute::cross_site_networks::v1:: + GetCrossSiteNetworkRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// Creates a cross-site network in the specified project in the given scope + /// using the parameters that are included in the request. + /// https://cloud.google.com/compute/docs/reference/rest/v1/crossSiteNetworks/insert + /// + /// @param project Project ID for this request. + /// @param cross_site_network_resource The CrossSiteNetwork for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.cross_site_networks.v1.InsertCrossSiteNetworkRequest]: @cloud_cpp_reference_link{google/cloud/compute/cross_site_networks/v1/cross_site_networks.proto#L144} + /// + // clang-format on + future> + InsertCrossSiteNetwork( + std::string const& project, + google::cloud::cpp::compute::v1::CrossSiteNetwork const& + cross_site_network_resource, + Options opts = {}); + + // clang-format off + /// + /// @copybrief InsertCrossSiteNetwork + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr InsertCrossSiteNetwork( + NoAwaitTag, std::string const& project, + google::cloud::cpp::compute::v1::CrossSiteNetwork const& + cross_site_network_resource, + Options opts = {}); + + // clang-format off + /// + /// Creates a cross-site network in the specified project in the given scope + /// using the parameters that are included in the request. + /// https://cloud.google.com/compute/docs/reference/rest/v1/crossSiteNetworks/insert + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.cross_site_networks.v1.InsertCrossSiteNetworkRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.cross_site_networks.v1.InsertCrossSiteNetworkRequest]: @cloud_cpp_reference_link{google/cloud/compute/cross_site_networks/v1/cross_site_networks.proto#L144} + /// + // clang-format on + future> + InsertCrossSiteNetwork(google::cloud::cpp::compute::cross_site_networks::v1:: + InsertCrossSiteNetworkRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief InsertCrossSiteNetwork + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr InsertCrossSiteNetwork( + NoAwaitTag, + google::cloud::cpp::compute::cross_site_networks::v1:: + InsertCrossSiteNetworkRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief InsertCrossSiteNetwork + /// + /// This method accepts a `google::cloud::cpp::compute::v1::Operation` that corresponds + /// to a previously started Long Running Operation (LRO) and polls the status + /// of the LRO in the background. + /// + // clang-format on + future> + InsertCrossSiteNetwork( + google::cloud::cpp::compute::v1::Operation const& operation, + Options opts = {}); + + // clang-format off + /// + /// Lists the cross-site networks for a project in the given scope. + /// https://cloud.google.com/compute/docs/reference/rest/v1/crossSiteNetworks/list + /// + /// @param project Project ID for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return a [StreamRange](@ref google::cloud::StreamRange) + /// to iterate of the results. See the documentation of this type for + /// details. In brief, this class has `begin()` and `end()` member + /// functions returning a iterator class meeting the + /// [input iterator requirements]. The value type for this iterator is a + /// [`StatusOr`] as the iteration may fail even after some values are + /// retrieved successfully, for example, if there is a network disconnect. + /// An empty set of results does not indicate an error, it indicates + /// that there are no resources meeting the request criteria. + /// On a successful iteration the `StatusOr` contains elements of type + /// [google.cloud.cpp.compute.v1.CrossSiteNetwork], or rather, + /// the C++ class generated by Protobuf from that type. Please consult the + /// Protobuf documentation for details on the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.cross_site_networks.v1.ListCrossSiteNetworksRequest]: @cloud_cpp_reference_link{google/cloud/compute/cross_site_networks/v1/cross_site_networks.proto#L177} + /// [google.cloud.cpp.compute.v1.CrossSiteNetwork]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_027.proto#L28} + /// + // clang-format on + StreamRange + ListCrossSiteNetworks(std::string const& project, Options opts = {}); + + // clang-format off + /// + /// Lists the cross-site networks for a project in the given scope. + /// https://cloud.google.com/compute/docs/reference/rest/v1/crossSiteNetworks/list + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.cross_site_networks.v1.ListCrossSiteNetworksRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return a [StreamRange](@ref google::cloud::StreamRange) + /// to iterate of the results. See the documentation of this type for + /// details. In brief, this class has `begin()` and `end()` member + /// functions returning a iterator class meeting the + /// [input iterator requirements]. The value type for this iterator is a + /// [`StatusOr`] as the iteration may fail even after some values are + /// retrieved successfully, for example, if there is a network disconnect. + /// An empty set of results does not indicate an error, it indicates + /// that there are no resources meeting the request criteria. + /// On a successful iteration the `StatusOr` contains elements of type + /// [google.cloud.cpp.compute.v1.CrossSiteNetwork], or rather, + /// the C++ class generated by Protobuf from that type. Please consult the + /// Protobuf documentation for details on the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.cross_site_networks.v1.ListCrossSiteNetworksRequest]: @cloud_cpp_reference_link{google/cloud/compute/cross_site_networks/v1/cross_site_networks.proto#L177} + /// [google.cloud.cpp.compute.v1.CrossSiteNetwork]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_027.proto#L28} + /// + // clang-format on + StreamRange + ListCrossSiteNetworks(google::cloud::cpp::compute::cross_site_networks::v1:: + ListCrossSiteNetworksRequest request, + Options opts = {}); + + // clang-format off + /// + /// Updates the specified cross-site network with the data included in + /// the request. This method supportsPATCH + /// semantics and uses theJSON merge + /// patch format and processing rules. + /// https://cloud.google.com/compute/docs/reference/rest/v1/crossSiteNetworks/patch + /// + /// @param project Project ID for this request. + /// @param cross_site_network Name of the cross-site network to update. + /// @param update_mask update_mask indicates fields to be updated as part of this request. + /// @param cross_site_network_resource The CrossSiteNetwork for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.cross_site_networks.v1.PatchCrossSiteNetworkRequest]: @cloud_cpp_reference_link{google/cloud/compute/cross_site_networks/v1/cross_site_networks.proto#L278} + /// + // clang-format on + future> + PatchCrossSiteNetwork(std::string const& project, + std::string const& cross_site_network, + std::string const& update_mask, + google::cloud::cpp::compute::v1::CrossSiteNetwork const& + cross_site_network_resource, + Options opts = {}); + + // clang-format off + /// + /// @copybrief PatchCrossSiteNetwork + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr PatchCrossSiteNetwork( + NoAwaitTag, std::string const& project, + std::string const& cross_site_network, std::string const& update_mask, + google::cloud::cpp::compute::v1::CrossSiteNetwork const& + cross_site_network_resource, + Options opts = {}); + + // clang-format off + /// + /// Updates the specified cross-site network with the data included in + /// the request. This method supportsPATCH + /// semantics and uses theJSON merge + /// patch format and processing rules. + /// https://cloud.google.com/compute/docs/reference/rest/v1/crossSiteNetworks/patch + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.cross_site_networks.v1.PatchCrossSiteNetworkRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.cross_site_networks.v1.PatchCrossSiteNetworkRequest]: @cloud_cpp_reference_link{google/cloud/compute/cross_site_networks/v1/cross_site_networks.proto#L278} + /// + // clang-format on + future> + PatchCrossSiteNetwork(google::cloud::cpp::compute::cross_site_networks::v1:: + PatchCrossSiteNetworkRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief PatchCrossSiteNetwork + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr PatchCrossSiteNetwork( + NoAwaitTag, + google::cloud::cpp::compute::cross_site_networks::v1:: + PatchCrossSiteNetworkRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief PatchCrossSiteNetwork + /// + /// This method accepts a `google::cloud::cpp::compute::v1::Operation` that corresponds + /// to a previously started Long Running Operation (LRO) and polls the status + /// of the LRO in the background. + /// + // clang-format on + future> + PatchCrossSiteNetwork( + google::cloud::cpp::compute::v1::Operation const& operation, + Options opts = {}); + + private: + std::shared_ptr connection_; + Options options_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_cross_site_networks_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_CROSS_SITE_NETWORKS_V1_CROSS_SITE_NETWORKS_CLIENT_H diff --git a/google/cloud/compute/cross_site_networks/v1/cross_site_networks_connection.cc b/google/cloud/compute/cross_site_networks/v1/cross_site_networks_connection.cc new file mode 100644 index 0000000000000..e5b5870cf24db --- /dev/null +++ b/google/cloud/compute/cross_site_networks/v1/cross_site_networks_connection.cc @@ -0,0 +1,132 @@ +// Copyright 2026 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. +// source: google/cloud/compute/cross_site_networks/v1/cross_site_networks.proto + +#include "google/cloud/compute/cross_site_networks/v1/cross_site_networks_connection.h" +#include "google/cloud/compute/cross_site_networks/v1/cross_site_networks_options.h" +#include "google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_option_defaults.h" +#include "google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_tracing_connection.h" +#include "google/cloud/background_threads.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/grpc_options.h" +#include "google/cloud/internal/pagination_range.h" +#include "google/cloud/internal/unified_grpc_credentials.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_cross_site_networks_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +CrossSiteNetworksConnection::~CrossSiteNetworksConnection() = default; + +future> +CrossSiteNetworksConnection::DeleteCrossSiteNetwork( + google::cloud::cpp::compute::cross_site_networks::v1:: + DeleteCrossSiteNetworkRequest const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +CrossSiteNetworksConnection::DeleteCrossSiteNetwork( + NoAwaitTag, google::cloud::cpp::compute::cross_site_networks::v1:: + DeleteCrossSiteNetworkRequest const&) { + return StatusOr( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +CrossSiteNetworksConnection::DeleteCrossSiteNetwork( + google::cloud::cpp::compute::v1::Operation const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +CrossSiteNetworksConnection::GetCrossSiteNetwork( + google::cloud::cpp::compute::cross_site_networks::v1:: + GetCrossSiteNetworkRequest const&) { + return Status(StatusCode::kUnimplemented, "not implemented"); +} + +future> +CrossSiteNetworksConnection::InsertCrossSiteNetwork( + google::cloud::cpp::compute::cross_site_networks::v1:: + InsertCrossSiteNetworkRequest const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +CrossSiteNetworksConnection::InsertCrossSiteNetwork( + NoAwaitTag, google::cloud::cpp::compute::cross_site_networks::v1:: + InsertCrossSiteNetworkRequest const&) { + return StatusOr( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +CrossSiteNetworksConnection::InsertCrossSiteNetwork( + google::cloud::cpp::compute::v1::Operation const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StreamRange +CrossSiteNetworksConnection::ListCrossSiteNetworks( + google::cloud::cpp::compute::cross_site_networks::v1:: + ListCrossSiteNetworksRequest) { // NOLINT(performance-unnecessary-value-param) + return google::cloud::internal::MakeUnimplementedPaginationRange< + StreamRange>(); +} + +future> +CrossSiteNetworksConnection::PatchCrossSiteNetwork( + google::cloud::cpp::compute::cross_site_networks::v1:: + PatchCrossSiteNetworkRequest const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +CrossSiteNetworksConnection::PatchCrossSiteNetwork( + NoAwaitTag, google::cloud::cpp::compute::cross_site_networks::v1:: + PatchCrossSiteNetworkRequest const&) { + return StatusOr( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +CrossSiteNetworksConnection::PatchCrossSiteNetwork( + google::cloud::cpp::compute::v1::Operation const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_cross_site_networks_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/cross_site_networks/v1/cross_site_networks_connection.h b/google/cloud/compute/cross_site_networks/v1/cross_site_networks_connection.h new file mode 100644 index 0000000000000..367e59202757b --- /dev/null +++ b/google/cloud/compute/cross_site_networks/v1/cross_site_networks_connection.h @@ -0,0 +1,243 @@ +// Copyright 2026 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. +// source: google/cloud/compute/cross_site_networks/v1/cross_site_networks.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_CROSS_SITE_NETWORKS_V1_CROSS_SITE_NETWORKS_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_CROSS_SITE_NETWORKS_V1_CROSS_SITE_NETWORKS_CONNECTION_H + +#include "google/cloud/compute/cross_site_networks/v1/cross_site_networks.pb.h" +#include "google/cloud/compute/cross_site_networks/v1/cross_site_networks_connection_idempotency_policy.h" +#include "google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_retry_traits.h" +#include "google/cloud/backoff_policy.h" +#include "google/cloud/future.h" +#include "google/cloud/internal/retry_policy_impl.h" +#include "google/cloud/no_await_tag.h" +#include "google/cloud/options.h" +#include "google/cloud/polling_policy.h" +#include "google/cloud/status_or.h" +#include "google/cloud/stream_range.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_cross_site_networks_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/// The retry policy for `CrossSiteNetworksConnection`. +class CrossSiteNetworksRetryPolicy : public ::google::cloud::RetryPolicy { + public: + /// Creates a new instance of the policy, reset to the initial state. + virtual std::unique_ptr clone() const = 0; +}; + +/** + * A retry policy for `CrossSiteNetworksConnection` based on counting errors. + * + * This policy stops retrying if: + * - An RPC returns a non-transient error. + * - More than a prescribed number of transient failures is detected. + * + * In this class the following status codes are treated as transient errors: + * - [`kUnavailable`](@ref google::cloud::StatusCode) + */ +class CrossSiteNetworksLimitedErrorCountRetryPolicy + : public CrossSiteNetworksRetryPolicy { + public: + /** + * Create an instance that tolerates up to @p maximum_failures transient + * errors. + * + * @note Disable the retry loop by providing an instance of this policy with + * @p maximum_failures == 0. + */ + explicit CrossSiteNetworksLimitedErrorCountRetryPolicy(int maximum_failures) + : impl_(maximum_failures) {} + + CrossSiteNetworksLimitedErrorCountRetryPolicy( + CrossSiteNetworksLimitedErrorCountRetryPolicy&& rhs) noexcept + : CrossSiteNetworksLimitedErrorCountRetryPolicy(rhs.maximum_failures()) {} + CrossSiteNetworksLimitedErrorCountRetryPolicy( + CrossSiteNetworksLimitedErrorCountRetryPolicy const& rhs) noexcept + : CrossSiteNetworksLimitedErrorCountRetryPolicy(rhs.maximum_failures()) {} + + int maximum_failures() const { return impl_.maximum_failures(); } + + bool OnFailure(Status const& status) override { + return impl_.OnFailure(status); + } + bool IsExhausted() const override { return impl_.IsExhausted(); } + bool IsPermanentFailure(Status const& status) const override { + return impl_.IsPermanentFailure(status); + } + std::unique_ptr clone() const override { + return std::make_unique( + maximum_failures()); + } + + // This is provided only for backwards compatibility. + using BaseType = CrossSiteNetworksRetryPolicy; + + private: + google::cloud::internal::LimitedErrorCountRetryPolicy< + compute_cross_site_networks_v1_internal::CrossSiteNetworksRetryTraits> + impl_; +}; + +/** + * A retry policy for `CrossSiteNetworksConnection` based on elapsed time. + * + * This policy stops retrying if: + * - An RPC returns a non-transient error. + * - The elapsed time in the retry loop exceeds a prescribed duration. + * + * In this class the following status codes are treated as transient errors: + * - [`kUnavailable`](@ref google::cloud::StatusCode) + */ +class CrossSiteNetworksLimitedTimeRetryPolicy + : public CrossSiteNetworksRetryPolicy { + public: + /** + * Constructor given a `std::chrono::duration<>` object. + * + * @tparam DurationRep a placeholder to match the `Rep` tparam for @p + * duration's type. The semantics of this template parameter are + * documented in `std::chrono::duration<>`. In brief, the underlying + * arithmetic type used to store the number of ticks. For our purposes it + * is simply a formal parameter. + * @tparam DurationPeriod a placeholder to match the `Period` tparam for @p + * duration's type. The semantics of this template parameter are + * documented in `std::chrono::duration<>`. In brief, the length of the + * tick in seconds, expressed as a `std::ratio<>`. For our purposes it is + * simply a formal parameter. + * @param maximum_duration the maximum time allowed before the policy expires. + * While the application can express this time in any units they desire, + * the class truncates to milliseconds. + * + * @see https://en.cppreference.com/w/cpp/chrono/duration for more information + * about `std::chrono::duration`. + */ + template + explicit CrossSiteNetworksLimitedTimeRetryPolicy( + std::chrono::duration maximum_duration) + : impl_(maximum_duration) {} + + CrossSiteNetworksLimitedTimeRetryPolicy( + CrossSiteNetworksLimitedTimeRetryPolicy&& rhs) noexcept + : CrossSiteNetworksLimitedTimeRetryPolicy(rhs.maximum_duration()) {} + CrossSiteNetworksLimitedTimeRetryPolicy( + CrossSiteNetworksLimitedTimeRetryPolicy const& rhs) noexcept + : CrossSiteNetworksLimitedTimeRetryPolicy(rhs.maximum_duration()) {} + + std::chrono::milliseconds maximum_duration() const { + return impl_.maximum_duration(); + } + + bool OnFailure(Status const& status) override { + return impl_.OnFailure(status); + } + bool IsExhausted() const override { return impl_.IsExhausted(); } + bool IsPermanentFailure(Status const& status) const override { + return impl_.IsPermanentFailure(status); + } + std::unique_ptr clone() const override { + return std::make_unique( + maximum_duration()); + } + + // This is provided only for backwards compatibility. + using BaseType = CrossSiteNetworksRetryPolicy; + + private: + google::cloud::internal::LimitedTimeRetryPolicy< + compute_cross_site_networks_v1_internal::CrossSiteNetworksRetryTraits> + impl_; +}; + +/** + * The `CrossSiteNetworksConnection` object for `CrossSiteNetworksClient`. + * + * This interface defines virtual methods for each of the user-facing overload + * sets in `CrossSiteNetworksClient`. This allows users to inject custom + * behavior (e.g., with a Google Mock object) when writing tests that use + * objects of type `CrossSiteNetworksClient`. + * + * To create a concrete instance, see `MakeCrossSiteNetworksConnection()`. + * + * For mocking, see + * `compute_cross_site_networks_v1_mocks::MockCrossSiteNetworksConnection`. + */ +class CrossSiteNetworksConnection { + public: + virtual ~CrossSiteNetworksConnection() = 0; + + virtual Options options() { return Options{}; } + + virtual future> + DeleteCrossSiteNetwork(google::cloud::cpp::compute::cross_site_networks::v1:: + DeleteCrossSiteNetworkRequest const& request); + + virtual StatusOr + DeleteCrossSiteNetwork(NoAwaitTag, + google::cloud::cpp::compute::cross_site_networks::v1:: + DeleteCrossSiteNetworkRequest const& request); + + virtual future> + DeleteCrossSiteNetwork( + google::cloud::cpp::compute::v1::Operation const& operation); + + virtual StatusOr + GetCrossSiteNetwork(google::cloud::cpp::compute::cross_site_networks::v1:: + GetCrossSiteNetworkRequest const& request); + + virtual future> + InsertCrossSiteNetwork(google::cloud::cpp::compute::cross_site_networks::v1:: + InsertCrossSiteNetworkRequest const& request); + + virtual StatusOr + InsertCrossSiteNetwork(NoAwaitTag, + google::cloud::cpp::compute::cross_site_networks::v1:: + InsertCrossSiteNetworkRequest const& request); + + virtual future> + InsertCrossSiteNetwork( + google::cloud::cpp::compute::v1::Operation const& operation); + + virtual StreamRange + ListCrossSiteNetworks(google::cloud::cpp::compute::cross_site_networks::v1:: + ListCrossSiteNetworksRequest request); + + virtual future> + PatchCrossSiteNetwork(google::cloud::cpp::compute::cross_site_networks::v1:: + PatchCrossSiteNetworkRequest const& request); + + virtual StatusOr + PatchCrossSiteNetwork(NoAwaitTag, + google::cloud::cpp::compute::cross_site_networks::v1:: + PatchCrossSiteNetworkRequest const& request); + + virtual future> + PatchCrossSiteNetwork( + google::cloud::cpp::compute::v1::Operation const& operation); +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_cross_site_networks_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_CROSS_SITE_NETWORKS_V1_CROSS_SITE_NETWORKS_CONNECTION_H diff --git a/google/cloud/compute/cross_site_networks/v1/cross_site_networks_connection_idempotency_policy.cc b/google/cloud/compute/cross_site_networks/v1/cross_site_networks_connection_idempotency_policy.cc new file mode 100644 index 0000000000000..4ec44dcf0e443 --- /dev/null +++ b/google/cloud/compute/cross_site_networks/v1/cross_site_networks_connection_idempotency_policy.cc @@ -0,0 +1,77 @@ +// Copyright 2026 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. +// source: google/cloud/compute/cross_site_networks/v1/cross_site_networks.proto + +#include "google/cloud/compute/cross_site_networks/v1/cross_site_networks_connection_idempotency_policy.h" +#include + +namespace google { +namespace cloud { +namespace compute_cross_site_networks_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +using ::google::cloud::Idempotency; + +CrossSiteNetworksConnectionIdempotencyPolicy:: + ~CrossSiteNetworksConnectionIdempotencyPolicy() = default; + +std::unique_ptr +CrossSiteNetworksConnectionIdempotencyPolicy::clone() const { + return std::make_unique(*this); +} + +Idempotency +CrossSiteNetworksConnectionIdempotencyPolicy::DeleteCrossSiteNetwork( + google::cloud::cpp::compute::cross_site_networks::v1:: + DeleteCrossSiteNetworkRequest const&) { + return Idempotency::kNonIdempotent; +} + +Idempotency CrossSiteNetworksConnectionIdempotencyPolicy::GetCrossSiteNetwork( + google::cloud::cpp::compute::cross_site_networks::v1:: + GetCrossSiteNetworkRequest const&) { + return Idempotency::kIdempotent; +} + +Idempotency +CrossSiteNetworksConnectionIdempotencyPolicy::InsertCrossSiteNetwork( + google::cloud::cpp::compute::cross_site_networks::v1:: + InsertCrossSiteNetworkRequest const&) { + return Idempotency::kNonIdempotent; +} + +Idempotency CrossSiteNetworksConnectionIdempotencyPolicy::ListCrossSiteNetworks( + google::cloud::cpp::compute::cross_site_networks::v1:: + ListCrossSiteNetworksRequest) { // NOLINT + return Idempotency::kIdempotent; +} + +Idempotency CrossSiteNetworksConnectionIdempotencyPolicy::PatchCrossSiteNetwork( + google::cloud::cpp::compute::cross_site_networks::v1:: + PatchCrossSiteNetworkRequest const&) { + return Idempotency::kNonIdempotent; +} + +std::unique_ptr +MakeDefaultCrossSiteNetworksConnectionIdempotencyPolicy() { + return std::make_unique(); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_cross_site_networks_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/cross_site_networks/v1/cross_site_networks_connection_idempotency_policy.h b/google/cloud/compute/cross_site_networks/v1/cross_site_networks_connection_idempotency_policy.h new file mode 100644 index 0000000000000..4ae0501d4d95a --- /dev/null +++ b/google/cloud/compute/cross_site_networks/v1/cross_site_networks_connection_idempotency_policy.h @@ -0,0 +1,69 @@ +// Copyright 2026 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. +// source: google/cloud/compute/cross_site_networks/v1/cross_site_networks.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_CROSS_SITE_NETWORKS_V1_CROSS_SITE_NETWORKS_CONNECTION_IDEMPOTENCY_POLICY_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_CROSS_SITE_NETWORKS_V1_CROSS_SITE_NETWORKS_CONNECTION_IDEMPOTENCY_POLICY_H + +#include "google/cloud/compute/cross_site_networks/v1/cross_site_networks.pb.h" +#include "google/cloud/idempotency.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_cross_site_networks_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class CrossSiteNetworksConnectionIdempotencyPolicy { + public: + virtual ~CrossSiteNetworksConnectionIdempotencyPolicy(); + + /// Create a new copy of this object. + virtual std::unique_ptr clone() + const; + + virtual google::cloud::Idempotency DeleteCrossSiteNetwork( + google::cloud::cpp::compute::cross_site_networks::v1:: + DeleteCrossSiteNetworkRequest const& request); + + virtual google::cloud::Idempotency GetCrossSiteNetwork( + google::cloud::cpp::compute::cross_site_networks::v1:: + GetCrossSiteNetworkRequest const& request); + + virtual google::cloud::Idempotency InsertCrossSiteNetwork( + google::cloud::cpp::compute::cross_site_networks::v1:: + InsertCrossSiteNetworkRequest const& request); + + virtual google::cloud::Idempotency ListCrossSiteNetworks( + google::cloud::cpp::compute::cross_site_networks::v1:: + ListCrossSiteNetworksRequest request); + + virtual google::cloud::Idempotency PatchCrossSiteNetwork( + google::cloud::cpp::compute::cross_site_networks::v1:: + PatchCrossSiteNetworkRequest const& request); +}; + +std::unique_ptr +MakeDefaultCrossSiteNetworksConnectionIdempotencyPolicy(); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_cross_site_networks_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_CROSS_SITE_NETWORKS_V1_CROSS_SITE_NETWORKS_CONNECTION_IDEMPOTENCY_POLICY_H diff --git a/google/cloud/compute/cross_site_networks/v1/cross_site_networks_options.h b/google/cloud/compute/cross_site_networks/v1/cross_site_networks_options.h new file mode 100644 index 0000000000000..b7237adabb5fd --- /dev/null +++ b/google/cloud/compute/cross_site_networks/v1/cross_site_networks_options.h @@ -0,0 +1,87 @@ +// Copyright 2026 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. +// source: google/cloud/compute/cross_site_networks/v1/cross_site_networks.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_CROSS_SITE_NETWORKS_V1_CROSS_SITE_NETWORKS_OPTIONS_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_CROSS_SITE_NETWORKS_V1_CROSS_SITE_NETWORKS_OPTIONS_H + +#include "google/cloud/compute/cross_site_networks/v1/cross_site_networks_connection.h" +#include "google/cloud/compute/cross_site_networks/v1/cross_site_networks_connection_idempotency_policy.h" +#include "google/cloud/backoff_policy.h" +#include "google/cloud/options.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_cross_site_networks_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/** + * Use with `google::cloud::Options` to configure the retry policy. + * + * @ingroup google-cloud-compute-options + */ +struct CrossSiteNetworksRetryPolicyOption { + using Type = std::shared_ptr; +}; + +/** + * Use with `google::cloud::Options` to configure the backoff policy. + * + * @ingroup google-cloud-compute-options + */ +struct CrossSiteNetworksBackoffPolicyOption { + using Type = std::shared_ptr; +}; + +/** + * Use with `google::cloud::Options` to configure which operations are retried. + * + * @ingroup google-cloud-compute-options + */ +struct CrossSiteNetworksConnectionIdempotencyPolicyOption { + using Type = std::shared_ptr; +}; + +/** + * Use with `google::cloud::Options` to configure the long-running operations + * polling policy. + * + * @ingroup google-cloud-compute-options + */ +struct CrossSiteNetworksPollingPolicyOption { + using Type = std::shared_ptr; +}; + +/** + * The options applicable to CrossSiteNetworks. + * + * @ingroup google-cloud-compute-options + */ +using CrossSiteNetworksPolicyOptionList = + OptionList; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_cross_site_networks_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_CROSS_SITE_NETWORKS_V1_CROSS_SITE_NETWORKS_OPTIONS_H diff --git a/google/cloud/compute/cross_site_networks/v1/cross_site_networks_proto_export.h b/google/cloud/compute/cross_site_networks/v1/cross_site_networks_proto_export.h new file mode 100644 index 0000000000000..4e7abcb39af03 --- /dev/null +++ b/google/cloud/compute/cross_site_networks/v1/cross_site_networks_proto_export.h @@ -0,0 +1,33 @@ +// Copyright 2026 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_CROSS_SITE_NETWORKS_V1_CROSS_SITE_NETWORKS_PROTO_EXPORT_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_CROSS_SITE_NETWORKS_V1_CROSS_SITE_NETWORKS_PROTO_EXPORT_H + +// IWYU pragma: begin_exports +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_027.pb.h" +// IWYU pragma: end_exports + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_CROSS_SITE_NETWORKS_V1_CROSS_SITE_NETWORKS_PROTO_EXPORT_H diff --git a/google/cloud/compute/cross_site_networks/v1/cross_site_networks_rest_connection.cc b/google/cloud/compute/cross_site_networks/v1/cross_site_networks_rest_connection.cc new file mode 100644 index 0000000000000..a31f5615bcefc --- /dev/null +++ b/google/cloud/compute/cross_site_networks/v1/cross_site_networks_rest_connection.cc @@ -0,0 +1,60 @@ +// Copyright 2026 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. +// source: google/cloud/compute/cross_site_networks/v1/cross_site_networks.proto + +#include "google/cloud/compute/cross_site_networks/v1/cross_site_networks_rest_connection.h" +#include "google/cloud/compute/cross_site_networks/v1/cross_site_networks_options.h" +#include "google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_option_defaults.h" +#include "google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_rest_connection_impl.h" +#include "google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_rest_stub_factory.h" +#include "google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_tracing_connection.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/internal/rest_background_threads_impl.h" +#include "google/cloud/internal/rest_options.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_cross_site_networks_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +std::shared_ptr +MakeCrossSiteNetworksConnectionRest(Options options) { + internal::CheckExpectedOptions< + CommonOptionList, RestOptionList, UnifiedCredentialsOptionList, + rest_internal::TargetApiVersionOption, CrossSiteNetworksPolicyOptionList>( + options, __func__); + options = + compute_cross_site_networks_v1_internal::CrossSiteNetworksDefaultOptions( + std::move(options)); + auto background = std::make_unique< + rest_internal::AutomaticallyCreatedRestBackgroundThreads>(); + auto stub = compute_cross_site_networks_v1_internal:: + CreateDefaultCrossSiteNetworksRestStub(options); + return compute_cross_site_networks_v1_internal:: + MakeCrossSiteNetworksTracingConnection( + std::make_shared( + std::move(background), std::move(stub), std::move(options))); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_cross_site_networks_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/cross_site_networks/v1/cross_site_networks_rest_connection.h b/google/cloud/compute/cross_site_networks/v1/cross_site_networks_rest_connection.h new file mode 100644 index 0000000000000..1b1204f2b794c --- /dev/null +++ b/google/cloud/compute/cross_site_networks/v1/cross_site_networks_rest_connection.h @@ -0,0 +1,66 @@ +// Copyright 2026 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. +// source: google/cloud/compute/cross_site_networks/v1/cross_site_networks.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_CROSS_SITE_NETWORKS_V1_CROSS_SITE_NETWORKS_REST_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_CROSS_SITE_NETWORKS_V1_CROSS_SITE_NETWORKS_REST_CONNECTION_H + +#include "google/cloud/compute/cross_site_networks/v1/cross_site_networks_connection.h" +#include "google/cloud/options.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_cross_site_networks_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/** + * A factory function to construct an object of type + * `CrossSiteNetworksConnection` that uses REST over HTTP as transport in lieu + * of gRPC. REST transport should only be used for services that do not support + * gRPC or if the existing network configuration precludes using gRPC. + * + * The returned connection object should not be used directly; instead it + * should be passed as an argument to the constructor of + * CrossSiteNetworksClient. + * + * The optional @p options argument may be used to configure aspects of the + * returned `CrossSiteNetworksConnection`. Expected options are any of the types + * in the following option lists: + * + * - `google::cloud::CommonOptionList` + * - `google::cloud::RestOptionList` + * - `google::cloud::UnifiedCredentialsOptionList` + * - + * `google::cloud::compute_cross_site_networks_v1::CrossSiteNetworksPolicyOptionList` + * + * @note Unexpected options will be ignored. To log unexpected options instead, + * set `GOOGLE_CLOUD_CPP_ENABLE_CLOG=yes` in the environment. + * + * @param options (optional) Configure the `CrossSiteNetworksConnection` created + * by this function. + */ +std::shared_ptr +MakeCrossSiteNetworksConnectionRest(Options options = {}); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_cross_site_networks_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_CROSS_SITE_NETWORKS_V1_CROSS_SITE_NETWORKS_REST_CONNECTION_H diff --git a/google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_option_defaults.cc b/google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_option_defaults.cc new file mode 100644 index 0000000000000..60a78447eb718 --- /dev/null +++ b/google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_option_defaults.cc @@ -0,0 +1,90 @@ +// Copyright 2026 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. +// source: google/cloud/compute/cross_site_networks/v1/cross_site_networks.proto + +#include "google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_option_defaults.h" +#include "google/cloud/compute/cross_site_networks/v1/cross_site_networks_connection.h" +#include "google/cloud/compute/cross_site_networks/v1/cross_site_networks_options.h" +#include "google/cloud/internal/populate_common_options.h" +#include "google/cloud/internal/populate_grpc_options.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_cross_site_networks_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +namespace { +auto constexpr kBackoffScaling = 2.0; +} // namespace + +Options CrossSiteNetworksDefaultOptions(Options options) { + options = internal::PopulateCommonOptions( + std::move(options), "GOOGLE_CLOUD_CPP_CROSS_SITE_NETWORKS_ENDPOINT", "", + "GOOGLE_CLOUD_CPP_CROSS_SITE_NETWORKS_AUTHORITY", + "compute.googleapis.com"); + options = internal::PopulateGrpcOptions(std::move(options)); + if (!options.has()) { + options.set< + compute_cross_site_networks_v1::CrossSiteNetworksRetryPolicyOption>( + compute_cross_site_networks_v1::CrossSiteNetworksLimitedTimeRetryPolicy( + std::chrono::minutes(10)) + .clone()); + } + if (!options.has()) { + options.set< + compute_cross_site_networks_v1::CrossSiteNetworksBackoffPolicyOption>( + ExponentialBackoffPolicy( + std::chrono::seconds(0), std::chrono::seconds(1), + std::chrono::minutes(5), kBackoffScaling, kBackoffScaling) + .clone()); + } + if (!options.has()) { + options.set< + compute_cross_site_networks_v1::CrossSiteNetworksPollingPolicyOption>( + GenericPollingPolicy( + options + .get() + ->clone(), + ExponentialBackoffPolicy(std::chrono::seconds(1), + std::chrono::minutes(5), kBackoffScaling) + .clone()) + .clone()); + } + if (!options.has()) { + options.set( + compute_cross_site_networks_v1:: + MakeDefaultCrossSiteNetworksConnectionIdempotencyPolicy()); + } + + return options; +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_cross_site_networks_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_option_defaults.h b/google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_option_defaults.h new file mode 100644 index 0000000000000..ea9f3123b0172 --- /dev/null +++ b/google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_option_defaults.h @@ -0,0 +1,37 @@ +// Copyright 2026 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. +// source: google/cloud/compute/cross_site_networks/v1/cross_site_networks.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_CROSS_SITE_NETWORKS_V1_INTERNAL_CROSS_SITE_NETWORKS_OPTION_DEFAULTS_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_CROSS_SITE_NETWORKS_V1_INTERNAL_CROSS_SITE_NETWORKS_OPTION_DEFAULTS_H + +#include "google/cloud/options.h" +#include "google/cloud/version.h" + +namespace google { +namespace cloud { +namespace compute_cross_site_networks_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +Options CrossSiteNetworksDefaultOptions(Options options); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_cross_site_networks_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_CROSS_SITE_NETWORKS_V1_INTERNAL_CROSS_SITE_NETWORKS_OPTION_DEFAULTS_H diff --git a/google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_rest_connection_impl.cc b/google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_rest_connection_impl.cc new file mode 100644 index 0000000000000..9ba58c10cea0e --- /dev/null +++ b/google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_rest_connection_impl.cc @@ -0,0 +1,488 @@ +// Copyright 2026 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. +// source: google/cloud/compute/cross_site_networks/v1/cross_site_networks.proto + +#include "google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_rest_connection_impl.h" +#include "google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_rest_stub_factory.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/internal/async_rest_long_running_operation_custom.h" +#include "google/cloud/internal/extract_long_running_result.h" +#include "google/cloud/internal/pagination_range.h" +#include "google/cloud/internal/rest_lro_helpers.h" +#include "google/cloud/internal/rest_retry_loop.h" +#include "google/cloud/rest_options.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_cross_site_networks_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +CrossSiteNetworksRestConnectionImpl::CrossSiteNetworksRestConnectionImpl( + std::unique_ptr background, + std::shared_ptr< + compute_cross_site_networks_v1_internal::CrossSiteNetworksRestStub> + stub, + Options options) + : background_(std::move(background)), + stub_(std::move(stub)), + options_(internal::MergeOptions( + std::move(options), CrossSiteNetworksConnection::options())) {} + +future> +CrossSiteNetworksRestConnectionImpl::DeleteCrossSiteNetwork( + google::cloud::cpp::compute::cross_site_networks::v1:: + DeleteCrossSiteNetworkRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::global_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, request, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::cross_site_networks::v1:: + DeleteCrossSiteNetworkRequest const& request) { + return stub->AsyncDeleteCrossSiteNetwork(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->DeleteCrossSiteNetwork(request), + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [request](std::string const& op, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest& r) { + r.set_project(request.project()); + r.set_operation(op); + }, + [request](std::string const& op, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest& r) { + r.set_project(request.project()); + r.set_operation(op); + }); +} + +StatusOr +CrossSiteNetworksRestConnectionImpl::DeleteCrossSiteNetwork( + NoAwaitTag, google::cloud::cpp::compute::cross_site_networks::v1:: + DeleteCrossSiteNetworkRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->DeleteCrossSiteNetwork(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::cross_site_networks::v1:: + DeleteCrossSiteNetworkRequest const& request) { + return stub_->DeleteCrossSiteNetwork(rest_context, options, request); + }, + *current, request, __func__); +} + +future> +CrossSiteNetworksRestConnectionImpl::DeleteCrossSiteNetwork( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestAwaitLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::global_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, operation, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [operation](std::string const&, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_operation(info.operation); + }, + [operation](std::string const&, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_operation(info.operation); + }); +} + +StatusOr +CrossSiteNetworksRestConnectionImpl::GetCrossSiteNetwork( + google::cloud::cpp::compute::cross_site_networks::v1:: + GetCrossSiteNetworkRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->GetCrossSiteNetwork(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::cross_site_networks::v1:: + GetCrossSiteNetworkRequest const& request) { + return stub_->GetCrossSiteNetwork(rest_context, options, request); + }, + *current, request, __func__); +} + +future> +CrossSiteNetworksRestConnectionImpl::InsertCrossSiteNetwork( + google::cloud::cpp::compute::cross_site_networks::v1:: + InsertCrossSiteNetworkRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::global_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, request, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::cross_site_networks::v1:: + InsertCrossSiteNetworkRequest const& request) { + return stub->AsyncInsertCrossSiteNetwork(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->InsertCrossSiteNetwork(request), + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [request](std::string const& op, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest& r) { + r.set_project(request.project()); + r.set_operation(op); + }, + [request](std::string const& op, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest& r) { + r.set_project(request.project()); + r.set_operation(op); + }); +} + +StatusOr +CrossSiteNetworksRestConnectionImpl::InsertCrossSiteNetwork( + NoAwaitTag, google::cloud::cpp::compute::cross_site_networks::v1:: + InsertCrossSiteNetworkRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->InsertCrossSiteNetwork(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::cross_site_networks::v1:: + InsertCrossSiteNetworkRequest const& request) { + return stub_->InsertCrossSiteNetwork(rest_context, options, request); + }, + *current, request, __func__); +} + +future> +CrossSiteNetworksRestConnectionImpl::InsertCrossSiteNetwork( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestAwaitLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::global_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, operation, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [operation](std::string const&, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_operation(info.operation); + }, + [operation](std::string const&, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_operation(info.operation); + }); +} + +StreamRange +CrossSiteNetworksRestConnectionImpl::ListCrossSiteNetworks( + google::cloud::cpp::compute::cross_site_networks::v1:: + ListCrossSiteNetworksRequest request) { + request.clear_page_token(); + auto current = google::cloud::internal::SaveCurrentOptions(); + auto idempotency = + idempotency_policy(*current)->ListCrossSiteNetworks(request); + char const* function_name = __func__; + return google::cloud::internal::MakePaginationRange< + StreamRange>( + current, std::move(request), + [idempotency, function_name, stub = stub_, + retry = std::shared_ptr< + compute_cross_site_networks_v1::CrossSiteNetworksRetryPolicy>( + retry_policy(*current)), + backoff = std::shared_ptr(backoff_policy(*current))]( + Options const& options, + google::cloud::cpp::compute::cross_site_networks::v1:: + ListCrossSiteNetworksRequest const& r) { + return google::cloud::rest_internal::RestRetryLoop( + retry->clone(), backoff->clone(), idempotency, + [stub](rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::cross_site_networks::v1:: + ListCrossSiteNetworksRequest const& request) { + return stub->ListCrossSiteNetworks(rest_context, options, + request); + }, + options, r, function_name); + }, + [](google::cloud::cpp::compute::v1::CrossSiteNetworkList r) { + std::vector result( + r.items().size()); + auto& messages = *r.mutable_items(); + std::move(messages.begin(), messages.end(), result.begin()); + return result; + }); +} + +future> +CrossSiteNetworksRestConnectionImpl::PatchCrossSiteNetwork( + google::cloud::cpp::compute::cross_site_networks::v1:: + PatchCrossSiteNetworkRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::global_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, request, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::cross_site_networks::v1:: + PatchCrossSiteNetworkRequest const& request) { + return stub->AsyncPatchCrossSiteNetwork(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->PatchCrossSiteNetwork(request), + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [request](std::string const& op, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest& r) { + r.set_project(request.project()); + r.set_operation(op); + }, + [request](std::string const& op, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest& r) { + r.set_project(request.project()); + r.set_operation(op); + }); +} + +StatusOr +CrossSiteNetworksRestConnectionImpl::PatchCrossSiteNetwork( + NoAwaitTag, google::cloud::cpp::compute::cross_site_networks::v1:: + PatchCrossSiteNetworkRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->PatchCrossSiteNetwork(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::cross_site_networks::v1:: + PatchCrossSiteNetworkRequest const& request) { + return stub_->PatchCrossSiteNetwork(rest_context, options, request); + }, + *current, request, __func__); +} + +future> +CrossSiteNetworksRestConnectionImpl::PatchCrossSiteNetwork( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestAwaitLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::global_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, operation, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [operation](std::string const&, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_operation(info.operation); + }, + [operation](std::string const&, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_operation(info.operation); + }); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_cross_site_networks_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_rest_connection_impl.h b/google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_rest_connection_impl.h new file mode 100644 index 0000000000000..f504f39c715f1 --- /dev/null +++ b/google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_rest_connection_impl.h @@ -0,0 +1,147 @@ +// Copyright 2026 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. +// source: google/cloud/compute/cross_site_networks/v1/cross_site_networks.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_CROSS_SITE_NETWORKS_V1_INTERNAL_CROSS_SITE_NETWORKS_REST_CONNECTION_IMPL_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_CROSS_SITE_NETWORKS_V1_INTERNAL_CROSS_SITE_NETWORKS_REST_CONNECTION_IMPL_H + +#include "google/cloud/compute/cross_site_networks/v1/cross_site_networks_connection.h" +#include "google/cloud/compute/cross_site_networks/v1/cross_site_networks_connection_idempotency_policy.h" +#include "google/cloud/compute/cross_site_networks/v1/cross_site_networks_options.h" +#include "google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_rest_stub.h" +#include "google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_retry_traits.h" +#include "google/cloud/compute/global_operations/v1/global_operations.pb.h" +#include "google/cloud/background_threads.h" +#include "google/cloud/backoff_policy.h" +#include "google/cloud/options.h" +#include "google/cloud/status_or.h" +#include "google/cloud/stream_range.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_cross_site_networks_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class CrossSiteNetworksRestConnectionImpl + : public compute_cross_site_networks_v1::CrossSiteNetworksConnection { + public: + ~CrossSiteNetworksRestConnectionImpl() override = default; + + CrossSiteNetworksRestConnectionImpl( + std::unique_ptr background, + std::shared_ptr< + compute_cross_site_networks_v1_internal::CrossSiteNetworksRestStub> + stub, + Options options); + + Options options() override { return options_; } + + future> + DeleteCrossSiteNetwork( + google::cloud::cpp::compute::cross_site_networks::v1:: + DeleteCrossSiteNetworkRequest const& request) override; + + StatusOr DeleteCrossSiteNetwork( + NoAwaitTag, google::cloud::cpp::compute::cross_site_networks::v1:: + DeleteCrossSiteNetworkRequest const& request) override; + + future> + DeleteCrossSiteNetwork( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + StatusOr + GetCrossSiteNetwork(google::cloud::cpp::compute::cross_site_networks::v1:: + GetCrossSiteNetworkRequest const& request) override; + + future> + InsertCrossSiteNetwork( + google::cloud::cpp::compute::cross_site_networks::v1:: + InsertCrossSiteNetworkRequest const& request) override; + + StatusOr InsertCrossSiteNetwork( + NoAwaitTag, google::cloud::cpp::compute::cross_site_networks::v1:: + InsertCrossSiteNetworkRequest const& request) override; + + future> + InsertCrossSiteNetwork( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + StreamRange + ListCrossSiteNetworks(google::cloud::cpp::compute::cross_site_networks::v1:: + ListCrossSiteNetworksRequest request) override; + + future> + PatchCrossSiteNetwork( + google::cloud::cpp::compute::cross_site_networks::v1:: + PatchCrossSiteNetworkRequest const& request) override; + + StatusOr PatchCrossSiteNetwork( + NoAwaitTag, google::cloud::cpp::compute::cross_site_networks::v1:: + PatchCrossSiteNetworkRequest const& request) override; + + future> + PatchCrossSiteNetwork( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + private: + static std::unique_ptr< + compute_cross_site_networks_v1::CrossSiteNetworksRetryPolicy> + retry_policy(Options const& options) { + return options + .get() + ->clone(); + } + + static std::unique_ptr backoff_policy(Options const& options) { + return options + .get() + ->clone(); + } + + static std::unique_ptr + idempotency_policy(Options const& options) { + return options + .get() + ->clone(); + } + + static std::unique_ptr polling_policy(Options const& options) { + return options + .get() + ->clone(); + } + + std::unique_ptr background_; + std::shared_ptr< + compute_cross_site_networks_v1_internal::CrossSiteNetworksRestStub> + stub_; + Options options_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_cross_site_networks_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_CROSS_SITE_NETWORKS_V1_INTERNAL_CROSS_SITE_NETWORKS_REST_CONNECTION_IMPL_H diff --git a/google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_rest_logging_decorator.cc b/google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_rest_logging_decorator.cc new file mode 100644 index 0000000000000..4befbda38c3bc --- /dev/null +++ b/google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_rest_logging_decorator.cc @@ -0,0 +1,209 @@ +// Copyright 2026 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. +// source: google/cloud/compute/cross_site_networks/v1/cross_site_networks.proto + +#include "google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_rest_logging_decorator.h" +#include "google/cloud/internal/log_wrapper.h" +#include "google/cloud/status_or.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_cross_site_networks_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +CrossSiteNetworksRestLogging::CrossSiteNetworksRestLogging( + std::shared_ptr child, + TracingOptions tracing_options, std::set components) + : child_(std::move(child)), + tracing_options_(std::move(tracing_options)), + components_(std::move(components)) {} + +future> +CrossSiteNetworksRestLogging::AsyncDeleteCrossSiteNetwork( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::cross_site_networks::v1:: + DeleteCrossSiteNetworkRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::cross_site_networks::v1:: + DeleteCrossSiteNetworkRequest const& request) { + return child_->AsyncDeleteCrossSiteNetwork(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +StatusOr +CrossSiteNetworksRestLogging::DeleteCrossSiteNetwork( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::cross_site_networks::v1:: + DeleteCrossSiteNetworkRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::cross_site_networks::v1:: + DeleteCrossSiteNetworkRequest const& request) { + return child_->DeleteCrossSiteNetwork(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +StatusOr +CrossSiteNetworksRestLogging::GetCrossSiteNetwork( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::cross_site_networks::v1:: + GetCrossSiteNetworkRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::cross_site_networks::v1:: + GetCrossSiteNetworkRequest const& request) { + return child_->GetCrossSiteNetwork(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +future> +CrossSiteNetworksRestLogging::AsyncInsertCrossSiteNetwork( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::cross_site_networks::v1:: + InsertCrossSiteNetworkRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::cross_site_networks::v1:: + InsertCrossSiteNetworkRequest const& request) { + return child_->AsyncInsertCrossSiteNetwork(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +StatusOr +CrossSiteNetworksRestLogging::InsertCrossSiteNetwork( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::cross_site_networks::v1:: + InsertCrossSiteNetworkRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::cross_site_networks::v1:: + InsertCrossSiteNetworkRequest const& request) { + return child_->InsertCrossSiteNetwork(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +StatusOr +CrossSiteNetworksRestLogging::ListCrossSiteNetworks( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::cross_site_networks::v1:: + ListCrossSiteNetworksRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::cross_site_networks::v1:: + ListCrossSiteNetworksRequest const& request) { + return child_->ListCrossSiteNetworks(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +future> +CrossSiteNetworksRestLogging::AsyncPatchCrossSiteNetwork( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::cross_site_networks::v1:: + PatchCrossSiteNetworkRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::cross_site_networks::v1:: + PatchCrossSiteNetworkRequest const& request) { + return child_->AsyncPatchCrossSiteNetwork(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +StatusOr +CrossSiteNetworksRestLogging::PatchCrossSiteNetwork( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::cross_site_networks::v1:: + PatchCrossSiteNetworkRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::cross_site_networks::v1:: + PatchCrossSiteNetworkRequest const& request) { + return child_->PatchCrossSiteNetwork(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +future> +CrossSiteNetworksRestLogging::AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) { + return child_->AsyncGetOperation(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +future CrossSiteNetworksRestLogging::AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) { + return child_->AsyncCancelOperation(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_cross_site_networks_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_rest_logging_decorator.h b/google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_rest_logging_decorator.h new file mode 100644 index 0000000000000..7a831a04519b7 --- /dev/null +++ b/google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_rest_logging_decorator.h @@ -0,0 +1,126 @@ +// Copyright 2026 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. +// source: google/cloud/compute/cross_site_networks/v1/cross_site_networks.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_CROSS_SITE_NETWORKS_V1_INTERNAL_CROSS_SITE_NETWORKS_REST_LOGGING_DECORATOR_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_CROSS_SITE_NETWORKS_V1_INTERNAL_CROSS_SITE_NETWORKS_REST_LOGGING_DECORATOR_H + +#include "google/cloud/compute/cross_site_networks/v1/cross_site_networks.pb.h" +#include "google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_rest_stub.h" +#include "google/cloud/compute/global_operations/v1/global_operations.pb.h" +#include "google/cloud/future.h" +#include "google/cloud/internal/rest_context.h" +#include "google/cloud/tracing_options.h" +#include "google/cloud/version.h" +#include +#include +#include + +namespace google { +namespace cloud { +namespace compute_cross_site_networks_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class CrossSiteNetworksRestLogging : public CrossSiteNetworksRestStub { + public: + ~CrossSiteNetworksRestLogging() override = default; + CrossSiteNetworksRestLogging(std::shared_ptr child, + TracingOptions tracing_options, + std::set components); + + future> + AsyncDeleteCrossSiteNetwork( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::cross_site_networks::v1:: + DeleteCrossSiteNetworkRequest const& request) override; + + StatusOr DeleteCrossSiteNetwork( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::cross_site_networks::v1:: + DeleteCrossSiteNetworkRequest const& request) override; + + StatusOr + GetCrossSiteNetwork(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::cross_site_networks::v1:: + GetCrossSiteNetworkRequest const& request) override; + + future> + AsyncInsertCrossSiteNetwork( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::cross_site_networks::v1:: + InsertCrossSiteNetworkRequest const& request) override; + + StatusOr InsertCrossSiteNetwork( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::cross_site_networks::v1:: + InsertCrossSiteNetworkRequest const& request) override; + + StatusOr + ListCrossSiteNetworks( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::cross_site_networks::v1:: + ListCrossSiteNetworksRequest const& request) override; + + future> + AsyncPatchCrossSiteNetwork( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::cross_site_networks::v1:: + PatchCrossSiteNetworkRequest const& request) override; + + StatusOr PatchCrossSiteNetwork( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::cross_site_networks::v1:: + PatchCrossSiteNetworkRequest const& request) override; + + future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) override; + + future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) override; + + private: + std::shared_ptr child_; + TracingOptions tracing_options_; + std::set components_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_cross_site_networks_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_CROSS_SITE_NETWORKS_V1_INTERNAL_CROSS_SITE_NETWORKS_REST_LOGGING_DECORATOR_H diff --git a/google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_rest_metadata_decorator.cc b/google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_rest_metadata_decorator.cc new file mode 100644 index 0000000000000..d150390f8901c --- /dev/null +++ b/google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_rest_metadata_decorator.cc @@ -0,0 +1,156 @@ +// Copyright 2026 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. +// source: google/cloud/compute/cross_site_networks/v1/cross_site_networks.proto + +#include "google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_rest_metadata_decorator.h" +#include "google/cloud/internal/api_client_header.h" +#include "google/cloud/internal/rest_set_metadata.h" +#include "google/cloud/status_or.h" +#include "absl/strings/str_cat.h" +#include "absl/strings/str_format.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_cross_site_networks_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +CrossSiteNetworksRestMetadata::CrossSiteNetworksRestMetadata( + std::shared_ptr child, + std::string api_client_header) + : child_(std::move(child)), + api_client_header_( + api_client_header.empty() + ? google::cloud::internal::GeneratedLibClientHeader() + : std::move(api_client_header)) {} + +future> +CrossSiteNetworksRestMetadata::AsyncDeleteCrossSiteNetwork( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::cross_site_networks::v1:: + DeleteCrossSiteNetworkRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncDeleteCrossSiteNetwork(cq, std::move(rest_context), + std::move(options), request); +} + +StatusOr +CrossSiteNetworksRestMetadata::DeleteCrossSiteNetwork( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::cross_site_networks::v1:: + DeleteCrossSiteNetworkRequest const& request) { + SetMetadata(rest_context, options); + return child_->DeleteCrossSiteNetwork(rest_context, options, request); +} + +StatusOr +CrossSiteNetworksRestMetadata::GetCrossSiteNetwork( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::cross_site_networks::v1:: + GetCrossSiteNetworkRequest const& request) { + SetMetadata(rest_context, options); + return child_->GetCrossSiteNetwork(rest_context, options, request); +} + +future> +CrossSiteNetworksRestMetadata::AsyncInsertCrossSiteNetwork( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::cross_site_networks::v1:: + InsertCrossSiteNetworkRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncInsertCrossSiteNetwork(cq, std::move(rest_context), + std::move(options), request); +} + +StatusOr +CrossSiteNetworksRestMetadata::InsertCrossSiteNetwork( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::cross_site_networks::v1:: + InsertCrossSiteNetworkRequest const& request) { + SetMetadata(rest_context, options); + return child_->InsertCrossSiteNetwork(rest_context, options, request); +} + +StatusOr +CrossSiteNetworksRestMetadata::ListCrossSiteNetworks( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::cross_site_networks::v1:: + ListCrossSiteNetworksRequest const& request) { + SetMetadata(rest_context, options); + return child_->ListCrossSiteNetworks(rest_context, options, request); +} + +future> +CrossSiteNetworksRestMetadata::AsyncPatchCrossSiteNetwork( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::cross_site_networks::v1:: + PatchCrossSiteNetworkRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncPatchCrossSiteNetwork(cq, std::move(rest_context), + std::move(options), request); +} + +StatusOr +CrossSiteNetworksRestMetadata::PatchCrossSiteNetwork( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::cross_site_networks::v1:: + PatchCrossSiteNetworkRequest const& request) { + SetMetadata(rest_context, options); + return child_->PatchCrossSiteNetwork(rest_context, options, request); +} + +future> +CrossSiteNetworksRestMetadata::AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncGetOperation(cq, std::move(rest_context), + std::move(options), request); +} + +future CrossSiteNetworksRestMetadata::AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncCancelOperation(cq, std::move(rest_context), + std::move(options), request); +} + +void CrossSiteNetworksRestMetadata::SetMetadata( + rest_internal::RestContext& rest_context, Options const& options, + std::vector const& params) { + google::cloud::rest_internal::SetMetadata(rest_context, options, params, + api_client_header_); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_cross_site_networks_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_rest_metadata_decorator.h b/google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_rest_metadata_decorator.h new file mode 100644 index 0000000000000..f69b6b5e4434d --- /dev/null +++ b/google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_rest_metadata_decorator.h @@ -0,0 +1,127 @@ +// Copyright 2026 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. +// source: google/cloud/compute/cross_site_networks/v1/cross_site_networks.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_CROSS_SITE_NETWORKS_V1_INTERNAL_CROSS_SITE_NETWORKS_REST_METADATA_DECORATOR_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_CROSS_SITE_NETWORKS_V1_INTERNAL_CROSS_SITE_NETWORKS_REST_METADATA_DECORATOR_H + +#include "google/cloud/compute/cross_site_networks/v1/cross_site_networks.pb.h" +#include "google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_rest_stub.h" +#include "google/cloud/compute/global_operations/v1/global_operations.pb.h" +#include "google/cloud/future.h" +#include "google/cloud/rest_options.h" +#include "google/cloud/version.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_cross_site_networks_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class CrossSiteNetworksRestMetadata : public CrossSiteNetworksRestStub { + public: + ~CrossSiteNetworksRestMetadata() override = default; + explicit CrossSiteNetworksRestMetadata( + std::shared_ptr child, + std::string api_client_header = ""); + + google::cloud::future> + AsyncDeleteCrossSiteNetwork( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::cross_site_networks::v1:: + DeleteCrossSiteNetworkRequest const& request) override; + + StatusOr DeleteCrossSiteNetwork( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::cross_site_networks::v1:: + DeleteCrossSiteNetworkRequest const& request) override; + + StatusOr + GetCrossSiteNetwork(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::cross_site_networks::v1:: + GetCrossSiteNetworkRequest const& request) override; + + google::cloud::future> + AsyncInsertCrossSiteNetwork( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::cross_site_networks::v1:: + InsertCrossSiteNetworkRequest const& request) override; + + StatusOr InsertCrossSiteNetwork( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::cross_site_networks::v1:: + InsertCrossSiteNetworkRequest const& request) override; + + StatusOr + ListCrossSiteNetworks( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::cross_site_networks::v1:: + ListCrossSiteNetworksRequest const& request) override; + + google::cloud::future> + AsyncPatchCrossSiteNetwork( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::cross_site_networks::v1:: + PatchCrossSiteNetworkRequest const& request) override; + + StatusOr PatchCrossSiteNetwork( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::cross_site_networks::v1:: + PatchCrossSiteNetworkRequest const& request) override; + + google::cloud::future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) override; + + google::cloud::future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) override; + + private: + void SetMetadata(rest_internal::RestContext& rest_context, + Options const& options, + std::vector const& params = {}); + + std::shared_ptr child_; + std::string api_client_header_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_cross_site_networks_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_CROSS_SITE_NETWORKS_V1_INTERNAL_CROSS_SITE_NETWORKS_REST_METADATA_DECORATOR_H diff --git a/google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_rest_stub.cc b/google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_rest_stub.cc new file mode 100644 index 0000000000000..5cdba154dcc4e --- /dev/null +++ b/google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_rest_stub.cc @@ -0,0 +1,334 @@ +// Copyright 2026 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. +// source: google/cloud/compute/cross_site_networks/v1/cross_site_networks.proto + +#include "google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_rest_stub.h" +#include "google/cloud/compute/cross_site_networks/v1/cross_site_networks.pb.h" +#include "google/cloud/compute/global_operations/v1/global_operations.pb.h" +#include "google/cloud/common_options.h" +#include "google/cloud/internal/rest_stub_helpers.h" +#include "google/cloud/status_or.h" +#include "absl/strings/str_cat.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_cross_site_networks_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +DefaultCrossSiteNetworksRestStub::DefaultCrossSiteNetworksRestStub( + Options options) + : service_(rest_internal::MakePooledRestClient( + options.get(), options)), + operations_(rest_internal::MakePooledRestClient( + options.get(), options)), + options_(std::move(options)) {} + +DefaultCrossSiteNetworksRestStub::DefaultCrossSiteNetworksRestStub( + std::shared_ptr service, + std::shared_ptr operations, Options options) + : service_(std::move(service)), + operations_(std::move(operations)), + options_(std::move(options)) {} + +future> +DefaultCrossSiteNetworksRestStub::AsyncDeleteCrossSiteNetwork( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::cross_site_networks::v1:: + DeleteCrossSiteNetworkRequest const& request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto service, auto request, auto rest_context, auto options) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + p.set_value( + rest_internal::Delete( + *service, *rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", *options), + "/", "projects", "/", request.project(), "/", + "global", "/", "crossSiteNetworks", "/", + request.cross_site_network()), + std::move(query_params))); + }, + std::move(p), + service_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +StatusOr +DefaultCrossSiteNetworksRestStub::DeleteCrossSiteNetwork( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::cross_site_networks::v1:: + DeleteCrossSiteNetworkRequest const& request) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Delete( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "global", "/", + "crossSiteNetworks", "/", request.cross_site_network()), + std::move(query_params)); +} + +StatusOr +DefaultCrossSiteNetworksRestStub::GetCrossSiteNetwork( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::cross_site_networks::v1:: + GetCrossSiteNetworkRequest const& request) { + std::vector> query_params; + return rest_internal::Get( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "global", "/", + "crossSiteNetworks", "/", request.cross_site_network()), + std::move(query_params)); +} + +future> +DefaultCrossSiteNetworksRestStub::AsyncInsertCrossSiteNetwork( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::cross_site_networks::v1:: + InsertCrossSiteNetworkRequest const& request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto service, auto request, auto rest_context, auto options) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params.push_back( + {"validate_only", (request.validate_only() ? "1" : "0")}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + p.set_value( + rest_internal::Post( + *service, *rest_context, request.cross_site_network_resource(), + false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", *options), + "/", "projects", "/", request.project(), "/", + "global", "/", "crossSiteNetworks"), + std::move(query_params))); + }, + std::move(p), + service_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +StatusOr +DefaultCrossSiteNetworksRestStub::InsertCrossSiteNetwork( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::cross_site_networks::v1:: + InsertCrossSiteNetworkRequest const& request) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params.push_back( + {"validate_only", (request.validate_only() ? "1" : "0")}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Post( + *service_, rest_context, request.cross_site_network_resource(), false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "global", "/", + "crossSiteNetworks"), + std::move(query_params)); +} + +StatusOr +DefaultCrossSiteNetworksRestStub::ListCrossSiteNetworks( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::cross_site_networks::v1:: + ListCrossSiteNetworksRequest const& request) { + std::vector> query_params; + query_params.push_back({"filter", request.filter()}); + query_params.push_back( + {"max_results", std::to_string(request.max_results())}); + query_params.push_back({"order_by", request.order_by()}); + query_params.push_back({"page_token", request.page_token()}); + query_params.push_back({"return_partial_success", + (request.return_partial_success() ? "1" : "0")}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Get< + google::cloud::cpp::compute::v1::CrossSiteNetworkList>( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "global", "/", + "crossSiteNetworks"), + std::move(query_params)); +} + +future> +DefaultCrossSiteNetworksRestStub::AsyncPatchCrossSiteNetwork( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::cross_site_networks::v1:: + PatchCrossSiteNetworkRequest const& request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto service, auto request, auto rest_context, auto options) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params.push_back({"update_mask", request.update_mask()}); + query_params.push_back( + {"validate_only", (request.validate_only() ? "1" : "0")}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + p.set_value( + rest_internal::Patch( + *service, *rest_context, request.cross_site_network_resource(), + false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", *options), + "/", "projects", "/", request.project(), "/", + "global", "/", "crossSiteNetworks", "/", + request.cross_site_network()), + std::move(query_params))); + }, + std::move(p), + service_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +StatusOr +DefaultCrossSiteNetworksRestStub::PatchCrossSiteNetwork( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::cross_site_networks::v1:: + PatchCrossSiteNetworkRequest const& request) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params.push_back({"update_mask", request.update_mask()}); + query_params.push_back( + {"validate_only", (request.validate_only() ? "1" : "0")}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Patch( + *service_, rest_context, request.cross_site_network_resource(), false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "global", "/", + "crossSiteNetworks", "/", request.cross_site_network()), + std::move(query_params)); +} + +future> +DefaultCrossSiteNetworksRestStub::AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto operations, auto request, auto rest_context, + auto options) { + p.set_value( + rest_internal::Get( + *operations, *rest_context, request, false, + absl::StrCat("/compute/", + rest_internal::DetermineApiVersion("v1", *options), + "/projects/", request.project(), + "/global/operations/", request.operation()))); + }, + std::move(p), + operations_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +future DefaultCrossSiteNetworksRestStub::AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) { + promise> p; + future> f = p.get_future(); + std::thread t{ + [](auto p, auto operations, auto request, auto rest_context, + auto options) { + p.set_value(rest_internal::Post( + *operations, *rest_context, request, false, + absl::StrCat("/compute/", + rest_internal::DetermineApiVersion("v1", *options), + "/projects/", request.project(), "/global/operations/", + request.operation()))); + }, + std::move(p), + operations_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get().status(); + }); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_cross_site_networks_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_rest_stub.h b/google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_rest_stub.h new file mode 100644 index 0000000000000..99f7ec461d866 --- /dev/null +++ b/google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_rest_stub.h @@ -0,0 +1,202 @@ +// Copyright 2026 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. +// source: google/cloud/compute/cross_site_networks/v1/cross_site_networks.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_CROSS_SITE_NETWORKS_V1_INTERNAL_CROSS_SITE_NETWORKS_REST_STUB_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_CROSS_SITE_NETWORKS_V1_INTERNAL_CROSS_SITE_NETWORKS_REST_STUB_H + +#include "google/cloud/compute/cross_site_networks/v1/cross_site_networks.pb.h" +#include "google/cloud/compute/global_operations/v1/global_operations.pb.h" +#include "google/cloud/completion_queue.h" +#include "google/cloud/internal/rest_client.h" +#include "google/cloud/internal/rest_context.h" +#include "google/cloud/status_or.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_cross_site_networks_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class CrossSiteNetworksRestStub { + public: + virtual ~CrossSiteNetworksRestStub() = default; + + virtual future> + AsyncDeleteCrossSiteNetwork( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::cross_site_networks::v1:: + DeleteCrossSiteNetworkRequest const& request) = 0; + + virtual StatusOr + DeleteCrossSiteNetwork( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::cross_site_networks::v1:: + DeleteCrossSiteNetworkRequest const& request) = 0; + + virtual StatusOr + GetCrossSiteNetwork(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::cross_site_networks::v1:: + GetCrossSiteNetworkRequest const& request) = 0; + + virtual future> + AsyncInsertCrossSiteNetwork( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::cross_site_networks::v1:: + InsertCrossSiteNetworkRequest const& request) = 0; + + virtual StatusOr + InsertCrossSiteNetwork( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::cross_site_networks::v1:: + InsertCrossSiteNetworkRequest const& request) = 0; + + virtual StatusOr + ListCrossSiteNetworks(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::cross_site_networks::v1:: + ListCrossSiteNetworksRequest const& request) = 0; + + virtual future> + AsyncPatchCrossSiteNetwork( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::cross_site_networks::v1:: + PatchCrossSiteNetworkRequest const& request) = 0; + + virtual StatusOr + PatchCrossSiteNetwork(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::cross_site_networks::v1:: + PatchCrossSiteNetworkRequest const& request) = 0; + + virtual future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) = 0; + + virtual future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) = 0; +}; + +class DefaultCrossSiteNetworksRestStub : public CrossSiteNetworksRestStub { + public: + ~DefaultCrossSiteNetworksRestStub() override = default; + + explicit DefaultCrossSiteNetworksRestStub(Options options); + DefaultCrossSiteNetworksRestStub( + std::shared_ptr service, + std::shared_ptr operations, Options options); + + future> + AsyncDeleteCrossSiteNetwork( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::cross_site_networks::v1:: + DeleteCrossSiteNetworkRequest const& request) override; + + StatusOr DeleteCrossSiteNetwork( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::cross_site_networks::v1:: + DeleteCrossSiteNetworkRequest const& request) override; + + StatusOr + GetCrossSiteNetwork(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::cross_site_networks::v1:: + GetCrossSiteNetworkRequest const& request) override; + + future> + AsyncInsertCrossSiteNetwork( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::cross_site_networks::v1:: + InsertCrossSiteNetworkRequest const& request) override; + + StatusOr InsertCrossSiteNetwork( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::cross_site_networks::v1:: + InsertCrossSiteNetworkRequest const& request) override; + + StatusOr + ListCrossSiteNetworks( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::cross_site_networks::v1:: + ListCrossSiteNetworksRequest const& request) override; + + future> + AsyncPatchCrossSiteNetwork( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::cross_site_networks::v1:: + PatchCrossSiteNetworkRequest const& request) override; + + StatusOr PatchCrossSiteNetwork( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::cross_site_networks::v1:: + PatchCrossSiteNetworkRequest const& request) override; + + future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) override; + + future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) override; + + private: + std::shared_ptr service_; + std::shared_ptr operations_; + Options options_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_cross_site_networks_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_CROSS_SITE_NETWORKS_V1_INTERNAL_CROSS_SITE_NETWORKS_REST_STUB_H diff --git a/google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_rest_stub_factory.cc b/google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_rest_stub_factory.cc new file mode 100644 index 0000000000000..eacc009d7f11a --- /dev/null +++ b/google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_rest_stub_factory.cc @@ -0,0 +1,56 @@ +// Copyright 2026 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. +// source: google/cloud/compute/cross_site_networks/v1/cross_site_networks.proto + +#include "google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_rest_stub_factory.h" +#include "google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_rest_logging_decorator.h" +#include "google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_rest_metadata_decorator.h" +#include "google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_rest_stub.h" +#include "google/cloud/common_options.h" +#include "google/cloud/internal/algorithm.h" +#include "google/cloud/internal/populate_rest_options.h" +#include "google/cloud/log.h" +#include "google/cloud/options.h" +#include "google/cloud/rest_options.h" +#include "absl/strings/match.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_cross_site_networks_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +std::shared_ptr +CreateDefaultCrossSiteNetworksRestStub(Options const& options) { + auto opts = internal::PopulateRestOptions(options); + std::shared_ptr stub = + std::make_shared(std::move(opts)); + stub = std::make_shared(std::move(stub)); + if (internal::Contains(options.get(), "rpc")) { + GCP_LOG(INFO) << "Enabled logging for REST rpc calls"; + stub = std::make_shared( + std::move(stub), options.get(), + options.get()); + } + return stub; +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_cross_site_networks_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_rest_stub_factory.h b/google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_rest_stub_factory.h new file mode 100644 index 0000000000000..3a977b1359ba4 --- /dev/null +++ b/google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_rest_stub_factory.h @@ -0,0 +1,40 @@ +// Copyright 2026 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. +// source: google/cloud/compute/cross_site_networks/v1/cross_site_networks.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_CROSS_SITE_NETWORKS_V1_INTERNAL_CROSS_SITE_NETWORKS_REST_STUB_FACTORY_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_CROSS_SITE_NETWORKS_V1_INTERNAL_CROSS_SITE_NETWORKS_REST_STUB_FACTORY_H + +#include "google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_rest_stub.h" +#include "google/cloud/options.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_cross_site_networks_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +std::shared_ptr +CreateDefaultCrossSiteNetworksRestStub(Options const& options); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_cross_site_networks_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_CROSS_SITE_NETWORKS_V1_INTERNAL_CROSS_SITE_NETWORKS_REST_STUB_FACTORY_H diff --git a/google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_retry_traits.h b/google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_retry_traits.h new file mode 100644 index 0000000000000..569084bae56d5 --- /dev/null +++ b/google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_retry_traits.h @@ -0,0 +1,43 @@ +// Copyright 2026 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. +// source: google/cloud/compute/cross_site_networks/v1/cross_site_networks.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_CROSS_SITE_NETWORKS_V1_INTERNAL_CROSS_SITE_NETWORKS_RETRY_TRAITS_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_CROSS_SITE_NETWORKS_V1_INTERNAL_CROSS_SITE_NETWORKS_RETRY_TRAITS_H + +#include "google/cloud/status.h" +#include "google/cloud/version.h" + +namespace google { +namespace cloud { +namespace compute_cross_site_networks_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/// Define the gRPC status code semantics for retrying requests. +struct CrossSiteNetworksRetryTraits { + static bool IsPermanentFailure(google::cloud::Status const& status) { + return status.code() != StatusCode::kOk && + status.code() != StatusCode::kUnavailable; + } +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_cross_site_networks_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_CROSS_SITE_NETWORKS_V1_INTERNAL_CROSS_SITE_NETWORKS_RETRY_TRAITS_H diff --git a/google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_sources.cc b/google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_sources.cc new file mode 100644 index 0000000000000..7a63a74647155 --- /dev/null +++ b/google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_sources.cc @@ -0,0 +1,31 @@ +// Copyright 2026 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. +// source: google/cloud/compute/cross_site_networks/v1/cross_site_networks.proto + +// NOLINTBEGIN(bugprone-suspicious-include) +#include "google/cloud/compute/cross_site_networks/v1/cross_site_networks_client.cc" +#include "google/cloud/compute/cross_site_networks/v1/cross_site_networks_connection.cc" +#include "google/cloud/compute/cross_site_networks/v1/cross_site_networks_connection_idempotency_policy.cc" +#include "google/cloud/compute/cross_site_networks/v1/cross_site_networks_rest_connection.cc" +#include "google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_option_defaults.cc" +#include "google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_rest_connection_impl.cc" +#include "google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_rest_logging_decorator.cc" +#include "google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_rest_metadata_decorator.cc" +#include "google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_rest_stub.cc" +#include "google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_rest_stub_factory.cc" +#include "google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_tracing_connection.cc" +// NOLINTEND(bugprone-suspicious-include) diff --git a/google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_tracing_connection.cc b/google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_tracing_connection.cc new file mode 100644 index 0000000000000..706f23bd8e5da --- /dev/null +++ b/google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_tracing_connection.cc @@ -0,0 +1,179 @@ +// Copyright 2026 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. +// source: google/cloud/compute/cross_site_networks/v1/cross_site_networks.proto + +#include "google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_tracing_connection.h" +#include "google/cloud/internal/opentelemetry.h" +#include "google/cloud/internal/traced_stream_range.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_cross_site_networks_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +CrossSiteNetworksTracingConnection::CrossSiteNetworksTracingConnection( + std::shared_ptr + child) + : child_(std::move(child)) {} + +future> +CrossSiteNetworksTracingConnection::DeleteCrossSiteNetwork( + google::cloud::cpp::compute::cross_site_networks::v1:: + DeleteCrossSiteNetworkRequest const& request) { + auto span = internal::MakeSpan( + "compute_cross_site_networks_v1::CrossSiteNetworksConnection::" + "DeleteCrossSiteNetwork"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), + child_->DeleteCrossSiteNetwork(request)); +} + +StatusOr +CrossSiteNetworksTracingConnection::DeleteCrossSiteNetwork( + NoAwaitTag, google::cloud::cpp::compute::cross_site_networks::v1:: + DeleteCrossSiteNetworkRequest const& request) { + auto span = internal::MakeSpan( + "compute_cross_site_networks_v1::CrossSiteNetworksConnection::" + "DeleteCrossSiteNetwork"); + opentelemetry::trace::Scope scope(span); + return internal::EndSpan( + *span, child_->DeleteCrossSiteNetwork(NoAwaitTag{}, request)); +} + +future> +CrossSiteNetworksTracingConnection::DeleteCrossSiteNetwork( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto span = internal::MakeSpan( + "compute_cross_site_networks_v1::CrossSiteNetworksConnection::" + "DeleteCrossSiteNetwork"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), + child_->DeleteCrossSiteNetwork(operation)); +} + +StatusOr +CrossSiteNetworksTracingConnection::GetCrossSiteNetwork( + google::cloud::cpp::compute::cross_site_networks::v1:: + GetCrossSiteNetworkRequest const& request) { + auto span = internal::MakeSpan( + "compute_cross_site_networks_v1::CrossSiteNetworksConnection::" + "GetCrossSiteNetwork"); + auto scope = opentelemetry::trace::Scope(span); + return internal::EndSpan(*span, child_->GetCrossSiteNetwork(request)); +} + +future> +CrossSiteNetworksTracingConnection::InsertCrossSiteNetwork( + google::cloud::cpp::compute::cross_site_networks::v1:: + InsertCrossSiteNetworkRequest const& request) { + auto span = internal::MakeSpan( + "compute_cross_site_networks_v1::CrossSiteNetworksConnection::" + "InsertCrossSiteNetwork"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), + child_->InsertCrossSiteNetwork(request)); +} + +StatusOr +CrossSiteNetworksTracingConnection::InsertCrossSiteNetwork( + NoAwaitTag, google::cloud::cpp::compute::cross_site_networks::v1:: + InsertCrossSiteNetworkRequest const& request) { + auto span = internal::MakeSpan( + "compute_cross_site_networks_v1::CrossSiteNetworksConnection::" + "InsertCrossSiteNetwork"); + opentelemetry::trace::Scope scope(span); + return internal::EndSpan( + *span, child_->InsertCrossSiteNetwork(NoAwaitTag{}, request)); +} + +future> +CrossSiteNetworksTracingConnection::InsertCrossSiteNetwork( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto span = internal::MakeSpan( + "compute_cross_site_networks_v1::CrossSiteNetworksConnection::" + "InsertCrossSiteNetwork"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), + child_->InsertCrossSiteNetwork(operation)); +} + +StreamRange +CrossSiteNetworksTracingConnection::ListCrossSiteNetworks( + google::cloud::cpp::compute::cross_site_networks::v1:: + ListCrossSiteNetworksRequest request) { + auto span = internal::MakeSpan( + "compute_cross_site_networks_v1::CrossSiteNetworksConnection::" + "ListCrossSiteNetworks"); + internal::OTelScope scope(span); + auto sr = child_->ListCrossSiteNetworks(std::move(request)); + return internal::MakeTracedStreamRange< + google::cloud::cpp::compute::v1::CrossSiteNetwork>(std::move(span), + std::move(sr)); +} + +future> +CrossSiteNetworksTracingConnection::PatchCrossSiteNetwork( + google::cloud::cpp::compute::cross_site_networks::v1:: + PatchCrossSiteNetworkRequest const& request) { + auto span = internal::MakeSpan( + "compute_cross_site_networks_v1::CrossSiteNetworksConnection::" + "PatchCrossSiteNetwork"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), + child_->PatchCrossSiteNetwork(request)); +} + +StatusOr +CrossSiteNetworksTracingConnection::PatchCrossSiteNetwork( + NoAwaitTag, google::cloud::cpp::compute::cross_site_networks::v1:: + PatchCrossSiteNetworkRequest const& request) { + auto span = internal::MakeSpan( + "compute_cross_site_networks_v1::CrossSiteNetworksConnection::" + "PatchCrossSiteNetwork"); + opentelemetry::trace::Scope scope(span); + return internal::EndSpan( + *span, child_->PatchCrossSiteNetwork(NoAwaitTag{}, request)); +} + +future> +CrossSiteNetworksTracingConnection::PatchCrossSiteNetwork( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto span = internal::MakeSpan( + "compute_cross_site_networks_v1::CrossSiteNetworksConnection::" + "PatchCrossSiteNetwork"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), + child_->PatchCrossSiteNetwork(operation)); +} + +std::shared_ptr +MakeCrossSiteNetworksTracingConnection( + std::shared_ptr + conn) { + if (internal::TracingEnabled(conn->options())) { + conn = + std::make_shared(std::move(conn)); + } + return conn; +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_cross_site_networks_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_tracing_connection.h b/google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_tracing_connection.h new file mode 100644 index 0000000000000..5b43653b2ae92 --- /dev/null +++ b/google/cloud/compute/cross_site_networks/v1/internal/cross_site_networks_tracing_connection.h @@ -0,0 +1,111 @@ +// Copyright 2026 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. +// source: google/cloud/compute/cross_site_networks/v1/cross_site_networks.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_CROSS_SITE_NETWORKS_V1_INTERNAL_CROSS_SITE_NETWORKS_TRACING_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_CROSS_SITE_NETWORKS_V1_INTERNAL_CROSS_SITE_NETWORKS_TRACING_CONNECTION_H + +#include "google/cloud/compute/cross_site_networks/v1/cross_site_networks_connection.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_cross_site_networks_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class CrossSiteNetworksTracingConnection + : public compute_cross_site_networks_v1::CrossSiteNetworksConnection { + public: + ~CrossSiteNetworksTracingConnection() override = default; + + explicit CrossSiteNetworksTracingConnection( + std::shared_ptr< + compute_cross_site_networks_v1::CrossSiteNetworksConnection> + child); + + Options options() override { return child_->options(); } + + future> + DeleteCrossSiteNetwork( + google::cloud::cpp::compute::cross_site_networks::v1:: + DeleteCrossSiteNetworkRequest const& request) override; + + StatusOr DeleteCrossSiteNetwork( + NoAwaitTag, google::cloud::cpp::compute::cross_site_networks::v1:: + DeleteCrossSiteNetworkRequest const& request) override; + + future> + DeleteCrossSiteNetwork( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + StatusOr + GetCrossSiteNetwork(google::cloud::cpp::compute::cross_site_networks::v1:: + GetCrossSiteNetworkRequest const& request) override; + + future> + InsertCrossSiteNetwork( + google::cloud::cpp::compute::cross_site_networks::v1:: + InsertCrossSiteNetworkRequest const& request) override; + + StatusOr InsertCrossSiteNetwork( + NoAwaitTag, google::cloud::cpp::compute::cross_site_networks::v1:: + InsertCrossSiteNetworkRequest const& request) override; + + future> + InsertCrossSiteNetwork( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + StreamRange + ListCrossSiteNetworks(google::cloud::cpp::compute::cross_site_networks::v1:: + ListCrossSiteNetworksRequest request) override; + + future> + PatchCrossSiteNetwork( + google::cloud::cpp::compute::cross_site_networks::v1:: + PatchCrossSiteNetworkRequest const& request) override; + + StatusOr PatchCrossSiteNetwork( + NoAwaitTag, google::cloud::cpp::compute::cross_site_networks::v1:: + PatchCrossSiteNetworkRequest const& request) override; + + future> + PatchCrossSiteNetwork( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + private: + std::shared_ptr + child_; +}; + +/** + * Conditionally applies the tracing decorator to the given connection. + * + * The connection is only decorated if tracing is enabled (as determined by the + * connection's options). + */ +std::shared_ptr +MakeCrossSiteNetworksTracingConnection( + std::shared_ptr + conn); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_cross_site_networks_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_CROSS_SITE_NETWORKS_V1_INTERNAL_CROSS_SITE_NETWORKS_TRACING_CONNECTION_H diff --git a/google/cloud/compute/cross_site_networks/v1/mocks/mock_cross_site_networks_connection.h b/google/cloud/compute/cross_site_networks/v1/mocks/mock_cross_site_networks_connection.h new file mode 100644 index 0000000000000..e9e98c2eaca97 --- /dev/null +++ b/google/cloud/compute/cross_site_networks/v1/mocks/mock_cross_site_networks_connection.h @@ -0,0 +1,193 @@ +// Copyright 2026 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. +// source: google/cloud/compute/cross_site_networks/v1/cross_site_networks.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_CROSS_SITE_NETWORKS_V1_MOCKS_MOCK_CROSS_SITE_NETWORKS_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_CROSS_SITE_NETWORKS_V1_MOCKS_MOCK_CROSS_SITE_NETWORKS_CONNECTION_H + +#include "google/cloud/compute/cross_site_networks/v1/cross_site_networks_connection.h" +#include + +namespace google { +namespace cloud { +namespace compute_cross_site_networks_v1_mocks { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/** + * A class to mock `CrossSiteNetworksConnection`. + * + * Application developers may want to test their code with simulated responses, + * including errors, from an object of type `CrossSiteNetworksClient`. To do so, + * construct an object of type `CrossSiteNetworksClient` with an instance of + * this class. Then use the Google Test framework functions to program the + * behavior of this mock. + * + * @see [This example][bq-mock] for how to test your application with GoogleTest. + * While the example showcases types from the BigQuery library, the underlying + * principles apply for any pair of `*Client` and `*Connection`. + * + * [bq-mock]: @cloud_cpp_docs_link{bigquery,bigquery-read-mock} + */ +class MockCrossSiteNetworksConnection + : public compute_cross_site_networks_v1::CrossSiteNetworksConnection { + public: + MOCK_METHOD(Options, options, (), (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// DeleteCrossSiteNetwork(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + DeleteCrossSiteNetwork, + (google::cloud::cpp::compute::cross_site_networks::v1:: + DeleteCrossSiteNetworkRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// EXPECT_CALL(*mock, DeleteCrossSiteNetwork(_, _)) + /// @endcode + MOCK_METHOD(StatusOr, + DeleteCrossSiteNetwork, + (NoAwaitTag, + google::cloud::cpp::compute::cross_site_networks::v1:: + DeleteCrossSiteNetworkRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// DeleteCrossSiteNetwork(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + DeleteCrossSiteNetwork, + (google::cloud::cpp::compute::v1::Operation const& operation), + (override)); + + MOCK_METHOD(StatusOr, + GetCrossSiteNetwork, + (google::cloud::cpp::compute::cross_site_networks::v1:: + GetCrossSiteNetworkRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// InsertCrossSiteNetwork(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + InsertCrossSiteNetwork, + (google::cloud::cpp::compute::cross_site_networks::v1:: + InsertCrossSiteNetworkRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// EXPECT_CALL(*mock, InsertCrossSiteNetwork(_, _)) + /// @endcode + MOCK_METHOD(StatusOr, + InsertCrossSiteNetwork, + (NoAwaitTag, + google::cloud::cpp::compute::cross_site_networks::v1:: + InsertCrossSiteNetworkRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// InsertCrossSiteNetwork(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + InsertCrossSiteNetwork, + (google::cloud::cpp::compute::v1::Operation const& operation), + (override)); + + MOCK_METHOD((StreamRange), + ListCrossSiteNetworks, + (google::cloud::cpp::compute::cross_site_networks::v1:: + ListCrossSiteNetworksRequest request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// PatchCrossSiteNetwork(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + PatchCrossSiteNetwork, + (google::cloud::cpp::compute::cross_site_networks::v1:: + PatchCrossSiteNetworkRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// EXPECT_CALL(*mock, PatchCrossSiteNetwork(_, _)) + /// @endcode + MOCK_METHOD(StatusOr, + PatchCrossSiteNetwork, + (NoAwaitTag, google::cloud::cpp::compute::cross_site_networks:: + v1::PatchCrossSiteNetworkRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// PatchCrossSiteNetwork(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + PatchCrossSiteNetwork, + (google::cloud::cpp::compute::v1::Operation const& operation), + (override)); +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_cross_site_networks_v1_mocks +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_CROSS_SITE_NETWORKS_V1_MOCKS_MOCK_CROSS_SITE_NETWORKS_CONNECTION_H diff --git a/google/cloud/compute/cross_site_networks/v1/samples/cross_site_networks_client_samples.cc b/google/cloud/compute/cross_site_networks/v1/samples/cross_site_networks_client_samples.cc new file mode 100644 index 0000000000000..77bf8965581fd --- /dev/null +++ b/google/cloud/compute/cross_site_networks/v1/samples/cross_site_networks_client_samples.cc @@ -0,0 +1,246 @@ +// Copyright 2026 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. +// source: google/cloud/compute/cross_site_networks/v1/cross_site_networks.proto + +#include "google/cloud/compute/cross_site_networks/v1/cross_site_networks_client.h" +#include "google/cloud/compute/cross_site_networks/v1/cross_site_networks_connection_idempotency_policy.h" +#include "google/cloud/compute/cross_site_networks/v1/cross_site_networks_options.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/internal/getenv.h" +#include "google/cloud/polling_policy.h" +#include "google/cloud/testing_util/example_driver.h" +#include "google/cloud/universe_domain.h" +#include +#include +#include +#include + +// clang-format off +// main-dox-marker: compute_cross_site_networks_v1::CrossSiteNetworksClient +// lro-marker: true +// clang-format on +namespace { + +void SetClientEndpoint(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-endpoint"}; + } + //! [set-client-endpoint] + // This configuration is common with Private Google Access: + // https://cloud.google.com/vpc/docs/private-google-access + auto options = google::cloud::Options{}.set( + "private.googleapis.com"); + auto vpc_client = + google::cloud::compute_cross_site_networks_v1::CrossSiteNetworksClient( + google::cloud::compute_cross_site_networks_v1:: + MakeCrossSiteNetworksConnectionRest(options)); + //! [set-client-endpoint] +} + +void SetClientUniverseDomain(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-universe-domain"}; + } + //! [set-client-universe-domain] + google::cloud::Options options; + + // AddUniverseDomainOption interrogates the UnifiedCredentialsOption, if set, + // in the provided Options for the Universe Domain associated with the + // credentials and adds it to the set of Options. + // If no UnifiedCredentialsOption is set, GoogleDefaultCredentials are used. + auto ud_options = google::cloud::AddUniverseDomainOption(std::move(options)); + + if (!ud_options.ok()) throw std::move(ud_options).status(); + auto ud_client = + google::cloud::compute_cross_site_networks_v1::CrossSiteNetworksClient( + google::cloud::compute_cross_site_networks_v1:: + MakeCrossSiteNetworksConnectionRest(*ud_options)); + //! [set-client-universe-domain] +} + +//! [custom-idempotency-policy] +class CustomIdempotencyPolicy + : public google::cloud::compute_cross_site_networks_v1:: + CrossSiteNetworksConnectionIdempotencyPolicy { + public: + ~CustomIdempotencyPolicy() override = default; + std::unique_ptr + clone() const override { + return std::make_unique(*this); + } + // Override inherited functions to define as needed. +}; +//! [custom-idempotency-policy] + +void SetRetryPolicy(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-retry-policy"}; + } + //! [set-retry-policy] + auto options = + google::cloud::Options{} + .set( + CustomIdempotencyPolicy().clone()) + .set( + google::cloud::compute_cross_site_networks_v1:: + CrossSiteNetworksLimitedErrorCountRetryPolicy(3) + .clone()) + .set( + google::cloud::ExponentialBackoffPolicy( + /*initial_delay=*/std::chrono::milliseconds(200), + /*maximum_delay=*/std::chrono::seconds(45), + /*scaling=*/2.0) + .clone()); + auto connection = google::cloud::compute_cross_site_networks_v1:: + MakeCrossSiteNetworksConnectionRest(options); + + // c1 and c2 share the same retry policies + auto c1 = + google::cloud::compute_cross_site_networks_v1::CrossSiteNetworksClient( + connection); + auto c2 = + google::cloud::compute_cross_site_networks_v1::CrossSiteNetworksClient( + connection); + + // You can override any of the policies in a new client. This new client + // will share the policies from c1 (or c2) *except* for the retry policy. + auto c3 = + google::cloud::compute_cross_site_networks_v1::CrossSiteNetworksClient( + connection, google::cloud::Options{} + .set( + google::cloud::compute_cross_site_networks_v1:: + CrossSiteNetworksLimitedTimeRetryPolicy( + std::chrono::minutes(5)) + .clone())); + + // You can also override the policies in a single call: + // c3.SomeRpc(..., google::cloud::Options{} + // .set( + // google::cloud::compute_cross_site_networks_v1::CrossSiteNetworksLimitedErrorCountRetryPolicy(10).clone())); + //! [set-retry-policy] +} + +void SetPollingPolicy(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-policy-policy"}; + } + //! [set-polling-policy] + + // The polling policy controls how the client waits for long-running + // operations. `GenericPollingPolicy<>` combines existing policies. + // In this case, keep polling until the operation completes (with success + // or error) or 45 minutes, whichever happens first. Initially pause for + // 10 seconds between polling requests, increasing the pause by a factor + // of 4 until it becomes 2 minutes. + auto options = + google::cloud::Options{} + .set( + google::cloud::GenericPollingPolicy< + google::cloud::compute_cross_site_networks_v1:: + CrossSiteNetworksRetryPolicyOption::Type, + google::cloud::compute_cross_site_networks_v1:: + CrossSiteNetworksBackoffPolicyOption::Type>( + google::cloud::compute_cross_site_networks_v1:: + CrossSiteNetworksLimitedTimeRetryPolicy( + /*maximum_duration=*/std::chrono::minutes(45)) + .clone(), + google::cloud::ExponentialBackoffPolicy( + /*initial_delay=*/std::chrono::seconds(10), + /*maximum_delay=*/std::chrono::minutes(2), + /*scaling=*/4.0) + .clone()) + .clone()); + + auto connection = google::cloud::compute_cross_site_networks_v1:: + MakeCrossSiteNetworksConnectionRest(options); + + // c1 and c2 share the same polling policies. + auto c1 = + google::cloud::compute_cross_site_networks_v1::CrossSiteNetworksClient( + connection); + auto c2 = + google::cloud::compute_cross_site_networks_v1::CrossSiteNetworksClient( + connection); + //! [set-polling-policy] +} + +void WithServiceAccount(std::vector const& argv) { + if (argv.size() != 1 || argv[0] == "--help") { + throw google::cloud::testing_util::Usage{"with-service-account "}; + } + //! [with-service-account] + [](std::string const& keyfile) { + auto is = std::ifstream(keyfile); + is.exceptions(std::ios::badbit); // Minimal error handling in examples + auto contents = std::string(std::istreambuf_iterator(is.rdbuf()), {}); + auto options = + google::cloud::Options{}.set( + google::cloud::MakeServiceAccountCredentials(contents)); + return google::cloud::compute_cross_site_networks_v1:: + CrossSiteNetworksClient( + google::cloud::compute_cross_site_networks_v1:: + MakeCrossSiteNetworksConnectionRest(options)); + } + //! [with-service-account] + (argv.at(0)); +} + +void AutoRun(std::vector const& argv) { + namespace examples = ::google::cloud::testing_util; + using ::google::cloud::internal::GetEnv; + if (!argv.empty()) throw examples::Usage{"auto"}; + examples::CheckEnvironmentVariablesAreSet( + {"GOOGLE_CLOUD_CPP_TEST_SERVICE_ACCOUNT_KEYFILE"}); + auto const keyfile = + GetEnv("GOOGLE_CLOUD_CPP_TEST_SERVICE_ACCOUNT_KEYFILE").value(); + + std::cout << "\nRunning SetClientEndpoint() example" << std::endl; + SetClientEndpoint({}); + + std::cout << "\nRunning SetRetryPolicy() example" << std::endl; + SetRetryPolicy({}); + + std::cout << "\nRunning SetPollingPolicy() example" << std::endl; + SetPollingPolicy({}); + + std::cout << "\nRunning WithServiceAccount() example" << std::endl; + WithServiceAccount({keyfile}); + + std::cout << "\nRunning SetClientUniverseDomain() example" << std::endl; + SetClientUniverseDomain({}); +} + +} // namespace + +int main(int argc, char* argv[]) { // NOLINT(bugprone-exception-escape) + google::cloud::testing_util::Example example({ + {"set-client-endpoint", SetClientEndpoint}, + {"set-retry-policy", SetRetryPolicy}, + {"set-polling-policy", SetPollingPolicy}, + {"with-service-account", WithServiceAccount}, + {"set-client-universe-domain", SetClientUniverseDomain}, + {"auto", AutoRun}, + }); + return example.Run(argc, argv); +} 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 f4e86b0f8507d..bb665979466a3 100644 --- a/google/cloud/compute/disk_types/v1/disk_types_client.h +++ b/google/cloud/compute/disk_types/v1/disk_types_client.h @@ -87,8 +87,10 @@ class DiskTypesClient { // clang-format off /// - /// Retrieves an aggregated list of disk types. To prevent failure, Google - /// recommends that you set the `returnPartialSuccess` parameter to `true`. + /// Retrieves an aggregated list of disk types. + /// + /// To prevent failure, it is recommended that you set the + /// `returnPartialSuccess` parameter to `true`. /// https://cloud.google.com/compute/docs/reference/rest/v1/diskTypes/aggregatedList /// /// @param project Project ID for this request. @@ -114,8 +116,8 @@ class DiskTypesClient { /// [`future`]: @ref google::cloud::future /// [`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_027.proto#L244} + /// [google.cloud.cpp.compute.disk_types.v1.AggregatedListDiskTypesRequest]: @cloud_cpp_reference_link{google/cloud/compute/disk_types/v1/disk_types.proto#L75} + /// [google.cloud.cpp.compute.v1.DiskTypesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_036.proto#L288} /// // clang-format on StreamRange GetDiskType( @@ -219,8 +223,8 @@ class DiskTypesClient { /// [`future`]: @ref google::cloud::future /// [`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_026.proto#L34} + /// [google.cloud.cpp.compute.disk_types.v1.GetDiskTypeRequest]: @cloud_cpp_reference_link{google/cloud/compute/disk_types/v1/disk_types.proto#L190} + /// [google.cloud.cpp.compute.v1.DiskType]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_035.proto#L44} /// // clang-format on StatusOr GetDiskType( @@ -230,7 +234,8 @@ class DiskTypesClient { // clang-format off /// - /// Retrieves a list of disk types available to the specified project. + /// Retrieves a list of disk types available to the specified + /// project. /// https://cloud.google.com/compute/docs/reference/rest/v1/diskTypes/list /// /// @param project Project ID for this request. @@ -257,8 +262,8 @@ class DiskTypesClient { /// [`future`]: @ref google::cloud::future /// [`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_026.proto#L34} + /// [google.cloud.cpp.compute.disk_types.v1.ListDiskTypesRequest]: @cloud_cpp_reference_link{google/cloud/compute/disk_types/v1/disk_types.proto#L204} + /// [google.cloud.cpp.compute.v1.DiskType]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_035.proto#L44} /// // clang-format on StreamRange ListDiskTypes( @@ -266,7 +271,8 @@ class DiskTypesClient { // clang-format off /// - /// Retrieves a list of disk types available to the specified project. + /// Retrieves a list of disk types available to the specified + /// project. /// https://cloud.google.com/compute/docs/reference/rest/v1/diskTypes/list /// /// @param request Unary RPCs, such as the one wrapped by this @@ -297,8 +303,8 @@ class DiskTypesClient { /// [`future`]: @ref google::cloud::future /// [`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_026.proto#L34} + /// [google.cloud.cpp.compute.disk_types.v1.ListDiskTypesRequest]: @cloud_cpp_reference_link{google/cloud/compute/disk_types/v1/disk_types.proto#L204} + /// [google.cloud.cpp.compute.v1.DiskType]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_035.proto#L44} /// // 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 4e6922ebcda89..a6fae40f6e7dc 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 "google/cloud/compute/v1/internal/common_023.pb.h" -#include "google/cloud/compute/v1/internal/common_026.pb.h" -#include "google/cloud/compute/v1/internal/common_027.pb.h" +#include "google/cloud/compute/v1/internal/common_032.pb.h" +#include "google/cloud/compute/v1/internal/common_035.pb.h" +#include "google/cloud/compute/v1/internal/common_036.pb.h" // 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.cc b/google/cloud/compute/disks/v1/disks_client.cc index 999fc83ca84f7..9bc22a350e774 100644 --- a/google/cloud/compute/disks/v1/disks_client.cc +++ b/google/cloud/compute/disks/v1/disks_client.cc @@ -853,6 +853,62 @@ DisksClient::UpdateDisk( return connection_->UpdateDisk(operation); } +future> +DisksClient::UpdateKmsKey( + std::string const& project, std::string const& zone, + std::string const& disk, + google::cloud::cpp::compute::v1::DiskUpdateKmsKeyRequest const& + disk_update_kms_key_request_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::disks::v1::UpdateKmsKeyRequest request; + request.set_project(project); + request.set_zone(zone); + request.set_disk(disk); + *request.mutable_disk_update_kms_key_request_resource() = + disk_update_kms_key_request_resource; + return connection_->UpdateKmsKey(request); +} + +StatusOr DisksClient::UpdateKmsKey( + NoAwaitTag, std::string const& project, std::string const& zone, + std::string const& disk, + google::cloud::cpp::compute::v1::DiskUpdateKmsKeyRequest const& + disk_update_kms_key_request_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::disks::v1::UpdateKmsKeyRequest request; + request.set_project(project); + request.set_zone(zone); + request.set_disk(disk); + *request.mutable_disk_update_kms_key_request_resource() = + disk_update_kms_key_request_resource; + return connection_->UpdateKmsKey(NoAwaitTag{}, request); +} + +future> +DisksClient::UpdateKmsKey( + google::cloud::cpp::compute::disks::v1::UpdateKmsKeyRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->UpdateKmsKey(request); +} + +StatusOr DisksClient::UpdateKmsKey( + NoAwaitTag, + google::cloud::cpp::compute::disks::v1::UpdateKmsKeyRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->UpdateKmsKey(NoAwaitTag{}, request); +} + +future> +DisksClient::UpdateKmsKey( + google::cloud::cpp::compute::v1::Operation const& operation, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->UpdateKmsKey(operation); +} + GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END } // namespace compute_disks_v1 } // namespace cloud diff --git a/google/cloud/compute/disks/v1/disks_client.h b/google/cloud/compute/disks/v1/disks_client.h index 9900761b35432..646682685d0d4 100644 --- a/google/cloud/compute/disks/v1/disks_client.h +++ b/google/cloud/compute/disks/v1/disks_client.h @@ -88,8 +88,9 @@ class DisksClient { // clang-format off /// - /// Adds existing resource policies to a disk. You can only add one policy - /// which will be applied to this disk for scheduling snapshot creation. + /// Adds existing resource policies to a disk. You can only add one + /// policy which will be applied to this disk for scheduling snapshot + /// creation. /// https://cloud.google.com/compute/docs/reference/rest/v1/disks/addResourcePolicies /// /// @param project Project ID for this request. @@ -116,7 +117,7 @@ class DisksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.disks.v1.AddResourcePoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L297} + /// [google.cloud.cpp.compute.disks.v1.AddResourcePoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L318} /// // clang-format on future> @@ -147,8 +148,9 @@ class DisksClient { // clang-format off /// - /// Adds existing resource policies to a disk. You can only add one policy - /// which will be applied to this disk for scheduling snapshot creation. + /// Adds existing resource policies to a disk. You can only add one + /// policy which will be applied to this disk for scheduling snapshot + /// creation. /// https://cloud.google.com/compute/docs/reference/rest/v1/disks/addResourcePolicies /// /// @param request Unary RPCs, such as the one wrapped by this @@ -177,7 +179,7 @@ class DisksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.disks.v1.AddResourcePoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L297} + /// [google.cloud.cpp.compute.disks.v1.AddResourcePoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L318} /// // clang-format on future> @@ -219,9 +221,10 @@ class DisksClient { // clang-format off /// - /// Retrieves an aggregated list of persistent disks. To prevent failure, - /// Google recommends that you set the `returnPartialSuccess` parameter to - /// `true`. + /// Retrieves an aggregated list of persistent disks. + /// + /// To prevent failure, it is recommended that you set the + /// `returnPartialSuccess` parameter to `true`. /// https://cloud.google.com/compute/docs/reference/rest/v1/disks/aggregatedList /// /// @param project Project ID for this request. @@ -247,8 +250,8 @@ class DisksClient { /// [`future`]: @ref google::cloud::future /// [`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#L334} - /// [google.cloud.cpp.compute.v1.DisksScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_017.proto#L170} + /// [google.cloud.cpp.compute.disks.v1.AggregatedListDisksRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L358} + /// [google.cloud.cpp.compute.v1.DisksScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_020.proto#L210} /// // clang-format on StreamRange< @@ -257,9 +260,10 @@ class DisksClient { // clang-format off /// - /// Retrieves an aggregated list of persistent disks. To prevent failure, - /// Google recommends that you set the `returnPartialSuccess` parameter to - /// `true`. + /// Retrieves an aggregated list of persistent disks. + /// + /// To prevent failure, it is recommended that you set the + /// `returnPartialSuccess` parameter to `true`. /// https://cloud.google.com/compute/docs/reference/rest/v1/disks/aggregatedList /// /// @param request Unary RPCs, such as the one wrapped by this @@ -290,8 +294,8 @@ class DisksClient { /// [`future`]: @ref google::cloud::future /// [`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#L334} - /// [google.cloud.cpp.compute.v1.DisksScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_017.proto#L170} + /// [google.cloud.cpp.compute.disks.v1.AggregatedListDisksRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L358} + /// [google.cloud.cpp.compute.v1.DisksScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_020.proto#L210} /// // clang-format on StreamRange< @@ -329,7 +333,7 @@ class DisksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.disks.v1.BulkInsertRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L416} + /// [google.cloud.cpp.compute.disks.v1.BulkInsertRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L473} /// // clang-format on future> BulkInsert( @@ -386,7 +390,7 @@ class DisksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.disks.v1.BulkInsertRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L416} + /// [google.cloud.cpp.compute.disks.v1.BulkInsertRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L473} /// // clang-format on future> BulkInsert( @@ -424,8 +428,9 @@ class DisksClient { // clang-format off /// - /// Sets the labels on many disks at once. To learn more about labels, read the - /// Labeling Resources documentation. + /// Sets the labels on many disks at once. To learn more about labels, read + /// theLabeling + /// Resources documentation. /// https://cloud.google.com/compute/docs/reference/rest/v1/disks/bulkSetLabels /// /// @param project Project ID for this request. @@ -451,7 +456,7 @@ class DisksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.disks.v1.BulkSetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L449} + /// [google.cloud.cpp.compute.disks.v1.BulkSetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L509} /// // clang-format on future> BulkSetLabels( @@ -479,8 +484,9 @@ class DisksClient { // clang-format off /// - /// Sets the labels on many disks at once. To learn more about labels, read the - /// Labeling Resources documentation. + /// Sets the labels on many disks at once. To learn more about labels, read + /// theLabeling + /// Resources documentation. /// https://cloud.google.com/compute/docs/reference/rest/v1/disks/bulkSetLabels /// /// @param request Unary RPCs, such as the one wrapped by this @@ -509,7 +515,7 @@ class DisksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.disks.v1.BulkSetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L449} + /// [google.cloud.cpp.compute.disks.v1.BulkSetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L509} /// // clang-format on future> BulkSetLabels( @@ -550,9 +556,9 @@ class DisksClient { // clang-format off /// /// 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. + /// 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. /// https://cloud.google.com/compute/docs/reference/rest/v1/disks/createSnapshot /// /// @param project Project ID for this request. @@ -579,7 +585,7 @@ class DisksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.disks.v1.CreateSnapshotRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L486} + /// [google.cloud.cpp.compute.disks.v1.CreateSnapshotRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L549} /// // clang-format on future> CreateSnapshot( @@ -608,9 +614,9 @@ class DisksClient { // clang-format off /// /// 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. + /// 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. /// https://cloud.google.com/compute/docs/reference/rest/v1/disks/createSnapshot /// /// @param request Unary RPCs, such as the one wrapped by this @@ -639,7 +645,7 @@ class DisksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.disks.v1.CreateSnapshotRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L486} + /// [google.cloud.cpp.compute.disks.v1.CreateSnapshotRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L549} /// // clang-format on future> CreateSnapshot( @@ -680,8 +686,9 @@ class DisksClient { // clang-format off /// /// 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 + /// permanently and is irreversible. However, deleting a disk does not + /// delete any snapshots + /// previously made from the disk. You must separatelydelete /// snapshots. /// https://cloud.google.com/compute/docs/reference/rest/v1/disks/delete /// @@ -708,7 +715,7 @@ class DisksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.disks.v1.DeleteDiskRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L526} + /// [google.cloud.cpp.compute.disks.v1.DeleteDiskRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L592} /// // clang-format on future> DeleteDisk( @@ -733,8 +740,9 @@ class DisksClient { // clang-format off /// /// 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 + /// permanently and is irreversible. However, deleting a disk does not + /// delete any snapshots + /// previously made from the disk. You must separatelydelete /// snapshots. /// https://cloud.google.com/compute/docs/reference/rest/v1/disks/delete /// @@ -764,7 +772,7 @@ class DisksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.disks.v1.DeleteDiskRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L526} + /// [google.cloud.cpp.compute.disks.v1.DeleteDiskRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L592} /// // clang-format on future> DeleteDisk( @@ -821,8 +829,8 @@ class DisksClient { /// [`future`]: @ref google::cloud::future /// [`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#L558} - /// [google.cloud.cpp.compute.v1.Disk]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_014.proto#L49} + /// [google.cloud.cpp.compute.disks.v1.GetDiskRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L627} + /// [google.cloud.cpp.compute.v1.Disk]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_017.proto#L75} /// // clang-format on StatusOr GetDisk( @@ -853,8 +861,8 @@ class DisksClient { /// [`future`]: @ref google::cloud::future /// [`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#L558} - /// [google.cloud.cpp.compute.v1.Disk]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_014.proto#L49} + /// [google.cloud.cpp.compute.disks.v1.GetDiskRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L627} + /// [google.cloud.cpp.compute.v1.Disk]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_017.proto#L75} /// // clang-format on StatusOr GetDisk( @@ -883,8 +891,8 @@ class DisksClient { /// [`future`]: @ref google::cloud::future /// [`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#L571} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} + /// [google.cloud.cpp.compute.disks.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L640} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr GetIamPolicy( @@ -916,8 +924,8 @@ class DisksClient { /// [`future`]: @ref google::cloud::future /// [`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#L571} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} + /// [google.cloud.cpp.compute.disks.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L640} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr GetIamPolicy( @@ -927,11 +935,12 @@ class DisksClient { // clang-format off /// - /// 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. + /// Creates a persistent disk in the specified project using the data + /// in the request. You can create a disk from a source + /// (sourceImage, sourceSnapshot, orsourceDisk) 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. /// https://cloud.google.com/compute/docs/reference/rest/v1/disks/insert /// /// @param project Project ID for this request. @@ -957,7 +966,7 @@ class DisksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.disks.v1.InsertDiskRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L589} + /// [google.cloud.cpp.compute.disks.v1.InsertDiskRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L658} /// // clang-format on future> InsertDisk( @@ -983,11 +992,12 @@ class DisksClient { // clang-format off /// - /// 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. + /// Creates a persistent disk in the specified project using the data + /// in the request. You can create a disk from a source + /// (sourceImage, sourceSnapshot, orsourceDisk) 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. /// https://cloud.google.com/compute/docs/reference/rest/v1/disks/insert /// /// @param request Unary RPCs, such as the one wrapped by this @@ -1016,7 +1026,7 @@ class DisksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.disks.v1.InsertDiskRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L589} + /// [google.cloud.cpp.compute.disks.v1.InsertDiskRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L658} /// // clang-format on future> InsertDisk( @@ -1054,7 +1064,8 @@ class DisksClient { // clang-format off /// - /// Retrieves a list of persistent disks contained within the specified zone. + /// Retrieves a list of persistent disks contained within + /// the specified zone. /// https://cloud.google.com/compute/docs/reference/rest/v1/disks/list /// /// @param project Project ID for this request. @@ -1081,8 +1092,8 @@ class DisksClient { /// [`future`]: @ref google::cloud::future /// [`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#L625} - /// [google.cloud.cpp.compute.v1.Disk]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_014.proto#L49} + /// [google.cloud.cpp.compute.disks.v1.ListDisksRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L697} + /// [google.cloud.cpp.compute.v1.Disk]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_017.proto#L75} /// // clang-format on StreamRange ListDisks( @@ -1090,7 +1101,8 @@ class DisksClient { // clang-format off /// - /// Retrieves a list of persistent disks contained within the specified zone. + /// Retrieves a list of persistent disks contained within + /// the specified zone. /// https://cloud.google.com/compute/docs/reference/rest/v1/disks/list /// /// @param request Unary RPCs, such as the one wrapped by this @@ -1121,8 +1133,8 @@ class DisksClient { /// [`future`]: @ref google::cloud::future /// [`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#L625} - /// [google.cloud.cpp.compute.v1.Disk]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_014.proto#L49} + /// [google.cloud.cpp.compute.disks.v1.ListDisksRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L697} + /// [google.cloud.cpp.compute.v1.Disk]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_017.proto#L75} /// // clang-format on StreamRange ListDisks( @@ -1158,7 +1170,7 @@ class DisksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.disks.v1.RemoveResourcePoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L696} + /// [google.cloud.cpp.compute.disks.v1.RemoveResourcePoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L801} /// // clang-format on future> @@ -1218,7 +1230,7 @@ class DisksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.disks.v1.RemoveResourcePoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L696} + /// [google.cloud.cpp.compute.disks.v1.RemoveResourcePoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L801} /// // clang-format on future> @@ -1259,8 +1271,8 @@ class DisksClient { // clang-format off /// - /// Resizes the specified persistent disk. You can only increase the size of - /// the disk. + /// Resizes the specified persistent disk. + /// You can only increase the size of the disk. /// https://cloud.google.com/compute/docs/reference/rest/v1/disks/resize /// /// @param project Project ID for this request. @@ -1287,7 +1299,7 @@ class DisksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.disks.v1.ResizeRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L733} + /// [google.cloud.cpp.compute.disks.v1.ResizeRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L841} /// // clang-format on future> Resize( @@ -1317,8 +1329,8 @@ class DisksClient { // clang-format off /// - /// Resizes the specified persistent disk. You can only increase the size of - /// the disk. + /// Resizes the specified persistent disk. + /// You can only increase the size of the disk. /// https://cloud.google.com/compute/docs/reference/rest/v1/disks/resize /// /// @param request Unary RPCs, such as the one wrapped by this @@ -1347,7 +1359,7 @@ class DisksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.disks.v1.ResizeRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L733} + /// [google.cloud.cpp.compute.disks.v1.ResizeRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L841} /// // clang-format on future> Resize( @@ -1385,8 +1397,8 @@ class DisksClient { // clang-format off /// - /// Sets the access control policy on the specified resource. Replaces any - /// existing policy. + /// Sets the access control policy on the specified resource. + /// Replaces any existing policy. /// https://cloud.google.com/compute/docs/reference/rest/v1/disks/setIamPolicy /// /// @param project Project ID for this request. @@ -1406,8 +1418,8 @@ class DisksClient { /// [`future`]: @ref google::cloud::future /// [`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#L769} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} + /// [google.cloud.cpp.compute.disks.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L880} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr SetIamPolicy( @@ -1419,8 +1431,8 @@ class DisksClient { // clang-format off /// - /// Sets the access control policy on the specified resource. Replaces any - /// existing policy. + /// Sets the access control policy on the specified resource. + /// Replaces any existing policy. /// https://cloud.google.com/compute/docs/reference/rest/v1/disks/setIamPolicy /// /// @param request Unary RPCs, such as the one wrapped by this @@ -1442,8 +1454,8 @@ class DisksClient { /// [`future`]: @ref google::cloud::future /// [`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#L769} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} + /// [google.cloud.cpp.compute.disks.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L880} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr SetIamPolicy( @@ -1453,7 +1465,7 @@ class DisksClient { // clang-format off /// - /// Sets the labels on a disk. To learn more about labels, read the Labeling + /// Sets the labels on a disk. To learn more about labels, read theLabeling /// Resources documentation. /// https://cloud.google.com/compute/docs/reference/rest/v1/disks/setLabels /// @@ -1481,7 +1493,7 @@ class DisksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.disks.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L787} + /// [google.cloud.cpp.compute.disks.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L898} /// // clang-format on future> SetLabels( @@ -1511,7 +1523,7 @@ class DisksClient { // clang-format off /// - /// Sets the labels on a disk. To learn more about labels, read the Labeling + /// Sets the labels on a disk. To learn more about labels, read theLabeling /// Resources documentation. /// https://cloud.google.com/compute/docs/reference/rest/v1/disks/setLabels /// @@ -1541,7 +1553,7 @@ class DisksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.disks.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L787} + /// [google.cloud.cpp.compute.disks.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L898} /// // clang-format on future> SetLabels( @@ -1579,7 +1591,8 @@ class DisksClient { // clang-format off /// - /// Starts asynchronous replication. Must be invoked on the primary disk. + /// Starts asynchronous replication. + /// Must be invoked on the primary disk. /// https://cloud.google.com/compute/docs/reference/rest/v1/disks/startAsyncReplication /// /// @param project Project ID for this request. @@ -1606,7 +1619,7 @@ class DisksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.disks.v1.StartAsyncReplicationRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L824} + /// [google.cloud.cpp.compute.disks.v1.StartAsyncReplicationRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L938} /// // clang-format on future> @@ -1637,7 +1650,8 @@ class DisksClient { // clang-format off /// - /// Starts asynchronous replication. Must be invoked on the primary disk. + /// Starts asynchronous replication. + /// Must be invoked on the primary disk. /// https://cloud.google.com/compute/docs/reference/rest/v1/disks/startAsyncReplication /// /// @param request Unary RPCs, such as the one wrapped by this @@ -1666,7 +1680,7 @@ class DisksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.disks.v1.StartAsyncReplicationRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L824} + /// [google.cloud.cpp.compute.disks.v1.StartAsyncReplicationRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L938} /// // clang-format on future> @@ -1707,8 +1721,8 @@ class DisksClient { // clang-format off /// - /// Stops asynchronous replication. Can be invoked either on the primary or on - /// the secondary disk. + /// Stops asynchronous replication. + /// Can be invoked either on the primary or on the secondary disk. /// https://cloud.google.com/compute/docs/reference/rest/v1/disks/stopAsyncReplication /// /// @param project Project ID for this request. @@ -1734,7 +1748,7 @@ class DisksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.disks.v1.StopAsyncReplicationRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L861} + /// [google.cloud.cpp.compute.disks.v1.StopAsyncReplicationRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L978} /// // clang-format on future> @@ -1758,8 +1772,8 @@ class DisksClient { // clang-format off /// - /// Stops asynchronous replication. Can be invoked either on the primary or on - /// the secondary disk. + /// Stops asynchronous replication. + /// Can be invoked either on the primary or on the secondary disk. /// https://cloud.google.com/compute/docs/reference/rest/v1/disks/stopAsyncReplication /// /// @param request Unary RPCs, such as the one wrapped by this @@ -1788,7 +1802,7 @@ class DisksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.disks.v1.StopAsyncReplicationRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L861} + /// [google.cloud.cpp.compute.disks.v1.StopAsyncReplicationRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L978} /// // clang-format on future> @@ -1830,8 +1844,8 @@ class DisksClient { // clang-format off /// - /// Stops asynchronous replication for a consistency group of disks. Can be - /// invoked either in the primary or secondary scope. + /// Stops asynchronous replication for a consistency group of disks. + /// Can be invoked either in the primary or secondary scope. /// https://cloud.google.com/compute/docs/reference/rest/v1/disks/stopGroupAsyncReplication /// /// @param project Project ID for this request. @@ -1858,7 +1872,7 @@ class DisksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.disks.v1.StopGroupAsyncReplicationRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L893} + /// [google.cloud.cpp.compute.disks.v1.StopGroupAsyncReplicationRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L1013} /// // clang-format on future> @@ -1889,8 +1903,8 @@ class DisksClient { // clang-format off /// - /// Stops asynchronous replication for a consistency group of disks. Can be - /// invoked either in the primary or secondary scope. + /// Stops asynchronous replication for a consistency group of disks. + /// Can be invoked either in the primary or secondary scope. /// https://cloud.google.com/compute/docs/reference/rest/v1/disks/stopGroupAsyncReplication /// /// @param request Unary RPCs, such as the one wrapped by this @@ -1919,7 +1933,7 @@ class DisksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.disks.v1.StopGroupAsyncReplicationRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L893} + /// [google.cloud.cpp.compute.disks.v1.StopGroupAsyncReplicationRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L1013} /// // clang-format on future> @@ -1980,8 +1994,8 @@ class DisksClient { /// [`future`]: @ref google::cloud::future /// [`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#L928} - /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_145.proto#L30} + /// [google.cloud.cpp.compute.disks.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L1051} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} /// // clang-format on StatusOr @@ -2016,8 +2030,8 @@ class DisksClient { /// [`future`]: @ref google::cloud::future /// [`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#L928} - /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_145.proto#L30} + /// [google.cloud.cpp.compute.disks.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L1051} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} /// // clang-format on StatusOr @@ -2028,9 +2042,9 @@ class DisksClient { // clang-format off /// - /// 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. + /// 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. /// https://cloud.google.com/compute/docs/reference/rest/v1/disks/update /// /// @param project Project ID for this request. @@ -2058,7 +2072,7 @@ class DisksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.disks.v1.UpdateDiskRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L946} + /// [google.cloud.cpp.compute.disks.v1.UpdateDiskRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L1069} /// // clang-format on future> UpdateDisk( @@ -2086,9 +2100,9 @@ class DisksClient { // clang-format off /// - /// 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. + /// 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. /// https://cloud.google.com/compute/docs/reference/rest/v1/disks/update /// /// @param request Unary RPCs, such as the one wrapped by this @@ -2117,7 +2131,7 @@ class DisksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.disks.v1.UpdateDiskRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L946} + /// [google.cloud.cpp.compute.disks.v1.UpdateDiskRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L1069} /// // clang-format on future> UpdateDisk( @@ -2153,6 +2167,134 @@ class DisksClient { google::cloud::cpp::compute::v1::Operation const& operation, Options opts = {}); + // clang-format off + /// + /// Rotates the customer-managed + /// encryption key to the latest version for the specified persistent disk. + /// https://cloud.google.com/compute/docs/reference/rest/v1/disks/updateKmsKey + /// + /// @param project Project ID for this request. + /// @param zone The name of the zone for this request. + /// @param disk Name of the Disk resource, should conform to RFC1035. + /// @param disk_update_kms_key_request_resource The DiskUpdateKmsKeyRequest for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.disks.v1.UpdateKmsKeyRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L1113} + /// + // clang-format on + future> UpdateKmsKey( + std::string const& project, std::string const& zone, + std::string const& disk, + google::cloud::cpp::compute::v1::DiskUpdateKmsKeyRequest const& + disk_update_kms_key_request_resource, + Options opts = {}); + + // clang-format off + /// + /// @copybrief UpdateKmsKey + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr UpdateKmsKey( + NoAwaitTag, std::string const& project, std::string const& zone, + std::string const& disk, + google::cloud::cpp::compute::v1::DiskUpdateKmsKeyRequest const& + disk_update_kms_key_request_resource, + Options opts = {}); + + // clang-format off + /// + /// Rotates the customer-managed + /// encryption key to the latest version for the specified persistent disk. + /// https://cloud.google.com/compute/docs/reference/rest/v1/disks/updateKmsKey + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.disks.v1.UpdateKmsKeyRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.disks.v1.UpdateKmsKeyRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L1113} + /// + // clang-format on + future> UpdateKmsKey( + google::cloud::cpp::compute::disks::v1::UpdateKmsKeyRequest const& + request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief UpdateKmsKey + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr UpdateKmsKey( + NoAwaitTag, + google::cloud::cpp::compute::disks::v1::UpdateKmsKeyRequest const& + request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief UpdateKmsKey + /// + /// This method accepts a `google::cloud::cpp::compute::v1::Operation` that corresponds + /// to a previously started Long Running Operation (LRO) and polls the status + /// of the LRO in the background. + /// + // clang-format on + future> UpdateKmsKey( + google::cloud::cpp::compute::v1::Operation const& operation, + Options opts = {}); + private: std::shared_ptr connection_; Options options_; diff --git a/google/cloud/compute/disks/v1/disks_connection.cc b/google/cloud/compute/disks/v1/disks_connection.cc index 9bb6c7435ae0b..a7794e1515735 100644 --- a/google/cloud/compute/disks/v1/disks_connection.cc +++ b/google/cloud/compute/disks/v1/disks_connection.cc @@ -380,6 +380,30 @@ DisksConnection::UpdateDisk(google::cloud::cpp::compute::v1::Operation const&) { Status(StatusCode::kUnimplemented, "not implemented")); } +future> +DisksConnection::UpdateKmsKey( + google::cloud::cpp::compute::disks::v1::UpdateKmsKeyRequest const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +DisksConnection::UpdateKmsKey( + NoAwaitTag, + google::cloud::cpp::compute::disks::v1::UpdateKmsKeyRequest const&) { + return StatusOr( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +DisksConnection::UpdateKmsKey( + google::cloud::cpp::compute::v1::Operation const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END } // namespace compute_disks_v1 } // namespace cloud diff --git a/google/cloud/compute/disks/v1/disks_connection.h b/google/cloud/compute/disks/v1/disks_connection.h index 199caa3e494e2..4643a4ef2e32f 100644 --- a/google/cloud/compute/disks/v1/disks_connection.h +++ b/google/cloud/compute/disks/v1/disks_connection.h @@ -366,6 +366,19 @@ class DisksConnection { virtual future> UpdateDisk(google::cloud::cpp::compute::v1::Operation const& operation); + + virtual future> + UpdateKmsKey( + google::cloud::cpp::compute::disks::v1::UpdateKmsKeyRequest const& + request); + + virtual StatusOr UpdateKmsKey( + NoAwaitTag, + google::cloud::cpp::compute::disks::v1::UpdateKmsKeyRequest const& + request); + + virtual future> + UpdateKmsKey(google::cloud::cpp::compute::v1::Operation const& operation); }; GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END diff --git a/google/cloud/compute/disks/v1/disks_connection_idempotency_policy.cc b/google/cloud/compute/disks/v1/disks_connection_idempotency_policy.cc index 22570441a98a8..d1b3f139ee4af 100644 --- a/google/cloud/compute/disks/v1/disks_connection_idempotency_policy.cc +++ b/google/cloud/compute/disks/v1/disks_connection_idempotency_policy.cc @@ -133,6 +133,11 @@ Idempotency DisksConnectionIdempotencyPolicy::UpdateDisk( return Idempotency::kNonIdempotent; } +Idempotency DisksConnectionIdempotencyPolicy::UpdateKmsKey( + google::cloud::cpp::compute::disks::v1::UpdateKmsKeyRequest const&) { + return Idempotency::kNonIdempotent; +} + std::unique_ptr MakeDefaultDisksConnectionIdempotencyPolicy() { return std::make_unique(); diff --git a/google/cloud/compute/disks/v1/disks_connection_idempotency_policy.h b/google/cloud/compute/disks/v1/disks_connection_idempotency_policy.h index d22799ceb8c5c..5721c66f274b3 100644 --- a/google/cloud/compute/disks/v1/disks_connection_idempotency_policy.h +++ b/google/cloud/compute/disks/v1/disks_connection_idempotency_policy.h @@ -103,6 +103,10 @@ class DisksConnectionIdempotencyPolicy { virtual google::cloud::Idempotency UpdateDisk( google::cloud::cpp::compute::disks::v1::UpdateDiskRequest const& request); + + virtual google::cloud::Idempotency UpdateKmsKey( + google::cloud::cpp::compute::disks::v1::UpdateKmsKeyRequest const& + request); }; std::unique_ptr diff --git a/google/cloud/compute/disks/v1/disks_proto_export.h b/google/cloud/compute/disks/v1/disks_proto_export.h index 4a9a5c623c90b..c102721ed4d65 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 "google/cloud/compute/v1/internal/common_007.pb.h" -#include "google/cloud/compute/v1/internal/common_014.pb.h" -#include "google/cloud/compute/v1/internal/common_016.pb.h" +#include "google/cloud/compute/v1/internal/common_009.pb.h" #include "google/cloud/compute/v1/internal/common_017.pb.h" -#include "google/cloud/compute/v1/internal/common_021.pb.h" -#include "google/cloud/compute/v1/internal/common_031.pb.h" -#include "google/cloud/compute/v1/internal/common_122.pb.h" -#include "google/cloud/compute/v1/internal/common_145.pb.h" -#include "google/cloud/compute/v1/internal/common_151.pb.h" -#include "google/cloud/compute/v1/internal/common_152.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_020.pb.h" +#include "google/cloud/compute/v1/internal/common_028.pb.h" +#include "google/cloud/compute/v1/internal/common_040.pb.h" +#include "google/cloud/compute/v1/internal/common_146.pb.h" +#include "google/cloud/compute/v1/internal/common_171.pb.h" +#include "google/cloud/compute/v1/internal/common_180.pb.h" +#include "google/cloud/compute/v1/internal/common_182.pb.h" // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_DISKS_V1_DISKS_PROTO_EXPORT_H diff --git a/google/cloud/compute/disks/v1/internal/disks_rest_connection_impl.cc b/google/cloud/compute/disks/v1/internal/disks_rest_connection_impl.cc index ca9dfa5e8f090..b253a09cf0eeb 100644 --- a/google/cloud/compute/disks/v1/internal/disks_rest_connection_impl.cc +++ b/google/cloud/compute/disks/v1/internal/disks_rest_connection_impl.cc @@ -1892,6 +1892,139 @@ DisksRestConnectionImpl::UpdateDisk( }); } +future> +DisksRestConnectionImpl::UpdateKmsKey( + google::cloud::cpp::compute::disks::v1::UpdateKmsKeyRequest const& + request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::zone_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::zone_operations::v1::DeleteOperationRequest>( + background_->cq(), current, request, + [stub = stub_]( + CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::disks::v1::UpdateKmsKeyRequest const& + request) { + return stub->AsyncUpdateKmsKey(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->UpdateKmsKey(request), + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [request]( + std::string const& op, + google::cloud::cpp::compute::zone_operations::v1::GetOperationRequest& + r) { + r.set_project(request.project()); + r.set_zone(request.zone()); + r.set_operation(op); + }, + [request](std::string const& op, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest& r) { + r.set_project(request.project()); + r.set_zone(request.zone()); + r.set_operation(op); + }); +} + +StatusOr +DisksRestConnectionImpl::UpdateKmsKey( + NoAwaitTag, + google::cloud::cpp::compute::disks::v1::UpdateKmsKeyRequest const& + request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->UpdateKmsKey(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::disks::v1::UpdateKmsKeyRequest const& + request) { + return stub_->UpdateKmsKey(rest_context, options, request); + }, + *current, request, __func__); +} + +future> +DisksRestConnectionImpl::UpdateKmsKey( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestAwaitLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::zone_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::zone_operations::v1::DeleteOperationRequest>( + background_->cq(), current, operation, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [operation]( + std::string const&, + google::cloud::cpp::compute::zone_operations::v1::GetOperationRequest& + r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_zone(info.zone); + r.set_operation(info.operation); + }, + [operation](std::string const&, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_zone(info.zone); + r.set_operation(info.operation); + }); +} + GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END } // namespace compute_disks_v1_internal } // namespace cloud diff --git a/google/cloud/compute/disks/v1/internal/disks_rest_connection_impl.h b/google/cloud/compute/disks/v1/internal/disks_rest_connection_impl.h index d1b4c98defb06..e5d76c7508156 100644 --- a/google/cloud/compute/disks/v1/internal/disks_rest_connection_impl.h +++ b/google/cloud/compute/disks/v1/internal/disks_rest_connection_impl.h @@ -240,6 +240,18 @@ class DisksRestConnectionImpl : public compute_disks_v1::DisksConnection { future> UpdateDisk( google::cloud::cpp::compute::v1::Operation const& operation) override; + future> UpdateKmsKey( + google::cloud::cpp::compute::disks::v1::UpdateKmsKeyRequest const& + request) override; + + StatusOr UpdateKmsKey( + NoAwaitTag, + google::cloud::cpp::compute::disks::v1::UpdateKmsKeyRequest const& + request) override; + + future> UpdateKmsKey( + google::cloud::cpp::compute::v1::Operation const& operation) override; + private: static std::unique_ptr retry_policy( Options const& options) { diff --git a/google/cloud/compute/disks/v1/internal/disks_rest_logging_decorator.cc b/google/cloud/compute/disks/v1/internal/disks_rest_logging_decorator.cc index 6c6d7cc05d797..8fc865dcb4eec 100644 --- a/google/cloud/compute/disks/v1/internal/disks_rest_logging_decorator.cc +++ b/google/cloud/compute/disks/v1/internal/disks_rest_logging_decorator.cc @@ -546,6 +546,40 @@ DisksRestLogging::UpdateDisk( rest_context, options, request, __func__, tracing_options_); } +future> +DisksRestLogging::AsyncUpdateKmsKey( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::disks::v1::UpdateKmsKeyRequest const& + request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::disks::v1::UpdateKmsKeyRequest const& + request) { + return child_->AsyncUpdateKmsKey(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +StatusOr +DisksRestLogging::UpdateKmsKey( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::disks::v1::UpdateKmsKeyRequest const& + request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::disks::v1::UpdateKmsKeyRequest const& + request) { + return child_->UpdateKmsKey(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + future> DisksRestLogging::AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/disks/v1/internal/disks_rest_logging_decorator.h b/google/cloud/compute/disks/v1/internal/disks_rest_logging_decorator.h index 5d71c35f8bb9c..00a545c7a9003 100644 --- a/google/cloud/compute/disks/v1/internal/disks_rest_logging_decorator.h +++ b/google/cloud/compute/disks/v1/internal/disks_rest_logging_decorator.h @@ -257,6 +257,20 @@ class DisksRestLogging : public DisksRestStub { google::cloud::cpp::compute::disks::v1::UpdateDiskRequest const& request) override; + future> + AsyncUpdateKmsKey( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::disks::v1::UpdateKmsKeyRequest const& + request) override; + + StatusOr UpdateKmsKey( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::disks::v1::UpdateKmsKeyRequest const& + request) override; + future> AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/disks/v1/internal/disks_rest_metadata_decorator.cc b/google/cloud/compute/disks/v1/internal/disks_rest_metadata_decorator.cc index 8a54cf4cb66ff..88a9aeb269f61 100644 --- a/google/cloud/compute/disks/v1/internal/disks_rest_metadata_decorator.cc +++ b/google/cloud/compute/disks/v1/internal/disks_rest_metadata_decorator.cc @@ -349,6 +349,27 @@ DisksRestMetadata::UpdateDisk( return child_->UpdateDisk(rest_context, options, request); } +future> +DisksRestMetadata::AsyncUpdateKmsKey( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::disks::v1::UpdateKmsKeyRequest const& + request) { + SetMetadata(*rest_context, *options); + return child_->AsyncUpdateKmsKey(cq, std::move(rest_context), + std::move(options), request); +} + +StatusOr +DisksRestMetadata::UpdateKmsKey( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::disks::v1::UpdateKmsKeyRequest const& + request) { + SetMetadata(rest_context, options); + return child_->UpdateKmsKey(rest_context, options, request); +} + future> DisksRestMetadata::AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/disks/v1/internal/disks_rest_metadata_decorator.h b/google/cloud/compute/disks/v1/internal/disks_rest_metadata_decorator.h index 7557be5a73ddb..db0206861b78c 100644 --- a/google/cloud/compute/disks/v1/internal/disks_rest_metadata_decorator.h +++ b/google/cloud/compute/disks/v1/internal/disks_rest_metadata_decorator.h @@ -260,6 +260,20 @@ class DisksRestMetadata : public DisksRestStub { google::cloud::cpp::compute::disks::v1::UpdateDiskRequest const& request) override; + google::cloud::future> + AsyncUpdateKmsKey( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::disks::v1::UpdateKmsKeyRequest const& + request) override; + + StatusOr UpdateKmsKey( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::disks::v1::UpdateKmsKeyRequest const& + request) override; + google::cloud::future> AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/disks/v1/internal/disks_rest_stub.cc b/google/cloud/compute/disks/v1/internal/disks_rest_stub.cc index 4b5ae808fff2b..1c5c9c3e14219 100644 --- a/google/cloud/compute/disks/v1/internal/disks_rest_stub.cc +++ b/google/cloud/compute/disks/v1/internal/disks_rest_stub.cc @@ -915,6 +915,65 @@ DefaultDisksRestStub::UpdateDisk( std::move(query_params)); } +future> +DefaultDisksRestStub::AsyncUpdateKmsKey( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::disks::v1::UpdateKmsKeyRequest const& + request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto service, auto request, auto rest_context, auto options) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + p.set_value( + rest_internal::Post( + *service, *rest_context, + request.disk_update_kms_key_request_resource(), false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", *options), + "/", "projects", "/", request.project(), "/", + "zones", "/", request.zone(), "/", "disks", "/", + request.disk(), "/", "updateKmsKey"), + std::move(query_params))); + }, + std::move(p), + service_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +StatusOr +DefaultDisksRestStub::UpdateKmsKey( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::disks::v1::UpdateKmsKeyRequest const& + request) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Post( + *service_, rest_context, request.disk_update_kms_key_request_resource(), + false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "zones", "/", + request.zone(), "/", "disks", "/", request.disk(), "/", + "updateKmsKey"), + std::move(query_params)); +} + future> DefaultDisksRestStub::AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/disks/v1/internal/disks_rest_stub.h b/google/cloud/compute/disks/v1/internal/disks_rest_stub.h index f9123b9a39534..07d57057411dc 100644 --- a/google/cloud/compute/disks/v1/internal/disks_rest_stub.h +++ b/google/cloud/compute/disks/v1/internal/disks_rest_stub.h @@ -259,6 +259,20 @@ class DisksRestStub { google::cloud::cpp::compute::disks::v1::UpdateDiskRequest const& request) = 0; + virtual future> + AsyncUpdateKmsKey( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::disks::v1::UpdateKmsKeyRequest const& + request) = 0; + + virtual StatusOr UpdateKmsKey( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::disks::v1::UpdateKmsKeyRequest const& + request) = 0; + virtual future> AsyncGetOperation( google::cloud::CompletionQueue& cq, @@ -499,6 +513,20 @@ class DefaultDisksRestStub : public DisksRestStub { google::cloud::cpp::compute::disks::v1::UpdateDiskRequest const& request) override; + future> + AsyncUpdateKmsKey( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::disks::v1::UpdateKmsKeyRequest const& + request) override; + + StatusOr UpdateKmsKey( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::disks::v1::UpdateKmsKeyRequest const& + request) override; + future> AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/disks/v1/internal/disks_tracing_connection.cc b/google/cloud/compute/disks/v1/internal/disks_tracing_connection.cc index 271ce8de2d4fd..9db109a099b38 100644 --- a/google/cloud/compute/disks/v1/internal/disks_tracing_connection.cc +++ b/google/cloud/compute/disks/v1/internal/disks_tracing_connection.cc @@ -483,6 +483,36 @@ DisksTracingConnection::UpdateDisk( return internal::EndSpan(std::move(span), child_->UpdateDisk(operation)); } +future> +DisksTracingConnection::UpdateKmsKey( + google::cloud::cpp::compute::disks::v1::UpdateKmsKeyRequest const& + request) { + auto span = + internal::MakeSpan("compute_disks_v1::DisksConnection::UpdateKmsKey"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), child_->UpdateKmsKey(request)); +} + +StatusOr +DisksTracingConnection::UpdateKmsKey( + NoAwaitTag, + google::cloud::cpp::compute::disks::v1::UpdateKmsKeyRequest const& + request) { + auto span = + internal::MakeSpan("compute_disks_v1::DisksConnection::UpdateKmsKey"); + opentelemetry::trace::Scope scope(span); + return internal::EndSpan(*span, child_->UpdateKmsKey(NoAwaitTag{}, request)); +} + +future> +DisksTracingConnection::UpdateKmsKey( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto span = + internal::MakeSpan("compute_disks_v1::DisksConnection::UpdateKmsKey"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), child_->UpdateKmsKey(operation)); +} + std::shared_ptr MakeDisksTracingConnection( std::shared_ptr conn) { if (internal::TracingEnabled(conn->options())) { diff --git a/google/cloud/compute/disks/v1/internal/disks_tracing_connection.h b/google/cloud/compute/disks/v1/internal/disks_tracing_connection.h index 8cf191957cde5..689495886c20d 100644 --- a/google/cloud/compute/disks/v1/internal/disks_tracing_connection.h +++ b/google/cloud/compute/disks/v1/internal/disks_tracing_connection.h @@ -228,6 +228,18 @@ class DisksTracingConnection : public compute_disks_v1::DisksConnection { future> UpdateDisk( google::cloud::cpp::compute::v1::Operation const& operation) override; + future> UpdateKmsKey( + google::cloud::cpp::compute::disks::v1::UpdateKmsKeyRequest const& + request) override; + + StatusOr UpdateKmsKey( + NoAwaitTag, + google::cloud::cpp::compute::disks::v1::UpdateKmsKeyRequest const& + request) override; + + future> UpdateKmsKey( + google::cloud::cpp::compute::v1::Operation const& operation) override; + private: std::shared_ptr child_; }; diff --git a/google/cloud/compute/disks/v1/mocks/mock_disks_connection.h b/google/cloud/compute/disks/v1/mocks/mock_disks_connection.h index 930ec396d69f3..8b0ab0bc76e15 100644 --- a/google/cloud/compute/disks/v1/mocks/mock_disks_connection.h +++ b/google/cloud/compute/disks/v1/mocks/mock_disks_connection.h @@ -613,6 +613,49 @@ class MockDisksConnection : public compute_disks_v1::DisksConnection { UpdateDisk, (google::cloud::cpp::compute::v1::Operation const& operation), (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// UpdateKmsKey(Matcher(_))) + /// @endcode + MOCK_METHOD( + future>, + UpdateKmsKey, + (google::cloud::cpp::compute::disks::v1::UpdateKmsKeyRequest const& + request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// EXPECT_CALL(*mock, UpdateKmsKey(_, _)) + /// @endcode + MOCK_METHOD( + StatusOr, UpdateKmsKey, + (NoAwaitTag, + google::cloud::cpp::compute::disks::v1::UpdateKmsKeyRequest const& + request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// UpdateKmsKey(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + UpdateKmsKey, + (google::cloud::cpp::compute::v1::Operation const& operation), + (override)); }; GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END diff --git a/google/cloud/compute/doc/environment-variables.dox b/google/cloud/compute/doc/environment-variables.dox index 721dbc1a020e0..4468e28819792 100644 --- a/google/cloud/compute/doc/environment-variables.dox +++ b/google/cloud/compute/doc/environment-variables.dox @@ -18,6 +18,10 @@ environment variables are convenient when troubleshooting problems. `EndpointOption` (which defaults to "compute.googleapis.com") used by `MakeAddressesConnection()`. +- `GOOGLE_CLOUD_CPP_ADVICE_ENDPOINT=...` overrides the + `EndpointOption` (which defaults to "compute.googleapis.com") + used by `MakeAdviceConnection()`. + - `GOOGLE_CLOUD_CPP_AUTOSCALERS_ENDPOINT=...` overrides the `EndpointOption` (which defaults to "compute.googleapis.com") used by `MakeAutoscalersConnection()`. @@ -30,6 +34,10 @@ environment variables are convenient when troubleshooting problems. `EndpointOption` (which defaults to "compute.googleapis.com") used by `MakeBackendServicesConnection()`. +- `GOOGLE_CLOUD_CPP_CROSS_SITE_NETWORKS_ENDPOINT=...` overrides the + `EndpointOption` (which defaults to "compute.googleapis.com") + used by `MakeCrossSiteNetworksConnection()`. + - `GOOGLE_CLOUD_CPP_DISKS_ENDPOINT=...` overrides the `EndpointOption` (which defaults to "compute.googleapis.com") used by `MakeDisksConnection()`. @@ -78,10 +86,18 @@ environment variables are convenient when troubleshooting problems. `EndpointOption` (which defaults to "compute.googleapis.com") used by `MakeGlobalPublicDelegatedPrefixesConnection()`. +- `GOOGLE_CLOUD_CPP_GLOBAL_VM_EXTENSION_POLICIES_ENDPOINT=...` overrides the + `EndpointOption` (which defaults to "compute.googleapis.com") + used by `MakeGlobalVmExtensionPoliciesConnection()`. + - `GOOGLE_CLOUD_CPP_HEALTH_CHECKS_ENDPOINT=...` overrides the `EndpointOption` (which defaults to "compute.googleapis.com") used by `MakeHealthChecksConnection()`. +- `GOOGLE_CLOUD_CPP_HOSTS_ENDPOINT=...` overrides the + `EndpointOption` (which defaults to "compute.googleapis.com") + used by `MakeHostsConnection()`. + - `GOOGLE_CLOUD_CPP_HTTPS_HEALTH_CHECKS_ENDPOINT=...` overrides the `EndpointOption` (which defaults to "compute.googleapis.com") used by `MakeHttpsHealthChecksConnection()`. @@ -126,6 +142,10 @@ environment variables are convenient when troubleshooting problems. `EndpointOption` (which defaults to "compute.googleapis.com") used by `MakeInstantSnapshotsConnection()`. +- `GOOGLE_CLOUD_CPP_INSTANT_SNAPSHOT_GROUPS_ENDPOINT=...` overrides the + `EndpointOption` (which defaults to "compute.googleapis.com") + used by `MakeInstantSnapshotGroupsConnection()`. + - `GOOGLE_CLOUD_CPP_INTERCONNECTS_ENDPOINT=...` overrides the `EndpointOption` (which defaults to "compute.googleapis.com") used by `MakeInterconnectsConnection()`. @@ -202,10 +222,18 @@ environment variables are convenient when troubleshooting problems. `EndpointOption` (which defaults to "compute.googleapis.com") used by `MakeNodeTypesConnection()`. +- `GOOGLE_CLOUD_CPP_ORGANIZATION_SECURITY_POLICIES_ENDPOINT=...` overrides the + `EndpointOption` (which defaults to "compute.googleapis.com") + used by `MakeOrganizationSecurityPoliciesConnection()`. + - `GOOGLE_CLOUD_CPP_PACKET_MIRRORINGS_ENDPOINT=...` overrides the `EndpointOption` (which defaults to "compute.googleapis.com") used by `MakePacketMirroringsConnection()`. +- `GOOGLE_CLOUD_CPP_PREVIEW_FEATURES_ENDPOINT=...` overrides the + `EndpointOption` (which defaults to "compute.googleapis.com") + used by `MakePreviewFeaturesConnection()`. + - `GOOGLE_CLOUD_CPP_PROJECTS_ENDPOINT=...` overrides the `EndpointOption` (which defaults to "compute.googleapis.com") used by `MakeProjectsConnection()`. @@ -226,6 +254,10 @@ environment variables are convenient when troubleshooting problems. `EndpointOption` (which defaults to "compute.googleapis.com") used by `MakeRegionAutoscalersConnection()`. +- `GOOGLE_CLOUD_CPP_REGION_BACKEND_BUCKETS_ENDPOINT=...` overrides the + `EndpointOption` (which defaults to "compute.googleapis.com") + used by `MakeRegionBackendBucketsConnection()`. + - `GOOGLE_CLOUD_CPP_REGION_BACKEND_SERVICES_ENDPOINT=...` overrides the `EndpointOption` (which defaults to "compute.googleapis.com") used by `MakeRegionBackendServicesConnection()`. @@ -234,6 +266,10 @@ environment variables are convenient when troubleshooting problems. `EndpointOption` (which defaults to "compute.googleapis.com") used by `MakeRegionCommitmentsConnection()`. +- `GOOGLE_CLOUD_CPP_REGION_COMPOSITE_HEALTH_CHECKS_ENDPOINT=...` overrides the + `EndpointOption` (which defaults to "compute.googleapis.com") + used by `MakeRegionCompositeHealthChecksConnection()`. + - `GOOGLE_CLOUD_CPP_REGION_DISKS_ENDPOINT=...` overrides the `EndpointOption` (which defaults to "compute.googleapis.com") used by `MakeRegionDisksConnection()`. @@ -242,6 +278,10 @@ environment variables are convenient when troubleshooting problems. `EndpointOption` (which defaults to "compute.googleapis.com") used by `MakeRegionDiskTypesConnection()`. +- `GOOGLE_CLOUD_CPP_REGION_HEALTH_AGGREGATION_POLICIES_ENDPOINT=...` overrides the + `EndpointOption` (which defaults to "compute.googleapis.com") + used by `MakeRegionHealthAggregationPoliciesConnection()`. + - `GOOGLE_CLOUD_CPP_REGION_HEALTH_CHECKS_ENDPOINT=...` overrides the `EndpointOption` (which defaults to "compute.googleapis.com") used by `MakeRegionHealthChecksConnection()`. @@ -250,6 +290,10 @@ environment variables are convenient when troubleshooting problems. `EndpointOption` (which defaults to "compute.googleapis.com") used by `MakeRegionHealthCheckServicesConnection()`. +- `GOOGLE_CLOUD_CPP_REGION_HEALTH_SOURCES_ENDPOINT=...` overrides the + `EndpointOption` (which defaults to "compute.googleapis.com") + used by `MakeRegionHealthSourcesConnection()`. + - `GOOGLE_CLOUD_CPP_REGION_INSTANCES_ENDPOINT=...` overrides the `EndpointOption` (which defaults to "compute.googleapis.com") used by `MakeRegionInstancesConnection()`. @@ -262,6 +306,10 @@ environment variables are convenient when troubleshooting problems. `EndpointOption` (which defaults to "compute.googleapis.com") used by `MakeRegionInstanceGroupManagersConnection()`. +- `GOOGLE_CLOUD_CPP_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_ENDPOINT=...` overrides the + `EndpointOption` (which defaults to "compute.googleapis.com") + used by `MakeRegionInstanceGroupManagerResizeRequestsConnection()`. + - `GOOGLE_CLOUD_CPP_REGION_INSTANCE_TEMPLATES_ENDPOINT=...` overrides the `EndpointOption` (which defaults to "compute.googleapis.com") used by `MakeRegionInstanceTemplatesConnection()`. @@ -270,6 +318,10 @@ environment variables are convenient when troubleshooting problems. `EndpointOption` (which defaults to "compute.googleapis.com") used by `MakeRegionInstantSnapshotsConnection()`. +- `GOOGLE_CLOUD_CPP_REGION_INSTANT_SNAPSHOT_GROUPS_ENDPOINT=...` overrides the + `EndpointOption` (which defaults to "compute.googleapis.com") + used by `MakeRegionInstantSnapshotGroupsConnection()`. + - `GOOGLE_CLOUD_CPP_REGION_NETWORK_ENDPOINT_GROUPS_ENDPOINT=...` overrides the `EndpointOption` (which defaults to "compute.googleapis.com") used by `MakeRegionNetworkEndpointGroupsConnection()`. @@ -290,6 +342,14 @@ environment variables are convenient when troubleshooting problems. `EndpointOption` (which defaults to "compute.googleapis.com") used by `MakeRegionSecurityPoliciesConnection()`. +- `GOOGLE_CLOUD_CPP_REGION_SNAPSHOTS_ENDPOINT=...` overrides the + `EndpointOption` (which defaults to "compute.googleapis.com") + used by `MakeRegionSnapshotsConnection()`. + +- `GOOGLE_CLOUD_CPP_REGION_SNAPSHOT_SETTINGS_ENDPOINT=...` overrides the + `EndpointOption` (which defaults to "compute.googleapis.com") + used by `MakeRegionSnapshotSettingsConnection()`. + - `GOOGLE_CLOUD_CPP_REGION_SSL_CERTIFICATES_ENDPOINT=...` overrides the `EndpointOption` (which defaults to "compute.googleapis.com") used by `MakeRegionSslCertificatesConnection()`. @@ -318,6 +378,10 @@ environment variables are convenient when troubleshooting problems. `EndpointOption` (which defaults to "compute.googleapis.com") used by `MakeRegionZonesConnection()`. +- `GOOGLE_CLOUD_CPP_RELIABILITY_RISKS_ENDPOINT=...` overrides the + `EndpointOption` (which defaults to "compute.googleapis.com") + used by `MakeReliabilityRisksConnection()`. + - `GOOGLE_CLOUD_CPP_RESERVATIONS_ENDPOINT=...` overrides the `EndpointOption` (which defaults to "compute.googleapis.com") used by `MakeReservationsConnection()`. @@ -326,6 +390,10 @@ environment variables are convenient when troubleshooting problems. `EndpointOption` (which defaults to "compute.googleapis.com") used by `MakeReservationBlocksConnection()`. +- `GOOGLE_CLOUD_CPP_RESERVATION_SLOTS_ENDPOINT=...` overrides the + `EndpointOption` (which defaults to "compute.googleapis.com") + used by `MakeReservationSlotsConnection()`. + - `GOOGLE_CLOUD_CPP_RESERVATION_SUB_BLOCKS_ENDPOINT=...` overrides the `EndpointOption` (which defaults to "compute.googleapis.com") used by `MakeReservationSubBlocksConnection()`. @@ -334,6 +402,14 @@ environment variables are convenient when troubleshooting problems. `EndpointOption` (which defaults to "compute.googleapis.com") used by `MakeResourcePoliciesConnection()`. +- `GOOGLE_CLOUD_CPP_ROLLOUTS_ENDPOINT=...` overrides the + `EndpointOption` (which defaults to "compute.googleapis.com") + used by `MakeRolloutsConnection()`. + +- `GOOGLE_CLOUD_CPP_ROLLOUT_PLANS_ENDPOINT=...` overrides the + `EndpointOption` (which defaults to "compute.googleapis.com") + used by `MakeRolloutPlansConnection()`. + - `GOOGLE_CLOUD_CPP_ROUTERS_ENDPOINT=...` overrides the `EndpointOption` (which defaults to "compute.googleapis.com") used by `MakeRoutersConnection()`. @@ -422,6 +498,10 @@ environment variables are convenient when troubleshooting problems. `EndpointOption` (which defaults to "compute.googleapis.com") used by `MakeVpnTunnelsConnection()`. +- `GOOGLE_CLOUD_CPP_WIRE_GROUPS_ENDPOINT=...` overrides the + `EndpointOption` (which defaults to "compute.googleapis.com") + used by `MakeWireGroupsConnection()`. + - `GOOGLE_CLOUD_CPP_ZONES_ENDPOINT=...` overrides the `EndpointOption` (which defaults to "compute.googleapis.com") used by `MakeZonesConnection()`. @@ -430,6 +510,10 @@ environment variables are convenient when troubleshooting problems. `EndpointOption` (which defaults to "compute.googleapis.com") used by `MakeZoneOperationsConnection()`. +- `GOOGLE_CLOUD_CPP_ZONE_VM_EXTENSION_POLICIES_ENDPOINT=...` overrides the + `EndpointOption` (which defaults to "compute.googleapis.com") + used by `MakeZoneVmExtensionPoliciesConnection()`. + @see google::cloud::EndpointOption diff --git a/google/cloud/compute/doc/main.dox b/google/cloud/compute/doc/main.dox index 314b166718503..90db4e45d8842 100644 --- a/google/cloud/compute/doc/main.dox +++ b/google/cloud/compute/doc/main.dox @@ -33,9 +33,11 @@ application. - [\c compute_accelerator_types_v1::AcceleratorTypesClient](@ref google::cloud::compute_accelerator_types_v1::AcceleratorTypesClient) - [\c compute_addresses_v1::AddressesClient](@ref google::cloud::compute_addresses_v1::AddressesClient) +- [\c compute_advice_v1::AdviceClient](@ref google::cloud::compute_advice_v1::AdviceClient) - [\c compute_autoscalers_v1::AutoscalersClient](@ref google::cloud::compute_autoscalers_v1::AutoscalersClient) - [\c compute_backend_buckets_v1::BackendBucketsClient](@ref google::cloud::compute_backend_buckets_v1::BackendBucketsClient) - [\c compute_backend_services_v1::BackendServicesClient](@ref google::cloud::compute_backend_services_v1::BackendServicesClient) +- [\c compute_cross_site_networks_v1::CrossSiteNetworksClient](@ref google::cloud::compute_cross_site_networks_v1::CrossSiteNetworksClient) - [\c compute_disk_types_v1::DiskTypesClient](@ref google::cloud::compute_disk_types_v1::DiskTypesClient) - [\c compute_disks_v1::DisksClient](@ref google::cloud::compute_disks_v1::DisksClient) - [\c compute_external_vpn_gateways_v1::ExternalVpnGatewaysClient](@ref google::cloud::compute_external_vpn_gateways_v1::ExternalVpnGatewaysClient) @@ -48,7 +50,9 @@ application. - [\c compute_global_operations_v1::GlobalOperationsClient](@ref google::cloud::compute_global_operations_v1::GlobalOperationsClient) - [\c compute_global_organization_operations_v1::GlobalOrganizationOperationsClient](@ref google::cloud::compute_global_organization_operations_v1::GlobalOrganizationOperationsClient) - [\c compute_global_public_delegated_prefixes_v1::GlobalPublicDelegatedPrefixesClient](@ref google::cloud::compute_global_public_delegated_prefixes_v1::GlobalPublicDelegatedPrefixesClient) +- [\c compute_global_vm_extension_policies_v1::GlobalVmExtensionPoliciesClient](@ref google::cloud::compute_global_vm_extension_policies_v1::GlobalVmExtensionPoliciesClient) - [\c compute_health_checks_v1::HealthChecksClient](@ref google::cloud::compute_health_checks_v1::HealthChecksClient) +- [\c compute_hosts_v1::HostsClient](@ref google::cloud::compute_hosts_v1::HostsClient) - [\c compute_http_health_checks_v1::HttpHealthChecksClient](@ref google::cloud::compute_http_health_checks_v1::HttpHealthChecksClient) - [\c compute_https_health_checks_v1::HttpsHealthChecksClient](@ref google::cloud::compute_https_health_checks_v1::HttpsHealthChecksClient) - [\c compute_image_family_views_v1::ImageFamilyViewsClient](@ref google::cloud::compute_image_family_views_v1::ImageFamilyViewsClient) @@ -59,6 +63,7 @@ application. - [\c compute_instance_settings_v1::InstanceSettingsClient](@ref google::cloud::compute_instance_settings_v1::InstanceSettingsClient) - [\c compute_instance_templates_v1::InstanceTemplatesClient](@ref google::cloud::compute_instance_templates_v1::InstanceTemplatesClient) - [\c compute_instances_v1::InstancesClient](@ref google::cloud::compute_instances_v1::InstancesClient) +- [\c compute_instant_snapshot_groups_v1::InstantSnapshotGroupsClient](@ref google::cloud::compute_instant_snapshot_groups_v1::InstantSnapshotGroupsClient) - [\c compute_instant_snapshots_v1::InstantSnapshotsClient](@ref google::cloud::compute_instant_snapshots_v1::InstantSnapshotsClient) - [\c compute_interconnect_attachment_groups_v1::InterconnectAttachmentGroupsClient](@ref google::cloud::compute_interconnect_attachment_groups_v1::InterconnectAttachmentGroupsClient) - [\c compute_interconnect_attachments_v1::InterconnectAttachmentsClient](@ref google::cloud::compute_interconnect_attachments_v1::InterconnectAttachmentsClient) @@ -79,27 +84,37 @@ application. - [\c compute_node_groups_v1::NodeGroupsClient](@ref google::cloud::compute_node_groups_v1::NodeGroupsClient) - [\c compute_node_templates_v1::NodeTemplatesClient](@ref google::cloud::compute_node_templates_v1::NodeTemplatesClient) - [\c compute_node_types_v1::NodeTypesClient](@ref google::cloud::compute_node_types_v1::NodeTypesClient) +- [\c compute_organization_security_policies_v1::OrganizationSecurityPoliciesClient](@ref google::cloud::compute_organization_security_policies_v1::OrganizationSecurityPoliciesClient) - [\c compute_packet_mirrorings_v1::PacketMirroringsClient](@ref google::cloud::compute_packet_mirrorings_v1::PacketMirroringsClient) +- [\c compute_preview_features_v1::PreviewFeaturesClient](@ref google::cloud::compute_preview_features_v1::PreviewFeaturesClient) - [\c compute_projects_v1::ProjectsClient](@ref google::cloud::compute_projects_v1::ProjectsClient) - [\c compute_public_advertised_prefixes_v1::PublicAdvertisedPrefixesClient](@ref google::cloud::compute_public_advertised_prefixes_v1::PublicAdvertisedPrefixesClient) - [\c compute_public_delegated_prefixes_v1::PublicDelegatedPrefixesClient](@ref google::cloud::compute_public_delegated_prefixes_v1::PublicDelegatedPrefixesClient) - [\c compute_region_autoscalers_v1::RegionAutoscalersClient](@ref google::cloud::compute_region_autoscalers_v1::RegionAutoscalersClient) +- [\c compute_region_backend_buckets_v1::RegionBackendBucketsClient](@ref google::cloud::compute_region_backend_buckets_v1::RegionBackendBucketsClient) - [\c compute_region_backend_services_v1::RegionBackendServicesClient](@ref google::cloud::compute_region_backend_services_v1::RegionBackendServicesClient) - [\c compute_region_commitments_v1::RegionCommitmentsClient](@ref google::cloud::compute_region_commitments_v1::RegionCommitmentsClient) +- [\c compute_region_composite_health_checks_v1::RegionCompositeHealthChecksClient](@ref google::cloud::compute_region_composite_health_checks_v1::RegionCompositeHealthChecksClient) - [\c compute_region_disk_types_v1::RegionDiskTypesClient](@ref google::cloud::compute_region_disk_types_v1::RegionDiskTypesClient) - [\c compute_region_disks_v1::RegionDisksClient](@ref google::cloud::compute_region_disks_v1::RegionDisksClient) +- [\c compute_region_health_aggregation_policies_v1::RegionHealthAggregationPoliciesClient](@ref google::cloud::compute_region_health_aggregation_policies_v1::RegionHealthAggregationPoliciesClient) - [\c compute_region_health_check_services_v1::RegionHealthCheckServicesClient](@ref google::cloud::compute_region_health_check_services_v1::RegionHealthCheckServicesClient) - [\c compute_region_health_checks_v1::RegionHealthChecksClient](@ref google::cloud::compute_region_health_checks_v1::RegionHealthChecksClient) +- [\c compute_region_health_sources_v1::RegionHealthSourcesClient](@ref google::cloud::compute_region_health_sources_v1::RegionHealthSourcesClient) +- [\c compute_region_instance_group_manager_resize_requests_v1::RegionInstanceGroupManagerResizeRequestsClient](@ref google::cloud::compute_region_instance_group_manager_resize_requests_v1::RegionInstanceGroupManagerResizeRequestsClient) - [\c compute_region_instance_group_managers_v1::RegionInstanceGroupManagersClient](@ref google::cloud::compute_region_instance_group_managers_v1::RegionInstanceGroupManagersClient) - [\c compute_region_instance_groups_v1::RegionInstanceGroupsClient](@ref google::cloud::compute_region_instance_groups_v1::RegionInstanceGroupsClient) - [\c compute_region_instance_templates_v1::RegionInstanceTemplatesClient](@ref google::cloud::compute_region_instance_templates_v1::RegionInstanceTemplatesClient) - [\c compute_region_instances_v1::RegionInstancesClient](@ref google::cloud::compute_region_instances_v1::RegionInstancesClient) +- [\c compute_region_instant_snapshot_groups_v1::RegionInstantSnapshotGroupsClient](@ref google::cloud::compute_region_instant_snapshot_groups_v1::RegionInstantSnapshotGroupsClient) - [\c compute_region_instant_snapshots_v1::RegionInstantSnapshotsClient](@ref google::cloud::compute_region_instant_snapshots_v1::RegionInstantSnapshotsClient) - [\c compute_region_network_endpoint_groups_v1::RegionNetworkEndpointGroupsClient](@ref google::cloud::compute_region_network_endpoint_groups_v1::RegionNetworkEndpointGroupsClient) - [\c compute_region_network_firewall_policies_v1::RegionNetworkFirewallPoliciesClient](@ref google::cloud::compute_region_network_firewall_policies_v1::RegionNetworkFirewallPoliciesClient) - [\c compute_region_notification_endpoints_v1::RegionNotificationEndpointsClient](@ref google::cloud::compute_region_notification_endpoints_v1::RegionNotificationEndpointsClient) - [\c compute_region_operations_v1::RegionOperationsClient](@ref google::cloud::compute_region_operations_v1::RegionOperationsClient) - [\c compute_region_security_policies_v1::RegionSecurityPoliciesClient](@ref google::cloud::compute_region_security_policies_v1::RegionSecurityPoliciesClient) +- [\c compute_region_snapshot_settings_v1::RegionSnapshotSettingsClient](@ref google::cloud::compute_region_snapshot_settings_v1::RegionSnapshotSettingsClient) +- [\c compute_region_snapshots_v1::RegionSnapshotsClient](@ref google::cloud::compute_region_snapshots_v1::RegionSnapshotsClient) - [\c compute_region_ssl_certificates_v1::RegionSslCertificatesClient](@ref google::cloud::compute_region_ssl_certificates_v1::RegionSslCertificatesClient) - [\c compute_region_ssl_policies_v1::RegionSslPoliciesClient](@ref google::cloud::compute_region_ssl_policies_v1::RegionSslPoliciesClient) - [\c compute_region_target_http_proxies_v1::RegionTargetHttpProxiesClient](@ref google::cloud::compute_region_target_http_proxies_v1::RegionTargetHttpProxiesClient) @@ -108,10 +123,14 @@ application. - [\c compute_region_url_maps_v1::RegionUrlMapsClient](@ref google::cloud::compute_region_url_maps_v1::RegionUrlMapsClient) - [\c compute_region_zones_v1::RegionZonesClient](@ref google::cloud::compute_region_zones_v1::RegionZonesClient) - [\c compute_regions_v1::RegionsClient](@ref google::cloud::compute_regions_v1::RegionsClient) +- [\c compute_reliability_risks_v1::ReliabilityRisksClient](@ref google::cloud::compute_reliability_risks_v1::ReliabilityRisksClient) - [\c compute_reservation_blocks_v1::ReservationBlocksClient](@ref google::cloud::compute_reservation_blocks_v1::ReservationBlocksClient) +- [\c compute_reservation_slots_v1::ReservationSlotsClient](@ref google::cloud::compute_reservation_slots_v1::ReservationSlotsClient) - [\c compute_reservation_sub_blocks_v1::ReservationSubBlocksClient](@ref google::cloud::compute_reservation_sub_blocks_v1::ReservationSubBlocksClient) - [\c compute_reservations_v1::ReservationsClient](@ref google::cloud::compute_reservations_v1::ReservationsClient) - [\c compute_resource_policies_v1::ResourcePoliciesClient](@ref google::cloud::compute_resource_policies_v1::ResourcePoliciesClient) +- [\c compute_rollout_plans_v1::RolloutPlansClient](@ref google::cloud::compute_rollout_plans_v1::RolloutPlansClient) +- [\c compute_rollouts_v1::RolloutsClient](@ref google::cloud::compute_rollouts_v1::RolloutsClient) - [\c compute_routers_v1::RoutersClient](@ref google::cloud::compute_routers_v1::RoutersClient) - [\c compute_routes_v1::RoutesClient](@ref google::cloud::compute_routes_v1::RoutesClient) - [\c compute_security_policies_v1::SecurityPoliciesClient](@ref google::cloud::compute_security_policies_v1::SecurityPoliciesClient) @@ -134,7 +153,9 @@ application. - [\c compute_url_maps_v1::UrlMapsClient](@ref google::cloud::compute_url_maps_v1::UrlMapsClient) - [\c compute_vpn_gateways_v1::VpnGatewaysClient](@ref google::cloud::compute_vpn_gateways_v1::VpnGatewaysClient) - [\c compute_vpn_tunnels_v1::VpnTunnelsClient](@ref google::cloud::compute_vpn_tunnels_v1::VpnTunnelsClient) +- [\c compute_wire_groups_v1::WireGroupsClient](@ref google::cloud::compute_wire_groups_v1::WireGroupsClient) - [\c compute_zone_operations_v1::ZoneOperationsClient](@ref google::cloud::compute_zone_operations_v1::ZoneOperationsClient) +- [\c compute_zone_vm_extension_policies_v1::ZoneVmExtensionPoliciesClient](@ref google::cloud::compute_zone_vm_extension_policies_v1::ZoneVmExtensionPoliciesClient) - [\c compute_zones_v1::ZonesClient](@ref google::cloud::compute_zones_v1::ZonesClient) diff --git a/google/cloud/compute/doc/override-authentication.dox b/google/cloud/compute/doc/override-authentication.dox index 6bd7ddb45d859..b951dc7bc0c13 100644 --- a/google/cloud/compute/doc/override-authentication.dox +++ b/google/cloud/compute/doc/override-authentication.dox @@ -15,9 +15,11 @@ Follow these links to find examples for other \c *Client classes: - [\c compute_accelerator_types_v1::AcceleratorTypesClient](@ref compute_accelerator_types_v1::AcceleratorTypesClient-service-account-snippet) - [\c compute_addresses_v1::AddressesClient](@ref compute_addresses_v1::AddressesClient-service-account-snippet) +- [\c compute_advice_v1::AdviceClient](@ref compute_advice_v1::AdviceClient-service-account-snippet) - [\c compute_autoscalers_v1::AutoscalersClient](@ref compute_autoscalers_v1::AutoscalersClient-service-account-snippet) - [\c compute_backend_buckets_v1::BackendBucketsClient](@ref compute_backend_buckets_v1::BackendBucketsClient-service-account-snippet) - [\c compute_backend_services_v1::BackendServicesClient](@ref compute_backend_services_v1::BackendServicesClient-service-account-snippet) +- [\c compute_cross_site_networks_v1::CrossSiteNetworksClient](@ref compute_cross_site_networks_v1::CrossSiteNetworksClient-service-account-snippet) - [\c compute_disk_types_v1::DiskTypesClient](@ref compute_disk_types_v1::DiskTypesClient-service-account-snippet) - [\c compute_disks_v1::DisksClient](@ref compute_disks_v1::DisksClient-service-account-snippet) - [\c compute_external_vpn_gateways_v1::ExternalVpnGatewaysClient](@ref compute_external_vpn_gateways_v1::ExternalVpnGatewaysClient-service-account-snippet) @@ -30,7 +32,9 @@ Follow these links to find examples for other \c *Client classes: - [\c compute_global_operations_v1::GlobalOperationsClient](@ref compute_global_operations_v1::GlobalOperationsClient-service-account-snippet) - [\c compute_global_organization_operations_v1::GlobalOrganizationOperationsClient](@ref compute_global_organization_operations_v1::GlobalOrganizationOperationsClient-service-account-snippet) - [\c compute_global_public_delegated_prefixes_v1::GlobalPublicDelegatedPrefixesClient](@ref compute_global_public_delegated_prefixes_v1::GlobalPublicDelegatedPrefixesClient-service-account-snippet) +- [\c compute_global_vm_extension_policies_v1::GlobalVmExtensionPoliciesClient](@ref compute_global_vm_extension_policies_v1::GlobalVmExtensionPoliciesClient-service-account-snippet) - [\c compute_health_checks_v1::HealthChecksClient](@ref compute_health_checks_v1::HealthChecksClient-service-account-snippet) +- [\c compute_hosts_v1::HostsClient](@ref compute_hosts_v1::HostsClient-service-account-snippet) - [\c compute_http_health_checks_v1::HttpHealthChecksClient](@ref compute_http_health_checks_v1::HttpHealthChecksClient-service-account-snippet) - [\c compute_https_health_checks_v1::HttpsHealthChecksClient](@ref compute_https_health_checks_v1::HttpsHealthChecksClient-service-account-snippet) - [\c compute_image_family_views_v1::ImageFamilyViewsClient](@ref compute_image_family_views_v1::ImageFamilyViewsClient-service-account-snippet) @@ -41,6 +45,7 @@ Follow these links to find examples for other \c *Client classes: - [\c compute_instance_settings_v1::InstanceSettingsClient](@ref compute_instance_settings_v1::InstanceSettingsClient-service-account-snippet) - [\c compute_instance_templates_v1::InstanceTemplatesClient](@ref compute_instance_templates_v1::InstanceTemplatesClient-service-account-snippet) - [\c compute_instances_v1::InstancesClient](@ref compute_instances_v1::InstancesClient-service-account-snippet) +- [\c compute_instant_snapshot_groups_v1::InstantSnapshotGroupsClient](@ref compute_instant_snapshot_groups_v1::InstantSnapshotGroupsClient-service-account-snippet) - [\c compute_instant_snapshots_v1::InstantSnapshotsClient](@ref compute_instant_snapshots_v1::InstantSnapshotsClient-service-account-snippet) - [\c compute_interconnect_attachment_groups_v1::InterconnectAttachmentGroupsClient](@ref compute_interconnect_attachment_groups_v1::InterconnectAttachmentGroupsClient-service-account-snippet) - [\c compute_interconnect_attachments_v1::InterconnectAttachmentsClient](@ref compute_interconnect_attachments_v1::InterconnectAttachmentsClient-service-account-snippet) @@ -61,27 +66,37 @@ Follow these links to find examples for other \c *Client classes: - [\c compute_node_groups_v1::NodeGroupsClient](@ref compute_node_groups_v1::NodeGroupsClient-service-account-snippet) - [\c compute_node_templates_v1::NodeTemplatesClient](@ref compute_node_templates_v1::NodeTemplatesClient-service-account-snippet) - [\c compute_node_types_v1::NodeTypesClient](@ref compute_node_types_v1::NodeTypesClient-service-account-snippet) +- [\c compute_organization_security_policies_v1::OrganizationSecurityPoliciesClient](@ref compute_organization_security_policies_v1::OrganizationSecurityPoliciesClient-service-account-snippet) - [\c compute_packet_mirrorings_v1::PacketMirroringsClient](@ref compute_packet_mirrorings_v1::PacketMirroringsClient-service-account-snippet) +- [\c compute_preview_features_v1::PreviewFeaturesClient](@ref compute_preview_features_v1::PreviewFeaturesClient-service-account-snippet) - [\c compute_projects_v1::ProjectsClient](@ref compute_projects_v1::ProjectsClient-service-account-snippet) - [\c compute_public_advertised_prefixes_v1::PublicAdvertisedPrefixesClient](@ref compute_public_advertised_prefixes_v1::PublicAdvertisedPrefixesClient-service-account-snippet) - [\c compute_public_delegated_prefixes_v1::PublicDelegatedPrefixesClient](@ref compute_public_delegated_prefixes_v1::PublicDelegatedPrefixesClient-service-account-snippet) - [\c compute_region_autoscalers_v1::RegionAutoscalersClient](@ref compute_region_autoscalers_v1::RegionAutoscalersClient-service-account-snippet) +- [\c compute_region_backend_buckets_v1::RegionBackendBucketsClient](@ref compute_region_backend_buckets_v1::RegionBackendBucketsClient-service-account-snippet) - [\c compute_region_backend_services_v1::RegionBackendServicesClient](@ref compute_region_backend_services_v1::RegionBackendServicesClient-service-account-snippet) - [\c compute_region_commitments_v1::RegionCommitmentsClient](@ref compute_region_commitments_v1::RegionCommitmentsClient-service-account-snippet) +- [\c compute_region_composite_health_checks_v1::RegionCompositeHealthChecksClient](@ref compute_region_composite_health_checks_v1::RegionCompositeHealthChecksClient-service-account-snippet) - [\c compute_region_disk_types_v1::RegionDiskTypesClient](@ref compute_region_disk_types_v1::RegionDiskTypesClient-service-account-snippet) - [\c compute_region_disks_v1::RegionDisksClient](@ref compute_region_disks_v1::RegionDisksClient-service-account-snippet) +- [\c compute_region_health_aggregation_policies_v1::RegionHealthAggregationPoliciesClient](@ref compute_region_health_aggregation_policies_v1::RegionHealthAggregationPoliciesClient-service-account-snippet) - [\c compute_region_health_check_services_v1::RegionHealthCheckServicesClient](@ref compute_region_health_check_services_v1::RegionHealthCheckServicesClient-service-account-snippet) - [\c compute_region_health_checks_v1::RegionHealthChecksClient](@ref compute_region_health_checks_v1::RegionHealthChecksClient-service-account-snippet) +- [\c compute_region_health_sources_v1::RegionHealthSourcesClient](@ref compute_region_health_sources_v1::RegionHealthSourcesClient-service-account-snippet) +- [\c compute_region_instance_group_manager_resize_requests_v1::RegionInstanceGroupManagerResizeRequestsClient](@ref compute_region_instance_group_manager_resize_requests_v1::RegionInstanceGroupManagerResizeRequestsClient-service-account-snippet) - [\c compute_region_instance_group_managers_v1::RegionInstanceGroupManagersClient](@ref compute_region_instance_group_managers_v1::RegionInstanceGroupManagersClient-service-account-snippet) - [\c compute_region_instance_groups_v1::RegionInstanceGroupsClient](@ref compute_region_instance_groups_v1::RegionInstanceGroupsClient-service-account-snippet) - [\c compute_region_instance_templates_v1::RegionInstanceTemplatesClient](@ref compute_region_instance_templates_v1::RegionInstanceTemplatesClient-service-account-snippet) - [\c compute_region_instances_v1::RegionInstancesClient](@ref compute_region_instances_v1::RegionInstancesClient-service-account-snippet) +- [\c compute_region_instant_snapshot_groups_v1::RegionInstantSnapshotGroupsClient](@ref compute_region_instant_snapshot_groups_v1::RegionInstantSnapshotGroupsClient-service-account-snippet) - [\c compute_region_instant_snapshots_v1::RegionInstantSnapshotsClient](@ref compute_region_instant_snapshots_v1::RegionInstantSnapshotsClient-service-account-snippet) - [\c compute_region_network_endpoint_groups_v1::RegionNetworkEndpointGroupsClient](@ref compute_region_network_endpoint_groups_v1::RegionNetworkEndpointGroupsClient-service-account-snippet) - [\c compute_region_network_firewall_policies_v1::RegionNetworkFirewallPoliciesClient](@ref compute_region_network_firewall_policies_v1::RegionNetworkFirewallPoliciesClient-service-account-snippet) - [\c compute_region_notification_endpoints_v1::RegionNotificationEndpointsClient](@ref compute_region_notification_endpoints_v1::RegionNotificationEndpointsClient-service-account-snippet) - [\c compute_region_operations_v1::RegionOperationsClient](@ref compute_region_operations_v1::RegionOperationsClient-service-account-snippet) - [\c compute_region_security_policies_v1::RegionSecurityPoliciesClient](@ref compute_region_security_policies_v1::RegionSecurityPoliciesClient-service-account-snippet) +- [\c compute_region_snapshot_settings_v1::RegionSnapshotSettingsClient](@ref compute_region_snapshot_settings_v1::RegionSnapshotSettingsClient-service-account-snippet) +- [\c compute_region_snapshots_v1::RegionSnapshotsClient](@ref compute_region_snapshots_v1::RegionSnapshotsClient-service-account-snippet) - [\c compute_region_ssl_certificates_v1::RegionSslCertificatesClient](@ref compute_region_ssl_certificates_v1::RegionSslCertificatesClient-service-account-snippet) - [\c compute_region_ssl_policies_v1::RegionSslPoliciesClient](@ref compute_region_ssl_policies_v1::RegionSslPoliciesClient-service-account-snippet) - [\c compute_region_target_http_proxies_v1::RegionTargetHttpProxiesClient](@ref compute_region_target_http_proxies_v1::RegionTargetHttpProxiesClient-service-account-snippet) @@ -90,10 +105,14 @@ Follow these links to find examples for other \c *Client classes: - [\c compute_region_url_maps_v1::RegionUrlMapsClient](@ref compute_region_url_maps_v1::RegionUrlMapsClient-service-account-snippet) - [\c compute_region_zones_v1::RegionZonesClient](@ref compute_region_zones_v1::RegionZonesClient-service-account-snippet) - [\c compute_regions_v1::RegionsClient](@ref compute_regions_v1::RegionsClient-service-account-snippet) +- [\c compute_reliability_risks_v1::ReliabilityRisksClient](@ref compute_reliability_risks_v1::ReliabilityRisksClient-service-account-snippet) - [\c compute_reservation_blocks_v1::ReservationBlocksClient](@ref compute_reservation_blocks_v1::ReservationBlocksClient-service-account-snippet) +- [\c compute_reservation_slots_v1::ReservationSlotsClient](@ref compute_reservation_slots_v1::ReservationSlotsClient-service-account-snippet) - [\c compute_reservation_sub_blocks_v1::ReservationSubBlocksClient](@ref compute_reservation_sub_blocks_v1::ReservationSubBlocksClient-service-account-snippet) - [\c compute_reservations_v1::ReservationsClient](@ref compute_reservations_v1::ReservationsClient-service-account-snippet) - [\c compute_resource_policies_v1::ResourcePoliciesClient](@ref compute_resource_policies_v1::ResourcePoliciesClient-service-account-snippet) +- [\c compute_rollout_plans_v1::RolloutPlansClient](@ref compute_rollout_plans_v1::RolloutPlansClient-service-account-snippet) +- [\c compute_rollouts_v1::RolloutsClient](@ref compute_rollouts_v1::RolloutsClient-service-account-snippet) - [\c compute_routers_v1::RoutersClient](@ref compute_routers_v1::RoutersClient-service-account-snippet) - [\c compute_routes_v1::RoutesClient](@ref compute_routes_v1::RoutesClient-service-account-snippet) - [\c compute_security_policies_v1::SecurityPoliciesClient](@ref compute_security_policies_v1::SecurityPoliciesClient-service-account-snippet) @@ -116,7 +135,9 @@ Follow these links to find examples for other \c *Client classes: - [\c compute_url_maps_v1::UrlMapsClient](@ref compute_url_maps_v1::UrlMapsClient-service-account-snippet) - [\c compute_vpn_gateways_v1::VpnGatewaysClient](@ref compute_vpn_gateways_v1::VpnGatewaysClient-service-account-snippet) - [\c compute_vpn_tunnels_v1::VpnTunnelsClient](@ref compute_vpn_tunnels_v1::VpnTunnelsClient-service-account-snippet) +- [\c compute_wire_groups_v1::WireGroupsClient](@ref compute_wire_groups_v1::WireGroupsClient-service-account-snippet) - [\c compute_zone_operations_v1::ZoneOperationsClient](@ref compute_zone_operations_v1::ZoneOperationsClient-service-account-snippet) +- [\c compute_zone_vm_extension_policies_v1::ZoneVmExtensionPoliciesClient](@ref compute_zone_vm_extension_policies_v1::ZoneVmExtensionPoliciesClient-service-account-snippet) - [\c compute_zones_v1::ZonesClient](@ref compute_zones_v1::ZonesClient-service-account-snippet) @@ -147,6 +168,12 @@ guide for more details. */ +/*! @page compute_advice_v1::AdviceClient-service-account-snippet Override compute_advice_v1::AdviceClient Authentication Defaults + +@snippet google/cloud/compute/advice/v1/samples/advice_client_samples.cc with-service-account + +*/ + /*! @page compute_autoscalers_v1::AutoscalersClient-service-account-snippet Override compute_autoscalers_v1::AutoscalersClient Authentication Defaults @snippet google/cloud/compute/autoscalers/v1/samples/autoscalers_client_samples.cc with-service-account @@ -165,6 +192,12 @@ guide for more details. */ +/*! @page compute_cross_site_networks_v1::CrossSiteNetworksClient-service-account-snippet Override compute_cross_site_networks_v1::CrossSiteNetworksClient Authentication Defaults + +@snippet google/cloud/compute/cross_site_networks/v1/samples/cross_site_networks_client_samples.cc with-service-account + +*/ + /*! @page compute_disk_types_v1::DiskTypesClient-service-account-snippet Override compute_disk_types_v1::DiskTypesClient Authentication Defaults @snippet google/cloud/compute/disk_types/v1/samples/disk_types_client_samples.cc with-service-account @@ -237,12 +270,24 @@ guide for more details. */ +/*! @page compute_global_vm_extension_policies_v1::GlobalVmExtensionPoliciesClient-service-account-snippet Override compute_global_vm_extension_policies_v1::GlobalVmExtensionPoliciesClient Authentication Defaults + +@snippet google/cloud/compute/global_vm_extension_policies/v1/samples/global_vm_extension_policies_client_samples.cc with-service-account + +*/ + /*! @page compute_health_checks_v1::HealthChecksClient-service-account-snippet Override compute_health_checks_v1::HealthChecksClient Authentication Defaults @snippet google/cloud/compute/health_checks/v1/samples/health_checks_client_samples.cc with-service-account */ +/*! @page compute_hosts_v1::HostsClient-service-account-snippet Override compute_hosts_v1::HostsClient Authentication Defaults + +@snippet google/cloud/compute/hosts/v1/samples/hosts_client_samples.cc with-service-account + +*/ + /*! @page compute_http_health_checks_v1::HttpHealthChecksClient-service-account-snippet Override compute_http_health_checks_v1::HttpHealthChecksClient Authentication Defaults @snippet google/cloud/compute/http_health_checks/v1/samples/http_health_checks_client_samples.cc with-service-account @@ -303,6 +348,12 @@ guide for more details. */ +/*! @page compute_instant_snapshot_groups_v1::InstantSnapshotGroupsClient-service-account-snippet Override compute_instant_snapshot_groups_v1::InstantSnapshotGroupsClient Authentication Defaults + +@snippet google/cloud/compute/instant_snapshot_groups/v1/samples/instant_snapshot_groups_client_samples.cc with-service-account + +*/ + /*! @page compute_instant_snapshots_v1::InstantSnapshotsClient-service-account-snippet Override compute_instant_snapshots_v1::InstantSnapshotsClient Authentication Defaults @snippet google/cloud/compute/instant_snapshots/v1/samples/instant_snapshots_client_samples.cc with-service-account @@ -423,12 +474,24 @@ guide for more details. */ +/*! @page compute_organization_security_policies_v1::OrganizationSecurityPoliciesClient-service-account-snippet Override compute_organization_security_policies_v1::OrganizationSecurityPoliciesClient Authentication Defaults + +@snippet google/cloud/compute/organization_security_policies/v1/samples/organization_security_policies_client_samples.cc with-service-account + +*/ + /*! @page compute_packet_mirrorings_v1::PacketMirroringsClient-service-account-snippet Override compute_packet_mirrorings_v1::PacketMirroringsClient Authentication Defaults @snippet google/cloud/compute/packet_mirrorings/v1/samples/packet_mirrorings_client_samples.cc with-service-account */ +/*! @page compute_preview_features_v1::PreviewFeaturesClient-service-account-snippet Override compute_preview_features_v1::PreviewFeaturesClient Authentication Defaults + +@snippet google/cloud/compute/preview_features/v1/samples/preview_features_client_samples.cc with-service-account + +*/ + /*! @page compute_projects_v1::ProjectsClient-service-account-snippet Override compute_projects_v1::ProjectsClient Authentication Defaults @snippet google/cloud/compute/projects/v1/samples/projects_client_samples.cc with-service-account @@ -453,6 +516,12 @@ guide for more details. */ +/*! @page compute_region_backend_buckets_v1::RegionBackendBucketsClient-service-account-snippet Override compute_region_backend_buckets_v1::RegionBackendBucketsClient Authentication Defaults + +@snippet google/cloud/compute/region_backend_buckets/v1/samples/region_backend_buckets_client_samples.cc with-service-account + +*/ + /*! @page compute_region_backend_services_v1::RegionBackendServicesClient-service-account-snippet Override compute_region_backend_services_v1::RegionBackendServicesClient Authentication Defaults @snippet google/cloud/compute/region_backend_services/v1/samples/region_backend_services_client_samples.cc with-service-account @@ -465,6 +534,12 @@ guide for more details. */ +/*! @page compute_region_composite_health_checks_v1::RegionCompositeHealthChecksClient-service-account-snippet Override compute_region_composite_health_checks_v1::RegionCompositeHealthChecksClient Authentication Defaults + +@snippet google/cloud/compute/region_composite_health_checks/v1/samples/region_composite_health_checks_client_samples.cc with-service-account + +*/ + /*! @page compute_region_disk_types_v1::RegionDiskTypesClient-service-account-snippet Override compute_region_disk_types_v1::RegionDiskTypesClient Authentication Defaults @snippet google/cloud/compute/region_disk_types/v1/samples/region_disk_types_client_samples.cc with-service-account @@ -477,6 +552,12 @@ guide for more details. */ +/*! @page compute_region_health_aggregation_policies_v1::RegionHealthAggregationPoliciesClient-service-account-snippet Override compute_region_health_aggregation_policies_v1::RegionHealthAggregationPoliciesClient Authentication Defaults + +@snippet google/cloud/compute/region_health_aggregation_policies/v1/samples/region_health_aggregation_policies_client_samples.cc with-service-account + +*/ + /*! @page compute_region_health_check_services_v1::RegionHealthCheckServicesClient-service-account-snippet Override compute_region_health_check_services_v1::RegionHealthCheckServicesClient Authentication Defaults @snippet google/cloud/compute/region_health_check_services/v1/samples/region_health_check_services_client_samples.cc with-service-account @@ -489,6 +570,18 @@ guide for more details. */ +/*! @page compute_region_health_sources_v1::RegionHealthSourcesClient-service-account-snippet Override compute_region_health_sources_v1::RegionHealthSourcesClient Authentication Defaults + +@snippet google/cloud/compute/region_health_sources/v1/samples/region_health_sources_client_samples.cc with-service-account + +*/ + +/*! @page compute_region_instance_group_manager_resize_requests_v1::RegionInstanceGroupManagerResizeRequestsClient-service-account-snippet Override compute_region_instance_group_manager_resize_requests_v1::RegionInstanceGroupManagerResizeRequestsClient Authentication Defaults + +@snippet google/cloud/compute/region_instance_group_manager_resize_requests/v1/samples/region_instance_group_manager_resize_requests_client_samples.cc with-service-account + +*/ + /*! @page compute_region_instance_group_managers_v1::RegionInstanceGroupManagersClient-service-account-snippet Override compute_region_instance_group_managers_v1::RegionInstanceGroupManagersClient Authentication Defaults @snippet google/cloud/compute/region_instance_group_managers/v1/samples/region_instance_group_managers_client_samples.cc with-service-account @@ -513,6 +606,12 @@ guide for more details. */ +/*! @page compute_region_instant_snapshot_groups_v1::RegionInstantSnapshotGroupsClient-service-account-snippet Override compute_region_instant_snapshot_groups_v1::RegionInstantSnapshotGroupsClient Authentication Defaults + +@snippet google/cloud/compute/region_instant_snapshot_groups/v1/samples/region_instant_snapshot_groups_client_samples.cc with-service-account + +*/ + /*! @page compute_region_instant_snapshots_v1::RegionInstantSnapshotsClient-service-account-snippet Override compute_region_instant_snapshots_v1::RegionInstantSnapshotsClient Authentication Defaults @snippet google/cloud/compute/region_instant_snapshots/v1/samples/region_instant_snapshots_client_samples.cc with-service-account @@ -549,6 +648,18 @@ guide for more details. */ +/*! @page compute_region_snapshot_settings_v1::RegionSnapshotSettingsClient-service-account-snippet Override compute_region_snapshot_settings_v1::RegionSnapshotSettingsClient Authentication Defaults + +@snippet google/cloud/compute/region_snapshot_settings/v1/samples/region_snapshot_settings_client_samples.cc with-service-account + +*/ + +/*! @page compute_region_snapshots_v1::RegionSnapshotsClient-service-account-snippet Override compute_region_snapshots_v1::RegionSnapshotsClient Authentication Defaults + +@snippet google/cloud/compute/region_snapshots/v1/samples/region_snapshots_client_samples.cc with-service-account + +*/ + /*! @page compute_region_ssl_certificates_v1::RegionSslCertificatesClient-service-account-snippet Override compute_region_ssl_certificates_v1::RegionSslCertificatesClient Authentication Defaults @snippet google/cloud/compute/region_ssl_certificates/v1/samples/region_ssl_certificates_client_samples.cc with-service-account @@ -597,12 +708,24 @@ guide for more details. */ +/*! @page compute_reliability_risks_v1::ReliabilityRisksClient-service-account-snippet Override compute_reliability_risks_v1::ReliabilityRisksClient Authentication Defaults + +@snippet google/cloud/compute/reliability_risks/v1/samples/reliability_risks_client_samples.cc with-service-account + +*/ + /*! @page compute_reservation_blocks_v1::ReservationBlocksClient-service-account-snippet Override compute_reservation_blocks_v1::ReservationBlocksClient Authentication Defaults @snippet google/cloud/compute/reservation_blocks/v1/samples/reservation_blocks_client_samples.cc with-service-account */ +/*! @page compute_reservation_slots_v1::ReservationSlotsClient-service-account-snippet Override compute_reservation_slots_v1::ReservationSlotsClient Authentication Defaults + +@snippet google/cloud/compute/reservation_slots/v1/samples/reservation_slots_client_samples.cc with-service-account + +*/ + /*! @page compute_reservation_sub_blocks_v1::ReservationSubBlocksClient-service-account-snippet Override compute_reservation_sub_blocks_v1::ReservationSubBlocksClient Authentication Defaults @snippet google/cloud/compute/reservation_sub_blocks/v1/samples/reservation_sub_blocks_client_samples.cc with-service-account @@ -621,6 +744,18 @@ guide for more details. */ +/*! @page compute_rollout_plans_v1::RolloutPlansClient-service-account-snippet Override compute_rollout_plans_v1::RolloutPlansClient Authentication Defaults + +@snippet google/cloud/compute/rollout_plans/v1/samples/rollout_plans_client_samples.cc with-service-account + +*/ + +/*! @page compute_rollouts_v1::RolloutsClient-service-account-snippet Override compute_rollouts_v1::RolloutsClient Authentication Defaults + +@snippet google/cloud/compute/rollouts/v1/samples/rollouts_client_samples.cc with-service-account + +*/ + /*! @page compute_routers_v1::RoutersClient-service-account-snippet Override compute_routers_v1::RoutersClient Authentication Defaults @snippet google/cloud/compute/routers/v1/samples/routers_client_samples.cc with-service-account @@ -753,12 +888,24 @@ guide for more details. */ +/*! @page compute_wire_groups_v1::WireGroupsClient-service-account-snippet Override compute_wire_groups_v1::WireGroupsClient Authentication Defaults + +@snippet google/cloud/compute/wire_groups/v1/samples/wire_groups_client_samples.cc with-service-account + +*/ + /*! @page compute_zone_operations_v1::ZoneOperationsClient-service-account-snippet Override compute_zone_operations_v1::ZoneOperationsClient Authentication Defaults @snippet google/cloud/compute/zone_operations/v1/samples/zone_operations_client_samples.cc with-service-account */ +/*! @page compute_zone_vm_extension_policies_v1::ZoneVmExtensionPoliciesClient-service-account-snippet Override compute_zone_vm_extension_policies_v1::ZoneVmExtensionPoliciesClient Authentication Defaults + +@snippet google/cloud/compute/zone_vm_extension_policies/v1/samples/zone_vm_extension_policies_client_samples.cc with-service-account + +*/ + /*! @page compute_zones_v1::ZonesClient-service-account-snippet Override compute_zones_v1::ZonesClient Authentication Defaults @snippet google/cloud/compute/zones/v1/samples/zones_client_samples.cc with-service-account diff --git a/google/cloud/compute/doc/override-endpoint.dox b/google/cloud/compute/doc/override-endpoint.dox index b3868c4f3c930..2d26872bd868e 100644 --- a/google/cloud/compute/doc/override-endpoint.dox +++ b/google/cloud/compute/doc/override-endpoint.dox @@ -15,9 +15,11 @@ Follow these links to find examples for other \c *Client classes: - [\c compute_accelerator_types_v1::AcceleratorTypesClient](@ref compute_accelerator_types_v1::AcceleratorTypesClient-endpoint-snippet) - [\c compute_addresses_v1::AddressesClient](@ref compute_addresses_v1::AddressesClient-endpoint-snippet) +- [\c compute_advice_v1::AdviceClient](@ref compute_advice_v1::AdviceClient-endpoint-snippet) - [\c compute_autoscalers_v1::AutoscalersClient](@ref compute_autoscalers_v1::AutoscalersClient-endpoint-snippet) - [\c compute_backend_buckets_v1::BackendBucketsClient](@ref compute_backend_buckets_v1::BackendBucketsClient-endpoint-snippet) - [\c compute_backend_services_v1::BackendServicesClient](@ref compute_backend_services_v1::BackendServicesClient-endpoint-snippet) +- [\c compute_cross_site_networks_v1::CrossSiteNetworksClient](@ref compute_cross_site_networks_v1::CrossSiteNetworksClient-endpoint-snippet) - [\c compute_disk_types_v1::DiskTypesClient](@ref compute_disk_types_v1::DiskTypesClient-endpoint-snippet) - [\c compute_disks_v1::DisksClient](@ref compute_disks_v1::DisksClient-endpoint-snippet) - [\c compute_external_vpn_gateways_v1::ExternalVpnGatewaysClient](@ref compute_external_vpn_gateways_v1::ExternalVpnGatewaysClient-endpoint-snippet) @@ -30,7 +32,9 @@ Follow these links to find examples for other \c *Client classes: - [\c compute_global_operations_v1::GlobalOperationsClient](@ref compute_global_operations_v1::GlobalOperationsClient-endpoint-snippet) - [\c compute_global_organization_operations_v1::GlobalOrganizationOperationsClient](@ref compute_global_organization_operations_v1::GlobalOrganizationOperationsClient-endpoint-snippet) - [\c compute_global_public_delegated_prefixes_v1::GlobalPublicDelegatedPrefixesClient](@ref compute_global_public_delegated_prefixes_v1::GlobalPublicDelegatedPrefixesClient-endpoint-snippet) +- [\c compute_global_vm_extension_policies_v1::GlobalVmExtensionPoliciesClient](@ref compute_global_vm_extension_policies_v1::GlobalVmExtensionPoliciesClient-endpoint-snippet) - [\c compute_health_checks_v1::HealthChecksClient](@ref compute_health_checks_v1::HealthChecksClient-endpoint-snippet) +- [\c compute_hosts_v1::HostsClient](@ref compute_hosts_v1::HostsClient-endpoint-snippet) - [\c compute_http_health_checks_v1::HttpHealthChecksClient](@ref compute_http_health_checks_v1::HttpHealthChecksClient-endpoint-snippet) - [\c compute_https_health_checks_v1::HttpsHealthChecksClient](@ref compute_https_health_checks_v1::HttpsHealthChecksClient-endpoint-snippet) - [\c compute_image_family_views_v1::ImageFamilyViewsClient](@ref compute_image_family_views_v1::ImageFamilyViewsClient-endpoint-snippet) @@ -41,6 +45,7 @@ Follow these links to find examples for other \c *Client classes: - [\c compute_instance_settings_v1::InstanceSettingsClient](@ref compute_instance_settings_v1::InstanceSettingsClient-endpoint-snippet) - [\c compute_instance_templates_v1::InstanceTemplatesClient](@ref compute_instance_templates_v1::InstanceTemplatesClient-endpoint-snippet) - [\c compute_instances_v1::InstancesClient](@ref compute_instances_v1::InstancesClient-endpoint-snippet) +- [\c compute_instant_snapshot_groups_v1::InstantSnapshotGroupsClient](@ref compute_instant_snapshot_groups_v1::InstantSnapshotGroupsClient-endpoint-snippet) - [\c compute_instant_snapshots_v1::InstantSnapshotsClient](@ref compute_instant_snapshots_v1::InstantSnapshotsClient-endpoint-snippet) - [\c compute_interconnect_attachment_groups_v1::InterconnectAttachmentGroupsClient](@ref compute_interconnect_attachment_groups_v1::InterconnectAttachmentGroupsClient-endpoint-snippet) - [\c compute_interconnect_attachments_v1::InterconnectAttachmentsClient](@ref compute_interconnect_attachments_v1::InterconnectAttachmentsClient-endpoint-snippet) @@ -61,27 +66,37 @@ Follow these links to find examples for other \c *Client classes: - [\c compute_node_groups_v1::NodeGroupsClient](@ref compute_node_groups_v1::NodeGroupsClient-endpoint-snippet) - [\c compute_node_templates_v1::NodeTemplatesClient](@ref compute_node_templates_v1::NodeTemplatesClient-endpoint-snippet) - [\c compute_node_types_v1::NodeTypesClient](@ref compute_node_types_v1::NodeTypesClient-endpoint-snippet) +- [\c compute_organization_security_policies_v1::OrganizationSecurityPoliciesClient](@ref compute_organization_security_policies_v1::OrganizationSecurityPoliciesClient-endpoint-snippet) - [\c compute_packet_mirrorings_v1::PacketMirroringsClient](@ref compute_packet_mirrorings_v1::PacketMirroringsClient-endpoint-snippet) +- [\c compute_preview_features_v1::PreviewFeaturesClient](@ref compute_preview_features_v1::PreviewFeaturesClient-endpoint-snippet) - [\c compute_projects_v1::ProjectsClient](@ref compute_projects_v1::ProjectsClient-endpoint-snippet) - [\c compute_public_advertised_prefixes_v1::PublicAdvertisedPrefixesClient](@ref compute_public_advertised_prefixes_v1::PublicAdvertisedPrefixesClient-endpoint-snippet) - [\c compute_public_delegated_prefixes_v1::PublicDelegatedPrefixesClient](@ref compute_public_delegated_prefixes_v1::PublicDelegatedPrefixesClient-endpoint-snippet) - [\c compute_region_autoscalers_v1::RegionAutoscalersClient](@ref compute_region_autoscalers_v1::RegionAutoscalersClient-endpoint-snippet) +- [\c compute_region_backend_buckets_v1::RegionBackendBucketsClient](@ref compute_region_backend_buckets_v1::RegionBackendBucketsClient-endpoint-snippet) - [\c compute_region_backend_services_v1::RegionBackendServicesClient](@ref compute_region_backend_services_v1::RegionBackendServicesClient-endpoint-snippet) - [\c compute_region_commitments_v1::RegionCommitmentsClient](@ref compute_region_commitments_v1::RegionCommitmentsClient-endpoint-snippet) +- [\c compute_region_composite_health_checks_v1::RegionCompositeHealthChecksClient](@ref compute_region_composite_health_checks_v1::RegionCompositeHealthChecksClient-endpoint-snippet) - [\c compute_region_disk_types_v1::RegionDiskTypesClient](@ref compute_region_disk_types_v1::RegionDiskTypesClient-endpoint-snippet) - [\c compute_region_disks_v1::RegionDisksClient](@ref compute_region_disks_v1::RegionDisksClient-endpoint-snippet) +- [\c compute_region_health_aggregation_policies_v1::RegionHealthAggregationPoliciesClient](@ref compute_region_health_aggregation_policies_v1::RegionHealthAggregationPoliciesClient-endpoint-snippet) - [\c compute_region_health_check_services_v1::RegionHealthCheckServicesClient](@ref compute_region_health_check_services_v1::RegionHealthCheckServicesClient-endpoint-snippet) - [\c compute_region_health_checks_v1::RegionHealthChecksClient](@ref compute_region_health_checks_v1::RegionHealthChecksClient-endpoint-snippet) +- [\c compute_region_health_sources_v1::RegionHealthSourcesClient](@ref compute_region_health_sources_v1::RegionHealthSourcesClient-endpoint-snippet) +- [\c compute_region_instance_group_manager_resize_requests_v1::RegionInstanceGroupManagerResizeRequestsClient](@ref compute_region_instance_group_manager_resize_requests_v1::RegionInstanceGroupManagerResizeRequestsClient-endpoint-snippet) - [\c compute_region_instance_group_managers_v1::RegionInstanceGroupManagersClient](@ref compute_region_instance_group_managers_v1::RegionInstanceGroupManagersClient-endpoint-snippet) - [\c compute_region_instance_groups_v1::RegionInstanceGroupsClient](@ref compute_region_instance_groups_v1::RegionInstanceGroupsClient-endpoint-snippet) - [\c compute_region_instance_templates_v1::RegionInstanceTemplatesClient](@ref compute_region_instance_templates_v1::RegionInstanceTemplatesClient-endpoint-snippet) - [\c compute_region_instances_v1::RegionInstancesClient](@ref compute_region_instances_v1::RegionInstancesClient-endpoint-snippet) +- [\c compute_region_instant_snapshot_groups_v1::RegionInstantSnapshotGroupsClient](@ref compute_region_instant_snapshot_groups_v1::RegionInstantSnapshotGroupsClient-endpoint-snippet) - [\c compute_region_instant_snapshots_v1::RegionInstantSnapshotsClient](@ref compute_region_instant_snapshots_v1::RegionInstantSnapshotsClient-endpoint-snippet) - [\c compute_region_network_endpoint_groups_v1::RegionNetworkEndpointGroupsClient](@ref compute_region_network_endpoint_groups_v1::RegionNetworkEndpointGroupsClient-endpoint-snippet) - [\c compute_region_network_firewall_policies_v1::RegionNetworkFirewallPoliciesClient](@ref compute_region_network_firewall_policies_v1::RegionNetworkFirewallPoliciesClient-endpoint-snippet) - [\c compute_region_notification_endpoints_v1::RegionNotificationEndpointsClient](@ref compute_region_notification_endpoints_v1::RegionNotificationEndpointsClient-endpoint-snippet) - [\c compute_region_operations_v1::RegionOperationsClient](@ref compute_region_operations_v1::RegionOperationsClient-endpoint-snippet) - [\c compute_region_security_policies_v1::RegionSecurityPoliciesClient](@ref compute_region_security_policies_v1::RegionSecurityPoliciesClient-endpoint-snippet) +- [\c compute_region_snapshot_settings_v1::RegionSnapshotSettingsClient](@ref compute_region_snapshot_settings_v1::RegionSnapshotSettingsClient-endpoint-snippet) +- [\c compute_region_snapshots_v1::RegionSnapshotsClient](@ref compute_region_snapshots_v1::RegionSnapshotsClient-endpoint-snippet) - [\c compute_region_ssl_certificates_v1::RegionSslCertificatesClient](@ref compute_region_ssl_certificates_v1::RegionSslCertificatesClient-endpoint-snippet) - [\c compute_region_ssl_policies_v1::RegionSslPoliciesClient](@ref compute_region_ssl_policies_v1::RegionSslPoliciesClient-endpoint-snippet) - [\c compute_region_target_http_proxies_v1::RegionTargetHttpProxiesClient](@ref compute_region_target_http_proxies_v1::RegionTargetHttpProxiesClient-endpoint-snippet) @@ -90,10 +105,14 @@ Follow these links to find examples for other \c *Client classes: - [\c compute_region_url_maps_v1::RegionUrlMapsClient](@ref compute_region_url_maps_v1::RegionUrlMapsClient-endpoint-snippet) - [\c compute_region_zones_v1::RegionZonesClient](@ref compute_region_zones_v1::RegionZonesClient-endpoint-snippet) - [\c compute_regions_v1::RegionsClient](@ref compute_regions_v1::RegionsClient-endpoint-snippet) +- [\c compute_reliability_risks_v1::ReliabilityRisksClient](@ref compute_reliability_risks_v1::ReliabilityRisksClient-endpoint-snippet) - [\c compute_reservation_blocks_v1::ReservationBlocksClient](@ref compute_reservation_blocks_v1::ReservationBlocksClient-endpoint-snippet) +- [\c compute_reservation_slots_v1::ReservationSlotsClient](@ref compute_reservation_slots_v1::ReservationSlotsClient-endpoint-snippet) - [\c compute_reservation_sub_blocks_v1::ReservationSubBlocksClient](@ref compute_reservation_sub_blocks_v1::ReservationSubBlocksClient-endpoint-snippet) - [\c compute_reservations_v1::ReservationsClient](@ref compute_reservations_v1::ReservationsClient-endpoint-snippet) - [\c compute_resource_policies_v1::ResourcePoliciesClient](@ref compute_resource_policies_v1::ResourcePoliciesClient-endpoint-snippet) +- [\c compute_rollout_plans_v1::RolloutPlansClient](@ref compute_rollout_plans_v1::RolloutPlansClient-endpoint-snippet) +- [\c compute_rollouts_v1::RolloutsClient](@ref compute_rollouts_v1::RolloutsClient-endpoint-snippet) - [\c compute_routers_v1::RoutersClient](@ref compute_routers_v1::RoutersClient-endpoint-snippet) - [\c compute_routes_v1::RoutesClient](@ref compute_routes_v1::RoutesClient-endpoint-snippet) - [\c compute_security_policies_v1::SecurityPoliciesClient](@ref compute_security_policies_v1::SecurityPoliciesClient-endpoint-snippet) @@ -116,7 +135,9 @@ Follow these links to find examples for other \c *Client classes: - [\c compute_url_maps_v1::UrlMapsClient](@ref compute_url_maps_v1::UrlMapsClient-endpoint-snippet) - [\c compute_vpn_gateways_v1::VpnGatewaysClient](@ref compute_vpn_gateways_v1::VpnGatewaysClient-endpoint-snippet) - [\c compute_vpn_tunnels_v1::VpnTunnelsClient](@ref compute_vpn_tunnels_v1::VpnTunnelsClient-endpoint-snippet) +- [\c compute_wire_groups_v1::WireGroupsClient](@ref compute_wire_groups_v1::WireGroupsClient-endpoint-snippet) - [\c compute_zone_operations_v1::ZoneOperationsClient](@ref compute_zone_operations_v1::ZoneOperationsClient-endpoint-snippet) +- [\c compute_zone_vm_extension_policies_v1::ZoneVmExtensionPoliciesClient](@ref compute_zone_vm_extension_policies_v1::ZoneVmExtensionPoliciesClient-endpoint-snippet) - [\c compute_zones_v1::ZonesClient](@ref compute_zones_v1::ZonesClient-endpoint-snippet) @@ -137,6 +158,12 @@ Follow these links to find examples for other \c *Client classes: */ +/*! @page compute_advice_v1::AdviceClient-endpoint-snippet Override compute_advice_v1::AdviceClient Endpoint Configuration + +@snippet google/cloud/compute/advice/v1/samples/advice_client_samples.cc set-client-endpoint + +*/ + /*! @page compute_autoscalers_v1::AutoscalersClient-endpoint-snippet Override compute_autoscalers_v1::AutoscalersClient Endpoint Configuration @snippet google/cloud/compute/autoscalers/v1/samples/autoscalers_client_samples.cc set-client-endpoint @@ -155,6 +182,12 @@ Follow these links to find examples for other \c *Client classes: */ +/*! @page compute_cross_site_networks_v1::CrossSiteNetworksClient-endpoint-snippet Override compute_cross_site_networks_v1::CrossSiteNetworksClient Endpoint Configuration + +@snippet google/cloud/compute/cross_site_networks/v1/samples/cross_site_networks_client_samples.cc set-client-endpoint + +*/ + /*! @page compute_disk_types_v1::DiskTypesClient-endpoint-snippet Override compute_disk_types_v1::DiskTypesClient Endpoint Configuration @snippet google/cloud/compute/disk_types/v1/samples/disk_types_client_samples.cc set-client-endpoint @@ -227,12 +260,24 @@ Follow these links to find examples for other \c *Client classes: */ +/*! @page compute_global_vm_extension_policies_v1::GlobalVmExtensionPoliciesClient-endpoint-snippet Override compute_global_vm_extension_policies_v1::GlobalVmExtensionPoliciesClient Endpoint Configuration + +@snippet google/cloud/compute/global_vm_extension_policies/v1/samples/global_vm_extension_policies_client_samples.cc set-client-endpoint + +*/ + /*! @page compute_health_checks_v1::HealthChecksClient-endpoint-snippet Override compute_health_checks_v1::HealthChecksClient Endpoint Configuration @snippet google/cloud/compute/health_checks/v1/samples/health_checks_client_samples.cc set-client-endpoint */ +/*! @page compute_hosts_v1::HostsClient-endpoint-snippet Override compute_hosts_v1::HostsClient Endpoint Configuration + +@snippet google/cloud/compute/hosts/v1/samples/hosts_client_samples.cc set-client-endpoint + +*/ + /*! @page compute_http_health_checks_v1::HttpHealthChecksClient-endpoint-snippet Override compute_http_health_checks_v1::HttpHealthChecksClient Endpoint Configuration @snippet google/cloud/compute/http_health_checks/v1/samples/http_health_checks_client_samples.cc set-client-endpoint @@ -293,6 +338,12 @@ Follow these links to find examples for other \c *Client classes: */ +/*! @page compute_instant_snapshot_groups_v1::InstantSnapshotGroupsClient-endpoint-snippet Override compute_instant_snapshot_groups_v1::InstantSnapshotGroupsClient Endpoint Configuration + +@snippet google/cloud/compute/instant_snapshot_groups/v1/samples/instant_snapshot_groups_client_samples.cc set-client-endpoint + +*/ + /*! @page compute_instant_snapshots_v1::InstantSnapshotsClient-endpoint-snippet Override compute_instant_snapshots_v1::InstantSnapshotsClient Endpoint Configuration @snippet google/cloud/compute/instant_snapshots/v1/samples/instant_snapshots_client_samples.cc set-client-endpoint @@ -413,12 +464,24 @@ Follow these links to find examples for other \c *Client classes: */ +/*! @page compute_organization_security_policies_v1::OrganizationSecurityPoliciesClient-endpoint-snippet Override compute_organization_security_policies_v1::OrganizationSecurityPoliciesClient Endpoint Configuration + +@snippet google/cloud/compute/organization_security_policies/v1/samples/organization_security_policies_client_samples.cc set-client-endpoint + +*/ + /*! @page compute_packet_mirrorings_v1::PacketMirroringsClient-endpoint-snippet Override compute_packet_mirrorings_v1::PacketMirroringsClient Endpoint Configuration @snippet google/cloud/compute/packet_mirrorings/v1/samples/packet_mirrorings_client_samples.cc set-client-endpoint */ +/*! @page compute_preview_features_v1::PreviewFeaturesClient-endpoint-snippet Override compute_preview_features_v1::PreviewFeaturesClient Endpoint Configuration + +@snippet google/cloud/compute/preview_features/v1/samples/preview_features_client_samples.cc set-client-endpoint + +*/ + /*! @page compute_projects_v1::ProjectsClient-endpoint-snippet Override compute_projects_v1::ProjectsClient Endpoint Configuration @snippet google/cloud/compute/projects/v1/samples/projects_client_samples.cc set-client-endpoint @@ -443,6 +506,12 @@ Follow these links to find examples for other \c *Client classes: */ +/*! @page compute_region_backend_buckets_v1::RegionBackendBucketsClient-endpoint-snippet Override compute_region_backend_buckets_v1::RegionBackendBucketsClient Endpoint Configuration + +@snippet google/cloud/compute/region_backend_buckets/v1/samples/region_backend_buckets_client_samples.cc set-client-endpoint + +*/ + /*! @page compute_region_backend_services_v1::RegionBackendServicesClient-endpoint-snippet Override compute_region_backend_services_v1::RegionBackendServicesClient Endpoint Configuration @snippet google/cloud/compute/region_backend_services/v1/samples/region_backend_services_client_samples.cc set-client-endpoint @@ -455,6 +524,12 @@ Follow these links to find examples for other \c *Client classes: */ +/*! @page compute_region_composite_health_checks_v1::RegionCompositeHealthChecksClient-endpoint-snippet Override compute_region_composite_health_checks_v1::RegionCompositeHealthChecksClient Endpoint Configuration + +@snippet google/cloud/compute/region_composite_health_checks/v1/samples/region_composite_health_checks_client_samples.cc set-client-endpoint + +*/ + /*! @page compute_region_disk_types_v1::RegionDiskTypesClient-endpoint-snippet Override compute_region_disk_types_v1::RegionDiskTypesClient Endpoint Configuration @snippet google/cloud/compute/region_disk_types/v1/samples/region_disk_types_client_samples.cc set-client-endpoint @@ -467,6 +542,12 @@ Follow these links to find examples for other \c *Client classes: */ +/*! @page compute_region_health_aggregation_policies_v1::RegionHealthAggregationPoliciesClient-endpoint-snippet Override compute_region_health_aggregation_policies_v1::RegionHealthAggregationPoliciesClient Endpoint Configuration + +@snippet google/cloud/compute/region_health_aggregation_policies/v1/samples/region_health_aggregation_policies_client_samples.cc set-client-endpoint + +*/ + /*! @page compute_region_health_check_services_v1::RegionHealthCheckServicesClient-endpoint-snippet Override compute_region_health_check_services_v1::RegionHealthCheckServicesClient Endpoint Configuration @snippet google/cloud/compute/region_health_check_services/v1/samples/region_health_check_services_client_samples.cc set-client-endpoint @@ -479,6 +560,18 @@ Follow these links to find examples for other \c *Client classes: */ +/*! @page compute_region_health_sources_v1::RegionHealthSourcesClient-endpoint-snippet Override compute_region_health_sources_v1::RegionHealthSourcesClient Endpoint Configuration + +@snippet google/cloud/compute/region_health_sources/v1/samples/region_health_sources_client_samples.cc set-client-endpoint + +*/ + +/*! @page compute_region_instance_group_manager_resize_requests_v1::RegionInstanceGroupManagerResizeRequestsClient-endpoint-snippet Override compute_region_instance_group_manager_resize_requests_v1::RegionInstanceGroupManagerResizeRequestsClient Endpoint Configuration + +@snippet google/cloud/compute/region_instance_group_manager_resize_requests/v1/samples/region_instance_group_manager_resize_requests_client_samples.cc set-client-endpoint + +*/ + /*! @page compute_region_instance_group_managers_v1::RegionInstanceGroupManagersClient-endpoint-snippet Override compute_region_instance_group_managers_v1::RegionInstanceGroupManagersClient Endpoint Configuration @snippet google/cloud/compute/region_instance_group_managers/v1/samples/region_instance_group_managers_client_samples.cc set-client-endpoint @@ -503,6 +596,12 @@ Follow these links to find examples for other \c *Client classes: */ +/*! @page compute_region_instant_snapshot_groups_v1::RegionInstantSnapshotGroupsClient-endpoint-snippet Override compute_region_instant_snapshot_groups_v1::RegionInstantSnapshotGroupsClient Endpoint Configuration + +@snippet google/cloud/compute/region_instant_snapshot_groups/v1/samples/region_instant_snapshot_groups_client_samples.cc set-client-endpoint + +*/ + /*! @page compute_region_instant_snapshots_v1::RegionInstantSnapshotsClient-endpoint-snippet Override compute_region_instant_snapshots_v1::RegionInstantSnapshotsClient Endpoint Configuration @snippet google/cloud/compute/region_instant_snapshots/v1/samples/region_instant_snapshots_client_samples.cc set-client-endpoint @@ -539,6 +638,18 @@ Follow these links to find examples for other \c *Client classes: */ +/*! @page compute_region_snapshot_settings_v1::RegionSnapshotSettingsClient-endpoint-snippet Override compute_region_snapshot_settings_v1::RegionSnapshotSettingsClient Endpoint Configuration + +@snippet google/cloud/compute/region_snapshot_settings/v1/samples/region_snapshot_settings_client_samples.cc set-client-endpoint + +*/ + +/*! @page compute_region_snapshots_v1::RegionSnapshotsClient-endpoint-snippet Override compute_region_snapshots_v1::RegionSnapshotsClient Endpoint Configuration + +@snippet google/cloud/compute/region_snapshots/v1/samples/region_snapshots_client_samples.cc set-client-endpoint + +*/ + /*! @page compute_region_ssl_certificates_v1::RegionSslCertificatesClient-endpoint-snippet Override compute_region_ssl_certificates_v1::RegionSslCertificatesClient Endpoint Configuration @snippet google/cloud/compute/region_ssl_certificates/v1/samples/region_ssl_certificates_client_samples.cc set-client-endpoint @@ -587,12 +698,24 @@ Follow these links to find examples for other \c *Client classes: */ +/*! @page compute_reliability_risks_v1::ReliabilityRisksClient-endpoint-snippet Override compute_reliability_risks_v1::ReliabilityRisksClient Endpoint Configuration + +@snippet google/cloud/compute/reliability_risks/v1/samples/reliability_risks_client_samples.cc set-client-endpoint + +*/ + /*! @page compute_reservation_blocks_v1::ReservationBlocksClient-endpoint-snippet Override compute_reservation_blocks_v1::ReservationBlocksClient Endpoint Configuration @snippet google/cloud/compute/reservation_blocks/v1/samples/reservation_blocks_client_samples.cc set-client-endpoint */ +/*! @page compute_reservation_slots_v1::ReservationSlotsClient-endpoint-snippet Override compute_reservation_slots_v1::ReservationSlotsClient Endpoint Configuration + +@snippet google/cloud/compute/reservation_slots/v1/samples/reservation_slots_client_samples.cc set-client-endpoint + +*/ + /*! @page compute_reservation_sub_blocks_v1::ReservationSubBlocksClient-endpoint-snippet Override compute_reservation_sub_blocks_v1::ReservationSubBlocksClient Endpoint Configuration @snippet google/cloud/compute/reservation_sub_blocks/v1/samples/reservation_sub_blocks_client_samples.cc set-client-endpoint @@ -611,6 +734,18 @@ Follow these links to find examples for other \c *Client classes: */ +/*! @page compute_rollout_plans_v1::RolloutPlansClient-endpoint-snippet Override compute_rollout_plans_v1::RolloutPlansClient Endpoint Configuration + +@snippet google/cloud/compute/rollout_plans/v1/samples/rollout_plans_client_samples.cc set-client-endpoint + +*/ + +/*! @page compute_rollouts_v1::RolloutsClient-endpoint-snippet Override compute_rollouts_v1::RolloutsClient Endpoint Configuration + +@snippet google/cloud/compute/rollouts/v1/samples/rollouts_client_samples.cc set-client-endpoint + +*/ + /*! @page compute_routers_v1::RoutersClient-endpoint-snippet Override compute_routers_v1::RoutersClient Endpoint Configuration @snippet google/cloud/compute/routers/v1/samples/routers_client_samples.cc set-client-endpoint @@ -743,12 +878,24 @@ Follow these links to find examples for other \c *Client classes: */ +/*! @page compute_wire_groups_v1::WireGroupsClient-endpoint-snippet Override compute_wire_groups_v1::WireGroupsClient Endpoint Configuration + +@snippet google/cloud/compute/wire_groups/v1/samples/wire_groups_client_samples.cc set-client-endpoint + +*/ + /*! @page compute_zone_operations_v1::ZoneOperationsClient-endpoint-snippet Override compute_zone_operations_v1::ZoneOperationsClient Endpoint Configuration @snippet google/cloud/compute/zone_operations/v1/samples/zone_operations_client_samples.cc set-client-endpoint */ +/*! @page compute_zone_vm_extension_policies_v1::ZoneVmExtensionPoliciesClient-endpoint-snippet Override compute_zone_vm_extension_policies_v1::ZoneVmExtensionPoliciesClient Endpoint Configuration + +@snippet google/cloud/compute/zone_vm_extension_policies/v1/samples/zone_vm_extension_policies_client_samples.cc set-client-endpoint + +*/ + /*! @page compute_zones_v1::ZonesClient-endpoint-snippet Override compute_zones_v1::ZonesClient Endpoint Configuration @snippet google/cloud/compute/zones/v1/samples/zones_client_samples.cc set-client-endpoint diff --git a/google/cloud/compute/doc/override-retry-policies.dox b/google/cloud/compute/doc/override-retry-policies.dox index 61921c48aafbb..48d13493af4b2 100644 --- a/google/cloud/compute/doc/override-retry-policies.dox +++ b/google/cloud/compute/doc/override-retry-policies.dox @@ -81,9 +81,11 @@ Follow these links to find examples for other \c *Client classes: - [\c compute_accelerator_types_v1::AcceleratorTypesClient](@ref compute_accelerator_types_v1::AcceleratorTypesClient-retry-snippet) - [\c compute_addresses_v1::AddressesClient](@ref compute_addresses_v1::AddressesClient-retry-snippet) +- [\c compute_advice_v1::AdviceClient](@ref compute_advice_v1::AdviceClient-retry-snippet) - [\c compute_autoscalers_v1::AutoscalersClient](@ref compute_autoscalers_v1::AutoscalersClient-retry-snippet) - [\c compute_backend_buckets_v1::BackendBucketsClient](@ref compute_backend_buckets_v1::BackendBucketsClient-retry-snippet) - [\c compute_backend_services_v1::BackendServicesClient](@ref compute_backend_services_v1::BackendServicesClient-retry-snippet) +- [\c compute_cross_site_networks_v1::CrossSiteNetworksClient](@ref compute_cross_site_networks_v1::CrossSiteNetworksClient-retry-snippet) - [\c compute_disk_types_v1::DiskTypesClient](@ref compute_disk_types_v1::DiskTypesClient-retry-snippet) - [\c compute_disks_v1::DisksClient](@ref compute_disks_v1::DisksClient-retry-snippet) - [\c compute_external_vpn_gateways_v1::ExternalVpnGatewaysClient](@ref compute_external_vpn_gateways_v1::ExternalVpnGatewaysClient-retry-snippet) @@ -96,7 +98,9 @@ Follow these links to find examples for other \c *Client classes: - [\c compute_global_operations_v1::GlobalOperationsClient](@ref compute_global_operations_v1::GlobalOperationsClient-retry-snippet) - [\c compute_global_organization_operations_v1::GlobalOrganizationOperationsClient](@ref compute_global_organization_operations_v1::GlobalOrganizationOperationsClient-retry-snippet) - [\c compute_global_public_delegated_prefixes_v1::GlobalPublicDelegatedPrefixesClient](@ref compute_global_public_delegated_prefixes_v1::GlobalPublicDelegatedPrefixesClient-retry-snippet) +- [\c compute_global_vm_extension_policies_v1::GlobalVmExtensionPoliciesClient](@ref compute_global_vm_extension_policies_v1::GlobalVmExtensionPoliciesClient-retry-snippet) - [\c compute_health_checks_v1::HealthChecksClient](@ref compute_health_checks_v1::HealthChecksClient-retry-snippet) +- [\c compute_hosts_v1::HostsClient](@ref compute_hosts_v1::HostsClient-retry-snippet) - [\c compute_http_health_checks_v1::HttpHealthChecksClient](@ref compute_http_health_checks_v1::HttpHealthChecksClient-retry-snippet) - [\c compute_https_health_checks_v1::HttpsHealthChecksClient](@ref compute_https_health_checks_v1::HttpsHealthChecksClient-retry-snippet) - [\c compute_image_family_views_v1::ImageFamilyViewsClient](@ref compute_image_family_views_v1::ImageFamilyViewsClient-retry-snippet) @@ -107,6 +111,7 @@ Follow these links to find examples for other \c *Client classes: - [\c compute_instance_settings_v1::InstanceSettingsClient](@ref compute_instance_settings_v1::InstanceSettingsClient-retry-snippet) - [\c compute_instance_templates_v1::InstanceTemplatesClient](@ref compute_instance_templates_v1::InstanceTemplatesClient-retry-snippet) - [\c compute_instances_v1::InstancesClient](@ref compute_instances_v1::InstancesClient-retry-snippet) +- [\c compute_instant_snapshot_groups_v1::InstantSnapshotGroupsClient](@ref compute_instant_snapshot_groups_v1::InstantSnapshotGroupsClient-retry-snippet) - [\c compute_instant_snapshots_v1::InstantSnapshotsClient](@ref compute_instant_snapshots_v1::InstantSnapshotsClient-retry-snippet) - [\c compute_interconnect_attachment_groups_v1::InterconnectAttachmentGroupsClient](@ref compute_interconnect_attachment_groups_v1::InterconnectAttachmentGroupsClient-retry-snippet) - [\c compute_interconnect_attachments_v1::InterconnectAttachmentsClient](@ref compute_interconnect_attachments_v1::InterconnectAttachmentsClient-retry-snippet) @@ -127,27 +132,37 @@ Follow these links to find examples for other \c *Client classes: - [\c compute_node_groups_v1::NodeGroupsClient](@ref compute_node_groups_v1::NodeGroupsClient-retry-snippet) - [\c compute_node_templates_v1::NodeTemplatesClient](@ref compute_node_templates_v1::NodeTemplatesClient-retry-snippet) - [\c compute_node_types_v1::NodeTypesClient](@ref compute_node_types_v1::NodeTypesClient-retry-snippet) +- [\c compute_organization_security_policies_v1::OrganizationSecurityPoliciesClient](@ref compute_organization_security_policies_v1::OrganizationSecurityPoliciesClient-retry-snippet) - [\c compute_packet_mirrorings_v1::PacketMirroringsClient](@ref compute_packet_mirrorings_v1::PacketMirroringsClient-retry-snippet) +- [\c compute_preview_features_v1::PreviewFeaturesClient](@ref compute_preview_features_v1::PreviewFeaturesClient-retry-snippet) - [\c compute_projects_v1::ProjectsClient](@ref compute_projects_v1::ProjectsClient-retry-snippet) - [\c compute_public_advertised_prefixes_v1::PublicAdvertisedPrefixesClient](@ref compute_public_advertised_prefixes_v1::PublicAdvertisedPrefixesClient-retry-snippet) - [\c compute_public_delegated_prefixes_v1::PublicDelegatedPrefixesClient](@ref compute_public_delegated_prefixes_v1::PublicDelegatedPrefixesClient-retry-snippet) - [\c compute_region_autoscalers_v1::RegionAutoscalersClient](@ref compute_region_autoscalers_v1::RegionAutoscalersClient-retry-snippet) +- [\c compute_region_backend_buckets_v1::RegionBackendBucketsClient](@ref compute_region_backend_buckets_v1::RegionBackendBucketsClient-retry-snippet) - [\c compute_region_backend_services_v1::RegionBackendServicesClient](@ref compute_region_backend_services_v1::RegionBackendServicesClient-retry-snippet) - [\c compute_region_commitments_v1::RegionCommitmentsClient](@ref compute_region_commitments_v1::RegionCommitmentsClient-retry-snippet) +- [\c compute_region_composite_health_checks_v1::RegionCompositeHealthChecksClient](@ref compute_region_composite_health_checks_v1::RegionCompositeHealthChecksClient-retry-snippet) - [\c compute_region_disk_types_v1::RegionDiskTypesClient](@ref compute_region_disk_types_v1::RegionDiskTypesClient-retry-snippet) - [\c compute_region_disks_v1::RegionDisksClient](@ref compute_region_disks_v1::RegionDisksClient-retry-snippet) +- [\c compute_region_health_aggregation_policies_v1::RegionHealthAggregationPoliciesClient](@ref compute_region_health_aggregation_policies_v1::RegionHealthAggregationPoliciesClient-retry-snippet) - [\c compute_region_health_check_services_v1::RegionHealthCheckServicesClient](@ref compute_region_health_check_services_v1::RegionHealthCheckServicesClient-retry-snippet) - [\c compute_region_health_checks_v1::RegionHealthChecksClient](@ref compute_region_health_checks_v1::RegionHealthChecksClient-retry-snippet) +- [\c compute_region_health_sources_v1::RegionHealthSourcesClient](@ref compute_region_health_sources_v1::RegionHealthSourcesClient-retry-snippet) +- [\c compute_region_instance_group_manager_resize_requests_v1::RegionInstanceGroupManagerResizeRequestsClient](@ref compute_region_instance_group_manager_resize_requests_v1::RegionInstanceGroupManagerResizeRequestsClient-retry-snippet) - [\c compute_region_instance_group_managers_v1::RegionInstanceGroupManagersClient](@ref compute_region_instance_group_managers_v1::RegionInstanceGroupManagersClient-retry-snippet) - [\c compute_region_instance_groups_v1::RegionInstanceGroupsClient](@ref compute_region_instance_groups_v1::RegionInstanceGroupsClient-retry-snippet) - [\c compute_region_instance_templates_v1::RegionInstanceTemplatesClient](@ref compute_region_instance_templates_v1::RegionInstanceTemplatesClient-retry-snippet) - [\c compute_region_instances_v1::RegionInstancesClient](@ref compute_region_instances_v1::RegionInstancesClient-retry-snippet) +- [\c compute_region_instant_snapshot_groups_v1::RegionInstantSnapshotGroupsClient](@ref compute_region_instant_snapshot_groups_v1::RegionInstantSnapshotGroupsClient-retry-snippet) - [\c compute_region_instant_snapshots_v1::RegionInstantSnapshotsClient](@ref compute_region_instant_snapshots_v1::RegionInstantSnapshotsClient-retry-snippet) - [\c compute_region_network_endpoint_groups_v1::RegionNetworkEndpointGroupsClient](@ref compute_region_network_endpoint_groups_v1::RegionNetworkEndpointGroupsClient-retry-snippet) - [\c compute_region_network_firewall_policies_v1::RegionNetworkFirewallPoliciesClient](@ref compute_region_network_firewall_policies_v1::RegionNetworkFirewallPoliciesClient-retry-snippet) - [\c compute_region_notification_endpoints_v1::RegionNotificationEndpointsClient](@ref compute_region_notification_endpoints_v1::RegionNotificationEndpointsClient-retry-snippet) - [\c compute_region_operations_v1::RegionOperationsClient](@ref compute_region_operations_v1::RegionOperationsClient-retry-snippet) - [\c compute_region_security_policies_v1::RegionSecurityPoliciesClient](@ref compute_region_security_policies_v1::RegionSecurityPoliciesClient-retry-snippet) +- [\c compute_region_snapshot_settings_v1::RegionSnapshotSettingsClient](@ref compute_region_snapshot_settings_v1::RegionSnapshotSettingsClient-retry-snippet) +- [\c compute_region_snapshots_v1::RegionSnapshotsClient](@ref compute_region_snapshots_v1::RegionSnapshotsClient-retry-snippet) - [\c compute_region_ssl_certificates_v1::RegionSslCertificatesClient](@ref compute_region_ssl_certificates_v1::RegionSslCertificatesClient-retry-snippet) - [\c compute_region_ssl_policies_v1::RegionSslPoliciesClient](@ref compute_region_ssl_policies_v1::RegionSslPoliciesClient-retry-snippet) - [\c compute_region_target_http_proxies_v1::RegionTargetHttpProxiesClient](@ref compute_region_target_http_proxies_v1::RegionTargetHttpProxiesClient-retry-snippet) @@ -156,10 +171,14 @@ Follow these links to find examples for other \c *Client classes: - [\c compute_region_url_maps_v1::RegionUrlMapsClient](@ref compute_region_url_maps_v1::RegionUrlMapsClient-retry-snippet) - [\c compute_region_zones_v1::RegionZonesClient](@ref compute_region_zones_v1::RegionZonesClient-retry-snippet) - [\c compute_regions_v1::RegionsClient](@ref compute_regions_v1::RegionsClient-retry-snippet) +- [\c compute_reliability_risks_v1::ReliabilityRisksClient](@ref compute_reliability_risks_v1::ReliabilityRisksClient-retry-snippet) - [\c compute_reservation_blocks_v1::ReservationBlocksClient](@ref compute_reservation_blocks_v1::ReservationBlocksClient-retry-snippet) +- [\c compute_reservation_slots_v1::ReservationSlotsClient](@ref compute_reservation_slots_v1::ReservationSlotsClient-retry-snippet) - [\c compute_reservation_sub_blocks_v1::ReservationSubBlocksClient](@ref compute_reservation_sub_blocks_v1::ReservationSubBlocksClient-retry-snippet) - [\c compute_reservations_v1::ReservationsClient](@ref compute_reservations_v1::ReservationsClient-retry-snippet) - [\c compute_resource_policies_v1::ResourcePoliciesClient](@ref compute_resource_policies_v1::ResourcePoliciesClient-retry-snippet) +- [\c compute_rollout_plans_v1::RolloutPlansClient](@ref compute_rollout_plans_v1::RolloutPlansClient-retry-snippet) +- [\c compute_rollouts_v1::RolloutsClient](@ref compute_rollouts_v1::RolloutsClient-retry-snippet) - [\c compute_routers_v1::RoutersClient](@ref compute_routers_v1::RoutersClient-retry-snippet) - [\c compute_routes_v1::RoutesClient](@ref compute_routes_v1::RoutesClient-retry-snippet) - [\c compute_security_policies_v1::SecurityPoliciesClient](@ref compute_security_policies_v1::SecurityPoliciesClient-retry-snippet) @@ -182,7 +201,9 @@ Follow these links to find examples for other \c *Client classes: - [\c compute_url_maps_v1::UrlMapsClient](@ref compute_url_maps_v1::UrlMapsClient-retry-snippet) - [\c compute_vpn_gateways_v1::VpnGatewaysClient](@ref compute_vpn_gateways_v1::VpnGatewaysClient-retry-snippet) - [\c compute_vpn_tunnels_v1::VpnTunnelsClient](@ref compute_vpn_tunnels_v1::VpnTunnelsClient-retry-snippet) +- [\c compute_wire_groups_v1::WireGroupsClient](@ref compute_wire_groups_v1::WireGroupsClient-retry-snippet) - [\c compute_zone_operations_v1::ZoneOperationsClient](@ref compute_zone_operations_v1::ZoneOperationsClient-retry-snippet) +- [\c compute_zone_vm_extension_policies_v1::ZoneVmExtensionPoliciesClient](@ref compute_zone_vm_extension_policies_v1::ZoneVmExtensionPoliciesClient-retry-snippet) - [\c compute_zones_v1::ZonesClient](@ref compute_zones_v1::ZonesClient-retry-snippet) @@ -223,6 +244,18 @@ Assuming you have created a custom idempotency policy. Such as: */ +/*! @page compute_advice_v1::AdviceClient-retry-snippet Override compute_advice_v1::AdviceClient Retry Policies + +This shows how to override the retry policies for compute_advice_v1::AdviceClient: + +@snippet google/cloud/compute/advice/v1/samples/advice_client_samples.cc set-retry-policy + +Assuming you have created a custom idempotency policy. Such as: + +@snippet google/cloud/compute/advice/v1/samples/advice_client_samples.cc custom-idempotency-policy + +*/ + /*! @page compute_autoscalers_v1::AutoscalersClient-retry-snippet Override compute_autoscalers_v1::AutoscalersClient Retry Policies This shows how to override the retry policies for compute_autoscalers_v1::AutoscalersClient: @@ -259,6 +292,18 @@ Assuming you have created a custom idempotency policy. Such as: */ +/*! @page compute_cross_site_networks_v1::CrossSiteNetworksClient-retry-snippet Override compute_cross_site_networks_v1::CrossSiteNetworksClient Retry Policies + +This shows how to override the retry policies for compute_cross_site_networks_v1::CrossSiteNetworksClient: + +@snippet google/cloud/compute/cross_site_networks/v1/samples/cross_site_networks_client_samples.cc set-retry-policy + +Assuming you have created a custom idempotency policy. Such as: + +@snippet google/cloud/compute/cross_site_networks/v1/samples/cross_site_networks_client_samples.cc custom-idempotency-policy + +*/ + /*! @page compute_disk_types_v1::DiskTypesClient-retry-snippet Override compute_disk_types_v1::DiskTypesClient Retry Policies This shows how to override the retry policies for compute_disk_types_v1::DiskTypesClient: @@ -403,6 +448,18 @@ Assuming you have created a custom idempotency policy. Such as: */ +/*! @page compute_global_vm_extension_policies_v1::GlobalVmExtensionPoliciesClient-retry-snippet Override compute_global_vm_extension_policies_v1::GlobalVmExtensionPoliciesClient Retry Policies + +This shows how to override the retry policies for compute_global_vm_extension_policies_v1::GlobalVmExtensionPoliciesClient: + +@snippet google/cloud/compute/global_vm_extension_policies/v1/samples/global_vm_extension_policies_client_samples.cc set-retry-policy + +Assuming you have created a custom idempotency policy. Such as: + +@snippet google/cloud/compute/global_vm_extension_policies/v1/samples/global_vm_extension_policies_client_samples.cc custom-idempotency-policy + +*/ + /*! @page compute_health_checks_v1::HealthChecksClient-retry-snippet Override compute_health_checks_v1::HealthChecksClient Retry Policies This shows how to override the retry policies for compute_health_checks_v1::HealthChecksClient: @@ -415,6 +472,18 @@ Assuming you have created a custom idempotency policy. Such as: */ +/*! @page compute_hosts_v1::HostsClient-retry-snippet Override compute_hosts_v1::HostsClient Retry Policies + +This shows how to override the retry policies for compute_hosts_v1::HostsClient: + +@snippet google/cloud/compute/hosts/v1/samples/hosts_client_samples.cc set-retry-policy + +Assuming you have created a custom idempotency policy. Such as: + +@snippet google/cloud/compute/hosts/v1/samples/hosts_client_samples.cc custom-idempotency-policy + +*/ + /*! @page compute_http_health_checks_v1::HttpHealthChecksClient-retry-snippet Override compute_http_health_checks_v1::HttpHealthChecksClient Retry Policies This shows how to override the retry policies for compute_http_health_checks_v1::HttpHealthChecksClient: @@ -535,6 +604,18 @@ Assuming you have created a custom idempotency policy. Such as: */ +/*! @page compute_instant_snapshot_groups_v1::InstantSnapshotGroupsClient-retry-snippet Override compute_instant_snapshot_groups_v1::InstantSnapshotGroupsClient Retry Policies + +This shows how to override the retry policies for compute_instant_snapshot_groups_v1::InstantSnapshotGroupsClient: + +@snippet google/cloud/compute/instant_snapshot_groups/v1/samples/instant_snapshot_groups_client_samples.cc set-retry-policy + +Assuming you have created a custom idempotency policy. Such as: + +@snippet google/cloud/compute/instant_snapshot_groups/v1/samples/instant_snapshot_groups_client_samples.cc custom-idempotency-policy + +*/ + /*! @page compute_instant_snapshots_v1::InstantSnapshotsClient-retry-snippet Override compute_instant_snapshots_v1::InstantSnapshotsClient Retry Policies This shows how to override the retry policies for compute_instant_snapshots_v1::InstantSnapshotsClient: @@ -775,6 +856,18 @@ Assuming you have created a custom idempotency policy. Such as: */ +/*! @page compute_organization_security_policies_v1::OrganizationSecurityPoliciesClient-retry-snippet Override compute_organization_security_policies_v1::OrganizationSecurityPoliciesClient Retry Policies + +This shows how to override the retry policies for compute_organization_security_policies_v1::OrganizationSecurityPoliciesClient: + +@snippet google/cloud/compute/organization_security_policies/v1/samples/organization_security_policies_client_samples.cc set-retry-policy + +Assuming you have created a custom idempotency policy. Such as: + +@snippet google/cloud/compute/organization_security_policies/v1/samples/organization_security_policies_client_samples.cc custom-idempotency-policy + +*/ + /*! @page compute_packet_mirrorings_v1::PacketMirroringsClient-retry-snippet Override compute_packet_mirrorings_v1::PacketMirroringsClient Retry Policies This shows how to override the retry policies for compute_packet_mirrorings_v1::PacketMirroringsClient: @@ -787,6 +880,18 @@ Assuming you have created a custom idempotency policy. Such as: */ +/*! @page compute_preview_features_v1::PreviewFeaturesClient-retry-snippet Override compute_preview_features_v1::PreviewFeaturesClient Retry Policies + +This shows how to override the retry policies for compute_preview_features_v1::PreviewFeaturesClient: + +@snippet google/cloud/compute/preview_features/v1/samples/preview_features_client_samples.cc set-retry-policy + +Assuming you have created a custom idempotency policy. Such as: + +@snippet google/cloud/compute/preview_features/v1/samples/preview_features_client_samples.cc custom-idempotency-policy + +*/ + /*! @page compute_projects_v1::ProjectsClient-retry-snippet Override compute_projects_v1::ProjectsClient Retry Policies This shows how to override the retry policies for compute_projects_v1::ProjectsClient: @@ -835,6 +940,18 @@ Assuming you have created a custom idempotency policy. Such as: */ +/*! @page compute_region_backend_buckets_v1::RegionBackendBucketsClient-retry-snippet Override compute_region_backend_buckets_v1::RegionBackendBucketsClient Retry Policies + +This shows how to override the retry policies for compute_region_backend_buckets_v1::RegionBackendBucketsClient: + +@snippet google/cloud/compute/region_backend_buckets/v1/samples/region_backend_buckets_client_samples.cc set-retry-policy + +Assuming you have created a custom idempotency policy. Such as: + +@snippet google/cloud/compute/region_backend_buckets/v1/samples/region_backend_buckets_client_samples.cc custom-idempotency-policy + +*/ + /*! @page compute_region_backend_services_v1::RegionBackendServicesClient-retry-snippet Override compute_region_backend_services_v1::RegionBackendServicesClient Retry Policies This shows how to override the retry policies for compute_region_backend_services_v1::RegionBackendServicesClient: @@ -859,6 +976,18 @@ Assuming you have created a custom idempotency policy. Such as: */ +/*! @page compute_region_composite_health_checks_v1::RegionCompositeHealthChecksClient-retry-snippet Override compute_region_composite_health_checks_v1::RegionCompositeHealthChecksClient Retry Policies + +This shows how to override the retry policies for compute_region_composite_health_checks_v1::RegionCompositeHealthChecksClient: + +@snippet google/cloud/compute/region_composite_health_checks/v1/samples/region_composite_health_checks_client_samples.cc set-retry-policy + +Assuming you have created a custom idempotency policy. Such as: + +@snippet google/cloud/compute/region_composite_health_checks/v1/samples/region_composite_health_checks_client_samples.cc custom-idempotency-policy + +*/ + /*! @page compute_region_disk_types_v1::RegionDiskTypesClient-retry-snippet Override compute_region_disk_types_v1::RegionDiskTypesClient Retry Policies This shows how to override the retry policies for compute_region_disk_types_v1::RegionDiskTypesClient: @@ -883,6 +1012,18 @@ Assuming you have created a custom idempotency policy. Such as: */ +/*! @page compute_region_health_aggregation_policies_v1::RegionHealthAggregationPoliciesClient-retry-snippet Override compute_region_health_aggregation_policies_v1::RegionHealthAggregationPoliciesClient Retry Policies + +This shows how to override the retry policies for compute_region_health_aggregation_policies_v1::RegionHealthAggregationPoliciesClient: + +@snippet google/cloud/compute/region_health_aggregation_policies/v1/samples/region_health_aggregation_policies_client_samples.cc set-retry-policy + +Assuming you have created a custom idempotency policy. Such as: + +@snippet google/cloud/compute/region_health_aggregation_policies/v1/samples/region_health_aggregation_policies_client_samples.cc custom-idempotency-policy + +*/ + /*! @page compute_region_health_check_services_v1::RegionHealthCheckServicesClient-retry-snippet Override compute_region_health_check_services_v1::RegionHealthCheckServicesClient Retry Policies This shows how to override the retry policies for compute_region_health_check_services_v1::RegionHealthCheckServicesClient: @@ -907,6 +1048,30 @@ Assuming you have created a custom idempotency policy. Such as: */ +/*! @page compute_region_health_sources_v1::RegionHealthSourcesClient-retry-snippet Override compute_region_health_sources_v1::RegionHealthSourcesClient Retry Policies + +This shows how to override the retry policies for compute_region_health_sources_v1::RegionHealthSourcesClient: + +@snippet google/cloud/compute/region_health_sources/v1/samples/region_health_sources_client_samples.cc set-retry-policy + +Assuming you have created a custom idempotency policy. Such as: + +@snippet google/cloud/compute/region_health_sources/v1/samples/region_health_sources_client_samples.cc custom-idempotency-policy + +*/ + +/*! @page compute_region_instance_group_manager_resize_requests_v1::RegionInstanceGroupManagerResizeRequestsClient-retry-snippet Override compute_region_instance_group_manager_resize_requests_v1::RegionInstanceGroupManagerResizeRequestsClient Retry Policies + +This shows how to override the retry policies for compute_region_instance_group_manager_resize_requests_v1::RegionInstanceGroupManagerResizeRequestsClient: + +@snippet google/cloud/compute/region_instance_group_manager_resize_requests/v1/samples/region_instance_group_manager_resize_requests_client_samples.cc set-retry-policy + +Assuming you have created a custom idempotency policy. Such as: + +@snippet google/cloud/compute/region_instance_group_manager_resize_requests/v1/samples/region_instance_group_manager_resize_requests_client_samples.cc custom-idempotency-policy + +*/ + /*! @page compute_region_instance_group_managers_v1::RegionInstanceGroupManagersClient-retry-snippet Override compute_region_instance_group_managers_v1::RegionInstanceGroupManagersClient Retry Policies This shows how to override the retry policies for compute_region_instance_group_managers_v1::RegionInstanceGroupManagersClient: @@ -955,6 +1120,18 @@ Assuming you have created a custom idempotency policy. Such as: */ +/*! @page compute_region_instant_snapshot_groups_v1::RegionInstantSnapshotGroupsClient-retry-snippet Override compute_region_instant_snapshot_groups_v1::RegionInstantSnapshotGroupsClient Retry Policies + +This shows how to override the retry policies for compute_region_instant_snapshot_groups_v1::RegionInstantSnapshotGroupsClient: + +@snippet google/cloud/compute/region_instant_snapshot_groups/v1/samples/region_instant_snapshot_groups_client_samples.cc set-retry-policy + +Assuming you have created a custom idempotency policy. Such as: + +@snippet google/cloud/compute/region_instant_snapshot_groups/v1/samples/region_instant_snapshot_groups_client_samples.cc custom-idempotency-policy + +*/ + /*! @page compute_region_instant_snapshots_v1::RegionInstantSnapshotsClient-retry-snippet Override compute_region_instant_snapshots_v1::RegionInstantSnapshotsClient Retry Policies This shows how to override the retry policies for compute_region_instant_snapshots_v1::RegionInstantSnapshotsClient: @@ -1027,6 +1204,30 @@ Assuming you have created a custom idempotency policy. Such as: */ +/*! @page compute_region_snapshot_settings_v1::RegionSnapshotSettingsClient-retry-snippet Override compute_region_snapshot_settings_v1::RegionSnapshotSettingsClient Retry Policies + +This shows how to override the retry policies for compute_region_snapshot_settings_v1::RegionSnapshotSettingsClient: + +@snippet google/cloud/compute/region_snapshot_settings/v1/samples/region_snapshot_settings_client_samples.cc set-retry-policy + +Assuming you have created a custom idempotency policy. Such as: + +@snippet google/cloud/compute/region_snapshot_settings/v1/samples/region_snapshot_settings_client_samples.cc custom-idempotency-policy + +*/ + +/*! @page compute_region_snapshots_v1::RegionSnapshotsClient-retry-snippet Override compute_region_snapshots_v1::RegionSnapshotsClient Retry Policies + +This shows how to override the retry policies for compute_region_snapshots_v1::RegionSnapshotsClient: + +@snippet google/cloud/compute/region_snapshots/v1/samples/region_snapshots_client_samples.cc set-retry-policy + +Assuming you have created a custom idempotency policy. Such as: + +@snippet google/cloud/compute/region_snapshots/v1/samples/region_snapshots_client_samples.cc custom-idempotency-policy + +*/ + /*! @page compute_region_ssl_certificates_v1::RegionSslCertificatesClient-retry-snippet Override compute_region_ssl_certificates_v1::RegionSslCertificatesClient Retry Policies This shows how to override the retry policies for compute_region_ssl_certificates_v1::RegionSslCertificatesClient: @@ -1123,6 +1324,18 @@ Assuming you have created a custom idempotency policy. Such as: */ +/*! @page compute_reliability_risks_v1::ReliabilityRisksClient-retry-snippet Override compute_reliability_risks_v1::ReliabilityRisksClient Retry Policies + +This shows how to override the retry policies for compute_reliability_risks_v1::ReliabilityRisksClient: + +@snippet google/cloud/compute/reliability_risks/v1/samples/reliability_risks_client_samples.cc set-retry-policy + +Assuming you have created a custom idempotency policy. Such as: + +@snippet google/cloud/compute/reliability_risks/v1/samples/reliability_risks_client_samples.cc custom-idempotency-policy + +*/ + /*! @page compute_reservation_blocks_v1::ReservationBlocksClient-retry-snippet Override compute_reservation_blocks_v1::ReservationBlocksClient Retry Policies This shows how to override the retry policies for compute_reservation_blocks_v1::ReservationBlocksClient: @@ -1135,6 +1348,18 @@ Assuming you have created a custom idempotency policy. Such as: */ +/*! @page compute_reservation_slots_v1::ReservationSlotsClient-retry-snippet Override compute_reservation_slots_v1::ReservationSlotsClient Retry Policies + +This shows how to override the retry policies for compute_reservation_slots_v1::ReservationSlotsClient: + +@snippet google/cloud/compute/reservation_slots/v1/samples/reservation_slots_client_samples.cc set-retry-policy + +Assuming you have created a custom idempotency policy. Such as: + +@snippet google/cloud/compute/reservation_slots/v1/samples/reservation_slots_client_samples.cc custom-idempotency-policy + +*/ + /*! @page compute_reservation_sub_blocks_v1::ReservationSubBlocksClient-retry-snippet Override compute_reservation_sub_blocks_v1::ReservationSubBlocksClient Retry Policies This shows how to override the retry policies for compute_reservation_sub_blocks_v1::ReservationSubBlocksClient: @@ -1171,6 +1396,30 @@ Assuming you have created a custom idempotency policy. Such as: */ +/*! @page compute_rollout_plans_v1::RolloutPlansClient-retry-snippet Override compute_rollout_plans_v1::RolloutPlansClient Retry Policies + +This shows how to override the retry policies for compute_rollout_plans_v1::RolloutPlansClient: + +@snippet google/cloud/compute/rollout_plans/v1/samples/rollout_plans_client_samples.cc set-retry-policy + +Assuming you have created a custom idempotency policy. Such as: + +@snippet google/cloud/compute/rollout_plans/v1/samples/rollout_plans_client_samples.cc custom-idempotency-policy + +*/ + +/*! @page compute_rollouts_v1::RolloutsClient-retry-snippet Override compute_rollouts_v1::RolloutsClient Retry Policies + +This shows how to override the retry policies for compute_rollouts_v1::RolloutsClient: + +@snippet google/cloud/compute/rollouts/v1/samples/rollouts_client_samples.cc set-retry-policy + +Assuming you have created a custom idempotency policy. Such as: + +@snippet google/cloud/compute/rollouts/v1/samples/rollouts_client_samples.cc custom-idempotency-policy + +*/ + /*! @page compute_routers_v1::RoutersClient-retry-snippet Override compute_routers_v1::RoutersClient Retry Policies This shows how to override the retry policies for compute_routers_v1::RoutersClient: @@ -1435,6 +1684,18 @@ Assuming you have created a custom idempotency policy. Such as: */ +/*! @page compute_wire_groups_v1::WireGroupsClient-retry-snippet Override compute_wire_groups_v1::WireGroupsClient Retry Policies + +This shows how to override the retry policies for compute_wire_groups_v1::WireGroupsClient: + +@snippet google/cloud/compute/wire_groups/v1/samples/wire_groups_client_samples.cc set-retry-policy + +Assuming you have created a custom idempotency policy. Such as: + +@snippet google/cloud/compute/wire_groups/v1/samples/wire_groups_client_samples.cc custom-idempotency-policy + +*/ + /*! @page compute_zone_operations_v1::ZoneOperationsClient-retry-snippet Override compute_zone_operations_v1::ZoneOperationsClient Retry Policies This shows how to override the retry policies for compute_zone_operations_v1::ZoneOperationsClient: @@ -1447,6 +1708,18 @@ Assuming you have created a custom idempotency policy. Such as: */ +/*! @page compute_zone_vm_extension_policies_v1::ZoneVmExtensionPoliciesClient-retry-snippet Override compute_zone_vm_extension_policies_v1::ZoneVmExtensionPoliciesClient Retry Policies + +This shows how to override the retry policies for compute_zone_vm_extension_policies_v1::ZoneVmExtensionPoliciesClient: + +@snippet google/cloud/compute/zone_vm_extension_policies/v1/samples/zone_vm_extension_policies_client_samples.cc set-retry-policy + +Assuming you have created a custom idempotency policy. Such as: + +@snippet google/cloud/compute/zone_vm_extension_policies/v1/samples/zone_vm_extension_policies_client_samples.cc custom-idempotency-policy + +*/ + /*! @page compute_zones_v1::ZonesClient-retry-snippet Override compute_zones_v1::ZonesClient Retry Policies This shows how to override the retry policies for compute_zones_v1::ZonesClient: diff --git a/google/cloud/compute/doc/override-universe-domain.dox b/google/cloud/compute/doc/override-universe-domain.dox index 6e67258b368fe..cc4396636bca9 100644 --- a/google/cloud/compute/doc/override-universe-domain.dox +++ b/google/cloud/compute/doc/override-universe-domain.dox @@ -14,9 +14,11 @@ Follow these links to find examples for other \c *Client classes: - [\c compute_accelerator_types_v1::AcceleratorTypesClient](@ref compute_accelerator_types_v1::AcceleratorTypesClient-universe-domain-snippet) - [\c compute_addresses_v1::AddressesClient](@ref compute_addresses_v1::AddressesClient-universe-domain-snippet) +- [\c compute_advice_v1::AdviceClient](@ref compute_advice_v1::AdviceClient-universe-domain-snippet) - [\c compute_autoscalers_v1::AutoscalersClient](@ref compute_autoscalers_v1::AutoscalersClient-universe-domain-snippet) - [\c compute_backend_buckets_v1::BackendBucketsClient](@ref compute_backend_buckets_v1::BackendBucketsClient-universe-domain-snippet) - [\c compute_backend_services_v1::BackendServicesClient](@ref compute_backend_services_v1::BackendServicesClient-universe-domain-snippet) +- [\c compute_cross_site_networks_v1::CrossSiteNetworksClient](@ref compute_cross_site_networks_v1::CrossSiteNetworksClient-universe-domain-snippet) - [\c compute_disk_types_v1::DiskTypesClient](@ref compute_disk_types_v1::DiskTypesClient-universe-domain-snippet) - [\c compute_disks_v1::DisksClient](@ref compute_disks_v1::DisksClient-universe-domain-snippet) - [\c compute_external_vpn_gateways_v1::ExternalVpnGatewaysClient](@ref compute_external_vpn_gateways_v1::ExternalVpnGatewaysClient-universe-domain-snippet) @@ -29,7 +31,9 @@ Follow these links to find examples for other \c *Client classes: - [\c compute_global_operations_v1::GlobalOperationsClient](@ref compute_global_operations_v1::GlobalOperationsClient-universe-domain-snippet) - [\c compute_global_organization_operations_v1::GlobalOrganizationOperationsClient](@ref compute_global_organization_operations_v1::GlobalOrganizationOperationsClient-universe-domain-snippet) - [\c compute_global_public_delegated_prefixes_v1::GlobalPublicDelegatedPrefixesClient](@ref compute_global_public_delegated_prefixes_v1::GlobalPublicDelegatedPrefixesClient-universe-domain-snippet) +- [\c compute_global_vm_extension_policies_v1::GlobalVmExtensionPoliciesClient](@ref compute_global_vm_extension_policies_v1::GlobalVmExtensionPoliciesClient-universe-domain-snippet) - [\c compute_health_checks_v1::HealthChecksClient](@ref compute_health_checks_v1::HealthChecksClient-universe-domain-snippet) +- [\c compute_hosts_v1::HostsClient](@ref compute_hosts_v1::HostsClient-universe-domain-snippet) - [\c compute_http_health_checks_v1::HttpHealthChecksClient](@ref compute_http_health_checks_v1::HttpHealthChecksClient-universe-domain-snippet) - [\c compute_https_health_checks_v1::HttpsHealthChecksClient](@ref compute_https_health_checks_v1::HttpsHealthChecksClient-universe-domain-snippet) - [\c compute_image_family_views_v1::ImageFamilyViewsClient](@ref compute_image_family_views_v1::ImageFamilyViewsClient-universe-domain-snippet) @@ -40,6 +44,7 @@ Follow these links to find examples for other \c *Client classes: - [\c compute_instance_settings_v1::InstanceSettingsClient](@ref compute_instance_settings_v1::InstanceSettingsClient-universe-domain-snippet) - [\c compute_instance_templates_v1::InstanceTemplatesClient](@ref compute_instance_templates_v1::InstanceTemplatesClient-universe-domain-snippet) - [\c compute_instances_v1::InstancesClient](@ref compute_instances_v1::InstancesClient-universe-domain-snippet) +- [\c compute_instant_snapshot_groups_v1::InstantSnapshotGroupsClient](@ref compute_instant_snapshot_groups_v1::InstantSnapshotGroupsClient-universe-domain-snippet) - [\c compute_instant_snapshots_v1::InstantSnapshotsClient](@ref compute_instant_snapshots_v1::InstantSnapshotsClient-universe-domain-snippet) - [\c compute_interconnect_attachment_groups_v1::InterconnectAttachmentGroupsClient](@ref compute_interconnect_attachment_groups_v1::InterconnectAttachmentGroupsClient-universe-domain-snippet) - [\c compute_interconnect_attachments_v1::InterconnectAttachmentsClient](@ref compute_interconnect_attachments_v1::InterconnectAttachmentsClient-universe-domain-snippet) @@ -60,27 +65,37 @@ Follow these links to find examples for other \c *Client classes: - [\c compute_node_groups_v1::NodeGroupsClient](@ref compute_node_groups_v1::NodeGroupsClient-universe-domain-snippet) - [\c compute_node_templates_v1::NodeTemplatesClient](@ref compute_node_templates_v1::NodeTemplatesClient-universe-domain-snippet) - [\c compute_node_types_v1::NodeTypesClient](@ref compute_node_types_v1::NodeTypesClient-universe-domain-snippet) +- [\c compute_organization_security_policies_v1::OrganizationSecurityPoliciesClient](@ref compute_organization_security_policies_v1::OrganizationSecurityPoliciesClient-universe-domain-snippet) - [\c compute_packet_mirrorings_v1::PacketMirroringsClient](@ref compute_packet_mirrorings_v1::PacketMirroringsClient-universe-domain-snippet) +- [\c compute_preview_features_v1::PreviewFeaturesClient](@ref compute_preview_features_v1::PreviewFeaturesClient-universe-domain-snippet) - [\c compute_projects_v1::ProjectsClient](@ref compute_projects_v1::ProjectsClient-universe-domain-snippet) - [\c compute_public_advertised_prefixes_v1::PublicAdvertisedPrefixesClient](@ref compute_public_advertised_prefixes_v1::PublicAdvertisedPrefixesClient-universe-domain-snippet) - [\c compute_public_delegated_prefixes_v1::PublicDelegatedPrefixesClient](@ref compute_public_delegated_prefixes_v1::PublicDelegatedPrefixesClient-universe-domain-snippet) - [\c compute_region_autoscalers_v1::RegionAutoscalersClient](@ref compute_region_autoscalers_v1::RegionAutoscalersClient-universe-domain-snippet) +- [\c compute_region_backend_buckets_v1::RegionBackendBucketsClient](@ref compute_region_backend_buckets_v1::RegionBackendBucketsClient-universe-domain-snippet) - [\c compute_region_backend_services_v1::RegionBackendServicesClient](@ref compute_region_backend_services_v1::RegionBackendServicesClient-universe-domain-snippet) - [\c compute_region_commitments_v1::RegionCommitmentsClient](@ref compute_region_commitments_v1::RegionCommitmentsClient-universe-domain-snippet) +- [\c compute_region_composite_health_checks_v1::RegionCompositeHealthChecksClient](@ref compute_region_composite_health_checks_v1::RegionCompositeHealthChecksClient-universe-domain-snippet) - [\c compute_region_disk_types_v1::RegionDiskTypesClient](@ref compute_region_disk_types_v1::RegionDiskTypesClient-universe-domain-snippet) - [\c compute_region_disks_v1::RegionDisksClient](@ref compute_region_disks_v1::RegionDisksClient-universe-domain-snippet) +- [\c compute_region_health_aggregation_policies_v1::RegionHealthAggregationPoliciesClient](@ref compute_region_health_aggregation_policies_v1::RegionHealthAggregationPoliciesClient-universe-domain-snippet) - [\c compute_region_health_check_services_v1::RegionHealthCheckServicesClient](@ref compute_region_health_check_services_v1::RegionHealthCheckServicesClient-universe-domain-snippet) - [\c compute_region_health_checks_v1::RegionHealthChecksClient](@ref compute_region_health_checks_v1::RegionHealthChecksClient-universe-domain-snippet) +- [\c compute_region_health_sources_v1::RegionHealthSourcesClient](@ref compute_region_health_sources_v1::RegionHealthSourcesClient-universe-domain-snippet) +- [\c compute_region_instance_group_manager_resize_requests_v1::RegionInstanceGroupManagerResizeRequestsClient](@ref compute_region_instance_group_manager_resize_requests_v1::RegionInstanceGroupManagerResizeRequestsClient-universe-domain-snippet) - [\c compute_region_instance_group_managers_v1::RegionInstanceGroupManagersClient](@ref compute_region_instance_group_managers_v1::RegionInstanceGroupManagersClient-universe-domain-snippet) - [\c compute_region_instance_groups_v1::RegionInstanceGroupsClient](@ref compute_region_instance_groups_v1::RegionInstanceGroupsClient-universe-domain-snippet) - [\c compute_region_instance_templates_v1::RegionInstanceTemplatesClient](@ref compute_region_instance_templates_v1::RegionInstanceTemplatesClient-universe-domain-snippet) - [\c compute_region_instances_v1::RegionInstancesClient](@ref compute_region_instances_v1::RegionInstancesClient-universe-domain-snippet) +- [\c compute_region_instant_snapshot_groups_v1::RegionInstantSnapshotGroupsClient](@ref compute_region_instant_snapshot_groups_v1::RegionInstantSnapshotGroupsClient-universe-domain-snippet) - [\c compute_region_instant_snapshots_v1::RegionInstantSnapshotsClient](@ref compute_region_instant_snapshots_v1::RegionInstantSnapshotsClient-universe-domain-snippet) - [\c compute_region_network_endpoint_groups_v1::RegionNetworkEndpointGroupsClient](@ref compute_region_network_endpoint_groups_v1::RegionNetworkEndpointGroupsClient-universe-domain-snippet) - [\c compute_region_network_firewall_policies_v1::RegionNetworkFirewallPoliciesClient](@ref compute_region_network_firewall_policies_v1::RegionNetworkFirewallPoliciesClient-universe-domain-snippet) - [\c compute_region_notification_endpoints_v1::RegionNotificationEndpointsClient](@ref compute_region_notification_endpoints_v1::RegionNotificationEndpointsClient-universe-domain-snippet) - [\c compute_region_operations_v1::RegionOperationsClient](@ref compute_region_operations_v1::RegionOperationsClient-universe-domain-snippet) - [\c compute_region_security_policies_v1::RegionSecurityPoliciesClient](@ref compute_region_security_policies_v1::RegionSecurityPoliciesClient-universe-domain-snippet) +- [\c compute_region_snapshot_settings_v1::RegionSnapshotSettingsClient](@ref compute_region_snapshot_settings_v1::RegionSnapshotSettingsClient-universe-domain-snippet) +- [\c compute_region_snapshots_v1::RegionSnapshotsClient](@ref compute_region_snapshots_v1::RegionSnapshotsClient-universe-domain-snippet) - [\c compute_region_ssl_certificates_v1::RegionSslCertificatesClient](@ref compute_region_ssl_certificates_v1::RegionSslCertificatesClient-universe-domain-snippet) - [\c compute_region_ssl_policies_v1::RegionSslPoliciesClient](@ref compute_region_ssl_policies_v1::RegionSslPoliciesClient-universe-domain-snippet) - [\c compute_region_target_http_proxies_v1::RegionTargetHttpProxiesClient](@ref compute_region_target_http_proxies_v1::RegionTargetHttpProxiesClient-universe-domain-snippet) @@ -89,10 +104,14 @@ Follow these links to find examples for other \c *Client classes: - [\c compute_region_url_maps_v1::RegionUrlMapsClient](@ref compute_region_url_maps_v1::RegionUrlMapsClient-universe-domain-snippet) - [\c compute_region_zones_v1::RegionZonesClient](@ref compute_region_zones_v1::RegionZonesClient-universe-domain-snippet) - [\c compute_regions_v1::RegionsClient](@ref compute_regions_v1::RegionsClient-universe-domain-snippet) +- [\c compute_reliability_risks_v1::ReliabilityRisksClient](@ref compute_reliability_risks_v1::ReliabilityRisksClient-universe-domain-snippet) - [\c compute_reservation_blocks_v1::ReservationBlocksClient](@ref compute_reservation_blocks_v1::ReservationBlocksClient-universe-domain-snippet) +- [\c compute_reservation_slots_v1::ReservationSlotsClient](@ref compute_reservation_slots_v1::ReservationSlotsClient-universe-domain-snippet) - [\c compute_reservation_sub_blocks_v1::ReservationSubBlocksClient](@ref compute_reservation_sub_blocks_v1::ReservationSubBlocksClient-universe-domain-snippet) - [\c compute_reservations_v1::ReservationsClient](@ref compute_reservations_v1::ReservationsClient-universe-domain-snippet) - [\c compute_resource_policies_v1::ResourcePoliciesClient](@ref compute_resource_policies_v1::ResourcePoliciesClient-universe-domain-snippet) +- [\c compute_rollout_plans_v1::RolloutPlansClient](@ref compute_rollout_plans_v1::RolloutPlansClient-universe-domain-snippet) +- [\c compute_rollouts_v1::RolloutsClient](@ref compute_rollouts_v1::RolloutsClient-universe-domain-snippet) - [\c compute_routers_v1::RoutersClient](@ref compute_routers_v1::RoutersClient-universe-domain-snippet) - [\c compute_routes_v1::RoutesClient](@ref compute_routes_v1::RoutesClient-universe-domain-snippet) - [\c compute_security_policies_v1::SecurityPoliciesClient](@ref compute_security_policies_v1::SecurityPoliciesClient-universe-domain-snippet) @@ -115,7 +134,9 @@ Follow these links to find examples for other \c *Client classes: - [\c compute_url_maps_v1::UrlMapsClient](@ref compute_url_maps_v1::UrlMapsClient-universe-domain-snippet) - [\c compute_vpn_gateways_v1::VpnGatewaysClient](@ref compute_vpn_gateways_v1::VpnGatewaysClient-universe-domain-snippet) - [\c compute_vpn_tunnels_v1::VpnTunnelsClient](@ref compute_vpn_tunnels_v1::VpnTunnelsClient-universe-domain-snippet) +- [\c compute_wire_groups_v1::WireGroupsClient](@ref compute_wire_groups_v1::WireGroupsClient-universe-domain-snippet) - [\c compute_zone_operations_v1::ZoneOperationsClient](@ref compute_zone_operations_v1::ZoneOperationsClient-universe-domain-snippet) +- [\c compute_zone_vm_extension_policies_v1::ZoneVmExtensionPoliciesClient](@ref compute_zone_vm_extension_policies_v1::ZoneVmExtensionPoliciesClient-universe-domain-snippet) - [\c compute_zones_v1::ZonesClient](@ref compute_zones_v1::ZonesClient-universe-domain-snippet) @@ -136,6 +157,12 @@ Follow these links to find examples for other \c *Client classes: */ +/*! @page compute_advice_v1::AdviceClient-universe-domain-snippet Override compute_advice_v1::AdviceClient Universe Domain + +@snippet google/cloud/compute/advice/v1/samples/advice_client_samples.cc set-client-universe-domain + +*/ + /*! @page compute_autoscalers_v1::AutoscalersClient-universe-domain-snippet Override compute_autoscalers_v1::AutoscalersClient Universe Domain @snippet google/cloud/compute/autoscalers/v1/samples/autoscalers_client_samples.cc set-client-universe-domain @@ -154,6 +181,12 @@ Follow these links to find examples for other \c *Client classes: */ +/*! @page compute_cross_site_networks_v1::CrossSiteNetworksClient-universe-domain-snippet Override compute_cross_site_networks_v1::CrossSiteNetworksClient Universe Domain + +@snippet google/cloud/compute/cross_site_networks/v1/samples/cross_site_networks_client_samples.cc set-client-universe-domain + +*/ + /*! @page compute_disk_types_v1::DiskTypesClient-universe-domain-snippet Override compute_disk_types_v1::DiskTypesClient Universe Domain @snippet google/cloud/compute/disk_types/v1/samples/disk_types_client_samples.cc set-client-universe-domain @@ -226,12 +259,24 @@ Follow these links to find examples for other \c *Client classes: */ +/*! @page compute_global_vm_extension_policies_v1::GlobalVmExtensionPoliciesClient-universe-domain-snippet Override compute_global_vm_extension_policies_v1::GlobalVmExtensionPoliciesClient Universe Domain + +@snippet google/cloud/compute/global_vm_extension_policies/v1/samples/global_vm_extension_policies_client_samples.cc set-client-universe-domain + +*/ + /*! @page compute_health_checks_v1::HealthChecksClient-universe-domain-snippet Override compute_health_checks_v1::HealthChecksClient Universe Domain @snippet google/cloud/compute/health_checks/v1/samples/health_checks_client_samples.cc set-client-universe-domain */ +/*! @page compute_hosts_v1::HostsClient-universe-domain-snippet Override compute_hosts_v1::HostsClient Universe Domain + +@snippet google/cloud/compute/hosts/v1/samples/hosts_client_samples.cc set-client-universe-domain + +*/ + /*! @page compute_http_health_checks_v1::HttpHealthChecksClient-universe-domain-snippet Override compute_http_health_checks_v1::HttpHealthChecksClient Universe Domain @snippet google/cloud/compute/http_health_checks/v1/samples/http_health_checks_client_samples.cc set-client-universe-domain @@ -292,6 +337,12 @@ Follow these links to find examples for other \c *Client classes: */ +/*! @page compute_instant_snapshot_groups_v1::InstantSnapshotGroupsClient-universe-domain-snippet Override compute_instant_snapshot_groups_v1::InstantSnapshotGroupsClient Universe Domain + +@snippet google/cloud/compute/instant_snapshot_groups/v1/samples/instant_snapshot_groups_client_samples.cc set-client-universe-domain + +*/ + /*! @page compute_instant_snapshots_v1::InstantSnapshotsClient-universe-domain-snippet Override compute_instant_snapshots_v1::InstantSnapshotsClient Universe Domain @snippet google/cloud/compute/instant_snapshots/v1/samples/instant_snapshots_client_samples.cc set-client-universe-domain @@ -412,12 +463,24 @@ Follow these links to find examples for other \c *Client classes: */ +/*! @page compute_organization_security_policies_v1::OrganizationSecurityPoliciesClient-universe-domain-snippet Override compute_organization_security_policies_v1::OrganizationSecurityPoliciesClient Universe Domain + +@snippet google/cloud/compute/organization_security_policies/v1/samples/organization_security_policies_client_samples.cc set-client-universe-domain + +*/ + /*! @page compute_packet_mirrorings_v1::PacketMirroringsClient-universe-domain-snippet Override compute_packet_mirrorings_v1::PacketMirroringsClient Universe Domain @snippet google/cloud/compute/packet_mirrorings/v1/samples/packet_mirrorings_client_samples.cc set-client-universe-domain */ +/*! @page compute_preview_features_v1::PreviewFeaturesClient-universe-domain-snippet Override compute_preview_features_v1::PreviewFeaturesClient Universe Domain + +@snippet google/cloud/compute/preview_features/v1/samples/preview_features_client_samples.cc set-client-universe-domain + +*/ + /*! @page compute_projects_v1::ProjectsClient-universe-domain-snippet Override compute_projects_v1::ProjectsClient Universe Domain @snippet google/cloud/compute/projects/v1/samples/projects_client_samples.cc set-client-universe-domain @@ -442,6 +505,12 @@ Follow these links to find examples for other \c *Client classes: */ +/*! @page compute_region_backend_buckets_v1::RegionBackendBucketsClient-universe-domain-snippet Override compute_region_backend_buckets_v1::RegionBackendBucketsClient Universe Domain + +@snippet google/cloud/compute/region_backend_buckets/v1/samples/region_backend_buckets_client_samples.cc set-client-universe-domain + +*/ + /*! @page compute_region_backend_services_v1::RegionBackendServicesClient-universe-domain-snippet Override compute_region_backend_services_v1::RegionBackendServicesClient Universe Domain @snippet google/cloud/compute/region_backend_services/v1/samples/region_backend_services_client_samples.cc set-client-universe-domain @@ -454,6 +523,12 @@ Follow these links to find examples for other \c *Client classes: */ +/*! @page compute_region_composite_health_checks_v1::RegionCompositeHealthChecksClient-universe-domain-snippet Override compute_region_composite_health_checks_v1::RegionCompositeHealthChecksClient Universe Domain + +@snippet google/cloud/compute/region_composite_health_checks/v1/samples/region_composite_health_checks_client_samples.cc set-client-universe-domain + +*/ + /*! @page compute_region_disk_types_v1::RegionDiskTypesClient-universe-domain-snippet Override compute_region_disk_types_v1::RegionDiskTypesClient Universe Domain @snippet google/cloud/compute/region_disk_types/v1/samples/region_disk_types_client_samples.cc set-client-universe-domain @@ -466,6 +541,12 @@ Follow these links to find examples for other \c *Client classes: */ +/*! @page compute_region_health_aggregation_policies_v1::RegionHealthAggregationPoliciesClient-universe-domain-snippet Override compute_region_health_aggregation_policies_v1::RegionHealthAggregationPoliciesClient Universe Domain + +@snippet google/cloud/compute/region_health_aggregation_policies/v1/samples/region_health_aggregation_policies_client_samples.cc set-client-universe-domain + +*/ + /*! @page compute_region_health_check_services_v1::RegionHealthCheckServicesClient-universe-domain-snippet Override compute_region_health_check_services_v1::RegionHealthCheckServicesClient Universe Domain @snippet google/cloud/compute/region_health_check_services/v1/samples/region_health_check_services_client_samples.cc set-client-universe-domain @@ -478,6 +559,18 @@ Follow these links to find examples for other \c *Client classes: */ +/*! @page compute_region_health_sources_v1::RegionHealthSourcesClient-universe-domain-snippet Override compute_region_health_sources_v1::RegionHealthSourcesClient Universe Domain + +@snippet google/cloud/compute/region_health_sources/v1/samples/region_health_sources_client_samples.cc set-client-universe-domain + +*/ + +/*! @page compute_region_instance_group_manager_resize_requests_v1::RegionInstanceGroupManagerResizeRequestsClient-universe-domain-snippet Override compute_region_instance_group_manager_resize_requests_v1::RegionInstanceGroupManagerResizeRequestsClient Universe Domain + +@snippet google/cloud/compute/region_instance_group_manager_resize_requests/v1/samples/region_instance_group_manager_resize_requests_client_samples.cc set-client-universe-domain + +*/ + /*! @page compute_region_instance_group_managers_v1::RegionInstanceGroupManagersClient-universe-domain-snippet Override compute_region_instance_group_managers_v1::RegionInstanceGroupManagersClient Universe Domain @snippet google/cloud/compute/region_instance_group_managers/v1/samples/region_instance_group_managers_client_samples.cc set-client-universe-domain @@ -502,6 +595,12 @@ Follow these links to find examples for other \c *Client classes: */ +/*! @page compute_region_instant_snapshot_groups_v1::RegionInstantSnapshotGroupsClient-universe-domain-snippet Override compute_region_instant_snapshot_groups_v1::RegionInstantSnapshotGroupsClient Universe Domain + +@snippet google/cloud/compute/region_instant_snapshot_groups/v1/samples/region_instant_snapshot_groups_client_samples.cc set-client-universe-domain + +*/ + /*! @page compute_region_instant_snapshots_v1::RegionInstantSnapshotsClient-universe-domain-snippet Override compute_region_instant_snapshots_v1::RegionInstantSnapshotsClient Universe Domain @snippet google/cloud/compute/region_instant_snapshots/v1/samples/region_instant_snapshots_client_samples.cc set-client-universe-domain @@ -538,6 +637,18 @@ Follow these links to find examples for other \c *Client classes: */ +/*! @page compute_region_snapshot_settings_v1::RegionSnapshotSettingsClient-universe-domain-snippet Override compute_region_snapshot_settings_v1::RegionSnapshotSettingsClient Universe Domain + +@snippet google/cloud/compute/region_snapshot_settings/v1/samples/region_snapshot_settings_client_samples.cc set-client-universe-domain + +*/ + +/*! @page compute_region_snapshots_v1::RegionSnapshotsClient-universe-domain-snippet Override compute_region_snapshots_v1::RegionSnapshotsClient Universe Domain + +@snippet google/cloud/compute/region_snapshots/v1/samples/region_snapshots_client_samples.cc set-client-universe-domain + +*/ + /*! @page compute_region_ssl_certificates_v1::RegionSslCertificatesClient-universe-domain-snippet Override compute_region_ssl_certificates_v1::RegionSslCertificatesClient Universe Domain @snippet google/cloud/compute/region_ssl_certificates/v1/samples/region_ssl_certificates_client_samples.cc set-client-universe-domain @@ -586,12 +697,24 @@ Follow these links to find examples for other \c *Client classes: */ +/*! @page compute_reliability_risks_v1::ReliabilityRisksClient-universe-domain-snippet Override compute_reliability_risks_v1::ReliabilityRisksClient Universe Domain + +@snippet google/cloud/compute/reliability_risks/v1/samples/reliability_risks_client_samples.cc set-client-universe-domain + +*/ + /*! @page compute_reservation_blocks_v1::ReservationBlocksClient-universe-domain-snippet Override compute_reservation_blocks_v1::ReservationBlocksClient Universe Domain @snippet google/cloud/compute/reservation_blocks/v1/samples/reservation_blocks_client_samples.cc set-client-universe-domain */ +/*! @page compute_reservation_slots_v1::ReservationSlotsClient-universe-domain-snippet Override compute_reservation_slots_v1::ReservationSlotsClient Universe Domain + +@snippet google/cloud/compute/reservation_slots/v1/samples/reservation_slots_client_samples.cc set-client-universe-domain + +*/ + /*! @page compute_reservation_sub_blocks_v1::ReservationSubBlocksClient-universe-domain-snippet Override compute_reservation_sub_blocks_v1::ReservationSubBlocksClient Universe Domain @snippet google/cloud/compute/reservation_sub_blocks/v1/samples/reservation_sub_blocks_client_samples.cc set-client-universe-domain @@ -610,6 +733,18 @@ Follow these links to find examples for other \c *Client classes: */ +/*! @page compute_rollout_plans_v1::RolloutPlansClient-universe-domain-snippet Override compute_rollout_plans_v1::RolloutPlansClient Universe Domain + +@snippet google/cloud/compute/rollout_plans/v1/samples/rollout_plans_client_samples.cc set-client-universe-domain + +*/ + +/*! @page compute_rollouts_v1::RolloutsClient-universe-domain-snippet Override compute_rollouts_v1::RolloutsClient Universe Domain + +@snippet google/cloud/compute/rollouts/v1/samples/rollouts_client_samples.cc set-client-universe-domain + +*/ + /*! @page compute_routers_v1::RoutersClient-universe-domain-snippet Override compute_routers_v1::RoutersClient Universe Domain @snippet google/cloud/compute/routers/v1/samples/routers_client_samples.cc set-client-universe-domain @@ -742,12 +877,24 @@ Follow these links to find examples for other \c *Client classes: */ +/*! @page compute_wire_groups_v1::WireGroupsClient-universe-domain-snippet Override compute_wire_groups_v1::WireGroupsClient Universe Domain + +@snippet google/cloud/compute/wire_groups/v1/samples/wire_groups_client_samples.cc set-client-universe-domain + +*/ + /*! @page compute_zone_operations_v1::ZoneOperationsClient-universe-domain-snippet Override compute_zone_operations_v1::ZoneOperationsClient Universe Domain @snippet google/cloud/compute/zone_operations/v1/samples/zone_operations_client_samples.cc set-client-universe-domain */ +/*! @page compute_zone_vm_extension_policies_v1::ZoneVmExtensionPoliciesClient-universe-domain-snippet Override compute_zone_vm_extension_policies_v1::ZoneVmExtensionPoliciesClient Universe Domain + +@snippet google/cloud/compute/zone_vm_extension_policies/v1/samples/zone_vm_extension_policies_client_samples.cc set-client-universe-domain + +*/ + /*! @page compute_zones_v1::ZonesClient-universe-domain-snippet Override compute_zones_v1::ZonesClient Universe Domain @snippet google/cloud/compute/zones/v1/samples/zones_client_samples.cc set-client-universe-domain 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 b5c0a1cc04527..8e42bbe320e48 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 @@ -118,7 +118,7 @@ class ExternalVpnGatewaysClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.external_vpn_gateways.v1.DeleteExternalVpnGatewayRequest]: @cloud_cpp_reference_link{google/cloud/compute/external_vpn_gateways/v1/external_vpn_gateways.proto#L117} + /// [google.cloud.cpp.compute.external_vpn_gateways.v1.DeleteExternalVpnGatewayRequest]: @cloud_cpp_reference_link{google/cloud/compute/external_vpn_gateways/v1/external_vpn_gateways.proto#L118} /// // clang-format on future> @@ -172,7 +172,7 @@ class ExternalVpnGatewaysClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.external_vpn_gateways.v1.DeleteExternalVpnGatewayRequest]: @cloud_cpp_reference_link{google/cloud/compute/external_vpn_gateways/v1/external_vpn_gateways.proto#L117} + /// [google.cloud.cpp.compute.external_vpn_gateways.v1.DeleteExternalVpnGatewayRequest]: @cloud_cpp_reference_link{google/cloud/compute/external_vpn_gateways/v1/external_vpn_gateways.proto#L118} /// // clang-format on future> @@ -233,8 +233,8 @@ class ExternalVpnGatewaysClient { /// [`future`]: @ref google::cloud::future /// [`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_032.proto#L31} + /// [google.cloud.cpp.compute.external_vpn_gateways.v1.GetExternalVpnGatewayRequest]: @cloud_cpp_reference_link{google/cloud/compute/external_vpn_gateways/v1/external_vpn_gateways.proto#L149} + /// [google.cloud.cpp.compute.v1.ExternalVpnGateway]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_041.proto#L35} /// // clang-format on StatusOr @@ -267,8 +267,8 @@ class ExternalVpnGatewaysClient { /// [`future`]: @ref google::cloud::future /// [`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_032.proto#L31} + /// [google.cloud.cpp.compute.external_vpn_gateways.v1.GetExternalVpnGatewayRequest]: @cloud_cpp_reference_link{google/cloud/compute/external_vpn_gateways/v1/external_vpn_gateways.proto#L149} + /// [google.cloud.cpp.compute.v1.ExternalVpnGateway]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_041.proto#L35} /// // clang-format on StatusOr @@ -278,8 +278,8 @@ class ExternalVpnGatewaysClient { // clang-format off /// - /// Creates a ExternalVpnGateway in the specified project using the data - /// included in the request. + /// Creates a ExternalVpnGateway in the specified project using + /// the data included in the request. /// https://cloud.google.com/compute/docs/reference/rest/v1/externalVpnGateways/insert /// /// @param project Project ID for this request. @@ -304,7 +304,7 @@ class ExternalVpnGatewaysClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.external_vpn_gateways.v1.InsertExternalVpnGatewayRequest]: @cloud_cpp_reference_link{google/cloud/compute/external_vpn_gateways/v1/external_vpn_gateways.proto#L158} + /// [google.cloud.cpp.compute.external_vpn_gateways.v1.InsertExternalVpnGatewayRequest]: @cloud_cpp_reference_link{google/cloud/compute/external_vpn_gateways/v1/external_vpn_gateways.proto#L162} /// // clang-format on future> @@ -333,8 +333,8 @@ class ExternalVpnGatewaysClient { // clang-format off /// - /// Creates a ExternalVpnGateway in the specified project using the data - /// included in the request. + /// Creates a ExternalVpnGateway in the specified project using + /// the data included in the request. /// https://cloud.google.com/compute/docs/reference/rest/v1/externalVpnGateways/insert /// /// @param request Unary RPCs, such as the one wrapped by this @@ -363,7 +363,7 @@ class ExternalVpnGatewaysClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.external_vpn_gateways.v1.InsertExternalVpnGatewayRequest]: @cloud_cpp_reference_link{google/cloud/compute/external_vpn_gateways/v1/external_vpn_gateways.proto#L158} + /// [google.cloud.cpp.compute.external_vpn_gateways.v1.InsertExternalVpnGatewayRequest]: @cloud_cpp_reference_link{google/cloud/compute/external_vpn_gateways/v1/external_vpn_gateways.proto#L162} /// // clang-format on future> @@ -432,8 +432,8 @@ class ExternalVpnGatewaysClient { /// [`future`]: @ref google::cloud::future /// [`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_032.proto#L31} + /// [google.cloud.cpp.compute.external_vpn_gateways.v1.ListExternalVpnGatewaysRequest]: @cloud_cpp_reference_link{google/cloud/compute/external_vpn_gateways/v1/external_vpn_gateways.proto#L191} + /// [google.cloud.cpp.compute.v1.ExternalVpnGateway]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_041.proto#L35} /// // clang-format on StreamRange @@ -473,8 +473,8 @@ class ExternalVpnGatewaysClient { /// [`future`]: @ref google::cloud::future /// [`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_032.proto#L31} + /// [google.cloud.cpp.compute.external_vpn_gateways.v1.ListExternalVpnGatewaysRequest]: @cloud_cpp_reference_link{google/cloud/compute/external_vpn_gateways/v1/external_vpn_gateways.proto#L191} + /// [google.cloud.cpp.compute.v1.ExternalVpnGateway]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_041.proto#L35} /// // clang-format on StreamRange @@ -484,8 +484,9 @@ class ExternalVpnGatewaysClient { // clang-format off /// - /// Sets the labels on an ExternalVpnGateway. To learn more about labels, read - /// the Labeling Resources documentation. + /// Sets the labels on an ExternalVpnGateway. To learn more about labels, + /// read the Labeling + /// Resources documentation. /// https://cloud.google.com/compute/docs/reference/rest/v1/externalVpnGateways/setLabels /// /// @param project Project ID for this request. @@ -511,7 +512,7 @@ class ExternalVpnGatewaysClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.external_vpn_gateways.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/external_vpn_gateways/v1/external_vpn_gateways.proto#L252} + /// [google.cloud.cpp.compute.external_vpn_gateways.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/external_vpn_gateways/v1/external_vpn_gateways.proto#L292} /// // clang-format on future> SetLabels( @@ -539,8 +540,9 @@ class ExternalVpnGatewaysClient { // clang-format off /// - /// Sets the labels on an ExternalVpnGateway. To learn more about labels, read - /// the Labeling Resources documentation. + /// Sets the labels on an ExternalVpnGateway. To learn more about labels, + /// read the Labeling + /// Resources documentation. /// https://cloud.google.com/compute/docs/reference/rest/v1/externalVpnGateways/setLabels /// /// @param request Unary RPCs, such as the one wrapped by this @@ -569,7 +571,7 @@ class ExternalVpnGatewaysClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.external_vpn_gateways.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/external_vpn_gateways/v1/external_vpn_gateways.proto#L252} + /// [google.cloud.cpp.compute.external_vpn_gateways.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/external_vpn_gateways/v1/external_vpn_gateways.proto#L292} /// // clang-format on future> SetLabels( @@ -628,8 +630,8 @@ class ExternalVpnGatewaysClient { /// [`future`]: @ref google::cloud::future /// [`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_145.proto#L30} + /// [google.cloud.cpp.compute.external_vpn_gateways.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/external_vpn_gateways/v1/external_vpn_gateways.proto#L311} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} /// // clang-format on StatusOr @@ -663,8 +665,8 @@ class ExternalVpnGatewaysClient { /// [`future`]: @ref google::cloud::future /// [`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_145.proto#L30} + /// [google.cloud.cpp.compute.external_vpn_gateways.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/external_vpn_gateways/v1/external_vpn_gateways.proto#L311} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.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 9e6083481dbe9..04ea8b9320b82 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 "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_032.pb.h" -#include "google/cloud/compute/v1/internal/common_046.pb.h" -#include "google/cloud/compute/v1/internal/common_145.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_041.pb.h" +#include "google/cloud/compute/v1/internal/common_056.pb.h" +#include "google/cloud/compute/v1/internal/common_171.pb.h" // 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 8af112bbd5f5d..8496dcfd6d1a6 100644 --- a/google/cloud/compute/firewall_policies/v1/firewall_policies_client.h +++ b/google/cloud/compute/firewall_policies/v1/firewall_policies_client.h @@ -237,7 +237,7 @@ class FirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.firewall_policies.v1.AddRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewall_policies/v1/firewall_policies.proto#L282} + /// [google.cloud.cpp.compute.firewall_policies.v1.AddRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewall_policies/v1/firewall_policies.proto#L285} /// // clang-format on future> AddRule( @@ -294,7 +294,7 @@ class FirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.firewall_policies.v1.AddRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewall_policies/v1/firewall_policies.proto#L282} + /// [google.cloud.cpp.compute.firewall_policies.v1.AddRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewall_policies/v1/firewall_policies.proto#L285} /// // clang-format on future> AddRule( @@ -358,7 +358,7 @@ class FirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.firewall_policies.v1.CloneRulesRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewall_policies/v1/firewall_policies.proto#L305} + /// [google.cloud.cpp.compute.firewall_policies.v1.CloneRulesRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewall_policies/v1/firewall_policies.proto#L311} /// // clang-format on future> CloneRules( @@ -409,7 +409,7 @@ class FirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.firewall_policies.v1.CloneRulesRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewall_policies/v1/firewall_policies.proto#L305} + /// [google.cloud.cpp.compute.firewall_policies.v1.CloneRulesRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewall_policies/v1/firewall_policies.proto#L311} /// // clang-format on future> CloneRules( @@ -473,7 +473,7 @@ class FirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.firewall_policies.v1.DeleteFirewallPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewall_policies/v1/firewall_policies.proto#L328} + /// [google.cloud.cpp.compute.firewall_policies.v1.DeleteFirewallPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewall_policies/v1/firewall_policies.proto#L337} /// // clang-format on future> @@ -524,7 +524,7 @@ class FirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.firewall_policies.v1.DeleteFirewallPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewall_policies/v1/firewall_policies.proto#L328} + /// [google.cloud.cpp.compute.firewall_policies.v1.DeleteFirewallPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewall_policies/v1/firewall_policies.proto#L337} /// // clang-format on future> @@ -582,8 +582,8 @@ class FirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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.firewall_policies.v1.GetFirewallPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewall_policies/v1/firewall_policies.proto#L369} + /// [google.cloud.cpp.compute.v1.FirewallPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_047.proto#L27} /// // clang-format on StatusOr GetFirewallPolicy( @@ -613,8 +613,8 @@ class FirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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.firewall_policies.v1.GetFirewallPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewall_policies/v1/firewall_policies.proto#L369} + /// [google.cloud.cpp.compute.v1.FirewallPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_047.proto#L27} /// // clang-format on StatusOr GetFirewallPolicy( @@ -641,8 +641,8 @@ class FirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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#L115} + /// [google.cloud.cpp.compute.firewall_policies.v1.GetAssociationRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewall_policies/v1/firewall_policies.proto#L359} + /// [google.cloud.cpp.compute.v1.FirewallPolicyAssociation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_047.proto#L132} /// // clang-format on StatusOr @@ -672,8 +672,8 @@ class FirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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#L115} + /// [google.cloud.cpp.compute.firewall_policies.v1.GetAssociationRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewall_policies/v1/firewall_policies.proto#L359} + /// [google.cloud.cpp.compute.v1.FirewallPolicyAssociation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_047.proto#L132} /// // clang-format on StatusOr @@ -701,8 +701,8 @@ class FirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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_007.proto#L178} + /// [google.cloud.cpp.compute.firewall_policies.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewall_policies/v1/firewall_policies.proto#L376} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr GetIamPolicy( @@ -733,8 +733,8 @@ class FirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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_007.proto#L178} + /// [google.cloud.cpp.compute.firewall_policies.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewall_policies/v1/firewall_policies.proto#L376} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr GetIamPolicy( @@ -761,8 +761,8 @@ class FirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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.firewall_policies.v1.GetRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewall_policies/v1/firewall_policies.proto#L387} + /// [google.cloud.cpp.compute.v1.FirewallPolicyRule]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_048.proto#L26} /// // clang-format on StatusOr GetRule( @@ -792,8 +792,8 @@ class FirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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.firewall_policies.v1.GetRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewall_policies/v1/firewall_policies.proto#L387} + /// [google.cloud.cpp.compute.v1.FirewallPolicyRule]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_048.proto#L26} /// // clang-format on StatusOr GetRule( @@ -833,7 +833,7 @@ class FirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.firewall_policies.v1.InsertFirewallPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewall_policies/v1/firewall_policies.proto#L385} + /// [google.cloud.cpp.compute.firewall_policies.v1.InsertFirewallPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewall_policies/v1/firewall_policies.proto#L397} /// // clang-format on future> @@ -874,8 +874,8 @@ class FirewallPoliciesClient { // clang-format off /// - /// Lists all the policies that have been configured for the specified folder - /// or organization. + /// Lists all the policies that have been configured for the specified + /// folder or organization. /// https://cloud.google.com/compute/docs/reference/rest/v1/firewallPolicies/list /// /// @param request Unary RPCs, such as the one wrapped by this @@ -906,8 +906,8 @@ class FirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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.firewall_policies.v1.ListFirewallPoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewall_policies/v1/firewall_policies.proto#L437} + /// [google.cloud.cpp.compute.v1.FirewallPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_047.proto#L27} /// // clang-format on StreamRange @@ -939,8 +939,8 @@ class FirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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_036.proto#L27} + /// [google.cloud.cpp.compute.firewall_policies.v1.ListAssociationsRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewall_policies/v1/firewall_policies.proto#L424} + /// [google.cloud.cpp.compute.v1.FirewallPoliciesListAssociationsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_045.proto#L27} /// // clang-format on StatusOr< @@ -975,7 +975,7 @@ class FirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.firewall_policies.v1.MoveRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewall_policies/v1/firewall_policies.proto#L485} + /// [google.cloud.cpp.compute.firewall_policies.v1.MoveRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewall_policies/v1/firewall_policies.proto#L539} /// // clang-format on future> Move( @@ -1026,7 +1026,7 @@ class FirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.firewall_policies.v1.MoveRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewall_policies/v1/firewall_policies.proto#L485} + /// [google.cloud.cpp.compute.firewall_policies.v1.MoveRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewall_policies/v1/firewall_policies.proto#L539} /// // clang-format on future> Move( @@ -1091,7 +1091,7 @@ class FirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.firewall_policies.v1.PatchFirewallPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewall_policies/v1/firewall_policies.proto#L509} + /// [google.cloud.cpp.compute.firewall_policies.v1.PatchFirewallPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewall_policies/v1/firewall_policies.proto#L566} /// // clang-format on future> @@ -1148,7 +1148,7 @@ class FirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.firewall_policies.v1.PatchFirewallPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewall_policies/v1/firewall_policies.proto#L509} + /// [google.cloud.cpp.compute.firewall_policies.v1.PatchFirewallPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewall_policies/v1/firewall_policies.proto#L566} /// // clang-format on future> @@ -1214,7 +1214,7 @@ class FirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.firewall_policies.v1.PatchRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewall_policies/v1/firewall_policies.proto#L532} + /// [google.cloud.cpp.compute.firewall_policies.v1.PatchRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewall_policies/v1/firewall_policies.proto#L592} /// // clang-format on future> PatchRule( @@ -1271,7 +1271,7 @@ class FirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.firewall_policies.v1.PatchRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewall_policies/v1/firewall_policies.proto#L532} + /// [google.cloud.cpp.compute.firewall_policies.v1.PatchRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewall_policies/v1/firewall_policies.proto#L592} /// // clang-format on future> PatchRule( @@ -1335,7 +1335,7 @@ class FirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.firewall_policies.v1.RemoveAssociationRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewall_policies/v1/firewall_policies.proto#L558} + /// [google.cloud.cpp.compute.firewall_policies.v1.RemoveAssociationRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewall_policies/v1/firewall_policies.proto#L621} /// // clang-format on future> @@ -1386,7 +1386,7 @@ class FirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.firewall_policies.v1.RemoveAssociationRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewall_policies/v1/firewall_policies.proto#L558} + /// [google.cloud.cpp.compute.firewall_policies.v1.RemoveAssociationRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewall_policies/v1/firewall_policies.proto#L621} /// // clang-format on future> @@ -1450,7 +1450,7 @@ class FirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.firewall_policies.v1.RemoveRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewall_policies/v1/firewall_policies.proto#L580} + /// [google.cloud.cpp.compute.firewall_policies.v1.RemoveRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewall_policies/v1/firewall_policies.proto#L646} /// // clang-format on future> RemoveRule( @@ -1501,7 +1501,7 @@ class FirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.firewall_policies.v1.RemoveRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewall_policies/v1/firewall_policies.proto#L580} + /// [google.cloud.cpp.compute.firewall_policies.v1.RemoveRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewall_policies/v1/firewall_policies.proto#L646} /// // clang-format on future> RemoveRule( @@ -1541,8 +1541,8 @@ class FirewallPoliciesClient { // clang-format off /// - /// Sets the access control policy on the specified resource. Replaces any - /// existing policy. + /// Sets the access control policy on the specified resource. + /// Replaces any existing policy. /// https://cloud.google.com/compute/docs/reference/rest/v1/firewallPolicies/setIamPolicy /// /// @param resource Name or id of the resource for this request. @@ -1560,8 +1560,8 @@ class FirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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_007.proto#L178} + /// [google.cloud.cpp.compute.firewall_policies.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewall_policies/v1/firewall_policies.proto#L671} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr SetIamPolicy( @@ -1572,8 +1572,8 @@ class FirewallPoliciesClient { // clang-format off /// - /// Sets the access control policy on the specified resource. Replaces any - /// existing policy. + /// Sets the access control policy on the specified resource. + /// Replaces any existing policy. /// https://cloud.google.com/compute/docs/reference/rest/v1/firewallPolicies/setIamPolicy /// /// @param request Unary RPCs, such as the one wrapped by this @@ -1595,8 +1595,8 @@ class FirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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_007.proto#L178} + /// [google.cloud.cpp.compute.firewall_policies.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewall_policies/v1/firewall_policies.proto#L671} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr SetIamPolicy( @@ -1624,8 +1624,8 @@ class FirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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_145.proto#L30} + /// [google.cloud.cpp.compute.firewall_policies.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewall_policies/v1/firewall_policies.proto#L683} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} /// // clang-format on StatusOr @@ -1659,8 +1659,8 @@ class FirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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_145.proto#L30} + /// [google.cloud.cpp.compute.firewall_policies.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewall_policies/v1/firewall_policies.proto#L683} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.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 bcd7cd1c3dc5d..8a9907df9e774 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 "google/cloud/compute/v1/internal/common_007.pb.h" -#include "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_031.pb.h" -#include "google/cloud/compute/v1/internal/common_036.pb.h" -#include "google/cloud/compute/v1/internal/common_038.pb.h" -#include "google/cloud/compute/v1/internal/common_039.pb.h" -#include "google/cloud/compute/v1/internal/common_145.pb.h" +#include "google/cloud/compute/v1/internal/common_009.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_040.pb.h" +#include "google/cloud/compute/v1/internal/common_045.pb.h" +#include "google/cloud/compute/v1/internal/common_047.pb.h" +#include "google/cloud/compute/v1/internal/common_048.pb.h" +#include "google/cloud/compute/v1/internal/common_171.pb.h" // 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_stub.cc b/google/cloud/compute/firewall_policies/v1/internal/firewall_policies_rest_stub.cc index f94c01a8b1cc2..03b24d3d7fc57 100644 --- a/google/cloud/compute/firewall_policies/v1/internal/firewall_policies_rest_stub.cc +++ b/google/cloud/compute/firewall_policies/v1/internal/firewall_policies_rest_stub.cc @@ -441,6 +441,8 @@ DefaultFirewallPoliciesRestStub::ListAssociations( google::cloud::cpp::compute::firewall_policies::v1:: ListAssociationsRequest const& request) { std::vector> query_params; + query_params.push_back({"include_inherited_policies", + (request.include_inherited_policies() ? "1" : "0")}); query_params.push_back({"target_resource", request.target_resource()}); query_params = rest_internal::TrimEmptyQueryParameters(std::move(query_params)); diff --git a/google/cloud/compute/firewalls/v1/firewalls_client.cc b/google/cloud/compute/firewalls/v1/firewalls_client.cc index eaca06fd39aa9..e0f317167fd20 100644 --- a/google/cloud/compute/firewalls/v1/firewalls_client.cc +++ b/google/cloud/compute/firewalls/v1/firewalls_client.cc @@ -215,6 +215,30 @@ FirewallsClient::PatchFirewall( return connection_->PatchFirewall(operation); } +StatusOr +FirewallsClient::TestIamPermissions( + std::string const& project, std::string const& resource, + google::cloud::cpp::compute::v1::TestPermissionsRequest const& + test_permissions_request_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::firewalls::v1::TestIamPermissionsRequest request; + request.set_project(project); + request.set_resource(resource); + *request.mutable_test_permissions_request_resource() = + test_permissions_request_resource; + return connection_->TestIamPermissions(request); +} + +StatusOr +FirewallsClient::TestIamPermissions( + google::cloud::cpp::compute::firewalls::v1::TestIamPermissionsRequest const& + request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->TestIamPermissions(request); +} + future> FirewallsClient::UpdateFirewall( std::string const& project, std::string const& firewall, diff --git a/google/cloud/compute/firewalls/v1/firewalls_client.h b/google/cloud/compute/firewalls/v1/firewalls_client.h index 96a3f8dabd418..e0b31af3ff397 100644 --- a/google/cloud/compute/firewalls/v1/firewalls_client.h +++ b/google/cloud/compute/firewalls/v1/firewalls_client.h @@ -112,7 +112,7 @@ class FirewallsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.firewalls.v1.DeleteFirewallRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewalls/v1/firewalls.proto#L115} + /// [google.cloud.cpp.compute.firewalls.v1.DeleteFirewallRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewalls/v1/firewalls.proto#L131} /// // clang-format on future> DeleteFirewall( @@ -165,7 +165,7 @@ class FirewallsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.firewalls.v1.DeleteFirewallRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewalls/v1/firewalls.proto#L115} + /// [google.cloud.cpp.compute.firewalls.v1.DeleteFirewallRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewalls/v1/firewalls.proto#L131} /// // clang-format on future> DeleteFirewall( @@ -223,8 +223,8 @@ class FirewallsClient { /// [`future`]: @ref google::cloud::future /// [`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_034.proto#L27} + /// [google.cloud.cpp.compute.firewalls.v1.GetFirewallRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewalls/v1/firewalls.proto#L160} + /// [google.cloud.cpp.compute.v1.Firewall]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_043.proto#L28} /// // clang-format on StatusOr GetFirewall( @@ -255,8 +255,8 @@ class FirewallsClient { /// [`future`]: @ref google::cloud::future /// [`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_034.proto#L27} + /// [google.cloud.cpp.compute.firewalls.v1.GetFirewallRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewalls/v1/firewalls.proto#L160} + /// [google.cloud.cpp.compute.v1.Firewall]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_043.proto#L28} /// // clang-format on StatusOr GetFirewall( @@ -266,8 +266,8 @@ class FirewallsClient { // clang-format off /// - /// Creates a firewall rule in the specified project using the data included in - /// the request. + /// Creates a firewall rule in the specified project using the data + /// included in the request. /// https://cloud.google.com/compute/docs/reference/rest/v1/firewalls/insert /// /// @param project Project ID for this request. @@ -292,7 +292,7 @@ class FirewallsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.firewalls.v1.InsertFirewallRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewalls/v1/firewalls.proto#L152} + /// [google.cloud.cpp.compute.firewalls.v1.InsertFirewallRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewalls/v1/firewalls.proto#L171} /// // clang-format on future> InsertFirewall( @@ -318,8 +318,8 @@ class FirewallsClient { // clang-format off /// - /// Creates a firewall rule in the specified project using the data included in - /// the request. + /// Creates a firewall rule in the specified project using the data + /// included in the request. /// https://cloud.google.com/compute/docs/reference/rest/v1/firewalls/insert /// /// @param request Unary RPCs, such as the one wrapped by this @@ -348,7 +348,7 @@ class FirewallsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.firewalls.v1.InsertFirewallRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewalls/v1/firewalls.proto#L152} + /// [google.cloud.cpp.compute.firewalls.v1.InsertFirewallRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewalls/v1/firewalls.proto#L171} /// // clang-format on future> InsertFirewall( @@ -388,7 +388,8 @@ class FirewallsClient { // clang-format off /// - /// Retrieves the list of firewall rules available to the specified project. + /// Retrieves the list of firewall rules available to the specified + /// project. /// https://cloud.google.com/compute/docs/reference/rest/v1/firewalls/list /// /// @param project Project ID for this request. @@ -414,8 +415,8 @@ class FirewallsClient { /// [`future`]: @ref google::cloud::future /// [`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_034.proto#L27} + /// [google.cloud.cpp.compute.firewalls.v1.ListFirewallsRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewalls/v1/firewalls.proto#L200} + /// [google.cloud.cpp.compute.v1.Firewall]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_043.proto#L28} /// // clang-format on StreamRange ListFirewalls( @@ -423,7 +424,8 @@ class FirewallsClient { // clang-format off /// - /// Retrieves the list of firewall rules available to the specified project. + /// Retrieves the list of firewall rules available to the specified + /// project. /// https://cloud.google.com/compute/docs/reference/rest/v1/firewalls/list /// /// @param request Unary RPCs, such as the one wrapped by this @@ -454,8 +456,8 @@ class FirewallsClient { /// [`future`]: @ref google::cloud::future /// [`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_034.proto#L27} + /// [google.cloud.cpp.compute.firewalls.v1.ListFirewallsRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewalls/v1/firewalls.proto#L200} + /// [google.cloud.cpp.compute.v1.Firewall]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_043.proto#L28} /// // clang-format on StreamRange ListFirewalls( @@ -464,9 +466,10 @@ class FirewallsClient { // clang-format off /// - /// 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. + /// Updates the specified firewall rule with the data included in the + /// request. This method supportsPATCH + /// semantics and uses theJSON merge + /// patch format and processing rules. /// https://cloud.google.com/compute/docs/reference/rest/v1/firewalls/patch /// /// @param project Project ID for this request. @@ -492,7 +495,7 @@ class FirewallsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.firewalls.v1.PatchFirewallRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewalls/v1/firewalls.proto#L246} + /// [google.cloud.cpp.compute.firewalls.v1.PatchFirewallRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewalls/v1/firewalls.proto#L301} /// // clang-format on future> PatchFirewall( @@ -518,9 +521,10 @@ class FirewallsClient { // clang-format off /// - /// 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. + /// Updates the specified firewall rule with the data included in the + /// request. This method supportsPATCH + /// semantics and uses theJSON merge + /// patch format and processing rules. /// https://cloud.google.com/compute/docs/reference/rest/v1/firewalls/patch /// /// @param request Unary RPCs, such as the one wrapped by this @@ -549,7 +553,7 @@ class FirewallsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.firewalls.v1.PatchFirewallRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewalls/v1/firewalls.proto#L246} + /// [google.cloud.cpp.compute.firewalls.v1.PatchFirewallRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewalls/v1/firewalls.proto#L301} /// // clang-format on future> PatchFirewall( @@ -589,7 +593,73 @@ class FirewallsClient { // clang-format off /// - /// Updates the specified firewall rule with the data included in the request. + /// Returns permissions that a caller has on the specified resource. + /// https://cloud.google.com/compute/docs/reference/rest/v1/firewalls/testIamPermissions + /// + /// @param project Project ID for this request. + /// @param resource Name or id of the resource for this request. + /// @param test_permissions_request_resource The TestPermissionsRequest for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.TestPermissionsResponse]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.firewalls.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewalls/v1/firewalls.proto#L334} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} + /// + // clang-format on + StatusOr + TestIamPermissions( + std::string const& project, std::string const& resource, + google::cloud::cpp::compute::v1::TestPermissionsRequest const& + test_permissions_request_resource, + Options opts = {}); + + // clang-format off + /// + /// Returns permissions that a caller has on the specified resource. + /// https://cloud.google.com/compute/docs/reference/rest/v1/firewalls/testIamPermissions + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.firewalls.v1.TestIamPermissionsRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.TestPermissionsResponse]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.firewalls.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewalls/v1/firewalls.proto#L334} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} + /// + // clang-format on + StatusOr + TestIamPermissions(google::cloud::cpp::compute::firewalls::v1:: + TestIamPermissionsRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// 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. /// https://cloud.google.com/compute/docs/reference/rest/v1/firewalls/update @@ -617,7 +687,7 @@ class FirewallsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.firewalls.v1.UpdateFirewallRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewalls/v1/firewalls.proto#L276} + /// [google.cloud.cpp.compute.firewalls.v1.UpdateFirewallRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewalls/v1/firewalls.proto#L349} /// // clang-format on future> UpdateFirewall( @@ -643,7 +713,8 @@ class FirewallsClient { // clang-format off /// - /// Updates the specified firewall rule with the data included in the request. + /// 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. /// https://cloud.google.com/compute/docs/reference/rest/v1/firewalls/update @@ -674,7 +745,7 @@ class FirewallsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.firewalls.v1.UpdateFirewallRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewalls/v1/firewalls.proto#L276} + /// [google.cloud.cpp.compute.firewalls.v1.UpdateFirewallRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewalls/v1/firewalls.proto#L349} /// // clang-format on future> UpdateFirewall( diff --git a/google/cloud/compute/firewalls/v1/firewalls_connection.cc b/google/cloud/compute/firewalls/v1/firewalls_connection.cc index ff1b9613e9e57..47e9582695576 100644 --- a/google/cloud/compute/firewalls/v1/firewalls_connection.cc +++ b/google/cloud/compute/firewalls/v1/firewalls_connection.cc @@ -122,6 +122,13 @@ FirewallsConnection::PatchFirewall( Status(StatusCode::kUnimplemented, "not implemented")); } +StatusOr +FirewallsConnection::TestIamPermissions( + google::cloud::cpp::compute::firewalls::v1:: + TestIamPermissionsRequest const&) { + return Status(StatusCode::kUnimplemented, "not implemented"); +} + future> FirewallsConnection::UpdateFirewall( google::cloud::cpp::compute::firewalls::v1::UpdateFirewallRequest const&) { diff --git a/google/cloud/compute/firewalls/v1/firewalls_connection.h b/google/cloud/compute/firewalls/v1/firewalls_connection.h index 306f907e634a3..4c1138c0dcc65 100644 --- a/google/cloud/compute/firewalls/v1/firewalls_connection.h +++ b/google/cloud/compute/firewalls/v1/firewalls_connection.h @@ -230,6 +230,10 @@ class FirewallsConnection { virtual future> PatchFirewall(google::cloud::cpp::compute::v1::Operation const& operation); + virtual StatusOr + TestIamPermissions(google::cloud::cpp::compute::firewalls::v1:: + TestIamPermissionsRequest const& request); + virtual future> UpdateFirewall( google::cloud::cpp::compute::firewalls::v1::UpdateFirewallRequest const& diff --git a/google/cloud/compute/firewalls/v1/firewalls_connection_idempotency_policy.cc b/google/cloud/compute/firewalls/v1/firewalls_connection_idempotency_policy.cc index 9234daaff8f9c..99e68b0a54ee2 100644 --- a/google/cloud/compute/firewalls/v1/firewalls_connection_idempotency_policy.cc +++ b/google/cloud/compute/firewalls/v1/firewalls_connection_idempotency_policy.cc @@ -60,6 +60,12 @@ Idempotency FirewallsConnectionIdempotencyPolicy::PatchFirewall( return Idempotency::kNonIdempotent; } +Idempotency FirewallsConnectionIdempotencyPolicy::TestIamPermissions( + google::cloud::cpp::compute::firewalls::v1:: + TestIamPermissionsRequest const&) { + return Idempotency::kNonIdempotent; +} + Idempotency FirewallsConnectionIdempotencyPolicy::UpdateFirewall( google::cloud::cpp::compute::firewalls::v1::UpdateFirewallRequest const&) { return Idempotency::kIdempotent; diff --git a/google/cloud/compute/firewalls/v1/firewalls_connection_idempotency_policy.h b/google/cloud/compute/firewalls/v1/firewalls_connection_idempotency_policy.h index 57a9d5014eaf0..976f120546b3c 100644 --- a/google/cloud/compute/firewalls/v1/firewalls_connection_idempotency_policy.h +++ b/google/cloud/compute/firewalls/v1/firewalls_connection_idempotency_policy.h @@ -55,6 +55,10 @@ class FirewallsConnectionIdempotencyPolicy { google::cloud::cpp::compute::firewalls::v1::PatchFirewallRequest const& request); + virtual google::cloud::Idempotency TestIamPermissions( + google::cloud::cpp::compute::firewalls::v1:: + TestIamPermissionsRequest const& request); + virtual google::cloud::Idempotency UpdateFirewall( google::cloud::cpp::compute::firewalls::v1::UpdateFirewallRequest const& request); diff --git a/google/cloud/compute/firewalls/v1/firewalls_proto_export.h b/google/cloud/compute/firewalls/v1/firewalls_proto_export.h index 7a630bcdc8e4a..b04261b72a1c6 100644 --- a/google/cloud/compute/firewalls/v1/firewalls_proto_export.h +++ b/google/cloud/compute/firewalls/v1/firewalls_proto_export.h @@ -26,9 +26,10 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_FIREWALLS_V1_FIREWALLS_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_034.pb.h" -#include "google/cloud/compute/v1/internal/common_035.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_043.pb.h" +#include "google/cloud/compute/v1/internal/common_044.pb.h" +#include "google/cloud/compute/v1/internal/common_171.pb.h" // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_FIREWALLS_V1_FIREWALLS_PROTO_EXPORT_H diff --git a/google/cloud/compute/firewalls/v1/internal/firewalls_rest_connection_impl.cc b/google/cloud/compute/firewalls/v1/internal/firewalls_rest_connection_impl.cc index cfeed58bdbb1d..a56b821c0af19 100644 --- a/google/cloud/compute/firewalls/v1/internal/firewalls_rest_connection_impl.cc +++ b/google/cloud/compute/firewalls/v1/internal/firewalls_rest_connection_impl.cc @@ -479,6 +479,22 @@ FirewallsRestConnectionImpl::PatchFirewall( }); } +StatusOr +FirewallsRestConnectionImpl::TestIamPermissions( + google::cloud::cpp::compute::firewalls::v1::TestIamPermissionsRequest const& + request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->TestIamPermissions(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::firewalls::v1:: + TestIamPermissionsRequest const& request) { + return stub_->TestIamPermissions(rest_context, options, request); + }, + *current, request, __func__); +} + future> FirewallsRestConnectionImpl::UpdateFirewall( google::cloud::cpp::compute::firewalls::v1::UpdateFirewallRequest const& diff --git a/google/cloud/compute/firewalls/v1/internal/firewalls_rest_connection_impl.h b/google/cloud/compute/firewalls/v1/internal/firewalls_rest_connection_impl.h index ee060f3e03447..3eaab526925ef 100644 --- a/google/cloud/compute/firewalls/v1/internal/firewalls_rest_connection_impl.h +++ b/google/cloud/compute/firewalls/v1/internal/firewalls_rest_connection_impl.h @@ -94,6 +94,10 @@ class FirewallsRestConnectionImpl future> PatchFirewall( google::cloud::cpp::compute::v1::Operation const& operation) override; + StatusOr + TestIamPermissions(google::cloud::cpp::compute::firewalls::v1:: + TestIamPermissionsRequest const& request) override; + future> UpdateFirewall( google::cloud::cpp::compute::firewalls::v1::UpdateFirewallRequest const& request) override; diff --git a/google/cloud/compute/firewalls/v1/internal/firewalls_rest_logging_decorator.cc b/google/cloud/compute/firewalls/v1/internal/firewalls_rest_logging_decorator.cc index 2f4e54f06f456..c90e0bad81905 100644 --- a/google/cloud/compute/firewalls/v1/internal/firewalls_rest_logging_decorator.cc +++ b/google/cloud/compute/firewalls/v1/internal/firewalls_rest_logging_decorator.cc @@ -165,6 +165,20 @@ FirewallsRestLogging::PatchFirewall( rest_context, options, request, __func__, tracing_options_); } +StatusOr +FirewallsRestLogging::TestIamPermissions( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::firewalls::v1::TestIamPermissionsRequest const& + request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::firewalls::v1:: + TestIamPermissionsRequest const& request) { + return child_->TestIamPermissions(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + future> FirewallsRestLogging::AsyncUpdateFirewall( CompletionQueue& cq, diff --git a/google/cloud/compute/firewalls/v1/internal/firewalls_rest_logging_decorator.h b/google/cloud/compute/firewalls/v1/internal/firewalls_rest_logging_decorator.h index b89384fe97444..4d662ab16b28b 100644 --- a/google/cloud/compute/firewalls/v1/internal/firewalls_rest_logging_decorator.h +++ b/google/cloud/compute/firewalls/v1/internal/firewalls_rest_logging_decorator.h @@ -96,6 +96,12 @@ class FirewallsRestLogging : public FirewallsRestStub { google::cloud::cpp::compute::firewalls::v1::PatchFirewallRequest const& request) override; + StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::firewalls::v1:: + TestIamPermissionsRequest const& request) override; + future> AsyncUpdateFirewall( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/firewalls/v1/internal/firewalls_rest_metadata_decorator.cc b/google/cloud/compute/firewalls/v1/internal/firewalls_rest_metadata_decorator.cc index ac2ca5fecbc44..4182ba2465895 100644 --- a/google/cloud/compute/firewalls/v1/internal/firewalls_rest_metadata_decorator.cc +++ b/google/cloud/compute/firewalls/v1/internal/firewalls_rest_metadata_decorator.cc @@ -119,6 +119,15 @@ FirewallsRestMetadata::PatchFirewall( return child_->PatchFirewall(rest_context, options, request); } +StatusOr +FirewallsRestMetadata::TestIamPermissions( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::firewalls::v1::TestIamPermissionsRequest const& + request) { + SetMetadata(rest_context, options); + return child_->TestIamPermissions(rest_context, options, request); +} + future> FirewallsRestMetadata::AsyncUpdateFirewall( CompletionQueue& cq, diff --git a/google/cloud/compute/firewalls/v1/internal/firewalls_rest_metadata_decorator.h b/google/cloud/compute/firewalls/v1/internal/firewalls_rest_metadata_decorator.h index 92373eb1203f9..46d9139498052 100644 --- a/google/cloud/compute/firewalls/v1/internal/firewalls_rest_metadata_decorator.h +++ b/google/cloud/compute/firewalls/v1/internal/firewalls_rest_metadata_decorator.h @@ -93,6 +93,12 @@ class FirewallsRestMetadata : public FirewallsRestStub { google::cloud::cpp::compute::firewalls::v1::PatchFirewallRequest const& request) override; + StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::firewalls::v1:: + TestIamPermissionsRequest const& request) override; + google::cloud::future> AsyncUpdateFirewall( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/firewalls/v1/internal/firewalls_rest_stub.cc b/google/cloud/compute/firewalls/v1/internal/firewalls_rest_stub.cc index 49f4effd50b5c..8a0235d287309 100644 --- a/google/cloud/compute/firewalls/v1/internal/firewalls_rest_stub.cc +++ b/google/cloud/compute/firewalls/v1/internal/firewalls_rest_stub.cc @@ -253,6 +253,25 @@ DefaultFirewallsRestStub::PatchFirewall( std::move(query_params)); } +StatusOr +DefaultFirewallsRestStub::TestIamPermissions( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::firewalls::v1::TestIamPermissionsRequest const& + request) { + std::vector> query_params; + return rest_internal::Post< + google::cloud::cpp::compute::v1::TestPermissionsResponse>( + *service_, rest_context, request.test_permissions_request_resource(), + false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "global", "/", + "firewalls", "/", request.resource(), "/", + "testIamPermissions"), + std::move(query_params)); +} + future> DefaultFirewallsRestStub::AsyncUpdateFirewall( CompletionQueue& cq, diff --git a/google/cloud/compute/firewalls/v1/internal/firewalls_rest_stub.h b/google/cloud/compute/firewalls/v1/internal/firewalls_rest_stub.h index 25405c2ca0d1f..76418d08e0acd 100644 --- a/google/cloud/compute/firewalls/v1/internal/firewalls_rest_stub.h +++ b/google/cloud/compute/firewalls/v1/internal/firewalls_rest_stub.h @@ -91,6 +91,12 @@ class FirewallsRestStub { google::cloud::cpp::compute::firewalls::v1::PatchFirewallRequest const& request) = 0; + virtual StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::firewalls::v1:: + TestIamPermissionsRequest const& request) = 0; + virtual future> AsyncUpdateFirewall( google::cloud::CompletionQueue& cq, @@ -184,6 +190,12 @@ class DefaultFirewallsRestStub : public FirewallsRestStub { google::cloud::cpp::compute::firewalls::v1::PatchFirewallRequest const& request) override; + StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::firewalls::v1:: + TestIamPermissionsRequest const& request) override; + future> AsyncUpdateFirewall( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/firewalls/v1/internal/firewalls_tracing_connection.cc b/google/cloud/compute/firewalls/v1/internal/firewalls_tracing_connection.cc index 98fc7e257429f..c4f61c2e7f3b0 100644 --- a/google/cloud/compute/firewalls/v1/internal/firewalls_tracing_connection.cc +++ b/google/cloud/compute/firewalls/v1/internal/firewalls_tracing_connection.cc @@ -145,6 +145,16 @@ FirewallsTracingConnection::PatchFirewall( return internal::EndSpan(std::move(span), child_->PatchFirewall(operation)); } +StatusOr +FirewallsTracingConnection::TestIamPermissions( + google::cloud::cpp::compute::firewalls::v1::TestIamPermissionsRequest const& + request) { + auto span = internal::MakeSpan( + "compute_firewalls_v1::FirewallsConnection::TestIamPermissions"); + auto scope = opentelemetry::trace::Scope(span); + return internal::EndSpan(*span, child_->TestIamPermissions(request)); +} + future> FirewallsTracingConnection::UpdateFirewall( google::cloud::cpp::compute::firewalls::v1::UpdateFirewallRequest const& diff --git a/google/cloud/compute/firewalls/v1/internal/firewalls_tracing_connection.h b/google/cloud/compute/firewalls/v1/internal/firewalls_tracing_connection.h index d002d9ee7d3e4..1e2e22a49e35e 100644 --- a/google/cloud/compute/firewalls/v1/internal/firewalls_tracing_connection.h +++ b/google/cloud/compute/firewalls/v1/internal/firewalls_tracing_connection.h @@ -82,6 +82,10 @@ class FirewallsTracingConnection future> PatchFirewall( google::cloud::cpp::compute::v1::Operation const& operation) override; + StatusOr + TestIamPermissions(google::cloud::cpp::compute::firewalls::v1:: + TestIamPermissionsRequest const& request) override; + future> UpdateFirewall( google::cloud::cpp::compute::firewalls::v1::UpdateFirewallRequest const& request) override; diff --git a/google/cloud/compute/firewalls/v1/mocks/mock_firewalls_connection.h b/google/cloud/compute/firewalls/v1/mocks/mock_firewalls_connection.h index e3758a4871da2..67d3a15e82bed 100644 --- a/google/cloud/compute/firewalls/v1/mocks/mock_firewalls_connection.h +++ b/google/cloud/compute/firewalls/v1/mocks/mock_firewalls_connection.h @@ -188,6 +188,13 @@ class MockFirewallsConnection (google::cloud::cpp::compute::v1::Operation const& operation), (override)); + MOCK_METHOD( + StatusOr, + TestIamPermissions, + (google::cloud::cpp::compute::firewalls::v1:: + TestIamPermissionsRequest const& request), + (override)); + /// To disambiguate calls, use: /// /// @code 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 441d0290cacab..de541b9899764 100644 --- a/google/cloud/compute/forwarding_rules/v1/forwarding_rules_client.h +++ b/google/cloud/compute/forwarding_rules/v1/forwarding_rules_client.h @@ -90,9 +90,10 @@ class ForwardingRulesClient { // clang-format off /// - /// Retrieves an aggregated list of forwarding rules. To prevent failure, - /// Google recommends that you set the `returnPartialSuccess` parameter to - /// `true`. + /// Retrieves an aggregated list of forwarding rules. + /// + /// To prevent failure, it is recommended that you set the + /// `returnPartialSuccess` parameter to `true`. /// https://cloud.google.com/compute/docs/reference/rest/v1/forwardingRules/aggregatedList /// /// @param project Project ID for this request. @@ -118,8 +119,8 @@ class ForwardingRulesClient { /// [`future`]: @ref google::cloud::future /// [`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#L137} + /// [google.cloud.cpp.compute.forwarding_rules.v1.AggregatedListForwardingRulesRequest]: @cloud_cpp_reference_link{google/cloud/compute/forwarding_rules/v1/forwarding_rules.proto#L150} + /// [google.cloud.cpp.compute.v1.ForwardingRulesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_051.proto#L158} /// // clang-format on StreamRange> @@ -253,7 +255,7 @@ class ForwardingRulesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.forwarding_rules.v1.DeleteForwardingRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/forwarding_rules/v1/forwarding_rules.proto#L229} + /// [google.cloud.cpp.compute.forwarding_rules.v1.DeleteForwardingRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/forwarding_rules/v1/forwarding_rules.proto#L265} /// // clang-format on future> @@ -313,8 +315,8 @@ class ForwardingRulesClient { /// [`future`]: @ref google::cloud::future /// [`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.forwarding_rules.v1.GetForwardingRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/forwarding_rules/v1/forwarding_rules.proto#L301} + /// [google.cloud.cpp.compute.v1.ForwardingRule]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_050.proto#L44} /// // clang-format on StatusOr GetForwardingRule( @@ -345,8 +347,8 @@ class ForwardingRulesClient { /// [`future`]: @ref google::cloud::future /// [`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.forwarding_rules.v1.GetForwardingRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/forwarding_rules/v1/forwarding_rules.proto#L301} + /// [google.cloud.cpp.compute.v1.ForwardingRule]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_050.proto#L44} /// // clang-format on StatusOr GetForwardingRule( @@ -383,7 +385,7 @@ class ForwardingRulesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.forwarding_rules.v1.InsertForwardingRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/forwarding_rules/v1/forwarding_rules.proto#L277} + /// [google.cloud.cpp.compute.forwarding_rules.v1.InsertForwardingRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/forwarding_rules/v1/forwarding_rules.proto#L322} /// // clang-format on future> @@ -441,7 +443,7 @@ class ForwardingRulesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.forwarding_rules.v1.InsertForwardingRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/forwarding_rules/v1/forwarding_rules.proto#L277} + /// [google.cloud.cpp.compute.forwarding_rules.v1.InsertForwardingRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/forwarding_rules/v1/forwarding_rules.proto#L322} /// // clang-format on future> @@ -510,8 +512,8 @@ class ForwardingRulesClient { /// [`future`]: @ref google::cloud::future /// [`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.forwarding_rules.v1.ListForwardingRulesRequest]: @cloud_cpp_reference_link{google/cloud/compute/forwarding_rules/v1/forwarding_rules.proto#L358} + /// [google.cloud.cpp.compute.v1.ForwardingRule]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_050.proto#L44} /// // clang-format on StreamRange @@ -552,8 +554,8 @@ class ForwardingRulesClient { /// [`future`]: @ref google::cloud::future /// [`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.forwarding_rules.v1.ListForwardingRulesRequest]: @cloud_cpp_reference_link{google/cloud/compute/forwarding_rules/v1/forwarding_rules.proto#L358} + /// [google.cloud.cpp.compute.v1.ForwardingRule]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_050.proto#L44} /// // clang-format on StreamRange @@ -564,9 +566,10 @@ class ForwardingRulesClient { // clang-format off /// /// 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. + /// request. This method supportsPATCH + /// semantics and uses theJSON merge + /// patch format and processing rules. Currently, you can only + /// patch the network_tier field. /// https://cloud.google.com/compute/docs/reference/rest/v1/forwardingRules/patch /// /// @param project Project ID for this request. @@ -593,7 +596,7 @@ class ForwardingRulesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.forwarding_rules.v1.PatchForwardingRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/forwarding_rules/v1/forwarding_rules.proto#L382} + /// [google.cloud.cpp.compute.forwarding_rules.v1.PatchForwardingRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/forwarding_rules/v1/forwarding_rules.proto#L463} /// // clang-format on future> @@ -624,9 +627,10 @@ class ForwardingRulesClient { // clang-format off /// /// 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. + /// request. This method supportsPATCH + /// semantics and uses theJSON merge + /// patch format and processing rules. Currently, you can only + /// patch the network_tier field. /// https://cloud.google.com/compute/docs/reference/rest/v1/forwardingRules/patch /// /// @param request Unary RPCs, such as the one wrapped by this @@ -655,7 +659,7 @@ class ForwardingRulesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.forwarding_rules.v1.PatchForwardingRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/forwarding_rules/v1/forwarding_rules.proto#L382} + /// [google.cloud.cpp.compute.forwarding_rules.v1.PatchForwardingRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/forwarding_rules/v1/forwarding_rules.proto#L463} /// // clang-format on future> @@ -696,8 +700,9 @@ class ForwardingRulesClient { // clang-format off /// - /// Sets the labels on the specified resource. To learn more about labels, read - /// the Labeling Resources documentation. + /// Sets the labels on the specified resource. To learn more about labels, + /// read the + /// Labeling Resources documentation. /// https://cloud.google.com/compute/docs/reference/rest/v1/forwardingRules/setLabels /// /// @param project Project ID for this request. @@ -724,7 +729,7 @@ class ForwardingRulesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.forwarding_rules.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/forwarding_rules/v1/forwarding_rules.proto#L419} + /// [google.cloud.cpp.compute.forwarding_rules.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/forwarding_rules/v1/forwarding_rules.proto#L503} /// // clang-format on future> SetLabels( @@ -754,8 +759,9 @@ class ForwardingRulesClient { // clang-format off /// - /// Sets the labels on the specified resource. To learn more about labels, read - /// the Labeling Resources documentation. + /// Sets the labels on the specified resource. To learn more about labels, + /// read the + /// Labeling Resources documentation. /// https://cloud.google.com/compute/docs/reference/rest/v1/forwardingRules/setLabels /// /// @param request Unary RPCs, such as the one wrapped by this @@ -784,7 +790,7 @@ class ForwardingRulesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.forwarding_rules.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/forwarding_rules/v1/forwarding_rules.proto#L419} + /// [google.cloud.cpp.compute.forwarding_rules.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/forwarding_rules/v1/forwarding_rules.proto#L503} /// // clang-format on future> SetLabels( @@ -852,7 +858,7 @@ class ForwardingRulesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.forwarding_rules.v1.SetTargetRequest]: @cloud_cpp_reference_link{google/cloud/compute/forwarding_rules/v1/forwarding_rules.proto#L457} + /// [google.cloud.cpp.compute.forwarding_rules.v1.SetTargetRequest]: @cloud_cpp_reference_link{google/cloud/compute/forwarding_rules/v1/forwarding_rules.proto#L544} /// // clang-format on future> SetTarget( @@ -912,7 +918,7 @@ class ForwardingRulesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.forwarding_rules.v1.SetTargetRequest]: @cloud_cpp_reference_link{google/cloud/compute/forwarding_rules/v1/forwarding_rules.proto#L457} + /// [google.cloud.cpp.compute.forwarding_rules.v1.SetTargetRequest]: @cloud_cpp_reference_link{google/cloud/compute/forwarding_rules/v1/forwarding_rules.proto#L544} /// // clang-format on future> SetTarget( 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 61a7f37821cf3..0a253c51b345b 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 "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_041.pb.h" -#include "google/cloud/compute/v1/internal/common_042.pb.h" -#include "google/cloud/compute/v1/internal/common_082.pb.h" -#include "google/cloud/compute/v1/internal/common_107.pb.h" -#include "google/cloud/compute/v1/internal/common_140.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_050.pb.h" +#include "google/cloud/compute/v1/internal/common_051.pb.h" +#include "google/cloud/compute/v1/internal/common_097.pb.h" +#include "google/cloud/compute/v1/internal/common_125.pb.h" +#include "google/cloud/compute/v1/internal/common_166.pb.h" // 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/forwarding_rules/v1/internal/forwarding_rules_rest_stub.cc b/google/cloud/compute/forwarding_rules/v1/internal/forwarding_rules_rest_stub.cc index 1a10a95c99e4c..5b498aed7bd1a 100644 --- a/google/cloud/compute/forwarding_rules/v1/internal/forwarding_rules_rest_stub.cc +++ b/google/cloud/compute/forwarding_rules/v1/internal/forwarding_rules_rest_stub.cc @@ -139,6 +139,9 @@ DefaultForwardingRulesRestStub::GetForwardingRule( google::cloud::cpp::compute::forwarding_rules::v1:: GetForwardingRuleRequest const& request) { std::vector> query_params; + query_params.push_back({"view", request.view()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); return rest_internal::Get( *service_, rest_context, request, false, absl::StrCat("/", "compute", "/", 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 new file mode 100644 index 0000000000000..bfbba6db87133 --- /dev/null +++ b/google/cloud/compute/future_reservations/v1/future_reservations_proto_export.h @@ -0,0 +1,39 @@ +// Copyright 2026 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 "google/cloud/compute/v1/internal/common_001.pb.h" +#include "google/cloud/compute/v1/internal/common_007.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_038.pb.h" +#include "google/cloud/compute/v1/internal/common_052.pb.h" +#include "google/cloud/compute/v1/internal/common_134.pb.h" +#include "google/cloud/compute/v1/internal/common_144.pb.h" +#include "google/cloud/compute/v1/internal/common_156.pb.h" +// 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_client.cc b/google/cloud/compute/global_addresses/v1/global_addresses_client.cc index eb74fe4bceaa6..c5cb80765e5ab 100644 --- a/google/cloud/compute/global_addresses/v1/global_addresses_client.cc +++ b/google/cloud/compute/global_addresses/v1/global_addresses_client.cc @@ -282,6 +282,31 @@ GlobalAddressesClient::SetLabels( return connection_->SetLabels(operation); } +StatusOr +GlobalAddressesClient::TestIamPermissions( + std::string const& project, std::string const& resource, + google::cloud::cpp::compute::v1::TestPermissionsRequest const& + test_permissions_request_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::global_addresses::v1::TestIamPermissionsRequest + request; + request.set_project(project); + request.set_resource(resource); + *request.mutable_test_permissions_request_resource() = + test_permissions_request_resource; + return connection_->TestIamPermissions(request); +} + +StatusOr +GlobalAddressesClient::TestIamPermissions( + google::cloud::cpp::compute::global_addresses::v1:: + TestIamPermissionsRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->TestIamPermissions(request); +} + GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END } // namespace compute_global_addresses_v1 } // namespace cloud diff --git a/google/cloud/compute/global_addresses/v1/global_addresses_client.h b/google/cloud/compute/global_addresses/v1/global_addresses_client.h index 1875fda5243c7..0046612c502f7 100644 --- a/google/cloud/compute/global_addresses/v1/global_addresses_client.h +++ b/google/cloud/compute/global_addresses/v1/global_addresses_client.h @@ -115,7 +115,7 @@ class GlobalAddressesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.global_addresses.v1.DeleteAddressRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_addresses/v1/global_addresses.proto#L114} + /// [google.cloud.cpp.compute.global_addresses.v1.DeleteAddressRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_addresses/v1/global_addresses.proto#L128} /// // clang-format on future> DeleteAddress( @@ -168,7 +168,7 @@ class GlobalAddressesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.global_addresses.v1.DeleteAddressRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_addresses/v1/global_addresses.proto#L114} + /// [google.cloud.cpp.compute.global_addresses.v1.DeleteAddressRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_addresses/v1/global_addresses.proto#L128} /// // clang-format on future> DeleteAddress( @@ -226,8 +226,8 @@ class GlobalAddressesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.global_addresses.v1.GetAddressRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_addresses/v1/global_addresses.proto#L140} - /// [google.cloud.cpp.compute.v1.Address]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_004.proto#L30} + /// [google.cloud.cpp.compute.global_addresses.v1.GetAddressRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_addresses/v1/global_addresses.proto#L157} + /// [google.cloud.cpp.compute.v1.Address]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_005.proto#L35} /// // clang-format on StatusOr GetAddress( @@ -258,8 +258,8 @@ class GlobalAddressesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.global_addresses.v1.GetAddressRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_addresses/v1/global_addresses.proto#L140} - /// [google.cloud.cpp.compute.v1.Address]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_004.proto#L30} + /// [google.cloud.cpp.compute.global_addresses.v1.GetAddressRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_addresses/v1/global_addresses.proto#L157} + /// [google.cloud.cpp.compute.v1.Address]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_005.proto#L35} /// // clang-format on StatusOr GetAddress( @@ -295,7 +295,7 @@ class GlobalAddressesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.global_addresses.v1.InsertAddressRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_addresses/v1/global_addresses.proto#L151} + /// [google.cloud.cpp.compute.global_addresses.v1.InsertAddressRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_addresses/v1/global_addresses.proto#L168} /// // clang-format on future> InsertAddress( @@ -351,7 +351,7 @@ class GlobalAddressesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.global_addresses.v1.InsertAddressRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_addresses/v1/global_addresses.proto#L151} + /// [google.cloud.cpp.compute.global_addresses.v1.InsertAddressRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_addresses/v1/global_addresses.proto#L168} /// // clang-format on future> InsertAddress( @@ -417,8 +417,8 @@ class GlobalAddressesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.global_addresses.v1.ListGlobalAddressesRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_addresses/v1/global_addresses.proto#L177} - /// [google.cloud.cpp.compute.v1.Address]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_004.proto#L30} + /// [google.cloud.cpp.compute.global_addresses.v1.ListGlobalAddressesRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_addresses/v1/global_addresses.proto#L197} + /// [google.cloud.cpp.compute.v1.Address]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_005.proto#L35} /// // clang-format on StreamRange ListGlobalAddresses( @@ -457,8 +457,8 @@ class GlobalAddressesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.global_addresses.v1.ListGlobalAddressesRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_addresses/v1/global_addresses.proto#L177} - /// [google.cloud.cpp.compute.v1.Address]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_004.proto#L30} + /// [google.cloud.cpp.compute.global_addresses.v1.ListGlobalAddressesRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_addresses/v1/global_addresses.proto#L197} + /// [google.cloud.cpp.compute.v1.Address]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_005.proto#L35} /// // clang-format on StreamRange ListGlobalAddresses( @@ -494,7 +494,7 @@ class GlobalAddressesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.global_addresses.v1.MoveRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_addresses/v1/global_addresses.proto#L245} + /// [google.cloud.cpp.compute.global_addresses.v1.MoveRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_addresses/v1/global_addresses.proto#L298} /// // clang-format on future> Move( @@ -551,7 +551,7 @@ class GlobalAddressesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.global_addresses.v1.MoveRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_addresses/v1/global_addresses.proto#L245} + /// [google.cloud.cpp.compute.global_addresses.v1.MoveRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_addresses/v1/global_addresses.proto#L298} /// // clang-format on future> Move( @@ -591,8 +591,9 @@ class GlobalAddressesClient { // clang-format off /// - /// Sets the labels on a GlobalAddress. To learn more about labels, read the - /// Labeling Resources documentation. + /// Sets the labels on a GlobalAddress. To learn more about labels, read + /// theLabeling + /// Resources documentation. /// https://cloud.google.com/compute/docs/reference/rest/v1/globalAddresses/setLabels /// /// @param project Project ID for this request. @@ -618,7 +619,7 @@ class GlobalAddressesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.global_addresses.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_addresses/v1/global_addresses.proto#L276} + /// [google.cloud.cpp.compute.global_addresses.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_addresses/v1/global_addresses.proto#L332} /// // clang-format on future> SetLabels( @@ -646,8 +647,9 @@ class GlobalAddressesClient { // clang-format off /// - /// Sets the labels on a GlobalAddress. To learn more about labels, read the - /// Labeling Resources documentation. + /// Sets the labels on a GlobalAddress. To learn more about labels, read + /// theLabeling + /// Resources documentation. /// https://cloud.google.com/compute/docs/reference/rest/v1/globalAddresses/setLabels /// /// @param request Unary RPCs, such as the one wrapped by this @@ -676,7 +678,7 @@ class GlobalAddressesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.global_addresses.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_addresses/v1/global_addresses.proto#L276} + /// [google.cloud.cpp.compute.global_addresses.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_addresses/v1/global_addresses.proto#L332} /// // clang-format on future> SetLabels( @@ -714,6 +716,71 @@ class GlobalAddressesClient { google::cloud::cpp::compute::v1::Operation const& operation, Options opts = {}); + // clang-format off + /// + /// Returns permissions that a caller has on the specified resource. + /// https://cloud.google.com/compute/docs/reference/rest/v1/globalAddresses/testIamPermissions + /// + /// @param project Project ID for this request. + /// @param resource Name or id of the resource for this request. + /// @param test_permissions_request_resource The TestPermissionsRequest for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.TestPermissionsResponse]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.global_addresses.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_addresses/v1/global_addresses.proto#L351} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} + /// + // clang-format on + StatusOr + TestIamPermissions( + std::string const& project, std::string const& resource, + google::cloud::cpp::compute::v1::TestPermissionsRequest const& + test_permissions_request_resource, + Options opts = {}); + + // clang-format off + /// + /// Returns permissions that a caller has on the specified resource. + /// https://cloud.google.com/compute/docs/reference/rest/v1/globalAddresses/testIamPermissions + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.global_addresses.v1.TestIamPermissionsRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.TestPermissionsResponse]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.global_addresses.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_addresses/v1/global_addresses.proto#L351} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} + /// + // clang-format on + StatusOr + TestIamPermissions(google::cloud::cpp::compute::global_addresses::v1:: + TestIamPermissionsRequest const& request, + Options opts = {}); + private: std::shared_ptr connection_; Options options_; diff --git a/google/cloud/compute/global_addresses/v1/global_addresses_connection.cc b/google/cloud/compute/global_addresses/v1/global_addresses_connection.cc index 4f401e08da523..12e967cca57fd 100644 --- a/google/cloud/compute/global_addresses/v1/global_addresses_connection.cc +++ b/google/cloud/compute/global_addresses/v1/global_addresses_connection.cc @@ -150,6 +150,13 @@ GlobalAddressesConnection::SetLabels( Status(StatusCode::kUnimplemented, "not implemented")); } +StatusOr +GlobalAddressesConnection::TestIamPermissions( + google::cloud::cpp::compute::global_addresses::v1:: + TestIamPermissionsRequest const&) { + return Status(StatusCode::kUnimplemented, "not implemented"); +} + GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END } // namespace compute_global_addresses_v1 } // namespace cloud diff --git a/google/cloud/compute/global_addresses/v1/global_addresses_connection.h b/google/cloud/compute/global_addresses/v1/global_addresses_connection.h index 6821a8893b501..c7ac04fda65dc 100644 --- a/google/cloud/compute/global_addresses/v1/global_addresses_connection.h +++ b/google/cloud/compute/global_addresses/v1/global_addresses_connection.h @@ -241,6 +241,10 @@ class GlobalAddressesConnection { virtual future> SetLabels(google::cloud::cpp::compute::v1::Operation const& operation); + + virtual StatusOr + TestIamPermissions(google::cloud::cpp::compute::global_addresses::v1:: + TestIamPermissionsRequest const& request); }; GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END diff --git a/google/cloud/compute/global_addresses/v1/global_addresses_connection_idempotency_policy.cc b/google/cloud/compute/global_addresses/v1/global_addresses_connection_idempotency_policy.cc index 985481952fa8b..e970fda35d3bb 100644 --- a/google/cloud/compute/global_addresses/v1/global_addresses_connection_idempotency_policy.cc +++ b/google/cloud/compute/global_addresses/v1/global_addresses_connection_idempotency_policy.cc @@ -69,6 +69,12 @@ Idempotency GlobalAddressesConnectionIdempotencyPolicy::SetLabels( return Idempotency::kNonIdempotent; } +Idempotency GlobalAddressesConnectionIdempotencyPolicy::TestIamPermissions( + google::cloud::cpp::compute::global_addresses::v1:: + TestIamPermissionsRequest const&) { + return Idempotency::kNonIdempotent; +} + std::unique_ptr MakeDefaultGlobalAddressesConnectionIdempotencyPolicy() { return std::make_unique(); diff --git a/google/cloud/compute/global_addresses/v1/global_addresses_connection_idempotency_policy.h b/google/cloud/compute/global_addresses/v1/global_addresses_connection_idempotency_policy.h index 9dd39bbc3f342..cdd2a91cb62d5 100644 --- a/google/cloud/compute/global_addresses/v1/global_addresses_connection_idempotency_policy.h +++ b/google/cloud/compute/global_addresses/v1/global_addresses_connection_idempotency_policy.h @@ -60,6 +60,10 @@ class GlobalAddressesConnectionIdempotencyPolicy { virtual google::cloud::Idempotency SetLabels( google::cloud::cpp::compute::global_addresses::v1::SetLabelsRequest const& request); + + virtual google::cloud::Idempotency TestIamPermissions( + google::cloud::cpp::compute::global_addresses::v1:: + TestIamPermissionsRequest const& request); }; std::unique_ptr 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 b0644b347d78c..eb7317f3a946c 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 @@ -26,10 +26,11 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_GLOBAL_ADDRESSES_V1_GLOBAL_ADDRESSES_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include "google/cloud/compute/v1/internal/common_004.pb.h" -#include "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_044.pb.h" -#include "google/cloud/compute/v1/internal/common_046.pb.h" +#include "google/cloud/compute/v1/internal/common_005.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_054.pb.h" +#include "google/cloud/compute/v1/internal/common_056.pb.h" +#include "google/cloud/compute/v1/internal/common_171.pb.h" // 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_addresses/v1/internal/global_addresses_rest_connection_impl.cc b/google/cloud/compute/global_addresses/v1/internal/global_addresses_rest_connection_impl.cc index e4c90a6d5c56c..8680c94f2d684 100644 --- a/google/cloud/compute/global_addresses/v1/internal/global_addresses_rest_connection_impl.cc +++ b/google/cloud/compute/global_addresses/v1/internal/global_addresses_rest_connection_impl.cc @@ -609,6 +609,22 @@ GlobalAddressesRestConnectionImpl::SetLabels( }); } +StatusOr +GlobalAddressesRestConnectionImpl::TestIamPermissions( + google::cloud::cpp::compute::global_addresses::v1:: + TestIamPermissionsRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->TestIamPermissions(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::global_addresses::v1:: + TestIamPermissionsRequest const& request) { + return stub_->TestIamPermissions(rest_context, options, request); + }, + *current, request, __func__); +} + GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END } // namespace compute_global_addresses_v1_internal } // namespace cloud diff --git a/google/cloud/compute/global_addresses/v1/internal/global_addresses_rest_connection_impl.h b/google/cloud/compute/global_addresses/v1/internal/global_addresses_rest_connection_impl.h index c4728b4212c91..5cdae75eb23cb 100644 --- a/google/cloud/compute/global_addresses/v1/internal/global_addresses_rest_connection_impl.h +++ b/google/cloud/compute/global_addresses/v1/internal/global_addresses_rest_connection_impl.h @@ -106,6 +106,10 @@ class GlobalAddressesRestConnectionImpl future> SetLabels( google::cloud::cpp::compute::v1::Operation const& operation) override; + StatusOr + TestIamPermissions(google::cloud::cpp::compute::global_addresses::v1:: + TestIamPermissionsRequest const& request) override; + private: static std::unique_ptr< compute_global_addresses_v1::GlobalAddressesRetryPolicy> diff --git a/google/cloud/compute/global_addresses/v1/internal/global_addresses_rest_logging_decorator.cc b/google/cloud/compute/global_addresses/v1/internal/global_addresses_rest_logging_decorator.cc index adfe130506326..0490d50354b54 100644 --- a/google/cloud/compute/global_addresses/v1/internal/global_addresses_rest_logging_decorator.cc +++ b/google/cloud/compute/global_addresses/v1/internal/global_addresses_rest_logging_decorator.cc @@ -198,6 +198,20 @@ GlobalAddressesRestLogging::SetLabels( rest_context, options, request, __func__, tracing_options_); } +StatusOr +GlobalAddressesRestLogging::TestIamPermissions( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::global_addresses::v1:: + TestIamPermissionsRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::global_addresses::v1:: + TestIamPermissionsRequest const& request) { + return child_->TestIamPermissions(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + future> GlobalAddressesRestLogging::AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/global_addresses/v1/internal/global_addresses_rest_logging_decorator.h b/google/cloud/compute/global_addresses/v1/internal/global_addresses_rest_logging_decorator.h index d5ba84324f16b..45f60f8644140 100644 --- a/google/cloud/compute/global_addresses/v1/internal/global_addresses_rest_logging_decorator.h +++ b/google/cloud/compute/global_addresses/v1/internal/global_addresses_rest_logging_decorator.h @@ -108,6 +108,12 @@ class GlobalAddressesRestLogging : public GlobalAddressesRestStub { google::cloud::cpp::compute::global_addresses::v1::SetLabelsRequest const& request) override; + StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::global_addresses::v1:: + TestIamPermissionsRequest const& request) override; + future> AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/global_addresses/v1/internal/global_addresses_rest_metadata_decorator.cc b/google/cloud/compute/global_addresses/v1/internal/global_addresses_rest_metadata_decorator.cc index e22bf20cf3676..5686449300f42 100644 --- a/google/cloud/compute/global_addresses/v1/internal/global_addresses_rest_metadata_decorator.cc +++ b/google/cloud/compute/global_addresses/v1/internal/global_addresses_rest_metadata_decorator.cc @@ -141,6 +141,15 @@ GlobalAddressesRestMetadata::SetLabels( return child_->SetLabels(rest_context, options, request); } +StatusOr +GlobalAddressesRestMetadata::TestIamPermissions( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::global_addresses::v1:: + TestIamPermissionsRequest const& request) { + SetMetadata(rest_context, options); + return child_->TestIamPermissions(rest_context, options, request); +} + future> GlobalAddressesRestMetadata::AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/global_addresses/v1/internal/global_addresses_rest_metadata_decorator.h b/google/cloud/compute/global_addresses/v1/internal/global_addresses_rest_metadata_decorator.h index 1aa0271e26443..95bc66d2170db 100644 --- a/google/cloud/compute/global_addresses/v1/internal/global_addresses_rest_metadata_decorator.h +++ b/google/cloud/compute/global_addresses/v1/internal/global_addresses_rest_metadata_decorator.h @@ -108,6 +108,12 @@ class GlobalAddressesRestMetadata : public GlobalAddressesRestStub { google::cloud::cpp::compute::global_addresses::v1::SetLabelsRequest const& request) override; + StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::global_addresses::v1:: + TestIamPermissionsRequest const& request) override; + google::cloud::future> AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/global_addresses/v1/internal/global_addresses_rest_stub.cc b/google/cloud/compute/global_addresses/v1/internal/global_addresses_rest_stub.cc index 731ebc3898ffd..0f76531cdc1d2 100644 --- a/google/cloud/compute/global_addresses/v1/internal/global_addresses_rest_stub.cc +++ b/google/cloud/compute/global_addresses/v1/internal/global_addresses_rest_stub.cc @@ -307,6 +307,25 @@ DefaultGlobalAddressesRestStub::SetLabels( std::move(query_params)); } +StatusOr +DefaultGlobalAddressesRestStub::TestIamPermissions( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::global_addresses::v1:: + TestIamPermissionsRequest const& request) { + std::vector> query_params; + return rest_internal::Post< + google::cloud::cpp::compute::v1::TestPermissionsResponse>( + *service_, rest_context, request.test_permissions_request_resource(), + false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "global", "/", + "addresses", "/", request.resource(), "/", + "testIamPermissions"), + std::move(query_params)); +} + future> DefaultGlobalAddressesRestStub::AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/global_addresses/v1/internal/global_addresses_rest_stub.h b/google/cloud/compute/global_addresses/v1/internal/global_addresses_rest_stub.h index f1f1a4cbff8d1..c9b244a25a448 100644 --- a/google/cloud/compute/global_addresses/v1/internal/global_addresses_rest_stub.h +++ b/google/cloud/compute/global_addresses/v1/internal/global_addresses_rest_stub.h @@ -105,6 +105,12 @@ class GlobalAddressesRestStub { google::cloud::cpp::compute::global_addresses::v1::SetLabelsRequest const& request) = 0; + virtual StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::global_addresses::v1:: + TestIamPermissionsRequest const& request) = 0; + virtual future> AsyncGetOperation( google::cloud::CompletionQueue& cq, @@ -196,6 +202,12 @@ class DefaultGlobalAddressesRestStub : public GlobalAddressesRestStub { google::cloud::cpp::compute::global_addresses::v1::SetLabelsRequest const& request) override; + StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::global_addresses::v1:: + TestIamPermissionsRequest const& request) override; + future> AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/global_addresses/v1/internal/global_addresses_tracing_connection.cc b/google/cloud/compute/global_addresses/v1/internal/global_addresses_tracing_connection.cc index 34b6c4c69b648..cf7b3d02b6d16 100644 --- a/google/cloud/compute/global_addresses/v1/internal/global_addresses_tracing_connection.cc +++ b/google/cloud/compute/global_addresses/v1/internal/global_addresses_tracing_connection.cc @@ -173,6 +173,17 @@ GlobalAddressesTracingConnection::SetLabels( return internal::EndSpan(std::move(span), child_->SetLabels(operation)); } +StatusOr +GlobalAddressesTracingConnection::TestIamPermissions( + google::cloud::cpp::compute::global_addresses::v1:: + TestIamPermissionsRequest const& request) { + auto span = internal::MakeSpan( + "compute_global_addresses_v1::GlobalAddressesConnection::" + "TestIamPermissions"); + auto scope = opentelemetry::trace::Scope(span); + return internal::EndSpan(*span, child_->TestIamPermissions(request)); +} + std::shared_ptr MakeGlobalAddressesTracingConnection( std::shared_ptr diff --git a/google/cloud/compute/global_addresses/v1/internal/global_addresses_tracing_connection.h b/google/cloud/compute/global_addresses/v1/internal/global_addresses_tracing_connection.h index 9ee4fa21ee56b..9cee82f8f83d4 100644 --- a/google/cloud/compute/global_addresses/v1/internal/global_addresses_tracing_connection.h +++ b/google/cloud/compute/global_addresses/v1/internal/global_addresses_tracing_connection.h @@ -93,6 +93,10 @@ class GlobalAddressesTracingConnection future> SetLabels( google::cloud::cpp::compute::v1::Operation const& operation) override; + StatusOr + TestIamPermissions(google::cloud::cpp::compute::global_addresses::v1:: + TestIamPermissionsRequest const& request) override; + private: std::shared_ptr child_; diff --git a/google/cloud/compute/global_addresses/v1/mocks/mock_global_addresses_connection.h b/google/cloud/compute/global_addresses/v1/mocks/mock_global_addresses_connection.h index a24f3a8f8036c..6c88b978ca400 100644 --- a/google/cloud/compute/global_addresses/v1/mocks/mock_global_addresses_connection.h +++ b/google/cloud/compute/global_addresses/v1/mocks/mock_global_addresses_connection.h @@ -219,6 +219,13 @@ class MockGlobalAddressesConnection SetLabels, (google::cloud::cpp::compute::v1::Operation const& operation), (override)); + + MOCK_METHOD( + StatusOr, + TestIamPermissions, + (google::cloud::cpp::compute::global_addresses::v1:: + TestIamPermissionsRequest const& request), + (override)); }; GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END 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..cdbb8720cc6b6 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 @@ -119,7 +119,7 @@ class GlobalForwardingRulesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.global_forwarding_rules.v1.DeleteForwardingRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_forwarding_rules/v1/global_forwarding_rules.proto#L134} + /// [google.cloud.cpp.compute.global_forwarding_rules.v1.DeleteForwardingRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_forwarding_rules/v1/global_forwarding_rules.proto#L136} /// // clang-format on future> @@ -172,7 +172,7 @@ class GlobalForwardingRulesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.global_forwarding_rules.v1.DeleteForwardingRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_forwarding_rules/v1/global_forwarding_rules.proto#L134} + /// [google.cloud.cpp.compute.global_forwarding_rules.v1.DeleteForwardingRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_forwarding_rules/v1/global_forwarding_rules.proto#L136} /// // clang-format on future> @@ -232,8 +232,8 @@ class GlobalForwardingRulesClient { /// [`future`]: @ref google::cloud::future /// [`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.global_forwarding_rules.v1.GetForwardingRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_forwarding_rules/v1/global_forwarding_rules.proto#L165} + /// [google.cloud.cpp.compute.v1.ForwardingRule]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_050.proto#L44} /// // clang-format on StatusOr GetForwardingRule( @@ -265,8 +265,8 @@ class GlobalForwardingRulesClient { /// [`future`]: @ref google::cloud::future /// [`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.global_forwarding_rules.v1.GetForwardingRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_forwarding_rules/v1/global_forwarding_rules.proto#L165} + /// [google.cloud.cpp.compute.v1.ForwardingRule]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_050.proto#L44} /// // clang-format on StatusOr GetForwardingRule( @@ -276,8 +276,8 @@ class GlobalForwardingRulesClient { // clang-format off /// - /// Creates a GlobalForwardingRule resource in the specified project using the - /// data included in the request. + /// Creates a GlobalForwardingRule resource in the specified project using + /// the data included in the request. /// https://cloud.google.com/compute/docs/reference/rest/v1/globalForwardingRules/insert /// /// @param project Project ID for this request. @@ -302,7 +302,7 @@ class GlobalForwardingRulesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.global_forwarding_rules.v1.InsertForwardingRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_forwarding_rules/v1/global_forwarding_rules.proto#L171} + /// [google.cloud.cpp.compute.global_forwarding_rules.v1.InsertForwardingRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_forwarding_rules/v1/global_forwarding_rules.proto#L182} /// // clang-format on future> @@ -330,8 +330,8 @@ class GlobalForwardingRulesClient { // clang-format off /// - /// Creates a GlobalForwardingRule resource in the specified project using the - /// data included in the request. + /// Creates a GlobalForwardingRule resource in the specified project using + /// the data included in the request. /// https://cloud.google.com/compute/docs/reference/rest/v1/globalForwardingRules/insert /// /// @param request Unary RPCs, such as the one wrapped by this @@ -360,7 +360,7 @@ class GlobalForwardingRulesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.global_forwarding_rules.v1.InsertForwardingRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_forwarding_rules/v1/global_forwarding_rules.proto#L171} + /// [google.cloud.cpp.compute.global_forwarding_rules.v1.InsertForwardingRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_forwarding_rules/v1/global_forwarding_rules.proto#L182} /// // clang-format on future> @@ -428,8 +428,8 @@ class GlobalForwardingRulesClient { /// [`future`]: @ref google::cloud::future /// [`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.global_forwarding_rules.v1.ListGlobalForwardingRulesRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_forwarding_rules/v1/global_forwarding_rules.proto#L211} + /// [google.cloud.cpp.compute.v1.ForwardingRule]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_050.proto#L44} /// // clang-format on StreamRange @@ -469,8 +469,8 @@ class GlobalForwardingRulesClient { /// [`future`]: @ref google::cloud::future /// [`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.global_forwarding_rules.v1.ListGlobalForwardingRulesRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_forwarding_rules/v1/global_forwarding_rules.proto#L211} + /// [google.cloud.cpp.compute.v1.ForwardingRule]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_050.proto#L44} /// // clang-format on StreamRange @@ -482,9 +482,10 @@ class GlobalForwardingRulesClient { // clang-format off /// /// 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. + /// request. This method supportsPATCH + /// semantics and uses theJSON merge + /// patch format and processing rules. Currently, you can only + /// patch the network_tier field. /// https://cloud.google.com/compute/docs/reference/rest/v1/globalForwardingRules/patch /// /// @param project Project ID for this request. @@ -510,7 +511,7 @@ class GlobalForwardingRulesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.global_forwarding_rules.v1.PatchForwardingRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_forwarding_rules/v1/global_forwarding_rules.proto#L265} + /// [google.cloud.cpp.compute.global_forwarding_rules.v1.PatchForwardingRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_forwarding_rules/v1/global_forwarding_rules.proto#L312} /// // clang-format on future> @@ -541,9 +542,10 @@ class GlobalForwardingRulesClient { // clang-format off /// /// 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. + /// request. This method supportsPATCH + /// semantics and uses theJSON merge + /// patch format and processing rules. Currently, you can only + /// patch the network_tier field. /// https://cloud.google.com/compute/docs/reference/rest/v1/globalForwardingRules/patch /// /// @param request Unary RPCs, such as the one wrapped by this @@ -572,7 +574,7 @@ class GlobalForwardingRulesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.global_forwarding_rules.v1.PatchForwardingRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_forwarding_rules/v1/global_forwarding_rules.proto#L265} + /// [google.cloud.cpp.compute.global_forwarding_rules.v1.PatchForwardingRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_forwarding_rules/v1/global_forwarding_rules.proto#L312} /// // clang-format on future> @@ -613,8 +615,9 @@ class GlobalForwardingRulesClient { // clang-format off /// - /// Sets the labels on the specified resource. To learn more about labels, read - /// the Labeling resources documentation. + /// Sets the labels on the specified resource. To learn more about labels, + /// read the + /// Labeling resources documentation. /// https://cloud.google.com/compute/docs/reference/rest/v1/globalForwardingRules/setLabels /// /// @param project Project ID for this request. @@ -640,7 +643,7 @@ class GlobalForwardingRulesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.global_forwarding_rules.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_forwarding_rules/v1/global_forwarding_rules.proto#L295} + /// [google.cloud.cpp.compute.global_forwarding_rules.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_forwarding_rules/v1/global_forwarding_rules.proto#L345} /// // clang-format on future> SetLabels( @@ -668,8 +671,9 @@ class GlobalForwardingRulesClient { // clang-format off /// - /// Sets the labels on the specified resource. To learn more about labels, read - /// the Labeling resources documentation. + /// Sets the labels on the specified resource. To learn more about labels, + /// read the + /// Labeling resources documentation. /// https://cloud.google.com/compute/docs/reference/rest/v1/globalForwardingRules/setLabels /// /// @param request Unary RPCs, such as the one wrapped by this @@ -698,7 +702,7 @@ class GlobalForwardingRulesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.global_forwarding_rules.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_forwarding_rules/v1/global_forwarding_rules.proto#L295} + /// [google.cloud.cpp.compute.global_forwarding_rules.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_forwarding_rules/v1/global_forwarding_rules.proto#L345} /// // clang-format on future> SetLabels( @@ -765,7 +769,7 @@ class GlobalForwardingRulesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.global_forwarding_rules.v1.SetTargetRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_forwarding_rules/v1/global_forwarding_rules.proto#L314} + /// [google.cloud.cpp.compute.global_forwarding_rules.v1.SetTargetRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_forwarding_rules/v1/global_forwarding_rules.proto#L364} /// // clang-format on future> SetTarget( @@ -824,7 +828,7 @@ class GlobalForwardingRulesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.global_forwarding_rules.v1.SetTargetRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_forwarding_rules/v1/global_forwarding_rules.proto#L314} + /// [google.cloud.cpp.compute.global_forwarding_rules.v1.SetTargetRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_forwarding_rules/v1/global_forwarding_rules.proto#L364} /// // clang-format on future> SetTarget( 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 c09990225c10b..253acc974cfd0 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 "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_041.pb.h" -#include "google/cloud/compute/v1/internal/common_046.pb.h" -#include "google/cloud/compute/v1/internal/common_082.pb.h" -#include "google/cloud/compute/v1/internal/common_140.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_050.pb.h" +#include "google/cloud/compute/v1/internal/common_056.pb.h" +#include "google/cloud/compute/v1/internal/common_097.pb.h" +#include "google/cloud/compute/v1/internal/common_166.pb.h" // 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_forwarding_rules/v1/internal/global_forwarding_rules_rest_stub.cc b/google/cloud/compute/global_forwarding_rules/v1/internal/global_forwarding_rules_rest_stub.cc index 41cecffb11fd7..485453de93b72 100644 --- a/google/cloud/compute/global_forwarding_rules/v1/internal/global_forwarding_rules_rest_stub.cc +++ b/google/cloud/compute/global_forwarding_rules/v1/internal/global_forwarding_rules_rest_stub.cc @@ -110,6 +110,9 @@ DefaultGlobalForwardingRulesRestStub::GetForwardingRule( google::cloud::cpp::compute::global_forwarding_rules::v1:: GetForwardingRuleRequest const& request) { std::vector> query_params; + query_params.push_back({"view", request.view()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); return rest_internal::Get( *service_, rest_context, request, false, absl::StrCat("/", "compute", "/", 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 c22a4bb74b999..6ece8f982fd48 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 @@ -123,7 +123,7 @@ class GlobalNetworkEndpointGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.global_network_endpoint_groups.v1.AttachNetworkEndpointsRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_network_endpoint_groups/v1/global_network_endpoint_groups.proto#L127} + /// [google.cloud.cpp.compute.global_network_endpoint_groups.v1.AttachNetworkEndpointsRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_network_endpoint_groups/v1/global_network_endpoint_groups.proto#L141} /// // clang-format on future> @@ -184,7 +184,7 @@ class GlobalNetworkEndpointGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.global_network_endpoint_groups.v1.AttachNetworkEndpointsRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_network_endpoint_groups/v1/global_network_endpoint_groups.proto#L127} + /// [google.cloud.cpp.compute.global_network_endpoint_groups.v1.AttachNetworkEndpointsRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_network_endpoint_groups/v1/global_network_endpoint_groups.proto#L141} /// // clang-format on future> @@ -253,7 +253,7 @@ class GlobalNetworkEndpointGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.global_network_endpoint_groups.v1.DeleteNetworkEndpointGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_network_endpoint_groups/v1/global_network_endpoint_groups.proto#L162} + /// [google.cloud.cpp.compute.global_network_endpoint_groups.v1.DeleteNetworkEndpointGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_network_endpoint_groups/v1/global_network_endpoint_groups.proto#L179} /// // clang-format on future> @@ -309,7 +309,7 @@ class GlobalNetworkEndpointGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.global_network_endpoint_groups.v1.DeleteNetworkEndpointGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_network_endpoint_groups/v1/global_network_endpoint_groups.proto#L162} + /// [google.cloud.cpp.compute.global_network_endpoint_groups.v1.DeleteNetworkEndpointGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_network_endpoint_groups/v1/global_network_endpoint_groups.proto#L179} /// // clang-format on future> @@ -379,7 +379,7 @@ class GlobalNetworkEndpointGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.global_network_endpoint_groups.v1.DetachNetworkEndpointsRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_network_endpoint_groups/v1/global_network_endpoint_groups.proto#L191} + /// [google.cloud.cpp.compute.global_network_endpoint_groups.v1.DetachNetworkEndpointsRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_network_endpoint_groups/v1/global_network_endpoint_groups.proto#L211} /// // clang-format on future> @@ -440,7 +440,7 @@ class GlobalNetworkEndpointGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.global_network_endpoint_groups.v1.DetachNetworkEndpointsRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_network_endpoint_groups/v1/global_network_endpoint_groups.proto#L191} + /// [google.cloud.cpp.compute.global_network_endpoint_groups.v1.DetachNetworkEndpointsRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_network_endpoint_groups/v1/global_network_endpoint_groups.proto#L211} /// // clang-format on future> @@ -500,8 +500,8 @@ class GlobalNetworkEndpointGroupsClient { /// [`future`]: @ref google::cloud::future /// [`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_012.proto#L131} + /// [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#L249} + /// [google.cloud.cpp.compute.v1.NetworkEndpointGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_015.proto#L157} /// // clang-format on StatusOr @@ -533,8 +533,8 @@ class GlobalNetworkEndpointGroupsClient { /// [`future`]: @ref google::cloud::future /// [`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_012.proto#L131} + /// [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#L249} + /// [google.cloud.cpp.compute.v1.NetworkEndpointGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_015.proto#L157} /// // clang-format on StatusOr @@ -547,6 +547,20 @@ class GlobalNetworkEndpointGroupsClient { /// /// Creates a network endpoint group in the specified project using the /// parameters that are included in the request. + /// + /// Note: Use the following APIs to manage network endpoint groups: + /// + /// - + /// To manage NEGs with zonal scope (such as zonal NEGs, hybrid connectivity + /// NEGs): zonal + /// API + /// - + /// To manage NEGs with regional scope (such as regional internet NEGs, + /// serverless NEGs, Private Service Connect NEGs): regional + /// API + /// - + /// To manage NEGs with global scope (such as global internet NEGs):global + /// API /// https://cloud.google.com/compute/docs/reference/rest/v1/globalNetworkEndpointGroups/insert /// /// @param project Project ID for this request. @@ -571,7 +585,7 @@ class GlobalNetworkEndpointGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.global_network_endpoint_groups.v1.InsertNetworkEndpointGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_network_endpoint_groups/v1/global_network_endpoint_groups.proto#L239} + /// [google.cloud.cpp.compute.global_network_endpoint_groups.v1.InsertNetworkEndpointGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_network_endpoint_groups/v1/global_network_endpoint_groups.proto#L262} /// // clang-format on future> @@ -603,6 +617,20 @@ class GlobalNetworkEndpointGroupsClient { /// /// Creates a network endpoint group in the specified project using the /// parameters that are included in the request. + /// + /// Note: Use the following APIs to manage network endpoint groups: + /// + /// - + /// To manage NEGs with zonal scope (such as zonal NEGs, hybrid connectivity + /// NEGs): zonal + /// API + /// - + /// To manage NEGs with regional scope (such as regional internet NEGs, + /// serverless NEGs, Private Service Connect NEGs): regional + /// API + /// - + /// To manage NEGs with global scope (such as global internet NEGs):global + /// API /// https://cloud.google.com/compute/docs/reference/rest/v1/globalNetworkEndpointGroups/insert /// /// @param request Unary RPCs, such as the one wrapped by this @@ -631,7 +659,7 @@ class GlobalNetworkEndpointGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.global_network_endpoint_groups.v1.InsertNetworkEndpointGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_network_endpoint_groups/v1/global_network_endpoint_groups.proto#L239} + /// [google.cloud.cpp.compute.global_network_endpoint_groups.v1.InsertNetworkEndpointGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_network_endpoint_groups/v1/global_network_endpoint_groups.proto#L262} /// // clang-format on future> @@ -701,8 +729,8 @@ class GlobalNetworkEndpointGroupsClient { /// [`future`]: @ref google::cloud::future /// [`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_012.proto#L131} + /// [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#L291} + /// [google.cloud.cpp.compute.v1.NetworkEndpointGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_015.proto#L157} /// // clang-format on StreamRange @@ -743,8 +771,8 @@ class GlobalNetworkEndpointGroupsClient { /// [`future`]: @ref google::cloud::future /// [`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_012.proto#L131} + /// [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#L291} + /// [google.cloud.cpp.compute.v1.NetworkEndpointGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_015.proto#L157} /// // clang-format on StreamRange @@ -783,8 +811,8 @@ class GlobalNetworkEndpointGroupsClient { /// [`future`]: @ref google::cloud::future /// [`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_012.proto#L548} + /// [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#L392} + /// [google.cloud.cpp.compute.v1.NetworkEndpointWithHealthStatus]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_015.proto#L678} /// // clang-format on StreamRange @@ -825,8 +853,8 @@ class GlobalNetworkEndpointGroupsClient { /// [`future`]: @ref google::cloud::future /// [`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_012.proto#L548} + /// [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#L392} + /// [google.cloud.cpp.compute.v1.NetworkEndpointWithHealthStatus]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_015.proto#L678} /// // 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 85c0a2ff64177..6d20e32b51b7c 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 "google/cloud/compute/v1/internal/common_012.pb.h" -#include "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_045.pb.h" -#include "google/cloud/compute/v1/internal/common_049.pb.h" +#include "google/cloud/compute/v1/internal/common_015.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_055.pb.h" +#include "google/cloud/compute/v1/internal/common_061.pb.h" // 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 4c0ba7ba5b597..3fd634810167d 100644 --- a/google/cloud/compute/global_operations/v1/global_operations_client.h +++ b/google/cloud/compute/global_operations/v1/global_operations_client.h @@ -90,8 +90,10 @@ class GlobalOperationsClient { // clang-format off /// - /// Retrieves an aggregated list of all operations. To prevent failure, Google - /// recommends that you set the `returnPartialSuccess` parameter to `true`. + /// Retrieves an aggregated list of all operations. + /// + /// To prevent failure, Google recommends that you set the + /// `returnPartialSuccess` parameter to `true`. /// https://cloud.google.com/compute/docs/reference/rest/v1/globalOperations/aggregatedList /// /// @param project Project ID for this request. @@ -117,8 +119,8 @@ class GlobalOperationsClient { /// [`future`]: @ref google::cloud::future /// [`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_091.proto#L138} + /// [google.cloud.cpp.compute.global_operations.v1.AggregatedListGlobalOperationsRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_operations/v1/global_operations.proto#L114} + /// [google.cloud.cpp.compute.v1.OperationsScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_106.proto#L160} /// // clang-format on StreamRange GetOperation( @@ -277,8 +281,8 @@ class GlobalOperationsClient { /// [`future`]: @ref google::cloud::future /// [`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_016.proto#L131} + /// [google.cloud.cpp.compute.global_operations.v1.GetOperationRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_operations/v1/global_operations.proto#L241} + /// [google.cloud.cpp.compute.v1.Operation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_019.proto#L188} /// // clang-format on StatusOr GetOperation( @@ -315,8 +319,8 @@ class GlobalOperationsClient { /// [`future`]: @ref google::cloud::future /// [`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_016.proto#L131} + /// [google.cloud.cpp.compute.global_operations.v1.ListGlobalOperationsRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_operations/v1/global_operations.proto#L256} + /// [google.cloud.cpp.compute.v1.Operation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_019.proto#L188} /// // clang-format on StreamRange ListGlobalOperations( @@ -356,8 +360,8 @@ class GlobalOperationsClient { /// [`future`]: @ref google::cloud::future /// [`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_016.proto#L131} + /// [google.cloud.cpp.compute.global_operations.v1.ListGlobalOperationsRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_operations/v1/global_operations.proto#L256} + /// [google.cloud.cpp.compute.v1.Operation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_019.proto#L188} /// // clang-format on StreamRange ListGlobalOperations( @@ -367,17 +371,24 @@ class GlobalOperationsClient { // clang-format off /// - /// 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`. + /// 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`. /// https://cloud.google.com/compute/docs/reference/rest/v1/globalOperations/wait /// /// @param project Project ID for this request. @@ -396,8 +407,8 @@ class GlobalOperationsClient { /// [`future`]: @ref google::cloud::future /// [`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_016.proto#L131} + /// [google.cloud.cpp.compute.global_operations.v1.WaitRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_operations/v1/global_operations.proto#L357} + /// [google.cloud.cpp.compute.v1.Operation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_019.proto#L188} /// // clang-format on StatusOr Wait( @@ -406,17 +417,24 @@ class GlobalOperationsClient { // clang-format off /// - /// 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`. + /// 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`. /// https://cloud.google.com/compute/docs/reference/rest/v1/globalOperations/wait /// /// @param request Unary RPCs, such as the one wrapped by this @@ -438,8 +456,8 @@ class GlobalOperationsClient { /// [`future`]: @ref google::cloud::future /// [`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_016.proto#L131} + /// [google.cloud.cpp.compute.global_operations.v1.WaitRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_operations/v1/global_operations.proto#L357} + /// [google.cloud.cpp.compute.v1.Operation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_019.proto#L188} /// // 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 a852292680565..f586386feb465 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 "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_091.pb.h" -#include "google/cloud/compute/v1/internal/common_092.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_106.pb.h" +#include "google/cloud/compute/v1/internal/common_107.pb.h" // 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 6f8fe3d380b6b..847bde4c259cb 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 @@ -147,12 +147,12 @@ class GlobalOrganizationOperationsClient { // clang-format off /// - /// Retrieves the specified Operations resource. Gets a list of operations by - /// making a `list()` request. + /// Retrieves the specified Operations resource. Gets a list of operations + /// by making a `list()` request. /// https://cloud.google.com/compute/docs/reference/rest/v1/globalOrganizationOperations/get /// - /// @param operation Name of the Operations resource to return, or its unique numeric - /// identifier. + /// @param operation Name of the Operations resource to return. Parent is derived from this + /// field. /// @param opts Optional. Override the class-level options, such as retry and /// backoff policies. /// @return the result of the RPC. The response message type @@ -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_016.proto#L131} + /// [google.cloud.cpp.compute.v1.Operation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_019.proto#L188} /// // clang-format on StatusOr GetOperation( @@ -175,8 +175,8 @@ class GlobalOrganizationOperationsClient { // clang-format off /// - /// Retrieves the specified Operations resource. Gets a list of operations by - /// making a `list()` request. + /// Retrieves the specified Operations resource. Gets a list of operations + /// by making a `list()` request. /// https://cloud.google.com/compute/docs/reference/rest/v1/globalOrganizationOperations/get /// /// @param request Unary RPCs, such as the one wrapped by this @@ -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_016.proto#L131} + /// [google.cloud.cpp.compute.v1.Operation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_019.proto#L188} /// // 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_016.proto#L131} + /// [google.cloud.cpp.compute.v1.Operation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_019.proto#L188} /// // 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 dabfdd3777981..c61ee57a6dd90 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 "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_092.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_107.pb.h" // 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 5f0f0a75395de..13306f8a013a3 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 @@ -120,7 +120,7 @@ class GlobalPublicDelegatedPrefixesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.global_public_delegated_prefixes.v1.DeletePublicDelegatedPrefixRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_public_delegated_prefixes/v1/global_public_delegated_prefixes.proto#L103} + /// [google.cloud.cpp.compute.global_public_delegated_prefixes.v1.DeletePublicDelegatedPrefixRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_public_delegated_prefixes/v1/global_public_delegated_prefixes.proto#L104} /// // clang-format on future> @@ -175,7 +175,7 @@ class GlobalPublicDelegatedPrefixesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.global_public_delegated_prefixes.v1.DeletePublicDelegatedPrefixRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_public_delegated_prefixes/v1/global_public_delegated_prefixes.proto#L103} + /// [google.cloud.cpp.compute.global_public_delegated_prefixes.v1.DeletePublicDelegatedPrefixRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_public_delegated_prefixes/v1/global_public_delegated_prefixes.proto#L104} /// // clang-format on future> @@ -236,8 +236,8 @@ class GlobalPublicDelegatedPrefixesClient { /// [`future`]: @ref google::cloud::future /// [`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_096.proto#L29} + /// [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#L135} + /// [google.cloud.cpp.compute.v1.PublicDelegatedPrefix]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_113.proto#L29} /// // clang-format on StatusOr @@ -269,8 +269,8 @@ class GlobalPublicDelegatedPrefixesClient { /// [`future`]: @ref google::cloud::future /// [`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_096.proto#L29} + /// [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#L135} + /// [google.cloud.cpp.compute.v1.PublicDelegatedPrefix]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_113.proto#L29} /// // clang-format on StatusOr @@ -307,7 +307,7 @@ class GlobalPublicDelegatedPrefixesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.global_public_delegated_prefixes.v1.InsertPublicDelegatedPrefixRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_public_delegated_prefixes/v1/global_public_delegated_prefixes.proto#L144} + /// [google.cloud.cpp.compute.global_public_delegated_prefixes.v1.InsertPublicDelegatedPrefixRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_public_delegated_prefixes/v1/global_public_delegated_prefixes.proto#L148} /// // clang-format on future> @@ -367,7 +367,7 @@ class GlobalPublicDelegatedPrefixesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.global_public_delegated_prefixes.v1.InsertPublicDelegatedPrefixRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_public_delegated_prefixes/v1/global_public_delegated_prefixes.proto#L144} + /// [google.cloud.cpp.compute.global_public_delegated_prefixes.v1.InsertPublicDelegatedPrefixRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_public_delegated_prefixes/v1/global_public_delegated_prefixes.proto#L148} /// // clang-format on future> @@ -436,8 +436,8 @@ class GlobalPublicDelegatedPrefixesClient { /// [`future`]: @ref google::cloud::future /// [`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_096.proto#L29} + /// [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#L177} + /// [google.cloud.cpp.compute.v1.PublicDelegatedPrefix]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_113.proto#L29} /// // clang-format on StreamRange @@ -477,8 +477,8 @@ class GlobalPublicDelegatedPrefixesClient { /// [`future`]: @ref google::cloud::future /// [`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_096.proto#L29} + /// [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#L177} + /// [google.cloud.cpp.compute.v1.PublicDelegatedPrefix]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_113.proto#L29} /// // clang-format on StreamRange @@ -490,8 +490,9 @@ class GlobalPublicDelegatedPrefixesClient { // clang-format off /// /// 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. + /// included in the request. This method supportsPATCH + /// semantics and usesJSON merge + /// patch format and processing rules. /// https://cloud.google.com/compute/docs/reference/rest/v1/globalPublicDelegatedPrefixes/patch /// /// @param project Project ID for this request. @@ -517,7 +518,7 @@ class GlobalPublicDelegatedPrefixesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.global_public_delegated_prefixes.v1.PatchPublicDelegatedPrefixRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_public_delegated_prefixes/v1/global_public_delegated_prefixes.proto#L238} + /// [google.cloud.cpp.compute.global_public_delegated_prefixes.v1.PatchPublicDelegatedPrefixRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_public_delegated_prefixes/v1/global_public_delegated_prefixes.proto#L278} /// // clang-format on future> @@ -549,8 +550,9 @@ class GlobalPublicDelegatedPrefixesClient { // clang-format off /// /// 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. + /// included in the request. This method supportsPATCH + /// semantics and usesJSON merge + /// patch format and processing rules. /// https://cloud.google.com/compute/docs/reference/rest/v1/globalPublicDelegatedPrefixes/patch /// /// @param request Unary RPCs, such as the one wrapped by this @@ -579,7 +581,7 @@ class GlobalPublicDelegatedPrefixesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.global_public_delegated_prefixes.v1.PatchPublicDelegatedPrefixRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_public_delegated_prefixes/v1/global_public_delegated_prefixes.proto#L238} + /// [google.cloud.cpp.compute.global_public_delegated_prefixes.v1.PatchPublicDelegatedPrefixRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_public_delegated_prefixes/v1/global_public_delegated_prefixes.proto#L278} /// // clang-format on future> 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 3bdf0adb99009..9b4e812517b90 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 "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_096.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_113.pb.h" // 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/global_vm_extension_policies/v1/global_vm_extension_policies_client.cc b/google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies_client.cc new file mode 100644 index 0000000000000..6ef1f8a9590f8 --- /dev/null +++ b/google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies_client.cc @@ -0,0 +1,282 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies.proto + +#include "google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies_client.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_global_vm_extension_policies_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +GlobalVmExtensionPoliciesClient::GlobalVmExtensionPoliciesClient( + std::shared_ptr connection, + Options opts) + : connection_(std::move(connection)), + options_( + internal::MergeOptions(std::move(opts), connection_->options())) {} +GlobalVmExtensionPoliciesClient::~GlobalVmExtensionPoliciesClient() = default; + +StreamRange< + std::pair> +GlobalVmExtensionPoliciesClient::AggregatedListGlobalVmExtensionPolicies( + std::string const& project, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + AggregatedListGlobalVmExtensionPoliciesRequest request; + request.set_project(project); + return connection_->AggregatedListGlobalVmExtensionPolicies(request); +} + +StreamRange< + std::pair> +GlobalVmExtensionPoliciesClient::AggregatedListGlobalVmExtensionPolicies( + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + AggregatedListGlobalVmExtensionPoliciesRequest request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->AggregatedListGlobalVmExtensionPolicies( + std::move(request)); +} + +future> +GlobalVmExtensionPoliciesClient::DeleteGlobalVmExtensionPolicy( + std::string const& project, std::string const& global_vm_extension_policy, + google::cloud::cpp::compute::v1:: + GlobalVmExtensionPolicyRolloutOperationRolloutInput const& + global_vm_extension_policy_rollout_operation_rollout_input_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + DeleteGlobalVmExtensionPolicyRequest request; + request.set_project(project); + request.set_global_vm_extension_policy(global_vm_extension_policy); + *request + .mutable_global_vm_extension_policy_rollout_operation_rollout_input_resource() = + global_vm_extension_policy_rollout_operation_rollout_input_resource; + return connection_->DeleteGlobalVmExtensionPolicy(request); +} + +StatusOr +GlobalVmExtensionPoliciesClient::DeleteGlobalVmExtensionPolicy( + NoAwaitTag, std::string const& project, + std::string const& global_vm_extension_policy, + google::cloud::cpp::compute::v1:: + GlobalVmExtensionPolicyRolloutOperationRolloutInput const& + global_vm_extension_policy_rollout_operation_rollout_input_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + DeleteGlobalVmExtensionPolicyRequest request; + request.set_project(project); + request.set_global_vm_extension_policy(global_vm_extension_policy); + *request + .mutable_global_vm_extension_policy_rollout_operation_rollout_input_resource() = + global_vm_extension_policy_rollout_operation_rollout_input_resource; + return connection_->DeleteGlobalVmExtensionPolicy(NoAwaitTag{}, request); +} + +future> +GlobalVmExtensionPoliciesClient::DeleteGlobalVmExtensionPolicy( + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + DeleteGlobalVmExtensionPolicyRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->DeleteGlobalVmExtensionPolicy(request); +} + +StatusOr +GlobalVmExtensionPoliciesClient::DeleteGlobalVmExtensionPolicy( + NoAwaitTag, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + DeleteGlobalVmExtensionPolicyRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->DeleteGlobalVmExtensionPolicy(NoAwaitTag{}, request); +} + +future> +GlobalVmExtensionPoliciesClient::DeleteGlobalVmExtensionPolicy( + google::cloud::cpp::compute::v1::Operation const& operation, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->DeleteGlobalVmExtensionPolicy(operation); +} + +StatusOr +GlobalVmExtensionPoliciesClient::GetGlobalVmExtensionPolicy( + std::string const& project, std::string const& global_vm_extension_policy, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + GetGlobalVmExtensionPolicyRequest request; + request.set_project(project); + request.set_global_vm_extension_policy(global_vm_extension_policy); + return connection_->GetGlobalVmExtensionPolicy(request); +} + +StatusOr +GlobalVmExtensionPoliciesClient::GetGlobalVmExtensionPolicy( + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + GetGlobalVmExtensionPolicyRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->GetGlobalVmExtensionPolicy(request); +} + +future> +GlobalVmExtensionPoliciesClient::InsertGlobalVmExtensionPolicy( + std::string const& project, + google::cloud::cpp::compute::v1::GlobalVmExtensionPolicy const& + global_vm_extension_policy_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + InsertGlobalVmExtensionPolicyRequest request; + request.set_project(project); + *request.mutable_global_vm_extension_policy_resource() = + global_vm_extension_policy_resource; + return connection_->InsertGlobalVmExtensionPolicy(request); +} + +StatusOr +GlobalVmExtensionPoliciesClient::InsertGlobalVmExtensionPolicy( + NoAwaitTag, std::string const& project, + google::cloud::cpp::compute::v1::GlobalVmExtensionPolicy const& + global_vm_extension_policy_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + InsertGlobalVmExtensionPolicyRequest request; + request.set_project(project); + *request.mutable_global_vm_extension_policy_resource() = + global_vm_extension_policy_resource; + return connection_->InsertGlobalVmExtensionPolicy(NoAwaitTag{}, request); +} + +future> +GlobalVmExtensionPoliciesClient::InsertGlobalVmExtensionPolicy( + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + InsertGlobalVmExtensionPolicyRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->InsertGlobalVmExtensionPolicy(request); +} + +StatusOr +GlobalVmExtensionPoliciesClient::InsertGlobalVmExtensionPolicy( + NoAwaitTag, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + InsertGlobalVmExtensionPolicyRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->InsertGlobalVmExtensionPolicy(NoAwaitTag{}, request); +} + +future> +GlobalVmExtensionPoliciesClient::InsertGlobalVmExtensionPolicy( + google::cloud::cpp::compute::v1::Operation const& operation, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->InsertGlobalVmExtensionPolicy(operation); +} + +StreamRange +GlobalVmExtensionPoliciesClient::ListGlobalVmExtensionPolicies( + std::string const& project, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + ListGlobalVmExtensionPoliciesRequest request; + request.set_project(project); + return connection_->ListGlobalVmExtensionPolicies(request); +} + +StreamRange +GlobalVmExtensionPoliciesClient::ListGlobalVmExtensionPolicies( + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + ListGlobalVmExtensionPoliciesRequest request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->ListGlobalVmExtensionPolicies(std::move(request)); +} + +future> +GlobalVmExtensionPoliciesClient::UpdateGlobalVmExtensionPolicy( + std::string const& project, std::string const& global_vm_extension_policy, + google::cloud::cpp::compute::v1::GlobalVmExtensionPolicy const& + global_vm_extension_policy_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + UpdateGlobalVmExtensionPolicyRequest request; + request.set_project(project); + request.set_global_vm_extension_policy(global_vm_extension_policy); + *request.mutable_global_vm_extension_policy_resource() = + global_vm_extension_policy_resource; + return connection_->UpdateGlobalVmExtensionPolicy(request); +} + +StatusOr +GlobalVmExtensionPoliciesClient::UpdateGlobalVmExtensionPolicy( + NoAwaitTag, std::string const& project, + std::string const& global_vm_extension_policy, + google::cloud::cpp::compute::v1::GlobalVmExtensionPolicy const& + global_vm_extension_policy_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + UpdateGlobalVmExtensionPolicyRequest request; + request.set_project(project); + request.set_global_vm_extension_policy(global_vm_extension_policy); + *request.mutable_global_vm_extension_policy_resource() = + global_vm_extension_policy_resource; + return connection_->UpdateGlobalVmExtensionPolicy(NoAwaitTag{}, request); +} + +future> +GlobalVmExtensionPoliciesClient::UpdateGlobalVmExtensionPolicy( + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + UpdateGlobalVmExtensionPolicyRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->UpdateGlobalVmExtensionPolicy(request); +} + +StatusOr +GlobalVmExtensionPoliciesClient::UpdateGlobalVmExtensionPolicy( + NoAwaitTag, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + UpdateGlobalVmExtensionPolicyRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->UpdateGlobalVmExtensionPolicy(NoAwaitTag{}, request); +} + +future> +GlobalVmExtensionPoliciesClient::UpdateGlobalVmExtensionPolicy( + google::cloud::cpp::compute::v1::Operation const& operation, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->UpdateGlobalVmExtensionPolicy(operation); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_global_vm_extension_policies_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies_client.h b/google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies_client.h new file mode 100644 index 0000000000000..7f5ba60525810 --- /dev/null +++ b/google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies_client.h @@ -0,0 +1,735 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_GLOBAL_VM_EXTENSION_POLICIES_V1_GLOBAL_VM_EXTENSION_POLICIES_CLIENT_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_GLOBAL_VM_EXTENSION_POLICIES_V1_GLOBAL_VM_EXTENSION_POLICIES_CLIENT_H + +#include "google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies_rest_connection.h" +#include "google/cloud/future.h" +#include "google/cloud/no_await_tag.h" +#include "google/cloud/options.h" +#include "google/cloud/polling_policy.h" +#include "google/cloud/status_or.h" +#include "google/cloud/version.h" +#include +#include +#include + +namespace google { +namespace cloud { +namespace compute_global_vm_extension_policies_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/// +/// Service for the globalVmExtensionPolicies resource. +/// https://cloud.google.com/compute/docs/reference/rest/v1/globalVmExtensionPolicies +/// +/// @par Equality +/// +/// Instances of this class created via copy-construction or copy-assignment +/// always compare equal. Instances created with equal +/// `std::shared_ptr<*Connection>` objects compare equal. Objects that compare +/// equal share the same underlying resources. +/// +/// @par Performance +/// +/// Creating a new instance of this class is a relatively expensive operation, +/// new objects establish new connections to the service. In contrast, +/// copy-construction, move-construction, and the corresponding assignment +/// operations are relatively efficient as the copies share all underlying +/// resources. +/// +/// @par Thread Safety +/// +/// Concurrent access to different instances of this class, even if they compare +/// equal, is guaranteed to work. Two or more threads operating on the same +/// instance of this class is not guaranteed to work. Since copy-construction +/// and move-construction is a relatively efficient operation, consider using +/// such a copy when using this class from multiple threads. +/// +class GlobalVmExtensionPoliciesClient { + public: + explicit GlobalVmExtensionPoliciesClient( + std::shared_ptr connection, + Options opts = {}); + ~GlobalVmExtensionPoliciesClient(); + + ///@{ + /// @name Copy and move support + GlobalVmExtensionPoliciesClient(GlobalVmExtensionPoliciesClient const&) = + default; + GlobalVmExtensionPoliciesClient& operator=( + GlobalVmExtensionPoliciesClient const&) = default; + GlobalVmExtensionPoliciesClient(GlobalVmExtensionPoliciesClient&&) = default; + GlobalVmExtensionPoliciesClient& operator=( + GlobalVmExtensionPoliciesClient&&) = default; + ///@} + + ///@{ + /// @name Equality + friend bool operator==(GlobalVmExtensionPoliciesClient const& a, + GlobalVmExtensionPoliciesClient const& b) { + return a.connection_ == b.connection_; + } + friend bool operator!=(GlobalVmExtensionPoliciesClient const& a, + GlobalVmExtensionPoliciesClient const& b) { + return !(a == b); + } + ///@} + + // clang-format off + /// + /// Retrieves the list of all VM Extension Policy resources + /// available to the specified project. + /// + /// To prevent failure, it's recommended that you set the + /// `returnPartialSuccess` parameter to `true`. + /// https://cloud.google.com/compute/docs/reference/rest/v1/globalVmExtensionPolicies/aggregatedList + /// + /// @param project Name of the project scoping this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return a [StreamRange](@ref google::cloud::StreamRange) + /// to iterate of the results. See the documentation of this type for + /// details. In brief, this class has `begin()` and `end()` member + /// functions returning a iterator class meeting the + /// [input iterator requirements]. The value type for this iterator is a + /// [`StatusOr`] as the iteration may fail even after some values are + /// retrieved successfully, for example, if there is a network disconnect. + /// An empty set of results does not indicate an error, it indicates + /// that there are no resources meeting the request criteria. + /// On a successful iteration the `StatusOr` contains elements of type + /// [google.cloud.cpp.compute.v1.VmExtensionPoliciesScopedList], or rather, + /// the C++ class generated by Protobuf from that type. Please consult the + /// Protobuf documentation for details on the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.global_vm_extension_policies.v1.AggregatedListGlobalVmExtensionPoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies.proto#L122} + /// [google.cloud.cpp.compute.v1.VmExtensionPoliciesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_058.proto#L375} + /// + // clang-format on + StreamRange< + std::pair> + AggregatedListGlobalVmExtensionPolicies(std::string const& project, + Options opts = {}); + + // clang-format off + /// + /// Retrieves the list of all VM Extension Policy resources + /// available to the specified project. + /// + /// To prevent failure, it's recommended that you set the + /// `returnPartialSuccess` parameter to `true`. + /// https://cloud.google.com/compute/docs/reference/rest/v1/globalVmExtensionPolicies/aggregatedList + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.global_vm_extension_policies.v1.AggregatedListGlobalVmExtensionPoliciesRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return a [StreamRange](@ref google::cloud::StreamRange) + /// to iterate of the results. See the documentation of this type for + /// details. In brief, this class has `begin()` and `end()` member + /// functions returning a iterator class meeting the + /// [input iterator requirements]. The value type for this iterator is a + /// [`StatusOr`] as the iteration may fail even after some values are + /// retrieved successfully, for example, if there is a network disconnect. + /// An empty set of results does not indicate an error, it indicates + /// that there are no resources meeting the request criteria. + /// On a successful iteration the `StatusOr` contains elements of type + /// [google.cloud.cpp.compute.v1.VmExtensionPoliciesScopedList], or rather, + /// the C++ class generated by Protobuf from that type. Please consult the + /// Protobuf documentation for details on the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.global_vm_extension_policies.v1.AggregatedListGlobalVmExtensionPoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies.proto#L122} + /// [google.cloud.cpp.compute.v1.VmExtensionPoliciesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_058.proto#L375} + /// + // clang-format on + StreamRange< + std::pair> + AggregatedListGlobalVmExtensionPolicies( + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + AggregatedListGlobalVmExtensionPoliciesRequest request, + Options opts = {}); + + // clang-format off + /// + /// Purge scoped resources (zonal policies) from a global VM extension + /// policy, and then delete the global VM extension policy. Purge of the scoped + /// resources is a pre-condition of the global VM extension policy deletion. + /// The deletion of the global VM extension policy happens after the purge + /// rollout is done, so it's not a part of the LRO. It's an automatic process + /// that triggers in the backend. + /// https://cloud.google.com/compute/docs/reference/rest/v1/globalVmExtensionPolicies/delete + /// + /// @param project Project ID for this request. + /// @param global_vm_extension_policy Name of the global VM extension policy to purge scoped resources for. + /// @param global_vm_extension_policy_rollout_operation_rollout_input_resource The GlobalVmExtensionPolicyRolloutOperationRolloutInput for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.global_vm_extension_policies.v1.DeleteGlobalVmExtensionPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies.proto#L237} + /// + // clang-format on + future> + DeleteGlobalVmExtensionPolicy( + std::string const& project, std::string const& global_vm_extension_policy, + google::cloud::cpp::compute::v1:: + GlobalVmExtensionPolicyRolloutOperationRolloutInput const& + global_vm_extension_policy_rollout_operation_rollout_input_resource, + Options opts = {}); + + // clang-format off + /// + /// @copybrief DeleteGlobalVmExtensionPolicy + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr + DeleteGlobalVmExtensionPolicy( + NoAwaitTag, std::string const& project, + std::string const& global_vm_extension_policy, + google::cloud::cpp::compute::v1:: + GlobalVmExtensionPolicyRolloutOperationRolloutInput const& + global_vm_extension_policy_rollout_operation_rollout_input_resource, + Options opts = {}); + + // clang-format off + /// + /// Purge scoped resources (zonal policies) from a global VM extension + /// policy, and then delete the global VM extension policy. Purge of the scoped + /// resources is a pre-condition of the global VM extension policy deletion. + /// The deletion of the global VM extension policy happens after the purge + /// rollout is done, so it's not a part of the LRO. It's an automatic process + /// that triggers in the backend. + /// https://cloud.google.com/compute/docs/reference/rest/v1/globalVmExtensionPolicies/delete + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.global_vm_extension_policies.v1.DeleteGlobalVmExtensionPolicyRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.global_vm_extension_policies.v1.DeleteGlobalVmExtensionPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies.proto#L237} + /// + // clang-format on + future> + DeleteGlobalVmExtensionPolicy( + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + DeleteGlobalVmExtensionPolicyRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief DeleteGlobalVmExtensionPolicy + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr + DeleteGlobalVmExtensionPolicy( + NoAwaitTag, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + DeleteGlobalVmExtensionPolicyRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief DeleteGlobalVmExtensionPolicy + /// + /// This method accepts a `google::cloud::cpp::compute::v1::Operation` that corresponds + /// to a previously started Long Running Operation (LRO) and polls the status + /// of the LRO in the background. + /// + // clang-format on + future> + DeleteGlobalVmExtensionPolicy( + google::cloud::cpp::compute::v1::Operation const& operation, + Options opts = {}); + + // clang-format off + /// + /// Gets details of a global VM extension policy. + /// https://cloud.google.com/compute/docs/reference/rest/v1/globalVmExtensionPolicies/get + /// + /// @param project Project ID for this request. + /// @param global_vm_extension_policy Name of the GlobalVmExtensionPolicy resource to return. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.GlobalVmExtensionPolicy]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.global_vm_extension_policies.v1.GetGlobalVmExtensionPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies.proto#L274} + /// [google.cloud.cpp.compute.v1.GlobalVmExtensionPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_058.proto#L27} + /// + // clang-format on + StatusOr + GetGlobalVmExtensionPolicy(std::string const& project, + std::string const& global_vm_extension_policy, + Options opts = {}); + + // clang-format off + /// + /// Gets details of a global VM extension policy. + /// https://cloud.google.com/compute/docs/reference/rest/v1/globalVmExtensionPolicies/get + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.global_vm_extension_policies.v1.GetGlobalVmExtensionPolicyRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.GlobalVmExtensionPolicy]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.global_vm_extension_policies.v1.GetGlobalVmExtensionPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies.proto#L274} + /// [google.cloud.cpp.compute.v1.GlobalVmExtensionPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_058.proto#L27} + /// + // clang-format on + StatusOr + GetGlobalVmExtensionPolicy( + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + GetGlobalVmExtensionPolicyRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// Creates a new project level GlobalVmExtensionPolicy. + /// https://cloud.google.com/compute/docs/reference/rest/v1/globalVmExtensionPolicies/insert + /// + /// @param project Project ID for this request. + /// @param global_vm_extension_policy_resource The GlobalVmExtensionPolicy for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.global_vm_extension_policies.v1.InsertGlobalVmExtensionPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies.proto#L287} + /// + // clang-format on + future> + InsertGlobalVmExtensionPolicy( + std::string const& project, + google::cloud::cpp::compute::v1::GlobalVmExtensionPolicy const& + global_vm_extension_policy_resource, + Options opts = {}); + + // clang-format off + /// + /// @copybrief InsertGlobalVmExtensionPolicy + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr + InsertGlobalVmExtensionPolicy( + NoAwaitTag, std::string const& project, + google::cloud::cpp::compute::v1::GlobalVmExtensionPolicy const& + global_vm_extension_policy_resource, + Options opts = {}); + + // clang-format off + /// + /// Creates a new project level GlobalVmExtensionPolicy. + /// https://cloud.google.com/compute/docs/reference/rest/v1/globalVmExtensionPolicies/insert + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.global_vm_extension_policies.v1.InsertGlobalVmExtensionPolicyRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.global_vm_extension_policies.v1.InsertGlobalVmExtensionPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies.proto#L287} + /// + // clang-format on + future> + InsertGlobalVmExtensionPolicy( + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + InsertGlobalVmExtensionPolicyRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief InsertGlobalVmExtensionPolicy + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr + InsertGlobalVmExtensionPolicy( + NoAwaitTag, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + InsertGlobalVmExtensionPolicyRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief InsertGlobalVmExtensionPolicy + /// + /// This method accepts a `google::cloud::cpp::compute::v1::Operation` that corresponds + /// to a previously started Long Running Operation (LRO) and polls the status + /// of the LRO in the background. + /// + // clang-format on + future> + InsertGlobalVmExtensionPolicy( + google::cloud::cpp::compute::v1::Operation const& operation, + Options opts = {}); + + // clang-format off + /// + /// Lists global VM extension policies. + /// https://cloud.google.com/compute/docs/reference/rest/v1/globalVmExtensionPolicies/list + /// + /// @param project Project ID for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return a [StreamRange](@ref google::cloud::StreamRange) + /// to iterate of the results. See the documentation of this type for + /// details. In brief, this class has `begin()` and `end()` member + /// functions returning a iterator class meeting the + /// [input iterator requirements]. The value type for this iterator is a + /// [`StatusOr`] as the iteration may fail even after some values are + /// retrieved successfully, for example, if there is a network disconnect. + /// An empty set of results does not indicate an error, it indicates + /// that there are no resources meeting the request criteria. + /// On a successful iteration the `StatusOr` contains elements of type + /// [google.cloud.cpp.compute.v1.GlobalVmExtensionPolicy], or rather, + /// the C++ class generated by Protobuf from that type. Please consult the + /// Protobuf documentation for details on the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.global_vm_extension_policies.v1.ListGlobalVmExtensionPoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies.proto#L317} + /// [google.cloud.cpp.compute.v1.GlobalVmExtensionPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_058.proto#L27} + /// + // clang-format on + StreamRange + ListGlobalVmExtensionPolicies(std::string const& project, Options opts = {}); + + // clang-format off + /// + /// Lists global VM extension policies. + /// https://cloud.google.com/compute/docs/reference/rest/v1/globalVmExtensionPolicies/list + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.global_vm_extension_policies.v1.ListGlobalVmExtensionPoliciesRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return a [StreamRange](@ref google::cloud::StreamRange) + /// to iterate of the results. See the documentation of this type for + /// details. In brief, this class has `begin()` and `end()` member + /// functions returning a iterator class meeting the + /// [input iterator requirements]. The value type for this iterator is a + /// [`StatusOr`] as the iteration may fail even after some values are + /// retrieved successfully, for example, if there is a network disconnect. + /// An empty set of results does not indicate an error, it indicates + /// that there are no resources meeting the request criteria. + /// On a successful iteration the `StatusOr` contains elements of type + /// [google.cloud.cpp.compute.v1.GlobalVmExtensionPolicy], or rather, + /// the C++ class generated by Protobuf from that type. Please consult the + /// Protobuf documentation for details on the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.global_vm_extension_policies.v1.ListGlobalVmExtensionPoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies.proto#L317} + /// [google.cloud.cpp.compute.v1.GlobalVmExtensionPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_058.proto#L27} + /// + // clang-format on + StreamRange + ListGlobalVmExtensionPolicies( + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + ListGlobalVmExtensionPoliciesRequest request, + Options opts = {}); + + // clang-format off + /// + /// Updates a global VM extension policy. + /// https://cloud.google.com/compute/docs/reference/rest/v1/globalVmExtensionPolicies/update + /// + /// @param project Project ID for this request. + /// @param global_vm_extension_policy Name of the global VM extension policy to update. + /// @param global_vm_extension_policy_resource The GlobalVmExtensionPolicy for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.global_vm_extension_policies.v1.UpdateGlobalVmExtensionPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies.proto#L418} + /// + // clang-format on + future> + UpdateGlobalVmExtensionPolicy( + std::string const& project, std::string const& global_vm_extension_policy, + google::cloud::cpp::compute::v1::GlobalVmExtensionPolicy const& + global_vm_extension_policy_resource, + Options opts = {}); + + // clang-format off + /// + /// @copybrief UpdateGlobalVmExtensionPolicy + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr + UpdateGlobalVmExtensionPolicy( + NoAwaitTag, std::string const& project, + std::string const& global_vm_extension_policy, + google::cloud::cpp::compute::v1::GlobalVmExtensionPolicy const& + global_vm_extension_policy_resource, + Options opts = {}); + + // clang-format off + /// + /// Updates a global VM extension policy. + /// https://cloud.google.com/compute/docs/reference/rest/v1/globalVmExtensionPolicies/update + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.global_vm_extension_policies.v1.UpdateGlobalVmExtensionPolicyRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.global_vm_extension_policies.v1.UpdateGlobalVmExtensionPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies.proto#L418} + /// + // clang-format on + future> + UpdateGlobalVmExtensionPolicy( + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + UpdateGlobalVmExtensionPolicyRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief UpdateGlobalVmExtensionPolicy + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr + UpdateGlobalVmExtensionPolicy( + NoAwaitTag, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + UpdateGlobalVmExtensionPolicyRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief UpdateGlobalVmExtensionPolicy + /// + /// This method accepts a `google::cloud::cpp::compute::v1::Operation` that corresponds + /// to a previously started Long Running Operation (LRO) and polls the status + /// of the LRO in the background. + /// + // clang-format on + future> + UpdateGlobalVmExtensionPolicy( + google::cloud::cpp::compute::v1::Operation const& operation, + Options opts = {}); + + private: + std::shared_ptr connection_; + Options options_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_global_vm_extension_policies_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_GLOBAL_VM_EXTENSION_POLICIES_V1_GLOBAL_VM_EXTENSION_POLICIES_CLIENT_H diff --git a/google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies_connection.cc b/google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies_connection.cc new file mode 100644 index 0000000000000..f93ae09f52ce6 --- /dev/null +++ b/google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies_connection.cc @@ -0,0 +1,145 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies.proto + +#include "google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies_connection.h" +#include "google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies_options.h" +#include "google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_option_defaults.h" +#include "google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_tracing_connection.h" +#include "google/cloud/background_threads.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/grpc_options.h" +#include "google/cloud/internal/pagination_range.h" +#include "google/cloud/internal/unified_grpc_credentials.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_global_vm_extension_policies_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +GlobalVmExtensionPoliciesConnection::~GlobalVmExtensionPoliciesConnection() = + default; + +StreamRange< + std::pair> +GlobalVmExtensionPoliciesConnection::AggregatedListGlobalVmExtensionPolicies( + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + AggregatedListGlobalVmExtensionPoliciesRequest) { // NOLINT(performance-unnecessary-value-param) + return google::cloud::internal::MakeUnimplementedPaginationRange< + StreamRange>>(); +} + +future> +GlobalVmExtensionPoliciesConnection::DeleteGlobalVmExtensionPolicy( + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + DeleteGlobalVmExtensionPolicyRequest const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +GlobalVmExtensionPoliciesConnection::DeleteGlobalVmExtensionPolicy( + NoAwaitTag, google::cloud::cpp::compute::global_vm_extension_policies::v1:: + DeleteGlobalVmExtensionPolicyRequest const&) { + return StatusOr( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +GlobalVmExtensionPoliciesConnection::DeleteGlobalVmExtensionPolicy( + google::cloud::cpp::compute::v1::Operation const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +GlobalVmExtensionPoliciesConnection::GetGlobalVmExtensionPolicy( + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + GetGlobalVmExtensionPolicyRequest const&) { + return Status(StatusCode::kUnimplemented, "not implemented"); +} + +future> +GlobalVmExtensionPoliciesConnection::InsertGlobalVmExtensionPolicy( + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + InsertGlobalVmExtensionPolicyRequest const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +GlobalVmExtensionPoliciesConnection::InsertGlobalVmExtensionPolicy( + NoAwaitTag, google::cloud::cpp::compute::global_vm_extension_policies::v1:: + InsertGlobalVmExtensionPolicyRequest const&) { + return StatusOr( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +GlobalVmExtensionPoliciesConnection::InsertGlobalVmExtensionPolicy( + google::cloud::cpp::compute::v1::Operation const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StreamRange +GlobalVmExtensionPoliciesConnection::ListGlobalVmExtensionPolicies( + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + ListGlobalVmExtensionPoliciesRequest) { // NOLINT(performance-unnecessary-value-param) + return google::cloud::internal::MakeUnimplementedPaginationRange< + StreamRange>(); +} + +future> +GlobalVmExtensionPoliciesConnection::UpdateGlobalVmExtensionPolicy( + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + UpdateGlobalVmExtensionPolicyRequest const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +GlobalVmExtensionPoliciesConnection::UpdateGlobalVmExtensionPolicy( + NoAwaitTag, google::cloud::cpp::compute::global_vm_extension_policies::v1:: + UpdateGlobalVmExtensionPolicyRequest const&) { + return StatusOr( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +GlobalVmExtensionPoliciesConnection::UpdateGlobalVmExtensionPolicy( + google::cloud::cpp::compute::v1::Operation const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_global_vm_extension_policies_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies_connection.h b/google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies_connection.h new file mode 100644 index 0000000000000..1641ad54c85c6 --- /dev/null +++ b/google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies_connection.h @@ -0,0 +1,270 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_GLOBAL_VM_EXTENSION_POLICIES_V1_GLOBAL_VM_EXTENSION_POLICIES_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_GLOBAL_VM_EXTENSION_POLICIES_V1_GLOBAL_VM_EXTENSION_POLICIES_CONNECTION_H + +#include "google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies.pb.h" +#include "google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies_connection_idempotency_policy.h" +#include "google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_retry_traits.h" +#include "google/cloud/backoff_policy.h" +#include "google/cloud/future.h" +#include "google/cloud/internal/retry_policy_impl.h" +#include "google/cloud/no_await_tag.h" +#include "google/cloud/options.h" +#include "google/cloud/polling_policy.h" +#include "google/cloud/status_or.h" +#include "google/cloud/stream_range.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_global_vm_extension_policies_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/// The retry policy for `GlobalVmExtensionPoliciesConnection`. +class GlobalVmExtensionPoliciesRetryPolicy + : public ::google::cloud::RetryPolicy { + public: + /// Creates a new instance of the policy, reset to the initial state. + virtual std::unique_ptr clone() + const = 0; +}; + +/** + * A retry policy for `GlobalVmExtensionPoliciesConnection` based on counting + * errors. + * + * This policy stops retrying if: + * - An RPC returns a non-transient error. + * - More than a prescribed number of transient failures is detected. + * + * In this class the following status codes are treated as transient errors: + * - [`kUnavailable`](@ref google::cloud::StatusCode) + */ +class GlobalVmExtensionPoliciesLimitedErrorCountRetryPolicy + : public GlobalVmExtensionPoliciesRetryPolicy { + public: + /** + * Create an instance that tolerates up to @p maximum_failures transient + * errors. + * + * @note Disable the retry loop by providing an instance of this policy with + * @p maximum_failures == 0. + */ + explicit GlobalVmExtensionPoliciesLimitedErrorCountRetryPolicy( + int maximum_failures) + : impl_(maximum_failures) {} + + GlobalVmExtensionPoliciesLimitedErrorCountRetryPolicy( + GlobalVmExtensionPoliciesLimitedErrorCountRetryPolicy&& rhs) noexcept + : GlobalVmExtensionPoliciesLimitedErrorCountRetryPolicy( + rhs.maximum_failures()) {} + GlobalVmExtensionPoliciesLimitedErrorCountRetryPolicy( + GlobalVmExtensionPoliciesLimitedErrorCountRetryPolicy const& rhs) noexcept + : GlobalVmExtensionPoliciesLimitedErrorCountRetryPolicy( + rhs.maximum_failures()) {} + + int maximum_failures() const { return impl_.maximum_failures(); } + + bool OnFailure(Status const& status) override { + return impl_.OnFailure(status); + } + bool IsExhausted() const override { return impl_.IsExhausted(); } + bool IsPermanentFailure(Status const& status) const override { + return impl_.IsPermanentFailure(status); + } + std::unique_ptr clone() const override { + return std::make_unique< + GlobalVmExtensionPoliciesLimitedErrorCountRetryPolicy>( + maximum_failures()); + } + + // This is provided only for backwards compatibility. + using BaseType = GlobalVmExtensionPoliciesRetryPolicy; + + private: + google::cloud::internal::LimitedErrorCountRetryPolicy< + compute_global_vm_extension_policies_v1_internal:: + GlobalVmExtensionPoliciesRetryTraits> + impl_; +}; + +/** + * A retry policy for `GlobalVmExtensionPoliciesConnection` based on elapsed + * time. + * + * This policy stops retrying if: + * - An RPC returns a non-transient error. + * - The elapsed time in the retry loop exceeds a prescribed duration. + * + * In this class the following status codes are treated as transient errors: + * - [`kUnavailable`](@ref google::cloud::StatusCode) + */ +class GlobalVmExtensionPoliciesLimitedTimeRetryPolicy + : public GlobalVmExtensionPoliciesRetryPolicy { + public: + /** + * Constructor given a `std::chrono::duration<>` object. + * + * @tparam DurationRep a placeholder to match the `Rep` tparam for @p + * duration's type. The semantics of this template parameter are + * documented in `std::chrono::duration<>`. In brief, the underlying + * arithmetic type used to store the number of ticks. For our purposes it + * is simply a formal parameter. + * @tparam DurationPeriod a placeholder to match the `Period` tparam for @p + * duration's type. The semantics of this template parameter are + * documented in `std::chrono::duration<>`. In brief, the length of the + * tick in seconds, expressed as a `std::ratio<>`. For our purposes it is + * simply a formal parameter. + * @param maximum_duration the maximum time allowed before the policy expires. + * While the application can express this time in any units they desire, + * the class truncates to milliseconds. + * + * @see https://en.cppreference.com/w/cpp/chrono/duration for more information + * about `std::chrono::duration`. + */ + template + explicit GlobalVmExtensionPoliciesLimitedTimeRetryPolicy( + std::chrono::duration maximum_duration) + : impl_(maximum_duration) {} + + GlobalVmExtensionPoliciesLimitedTimeRetryPolicy( + GlobalVmExtensionPoliciesLimitedTimeRetryPolicy&& rhs) noexcept + : GlobalVmExtensionPoliciesLimitedTimeRetryPolicy( + rhs.maximum_duration()) {} + GlobalVmExtensionPoliciesLimitedTimeRetryPolicy( + GlobalVmExtensionPoliciesLimitedTimeRetryPolicy const& rhs) noexcept + : GlobalVmExtensionPoliciesLimitedTimeRetryPolicy( + rhs.maximum_duration()) {} + + std::chrono::milliseconds maximum_duration() const { + return impl_.maximum_duration(); + } + + bool OnFailure(Status const& status) override { + return impl_.OnFailure(status); + } + bool IsExhausted() const override { return impl_.IsExhausted(); } + bool IsPermanentFailure(Status const& status) const override { + return impl_.IsPermanentFailure(status); + } + std::unique_ptr clone() const override { + return std::make_unique( + maximum_duration()); + } + + // This is provided only for backwards compatibility. + using BaseType = GlobalVmExtensionPoliciesRetryPolicy; + + private: + google::cloud::internal::LimitedTimeRetryPolicy< + compute_global_vm_extension_policies_v1_internal:: + GlobalVmExtensionPoliciesRetryTraits> + impl_; +}; + +/** + * The `GlobalVmExtensionPoliciesConnection` object for + * `GlobalVmExtensionPoliciesClient`. + * + * This interface defines virtual methods for each of the user-facing overload + * sets in `GlobalVmExtensionPoliciesClient`. This allows users to inject custom + * behavior (e.g., with a Google Mock object) when writing tests that use + * objects of type `GlobalVmExtensionPoliciesClient`. + * + * To create a concrete instance, see + * `MakeGlobalVmExtensionPoliciesConnection()`. + * + * For mocking, see + * `compute_global_vm_extension_policies_v1_mocks::MockGlobalVmExtensionPoliciesConnection`. + */ +class GlobalVmExtensionPoliciesConnection { + public: + virtual ~GlobalVmExtensionPoliciesConnection() = 0; + + virtual Options options() { return Options{}; } + + virtual StreamRange< + std::pair> + AggregatedListGlobalVmExtensionPolicies( + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + AggregatedListGlobalVmExtensionPoliciesRequest request); + + virtual future> + DeleteGlobalVmExtensionPolicy( + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + DeleteGlobalVmExtensionPolicyRequest const& request); + + virtual StatusOr + DeleteGlobalVmExtensionPolicy( + NoAwaitTag, google::cloud::cpp::compute::global_vm_extension_policies:: + v1::DeleteGlobalVmExtensionPolicyRequest const& request); + + virtual future> + DeleteGlobalVmExtensionPolicy( + google::cloud::cpp::compute::v1::Operation const& operation); + + virtual StatusOr + GetGlobalVmExtensionPolicy( + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + GetGlobalVmExtensionPolicyRequest const& request); + + virtual future> + InsertGlobalVmExtensionPolicy( + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + InsertGlobalVmExtensionPolicyRequest const& request); + + virtual StatusOr + InsertGlobalVmExtensionPolicy( + NoAwaitTag, google::cloud::cpp::compute::global_vm_extension_policies:: + v1::InsertGlobalVmExtensionPolicyRequest const& request); + + virtual future> + InsertGlobalVmExtensionPolicy( + google::cloud::cpp::compute::v1::Operation const& operation); + + virtual StreamRange + ListGlobalVmExtensionPolicies( + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + ListGlobalVmExtensionPoliciesRequest request); + + virtual future> + UpdateGlobalVmExtensionPolicy( + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + UpdateGlobalVmExtensionPolicyRequest const& request); + + virtual StatusOr + UpdateGlobalVmExtensionPolicy( + NoAwaitTag, google::cloud::cpp::compute::global_vm_extension_policies:: + v1::UpdateGlobalVmExtensionPolicyRequest const& request); + + virtual future> + UpdateGlobalVmExtensionPolicy( + google::cloud::cpp::compute::v1::Operation const& operation); +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_global_vm_extension_policies_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_GLOBAL_VM_EXTENSION_POLICIES_V1_GLOBAL_VM_EXTENSION_POLICIES_CONNECTION_H diff --git a/google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies_connection_idempotency_policy.cc b/google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies_connection_idempotency_policy.cc new file mode 100644 index 0000000000000..f30f4e9fdb320 --- /dev/null +++ b/google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies_connection_idempotency_policy.cc @@ -0,0 +1,90 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies.proto + +#include "google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies_connection_idempotency_policy.h" +#include + +namespace google { +namespace cloud { +namespace compute_global_vm_extension_policies_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +using ::google::cloud::Idempotency; + +GlobalVmExtensionPoliciesConnectionIdempotencyPolicy:: + ~GlobalVmExtensionPoliciesConnectionIdempotencyPolicy() = default; + +std::unique_ptr +GlobalVmExtensionPoliciesConnectionIdempotencyPolicy::clone() const { + return std::make_unique( + *this); +} + +Idempotency GlobalVmExtensionPoliciesConnectionIdempotencyPolicy:: + AggregatedListGlobalVmExtensionPolicies( + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + AggregatedListGlobalVmExtensionPoliciesRequest) { // NOLINT + return Idempotency::kIdempotent; +} + +Idempotency GlobalVmExtensionPoliciesConnectionIdempotencyPolicy:: + DeleteGlobalVmExtensionPolicy( + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + DeleteGlobalVmExtensionPolicyRequest const&) { + return Idempotency::kNonIdempotent; +} + +Idempotency GlobalVmExtensionPoliciesConnectionIdempotencyPolicy:: + GetGlobalVmExtensionPolicy( + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + GetGlobalVmExtensionPolicyRequest const&) { + return Idempotency::kIdempotent; +} + +Idempotency GlobalVmExtensionPoliciesConnectionIdempotencyPolicy:: + InsertGlobalVmExtensionPolicy( + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + InsertGlobalVmExtensionPolicyRequest const&) { + return Idempotency::kNonIdempotent; +} + +Idempotency GlobalVmExtensionPoliciesConnectionIdempotencyPolicy:: + ListGlobalVmExtensionPolicies( + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + ListGlobalVmExtensionPoliciesRequest) { // NOLINT + return Idempotency::kIdempotent; +} + +Idempotency GlobalVmExtensionPoliciesConnectionIdempotencyPolicy:: + UpdateGlobalVmExtensionPolicy( + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + UpdateGlobalVmExtensionPolicyRequest const&) { + return Idempotency::kNonIdempotent; +} + +std::unique_ptr +MakeDefaultGlobalVmExtensionPoliciesConnectionIdempotencyPolicy() { + return std::make_unique< + GlobalVmExtensionPoliciesConnectionIdempotencyPolicy>(); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_global_vm_extension_policies_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies_connection_idempotency_policy.h b/google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies_connection_idempotency_policy.h new file mode 100644 index 0000000000000..2e9f085b537bd --- /dev/null +++ b/google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies_connection_idempotency_policy.h @@ -0,0 +1,74 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_GLOBAL_VM_EXTENSION_POLICIES_V1_GLOBAL_VM_EXTENSION_POLICIES_CONNECTION_IDEMPOTENCY_POLICY_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_GLOBAL_VM_EXTENSION_POLICIES_V1_GLOBAL_VM_EXTENSION_POLICIES_CONNECTION_IDEMPOTENCY_POLICY_H + +#include "google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies.pb.h" +#include "google/cloud/idempotency.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_global_vm_extension_policies_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class GlobalVmExtensionPoliciesConnectionIdempotencyPolicy { + public: + virtual ~GlobalVmExtensionPoliciesConnectionIdempotencyPolicy(); + + /// Create a new copy of this object. + virtual std::unique_ptr + clone() const; + + virtual google::cloud::Idempotency AggregatedListGlobalVmExtensionPolicies( + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + AggregatedListGlobalVmExtensionPoliciesRequest request); + + virtual google::cloud::Idempotency DeleteGlobalVmExtensionPolicy( + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + DeleteGlobalVmExtensionPolicyRequest const& request); + + virtual google::cloud::Idempotency GetGlobalVmExtensionPolicy( + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + GetGlobalVmExtensionPolicyRequest const& request); + + virtual google::cloud::Idempotency InsertGlobalVmExtensionPolicy( + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + InsertGlobalVmExtensionPolicyRequest const& request); + + virtual google::cloud::Idempotency ListGlobalVmExtensionPolicies( + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + ListGlobalVmExtensionPoliciesRequest request); + + virtual google::cloud::Idempotency UpdateGlobalVmExtensionPolicy( + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + UpdateGlobalVmExtensionPolicyRequest const& request); +}; + +std::unique_ptr +MakeDefaultGlobalVmExtensionPoliciesConnectionIdempotencyPolicy(); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_global_vm_extension_policies_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_GLOBAL_VM_EXTENSION_POLICIES_V1_GLOBAL_VM_EXTENSION_POLICIES_CONNECTION_IDEMPOTENCY_POLICY_H diff --git a/google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies_options.h b/google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies_options.h new file mode 100644 index 0000000000000..585bf86118363 --- /dev/null +++ b/google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies_options.h @@ -0,0 +1,89 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_GLOBAL_VM_EXTENSION_POLICIES_V1_GLOBAL_VM_EXTENSION_POLICIES_OPTIONS_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_GLOBAL_VM_EXTENSION_POLICIES_V1_GLOBAL_VM_EXTENSION_POLICIES_OPTIONS_H + +#include "google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies_connection.h" +#include "google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies_connection_idempotency_policy.h" +#include "google/cloud/backoff_policy.h" +#include "google/cloud/options.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_global_vm_extension_policies_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/** + * Use with `google::cloud::Options` to configure the retry policy. + * + * @ingroup google-cloud-compute-options + */ +struct GlobalVmExtensionPoliciesRetryPolicyOption { + using Type = std::shared_ptr; +}; + +/** + * Use with `google::cloud::Options` to configure the backoff policy. + * + * @ingroup google-cloud-compute-options + */ +struct GlobalVmExtensionPoliciesBackoffPolicyOption { + using Type = std::shared_ptr; +}; + +/** + * Use with `google::cloud::Options` to configure which operations are retried. + * + * @ingroup google-cloud-compute-options + */ +struct GlobalVmExtensionPoliciesConnectionIdempotencyPolicyOption { + using Type = + std::shared_ptr; +}; + +/** + * Use with `google::cloud::Options` to configure the long-running operations + * polling policy. + * + * @ingroup google-cloud-compute-options + */ +struct GlobalVmExtensionPoliciesPollingPolicyOption { + using Type = std::shared_ptr; +}; + +/** + * The options applicable to GlobalVmExtensionPolicies. + * + * @ingroup google-cloud-compute-options + */ +using GlobalVmExtensionPoliciesPolicyOptionList = + OptionList; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_global_vm_extension_policies_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_GLOBAL_VM_EXTENSION_POLICIES_V1_GLOBAL_VM_EXTENSION_POLICIES_OPTIONS_H diff --git a/google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies_proto_export.h b/google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies_proto_export.h new file mode 100644 index 0000000000000..7060fbbcd675f --- /dev/null +++ b/google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies_proto_export.h @@ -0,0 +1,34 @@ +// Copyright 2026 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_GLOBAL_VM_EXTENSION_POLICIES_V1_GLOBAL_VM_EXTENSION_POLICIES_PROTO_EXPORT_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_GLOBAL_VM_EXTENSION_POLICIES_V1_GLOBAL_VM_EXTENSION_POLICIES_PROTO_EXPORT_H + +// IWYU pragma: begin_exports +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_058.pb.h" +#include "google/cloud/compute/v1/internal/common_175.pb.h" +// IWYU pragma: end_exports + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_GLOBAL_VM_EXTENSION_POLICIES_V1_GLOBAL_VM_EXTENSION_POLICIES_PROTO_EXPORT_H diff --git a/google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies_rest_connection.cc b/google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies_rest_connection.cc new file mode 100644 index 0000000000000..7edca241f8226 --- /dev/null +++ b/google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies_rest_connection.cc @@ -0,0 +1,61 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies.proto + +#include "google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies_rest_connection.h" +#include "google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies_options.h" +#include "google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_option_defaults.h" +#include "google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_rest_connection_impl.h" +#include "google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_rest_stub_factory.h" +#include "google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_tracing_connection.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/internal/rest_background_threads_impl.h" +#include "google/cloud/internal/rest_options.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_global_vm_extension_policies_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +std::shared_ptr +MakeGlobalVmExtensionPoliciesConnectionRest(Options options) { + internal::CheckExpectedOptions( + options, __func__); + options = compute_global_vm_extension_policies_v1_internal:: + GlobalVmExtensionPoliciesDefaultOptions(std::move(options)); + auto background = std::make_unique< + rest_internal::AutomaticallyCreatedRestBackgroundThreads>(); + auto stub = compute_global_vm_extension_policies_v1_internal:: + CreateDefaultGlobalVmExtensionPoliciesRestStub(options); + return compute_global_vm_extension_policies_v1_internal:: + MakeGlobalVmExtensionPoliciesTracingConnection( + std::make_shared( + std::move(background), std::move(stub), std::move(options))); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_global_vm_extension_policies_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies_rest_connection.h b/google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies_rest_connection.h new file mode 100644 index 0000000000000..f70c01b68c70b --- /dev/null +++ b/google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies_rest_connection.h @@ -0,0 +1,67 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_GLOBAL_VM_EXTENSION_POLICIES_V1_GLOBAL_VM_EXTENSION_POLICIES_REST_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_GLOBAL_VM_EXTENSION_POLICIES_V1_GLOBAL_VM_EXTENSION_POLICIES_REST_CONNECTION_H + +#include "google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies_connection.h" +#include "google/cloud/options.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_global_vm_extension_policies_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/** + * A factory function to construct an object of type + * `GlobalVmExtensionPoliciesConnection` that uses REST over HTTP as transport + * in lieu of gRPC. REST transport should only be used for services that do not + * support gRPC or if the existing network configuration precludes using gRPC. + * + * The returned connection object should not be used directly; instead it + * should be passed as an argument to the constructor of + * GlobalVmExtensionPoliciesClient. + * + * The optional @p options argument may be used to configure aspects of the + * returned `GlobalVmExtensionPoliciesConnection`. Expected options are any of + * the types in the following option lists: + * + * - `google::cloud::CommonOptionList` + * - `google::cloud::RestOptionList` + * - `google::cloud::UnifiedCredentialsOptionList` + * - + * `google::cloud::compute_global_vm_extension_policies_v1::GlobalVmExtensionPoliciesPolicyOptionList` + * + * @note Unexpected options will be ignored. To log unexpected options instead, + * set `GOOGLE_CLOUD_CPP_ENABLE_CLOG=yes` in the environment. + * + * @param options (optional) Configure the `GlobalVmExtensionPoliciesConnection` + * created by this function. + */ +std::shared_ptr +MakeGlobalVmExtensionPoliciesConnectionRest(Options options = {}); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_global_vm_extension_policies_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_GLOBAL_VM_EXTENSION_POLICIES_V1_GLOBAL_VM_EXTENSION_POLICIES_REST_CONNECTION_H diff --git a/google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_option_defaults.cc b/google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_option_defaults.cc new file mode 100644 index 0000000000000..2b71c29ee041f --- /dev/null +++ b/google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_option_defaults.cc @@ -0,0 +1,95 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies.proto + +#include "google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_option_defaults.h" +#include "google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies_connection.h" +#include "google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies_options.h" +#include "google/cloud/internal/populate_common_options.h" +#include "google/cloud/internal/populate_grpc_options.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_global_vm_extension_policies_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +namespace { +auto constexpr kBackoffScaling = 2.0; +} // namespace + +Options GlobalVmExtensionPoliciesDefaultOptions(Options options) { + options = internal::PopulateCommonOptions( + std::move(options), + "GOOGLE_CLOUD_CPP_GLOBAL_VM_EXTENSION_POLICIES_ENDPOINT", "", + "GOOGLE_CLOUD_CPP_GLOBAL_VM_EXTENSION_POLICIES_AUTHORITY", + "compute.googleapis.com"); + options = internal::PopulateGrpcOptions(std::move(options)); + if (!options.has()) { + options.set( + compute_global_vm_extension_policies_v1:: + GlobalVmExtensionPoliciesLimitedTimeRetryPolicy( + std::chrono::minutes(10)) + .clone()); + } + if (!options.has()) { + options.set( + ExponentialBackoffPolicy( + std::chrono::seconds(0), std::chrono::seconds(1), + std::chrono::minutes(5), kBackoffScaling, kBackoffScaling) + .clone()); + } + if (!options.has()) { + options.set( + GenericPollingPolicy< + compute_global_vm_extension_policies_v1:: + GlobalVmExtensionPoliciesRetryPolicyOption::Type, + compute_global_vm_extension_policies_v1:: + GlobalVmExtensionPoliciesBackoffPolicyOption::Type>( + options + .get() + ->clone(), + ExponentialBackoffPolicy(std::chrono::seconds(1), + std::chrono::minutes(5), kBackoffScaling) + .clone()) + .clone()); + } + if (!options.has< + compute_global_vm_extension_policies_v1:: + GlobalVmExtensionPoliciesConnectionIdempotencyPolicyOption>()) { + options.set( + compute_global_vm_extension_policies_v1:: + MakeDefaultGlobalVmExtensionPoliciesConnectionIdempotencyPolicy()); + } + + return options; +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_global_vm_extension_policies_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_option_defaults.h b/google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_option_defaults.h new file mode 100644 index 0000000000000..555816900168b --- /dev/null +++ b/google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_option_defaults.h @@ -0,0 +1,38 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_GLOBAL_VM_EXTENSION_POLICIES_V1_INTERNAL_GLOBAL_VM_EXTENSION_POLICIES_OPTION_DEFAULTS_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_GLOBAL_VM_EXTENSION_POLICIES_V1_INTERNAL_GLOBAL_VM_EXTENSION_POLICIES_OPTION_DEFAULTS_H + +#include "google/cloud/options.h" +#include "google/cloud/version.h" + +namespace google { +namespace cloud { +namespace compute_global_vm_extension_policies_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +Options GlobalVmExtensionPoliciesDefaultOptions(Options options); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_global_vm_extension_policies_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_GLOBAL_VM_EXTENSION_POLICIES_V1_INTERNAL_GLOBAL_VM_EXTENSION_POLICIES_OPTION_DEFAULTS_H diff --git a/google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_rest_connection_impl.cc b/google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_rest_connection_impl.cc new file mode 100644 index 0000000000000..d955fa2fbe602 --- /dev/null +++ b/google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_rest_connection_impl.cc @@ -0,0 +1,547 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies.proto + +#include "google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_rest_connection_impl.h" +#include "google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_rest_stub_factory.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/internal/async_rest_long_running_operation_custom.h" +#include "google/cloud/internal/extract_long_running_result.h" +#include "google/cloud/internal/pagination_range.h" +#include "google/cloud/internal/rest_lro_helpers.h" +#include "google/cloud/internal/rest_retry_loop.h" +#include "google/cloud/rest_options.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_global_vm_extension_policies_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +GlobalVmExtensionPoliciesRestConnectionImpl:: + GlobalVmExtensionPoliciesRestConnectionImpl( + std::unique_ptr background, + std::shared_ptr + stub, + Options options) + : background_(std::move(background)), + stub_(std::move(stub)), + options_(internal::MergeOptions( + std::move(options), GlobalVmExtensionPoliciesConnection::options())) { +} + +StreamRange< + std::pair> +GlobalVmExtensionPoliciesRestConnectionImpl:: + AggregatedListGlobalVmExtensionPolicies( + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + AggregatedListGlobalVmExtensionPoliciesRequest request) { + request.clear_page_token(); + auto current = google::cloud::internal::SaveCurrentOptions(); + auto idempotency = + idempotency_policy(*current)->AggregatedListGlobalVmExtensionPolicies( + request); + char const* function_name = __func__; + return google::cloud::internal::MakePaginationRange>>( + current, std::move(request), + [idempotency, function_name, stub = stub_, + retry = std::shared_ptr( + retry_policy(*current)), + backoff = std::shared_ptr(backoff_policy(*current))]( + Options const& options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + AggregatedListGlobalVmExtensionPoliciesRequest const& r) { + return google::cloud::rest_internal::RestRetryLoop( + retry->clone(), backoff->clone(), idempotency, + [stub](rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::global_vm_extension_policies:: + v1::AggregatedListGlobalVmExtensionPoliciesRequest const& + request) { + return stub->AggregatedListGlobalVmExtensionPolicies( + rest_context, options, request); + }, + options, r, function_name); + }, + [](google::cloud::cpp::compute::v1:: + VmExtensionPolicyAggregatedListResponse r) { + std::vector> + result(r.items().size()); + auto& messages = *r.mutable_items(); + std::move(messages.begin(), messages.end(), result.begin()); + return result; + }); +} + +future> +GlobalVmExtensionPoliciesRestConnectionImpl::DeleteGlobalVmExtensionPolicy( + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + DeleteGlobalVmExtensionPolicyRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::global_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, request, + [stub = stub_]( + CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + DeleteGlobalVmExtensionPolicyRequest const& request) { + return stub->AsyncDeleteGlobalVmExtensionPolicy( + cq, std::move(context), std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->DeleteGlobalVmExtensionPolicy(request), + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [request](std::string const& op, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest& r) { + r.set_project(request.project()); + r.set_operation(op); + }, + [request](std::string const& op, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest& r) { + r.set_project(request.project()); + r.set_operation(op); + }); +} + +StatusOr +GlobalVmExtensionPoliciesRestConnectionImpl::DeleteGlobalVmExtensionPolicy( + NoAwaitTag, google::cloud::cpp::compute::global_vm_extension_policies::v1:: + DeleteGlobalVmExtensionPolicyRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->DeleteGlobalVmExtensionPolicy(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + DeleteGlobalVmExtensionPolicyRequest const& request) { + return stub_->DeleteGlobalVmExtensionPolicy(rest_context, options, + request); + }, + *current, request, __func__); +} + +future> +GlobalVmExtensionPoliciesRestConnectionImpl::DeleteGlobalVmExtensionPolicy( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestAwaitLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::global_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, operation, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [operation](std::string const&, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_operation(info.operation); + }, + [operation](std::string const&, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_operation(info.operation); + }); +} + +StatusOr +GlobalVmExtensionPoliciesRestConnectionImpl::GetGlobalVmExtensionPolicy( + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + GetGlobalVmExtensionPolicyRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->GetGlobalVmExtensionPolicy(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + GetGlobalVmExtensionPolicyRequest const& request) { + return stub_->GetGlobalVmExtensionPolicy(rest_context, options, + request); + }, + *current, request, __func__); +} + +future> +GlobalVmExtensionPoliciesRestConnectionImpl::InsertGlobalVmExtensionPolicy( + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + InsertGlobalVmExtensionPolicyRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::global_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, request, + [stub = stub_]( + CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + InsertGlobalVmExtensionPolicyRequest const& request) { + return stub->AsyncInsertGlobalVmExtensionPolicy( + cq, std::move(context), std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->InsertGlobalVmExtensionPolicy(request), + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [request](std::string const& op, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest& r) { + r.set_project(request.project()); + r.set_operation(op); + }, + [request](std::string const& op, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest& r) { + r.set_project(request.project()); + r.set_operation(op); + }); +} + +StatusOr +GlobalVmExtensionPoliciesRestConnectionImpl::InsertGlobalVmExtensionPolicy( + NoAwaitTag, google::cloud::cpp::compute::global_vm_extension_policies::v1:: + InsertGlobalVmExtensionPolicyRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->InsertGlobalVmExtensionPolicy(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + InsertGlobalVmExtensionPolicyRequest const& request) { + return stub_->InsertGlobalVmExtensionPolicy(rest_context, options, + request); + }, + *current, request, __func__); +} + +future> +GlobalVmExtensionPoliciesRestConnectionImpl::InsertGlobalVmExtensionPolicy( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestAwaitLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::global_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, operation, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [operation](std::string const&, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_operation(info.operation); + }, + [operation](std::string const&, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_operation(info.operation); + }); +} + +StreamRange +GlobalVmExtensionPoliciesRestConnectionImpl::ListGlobalVmExtensionPolicies( + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + ListGlobalVmExtensionPoliciesRequest request) { + request.clear_page_token(); + auto current = google::cloud::internal::SaveCurrentOptions(); + auto idempotency = + idempotency_policy(*current)->ListGlobalVmExtensionPolicies(request); + char const* function_name = __func__; + return google::cloud::internal::MakePaginationRange< + StreamRange>( + current, std::move(request), + [idempotency, function_name, stub = stub_, + retry = std::shared_ptr( + retry_policy(*current)), + backoff = std::shared_ptr(backoff_policy(*current))]( + Options const& options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + ListGlobalVmExtensionPoliciesRequest const& r) { + return google::cloud::rest_internal::RestRetryLoop( + retry->clone(), backoff->clone(), idempotency, + [stub]( + rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + ListGlobalVmExtensionPoliciesRequest const& request) { + return stub->ListGlobalVmExtensionPolicies(rest_context, options, + request); + }, + options, r, function_name); + }, + [](google::cloud::cpp::compute::v1::GlobalVmExtensionPolicyList r) { + std::vector + result(r.items().size()); + auto& messages = *r.mutable_items(); + std::move(messages.begin(), messages.end(), result.begin()); + return result; + }); +} + +future> +GlobalVmExtensionPoliciesRestConnectionImpl::UpdateGlobalVmExtensionPolicy( + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + UpdateGlobalVmExtensionPolicyRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::global_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, request, + [stub = stub_]( + CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + UpdateGlobalVmExtensionPolicyRequest const& request) { + return stub->AsyncUpdateGlobalVmExtensionPolicy( + cq, std::move(context), std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->UpdateGlobalVmExtensionPolicy(request), + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [request](std::string const& op, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest& r) { + r.set_project(request.project()); + r.set_operation(op); + }, + [request](std::string const& op, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest& r) { + r.set_project(request.project()); + r.set_operation(op); + }); +} + +StatusOr +GlobalVmExtensionPoliciesRestConnectionImpl::UpdateGlobalVmExtensionPolicy( + NoAwaitTag, google::cloud::cpp::compute::global_vm_extension_policies::v1:: + UpdateGlobalVmExtensionPolicyRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->UpdateGlobalVmExtensionPolicy(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + UpdateGlobalVmExtensionPolicyRequest const& request) { + return stub_->UpdateGlobalVmExtensionPolicy(rest_context, options, + request); + }, + *current, request, __func__); +} + +future> +GlobalVmExtensionPoliciesRestConnectionImpl::UpdateGlobalVmExtensionPolicy( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestAwaitLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::global_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, operation, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [operation](std::string const&, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_operation(info.operation); + }, + [operation](std::string const&, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_operation(info.operation); + }); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_global_vm_extension_policies_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_rest_connection_impl.h b/google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_rest_connection_impl.h new file mode 100644 index 0000000000000..9322d8cec1ade --- /dev/null +++ b/google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_rest_connection_impl.h @@ -0,0 +1,165 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_GLOBAL_VM_EXTENSION_POLICIES_V1_INTERNAL_GLOBAL_VM_EXTENSION_POLICIES_REST_CONNECTION_IMPL_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_GLOBAL_VM_EXTENSION_POLICIES_V1_INTERNAL_GLOBAL_VM_EXTENSION_POLICIES_REST_CONNECTION_IMPL_H + +#include "google/cloud/compute/global_operations/v1/global_operations.pb.h" +#include "google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies_connection.h" +#include "google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies_connection_idempotency_policy.h" +#include "google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies_options.h" +#include "google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_rest_stub.h" +#include "google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_retry_traits.h" +#include "google/cloud/background_threads.h" +#include "google/cloud/backoff_policy.h" +#include "google/cloud/options.h" +#include "google/cloud/status_or.h" +#include "google/cloud/stream_range.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_global_vm_extension_policies_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class GlobalVmExtensionPoliciesRestConnectionImpl + : public compute_global_vm_extension_policies_v1:: + GlobalVmExtensionPoliciesConnection { + public: + ~GlobalVmExtensionPoliciesRestConnectionImpl() override = default; + + GlobalVmExtensionPoliciesRestConnectionImpl( + std::unique_ptr background, + std::shared_ptr + stub, + Options options); + + Options options() override { return options_; } + + StreamRange< + std::pair> + AggregatedListGlobalVmExtensionPolicies( + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + AggregatedListGlobalVmExtensionPoliciesRequest request) override; + + future> + DeleteGlobalVmExtensionPolicy( + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + DeleteGlobalVmExtensionPolicyRequest const& request) override; + + StatusOr + DeleteGlobalVmExtensionPolicy( + NoAwaitTag, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + DeleteGlobalVmExtensionPolicyRequest const& request) override; + + future> + DeleteGlobalVmExtensionPolicy( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + StatusOr + GetGlobalVmExtensionPolicy( + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + GetGlobalVmExtensionPolicyRequest const& request) override; + + future> + InsertGlobalVmExtensionPolicy( + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + InsertGlobalVmExtensionPolicyRequest const& request) override; + + StatusOr + InsertGlobalVmExtensionPolicy( + NoAwaitTag, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + InsertGlobalVmExtensionPolicyRequest const& request) override; + + future> + InsertGlobalVmExtensionPolicy( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + StreamRange + ListGlobalVmExtensionPolicies( + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + ListGlobalVmExtensionPoliciesRequest request) override; + + future> + UpdateGlobalVmExtensionPolicy( + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + UpdateGlobalVmExtensionPolicyRequest const& request) override; + + StatusOr + UpdateGlobalVmExtensionPolicy( + NoAwaitTag, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + UpdateGlobalVmExtensionPolicyRequest const& request) override; + + future> + UpdateGlobalVmExtensionPolicy( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + private: + static std::unique_ptr + retry_policy(Options const& options) { + return options + .get() + ->clone(); + } + + static std::unique_ptr backoff_policy(Options const& options) { + return options + .get() + ->clone(); + } + + static std::unique_ptr< + compute_global_vm_extension_policies_v1:: + GlobalVmExtensionPoliciesConnectionIdempotencyPolicy> + idempotency_policy(Options const& options) { + return options + .get() + ->clone(); + } + + static std::unique_ptr polling_policy(Options const& options) { + return options + .get() + ->clone(); + } + + std::unique_ptr background_; + std::shared_ptr + stub_; + Options options_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_global_vm_extension_policies_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_GLOBAL_VM_EXTENSION_POLICIES_V1_INTERNAL_GLOBAL_VM_EXTENSION_POLICIES_REST_CONNECTION_IMPL_H diff --git a/google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_rest_logging_decorator.cc b/google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_rest_logging_decorator.cc new file mode 100644 index 0000000000000..b8490030b9c17 --- /dev/null +++ b/google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_rest_logging_decorator.cc @@ -0,0 +1,232 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies.proto + +#include "google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_rest_logging_decorator.h" +#include "google/cloud/internal/log_wrapper.h" +#include "google/cloud/status_or.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_global_vm_extension_policies_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +GlobalVmExtensionPoliciesRestLogging::GlobalVmExtensionPoliciesRestLogging( + std::shared_ptr child, + TracingOptions tracing_options, std::set components) + : child_(std::move(child)), + tracing_options_(std::move(tracing_options)), + components_(std::move(components)) {} + +StatusOr< + google::cloud::cpp::compute::v1::VmExtensionPolicyAggregatedListResponse> +GlobalVmExtensionPoliciesRestLogging::AggregatedListGlobalVmExtensionPolicies( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + AggregatedListGlobalVmExtensionPoliciesRequest const& request) { + return google::cloud::internal::LogWrapper( + [this]( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + AggregatedListGlobalVmExtensionPoliciesRequest const& request) { + return child_->AggregatedListGlobalVmExtensionPolicies( + rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +future> +GlobalVmExtensionPoliciesRestLogging::AsyncDeleteGlobalVmExtensionPolicy( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + DeleteGlobalVmExtensionPolicyRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + DeleteGlobalVmExtensionPolicyRequest const& request) { + return child_->AsyncDeleteGlobalVmExtensionPolicy( + cq, std::move(rest_context), std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +StatusOr +GlobalVmExtensionPoliciesRestLogging::DeleteGlobalVmExtensionPolicy( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + DeleteGlobalVmExtensionPolicyRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + DeleteGlobalVmExtensionPolicyRequest const& request) { + return child_->DeleteGlobalVmExtensionPolicy(rest_context, options, + request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +StatusOr +GlobalVmExtensionPoliciesRestLogging::GetGlobalVmExtensionPolicy( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + GetGlobalVmExtensionPolicyRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + GetGlobalVmExtensionPolicyRequest const& request) { + return child_->GetGlobalVmExtensionPolicy(rest_context, options, + request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +future> +GlobalVmExtensionPoliciesRestLogging::AsyncInsertGlobalVmExtensionPolicy( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + InsertGlobalVmExtensionPolicyRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + InsertGlobalVmExtensionPolicyRequest const& request) { + return child_->AsyncInsertGlobalVmExtensionPolicy( + cq, std::move(rest_context), std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +StatusOr +GlobalVmExtensionPoliciesRestLogging::InsertGlobalVmExtensionPolicy( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + InsertGlobalVmExtensionPolicyRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + InsertGlobalVmExtensionPolicyRequest const& request) { + return child_->InsertGlobalVmExtensionPolicy(rest_context, options, + request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +StatusOr +GlobalVmExtensionPoliciesRestLogging::ListGlobalVmExtensionPolicies( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + ListGlobalVmExtensionPoliciesRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + ListGlobalVmExtensionPoliciesRequest const& request) { + return child_->ListGlobalVmExtensionPolicies(rest_context, options, + request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +future> +GlobalVmExtensionPoliciesRestLogging::AsyncUpdateGlobalVmExtensionPolicy( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + UpdateGlobalVmExtensionPolicyRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + UpdateGlobalVmExtensionPolicyRequest const& request) { + return child_->AsyncUpdateGlobalVmExtensionPolicy( + cq, std::move(rest_context), std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +StatusOr +GlobalVmExtensionPoliciesRestLogging::UpdateGlobalVmExtensionPolicy( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + UpdateGlobalVmExtensionPolicyRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + UpdateGlobalVmExtensionPolicyRequest const& request) { + return child_->UpdateGlobalVmExtensionPolicy(rest_context, options, + request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +future> +GlobalVmExtensionPoliciesRestLogging::AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) { + return child_->AsyncGetOperation(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +future GlobalVmExtensionPoliciesRestLogging::AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) { + return child_->AsyncCancelOperation(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_global_vm_extension_policies_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_rest_logging_decorator.h b/google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_rest_logging_decorator.h new file mode 100644 index 0000000000000..26acfd2c7bf14 --- /dev/null +++ b/google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_rest_logging_decorator.h @@ -0,0 +1,141 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_GLOBAL_VM_EXTENSION_POLICIES_V1_INTERNAL_GLOBAL_VM_EXTENSION_POLICIES_REST_LOGGING_DECORATOR_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_GLOBAL_VM_EXTENSION_POLICIES_V1_INTERNAL_GLOBAL_VM_EXTENSION_POLICIES_REST_LOGGING_DECORATOR_H + +#include "google/cloud/compute/global_operations/v1/global_operations.pb.h" +#include "google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies.pb.h" +#include "google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_rest_stub.h" +#include "google/cloud/future.h" +#include "google/cloud/internal/rest_context.h" +#include "google/cloud/tracing_options.h" +#include "google/cloud/version.h" +#include +#include +#include + +namespace google { +namespace cloud { +namespace compute_global_vm_extension_policies_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class GlobalVmExtensionPoliciesRestLogging + : public GlobalVmExtensionPoliciesRestStub { + public: + ~GlobalVmExtensionPoliciesRestLogging() override = default; + GlobalVmExtensionPoliciesRestLogging( + std::shared_ptr child, + TracingOptions tracing_options, std::set components); + + StatusOr< + google::cloud::cpp::compute::v1::VmExtensionPolicyAggregatedListResponse> + AggregatedListGlobalVmExtensionPolicies( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + AggregatedListGlobalVmExtensionPoliciesRequest const& request) + override; + + future> + AsyncDeleteGlobalVmExtensionPolicy( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + DeleteGlobalVmExtensionPolicyRequest const& request) override; + + StatusOr + DeleteGlobalVmExtensionPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + DeleteGlobalVmExtensionPolicyRequest const& request) override; + + StatusOr + GetGlobalVmExtensionPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + GetGlobalVmExtensionPolicyRequest const& request) override; + + future> + AsyncInsertGlobalVmExtensionPolicy( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + InsertGlobalVmExtensionPolicyRequest const& request) override; + + StatusOr + InsertGlobalVmExtensionPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + InsertGlobalVmExtensionPolicyRequest const& request) override; + + StatusOr + ListGlobalVmExtensionPolicies( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + ListGlobalVmExtensionPoliciesRequest const& request) override; + + future> + AsyncUpdateGlobalVmExtensionPolicy( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + UpdateGlobalVmExtensionPolicyRequest const& request) override; + + StatusOr + UpdateGlobalVmExtensionPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + UpdateGlobalVmExtensionPolicyRequest const& request) override; + + future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) override; + + future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) override; + + private: + std::shared_ptr child_; + TracingOptions tracing_options_; + std::set components_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_global_vm_extension_policies_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_GLOBAL_VM_EXTENSION_POLICIES_V1_INTERNAL_GLOBAL_VM_EXTENSION_POLICIES_REST_LOGGING_DECORATOR_H diff --git a/google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_rest_metadata_decorator.cc b/google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_rest_metadata_decorator.cc new file mode 100644 index 0000000000000..a275bbe75743b --- /dev/null +++ b/google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_rest_metadata_decorator.cc @@ -0,0 +1,168 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies.proto + +#include "google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_rest_metadata_decorator.h" +#include "google/cloud/internal/api_client_header.h" +#include "google/cloud/internal/rest_set_metadata.h" +#include "google/cloud/status_or.h" +#include "absl/strings/str_cat.h" +#include "absl/strings/str_format.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_global_vm_extension_policies_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +GlobalVmExtensionPoliciesRestMetadata::GlobalVmExtensionPoliciesRestMetadata( + std::shared_ptr child, + std::string api_client_header) + : child_(std::move(child)), + api_client_header_( + api_client_header.empty() + ? google::cloud::internal::GeneratedLibClientHeader() + : std::move(api_client_header)) {} + +StatusOr< + google::cloud::cpp::compute::v1::VmExtensionPolicyAggregatedListResponse> +GlobalVmExtensionPoliciesRestMetadata::AggregatedListGlobalVmExtensionPolicies( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + AggregatedListGlobalVmExtensionPoliciesRequest const& request) { + SetMetadata(rest_context, options); + return child_->AggregatedListGlobalVmExtensionPolicies(rest_context, options, + request); +} + +future> +GlobalVmExtensionPoliciesRestMetadata::AsyncDeleteGlobalVmExtensionPolicy( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + DeleteGlobalVmExtensionPolicyRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncDeleteGlobalVmExtensionPolicy( + cq, std::move(rest_context), std::move(options), request); +} + +StatusOr +GlobalVmExtensionPoliciesRestMetadata::DeleteGlobalVmExtensionPolicy( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + DeleteGlobalVmExtensionPolicyRequest const& request) { + SetMetadata(rest_context, options); + return child_->DeleteGlobalVmExtensionPolicy(rest_context, options, request); +} + +StatusOr +GlobalVmExtensionPoliciesRestMetadata::GetGlobalVmExtensionPolicy( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + GetGlobalVmExtensionPolicyRequest const& request) { + SetMetadata(rest_context, options); + return child_->GetGlobalVmExtensionPolicy(rest_context, options, request); +} + +future> +GlobalVmExtensionPoliciesRestMetadata::AsyncInsertGlobalVmExtensionPolicy( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + InsertGlobalVmExtensionPolicyRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncInsertGlobalVmExtensionPolicy( + cq, std::move(rest_context), std::move(options), request); +} + +StatusOr +GlobalVmExtensionPoliciesRestMetadata::InsertGlobalVmExtensionPolicy( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + InsertGlobalVmExtensionPolicyRequest const& request) { + SetMetadata(rest_context, options); + return child_->InsertGlobalVmExtensionPolicy(rest_context, options, request); +} + +StatusOr +GlobalVmExtensionPoliciesRestMetadata::ListGlobalVmExtensionPolicies( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + ListGlobalVmExtensionPoliciesRequest const& request) { + SetMetadata(rest_context, options); + return child_->ListGlobalVmExtensionPolicies(rest_context, options, request); +} + +future> +GlobalVmExtensionPoliciesRestMetadata::AsyncUpdateGlobalVmExtensionPolicy( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + UpdateGlobalVmExtensionPolicyRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncUpdateGlobalVmExtensionPolicy( + cq, std::move(rest_context), std::move(options), request); +} + +StatusOr +GlobalVmExtensionPoliciesRestMetadata::UpdateGlobalVmExtensionPolicy( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + UpdateGlobalVmExtensionPolicyRequest const& request) { + SetMetadata(rest_context, options); + return child_->UpdateGlobalVmExtensionPolicy(rest_context, options, request); +} + +future> +GlobalVmExtensionPoliciesRestMetadata::AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncGetOperation(cq, std::move(rest_context), + std::move(options), request); +} + +future GlobalVmExtensionPoliciesRestMetadata::AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncCancelOperation(cq, std::move(rest_context), + std::move(options), request); +} + +void GlobalVmExtensionPoliciesRestMetadata::SetMetadata( + rest_internal::RestContext& rest_context, Options const& options, + std::vector const& params) { + google::cloud::rest_internal::SetMetadata(rest_context, options, params, + api_client_header_); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_global_vm_extension_policies_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_rest_metadata_decorator.h b/google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_rest_metadata_decorator.h new file mode 100644 index 0000000000000..0f507ca0afc3f --- /dev/null +++ b/google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_rest_metadata_decorator.h @@ -0,0 +1,142 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_GLOBAL_VM_EXTENSION_POLICIES_V1_INTERNAL_GLOBAL_VM_EXTENSION_POLICIES_REST_METADATA_DECORATOR_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_GLOBAL_VM_EXTENSION_POLICIES_V1_INTERNAL_GLOBAL_VM_EXTENSION_POLICIES_REST_METADATA_DECORATOR_H + +#include "google/cloud/compute/global_operations/v1/global_operations.pb.h" +#include "google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies.pb.h" +#include "google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_rest_stub.h" +#include "google/cloud/future.h" +#include "google/cloud/rest_options.h" +#include "google/cloud/version.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_global_vm_extension_policies_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class GlobalVmExtensionPoliciesRestMetadata + : public GlobalVmExtensionPoliciesRestStub { + public: + ~GlobalVmExtensionPoliciesRestMetadata() override = default; + explicit GlobalVmExtensionPoliciesRestMetadata( + std::shared_ptr child, + std::string api_client_header = ""); + + StatusOr< + google::cloud::cpp::compute::v1::VmExtensionPolicyAggregatedListResponse> + AggregatedListGlobalVmExtensionPolicies( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + AggregatedListGlobalVmExtensionPoliciesRequest const& request) + override; + + google::cloud::future> + AsyncDeleteGlobalVmExtensionPolicy( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + DeleteGlobalVmExtensionPolicyRequest const& request) override; + + StatusOr + DeleteGlobalVmExtensionPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + DeleteGlobalVmExtensionPolicyRequest const& request) override; + + StatusOr + GetGlobalVmExtensionPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + GetGlobalVmExtensionPolicyRequest const& request) override; + + google::cloud::future> + AsyncInsertGlobalVmExtensionPolicy( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + InsertGlobalVmExtensionPolicyRequest const& request) override; + + StatusOr + InsertGlobalVmExtensionPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + InsertGlobalVmExtensionPolicyRequest const& request) override; + + StatusOr + ListGlobalVmExtensionPolicies( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + ListGlobalVmExtensionPoliciesRequest const& request) override; + + google::cloud::future> + AsyncUpdateGlobalVmExtensionPolicy( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + UpdateGlobalVmExtensionPolicyRequest const& request) override; + + StatusOr + UpdateGlobalVmExtensionPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + UpdateGlobalVmExtensionPolicyRequest const& request) override; + + google::cloud::future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) override; + + google::cloud::future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) override; + + private: + void SetMetadata(rest_internal::RestContext& rest_context, + Options const& options, + std::vector const& params = {}); + + std::shared_ptr child_; + std::string api_client_header_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_global_vm_extension_policies_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_GLOBAL_VM_EXTENSION_POLICIES_V1_INTERNAL_GLOBAL_VM_EXTENSION_POLICIES_REST_METADATA_DECORATOR_H diff --git a/google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_rest_stub.cc b/google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_rest_stub.cc new file mode 100644 index 0000000000000..7414583d2e511 --- /dev/null +++ b/google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_rest_stub.cc @@ -0,0 +1,370 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies.proto + +#include "google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_rest_stub.h" +#include "google/cloud/compute/global_operations/v1/global_operations.pb.h" +#include "google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies.pb.h" +#include "google/cloud/common_options.h" +#include "google/cloud/internal/rest_stub_helpers.h" +#include "google/cloud/status_or.h" +#include "absl/strings/str_cat.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_global_vm_extension_policies_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +DefaultGlobalVmExtensionPoliciesRestStub:: + DefaultGlobalVmExtensionPoliciesRestStub(Options options) + : service_(rest_internal::MakePooledRestClient( + options.get(), options)), + operations_(rest_internal::MakePooledRestClient( + options.get(), options)), + options_(std::move(options)) {} + +DefaultGlobalVmExtensionPoliciesRestStub:: + DefaultGlobalVmExtensionPoliciesRestStub( + std::shared_ptr service, + std::shared_ptr operations, Options options) + : service_(std::move(service)), + operations_(std::move(operations)), + options_(std::move(options)) {} + +StatusOr< + google::cloud::cpp::compute::v1::VmExtensionPolicyAggregatedListResponse> +DefaultGlobalVmExtensionPoliciesRestStub:: + AggregatedListGlobalVmExtensionPolicies( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + AggregatedListGlobalVmExtensionPoliciesRequest const& request) { + std::vector> query_params; + query_params.push_back({"filter", request.filter()}); + query_params.push_back( + {"include_all_scopes", (request.include_all_scopes() ? "1" : "0")}); + query_params.push_back( + {"max_results", std::to_string(request.max_results())}); + query_params.push_back({"order_by", request.order_by()}); + query_params.push_back({"page_token", request.page_token()}); + query_params.push_back({"return_partial_success", + (request.return_partial_success() ? "1" : "0")}); + query_params.push_back( + {"service_project_number", request.service_project_number()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Get< + google::cloud::cpp::compute::v1::VmExtensionPolicyAggregatedListResponse>( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "aggregated", "/", + "vmExtensionPolicies"), + std::move(query_params)); +} + +future> +DefaultGlobalVmExtensionPoliciesRestStub::AsyncDeleteGlobalVmExtensionPolicy( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + DeleteGlobalVmExtensionPolicyRequest const& request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto service, auto request, auto rest_context, auto options) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + p.set_value(rest_internal::Post< + google::cloud::cpp::compute::v1::Operation>( + *service, *rest_context, + request + .global_vm_extension_policy_rollout_operation_rollout_input_resource(), + false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", *options), + "/", "projects", "/", request.project(), "/", "global", + "/", "vmExtensionPolicies", "/", + request.global_vm_extension_policy(), "/", "delete"), + std::move(query_params))); + }, + std::move(p), + service_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +StatusOr +DefaultGlobalVmExtensionPoliciesRestStub::DeleteGlobalVmExtensionPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + DeleteGlobalVmExtensionPolicyRequest const& request) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Post( + *service_, rest_context, + request + .global_vm_extension_policy_rollout_operation_rollout_input_resource(), + false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "global", "/", + "vmExtensionPolicies", "/", + request.global_vm_extension_policy(), "/", "delete"), + std::move(query_params)); +} + +StatusOr +DefaultGlobalVmExtensionPoliciesRestStub::GetGlobalVmExtensionPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + GetGlobalVmExtensionPolicyRequest const& request) { + std::vector> query_params; + return rest_internal::Get< + google::cloud::cpp::compute::v1::GlobalVmExtensionPolicy>( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "global", "/", + "vmExtensionPolicies", "/", + request.global_vm_extension_policy()), + std::move(query_params)); +} + +future> +DefaultGlobalVmExtensionPoliciesRestStub::AsyncInsertGlobalVmExtensionPolicy( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + InsertGlobalVmExtensionPolicyRequest const& request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto service, auto request, auto rest_context, auto options) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + p.set_value( + rest_internal::Post( + *service, *rest_context, + request.global_vm_extension_policy_resource(), false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", *options), + "/", "projects", "/", request.project(), "/", + "global", "/", "vmExtensionPolicies"), + std::move(query_params))); + }, + std::move(p), + service_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +StatusOr +DefaultGlobalVmExtensionPoliciesRestStub::InsertGlobalVmExtensionPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + InsertGlobalVmExtensionPolicyRequest const& request) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Post( + *service_, rest_context, request.global_vm_extension_policy_resource(), + false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "global", "/", + "vmExtensionPolicies"), + std::move(query_params)); +} + +StatusOr +DefaultGlobalVmExtensionPoliciesRestStub::ListGlobalVmExtensionPolicies( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + ListGlobalVmExtensionPoliciesRequest const& request) { + std::vector> query_params; + query_params.push_back({"filter", request.filter()}); + query_params.push_back( + {"max_results", std::to_string(request.max_results())}); + query_params.push_back({"order_by", request.order_by()}); + query_params.push_back({"page_token", request.page_token()}); + query_params.push_back({"return_partial_success", + (request.return_partial_success() ? "1" : "0")}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Get< + google::cloud::cpp::compute::v1::GlobalVmExtensionPolicyList>( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "global", "/", + "vmExtensionPolicies"), + std::move(query_params)); +} + +future> +DefaultGlobalVmExtensionPoliciesRestStub::AsyncUpdateGlobalVmExtensionPolicy( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + UpdateGlobalVmExtensionPolicyRequest const& request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto service, auto request, auto rest_context, auto options) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + p.set_value( + rest_internal::Patch( + *service, *rest_context, + request.global_vm_extension_policy_resource(), false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", *options), + "/", "projects", "/", request.project(), "/", + "global", "/", "vmExtensionPolicies", "/", + request.global_vm_extension_policy()), + std::move(query_params))); + }, + std::move(p), + service_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +StatusOr +DefaultGlobalVmExtensionPoliciesRestStub::UpdateGlobalVmExtensionPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + UpdateGlobalVmExtensionPolicyRequest const& request) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Patch( + *service_, rest_context, request.global_vm_extension_policy_resource(), + false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "global", "/", + "vmExtensionPolicies", "/", + request.global_vm_extension_policy()), + std::move(query_params)); +} + +future> +DefaultGlobalVmExtensionPoliciesRestStub::AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto operations, auto request, auto rest_context, + auto options) { + p.set_value( + rest_internal::Get( + *operations, *rest_context, request, false, + absl::StrCat("/compute/", + rest_internal::DetermineApiVersion("v1", *options), + "/projects/", request.project(), + "/global/operations/", request.operation()))); + }, + std::move(p), + operations_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +future DefaultGlobalVmExtensionPoliciesRestStub::AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) { + promise> p; + future> f = p.get_future(); + std::thread t{ + [](auto p, auto operations, auto request, auto rest_context, + auto options) { + p.set_value(rest_internal::Post( + *operations, *rest_context, request, false, + absl::StrCat("/compute/", + rest_internal::DetermineApiVersion("v1", *options), + "/projects/", request.project(), "/global/operations/", + request.operation()))); + }, + std::move(p), + operations_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get().status(); + }); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_global_vm_extension_policies_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_rest_stub.h b/google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_rest_stub.h new file mode 100644 index 0000000000000..9c8a5feea536e --- /dev/null +++ b/google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_rest_stub.h @@ -0,0 +1,228 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_GLOBAL_VM_EXTENSION_POLICIES_V1_INTERNAL_GLOBAL_VM_EXTENSION_POLICIES_REST_STUB_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_GLOBAL_VM_EXTENSION_POLICIES_V1_INTERNAL_GLOBAL_VM_EXTENSION_POLICIES_REST_STUB_H + +#include "google/cloud/compute/global_operations/v1/global_operations.pb.h" +#include "google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies.pb.h" +#include "google/cloud/completion_queue.h" +#include "google/cloud/internal/rest_client.h" +#include "google/cloud/internal/rest_context.h" +#include "google/cloud/status_or.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_global_vm_extension_policies_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class GlobalVmExtensionPoliciesRestStub { + public: + virtual ~GlobalVmExtensionPoliciesRestStub() = default; + + virtual StatusOr< + google::cloud::cpp::compute::v1::VmExtensionPolicyAggregatedListResponse> + AggregatedListGlobalVmExtensionPolicies( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + AggregatedListGlobalVmExtensionPoliciesRequest const& request) = 0; + + virtual future> + AsyncDeleteGlobalVmExtensionPolicy( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + DeleteGlobalVmExtensionPolicyRequest const& request) = 0; + + virtual StatusOr + DeleteGlobalVmExtensionPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + DeleteGlobalVmExtensionPolicyRequest const& request) = 0; + + virtual StatusOr + GetGlobalVmExtensionPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + GetGlobalVmExtensionPolicyRequest const& request) = 0; + + virtual future> + AsyncInsertGlobalVmExtensionPolicy( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + InsertGlobalVmExtensionPolicyRequest const& request) = 0; + + virtual StatusOr + InsertGlobalVmExtensionPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + InsertGlobalVmExtensionPolicyRequest const& request) = 0; + + virtual StatusOr + ListGlobalVmExtensionPolicies( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + ListGlobalVmExtensionPoliciesRequest const& request) = 0; + + virtual future> + AsyncUpdateGlobalVmExtensionPolicy( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + UpdateGlobalVmExtensionPolicyRequest const& request) = 0; + + virtual StatusOr + UpdateGlobalVmExtensionPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + UpdateGlobalVmExtensionPolicyRequest const& request) = 0; + + virtual future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) = 0; + + virtual future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) = 0; +}; + +class DefaultGlobalVmExtensionPoliciesRestStub + : public GlobalVmExtensionPoliciesRestStub { + public: + ~DefaultGlobalVmExtensionPoliciesRestStub() override = default; + + explicit DefaultGlobalVmExtensionPoliciesRestStub(Options options); + DefaultGlobalVmExtensionPoliciesRestStub( + std::shared_ptr service, + std::shared_ptr operations, Options options); + + StatusOr< + google::cloud::cpp::compute::v1::VmExtensionPolicyAggregatedListResponse> + AggregatedListGlobalVmExtensionPolicies( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + AggregatedListGlobalVmExtensionPoliciesRequest const& request) + override; + + future> + AsyncDeleteGlobalVmExtensionPolicy( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + DeleteGlobalVmExtensionPolicyRequest const& request) override; + + StatusOr + DeleteGlobalVmExtensionPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + DeleteGlobalVmExtensionPolicyRequest const& request) override; + + StatusOr + GetGlobalVmExtensionPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + GetGlobalVmExtensionPolicyRequest const& request) override; + + future> + AsyncInsertGlobalVmExtensionPolicy( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + InsertGlobalVmExtensionPolicyRequest const& request) override; + + StatusOr + InsertGlobalVmExtensionPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + InsertGlobalVmExtensionPolicyRequest const& request) override; + + StatusOr + ListGlobalVmExtensionPolicies( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + ListGlobalVmExtensionPoliciesRequest const& request) override; + + future> + AsyncUpdateGlobalVmExtensionPolicy( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + UpdateGlobalVmExtensionPolicyRequest const& request) override; + + StatusOr + UpdateGlobalVmExtensionPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + UpdateGlobalVmExtensionPolicyRequest const& request) override; + + future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) override; + + future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) override; + + private: + std::shared_ptr service_; + std::shared_ptr operations_; + Options options_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_global_vm_extension_policies_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_GLOBAL_VM_EXTENSION_POLICIES_V1_INTERNAL_GLOBAL_VM_EXTENSION_POLICIES_REST_STUB_H diff --git a/google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_rest_stub_factory.cc b/google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_rest_stub_factory.cc new file mode 100644 index 0000000000000..c661ac277a503 --- /dev/null +++ b/google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_rest_stub_factory.cc @@ -0,0 +1,59 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies.proto + +#include "google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_rest_stub_factory.h" +#include "google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_rest_logging_decorator.h" +#include "google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_rest_metadata_decorator.h" +#include "google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_rest_stub.h" +#include "google/cloud/common_options.h" +#include "google/cloud/internal/algorithm.h" +#include "google/cloud/internal/populate_rest_options.h" +#include "google/cloud/log.h" +#include "google/cloud/options.h" +#include "google/cloud/rest_options.h" +#include "absl/strings/match.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_global_vm_extension_policies_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +std::shared_ptr +CreateDefaultGlobalVmExtensionPoliciesRestStub(Options const& options) { + auto opts = internal::PopulateRestOptions(options); + std::shared_ptr stub = + std::make_shared( + std::move(opts)); + stub = + std::make_shared(std::move(stub)); + if (internal::Contains(options.get(), "rpc")) { + GCP_LOG(INFO) << "Enabled logging for REST rpc calls"; + stub = std::make_shared( + std::move(stub), options.get(), + options.get()); + } + return stub; +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_global_vm_extension_policies_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_rest_stub_factory.h b/google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_rest_stub_factory.h new file mode 100644 index 0000000000000..747bf61ca1a19 --- /dev/null +++ b/google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_rest_stub_factory.h @@ -0,0 +1,41 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_GLOBAL_VM_EXTENSION_POLICIES_V1_INTERNAL_GLOBAL_VM_EXTENSION_POLICIES_REST_STUB_FACTORY_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_GLOBAL_VM_EXTENSION_POLICIES_V1_INTERNAL_GLOBAL_VM_EXTENSION_POLICIES_REST_STUB_FACTORY_H + +#include "google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_rest_stub.h" +#include "google/cloud/options.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_global_vm_extension_policies_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +std::shared_ptr +CreateDefaultGlobalVmExtensionPoliciesRestStub(Options const& options); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_global_vm_extension_policies_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_GLOBAL_VM_EXTENSION_POLICIES_V1_INTERNAL_GLOBAL_VM_EXTENSION_POLICIES_REST_STUB_FACTORY_H diff --git a/google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_retry_traits.h b/google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_retry_traits.h new file mode 100644 index 0000000000000..bfac68935aee4 --- /dev/null +++ b/google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_retry_traits.h @@ -0,0 +1,44 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_GLOBAL_VM_EXTENSION_POLICIES_V1_INTERNAL_GLOBAL_VM_EXTENSION_POLICIES_RETRY_TRAITS_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_GLOBAL_VM_EXTENSION_POLICIES_V1_INTERNAL_GLOBAL_VM_EXTENSION_POLICIES_RETRY_TRAITS_H + +#include "google/cloud/status.h" +#include "google/cloud/version.h" + +namespace google { +namespace cloud { +namespace compute_global_vm_extension_policies_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/// Define the gRPC status code semantics for retrying requests. +struct GlobalVmExtensionPoliciesRetryTraits { + static bool IsPermanentFailure(google::cloud::Status const& status) { + return status.code() != StatusCode::kOk && + status.code() != StatusCode::kUnavailable; + } +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_global_vm_extension_policies_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_GLOBAL_VM_EXTENSION_POLICIES_V1_INTERNAL_GLOBAL_VM_EXTENSION_POLICIES_RETRY_TRAITS_H diff --git a/google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_sources.cc b/google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_sources.cc new file mode 100644 index 0000000000000..cc1617a5f7cd3 --- /dev/null +++ b/google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_sources.cc @@ -0,0 +1,32 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies.proto + +// NOLINTBEGIN(bugprone-suspicious-include) +#include "google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies_client.cc" +#include "google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies_connection.cc" +#include "google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies_connection_idempotency_policy.cc" +#include "google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies_rest_connection.cc" +#include "google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_option_defaults.cc" +#include "google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_rest_connection_impl.cc" +#include "google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_rest_logging_decorator.cc" +#include "google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_rest_metadata_decorator.cc" +#include "google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_rest_stub.cc" +#include "google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_rest_stub_factory.cc" +#include "google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_tracing_connection.cc" +// NOLINTEND(bugprone-suspicious-include) diff --git a/google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_tracing_connection.cc b/google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_tracing_connection.cc new file mode 100644 index 0000000000000..2b3e7750de011 --- /dev/null +++ b/google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_tracing_connection.cc @@ -0,0 +1,203 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies.proto + +#include "google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_tracing_connection.h" +#include "google/cloud/internal/opentelemetry.h" +#include "google/cloud/internal/traced_stream_range.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_global_vm_extension_policies_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +GlobalVmExtensionPoliciesTracingConnection:: + GlobalVmExtensionPoliciesTracingConnection( + std::shared_ptr + child) + : child_(std::move(child)) {} + +StreamRange< + std::pair> +GlobalVmExtensionPoliciesTracingConnection:: + AggregatedListGlobalVmExtensionPolicies( + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + AggregatedListGlobalVmExtensionPoliciesRequest request) { + auto span = internal::MakeSpan( + "compute_global_vm_extension_policies_v1::" + "GlobalVmExtensionPoliciesConnection::" + "AggregatedListGlobalVmExtensionPolicies"); + internal::OTelScope scope(span); + auto sr = child_->AggregatedListGlobalVmExtensionPolicies(std::move(request)); + return internal::MakeTracedStreamRange>( + std::move(span), std::move(sr)); +} + +future> +GlobalVmExtensionPoliciesTracingConnection::DeleteGlobalVmExtensionPolicy( + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + DeleteGlobalVmExtensionPolicyRequest const& request) { + auto span = internal::MakeSpan( + "compute_global_vm_extension_policies_v1::" + "GlobalVmExtensionPoliciesConnection::DeleteGlobalVmExtensionPolicy"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), + child_->DeleteGlobalVmExtensionPolicy(request)); +} + +StatusOr +GlobalVmExtensionPoliciesTracingConnection::DeleteGlobalVmExtensionPolicy( + NoAwaitTag, google::cloud::cpp::compute::global_vm_extension_policies::v1:: + DeleteGlobalVmExtensionPolicyRequest const& request) { + auto span = internal::MakeSpan( + "compute_global_vm_extension_policies_v1::" + "GlobalVmExtensionPoliciesConnection::DeleteGlobalVmExtensionPolicy"); + opentelemetry::trace::Scope scope(span); + return internal::EndSpan( + *span, child_->DeleteGlobalVmExtensionPolicy(NoAwaitTag{}, request)); +} + +future> +GlobalVmExtensionPoliciesTracingConnection::DeleteGlobalVmExtensionPolicy( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto span = internal::MakeSpan( + "compute_global_vm_extension_policies_v1::" + "GlobalVmExtensionPoliciesConnection::DeleteGlobalVmExtensionPolicy"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), + child_->DeleteGlobalVmExtensionPolicy(operation)); +} + +StatusOr +GlobalVmExtensionPoliciesTracingConnection::GetGlobalVmExtensionPolicy( + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + GetGlobalVmExtensionPolicyRequest const& request) { + auto span = internal::MakeSpan( + "compute_global_vm_extension_policies_v1::" + "GlobalVmExtensionPoliciesConnection::GetGlobalVmExtensionPolicy"); + auto scope = opentelemetry::trace::Scope(span); + return internal::EndSpan(*span, child_->GetGlobalVmExtensionPolicy(request)); +} + +future> +GlobalVmExtensionPoliciesTracingConnection::InsertGlobalVmExtensionPolicy( + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + InsertGlobalVmExtensionPolicyRequest const& request) { + auto span = internal::MakeSpan( + "compute_global_vm_extension_policies_v1::" + "GlobalVmExtensionPoliciesConnection::InsertGlobalVmExtensionPolicy"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), + child_->InsertGlobalVmExtensionPolicy(request)); +} + +StatusOr +GlobalVmExtensionPoliciesTracingConnection::InsertGlobalVmExtensionPolicy( + NoAwaitTag, google::cloud::cpp::compute::global_vm_extension_policies::v1:: + InsertGlobalVmExtensionPolicyRequest const& request) { + auto span = internal::MakeSpan( + "compute_global_vm_extension_policies_v1::" + "GlobalVmExtensionPoliciesConnection::InsertGlobalVmExtensionPolicy"); + opentelemetry::trace::Scope scope(span); + return internal::EndSpan( + *span, child_->InsertGlobalVmExtensionPolicy(NoAwaitTag{}, request)); +} + +future> +GlobalVmExtensionPoliciesTracingConnection::InsertGlobalVmExtensionPolicy( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto span = internal::MakeSpan( + "compute_global_vm_extension_policies_v1::" + "GlobalVmExtensionPoliciesConnection::InsertGlobalVmExtensionPolicy"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), + child_->InsertGlobalVmExtensionPolicy(operation)); +} + +StreamRange +GlobalVmExtensionPoliciesTracingConnection::ListGlobalVmExtensionPolicies( + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + ListGlobalVmExtensionPoliciesRequest request) { + auto span = internal::MakeSpan( + "compute_global_vm_extension_policies_v1::" + "GlobalVmExtensionPoliciesConnection::ListGlobalVmExtensionPolicies"); + internal::OTelScope scope(span); + auto sr = child_->ListGlobalVmExtensionPolicies(std::move(request)); + return internal::MakeTracedStreamRange< + google::cloud::cpp::compute::v1::GlobalVmExtensionPolicy>(std::move(span), + std::move(sr)); +} + +future> +GlobalVmExtensionPoliciesTracingConnection::UpdateGlobalVmExtensionPolicy( + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + UpdateGlobalVmExtensionPolicyRequest const& request) { + auto span = internal::MakeSpan( + "compute_global_vm_extension_policies_v1::" + "GlobalVmExtensionPoliciesConnection::UpdateGlobalVmExtensionPolicy"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), + child_->UpdateGlobalVmExtensionPolicy(request)); +} + +StatusOr +GlobalVmExtensionPoliciesTracingConnection::UpdateGlobalVmExtensionPolicy( + NoAwaitTag, google::cloud::cpp::compute::global_vm_extension_policies::v1:: + UpdateGlobalVmExtensionPolicyRequest const& request) { + auto span = internal::MakeSpan( + "compute_global_vm_extension_policies_v1::" + "GlobalVmExtensionPoliciesConnection::UpdateGlobalVmExtensionPolicy"); + opentelemetry::trace::Scope scope(span); + return internal::EndSpan( + *span, child_->UpdateGlobalVmExtensionPolicy(NoAwaitTag{}, request)); +} + +future> +GlobalVmExtensionPoliciesTracingConnection::UpdateGlobalVmExtensionPolicy( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto span = internal::MakeSpan( + "compute_global_vm_extension_policies_v1::" + "GlobalVmExtensionPoliciesConnection::UpdateGlobalVmExtensionPolicy"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), + child_->UpdateGlobalVmExtensionPolicy(operation)); +} + +std::shared_ptr +MakeGlobalVmExtensionPoliciesTracingConnection( + std::shared_ptr + conn) { + if (internal::TracingEnabled(conn->options())) { + conn = std::make_shared( + std::move(conn)); + } + return conn; +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_global_vm_extension_policies_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_tracing_connection.h b/google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_tracing_connection.h new file mode 100644 index 0000000000000..ccb58d229efe9 --- /dev/null +++ b/google/cloud/compute/global_vm_extension_policies/v1/internal/global_vm_extension_policies_tracing_connection.h @@ -0,0 +1,131 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_GLOBAL_VM_EXTENSION_POLICIES_V1_INTERNAL_GLOBAL_VM_EXTENSION_POLICIES_TRACING_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_GLOBAL_VM_EXTENSION_POLICIES_V1_INTERNAL_GLOBAL_VM_EXTENSION_POLICIES_TRACING_CONNECTION_H + +#include "google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies_connection.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_global_vm_extension_policies_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class GlobalVmExtensionPoliciesTracingConnection + : public compute_global_vm_extension_policies_v1:: + GlobalVmExtensionPoliciesConnection { + public: + ~GlobalVmExtensionPoliciesTracingConnection() override = default; + + explicit GlobalVmExtensionPoliciesTracingConnection( + std::shared_ptr + child); + + Options options() override { return child_->options(); } + + StreamRange< + std::pair> + AggregatedListGlobalVmExtensionPolicies( + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + AggregatedListGlobalVmExtensionPoliciesRequest request) override; + + future> + DeleteGlobalVmExtensionPolicy( + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + DeleteGlobalVmExtensionPolicyRequest const& request) override; + + StatusOr + DeleteGlobalVmExtensionPolicy( + NoAwaitTag, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + DeleteGlobalVmExtensionPolicyRequest const& request) override; + + future> + DeleteGlobalVmExtensionPolicy( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + StatusOr + GetGlobalVmExtensionPolicy( + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + GetGlobalVmExtensionPolicyRequest const& request) override; + + future> + InsertGlobalVmExtensionPolicy( + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + InsertGlobalVmExtensionPolicyRequest const& request) override; + + StatusOr + InsertGlobalVmExtensionPolicy( + NoAwaitTag, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + InsertGlobalVmExtensionPolicyRequest const& request) override; + + future> + InsertGlobalVmExtensionPolicy( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + StreamRange + ListGlobalVmExtensionPolicies( + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + ListGlobalVmExtensionPoliciesRequest request) override; + + future> + UpdateGlobalVmExtensionPolicy( + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + UpdateGlobalVmExtensionPolicyRequest const& request) override; + + StatusOr + UpdateGlobalVmExtensionPolicy( + NoAwaitTag, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + UpdateGlobalVmExtensionPolicyRequest const& request) override; + + future> + UpdateGlobalVmExtensionPolicy( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + private: + std::shared_ptr + child_; +}; + +/** + * Conditionally applies the tracing decorator to the given connection. + * + * The connection is only decorated if tracing is enabled (as determined by the + * connection's options). + */ +std::shared_ptr +MakeGlobalVmExtensionPoliciesTracingConnection( + std::shared_ptr + conn); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_global_vm_extension_policies_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_GLOBAL_VM_EXTENSION_POLICIES_V1_INTERNAL_GLOBAL_VM_EXTENSION_POLICIES_TRACING_CONNECTION_H diff --git a/google/cloud/compute/global_vm_extension_policies/v1/mocks/mock_global_vm_extension_policies_connection.h b/google/cloud/compute/global_vm_extension_policies/v1/mocks/mock_global_vm_extension_policies_connection.h new file mode 100644 index 0000000000000..71f4cfa29bbb3 --- /dev/null +++ b/google/cloud/compute/global_vm_extension_policies/v1/mocks/mock_global_vm_extension_policies_connection.h @@ -0,0 +1,206 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_GLOBAL_VM_EXTENSION_POLICIES_V1_MOCKS_MOCK_GLOBAL_VM_EXTENSION_POLICIES_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_GLOBAL_VM_EXTENSION_POLICIES_V1_MOCKS_MOCK_GLOBAL_VM_EXTENSION_POLICIES_CONNECTION_H + +#include "google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies_connection.h" +#include + +namespace google { +namespace cloud { +namespace compute_global_vm_extension_policies_v1_mocks { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/** + * A class to mock `GlobalVmExtensionPoliciesConnection`. + * + * Application developers may want to test their code with simulated responses, + * including errors, from an object of type `GlobalVmExtensionPoliciesClient`. + * To do so, construct an object of type `GlobalVmExtensionPoliciesClient` with + * an instance of this class. Then use the Google Test framework functions to + * program the behavior of this mock. + * + * @see [This example][bq-mock] for how to test your application with GoogleTest. + * While the example showcases types from the BigQuery library, the underlying + * principles apply for any pair of `*Client` and `*Connection`. + * + * [bq-mock]: @cloud_cpp_docs_link{bigquery,bigquery-read-mock} + */ +class MockGlobalVmExtensionPoliciesConnection + : public compute_global_vm_extension_policies_v1:: + GlobalVmExtensionPoliciesConnection { + public: + MOCK_METHOD(Options, options, (), (override)); + + MOCK_METHOD( + (StreamRange>), + AggregatedListGlobalVmExtensionPolicies, + (google::cloud::cpp::compute::global_vm_extension_policies::v1:: + AggregatedListGlobalVmExtensionPoliciesRequest request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// DeleteGlobalVmExtensionPolicy(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + DeleteGlobalVmExtensionPolicy, + (google::cloud::cpp::compute::global_vm_extension_policies::v1:: + DeleteGlobalVmExtensionPolicyRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// EXPECT_CALL(*mock, DeleteGlobalVmExtensionPolicy(_, _)) + /// @endcode + MOCK_METHOD(StatusOr, + DeleteGlobalVmExtensionPolicy, + (NoAwaitTag, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + DeleteGlobalVmExtensionPolicyRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// DeleteGlobalVmExtensionPolicy(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + DeleteGlobalVmExtensionPolicy, + (google::cloud::cpp::compute::v1::Operation const& operation), + (override)); + + MOCK_METHOD( + StatusOr, + GetGlobalVmExtensionPolicy, + (google::cloud::cpp::compute::global_vm_extension_policies::v1:: + GetGlobalVmExtensionPolicyRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// InsertGlobalVmExtensionPolicy(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + InsertGlobalVmExtensionPolicy, + (google::cloud::cpp::compute::global_vm_extension_policies::v1:: + InsertGlobalVmExtensionPolicyRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// EXPECT_CALL(*mock, InsertGlobalVmExtensionPolicy(_, _)) + /// @endcode + MOCK_METHOD(StatusOr, + InsertGlobalVmExtensionPolicy, + (NoAwaitTag, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + InsertGlobalVmExtensionPolicyRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// InsertGlobalVmExtensionPolicy(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + InsertGlobalVmExtensionPolicy, + (google::cloud::cpp::compute::v1::Operation const& operation), + (override)); + + MOCK_METHOD( + (StreamRange), + ListGlobalVmExtensionPolicies, + (google::cloud::cpp::compute::global_vm_extension_policies::v1:: + ListGlobalVmExtensionPoliciesRequest request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// UpdateGlobalVmExtensionPolicy(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + UpdateGlobalVmExtensionPolicy, + (google::cloud::cpp::compute::global_vm_extension_policies::v1:: + UpdateGlobalVmExtensionPolicyRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// EXPECT_CALL(*mock, UpdateGlobalVmExtensionPolicy(_, _)) + /// @endcode + MOCK_METHOD(StatusOr, + UpdateGlobalVmExtensionPolicy, + (NoAwaitTag, + google::cloud::cpp::compute::global_vm_extension_policies::v1:: + UpdateGlobalVmExtensionPolicyRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// UpdateGlobalVmExtensionPolicy(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + UpdateGlobalVmExtensionPolicy, + (google::cloud::cpp::compute::v1::Operation const& operation), + (override)); +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_global_vm_extension_policies_v1_mocks +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_GLOBAL_VM_EXTENSION_POLICIES_V1_MOCKS_MOCK_GLOBAL_VM_EXTENSION_POLICIES_CONNECTION_H diff --git a/google/cloud/compute/global_vm_extension_policies/v1/samples/global_vm_extension_policies_client_samples.cc b/google/cloud/compute/global_vm_extension_policies/v1/samples/global_vm_extension_policies_client_samples.cc new file mode 100644 index 0000000000000..709957110fcea --- /dev/null +++ b/google/cloud/compute/global_vm_extension_policies/v1/samples/global_vm_extension_policies_client_samples.cc @@ -0,0 +1,244 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies.proto + +#include "google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies_client.h" +#include "google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies_connection_idempotency_policy.h" +#include "google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies_options.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/internal/getenv.h" +#include "google/cloud/polling_policy.h" +#include "google/cloud/testing_util/example_driver.h" +#include "google/cloud/universe_domain.h" +#include +#include +#include +#include + +// clang-format off +// main-dox-marker: compute_global_vm_extension_policies_v1::GlobalVmExtensionPoliciesClient +// lro-marker: true +// clang-format on +namespace { + +void SetClientEndpoint(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-endpoint"}; + } + //! [set-client-endpoint] + // This configuration is common with Private Google Access: + // https://cloud.google.com/vpc/docs/private-google-access + auto options = google::cloud::Options{}.set( + "private.googleapis.com"); + auto vpc_client = google::cloud::compute_global_vm_extension_policies_v1:: + GlobalVmExtensionPoliciesClient( + google::cloud::compute_global_vm_extension_policies_v1:: + MakeGlobalVmExtensionPoliciesConnectionRest(options)); + //! [set-client-endpoint] +} + +void SetClientUniverseDomain(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-universe-domain"}; + } + //! [set-client-universe-domain] + google::cloud::Options options; + + // AddUniverseDomainOption interrogates the UnifiedCredentialsOption, if set, + // in the provided Options for the Universe Domain associated with the + // credentials and adds it to the set of Options. + // If no UnifiedCredentialsOption is set, GoogleDefaultCredentials are used. + auto ud_options = google::cloud::AddUniverseDomainOption(std::move(options)); + + if (!ud_options.ok()) throw std::move(ud_options).status(); + auto ud_client = google::cloud::compute_global_vm_extension_policies_v1:: + GlobalVmExtensionPoliciesClient( + google::cloud::compute_global_vm_extension_policies_v1:: + MakeGlobalVmExtensionPoliciesConnectionRest(*ud_options)); + //! [set-client-universe-domain] +} + +//! [custom-idempotency-policy] +class CustomIdempotencyPolicy + : public google::cloud::compute_global_vm_extension_policies_v1:: + GlobalVmExtensionPoliciesConnectionIdempotencyPolicy { + public: + ~CustomIdempotencyPolicy() override = default; + std::unique_ptr + clone() const override { + return std::make_unique(*this); + } + // Override inherited functions to define as needed. +}; +//! [custom-idempotency-policy] + +void SetRetryPolicy(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-retry-policy"}; + } + //! [set-retry-policy] + auto options = + google::cloud::Options{} + .set( + CustomIdempotencyPolicy().clone()) + .set( + google::cloud::compute_global_vm_extension_policies_v1:: + GlobalVmExtensionPoliciesLimitedErrorCountRetryPolicy(3) + .clone()) + .set( + google::cloud::ExponentialBackoffPolicy( + /*initial_delay=*/std::chrono::milliseconds(200), + /*maximum_delay=*/std::chrono::seconds(45), + /*scaling=*/2.0) + .clone()); + auto connection = google::cloud::compute_global_vm_extension_policies_v1:: + MakeGlobalVmExtensionPoliciesConnectionRest(options); + + // c1 and c2 share the same retry policies + auto c1 = google::cloud::compute_global_vm_extension_policies_v1:: + GlobalVmExtensionPoliciesClient(connection); + auto c2 = google::cloud::compute_global_vm_extension_policies_v1:: + GlobalVmExtensionPoliciesClient(connection); + + // You can override any of the policies in a new client. This new client + // will share the policies from c1 (or c2) *except* for the retry policy. + auto c3 = google::cloud::compute_global_vm_extension_policies_v1:: + GlobalVmExtensionPoliciesClient( + connection, + google::cloud::Options{} + .set( + google::cloud::compute_global_vm_extension_policies_v1:: + GlobalVmExtensionPoliciesLimitedTimeRetryPolicy( + std::chrono::minutes(5)) + .clone())); + + // You can also override the policies in a single call: + // c3.SomeRpc(..., google::cloud::Options{} + // .set( + // google::cloud::compute_global_vm_extension_policies_v1::GlobalVmExtensionPoliciesLimitedErrorCountRetryPolicy(10).clone())); + //! [set-retry-policy] +} + +void SetPollingPolicy(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-policy-policy"}; + } + //! [set-polling-policy] + + // The polling policy controls how the client waits for long-running + // operations. `GenericPollingPolicy<>` combines existing policies. + // In this case, keep polling until the operation completes (with success + // or error) or 45 minutes, whichever happens first. Initially pause for + // 10 seconds between polling requests, increasing the pause by a factor + // of 4 until it becomes 2 minutes. + auto options = + google::cloud::Options{} + .set( + google::cloud::GenericPollingPolicy< + google::cloud::compute_global_vm_extension_policies_v1:: + GlobalVmExtensionPoliciesRetryPolicyOption::Type, + google::cloud::compute_global_vm_extension_policies_v1:: + GlobalVmExtensionPoliciesBackoffPolicyOption::Type>( + google::cloud::compute_global_vm_extension_policies_v1:: + GlobalVmExtensionPoliciesLimitedTimeRetryPolicy( + /*maximum_duration=*/std::chrono::minutes(45)) + .clone(), + google::cloud::ExponentialBackoffPolicy( + /*initial_delay=*/std::chrono::seconds(10), + /*maximum_delay=*/std::chrono::minutes(2), + /*scaling=*/4.0) + .clone()) + .clone()); + + auto connection = google::cloud::compute_global_vm_extension_policies_v1:: + MakeGlobalVmExtensionPoliciesConnectionRest(options); + + // c1 and c2 share the same polling policies. + auto c1 = google::cloud::compute_global_vm_extension_policies_v1:: + GlobalVmExtensionPoliciesClient(connection); + auto c2 = google::cloud::compute_global_vm_extension_policies_v1:: + GlobalVmExtensionPoliciesClient(connection); + //! [set-polling-policy] +} + +void WithServiceAccount(std::vector const& argv) { + if (argv.size() != 1 || argv[0] == "--help") { + throw google::cloud::testing_util::Usage{"with-service-account "}; + } + //! [with-service-account] + [](std::string const& keyfile) { + auto is = std::ifstream(keyfile); + is.exceptions(std::ios::badbit); // Minimal error handling in examples + auto contents = std::string(std::istreambuf_iterator(is.rdbuf()), {}); + auto options = + google::cloud::Options{}.set( + google::cloud::MakeServiceAccountCredentials(contents)); + return google::cloud::compute_global_vm_extension_policies_v1:: + GlobalVmExtensionPoliciesClient( + google::cloud::compute_global_vm_extension_policies_v1:: + MakeGlobalVmExtensionPoliciesConnectionRest(options)); + } + //! [with-service-account] + (argv.at(0)); +} + +void AutoRun(std::vector const& argv) { + namespace examples = ::google::cloud::testing_util; + using ::google::cloud::internal::GetEnv; + if (!argv.empty()) throw examples::Usage{"auto"}; + examples::CheckEnvironmentVariablesAreSet( + {"GOOGLE_CLOUD_CPP_TEST_SERVICE_ACCOUNT_KEYFILE"}); + auto const keyfile = + GetEnv("GOOGLE_CLOUD_CPP_TEST_SERVICE_ACCOUNT_KEYFILE").value(); + + std::cout << "\nRunning SetClientEndpoint() example" << std::endl; + SetClientEndpoint({}); + + std::cout << "\nRunning SetRetryPolicy() example" << std::endl; + SetRetryPolicy({}); + + std::cout << "\nRunning SetPollingPolicy() example" << std::endl; + SetPollingPolicy({}); + + std::cout << "\nRunning WithServiceAccount() example" << std::endl; + WithServiceAccount({keyfile}); + + std::cout << "\nRunning SetClientUniverseDomain() example" << std::endl; + SetClientUniverseDomain({}); +} + +} // namespace + +int main(int argc, char* argv[]) { // NOLINT(bugprone-exception-escape) + google::cloud::testing_util::Example example({ + {"set-client-endpoint", SetClientEndpoint}, + {"set-retry-policy", SetRetryPolicy}, + {"set-polling-policy", SetPollingPolicy}, + {"with-service-account", WithServiceAccount}, + {"set-client-universe-domain", SetClientUniverseDomain}, + {"auto", AutoRun}, + }); + return example.Run(argc, argv); +} diff --git a/google/cloud/compute/health_checks/v1/health_checks_client.cc b/google/cloud/compute/health_checks/v1/health_checks_client.cc index 9121cda05e221..fa8b54eb8f0b8 100644 --- a/google/cloud/compute/health_checks/v1/health_checks_client.cc +++ b/google/cloud/compute/health_checks/v1/health_checks_client.cc @@ -247,6 +247,31 @@ HealthChecksClient::PatchHealthCheck( return connection_->PatchHealthCheck(operation); } +StatusOr +HealthChecksClient::TestIamPermissions( + std::string const& project, std::string const& resource, + google::cloud::cpp::compute::v1::TestPermissionsRequest const& + test_permissions_request_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::health_checks::v1::TestIamPermissionsRequest + request; + request.set_project(project); + request.set_resource(resource); + *request.mutable_test_permissions_request_resource() = + test_permissions_request_resource; + return connection_->TestIamPermissions(request); +} + +StatusOr +HealthChecksClient::TestIamPermissions( + google::cloud::cpp::compute::health_checks::v1:: + TestIamPermissionsRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->TestIamPermissions(request); +} + future> HealthChecksClient::UpdateHealthCheck( std::string const& project, std::string const& health_check, 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 da6029a17e507..e4c1022240620 100644 --- a/google/cloud/compute/health_checks/v1/health_checks_client.h +++ b/google/cloud/compute/health_checks/v1/health_checks_client.h @@ -91,8 +91,10 @@ class HealthChecksClient { // clang-format off /// /// 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`. + /// available to the specified project. + /// + /// To prevent failure, Google recommends that you set the + /// `returnPartialSuccess` parameter to `true`. /// https://cloud.google.com/compute/docs/reference/rest/v1/healthChecks/aggregatedList /// /// @param project Name of the project scoping this request. @@ -118,8 +120,8 @@ class HealthChecksClient { /// [`future`]: @ref google::cloud::future /// [`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#L136} + /// [google.cloud.cpp.compute.health_checks.v1.AggregatedListHealthChecksRequest]: @cloud_cpp_reference_link{google/cloud/compute/health_checks/v1/health_checks.proto#L145} + /// [google.cloud.cpp.compute.v1.HealthChecksScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_063.proto#L157} /// // clang-format on StreamRange> @@ -251,7 +255,7 @@ class HealthChecksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.health_checks.v1.DeleteHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/health_checks/v1/health_checks.proto#L211} + /// [google.cloud.cpp.compute.health_checks.v1.DeleteHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/health_checks/v1/health_checks.proto#L260} /// // clang-format on future> @@ -309,8 +313,8 @@ class HealthChecksClient { /// [`future`]: @ref google::cloud::future /// [`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_043.proto#L271} + /// [google.cloud.cpp.compute.health_checks.v1.GetHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/health_checks/v1/health_checks.proto#L289} + /// [google.cloud.cpp.compute.v1.HealthCheck]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_053.proto#L368} /// // clang-format on StatusOr GetHealthCheck( @@ -341,8 +345,8 @@ class HealthChecksClient { /// [`future`]: @ref google::cloud::future /// [`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_043.proto#L271} + /// [google.cloud.cpp.compute.health_checks.v1.GetHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/health_checks/v1/health_checks.proto#L289} + /// [google.cloud.cpp.compute.v1.HealthCheck]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_053.proto#L368} /// // clang-format on StatusOr GetHealthCheck( @@ -378,7 +382,7 @@ class HealthChecksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.health_checks.v1.InsertHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/health_checks/v1/health_checks.proto#L248} + /// [google.cloud.cpp.compute.health_checks.v1.InsertHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/health_checks/v1/health_checks.proto#L300} /// // clang-format on future> @@ -435,7 +439,7 @@ class HealthChecksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.health_checks.v1.InsertHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/health_checks/v1/health_checks.proto#L248} + /// [google.cloud.cpp.compute.health_checks.v1.InsertHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/health_checks/v1/health_checks.proto#L300} /// // clang-format on future> @@ -502,8 +506,8 @@ class HealthChecksClient { /// [`future`]: @ref google::cloud::future /// [`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_043.proto#L271} + /// [google.cloud.cpp.compute.health_checks.v1.ListHealthChecksRequest]: @cloud_cpp_reference_link{google/cloud/compute/health_checks/v1/health_checks.proto#L329} + /// [google.cloud.cpp.compute.v1.HealthCheck]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_053.proto#L368} /// // clang-format on StreamRange ListHealthChecks( @@ -543,8 +547,8 @@ class HealthChecksClient { /// [`future`]: @ref google::cloud::future /// [`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_043.proto#L271} + /// [google.cloud.cpp.compute.health_checks.v1.ListHealthChecksRequest]: @cloud_cpp_reference_link{google/cloud/compute/health_checks/v1/health_checks.proto#L329} + /// [google.cloud.cpp.compute.v1.HealthCheck]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_053.proto#L368} /// // clang-format on StreamRange ListHealthChecks( @@ -555,8 +559,9 @@ class HealthChecksClient { // clang-format off /// /// 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. + /// included in the request. This method supportsPATCH + /// semantics and uses theJSON merge + /// patch format and processing rules. /// https://cloud.google.com/compute/docs/reference/rest/v1/healthChecks/patch /// /// @param project Project ID for this request. @@ -582,7 +587,7 @@ class HealthChecksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.health_checks.v1.PatchHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/health_checks/v1/health_checks.proto#L342} + /// [google.cloud.cpp.compute.health_checks.v1.PatchHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/health_checks/v1/health_checks.proto#L430} /// // clang-format on future> PatchHealthCheck( @@ -609,8 +614,9 @@ class HealthChecksClient { // clang-format off /// /// 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. + /// included in the request. This method supportsPATCH + /// semantics and uses theJSON merge + /// patch format and processing rules. /// https://cloud.google.com/compute/docs/reference/rest/v1/healthChecks/patch /// /// @param request Unary RPCs, such as the one wrapped by this @@ -639,7 +645,7 @@ class HealthChecksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.health_checks.v1.PatchHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/health_checks/v1/health_checks.proto#L342} + /// [google.cloud.cpp.compute.health_checks.v1.PatchHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/health_checks/v1/health_checks.proto#L430} /// // clang-format on future> PatchHealthCheck( @@ -677,6 +683,71 @@ class HealthChecksClient { google::cloud::cpp::compute::v1::Operation const& operation, Options opts = {}); + // clang-format off + /// + /// Returns permissions that a caller has on the specified resource. + /// https://cloud.google.com/compute/docs/reference/rest/v1/healthChecks/testIamPermissions + /// + /// @param project Project ID for this request. + /// @param resource Name or id of the resource for this request. + /// @param test_permissions_request_resource The TestPermissionsRequest for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.TestPermissionsResponse]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.health_checks.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/health_checks/v1/health_checks.proto#L463} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} + /// + // clang-format on + StatusOr + TestIamPermissions( + std::string const& project, std::string const& resource, + google::cloud::cpp::compute::v1::TestPermissionsRequest const& + test_permissions_request_resource, + Options opts = {}); + + // clang-format off + /// + /// Returns permissions that a caller has on the specified resource. + /// https://cloud.google.com/compute/docs/reference/rest/v1/healthChecks/testIamPermissions + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.health_checks.v1.TestIamPermissionsRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.TestPermissionsResponse]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.health_checks.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/health_checks/v1/health_checks.proto#L463} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} + /// + // clang-format on + StatusOr + TestIamPermissions(google::cloud::cpp::compute::health_checks::v1:: + TestIamPermissionsRequest const& request, + Options opts = {}); + // clang-format off /// /// Updates a HealthCheck resource in the specified project using the data @@ -706,7 +777,7 @@ class HealthChecksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.health_checks.v1.UpdateHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/health_checks/v1/health_checks.proto#L372} + /// [google.cloud.cpp.compute.health_checks.v1.UpdateHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/health_checks/v1/health_checks.proto#L478} /// // clang-format on future> @@ -763,7 +834,7 @@ class HealthChecksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.health_checks.v1.UpdateHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/health_checks/v1/health_checks.proto#L372} + /// [google.cloud.cpp.compute.health_checks.v1.UpdateHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/health_checks/v1/health_checks.proto#L478} /// // clang-format on future> diff --git a/google/cloud/compute/health_checks/v1/health_checks_connection.cc b/google/cloud/compute/health_checks/v1/health_checks_connection.cc index cdd0c3060b386..e5d5fbf13c278 100644 --- a/google/cloud/compute/health_checks/v1/health_checks_connection.cc +++ b/google/cloud/compute/health_checks/v1/health_checks_connection.cc @@ -136,6 +136,13 @@ HealthChecksConnection::PatchHealthCheck( Status(StatusCode::kUnimplemented, "not implemented")); } +StatusOr +HealthChecksConnection::TestIamPermissions( + google::cloud::cpp::compute::health_checks::v1:: + TestIamPermissionsRequest const&) { + return Status(StatusCode::kUnimplemented, "not implemented"); +} + future> HealthChecksConnection::UpdateHealthCheck( google::cloud::cpp::compute::health_checks::v1:: diff --git a/google/cloud/compute/health_checks/v1/health_checks_connection.h b/google/cloud/compute/health_checks/v1/health_checks_connection.h index 64cac99cbb912..dba61573e1c77 100644 --- a/google/cloud/compute/health_checks/v1/health_checks_connection.h +++ b/google/cloud/compute/health_checks/v1/health_checks_connection.h @@ -235,6 +235,10 @@ class HealthChecksConnection { virtual future> PatchHealthCheck(google::cloud::cpp::compute::v1::Operation const& operation); + virtual StatusOr + TestIamPermissions(google::cloud::cpp::compute::health_checks::v1:: + TestIamPermissionsRequest const& request); + virtual future> UpdateHealthCheck(google::cloud::cpp::compute::health_checks::v1:: UpdateHealthCheckRequest const& request); diff --git a/google/cloud/compute/health_checks/v1/health_checks_connection_idempotency_policy.cc b/google/cloud/compute/health_checks/v1/health_checks_connection_idempotency_policy.cc index d483c2ac109b4..39701fd51e18d 100644 --- a/google/cloud/compute/health_checks/v1/health_checks_connection_idempotency_policy.cc +++ b/google/cloud/compute/health_checks/v1/health_checks_connection_idempotency_policy.cc @@ -70,6 +70,12 @@ Idempotency HealthChecksConnectionIdempotencyPolicy::PatchHealthCheck( return Idempotency::kNonIdempotent; } +Idempotency HealthChecksConnectionIdempotencyPolicy::TestIamPermissions( + google::cloud::cpp::compute::health_checks::v1:: + TestIamPermissionsRequest const&) { + return Idempotency::kNonIdempotent; +} + Idempotency HealthChecksConnectionIdempotencyPolicy::UpdateHealthCheck( google::cloud::cpp::compute::health_checks::v1:: UpdateHealthCheckRequest const&) { diff --git a/google/cloud/compute/health_checks/v1/health_checks_connection_idempotency_policy.h b/google/cloud/compute/health_checks/v1/health_checks_connection_idempotency_policy.h index 33509b33bac1c..63554501d31be 100644 --- a/google/cloud/compute/health_checks/v1/health_checks_connection_idempotency_policy.h +++ b/google/cloud/compute/health_checks/v1/health_checks_connection_idempotency_policy.h @@ -61,6 +61,10 @@ class HealthChecksConnectionIdempotencyPolicy { google::cloud::cpp::compute::health_checks::v1:: PatchHealthCheckRequest const& request); + virtual google::cloud::Idempotency TestIamPermissions( + google::cloud::cpp::compute::health_checks::v1:: + TestIamPermissionsRequest const& request); + virtual google::cloud::Idempotency UpdateHealthCheck( google::cloud::cpp::compute::health_checks::v1:: UpdateHealthCheckRequest const& request); 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 5c60b105d1b1d..b2ef9c45901ba 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,10 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_HEALTH_CHECKS_V1_HEALTH_CHECKS_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_043.pb.h" -#include "google/cloud/compute/v1/internal/common_051.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_053.pb.h" +#include "google/cloud/compute/v1/internal/common_063.pb.h" +#include "google/cloud/compute/v1/internal/common_171.pb.h" // 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/health_checks/v1/internal/health_checks_rest_connection_impl.cc b/google/cloud/compute/health_checks/v1/internal/health_checks_rest_connection_impl.cc index aaf2d7b317f23..28e051985f7ad 100644 --- a/google/cloud/compute/health_checks/v1/internal/health_checks_rest_connection_impl.cc +++ b/google/cloud/compute/health_checks/v1/internal/health_checks_rest_connection_impl.cc @@ -521,6 +521,22 @@ HealthChecksRestConnectionImpl::PatchHealthCheck( }); } +StatusOr +HealthChecksRestConnectionImpl::TestIamPermissions( + google::cloud::cpp::compute::health_checks::v1:: + TestIamPermissionsRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->TestIamPermissions(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::health_checks::v1:: + TestIamPermissionsRequest const& request) { + return stub_->TestIamPermissions(rest_context, options, request); + }, + *current, request, __func__); +} + future> HealthChecksRestConnectionImpl::UpdateHealthCheck( google::cloud::cpp::compute::health_checks::v1:: diff --git a/google/cloud/compute/health_checks/v1/internal/health_checks_rest_connection_impl.h b/google/cloud/compute/health_checks/v1/internal/health_checks_rest_connection_impl.h index ecfec7fd13ecb..6cc4bd4a106f5 100644 --- a/google/cloud/compute/health_checks/v1/internal/health_checks_rest_connection_impl.h +++ b/google/cloud/compute/health_checks/v1/internal/health_checks_rest_connection_impl.h @@ -100,6 +100,10 @@ class HealthChecksRestConnectionImpl future> PatchHealthCheck( google::cloud::cpp::compute::v1::Operation const& operation) override; + StatusOr + TestIamPermissions(google::cloud::cpp::compute::health_checks::v1:: + TestIamPermissionsRequest const& request) override; + future> UpdateHealthCheck(google::cloud::cpp::compute::health_checks::v1:: UpdateHealthCheckRequest const& request) override; diff --git a/google/cloud/compute/health_checks/v1/internal/health_checks_rest_logging_decorator.cc b/google/cloud/compute/health_checks/v1/internal/health_checks_rest_logging_decorator.cc index e71c007006594..1e9a2efc23cb4 100644 --- a/google/cloud/compute/health_checks/v1/internal/health_checks_rest_logging_decorator.cc +++ b/google/cloud/compute/health_checks/v1/internal/health_checks_rest_logging_decorator.cc @@ -179,6 +179,20 @@ HealthChecksRestLogging::PatchHealthCheck( rest_context, options, request, __func__, tracing_options_); } +StatusOr +HealthChecksRestLogging::TestIamPermissions( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::health_checks::v1:: + TestIamPermissionsRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::health_checks::v1:: + TestIamPermissionsRequest const& request) { + return child_->TestIamPermissions(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + future> HealthChecksRestLogging::AsyncUpdateHealthCheck( CompletionQueue& cq, diff --git a/google/cloud/compute/health_checks/v1/internal/health_checks_rest_logging_decorator.h b/google/cloud/compute/health_checks/v1/internal/health_checks_rest_logging_decorator.h index c78abceaf2b87..616b6c985170a 100644 --- a/google/cloud/compute/health_checks/v1/internal/health_checks_rest_logging_decorator.h +++ b/google/cloud/compute/health_checks/v1/internal/health_checks_rest_logging_decorator.h @@ -103,6 +103,12 @@ class HealthChecksRestLogging : public HealthChecksRestStub { google::cloud::cpp::compute::health_checks::v1:: PatchHealthCheckRequest const& request) override; + StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::health_checks::v1:: + TestIamPermissionsRequest const& request) override; + future> AsyncUpdateHealthCheck( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/health_checks/v1/internal/health_checks_rest_metadata_decorator.cc b/google/cloud/compute/health_checks/v1/internal/health_checks_rest_metadata_decorator.cc index 028b6a2155dcc..41a1835a69f23 100644 --- a/google/cloud/compute/health_checks/v1/internal/health_checks_rest_metadata_decorator.cc +++ b/google/cloud/compute/health_checks/v1/internal/health_checks_rest_metadata_decorator.cc @@ -128,6 +128,15 @@ HealthChecksRestMetadata::PatchHealthCheck( return child_->PatchHealthCheck(rest_context, options, request); } +StatusOr +HealthChecksRestMetadata::TestIamPermissions( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::health_checks::v1:: + TestIamPermissionsRequest const& request) { + SetMetadata(rest_context, options); + return child_->TestIamPermissions(rest_context, options, request); +} + future> HealthChecksRestMetadata::AsyncUpdateHealthCheck( CompletionQueue& cq, diff --git a/google/cloud/compute/health_checks/v1/internal/health_checks_rest_metadata_decorator.h b/google/cloud/compute/health_checks/v1/internal/health_checks_rest_metadata_decorator.h index 93b69705c98ec..cc14b057fbae3 100644 --- a/google/cloud/compute/health_checks/v1/internal/health_checks_rest_metadata_decorator.h +++ b/google/cloud/compute/health_checks/v1/internal/health_checks_rest_metadata_decorator.h @@ -100,6 +100,12 @@ class HealthChecksRestMetadata : public HealthChecksRestStub { google::cloud::cpp::compute::health_checks::v1:: PatchHealthCheckRequest const& request) override; + StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::health_checks::v1:: + TestIamPermissionsRequest const& request) override; + google::cloud::future> AsyncUpdateHealthCheck( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/health_checks/v1/internal/health_checks_rest_stub.cc b/google/cloud/compute/health_checks/v1/internal/health_checks_rest_stub.cc index a333f888b8030..7826541985fbd 100644 --- a/google/cloud/compute/health_checks/v1/internal/health_checks_rest_stub.cc +++ b/google/cloud/compute/health_checks/v1/internal/health_checks_rest_stub.cc @@ -283,6 +283,25 @@ DefaultHealthChecksRestStub::PatchHealthCheck( std::move(query_params)); } +StatusOr +DefaultHealthChecksRestStub::TestIamPermissions( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::health_checks::v1:: + TestIamPermissionsRequest const& request) { + std::vector> query_params; + return rest_internal::Post< + google::cloud::cpp::compute::v1::TestPermissionsResponse>( + *service_, rest_context, request.test_permissions_request_resource(), + false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "global", "/", + "healthChecks", "/", request.resource(), "/", + "testIamPermissions"), + std::move(query_params)); +} + future> DefaultHealthChecksRestStub::AsyncUpdateHealthCheck( CompletionQueue& cq, diff --git a/google/cloud/compute/health_checks/v1/internal/health_checks_rest_stub.h b/google/cloud/compute/health_checks/v1/internal/health_checks_rest_stub.h index 05a450573c646..f88e95cb79355 100644 --- a/google/cloud/compute/health_checks/v1/internal/health_checks_rest_stub.h +++ b/google/cloud/compute/health_checks/v1/internal/health_checks_rest_stub.h @@ -98,6 +98,12 @@ class HealthChecksRestStub { google::cloud::cpp::compute::health_checks::v1:: PatchHealthCheckRequest const& request) = 0; + virtual StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::health_checks::v1:: + TestIamPermissionsRequest const& request) = 0; + virtual future> AsyncUpdateHealthCheck( google::cloud::CompletionQueue& cq, @@ -198,6 +204,12 @@ class DefaultHealthChecksRestStub : public HealthChecksRestStub { google::cloud::cpp::compute::health_checks::v1:: PatchHealthCheckRequest const& request) override; + StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::health_checks::v1:: + TestIamPermissionsRequest const& request) override; + future> AsyncUpdateHealthCheck( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/health_checks/v1/internal/health_checks_tracing_connection.cc b/google/cloud/compute/health_checks/v1/internal/health_checks_tracing_connection.cc index 833f7dc3027ef..9d51702dac978 100644 --- a/google/cloud/compute/health_checks/v1/internal/health_checks_tracing_connection.cc +++ b/google/cloud/compute/health_checks/v1/internal/health_checks_tracing_connection.cc @@ -162,6 +162,16 @@ HealthChecksTracingConnection::PatchHealthCheck( child_->PatchHealthCheck(operation)); } +StatusOr +HealthChecksTracingConnection::TestIamPermissions( + google::cloud::cpp::compute::health_checks::v1:: + TestIamPermissionsRequest const& request) { + auto span = internal::MakeSpan( + "compute_health_checks_v1::HealthChecksConnection::TestIamPermissions"); + auto scope = opentelemetry::trace::Scope(span); + return internal::EndSpan(*span, child_->TestIamPermissions(request)); +} + future> HealthChecksTracingConnection::UpdateHealthCheck( google::cloud::cpp::compute::health_checks::v1:: diff --git a/google/cloud/compute/health_checks/v1/internal/health_checks_tracing_connection.h b/google/cloud/compute/health_checks/v1/internal/health_checks_tracing_connection.h index 974780dd37442..a9023b63efc39 100644 --- a/google/cloud/compute/health_checks/v1/internal/health_checks_tracing_connection.h +++ b/google/cloud/compute/health_checks/v1/internal/health_checks_tracing_connection.h @@ -87,6 +87,10 @@ class HealthChecksTracingConnection future> PatchHealthCheck( google::cloud::cpp::compute::v1::Operation const& operation) override; + StatusOr + TestIamPermissions(google::cloud::cpp::compute::health_checks::v1:: + TestIamPermissionsRequest const& request) override; + future> UpdateHealthCheck(google::cloud::cpp::compute::health_checks::v1:: UpdateHealthCheckRequest const& request) override; diff --git a/google/cloud/compute/health_checks/v1/mocks/mock_health_checks_connection.h b/google/cloud/compute/health_checks/v1/mocks/mock_health_checks_connection.h index 0032e914f5db2..98774469fc4f5 100644 --- a/google/cloud/compute/health_checks/v1/mocks/mock_health_checks_connection.h +++ b/google/cloud/compute/health_checks/v1/mocks/mock_health_checks_connection.h @@ -192,6 +192,13 @@ class MockHealthChecksConnection (google::cloud::cpp::compute::v1::Operation const& operation), (override)); + MOCK_METHOD( + StatusOr, + TestIamPermissions, + (google::cloud::cpp::compute::health_checks::v1:: + TestIamPermissionsRequest const& request), + (override)); + /// To disambiguate calls, use: /// /// @code diff --git a/google/cloud/compute/hosts/v1/hosts_client.cc b/google/cloud/compute/hosts/v1/hosts_client.cc new file mode 100644 index 0000000000000..cc11faab6cb4b --- /dev/null +++ b/google/cloud/compute/hosts/v1/hosts_client.cc @@ -0,0 +1,133 @@ +// Copyright 2026 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. +// source: google/cloud/compute/hosts/v1/hosts.proto + +#include "google/cloud/compute/hosts/v1/hosts_client.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_hosts_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +HostsClient::HostsClient(std::shared_ptr connection, + Options opts) + : connection_(std::move(connection)), + options_( + internal::MergeOptions(std::move(opts), connection_->options())) {} +HostsClient::~HostsClient() = default; + +StatusOr HostsClient::GetHost( + std::string const& project, std::string const& zone, + std::string const& association, std::string const& host, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::hosts::v1::GetHostRequest request; + request.set_project(project); + request.set_zone(zone); + request.set_association(association); + request.set_host(host); + return connection_->GetHost(request); +} + +StatusOr HostsClient::GetHost( + google::cloud::cpp::compute::hosts::v1::GetHostRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->GetHost(request); +} + +future> +HostsClient::GetVersion( + std::string const& project, std::string const& zone, + std::string const& association, std::string const& host, + google::cloud::cpp::compute::v1::HostsGetVersionRequest const& + hosts_get_version_request_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::hosts::v1::GetVersionRequest request; + request.set_project(project); + request.set_zone(zone); + request.set_association(association); + request.set_host(host); + *request.mutable_hosts_get_version_request_resource() = + hosts_get_version_request_resource; + return connection_->GetVersion(request); +} + +StatusOr HostsClient::GetVersion( + NoAwaitTag, std::string const& project, std::string const& zone, + std::string const& association, std::string const& host, + google::cloud::cpp::compute::v1::HostsGetVersionRequest const& + hosts_get_version_request_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::hosts::v1::GetVersionRequest request; + request.set_project(project); + request.set_zone(zone); + request.set_association(association); + request.set_host(host); + *request.mutable_hosts_get_version_request_resource() = + hosts_get_version_request_resource; + return connection_->GetVersion(NoAwaitTag{}, request); +} + +future> +HostsClient::GetVersion( + google::cloud::cpp::compute::hosts::v1::GetVersionRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->GetVersion(request); +} + +StatusOr HostsClient::GetVersion( + NoAwaitTag, + google::cloud::cpp::compute::hosts::v1::GetVersionRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->GetVersion(NoAwaitTag{}, request); +} + +future> +HostsClient::GetVersion( + google::cloud::cpp::compute::v1::Operation const& operation, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->GetVersion(operation); +} + +StreamRange HostsClient::ListHosts( + std::string const& project, std::string const& zone, + std::string const& association, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::hosts::v1::ListHostsRequest request; + request.set_project(project); + request.set_zone(zone); + request.set_association(association); + return connection_->ListHosts(request); +} + +StreamRange HostsClient::ListHosts( + google::cloud::cpp::compute::hosts::v1::ListHostsRequest request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->ListHosts(std::move(request)); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_hosts_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/hosts/v1/hosts_client.h b/google/cloud/compute/hosts/v1/hosts_client.h new file mode 100644 index 0000000000000..6d406fd02844e --- /dev/null +++ b/google/cloud/compute/hosts/v1/hosts_client.h @@ -0,0 +1,377 @@ +// Copyright 2026 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. +// source: google/cloud/compute/hosts/v1/hosts.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_HOSTS_V1_HOSTS_CLIENT_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_HOSTS_V1_HOSTS_CLIENT_H + +#include "google/cloud/compute/hosts/v1/hosts_rest_connection.h" +#include "google/cloud/future.h" +#include "google/cloud/no_await_tag.h" +#include "google/cloud/options.h" +#include "google/cloud/polling_policy.h" +#include "google/cloud/status_or.h" +#include "google/cloud/version.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_hosts_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/// +/// Service for the hosts resource. +/// https://cloud.google.com/compute/docs/reference/rest/v1/hosts +/// +/// @par Equality +/// +/// Instances of this class created via copy-construction or copy-assignment +/// always compare equal. Instances created with equal +/// `std::shared_ptr<*Connection>` objects compare equal. Objects that compare +/// equal share the same underlying resources. +/// +/// @par Performance +/// +/// Creating a new instance of this class is a relatively expensive operation, +/// new objects establish new connections to the service. In contrast, +/// copy-construction, move-construction, and the corresponding assignment +/// operations are relatively efficient as the copies share all underlying +/// resources. +/// +/// @par Thread Safety +/// +/// Concurrent access to different instances of this class, even if they compare +/// equal, is guaranteed to work. Two or more threads operating on the same +/// instance of this class is not guaranteed to work. Since copy-construction +/// and move-construction is a relatively efficient operation, consider using +/// such a copy when using this class from multiple threads. +/// +class HostsClient { + public: + explicit HostsClient(std::shared_ptr connection, + Options opts = {}); + ~HostsClient(); + + ///@{ + /// @name Copy and move support + HostsClient(HostsClient const&) = default; + HostsClient& operator=(HostsClient const&) = default; + HostsClient(HostsClient&&) = default; + HostsClient& operator=(HostsClient&&) = default; + ///@} + + ///@{ + /// @name Equality + friend bool operator==(HostsClient const& a, HostsClient const& b) { + return a.connection_ == b.connection_; + } + friend bool operator!=(HostsClient const& a, HostsClient const& b) { + return !(a == b); + } + ///@} + + // clang-format off + /// + /// Retrieves information about the specified host. + /// https://cloud.google.com/compute/docs/reference/rest/v1/hosts/get + /// + /// @param project The project ID for this request. + /// @param zone The name of the zone for this request, formatted as RFC1035. + /// @param association The parent resource association for the Host. This field specifies the + /// hierarchical context (e.g., reservation, block, sub-block) when + /// accessing the host. For example, reservations/reservation_name, + /// reservations/reservation_name/reservationBlocks/reservation_block_name or + /// reservations/reservation_name/reservationBlocks/reservation_block_name/reservationSubBlocks/reservation_sub_block_name. + /// @param host The name of the host, formatted as RFC1035 or a resource ID + /// number. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.Host]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.hosts.v1.GetHostRequest]: @cloud_cpp_reference_link{google/cloud/compute/hosts/v1/hosts.proto#L74} + /// [google.cloud.cpp.compute.v1.Host]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_066.proto#L25} + /// + // clang-format on + StatusOr GetHost( + std::string const& project, std::string const& zone, + std::string const& association, std::string const& host, + Options opts = {}); + + // clang-format off + /// + /// Retrieves information about the specified host. + /// https://cloud.google.com/compute/docs/reference/rest/v1/hosts/get + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.hosts.v1.GetHostRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.Host]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.hosts.v1.GetHostRequest]: @cloud_cpp_reference_link{google/cloud/compute/hosts/v1/hosts.proto#L74} + /// [google.cloud.cpp.compute.v1.Host]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_066.proto#L25} + /// + // clang-format on + StatusOr GetHost( + google::cloud::cpp::compute::hosts::v1::GetHostRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// Allows customers to get SBOM versions of a host. + /// https://cloud.google.com/compute/docs/reference/rest/v1/hosts/getVersion + /// + /// @param project Project ID for this request. + /// @param zone Name of the zone for this request. Zone name should conform to RFC1035. + /// @param association The parent resource association for the Host. This field specifies the + /// hierarchical context (e.g., reservation, block, sub-block) when + /// accessing the host. + /// @param host The name of the host, formatted as RFC1035 or a resource ID + /// number. + /// @param hosts_get_version_request_resource The HostsGetVersionRequest for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.hosts.v1.GetVersionRequest]: @cloud_cpp_reference_link{google/cloud/compute/hosts/v1/hosts.proto#L96} + /// + // clang-format on + future> GetVersion( + std::string const& project, std::string const& zone, + std::string const& association, std::string const& host, + google::cloud::cpp::compute::v1::HostsGetVersionRequest const& + hosts_get_version_request_resource, + Options opts = {}); + + // clang-format off + /// + /// @copybrief GetVersion + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr GetVersion( + NoAwaitTag, std::string const& project, std::string const& zone, + std::string const& association, std::string const& host, + google::cloud::cpp::compute::v1::HostsGetVersionRequest const& + hosts_get_version_request_resource, + Options opts = {}); + + // clang-format off + /// + /// Allows customers to get SBOM versions of a host. + /// https://cloud.google.com/compute/docs/reference/rest/v1/hosts/getVersion + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.hosts.v1.GetVersionRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.hosts.v1.GetVersionRequest]: @cloud_cpp_reference_link{google/cloud/compute/hosts/v1/hosts.proto#L96} + /// + // clang-format on + future> GetVersion( + google::cloud::cpp::compute::hosts::v1::GetVersionRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief GetVersion + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr GetVersion( + NoAwaitTag, + google::cloud::cpp::compute::hosts::v1::GetVersionRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief GetVersion + /// + /// This method accepts a `google::cloud::cpp::compute::v1::Operation` that corresponds + /// to a previously started Long Running Operation (LRO) and polls the status + /// of the LRO in the background. + /// + // clang-format on + future> GetVersion( + google::cloud::cpp::compute::v1::Operation const& operation, + Options opts = {}); + + // clang-format off + /// + /// Retrieves a list of hosts. + /// https://cloud.google.com/compute/docs/reference/rest/v1/hosts/list + /// + /// @param project The project ID for this request. + /// @param zone The name of the zone for this request, formatted as RFC1035. + /// @param association The parent resource association for the Host. This field specifies the + /// hierarchical context (e.g., reservation, block, sub-block) when + /// accessing the host. For example, reservations/reservation_name, + /// reservations/reservation_name/reservationBlocks/reservation_block_name or + /// reservations/reservation_name/reservationBlocks/reservation_block_name/reservationSubBlocks/reservation_sub_block_name. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return a [StreamRange](@ref google::cloud::StreamRange) + /// to iterate of the results. See the documentation of this type for + /// details. In brief, this class has `begin()` and `end()` member + /// functions returning a iterator class meeting the + /// [input iterator requirements]. The value type for this iterator is a + /// [`StatusOr`] as the iteration may fail even after some values are + /// retrieved successfully, for example, if there is a network disconnect. + /// An empty set of results does not indicate an error, it indicates + /// that there are no resources meeting the request criteria. + /// On a successful iteration the `StatusOr` contains elements of type + /// [google.cloud.cpp.compute.v1.Host], or rather, + /// the C++ class generated by Protobuf from that type. Please consult the + /// Protobuf documentation for details on the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.hosts.v1.ListHostsRequest]: @cloud_cpp_reference_link{google/cloud/compute/hosts/v1/hosts.proto#L133} + /// [google.cloud.cpp.compute.v1.Host]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_066.proto#L25} + /// + // clang-format on + StreamRange ListHosts( + std::string const& project, std::string const& zone, + std::string const& association, Options opts = {}); + + // clang-format off + /// + /// Retrieves a list of hosts. + /// https://cloud.google.com/compute/docs/reference/rest/v1/hosts/list + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.hosts.v1.ListHostsRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return a [StreamRange](@ref google::cloud::StreamRange) + /// to iterate of the results. See the documentation of this type for + /// details. In brief, this class has `begin()` and `end()` member + /// functions returning a iterator class meeting the + /// [input iterator requirements]. The value type for this iterator is a + /// [`StatusOr`] as the iteration may fail even after some values are + /// retrieved successfully, for example, if there is a network disconnect. + /// An empty set of results does not indicate an error, it indicates + /// that there are no resources meeting the request criteria. + /// On a successful iteration the `StatusOr` contains elements of type + /// [google.cloud.cpp.compute.v1.Host], or rather, + /// the C++ class generated by Protobuf from that type. Please consult the + /// Protobuf documentation for details on the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.hosts.v1.ListHostsRequest]: @cloud_cpp_reference_link{google/cloud/compute/hosts/v1/hosts.proto#L133} + /// [google.cloud.cpp.compute.v1.Host]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_066.proto#L25} + /// + // clang-format on + StreamRange ListHosts( + google::cloud::cpp::compute::hosts::v1::ListHostsRequest request, + Options opts = {}); + + private: + std::shared_ptr connection_; + Options options_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_hosts_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_HOSTS_V1_HOSTS_CLIENT_H diff --git a/google/cloud/compute/hosts/v1/hosts_connection.cc b/google/cloud/compute/hosts/v1/hosts_connection.cc new file mode 100644 index 0000000000000..0104edc25b61f --- /dev/null +++ b/google/cloud/compute/hosts/v1/hosts_connection.cc @@ -0,0 +1,77 @@ +// Copyright 2026 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. +// source: google/cloud/compute/hosts/v1/hosts.proto + +#include "google/cloud/compute/hosts/v1/hosts_connection.h" +#include "google/cloud/compute/hosts/v1/hosts_options.h" +#include "google/cloud/compute/hosts/v1/internal/hosts_option_defaults.h" +#include "google/cloud/compute/hosts/v1/internal/hosts_tracing_connection.h" +#include "google/cloud/background_threads.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/grpc_options.h" +#include "google/cloud/internal/pagination_range.h" +#include "google/cloud/internal/unified_grpc_credentials.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_hosts_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +HostsConnection::~HostsConnection() = default; + +StatusOr HostsConnection::GetHost( + google::cloud::cpp::compute::hosts::v1::GetHostRequest const&) { + return Status(StatusCode::kUnimplemented, "not implemented"); +} + +future> +HostsConnection::GetVersion( + google::cloud::cpp::compute::hosts::v1::GetVersionRequest const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +HostsConnection::GetVersion( + NoAwaitTag, + google::cloud::cpp::compute::hosts::v1::GetVersionRequest const&) { + return StatusOr( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +HostsConnection::GetVersion(google::cloud::cpp::compute::v1::Operation const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StreamRange HostsConnection::ListHosts( + google::cloud::cpp::compute::hosts::v1:: + ListHostsRequest) { // NOLINT(performance-unnecessary-value-param) + return google::cloud::internal::MakeUnimplementedPaginationRange< + StreamRange>(); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_hosts_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/hosts/v1/hosts_connection.h b/google/cloud/compute/hosts/v1/hosts_connection.h new file mode 100644 index 0000000000000..6b7309b4d0f9b --- /dev/null +++ b/google/cloud/compute/hosts/v1/hosts_connection.h @@ -0,0 +1,207 @@ +// Copyright 2026 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. +// source: google/cloud/compute/hosts/v1/hosts.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_HOSTS_V1_HOSTS_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_HOSTS_V1_HOSTS_CONNECTION_H + +#include "google/cloud/compute/hosts/v1/hosts.pb.h" +#include "google/cloud/compute/hosts/v1/hosts_connection_idempotency_policy.h" +#include "google/cloud/compute/hosts/v1/internal/hosts_retry_traits.h" +#include "google/cloud/backoff_policy.h" +#include "google/cloud/future.h" +#include "google/cloud/internal/retry_policy_impl.h" +#include "google/cloud/no_await_tag.h" +#include "google/cloud/options.h" +#include "google/cloud/polling_policy.h" +#include "google/cloud/status_or.h" +#include "google/cloud/stream_range.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_hosts_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/// The retry policy for `HostsConnection`. +class HostsRetryPolicy : public ::google::cloud::RetryPolicy { + public: + /// Creates a new instance of the policy, reset to the initial state. + virtual std::unique_ptr clone() const = 0; +}; + +/** + * A retry policy for `HostsConnection` based on counting errors. + * + * This policy stops retrying if: + * - An RPC returns a non-transient error. + * - More than a prescribed number of transient failures is detected. + * + * In this class the following status codes are treated as transient errors: + * - [`kUnavailable`](@ref google::cloud::StatusCode) + */ +class HostsLimitedErrorCountRetryPolicy : public HostsRetryPolicy { + public: + /** + * Create an instance that tolerates up to @p maximum_failures transient + * errors. + * + * @note Disable the retry loop by providing an instance of this policy with + * @p maximum_failures == 0. + */ + explicit HostsLimitedErrorCountRetryPolicy(int maximum_failures) + : impl_(maximum_failures) {} + + HostsLimitedErrorCountRetryPolicy( + HostsLimitedErrorCountRetryPolicy&& rhs) noexcept + : HostsLimitedErrorCountRetryPolicy(rhs.maximum_failures()) {} + HostsLimitedErrorCountRetryPolicy( + HostsLimitedErrorCountRetryPolicy const& rhs) noexcept + : HostsLimitedErrorCountRetryPolicy(rhs.maximum_failures()) {} + + int maximum_failures() const { return impl_.maximum_failures(); } + + bool OnFailure(Status const& status) override { + return impl_.OnFailure(status); + } + bool IsExhausted() const override { return impl_.IsExhausted(); } + bool IsPermanentFailure(Status const& status) const override { + return impl_.IsPermanentFailure(status); + } + std::unique_ptr clone() const override { + return std::make_unique( + maximum_failures()); + } + + // This is provided only for backwards compatibility. + using BaseType = HostsRetryPolicy; + + private: + google::cloud::internal::LimitedErrorCountRetryPolicy< + compute_hosts_v1_internal::HostsRetryTraits> + impl_; +}; + +/** + * A retry policy for `HostsConnection` based on elapsed time. + * + * This policy stops retrying if: + * - An RPC returns a non-transient error. + * - The elapsed time in the retry loop exceeds a prescribed duration. + * + * In this class the following status codes are treated as transient errors: + * - [`kUnavailable`](@ref google::cloud::StatusCode) + */ +class HostsLimitedTimeRetryPolicy : public HostsRetryPolicy { + public: + /** + * Constructor given a `std::chrono::duration<>` object. + * + * @tparam DurationRep a placeholder to match the `Rep` tparam for @p + * duration's type. The semantics of this template parameter are + * documented in `std::chrono::duration<>`. In brief, the underlying + * arithmetic type used to store the number of ticks. For our purposes it + * is simply a formal parameter. + * @tparam DurationPeriod a placeholder to match the `Period` tparam for @p + * duration's type. The semantics of this template parameter are + * documented in `std::chrono::duration<>`. In brief, the length of the + * tick in seconds, expressed as a `std::ratio<>`. For our purposes it is + * simply a formal parameter. + * @param maximum_duration the maximum time allowed before the policy expires. + * While the application can express this time in any units they desire, + * the class truncates to milliseconds. + * + * @see https://en.cppreference.com/w/cpp/chrono/duration for more information + * about `std::chrono::duration`. + */ + template + explicit HostsLimitedTimeRetryPolicy( + std::chrono::duration maximum_duration) + : impl_(maximum_duration) {} + + HostsLimitedTimeRetryPolicy(HostsLimitedTimeRetryPolicy&& rhs) noexcept + : HostsLimitedTimeRetryPolicy(rhs.maximum_duration()) {} + HostsLimitedTimeRetryPolicy(HostsLimitedTimeRetryPolicy const& rhs) noexcept + : HostsLimitedTimeRetryPolicy(rhs.maximum_duration()) {} + + std::chrono::milliseconds maximum_duration() const { + return impl_.maximum_duration(); + } + + bool OnFailure(Status const& status) override { + return impl_.OnFailure(status); + } + bool IsExhausted() const override { return impl_.IsExhausted(); } + bool IsPermanentFailure(Status const& status) const override { + return impl_.IsPermanentFailure(status); + } + std::unique_ptr clone() const override { + return std::make_unique(maximum_duration()); + } + + // This is provided only for backwards compatibility. + using BaseType = HostsRetryPolicy; + + private: + google::cloud::internal::LimitedTimeRetryPolicy< + compute_hosts_v1_internal::HostsRetryTraits> + impl_; +}; + +/** + * The `HostsConnection` object for `HostsClient`. + * + * This interface defines virtual methods for each of the user-facing overload + * sets in `HostsClient`. This allows users to inject custom behavior + * (e.g., with a Google Mock object) when writing tests that use objects of type + * `HostsClient`. + * + * To create a concrete instance, see `MakeHostsConnection()`. + * + * For mocking, see `compute_hosts_v1_mocks::MockHostsConnection`. + */ +class HostsConnection { + public: + virtual ~HostsConnection() = 0; + + virtual Options options() { return Options{}; } + + virtual StatusOr GetHost( + google::cloud::cpp::compute::hosts::v1::GetHostRequest const& request); + + virtual future> + GetVersion( + google::cloud::cpp::compute::hosts::v1::GetVersionRequest const& request); + + virtual StatusOr GetVersion( + NoAwaitTag, + google::cloud::cpp::compute::hosts::v1::GetVersionRequest const& request); + + virtual future> + GetVersion(google::cloud::cpp::compute::v1::Operation const& operation); + + virtual StreamRange ListHosts( + google::cloud::cpp::compute::hosts::v1::ListHostsRequest request); +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_hosts_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_HOSTS_V1_HOSTS_CONNECTION_H diff --git a/google/cloud/compute/hosts/v1/hosts_connection_idempotency_policy.cc b/google/cloud/compute/hosts/v1/hosts_connection_idempotency_policy.cc new file mode 100644 index 0000000000000..ba6c1f7fb66e8 --- /dev/null +++ b/google/cloud/compute/hosts/v1/hosts_connection_idempotency_policy.cc @@ -0,0 +1,59 @@ +// Copyright 2026 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. +// source: google/cloud/compute/hosts/v1/hosts.proto + +#include "google/cloud/compute/hosts/v1/hosts_connection_idempotency_policy.h" +#include + +namespace google { +namespace cloud { +namespace compute_hosts_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +using ::google::cloud::Idempotency; + +HostsConnectionIdempotencyPolicy::~HostsConnectionIdempotencyPolicy() = default; + +std::unique_ptr +HostsConnectionIdempotencyPolicy::clone() const { + return std::make_unique(*this); +} + +Idempotency HostsConnectionIdempotencyPolicy::GetHost( + google::cloud::cpp::compute::hosts::v1::GetHostRequest const&) { + return Idempotency::kIdempotent; +} + +Idempotency HostsConnectionIdempotencyPolicy::GetVersion( + google::cloud::cpp::compute::hosts::v1::GetVersionRequest const&) { + return Idempotency::kNonIdempotent; +} + +Idempotency HostsConnectionIdempotencyPolicy::ListHosts( + google::cloud::cpp::compute::hosts::v1::ListHostsRequest) { // NOLINT + return Idempotency::kIdempotent; +} + +std::unique_ptr +MakeDefaultHostsConnectionIdempotencyPolicy() { + return std::make_unique(); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_hosts_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/hosts/v1/hosts_connection_idempotency_policy.h b/google/cloud/compute/hosts/v1/hosts_connection_idempotency_policy.h new file mode 100644 index 0000000000000..43fd25be46066 --- /dev/null +++ b/google/cloud/compute/hosts/v1/hosts_connection_idempotency_policy.h @@ -0,0 +1,57 @@ +// Copyright 2026 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. +// source: google/cloud/compute/hosts/v1/hosts.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_HOSTS_V1_HOSTS_CONNECTION_IDEMPOTENCY_POLICY_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_HOSTS_V1_HOSTS_CONNECTION_IDEMPOTENCY_POLICY_H + +#include "google/cloud/compute/hosts/v1/hosts.pb.h" +#include "google/cloud/idempotency.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_hosts_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class HostsConnectionIdempotencyPolicy { + public: + virtual ~HostsConnectionIdempotencyPolicy(); + + /// Create a new copy of this object. + virtual std::unique_ptr clone() const; + + virtual google::cloud::Idempotency GetHost( + google::cloud::cpp::compute::hosts::v1::GetHostRequest const& request); + + virtual google::cloud::Idempotency GetVersion( + google::cloud::cpp::compute::hosts::v1::GetVersionRequest const& request); + + virtual google::cloud::Idempotency ListHosts( + google::cloud::cpp::compute::hosts::v1::ListHostsRequest request); +}; + +std::unique_ptr +MakeDefaultHostsConnectionIdempotencyPolicy(); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_hosts_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_HOSTS_V1_HOSTS_CONNECTION_IDEMPOTENCY_POLICY_H diff --git a/google/cloud/compute/hosts/v1/hosts_options.h b/google/cloud/compute/hosts/v1/hosts_options.h new file mode 100644 index 0000000000000..aa1d0c6db042c --- /dev/null +++ b/google/cloud/compute/hosts/v1/hosts_options.h @@ -0,0 +1,86 @@ +// Copyright 2026 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. +// source: google/cloud/compute/hosts/v1/hosts.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_HOSTS_V1_HOSTS_OPTIONS_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_HOSTS_V1_HOSTS_OPTIONS_H + +#include "google/cloud/compute/hosts/v1/hosts_connection.h" +#include "google/cloud/compute/hosts/v1/hosts_connection_idempotency_policy.h" +#include "google/cloud/backoff_policy.h" +#include "google/cloud/options.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_hosts_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/** + * Use with `google::cloud::Options` to configure the retry policy. + * + * @ingroup google-cloud-compute-options + */ +struct HostsRetryPolicyOption { + using Type = std::shared_ptr; +}; + +/** + * Use with `google::cloud::Options` to configure the backoff policy. + * + * @ingroup google-cloud-compute-options + */ +struct HostsBackoffPolicyOption { + using Type = std::shared_ptr; +}; + +/** + * Use with `google::cloud::Options` to configure which operations are retried. + * + * @ingroup google-cloud-compute-options + */ +struct HostsConnectionIdempotencyPolicyOption { + using Type = std::shared_ptr; +}; + +/** + * Use with `google::cloud::Options` to configure the long-running operations + * polling policy. + * + * @ingroup google-cloud-compute-options + */ +struct HostsPollingPolicyOption { + using Type = std::shared_ptr; +}; + +/** + * The options applicable to Hosts. + * + * @ingroup google-cloud-compute-options + */ +using HostsPolicyOptionList = + OptionList; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_hosts_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_HOSTS_V1_HOSTS_OPTIONS_H diff --git a/google/cloud/compute/hosts/v1/hosts_proto_export.h b/google/cloud/compute/hosts/v1/hosts_proto_export.h new file mode 100644 index 0000000000000..86f6fedd4db4f --- /dev/null +++ b/google/cloud/compute/hosts/v1/hosts_proto_export.h @@ -0,0 +1,33 @@ +// Copyright 2026 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_HOSTS_V1_HOSTS_PROTO_EXPORT_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_HOSTS_V1_HOSTS_PROTO_EXPORT_H + +// IWYU pragma: begin_exports +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_066.pb.h" +// IWYU pragma: end_exports + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_HOSTS_V1_HOSTS_PROTO_EXPORT_H diff --git a/google/cloud/compute/hosts/v1/hosts_rest_connection.cc b/google/cloud/compute/hosts/v1/hosts_rest_connection.cc new file mode 100644 index 0000000000000..35b5da60135da --- /dev/null +++ b/google/cloud/compute/hosts/v1/hosts_rest_connection.cc @@ -0,0 +1,54 @@ +// Copyright 2026 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. +// source: google/cloud/compute/hosts/v1/hosts.proto + +#include "google/cloud/compute/hosts/v1/hosts_rest_connection.h" +#include "google/cloud/compute/hosts/v1/hosts_options.h" +#include "google/cloud/compute/hosts/v1/internal/hosts_option_defaults.h" +#include "google/cloud/compute/hosts/v1/internal/hosts_rest_connection_impl.h" +#include "google/cloud/compute/hosts/v1/internal/hosts_rest_stub_factory.h" +#include "google/cloud/compute/hosts/v1/internal/hosts_tracing_connection.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/internal/rest_background_threads_impl.h" +#include "google/cloud/internal/rest_options.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_hosts_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +std::shared_ptr MakeHostsConnectionRest(Options options) { + internal::CheckExpectedOptions< + CommonOptionList, RestOptionList, UnifiedCredentialsOptionList, + rest_internal::TargetApiVersionOption, HostsPolicyOptionList>(options, + __func__); + options = compute_hosts_v1_internal::HostsDefaultOptions(std::move(options)); + auto background = std::make_unique< + rest_internal::AutomaticallyCreatedRestBackgroundThreads>(); + auto stub = compute_hosts_v1_internal::CreateDefaultHostsRestStub(options); + return compute_hosts_v1_internal::MakeHostsTracingConnection( + std::make_shared( + std::move(background), std::move(stub), std::move(options))); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_hosts_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/hosts/v1/hosts_rest_connection.h b/google/cloud/compute/hosts/v1/hosts_rest_connection.h new file mode 100644 index 0000000000000..12f3b75556101 --- /dev/null +++ b/google/cloud/compute/hosts/v1/hosts_rest_connection.h @@ -0,0 +1,63 @@ +// Copyright 2026 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. +// source: google/cloud/compute/hosts/v1/hosts.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_HOSTS_V1_HOSTS_REST_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_HOSTS_V1_HOSTS_REST_CONNECTION_H + +#include "google/cloud/compute/hosts/v1/hosts_connection.h" +#include "google/cloud/options.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_hosts_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/** + * A factory function to construct an object of type `HostsConnection` + * that uses REST over HTTP as transport in lieu of gRPC. REST transport should + * only be used for services that do not support gRPC or if the existing network + * configuration precludes using gRPC. + * + * The returned connection object should not be used directly; instead it + * should be passed as an argument to the constructor of HostsClient. + * + * The optional @p options argument may be used to configure aspects of the + * returned `HostsConnection`. Expected options are any of the types in + * the following option lists: + * + * - `google::cloud::CommonOptionList` + * - `google::cloud::RestOptionList` + * - `google::cloud::UnifiedCredentialsOptionList` + * - `google::cloud::compute_hosts_v1::HostsPolicyOptionList` + * + * @note Unexpected options will be ignored. To log unexpected options instead, + * set `GOOGLE_CLOUD_CPP_ENABLE_CLOG=yes` in the environment. + * + * @param options (optional) Configure the `HostsConnection` created by + * this function. + */ +std::shared_ptr MakeHostsConnectionRest(Options options = {}); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_hosts_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_HOSTS_V1_HOSTS_REST_CONNECTION_H diff --git a/google/cloud/compute/hosts/v1/internal/hosts_option_defaults.cc b/google/cloud/compute/hosts/v1/internal/hosts_option_defaults.cc new file mode 100644 index 0000000000000..663fcc07b24c3 --- /dev/null +++ b/google/cloud/compute/hosts/v1/internal/hosts_option_defaults.cc @@ -0,0 +1,75 @@ +// Copyright 2026 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. +// source: google/cloud/compute/hosts/v1/hosts.proto + +#include "google/cloud/compute/hosts/v1/internal/hosts_option_defaults.h" +#include "google/cloud/compute/hosts/v1/hosts_connection.h" +#include "google/cloud/compute/hosts/v1/hosts_options.h" +#include "google/cloud/internal/populate_common_options.h" +#include "google/cloud/internal/populate_grpc_options.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_hosts_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +namespace { +auto constexpr kBackoffScaling = 2.0; +} // namespace + +Options HostsDefaultOptions(Options options) { + options = internal::PopulateCommonOptions( + std::move(options), "GOOGLE_CLOUD_CPP_HOSTS_ENDPOINT", "", + "GOOGLE_CLOUD_CPP_HOSTS_AUTHORITY", "compute.googleapis.com"); + options = internal::PopulateGrpcOptions(std::move(options)); + if (!options.has()) { + options.set( + compute_hosts_v1::HostsLimitedTimeRetryPolicy(std::chrono::minutes(10)) + .clone()); + } + if (!options.has()) { + options.set( + ExponentialBackoffPolicy( + std::chrono::seconds(0), std::chrono::seconds(1), + std::chrono::minutes(5), kBackoffScaling, kBackoffScaling) + .clone()); + } + if (!options.has()) { + options.set( + GenericPollingPolicy( + options.get()->clone(), + ExponentialBackoffPolicy(std::chrono::seconds(1), + std::chrono::minutes(5), kBackoffScaling) + .clone()) + .clone()); + } + if (!options + .has()) { + options.set( + compute_hosts_v1::MakeDefaultHostsConnectionIdempotencyPolicy()); + } + + return options; +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_hosts_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/hosts/v1/internal/hosts_option_defaults.h b/google/cloud/compute/hosts/v1/internal/hosts_option_defaults.h new file mode 100644 index 0000000000000..ac0b6cd9d1efc --- /dev/null +++ b/google/cloud/compute/hosts/v1/internal/hosts_option_defaults.h @@ -0,0 +1,37 @@ +// Copyright 2026 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. +// source: google/cloud/compute/hosts/v1/hosts.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_HOSTS_V1_INTERNAL_HOSTS_OPTION_DEFAULTS_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_HOSTS_V1_INTERNAL_HOSTS_OPTION_DEFAULTS_H + +#include "google/cloud/options.h" +#include "google/cloud/version.h" + +namespace google { +namespace cloud { +namespace compute_hosts_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +Options HostsDefaultOptions(Options options); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_hosts_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_HOSTS_V1_INTERNAL_HOSTS_OPTION_DEFAULTS_H diff --git a/google/cloud/compute/hosts/v1/internal/hosts_rest_connection_impl.cc b/google/cloud/compute/hosts/v1/internal/hosts_rest_connection_impl.cc new file mode 100644 index 0000000000000..931b3891ef600 --- /dev/null +++ b/google/cloud/compute/hosts/v1/internal/hosts_rest_connection_impl.cc @@ -0,0 +1,231 @@ +// Copyright 2026 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. +// source: google/cloud/compute/hosts/v1/hosts.proto + +#include "google/cloud/compute/hosts/v1/internal/hosts_rest_connection_impl.h" +#include "google/cloud/compute/hosts/v1/internal/hosts_rest_stub_factory.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/internal/async_rest_long_running_operation_custom.h" +#include "google/cloud/internal/extract_long_running_result.h" +#include "google/cloud/internal/pagination_range.h" +#include "google/cloud/internal/rest_lro_helpers.h" +#include "google/cloud/internal/rest_retry_loop.h" +#include "google/cloud/rest_options.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_hosts_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +HostsRestConnectionImpl::HostsRestConnectionImpl( + std::unique_ptr background, + std::shared_ptr stub, + Options options) + : background_(std::move(background)), + stub_(std::move(stub)), + options_(internal::MergeOptions(std::move(options), + HostsConnection::options())) {} + +StatusOr +HostsRestConnectionImpl::GetHost( + google::cloud::cpp::compute::hosts::v1::GetHostRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->GetHost(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::hosts::v1::GetHostRequest const& + request) { + return stub_->GetHost(rest_context, options, request); + }, + *current, request, __func__); +} + +future> +HostsRestConnectionImpl::GetVersion( + google::cloud::cpp::compute::hosts::v1::GetVersionRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::zone_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::zone_operations::v1::DeleteOperationRequest>( + background_->cq(), current, request, + [stub = stub_]( + CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::hosts::v1::GetVersionRequest const& + request) { + return stub->AsyncGetVersion(cq, std::move(context), std::move(options), + request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->GetVersion(request), + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [request]( + std::string const& op, + google::cloud::cpp::compute::zone_operations::v1::GetOperationRequest& + r) { + r.set_project(request.project()); + r.set_zone(request.zone()); + r.set_operation(op); + }, + [request](std::string const& op, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest& r) { + r.set_project(request.project()); + r.set_zone(request.zone()); + r.set_operation(op); + }); +} + +StatusOr +HostsRestConnectionImpl::GetVersion( + NoAwaitTag, + google::cloud::cpp::compute::hosts::v1::GetVersionRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->GetVersion(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::hosts::v1::GetVersionRequest const& + request) { + return stub_->GetVersion(rest_context, options, request); + }, + *current, request, __func__); +} + +future> +HostsRestConnectionImpl::GetVersion( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestAwaitLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::zone_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::zone_operations::v1::DeleteOperationRequest>( + background_->cq(), current, operation, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [operation]( + std::string const&, + google::cloud::cpp::compute::zone_operations::v1::GetOperationRequest& + r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_zone(info.zone); + r.set_operation(info.operation); + }, + [operation](std::string const&, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_zone(info.zone); + r.set_operation(info.operation); + }); +} + +StreamRange +HostsRestConnectionImpl::ListHosts( + google::cloud::cpp::compute::hosts::v1::ListHostsRequest request) { + request.clear_page_token(); + auto current = google::cloud::internal::SaveCurrentOptions(); + auto idempotency = idempotency_policy(*current)->ListHosts(request); + char const* function_name = __func__; + return google::cloud::internal::MakePaginationRange< + StreamRange>( + current, std::move(request), + [idempotency, function_name, stub = stub_, + retry = std::shared_ptr( + retry_policy(*current)), + backoff = std::shared_ptr(backoff_policy(*current))]( + Options const& options, + google::cloud::cpp::compute::hosts::v1::ListHostsRequest const& r) { + return google::cloud::rest_internal::RestRetryLoop( + retry->clone(), backoff->clone(), idempotency, + [stub]( + rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::hosts::v1::ListHostsRequest const& + request) { + return stub->ListHosts(rest_context, options, request); + }, + options, r, function_name); + }, + [](google::cloud::cpp::compute::v1::HostsListResponse r) { + std::vector result( + r.items().size()); + auto& messages = *r.mutable_items(); + std::move(messages.begin(), messages.end(), result.begin()); + return result; + }); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_hosts_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/hosts/v1/internal/hosts_rest_connection_impl.h b/google/cloud/compute/hosts/v1/internal/hosts_rest_connection_impl.h new file mode 100644 index 0000000000000..4dd7fab67d76b --- /dev/null +++ b/google/cloud/compute/hosts/v1/internal/hosts_rest_connection_impl.h @@ -0,0 +1,103 @@ +// Copyright 2026 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. +// source: google/cloud/compute/hosts/v1/hosts.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_HOSTS_V1_INTERNAL_HOSTS_REST_CONNECTION_IMPL_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_HOSTS_V1_INTERNAL_HOSTS_REST_CONNECTION_IMPL_H + +#include "google/cloud/compute/hosts/v1/hosts_connection.h" +#include "google/cloud/compute/hosts/v1/hosts_connection_idempotency_policy.h" +#include "google/cloud/compute/hosts/v1/hosts_options.h" +#include "google/cloud/compute/hosts/v1/internal/hosts_rest_stub.h" +#include "google/cloud/compute/hosts/v1/internal/hosts_retry_traits.h" +#include "google/cloud/compute/zone_operations/v1/zone_operations.pb.h" +#include "google/cloud/background_threads.h" +#include "google/cloud/backoff_policy.h" +#include "google/cloud/options.h" +#include "google/cloud/status_or.h" +#include "google/cloud/stream_range.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_hosts_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class HostsRestConnectionImpl : public compute_hosts_v1::HostsConnection { + public: + ~HostsRestConnectionImpl() override = default; + + HostsRestConnectionImpl( + std::unique_ptr background, + std::shared_ptr stub, + Options options); + + Options options() override { return options_; } + + StatusOr GetHost( + google::cloud::cpp::compute::hosts::v1::GetHostRequest const& request) + override; + + future> GetVersion( + google::cloud::cpp::compute::hosts::v1::GetVersionRequest const& request) + override; + + StatusOr GetVersion( + NoAwaitTag, + google::cloud::cpp::compute::hosts::v1::GetVersionRequest const& request) + override; + + future> GetVersion( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + StreamRange ListHosts( + google::cloud::cpp::compute::hosts::v1::ListHostsRequest request) + override; + + private: + static std::unique_ptr retry_policy( + Options const& options) { + return options.get()->clone(); + } + + static std::unique_ptr backoff_policy(Options const& options) { + return options.get()->clone(); + } + + static std::unique_ptr + idempotency_policy(Options const& options) { + return options + .get() + ->clone(); + } + + static std::unique_ptr polling_policy(Options const& options) { + return options.get()->clone(); + } + + std::unique_ptr background_; + std::shared_ptr stub_; + Options options_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_hosts_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_HOSTS_V1_INTERNAL_HOSTS_REST_CONNECTION_IMPL_H diff --git a/google/cloud/compute/hosts/v1/internal/hosts_rest_logging_decorator.cc b/google/cloud/compute/hosts/v1/internal/hosts_rest_logging_decorator.cc new file mode 100644 index 0000000000000..84af188a59f25 --- /dev/null +++ b/google/cloud/compute/hosts/v1/internal/hosts_rest_logging_decorator.cc @@ -0,0 +1,136 @@ +// Copyright 2026 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. +// source: google/cloud/compute/hosts/v1/hosts.proto + +#include "google/cloud/compute/hosts/v1/internal/hosts_rest_logging_decorator.h" +#include "google/cloud/internal/log_wrapper.h" +#include "google/cloud/status_or.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_hosts_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +HostsRestLogging::HostsRestLogging(std::shared_ptr child, + TracingOptions tracing_options, + std::set components) + : child_(std::move(child)), + tracing_options_(std::move(tracing_options)), + components_(std::move(components)) {} + +StatusOr HostsRestLogging::GetHost( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::hosts::v1::GetHostRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::hosts::v1::GetHostRequest const& + request) { + return child_->GetHost(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +future> +HostsRestLogging::AsyncGetVersion( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::hosts::v1::GetVersionRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::hosts::v1::GetVersionRequest const& + request) { + return child_->AsyncGetVersion(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +StatusOr +HostsRestLogging::GetVersion( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::hosts::v1::GetVersionRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::hosts::v1::GetVersionRequest const& + request) { + return child_->GetVersion(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +StatusOr +HostsRestLogging::ListHosts( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::hosts::v1::ListHostsRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::hosts::v1::ListHostsRequest const& + request) { + return child_->ListHosts(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +future> +HostsRestLogging::AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1::GetOperationRequest const& + request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + GetOperationRequest const& request) { + return child_->AsyncGetOperation(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +future HostsRestLogging::AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest const& request) { + return child_->AsyncCancelOperation(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_hosts_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/hosts/v1/internal/hosts_rest_logging_decorator.h b/google/cloud/compute/hosts/v1/internal/hosts_rest_logging_decorator.h new file mode 100644 index 0000000000000..d157246593b26 --- /dev/null +++ b/google/cloud/compute/hosts/v1/internal/hosts_rest_logging_decorator.h @@ -0,0 +1,96 @@ +// Copyright 2026 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. +// source: google/cloud/compute/hosts/v1/hosts.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_HOSTS_V1_INTERNAL_HOSTS_REST_LOGGING_DECORATOR_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_HOSTS_V1_INTERNAL_HOSTS_REST_LOGGING_DECORATOR_H + +#include "google/cloud/compute/hosts/v1/hosts.pb.h" +#include "google/cloud/compute/hosts/v1/internal/hosts_rest_stub.h" +#include "google/cloud/compute/zone_operations/v1/zone_operations.pb.h" +#include "google/cloud/future.h" +#include "google/cloud/internal/rest_context.h" +#include "google/cloud/tracing_options.h" +#include "google/cloud/version.h" +#include +#include +#include + +namespace google { +namespace cloud { +namespace compute_hosts_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class HostsRestLogging : public HostsRestStub { + public: + ~HostsRestLogging() override = default; + HostsRestLogging(std::shared_ptr child, + TracingOptions tracing_options, + std::set components); + + StatusOr GetHost( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::hosts::v1::GetHostRequest const& request) + override; + + future> AsyncGetVersion( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::hosts::v1::GetVersionRequest const& request) + override; + + StatusOr GetVersion( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::hosts::v1::GetVersionRequest const& request) + override; + + StatusOr ListHosts( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::hosts::v1::ListHostsRequest const& request) + override; + + future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + GetOperationRequest const& request) override; + + future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest const& request) override; + + private: + std::shared_ptr child_; + TracingOptions tracing_options_; + std::set components_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_hosts_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_HOSTS_V1_INTERNAL_HOSTS_REST_LOGGING_DECORATOR_H diff --git a/google/cloud/compute/hosts/v1/internal/hosts_rest_metadata_decorator.cc b/google/cloud/compute/hosts/v1/internal/hosts_rest_metadata_decorator.cc new file mode 100644 index 0000000000000..3b8f6a72f9318 --- /dev/null +++ b/google/cloud/compute/hosts/v1/internal/hosts_rest_metadata_decorator.cc @@ -0,0 +1,108 @@ +// Copyright 2026 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. +// source: google/cloud/compute/hosts/v1/hosts.proto + +#include "google/cloud/compute/hosts/v1/internal/hosts_rest_metadata_decorator.h" +#include "google/cloud/internal/api_client_header.h" +#include "google/cloud/internal/rest_set_metadata.h" +#include "google/cloud/status_or.h" +#include "absl/strings/str_cat.h" +#include "absl/strings/str_format.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_hosts_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +HostsRestMetadata::HostsRestMetadata(std::shared_ptr child, + std::string api_client_header) + : child_(std::move(child)), + api_client_header_( + api_client_header.empty() + ? google::cloud::internal::GeneratedLibClientHeader() + : std::move(api_client_header)) {} + +StatusOr HostsRestMetadata::GetHost( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::hosts::v1::GetHostRequest const& request) { + SetMetadata(rest_context, options); + return child_->GetHost(rest_context, options, request); +} + +future> +HostsRestMetadata::AsyncGetVersion( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::hosts::v1::GetVersionRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncGetVersion(cq, std::move(rest_context), + std::move(options), request); +} + +StatusOr +HostsRestMetadata::GetVersion( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::hosts::v1::GetVersionRequest const& request) { + SetMetadata(rest_context, options); + return child_->GetVersion(rest_context, options, request); +} + +StatusOr +HostsRestMetadata::ListHosts( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::hosts::v1::ListHostsRequest const& request) { + SetMetadata(rest_context, options); + return child_->ListHosts(rest_context, options, request); +} + +future> +HostsRestMetadata::AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1::GetOperationRequest const& + request) { + SetMetadata(*rest_context, *options); + return child_->AsyncGetOperation(cq, std::move(rest_context), + std::move(options), request); +} + +future HostsRestMetadata::AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncCancelOperation(cq, std::move(rest_context), + std::move(options), request); +} + +void HostsRestMetadata::SetMetadata(rest_internal::RestContext& rest_context, + Options const& options, + std::vector const& params) { + google::cloud::rest_internal::SetMetadata(rest_context, options, params, + api_client_header_); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_hosts_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/hosts/v1/internal/hosts_rest_metadata_decorator.h b/google/cloud/compute/hosts/v1/internal/hosts_rest_metadata_decorator.h new file mode 100644 index 0000000000000..ad4977b1651c4 --- /dev/null +++ b/google/cloud/compute/hosts/v1/internal/hosts_rest_metadata_decorator.h @@ -0,0 +1,97 @@ +// Copyright 2026 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. +// source: google/cloud/compute/hosts/v1/hosts.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_HOSTS_V1_INTERNAL_HOSTS_REST_METADATA_DECORATOR_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_HOSTS_V1_INTERNAL_HOSTS_REST_METADATA_DECORATOR_H + +#include "google/cloud/compute/hosts/v1/hosts.pb.h" +#include "google/cloud/compute/hosts/v1/internal/hosts_rest_stub.h" +#include "google/cloud/compute/zone_operations/v1/zone_operations.pb.h" +#include "google/cloud/future.h" +#include "google/cloud/rest_options.h" +#include "google/cloud/version.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_hosts_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class HostsRestMetadata : public HostsRestStub { + public: + ~HostsRestMetadata() override = default; + explicit HostsRestMetadata(std::shared_ptr child, + std::string api_client_header = ""); + + StatusOr GetHost( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::hosts::v1::GetHostRequest const& request) + override; + + google::cloud::future> + AsyncGetVersion( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::hosts::v1::GetVersionRequest const& request) + override; + + StatusOr GetVersion( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::hosts::v1::GetVersionRequest const& request) + override; + + StatusOr ListHosts( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::hosts::v1::ListHostsRequest const& request) + override; + + google::cloud::future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + GetOperationRequest const& request) override; + + google::cloud::future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest const& request) override; + + private: + void SetMetadata(rest_internal::RestContext& rest_context, + Options const& options, + std::vector const& params = {}); + + std::shared_ptr child_; + std::string api_client_header_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_hosts_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_HOSTS_V1_INTERNAL_HOSTS_REST_METADATA_DECORATOR_H diff --git a/google/cloud/compute/hosts/v1/internal/hosts_rest_stub.cc b/google/cloud/compute/hosts/v1/internal/hosts_rest_stub.cc new file mode 100644 index 0000000000000..3f485bee5f657 --- /dev/null +++ b/google/cloud/compute/hosts/v1/internal/hosts_rest_stub.cc @@ -0,0 +1,210 @@ +// Copyright 2026 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. +// source: google/cloud/compute/hosts/v1/hosts.proto + +#include "google/cloud/compute/hosts/v1/internal/hosts_rest_stub.h" +#include "google/cloud/compute/hosts/v1/hosts.pb.h" +#include "google/cloud/compute/zone_operations/v1/zone_operations.pb.h" +#include "google/cloud/common_options.h" +#include "google/cloud/internal/rest_stub_helpers.h" +#include "google/cloud/status_or.h" +#include "absl/strings/str_cat.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_hosts_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +DefaultHostsRestStub::DefaultHostsRestStub(Options options) + : service_(rest_internal::MakePooledRestClient( + options.get(), options)), + operations_(rest_internal::MakePooledRestClient( + options.get(), options)), + options_(std::move(options)) {} + +DefaultHostsRestStub::DefaultHostsRestStub( + std::shared_ptr service, + std::shared_ptr operations, Options options) + : service_(std::move(service)), + operations_(std::move(operations)), + options_(std::move(options)) {} + +StatusOr DefaultHostsRestStub::GetHost( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::hosts::v1::GetHostRequest const& request) { + std::vector> query_params; + return rest_internal::Get( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "zones", "/", + request.zone(), "/", request.association(), "/", "hosts", + "/", request.host()), + std::move(query_params)); +} + +future> +DefaultHostsRestStub::AsyncGetVersion( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::hosts::v1::GetVersionRequest const& request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto service, auto request, auto rest_context, auto options) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + p.set_value( + rest_internal::Post( + *service, *rest_context, + request.hosts_get_version_request_resource(), false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", *options), + "/", "projects", "/", request.project(), "/", + "zones", "/", request.zone(), "/", + request.association(), "/", "hosts", "/", + request.host(), "/", "getVersion"), + std::move(query_params))); + }, + std::move(p), + service_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +StatusOr +DefaultHostsRestStub::GetVersion( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::hosts::v1::GetVersionRequest const& request) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Post( + *service_, rest_context, request.hosts_get_version_request_resource(), + false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "zones", "/", + request.zone(), "/", request.association(), "/", "hosts", + "/", request.host(), "/", "getVersion"), + std::move(query_params)); +} + +StatusOr +DefaultHostsRestStub::ListHosts( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::hosts::v1::ListHostsRequest const& request) { + std::vector> query_params; + query_params.push_back({"filter", request.filter()}); + query_params.push_back( + {"max_results", std::to_string(request.max_results())}); + query_params.push_back({"order_by", request.order_by()}); + query_params.push_back({"page_token", request.page_token()}); + query_params.push_back({"return_partial_success", + (request.return_partial_success() ? "1" : "0")}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Get( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "zones", "/", + request.zone(), "/", request.association(), "/", "hosts"), + std::move(query_params)); +} + +future> +DefaultHostsRestStub::AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1::GetOperationRequest const& + request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto operations, auto request, auto rest_context, + auto options) { + p.set_value( + rest_internal::Get( + *operations, *rest_context, request, false, + absl::StrCat("/compute/", + rest_internal::DetermineApiVersion("v1", *options), + "/projects/", request.project(), "/zones/", + request.zone(), "/operations/", + request.operation()))); + }, + std::move(p), + operations_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +future DefaultHostsRestStub::AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest const& request) { + promise> p; + future> f = p.get_future(); + std::thread t{ + [](auto p, auto operations, auto request, auto rest_context, + auto options) { + p.set_value(rest_internal::Post( + *operations, *rest_context, request, false, + absl::StrCat("/compute/", + rest_internal::DetermineApiVersion("v1", *options), + "/projects/", request.project(), "/zones/", + request.zone(), "/operations/", request.operation()))); + }, + std::move(p), + operations_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get().status(); + }); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_hosts_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/hosts/v1/internal/hosts_rest_stub.h b/google/cloud/compute/hosts/v1/internal/hosts_rest_stub.h new file mode 100644 index 0000000000000..68638f1224ce8 --- /dev/null +++ b/google/cloud/compute/hosts/v1/internal/hosts_rest_stub.h @@ -0,0 +1,142 @@ +// Copyright 2026 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. +// source: google/cloud/compute/hosts/v1/hosts.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_HOSTS_V1_INTERNAL_HOSTS_REST_STUB_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_HOSTS_V1_INTERNAL_HOSTS_REST_STUB_H + +#include "google/cloud/compute/hosts/v1/hosts.pb.h" +#include "google/cloud/compute/zone_operations/v1/zone_operations.pb.h" +#include "google/cloud/completion_queue.h" +#include "google/cloud/internal/rest_client.h" +#include "google/cloud/internal/rest_context.h" +#include "google/cloud/status_or.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_hosts_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class HostsRestStub { + public: + virtual ~HostsRestStub() = default; + + virtual StatusOr GetHost( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::hosts::v1::GetHostRequest const& + request) = 0; + + virtual future> + AsyncGetVersion( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::hosts::v1::GetVersionRequest const& + request) = 0; + + virtual StatusOr GetVersion( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::hosts::v1::GetVersionRequest const& + request) = 0; + + virtual StatusOr + ListHosts(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::hosts::v1::ListHostsRequest const& + request) = 0; + + virtual future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + GetOperationRequest const& request) = 0; + + virtual future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest const& request) = 0; +}; + +class DefaultHostsRestStub : public HostsRestStub { + public: + ~DefaultHostsRestStub() override = default; + + explicit DefaultHostsRestStub(Options options); + DefaultHostsRestStub(std::shared_ptr service, + std::shared_ptr operations, + Options options); + + StatusOr GetHost( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::hosts::v1::GetHostRequest const& request) + override; + + future> AsyncGetVersion( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::hosts::v1::GetVersionRequest const& request) + override; + + StatusOr GetVersion( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::hosts::v1::GetVersionRequest const& request) + override; + + StatusOr ListHosts( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::hosts::v1::ListHostsRequest const& request) + override; + + future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + GetOperationRequest const& request) override; + + future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest const& request) override; + + private: + std::shared_ptr service_; + std::shared_ptr operations_; + Options options_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_hosts_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_HOSTS_V1_INTERNAL_HOSTS_REST_STUB_H diff --git a/google/cloud/compute/hosts/v1/internal/hosts_rest_stub_factory.cc b/google/cloud/compute/hosts/v1/internal/hosts_rest_stub_factory.cc new file mode 100644 index 0000000000000..d7d5b0356ceee --- /dev/null +++ b/google/cloud/compute/hosts/v1/internal/hosts_rest_stub_factory.cc @@ -0,0 +1,56 @@ +// Copyright 2026 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. +// source: google/cloud/compute/hosts/v1/hosts.proto + +#include "google/cloud/compute/hosts/v1/internal/hosts_rest_stub_factory.h" +#include "google/cloud/compute/hosts/v1/internal/hosts_rest_logging_decorator.h" +#include "google/cloud/compute/hosts/v1/internal/hosts_rest_metadata_decorator.h" +#include "google/cloud/compute/hosts/v1/internal/hosts_rest_stub.h" +#include "google/cloud/common_options.h" +#include "google/cloud/internal/algorithm.h" +#include "google/cloud/internal/populate_rest_options.h" +#include "google/cloud/log.h" +#include "google/cloud/options.h" +#include "google/cloud/rest_options.h" +#include "absl/strings/match.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_hosts_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +std::shared_ptr CreateDefaultHostsRestStub( + Options const& options) { + auto opts = internal::PopulateRestOptions(options); + std::shared_ptr stub = + std::make_shared(std::move(opts)); + stub = std::make_shared(std::move(stub)); + if (internal::Contains(options.get(), "rpc")) { + GCP_LOG(INFO) << "Enabled logging for REST rpc calls"; + stub = std::make_shared( + std::move(stub), options.get(), + options.get()); + } + return stub; +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_hosts_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/hosts/v1/internal/hosts_rest_stub_factory.h b/google/cloud/compute/hosts/v1/internal/hosts_rest_stub_factory.h new file mode 100644 index 0000000000000..70dbf6d00a178 --- /dev/null +++ b/google/cloud/compute/hosts/v1/internal/hosts_rest_stub_factory.h @@ -0,0 +1,40 @@ +// Copyright 2026 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. +// source: google/cloud/compute/hosts/v1/hosts.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_HOSTS_V1_INTERNAL_HOSTS_REST_STUB_FACTORY_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_HOSTS_V1_INTERNAL_HOSTS_REST_STUB_FACTORY_H + +#include "google/cloud/compute/hosts/v1/internal/hosts_rest_stub.h" +#include "google/cloud/options.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_hosts_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +std::shared_ptr CreateDefaultHostsRestStub( + Options const& options); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_hosts_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_HOSTS_V1_INTERNAL_HOSTS_REST_STUB_FACTORY_H diff --git a/google/cloud/compute/hosts/v1/internal/hosts_retry_traits.h b/google/cloud/compute/hosts/v1/internal/hosts_retry_traits.h new file mode 100644 index 0000000000000..64c42cd8de787 --- /dev/null +++ b/google/cloud/compute/hosts/v1/internal/hosts_retry_traits.h @@ -0,0 +1,43 @@ +// Copyright 2026 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. +// source: google/cloud/compute/hosts/v1/hosts.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_HOSTS_V1_INTERNAL_HOSTS_RETRY_TRAITS_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_HOSTS_V1_INTERNAL_HOSTS_RETRY_TRAITS_H + +#include "google/cloud/status.h" +#include "google/cloud/version.h" + +namespace google { +namespace cloud { +namespace compute_hosts_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/// Define the gRPC status code semantics for retrying requests. +struct HostsRetryTraits { + static bool IsPermanentFailure(google::cloud::Status const& status) { + return status.code() != StatusCode::kOk && + status.code() != StatusCode::kUnavailable; + } +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_hosts_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_HOSTS_V1_INTERNAL_HOSTS_RETRY_TRAITS_H diff --git a/google/cloud/compute/hosts/v1/internal/hosts_sources.cc b/google/cloud/compute/hosts/v1/internal/hosts_sources.cc new file mode 100644 index 0000000000000..1b162e28c4076 --- /dev/null +++ b/google/cloud/compute/hosts/v1/internal/hosts_sources.cc @@ -0,0 +1,31 @@ +// Copyright 2026 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. +// source: google/cloud/compute/hosts/v1/hosts.proto + +// NOLINTBEGIN(bugprone-suspicious-include) +#include "google/cloud/compute/hosts/v1/hosts_client.cc" +#include "google/cloud/compute/hosts/v1/hosts_connection.cc" +#include "google/cloud/compute/hosts/v1/hosts_connection_idempotency_policy.cc" +#include "google/cloud/compute/hosts/v1/hosts_rest_connection.cc" +#include "google/cloud/compute/hosts/v1/internal/hosts_option_defaults.cc" +#include "google/cloud/compute/hosts/v1/internal/hosts_rest_connection_impl.cc" +#include "google/cloud/compute/hosts/v1/internal/hosts_rest_logging_decorator.cc" +#include "google/cloud/compute/hosts/v1/internal/hosts_rest_metadata_decorator.cc" +#include "google/cloud/compute/hosts/v1/internal/hosts_rest_stub.cc" +#include "google/cloud/compute/hosts/v1/internal/hosts_rest_stub_factory.cc" +#include "google/cloud/compute/hosts/v1/internal/hosts_tracing_connection.cc" +// NOLINTEND(bugprone-suspicious-include) diff --git a/google/cloud/compute/hosts/v1/internal/hosts_tracing_connection.cc b/google/cloud/compute/hosts/v1/internal/hosts_tracing_connection.cc new file mode 100644 index 0000000000000..c56d995168f38 --- /dev/null +++ b/google/cloud/compute/hosts/v1/internal/hosts_tracing_connection.cc @@ -0,0 +1,91 @@ +// Copyright 2026 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. +// source: google/cloud/compute/hosts/v1/hosts.proto + +#include "google/cloud/compute/hosts/v1/internal/hosts_tracing_connection.h" +#include "google/cloud/internal/opentelemetry.h" +#include "google/cloud/internal/traced_stream_range.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_hosts_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +HostsTracingConnection::HostsTracingConnection( + std::shared_ptr child) + : child_(std::move(child)) {} + +StatusOr HostsTracingConnection::GetHost( + google::cloud::cpp::compute::hosts::v1::GetHostRequest const& request) { + auto span = internal::MakeSpan("compute_hosts_v1::HostsConnection::GetHost"); + auto scope = opentelemetry::trace::Scope(span); + return internal::EndSpan(*span, child_->GetHost(request)); +} + +future> +HostsTracingConnection::GetVersion( + google::cloud::cpp::compute::hosts::v1::GetVersionRequest const& request) { + auto span = + internal::MakeSpan("compute_hosts_v1::HostsConnection::GetVersion"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), child_->GetVersion(request)); +} + +StatusOr +HostsTracingConnection::GetVersion( + NoAwaitTag, + google::cloud::cpp::compute::hosts::v1::GetVersionRequest const& request) { + auto span = + internal::MakeSpan("compute_hosts_v1::HostsConnection::GetVersion"); + opentelemetry::trace::Scope scope(span); + return internal::EndSpan(*span, child_->GetVersion(NoAwaitTag{}, request)); +} + +future> +HostsTracingConnection::GetVersion( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto span = + internal::MakeSpan("compute_hosts_v1::HostsConnection::GetVersion"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), child_->GetVersion(operation)); +} + +StreamRange +HostsTracingConnection::ListHosts( + google::cloud::cpp::compute::hosts::v1::ListHostsRequest request) { + auto span = + internal::MakeSpan("compute_hosts_v1::HostsConnection::ListHosts"); + internal::OTelScope scope(span); + auto sr = child_->ListHosts(std::move(request)); + return internal::MakeTracedStreamRange( + std::move(span), std::move(sr)); +} + +std::shared_ptr MakeHostsTracingConnection( + std::shared_ptr conn) { + if (internal::TracingEnabled(conn->options())) { + conn = std::make_shared(std::move(conn)); + } + return conn; +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_hosts_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/hosts/v1/internal/hosts_tracing_connection.h b/google/cloud/compute/hosts/v1/internal/hosts_tracing_connection.h new file mode 100644 index 0000000000000..fd6a3f92deb69 --- /dev/null +++ b/google/cloud/compute/hosts/v1/internal/hosts_tracing_connection.h @@ -0,0 +1,78 @@ +// Copyright 2026 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. +// source: google/cloud/compute/hosts/v1/hosts.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_HOSTS_V1_INTERNAL_HOSTS_TRACING_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_HOSTS_V1_INTERNAL_HOSTS_TRACING_CONNECTION_H + +#include "google/cloud/compute/hosts/v1/hosts_connection.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_hosts_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class HostsTracingConnection : public compute_hosts_v1::HostsConnection { + public: + ~HostsTracingConnection() override = default; + + explicit HostsTracingConnection( + std::shared_ptr child); + + Options options() override { return child_->options(); } + + StatusOr GetHost( + google::cloud::cpp::compute::hosts::v1::GetHostRequest const& request) + override; + + future> GetVersion( + google::cloud::cpp::compute::hosts::v1::GetVersionRequest const& request) + override; + + StatusOr GetVersion( + NoAwaitTag, + google::cloud::cpp::compute::hosts::v1::GetVersionRequest const& request) + override; + + future> GetVersion( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + StreamRange ListHosts( + google::cloud::cpp::compute::hosts::v1::ListHostsRequest request) + override; + + private: + std::shared_ptr child_; +}; + +/** + * Conditionally applies the tracing decorator to the given connection. + * + * The connection is only decorated if tracing is enabled (as determined by the + * connection's options). + */ +std::shared_ptr MakeHostsTracingConnection( + std::shared_ptr conn); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_hosts_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_HOSTS_V1_INTERNAL_HOSTS_TRACING_CONNECTION_H diff --git a/google/cloud/compute/hosts/v1/mocks/mock_hosts_connection.h b/google/cloud/compute/hosts/v1/mocks/mock_hosts_connection.h new file mode 100644 index 0000000000000..d2efc84c3e944 --- /dev/null +++ b/google/cloud/compute/hosts/v1/mocks/mock_hosts_connection.h @@ -0,0 +1,105 @@ +// Copyright 2026 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. +// source: google/cloud/compute/hosts/v1/hosts.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_HOSTS_V1_MOCKS_MOCK_HOSTS_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_HOSTS_V1_MOCKS_MOCK_HOSTS_CONNECTION_H + +#include "google/cloud/compute/hosts/v1/hosts_connection.h" +#include + +namespace google { +namespace cloud { +namespace compute_hosts_v1_mocks { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/** + * A class to mock `HostsConnection`. + * + * Application developers may want to test their code with simulated responses, + * including errors, from an object of type `HostsClient`. To do so, + * construct an object of type `HostsClient` with an instance of this + * class. Then use the Google Test framework functions to program the behavior + * of this mock. + * + * @see [This example][bq-mock] for how to test your application with GoogleTest. + * While the example showcases types from the BigQuery library, the underlying + * principles apply for any pair of `*Client` and `*Connection`. + * + * [bq-mock]: @cloud_cpp_docs_link{bigquery,bigquery-read-mock} + */ +class MockHostsConnection : public compute_hosts_v1::HostsConnection { + public: + MOCK_METHOD(Options, options, (), (override)); + + MOCK_METHOD( + StatusOr, GetHost, + (google::cloud::cpp::compute::hosts::v1::GetHostRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// GetVersion(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + GetVersion, + (google::cloud::cpp::compute::hosts::v1::GetVersionRequest const& + request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// EXPECT_CALL(*mock, GetVersion(_, _)) + /// @endcode + MOCK_METHOD(StatusOr, GetVersion, + (NoAwaitTag, + google::cloud::cpp::compute::hosts::v1::GetVersionRequest const& + request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// GetVersion(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + GetVersion, + (google::cloud::cpp::compute::v1::Operation const& operation), + (override)); + + MOCK_METHOD( + (StreamRange), ListHosts, + (google::cloud::cpp::compute::hosts::v1::ListHostsRequest request), + (override)); +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_hosts_v1_mocks +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_HOSTS_V1_MOCKS_MOCK_HOSTS_CONNECTION_H diff --git a/google/cloud/compute/hosts/v1/samples/hosts_client_samples.cc b/google/cloud/compute/hosts/v1/samples/hosts_client_samples.cc new file mode 100644 index 0000000000000..f37277e156afe --- /dev/null +++ b/google/cloud/compute/hosts/v1/samples/hosts_client_samples.cc @@ -0,0 +1,224 @@ +// Copyright 2026 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. +// source: google/cloud/compute/hosts/v1/hosts.proto + +#include "google/cloud/compute/hosts/v1/hosts_client.h" +#include "google/cloud/compute/hosts/v1/hosts_connection_idempotency_policy.h" +#include "google/cloud/compute/hosts/v1/hosts_options.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/internal/getenv.h" +#include "google/cloud/polling_policy.h" +#include "google/cloud/testing_util/example_driver.h" +#include "google/cloud/universe_domain.h" +#include +#include +#include +#include + +// clang-format off +// main-dox-marker: compute_hosts_v1::HostsClient +// lro-marker: true +// clang-format on +namespace { + +void SetClientEndpoint(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-endpoint"}; + } + //! [set-client-endpoint] + // This configuration is common with Private Google Access: + // https://cloud.google.com/vpc/docs/private-google-access + auto options = google::cloud::Options{}.set( + "private.googleapis.com"); + auto vpc_client = google::cloud::compute_hosts_v1::HostsClient( + google::cloud::compute_hosts_v1::MakeHostsConnectionRest(options)); + //! [set-client-endpoint] +} + +void SetClientUniverseDomain(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-universe-domain"}; + } + //! [set-client-universe-domain] + google::cloud::Options options; + + // AddUniverseDomainOption interrogates the UnifiedCredentialsOption, if set, + // in the provided Options for the Universe Domain associated with the + // credentials and adds it to the set of Options. + // If no UnifiedCredentialsOption is set, GoogleDefaultCredentials are used. + auto ud_options = google::cloud::AddUniverseDomainOption(std::move(options)); + + if (!ud_options.ok()) throw std::move(ud_options).status(); + auto ud_client = google::cloud::compute_hosts_v1::HostsClient( + google::cloud::compute_hosts_v1::MakeHostsConnectionRest(*ud_options)); + //! [set-client-universe-domain] +} + +//! [custom-idempotency-policy] +class CustomIdempotencyPolicy + : public google::cloud::compute_hosts_v1::HostsConnectionIdempotencyPolicy { + public: + ~CustomIdempotencyPolicy() override = default; + std::unique_ptr< + google::cloud::compute_hosts_v1::HostsConnectionIdempotencyPolicy> + clone() const override { + return std::make_unique(*this); + } + // Override inherited functions to define as needed. +}; +//! [custom-idempotency-policy] + +void SetRetryPolicy(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-retry-policy"}; + } + //! [set-retry-policy] + auto options = + google::cloud::Options{} + .set( + CustomIdempotencyPolicy().clone()) + .set( + google::cloud::compute_hosts_v1:: + HostsLimitedErrorCountRetryPolicy(3) + .clone()) + .set( + google::cloud::ExponentialBackoffPolicy( + /*initial_delay=*/std::chrono::milliseconds(200), + /*maximum_delay=*/std::chrono::seconds(45), + /*scaling=*/2.0) + .clone()); + auto connection = + google::cloud::compute_hosts_v1::MakeHostsConnectionRest(options); + + // c1 and c2 share the same retry policies + auto c1 = google::cloud::compute_hosts_v1::HostsClient(connection); + auto c2 = google::cloud::compute_hosts_v1::HostsClient(connection); + + // You can override any of the policies in a new client. This new client + // will share the policies from c1 (or c2) *except* for the retry policy. + auto c3 = google::cloud::compute_hosts_v1::HostsClient( + connection, + google::cloud::Options{} + .set( + google::cloud::compute_hosts_v1::HostsLimitedTimeRetryPolicy( + std::chrono::minutes(5)) + .clone())); + + // You can also override the policies in a single call: + // c3.SomeRpc(..., google::cloud::Options{} + // .set( + // google::cloud::compute_hosts_v1::HostsLimitedErrorCountRetryPolicy(10).clone())); + //! [set-retry-policy] +} + +void SetPollingPolicy(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-policy-policy"}; + } + //! [set-polling-policy] + + // The polling policy controls how the client waits for long-running + // operations. `GenericPollingPolicy<>` combines existing policies. + // In this case, keep polling until the operation completes (with success + // or error) or 45 minutes, whichever happens first. Initially pause for + // 10 seconds between polling requests, increasing the pause by a factor + // of 4 until it becomes 2 minutes. + auto options = + google::cloud::Options{} + .set( + google::cloud::GenericPollingPolicy< + google::cloud::compute_hosts_v1::HostsRetryPolicyOption::Type, + google::cloud::compute_hosts_v1::HostsBackoffPolicyOption:: + Type>( + google::cloud::compute_hosts_v1::HostsLimitedTimeRetryPolicy( + /*maximum_duration=*/std::chrono::minutes(45)) + .clone(), + google::cloud::ExponentialBackoffPolicy( + /*initial_delay=*/std::chrono::seconds(10), + /*maximum_delay=*/std::chrono::minutes(2), + /*scaling=*/4.0) + .clone()) + .clone()); + + auto connection = + google::cloud::compute_hosts_v1::MakeHostsConnectionRest(options); + + // c1 and c2 share the same polling policies. + auto c1 = google::cloud::compute_hosts_v1::HostsClient(connection); + auto c2 = google::cloud::compute_hosts_v1::HostsClient(connection); + //! [set-polling-policy] +} + +void WithServiceAccount(std::vector const& argv) { + if (argv.size() != 1 || argv[0] == "--help") { + throw google::cloud::testing_util::Usage{"with-service-account "}; + } + //! [with-service-account] + [](std::string const& keyfile) { + auto is = std::ifstream(keyfile); + is.exceptions(std::ios::badbit); // Minimal error handling in examples + auto contents = std::string(std::istreambuf_iterator(is.rdbuf()), {}); + auto options = + google::cloud::Options{}.set( + google::cloud::MakeServiceAccountCredentials(contents)); + return google::cloud::compute_hosts_v1::HostsClient( + google::cloud::compute_hosts_v1::MakeHostsConnectionRest(options)); + } + //! [with-service-account] + (argv.at(0)); +} + +void AutoRun(std::vector const& argv) { + namespace examples = ::google::cloud::testing_util; + using ::google::cloud::internal::GetEnv; + if (!argv.empty()) throw examples::Usage{"auto"}; + examples::CheckEnvironmentVariablesAreSet( + {"GOOGLE_CLOUD_CPP_TEST_SERVICE_ACCOUNT_KEYFILE"}); + auto const keyfile = + GetEnv("GOOGLE_CLOUD_CPP_TEST_SERVICE_ACCOUNT_KEYFILE").value(); + + std::cout << "\nRunning SetClientEndpoint() example" << std::endl; + SetClientEndpoint({}); + + std::cout << "\nRunning SetRetryPolicy() example" << std::endl; + SetRetryPolicy({}); + + std::cout << "\nRunning SetPollingPolicy() example" << std::endl; + SetPollingPolicy({}); + + std::cout << "\nRunning WithServiceAccount() example" << std::endl; + WithServiceAccount({keyfile}); + + std::cout << "\nRunning SetClientUniverseDomain() example" << std::endl; + SetClientUniverseDomain({}); +} + +} // namespace + +int main(int argc, char* argv[]) { // NOLINT(bugprone-exception-escape) + google::cloud::testing_util::Example example({ + {"set-client-endpoint", SetClientEndpoint}, + {"set-retry-policy", SetRetryPolicy}, + {"set-polling-policy", SetPollingPolicy}, + {"with-service-account", WithServiceAccount}, + {"set-client-universe-domain", SetClientUniverseDomain}, + {"auto", AutoRun}, + }); + return example.Run(argc, argv); +} diff --git a/google/cloud/compute/http_health_checks/v1/http_health_checks_client.cc b/google/cloud/compute/http_health_checks/v1/http_health_checks_client.cc index f8c61aa1efbb2..779bff71dd57e 100644 --- a/google/cloud/compute/http_health_checks/v1/http_health_checks_client.cc +++ b/google/cloud/compute/http_health_checks/v1/http_health_checks_client.cc @@ -233,6 +233,31 @@ HttpHealthChecksClient::PatchHttpHealthCheck( return connection_->PatchHttpHealthCheck(operation); } +StatusOr +HttpHealthChecksClient::TestIamPermissions( + std::string const& project, std::string const& resource, + google::cloud::cpp::compute::v1::TestPermissionsRequest const& + test_permissions_request_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::http_health_checks::v1::TestIamPermissionsRequest + request; + request.set_project(project); + request.set_resource(resource); + *request.mutable_test_permissions_request_resource() = + test_permissions_request_resource; + return connection_->TestIamPermissions(request); +} + +StatusOr +HttpHealthChecksClient::TestIamPermissions( + google::cloud::cpp::compute::http_health_checks::v1:: + TestIamPermissionsRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->TestIamPermissions(request); +} + future> HttpHealthChecksClient::UpdateHttpHealthCheck( std::string const& project, std::string const& http_health_check, 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..12c187bc382cd 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 @@ -115,7 +115,7 @@ class HttpHealthChecksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.http_health_checks.v1.DeleteHttpHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/http_health_checks/v1/http_health_checks.proto#L116} + /// [google.cloud.cpp.compute.http_health_checks.v1.DeleteHttpHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/http_health_checks/v1/http_health_checks.proto#L130} /// // clang-format on future> @@ -169,7 +169,7 @@ class HttpHealthChecksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.http_health_checks.v1.DeleteHttpHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/http_health_checks/v1/http_health_checks.proto#L116} + /// [google.cloud.cpp.compute.http_health_checks.v1.DeleteHttpHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/http_health_checks/v1/http_health_checks.proto#L130} /// // clang-format on future> @@ -228,8 +228,8 @@ class HttpHealthChecksClient { /// [`future`]: @ref google::cloud::future /// [`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.http_health_checks.v1.GetHttpHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/http_health_checks/v1/http_health_checks.proto#L159} + /// [google.cloud.cpp.compute.v1.HttpHealthCheck]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_067.proto#L33} /// // clang-format on StatusOr GetHttpHealthCheck( @@ -260,8 +260,8 @@ class HttpHealthChecksClient { /// [`future`]: @ref google::cloud::future /// [`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.http_health_checks.v1.GetHttpHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/http_health_checks/v1/http_health_checks.proto#L159} + /// [google.cloud.cpp.compute.v1.HttpHealthCheck]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_067.proto#L33} /// // clang-format on StatusOr GetHttpHealthCheck( @@ -297,7 +297,7 @@ class HttpHealthChecksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.http_health_checks.v1.InsertHttpHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/http_health_checks/v1/http_health_checks.proto#L153} + /// [google.cloud.cpp.compute.http_health_checks.v1.InsertHttpHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/http_health_checks/v1/http_health_checks.proto#L170} /// // clang-format on future> @@ -355,7 +355,7 @@ class HttpHealthChecksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.http_health_checks.v1.InsertHttpHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/http_health_checks/v1/http_health_checks.proto#L153} + /// [google.cloud.cpp.compute.http_health_checks.v1.InsertHttpHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/http_health_checks/v1/http_health_checks.proto#L170} /// // clang-format on future> @@ -423,8 +423,8 @@ class HttpHealthChecksClient { /// [`future`]: @ref google::cloud::future /// [`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.http_health_checks.v1.ListHttpHealthChecksRequest]: @cloud_cpp_reference_link{google/cloud/compute/http_health_checks/v1/http_health_checks.proto#L199} + /// [google.cloud.cpp.compute.v1.HttpHealthCheck]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_067.proto#L33} /// // clang-format on StreamRange @@ -464,8 +464,8 @@ class HttpHealthChecksClient { /// [`future`]: @ref google::cloud::future /// [`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.http_health_checks.v1.ListHttpHealthChecksRequest]: @cloud_cpp_reference_link{google/cloud/compute/http_health_checks/v1/http_health_checks.proto#L199} + /// [google.cloud.cpp.compute.v1.HttpHealthCheck]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_067.proto#L33} /// // clang-format on StreamRange @@ -476,8 +476,9 @@ class HttpHealthChecksClient { // clang-format off /// /// 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. + /// included in the request. This method supportsPATCH + /// semantics and uses theJSON merge + /// patch format and processing rules. /// https://cloud.google.com/compute/docs/reference/rest/v1/httpHealthChecks/patch /// /// @param project Project ID for this request. @@ -503,7 +504,7 @@ class HttpHealthChecksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.http_health_checks.v1.PatchHttpHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/http_health_checks/v1/http_health_checks.proto#L247} + /// [google.cloud.cpp.compute.http_health_checks.v1.PatchHttpHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/http_health_checks/v1/http_health_checks.proto#L300} /// // clang-format on future> @@ -534,8 +535,9 @@ class HttpHealthChecksClient { // clang-format off /// /// 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. + /// included in the request. This method supportsPATCH + /// semantics and uses theJSON merge + /// patch format and processing rules. /// https://cloud.google.com/compute/docs/reference/rest/v1/httpHealthChecks/patch /// /// @param request Unary RPCs, such as the one wrapped by this @@ -564,7 +566,7 @@ class HttpHealthChecksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.http_health_checks.v1.PatchHttpHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/http_health_checks/v1/http_health_checks.proto#L247} + /// [google.cloud.cpp.compute.http_health_checks.v1.PatchHttpHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/http_health_checks/v1/http_health_checks.proto#L300} /// // clang-format on future> @@ -603,6 +605,71 @@ class HttpHealthChecksClient { google::cloud::cpp::compute::v1::Operation const& operation, Options opts = {}); + // clang-format off + /// + /// Returns permissions that a caller has on the specified resource. + /// https://cloud.google.com/compute/docs/reference/rest/v1/httpHealthChecks/testIamPermissions + /// + /// @param project Project ID for this request. + /// @param resource Name or id of the resource for this request. + /// @param test_permissions_request_resource The TestPermissionsRequest for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.TestPermissionsResponse]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.http_health_checks.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/http_health_checks/v1/http_health_checks.proto#L333} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} + /// + // clang-format on + StatusOr + TestIamPermissions( + std::string const& project, std::string const& resource, + google::cloud::cpp::compute::v1::TestPermissionsRequest const& + test_permissions_request_resource, + Options opts = {}); + + // clang-format off + /// + /// Returns permissions that a caller has on the specified resource. + /// https://cloud.google.com/compute/docs/reference/rest/v1/httpHealthChecks/testIamPermissions + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.http_health_checks.v1.TestIamPermissionsRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.TestPermissionsResponse]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.http_health_checks.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/http_health_checks/v1/http_health_checks.proto#L333} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} + /// + // clang-format on + StatusOr + TestIamPermissions(google::cloud::cpp::compute::http_health_checks::v1:: + TestIamPermissionsRequest const& request, + Options opts = {}); + // clang-format off /// /// Updates a HttpHealthCheck resource in the specified project using the data @@ -632,7 +699,7 @@ class HttpHealthChecksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.http_health_checks.v1.UpdateHttpHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/http_health_checks/v1/http_health_checks.proto#L277} + /// [google.cloud.cpp.compute.http_health_checks.v1.UpdateHttpHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/http_health_checks/v1/http_health_checks.proto#L348} /// // clang-format on future> @@ -692,7 +759,7 @@ class HttpHealthChecksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.http_health_checks.v1.UpdateHttpHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/http_health_checks/v1/http_health_checks.proto#L277} + /// [google.cloud.cpp.compute.http_health_checks.v1.UpdateHttpHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/http_health_checks/v1/http_health_checks.proto#L348} /// // clang-format on future> diff --git a/google/cloud/compute/http_health_checks/v1/http_health_checks_connection.cc b/google/cloud/compute/http_health_checks/v1/http_health_checks_connection.cc index 77a7512c8f0a6..7204d15a3d28b 100644 --- a/google/cloud/compute/http_health_checks/v1/http_health_checks_connection.cc +++ b/google/cloud/compute/http_health_checks/v1/http_health_checks_connection.cc @@ -126,6 +126,13 @@ HttpHealthChecksConnection::PatchHttpHealthCheck( Status(StatusCode::kUnimplemented, "not implemented")); } +StatusOr +HttpHealthChecksConnection::TestIamPermissions( + google::cloud::cpp::compute::http_health_checks::v1:: + TestIamPermissionsRequest const&) { + return Status(StatusCode::kUnimplemented, "not implemented"); +} + future> HttpHealthChecksConnection::UpdateHttpHealthCheck( google::cloud::cpp::compute::http_health_checks::v1:: diff --git a/google/cloud/compute/http_health_checks/v1/http_health_checks_connection.h b/google/cloud/compute/http_health_checks/v1/http_health_checks_connection.h index bfbd229fb0c98..ac2dc39de1b81 100644 --- a/google/cloud/compute/http_health_checks/v1/http_health_checks_connection.h +++ b/google/cloud/compute/http_health_checks/v1/http_health_checks_connection.h @@ -234,6 +234,10 @@ class HttpHealthChecksConnection { PatchHttpHealthCheck( google::cloud::cpp::compute::v1::Operation const& operation); + virtual StatusOr + TestIamPermissions(google::cloud::cpp::compute::http_health_checks::v1:: + TestIamPermissionsRequest const& request); + virtual future> UpdateHttpHealthCheck(google::cloud::cpp::compute::http_health_checks::v1:: UpdateHttpHealthCheckRequest const& request); diff --git a/google/cloud/compute/http_health_checks/v1/http_health_checks_connection_idempotency_policy.cc b/google/cloud/compute/http_health_checks/v1/http_health_checks_connection_idempotency_policy.cc index f2e289172f2e5..1b12a8b1c3c29 100644 --- a/google/cloud/compute/http_health_checks/v1/http_health_checks_connection_idempotency_policy.cc +++ b/google/cloud/compute/http_health_checks/v1/http_health_checks_connection_idempotency_policy.cc @@ -64,6 +64,12 @@ Idempotency HttpHealthChecksConnectionIdempotencyPolicy::PatchHttpHealthCheck( return Idempotency::kNonIdempotent; } +Idempotency HttpHealthChecksConnectionIdempotencyPolicy::TestIamPermissions( + google::cloud::cpp::compute::http_health_checks::v1:: + TestIamPermissionsRequest const&) { + return Idempotency::kNonIdempotent; +} + Idempotency HttpHealthChecksConnectionIdempotencyPolicy::UpdateHttpHealthCheck( google::cloud::cpp::compute::http_health_checks::v1:: UpdateHttpHealthCheckRequest const&) { diff --git a/google/cloud/compute/http_health_checks/v1/http_health_checks_connection_idempotency_policy.h b/google/cloud/compute/http_health_checks/v1/http_health_checks_connection_idempotency_policy.h index 0331861527f92..ee8ad3092b162 100644 --- a/google/cloud/compute/http_health_checks/v1/http_health_checks_connection_idempotency_policy.h +++ b/google/cloud/compute/http_health_checks/v1/http_health_checks_connection_idempotency_policy.h @@ -57,6 +57,10 @@ class HttpHealthChecksConnectionIdempotencyPolicy { google::cloud::cpp::compute::http_health_checks::v1:: PatchHttpHealthCheckRequest const& request); + virtual google::cloud::Idempotency TestIamPermissions( + google::cloud::cpp::compute::http_health_checks::v1:: + TestIamPermissionsRequest const& request); + virtual google::cloud::Idempotency UpdateHttpHealthCheck( google::cloud::cpp::compute::http_health_checks::v1:: UpdateHttpHealthCheckRequest const& request); 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 a13ad208156f7..9b358247a2f8a 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,9 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_HTTP_HEALTH_CHECKS_V1_HTTP_HEALTH_CHECKS_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_053.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_067.pb.h" +#include "google/cloud/compute/v1/internal/common_171.pb.h" // 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/http_health_checks/v1/internal/http_health_checks_rest_connection_impl.cc b/google/cloud/compute/http_health_checks/v1/internal/http_health_checks_rest_connection_impl.cc index 03bfc4179707e..4741b7c13efc9 100644 --- a/google/cloud/compute/http_health_checks/v1/internal/http_health_checks_rest_connection_impl.cc +++ b/google/cloud/compute/http_health_checks/v1/internal/http_health_checks_rest_connection_impl.cc @@ -481,6 +481,22 @@ HttpHealthChecksRestConnectionImpl::PatchHttpHealthCheck( }); } +StatusOr +HttpHealthChecksRestConnectionImpl::TestIamPermissions( + google::cloud::cpp::compute::http_health_checks::v1:: + TestIamPermissionsRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->TestIamPermissions(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::http_health_checks::v1:: + TestIamPermissionsRequest const& request) { + return stub_->TestIamPermissions(rest_context, options, request); + }, + *current, request, __func__); +} + future> HttpHealthChecksRestConnectionImpl::UpdateHttpHealthCheck( google::cloud::cpp::compute::http_health_checks::v1:: diff --git a/google/cloud/compute/http_health_checks/v1/internal/http_health_checks_rest_connection_impl.h b/google/cloud/compute/http_health_checks/v1/internal/http_health_checks_rest_connection_impl.h index 179953db0964c..32f76c1d069f7 100644 --- a/google/cloud/compute/http_health_checks/v1/internal/http_health_checks_rest_connection_impl.h +++ b/google/cloud/compute/http_health_checks/v1/internal/http_health_checks_rest_connection_impl.h @@ -98,6 +98,10 @@ class HttpHealthChecksRestConnectionImpl PatchHttpHealthCheck( google::cloud::cpp::compute::v1::Operation const& operation) override; + StatusOr + TestIamPermissions(google::cloud::cpp::compute::http_health_checks::v1:: + TestIamPermissionsRequest const& request) override; + future> UpdateHttpHealthCheck( google::cloud::cpp::compute::http_health_checks::v1:: diff --git a/google/cloud/compute/http_health_checks/v1/internal/http_health_checks_rest_logging_decorator.cc b/google/cloud/compute/http_health_checks/v1/internal/http_health_checks_rest_logging_decorator.cc index 764ff7ce15b51..271e82893a5f5 100644 --- a/google/cloud/compute/http_health_checks/v1/internal/http_health_checks_rest_logging_decorator.cc +++ b/google/cloud/compute/http_health_checks/v1/internal/http_health_checks_rest_logging_decorator.cc @@ -164,6 +164,20 @@ HttpHealthChecksRestLogging::PatchHttpHealthCheck( rest_context, options, request, __func__, tracing_options_); } +StatusOr +HttpHealthChecksRestLogging::TestIamPermissions( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::http_health_checks::v1:: + TestIamPermissionsRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::http_health_checks::v1:: + TestIamPermissionsRequest const& request) { + return child_->TestIamPermissions(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + future> HttpHealthChecksRestLogging::AsyncUpdateHttpHealthCheck( CompletionQueue& cq, diff --git a/google/cloud/compute/http_health_checks/v1/internal/http_health_checks_rest_logging_decorator.h b/google/cloud/compute/http_health_checks/v1/internal/http_health_checks_rest_logging_decorator.h index 3b222e76e2943..06c13d93a5f0a 100644 --- a/google/cloud/compute/http_health_checks/v1/internal/http_health_checks_rest_logging_decorator.h +++ b/google/cloud/compute/http_health_checks/v1/internal/http_health_checks_rest_logging_decorator.h @@ -96,6 +96,12 @@ class HttpHealthChecksRestLogging : public HttpHealthChecksRestStub { google::cloud::cpp::compute::http_health_checks::v1:: PatchHttpHealthCheckRequest const& request) override; + StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::http_health_checks::v1:: + TestIamPermissionsRequest const& request) override; + future> AsyncUpdateHttpHealthCheck( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/http_health_checks/v1/internal/http_health_checks_rest_metadata_decorator.cc b/google/cloud/compute/http_health_checks/v1/internal/http_health_checks_rest_metadata_decorator.cc index 88f77638f7d67..b128aa706d6d9 100644 --- a/google/cloud/compute/http_health_checks/v1/internal/http_health_checks_rest_metadata_decorator.cc +++ b/google/cloud/compute/http_health_checks/v1/internal/http_health_checks_rest_metadata_decorator.cc @@ -120,6 +120,15 @@ HttpHealthChecksRestMetadata::PatchHttpHealthCheck( return child_->PatchHttpHealthCheck(rest_context, options, request); } +StatusOr +HttpHealthChecksRestMetadata::TestIamPermissions( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::http_health_checks::v1:: + TestIamPermissionsRequest const& request) { + SetMetadata(rest_context, options); + return child_->TestIamPermissions(rest_context, options, request); +} + future> HttpHealthChecksRestMetadata::AsyncUpdateHttpHealthCheck( CompletionQueue& cq, diff --git a/google/cloud/compute/http_health_checks/v1/internal/http_health_checks_rest_metadata_decorator.h b/google/cloud/compute/http_health_checks/v1/internal/http_health_checks_rest_metadata_decorator.h index f754cfe186d5e..3ad476338001f 100644 --- a/google/cloud/compute/http_health_checks/v1/internal/http_health_checks_rest_metadata_decorator.h +++ b/google/cloud/compute/http_health_checks/v1/internal/http_health_checks_rest_metadata_decorator.h @@ -94,6 +94,12 @@ class HttpHealthChecksRestMetadata : public HttpHealthChecksRestStub { google::cloud::cpp::compute::http_health_checks::v1:: PatchHttpHealthCheckRequest const& request) override; + StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::http_health_checks::v1:: + TestIamPermissionsRequest const& request) override; + google::cloud::future> AsyncUpdateHttpHealthCheck( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/http_health_checks/v1/internal/http_health_checks_rest_stub.cc b/google/cloud/compute/http_health_checks/v1/internal/http_health_checks_rest_stub.cc index b6337a65fe9d2..8c460089178ee 100644 --- a/google/cloud/compute/http_health_checks/v1/internal/http_health_checks_rest_stub.cc +++ b/google/cloud/compute/http_health_checks/v1/internal/http_health_checks_rest_stub.cc @@ -257,6 +257,25 @@ DefaultHttpHealthChecksRestStub::PatchHttpHealthCheck( std::move(query_params)); } +StatusOr +DefaultHttpHealthChecksRestStub::TestIamPermissions( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::http_health_checks::v1:: + TestIamPermissionsRequest const& request) { + std::vector> query_params; + return rest_internal::Post< + google::cloud::cpp::compute::v1::TestPermissionsResponse>( + *service_, rest_context, request.test_permissions_request_resource(), + false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "global", "/", + "httpHealthChecks", "/", request.resource(), "/", + "testIamPermissions"), + std::move(query_params)); +} + future> DefaultHttpHealthChecksRestStub::AsyncUpdateHttpHealthCheck( CompletionQueue& cq, diff --git a/google/cloud/compute/http_health_checks/v1/internal/http_health_checks_rest_stub.h b/google/cloud/compute/http_health_checks/v1/internal/http_health_checks_rest_stub.h index 54d00d9043be2..621c18f1b334c 100644 --- a/google/cloud/compute/http_health_checks/v1/internal/http_health_checks_rest_stub.h +++ b/google/cloud/compute/http_health_checks/v1/internal/http_health_checks_rest_stub.h @@ -91,6 +91,12 @@ class HttpHealthChecksRestStub { google::cloud::cpp::compute::http_health_checks::v1:: PatchHttpHealthCheckRequest const& request) = 0; + virtual StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::http_health_checks::v1:: + TestIamPermissionsRequest const& request) = 0; + virtual future> AsyncUpdateHttpHealthCheck( google::cloud::CompletionQueue& cq, @@ -184,6 +190,12 @@ class DefaultHttpHealthChecksRestStub : public HttpHealthChecksRestStub { google::cloud::cpp::compute::http_health_checks::v1:: PatchHttpHealthCheckRequest const& request) override; + StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::http_health_checks::v1:: + TestIamPermissionsRequest const& request) override; + future> AsyncUpdateHttpHealthCheck( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/http_health_checks/v1/internal/http_health_checks_tracing_connection.cc b/google/cloud/compute/http_health_checks/v1/internal/http_health_checks_tracing_connection.cc index 6133ccec68b9f..ecb28ea4a21e3 100644 --- a/google/cloud/compute/http_health_checks/v1/internal/http_health_checks_tracing_connection.cc +++ b/google/cloud/compute/http_health_checks/v1/internal/http_health_checks_tracing_connection.cc @@ -162,6 +162,17 @@ HttpHealthChecksTracingConnection::PatchHttpHealthCheck( child_->PatchHttpHealthCheck(operation)); } +StatusOr +HttpHealthChecksTracingConnection::TestIamPermissions( + google::cloud::cpp::compute::http_health_checks::v1:: + TestIamPermissionsRequest const& request) { + auto span = internal::MakeSpan( + "compute_http_health_checks_v1::HttpHealthChecksConnection::" + "TestIamPermissions"); + auto scope = opentelemetry::trace::Scope(span); + return internal::EndSpan(*span, child_->TestIamPermissions(request)); +} + future> HttpHealthChecksTracingConnection::UpdateHttpHealthCheck( google::cloud::cpp::compute::http_health_checks::v1:: diff --git a/google/cloud/compute/http_health_checks/v1/internal/http_health_checks_tracing_connection.h b/google/cloud/compute/http_health_checks/v1/internal/http_health_checks_tracing_connection.h index 3ee4fc55438ea..b0847878aabe0 100644 --- a/google/cloud/compute/http_health_checks/v1/internal/http_health_checks_tracing_connection.h +++ b/google/cloud/compute/http_health_checks/v1/internal/http_health_checks_tracing_connection.h @@ -85,6 +85,10 @@ class HttpHealthChecksTracingConnection PatchHttpHealthCheck( google::cloud::cpp::compute::v1::Operation const& operation) override; + StatusOr + TestIamPermissions(google::cloud::cpp::compute::http_health_checks::v1:: + TestIamPermissionsRequest const& request) override; + future> UpdateHttpHealthCheck( google::cloud::cpp::compute::http_health_checks::v1:: diff --git a/google/cloud/compute/http_health_checks/v1/mocks/mock_http_health_checks_connection.h b/google/cloud/compute/http_health_checks/v1/mocks/mock_http_health_checks_connection.h index 54cfe9551e577..f9174e46f6181 100644 --- a/google/cloud/compute/http_health_checks/v1/mocks/mock_http_health_checks_connection.h +++ b/google/cloud/compute/http_health_checks/v1/mocks/mock_http_health_checks_connection.h @@ -182,6 +182,13 @@ class MockHttpHealthChecksConnection (google::cloud::cpp::compute::v1::Operation const& operation), (override)); + MOCK_METHOD( + StatusOr, + TestIamPermissions, + (google::cloud::cpp::compute::http_health_checks::v1:: + TestIamPermissionsRequest const& request), + (override)); + /// To disambiguate calls, use: /// /// @code diff --git a/google/cloud/compute/https_health_checks/v1/https_health_checks_client.cc b/google/cloud/compute/https_health_checks/v1/https_health_checks_client.cc index d7b1d76122840..60179a21efb0c 100644 --- a/google/cloud/compute/https_health_checks/v1/https_health_checks_client.cc +++ b/google/cloud/compute/https_health_checks/v1/https_health_checks_client.cc @@ -233,6 +233,31 @@ HttpsHealthChecksClient::PatchHttpsHealthCheck( return connection_->PatchHttpsHealthCheck(operation); } +StatusOr +HttpsHealthChecksClient::TestIamPermissions( + std::string const& project, std::string const& resource, + google::cloud::cpp::compute::v1::TestPermissionsRequest const& + test_permissions_request_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::https_health_checks::v1:: + TestIamPermissionsRequest request; + request.set_project(project); + request.set_resource(resource); + *request.mutable_test_permissions_request_resource() = + test_permissions_request_resource; + return connection_->TestIamPermissions(request); +} + +StatusOr +HttpsHealthChecksClient::TestIamPermissions( + google::cloud::cpp::compute::https_health_checks::v1:: + TestIamPermissionsRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->TestIamPermissions(request); +} + future> HttpsHealthChecksClient::UpdateHttpsHealthCheck( std::string const& project, std::string const& https_health_check, 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..d9d01ef33a77b 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 @@ -115,7 +115,7 @@ class HttpsHealthChecksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.https_health_checks.v1.DeleteHttpsHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/https_health_checks/v1/https_health_checks.proto#L117} + /// [google.cloud.cpp.compute.https_health_checks.v1.DeleteHttpsHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/https_health_checks/v1/https_health_checks.proto#L131} /// // clang-format on future> @@ -169,7 +169,7 @@ class HttpsHealthChecksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.https_health_checks.v1.DeleteHttpsHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/https_health_checks/v1/https_health_checks.proto#L117} + /// [google.cloud.cpp.compute.https_health_checks.v1.DeleteHttpsHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/https_health_checks/v1/https_health_checks.proto#L131} /// // clang-format on future> @@ -228,8 +228,8 @@ class HttpsHealthChecksClient { /// [`future`]: @ref google::cloud::future /// [`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.https_health_checks.v1.GetHttpsHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/https_health_checks/v1/https_health_checks.proto#L160} + /// [google.cloud.cpp.compute.v1.HttpsHealthCheck]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_068.proto#L34} /// // clang-format on StatusOr @@ -260,8 +260,8 @@ class HttpsHealthChecksClient { /// [`future`]: @ref google::cloud::future /// [`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.https_health_checks.v1.GetHttpsHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/https_health_checks/v1/https_health_checks.proto#L160} + /// [google.cloud.cpp.compute.v1.HttpsHealthCheck]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_068.proto#L34} /// // clang-format on StatusOr @@ -297,7 +297,7 @@ class HttpsHealthChecksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.https_health_checks.v1.InsertHttpsHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/https_health_checks/v1/https_health_checks.proto#L154} + /// [google.cloud.cpp.compute.https_health_checks.v1.InsertHttpsHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/https_health_checks/v1/https_health_checks.proto#L171} /// // clang-format on future> @@ -356,7 +356,7 @@ class HttpsHealthChecksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.https_health_checks.v1.InsertHttpsHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/https_health_checks/v1/https_health_checks.proto#L154} + /// [google.cloud.cpp.compute.https_health_checks.v1.InsertHttpsHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/https_health_checks/v1/https_health_checks.proto#L171} /// // clang-format on future> @@ -424,8 +424,8 @@ class HttpsHealthChecksClient { /// [`future`]: @ref google::cloud::future /// [`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.https_health_checks.v1.ListHttpsHealthChecksRequest]: @cloud_cpp_reference_link{google/cloud/compute/https_health_checks/v1/https_health_checks.proto#L200} + /// [google.cloud.cpp.compute.v1.HttpsHealthCheck]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_068.proto#L34} /// // clang-format on StreamRange @@ -465,8 +465,8 @@ class HttpsHealthChecksClient { /// [`future`]: @ref google::cloud::future /// [`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.https_health_checks.v1.ListHttpsHealthChecksRequest]: @cloud_cpp_reference_link{google/cloud/compute/https_health_checks/v1/https_health_checks.proto#L200} + /// [google.cloud.cpp.compute.v1.HttpsHealthCheck]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_068.proto#L34} /// // clang-format on StreamRange @@ -477,8 +477,9 @@ class HttpsHealthChecksClient { // clang-format off /// /// 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. + /// included in the request. This method supportsPATCH + /// semantics and uses theJSON merge + /// patch format and processing rules. /// https://cloud.google.com/compute/docs/reference/rest/v1/httpsHealthChecks/patch /// /// @param project Project ID for this request. @@ -504,7 +505,7 @@ class HttpsHealthChecksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.https_health_checks.v1.PatchHttpsHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/https_health_checks/v1/https_health_checks.proto#L248} + /// [google.cloud.cpp.compute.https_health_checks.v1.PatchHttpsHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/https_health_checks/v1/https_health_checks.proto#L301} /// // clang-format on future> @@ -535,8 +536,9 @@ class HttpsHealthChecksClient { // clang-format off /// /// 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. + /// included in the request. This method supportsPATCH + /// semantics and uses theJSON merge + /// patch format and processing rules. /// https://cloud.google.com/compute/docs/reference/rest/v1/httpsHealthChecks/patch /// /// @param request Unary RPCs, such as the one wrapped by this @@ -565,7 +567,7 @@ class HttpsHealthChecksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.https_health_checks.v1.PatchHttpsHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/https_health_checks/v1/https_health_checks.proto#L248} + /// [google.cloud.cpp.compute.https_health_checks.v1.PatchHttpsHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/https_health_checks/v1/https_health_checks.proto#L301} /// // clang-format on future> @@ -604,6 +606,71 @@ class HttpsHealthChecksClient { google::cloud::cpp::compute::v1::Operation const& operation, Options opts = {}); + // clang-format off + /// + /// Returns permissions that a caller has on the specified resource. + /// https://cloud.google.com/compute/docs/reference/rest/v1/httpsHealthChecks/testIamPermissions + /// + /// @param project Project ID for this request. + /// @param resource Name or id of the resource for this request. + /// @param test_permissions_request_resource The TestPermissionsRequest for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.TestPermissionsResponse]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.https_health_checks.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/https_health_checks/v1/https_health_checks.proto#L334} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} + /// + // clang-format on + StatusOr + TestIamPermissions( + std::string const& project, std::string const& resource, + google::cloud::cpp::compute::v1::TestPermissionsRequest const& + test_permissions_request_resource, + Options opts = {}); + + // clang-format off + /// + /// Returns permissions that a caller has on the specified resource. + /// https://cloud.google.com/compute/docs/reference/rest/v1/httpsHealthChecks/testIamPermissions + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.https_health_checks.v1.TestIamPermissionsRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.TestPermissionsResponse]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.https_health_checks.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/https_health_checks/v1/https_health_checks.proto#L334} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} + /// + // clang-format on + StatusOr + TestIamPermissions(google::cloud::cpp::compute::https_health_checks::v1:: + TestIamPermissionsRequest const& request, + Options opts = {}); + // clang-format off /// /// Updates a HttpsHealthCheck resource in the specified project using the data @@ -633,7 +700,7 @@ class HttpsHealthChecksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.https_health_checks.v1.UpdateHttpsHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/https_health_checks/v1/https_health_checks.proto#L278} + /// [google.cloud.cpp.compute.https_health_checks.v1.UpdateHttpsHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/https_health_checks/v1/https_health_checks.proto#L349} /// // clang-format on future> @@ -693,7 +760,7 @@ class HttpsHealthChecksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.https_health_checks.v1.UpdateHttpsHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/https_health_checks/v1/https_health_checks.proto#L278} + /// [google.cloud.cpp.compute.https_health_checks.v1.UpdateHttpsHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/https_health_checks/v1/https_health_checks.proto#L349} /// // clang-format on future> diff --git a/google/cloud/compute/https_health_checks/v1/https_health_checks_connection.cc b/google/cloud/compute/https_health_checks/v1/https_health_checks_connection.cc index dcfe1e89e36c1..bfd6230a90421 100644 --- a/google/cloud/compute/https_health_checks/v1/https_health_checks_connection.cc +++ b/google/cloud/compute/https_health_checks/v1/https_health_checks_connection.cc @@ -126,6 +126,13 @@ HttpsHealthChecksConnection::PatchHttpsHealthCheck( Status(StatusCode::kUnimplemented, "not implemented")); } +StatusOr +HttpsHealthChecksConnection::TestIamPermissions( + google::cloud::cpp::compute::https_health_checks::v1:: + TestIamPermissionsRequest const&) { + return Status(StatusCode::kUnimplemented, "not implemented"); +} + future> HttpsHealthChecksConnection::UpdateHttpsHealthCheck( google::cloud::cpp::compute::https_health_checks::v1:: diff --git a/google/cloud/compute/https_health_checks/v1/https_health_checks_connection.h b/google/cloud/compute/https_health_checks/v1/https_health_checks_connection.h index 49a98c41909e0..a99747ceeaf9a 100644 --- a/google/cloud/compute/https_health_checks/v1/https_health_checks_connection.h +++ b/google/cloud/compute/https_health_checks/v1/https_health_checks_connection.h @@ -234,6 +234,10 @@ class HttpsHealthChecksConnection { PatchHttpsHealthCheck( google::cloud::cpp::compute::v1::Operation const& operation); + virtual StatusOr + TestIamPermissions(google::cloud::cpp::compute::https_health_checks::v1:: + TestIamPermissionsRequest const& request); + virtual future> UpdateHttpsHealthCheck(google::cloud::cpp::compute::https_health_checks::v1:: UpdateHttpsHealthCheckRequest const& request); diff --git a/google/cloud/compute/https_health_checks/v1/https_health_checks_connection_idempotency_policy.cc b/google/cloud/compute/https_health_checks/v1/https_health_checks_connection_idempotency_policy.cc index d648ccd9b95fb..66c5b73a1d1ac 100644 --- a/google/cloud/compute/https_health_checks/v1/https_health_checks_connection_idempotency_policy.cc +++ b/google/cloud/compute/https_health_checks/v1/https_health_checks_connection_idempotency_policy.cc @@ -66,6 +66,12 @@ Idempotency HttpsHealthChecksConnectionIdempotencyPolicy::PatchHttpsHealthCheck( return Idempotency::kNonIdempotent; } +Idempotency HttpsHealthChecksConnectionIdempotencyPolicy::TestIamPermissions( + google::cloud::cpp::compute::https_health_checks::v1:: + TestIamPermissionsRequest const&) { + return Idempotency::kNonIdempotent; +} + Idempotency HttpsHealthChecksConnectionIdempotencyPolicy::UpdateHttpsHealthCheck( google::cloud::cpp::compute::https_health_checks::v1:: diff --git a/google/cloud/compute/https_health_checks/v1/https_health_checks_connection_idempotency_policy.h b/google/cloud/compute/https_health_checks/v1/https_health_checks_connection_idempotency_policy.h index 9d2c5fa4840c1..3fac6e74c6823 100644 --- a/google/cloud/compute/https_health_checks/v1/https_health_checks_connection_idempotency_policy.h +++ b/google/cloud/compute/https_health_checks/v1/https_health_checks_connection_idempotency_policy.h @@ -57,6 +57,10 @@ class HttpsHealthChecksConnectionIdempotencyPolicy { google::cloud::cpp::compute::https_health_checks::v1:: PatchHttpsHealthCheckRequest const& request); + virtual google::cloud::Idempotency TestIamPermissions( + google::cloud::cpp::compute::https_health_checks::v1:: + TestIamPermissionsRequest const& request); + virtual google::cloud::Idempotency UpdateHttpsHealthCheck( google::cloud::cpp::compute::https_health_checks::v1:: UpdateHttpsHealthCheckRequest const& request); 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 51f70130f5f90..99496ba5f16ad 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,9 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_HTTPS_HEALTH_CHECKS_V1_HTTPS_HEALTH_CHECKS_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_054.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_068.pb.h" +#include "google/cloud/compute/v1/internal/common_171.pb.h" // 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/https_health_checks/v1/internal/https_health_checks_rest_connection_impl.cc b/google/cloud/compute/https_health_checks/v1/internal/https_health_checks_rest_connection_impl.cc index 0b9e527107f25..26bfd3895b591 100644 --- a/google/cloud/compute/https_health_checks/v1/internal/https_health_checks_rest_connection_impl.cc +++ b/google/cloud/compute/https_health_checks/v1/internal/https_health_checks_rest_connection_impl.cc @@ -482,6 +482,22 @@ HttpsHealthChecksRestConnectionImpl::PatchHttpsHealthCheck( }); } +StatusOr +HttpsHealthChecksRestConnectionImpl::TestIamPermissions( + google::cloud::cpp::compute::https_health_checks::v1:: + TestIamPermissionsRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->TestIamPermissions(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::https_health_checks::v1:: + TestIamPermissionsRequest const& request) { + return stub_->TestIamPermissions(rest_context, options, request); + }, + *current, request, __func__); +} + future> HttpsHealthChecksRestConnectionImpl::UpdateHttpsHealthCheck( google::cloud::cpp::compute::https_health_checks::v1:: diff --git a/google/cloud/compute/https_health_checks/v1/internal/https_health_checks_rest_connection_impl.h b/google/cloud/compute/https_health_checks/v1/internal/https_health_checks_rest_connection_impl.h index 0ae2e47902d61..86d588bffb913 100644 --- a/google/cloud/compute/https_health_checks/v1/internal/https_health_checks_rest_connection_impl.h +++ b/google/cloud/compute/https_health_checks/v1/internal/https_health_checks_rest_connection_impl.h @@ -99,6 +99,10 @@ class HttpsHealthChecksRestConnectionImpl PatchHttpsHealthCheck( google::cloud::cpp::compute::v1::Operation const& operation) override; + StatusOr + TestIamPermissions(google::cloud::cpp::compute::https_health_checks::v1:: + TestIamPermissionsRequest const& request) override; + future> UpdateHttpsHealthCheck( google::cloud::cpp::compute::https_health_checks::v1:: diff --git a/google/cloud/compute/https_health_checks/v1/internal/https_health_checks_rest_logging_decorator.cc b/google/cloud/compute/https_health_checks/v1/internal/https_health_checks_rest_logging_decorator.cc index fd2369cd302bc..f0f7b535a4361 100644 --- a/google/cloud/compute/https_health_checks/v1/internal/https_health_checks_rest_logging_decorator.cc +++ b/google/cloud/compute/https_health_checks/v1/internal/https_health_checks_rest_logging_decorator.cc @@ -164,6 +164,20 @@ HttpsHealthChecksRestLogging::PatchHttpsHealthCheck( rest_context, options, request, __func__, tracing_options_); } +StatusOr +HttpsHealthChecksRestLogging::TestIamPermissions( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::https_health_checks::v1:: + TestIamPermissionsRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::https_health_checks::v1:: + TestIamPermissionsRequest const& request) { + return child_->TestIamPermissions(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + future> HttpsHealthChecksRestLogging::AsyncUpdateHttpsHealthCheck( CompletionQueue& cq, diff --git a/google/cloud/compute/https_health_checks/v1/internal/https_health_checks_rest_logging_decorator.h b/google/cloud/compute/https_health_checks/v1/internal/https_health_checks_rest_logging_decorator.h index a4044050d7a70..71f38d68daf89 100644 --- a/google/cloud/compute/https_health_checks/v1/internal/https_health_checks_rest_logging_decorator.h +++ b/google/cloud/compute/https_health_checks/v1/internal/https_health_checks_rest_logging_decorator.h @@ -97,6 +97,12 @@ class HttpsHealthChecksRestLogging : public HttpsHealthChecksRestStub { google::cloud::cpp::compute::https_health_checks::v1:: PatchHttpsHealthCheckRequest const& request) override; + StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::https_health_checks::v1:: + TestIamPermissionsRequest const& request) override; + future> AsyncUpdateHttpsHealthCheck( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/https_health_checks/v1/internal/https_health_checks_rest_metadata_decorator.cc b/google/cloud/compute/https_health_checks/v1/internal/https_health_checks_rest_metadata_decorator.cc index 22095930504b9..892c380379d50 100644 --- a/google/cloud/compute/https_health_checks/v1/internal/https_health_checks_rest_metadata_decorator.cc +++ b/google/cloud/compute/https_health_checks/v1/internal/https_health_checks_rest_metadata_decorator.cc @@ -120,6 +120,15 @@ HttpsHealthChecksRestMetadata::PatchHttpsHealthCheck( return child_->PatchHttpsHealthCheck(rest_context, options, request); } +StatusOr +HttpsHealthChecksRestMetadata::TestIamPermissions( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::https_health_checks::v1:: + TestIamPermissionsRequest const& request) { + SetMetadata(rest_context, options); + return child_->TestIamPermissions(rest_context, options, request); +} + future> HttpsHealthChecksRestMetadata::AsyncUpdateHttpsHealthCheck( CompletionQueue& cq, diff --git a/google/cloud/compute/https_health_checks/v1/internal/https_health_checks_rest_metadata_decorator.h b/google/cloud/compute/https_health_checks/v1/internal/https_health_checks_rest_metadata_decorator.h index 1ba2fe726fbf3..f12aaca428d3a 100644 --- a/google/cloud/compute/https_health_checks/v1/internal/https_health_checks_rest_metadata_decorator.h +++ b/google/cloud/compute/https_health_checks/v1/internal/https_health_checks_rest_metadata_decorator.h @@ -95,6 +95,12 @@ class HttpsHealthChecksRestMetadata : public HttpsHealthChecksRestStub { google::cloud::cpp::compute::https_health_checks::v1:: PatchHttpsHealthCheckRequest const& request) override; + StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::https_health_checks::v1:: + TestIamPermissionsRequest const& request) override; + google::cloud::future> AsyncUpdateHttpsHealthCheck( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/https_health_checks/v1/internal/https_health_checks_rest_stub.cc b/google/cloud/compute/https_health_checks/v1/internal/https_health_checks_rest_stub.cc index d2651fe27e8b9..69a9d19f33e8a 100644 --- a/google/cloud/compute/https_health_checks/v1/internal/https_health_checks_rest_stub.cc +++ b/google/cloud/compute/https_health_checks/v1/internal/https_health_checks_rest_stub.cc @@ -257,6 +257,25 @@ DefaultHttpsHealthChecksRestStub::PatchHttpsHealthCheck( std::move(query_params)); } +StatusOr +DefaultHttpsHealthChecksRestStub::TestIamPermissions( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::https_health_checks::v1:: + TestIamPermissionsRequest const& request) { + std::vector> query_params; + return rest_internal::Post< + google::cloud::cpp::compute::v1::TestPermissionsResponse>( + *service_, rest_context, request.test_permissions_request_resource(), + false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "global", "/", + "httpsHealthChecks", "/", request.resource(), "/", + "testIamPermissions"), + std::move(query_params)); +} + future> DefaultHttpsHealthChecksRestStub::AsyncUpdateHttpsHealthCheck( CompletionQueue& cq, diff --git a/google/cloud/compute/https_health_checks/v1/internal/https_health_checks_rest_stub.h b/google/cloud/compute/https_health_checks/v1/internal/https_health_checks_rest_stub.h index 839455228655b..5eff02fa18f1c 100644 --- a/google/cloud/compute/https_health_checks/v1/internal/https_health_checks_rest_stub.h +++ b/google/cloud/compute/https_health_checks/v1/internal/https_health_checks_rest_stub.h @@ -93,6 +93,12 @@ class HttpsHealthChecksRestStub { google::cloud::cpp::compute::https_health_checks::v1:: PatchHttpsHealthCheckRequest const& request) = 0; + virtual StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::https_health_checks::v1:: + TestIamPermissionsRequest const& request) = 0; + virtual future> AsyncUpdateHttpsHealthCheck( google::cloud::CompletionQueue& cq, @@ -188,6 +194,12 @@ class DefaultHttpsHealthChecksRestStub : public HttpsHealthChecksRestStub { google::cloud::cpp::compute::https_health_checks::v1:: PatchHttpsHealthCheckRequest const& request) override; + StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::https_health_checks::v1:: + TestIamPermissionsRequest const& request) override; + future> AsyncUpdateHttpsHealthCheck( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/https_health_checks/v1/internal/https_health_checks_tracing_connection.cc b/google/cloud/compute/https_health_checks/v1/internal/https_health_checks_tracing_connection.cc index 003dc4e104b07..5b7a2a5f0a57b 100644 --- a/google/cloud/compute/https_health_checks/v1/internal/https_health_checks_tracing_connection.cc +++ b/google/cloud/compute/https_health_checks/v1/internal/https_health_checks_tracing_connection.cc @@ -162,6 +162,17 @@ HttpsHealthChecksTracingConnection::PatchHttpsHealthCheck( child_->PatchHttpsHealthCheck(operation)); } +StatusOr +HttpsHealthChecksTracingConnection::TestIamPermissions( + google::cloud::cpp::compute::https_health_checks::v1:: + TestIamPermissionsRequest const& request) { + auto span = internal::MakeSpan( + "compute_https_health_checks_v1::HttpsHealthChecksConnection::" + "TestIamPermissions"); + auto scope = opentelemetry::trace::Scope(span); + return internal::EndSpan(*span, child_->TestIamPermissions(request)); +} + future> HttpsHealthChecksTracingConnection::UpdateHttpsHealthCheck( google::cloud::cpp::compute::https_health_checks::v1:: diff --git a/google/cloud/compute/https_health_checks/v1/internal/https_health_checks_tracing_connection.h b/google/cloud/compute/https_health_checks/v1/internal/https_health_checks_tracing_connection.h index 623f2c83bc1f5..ccb96fa4986d9 100644 --- a/google/cloud/compute/https_health_checks/v1/internal/https_health_checks_tracing_connection.h +++ b/google/cloud/compute/https_health_checks/v1/internal/https_health_checks_tracing_connection.h @@ -87,6 +87,10 @@ class HttpsHealthChecksTracingConnection PatchHttpsHealthCheck( google::cloud::cpp::compute::v1::Operation const& operation) override; + StatusOr + TestIamPermissions(google::cloud::cpp::compute::https_health_checks::v1:: + TestIamPermissionsRequest const& request) override; + future> UpdateHttpsHealthCheck( google::cloud::cpp::compute::https_health_checks::v1:: diff --git a/google/cloud/compute/https_health_checks/v1/mocks/mock_https_health_checks_connection.h b/google/cloud/compute/https_health_checks/v1/mocks/mock_https_health_checks_connection.h index c069fb07ad5cb..e83a0413d4f8f 100644 --- a/google/cloud/compute/https_health_checks/v1/mocks/mock_https_health_checks_connection.h +++ b/google/cloud/compute/https_health_checks/v1/mocks/mock_https_health_checks_connection.h @@ -184,6 +184,13 @@ class MockHttpsHealthChecksConnection (google::cloud::cpp::compute::v1::Operation const& operation), (override)); + MOCK_METHOD( + StatusOr, + TestIamPermissions, + (google::cloud::cpp::compute::https_health_checks::v1:: + TestIamPermissionsRequest const& request), + (override)); + /// To disambiguate calls, use: /// /// @code 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..6c87698922be6 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 @@ -89,8 +89,8 @@ class ImageFamilyViewsClient { // clang-format off /// - /// Returns the latest image that is part of an image family, is not deprecated - /// and is rolled out in the specified zone. + /// Returns the latest image that is part of an image family, is not + /// deprecated and is rolled out in the specified zone. /// https://cloud.google.com/compute/docs/reference/rest/v1/imageFamilyViews/get /// /// @param project Project ID for this request. @@ -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_070.proto#L26} /// // clang-format on StatusOr GetImageFamilyView( @@ -119,8 +119,8 @@ class ImageFamilyViewsClient { // clang-format off /// - /// Returns the latest image that is part of an image family, is not deprecated - /// and is rolled out in the specified zone. + /// Returns the latest image that is part of an image family, is not + /// deprecated and is rolled out in the specified zone. /// https://cloud.google.com/compute/docs/reference/rest/v1/imageFamilyViews/get /// /// @param request Unary RPCs, such as the one wrapped by this @@ -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_070.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 146a2bb003e35..63e09620e5931 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 "google/cloud/compute/v1/internal/common_021.pb.h" -#include "google/cloud/compute/v1/internal/common_023.pb.h" -#include "google/cloud/compute/v1/internal/common_033.pb.h" -#include "google/cloud/compute/v1/internal/common_055.pb.h" -#include "google/cloud/compute/v1/internal/common_056.pb.h" +#include "google/cloud/compute/v1/internal/common_028.pb.h" +#include "google/cloud/compute/v1/internal/common_032.pb.h" +#include "google/cloud/compute/v1/internal/common_042.pb.h" +#include "google/cloud/compute/v1/internal/common_069.pb.h" +#include "google/cloud/compute/v1/internal/common_070.pb.h" // 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 fbc5de28737d0..a8e73c5138fc2 100644 --- a/google/cloud/compute/images/v1/images_client.h +++ b/google/cloud/compute/images/v1/images_client.h @@ -205,8 +205,9 @@ class ImagesClient { // clang-format off /// - /// Sets the deprecation status of an image. If an empty request body is given, - /// clears the deprecation status instead. + /// Sets the deprecation status of an image. + /// + /// If an empty request body is given, clears the deprecation status instead. /// https://cloud.google.com/compute/docs/reference/rest/v1/images/deprecate /// /// @param project Project ID for this request. @@ -232,7 +233,7 @@ class ImagesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.images.v1.DeprecateRequest]: @cloud_cpp_reference_link{google/cloud/compute/images/v1/images.proto#L214} + /// [google.cloud.cpp.compute.images.v1.DeprecateRequest]: @cloud_cpp_reference_link{google/cloud/compute/images/v1/images.proto#L217} /// // clang-format on future> Deprecate( @@ -260,8 +261,9 @@ class ImagesClient { // clang-format off /// - /// Sets the deprecation status of an image. If an empty request body is given, - /// clears the deprecation status instead. + /// Sets the deprecation status of an image. + /// + /// If an empty request body is given, clears the deprecation status instead. /// https://cloud.google.com/compute/docs/reference/rest/v1/images/deprecate /// /// @param request Unary RPCs, such as the one wrapped by this @@ -290,7 +292,7 @@ class ImagesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.images.v1.DeprecateRequest]: @cloud_cpp_reference_link{google/cloud/compute/images/v1/images.proto#L214} + /// [google.cloud.cpp.compute.images.v1.DeprecateRequest]: @cloud_cpp_reference_link{google/cloud/compute/images/v1/images.proto#L217} /// // clang-format on future> Deprecate( @@ -346,8 +348,8 @@ class ImagesClient { /// [`future`]: @ref google::cloud::future /// [`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.images.v1.GetImageRequest]: @cloud_cpp_reference_link{google/cloud/compute/images/v1/images.proto#L277} + /// [google.cloud.cpp.compute.v1.Image]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_069.proto#L32} /// // clang-format on StatusOr GetImage( @@ -377,8 +379,8 @@ class ImagesClient { /// [`future`]: @ref google::cloud::future /// [`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.images.v1.GetImageRequest]: @cloud_cpp_reference_link{google/cloud/compute/images/v1/images.proto#L277} + /// [google.cloud.cpp.compute.v1.Image]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_069.proto#L32} /// // clang-format on StatusOr GetImage( @@ -388,8 +390,8 @@ class ImagesClient { // clang-format off /// /// 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. + /// deprecated. For more information on image families, seePublic + /// image families documentation. /// https://cloud.google.com/compute/docs/reference/rest/v1/images/getFromFamily /// /// @param project The image project that the image belongs to. For example, to get a CentOS @@ -408,8 +410,8 @@ class ImagesClient { /// [`future`]: @ref google::cloud::future /// [`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.images.v1.GetFromFamilyRequest]: @cloud_cpp_reference_link{google/cloud/compute/images/v1/images.proto#L250} + /// [google.cloud.cpp.compute.v1.Image]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_069.proto#L32} /// // clang-format on StatusOr GetFromFamily( @@ -418,8 +420,8 @@ class ImagesClient { // clang-format off /// /// 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. + /// deprecated. For more information on image families, seePublic + /// image families documentation. /// https://cloud.google.com/compute/docs/reference/rest/v1/images/getFromFamily /// /// @param request Unary RPCs, such as the one wrapped by this @@ -441,8 +443,8 @@ class ImagesClient { /// [`future`]: @ref google::cloud::future /// [`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.images.v1.GetFromFamilyRequest]: @cloud_cpp_reference_link{google/cloud/compute/images/v1/images.proto#L250} + /// [google.cloud.cpp.compute.v1.Image]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_069.proto#L32} /// // clang-format on StatusOr GetFromFamily( @@ -471,8 +473,8 @@ class ImagesClient { /// [`future`]: @ref google::cloud::future /// [`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_007.proto#L178} + /// [google.cloud.cpp.compute.images.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/images/v1/images.proto#L262} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr GetIamPolicy( @@ -504,8 +506,8 @@ class ImagesClient { /// [`future`]: @ref google::cloud::future /// [`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_007.proto#L178} + /// [google.cloud.cpp.compute.images.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/images/v1/images.proto#L262} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr GetIamPolicy( @@ -515,8 +517,8 @@ class ImagesClient { // clang-format off /// - /// Creates an image in the specified project using the data included in the - /// request. + /// Creates an image in the specified project using the data included + /// in the request. /// https://cloud.google.com/compute/docs/reference/rest/v1/images/insert /// /// @param project Project ID for this request. @@ -541,7 +543,7 @@ class ImagesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.images.v1.InsertImageRequest]: @cloud_cpp_reference_link{google/cloud/compute/images/v1/images.proto#L282} + /// [google.cloud.cpp.compute.images.v1.InsertImageRequest]: @cloud_cpp_reference_link{google/cloud/compute/images/v1/images.proto#L288} /// // clang-format on future> InsertImage( @@ -567,8 +569,8 @@ class ImagesClient { // clang-format off /// - /// Creates an image in the specified project using the data included in the - /// request. + /// Creates an image in the specified project using the data included + /// in the request. /// https://cloud.google.com/compute/docs/reference/rest/v1/images/insert /// /// @param request Unary RPCs, such as the one wrapped by this @@ -597,7 +599,7 @@ class ImagesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.images.v1.InsertImageRequest]: @cloud_cpp_reference_link{google/cloud/compute/images/v1/images.proto#L282} + /// [google.cloud.cpp.compute.images.v1.InsertImageRequest]: @cloud_cpp_reference_link{google/cloud/compute/images/v1/images.proto#L288} /// // clang-format on future> InsertImage( @@ -637,12 +639,13 @@ class ImagesClient { // clang-format off /// - /// 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. + /// 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. /// https://cloud.google.com/compute/docs/reference/rest/v1/images/list /// /// @param project Project ID for this request. @@ -668,8 +671,8 @@ class ImagesClient { /// [`future`]: @ref google::cloud::future /// [`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.images.v1.ListImagesRequest]: @cloud_cpp_reference_link{google/cloud/compute/images/v1/images.proto#L320} + /// [google.cloud.cpp.compute.v1.Image]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_069.proto#L32} /// // clang-format on StreamRange ListImages( @@ -677,12 +680,13 @@ class ImagesClient { // clang-format off /// - /// 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. + /// 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. /// https://cloud.google.com/compute/docs/reference/rest/v1/images/list /// /// @param request Unary RPCs, such as the one wrapped by this @@ -713,8 +717,8 @@ class ImagesClient { /// [`future`]: @ref google::cloud::future /// [`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.images.v1.ListImagesRequest]: @cloud_cpp_reference_link{google/cloud/compute/images/v1/images.proto#L320} + /// [google.cloud.cpp.compute.v1.Image]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_069.proto#L32} /// // clang-format on StreamRange ListImages( @@ -723,8 +727,9 @@ class ImagesClient { // clang-format off /// - /// Patches the specified image with the data included in the request. Only the - /// following fields can be modified: family, description, deprecation status. + /// Patches the specified image with the data included in the request. + /// Only the following fields can be modified: family, description, + /// deprecation status. /// https://cloud.google.com/compute/docs/reference/rest/v1/images/patch /// /// @param project Project ID for this request. @@ -750,7 +755,7 @@ class ImagesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.images.v1.PatchImageRequest]: @cloud_cpp_reference_link{google/cloud/compute/images/v1/images.proto#L379} + /// [google.cloud.cpp.compute.images.v1.PatchImageRequest]: @cloud_cpp_reference_link{google/cloud/compute/images/v1/images.proto#L421} /// // clang-format on future> PatchImage( @@ -776,8 +781,9 @@ class ImagesClient { // clang-format off /// - /// Patches the specified image with the data included in the request. Only the - /// following fields can be modified: family, description, deprecation status. + /// Patches the specified image with the data included in the request. + /// Only the following fields can be modified: family, description, + /// deprecation status. /// https://cloud.google.com/compute/docs/reference/rest/v1/images/patch /// /// @param request Unary RPCs, such as the one wrapped by this @@ -806,7 +812,7 @@ class ImagesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.images.v1.PatchImageRequest]: @cloud_cpp_reference_link{google/cloud/compute/images/v1/images.proto#L379} + /// [google.cloud.cpp.compute.images.v1.PatchImageRequest]: @cloud_cpp_reference_link{google/cloud/compute/images/v1/images.proto#L421} /// // clang-format on future> PatchImage( @@ -844,8 +850,8 @@ class ImagesClient { // clang-format off /// - /// Sets the access control policy on the specified resource. Replaces any - /// existing policy. + /// Sets the access control policy on the specified resource. + /// Replaces any existing policy. /// https://cloud.google.com/compute/docs/reference/rest/v1/images/setIamPolicy /// /// @param project Project ID for this request. @@ -864,8 +870,8 @@ class ImagesClient { /// [`future`]: @ref google::cloud::future /// [`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_007.proto#L178} + /// [google.cloud.cpp.compute.images.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/images/v1/images.proto#L454} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr SetIamPolicy( @@ -876,8 +882,8 @@ class ImagesClient { // clang-format off /// - /// Sets the access control policy on the specified resource. Replaces any - /// existing policy. + /// Sets the access control policy on the specified resource. + /// Replaces any existing policy. /// https://cloud.google.com/compute/docs/reference/rest/v1/images/setIamPolicy /// /// @param request Unary RPCs, such as the one wrapped by this @@ -899,8 +905,8 @@ class ImagesClient { /// [`future`]: @ref google::cloud::future /// [`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_007.proto#L178} + /// [google.cloud.cpp.compute.images.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/images/v1/images.proto#L454} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr SetIamPolicy( @@ -910,7 +916,7 @@ class ImagesClient { // clang-format off /// - /// Sets the labels on an image. To learn more about labels, read the Labeling + /// Sets the labels on an image. To learn more about labels, read theLabeling /// Resources documentation. /// https://cloud.google.com/compute/docs/reference/rest/v1/images/setLabels /// @@ -937,7 +943,7 @@ class ImagesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.images.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/images/v1/images.proto#L425} + /// [google.cloud.cpp.compute.images.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/images/v1/images.proto#L470} /// // clang-format on future> SetLabels( @@ -965,7 +971,7 @@ class ImagesClient { // clang-format off /// - /// Sets the labels on an image. To learn more about labels, read the Labeling + /// Sets the labels on an image. To learn more about labels, read theLabeling /// Resources documentation. /// https://cloud.google.com/compute/docs/reference/rest/v1/images/setLabels /// @@ -995,7 +1001,7 @@ class ImagesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.images.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/images/v1/images.proto#L425} + /// [google.cloud.cpp.compute.images.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/images/v1/images.proto#L470} /// // clang-format on future> SetLabels( @@ -1052,8 +1058,8 @@ class ImagesClient { /// [`future`]: @ref google::cloud::future /// [`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_145.proto#L30} + /// [google.cloud.cpp.compute.images.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/images/v1/images.proto#L489} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} /// // clang-format on StatusOr @@ -1087,8 +1093,8 @@ class ImagesClient { /// [`future`]: @ref google::cloud::future /// [`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_145.proto#L30} + /// [google.cloud.cpp.compute.images.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/images/v1/images.proto#L489} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.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 f3f6cb0503048..7d03925a12fa8 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 "google/cloud/compute/v1/internal/common_007.pb.h" -#include "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_021.pb.h" -#include "google/cloud/compute/v1/internal/common_023.pb.h" -#include "google/cloud/compute/v1/internal/common_031.pb.h" -#include "google/cloud/compute/v1/internal/common_033.pb.h" -#include "google/cloud/compute/v1/internal/common_046.pb.h" -#include "google/cloud/compute/v1/internal/common_047.pb.h" -#include "google/cloud/compute/v1/internal/common_055.pb.h" +#include "google/cloud/compute/v1/internal/common_009.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_028.pb.h" +#include "google/cloud/compute/v1/internal/common_032.pb.h" +#include "google/cloud/compute/v1/internal/common_040.pb.h" +#include "google/cloud/compute/v1/internal/common_042.pb.h" +#include "google/cloud/compute/v1/internal/common_056.pb.h" #include "google/cloud/compute/v1/internal/common_057.pb.h" -#include "google/cloud/compute/v1/internal/common_145.pb.h" +#include "google/cloud/compute/v1/internal/common_069.pb.h" +#include "google/cloud/compute/v1/internal/common_071.pb.h" +#include "google/cloud/compute/v1/internal/common_171.pb.h" // 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..9654fd121a605 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 @@ -102,12 +102,12 @@ class InstanceGroupManagerResizeRequestsClient { /// https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagerResizeRequests/cancel /// /// @param project Project ID for this request. - /// @param zone The name of the zone where the managed instance group is located. The name - /// should conform to RFC1035. - /// @param instance_group_manager The name of the managed instance group. The name should conform to RFC1035 - /// or be a resource ID. - /// @param resize_request The name of the resize request to cancel. The name should conform to - /// RFC1035 or be a resource ID. + /// @param zone The name of thezone where the managed + /// instance group is located. The name should conform to RFC1035. + /// @param instance_group_manager The name of the managed instance group. + /// The name should conform to RFC1035 or be a resource ID. + /// @param resize_request The name of the resize request to cancel. + /// The name should conform to RFC1035 or be a resource ID. /// @param opts Optional. Override the class-level options, such as retry and /// backoff policies. /// @return A [`future`] that becomes satisfied when the LRO @@ -128,7 +128,7 @@ class InstanceGroupManagerResizeRequestsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instance_group_manager_resize_requests.v1.CancelRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_manager_resize_requests/v1/instance_group_manager_resize_requests.proto#L113} + /// [google.cloud.cpp.compute.instance_group_manager_resize_requests.v1.CancelRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_manager_resize_requests/v1/instance_group_manager_resize_requests.proto#L114} /// // clang-format on future> Cancel( @@ -186,7 +186,7 @@ class InstanceGroupManagerResizeRequestsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instance_group_manager_resize_requests.v1.CancelRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_manager_resize_requests/v1/instance_group_manager_resize_requests.proto#L113} + /// [google.cloud.cpp.compute.instance_group_manager_resize_requests.v1.CancelRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_manager_resize_requests/v1/instance_group_manager_resize_requests.proto#L114} /// // clang-format on future> Cancel( @@ -232,12 +232,12 @@ class InstanceGroupManagerResizeRequestsClient { /// https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagerResizeRequests/delete /// /// @param project Project ID for this request. - /// @param zone The name of the zone where the managed instance group is located. The name - /// should conform to RFC1035. - /// @param instance_group_manager The name of the managed instance group. The name should conform to RFC1035 - /// or be a resource ID. - /// @param resize_request The name of the resize request to delete. The name should conform to - /// RFC1035 or be a resource ID. + /// @param zone The name of thezone where the managed + /// instance group is located. The name should conform to RFC1035. + /// @param instance_group_manager The name of the managed instance group. + /// The name should conform to RFC1035 or be a resource ID. + /// @param resize_request The name of the resize request to delete. + /// The name should conform to RFC1035 or be a resource ID. /// @param opts Optional. Override the class-level options, such as retry and /// backoff policies. /// @return A [`future`] that becomes satisfied when the LRO @@ -258,7 +258,7 @@ class InstanceGroupManagerResizeRequestsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instance_group_manager_resize_requests.v1.DeleteInstanceGroupManagerResizeRequestRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_manager_resize_requests/v1/instance_group_manager_resize_requests.proto#L155} + /// [google.cloud.cpp.compute.instance_group_manager_resize_requests.v1.DeleteInstanceGroupManagerResizeRequestRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_manager_resize_requests/v1/instance_group_manager_resize_requests.proto#L159} /// // clang-format on future> @@ -317,7 +317,7 @@ class InstanceGroupManagerResizeRequestsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instance_group_manager_resize_requests.v1.DeleteInstanceGroupManagerResizeRequestRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_manager_resize_requests/v1/instance_group_manager_resize_requests.proto#L155} + /// [google.cloud.cpp.compute.instance_group_manager_resize_requests.v1.DeleteInstanceGroupManagerResizeRequestRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_manager_resize_requests/v1/instance_group_manager_resize_requests.proto#L159} /// // clang-format on future> @@ -364,12 +364,12 @@ class InstanceGroupManagerResizeRequestsClient { /// https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagerResizeRequests/get /// /// @param project Project ID for this request. - /// @param zone Name of the href="/compute/docs/regions-zones/#available">zone scoping this - /// request. Name should conform to RFC1035. - /// @param instance_group_manager The name of the managed instance group. Name should conform to RFC1035 or - /// be a resource ID. - /// @param resize_request The name of the resize request. Name should conform to RFC1035 or be a - /// resource ID. + /// @param zone Name of the href="/compute/docs/regions-zones/#available">zone + /// scoping this request. Name should conform to RFC1035. + /// @param instance_group_manager The name of the managed instance group. + /// Name should conform to RFC1035 or be a resource ID. + /// @param resize_request The name of the resize request. + /// Name should conform to RFC1035 or be a resource ID. /// @param opts Optional. Override the class-level options, such as retry and /// backoff policies. /// @return the result of the RPC. The response message type @@ -383,8 +383,8 @@ class InstanceGroupManagerResizeRequestsClient { /// [`future`]: @ref google::cloud::future /// [`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.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#L204} + /// [google.cloud.cpp.compute.v1.InstanceGroupManagerResizeRequest]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_076.proto#L33} /// // clang-format on StatusOr @@ -417,8 +417,8 @@ class InstanceGroupManagerResizeRequestsClient { /// [`future`]: @ref google::cloud::future /// [`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.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#L204} + /// [google.cloud.cpp.compute.v1.InstanceGroupManagerResizeRequest]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_076.proto#L33} /// // clang-format on StatusOr @@ -429,15 +429,17 @@ class InstanceGroupManagerResizeRequestsClient { // clang-format off /// - /// Creates a new resize request that starts provisioning VMs immediately or - /// queues VM creation. + /// Creates a new resize request that starts provisioning VMs immediately + /// or queues VM creation. /// https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagerResizeRequests/insert /// /// @param project Project ID for this request. - /// @param zone 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. - /// @param instance_group_manager 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. + /// @param zone The name of thezone where the managed + /// instance group is located and where the resize request will be created. + /// Name should conform to RFC1035. + /// @param instance_group_manager 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. /// @param instance_group_manager_resize_request_resource The InstanceGroupManagerResizeRequest for this request. /// @param opts Optional. Override the class-level options, such as retry and /// backoff policies. @@ -459,7 +461,7 @@ class InstanceGroupManagerResizeRequestsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instance_group_manager_resize_requests.v1.InsertInstanceGroupManagerResizeRequestRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_manager_resize_requests/v1/instance_group_manager_resize_requests.proto#L220} + /// [google.cloud.cpp.compute.instance_group_manager_resize_requests.v1.InsertInstanceGroupManagerResizeRequestRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_manager_resize_requests/v1/instance_group_manager_resize_requests.proto#L227} /// // clang-format on future> @@ -491,8 +493,8 @@ class InstanceGroupManagerResizeRequestsClient { // clang-format off /// - /// Creates a new resize request that starts provisioning VMs immediately or - /// queues VM creation. + /// Creates a new resize request that starts provisioning VMs immediately + /// or queues VM creation. /// https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagerResizeRequests/insert /// /// @param request Unary RPCs, such as the one wrapped by this @@ -521,7 +523,7 @@ class InstanceGroupManagerResizeRequestsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instance_group_manager_resize_requests.v1.InsertInstanceGroupManagerResizeRequestRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_manager_resize_requests/v1/instance_group_manager_resize_requests.proto#L220} + /// [google.cloud.cpp.compute.instance_group_manager_resize_requests.v1.InsertInstanceGroupManagerResizeRequestRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_manager_resize_requests/v1/instance_group_manager_resize_requests.proto#L227} /// // clang-format on future> @@ -564,13 +566,13 @@ class InstanceGroupManagerResizeRequestsClient { // clang-format off /// - /// Retrieves a list of resize requests that are contained in the managed - /// instance group. + /// Retrieves a list of resize requests that are contained in the + /// managed instance group. /// https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagerResizeRequests/list /// /// @param project Project ID for this request. - /// @param zone The name of the zone where the managed instance group is located. The name - /// should conform to RFC1035. + /// @param zone The name of thezone where the managed + /// instance group is located. The name should conform to RFC1035. /// @param instance_group_manager The name of the managed instance group. The name should conform to RFC1035. /// @param opts Optional. Override the class-level options, such as retry and /// backoff policies. @@ -594,8 +596,8 @@ class InstanceGroupManagerResizeRequestsClient { /// [`future`]: @ref google::cloud::future /// [`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.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#L274} + /// [google.cloud.cpp.compute.v1.InstanceGroupManagerResizeRequest]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_076.proto#L33} /// // clang-format on StreamRange< @@ -606,8 +608,8 @@ class InstanceGroupManagerResizeRequestsClient { // clang-format off /// - /// Retrieves a list of resize requests that are contained in the managed - /// instance group. + /// Retrieves a list of resize requests that are contained in the + /// managed instance group. /// https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagerResizeRequests/list /// /// @param request Unary RPCs, such as the one wrapped by this @@ -638,8 +640,8 @@ class InstanceGroupManagerResizeRequestsClient { /// [`future`]: @ref google::cloud::future /// [`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.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#L274} + /// [google.cloud.cpp.compute.v1.InstanceGroupManagerResizeRequest]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_076.proto#L33} /// // 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 2faf312babb8f..0f656ae885e28 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,11 @@ #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 "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_029.pb.h" -#include "google/cloud/compute/v1/internal/common_062.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_038.pb.h" +#include "google/cloud/compute/v1/internal/common_076.pb.h" +#include "google/cloud/compute/v1/internal/common_077.pb.h" +#include "google/cloud/compute/v1/internal/common_110.pb.h" // 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 c46699e2c164c..ff45fc0072640 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 @@ -94,22 +94,28 @@ class InstanceGroupManagersClient { // clang-format off /// - /// 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. + /// 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 thetargetSize of + /// the managed instance group by the + /// number of instances that you abandon. This operation is marked asDONE 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 thelistmanagedinstances + /// 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. /// https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagers/abandonInstances /// /// @param project Project ID for this request. - /// @param zone The name of the zone where the managed instance group is located. + /// @param zone The name of thezone where the managed + /// instance group is located. /// @param instance_group_manager The name of the managed instance group. /// @param instance_group_managers_abandon_instances_request_resource The InstanceGroupManagersAbandonInstancesRequest for this request. /// @param opts Optional. Override the class-level options, such as retry and @@ -132,7 +138,7 @@ class InstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instance_group_managers.v1.AbandonInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L496} + /// [google.cloud.cpp.compute.instance_group_managers.v1.AbandonInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L566} /// // clang-format on future> AbandonInstances( @@ -164,18 +170,23 @@ class InstanceGroupManagersClient { // clang-format off /// - /// 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. + /// 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 thetargetSize of + /// the managed instance group by the + /// number of instances that you abandon. This operation is marked asDONE 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 thelistmanagedinstances + /// 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. /// https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagers/abandonInstances /// /// @param request Unary RPCs, such as the one wrapped by this @@ -204,7 +215,7 @@ class InstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instance_group_managers.v1.AbandonInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L496} + /// [google.cloud.cpp.compute.instance_group_managers.v1.AbandonInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L566} /// // clang-format on future> AbandonInstances( @@ -244,9 +255,10 @@ class InstanceGroupManagersClient { // clang-format off /// - /// 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`. + /// 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`. /// https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagers/aggregatedList /// /// @param project Project ID for this request. @@ -272,8 +284,8 @@ class InstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`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#L537} - /// [google.cloud.cpp.compute.v1.InstanceGroupManagersScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_061.proto#L469} + /// [google.cloud.cpp.compute.instance_group_managers.v1.AggregatedListInstanceGroupManagersRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L611} + /// [google.cloud.cpp.compute.v1.InstanceGroupManagersScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_075.proto#L560} /// // clang-format on StreamRange> @@ -391,8 +404,8 @@ class InstanceGroupManagersClient { // clang-format off /// - /// Applies changes to selected instances on the managed instance group. This - /// method can be used to apply new overrides and/or new versions. + /// Applies changes to selected instances on the managed instance group. + /// This method can be used to apply new overrides and/or new versions. /// https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagers/applyUpdatesToInstances /// /// @param request Unary RPCs, such as the one wrapped by this @@ -421,7 +434,7 @@ class InstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instance_group_managers.v1.ApplyUpdatesToInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L619} + /// [google.cloud.cpp.compute.instance_group_managers.v1.ApplyUpdatesToInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L726} /// // clang-format on future> @@ -463,17 +476,20 @@ class InstanceGroupManagersClient { // clang-format off /// /// 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. + /// group. Instances are created using the current instance template. Thecreate + /// instances operation is marked DONE if thecreateInstances request is + /// successful. The underlying actions + /// take additional time. You must separately verify the status of thecreating + /// or actions with the listmanagedinstances + /// method. /// https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagers/createInstances /// /// @param project Project ID for this request. - /// @param zone The name of the zone where the managed instance group is located. It should - /// conform to RFC1035. - /// @param instance_group_manager The name of the managed instance group. It should conform to RFC1035. + /// @param zone The name of thezone + /// where the managed instance group is located. + /// It should conform to RFC1035. + /// @param instance_group_manager The name of the managed instance group. + /// It should conform to RFC1035. /// @param instance_group_managers_create_instances_request_resource The InstanceGroupManagersCreateInstancesRequest for this request. /// @param opts Optional. Override the class-level options, such as retry and /// backoff policies. @@ -495,7 +511,7 @@ class InstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instance_group_managers.v1.CreateInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L648} + /// [google.cloud.cpp.compute.instance_group_managers.v1.CreateInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L755} /// // clang-format on future> CreateInstances( @@ -528,11 +544,12 @@ class InstanceGroupManagersClient { // clang-format off /// /// 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. + /// group. Instances are created using the current instance template. Thecreate + /// instances operation is marked DONE if thecreateInstances request is + /// successful. The underlying actions + /// take additional time. You must separately verify the status of thecreating + /// or actions with the listmanagedinstances + /// method. /// https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagers/createInstances /// /// @param request Unary RPCs, such as the one wrapped by this @@ -561,7 +578,7 @@ class InstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instance_group_managers.v1.CreateInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L648} + /// [google.cloud.cpp.compute.instance_group_managers.v1.CreateInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L755} /// // clang-format on future> CreateInstances( @@ -601,13 +618,15 @@ class InstanceGroupManagersClient { // clang-format off /// - /// 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. + /// 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. /// https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagers/delete /// /// @param project Project ID for this request. - /// @param zone The name of the zone where the managed instance group is located. + /// @param zone The name of thezone where the managed + /// instance group is located. /// @param instance_group_manager The name of the managed instance group to delete. /// @param opts Optional. Override the class-level options, such as retry and /// backoff policies. @@ -629,7 +648,7 @@ class InstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instance_group_managers.v1.DeleteInstanceGroupManagerRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L689} + /// [google.cloud.cpp.compute.instance_group_managers.v1.DeleteInstanceGroupManagerRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L801} /// // clang-format on future> @@ -657,9 +676,10 @@ class InstanceGroupManagersClient { // clang-format off /// - /// 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. + /// 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. /// https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagers/delete /// /// @param request Unary RPCs, such as the one wrapped by this @@ -688,7 +708,7 @@ class InstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instance_group_managers.v1.DeleteInstanceGroupManagerRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L689} + /// [google.cloud.cpp.compute.instance_group_managers.v1.DeleteInstanceGroupManagerRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L801} /// // clang-format on future> @@ -732,20 +752,26 @@ class InstanceGroupManagersClient { // clang-format off /// /// 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. + /// deletion. The instances are also removed from any target + /// pools of which they were a member. This method reduces thetargetSize 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 thelistmanagedinstances + /// 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. /// https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagers/deleteInstances /// /// @param project Project ID for this request. - /// @param zone The name of the zone where the managed instance group is located. + /// @param zone The name of thezone where the managed + /// instance group is located. /// @param instance_group_manager The name of the managed instance group. /// @param instance_group_managers_delete_instances_request_resource The InstanceGroupManagersDeleteInstancesRequest for this request. /// @param opts Optional. Override the class-level options, such as retry and @@ -768,7 +794,7 @@ class InstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instance_group_managers.v1.DeleteInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L724} + /// [google.cloud.cpp.compute.instance_group_managers.v1.DeleteInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L844} /// // clang-format on future> DeleteInstances( @@ -801,16 +827,21 @@ class InstanceGroupManagersClient { // clang-format off /// /// 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. + /// deletion. The instances are also removed from any target + /// pools of which they were a member. This method reduces thetargetSize 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 thelistmanagedinstances + /// 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. /// https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagers/deleteInstances /// /// @param request Unary RPCs, such as the one wrapped by this @@ -839,7 +870,7 @@ class InstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instance_group_managers.v1.DeleteInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L724} + /// [google.cloud.cpp.compute.instance_group_managers.v1.DeleteInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L844} /// // clang-format on future> DeleteInstances( @@ -884,9 +915,12 @@ class InstanceGroupManagersClient { /// https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagers/deletePerInstanceConfigs /// /// @param project Project ID for this request. - /// @param zone The name of the zone where the managed instance group is located. It should - /// conform to RFC1035. - /// @param instance_group_manager The name of the managed instance group. It should conform to RFC1035. + /// @param zone The name of thezone + /// where the managed instance + /// group is located. + /// It should conform to RFC1035. + /// @param instance_group_manager The name of the managed instance group. + /// It should conform to RFC1035. /// @param instance_group_managers_delete_per_instance_configs_req_resource The InstanceGroupManagersDeletePerInstanceConfigsReq for this request. /// @param opts Optional. Override the class-level options, such as retry and /// backoff policies. @@ -908,7 +942,7 @@ class InstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instance_group_managers.v1.DeletePerInstanceConfigsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L765} + /// [google.cloud.cpp.compute.instance_group_managers.v1.DeletePerInstanceConfigsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L893} /// // clang-format on future> @@ -971,7 +1005,7 @@ class InstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instance_group_managers.v1.DeletePerInstanceConfigsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L765} + /// [google.cloud.cpp.compute.instance_group_managers.v1.DeletePerInstanceConfigsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L893} /// // clang-format on future> @@ -1017,7 +1051,8 @@ class InstanceGroupManagersClient { /// https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagers/get /// /// @param project Project ID for this request. - /// @param zone The name of the zone where the managed instance group is located. + /// @param zone The name of thezone where the managed + /// instance group is located. /// @param instance_group_manager The name of the managed instance group. /// @param opts Optional. Override the class-level options, such as retry and /// backoff policies. @@ -1032,8 +1067,8 @@ class InstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`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#L795} - /// [google.cloud.cpp.compute.v1.InstanceGroupManager]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_028.proto#L67} + /// [google.cloud.cpp.compute.instance_group_managers.v1.GetInstanceGroupManagerRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L926} + /// [google.cloud.cpp.compute.v1.InstanceGroupManager]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_037.proto#L84} /// // clang-format on StatusOr @@ -1065,8 +1100,8 @@ class InstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`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#L795} - /// [google.cloud.cpp.compute.v1.InstanceGroupManager]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_028.proto#L67} + /// [google.cloud.cpp.compute.instance_group_managers.v1.GetInstanceGroupManagerRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L926} + /// [google.cloud.cpp.compute.v1.InstanceGroupManager]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_037.proto#L84} /// // clang-format on StatusOr @@ -1076,18 +1111,23 @@ class InstanceGroupManagersClient { // clang-format off /// - /// 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. + /// 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 + /// thelistmanagedinstances + /// 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. /// https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagers/insert /// /// @param project Project ID for this request. - /// @param zone The name of the zone where you want to create the managed instance group. + /// @param zone The name of the zone + /// where you want to create the managed instance group. /// @param instance_group_manager_resource The InstanceGroupManager for this request. /// @param opts Optional. Override the class-level options, such as retry and /// backoff policies. @@ -1109,7 +1149,7 @@ class InstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instance_group_managers.v1.InsertInstanceGroupManagerRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L811} + /// [google.cloud.cpp.compute.instance_group_managers.v1.InsertInstanceGroupManagerRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L943} /// // clang-format on future> @@ -1139,14 +1179,18 @@ class InstanceGroupManagersClient { // clang-format off /// - /// 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. + /// 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 + /// thelistmanagedinstances + /// 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. /// https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagers/insert /// /// @param request Unary RPCs, such as the one wrapped by this @@ -1175,7 +1219,7 @@ class InstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instance_group_managers.v1.InsertInstanceGroupManagerRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L811} + /// [google.cloud.cpp.compute.instance_group_managers.v1.InsertInstanceGroupManagerRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L943} /// // clang-format on future> @@ -1223,7 +1267,8 @@ class InstanceGroupManagersClient { /// https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagers/list /// /// @param project Project ID for this request. - /// @param zone The name of the zone where the managed instance group is located. + /// @param zone The name of thezone where the managed + /// instance group is located. /// @param opts Optional. Override the class-level options, such as retry and /// backoff policies. /// @return a [StreamRange](@ref google::cloud::StreamRange) @@ -1246,8 +1291,8 @@ class InstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`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#L924} - /// [google.cloud.cpp.compute.v1.InstanceGroupManager]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_028.proto#L67} + /// [google.cloud.cpp.compute.instance_group_managers.v1.ListInstanceGroupManagersRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L1095} + /// [google.cloud.cpp.compute.v1.InstanceGroupManager]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_037.proto#L84} /// // clang-format on StreamRange @@ -1288,8 +1333,8 @@ class InstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`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#L924} - /// [google.cloud.cpp.compute.v1.InstanceGroupManager]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_028.proto#L67} + /// [google.cloud.cpp.compute.instance_group_managers.v1.ListInstanceGroupManagersRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L1095} + /// [google.cloud.cpp.compute.v1.InstanceGroupManager]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_037.proto#L84} /// // clang-format on StreamRange @@ -1301,15 +1346,18 @@ class InstanceGroupManagersClient { // clang-format off /// /// Lists all errors thrown by actions on instances for a given managed - /// instance group. The filter and orderBy query parameters are not supported. + /// instance group. The filter and orderBy query + /// parameters are not supported. /// https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagers/listErrors /// /// @param project Project ID for this request. - /// @param zone The name of the zone where the managed instance group is located. It should - /// conform to RFC1035. - /// @param instance_group_manager 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}. + /// @param zone The name of thezone where the managed + /// instance group is located. + /// It should conform to RFC1035. + /// @param instance_group_manager 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}. /// @param opts Optional. Override the class-level options, such as retry and /// backoff policies. /// @return a [StreamRange](@ref google::cloud::StreamRange) @@ -1332,8 +1380,8 @@ class InstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`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#L844} - /// [google.cloud.cpp.compute.v1.InstanceManagedByIgmError]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_028.proto#L567} + /// [google.cloud.cpp.compute.instance_group_managers.v1.ListErrorsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L980} + /// [google.cloud.cpp.compute.v1.InstanceManagedByIgmError]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_037.proto#L938} /// // clang-format on StreamRange @@ -1343,7 +1391,8 @@ class InstanceGroupManagersClient { // clang-format off /// /// Lists all errors thrown by actions on instances for a given managed - /// instance group. The filter and orderBy query parameters are not supported. + /// instance group. The filter and orderBy query + /// parameters are not supported. /// https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagers/listErrors /// /// @param request Unary RPCs, such as the one wrapped by this @@ -1374,8 +1423,8 @@ class InstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`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#L844} - /// [google.cloud.cpp.compute.v1.InstanceManagedByIgmError]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_028.proto#L567} + /// [google.cloud.cpp.compute.instance_group_managers.v1.ListErrorsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L980} + /// [google.cloud.cpp.compute.v1.InstanceManagedByIgmError]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_037.proto#L938} /// // clang-format on StreamRange @@ -1385,18 +1434,20 @@ class InstanceGroupManagersClient { // clang-format off /// - /// 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 + /// 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`. /// https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagers/listManagedInstances /// /// @param project Project ID for this request. - /// @param zone The name of the zone where the managed instance group is located. + /// @param zone The name of thezone where the managed + /// instance group is located. /// @param instance_group_manager The name of the managed instance group. /// @param opts Optional. Override the class-level options, such as retry and /// backoff policies. @@ -1411,8 +1462,8 @@ class InstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`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#L995} - /// [google.cloud.cpp.compute.v1.InstanceGroupManagersListManagedInstancesResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_061.proto#L338} + /// [google.cloud.cpp.compute.instance_group_managers.v1.ListManagedInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L1200} + /// [google.cloud.cpp.compute.v1.InstanceGroupManagersListManagedInstancesResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_075.proto#L404} /// // clang-format on StatusOr @@ -1537,8 +1590,8 @@ class InstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`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#L1072} - /// [google.cloud.cpp.compute.v1.PerInstanceConfig]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_028.proto#L833} + /// [google.cloud.cpp.compute.instance_group_managers.v1.ListPerInstanceConfigsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L1311} + /// [google.cloud.cpp.compute.v1.PerInstanceConfig]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_110.proto#L24} /// // clang-format on StreamRange @@ -1548,20 +1601,27 @@ class InstanceGroupManagersClient { // clang-format off /// - /// 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 + /// 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. + /// with thelistManagedInstances + /// method. This method supportsPATCH + /// semantics and uses theJSON 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, seeUpdating + /// instances in + /// a MIG. /// https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagers/patch /// /// @param project Project ID for this request. - /// @param zone The name of the zone where you want to create the managed instance group. + /// @param zone The name of the zone where + /// you want to create the managed instance group. /// @param instance_group_manager The name of the instance group manager. /// @param instance_group_manager_resource The InstanceGroupManager for this request. /// @param opts Optional. Override the class-level options, such as retry and @@ -1584,7 +1644,7 @@ class InstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instance_group_managers.v1.PatchInstanceGroupManagerRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L1150} + /// [google.cloud.cpp.compute.instance_group_managers.v1.PatchInstanceGroupManagerRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L1423} /// // clang-format on future> @@ -1616,16 +1676,22 @@ class InstanceGroupManagersClient { // clang-format off /// - /// 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 + /// 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. + /// with thelistManagedInstances + /// method. This method supportsPATCH + /// semantics and uses theJSON 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, seeUpdating + /// instances in + /// a MIG. /// https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagers/patch /// /// @param request Unary RPCs, such as the one wrapped by this @@ -1654,7 +1720,7 @@ class InstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instance_group_managers.v1.PatchInstanceGroupManagerRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L1150} + /// [google.cloud.cpp.compute.instance_group_managers.v1.PatchInstanceGroupManagerRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L1423} /// // clang-format on future> @@ -1698,14 +1764,16 @@ class InstanceGroupManagersClient { // clang-format off /// /// 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. + /// group. perInstanceConfig.name serves as a key used to + /// distinguish whether to perform insert or patch. /// https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagers/patchPerInstanceConfigs /// /// @param project Project ID for this request. - /// @param zone The name of the zone where the managed instance group is located. It should - /// conform to RFC1035. - /// @param instance_group_manager The name of the managed instance group. It should conform to RFC1035. + /// @param zone The name of thezone + /// where the managed instance group is located. + /// It should conform to RFC1035. + /// @param instance_group_manager The name of the managed instance group. + /// It should conform to RFC1035. /// @param instance_group_managers_patch_per_instance_configs_req_resource The InstanceGroupManagersPatchPerInstanceConfigsReq for this request. /// @param opts Optional. Override the class-level options, such as retry and /// backoff policies. @@ -1727,7 +1795,7 @@ class InstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instance_group_managers.v1.PatchPerInstanceConfigsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L1189} + /// [google.cloud.cpp.compute.instance_group_managers.v1.PatchPerInstanceConfigsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L1466} /// // clang-format on future> @@ -1761,8 +1829,8 @@ class InstanceGroupManagersClient { // clang-format off /// /// 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. + /// group. perInstanceConfig.name serves as a key used to + /// distinguish whether to perform insert or patch. /// https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagers/patchPerInstanceConfigs /// /// @param request Unary RPCs, such as the one wrapped by this @@ -1791,7 +1859,7 @@ class InstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instance_group_managers.v1.PatchPerInstanceConfigsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L1189} + /// [google.cloud.cpp.compute.instance_group_managers.v1.PatchPerInstanceConfigsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L1466} /// // clang-format on future> @@ -1834,18 +1902,23 @@ class InstanceGroupManagersClient { /// /// 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. + /// 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 itscurrentAction + /// 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. /// https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagers/recreateInstances /// /// @param project Project ID for this request. - /// @param zone The name of the zone where the managed instance group is located. + /// @param zone The name of thezone where the managed + /// instance group is located. /// @param instance_group_manager The name of the managed instance group. /// @param instance_group_managers_recreate_instances_request_resource The InstanceGroupManagersRecreateInstancesRequest for this request. /// @param opts Optional. Override the class-level options, such as retry and @@ -1868,7 +1941,7 @@ class InstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instance_group_managers.v1.RecreateInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L1231} + /// [google.cloud.cpp.compute.instance_group_managers.v1.RecreateInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L1513} /// // clang-format on future> @@ -1903,14 +1976,18 @@ class InstanceGroupManagersClient { /// /// 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. + /// 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 itscurrentAction + /// 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. /// https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagers/recreateInstances /// /// @param request Unary RPCs, such as the one wrapped by this @@ -1939,7 +2016,7 @@ class InstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instance_group_managers.v1.RecreateInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L1231} + /// [google.cloud.cpp.compute.instance_group_managers.v1.RecreateInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L1513} /// // clang-format on future> @@ -1981,23 +2058,33 @@ class InstanceGroupManagersClient { /// /// 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. + /// the size, the group deletes instances. The resize operation is markedDONE + /// 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 thelistmanagedinstances + /// 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. /// https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagers/resize /// /// @param project Project ID for this request. - /// @param zone The name of the zone where the managed instance group is located. + /// @param zone The name of thezone where the managed + /// instance group is located. /// @param instance_group_manager The name of the managed instance group. /// @param size The number of running instances that the managed instance group should /// maintain at any given time. The group automatically adds or removes @@ -2022,7 +2109,7 @@ class InstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instance_group_managers.v1.ResizeRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L1272} + /// [google.cloud.cpp.compute.instance_group_managers.v1.ResizeRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L1562} /// // clang-format on future> Resize( @@ -2050,19 +2137,28 @@ class InstanceGroupManagersClient { /// /// 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. + /// the size, the group deletes instances. The resize operation is markedDONE + /// 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 thelistmanagedinstances + /// 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. /// https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagers/resize /// /// @param request Unary RPCs, such as the one wrapped by this @@ -2091,7 +2187,7 @@ class InstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instance_group_managers.v1.ResizeRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L1272} + /// [google.cloud.cpp.compute.instance_group_managers.v1.ResizeRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L1562} /// // clang-format on future> Resize( @@ -2131,23 +2227,29 @@ class InstanceGroupManagersClient { // clang-format off /// - /// Flags the specified instances in the managed instance group to be resumed. - /// This method increases the targetSize and decreases the targetSuspendedSize + /// Flags the specified instances in the managed instance group to be + /// resumed. This method increases thetargetSize and decreases the + /// targetSuspendedSize /// of the managed instance group by the number of instances that you resume. - /// The resumeInstances operation is marked DONE if the resumeInstances request - /// is successful. The underlying actions take additional time. You must - /// separately verify the status of the RESUMING action with the - /// listmanagedinstances method. In this request, you can only specify - /// instances that are suspended. For example, if an instance was previously - /// suspended using the suspendInstances method, it can be resumed using the - /// resumeInstances method. If a health check is attached to the managed - /// instance group, the specified instances will be verified as healthy after - /// they are resumed. You can specify a maximum of 1000 instances with this - /// method per request. + /// The resumeInstances operation is marked DONE if + /// the resumeInstances request is successful. The underlying + /// actions take additional time. You must separately verify the status of + /// theRESUMING action with thelistmanagedinstances + /// method. + /// + /// In this request, you can only specify instances that are suspended. For + /// example, if an instance was previously suspended using the suspendInstances + /// method, it can be resumed using the resumeInstances method. + /// + /// If a health check is attached to the managed instance group, the specified + /// instances will be verified as healthy after they are resumed. + /// + /// You can specify a maximum of 1000 instances with this method per request. /// https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagers/resumeInstances /// /// @param project Project ID for this request. - /// @param zone The name of the zone where the managed instance group is located. + /// @param zone The name of thezone where the managed + /// instance group is located. /// @param instance_group_manager The name of the managed instance group. /// @param instance_group_managers_resume_instances_request_resource The InstanceGroupManagersResumeInstancesRequest for this request. /// @param opts Optional. Override the class-level options, such as retry and @@ -2170,7 +2272,7 @@ class InstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instance_group_managers.v1.ResumeInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L1312} + /// [google.cloud.cpp.compute.instance_group_managers.v1.ResumeInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L1606} /// // clang-format on future> ResumeInstances( @@ -2202,19 +2304,24 @@ class InstanceGroupManagersClient { // clang-format off /// - /// Flags the specified instances in the managed instance group to be resumed. - /// This method increases the targetSize and decreases the targetSuspendedSize + /// Flags the specified instances in the managed instance group to be + /// resumed. This method increases thetargetSize and decreases the + /// targetSuspendedSize /// of the managed instance group by the number of instances that you resume. - /// The resumeInstances operation is marked DONE if the resumeInstances request - /// is successful. The underlying actions take additional time. You must - /// separately verify the status of the RESUMING action with the - /// listmanagedinstances method. In this request, you can only specify - /// instances that are suspended. For example, if an instance was previously - /// suspended using the suspendInstances method, it can be resumed using the - /// resumeInstances method. If a health check is attached to the managed - /// instance group, the specified instances will be verified as healthy after - /// they are resumed. You can specify a maximum of 1000 instances with this - /// method per request. + /// The resumeInstances operation is marked DONE if + /// the resumeInstances request is successful. The underlying + /// actions take additional time. You must separately verify the status of + /// theRESUMING action with thelistmanagedinstances + /// method. + /// + /// In this request, you can only specify instances that are suspended. For + /// example, if an instance was previously suspended using the suspendInstances + /// method, it can be resumed using the resumeInstances method. + /// + /// If a health check is attached to the managed instance group, the specified + /// instances will be verified as healthy after they are resumed. + /// + /// You can specify a maximum of 1000 instances with this method per request. /// https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagers/resumeInstances /// /// @param request Unary RPCs, such as the one wrapped by this @@ -2243,7 +2350,7 @@ class InstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instance_group_managers.v1.ResumeInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L1312} + /// [google.cloud.cpp.compute.instance_group_managers.v1.ResumeInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L1606} /// // clang-format on future> ResumeInstances( @@ -2285,12 +2392,13 @@ class InstanceGroupManagersClient { /// /// 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. + /// unless you run recreateInstances, runapplyUpdatesToInstances, or set the + /// group'supdatePolicy.type to PROACTIVE. /// https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagers/setInstanceTemplate /// /// @param project Project ID for this request. - /// @param zone The name of the zone where the managed instance group is located. + /// @param zone The name of thezone where the managed + /// instance group is located. /// @param instance_group_manager The name of the managed instance group. /// @param instance_group_managers_set_instance_template_request_resource The InstanceGroupManagersSetInstanceTemplateRequest for this request. /// @param opts Optional. Override the class-level options, such as retry and @@ -2313,7 +2421,7 @@ class InstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instance_group_managers.v1.SetInstanceTemplateRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L1353} + /// [google.cloud.cpp.compute.instance_group_managers.v1.SetInstanceTemplateRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L1651} /// // clang-format on future> @@ -2348,8 +2456,8 @@ class InstanceGroupManagersClient { /// /// 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. + /// unless you run recreateInstances, runapplyUpdatesToInstances, or set the + /// group'supdatePolicy.type to PROACTIVE. /// https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagers/setInstanceTemplate /// /// @param request Unary RPCs, such as the one wrapped by this @@ -2378,7 +2486,7 @@ class InstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instance_group_managers.v1.SetInstanceTemplateRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L1353} + /// [google.cloud.cpp.compute.instance_group_managers.v1.SetInstanceTemplateRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L1651} /// // clang-format on future> @@ -2421,14 +2529,16 @@ class InstanceGroupManagersClient { /// /// 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. + /// instances in the managed instance group. This operation is markedDONE 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. /// https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagers/setTargetPools /// /// @param project Project ID for this request. - /// @param zone The name of the zone where the managed instance group is located. + /// @param zone The name of thezone where the managed + /// instance group is located. /// @param instance_group_manager The name of the managed instance group. /// @param instance_group_managers_set_target_pools_request_resource The InstanceGroupManagersSetTargetPoolsRequest for this request. /// @param opts Optional. Override the class-level options, such as retry and @@ -2451,7 +2561,7 @@ class InstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instance_group_managers.v1.SetTargetPoolsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L1394} + /// [google.cloud.cpp.compute.instance_group_managers.v1.SetTargetPoolsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L1696} /// // clang-format on future> SetTargetPools( @@ -2485,10 +2595,11 @@ class InstanceGroupManagersClient { /// /// 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. + /// instances in the managed instance group. This operation is markedDONE 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. /// https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagers/setTargetPools /// /// @param request Unary RPCs, such as the one wrapped by this @@ -2517,7 +2628,7 @@ class InstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instance_group_managers.v1.SetTargetPoolsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L1394} + /// [google.cloud.cpp.compute.instance_group_managers.v1.SetTargetPoolsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L1696} /// // clang-format on future> SetTargetPools( @@ -2557,23 +2668,29 @@ class InstanceGroupManagersClient { // clang-format off /// - /// Flags the specified instances in the managed instance group to be started. - /// This method increases the targetSize and decreases the targetStoppedSize of - /// the managed instance group by the number of instances that you start. The - /// startInstances operation is marked DONE if the startInstances request is - /// successful. The underlying actions take additional time. You must - /// separately verify the status of the STARTING action with the - /// listmanagedinstances method. In this request, you can only specify - /// instances that are stopped. For example, if an instance was previously - /// stopped using the stopInstances method, it can be started using the - /// startInstances method. If a health check is attached to the managed - /// instance group, the specified instances will be verified as healthy after - /// they are started. You can specify a maximum of 1000 instances with this - /// method per request. + /// Flags the specified instances in the managed instance group to be + /// started. This method increases thetargetSize and decreases the + /// targetStoppedSize + /// of the managed instance group by the number of instances that you start. + /// The startInstances operation is marked DONE if + /// the startInstances request is successful. The underlying + /// actions take additional time. You must separately verify the status of + /// theSTARTING action with thelistmanagedinstances + /// method. + /// + /// In this request, you can only specify instances that are stopped. For + /// example, if an instance was previously stopped using the stopInstances + /// method, it can be started using the startInstances method. + /// + /// If a health check is attached to the managed instance group, the specified + /// instances will be verified as healthy after they are started. + /// + /// You can specify a maximum of 1000 instances with this method per request. /// https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagers/startInstances /// /// @param project Project ID for this request. - /// @param zone The name of the zone where the managed instance group is located. + /// @param zone The name of thezone where the managed + /// instance group is located. /// @param instance_group_manager The name of the managed instance group. /// @param instance_group_managers_start_instances_request_resource The InstanceGroupManagersStartInstancesRequest for this request. /// @param opts Optional. Override the class-level options, such as retry and @@ -2596,7 +2713,7 @@ class InstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instance_group_managers.v1.StartInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L1435} + /// [google.cloud.cpp.compute.instance_group_managers.v1.StartInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L1741} /// // clang-format on future> StartInstances( @@ -2628,19 +2745,24 @@ class InstanceGroupManagersClient { // clang-format off /// - /// Flags the specified instances in the managed instance group to be started. - /// This method increases the targetSize and decreases the targetStoppedSize of - /// the managed instance group by the number of instances that you start. The - /// startInstances operation is marked DONE if the startInstances request is - /// successful. The underlying actions take additional time. You must - /// separately verify the status of the STARTING action with the - /// listmanagedinstances method. In this request, you can only specify - /// instances that are stopped. For example, if an instance was previously - /// stopped using the stopInstances method, it can be started using the - /// startInstances method. If a health check is attached to the managed - /// instance group, the specified instances will be verified as healthy after - /// they are started. You can specify a maximum of 1000 instances with this - /// method per request. + /// Flags the specified instances in the managed instance group to be + /// started. This method increases thetargetSize and decreases the + /// targetStoppedSize + /// of the managed instance group by the number of instances that you start. + /// The startInstances operation is marked DONE if + /// the startInstances request is successful. The underlying + /// actions take additional time. You must separately verify the status of + /// theSTARTING action with thelistmanagedinstances + /// method. + /// + /// In this request, you can only specify instances that are stopped. For + /// example, if an instance was previously stopped using the stopInstances + /// method, it can be started using the startInstances method. + /// + /// If a health check is attached to the managed instance group, the specified + /// instances will be verified as healthy after they are started. + /// + /// You can specify a maximum of 1000 instances with this method per request. /// https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagers/startInstances /// /// @param request Unary RPCs, such as the one wrapped by this @@ -2669,7 +2791,7 @@ class InstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instance_group_managers.v1.StartInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L1435} + /// [google.cloud.cpp.compute.instance_group_managers.v1.StartInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L1741} /// // clang-format on future> StartInstances( @@ -2711,26 +2833,38 @@ class InstanceGroupManagersClient { /// /// Flags the specified instances in the managed instance group to be /// immediately stopped. You can only specify instances that are running in - /// this request. This method reduces the targetSize and increases the - /// targetStoppedSize of the managed instance group by the number of instances - /// that you stop. The stopInstances operation is marked DONE if the - /// stopInstances request is successful. The underlying actions take additional - /// time. You must separately verify the status of the STOPPING action with the - /// listmanagedinstances method. If the standbyPolicy.initialDelaySec field is - /// set, the group delays stopping the instances until initialDelaySec have - /// passed from instance.creationTimestamp (that is, when the instance was - /// created). This delay gives your application time to set itself up and - /// initialize on the instance. If more than initialDelaySec seconds have - /// passed since instance.creationTimestamp when this method is called, there - /// will be zero delay. 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 stopped. - /// Stopped instances can be started using the startInstances method. You can - /// specify a maximum of 1000 instances with this method per request. + /// this request. This method reduces thetargetSize and increases the + /// targetStoppedSize + /// of the managed instance group by the number of instances that you stop. + /// The stopInstances operation is marked DONE if + /// the stopInstances request is successful. The underlying + /// actions take additional time. You must separately verify the status of + /// theSTOPPING action with thelistmanagedinstances + /// method. + /// + /// If the standbyPolicy.initialDelaySec field is set, the group + /// delays stopping the instances until initialDelaySec have + /// passed from instance.creationTimestamp (that is, when the + /// instance was created). This delay gives your application time to + /// set itself up and initialize on the instance. If more thaninitialDelaySec + /// seconds have passed sinceinstance.creationTimestamp when this method is + /// called, there + /// will be zero delay. + /// + /// 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 stopped. + /// + /// Stopped instances can be started using the startInstances + /// method. + /// + /// You can specify a maximum of 1000 instances with this method per request. /// https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagers/stopInstances /// /// @param project Project ID for this request. - /// @param zone The name of the zone where the managed instance group is located. + /// @param zone The name of thezone where the managed + /// instance group is located. /// @param instance_group_manager The name of the managed instance group. /// @param instance_group_managers_stop_instances_request_resource The InstanceGroupManagersStopInstancesRequest for this request. /// @param opts Optional. Override the class-level options, such as retry and @@ -2753,7 +2887,7 @@ class InstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instance_group_managers.v1.StopInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L1476} + /// [google.cloud.cpp.compute.instance_group_managers.v1.StopInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L1786} /// // clang-format on future> StopInstances( @@ -2787,22 +2921,33 @@ class InstanceGroupManagersClient { /// /// Flags the specified instances in the managed instance group to be /// immediately stopped. You can only specify instances that are running in - /// this request. This method reduces the targetSize and increases the - /// targetStoppedSize of the managed instance group by the number of instances - /// that you stop. The stopInstances operation is marked DONE if the - /// stopInstances request is successful. The underlying actions take additional - /// time. You must separately verify the status of the STOPPING action with the - /// listmanagedinstances method. If the standbyPolicy.initialDelaySec field is - /// set, the group delays stopping the instances until initialDelaySec have - /// passed from instance.creationTimestamp (that is, when the instance was - /// created). This delay gives your application time to set itself up and - /// initialize on the instance. If more than initialDelaySec seconds have - /// passed since instance.creationTimestamp when this method is called, there - /// will be zero delay. 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 stopped. - /// Stopped instances can be started using the startInstances method. You can - /// specify a maximum of 1000 instances with this method per request. + /// this request. This method reduces thetargetSize and increases the + /// targetStoppedSize + /// of the managed instance group by the number of instances that you stop. + /// The stopInstances operation is marked DONE if + /// the stopInstances request is successful. The underlying + /// actions take additional time. You must separately verify the status of + /// theSTOPPING action with thelistmanagedinstances + /// method. + /// + /// If the standbyPolicy.initialDelaySec field is set, the group + /// delays stopping the instances until initialDelaySec have + /// passed from instance.creationTimestamp (that is, when the + /// instance was created). This delay gives your application time to + /// set itself up and initialize on the instance. If more thaninitialDelaySec + /// seconds have passed sinceinstance.creationTimestamp when this method is + /// called, there + /// will be zero delay. + /// + /// 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 stopped. + /// + /// Stopped instances can be started using the startInstances + /// method. + /// + /// You can specify a maximum of 1000 instances with this method per request. /// https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagers/stopInstances /// /// @param request Unary RPCs, such as the one wrapped by this @@ -2831,7 +2976,7 @@ class InstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instance_group_managers.v1.StopInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L1476} + /// [google.cloud.cpp.compute.instance_group_managers.v1.StopInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L1786} /// // clang-format on future> StopInstances( @@ -2873,27 +3018,38 @@ class InstanceGroupManagersClient { /// /// Flags the specified instances in the managed instance group to be /// immediately suspended. You can only specify instances that are running in - /// this request. This method reduces the targetSize and increases the - /// targetSuspendedSize of the managed instance group by the number of - /// instances that you suspend. The suspendInstances operation is marked DONE - /// if the suspendInstances request is successful. The underlying actions take - /// additional time. You must separately verify the status of the SUSPENDING - /// action with the listmanagedinstances method. If the - /// standbyPolicy.initialDelaySec field is set, the group delays suspension of - /// the instances until initialDelaySec have passed from - /// instance.creationTimestamp (that is, when the instance was created). This - /// delay gives your application time to set itself up and initialize on the - /// instance. If more than initialDelaySec seconds have passed since - /// instance.creationTimestamp when this method is called, there will be zero - /// delay. If the group is part of a backend service that has enabled + /// this request. This method reduces thetargetSize and increases the + /// targetSuspendedSize + /// of the managed instance group by the number of instances that you suspend. + /// The suspendInstances operation is marked DONE if + /// the suspendInstances request is successful. The underlying + /// actions take additional time. You must separately verify the status of + /// theSUSPENDING action with thelistmanagedinstances + /// method. + /// + /// If the standbyPolicy.initialDelaySec field is set, the group + /// delays suspension of the instances until initialDelaySec have + /// passed from instance.creationTimestamp (that is, when the + /// instance was created). This delay gives your application time to + /// set itself up and initialize on the instance. If more thaninitialDelaySec + /// seconds have passed sinceinstance.creationTimestamp when this method is + /// called, there + /// will be zero delay. + /// + /// 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 suspended. - /// Suspended instances can be resumed using the resumeInstances method. You - /// can specify a maximum of 1000 instances with this method per request. + /// + /// Suspended instances can be resumed using the resumeInstances + /// method. + /// + /// You can specify a maximum of 1000 instances with this method per request. /// https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagers/suspendInstances /// /// @param project Project ID for this request. - /// @param zone The name of the zone where the managed instance group is located. + /// @param zone The name of thezone where the managed + /// instance group is located. /// @param instance_group_manager The name of the managed instance group. /// @param instance_group_managers_suspend_instances_request_resource The InstanceGroupManagersSuspendInstancesRequest for this request. /// @param opts Optional. Override the class-level options, such as retry and @@ -2916,7 +3072,7 @@ class InstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instance_group_managers.v1.SuspendInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L1516} + /// [google.cloud.cpp.compute.instance_group_managers.v1.SuspendInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L1834} /// // clang-format on future> SuspendInstances( @@ -2950,23 +3106,33 @@ class InstanceGroupManagersClient { /// /// Flags the specified instances in the managed instance group to be /// immediately suspended. You can only specify instances that are running in - /// this request. This method reduces the targetSize and increases the - /// targetSuspendedSize of the managed instance group by the number of - /// instances that you suspend. The suspendInstances operation is marked DONE - /// if the suspendInstances request is successful. The underlying actions take - /// additional time. You must separately verify the status of the SUSPENDING - /// action with the listmanagedinstances method. If the - /// standbyPolicy.initialDelaySec field is set, the group delays suspension of - /// the instances until initialDelaySec have passed from - /// instance.creationTimestamp (that is, when the instance was created). This - /// delay gives your application time to set itself up and initialize on the - /// instance. If more than initialDelaySec seconds have passed since - /// instance.creationTimestamp when this method is called, there will be zero - /// delay. If the group is part of a backend service that has enabled + /// this request. This method reduces thetargetSize and increases the + /// targetSuspendedSize + /// of the managed instance group by the number of instances that you suspend. + /// The suspendInstances operation is marked DONE if + /// the suspendInstances request is successful. The underlying + /// actions take additional time. You must separately verify the status of + /// theSUSPENDING action with thelistmanagedinstances + /// method. + /// + /// If the standbyPolicy.initialDelaySec field is set, the group + /// delays suspension of the instances until initialDelaySec have + /// passed from instance.creationTimestamp (that is, when the + /// instance was created). This delay gives your application time to + /// set itself up and initialize on the instance. If more thaninitialDelaySec + /// seconds have passed sinceinstance.creationTimestamp when this method is + /// called, there + /// will be zero delay. + /// + /// 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 suspended. - /// Suspended instances can be resumed using the resumeInstances method. You - /// can specify a maximum of 1000 instances with this method per request. + /// + /// Suspended instances can be resumed using the resumeInstances + /// method. + /// + /// You can specify a maximum of 1000 instances with this method per request. /// https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagers/suspendInstances /// /// @param request Unary RPCs, such as the one wrapped by this @@ -2995,7 +3161,7 @@ class InstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instance_group_managers.v1.SuspendInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L1516} + /// [google.cloud.cpp.compute.instance_group_managers.v1.SuspendInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L1834} /// // clang-format on future> SuspendInstances( @@ -3036,14 +3202,16 @@ class InstanceGroupManagersClient { // clang-format off /// /// 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. + /// group. perInstanceConfig.name serves as a key used to + /// distinguish whether to perform insert or patch. /// https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagers/updatePerInstanceConfigs /// /// @param project Project ID for this request. - /// @param zone The name of the zone where the managed instance group is located. It should - /// conform to RFC1035. - /// @param instance_group_manager The name of the managed instance group. It should conform to RFC1035. + /// @param zone The name of thezone + /// where the managed instance group is located. + /// It should conform to RFC1035. + /// @param instance_group_manager The name of the managed instance group. + /// It should conform to RFC1035. /// @param instance_group_managers_update_per_instance_configs_req_resource The InstanceGroupManagersUpdatePerInstanceConfigsReq for this request. /// @param opts Optional. Override the class-level options, such as retry and /// backoff policies. @@ -3065,7 +3233,7 @@ class InstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instance_group_managers.v1.UpdatePerInstanceConfigsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L1557} + /// [google.cloud.cpp.compute.instance_group_managers.v1.UpdatePerInstanceConfigsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L1879} /// // clang-format on future> @@ -3099,8 +3267,8 @@ class InstanceGroupManagersClient { // clang-format off /// /// 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. + /// group. perInstanceConfig.name serves as a key used to + /// distinguish whether to perform insert or patch. /// https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagers/updatePerInstanceConfigs /// /// @param request Unary RPCs, such as the one wrapped by this @@ -3129,7 +3297,7 @@ class InstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instance_group_managers.v1.UpdatePerInstanceConfigsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L1557} + /// [google.cloud.cpp.compute.instance_group_managers.v1.UpdatePerInstanceConfigsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L1879} /// // clang-format on future> 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 145560402f9c2..0e0738ffbd1d0 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,13 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_INSTANCE_GROUP_MANAGERS_V1_INSTANCE_GROUP_MANAGERS_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_028.pb.h" -#include "google/cloud/compute/v1/internal/common_040.pb.h" -#include "google/cloud/compute/v1/internal/common_061.pb.h" -#include "google/cloud/compute/v1/internal/common_083.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_037.pb.h" +#include "google/cloud/compute/v1/internal/common_038.pb.h" +#include "google/cloud/compute/v1/internal/common_049.pb.h" +#include "google/cloud/compute/v1/internal/common_075.pb.h" +#include "google/cloud/compute/v1/internal/common_098.pb.h" +#include "google/cloud/compute/v1/internal/common_110.pb.h" // 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_group_managers/v1/internal/instance_group_managers_rest_stub.cc b/google/cloud/compute/instance_group_managers/v1/internal/instance_group_managers_rest_stub.cc index d70d2a1945d36..885fd2e8aac38 100644 --- a/google/cloud/compute/instance_group_managers/v1/internal/instance_group_managers_rest_stub.cc +++ b/google/cloud/compute/instance_group_managers/v1/internal/instance_group_managers_rest_stub.cc @@ -273,6 +273,8 @@ DefaultInstanceGroupManagersRestStub::AsyncDeleteInstanceGroupManager( std::thread t{ [](auto p, auto service, auto request, auto rest_context, auto options) { std::vector> query_params; + query_params.push_back({"no_graceful_shutdown", + (request.no_graceful_shutdown() ? "1" : "0")}); query_params.push_back({"request_id", request.request_id()}); query_params = rest_internal::TrimEmptyQueryParameters(std::move(query_params)); @@ -305,6 +307,8 @@ DefaultInstanceGroupManagersRestStub::DeleteInstanceGroupManager( google::cloud::cpp::compute::instance_group_managers::v1:: DeleteInstanceGroupManagerRequest const& request) { std::vector> query_params; + query_params.push_back( + {"no_graceful_shutdown", (request.no_graceful_shutdown() ? "1" : "0")}); query_params.push_back({"request_id", request.request_id()}); query_params = rest_internal::TrimEmptyQueryParameters(std::move(query_params)); @@ -331,6 +335,8 @@ DefaultInstanceGroupManagersRestStub::AsyncDeleteInstances( std::thread t{ [](auto p, auto service, auto request, auto rest_context, auto options) { std::vector> query_params; + query_params.push_back({"no_graceful_shutdown", + (request.no_graceful_shutdown() ? "1" : "0")}); query_params.push_back({"request_id", request.request_id()}); query_params = rest_internal::TrimEmptyQueryParameters(std::move(query_params)); @@ -365,6 +371,8 @@ DefaultInstanceGroupManagersRestStub::DeleteInstances( google::cloud::cpp::compute::instance_group_managers::v1:: DeleteInstancesRequest const& request) { std::vector> query_params; + query_params.push_back( + {"no_graceful_shutdown", (request.no_graceful_shutdown() ? "1" : "0")}); query_params.push_back({"request_id", request.request_id()}); query_params = rest_internal::TrimEmptyQueryParameters(std::move(query_params)); @@ -746,6 +754,8 @@ DefaultInstanceGroupManagersRestStub::AsyncRecreateInstances( std::thread t{ [](auto p, auto service, auto request, auto rest_context, auto options) { std::vector> query_params; + query_params.push_back({"no_graceful_shutdown", + (request.no_graceful_shutdown() ? "1" : "0")}); query_params.push_back({"request_id", request.request_id()}); query_params = rest_internal::TrimEmptyQueryParameters(std::move(query_params)); @@ -781,6 +791,8 @@ DefaultInstanceGroupManagersRestStub::RecreateInstances( google::cloud::cpp::compute::instance_group_managers::v1:: RecreateInstancesRequest const& request) { std::vector> query_params; + query_params.push_back( + {"no_graceful_shutdown", (request.no_graceful_shutdown() ? "1" : "0")}); query_params.push_back({"request_id", request.request_id()}); query_params = rest_internal::TrimEmptyQueryParameters(std::move(query_params)); @@ -1111,6 +1123,8 @@ DefaultInstanceGroupManagersRestStub::AsyncStopInstances( std::thread t{ [](auto p, auto service, auto request, auto rest_context, auto options) { std::vector> query_params; + query_params.push_back({"no_graceful_shutdown", + (request.no_graceful_shutdown() ? "1" : "0")}); query_params.push_back({"request_id", request.request_id()}); query_params = rest_internal::TrimEmptyQueryParameters(std::move(query_params)); @@ -1146,6 +1160,8 @@ DefaultInstanceGroupManagersRestStub::StopInstances( google::cloud::cpp::compute::instance_group_managers::v1:: StopInstancesRequest const& request) { std::vector> query_params; + query_params.push_back( + {"no_graceful_shutdown", (request.no_graceful_shutdown() ? "1" : "0")}); query_params.push_back({"request_id", request.request_id()}); query_params = rest_internal::TrimEmptyQueryParameters(std::move(query_params)); diff --git a/google/cloud/compute/instance_groups/v1/instance_groups_client.cc b/google/cloud/compute/instance_groups/v1/instance_groups_client.cc index af5d88cda03b2..1d277396cea52 100644 --- a/google/cloud/compute/instance_groups/v1/instance_groups_client.cc +++ b/google/cloud/compute/instance_groups/v1/instance_groups_client.cc @@ -419,6 +419,33 @@ InstanceGroupsClient::SetNamedPorts( return connection_->SetNamedPorts(operation); } +StatusOr +InstanceGroupsClient::TestIamPermissions( + std::string const& project, std::string const& zone, + std::string const& resource, + google::cloud::cpp::compute::v1::TestPermissionsRequest const& + test_permissions_request_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::instance_groups::v1::TestIamPermissionsRequest + request; + request.set_project(project); + request.set_zone(zone); + request.set_resource(resource); + *request.mutable_test_permissions_request_resource() = + test_permissions_request_resource; + return connection_->TestIamPermissions(request); +} + +StatusOr +InstanceGroupsClient::TestIamPermissions( + google::cloud::cpp::compute::instance_groups::v1:: + TestIamPermissionsRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->TestIamPermissions(request); +} + GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END } // namespace compute_instance_groups_v1 } // namespace cloud 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 a0abecae6732d..ddcf97c7f85af 100644 --- a/google/cloud/compute/instance_groups/v1/instance_groups_client.h +++ b/google/cloud/compute/instance_groups/v1/instance_groups_client.h @@ -90,13 +90,15 @@ class InstanceGroupsClient { // clang-format off /// - /// Adds a list of instances to the specified instance group. All of the + /// 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. + /// Read + /// Adding instances for more information. /// https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroups/addInstances /// /// @param project Project ID for this request. - /// @param zone The name of the zone where the instance group is located. + /// @param zone The name of the zone + /// where the instance group is located. /// @param instance_group The name of the instance group where you are adding instances. /// @param instance_groups_add_instances_request_resource The InstanceGroupsAddInstancesRequest for this request. /// @param opts Optional. Override the class-level options, such as retry and @@ -119,7 +121,7 @@ class InstanceGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instance_groups.v1.AddInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_groups/v1/instance_groups.proto#L165} + /// [google.cloud.cpp.compute.instance_groups.v1.AddInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_groups/v1/instance_groups.proto#L190} /// // clang-format on future> AddInstances( @@ -149,9 +151,10 @@ class InstanceGroupsClient { // clang-format off /// - /// Adds a list of instances to the specified instance group. All of the + /// 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. + /// Read + /// Adding instances for more information. /// https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroups/addInstances /// /// @param request Unary RPCs, such as the one wrapped by this @@ -180,7 +183,7 @@ class InstanceGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instance_groups.v1.AddInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_groups/v1/instance_groups.proto#L165} + /// [google.cloud.cpp.compute.instance_groups.v1.AddInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_groups/v1/instance_groups.proto#L190} /// // clang-format on future> AddInstances( @@ -220,9 +223,10 @@ class InstanceGroupsClient { // clang-format off /// - /// Retrieves the list of instance groups and sorts them by zone. To prevent - /// failure, Google recommends that you set the `returnPartialSuccess` - /// parameter to `true`. + /// Retrieves the list of instance groups and sorts them by zone. + /// + /// To prevent failure, Google recommends that you set the + /// `returnPartialSuccess` parameter to `true`. /// https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroups/aggregatedList /// /// @param project Project ID for this request. @@ -248,8 +252,8 @@ class InstanceGroupsClient { /// [`future`]: @ref google::cloud::future /// [`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#L379} + /// [google.cloud.cpp.compute.instance_groups.v1.AggregatedListInstanceGroupsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_groups/v1/instance_groups.proto#L232} + /// [google.cloud.cpp.compute.v1.InstanceGroupsScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_074.proto#L449} /// // clang-format on StreamRange> @@ -358,7 +365,8 @@ class InstanceGroupsClient { /// /// 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. + /// Read + /// Deleting an instance group for more information. /// https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroups/delete /// /// @param request Unary RPCs, such as the one wrapped by this @@ -387,7 +395,7 @@ class InstanceGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instance_groups.v1.DeleteInstanceGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_groups/v1/instance_groups.proto#L285} + /// [google.cloud.cpp.compute.instance_groups.v1.DeleteInstanceGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_groups/v1/instance_groups.proto#L347} /// // clang-format on future> @@ -429,13 +437,16 @@ class InstanceGroupsClient { // clang-format off /// /// 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. + /// instance groups by making a list() request. + /// + /// For managed instance groups, use theinstanceGroupManagers + /// or regionInstanceGroupManagers + /// methods instead. /// https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroups/get /// /// @param project Project ID for this request. - /// @param zone The name of the zone where the instance group is located. + /// @param zone The name of the zone + /// where the instance group is located. /// @param instance_group The name of the instance group. /// @param opts Optional. Override the class-level options, such as retry and /// backoff policies. @@ -450,8 +461,8 @@ class InstanceGroupsClient { /// [`future`]: @ref google::cloud::future /// [`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.instance_groups.v1.GetInstanceGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_groups/v1/instance_groups.proto#L384} + /// [google.cloud.cpp.compute.v1.InstanceGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_073.proto#L43} /// // clang-format on StatusOr GetInstanceGroup( @@ -461,9 +472,11 @@ class InstanceGroupsClient { // clang-format off /// /// 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. + /// instance groups by making a list() request. + /// + /// For managed instance groups, use theinstanceGroupManagers + /// or regionInstanceGroupManagers + /// methods instead. /// https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroups/get /// /// @param request Unary RPCs, such as the one wrapped by this @@ -485,8 +498,8 @@ class InstanceGroupsClient { /// [`future`]: @ref google::cloud::future /// [`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.instance_groups.v1.GetInstanceGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_groups/v1/instance_groups.proto#L384} + /// [google.cloud.cpp.compute.v1.InstanceGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_073.proto#L43} /// // clang-format on StatusOr GetInstanceGroup( @@ -496,12 +509,13 @@ class InstanceGroupsClient { // clang-format off /// - /// Creates an instance group in the specified project using the parameters - /// that are included in the request. + /// Creates an instance group in the specified project using the + /// parameters that are included in the request. /// https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroups/insert /// /// @param project Project ID for this request. - /// @param zone The name of the zone where you want to create the instance group. + /// @param zone The name of the zone + /// where you want to create the instance group. /// @param instance_group_resource The InstanceGroup for this request. /// @param opts Optional. Override the class-level options, such as retry and /// backoff policies. @@ -523,7 +537,7 @@ class InstanceGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instance_groups.v1.InsertInstanceGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_groups/v1/instance_groups.proto#L332} + /// [google.cloud.cpp.compute.instance_groups.v1.InsertInstanceGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_groups/v1/instance_groups.proto#L399} /// // clang-format on future> @@ -551,8 +565,8 @@ class InstanceGroupsClient { // clang-format off /// - /// Creates an instance group in the specified project using the parameters - /// that are included in the request. + /// Creates an instance group in the specified project using the + /// parameters that are included in the request. /// https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroups/insert /// /// @param request Unary RPCs, such as the one wrapped by this @@ -581,7 +595,7 @@ class InstanceGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instance_groups.v1.InsertInstanceGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_groups/v1/instance_groups.proto#L332} + /// [google.cloud.cpp.compute.instance_groups.v1.InsertInstanceGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_groups/v1/instance_groups.proto#L399} /// // clang-format on future> @@ -623,12 +637,16 @@ class InstanceGroupsClient { // clang-format off /// /// Retrieves the list of zonal instance group resources contained within the - /// specified zone. For managed instance groups, use the instanceGroupManagers - /// or regionInstanceGroupManagers methods instead. + /// specified zone. + /// + /// For managed instance groups, use theinstanceGroupManagers + /// or regionInstanceGroupManagers + /// methods instead. /// https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroups/list /// /// @param project Project ID for this request. - /// @param zone The name of the zone where the instance group is located. + /// @param zone The name of thezone + /// where the instance group is located. /// @param opts Optional. Override the class-level options, such as retry and /// backoff policies. /// @return a [StreamRange](@ref google::cloud::StreamRange) @@ -651,8 +669,8 @@ class InstanceGroupsClient { /// [`future`]: @ref google::cloud::future /// [`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.instance_groups.v1.ListInstanceGroupsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_groups/v1/instance_groups.proto#L436} + /// [google.cloud.cpp.compute.v1.InstanceGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_073.proto#L43} /// // clang-format on StreamRange @@ -662,8 +680,11 @@ class InstanceGroupsClient { // clang-format off /// /// Retrieves the list of zonal instance group resources contained within the - /// specified zone. For managed instance groups, use the instanceGroupManagers - /// or regionInstanceGroupManagers methods instead. + /// specified zone. + /// + /// For managed instance groups, use theinstanceGroupManagers + /// or regionInstanceGroupManagers + /// methods instead. /// https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroups/list /// /// @param request Unary RPCs, such as the one wrapped by this @@ -694,8 +715,8 @@ class InstanceGroupsClient { /// [`future`]: @ref google::cloud::future /// [`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.instance_groups.v1.ListInstanceGroupsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_groups/v1/instance_groups.proto#L436} + /// [google.cloud.cpp.compute.v1.InstanceGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_073.proto#L43} /// // clang-format on StreamRange @@ -705,15 +726,17 @@ class InstanceGroupsClient { // clang-format off /// - /// 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. + /// 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. /// https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroups/listInstances /// /// @param project Project ID for this request. - /// @param zone The name of the zone where the instance group is located. - /// @param instance_group The name of the instance group from which you want to generate a list of - /// included instances. + /// @param zone The name of the zone + /// where the instance group is located. + /// @param instance_group The name of the instance group from which you want to generate a list + /// of included instances. /// @param instance_groups_list_instances_request_resource The InstanceGroupsListInstancesRequest for this request. /// @param opts Optional. Override the class-level options, such as retry and /// backoff policies. @@ -737,8 +760,8 @@ class InstanceGroupsClient { /// [`future`]: @ref google::cloud::future /// [`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#L96} + /// [google.cloud.cpp.compute.instance_groups.v1.ListInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_groups/v1/instance_groups.proto#L541} + /// [google.cloud.cpp.compute.v1.InstanceWithNamedPorts]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_073.proto#L115} /// // clang-format on StreamRange @@ -751,9 +774,10 @@ class InstanceGroupsClient { // clang-format off /// - /// 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. + /// 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. /// https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroups/listInstances /// /// @param request Unary RPCs, such as the one wrapped by this @@ -784,8 +808,8 @@ class InstanceGroupsClient { /// [`future`]: @ref google::cloud::future /// [`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#L96} + /// [google.cloud.cpp.compute.instance_groups.v1.ListInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_groups/v1/instance_groups.proto#L541} + /// [google.cloud.cpp.compute.v1.InstanceWithNamedPorts]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_073.proto#L115} /// // clang-format on StreamRange @@ -797,13 +821,17 @@ class InstanceGroupsClient { // clang-format off /// /// 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. + /// 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. /// https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroups/removeInstances /// /// @param project Project ID for this request. - /// @param zone The name of the zone where the instance group is located. + /// @param zone The name of the zone + /// where the instance group is located. /// @param instance_group The name of the instance group where the specified instances will be /// removed. /// @param instance_groups_remove_instances_request_resource The InstanceGroupsRemoveInstancesRequest for this request. @@ -827,7 +855,7 @@ class InstanceGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instance_groups.v1.RemoveInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_groups/v1/instance_groups.proto#L517} + /// [google.cloud.cpp.compute.instance_groups.v1.RemoveInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_groups/v1/instance_groups.proto#L656} /// // clang-format on future> RemoveInstances( @@ -860,9 +888,12 @@ class InstanceGroupsClient { // clang-format off /// /// 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. + /// 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. /// https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroups/removeInstances /// /// @param request Unary RPCs, such as the one wrapped by this @@ -891,7 +922,7 @@ class InstanceGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instance_groups.v1.RemoveInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_groups/v1/instance_groups.proto#L517} + /// [google.cloud.cpp.compute.instance_groups.v1.RemoveInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_groups/v1/instance_groups.proto#L656} /// // clang-format on future> RemoveInstances( @@ -935,7 +966,8 @@ class InstanceGroupsClient { /// https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroups/setNamedPorts /// /// @param project Project ID for this request. - /// @param zone The name of the zone where the instance group is located. + /// @param zone The name of the zone + /// where the instance group is located. /// @param instance_group The name of the instance group where the named ports are updated. /// @param instance_groups_set_named_ports_request_resource The InstanceGroupsSetNamedPortsRequest for this request. /// @param opts Optional. Override the class-level options, such as retry and @@ -958,7 +990,7 @@ class InstanceGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instance_groups.v1.SetNamedPortsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_groups/v1/instance_groups.proto#L556} + /// [google.cloud.cpp.compute.instance_groups.v1.SetNamedPortsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_groups/v1/instance_groups.proto#L699} /// // clang-format on future> SetNamedPorts( @@ -1017,7 +1049,7 @@ class InstanceGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instance_groups.v1.SetNamedPortsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_groups/v1/instance_groups.proto#L556} + /// [google.cloud.cpp.compute.instance_groups.v1.SetNamedPortsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_groups/v1/instance_groups.proto#L699} /// // clang-format on future> SetNamedPorts( @@ -1055,6 +1087,73 @@ class InstanceGroupsClient { google::cloud::cpp::compute::v1::Operation const& operation, Options opts = {}); + // clang-format off + /// + /// Returns permissions that a caller has on the specified resource. + /// https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroups/testIamPermissions + /// + /// @param project Project ID for this request. + /// @param zone The name of the zone for this request. + /// @param resource Name or id of the resource for this request. + /// @param test_permissions_request_resource The TestPermissionsRequest for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.TestPermissionsResponse]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.instance_groups.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_groups/v1/instance_groups.proto#L741} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} + /// + // clang-format on + StatusOr + TestIamPermissions( + std::string const& project, std::string const& zone, + std::string const& resource, + google::cloud::cpp::compute::v1::TestPermissionsRequest const& + test_permissions_request_resource, + Options opts = {}); + + // clang-format off + /// + /// Returns permissions that a caller has on the specified resource. + /// https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroups/testIamPermissions + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.instance_groups.v1.TestIamPermissionsRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.TestPermissionsResponse]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.instance_groups.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_groups/v1/instance_groups.proto#L741} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} + /// + // clang-format on + StatusOr + TestIamPermissions(google::cloud::cpp::compute::instance_groups::v1:: + TestIamPermissionsRequest const& request, + Options opts = {}); + private: std::shared_ptr connection_; Options options_; diff --git a/google/cloud/compute/instance_groups/v1/instance_groups_connection.cc b/google/cloud/compute/instance_groups/v1/instance_groups_connection.cc index fe3e7a1ba8806..ddb61346cbc1f 100644 --- a/google/cloud/compute/instance_groups/v1/instance_groups_connection.cc +++ b/google/cloud/compute/instance_groups/v1/instance_groups_connection.cc @@ -194,6 +194,13 @@ InstanceGroupsConnection::SetNamedPorts( Status(StatusCode::kUnimplemented, "not implemented")); } +StatusOr +InstanceGroupsConnection::TestIamPermissions( + google::cloud::cpp::compute::instance_groups::v1:: + TestIamPermissionsRequest const&) { + return Status(StatusCode::kUnimplemented, "not implemented"); +} + GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END } // namespace compute_instance_groups_v1 } // namespace cloud diff --git a/google/cloud/compute/instance_groups/v1/instance_groups_connection.h b/google/cloud/compute/instance_groups/v1/instance_groups_connection.h index 3fd4fe1ca3bdd..26896a0024e6a 100644 --- a/google/cloud/compute/instance_groups/v1/instance_groups_connection.h +++ b/google/cloud/compute/instance_groups/v1/instance_groups_connection.h @@ -263,6 +263,10 @@ class InstanceGroupsConnection { virtual future> SetNamedPorts(google::cloud::cpp::compute::v1::Operation const& operation); + + virtual StatusOr + TestIamPermissions(google::cloud::cpp::compute::instance_groups::v1:: + TestIamPermissionsRequest const& request); }; GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END diff --git a/google/cloud/compute/instance_groups/v1/instance_groups_connection_idempotency_policy.cc b/google/cloud/compute/instance_groups/v1/instance_groups_connection_idempotency_policy.cc index 1b9b78a2a4c83..53282d15e678e 100644 --- a/google/cloud/compute/instance_groups/v1/instance_groups_connection_idempotency_policy.cc +++ b/google/cloud/compute/instance_groups/v1/instance_groups_connection_idempotency_policy.cc @@ -89,6 +89,12 @@ Idempotency InstanceGroupsConnectionIdempotencyPolicy::SetNamedPorts( return Idempotency::kNonIdempotent; } +Idempotency InstanceGroupsConnectionIdempotencyPolicy::TestIamPermissions( + google::cloud::cpp::compute::instance_groups::v1:: + TestIamPermissionsRequest const&) { + return Idempotency::kNonIdempotent; +} + std::unique_ptr MakeDefaultInstanceGroupsConnectionIdempotencyPolicy() { return std::make_unique(); diff --git a/google/cloud/compute/instance_groups/v1/instance_groups_connection_idempotency_policy.h b/google/cloud/compute/instance_groups/v1/instance_groups_connection_idempotency_policy.h index 4af7d05610ffe..9e2e4a32f2fab 100644 --- a/google/cloud/compute/instance_groups/v1/instance_groups_connection_idempotency_policy.h +++ b/google/cloud/compute/instance_groups/v1/instance_groups_connection_idempotency_policy.h @@ -72,6 +72,10 @@ class InstanceGroupsConnectionIdempotencyPolicy { virtual google::cloud::Idempotency SetNamedPorts( google::cloud::cpp::compute::instance_groups::v1:: SetNamedPortsRequest const& request); + + virtual google::cloud::Idempotency TestIamPermissions( + google::cloud::cpp::compute::instance_groups::v1:: + TestIamPermissionsRequest const& request); }; std::unique_ptr 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 8eb5aa4cfea08..e8df1c6dcdd67 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,12 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_INSTANCE_GROUPS_V1_INSTANCE_GROUPS_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_059.pb.h" -#include "google/cloud/compute/v1/internal/common_060.pb.h" -#include "google/cloud/compute/v1/internal/common_063.pb.h" -#include "google/cloud/compute/v1/internal/common_083.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_073.pb.h" +#include "google/cloud/compute/v1/internal/common_074.pb.h" +#include "google/cloud/compute/v1/internal/common_078.pb.h" +#include "google/cloud/compute/v1/internal/common_098.pb.h" +#include "google/cloud/compute/v1/internal/common_171.pb.h" // 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_groups/v1/internal/instance_groups_rest_connection_impl.cc b/google/cloud/compute/instance_groups/v1/internal/instance_groups_rest_connection_impl.cc index 7711c27ea0083..8b77c3f749e58 100644 --- a/google/cloud/compute/instance_groups/v1/internal/instance_groups_rest_connection_impl.cc +++ b/google/cloud/compute/instance_groups/v1/internal/instance_groups_rest_connection_impl.cc @@ -832,6 +832,22 @@ InstanceGroupsRestConnectionImpl::SetNamedPorts( }); } +StatusOr +InstanceGroupsRestConnectionImpl::TestIamPermissions( + google::cloud::cpp::compute::instance_groups::v1:: + TestIamPermissionsRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->TestIamPermissions(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::instance_groups::v1:: + TestIamPermissionsRequest const& request) { + return stub_->TestIamPermissions(rest_context, options, request); + }, + *current, request, __func__); +} + GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END } // namespace compute_instance_groups_v1_internal } // namespace cloud diff --git a/google/cloud/compute/instance_groups/v1/internal/instance_groups_rest_connection_impl.h b/google/cloud/compute/instance_groups/v1/internal/instance_groups_rest_connection_impl.h index fb7274910a49a..c5084d9f7ead2 100644 --- a/google/cloud/compute/instance_groups/v1/internal/instance_groups_rest_connection_impl.h +++ b/google/cloud/compute/instance_groups/v1/internal/instance_groups_rest_connection_impl.h @@ -128,6 +128,10 @@ class InstanceGroupsRestConnectionImpl future> SetNamedPorts( google::cloud::cpp::compute::v1::Operation const& operation) override; + StatusOr + TestIamPermissions(google::cloud::cpp::compute::instance_groups::v1:: + TestIamPermissionsRequest const& request) override; + private: static std::unique_ptr retry_policy(Options const& options) { diff --git a/google/cloud/compute/instance_groups/v1/internal/instance_groups_rest_logging_decorator.cc b/google/cloud/compute/instance_groups/v1/internal/instance_groups_rest_logging_decorator.cc index a762fbce90732..20d2886e15042 100644 --- a/google/cloud/compute/instance_groups/v1/internal/instance_groups_rest_logging_decorator.cc +++ b/google/cloud/compute/instance_groups/v1/internal/instance_groups_rest_logging_decorator.cc @@ -261,6 +261,20 @@ InstanceGroupsRestLogging::SetNamedPorts( rest_context, options, request, __func__, tracing_options_); } +StatusOr +InstanceGroupsRestLogging::TestIamPermissions( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::instance_groups::v1:: + TestIamPermissionsRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::instance_groups::v1:: + TestIamPermissionsRequest const& request) { + return child_->TestIamPermissions(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + future> InstanceGroupsRestLogging::AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/instance_groups/v1/internal/instance_groups_rest_logging_decorator.h b/google/cloud/compute/instance_groups/v1/internal/instance_groups_rest_logging_decorator.h index 7b57f38e1a55d..775302d3c3d09 100644 --- a/google/cloud/compute/instance_groups/v1/internal/instance_groups_rest_logging_decorator.h +++ b/google/cloud/compute/instance_groups/v1/internal/instance_groups_rest_logging_decorator.h @@ -137,6 +137,12 @@ class InstanceGroupsRestLogging : public InstanceGroupsRestStub { google::cloud::cpp::compute::instance_groups::v1:: SetNamedPortsRequest const& request) override; + StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::instance_groups::v1:: + TestIamPermissionsRequest const& request) override; + future> AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/instance_groups/v1/internal/instance_groups_rest_metadata_decorator.cc b/google/cloud/compute/instance_groups/v1/internal/instance_groups_rest_metadata_decorator.cc index 5ed7fe3cc4fe9..9f4c29d07fc28 100644 --- a/google/cloud/compute/instance_groups/v1/internal/instance_groups_rest_metadata_decorator.cc +++ b/google/cloud/compute/instance_groups/v1/internal/instance_groups_rest_metadata_decorator.cc @@ -180,6 +180,15 @@ InstanceGroupsRestMetadata::SetNamedPorts( return child_->SetNamedPorts(rest_context, options, request); } +StatusOr +InstanceGroupsRestMetadata::TestIamPermissions( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::instance_groups::v1:: + TestIamPermissionsRequest const& request) { + SetMetadata(rest_context, options); + return child_->TestIamPermissions(rest_context, options, request); +} + future> InstanceGroupsRestMetadata::AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/instance_groups/v1/internal/instance_groups_rest_metadata_decorator.h b/google/cloud/compute/instance_groups/v1/internal/instance_groups_rest_metadata_decorator.h index bfbe7cbcbac7e..eab46647d2de5 100644 --- a/google/cloud/compute/instance_groups/v1/internal/instance_groups_rest_metadata_decorator.h +++ b/google/cloud/compute/instance_groups/v1/internal/instance_groups_rest_metadata_decorator.h @@ -135,6 +135,12 @@ class InstanceGroupsRestMetadata : public InstanceGroupsRestStub { google::cloud::cpp::compute::instance_groups::v1:: SetNamedPortsRequest const& request) override; + StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::instance_groups::v1:: + TestIamPermissionsRequest const& request) override; + google::cloud::future> AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/instance_groups/v1/internal/instance_groups_rest_stub.cc b/google/cloud/compute/instance_groups/v1/internal/instance_groups_rest_stub.cc index 11942205405be..6fa2cf1fe6184 100644 --- a/google/cloud/compute/instance_groups/v1/internal/instance_groups_rest_stub.cc +++ b/google/cloud/compute/instance_groups/v1/internal/instance_groups_rest_stub.cc @@ -441,6 +441,25 @@ DefaultInstanceGroupsRestStub::SetNamedPorts( std::move(query_params)); } +StatusOr +DefaultInstanceGroupsRestStub::TestIamPermissions( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::instance_groups::v1:: + TestIamPermissionsRequest const& request) { + std::vector> query_params; + return rest_internal::Post< + google::cloud::cpp::compute::v1::TestPermissionsResponse>( + *service_, rest_context, request.test_permissions_request_resource(), + false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "zones", "/", + request.zone(), "/", "instanceGroups", "/", + request.resource(), "/", "testIamPermissions"), + std::move(query_params)); +} + future> DefaultInstanceGroupsRestStub::AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/instance_groups/v1/internal/instance_groups_rest_stub.h b/google/cloud/compute/instance_groups/v1/internal/instance_groups_rest_stub.h index 699c86660ad21..5a0d86bf39788 100644 --- a/google/cloud/compute/instance_groups/v1/internal/instance_groups_rest_stub.h +++ b/google/cloud/compute/instance_groups/v1/internal/instance_groups_rest_stub.h @@ -132,6 +132,12 @@ class InstanceGroupsRestStub { google::cloud::cpp::compute::instance_groups::v1:: SetNamedPortsRequest const& request) = 0; + virtual StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::instance_groups::v1:: + TestIamPermissionsRequest const& request) = 0; + virtual future> AsyncGetOperation( google::cloud::CompletionQueue& cq, @@ -252,6 +258,12 @@ class DefaultInstanceGroupsRestStub : public InstanceGroupsRestStub { google::cloud::cpp::compute::instance_groups::v1:: SetNamedPortsRequest const& request) override; + StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::instance_groups::v1:: + TestIamPermissionsRequest const& request) override; + future> AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/instance_groups/v1/internal/instance_groups_tracing_connection.cc b/google/cloud/compute/instance_groups/v1/internal/instance_groups_tracing_connection.cc index 60969134a114a..c8bf4c60075b3 100644 --- a/google/cloud/compute/instance_groups/v1/internal/instance_groups_tracing_connection.cc +++ b/google/cloud/compute/instance_groups/v1/internal/instance_groups_tracing_connection.cc @@ -242,6 +242,17 @@ InstanceGroupsTracingConnection::SetNamedPorts( return internal::EndSpan(std::move(span), child_->SetNamedPorts(operation)); } +StatusOr +InstanceGroupsTracingConnection::TestIamPermissions( + google::cloud::cpp::compute::instance_groups::v1:: + TestIamPermissionsRequest const& request) { + auto span = internal::MakeSpan( + "compute_instance_groups_v1::InstanceGroupsConnection::" + "TestIamPermissions"); + auto scope = opentelemetry::trace::Scope(span); + return internal::EndSpan(*span, child_->TestIamPermissions(request)); +} + std::shared_ptr MakeInstanceGroupsTracingConnection( std::shared_ptr diff --git a/google/cloud/compute/instance_groups/v1/internal/instance_groups_tracing_connection.h b/google/cloud/compute/instance_groups/v1/internal/instance_groups_tracing_connection.h index 2411e33285b74..ca892405c5120 100644 --- a/google/cloud/compute/instance_groups/v1/internal/instance_groups_tracing_connection.h +++ b/google/cloud/compute/instance_groups/v1/internal/instance_groups_tracing_connection.h @@ -115,6 +115,10 @@ class InstanceGroupsTracingConnection future> SetNamedPorts( google::cloud::cpp::compute::v1::Operation const& operation) override; + StatusOr + TestIamPermissions(google::cloud::cpp::compute::instance_groups::v1:: + TestIamPermissionsRequest const& request) override; + private: std::shared_ptr child_; }; diff --git a/google/cloud/compute/instance_groups/v1/mocks/mock_instance_groups_connection.h b/google/cloud/compute/instance_groups/v1/mocks/mock_instance_groups_connection.h index 1118009602807..21a531ca5c239 100644 --- a/google/cloud/compute/instance_groups/v1/mocks/mock_instance_groups_connection.h +++ b/google/cloud/compute/instance_groups/v1/mocks/mock_instance_groups_connection.h @@ -278,6 +278,13 @@ class MockInstanceGroupsConnection SetNamedPorts, (google::cloud::cpp::compute::v1::Operation const& operation), (override)); + + MOCK_METHOD( + StatusOr, + TestIamPermissions, + (google::cloud::cpp::compute::instance_groups::v1:: + TestIamPermissionsRequest const& request), + (override)); }; GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END 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..65fde2fa6ad43 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_079.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_079.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 f9beef5cc16eb..3dc6579186a30 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 "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_064.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_079.pb.h" // 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 933ca846657c7..6ad9699dcb35b 100644 --- a/google/cloud/compute/instance_templates/v1/instance_templates_client.h +++ b/google/cloud/compute/instance_templates/v1/instance_templates_client.h @@ -92,8 +92,10 @@ class InstanceTemplatesClient { // clang-format off /// /// 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`. + /// available to the specified project. + /// + /// To prevent failure, Google recommends that you set the + /// `returnPartialSuccess` parameter to `true`. /// https://cloud.google.com/compute/docs/reference/rest/v1/instanceTemplates/aggregatedList /// /// @param project Name of the project scoping this request. @@ -119,8 +121,8 @@ class InstanceTemplatesClient { /// [`future`]: @ref google::cloud::future /// [`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#L134} + /// [google.cloud.cpp.compute.instance_templates.v1.AggregatedListInstanceTemplatesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_templates/v1/instance_templates.proto#L146} + /// [google.cloud.cpp.compute.v1.InstanceTemplatesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_080.proto#L155} /// // clang-format on StreamRange< @@ -132,8 +134,10 @@ class InstanceTemplatesClient { // clang-format off /// /// 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`. + /// available to the specified project. + /// + /// To prevent failure, Google recommends that you set the + /// `returnPartialSuccess` parameter to `true`. /// https://cloud.google.com/compute/docs/reference/rest/v1/instanceTemplates/aggregatedList /// /// @param request Unary RPCs, such as the one wrapped by this @@ -164,8 +168,8 @@ class InstanceTemplatesClient { /// [`future`]: @ref google::cloud::future /// [`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#L134} + /// [google.cloud.cpp.compute.instance_templates.v1.AggregatedListInstanceTemplatesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_templates/v1/instance_templates.proto#L146} + /// [google.cloud.cpp.compute.v1.InstanceTemplatesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_080.proto#L155} /// // clang-format on StreamRange< @@ -179,8 +183,8 @@ class InstanceTemplatesClient { // clang-format off /// /// 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. + /// permanent and cannot be undone. It is not possible to delete templates + /// that are already in use by a managed instance group. /// https://cloud.google.com/compute/docs/reference/rest/v1/instanceTemplates/delete /// /// @param project Project ID for this request. @@ -205,7 +209,7 @@ class InstanceTemplatesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instance_templates.v1.DeleteInstanceTemplateRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_templates/v1/instance_templates.proto#L225} + /// [google.cloud.cpp.compute.instance_templates.v1.DeleteInstanceTemplateRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_templates/v1/instance_templates.proto#L261} /// // clang-format on future> @@ -231,8 +235,8 @@ class InstanceTemplatesClient { // clang-format off /// /// 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. + /// permanent and cannot be undone. It is not possible to delete templates + /// that are already in use by a managed instance group. /// https://cloud.google.com/compute/docs/reference/rest/v1/instanceTemplates/delete /// /// @param request Unary RPCs, such as the one wrapped by this @@ -261,7 +265,7 @@ class InstanceTemplatesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instance_templates.v1.DeleteInstanceTemplateRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_templates/v1/instance_templates.proto#L225} + /// [google.cloud.cpp.compute.instance_templates.v1.DeleteInstanceTemplateRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_templates/v1/instance_templates.proto#L261} /// // clang-format on future> @@ -320,8 +324,8 @@ class InstanceTemplatesClient { /// [`future`]: @ref google::cloud::future /// [`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_024.proto#L85} + /// [google.cloud.cpp.compute.instance_templates.v1.GetInstanceTemplateRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_templates/v1/instance_templates.proto#L305} + /// [google.cloud.cpp.compute.v1.InstanceTemplate]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_033.proto#L109} /// // clang-format on StatusOr @@ -352,8 +356,8 @@ class InstanceTemplatesClient { /// [`future`]: @ref google::cloud::future /// [`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_024.proto#L85} + /// [google.cloud.cpp.compute.instance_templates.v1.GetInstanceTemplateRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_templates/v1/instance_templates.proto#L305} + /// [google.cloud.cpp.compute.v1.InstanceTemplate]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_033.proto#L109} /// // clang-format on StatusOr @@ -382,8 +386,8 @@ class InstanceTemplatesClient { /// [`future`]: @ref google::cloud::future /// [`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_007.proto#L178} + /// [google.cloud.cpp.compute.instance_templates.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_templates/v1/instance_templates.proto#L290} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr GetIamPolicy( @@ -415,8 +419,8 @@ class InstanceTemplatesClient { /// [`future`]: @ref google::cloud::future /// [`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_007.proto#L178} + /// [google.cloud.cpp.compute.instance_templates.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_templates/v1/instance_templates.proto#L290} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr GetIamPolicy( @@ -426,10 +430,11 @@ class InstanceTemplatesClient { // clang-format off /// - /// 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. + /// 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. /// https://cloud.google.com/compute/docs/reference/rest/v1/instanceTemplates/insert /// /// @param project Project ID for this request. @@ -454,7 +459,7 @@ class InstanceTemplatesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instance_templates.v1.InsertInstanceTemplateRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_templates/v1/instance_templates.proto#L277} + /// [google.cloud.cpp.compute.instance_templates.v1.InsertInstanceTemplateRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_templates/v1/instance_templates.proto#L316} /// // clang-format on future> @@ -483,10 +488,11 @@ class InstanceTemplatesClient { // clang-format off /// - /// 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. + /// 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. /// https://cloud.google.com/compute/docs/reference/rest/v1/instanceTemplates/insert /// /// @param request Unary RPCs, such as the one wrapped by this @@ -515,7 +521,7 @@ class InstanceTemplatesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instance_templates.v1.InsertInstanceTemplateRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_templates/v1/instance_templates.proto#L277} + /// [google.cloud.cpp.compute.instance_templates.v1.InsertInstanceTemplateRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_templates/v1/instance_templates.proto#L316} /// // clang-format on future> @@ -556,8 +562,8 @@ class InstanceTemplatesClient { // clang-format off /// - /// Retrieves a list of instance templates that are contained within the - /// specified project. + /// Retrieves a list of instance templates that are contained within + /// the specified project. /// https://cloud.google.com/compute/docs/reference/rest/v1/instanceTemplates/list /// /// @param project Project ID for this request. @@ -583,8 +589,8 @@ class InstanceTemplatesClient { /// [`future`]: @ref google::cloud::future /// [`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_024.proto#L85} + /// [google.cloud.cpp.compute.instance_templates.v1.ListInstanceTemplatesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_templates/v1/instance_templates.proto#L345} + /// [google.cloud.cpp.compute.v1.InstanceTemplate]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_033.proto#L109} /// // clang-format on StreamRange @@ -592,8 +598,8 @@ class InstanceTemplatesClient { // clang-format off /// - /// Retrieves a list of instance templates that are contained within the - /// specified project. + /// Retrieves a list of instance templates that are contained within + /// the specified project. /// https://cloud.google.com/compute/docs/reference/rest/v1/instanceTemplates/list /// /// @param request Unary RPCs, such as the one wrapped by this @@ -624,8 +630,8 @@ class InstanceTemplatesClient { /// [`future`]: @ref google::cloud::future /// [`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_024.proto#L85} + /// [google.cloud.cpp.compute.instance_templates.v1.ListInstanceTemplatesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_templates/v1/instance_templates.proto#L345} + /// [google.cloud.cpp.compute.v1.InstanceTemplate]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_033.proto#L109} /// // clang-format on StreamRange @@ -635,8 +641,8 @@ class InstanceTemplatesClient { // clang-format off /// - /// Sets the access control policy on the specified resource. Replaces any - /// existing policy. + /// Sets the access control policy on the specified resource. + /// Replaces any existing policy. /// https://cloud.google.com/compute/docs/reference/rest/v1/instanceTemplates/setIamPolicy /// /// @param project Project ID for this request. @@ -655,8 +661,8 @@ class InstanceTemplatesClient { /// [`future`]: @ref google::cloud::future /// [`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_007.proto#L178} + /// [google.cloud.cpp.compute.instance_templates.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_templates/v1/instance_templates.proto#L446} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr SetIamPolicy( @@ -667,8 +673,8 @@ class InstanceTemplatesClient { // clang-format off /// - /// Sets the access control policy on the specified resource. Replaces any - /// existing policy. + /// Sets the access control policy on the specified resource. + /// Replaces any existing policy. /// https://cloud.google.com/compute/docs/reference/rest/v1/instanceTemplates/setIamPolicy /// /// @param request Unary RPCs, such as the one wrapped by this @@ -690,8 +696,8 @@ class InstanceTemplatesClient { /// [`future`]: @ref google::cloud::future /// [`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_007.proto#L178} + /// [google.cloud.cpp.compute.instance_templates.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_templates/v1/instance_templates.proto#L446} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr SetIamPolicy( @@ -720,8 +726,8 @@ class InstanceTemplatesClient { /// [`future`]: @ref google::cloud::future /// [`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_145.proto#L30} + /// [google.cloud.cpp.compute.instance_templates.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_templates/v1/instance_templates.proto#L462} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} /// // clang-format on StatusOr @@ -755,8 +761,8 @@ class InstanceTemplatesClient { /// [`future`]: @ref google::cloud::future /// [`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_145.proto#L30} + /// [google.cloud.cpp.compute.instance_templates.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_templates/v1/instance_templates.proto#L462} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.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 143ec0382f3cc..787759c1fe808 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 @@ -27,18 +27,18 @@ // IWYU pragma: begin_exports #include "google/cloud/compute/v1/internal/common_001.pb.h" -#include "google/cloud/compute/v1/internal/common_003.pb.h" -#include "google/cloud/compute/v1/internal/common_007.pb.h" -#include "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_021.pb.h" -#include "google/cloud/compute/v1/internal/common_024.pb.h" -#include "google/cloud/compute/v1/internal/common_029.pb.h" -#include "google/cloud/compute/v1/internal/common_031.pb.h" +#include "google/cloud/compute/v1/internal/common_004.pb.h" +#include "google/cloud/compute/v1/internal/common_009.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_028.pb.h" #include "google/cloud/compute/v1/internal/common_033.pb.h" -#include "google/cloud/compute/v1/internal/common_047.pb.h" -#include "google/cloud/compute/v1/internal/common_065.pb.h" -#include "google/cloud/compute/v1/internal/common_081.pb.h" -#include "google/cloud/compute/v1/internal/common_145.pb.h" +#include "google/cloud/compute/v1/internal/common_038.pb.h" +#include "google/cloud/compute/v1/internal/common_040.pb.h" +#include "google/cloud/compute/v1/internal/common_042.pb.h" +#include "google/cloud/compute/v1/internal/common_057.pb.h" +#include "google/cloud/compute/v1/internal/common_080.pb.h" +#include "google/cloud/compute/v1/internal/common_096.pb.h" +#include "google/cloud/compute/v1/internal/common_171.pb.h" // 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.cc b/google/cloud/compute/instances/v1/instances_client.cc index 68167551ecbf0..810d5919d8568 100644 --- a/google/cloud/compute/instances/v1/instances_client.cc +++ b/google/cloud/compute/instances/v1/instances_client.cc @@ -90,6 +90,66 @@ InstancesClient::AddAccessConfig( return connection_->AddAccessConfig(operation); } +future> +InstancesClient::AddNetworkInterface( + std::string const& project, std::string const& zone, + std::string const& instance, + google::cloud::cpp::compute::v1::NetworkInterface const& + network_interface_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::instances::v1::AddNetworkInterfaceRequest + request; + request.set_project(project); + request.set_zone(zone); + request.set_instance(instance); + *request.mutable_network_interface_resource() = network_interface_resource; + return connection_->AddNetworkInterface(request); +} + +StatusOr +InstancesClient::AddNetworkInterface( + NoAwaitTag, std::string const& project, std::string const& zone, + std::string const& instance, + google::cloud::cpp::compute::v1::NetworkInterface const& + network_interface_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::instances::v1::AddNetworkInterfaceRequest + request; + request.set_project(project); + request.set_zone(zone); + request.set_instance(instance); + *request.mutable_network_interface_resource() = network_interface_resource; + return connection_->AddNetworkInterface(NoAwaitTag{}, request); +} + +future> +InstancesClient::AddNetworkInterface( + google::cloud::cpp::compute::instances::v1:: + AddNetworkInterfaceRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->AddNetworkInterface(request); +} + +StatusOr +InstancesClient::AddNetworkInterface( + NoAwaitTag, + google::cloud::cpp::compute::instances::v1:: + AddNetworkInterfaceRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->AddNetworkInterface(NoAwaitTag{}, request); +} + +future> +InstancesClient::AddNetworkInterface( + google::cloud::cpp::compute::v1::Operation const& operation, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->AddNetworkInterface(operation); +} + future> InstancesClient::AddResourcePolicies( std::string const& project, std::string const& zone, @@ -395,6 +455,62 @@ InstancesClient::DeleteAccessConfig( return connection_->DeleteAccessConfig(operation); } +future> +InstancesClient::DeleteNetworkInterface( + std::string const& project, std::string const& zone, + std::string const& instance, std::string const& network_interface_name, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::instances::v1::DeleteNetworkInterfaceRequest + request; + request.set_project(project); + request.set_zone(zone); + request.set_instance(instance); + request.set_network_interface_name(network_interface_name); + return connection_->DeleteNetworkInterface(request); +} + +StatusOr +InstancesClient::DeleteNetworkInterface( + NoAwaitTag, std::string const& project, std::string const& zone, + std::string const& instance, std::string const& network_interface_name, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::instances::v1::DeleteNetworkInterfaceRequest + request; + request.set_project(project); + request.set_zone(zone); + request.set_instance(instance); + request.set_network_interface_name(network_interface_name); + return connection_->DeleteNetworkInterface(NoAwaitTag{}, request); +} + +future> +InstancesClient::DeleteNetworkInterface( + google::cloud::cpp::compute::instances::v1:: + DeleteNetworkInterfaceRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->DeleteNetworkInterface(request); +} + +StatusOr +InstancesClient::DeleteNetworkInterface( + NoAwaitTag, + google::cloud::cpp::compute::instances::v1:: + DeleteNetworkInterfaceRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->DeleteNetworkInterface(NoAwaitTag{}, request); +} + +future> +InstancesClient::DeleteNetworkInterface( + google::cloud::cpp::compute::v1::Operation const& operation, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->DeleteNetworkInterface(operation); +} + future> InstancesClient::DetachDisk(std::string const& project, std::string const& zone, std::string const& instance, diff --git a/google/cloud/compute/instances/v1/instances_client.h b/google/cloud/compute/instances/v1/instances_client.h index d5d4577785289..61c2bf1301dd5 100644 --- a/google/cloud/compute/instances/v1/instances_client.h +++ b/google/cloud/compute/instances/v1/instances_client.h @@ -116,7 +116,7 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instances.v1.AddAccessConfigRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L695} + /// [google.cloud.cpp.compute.instances.v1.AddAccessConfigRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L745} /// // clang-format on future> AddAccessConfig( @@ -175,7 +175,7 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instances.v1.AddAccessConfigRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L695} + /// [google.cloud.cpp.compute.instances.v1.AddAccessConfigRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L745} /// // clang-format on future> AddAccessConfig( @@ -215,8 +215,136 @@ class InstancesClient { // clang-format off /// - /// 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 + /// Adds one dynamic network interface to an active instance. + /// https://cloud.google.com/compute/docs/reference/rest/v1/instances/addNetworkInterface + /// + /// @param project Project ID for this request. + /// @param zone The name of the zone for this request. + /// @param instance The instance name for this request stored as resource_id. + /// Name should conform to RFC1035 or be an unsigned long integer. + /// @param network_interface_resource The NetworkInterface for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.instances.v1.AddNetworkInterfaceRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L789} + /// + // clang-format on + future> + AddNetworkInterface(std::string const& project, std::string const& zone, + std::string const& instance, + google::cloud::cpp::compute::v1::NetworkInterface const& + network_interface_resource, + Options opts = {}); + + // clang-format off + /// + /// @copybrief AddNetworkInterface + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr AddNetworkInterface( + NoAwaitTag, std::string const& project, std::string const& zone, + std::string const& instance, + google::cloud::cpp::compute::v1::NetworkInterface const& + network_interface_resource, + Options opts = {}); + + // clang-format off + /// + /// Adds one dynamic network interface to an active instance. + /// https://cloud.google.com/compute/docs/reference/rest/v1/instances/addNetworkInterface + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.instances.v1.AddNetworkInterfaceRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.instances.v1.AddNetworkInterfaceRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L789} + /// + // clang-format on + future> + AddNetworkInterface(google::cloud::cpp::compute::instances::v1:: + AddNetworkInterfaceRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief AddNetworkInterface + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr AddNetworkInterface( + NoAwaitTag, + google::cloud::cpp::compute::instances::v1:: + AddNetworkInterfaceRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief AddNetworkInterface + /// + /// This method accepts a `google::cloud::cpp::compute::v1::Operation` that corresponds + /// to a previously started Long Running Operation (LRO) and polls the status + /// of the LRO in the background. + /// + // clang-format on + future> + AddNetworkInterface( + google::cloud::cpp::compute::v1::Operation const& operation, + Options opts = {}); + + // clang-format off + /// + /// 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. /// https://cloud.google.com/compute/docs/reference/rest/v1/instances/addResourcePolicies /// @@ -244,7 +372,7 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instances.v1.AddResourcePoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L736} + /// [google.cloud.cpp.compute.instances.v1.AddResourcePoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L830} /// // clang-format on future> @@ -276,8 +404,8 @@ class InstancesClient { // clang-format off /// - /// 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 + /// 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. /// https://cloud.google.com/compute/docs/reference/rest/v1/instances/addResourcePolicies /// @@ -307,7 +435,7 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instances.v1.AddResourcePoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L736} + /// [google.cloud.cpp.compute.instances.v1.AddResourcePoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L830} /// // clang-format on future> @@ -348,9 +476,12 @@ class InstancesClient { // clang-format off /// - /// 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. + /// 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`. /// https://cloud.google.com/compute/docs/reference/rest/v1/instances/aggregatedList @@ -378,8 +509,8 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`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#L774} - /// [google.cloud.cpp.compute.v1.InstancesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_022.proto#L751} + /// [google.cloud.cpp.compute.instances.v1.AggregatedListInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L871} + /// [google.cloud.cpp.compute.v1.InstancesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_029.proto#L899} /// // clang-format on StreamRange> AttachDisk( @@ -496,10 +630,10 @@ class InstancesClient { // clang-format off /// - /// 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. + /// 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, readAdding a + /// persistent disk to your instance. /// https://cloud.google.com/compute/docs/reference/rest/v1/instances/attachDisk /// /// @param request Unary RPCs, such as the one wrapped by this @@ -528,7 +662,7 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instances.v1.AttachDiskRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L856} + /// [google.cloud.cpp.compute.instances.v1.AttachDiskRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L986} /// // clang-format on future> AttachDisk( @@ -569,7 +703,8 @@ class InstancesClient { // clang-format off /// /// Creates multiple instances. Count specifies the number of instances to - /// create. For more information, see About bulk creation of VMs. + /// create. For more information, seeAbout bulk + /// creation of VMs. /// https://cloud.google.com/compute/docs/reference/rest/v1/instances/bulkInsert /// /// @param project Project ID for this request. @@ -595,7 +730,7 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instances.v1.BulkInsertRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L898} + /// [google.cloud.cpp.compute.instances.v1.BulkInsertRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1031} /// // clang-format on future> BulkInsert( @@ -624,7 +759,8 @@ class InstancesClient { // clang-format off /// /// Creates multiple instances. Count specifies the number of instances to - /// create. For more information, see About bulk creation of VMs. + /// create. For more information, seeAbout bulk + /// creation of VMs. /// https://cloud.google.com/compute/docs/reference/rest/v1/instances/bulkInsert /// /// @param request Unary RPCs, such as the one wrapped by this @@ -653,7 +789,7 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instances.v1.BulkInsertRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L898} + /// [google.cloud.cpp.compute.instances.v1.BulkInsertRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1031} /// // clang-format on future> BulkInsert( @@ -693,7 +829,7 @@ class InstancesClient { // clang-format off /// - /// Deletes the specified Instance resource. For more information, see Deleting + /// Deletes the specified Instance resource. For more information, seeDeleting /// an instance. /// https://cloud.google.com/compute/docs/reference/rest/v1/instances/delete /// @@ -720,7 +856,7 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instances.v1.DeleteInstanceRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L972} + /// [google.cloud.cpp.compute.instances.v1.DeleteInstanceRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1111} /// // clang-format on future> DeleteInstance( @@ -744,7 +880,7 @@ class InstancesClient { // clang-format off /// - /// Deletes the specified Instance resource. For more information, see Deleting + /// Deletes the specified Instance resource. For more information, seeDeleting /// an instance. /// https://cloud.google.com/compute/docs/reference/rest/v1/instances/delete /// @@ -774,7 +910,7 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instances.v1.DeleteInstanceRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L972} + /// [google.cloud.cpp.compute.instances.v1.DeleteInstanceRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1111} /// // clang-format on future> DeleteInstance( @@ -842,7 +978,7 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instances.v1.DeleteAccessConfigRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L931} + /// [google.cloud.cpp.compute.instances.v1.DeleteAccessConfigRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1067} /// // clang-format on future> @@ -898,7 +1034,7 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instances.v1.DeleteAccessConfigRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L931} + /// [google.cloud.cpp.compute.instances.v1.DeleteAccessConfigRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1067} /// // clang-format on future> @@ -937,6 +1073,139 @@ class InstancesClient { google::cloud::cpp::compute::v1::Operation const& operation, Options opts = {}); + // clang-format off + /// + /// Deletes one dynamic network interface from an active instance. + /// InstancesDeleteNetworkInterfaceRequest indicates: + /// - instance from which to delete, using project+zone+resource_id fields; + /// - dynamic network interface to be deleted, using network_interface_name + /// field; + /// https://cloud.google.com/compute/docs/reference/rest/v1/instances/deleteNetworkInterface + /// + /// @param project Project ID for this request. + /// @param zone The name of the zone for this request. + /// @param instance The instance name for this request stored as resource_id. + /// Name should conform to RFC1035 or be an unsigned long integer. + /// @param network_interface_name The name of the dynamic network interface to be deleted from the instance. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.instances.v1.DeleteNetworkInterfaceRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1150} + /// + // clang-format on + future> + DeleteNetworkInterface(std::string const& project, std::string const& zone, + std::string const& instance, + std::string const& network_interface_name, + Options opts = {}); + + // clang-format off + /// + /// @copybrief DeleteNetworkInterface + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr DeleteNetworkInterface( + NoAwaitTag, std::string const& project, std::string const& zone, + std::string const& instance, std::string const& network_interface_name, + Options opts = {}); + + // clang-format off + /// + /// Deletes one dynamic network interface from an active instance. + /// InstancesDeleteNetworkInterfaceRequest indicates: + /// - instance from which to delete, using project+zone+resource_id fields; + /// - dynamic network interface to be deleted, using network_interface_name + /// field; + /// https://cloud.google.com/compute/docs/reference/rest/v1/instances/deleteNetworkInterface + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.instances.v1.DeleteNetworkInterfaceRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.instances.v1.DeleteNetworkInterfaceRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1150} + /// + // clang-format on + future> + DeleteNetworkInterface(google::cloud::cpp::compute::instances::v1:: + DeleteNetworkInterfaceRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief DeleteNetworkInterface + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr DeleteNetworkInterface( + NoAwaitTag, + google::cloud::cpp::compute::instances::v1:: + DeleteNetworkInterfaceRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief DeleteNetworkInterface + /// + /// This method accepts a `google::cloud::cpp::compute::v1::Operation` that corresponds + /// to a previously started Long Running Operation (LRO) and polls the status + /// of the LRO in the background. + /// + // clang-format on + future> + DeleteNetworkInterface( + google::cloud::cpp::compute::v1::Operation const& operation, + Options opts = {}); + // clang-format off /// /// Detaches a disk from an instance. @@ -945,8 +1214,8 @@ class InstancesClient { /// @param project Project ID for this request. /// @param zone The name of the zone for this request. /// @param instance Instance name for this request. - /// @param device_name The device name of the disk to detach. Make a get() request on the instance - /// to view currently attached disks and device names. + /// @param device_name The device name of the disk to detach. Make a get() request on + /// the instance to view currently attached disks and device names. /// @param opts Optional. Override the class-level options, such as retry and /// backoff policies. /// @return A [`future`] that becomes satisfied when the LRO @@ -967,7 +1236,7 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instances.v1.DetachDiskRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1005} + /// [google.cloud.cpp.compute.instances.v1.DetachDiskRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1193} /// // clang-format on future> DetachDisk( @@ -1022,7 +1291,7 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instances.v1.DetachDiskRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1005} + /// [google.cloud.cpp.compute.instances.v1.DetachDiskRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1193} /// // clang-format on future> DetachDisk( @@ -1081,8 +1350,8 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`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#L1099} - /// [google.cloud.cpp.compute.v1.Instance]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_022.proto#L93} + /// [google.cloud.cpp.compute.instances.v1.GetInstanceRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1290} + /// [google.cloud.cpp.compute.v1.Instance]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_029.proto#L99} /// // clang-format on StatusOr GetInstance( @@ -1113,8 +1382,8 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`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#L1099} - /// [google.cloud.cpp.compute.v1.Instance]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_022.proto#L93} + /// [google.cloud.cpp.compute.instances.v1.GetInstanceRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1290} + /// [google.cloud.cpp.compute.v1.Instance]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_029.proto#L99} /// // clang-format on StatusOr GetInstance( @@ -1144,8 +1413,8 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`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#L1043} - /// [google.cloud.cpp.compute.v1.InstancesGetEffectiveFirewallsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_022.proto#L681} + /// [google.cloud.cpp.compute.instances.v1.GetEffectiveFirewallsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1234} + /// [google.cloud.cpp.compute.v1.InstancesGetEffectiveFirewallsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_029.proto#L823} /// // clang-format on StatusOr< @@ -1179,8 +1448,8 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`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#L1043} - /// [google.cloud.cpp.compute.v1.InstancesGetEffectiveFirewallsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_022.proto#L681} + /// [google.cloud.cpp.compute.instances.v1.GetEffectiveFirewallsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1234} + /// [google.cloud.cpp.compute.v1.InstancesGetEffectiveFirewallsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_029.proto#L823} /// // clang-format on StatusOr< @@ -1210,8 +1479,8 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`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#L1061} - /// [google.cloud.cpp.compute.v1.GuestAttributes]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_022.proto#L51} + /// [google.cloud.cpp.compute.instances.v1.GetGuestAttributesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1252} + /// [google.cloud.cpp.compute.v1.GuestAttributes]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_029.proto#L55} /// // clang-format on StatusOr GetGuestAttributes( @@ -1242,8 +1511,8 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`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#L1061} - /// [google.cloud.cpp.compute.v1.GuestAttributes]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_022.proto#L51} + /// [google.cloud.cpp.compute.instances.v1.GetGuestAttributesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1252} + /// [google.cloud.cpp.compute.v1.GuestAttributes]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_029.proto#L55} /// // clang-format on StatusOr GetGuestAttributes( @@ -1273,8 +1542,8 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`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#L1081} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} + /// [google.cloud.cpp.compute.instances.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1272} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr GetIamPolicy( @@ -1306,8 +1575,8 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`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#L1081} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} + /// [google.cloud.cpp.compute.instances.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1272} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr GetIamPolicy( @@ -1336,8 +1605,8 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`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#L1113} - /// [google.cloud.cpp.compute.v1.Screenshot]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_022.proto#L974} + /// [google.cloud.cpp.compute.instances.v1.GetScreenshotRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1304} + /// [google.cloud.cpp.compute.v1.Screenshot]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_029.proto#L1277} /// // clang-format on StatusOr GetScreenshot( @@ -1368,8 +1637,8 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`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#L1113} - /// [google.cloud.cpp.compute.v1.Screenshot]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_022.proto#L974} + /// [google.cloud.cpp.compute.instances.v1.GetScreenshotRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1304} + /// [google.cloud.cpp.compute.v1.Screenshot]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_029.proto#L1277} /// // clang-format on StatusOr GetScreenshot( @@ -1398,8 +1667,8 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`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#L1127} - /// [google.cloud.cpp.compute.v1.SerialPortOutput]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_022.proto#L984} + /// [google.cloud.cpp.compute.instances.v1.GetSerialPortOutputRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1318} + /// [google.cloud.cpp.compute.v1.SerialPortOutput]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_029.proto#L1287} /// // clang-format on StatusOr @@ -1430,8 +1699,8 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`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#L1127} - /// [google.cloud.cpp.compute.v1.SerialPortOutput]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_022.proto#L984} + /// [google.cloud.cpp.compute.instances.v1.GetSerialPortOutputRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1318} + /// [google.cloud.cpp.compute.v1.SerialPortOutput]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_029.proto#L1287} /// // clang-format on StatusOr @@ -1460,8 +1729,8 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`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#L1160} - /// [google.cloud.cpp.compute.v1.ShieldedInstanceIdentity]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_022.proto#L1010} + /// [google.cloud.cpp.compute.instances.v1.GetShieldedInstanceIdentityRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1354} + /// [google.cloud.cpp.compute.v1.ShieldedInstanceIdentity]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_029.proto#L1314} /// // clang-format on StatusOr @@ -1493,8 +1762,8 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`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#L1160} - /// [google.cloud.cpp.compute.v1.ShieldedInstanceIdentity]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_022.proto#L1010} + /// [google.cloud.cpp.compute.instances.v1.GetShieldedInstanceIdentityRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1354} + /// [google.cloud.cpp.compute.v1.ShieldedInstanceIdentity]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_029.proto#L1314} /// // clang-format on StatusOr @@ -1532,7 +1801,7 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instances.v1.InsertInstanceRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1174} + /// [google.cloud.cpp.compute.instances.v1.InsertInstanceRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1368} /// // clang-format on future> InsertInstance( @@ -1588,7 +1857,7 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instances.v1.InsertInstanceRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1174} + /// [google.cloud.cpp.compute.instances.v1.InsertInstanceRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1368} /// // clang-format on future> InsertInstance( @@ -1628,7 +1897,8 @@ class InstancesClient { // clang-format off /// - /// Retrieves the list of instances contained within the specified zone. + /// Retrieves the list of instances contained within + /// the specified zone. /// https://cloud.google.com/compute/docs/reference/rest/v1/instances/list /// /// @param project Project ID for this request. @@ -1655,8 +1925,8 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`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#L1226} - /// [google.cloud.cpp.compute.v1.Instance]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_022.proto#L93} + /// [google.cloud.cpp.compute.instances.v1.ListInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1429} + /// [google.cloud.cpp.compute.v1.Instance]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_029.proto#L99} /// // clang-format on StreamRange ListInstances( @@ -1664,7 +1934,8 @@ class InstancesClient { // clang-format off /// - /// Retrieves the list of instances contained within the specified zone. + /// Retrieves the list of instances contained within + /// the specified zone. /// https://cloud.google.com/compute/docs/reference/rest/v1/instances/list /// /// @param request Unary RPCs, such as the one wrapped by this @@ -1695,8 +1966,8 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`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#L1226} - /// [google.cloud.cpp.compute.v1.Instance]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_022.proto#L93} + /// [google.cloud.cpp.compute.instances.v1.ListInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1429} + /// [google.cloud.cpp.compute.v1.Instance]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_029.proto#L99} /// // clang-format on StreamRange ListInstances( @@ -1708,13 +1979,14 @@ class InstancesClient { /// 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. + /// For more information, readViewing + /// referrers to VM instances. /// https://cloud.google.com/compute/docs/reference/rest/v1/instances/listReferrers /// /// @param project Project ID for this request. /// @param zone The name of the zone for this request. - /// @param instance Name of the target instance scoping this request, or '-' if the request - /// should span over all instances in the container. + /// @param instance Name of the target instance scoping this request, or '-' if the + /// request should span over all instances in the container. /// @param opts Optional. Override the class-level options, such as retry and /// backoff policies. /// @return a [StreamRange](@ref google::cloud::StreamRange) @@ -1737,8 +2009,8 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`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#L1297} - /// [google.cloud.cpp.compute.v1.Reference]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_022.proto#L909} + /// [google.cloud.cpp.compute.instances.v1.ListReferrersRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1533} + /// [google.cloud.cpp.compute.v1.Reference]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_029.proto#L1081} /// // clang-format on StreamRange ListReferrers( @@ -1750,7 +2022,8 @@ class InstancesClient { /// 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. + /// For more information, readViewing + /// referrers to VM instances. /// https://cloud.google.com/compute/docs/reference/rest/v1/instances/listReferrers /// /// @param request Unary RPCs, such as the one wrapped by this @@ -1781,8 +2054,8 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`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#L1297} - /// [google.cloud.cpp.compute.v1.Reference]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_022.proto#L909} + /// [google.cloud.cpp.compute.instances.v1.ListReferrersRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1533} + /// [google.cloud.cpp.compute.v1.Reference]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_029.proto#L1081} /// // clang-format on StreamRange ListReferrers( @@ -1817,7 +2090,7 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instances.v1.PerformMaintenanceRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1373} + /// [google.cloud.cpp.compute.instances.v1.PerformMaintenanceRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1642} /// // clang-format on future> @@ -1870,7 +2143,7 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instances.v1.PerformMaintenanceRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1373} + /// [google.cloud.cpp.compute.instances.v1.PerformMaintenanceRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1642} /// // clang-format on future> @@ -1938,7 +2211,7 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instances.v1.RemoveResourcePoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1406} + /// [google.cloud.cpp.compute.instances.v1.RemoveResourcePoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1678} /// // clang-format on future> @@ -2000,7 +2273,7 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instances.v1.RemoveResourcePoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1406} + /// [google.cloud.cpp.compute.instances.v1.RemoveResourcePoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1678} /// // clang-format on future> @@ -2068,7 +2341,7 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instances.v1.ReportHostAsFaultyRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1444} + /// [google.cloud.cpp.compute.instances.v1.ReportHostAsFaultyRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1719} /// // clang-format on future> @@ -2128,7 +2401,7 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instances.v1.ReportHostAsFaultyRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1444} + /// [google.cloud.cpp.compute.instances.v1.ReportHostAsFaultyRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1719} /// // clang-format on future> @@ -2169,8 +2442,9 @@ class InstancesClient { // clang-format off /// - /// 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. + /// Performs a reset on the instance. This is a hard reset. The VM + /// does not do a graceful shutdown. For more information, seeResetting + /// an instance. /// https://cloud.google.com/compute/docs/reference/rest/v1/instances/reset /// /// @param project Project ID for this request. @@ -2196,7 +2470,7 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instances.v1.ResetRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1482} + /// [google.cloud.cpp.compute.instances.v1.ResetRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1760} /// // clang-format on future> Reset( @@ -2220,8 +2494,9 @@ class InstancesClient { // clang-format off /// - /// 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. + /// Performs a reset on the instance. This is a hard reset. The VM + /// does not do a graceful shutdown. For more information, seeResetting + /// an instance. /// https://cloud.google.com/compute/docs/reference/rest/v1/instances/reset /// /// @param request Unary RPCs, such as the one wrapped by this @@ -2250,7 +2525,7 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instances.v1.ResetRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1482} + /// [google.cloud.cpp.compute.instances.v1.ResetRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1760} /// // clang-format on future> Reset( @@ -2288,7 +2563,7 @@ class InstancesClient { // clang-format off /// - /// Resumes an instance that was suspended using the instances().suspend + /// Resumes an instance that was suspended using theinstances().suspend /// method. /// https://cloud.google.com/compute/docs/reference/rest/v1/instances/resume /// @@ -2315,7 +2590,7 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instances.v1.ResumeRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1515} + /// [google.cloud.cpp.compute.instances.v1.ResumeRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1796} /// // clang-format on future> Resume( @@ -2339,7 +2614,7 @@ class InstancesClient { // clang-format off /// - /// Resumes an instance that was suspended using the instances().suspend + /// Resumes an instance that was suspended using theinstances().suspend /// method. /// https://cloud.google.com/compute/docs/reference/rest/v1/instances/resume /// @@ -2369,7 +2644,7 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instances.v1.ResumeRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1515} + /// [google.cloud.cpp.compute.instances.v1.ResumeRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1796} /// // clang-format on future> Resume( @@ -2424,7 +2699,7 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instances.v1.SendDiagnosticInterruptRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1548} + /// [google.cloud.cpp.compute.instances.v1.SendDiagnosticInterruptRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1832} /// // clang-format on Status SendDiagnosticInterrupt(std::string const& project, @@ -2454,7 +2729,7 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instances.v1.SendDiagnosticInterruptRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1548} + /// [google.cloud.cpp.compute.instances.v1.SendDiagnosticInterruptRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1832} /// // clang-format on Status SendDiagnosticInterrupt( @@ -2490,7 +2765,7 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instances.v1.SetDeletionProtectionRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1562} + /// [google.cloud.cpp.compute.instances.v1.SetDeletionProtectionRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1846} /// // clang-format on future> @@ -2543,7 +2818,7 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instances.v1.SetDeletionProtectionRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1562} + /// [google.cloud.cpp.compute.instances.v1.SetDeletionProtectionRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1846} /// // clang-format on future> @@ -2591,8 +2866,8 @@ class InstancesClient { /// @param zone The name of the zone for this request. /// @param instance The instance name for this request. /// @param auto_delete Whether to auto-delete the disk when the instance is deleted. - /// @param device_name The device name of the disk to modify. Make a get() request on the instance - /// to view currently attached disks and device names. + /// @param device_name The device name of the disk to modify. Make a get() request + /// on the instance to view currently attached disks and device names. /// @param opts Optional. Override the class-level options, such as retry and /// backoff policies. /// @return A [`future`] that becomes satisfied when the LRO @@ -2613,7 +2888,7 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instances.v1.SetDiskAutoDeleteRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1598} + /// [google.cloud.cpp.compute.instances.v1.SetDiskAutoDeleteRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1885} /// // clang-format on future> @@ -2668,7 +2943,7 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instances.v1.SetDiskAutoDeleteRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1598} + /// [google.cloud.cpp.compute.instances.v1.SetDiskAutoDeleteRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1885} /// // clang-format on future> @@ -2708,8 +2983,8 @@ class InstancesClient { // clang-format off /// - /// Sets the access control policy on the specified resource. Replaces any - /// existing policy. + /// Sets the access control policy on the specified resource. + /// Replaces any existing policy. /// https://cloud.google.com/compute/docs/reference/rest/v1/instances/setIamPolicy /// /// @param project Project ID for this request. @@ -2729,8 +3004,8 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`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#L1640} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} + /// [google.cloud.cpp.compute.instances.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1930} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr SetIamPolicy( @@ -2742,8 +3017,8 @@ class InstancesClient { // clang-format off /// - /// Sets the access control policy on the specified resource. Replaces any - /// existing policy. + /// Sets the access control policy on the specified resource. + /// Replaces any existing policy. /// https://cloud.google.com/compute/docs/reference/rest/v1/instances/setIamPolicy /// /// @param request Unary RPCs, such as the one wrapped by this @@ -2765,8 +3040,8 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`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#L1640} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} + /// [google.cloud.cpp.compute.instances.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1930} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr SetIamPolicy( @@ -2776,7 +3051,7 @@ class InstancesClient { // clang-format off /// - /// Sets labels on an instance. To learn more about labels, read the Labeling + /// Sets labels on an instance. To learn more about labels, read theLabeling /// Resources documentation. /// https://cloud.google.com/compute/docs/reference/rest/v1/instances/setLabels /// @@ -2804,7 +3079,7 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instances.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1658} + /// [google.cloud.cpp.compute.instances.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1948} /// // clang-format on future> SetLabels( @@ -2834,7 +3109,7 @@ class InstancesClient { // clang-format off /// - /// Sets labels on an instance. To learn more about labels, read the Labeling + /// Sets labels on an instance. To learn more about labels, read theLabeling /// Resources documentation. /// https://cloud.google.com/compute/docs/reference/rest/v1/instances/setLabels /// @@ -2864,7 +3139,7 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instances.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1658} + /// [google.cloud.cpp.compute.instances.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1948} /// // clang-format on future> SetLabels( @@ -2932,7 +3207,7 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instances.v1.SetMachineResourcesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1696} + /// [google.cloud.cpp.compute.instances.v1.SetMachineResourcesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1989} /// // clang-format on future> @@ -2994,7 +3269,7 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instances.v1.SetMachineResourcesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1696} + /// [google.cloud.cpp.compute.instances.v1.SetMachineResourcesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1989} /// // clang-format on future> @@ -3035,8 +3310,8 @@ class InstancesClient { // clang-format off /// - /// Changes the machine type for a stopped instance to the machine type - /// specified in the request. + /// Changes the machine type for a stopped instance to the machine + /// type specified in the request. /// https://cloud.google.com/compute/docs/reference/rest/v1/instances/setMachineType /// /// @param project Project ID for this request. @@ -3063,7 +3338,7 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instances.v1.SetMachineTypeRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1734} + /// [google.cloud.cpp.compute.instances.v1.SetMachineTypeRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L2030} /// // clang-format on future> SetMachineType( @@ -3093,8 +3368,8 @@ class InstancesClient { // clang-format off /// - /// Changes the machine type for a stopped instance to the machine type - /// specified in the request. + /// Changes the machine type for a stopped instance to the machine + /// type specified in the request. /// https://cloud.google.com/compute/docs/reference/rest/v1/instances/setMachineType /// /// @param request Unary RPCs, such as the one wrapped by this @@ -3123,7 +3398,7 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instances.v1.SetMachineTypeRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1734} + /// [google.cloud.cpp.compute.instances.v1.SetMachineTypeRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L2030} /// // clang-format on future> SetMachineType( @@ -3163,8 +3438,8 @@ class InstancesClient { // clang-format off /// - /// Sets metadata for the specified instance to the data included in the - /// request. + /// Sets metadata for the specified instance to the data included + /// in the request. /// https://cloud.google.com/compute/docs/reference/rest/v1/instances/setMetadata /// /// @param project Project ID for this request. @@ -3191,7 +3466,7 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instances.v1.SetMetadataRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1772} + /// [google.cloud.cpp.compute.instances.v1.SetMetadataRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L2071} /// // clang-format on future> SetMetadata( @@ -3219,8 +3494,8 @@ class InstancesClient { // clang-format off /// - /// Sets metadata for the specified instance to the data included in the - /// request. + /// Sets metadata for the specified instance to the data included + /// in the request. /// https://cloud.google.com/compute/docs/reference/rest/v1/instances/setMetadata /// /// @param request Unary RPCs, such as the one wrapped by this @@ -3249,7 +3524,7 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instances.v1.SetMetadataRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1772} + /// [google.cloud.cpp.compute.instances.v1.SetMetadataRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L2071} /// // clang-format on future> SetMetadata( @@ -3289,9 +3564,10 @@ class InstancesClient { // clang-format off /// - /// 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. + /// Changes the minimum CPU platform that this instance should use. + /// This method can only + /// be called on a stopped instance. For more information, readSpecifying a + /// Minimum CPU Platform. /// https://cloud.google.com/compute/docs/reference/rest/v1/instances/setMinCpuPlatform /// /// @param project Project ID for this request. @@ -3318,7 +3594,7 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instances.v1.SetMinCpuPlatformRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1809} + /// [google.cloud.cpp.compute.instances.v1.SetMinCpuPlatformRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L2111} /// // clang-format on future> @@ -3349,9 +3625,10 @@ class InstancesClient { // clang-format off /// - /// 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. + /// Changes the minimum CPU platform that this instance should use. + /// This method can only + /// be called on a stopped instance. For more information, readSpecifying a + /// Minimum CPU Platform. /// https://cloud.google.com/compute/docs/reference/rest/v1/instances/setMinCpuPlatform /// /// @param request Unary RPCs, such as the one wrapped by this @@ -3380,7 +3657,7 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instances.v1.SetMinCpuPlatformRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1809} + /// [google.cloud.cpp.compute.instances.v1.SetMinCpuPlatformRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L2111} /// // clang-format on future> @@ -3447,7 +3724,7 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instances.v1.SetNameRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1847} + /// [google.cloud.cpp.compute.instances.v1.SetNameRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L2152} /// // clang-format on future> SetName( @@ -3506,7 +3783,7 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instances.v1.SetNameRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1847} + /// [google.cloud.cpp.compute.instances.v1.SetNameRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L2152} /// // clang-format on future> SetName( @@ -3544,11 +3821,12 @@ class InstancesClient { // clang-format off /// - /// 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. + /// Sets an instance's scheduling options. You can only call this method on + /// astopped instance, + /// that is, a VM instance that is in a `TERMINATED` state. SeeInstance Life + /// Cycle for more information on the possible instance states. + /// For more information about setting scheduling options for a VM, seeSet + /// VM host maintenance policy. /// https://cloud.google.com/compute/docs/reference/rest/v1/instances/setScheduling /// /// @param project Project ID for this request. @@ -3575,7 +3853,7 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instances.v1.SetSchedulingRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1885} + /// [google.cloud.cpp.compute.instances.v1.SetSchedulingRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L2193} /// // clang-format on future> SetScheduling( @@ -3603,11 +3881,12 @@ class InstancesClient { // clang-format off /// - /// 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. + /// Sets an instance's scheduling options. You can only call this method on + /// astopped instance, + /// that is, a VM instance that is in a `TERMINATED` state. SeeInstance Life + /// Cycle for more information on the possible instance states. + /// For more information about setting scheduling options for a VM, seeSet + /// VM host maintenance policy. /// https://cloud.google.com/compute/docs/reference/rest/v1/instances/setScheduling /// /// @param request Unary RPCs, such as the one wrapped by this @@ -3636,7 +3915,7 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instances.v1.SetSchedulingRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1885} + /// [google.cloud.cpp.compute.instances.v1.SetSchedulingRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L2193} /// // clang-format on future> SetScheduling( @@ -3676,14 +3955,15 @@ class InstancesClient { // clang-format off /// - /// Sets the Google Cloud Armor security policy for the specified instance. For - /// more information, see Google Cloud Armor Overview + /// Sets the Google Cloud Armor security policy for the specified instance. + /// For more information, seeGoogle + /// Cloud Armor Overview /// https://cloud.google.com/compute/docs/reference/rest/v1/instances/setSecurityPolicy /// /// @param project Project ID for this request. /// @param zone Name of the zone scoping this request. - /// @param instance Name of the Instance resource to which the security policy should be set. - /// The name should conform to RFC1035. + /// @param instance Name of the Instance resource to which the security policy should be + /// set. The name should conform to RFC1035. /// @param instances_set_security_policy_request_resource The InstancesSetSecurityPolicyRequest for this request. /// @param opts Optional. Override the class-level options, such as retry and /// backoff policies. @@ -3705,7 +3985,7 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instances.v1.SetSecurityPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1922} + /// [google.cloud.cpp.compute.instances.v1.SetSecurityPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L2233} /// // clang-format on future> @@ -3736,8 +4016,9 @@ class InstancesClient { // clang-format off /// - /// Sets the Google Cloud Armor security policy for the specified instance. For - /// more information, see Google Cloud Armor Overview + /// Sets the Google Cloud Armor security policy for the specified instance. + /// For more information, seeGoogle + /// Cloud Armor Overview /// https://cloud.google.com/compute/docs/reference/rest/v1/instances/setSecurityPolicy /// /// @param request Unary RPCs, such as the one wrapped by this @@ -3766,7 +4047,7 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instances.v1.SetSecurityPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1922} + /// [google.cloud.cpp.compute.instances.v1.SetSecurityPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L2233} /// // clang-format on future> @@ -3806,8 +4087,9 @@ class InstancesClient { // clang-format off /// - /// Sets the service account on the instance. For more information, read - /// Changing the service account and access scopes for an instance. + /// Sets the service account on the instance. For more information, + /// readChanging + /// the service account and access scopes for an instance. /// https://cloud.google.com/compute/docs/reference/rest/v1/instances/setServiceAccount /// /// @param project Project ID for this request. @@ -3834,7 +4116,7 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instances.v1.SetServiceAccountRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1961} + /// [google.cloud.cpp.compute.instances.v1.SetServiceAccountRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L2275} /// // clang-format on future> @@ -3865,8 +4147,9 @@ class InstancesClient { // clang-format off /// - /// Sets the service account on the instance. For more information, read - /// Changing the service account and access scopes for an instance. + /// Sets the service account on the instance. For more information, + /// readChanging + /// the service account and access scopes for an instance. /// https://cloud.google.com/compute/docs/reference/rest/v1/instances/setServiceAccount /// /// @param request Unary RPCs, such as the one wrapped by this @@ -3895,7 +4178,7 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instances.v1.SetServiceAccountRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1961} + /// [google.cloud.cpp.compute.instances.v1.SetServiceAccountRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L2275} /// // clang-format on future> @@ -3935,9 +4218,10 @@ class InstancesClient { // clang-format off /// - /// 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. + /// 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. /// https://cloud.google.com/compute/docs/reference/rest/v1/instances/setShieldedInstanceIntegrityPolicy /// /// @param project Project ID for this request. @@ -3964,7 +4248,7 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instances.v1.SetShieldedInstanceIntegrityPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1999} + /// [google.cloud.cpp.compute.instances.v1.SetShieldedInstanceIntegrityPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L2316} /// // clang-format on future> @@ -3996,9 +4280,10 @@ class InstancesClient { // clang-format off /// - /// 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. + /// 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. /// https://cloud.google.com/compute/docs/reference/rest/v1/instances/setShieldedInstanceIntegrityPolicy /// /// @param request Unary RPCs, such as the one wrapped by this @@ -4027,7 +4312,7 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instances.v1.SetShieldedInstanceIntegrityPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1999} + /// [google.cloud.cpp.compute.instances.v1.SetShieldedInstanceIntegrityPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L2316} /// // clang-format on future> @@ -4070,8 +4355,8 @@ class InstancesClient { // clang-format off /// - /// Sets network tags for the specified instance to the data included in the - /// request. + /// Sets network tags + /// for the specified instance to the data included in the request. /// https://cloud.google.com/compute/docs/reference/rest/v1/instances/setTags /// /// @param project Project ID for this request. @@ -4098,7 +4383,7 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instances.v1.SetTagsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L2037} + /// [google.cloud.cpp.compute.instances.v1.SetTagsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L2357} /// // clang-format on future> SetTags( @@ -4126,8 +4411,8 @@ class InstancesClient { // clang-format off /// - /// Sets network tags for the specified instance to the data included in the - /// request. + /// Sets network tags + /// for the specified instance to the data included in the request. /// https://cloud.google.com/compute/docs/reference/rest/v1/instances/setTags /// /// @param request Unary RPCs, such as the one wrapped by this @@ -4156,7 +4441,7 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instances.v1.SetTagsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L2037} + /// [google.cloud.cpp.compute.instances.v1.SetTagsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L2357} /// // clang-format on future> SetTags( @@ -4221,7 +4506,7 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instances.v1.SimulateMaintenanceEventRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L2074} + /// [google.cloud.cpp.compute.instances.v1.SimulateMaintenanceEventRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L2397} /// // clang-format on future> @@ -4275,7 +4560,7 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instances.v1.SimulateMaintenanceEventRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L2074} + /// [google.cloud.cpp.compute.instances.v1.SimulateMaintenanceEventRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L2397} /// // clang-format on future> @@ -4316,8 +4601,9 @@ class InstancesClient { // clang-format off /// - /// Starts an instance that was stopped using the instances().stop method. For - /// more information, see Restart an instance. + /// Starts an instance that was stopped using theinstances().stop + /// method. For more information, seeRestart an + /// instance. /// https://cloud.google.com/compute/docs/reference/rest/v1/instances/start /// /// @param project Project ID for this request. @@ -4343,7 +4629,7 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instances.v1.StartRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L2112} + /// [google.cloud.cpp.compute.instances.v1.StartRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L2438} /// // clang-format on future> Start( @@ -4367,8 +4653,9 @@ class InstancesClient { // clang-format off /// - /// Starts an instance that was stopped using the instances().stop method. For - /// more information, see Restart an instance. + /// Starts an instance that was stopped using theinstances().stop + /// method. For more information, seeRestart an + /// instance. /// https://cloud.google.com/compute/docs/reference/rest/v1/instances/start /// /// @param request Unary RPCs, such as the one wrapped by this @@ -4397,7 +4684,7 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instances.v1.StartRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L2112} + /// [google.cloud.cpp.compute.instances.v1.StartRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L2438} /// // clang-format on future> Start( @@ -4435,8 +4722,9 @@ class InstancesClient { // clang-format off /// - /// Starts an instance that was stopped using the instances().stop method. For - /// more information, see Restart an instance. + /// Starts an instance that was stopped using theinstances().stop + /// method. For more information, seeRestart an + /// instance. /// https://cloud.google.com/compute/docs/reference/rest/v1/instances/startWithEncryptionKey /// /// @param project Project ID for this request. @@ -4463,7 +4751,7 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instances.v1.StartWithEncryptionKeyRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L2145} + /// [google.cloud.cpp.compute.instances.v1.StartWithEncryptionKeyRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L2474} /// // clang-format on future> @@ -4496,8 +4784,9 @@ class InstancesClient { // clang-format off /// - /// Starts an instance that was stopped using the instances().stop method. For - /// more information, see Restart an instance. + /// Starts an instance that was stopped using theinstances().stop + /// method. For more information, seeRestart an + /// instance. /// https://cloud.google.com/compute/docs/reference/rest/v1/instances/startWithEncryptionKey /// /// @param request Unary RPCs, such as the one wrapped by this @@ -4526,7 +4815,7 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instances.v1.StartWithEncryptionKeyRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L2145} + /// [google.cloud.cpp.compute.instances.v1.StartWithEncryptionKeyRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L2474} /// // clang-format on future> @@ -4567,12 +4856,12 @@ class InstancesClient { // clang-format off /// - /// 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 + /// 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. + /// be charged until they are deleted. For more information, seeStopping + /// an instance. /// https://cloud.google.com/compute/docs/reference/rest/v1/instances/stop /// /// @param project Project ID for this request. @@ -4598,7 +4887,7 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instances.v1.StopRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L2183} + /// [google.cloud.cpp.compute.instances.v1.StopRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L2515} /// // clang-format on future> Stop( @@ -4622,12 +4911,12 @@ class InstancesClient { // clang-format off /// - /// 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 + /// 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. + /// be charged until they are deleted. For more information, seeStopping + /// an instance. /// https://cloud.google.com/compute/docs/reference/rest/v1/instances/stop /// /// @param request Unary RPCs, such as the one wrapped by this @@ -4656,7 +4945,7 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instances.v1.StopRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L2183} + /// [google.cloud.cpp.compute.instances.v1.StopRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L2515} /// // clang-format on future> Stop( @@ -4699,8 +4988,9 @@ class InstancesClient { /// 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. + /// addresses, will continue to be charged while the instance is suspended. + /// For more information, see + /// Suspending and resuming an instance. /// https://cloud.google.com/compute/docs/reference/rest/v1/instances/suspend /// /// @param project Project ID for this request. @@ -4726,7 +5016,7 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instances.v1.SuspendRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L2221} + /// [google.cloud.cpp.compute.instances.v1.SuspendRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L2559} /// // clang-format on future> Suspend( @@ -4755,8 +5045,9 @@ class InstancesClient { /// 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. + /// addresses, will continue to be charged while the instance is suspended. + /// For more information, see + /// Suspending and resuming an instance. /// https://cloud.google.com/compute/docs/reference/rest/v1/instances/suspend /// /// @param request Unary RPCs, such as the one wrapped by this @@ -4785,7 +5076,7 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instances.v1.SuspendRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L2221} + /// [google.cloud.cpp.compute.instances.v1.SuspendRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L2559} /// // clang-format on future> Suspend( @@ -4843,8 +5134,8 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`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#L2259} - /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_145.proto#L30} + /// [google.cloud.cpp.compute.instances.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L2600} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} /// // clang-format on StatusOr @@ -4879,8 +5170,8 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`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#L2259} - /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_145.proto#L30} + /// [google.cloud.cpp.compute.instances.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L2600} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} /// // clang-format on StatusOr @@ -4891,8 +5182,9 @@ class InstancesClient { // clang-format off /// /// 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. + /// method can update only a specific set of instance properties. See + /// Updating a running instance for a list of updatable instance + /// properties. /// https://cloud.google.com/compute/docs/reference/rest/v1/instances/update /// /// @param project Project ID for this request. @@ -4919,7 +5211,7 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instances.v1.UpdateInstanceRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L2355} + /// [google.cloud.cpp.compute.instances.v1.UpdateInstanceRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L2702} /// // clang-format on future> UpdateInstance( @@ -4948,8 +5240,9 @@ class InstancesClient { // clang-format off /// /// 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. + /// method can update only a specific set of instance properties. See + /// Updating a running instance for a list of updatable instance + /// properties. /// https://cloud.google.com/compute/docs/reference/rest/v1/instances/update /// /// @param request Unary RPCs, such as the one wrapped by this @@ -4978,7 +5271,7 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instances.v1.UpdateInstanceRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L2355} + /// [google.cloud.cpp.compute.instances.v1.UpdateInstanceRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L2702} /// // clang-format on future> UpdateInstance( @@ -5019,8 +5312,9 @@ class InstancesClient { // clang-format off /// /// 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. + /// with the data included in the request. This method supportsPATCH + /// semantics and uses theJSON merge + /// patch format and processing rules. /// https://cloud.google.com/compute/docs/reference/rest/v1/instances/updateAccessConfig /// /// @param project Project ID for this request. @@ -5048,7 +5342,7 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instances.v1.UpdateAccessConfigRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L2277} + /// [google.cloud.cpp.compute.instances.v1.UpdateAccessConfigRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L2618} /// // clang-format on future> @@ -5080,8 +5374,9 @@ class InstancesClient { // clang-format off /// /// 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. + /// with the data included in the request. This method supportsPATCH + /// semantics and uses theJSON merge + /// patch format and processing rules. /// https://cloud.google.com/compute/docs/reference/rest/v1/instances/updateAccessConfig /// /// @param request Unary RPCs, such as the one wrapped by this @@ -5110,7 +5405,7 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instances.v1.UpdateAccessConfigRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L2277} + /// [google.cloud.cpp.compute.instances.v1.UpdateAccessConfigRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L2618} /// // clang-format on future> @@ -5151,9 +5446,10 @@ class InstancesClient { // clang-format off /// - /// 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. + /// Updates the Display config for a VM instance. You can + /// only use this method on a stopped VM instance. This method supportsPATCH + /// semantics and uses theJSON merge + /// patch format and processing rules. /// https://cloud.google.com/compute/docs/reference/rest/v1/instances/updateDisplayDevice /// /// @param project Project ID for this request. @@ -5180,7 +5476,7 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instances.v1.UpdateDisplayDeviceRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L2318} + /// [google.cloud.cpp.compute.instances.v1.UpdateDisplayDeviceRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L2662} /// // clang-format on future> @@ -5210,9 +5506,10 @@ class InstancesClient { // clang-format off /// - /// 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. + /// Updates the Display config for a VM instance. You can + /// only use this method on a stopped VM instance. This method supportsPATCH + /// semantics and uses theJSON merge + /// patch format and processing rules. /// https://cloud.google.com/compute/docs/reference/rest/v1/instances/updateDisplayDevice /// /// @param request Unary RPCs, such as the one wrapped by this @@ -5241,7 +5538,7 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instances.v1.UpdateDisplayDeviceRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L2318} + /// [google.cloud.cpp.compute.instances.v1.UpdateDisplayDeviceRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L2662} /// // clang-format on future> @@ -5283,10 +5580,11 @@ class InstancesClient { // clang-format off /// /// 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. + /// 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. /// https://cloud.google.com/compute/docs/reference/rest/v1/instances/updateNetworkInterface /// /// @param project Project ID for this request. @@ -5314,7 +5612,7 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instances.v1.UpdateNetworkInterfaceRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L2412} + /// [google.cloud.cpp.compute.instances.v1.UpdateNetworkInterfaceRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L2768} /// // clang-format on future> @@ -5346,10 +5644,11 @@ class InstancesClient { // clang-format off /// /// 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. + /// 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. /// https://cloud.google.com/compute/docs/reference/rest/v1/instances/updateNetworkInterface /// /// @param request Unary RPCs, such as the one wrapped by this @@ -5378,7 +5677,7 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instances.v1.UpdateNetworkInterfaceRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L2412} + /// [google.cloud.cpp.compute.instances.v1.UpdateNetworkInterfaceRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L2768} /// // clang-format on future> @@ -5419,9 +5718,10 @@ class InstancesClient { // clang-format off /// - /// 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. + /// Updates the Shielded Instance config for an instance. You can + /// only use this method on a stopped instance. This method supportsPATCH + /// semantics and uses theJSON merge + /// patch format and processing rules. /// https://cloud.google.com/compute/docs/reference/rest/v1/instances/updateShieldedInstanceConfig /// /// @param project Project ID for this request. @@ -5448,7 +5748,7 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instances.v1.UpdateShieldedInstanceConfigRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L2453} + /// [google.cloud.cpp.compute.instances.v1.UpdateShieldedInstanceConfigRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L2812} /// // clang-format on future> @@ -5480,9 +5780,10 @@ class InstancesClient { // clang-format off /// - /// 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. + /// Updates the Shielded Instance config for an instance. You can + /// only use this method on a stopped instance. This method supportsPATCH + /// semantics and uses theJSON merge + /// patch format and processing rules. /// https://cloud.google.com/compute/docs/reference/rest/v1/instances/updateShieldedInstanceConfig /// /// @param request Unary RPCs, such as the one wrapped by this @@ -5511,7 +5812,7 @@ class InstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instances.v1.UpdateShieldedInstanceConfigRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L2453} + /// [google.cloud.cpp.compute.instances.v1.UpdateShieldedInstanceConfigRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L2812} /// // clang-format on future> diff --git a/google/cloud/compute/instances/v1/instances_connection.cc b/google/cloud/compute/instances/v1/instances_connection.cc index 7baccc85f98ed..cc6fd5dbd8863 100644 --- a/google/cloud/compute/instances/v1/instances_connection.cc +++ b/google/cloud/compute/instances/v1/instances_connection.cc @@ -60,6 +60,31 @@ InstancesConnection::AddAccessConfig( Status(StatusCode::kUnimplemented, "not implemented")); } +future> +InstancesConnection::AddNetworkInterface( + google::cloud::cpp::compute::instances::v1:: + AddNetworkInterfaceRequest const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +InstancesConnection::AddNetworkInterface( + NoAwaitTag, google::cloud::cpp::compute::instances::v1:: + AddNetworkInterfaceRequest const&) { + return StatusOr( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +InstancesConnection::AddNetworkInterface( + google::cloud::cpp::compute::v1::Operation const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + future> InstancesConnection::AddResourcePolicies( google::cloud::cpp::compute::instances::v1:: @@ -192,6 +217,31 @@ InstancesConnection::DeleteAccessConfig( Status(StatusCode::kUnimplemented, "not implemented")); } +future> +InstancesConnection::DeleteNetworkInterface( + google::cloud::cpp::compute::instances::v1:: + DeleteNetworkInterfaceRequest const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +InstancesConnection::DeleteNetworkInterface( + NoAwaitTag, google::cloud::cpp::compute::instances::v1:: + DeleteNetworkInterfaceRequest const&) { + return StatusOr( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +InstancesConnection::DeleteNetworkInterface( + google::cloud::cpp::compute::v1::Operation const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + future> InstancesConnection::DetachDisk( google::cloud::cpp::compute::instances::v1::DetachDiskRequest const&) { diff --git a/google/cloud/compute/instances/v1/instances_connection.h b/google/cloud/compute/instances/v1/instances_connection.h index 9a4aeee7d0a83..66ecc854b2731 100644 --- a/google/cloud/compute/instances/v1/instances_connection.h +++ b/google/cloud/compute/instances/v1/instances_connection.h @@ -197,6 +197,19 @@ class InstancesConnection { virtual future> AddAccessConfig(google::cloud::cpp::compute::v1::Operation const& operation); + virtual future> + AddNetworkInterface(google::cloud::cpp::compute::instances::v1:: + AddNetworkInterfaceRequest const& request); + + virtual StatusOr + AddNetworkInterface(NoAwaitTag, + google::cloud::cpp::compute::instances::v1:: + AddNetworkInterfaceRequest const& request); + + virtual future> + AddNetworkInterface( + google::cloud::cpp::compute::v1::Operation const& operation); + virtual future> AddResourcePolicies(google::cloud::cpp::compute::instances::v1:: AddResourcePoliciesRequest const& request); @@ -267,6 +280,19 @@ class InstancesConnection { DeleteAccessConfig( google::cloud::cpp::compute::v1::Operation const& operation); + virtual future> + DeleteNetworkInterface(google::cloud::cpp::compute::instances::v1:: + DeleteNetworkInterfaceRequest const& request); + + virtual StatusOr + DeleteNetworkInterface(NoAwaitTag, + google::cloud::cpp::compute::instances::v1:: + DeleteNetworkInterfaceRequest const& request); + + virtual future> + DeleteNetworkInterface( + google::cloud::cpp::compute::v1::Operation const& operation); + virtual future> DetachDisk( google::cloud::cpp::compute::instances::v1::DetachDiskRequest const& diff --git a/google/cloud/compute/instances/v1/instances_connection_idempotency_policy.cc b/google/cloud/compute/instances/v1/instances_connection_idempotency_policy.cc index 6f3b900a66fae..123c717158585 100644 --- a/google/cloud/compute/instances/v1/instances_connection_idempotency_policy.cc +++ b/google/cloud/compute/instances/v1/instances_connection_idempotency_policy.cc @@ -39,6 +39,12 @@ Idempotency InstancesConnectionIdempotencyPolicy::AddAccessConfig( return Idempotency::kNonIdempotent; } +Idempotency InstancesConnectionIdempotencyPolicy::AddNetworkInterface( + google::cloud::cpp::compute::instances::v1:: + AddNetworkInterfaceRequest const&) { + return Idempotency::kNonIdempotent; +} + Idempotency InstancesConnectionIdempotencyPolicy::AddResourcePolicies( google::cloud::cpp::compute::instances::v1:: AddResourcePoliciesRequest const&) { @@ -72,6 +78,12 @@ Idempotency InstancesConnectionIdempotencyPolicy::DeleteAccessConfig( return Idempotency::kNonIdempotent; } +Idempotency InstancesConnectionIdempotencyPolicy::DeleteNetworkInterface( + google::cloud::cpp::compute::instances::v1:: + DeleteNetworkInterfaceRequest const&) { + return Idempotency::kNonIdempotent; +} + Idempotency InstancesConnectionIdempotencyPolicy::DetachDisk( google::cloud::cpp::compute::instances::v1::DetachDiskRequest const&) { return Idempotency::kNonIdempotent; diff --git a/google/cloud/compute/instances/v1/instances_connection_idempotency_policy.h b/google/cloud/compute/instances/v1/instances_connection_idempotency_policy.h index 772320437dad3..f74d5f3ec1bb9 100644 --- a/google/cloud/compute/instances/v1/instances_connection_idempotency_policy.h +++ b/google/cloud/compute/instances/v1/instances_connection_idempotency_policy.h @@ -40,6 +40,10 @@ class InstancesConnectionIdempotencyPolicy { google::cloud::cpp::compute::instances::v1::AddAccessConfigRequest const& request); + virtual google::cloud::Idempotency AddNetworkInterface( + google::cloud::cpp::compute::instances::v1:: + AddNetworkInterfaceRequest const& request); + virtual google::cloud::Idempotency AddResourcePolicies( google::cloud::cpp::compute::instances::v1:: AddResourcePoliciesRequest const& request); @@ -64,6 +68,10 @@ class InstancesConnectionIdempotencyPolicy { google::cloud::cpp::compute::instances::v1:: DeleteAccessConfigRequest const& request); + virtual google::cloud::Idempotency DeleteNetworkInterface( + google::cloud::cpp::compute::instances::v1:: + DeleteNetworkInterfaceRequest const& request); + virtual google::cloud::Idempotency DetachDisk( google::cloud::cpp::compute::instances::v1::DetachDiskRequest const& request); diff --git a/google/cloud/compute/instances/v1/instances_proto_export.h b/google/cloud/compute/instances/v1/instances_proto_export.h index 31058ec707203..11f3bb1c41f44 100644 --- a/google/cloud/compute/instances/v1/instances_proto_export.h +++ b/google/cloud/compute/instances/v1/instances_proto_export.h @@ -27,21 +27,21 @@ // IWYU pragma: begin_exports #include "google/cloud/compute/v1/internal/common_001.pb.h" -#include "google/cloud/compute/v1/internal/common_003.pb.h" -#include "google/cloud/compute/v1/internal/common_007.pb.h" -#include "google/cloud/compute/v1/internal/common_015.pb.h" -#include "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_021.pb.h" -#include "google/cloud/compute/v1/internal/common_022.pb.h" +#include "google/cloud/compute/v1/internal/common_004.pb.h" +#include "google/cloud/compute/v1/internal/common_009.pb.h" +#include "google/cloud/compute/v1/internal/common_018.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_028.pb.h" #include "google/cloud/compute/v1/internal/common_029.pb.h" -#include "google/cloud/compute/v1/internal/common_031.pb.h" -#include "google/cloud/compute/v1/internal/common_033.pb.h" -#include "google/cloud/compute/v1/internal/common_034.pb.h" -#include "google/cloud/compute/v1/internal/common_039.pb.h" -#include "google/cloud/compute/v1/internal/common_081.pb.h" -#include "google/cloud/compute/v1/internal/common_145.pb.h" -#include "google/cloud/compute/v1/internal/common_146.pb.h" -#include "google/cloud/compute/v1/internal/common_152.pb.h" +#include "google/cloud/compute/v1/internal/common_038.pb.h" +#include "google/cloud/compute/v1/internal/common_040.pb.h" +#include "google/cloud/compute/v1/internal/common_042.pb.h" +#include "google/cloud/compute/v1/internal/common_043.pb.h" +#include "google/cloud/compute/v1/internal/common_048.pb.h" +#include "google/cloud/compute/v1/internal/common_096.pb.h" +#include "google/cloud/compute/v1/internal/common_171.pb.h" +#include "google/cloud/compute/v1/internal/common_173.pb.h" +#include "google/cloud/compute/v1/internal/common_182.pb.h" // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_INSTANCES_V1_INSTANCES_PROTO_EXPORT_H diff --git a/google/cloud/compute/instances/v1/internal/instances_rest_connection_impl.cc b/google/cloud/compute/instances/v1/internal/instances_rest_connection_impl.cc index e39be3d858718..1bc072e22d45e 100644 --- a/google/cloud/compute/instances/v1/internal/instances_rest_connection_impl.cc +++ b/google/cloud/compute/instances/v1/internal/instances_rest_connection_impl.cc @@ -175,6 +175,137 @@ InstancesRestConnectionImpl::AddAccessConfig( }); } +future> +InstancesRestConnectionImpl::AddNetworkInterface( + google::cloud::cpp::compute::instances::v1:: + AddNetworkInterfaceRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::zone_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::zone_operations::v1::DeleteOperationRequest>( + background_->cq(), current, request, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::instances::v1:: + AddNetworkInterfaceRequest const& request) { + return stub->AsyncAddNetworkInterface(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->AddNetworkInterface(request), + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [request]( + std::string const& op, + google::cloud::cpp::compute::zone_operations::v1::GetOperationRequest& + r) { + r.set_project(request.project()); + r.set_zone(request.zone()); + r.set_operation(op); + }, + [request](std::string const& op, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest& r) { + r.set_project(request.project()); + r.set_zone(request.zone()); + r.set_operation(op); + }); +} + +StatusOr +InstancesRestConnectionImpl::AddNetworkInterface( + NoAwaitTag, google::cloud::cpp::compute::instances::v1:: + AddNetworkInterfaceRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->AddNetworkInterface(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::instances::v1:: + AddNetworkInterfaceRequest const& request) { + return stub_->AddNetworkInterface(rest_context, options, request); + }, + *current, request, __func__); +} + +future> +InstancesRestConnectionImpl::AddNetworkInterface( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestAwaitLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::zone_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::zone_operations::v1::DeleteOperationRequest>( + background_->cq(), current, operation, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [operation]( + std::string const&, + google::cloud::cpp::compute::zone_operations::v1::GetOperationRequest& + r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_zone(info.zone); + r.set_operation(info.operation); + }, + [operation](std::string const&, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_zone(info.zone); + r.set_operation(info.operation); + }); +} + future> InstancesRestConnectionImpl::AddResourcePolicies( google::cloud::cpp::compute::instances::v1:: @@ -878,6 +1009,137 @@ InstancesRestConnectionImpl::DeleteAccessConfig( }); } +future> +InstancesRestConnectionImpl::DeleteNetworkInterface( + google::cloud::cpp::compute::instances::v1:: + DeleteNetworkInterfaceRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::zone_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::zone_operations::v1::DeleteOperationRequest>( + background_->cq(), current, request, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::instances::v1:: + DeleteNetworkInterfaceRequest const& request) { + return stub->AsyncDeleteNetworkInterface(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->DeleteNetworkInterface(request), + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [request]( + std::string const& op, + google::cloud::cpp::compute::zone_operations::v1::GetOperationRequest& + r) { + r.set_project(request.project()); + r.set_zone(request.zone()); + r.set_operation(op); + }, + [request](std::string const& op, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest& r) { + r.set_project(request.project()); + r.set_zone(request.zone()); + r.set_operation(op); + }); +} + +StatusOr +InstancesRestConnectionImpl::DeleteNetworkInterface( + NoAwaitTag, google::cloud::cpp::compute::instances::v1:: + DeleteNetworkInterfaceRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->DeleteNetworkInterface(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::instances::v1:: + DeleteNetworkInterfaceRequest const& request) { + return stub_->DeleteNetworkInterface(rest_context, options, request); + }, + *current, request, __func__); +} + +future> +InstancesRestConnectionImpl::DeleteNetworkInterface( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestAwaitLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::zone_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::zone_operations::v1::DeleteOperationRequest>( + background_->cq(), current, operation, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [operation]( + std::string const&, + google::cloud::cpp::compute::zone_operations::v1::GetOperationRequest& + r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_zone(info.zone); + r.set_operation(info.operation); + }, + [operation](std::string const&, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_zone(info.zone); + r.set_operation(info.operation); + }); +} + future> InstancesRestConnectionImpl::DetachDisk( google::cloud::cpp::compute::instances::v1::DetachDiskRequest const& diff --git a/google/cloud/compute/instances/v1/internal/instances_rest_connection_impl.h b/google/cloud/compute/instances/v1/internal/instances_rest_connection_impl.h index 375d08283ffcc..dca41de050507 100644 --- a/google/cloud/compute/instances/v1/internal/instances_rest_connection_impl.h +++ b/google/cloud/compute/instances/v1/internal/instances_rest_connection_impl.h @@ -62,6 +62,18 @@ class InstancesRestConnectionImpl future> AddAccessConfig( google::cloud::cpp::compute::v1::Operation const& operation) override; + future> + AddNetworkInterface(google::cloud::cpp::compute::instances::v1:: + AddNetworkInterfaceRequest const& request) override; + + StatusOr AddNetworkInterface( + NoAwaitTag, google::cloud::cpp::compute::instances::v1:: + AddNetworkInterfaceRequest const& request) override; + + future> + AddNetworkInterface( + google::cloud::cpp::compute::v1::Operation const& operation) override; + future> AddResourcePolicies(google::cloud::cpp::compute::instances::v1:: AddResourcePoliciesRequest const& request) override; @@ -128,6 +140,19 @@ class InstancesRestConnectionImpl DeleteAccessConfig( google::cloud::cpp::compute::v1::Operation const& operation) override; + future> + DeleteNetworkInterface( + google::cloud::cpp::compute::instances::v1:: + DeleteNetworkInterfaceRequest const& request) override; + + StatusOr DeleteNetworkInterface( + NoAwaitTag, google::cloud::cpp::compute::instances::v1:: + DeleteNetworkInterfaceRequest const& request) override; + + future> + DeleteNetworkInterface( + google::cloud::cpp::compute::v1::Operation const& operation) override; + future> DetachDisk( google::cloud::cpp::compute::instances::v1::DetachDiskRequest const& request) override; diff --git a/google/cloud/compute/instances/v1/internal/instances_rest_logging_decorator.cc b/google/cloud/compute/instances/v1/internal/instances_rest_logging_decorator.cc index 0444fa8385538..3ac2b6b1d725b 100644 --- a/google/cloud/compute/instances/v1/internal/instances_rest_logging_decorator.cc +++ b/google/cloud/compute/instances/v1/internal/instances_rest_logging_decorator.cc @@ -68,6 +68,40 @@ InstancesRestLogging::AddAccessConfig( rest_context, options, request, __func__, tracing_options_); } +future> +InstancesRestLogging::AsyncAddNetworkInterface( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::instances::v1:: + AddNetworkInterfaceRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::instances::v1:: + AddNetworkInterfaceRequest const& request) { + return child_->AsyncAddNetworkInterface(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +StatusOr +InstancesRestLogging::AddNetworkInterface( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::instances::v1:: + AddNetworkInterfaceRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::instances::v1:: + AddNetworkInterfaceRequest const& request) { + return child_->AddNetworkInterface(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + future> InstancesRestLogging::AsyncAddResourcePolicies( CompletionQueue& cq, @@ -256,6 +290,40 @@ InstancesRestLogging::DeleteAccessConfig( rest_context, options, request, __func__, tracing_options_); } +future> +InstancesRestLogging::AsyncDeleteNetworkInterface( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::instances::v1:: + DeleteNetworkInterfaceRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::instances::v1:: + DeleteNetworkInterfaceRequest const& request) { + return child_->AsyncDeleteNetworkInterface(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +StatusOr +InstancesRestLogging::DeleteNetworkInterface( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::instances::v1:: + DeleteNetworkInterfaceRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::instances::v1:: + DeleteNetworkInterfaceRequest const& request) { + return child_->DeleteNetworkInterface(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + future> InstancesRestLogging::AsyncDetachDisk( CompletionQueue& cq, diff --git a/google/cloud/compute/instances/v1/internal/instances_rest_logging_decorator.h b/google/cloud/compute/instances/v1/internal/instances_rest_logging_decorator.h index 13637e55d4487..2bef62b9a4fdf 100644 --- a/google/cloud/compute/instances/v1/internal/instances_rest_logging_decorator.h +++ b/google/cloud/compute/instances/v1/internal/instances_rest_logging_decorator.h @@ -56,6 +56,20 @@ class InstancesRestLogging : public InstancesRestStub { google::cloud::cpp::compute::instances::v1::AddAccessConfigRequest const& request) override; + future> + AsyncAddNetworkInterface( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::instances::v1:: + AddNetworkInterfaceRequest const& request) override; + + StatusOr AddNetworkInterface( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::instances::v1:: + AddNetworkInterfaceRequest const& request) override; + future> AsyncAddResourcePolicies( google::cloud::CompletionQueue& cq, @@ -131,6 +145,20 @@ class InstancesRestLogging : public InstancesRestStub { google::cloud::cpp::compute::instances::v1:: DeleteAccessConfigRequest const& request) override; + future> + AsyncDeleteNetworkInterface( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::instances::v1:: + DeleteNetworkInterfaceRequest const& request) override; + + StatusOr DeleteNetworkInterface( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::instances::v1:: + DeleteNetworkInterfaceRequest const& request) override; + future> AsyncDetachDisk( google::cloud::CompletionQueue& cq, std::unique_ptr rest_context, diff --git a/google/cloud/compute/instances/v1/internal/instances_rest_metadata_decorator.cc b/google/cloud/compute/instances/v1/internal/instances_rest_metadata_decorator.cc index da3001805d4eb..a216e5f5145aa 100644 --- a/google/cloud/compute/instances/v1/internal/instances_rest_metadata_decorator.cc +++ b/google/cloud/compute/instances/v1/internal/instances_rest_metadata_decorator.cc @@ -59,6 +59,27 @@ InstancesRestMetadata::AddAccessConfig( return child_->AddAccessConfig(rest_context, options, request); } +future> +InstancesRestMetadata::AsyncAddNetworkInterface( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::instances::v1:: + AddNetworkInterfaceRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncAddNetworkInterface(cq, std::move(rest_context), + std::move(options), request); +} + +StatusOr +InstancesRestMetadata::AddNetworkInterface( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::instances::v1:: + AddNetworkInterfaceRequest const& request) { + SetMetadata(rest_context, options); + return child_->AddNetworkInterface(rest_context, options, request); +} + future> InstancesRestMetadata::AsyncAddResourcePolicies( CompletionQueue& cq, @@ -173,6 +194,27 @@ InstancesRestMetadata::DeleteAccessConfig( return child_->DeleteAccessConfig(rest_context, options, request); } +future> +InstancesRestMetadata::AsyncDeleteNetworkInterface( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::instances::v1:: + DeleteNetworkInterfaceRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncDeleteNetworkInterface(cq, std::move(rest_context), + std::move(options), request); +} + +StatusOr +InstancesRestMetadata::DeleteNetworkInterface( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::instances::v1:: + DeleteNetworkInterfaceRequest const& request) { + SetMetadata(rest_context, options); + return child_->DeleteNetworkInterface(rest_context, options, request); +} + future> InstancesRestMetadata::AsyncDetachDisk( CompletionQueue& cq, diff --git a/google/cloud/compute/instances/v1/internal/instances_rest_metadata_decorator.h b/google/cloud/compute/instances/v1/internal/instances_rest_metadata_decorator.h index 4e57e4b711aed..ac163fc6b701e 100644 --- a/google/cloud/compute/instances/v1/internal/instances_rest_metadata_decorator.h +++ b/google/cloud/compute/instances/v1/internal/instances_rest_metadata_decorator.h @@ -53,6 +53,20 @@ class InstancesRestMetadata : public InstancesRestStub { google::cloud::cpp::compute::instances::v1::AddAccessConfigRequest const& request) override; + google::cloud::future> + AsyncAddNetworkInterface( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::instances::v1:: + AddNetworkInterfaceRequest const& request) override; + + StatusOr AddNetworkInterface( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::instances::v1:: + AddNetworkInterfaceRequest const& request) override; + google::cloud::future> AsyncAddResourcePolicies( google::cloud::CompletionQueue& cq, @@ -130,6 +144,20 @@ class InstancesRestMetadata : public InstancesRestStub { google::cloud::cpp::compute::instances::v1:: DeleteAccessConfigRequest const& request) override; + google::cloud::future> + AsyncDeleteNetworkInterface( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::instances::v1:: + DeleteNetworkInterfaceRequest const& request) override; + + StatusOr DeleteNetworkInterface( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::instances::v1:: + DeleteNetworkInterfaceRequest const& request) override; + google::cloud::future> AsyncDetachDisk( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/instances/v1/internal/instances_rest_stub.cc b/google/cloud/compute/instances/v1/internal/instances_rest_stub.cc index 7a19c4610725e..1de824ab04d0c 100644 --- a/google/cloud/compute/instances/v1/internal/instances_rest_stub.cc +++ b/google/cloud/compute/instances/v1/internal/instances_rest_stub.cc @@ -106,6 +106,65 @@ DefaultInstancesRestStub::AddAccessConfig( std::move(query_params)); } +future> +DefaultInstancesRestStub::AsyncAddNetworkInterface( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::instances::v1:: + AddNetworkInterfaceRequest const& request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto service, auto request, auto rest_context, auto options) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + p.set_value( + rest_internal::Post( + *service, *rest_context, request.network_interface_resource(), + false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", *options), + "/", "projects", "/", request.project(), "/", + "zones", "/", request.zone(), "/", "instances", + "/", request.instance(), "/", + "addNetworkInterface"), + std::move(query_params))); + }, + std::move(p), + service_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +StatusOr +DefaultInstancesRestStub::AddNetworkInterface( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::instances::v1:: + AddNetworkInterfaceRequest const& request) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Post( + *service_, rest_context, request.network_interface_resource(), false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "zones", "/", + request.zone(), "/", "instances", "/", request.instance(), + "/", "addNetworkInterface"), + std::move(query_params)); +} + future> DefaultInstancesRestStub::AsyncAddResourcePolicies( CompletionQueue& cq, @@ -329,6 +388,8 @@ DefaultInstancesRestStub::AsyncDeleteInstance( std::thread t{ [](auto p, auto service, auto request, auto rest_context, auto options) { std::vector> query_params; + query_params.push_back({"no_graceful_shutdown", + (request.no_graceful_shutdown() ? "1" : "0")}); query_params.push_back({"request_id", request.request_id()}); query_params = rest_internal::TrimEmptyQueryParameters(std::move(query_params)); @@ -360,6 +421,8 @@ DefaultInstancesRestStub::DeleteInstance( google::cloud::cpp::compute::instances::v1::DeleteInstanceRequest const& request) { std::vector> query_params; + query_params.push_back( + {"no_graceful_shutdown", (request.no_graceful_shutdown() ? "1" : "0")}); query_params.push_back({"request_id", request.request_id()}); query_params = rest_internal::TrimEmptyQueryParameters(std::move(query_params)); @@ -424,6 +487,58 @@ DefaultInstancesRestStub::DeleteAccessConfig( std::move(query_params)); } +future> +DefaultInstancesRestStub::AsyncDeleteNetworkInterface( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::instances::v1:: + DeleteNetworkInterfaceRequest const& request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto service, auto request, auto rest_context, auto options) { + std::vector> query_params; + p.set_value( + rest_internal::Post( + *service, *rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", *options), + "/", "projects", "/", request.project(), "/", + "zones", "/", request.zone(), "/", "instances", + "/", request.instance(), "/", + "deleteNetworkInterface"), + std::move(query_params))); + }, + std::move(p), + service_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +StatusOr +DefaultInstancesRestStub::DeleteNetworkInterface( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::instances::v1:: + DeleteNetworkInterfaceRequest const& request) { + std::vector> query_params; + return rest_internal::Post( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "zones", "/", + request.zone(), "/", "instances", "/", request.instance(), + "/", "deleteNetworkInterface"), + std::move(query_params)); +} + future> DefaultInstancesRestStub::AsyncDetachDisk( CompletionQueue& cq, @@ -2071,6 +2186,8 @@ DefaultInstancesRestStub::AsyncUpdateInstance( std::thread t{ [](auto p, auto service, auto request, auto rest_context, auto options) { std::vector> query_params; + query_params.push_back( + {"discard_local_ssd", (request.discard_local_ssd() ? "1" : "0")}); query_params.push_back({"minimal_action", request.minimal_action()}); query_params.push_back({"most_disruptive_allowed_action", request.most_disruptive_allowed_action()}); @@ -2105,6 +2222,8 @@ DefaultInstancesRestStub::UpdateInstance( google::cloud::cpp::compute::instances::v1::UpdateInstanceRequest const& request) { std::vector> query_params; + query_params.push_back( + {"discard_local_ssd", (request.discard_local_ssd() ? "1" : "0")}); query_params.push_back({"minimal_action", request.minimal_action()}); query_params.push_back({"most_disruptive_allowed_action", request.most_disruptive_allowed_action()}); diff --git a/google/cloud/compute/instances/v1/internal/instances_rest_stub.h b/google/cloud/compute/instances/v1/internal/instances_rest_stub.h index 5329c7daacdc7..026c51d8e30a0 100644 --- a/google/cloud/compute/instances/v1/internal/instances_rest_stub.h +++ b/google/cloud/compute/instances/v1/internal/instances_rest_stub.h @@ -51,6 +51,20 @@ class InstancesRestStub { google::cloud::cpp::compute::instances::v1::AddAccessConfigRequest const& request) = 0; + virtual future> + AsyncAddNetworkInterface( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::instances::v1:: + AddNetworkInterfaceRequest const& request) = 0; + + virtual StatusOr + AddNetworkInterface(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::instances::v1:: + AddNetworkInterfaceRequest const& request) = 0; + virtual future> AsyncAddResourcePolicies( google::cloud::CompletionQueue& cq, @@ -128,6 +142,21 @@ class InstancesRestStub { google::cloud::cpp::compute::instances::v1:: DeleteAccessConfigRequest const& request) = 0; + virtual future> + AsyncDeleteNetworkInterface( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::instances::v1:: + DeleteNetworkInterfaceRequest const& request) = 0; + + virtual StatusOr + DeleteNetworkInterface( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::instances::v1:: + DeleteNetworkInterfaceRequest const& request) = 0; + virtual future> AsyncDetachDisk( google::cloud::CompletionQueue& cq, @@ -668,6 +697,20 @@ class DefaultInstancesRestStub : public InstancesRestStub { google::cloud::cpp::compute::instances::v1::AddAccessConfigRequest const& request) override; + future> + AsyncAddNetworkInterface( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::instances::v1:: + AddNetworkInterfaceRequest const& request) override; + + StatusOr AddNetworkInterface( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::instances::v1:: + AddNetworkInterfaceRequest const& request) override; + future> AsyncAddResourcePolicies( google::cloud::CompletionQueue& cq, @@ -743,6 +786,20 @@ class DefaultInstancesRestStub : public InstancesRestStub { google::cloud::cpp::compute::instances::v1:: DeleteAccessConfigRequest const& request) override; + future> + AsyncDeleteNetworkInterface( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::instances::v1:: + DeleteNetworkInterfaceRequest const& request) override; + + StatusOr DeleteNetworkInterface( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::instances::v1:: + DeleteNetworkInterfaceRequest const& request) override; + future> AsyncDetachDisk( google::cloud::CompletionQueue& cq, std::unique_ptr rest_context, diff --git a/google/cloud/compute/instances/v1/internal/instances_tracing_connection.cc b/google/cloud/compute/instances/v1/internal/instances_tracing_connection.cc index b4d7c0859518f..14976c13a44f7 100644 --- a/google/cloud/compute/instances/v1/internal/instances_tracing_connection.cc +++ b/google/cloud/compute/instances/v1/internal/instances_tracing_connection.cc @@ -62,6 +62,38 @@ InstancesTracingConnection::AddAccessConfig( return internal::EndSpan(std::move(span), child_->AddAccessConfig(operation)); } +future> +InstancesTracingConnection::AddNetworkInterface( + google::cloud::cpp::compute::instances::v1:: + AddNetworkInterfaceRequest const& request) { + auto span = internal::MakeSpan( + "compute_instances_v1::InstancesConnection::AddNetworkInterface"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), + child_->AddNetworkInterface(request)); +} + +StatusOr +InstancesTracingConnection::AddNetworkInterface( + NoAwaitTag, google::cloud::cpp::compute::instances::v1:: + AddNetworkInterfaceRequest const& request) { + auto span = internal::MakeSpan( + "compute_instances_v1::InstancesConnection::AddNetworkInterface"); + opentelemetry::trace::Scope scope(span); + return internal::EndSpan(*span, + child_->AddNetworkInterface(NoAwaitTag{}, request)); +} + +future> +InstancesTracingConnection::AddNetworkInterface( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto span = internal::MakeSpan( + "compute_instances_v1::InstancesConnection::AddNetworkInterface"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), + child_->AddNetworkInterface(operation)); +} + future> InstancesTracingConnection::AddResourcePolicies( google::cloud::cpp::compute::instances::v1:: @@ -232,6 +264,38 @@ InstancesTracingConnection::DeleteAccessConfig( child_->DeleteAccessConfig(operation)); } +future> +InstancesTracingConnection::DeleteNetworkInterface( + google::cloud::cpp::compute::instances::v1:: + DeleteNetworkInterfaceRequest const& request) { + auto span = internal::MakeSpan( + "compute_instances_v1::InstancesConnection::DeleteNetworkInterface"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), + child_->DeleteNetworkInterface(request)); +} + +StatusOr +InstancesTracingConnection::DeleteNetworkInterface( + NoAwaitTag, google::cloud::cpp::compute::instances::v1:: + DeleteNetworkInterfaceRequest const& request) { + auto span = internal::MakeSpan( + "compute_instances_v1::InstancesConnection::DeleteNetworkInterface"); + opentelemetry::trace::Scope scope(span); + return internal::EndSpan( + *span, child_->DeleteNetworkInterface(NoAwaitTag{}, request)); +} + +future> +InstancesTracingConnection::DeleteNetworkInterface( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto span = internal::MakeSpan( + "compute_instances_v1::InstancesConnection::DeleteNetworkInterface"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), + child_->DeleteNetworkInterface(operation)); +} + future> InstancesTracingConnection::DetachDisk( google::cloud::cpp::compute::instances::v1::DetachDiskRequest const& diff --git a/google/cloud/compute/instances/v1/internal/instances_tracing_connection.h b/google/cloud/compute/instances/v1/internal/instances_tracing_connection.h index f076434a3bfcc..0468812182654 100644 --- a/google/cloud/compute/instances/v1/internal/instances_tracing_connection.h +++ b/google/cloud/compute/instances/v1/internal/instances_tracing_connection.h @@ -50,6 +50,18 @@ class InstancesTracingConnection future> AddAccessConfig( google::cloud::cpp::compute::v1::Operation const& operation) override; + future> + AddNetworkInterface(google::cloud::cpp::compute::instances::v1:: + AddNetworkInterfaceRequest const& request) override; + + StatusOr AddNetworkInterface( + NoAwaitTag, google::cloud::cpp::compute::instances::v1:: + AddNetworkInterfaceRequest const& request) override; + + future> + AddNetworkInterface( + google::cloud::cpp::compute::v1::Operation const& operation) override; + future> AddResourcePolicies(google::cloud::cpp::compute::instances::v1:: AddResourcePoliciesRequest const& request) override; @@ -116,6 +128,19 @@ class InstancesTracingConnection DeleteAccessConfig( google::cloud::cpp::compute::v1::Operation const& operation) override; + future> + DeleteNetworkInterface( + google::cloud::cpp::compute::instances::v1:: + DeleteNetworkInterfaceRequest const& request) override; + + StatusOr DeleteNetworkInterface( + NoAwaitTag, google::cloud::cpp::compute::instances::v1:: + DeleteNetworkInterfaceRequest const& request) override; + + future> + DeleteNetworkInterface( + google::cloud::cpp::compute::v1::Operation const& operation) override; + future> DetachDisk( google::cloud::cpp::compute::instances::v1::DetachDiskRequest const& request) override; diff --git a/google/cloud/compute/instances/v1/mocks/mock_instances_connection.h b/google/cloud/compute/instances/v1/mocks/mock_instances_connection.h index 1aad39031d9ed..08af159d72ed2 100644 --- a/google/cloud/compute/instances/v1/mocks/mock_instances_connection.h +++ b/google/cloud/compute/instances/v1/mocks/mock_instances_connection.h @@ -90,6 +90,47 @@ class MockInstancesConnection (google::cloud::cpp::compute::v1::Operation const& operation), (override)); + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// AddNetworkInterface(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + AddNetworkInterface, + (google::cloud::cpp::compute::instances::v1:: + AddNetworkInterfaceRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// EXPECT_CALL(*mock, AddNetworkInterface(_, _)) + /// @endcode + MOCK_METHOD(StatusOr, + AddNetworkInterface, + (NoAwaitTag, google::cloud::cpp::compute::instances::v1:: + AddNetworkInterfaceRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// AddNetworkInterface(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + AddNetworkInterface, + (google::cloud::cpp::compute::v1::Operation const& operation), + (override)); + /// To disambiguate calls, use: /// /// @code @@ -305,6 +346,47 @@ class MockInstancesConnection (google::cloud::cpp::compute::v1::Operation const& operation), (override)); + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// DeleteNetworkInterface(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + DeleteNetworkInterface, + (google::cloud::cpp::compute::instances::v1:: + DeleteNetworkInterfaceRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// EXPECT_CALL(*mock, DeleteNetworkInterface(_, _)) + /// @endcode + MOCK_METHOD(StatusOr, + DeleteNetworkInterface, + (NoAwaitTag, google::cloud::cpp::compute::instances::v1:: + DeleteNetworkInterfaceRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// DeleteNetworkInterface(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + DeleteNetworkInterface, + (google::cloud::cpp::compute::v1::Operation const& operation), + (override)); + /// To disambiguate calls, use: /// /// @code diff --git a/google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups_client.cc b/google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups_client.cc new file mode 100644 index 0000000000000..95e3a5cab901c --- /dev/null +++ b/google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups_client.cc @@ -0,0 +1,268 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups.proto + +#include "google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups_client.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_instant_snapshot_groups_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +InstantSnapshotGroupsClient::InstantSnapshotGroupsClient( + std::shared_ptr connection, Options opts) + : connection_(std::move(connection)), + options_( + internal::MergeOptions(std::move(opts), connection_->options())) {} +InstantSnapshotGroupsClient::~InstantSnapshotGroupsClient() = default; + +future> +InstantSnapshotGroupsClient::DeleteInstantSnapshotGroup( + std::string const& project, std::string const& zone, + std::string const& instant_snapshot_group, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest request; + request.set_project(project); + request.set_zone(zone); + request.set_instant_snapshot_group(instant_snapshot_group); + return connection_->DeleteInstantSnapshotGroup(request); +} + +StatusOr +InstantSnapshotGroupsClient::DeleteInstantSnapshotGroup( + NoAwaitTag, std::string const& project, std::string const& zone, + std::string const& instant_snapshot_group, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest request; + request.set_project(project); + request.set_zone(zone); + request.set_instant_snapshot_group(instant_snapshot_group); + return connection_->DeleteInstantSnapshotGroup(NoAwaitTag{}, request); +} + +future> +InstantSnapshotGroupsClient::DeleteInstantSnapshotGroup( + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->DeleteInstantSnapshotGroup(request); +} + +StatusOr +InstantSnapshotGroupsClient::DeleteInstantSnapshotGroup( + NoAwaitTag, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->DeleteInstantSnapshotGroup(NoAwaitTag{}, request); +} + +future> +InstantSnapshotGroupsClient::DeleteInstantSnapshotGroup( + google::cloud::cpp::compute::v1::Operation const& operation, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->DeleteInstantSnapshotGroup(operation); +} + +StatusOr +InstantSnapshotGroupsClient::GetInstantSnapshotGroup( + std::string const& project, std::string const& zone, + std::string const& instant_snapshot_group, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + GetInstantSnapshotGroupRequest request; + request.set_project(project); + request.set_zone(zone); + request.set_instant_snapshot_group(instant_snapshot_group); + return connection_->GetInstantSnapshotGroup(request); +} + +StatusOr +InstantSnapshotGroupsClient::GetInstantSnapshotGroup( + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + GetInstantSnapshotGroupRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->GetInstantSnapshotGroup(request); +} + +StatusOr +InstantSnapshotGroupsClient::GetIamPolicy(std::string const& project, + std::string const& zone, + std::string const& resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::instant_snapshot_groups::v1::GetIamPolicyRequest + request; + request.set_project(project); + request.set_zone(zone); + request.set_resource(resource); + return connection_->GetIamPolicy(request); +} + +StatusOr +InstantSnapshotGroupsClient::GetIamPolicy( + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + GetIamPolicyRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->GetIamPolicy(request); +} + +future> +InstantSnapshotGroupsClient::InsertInstantSnapshotGroup( + std::string const& project, std::string const& zone, + google::cloud::cpp::compute::v1::InstantSnapshotGroup const& + instant_snapshot_group_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest request; + request.set_project(project); + request.set_zone(zone); + *request.mutable_instant_snapshot_group_resource() = + instant_snapshot_group_resource; + return connection_->InsertInstantSnapshotGroup(request); +} + +StatusOr +InstantSnapshotGroupsClient::InsertInstantSnapshotGroup( + NoAwaitTag, std::string const& project, std::string const& zone, + google::cloud::cpp::compute::v1::InstantSnapshotGroup const& + instant_snapshot_group_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest request; + request.set_project(project); + request.set_zone(zone); + *request.mutable_instant_snapshot_group_resource() = + instant_snapshot_group_resource; + return connection_->InsertInstantSnapshotGroup(NoAwaitTag{}, request); +} + +future> +InstantSnapshotGroupsClient::InsertInstantSnapshotGroup( + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->InsertInstantSnapshotGroup(request); +} + +StatusOr +InstantSnapshotGroupsClient::InsertInstantSnapshotGroup( + NoAwaitTag, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->InsertInstantSnapshotGroup(NoAwaitTag{}, request); +} + +future> +InstantSnapshotGroupsClient::InsertInstantSnapshotGroup( + google::cloud::cpp::compute::v1::Operation const& operation, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->InsertInstantSnapshotGroup(operation); +} + +StreamRange +InstantSnapshotGroupsClient::ListInstantSnapshotGroups( + std::string const& project, std::string const& zone, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + ListInstantSnapshotGroupsRequest request; + request.set_project(project); + request.set_zone(zone); + return connection_->ListInstantSnapshotGroups(request); +} + +StreamRange +InstantSnapshotGroupsClient::ListInstantSnapshotGroups( + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + ListInstantSnapshotGroupsRequest request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->ListInstantSnapshotGroups(std::move(request)); +} + +StatusOr +InstantSnapshotGroupsClient::SetIamPolicy( + std::string const& project, std::string const& zone, + std::string const& resource, + google::cloud::cpp::compute::v1::ZoneSetPolicyRequest const& + zone_set_policy_request_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::instant_snapshot_groups::v1::SetIamPolicyRequest + request; + request.set_project(project); + request.set_zone(zone); + request.set_resource(resource); + *request.mutable_zone_set_policy_request_resource() = + zone_set_policy_request_resource; + return connection_->SetIamPolicy(request); +} + +StatusOr +InstantSnapshotGroupsClient::SetIamPolicy( + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + SetIamPolicyRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->SetIamPolicy(request); +} + +StatusOr +InstantSnapshotGroupsClient::TestIamPermissions( + std::string const& project, std::string const& zone, + std::string const& resource, + google::cloud::cpp::compute::v1::TestPermissionsRequest const& + test_permissions_request_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + TestIamPermissionsRequest request; + request.set_project(project); + request.set_zone(zone); + request.set_resource(resource); + *request.mutable_test_permissions_request_resource() = + test_permissions_request_resource; + return connection_->TestIamPermissions(request); +} + +StatusOr +InstantSnapshotGroupsClient::TestIamPermissions( + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + TestIamPermissionsRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->TestIamPermissions(request); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_instant_snapshot_groups_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups_client.h b/google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups_client.h new file mode 100644 index 0000000000000..b2163673715c2 --- /dev/null +++ b/google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups_client.h @@ -0,0 +1,702 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_INSTANT_SNAPSHOT_GROUPS_V1_INSTANT_SNAPSHOT_GROUPS_CLIENT_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_INSTANT_SNAPSHOT_GROUPS_V1_INSTANT_SNAPSHOT_GROUPS_CLIENT_H + +#include "google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups_rest_connection.h" +#include "google/cloud/future.h" +#include "google/cloud/no_await_tag.h" +#include "google/cloud/options.h" +#include "google/cloud/polling_policy.h" +#include "google/cloud/status_or.h" +#include "google/cloud/version.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_instant_snapshot_groups_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/// +/// Service for the instantSnapshotGroups resource. +/// https://cloud.google.com/compute/docs/reference/rest/v1/instantSnapshotGroups +/// +/// @par Equality +/// +/// Instances of this class created via copy-construction or copy-assignment +/// always compare equal. Instances created with equal +/// `std::shared_ptr<*Connection>` objects compare equal. Objects that compare +/// equal share the same underlying resources. +/// +/// @par Performance +/// +/// Creating a new instance of this class is a relatively expensive operation, +/// new objects establish new connections to the service. In contrast, +/// copy-construction, move-construction, and the corresponding assignment +/// operations are relatively efficient as the copies share all underlying +/// resources. +/// +/// @par Thread Safety +/// +/// Concurrent access to different instances of this class, even if they compare +/// equal, is guaranteed to work. Two or more threads operating on the same +/// instance of this class is not guaranteed to work. Since copy-construction +/// and move-construction is a relatively efficient operation, consider using +/// such a copy when using this class from multiple threads. +/// +class InstantSnapshotGroupsClient { + public: + explicit InstantSnapshotGroupsClient( + std::shared_ptr connection, + Options opts = {}); + ~InstantSnapshotGroupsClient(); + + ///@{ + /// @name Copy and move support + InstantSnapshotGroupsClient(InstantSnapshotGroupsClient const&) = default; + InstantSnapshotGroupsClient& operator=(InstantSnapshotGroupsClient const&) = + default; + InstantSnapshotGroupsClient(InstantSnapshotGroupsClient&&) = default; + InstantSnapshotGroupsClient& operator=(InstantSnapshotGroupsClient&&) = + default; + ///@} + + ///@{ + /// @name Equality + friend bool operator==(InstantSnapshotGroupsClient const& a, + InstantSnapshotGroupsClient const& b) { + return a.connection_ == b.connection_; + } + friend bool operator!=(InstantSnapshotGroupsClient const& a, + InstantSnapshotGroupsClient const& b) { + return !(a == b); + } + ///@} + + // clang-format off + /// + /// deletes a Zonal InstantSnapshotGroup resource + /// https://cloud.google.com/compute/docs/reference/rest/v1/instantSnapshotGroups/delete + /// + /// @param project Project ID for this request. + /// @param zone The name of the zone for this request. + /// @param instant_snapshot_group Name of the InstantSnapshot resource to delete. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.instant_snapshot_groups.v1.DeleteInstantSnapshotGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups.proto#L128} + /// + // clang-format on + future> + DeleteInstantSnapshotGroup(std::string const& project, + std::string const& zone, + std::string const& instant_snapshot_group, + Options opts = {}); + + // clang-format off + /// + /// @copybrief DeleteInstantSnapshotGroup + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr + DeleteInstantSnapshotGroup(NoAwaitTag, std::string const& project, + std::string const& zone, + std::string const& instant_snapshot_group, + Options opts = {}); + + // clang-format off + /// + /// deletes a Zonal InstantSnapshotGroup resource + /// https://cloud.google.com/compute/docs/reference/rest/v1/instantSnapshotGroups/delete + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.instant_snapshot_groups.v1.DeleteInstantSnapshotGroupRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.instant_snapshot_groups.v1.DeleteInstantSnapshotGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups.proto#L128} + /// + // clang-format on + future> + DeleteInstantSnapshotGroup( + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief DeleteInstantSnapshotGroup + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr + DeleteInstantSnapshotGroup( + NoAwaitTag, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief DeleteInstantSnapshotGroup + /// + /// This method accepts a `google::cloud::cpp::compute::v1::Operation` that corresponds + /// to a previously started Long Running Operation (LRO) and polls the status + /// of the LRO in the background. + /// + // clang-format on + future> + DeleteInstantSnapshotGroup( + google::cloud::cpp::compute::v1::Operation const& operation, + Options opts = {}); + + // clang-format off + /// + /// returns the specified InstantSnapshotGroup resource in the specified zone. + /// https://cloud.google.com/compute/docs/reference/rest/v1/instantSnapshotGroups/get + /// + /// @param project Project ID for this request. + /// @param zone The name of the zone for this request. + /// @param instant_snapshot_group Name of the InstantSnapshotGroup resource to return. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.InstantSnapshotGroup]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.instant_snapshot_groups.v1.GetInstantSnapshotGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups.proto#L184} + /// [google.cloud.cpp.compute.v1.InstantSnapshotGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_083.proto#L28} + /// + // clang-format on + StatusOr + GetInstantSnapshotGroup(std::string const& project, std::string const& zone, + std::string const& instant_snapshot_group, + Options opts = {}); + + // clang-format off + /// + /// returns the specified InstantSnapshotGroup resource in the specified zone. + /// https://cloud.google.com/compute/docs/reference/rest/v1/instantSnapshotGroups/get + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.instant_snapshot_groups.v1.GetInstantSnapshotGroupRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.InstantSnapshotGroup]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.instant_snapshot_groups.v1.GetInstantSnapshotGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups.proto#L184} + /// [google.cloud.cpp.compute.v1.InstantSnapshotGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_083.proto#L28} + /// + // clang-format on + StatusOr + GetInstantSnapshotGroup(google::cloud::cpp::compute::instant_snapshot_groups:: + v1::GetInstantSnapshotGroupRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// Gets the access control policy for a resource. May be empty if no such + /// policy or resource exists. + /// https://cloud.google.com/compute/docs/reference/rest/v1/instantSnapshotGroups/getIamPolicy + /// + /// @param project Project ID for this request. + /// @param zone The name of the zone for this request. + /// @param resource Name or id of the resource for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.Policy]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.instant_snapshot_groups.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups.proto#L166} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} + /// + // clang-format on + StatusOr GetIamPolicy( + std::string const& project, std::string const& zone, + std::string const& resource, Options opts = {}); + + // clang-format off + /// + /// Gets the access control policy for a resource. May be empty if no such + /// policy or resource exists. + /// https://cloud.google.com/compute/docs/reference/rest/v1/instantSnapshotGroups/getIamPolicy + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.instant_snapshot_groups.v1.GetIamPolicyRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.Policy]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.instant_snapshot_groups.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups.proto#L166} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} + /// + // clang-format on + StatusOr GetIamPolicy( + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + GetIamPolicyRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// inserts a Zonal InstantSnapshotGroup resource + /// https://cloud.google.com/compute/docs/reference/rest/v1/instantSnapshotGroups/insert + /// + /// @param project Project ID for this request. + /// @param zone Name of the zone for this request. + /// @param instant_snapshot_group_resource The InstantSnapshotGroup for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.instant_snapshot_groups.v1.InsertInstantSnapshotGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups.proto#L200} + /// + // clang-format on + future> + InsertInstantSnapshotGroup( + std::string const& project, std::string const& zone, + google::cloud::cpp::compute::v1::InstantSnapshotGroup const& + instant_snapshot_group_resource, + Options opts = {}); + + // clang-format off + /// + /// @copybrief InsertInstantSnapshotGroup + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr + InsertInstantSnapshotGroup( + NoAwaitTag, std::string const& project, std::string const& zone, + google::cloud::cpp::compute::v1::InstantSnapshotGroup const& + instant_snapshot_group_resource, + Options opts = {}); + + // clang-format off + /// + /// inserts a Zonal InstantSnapshotGroup resource + /// https://cloud.google.com/compute/docs/reference/rest/v1/instantSnapshotGroups/insert + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.instant_snapshot_groups.v1.InsertInstantSnapshotGroupRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.instant_snapshot_groups.v1.InsertInstantSnapshotGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups.proto#L200} + /// + // clang-format on + future> + InsertInstantSnapshotGroup( + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief InsertInstantSnapshotGroup + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr + InsertInstantSnapshotGroup( + NoAwaitTag, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief InsertInstantSnapshotGroup + /// + /// This method accepts a `google::cloud::cpp::compute::v1::Operation` that corresponds + /// to a previously started Long Running Operation (LRO) and polls the status + /// of the LRO in the background. + /// + // clang-format on + future> + InsertInstantSnapshotGroup( + google::cloud::cpp::compute::v1::Operation const& operation, + Options opts = {}); + + // clang-format off + /// + /// retrieves the list of InstantSnapshotGroup resources contained within + /// the specified zone. + /// https://cloud.google.com/compute/docs/reference/rest/v1/instantSnapshotGroups/list + /// + /// @param project Project ID for this request. + /// @param zone The name of the zone for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return a [StreamRange](@ref google::cloud::StreamRange) + /// to iterate of the results. See the documentation of this type for + /// details. In brief, this class has `begin()` and `end()` member + /// functions returning a iterator class meeting the + /// [input iterator requirements]. The value type for this iterator is a + /// [`StatusOr`] as the iteration may fail even after some values are + /// retrieved successfully, for example, if there is a network disconnect. + /// An empty set of results does not indicate an error, it indicates + /// that there are no resources meeting the request criteria. + /// On a successful iteration the `StatusOr` contains elements of type + /// [google.cloud.cpp.compute.v1.InstantSnapshotGroup], or rather, + /// the C++ class generated by Protobuf from that type. Please consult the + /// Protobuf documentation for details on the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.instant_snapshot_groups.v1.ListInstantSnapshotGroupsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups.proto#L240} + /// [google.cloud.cpp.compute.v1.InstantSnapshotGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_083.proto#L28} + /// + // clang-format on + StreamRange + ListInstantSnapshotGroups(std::string const& project, std::string const& zone, + Options opts = {}); + + // clang-format off + /// + /// retrieves the list of InstantSnapshotGroup resources contained within + /// the specified zone. + /// https://cloud.google.com/compute/docs/reference/rest/v1/instantSnapshotGroups/list + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.instant_snapshot_groups.v1.ListInstantSnapshotGroupsRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return a [StreamRange](@ref google::cloud::StreamRange) + /// to iterate of the results. See the documentation of this type for + /// details. In brief, this class has `begin()` and `end()` member + /// functions returning a iterator class meeting the + /// [input iterator requirements]. The value type for this iterator is a + /// [`StatusOr`] as the iteration may fail even after some values are + /// retrieved successfully, for example, if there is a network disconnect. + /// An empty set of results does not indicate an error, it indicates + /// that there are no resources meeting the request criteria. + /// On a successful iteration the `StatusOr` contains elements of type + /// [google.cloud.cpp.compute.v1.InstantSnapshotGroup], or rather, + /// the C++ class generated by Protobuf from that type. Please consult the + /// Protobuf documentation for details on the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.instant_snapshot_groups.v1.ListInstantSnapshotGroupsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups.proto#L240} + /// [google.cloud.cpp.compute.v1.InstantSnapshotGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_083.proto#L28} + /// + // clang-format on + StreamRange + ListInstantSnapshotGroups( + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + ListInstantSnapshotGroupsRequest request, + Options opts = {}); + + // clang-format off + /// + /// Sets the access control policy on the specified resource. + /// Replaces any existing policy. + /// https://cloud.google.com/compute/docs/reference/rest/v1/instantSnapshotGroups/setIamPolicy + /// + /// @param project Project ID for this request. + /// @param zone The name of the zone for this request. + /// @param resource Name or id of the resource for this request. + /// @param zone_set_policy_request_resource The ZoneSetPolicyRequest for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.Policy]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.instant_snapshot_groups.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups.proto#L344} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} + /// + // clang-format on + StatusOr SetIamPolicy( + std::string const& project, std::string const& zone, + std::string const& resource, + google::cloud::cpp::compute::v1::ZoneSetPolicyRequest const& + zone_set_policy_request_resource, + Options opts = {}); + + // clang-format off + /// + /// Sets the access control policy on the specified resource. + /// Replaces any existing policy. + /// https://cloud.google.com/compute/docs/reference/rest/v1/instantSnapshotGroups/setIamPolicy + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.instant_snapshot_groups.v1.SetIamPolicyRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.Policy]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.instant_snapshot_groups.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups.proto#L344} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} + /// + // clang-format on + StatusOr SetIamPolicy( + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + SetIamPolicyRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// Returns permissions that a caller has on the specified resource. + /// https://cloud.google.com/compute/docs/reference/rest/v1/instantSnapshotGroups/testIamPermissions + /// + /// @param project Project ID for this request. + /// @param zone The name of the zone for this request. + /// @param resource Name or id of the resource for this request. + /// @param test_permissions_request_resource The TestPermissionsRequest for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.TestPermissionsResponse]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.instant_snapshot_groups.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups.proto#L362} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} + /// + // clang-format on + StatusOr + TestIamPermissions( + std::string const& project, std::string const& zone, + std::string const& resource, + google::cloud::cpp::compute::v1::TestPermissionsRequest const& + test_permissions_request_resource, + Options opts = {}); + + // clang-format off + /// + /// Returns permissions that a caller has on the specified resource. + /// https://cloud.google.com/compute/docs/reference/rest/v1/instantSnapshotGroups/testIamPermissions + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.instant_snapshot_groups.v1.TestIamPermissionsRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.TestPermissionsResponse]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.instant_snapshot_groups.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups.proto#L362} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} + /// + // clang-format on + StatusOr + TestIamPermissions(google::cloud::cpp::compute::instant_snapshot_groups::v1:: + TestIamPermissionsRequest const& request, + Options opts = {}); + + private: + std::shared_ptr connection_; + Options options_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_instant_snapshot_groups_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_INSTANT_SNAPSHOT_GROUPS_V1_INSTANT_SNAPSHOT_GROUPS_CLIENT_H diff --git a/google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups_connection.cc b/google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups_connection.cc new file mode 100644 index 0000000000000..0151c4a3f41c1 --- /dev/null +++ b/google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups_connection.cc @@ -0,0 +1,129 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups.proto + +#include "google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups_connection.h" +#include "google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups_options.h" +#include "google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_option_defaults.h" +#include "google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_tracing_connection.h" +#include "google/cloud/background_threads.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/grpc_options.h" +#include "google/cloud/internal/pagination_range.h" +#include "google/cloud/internal/unified_grpc_credentials.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_instant_snapshot_groups_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +InstantSnapshotGroupsConnection::~InstantSnapshotGroupsConnection() = default; + +future> +InstantSnapshotGroupsConnection::DeleteInstantSnapshotGroup( + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +InstantSnapshotGroupsConnection::DeleteInstantSnapshotGroup( + NoAwaitTag, google::cloud::cpp::compute::instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest const&) { + return StatusOr( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +InstantSnapshotGroupsConnection::DeleteInstantSnapshotGroup( + google::cloud::cpp::compute::v1::Operation const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +InstantSnapshotGroupsConnection::GetInstantSnapshotGroup( + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + GetInstantSnapshotGroupRequest const&) { + return Status(StatusCode::kUnimplemented, "not implemented"); +} + +StatusOr +InstantSnapshotGroupsConnection::GetIamPolicy( + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + GetIamPolicyRequest const&) { + return Status(StatusCode::kUnimplemented, "not implemented"); +} + +future> +InstantSnapshotGroupsConnection::InsertInstantSnapshotGroup( + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +InstantSnapshotGroupsConnection::InsertInstantSnapshotGroup( + NoAwaitTag, google::cloud::cpp::compute::instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest const&) { + return StatusOr( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +InstantSnapshotGroupsConnection::InsertInstantSnapshotGroup( + google::cloud::cpp::compute::v1::Operation const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StreamRange +InstantSnapshotGroupsConnection::ListInstantSnapshotGroups( + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + ListInstantSnapshotGroupsRequest) { // NOLINT(performance-unnecessary-value-param) + return google::cloud::internal::MakeUnimplementedPaginationRange< + StreamRange>(); +} + +StatusOr +InstantSnapshotGroupsConnection::SetIamPolicy( + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + SetIamPolicyRequest const&) { + return Status(StatusCode::kUnimplemented, "not implemented"); +} + +StatusOr +InstantSnapshotGroupsConnection::TestIamPermissions( + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + TestIamPermissionsRequest const&) { + return Status(StatusCode::kUnimplemented, "not implemented"); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_instant_snapshot_groups_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups_connection.h b/google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups_connection.h new file mode 100644 index 0000000000000..fdb6633344faa --- /dev/null +++ b/google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups_connection.h @@ -0,0 +1,254 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_INSTANT_SNAPSHOT_GROUPS_V1_INSTANT_SNAPSHOT_GROUPS_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_INSTANT_SNAPSHOT_GROUPS_V1_INSTANT_SNAPSHOT_GROUPS_CONNECTION_H + +#include "google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups.pb.h" +#include "google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups_connection_idempotency_policy.h" +#include "google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_retry_traits.h" +#include "google/cloud/backoff_policy.h" +#include "google/cloud/future.h" +#include "google/cloud/internal/retry_policy_impl.h" +#include "google/cloud/no_await_tag.h" +#include "google/cloud/options.h" +#include "google/cloud/polling_policy.h" +#include "google/cloud/status_or.h" +#include "google/cloud/stream_range.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_instant_snapshot_groups_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/// The retry policy for `InstantSnapshotGroupsConnection`. +class InstantSnapshotGroupsRetryPolicy : public ::google::cloud::RetryPolicy { + public: + /// Creates a new instance of the policy, reset to the initial state. + virtual std::unique_ptr clone() const = 0; +}; + +/** + * A retry policy for `InstantSnapshotGroupsConnection` based on counting + * errors. + * + * This policy stops retrying if: + * - An RPC returns a non-transient error. + * - More than a prescribed number of transient failures is detected. + * + * In this class the following status codes are treated as transient errors: + * - [`kUnavailable`](@ref google::cloud::StatusCode) + */ +class InstantSnapshotGroupsLimitedErrorCountRetryPolicy + : public InstantSnapshotGroupsRetryPolicy { + public: + /** + * Create an instance that tolerates up to @p maximum_failures transient + * errors. + * + * @note Disable the retry loop by providing an instance of this policy with + * @p maximum_failures == 0. + */ + explicit InstantSnapshotGroupsLimitedErrorCountRetryPolicy( + int maximum_failures) + : impl_(maximum_failures) {} + + InstantSnapshotGroupsLimitedErrorCountRetryPolicy( + InstantSnapshotGroupsLimitedErrorCountRetryPolicy&& rhs) noexcept + : InstantSnapshotGroupsLimitedErrorCountRetryPolicy( + rhs.maximum_failures()) {} + InstantSnapshotGroupsLimitedErrorCountRetryPolicy( + InstantSnapshotGroupsLimitedErrorCountRetryPolicy const& rhs) noexcept + : InstantSnapshotGroupsLimitedErrorCountRetryPolicy( + rhs.maximum_failures()) {} + + int maximum_failures() const { return impl_.maximum_failures(); } + + bool OnFailure(Status const& status) override { + return impl_.OnFailure(status); + } + bool IsExhausted() const override { return impl_.IsExhausted(); } + bool IsPermanentFailure(Status const& status) const override { + return impl_.IsPermanentFailure(status); + } + std::unique_ptr clone() const override { + return std::make_unique( + maximum_failures()); + } + + // This is provided only for backwards compatibility. + using BaseType = InstantSnapshotGroupsRetryPolicy; + + private: + google::cloud::internal::LimitedErrorCountRetryPolicy< + compute_instant_snapshot_groups_v1_internal:: + InstantSnapshotGroupsRetryTraits> + impl_; +}; + +/** + * A retry policy for `InstantSnapshotGroupsConnection` based on elapsed time. + * + * This policy stops retrying if: + * - An RPC returns a non-transient error. + * - The elapsed time in the retry loop exceeds a prescribed duration. + * + * In this class the following status codes are treated as transient errors: + * - [`kUnavailable`](@ref google::cloud::StatusCode) + */ +class InstantSnapshotGroupsLimitedTimeRetryPolicy + : public InstantSnapshotGroupsRetryPolicy { + public: + /** + * Constructor given a `std::chrono::duration<>` object. + * + * @tparam DurationRep a placeholder to match the `Rep` tparam for @p + * duration's type. The semantics of this template parameter are + * documented in `std::chrono::duration<>`. In brief, the underlying + * arithmetic type used to store the number of ticks. For our purposes it + * is simply a formal parameter. + * @tparam DurationPeriod a placeholder to match the `Period` tparam for @p + * duration's type. The semantics of this template parameter are + * documented in `std::chrono::duration<>`. In brief, the length of the + * tick in seconds, expressed as a `std::ratio<>`. For our purposes it is + * simply a formal parameter. + * @param maximum_duration the maximum time allowed before the policy expires. + * While the application can express this time in any units they desire, + * the class truncates to milliseconds. + * + * @see https://en.cppreference.com/w/cpp/chrono/duration for more information + * about `std::chrono::duration`. + */ + template + explicit InstantSnapshotGroupsLimitedTimeRetryPolicy( + std::chrono::duration maximum_duration) + : impl_(maximum_duration) {} + + InstantSnapshotGroupsLimitedTimeRetryPolicy( + InstantSnapshotGroupsLimitedTimeRetryPolicy&& rhs) noexcept + : InstantSnapshotGroupsLimitedTimeRetryPolicy(rhs.maximum_duration()) {} + InstantSnapshotGroupsLimitedTimeRetryPolicy( + InstantSnapshotGroupsLimitedTimeRetryPolicy const& rhs) noexcept + : InstantSnapshotGroupsLimitedTimeRetryPolicy(rhs.maximum_duration()) {} + + std::chrono::milliseconds maximum_duration() const { + return impl_.maximum_duration(); + } + + bool OnFailure(Status const& status) override { + return impl_.OnFailure(status); + } + bool IsExhausted() const override { return impl_.IsExhausted(); } + bool IsPermanentFailure(Status const& status) const override { + return impl_.IsPermanentFailure(status); + } + std::unique_ptr clone() const override { + return std::make_unique( + maximum_duration()); + } + + // This is provided only for backwards compatibility. + using BaseType = InstantSnapshotGroupsRetryPolicy; + + private: + google::cloud::internal::LimitedTimeRetryPolicy< + compute_instant_snapshot_groups_v1_internal:: + InstantSnapshotGroupsRetryTraits> + impl_; +}; + +/** + * The `InstantSnapshotGroupsConnection` object for + * `InstantSnapshotGroupsClient`. + * + * This interface defines virtual methods for each of the user-facing overload + * sets in `InstantSnapshotGroupsClient`. This allows users to inject custom + * behavior (e.g., with a Google Mock object) when writing tests that use + * objects of type `InstantSnapshotGroupsClient`. + * + * To create a concrete instance, see `MakeInstantSnapshotGroupsConnection()`. + * + * For mocking, see + * `compute_instant_snapshot_groups_v1_mocks::MockInstantSnapshotGroupsConnection`. + */ +class InstantSnapshotGroupsConnection { + public: + virtual ~InstantSnapshotGroupsConnection() = 0; + + virtual Options options() { return Options{}; } + + virtual future> + DeleteInstantSnapshotGroup( + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest const& request); + + virtual StatusOr + DeleteInstantSnapshotGroup( + NoAwaitTag, google::cloud::cpp::compute::instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest const& request); + + virtual future> + DeleteInstantSnapshotGroup( + google::cloud::cpp::compute::v1::Operation const& operation); + + virtual StatusOr + GetInstantSnapshotGroup( + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + GetInstantSnapshotGroupRequest const& request); + + virtual StatusOr GetIamPolicy( + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + GetIamPolicyRequest const& request); + + virtual future> + InsertInstantSnapshotGroup( + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest const& request); + + virtual StatusOr + InsertInstantSnapshotGroup( + NoAwaitTag, google::cloud::cpp::compute::instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest const& request); + + virtual future> + InsertInstantSnapshotGroup( + google::cloud::cpp::compute::v1::Operation const& operation); + + virtual StreamRange + ListInstantSnapshotGroups( + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + ListInstantSnapshotGroupsRequest request); + + virtual StatusOr SetIamPolicy( + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + SetIamPolicyRequest const& request); + + virtual StatusOr + TestIamPermissions(google::cloud::cpp::compute::instant_snapshot_groups::v1:: + TestIamPermissionsRequest const& request); +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_instant_snapshot_groups_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_INSTANT_SNAPSHOT_GROUPS_V1_INSTANT_SNAPSHOT_GROUPS_CONNECTION_H diff --git a/google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups_connection_idempotency_policy.cc b/google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups_connection_idempotency_policy.cc new file mode 100644 index 0000000000000..7cc0a0050f668 --- /dev/null +++ b/google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups_connection_idempotency_policy.cc @@ -0,0 +1,94 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups.proto + +#include "google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups_connection_idempotency_policy.h" +#include + +namespace google { +namespace cloud { +namespace compute_instant_snapshot_groups_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +using ::google::cloud::Idempotency; + +InstantSnapshotGroupsConnectionIdempotencyPolicy:: + ~InstantSnapshotGroupsConnectionIdempotencyPolicy() = default; + +std::unique_ptr +InstantSnapshotGroupsConnectionIdempotencyPolicy::clone() const { + return std::make_unique( + *this); +} + +Idempotency +InstantSnapshotGroupsConnectionIdempotencyPolicy::DeleteInstantSnapshotGroup( + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest const&) { + return Idempotency::kNonIdempotent; +} + +Idempotency +InstantSnapshotGroupsConnectionIdempotencyPolicy::GetInstantSnapshotGroup( + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + GetInstantSnapshotGroupRequest const&) { + return Idempotency::kIdempotent; +} + +Idempotency InstantSnapshotGroupsConnectionIdempotencyPolicy::GetIamPolicy( + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + GetIamPolicyRequest const&) { + return Idempotency::kIdempotent; +} + +Idempotency +InstantSnapshotGroupsConnectionIdempotencyPolicy::InsertInstantSnapshotGroup( + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest const&) { + return Idempotency::kNonIdempotent; +} + +Idempotency +InstantSnapshotGroupsConnectionIdempotencyPolicy::ListInstantSnapshotGroups( + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + ListInstantSnapshotGroupsRequest) { // NOLINT + return Idempotency::kIdempotent; +} + +Idempotency InstantSnapshotGroupsConnectionIdempotencyPolicy::SetIamPolicy( + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + SetIamPolicyRequest const&) { + return Idempotency::kNonIdempotent; +} + +Idempotency +InstantSnapshotGroupsConnectionIdempotencyPolicy::TestIamPermissions( + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + TestIamPermissionsRequest const&) { + return Idempotency::kNonIdempotent; +} + +std::unique_ptr +MakeDefaultInstantSnapshotGroupsConnectionIdempotencyPolicy() { + return std::make_unique(); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_instant_snapshot_groups_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups_connection_idempotency_policy.h b/google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups_connection_idempotency_policy.h new file mode 100644 index 0000000000000..543c5b384cf03 --- /dev/null +++ b/google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups_connection_idempotency_policy.h @@ -0,0 +1,78 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_INSTANT_SNAPSHOT_GROUPS_V1_INSTANT_SNAPSHOT_GROUPS_CONNECTION_IDEMPOTENCY_POLICY_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_INSTANT_SNAPSHOT_GROUPS_V1_INSTANT_SNAPSHOT_GROUPS_CONNECTION_IDEMPOTENCY_POLICY_H + +#include "google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups.pb.h" +#include "google/cloud/idempotency.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_instant_snapshot_groups_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class InstantSnapshotGroupsConnectionIdempotencyPolicy { + public: + virtual ~InstantSnapshotGroupsConnectionIdempotencyPolicy(); + + /// Create a new copy of this object. + virtual std::unique_ptr + clone() const; + + virtual google::cloud::Idempotency DeleteInstantSnapshotGroup( + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest const& request); + + virtual google::cloud::Idempotency GetInstantSnapshotGroup( + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + GetInstantSnapshotGroupRequest const& request); + + virtual google::cloud::Idempotency GetIamPolicy( + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + GetIamPolicyRequest const& request); + + virtual google::cloud::Idempotency InsertInstantSnapshotGroup( + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest const& request); + + virtual google::cloud::Idempotency ListInstantSnapshotGroups( + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + ListInstantSnapshotGroupsRequest request); + + virtual google::cloud::Idempotency SetIamPolicy( + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + SetIamPolicyRequest const& request); + + virtual google::cloud::Idempotency TestIamPermissions( + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + TestIamPermissionsRequest const& request); +}; + +std::unique_ptr +MakeDefaultInstantSnapshotGroupsConnectionIdempotencyPolicy(); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_instant_snapshot_groups_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_INSTANT_SNAPSHOT_GROUPS_V1_INSTANT_SNAPSHOT_GROUPS_CONNECTION_IDEMPOTENCY_POLICY_H diff --git a/google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups_options.h b/google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups_options.h new file mode 100644 index 0000000000000..2b18124957ece --- /dev/null +++ b/google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups_options.h @@ -0,0 +1,89 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_INSTANT_SNAPSHOT_GROUPS_V1_INSTANT_SNAPSHOT_GROUPS_OPTIONS_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_INSTANT_SNAPSHOT_GROUPS_V1_INSTANT_SNAPSHOT_GROUPS_OPTIONS_H + +#include "google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups_connection.h" +#include "google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups_connection_idempotency_policy.h" +#include "google/cloud/backoff_policy.h" +#include "google/cloud/options.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_instant_snapshot_groups_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/** + * Use with `google::cloud::Options` to configure the retry policy. + * + * @ingroup google-cloud-compute-options + */ +struct InstantSnapshotGroupsRetryPolicyOption { + using Type = std::shared_ptr; +}; + +/** + * Use with `google::cloud::Options` to configure the backoff policy. + * + * @ingroup google-cloud-compute-options + */ +struct InstantSnapshotGroupsBackoffPolicyOption { + using Type = std::shared_ptr; +}; + +/** + * Use with `google::cloud::Options` to configure which operations are retried. + * + * @ingroup google-cloud-compute-options + */ +struct InstantSnapshotGroupsConnectionIdempotencyPolicyOption { + using Type = + std::shared_ptr; +}; + +/** + * Use with `google::cloud::Options` to configure the long-running operations + * polling policy. + * + * @ingroup google-cloud-compute-options + */ +struct InstantSnapshotGroupsPollingPolicyOption { + using Type = std::shared_ptr; +}; + +/** + * The options applicable to InstantSnapshotGroups. + * + * @ingroup google-cloud-compute-options + */ +using InstantSnapshotGroupsPolicyOptionList = + OptionList; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_instant_snapshot_groups_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_INSTANT_SNAPSHOT_GROUPS_V1_INSTANT_SNAPSHOT_GROUPS_OPTIONS_H diff --git a/google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups_proto_export.h b/google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups_proto_export.h new file mode 100644 index 0000000000000..97acd91eae656 --- /dev/null +++ b/google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups_proto_export.h @@ -0,0 +1,37 @@ +// Copyright 2026 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_INSTANT_SNAPSHOT_GROUPS_V1_INSTANT_SNAPSHOT_GROUPS_PROTO_EXPORT_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_INSTANT_SNAPSHOT_GROUPS_V1_INSTANT_SNAPSHOT_GROUPS_PROTO_EXPORT_H + +// IWYU pragma: begin_exports +#include "google/cloud/compute/v1/internal/common_009.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_040.pb.h" +#include "google/cloud/compute/v1/internal/common_083.pb.h" +#include "google/cloud/compute/v1/internal/common_171.pb.h" +#include "google/cloud/compute/v1/internal/common_182.pb.h" +// IWYU pragma: end_exports + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_INSTANT_SNAPSHOT_GROUPS_V1_INSTANT_SNAPSHOT_GROUPS_PROTO_EXPORT_H diff --git a/google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups_rest_connection.cc b/google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups_rest_connection.cc new file mode 100644 index 0000000000000..2d2b76ad396dd --- /dev/null +++ b/google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups_rest_connection.cc @@ -0,0 +1,61 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups.proto + +#include "google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups_rest_connection.h" +#include "google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups_options.h" +#include "google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_option_defaults.h" +#include "google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_rest_connection_impl.h" +#include "google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_rest_stub_factory.h" +#include "google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_tracing_connection.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/internal/rest_background_threads_impl.h" +#include "google/cloud/internal/rest_options.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_instant_snapshot_groups_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +std::shared_ptr +MakeInstantSnapshotGroupsConnectionRest(Options options) { + internal::CheckExpectedOptions( + options, __func__); + options = compute_instant_snapshot_groups_v1_internal:: + InstantSnapshotGroupsDefaultOptions(std::move(options)); + auto background = std::make_unique< + rest_internal::AutomaticallyCreatedRestBackgroundThreads>(); + auto stub = compute_instant_snapshot_groups_v1_internal:: + CreateDefaultInstantSnapshotGroupsRestStub(options); + return compute_instant_snapshot_groups_v1_internal:: + MakeInstantSnapshotGroupsTracingConnection( + std::make_shared( + std::move(background), std::move(stub), std::move(options))); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_instant_snapshot_groups_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups_rest_connection.h b/google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups_rest_connection.h new file mode 100644 index 0000000000000..dd4d4fc8f0940 --- /dev/null +++ b/google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups_rest_connection.h @@ -0,0 +1,67 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_INSTANT_SNAPSHOT_GROUPS_V1_INSTANT_SNAPSHOT_GROUPS_REST_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_INSTANT_SNAPSHOT_GROUPS_V1_INSTANT_SNAPSHOT_GROUPS_REST_CONNECTION_H + +#include "google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups_connection.h" +#include "google/cloud/options.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_instant_snapshot_groups_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/** + * A factory function to construct an object of type + * `InstantSnapshotGroupsConnection` that uses REST over HTTP as transport in + * lieu of gRPC. REST transport should only be used for services that do not + * support gRPC or if the existing network configuration precludes using gRPC. + * + * The returned connection object should not be used directly; instead it + * should be passed as an argument to the constructor of + * InstantSnapshotGroupsClient. + * + * The optional @p options argument may be used to configure aspects of the + * returned `InstantSnapshotGroupsConnection`. Expected options are any of the + * types in the following option lists: + * + * - `google::cloud::CommonOptionList` + * - `google::cloud::RestOptionList` + * - `google::cloud::UnifiedCredentialsOptionList` + * - + * `google::cloud::compute_instant_snapshot_groups_v1::InstantSnapshotGroupsPolicyOptionList` + * + * @note Unexpected options will be ignored. To log unexpected options instead, + * set `GOOGLE_CLOUD_CPP_ENABLE_CLOG=yes` in the environment. + * + * @param options (optional) Configure the `InstantSnapshotGroupsConnection` + * created by this function. + */ +std::shared_ptr +MakeInstantSnapshotGroupsConnectionRest(Options options = {}); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_instant_snapshot_groups_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_INSTANT_SNAPSHOT_GROUPS_V1_INSTANT_SNAPSHOT_GROUPS_REST_CONNECTION_H diff --git a/google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_option_defaults.cc b/google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_option_defaults.cc new file mode 100644 index 0000000000000..3877677935ecb --- /dev/null +++ b/google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_option_defaults.cc @@ -0,0 +1,94 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups.proto + +#include "google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_option_defaults.h" +#include "google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups_connection.h" +#include "google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups_options.h" +#include "google/cloud/internal/populate_common_options.h" +#include "google/cloud/internal/populate_grpc_options.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_instant_snapshot_groups_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +namespace { +auto constexpr kBackoffScaling = 2.0; +} // namespace + +Options InstantSnapshotGroupsDefaultOptions(Options options) { + options = internal::PopulateCommonOptions( + std::move(options), "GOOGLE_CLOUD_CPP_INSTANT_SNAPSHOT_GROUPS_ENDPOINT", + "", "GOOGLE_CLOUD_CPP_INSTANT_SNAPSHOT_GROUPS_AUTHORITY", + "compute.googleapis.com"); + options = internal::PopulateGrpcOptions(std::move(options)); + if (!options.has()) { + options.set( + compute_instant_snapshot_groups_v1:: + InstantSnapshotGroupsLimitedTimeRetryPolicy( + std::chrono::minutes(10)) + .clone()); + } + if (!options.has()) { + options.set( + ExponentialBackoffPolicy( + std::chrono::seconds(0), std::chrono::seconds(1), + std::chrono::minutes(5), kBackoffScaling, kBackoffScaling) + .clone()); + } + if (!options.has()) { + options.set( + GenericPollingPolicy< + compute_instant_snapshot_groups_v1:: + InstantSnapshotGroupsRetryPolicyOption::Type, + compute_instant_snapshot_groups_v1:: + InstantSnapshotGroupsBackoffPolicyOption::Type>( + options + .get() + ->clone(), + ExponentialBackoffPolicy(std::chrono::seconds(1), + std::chrono::minutes(5), kBackoffScaling) + .clone()) + .clone()); + } + if (!options + .has()) { + options.set( + compute_instant_snapshot_groups_v1:: + MakeDefaultInstantSnapshotGroupsConnectionIdempotencyPolicy()); + } + + return options; +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_instant_snapshot_groups_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_option_defaults.h b/google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_option_defaults.h new file mode 100644 index 0000000000000..59712f33871ac --- /dev/null +++ b/google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_option_defaults.h @@ -0,0 +1,38 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_INSTANT_SNAPSHOT_GROUPS_V1_INTERNAL_INSTANT_SNAPSHOT_GROUPS_OPTION_DEFAULTS_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_INSTANT_SNAPSHOT_GROUPS_V1_INTERNAL_INSTANT_SNAPSHOT_GROUPS_OPTION_DEFAULTS_H + +#include "google/cloud/options.h" +#include "google/cloud/version.h" + +namespace google { +namespace cloud { +namespace compute_instant_snapshot_groups_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +Options InstantSnapshotGroupsDefaultOptions(Options options); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_instant_snapshot_groups_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_INSTANT_SNAPSHOT_GROUPS_V1_INTERNAL_INSTANT_SNAPSHOT_GROUPS_OPTION_DEFAULTS_H diff --git a/google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_rest_connection_impl.cc b/google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_rest_connection_impl.cc new file mode 100644 index 0000000000000..1f59f7311c611 --- /dev/null +++ b/google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_rest_connection_impl.cc @@ -0,0 +1,421 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups.proto + +#include "google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_rest_connection_impl.h" +#include "google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_rest_stub_factory.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/internal/async_rest_long_running_operation_custom.h" +#include "google/cloud/internal/extract_long_running_result.h" +#include "google/cloud/internal/pagination_range.h" +#include "google/cloud/internal/rest_lro_helpers.h" +#include "google/cloud/internal/rest_retry_loop.h" +#include "google/cloud/rest_options.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_instant_snapshot_groups_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +InstantSnapshotGroupsRestConnectionImpl:: + InstantSnapshotGroupsRestConnectionImpl( + std::unique_ptr background, + std::shared_ptr + stub, + Options options) + : background_(std::move(background)), + stub_(std::move(stub)), + options_(internal::MergeOptions( + std::move(options), InstantSnapshotGroupsConnection::options())) {} + +future> +InstantSnapshotGroupsRestConnectionImpl::DeleteInstantSnapshotGroup( + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::zone_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::zone_operations::v1::DeleteOperationRequest>( + background_->cq(), current, request, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest const& request) { + return stub->AsyncDeleteInstantSnapshotGroup( + cq, std::move(context), std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->DeleteInstantSnapshotGroup(request), + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [request]( + std::string const& op, + google::cloud::cpp::compute::zone_operations::v1::GetOperationRequest& + r) { + r.set_project(request.project()); + r.set_zone(request.zone()); + r.set_operation(op); + }, + [request](std::string const& op, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest& r) { + r.set_project(request.project()); + r.set_zone(request.zone()); + r.set_operation(op); + }); +} + +StatusOr +InstantSnapshotGroupsRestConnectionImpl::DeleteInstantSnapshotGroup( + NoAwaitTag, google::cloud::cpp::compute::instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->DeleteInstantSnapshotGroup(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest const& request) { + return stub_->DeleteInstantSnapshotGroup(rest_context, options, + request); + }, + *current, request, __func__); +} + +future> +InstantSnapshotGroupsRestConnectionImpl::DeleteInstantSnapshotGroup( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestAwaitLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::zone_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::zone_operations::v1::DeleteOperationRequest>( + background_->cq(), current, operation, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [operation]( + std::string const&, + google::cloud::cpp::compute::zone_operations::v1::GetOperationRequest& + r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_zone(info.zone); + r.set_operation(info.operation); + }, + [operation](std::string const&, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_zone(info.zone); + r.set_operation(info.operation); + }); +} + +StatusOr +InstantSnapshotGroupsRestConnectionImpl::GetInstantSnapshotGroup( + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + GetInstantSnapshotGroupRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->GetInstantSnapshotGroup(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + GetInstantSnapshotGroupRequest const& request) { + return stub_->GetInstantSnapshotGroup(rest_context, options, request); + }, + *current, request, __func__); +} + +StatusOr +InstantSnapshotGroupsRestConnectionImpl::GetIamPolicy( + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + GetIamPolicyRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->GetIamPolicy(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + GetIamPolicyRequest const& request) { + return stub_->GetIamPolicy(rest_context, options, request); + }, + *current, request, __func__); +} + +future> +InstantSnapshotGroupsRestConnectionImpl::InsertInstantSnapshotGroup( + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::zone_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::zone_operations::v1::DeleteOperationRequest>( + background_->cq(), current, request, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest const& request) { + return stub->AsyncInsertInstantSnapshotGroup( + cq, std::move(context), std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->InsertInstantSnapshotGroup(request), + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [request]( + std::string const& op, + google::cloud::cpp::compute::zone_operations::v1::GetOperationRequest& + r) { + r.set_project(request.project()); + r.set_zone(request.zone()); + r.set_operation(op); + }, + [request](std::string const& op, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest& r) { + r.set_project(request.project()); + r.set_zone(request.zone()); + r.set_operation(op); + }); +} + +StatusOr +InstantSnapshotGroupsRestConnectionImpl::InsertInstantSnapshotGroup( + NoAwaitTag, google::cloud::cpp::compute::instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->InsertInstantSnapshotGroup(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest const& request) { + return stub_->InsertInstantSnapshotGroup(rest_context, options, + request); + }, + *current, request, __func__); +} + +future> +InstantSnapshotGroupsRestConnectionImpl::InsertInstantSnapshotGroup( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestAwaitLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::zone_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::zone_operations::v1::DeleteOperationRequest>( + background_->cq(), current, operation, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [operation]( + std::string const&, + google::cloud::cpp::compute::zone_operations::v1::GetOperationRequest& + r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_zone(info.zone); + r.set_operation(info.operation); + }, + [operation](std::string const&, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_zone(info.zone); + r.set_operation(info.operation); + }); +} + +StreamRange +InstantSnapshotGroupsRestConnectionImpl::ListInstantSnapshotGroups( + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + ListInstantSnapshotGroupsRequest request) { + request.clear_page_token(); + auto current = google::cloud::internal::SaveCurrentOptions(); + auto idempotency = + idempotency_policy(*current)->ListInstantSnapshotGroups(request); + char const* function_name = __func__; + return google::cloud::internal::MakePaginationRange< + StreamRange>( + current, std::move(request), + [idempotency, function_name, stub = stub_, + retry = std::shared_ptr( + retry_policy(*current)), + backoff = std::shared_ptr(backoff_policy(*current))]( + Options const& options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + ListInstantSnapshotGroupsRequest const& r) { + return google::cloud::rest_internal::RestRetryLoop( + retry->clone(), backoff->clone(), idempotency, + [stub](rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + ListInstantSnapshotGroupsRequest const& request) { + return stub->ListInstantSnapshotGroups(rest_context, options, + request); + }, + options, r, function_name); + }, + [](google::cloud::cpp::compute::v1::ListInstantSnapshotGroups r) { + std::vector + result(r.items().size()); + auto& messages = *r.mutable_items(); + std::move(messages.begin(), messages.end(), result.begin()); + return result; + }); +} + +StatusOr +InstantSnapshotGroupsRestConnectionImpl::SetIamPolicy( + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + SetIamPolicyRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->SetIamPolicy(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + SetIamPolicyRequest const& request) { + return stub_->SetIamPolicy(rest_context, options, request); + }, + *current, request, __func__); +} + +StatusOr +InstantSnapshotGroupsRestConnectionImpl::TestIamPermissions( + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + TestIamPermissionsRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->TestIamPermissions(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + TestIamPermissionsRequest const& request) { + return stub_->TestIamPermissions(rest_context, options, request); + }, + *current, request, __func__); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_instant_snapshot_groups_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_rest_connection_impl.h b/google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_rest_connection_impl.h new file mode 100644 index 0000000000000..c428e5979d8bd --- /dev/null +++ b/google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_rest_connection_impl.h @@ -0,0 +1,154 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_INSTANT_SNAPSHOT_GROUPS_V1_INTERNAL_INSTANT_SNAPSHOT_GROUPS_REST_CONNECTION_IMPL_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_INSTANT_SNAPSHOT_GROUPS_V1_INTERNAL_INSTANT_SNAPSHOT_GROUPS_REST_CONNECTION_IMPL_H + +#include "google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups_connection.h" +#include "google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups_connection_idempotency_policy.h" +#include "google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups_options.h" +#include "google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_rest_stub.h" +#include "google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_retry_traits.h" +#include "google/cloud/compute/zone_operations/v1/zone_operations.pb.h" +#include "google/cloud/background_threads.h" +#include "google/cloud/backoff_policy.h" +#include "google/cloud/options.h" +#include "google/cloud/status_or.h" +#include "google/cloud/stream_range.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_instant_snapshot_groups_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class InstantSnapshotGroupsRestConnectionImpl + : public compute_instant_snapshot_groups_v1:: + InstantSnapshotGroupsConnection { + public: + ~InstantSnapshotGroupsRestConnectionImpl() override = default; + + InstantSnapshotGroupsRestConnectionImpl( + std::unique_ptr background, + std::shared_ptr + stub, + Options options); + + Options options() override { return options_; } + + future> + DeleteInstantSnapshotGroup( + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest const& request) override; + + StatusOr + DeleteInstantSnapshotGroup( + NoAwaitTag, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest const& request) override; + + future> + DeleteInstantSnapshotGroup( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + StatusOr + GetInstantSnapshotGroup( + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + GetInstantSnapshotGroupRequest const& request) override; + + StatusOr GetIamPolicy( + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + GetIamPolicyRequest const& request) override; + + future> + InsertInstantSnapshotGroup( + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest const& request) override; + + StatusOr + InsertInstantSnapshotGroup( + NoAwaitTag, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest const& request) override; + + future> + InsertInstantSnapshotGroup( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + StreamRange + ListInstantSnapshotGroups( + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + ListInstantSnapshotGroupsRequest request) override; + + StatusOr SetIamPolicy( + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + SetIamPolicyRequest const& request) override; + + StatusOr + TestIamPermissions(google::cloud::cpp::compute::instant_snapshot_groups::v1:: + TestIamPermissionsRequest const& request) override; + + private: + static std::unique_ptr< + compute_instant_snapshot_groups_v1::InstantSnapshotGroupsRetryPolicy> + retry_policy(Options const& options) { + return options + .get() + ->clone(); + } + + static std::unique_ptr backoff_policy(Options const& options) { + return options + .get() + ->clone(); + } + + static std::unique_ptr + idempotency_policy(Options const& options) { + return options + .get() + ->clone(); + } + + static std::unique_ptr polling_policy(Options const& options) { + return options + .get() + ->clone(); + } + + std::unique_ptr background_; + std::shared_ptr + stub_; + Options options_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_instant_snapshot_groups_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_INSTANT_SNAPSHOT_GROUPS_V1_INTERNAL_INSTANT_SNAPSHOT_GROUPS_REST_CONNECTION_IMPL_H diff --git a/google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_rest_logging_decorator.cc b/google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_rest_logging_decorator.cc new file mode 100644 index 0000000000000..f29228290beb6 --- /dev/null +++ b/google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_rest_logging_decorator.cc @@ -0,0 +1,221 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups.proto + +#include "google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_rest_logging_decorator.h" +#include "google/cloud/internal/log_wrapper.h" +#include "google/cloud/status_or.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_instant_snapshot_groups_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +InstantSnapshotGroupsRestLogging::InstantSnapshotGroupsRestLogging( + std::shared_ptr child, + TracingOptions tracing_options, std::set components) + : child_(std::move(child)), + tracing_options_(std::move(tracing_options)), + components_(std::move(components)) {} + +future> +InstantSnapshotGroupsRestLogging::AsyncDeleteInstantSnapshotGroup( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest const& request) { + return child_->AsyncDeleteInstantSnapshotGroup( + cq, std::move(rest_context), std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +StatusOr +InstantSnapshotGroupsRestLogging::DeleteInstantSnapshotGroup( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest const& request) { + return child_->DeleteInstantSnapshotGroup(rest_context, options, + request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +StatusOr +InstantSnapshotGroupsRestLogging::GetInstantSnapshotGroup( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + GetInstantSnapshotGroupRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + GetInstantSnapshotGroupRequest const& request) { + return child_->GetInstantSnapshotGroup(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +StatusOr +InstantSnapshotGroupsRestLogging::GetIamPolicy( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + GetIamPolicyRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + GetIamPolicyRequest const& request) { + return child_->GetIamPolicy(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +future> +InstantSnapshotGroupsRestLogging::AsyncInsertInstantSnapshotGroup( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest const& request) { + return child_->AsyncInsertInstantSnapshotGroup( + cq, std::move(rest_context), std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +StatusOr +InstantSnapshotGroupsRestLogging::InsertInstantSnapshotGroup( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest const& request) { + return child_->InsertInstantSnapshotGroup(rest_context, options, + request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +StatusOr +InstantSnapshotGroupsRestLogging::ListInstantSnapshotGroups( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + ListInstantSnapshotGroupsRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + ListInstantSnapshotGroupsRequest const& request) { + return child_->ListInstantSnapshotGroups(rest_context, options, + request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +StatusOr +InstantSnapshotGroupsRestLogging::SetIamPolicy( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + SetIamPolicyRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + SetIamPolicyRequest const& request) { + return child_->SetIamPolicy(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +StatusOr +InstantSnapshotGroupsRestLogging::TestIamPermissions( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + TestIamPermissionsRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + TestIamPermissionsRequest const& request) { + return child_->TestIamPermissions(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +future> +InstantSnapshotGroupsRestLogging::AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1::GetOperationRequest const& + request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + GetOperationRequest const& request) { + return child_->AsyncGetOperation(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +future InstantSnapshotGroupsRestLogging::AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest const& request) { + return child_->AsyncCancelOperation(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_instant_snapshot_groups_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_rest_logging_decorator.h b/google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_rest_logging_decorator.h new file mode 100644 index 0000000000000..bef7ef0d80e3f --- /dev/null +++ b/google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_rest_logging_decorator.h @@ -0,0 +1,134 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_INSTANT_SNAPSHOT_GROUPS_V1_INTERNAL_INSTANT_SNAPSHOT_GROUPS_REST_LOGGING_DECORATOR_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_INSTANT_SNAPSHOT_GROUPS_V1_INTERNAL_INSTANT_SNAPSHOT_GROUPS_REST_LOGGING_DECORATOR_H + +#include "google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups.pb.h" +#include "google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_rest_stub.h" +#include "google/cloud/compute/zone_operations/v1/zone_operations.pb.h" +#include "google/cloud/future.h" +#include "google/cloud/internal/rest_context.h" +#include "google/cloud/tracing_options.h" +#include "google/cloud/version.h" +#include +#include +#include + +namespace google { +namespace cloud { +namespace compute_instant_snapshot_groups_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class InstantSnapshotGroupsRestLogging : public InstantSnapshotGroupsRestStub { + public: + ~InstantSnapshotGroupsRestLogging() override = default; + InstantSnapshotGroupsRestLogging( + std::shared_ptr child, + TracingOptions tracing_options, std::set components); + + future> + AsyncDeleteInstantSnapshotGroup( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest const& request) override; + + StatusOr + DeleteInstantSnapshotGroup( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest const& request) override; + + StatusOr + GetInstantSnapshotGroup( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + GetInstantSnapshotGroupRequest const& request) override; + + StatusOr GetIamPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + GetIamPolicyRequest const& request) override; + + future> + AsyncInsertInstantSnapshotGroup( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest const& request) override; + + StatusOr + InsertInstantSnapshotGroup( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest const& request) override; + + StatusOr + ListInstantSnapshotGroups( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + ListInstantSnapshotGroupsRequest const& request) override; + + StatusOr SetIamPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + SetIamPolicyRequest const& request) override; + + StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + TestIamPermissionsRequest const& request) override; + + future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + GetOperationRequest const& request) override; + + future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest const& request) override; + + private: + std::shared_ptr child_; + TracingOptions tracing_options_; + std::set components_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_instant_snapshot_groups_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_INSTANT_SNAPSHOT_GROUPS_V1_INTERNAL_INSTANT_SNAPSHOT_GROUPS_REST_LOGGING_DECORATOR_H diff --git a/google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_rest_metadata_decorator.cc b/google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_rest_metadata_decorator.cc new file mode 100644 index 0000000000000..5a886e25fff55 --- /dev/null +++ b/google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_rest_metadata_decorator.cc @@ -0,0 +1,163 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups.proto + +#include "google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_rest_metadata_decorator.h" +#include "google/cloud/internal/api_client_header.h" +#include "google/cloud/internal/rest_set_metadata.h" +#include "google/cloud/status_or.h" +#include "absl/strings/str_cat.h" +#include "absl/strings/str_format.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_instant_snapshot_groups_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +InstantSnapshotGroupsRestMetadata::InstantSnapshotGroupsRestMetadata( + std::shared_ptr child, + std::string api_client_header) + : child_(std::move(child)), + api_client_header_( + api_client_header.empty() + ? google::cloud::internal::GeneratedLibClientHeader() + : std::move(api_client_header)) {} + +future> +InstantSnapshotGroupsRestMetadata::AsyncDeleteInstantSnapshotGroup( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncDeleteInstantSnapshotGroup(cq, std::move(rest_context), + std::move(options), request); +} + +StatusOr +InstantSnapshotGroupsRestMetadata::DeleteInstantSnapshotGroup( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest const& request) { + SetMetadata(rest_context, options); + return child_->DeleteInstantSnapshotGroup(rest_context, options, request); +} + +StatusOr +InstantSnapshotGroupsRestMetadata::GetInstantSnapshotGroup( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + GetInstantSnapshotGroupRequest const& request) { + SetMetadata(rest_context, options); + return child_->GetInstantSnapshotGroup(rest_context, options, request); +} + +StatusOr +InstantSnapshotGroupsRestMetadata::GetIamPolicy( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + GetIamPolicyRequest const& request) { + SetMetadata(rest_context, options); + return child_->GetIamPolicy(rest_context, options, request); +} + +future> +InstantSnapshotGroupsRestMetadata::AsyncInsertInstantSnapshotGroup( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncInsertInstantSnapshotGroup(cq, std::move(rest_context), + std::move(options), request); +} + +StatusOr +InstantSnapshotGroupsRestMetadata::InsertInstantSnapshotGroup( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest const& request) { + SetMetadata(rest_context, options); + return child_->InsertInstantSnapshotGroup(rest_context, options, request); +} + +StatusOr +InstantSnapshotGroupsRestMetadata::ListInstantSnapshotGroups( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + ListInstantSnapshotGroupsRequest const& request) { + SetMetadata(rest_context, options); + return child_->ListInstantSnapshotGroups(rest_context, options, request); +} + +StatusOr +InstantSnapshotGroupsRestMetadata::SetIamPolicy( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + SetIamPolicyRequest const& request) { + SetMetadata(rest_context, options); + return child_->SetIamPolicy(rest_context, options, request); +} + +StatusOr +InstantSnapshotGroupsRestMetadata::TestIamPermissions( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + TestIamPermissionsRequest const& request) { + SetMetadata(rest_context, options); + return child_->TestIamPermissions(rest_context, options, request); +} + +future> +InstantSnapshotGroupsRestMetadata::AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1::GetOperationRequest const& + request) { + SetMetadata(*rest_context, *options); + return child_->AsyncGetOperation(cq, std::move(rest_context), + std::move(options), request); +} + +future InstantSnapshotGroupsRestMetadata::AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncCancelOperation(cq, std::move(rest_context), + std::move(options), request); +} + +void InstantSnapshotGroupsRestMetadata::SetMetadata( + rest_internal::RestContext& rest_context, Options const& options, + std::vector const& params) { + google::cloud::rest_internal::SetMetadata(rest_context, options, params, + api_client_header_); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_instant_snapshot_groups_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_rest_metadata_decorator.h b/google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_rest_metadata_decorator.h new file mode 100644 index 0000000000000..f88a24e51e59c --- /dev/null +++ b/google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_rest_metadata_decorator.h @@ -0,0 +1,135 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_INSTANT_SNAPSHOT_GROUPS_V1_INTERNAL_INSTANT_SNAPSHOT_GROUPS_REST_METADATA_DECORATOR_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_INSTANT_SNAPSHOT_GROUPS_V1_INTERNAL_INSTANT_SNAPSHOT_GROUPS_REST_METADATA_DECORATOR_H + +#include "google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups.pb.h" +#include "google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_rest_stub.h" +#include "google/cloud/compute/zone_operations/v1/zone_operations.pb.h" +#include "google/cloud/future.h" +#include "google/cloud/rest_options.h" +#include "google/cloud/version.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_instant_snapshot_groups_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class InstantSnapshotGroupsRestMetadata : public InstantSnapshotGroupsRestStub { + public: + ~InstantSnapshotGroupsRestMetadata() override = default; + explicit InstantSnapshotGroupsRestMetadata( + std::shared_ptr child, + std::string api_client_header = ""); + + google::cloud::future> + AsyncDeleteInstantSnapshotGroup( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest const& request) override; + + StatusOr + DeleteInstantSnapshotGroup( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest const& request) override; + + StatusOr + GetInstantSnapshotGroup( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + GetInstantSnapshotGroupRequest const& request) override; + + StatusOr GetIamPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + GetIamPolicyRequest const& request) override; + + google::cloud::future> + AsyncInsertInstantSnapshotGroup( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest const& request) override; + + StatusOr + InsertInstantSnapshotGroup( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest const& request) override; + + StatusOr + ListInstantSnapshotGroups( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + ListInstantSnapshotGroupsRequest const& request) override; + + StatusOr SetIamPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + SetIamPolicyRequest const& request) override; + + StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + TestIamPermissionsRequest const& request) override; + + google::cloud::future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + GetOperationRequest const& request) override; + + google::cloud::future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest const& request) override; + + private: + void SetMetadata(rest_internal::RestContext& rest_context, + Options const& options, + std::vector const& params = {}); + + std::shared_ptr child_; + std::string api_client_header_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_instant_snapshot_groups_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_INSTANT_SNAPSHOT_GROUPS_V1_INTERNAL_INSTANT_SNAPSHOT_GROUPS_REST_METADATA_DECORATOR_H diff --git a/google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_rest_stub.cc b/google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_rest_stub.cc new file mode 100644 index 0000000000000..5256db845a742 --- /dev/null +++ b/google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_rest_stub.cc @@ -0,0 +1,337 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups.proto + +#include "google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_rest_stub.h" +#include "google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups.pb.h" +#include "google/cloud/compute/zone_operations/v1/zone_operations.pb.h" +#include "google/cloud/common_options.h" +#include "google/cloud/internal/rest_stub_helpers.h" +#include "google/cloud/status_or.h" +#include "absl/strings/str_cat.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_instant_snapshot_groups_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +DefaultInstantSnapshotGroupsRestStub::DefaultInstantSnapshotGroupsRestStub( + Options options) + : service_(rest_internal::MakePooledRestClient( + options.get(), options)), + operations_(rest_internal::MakePooledRestClient( + options.get(), options)), + options_(std::move(options)) {} + +DefaultInstantSnapshotGroupsRestStub::DefaultInstantSnapshotGroupsRestStub( + std::shared_ptr service, + std::shared_ptr operations, Options options) + : service_(std::move(service)), + operations_(std::move(operations)), + options_(std::move(options)) {} + +future> +DefaultInstantSnapshotGroupsRestStub::AsyncDeleteInstantSnapshotGroup( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest const& request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto service, auto request, auto rest_context, auto options) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + p.set_value( + rest_internal::Delete( + *service, *rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", *options), + "/", "projects", "/", request.project(), "/", + "zones", "/", request.zone(), "/", + "instantSnapshotGroups", "/", + request.instant_snapshot_group()), + std::move(query_params))); + }, + std::move(p), + service_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +StatusOr +DefaultInstantSnapshotGroupsRestStub::DeleteInstantSnapshotGroup( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest const& request) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Delete( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "zones", "/", + request.zone(), "/", "instantSnapshotGroups", "/", + request.instant_snapshot_group()), + std::move(query_params)); +} + +StatusOr +DefaultInstantSnapshotGroupsRestStub::GetInstantSnapshotGroup( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + GetInstantSnapshotGroupRequest const& request) { + std::vector> query_params; + return rest_internal::Get< + google::cloud::cpp::compute::v1::InstantSnapshotGroup>( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "zones", "/", + request.zone(), "/", "instantSnapshotGroups", "/", + request.instant_snapshot_group()), + std::move(query_params)); +} + +StatusOr +DefaultInstantSnapshotGroupsRestStub::GetIamPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + GetIamPolicyRequest const& request) { + std::vector> query_params; + query_params.push_back( + {"options_requested_policy_version", + std::to_string(request.options_requested_policy_version())}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Get( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "zones", "/", + request.zone(), "/", "instantSnapshotGroups", "/", + request.resource(), "/", "getIamPolicy"), + std::move(query_params)); +} + +future> +DefaultInstantSnapshotGroupsRestStub::AsyncInsertInstantSnapshotGroup( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest const& request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto service, auto request, auto rest_context, auto options) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params.push_back( + {"source_consistency_group", request.source_consistency_group()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + p.set_value( + rest_internal::Post( + *service, *rest_context, + request.instant_snapshot_group_resource(), false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", *options), + "/", "projects", "/", request.project(), "/", + "zones", "/", request.zone(), "/", + "instantSnapshotGroups"), + std::move(query_params))); + }, + std::move(p), + service_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +StatusOr +DefaultInstantSnapshotGroupsRestStub::InsertInstantSnapshotGroup( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest const& request) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params.push_back( + {"source_consistency_group", request.source_consistency_group()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Post( + *service_, rest_context, request.instant_snapshot_group_resource(), false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "zones", "/", + request.zone(), "/", "instantSnapshotGroups"), + std::move(query_params)); +} + +StatusOr +DefaultInstantSnapshotGroupsRestStub::ListInstantSnapshotGroups( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + ListInstantSnapshotGroupsRequest const& request) { + std::vector> query_params; + query_params.push_back({"filter", request.filter()}); + query_params.push_back( + {"max_results", std::to_string(request.max_results())}); + query_params.push_back({"order_by", request.order_by()}); + query_params.push_back({"page_token", request.page_token()}); + query_params.push_back({"return_partial_success", + (request.return_partial_success() ? "1" : "0")}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Get< + google::cloud::cpp::compute::v1::ListInstantSnapshotGroups>( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "zones", "/", + request.zone(), "/", "instantSnapshotGroups"), + std::move(query_params)); +} + +StatusOr +DefaultInstantSnapshotGroupsRestStub::SetIamPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + SetIamPolicyRequest const& request) { + std::vector> query_params; + return rest_internal::Post( + *service_, rest_context, request.zone_set_policy_request_resource(), + false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "zones", "/", + request.zone(), "/", "instantSnapshotGroups", "/", + request.resource(), "/", "setIamPolicy"), + std::move(query_params)); +} + +StatusOr +DefaultInstantSnapshotGroupsRestStub::TestIamPermissions( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + TestIamPermissionsRequest const& request) { + std::vector> query_params; + return rest_internal::Post< + google::cloud::cpp::compute::v1::TestPermissionsResponse>( + *service_, rest_context, request.test_permissions_request_resource(), + false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "zones", "/", + request.zone(), "/", "instantSnapshotGroups", "/", + request.resource(), "/", "testIamPermissions"), + std::move(query_params)); +} + +future> +DefaultInstantSnapshotGroupsRestStub::AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1::GetOperationRequest const& + request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto operations, auto request, auto rest_context, + auto options) { + p.set_value( + rest_internal::Get( + *operations, *rest_context, request, false, + absl::StrCat("/compute/", + rest_internal::DetermineApiVersion("v1", *options), + "/projects/", request.project(), "/zones/", + request.zone(), "/operations/", + request.operation()))); + }, + std::move(p), + operations_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +future DefaultInstantSnapshotGroupsRestStub::AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest const& request) { + promise> p; + future> f = p.get_future(); + std::thread t{ + [](auto p, auto operations, auto request, auto rest_context, + auto options) { + p.set_value(rest_internal::Post( + *operations, *rest_context, request, false, + absl::StrCat("/compute/", + rest_internal::DetermineApiVersion("v1", *options), + "/projects/", request.project(), "/zones/", + request.zone(), "/operations/", request.operation()))); + }, + std::move(p), + operations_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get().status(); + }); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_instant_snapshot_groups_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_rest_stub.h b/google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_rest_stub.h new file mode 100644 index 0000000000000..0c6cf8f17e222 --- /dev/null +++ b/google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_rest_stub.h @@ -0,0 +1,217 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_INSTANT_SNAPSHOT_GROUPS_V1_INTERNAL_INSTANT_SNAPSHOT_GROUPS_REST_STUB_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_INSTANT_SNAPSHOT_GROUPS_V1_INTERNAL_INSTANT_SNAPSHOT_GROUPS_REST_STUB_H + +#include "google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups.pb.h" +#include "google/cloud/compute/zone_operations/v1/zone_operations.pb.h" +#include "google/cloud/completion_queue.h" +#include "google/cloud/internal/rest_client.h" +#include "google/cloud/internal/rest_context.h" +#include "google/cloud/status_or.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_instant_snapshot_groups_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class InstantSnapshotGroupsRestStub { + public: + virtual ~InstantSnapshotGroupsRestStub() = default; + + virtual future> + AsyncDeleteInstantSnapshotGroup( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest const& request) = 0; + + virtual StatusOr + DeleteInstantSnapshotGroup( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest const& request) = 0; + + virtual StatusOr + GetInstantSnapshotGroup( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + GetInstantSnapshotGroupRequest const& request) = 0; + + virtual StatusOr GetIamPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + GetIamPolicyRequest const& request) = 0; + + virtual future> + AsyncInsertInstantSnapshotGroup( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest const& request) = 0; + + virtual StatusOr + InsertInstantSnapshotGroup( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest const& request) = 0; + + virtual StatusOr + ListInstantSnapshotGroups( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + ListInstantSnapshotGroupsRequest const& request) = 0; + + virtual StatusOr SetIamPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + SetIamPolicyRequest const& request) = 0; + + virtual StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + TestIamPermissionsRequest const& request) = 0; + + virtual future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + GetOperationRequest const& request) = 0; + + virtual future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest const& request) = 0; +}; + +class DefaultInstantSnapshotGroupsRestStub + : public InstantSnapshotGroupsRestStub { + public: + ~DefaultInstantSnapshotGroupsRestStub() override = default; + + explicit DefaultInstantSnapshotGroupsRestStub(Options options); + DefaultInstantSnapshotGroupsRestStub( + std::shared_ptr service, + std::shared_ptr operations, Options options); + + future> + AsyncDeleteInstantSnapshotGroup( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest const& request) override; + + StatusOr + DeleteInstantSnapshotGroup( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest const& request) override; + + StatusOr + GetInstantSnapshotGroup( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + GetInstantSnapshotGroupRequest const& request) override; + + StatusOr GetIamPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + GetIamPolicyRequest const& request) override; + + future> + AsyncInsertInstantSnapshotGroup( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest const& request) override; + + StatusOr + InsertInstantSnapshotGroup( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest const& request) override; + + StatusOr + ListInstantSnapshotGroups( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + ListInstantSnapshotGroupsRequest const& request) override; + + StatusOr SetIamPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + SetIamPolicyRequest const& request) override; + + StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + TestIamPermissionsRequest const& request) override; + + future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + GetOperationRequest const& request) override; + + future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest const& request) override; + + private: + std::shared_ptr service_; + std::shared_ptr operations_; + Options options_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_instant_snapshot_groups_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_INSTANT_SNAPSHOT_GROUPS_V1_INTERNAL_INSTANT_SNAPSHOT_GROUPS_REST_STUB_H diff --git a/google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_rest_stub_factory.cc b/google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_rest_stub_factory.cc new file mode 100644 index 0000000000000..cf99991da3185 --- /dev/null +++ b/google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_rest_stub_factory.cc @@ -0,0 +1,57 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups.proto + +#include "google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_rest_stub_factory.h" +#include "google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_rest_logging_decorator.h" +#include "google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_rest_metadata_decorator.h" +#include "google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_rest_stub.h" +#include "google/cloud/common_options.h" +#include "google/cloud/internal/algorithm.h" +#include "google/cloud/internal/populate_rest_options.h" +#include "google/cloud/log.h" +#include "google/cloud/options.h" +#include "google/cloud/rest_options.h" +#include "absl/strings/match.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_instant_snapshot_groups_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +std::shared_ptr +CreateDefaultInstantSnapshotGroupsRestStub(Options const& options) { + auto opts = internal::PopulateRestOptions(options); + std::shared_ptr stub = + std::make_shared(std::move(opts)); + stub = std::make_shared(std::move(stub)); + if (internal::Contains(options.get(), "rpc")) { + GCP_LOG(INFO) << "Enabled logging for REST rpc calls"; + stub = std::make_shared( + std::move(stub), options.get(), + options.get()); + } + return stub; +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_instant_snapshot_groups_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_rest_stub_factory.h b/google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_rest_stub_factory.h new file mode 100644 index 0000000000000..81b44d07f71b7 --- /dev/null +++ b/google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_rest_stub_factory.h @@ -0,0 +1,41 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_INSTANT_SNAPSHOT_GROUPS_V1_INTERNAL_INSTANT_SNAPSHOT_GROUPS_REST_STUB_FACTORY_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_INSTANT_SNAPSHOT_GROUPS_V1_INTERNAL_INSTANT_SNAPSHOT_GROUPS_REST_STUB_FACTORY_H + +#include "google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_rest_stub.h" +#include "google/cloud/options.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_instant_snapshot_groups_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +std::shared_ptr +CreateDefaultInstantSnapshotGroupsRestStub(Options const& options); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_instant_snapshot_groups_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_INSTANT_SNAPSHOT_GROUPS_V1_INTERNAL_INSTANT_SNAPSHOT_GROUPS_REST_STUB_FACTORY_H diff --git a/google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_retry_traits.h b/google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_retry_traits.h new file mode 100644 index 0000000000000..21112778fbab0 --- /dev/null +++ b/google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_retry_traits.h @@ -0,0 +1,44 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_INSTANT_SNAPSHOT_GROUPS_V1_INTERNAL_INSTANT_SNAPSHOT_GROUPS_RETRY_TRAITS_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_INSTANT_SNAPSHOT_GROUPS_V1_INTERNAL_INSTANT_SNAPSHOT_GROUPS_RETRY_TRAITS_H + +#include "google/cloud/status.h" +#include "google/cloud/version.h" + +namespace google { +namespace cloud { +namespace compute_instant_snapshot_groups_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/// Define the gRPC status code semantics for retrying requests. +struct InstantSnapshotGroupsRetryTraits { + static bool IsPermanentFailure(google::cloud::Status const& status) { + return status.code() != StatusCode::kOk && + status.code() != StatusCode::kUnavailable; + } +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_instant_snapshot_groups_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_INSTANT_SNAPSHOT_GROUPS_V1_INTERNAL_INSTANT_SNAPSHOT_GROUPS_RETRY_TRAITS_H diff --git a/google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_sources.cc b/google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_sources.cc new file mode 100644 index 0000000000000..79bb13f3c6380 --- /dev/null +++ b/google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_sources.cc @@ -0,0 +1,32 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups.proto + +// NOLINTBEGIN(bugprone-suspicious-include) +#include "google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups_client.cc" +#include "google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups_connection.cc" +#include "google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups_connection_idempotency_policy.cc" +#include "google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups_rest_connection.cc" +#include "google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_option_defaults.cc" +#include "google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_rest_connection_impl.cc" +#include "google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_rest_logging_decorator.cc" +#include "google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_rest_metadata_decorator.cc" +#include "google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_rest_stub.cc" +#include "google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_rest_stub_factory.cc" +#include "google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_tracing_connection.cc" +// NOLINTEND(bugprone-suspicious-include) diff --git a/google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_tracing_connection.cc b/google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_tracing_connection.cc new file mode 100644 index 0000000000000..96c0bba548c95 --- /dev/null +++ b/google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_tracing_connection.cc @@ -0,0 +1,181 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups.proto + +#include "google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_tracing_connection.h" +#include "google/cloud/internal/opentelemetry.h" +#include "google/cloud/internal/traced_stream_range.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_instant_snapshot_groups_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +InstantSnapshotGroupsTracingConnection::InstantSnapshotGroupsTracingConnection( + std::shared_ptr< + compute_instant_snapshot_groups_v1::InstantSnapshotGroupsConnection> + child) + : child_(std::move(child)) {} + +future> +InstantSnapshotGroupsTracingConnection::DeleteInstantSnapshotGroup( + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest const& request) { + auto span = internal::MakeSpan( + "compute_instant_snapshot_groups_v1::InstantSnapshotGroupsConnection::" + "DeleteInstantSnapshotGroup"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), + child_->DeleteInstantSnapshotGroup(request)); +} + +StatusOr +InstantSnapshotGroupsTracingConnection::DeleteInstantSnapshotGroup( + NoAwaitTag, google::cloud::cpp::compute::instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest const& request) { + auto span = internal::MakeSpan( + "compute_instant_snapshot_groups_v1::InstantSnapshotGroupsConnection::" + "DeleteInstantSnapshotGroup"); + opentelemetry::trace::Scope scope(span); + return internal::EndSpan( + *span, child_->DeleteInstantSnapshotGroup(NoAwaitTag{}, request)); +} + +future> +InstantSnapshotGroupsTracingConnection::DeleteInstantSnapshotGroup( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto span = internal::MakeSpan( + "compute_instant_snapshot_groups_v1::InstantSnapshotGroupsConnection::" + "DeleteInstantSnapshotGroup"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), + child_->DeleteInstantSnapshotGroup(operation)); +} + +StatusOr +InstantSnapshotGroupsTracingConnection::GetInstantSnapshotGroup( + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + GetInstantSnapshotGroupRequest const& request) { + auto span = internal::MakeSpan( + "compute_instant_snapshot_groups_v1::InstantSnapshotGroupsConnection::" + "GetInstantSnapshotGroup"); + auto scope = opentelemetry::trace::Scope(span); + return internal::EndSpan(*span, child_->GetInstantSnapshotGroup(request)); +} + +StatusOr +InstantSnapshotGroupsTracingConnection::GetIamPolicy( + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + GetIamPolicyRequest const& request) { + auto span = internal::MakeSpan( + "compute_instant_snapshot_groups_v1::InstantSnapshotGroupsConnection::" + "GetIamPolicy"); + auto scope = opentelemetry::trace::Scope(span); + return internal::EndSpan(*span, child_->GetIamPolicy(request)); +} + +future> +InstantSnapshotGroupsTracingConnection::InsertInstantSnapshotGroup( + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest const& request) { + auto span = internal::MakeSpan( + "compute_instant_snapshot_groups_v1::InstantSnapshotGroupsConnection::" + "InsertInstantSnapshotGroup"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), + child_->InsertInstantSnapshotGroup(request)); +} + +StatusOr +InstantSnapshotGroupsTracingConnection::InsertInstantSnapshotGroup( + NoAwaitTag, google::cloud::cpp::compute::instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest const& request) { + auto span = internal::MakeSpan( + "compute_instant_snapshot_groups_v1::InstantSnapshotGroupsConnection::" + "InsertInstantSnapshotGroup"); + opentelemetry::trace::Scope scope(span); + return internal::EndSpan( + *span, child_->InsertInstantSnapshotGroup(NoAwaitTag{}, request)); +} + +future> +InstantSnapshotGroupsTracingConnection::InsertInstantSnapshotGroup( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto span = internal::MakeSpan( + "compute_instant_snapshot_groups_v1::InstantSnapshotGroupsConnection::" + "InsertInstantSnapshotGroup"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), + child_->InsertInstantSnapshotGroup(operation)); +} + +StreamRange +InstantSnapshotGroupsTracingConnection::ListInstantSnapshotGroups( + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + ListInstantSnapshotGroupsRequest request) { + auto span = internal::MakeSpan( + "compute_instant_snapshot_groups_v1::InstantSnapshotGroupsConnection::" + "ListInstantSnapshotGroups"); + internal::OTelScope scope(span); + auto sr = child_->ListInstantSnapshotGroups(std::move(request)); + return internal::MakeTracedStreamRange< + google::cloud::cpp::compute::v1::InstantSnapshotGroup>(std::move(span), + std::move(sr)); +} + +StatusOr +InstantSnapshotGroupsTracingConnection::SetIamPolicy( + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + SetIamPolicyRequest const& request) { + auto span = internal::MakeSpan( + "compute_instant_snapshot_groups_v1::InstantSnapshotGroupsConnection::" + "SetIamPolicy"); + auto scope = opentelemetry::trace::Scope(span); + return internal::EndSpan(*span, child_->SetIamPolicy(request)); +} + +StatusOr +InstantSnapshotGroupsTracingConnection::TestIamPermissions( + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + TestIamPermissionsRequest const& request) { + auto span = internal::MakeSpan( + "compute_instant_snapshot_groups_v1::InstantSnapshotGroupsConnection::" + "TestIamPermissions"); + auto scope = opentelemetry::trace::Scope(span); + return internal::EndSpan(*span, child_->TestIamPermissions(request)); +} + +std::shared_ptr< + compute_instant_snapshot_groups_v1::InstantSnapshotGroupsConnection> +MakeInstantSnapshotGroupsTracingConnection( + std::shared_ptr< + compute_instant_snapshot_groups_v1::InstantSnapshotGroupsConnection> + conn) { + if (internal::TracingEnabled(conn->options())) { + conn = std::make_shared( + std::move(conn)); + } + return conn; +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_instant_snapshot_groups_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_tracing_connection.h b/google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_tracing_connection.h new file mode 100644 index 0000000000000..680d136b35015 --- /dev/null +++ b/google/cloud/compute/instant_snapshot_groups/v1/internal/instant_snapshot_groups_tracing_connection.h @@ -0,0 +1,121 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_INSTANT_SNAPSHOT_GROUPS_V1_INTERNAL_INSTANT_SNAPSHOT_GROUPS_TRACING_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_INSTANT_SNAPSHOT_GROUPS_V1_INTERNAL_INSTANT_SNAPSHOT_GROUPS_TRACING_CONNECTION_H + +#include "google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups_connection.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_instant_snapshot_groups_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class InstantSnapshotGroupsTracingConnection + : public compute_instant_snapshot_groups_v1:: + InstantSnapshotGroupsConnection { + public: + ~InstantSnapshotGroupsTracingConnection() override = default; + + explicit InstantSnapshotGroupsTracingConnection( + std::shared_ptr< + compute_instant_snapshot_groups_v1::InstantSnapshotGroupsConnection> + child); + + Options options() override { return child_->options(); } + + future> + DeleteInstantSnapshotGroup( + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest const& request) override; + + StatusOr + DeleteInstantSnapshotGroup( + NoAwaitTag, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest const& request) override; + + future> + DeleteInstantSnapshotGroup( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + StatusOr + GetInstantSnapshotGroup( + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + GetInstantSnapshotGroupRequest const& request) override; + + StatusOr GetIamPolicy( + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + GetIamPolicyRequest const& request) override; + + future> + InsertInstantSnapshotGroup( + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest const& request) override; + + StatusOr + InsertInstantSnapshotGroup( + NoAwaitTag, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest const& request) override; + + future> + InsertInstantSnapshotGroup( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + StreamRange + ListInstantSnapshotGroups( + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + ListInstantSnapshotGroupsRequest request) override; + + StatusOr SetIamPolicy( + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + SetIamPolicyRequest const& request) override; + + StatusOr + TestIamPermissions(google::cloud::cpp::compute::instant_snapshot_groups::v1:: + TestIamPermissionsRequest const& request) override; + + private: + std::shared_ptr< + compute_instant_snapshot_groups_v1::InstantSnapshotGroupsConnection> + child_; +}; + +/** + * Conditionally applies the tracing decorator to the given connection. + * + * The connection is only decorated if tracing is enabled (as determined by the + * connection's options). + */ +std::shared_ptr< + compute_instant_snapshot_groups_v1::InstantSnapshotGroupsConnection> +MakeInstantSnapshotGroupsTracingConnection( + std::shared_ptr< + compute_instant_snapshot_groups_v1::InstantSnapshotGroupsConnection> + conn); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_instant_snapshot_groups_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_INSTANT_SNAPSHOT_GROUPS_V1_INTERNAL_INSTANT_SNAPSHOT_GROUPS_TRACING_CONNECTION_H diff --git a/google/cloud/compute/instant_snapshot_groups/v1/mocks/mock_instant_snapshot_groups_connection.h b/google/cloud/compute/instant_snapshot_groups/v1/mocks/mock_instant_snapshot_groups_connection.h new file mode 100644 index 0000000000000..09b53bc88c29f --- /dev/null +++ b/google/cloud/compute/instant_snapshot_groups/v1/mocks/mock_instant_snapshot_groups_connection.h @@ -0,0 +1,172 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_INSTANT_SNAPSHOT_GROUPS_V1_MOCKS_MOCK_INSTANT_SNAPSHOT_GROUPS_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_INSTANT_SNAPSHOT_GROUPS_V1_MOCKS_MOCK_INSTANT_SNAPSHOT_GROUPS_CONNECTION_H + +#include "google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups_connection.h" +#include + +namespace google { +namespace cloud { +namespace compute_instant_snapshot_groups_v1_mocks { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/** + * A class to mock `InstantSnapshotGroupsConnection`. + * + * Application developers may want to test their code with simulated responses, + * including errors, from an object of type `InstantSnapshotGroupsClient`. To do + * so, construct an object of type `InstantSnapshotGroupsClient` with an + * instance of this class. Then use the Google Test framework functions to + * program the behavior of this mock. + * + * @see [This example][bq-mock] for how to test your application with GoogleTest. + * While the example showcases types from the BigQuery library, the underlying + * principles apply for any pair of `*Client` and `*Connection`. + * + * [bq-mock]: @cloud_cpp_docs_link{bigquery,bigquery-read-mock} + */ +class MockInstantSnapshotGroupsConnection + : public compute_instant_snapshot_groups_v1:: + InstantSnapshotGroupsConnection { + public: + MOCK_METHOD(Options, options, (), (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// DeleteInstantSnapshotGroup(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + DeleteInstantSnapshotGroup, + (google::cloud::cpp::compute::instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// EXPECT_CALL(*mock, DeleteInstantSnapshotGroup(_, _)) + /// @endcode + MOCK_METHOD(StatusOr, + DeleteInstantSnapshotGroup, + (NoAwaitTag, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// DeleteInstantSnapshotGroup(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + DeleteInstantSnapshotGroup, + (google::cloud::cpp::compute::v1::Operation const& operation), + (override)); + + MOCK_METHOD(StatusOr, + GetInstantSnapshotGroup, + (google::cloud::cpp::compute::instant_snapshot_groups::v1:: + GetInstantSnapshotGroupRequest const& request), + (override)); + + MOCK_METHOD(StatusOr, GetIamPolicy, + (google::cloud::cpp::compute::instant_snapshot_groups::v1:: + GetIamPolicyRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// InsertInstantSnapshotGroup(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + InsertInstantSnapshotGroup, + (google::cloud::cpp::compute::instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// EXPECT_CALL(*mock, InsertInstantSnapshotGroup(_, _)) + /// @endcode + MOCK_METHOD(StatusOr, + InsertInstantSnapshotGroup, + (NoAwaitTag, + google::cloud::cpp::compute::instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// InsertInstantSnapshotGroup(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + InsertInstantSnapshotGroup, + (google::cloud::cpp::compute::v1::Operation const& operation), + (override)); + + MOCK_METHOD( + (StreamRange), + ListInstantSnapshotGroups, + (google::cloud::cpp::compute::instant_snapshot_groups::v1:: + ListInstantSnapshotGroupsRequest request), + (override)); + + MOCK_METHOD(StatusOr, SetIamPolicy, + (google::cloud::cpp::compute::instant_snapshot_groups::v1:: + SetIamPolicyRequest const& request), + (override)); + + MOCK_METHOD( + StatusOr, + TestIamPermissions, + (google::cloud::cpp::compute::instant_snapshot_groups::v1:: + TestIamPermissionsRequest const& request), + (override)); +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_instant_snapshot_groups_v1_mocks +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_INSTANT_SNAPSHOT_GROUPS_V1_MOCKS_MOCK_INSTANT_SNAPSHOT_GROUPS_CONNECTION_H diff --git a/google/cloud/compute/instant_snapshot_groups/v1/samples/instant_snapshot_groups_client_samples.cc b/google/cloud/compute/instant_snapshot_groups/v1/samples/instant_snapshot_groups_client_samples.cc new file mode 100644 index 0000000000000..a5ae738b5119a --- /dev/null +++ b/google/cloud/compute/instant_snapshot_groups/v1/samples/instant_snapshot_groups_client_samples.cc @@ -0,0 +1,244 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups.proto + +#include "google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups_client.h" +#include "google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups_connection_idempotency_policy.h" +#include "google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups_options.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/internal/getenv.h" +#include "google/cloud/polling_policy.h" +#include "google/cloud/testing_util/example_driver.h" +#include "google/cloud/universe_domain.h" +#include +#include +#include +#include + +// clang-format off +// main-dox-marker: compute_instant_snapshot_groups_v1::InstantSnapshotGroupsClient +// lro-marker: true +// clang-format on +namespace { + +void SetClientEndpoint(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-endpoint"}; + } + //! [set-client-endpoint] + // This configuration is common with Private Google Access: + // https://cloud.google.com/vpc/docs/private-google-access + auto options = google::cloud::Options{}.set( + "private.googleapis.com"); + auto vpc_client = google::cloud::compute_instant_snapshot_groups_v1:: + InstantSnapshotGroupsClient( + google::cloud::compute_instant_snapshot_groups_v1:: + MakeInstantSnapshotGroupsConnectionRest(options)); + //! [set-client-endpoint] +} + +void SetClientUniverseDomain(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-universe-domain"}; + } + //! [set-client-universe-domain] + google::cloud::Options options; + + // AddUniverseDomainOption interrogates the UnifiedCredentialsOption, if set, + // in the provided Options for the Universe Domain associated with the + // credentials and adds it to the set of Options. + // If no UnifiedCredentialsOption is set, GoogleDefaultCredentials are used. + auto ud_options = google::cloud::AddUniverseDomainOption(std::move(options)); + + if (!ud_options.ok()) throw std::move(ud_options).status(); + auto ud_client = google::cloud::compute_instant_snapshot_groups_v1:: + InstantSnapshotGroupsClient( + google::cloud::compute_instant_snapshot_groups_v1:: + MakeInstantSnapshotGroupsConnectionRest(*ud_options)); + //! [set-client-universe-domain] +} + +//! [custom-idempotency-policy] +class CustomIdempotencyPolicy + : public google::cloud::compute_instant_snapshot_groups_v1:: + InstantSnapshotGroupsConnectionIdempotencyPolicy { + public: + ~CustomIdempotencyPolicy() override = default; + std::unique_ptr + clone() const override { + return std::make_unique(*this); + } + // Override inherited functions to define as needed. +}; +//! [custom-idempotency-policy] + +void SetRetryPolicy(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-retry-policy"}; + } + //! [set-retry-policy] + auto options = + google::cloud::Options{} + .set( + CustomIdempotencyPolicy().clone()) + .set( + google::cloud::compute_instant_snapshot_groups_v1:: + InstantSnapshotGroupsLimitedErrorCountRetryPolicy(3) + .clone()) + .set( + google::cloud::ExponentialBackoffPolicy( + /*initial_delay=*/std::chrono::milliseconds(200), + /*maximum_delay=*/std::chrono::seconds(45), + /*scaling=*/2.0) + .clone()); + auto connection = google::cloud::compute_instant_snapshot_groups_v1:: + MakeInstantSnapshotGroupsConnectionRest(options); + + // c1 and c2 share the same retry policies + auto c1 = google::cloud::compute_instant_snapshot_groups_v1:: + InstantSnapshotGroupsClient(connection); + auto c2 = google::cloud::compute_instant_snapshot_groups_v1:: + InstantSnapshotGroupsClient(connection); + + // You can override any of the policies in a new client. This new client + // will share the policies from c1 (or c2) *except* for the retry policy. + auto c3 = google::cloud::compute_instant_snapshot_groups_v1:: + InstantSnapshotGroupsClient( + connection, + google::cloud::Options{} + .set( + google::cloud::compute_instant_snapshot_groups_v1:: + InstantSnapshotGroupsLimitedTimeRetryPolicy( + std::chrono::minutes(5)) + .clone())); + + // You can also override the policies in a single call: + // c3.SomeRpc(..., google::cloud::Options{} + // .set( + // google::cloud::compute_instant_snapshot_groups_v1::InstantSnapshotGroupsLimitedErrorCountRetryPolicy(10).clone())); + //! [set-retry-policy] +} + +void SetPollingPolicy(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-policy-policy"}; + } + //! [set-polling-policy] + + // The polling policy controls how the client waits for long-running + // operations. `GenericPollingPolicy<>` combines existing policies. + // In this case, keep polling until the operation completes (with success + // or error) or 45 minutes, whichever happens first. Initially pause for + // 10 seconds between polling requests, increasing the pause by a factor + // of 4 until it becomes 2 minutes. + auto options = + google::cloud::Options{} + .set( + google::cloud::GenericPollingPolicy< + google::cloud::compute_instant_snapshot_groups_v1:: + InstantSnapshotGroupsRetryPolicyOption::Type, + google::cloud::compute_instant_snapshot_groups_v1:: + InstantSnapshotGroupsBackoffPolicyOption::Type>( + google::cloud::compute_instant_snapshot_groups_v1:: + InstantSnapshotGroupsLimitedTimeRetryPolicy( + /*maximum_duration=*/std::chrono::minutes(45)) + .clone(), + google::cloud::ExponentialBackoffPolicy( + /*initial_delay=*/std::chrono::seconds(10), + /*maximum_delay=*/std::chrono::minutes(2), + /*scaling=*/4.0) + .clone()) + .clone()); + + auto connection = google::cloud::compute_instant_snapshot_groups_v1:: + MakeInstantSnapshotGroupsConnectionRest(options); + + // c1 and c2 share the same polling policies. + auto c1 = google::cloud::compute_instant_snapshot_groups_v1:: + InstantSnapshotGroupsClient(connection); + auto c2 = google::cloud::compute_instant_snapshot_groups_v1:: + InstantSnapshotGroupsClient(connection); + //! [set-polling-policy] +} + +void WithServiceAccount(std::vector const& argv) { + if (argv.size() != 1 || argv[0] == "--help") { + throw google::cloud::testing_util::Usage{"with-service-account "}; + } + //! [with-service-account] + [](std::string const& keyfile) { + auto is = std::ifstream(keyfile); + is.exceptions(std::ios::badbit); // Minimal error handling in examples + auto contents = std::string(std::istreambuf_iterator(is.rdbuf()), {}); + auto options = + google::cloud::Options{}.set( + google::cloud::MakeServiceAccountCredentials(contents)); + return google::cloud::compute_instant_snapshot_groups_v1:: + InstantSnapshotGroupsClient( + google::cloud::compute_instant_snapshot_groups_v1:: + MakeInstantSnapshotGroupsConnectionRest(options)); + } + //! [with-service-account] + (argv.at(0)); +} + +void AutoRun(std::vector const& argv) { + namespace examples = ::google::cloud::testing_util; + using ::google::cloud::internal::GetEnv; + if (!argv.empty()) throw examples::Usage{"auto"}; + examples::CheckEnvironmentVariablesAreSet( + {"GOOGLE_CLOUD_CPP_TEST_SERVICE_ACCOUNT_KEYFILE"}); + auto const keyfile = + GetEnv("GOOGLE_CLOUD_CPP_TEST_SERVICE_ACCOUNT_KEYFILE").value(); + + std::cout << "\nRunning SetClientEndpoint() example" << std::endl; + SetClientEndpoint({}); + + std::cout << "\nRunning SetRetryPolicy() example" << std::endl; + SetRetryPolicy({}); + + std::cout << "\nRunning SetPollingPolicy() example" << std::endl; + SetPollingPolicy({}); + + std::cout << "\nRunning WithServiceAccount() example" << std::endl; + WithServiceAccount({keyfile}); + + std::cout << "\nRunning SetClientUniverseDomain() example" << std::endl; + SetClientUniverseDomain({}); +} + +} // namespace + +int main(int argc, char* argv[]) { // NOLINT(bugprone-exception-escape) + google::cloud::testing_util::Example example({ + {"set-client-endpoint", SetClientEndpoint}, + {"set-retry-policy", SetRetryPolicy}, + {"set-polling-policy", SetPollingPolicy}, + {"with-service-account", WithServiceAccount}, + {"set-client-universe-domain", SetClientUniverseDomain}, + {"auto", AutoRun}, + }); + return example.Run(argc, argv); +} 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 d47a7e1a27ab9..6d8891e8b7979 100644 --- a/google/cloud/compute/instant_snapshots/v1/instant_snapshots_client.h +++ b/google/cloud/compute/instant_snapshots/v1/instant_snapshots_client.h @@ -91,9 +91,10 @@ class InstantSnapshotsClient { // clang-format off /// - /// Retrieves an aggregated list of instantSnapshots. To prevent failure, - /// Google recommends that you set the `returnPartialSuccess` parameter to - /// `true`. + /// Retrieves an aggregated list of instantSnapshots. + /// + /// To prevent failure, Google recommends that you set the + /// `returnPartialSuccess` parameter to `true`. /// https://cloud.google.com/compute/docs/reference/rest/v1/instantSnapshots/aggregatedList /// /// @param project Project ID for this request. @@ -119,8 +120,8 @@ class InstantSnapshotsClient { /// [`future`]: @ref google::cloud::future /// [`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#L138} + /// [google.cloud.cpp.compute.instant_snapshots.v1.AggregatedListInstantSnapshotsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instant_snapshots/v1/instant_snapshots.proto#L163} + /// [google.cloud.cpp.compute.v1.InstantSnapshotsScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_082.proto#L159} /// // clang-format on StreamRange> @@ -234,8 +238,10 @@ class InstantSnapshotsClient { /// 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. + /// to the next corresponding instantSnapshot. + /// + /// For more information, seeDeleting + /// instantSnapshots. /// https://cloud.google.com/compute/docs/reference/rest/v1/instantSnapshots/delete /// /// @param request Unary RPCs, such as the one wrapped by this @@ -264,7 +270,7 @@ class InstantSnapshotsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instant_snapshots.v1.DeleteInstantSnapshotRequest]: @cloud_cpp_reference_link{google/cloud/compute/instant_snapshots/v1/instant_snapshots.proto#L241} + /// [google.cloud.cpp.compute.instant_snapshots.v1.DeleteInstantSnapshotRequest]: @cloud_cpp_reference_link{google/cloud/compute/instant_snapshots/v1/instant_snapshots.proto#L278} /// // clang-format on future> @@ -324,8 +330,8 @@ class InstantSnapshotsClient { /// [`future`]: @ref google::cloud::future /// [`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.instant_snapshots.v1.GetInstantSnapshotRequest]: @cloud_cpp_reference_link{google/cloud/compute/instant_snapshots/v1/instant_snapshots.proto#L332} + /// [google.cloud.cpp.compute.v1.InstantSnapshot]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_081.proto#L27} /// // clang-format on StatusOr GetInstantSnapshot( @@ -356,8 +362,8 @@ class InstantSnapshotsClient { /// [`future`]: @ref google::cloud::future /// [`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.instant_snapshots.v1.GetInstantSnapshotRequest]: @cloud_cpp_reference_link{google/cloud/compute/instant_snapshots/v1/instant_snapshots.proto#L332} + /// [google.cloud.cpp.compute.v1.InstantSnapshot]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_081.proto#L27} /// // clang-format on StatusOr GetInstantSnapshot( @@ -387,8 +393,8 @@ class InstantSnapshotsClient { /// [`future`]: @ref google::cloud::future /// [`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_007.proto#L178} + /// [google.cloud.cpp.compute.instant_snapshots.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/instant_snapshots/v1/instant_snapshots.proto#L314} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr GetIamPolicy( @@ -420,8 +426,8 @@ class InstantSnapshotsClient { /// [`future`]: @ref google::cloud::future /// [`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_007.proto#L178} + /// [google.cloud.cpp.compute.instant_snapshots.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/instant_snapshots/v1/instant_snapshots.proto#L314} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr GetIamPolicy( @@ -457,7 +463,7 @@ class InstantSnapshotsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instant_snapshots.v1.InsertInstantSnapshotRequest]: @cloud_cpp_reference_link{google/cloud/compute/instant_snapshots/v1/instant_snapshots.proto#L306} + /// [google.cloud.cpp.compute.instant_snapshots.v1.InsertInstantSnapshotRequest]: @cloud_cpp_reference_link{google/cloud/compute/instant_snapshots/v1/instant_snapshots.proto#L346} /// // clang-format on future> @@ -514,7 +520,7 @@ class InstantSnapshotsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instant_snapshots.v1.InsertInstantSnapshotRequest]: @cloud_cpp_reference_link{google/cloud/compute/instant_snapshots/v1/instant_snapshots.proto#L306} + /// [google.cloud.cpp.compute.instant_snapshots.v1.InsertInstantSnapshotRequest]: @cloud_cpp_reference_link{google/cloud/compute/instant_snapshots/v1/instant_snapshots.proto#L346} /// // clang-format on future> @@ -555,8 +561,8 @@ class InstantSnapshotsClient { // clang-format off /// - /// Retrieves the list of InstantSnapshot resources contained within the - /// specified zone. + /// Retrieves the list of InstantSnapshot resources contained within + /// the specified zone. /// https://cloud.google.com/compute/docs/reference/rest/v1/instantSnapshots/list /// /// @param project Project ID for this request. @@ -583,8 +589,8 @@ class InstantSnapshotsClient { /// [`future`]: @ref google::cloud::future /// [`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.instant_snapshots.v1.ListInstantSnapshotsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instant_snapshots/v1/instant_snapshots.proto#L382} + /// [google.cloud.cpp.compute.v1.InstantSnapshot]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_081.proto#L27} /// // clang-format on StreamRange @@ -593,8 +599,8 @@ class InstantSnapshotsClient { // clang-format off /// - /// Retrieves the list of InstantSnapshot resources contained within the - /// specified zone. + /// Retrieves the list of InstantSnapshot resources contained within + /// the specified zone. /// https://cloud.google.com/compute/docs/reference/rest/v1/instantSnapshots/list /// /// @param request Unary RPCs, such as the one wrapped by this @@ -625,8 +631,8 @@ class InstantSnapshotsClient { /// [`future`]: @ref google::cloud::future /// [`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.instant_snapshots.v1.ListInstantSnapshotsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instant_snapshots/v1/instant_snapshots.proto#L382} + /// [google.cloud.cpp.compute.v1.InstantSnapshot]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_081.proto#L27} /// // clang-format on StreamRange @@ -636,8 +642,8 @@ class InstantSnapshotsClient { // clang-format off /// - /// Sets the access control policy on the specified resource. Replaces any - /// existing policy. + /// Sets the access control policy on the specified resource. + /// Replaces any existing policy. /// https://cloud.google.com/compute/docs/reference/rest/v1/instantSnapshots/setIamPolicy /// /// @param project Project ID for this request. @@ -657,8 +663,8 @@ class InstantSnapshotsClient { /// [`future`]: @ref google::cloud::future /// [`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_007.proto#L178} + /// [google.cloud.cpp.compute.instant_snapshots.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/instant_snapshots/v1/instant_snapshots.proto#L486} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr SetIamPolicy( @@ -670,8 +676,8 @@ class InstantSnapshotsClient { // clang-format off /// - /// Sets the access control policy on the specified resource. Replaces any - /// existing policy. + /// Sets the access control policy on the specified resource. + /// Replaces any existing policy. /// https://cloud.google.com/compute/docs/reference/rest/v1/instantSnapshots/setIamPolicy /// /// @param request Unary RPCs, such as the one wrapped by this @@ -693,8 +699,8 @@ class InstantSnapshotsClient { /// [`future`]: @ref google::cloud::future /// [`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_007.proto#L178} + /// [google.cloud.cpp.compute.instant_snapshots.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/instant_snapshots/v1/instant_snapshots.proto#L486} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr SetIamPolicy( @@ -705,7 +711,8 @@ class InstantSnapshotsClient { // clang-format off /// /// Sets the labels on a instantSnapshot in the given zone. To learn more about - /// labels, read the Labeling Resources documentation. + /// labels, read the Labeling + /// Resources documentation. /// https://cloud.google.com/compute/docs/reference/rest/v1/instantSnapshots/setLabels /// /// @param project Project ID for this request. @@ -732,7 +739,7 @@ class InstantSnapshotsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instant_snapshots.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instant_snapshots/v1/instant_snapshots.proto#L428} + /// [google.cloud.cpp.compute.instant_snapshots.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instant_snapshots/v1/instant_snapshots.proto#L504} /// // clang-format on future> SetLabels( @@ -763,7 +770,8 @@ class InstantSnapshotsClient { // clang-format off /// /// Sets the labels on a instantSnapshot in the given zone. To learn more about - /// labels, read the Labeling Resources documentation. + /// labels, read the Labeling + /// Resources documentation. /// https://cloud.google.com/compute/docs/reference/rest/v1/instantSnapshots/setLabels /// /// @param request Unary RPCs, such as the one wrapped by this @@ -792,7 +800,7 @@ class InstantSnapshotsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.instant_snapshots.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instant_snapshots/v1/instant_snapshots.proto#L428} + /// [google.cloud.cpp.compute.instant_snapshots.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instant_snapshots/v1/instant_snapshots.proto#L504} /// // clang-format on future> SetLabels( @@ -852,8 +860,8 @@ class InstantSnapshotsClient { /// [`future`]: @ref google::cloud::future /// [`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_145.proto#L30} + /// [google.cloud.cpp.compute.instant_snapshots.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instant_snapshots/v1/instant_snapshots.proto#L544} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} /// // clang-format on StatusOr @@ -888,8 +896,8 @@ class InstantSnapshotsClient { /// [`future`]: @ref google::cloud::future /// [`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_145.proto#L30} + /// [google.cloud.cpp.compute.instant_snapshots.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instant_snapshots/v1/instant_snapshots.proto#L544} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.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 2df65dca61d48..c6c947b58dcd3 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 "google/cloud/compute/v1/internal/common_007.pb.h" -#include "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_031.pb.h" -#include "google/cloud/compute/v1/internal/common_066.pb.h" -#include "google/cloud/compute/v1/internal/common_067.pb.h" -#include "google/cloud/compute/v1/internal/common_145.pb.h" -#include "google/cloud/compute/v1/internal/common_151.pb.h" -#include "google/cloud/compute/v1/internal/common_152.pb.h" +#include "google/cloud/compute/v1/internal/common_009.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_040.pb.h" +#include "google/cloud/compute/v1/internal/common_081.pb.h" +#include "google/cloud/compute/v1/internal/common_082.pb.h" +#include "google/cloud/compute/v1/internal/common_171.pb.h" +#include "google/cloud/compute/v1/internal/common_180.pb.h" +#include "google/cloud/compute/v1/internal/common_182.pb.h" // 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_attachment_groups/v1/interconnect_attachment_groups_client.h b/google/cloud/compute/interconnect_attachment_groups/v1/interconnect_attachment_groups_client.h index 16d44c42c734c..cc2f66dff4c90 100644 --- a/google/cloud/compute/interconnect_attachment_groups/v1/interconnect_attachment_groups_client.h +++ b/google/cloud/compute/interconnect_attachment_groups/v1/interconnect_attachment_groups_client.h @@ -121,7 +121,7 @@ class InterconnectAttachmentGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.interconnect_attachment_groups.v1.DeleteInterconnectAttachmentGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_attachment_groups/v1/interconnect_attachment_groups.proto#L160} + /// [google.cloud.cpp.compute.interconnect_attachment_groups.v1.DeleteInterconnectAttachmentGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_attachment_groups/v1/interconnect_attachment_groups.proto#L161} /// // clang-format on future> @@ -176,7 +176,7 @@ class InterconnectAttachmentGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.interconnect_attachment_groups.v1.DeleteInterconnectAttachmentGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_attachment_groups/v1/interconnect_attachment_groups.proto#L160} + /// [google.cloud.cpp.compute.interconnect_attachment_groups.v1.DeleteInterconnectAttachmentGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_attachment_groups/v1/interconnect_attachment_groups.proto#L161} /// // clang-format on future> @@ -238,8 +238,8 @@ class InterconnectAttachmentGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.interconnect_attachment_groups.v1.GetInterconnectAttachmentGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_attachment_groups/v1/interconnect_attachment_groups.proto#L204} - /// [google.cloud.cpp.compute.v1.InterconnectAttachmentGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_071.proto#L26} + /// [google.cloud.cpp.compute.interconnect_attachment_groups.v1.GetInterconnectAttachmentGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_attachment_groups/v1/interconnect_attachment_groups.proto#L208} + /// [google.cloud.cpp.compute.v1.InterconnectAttachmentGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_087.proto#L26} /// // clang-format on StatusOr @@ -272,8 +272,8 @@ class InterconnectAttachmentGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.interconnect_attachment_groups.v1.GetInterconnectAttachmentGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_attachment_groups/v1/interconnect_attachment_groups.proto#L204} - /// [google.cloud.cpp.compute.v1.InterconnectAttachmentGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_071.proto#L26} + /// [google.cloud.cpp.compute.interconnect_attachment_groups.v1.GetInterconnectAttachmentGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_attachment_groups/v1/interconnect_attachment_groups.proto#L208} + /// [google.cloud.cpp.compute.v1.InterconnectAttachmentGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_087.proto#L26} /// // clang-format on StatusOr @@ -303,8 +303,8 @@ class InterconnectAttachmentGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.interconnect_attachment_groups.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_attachment_groups/v1/interconnect_attachment_groups.proto#L189} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} + /// [google.cloud.cpp.compute.interconnect_attachment_groups.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_attachment_groups/v1/interconnect_attachment_groups.proto#L193} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr GetIamPolicy( @@ -336,8 +336,8 @@ class InterconnectAttachmentGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.interconnect_attachment_groups.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_attachment_groups/v1/interconnect_attachment_groups.proto#L189} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} + /// [google.cloud.cpp.compute.interconnect_attachment_groups.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_attachment_groups/v1/interconnect_attachment_groups.proto#L193} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr GetIamPolicy( @@ -366,8 +366,8 @@ class InterconnectAttachmentGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.interconnect_attachment_groups.v1.GetOperationalStatusRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_attachment_groups/v1/interconnect_attachment_groups.proto#L217} - /// [google.cloud.cpp.compute.v1.InterconnectAttachmentGroupsGetOperationalStatusResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_071.proto#L211} + /// [google.cloud.cpp.compute.interconnect_attachment_groups.v1.GetOperationalStatusRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_attachment_groups/v1/interconnect_attachment_groups.proto#L221} + /// [google.cloud.cpp.compute.v1.InterconnectAttachmentGroupsGetOperationalStatusResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_087.proto#L224} /// // clang-format on StatusOr> @@ -500,7 +500,7 @@ class InterconnectAttachmentGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.interconnect_attachment_groups.v1.InsertInterconnectAttachmentGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_attachment_groups/v1/interconnect_attachment_groups.proto#L230} + /// [google.cloud.cpp.compute.interconnect_attachment_groups.v1.InsertInterconnectAttachmentGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_attachment_groups/v1/interconnect_attachment_groups.proto#L234} /// // clang-format on future> @@ -569,8 +569,8 @@ class InterconnectAttachmentGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.interconnect_attachment_groups.v1.ListInterconnectAttachmentGroupsRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_attachment_groups/v1/interconnect_attachment_groups.proto#L258} - /// [google.cloud.cpp.compute.v1.InterconnectAttachmentGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_071.proto#L26} + /// [google.cloud.cpp.compute.interconnect_attachment_groups.v1.ListInterconnectAttachmentGroupsRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_attachment_groups/v1/interconnect_attachment_groups.proto#L265} + /// [google.cloud.cpp.compute.v1.InterconnectAttachmentGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_087.proto#L26} /// // clang-format on StreamRange @@ -610,8 +610,8 @@ class InterconnectAttachmentGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.interconnect_attachment_groups.v1.ListInterconnectAttachmentGroupsRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_attachment_groups/v1/interconnect_attachment_groups.proto#L258} - /// [google.cloud.cpp.compute.v1.InterconnectAttachmentGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_071.proto#L26} + /// [google.cloud.cpp.compute.interconnect_attachment_groups.v1.ListInterconnectAttachmentGroupsRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_attachment_groups/v1/interconnect_attachment_groups.proto#L265} + /// [google.cloud.cpp.compute.v1.InterconnectAttachmentGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_087.proto#L26} /// // clang-format on StreamRange @@ -623,8 +623,9 @@ class InterconnectAttachmentGroupsClient { // clang-format off /// /// Patches the specified InterconnectAttachmentGroup resource with the data - /// included in the request. This method supports PATCH semantics and uses JSON - /// merge patch format and processing rules. + /// included in the request. This method supports PATCH + /// semantics and usesJSON merge + /// patch format and processing rules. /// https://cloud.google.com/compute/docs/reference/rest/v1/interconnectAttachmentGroups/patch /// /// @param project Project ID for this request. @@ -651,7 +652,7 @@ class InterconnectAttachmentGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.interconnect_attachment_groups.v1.PatchInterconnectAttachmentGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_attachment_groups/v1/interconnect_attachment_groups.proto#L326} + /// [google.cloud.cpp.compute.interconnect_attachment_groups.v1.PatchInterconnectAttachmentGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_attachment_groups/v1/interconnect_attachment_groups.proto#L366} /// // clang-format on future> @@ -686,8 +687,9 @@ class InterconnectAttachmentGroupsClient { // clang-format off /// /// Patches the specified InterconnectAttachmentGroup resource with the data - /// included in the request. This method supports PATCH semantics and uses JSON - /// merge patch format and processing rules. + /// included in the request. This method supports PATCH + /// semantics and usesJSON merge + /// patch format and processing rules. /// https://cloud.google.com/compute/docs/reference/rest/v1/interconnectAttachmentGroups/patch /// /// @param request Unary RPCs, such as the one wrapped by this @@ -716,7 +718,7 @@ class InterconnectAttachmentGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.interconnect_attachment_groups.v1.PatchInterconnectAttachmentGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_attachment_groups/v1/interconnect_attachment_groups.proto#L326} + /// [google.cloud.cpp.compute.interconnect_attachment_groups.v1.PatchInterconnectAttachmentGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_attachment_groups/v1/interconnect_attachment_groups.proto#L366} /// // clang-format on future> @@ -759,8 +761,8 @@ class InterconnectAttachmentGroupsClient { // clang-format off /// - /// Sets the access control policy on the specified resource. Replaces any - /// existing policy. + /// Sets the access control policy on the specified resource. + /// Replaces any existing policy. /// https://cloud.google.com/compute/docs/reference/rest/v1/interconnectAttachmentGroups/setIamPolicy /// /// @param project Project ID for this request. @@ -779,8 +781,8 @@ class InterconnectAttachmentGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.interconnect_attachment_groups.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_attachment_groups/v1/interconnect_attachment_groups.proto#L363} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} + /// [google.cloud.cpp.compute.interconnect_attachment_groups.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_attachment_groups/v1/interconnect_attachment_groups.proto#L406} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr SetIamPolicy( @@ -791,8 +793,8 @@ class InterconnectAttachmentGroupsClient { // clang-format off /// - /// Sets the access control policy on the specified resource. Replaces any - /// existing policy. + /// Sets the access control policy on the specified resource. + /// Replaces any existing policy. /// https://cloud.google.com/compute/docs/reference/rest/v1/interconnectAttachmentGroups/setIamPolicy /// /// @param request Unary RPCs, such as the one wrapped by this @@ -814,8 +816,8 @@ class InterconnectAttachmentGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.interconnect_attachment_groups.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_attachment_groups/v1/interconnect_attachment_groups.proto#L363} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} + /// [google.cloud.cpp.compute.interconnect_attachment_groups.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_attachment_groups/v1/interconnect_attachment_groups.proto#L406} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr SetIamPolicy( @@ -844,8 +846,8 @@ class InterconnectAttachmentGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.interconnect_attachment_groups.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_attachment_groups/v1/interconnect_attachment_groups.proto#L379} - /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_145.proto#L30} + /// [google.cloud.cpp.compute.interconnect_attachment_groups.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_attachment_groups/v1/interconnect_attachment_groups.proto#L422} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} /// // clang-format on StatusOr @@ -879,8 +881,8 @@ class InterconnectAttachmentGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.interconnect_attachment_groups.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_attachment_groups/v1/interconnect_attachment_groups.proto#L379} - /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_145.proto#L30} + /// [google.cloud.cpp.compute.interconnect_attachment_groups.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_attachment_groups/v1/interconnect_attachment_groups.proto#L422} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} /// // clang-format on StatusOr diff --git a/google/cloud/compute/interconnect_attachment_groups/v1/interconnect_attachment_groups_proto_export.h b/google/cloud/compute/interconnect_attachment_groups/v1/interconnect_attachment_groups_proto_export.h index ec6516a3afcc3..1b148e464c87b 100644 --- a/google/cloud/compute/interconnect_attachment_groups/v1/interconnect_attachment_groups_proto_export.h +++ b/google/cloud/compute/interconnect_attachment_groups/v1/interconnect_attachment_groups_proto_export.h @@ -26,12 +26,12 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_INTERCONNECT_ATTACHMENT_GROUPS_V1_INTERCONNECT_ATTACHMENT_GROUPS_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include "google/cloud/compute/v1/internal/common_007.pb.h" -#include "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_031.pb.h" -#include "google/cloud/compute/v1/internal/common_047.pb.h" -#include "google/cloud/compute/v1/internal/common_071.pb.h" -#include "google/cloud/compute/v1/internal/common_145.pb.h" +#include "google/cloud/compute/v1/internal/common_009.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_040.pb.h" +#include "google/cloud/compute/v1/internal/common_057.pb.h" +#include "google/cloud/compute/v1/internal/common_087.pb.h" +#include "google/cloud/compute/v1/internal/common_171.pb.h" // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_INTERCONNECT_ATTACHMENT_GROUPS_V1_INTERCONNECT_ATTACHMENT_GROUPS_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 5318db8c25111..380af1448068a 100644 --- a/google/cloud/compute/interconnect_attachments/v1/interconnect_attachments_client.h +++ b/google/cloud/compute/interconnect_attachments/v1/interconnect_attachments_client.h @@ -94,9 +94,10 @@ class InterconnectAttachmentsClient { // clang-format off /// - /// Retrieves an aggregated list of interconnect attachments. To prevent - /// failure, Google recommends that you set the `returnPartialSuccess` - /// parameter to `true`. + /// Retrieves an aggregated list of interconnect attachments. + /// + /// To prevent failure, Google recommends that you set the + /// `returnPartialSuccess` parameter to `true`. /// https://cloud.google.com/compute/docs/reference/rest/v1/interconnectAttachments/aggregatedList /// /// @param project Project ID for this request. @@ -122,8 +123,8 @@ class InterconnectAttachmentsClient { /// [`future`]: @ref google::cloud::future /// [`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#L592} + /// [google.cloud.cpp.compute.interconnect_attachments.v1.AggregatedListInterconnectAttachmentsRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_attachments/v1/interconnect_attachments.proto#L137} + /// [google.cloud.cpp.compute.v1.InterconnectAttachmentsScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_085.proto#L878} /// // clang-format on StreamRange> @@ -262,7 +264,7 @@ class InterconnectAttachmentsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.interconnect_attachments.v1.DeleteInterconnectAttachmentRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_attachments/v1/interconnect_attachments.proto#L216} + /// [google.cloud.cpp.compute.interconnect_attachments.v1.DeleteInterconnectAttachmentRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_attachments/v1/interconnect_attachments.proto#L252} /// // clang-format on future> @@ -324,8 +326,8 @@ class InterconnectAttachmentsClient { /// [`future`]: @ref google::cloud::future /// [`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.interconnect_attachments.v1.GetInterconnectAttachmentRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_attachments/v1/interconnect_attachments.proto#L290} + /// [google.cloud.cpp.compute.v1.InterconnectAttachment]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_085.proto#L32} /// // clang-format on StatusOr @@ -358,8 +360,8 @@ class InterconnectAttachmentsClient { /// [`future`]: @ref google::cloud::future /// [`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.interconnect_attachments.v1.GetInterconnectAttachmentRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_attachments/v1/interconnect_attachments.proto#L290} + /// [google.cloud.cpp.compute.v1.InterconnectAttachment]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_085.proto#L32} /// // clang-format on StatusOr @@ -397,7 +399,7 @@ class InterconnectAttachmentsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.interconnect_attachments.v1.InsertInterconnectAttachmentRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_attachments/v1/interconnect_attachments.proto#L268} + /// [google.cloud.cpp.compute.interconnect_attachments.v1.InsertInterconnectAttachmentRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_attachments/v1/interconnect_attachments.proto#L307} /// // clang-format on future> @@ -457,7 +459,7 @@ class InterconnectAttachmentsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.interconnect_attachments.v1.InsertInterconnectAttachmentRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_attachments/v1/interconnect_attachments.proto#L268} + /// [google.cloud.cpp.compute.interconnect_attachments.v1.InsertInterconnectAttachmentRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_attachments/v1/interconnect_attachments.proto#L307} /// // clang-format on future> @@ -500,8 +502,8 @@ class InterconnectAttachmentsClient { // clang-format off /// - /// Retrieves the list of interconnect attachments contained within the - /// specified region. + /// Retrieves the list of interconnect attachments contained within + /// the specified region. /// https://cloud.google.com/compute/docs/reference/rest/v1/interconnectAttachments/list /// /// @param project Project ID for this request. @@ -528,8 +530,8 @@ class InterconnectAttachmentsClient { /// [`future`]: @ref google::cloud::future /// [`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.interconnect_attachments.v1.ListInterconnectAttachmentsRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_attachments/v1/interconnect_attachments.proto#L346} + /// [google.cloud.cpp.compute.v1.InterconnectAttachment]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_085.proto#L32} /// // clang-format on StreamRange @@ -538,8 +540,8 @@ class InterconnectAttachmentsClient { // clang-format off /// - /// Retrieves the list of interconnect attachments contained within the - /// specified region. + /// Retrieves the list of interconnect attachments contained within + /// the specified region. /// https://cloud.google.com/compute/docs/reference/rest/v1/interconnectAttachments/list /// /// @param request Unary RPCs, such as the one wrapped by this @@ -570,8 +572,8 @@ class InterconnectAttachmentsClient { /// [`future`]: @ref google::cloud::future /// [`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.interconnect_attachments.v1.ListInterconnectAttachmentsRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_attachments/v1/interconnect_attachments.proto#L346} + /// [google.cloud.cpp.compute.v1.InterconnectAttachment]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_085.proto#L32} /// // clang-format on StreamRange @@ -583,8 +585,9 @@ class InterconnectAttachmentsClient { // clang-format off /// /// 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. + /// request. This method supportsPATCH + /// semantics and uses theJSON merge + /// patch format and processing rules. /// https://cloud.google.com/compute/docs/reference/rest/v1/interconnectAttachments/patch /// /// @param project Project ID for this request. @@ -611,7 +614,7 @@ class InterconnectAttachmentsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.interconnect_attachments.v1.PatchInterconnectAttachmentRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_attachments/v1/interconnect_attachments.proto#L376} + /// [google.cloud.cpp.compute.interconnect_attachments.v1.PatchInterconnectAttachmentRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_attachments/v1/interconnect_attachments.proto#L451} /// // clang-format on future> @@ -644,8 +647,9 @@ class InterconnectAttachmentsClient { // clang-format off /// /// 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. + /// request. This method supportsPATCH + /// semantics and uses theJSON merge + /// patch format and processing rules. /// https://cloud.google.com/compute/docs/reference/rest/v1/interconnectAttachments/patch /// /// @param request Unary RPCs, such as the one wrapped by this @@ -674,7 +678,7 @@ class InterconnectAttachmentsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.interconnect_attachments.v1.PatchInterconnectAttachmentRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_attachments/v1/interconnect_attachments.proto#L376} + /// [google.cloud.cpp.compute.interconnect_attachments.v1.PatchInterconnectAttachmentRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_attachments/v1/interconnect_attachments.proto#L451} /// // clang-format on future> @@ -718,7 +722,8 @@ class InterconnectAttachmentsClient { // clang-format off /// /// Sets the labels on an InterconnectAttachment. To learn more about labels, - /// read the Labeling Resources documentation. + /// read the Labeling + /// Resources documentation. /// https://cloud.google.com/compute/docs/reference/rest/v1/interconnectAttachments/setLabels /// /// @param project Project ID for this request. @@ -745,7 +750,7 @@ class InterconnectAttachmentsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.interconnect_attachments.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_attachments/v1/interconnect_attachments.proto#L415} + /// [google.cloud.cpp.compute.interconnect_attachments.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_attachments/v1/interconnect_attachments.proto#L493} /// // clang-format on future> SetLabels( @@ -776,7 +781,8 @@ class InterconnectAttachmentsClient { // clang-format off /// /// Sets the labels on an InterconnectAttachment. To learn more about labels, - /// read the Labeling Resources documentation. + /// read the Labeling + /// Resources documentation. /// https://cloud.google.com/compute/docs/reference/rest/v1/interconnectAttachments/setLabels /// /// @param request Unary RPCs, such as the one wrapped by this @@ -805,7 +811,7 @@ class InterconnectAttachmentsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.interconnect_attachments.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_attachments/v1/interconnect_attachments.proto#L415} + /// [google.cloud.cpp.compute.interconnect_attachments.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_attachments/v1/interconnect_attachments.proto#L493} /// // clang-format on future> SetLabels( 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 87d65a390321b..f4d6e6929a548 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 "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_069.pb.h" -#include "google/cloud/compute/v1/internal/common_070.pb.h" -#include "google/cloud/compute/v1/internal/common_107.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_085.pb.h" +#include "google/cloud/compute/v1/internal/common_086.pb.h" +#include "google/cloud/compute/v1/internal/common_125.pb.h" // 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_groups/v1/interconnect_groups_client.h b/google/cloud/compute/interconnect_groups/v1/interconnect_groups_client.h index bbbc345b3e106..a7e3718339c3c 100644 --- a/google/cloud/compute/interconnect_groups/v1/interconnect_groups_client.h +++ b/google/cloud/compute/interconnect_groups/v1/interconnect_groups_client.h @@ -119,7 +119,7 @@ class InterconnectGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.interconnect_groups.v1.CreateMembersRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_groups/v1/interconnect_groups.proto#L166} + /// [google.cloud.cpp.compute.interconnect_groups.v1.CreateMembersRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_groups/v1/interconnect_groups.proto#L168} /// // clang-format on future> CreateMembers( @@ -180,7 +180,7 @@ class InterconnectGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.interconnect_groups.v1.CreateMembersRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_groups/v1/interconnect_groups.proto#L166} + /// [google.cloud.cpp.compute.interconnect_groups.v1.CreateMembersRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_groups/v1/interconnect_groups.proto#L168} /// // clang-format on future> CreateMembers( @@ -245,7 +245,7 @@ class InterconnectGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.interconnect_groups.v1.DeleteInterconnectGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_groups/v1/interconnect_groups.proto#L185} + /// [google.cloud.cpp.compute.interconnect_groups.v1.DeleteInterconnectGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_groups/v1/interconnect_groups.proto#L187} /// // clang-format on future> @@ -299,7 +299,7 @@ class InterconnectGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.interconnect_groups.v1.DeleteInterconnectGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_groups/v1/interconnect_groups.proto#L185} + /// [google.cloud.cpp.compute.interconnect_groups.v1.DeleteInterconnectGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_groups/v1/interconnect_groups.proto#L187} /// // clang-format on future> @@ -358,8 +358,8 @@ class InterconnectGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.interconnect_groups.v1.GetInterconnectGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_groups/v1/interconnect_groups.proto#L227} - /// [google.cloud.cpp.compute.v1.InterconnectGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_073.proto#L28} + /// [google.cloud.cpp.compute.interconnect_groups.v1.GetInterconnectGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_groups/v1/interconnect_groups.proto#L232} + /// [google.cloud.cpp.compute.v1.InterconnectGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_089.proto#L28} /// // clang-format on StatusOr @@ -391,8 +391,8 @@ class InterconnectGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.interconnect_groups.v1.GetInterconnectGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_groups/v1/interconnect_groups.proto#L227} - /// [google.cloud.cpp.compute.v1.InterconnectGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_073.proto#L28} + /// [google.cloud.cpp.compute.interconnect_groups.v1.GetInterconnectGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_groups/v1/interconnect_groups.proto#L232} + /// [google.cloud.cpp.compute.v1.InterconnectGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_089.proto#L28} /// // clang-format on StatusOr @@ -421,8 +421,8 @@ class InterconnectGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.interconnect_groups.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_groups/v1/interconnect_groups.proto#L212} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} + /// [google.cloud.cpp.compute.interconnect_groups.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_groups/v1/interconnect_groups.proto#L217} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr GetIamPolicy( @@ -454,8 +454,8 @@ class InterconnectGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.interconnect_groups.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_groups/v1/interconnect_groups.proto#L212} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} + /// [google.cloud.cpp.compute.interconnect_groups.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_groups/v1/interconnect_groups.proto#L217} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr GetIamPolicy( @@ -465,7 +465,8 @@ class InterconnectGroupsClient { // clang-format off /// - /// Returns the interconnectStatuses for the specified InterconnectGroup. + /// Returns the interconnectStatuses for the specified + /// InterconnectGroup. /// https://cloud.google.com/compute/docs/reference/rest/v1/interconnectGroups/getOperationalStatus /// /// @param project Project ID for this request. @@ -483,8 +484,8 @@ class InterconnectGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.interconnect_groups.v1.GetOperationalStatusRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_groups/v1/interconnect_groups.proto#L238} - /// [google.cloud.cpp.compute.v1.InterconnectGroupsGetOperationalStatusResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_073.proto#L298} + /// [google.cloud.cpp.compute.interconnect_groups.v1.GetOperationalStatusRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_groups/v1/interconnect_groups.proto#L243} + /// [google.cloud.cpp.compute.v1.InterconnectGroupsGetOperationalStatusResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_089.proto#L330} /// // clang-format on StatusOr> @@ -614,7 +616,7 @@ class InterconnectGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.interconnect_groups.v1.InsertInterconnectGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_groups/v1/interconnect_groups.proto#L249} + /// [google.cloud.cpp.compute.interconnect_groups.v1.InsertInterconnectGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_groups/v1/interconnect_groups.proto#L254} /// // clang-format on future> @@ -681,8 +683,8 @@ class InterconnectGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.interconnect_groups.v1.ListInterconnectGroupsRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_groups/v1/interconnect_groups.proto#L276} - /// [google.cloud.cpp.compute.v1.InterconnectGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_073.proto#L28} + /// [google.cloud.cpp.compute.interconnect_groups.v1.ListInterconnectGroupsRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_groups/v1/interconnect_groups.proto#L284} + /// [google.cloud.cpp.compute.v1.InterconnectGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_089.proto#L28} /// // clang-format on StreamRange @@ -721,8 +723,8 @@ class InterconnectGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.interconnect_groups.v1.ListInterconnectGroupsRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_groups/v1/interconnect_groups.proto#L276} - /// [google.cloud.cpp.compute.v1.InterconnectGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_073.proto#L28} + /// [google.cloud.cpp.compute.interconnect_groups.v1.ListInterconnectGroupsRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_groups/v1/interconnect_groups.proto#L284} + /// [google.cloud.cpp.compute.v1.InterconnectGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_089.proto#L28} /// // clang-format on StreamRange @@ -733,8 +735,9 @@ class InterconnectGroupsClient { // clang-format off /// /// Patches the specified InterconnectGroup resource with the data included in - /// the request. This method supports PATCH semantics and uses JSON merge patch - /// format and processing rules. + /// the request. This method supports PATCH + /// semantics and usesJSON merge + /// patch format and processing rules. /// https://cloud.google.com/compute/docs/reference/rest/v1/interconnectGroups/patch /// /// @param project Project ID for this request. @@ -761,7 +764,7 @@ class InterconnectGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.interconnect_groups.v1.PatchInterconnectGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_groups/v1/interconnect_groups.proto#L344} + /// [google.cloud.cpp.compute.interconnect_groups.v1.PatchInterconnectGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_groups/v1/interconnect_groups.proto#L385} /// // clang-format on future> @@ -793,8 +796,9 @@ class InterconnectGroupsClient { // clang-format off /// /// Patches the specified InterconnectGroup resource with the data included in - /// the request. This method supports PATCH semantics and uses JSON merge patch - /// format and processing rules. + /// the request. This method supports PATCH + /// semantics and usesJSON merge + /// patch format and processing rules. /// https://cloud.google.com/compute/docs/reference/rest/v1/interconnectGroups/patch /// /// @param request Unary RPCs, such as the one wrapped by this @@ -823,7 +827,7 @@ class InterconnectGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.interconnect_groups.v1.PatchInterconnectGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_groups/v1/interconnect_groups.proto#L344} + /// [google.cloud.cpp.compute.interconnect_groups.v1.PatchInterconnectGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_groups/v1/interconnect_groups.proto#L385} /// // clang-format on future> @@ -864,8 +868,8 @@ class InterconnectGroupsClient { // clang-format off /// - /// Sets the access control policy on the specified resource. Replaces any - /// existing policy. + /// Sets the access control policy on the specified resource. + /// Replaces any existing policy. /// https://cloud.google.com/compute/docs/reference/rest/v1/interconnectGroups/setIamPolicy /// /// @param project Project ID for this request. @@ -884,8 +888,8 @@ class InterconnectGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.interconnect_groups.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_groups/v1/interconnect_groups.proto#L378} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} + /// [google.cloud.cpp.compute.interconnect_groups.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_groups/v1/interconnect_groups.proto#L422} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr SetIamPolicy( @@ -896,8 +900,8 @@ class InterconnectGroupsClient { // clang-format off /// - /// Sets the access control policy on the specified resource. Replaces any - /// existing policy. + /// Sets the access control policy on the specified resource. + /// Replaces any existing policy. /// https://cloud.google.com/compute/docs/reference/rest/v1/interconnectGroups/setIamPolicy /// /// @param request Unary RPCs, such as the one wrapped by this @@ -919,8 +923,8 @@ class InterconnectGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.interconnect_groups.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_groups/v1/interconnect_groups.proto#L378} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} + /// [google.cloud.cpp.compute.interconnect_groups.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_groups/v1/interconnect_groups.proto#L422} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr SetIamPolicy( @@ -949,8 +953,8 @@ class InterconnectGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.interconnect_groups.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_groups/v1/interconnect_groups.proto#L394} - /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_145.proto#L30} + /// [google.cloud.cpp.compute.interconnect_groups.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_groups/v1/interconnect_groups.proto#L438} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} /// // clang-format on StatusOr @@ -984,8 +988,8 @@ class InterconnectGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.interconnect_groups.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_groups/v1/interconnect_groups.proto#L394} - /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_145.proto#L30} + /// [google.cloud.cpp.compute.interconnect_groups.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_groups/v1/interconnect_groups.proto#L438} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} /// // clang-format on StatusOr diff --git a/google/cloud/compute/interconnect_groups/v1/interconnect_groups_proto_export.h b/google/cloud/compute/interconnect_groups/v1/interconnect_groups_proto_export.h index 942bc1daa59a6..b9a2f06755775 100644 --- a/google/cloud/compute/interconnect_groups/v1/interconnect_groups_proto_export.h +++ b/google/cloud/compute/interconnect_groups/v1/interconnect_groups_proto_export.h @@ -26,13 +26,13 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_INTERCONNECT_GROUPS_V1_INTERCONNECT_GROUPS_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include "google/cloud/compute/v1/internal/common_007.pb.h" -#include "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_031.pb.h" -#include "google/cloud/compute/v1/internal/common_047.pb.h" -#include "google/cloud/compute/v1/internal/common_072.pb.h" -#include "google/cloud/compute/v1/internal/common_073.pb.h" -#include "google/cloud/compute/v1/internal/common_145.pb.h" +#include "google/cloud/compute/v1/internal/common_009.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_040.pb.h" +#include "google/cloud/compute/v1/internal/common_057.pb.h" +#include "google/cloud/compute/v1/internal/common_088.pb.h" +#include "google/cloud/compute/v1/internal/common_089.pb.h" +#include "google/cloud/compute/v1/internal/common_171.pb.h" // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_INTERCONNECT_GROUPS_V1_INTERCONNECT_GROUPS_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 e35edc58dee5a..944f4f00dd9f7 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_074.proto#L28} + /// [google.cloud.cpp.compute.v1.InterconnectLocation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_090.proto#L29} /// // 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_074.proto#L28} + /// [google.cloud.cpp.compute.v1.InterconnectLocation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_090.proto#L29} /// // 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_074.proto#L28} + /// [google.cloud.cpp.compute.v1.InterconnectLocation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_090.proto#L29} /// // 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_074.proto#L28} + /// [google.cloud.cpp.compute.v1.InterconnectLocation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_090.proto#L29} /// // 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 049a82f5dab94..2ebe55d3bfaa2 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 "google/cloud/compute/v1/internal/common_074.pb.h" +#include "google/cloud/compute/v1/internal/common_090.pb.h" // 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 2ea5cdad9e733..4c119c8ac028a 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 @@ -95,7 +95,7 @@ class InterconnectRemoteLocationsClient { // clang-format off /// /// Returns the details for the specified interconnect remote location. Gets a - /// list of available interconnect remote locations by making a list() request. + /// list of available interconnect remote locations by making alist() request. /// https://cloud.google.com/compute/docs/reference/rest/v1/interconnectRemoteLocations/get /// /// @param project Project ID for this request. @@ -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_075.proto#L29} + /// [google.cloud.cpp.compute.v1.InterconnectRemoteLocation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_091.proto#L30} /// // clang-format on StatusOr @@ -125,7 +125,7 @@ class InterconnectRemoteLocationsClient { // clang-format off /// /// Returns the details for the specified interconnect remote location. Gets a - /// list of available interconnect remote locations by making a list() request. + /// list of available interconnect remote locations by making alist() request. /// https://cloud.google.com/compute/docs/reference/rest/v1/interconnectRemoteLocations/get /// /// @param request Unary RPCs, such as the one wrapped by this @@ -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_075.proto#L29} + /// [google.cloud.cpp.compute.v1.InterconnectRemoteLocation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_091.proto#L30} /// // 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_075.proto#L29} + /// [google.cloud.cpp.compute.v1.InterconnectRemoteLocation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_091.proto#L30} /// // 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_075.proto#L29} + /// [google.cloud.cpp.compute.v1.InterconnectRemoteLocation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_091.proto#L30} /// // 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 dee12ca0726a4..b690791d8d65b 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 "google/cloud/compute/v1/internal/common_070.pb.h" -#include "google/cloud/compute/v1/internal/common_075.pb.h" +#include "google/cloud/compute/v1/internal/common_086.pb.h" +#include "google/cloud/compute/v1/internal/common_091.pb.h" // 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 1b3d91418e564..783075acf0c6b 100644 --- a/google/cloud/compute/interconnects/v1/interconnects_client.h +++ b/google/cloud/compute/interconnects/v1/interconnects_client.h @@ -115,7 +115,7 @@ class InterconnectsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.interconnects.v1.DeleteInterconnectRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnects/v1/interconnects.proto#L141} + /// [google.cloud.cpp.compute.interconnects.v1.DeleteInterconnectRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnects/v1/interconnects.proto#L149} /// // clang-format on future> @@ -168,7 +168,7 @@ class InterconnectsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.interconnects.v1.DeleteInterconnectRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnects/v1/interconnects.proto#L141} + /// [google.cloud.cpp.compute.interconnects.v1.DeleteInterconnectRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnects/v1/interconnects.proto#L149} /// // clang-format on future> @@ -228,8 +228,8 @@ class InterconnectsClient { /// [`future`]: @ref google::cloud::future /// [`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#L29} + /// [google.cloud.cpp.compute.interconnects.v1.GetInterconnectRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnects/v1/interconnects.proto#L189} + /// [google.cloud.cpp.compute.v1.Interconnect]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_084.proto#L31} /// // clang-format on StatusOr GetInterconnect( @@ -261,8 +261,8 @@ class InterconnectsClient { /// [`future`]: @ref google::cloud::future /// [`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#L29} + /// [google.cloud.cpp.compute.interconnects.v1.GetInterconnectRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnects/v1/interconnects.proto#L189} + /// [google.cloud.cpp.compute.v1.Interconnect]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_084.proto#L31} /// // clang-format on StatusOr GetInterconnect( @@ -272,11 +272,16 @@ class InterconnectsClient { // clang-format off /// - /// 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. + /// 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. /// https://cloud.google.com/compute/docs/reference/rest/v1/interconnects/getDiagnostics /// /// @param project Project ID for this request. @@ -294,8 +299,8 @@ class InterconnectsClient { /// [`future`]: @ref google::cloud::future /// [`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#L468} + /// [google.cloud.cpp.compute.interconnects.v1.GetDiagnosticsRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnects/v1/interconnects.proto#L178} + /// [google.cloud.cpp.compute.v1.InterconnectsGetDiagnosticsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_084.proto#L664} /// // clang-format on StatusOr @@ -304,11 +309,16 @@ class InterconnectsClient { // clang-format off /// - /// 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. + /// 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. /// https://cloud.google.com/compute/docs/reference/rest/v1/interconnects/getDiagnostics /// /// @param request Unary RPCs, such as the one wrapped by this @@ -330,8 +340,8 @@ class InterconnectsClient { /// [`future`]: @ref google::cloud::future /// [`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#L468} + /// [google.cloud.cpp.compute.interconnects.v1.GetDiagnosticsRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnects/v1/interconnects.proto#L178} + /// [google.cloud.cpp.compute.v1.InterconnectsGetDiagnosticsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_084.proto#L664} /// // clang-format on StatusOr @@ -341,7 +351,8 @@ class InterconnectsClient { // clang-format off /// - /// Returns the interconnectMacsecConfig for the specified Interconnect. + /// Returns the interconnectMacsecConfig for the specified + /// Interconnect. /// https://cloud.google.com/compute/docs/reference/rest/v1/interconnects/getMacsecConfig /// /// @param project Project ID for this request. @@ -359,8 +370,8 @@ class InterconnectsClient { /// [`future`]: @ref google::cloud::future /// [`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#L473} + /// [google.cloud.cpp.compute.interconnects.v1.GetMacsecConfigRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnects/v1/interconnects.proto#L200} + /// [google.cloud.cpp.compute.v1.InterconnectsGetMacsecConfigResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_084.proto#L669} /// // clang-format on StatusOr< @@ -370,7 +381,8 @@ class InterconnectsClient { // clang-format off /// - /// Returns the interconnectMacsecConfig for the specified Interconnect. + /// Returns the interconnectMacsecConfig for the specified + /// Interconnect. /// https://cloud.google.com/compute/docs/reference/rest/v1/interconnects/getMacsecConfig /// /// @param request Unary RPCs, such as the one wrapped by this @@ -392,8 +404,8 @@ class InterconnectsClient { /// [`future`]: @ref google::cloud::future /// [`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#L473} + /// [google.cloud.cpp.compute.interconnects.v1.GetMacsecConfigRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnects/v1/interconnects.proto#L200} + /// [google.cloud.cpp.compute.v1.InterconnectsGetMacsecConfigResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_084.proto#L669} /// // clang-format on StatusOr< @@ -404,8 +416,8 @@ class InterconnectsClient { // clang-format off /// - /// Creates an Interconnect in the specified project using the data included in - /// the request. + /// Creates an Interconnect in the specified project using + /// the data included in the request. /// https://cloud.google.com/compute/docs/reference/rest/v1/interconnects/insert /// /// @param project Project ID for this request. @@ -430,7 +442,7 @@ class InterconnectsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.interconnects.v1.InsertInterconnectRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnects/v1/interconnects.proto#L200} + /// [google.cloud.cpp.compute.interconnects.v1.InsertInterconnectRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnects/v1/interconnects.proto#L211} /// // clang-format on future> @@ -458,8 +470,8 @@ class InterconnectsClient { // clang-format off /// - /// Creates an Interconnect in the specified project using the data included in - /// the request. + /// Creates an Interconnect in the specified project using + /// the data included in the request. /// https://cloud.google.com/compute/docs/reference/rest/v1/interconnects/insert /// /// @param request Unary RPCs, such as the one wrapped by this @@ -488,7 +500,7 @@ class InterconnectsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.interconnects.v1.InsertInterconnectRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnects/v1/interconnects.proto#L200} + /// [google.cloud.cpp.compute.interconnects.v1.InsertInterconnectRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnects/v1/interconnects.proto#L211} /// // clang-format on future> @@ -555,8 +567,8 @@ class InterconnectsClient { /// [`future`]: @ref google::cloud::future /// [`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#L29} + /// [google.cloud.cpp.compute.interconnects.v1.ListInterconnectsRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnects/v1/interconnects.proto#L240} + /// [google.cloud.cpp.compute.v1.Interconnect]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_084.proto#L31} /// // clang-format on StreamRange ListInterconnects( @@ -595,8 +607,8 @@ class InterconnectsClient { /// [`future`]: @ref google::cloud::future /// [`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#L29} + /// [google.cloud.cpp.compute.interconnects.v1.ListInterconnectsRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnects/v1/interconnects.proto#L240} + /// [google.cloud.cpp.compute.v1.Interconnect]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_084.proto#L31} /// // clang-format on StreamRange ListInterconnects( @@ -607,8 +619,9 @@ class InterconnectsClient { // clang-format off /// /// 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. + /// This method supportsPATCH + /// semantics and uses theJSON merge + /// patch format and processing rules. /// https://cloud.google.com/compute/docs/reference/rest/v1/interconnects/patch /// /// @param project Project ID for this request. @@ -634,7 +647,7 @@ class InterconnectsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.interconnects.v1.PatchInterconnectRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnects/v1/interconnects.proto#L294} + /// [google.cloud.cpp.compute.interconnects.v1.PatchInterconnectRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnects/v1/interconnects.proto#L341} /// // clang-format on future> @@ -663,8 +676,9 @@ class InterconnectsClient { // clang-format off /// /// 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. + /// This method supportsPATCH + /// semantics and uses theJSON merge + /// patch format and processing rules. /// https://cloud.google.com/compute/docs/reference/rest/v1/interconnects/patch /// /// @param request Unary RPCs, such as the one wrapped by this @@ -693,7 +707,7 @@ class InterconnectsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.interconnects.v1.PatchInterconnectRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnects/v1/interconnects.proto#L294} + /// [google.cloud.cpp.compute.interconnects.v1.PatchInterconnectRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnects/v1/interconnects.proto#L341} /// // clang-format on future> @@ -733,8 +747,9 @@ class InterconnectsClient { // clang-format off /// - /// Sets the labels on an Interconnect. To learn more about labels, read the - /// Labeling Resources documentation. + /// Sets the labels on an Interconnect. To learn more about labels, + /// read the Labeling + /// Resources documentation. /// https://cloud.google.com/compute/docs/reference/rest/v1/interconnects/setLabels /// /// @param project Project ID for this request. @@ -760,7 +775,7 @@ class InterconnectsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.interconnects.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnects/v1/interconnects.proto#L324} + /// [google.cloud.cpp.compute.interconnects.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnects/v1/interconnects.proto#L374} /// // clang-format on future> SetLabels( @@ -788,8 +803,9 @@ class InterconnectsClient { // clang-format off /// - /// Sets the labels on an Interconnect. To learn more about labels, read the - /// Labeling Resources documentation. + /// Sets the labels on an Interconnect. To learn more about labels, + /// read the Labeling + /// Resources documentation. /// https://cloud.google.com/compute/docs/reference/rest/v1/interconnects/setLabels /// /// @param request Unary RPCs, such as the one wrapped by this @@ -818,7 +834,7 @@ class InterconnectsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.interconnects.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnects/v1/interconnects.proto#L324} + /// [google.cloud.cpp.compute.interconnects.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnects/v1/interconnects.proto#L374} /// // clang-format on future> SetLabels( diff --git a/google/cloud/compute/interconnects/v1/interconnects_proto_export.h b/google/cloud/compute/interconnects/v1/interconnects_proto_export.h index 28d03f527b2ee..6013947880b91 100644 --- a/google/cloud/compute/interconnects/v1/interconnects_proto_export.h +++ b/google/cloud/compute/interconnects/v1/interconnects_proto_export.h @@ -26,10 +26,10 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_INTERCONNECTS_V1_INTERCONNECTS_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_046.pb.h" -#include "google/cloud/compute/v1/internal/common_068.pb.h" -#include "google/cloud/compute/v1/internal/common_072.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_056.pb.h" +#include "google/cloud/compute/v1/internal/common_084.pb.h" +#include "google/cloud/compute/v1/internal/common_088.pb.h" // 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/internal/license_codes_rest_connection_impl.cc b/google/cloud/compute/license_codes/v1/internal/license_codes_rest_connection_impl.cc index 52b30415673e6..755b2a269f67b 100644 --- a/google/cloud/compute/license_codes/v1/internal/license_codes_rest_connection_impl.cc +++ b/google/cloud/compute/license_codes/v1/internal/license_codes_rest_connection_impl.cc @@ -56,6 +56,38 @@ LicenseCodesRestConnectionImpl::GetLicenseCode( *current, request, __func__); } +StatusOr +LicenseCodesRestConnectionImpl::GetIamPolicy( + google::cloud::cpp::compute::license_codes::v1::GetIamPolicyRequest const& + request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->GetIamPolicy(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::license_codes::v1:: + GetIamPolicyRequest const& request) { + return stub_->GetIamPolicy(rest_context, options, request); + }, + *current, request, __func__); +} + +StatusOr +LicenseCodesRestConnectionImpl::SetIamPolicy( + google::cloud::cpp::compute::license_codes::v1::SetIamPolicyRequest const& + request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->SetIamPolicy(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::license_codes::v1:: + SetIamPolicyRequest const& request) { + return stub_->SetIamPolicy(rest_context, options, request); + }, + *current, request, __func__); +} + StatusOr LicenseCodesRestConnectionImpl::TestIamPermissions( google::cloud::cpp::compute::license_codes::v1:: diff --git a/google/cloud/compute/license_codes/v1/internal/license_codes_rest_connection_impl.h b/google/cloud/compute/license_codes/v1/internal/license_codes_rest_connection_impl.h index b2cfcbebbbf76..bf1649ca57083 100644 --- a/google/cloud/compute/license_codes/v1/internal/license_codes_rest_connection_impl.h +++ b/google/cloud/compute/license_codes/v1/internal/license_codes_rest_connection_impl.h @@ -53,6 +53,14 @@ class LicenseCodesRestConnectionImpl google::cloud::cpp::compute::license_codes::v1:: GetLicenseCodeRequest const& request) override; + StatusOr GetIamPolicy( + google::cloud::cpp::compute::license_codes::v1::GetIamPolicyRequest const& + request) override; + + StatusOr SetIamPolicy( + google::cloud::cpp::compute::license_codes::v1::SetIamPolicyRequest const& + request) override; + StatusOr TestIamPermissions(google::cloud::cpp::compute::license_codes::v1:: TestIamPermissionsRequest const& request) override; diff --git a/google/cloud/compute/license_codes/v1/internal/license_codes_rest_logging_decorator.cc b/google/cloud/compute/license_codes/v1/internal/license_codes_rest_logging_decorator.cc index 978f84394c435..3807a059ce7c5 100644 --- a/google/cloud/compute/license_codes/v1/internal/license_codes_rest_logging_decorator.cc +++ b/google/cloud/compute/license_codes/v1/internal/license_codes_rest_logging_decorator.cc @@ -48,6 +48,34 @@ LicenseCodesRestLogging::GetLicenseCode( rest_context, options, request, __func__, tracing_options_); } +StatusOr +LicenseCodesRestLogging::GetIamPolicy( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::license_codes::v1::GetIamPolicyRequest const& + request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::license_codes::v1:: + GetIamPolicyRequest const& request) { + return child_->GetIamPolicy(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +StatusOr +LicenseCodesRestLogging::SetIamPolicy( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::license_codes::v1::SetIamPolicyRequest const& + request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::license_codes::v1:: + SetIamPolicyRequest const& request) { + return child_->SetIamPolicy(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + StatusOr LicenseCodesRestLogging::TestIamPermissions( rest_internal::RestContext& rest_context, Options const& options, diff --git a/google/cloud/compute/license_codes/v1/internal/license_codes_rest_logging_decorator.h b/google/cloud/compute/license_codes/v1/internal/license_codes_rest_logging_decorator.h index 1338441af6042..6fa835fa8abd5 100644 --- a/google/cloud/compute/license_codes/v1/internal/license_codes_rest_logging_decorator.h +++ b/google/cloud/compute/license_codes/v1/internal/license_codes_rest_logging_decorator.h @@ -47,6 +47,18 @@ class LicenseCodesRestLogging : public LicenseCodesRestStub { google::cloud::cpp::compute::license_codes::v1:: GetLicenseCodeRequest const& request) override; + StatusOr GetIamPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::license_codes::v1::GetIamPolicyRequest const& + request) override; + + StatusOr SetIamPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::license_codes::v1::SetIamPolicyRequest const& + request) override; + StatusOr TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, Options const& options, diff --git a/google/cloud/compute/license_codes/v1/internal/license_codes_rest_metadata_decorator.cc b/google/cloud/compute/license_codes/v1/internal/license_codes_rest_metadata_decorator.cc index ed0e1c2c1bd01..ae0b575594628 100644 --- a/google/cloud/compute/license_codes/v1/internal/license_codes_rest_metadata_decorator.cc +++ b/google/cloud/compute/license_codes/v1/internal/license_codes_rest_metadata_decorator.cc @@ -47,6 +47,24 @@ LicenseCodesRestMetadata::GetLicenseCode( return child_->GetLicenseCode(rest_context, options, request); } +StatusOr +LicenseCodesRestMetadata::GetIamPolicy( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::license_codes::v1::GetIamPolicyRequest const& + request) { + SetMetadata(rest_context, options); + return child_->GetIamPolicy(rest_context, options, request); +} + +StatusOr +LicenseCodesRestMetadata::SetIamPolicy( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::license_codes::v1::SetIamPolicyRequest const& + request) { + SetMetadata(rest_context, options); + return child_->SetIamPolicy(rest_context, options, request); +} + StatusOr LicenseCodesRestMetadata::TestIamPermissions( rest_internal::RestContext& rest_context, Options const& options, diff --git a/google/cloud/compute/license_codes/v1/internal/license_codes_rest_metadata_decorator.h b/google/cloud/compute/license_codes/v1/internal/license_codes_rest_metadata_decorator.h index 774af7f60c9c0..50f8c595f3a28 100644 --- a/google/cloud/compute/license_codes/v1/internal/license_codes_rest_metadata_decorator.h +++ b/google/cloud/compute/license_codes/v1/internal/license_codes_rest_metadata_decorator.h @@ -44,6 +44,18 @@ class LicenseCodesRestMetadata : public LicenseCodesRestStub { google::cloud::cpp::compute::license_codes::v1:: GetLicenseCodeRequest const& request) override; + StatusOr GetIamPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::license_codes::v1::GetIamPolicyRequest const& + request) override; + + StatusOr SetIamPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::license_codes::v1::SetIamPolicyRequest const& + request) override; + StatusOr TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, Options const& options, diff --git a/google/cloud/compute/license_codes/v1/internal/license_codes_rest_stub.cc b/google/cloud/compute/license_codes/v1/internal/license_codes_rest_stub.cc index 1dfe9b231b9fa..971dbc07c66c0 100644 --- a/google/cloud/compute/license_codes/v1/internal/license_codes_rest_stub.cc +++ b/google/cloud/compute/license_codes/v1/internal/license_codes_rest_stub.cc @@ -55,6 +55,46 @@ DefaultLicenseCodesRestStub::GetLicenseCode( std::move(query_params)); } +StatusOr +DefaultLicenseCodesRestStub::GetIamPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::license_codes::v1::GetIamPolicyRequest const& + request) { + std::vector> query_params; + query_params.push_back( + {"options_requested_policy_version", + std::to_string(request.options_requested_policy_version())}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Get( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "global", "/", + "licenseCodes", "/", request.resource(), "/", + "getIamPolicy"), + std::move(query_params)); +} + +StatusOr +DefaultLicenseCodesRestStub::SetIamPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::license_codes::v1::SetIamPolicyRequest const& + request) { + std::vector> query_params; + return rest_internal::Post( + *service_, rest_context, request.global_set_policy_request_resource(), + false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "global", "/", + "licenseCodes", "/", request.resource(), "/", + "setIamPolicy"), + std::move(query_params)); +} + StatusOr DefaultLicenseCodesRestStub::TestIamPermissions( google::cloud::rest_internal::RestContext& rest_context, diff --git a/google/cloud/compute/license_codes/v1/internal/license_codes_rest_stub.h b/google/cloud/compute/license_codes/v1/internal/license_codes_rest_stub.h index 3de76502f66d8..651d1072389ad 100644 --- a/google/cloud/compute/license_codes/v1/internal/license_codes_rest_stub.h +++ b/google/cloud/compute/license_codes/v1/internal/license_codes_rest_stub.h @@ -42,6 +42,18 @@ class LicenseCodesRestStub { google::cloud::cpp::compute::license_codes::v1:: GetLicenseCodeRequest const& request) = 0; + virtual StatusOr GetIamPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::license_codes::v1::GetIamPolicyRequest const& + request) = 0; + + virtual StatusOr SetIamPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::license_codes::v1::SetIamPolicyRequest const& + request) = 0; + virtual StatusOr TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, Options const& options, @@ -63,6 +75,18 @@ class DefaultLicenseCodesRestStub : public LicenseCodesRestStub { google::cloud::cpp::compute::license_codes::v1:: GetLicenseCodeRequest const& request) override; + StatusOr GetIamPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::license_codes::v1::GetIamPolicyRequest const& + request) override; + + StatusOr SetIamPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::license_codes::v1::SetIamPolicyRequest const& + request) override; + StatusOr TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, Options const& options, diff --git a/google/cloud/compute/license_codes/v1/internal/license_codes_tracing_connection.cc b/google/cloud/compute/license_codes/v1/internal/license_codes_tracing_connection.cc index 8d61a0afeb6e7..20f2f9b8e2304 100644 --- a/google/cloud/compute/license_codes/v1/internal/license_codes_tracing_connection.cc +++ b/google/cloud/compute/license_codes/v1/internal/license_codes_tracing_connection.cc @@ -40,6 +40,26 @@ LicenseCodesTracingConnection::GetLicenseCode( return internal::EndSpan(*span, child_->GetLicenseCode(request)); } +StatusOr +LicenseCodesTracingConnection::GetIamPolicy( + google::cloud::cpp::compute::license_codes::v1::GetIamPolicyRequest const& + request) { + auto span = internal::MakeSpan( + "compute_license_codes_v1::LicenseCodesConnection::GetIamPolicy"); + auto scope = opentelemetry::trace::Scope(span); + return internal::EndSpan(*span, child_->GetIamPolicy(request)); +} + +StatusOr +LicenseCodesTracingConnection::SetIamPolicy( + google::cloud::cpp::compute::license_codes::v1::SetIamPolicyRequest const& + request) { + auto span = internal::MakeSpan( + "compute_license_codes_v1::LicenseCodesConnection::SetIamPolicy"); + auto scope = opentelemetry::trace::Scope(span); + return internal::EndSpan(*span, child_->SetIamPolicy(request)); +} + StatusOr LicenseCodesTracingConnection::TestIamPermissions( google::cloud::cpp::compute::license_codes::v1:: diff --git a/google/cloud/compute/license_codes/v1/internal/license_codes_tracing_connection.h b/google/cloud/compute/license_codes/v1/internal/license_codes_tracing_connection.h index 962b1ae73645f..78b6656cbbd8f 100644 --- a/google/cloud/compute/license_codes/v1/internal/license_codes_tracing_connection.h +++ b/google/cloud/compute/license_codes/v1/internal/license_codes_tracing_connection.h @@ -42,6 +42,14 @@ class LicenseCodesTracingConnection google::cloud::cpp::compute::license_codes::v1:: GetLicenseCodeRequest const& request) override; + StatusOr GetIamPolicy( + google::cloud::cpp::compute::license_codes::v1::GetIamPolicyRequest const& + request) override; + + StatusOr SetIamPolicy( + google::cloud::cpp::compute::license_codes::v1::SetIamPolicyRequest const& + request) override; + StatusOr TestIamPermissions(google::cloud::cpp::compute::license_codes::v1:: TestIamPermissionsRequest const& request) override; diff --git a/google/cloud/compute/license_codes/v1/license_codes_client.cc b/google/cloud/compute/license_codes/v1/license_codes_client.cc index e140c798b993c..4193d135530c3 100644 --- a/google/cloud/compute/license_codes/v1/license_codes_client.cc +++ b/google/cloud/compute/license_codes/v1/license_codes_client.cc @@ -52,6 +52,49 @@ LicenseCodesClient::GetLicenseCode( return connection_->GetLicenseCode(request); } +StatusOr +LicenseCodesClient::GetIamPolicy(std::string const& project, + std::string const& resource, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::license_codes::v1::GetIamPolicyRequest request; + request.set_project(project); + request.set_resource(resource); + return connection_->GetIamPolicy(request); +} + +StatusOr +LicenseCodesClient::GetIamPolicy( + google::cloud::cpp::compute::license_codes::v1::GetIamPolicyRequest const& + request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->GetIamPolicy(request); +} + +StatusOr +LicenseCodesClient::SetIamPolicy( + std::string const& project, std::string const& resource, + google::cloud::cpp::compute::v1::GlobalSetPolicyRequest const& + global_set_policy_request_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::license_codes::v1::SetIamPolicyRequest request; + request.set_project(project); + request.set_resource(resource); + *request.mutable_global_set_policy_request_resource() = + global_set_policy_request_resource; + return connection_->SetIamPolicy(request); +} + +StatusOr +LicenseCodesClient::SetIamPolicy( + google::cloud::cpp::compute::license_codes::v1::SetIamPolicyRequest const& + request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->SetIamPolicy(request); +} + StatusOr LicenseCodesClient::TestIamPermissions( std::string const& project, std::string const& resource, 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 5871662395958..13e61f022e121 100644 --- a/google/cloud/compute/license_codes/v1/license_codes_client.h +++ b/google/cloud/compute/license_codes/v1/license_codes_client.h @@ -88,10 +88,11 @@ class LicenseCodesClient { // clang-format off /// - /// 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. + /// 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 creatingCloud Marketplace + /// images. /// https://cloud.google.com/compute/docs/reference/rest/v1/licenseCodes/get /// /// @param project Project ID for this request. @@ -109,8 +110,8 @@ class LicenseCodesClient { /// [`future`]: @ref google::cloud::future /// [`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_077.proto#L27} + /// [google.cloud.cpp.compute.license_codes.v1.GetLicenseCodeRequest]: @cloud_cpp_reference_link{google/cloud/compute/license_codes/v1/license_codes.proto#L117} + /// [google.cloud.cpp.compute.v1.LicenseCode]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_093.proto#L33} /// // clang-format on StatusOr GetLicenseCode( @@ -119,10 +120,11 @@ class LicenseCodesClient { // clang-format off /// - /// 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. + /// 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 creatingCloud Marketplace + /// images. /// https://cloud.google.com/compute/docs/reference/rest/v1/licenseCodes/get /// /// @param request Unary RPCs, such as the one wrapped by this @@ -144,8 +146,8 @@ class LicenseCodesClient { /// [`future`]: @ref google::cloud::future /// [`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_077.proto#L27} + /// [google.cloud.cpp.compute.license_codes.v1.GetLicenseCodeRequest]: @cloud_cpp_reference_link{google/cloud/compute/license_codes/v1/license_codes.proto#L117} + /// [google.cloud.cpp.compute.v1.LicenseCode]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_093.proto#L33} /// // clang-format on StatusOr GetLicenseCode( @@ -155,9 +157,151 @@ class LicenseCodesClient { // clang-format off /// - /// 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. + /// 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 creatingCloud Marketplace + /// images. + /// https://cloud.google.com/compute/docs/reference/rest/v1/licenseCodes/getIamPolicy + /// + /// @param project Project ID for this request. + /// @param resource Name or id of the resource for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.Policy]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.license_codes.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/license_codes/v1/license_codes.proto#L102} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} + /// + // clang-format on + StatusOr GetIamPolicy( + std::string const& project, std::string const& resource, + Options opts = {}); + + // clang-format off + /// + /// 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 creatingCloud Marketplace + /// images. + /// https://cloud.google.com/compute/docs/reference/rest/v1/licenseCodes/getIamPolicy + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.license_codes.v1.GetIamPolicyRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.Policy]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.license_codes.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/license_codes/v1/license_codes.proto#L102} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} + /// + // clang-format on + StatusOr GetIamPolicy( + google::cloud::cpp::compute::license_codes::v1::GetIamPolicyRequest const& + request, + Options opts = {}); + + // clang-format off + /// + /// 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 creatingCloud Marketplace + /// images. + /// https://cloud.google.com/compute/docs/reference/rest/v1/licenseCodes/setIamPolicy + /// + /// @param project Project ID for this request. + /// @param resource Name or id of the resource for this request. + /// @param global_set_policy_request_resource The GlobalSetPolicyRequest for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.Policy]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.license_codes.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/license_codes/v1/license_codes.proto#L128} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} + /// + // clang-format on + StatusOr SetIamPolicy( + std::string const& project, std::string const& resource, + google::cloud::cpp::compute::v1::GlobalSetPolicyRequest const& + global_set_policy_request_resource, + Options opts = {}); + + // clang-format off + /// + /// 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 creatingCloud Marketplace + /// images. + /// https://cloud.google.com/compute/docs/reference/rest/v1/licenseCodes/setIamPolicy + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.license_codes.v1.SetIamPolicyRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.Policy]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.license_codes.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/license_codes/v1/license_codes.proto#L128} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} + /// + // clang-format on + StatusOr SetIamPolicy( + google::cloud::cpp::compute::license_codes::v1::SetIamPolicyRequest const& + request, + Options opts = {}); + + // clang-format off + /// + /// Returns permissions that a caller has on the specified resource. + /// *Caution* This resource is intended + /// for use only by third-party partners who are creatingCloud Marketplace + /// images. /// https://cloud.google.com/compute/docs/reference/rest/v1/licenseCodes/testIamPermissions /// /// @param project Project ID for this request. @@ -176,8 +320,8 @@ class LicenseCodesClient { /// [`future`]: @ref google::cloud::future /// [`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_145.proto#L30} + /// [google.cloud.cpp.compute.license_codes.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/license_codes/v1/license_codes.proto#L144} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} /// // clang-format on StatusOr @@ -189,9 +333,10 @@ class LicenseCodesClient { // clang-format off /// - /// 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. + /// Returns permissions that a caller has on the specified resource. + /// *Caution* This resource is intended + /// for use only by third-party partners who are creatingCloud Marketplace + /// images. /// https://cloud.google.com/compute/docs/reference/rest/v1/licenseCodes/testIamPermissions /// /// @param request Unary RPCs, such as the one wrapped by this @@ -213,8 +358,8 @@ class LicenseCodesClient { /// [`future`]: @ref google::cloud::future /// [`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_145.proto#L30} + /// [google.cloud.cpp.compute.license_codes.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/license_codes/v1/license_codes.proto#L144} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} /// // clang-format on StatusOr diff --git a/google/cloud/compute/license_codes/v1/license_codes_connection.cc b/google/cloud/compute/license_codes/v1/license_codes_connection.cc index 9404503f832d7..fadbc9d69162b 100644 --- a/google/cloud/compute/license_codes/v1/license_codes_connection.cc +++ b/google/cloud/compute/license_codes/v1/license_codes_connection.cc @@ -42,6 +42,20 @@ LicenseCodesConnection::GetLicenseCode( return Status(StatusCode::kUnimplemented, "not implemented"); } +StatusOr +LicenseCodesConnection::GetIamPolicy( + google::cloud::cpp::compute::license_codes::v1:: + GetIamPolicyRequest const&) { + return Status(StatusCode::kUnimplemented, "not implemented"); +} + +StatusOr +LicenseCodesConnection::SetIamPolicy( + google::cloud::cpp::compute::license_codes::v1:: + SetIamPolicyRequest const&) { + return Status(StatusCode::kUnimplemented, "not implemented"); +} + StatusOr LicenseCodesConnection::TestIamPermissions( google::cloud::cpp::compute::license_codes::v1:: diff --git a/google/cloud/compute/license_codes/v1/license_codes_connection.h b/google/cloud/compute/license_codes/v1/license_codes_connection.h index ad811d4af8318..7a6a71b9a2d33 100644 --- a/google/cloud/compute/license_codes/v1/license_codes_connection.h +++ b/google/cloud/compute/license_codes/v1/license_codes_connection.h @@ -186,6 +186,14 @@ class LicenseCodesConnection { google::cloud::cpp::compute::license_codes::v1:: GetLicenseCodeRequest const& request); + virtual StatusOr GetIamPolicy( + google::cloud::cpp::compute::license_codes::v1::GetIamPolicyRequest const& + request); + + virtual StatusOr SetIamPolicy( + google::cloud::cpp::compute::license_codes::v1::SetIamPolicyRequest const& + request); + virtual StatusOr TestIamPermissions(google::cloud::cpp::compute::license_codes::v1:: TestIamPermissionsRequest const& request); diff --git a/google/cloud/compute/license_codes/v1/license_codes_connection_idempotency_policy.cc b/google/cloud/compute/license_codes/v1/license_codes_connection_idempotency_policy.cc index deed69c65ed2a..3ae9c0f6b276f 100644 --- a/google/cloud/compute/license_codes/v1/license_codes_connection_idempotency_policy.cc +++ b/google/cloud/compute/license_codes/v1/license_codes_connection_idempotency_policy.cc @@ -40,6 +40,18 @@ Idempotency LicenseCodesConnectionIdempotencyPolicy::GetLicenseCode( return Idempotency::kIdempotent; } +Idempotency LicenseCodesConnectionIdempotencyPolicy::GetIamPolicy( + google::cloud::cpp::compute::license_codes::v1:: + GetIamPolicyRequest const&) { + return Idempotency::kIdempotent; +} + +Idempotency LicenseCodesConnectionIdempotencyPolicy::SetIamPolicy( + google::cloud::cpp::compute::license_codes::v1:: + SetIamPolicyRequest const&) { + return Idempotency::kNonIdempotent; +} + Idempotency LicenseCodesConnectionIdempotencyPolicy::TestIamPermissions( google::cloud::cpp::compute::license_codes::v1:: TestIamPermissionsRequest const&) { diff --git a/google/cloud/compute/license_codes/v1/license_codes_connection_idempotency_policy.h b/google/cloud/compute/license_codes/v1/license_codes_connection_idempotency_policy.h index 9fb95dc04f653..268b4f4daf3c8 100644 --- a/google/cloud/compute/license_codes/v1/license_codes_connection_idempotency_policy.h +++ b/google/cloud/compute/license_codes/v1/license_codes_connection_idempotency_policy.h @@ -41,6 +41,14 @@ class LicenseCodesConnectionIdempotencyPolicy { google::cloud::cpp::compute::license_codes::v1:: GetLicenseCodeRequest const& request); + virtual google::cloud::Idempotency GetIamPolicy( + google::cloud::cpp::compute::license_codes::v1::GetIamPolicyRequest const& + request); + + virtual google::cloud::Idempotency SetIamPolicy( + google::cloud::cpp::compute::license_codes::v1::SetIamPolicyRequest const& + request); + virtual google::cloud::Idempotency TestIamPermissions( google::cloud::cpp::compute::license_codes::v1:: TestIamPermissionsRequest const& request); 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 1615730514d13..7b77b9839410f 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,12 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_LICENSE_CODES_V1_LICENSE_CODES_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include "google/cloud/compute/v1/internal/common_077.pb.h" -#include "google/cloud/compute/v1/internal/common_145.pb.h" +#include "google/cloud/compute/v1/internal/common_009.pb.h" +#include "google/cloud/compute/v1/internal/common_038.pb.h" +#include "google/cloud/compute/v1/internal/common_040.pb.h" +#include "google/cloud/compute/v1/internal/common_057.pb.h" +#include "google/cloud/compute/v1/internal/common_093.pb.h" +#include "google/cloud/compute/v1/internal/common_171.pb.h" // 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/license_codes/v1/mocks/mock_license_codes_connection.h b/google/cloud/compute/license_codes/v1/mocks/mock_license_codes_connection.h index 899006d4766e9..d6ae9839d683a 100644 --- a/google/cloud/compute/license_codes/v1/mocks/mock_license_codes_connection.h +++ b/google/cloud/compute/license_codes/v1/mocks/mock_license_codes_connection.h @@ -53,6 +53,16 @@ class MockLicenseCodesConnection GetLicenseCodeRequest const& request), (override)); + MOCK_METHOD(StatusOr, GetIamPolicy, + (google::cloud::cpp::compute::license_codes::v1:: + GetIamPolicyRequest const& request), + (override)); + + MOCK_METHOD(StatusOr, SetIamPolicy, + (google::cloud::cpp::compute::license_codes::v1:: + SetIamPolicyRequest const& request), + (override)); + MOCK_METHOD( StatusOr, TestIamPermissions, diff --git a/google/cloud/compute/licenses/v1/licenses_client.h b/google/cloud/compute/licenses/v1/licenses_client.h index 484964081b644..8468617fb46f6 100644 --- a/google/cloud/compute/licenses/v1/licenses_client.h +++ b/google/cloud/compute/licenses/v1/licenses_client.h @@ -87,8 +87,10 @@ class LicensesClient { // clang-format off /// - /// Deletes the specified license. *Caution* This resource is intended for use - /// only by third-party partners who are creating Cloud Marketplace images. + /// Deletes the specified license. + /// *Caution* This resource is intended + /// for use only by third-party partners who are creatingCloud Marketplace + /// images. /// https://cloud.google.com/compute/docs/reference/rest/v1/licenses/delete /// /// @param project Project ID for this request. @@ -113,7 +115,7 @@ class LicensesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.licenses.v1.DeleteLicenseRequest]: @cloud_cpp_reference_link{google/cloud/compute/licenses/v1/licenses.proto#L157} + /// [google.cloud.cpp.compute.licenses.v1.DeleteLicenseRequest]: @cloud_cpp_reference_link{google/cloud/compute/licenses/v1/licenses.proto#L169} /// // clang-format on future> DeleteLicense( @@ -137,8 +139,10 @@ class LicensesClient { // clang-format off /// - /// Deletes the specified license. *Caution* This resource is intended for use - /// only by third-party partners who are creating Cloud Marketplace images. + /// Deletes the specified license. + /// *Caution* This resource is intended + /// for use only by third-party partners who are creatingCloud Marketplace + /// images. /// https://cloud.google.com/compute/docs/reference/rest/v1/licenses/delete /// /// @param request Unary RPCs, such as the one wrapped by this @@ -167,7 +171,7 @@ class LicensesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.licenses.v1.DeleteLicenseRequest]: @cloud_cpp_reference_link{google/cloud/compute/licenses/v1/licenses.proto#L157} + /// [google.cloud.cpp.compute.licenses.v1.DeleteLicenseRequest]: @cloud_cpp_reference_link{google/cloud/compute/licenses/v1/licenses.proto#L169} /// // clang-format on future> DeleteLicense( @@ -207,8 +211,9 @@ class LicensesClient { // clang-format off /// - /// Returns the specified License resource. *Caution* This resource is intended - /// for use only by third-party partners who are creating Cloud Marketplace + /// Returns the specified License resource. + /// *Caution* This resource is intended + /// for use only by third-party partners who are creatingCloud Marketplace /// images. /// https://cloud.google.com/compute/docs/reference/rest/v1/licenses/get /// @@ -227,8 +232,8 @@ class LicensesClient { /// [`future`]: @ref google::cloud::future /// [`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#L198} - /// [google.cloud.cpp.compute.v1.License]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_076.proto#L30} + /// [google.cloud.cpp.compute.licenses.v1.GetLicenseRequest]: @cloud_cpp_reference_link{google/cloud/compute/licenses/v1/licenses.proto#L213} + /// [google.cloud.cpp.compute.v1.License]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_092.proto#L33} /// // clang-format on StatusOr GetLicense( @@ -237,8 +242,9 @@ class LicensesClient { // clang-format off /// - /// Returns the specified License resource. *Caution* This resource is intended - /// for use only by third-party partners who are creating Cloud Marketplace + /// Returns the specified License resource. + /// *Caution* This resource is intended + /// for use only by third-party partners who are creatingCloud Marketplace /// images. /// https://cloud.google.com/compute/docs/reference/rest/v1/licenses/get /// @@ -261,8 +267,8 @@ class LicensesClient { /// [`future`]: @ref google::cloud::future /// [`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#L198} - /// [google.cloud.cpp.compute.v1.License]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_076.proto#L30} + /// [google.cloud.cpp.compute.licenses.v1.GetLicenseRequest]: @cloud_cpp_reference_link{google/cloud/compute/licenses/v1/licenses.proto#L213} + /// [google.cloud.cpp.compute.v1.License]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_092.proto#L33} /// // clang-format on StatusOr GetLicense( @@ -273,8 +279,10 @@ class LicensesClient { // clang-format off /// /// 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. + /// policy or resource exists. + /// *Caution* This resource is intended + /// for use only by third-party partners who are creatingCloud Marketplace + /// images. /// https://cloud.google.com/compute/docs/reference/rest/v1/licenses/getIamPolicy /// /// @param project Project ID for this request. @@ -292,8 +300,8 @@ class LicensesClient { /// [`future`]: @ref google::cloud::future /// [`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#L183} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} + /// [google.cloud.cpp.compute.licenses.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/licenses/v1/licenses.proto#L198} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr GetIamPolicy( @@ -303,8 +311,10 @@ class LicensesClient { // clang-format off /// /// 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. + /// policy or resource exists. + /// *Caution* This resource is intended + /// for use only by third-party partners who are creatingCloud Marketplace + /// images. /// https://cloud.google.com/compute/docs/reference/rest/v1/licenses/getIamPolicy /// /// @param request Unary RPCs, such as the one wrapped by this @@ -326,8 +336,8 @@ class LicensesClient { /// [`future`]: @ref google::cloud::future /// [`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#L183} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} + /// [google.cloud.cpp.compute.licenses.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/licenses/v1/licenses.proto#L198} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr GetIamPolicy( @@ -337,9 +347,10 @@ class LicensesClient { // clang-format off /// - /// 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. + /// Create a License resource in the specified project. + /// *Caution* This resource is intended + /// for use only by third-party partners who are creatingCloud Marketplace + /// images. /// https://cloud.google.com/compute/docs/reference/rest/v1/licenses/insert /// /// @param project Project ID for this request. @@ -364,7 +375,7 @@ class LicensesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.licenses.v1.InsertLicenseRequest]: @cloud_cpp_reference_link{google/cloud/compute/licenses/v1/licenses.proto#L209} + /// [google.cloud.cpp.compute.licenses.v1.InsertLicenseRequest]: @cloud_cpp_reference_link{google/cloud/compute/licenses/v1/licenses.proto#L224} /// // clang-format on future> InsertLicense( @@ -390,9 +401,10 @@ class LicensesClient { // clang-format off /// - /// 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. + /// Create a License resource in the specified project. + /// *Caution* This resource is intended + /// for use only by third-party partners who are creatingCloud Marketplace + /// images. /// https://cloud.google.com/compute/docs/reference/rest/v1/licenses/insert /// /// @param request Unary RPCs, such as the one wrapped by this @@ -421,7 +433,7 @@ class LicensesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.licenses.v1.InsertLicenseRequest]: @cloud_cpp_reference_link{google/cloud/compute/licenses/v1/licenses.proto#L209} + /// [google.cloud.cpp.compute.licenses.v1.InsertLicenseRequest]: @cloud_cpp_reference_link{google/cloud/compute/licenses/v1/licenses.proto#L224} /// // clang-format on future> InsertLicense( @@ -461,13 +473,15 @@ class LicensesClient { // clang-format off /// - /// 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. + /// 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 orwindows-cloud. + /// *Caution* This resource is intended + /// for use only by third-party partners who are creatingCloud Marketplace + /// images. /// https://cloud.google.com/compute/docs/reference/rest/v1/licenses/list /// /// @param project Project ID for this request. @@ -493,8 +507,8 @@ class LicensesClient { /// [`future`]: @ref google::cloud::future /// [`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#L235} - /// [google.cloud.cpp.compute.v1.License]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_076.proto#L30} + /// [google.cloud.cpp.compute.licenses.v1.ListLicensesRequest]: @cloud_cpp_reference_link{google/cloud/compute/licenses/v1/licenses.proto#L253} + /// [google.cloud.cpp.compute.v1.License]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_092.proto#L33} /// // clang-format on StreamRange ListLicenses( @@ -502,13 +516,15 @@ class LicensesClient { // clang-format off /// - /// 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. + /// 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 orwindows-cloud. + /// *Caution* This resource is intended + /// for use only by third-party partners who are creatingCloud Marketplace + /// images. /// https://cloud.google.com/compute/docs/reference/rest/v1/licenses/list /// /// @param request Unary RPCs, such as the one wrapped by this @@ -539,8 +555,8 @@ class LicensesClient { /// [`future`]: @ref google::cloud::future /// [`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#L235} - /// [google.cloud.cpp.compute.v1.License]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_076.proto#L30} + /// [google.cloud.cpp.compute.licenses.v1.ListLicensesRequest]: @cloud_cpp_reference_link{google/cloud/compute/licenses/v1/licenses.proto#L253} + /// [google.cloud.cpp.compute.v1.License]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_092.proto#L33} /// // clang-format on StreamRange ListLicenses( @@ -549,9 +565,11 @@ class LicensesClient { // clang-format off /// - /// 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. + /// 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 creatingCloud Marketplace + /// images. /// https://cloud.google.com/compute/docs/reference/rest/v1/licenses/setIamPolicy /// /// @param project Project ID for this request. @@ -570,8 +588,8 @@ class LicensesClient { /// [`future`]: @ref google::cloud::future /// [`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#L303} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} + /// [google.cloud.cpp.compute.licenses.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/licenses/v1/licenses.proto#L354} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr SetIamPolicy( @@ -582,9 +600,11 @@ class LicensesClient { // clang-format off /// - /// 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. + /// 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 creatingCloud Marketplace + /// images. /// https://cloud.google.com/compute/docs/reference/rest/v1/licenses/setIamPolicy /// /// @param request Unary RPCs, such as the one wrapped by this @@ -606,8 +626,8 @@ class LicensesClient { /// [`future`]: @ref google::cloud::future /// [`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#L303} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} + /// [google.cloud.cpp.compute.licenses.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/licenses/v1/licenses.proto#L354} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr SetIamPolicy( @@ -617,9 +637,10 @@ class LicensesClient { // clang-format off /// - /// 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. + /// Returns permissions that a caller has on the specified resource. + /// *Caution* This resource is intended + /// for use only by third-party partners who are creatingCloud Marketplace + /// images. /// https://cloud.google.com/compute/docs/reference/rest/v1/licenses/testIamPermissions /// /// @param project Project ID for this request. @@ -638,8 +659,8 @@ class LicensesClient { /// [`future`]: @ref google::cloud::future /// [`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#L319} - /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_145.proto#L30} + /// [google.cloud.cpp.compute.licenses.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/licenses/v1/licenses.proto#L370} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} /// // clang-format on StatusOr @@ -651,9 +672,10 @@ class LicensesClient { // clang-format off /// - /// 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. + /// Returns permissions that a caller has on the specified resource. + /// *Caution* This resource is intended + /// for use only by third-party partners who are creatingCloud Marketplace + /// images. /// https://cloud.google.com/compute/docs/reference/rest/v1/licenses/testIamPermissions /// /// @param request Unary RPCs, such as the one wrapped by this @@ -675,8 +697,8 @@ class LicensesClient { /// [`future`]: @ref google::cloud::future /// [`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#L319} - /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_145.proto#L30} + /// [google.cloud.cpp.compute.licenses.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/licenses/v1/licenses.proto#L370} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} /// // clang-format on StatusOr @@ -686,9 +708,10 @@ class LicensesClient { // clang-format off /// - /// Updates 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. + /// Updates a License resource in the specified project. + /// *Caution* This resource is intended + /// for use only by third-party partners who are creatingCloud Marketplace + /// images. /// https://cloud.google.com/compute/docs/reference/rest/v1/licenses/update /// /// @param project Project ID for this request. @@ -715,7 +738,7 @@ class LicensesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.licenses.v1.UpdateLicenseRequest]: @cloud_cpp_reference_link{google/cloud/compute/licenses/v1/licenses.proto#L334} + /// [google.cloud.cpp.compute.licenses.v1.UpdateLicenseRequest]: @cloud_cpp_reference_link{google/cloud/compute/licenses/v1/licenses.proto#L385} /// // clang-format on future> UpdateLicense( @@ -743,9 +766,10 @@ class LicensesClient { // clang-format off /// - /// Updates 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. + /// Updates a License resource in the specified project. + /// *Caution* This resource is intended + /// for use only by third-party partners who are creatingCloud Marketplace + /// images. /// https://cloud.google.com/compute/docs/reference/rest/v1/licenses/update /// /// @param request Unary RPCs, such as the one wrapped by this @@ -774,7 +798,7 @@ class LicensesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.licenses.v1.UpdateLicenseRequest]: @cloud_cpp_reference_link{google/cloud/compute/licenses/v1/licenses.proto#L334} + /// [google.cloud.cpp.compute.licenses.v1.UpdateLicenseRequest]: @cloud_cpp_reference_link{google/cloud/compute/licenses/v1/licenses.proto#L385} /// // clang-format on future> UpdateLicense( diff --git a/google/cloud/compute/licenses/v1/licenses_proto_export.h b/google/cloud/compute/licenses/v1/licenses_proto_export.h index d57c206a4b996..d2e0317bc3013 100644 --- a/google/cloud/compute/licenses/v1/licenses_proto_export.h +++ b/google/cloud/compute/licenses/v1/licenses_proto_export.h @@ -26,13 +26,13 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_LICENSES_V1_LICENSES_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include "google/cloud/compute/v1/internal/common_007.pb.h" -#include "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_029.pb.h" -#include "google/cloud/compute/v1/internal/common_031.pb.h" -#include "google/cloud/compute/v1/internal/common_047.pb.h" -#include "google/cloud/compute/v1/internal/common_076.pb.h" -#include "google/cloud/compute/v1/internal/common_145.pb.h" +#include "google/cloud/compute/v1/internal/common_009.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_038.pb.h" +#include "google/cloud/compute/v1/internal/common_040.pb.h" +#include "google/cloud/compute/v1/internal/common_057.pb.h" +#include "google/cloud/compute/v1/internal/common_092.pb.h" +#include "google/cloud/compute/v1/internal/common_171.pb.h" // 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 4897d96e3335f..a6cea5db70824 100644 --- a/google/cloud/compute/machine_images/v1/machine_images_client.h +++ b/google/cloud/compute/machine_images/v1/machine_images_client.h @@ -116,7 +116,7 @@ class MachineImagesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.machine_images.v1.DeleteMachineImageRequest]: @cloud_cpp_reference_link{google/cloud/compute/machine_images/v1/machine_images.proto#L144} + /// [google.cloud.cpp.compute.machine_images.v1.DeleteMachineImageRequest]: @cloud_cpp_reference_link{google/cloud/compute/machine_images/v1/machine_images.proto#L146} /// // clang-format on future> @@ -170,7 +170,7 @@ class MachineImagesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.machine_images.v1.DeleteMachineImageRequest]: @cloud_cpp_reference_link{google/cloud/compute/machine_images/v1/machine_images.proto#L144} + /// [google.cloud.cpp.compute.machine_images.v1.DeleteMachineImageRequest]: @cloud_cpp_reference_link{google/cloud/compute/machine_images/v1/machine_images.proto#L146} /// // clang-format on future> @@ -229,8 +229,8 @@ class MachineImagesClient { /// [`future`]: @ref google::cloud::future /// [`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#L185} - /// [google.cloud.cpp.compute.v1.MachineImage]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_079.proto#L33} + /// [google.cloud.cpp.compute.machine_images.v1.GetMachineImageRequest]: @cloud_cpp_reference_link{google/cloud/compute/machine_images/v1/machine_images.proto#L190} + /// [google.cloud.cpp.compute.v1.MachineImage]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_095.proto#L35} /// // clang-format on StatusOr GetMachineImage( @@ -261,8 +261,8 @@ class MachineImagesClient { /// [`future`]: @ref google::cloud::future /// [`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#L185} - /// [google.cloud.cpp.compute.v1.MachineImage]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_079.proto#L33} + /// [google.cloud.cpp.compute.machine_images.v1.GetMachineImageRequest]: @cloud_cpp_reference_link{google/cloud/compute/machine_images/v1/machine_images.proto#L190} + /// [google.cloud.cpp.compute.v1.MachineImage]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_095.proto#L35} /// // clang-format on StatusOr GetMachineImage( @@ -291,8 +291,8 @@ class MachineImagesClient { /// [`future`]: @ref google::cloud::future /// [`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#L170} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} + /// [google.cloud.cpp.compute.machine_images.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/machine_images/v1/machine_images.proto#L175} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr GetIamPolicy( @@ -324,8 +324,8 @@ class MachineImagesClient { /// [`future`]: @ref google::cloud::future /// [`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#L170} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} + /// [google.cloud.cpp.compute.machine_images.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/machine_images/v1/machine_images.proto#L175} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr GetIamPolicy( @@ -335,10 +335,11 @@ class MachineImagesClient { // clang-format off /// - /// 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. + /// 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. /// https://cloud.google.com/compute/docs/reference/rest/v1/machineImages/insert /// /// @param project Project ID for this request. @@ -363,7 +364,7 @@ class MachineImagesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.machine_images.v1.InsertMachineImageRequest]: @cloud_cpp_reference_link{google/cloud/compute/machine_images/v1/machine_images.proto#L196} + /// [google.cloud.cpp.compute.machine_images.v1.InsertMachineImageRequest]: @cloud_cpp_reference_link{google/cloud/compute/machine_images/v1/machine_images.proto#L201} /// // clang-format on future> @@ -391,10 +392,11 @@ class MachineImagesClient { // clang-format off /// - /// 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. + /// 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. /// https://cloud.google.com/compute/docs/reference/rest/v1/machineImages/insert /// /// @param request Unary RPCs, such as the one wrapped by this @@ -423,7 +425,7 @@ class MachineImagesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.machine_images.v1.InsertMachineImageRequest]: @cloud_cpp_reference_link{google/cloud/compute/machine_images/v1/machine_images.proto#L196} + /// [google.cloud.cpp.compute.machine_images.v1.InsertMachineImageRequest]: @cloud_cpp_reference_link{google/cloud/compute/machine_images/v1/machine_images.proto#L201} /// // clang-format on future> @@ -464,8 +466,8 @@ class MachineImagesClient { // clang-format off /// - /// Retrieves a list of machine images that are contained within the specified - /// project. + /// Retrieves a list of machine images that are contained within + /// the specified project. /// https://cloud.google.com/compute/docs/reference/rest/v1/machineImages/list /// /// @param project Project ID for this request. @@ -491,8 +493,8 @@ class MachineImagesClient { /// [`future`]: @ref google::cloud::future /// [`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#L225} - /// [google.cloud.cpp.compute.v1.MachineImage]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_079.proto#L33} + /// [google.cloud.cpp.compute.machine_images.v1.ListMachineImagesRequest]: @cloud_cpp_reference_link{google/cloud/compute/machine_images/v1/machine_images.proto#L233} + /// [google.cloud.cpp.compute.v1.MachineImage]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_095.proto#L35} /// // clang-format on StreamRange ListMachineImages( @@ -500,8 +502,8 @@ class MachineImagesClient { // clang-format off /// - /// Retrieves a list of machine images that are contained within the specified - /// project. + /// Retrieves a list of machine images that are contained within + /// the specified project. /// https://cloud.google.com/compute/docs/reference/rest/v1/machineImages/list /// /// @param request Unary RPCs, such as the one wrapped by this @@ -532,8 +534,8 @@ class MachineImagesClient { /// [`future`]: @ref google::cloud::future /// [`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#L225} - /// [google.cloud.cpp.compute.v1.MachineImage]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_079.proto#L33} + /// [google.cloud.cpp.compute.machine_images.v1.ListMachineImagesRequest]: @cloud_cpp_reference_link{google/cloud/compute/machine_images/v1/machine_images.proto#L233} + /// [google.cloud.cpp.compute.v1.MachineImage]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_095.proto#L35} /// // clang-format on StreamRange ListMachineImages( @@ -543,8 +545,8 @@ class MachineImagesClient { // clang-format off /// - /// Sets the access control policy on the specified resource. Replaces any - /// existing policy. + /// Sets the access control policy on the specified resource. + /// Replaces any existing policy. /// https://cloud.google.com/compute/docs/reference/rest/v1/machineImages/setIamPolicy /// /// @param project Project ID for this request. @@ -563,8 +565,8 @@ class MachineImagesClient { /// [`future`]: @ref google::cloud::future /// [`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#L293} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} + /// [google.cloud.cpp.compute.machine_images.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/machine_images/v1/machine_images.proto#L334} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr SetIamPolicy( @@ -575,8 +577,8 @@ class MachineImagesClient { // clang-format off /// - /// Sets the access control policy on the specified resource. Replaces any - /// existing policy. + /// Sets the access control policy on the specified resource. + /// Replaces any existing policy. /// https://cloud.google.com/compute/docs/reference/rest/v1/machineImages/setIamPolicy /// /// @param request Unary RPCs, such as the one wrapped by this @@ -598,8 +600,8 @@ class MachineImagesClient { /// [`future`]: @ref google::cloud::future /// [`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#L293} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} + /// [google.cloud.cpp.compute.machine_images.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/machine_images/v1/machine_images.proto#L334} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr SetIamPolicy( @@ -609,8 +611,9 @@ class MachineImagesClient { // clang-format off /// - /// Sets the labels on a machine image. To learn more about labels, read the - /// Labeling Resources documentation. + /// Sets the labels on a machine image. To learn more about labels, read + /// theLabeling + /// Resources documentation. /// https://cloud.google.com/compute/docs/reference/rest/v1/machineImages/setLabels /// /// @param project Project ID for this request. @@ -636,7 +639,7 @@ class MachineImagesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.machine_images.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/machine_images/v1/machine_images.proto#L309} + /// [google.cloud.cpp.compute.machine_images.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/machine_images/v1/machine_images.proto#L350} /// // clang-format on future> SetLabels( @@ -664,8 +667,9 @@ class MachineImagesClient { // clang-format off /// - /// Sets the labels on a machine image. To learn more about labels, read the - /// Labeling Resources documentation. + /// Sets the labels on a machine image. To learn more about labels, read + /// theLabeling + /// Resources documentation. /// https://cloud.google.com/compute/docs/reference/rest/v1/machineImages/setLabels /// /// @param request Unary RPCs, such as the one wrapped by this @@ -694,7 +698,7 @@ class MachineImagesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.machine_images.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/machine_images/v1/machine_images.proto#L309} + /// [google.cloud.cpp.compute.machine_images.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/machine_images/v1/machine_images.proto#L350} /// // clang-format on future> SetLabels( @@ -753,8 +757,8 @@ class MachineImagesClient { /// [`future`]: @ref google::cloud::future /// [`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#L328} - /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_145.proto#L30} + /// [google.cloud.cpp.compute.machine_images.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/machine_images/v1/machine_images.proto#L369} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} /// // clang-format on StatusOr @@ -788,8 +792,8 @@ class MachineImagesClient { /// [`future`]: @ref google::cloud::future /// [`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#L328} - /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_145.proto#L30} + /// [google.cloud.cpp.compute.machine_images.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/machine_images/v1/machine_images.proto#L369} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.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 7252eaec96f6b..e073eeaffaaa6 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 @@ -27,18 +27,18 @@ // IWYU pragma: begin_exports #include "google/cloud/compute/v1/internal/common_001.pb.h" -#include "google/cloud/compute/v1/internal/common_003.pb.h" -#include "google/cloud/compute/v1/internal/common_007.pb.h" -#include "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_021.pb.h" -#include "google/cloud/compute/v1/internal/common_029.pb.h" -#include "google/cloud/compute/v1/internal/common_031.pb.h" -#include "google/cloud/compute/v1/internal/common_033.pb.h" -#include "google/cloud/compute/v1/internal/common_046.pb.h" -#include "google/cloud/compute/v1/internal/common_047.pb.h" -#include "google/cloud/compute/v1/internal/common_079.pb.h" -#include "google/cloud/compute/v1/internal/common_081.pb.h" -#include "google/cloud/compute/v1/internal/common_145.pb.h" +#include "google/cloud/compute/v1/internal/common_004.pb.h" +#include "google/cloud/compute/v1/internal/common_009.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_028.pb.h" +#include "google/cloud/compute/v1/internal/common_038.pb.h" +#include "google/cloud/compute/v1/internal/common_040.pb.h" +#include "google/cloud/compute/v1/internal/common_042.pb.h" +#include "google/cloud/compute/v1/internal/common_056.pb.h" +#include "google/cloud/compute/v1/internal/common_057.pb.h" +#include "google/cloud/compute/v1/internal/common_095.pb.h" +#include "google/cloud/compute/v1/internal/common_096.pb.h" +#include "google/cloud/compute/v1/internal/common_171.pb.h" // 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 2b811b4919e3b..412eb572e97aa 100644 --- a/google/cloud/compute/machine_types/v1/machine_types_client.h +++ b/google/cloud/compute/machine_types/v1/machine_types_client.h @@ -89,8 +89,10 @@ class MachineTypesClient { // clang-format off /// - /// Retrieves an aggregated list of machine types. To prevent failure, Google - /// recommends that you set the `returnPartialSuccess` parameter to `true`. + /// Retrieves an aggregated list of machine types. + /// + /// To prevent failure, Google recommends that you set the + /// `returnPartialSuccess` parameter to `true`. /// https://cloud.google.com/compute/docs/reference/rest/v1/machineTypes/aggregatedList /// /// @param project Project ID for this request. @@ -116,8 +118,8 @@ class MachineTypesClient { /// [`future`]: @ref google::cloud::future /// [`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_080.proto#L324} + /// [google.cloud.cpp.compute.machine_types.v1.AggregatedListMachineTypesRequest]: @cloud_cpp_reference_link{google/cloud/compute/machine_types/v1/machine_types.proto#L74} + /// [google.cloud.cpp.compute.v1.MachineTypesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_021.proto#L382} /// // clang-format on StreamRange GetMachineType( @@ -221,8 +225,8 @@ class MachineTypesClient { /// [`future`]: @ref google::cloud::future /// [`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_080.proto#L29} + /// [google.cloud.cpp.compute.machine_types.v1.GetMachineTypeRequest]: @cloud_cpp_reference_link{google/cloud/compute/machine_types/v1/machine_types.proto#L189} + /// [google.cloud.cpp.compute.v1.MachineType]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_021.proto#L38} /// // clang-format on StatusOr GetMachineType( @@ -232,7 +236,8 @@ class MachineTypesClient { // clang-format off /// - /// Retrieves a list of machine types available to the specified project. + /// Retrieves a list of machine types available to the specified + /// project. /// https://cloud.google.com/compute/docs/reference/rest/v1/machineTypes/list /// /// @param project Project ID for this request. @@ -259,8 +264,8 @@ class MachineTypesClient { /// [`future`]: @ref google::cloud::future /// [`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_080.proto#L29} + /// [google.cloud.cpp.compute.machine_types.v1.ListMachineTypesRequest]: @cloud_cpp_reference_link{google/cloud/compute/machine_types/v1/machine_types.proto#L203} + /// [google.cloud.cpp.compute.v1.MachineType]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_021.proto#L38} /// // clang-format on StreamRange ListMachineTypes( @@ -268,7 +273,8 @@ class MachineTypesClient { // clang-format off /// - /// Retrieves a list of machine types available to the specified project. + /// Retrieves a list of machine types available to the specified + /// project. /// https://cloud.google.com/compute/docs/reference/rest/v1/machineTypes/list /// /// @param request Unary RPCs, such as the one wrapped by this @@ -299,8 +305,8 @@ class MachineTypesClient { /// [`future`]: @ref google::cloud::future /// [`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_080.proto#L29} + /// [google.cloud.cpp.compute.machine_types.v1.ListMachineTypesRequest]: @cloud_cpp_reference_link{google/cloud/compute/machine_types/v1/machine_types.proto#L203} + /// [google.cloud.cpp.compute.v1.MachineType]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_021.proto#L38} /// // 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 38e374ce17ad9..fc7c92344df94 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 "google/cloud/compute/v1/internal/common_023.pb.h" -#include "google/cloud/compute/v1/internal/common_080.pb.h" +#include "google/cloud/compute/v1/internal/common_021.pb.h" +#include "google/cloud/compute/v1/internal/common_032.pb.h" // 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 d06327d00dbb1..e4a9cdf7c5e34 100644 --- a/google/cloud/compute/network_attachments/v1/network_attachments_client.h +++ b/google/cloud/compute/network_attachments/v1/network_attachments_client.h @@ -92,9 +92,11 @@ class NetworkAttachmentsClient { // clang-format off /// - /// 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`. + /// 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`. /// https://cloud.google.com/compute/docs/reference/rest/v1/networkAttachments/aggregatedList /// /// @param project Project ID for this request. @@ -120,8 +122,8 @@ class NetworkAttachmentsClient { /// [`future`]: @ref google::cloud::future /// [`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_084.proto#L352} + /// [google.cloud.cpp.compute.network_attachments.v1.AggregatedListNetworkAttachmentsRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_attachments/v1/network_attachments.proto#L156} + /// [google.cloud.cpp.compute.v1.NetworkAttachmentsScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_099.proto#L408} /// // clang-format on StreamRange< @@ -132,9 +134,11 @@ class NetworkAttachmentsClient { // clang-format off /// - /// 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`. + /// 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`. /// https://cloud.google.com/compute/docs/reference/rest/v1/networkAttachments/aggregatedList /// /// @param request Unary RPCs, such as the one wrapped by this @@ -165,8 +169,8 @@ class NetworkAttachmentsClient { /// [`future`]: @ref google::cloud::future /// [`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_084.proto#L352} + /// [google.cloud.cpp.compute.network_attachments.v1.AggregatedListNetworkAttachmentsRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_attachments/v1/network_attachments.proto#L156} + /// [google.cloud.cpp.compute.v1.NetworkAttachmentsScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_099.proto#L408} /// // clang-format on StreamRange< @@ -205,7 +209,7 @@ class NetworkAttachmentsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.network_attachments.v1.DeleteNetworkAttachmentRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_attachments/v1/network_attachments.proto#L235} + /// [google.cloud.cpp.compute.network_attachments.v1.DeleteNetworkAttachmentRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_attachments/v1/network_attachments.proto#L271} /// // clang-format on future> @@ -259,7 +263,7 @@ class NetworkAttachmentsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.network_attachments.v1.DeleteNetworkAttachmentRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_attachments/v1/network_attachments.proto#L235} + /// [google.cloud.cpp.compute.network_attachments.v1.DeleteNetworkAttachmentRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_attachments/v1/network_attachments.proto#L271} /// // clang-format on future> @@ -319,8 +323,8 @@ class NetworkAttachmentsClient { /// [`future`]: @ref google::cloud::future /// [`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_084.proto#L25} + /// [google.cloud.cpp.compute.network_attachments.v1.GetNetworkAttachmentRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_attachments/v1/network_attachments.proto#L327} + /// [google.cloud.cpp.compute.v1.NetworkAttachment]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_099.proto#L26} /// // clang-format on StatusOr @@ -352,8 +356,8 @@ class NetworkAttachmentsClient { /// [`future`]: @ref google::cloud::future /// [`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_084.proto#L25} + /// [google.cloud.cpp.compute.network_attachments.v1.GetNetworkAttachmentRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_attachments/v1/network_attachments.proto#L327} + /// [google.cloud.cpp.compute.v1.NetworkAttachment]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_099.proto#L26} /// // clang-format on StatusOr @@ -383,8 +387,8 @@ class NetworkAttachmentsClient { /// [`future`]: @ref google::cloud::future /// [`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_007.proto#L178} + /// [google.cloud.cpp.compute.network_attachments.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_attachments/v1/network_attachments.proto#L308} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr GetIamPolicy( @@ -416,8 +420,8 @@ class NetworkAttachmentsClient { /// [`future`]: @ref google::cloud::future /// [`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_007.proto#L178} + /// [google.cloud.cpp.compute.network_attachments.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_attachments/v1/network_attachments.proto#L308} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr GetIamPolicy( @@ -454,7 +458,7 @@ class NetworkAttachmentsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.network_attachments.v1.InsertNetworkAttachmentRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_attachments/v1/network_attachments.proto#L303} + /// [google.cloud.cpp.compute.network_attachments.v1.InsertNetworkAttachmentRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_attachments/v1/network_attachments.proto#L342} /// // clang-format on future> @@ -513,7 +517,7 @@ class NetworkAttachmentsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.network_attachments.v1.InsertNetworkAttachmentRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_attachments/v1/network_attachments.proto#L303} + /// [google.cloud.cpp.compute.network_attachments.v1.InsertNetworkAttachmentRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_attachments/v1/network_attachments.proto#L342} /// // clang-format on future> @@ -581,8 +585,8 @@ class NetworkAttachmentsClient { /// [`future`]: @ref google::cloud::future /// [`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_084.proto#L25} + /// [google.cloud.cpp.compute.network_attachments.v1.ListNetworkAttachmentsRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_attachments/v1/network_attachments.proto#L379} + /// [google.cloud.cpp.compute.v1.NetworkAttachment]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_099.proto#L26} /// // clang-format on StreamRange @@ -622,8 +626,8 @@ class NetworkAttachmentsClient { /// [`future`]: @ref google::cloud::future /// [`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_084.proto#L25} + /// [google.cloud.cpp.compute.network_attachments.v1.ListNetworkAttachmentsRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_attachments/v1/network_attachments.proto#L379} + /// [google.cloud.cpp.compute.v1.NetworkAttachment]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_099.proto#L26} /// // clang-format on StreamRange @@ -634,8 +638,9 @@ class NetworkAttachmentsClient { // clang-format off /// /// 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. + /// the request. This method supports PATCH + /// semantics and usesJSON merge + /// patch format and processing rules. /// https://cloud.google.com/compute/docs/reference/rest/v1/networkAttachments/patch /// /// @param project Project ID for this request. @@ -662,7 +667,7 @@ class NetworkAttachmentsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.network_attachments.v1.PatchNetworkAttachmentRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_attachments/v1/network_attachments.proto#L409} + /// [google.cloud.cpp.compute.network_attachments.v1.PatchNetworkAttachmentRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_attachments/v1/network_attachments.proto#L484} /// // clang-format on future> @@ -694,8 +699,9 @@ class NetworkAttachmentsClient { // clang-format off /// /// 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. + /// the request. This method supports PATCH + /// semantics and usesJSON merge + /// patch format and processing rules. /// https://cloud.google.com/compute/docs/reference/rest/v1/networkAttachments/patch /// /// @param request Unary RPCs, such as the one wrapped by this @@ -724,7 +730,7 @@ class NetworkAttachmentsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.network_attachments.v1.PatchNetworkAttachmentRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_attachments/v1/network_attachments.proto#L409} + /// [google.cloud.cpp.compute.network_attachments.v1.PatchNetworkAttachmentRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_attachments/v1/network_attachments.proto#L484} /// // clang-format on future> @@ -765,8 +771,8 @@ class NetworkAttachmentsClient { // clang-format off /// - /// Sets the access control policy on the specified resource. Replaces any - /// existing policy. + /// Sets the access control policy on the specified resource. + /// Replaces any existing policy. /// https://cloud.google.com/compute/docs/reference/rest/v1/networkAttachments/setIamPolicy /// /// @param project Project ID for this request. @@ -786,8 +792,8 @@ class NetworkAttachmentsClient { /// [`future`]: @ref google::cloud::future /// [`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_007.proto#L178} + /// [google.cloud.cpp.compute.network_attachments.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_attachments/v1/network_attachments.proto#L525} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr SetIamPolicy( @@ -799,8 +805,8 @@ class NetworkAttachmentsClient { // clang-format off /// - /// Sets the access control policy on the specified resource. Replaces any - /// existing policy. + /// Sets the access control policy on the specified resource. + /// Replaces any existing policy. /// https://cloud.google.com/compute/docs/reference/rest/v1/networkAttachments/setIamPolicy /// /// @param request Unary RPCs, such as the one wrapped by this @@ -822,8 +828,8 @@ class NetworkAttachmentsClient { /// [`future`]: @ref google::cloud::future /// [`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_007.proto#L178} + /// [google.cloud.cpp.compute.network_attachments.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_attachments/v1/network_attachments.proto#L525} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr SetIamPolicy( @@ -853,8 +859,8 @@ class NetworkAttachmentsClient { /// [`future`]: @ref google::cloud::future /// [`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_145.proto#L30} + /// [google.cloud.cpp.compute.network_attachments.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_attachments/v1/network_attachments.proto#L545} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} /// // clang-format on StatusOr @@ -889,8 +895,8 @@ class NetworkAttachmentsClient { /// [`future`]: @ref google::cloud::future /// [`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_145.proto#L30} + /// [google.cloud.cpp.compute.network_attachments.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_attachments/v1/network_attachments.proto#L545} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.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 e714541e48486..efbc902007064 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 "google/cloud/compute/v1/internal/common_007.pb.h" -#include "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_031.pb.h" -#include "google/cloud/compute/v1/internal/common_084.pb.h" -#include "google/cloud/compute/v1/internal/common_108.pb.h" -#include "google/cloud/compute/v1/internal/common_145.pb.h" +#include "google/cloud/compute/v1/internal/common_009.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_040.pb.h" +#include "google/cloud/compute/v1/internal/common_099.pb.h" +#include "google/cloud/compute/v1/internal/common_126.pb.h" +#include "google/cloud/compute/v1/internal/common_171.pb.h" // 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 125c758d53123..bd3f2426c9d57 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 @@ -97,8 +97,10 @@ class NetworkEdgeSecurityServicesClient { // clang-format off /// /// 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`. + /// the specified project. + /// + /// To prevent failure, Google recommends that you set the + /// `returnPartialSuccess` parameter to `true`. /// https://cloud.google.com/compute/docs/reference/rest/v1/networkEdgeSecurityServices/aggregatedList /// /// @param project Name of the project scoping this request. @@ -124,8 +126,8 @@ class NetworkEdgeSecurityServicesClient { /// [`future`]: @ref google::cloud::future /// [`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_085.proto#L189} + /// [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#L108} + /// [google.cloud.cpp.compute.v1.NetworkEdgeSecurityServicesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_100.proto#L217} /// // clang-format on StreamRange> @@ -262,7 +266,7 @@ class NetworkEdgeSecurityServicesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.network_edge_security_services.v1.DeleteNetworkEdgeSecurityServiceRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_edge_security_services/v1/network_edge_security_services.proto#L188} + /// [google.cloud.cpp.compute.network_edge_security_services.v1.DeleteNetworkEdgeSecurityServiceRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_edge_security_services/v1/network_edge_security_services.proto#L223} /// // clang-format on future> @@ -324,8 +328,8 @@ class NetworkEdgeSecurityServicesClient { /// [`future`]: @ref google::cloud::future /// [`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_085.proto#L25} + /// [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#L261} + /// [google.cloud.cpp.compute.v1.NetworkEdgeSecurityService]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_100.proto#L25} /// // clang-format on StatusOr @@ -357,8 +361,8 @@ class NetworkEdgeSecurityServicesClient { /// [`future`]: @ref google::cloud::future /// [`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_085.proto#L25} + /// [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#L261} + /// [google.cloud.cpp.compute.v1.NetworkEdgeSecurityService]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_100.proto#L25} /// // clang-format on StatusOr @@ -396,7 +400,7 @@ class NetworkEdgeSecurityServicesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.network_edge_security_services.v1.InsertNetworkEdgeSecurityServiceRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_edge_security_services/v1/network_edge_security_services.proto#L240} + /// [google.cloud.cpp.compute.network_edge_security_services.v1.InsertNetworkEdgeSecurityServiceRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_edge_security_services/v1/network_edge_security_services.proto#L278} /// // clang-format on future> @@ -456,7 +460,7 @@ class NetworkEdgeSecurityServicesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.network_edge_security_services.v1.InsertNetworkEdgeSecurityServiceRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_edge_security_services/v1/network_edge_security_services.proto#L240} + /// [google.cloud.cpp.compute.network_edge_security_services.v1.InsertNetworkEdgeSecurityServiceRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_edge_security_services/v1/network_edge_security_services.proto#L278} /// // clang-format on future> @@ -527,7 +531,7 @@ class NetworkEdgeSecurityServicesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.network_edge_security_services.v1.PatchNetworkEdgeSecurityServiceRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_edge_security_services/v1/network_edge_security_services.proto#L277} + /// [google.cloud.cpp.compute.network_edge_security_services.v1.PatchNetworkEdgeSecurityServiceRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_edge_security_services/v1/network_edge_security_services.proto#L318} /// // clang-format on future> @@ -590,7 +594,7 @@ class NetworkEdgeSecurityServicesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.network_edge_security_services.v1.PatchNetworkEdgeSecurityServiceRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_edge_security_services/v1/network_edge_security_services.proto#L277} + /// [google.cloud.cpp.compute.network_edge_security_services.v1.PatchNetworkEdgeSecurityServiceRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_edge_security_services/v1/network_edge_security_services.proto#L318} /// // clang-format on future> 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 3298cb4063517..a4159d82e482d 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 "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_085.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_100.pb.h" // 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 4c8e4c4fa782f..3a1d74ee59d64 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 @@ -94,9 +94,10 @@ class NetworkEndpointGroupsClient { // clang-format off /// - /// 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`. + /// 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`. /// https://cloud.google.com/compute/docs/reference/rest/v1/networkEndpointGroups/aggregatedList /// /// @param project Project ID for this request. @@ -122,8 +123,8 @@ class NetworkEndpointGroupsClient { /// [`future`]: @ref google::cloud::future /// [`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_086.proto#L160} + /// [google.cloud.cpp.compute.network_endpoint_groups.v1.AggregatedListNetworkEndpointGroupsRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_endpoint_groups/v1/network_endpoint_groups.proto#L174} + /// [google.cloud.cpp.compute.v1.NetworkEndpointGroupsScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_101.proto#L183} /// // clang-format on StreamRange> @@ -270,7 +272,7 @@ class NetworkEndpointGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.network_endpoint_groups.v1.AttachNetworkEndpointsRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_endpoint_groups/v1/network_endpoint_groups.proto#L241} + /// [google.cloud.cpp.compute.network_endpoint_groups.v1.AttachNetworkEndpointsRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_endpoint_groups/v1/network_endpoint_groups.proto#L289} /// // clang-format on future> @@ -318,8 +320,8 @@ class NetworkEndpointGroupsClient { /// https://cloud.google.com/compute/docs/reference/rest/v1/networkEndpointGroups/delete /// /// @param project Project ID for this request. - /// @param zone The name of the zone where the network endpoint group is located. It should - /// comply with RFC1035. + /// @param zone The name of the zone where + /// the network endpoint group is located. It should comply with RFC1035. /// @param network_endpoint_group The name of the network endpoint group to delete. It should comply with /// RFC1035. /// @param opts Optional. Override the class-level options, such as retry and @@ -342,7 +344,7 @@ class NetworkEndpointGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.network_endpoint_groups.v1.DeleteNetworkEndpointGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_endpoint_groups/v1/network_endpoint_groups.proto#L284} + /// [google.cloud.cpp.compute.network_endpoint_groups.v1.DeleteNetworkEndpointGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_endpoint_groups/v1/network_endpoint_groups.proto#L335} /// // clang-format on future> @@ -402,7 +404,7 @@ class NetworkEndpointGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.network_endpoint_groups.v1.DeleteNetworkEndpointGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_endpoint_groups/v1/network_endpoint_groups.proto#L284} + /// [google.cloud.cpp.compute.network_endpoint_groups.v1.DeleteNetworkEndpointGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_endpoint_groups/v1/network_endpoint_groups.proto#L335} /// // clang-format on future> @@ -450,8 +452,8 @@ class NetworkEndpointGroupsClient { /// https://cloud.google.com/compute/docs/reference/rest/v1/networkEndpointGroups/detachNetworkEndpoints /// /// @param project Project ID for this request. - /// @param zone The name of the zone where the network endpoint group is located. It should - /// comply with RFC1035. + /// @param zone The name of the zone where + /// the network endpoint group is located. It should comply with RFC1035. /// @param network_endpoint_group The name of the network endpoint group where you are removing network /// endpoints. It should comply with RFC1035. /// @param network_endpoint_groups_detach_endpoints_request_resource The NetworkEndpointGroupsDetachEndpointsRequest for this request. @@ -475,7 +477,7 @@ class NetworkEndpointGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.network_endpoint_groups.v1.DetachNetworkEndpointsRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_endpoint_groups/v1/network_endpoint_groups.proto#L321} + /// [google.cloud.cpp.compute.network_endpoint_groups.v1.DetachNetworkEndpointsRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_endpoint_groups/v1/network_endpoint_groups.proto#L375} /// // clang-format on future> @@ -538,7 +540,7 @@ class NetworkEndpointGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.network_endpoint_groups.v1.DetachNetworkEndpointsRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_endpoint_groups/v1/network_endpoint_groups.proto#L321} + /// [google.cloud.cpp.compute.network_endpoint_groups.v1.DetachNetworkEndpointsRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_endpoint_groups/v1/network_endpoint_groups.proto#L375} /// // clang-format on future> @@ -583,8 +585,8 @@ class NetworkEndpointGroupsClient { /// https://cloud.google.com/compute/docs/reference/rest/v1/networkEndpointGroups/get /// /// @param project Project ID for this request. - /// @param zone The name of the zone where the network endpoint group is located. It should - /// comply with RFC1035. + /// @param zone The name of the zone where + /// the network endpoint group is located. It should comply with RFC1035. /// @param network_endpoint_group The name of the network endpoint group. It should comply with RFC1035. /// @param opts Optional. Override the class-level options, such as retry and /// backoff policies. @@ -599,8 +601,8 @@ class NetworkEndpointGroupsClient { /// [`future`]: @ref google::cloud::future /// [`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_012.proto#L131} + /// [google.cloud.cpp.compute.network_endpoint_groups.v1.GetNetworkEndpointGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_endpoint_groups/v1/network_endpoint_groups.proto#L421} + /// [google.cloud.cpp.compute.v1.NetworkEndpointGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_015.proto#L157} /// // clang-format on StatusOr @@ -632,8 +634,8 @@ class NetworkEndpointGroupsClient { /// [`future`]: @ref google::cloud::future /// [`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_012.proto#L131} + /// [google.cloud.cpp.compute.network_endpoint_groups.v1.GetNetworkEndpointGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_endpoint_groups/v1/network_endpoint_groups.proto#L421} + /// [google.cloud.cpp.compute.v1.NetworkEndpointGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_015.proto#L157} /// // clang-format on StatusOr @@ -645,11 +647,26 @@ class NetworkEndpointGroupsClient { /// /// Creates a network endpoint group in the specified project using the /// parameters that are included in the request. + /// + /// Note: Use the following APIs to manage network endpoint groups: + /// + /// - + /// To manage NEGs with zonal scope (such as zonal NEGs, hybrid connectivity + /// NEGs): zonal + /// API + /// - + /// To manage NEGs with regional scope (such as regional internet NEGs, + /// serverless NEGs, Private Service Connect NEGs): regional + /// API + /// - + /// To manage NEGs with global scope (such as global internet NEGs):global + /// API /// https://cloud.google.com/compute/docs/reference/rest/v1/networkEndpointGroups/insert /// /// @param project Project ID for this request. - /// @param zone The name of the zone where you want to create the network endpoint group. - /// It should comply with RFC1035. + /// @param zone The name of the zone where + /// you want to create the network endpoint group. It should comply with + /// RFC1035. /// @param network_endpoint_group_resource The NetworkEndpointGroup for this request. /// @param opts Optional. Override the class-level options, such as retry and /// backoff policies. @@ -671,7 +688,7 @@ class NetworkEndpointGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.network_endpoint_groups.v1.InsertNetworkEndpointGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_endpoint_groups/v1/network_endpoint_groups.proto#L381} + /// [google.cloud.cpp.compute.network_endpoint_groups.v1.InsertNetworkEndpointGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_endpoint_groups/v1/network_endpoint_groups.proto#L438} /// // clang-format on future> @@ -703,6 +720,20 @@ class NetworkEndpointGroupsClient { /// /// Creates a network endpoint group in the specified project using the /// parameters that are included in the request. + /// + /// Note: Use the following APIs to manage network endpoint groups: + /// + /// - + /// To manage NEGs with zonal scope (such as zonal NEGs, hybrid connectivity + /// NEGs): zonal + /// API + /// - + /// To manage NEGs with regional scope (such as regional internet NEGs, + /// serverless NEGs, Private Service Connect NEGs): regional + /// API + /// - + /// To manage NEGs with global scope (such as global internet NEGs):global + /// API /// https://cloud.google.com/compute/docs/reference/rest/v1/networkEndpointGroups/insert /// /// @param request Unary RPCs, such as the one wrapped by this @@ -731,7 +762,7 @@ class NetworkEndpointGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.network_endpoint_groups.v1.InsertNetworkEndpointGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_endpoint_groups/v1/network_endpoint_groups.proto#L381} + /// [google.cloud.cpp.compute.network_endpoint_groups.v1.InsertNetworkEndpointGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_endpoint_groups/v1/network_endpoint_groups.proto#L438} /// // clang-format on future> @@ -779,8 +810,8 @@ class NetworkEndpointGroupsClient { /// https://cloud.google.com/compute/docs/reference/rest/v1/networkEndpointGroups/list /// /// @param project Project ID for this request. - /// @param zone The name of the zone where the network endpoint group is located. It should - /// comply with RFC1035. + /// @param zone The name of thezone + /// where the network endpoint group is located. It should comply with RFC1035. /// @param opts Optional. Override the class-level options, such as retry and /// backoff policies. /// @return a [StreamRange](@ref google::cloud::StreamRange) @@ -803,8 +834,8 @@ class NetworkEndpointGroupsClient { /// [`future`]: @ref google::cloud::future /// [`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_012.proto#L131} + /// [google.cloud.cpp.compute.network_endpoint_groups.v1.ListNetworkEndpointGroupsRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_endpoint_groups/v1/network_endpoint_groups.proto#L476} + /// [google.cloud.cpp.compute.v1.NetworkEndpointGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_015.proto#L157} /// // clang-format on StreamRange @@ -845,8 +876,8 @@ class NetworkEndpointGroupsClient { /// [`future`]: @ref google::cloud::future /// [`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_012.proto#L131} + /// [google.cloud.cpp.compute.network_endpoint_groups.v1.ListNetworkEndpointGroupsRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_endpoint_groups/v1/network_endpoint_groups.proto#L476} + /// [google.cloud.cpp.compute.v1.NetworkEndpointGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_015.proto#L157} /// // clang-format on StreamRange @@ -861,8 +892,8 @@ class NetworkEndpointGroupsClient { /// https://cloud.google.com/compute/docs/reference/rest/v1/networkEndpointGroups/listNetworkEndpoints /// /// @param project Project ID for this request. - /// @param zone The name of the zone where the network endpoint group is located. It should - /// comply with RFC1035. + /// @param zone The name of the zone where + /// the network endpoint group is located. It should comply with RFC1035. /// @param network_endpoint_group The name of the network endpoint group from which you want to generate a /// list of included network endpoints. It should comply with RFC1035. /// @param network_endpoint_groups_list_endpoints_request_resource The NetworkEndpointGroupsListEndpointsRequest for this request. @@ -888,8 +919,8 @@ class NetworkEndpointGroupsClient { /// [`future`]: @ref google::cloud::future /// [`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_012.proto#L548} + /// [google.cloud.cpp.compute.network_endpoint_groups.v1.ListNetworkEndpointsRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_endpoint_groups/v1/network_endpoint_groups.proto#L581} + /// [google.cloud.cpp.compute.v1.NetworkEndpointWithHealthStatus]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_015.proto#L678} /// // clang-format on StreamRange @@ -934,8 +965,8 @@ class NetworkEndpointGroupsClient { /// [`future`]: @ref google::cloud::future /// [`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_012.proto#L548} + /// [google.cloud.cpp.compute.network_endpoint_groups.v1.ListNetworkEndpointsRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_endpoint_groups/v1/network_endpoint_groups.proto#L581} + /// [google.cloud.cpp.compute.v1.NetworkEndpointWithHealthStatus]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_015.proto#L678} /// // clang-format on StreamRange @@ -965,8 +996,8 @@ class NetworkEndpointGroupsClient { /// [`future`]: @ref google::cloud::future /// [`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_145.proto#L30} + /// [google.cloud.cpp.compute.network_endpoint_groups.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_endpoint_groups/v1/network_endpoint_groups.proto#L698} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} /// // clang-format on StatusOr @@ -1001,8 +1032,8 @@ class NetworkEndpointGroupsClient { /// [`future`]: @ref google::cloud::future /// [`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_145.proto#L30} + /// [google.cloud.cpp.compute.network_endpoint_groups.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_endpoint_groups/v1/network_endpoint_groups.proto#L698} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.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 c878ac3acd9f5..ddd22a42a1dba 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 "google/cloud/compute/v1/internal/common_012.pb.h" -#include "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_049.pb.h" -#include "google/cloud/compute/v1/internal/common_086.pb.h" -#include "google/cloud/compute/v1/internal/common_145.pb.h" +#include "google/cloud/compute/v1/internal/common_015.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_061.pb.h" +#include "google/cloud/compute/v1/internal/common_101.pb.h" +#include "google/cloud/compute/v1/internal/common_171.pb.h" // 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 e273476eb156c..f1c57f4e5820e 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 @@ -120,7 +120,7 @@ class NetworkFirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.network_firewall_policies.v1.AddAssociationRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L297} + /// [google.cloud.cpp.compute.network_firewall_policies.v1.AddAssociationRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L299} /// // clang-format on future> AddAssociation( @@ -178,7 +178,7 @@ class NetworkFirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.network_firewall_policies.v1.AddAssociationRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L297} + /// [google.cloud.cpp.compute.network_firewall_policies.v1.AddAssociationRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L299} /// // clang-format on future> AddAssociation( @@ -244,7 +244,7 @@ class NetworkFirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.network_firewall_policies.v1.AddPacketMirroringRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L334} + /// [google.cloud.cpp.compute.network_firewall_policies.v1.AddPacketMirroringRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L339} /// // clang-format on future> @@ -303,7 +303,7 @@ class NetworkFirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.network_firewall_policies.v1.AddPacketMirroringRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L334} + /// [google.cloud.cpp.compute.network_firewall_policies.v1.AddPacketMirroringRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L339} /// // clang-format on future> @@ -371,7 +371,7 @@ class NetworkFirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.network_firewall_policies.v1.AddRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L372} + /// [google.cloud.cpp.compute.network_firewall_policies.v1.AddRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L382} /// // clang-format on future> AddRule( @@ -429,7 +429,7 @@ class NetworkFirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.network_firewall_policies.v1.AddRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L372} + /// [google.cloud.cpp.compute.network_firewall_policies.v1.AddRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L382} /// // clang-format on future> AddRule( @@ -471,8 +471,10 @@ class NetworkFirewallPoliciesClient { /// /// Retrieves an aggregated list of network firewall policies, listing network /// firewall policies from all applicable scopes (global and regional) and - /// grouping the results per scope. To prevent failure, Google recommends that - /// you set the `returnPartialSuccess` parameter to `true`. + /// grouping the results per scope. + /// + /// To prevent failure, it is recommended that you set the + /// `returnPartialSuccess` parameter to `true`. /// https://cloud.google.com/compute/docs/reference/rest/v1/networkFirewallPolicies/aggregatedList /// /// @param project Project ID for this request. @@ -498,8 +500,8 @@ class NetworkFirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.network_firewall_policies.v1.AggregatedListNetworkFirewallPoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L410} - /// [google.cloud.cpp.compute.v1.FirewallPoliciesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_037.proto#L26} + /// [google.cloud.cpp.compute.network_firewall_policies.v1.AggregatedListNetworkFirewallPoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L425} + /// [google.cloud.cpp.compute.v1.FirewallPoliciesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_046.proto#L26} /// // clang-format on StreamRange> CloneRules( @@ -634,7 +638,7 @@ class NetworkFirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.network_firewall_policies.v1.CloneRulesRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L492} + /// [google.cloud.cpp.compute.network_firewall_policies.v1.CloneRulesRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L540} /// // clang-format on future> CloneRules( @@ -699,7 +703,7 @@ class NetworkFirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.network_firewall_policies.v1.DeleteFirewallPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L522} + /// [google.cloud.cpp.compute.network_firewall_policies.v1.DeleteFirewallPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L573} /// // clang-format on future> @@ -752,7 +756,7 @@ class NetworkFirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.network_firewall_policies.v1.DeleteFirewallPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L522} + /// [google.cloud.cpp.compute.network_firewall_policies.v1.DeleteFirewallPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L573} /// // clang-format on future> @@ -811,8 +815,8 @@ class NetworkFirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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#L562} - /// [google.cloud.cpp.compute.v1.FirewallPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_038.proto#L27} + /// [google.cloud.cpp.compute.network_firewall_policies.v1.GetFirewallPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L616} + /// [google.cloud.cpp.compute.v1.FirewallPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_047.proto#L27} /// // clang-format on StatusOr GetFirewallPolicy( @@ -843,8 +847,8 @@ class NetworkFirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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#L562} - /// [google.cloud.cpp.compute.v1.FirewallPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_038.proto#L27} + /// [google.cloud.cpp.compute.network_firewall_policies.v1.GetFirewallPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L616} + /// [google.cloud.cpp.compute.v1.FirewallPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_047.proto#L27} /// // clang-format on StatusOr GetFirewallPolicy( @@ -872,8 +876,8 @@ class NetworkFirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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#L548} - /// [google.cloud.cpp.compute.v1.FirewallPolicyAssociation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_038.proto#L115} + /// [google.cloud.cpp.compute.network_firewall_policies.v1.GetAssociationRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L602} + /// [google.cloud.cpp.compute.v1.FirewallPolicyAssociation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_047.proto#L132} /// // clang-format on StatusOr @@ -904,8 +908,8 @@ class NetworkFirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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#L548} - /// [google.cloud.cpp.compute.v1.FirewallPolicyAssociation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_038.proto#L115} + /// [google.cloud.cpp.compute.network_firewall_policies.v1.GetAssociationRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L602} + /// [google.cloud.cpp.compute.v1.FirewallPolicyAssociation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_047.proto#L132} /// // clang-format on StatusOr @@ -934,8 +938,8 @@ class NetworkFirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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#L573} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} + /// [google.cloud.cpp.compute.network_firewall_policies.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L627} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr GetIamPolicy( @@ -967,8 +971,8 @@ class NetworkFirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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#L573} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} + /// [google.cloud.cpp.compute.network_firewall_policies.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L627} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr GetIamPolicy( @@ -996,8 +1000,8 @@ class NetworkFirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.network_firewall_policies.v1.GetPacketMirroringRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L588} - /// [google.cloud.cpp.compute.v1.FirewallPolicyRule]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_039.proto#L26} + /// [google.cloud.cpp.compute.network_firewall_policies.v1.GetPacketMirroringRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L642} + /// [google.cloud.cpp.compute.v1.FirewallPolicyRule]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_048.proto#L26} /// // clang-format on StatusOr @@ -1028,8 +1032,8 @@ class NetworkFirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.network_firewall_policies.v1.GetPacketMirroringRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L588} - /// [google.cloud.cpp.compute.v1.FirewallPolicyRule]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_039.proto#L26} + /// [google.cloud.cpp.compute.network_firewall_policies.v1.GetPacketMirroringRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L642} + /// [google.cloud.cpp.compute.v1.FirewallPolicyRule]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_048.proto#L26} /// // clang-format on StatusOr @@ -1058,8 +1062,8 @@ class NetworkFirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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#L602} - /// [google.cloud.cpp.compute.v1.FirewallPolicyRule]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_039.proto#L26} + /// [google.cloud.cpp.compute.network_firewall_policies.v1.GetRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L656} + /// [google.cloud.cpp.compute.v1.FirewallPolicyRule]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_048.proto#L26} /// // clang-format on StatusOr GetRule( @@ -1090,8 +1094,8 @@ class NetworkFirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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#L602} - /// [google.cloud.cpp.compute.v1.FirewallPolicyRule]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_039.proto#L26} + /// [google.cloud.cpp.compute.network_firewall_policies.v1.GetRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L656} + /// [google.cloud.cpp.compute.v1.FirewallPolicyRule]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_048.proto#L26} /// // clang-format on StatusOr GetRule( @@ -1127,7 +1131,7 @@ class NetworkFirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.network_firewall_policies.v1.InsertFirewallPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L616} + /// [google.cloud.cpp.compute.network_firewall_policies.v1.InsertFirewallPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L670} /// // clang-format on future> @@ -1185,7 +1189,7 @@ class NetworkFirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.network_firewall_policies.v1.InsertFirewallPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L616} + /// [google.cloud.cpp.compute.network_firewall_policies.v1.InsertFirewallPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L670} /// // clang-format on future> @@ -1252,8 +1256,8 @@ class NetworkFirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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#L642} - /// [google.cloud.cpp.compute.v1.FirewallPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_038.proto#L27} + /// [google.cloud.cpp.compute.network_firewall_policies.v1.ListNetworkFirewallPoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L699} + /// [google.cloud.cpp.compute.v1.FirewallPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_047.proto#L27} /// // clang-format on StreamRange @@ -1292,8 +1296,8 @@ class NetworkFirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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#L642} - /// [google.cloud.cpp.compute.v1.FirewallPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_038.proto#L27} + /// [google.cloud.cpp.compute.network_firewall_policies.v1.ListNetworkFirewallPoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L699} + /// [google.cloud.cpp.compute.v1.FirewallPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_047.proto#L27} /// // clang-format on StreamRange @@ -1330,7 +1334,7 @@ class NetworkFirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.network_firewall_policies.v1.PatchFirewallPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L710} + /// [google.cloud.cpp.compute.network_firewall_policies.v1.PatchFirewallPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L800} /// // clang-format on future> @@ -1389,7 +1393,7 @@ class NetworkFirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.network_firewall_policies.v1.PatchFirewallPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L710} + /// [google.cloud.cpp.compute.network_firewall_policies.v1.PatchFirewallPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L800} /// // clang-format on future> @@ -1456,7 +1460,7 @@ class NetworkFirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.network_firewall_policies.v1.PatchPacketMirroringRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L740} + /// [google.cloud.cpp.compute.network_firewall_policies.v1.PatchPacketMirroringRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L833} /// // clang-format on future> @@ -1515,7 +1519,7 @@ class NetworkFirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.network_firewall_policies.v1.PatchPacketMirroringRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L740} + /// [google.cloud.cpp.compute.network_firewall_policies.v1.PatchPacketMirroringRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L833} /// // clang-format on future> @@ -1583,7 +1587,7 @@ class NetworkFirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.network_firewall_policies.v1.PatchRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L773} + /// [google.cloud.cpp.compute.network_firewall_policies.v1.PatchRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L869} /// // clang-format on future> PatchRule( @@ -1641,7 +1645,7 @@ class NetworkFirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.network_firewall_policies.v1.PatchRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L773} + /// [google.cloud.cpp.compute.network_firewall_policies.v1.PatchRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L869} /// // clang-format on future> PatchRule( @@ -1706,7 +1710,7 @@ class NetworkFirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.network_firewall_policies.v1.RemoveAssociationRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L806} + /// [google.cloud.cpp.compute.network_firewall_policies.v1.RemoveAssociationRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L905} /// // clang-format on future> @@ -1759,7 +1763,7 @@ class NetworkFirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.network_firewall_policies.v1.RemoveAssociationRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L806} + /// [google.cloud.cpp.compute.network_firewall_policies.v1.RemoveAssociationRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L905} /// // clang-format on future> @@ -1824,7 +1828,7 @@ class NetworkFirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.network_firewall_policies.v1.RemovePacketMirroringRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L835} + /// [google.cloud.cpp.compute.network_firewall_policies.v1.RemovePacketMirroringRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L937} /// // clang-format on future> @@ -1879,7 +1883,7 @@ class NetworkFirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.network_firewall_policies.v1.RemovePacketMirroringRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L835} + /// [google.cloud.cpp.compute.network_firewall_policies.v1.RemovePacketMirroringRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L937} /// // clang-format on future> @@ -1947,7 +1951,7 @@ class NetworkFirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.network_firewall_policies.v1.RemoveRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L864} + /// [google.cloud.cpp.compute.network_firewall_policies.v1.RemoveRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L969} /// // clang-format on future> RemoveRule( @@ -2000,7 +2004,7 @@ class NetworkFirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.network_firewall_policies.v1.RemoveRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L864} + /// [google.cloud.cpp.compute.network_firewall_policies.v1.RemoveRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L969} /// // clang-format on future> RemoveRule( @@ -2040,8 +2044,8 @@ class NetworkFirewallPoliciesClient { // clang-format off /// - /// Sets the access control policy on the specified resource. Replaces any - /// existing policy. + /// Sets the access control policy on the specified resource. + /// Replaces any existing policy. /// https://cloud.google.com/compute/docs/reference/rest/v1/networkFirewallPolicies/setIamPolicy /// /// @param project Project ID for this request. @@ -2060,8 +2064,8 @@ class NetworkFirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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#L893} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} + /// [google.cloud.cpp.compute.network_firewall_policies.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L1001} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr SetIamPolicy( @@ -2072,8 +2076,8 @@ class NetworkFirewallPoliciesClient { // clang-format off /// - /// Sets the access control policy on the specified resource. Replaces any - /// existing policy. + /// Sets the access control policy on the specified resource. + /// Replaces any existing policy. /// https://cloud.google.com/compute/docs/reference/rest/v1/networkFirewallPolicies/setIamPolicy /// /// @param request Unary RPCs, such as the one wrapped by this @@ -2095,8 +2099,8 @@ class NetworkFirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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#L893} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} + /// [google.cloud.cpp.compute.network_firewall_policies.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L1001} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr SetIamPolicy( @@ -2125,8 +2129,8 @@ class NetworkFirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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#L909} - /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_145.proto#L30} + /// [google.cloud.cpp.compute.network_firewall_policies.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L1017} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} /// // clang-format on StatusOr @@ -2160,8 +2164,8 @@ class NetworkFirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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#L909} - /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_145.proto#L30} + /// [google.cloud.cpp.compute.network_firewall_policies.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L1017} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.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 b79d4dd7d1912..5c88069c1ef47 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,14 +26,14 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_NETWORK_FIREWALL_POLICIES_V1_NETWORK_FIREWALL_POLICIES_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include "google/cloud/compute/v1/internal/common_007.pb.h" -#include "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_031.pb.h" -#include "google/cloud/compute/v1/internal/common_037.pb.h" -#include "google/cloud/compute/v1/internal/common_038.pb.h" -#include "google/cloud/compute/v1/internal/common_039.pb.h" +#include "google/cloud/compute/v1/internal/common_009.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_040.pb.h" +#include "google/cloud/compute/v1/internal/common_046.pb.h" #include "google/cloud/compute/v1/internal/common_047.pb.h" -#include "google/cloud/compute/v1/internal/common_145.pb.h" +#include "google/cloud/compute/v1/internal/common_048.pb.h" +#include "google/cloud/compute/v1/internal/common_057.pb.h" +#include "google/cloud/compute/v1/internal/common_171.pb.h" // 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/network_profiles/v1/network_profiles_client.h b/google/cloud/compute/network_profiles/v1/network_profiles_client.h index 03d692470f675..0fb6fcdf1245a 100644 --- a/google/cloud/compute/network_profiles/v1/network_profiles_client.h +++ b/google/cloud/compute/network_profiles/v1/network_profiles_client.h @@ -106,8 +106,8 @@ class NetworkProfilesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.network_profiles.v1.GetNetworkProfileRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_profiles/v1/network_profiles.proto#L60} - /// [google.cloud.cpp.compute.v1.NetworkProfile]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_087.proto#L25} + /// [google.cloud.cpp.compute.network_profiles.v1.GetNetworkProfileRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_profiles/v1/network_profiles.proto#L61} + /// [google.cloud.cpp.compute.v1.NetworkProfile]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_102.proto#L25} /// // clang-format on StatusOr GetNetworkProfile( @@ -138,8 +138,8 @@ class NetworkProfilesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.network_profiles.v1.GetNetworkProfileRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_profiles/v1/network_profiles.proto#L60} - /// [google.cloud.cpp.compute.v1.NetworkProfile]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_087.proto#L25} + /// [google.cloud.cpp.compute.network_profiles.v1.GetNetworkProfileRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_profiles/v1/network_profiles.proto#L61} + /// [google.cloud.cpp.compute.v1.NetworkProfile]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_102.proto#L25} /// // clang-format on StatusOr GetNetworkProfile( @@ -149,7 +149,8 @@ class NetworkProfilesClient { // clang-format off /// - /// Retrieves a list of network profiles available to the specified project. + /// Retrieves a list of network profiles available to the specified + /// project. /// https://cloud.google.com/compute/docs/reference/rest/v1/networkProfiles/list /// /// @param project Project ID for this request. @@ -175,8 +176,8 @@ class NetworkProfilesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.network_profiles.v1.ListNetworkProfilesRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_profiles/v1/network_profiles.proto#L71} - /// [google.cloud.cpp.compute.v1.NetworkProfile]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_087.proto#L25} + /// [google.cloud.cpp.compute.network_profiles.v1.ListNetworkProfilesRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_profiles/v1/network_profiles.proto#L72} + /// [google.cloud.cpp.compute.v1.NetworkProfile]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_102.proto#L25} /// // clang-format on StreamRange @@ -184,7 +185,8 @@ class NetworkProfilesClient { // clang-format off /// - /// Retrieves a list of network profiles available to the specified project. + /// Retrieves a list of network profiles available to the specified + /// project. /// https://cloud.google.com/compute/docs/reference/rest/v1/networkProfiles/list /// /// @param request Unary RPCs, such as the one wrapped by this @@ -215,8 +217,8 @@ class NetworkProfilesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.network_profiles.v1.ListNetworkProfilesRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_profiles/v1/network_profiles.proto#L71} - /// [google.cloud.cpp.compute.v1.NetworkProfile]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_087.proto#L25} + /// [google.cloud.cpp.compute.network_profiles.v1.ListNetworkProfilesRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_profiles/v1/network_profiles.proto#L72} + /// [google.cloud.cpp.compute.v1.NetworkProfile]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_102.proto#L25} /// // clang-format on StreamRange diff --git a/google/cloud/compute/network_profiles/v1/network_profiles_proto_export.h b/google/cloud/compute/network_profiles/v1/network_profiles_proto_export.h index 859d60f5ce192..8c859d0a40945 100644 --- a/google/cloud/compute/network_profiles/v1/network_profiles_proto_export.h +++ b/google/cloud/compute/network_profiles/v1/network_profiles_proto_export.h @@ -26,7 +26,7 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_NETWORK_PROFILES_V1_NETWORK_PROFILES_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include "google/cloud/compute/v1/internal/common_087.pb.h" +#include "google/cloud/compute/v1/internal/common_102.pb.h" // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_NETWORK_PROFILES_V1_NETWORK_PROFILES_PROTO_EXPORT_H diff --git a/google/cloud/compute/networks/v1/internal/networks_rest_connection_impl.cc b/google/cloud/compute/networks/v1/internal/networks_rest_connection_impl.cc index ae03077ae4b7d..53756c8c9eb57 100644 --- a/google/cloud/compute/networks/v1/internal/networks_rest_connection_impl.cc +++ b/google/cloud/compute/networks/v1/internal/networks_rest_connection_impl.cc @@ -172,6 +172,134 @@ NetworksRestConnectionImpl::AddPeering( }); } +future> +NetworksRestConnectionImpl::CancelRequestRemovePeering( + google::cloud::cpp::compute::networks::v1:: + CancelRequestRemovePeeringRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::global_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, request, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::networks::v1:: + CancelRequestRemovePeeringRequest const& request) { + return stub->AsyncCancelRequestRemovePeering( + cq, std::move(context), std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->CancelRequestRemovePeering(request), + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [request](std::string const& op, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest& r) { + r.set_project(request.project()); + r.set_operation(op); + }, + [request](std::string const& op, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest& r) { + r.set_project(request.project()); + r.set_operation(op); + }); +} + +StatusOr +NetworksRestConnectionImpl::CancelRequestRemovePeering( + NoAwaitTag, google::cloud::cpp::compute::networks::v1:: + CancelRequestRemovePeeringRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->CancelRequestRemovePeering(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::networks::v1:: + CancelRequestRemovePeeringRequest const& request) { + return stub_->CancelRequestRemovePeering(rest_context, options, + request); + }, + *current, request, __func__); +} + +future> +NetworksRestConnectionImpl::CancelRequestRemovePeering( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestAwaitLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::global_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, operation, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [operation](std::string const&, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_operation(info.operation); + }, + [operation](std::string const&, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_operation(info.operation); + }); +} + future> NetworksRestConnectionImpl::DeleteNetwork( google::cloud::cpp::compute::networks::v1::DeleteNetworkRequest const& @@ -796,6 +924,133 @@ NetworksRestConnectionImpl::RemovePeering( }); } +future> +NetworksRestConnectionImpl::RequestRemovePeering( + google::cloud::cpp::compute::networks::v1:: + RequestRemovePeeringRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::global_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, request, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::networks::v1:: + RequestRemovePeeringRequest const& request) { + return stub->AsyncRequestRemovePeering(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->RequestRemovePeering(request), + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [request](std::string const& op, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest& r) { + r.set_project(request.project()); + r.set_operation(op); + }, + [request](std::string const& op, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest& r) { + r.set_project(request.project()); + r.set_operation(op); + }); +} + +StatusOr +NetworksRestConnectionImpl::RequestRemovePeering( + NoAwaitTag, google::cloud::cpp::compute::networks::v1:: + RequestRemovePeeringRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->RequestRemovePeering(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::networks::v1:: + RequestRemovePeeringRequest const& request) { + return stub_->RequestRemovePeering(rest_context, options, request); + }, + *current, request, __func__); +} + +future> +NetworksRestConnectionImpl::RequestRemovePeering( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestAwaitLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::global_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, operation, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [operation](std::string const&, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_operation(info.operation); + }, + [operation](std::string const&, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_operation(info.operation); + }); +} + future> NetworksRestConnectionImpl::SwitchToCustomMode( google::cloud::cpp::compute::networks::v1::SwitchToCustomModeRequest const& diff --git a/google/cloud/compute/networks/v1/internal/networks_rest_connection_impl.h b/google/cloud/compute/networks/v1/internal/networks_rest_connection_impl.h index f190b4f89410c..9cfab1cc7c81e 100644 --- a/google/cloud/compute/networks/v1/internal/networks_rest_connection_impl.h +++ b/google/cloud/compute/networks/v1/internal/networks_rest_connection_impl.h @@ -62,6 +62,21 @@ class NetworksRestConnectionImpl future> AddPeering( google::cloud::cpp::compute::v1::Operation const& operation) override; + future> + CancelRequestRemovePeering( + google::cloud::cpp::compute::networks::v1:: + CancelRequestRemovePeeringRequest const& request) override; + + StatusOr + CancelRequestRemovePeering( + NoAwaitTag, + google::cloud::cpp::compute::networks::v1:: + CancelRequestRemovePeeringRequest const& request) override; + + future> + CancelRequestRemovePeering( + google::cloud::cpp::compute::v1::Operation const& operation) override; + future> DeleteNetwork( google::cloud::cpp::compute::networks::v1::DeleteNetworkRequest const& request) override; @@ -129,6 +144,18 @@ class NetworksRestConnectionImpl future> RemovePeering( google::cloud::cpp::compute::v1::Operation const& operation) override; + future> + RequestRemovePeering(google::cloud::cpp::compute::networks::v1:: + RequestRemovePeeringRequest const& request) override; + + StatusOr RequestRemovePeering( + NoAwaitTag, google::cloud::cpp::compute::networks::v1:: + RequestRemovePeeringRequest const& request) override; + + future> + RequestRemovePeering( + google::cloud::cpp::compute::v1::Operation const& operation) override; + future> SwitchToCustomMode(google::cloud::cpp::compute::networks::v1:: SwitchToCustomModeRequest const& request) override; diff --git a/google/cloud/compute/networks/v1/internal/networks_rest_logging_decorator.cc b/google/cloud/compute/networks/v1/internal/networks_rest_logging_decorator.cc index f1eda34b1dd1c..6213f1a21dd5d 100644 --- a/google/cloud/compute/networks/v1/internal/networks_rest_logging_decorator.cc +++ b/google/cloud/compute/networks/v1/internal/networks_rest_logging_decorator.cc @@ -68,6 +68,41 @@ NetworksRestLogging::AddPeering( rest_context, options, request, __func__, tracing_options_); } +future> +NetworksRestLogging::AsyncCancelRequestRemovePeering( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::networks::v1:: + CancelRequestRemovePeeringRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::networks::v1:: + CancelRequestRemovePeeringRequest const& request) { + return child_->AsyncCancelRequestRemovePeering( + cq, std::move(rest_context), std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +StatusOr +NetworksRestLogging::CancelRequestRemovePeering( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::networks::v1:: + CancelRequestRemovePeeringRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::networks::v1:: + CancelRequestRemovePeeringRequest const& request) { + return child_->CancelRequestRemovePeering(rest_context, options, + request); + }, + rest_context, options, request, __func__, tracing_options_); +} + future> NetworksRestLogging::AsyncDeleteNetwork( CompletionQueue& cq, @@ -269,6 +304,40 @@ NetworksRestLogging::RemovePeering( rest_context, options, request, __func__, tracing_options_); } +future> +NetworksRestLogging::AsyncRequestRemovePeering( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::networks::v1:: + RequestRemovePeeringRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::networks::v1:: + RequestRemovePeeringRequest const& request) { + return child_->AsyncRequestRemovePeering(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +StatusOr +NetworksRestLogging::RequestRemovePeering( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::networks::v1:: + RequestRemovePeeringRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::networks::v1:: + RequestRemovePeeringRequest const& request) { + return child_->RequestRemovePeering(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + future> NetworksRestLogging::AsyncSwitchToCustomMode( CompletionQueue& cq, diff --git a/google/cloud/compute/networks/v1/internal/networks_rest_logging_decorator.h b/google/cloud/compute/networks/v1/internal/networks_rest_logging_decorator.h index 534999b6e3172..75ce0d2d9c7c6 100644 --- a/google/cloud/compute/networks/v1/internal/networks_rest_logging_decorator.h +++ b/google/cloud/compute/networks/v1/internal/networks_rest_logging_decorator.h @@ -55,6 +55,21 @@ class NetworksRestLogging : public NetworksRestStub { google::cloud::cpp::compute::networks::v1::AddPeeringRequest const& request) override; + future> + AsyncCancelRequestRemovePeering( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::networks::v1:: + CancelRequestRemovePeeringRequest const& request) override; + + StatusOr + CancelRequestRemovePeering( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::networks::v1:: + CancelRequestRemovePeeringRequest const& request) override; + future> AsyncDeleteNetwork( google::cloud::CompletionQueue& cq, @@ -138,6 +153,20 @@ class NetworksRestLogging : public NetworksRestStub { google::cloud::cpp::compute::networks::v1::RemovePeeringRequest const& request) override; + future> + AsyncRequestRemovePeering( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::networks::v1:: + RequestRemovePeeringRequest const& request) override; + + StatusOr RequestRemovePeering( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::networks::v1:: + RequestRemovePeeringRequest const& request) override; + future> AsyncSwitchToCustomMode( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/networks/v1/internal/networks_rest_metadata_decorator.cc b/google/cloud/compute/networks/v1/internal/networks_rest_metadata_decorator.cc index 8716be2a8e979..b54194c37891c 100644 --- a/google/cloud/compute/networks/v1/internal/networks_rest_metadata_decorator.cc +++ b/google/cloud/compute/networks/v1/internal/networks_rest_metadata_decorator.cc @@ -59,6 +59,27 @@ NetworksRestMetadata::AddPeering( return child_->AddPeering(rest_context, options, request); } +future> +NetworksRestMetadata::AsyncCancelRequestRemovePeering( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::networks::v1:: + CancelRequestRemovePeeringRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncCancelRequestRemovePeering(cq, std::move(rest_context), + std::move(options), request); +} + +StatusOr +NetworksRestMetadata::CancelRequestRemovePeering( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::networks::v1:: + CancelRequestRemovePeeringRequest const& request) { + SetMetadata(rest_context, options); + return child_->CancelRequestRemovePeering(rest_context, options, request); +} + future> NetworksRestMetadata::AsyncDeleteNetwork( CompletionQueue& cq, @@ -179,6 +200,27 @@ NetworksRestMetadata::RemovePeering( return child_->RemovePeering(rest_context, options, request); } +future> +NetworksRestMetadata::AsyncRequestRemovePeering( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::networks::v1:: + RequestRemovePeeringRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncRequestRemovePeering(cq, std::move(rest_context), + std::move(options), request); +} + +StatusOr +NetworksRestMetadata::RequestRemovePeering( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::networks::v1:: + RequestRemovePeeringRequest const& request) { + SetMetadata(rest_context, options); + return child_->RequestRemovePeering(rest_context, options, request); +} + future> NetworksRestMetadata::AsyncSwitchToCustomMode( CompletionQueue& cq, diff --git a/google/cloud/compute/networks/v1/internal/networks_rest_metadata_decorator.h b/google/cloud/compute/networks/v1/internal/networks_rest_metadata_decorator.h index 1203473a96899..51214e18b8f27 100644 --- a/google/cloud/compute/networks/v1/internal/networks_rest_metadata_decorator.h +++ b/google/cloud/compute/networks/v1/internal/networks_rest_metadata_decorator.h @@ -53,6 +53,21 @@ class NetworksRestMetadata : public NetworksRestStub { google::cloud::cpp::compute::networks::v1::AddPeeringRequest const& request) override; + google::cloud::future> + AsyncCancelRequestRemovePeering( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::networks::v1:: + CancelRequestRemovePeeringRequest const& request) override; + + StatusOr + CancelRequestRemovePeering( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::networks::v1:: + CancelRequestRemovePeeringRequest const& request) override; + google::cloud::future> AsyncDeleteNetwork( google::cloud::CompletionQueue& cq, @@ -136,6 +151,20 @@ class NetworksRestMetadata : public NetworksRestStub { google::cloud::cpp::compute::networks::v1::RemovePeeringRequest const& request) override; + google::cloud::future> + AsyncRequestRemovePeering( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::networks::v1:: + RequestRemovePeeringRequest const& request) override; + + StatusOr RequestRemovePeering( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::networks::v1:: + RequestRemovePeeringRequest const& request) override; + google::cloud::future> AsyncSwitchToCustomMode( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/networks/v1/internal/networks_rest_stub.cc b/google/cloud/compute/networks/v1/internal/networks_rest_stub.cc index 8eb6fae4c43b2..28b1e4c76a4a0 100644 --- a/google/cloud/compute/networks/v1/internal/networks_rest_stub.cc +++ b/google/cloud/compute/networks/v1/internal/networks_rest_stub.cc @@ -103,6 +103,67 @@ DefaultNetworksRestStub::AddPeering( std::move(query_params)); } +future> +DefaultNetworksRestStub::AsyncCancelRequestRemovePeering( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::networks::v1:: + CancelRequestRemovePeeringRequest const& request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto service, auto request, auto rest_context, auto options) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + p.set_value( + rest_internal::Post( + *service, *rest_context, + request + .networks_cancel_request_remove_peering_request_resource(), + false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", *options), + "/", "projects", "/", request.project(), "/", + "global", "/", "networks", "/", request.network(), + "/", "cancelRequestRemovePeering"), + std::move(query_params))); + }, + std::move(p), + service_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +StatusOr +DefaultNetworksRestStub::CancelRequestRemovePeering( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::networks::v1:: + CancelRequestRemovePeeringRequest const& request) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Post( + *service_, rest_context, + request.networks_cancel_request_remove_peering_request_resource(), false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "global", "/", + "networks", "/", request.network(), "/", + "cancelRequestRemovePeering"), + std::move(query_params)); +} + future> DefaultNetworksRestStub::AsyncDeleteNetwork( CompletionQueue& cq, @@ -415,6 +476,66 @@ DefaultNetworksRestStub::RemovePeering( std::move(query_params)); } +future> +DefaultNetworksRestStub::AsyncRequestRemovePeering( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::networks::v1:: + RequestRemovePeeringRequest const& request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto service, auto request, auto rest_context, auto options) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + p.set_value( + rest_internal::Post( + *service, *rest_context, + request.networks_request_remove_peering_request_resource(), + false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", *options), + "/", "projects", "/", request.project(), "/", + "global", "/", "networks", "/", request.network(), + "/", "requestRemovePeering"), + std::move(query_params))); + }, + std::move(p), + service_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +StatusOr +DefaultNetworksRestStub::RequestRemovePeering( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::networks::v1:: + RequestRemovePeeringRequest const& request) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Post( + *service_, rest_context, + request.networks_request_remove_peering_request_resource(), false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "global", "/", + "networks", "/", request.network(), "/", + "requestRemovePeering"), + std::move(query_params)); +} + future> DefaultNetworksRestStub::AsyncSwitchToCustomMode( CompletionQueue& cq, diff --git a/google/cloud/compute/networks/v1/internal/networks_rest_stub.h b/google/cloud/compute/networks/v1/internal/networks_rest_stub.h index 157f26f4f7a18..c390d4956cdd1 100644 --- a/google/cloud/compute/networks/v1/internal/networks_rest_stub.h +++ b/google/cloud/compute/networks/v1/internal/networks_rest_stub.h @@ -51,6 +51,21 @@ class NetworksRestStub { google::cloud::cpp::compute::networks::v1::AddPeeringRequest const& request) = 0; + virtual future> + AsyncCancelRequestRemovePeering( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::networks::v1:: + CancelRequestRemovePeeringRequest const& request) = 0; + + virtual StatusOr + CancelRequestRemovePeering( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::networks::v1:: + CancelRequestRemovePeeringRequest const& request) = 0; + virtual future> AsyncDeleteNetwork( google::cloud::CompletionQueue& cq, @@ -133,6 +148,20 @@ class NetworksRestStub { google::cloud::cpp::compute::networks::v1::RemovePeeringRequest const& request) = 0; + virtual future> + AsyncRequestRemovePeering( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::networks::v1:: + RequestRemovePeeringRequest const& request) = 0; + + virtual StatusOr + RequestRemovePeering(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::networks::v1:: + RequestRemovePeeringRequest const& request) = 0; + virtual future> AsyncSwitchToCustomMode( google::cloud::CompletionQueue& cq, @@ -199,6 +228,21 @@ class DefaultNetworksRestStub : public NetworksRestStub { google::cloud::cpp::compute::networks::v1::AddPeeringRequest const& request) override; + future> + AsyncCancelRequestRemovePeering( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::networks::v1:: + CancelRequestRemovePeeringRequest const& request) override; + + StatusOr + CancelRequestRemovePeering( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::networks::v1:: + CancelRequestRemovePeeringRequest const& request) override; + future> AsyncDeleteNetwork( google::cloud::CompletionQueue& cq, @@ -282,6 +326,20 @@ class DefaultNetworksRestStub : public NetworksRestStub { google::cloud::cpp::compute::networks::v1::RemovePeeringRequest const& request) override; + future> + AsyncRequestRemovePeering( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::networks::v1:: + RequestRemovePeeringRequest const& request) override; + + StatusOr RequestRemovePeering( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::networks::v1:: + RequestRemovePeeringRequest const& request) override; + future> AsyncSwitchToCustomMode( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/networks/v1/internal/networks_tracing_connection.cc b/google/cloud/compute/networks/v1/internal/networks_tracing_connection.cc index 38cf287a271ed..5b3d49615fdd0 100644 --- a/google/cloud/compute/networks/v1/internal/networks_tracing_connection.cc +++ b/google/cloud/compute/networks/v1/internal/networks_tracing_connection.cc @@ -61,6 +61,38 @@ NetworksTracingConnection::AddPeering( return internal::EndSpan(std::move(span), child_->AddPeering(operation)); } +future> +NetworksTracingConnection::CancelRequestRemovePeering( + google::cloud::cpp::compute::networks::v1:: + CancelRequestRemovePeeringRequest const& request) { + auto span = internal::MakeSpan( + "compute_networks_v1::NetworksConnection::CancelRequestRemovePeering"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), + child_->CancelRequestRemovePeering(request)); +} + +StatusOr +NetworksTracingConnection::CancelRequestRemovePeering( + NoAwaitTag, google::cloud::cpp::compute::networks::v1:: + CancelRequestRemovePeeringRequest const& request) { + auto span = internal::MakeSpan( + "compute_networks_v1::NetworksConnection::CancelRequestRemovePeering"); + opentelemetry::trace::Scope scope(span); + return internal::EndSpan( + *span, child_->CancelRequestRemovePeering(NoAwaitTag{}, request)); +} + +future> +NetworksTracingConnection::CancelRequestRemovePeering( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto span = internal::MakeSpan( + "compute_networks_v1::NetworksConnection::CancelRequestRemovePeering"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), + child_->CancelRequestRemovePeering(operation)); +} + future> NetworksTracingConnection::DeleteNetwork( google::cloud::cpp::compute::networks::v1::DeleteNetworkRequest const& @@ -225,6 +257,38 @@ NetworksTracingConnection::RemovePeering( return internal::EndSpan(std::move(span), child_->RemovePeering(operation)); } +future> +NetworksTracingConnection::RequestRemovePeering( + google::cloud::cpp::compute::networks::v1:: + RequestRemovePeeringRequest const& request) { + auto span = internal::MakeSpan( + "compute_networks_v1::NetworksConnection::RequestRemovePeering"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), + child_->RequestRemovePeering(request)); +} + +StatusOr +NetworksTracingConnection::RequestRemovePeering( + NoAwaitTag, google::cloud::cpp::compute::networks::v1:: + RequestRemovePeeringRequest const& request) { + auto span = internal::MakeSpan( + "compute_networks_v1::NetworksConnection::RequestRemovePeering"); + opentelemetry::trace::Scope scope(span); + return internal::EndSpan(*span, + child_->RequestRemovePeering(NoAwaitTag{}, request)); +} + +future> +NetworksTracingConnection::RequestRemovePeering( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto span = internal::MakeSpan( + "compute_networks_v1::NetworksConnection::RequestRemovePeering"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), + child_->RequestRemovePeering(operation)); +} + future> NetworksTracingConnection::SwitchToCustomMode( google::cloud::cpp::compute::networks::v1::SwitchToCustomModeRequest const& diff --git a/google/cloud/compute/networks/v1/internal/networks_tracing_connection.h b/google/cloud/compute/networks/v1/internal/networks_tracing_connection.h index 7cea9949404ba..a60b36a636580 100644 --- a/google/cloud/compute/networks/v1/internal/networks_tracing_connection.h +++ b/google/cloud/compute/networks/v1/internal/networks_tracing_connection.h @@ -50,6 +50,21 @@ class NetworksTracingConnection future> AddPeering( google::cloud::cpp::compute::v1::Operation const& operation) override; + future> + CancelRequestRemovePeering( + google::cloud::cpp::compute::networks::v1:: + CancelRequestRemovePeeringRequest const& request) override; + + StatusOr + CancelRequestRemovePeering( + NoAwaitTag, + google::cloud::cpp::compute::networks::v1:: + CancelRequestRemovePeeringRequest const& request) override; + + future> + CancelRequestRemovePeering( + google::cloud::cpp::compute::v1::Operation const& operation) override; + future> DeleteNetwork( google::cloud::cpp::compute::networks::v1::DeleteNetworkRequest const& request) override; @@ -117,6 +132,18 @@ class NetworksTracingConnection future> RemovePeering( google::cloud::cpp::compute::v1::Operation const& operation) override; + future> + RequestRemovePeering(google::cloud::cpp::compute::networks::v1:: + RequestRemovePeeringRequest const& request) override; + + StatusOr RequestRemovePeering( + NoAwaitTag, google::cloud::cpp::compute::networks::v1:: + RequestRemovePeeringRequest const& request) override; + + future> + RequestRemovePeering( + google::cloud::cpp::compute::v1::Operation const& operation) override; + future> SwitchToCustomMode(google::cloud::cpp::compute::networks::v1:: SwitchToCustomModeRequest const& request) override; diff --git a/google/cloud/compute/networks/v1/mocks/mock_networks_connection.h b/google/cloud/compute/networks/v1/mocks/mock_networks_connection.h index 2bcc1a1b0a201..eb952bff3cb6d 100644 --- a/google/cloud/compute/networks/v1/mocks/mock_networks_connection.h +++ b/google/cloud/compute/networks/v1/mocks/mock_networks_connection.h @@ -87,6 +87,48 @@ class MockNetworksConnection : public compute_networks_v1::NetworksConnection { (google::cloud::cpp::compute::v1::Operation const& operation), (override)); + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// CancelRequestRemovePeering(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + CancelRequestRemovePeering, + (google::cloud::cpp::compute::networks::v1:: + CancelRequestRemovePeeringRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// EXPECT_CALL(*mock, CancelRequestRemovePeering(_, _)) + /// @endcode + MOCK_METHOD(StatusOr, + CancelRequestRemovePeering, + (NoAwaitTag, + google::cloud::cpp::compute::networks::v1:: + CancelRequestRemovePeeringRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// CancelRequestRemovePeering(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + CancelRequestRemovePeering, + (google::cloud::cpp::compute::v1::Operation const& operation), + (override)); + /// To disambiguate calls, use: /// /// @code @@ -284,6 +326,47 @@ class MockNetworksConnection : public compute_networks_v1::NetworksConnection { (google::cloud::cpp::compute::v1::Operation const& operation), (override)); + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// RequestRemovePeering(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + RequestRemovePeering, + (google::cloud::cpp::compute::networks::v1:: + RequestRemovePeeringRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// EXPECT_CALL(*mock, RequestRemovePeering(_, _)) + /// @endcode + MOCK_METHOD(StatusOr, + RequestRemovePeering, + (NoAwaitTag, google::cloud::cpp::compute::networks::v1:: + RequestRemovePeeringRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// RequestRemovePeering(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + RequestRemovePeering, + (google::cloud::cpp::compute::v1::Operation const& operation), + (override)); + /// To disambiguate calls, use: /// /// @code diff --git a/google/cloud/compute/networks/v1/networks_client.cc b/google/cloud/compute/networks/v1/networks_client.cc index 533872db1dc40..b988f384ec58f 100644 --- a/google/cloud/compute/networks/v1/networks_client.cc +++ b/google/cloud/compute/networks/v1/networks_client.cc @@ -84,6 +84,66 @@ NetworksClient::AddPeering( return connection_->AddPeering(operation); } +future> +NetworksClient::CancelRequestRemovePeering( + std::string const& project, std::string const& network, + google::cloud::cpp::compute::v1:: + NetworksCancelRequestRemovePeeringRequest const& + networks_cancel_request_remove_peering_request_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::networks::v1::CancelRequestRemovePeeringRequest + request; + request.set_project(project); + request.set_network(network); + *request.mutable_networks_cancel_request_remove_peering_request_resource() = + networks_cancel_request_remove_peering_request_resource; + return connection_->CancelRequestRemovePeering(request); +} + +StatusOr +NetworksClient::CancelRequestRemovePeering( + NoAwaitTag, std::string const& project, std::string const& network, + google::cloud::cpp::compute::v1:: + NetworksCancelRequestRemovePeeringRequest const& + networks_cancel_request_remove_peering_request_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::networks::v1::CancelRequestRemovePeeringRequest + request; + request.set_project(project); + request.set_network(network); + *request.mutable_networks_cancel_request_remove_peering_request_resource() = + networks_cancel_request_remove_peering_request_resource; + return connection_->CancelRequestRemovePeering(NoAwaitTag{}, request); +} + +future> +NetworksClient::CancelRequestRemovePeering( + google::cloud::cpp::compute::networks::v1:: + CancelRequestRemovePeeringRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->CancelRequestRemovePeering(request); +} + +StatusOr +NetworksClient::CancelRequestRemovePeering( + NoAwaitTag, + google::cloud::cpp::compute::networks::v1:: + CancelRequestRemovePeeringRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->CancelRequestRemovePeering(NoAwaitTag{}, request); +} + +future> +NetworksClient::CancelRequestRemovePeering( + google::cloud::cpp::compute::v1::Operation const& operation, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->CancelRequestRemovePeering(operation); +} + future> NetworksClient::DeleteNetwork(std::string const& project, std::string const& network, Options opts) { @@ -359,6 +419,64 @@ NetworksClient::RemovePeering( return connection_->RemovePeering(operation); } +future> +NetworksClient::RequestRemovePeering( + std::string const& project, std::string const& network, + google::cloud::cpp::compute::v1::NetworksRequestRemovePeeringRequest const& + networks_request_remove_peering_request_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::networks::v1::RequestRemovePeeringRequest + request; + request.set_project(project); + request.set_network(network); + *request.mutable_networks_request_remove_peering_request_resource() = + networks_request_remove_peering_request_resource; + return connection_->RequestRemovePeering(request); +} + +StatusOr +NetworksClient::RequestRemovePeering( + NoAwaitTag, std::string const& project, std::string const& network, + google::cloud::cpp::compute::v1::NetworksRequestRemovePeeringRequest const& + networks_request_remove_peering_request_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::networks::v1::RequestRemovePeeringRequest + request; + request.set_project(project); + request.set_network(network); + *request.mutable_networks_request_remove_peering_request_resource() = + networks_request_remove_peering_request_resource; + return connection_->RequestRemovePeering(NoAwaitTag{}, request); +} + +future> +NetworksClient::RequestRemovePeering( + google::cloud::cpp::compute::networks::v1:: + RequestRemovePeeringRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->RequestRemovePeering(request); +} + +StatusOr +NetworksClient::RequestRemovePeering( + NoAwaitTag, + google::cloud::cpp::compute::networks::v1:: + RequestRemovePeeringRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->RequestRemovePeering(NoAwaitTag{}, request); +} + +future> +NetworksClient::RequestRemovePeering( + google::cloud::cpp::compute::v1::Operation const& operation, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->RequestRemovePeering(operation); +} + future> NetworksClient::SwitchToCustomMode(std::string const& project, std::string const& network, Options opts) { diff --git a/google/cloud/compute/networks/v1/networks_client.h b/google/cloud/compute/networks/v1/networks_client.h index 4d2cc4578a81f..5662e4720203c 100644 --- a/google/cloud/compute/networks/v1/networks_client.h +++ b/google/cloud/compute/networks/v1/networks_client.h @@ -113,7 +113,7 @@ class NetworksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.networks.v1.AddPeeringRequest]: @cloud_cpp_reference_link{google/cloud/compute/networks/v1/networks.proto#L172} + /// [google.cloud.cpp.compute.networks.v1.AddPeeringRequest]: @cloud_cpp_reference_link{google/cloud/compute/networks/v1/networks.proto#L201} /// // clang-format on future> AddPeering( @@ -170,7 +170,7 @@ class NetworksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.networks.v1.AddPeeringRequest]: @cloud_cpp_reference_link{google/cloud/compute/networks/v1/networks.proto#L172} + /// [google.cloud.cpp.compute.networks.v1.AddPeeringRequest]: @cloud_cpp_reference_link{google/cloud/compute/networks/v1/networks.proto#L201} /// // clang-format on future> AddPeering( @@ -208,6 +208,140 @@ class NetworksClient { google::cloud::cpp::compute::v1::Operation const& operation, Options opts = {}); + // clang-format off + /// + /// Cancel requests to remove a peering from the specified network. Applicable + /// only for PeeringConnection with update_strategy=CONSENSUS. Cancels a + /// request to remove a peering from the specified network. + /// https://cloud.google.com/compute/docs/reference/rest/v1/networks/cancelRequestRemovePeering + /// + /// @param project Project ID for this request. + /// @param network Name of the network resource to remove peering from. + /// @param networks_cancel_request_remove_peering_request_resource The NetworksCancelRequestRemovePeeringRequest for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.networks.v1.CancelRequestRemovePeeringRequest]: @cloud_cpp_reference_link{google/cloud/compute/networks/v1/networks.proto#L235} + /// + // clang-format on + future> + CancelRequestRemovePeering( + std::string const& project, std::string const& network, + google::cloud::cpp::compute::v1:: + NetworksCancelRequestRemovePeeringRequest const& + networks_cancel_request_remove_peering_request_resource, + Options opts = {}); + + // clang-format off + /// + /// @copybrief CancelRequestRemovePeering + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr + CancelRequestRemovePeering( + NoAwaitTag, std::string const& project, std::string const& network, + google::cloud::cpp::compute::v1:: + NetworksCancelRequestRemovePeeringRequest const& + networks_cancel_request_remove_peering_request_resource, + Options opts = {}); + + // clang-format off + /// + /// Cancel requests to remove a peering from the specified network. Applicable + /// only for PeeringConnection with update_strategy=CONSENSUS. Cancels a + /// request to remove a peering from the specified network. + /// https://cloud.google.com/compute/docs/reference/rest/v1/networks/cancelRequestRemovePeering + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.networks.v1.CancelRequestRemovePeeringRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.networks.v1.CancelRequestRemovePeeringRequest]: @cloud_cpp_reference_link{google/cloud/compute/networks/v1/networks.proto#L235} + /// + // clang-format on + future> + CancelRequestRemovePeering( + google::cloud::cpp::compute::networks::v1:: + CancelRequestRemovePeeringRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief CancelRequestRemovePeering + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr + CancelRequestRemovePeering( + NoAwaitTag, + google::cloud::cpp::compute::networks::v1:: + CancelRequestRemovePeeringRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief CancelRequestRemovePeering + /// + /// This method accepts a `google::cloud::cpp::compute::v1::Operation` that corresponds + /// to a previously started Long Running Operation (LRO) and polls the status + /// of the LRO in the background. + /// + // clang-format on + future> + CancelRequestRemovePeering( + google::cloud::cpp::compute::v1::Operation const& operation, + Options opts = {}); + // clang-format off /// /// Deletes the specified network. @@ -235,7 +369,7 @@ class NetworksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.networks.v1.DeleteNetworkRequest]: @cloud_cpp_reference_link{google/cloud/compute/networks/v1/networks.proto#L203} + /// [google.cloud.cpp.compute.networks.v1.DeleteNetworkRequest]: @cloud_cpp_reference_link{google/cloud/compute/networks/v1/networks.proto#L269} /// // clang-format on future> DeleteNetwork( @@ -288,7 +422,7 @@ class NetworksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.networks.v1.DeleteNetworkRequest]: @cloud_cpp_reference_link{google/cloud/compute/networks/v1/networks.proto#L203} + /// [google.cloud.cpp.compute.networks.v1.DeleteNetworkRequest]: @cloud_cpp_reference_link{google/cloud/compute/networks/v1/networks.proto#L269} /// // clang-format on future> DeleteNetwork( @@ -346,8 +480,8 @@ class NetworksClient { /// [`future`]: @ref google::cloud::future /// [`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_030.proto#L161} + /// [google.cloud.cpp.compute.networks.v1.GetNetworkRequest]: @cloud_cpp_reference_link{google/cloud/compute/networks/v1/networks.proto#L309} + /// [google.cloud.cpp.compute.v1.Network]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_039.proto#L185} /// // clang-format on StatusOr GetNetwork( @@ -378,8 +512,8 @@ class NetworksClient { /// [`future`]: @ref google::cloud::future /// [`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_030.proto#L161} + /// [google.cloud.cpp.compute.networks.v1.GetNetworkRequest]: @cloud_cpp_reference_link{google/cloud/compute/networks/v1/networks.proto#L309} + /// [google.cloud.cpp.compute.v1.Network]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_039.proto#L185} /// // clang-format on StatusOr GetNetwork( @@ -407,8 +541,8 @@ class NetworksClient { /// [`future`]: @ref google::cloud::future /// [`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_030.proto#L532} + /// [google.cloud.cpp.compute.networks.v1.GetEffectiveFirewallsRequest]: @cloud_cpp_reference_link{google/cloud/compute/networks/v1/networks.proto#L298} + /// [google.cloud.cpp.compute.v1.NetworksGetEffectiveFirewallsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_039.proto#L733} /// // clang-format on StatusOr< @@ -440,8 +574,8 @@ class NetworksClient { /// [`future`]: @ref google::cloud::future /// [`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_030.proto#L532} + /// [google.cloud.cpp.compute.networks.v1.GetEffectiveFirewallsRequest]: @cloud_cpp_reference_link{google/cloud/compute/networks/v1/networks.proto#L298} + /// [google.cloud.cpp.compute.v1.NetworksGetEffectiveFirewallsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_039.proto#L733} /// // clang-format on StatusOr< @@ -452,8 +586,8 @@ class NetworksClient { // clang-format off /// - /// Creates a network in the specified project using the data included in the - /// request. + /// Creates a network in the specified project using the data included + /// in the request. /// https://cloud.google.com/compute/docs/reference/rest/v1/networks/insert /// /// @param project Project ID for this request. @@ -478,7 +612,7 @@ class NetworksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.networks.v1.InsertNetworkRequest]: @cloud_cpp_reference_link{google/cloud/compute/networks/v1/networks.proto#L251} + /// [google.cloud.cpp.compute.networks.v1.InsertNetworkRequest]: @cloud_cpp_reference_link{google/cloud/compute/networks/v1/networks.proto#L320} /// // clang-format on future> InsertNetwork( @@ -504,8 +638,8 @@ class NetworksClient { // clang-format off /// - /// Creates a network in the specified project using the data included in the - /// request. + /// Creates a network in the specified project using the data included + /// in the request. /// https://cloud.google.com/compute/docs/reference/rest/v1/networks/insert /// /// @param request Unary RPCs, such as the one wrapped by this @@ -534,7 +668,7 @@ class NetworksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.networks.v1.InsertNetworkRequest]: @cloud_cpp_reference_link{google/cloud/compute/networks/v1/networks.proto#L251} + /// [google.cloud.cpp.compute.networks.v1.InsertNetworkRequest]: @cloud_cpp_reference_link{google/cloud/compute/networks/v1/networks.proto#L320} /// // clang-format on future> InsertNetwork( @@ -600,8 +734,8 @@ class NetworksClient { /// [`future`]: @ref google::cloud::future /// [`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_030.proto#L161} + /// [google.cloud.cpp.compute.networks.v1.ListNetworksRequest]: @cloud_cpp_reference_link{google/cloud/compute/networks/v1/networks.proto#L349} + /// [google.cloud.cpp.compute.v1.Network]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_039.proto#L185} /// // clang-format on StreamRange ListNetworks( @@ -640,8 +774,8 @@ class NetworksClient { /// [`future`]: @ref google::cloud::future /// [`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_030.proto#L161} + /// [google.cloud.cpp.compute.networks.v1.ListNetworksRequest]: @cloud_cpp_reference_link{google/cloud/compute/networks/v1/networks.proto#L349} + /// [google.cloud.cpp.compute.v1.Network]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_039.proto#L185} /// // clang-format on StreamRange ListNetworks( @@ -677,8 +811,8 @@ class NetworksClient { /// [`future`]: @ref google::cloud::future /// [`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_030.proto#L27} + /// [google.cloud.cpp.compute.networks.v1.ListPeeringRoutesRequest]: @cloud_cpp_reference_link{google/cloud/compute/networks/v1/networks.proto#L450} + /// [google.cloud.cpp.compute.v1.ExchangedPeeringRoute]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_039.proto#L27} /// // clang-format on StreamRange @@ -718,8 +852,8 @@ class NetworksClient { /// [`future`]: @ref google::cloud::future /// [`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_030.proto#L27} + /// [google.cloud.cpp.compute.networks.v1.ListPeeringRoutesRequest]: @cloud_cpp_reference_link{google/cloud/compute/networks/v1/networks.proto#L450} + /// [google.cloud.cpp.compute.v1.ExchangedPeeringRoute]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_039.proto#L27} /// // clang-format on StreamRange @@ -730,8 +864,8 @@ class NetworksClient { // clang-format off /// - /// Patches the specified network with the data included in the request. Only - /// routingConfig can be modified. + /// Patches the specified network with the data included in the request. + /// Only routingConfig can be modified. /// https://cloud.google.com/compute/docs/reference/rest/v1/networks/patch /// /// @param project Project ID for this request. @@ -757,7 +891,7 @@ class NetworksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.networks.v1.PatchNetworkRequest]: @cloud_cpp_reference_link{google/cloud/compute/networks/v1/networks.proto#L430} + /// [google.cloud.cpp.compute.networks.v1.PatchNetworkRequest]: @cloud_cpp_reference_link{google/cloud/compute/networks/v1/networks.proto#L568} /// // clang-format on future> PatchNetwork( @@ -783,8 +917,8 @@ class NetworksClient { // clang-format off /// - /// Patches the specified network with the data included in the request. Only - /// routingConfig can be modified. + /// Patches the specified network with the data included in the request. + /// Only routingConfig can be modified. /// https://cloud.google.com/compute/docs/reference/rest/v1/networks/patch /// /// @param request Unary RPCs, such as the one wrapped by this @@ -813,7 +947,7 @@ class NetworksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.networks.v1.PatchNetworkRequest]: @cloud_cpp_reference_link{google/cloud/compute/networks/v1/networks.proto#L430} + /// [google.cloud.cpp.compute.networks.v1.PatchNetworkRequest]: @cloud_cpp_reference_link{google/cloud/compute/networks/v1/networks.proto#L568} /// // clang-format on future> PatchNetwork( @@ -879,7 +1013,7 @@ class NetworksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.networks.v1.RemovePeeringRequest]: @cloud_cpp_reference_link{google/cloud/compute/networks/v1/networks.proto#L460} + /// [google.cloud.cpp.compute.networks.v1.RemovePeeringRequest]: @cloud_cpp_reference_link{google/cloud/compute/networks/v1/networks.proto#L601} /// // clang-format on future> RemovePeering( @@ -936,7 +1070,7 @@ class NetworksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.networks.v1.RemovePeeringRequest]: @cloud_cpp_reference_link{google/cloud/compute/networks/v1/networks.proto#L460} + /// [google.cloud.cpp.compute.networks.v1.RemovePeeringRequest]: @cloud_cpp_reference_link{google/cloud/compute/networks/v1/networks.proto#L601} /// // clang-format on future> RemovePeering( @@ -974,6 +1108,134 @@ class NetworksClient { google::cloud::cpp::compute::v1::Operation const& operation, Options opts = {}); + // clang-format off + /// + /// Requests to remove a peering from the specified network. Applicable only + /// for PeeringConnection with update_strategy=CONSENSUS. + /// https://cloud.google.com/compute/docs/reference/rest/v1/networks/requestRemovePeering + /// + /// @param project Project ID for this request. + /// @param network Name of the network resource to remove peering from. + /// @param networks_request_remove_peering_request_resource The NetworksRequestRemovePeeringRequest for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.networks.v1.RequestRemovePeeringRequest]: @cloud_cpp_reference_link{google/cloud/compute/networks/v1/networks.proto#L635} + /// + // clang-format on + future> + RequestRemovePeering(std::string const& project, std::string const& network, + google::cloud::cpp::compute::v1:: + NetworksRequestRemovePeeringRequest const& + networks_request_remove_peering_request_resource, + Options opts = {}); + + // clang-format off + /// + /// @copybrief RequestRemovePeering + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr RequestRemovePeering( + NoAwaitTag, std::string const& project, std::string const& network, + google::cloud::cpp::compute::v1:: + NetworksRequestRemovePeeringRequest const& + networks_request_remove_peering_request_resource, + Options opts = {}); + + // clang-format off + /// + /// Requests to remove a peering from the specified network. Applicable only + /// for PeeringConnection with update_strategy=CONSENSUS. + /// https://cloud.google.com/compute/docs/reference/rest/v1/networks/requestRemovePeering + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.networks.v1.RequestRemovePeeringRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.networks.v1.RequestRemovePeeringRequest]: @cloud_cpp_reference_link{google/cloud/compute/networks/v1/networks.proto#L635} + /// + // clang-format on + future> + RequestRemovePeering(google::cloud::cpp::compute::networks::v1:: + RequestRemovePeeringRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief RequestRemovePeering + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr RequestRemovePeering( + NoAwaitTag, + google::cloud::cpp::compute::networks::v1:: + RequestRemovePeeringRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief RequestRemovePeering + /// + /// This method accepts a `google::cloud::cpp::compute::v1::Operation` that corresponds + /// to a previously started Long Running Operation (LRO) and polls the status + /// of the LRO in the background. + /// + // clang-format on + future> + RequestRemovePeering( + google::cloud::cpp::compute::v1::Operation const& operation, + Options opts = {}); + // clang-format off /// /// Switches the network mode from auto subnet mode to custom subnet mode. @@ -1001,7 +1263,7 @@ class NetworksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.networks.v1.SwitchToCustomModeRequest]: @cloud_cpp_reference_link{google/cloud/compute/networks/v1/networks.proto#L491} + /// [google.cloud.cpp.compute.networks.v1.SwitchToCustomModeRequest]: @cloud_cpp_reference_link{google/cloud/compute/networks/v1/networks.proto#L669} /// // clang-format on future> @@ -1054,7 +1316,7 @@ class NetworksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.networks.v1.SwitchToCustomModeRequest]: @cloud_cpp_reference_link{google/cloud/compute/networks/v1/networks.proto#L491} + /// [google.cloud.cpp.compute.networks.v1.SwitchToCustomModeRequest]: @cloud_cpp_reference_link{google/cloud/compute/networks/v1/networks.proto#L669} /// // clang-format on future> @@ -1123,7 +1385,7 @@ class NetworksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.networks.v1.UpdatePeeringRequest]: @cloud_cpp_reference_link{google/cloud/compute/networks/v1/networks.proto#L517} + /// [google.cloud.cpp.compute.networks.v1.UpdatePeeringRequest]: @cloud_cpp_reference_link{google/cloud/compute/networks/v1/networks.proto#L698} /// // clang-format on future> UpdatePeering( @@ -1182,7 +1444,7 @@ class NetworksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.networks.v1.UpdatePeeringRequest]: @cloud_cpp_reference_link{google/cloud/compute/networks/v1/networks.proto#L517} + /// [google.cloud.cpp.compute.networks.v1.UpdatePeeringRequest]: @cloud_cpp_reference_link{google/cloud/compute/networks/v1/networks.proto#L698} /// // clang-format on future> UpdatePeering( diff --git a/google/cloud/compute/networks/v1/networks_connection.cc b/google/cloud/compute/networks/v1/networks_connection.cc index 66b734468a4ec..17e159ab8c4b5 100644 --- a/google/cloud/compute/networks/v1/networks_connection.cc +++ b/google/cloud/compute/networks/v1/networks_connection.cc @@ -60,6 +60,31 @@ NetworksConnection::AddPeering( Status(StatusCode::kUnimplemented, "not implemented")); } +future> +NetworksConnection::CancelRequestRemovePeering( + google::cloud::cpp::compute::networks::v1:: + CancelRequestRemovePeeringRequest const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +NetworksConnection::CancelRequestRemovePeering( + NoAwaitTag, google::cloud::cpp::compute::networks::v1:: + CancelRequestRemovePeeringRequest const&) { + return StatusOr( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +NetworksConnection::CancelRequestRemovePeering( + google::cloud::cpp::compute::v1::Operation const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + future> NetworksConnection::DeleteNetwork( google::cloud::cpp::compute::networks::v1::DeleteNetworkRequest const&) { @@ -185,6 +210,31 @@ NetworksConnection::RemovePeering( Status(StatusCode::kUnimplemented, "not implemented")); } +future> +NetworksConnection::RequestRemovePeering( + google::cloud::cpp::compute::networks::v1:: + RequestRemovePeeringRequest const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +NetworksConnection::RequestRemovePeering( + NoAwaitTag, google::cloud::cpp::compute::networks::v1:: + RequestRemovePeeringRequest const&) { + return StatusOr( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +NetworksConnection::RequestRemovePeering( + google::cloud::cpp::compute::v1::Operation const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + future> NetworksConnection::SwitchToCustomMode( google::cloud::cpp::compute::networks::v1:: diff --git a/google/cloud/compute/networks/v1/networks_connection.h b/google/cloud/compute/networks/v1/networks_connection.h index 05cb2e06f4deb..3abc097cfbcb3 100644 --- a/google/cloud/compute/networks/v1/networks_connection.h +++ b/google/cloud/compute/networks/v1/networks_connection.h @@ -194,6 +194,20 @@ class NetworksConnection { virtual future> AddPeering(google::cloud::cpp::compute::v1::Operation const& operation); + virtual future> + CancelRequestRemovePeering( + google::cloud::cpp::compute::networks::v1:: + CancelRequestRemovePeeringRequest const& request); + + virtual StatusOr + CancelRequestRemovePeering( + NoAwaitTag, google::cloud::cpp::compute::networks::v1:: + CancelRequestRemovePeeringRequest const& request); + + virtual future> + CancelRequestRemovePeering( + google::cloud::cpp::compute::v1::Operation const& operation); + virtual future> DeleteNetwork( google::cloud::cpp::compute::networks::v1::DeleteNetworkRequest const& @@ -263,6 +277,19 @@ class NetworksConnection { virtual future> RemovePeering(google::cloud::cpp::compute::v1::Operation const& operation); + virtual future> + RequestRemovePeering(google::cloud::cpp::compute::networks::v1:: + RequestRemovePeeringRequest const& request); + + virtual StatusOr + RequestRemovePeering(NoAwaitTag, + google::cloud::cpp::compute::networks::v1:: + RequestRemovePeeringRequest const& request); + + virtual future> + RequestRemovePeering( + google::cloud::cpp::compute::v1::Operation const& operation); + virtual future> SwitchToCustomMode(google::cloud::cpp::compute::networks::v1:: SwitchToCustomModeRequest const& request); diff --git a/google/cloud/compute/networks/v1/networks_connection_idempotency_policy.cc b/google/cloud/compute/networks/v1/networks_connection_idempotency_policy.cc index 775a78c3ca7a9..4376dd4588193 100644 --- a/google/cloud/compute/networks/v1/networks_connection_idempotency_policy.cc +++ b/google/cloud/compute/networks/v1/networks_connection_idempotency_policy.cc @@ -39,6 +39,12 @@ Idempotency NetworksConnectionIdempotencyPolicy::AddPeering( return Idempotency::kNonIdempotent; } +Idempotency NetworksConnectionIdempotencyPolicy::CancelRequestRemovePeering( + google::cloud::cpp::compute::networks::v1:: + CancelRequestRemovePeeringRequest const&) { + return Idempotency::kNonIdempotent; +} + Idempotency NetworksConnectionIdempotencyPolicy::DeleteNetwork( google::cloud::cpp::compute::networks::v1::DeleteNetworkRequest const&) { return Idempotency::kNonIdempotent; @@ -81,6 +87,12 @@ Idempotency NetworksConnectionIdempotencyPolicy::RemovePeering( return Idempotency::kNonIdempotent; } +Idempotency NetworksConnectionIdempotencyPolicy::RequestRemovePeering( + google::cloud::cpp::compute::networks::v1:: + RequestRemovePeeringRequest const&) { + return Idempotency::kNonIdempotent; +} + Idempotency NetworksConnectionIdempotencyPolicy::SwitchToCustomMode( google::cloud::cpp::compute::networks::v1:: SwitchToCustomModeRequest const&) { diff --git a/google/cloud/compute/networks/v1/networks_connection_idempotency_policy.h b/google/cloud/compute/networks/v1/networks_connection_idempotency_policy.h index 2700e292ffc3a..b20ed5d65562b 100644 --- a/google/cloud/compute/networks/v1/networks_connection_idempotency_policy.h +++ b/google/cloud/compute/networks/v1/networks_connection_idempotency_policy.h @@ -40,6 +40,10 @@ class NetworksConnectionIdempotencyPolicy { google::cloud::cpp::compute::networks::v1::AddPeeringRequest const& request); + virtual google::cloud::Idempotency CancelRequestRemovePeering( + google::cloud::cpp::compute::networks::v1:: + CancelRequestRemovePeeringRequest const& request); + virtual google::cloud::Idempotency DeleteNetwork( google::cloud::cpp::compute::networks::v1::DeleteNetworkRequest const& request); @@ -71,6 +75,10 @@ class NetworksConnectionIdempotencyPolicy { google::cloud::cpp::compute::networks::v1::RemovePeeringRequest const& request); + virtual google::cloud::Idempotency RequestRemovePeering( + google::cloud::cpp::compute::networks::v1:: + RequestRemovePeeringRequest const& request); + virtual google::cloud::Idempotency SwitchToCustomMode( google::cloud::cpp::compute::networks::v1:: SwitchToCustomModeRequest const& request); diff --git a/google/cloud/compute/networks/v1/networks_proto_export.h b/google/cloud/compute/networks/v1/networks_proto_export.h index 063a722deecb9..9158b07b485dc 100644 --- a/google/cloud/compute/networks/v1/networks_proto_export.h +++ b/google/cloud/compute/networks/v1/networks_proto_export.h @@ -26,15 +26,16 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_NETWORKS_V1_NETWORKS_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include "google/cloud/compute/v1/internal/common_007.pb.h" -#include "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_030.pb.h" -#include "google/cloud/compute/v1/internal/common_031.pb.h" -#include "google/cloud/compute/v1/internal/common_034.pb.h" +#include "google/cloud/compute/v1/internal/common_009.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" #include "google/cloud/compute/v1/internal/common_039.pb.h" -#include "google/cloud/compute/v1/internal/common_108.pb.h" -#include "google/cloud/compute/v1/internal/common_132.pb.h" -#include "google/cloud/compute/v1/internal/common_145.pb.h" +#include "google/cloud/compute/v1/internal/common_040.pb.h" +#include "google/cloud/compute/v1/internal/common_043.pb.h" +#include "google/cloud/compute/v1/internal/common_048.pb.h" +#include "google/cloud/compute/v1/internal/common_126.pb.h" +#include "google/cloud/compute/v1/internal/common_158.pb.h" +#include "google/cloud/compute/v1/internal/common_171.pb.h" +#include "google/cloud/compute/v1/internal/common_172.pb.h" // 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 78a2664163760..c4d09f5cff9b3 100644 --- a/google/cloud/compute/node_groups/v1/node_groups_client.h +++ b/google/cloud/compute/node_groups/v1/node_groups_client.h @@ -115,7 +115,7 @@ class NodeGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.node_groups.v1.AddNodesRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_groups/v1/node_groups.proto#L230} + /// [google.cloud.cpp.compute.node_groups.v1.AddNodesRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_groups/v1/node_groups.proto#L233} /// // clang-format on future> AddNodes( @@ -174,7 +174,7 @@ class NodeGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.node_groups.v1.AddNodesRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_groups/v1/node_groups.proto#L230} + /// [google.cloud.cpp.compute.node_groups.v1.AddNodesRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_groups/v1/node_groups.proto#L233} /// // clang-format on future> AddNodes( @@ -214,9 +214,11 @@ class NodeGroupsClient { // clang-format off /// - /// 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`. + /// 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`. /// https://cloud.google.com/compute/docs/reference/rest/v1/nodeGroups/aggregatedList /// /// @param project Project ID for this request. @@ -242,8 +244,8 @@ class NodeGroupsClient { /// [`future`]: @ref google::cloud::future /// [`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#L586} + /// [google.cloud.cpp.compute.node_groups.v1.AggregatedListNodeGroupsRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_groups/v1/node_groups.proto#L274} + /// [google.cloud.cpp.compute.v1.NodeGroupsScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_072.proto#L671} /// // clang-format on StreamRange> DeleteNodeGroup( @@ -376,7 +380,7 @@ class NodeGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.node_groups.v1.DeleteNodeGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_groups/v1/node_groups.proto#L350} + /// [google.cloud.cpp.compute.node_groups.v1.DeleteNodeGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_groups/v1/node_groups.proto#L389} /// // clang-format on future> DeleteNodeGroup( @@ -443,7 +447,7 @@ class NodeGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.node_groups.v1.DeleteNodesRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_groups/v1/node_groups.proto#L383} + /// [google.cloud.cpp.compute.node_groups.v1.DeleteNodesRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_groups/v1/node_groups.proto#L425} /// // clang-format on future> DeleteNodes( @@ -502,7 +506,7 @@ class NodeGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.node_groups.v1.DeleteNodesRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_groups/v1/node_groups.proto#L383} + /// [google.cloud.cpp.compute.node_groups.v1.DeleteNodesRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_groups/v1/node_groups.proto#L425} /// // clang-format on future> DeleteNodes( @@ -542,9 +546,10 @@ class NodeGroupsClient { // clang-format off /// - /// 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. + /// 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. /// https://cloud.google.com/compute/docs/reference/rest/v1/nodeGroups/get /// /// @param project Project ID for this request. @@ -563,8 +568,8 @@ class NodeGroupsClient { /// [`future`]: @ref google::cloud::future /// [`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.node_groups.v1.GetNodeGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_groups/v1/node_groups.proto#L484} + /// [google.cloud.cpp.compute.v1.NodeGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_072.proto#L63} /// // clang-format on StatusOr GetNodeGroup( @@ -573,9 +578,10 @@ class NodeGroupsClient { // clang-format off /// - /// 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. + /// 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. /// https://cloud.google.com/compute/docs/reference/rest/v1/nodeGroups/get /// /// @param request Unary RPCs, such as the one wrapped by this @@ -597,8 +603,8 @@ class NodeGroupsClient { /// [`future`]: @ref google::cloud::future /// [`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.node_groups.v1.GetNodeGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_groups/v1/node_groups.proto#L484} + /// [google.cloud.cpp.compute.v1.NodeGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_072.proto#L63} /// // clang-format on StatusOr GetNodeGroup( @@ -628,8 +634,8 @@ class NodeGroupsClient { /// [`future`]: @ref google::cloud::future /// [`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_007.proto#L178} + /// [google.cloud.cpp.compute.node_groups.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_groups/v1/node_groups.proto#L466} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr GetIamPolicy( @@ -661,8 +667,8 @@ class NodeGroupsClient { /// [`future`]: @ref google::cloud::future /// [`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_007.proto#L178} + /// [google.cloud.cpp.compute.node_groups.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_groups/v1/node_groups.proto#L466} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr GetIamPolicy( @@ -700,7 +706,7 @@ class NodeGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.node_groups.v1.InsertNodeGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_groups/v1/node_groups.proto#L453} + /// [google.cloud.cpp.compute.node_groups.v1.InsertNodeGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_groups/v1/node_groups.proto#L498} /// // clang-format on future> InsertNodeGroup( @@ -758,7 +764,7 @@ class NodeGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.node_groups.v1.InsertNodeGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_groups/v1/node_groups.proto#L453} + /// [google.cloud.cpp.compute.node_groups.v1.InsertNodeGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_groups/v1/node_groups.proto#L498} /// // clang-format on future> InsertNodeGroup( @@ -798,8 +804,8 @@ class NodeGroupsClient { // clang-format off /// - /// Retrieves a list of node groups available to the specified project. Note: - /// use nodeGroups.listNodes for more details about each group. + /// Retrieves a list of node groups available to the specified project. + /// Note: use nodeGroups.listNodes for more details about each group. /// https://cloud.google.com/compute/docs/reference/rest/v1/nodeGroups/list /// /// @param project Project ID for this request. @@ -826,8 +832,8 @@ class NodeGroupsClient { /// [`future`]: @ref google::cloud::future /// [`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.node_groups.v1.ListNodeGroupsRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_groups/v1/node_groups.proto#L538} + /// [google.cloud.cpp.compute.v1.NodeGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_072.proto#L63} /// // clang-format on StreamRange ListNodeGroups( @@ -835,8 +841,8 @@ class NodeGroupsClient { // clang-format off /// - /// Retrieves a list of node groups available to the specified project. Note: - /// use nodeGroups.listNodes for more details about each group. + /// Retrieves a list of node groups available to the specified project. + /// Note: use nodeGroups.listNodes for more details about each group. /// https://cloud.google.com/compute/docs/reference/rest/v1/nodeGroups/list /// /// @param request Unary RPCs, such as the one wrapped by this @@ -867,8 +873,8 @@ class NodeGroupsClient { /// [`future`]: @ref google::cloud::future /// [`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.node_groups.v1.ListNodeGroupsRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_groups/v1/node_groups.proto#L538} + /// [google.cloud.cpp.compute.v1.NodeGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_072.proto#L63} /// // clang-format on StreamRange ListNodeGroups( @@ -906,8 +912,8 @@ class NodeGroupsClient { /// [`future`]: @ref google::cloud::future /// [`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#L404} + /// [google.cloud.cpp.compute.node_groups.v1.ListNodesRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_groups/v1/node_groups.proto#L642} + /// [google.cloud.cpp.compute.v1.NodeGroupNode]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_072.proto#L465} /// // clang-format on StreamRange ListNodes( @@ -947,8 +953,8 @@ class NodeGroupsClient { /// [`future`]: @ref google::cloud::future /// [`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#L404} + /// [google.cloud.cpp.compute.node_groups.v1.ListNodesRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_groups/v1/node_groups.proto#L642} + /// [google.cloud.cpp.compute.v1.NodeGroupNode]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_072.proto#L465} /// // clang-format on StreamRange ListNodes( @@ -984,7 +990,7 @@ class NodeGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.node_groups.v1.PatchNodeGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_groups/v1/node_groups.proto#L636} + /// [google.cloud.cpp.compute.node_groups.v1.PatchNodeGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_groups/v1/node_groups.proto#L750} /// // clang-format on future> PatchNodeGroup( @@ -1041,7 +1047,7 @@ class NodeGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.node_groups.v1.PatchNodeGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_groups/v1/node_groups.proto#L636} + /// [google.cloud.cpp.compute.node_groups.v1.PatchNodeGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_groups/v1/node_groups.proto#L750} /// // clang-format on future> PatchNodeGroup( @@ -1108,7 +1114,7 @@ class NodeGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.node_groups.v1.PerformMaintenanceRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_groups/v1/node_groups.proto#L673} + /// [google.cloud.cpp.compute.node_groups.v1.PerformMaintenanceRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_groups/v1/node_groups.proto#L790} /// // clang-format on future> @@ -1169,7 +1175,7 @@ class NodeGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.node_groups.v1.PerformMaintenanceRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_groups/v1/node_groups.proto#L673} + /// [google.cloud.cpp.compute.node_groups.v1.PerformMaintenanceRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_groups/v1/node_groups.proto#L790} /// // clang-format on future> @@ -1210,8 +1216,8 @@ class NodeGroupsClient { // clang-format off /// - /// Sets the access control policy on the specified resource. Replaces any - /// existing policy. + /// Sets the access control policy on the specified resource. + /// Replaces any existing policy. /// https://cloud.google.com/compute/docs/reference/rest/v1/nodeGroups/setIamPolicy /// /// @param project Project ID for this request. @@ -1231,8 +1237,8 @@ class NodeGroupsClient { /// [`future`]: @ref google::cloud::future /// [`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_007.proto#L178} + /// [google.cloud.cpp.compute.node_groups.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_groups/v1/node_groups.proto#L831} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr SetIamPolicy( @@ -1244,8 +1250,8 @@ class NodeGroupsClient { // clang-format off /// - /// Sets the access control policy on the specified resource. Replaces any - /// existing policy. + /// Sets the access control policy on the specified resource. + /// Replaces any existing policy. /// https://cloud.google.com/compute/docs/reference/rest/v1/nodeGroups/setIamPolicy /// /// @param request Unary RPCs, such as the one wrapped by this @@ -1267,8 +1273,8 @@ class NodeGroupsClient { /// [`future`]: @ref google::cloud::future /// [`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_007.proto#L178} + /// [google.cloud.cpp.compute.node_groups.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_groups/v1/node_groups.proto#L831} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr SetIamPolicy( @@ -1305,7 +1311,7 @@ class NodeGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.node_groups.v1.SetNodeTemplateRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_groups/v1/node_groups.proto#L729} + /// [google.cloud.cpp.compute.node_groups.v1.SetNodeTemplateRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_groups/v1/node_groups.proto#L849} /// // clang-format on future> SetNodeTemplate( @@ -1364,7 +1370,7 @@ class NodeGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.node_groups.v1.SetNodeTemplateRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_groups/v1/node_groups.proto#L729} + /// [google.cloud.cpp.compute.node_groups.v1.SetNodeTemplateRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_groups/v1/node_groups.proto#L849} /// // clang-format on future> SetNodeTemplate( @@ -1432,7 +1438,7 @@ class NodeGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.node_groups.v1.SimulateMaintenanceEventRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_groups/v1/node_groups.proto#L767} + /// [google.cloud.cpp.compute.node_groups.v1.SimulateMaintenanceEventRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_groups/v1/node_groups.proto#L890} /// // clang-format on future> @@ -1494,7 +1500,7 @@ class NodeGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.node_groups.v1.SimulateMaintenanceEventRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_groups/v1/node_groups.proto#L767} + /// [google.cloud.cpp.compute.node_groups.v1.SimulateMaintenanceEventRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_groups/v1/node_groups.proto#L890} /// // clang-format on future> @@ -1555,8 +1561,8 @@ class NodeGroupsClient { /// [`future`]: @ref google::cloud::future /// [`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_145.proto#L30} + /// [google.cloud.cpp.compute.node_groups.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_groups/v1/node_groups.proto#L932} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} /// // clang-format on StatusOr @@ -1591,8 +1597,8 @@ class NodeGroupsClient { /// [`future`]: @ref google::cloud::future /// [`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_145.proto#L30} + /// [google.cloud.cpp.compute.node_groups.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_groups/v1/node_groups.proto#L932} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.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 0c94514e229d5..c07fd52c33a98 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 "google/cloud/compute/v1/internal/common_001.pb.h" -#include "google/cloud/compute/v1/internal/common_007.pb.h" -#include "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_029.pb.h" -#include "google/cloud/compute/v1/internal/common_031.pb.h" -#include "google/cloud/compute/v1/internal/common_058.pb.h" -#include "google/cloud/compute/v1/internal/common_078.pb.h" -#include "google/cloud/compute/v1/internal/common_120.pb.h" -#include "google/cloud/compute/v1/internal/common_145.pb.h" -#include "google/cloud/compute/v1/internal/common_146.pb.h" -#include "google/cloud/compute/v1/internal/common_152.pb.h" +#include "google/cloud/compute/v1/internal/common_009.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_038.pb.h" +#include "google/cloud/compute/v1/internal/common_040.pb.h" +#include "google/cloud/compute/v1/internal/common_072.pb.h" +#include "google/cloud/compute/v1/internal/common_094.pb.h" +#include "google/cloud/compute/v1/internal/common_144.pb.h" +#include "google/cloud/compute/v1/internal/common_171.pb.h" +#include "google/cloud/compute/v1/internal/common_173.pb.h" +#include "google/cloud/compute/v1/internal/common_182.pb.h" // 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 1f0ff09841bdb..d867f0e0cd0a0 100644 --- a/google/cloud/compute/node_templates/v1/node_templates_client.h +++ b/google/cloud/compute/node_templates/v1/node_templates_client.h @@ -90,8 +90,10 @@ class NodeTemplatesClient { // clang-format off /// - /// Retrieves an aggregated list of node templates. To prevent failure, Google - /// recommends that you set the `returnPartialSuccess` parameter to `true`. + /// Retrieves an aggregated list of node templates. + /// + /// To prevent failure, Google recommends that you set the + /// `returnPartialSuccess` parameter to `true`. /// https://cloud.google.com/compute/docs/reference/rest/v1/nodeTemplates/aggregatedList /// /// @param project Project ID for this request. @@ -117,8 +119,8 @@ class NodeTemplatesClient { /// [`future`]: @ref google::cloud::future /// [`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_088.proto#L330} + /// [google.cloud.cpp.compute.node_templates.v1.AggregatedListNodeTemplatesRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_templates/v1/node_templates.proto#L140} + /// [google.cloud.cpp.compute.v1.NodeTemplatesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_103.proto#L387} /// // clang-format on StreamRange> @@ -250,7 +254,7 @@ class NodeTemplatesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.node_templates.v1.DeleteNodeTemplateRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_templates/v1/node_templates.proto#L219} + /// [google.cloud.cpp.compute.node_templates.v1.DeleteNodeTemplateRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_templates/v1/node_templates.proto#L255} /// // clang-format on future> @@ -310,8 +314,8 @@ class NodeTemplatesClient { /// [`future`]: @ref google::cloud::future /// [`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_088.proto#L30} + /// [google.cloud.cpp.compute.node_templates.v1.GetNodeTemplateRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_templates/v1/node_templates.proto#L310} + /// [google.cloud.cpp.compute.v1.NodeTemplate]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_103.proto#L32} /// // clang-format on StatusOr GetNodeTemplate( @@ -342,8 +346,8 @@ class NodeTemplatesClient { /// [`future`]: @ref google::cloud::future /// [`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_088.proto#L30} + /// [google.cloud.cpp.compute.node_templates.v1.GetNodeTemplateRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_templates/v1/node_templates.proto#L310} + /// [google.cloud.cpp.compute.v1.NodeTemplate]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_103.proto#L32} /// // clang-format on StatusOr GetNodeTemplate( @@ -373,8 +377,8 @@ class NodeTemplatesClient { /// [`future`]: @ref google::cloud::future /// [`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_007.proto#L178} + /// [google.cloud.cpp.compute.node_templates.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_templates/v1/node_templates.proto#L291} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr GetIamPolicy( @@ -406,8 +410,8 @@ class NodeTemplatesClient { /// [`future`]: @ref google::cloud::future /// [`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_007.proto#L178} + /// [google.cloud.cpp.compute.node_templates.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_templates/v1/node_templates.proto#L291} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr GetIamPolicy( @@ -444,7 +448,7 @@ class NodeTemplatesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.node_templates.v1.InsertNodeTemplateRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_templates/v1/node_templates.proto#L286} + /// [google.cloud.cpp.compute.node_templates.v1.InsertNodeTemplateRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_templates/v1/node_templates.proto#L325} /// // clang-format on future> @@ -502,7 +506,7 @@ class NodeTemplatesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.node_templates.v1.InsertNodeTemplateRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_templates/v1/node_templates.proto#L286} + /// [google.cloud.cpp.compute.node_templates.v1.InsertNodeTemplateRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_templates/v1/node_templates.proto#L325} /// // clang-format on future> @@ -543,7 +547,8 @@ class NodeTemplatesClient { // clang-format off /// - /// Retrieves a list of node templates available to the specified project. + /// Retrieves a list of node templates available to the specified + /// project. /// https://cloud.google.com/compute/docs/reference/rest/v1/nodeTemplates/list /// /// @param project Project ID for this request. @@ -570,8 +575,8 @@ class NodeTemplatesClient { /// [`future`]: @ref google::cloud::future /// [`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_088.proto#L30} + /// [google.cloud.cpp.compute.node_templates.v1.ListNodeTemplatesRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_templates/v1/node_templates.proto#L361} + /// [google.cloud.cpp.compute.v1.NodeTemplate]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_103.proto#L32} /// // clang-format on StreamRange ListNodeTemplates( @@ -579,7 +584,8 @@ class NodeTemplatesClient { // clang-format off /// - /// Retrieves a list of node templates available to the specified project. + /// Retrieves a list of node templates available to the specified + /// project. /// https://cloud.google.com/compute/docs/reference/rest/v1/nodeTemplates/list /// /// @param request Unary RPCs, such as the one wrapped by this @@ -610,8 +616,8 @@ class NodeTemplatesClient { /// [`future`]: @ref google::cloud::future /// [`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_088.proto#L30} + /// [google.cloud.cpp.compute.node_templates.v1.ListNodeTemplatesRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_templates/v1/node_templates.proto#L361} + /// [google.cloud.cpp.compute.v1.NodeTemplate]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_103.proto#L32} /// // clang-format on StreamRange ListNodeTemplates( @@ -621,8 +627,8 @@ class NodeTemplatesClient { // clang-format off /// - /// Sets the access control policy on the specified resource. Replaces any - /// existing policy. + /// Sets the access control policy on the specified resource. + /// Replaces any existing policy. /// https://cloud.google.com/compute/docs/reference/rest/v1/nodeTemplates/setIamPolicy /// /// @param project Project ID for this request. @@ -642,8 +648,8 @@ class NodeTemplatesClient { /// [`future`]: @ref google::cloud::future /// [`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_007.proto#L178} + /// [google.cloud.cpp.compute.node_templates.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_templates/v1/node_templates.proto#L466} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr SetIamPolicy( @@ -655,8 +661,8 @@ class NodeTemplatesClient { // clang-format off /// - /// Sets the access control policy on the specified resource. Replaces any - /// existing policy. + /// Sets the access control policy on the specified resource. + /// Replaces any existing policy. /// https://cloud.google.com/compute/docs/reference/rest/v1/nodeTemplates/setIamPolicy /// /// @param request Unary RPCs, such as the one wrapped by this @@ -678,8 +684,8 @@ class NodeTemplatesClient { /// [`future`]: @ref google::cloud::future /// [`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_007.proto#L178} + /// [google.cloud.cpp.compute.node_templates.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_templates/v1/node_templates.proto#L466} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr SetIamPolicy( @@ -709,8 +715,8 @@ class NodeTemplatesClient { /// [`future`]: @ref google::cloud::future /// [`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_145.proto#L30} + /// [google.cloud.cpp.compute.node_templates.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_templates/v1/node_templates.proto#L486} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} /// // clang-format on StatusOr @@ -745,8 +751,8 @@ class NodeTemplatesClient { /// [`future`]: @ref google::cloud::future /// [`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_145.proto#L30} + /// [google.cloud.cpp.compute.node_templates.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_templates/v1/node_templates.proto#L486} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.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 471001ad9c7a3..52c12549ca954 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 "google/cloud/compute/v1/internal/common_001.pb.h" -#include "google/cloud/compute/v1/internal/common_007.pb.h" -#include "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_031.pb.h" -#include "google/cloud/compute/v1/internal/common_078.pb.h" -#include "google/cloud/compute/v1/internal/common_088.pb.h" -#include "google/cloud/compute/v1/internal/common_108.pb.h" -#include "google/cloud/compute/v1/internal/common_145.pb.h" +#include "google/cloud/compute/v1/internal/common_009.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_040.pb.h" +#include "google/cloud/compute/v1/internal/common_094.pb.h" +#include "google/cloud/compute/v1/internal/common_103.pb.h" +#include "google/cloud/compute/v1/internal/common_126.pb.h" +#include "google/cloud/compute/v1/internal/common_171.pb.h" // 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 9766fe6db7c30..cdd87834bfda7 100644 --- a/google/cloud/compute/node_types/v1/node_types_client.h +++ b/google/cloud/compute/node_types/v1/node_types_client.h @@ -87,8 +87,10 @@ class NodeTypesClient { // clang-format off /// - /// Retrieves an aggregated list of node types. To prevent failure, Google - /// recommends that you set the `returnPartialSuccess` parameter to `true`. + /// Retrieves an aggregated list of node types. + /// + /// To prevent failure, Google recommends that you set the + /// `returnPartialSuccess` parameter to `true`. /// https://cloud.google.com/compute/docs/reference/rest/v1/nodeTypes/aggregatedList /// /// @param project Project ID for this request. @@ -114,8 +116,8 @@ class NodeTypesClient { /// [`future`]: @ref google::cloud::future /// [`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_089.proto#L297} + /// [google.cloud.cpp.compute.node_types.v1.AggregatedListNodeTypesRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_types/v1/node_types.proto#L74} + /// [google.cloud.cpp.compute.v1.NodeTypesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_104.proto#L345} /// // clang-format on StreamRange GetNodeType( @@ -219,8 +223,8 @@ class NodeTypesClient { /// [`future`]: @ref google::cloud::future /// [`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_089.proto#L31} + /// [google.cloud.cpp.compute.node_types.v1.GetNodeTypeRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_types/v1/node_types.proto#L189} + /// [google.cloud.cpp.compute.v1.NodeType]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_104.proto#L33} /// // clang-format on StatusOr GetNodeType( @@ -230,7 +234,8 @@ class NodeTypesClient { // clang-format off /// - /// Retrieves a list of node types available to the specified project. + /// Retrieves a list of node types available to the specified + /// project. /// https://cloud.google.com/compute/docs/reference/rest/v1/nodeTypes/list /// /// @param project Project ID for this request. @@ -257,8 +262,8 @@ class NodeTypesClient { /// [`future`]: @ref google::cloud::future /// [`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_089.proto#L31} + /// [google.cloud.cpp.compute.node_types.v1.ListNodeTypesRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_types/v1/node_types.proto#L203} + /// [google.cloud.cpp.compute.v1.NodeType]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_104.proto#L33} /// // clang-format on StreamRange ListNodeTypes( @@ -266,7 +271,8 @@ class NodeTypesClient { // clang-format off /// - /// Retrieves a list of node types available to the specified project. + /// Retrieves a list of node types available to the specified + /// project. /// https://cloud.google.com/compute/docs/reference/rest/v1/nodeTypes/list /// /// @param request Unary RPCs, such as the one wrapped by this @@ -297,8 +303,8 @@ class NodeTypesClient { /// [`future`]: @ref google::cloud::future /// [`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_089.proto#L31} + /// [google.cloud.cpp.compute.node_types.v1.ListNodeTypesRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_types/v1/node_types.proto#L203} + /// [google.cloud.cpp.compute.v1.NodeType]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_104.proto#L33} /// // 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 879dc6fdf95b8..306bd7e40750f 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 "google/cloud/compute/v1/internal/common_023.pb.h" -#include "google/cloud/compute/v1/internal/common_089.pb.h" +#include "google/cloud/compute/v1/internal/common_032.pb.h" +#include "google/cloud/compute/v1/internal/common_104.pb.h" // 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/organization_security_policies/v1/internal/organization_security_policies_option_defaults.cc b/google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_option_defaults.cc new file mode 100644 index 0000000000000..3ad84c41c9164 --- /dev/null +++ b/google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_option_defaults.cc @@ -0,0 +1,96 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/organization_security_policies/v1/organization_security_policies.proto + +#include "google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_option_defaults.h" +#include "google/cloud/compute/organization_security_policies/v1/organization_security_policies_connection.h" +#include "google/cloud/compute/organization_security_policies/v1/organization_security_policies_options.h" +#include "google/cloud/internal/populate_common_options.h" +#include "google/cloud/internal/populate_grpc_options.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_organization_security_policies_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +namespace { +auto constexpr kBackoffScaling = 2.0; +} // namespace + +Options OrganizationSecurityPoliciesDefaultOptions(Options options) { + options = internal::PopulateCommonOptions( + std::move(options), + "GOOGLE_CLOUD_CPP_ORGANIZATION_SECURITY_POLICIES_ENDPOINT", "", + "GOOGLE_CLOUD_CPP_ORGANIZATION_SECURITY_POLICIES_AUTHORITY", + "compute.googleapis.com"); + options = internal::PopulateGrpcOptions(std::move(options)); + if (!options.has()) { + options.set( + compute_organization_security_policies_v1:: + OrganizationSecurityPoliciesLimitedTimeRetryPolicy( + std::chrono::minutes(10)) + .clone()); + } + if (!options.has()) { + options.set( + ExponentialBackoffPolicy( + std::chrono::seconds(0), std::chrono::seconds(1), + std::chrono::minutes(5), kBackoffScaling, kBackoffScaling) + .clone()); + } + if (!options.has()) { + options.set( + GenericPollingPolicy< + compute_organization_security_policies_v1:: + OrganizationSecurityPoliciesRetryPolicyOption::Type, + compute_organization_security_policies_v1:: + OrganizationSecurityPoliciesBackoffPolicyOption::Type>( + options + .get() + ->clone(), + ExponentialBackoffPolicy(std::chrono::seconds(1), + std::chrono::minutes(5), kBackoffScaling) + .clone()) + .clone()); + } + if (!options.has< + compute_organization_security_policies_v1:: + OrganizationSecurityPoliciesConnectionIdempotencyPolicyOption>()) { + options.set< + compute_organization_security_policies_v1:: + OrganizationSecurityPoliciesConnectionIdempotencyPolicyOption>( + compute_organization_security_policies_v1:: + MakeDefaultOrganizationSecurityPoliciesConnectionIdempotencyPolicy()); + } + + return options; +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_organization_security_policies_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_option_defaults.h b/google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_option_defaults.h new file mode 100644 index 0000000000000..ba84c4645f7b5 --- /dev/null +++ b/google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_option_defaults.h @@ -0,0 +1,38 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/organization_security_policies/v1/organization_security_policies.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ORGANIZATION_SECURITY_POLICIES_V1_INTERNAL_ORGANIZATION_SECURITY_POLICIES_OPTION_DEFAULTS_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ORGANIZATION_SECURITY_POLICIES_V1_INTERNAL_ORGANIZATION_SECURITY_POLICIES_OPTION_DEFAULTS_H + +#include "google/cloud/options.h" +#include "google/cloud/version.h" + +namespace google { +namespace cloud { +namespace compute_organization_security_policies_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +Options OrganizationSecurityPoliciesDefaultOptions(Options options); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_organization_security_policies_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ORGANIZATION_SECURITY_POLICIES_V1_INTERNAL_ORGANIZATION_SECURITY_POLICIES_OPTION_DEFAULTS_H diff --git a/google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_rest_connection_impl.cc b/google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_rest_connection_impl.cc new file mode 100644 index 0000000000000..9456df2c648de --- /dev/null +++ b/google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_rest_connection_impl.cc @@ -0,0 +1,1439 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/organization_security_policies/v1/organization_security_policies.proto + +#include "google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_rest_connection_impl.h" +#include "google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_rest_stub_factory.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/internal/async_rest_long_running_operation_custom.h" +#include "google/cloud/internal/extract_long_running_result.h" +#include "google/cloud/internal/pagination_range.h" +#include "google/cloud/internal/rest_lro_helpers.h" +#include "google/cloud/internal/rest_retry_loop.h" +#include "google/cloud/rest_options.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_organization_security_policies_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +OrganizationSecurityPoliciesRestConnectionImpl:: + OrganizationSecurityPoliciesRestConnectionImpl( + std::unique_ptr background, + std::shared_ptr + stub, + Options options) + : background_(std::move(background)), + stub_(std::move(stub)), + options_(internal::MergeOptions( + std::move(options), + OrganizationSecurityPoliciesConnection::options())) {} + +future> +OrganizationSecurityPoliciesRestConnectionImpl::AddAssociation( + google::cloud::cpp::compute::organization_security_policies::v1:: + AddAssociationRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::global_organization_operations::v1:: + GetOperationRequest, + google::cloud::cpp::compute::global_organization_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, request, + [stub = stub_]( + CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + AddAssociationRequest const& request) { + return stub->AsyncAddAssociation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_]( + CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_organization_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_]( + CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_organization_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->AddAssociation(request), + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [request](std::string const& op, + google::cloud::cpp::compute::global_organization_operations:: + 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); }); +} + +StatusOr +OrganizationSecurityPoliciesRestConnectionImpl::AddAssociation( + NoAwaitTag, google::cloud::cpp::compute::organization_security_policies:: + v1::AddAssociationRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->AddAssociation(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + AddAssociationRequest const& request) { + return stub_->AddAssociation(rest_context, options, request); + }, + *current, request, __func__); +} + +future> +OrganizationSecurityPoliciesRestConnectionImpl::AddAssociation( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestAwaitLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::global_organization_operations::v1:: + GetOperationRequest, + google::cloud::cpp::compute::global_organization_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, operation, + [stub = stub_]( + CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_organization_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_]( + CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_organization_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [operation](std::string const&, + google::cloud::cpp::compute::global_organization_operations:: + v1::GetOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_operation(info.operation); + }, + [operation](std::string const&, + google::cloud::cpp::compute::global_organization_operations:: + v1::DeleteOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_operation(info.operation); + }); +} + +future> +OrganizationSecurityPoliciesRestConnectionImpl::AddRule( + google::cloud::cpp::compute::organization_security_policies::v1:: + AddRuleRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::global_organization_operations::v1:: + GetOperationRequest, + google::cloud::cpp::compute::global_organization_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, request, + [stub = stub_]( + CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + AddRuleRequest const& request) { + return stub->AsyncAddRule(cq, std::move(context), std::move(options), + request); + }, + [stub = stub_]( + CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_organization_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_]( + CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_organization_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->AddRule(request), polling_policy(*current), + __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [request](std::string const& op, + google::cloud::cpp::compute::global_organization_operations:: + 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); }); +} + +StatusOr +OrganizationSecurityPoliciesRestConnectionImpl::AddRule( + NoAwaitTag, google::cloud::cpp::compute::organization_security_policies:: + v1::AddRuleRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->AddRule(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + AddRuleRequest const& request) { + return stub_->AddRule(rest_context, options, request); + }, + *current, request, __func__); +} + +future> +OrganizationSecurityPoliciesRestConnectionImpl::AddRule( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestAwaitLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::global_organization_operations::v1:: + GetOperationRequest, + google::cloud::cpp::compute::global_organization_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, operation, + [stub = stub_]( + CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_organization_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_]( + CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_organization_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [operation](std::string const&, + google::cloud::cpp::compute::global_organization_operations:: + v1::GetOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_operation(info.operation); + }, + [operation](std::string const&, + google::cloud::cpp::compute::global_organization_operations:: + v1::DeleteOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_operation(info.operation); + }); +} + +future> +OrganizationSecurityPoliciesRestConnectionImpl::CopyRules( + google::cloud::cpp::compute::organization_security_policies::v1:: + CopyRulesRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::global_organization_operations::v1:: + GetOperationRequest, + google::cloud::cpp::compute::global_organization_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, request, + [stub = stub_]( + CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + CopyRulesRequest const& request) { + return stub->AsyncCopyRules(cq, std::move(context), std::move(options), + request); + }, + [stub = stub_]( + CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_organization_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_]( + CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_organization_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->CopyRules(request), + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [request](std::string const& op, + google::cloud::cpp::compute::global_organization_operations:: + 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); }); +} + +StatusOr +OrganizationSecurityPoliciesRestConnectionImpl::CopyRules( + NoAwaitTag, google::cloud::cpp::compute::organization_security_policies:: + v1::CopyRulesRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->CopyRules(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + CopyRulesRequest const& request) { + return stub_->CopyRules(rest_context, options, request); + }, + *current, request, __func__); +} + +future> +OrganizationSecurityPoliciesRestConnectionImpl::CopyRules( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestAwaitLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::global_organization_operations::v1:: + GetOperationRequest, + google::cloud::cpp::compute::global_organization_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, operation, + [stub = stub_]( + CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_organization_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_]( + CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_organization_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [operation](std::string const&, + google::cloud::cpp::compute::global_organization_operations:: + v1::GetOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_operation(info.operation); + }, + [operation](std::string const&, + google::cloud::cpp::compute::global_organization_operations:: + v1::DeleteOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_operation(info.operation); + }); +} + +future> +OrganizationSecurityPoliciesRestConnectionImpl::DeleteSecurityPolicy( + google::cloud::cpp::compute::organization_security_policies::v1:: + DeleteSecurityPolicyRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::global_organization_operations::v1:: + GetOperationRequest, + google::cloud::cpp::compute::global_organization_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, request, + [stub = stub_]( + CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + DeleteSecurityPolicyRequest const& request) { + return stub->AsyncDeleteSecurityPolicy(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_]( + CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_organization_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_]( + CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_organization_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->DeleteSecurityPolicy(request), + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [request](std::string const& op, + google::cloud::cpp::compute::global_organization_operations:: + 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); }); +} + +StatusOr +OrganizationSecurityPoliciesRestConnectionImpl::DeleteSecurityPolicy( + NoAwaitTag, google::cloud::cpp::compute::organization_security_policies:: + v1::DeleteSecurityPolicyRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->DeleteSecurityPolicy(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + DeleteSecurityPolicyRequest const& request) { + return stub_->DeleteSecurityPolicy(rest_context, options, request); + }, + *current, request, __func__); +} + +future> +OrganizationSecurityPoliciesRestConnectionImpl::DeleteSecurityPolicy( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestAwaitLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::global_organization_operations::v1:: + GetOperationRequest, + google::cloud::cpp::compute::global_organization_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, operation, + [stub = stub_]( + CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_organization_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_]( + CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_organization_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [operation](std::string const&, + google::cloud::cpp::compute::global_organization_operations:: + v1::GetOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_operation(info.operation); + }, + [operation](std::string const&, + google::cloud::cpp::compute::global_organization_operations:: + v1::DeleteOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_operation(info.operation); + }); +} + +StatusOr +OrganizationSecurityPoliciesRestConnectionImpl::GetSecurityPolicy( + google::cloud::cpp::compute::organization_security_policies::v1:: + GetSecurityPolicyRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->GetSecurityPolicy(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + GetSecurityPolicyRequest const& request) { + return stub_->GetSecurityPolicy(rest_context, options, request); + }, + *current, request, __func__); +} + +StatusOr +OrganizationSecurityPoliciesRestConnectionImpl::GetAssociation( + google::cloud::cpp::compute::organization_security_policies::v1:: + GetAssociationRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->GetAssociation(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + GetAssociationRequest const& request) { + return stub_->GetAssociation(rest_context, options, request); + }, + *current, request, __func__); +} + +StatusOr +OrganizationSecurityPoliciesRestConnectionImpl::GetRule( + google::cloud::cpp::compute::organization_security_policies::v1:: + GetRuleRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->GetRule(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + GetRuleRequest const& request) { + return stub_->GetRule(rest_context, options, request); + }, + *current, request, __func__); +} + +future> +OrganizationSecurityPoliciesRestConnectionImpl::InsertSecurityPolicy( + google::cloud::cpp::compute::organization_security_policies::v1:: + InsertSecurityPolicyRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::global_organization_operations::v1:: + GetOperationRequest, + google::cloud::cpp::compute::global_organization_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, request, + [stub = stub_]( + CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + InsertSecurityPolicyRequest const& request) { + return stub->AsyncInsertSecurityPolicy(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_]( + CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_organization_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_]( + CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_organization_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->InsertSecurityPolicy(request), + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [request](std::string const& op, + google::cloud::cpp::compute::global_organization_operations:: + 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); }); +} + +StatusOr +OrganizationSecurityPoliciesRestConnectionImpl::InsertSecurityPolicy( + NoAwaitTag, google::cloud::cpp::compute::organization_security_policies:: + v1::InsertSecurityPolicyRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->InsertSecurityPolicy(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + InsertSecurityPolicyRequest const& request) { + return stub_->InsertSecurityPolicy(rest_context, options, request); + }, + *current, request, __func__); +} + +future> +OrganizationSecurityPoliciesRestConnectionImpl::InsertSecurityPolicy( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestAwaitLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::global_organization_operations::v1:: + GetOperationRequest, + google::cloud::cpp::compute::global_organization_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, operation, + [stub = stub_]( + CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_organization_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_]( + CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_organization_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [operation](std::string const&, + google::cloud::cpp::compute::global_organization_operations:: + v1::GetOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_operation(info.operation); + }, + [operation](std::string const&, + google::cloud::cpp::compute::global_organization_operations:: + v1::DeleteOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_operation(info.operation); + }); +} + +StreamRange +OrganizationSecurityPoliciesRestConnectionImpl:: + ListOrganizationSecurityPolicies( + google::cloud::cpp::compute::organization_security_policies::v1:: + ListOrganizationSecurityPoliciesRequest request) { + request.clear_page_token(); + auto current = google::cloud::internal::SaveCurrentOptions(); + auto idempotency = + idempotency_policy(*current)->ListOrganizationSecurityPolicies(request); + char const* function_name = __func__; + return google::cloud::internal::MakePaginationRange< + StreamRange>( + current, std::move(request), + [idempotency, function_name, stub = stub_, + retry = std::shared_ptr( + retry_policy(*current)), + backoff = std::shared_ptr(backoff_policy(*current))]( + Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + ListOrganizationSecurityPoliciesRequest const& r) { + return google::cloud::rest_internal::RestRetryLoop( + retry->clone(), backoff->clone(), idempotency, + [stub](rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies:: + v1::ListOrganizationSecurityPoliciesRequest const& + request) { + return stub->ListOrganizationSecurityPolicies(rest_context, + options, request); + }, + options, r, function_name); + }, + [](google::cloud::cpp::compute::v1::SecurityPolicyList r) { + std::vector result( + r.items().size()); + auto& messages = *r.mutable_items(); + std::move(messages.begin(), messages.end(), result.begin()); + return result; + }); +} + +StatusOr +OrganizationSecurityPoliciesRestConnectionImpl::ListAssociations( + google::cloud::cpp::compute::organization_security_policies::v1:: + ListAssociationsRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->ListAssociations(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + ListAssociationsRequest const& request) { + return stub_->ListAssociations(rest_context, options, request); + }, + *current, request, __func__); +} + +StatusOr +OrganizationSecurityPoliciesRestConnectionImpl::ListPreconfiguredExpressionSets( + google::cloud::cpp::compute::organization_security_policies::v1:: + ListPreconfiguredExpressionSetsRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->ListPreconfiguredExpressionSets(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + ListPreconfiguredExpressionSetsRequest const& request) { + return stub_->ListPreconfiguredExpressionSets(rest_context, options, + request); + }, + *current, request, __func__); +} + +future> +OrganizationSecurityPoliciesRestConnectionImpl::Move( + google::cloud::cpp::compute::organization_security_policies::v1:: + MoveRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::global_organization_operations::v1:: + GetOperationRequest, + google::cloud::cpp::compute::global_organization_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, request, + [stub = stub_]( + CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + MoveRequest const& request) { + return stub->AsyncMove(cq, std::move(context), std::move(options), + request); + }, + [stub = stub_]( + CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_organization_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_]( + CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_organization_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->Move(request), polling_policy(*current), + __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [request](std::string const& op, + google::cloud::cpp::compute::global_organization_operations:: + 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); }); +} + +StatusOr +OrganizationSecurityPoliciesRestConnectionImpl::Move( + NoAwaitTag, google::cloud::cpp::compute::organization_security_policies:: + v1::MoveRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->Move(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + MoveRequest const& request) { + return stub_->Move(rest_context, options, request); + }, + *current, request, __func__); +} + +future> +OrganizationSecurityPoliciesRestConnectionImpl::Move( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestAwaitLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::global_organization_operations::v1:: + GetOperationRequest, + google::cloud::cpp::compute::global_organization_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, operation, + [stub = stub_]( + CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_organization_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_]( + CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_organization_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [operation](std::string const&, + google::cloud::cpp::compute::global_organization_operations:: + v1::GetOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_operation(info.operation); + }, + [operation](std::string const&, + google::cloud::cpp::compute::global_organization_operations:: + v1::DeleteOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_operation(info.operation); + }); +} + +future> +OrganizationSecurityPoliciesRestConnectionImpl::PatchSecurityPolicy( + google::cloud::cpp::compute::organization_security_policies::v1:: + PatchSecurityPolicyRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::global_organization_operations::v1:: + GetOperationRequest, + google::cloud::cpp::compute::global_organization_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, request, + [stub = stub_]( + CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + PatchSecurityPolicyRequest const& request) { + return stub->AsyncPatchSecurityPolicy(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_]( + CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_organization_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_]( + CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_organization_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->PatchSecurityPolicy(request), + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [request](std::string const& op, + google::cloud::cpp::compute::global_organization_operations:: + 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); }); +} + +StatusOr +OrganizationSecurityPoliciesRestConnectionImpl::PatchSecurityPolicy( + NoAwaitTag, google::cloud::cpp::compute::organization_security_policies:: + v1::PatchSecurityPolicyRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->PatchSecurityPolicy(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + PatchSecurityPolicyRequest const& request) { + return stub_->PatchSecurityPolicy(rest_context, options, request); + }, + *current, request, __func__); +} + +future> +OrganizationSecurityPoliciesRestConnectionImpl::PatchSecurityPolicy( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestAwaitLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::global_organization_operations::v1:: + GetOperationRequest, + google::cloud::cpp::compute::global_organization_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, operation, + [stub = stub_]( + CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_organization_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_]( + CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_organization_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [operation](std::string const&, + google::cloud::cpp::compute::global_organization_operations:: + v1::GetOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_operation(info.operation); + }, + [operation](std::string const&, + google::cloud::cpp::compute::global_organization_operations:: + v1::DeleteOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_operation(info.operation); + }); +} + +future> +OrganizationSecurityPoliciesRestConnectionImpl::PatchRule( + google::cloud::cpp::compute::organization_security_policies::v1:: + PatchRuleRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::global_organization_operations::v1:: + GetOperationRequest, + google::cloud::cpp::compute::global_organization_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, request, + [stub = stub_]( + CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + PatchRuleRequest const& request) { + return stub->AsyncPatchRule(cq, std::move(context), std::move(options), + request); + }, + [stub = stub_]( + CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_organization_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_]( + CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_organization_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->PatchRule(request), + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [request](std::string const& op, + google::cloud::cpp::compute::global_organization_operations:: + 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); }); +} + +StatusOr +OrganizationSecurityPoliciesRestConnectionImpl::PatchRule( + NoAwaitTag, google::cloud::cpp::compute::organization_security_policies:: + v1::PatchRuleRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->PatchRule(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + PatchRuleRequest const& request) { + return stub_->PatchRule(rest_context, options, request); + }, + *current, request, __func__); +} + +future> +OrganizationSecurityPoliciesRestConnectionImpl::PatchRule( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestAwaitLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::global_organization_operations::v1:: + GetOperationRequest, + google::cloud::cpp::compute::global_organization_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, operation, + [stub = stub_]( + CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_organization_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_]( + CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_organization_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [operation](std::string const&, + google::cloud::cpp::compute::global_organization_operations:: + v1::GetOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_operation(info.operation); + }, + [operation](std::string const&, + google::cloud::cpp::compute::global_organization_operations:: + v1::DeleteOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_operation(info.operation); + }); +} + +future> +OrganizationSecurityPoliciesRestConnectionImpl::RemoveAssociation( + google::cloud::cpp::compute::organization_security_policies::v1:: + RemoveAssociationRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::global_organization_operations::v1:: + GetOperationRequest, + google::cloud::cpp::compute::global_organization_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, request, + [stub = stub_]( + CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + RemoveAssociationRequest const& request) { + return stub->AsyncRemoveAssociation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_]( + CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_organization_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_]( + CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_organization_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->RemoveAssociation(request), + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [request](std::string const& op, + google::cloud::cpp::compute::global_organization_operations:: + 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); }); +} + +StatusOr +OrganizationSecurityPoliciesRestConnectionImpl::RemoveAssociation( + NoAwaitTag, google::cloud::cpp::compute::organization_security_policies:: + v1::RemoveAssociationRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->RemoveAssociation(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + RemoveAssociationRequest const& request) { + return stub_->RemoveAssociation(rest_context, options, request); + }, + *current, request, __func__); +} + +future> +OrganizationSecurityPoliciesRestConnectionImpl::RemoveAssociation( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestAwaitLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::global_organization_operations::v1:: + GetOperationRequest, + google::cloud::cpp::compute::global_organization_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, operation, + [stub = stub_]( + CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_organization_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_]( + CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_organization_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [operation](std::string const&, + google::cloud::cpp::compute::global_organization_operations:: + v1::GetOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_operation(info.operation); + }, + [operation](std::string const&, + google::cloud::cpp::compute::global_organization_operations:: + v1::DeleteOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_operation(info.operation); + }); +} + +future> +OrganizationSecurityPoliciesRestConnectionImpl::RemoveRule( + google::cloud::cpp::compute::organization_security_policies::v1:: + RemoveRuleRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::global_organization_operations::v1:: + GetOperationRequest, + google::cloud::cpp::compute::global_organization_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, request, + [stub = stub_]( + CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + RemoveRuleRequest const& request) { + return stub->AsyncRemoveRule(cq, std::move(context), std::move(options), + request); + }, + [stub = stub_]( + CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_organization_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_]( + CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_organization_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->RemoveRule(request), + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [request](std::string const& op, + google::cloud::cpp::compute::global_organization_operations:: + 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); }); +} + +StatusOr +OrganizationSecurityPoliciesRestConnectionImpl::RemoveRule( + NoAwaitTag, google::cloud::cpp::compute::organization_security_policies:: + v1::RemoveRuleRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->RemoveRule(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + RemoveRuleRequest const& request) { + return stub_->RemoveRule(rest_context, options, request); + }, + *current, request, __func__); +} + +future> +OrganizationSecurityPoliciesRestConnectionImpl::RemoveRule( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestAwaitLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::global_organization_operations::v1:: + GetOperationRequest, + google::cloud::cpp::compute::global_organization_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, operation, + [stub = stub_]( + CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_organization_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_]( + CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_organization_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [operation](std::string const&, + google::cloud::cpp::compute::global_organization_operations:: + v1::GetOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_operation(info.operation); + }, + [operation](std::string const&, + google::cloud::cpp::compute::global_organization_operations:: + v1::DeleteOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_operation(info.operation); + }); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_organization_security_policies_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_rest_connection_impl.h b/google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_rest_connection_impl.h new file mode 100644 index 0000000000000..49c51acd04e34 --- /dev/null +++ b/google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_rest_connection_impl.h @@ -0,0 +1,250 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/organization_security_policies/v1/organization_security_policies.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ORGANIZATION_SECURITY_POLICIES_V1_INTERNAL_ORGANIZATION_SECURITY_POLICIES_REST_CONNECTION_IMPL_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ORGANIZATION_SECURITY_POLICIES_V1_INTERNAL_ORGANIZATION_SECURITY_POLICIES_REST_CONNECTION_IMPL_H + +#include "google/cloud/compute/global_organization_operations/v1/global_organization_operations.pb.h" +#include "google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_rest_stub.h" +#include "google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_retry_traits.h" +#include "google/cloud/compute/organization_security_policies/v1/organization_security_policies_connection.h" +#include "google/cloud/compute/organization_security_policies/v1/organization_security_policies_connection_idempotency_policy.h" +#include "google/cloud/compute/organization_security_policies/v1/organization_security_policies_options.h" +#include "google/cloud/background_threads.h" +#include "google/cloud/backoff_policy.h" +#include "google/cloud/options.h" +#include "google/cloud/status_or.h" +#include "google/cloud/stream_range.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_organization_security_policies_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class OrganizationSecurityPoliciesRestConnectionImpl + : public compute_organization_security_policies_v1:: + OrganizationSecurityPoliciesConnection { + public: + ~OrganizationSecurityPoliciesRestConnectionImpl() override = default; + + OrganizationSecurityPoliciesRestConnectionImpl( + std::unique_ptr background, + std::shared_ptr + stub, + Options options); + + Options options() override { return options_; } + + future> AddAssociation( + google::cloud::cpp::compute::organization_security_policies::v1:: + AddAssociationRequest const& request) override; + + StatusOr AddAssociation( + NoAwaitTag, google::cloud::cpp::compute::organization_security_policies:: + v1::AddAssociationRequest const& request) override; + + future> AddAssociation( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + future> AddRule( + google::cloud::cpp::compute::organization_security_policies::v1:: + AddRuleRequest const& request) override; + + StatusOr AddRule( + NoAwaitTag, google::cloud::cpp::compute::organization_security_policies:: + v1::AddRuleRequest const& request) override; + + future> AddRule( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + future> CopyRules( + google::cloud::cpp::compute::organization_security_policies::v1:: + CopyRulesRequest const& request) override; + + StatusOr CopyRules( + NoAwaitTag, google::cloud::cpp::compute::organization_security_policies:: + v1::CopyRulesRequest const& request) override; + + future> CopyRules( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + future> + DeleteSecurityPolicy( + google::cloud::cpp::compute::organization_security_policies::v1:: + DeleteSecurityPolicyRequest const& request) override; + + StatusOr DeleteSecurityPolicy( + NoAwaitTag, google::cloud::cpp::compute::organization_security_policies:: + v1::DeleteSecurityPolicyRequest const& request) override; + + future> + DeleteSecurityPolicy( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + StatusOr GetSecurityPolicy( + google::cloud::cpp::compute::organization_security_policies::v1:: + GetSecurityPolicyRequest const& request) override; + + StatusOr + GetAssociation(google::cloud::cpp::compute::organization_security_policies:: + v1::GetAssociationRequest const& request) override; + + StatusOr GetRule( + google::cloud::cpp::compute::organization_security_policies::v1:: + GetRuleRequest const& request) override; + + future> + InsertSecurityPolicy( + google::cloud::cpp::compute::organization_security_policies::v1:: + InsertSecurityPolicyRequest const& request) override; + + StatusOr InsertSecurityPolicy( + NoAwaitTag, google::cloud::cpp::compute::organization_security_policies:: + v1::InsertSecurityPolicyRequest const& request) override; + + future> + InsertSecurityPolicy( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + StreamRange + ListOrganizationSecurityPolicies( + google::cloud::cpp::compute::organization_security_policies::v1:: + ListOrganizationSecurityPoliciesRequest request) override; + + StatusOr + ListAssociations(google::cloud::cpp::compute::organization_security_policies:: + v1::ListAssociationsRequest const& request) override; + + StatusOr + ListPreconfiguredExpressionSets( + google::cloud::cpp::compute::organization_security_policies::v1:: + ListPreconfiguredExpressionSetsRequest const& request) override; + + future> Move( + google::cloud::cpp::compute::organization_security_policies::v1:: + MoveRequest const& request) override; + + StatusOr Move( + NoAwaitTag, google::cloud::cpp::compute::organization_security_policies:: + v1::MoveRequest const& request) override; + + future> Move( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + future> + PatchSecurityPolicy( + google::cloud::cpp::compute::organization_security_policies::v1:: + PatchSecurityPolicyRequest const& request) override; + + StatusOr PatchSecurityPolicy( + NoAwaitTag, google::cloud::cpp::compute::organization_security_policies:: + v1::PatchSecurityPolicyRequest const& request) override; + + future> + PatchSecurityPolicy( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + future> PatchRule( + google::cloud::cpp::compute::organization_security_policies::v1:: + PatchRuleRequest const& request) override; + + StatusOr PatchRule( + NoAwaitTag, google::cloud::cpp::compute::organization_security_policies:: + v1::PatchRuleRequest const& request) override; + + future> PatchRule( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + future> + RemoveAssociation( + google::cloud::cpp::compute::organization_security_policies::v1:: + RemoveAssociationRequest const& request) override; + + StatusOr RemoveAssociation( + NoAwaitTag, google::cloud::cpp::compute::organization_security_policies:: + v1::RemoveAssociationRequest const& request) override; + + future> + RemoveAssociation( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + future> RemoveRule( + google::cloud::cpp::compute::organization_security_policies::v1:: + RemoveRuleRequest const& request) override; + + StatusOr RemoveRule( + NoAwaitTag, google::cloud::cpp::compute::organization_security_policies:: + v1::RemoveRuleRequest const& request) override; + + future> RemoveRule( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + private: + static std::unique_ptr + retry_policy(Options const& options) { + return options + .get() + ->clone(); + } + + static std::unique_ptr backoff_policy(Options const& options) { + return options + .get() + ->clone(); + } + + static std::unique_ptr< + compute_organization_security_policies_v1:: + OrganizationSecurityPoliciesConnectionIdempotencyPolicy> + idempotency_policy(Options const& options) { + return options + .get< + compute_organization_security_policies_v1:: + OrganizationSecurityPoliciesConnectionIdempotencyPolicyOption>() + ->clone(); + } + + static std::unique_ptr polling_policy(Options const& options) { + return options + .get() + ->clone(); + } + + std::unique_ptr background_; + std::shared_ptr + stub_; + Options options_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_organization_security_policies_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ORGANIZATION_SECURITY_POLICIES_V1_INTERNAL_ORGANIZATION_SECURITY_POLICIES_REST_CONNECTION_IMPL_H diff --git a/google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_rest_logging_decorator.cc b/google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_rest_logging_decorator.cc new file mode 100644 index 0000000000000..b13c04ab0f0b8 --- /dev/null +++ b/google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_rest_logging_decorator.cc @@ -0,0 +1,509 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/organization_security_policies/v1/organization_security_policies.proto + +#include "google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_rest_logging_decorator.h" +#include "google/cloud/internal/log_wrapper.h" +#include "google/cloud/status_or.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_organization_security_policies_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +OrganizationSecurityPoliciesRestLogging:: + OrganizationSecurityPoliciesRestLogging( + std::shared_ptr child, + TracingOptions tracing_options, std::set components) + : child_(std::move(child)), + tracing_options_(std::move(tracing_options)), + components_(std::move(components)) {} + +future> +OrganizationSecurityPoliciesRestLogging::AsyncAddAssociation( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + AddAssociationRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + AddAssociationRequest const& request) { + return child_->AsyncAddAssociation(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +StatusOr +OrganizationSecurityPoliciesRestLogging::AddAssociation( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + AddAssociationRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + AddAssociationRequest const& request) { + return child_->AddAssociation(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +future> +OrganizationSecurityPoliciesRestLogging::AsyncAddRule( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + AddRuleRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + AddRuleRequest const& request) { + return child_->AsyncAddRule(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +StatusOr +OrganizationSecurityPoliciesRestLogging::AddRule( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + AddRuleRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + AddRuleRequest const& request) { + return child_->AddRule(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +future> +OrganizationSecurityPoliciesRestLogging::AsyncCopyRules( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + CopyRulesRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + CopyRulesRequest const& request) { + return child_->AsyncCopyRules(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +StatusOr +OrganizationSecurityPoliciesRestLogging::CopyRules( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + CopyRulesRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + CopyRulesRequest const& request) { + return child_->CopyRules(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +future> +OrganizationSecurityPoliciesRestLogging::AsyncDeleteSecurityPolicy( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + DeleteSecurityPolicyRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + DeleteSecurityPolicyRequest const& request) { + return child_->AsyncDeleteSecurityPolicy(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +StatusOr +OrganizationSecurityPoliciesRestLogging::DeleteSecurityPolicy( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + DeleteSecurityPolicyRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + DeleteSecurityPolicyRequest const& request) { + return child_->DeleteSecurityPolicy(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +StatusOr +OrganizationSecurityPoliciesRestLogging::GetSecurityPolicy( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + GetSecurityPolicyRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + GetSecurityPolicyRequest const& request) { + return child_->GetSecurityPolicy(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +StatusOr +OrganizationSecurityPoliciesRestLogging::GetAssociation( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + GetAssociationRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + GetAssociationRequest const& request) { + return child_->GetAssociation(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +StatusOr +OrganizationSecurityPoliciesRestLogging::GetRule( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + GetRuleRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + GetRuleRequest const& request) { + return child_->GetRule(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +future> +OrganizationSecurityPoliciesRestLogging::AsyncInsertSecurityPolicy( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + InsertSecurityPolicyRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + InsertSecurityPolicyRequest const& request) { + return child_->AsyncInsertSecurityPolicy(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +StatusOr +OrganizationSecurityPoliciesRestLogging::InsertSecurityPolicy( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + InsertSecurityPolicyRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + InsertSecurityPolicyRequest const& request) { + return child_->InsertSecurityPolicy(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +StatusOr +OrganizationSecurityPoliciesRestLogging::ListOrganizationSecurityPolicies( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + ListOrganizationSecurityPoliciesRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + ListOrganizationSecurityPoliciesRequest const& request) { + return child_->ListOrganizationSecurityPolicies(rest_context, options, + request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +StatusOr +OrganizationSecurityPoliciesRestLogging::ListAssociations( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + ListAssociationsRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + ListAssociationsRequest const& request) { + return child_->ListAssociations(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +StatusOr +OrganizationSecurityPoliciesRestLogging::ListPreconfiguredExpressionSets( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + ListPreconfiguredExpressionSetsRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + ListPreconfiguredExpressionSetsRequest const& request) { + return child_->ListPreconfiguredExpressionSets(rest_context, options, + request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +future> +OrganizationSecurityPoliciesRestLogging::AsyncMove( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + MoveRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + MoveRequest const& request) { + return child_->AsyncMove(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +StatusOr +OrganizationSecurityPoliciesRestLogging::Move( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + MoveRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + MoveRequest const& request) { + return child_->Move(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +future> +OrganizationSecurityPoliciesRestLogging::AsyncPatchSecurityPolicy( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + PatchSecurityPolicyRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + PatchSecurityPolicyRequest const& request) { + return child_->AsyncPatchSecurityPolicy(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +StatusOr +OrganizationSecurityPoliciesRestLogging::PatchSecurityPolicy( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + PatchSecurityPolicyRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + PatchSecurityPolicyRequest const& request) { + return child_->PatchSecurityPolicy(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +future> +OrganizationSecurityPoliciesRestLogging::AsyncPatchRule( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + PatchRuleRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + PatchRuleRequest const& request) { + return child_->AsyncPatchRule(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +StatusOr +OrganizationSecurityPoliciesRestLogging::PatchRule( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + PatchRuleRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + PatchRuleRequest const& request) { + return child_->PatchRule(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +future> +OrganizationSecurityPoliciesRestLogging::AsyncRemoveAssociation( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + RemoveAssociationRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + RemoveAssociationRequest const& request) { + return child_->AsyncRemoveAssociation(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +StatusOr +OrganizationSecurityPoliciesRestLogging::RemoveAssociation( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + RemoveAssociationRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + RemoveAssociationRequest const& request) { + return child_->RemoveAssociation(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +future> +OrganizationSecurityPoliciesRestLogging::AsyncRemoveRule( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + RemoveRuleRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + RemoveRuleRequest const& request) { + return child_->AsyncRemoveRule(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +StatusOr +OrganizationSecurityPoliciesRestLogging::RemoveRule( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + RemoveRuleRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + RemoveRuleRequest const& request) { + return child_->RemoveRule(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +future> +OrganizationSecurityPoliciesRestLogging::AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_organization_operations::v1:: + GetOperationRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_organization_operations::v1:: + GetOperationRequest const& request) { + return child_->AsyncGetOperation(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +future OrganizationSecurityPoliciesRestLogging::AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_organization_operations::v1:: + DeleteOperationRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_organization_operations::v1:: + DeleteOperationRequest const& request) { + return child_->AsyncCancelOperation(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_organization_security_policies_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_rest_logging_decorator.h b/google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_rest_logging_decorator.h new file mode 100644 index 0000000000000..bebcfbd865782 --- /dev/null +++ b/google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_rest_logging_decorator.h @@ -0,0 +1,248 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/organization_security_policies/v1/organization_security_policies.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ORGANIZATION_SECURITY_POLICIES_V1_INTERNAL_ORGANIZATION_SECURITY_POLICIES_REST_LOGGING_DECORATOR_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ORGANIZATION_SECURITY_POLICIES_V1_INTERNAL_ORGANIZATION_SECURITY_POLICIES_REST_LOGGING_DECORATOR_H + +#include "google/cloud/compute/global_organization_operations/v1/global_organization_operations.pb.h" +#include "google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_rest_stub.h" +#include "google/cloud/compute/organization_security_policies/v1/organization_security_policies.pb.h" +#include "google/cloud/future.h" +#include "google/cloud/internal/rest_context.h" +#include "google/cloud/tracing_options.h" +#include "google/cloud/version.h" +#include +#include +#include + +namespace google { +namespace cloud { +namespace compute_organization_security_policies_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class OrganizationSecurityPoliciesRestLogging + : public OrganizationSecurityPoliciesRestStub { + public: + ~OrganizationSecurityPoliciesRestLogging() override = default; + OrganizationSecurityPoliciesRestLogging( + std::shared_ptr child, + TracingOptions tracing_options, std::set components); + + future> + AsyncAddAssociation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + AddAssociationRequest const& request) override; + + StatusOr AddAssociation( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + AddAssociationRequest const& request) override; + + future> AsyncAddRule( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + AddRuleRequest const& request) override; + + StatusOr AddRule( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + AddRuleRequest const& request) override; + + future> AsyncCopyRules( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + CopyRulesRequest const& request) override; + + StatusOr CopyRules( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + CopyRulesRequest const& request) override; + + future> + AsyncDeleteSecurityPolicy( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + DeleteSecurityPolicyRequest const& request) override; + + StatusOr DeleteSecurityPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + DeleteSecurityPolicyRequest const& request) override; + + StatusOr GetSecurityPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + GetSecurityPolicyRequest const& request) override; + + StatusOr + GetAssociation(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies:: + v1::GetAssociationRequest const& request) override; + + StatusOr GetRule( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + GetRuleRequest const& request) override; + + future> + AsyncInsertSecurityPolicy( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + InsertSecurityPolicyRequest const& request) override; + + StatusOr InsertSecurityPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + InsertSecurityPolicyRequest const& request) override; + + StatusOr + ListOrganizationSecurityPolicies( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + ListOrganizationSecurityPoliciesRequest const& request) override; + + StatusOr + ListAssociations(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies:: + v1::ListAssociationsRequest const& request) override; + + StatusOr + ListPreconfiguredExpressionSets( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + ListPreconfiguredExpressionSetsRequest const& request) override; + + future> AsyncMove( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + MoveRequest const& request) override; + + StatusOr Move( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + MoveRequest const& request) override; + + future> + AsyncPatchSecurityPolicy( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + PatchSecurityPolicyRequest const& request) override; + + StatusOr PatchSecurityPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + PatchSecurityPolicyRequest const& request) override; + + future> AsyncPatchRule( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + PatchRuleRequest const& request) override; + + StatusOr PatchRule( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + PatchRuleRequest const& request) override; + + future> + AsyncRemoveAssociation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + RemoveAssociationRequest const& request) override; + + StatusOr RemoveAssociation( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + RemoveAssociationRequest const& request) override; + + future> AsyncRemoveRule( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + RemoveRuleRequest const& request) override; + + StatusOr RemoveRule( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + RemoveRuleRequest const& request) override; + + future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_organization_operations::v1:: + GetOperationRequest const& request) override; + + future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_organization_operations::v1:: + DeleteOperationRequest const& request) override; + + private: + std::shared_ptr child_; + TracingOptions tracing_options_; + std::set components_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_organization_security_policies_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ORGANIZATION_SECURITY_POLICIES_V1_INTERNAL_ORGANIZATION_SECURITY_POLICIES_REST_LOGGING_DECORATOR_H diff --git a/google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_rest_metadata_decorator.cc b/google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_rest_metadata_decorator.cc new file mode 100644 index 0000000000000..9f00d6122d433 --- /dev/null +++ b/google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_rest_metadata_decorator.cc @@ -0,0 +1,345 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/organization_security_policies/v1/organization_security_policies.proto + +#include "google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_rest_metadata_decorator.h" +#include "google/cloud/internal/api_client_header.h" +#include "google/cloud/internal/rest_set_metadata.h" +#include "google/cloud/status_or.h" +#include "absl/strings/str_cat.h" +#include "absl/strings/str_format.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_organization_security_policies_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +OrganizationSecurityPoliciesRestMetadata:: + OrganizationSecurityPoliciesRestMetadata( + std::shared_ptr child, + std::string api_client_header) + : child_(std::move(child)), + api_client_header_( + api_client_header.empty() + ? google::cloud::internal::GeneratedLibClientHeader() + : std::move(api_client_header)) {} + +future> +OrganizationSecurityPoliciesRestMetadata::AsyncAddAssociation( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + AddAssociationRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncAddAssociation(cq, std::move(rest_context), + std::move(options), request); +} + +StatusOr +OrganizationSecurityPoliciesRestMetadata::AddAssociation( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + AddAssociationRequest const& request) { + SetMetadata(rest_context, options); + return child_->AddAssociation(rest_context, options, request); +} + +future> +OrganizationSecurityPoliciesRestMetadata::AsyncAddRule( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + AddRuleRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncAddRule(cq, std::move(rest_context), std::move(options), + request); +} + +StatusOr +OrganizationSecurityPoliciesRestMetadata::AddRule( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + AddRuleRequest const& request) { + SetMetadata(rest_context, options); + return child_->AddRule(rest_context, options, request); +} + +future> +OrganizationSecurityPoliciesRestMetadata::AsyncCopyRules( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + CopyRulesRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncCopyRules(cq, std::move(rest_context), std::move(options), + request); +} + +StatusOr +OrganizationSecurityPoliciesRestMetadata::CopyRules( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + CopyRulesRequest const& request) { + SetMetadata(rest_context, options); + return child_->CopyRules(rest_context, options, request); +} + +future> +OrganizationSecurityPoliciesRestMetadata::AsyncDeleteSecurityPolicy( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + DeleteSecurityPolicyRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncDeleteSecurityPolicy(cq, std::move(rest_context), + std::move(options), request); +} + +StatusOr +OrganizationSecurityPoliciesRestMetadata::DeleteSecurityPolicy( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + DeleteSecurityPolicyRequest const& request) { + SetMetadata(rest_context, options); + return child_->DeleteSecurityPolicy(rest_context, options, request); +} + +StatusOr +OrganizationSecurityPoliciesRestMetadata::GetSecurityPolicy( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + GetSecurityPolicyRequest const& request) { + SetMetadata(rest_context, options); + return child_->GetSecurityPolicy(rest_context, options, request); +} + +StatusOr +OrganizationSecurityPoliciesRestMetadata::GetAssociation( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + GetAssociationRequest const& request) { + SetMetadata(rest_context, options); + return child_->GetAssociation(rest_context, options, request); +} + +StatusOr +OrganizationSecurityPoliciesRestMetadata::GetRule( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + GetRuleRequest const& request) { + SetMetadata(rest_context, options); + return child_->GetRule(rest_context, options, request); +} + +future> +OrganizationSecurityPoliciesRestMetadata::AsyncInsertSecurityPolicy( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + InsertSecurityPolicyRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncInsertSecurityPolicy(cq, std::move(rest_context), + std::move(options), request); +} + +StatusOr +OrganizationSecurityPoliciesRestMetadata::InsertSecurityPolicy( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + InsertSecurityPolicyRequest const& request) { + SetMetadata(rest_context, options); + return child_->InsertSecurityPolicy(rest_context, options, request); +} + +StatusOr +OrganizationSecurityPoliciesRestMetadata::ListOrganizationSecurityPolicies( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + ListOrganizationSecurityPoliciesRequest const& request) { + SetMetadata(rest_context, options); + return child_->ListOrganizationSecurityPolicies(rest_context, options, + request); +} + +StatusOr +OrganizationSecurityPoliciesRestMetadata::ListAssociations( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + ListAssociationsRequest const& request) { + SetMetadata(rest_context, options); + return child_->ListAssociations(rest_context, options, request); +} + +StatusOr +OrganizationSecurityPoliciesRestMetadata::ListPreconfiguredExpressionSets( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + ListPreconfiguredExpressionSetsRequest const& request) { + SetMetadata(rest_context, options); + return child_->ListPreconfiguredExpressionSets(rest_context, options, + request); +} + +future> +OrganizationSecurityPoliciesRestMetadata::AsyncMove( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + MoveRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncMove(cq, std::move(rest_context), std::move(options), + request); +} + +StatusOr +OrganizationSecurityPoliciesRestMetadata::Move( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + MoveRequest const& request) { + SetMetadata(rest_context, options); + return child_->Move(rest_context, options, request); +} + +future> +OrganizationSecurityPoliciesRestMetadata::AsyncPatchSecurityPolicy( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + PatchSecurityPolicyRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncPatchSecurityPolicy(cq, std::move(rest_context), + std::move(options), request); +} + +StatusOr +OrganizationSecurityPoliciesRestMetadata::PatchSecurityPolicy( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + PatchSecurityPolicyRequest const& request) { + SetMetadata(rest_context, options); + return child_->PatchSecurityPolicy(rest_context, options, request); +} + +future> +OrganizationSecurityPoliciesRestMetadata::AsyncPatchRule( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + PatchRuleRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncPatchRule(cq, std::move(rest_context), std::move(options), + request); +} + +StatusOr +OrganizationSecurityPoliciesRestMetadata::PatchRule( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + PatchRuleRequest const& request) { + SetMetadata(rest_context, options); + return child_->PatchRule(rest_context, options, request); +} + +future> +OrganizationSecurityPoliciesRestMetadata::AsyncRemoveAssociation( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + RemoveAssociationRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncRemoveAssociation(cq, std::move(rest_context), + std::move(options), request); +} + +StatusOr +OrganizationSecurityPoliciesRestMetadata::RemoveAssociation( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + RemoveAssociationRequest const& request) { + SetMetadata(rest_context, options); + return child_->RemoveAssociation(rest_context, options, request); +} + +future> +OrganizationSecurityPoliciesRestMetadata::AsyncRemoveRule( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + RemoveRuleRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncRemoveRule(cq, std::move(rest_context), + std::move(options), request); +} + +StatusOr +OrganizationSecurityPoliciesRestMetadata::RemoveRule( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + RemoveRuleRequest const& request) { + SetMetadata(rest_context, options); + return child_->RemoveRule(rest_context, options, request); +} + +future> +OrganizationSecurityPoliciesRestMetadata::AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_organization_operations::v1:: + GetOperationRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncGetOperation(cq, std::move(rest_context), + std::move(options), request); +} + +future OrganizationSecurityPoliciesRestMetadata::AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_organization_operations::v1:: + DeleteOperationRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncCancelOperation(cq, std::move(rest_context), + std::move(options), request); +} + +void OrganizationSecurityPoliciesRestMetadata::SetMetadata( + rest_internal::RestContext& rest_context, Options const& options, + std::vector const& params) { + google::cloud::rest_internal::SetMetadata(rest_context, options, params, + api_client_header_); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_organization_security_policies_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_rest_metadata_decorator.h b/google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_rest_metadata_decorator.h new file mode 100644 index 0000000000000..8be36676fe494 --- /dev/null +++ b/google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_rest_metadata_decorator.h @@ -0,0 +1,254 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/organization_security_policies/v1/organization_security_policies.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ORGANIZATION_SECURITY_POLICIES_V1_INTERNAL_ORGANIZATION_SECURITY_POLICIES_REST_METADATA_DECORATOR_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ORGANIZATION_SECURITY_POLICIES_V1_INTERNAL_ORGANIZATION_SECURITY_POLICIES_REST_METADATA_DECORATOR_H + +#include "google/cloud/compute/global_organization_operations/v1/global_organization_operations.pb.h" +#include "google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_rest_stub.h" +#include "google/cloud/compute/organization_security_policies/v1/organization_security_policies.pb.h" +#include "google/cloud/future.h" +#include "google/cloud/rest_options.h" +#include "google/cloud/version.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_organization_security_policies_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class OrganizationSecurityPoliciesRestMetadata + : public OrganizationSecurityPoliciesRestStub { + public: + ~OrganizationSecurityPoliciesRestMetadata() override = default; + explicit OrganizationSecurityPoliciesRestMetadata( + std::shared_ptr child, + std::string api_client_header = ""); + + google::cloud::future> + AsyncAddAssociation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + AddAssociationRequest const& request) override; + + StatusOr AddAssociation( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + AddAssociationRequest const& request) override; + + google::cloud::future> + AsyncAddRule( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + AddRuleRequest const& request) override; + + StatusOr AddRule( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + AddRuleRequest const& request) override; + + google::cloud::future> + AsyncCopyRules( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + CopyRulesRequest const& request) override; + + StatusOr CopyRules( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + CopyRulesRequest const& request) override; + + google::cloud::future> + AsyncDeleteSecurityPolicy( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + DeleteSecurityPolicyRequest const& request) override; + + StatusOr DeleteSecurityPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + DeleteSecurityPolicyRequest const& request) override; + + StatusOr GetSecurityPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + GetSecurityPolicyRequest const& request) override; + + StatusOr + GetAssociation(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies:: + v1::GetAssociationRequest const& request) override; + + StatusOr GetRule( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + GetRuleRequest const& request) override; + + google::cloud::future> + AsyncInsertSecurityPolicy( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + InsertSecurityPolicyRequest const& request) override; + + StatusOr InsertSecurityPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + InsertSecurityPolicyRequest const& request) override; + + StatusOr + ListOrganizationSecurityPolicies( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + ListOrganizationSecurityPoliciesRequest const& request) override; + + StatusOr + ListAssociations(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies:: + v1::ListAssociationsRequest const& request) override; + + StatusOr + ListPreconfiguredExpressionSets( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + ListPreconfiguredExpressionSetsRequest const& request) override; + + google::cloud::future> + AsyncMove( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + MoveRequest const& request) override; + + StatusOr Move( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + MoveRequest const& request) override; + + google::cloud::future> + AsyncPatchSecurityPolicy( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + PatchSecurityPolicyRequest const& request) override; + + StatusOr PatchSecurityPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + PatchSecurityPolicyRequest const& request) override; + + google::cloud::future> + AsyncPatchRule( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + PatchRuleRequest const& request) override; + + StatusOr PatchRule( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + PatchRuleRequest const& request) override; + + google::cloud::future> + AsyncRemoveAssociation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + RemoveAssociationRequest const& request) override; + + StatusOr RemoveAssociation( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + RemoveAssociationRequest const& request) override; + + google::cloud::future> + AsyncRemoveRule( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + RemoveRuleRequest const& request) override; + + StatusOr RemoveRule( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + RemoveRuleRequest const& request) override; + + google::cloud::future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_organization_operations::v1:: + GetOperationRequest const& request) override; + + google::cloud::future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_organization_operations::v1:: + DeleteOperationRequest const& request) override; + + private: + void SetMetadata(rest_internal::RestContext& rest_context, + Options const& options, + std::vector const& params = {}); + + std::shared_ptr child_; + std::string api_client_header_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_organization_security_policies_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ORGANIZATION_SECURITY_POLICIES_V1_INTERNAL_ORGANIZATION_SECURITY_POLICIES_REST_METADATA_DECORATOR_H diff --git a/google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_rest_stub.cc b/google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_rest_stub.cc new file mode 100644 index 0000000000000..5e4682de9f385 --- /dev/null +++ b/google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_rest_stub.cc @@ -0,0 +1,799 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/organization_security_policies/v1/organization_security_policies.proto + +#include "google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_rest_stub.h" +#include "google/cloud/compute/global_organization_operations/v1/global_organization_operations.pb.h" +#include "google/cloud/compute/organization_security_policies/v1/organization_security_policies.pb.h" +#include "google/cloud/common_options.h" +#include "google/cloud/internal/rest_stub_helpers.h" +#include "google/cloud/status_or.h" +#include "absl/strings/str_cat.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_organization_security_policies_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +DefaultOrganizationSecurityPoliciesRestStub:: + DefaultOrganizationSecurityPoliciesRestStub(Options options) + : service_(rest_internal::MakePooledRestClient( + options.get(), options)), + operations_(rest_internal::MakePooledRestClient( + options.get(), options)), + options_(std::move(options)) {} + +DefaultOrganizationSecurityPoliciesRestStub:: + DefaultOrganizationSecurityPoliciesRestStub( + std::shared_ptr service, + std::shared_ptr operations, Options options) + : service_(std::move(service)), + operations_(std::move(operations)), + options_(std::move(options)) {} + +future> +DefaultOrganizationSecurityPoliciesRestStub::AsyncAddAssociation( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + AddAssociationRequest const& request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto service, auto request, auto rest_context, auto options) { + std::vector> query_params; + query_params.push_back( + {"replace_existing_association", + (request.replace_existing_association() ? "1" : "0")}); + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + p.set_value( + rest_internal::Post( + *service, *rest_context, + request.security_policy_association_resource(), false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", *options), + "/", "locations", "/", "global", "/", + "securityPolicies", "/", request.security_policy(), + "/", "addAssociation"), + std::move(query_params))); + }, + std::move(p), + service_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +StatusOr +DefaultOrganizationSecurityPoliciesRestStub::AddAssociation( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + AddAssociationRequest const& request) { + std::vector> query_params; + query_params.push_back( + {"replace_existing_association", + (request.replace_existing_association() ? "1" : "0")}); + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Post( + *service_, rest_context, request.security_policy_association_resource(), + false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "locations", "/", "global", "/", "securityPolicies", "/", + request.security_policy(), "/", "addAssociation"), + std::move(query_params)); +} + +future> +DefaultOrganizationSecurityPoliciesRestStub::AsyncAddRule( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + AddRuleRequest const& request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto service, auto request, auto rest_context, auto options) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + p.set_value( + rest_internal::Post( + *service, *rest_context, + request.security_policy_rule_resource(), false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", *options), + "/", "locations", "/", "global", "/", + "securityPolicies", "/", request.security_policy(), + "/", "addRule"), + std::move(query_params))); + }, + std::move(p), + service_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +StatusOr +DefaultOrganizationSecurityPoliciesRestStub::AddRule( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + AddRuleRequest const& request) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Post( + *service_, rest_context, request.security_policy_rule_resource(), false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "locations", "/", "global", "/", "securityPolicies", "/", + request.security_policy(), "/", "addRule"), + std::move(query_params)); +} + +future> +DefaultOrganizationSecurityPoliciesRestStub::AsyncCopyRules( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + CopyRulesRequest const& request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto service, auto request, auto rest_context, auto options) { + std::vector> query_params; + p.set_value( + rest_internal::Post( + *service, *rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", *options), + "/", "locations", "/", "global", "/", + "securityPolicies", "/", request.security_policy(), + "/", "copyRules"), + std::move(query_params))); + }, + std::move(p), + service_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +StatusOr +DefaultOrganizationSecurityPoliciesRestStub::CopyRules( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + CopyRulesRequest const& request) { + std::vector> query_params; + return rest_internal::Post( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "locations", "/", "global", "/", "securityPolicies", "/", + request.security_policy(), "/", "copyRules"), + std::move(query_params)); +} + +future> +DefaultOrganizationSecurityPoliciesRestStub::AsyncDeleteSecurityPolicy( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + DeleteSecurityPolicyRequest const& request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto service, auto request, auto rest_context, auto options) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + p.set_value( + rest_internal::Delete( + *service, *rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", *options), + "/", "locations", "/", "global", "/", + "securityPolicies", "/", + request.security_policy()), + std::move(query_params))); + }, + std::move(p), + service_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +StatusOr +DefaultOrganizationSecurityPoliciesRestStub::DeleteSecurityPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + DeleteSecurityPolicyRequest const& request) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Delete( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "locations", "/", "global", "/", "securityPolicies", "/", + request.security_policy()), + std::move(query_params)); +} + +StatusOr +DefaultOrganizationSecurityPoliciesRestStub::GetSecurityPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + GetSecurityPolicyRequest const& request) { + std::vector> query_params; + return rest_internal::Get( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "locations", "/", "global", "/", "securityPolicies", "/", + request.security_policy()), + std::move(query_params)); +} + +StatusOr +DefaultOrganizationSecurityPoliciesRestStub::GetAssociation( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + GetAssociationRequest const& request) { + std::vector> query_params; + query_params.push_back({"name", request.name()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Get< + google::cloud::cpp::compute::v1::SecurityPolicyAssociation>( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "locations", "/", "global", "/", "securityPolicies", "/", + request.security_policy(), "/", "getAssociation"), + std::move(query_params)); +} + +StatusOr +DefaultOrganizationSecurityPoliciesRestStub::GetRule( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + GetRuleRequest const& request) { + std::vector> query_params; + query_params.push_back({"priority", std::to_string(request.priority())}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Get< + google::cloud::cpp::compute::v1::SecurityPolicyRule>( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "locations", "/", "global", "/", "securityPolicies", "/", + request.security_policy(), "/", "getRule"), + std::move(query_params)); +} + +future> +DefaultOrganizationSecurityPoliciesRestStub::AsyncInsertSecurityPolicy( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + InsertSecurityPolicyRequest const& request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto service, auto request, auto rest_context, auto options) { + std::vector> query_params; + query_params.push_back({"parent_id", request.parent_id()}); + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + p.set_value( + rest_internal::Post( + *service, *rest_context, request.security_policy_resource(), + false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", *options), + "/", "locations", "/", "global", "/", + "securityPolicies"), + std::move(query_params))); + }, + std::move(p), + service_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +StatusOr +DefaultOrganizationSecurityPoliciesRestStub::InsertSecurityPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + InsertSecurityPolicyRequest const& request) { + std::vector> query_params; + query_params.push_back({"parent_id", request.parent_id()}); + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Post( + *service_, rest_context, request.security_policy_resource(), false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "locations", "/", "global", "/", "securityPolicies"), + std::move(query_params)); +} + +StatusOr +DefaultOrganizationSecurityPoliciesRestStub::ListOrganizationSecurityPolicies( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + ListOrganizationSecurityPoliciesRequest const& request) { + std::vector> query_params; + query_params.push_back({"filter", request.filter()}); + query_params.push_back( + {"max_results", std::to_string(request.max_results())}); + query_params.push_back({"order_by", request.order_by()}); + query_params.push_back({"page_token", request.page_token()}); + query_params.push_back({"parent_id", request.parent_id()}); + query_params.push_back({"return_partial_success", + (request.return_partial_success() ? "1" : "0")}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Get< + google::cloud::cpp::compute::v1::SecurityPolicyList>( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "locations", "/", "global", "/", "securityPolicies"), + std::move(query_params)); +} + +StatusOr +DefaultOrganizationSecurityPoliciesRestStub::ListAssociations( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + ListAssociationsRequest const& request) { + std::vector> query_params; + query_params.push_back({"target_resource", request.target_resource()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Get< + google::cloud::cpp::compute::v1:: + OrganizationSecurityPoliciesListAssociationsResponse>( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "locations", "/", "global", "/", "securityPolicies", "/", + "listAssociations"), + std::move(query_params)); +} + +StatusOr +DefaultOrganizationSecurityPoliciesRestStub::ListPreconfiguredExpressionSets( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + ListPreconfiguredExpressionSetsRequest const& request) { + std::vector> query_params; + query_params.push_back({"filter", request.filter()}); + query_params.push_back( + {"max_results", std::to_string(request.max_results())}); + query_params.push_back({"order_by", request.order_by()}); + query_params.push_back({"page_token", request.page_token()}); + query_params.push_back({"parent_id", request.parent_id()}); + query_params.push_back({"return_partial_success", + (request.return_partial_success() ? "1" : "0")}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Get< + google::cloud::cpp::compute::v1:: + SecurityPoliciesListPreconfiguredExpressionSetsResponse>( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "locations", "/", "global", "/", "securityPolicies", "/", + "listPreconfiguredExpressionSets"), + std::move(query_params)); +} + +future> +DefaultOrganizationSecurityPoliciesRestStub::AsyncMove( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + MoveRequest const& request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto service, auto request, auto rest_context, auto options) { + std::vector> query_params; + p.set_value( + rest_internal::Post( + *service, *rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", *options), + "/", "locations", "/", "global", "/", + "securityPolicies", "/", request.security_policy(), + "/", "move"), + std::move(query_params))); + }, + std::move(p), + service_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +StatusOr +DefaultOrganizationSecurityPoliciesRestStub::Move( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + MoveRequest const& request) { + std::vector> query_params; + return rest_internal::Post( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "locations", "/", "global", "/", "securityPolicies", "/", + request.security_policy(), "/", "move"), + std::move(query_params)); +} + +future> +DefaultOrganizationSecurityPoliciesRestStub::AsyncPatchSecurityPolicy( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + PatchSecurityPolicyRequest const& request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto service, auto request, auto rest_context, auto options) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + p.set_value( + rest_internal::Patch( + *service, *rest_context, request.security_policy_resource(), + false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", *options), + "/", "locations", "/", "global", "/", + "securityPolicies", "/", + request.security_policy()), + std::move(query_params))); + }, + std::move(p), + service_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +StatusOr +DefaultOrganizationSecurityPoliciesRestStub::PatchSecurityPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + PatchSecurityPolicyRequest const& request) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Patch( + *service_, rest_context, request.security_policy_resource(), false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "locations", "/", "global", "/", "securityPolicies", "/", + request.security_policy()), + std::move(query_params)); +} + +future> +DefaultOrganizationSecurityPoliciesRestStub::AsyncPatchRule( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + PatchRuleRequest const& request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto service, auto request, auto rest_context, auto options) { + std::vector> query_params; + query_params.push_back( + {"priority", std::to_string(request.priority())}); + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + p.set_value( + rest_internal::Post( + *service, *rest_context, + request.security_policy_rule_resource(), false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", *options), + "/", "locations", "/", "global", "/", + "securityPolicies", "/", request.security_policy(), + "/", "patchRule"), + std::move(query_params))); + }, + std::move(p), + service_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +StatusOr +DefaultOrganizationSecurityPoliciesRestStub::PatchRule( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + PatchRuleRequest const& request) { + std::vector> query_params; + query_params.push_back({"priority", std::to_string(request.priority())}); + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Post( + *service_, rest_context, request.security_policy_rule_resource(), false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "locations", "/", "global", "/", "securityPolicies", "/", + request.security_policy(), "/", "patchRule"), + std::move(query_params)); +} + +future> +DefaultOrganizationSecurityPoliciesRestStub::AsyncRemoveAssociation( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + RemoveAssociationRequest const& request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto service, auto request, auto rest_context, auto options) { + std::vector> query_params; + p.set_value( + rest_internal::Post( + *service, *rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", *options), + "/", "locations", "/", "global", "/", + "securityPolicies", "/", request.security_policy(), + "/", "removeAssociation"), + std::move(query_params))); + }, + std::move(p), + service_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +StatusOr +DefaultOrganizationSecurityPoliciesRestStub::RemoveAssociation( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + RemoveAssociationRequest const& request) { + std::vector> query_params; + return rest_internal::Post( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "locations", "/", "global", "/", "securityPolicies", "/", + request.security_policy(), "/", "removeAssociation"), + std::move(query_params)); +} + +future> +DefaultOrganizationSecurityPoliciesRestStub::AsyncRemoveRule( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + RemoveRuleRequest const& request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto service, auto request, auto rest_context, auto options) { + std::vector> query_params; + p.set_value( + rest_internal::Post( + *service, *rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", *options), + "/", "locations", "/", "global", "/", + "securityPolicies", "/", request.security_policy(), + "/", "removeRule"), + std::move(query_params))); + }, + std::move(p), + service_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +StatusOr +DefaultOrganizationSecurityPoliciesRestStub::RemoveRule( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + RemoveRuleRequest const& request) { + std::vector> query_params; + return rest_internal::Post( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "locations", "/", "global", "/", "securityPolicies", "/", + request.security_policy(), "/", "removeRule"), + std::move(query_params)); +} + +future> +DefaultOrganizationSecurityPoliciesRestStub::AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_organization_operations::v1:: + GetOperationRequest const& request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto operations, auto request, auto rest_context, + auto options) { + p.set_value( + rest_internal::Get( + *operations, *rest_context, request, false, + absl::StrCat("/compute/", + rest_internal::DetermineApiVersion("v1", *options), + "/locations/global/operations/", + request.operation()))); + }, + std::move(p), + operations_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +future +DefaultOrganizationSecurityPoliciesRestStub::AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_organization_operations::v1:: + DeleteOperationRequest const& request) { + promise> p; + future> f = p.get_future(); + std::thread t{ + [](auto p, auto operations, auto request, auto rest_context, + auto options) { + p.set_value(rest_internal::Post( + *operations, *rest_context, request, false, + absl::StrCat( + "/compute/", rest_internal::DetermineApiVersion("v1", *options), + "/locations/global/operations/", request.operation()))); + }, + std::move(p), + operations_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get().status(); + }); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_organization_security_policies_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_rest_stub.h b/google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_rest_stub.h new file mode 100644 index 0000000000000..cfebd65438245 --- /dev/null +++ b/google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_rest_stub.h @@ -0,0 +1,453 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/organization_security_policies/v1/organization_security_policies.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ORGANIZATION_SECURITY_POLICIES_V1_INTERNAL_ORGANIZATION_SECURITY_POLICIES_REST_STUB_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ORGANIZATION_SECURITY_POLICIES_V1_INTERNAL_ORGANIZATION_SECURITY_POLICIES_REST_STUB_H + +#include "google/cloud/compute/global_organization_operations/v1/global_organization_operations.pb.h" +#include "google/cloud/compute/organization_security_policies/v1/organization_security_policies.pb.h" +#include "google/cloud/completion_queue.h" +#include "google/cloud/internal/rest_client.h" +#include "google/cloud/internal/rest_context.h" +#include "google/cloud/status_or.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_organization_security_policies_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class OrganizationSecurityPoliciesRestStub { + public: + virtual ~OrganizationSecurityPoliciesRestStub() = default; + + virtual future> + AsyncAddAssociation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + AddAssociationRequest const& request) = 0; + + virtual StatusOr AddAssociation( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + AddAssociationRequest const& request) = 0; + + virtual future> + AsyncAddRule( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + AddRuleRequest const& request) = 0; + + virtual StatusOr AddRule( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + AddRuleRequest const& request) = 0; + + virtual future> + AsyncCopyRules( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + CopyRulesRequest const& request) = 0; + + virtual StatusOr CopyRules( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + CopyRulesRequest const& request) = 0; + + virtual future> + AsyncDeleteSecurityPolicy( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + DeleteSecurityPolicyRequest const& request) = 0; + + virtual StatusOr + DeleteSecurityPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + DeleteSecurityPolicyRequest const& request) = 0; + + virtual StatusOr + GetSecurityPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + GetSecurityPolicyRequest const& request) = 0; + + virtual StatusOr + GetAssociation(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies:: + v1::GetAssociationRequest const& request) = 0; + + virtual StatusOr GetRule( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + GetRuleRequest const& request) = 0; + + virtual future> + AsyncInsertSecurityPolicy( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + InsertSecurityPolicyRequest const& request) = 0; + + virtual StatusOr + InsertSecurityPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + InsertSecurityPolicyRequest const& request) = 0; + + virtual StatusOr + ListOrganizationSecurityPolicies( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + ListOrganizationSecurityPoliciesRequest const& request) = 0; + + virtual StatusOr + ListAssociations(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies:: + v1::ListAssociationsRequest const& request) = 0; + + virtual StatusOr + ListPreconfiguredExpressionSets( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + ListPreconfiguredExpressionSetsRequest const& request) = 0; + + virtual future> + AsyncMove( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + MoveRequest const& request) = 0; + + virtual StatusOr Move( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + MoveRequest const& request) = 0; + + virtual future> + AsyncPatchSecurityPolicy( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + PatchSecurityPolicyRequest const& request) = 0; + + virtual StatusOr + PatchSecurityPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + PatchSecurityPolicyRequest const& request) = 0; + + virtual future> + AsyncPatchRule( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + PatchRuleRequest const& request) = 0; + + virtual StatusOr PatchRule( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + PatchRuleRequest const& request) = 0; + + virtual future> + AsyncRemoveAssociation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + RemoveAssociationRequest const& request) = 0; + + virtual StatusOr + RemoveAssociation( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + RemoveAssociationRequest const& request) = 0; + + virtual future> + AsyncRemoveRule( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + RemoveRuleRequest const& request) = 0; + + virtual StatusOr RemoveRule( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + RemoveRuleRequest const& request) = 0; + + virtual future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_organization_operations::v1:: + GetOperationRequest const& request) = 0; + + virtual future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_organization_operations::v1:: + DeleteOperationRequest const& request) = 0; +}; + +class DefaultOrganizationSecurityPoliciesRestStub + : public OrganizationSecurityPoliciesRestStub { + public: + ~DefaultOrganizationSecurityPoliciesRestStub() override = default; + + explicit DefaultOrganizationSecurityPoliciesRestStub(Options options); + DefaultOrganizationSecurityPoliciesRestStub( + std::shared_ptr service, + std::shared_ptr operations, Options options); + + future> + AsyncAddAssociation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + AddAssociationRequest const& request) override; + + StatusOr AddAssociation( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + AddAssociationRequest const& request) override; + + future> AsyncAddRule( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + AddRuleRequest const& request) override; + + StatusOr AddRule( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + AddRuleRequest const& request) override; + + future> AsyncCopyRules( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + CopyRulesRequest const& request) override; + + StatusOr CopyRules( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + CopyRulesRequest const& request) override; + + future> + AsyncDeleteSecurityPolicy( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + DeleteSecurityPolicyRequest const& request) override; + + StatusOr DeleteSecurityPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + DeleteSecurityPolicyRequest const& request) override; + + StatusOr GetSecurityPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + GetSecurityPolicyRequest const& request) override; + + StatusOr + GetAssociation(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies:: + v1::GetAssociationRequest const& request) override; + + StatusOr GetRule( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + GetRuleRequest const& request) override; + + future> + AsyncInsertSecurityPolicy( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + InsertSecurityPolicyRequest const& request) override; + + StatusOr InsertSecurityPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + InsertSecurityPolicyRequest const& request) override; + + StatusOr + ListOrganizationSecurityPolicies( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + ListOrganizationSecurityPoliciesRequest const& request) override; + + StatusOr + ListAssociations(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies:: + v1::ListAssociationsRequest const& request) override; + + StatusOr + ListPreconfiguredExpressionSets( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + ListPreconfiguredExpressionSetsRequest const& request) override; + + future> AsyncMove( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + MoveRequest const& request) override; + + StatusOr Move( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + MoveRequest const& request) override; + + future> + AsyncPatchSecurityPolicy( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + PatchSecurityPolicyRequest const& request) override; + + StatusOr PatchSecurityPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + PatchSecurityPolicyRequest const& request) override; + + future> AsyncPatchRule( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + PatchRuleRequest const& request) override; + + StatusOr PatchRule( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + PatchRuleRequest const& request) override; + + future> + AsyncRemoveAssociation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + RemoveAssociationRequest const& request) override; + + StatusOr RemoveAssociation( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + RemoveAssociationRequest const& request) override; + + future> AsyncRemoveRule( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::organization_security_policies::v1:: + RemoveRuleRequest const& request) override; + + StatusOr RemoveRule( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::organization_security_policies::v1:: + RemoveRuleRequest const& request) override; + + future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_organization_operations::v1:: + GetOperationRequest const& request) override; + + future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_organization_operations::v1:: + DeleteOperationRequest const& request) override; + + private: + std::shared_ptr service_; + std::shared_ptr operations_; + Options options_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_organization_security_policies_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ORGANIZATION_SECURITY_POLICIES_V1_INTERNAL_ORGANIZATION_SECURITY_POLICIES_REST_STUB_H diff --git a/google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_rest_stub_factory.cc b/google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_rest_stub_factory.cc new file mode 100644 index 0000000000000..fe0310ea6bca3 --- /dev/null +++ b/google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_rest_stub_factory.cc @@ -0,0 +1,59 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/organization_security_policies/v1/organization_security_policies.proto + +#include "google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_rest_stub_factory.h" +#include "google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_rest_logging_decorator.h" +#include "google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_rest_metadata_decorator.h" +#include "google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_rest_stub.h" +#include "google/cloud/common_options.h" +#include "google/cloud/internal/algorithm.h" +#include "google/cloud/internal/populate_rest_options.h" +#include "google/cloud/log.h" +#include "google/cloud/options.h" +#include "google/cloud/rest_options.h" +#include "absl/strings/match.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_organization_security_policies_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +std::shared_ptr +CreateDefaultOrganizationSecurityPoliciesRestStub(Options const& options) { + auto opts = internal::PopulateRestOptions(options); + std::shared_ptr stub = + std::make_shared( + std::move(opts)); + stub = std::make_shared( + std::move(stub)); + if (internal::Contains(options.get(), "rpc")) { + GCP_LOG(INFO) << "Enabled logging for REST rpc calls"; + stub = std::make_shared( + std::move(stub), options.get(), + options.get()); + } + return stub; +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_organization_security_policies_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_rest_stub_factory.h b/google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_rest_stub_factory.h new file mode 100644 index 0000000000000..9bf9c3c0ebc10 --- /dev/null +++ b/google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_rest_stub_factory.h @@ -0,0 +1,41 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/organization_security_policies/v1/organization_security_policies.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ORGANIZATION_SECURITY_POLICIES_V1_INTERNAL_ORGANIZATION_SECURITY_POLICIES_REST_STUB_FACTORY_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ORGANIZATION_SECURITY_POLICIES_V1_INTERNAL_ORGANIZATION_SECURITY_POLICIES_REST_STUB_FACTORY_H + +#include "google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_rest_stub.h" +#include "google/cloud/options.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_organization_security_policies_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +std::shared_ptr +CreateDefaultOrganizationSecurityPoliciesRestStub(Options const& options); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_organization_security_policies_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ORGANIZATION_SECURITY_POLICIES_V1_INTERNAL_ORGANIZATION_SECURITY_POLICIES_REST_STUB_FACTORY_H diff --git a/google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_retry_traits.h b/google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_retry_traits.h new file mode 100644 index 0000000000000..9665c507de978 --- /dev/null +++ b/google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_retry_traits.h @@ -0,0 +1,44 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/organization_security_policies/v1/organization_security_policies.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ORGANIZATION_SECURITY_POLICIES_V1_INTERNAL_ORGANIZATION_SECURITY_POLICIES_RETRY_TRAITS_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ORGANIZATION_SECURITY_POLICIES_V1_INTERNAL_ORGANIZATION_SECURITY_POLICIES_RETRY_TRAITS_H + +#include "google/cloud/status.h" +#include "google/cloud/version.h" + +namespace google { +namespace cloud { +namespace compute_organization_security_policies_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/// Define the gRPC status code semantics for retrying requests. +struct OrganizationSecurityPoliciesRetryTraits { + static bool IsPermanentFailure(google::cloud::Status const& status) { + return status.code() != StatusCode::kOk && + status.code() != StatusCode::kUnavailable; + } +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_organization_security_policies_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ORGANIZATION_SECURITY_POLICIES_V1_INTERNAL_ORGANIZATION_SECURITY_POLICIES_RETRY_TRAITS_H diff --git a/google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_sources.cc b/google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_sources.cc new file mode 100644 index 0000000000000..d002ad0715db1 --- /dev/null +++ b/google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_sources.cc @@ -0,0 +1,32 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/organization_security_policies/v1/organization_security_policies.proto + +// NOLINTBEGIN(bugprone-suspicious-include) +#include "google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_option_defaults.cc" +#include "google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_rest_connection_impl.cc" +#include "google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_rest_logging_decorator.cc" +#include "google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_rest_metadata_decorator.cc" +#include "google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_rest_stub.cc" +#include "google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_rest_stub_factory.cc" +#include "google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_tracing_connection.cc" +#include "google/cloud/compute/organization_security_policies/v1/organization_security_policies_client.cc" +#include "google/cloud/compute/organization_security_policies/v1/organization_security_policies_connection.cc" +#include "google/cloud/compute/organization_security_policies/v1/organization_security_policies_connection_idempotency_policy.cc" +#include "google/cloud/compute/organization_security_policies/v1/organization_security_policies_rest_connection.cc" +// NOLINTEND(bugprone-suspicious-include) diff --git a/google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_tracing_connection.cc b/google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_tracing_connection.cc new file mode 100644 index 0000000000000..17910b15f8bcb --- /dev/null +++ b/google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_tracing_connection.cc @@ -0,0 +1,460 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/organization_security_policies/v1/organization_security_policies.proto + +#include "google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_tracing_connection.h" +#include "google/cloud/internal/opentelemetry.h" +#include "google/cloud/internal/traced_stream_range.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_organization_security_policies_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +OrganizationSecurityPoliciesTracingConnection:: + OrganizationSecurityPoliciesTracingConnection( + std::shared_ptr + child) + : child_(std::move(child)) {} + +future> +OrganizationSecurityPoliciesTracingConnection::AddAssociation( + google::cloud::cpp::compute::organization_security_policies::v1:: + AddAssociationRequest const& request) { + auto span = internal::MakeSpan( + "compute_organization_security_policies_v1::" + "OrganizationSecurityPoliciesConnection::AddAssociation"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), child_->AddAssociation(request)); +} + +StatusOr +OrganizationSecurityPoliciesTracingConnection::AddAssociation( + NoAwaitTag, google::cloud::cpp::compute::organization_security_policies:: + v1::AddAssociationRequest const& request) { + auto span = internal::MakeSpan( + "compute_organization_security_policies_v1::" + "OrganizationSecurityPoliciesConnection::AddAssociation"); + opentelemetry::trace::Scope scope(span); + return internal::EndSpan(*span, + child_->AddAssociation(NoAwaitTag{}, request)); +} + +future> +OrganizationSecurityPoliciesTracingConnection::AddAssociation( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto span = internal::MakeSpan( + "compute_organization_security_policies_v1::" + "OrganizationSecurityPoliciesConnection::AddAssociation"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), child_->AddAssociation(operation)); +} + +future> +OrganizationSecurityPoliciesTracingConnection::AddRule( + google::cloud::cpp::compute::organization_security_policies::v1:: + AddRuleRequest const& request) { + auto span = internal::MakeSpan( + "compute_organization_security_policies_v1::" + "OrganizationSecurityPoliciesConnection::AddRule"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), child_->AddRule(request)); +} + +StatusOr +OrganizationSecurityPoliciesTracingConnection::AddRule( + NoAwaitTag, google::cloud::cpp::compute::organization_security_policies:: + v1::AddRuleRequest const& request) { + auto span = internal::MakeSpan( + "compute_organization_security_policies_v1::" + "OrganizationSecurityPoliciesConnection::AddRule"); + opentelemetry::trace::Scope scope(span); + return internal::EndSpan(*span, child_->AddRule(NoAwaitTag{}, request)); +} + +future> +OrganizationSecurityPoliciesTracingConnection::AddRule( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto span = internal::MakeSpan( + "compute_organization_security_policies_v1::" + "OrganizationSecurityPoliciesConnection::AddRule"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), child_->AddRule(operation)); +} + +future> +OrganizationSecurityPoliciesTracingConnection::CopyRules( + google::cloud::cpp::compute::organization_security_policies::v1:: + CopyRulesRequest const& request) { + auto span = internal::MakeSpan( + "compute_organization_security_policies_v1::" + "OrganizationSecurityPoliciesConnection::CopyRules"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), child_->CopyRules(request)); +} + +StatusOr +OrganizationSecurityPoliciesTracingConnection::CopyRules( + NoAwaitTag, google::cloud::cpp::compute::organization_security_policies:: + v1::CopyRulesRequest const& request) { + auto span = internal::MakeSpan( + "compute_organization_security_policies_v1::" + "OrganizationSecurityPoliciesConnection::CopyRules"); + opentelemetry::trace::Scope scope(span); + return internal::EndSpan(*span, child_->CopyRules(NoAwaitTag{}, request)); +} + +future> +OrganizationSecurityPoliciesTracingConnection::CopyRules( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto span = internal::MakeSpan( + "compute_organization_security_policies_v1::" + "OrganizationSecurityPoliciesConnection::CopyRules"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), child_->CopyRules(operation)); +} + +future> +OrganizationSecurityPoliciesTracingConnection::DeleteSecurityPolicy( + google::cloud::cpp::compute::organization_security_policies::v1:: + DeleteSecurityPolicyRequest const& request) { + auto span = internal::MakeSpan( + "compute_organization_security_policies_v1::" + "OrganizationSecurityPoliciesConnection::DeleteSecurityPolicy"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), + child_->DeleteSecurityPolicy(request)); +} + +StatusOr +OrganizationSecurityPoliciesTracingConnection::DeleteSecurityPolicy( + NoAwaitTag, google::cloud::cpp::compute::organization_security_policies:: + v1::DeleteSecurityPolicyRequest const& request) { + auto span = internal::MakeSpan( + "compute_organization_security_policies_v1::" + "OrganizationSecurityPoliciesConnection::DeleteSecurityPolicy"); + opentelemetry::trace::Scope scope(span); + return internal::EndSpan(*span, + child_->DeleteSecurityPolicy(NoAwaitTag{}, request)); +} + +future> +OrganizationSecurityPoliciesTracingConnection::DeleteSecurityPolicy( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto span = internal::MakeSpan( + "compute_organization_security_policies_v1::" + "OrganizationSecurityPoliciesConnection::DeleteSecurityPolicy"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), + child_->DeleteSecurityPolicy(operation)); +} + +StatusOr +OrganizationSecurityPoliciesTracingConnection::GetSecurityPolicy( + google::cloud::cpp::compute::organization_security_policies::v1:: + GetSecurityPolicyRequest const& request) { + auto span = internal::MakeSpan( + "compute_organization_security_policies_v1::" + "OrganizationSecurityPoliciesConnection::GetSecurityPolicy"); + auto scope = opentelemetry::trace::Scope(span); + return internal::EndSpan(*span, child_->GetSecurityPolicy(request)); +} + +StatusOr +OrganizationSecurityPoliciesTracingConnection::GetAssociation( + google::cloud::cpp::compute::organization_security_policies::v1:: + GetAssociationRequest const& request) { + auto span = internal::MakeSpan( + "compute_organization_security_policies_v1::" + "OrganizationSecurityPoliciesConnection::GetAssociation"); + auto scope = opentelemetry::trace::Scope(span); + return internal::EndSpan(*span, child_->GetAssociation(request)); +} + +StatusOr +OrganizationSecurityPoliciesTracingConnection::GetRule( + google::cloud::cpp::compute::organization_security_policies::v1:: + GetRuleRequest const& request) { + auto span = internal::MakeSpan( + "compute_organization_security_policies_v1::" + "OrganizationSecurityPoliciesConnection::GetRule"); + auto scope = opentelemetry::trace::Scope(span); + return internal::EndSpan(*span, child_->GetRule(request)); +} + +future> +OrganizationSecurityPoliciesTracingConnection::InsertSecurityPolicy( + google::cloud::cpp::compute::organization_security_policies::v1:: + InsertSecurityPolicyRequest const& request) { + auto span = internal::MakeSpan( + "compute_organization_security_policies_v1::" + "OrganizationSecurityPoliciesConnection::InsertSecurityPolicy"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), + child_->InsertSecurityPolicy(request)); +} + +StatusOr +OrganizationSecurityPoliciesTracingConnection::InsertSecurityPolicy( + NoAwaitTag, google::cloud::cpp::compute::organization_security_policies:: + v1::InsertSecurityPolicyRequest const& request) { + auto span = internal::MakeSpan( + "compute_organization_security_policies_v1::" + "OrganizationSecurityPoliciesConnection::InsertSecurityPolicy"); + opentelemetry::trace::Scope scope(span); + return internal::EndSpan(*span, + child_->InsertSecurityPolicy(NoAwaitTag{}, request)); +} + +future> +OrganizationSecurityPoliciesTracingConnection::InsertSecurityPolicy( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto span = internal::MakeSpan( + "compute_organization_security_policies_v1::" + "OrganizationSecurityPoliciesConnection::InsertSecurityPolicy"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), + child_->InsertSecurityPolicy(operation)); +} + +StreamRange +OrganizationSecurityPoliciesTracingConnection::ListOrganizationSecurityPolicies( + google::cloud::cpp::compute::organization_security_policies::v1:: + ListOrganizationSecurityPoliciesRequest request) { + auto span = internal::MakeSpan( + "compute_organization_security_policies_v1::" + "OrganizationSecurityPoliciesConnection::" + "ListOrganizationSecurityPolicies"); + internal::OTelScope scope(span); + auto sr = child_->ListOrganizationSecurityPolicies(std::move(request)); + return internal::MakeTracedStreamRange< + google::cloud::cpp::compute::v1::SecurityPolicy>(std::move(span), + std::move(sr)); +} + +StatusOr +OrganizationSecurityPoliciesTracingConnection::ListAssociations( + google::cloud::cpp::compute::organization_security_policies::v1:: + ListAssociationsRequest const& request) { + auto span = internal::MakeSpan( + "compute_organization_security_policies_v1::" + "OrganizationSecurityPoliciesConnection::ListAssociations"); + auto scope = opentelemetry::trace::Scope(span); + return internal::EndSpan(*span, child_->ListAssociations(request)); +} + +StatusOr +OrganizationSecurityPoliciesTracingConnection::ListPreconfiguredExpressionSets( + google::cloud::cpp::compute::organization_security_policies::v1:: + ListPreconfiguredExpressionSetsRequest const& request) { + auto span = internal::MakeSpan( + "compute_organization_security_policies_v1::" + "OrganizationSecurityPoliciesConnection::" + "ListPreconfiguredExpressionSets"); + auto scope = opentelemetry::trace::Scope(span); + return internal::EndSpan(*span, + child_->ListPreconfiguredExpressionSets(request)); +} + +future> +OrganizationSecurityPoliciesTracingConnection::Move( + google::cloud::cpp::compute::organization_security_policies::v1:: + MoveRequest const& request) { + auto span = internal::MakeSpan( + "compute_organization_security_policies_v1::" + "OrganizationSecurityPoliciesConnection::Move"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), child_->Move(request)); +} + +StatusOr +OrganizationSecurityPoliciesTracingConnection::Move( + NoAwaitTag, google::cloud::cpp::compute::organization_security_policies:: + v1::MoveRequest const& request) { + auto span = internal::MakeSpan( + "compute_organization_security_policies_v1::" + "OrganizationSecurityPoliciesConnection::Move"); + opentelemetry::trace::Scope scope(span); + return internal::EndSpan(*span, child_->Move(NoAwaitTag{}, request)); +} + +future> +OrganizationSecurityPoliciesTracingConnection::Move( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto span = internal::MakeSpan( + "compute_organization_security_policies_v1::" + "OrganizationSecurityPoliciesConnection::Move"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), child_->Move(operation)); +} + +future> +OrganizationSecurityPoliciesTracingConnection::PatchSecurityPolicy( + google::cloud::cpp::compute::organization_security_policies::v1:: + PatchSecurityPolicyRequest const& request) { + auto span = internal::MakeSpan( + "compute_organization_security_policies_v1::" + "OrganizationSecurityPoliciesConnection::PatchSecurityPolicy"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), + child_->PatchSecurityPolicy(request)); +} + +StatusOr +OrganizationSecurityPoliciesTracingConnection::PatchSecurityPolicy( + NoAwaitTag, google::cloud::cpp::compute::organization_security_policies:: + v1::PatchSecurityPolicyRequest const& request) { + auto span = internal::MakeSpan( + "compute_organization_security_policies_v1::" + "OrganizationSecurityPoliciesConnection::PatchSecurityPolicy"); + opentelemetry::trace::Scope scope(span); + return internal::EndSpan(*span, + child_->PatchSecurityPolicy(NoAwaitTag{}, request)); +} + +future> +OrganizationSecurityPoliciesTracingConnection::PatchSecurityPolicy( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto span = internal::MakeSpan( + "compute_organization_security_policies_v1::" + "OrganizationSecurityPoliciesConnection::PatchSecurityPolicy"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), + child_->PatchSecurityPolicy(operation)); +} + +future> +OrganizationSecurityPoliciesTracingConnection::PatchRule( + google::cloud::cpp::compute::organization_security_policies::v1:: + PatchRuleRequest const& request) { + auto span = internal::MakeSpan( + "compute_organization_security_policies_v1::" + "OrganizationSecurityPoliciesConnection::PatchRule"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), child_->PatchRule(request)); +} + +StatusOr +OrganizationSecurityPoliciesTracingConnection::PatchRule( + NoAwaitTag, google::cloud::cpp::compute::organization_security_policies:: + v1::PatchRuleRequest const& request) { + auto span = internal::MakeSpan( + "compute_organization_security_policies_v1::" + "OrganizationSecurityPoliciesConnection::PatchRule"); + opentelemetry::trace::Scope scope(span); + return internal::EndSpan(*span, child_->PatchRule(NoAwaitTag{}, request)); +} + +future> +OrganizationSecurityPoliciesTracingConnection::PatchRule( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto span = internal::MakeSpan( + "compute_organization_security_policies_v1::" + "OrganizationSecurityPoliciesConnection::PatchRule"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), child_->PatchRule(operation)); +} + +future> +OrganizationSecurityPoliciesTracingConnection::RemoveAssociation( + google::cloud::cpp::compute::organization_security_policies::v1:: + RemoveAssociationRequest const& request) { + auto span = internal::MakeSpan( + "compute_organization_security_policies_v1::" + "OrganizationSecurityPoliciesConnection::RemoveAssociation"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), child_->RemoveAssociation(request)); +} + +StatusOr +OrganizationSecurityPoliciesTracingConnection::RemoveAssociation( + NoAwaitTag, google::cloud::cpp::compute::organization_security_policies:: + v1::RemoveAssociationRequest const& request) { + auto span = internal::MakeSpan( + "compute_organization_security_policies_v1::" + "OrganizationSecurityPoliciesConnection::RemoveAssociation"); + opentelemetry::trace::Scope scope(span); + return internal::EndSpan(*span, + child_->RemoveAssociation(NoAwaitTag{}, request)); +} + +future> +OrganizationSecurityPoliciesTracingConnection::RemoveAssociation( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto span = internal::MakeSpan( + "compute_organization_security_policies_v1::" + "OrganizationSecurityPoliciesConnection::RemoveAssociation"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), + child_->RemoveAssociation(operation)); +} + +future> +OrganizationSecurityPoliciesTracingConnection::RemoveRule( + google::cloud::cpp::compute::organization_security_policies::v1:: + RemoveRuleRequest const& request) { + auto span = internal::MakeSpan( + "compute_organization_security_policies_v1::" + "OrganizationSecurityPoliciesConnection::RemoveRule"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), child_->RemoveRule(request)); +} + +StatusOr +OrganizationSecurityPoliciesTracingConnection::RemoveRule( + NoAwaitTag, google::cloud::cpp::compute::organization_security_policies:: + v1::RemoveRuleRequest const& request) { + auto span = internal::MakeSpan( + "compute_organization_security_policies_v1::" + "OrganizationSecurityPoliciesConnection::RemoveRule"); + opentelemetry::trace::Scope scope(span); + return internal::EndSpan(*span, child_->RemoveRule(NoAwaitTag{}, request)); +} + +future> +OrganizationSecurityPoliciesTracingConnection::RemoveRule( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto span = internal::MakeSpan( + "compute_organization_security_policies_v1::" + "OrganizationSecurityPoliciesConnection::RemoveRule"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), child_->RemoveRule(operation)); +} + +std::shared_ptr +MakeOrganizationSecurityPoliciesTracingConnection( + std::shared_ptr + conn) { + if (internal::TracingEnabled(conn->options())) { + conn = std::make_shared( + std::move(conn)); + } + return conn; +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_organization_security_policies_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_tracing_connection.h b/google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_tracing_connection.h new file mode 100644 index 0000000000000..d5902f876cc84 --- /dev/null +++ b/google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_tracing_connection.h @@ -0,0 +1,215 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/organization_security_policies/v1/organization_security_policies.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ORGANIZATION_SECURITY_POLICIES_V1_INTERNAL_ORGANIZATION_SECURITY_POLICIES_TRACING_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ORGANIZATION_SECURITY_POLICIES_V1_INTERNAL_ORGANIZATION_SECURITY_POLICIES_TRACING_CONNECTION_H + +#include "google/cloud/compute/organization_security_policies/v1/organization_security_policies_connection.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_organization_security_policies_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class OrganizationSecurityPoliciesTracingConnection + : public compute_organization_security_policies_v1:: + OrganizationSecurityPoliciesConnection { + public: + ~OrganizationSecurityPoliciesTracingConnection() override = default; + + explicit OrganizationSecurityPoliciesTracingConnection( + std::shared_ptr + child); + + Options options() override { return child_->options(); } + + future> AddAssociation( + google::cloud::cpp::compute::organization_security_policies::v1:: + AddAssociationRequest const& request) override; + + StatusOr AddAssociation( + NoAwaitTag, google::cloud::cpp::compute::organization_security_policies:: + v1::AddAssociationRequest const& request) override; + + future> AddAssociation( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + future> AddRule( + google::cloud::cpp::compute::organization_security_policies::v1:: + AddRuleRequest const& request) override; + + StatusOr AddRule( + NoAwaitTag, google::cloud::cpp::compute::organization_security_policies:: + v1::AddRuleRequest const& request) override; + + future> AddRule( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + future> CopyRules( + google::cloud::cpp::compute::organization_security_policies::v1:: + CopyRulesRequest const& request) override; + + StatusOr CopyRules( + NoAwaitTag, google::cloud::cpp::compute::organization_security_policies:: + v1::CopyRulesRequest const& request) override; + + future> CopyRules( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + future> + DeleteSecurityPolicy( + google::cloud::cpp::compute::organization_security_policies::v1:: + DeleteSecurityPolicyRequest const& request) override; + + StatusOr DeleteSecurityPolicy( + NoAwaitTag, google::cloud::cpp::compute::organization_security_policies:: + v1::DeleteSecurityPolicyRequest const& request) override; + + future> + DeleteSecurityPolicy( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + StatusOr GetSecurityPolicy( + google::cloud::cpp::compute::organization_security_policies::v1:: + GetSecurityPolicyRequest const& request) override; + + StatusOr + GetAssociation(google::cloud::cpp::compute::organization_security_policies:: + v1::GetAssociationRequest const& request) override; + + StatusOr GetRule( + google::cloud::cpp::compute::organization_security_policies::v1:: + GetRuleRequest const& request) override; + + future> + InsertSecurityPolicy( + google::cloud::cpp::compute::organization_security_policies::v1:: + InsertSecurityPolicyRequest const& request) override; + + StatusOr InsertSecurityPolicy( + NoAwaitTag, google::cloud::cpp::compute::organization_security_policies:: + v1::InsertSecurityPolicyRequest const& request) override; + + future> + InsertSecurityPolicy( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + StreamRange + ListOrganizationSecurityPolicies( + google::cloud::cpp::compute::organization_security_policies::v1:: + ListOrganizationSecurityPoliciesRequest request) override; + + StatusOr + ListAssociations(google::cloud::cpp::compute::organization_security_policies:: + v1::ListAssociationsRequest const& request) override; + + StatusOr + ListPreconfiguredExpressionSets( + google::cloud::cpp::compute::organization_security_policies::v1:: + ListPreconfiguredExpressionSetsRequest const& request) override; + + future> Move( + google::cloud::cpp::compute::organization_security_policies::v1:: + MoveRequest const& request) override; + + StatusOr Move( + NoAwaitTag, google::cloud::cpp::compute::organization_security_policies:: + v1::MoveRequest const& request) override; + + future> Move( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + future> + PatchSecurityPolicy( + google::cloud::cpp::compute::organization_security_policies::v1:: + PatchSecurityPolicyRequest const& request) override; + + StatusOr PatchSecurityPolicy( + NoAwaitTag, google::cloud::cpp::compute::organization_security_policies:: + v1::PatchSecurityPolicyRequest const& request) override; + + future> + PatchSecurityPolicy( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + future> PatchRule( + google::cloud::cpp::compute::organization_security_policies::v1:: + PatchRuleRequest const& request) override; + + StatusOr PatchRule( + NoAwaitTag, google::cloud::cpp::compute::organization_security_policies:: + v1::PatchRuleRequest const& request) override; + + future> PatchRule( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + future> + RemoveAssociation( + google::cloud::cpp::compute::organization_security_policies::v1:: + RemoveAssociationRequest const& request) override; + + StatusOr RemoveAssociation( + NoAwaitTag, google::cloud::cpp::compute::organization_security_policies:: + v1::RemoveAssociationRequest const& request) override; + + future> + RemoveAssociation( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + future> RemoveRule( + google::cloud::cpp::compute::organization_security_policies::v1:: + RemoveRuleRequest const& request) override; + + StatusOr RemoveRule( + NoAwaitTag, google::cloud::cpp::compute::organization_security_policies:: + v1::RemoveRuleRequest const& request) override; + + future> RemoveRule( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + private: + std::shared_ptr + child_; +}; + +/** + * Conditionally applies the tracing decorator to the given connection. + * + * The connection is only decorated if tracing is enabled (as determined by the + * connection's options). + */ +std::shared_ptr +MakeOrganizationSecurityPoliciesTracingConnection( + std::shared_ptr + conn); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_organization_security_policies_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ORGANIZATION_SECURITY_POLICIES_V1_INTERNAL_ORGANIZATION_SECURITY_POLICIES_TRACING_CONNECTION_H diff --git a/google/cloud/compute/organization_security_policies/v1/mocks/mock_organization_security_policies_connection.h b/google/cloud/compute/organization_security_policies/v1/mocks/mock_organization_security_policies_connection.h new file mode 100644 index 0000000000000..9c85fa58fcdf8 --- /dev/null +++ b/google/cloud/compute/organization_security_policies/v1/mocks/mock_organization_security_policies_connection.h @@ -0,0 +1,509 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/organization_security_policies/v1/organization_security_policies.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ORGANIZATION_SECURITY_POLICIES_V1_MOCKS_MOCK_ORGANIZATION_SECURITY_POLICIES_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ORGANIZATION_SECURITY_POLICIES_V1_MOCKS_MOCK_ORGANIZATION_SECURITY_POLICIES_CONNECTION_H + +#include "google/cloud/compute/organization_security_policies/v1/organization_security_policies_connection.h" +#include + +namespace google { +namespace cloud { +namespace compute_organization_security_policies_v1_mocks { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/** + * A class to mock `OrganizationSecurityPoliciesConnection`. + * + * Application developers may want to test their code with simulated responses, + * including errors, from an object of type + * `OrganizationSecurityPoliciesClient`. To do so, construct an object of type + * `OrganizationSecurityPoliciesClient` with an instance of this class. Then use + * the Google Test framework functions to program the behavior of this mock. + * + * @see [This example][bq-mock] for how to test your application with GoogleTest. + * While the example showcases types from the BigQuery library, the underlying + * principles apply for any pair of `*Client` and `*Connection`. + * + * [bq-mock]: @cloud_cpp_docs_link{bigquery,bigquery-read-mock} + */ +class MockOrganizationSecurityPoliciesConnection + : public compute_organization_security_policies_v1:: + OrganizationSecurityPoliciesConnection { + public: + MOCK_METHOD(Options, options, (), (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// AddAssociation(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + AddAssociation, + (google::cloud::cpp::compute::organization_security_policies::v1:: + AddAssociationRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// EXPECT_CALL(*mock, AddAssociation(_, _)) + /// @endcode + MOCK_METHOD(StatusOr, + AddAssociation, + (NoAwaitTag, + google::cloud::cpp::compute::organization_security_policies::v1:: + AddAssociationRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// AddAssociation(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + AddAssociation, + (google::cloud::cpp::compute::v1::Operation const& operation), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// AddRule(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + AddRule, + (google::cloud::cpp::compute::organization_security_policies::v1:: + AddRuleRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// EXPECT_CALL(*mock, AddRule(_, _)) + /// @endcode + MOCK_METHOD(StatusOr, AddRule, + (NoAwaitTag, + google::cloud::cpp::compute::organization_security_policies::v1:: + AddRuleRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// AddRule(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + AddRule, + (google::cloud::cpp::compute::v1::Operation const& operation), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// CopyRules(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + CopyRules, + (google::cloud::cpp::compute::organization_security_policies::v1:: + CopyRulesRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// EXPECT_CALL(*mock, CopyRules(_, _)) + /// @endcode + MOCK_METHOD(StatusOr, CopyRules, + (NoAwaitTag, + google::cloud::cpp::compute::organization_security_policies::v1:: + CopyRulesRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// CopyRules(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + CopyRules, + (google::cloud::cpp::compute::v1::Operation const& operation), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// DeleteSecurityPolicy(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + DeleteSecurityPolicy, + (google::cloud::cpp::compute::organization_security_policies::v1:: + DeleteSecurityPolicyRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// EXPECT_CALL(*mock, DeleteSecurityPolicy(_, _)) + /// @endcode + MOCK_METHOD(StatusOr, + DeleteSecurityPolicy, + (NoAwaitTag, + google::cloud::cpp::compute::organization_security_policies::v1:: + DeleteSecurityPolicyRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// DeleteSecurityPolicy(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + DeleteSecurityPolicy, + (google::cloud::cpp::compute::v1::Operation const& operation), + (override)); + + MOCK_METHOD(StatusOr, + GetSecurityPolicy, + (google::cloud::cpp::compute::organization_security_policies::v1:: + GetSecurityPolicyRequest const& request), + (override)); + + MOCK_METHOD( + StatusOr, + GetAssociation, + (google::cloud::cpp::compute::organization_security_policies::v1:: + GetAssociationRequest const& request), + (override)); + + MOCK_METHOD(StatusOr, + GetRule, + (google::cloud::cpp::compute::organization_security_policies::v1:: + GetRuleRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// InsertSecurityPolicy(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + InsertSecurityPolicy, + (google::cloud::cpp::compute::organization_security_policies::v1:: + InsertSecurityPolicyRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// EXPECT_CALL(*mock, InsertSecurityPolicy(_, _)) + /// @endcode + MOCK_METHOD(StatusOr, + InsertSecurityPolicy, + (NoAwaitTag, + google::cloud::cpp::compute::organization_security_policies::v1:: + InsertSecurityPolicyRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// InsertSecurityPolicy(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + InsertSecurityPolicy, + (google::cloud::cpp::compute::v1::Operation const& operation), + (override)); + + MOCK_METHOD((StreamRange), + ListOrganizationSecurityPolicies, + (google::cloud::cpp::compute::organization_security_policies::v1:: + ListOrganizationSecurityPoliciesRequest request), + (override)); + + MOCK_METHOD( + StatusOr, + ListAssociations, + (google::cloud::cpp::compute::organization_security_policies::v1:: + ListAssociationsRequest const& request), + (override)); + + MOCK_METHOD( + StatusOr, + ListPreconfiguredExpressionSets, + (google::cloud::cpp::compute::organization_security_policies::v1:: + ListPreconfiguredExpressionSetsRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// Move(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + Move, + (google::cloud::cpp::compute::organization_security_policies::v1:: + MoveRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// EXPECT_CALL(*mock, Move(_, _)) + /// @endcode + MOCK_METHOD(StatusOr, Move, + (NoAwaitTag, + google::cloud::cpp::compute::organization_security_policies::v1:: + MoveRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, Move(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + Move, + (google::cloud::cpp::compute::v1::Operation const& operation), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// PatchSecurityPolicy(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + PatchSecurityPolicy, + (google::cloud::cpp::compute::organization_security_policies::v1:: + PatchSecurityPolicyRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// EXPECT_CALL(*mock, PatchSecurityPolicy(_, _)) + /// @endcode + MOCK_METHOD(StatusOr, + PatchSecurityPolicy, + (NoAwaitTag, + google::cloud::cpp::compute::organization_security_policies::v1:: + PatchSecurityPolicyRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// PatchSecurityPolicy(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + PatchSecurityPolicy, + (google::cloud::cpp::compute::v1::Operation const& operation), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// PatchRule(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + PatchRule, + (google::cloud::cpp::compute::organization_security_policies::v1:: + PatchRuleRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// EXPECT_CALL(*mock, PatchRule(_, _)) + /// @endcode + MOCK_METHOD(StatusOr, PatchRule, + (NoAwaitTag, + google::cloud::cpp::compute::organization_security_policies::v1:: + PatchRuleRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// PatchRule(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + PatchRule, + (google::cloud::cpp::compute::v1::Operation const& operation), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// RemoveAssociation(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + RemoveAssociation, + (google::cloud::cpp::compute::organization_security_policies::v1:: + RemoveAssociationRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// EXPECT_CALL(*mock, RemoveAssociation(_, _)) + /// @endcode + MOCK_METHOD(StatusOr, + RemoveAssociation, + (NoAwaitTag, + google::cloud::cpp::compute::organization_security_policies::v1:: + RemoveAssociationRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// RemoveAssociation(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + RemoveAssociation, + (google::cloud::cpp::compute::v1::Operation const& operation), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// RemoveRule(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + RemoveRule, + (google::cloud::cpp::compute::organization_security_policies::v1:: + RemoveRuleRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// EXPECT_CALL(*mock, RemoveRule(_, _)) + /// @endcode + MOCK_METHOD(StatusOr, RemoveRule, + (NoAwaitTag, + google::cloud::cpp::compute::organization_security_policies::v1:: + RemoveRuleRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// RemoveRule(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + RemoveRule, + (google::cloud::cpp::compute::v1::Operation const& operation), + (override)); +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_organization_security_policies_v1_mocks +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ORGANIZATION_SECURITY_POLICIES_V1_MOCKS_MOCK_ORGANIZATION_SECURITY_POLICIES_CONNECTION_H diff --git a/google/cloud/compute/organization_security_policies/v1/organization_security_policies_client.cc b/google/cloud/compute/organization_security_policies/v1/organization_security_policies_client.cc new file mode 100644 index 0000000000000..dd4652dd92e13 --- /dev/null +++ b/google/cloud/compute/organization_security_policies/v1/organization_security_policies_client.cc @@ -0,0 +1,606 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/organization_security_policies/v1/organization_security_policies.proto + +#include "google/cloud/compute/organization_security_policies/v1/organization_security_policies_client.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_organization_security_policies_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +OrganizationSecurityPoliciesClient::OrganizationSecurityPoliciesClient( + std::shared_ptr connection, + Options opts) + : connection_(std::move(connection)), + options_( + internal::MergeOptions(std::move(opts), connection_->options())) {} +OrganizationSecurityPoliciesClient::~OrganizationSecurityPoliciesClient() = + default; + +future> +OrganizationSecurityPoliciesClient::AddAssociation( + std::string const& security_policy, + google::cloud::cpp::compute::v1::SecurityPolicyAssociation const& + security_policy_association_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::organization_security_policies::v1:: + AddAssociationRequest request; + request.set_security_policy(security_policy); + *request.mutable_security_policy_association_resource() = + security_policy_association_resource; + return connection_->AddAssociation(request); +} + +StatusOr +OrganizationSecurityPoliciesClient::AddAssociation( + NoAwaitTag, std::string const& security_policy, + google::cloud::cpp::compute::v1::SecurityPolicyAssociation const& + security_policy_association_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::organization_security_policies::v1:: + AddAssociationRequest request; + request.set_security_policy(security_policy); + *request.mutable_security_policy_association_resource() = + security_policy_association_resource; + return connection_->AddAssociation(NoAwaitTag{}, request); +} + +future> +OrganizationSecurityPoliciesClient::AddAssociation( + google::cloud::cpp::compute::organization_security_policies::v1:: + AddAssociationRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->AddAssociation(request); +} + +StatusOr +OrganizationSecurityPoliciesClient::AddAssociation( + NoAwaitTag, + google::cloud::cpp::compute::organization_security_policies::v1:: + AddAssociationRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->AddAssociation(NoAwaitTag{}, request); +} + +future> +OrganizationSecurityPoliciesClient::AddAssociation( + google::cloud::cpp::compute::v1::Operation const& operation, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->AddAssociation(operation); +} + +future> +OrganizationSecurityPoliciesClient::AddRule( + std::string const& security_policy, + google::cloud::cpp::compute::v1::SecurityPolicyRule const& + security_policy_rule_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::organization_security_policies::v1:: + AddRuleRequest request; + request.set_security_policy(security_policy); + *request.mutable_security_policy_rule_resource() = + security_policy_rule_resource; + return connection_->AddRule(request); +} + +StatusOr +OrganizationSecurityPoliciesClient::AddRule( + NoAwaitTag, std::string const& security_policy, + google::cloud::cpp::compute::v1::SecurityPolicyRule const& + security_policy_rule_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::organization_security_policies::v1:: + AddRuleRequest request; + request.set_security_policy(security_policy); + *request.mutable_security_policy_rule_resource() = + security_policy_rule_resource; + return connection_->AddRule(NoAwaitTag{}, request); +} + +future> +OrganizationSecurityPoliciesClient::AddRule( + google::cloud::cpp::compute::organization_security_policies::v1:: + AddRuleRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->AddRule(request); +} + +StatusOr +OrganizationSecurityPoliciesClient::AddRule( + NoAwaitTag, + google::cloud::cpp::compute::organization_security_policies::v1:: + AddRuleRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->AddRule(NoAwaitTag{}, request); +} + +future> +OrganizationSecurityPoliciesClient::AddRule( + google::cloud::cpp::compute::v1::Operation const& operation, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->AddRule(operation); +} + +future> +OrganizationSecurityPoliciesClient::CopyRules( + std::string const& security_policy, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::organization_security_policies::v1:: + CopyRulesRequest request; + request.set_security_policy(security_policy); + return connection_->CopyRules(request); +} + +StatusOr +OrganizationSecurityPoliciesClient::CopyRules( + NoAwaitTag, std::string const& security_policy, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::organization_security_policies::v1:: + CopyRulesRequest request; + request.set_security_policy(security_policy); + return connection_->CopyRules(NoAwaitTag{}, request); +} + +future> +OrganizationSecurityPoliciesClient::CopyRules( + google::cloud::cpp::compute::organization_security_policies::v1:: + CopyRulesRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->CopyRules(request); +} + +StatusOr +OrganizationSecurityPoliciesClient::CopyRules( + NoAwaitTag, + google::cloud::cpp::compute::organization_security_policies::v1:: + CopyRulesRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->CopyRules(NoAwaitTag{}, request); +} + +future> +OrganizationSecurityPoliciesClient::CopyRules( + google::cloud::cpp::compute::v1::Operation const& operation, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->CopyRules(operation); +} + +future> +OrganizationSecurityPoliciesClient::DeleteSecurityPolicy( + std::string const& security_policy, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::organization_security_policies::v1:: + DeleteSecurityPolicyRequest request; + request.set_security_policy(security_policy); + return connection_->DeleteSecurityPolicy(request); +} + +StatusOr +OrganizationSecurityPoliciesClient::DeleteSecurityPolicy( + NoAwaitTag, std::string const& security_policy, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::organization_security_policies::v1:: + DeleteSecurityPolicyRequest request; + request.set_security_policy(security_policy); + return connection_->DeleteSecurityPolicy(NoAwaitTag{}, request); +} + +future> +OrganizationSecurityPoliciesClient::DeleteSecurityPolicy( + google::cloud::cpp::compute::organization_security_policies::v1:: + DeleteSecurityPolicyRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->DeleteSecurityPolicy(request); +} + +StatusOr +OrganizationSecurityPoliciesClient::DeleteSecurityPolicy( + NoAwaitTag, + google::cloud::cpp::compute::organization_security_policies::v1:: + DeleteSecurityPolicyRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->DeleteSecurityPolicy(NoAwaitTag{}, request); +} + +future> +OrganizationSecurityPoliciesClient::DeleteSecurityPolicy( + google::cloud::cpp::compute::v1::Operation const& operation, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->DeleteSecurityPolicy(operation); +} + +StatusOr +OrganizationSecurityPoliciesClient::GetSecurityPolicy( + std::string const& security_policy, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::organization_security_policies::v1:: + GetSecurityPolicyRequest request; + request.set_security_policy(security_policy); + return connection_->GetSecurityPolicy(request); +} + +StatusOr +OrganizationSecurityPoliciesClient::GetSecurityPolicy( + google::cloud::cpp::compute::organization_security_policies::v1:: + GetSecurityPolicyRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->GetSecurityPolicy(request); +} + +StatusOr +OrganizationSecurityPoliciesClient::GetAssociation( + std::string const& security_policy, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::organization_security_policies::v1:: + GetAssociationRequest request; + request.set_security_policy(security_policy); + return connection_->GetAssociation(request); +} + +StatusOr +OrganizationSecurityPoliciesClient::GetAssociation( + google::cloud::cpp::compute::organization_security_policies::v1:: + GetAssociationRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->GetAssociation(request); +} + +StatusOr +OrganizationSecurityPoliciesClient::GetRule(std::string const& security_policy, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::organization_security_policies::v1:: + GetRuleRequest request; + request.set_security_policy(security_policy); + return connection_->GetRule(request); +} + +StatusOr +OrganizationSecurityPoliciesClient::GetRule( + google::cloud::cpp::compute::organization_security_policies::v1:: + GetRuleRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->GetRule(request); +} + +future> +OrganizationSecurityPoliciesClient::InsertSecurityPolicy( + google::cloud::cpp::compute::organization_security_policies::v1:: + InsertSecurityPolicyRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->InsertSecurityPolicy(request); +} + +StatusOr +OrganizationSecurityPoliciesClient::InsertSecurityPolicy( + NoAwaitTag, + google::cloud::cpp::compute::organization_security_policies::v1:: + InsertSecurityPolicyRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->InsertSecurityPolicy(NoAwaitTag{}, request); +} + +future> +OrganizationSecurityPoliciesClient::InsertSecurityPolicy( + google::cloud::cpp::compute::v1::Operation const& operation, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->InsertSecurityPolicy(operation); +} + +StreamRange +OrganizationSecurityPoliciesClient::ListOrganizationSecurityPolicies( + google::cloud::cpp::compute::organization_security_policies::v1:: + ListOrganizationSecurityPoliciesRequest request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->ListOrganizationSecurityPolicies(std::move(request)); +} + +StatusOr +OrganizationSecurityPoliciesClient::ListAssociations( + google::cloud::cpp::compute::organization_security_policies::v1:: + ListAssociationsRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->ListAssociations(request); +} + +StatusOr +OrganizationSecurityPoliciesClient::ListPreconfiguredExpressionSets( + google::cloud::cpp::compute::organization_security_policies::v1:: + ListPreconfiguredExpressionSetsRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->ListPreconfiguredExpressionSets(request); +} + +future> +OrganizationSecurityPoliciesClient::Move(std::string const& security_policy, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::organization_security_policies::v1::MoveRequest + request; + request.set_security_policy(security_policy); + return connection_->Move(request); +} + +StatusOr +OrganizationSecurityPoliciesClient::Move(NoAwaitTag, + std::string const& security_policy, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::organization_security_policies::v1::MoveRequest + request; + request.set_security_policy(security_policy); + return connection_->Move(NoAwaitTag{}, request); +} + +future> +OrganizationSecurityPoliciesClient::Move( + google::cloud::cpp::compute::organization_security_policies::v1:: + MoveRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->Move(request); +} + +StatusOr +OrganizationSecurityPoliciesClient::Move( + NoAwaitTag, + google::cloud::cpp::compute::organization_security_policies::v1:: + MoveRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->Move(NoAwaitTag{}, request); +} + +future> +OrganizationSecurityPoliciesClient::Move( + google::cloud::cpp::compute::v1::Operation const& operation, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->Move(operation); +} + +future> +OrganizationSecurityPoliciesClient::PatchSecurityPolicy( + std::string const& security_policy, + google::cloud::cpp::compute::v1::SecurityPolicy const& + security_policy_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::organization_security_policies::v1:: + PatchSecurityPolicyRequest request; + request.set_security_policy(security_policy); + *request.mutable_security_policy_resource() = security_policy_resource; + return connection_->PatchSecurityPolicy(request); +} + +StatusOr +OrganizationSecurityPoliciesClient::PatchSecurityPolicy( + NoAwaitTag, std::string const& security_policy, + google::cloud::cpp::compute::v1::SecurityPolicy const& + security_policy_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::organization_security_policies::v1:: + PatchSecurityPolicyRequest request; + request.set_security_policy(security_policy); + *request.mutable_security_policy_resource() = security_policy_resource; + return connection_->PatchSecurityPolicy(NoAwaitTag{}, request); +} + +future> +OrganizationSecurityPoliciesClient::PatchSecurityPolicy( + google::cloud::cpp::compute::organization_security_policies::v1:: + PatchSecurityPolicyRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->PatchSecurityPolicy(request); +} + +StatusOr +OrganizationSecurityPoliciesClient::PatchSecurityPolicy( + NoAwaitTag, + google::cloud::cpp::compute::organization_security_policies::v1:: + PatchSecurityPolicyRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->PatchSecurityPolicy(NoAwaitTag{}, request); +} + +future> +OrganizationSecurityPoliciesClient::PatchSecurityPolicy( + google::cloud::cpp::compute::v1::Operation const& operation, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->PatchSecurityPolicy(operation); +} + +future> +OrganizationSecurityPoliciesClient::PatchRule( + std::string const& security_policy, + google::cloud::cpp::compute::v1::SecurityPolicyRule const& + security_policy_rule_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::organization_security_policies::v1:: + PatchRuleRequest request; + request.set_security_policy(security_policy); + *request.mutable_security_policy_rule_resource() = + security_policy_rule_resource; + return connection_->PatchRule(request); +} + +StatusOr +OrganizationSecurityPoliciesClient::PatchRule( + NoAwaitTag, std::string const& security_policy, + google::cloud::cpp::compute::v1::SecurityPolicyRule const& + security_policy_rule_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::organization_security_policies::v1:: + PatchRuleRequest request; + request.set_security_policy(security_policy); + *request.mutable_security_policy_rule_resource() = + security_policy_rule_resource; + return connection_->PatchRule(NoAwaitTag{}, request); +} + +future> +OrganizationSecurityPoliciesClient::PatchRule( + google::cloud::cpp::compute::organization_security_policies::v1:: + PatchRuleRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->PatchRule(request); +} + +StatusOr +OrganizationSecurityPoliciesClient::PatchRule( + NoAwaitTag, + google::cloud::cpp::compute::organization_security_policies::v1:: + PatchRuleRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->PatchRule(NoAwaitTag{}, request); +} + +future> +OrganizationSecurityPoliciesClient::PatchRule( + google::cloud::cpp::compute::v1::Operation const& operation, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->PatchRule(operation); +} + +future> +OrganizationSecurityPoliciesClient::RemoveAssociation( + std::string const& security_policy, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::organization_security_policies::v1:: + RemoveAssociationRequest request; + request.set_security_policy(security_policy); + return connection_->RemoveAssociation(request); +} + +StatusOr +OrganizationSecurityPoliciesClient::RemoveAssociation( + NoAwaitTag, std::string const& security_policy, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::organization_security_policies::v1:: + RemoveAssociationRequest request; + request.set_security_policy(security_policy); + return connection_->RemoveAssociation(NoAwaitTag{}, request); +} + +future> +OrganizationSecurityPoliciesClient::RemoveAssociation( + google::cloud::cpp::compute::organization_security_policies::v1:: + RemoveAssociationRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->RemoveAssociation(request); +} + +StatusOr +OrganizationSecurityPoliciesClient::RemoveAssociation( + NoAwaitTag, + google::cloud::cpp::compute::organization_security_policies::v1:: + RemoveAssociationRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->RemoveAssociation(NoAwaitTag{}, request); +} + +future> +OrganizationSecurityPoliciesClient::RemoveAssociation( + google::cloud::cpp::compute::v1::Operation const& operation, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->RemoveAssociation(operation); +} + +future> +OrganizationSecurityPoliciesClient::RemoveRule( + std::string const& security_policy, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::organization_security_policies::v1:: + RemoveRuleRequest request; + request.set_security_policy(security_policy); + return connection_->RemoveRule(request); +} + +StatusOr +OrganizationSecurityPoliciesClient::RemoveRule( + NoAwaitTag, std::string const& security_policy, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::organization_security_policies::v1:: + RemoveRuleRequest request; + request.set_security_policy(security_policy); + return connection_->RemoveRule(NoAwaitTag{}, request); +} + +future> +OrganizationSecurityPoliciesClient::RemoveRule( + google::cloud::cpp::compute::organization_security_policies::v1:: + RemoveRuleRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->RemoveRule(request); +} + +StatusOr +OrganizationSecurityPoliciesClient::RemoveRule( + NoAwaitTag, + google::cloud::cpp::compute::organization_security_policies::v1:: + RemoveRuleRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->RemoveRule(NoAwaitTag{}, request); +} + +future> +OrganizationSecurityPoliciesClient::RemoveRule( + google::cloud::cpp::compute::v1::Operation const& operation, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->RemoveRule(operation); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_organization_security_policies_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/organization_security_policies/v1/organization_security_policies_client.h b/google/cloud/compute/organization_security_policies/v1/organization_security_policies_client.h new file mode 100644 index 0000000000000..8a3dbb486e7b9 --- /dev/null +++ b/google/cloud/compute/organization_security_policies/v1/organization_security_policies_client.h @@ -0,0 +1,1667 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/organization_security_policies/v1/organization_security_policies.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ORGANIZATION_SECURITY_POLICIES_V1_ORGANIZATION_SECURITY_POLICIES_CLIENT_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ORGANIZATION_SECURITY_POLICIES_V1_ORGANIZATION_SECURITY_POLICIES_CLIENT_H + +#include "google/cloud/compute/organization_security_policies/v1/organization_security_policies_rest_connection.h" +#include "google/cloud/future.h" +#include "google/cloud/no_await_tag.h" +#include "google/cloud/options.h" +#include "google/cloud/polling_policy.h" +#include "google/cloud/status_or.h" +#include "google/cloud/version.h" +#include +#include +#include + +namespace google { +namespace cloud { +namespace compute_organization_security_policies_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/// +/// Service for the organizationSecurityPolicies resource. +/// https://cloud.google.com/compute/docs/reference/rest/v1/organizationSecurityPolicies +/// +/// @par Equality +/// +/// Instances of this class created via copy-construction or copy-assignment +/// always compare equal. Instances created with equal +/// `std::shared_ptr<*Connection>` objects compare equal. Objects that compare +/// equal share the same underlying resources. +/// +/// @par Performance +/// +/// Creating a new instance of this class is a relatively expensive operation, +/// new objects establish new connections to the service. In contrast, +/// copy-construction, move-construction, and the corresponding assignment +/// operations are relatively efficient as the copies share all underlying +/// resources. +/// +/// @par Thread Safety +/// +/// Concurrent access to different instances of this class, even if they compare +/// equal, is guaranteed to work. Two or more threads operating on the same +/// instance of this class is not guaranteed to work. Since copy-construction +/// and move-construction is a relatively efficient operation, consider using +/// such a copy when using this class from multiple threads. +/// +class OrganizationSecurityPoliciesClient { + public: + explicit OrganizationSecurityPoliciesClient( + std::shared_ptr connection, + Options opts = {}); + ~OrganizationSecurityPoliciesClient(); + + ///@{ + /// @name Copy and move support + OrganizationSecurityPoliciesClient( + OrganizationSecurityPoliciesClient const&) = default; + OrganizationSecurityPoliciesClient& operator=( + OrganizationSecurityPoliciesClient const&) = default; + OrganizationSecurityPoliciesClient(OrganizationSecurityPoliciesClient&&) = + default; + OrganizationSecurityPoliciesClient& operator=( + OrganizationSecurityPoliciesClient&&) = default; + ///@} + + ///@{ + /// @name Equality + friend bool operator==(OrganizationSecurityPoliciesClient const& a, + OrganizationSecurityPoliciesClient const& b) { + return a.connection_ == b.connection_; + } + friend bool operator!=(OrganizationSecurityPoliciesClient const& a, + OrganizationSecurityPoliciesClient const& b) { + return !(a == b); + } + ///@} + + // clang-format off + /// + /// Inserts an association for the specified security policy. + /// + /// This has billing implications. Projects in the hierarchy with effective + /// hierarchical security policies will be automatically enrolled into Cloud + /// Armor Enterprise if not already enrolled. + /// + /// Use this API to modify Cloud Armor policies. Previously, alpha and beta + /// versions of this API were used to modify firewall policies. This usage is + /// now disabled for most organizations. Use firewallPolicies.addAssociation + /// instead. + /// https://cloud.google.com/compute/docs/reference/rest/v1/organizationSecurityPolicies/addAssociation + /// + /// @param security_policy Name of the security policy to update. + /// @param security_policy_association_resource The SecurityPolicyAssociation for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.organization_security_policies.v1.AddAssociationRequest]: @cloud_cpp_reference_link{google/cloud/compute/organization_security_policies/v1/organization_security_policies.proto#L297} + /// + // clang-format on + future> AddAssociation( + std::string const& security_policy, + google::cloud::cpp::compute::v1::SecurityPolicyAssociation const& + security_policy_association_resource, + Options opts = {}); + + // clang-format off + /// + /// @copybrief AddAssociation + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr AddAssociation( + NoAwaitTag, std::string const& security_policy, + google::cloud::cpp::compute::v1::SecurityPolicyAssociation const& + security_policy_association_resource, + Options opts = {}); + + // clang-format off + /// + /// Inserts an association for the specified security policy. + /// + /// This has billing implications. Projects in the hierarchy with effective + /// hierarchical security policies will be automatically enrolled into Cloud + /// Armor Enterprise if not already enrolled. + /// + /// Use this API to modify Cloud Armor policies. Previously, alpha and beta + /// versions of this API were used to modify firewall policies. This usage is + /// now disabled for most organizations. Use firewallPolicies.addAssociation + /// instead. + /// https://cloud.google.com/compute/docs/reference/rest/v1/organizationSecurityPolicies/addAssociation + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.organization_security_policies.v1.AddAssociationRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.organization_security_policies.v1.AddAssociationRequest]: @cloud_cpp_reference_link{google/cloud/compute/organization_security_policies/v1/organization_security_policies.proto#L297} + /// + // clang-format on + future> AddAssociation( + google::cloud::cpp::compute::organization_security_policies::v1:: + AddAssociationRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief AddAssociation + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr AddAssociation( + NoAwaitTag, + google::cloud::cpp::compute::organization_security_policies::v1:: + AddAssociationRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief AddAssociation + /// + /// This method accepts a `google::cloud::cpp::compute::v1::Operation` that corresponds + /// to a previously started Long Running Operation (LRO) and polls the status + /// of the LRO in the background. + /// + // clang-format on + future> AddAssociation( + google::cloud::cpp::compute::v1::Operation const& operation, + Options opts = {}); + + // clang-format off + /// + /// Inserts a rule into a security policy. + /// + /// Use this API to modify Cloud Armor policies. Previously, alpha and beta + /// versions of this API were used to modify firewall policies. This usage is + /// now disabled for most organizations. Use firewallPolicies.addRule instead. + /// https://cloud.google.com/compute/docs/reference/rest/v1/organizationSecurityPolicies/addRule + /// + /// @param security_policy Name of the security policy to update. + /// @param security_policy_rule_resource The SecurityPolicyRule for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.organization_security_policies.v1.AddRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/organization_security_policies/v1/organization_security_policies.proto#L330} + /// + // clang-format on + future> AddRule( + std::string const& security_policy, + google::cloud::cpp::compute::v1::SecurityPolicyRule const& + security_policy_rule_resource, + Options opts = {}); + + // clang-format off + /// + /// @copybrief AddRule + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr AddRule( + NoAwaitTag, std::string const& security_policy, + google::cloud::cpp::compute::v1::SecurityPolicyRule const& + security_policy_rule_resource, + Options opts = {}); + + // clang-format off + /// + /// Inserts a rule into a security policy. + /// + /// Use this API to modify Cloud Armor policies. Previously, alpha and beta + /// versions of this API were used to modify firewall policies. This usage is + /// now disabled for most organizations. Use firewallPolicies.addRule instead. + /// https://cloud.google.com/compute/docs/reference/rest/v1/organizationSecurityPolicies/addRule + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.organization_security_policies.v1.AddRuleRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.organization_security_policies.v1.AddRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/organization_security_policies/v1/organization_security_policies.proto#L330} + /// + // clang-format on + future> AddRule( + google::cloud::cpp::compute::organization_security_policies::v1:: + AddRuleRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief AddRule + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr AddRule( + NoAwaitTag, + google::cloud::cpp::compute::organization_security_policies::v1:: + AddRuleRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief AddRule + /// + /// This method accepts a `google::cloud::cpp::compute::v1::Operation` that corresponds + /// to a previously started Long Running Operation (LRO) and polls the status + /// of the LRO in the background. + /// + // clang-format on + future> AddRule( + google::cloud::cpp::compute::v1::Operation const& operation, + Options opts = {}); + + // clang-format off + /// + /// Copies rules to the specified security policy. + /// + /// Use this API to modify Cloud Armor policies. Previously, alpha and beta + /// versions of this API were used to modify firewall policies. This usage is + /// now disabled for most organizations. Use firewallPolicies.cloneRules + /// instead. + /// https://cloud.google.com/compute/docs/reference/rest/v1/organizationSecurityPolicies/copyRules + /// + /// @param security_policy Name of the security policy to update. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.organization_security_policies.v1.CopyRulesRequest]: @cloud_cpp_reference_link{google/cloud/compute/organization_security_policies/v1/organization_security_policies.proto#L356} + /// + // clang-format on + future> CopyRules( + std::string const& security_policy, Options opts = {}); + + // clang-format off + /// + /// @copybrief CopyRules + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr CopyRules( + NoAwaitTag, std::string const& security_policy, Options opts = {}); + + // clang-format off + /// + /// Copies rules to the specified security policy. + /// + /// Use this API to modify Cloud Armor policies. Previously, alpha and beta + /// versions of this API were used to modify firewall policies. This usage is + /// now disabled for most organizations. Use firewallPolicies.cloneRules + /// instead. + /// https://cloud.google.com/compute/docs/reference/rest/v1/organizationSecurityPolicies/copyRules + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.organization_security_policies.v1.CopyRulesRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.organization_security_policies.v1.CopyRulesRequest]: @cloud_cpp_reference_link{google/cloud/compute/organization_security_policies/v1/organization_security_policies.proto#L356} + /// + // clang-format on + future> CopyRules( + google::cloud::cpp::compute::organization_security_policies::v1:: + CopyRulesRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief CopyRules + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr CopyRules( + NoAwaitTag, + google::cloud::cpp::compute::organization_security_policies::v1:: + CopyRulesRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief CopyRules + /// + /// This method accepts a `google::cloud::cpp::compute::v1::Operation` that corresponds + /// to a previously started Long Running Operation (LRO) and polls the status + /// of the LRO in the background. + /// + // clang-format on + future> CopyRules( + google::cloud::cpp::compute::v1::Operation const& operation, + Options opts = {}); + + // clang-format off + /// + /// Deletes the specified policy. + /// + /// Use this API to remove Cloud Armor policies. Previously, alpha and beta + /// versions of this API were used to remove firewall policies. This usage is + /// now disabled for most organizations. Use firewallPolicies.delete instead. + /// https://cloud.google.com/compute/docs/reference/rest/v1/organizationSecurityPolicies/delete + /// + /// @param security_policy Name of the security policy to delete. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.organization_security_policies.v1.DeleteSecurityPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/organization_security_policies/v1/organization_security_policies.proto#L382} + /// + // clang-format on + future> + DeleteSecurityPolicy(std::string const& security_policy, Options opts = {}); + + // clang-format off + /// + /// @copybrief DeleteSecurityPolicy + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr DeleteSecurityPolicy( + NoAwaitTag, std::string const& security_policy, Options opts = {}); + + // clang-format off + /// + /// Deletes the specified policy. + /// + /// Use this API to remove Cloud Armor policies. Previously, alpha and beta + /// versions of this API were used to remove firewall policies. This usage is + /// now disabled for most organizations. Use firewallPolicies.delete instead. + /// https://cloud.google.com/compute/docs/reference/rest/v1/organizationSecurityPolicies/delete + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.organization_security_policies.v1.DeleteSecurityPolicyRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.organization_security_policies.v1.DeleteSecurityPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/organization_security_policies/v1/organization_security_policies.proto#L382} + /// + // clang-format on + future> + DeleteSecurityPolicy( + google::cloud::cpp::compute::organization_security_policies::v1:: + DeleteSecurityPolicyRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief DeleteSecurityPolicy + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr DeleteSecurityPolicy( + NoAwaitTag, + google::cloud::cpp::compute::organization_security_policies::v1:: + DeleteSecurityPolicyRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief DeleteSecurityPolicy + /// + /// This method accepts a `google::cloud::cpp::compute::v1::Operation` that corresponds + /// to a previously started Long Running Operation (LRO) and polls the status + /// of the LRO in the background. + /// + // clang-format on + future> + DeleteSecurityPolicy( + google::cloud::cpp::compute::v1::Operation const& operation, + Options opts = {}); + + // clang-format off + /// + /// List all of the ordered rules present in a single specified policy. + /// + /// Use this API to read Cloud Armor policies. Previously, alpha and beta + /// versions of this API were used to read firewall policies. This usage is now + /// disabled for most organizations. Use firewallPolicies.get instead. + /// https://cloud.google.com/compute/docs/reference/rest/v1/organizationSecurityPolicies/get + /// + /// @param security_policy Name of the security policy to get. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.SecurityPolicy]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.organization_security_policies.v1.GetSecurityPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/organization_security_policies/v1/organization_security_policies.proto#L424} + /// [google.cloud.cpp.compute.v1.SecurityPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_141.proto#L31} + /// + // clang-format on + StatusOr GetSecurityPolicy( + std::string const& security_policy, Options opts = {}); + + // clang-format off + /// + /// List all of the ordered rules present in a single specified policy. + /// + /// Use this API to read Cloud Armor policies. Previously, alpha and beta + /// versions of this API were used to read firewall policies. This usage is now + /// disabled for most organizations. Use firewallPolicies.get instead. + /// https://cloud.google.com/compute/docs/reference/rest/v1/organizationSecurityPolicies/get + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.organization_security_policies.v1.GetSecurityPolicyRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.SecurityPolicy]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.organization_security_policies.v1.GetSecurityPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/organization_security_policies/v1/organization_security_policies.proto#L424} + /// [google.cloud.cpp.compute.v1.SecurityPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_141.proto#L31} + /// + // clang-format on + StatusOr GetSecurityPolicy( + google::cloud::cpp::compute::organization_security_policies::v1:: + GetSecurityPolicyRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// Gets an association with the specified name. + /// + /// Use this API to read Cloud Armor policies. Previously, alpha and beta + /// versions of this API were used to read firewall policies. This usage is + /// now disabled for most organizations. Use firewallPolicies.getAssociation + /// instead. + /// https://cloud.google.com/compute/docs/reference/rest/v1/organizationSecurityPolicies/getAssociation + /// + /// @param security_policy Name of the security policy to which the queried rule belongs. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.SecurityPolicyAssociation]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.organization_security_policies.v1.GetAssociationRequest]: @cloud_cpp_reference_link{google/cloud/compute/organization_security_policies/v1/organization_security_policies.proto#L404} + /// [google.cloud.cpp.compute.v1.SecurityPolicyAssociation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_141.proto#L306} + /// + // clang-format on + StatusOr + GetAssociation(std::string const& security_policy, Options opts = {}); + + // clang-format off + /// + /// Gets an association with the specified name. + /// + /// Use this API to read Cloud Armor policies. Previously, alpha and beta + /// versions of this API were used to read firewall policies. This usage is + /// now disabled for most organizations. Use firewallPolicies.getAssociation + /// instead. + /// https://cloud.google.com/compute/docs/reference/rest/v1/organizationSecurityPolicies/getAssociation + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.organization_security_policies.v1.GetAssociationRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.SecurityPolicyAssociation]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.organization_security_policies.v1.GetAssociationRequest]: @cloud_cpp_reference_link{google/cloud/compute/organization_security_policies/v1/organization_security_policies.proto#L404} + /// [google.cloud.cpp.compute.v1.SecurityPolicyAssociation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_141.proto#L306} + /// + // clang-format on + StatusOr + GetAssociation(google::cloud::cpp::compute::organization_security_policies:: + v1::GetAssociationRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// Gets a rule at the specified priority. + /// + /// Use this API to read Cloud Armor policies. Previously, alpha and beta + /// versions of this API were used to read firewall policies. This usage is now + /// disabled for most organizations. Use firewallPolicies.getRule instead. + /// https://cloud.google.com/compute/docs/reference/rest/v1/organizationSecurityPolicies/getRule + /// + /// @param security_policy Name of the security policy to which the queried rule belongs. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.SecurityPolicyRule]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.organization_security_policies.v1.GetRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/organization_security_policies/v1/organization_security_policies.proto#L414} + /// [google.cloud.cpp.compute.v1.SecurityPolicyRule]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_141.proto#L503} + /// + // clang-format on + StatusOr GetRule( + std::string const& security_policy, Options opts = {}); + + // clang-format off + /// + /// Gets a rule at the specified priority. + /// + /// Use this API to read Cloud Armor policies. Previously, alpha and beta + /// versions of this API were used to read firewall policies. This usage is now + /// disabled for most organizations. Use firewallPolicies.getRule instead. + /// https://cloud.google.com/compute/docs/reference/rest/v1/organizationSecurityPolicies/getRule + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.organization_security_policies.v1.GetRuleRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.SecurityPolicyRule]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.organization_security_policies.v1.GetRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/organization_security_policies/v1/organization_security_policies.proto#L414} + /// [google.cloud.cpp.compute.v1.SecurityPolicyRule]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_141.proto#L503} + /// + // clang-format on + StatusOr GetRule( + google::cloud::cpp::compute::organization_security_policies::v1:: + GetRuleRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// Creates a new policy in the specified organization using the data included + /// in the request. + /// + /// Use this API to add Cloud Armor policies. Previously, alpha and beta + /// versions of this API were used to add firewall policies. This usage is now + /// disabled for most organizations. Use firewallPolicies.insert instead. + /// https://cloud.google.com/compute/docs/reference/rest/v1/organizationSecurityPolicies/insert + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.organization_security_policies.v1.InsertSecurityPolicyRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.organization_security_policies.v1.InsertSecurityPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/organization_security_policies/v1/organization_security_policies.proto#L431} + /// + // clang-format on + future> + InsertSecurityPolicy( + google::cloud::cpp::compute::organization_security_policies::v1:: + InsertSecurityPolicyRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief InsertSecurityPolicy + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr InsertSecurityPolicy( + NoAwaitTag, + google::cloud::cpp::compute::organization_security_policies::v1:: + InsertSecurityPolicyRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief InsertSecurityPolicy + /// + /// This method accepts a `google::cloud::cpp::compute::v1::Operation` that corresponds + /// to a previously started Long Running Operation (LRO) and polls the status + /// of the LRO in the background. + /// + // clang-format on + future> + InsertSecurityPolicy( + google::cloud::cpp::compute::v1::Operation const& operation, + Options opts = {}); + + // clang-format off + /// + /// List all the policies that have been configured for the specified + /// organization. + /// + /// Use this API to read Cloud Armor policies. Previously, alpha and beta + /// versions of this API were used to read firewall policies. This usage is now + /// disabled for most organizations. Use firewallPolicies.list instead. + /// https://cloud.google.com/compute/docs/reference/rest/v1/organizationSecurityPolicies/list + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.organization_security_policies.v1.ListOrganizationSecurityPoliciesRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return a [StreamRange](@ref google::cloud::StreamRange) + /// to iterate of the results. See the documentation of this type for + /// details. In brief, this class has `begin()` and `end()` member + /// functions returning a iterator class meeting the + /// [input iterator requirements]. The value type for this iterator is a + /// [`StatusOr`] as the iteration may fail even after some values are + /// retrieved successfully, for example, if there is a network disconnect. + /// An empty set of results does not indicate an error, it indicates + /// that there are no resources meeting the request criteria. + /// On a successful iteration the `StatusOr` contains elements of type + /// [google.cloud.cpp.compute.v1.SecurityPolicy], or rather, + /// the C++ class generated by Protobuf from that type. Please consult the + /// Protobuf documentation for details on the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.organization_security_policies.v1.ListOrganizationSecurityPoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/organization_security_policies/v1/organization_security_policies.proto#L465} + /// [google.cloud.cpp.compute.v1.SecurityPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_141.proto#L31} + /// + // clang-format on + StreamRange + ListOrganizationSecurityPolicies( + google::cloud::cpp::compute::organization_security_policies::v1:: + ListOrganizationSecurityPoliciesRequest request, + Options opts = {}); + + // clang-format off + /// + /// Lists associations of a specified target, i.e., organization or folder. + /// + /// Use this API to read Cloud Armor policies. Previously, alpha and beta + /// versions of this API were used to read firewall policies. This usage is + /// now disabled for most organizations. Use firewallPolicies.listAssociations + /// instead. + /// https://cloud.google.com/compute/docs/reference/rest/v1/organizationSecurityPolicies/listAssociations + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.organization_security_policies.v1.ListAssociationsRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.OrganizationSecurityPoliciesListAssociationsResponse]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.organization_security_policies.v1.ListAssociationsRequest]: @cloud_cpp_reference_link{google/cloud/compute/organization_security_policies/v1/organization_security_policies.proto#L458} + /// [google.cloud.cpp.compute.v1.OrganizationSecurityPoliciesListAssociationsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_108.proto#L26} + /// + // clang-format on + StatusOr + ListAssociations(google::cloud::cpp::compute::organization_security_policies:: + v1::ListAssociationsRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// Gets the current list of preconfigured Web Application Firewall (WAF) + /// expressions. + /// https://cloud.google.com/compute/docs/reference/rest/v1/organizationSecurityPolicies/listPreconfiguredExpressionSets + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.organization_security_policies.v1.ListPreconfiguredExpressionSetsRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.SecurityPoliciesListPreconfiguredExpressionSetsResponse]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.organization_security_policies.v1.ListPreconfiguredExpressionSetsRequest]: @cloud_cpp_reference_link{google/cloud/compute/organization_security_policies/v1/organization_security_policies.proto#L565} + /// [google.cloud.cpp.compute.v1.SecurityPoliciesListPreconfiguredExpressionSetsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_111.proto#L29} + /// + // clang-format on + StatusOr + ListPreconfiguredExpressionSets( + google::cloud::cpp::compute::organization_security_policies::v1:: + ListPreconfiguredExpressionSetsRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// Moves the specified security policy. + /// + /// Use this API to modify Cloud Armor policies. Previously, alpha and beta + /// versions of this API were used to modify firewall policies. This usage is + /// now disabled for most organizations. Use firewallPolicies.move instead. + /// https://cloud.google.com/compute/docs/reference/rest/v1/organizationSecurityPolicies/move + /// + /// @param security_policy Name of the security policy to update. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.organization_security_policies.v1.MoveRequest]: @cloud_cpp_reference_link{google/cloud/compute/organization_security_policies/v1/organization_security_policies.proto#L665} + /// + // clang-format on + future> Move( + std::string const& security_policy, Options opts = {}); + + // clang-format off + /// + /// @copybrief Move + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr Move( + NoAwaitTag, std::string const& security_policy, Options opts = {}); + + // clang-format off + /// + /// Moves the specified security policy. + /// + /// Use this API to modify Cloud Armor policies. Previously, alpha and beta + /// versions of this API were used to modify firewall policies. This usage is + /// now disabled for most organizations. Use firewallPolicies.move instead. + /// https://cloud.google.com/compute/docs/reference/rest/v1/organizationSecurityPolicies/move + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.organization_security_policies.v1.MoveRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.organization_security_policies.v1.MoveRequest]: @cloud_cpp_reference_link{google/cloud/compute/organization_security_policies/v1/organization_security_policies.proto#L665} + /// + // clang-format on + future> Move( + google::cloud::cpp::compute::organization_security_policies::v1:: + MoveRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief Move + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr Move( + NoAwaitTag, + google::cloud::cpp::compute::organization_security_policies::v1:: + MoveRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief Move + /// + /// This method accepts a `google::cloud::cpp::compute::v1::Operation` that corresponds + /// to a previously started Long Running Operation (LRO) and polls the status + /// of the LRO in the background. + /// + // clang-format on + future> Move( + google::cloud::cpp::compute::v1::Operation const& operation, + Options opts = {}); + + // clang-format off + /// + /// Patches the specified policy with the data included in the request. + /// + /// Use this API to modify Cloud Armor policies. Previously, alpha and beta + /// versions of this API were used to modify firewall policies. This usage is + /// now disabled for most organizations. Use firewallPolicies.patch instead. + /// https://cloud.google.com/compute/docs/reference/rest/v1/organizationSecurityPolicies/patch + /// + /// @param security_policy Name of the security policy to update. + /// @param security_policy_resource The SecurityPolicy for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.organization_security_policies.v1.PatchSecurityPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/organization_security_policies/v1/organization_security_policies.proto#L719} + /// + // clang-format on + future> + PatchSecurityPolicy(std::string const& security_policy, + google::cloud::cpp::compute::v1::SecurityPolicy const& + security_policy_resource, + Options opts = {}); + + // clang-format off + /// + /// @copybrief PatchSecurityPolicy + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr PatchSecurityPolicy( + NoAwaitTag, std::string const& security_policy, + google::cloud::cpp::compute::v1::SecurityPolicy const& + security_policy_resource, + Options opts = {}); + + // clang-format off + /// + /// Patches the specified policy with the data included in the request. + /// + /// Use this API to modify Cloud Armor policies. Previously, alpha and beta + /// versions of this API were used to modify firewall policies. This usage is + /// now disabled for most organizations. Use firewallPolicies.patch instead. + /// https://cloud.google.com/compute/docs/reference/rest/v1/organizationSecurityPolicies/patch + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.organization_security_policies.v1.PatchSecurityPolicyRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.organization_security_policies.v1.PatchSecurityPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/organization_security_policies/v1/organization_security_policies.proto#L719} + /// + // clang-format on + future> + PatchSecurityPolicy( + google::cloud::cpp::compute::organization_security_policies::v1:: + PatchSecurityPolicyRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief PatchSecurityPolicy + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr PatchSecurityPolicy( + NoAwaitTag, + google::cloud::cpp::compute::organization_security_policies::v1:: + PatchSecurityPolicyRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief PatchSecurityPolicy + /// + /// This method accepts a `google::cloud::cpp::compute::v1::Operation` that corresponds + /// to a previously started Long Running Operation (LRO) and polls the status + /// of the LRO in the background. + /// + // clang-format on + future> + PatchSecurityPolicy( + google::cloud::cpp::compute::v1::Operation const& operation, + Options opts = {}); + + // clang-format off + /// + /// Patches a rule at the specified priority. + /// + /// Use this API to modify Cloud Armor policies. Previously, alpha and beta + /// versions of this API were used to modify firewall policies. This usage is + /// now disabled for most organizations. Use firewallPolicies.patchRule + /// instead. + /// https://cloud.google.com/compute/docs/reference/rest/v1/organizationSecurityPolicies/patchRule + /// + /// @param security_policy Name of the security policy to update. + /// @param security_policy_rule_resource The SecurityPolicyRule for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.organization_security_policies.v1.PatchRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/organization_security_policies/v1/organization_security_policies.proto#L690} + /// + // clang-format on + future> PatchRule( + std::string const& security_policy, + google::cloud::cpp::compute::v1::SecurityPolicyRule const& + security_policy_rule_resource, + Options opts = {}); + + // clang-format off + /// + /// @copybrief PatchRule + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr PatchRule( + NoAwaitTag, std::string const& security_policy, + google::cloud::cpp::compute::v1::SecurityPolicyRule const& + security_policy_rule_resource, + Options opts = {}); + + // clang-format off + /// + /// Patches a rule at the specified priority. + /// + /// Use this API to modify Cloud Armor policies. Previously, alpha and beta + /// versions of this API were used to modify firewall policies. This usage is + /// now disabled for most organizations. Use firewallPolicies.patchRule + /// instead. + /// https://cloud.google.com/compute/docs/reference/rest/v1/organizationSecurityPolicies/patchRule + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.organization_security_policies.v1.PatchRuleRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.organization_security_policies.v1.PatchRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/organization_security_policies/v1/organization_security_policies.proto#L690} + /// + // clang-format on + future> PatchRule( + google::cloud::cpp::compute::organization_security_policies::v1:: + PatchRuleRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief PatchRule + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr PatchRule( + NoAwaitTag, + google::cloud::cpp::compute::organization_security_policies::v1:: + PatchRuleRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief PatchRule + /// + /// This method accepts a `google::cloud::cpp::compute::v1::Operation` that corresponds + /// to a previously started Long Running Operation (LRO) and polls the status + /// of the LRO in the background. + /// + // clang-format on + future> PatchRule( + google::cloud::cpp::compute::v1::Operation const& operation, + Options opts = {}); + + // clang-format off + /// + /// Removes an association for the specified security policy. + /// + /// Use this API to modify Cloud Armor policies. Previously, alpha and beta + /// versions of this API were used to modify firewall policies. This usage is + /// now disabled for most organizations. Use firewallPolicies.removeAssociation + /// instead. + /// https://cloud.google.com/compute/docs/reference/rest/v1/organizationSecurityPolicies/removeAssociation + /// + /// @param security_policy Name of the security policy to update. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.organization_security_policies.v1.RemoveAssociationRequest]: @cloud_cpp_reference_link{google/cloud/compute/organization_security_policies/v1/organization_security_policies.proto#L745} + /// + // clang-format on + future> + RemoveAssociation(std::string const& security_policy, Options opts = {}); + + // clang-format off + /// + /// @copybrief RemoveAssociation + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr RemoveAssociation( + NoAwaitTag, std::string const& security_policy, Options opts = {}); + + // clang-format off + /// + /// Removes an association for the specified security policy. + /// + /// Use this API to modify Cloud Armor policies. Previously, alpha and beta + /// versions of this API were used to modify firewall policies. This usage is + /// now disabled for most organizations. Use firewallPolicies.removeAssociation + /// instead. + /// https://cloud.google.com/compute/docs/reference/rest/v1/organizationSecurityPolicies/removeAssociation + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.organization_security_policies.v1.RemoveAssociationRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.organization_security_policies.v1.RemoveAssociationRequest]: @cloud_cpp_reference_link{google/cloud/compute/organization_security_policies/v1/organization_security_policies.proto#L745} + /// + // clang-format on + future> + RemoveAssociation( + google::cloud::cpp::compute::organization_security_policies::v1:: + RemoveAssociationRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief RemoveAssociation + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr RemoveAssociation( + NoAwaitTag, + google::cloud::cpp::compute::organization_security_policies::v1:: + RemoveAssociationRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief RemoveAssociation + /// + /// This method accepts a `google::cloud::cpp::compute::v1::Operation` that corresponds + /// to a previously started Long Running Operation (LRO) and polls the status + /// of the LRO in the background. + /// + // clang-format on + future> + RemoveAssociation(google::cloud::cpp::compute::v1::Operation const& operation, + Options opts = {}); + + // clang-format off + /// + /// Deletes a rule at the specified priority. + /// + /// Use this API to modify Cloud Armor policies. Previously, alpha and beta + /// versions of this API were used to modify firewall policies. This usage is + /// now disabled for most organizations. Use firewallPolicies.removeRule + /// instead. + /// https://cloud.google.com/compute/docs/reference/rest/v1/organizationSecurityPolicies/removeRule + /// + /// @param security_policy Name of the security policy to update. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.organization_security_policies.v1.RemoveRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/organization_security_policies/v1/organization_security_policies.proto#L770} + /// + // clang-format on + future> RemoveRule( + std::string const& security_policy, Options opts = {}); + + // clang-format off + /// + /// @copybrief RemoveRule + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr RemoveRule( + NoAwaitTag, std::string const& security_policy, Options opts = {}); + + // clang-format off + /// + /// Deletes a rule at the specified priority. + /// + /// Use this API to modify Cloud Armor policies. Previously, alpha and beta + /// versions of this API were used to modify firewall policies. This usage is + /// now disabled for most organizations. Use firewallPolicies.removeRule + /// instead. + /// https://cloud.google.com/compute/docs/reference/rest/v1/organizationSecurityPolicies/removeRule + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.organization_security_policies.v1.RemoveRuleRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.organization_security_policies.v1.RemoveRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/organization_security_policies/v1/organization_security_policies.proto#L770} + /// + // clang-format on + future> RemoveRule( + google::cloud::cpp::compute::organization_security_policies::v1:: + RemoveRuleRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief RemoveRule + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr RemoveRule( + NoAwaitTag, + google::cloud::cpp::compute::organization_security_policies::v1:: + RemoveRuleRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief RemoveRule + /// + /// This method accepts a `google::cloud::cpp::compute::v1::Operation` that corresponds + /// to a previously started Long Running Operation (LRO) and polls the status + /// of the LRO in the background. + /// + // clang-format on + future> RemoveRule( + google::cloud::cpp::compute::v1::Operation const& operation, + Options opts = {}); + + private: + std::shared_ptr connection_; + Options options_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_organization_security_policies_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ORGANIZATION_SECURITY_POLICIES_V1_ORGANIZATION_SECURITY_POLICIES_CLIENT_H diff --git a/google/cloud/compute/organization_security_policies/v1/organization_security_policies_connection.cc b/google/cloud/compute/organization_security_policies/v1/organization_security_policies_connection.cc new file mode 100644 index 0000000000000..f54589f24a379 --- /dev/null +++ b/google/cloud/compute/organization_security_policies/v1/organization_security_policies_connection.cc @@ -0,0 +1,339 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/organization_security_policies/v1/organization_security_policies.proto + +#include "google/cloud/compute/organization_security_policies/v1/organization_security_policies_connection.h" +#include "google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_option_defaults.h" +#include "google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_tracing_connection.h" +#include "google/cloud/compute/organization_security_policies/v1/organization_security_policies_options.h" +#include "google/cloud/background_threads.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/grpc_options.h" +#include "google/cloud/internal/pagination_range.h" +#include "google/cloud/internal/unified_grpc_credentials.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_organization_security_policies_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +OrganizationSecurityPoliciesConnection:: + ~OrganizationSecurityPoliciesConnection() = default; + +future> +OrganizationSecurityPoliciesConnection::AddAssociation( + google::cloud::cpp::compute::organization_security_policies::v1:: + AddAssociationRequest const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +OrganizationSecurityPoliciesConnection::AddAssociation( + NoAwaitTag, google::cloud::cpp::compute::organization_security_policies:: + v1::AddAssociationRequest const&) { + return StatusOr( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +OrganizationSecurityPoliciesConnection::AddAssociation( + google::cloud::cpp::compute::v1::Operation const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +OrganizationSecurityPoliciesConnection::AddRule( + google::cloud::cpp::compute::organization_security_policies::v1:: + AddRuleRequest const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +OrganizationSecurityPoliciesConnection::AddRule( + NoAwaitTag, google::cloud::cpp::compute::organization_security_policies:: + v1::AddRuleRequest const&) { + return StatusOr( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +OrganizationSecurityPoliciesConnection::AddRule( + google::cloud::cpp::compute::v1::Operation const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +OrganizationSecurityPoliciesConnection::CopyRules( + google::cloud::cpp::compute::organization_security_policies::v1:: + CopyRulesRequest const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +OrganizationSecurityPoliciesConnection::CopyRules( + NoAwaitTag, google::cloud::cpp::compute::organization_security_policies:: + v1::CopyRulesRequest const&) { + return StatusOr( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +OrganizationSecurityPoliciesConnection::CopyRules( + google::cloud::cpp::compute::v1::Operation const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +OrganizationSecurityPoliciesConnection::DeleteSecurityPolicy( + google::cloud::cpp::compute::organization_security_policies::v1:: + DeleteSecurityPolicyRequest const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +OrganizationSecurityPoliciesConnection::DeleteSecurityPolicy( + NoAwaitTag, google::cloud::cpp::compute::organization_security_policies:: + v1::DeleteSecurityPolicyRequest const&) { + return StatusOr( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +OrganizationSecurityPoliciesConnection::DeleteSecurityPolicy( + google::cloud::cpp::compute::v1::Operation const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +OrganizationSecurityPoliciesConnection::GetSecurityPolicy( + google::cloud::cpp::compute::organization_security_policies::v1:: + GetSecurityPolicyRequest const&) { + return Status(StatusCode::kUnimplemented, "not implemented"); +} + +StatusOr +OrganizationSecurityPoliciesConnection::GetAssociation( + google::cloud::cpp::compute::organization_security_policies::v1:: + GetAssociationRequest const&) { + return Status(StatusCode::kUnimplemented, "not implemented"); +} + +StatusOr +OrganizationSecurityPoliciesConnection::GetRule( + google::cloud::cpp::compute::organization_security_policies::v1:: + GetRuleRequest const&) { + return Status(StatusCode::kUnimplemented, "not implemented"); +} + +future> +OrganizationSecurityPoliciesConnection::InsertSecurityPolicy( + google::cloud::cpp::compute::organization_security_policies::v1:: + InsertSecurityPolicyRequest const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +OrganizationSecurityPoliciesConnection::InsertSecurityPolicy( + NoAwaitTag, google::cloud::cpp::compute::organization_security_policies:: + v1::InsertSecurityPolicyRequest const&) { + return StatusOr( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +OrganizationSecurityPoliciesConnection::InsertSecurityPolicy( + google::cloud::cpp::compute::v1::Operation const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StreamRange +OrganizationSecurityPoliciesConnection::ListOrganizationSecurityPolicies( + google::cloud::cpp::compute::organization_security_policies::v1:: + ListOrganizationSecurityPoliciesRequest) { // NOLINT(performance-unnecessary-value-param) + return google::cloud::internal::MakeUnimplementedPaginationRange< + StreamRange>(); +} + +StatusOr +OrganizationSecurityPoliciesConnection::ListAssociations( + google::cloud::cpp::compute::organization_security_policies::v1:: + ListAssociationsRequest const&) { + return Status(StatusCode::kUnimplemented, "not implemented"); +} + +StatusOr +OrganizationSecurityPoliciesConnection::ListPreconfiguredExpressionSets( + google::cloud::cpp::compute::organization_security_policies::v1:: + ListPreconfiguredExpressionSetsRequest const&) { + return Status(StatusCode::kUnimplemented, "not implemented"); +} + +future> +OrganizationSecurityPoliciesConnection::Move( + google::cloud::cpp::compute::organization_security_policies::v1:: + MoveRequest const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +OrganizationSecurityPoliciesConnection::Move( + NoAwaitTag, google::cloud::cpp::compute::organization_security_policies:: + v1::MoveRequest const&) { + return StatusOr( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +OrganizationSecurityPoliciesConnection::Move( + google::cloud::cpp::compute::v1::Operation const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +OrganizationSecurityPoliciesConnection::PatchSecurityPolicy( + google::cloud::cpp::compute::organization_security_policies::v1:: + PatchSecurityPolicyRequest const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +OrganizationSecurityPoliciesConnection::PatchSecurityPolicy( + NoAwaitTag, google::cloud::cpp::compute::organization_security_policies:: + v1::PatchSecurityPolicyRequest const&) { + return StatusOr( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +OrganizationSecurityPoliciesConnection::PatchSecurityPolicy( + google::cloud::cpp::compute::v1::Operation const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +OrganizationSecurityPoliciesConnection::PatchRule( + google::cloud::cpp::compute::organization_security_policies::v1:: + PatchRuleRequest const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +OrganizationSecurityPoliciesConnection::PatchRule( + NoAwaitTag, google::cloud::cpp::compute::organization_security_policies:: + v1::PatchRuleRequest const&) { + return StatusOr( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +OrganizationSecurityPoliciesConnection::PatchRule( + google::cloud::cpp::compute::v1::Operation const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +OrganizationSecurityPoliciesConnection::RemoveAssociation( + google::cloud::cpp::compute::organization_security_policies::v1:: + RemoveAssociationRequest const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +OrganizationSecurityPoliciesConnection::RemoveAssociation( + NoAwaitTag, google::cloud::cpp::compute::organization_security_policies:: + v1::RemoveAssociationRequest const&) { + return StatusOr( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +OrganizationSecurityPoliciesConnection::RemoveAssociation( + google::cloud::cpp::compute::v1::Operation const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +OrganizationSecurityPoliciesConnection::RemoveRule( + google::cloud::cpp::compute::organization_security_policies::v1:: + RemoveRuleRequest const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +OrganizationSecurityPoliciesConnection::RemoveRule( + NoAwaitTag, google::cloud::cpp::compute::organization_security_policies:: + v1::RemoveRuleRequest const&) { + return StatusOr( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +OrganizationSecurityPoliciesConnection::RemoveRule( + google::cloud::cpp::compute::v1::Operation const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_organization_security_policies_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/organization_security_policies/v1/organization_security_policies_connection.h b/google/cloud/compute/organization_security_policies/v1/organization_security_policies_connection.h new file mode 100644 index 0000000000000..f24fdad403666 --- /dev/null +++ b/google/cloud/compute/organization_security_policies/v1/organization_security_policies_connection.h @@ -0,0 +1,365 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/organization_security_policies/v1/organization_security_policies.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ORGANIZATION_SECURITY_POLICIES_V1_ORGANIZATION_SECURITY_POLICIES_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ORGANIZATION_SECURITY_POLICIES_V1_ORGANIZATION_SECURITY_POLICIES_CONNECTION_H + +#include "google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_retry_traits.h" +#include "google/cloud/compute/organization_security_policies/v1/organization_security_policies.pb.h" +#include "google/cloud/compute/organization_security_policies/v1/organization_security_policies_connection_idempotency_policy.h" +#include "google/cloud/backoff_policy.h" +#include "google/cloud/future.h" +#include "google/cloud/internal/retry_policy_impl.h" +#include "google/cloud/no_await_tag.h" +#include "google/cloud/options.h" +#include "google/cloud/polling_policy.h" +#include "google/cloud/status_or.h" +#include "google/cloud/stream_range.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_organization_security_policies_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/// The retry policy for `OrganizationSecurityPoliciesConnection`. +class OrganizationSecurityPoliciesRetryPolicy + : public ::google::cloud::RetryPolicy { + public: + /// Creates a new instance of the policy, reset to the initial state. + virtual std::unique_ptr clone() + const = 0; +}; + +/** + * A retry policy for `OrganizationSecurityPoliciesConnection` based on counting + * errors. + * + * This policy stops retrying if: + * - An RPC returns a non-transient error. + * - More than a prescribed number of transient failures is detected. + * + * In this class the following status codes are treated as transient errors: + * - [`kUnavailable`](@ref google::cloud::StatusCode) + */ +class OrganizationSecurityPoliciesLimitedErrorCountRetryPolicy + : public OrganizationSecurityPoliciesRetryPolicy { + public: + /** + * Create an instance that tolerates up to @p maximum_failures transient + * errors. + * + * @note Disable the retry loop by providing an instance of this policy with + * @p maximum_failures == 0. + */ + explicit OrganizationSecurityPoliciesLimitedErrorCountRetryPolicy( + int maximum_failures) + : impl_(maximum_failures) {} + + OrganizationSecurityPoliciesLimitedErrorCountRetryPolicy( + OrganizationSecurityPoliciesLimitedErrorCountRetryPolicy&& rhs) noexcept + : OrganizationSecurityPoliciesLimitedErrorCountRetryPolicy( + rhs.maximum_failures()) {} + OrganizationSecurityPoliciesLimitedErrorCountRetryPolicy( + OrganizationSecurityPoliciesLimitedErrorCountRetryPolicy const& + rhs) noexcept + : OrganizationSecurityPoliciesLimitedErrorCountRetryPolicy( + rhs.maximum_failures()) {} + + int maximum_failures() const { return impl_.maximum_failures(); } + + bool OnFailure(Status const& status) override { + return impl_.OnFailure(status); + } + bool IsExhausted() const override { return impl_.IsExhausted(); } + bool IsPermanentFailure(Status const& status) const override { + return impl_.IsPermanentFailure(status); + } + std::unique_ptr clone() + const override { + return std::make_unique< + OrganizationSecurityPoliciesLimitedErrorCountRetryPolicy>( + maximum_failures()); + } + + // This is provided only for backwards compatibility. + using BaseType = OrganizationSecurityPoliciesRetryPolicy; + + private: + google::cloud::internal::LimitedErrorCountRetryPolicy< + compute_organization_security_policies_v1_internal:: + OrganizationSecurityPoliciesRetryTraits> + impl_; +}; + +/** + * A retry policy for `OrganizationSecurityPoliciesConnection` based on elapsed + * time. + * + * This policy stops retrying if: + * - An RPC returns a non-transient error. + * - The elapsed time in the retry loop exceeds a prescribed duration. + * + * In this class the following status codes are treated as transient errors: + * - [`kUnavailable`](@ref google::cloud::StatusCode) + */ +class OrganizationSecurityPoliciesLimitedTimeRetryPolicy + : public OrganizationSecurityPoliciesRetryPolicy { + public: + /** + * Constructor given a `std::chrono::duration<>` object. + * + * @tparam DurationRep a placeholder to match the `Rep` tparam for @p + * duration's type. The semantics of this template parameter are + * documented in `std::chrono::duration<>`. In brief, the underlying + * arithmetic type used to store the number of ticks. For our purposes it + * is simply a formal parameter. + * @tparam DurationPeriod a placeholder to match the `Period` tparam for @p + * duration's type. The semantics of this template parameter are + * documented in `std::chrono::duration<>`. In brief, the length of the + * tick in seconds, expressed as a `std::ratio<>`. For our purposes it is + * simply a formal parameter. + * @param maximum_duration the maximum time allowed before the policy expires. + * While the application can express this time in any units they desire, + * the class truncates to milliseconds. + * + * @see https://en.cppreference.com/w/cpp/chrono/duration for more information + * about `std::chrono::duration`. + */ + template + explicit OrganizationSecurityPoliciesLimitedTimeRetryPolicy( + std::chrono::duration maximum_duration) + : impl_(maximum_duration) {} + + OrganizationSecurityPoliciesLimitedTimeRetryPolicy( + OrganizationSecurityPoliciesLimitedTimeRetryPolicy&& rhs) noexcept + : OrganizationSecurityPoliciesLimitedTimeRetryPolicy( + rhs.maximum_duration()) {} + OrganizationSecurityPoliciesLimitedTimeRetryPolicy( + OrganizationSecurityPoliciesLimitedTimeRetryPolicy const& rhs) noexcept + : OrganizationSecurityPoliciesLimitedTimeRetryPolicy( + rhs.maximum_duration()) {} + + std::chrono::milliseconds maximum_duration() const { + return impl_.maximum_duration(); + } + + bool OnFailure(Status const& status) override { + return impl_.OnFailure(status); + } + bool IsExhausted() const override { return impl_.IsExhausted(); } + bool IsPermanentFailure(Status const& status) const override { + return impl_.IsPermanentFailure(status); + } + std::unique_ptr clone() + const override { + return std::make_unique( + maximum_duration()); + } + + // This is provided only for backwards compatibility. + using BaseType = OrganizationSecurityPoliciesRetryPolicy; + + private: + google::cloud::internal::LimitedTimeRetryPolicy< + compute_organization_security_policies_v1_internal:: + OrganizationSecurityPoliciesRetryTraits> + impl_; +}; + +/** + * The `OrganizationSecurityPoliciesConnection` object for + * `OrganizationSecurityPoliciesClient`. + * + * This interface defines virtual methods for each of the user-facing overload + * sets in `OrganizationSecurityPoliciesClient`. This allows users to inject + * custom behavior (e.g., with a Google Mock object) when writing tests that use + * objects of type `OrganizationSecurityPoliciesClient`. + * + * To create a concrete instance, see + * `MakeOrganizationSecurityPoliciesConnection()`. + * + * For mocking, see + * `compute_organization_security_policies_v1_mocks::MockOrganizationSecurityPoliciesConnection`. + */ +class OrganizationSecurityPoliciesConnection { + public: + virtual ~OrganizationSecurityPoliciesConnection() = 0; + + virtual Options options() { return Options{}; } + + virtual future> + AddAssociation(google::cloud::cpp::compute::organization_security_policies:: + v1::AddAssociationRequest const& request); + + virtual StatusOr AddAssociation( + NoAwaitTag, google::cloud::cpp::compute::organization_security_policies:: + v1::AddAssociationRequest const& request); + + virtual future> + AddAssociation(google::cloud::cpp::compute::v1::Operation const& operation); + + virtual future> AddRule( + google::cloud::cpp::compute::organization_security_policies::v1:: + AddRuleRequest const& request); + + virtual StatusOr AddRule( + NoAwaitTag, google::cloud::cpp::compute::organization_security_policies:: + v1::AddRuleRequest const& request); + + virtual future> AddRule( + google::cloud::cpp::compute::v1::Operation const& operation); + + virtual future> + CopyRules(google::cloud::cpp::compute::organization_security_policies::v1:: + CopyRulesRequest const& request); + + virtual StatusOr CopyRules( + NoAwaitTag, google::cloud::cpp::compute::organization_security_policies:: + v1::CopyRulesRequest const& request); + + virtual future> + CopyRules(google::cloud::cpp::compute::v1::Operation const& operation); + + virtual future> + DeleteSecurityPolicy( + google::cloud::cpp::compute::organization_security_policies::v1:: + DeleteSecurityPolicyRequest const& request); + + virtual StatusOr + DeleteSecurityPolicy( + NoAwaitTag, google::cloud::cpp::compute::organization_security_policies:: + v1::DeleteSecurityPolicyRequest const& request); + + virtual future> + DeleteSecurityPolicy( + google::cloud::cpp::compute::v1::Operation const& operation); + + virtual StatusOr + GetSecurityPolicy( + google::cloud::cpp::compute::organization_security_policies::v1:: + GetSecurityPolicyRequest const& request); + + virtual StatusOr + GetAssociation(google::cloud::cpp::compute::organization_security_policies:: + v1::GetAssociationRequest const& request); + + virtual StatusOr GetRule( + google::cloud::cpp::compute::organization_security_policies::v1:: + GetRuleRequest const& request); + + virtual future> + InsertSecurityPolicy( + google::cloud::cpp::compute::organization_security_policies::v1:: + InsertSecurityPolicyRequest const& request); + + virtual StatusOr + InsertSecurityPolicy( + NoAwaitTag, google::cloud::cpp::compute::organization_security_policies:: + v1::InsertSecurityPolicyRequest const& request); + + virtual future> + InsertSecurityPolicy( + google::cloud::cpp::compute::v1::Operation const& operation); + + virtual StreamRange + ListOrganizationSecurityPolicies( + google::cloud::cpp::compute::organization_security_policies::v1:: + ListOrganizationSecurityPoliciesRequest request); + + virtual StatusOr + ListAssociations(google::cloud::cpp::compute::organization_security_policies:: + v1::ListAssociationsRequest const& request); + + virtual StatusOr + ListPreconfiguredExpressionSets( + google::cloud::cpp::compute::organization_security_policies::v1:: + ListPreconfiguredExpressionSetsRequest const& request); + + virtual future> Move( + google::cloud::cpp::compute::organization_security_policies::v1:: + MoveRequest const& request); + + virtual StatusOr Move( + NoAwaitTag, google::cloud::cpp::compute::organization_security_policies:: + v1::MoveRequest const& request); + + virtual future> Move( + google::cloud::cpp::compute::v1::Operation const& operation); + + virtual future> + PatchSecurityPolicy( + google::cloud::cpp::compute::organization_security_policies::v1:: + PatchSecurityPolicyRequest const& request); + + virtual StatusOr + PatchSecurityPolicy( + NoAwaitTag, google::cloud::cpp::compute::organization_security_policies:: + v1::PatchSecurityPolicyRequest const& request); + + virtual future> + PatchSecurityPolicy( + google::cloud::cpp::compute::v1::Operation const& operation); + + virtual future> + PatchRule(google::cloud::cpp::compute::organization_security_policies::v1:: + PatchRuleRequest const& request); + + virtual StatusOr PatchRule( + NoAwaitTag, google::cloud::cpp::compute::organization_security_policies:: + v1::PatchRuleRequest const& request); + + virtual future> + PatchRule(google::cloud::cpp::compute::v1::Operation const& operation); + + virtual future> + RemoveAssociation( + google::cloud::cpp::compute::organization_security_policies::v1:: + RemoveAssociationRequest const& request); + + virtual StatusOr + RemoveAssociation( + NoAwaitTag, google::cloud::cpp::compute::organization_security_policies:: + v1::RemoveAssociationRequest const& request); + + virtual future> + RemoveAssociation( + google::cloud::cpp::compute::v1::Operation const& operation); + + virtual future> + RemoveRule(google::cloud::cpp::compute::organization_security_policies::v1:: + RemoveRuleRequest const& request); + + virtual StatusOr RemoveRule( + NoAwaitTag, google::cloud::cpp::compute::organization_security_policies:: + v1::RemoveRuleRequest const& request); + + virtual future> + RemoveRule(google::cloud::cpp::compute::v1::Operation const& operation); +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_organization_security_policies_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ORGANIZATION_SECURITY_POLICIES_V1_ORGANIZATION_SECURITY_POLICIES_CONNECTION_H diff --git a/google/cloud/compute/organization_security_policies/v1/organization_security_policies_connection_idempotency_policy.cc b/google/cloud/compute/organization_security_policies/v1/organization_security_policies_connection_idempotency_policy.cc new file mode 100644 index 0000000000000..24f67b7016f04 --- /dev/null +++ b/google/cloud/compute/organization_security_policies/v1/organization_security_policies_connection_idempotency_policy.cc @@ -0,0 +1,154 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/organization_security_policies/v1/organization_security_policies.proto + +#include "google/cloud/compute/organization_security_policies/v1/organization_security_policies_connection_idempotency_policy.h" +#include + +namespace google { +namespace cloud { +namespace compute_organization_security_policies_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +using ::google::cloud::Idempotency; + +OrganizationSecurityPoliciesConnectionIdempotencyPolicy:: + ~OrganizationSecurityPoliciesConnectionIdempotencyPolicy() = default; + +std::unique_ptr +OrganizationSecurityPoliciesConnectionIdempotencyPolicy::clone() const { + return std::make_unique< + OrganizationSecurityPoliciesConnectionIdempotencyPolicy>(*this); +} + +Idempotency +OrganizationSecurityPoliciesConnectionIdempotencyPolicy::AddAssociation( + google::cloud::cpp::compute::organization_security_policies::v1:: + AddAssociationRequest const&) { + return Idempotency::kNonIdempotent; +} + +Idempotency OrganizationSecurityPoliciesConnectionIdempotencyPolicy::AddRule( + google::cloud::cpp::compute::organization_security_policies::v1:: + AddRuleRequest const&) { + return Idempotency::kNonIdempotent; +} + +Idempotency OrganizationSecurityPoliciesConnectionIdempotencyPolicy::CopyRules( + google::cloud::cpp::compute::organization_security_policies::v1:: + CopyRulesRequest const&) { + return Idempotency::kNonIdempotent; +} + +Idempotency +OrganizationSecurityPoliciesConnectionIdempotencyPolicy::DeleteSecurityPolicy( + google::cloud::cpp::compute::organization_security_policies::v1:: + DeleteSecurityPolicyRequest const&) { + return Idempotency::kNonIdempotent; +} + +Idempotency +OrganizationSecurityPoliciesConnectionIdempotencyPolicy::GetSecurityPolicy( + google::cloud::cpp::compute::organization_security_policies::v1:: + GetSecurityPolicyRequest const&) { + return Idempotency::kIdempotent; +} + +Idempotency +OrganizationSecurityPoliciesConnectionIdempotencyPolicy::GetAssociation( + google::cloud::cpp::compute::organization_security_policies::v1:: + GetAssociationRequest const&) { + return Idempotency::kIdempotent; +} + +Idempotency OrganizationSecurityPoliciesConnectionIdempotencyPolicy::GetRule( + google::cloud::cpp::compute::organization_security_policies::v1:: + GetRuleRequest const&) { + return Idempotency::kIdempotent; +} + +Idempotency +OrganizationSecurityPoliciesConnectionIdempotencyPolicy::InsertSecurityPolicy( + google::cloud::cpp::compute::organization_security_policies::v1:: + InsertSecurityPolicyRequest const&) { + return Idempotency::kNonIdempotent; +} + +Idempotency OrganizationSecurityPoliciesConnectionIdempotencyPolicy:: + ListOrganizationSecurityPolicies( + google::cloud::cpp::compute::organization_security_policies::v1:: + ListOrganizationSecurityPoliciesRequest) { // NOLINT + return Idempotency::kIdempotent; +} + +Idempotency +OrganizationSecurityPoliciesConnectionIdempotencyPolicy::ListAssociations( + google::cloud::cpp::compute::organization_security_policies::v1:: + ListAssociationsRequest const&) { + return Idempotency::kIdempotent; +} + +Idempotency OrganizationSecurityPoliciesConnectionIdempotencyPolicy:: + ListPreconfiguredExpressionSets( + google::cloud::cpp::compute::organization_security_policies::v1:: + ListPreconfiguredExpressionSetsRequest const&) { + return Idempotency::kIdempotent; +} + +Idempotency OrganizationSecurityPoliciesConnectionIdempotencyPolicy::Move( + google::cloud::cpp::compute::organization_security_policies::v1:: + MoveRequest const&) { + return Idempotency::kNonIdempotent; +} + +Idempotency +OrganizationSecurityPoliciesConnectionIdempotencyPolicy::PatchSecurityPolicy( + google::cloud::cpp::compute::organization_security_policies::v1:: + PatchSecurityPolicyRequest const&) { + return Idempotency::kNonIdempotent; +} + +Idempotency OrganizationSecurityPoliciesConnectionIdempotencyPolicy::PatchRule( + google::cloud::cpp::compute::organization_security_policies::v1:: + PatchRuleRequest const&) { + return Idempotency::kNonIdempotent; +} + +Idempotency +OrganizationSecurityPoliciesConnectionIdempotencyPolicy::RemoveAssociation( + google::cloud::cpp::compute::organization_security_policies::v1:: + RemoveAssociationRequest const&) { + return Idempotency::kNonIdempotent; +} + +Idempotency OrganizationSecurityPoliciesConnectionIdempotencyPolicy::RemoveRule( + google::cloud::cpp::compute::organization_security_policies::v1:: + RemoveRuleRequest const&) { + return Idempotency::kNonIdempotent; +} + +std::unique_ptr +MakeDefaultOrganizationSecurityPoliciesConnectionIdempotencyPolicy() { + return std::make_unique< + OrganizationSecurityPoliciesConnectionIdempotencyPolicy>(); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_organization_security_policies_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/organization_security_policies/v1/organization_security_policies_connection_idempotency_policy.h b/google/cloud/compute/organization_security_policies/v1/organization_security_policies_connection_idempotency_policy.h new file mode 100644 index 0000000000000..a0093b06acda9 --- /dev/null +++ b/google/cloud/compute/organization_security_policies/v1/organization_security_policies_connection_idempotency_policy.h @@ -0,0 +1,115 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/organization_security_policies/v1/organization_security_policies.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ORGANIZATION_SECURITY_POLICIES_V1_ORGANIZATION_SECURITY_POLICIES_CONNECTION_IDEMPOTENCY_POLICY_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ORGANIZATION_SECURITY_POLICIES_V1_ORGANIZATION_SECURITY_POLICIES_CONNECTION_IDEMPOTENCY_POLICY_H + +#include "google/cloud/compute/organization_security_policies/v1/organization_security_policies.pb.h" +#include "google/cloud/idempotency.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_organization_security_policies_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class OrganizationSecurityPoliciesConnectionIdempotencyPolicy { + public: + virtual ~OrganizationSecurityPoliciesConnectionIdempotencyPolicy(); + + /// Create a new copy of this object. + virtual std::unique_ptr< + OrganizationSecurityPoliciesConnectionIdempotencyPolicy> + clone() const; + + virtual google::cloud::Idempotency AddAssociation( + google::cloud::cpp::compute::organization_security_policies::v1:: + AddAssociationRequest const& request); + + virtual google::cloud::Idempotency AddRule( + google::cloud::cpp::compute::organization_security_policies::v1:: + AddRuleRequest const& request); + + virtual google::cloud::Idempotency CopyRules( + google::cloud::cpp::compute::organization_security_policies::v1:: + CopyRulesRequest const& request); + + virtual google::cloud::Idempotency DeleteSecurityPolicy( + google::cloud::cpp::compute::organization_security_policies::v1:: + DeleteSecurityPolicyRequest const& request); + + virtual google::cloud::Idempotency GetSecurityPolicy( + google::cloud::cpp::compute::organization_security_policies::v1:: + GetSecurityPolicyRequest const& request); + + virtual google::cloud::Idempotency GetAssociation( + google::cloud::cpp::compute::organization_security_policies::v1:: + GetAssociationRequest const& request); + + virtual google::cloud::Idempotency GetRule( + google::cloud::cpp::compute::organization_security_policies::v1:: + GetRuleRequest const& request); + + virtual google::cloud::Idempotency InsertSecurityPolicy( + google::cloud::cpp::compute::organization_security_policies::v1:: + InsertSecurityPolicyRequest const& request); + + virtual google::cloud::Idempotency ListOrganizationSecurityPolicies( + google::cloud::cpp::compute::organization_security_policies::v1:: + ListOrganizationSecurityPoliciesRequest request); + + virtual google::cloud::Idempotency ListAssociations( + google::cloud::cpp::compute::organization_security_policies::v1:: + ListAssociationsRequest const& request); + + virtual google::cloud::Idempotency ListPreconfiguredExpressionSets( + google::cloud::cpp::compute::organization_security_policies::v1:: + ListPreconfiguredExpressionSetsRequest const& request); + + virtual google::cloud::Idempotency Move( + google::cloud::cpp::compute::organization_security_policies::v1:: + MoveRequest const& request); + + virtual google::cloud::Idempotency PatchSecurityPolicy( + google::cloud::cpp::compute::organization_security_policies::v1:: + PatchSecurityPolicyRequest const& request); + + virtual google::cloud::Idempotency PatchRule( + google::cloud::cpp::compute::organization_security_policies::v1:: + PatchRuleRequest const& request); + + virtual google::cloud::Idempotency RemoveAssociation( + google::cloud::cpp::compute::organization_security_policies::v1:: + RemoveAssociationRequest const& request); + + virtual google::cloud::Idempotency RemoveRule( + google::cloud::cpp::compute::organization_security_policies::v1:: + RemoveRuleRequest const& request); +}; + +std::unique_ptr +MakeDefaultOrganizationSecurityPoliciesConnectionIdempotencyPolicy(); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_organization_security_policies_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ORGANIZATION_SECURITY_POLICIES_V1_ORGANIZATION_SECURITY_POLICIES_CONNECTION_IDEMPOTENCY_POLICY_H diff --git a/google/cloud/compute/organization_security_policies/v1/organization_security_policies_options.h b/google/cloud/compute/organization_security_policies/v1/organization_security_policies_options.h new file mode 100644 index 0000000000000..d17ba307445a1 --- /dev/null +++ b/google/cloud/compute/organization_security_policies/v1/organization_security_policies_options.h @@ -0,0 +1,89 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/organization_security_policies/v1/organization_security_policies.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ORGANIZATION_SECURITY_POLICIES_V1_ORGANIZATION_SECURITY_POLICIES_OPTIONS_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ORGANIZATION_SECURITY_POLICIES_V1_ORGANIZATION_SECURITY_POLICIES_OPTIONS_H + +#include "google/cloud/compute/organization_security_policies/v1/organization_security_policies_connection.h" +#include "google/cloud/compute/organization_security_policies/v1/organization_security_policies_connection_idempotency_policy.h" +#include "google/cloud/backoff_policy.h" +#include "google/cloud/options.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_organization_security_policies_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/** + * Use with `google::cloud::Options` to configure the retry policy. + * + * @ingroup google-cloud-compute-options + */ +struct OrganizationSecurityPoliciesRetryPolicyOption { + using Type = std::shared_ptr; +}; + +/** + * Use with `google::cloud::Options` to configure the backoff policy. + * + * @ingroup google-cloud-compute-options + */ +struct OrganizationSecurityPoliciesBackoffPolicyOption { + using Type = std::shared_ptr; +}; + +/** + * Use with `google::cloud::Options` to configure which operations are retried. + * + * @ingroup google-cloud-compute-options + */ +struct OrganizationSecurityPoliciesConnectionIdempotencyPolicyOption { + using Type = + std::shared_ptr; +}; + +/** + * Use with `google::cloud::Options` to configure the long-running operations + * polling policy. + * + * @ingroup google-cloud-compute-options + */ +struct OrganizationSecurityPoliciesPollingPolicyOption { + using Type = std::shared_ptr; +}; + +/** + * The options applicable to OrganizationSecurityPolicies. + * + * @ingroup google-cloud-compute-options + */ +using OrganizationSecurityPoliciesPolicyOptionList = + OptionList; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_organization_security_policies_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ORGANIZATION_SECURITY_POLICIES_V1_ORGANIZATION_SECURITY_POLICIES_OPTIONS_H diff --git a/google/cloud/compute/organization_security_policies/v1/organization_security_policies_proto_export.h b/google/cloud/compute/organization_security_policies/v1/organization_security_policies_proto_export.h new file mode 100644 index 0000000000000..9aaa9d6d04cff --- /dev/null +++ b/google/cloud/compute/organization_security_policies/v1/organization_security_policies_proto_export.h @@ -0,0 +1,36 @@ +// Copyright 2026 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_ORGANIZATION_SECURITY_POLICIES_V1_ORGANIZATION_SECURITY_POLICIES_PROTO_EXPORT_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ORGANIZATION_SECURITY_POLICIES_V1_ORGANIZATION_SECURITY_POLICIES_PROTO_EXPORT_H + +// IWYU pragma: begin_exports +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_040.pb.h" +#include "google/cloud/compute/v1/internal/common_108.pb.h" +#include "google/cloud/compute/v1/internal/common_111.pb.h" +#include "google/cloud/compute/v1/internal/common_141.pb.h" +// IWYU pragma: end_exports + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ORGANIZATION_SECURITY_POLICIES_V1_ORGANIZATION_SECURITY_POLICIES_PROTO_EXPORT_H diff --git a/google/cloud/compute/organization_security_policies/v1/organization_security_policies_rest_connection.cc b/google/cloud/compute/organization_security_policies/v1/organization_security_policies_rest_connection.cc new file mode 100644 index 0000000000000..74c710caac05e --- /dev/null +++ b/google/cloud/compute/organization_security_policies/v1/organization_security_policies_rest_connection.cc @@ -0,0 +1,61 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/organization_security_policies/v1/organization_security_policies.proto + +#include "google/cloud/compute/organization_security_policies/v1/organization_security_policies_rest_connection.h" +#include "google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_option_defaults.h" +#include "google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_rest_connection_impl.h" +#include "google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_rest_stub_factory.h" +#include "google/cloud/compute/organization_security_policies/v1/internal/organization_security_policies_tracing_connection.h" +#include "google/cloud/compute/organization_security_policies/v1/organization_security_policies_options.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/internal/rest_background_threads_impl.h" +#include "google/cloud/internal/rest_options.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_organization_security_policies_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +std::shared_ptr +MakeOrganizationSecurityPoliciesConnectionRest(Options options) { + internal::CheckExpectedOptions( + options, __func__); + options = compute_organization_security_policies_v1_internal:: + OrganizationSecurityPoliciesDefaultOptions(std::move(options)); + auto background = std::make_unique< + rest_internal::AutomaticallyCreatedRestBackgroundThreads>(); + auto stub = compute_organization_security_policies_v1_internal:: + CreateDefaultOrganizationSecurityPoliciesRestStub(options); + return compute_organization_security_policies_v1_internal:: + MakeOrganizationSecurityPoliciesTracingConnection( + std::make_shared( + std::move(background), std::move(stub), std::move(options))); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_organization_security_policies_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/organization_security_policies/v1/organization_security_policies_rest_connection.h b/google/cloud/compute/organization_security_policies/v1/organization_security_policies_rest_connection.h new file mode 100644 index 0000000000000..1ce7d72625bde --- /dev/null +++ b/google/cloud/compute/organization_security_policies/v1/organization_security_policies_rest_connection.h @@ -0,0 +1,68 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/organization_security_policies/v1/organization_security_policies.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ORGANIZATION_SECURITY_POLICIES_V1_ORGANIZATION_SECURITY_POLICIES_REST_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ORGANIZATION_SECURITY_POLICIES_V1_ORGANIZATION_SECURITY_POLICIES_REST_CONNECTION_H + +#include "google/cloud/compute/organization_security_policies/v1/organization_security_policies_connection.h" +#include "google/cloud/options.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_organization_security_policies_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/** + * A factory function to construct an object of type + * `OrganizationSecurityPoliciesConnection` that uses REST over HTTP as + * transport in lieu of gRPC. REST transport should only be used for services + * that do not support gRPC or if the existing network configuration precludes + * using gRPC. + * + * The returned connection object should not be used directly; instead it + * should be passed as an argument to the constructor of + * OrganizationSecurityPoliciesClient. + * + * The optional @p options argument may be used to configure aspects of the + * returned `OrganizationSecurityPoliciesConnection`. Expected options are any + * of the types in the following option lists: + * + * - `google::cloud::CommonOptionList` + * - `google::cloud::RestOptionList` + * - `google::cloud::UnifiedCredentialsOptionList` + * - + * `google::cloud::compute_organization_security_policies_v1::OrganizationSecurityPoliciesPolicyOptionList` + * + * @note Unexpected options will be ignored. To log unexpected options instead, + * set `GOOGLE_CLOUD_CPP_ENABLE_CLOG=yes` in the environment. + * + * @param options (optional) Configure the + * `OrganizationSecurityPoliciesConnection` created by this function. + */ +std::shared_ptr +MakeOrganizationSecurityPoliciesConnectionRest(Options options = {}); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_organization_security_policies_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ORGANIZATION_SECURITY_POLICIES_V1_ORGANIZATION_SECURITY_POLICIES_REST_CONNECTION_H diff --git a/google/cloud/compute/organization_security_policies/v1/samples/organization_security_policies_client_samples.cc b/google/cloud/compute/organization_security_policies/v1/samples/organization_security_policies_client_samples.cc new file mode 100644 index 0000000000000..8ad8471dd25d6 --- /dev/null +++ b/google/cloud/compute/organization_security_policies/v1/samples/organization_security_policies_client_samples.cc @@ -0,0 +1,245 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/organization_security_policies/v1/organization_security_policies.proto + +#include "google/cloud/compute/organization_security_policies/v1/organization_security_policies_client.h" +#include "google/cloud/compute/organization_security_policies/v1/organization_security_policies_connection_idempotency_policy.h" +#include "google/cloud/compute/organization_security_policies/v1/organization_security_policies_options.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/internal/getenv.h" +#include "google/cloud/polling_policy.h" +#include "google/cloud/testing_util/example_driver.h" +#include "google/cloud/universe_domain.h" +#include +#include +#include +#include + +// clang-format off +// main-dox-marker: compute_organization_security_policies_v1::OrganizationSecurityPoliciesClient +// lro-marker: true +// clang-format on +namespace { + +void SetClientEndpoint(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-endpoint"}; + } + //! [set-client-endpoint] + // This configuration is common with Private Google Access: + // https://cloud.google.com/vpc/docs/private-google-access + auto options = google::cloud::Options{}.set( + "private.googleapis.com"); + auto vpc_client = google::cloud::compute_organization_security_policies_v1:: + OrganizationSecurityPoliciesClient( + google::cloud::compute_organization_security_policies_v1:: + MakeOrganizationSecurityPoliciesConnectionRest(options)); + //! [set-client-endpoint] +} + +void SetClientUniverseDomain(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-universe-domain"}; + } + //! [set-client-universe-domain] + google::cloud::Options options; + + // AddUniverseDomainOption interrogates the UnifiedCredentialsOption, if set, + // in the provided Options for the Universe Domain associated with the + // credentials and adds it to the set of Options. + // If no UnifiedCredentialsOption is set, GoogleDefaultCredentials are used. + auto ud_options = google::cloud::AddUniverseDomainOption(std::move(options)); + + if (!ud_options.ok()) throw std::move(ud_options).status(); + auto ud_client = google::cloud::compute_organization_security_policies_v1:: + OrganizationSecurityPoliciesClient( + google::cloud::compute_organization_security_policies_v1:: + MakeOrganizationSecurityPoliciesConnectionRest(*ud_options)); + //! [set-client-universe-domain] +} + +//! [custom-idempotency-policy] +class CustomIdempotencyPolicy + : public google::cloud::compute_organization_security_policies_v1:: + OrganizationSecurityPoliciesConnectionIdempotencyPolicy { + public: + ~CustomIdempotencyPolicy() override = default; + std::unique_ptr + clone() const override { + return std::make_unique(*this); + } + // Override inherited functions to define as needed. +}; +//! [custom-idempotency-policy] + +void SetRetryPolicy(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-retry-policy"}; + } + //! [set-retry-policy] + auto options = + google::cloud::Options{} + .set< + google::cloud::compute_organization_security_policies_v1:: + OrganizationSecurityPoliciesConnectionIdempotencyPolicyOption>( + CustomIdempotencyPolicy().clone()) + .set( + google::cloud::compute_organization_security_policies_v1:: + OrganizationSecurityPoliciesLimitedErrorCountRetryPolicy(3) + .clone()) + .set( + google::cloud::ExponentialBackoffPolicy( + /*initial_delay=*/std::chrono::milliseconds(200), + /*maximum_delay=*/std::chrono::seconds(45), + /*scaling=*/2.0) + .clone()); + auto connection = google::cloud::compute_organization_security_policies_v1:: + MakeOrganizationSecurityPoliciesConnectionRest(options); + + // c1 and c2 share the same retry policies + auto c1 = google::cloud::compute_organization_security_policies_v1:: + OrganizationSecurityPoliciesClient(connection); + auto c2 = google::cloud::compute_organization_security_policies_v1:: + OrganizationSecurityPoliciesClient(connection); + + // You can override any of the policies in a new client. This new client + // will share the policies from c1 (or c2) *except* for the retry policy. + auto c3 = google::cloud::compute_organization_security_policies_v1:: + OrganizationSecurityPoliciesClient( + connection, + google::cloud::Options{} + .set( + google::cloud::compute_organization_security_policies_v1:: + OrganizationSecurityPoliciesLimitedTimeRetryPolicy( + std::chrono::minutes(5)) + .clone())); + + // You can also override the policies in a single call: + // c3.SomeRpc(..., google::cloud::Options{} + // .set( + // google::cloud::compute_organization_security_policies_v1::OrganizationSecurityPoliciesLimitedErrorCountRetryPolicy(10).clone())); + //! [set-retry-policy] +} + +void SetPollingPolicy(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-policy-policy"}; + } + //! [set-polling-policy] + + // The polling policy controls how the client waits for long-running + // operations. `GenericPollingPolicy<>` combines existing policies. + // In this case, keep polling until the operation completes (with success + // or error) or 45 minutes, whichever happens first. Initially pause for + // 10 seconds between polling requests, increasing the pause by a factor + // of 4 until it becomes 2 minutes. + auto options = + google::cloud::Options{} + .set( + google::cloud::GenericPollingPolicy< + google::cloud::compute_organization_security_policies_v1:: + OrganizationSecurityPoliciesRetryPolicyOption::Type, + google::cloud::compute_organization_security_policies_v1:: + OrganizationSecurityPoliciesBackoffPolicyOption::Type>( + google::cloud::compute_organization_security_policies_v1:: + OrganizationSecurityPoliciesLimitedTimeRetryPolicy( + /*maximum_duration=*/std::chrono::minutes(45)) + .clone(), + google::cloud::ExponentialBackoffPolicy( + /*initial_delay=*/std::chrono::seconds(10), + /*maximum_delay=*/std::chrono::minutes(2), + /*scaling=*/4.0) + .clone()) + .clone()); + + auto connection = google::cloud::compute_organization_security_policies_v1:: + MakeOrganizationSecurityPoliciesConnectionRest(options); + + // c1 and c2 share the same polling policies. + auto c1 = google::cloud::compute_organization_security_policies_v1:: + OrganizationSecurityPoliciesClient(connection); + auto c2 = google::cloud::compute_organization_security_policies_v1:: + OrganizationSecurityPoliciesClient(connection); + //! [set-polling-policy] +} + +void WithServiceAccount(std::vector const& argv) { + if (argv.size() != 1 || argv[0] == "--help") { + throw google::cloud::testing_util::Usage{"with-service-account "}; + } + //! [with-service-account] + [](std::string const& keyfile) { + auto is = std::ifstream(keyfile); + is.exceptions(std::ios::badbit); // Minimal error handling in examples + auto contents = std::string(std::istreambuf_iterator(is.rdbuf()), {}); + auto options = + google::cloud::Options{}.set( + google::cloud::MakeServiceAccountCredentials(contents)); + return google::cloud::compute_organization_security_policies_v1:: + OrganizationSecurityPoliciesClient( + google::cloud::compute_organization_security_policies_v1:: + MakeOrganizationSecurityPoliciesConnectionRest(options)); + } + //! [with-service-account] + (argv.at(0)); +} + +void AutoRun(std::vector const& argv) { + namespace examples = ::google::cloud::testing_util; + using ::google::cloud::internal::GetEnv; + if (!argv.empty()) throw examples::Usage{"auto"}; + examples::CheckEnvironmentVariablesAreSet( + {"GOOGLE_CLOUD_CPP_TEST_SERVICE_ACCOUNT_KEYFILE"}); + auto const keyfile = + GetEnv("GOOGLE_CLOUD_CPP_TEST_SERVICE_ACCOUNT_KEYFILE").value(); + + std::cout << "\nRunning SetClientEndpoint() example" << std::endl; + SetClientEndpoint({}); + + std::cout << "\nRunning SetRetryPolicy() example" << std::endl; + SetRetryPolicy({}); + + std::cout << "\nRunning SetPollingPolicy() example" << std::endl; + SetPollingPolicy({}); + + std::cout << "\nRunning WithServiceAccount() example" << std::endl; + WithServiceAccount({keyfile}); + + std::cout << "\nRunning SetClientUniverseDomain() example" << std::endl; + SetClientUniverseDomain({}); +} + +} // namespace + +int main(int argc, char* argv[]) { // NOLINT(bugprone-exception-escape) + google::cloud::testing_util::Example example({ + {"set-client-endpoint", SetClientEndpoint}, + {"set-retry-policy", SetRetryPolicy}, + {"set-polling-policy", SetPollingPolicy}, + {"with-service-account", WithServiceAccount}, + {"set-client-universe-domain", SetClientUniverseDomain}, + {"auto", AutoRun}, + }); + return example.Run(argc, argv); +} 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 c533a615c836b..88f312651680a 100644 --- a/google/cloud/compute/packet_mirrorings/v1/packet_mirrorings_client.h +++ b/google/cloud/compute/packet_mirrorings/v1/packet_mirrorings_client.h @@ -91,9 +91,10 @@ class PacketMirroringsClient { // clang-format off /// - /// Retrieves an aggregated list of packetMirrorings. To prevent failure, - /// Google recommends that you set the `returnPartialSuccess` parameter to - /// `true`. + /// Retrieves an aggregated list of packetMirrorings. + /// + /// To prevent failure, Google recommends that you set the + /// `returnPartialSuccess` parameter to `true`. /// https://cloud.google.com/compute/docs/reference/rest/v1/packetMirrorings/aggregatedList /// /// @param project Project ID for this request. @@ -119,8 +120,8 @@ class PacketMirroringsClient { /// [`future`]: @ref google::cloud::future /// [`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_093.proto#L392} + /// [google.cloud.cpp.compute.packet_mirrorings.v1.AggregatedListPacketMirroringsRequest]: @cloud_cpp_reference_link{google/cloud/compute/packet_mirrorings/v1/packet_mirrorings.proto#L130} + /// [google.cloud.cpp.compute.v1.PacketMirroringsScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_109.proto#L456} /// // clang-format on StreamRange> @@ -254,7 +256,7 @@ class PacketMirroringsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.packet_mirrorings.v1.DeletePacketMirroringRequest]: @cloud_cpp_reference_link{google/cloud/compute/packet_mirrorings/v1/packet_mirrorings.proto#L210} + /// [google.cloud.cpp.compute.packet_mirrorings.v1.DeletePacketMirroringRequest]: @cloud_cpp_reference_link{google/cloud/compute/packet_mirrorings/v1/packet_mirrorings.proto#L245} /// // clang-format on future> @@ -314,8 +316,8 @@ class PacketMirroringsClient { /// [`future`]: @ref google::cloud::future /// [`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_093.proto#L29} + /// [google.cloud.cpp.compute.packet_mirrorings.v1.GetPacketMirroringRequest]: @cloud_cpp_reference_link{google/cloud/compute/packet_mirrorings/v1/packet_mirrorings.proto#L281} + /// [google.cloud.cpp.compute.v1.PacketMirroring]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_109.proto#L32} /// // clang-format on StatusOr GetPacketMirroring( @@ -346,8 +348,8 @@ class PacketMirroringsClient { /// [`future`]: @ref google::cloud::future /// [`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_093.proto#L29} + /// [google.cloud.cpp.compute.packet_mirrorings.v1.GetPacketMirroringRequest]: @cloud_cpp_reference_link{google/cloud/compute/packet_mirrorings/v1/packet_mirrorings.proto#L281} + /// [google.cloud.cpp.compute.v1.PacketMirroring]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_109.proto#L32} /// // clang-format on StatusOr GetPacketMirroring( @@ -384,7 +386,7 @@ class PacketMirroringsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.packet_mirrorings.v1.InsertPacketMirroringRequest]: @cloud_cpp_reference_link{google/cloud/compute/packet_mirrorings/v1/packet_mirrorings.proto#L258} + /// [google.cloud.cpp.compute.packet_mirrorings.v1.InsertPacketMirroringRequest]: @cloud_cpp_reference_link{google/cloud/compute/packet_mirrorings/v1/packet_mirrorings.proto#L296} /// // clang-format on future> @@ -442,7 +444,7 @@ class PacketMirroringsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.packet_mirrorings.v1.InsertPacketMirroringRequest]: @cloud_cpp_reference_link{google/cloud/compute/packet_mirrorings/v1/packet_mirrorings.proto#L258} + /// [google.cloud.cpp.compute.packet_mirrorings.v1.InsertPacketMirroringRequest]: @cloud_cpp_reference_link{google/cloud/compute/packet_mirrorings/v1/packet_mirrorings.proto#L296} /// // clang-format on future> @@ -511,8 +513,8 @@ class PacketMirroringsClient { /// [`future`]: @ref google::cloud::future /// [`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_093.proto#L29} + /// [google.cloud.cpp.compute.packet_mirrorings.v1.ListPacketMirroringsRequest]: @cloud_cpp_reference_link{google/cloud/compute/packet_mirrorings/v1/packet_mirrorings.proto#L332} + /// [google.cloud.cpp.compute.v1.PacketMirroring]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_109.proto#L32} /// // clang-format on StreamRange @@ -553,8 +555,8 @@ class PacketMirroringsClient { /// [`future`]: @ref google::cloud::future /// [`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_093.proto#L29} + /// [google.cloud.cpp.compute.packet_mirrorings.v1.ListPacketMirroringsRequest]: @cloud_cpp_reference_link{google/cloud/compute/packet_mirrorings/v1/packet_mirrorings.proto#L332} + /// [google.cloud.cpp.compute.v1.PacketMirroring]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_109.proto#L32} /// // clang-format on StreamRange @@ -565,8 +567,9 @@ class PacketMirroringsClient { // clang-format off /// /// 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. + /// the request. This method supportsPATCH + /// semantics and usesJSON merge + /// patch format and processing rules. /// https://cloud.google.com/compute/docs/reference/rest/v1/packetMirrorings/patch /// /// @param project Project ID for this request. @@ -593,7 +596,7 @@ class PacketMirroringsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.packet_mirrorings.v1.PatchPacketMirroringRequest]: @cloud_cpp_reference_link{google/cloud/compute/packet_mirrorings/v1/packet_mirrorings.proto#L363} + /// [google.cloud.cpp.compute.packet_mirrorings.v1.PatchPacketMirroringRequest]: @cloud_cpp_reference_link{google/cloud/compute/packet_mirrorings/v1/packet_mirrorings.proto#L437} /// // clang-format on future> @@ -624,8 +627,9 @@ class PacketMirroringsClient { // clang-format off /// /// 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. + /// the request. This method supportsPATCH + /// semantics and usesJSON merge + /// patch format and processing rules. /// https://cloud.google.com/compute/docs/reference/rest/v1/packetMirrorings/patch /// /// @param request Unary RPCs, such as the one wrapped by this @@ -654,7 +658,7 @@ class PacketMirroringsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.packet_mirrorings.v1.PatchPacketMirroringRequest]: @cloud_cpp_reference_link{google/cloud/compute/packet_mirrorings/v1/packet_mirrorings.proto#L363} + /// [google.cloud.cpp.compute.packet_mirrorings.v1.PatchPacketMirroringRequest]: @cloud_cpp_reference_link{google/cloud/compute/packet_mirrorings/v1/packet_mirrorings.proto#L437} /// // clang-format on future> @@ -715,8 +719,8 @@ class PacketMirroringsClient { /// [`future`]: @ref google::cloud::future /// [`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_145.proto#L30} + /// [google.cloud.cpp.compute.packet_mirrorings.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/packet_mirrorings/v1/packet_mirrorings.proto#L477} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} /// // clang-format on StatusOr @@ -751,8 +755,8 @@ class PacketMirroringsClient { /// [`future`]: @ref google::cloud::future /// [`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_145.proto#L30} + /// [google.cloud.cpp.compute.packet_mirrorings.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/packet_mirrorings/v1/packet_mirrorings.proto#L477} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.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 f410b79d44368..6c422e2a4708d 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 "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_093.pb.h" -#include "google/cloud/compute/v1/internal/common_145.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_109.pb.h" +#include "google/cloud/compute/v1/internal/common_171.pb.h" // 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/preview_features/v1/internal/preview_features_option_defaults.cc b/google/cloud/compute/preview_features/v1/internal/preview_features_option_defaults.cc new file mode 100644 index 0000000000000..9cd887ce39cd8 --- /dev/null +++ b/google/cloud/compute/preview_features/v1/internal/preview_features_option_defaults.cc @@ -0,0 +1,88 @@ +// Copyright 2026 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. +// source: google/cloud/compute/preview_features/v1/preview_features.proto + +#include "google/cloud/compute/preview_features/v1/internal/preview_features_option_defaults.h" +#include "google/cloud/compute/preview_features/v1/preview_features_connection.h" +#include "google/cloud/compute/preview_features/v1/preview_features_options.h" +#include "google/cloud/internal/populate_common_options.h" +#include "google/cloud/internal/populate_grpc_options.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_preview_features_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +namespace { +auto constexpr kBackoffScaling = 2.0; +} // namespace + +Options PreviewFeaturesDefaultOptions(Options options) { + options = internal::PopulateCommonOptions( + std::move(options), "GOOGLE_CLOUD_CPP_PREVIEW_FEATURES_ENDPOINT", "", + "GOOGLE_CLOUD_CPP_PREVIEW_FEATURES_AUTHORITY", "compute.googleapis.com"); + options = internal::PopulateGrpcOptions(std::move(options)); + if (!options.has< + compute_preview_features_v1::PreviewFeaturesRetryPolicyOption>()) { + options.set( + compute_preview_features_v1::PreviewFeaturesLimitedTimeRetryPolicy( + std::chrono::minutes(10)) + .clone()); + } + if (!options.has< + compute_preview_features_v1::PreviewFeaturesBackoffPolicyOption>()) { + options + .set( + ExponentialBackoffPolicy( + std::chrono::seconds(0), std::chrono::seconds(1), + std::chrono::minutes(5), kBackoffScaling, kBackoffScaling) + .clone()); + } + if (!options.has< + compute_preview_features_v1::PreviewFeaturesPollingPolicyOption>()) { + options.set< + compute_preview_features_v1::PreviewFeaturesPollingPolicyOption>( + GenericPollingPolicy< + compute_preview_features_v1::PreviewFeaturesRetryPolicyOption::Type, + compute_preview_features_v1::PreviewFeaturesBackoffPolicyOption:: + Type>( + options + .get() + ->clone(), + ExponentialBackoffPolicy(std::chrono::seconds(1), + std::chrono::minutes(5), kBackoffScaling) + .clone()) + .clone()); + } + if (!options.has()) { + options.set( + compute_preview_features_v1:: + MakeDefaultPreviewFeaturesConnectionIdempotencyPolicy()); + } + + return options; +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_preview_features_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/preview_features/v1/internal/preview_features_option_defaults.h b/google/cloud/compute/preview_features/v1/internal/preview_features_option_defaults.h new file mode 100644 index 0000000000000..735c785ede523 --- /dev/null +++ b/google/cloud/compute/preview_features/v1/internal/preview_features_option_defaults.h @@ -0,0 +1,37 @@ +// Copyright 2026 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. +// source: google/cloud/compute/preview_features/v1/preview_features.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_PREVIEW_FEATURES_V1_INTERNAL_PREVIEW_FEATURES_OPTION_DEFAULTS_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_PREVIEW_FEATURES_V1_INTERNAL_PREVIEW_FEATURES_OPTION_DEFAULTS_H + +#include "google/cloud/options.h" +#include "google/cloud/version.h" + +namespace google { +namespace cloud { +namespace compute_preview_features_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +Options PreviewFeaturesDefaultOptions(Options options); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_preview_features_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_PREVIEW_FEATURES_V1_INTERNAL_PREVIEW_FEATURES_OPTION_DEFAULTS_H diff --git a/google/cloud/compute/preview_features/v1/internal/preview_features_rest_connection_impl.cc b/google/cloud/compute/preview_features/v1/internal/preview_features_rest_connection_impl.cc new file mode 100644 index 0000000000000..c4ea387bf556d --- /dev/null +++ b/google/cloud/compute/preview_features/v1/internal/preview_features_rest_connection_impl.cc @@ -0,0 +1,232 @@ +// Copyright 2026 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. +// source: google/cloud/compute/preview_features/v1/preview_features.proto + +#include "google/cloud/compute/preview_features/v1/internal/preview_features_rest_connection_impl.h" +#include "google/cloud/compute/preview_features/v1/internal/preview_features_rest_stub_factory.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/internal/async_rest_long_running_operation_custom.h" +#include "google/cloud/internal/extract_long_running_result.h" +#include "google/cloud/internal/pagination_range.h" +#include "google/cloud/internal/rest_lro_helpers.h" +#include "google/cloud/internal/rest_retry_loop.h" +#include "google/cloud/rest_options.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_preview_features_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +PreviewFeaturesRestConnectionImpl::PreviewFeaturesRestConnectionImpl( + std::unique_ptr background, + std::shared_ptr< + compute_preview_features_v1_internal::PreviewFeaturesRestStub> + stub, + Options options) + : background_(std::move(background)), + stub_(std::move(stub)), + options_(internal::MergeOptions(std::move(options), + PreviewFeaturesConnection::options())) {} + +StatusOr +PreviewFeaturesRestConnectionImpl::GetPreviewFeature( + google::cloud::cpp::compute::preview_features::v1:: + GetPreviewFeatureRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->GetPreviewFeature(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::preview_features::v1:: + GetPreviewFeatureRequest const& request) { + return stub_->GetPreviewFeature(rest_context, options, request); + }, + *current, request, __func__); +} + +StreamRange +PreviewFeaturesRestConnectionImpl::ListPreviewFeatures( + google::cloud::cpp::compute::preview_features::v1:: + ListPreviewFeaturesRequest request) { + request.clear_page_token(); + auto current = google::cloud::internal::SaveCurrentOptions(); + auto idempotency = idempotency_policy(*current)->ListPreviewFeatures(request); + char const* function_name = __func__; + return google::cloud::internal::MakePaginationRange< + StreamRange>( + current, std::move(request), + [idempotency, function_name, stub = stub_, + retry = std::shared_ptr< + compute_preview_features_v1::PreviewFeaturesRetryPolicy>( + retry_policy(*current)), + backoff = std::shared_ptr(backoff_policy(*current))]( + Options const& options, + google::cloud::cpp::compute::preview_features::v1:: + ListPreviewFeaturesRequest const& r) { + return google::cloud::rest_internal::RestRetryLoop( + retry->clone(), backoff->clone(), idempotency, + [stub](rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::preview_features::v1:: + ListPreviewFeaturesRequest const& request) { + return stub->ListPreviewFeatures(rest_context, options, request); + }, + options, r, function_name); + }, + [](google::cloud::cpp::compute::v1::PreviewFeatureList r) { + std::vector result( + r.items().size()); + auto& messages = *r.mutable_items(); + std::move(messages.begin(), messages.end(), result.begin()); + return result; + }); +} + +future> +PreviewFeaturesRestConnectionImpl::UpdatePreviewFeature( + google::cloud::cpp::compute::preview_features::v1:: + UpdatePreviewFeatureRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::global_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, request, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::preview_features::v1:: + UpdatePreviewFeatureRequest const& request) { + return stub->AsyncUpdatePreviewFeature(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->UpdatePreviewFeature(request), + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [request](std::string const& op, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest& r) { + r.set_project(request.project()); + r.set_operation(op); + }, + [request](std::string const& op, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest& r) { + r.set_project(request.project()); + r.set_operation(op); + }); +} + +StatusOr +PreviewFeaturesRestConnectionImpl::UpdatePreviewFeature( + NoAwaitTag, google::cloud::cpp::compute::preview_features::v1:: + UpdatePreviewFeatureRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->UpdatePreviewFeature(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::preview_features::v1:: + UpdatePreviewFeatureRequest const& request) { + return stub_->UpdatePreviewFeature(rest_context, options, request); + }, + *current, request, __func__); +} + +future> +PreviewFeaturesRestConnectionImpl::UpdatePreviewFeature( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestAwaitLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::global_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, operation, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [operation](std::string const&, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_operation(info.operation); + }, + [operation](std::string const&, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_operation(info.operation); + }); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_preview_features_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/preview_features/v1/internal/preview_features_rest_connection_impl.h b/google/cloud/compute/preview_features/v1/internal/preview_features_rest_connection_impl.h new file mode 100644 index 0000000000000..5d80a00f948fe --- /dev/null +++ b/google/cloud/compute/preview_features/v1/internal/preview_features_rest_connection_impl.h @@ -0,0 +1,116 @@ +// Copyright 2026 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. +// source: google/cloud/compute/preview_features/v1/preview_features.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_PREVIEW_FEATURES_V1_INTERNAL_PREVIEW_FEATURES_REST_CONNECTION_IMPL_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_PREVIEW_FEATURES_V1_INTERNAL_PREVIEW_FEATURES_REST_CONNECTION_IMPL_H + +#include "google/cloud/compute/global_operations/v1/global_operations.pb.h" +#include "google/cloud/compute/preview_features/v1/internal/preview_features_rest_stub.h" +#include "google/cloud/compute/preview_features/v1/internal/preview_features_retry_traits.h" +#include "google/cloud/compute/preview_features/v1/preview_features_connection.h" +#include "google/cloud/compute/preview_features/v1/preview_features_connection_idempotency_policy.h" +#include "google/cloud/compute/preview_features/v1/preview_features_options.h" +#include "google/cloud/background_threads.h" +#include "google/cloud/backoff_policy.h" +#include "google/cloud/options.h" +#include "google/cloud/status_or.h" +#include "google/cloud/stream_range.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_preview_features_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class PreviewFeaturesRestConnectionImpl + : public compute_preview_features_v1::PreviewFeaturesConnection { + public: + ~PreviewFeaturesRestConnectionImpl() override = default; + + PreviewFeaturesRestConnectionImpl( + std::unique_ptr background, + std::shared_ptr< + compute_preview_features_v1_internal::PreviewFeaturesRestStub> + stub, + Options options); + + Options options() override { return options_; } + + StatusOr GetPreviewFeature( + google::cloud::cpp::compute::preview_features::v1:: + GetPreviewFeatureRequest const& request) override; + + StreamRange + ListPreviewFeatures(google::cloud::cpp::compute::preview_features::v1:: + ListPreviewFeaturesRequest request) override; + + future> + UpdatePreviewFeature(google::cloud::cpp::compute::preview_features::v1:: + UpdatePreviewFeatureRequest const& request) override; + + StatusOr UpdatePreviewFeature( + NoAwaitTag, google::cloud::cpp::compute::preview_features::v1:: + UpdatePreviewFeatureRequest const& request) override; + + future> + UpdatePreviewFeature( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + private: + static std::unique_ptr< + compute_preview_features_v1::PreviewFeaturesRetryPolicy> + retry_policy(Options const& options) { + return options + .get() + ->clone(); + } + + static std::unique_ptr backoff_policy(Options const& options) { + return options + .get() + ->clone(); + } + + static std::unique_ptr< + compute_preview_features_v1::PreviewFeaturesConnectionIdempotencyPolicy> + idempotency_policy(Options const& options) { + return options + .get() + ->clone(); + } + + static std::unique_ptr polling_policy(Options const& options) { + return options + .get() + ->clone(); + } + + std::unique_ptr background_; + std::shared_ptr + stub_; + Options options_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_preview_features_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_PREVIEW_FEATURES_V1_INTERNAL_PREVIEW_FEATURES_REST_CONNECTION_IMPL_H diff --git a/google/cloud/compute/preview_features/v1/internal/preview_features_rest_logging_decorator.cc b/google/cloud/compute/preview_features/v1/internal/preview_features_rest_logging_decorator.cc new file mode 100644 index 0000000000000..dd26cb03ab210 --- /dev/null +++ b/google/cloud/compute/preview_features/v1/internal/preview_features_rest_logging_decorator.cc @@ -0,0 +1,141 @@ +// Copyright 2026 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. +// source: google/cloud/compute/preview_features/v1/preview_features.proto + +#include "google/cloud/compute/preview_features/v1/internal/preview_features_rest_logging_decorator.h" +#include "google/cloud/internal/log_wrapper.h" +#include "google/cloud/status_or.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_preview_features_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +PreviewFeaturesRestLogging::PreviewFeaturesRestLogging( + std::shared_ptr child, + TracingOptions tracing_options, std::set components) + : child_(std::move(child)), + tracing_options_(std::move(tracing_options)), + components_(std::move(components)) {} + +StatusOr +PreviewFeaturesRestLogging::GetPreviewFeature( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::preview_features::v1:: + GetPreviewFeatureRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::preview_features::v1:: + GetPreviewFeatureRequest const& request) { + return child_->GetPreviewFeature(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +StatusOr +PreviewFeaturesRestLogging::ListPreviewFeatures( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::preview_features::v1:: + ListPreviewFeaturesRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::preview_features::v1:: + ListPreviewFeaturesRequest const& request) { + return child_->ListPreviewFeatures(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +future> +PreviewFeaturesRestLogging::AsyncUpdatePreviewFeature( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::preview_features::v1:: + UpdatePreviewFeatureRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::preview_features::v1:: + UpdatePreviewFeatureRequest const& request) { + return child_->AsyncUpdatePreviewFeature(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +StatusOr +PreviewFeaturesRestLogging::UpdatePreviewFeature( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::preview_features::v1:: + UpdatePreviewFeatureRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::preview_features::v1:: + UpdatePreviewFeatureRequest const& request) { + return child_->UpdatePreviewFeature(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +future> +PreviewFeaturesRestLogging::AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) { + return child_->AsyncGetOperation(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +future PreviewFeaturesRestLogging::AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) { + return child_->AsyncCancelOperation(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_preview_features_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/preview_features/v1/internal/preview_features_rest_logging_decorator.h b/google/cloud/compute/preview_features/v1/internal/preview_features_rest_logging_decorator.h new file mode 100644 index 0000000000000..7ca5b3961cdbc --- /dev/null +++ b/google/cloud/compute/preview_features/v1/internal/preview_features_rest_logging_decorator.h @@ -0,0 +1,97 @@ +// Copyright 2026 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. +// source: google/cloud/compute/preview_features/v1/preview_features.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_PREVIEW_FEATURES_V1_INTERNAL_PREVIEW_FEATURES_REST_LOGGING_DECORATOR_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_PREVIEW_FEATURES_V1_INTERNAL_PREVIEW_FEATURES_REST_LOGGING_DECORATOR_H + +#include "google/cloud/compute/global_operations/v1/global_operations.pb.h" +#include "google/cloud/compute/preview_features/v1/internal/preview_features_rest_stub.h" +#include "google/cloud/compute/preview_features/v1/preview_features.pb.h" +#include "google/cloud/future.h" +#include "google/cloud/internal/rest_context.h" +#include "google/cloud/tracing_options.h" +#include "google/cloud/version.h" +#include +#include +#include + +namespace google { +namespace cloud { +namespace compute_preview_features_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class PreviewFeaturesRestLogging : public PreviewFeaturesRestStub { + public: + ~PreviewFeaturesRestLogging() override = default; + PreviewFeaturesRestLogging(std::shared_ptr child, + TracingOptions tracing_options, + std::set components); + + StatusOr GetPreviewFeature( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::preview_features::v1:: + GetPreviewFeatureRequest const& request) override; + + StatusOr + ListPreviewFeatures(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::preview_features::v1:: + ListPreviewFeaturesRequest const& request) override; + + future> + AsyncUpdatePreviewFeature( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::preview_features::v1:: + UpdatePreviewFeatureRequest const& request) override; + + StatusOr UpdatePreviewFeature( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::preview_features::v1:: + UpdatePreviewFeatureRequest const& request) override; + + future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) override; + + future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) override; + + private: + std::shared_ptr child_; + TracingOptions tracing_options_; + std::set components_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_preview_features_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_PREVIEW_FEATURES_V1_INTERNAL_PREVIEW_FEATURES_REST_LOGGING_DECORATOR_H diff --git a/google/cloud/compute/preview_features/v1/internal/preview_features_rest_metadata_decorator.cc b/google/cloud/compute/preview_features/v1/internal/preview_features_rest_metadata_decorator.cc new file mode 100644 index 0000000000000..8f6c1ab34c85a --- /dev/null +++ b/google/cloud/compute/preview_features/v1/internal/preview_features_rest_metadata_decorator.cc @@ -0,0 +1,114 @@ +// Copyright 2026 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. +// source: google/cloud/compute/preview_features/v1/preview_features.proto + +#include "google/cloud/compute/preview_features/v1/internal/preview_features_rest_metadata_decorator.h" +#include "google/cloud/internal/api_client_header.h" +#include "google/cloud/internal/rest_set_metadata.h" +#include "google/cloud/status_or.h" +#include "absl/strings/str_cat.h" +#include "absl/strings/str_format.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_preview_features_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +PreviewFeaturesRestMetadata::PreviewFeaturesRestMetadata( + std::shared_ptr child, + std::string api_client_header) + : child_(std::move(child)), + api_client_header_( + api_client_header.empty() + ? google::cloud::internal::GeneratedLibClientHeader() + : std::move(api_client_header)) {} + +StatusOr +PreviewFeaturesRestMetadata::GetPreviewFeature( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::preview_features::v1:: + GetPreviewFeatureRequest const& request) { + SetMetadata(rest_context, options); + return child_->GetPreviewFeature(rest_context, options, request); +} + +StatusOr +PreviewFeaturesRestMetadata::ListPreviewFeatures( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::preview_features::v1:: + ListPreviewFeaturesRequest const& request) { + SetMetadata(rest_context, options); + return child_->ListPreviewFeatures(rest_context, options, request); +} + +future> +PreviewFeaturesRestMetadata::AsyncUpdatePreviewFeature( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::preview_features::v1:: + UpdatePreviewFeatureRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncUpdatePreviewFeature(cq, std::move(rest_context), + std::move(options), request); +} + +StatusOr +PreviewFeaturesRestMetadata::UpdatePreviewFeature( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::preview_features::v1:: + UpdatePreviewFeatureRequest const& request) { + SetMetadata(rest_context, options); + return child_->UpdatePreviewFeature(rest_context, options, request); +} + +future> +PreviewFeaturesRestMetadata::AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncGetOperation(cq, std::move(rest_context), + std::move(options), request); +} + +future PreviewFeaturesRestMetadata::AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncCancelOperation(cq, std::move(rest_context), + std::move(options), request); +} + +void PreviewFeaturesRestMetadata::SetMetadata( + rest_internal::RestContext& rest_context, Options const& options, + std::vector const& params) { + google::cloud::rest_internal::SetMetadata(rest_context, options, params, + api_client_header_); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_preview_features_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/preview_features/v1/internal/preview_features_rest_metadata_decorator.h b/google/cloud/compute/preview_features/v1/internal/preview_features_rest_metadata_decorator.h new file mode 100644 index 0000000000000..99acc1cdb1b81 --- /dev/null +++ b/google/cloud/compute/preview_features/v1/internal/preview_features_rest_metadata_decorator.h @@ -0,0 +1,98 @@ +// Copyright 2026 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. +// source: google/cloud/compute/preview_features/v1/preview_features.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_PREVIEW_FEATURES_V1_INTERNAL_PREVIEW_FEATURES_REST_METADATA_DECORATOR_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_PREVIEW_FEATURES_V1_INTERNAL_PREVIEW_FEATURES_REST_METADATA_DECORATOR_H + +#include "google/cloud/compute/global_operations/v1/global_operations.pb.h" +#include "google/cloud/compute/preview_features/v1/internal/preview_features_rest_stub.h" +#include "google/cloud/compute/preview_features/v1/preview_features.pb.h" +#include "google/cloud/future.h" +#include "google/cloud/rest_options.h" +#include "google/cloud/version.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_preview_features_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class PreviewFeaturesRestMetadata : public PreviewFeaturesRestStub { + public: + ~PreviewFeaturesRestMetadata() override = default; + explicit PreviewFeaturesRestMetadata( + std::shared_ptr child, + std::string api_client_header = ""); + + StatusOr GetPreviewFeature( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::preview_features::v1:: + GetPreviewFeatureRequest const& request) override; + + StatusOr + ListPreviewFeatures(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::preview_features::v1:: + ListPreviewFeaturesRequest const& request) override; + + google::cloud::future> + AsyncUpdatePreviewFeature( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::preview_features::v1:: + UpdatePreviewFeatureRequest const& request) override; + + StatusOr UpdatePreviewFeature( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::preview_features::v1:: + UpdatePreviewFeatureRequest const& request) override; + + google::cloud::future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) override; + + google::cloud::future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) override; + + private: + void SetMetadata(rest_internal::RestContext& rest_context, + Options const& options, + std::vector const& params = {}); + + std::shared_ptr child_; + std::string api_client_header_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_preview_features_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_PREVIEW_FEATURES_V1_INTERNAL_PREVIEW_FEATURES_REST_METADATA_DECORATOR_H diff --git a/google/cloud/compute/preview_features/v1/internal/preview_features_rest_stub.cc b/google/cloud/compute/preview_features/v1/internal/preview_features_rest_stub.cc new file mode 100644 index 0000000000000..d77612d2f4053 --- /dev/null +++ b/google/cloud/compute/preview_features/v1/internal/preview_features_rest_stub.cc @@ -0,0 +1,211 @@ +// Copyright 2026 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. +// source: google/cloud/compute/preview_features/v1/preview_features.proto + +#include "google/cloud/compute/preview_features/v1/internal/preview_features_rest_stub.h" +#include "google/cloud/compute/global_operations/v1/global_operations.pb.h" +#include "google/cloud/compute/preview_features/v1/preview_features.pb.h" +#include "google/cloud/common_options.h" +#include "google/cloud/internal/rest_stub_helpers.h" +#include "google/cloud/status_or.h" +#include "absl/strings/str_cat.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_preview_features_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +DefaultPreviewFeaturesRestStub::DefaultPreviewFeaturesRestStub(Options options) + : service_(rest_internal::MakePooledRestClient( + options.get(), options)), + operations_(rest_internal::MakePooledRestClient( + options.get(), options)), + options_(std::move(options)) {} + +DefaultPreviewFeaturesRestStub::DefaultPreviewFeaturesRestStub( + std::shared_ptr service, + std::shared_ptr operations, Options options) + : service_(std::move(service)), + operations_(std::move(operations)), + options_(std::move(options)) {} + +StatusOr +DefaultPreviewFeaturesRestStub::GetPreviewFeature( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::preview_features::v1:: + GetPreviewFeatureRequest const& request) { + std::vector> query_params; + return rest_internal::Get( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "global", "/", + "previewFeatures", "/", request.preview_feature()), + std::move(query_params)); +} + +StatusOr +DefaultPreviewFeaturesRestStub::ListPreviewFeatures( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::preview_features::v1:: + ListPreviewFeaturesRequest const& request) { + std::vector> query_params; + query_params.push_back({"filter", request.filter()}); + query_params.push_back( + {"max_results", std::to_string(request.max_results())}); + query_params.push_back({"order_by", request.order_by()}); + query_params.push_back({"page_token", request.page_token()}); + query_params.push_back({"return_partial_success", + (request.return_partial_success() ? "1" : "0")}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Get< + google::cloud::cpp::compute::v1::PreviewFeatureList>( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "global", "/", + "previewFeatures"), + std::move(query_params)); +} + +future> +DefaultPreviewFeaturesRestStub::AsyncUpdatePreviewFeature( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::preview_features::v1:: + UpdatePreviewFeatureRequest const& request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto service, auto request, auto rest_context, auto options) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + p.set_value( + rest_internal::Patch( + *service, *rest_context, request.preview_feature_resource(), + false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", *options), + "/", "projects", "/", request.project(), "/", + "global", "/", "previewFeatures", "/", + request.preview_feature()), + std::move(query_params))); + }, + std::move(p), + service_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +StatusOr +DefaultPreviewFeaturesRestStub::UpdatePreviewFeature( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::preview_features::v1:: + UpdatePreviewFeatureRequest const& request) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Patch( + *service_, rest_context, request.preview_feature_resource(), false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "global", "/", + "previewFeatures", "/", request.preview_feature()), + std::move(query_params)); +} + +future> +DefaultPreviewFeaturesRestStub::AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto operations, auto request, auto rest_context, + auto options) { + p.set_value( + rest_internal::Get( + *operations, *rest_context, request, false, + absl::StrCat("/compute/", + rest_internal::DetermineApiVersion("v1", *options), + "/projects/", request.project(), + "/global/operations/", request.operation()))); + }, + std::move(p), + operations_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +future DefaultPreviewFeaturesRestStub::AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) { + promise> p; + future> f = p.get_future(); + std::thread t{ + [](auto p, auto operations, auto request, auto rest_context, + auto options) { + p.set_value(rest_internal::Post( + *operations, *rest_context, request, false, + absl::StrCat("/compute/", + rest_internal::DetermineApiVersion("v1", *options), + "/projects/", request.project(), "/global/operations/", + request.operation()))); + }, + std::move(p), + operations_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get().status(); + }); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_preview_features_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/preview_features/v1/internal/preview_features_rest_stub.h b/google/cloud/compute/preview_features/v1/internal/preview_features_rest_stub.h new file mode 100644 index 0000000000000..05a45c207f23a --- /dev/null +++ b/google/cloud/compute/preview_features/v1/internal/preview_features_rest_stub.h @@ -0,0 +1,143 @@ +// Copyright 2026 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. +// source: google/cloud/compute/preview_features/v1/preview_features.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_PREVIEW_FEATURES_V1_INTERNAL_PREVIEW_FEATURES_REST_STUB_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_PREVIEW_FEATURES_V1_INTERNAL_PREVIEW_FEATURES_REST_STUB_H + +#include "google/cloud/compute/global_operations/v1/global_operations.pb.h" +#include "google/cloud/compute/preview_features/v1/preview_features.pb.h" +#include "google/cloud/completion_queue.h" +#include "google/cloud/internal/rest_client.h" +#include "google/cloud/internal/rest_context.h" +#include "google/cloud/status_or.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_preview_features_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class PreviewFeaturesRestStub { + public: + virtual ~PreviewFeaturesRestStub() = default; + + virtual StatusOr + GetPreviewFeature(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::preview_features::v1:: + GetPreviewFeatureRequest const& request) = 0; + + virtual StatusOr + ListPreviewFeatures(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::preview_features::v1:: + ListPreviewFeaturesRequest const& request) = 0; + + virtual future> + AsyncUpdatePreviewFeature( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::preview_features::v1:: + UpdatePreviewFeatureRequest const& request) = 0; + + virtual StatusOr + UpdatePreviewFeature(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::preview_features::v1:: + UpdatePreviewFeatureRequest const& request) = 0; + + virtual future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) = 0; + + virtual future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) = 0; +}; + +class DefaultPreviewFeaturesRestStub : public PreviewFeaturesRestStub { + public: + ~DefaultPreviewFeaturesRestStub() override = default; + + explicit DefaultPreviewFeaturesRestStub(Options options); + DefaultPreviewFeaturesRestStub( + std::shared_ptr service, + std::shared_ptr operations, Options options); + + StatusOr GetPreviewFeature( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::preview_features::v1:: + GetPreviewFeatureRequest const& request) override; + + StatusOr + ListPreviewFeatures(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::preview_features::v1:: + ListPreviewFeaturesRequest const& request) override; + + future> + AsyncUpdatePreviewFeature( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::preview_features::v1:: + UpdatePreviewFeatureRequest const& request) override; + + StatusOr UpdatePreviewFeature( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::preview_features::v1:: + UpdatePreviewFeatureRequest const& request) override; + + future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) override; + + future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) override; + + private: + std::shared_ptr service_; + std::shared_ptr operations_; + Options options_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_preview_features_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_PREVIEW_FEATURES_V1_INTERNAL_PREVIEW_FEATURES_REST_STUB_H diff --git a/google/cloud/compute/preview_features/v1/internal/preview_features_rest_stub_factory.cc b/google/cloud/compute/preview_features/v1/internal/preview_features_rest_stub_factory.cc new file mode 100644 index 0000000000000..974634963f404 --- /dev/null +++ b/google/cloud/compute/preview_features/v1/internal/preview_features_rest_stub_factory.cc @@ -0,0 +1,56 @@ +// Copyright 2026 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. +// source: google/cloud/compute/preview_features/v1/preview_features.proto + +#include "google/cloud/compute/preview_features/v1/internal/preview_features_rest_stub_factory.h" +#include "google/cloud/compute/preview_features/v1/internal/preview_features_rest_logging_decorator.h" +#include "google/cloud/compute/preview_features/v1/internal/preview_features_rest_metadata_decorator.h" +#include "google/cloud/compute/preview_features/v1/internal/preview_features_rest_stub.h" +#include "google/cloud/common_options.h" +#include "google/cloud/internal/algorithm.h" +#include "google/cloud/internal/populate_rest_options.h" +#include "google/cloud/log.h" +#include "google/cloud/options.h" +#include "google/cloud/rest_options.h" +#include "absl/strings/match.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_preview_features_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +std::shared_ptr CreateDefaultPreviewFeaturesRestStub( + Options const& options) { + auto opts = internal::PopulateRestOptions(options); + std::shared_ptr stub = + std::make_shared(std::move(opts)); + stub = std::make_shared(std::move(stub)); + if (internal::Contains(options.get(), "rpc")) { + GCP_LOG(INFO) << "Enabled logging for REST rpc calls"; + stub = std::make_shared( + std::move(stub), options.get(), + options.get()); + } + return stub; +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_preview_features_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/preview_features/v1/internal/preview_features_rest_stub_factory.h b/google/cloud/compute/preview_features/v1/internal/preview_features_rest_stub_factory.h new file mode 100644 index 0000000000000..ed4c7bf89b56d --- /dev/null +++ b/google/cloud/compute/preview_features/v1/internal/preview_features_rest_stub_factory.h @@ -0,0 +1,40 @@ +// Copyright 2026 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. +// source: google/cloud/compute/preview_features/v1/preview_features.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_PREVIEW_FEATURES_V1_INTERNAL_PREVIEW_FEATURES_REST_STUB_FACTORY_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_PREVIEW_FEATURES_V1_INTERNAL_PREVIEW_FEATURES_REST_STUB_FACTORY_H + +#include "google/cloud/compute/preview_features/v1/internal/preview_features_rest_stub.h" +#include "google/cloud/options.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_preview_features_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +std::shared_ptr CreateDefaultPreviewFeaturesRestStub( + Options const& options); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_preview_features_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_PREVIEW_FEATURES_V1_INTERNAL_PREVIEW_FEATURES_REST_STUB_FACTORY_H diff --git a/google/cloud/compute/preview_features/v1/internal/preview_features_retry_traits.h b/google/cloud/compute/preview_features/v1/internal/preview_features_retry_traits.h new file mode 100644 index 0000000000000..b926e5dad2bfd --- /dev/null +++ b/google/cloud/compute/preview_features/v1/internal/preview_features_retry_traits.h @@ -0,0 +1,43 @@ +// Copyright 2026 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. +// source: google/cloud/compute/preview_features/v1/preview_features.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_PREVIEW_FEATURES_V1_INTERNAL_PREVIEW_FEATURES_RETRY_TRAITS_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_PREVIEW_FEATURES_V1_INTERNAL_PREVIEW_FEATURES_RETRY_TRAITS_H + +#include "google/cloud/status.h" +#include "google/cloud/version.h" + +namespace google { +namespace cloud { +namespace compute_preview_features_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/// Define the gRPC status code semantics for retrying requests. +struct PreviewFeaturesRetryTraits { + static bool IsPermanentFailure(google::cloud::Status const& status) { + return status.code() != StatusCode::kOk && + status.code() != StatusCode::kUnavailable; + } +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_preview_features_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_PREVIEW_FEATURES_V1_INTERNAL_PREVIEW_FEATURES_RETRY_TRAITS_H diff --git a/google/cloud/compute/preview_features/v1/internal/preview_features_sources.cc b/google/cloud/compute/preview_features/v1/internal/preview_features_sources.cc new file mode 100644 index 0000000000000..050d6d81603d0 --- /dev/null +++ b/google/cloud/compute/preview_features/v1/internal/preview_features_sources.cc @@ -0,0 +1,31 @@ +// Copyright 2026 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. +// source: google/cloud/compute/preview_features/v1/preview_features.proto + +// NOLINTBEGIN(bugprone-suspicious-include) +#include "google/cloud/compute/preview_features/v1/internal/preview_features_option_defaults.cc" +#include "google/cloud/compute/preview_features/v1/internal/preview_features_rest_connection_impl.cc" +#include "google/cloud/compute/preview_features/v1/internal/preview_features_rest_logging_decorator.cc" +#include "google/cloud/compute/preview_features/v1/internal/preview_features_rest_metadata_decorator.cc" +#include "google/cloud/compute/preview_features/v1/internal/preview_features_rest_stub.cc" +#include "google/cloud/compute/preview_features/v1/internal/preview_features_rest_stub_factory.cc" +#include "google/cloud/compute/preview_features/v1/internal/preview_features_tracing_connection.cc" +#include "google/cloud/compute/preview_features/v1/preview_features_client.cc" +#include "google/cloud/compute/preview_features/v1/preview_features_connection.cc" +#include "google/cloud/compute/preview_features/v1/preview_features_connection_idempotency_policy.cc" +#include "google/cloud/compute/preview_features/v1/preview_features_rest_connection.cc" +// NOLINTEND(bugprone-suspicious-include) diff --git a/google/cloud/compute/preview_features/v1/internal/preview_features_tracing_connection.cc b/google/cloud/compute/preview_features/v1/internal/preview_features_tracing_connection.cc new file mode 100644 index 0000000000000..263c3101bb9d6 --- /dev/null +++ b/google/cloud/compute/preview_features/v1/internal/preview_features_tracing_connection.cc @@ -0,0 +1,108 @@ +// Copyright 2026 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. +// source: google/cloud/compute/preview_features/v1/preview_features.proto + +#include "google/cloud/compute/preview_features/v1/internal/preview_features_tracing_connection.h" +#include "google/cloud/internal/opentelemetry.h" +#include "google/cloud/internal/traced_stream_range.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_preview_features_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +PreviewFeaturesTracingConnection::PreviewFeaturesTracingConnection( + std::shared_ptr + child) + : child_(std::move(child)) {} + +StatusOr +PreviewFeaturesTracingConnection::GetPreviewFeature( + google::cloud::cpp::compute::preview_features::v1:: + GetPreviewFeatureRequest const& request) { + auto span = internal::MakeSpan( + "compute_preview_features_v1::PreviewFeaturesConnection::" + "GetPreviewFeature"); + auto scope = opentelemetry::trace::Scope(span); + return internal::EndSpan(*span, child_->GetPreviewFeature(request)); +} + +StreamRange +PreviewFeaturesTracingConnection::ListPreviewFeatures( + google::cloud::cpp::compute::preview_features::v1:: + ListPreviewFeaturesRequest request) { + auto span = internal::MakeSpan( + "compute_preview_features_v1::PreviewFeaturesConnection::" + "ListPreviewFeatures"); + internal::OTelScope scope(span); + auto sr = child_->ListPreviewFeatures(std::move(request)); + return internal::MakeTracedStreamRange< + google::cloud::cpp::compute::v1::PreviewFeature>(std::move(span), + std::move(sr)); +} + +future> +PreviewFeaturesTracingConnection::UpdatePreviewFeature( + google::cloud::cpp::compute::preview_features::v1:: + UpdatePreviewFeatureRequest const& request) { + auto span = internal::MakeSpan( + "compute_preview_features_v1::PreviewFeaturesConnection::" + "UpdatePreviewFeature"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), + child_->UpdatePreviewFeature(request)); +} + +StatusOr +PreviewFeaturesTracingConnection::UpdatePreviewFeature( + NoAwaitTag, google::cloud::cpp::compute::preview_features::v1:: + UpdatePreviewFeatureRequest const& request) { + auto span = internal::MakeSpan( + "compute_preview_features_v1::PreviewFeaturesConnection::" + "UpdatePreviewFeature"); + opentelemetry::trace::Scope scope(span); + return internal::EndSpan(*span, + child_->UpdatePreviewFeature(NoAwaitTag{}, request)); +} + +future> +PreviewFeaturesTracingConnection::UpdatePreviewFeature( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto span = internal::MakeSpan( + "compute_preview_features_v1::PreviewFeaturesConnection::" + "UpdatePreviewFeature"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), + child_->UpdatePreviewFeature(operation)); +} + +std::shared_ptr +MakePreviewFeaturesTracingConnection( + std::shared_ptr + conn) { + if (internal::TracingEnabled(conn->options())) { + conn = std::make_shared(std::move(conn)); + } + return conn; +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_preview_features_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/preview_features/v1/internal/preview_features_tracing_connection.h b/google/cloud/compute/preview_features/v1/internal/preview_features_tracing_connection.h new file mode 100644 index 0000000000000..1fadd3f4c3871 --- /dev/null +++ b/google/cloud/compute/preview_features/v1/internal/preview_features_tracing_connection.h @@ -0,0 +1,83 @@ +// Copyright 2026 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. +// source: google/cloud/compute/preview_features/v1/preview_features.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_PREVIEW_FEATURES_V1_INTERNAL_PREVIEW_FEATURES_TRACING_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_PREVIEW_FEATURES_V1_INTERNAL_PREVIEW_FEATURES_TRACING_CONNECTION_H + +#include "google/cloud/compute/preview_features/v1/preview_features_connection.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_preview_features_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class PreviewFeaturesTracingConnection + : public compute_preview_features_v1::PreviewFeaturesConnection { + public: + ~PreviewFeaturesTracingConnection() override = default; + + explicit PreviewFeaturesTracingConnection( + std::shared_ptr + child); + + Options options() override { return child_->options(); } + + StatusOr GetPreviewFeature( + google::cloud::cpp::compute::preview_features::v1:: + GetPreviewFeatureRequest const& request) override; + + StreamRange + ListPreviewFeatures(google::cloud::cpp::compute::preview_features::v1:: + ListPreviewFeaturesRequest request) override; + + future> + UpdatePreviewFeature(google::cloud::cpp::compute::preview_features::v1:: + UpdatePreviewFeatureRequest const& request) override; + + StatusOr UpdatePreviewFeature( + NoAwaitTag, google::cloud::cpp::compute::preview_features::v1:: + UpdatePreviewFeatureRequest const& request) override; + + future> + UpdatePreviewFeature( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + private: + std::shared_ptr + child_; +}; + +/** + * Conditionally applies the tracing decorator to the given connection. + * + * The connection is only decorated if tracing is enabled (as determined by the + * connection's options). + */ +std::shared_ptr +MakePreviewFeaturesTracingConnection( + std::shared_ptr + conn); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_preview_features_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_PREVIEW_FEATURES_V1_INTERNAL_PREVIEW_FEATURES_TRACING_CONNECTION_H diff --git a/google/cloud/compute/preview_features/v1/mocks/mock_preview_features_connection.h b/google/cloud/compute/preview_features/v1/mocks/mock_preview_features_connection.h new file mode 100644 index 0000000000000..31e0b5dd5a96a --- /dev/null +++ b/google/cloud/compute/preview_features/v1/mocks/mock_preview_features_connection.h @@ -0,0 +1,109 @@ +// Copyright 2026 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. +// source: google/cloud/compute/preview_features/v1/preview_features.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_PREVIEW_FEATURES_V1_MOCKS_MOCK_PREVIEW_FEATURES_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_PREVIEW_FEATURES_V1_MOCKS_MOCK_PREVIEW_FEATURES_CONNECTION_H + +#include "google/cloud/compute/preview_features/v1/preview_features_connection.h" +#include + +namespace google { +namespace cloud { +namespace compute_preview_features_v1_mocks { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/** + * A class to mock `PreviewFeaturesConnection`. + * + * Application developers may want to test their code with simulated responses, + * including errors, from an object of type `PreviewFeaturesClient`. To do so, + * construct an object of type `PreviewFeaturesClient` with an instance of this + * class. Then use the Google Test framework functions to program the behavior + * of this mock. + * + * @see [This example][bq-mock] for how to test your application with GoogleTest. + * While the example showcases types from the BigQuery library, the underlying + * principles apply for any pair of `*Client` and `*Connection`. + * + * [bq-mock]: @cloud_cpp_docs_link{bigquery,bigquery-read-mock} + */ +class MockPreviewFeaturesConnection + : public compute_preview_features_v1::PreviewFeaturesConnection { + public: + MOCK_METHOD(Options, options, (), (override)); + + MOCK_METHOD(StatusOr, + GetPreviewFeature, + (google::cloud::cpp::compute::preview_features::v1:: + GetPreviewFeatureRequest const& request), + (override)); + + MOCK_METHOD((StreamRange), + ListPreviewFeatures, + (google::cloud::cpp::compute::preview_features::v1:: + ListPreviewFeaturesRequest request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// UpdatePreviewFeature(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + UpdatePreviewFeature, + (google::cloud::cpp::compute::preview_features::v1:: + UpdatePreviewFeatureRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// EXPECT_CALL(*mock, UpdatePreviewFeature(_, _)) + /// @endcode + MOCK_METHOD(StatusOr, + UpdatePreviewFeature, + (NoAwaitTag, google::cloud::cpp::compute::preview_features::v1:: + UpdatePreviewFeatureRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// UpdatePreviewFeature(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + UpdatePreviewFeature, + (google::cloud::cpp::compute::v1::Operation const& operation), + (override)); +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_preview_features_v1_mocks +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_PREVIEW_FEATURES_V1_MOCKS_MOCK_PREVIEW_FEATURES_CONNECTION_H diff --git a/google/cloud/compute/preview_features/v1/preview_features_client.cc b/google/cloud/compute/preview_features/v1/preview_features_client.cc new file mode 100644 index 0000000000000..41c505729a734 --- /dev/null +++ b/google/cloud/compute/preview_features/v1/preview_features_client.cc @@ -0,0 +1,134 @@ +// Copyright 2026 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. +// source: google/cloud/compute/preview_features/v1/preview_features.proto + +#include "google/cloud/compute/preview_features/v1/preview_features_client.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_preview_features_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +PreviewFeaturesClient::PreviewFeaturesClient( + std::shared_ptr connection, Options opts) + : connection_(std::move(connection)), + options_( + internal::MergeOptions(std::move(opts), connection_->options())) {} +PreviewFeaturesClient::~PreviewFeaturesClient() = default; + +StatusOr +PreviewFeaturesClient::GetPreviewFeature(std::string const& project, + std::string const& preview_feature, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::preview_features::v1::GetPreviewFeatureRequest + request; + request.set_project(project); + request.set_preview_feature(preview_feature); + return connection_->GetPreviewFeature(request); +} + +StatusOr +PreviewFeaturesClient::GetPreviewFeature( + google::cloud::cpp::compute::preview_features::v1:: + GetPreviewFeatureRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->GetPreviewFeature(request); +} + +StreamRange +PreviewFeaturesClient::ListPreviewFeatures(std::string const& project, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::preview_features::v1::ListPreviewFeaturesRequest + request; + request.set_project(project); + return connection_->ListPreviewFeatures(request); +} + +StreamRange +PreviewFeaturesClient::ListPreviewFeatures( + google::cloud::cpp::compute::preview_features::v1:: + ListPreviewFeaturesRequest request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->ListPreviewFeatures(std::move(request)); +} + +future> +PreviewFeaturesClient::UpdatePreviewFeature( + std::string const& project, std::string const& preview_feature, + google::cloud::cpp::compute::v1::PreviewFeature const& + preview_feature_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::preview_features::v1::UpdatePreviewFeatureRequest + request; + request.set_project(project); + request.set_preview_feature(preview_feature); + *request.mutable_preview_feature_resource() = preview_feature_resource; + return connection_->UpdatePreviewFeature(request); +} + +StatusOr +PreviewFeaturesClient::UpdatePreviewFeature( + NoAwaitTag, std::string const& project, std::string const& preview_feature, + google::cloud::cpp::compute::v1::PreviewFeature const& + preview_feature_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::preview_features::v1::UpdatePreviewFeatureRequest + request; + request.set_project(project); + request.set_preview_feature(preview_feature); + *request.mutable_preview_feature_resource() = preview_feature_resource; + return connection_->UpdatePreviewFeature(NoAwaitTag{}, request); +} + +future> +PreviewFeaturesClient::UpdatePreviewFeature( + google::cloud::cpp::compute::preview_features::v1:: + UpdatePreviewFeatureRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->UpdatePreviewFeature(request); +} + +StatusOr +PreviewFeaturesClient::UpdatePreviewFeature( + NoAwaitTag, + google::cloud::cpp::compute::preview_features::v1:: + UpdatePreviewFeatureRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->UpdatePreviewFeature(NoAwaitTag{}, request); +} + +future> +PreviewFeaturesClient::UpdatePreviewFeature( + google::cloud::cpp::compute::v1::Operation const& operation, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->UpdatePreviewFeature(operation); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_preview_features_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/preview_features/v1/preview_features_client.h b/google/cloud/compute/preview_features/v1/preview_features_client.h new file mode 100644 index 0000000000000..6edf9d655e62f --- /dev/null +++ b/google/cloud/compute/preview_features/v1/preview_features_client.h @@ -0,0 +1,366 @@ +// Copyright 2026 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. +// source: google/cloud/compute/preview_features/v1/preview_features.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_PREVIEW_FEATURES_V1_PREVIEW_FEATURES_CLIENT_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_PREVIEW_FEATURES_V1_PREVIEW_FEATURES_CLIENT_H + +#include "google/cloud/compute/preview_features/v1/preview_features_rest_connection.h" +#include "google/cloud/future.h" +#include "google/cloud/no_await_tag.h" +#include "google/cloud/options.h" +#include "google/cloud/polling_policy.h" +#include "google/cloud/status_or.h" +#include "google/cloud/version.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_preview_features_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/// +/// Service for the previewFeatures resource. +/// https://cloud.google.com/compute/docs/reference/rest/v1/previewFeatures +/// +/// @par Equality +/// +/// Instances of this class created via copy-construction or copy-assignment +/// always compare equal. Instances created with equal +/// `std::shared_ptr<*Connection>` objects compare equal. Objects that compare +/// equal share the same underlying resources. +/// +/// @par Performance +/// +/// Creating a new instance of this class is a relatively expensive operation, +/// new objects establish new connections to the service. In contrast, +/// copy-construction, move-construction, and the corresponding assignment +/// operations are relatively efficient as the copies share all underlying +/// resources. +/// +/// @par Thread Safety +/// +/// Concurrent access to different instances of this class, even if they compare +/// equal, is guaranteed to work. Two or more threads operating on the same +/// instance of this class is not guaranteed to work. Since copy-construction +/// and move-construction is a relatively efficient operation, consider using +/// such a copy when using this class from multiple threads. +/// +class PreviewFeaturesClient { + public: + explicit PreviewFeaturesClient( + std::shared_ptr connection, Options opts = {}); + ~PreviewFeaturesClient(); + + ///@{ + /// @name Copy and move support + PreviewFeaturesClient(PreviewFeaturesClient const&) = default; + PreviewFeaturesClient& operator=(PreviewFeaturesClient const&) = default; + PreviewFeaturesClient(PreviewFeaturesClient&&) = default; + PreviewFeaturesClient& operator=(PreviewFeaturesClient&&) = default; + ///@} + + ///@{ + /// @name Equality + friend bool operator==(PreviewFeaturesClient const& a, + PreviewFeaturesClient const& b) { + return a.connection_ == b.connection_; + } + friend bool operator!=(PreviewFeaturesClient const& a, + PreviewFeaturesClient const& b) { + return !(a == b); + } + ///@} + + // clang-format off + /// + /// Returns the details of the given PreviewFeature. + /// https://cloud.google.com/compute/docs/reference/rest/v1/previewFeatures/get + /// + /// @param project Project ID for this request. + /// @param preview_feature Name of the PreviewFeature for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.PreviewFeature]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.preview_features.v1.GetPreviewFeatureRequest]: @cloud_cpp_reference_link{google/cloud/compute/preview_features/v1/preview_features.proto#L76} + /// [google.cloud.cpp.compute.v1.PreviewFeature]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_030.proto#L56} + /// + // clang-format on + StatusOr GetPreviewFeature( + std::string const& project, std::string const& preview_feature, + Options opts = {}); + + // clang-format off + /// + /// Returns the details of the given PreviewFeature. + /// https://cloud.google.com/compute/docs/reference/rest/v1/previewFeatures/get + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.preview_features.v1.GetPreviewFeatureRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.PreviewFeature]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.preview_features.v1.GetPreviewFeatureRequest]: @cloud_cpp_reference_link{google/cloud/compute/preview_features/v1/preview_features.proto#L76} + /// [google.cloud.cpp.compute.v1.PreviewFeature]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_030.proto#L56} + /// + // clang-format on + StatusOr GetPreviewFeature( + google::cloud::cpp::compute::preview_features::v1:: + GetPreviewFeatureRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// Returns the details of the given PreviewFeature. + /// https://cloud.google.com/compute/docs/reference/rest/v1/previewFeatures/list + /// + /// @param project Project ID for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return a [StreamRange](@ref google::cloud::StreamRange) + /// to iterate of the results. See the documentation of this type for + /// details. In brief, this class has `begin()` and `end()` member + /// functions returning a iterator class meeting the + /// [input iterator requirements]. The value type for this iterator is a + /// [`StatusOr`] as the iteration may fail even after some values are + /// retrieved successfully, for example, if there is a network disconnect. + /// An empty set of results does not indicate an error, it indicates + /// that there are no resources meeting the request criteria. + /// On a successful iteration the `StatusOr` contains elements of type + /// [google.cloud.cpp.compute.v1.PreviewFeature], or rather, + /// the C++ class generated by Protobuf from that type. Please consult the + /// Protobuf documentation for details on the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.preview_features.v1.ListPreviewFeaturesRequest]: @cloud_cpp_reference_link{google/cloud/compute/preview_features/v1/preview_features.proto#L87} + /// [google.cloud.cpp.compute.v1.PreviewFeature]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_030.proto#L56} + /// + // clang-format on + StreamRange + ListPreviewFeatures(std::string const& project, Options opts = {}); + + // clang-format off + /// + /// Returns the details of the given PreviewFeature. + /// https://cloud.google.com/compute/docs/reference/rest/v1/previewFeatures/list + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.preview_features.v1.ListPreviewFeaturesRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return a [StreamRange](@ref google::cloud::StreamRange) + /// to iterate of the results. See the documentation of this type for + /// details. In brief, this class has `begin()` and `end()` member + /// functions returning a iterator class meeting the + /// [input iterator requirements]. The value type for this iterator is a + /// [`StatusOr`] as the iteration may fail even after some values are + /// retrieved successfully, for example, if there is a network disconnect. + /// An empty set of results does not indicate an error, it indicates + /// that there are no resources meeting the request criteria. + /// On a successful iteration the `StatusOr` contains elements of type + /// [google.cloud.cpp.compute.v1.PreviewFeature], or rather, + /// the C++ class generated by Protobuf from that type. Please consult the + /// Protobuf documentation for details on the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.preview_features.v1.ListPreviewFeaturesRequest]: @cloud_cpp_reference_link{google/cloud/compute/preview_features/v1/preview_features.proto#L87} + /// [google.cloud.cpp.compute.v1.PreviewFeature]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_030.proto#L56} + /// + // clang-format on + StreamRange + ListPreviewFeatures(google::cloud::cpp::compute::preview_features::v1:: + ListPreviewFeaturesRequest request, + Options opts = {}); + + // clang-format off + /// + /// Patches the given PreviewFeature. This method is used to enable or disable + /// a PreviewFeature. + /// https://cloud.google.com/compute/docs/reference/rest/v1/previewFeatures/update + /// + /// @param project Project ID for this request. + /// @param preview_feature Name of the PreviewFeature for this request. + /// @param preview_feature_resource The PreviewFeature for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.preview_features.v1.UpdatePreviewFeatureRequest]: @cloud_cpp_reference_link{google/cloud/compute/preview_features/v1/preview_features.proto#L188} + /// + // clang-format on + future> + UpdatePreviewFeature(std::string const& project, + std::string const& preview_feature, + google::cloud::cpp::compute::v1::PreviewFeature const& + preview_feature_resource, + Options opts = {}); + + // clang-format off + /// + /// @copybrief UpdatePreviewFeature + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr UpdatePreviewFeature( + NoAwaitTag, std::string const& project, + std::string const& preview_feature, + google::cloud::cpp::compute::v1::PreviewFeature const& + preview_feature_resource, + Options opts = {}); + + // clang-format off + /// + /// Patches the given PreviewFeature. This method is used to enable or disable + /// a PreviewFeature. + /// https://cloud.google.com/compute/docs/reference/rest/v1/previewFeatures/update + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.preview_features.v1.UpdatePreviewFeatureRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.preview_features.v1.UpdatePreviewFeatureRequest]: @cloud_cpp_reference_link{google/cloud/compute/preview_features/v1/preview_features.proto#L188} + /// + // clang-format on + future> + UpdatePreviewFeature(google::cloud::cpp::compute::preview_features::v1:: + UpdatePreviewFeatureRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief UpdatePreviewFeature + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr UpdatePreviewFeature( + NoAwaitTag, + google::cloud::cpp::compute::preview_features::v1:: + UpdatePreviewFeatureRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief UpdatePreviewFeature + /// + /// This method accepts a `google::cloud::cpp::compute::v1::Operation` that corresponds + /// to a previously started Long Running Operation (LRO) and polls the status + /// of the LRO in the background. + /// + // clang-format on + future> + UpdatePreviewFeature( + google::cloud::cpp::compute::v1::Operation const& operation, + Options opts = {}); + + private: + std::shared_ptr connection_; + Options options_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_preview_features_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_PREVIEW_FEATURES_V1_PREVIEW_FEATURES_CLIENT_H diff --git a/google/cloud/compute/preview_features/v1/preview_features_connection.cc b/google/cloud/compute/preview_features/v1/preview_features_connection.cc new file mode 100644 index 0000000000000..da43887bc43ff --- /dev/null +++ b/google/cloud/compute/preview_features/v1/preview_features_connection.cc @@ -0,0 +1,82 @@ +// Copyright 2026 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. +// source: google/cloud/compute/preview_features/v1/preview_features.proto + +#include "google/cloud/compute/preview_features/v1/preview_features_connection.h" +#include "google/cloud/compute/preview_features/v1/internal/preview_features_option_defaults.h" +#include "google/cloud/compute/preview_features/v1/internal/preview_features_tracing_connection.h" +#include "google/cloud/compute/preview_features/v1/preview_features_options.h" +#include "google/cloud/background_threads.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/grpc_options.h" +#include "google/cloud/internal/pagination_range.h" +#include "google/cloud/internal/unified_grpc_credentials.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_preview_features_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +PreviewFeaturesConnection::~PreviewFeaturesConnection() = default; + +StatusOr +PreviewFeaturesConnection::GetPreviewFeature( + google::cloud::cpp::compute::preview_features::v1:: + GetPreviewFeatureRequest const&) { + return Status(StatusCode::kUnimplemented, "not implemented"); +} + +StreamRange +PreviewFeaturesConnection::ListPreviewFeatures( + google::cloud::cpp::compute::preview_features::v1:: + ListPreviewFeaturesRequest) { // NOLINT(performance-unnecessary-value-param) + return google::cloud::internal::MakeUnimplementedPaginationRange< + StreamRange>(); +} + +future> +PreviewFeaturesConnection::UpdatePreviewFeature( + google::cloud::cpp::compute::preview_features::v1:: + UpdatePreviewFeatureRequest const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +PreviewFeaturesConnection::UpdatePreviewFeature( + NoAwaitTag, google::cloud::cpp::compute::preview_features::v1:: + UpdatePreviewFeatureRequest const&) { + return StatusOr( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +PreviewFeaturesConnection::UpdatePreviewFeature( + google::cloud::cpp::compute::v1::Operation const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_preview_features_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/preview_features/v1/preview_features_connection.h b/google/cloud/compute/preview_features/v1/preview_features_connection.h new file mode 100644 index 0000000000000..da51091d933de --- /dev/null +++ b/google/cloud/compute/preview_features/v1/preview_features_connection.h @@ -0,0 +1,217 @@ +// Copyright 2026 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. +// source: google/cloud/compute/preview_features/v1/preview_features.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_PREVIEW_FEATURES_V1_PREVIEW_FEATURES_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_PREVIEW_FEATURES_V1_PREVIEW_FEATURES_CONNECTION_H + +#include "google/cloud/compute/preview_features/v1/internal/preview_features_retry_traits.h" +#include "google/cloud/compute/preview_features/v1/preview_features.pb.h" +#include "google/cloud/compute/preview_features/v1/preview_features_connection_idempotency_policy.h" +#include "google/cloud/backoff_policy.h" +#include "google/cloud/future.h" +#include "google/cloud/internal/retry_policy_impl.h" +#include "google/cloud/no_await_tag.h" +#include "google/cloud/options.h" +#include "google/cloud/polling_policy.h" +#include "google/cloud/status_or.h" +#include "google/cloud/stream_range.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_preview_features_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/// The retry policy for `PreviewFeaturesConnection`. +class PreviewFeaturesRetryPolicy : public ::google::cloud::RetryPolicy { + public: + /// Creates a new instance of the policy, reset to the initial state. + virtual std::unique_ptr clone() const = 0; +}; + +/** + * A retry policy for `PreviewFeaturesConnection` based on counting errors. + * + * This policy stops retrying if: + * - An RPC returns a non-transient error. + * - More than a prescribed number of transient failures is detected. + * + * In this class the following status codes are treated as transient errors: + * - [`kUnavailable`](@ref google::cloud::StatusCode) + */ +class PreviewFeaturesLimitedErrorCountRetryPolicy + : public PreviewFeaturesRetryPolicy { + public: + /** + * Create an instance that tolerates up to @p maximum_failures transient + * errors. + * + * @note Disable the retry loop by providing an instance of this policy with + * @p maximum_failures == 0. + */ + explicit PreviewFeaturesLimitedErrorCountRetryPolicy(int maximum_failures) + : impl_(maximum_failures) {} + + PreviewFeaturesLimitedErrorCountRetryPolicy( + PreviewFeaturesLimitedErrorCountRetryPolicy&& rhs) noexcept + : PreviewFeaturesLimitedErrorCountRetryPolicy(rhs.maximum_failures()) {} + PreviewFeaturesLimitedErrorCountRetryPolicy( + PreviewFeaturesLimitedErrorCountRetryPolicy const& rhs) noexcept + : PreviewFeaturesLimitedErrorCountRetryPolicy(rhs.maximum_failures()) {} + + int maximum_failures() const { return impl_.maximum_failures(); } + + bool OnFailure(Status const& status) override { + return impl_.OnFailure(status); + } + bool IsExhausted() const override { return impl_.IsExhausted(); } + bool IsPermanentFailure(Status const& status) const override { + return impl_.IsPermanentFailure(status); + } + std::unique_ptr clone() const override { + return std::make_unique( + maximum_failures()); + } + + // This is provided only for backwards compatibility. + using BaseType = PreviewFeaturesRetryPolicy; + + private: + google::cloud::internal::LimitedErrorCountRetryPolicy< + compute_preview_features_v1_internal::PreviewFeaturesRetryTraits> + impl_; +}; + +/** + * A retry policy for `PreviewFeaturesConnection` based on elapsed time. + * + * This policy stops retrying if: + * - An RPC returns a non-transient error. + * - The elapsed time in the retry loop exceeds a prescribed duration. + * + * In this class the following status codes are treated as transient errors: + * - [`kUnavailable`](@ref google::cloud::StatusCode) + */ +class PreviewFeaturesLimitedTimeRetryPolicy + : public PreviewFeaturesRetryPolicy { + public: + /** + * Constructor given a `std::chrono::duration<>` object. + * + * @tparam DurationRep a placeholder to match the `Rep` tparam for @p + * duration's type. The semantics of this template parameter are + * documented in `std::chrono::duration<>`. In brief, the underlying + * arithmetic type used to store the number of ticks. For our purposes it + * is simply a formal parameter. + * @tparam DurationPeriod a placeholder to match the `Period` tparam for @p + * duration's type. The semantics of this template parameter are + * documented in `std::chrono::duration<>`. In brief, the length of the + * tick in seconds, expressed as a `std::ratio<>`. For our purposes it is + * simply a formal parameter. + * @param maximum_duration the maximum time allowed before the policy expires. + * While the application can express this time in any units they desire, + * the class truncates to milliseconds. + * + * @see https://en.cppreference.com/w/cpp/chrono/duration for more information + * about `std::chrono::duration`. + */ + template + explicit PreviewFeaturesLimitedTimeRetryPolicy( + std::chrono::duration maximum_duration) + : impl_(maximum_duration) {} + + PreviewFeaturesLimitedTimeRetryPolicy( + PreviewFeaturesLimitedTimeRetryPolicy&& rhs) noexcept + : PreviewFeaturesLimitedTimeRetryPolicy(rhs.maximum_duration()) {} + PreviewFeaturesLimitedTimeRetryPolicy( + PreviewFeaturesLimitedTimeRetryPolicy const& rhs) noexcept + : PreviewFeaturesLimitedTimeRetryPolicy(rhs.maximum_duration()) {} + + std::chrono::milliseconds maximum_duration() const { + return impl_.maximum_duration(); + } + + bool OnFailure(Status const& status) override { + return impl_.OnFailure(status); + } + bool IsExhausted() const override { return impl_.IsExhausted(); } + bool IsPermanentFailure(Status const& status) const override { + return impl_.IsPermanentFailure(status); + } + std::unique_ptr clone() const override { + return std::make_unique( + maximum_duration()); + } + + // This is provided only for backwards compatibility. + using BaseType = PreviewFeaturesRetryPolicy; + + private: + google::cloud::internal::LimitedTimeRetryPolicy< + compute_preview_features_v1_internal::PreviewFeaturesRetryTraits> + impl_; +}; + +/** + * The `PreviewFeaturesConnection` object for `PreviewFeaturesClient`. + * + * This interface defines virtual methods for each of the user-facing overload + * sets in `PreviewFeaturesClient`. This allows users to inject custom behavior + * (e.g., with a Google Mock object) when writing tests that use objects of type + * `PreviewFeaturesClient`. + * + * To create a concrete instance, see `MakePreviewFeaturesConnection()`. + * + * For mocking, see + * `compute_preview_features_v1_mocks::MockPreviewFeaturesConnection`. + */ +class PreviewFeaturesConnection { + public: + virtual ~PreviewFeaturesConnection() = 0; + + virtual Options options() { return Options{}; } + + virtual StatusOr + GetPreviewFeature(google::cloud::cpp::compute::preview_features::v1:: + GetPreviewFeatureRequest const& request); + + virtual StreamRange + ListPreviewFeatures(google::cloud::cpp::compute::preview_features::v1:: + ListPreviewFeaturesRequest request); + + virtual future> + UpdatePreviewFeature(google::cloud::cpp::compute::preview_features::v1:: + UpdatePreviewFeatureRequest const& request); + + virtual StatusOr + UpdatePreviewFeature(NoAwaitTag, + google::cloud::cpp::compute::preview_features::v1:: + UpdatePreviewFeatureRequest const& request); + + virtual future> + UpdatePreviewFeature( + google::cloud::cpp::compute::v1::Operation const& operation); +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_preview_features_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_PREVIEW_FEATURES_V1_PREVIEW_FEATURES_CONNECTION_H diff --git a/google/cloud/compute/preview_features/v1/preview_features_connection_idempotency_policy.cc b/google/cloud/compute/preview_features/v1/preview_features_connection_idempotency_policy.cc new file mode 100644 index 0000000000000..ddf109acdab2f --- /dev/null +++ b/google/cloud/compute/preview_features/v1/preview_features_connection_idempotency_policy.cc @@ -0,0 +1,63 @@ +// Copyright 2026 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. +// source: google/cloud/compute/preview_features/v1/preview_features.proto + +#include "google/cloud/compute/preview_features/v1/preview_features_connection_idempotency_policy.h" +#include + +namespace google { +namespace cloud { +namespace compute_preview_features_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +using ::google::cloud::Idempotency; + +PreviewFeaturesConnectionIdempotencyPolicy:: + ~PreviewFeaturesConnectionIdempotencyPolicy() = default; + +std::unique_ptr +PreviewFeaturesConnectionIdempotencyPolicy::clone() const { + return std::make_unique(*this); +} + +Idempotency PreviewFeaturesConnectionIdempotencyPolicy::GetPreviewFeature( + google::cloud::cpp::compute::preview_features::v1:: + GetPreviewFeatureRequest const&) { + return Idempotency::kIdempotent; +} + +Idempotency PreviewFeaturesConnectionIdempotencyPolicy::ListPreviewFeatures( + google::cloud::cpp::compute::preview_features::v1:: + ListPreviewFeaturesRequest) { // NOLINT + return Idempotency::kIdempotent; +} + +Idempotency PreviewFeaturesConnectionIdempotencyPolicy::UpdatePreviewFeature( + google::cloud::cpp::compute::preview_features::v1:: + UpdatePreviewFeatureRequest const&) { + return Idempotency::kNonIdempotent; +} + +std::unique_ptr +MakeDefaultPreviewFeaturesConnectionIdempotencyPolicy() { + return std::make_unique(); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_preview_features_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/preview_features/v1/preview_features_connection_idempotency_policy.h b/google/cloud/compute/preview_features/v1/preview_features_connection_idempotency_policy.h new file mode 100644 index 0000000000000..5479d25ea7050 --- /dev/null +++ b/google/cloud/compute/preview_features/v1/preview_features_connection_idempotency_policy.h @@ -0,0 +1,61 @@ +// Copyright 2026 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. +// source: google/cloud/compute/preview_features/v1/preview_features.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_PREVIEW_FEATURES_V1_PREVIEW_FEATURES_CONNECTION_IDEMPOTENCY_POLICY_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_PREVIEW_FEATURES_V1_PREVIEW_FEATURES_CONNECTION_IDEMPOTENCY_POLICY_H + +#include "google/cloud/compute/preview_features/v1/preview_features.pb.h" +#include "google/cloud/idempotency.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_preview_features_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class PreviewFeaturesConnectionIdempotencyPolicy { + public: + virtual ~PreviewFeaturesConnectionIdempotencyPolicy(); + + /// Create a new copy of this object. + virtual std::unique_ptr clone() + const; + + virtual google::cloud::Idempotency GetPreviewFeature( + google::cloud::cpp::compute::preview_features::v1:: + GetPreviewFeatureRequest const& request); + + virtual google::cloud::Idempotency ListPreviewFeatures( + google::cloud::cpp::compute::preview_features::v1:: + ListPreviewFeaturesRequest request); + + virtual google::cloud::Idempotency UpdatePreviewFeature( + google::cloud::cpp::compute::preview_features::v1:: + UpdatePreviewFeatureRequest const& request); +}; + +std::unique_ptr +MakeDefaultPreviewFeaturesConnectionIdempotencyPolicy(); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_preview_features_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_PREVIEW_FEATURES_V1_PREVIEW_FEATURES_CONNECTION_IDEMPOTENCY_POLICY_H diff --git a/google/cloud/compute/preview_features/v1/preview_features_options.h b/google/cloud/compute/preview_features/v1/preview_features_options.h new file mode 100644 index 0000000000000..06996b3e9015c --- /dev/null +++ b/google/cloud/compute/preview_features/v1/preview_features_options.h @@ -0,0 +1,87 @@ +// Copyright 2026 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. +// source: google/cloud/compute/preview_features/v1/preview_features.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_PREVIEW_FEATURES_V1_PREVIEW_FEATURES_OPTIONS_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_PREVIEW_FEATURES_V1_PREVIEW_FEATURES_OPTIONS_H + +#include "google/cloud/compute/preview_features/v1/preview_features_connection.h" +#include "google/cloud/compute/preview_features/v1/preview_features_connection_idempotency_policy.h" +#include "google/cloud/backoff_policy.h" +#include "google/cloud/options.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_preview_features_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/** + * Use with `google::cloud::Options` to configure the retry policy. + * + * @ingroup google-cloud-compute-options + */ +struct PreviewFeaturesRetryPolicyOption { + using Type = std::shared_ptr; +}; + +/** + * Use with `google::cloud::Options` to configure the backoff policy. + * + * @ingroup google-cloud-compute-options + */ +struct PreviewFeaturesBackoffPolicyOption { + using Type = std::shared_ptr; +}; + +/** + * Use with `google::cloud::Options` to configure which operations are retried. + * + * @ingroup google-cloud-compute-options + */ +struct PreviewFeaturesConnectionIdempotencyPolicyOption { + using Type = std::shared_ptr; +}; + +/** + * Use with `google::cloud::Options` to configure the long-running operations + * polling policy. + * + * @ingroup google-cloud-compute-options + */ +struct PreviewFeaturesPollingPolicyOption { + using Type = std::shared_ptr; +}; + +/** + * The options applicable to PreviewFeatures. + * + * @ingroup google-cloud-compute-options + */ +using PreviewFeaturesPolicyOptionList = + OptionList; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_preview_features_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_PREVIEW_FEATURES_V1_PREVIEW_FEATURES_OPTIONS_H diff --git a/google/cloud/compute/preview_features/v1/preview_features_proto_export.h b/google/cloud/compute/preview_features/v1/preview_features_proto_export.h new file mode 100644 index 0000000000000..26dcddf4218db --- /dev/null +++ b/google/cloud/compute/preview_features/v1/preview_features_proto_export.h @@ -0,0 +1,33 @@ +// Copyright 2026 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_PREVIEW_FEATURES_V1_PREVIEW_FEATURES_PROTO_EXPORT_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_PREVIEW_FEATURES_V1_PREVIEW_FEATURES_PROTO_EXPORT_H + +// IWYU pragma: begin_exports +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_030.pb.h" +// IWYU pragma: end_exports + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_PREVIEW_FEATURES_V1_PREVIEW_FEATURES_PROTO_EXPORT_H diff --git a/google/cloud/compute/preview_features/v1/preview_features_rest_connection.cc b/google/cloud/compute/preview_features/v1/preview_features_rest_connection.cc new file mode 100644 index 0000000000000..a1a27d2278a4d --- /dev/null +++ b/google/cloud/compute/preview_features/v1/preview_features_rest_connection.cc @@ -0,0 +1,59 @@ +// Copyright 2026 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. +// source: google/cloud/compute/preview_features/v1/preview_features.proto + +#include "google/cloud/compute/preview_features/v1/preview_features_rest_connection.h" +#include "google/cloud/compute/preview_features/v1/internal/preview_features_option_defaults.h" +#include "google/cloud/compute/preview_features/v1/internal/preview_features_rest_connection_impl.h" +#include "google/cloud/compute/preview_features/v1/internal/preview_features_rest_stub_factory.h" +#include "google/cloud/compute/preview_features/v1/internal/preview_features_tracing_connection.h" +#include "google/cloud/compute/preview_features/v1/preview_features_options.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/internal/rest_background_threads_impl.h" +#include "google/cloud/internal/rest_options.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_preview_features_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +std::shared_ptr MakePreviewFeaturesConnectionRest( + Options options) { + internal::CheckExpectedOptions< + CommonOptionList, RestOptionList, UnifiedCredentialsOptionList, + rest_internal::TargetApiVersionOption, PreviewFeaturesPolicyOptionList>( + options, __func__); + options = compute_preview_features_v1_internal::PreviewFeaturesDefaultOptions( + std::move(options)); + auto background = std::make_unique< + rest_internal::AutomaticallyCreatedRestBackgroundThreads>(); + auto stub = compute_preview_features_v1_internal:: + CreateDefaultPreviewFeaturesRestStub(options); + return compute_preview_features_v1_internal:: + MakePreviewFeaturesTracingConnection( + std::make_shared( + std::move(background), std::move(stub), std::move(options))); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_preview_features_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/preview_features/v1/preview_features_rest_connection.h b/google/cloud/compute/preview_features/v1/preview_features_rest_connection.h new file mode 100644 index 0000000000000..ad920a1874e72 --- /dev/null +++ b/google/cloud/compute/preview_features/v1/preview_features_rest_connection.h @@ -0,0 +1,65 @@ +// Copyright 2026 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. +// source: google/cloud/compute/preview_features/v1/preview_features.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_PREVIEW_FEATURES_V1_PREVIEW_FEATURES_REST_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_PREVIEW_FEATURES_V1_PREVIEW_FEATURES_REST_CONNECTION_H + +#include "google/cloud/compute/preview_features/v1/preview_features_connection.h" +#include "google/cloud/options.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_preview_features_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/** + * A factory function to construct an object of type `PreviewFeaturesConnection` + * that uses REST over HTTP as transport in lieu of gRPC. REST transport should + * only be used for services that do not support gRPC or if the existing network + * configuration precludes using gRPC. + * + * The returned connection object should not be used directly; instead it + * should be passed as an argument to the constructor of PreviewFeaturesClient. + * + * The optional @p options argument may be used to configure aspects of the + * returned `PreviewFeaturesConnection`. Expected options are any of the types + * in the following option lists: + * + * - `google::cloud::CommonOptionList` + * - `google::cloud::RestOptionList` + * - `google::cloud::UnifiedCredentialsOptionList` + * - + * `google::cloud::compute_preview_features_v1::PreviewFeaturesPolicyOptionList` + * + * @note Unexpected options will be ignored. To log unexpected options instead, + * set `GOOGLE_CLOUD_CPP_ENABLE_CLOG=yes` in the environment. + * + * @param options (optional) Configure the `PreviewFeaturesConnection` created + * by this function. + */ +std::shared_ptr MakePreviewFeaturesConnectionRest( + Options options = {}); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_preview_features_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_PREVIEW_FEATURES_V1_PREVIEW_FEATURES_REST_CONNECTION_H diff --git a/google/cloud/compute/preview_features/v1/samples/preview_features_client_samples.cc b/google/cloud/compute/preview_features/v1/samples/preview_features_client_samples.cc new file mode 100644 index 0000000000000..52cf0b558c294 --- /dev/null +++ b/google/cloud/compute/preview_features/v1/samples/preview_features_client_samples.cc @@ -0,0 +1,239 @@ +// Copyright 2026 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. +// source: google/cloud/compute/preview_features/v1/preview_features.proto + +#include "google/cloud/compute/preview_features/v1/preview_features_client.h" +#include "google/cloud/compute/preview_features/v1/preview_features_connection_idempotency_policy.h" +#include "google/cloud/compute/preview_features/v1/preview_features_options.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/internal/getenv.h" +#include "google/cloud/polling_policy.h" +#include "google/cloud/testing_util/example_driver.h" +#include "google/cloud/universe_domain.h" +#include +#include +#include +#include + +// clang-format off +// main-dox-marker: compute_preview_features_v1::PreviewFeaturesClient +// lro-marker: true +// clang-format on +namespace { + +void SetClientEndpoint(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-endpoint"}; + } + //! [set-client-endpoint] + // This configuration is common with Private Google Access: + // https://cloud.google.com/vpc/docs/private-google-access + auto options = google::cloud::Options{}.set( + "private.googleapis.com"); + auto vpc_client = + google::cloud::compute_preview_features_v1::PreviewFeaturesClient( + google::cloud::compute_preview_features_v1:: + MakePreviewFeaturesConnectionRest(options)); + //! [set-client-endpoint] +} + +void SetClientUniverseDomain(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-universe-domain"}; + } + //! [set-client-universe-domain] + google::cloud::Options options; + + // AddUniverseDomainOption interrogates the UnifiedCredentialsOption, if set, + // in the provided Options for the Universe Domain associated with the + // credentials and adds it to the set of Options. + // If no UnifiedCredentialsOption is set, GoogleDefaultCredentials are used. + auto ud_options = google::cloud::AddUniverseDomainOption(std::move(options)); + + if (!ud_options.ok()) throw std::move(ud_options).status(); + auto ud_client = + google::cloud::compute_preview_features_v1::PreviewFeaturesClient( + google::cloud::compute_preview_features_v1:: + MakePreviewFeaturesConnectionRest(*ud_options)); + //! [set-client-universe-domain] +} + +//! [custom-idempotency-policy] +class CustomIdempotencyPolicy + : public google::cloud::compute_preview_features_v1:: + PreviewFeaturesConnectionIdempotencyPolicy { + public: + ~CustomIdempotencyPolicy() override = default; + std::unique_ptr + clone() const override { + return std::make_unique(*this); + } + // Override inherited functions to define as needed. +}; +//! [custom-idempotency-policy] + +void SetRetryPolicy(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-retry-policy"}; + } + //! [set-retry-policy] + auto options = google::cloud::Options{} + .set( + CustomIdempotencyPolicy().clone()) + .set( + google::cloud::compute_preview_features_v1:: + PreviewFeaturesLimitedErrorCountRetryPolicy(3) + .clone()) + .set( + google::cloud::ExponentialBackoffPolicy( + /*initial_delay=*/std::chrono::milliseconds(200), + /*maximum_delay=*/std::chrono::seconds(45), + /*scaling=*/2.0) + .clone()); + auto connection = google::cloud::compute_preview_features_v1:: + MakePreviewFeaturesConnectionRest(options); + + // c1 and c2 share the same retry policies + auto c1 = google::cloud::compute_preview_features_v1::PreviewFeaturesClient( + connection); + auto c2 = google::cloud::compute_preview_features_v1::PreviewFeaturesClient( + connection); + + // You can override any of the policies in a new client. This new client + // will share the policies from c1 (or c2) *except* for the retry policy. + auto c3 = google::cloud::compute_preview_features_v1::PreviewFeaturesClient( + connection, + google::cloud::Options{} + .set( + google::cloud::compute_preview_features_v1:: + PreviewFeaturesLimitedTimeRetryPolicy(std::chrono::minutes(5)) + .clone())); + + // You can also override the policies in a single call: + // c3.SomeRpc(..., google::cloud::Options{} + // .set( + // google::cloud::compute_preview_features_v1::PreviewFeaturesLimitedErrorCountRetryPolicy(10).clone())); + //! [set-retry-policy] +} + +void SetPollingPolicy(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-policy-policy"}; + } + //! [set-polling-policy] + + // The polling policy controls how the client waits for long-running + // operations. `GenericPollingPolicy<>` combines existing policies. + // In this case, keep polling until the operation completes (with success + // or error) or 45 minutes, whichever happens first. Initially pause for + // 10 seconds between polling requests, increasing the pause by a factor + // of 4 until it becomes 2 minutes. + auto options = + google::cloud::Options{} + .set( + google::cloud::GenericPollingPolicy< + google::cloud::compute_preview_features_v1:: + PreviewFeaturesRetryPolicyOption::Type, + google::cloud::compute_preview_features_v1:: + PreviewFeaturesBackoffPolicyOption::Type>( + google::cloud::compute_preview_features_v1:: + PreviewFeaturesLimitedTimeRetryPolicy( + /*maximum_duration=*/std::chrono::minutes(45)) + .clone(), + google::cloud::ExponentialBackoffPolicy( + /*initial_delay=*/std::chrono::seconds(10), + /*maximum_delay=*/std::chrono::minutes(2), + /*scaling=*/4.0) + .clone()) + .clone()); + + auto connection = google::cloud::compute_preview_features_v1:: + MakePreviewFeaturesConnectionRest(options); + + // c1 and c2 share the same polling policies. + auto c1 = google::cloud::compute_preview_features_v1::PreviewFeaturesClient( + connection); + auto c2 = google::cloud::compute_preview_features_v1::PreviewFeaturesClient( + connection); + //! [set-polling-policy] +} + +void WithServiceAccount(std::vector const& argv) { + if (argv.size() != 1 || argv[0] == "--help") { + throw google::cloud::testing_util::Usage{"with-service-account "}; + } + //! [with-service-account] + [](std::string const& keyfile) { + auto is = std::ifstream(keyfile); + is.exceptions(std::ios::badbit); // Minimal error handling in examples + auto contents = std::string(std::istreambuf_iterator(is.rdbuf()), {}); + auto options = + google::cloud::Options{}.set( + google::cloud::MakeServiceAccountCredentials(contents)); + return google::cloud::compute_preview_features_v1::PreviewFeaturesClient( + google::cloud::compute_preview_features_v1:: + MakePreviewFeaturesConnectionRest(options)); + } + //! [with-service-account] + (argv.at(0)); +} + +void AutoRun(std::vector const& argv) { + namespace examples = ::google::cloud::testing_util; + using ::google::cloud::internal::GetEnv; + if (!argv.empty()) throw examples::Usage{"auto"}; + examples::CheckEnvironmentVariablesAreSet( + {"GOOGLE_CLOUD_CPP_TEST_SERVICE_ACCOUNT_KEYFILE"}); + auto const keyfile = + GetEnv("GOOGLE_CLOUD_CPP_TEST_SERVICE_ACCOUNT_KEYFILE").value(); + + std::cout << "\nRunning SetClientEndpoint() example" << std::endl; + SetClientEndpoint({}); + + std::cout << "\nRunning SetRetryPolicy() example" << std::endl; + SetRetryPolicy({}); + + std::cout << "\nRunning SetPollingPolicy() example" << std::endl; + SetPollingPolicy({}); + + std::cout << "\nRunning WithServiceAccount() example" << std::endl; + WithServiceAccount({keyfile}); + + std::cout << "\nRunning SetClientUniverseDomain() example" << std::endl; + SetClientUniverseDomain({}); +} + +} // namespace + +int main(int argc, char* argv[]) { // NOLINT(bugprone-exception-escape) + google::cloud::testing_util::Example example({ + {"set-client-endpoint", SetClientEndpoint}, + {"set-retry-policy", SetRetryPolicy}, + {"set-polling-policy", SetPollingPolicy}, + {"with-service-account", WithServiceAccount}, + {"set-client-universe-domain", SetClientUniverseDomain}, + {"auto", AutoRun}, + }); + return example.Run(argc, argv); +} diff --git a/google/cloud/compute/projects/v1/projects_client.h b/google/cloud/compute/projects/v1/projects_client.h index 00aa38a8c06e7..882e9e070ba90 100644 --- a/google/cloud/compute/projects/v1/projects_client.h +++ b/google/cloud/compute/projects/v1/projects_client.h @@ -111,7 +111,7 @@ class ProjectsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.projects.v1.DisableXpnHostRequest]: @cloud_cpp_reference_link{google/cloud/compute/projects/v1/projects.proto#L237} + /// [google.cloud.cpp.compute.projects.v1.DisableXpnHostRequest]: @cloud_cpp_reference_link{google/cloud/compute/projects/v1/projects.proto#L256} /// // clang-format on future> DisableXpnHost( @@ -162,7 +162,7 @@ class ProjectsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.projects.v1.DisableXpnHostRequest]: @cloud_cpp_reference_link{google/cloud/compute/projects/v1/projects.proto#L237} + /// [google.cloud.cpp.compute.projects.v1.DisableXpnHostRequest]: @cloud_cpp_reference_link{google/cloud/compute/projects/v1/projects.proto#L256} /// // clang-format on future> DisableXpnHost( @@ -228,7 +228,7 @@ class ProjectsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.projects.v1.DisableXpnResourceRequest]: @cloud_cpp_reference_link{google/cloud/compute/projects/v1/projects.proto#L259} + /// [google.cloud.cpp.compute.projects.v1.DisableXpnResourceRequest]: @cloud_cpp_reference_link{google/cloud/compute/projects/v1/projects.proto#L281} /// // clang-format on future> @@ -287,7 +287,7 @@ class ProjectsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.projects.v1.DisableXpnResourceRequest]: @cloud_cpp_reference_link{google/cloud/compute/projects/v1/projects.proto#L259} + /// [google.cloud.cpp.compute.projects.v1.DisableXpnResourceRequest]: @cloud_cpp_reference_link{google/cloud/compute/projects/v1/projects.proto#L281} /// // clang-format on future> @@ -352,7 +352,7 @@ class ProjectsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.projects.v1.EnableXpnHostRequest]: @cloud_cpp_reference_link{google/cloud/compute/projects/v1/projects.proto#L286} + /// [google.cloud.cpp.compute.projects.v1.EnableXpnHostRequest]: @cloud_cpp_reference_link{google/cloud/compute/projects/v1/projects.proto#L311} /// // clang-format on future> EnableXpnHost( @@ -403,7 +403,7 @@ class ProjectsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.projects.v1.EnableXpnHostRequest]: @cloud_cpp_reference_link{google/cloud/compute/projects/v1/projects.proto#L286} + /// [google.cloud.cpp.compute.projects.v1.EnableXpnHostRequest]: @cloud_cpp_reference_link{google/cloud/compute/projects/v1/projects.proto#L311} /// // clang-format on future> EnableXpnHost( @@ -470,7 +470,7 @@ class ProjectsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.projects.v1.EnableXpnResourceRequest]: @cloud_cpp_reference_link{google/cloud/compute/projects/v1/projects.proto#L308} + /// [google.cloud.cpp.compute.projects.v1.EnableXpnResourceRequest]: @cloud_cpp_reference_link{google/cloud/compute/projects/v1/projects.proto#L336} /// // clang-format on future> @@ -530,7 +530,7 @@ class ProjectsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.projects.v1.EnableXpnResourceRequest]: @cloud_cpp_reference_link{google/cloud/compute/projects/v1/projects.proto#L308} + /// [google.cloud.cpp.compute.projects.v1.EnableXpnResourceRequest]: @cloud_cpp_reference_link{google/cloud/compute/projects/v1/projects.proto#L336} /// // clang-format on future> @@ -571,13 +571,15 @@ class ProjectsClient { // clang-format off /// - /// 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. + /// 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. /// https://cloud.google.com/compute/docs/reference/rest/v1/projects/get /// /// @param project Project ID for this request. @@ -594,8 +596,8 @@ class ProjectsClient { /// [`future`]: @ref google::cloud::future /// [`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_025.proto#L60} + /// [google.cloud.cpp.compute.projects.v1.GetProjectRequest]: @cloud_cpp_reference_link{google/cloud/compute/projects/v1/projects.proto#L366} + /// [google.cloud.cpp.compute.v1.Project]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_034.proto#L70} /// // clang-format on StatusOr GetProject( @@ -603,13 +605,15 @@ class ProjectsClient { // clang-format off /// - /// 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. + /// 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. /// https://cloud.google.com/compute/docs/reference/rest/v1/projects/get /// /// @param request Unary RPCs, such as the one wrapped by this @@ -631,8 +635,8 @@ class ProjectsClient { /// [`future`]: @ref google::cloud::future /// [`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_025.proto#L60} + /// [google.cloud.cpp.compute.projects.v1.GetProjectRequest]: @cloud_cpp_reference_link{google/cloud/compute/projects/v1/projects.proto#L366} + /// [google.cloud.cpp.compute.v1.Project]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_034.proto#L70} /// // clang-format on StatusOr GetProject( @@ -660,8 +664,8 @@ class ProjectsClient { /// [`future`]: @ref google::cloud::future /// [`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_025.proto#L60} + /// [google.cloud.cpp.compute.projects.v1.GetXpnHostRequest]: @cloud_cpp_reference_link{google/cloud/compute/projects/v1/projects.proto#L373} + /// [google.cloud.cpp.compute.v1.Project]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_034.proto#L70} /// // clang-format on StatusOr GetXpnHost( @@ -692,8 +696,8 @@ class ProjectsClient { /// [`future`]: @ref google::cloud::future /// [`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_025.proto#L60} + /// [google.cloud.cpp.compute.projects.v1.GetXpnHostRequest]: @cloud_cpp_reference_link{google/cloud/compute/projects/v1/projects.proto#L373} + /// [google.cloud.cpp.compute.v1.Project]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_034.proto#L70} /// // clang-format on StatusOr GetXpnHost( @@ -721,8 +725,8 @@ class ProjectsClient { /// [`future`]: @ref google::cloud::future /// [`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_025.proto#L148} + /// [google.cloud.cpp.compute.projects.v1.GetXpnResourcesRequest]: @cloud_cpp_reference_link{google/cloud/compute/projects/v1/projects.proto#L380} + /// [google.cloud.cpp.compute.v1.ProjectsGetXpnResources]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_034.proto#L168} /// // clang-format on StatusOr @@ -753,8 +757,8 @@ class ProjectsClient { /// [`future`]: @ref google::cloud::future /// [`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_025.proto#L148} + /// [google.cloud.cpp.compute.projects.v1.GetXpnResourcesRequest]: @cloud_cpp_reference_link{google/cloud/compute/projects/v1/projects.proto#L380} + /// [google.cloud.cpp.compute.v1.ProjectsGetXpnResources]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_034.proto#L168} /// // clang-format on StatusOr @@ -792,8 +796,8 @@ class ProjectsClient { /// [`future`]: @ref google::cloud::future /// [`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_025.proto#L60} + /// [google.cloud.cpp.compute.projects.v1.ListXpnHostsRequest]: @cloud_cpp_reference_link{google/cloud/compute/projects/v1/projects.proto#L481} + /// [google.cloud.cpp.compute.v1.Project]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_034.proto#L70} /// // clang-format on StreamRange ListXpnHosts( @@ -835,8 +839,8 @@ class ProjectsClient { /// [`future`]: @ref google::cloud::future /// [`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_025.proto#L60} + /// [google.cloud.cpp.compute.projects.v1.ListXpnHostsRequest]: @cloud_cpp_reference_link{google/cloud/compute/projects/v1/projects.proto#L481} + /// [google.cloud.cpp.compute.v1.Project]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_034.proto#L70} /// // clang-format on StreamRange ListXpnHosts( @@ -846,6 +850,19 @@ class ProjectsClient { // clang-format off /// /// Moves a persistent disk from one zone to another. + /// *Note*: The moveDisk API will be deprecated on September 29, 2026. + /// + /// Starting September 29, 2025, you can't use the moveDisk API on new + /// projects. To move a disk to a different region or zone, follow the steps in + /// [Change the location of a + /// disk](https://cloud.google.com/compute/docs/disks/migrate-to-hyperdisk#migrate-to-hd). + /// + /// Projects that already use the moveDisk API can continue usage until + /// September 29, 2026. + /// + /// Starting November 1, 2025, API responses will include a warning message in + /// the response body about the upcoming deprecation. You can skip the message + /// to continue using the service without interruption. /// https://cloud.google.com/compute/docs/reference/rest/v1/projects/moveDisk /// /// @param project Project ID for this request. @@ -870,7 +887,7 @@ class ProjectsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.projects.v1.MoveDiskRequest]: @cloud_cpp_reference_link{google/cloud/compute/projects/v1/projects.proto#L490} + /// [google.cloud.cpp.compute.projects.v1.MoveDiskRequest]: @cloud_cpp_reference_link{google/cloud/compute/projects/v1/projects.proto#L587} /// // clang-format on future> MoveDisk( @@ -899,6 +916,19 @@ class ProjectsClient { // clang-format off /// /// Moves a persistent disk from one zone to another. + /// *Note*: The moveDisk API will be deprecated on September 29, 2026. + /// + /// Starting September 29, 2025, you can't use the moveDisk API on new + /// projects. To move a disk to a different region or zone, follow the steps in + /// [Change the location of a + /// disk](https://cloud.google.com/compute/docs/disks/migrate-to-hyperdisk#migrate-to-hd). + /// + /// Projects that already use the moveDisk API can continue usage until + /// September 29, 2026. + /// + /// Starting November 1, 2025, API responses will include a warning message in + /// the response body about the upcoming deprecation. You can skip the message + /// to continue using the service without interruption. /// https://cloud.google.com/compute/docs/reference/rest/v1/projects/moveDisk /// /// @param request Unary RPCs, such as the one wrapped by this @@ -927,7 +957,7 @@ class ProjectsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.projects.v1.MoveDiskRequest]: @cloud_cpp_reference_link{google/cloud/compute/projects/v1/projects.proto#L490} + /// [google.cloud.cpp.compute.projects.v1.MoveDiskRequest]: @cloud_cpp_reference_link{google/cloud/compute/projects/v1/projects.proto#L587} /// // clang-format on future> MoveDisk( @@ -966,11 +996,14 @@ class ProjectsClient { // clang-format off /// /// 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). + /// another. + /// *Note*: Moving VMs or disks by using this method might + /// cause unexpected behavior. For more information, see the [known + /// + /// issue](https://cloud.google.com/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. + /// zones](https://cloud.google.com/compute/docs/instances/moving-instance-across-zones) + /// instead. /// https://cloud.google.com/compute/docs/reference/rest/v1/projects/moveInstance /// /// @param project Project ID for this request. @@ -995,7 +1028,7 @@ class ProjectsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.projects.v1.MoveInstanceRequest]: @cloud_cpp_reference_link{google/cloud/compute/projects/v1/projects.proto#L516} + /// [google.cloud.cpp.compute.projects.v1.MoveInstanceRequest]: @cloud_cpp_reference_link{google/cloud/compute/projects/v1/projects.proto#L616} /// // clang-format on future> MoveInstance( @@ -1024,11 +1057,14 @@ class ProjectsClient { // clang-format off /// /// 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). + /// another. + /// *Note*: Moving VMs or disks by using this method might + /// cause unexpected behavior. For more information, see the [known + /// + /// issue](https://cloud.google.com/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. + /// zones](https://cloud.google.com/compute/docs/instances/moving-instance-across-zones) + /// instead. /// https://cloud.google.com/compute/docs/reference/rest/v1/projects/moveInstance /// /// @param request Unary RPCs, such as the one wrapped by this @@ -1057,7 +1093,7 @@ class ProjectsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.projects.v1.MoveInstanceRequest]: @cloud_cpp_reference_link{google/cloud/compute/projects/v1/projects.proto#L516} + /// [google.cloud.cpp.compute.projects.v1.MoveInstanceRequest]: @cloud_cpp_reference_link{google/cloud/compute/projects/v1/projects.proto#L616} /// // clang-format on future> MoveInstance( @@ -1099,7 +1135,8 @@ class ProjectsClient { /// /// 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. + /// Enterprise. See Subscribing + /// to Cloud Armor Enterprise for more information. /// https://cloud.google.com/compute/docs/reference/rest/v1/projects/setCloudArmorTier /// /// @param project Project ID for this request. @@ -1124,7 +1161,7 @@ class ProjectsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.projects.v1.SetCloudArmorTierRequest]: @cloud_cpp_reference_link{google/cloud/compute/projects/v1/projects.proto#L542} + /// [google.cloud.cpp.compute.projects.v1.SetCloudArmorTierRequest]: @cloud_cpp_reference_link{google/cloud/compute/projects/v1/projects.proto#L645} /// // clang-format on future> @@ -1155,7 +1192,8 @@ class ProjectsClient { /// /// 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. + /// Enterprise. See Subscribing + /// to Cloud Armor Enterprise for more information. /// https://cloud.google.com/compute/docs/reference/rest/v1/projects/setCloudArmorTier /// /// @param request Unary RPCs, such as the one wrapped by this @@ -1184,7 +1222,7 @@ class ProjectsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.projects.v1.SetCloudArmorTierRequest]: @cloud_cpp_reference_link{google/cloud/compute/projects/v1/projects.proto#L542} + /// [google.cloud.cpp.compute.projects.v1.SetCloudArmorTierRequest]: @cloud_cpp_reference_link{google/cloud/compute/projects/v1/projects.proto#L645} /// // clang-format on future> @@ -1251,7 +1289,7 @@ class ProjectsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.projects.v1.SetCommonInstanceMetadataRequest]: @cloud_cpp_reference_link{google/cloud/compute/projects/v1/projects.proto#L569} + /// [google.cloud.cpp.compute.projects.v1.SetCommonInstanceMetadataRequest]: @cloud_cpp_reference_link{google/cloud/compute/projects/v1/projects.proto#L675} /// // clang-format on future> @@ -1309,7 +1347,7 @@ class ProjectsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.projects.v1.SetCommonInstanceMetadataRequest]: @cloud_cpp_reference_link{google/cloud/compute/projects/v1/projects.proto#L569} + /// [google.cloud.cpp.compute.projects.v1.SetCommonInstanceMetadataRequest]: @cloud_cpp_reference_link{google/cloud/compute/projects/v1/projects.proto#L675} /// // clang-format on future> @@ -1377,7 +1415,7 @@ class ProjectsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.projects.v1.SetDefaultNetworkTierRequest]: @cloud_cpp_reference_link{google/cloud/compute/projects/v1/projects.proto#L595} + /// [google.cloud.cpp.compute.projects.v1.SetDefaultNetworkTierRequest]: @cloud_cpp_reference_link{google/cloud/compute/projects/v1/projects.proto#L704} /// // clang-format on future> @@ -1439,7 +1477,7 @@ class ProjectsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.projects.v1.SetDefaultNetworkTierRequest]: @cloud_cpp_reference_link{google/cloud/compute/projects/v1/projects.proto#L595} + /// [google.cloud.cpp.compute.projects.v1.SetDefaultNetworkTierRequest]: @cloud_cpp_reference_link{google/cloud/compute/projects/v1/projects.proto#L704} /// // clang-format on future> @@ -1480,9 +1518,9 @@ class ProjectsClient { // clang-format off /// - /// 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. + /// Enables the usage export feature and sets theusage export bucket + /// where reports are stored. If you provide an empty request body using this + /// method, the usage export feature will be disabled. /// https://cloud.google.com/compute/docs/reference/rest/v1/projects/setUsageExportBucket /// /// @param project Project ID for this request. @@ -1507,7 +1545,7 @@ class ProjectsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.projects.v1.SetUsageExportBucketRequest]: @cloud_cpp_reference_link{google/cloud/compute/projects/v1/projects.proto#L622} + /// [google.cloud.cpp.compute.projects.v1.SetUsageExportBucketRequest]: @cloud_cpp_reference_link{google/cloud/compute/projects/v1/projects.proto#L734} /// // clang-format on future> @@ -1536,9 +1574,9 @@ class ProjectsClient { // clang-format off /// - /// 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. + /// Enables the usage export feature and sets theusage export bucket + /// where reports are stored. If you provide an empty request body using this + /// method, the usage export feature will be disabled. /// https://cloud.google.com/compute/docs/reference/rest/v1/projects/setUsageExportBucket /// /// @param request Unary RPCs, such as the one wrapped by this @@ -1567,7 +1605,7 @@ class ProjectsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.projects.v1.SetUsageExportBucketRequest]: @cloud_cpp_reference_link{google/cloud/compute/projects/v1/projects.proto#L622} + /// [google.cloud.cpp.compute.projects.v1.SetUsageExportBucketRequest]: @cloud_cpp_reference_link{google/cloud/compute/projects/v1/projects.proto#L734} /// // clang-format on future> diff --git a/google/cloud/compute/projects/v1/projects_proto_export.h b/google/cloud/compute/projects/v1/projects_proto_export.h index 81463ab7e1eb1..15630f8967059 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 "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_025.pb.h" -#include "google/cloud/compute/v1/internal/common_081.pb.h" -#include "google/cloud/compute/v1/internal/common_098.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_034.pb.h" +#include "google/cloud/compute/v1/internal/common_096.pb.h" +#include "google/cloud/compute/v1/internal/common_115.pb.h" // 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 5887d88e3ffe3..10a4dfa58ea4f 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 @@ -119,7 +119,7 @@ class PublicAdvertisedPrefixesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.public_advertised_prefixes.v1.AnnounceRequest]: @cloud_cpp_reference_link{google/cloud/compute/public_advertised_prefixes/v1/public_advertised_prefixes.proto#L126} + /// [google.cloud.cpp.compute.public_advertised_prefixes.v1.AnnounceRequest]: @cloud_cpp_reference_link{google/cloud/compute/public_advertised_prefixes/v1/public_advertised_prefixes.proto#L127} /// // clang-format on future> Announce( @@ -172,7 +172,7 @@ class PublicAdvertisedPrefixesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.public_advertised_prefixes.v1.AnnounceRequest]: @cloud_cpp_reference_link{google/cloud/compute/public_advertised_prefixes/v1/public_advertised_prefixes.proto#L126} + /// [google.cloud.cpp.compute.public_advertised_prefixes.v1.AnnounceRequest]: @cloud_cpp_reference_link{google/cloud/compute/public_advertised_prefixes/v1/public_advertised_prefixes.proto#L127} /// // clang-format on future> Announce( @@ -237,7 +237,7 @@ class PublicAdvertisedPrefixesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.public_advertised_prefixes.v1.DeletePublicAdvertisedPrefixRequest]: @cloud_cpp_reference_link{google/cloud/compute/public_advertised_prefixes/v1/public_advertised_prefixes.proto#L154} + /// [google.cloud.cpp.compute.public_advertised_prefixes.v1.DeletePublicAdvertisedPrefixRequest]: @cloud_cpp_reference_link{google/cloud/compute/public_advertised_prefixes/v1/public_advertised_prefixes.proto#L158} /// // clang-format on future> @@ -292,7 +292,7 @@ class PublicAdvertisedPrefixesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.public_advertised_prefixes.v1.DeletePublicAdvertisedPrefixRequest]: @cloud_cpp_reference_link{google/cloud/compute/public_advertised_prefixes/v1/public_advertised_prefixes.proto#L154} + /// [google.cloud.cpp.compute.public_advertised_prefixes.v1.DeletePublicAdvertisedPrefixRequest]: @cloud_cpp_reference_link{google/cloud/compute/public_advertised_prefixes/v1/public_advertised_prefixes.proto#L158} /// // clang-format on future> @@ -353,8 +353,8 @@ class PublicAdvertisedPrefixesClient { /// [`future`]: @ref google::cloud::future /// [`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_095.proto#L27} + /// [google.cloud.cpp.compute.public_advertised_prefixes.v1.GetPublicAdvertisedPrefixRequest]: @cloud_cpp_reference_link{google/cloud/compute/public_advertised_prefixes/v1/public_advertised_prefixes.proto#L189} + /// [google.cloud.cpp.compute.v1.PublicAdvertisedPrefix]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_112.proto#L27} /// // clang-format on StatusOr @@ -386,8 +386,8 @@ class PublicAdvertisedPrefixesClient { /// [`future`]: @ref google::cloud::future /// [`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_095.proto#L27} + /// [google.cloud.cpp.compute.public_advertised_prefixes.v1.GetPublicAdvertisedPrefixRequest]: @cloud_cpp_reference_link{google/cloud/compute/public_advertised_prefixes/v1/public_advertised_prefixes.proto#L189} + /// [google.cloud.cpp.compute.v1.PublicAdvertisedPrefix]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_112.proto#L27} /// // clang-format on StatusOr @@ -398,8 +398,8 @@ class PublicAdvertisedPrefixesClient { // clang-format off /// - /// Creates a PublicAdvertisedPrefix in the specified project using the - /// parameters that are included in the request. + /// Creates a PublicAdvertisedPrefix in the specified project + /// using the parameters that are included in the request. /// https://cloud.google.com/compute/docs/reference/rest/v1/publicAdvertisedPrefixes/insert /// /// @param project Project ID for this request. @@ -424,7 +424,7 @@ class PublicAdvertisedPrefixesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.public_advertised_prefixes.v1.InsertPublicAdvertisedPrefixRequest]: @cloud_cpp_reference_link{google/cloud/compute/public_advertised_prefixes/v1/public_advertised_prefixes.proto#L195} + /// [google.cloud.cpp.compute.public_advertised_prefixes.v1.InsertPublicAdvertisedPrefixRequest]: @cloud_cpp_reference_link{google/cloud/compute/public_advertised_prefixes/v1/public_advertised_prefixes.proto#L202} /// // clang-format on future> @@ -454,8 +454,8 @@ class PublicAdvertisedPrefixesClient { // clang-format off /// - /// Creates a PublicAdvertisedPrefix in the specified project using the - /// parameters that are included in the request. + /// Creates a PublicAdvertisedPrefix in the specified project + /// using the parameters that are included in the request. /// https://cloud.google.com/compute/docs/reference/rest/v1/publicAdvertisedPrefixes/insert /// /// @param request Unary RPCs, such as the one wrapped by this @@ -484,7 +484,7 @@ class PublicAdvertisedPrefixesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.public_advertised_prefixes.v1.InsertPublicAdvertisedPrefixRequest]: @cloud_cpp_reference_link{google/cloud/compute/public_advertised_prefixes/v1/public_advertised_prefixes.proto#L195} + /// [google.cloud.cpp.compute.public_advertised_prefixes.v1.InsertPublicAdvertisedPrefixRequest]: @cloud_cpp_reference_link{google/cloud/compute/public_advertised_prefixes/v1/public_advertised_prefixes.proto#L202} /// // clang-format on future> @@ -553,8 +553,8 @@ class PublicAdvertisedPrefixesClient { /// [`future`]: @ref google::cloud::future /// [`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_095.proto#L27} + /// [google.cloud.cpp.compute.public_advertised_prefixes.v1.ListPublicAdvertisedPrefixesRequest]: @cloud_cpp_reference_link{google/cloud/compute/public_advertised_prefixes/v1/public_advertised_prefixes.proto#L231} + /// [google.cloud.cpp.compute.v1.PublicAdvertisedPrefix]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_112.proto#L27} /// // clang-format on StreamRange @@ -593,8 +593,8 @@ class PublicAdvertisedPrefixesClient { /// [`future`]: @ref google::cloud::future /// [`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_095.proto#L27} + /// [google.cloud.cpp.compute.public_advertised_prefixes.v1.ListPublicAdvertisedPrefixesRequest]: @cloud_cpp_reference_link{google/cloud/compute/public_advertised_prefixes/v1/public_advertised_prefixes.proto#L231} + /// [google.cloud.cpp.compute.v1.PublicAdvertisedPrefix]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_112.proto#L27} /// // clang-format on StreamRange @@ -606,8 +606,9 @@ class PublicAdvertisedPrefixesClient { // clang-format off /// /// 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. + /// request. This method supportsPATCH + /// semantics and usesJSON merge + /// patch format and processing rules. /// https://cloud.google.com/compute/docs/reference/rest/v1/publicAdvertisedPrefixes/patch /// /// @param project Project ID for this request. @@ -633,7 +634,7 @@ class PublicAdvertisedPrefixesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.public_advertised_prefixes.v1.PatchPublicAdvertisedPrefixRequest]: @cloud_cpp_reference_link{google/cloud/compute/public_advertised_prefixes/v1/public_advertised_prefixes.proto#L289} + /// [google.cloud.cpp.compute.public_advertised_prefixes.v1.PatchPublicAdvertisedPrefixRequest]: @cloud_cpp_reference_link{google/cloud/compute/public_advertised_prefixes/v1/public_advertised_prefixes.proto#L332} /// // clang-format on future> @@ -665,8 +666,9 @@ class PublicAdvertisedPrefixesClient { // clang-format off /// /// 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. + /// request. This method supportsPATCH + /// semantics and usesJSON merge + /// patch format and processing rules. /// https://cloud.google.com/compute/docs/reference/rest/v1/publicAdvertisedPrefixes/patch /// /// @param request Unary RPCs, such as the one wrapped by this @@ -695,7 +697,7 @@ class PublicAdvertisedPrefixesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.public_advertised_prefixes.v1.PatchPublicAdvertisedPrefixRequest]: @cloud_cpp_reference_link{google/cloud/compute/public_advertised_prefixes/v1/public_advertised_prefixes.proto#L289} + /// [google.cloud.cpp.compute.public_advertised_prefixes.v1.PatchPublicAdvertisedPrefixRequest]: @cloud_cpp_reference_link{google/cloud/compute/public_advertised_prefixes/v1/public_advertised_prefixes.proto#L332} /// // clang-format on future> @@ -763,7 +765,7 @@ class PublicAdvertisedPrefixesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.public_advertised_prefixes.v1.WithdrawRequest]: @cloud_cpp_reference_link{google/cloud/compute/public_advertised_prefixes/v1/public_advertised_prefixes.proto#L321} + /// [google.cloud.cpp.compute.public_advertised_prefixes.v1.WithdrawRequest]: @cloud_cpp_reference_link{google/cloud/compute/public_advertised_prefixes/v1/public_advertised_prefixes.proto#L367} /// // clang-format on future> Withdraw( @@ -816,7 +818,7 @@ class PublicAdvertisedPrefixesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.public_advertised_prefixes.v1.WithdrawRequest]: @cloud_cpp_reference_link{google/cloud/compute/public_advertised_prefixes/v1/public_advertised_prefixes.proto#L321} + /// [google.cloud.cpp.compute.public_advertised_prefixes.v1.WithdrawRequest]: @cloud_cpp_reference_link{google/cloud/compute/public_advertised_prefixes/v1/public_advertised_prefixes.proto#L367} /// // clang-format on future> Withdraw( 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 263f7641c7568..25e86a58d0c9a 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 "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_095.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_112.pb.h" // 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 1b42dcb28fa02..f6e49ae75b20d 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 @@ -95,7 +95,9 @@ class PublicDelegatedPrefixesClient { // clang-format off /// /// Lists all PublicDelegatedPrefix resources owned by the specific project - /// across all scopes. To prevent failure, Google recommends that you set the + /// across all scopes. + /// + /// To prevent failure, Google recommends that you set the /// `returnPartialSuccess` parameter to `true`. /// https://cloud.google.com/compute/docs/reference/rest/v1/publicDelegatedPrefixes/aggregatedList /// @@ -122,8 +124,8 @@ class PublicDelegatedPrefixesClient { /// [`future`]: @ref google::cloud::future /// [`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_097.proto#L139} + /// [google.cloud.cpp.compute.public_delegated_prefixes.v1.AggregatedListPublicDelegatedPrefixesRequest]: @cloud_cpp_reference_link{google/cloud/compute/public_delegated_prefixes/v1/public_delegated_prefixes.proto#L148} + /// [google.cloud.cpp.compute.v1.PublicDelegatedPrefixesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_114.proto#L160} /// // clang-format on StreamRange> Announce( @@ -259,7 +263,7 @@ class PublicDelegatedPrefixesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.public_delegated_prefixes.v1.AnnounceRequest]: @cloud_cpp_reference_link{google/cloud/compute/public_delegated_prefixes/v1/public_delegated_prefixes.proto#L227} + /// [google.cloud.cpp.compute.public_delegated_prefixes.v1.AnnounceRequest]: @cloud_cpp_reference_link{google/cloud/compute/public_delegated_prefixes/v1/public_delegated_prefixes.proto#L263} /// // clang-format on future> Announce( @@ -325,7 +329,7 @@ class PublicDelegatedPrefixesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.public_delegated_prefixes.v1.DeletePublicDelegatedPrefixRequest]: @cloud_cpp_reference_link{google/cloud/compute/public_delegated_prefixes/v1/public_delegated_prefixes.proto#L263} + /// [google.cloud.cpp.compute.public_delegated_prefixes.v1.DeletePublicDelegatedPrefixRequest]: @cloud_cpp_reference_link{google/cloud/compute/public_delegated_prefixes/v1/public_delegated_prefixes.proto#L302} /// // clang-format on future> @@ -382,7 +386,7 @@ class PublicDelegatedPrefixesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.public_delegated_prefixes.v1.DeletePublicDelegatedPrefixRequest]: @cloud_cpp_reference_link{google/cloud/compute/public_delegated_prefixes/v1/public_delegated_prefixes.proto#L263} + /// [google.cloud.cpp.compute.public_delegated_prefixes.v1.DeletePublicDelegatedPrefixRequest]: @cloud_cpp_reference_link{google/cloud/compute/public_delegated_prefixes/v1/public_delegated_prefixes.proto#L302} /// // clang-format on future> @@ -444,8 +448,8 @@ class PublicDelegatedPrefixesClient { /// [`future`]: @ref google::cloud::future /// [`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_096.proto#L29} + /// [google.cloud.cpp.compute.public_delegated_prefixes.v1.GetPublicDelegatedPrefixRequest]: @cloud_cpp_reference_link{google/cloud/compute/public_delegated_prefixes/v1/public_delegated_prefixes.proto#L340} + /// [google.cloud.cpp.compute.v1.PublicDelegatedPrefix]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_113.proto#L29} /// // clang-format on StatusOr @@ -478,8 +482,8 @@ class PublicDelegatedPrefixesClient { /// [`future`]: @ref google::cloud::future /// [`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_096.proto#L29} + /// [google.cloud.cpp.compute.public_delegated_prefixes.v1.GetPublicDelegatedPrefixRequest]: @cloud_cpp_reference_link{google/cloud/compute/public_delegated_prefixes/v1/public_delegated_prefixes.proto#L340} + /// [google.cloud.cpp.compute.v1.PublicDelegatedPrefix]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_113.proto#L29} /// // clang-format on StatusOr @@ -517,7 +521,7 @@ class PublicDelegatedPrefixesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.public_delegated_prefixes.v1.InsertPublicDelegatedPrefixRequest]: @cloud_cpp_reference_link{google/cloud/compute/public_delegated_prefixes/v1/public_delegated_prefixes.proto#L315} + /// [google.cloud.cpp.compute.public_delegated_prefixes.v1.InsertPublicDelegatedPrefixRequest]: @cloud_cpp_reference_link{google/cloud/compute/public_delegated_prefixes/v1/public_delegated_prefixes.proto#L357} /// // clang-format on future> @@ -577,7 +581,7 @@ class PublicDelegatedPrefixesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.public_delegated_prefixes.v1.InsertPublicDelegatedPrefixRequest]: @cloud_cpp_reference_link{google/cloud/compute/public_delegated_prefixes/v1/public_delegated_prefixes.proto#L315} + /// [google.cloud.cpp.compute.public_delegated_prefixes.v1.InsertPublicDelegatedPrefixRequest]: @cloud_cpp_reference_link{google/cloud/compute/public_delegated_prefixes/v1/public_delegated_prefixes.proto#L357} /// // clang-format on future> @@ -647,8 +651,8 @@ class PublicDelegatedPrefixesClient { /// [`future`]: @ref google::cloud::future /// [`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_096.proto#L29} + /// [google.cloud.cpp.compute.public_delegated_prefixes.v1.ListPublicDelegatedPrefixesRequest]: @cloud_cpp_reference_link{google/cloud/compute/public_delegated_prefixes/v1/public_delegated_prefixes.proto#L393} + /// [google.cloud.cpp.compute.v1.PublicDelegatedPrefix]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_113.proto#L29} /// // clang-format on StreamRange @@ -688,8 +692,8 @@ class PublicDelegatedPrefixesClient { /// [`future`]: @ref google::cloud::future /// [`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_096.proto#L29} + /// [google.cloud.cpp.compute.public_delegated_prefixes.v1.ListPublicDelegatedPrefixesRequest]: @cloud_cpp_reference_link{google/cloud/compute/public_delegated_prefixes/v1/public_delegated_prefixes.proto#L393} + /// [google.cloud.cpp.compute.v1.PublicDelegatedPrefix]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_113.proto#L29} /// // clang-format on StreamRange @@ -701,7 +705,8 @@ class PublicDelegatedPrefixesClient { // clang-format off /// /// Patches the specified PublicDelegatedPrefix resource with the data included - /// in the request. This method supports PATCH semantics and uses JSON merge + /// in the request. This method supportsPATCH + /// semantics and usesJSON merge /// patch format and processing rules. /// https://cloud.google.com/compute/docs/reference/rest/v1/publicDelegatedPrefixes/patch /// @@ -729,7 +734,7 @@ class PublicDelegatedPrefixesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.public_delegated_prefixes.v1.PatchPublicDelegatedPrefixRequest]: @cloud_cpp_reference_link{google/cloud/compute/public_delegated_prefixes/v1/public_delegated_prefixes.proto#L420} + /// [google.cloud.cpp.compute.public_delegated_prefixes.v1.PatchPublicDelegatedPrefixRequest]: @cloud_cpp_reference_link{google/cloud/compute/public_delegated_prefixes/v1/public_delegated_prefixes.proto#L498} /// // clang-format on future> @@ -762,7 +767,8 @@ class PublicDelegatedPrefixesClient { // clang-format off /// /// Patches the specified PublicDelegatedPrefix resource with the data included - /// in the request. This method supports PATCH semantics and uses JSON merge + /// in the request. This method supportsPATCH + /// semantics and usesJSON merge /// patch format and processing rules. /// https://cloud.google.com/compute/docs/reference/rest/v1/publicDelegatedPrefixes/patch /// @@ -792,7 +798,7 @@ class PublicDelegatedPrefixesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.public_delegated_prefixes.v1.PatchPublicDelegatedPrefixRequest]: @cloud_cpp_reference_link{google/cloud/compute/public_delegated_prefixes/v1/public_delegated_prefixes.proto#L420} + /// [google.cloud.cpp.compute.public_delegated_prefixes.v1.PatchPublicDelegatedPrefixRequest]: @cloud_cpp_reference_link{google/cloud/compute/public_delegated_prefixes/v1/public_delegated_prefixes.proto#L498} /// // clang-format on future> @@ -839,8 +845,8 @@ class PublicDelegatedPrefixesClient { /// https://cloud.google.com/compute/docs/reference/rest/v1/publicDelegatedPrefixes/withdraw /// /// @param project Project ID for this request. - /// @param region The name of the region where the public delegated prefix is located. It - /// should comply with RFC1035. + /// @param region The name of theregion where + /// the public delegated prefix is located. It should comply with RFC1035. /// @param public_delegated_prefix The name of the public delegated prefix. It should comply with RFC1035. /// @param opts Optional. Override the class-level options, such as retry and /// backoff policies. @@ -862,7 +868,7 @@ class PublicDelegatedPrefixesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.public_delegated_prefixes.v1.WithdrawRequest]: @cloud_cpp_reference_link{google/cloud/compute/public_delegated_prefixes/v1/public_delegated_prefixes.proto#L459} + /// [google.cloud.cpp.compute.public_delegated_prefixes.v1.WithdrawRequest]: @cloud_cpp_reference_link{google/cloud/compute/public_delegated_prefixes/v1/public_delegated_prefixes.proto#L540} /// // clang-format on future> Withdraw( @@ -915,7 +921,7 @@ class PublicDelegatedPrefixesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.public_delegated_prefixes.v1.WithdrawRequest]: @cloud_cpp_reference_link{google/cloud/compute/public_delegated_prefixes/v1/public_delegated_prefixes.proto#L459} + /// [google.cloud.cpp.compute.public_delegated_prefixes.v1.WithdrawRequest]: @cloud_cpp_reference_link{google/cloud/compute/public_delegated_prefixes/v1/public_delegated_prefixes.proto#L540} /// // clang-format on future> Withdraw( 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 e372bd05444bf..16df74d41625b 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 "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_096.pb.h" -#include "google/cloud/compute/v1/internal/common_097.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_113.pb.h" +#include "google/cloud/compute/v1/internal/common_114.pb.h" // 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/internal/region_autoscalers_rest_connection_impl.cc b/google/cloud/compute/region_autoscalers/v1/internal/region_autoscalers_rest_connection_impl.cc index 54f709dcbe3e7..42a93db9e3df4 100644 --- a/google/cloud/compute/region_autoscalers/v1/internal/region_autoscalers_rest_connection_impl.cc +++ b/google/cloud/compute/region_autoscalers/v1/internal/region_autoscalers_rest_connection_impl.cc @@ -494,6 +494,22 @@ RegionAutoscalersRestConnectionImpl::PatchAutoscaler( }); } +StatusOr +RegionAutoscalersRestConnectionImpl::TestIamPermissions( + google::cloud::cpp::compute::region_autoscalers::v1:: + TestIamPermissionsRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->TestIamPermissions(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_autoscalers::v1:: + TestIamPermissionsRequest const& request) { + return stub_->TestIamPermissions(rest_context, options, request); + }, + *current, request, __func__); +} + future> RegionAutoscalersRestConnectionImpl::UpdateAutoscaler( google::cloud::cpp::compute::region_autoscalers::v1:: diff --git a/google/cloud/compute/region_autoscalers/v1/internal/region_autoscalers_rest_connection_impl.h b/google/cloud/compute/region_autoscalers/v1/internal/region_autoscalers_rest_connection_impl.h index 48d1c1938563c..5ddff4e5ee97f 100644 --- a/google/cloud/compute/region_autoscalers/v1/internal/region_autoscalers_rest_connection_impl.h +++ b/google/cloud/compute/region_autoscalers/v1/internal/region_autoscalers_rest_connection_impl.h @@ -93,6 +93,10 @@ class RegionAutoscalersRestConnectionImpl future> PatchAutoscaler( google::cloud::cpp::compute::v1::Operation const& operation) override; + StatusOr + TestIamPermissions(google::cloud::cpp::compute::region_autoscalers::v1:: + TestIamPermissionsRequest const& request) override; + future> UpdateAutoscaler( google::cloud::cpp::compute::region_autoscalers::v1:: UpdateAutoscalerRequest const& request) override; diff --git a/google/cloud/compute/region_autoscalers/v1/internal/region_autoscalers_rest_logging_decorator.cc b/google/cloud/compute/region_autoscalers/v1/internal/region_autoscalers_rest_logging_decorator.cc index 8d7b606863473..55b2dc1a18cec 100644 --- a/google/cloud/compute/region_autoscalers/v1/internal/region_autoscalers_rest_logging_decorator.cc +++ b/google/cloud/compute/region_autoscalers/v1/internal/region_autoscalers_rest_logging_decorator.cc @@ -164,6 +164,20 @@ RegionAutoscalersRestLogging::PatchAutoscaler( rest_context, options, request, __func__, tracing_options_); } +StatusOr +RegionAutoscalersRestLogging::TestIamPermissions( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_autoscalers::v1:: + TestIamPermissionsRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_autoscalers::v1:: + TestIamPermissionsRequest const& request) { + return child_->TestIamPermissions(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + future> RegionAutoscalersRestLogging::AsyncUpdateAutoscaler( CompletionQueue& cq, diff --git a/google/cloud/compute/region_autoscalers/v1/internal/region_autoscalers_rest_logging_decorator.h b/google/cloud/compute/region_autoscalers/v1/internal/region_autoscalers_rest_logging_decorator.h index 9904b8b9a74a4..4839dca394fe0 100644 --- a/google/cloud/compute/region_autoscalers/v1/internal/region_autoscalers_rest_logging_decorator.h +++ b/google/cloud/compute/region_autoscalers/v1/internal/region_autoscalers_rest_logging_decorator.h @@ -97,6 +97,12 @@ class RegionAutoscalersRestLogging : public RegionAutoscalersRestStub { google::cloud::cpp::compute::region_autoscalers::v1:: PatchAutoscalerRequest const& request) override; + StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_autoscalers::v1:: + TestIamPermissionsRequest const& request) override; + future> AsyncUpdateAutoscaler( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/region_autoscalers/v1/internal/region_autoscalers_rest_metadata_decorator.cc b/google/cloud/compute/region_autoscalers/v1/internal/region_autoscalers_rest_metadata_decorator.cc index 46732319e1d73..46d08ad4c31a1 100644 --- a/google/cloud/compute/region_autoscalers/v1/internal/region_autoscalers_rest_metadata_decorator.cc +++ b/google/cloud/compute/region_autoscalers/v1/internal/region_autoscalers_rest_metadata_decorator.cc @@ -120,6 +120,15 @@ RegionAutoscalersRestMetadata::PatchAutoscaler( return child_->PatchAutoscaler(rest_context, options, request); } +StatusOr +RegionAutoscalersRestMetadata::TestIamPermissions( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_autoscalers::v1:: + TestIamPermissionsRequest const& request) { + SetMetadata(rest_context, options); + return child_->TestIamPermissions(rest_context, options, request); +} + future> RegionAutoscalersRestMetadata::AsyncUpdateAutoscaler( CompletionQueue& cq, diff --git a/google/cloud/compute/region_autoscalers/v1/internal/region_autoscalers_rest_metadata_decorator.h b/google/cloud/compute/region_autoscalers/v1/internal/region_autoscalers_rest_metadata_decorator.h index 2c348291d45a5..0b044ae6e018c 100644 --- a/google/cloud/compute/region_autoscalers/v1/internal/region_autoscalers_rest_metadata_decorator.h +++ b/google/cloud/compute/region_autoscalers/v1/internal/region_autoscalers_rest_metadata_decorator.h @@ -95,6 +95,12 @@ class RegionAutoscalersRestMetadata : public RegionAutoscalersRestStub { google::cloud::cpp::compute::region_autoscalers::v1:: PatchAutoscalerRequest const& request) override; + StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_autoscalers::v1:: + TestIamPermissionsRequest const& request) override; + google::cloud::future> AsyncUpdateAutoscaler( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/region_autoscalers/v1/internal/region_autoscalers_rest_stub.cc b/google/cloud/compute/region_autoscalers/v1/internal/region_autoscalers_rest_stub.cc index 963888c10e3d5..7f2368cc45e15 100644 --- a/google/cloud/compute/region_autoscalers/v1/internal/region_autoscalers_rest_stub.cc +++ b/google/cloud/compute/region_autoscalers/v1/internal/region_autoscalers_rest_stub.cc @@ -260,6 +260,25 @@ DefaultRegionAutoscalersRestStub::PatchAutoscaler( std::move(query_params)); } +StatusOr +DefaultRegionAutoscalersRestStub::TestIamPermissions( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_autoscalers::v1:: + TestIamPermissionsRequest const& request) { + std::vector> query_params; + return rest_internal::Post< + google::cloud::cpp::compute::v1::TestPermissionsResponse>( + *service_, rest_context, request.test_permissions_request_resource(), + false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "regions", "/", + request.region(), "/", "autoscalers", "/", + request.resource(), "/", "testIamPermissions"), + std::move(query_params)); +} + future> DefaultRegionAutoscalersRestStub::AsyncUpdateAutoscaler( CompletionQueue& cq, diff --git a/google/cloud/compute/region_autoscalers/v1/internal/region_autoscalers_rest_stub.h b/google/cloud/compute/region_autoscalers/v1/internal/region_autoscalers_rest_stub.h index 05ea74a003823..03c39f8281b08 100644 --- a/google/cloud/compute/region_autoscalers/v1/internal/region_autoscalers_rest_stub.h +++ b/google/cloud/compute/region_autoscalers/v1/internal/region_autoscalers_rest_stub.h @@ -91,6 +91,12 @@ class RegionAutoscalersRestStub { google::cloud::cpp::compute::region_autoscalers::v1:: PatchAutoscalerRequest const& request) = 0; + virtual StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_autoscalers::v1:: + TestIamPermissionsRequest const& request) = 0; + virtual future> AsyncUpdateAutoscaler( google::cloud::CompletionQueue& cq, @@ -185,6 +191,12 @@ class DefaultRegionAutoscalersRestStub : public RegionAutoscalersRestStub { google::cloud::cpp::compute::region_autoscalers::v1:: PatchAutoscalerRequest const& request) override; + StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_autoscalers::v1:: + TestIamPermissionsRequest const& request) override; + future> AsyncUpdateAutoscaler( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/region_autoscalers/v1/internal/region_autoscalers_tracing_connection.cc b/google/cloud/compute/region_autoscalers/v1/internal/region_autoscalers_tracing_connection.cc index 38c91e7b3ea57..40617d2c3b20f 100644 --- a/google/cloud/compute/region_autoscalers/v1/internal/region_autoscalers_tracing_connection.cc +++ b/google/cloud/compute/region_autoscalers/v1/internal/region_autoscalers_tracing_connection.cc @@ -158,6 +158,17 @@ RegionAutoscalersTracingConnection::PatchAutoscaler( return internal::EndSpan(std::move(span), child_->PatchAutoscaler(operation)); } +StatusOr +RegionAutoscalersTracingConnection::TestIamPermissions( + google::cloud::cpp::compute::region_autoscalers::v1:: + TestIamPermissionsRequest const& request) { + auto span = internal::MakeSpan( + "compute_region_autoscalers_v1::RegionAutoscalersConnection::" + "TestIamPermissions"); + auto scope = opentelemetry::trace::Scope(span); + return internal::EndSpan(*span, child_->TestIamPermissions(request)); +} + future> RegionAutoscalersTracingConnection::UpdateAutoscaler( google::cloud::cpp::compute::region_autoscalers::v1:: diff --git a/google/cloud/compute/region_autoscalers/v1/internal/region_autoscalers_tracing_connection.h b/google/cloud/compute/region_autoscalers/v1/internal/region_autoscalers_tracing_connection.h index ae8399daf9f67..2c82c8f0a2107 100644 --- a/google/cloud/compute/region_autoscalers/v1/internal/region_autoscalers_tracing_connection.h +++ b/google/cloud/compute/region_autoscalers/v1/internal/region_autoscalers_tracing_connection.h @@ -81,6 +81,10 @@ class RegionAutoscalersTracingConnection future> PatchAutoscaler( google::cloud::cpp::compute::v1::Operation const& operation) override; + StatusOr + TestIamPermissions(google::cloud::cpp::compute::region_autoscalers::v1:: + TestIamPermissionsRequest const& request) override; + future> UpdateAutoscaler( google::cloud::cpp::compute::region_autoscalers::v1:: UpdateAutoscalerRequest const& request) override; diff --git a/google/cloud/compute/region_autoscalers/v1/mocks/mock_region_autoscalers_connection.h b/google/cloud/compute/region_autoscalers/v1/mocks/mock_region_autoscalers_connection.h index 34b9490469684..58ac91e3cad1c 100644 --- a/google/cloud/compute/region_autoscalers/v1/mocks/mock_region_autoscalers_connection.h +++ b/google/cloud/compute/region_autoscalers/v1/mocks/mock_region_autoscalers_connection.h @@ -182,6 +182,13 @@ class MockRegionAutoscalersConnection (google::cloud::cpp::compute::v1::Operation const& operation), (override)); + MOCK_METHOD( + StatusOr, + TestIamPermissions, + (google::cloud::cpp::compute::region_autoscalers::v1:: + TestIamPermissionsRequest const& request), + (override)); + /// To disambiguate calls, use: /// /// @code diff --git a/google/cloud/compute/region_autoscalers/v1/region_autoscalers_client.cc b/google/cloud/compute/region_autoscalers/v1/region_autoscalers_client.cc index 0040d58b0f558..a1d9a63b37fe3 100644 --- a/google/cloud/compute/region_autoscalers/v1/region_autoscalers_client.cc +++ b/google/cloud/compute/region_autoscalers/v1/region_autoscalers_client.cc @@ -239,6 +239,33 @@ RegionAutoscalersClient::PatchAutoscaler( return connection_->PatchAutoscaler(operation); } +StatusOr +RegionAutoscalersClient::TestIamPermissions( + std::string const& project, std::string const& region, + std::string const& resource, + google::cloud::cpp::compute::v1::TestPermissionsRequest const& + test_permissions_request_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_autoscalers::v1::TestIamPermissionsRequest + request; + request.set_project(project); + request.set_region(region); + request.set_resource(resource); + *request.mutable_test_permissions_request_resource() = + test_permissions_request_resource; + return connection_->TestIamPermissions(request); +} + +StatusOr +RegionAutoscalersClient::TestIamPermissions( + google::cloud::cpp::compute::region_autoscalers::v1:: + TestIamPermissionsRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->TestIamPermissions(request); +} + future> RegionAutoscalersClient::UpdateAutoscaler( std::string const& project, std::string const& region, 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 69dd3d3410b15..081398fd28088 100644 --- a/google/cloud/compute/region_autoscalers/v1/region_autoscalers_client.h +++ b/google/cloud/compute/region_autoscalers/v1/region_autoscalers_client.h @@ -117,7 +117,7 @@ class RegionAutoscalersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_autoscalers.v1.DeleteAutoscalerRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_autoscalers/v1/region_autoscalers.proto#L114} + /// [google.cloud.cpp.compute.region_autoscalers.v1.DeleteAutoscalerRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_autoscalers/v1/region_autoscalers.proto#L129} /// // clang-format on future> DeleteAutoscaler( @@ -170,7 +170,7 @@ class RegionAutoscalersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_autoscalers.v1.DeleteAutoscalerRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_autoscalers/v1/region_autoscalers.proto#L114} + /// [google.cloud.cpp.compute.region_autoscalers.v1.DeleteAutoscalerRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_autoscalers/v1/region_autoscalers.proto#L129} /// // clang-format on future> DeleteAutoscaler( @@ -229,8 +229,8 @@ class RegionAutoscalersClient { /// [`future`]: @ref google::cloud::future /// [`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_008.proto#L34} + /// [google.cloud.cpp.compute.region_autoscalers.v1.GetAutoscalerRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_autoscalers/v1/region_autoscalers.proto#L165} + /// [google.cloud.cpp.compute.v1.Autoscaler]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_010.proto#L43} /// // clang-format on StatusOr GetAutoscaler( @@ -261,8 +261,8 @@ class RegionAutoscalersClient { /// [`future`]: @ref google::cloud::future /// [`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_008.proto#L34} + /// [google.cloud.cpp.compute.region_autoscalers.v1.GetAutoscalerRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_autoscalers/v1/region_autoscalers.proto#L165} + /// [google.cloud.cpp.compute.v1.Autoscaler]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_010.proto#L43} /// // clang-format on StatusOr GetAutoscaler( @@ -272,8 +272,8 @@ class RegionAutoscalersClient { // clang-format off /// - /// Creates an autoscaler in the specified project using the data included in - /// the request. + /// Creates an autoscaler in the specified project using + /// the data included in the request. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionAutoscalers/insert /// /// @param project Project ID for this request. @@ -299,7 +299,7 @@ class RegionAutoscalersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_autoscalers.v1.InsertAutoscalerRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_autoscalers/v1/region_autoscalers.proto#L162} + /// [google.cloud.cpp.compute.region_autoscalers.v1.InsertAutoscalerRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_autoscalers/v1/region_autoscalers.proto#L180} /// // clang-format on future> InsertAutoscaler( @@ -325,8 +325,8 @@ class RegionAutoscalersClient { // clang-format off /// - /// Creates an autoscaler in the specified project using the data included in - /// the request. + /// Creates an autoscaler in the specified project using + /// the data included in the request. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionAutoscalers/insert /// /// @param request Unary RPCs, such as the one wrapped by this @@ -355,7 +355,7 @@ class RegionAutoscalersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_autoscalers.v1.InsertAutoscalerRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_autoscalers/v1/region_autoscalers.proto#L162} + /// [google.cloud.cpp.compute.region_autoscalers.v1.InsertAutoscalerRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_autoscalers/v1/region_autoscalers.proto#L180} /// // clang-format on future> InsertAutoscaler( @@ -395,7 +395,8 @@ class RegionAutoscalersClient { // clang-format off /// - /// Retrieves a list of autoscalers contained within the specified region. + /// Retrieves a list of autoscalers contained within + /// the specified region. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionAutoscalers/list /// /// @param project Project ID for this request. @@ -422,8 +423,8 @@ class RegionAutoscalersClient { /// [`future`]: @ref google::cloud::future /// [`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_008.proto#L34} + /// [google.cloud.cpp.compute.region_autoscalers.v1.ListRegionAutoscalersRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_autoscalers/v1/region_autoscalers.proto#L216} + /// [google.cloud.cpp.compute.v1.Autoscaler]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_010.proto#L43} /// // clang-format on StreamRange @@ -432,7 +433,8 @@ class RegionAutoscalersClient { // clang-format off /// - /// Retrieves a list of autoscalers contained within the specified region. + /// Retrieves a list of autoscalers contained within + /// the specified region. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionAutoscalers/list /// /// @param request Unary RPCs, such as the one wrapped by this @@ -463,8 +465,8 @@ class RegionAutoscalersClient { /// [`future`]: @ref google::cloud::future /// [`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_008.proto#L34} + /// [google.cloud.cpp.compute.region_autoscalers.v1.ListRegionAutoscalersRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_autoscalers/v1/region_autoscalers.proto#L216} + /// [google.cloud.cpp.compute.v1.Autoscaler]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_010.proto#L43} /// // clang-format on StreamRange @@ -474,8 +476,9 @@ class RegionAutoscalersClient { // clang-format off /// - /// Updates an autoscaler in the specified project using the data included in - /// the request. This method supports PATCH semantics and uses the JSON merge + /// Updates an autoscaler in the specified project using + /// the data included in the request. This method supportsPATCH + /// semantics and uses theJSON merge /// patch format and processing rules. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionAutoscalers/patch /// @@ -502,7 +505,7 @@ class RegionAutoscalersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_autoscalers.v1.PatchAutoscalerRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_autoscalers/v1/region_autoscalers.proto#L267} + /// [google.cloud.cpp.compute.region_autoscalers.v1.PatchAutoscalerRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_autoscalers/v1/region_autoscalers.proto#L321} /// // clang-format on future> PatchAutoscaler( @@ -528,8 +531,9 @@ class RegionAutoscalersClient { // clang-format off /// - /// Updates an autoscaler in the specified project using the data included in - /// the request. This method supports PATCH semantics and uses the JSON merge + /// Updates an autoscaler in the specified project using + /// the data included in the request. This method supportsPATCH + /// semantics and uses theJSON merge /// patch format and processing rules. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionAutoscalers/patch /// @@ -559,7 +563,7 @@ class RegionAutoscalersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_autoscalers.v1.PatchAutoscalerRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_autoscalers/v1/region_autoscalers.proto#L267} + /// [google.cloud.cpp.compute.region_autoscalers.v1.PatchAutoscalerRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_autoscalers/v1/region_autoscalers.proto#L321} /// // clang-format on future> PatchAutoscaler( @@ -599,8 +603,75 @@ class RegionAutoscalersClient { // clang-format off /// - /// Updates an autoscaler in the specified project using the data included in - /// the request. + /// Returns permissions that a caller has on the specified resource. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionAutoscalers/testIamPermissions + /// + /// @param project Project ID for this request. + /// @param region The name of the region for this request. + /// @param resource Name or id of the resource for this request. + /// @param test_permissions_request_resource The TestPermissionsRequest for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.TestPermissionsResponse]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_autoscalers.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_autoscalers/v1/region_autoscalers.proto#L360} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} + /// + // clang-format on + StatusOr + TestIamPermissions( + std::string const& project, std::string const& region, + std::string const& resource, + google::cloud::cpp::compute::v1::TestPermissionsRequest const& + test_permissions_request_resource, + Options opts = {}); + + // clang-format off + /// + /// Returns permissions that a caller has on the specified resource. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionAutoscalers/testIamPermissions + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.region_autoscalers.v1.TestIamPermissionsRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.TestPermissionsResponse]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_autoscalers.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_autoscalers/v1/region_autoscalers.proto#L360} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} + /// + // clang-format on + StatusOr + TestIamPermissions(google::cloud::cpp::compute::region_autoscalers::v1:: + TestIamPermissionsRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// Updates an autoscaler in the specified project using + /// the data included in the request. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionAutoscalers/update /// /// @param project Project ID for this request. @@ -626,7 +697,7 @@ class RegionAutoscalersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_autoscalers.v1.UpdateAutoscalerRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_autoscalers/v1/region_autoscalers.proto#L303} + /// [google.cloud.cpp.compute.region_autoscalers.v1.UpdateAutoscalerRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_autoscalers/v1/region_autoscalers.proto#L379} /// // clang-format on future> UpdateAutoscaler( @@ -652,8 +723,8 @@ class RegionAutoscalersClient { // clang-format off /// - /// Updates an autoscaler in the specified project using the data included in - /// the request. + /// Updates an autoscaler in the specified project using + /// the data included in the request. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionAutoscalers/update /// /// @param request Unary RPCs, such as the one wrapped by this @@ -682,7 +753,7 @@ class RegionAutoscalersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_autoscalers.v1.UpdateAutoscalerRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_autoscalers/v1/region_autoscalers.proto#L303} + /// [google.cloud.cpp.compute.region_autoscalers.v1.UpdateAutoscalerRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_autoscalers/v1/region_autoscalers.proto#L379} /// // clang-format on future> UpdateAutoscaler( diff --git a/google/cloud/compute/region_autoscalers/v1/region_autoscalers_connection.cc b/google/cloud/compute/region_autoscalers/v1/region_autoscalers_connection.cc index dc431b08f6775..6e9f5941c3090 100644 --- a/google/cloud/compute/region_autoscalers/v1/region_autoscalers_connection.cc +++ b/google/cloud/compute/region_autoscalers/v1/region_autoscalers_connection.cc @@ -126,6 +126,13 @@ RegionAutoscalersConnection::PatchAutoscaler( Status(StatusCode::kUnimplemented, "not implemented")); } +StatusOr +RegionAutoscalersConnection::TestIamPermissions( + google::cloud::cpp::compute::region_autoscalers::v1:: + TestIamPermissionsRequest const&) { + return Status(StatusCode::kUnimplemented, "not implemented"); +} + future> RegionAutoscalersConnection::UpdateAutoscaler( google::cloud::cpp::compute::region_autoscalers::v1:: diff --git a/google/cloud/compute/region_autoscalers/v1/region_autoscalers_connection.h b/google/cloud/compute/region_autoscalers/v1/region_autoscalers_connection.h index 8e27b4b0b13df..6d3653561913e 100644 --- a/google/cloud/compute/region_autoscalers/v1/region_autoscalers_connection.h +++ b/google/cloud/compute/region_autoscalers/v1/region_autoscalers_connection.h @@ -228,6 +228,10 @@ class RegionAutoscalersConnection { virtual future> PatchAutoscaler(google::cloud::cpp::compute::v1::Operation const& operation); + virtual StatusOr + TestIamPermissions(google::cloud::cpp::compute::region_autoscalers::v1:: + TestIamPermissionsRequest const& request); + virtual future> UpdateAutoscaler(google::cloud::cpp::compute::region_autoscalers::v1:: UpdateAutoscalerRequest const& request); diff --git a/google/cloud/compute/region_autoscalers/v1/region_autoscalers_connection_idempotency_policy.cc b/google/cloud/compute/region_autoscalers/v1/region_autoscalers_connection_idempotency_policy.cc index 5edb516926962..d0059d2b1a885 100644 --- a/google/cloud/compute/region_autoscalers/v1/region_autoscalers_connection_idempotency_policy.cc +++ b/google/cloud/compute/region_autoscalers/v1/region_autoscalers_connection_idempotency_policy.cc @@ -64,6 +64,12 @@ Idempotency RegionAutoscalersConnectionIdempotencyPolicy::PatchAutoscaler( return Idempotency::kNonIdempotent; } +Idempotency RegionAutoscalersConnectionIdempotencyPolicy::TestIamPermissions( + google::cloud::cpp::compute::region_autoscalers::v1:: + TestIamPermissionsRequest const&) { + return Idempotency::kNonIdempotent; +} + Idempotency RegionAutoscalersConnectionIdempotencyPolicy::UpdateAutoscaler( google::cloud::cpp::compute::region_autoscalers::v1:: UpdateAutoscalerRequest const&) { diff --git a/google/cloud/compute/region_autoscalers/v1/region_autoscalers_connection_idempotency_policy.h b/google/cloud/compute/region_autoscalers/v1/region_autoscalers_connection_idempotency_policy.h index edcca9e61ae84..8bf2988875a9a 100644 --- a/google/cloud/compute/region_autoscalers/v1/region_autoscalers_connection_idempotency_policy.h +++ b/google/cloud/compute/region_autoscalers/v1/region_autoscalers_connection_idempotency_policy.h @@ -57,6 +57,10 @@ class RegionAutoscalersConnectionIdempotencyPolicy { google::cloud::cpp::compute::region_autoscalers::v1:: PatchAutoscalerRequest const& request); + virtual google::cloud::Idempotency TestIamPermissions( + google::cloud::cpp::compute::region_autoscalers::v1:: + TestIamPermissionsRequest const& request); + virtual google::cloud::Idempotency UpdateAutoscaler( google::cloud::cpp::compute::region_autoscalers::v1:: UpdateAutoscalerRequest const& request); 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 96b540cda01b4..ca9e8409cfd68 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,11 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_AUTOSCALERS_V1_REGION_AUTOSCALERS_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include "google/cloud/compute/v1/internal/common_008.pb.h" -#include "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_040.pb.h" -#include "google/cloud/compute/v1/internal/common_100.pb.h" +#include "google/cloud/compute/v1/internal/common_010.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_049.pb.h" +#include "google/cloud/compute/v1/internal/common_117.pb.h" +#include "google/cloud/compute/v1/internal/common_171.pb.h" // 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_buckets/v1/internal/region_backend_buckets_option_defaults.cc b/google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_option_defaults.cc new file mode 100644 index 0000000000000..f02bcb222eaef --- /dev/null +++ b/google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_option_defaults.cc @@ -0,0 +1,92 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_backend_buckets/v1/region_backend_buckets.proto + +#include "google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_option_defaults.h" +#include "google/cloud/compute/region_backend_buckets/v1/region_backend_buckets_connection.h" +#include "google/cloud/compute/region_backend_buckets/v1/region_backend_buckets_options.h" +#include "google/cloud/internal/populate_common_options.h" +#include "google/cloud/internal/populate_grpc_options.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_backend_buckets_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +namespace { +auto constexpr kBackoffScaling = 2.0; +} // namespace + +Options RegionBackendBucketsDefaultOptions(Options options) { + options = internal::PopulateCommonOptions( + std::move(options), "GOOGLE_CLOUD_CPP_REGION_BACKEND_BUCKETS_ENDPOINT", + "", "GOOGLE_CLOUD_CPP_REGION_BACKEND_BUCKETS_AUTHORITY", + "compute.googleapis.com"); + options = internal::PopulateGrpcOptions(std::move(options)); + if (!options.has()) { + options.set( + compute_region_backend_buckets_v1:: + RegionBackendBucketsLimitedTimeRetryPolicy(std::chrono::minutes(10)) + .clone()); + } + if (!options.has()) { + options.set( + ExponentialBackoffPolicy( + std::chrono::seconds(0), std::chrono::seconds(1), + std::chrono::minutes(5), kBackoffScaling, kBackoffScaling) + .clone()); + } + if (!options.has()) { + options.set( + GenericPollingPolicy( + options + .get() + ->clone(), + ExponentialBackoffPolicy(std::chrono::seconds(1), + std::chrono::minutes(5), kBackoffScaling) + .clone()) + .clone()); + } + if (!options + .has()) { + options.set( + compute_region_backend_buckets_v1:: + MakeDefaultRegionBackendBucketsConnectionIdempotencyPolicy()); + } + + return options; +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_backend_buckets_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_option_defaults.h b/google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_option_defaults.h new file mode 100644 index 0000000000000..7dbf2c3f31ed8 --- /dev/null +++ b/google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_option_defaults.h @@ -0,0 +1,38 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_backend_buckets/v1/region_backend_buckets.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_BACKEND_BUCKETS_V1_INTERNAL_REGION_BACKEND_BUCKETS_OPTION_DEFAULTS_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_BACKEND_BUCKETS_V1_INTERNAL_REGION_BACKEND_BUCKETS_OPTION_DEFAULTS_H + +#include "google/cloud/options.h" +#include "google/cloud/version.h" + +namespace google { +namespace cloud { +namespace compute_region_backend_buckets_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +Options RegionBackendBucketsDefaultOptions(Options options); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_backend_buckets_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_BACKEND_BUCKETS_V1_INTERNAL_REGION_BACKEND_BUCKETS_OPTION_DEFAULTS_H diff --git a/google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_rest_connection_impl.cc b/google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_rest_connection_impl.cc new file mode 100644 index 0000000000000..507f012c6978c --- /dev/null +++ b/google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_rest_connection_impl.cc @@ -0,0 +1,587 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_backend_buckets/v1/region_backend_buckets.proto + +#include "google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_rest_connection_impl.h" +#include "google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_rest_stub_factory.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/internal/async_rest_long_running_operation_custom.h" +#include "google/cloud/internal/extract_long_running_result.h" +#include "google/cloud/internal/pagination_range.h" +#include "google/cloud/internal/rest_lro_helpers.h" +#include "google/cloud/internal/rest_retry_loop.h" +#include "google/cloud/rest_options.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_backend_buckets_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +RegionBackendBucketsRestConnectionImpl::RegionBackendBucketsRestConnectionImpl( + std::unique_ptr background, + std::shared_ptr + stub, + Options options) + : background_(std::move(background)), + stub_(std::move(stub)), + options_(internal::MergeOptions( + std::move(options), RegionBackendBucketsConnection::options())) {} + +future> +RegionBackendBucketsRestConnectionImpl::DeleteBackendBucket( + google::cloud::cpp::compute::region_backend_buckets::v1:: + DeleteBackendBucketRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::region_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, request, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + DeleteBackendBucketRequest const& request) { + return stub->AsyncDeleteBackendBucket(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->DeleteBackendBucket(request), + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [request](std::string const& op, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest& r) { + r.set_project(request.project()); + r.set_region(request.region()); + r.set_operation(op); + }, + [request](std::string const& op, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest& r) { + r.set_project(request.project()); + r.set_region(request.region()); + r.set_operation(op); + }); +} + +StatusOr +RegionBackendBucketsRestConnectionImpl::DeleteBackendBucket( + NoAwaitTag, google::cloud::cpp::compute::region_backend_buckets::v1:: + DeleteBackendBucketRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->DeleteBackendBucket(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + DeleteBackendBucketRequest const& request) { + return stub_->DeleteBackendBucket(rest_context, options, request); + }, + *current, request, __func__); +} + +future> +RegionBackendBucketsRestConnectionImpl::DeleteBackendBucket( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestAwaitLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::region_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, operation, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [operation](std::string const&, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_region(info.region); + r.set_operation(info.operation); + }, + [operation](std::string const&, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_region(info.region); + r.set_operation(info.operation); + }); +} + +StatusOr +RegionBackendBucketsRestConnectionImpl::GetBackendBucket( + google::cloud::cpp::compute::region_backend_buckets::v1:: + GetBackendBucketRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->GetBackendBucket(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + GetBackendBucketRequest const& request) { + return stub_->GetBackendBucket(rest_context, options, request); + }, + *current, request, __func__); +} + +StatusOr +RegionBackendBucketsRestConnectionImpl::GetIamPolicy( + google::cloud::cpp::compute::region_backend_buckets::v1:: + GetIamPolicyRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->GetIamPolicy(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + GetIamPolicyRequest const& request) { + return stub_->GetIamPolicy(rest_context, options, request); + }, + *current, request, __func__); +} + +future> +RegionBackendBucketsRestConnectionImpl::InsertBackendBucket( + google::cloud::cpp::compute::region_backend_buckets::v1:: + InsertBackendBucketRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::region_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, request, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + InsertBackendBucketRequest const& request) { + return stub->AsyncInsertBackendBucket(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->InsertBackendBucket(request), + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [request](std::string const& op, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest& r) { + r.set_project(request.project()); + r.set_region(request.region()); + r.set_operation(op); + }, + [request](std::string const& op, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest& r) { + r.set_project(request.project()); + r.set_region(request.region()); + r.set_operation(op); + }); +} + +StatusOr +RegionBackendBucketsRestConnectionImpl::InsertBackendBucket( + NoAwaitTag, google::cloud::cpp::compute::region_backend_buckets::v1:: + InsertBackendBucketRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->InsertBackendBucket(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + InsertBackendBucketRequest const& request) { + return stub_->InsertBackendBucket(rest_context, options, request); + }, + *current, request, __func__); +} + +future> +RegionBackendBucketsRestConnectionImpl::InsertBackendBucket( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestAwaitLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::region_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, operation, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [operation](std::string const&, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_region(info.region); + r.set_operation(info.operation); + }, + [operation](std::string const&, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_region(info.region); + r.set_operation(info.operation); + }); +} + +StreamRange +RegionBackendBucketsRestConnectionImpl::ListRegionBackendBuckets( + google::cloud::cpp::compute::region_backend_buckets::v1:: + ListRegionBackendBucketsRequest request) { + request.clear_page_token(); + auto current = google::cloud::internal::SaveCurrentOptions(); + auto idempotency = + idempotency_policy(*current)->ListRegionBackendBuckets(request); + char const* function_name = __func__; + return google::cloud::internal::MakePaginationRange< + StreamRange>( + current, std::move(request), + [idempotency, function_name, stub = stub_, + retry = std::shared_ptr< + compute_region_backend_buckets_v1::RegionBackendBucketsRetryPolicy>( + retry_policy(*current)), + backoff = std::shared_ptr(backoff_policy(*current))]( + Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + ListRegionBackendBucketsRequest const& r) { + return google::cloud::rest_internal::RestRetryLoop( + retry->clone(), backoff->clone(), idempotency, + [stub](rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + ListRegionBackendBucketsRequest const& request) { + return stub->ListRegionBackendBuckets(rest_context, options, + request); + }, + options, r, function_name); + }, + [](google::cloud::cpp::compute::v1::BackendBucketList r) { + std::vector result( + r.items().size()); + auto& messages = *r.mutable_items(); + std::move(messages.begin(), messages.end(), result.begin()); + return result; + }); +} + +StreamRange +RegionBackendBucketsRestConnectionImpl::ListUsable( + google::cloud::cpp::compute::region_backend_buckets::v1::ListUsableRequest + request) { + request.clear_page_token(); + auto current = google::cloud::internal::SaveCurrentOptions(); + auto idempotency = idempotency_policy(*current)->ListUsable(request); + char const* function_name = __func__; + return google::cloud::internal::MakePaginationRange< + StreamRange>( + current, std::move(request), + [idempotency, function_name, stub = stub_, + retry = std::shared_ptr< + compute_region_backend_buckets_v1::RegionBackendBucketsRetryPolicy>( + retry_policy(*current)), + backoff = std::shared_ptr(backoff_policy(*current))]( + Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + ListUsableRequest const& r) { + return google::cloud::rest_internal::RestRetryLoop( + retry->clone(), backoff->clone(), idempotency, + [stub](rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + ListUsableRequest const& request) { + return stub->ListUsable(rest_context, options, request); + }, + options, r, function_name); + }, + [](google::cloud::cpp::compute::v1::BackendBucketListUsable r) { + std::vector result( + r.items().size()); + auto& messages = *r.mutable_items(); + std::move(messages.begin(), messages.end(), result.begin()); + return result; + }); +} + +future> +RegionBackendBucketsRestConnectionImpl::PatchBackendBucket( + google::cloud::cpp::compute::region_backend_buckets::v1:: + PatchBackendBucketRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::region_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, request, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + PatchBackendBucketRequest const& request) { + return stub->AsyncPatchBackendBucket(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->PatchBackendBucket(request), + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [request](std::string const& op, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest& r) { + r.set_project(request.project()); + r.set_region(request.region()); + r.set_operation(op); + }, + [request](std::string const& op, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest& r) { + r.set_project(request.project()); + r.set_region(request.region()); + r.set_operation(op); + }); +} + +StatusOr +RegionBackendBucketsRestConnectionImpl::PatchBackendBucket( + NoAwaitTag, google::cloud::cpp::compute::region_backend_buckets::v1:: + PatchBackendBucketRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->PatchBackendBucket(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + PatchBackendBucketRequest const& request) { + return stub_->PatchBackendBucket(rest_context, options, request); + }, + *current, request, __func__); +} + +future> +RegionBackendBucketsRestConnectionImpl::PatchBackendBucket( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestAwaitLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::region_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, operation, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [operation](std::string const&, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_region(info.region); + r.set_operation(info.operation); + }, + [operation](std::string const&, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_region(info.region); + r.set_operation(info.operation); + }); +} + +StatusOr +RegionBackendBucketsRestConnectionImpl::SetIamPolicy( + google::cloud::cpp::compute::region_backend_buckets::v1:: + SetIamPolicyRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->SetIamPolicy(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + SetIamPolicyRequest const& request) { + return stub_->SetIamPolicy(rest_context, options, request); + }, + *current, request, __func__); +} + +StatusOr +RegionBackendBucketsRestConnectionImpl::TestIamPermissions( + google::cloud::cpp::compute::region_backend_buckets::v1:: + TestIamPermissionsRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->TestIamPermissions(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + TestIamPermissionsRequest const& request) { + return stub_->TestIamPermissions(rest_context, options, request); + }, + *current, request, __func__); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_backend_buckets_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_rest_connection_impl.h b/google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_rest_connection_impl.h new file mode 100644 index 0000000000000..696c7bfe34c76 --- /dev/null +++ b/google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_rest_connection_impl.h @@ -0,0 +1,162 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_backend_buckets/v1/region_backend_buckets.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_BACKEND_BUCKETS_V1_INTERNAL_REGION_BACKEND_BUCKETS_REST_CONNECTION_IMPL_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_BACKEND_BUCKETS_V1_INTERNAL_REGION_BACKEND_BUCKETS_REST_CONNECTION_IMPL_H + +#include "google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_rest_stub.h" +#include "google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_retry_traits.h" +#include "google/cloud/compute/region_backend_buckets/v1/region_backend_buckets_connection.h" +#include "google/cloud/compute/region_backend_buckets/v1/region_backend_buckets_connection_idempotency_policy.h" +#include "google/cloud/compute/region_backend_buckets/v1/region_backend_buckets_options.h" +#include "google/cloud/compute/region_operations/v1/region_operations.pb.h" +#include "google/cloud/background_threads.h" +#include "google/cloud/backoff_policy.h" +#include "google/cloud/options.h" +#include "google/cloud/status_or.h" +#include "google/cloud/stream_range.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_backend_buckets_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class RegionBackendBucketsRestConnectionImpl + : public compute_region_backend_buckets_v1::RegionBackendBucketsConnection { + public: + ~RegionBackendBucketsRestConnectionImpl() override = default; + + RegionBackendBucketsRestConnectionImpl( + std::unique_ptr background, + std::shared_ptr + stub, + Options options); + + Options options() override { return options_; } + + future> + DeleteBackendBucket(google::cloud::cpp::compute::region_backend_buckets::v1:: + DeleteBackendBucketRequest const& request) override; + + StatusOr DeleteBackendBucket( + NoAwaitTag, google::cloud::cpp::compute::region_backend_buckets::v1:: + DeleteBackendBucketRequest const& request) override; + + future> + DeleteBackendBucket( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + StatusOr GetBackendBucket( + google::cloud::cpp::compute::region_backend_buckets::v1:: + GetBackendBucketRequest const& request) override; + + StatusOr GetIamPolicy( + google::cloud::cpp::compute::region_backend_buckets::v1:: + GetIamPolicyRequest const& request) override; + + future> + InsertBackendBucket(google::cloud::cpp::compute::region_backend_buckets::v1:: + InsertBackendBucketRequest const& request) override; + + StatusOr InsertBackendBucket( + NoAwaitTag, google::cloud::cpp::compute::region_backend_buckets::v1:: + InsertBackendBucketRequest const& request) override; + + future> + InsertBackendBucket( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + StreamRange + ListRegionBackendBuckets( + google::cloud::cpp::compute::region_backend_buckets::v1:: + ListRegionBackendBucketsRequest request) override; + + StreamRange ListUsable( + google::cloud::cpp::compute::region_backend_buckets::v1::ListUsableRequest + request) override; + + future> + PatchBackendBucket(google::cloud::cpp::compute::region_backend_buckets::v1:: + PatchBackendBucketRequest const& request) override; + + StatusOr PatchBackendBucket( + NoAwaitTag, google::cloud::cpp::compute::region_backend_buckets::v1:: + PatchBackendBucketRequest const& request) override; + + future> + PatchBackendBucket( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + StatusOr SetIamPolicy( + google::cloud::cpp::compute::region_backend_buckets::v1:: + SetIamPolicyRequest const& request) override; + + StatusOr + TestIamPermissions(google::cloud::cpp::compute::region_backend_buckets::v1:: + TestIamPermissionsRequest const& request) override; + + private: + static std::unique_ptr< + compute_region_backend_buckets_v1::RegionBackendBucketsRetryPolicy> + retry_policy(Options const& options) { + return options + .get() + ->clone(); + } + + static std::unique_ptr backoff_policy(Options const& options) { + return options + .get() + ->clone(); + } + + static std::unique_ptr + idempotency_policy(Options const& options) { + return options + .get() + ->clone(); + } + + static std::unique_ptr polling_policy(Options const& options) { + return options + .get() + ->clone(); + } + + std::unique_ptr background_; + std::shared_ptr< + compute_region_backend_buckets_v1_internal::RegionBackendBucketsRestStub> + stub_; + Options options_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_backend_buckets_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_BACKEND_BUCKETS_V1_INTERNAL_REGION_BACKEND_BUCKETS_REST_CONNECTION_IMPL_H diff --git a/google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_rest_logging_decorator.cc b/google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_rest_logging_decorator.cc new file mode 100644 index 0000000000000..f477b16acc537 --- /dev/null +++ b/google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_rest_logging_decorator.cc @@ -0,0 +1,266 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_backend_buckets/v1/region_backend_buckets.proto + +#include "google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_rest_logging_decorator.h" +#include "google/cloud/internal/log_wrapper.h" +#include "google/cloud/status_or.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_backend_buckets_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +RegionBackendBucketsRestLogging::RegionBackendBucketsRestLogging( + std::shared_ptr child, + TracingOptions tracing_options, std::set components) + : child_(std::move(child)), + tracing_options_(std::move(tracing_options)), + components_(std::move(components)) {} + +future> +RegionBackendBucketsRestLogging::AsyncDeleteBackendBucket( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + DeleteBackendBucketRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + DeleteBackendBucketRequest const& request) { + return child_->AsyncDeleteBackendBucket(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +StatusOr +RegionBackendBucketsRestLogging::DeleteBackendBucket( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + DeleteBackendBucketRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + DeleteBackendBucketRequest const& request) { + return child_->DeleteBackendBucket(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +StatusOr +RegionBackendBucketsRestLogging::GetBackendBucket( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + GetBackendBucketRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + GetBackendBucketRequest const& request) { + return child_->GetBackendBucket(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +StatusOr +RegionBackendBucketsRestLogging::GetIamPolicy( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + GetIamPolicyRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + GetIamPolicyRequest const& request) { + return child_->GetIamPolicy(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +future> +RegionBackendBucketsRestLogging::AsyncInsertBackendBucket( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + InsertBackendBucketRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + InsertBackendBucketRequest const& request) { + return child_->AsyncInsertBackendBucket(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +StatusOr +RegionBackendBucketsRestLogging::InsertBackendBucket( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + InsertBackendBucketRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + InsertBackendBucketRequest const& request) { + return child_->InsertBackendBucket(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +StatusOr +RegionBackendBucketsRestLogging::ListRegionBackendBuckets( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + ListRegionBackendBucketsRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + ListRegionBackendBucketsRequest const& request) { + return child_->ListRegionBackendBuckets(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +StatusOr +RegionBackendBucketsRestLogging::ListUsable( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + ListUsableRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + ListUsableRequest const& request) { + return child_->ListUsable(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +future> +RegionBackendBucketsRestLogging::AsyncPatchBackendBucket( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + PatchBackendBucketRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + PatchBackendBucketRequest const& request) { + return child_->AsyncPatchBackendBucket(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +StatusOr +RegionBackendBucketsRestLogging::PatchBackendBucket( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + PatchBackendBucketRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + PatchBackendBucketRequest const& request) { + return child_->PatchBackendBucket(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +StatusOr +RegionBackendBucketsRestLogging::SetIamPolicy( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + SetIamPolicyRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + SetIamPolicyRequest const& request) { + return child_->SetIamPolicy(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +StatusOr +RegionBackendBucketsRestLogging::TestIamPermissions( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + TestIamPermissionsRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + TestIamPermissionsRequest const& request) { + return child_->TestIamPermissions(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +future> +RegionBackendBucketsRestLogging::AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + return child_->AsyncGetOperation(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +future RegionBackendBucketsRestLogging::AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + return child_->AsyncCancelOperation(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_backend_buckets_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_rest_logging_decorator.h b/google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_rest_logging_decorator.h new file mode 100644 index 0000000000000..fe88f18c77b61 --- /dev/null +++ b/google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_rest_logging_decorator.h @@ -0,0 +1,151 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_backend_buckets/v1/region_backend_buckets.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_BACKEND_BUCKETS_V1_INTERNAL_REGION_BACKEND_BUCKETS_REST_LOGGING_DECORATOR_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_BACKEND_BUCKETS_V1_INTERNAL_REGION_BACKEND_BUCKETS_REST_LOGGING_DECORATOR_H + +#include "google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_rest_stub.h" +#include "google/cloud/compute/region_backend_buckets/v1/region_backend_buckets.pb.h" +#include "google/cloud/compute/region_operations/v1/region_operations.pb.h" +#include "google/cloud/future.h" +#include "google/cloud/internal/rest_context.h" +#include "google/cloud/tracing_options.h" +#include "google/cloud/version.h" +#include +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_backend_buckets_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class RegionBackendBucketsRestLogging : public RegionBackendBucketsRestStub { + public: + ~RegionBackendBucketsRestLogging() override = default; + RegionBackendBucketsRestLogging( + std::shared_ptr child, + TracingOptions tracing_options, std::set components); + + future> + AsyncDeleteBackendBucket( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + DeleteBackendBucketRequest const& request) override; + + StatusOr DeleteBackendBucket( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + DeleteBackendBucketRequest const& request) override; + + StatusOr GetBackendBucket( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + GetBackendBucketRequest const& request) override; + + StatusOr GetIamPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + GetIamPolicyRequest const& request) override; + + future> + AsyncInsertBackendBucket( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + InsertBackendBucketRequest const& request) override; + + StatusOr InsertBackendBucket( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + InsertBackendBucketRequest const& request) override; + + StatusOr + ListRegionBackendBuckets( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + ListRegionBackendBucketsRequest const& request) override; + + StatusOr ListUsable( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + ListUsableRequest const& request) override; + + future> + AsyncPatchBackendBucket( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + PatchBackendBucketRequest const& request) override; + + StatusOr PatchBackendBucket( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + PatchBackendBucketRequest const& request) override; + + StatusOr SetIamPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + SetIamPolicyRequest const& request) override; + + StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + TestIamPermissionsRequest const& request) override; + + future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) override; + + future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) override; + + private: + std::shared_ptr child_; + TracingOptions tracing_options_; + std::set components_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_backend_buckets_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_BACKEND_BUCKETS_V1_INTERNAL_REGION_BACKEND_BUCKETS_REST_LOGGING_DECORATOR_H diff --git a/google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_rest_metadata_decorator.cc b/google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_rest_metadata_decorator.cc new file mode 100644 index 0000000000000..2656769d68302 --- /dev/null +++ b/google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_rest_metadata_decorator.cc @@ -0,0 +1,193 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_backend_buckets/v1/region_backend_buckets.proto + +#include "google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_rest_metadata_decorator.h" +#include "google/cloud/internal/api_client_header.h" +#include "google/cloud/internal/rest_set_metadata.h" +#include "google/cloud/status_or.h" +#include "absl/strings/str_cat.h" +#include "absl/strings/str_format.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_backend_buckets_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +RegionBackendBucketsRestMetadata::RegionBackendBucketsRestMetadata( + std::shared_ptr child, + std::string api_client_header) + : child_(std::move(child)), + api_client_header_( + api_client_header.empty() + ? google::cloud::internal::GeneratedLibClientHeader() + : std::move(api_client_header)) {} + +future> +RegionBackendBucketsRestMetadata::AsyncDeleteBackendBucket( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + DeleteBackendBucketRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncDeleteBackendBucket(cq, std::move(rest_context), + std::move(options), request); +} + +StatusOr +RegionBackendBucketsRestMetadata::DeleteBackendBucket( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + DeleteBackendBucketRequest const& request) { + SetMetadata(rest_context, options); + return child_->DeleteBackendBucket(rest_context, options, request); +} + +StatusOr +RegionBackendBucketsRestMetadata::GetBackendBucket( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + GetBackendBucketRequest const& request) { + SetMetadata(rest_context, options); + return child_->GetBackendBucket(rest_context, options, request); +} + +StatusOr +RegionBackendBucketsRestMetadata::GetIamPolicy( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + GetIamPolicyRequest const& request) { + SetMetadata(rest_context, options); + return child_->GetIamPolicy(rest_context, options, request); +} + +future> +RegionBackendBucketsRestMetadata::AsyncInsertBackendBucket( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + InsertBackendBucketRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncInsertBackendBucket(cq, std::move(rest_context), + std::move(options), request); +} + +StatusOr +RegionBackendBucketsRestMetadata::InsertBackendBucket( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + InsertBackendBucketRequest const& request) { + SetMetadata(rest_context, options); + return child_->InsertBackendBucket(rest_context, options, request); +} + +StatusOr +RegionBackendBucketsRestMetadata::ListRegionBackendBuckets( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + ListRegionBackendBucketsRequest const& request) { + SetMetadata(rest_context, options); + return child_->ListRegionBackendBuckets(rest_context, options, request); +} + +StatusOr +RegionBackendBucketsRestMetadata::ListUsable( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + ListUsableRequest const& request) { + SetMetadata(rest_context, options); + return child_->ListUsable(rest_context, options, request); +} + +future> +RegionBackendBucketsRestMetadata::AsyncPatchBackendBucket( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + PatchBackendBucketRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncPatchBackendBucket(cq, std::move(rest_context), + std::move(options), request); +} + +StatusOr +RegionBackendBucketsRestMetadata::PatchBackendBucket( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + PatchBackendBucketRequest const& request) { + SetMetadata(rest_context, options); + return child_->PatchBackendBucket(rest_context, options, request); +} + +StatusOr +RegionBackendBucketsRestMetadata::SetIamPolicy( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + SetIamPolicyRequest const& request) { + SetMetadata(rest_context, options); + return child_->SetIamPolicy(rest_context, options, request); +} + +StatusOr +RegionBackendBucketsRestMetadata::TestIamPermissions( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + TestIamPermissionsRequest const& request) { + SetMetadata(rest_context, options); + return child_->TestIamPermissions(rest_context, options, request); +} + +future> +RegionBackendBucketsRestMetadata::AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncGetOperation(cq, std::move(rest_context), + std::move(options), request); +} + +future RegionBackendBucketsRestMetadata::AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncCancelOperation(cq, std::move(rest_context), + std::move(options), request); +} + +void RegionBackendBucketsRestMetadata::SetMetadata( + rest_internal::RestContext& rest_context, Options const& options, + std::vector const& params) { + google::cloud::rest_internal::SetMetadata(rest_context, options, params, + api_client_header_); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_backend_buckets_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_rest_metadata_decorator.h b/google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_rest_metadata_decorator.h new file mode 100644 index 0000000000000..7057fc20cdba2 --- /dev/null +++ b/google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_rest_metadata_decorator.h @@ -0,0 +1,152 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_backend_buckets/v1/region_backend_buckets.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_BACKEND_BUCKETS_V1_INTERNAL_REGION_BACKEND_BUCKETS_REST_METADATA_DECORATOR_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_BACKEND_BUCKETS_V1_INTERNAL_REGION_BACKEND_BUCKETS_REST_METADATA_DECORATOR_H + +#include "google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_rest_stub.h" +#include "google/cloud/compute/region_backend_buckets/v1/region_backend_buckets.pb.h" +#include "google/cloud/compute/region_operations/v1/region_operations.pb.h" +#include "google/cloud/future.h" +#include "google/cloud/rest_options.h" +#include "google/cloud/version.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_backend_buckets_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class RegionBackendBucketsRestMetadata : public RegionBackendBucketsRestStub { + public: + ~RegionBackendBucketsRestMetadata() override = default; + explicit RegionBackendBucketsRestMetadata( + std::shared_ptr child, + std::string api_client_header = ""); + + google::cloud::future> + AsyncDeleteBackendBucket( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + DeleteBackendBucketRequest const& request) override; + + StatusOr DeleteBackendBucket( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + DeleteBackendBucketRequest const& request) override; + + StatusOr GetBackendBucket( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + GetBackendBucketRequest const& request) override; + + StatusOr GetIamPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + GetIamPolicyRequest const& request) override; + + google::cloud::future> + AsyncInsertBackendBucket( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + InsertBackendBucketRequest const& request) override; + + StatusOr InsertBackendBucket( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + InsertBackendBucketRequest const& request) override; + + StatusOr + ListRegionBackendBuckets( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + ListRegionBackendBucketsRequest const& request) override; + + StatusOr ListUsable( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + ListUsableRequest const& request) override; + + google::cloud::future> + AsyncPatchBackendBucket( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + PatchBackendBucketRequest const& request) override; + + StatusOr PatchBackendBucket( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + PatchBackendBucketRequest const& request) override; + + StatusOr SetIamPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + SetIamPolicyRequest const& request) override; + + StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + TestIamPermissionsRequest const& request) override; + + google::cloud::future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) override; + + google::cloud::future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) override; + + private: + void SetMetadata(rest_internal::RestContext& rest_context, + Options const& options, + std::vector const& params = {}); + + std::shared_ptr child_; + std::string api_client_header_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_backend_buckets_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_BACKEND_BUCKETS_V1_INTERNAL_REGION_BACKEND_BUCKETS_REST_METADATA_DECORATOR_H diff --git a/google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_rest_stub.cc b/google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_rest_stub.cc new file mode 100644 index 0000000000000..36839154401e9 --- /dev/null +++ b/google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_rest_stub.cc @@ -0,0 +1,414 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_backend_buckets/v1/region_backend_buckets.proto + +#include "google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_rest_stub.h" +#include "google/cloud/compute/region_backend_buckets/v1/region_backend_buckets.pb.h" +#include "google/cloud/compute/region_operations/v1/region_operations.pb.h" +#include "google/cloud/common_options.h" +#include "google/cloud/internal/rest_stub_helpers.h" +#include "google/cloud/status_or.h" +#include "absl/strings/str_cat.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_backend_buckets_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +DefaultRegionBackendBucketsRestStub::DefaultRegionBackendBucketsRestStub( + Options options) + : service_(rest_internal::MakePooledRestClient( + options.get(), options)), + operations_(rest_internal::MakePooledRestClient( + options.get(), options)), + options_(std::move(options)) {} + +DefaultRegionBackendBucketsRestStub::DefaultRegionBackendBucketsRestStub( + std::shared_ptr service, + std::shared_ptr operations, Options options) + : service_(std::move(service)), + operations_(std::move(operations)), + options_(std::move(options)) {} + +future> +DefaultRegionBackendBucketsRestStub::AsyncDeleteBackendBucket( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + DeleteBackendBucketRequest const& request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto service, auto request, auto rest_context, auto options) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + p.set_value( + rest_internal::Delete( + *service, *rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", *options), + "/", "projects", "/", request.project(), "/", + "regions", "/", request.region(), "/", + "backendBuckets", "/", request.backend_bucket()), + std::move(query_params))); + }, + std::move(p), + service_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +StatusOr +DefaultRegionBackendBucketsRestStub::DeleteBackendBucket( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + DeleteBackendBucketRequest const& request) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Delete( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "regions", "/", + request.region(), "/", "backendBuckets", "/", + request.backend_bucket()), + std::move(query_params)); +} + +StatusOr +DefaultRegionBackendBucketsRestStub::GetBackendBucket( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + GetBackendBucketRequest const& request) { + std::vector> query_params; + return rest_internal::Get( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "regions", "/", + request.region(), "/", "backendBuckets", "/", + request.backend_bucket()), + std::move(query_params)); +} + +StatusOr +DefaultRegionBackendBucketsRestStub::GetIamPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + GetIamPolicyRequest const& request) { + std::vector> query_params; + query_params.push_back( + {"options_requested_policy_version", + std::to_string(request.options_requested_policy_version())}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Get( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "regions", "/", + request.region(), "/", "backendBuckets", "/", + request.resource(), "/", "getIamPolicy"), + std::move(query_params)); +} + +future> +DefaultRegionBackendBucketsRestStub::AsyncInsertBackendBucket( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + InsertBackendBucketRequest const& request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto service, auto request, auto rest_context, auto options) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + p.set_value( + rest_internal::Post( + *service, *rest_context, request.backend_bucket_resource(), + false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", *options), + "/", "projects", "/", request.project(), "/", + "regions", "/", request.region(), "/", + "backendBuckets"), + std::move(query_params))); + }, + std::move(p), + service_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +StatusOr +DefaultRegionBackendBucketsRestStub::InsertBackendBucket( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + InsertBackendBucketRequest const& request) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Post( + *service_, rest_context, request.backend_bucket_resource(), false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "regions", "/", + request.region(), "/", "backendBuckets"), + std::move(query_params)); +} + +StatusOr +DefaultRegionBackendBucketsRestStub::ListRegionBackendBuckets( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + ListRegionBackendBucketsRequest const& request) { + std::vector> query_params; + query_params.push_back({"filter", request.filter()}); + query_params.push_back( + {"max_results", std::to_string(request.max_results())}); + query_params.push_back({"order_by", request.order_by()}); + query_params.push_back({"page_token", request.page_token()}); + query_params.push_back({"return_partial_success", + (request.return_partial_success() ? "1" : "0")}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Get( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "regions", "/", + request.region(), "/", "backendBuckets"), + std::move(query_params)); +} + +StatusOr +DefaultRegionBackendBucketsRestStub::ListUsable( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + ListUsableRequest const& request) { + std::vector> query_params; + query_params.push_back({"filter", request.filter()}); + query_params.push_back( + {"max_results", std::to_string(request.max_results())}); + query_params.push_back({"order_by", request.order_by()}); + query_params.push_back({"page_token", request.page_token()}); + query_params.push_back({"return_partial_success", + (request.return_partial_success() ? "1" : "0")}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Get< + google::cloud::cpp::compute::v1::BackendBucketListUsable>( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "regions", "/", + request.region(), "/", "backendBuckets", "/", "listUsable"), + std::move(query_params)); +} + +future> +DefaultRegionBackendBucketsRestStub::AsyncPatchBackendBucket( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + PatchBackendBucketRequest const& request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto service, auto request, auto rest_context, auto options) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + p.set_value( + rest_internal::Patch( + *service, *rest_context, request.backend_bucket_resource(), + false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", *options), + "/", "projects", "/", request.project(), "/", + "regions", "/", request.region(), "/", + "backendBuckets", "/", request.backend_bucket()), + std::move(query_params))); + }, + std::move(p), + service_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +StatusOr +DefaultRegionBackendBucketsRestStub::PatchBackendBucket( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + PatchBackendBucketRequest const& request) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Patch( + *service_, rest_context, request.backend_bucket_resource(), false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "regions", "/", + request.region(), "/", "backendBuckets", "/", + request.backend_bucket()), + std::move(query_params)); +} + +StatusOr +DefaultRegionBackendBucketsRestStub::SetIamPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + SetIamPolicyRequest const& request) { + std::vector> query_params; + return rest_internal::Post( + *service_, rest_context, request.region_set_policy_request_resource(), + false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "regions", "/", + request.region(), "/", "backendBuckets", "/", + request.resource(), "/", "setIamPolicy"), + std::move(query_params)); +} + +StatusOr +DefaultRegionBackendBucketsRestStub::TestIamPermissions( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + TestIamPermissionsRequest const& request) { + std::vector> query_params; + return rest_internal::Post< + google::cloud::cpp::compute::v1::TestPermissionsResponse>( + *service_, rest_context, request.test_permissions_request_resource(), + false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "regions", "/", + request.region(), "/", "backendBuckets", "/", + request.resource(), "/", "testIamPermissions"), + std::move(query_params)); +} + +future> +DefaultRegionBackendBucketsRestStub::AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto operations, auto request, auto rest_context, + auto options) { + p.set_value( + rest_internal::Get( + *operations, *rest_context, request, false, + absl::StrCat("/compute/", + rest_internal::DetermineApiVersion("v1", *options), + "/projects/", request.project(), "/regions/", + request.region(), "/operations/", + request.operation()))); + }, + std::move(p), + operations_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +future DefaultRegionBackendBucketsRestStub::AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + promise> p; + future> f = p.get_future(); + std::thread t{ + [](auto p, auto operations, auto request, auto rest_context, + auto options) { + p.set_value(rest_internal::Post( + *operations, *rest_context, request, false, + absl::StrCat( + "/compute/", rest_internal::DetermineApiVersion("v1", *options), + "/projects/", request.project(), "/regions/", request.region(), + "/operations/", request.operation()))); + }, + std::move(p), + operations_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get().status(); + }); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_backend_buckets_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_rest_stub.h b/google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_rest_stub.h new file mode 100644 index 0000000000000..c950e502b16b3 --- /dev/null +++ b/google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_rest_stub.h @@ -0,0 +1,251 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_backend_buckets/v1/region_backend_buckets.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_BACKEND_BUCKETS_V1_INTERNAL_REGION_BACKEND_BUCKETS_REST_STUB_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_BACKEND_BUCKETS_V1_INTERNAL_REGION_BACKEND_BUCKETS_REST_STUB_H + +#include "google/cloud/compute/region_backend_buckets/v1/region_backend_buckets.pb.h" +#include "google/cloud/compute/region_operations/v1/region_operations.pb.h" +#include "google/cloud/completion_queue.h" +#include "google/cloud/internal/rest_client.h" +#include "google/cloud/internal/rest_context.h" +#include "google/cloud/status_or.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_backend_buckets_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class RegionBackendBucketsRestStub { + public: + virtual ~RegionBackendBucketsRestStub() = default; + + virtual future> + AsyncDeleteBackendBucket( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + DeleteBackendBucketRequest const& request) = 0; + + virtual StatusOr + DeleteBackendBucket(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + DeleteBackendBucketRequest const& request) = 0; + + virtual StatusOr + GetBackendBucket(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + GetBackendBucketRequest const& request) = 0; + + virtual StatusOr GetIamPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + GetIamPolicyRequest const& request) = 0; + + virtual future> + AsyncInsertBackendBucket( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + InsertBackendBucketRequest const& request) = 0; + + virtual StatusOr + InsertBackendBucket(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + InsertBackendBucketRequest const& request) = 0; + + virtual StatusOr + ListRegionBackendBuckets( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + ListRegionBackendBucketsRequest const& request) = 0; + + virtual StatusOr + ListUsable(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + ListUsableRequest const& request) = 0; + + virtual future> + AsyncPatchBackendBucket( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + PatchBackendBucketRequest const& request) = 0; + + virtual StatusOr + PatchBackendBucket(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + PatchBackendBucketRequest const& request) = 0; + + virtual StatusOr SetIamPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + SetIamPolicyRequest const& request) = 0; + + virtual StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + TestIamPermissionsRequest const& request) = 0; + + virtual future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) = 0; + + virtual future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) = 0; +}; + +class DefaultRegionBackendBucketsRestStub + : public RegionBackendBucketsRestStub { + public: + ~DefaultRegionBackendBucketsRestStub() override = default; + + explicit DefaultRegionBackendBucketsRestStub(Options options); + DefaultRegionBackendBucketsRestStub( + std::shared_ptr service, + std::shared_ptr operations, Options options); + + future> + AsyncDeleteBackendBucket( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + DeleteBackendBucketRequest const& request) override; + + StatusOr DeleteBackendBucket( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + DeleteBackendBucketRequest const& request) override; + + StatusOr GetBackendBucket( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + GetBackendBucketRequest const& request) override; + + StatusOr GetIamPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + GetIamPolicyRequest const& request) override; + + future> + AsyncInsertBackendBucket( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + InsertBackendBucketRequest const& request) override; + + StatusOr InsertBackendBucket( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + InsertBackendBucketRequest const& request) override; + + StatusOr + ListRegionBackendBuckets( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + ListRegionBackendBucketsRequest const& request) override; + + StatusOr ListUsable( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + ListUsableRequest const& request) override; + + future> + AsyncPatchBackendBucket( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + PatchBackendBucketRequest const& request) override; + + StatusOr PatchBackendBucket( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + PatchBackendBucketRequest const& request) override; + + StatusOr SetIamPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + SetIamPolicyRequest const& request) override; + + StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_backend_buckets::v1:: + TestIamPermissionsRequest const& request) override; + + future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) override; + + future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) override; + + private: + std::shared_ptr service_; + std::shared_ptr operations_; + Options options_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_backend_buckets_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_BACKEND_BUCKETS_V1_INTERNAL_REGION_BACKEND_BUCKETS_REST_STUB_H diff --git a/google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_rest_stub_factory.cc b/google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_rest_stub_factory.cc new file mode 100644 index 0000000000000..b4d96e54bf2ba --- /dev/null +++ b/google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_rest_stub_factory.cc @@ -0,0 +1,57 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_backend_buckets/v1/region_backend_buckets.proto + +#include "google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_rest_stub_factory.h" +#include "google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_rest_logging_decorator.h" +#include "google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_rest_metadata_decorator.h" +#include "google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_rest_stub.h" +#include "google/cloud/common_options.h" +#include "google/cloud/internal/algorithm.h" +#include "google/cloud/internal/populate_rest_options.h" +#include "google/cloud/log.h" +#include "google/cloud/options.h" +#include "google/cloud/rest_options.h" +#include "absl/strings/match.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_backend_buckets_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +std::shared_ptr +CreateDefaultRegionBackendBucketsRestStub(Options const& options) { + auto opts = internal::PopulateRestOptions(options); + std::shared_ptr stub = + std::make_shared(std::move(opts)); + stub = std::make_shared(std::move(stub)); + if (internal::Contains(options.get(), "rpc")) { + GCP_LOG(INFO) << "Enabled logging for REST rpc calls"; + stub = std::make_shared( + std::move(stub), options.get(), + options.get()); + } + return stub; +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_backend_buckets_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_rest_stub_factory.h b/google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_rest_stub_factory.h new file mode 100644 index 0000000000000..b12900f1f8a83 --- /dev/null +++ b/google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_rest_stub_factory.h @@ -0,0 +1,41 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_backend_buckets/v1/region_backend_buckets.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_BACKEND_BUCKETS_V1_INTERNAL_REGION_BACKEND_BUCKETS_REST_STUB_FACTORY_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_BACKEND_BUCKETS_V1_INTERNAL_REGION_BACKEND_BUCKETS_REST_STUB_FACTORY_H + +#include "google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_rest_stub.h" +#include "google/cloud/options.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_backend_buckets_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +std::shared_ptr +CreateDefaultRegionBackendBucketsRestStub(Options const& options); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_backend_buckets_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_BACKEND_BUCKETS_V1_INTERNAL_REGION_BACKEND_BUCKETS_REST_STUB_FACTORY_H diff --git a/google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_retry_traits.h b/google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_retry_traits.h new file mode 100644 index 0000000000000..ccf39fa19149d --- /dev/null +++ b/google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_retry_traits.h @@ -0,0 +1,44 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_backend_buckets/v1/region_backend_buckets.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_BACKEND_BUCKETS_V1_INTERNAL_REGION_BACKEND_BUCKETS_RETRY_TRAITS_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_BACKEND_BUCKETS_V1_INTERNAL_REGION_BACKEND_BUCKETS_RETRY_TRAITS_H + +#include "google/cloud/status.h" +#include "google/cloud/version.h" + +namespace google { +namespace cloud { +namespace compute_region_backend_buckets_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/// Define the gRPC status code semantics for retrying requests. +struct RegionBackendBucketsRetryTraits { + static bool IsPermanentFailure(google::cloud::Status const& status) { + return status.code() != StatusCode::kOk && + status.code() != StatusCode::kUnavailable; + } +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_backend_buckets_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_BACKEND_BUCKETS_V1_INTERNAL_REGION_BACKEND_BUCKETS_RETRY_TRAITS_H diff --git a/google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_sources.cc b/google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_sources.cc new file mode 100644 index 0000000000000..507b9dd87cf33 --- /dev/null +++ b/google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_sources.cc @@ -0,0 +1,32 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_backend_buckets/v1/region_backend_buckets.proto + +// NOLINTBEGIN(bugprone-suspicious-include) +#include "google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_option_defaults.cc" +#include "google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_rest_connection_impl.cc" +#include "google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_rest_logging_decorator.cc" +#include "google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_rest_metadata_decorator.cc" +#include "google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_rest_stub.cc" +#include "google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_rest_stub_factory.cc" +#include "google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_tracing_connection.cc" +#include "google/cloud/compute/region_backend_buckets/v1/region_backend_buckets_client.cc" +#include "google/cloud/compute/region_backend_buckets/v1/region_backend_buckets_connection.cc" +#include "google/cloud/compute/region_backend_buckets/v1/region_backend_buckets_connection_idempotency_policy.cc" +#include "google/cloud/compute/region_backend_buckets/v1/region_backend_buckets_rest_connection.cc" +// NOLINTEND(bugprone-suspicious-include) diff --git a/google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_tracing_connection.cc b/google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_tracing_connection.cc new file mode 100644 index 0000000000000..ea77134d846e0 --- /dev/null +++ b/google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_tracing_connection.cc @@ -0,0 +1,230 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_backend_buckets/v1/region_backend_buckets.proto + +#include "google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_tracing_connection.h" +#include "google/cloud/internal/opentelemetry.h" +#include "google/cloud/internal/traced_stream_range.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_backend_buckets_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +RegionBackendBucketsTracingConnection::RegionBackendBucketsTracingConnection( + std::shared_ptr< + compute_region_backend_buckets_v1::RegionBackendBucketsConnection> + child) + : child_(std::move(child)) {} + +future> +RegionBackendBucketsTracingConnection::DeleteBackendBucket( + google::cloud::cpp::compute::region_backend_buckets::v1:: + DeleteBackendBucketRequest const& request) { + auto span = internal::MakeSpan( + "compute_region_backend_buckets_v1::RegionBackendBucketsConnection::" + "DeleteBackendBucket"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), + child_->DeleteBackendBucket(request)); +} + +StatusOr +RegionBackendBucketsTracingConnection::DeleteBackendBucket( + NoAwaitTag, google::cloud::cpp::compute::region_backend_buckets::v1:: + DeleteBackendBucketRequest const& request) { + auto span = internal::MakeSpan( + "compute_region_backend_buckets_v1::RegionBackendBucketsConnection::" + "DeleteBackendBucket"); + opentelemetry::trace::Scope scope(span); + return internal::EndSpan(*span, + child_->DeleteBackendBucket(NoAwaitTag{}, request)); +} + +future> +RegionBackendBucketsTracingConnection::DeleteBackendBucket( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto span = internal::MakeSpan( + "compute_region_backend_buckets_v1::RegionBackendBucketsConnection::" + "DeleteBackendBucket"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), + child_->DeleteBackendBucket(operation)); +} + +StatusOr +RegionBackendBucketsTracingConnection::GetBackendBucket( + google::cloud::cpp::compute::region_backend_buckets::v1:: + GetBackendBucketRequest const& request) { + auto span = internal::MakeSpan( + "compute_region_backend_buckets_v1::RegionBackendBucketsConnection::" + "GetBackendBucket"); + auto scope = opentelemetry::trace::Scope(span); + return internal::EndSpan(*span, child_->GetBackendBucket(request)); +} + +StatusOr +RegionBackendBucketsTracingConnection::GetIamPolicy( + google::cloud::cpp::compute::region_backend_buckets::v1:: + GetIamPolicyRequest const& request) { + auto span = internal::MakeSpan( + "compute_region_backend_buckets_v1::RegionBackendBucketsConnection::" + "GetIamPolicy"); + auto scope = opentelemetry::trace::Scope(span); + return internal::EndSpan(*span, child_->GetIamPolicy(request)); +} + +future> +RegionBackendBucketsTracingConnection::InsertBackendBucket( + google::cloud::cpp::compute::region_backend_buckets::v1:: + InsertBackendBucketRequest const& request) { + auto span = internal::MakeSpan( + "compute_region_backend_buckets_v1::RegionBackendBucketsConnection::" + "InsertBackendBucket"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), + child_->InsertBackendBucket(request)); +} + +StatusOr +RegionBackendBucketsTracingConnection::InsertBackendBucket( + NoAwaitTag, google::cloud::cpp::compute::region_backend_buckets::v1:: + InsertBackendBucketRequest const& request) { + auto span = internal::MakeSpan( + "compute_region_backend_buckets_v1::RegionBackendBucketsConnection::" + "InsertBackendBucket"); + opentelemetry::trace::Scope scope(span); + return internal::EndSpan(*span, + child_->InsertBackendBucket(NoAwaitTag{}, request)); +} + +future> +RegionBackendBucketsTracingConnection::InsertBackendBucket( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto span = internal::MakeSpan( + "compute_region_backend_buckets_v1::RegionBackendBucketsConnection::" + "InsertBackendBucket"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), + child_->InsertBackendBucket(operation)); +} + +StreamRange +RegionBackendBucketsTracingConnection::ListRegionBackendBuckets( + google::cloud::cpp::compute::region_backend_buckets::v1:: + ListRegionBackendBucketsRequest request) { + auto span = internal::MakeSpan( + "compute_region_backend_buckets_v1::RegionBackendBucketsConnection::" + "ListRegionBackendBuckets"); + internal::OTelScope scope(span); + auto sr = child_->ListRegionBackendBuckets(std::move(request)); + return internal::MakeTracedStreamRange< + google::cloud::cpp::compute::v1::BackendBucket>(std::move(span), + std::move(sr)); +} + +StreamRange +RegionBackendBucketsTracingConnection::ListUsable( + google::cloud::cpp::compute::region_backend_buckets::v1::ListUsableRequest + request) { + auto span = internal::MakeSpan( + "compute_region_backend_buckets_v1::RegionBackendBucketsConnection::" + "ListUsable"); + internal::OTelScope scope(span); + auto sr = child_->ListUsable(std::move(request)); + return internal::MakeTracedStreamRange< + google::cloud::cpp::compute::v1::BackendBucket>(std::move(span), + std::move(sr)); +} + +future> +RegionBackendBucketsTracingConnection::PatchBackendBucket( + google::cloud::cpp::compute::region_backend_buckets::v1:: + PatchBackendBucketRequest const& request) { + auto span = internal::MakeSpan( + "compute_region_backend_buckets_v1::RegionBackendBucketsConnection::" + "PatchBackendBucket"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), + child_->PatchBackendBucket(request)); +} + +StatusOr +RegionBackendBucketsTracingConnection::PatchBackendBucket( + NoAwaitTag, google::cloud::cpp::compute::region_backend_buckets::v1:: + PatchBackendBucketRequest const& request) { + auto span = internal::MakeSpan( + "compute_region_backend_buckets_v1::RegionBackendBucketsConnection::" + "PatchBackendBucket"); + opentelemetry::trace::Scope scope(span); + return internal::EndSpan(*span, + child_->PatchBackendBucket(NoAwaitTag{}, request)); +} + +future> +RegionBackendBucketsTracingConnection::PatchBackendBucket( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto span = internal::MakeSpan( + "compute_region_backend_buckets_v1::RegionBackendBucketsConnection::" + "PatchBackendBucket"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), + child_->PatchBackendBucket(operation)); +} + +StatusOr +RegionBackendBucketsTracingConnection::SetIamPolicy( + google::cloud::cpp::compute::region_backend_buckets::v1:: + SetIamPolicyRequest const& request) { + auto span = internal::MakeSpan( + "compute_region_backend_buckets_v1::RegionBackendBucketsConnection::" + "SetIamPolicy"); + auto scope = opentelemetry::trace::Scope(span); + return internal::EndSpan(*span, child_->SetIamPolicy(request)); +} + +StatusOr +RegionBackendBucketsTracingConnection::TestIamPermissions( + google::cloud::cpp::compute::region_backend_buckets::v1:: + TestIamPermissionsRequest const& request) { + auto span = internal::MakeSpan( + "compute_region_backend_buckets_v1::RegionBackendBucketsConnection::" + "TestIamPermissions"); + auto scope = opentelemetry::trace::Scope(span); + return internal::EndSpan(*span, child_->TestIamPermissions(request)); +} + +std::shared_ptr< + compute_region_backend_buckets_v1::RegionBackendBucketsConnection> +MakeRegionBackendBucketsTracingConnection( + std::shared_ptr< + compute_region_backend_buckets_v1::RegionBackendBucketsConnection> + conn) { + if (internal::TracingEnabled(conn->options())) { + conn = std::make_shared( + std::move(conn)); + } + return conn; +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_backend_buckets_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_tracing_connection.h b/google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_tracing_connection.h new file mode 100644 index 0000000000000..89e2ffb6d7ea3 --- /dev/null +++ b/google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_tracing_connection.h @@ -0,0 +1,129 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_backend_buckets/v1/region_backend_buckets.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_BACKEND_BUCKETS_V1_INTERNAL_REGION_BACKEND_BUCKETS_TRACING_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_BACKEND_BUCKETS_V1_INTERNAL_REGION_BACKEND_BUCKETS_TRACING_CONNECTION_H + +#include "google/cloud/compute/region_backend_buckets/v1/region_backend_buckets_connection.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_backend_buckets_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class RegionBackendBucketsTracingConnection + : public compute_region_backend_buckets_v1::RegionBackendBucketsConnection { + public: + ~RegionBackendBucketsTracingConnection() override = default; + + explicit RegionBackendBucketsTracingConnection( + std::shared_ptr< + compute_region_backend_buckets_v1::RegionBackendBucketsConnection> + child); + + Options options() override { return child_->options(); } + + future> + DeleteBackendBucket(google::cloud::cpp::compute::region_backend_buckets::v1:: + DeleteBackendBucketRequest const& request) override; + + StatusOr DeleteBackendBucket( + NoAwaitTag, google::cloud::cpp::compute::region_backend_buckets::v1:: + DeleteBackendBucketRequest const& request) override; + + future> + DeleteBackendBucket( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + StatusOr GetBackendBucket( + google::cloud::cpp::compute::region_backend_buckets::v1:: + GetBackendBucketRequest const& request) override; + + StatusOr GetIamPolicy( + google::cloud::cpp::compute::region_backend_buckets::v1:: + GetIamPolicyRequest const& request) override; + + future> + InsertBackendBucket(google::cloud::cpp::compute::region_backend_buckets::v1:: + InsertBackendBucketRequest const& request) override; + + StatusOr InsertBackendBucket( + NoAwaitTag, google::cloud::cpp::compute::region_backend_buckets::v1:: + InsertBackendBucketRequest const& request) override; + + future> + InsertBackendBucket( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + StreamRange + ListRegionBackendBuckets( + google::cloud::cpp::compute::region_backend_buckets::v1:: + ListRegionBackendBucketsRequest request) override; + + StreamRange ListUsable( + google::cloud::cpp::compute::region_backend_buckets::v1::ListUsableRequest + request) override; + + future> + PatchBackendBucket(google::cloud::cpp::compute::region_backend_buckets::v1:: + PatchBackendBucketRequest const& request) override; + + StatusOr PatchBackendBucket( + NoAwaitTag, google::cloud::cpp::compute::region_backend_buckets::v1:: + PatchBackendBucketRequest const& request) override; + + future> + PatchBackendBucket( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + StatusOr SetIamPolicy( + google::cloud::cpp::compute::region_backend_buckets::v1:: + SetIamPolicyRequest const& request) override; + + StatusOr + TestIamPermissions(google::cloud::cpp::compute::region_backend_buckets::v1:: + TestIamPermissionsRequest const& request) override; + + private: + std::shared_ptr< + compute_region_backend_buckets_v1::RegionBackendBucketsConnection> + child_; +}; + +/** + * Conditionally applies the tracing decorator to the given connection. + * + * The connection is only decorated if tracing is enabled (as determined by the + * connection's options). + */ +std::shared_ptr< + compute_region_backend_buckets_v1::RegionBackendBucketsConnection> +MakeRegionBackendBucketsTracingConnection( + std::shared_ptr< + compute_region_backend_buckets_v1::RegionBackendBucketsConnection> + conn); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_backend_buckets_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_BACKEND_BUCKETS_V1_INTERNAL_REGION_BACKEND_BUCKETS_TRACING_CONNECTION_H diff --git a/google/cloud/compute/region_backend_buckets/v1/mocks/mock_region_backend_buckets_connection.h b/google/cloud/compute/region_backend_buckets/v1/mocks/mock_region_backend_buckets_connection.h new file mode 100644 index 0000000000000..30064b86c789c --- /dev/null +++ b/google/cloud/compute/region_backend_buckets/v1/mocks/mock_region_backend_buckets_connection.h @@ -0,0 +1,215 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_backend_buckets/v1/region_backend_buckets.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_BACKEND_BUCKETS_V1_MOCKS_MOCK_REGION_BACKEND_BUCKETS_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_BACKEND_BUCKETS_V1_MOCKS_MOCK_REGION_BACKEND_BUCKETS_CONNECTION_H + +#include "google/cloud/compute/region_backend_buckets/v1/region_backend_buckets_connection.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_backend_buckets_v1_mocks { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/** + * A class to mock `RegionBackendBucketsConnection`. + * + * Application developers may want to test their code with simulated responses, + * including errors, from an object of type `RegionBackendBucketsClient`. To do + * so, construct an object of type `RegionBackendBucketsClient` with an instance + * of this class. Then use the Google Test framework functions to program the + * behavior of this mock. + * + * @see [This example][bq-mock] for how to test your application with GoogleTest. + * While the example showcases types from the BigQuery library, the underlying + * principles apply for any pair of `*Client` and `*Connection`. + * + * [bq-mock]: @cloud_cpp_docs_link{bigquery,bigquery-read-mock} + */ +class MockRegionBackendBucketsConnection + : public compute_region_backend_buckets_v1::RegionBackendBucketsConnection { + public: + MOCK_METHOD(Options, options, (), (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// DeleteBackendBucket(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + DeleteBackendBucket, + (google::cloud::cpp::compute::region_backend_buckets::v1:: + DeleteBackendBucketRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// EXPECT_CALL(*mock, DeleteBackendBucket(_, _)) + /// @endcode + MOCK_METHOD(StatusOr, + DeleteBackendBucket, + (NoAwaitTag, google::cloud::cpp::compute::region_backend_buckets:: + v1::DeleteBackendBucketRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// DeleteBackendBucket(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + DeleteBackendBucket, + (google::cloud::cpp::compute::v1::Operation const& operation), + (override)); + + MOCK_METHOD(StatusOr, + GetBackendBucket, + (google::cloud::cpp::compute::region_backend_buckets::v1:: + GetBackendBucketRequest const& request), + (override)); + + MOCK_METHOD(StatusOr, GetIamPolicy, + (google::cloud::cpp::compute::region_backend_buckets::v1:: + GetIamPolicyRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// InsertBackendBucket(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + InsertBackendBucket, + (google::cloud::cpp::compute::region_backend_buckets::v1:: + InsertBackendBucketRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// EXPECT_CALL(*mock, InsertBackendBucket(_, _)) + /// @endcode + MOCK_METHOD(StatusOr, + InsertBackendBucket, + (NoAwaitTag, google::cloud::cpp::compute::region_backend_buckets:: + v1::InsertBackendBucketRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// InsertBackendBucket(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + InsertBackendBucket, + (google::cloud::cpp::compute::v1::Operation const& operation), + (override)); + + MOCK_METHOD((StreamRange), + ListRegionBackendBuckets, + (google::cloud::cpp::compute::region_backend_buckets::v1:: + ListRegionBackendBucketsRequest request), + (override)); + + MOCK_METHOD((StreamRange), + ListUsable, + (google::cloud::cpp::compute::region_backend_buckets::v1:: + ListUsableRequest request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// PatchBackendBucket(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + PatchBackendBucket, + (google::cloud::cpp::compute::region_backend_buckets::v1:: + PatchBackendBucketRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// EXPECT_CALL(*mock, PatchBackendBucket(_, _)) + /// @endcode + MOCK_METHOD(StatusOr, + PatchBackendBucket, + (NoAwaitTag, google::cloud::cpp::compute::region_backend_buckets:: + v1::PatchBackendBucketRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// PatchBackendBucket(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + PatchBackendBucket, + (google::cloud::cpp::compute::v1::Operation const& operation), + (override)); + + MOCK_METHOD(StatusOr, SetIamPolicy, + (google::cloud::cpp::compute::region_backend_buckets::v1:: + SetIamPolicyRequest const& request), + (override)); + + MOCK_METHOD( + StatusOr, + TestIamPermissions, + (google::cloud::cpp::compute::region_backend_buckets::v1:: + TestIamPermissionsRequest const& request), + (override)); +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_backend_buckets_v1_mocks +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_BACKEND_BUCKETS_V1_MOCKS_MOCK_REGION_BACKEND_BUCKETS_CONNECTION_H diff --git a/google/cloud/compute/region_backend_buckets/v1/region_backend_buckets_client.cc b/google/cloud/compute/region_backend_buckets/v1/region_backend_buckets_client.cc new file mode 100644 index 0000000000000..6e7c20c1d959b --- /dev/null +++ b/google/cloud/compute/region_backend_buckets/v1/region_backend_buckets_client.cc @@ -0,0 +1,349 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_backend_buckets/v1/region_backend_buckets.proto + +#include "google/cloud/compute/region_backend_buckets/v1/region_backend_buckets_client.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_backend_buckets_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +RegionBackendBucketsClient::RegionBackendBucketsClient( + std::shared_ptr connection, Options opts) + : connection_(std::move(connection)), + options_( + internal::MergeOptions(std::move(opts), connection_->options())) {} +RegionBackendBucketsClient::~RegionBackendBucketsClient() = default; + +future> +RegionBackendBucketsClient::DeleteBackendBucket( + std::string const& project, std::string const& region, + std::string const& backend_bucket, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_backend_buckets::v1:: + DeleteBackendBucketRequest request; + request.set_project(project); + request.set_region(region); + request.set_backend_bucket(backend_bucket); + return connection_->DeleteBackendBucket(request); +} + +StatusOr +RegionBackendBucketsClient::DeleteBackendBucket( + NoAwaitTag, std::string const& project, std::string const& region, + std::string const& backend_bucket, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_backend_buckets::v1:: + DeleteBackendBucketRequest request; + request.set_project(project); + request.set_region(region); + request.set_backend_bucket(backend_bucket); + return connection_->DeleteBackendBucket(NoAwaitTag{}, request); +} + +future> +RegionBackendBucketsClient::DeleteBackendBucket( + google::cloud::cpp::compute::region_backend_buckets::v1:: + DeleteBackendBucketRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->DeleteBackendBucket(request); +} + +StatusOr +RegionBackendBucketsClient::DeleteBackendBucket( + NoAwaitTag, + google::cloud::cpp::compute::region_backend_buckets::v1:: + DeleteBackendBucketRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->DeleteBackendBucket(NoAwaitTag{}, request); +} + +future> +RegionBackendBucketsClient::DeleteBackendBucket( + google::cloud::cpp::compute::v1::Operation const& operation, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->DeleteBackendBucket(operation); +} + +StatusOr +RegionBackendBucketsClient::GetBackendBucket(std::string const& project, + std::string const& region, + std::string const& backend_bucket, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_backend_buckets::v1:: + GetBackendBucketRequest request; + request.set_project(project); + request.set_region(region); + request.set_backend_bucket(backend_bucket); + return connection_->GetBackendBucket(request); +} + +StatusOr +RegionBackendBucketsClient::GetBackendBucket( + google::cloud::cpp::compute::region_backend_buckets::v1:: + GetBackendBucketRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->GetBackendBucket(request); +} + +StatusOr +RegionBackendBucketsClient::GetIamPolicy(std::string const& project, + std::string const& region, + std::string const& resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_backend_buckets::v1::GetIamPolicyRequest + request; + request.set_project(project); + request.set_region(region); + request.set_resource(resource); + return connection_->GetIamPolicy(request); +} + +StatusOr +RegionBackendBucketsClient::GetIamPolicy( + google::cloud::cpp::compute::region_backend_buckets::v1:: + GetIamPolicyRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->GetIamPolicy(request); +} + +future> +RegionBackendBucketsClient::InsertBackendBucket( + std::string const& project, std::string const& region, + google::cloud::cpp::compute::v1::BackendBucket const& + backend_bucket_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_backend_buckets::v1:: + InsertBackendBucketRequest request; + request.set_project(project); + request.set_region(region); + *request.mutable_backend_bucket_resource() = backend_bucket_resource; + return connection_->InsertBackendBucket(request); +} + +StatusOr +RegionBackendBucketsClient::InsertBackendBucket( + NoAwaitTag, std::string const& project, std::string const& region, + google::cloud::cpp::compute::v1::BackendBucket const& + backend_bucket_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_backend_buckets::v1:: + InsertBackendBucketRequest request; + request.set_project(project); + request.set_region(region); + *request.mutable_backend_bucket_resource() = backend_bucket_resource; + return connection_->InsertBackendBucket(NoAwaitTag{}, request); +} + +future> +RegionBackendBucketsClient::InsertBackendBucket( + google::cloud::cpp::compute::region_backend_buckets::v1:: + InsertBackendBucketRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->InsertBackendBucket(request); +} + +StatusOr +RegionBackendBucketsClient::InsertBackendBucket( + NoAwaitTag, + google::cloud::cpp::compute::region_backend_buckets::v1:: + InsertBackendBucketRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->InsertBackendBucket(NoAwaitTag{}, request); +} + +future> +RegionBackendBucketsClient::InsertBackendBucket( + google::cloud::cpp::compute::v1::Operation const& operation, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->InsertBackendBucket(operation); +} + +StreamRange +RegionBackendBucketsClient::ListRegionBackendBuckets(std::string const& project, + std::string const& region, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_backend_buckets::v1:: + ListRegionBackendBucketsRequest request; + request.set_project(project); + request.set_region(region); + return connection_->ListRegionBackendBuckets(request); +} + +StreamRange +RegionBackendBucketsClient::ListRegionBackendBuckets( + google::cloud::cpp::compute::region_backend_buckets::v1:: + ListRegionBackendBucketsRequest request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->ListRegionBackendBuckets(std::move(request)); +} + +StreamRange +RegionBackendBucketsClient::ListUsable(std::string const& project, + std::string const& region, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_backend_buckets::v1::ListUsableRequest + request; + request.set_project(project); + request.set_region(region); + return connection_->ListUsable(request); +} + +StreamRange +RegionBackendBucketsClient::ListUsable( + google::cloud::cpp::compute::region_backend_buckets::v1::ListUsableRequest + request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->ListUsable(std::move(request)); +} + +future> +RegionBackendBucketsClient::PatchBackendBucket( + std::string const& project, std::string const& region, + std::string const& backend_bucket, + google::cloud::cpp::compute::v1::BackendBucket const& + backend_bucket_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_backend_buckets::v1:: + PatchBackendBucketRequest request; + request.set_project(project); + request.set_region(region); + request.set_backend_bucket(backend_bucket); + *request.mutable_backend_bucket_resource() = backend_bucket_resource; + return connection_->PatchBackendBucket(request); +} + +StatusOr +RegionBackendBucketsClient::PatchBackendBucket( + NoAwaitTag, std::string const& project, std::string const& region, + std::string const& backend_bucket, + google::cloud::cpp::compute::v1::BackendBucket const& + backend_bucket_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_backend_buckets::v1:: + PatchBackendBucketRequest request; + request.set_project(project); + request.set_region(region); + request.set_backend_bucket(backend_bucket); + *request.mutable_backend_bucket_resource() = backend_bucket_resource; + return connection_->PatchBackendBucket(NoAwaitTag{}, request); +} + +future> +RegionBackendBucketsClient::PatchBackendBucket( + google::cloud::cpp::compute::region_backend_buckets::v1:: + PatchBackendBucketRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->PatchBackendBucket(request); +} + +StatusOr +RegionBackendBucketsClient::PatchBackendBucket( + NoAwaitTag, + google::cloud::cpp::compute::region_backend_buckets::v1:: + PatchBackendBucketRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->PatchBackendBucket(NoAwaitTag{}, request); +} + +future> +RegionBackendBucketsClient::PatchBackendBucket( + google::cloud::cpp::compute::v1::Operation const& operation, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->PatchBackendBucket(operation); +} + +StatusOr +RegionBackendBucketsClient::SetIamPolicy( + std::string const& project, std::string const& region, + std::string const& resource, + google::cloud::cpp::compute::v1::RegionSetPolicyRequest const& + region_set_policy_request_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_backend_buckets::v1::SetIamPolicyRequest + request; + request.set_project(project); + request.set_region(region); + request.set_resource(resource); + *request.mutable_region_set_policy_request_resource() = + region_set_policy_request_resource; + return connection_->SetIamPolicy(request); +} + +StatusOr +RegionBackendBucketsClient::SetIamPolicy( + google::cloud::cpp::compute::region_backend_buckets::v1:: + SetIamPolicyRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->SetIamPolicy(request); +} + +StatusOr +RegionBackendBucketsClient::TestIamPermissions( + std::string const& project, std::string const& region, + std::string const& resource, + google::cloud::cpp::compute::v1::TestPermissionsRequest const& + test_permissions_request_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_backend_buckets::v1:: + TestIamPermissionsRequest request; + request.set_project(project); + request.set_region(region); + request.set_resource(resource); + *request.mutable_test_permissions_request_resource() = + test_permissions_request_resource; + return connection_->TestIamPermissions(request); +} + +StatusOr +RegionBackendBucketsClient::TestIamPermissions( + google::cloud::cpp::compute::region_backend_buckets::v1:: + TestIamPermissionsRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->TestIamPermissions(request); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_backend_buckets_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_backend_buckets/v1/region_backend_buckets_client.h b/google/cloud/compute/region_backend_buckets/v1/region_backend_buckets_client.h new file mode 100644 index 0000000000000..e682f45a19e86 --- /dev/null +++ b/google/cloud/compute/region_backend_buckets/v1/region_backend_buckets_client.h @@ -0,0 +1,905 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_backend_buckets/v1/region_backend_buckets.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_BACKEND_BUCKETS_V1_REGION_BACKEND_BUCKETS_CLIENT_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_BACKEND_BUCKETS_V1_REGION_BACKEND_BUCKETS_CLIENT_H + +#include "google/cloud/compute/region_backend_buckets/v1/region_backend_buckets_rest_connection.h" +#include "google/cloud/future.h" +#include "google/cloud/no_await_tag.h" +#include "google/cloud/options.h" +#include "google/cloud/polling_policy.h" +#include "google/cloud/status_or.h" +#include "google/cloud/version.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_backend_buckets_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/// +/// Service for the regionBackendBuckets resource. +/// https://cloud.google.com/compute/docs/reference/rest/v1/regionBackendBuckets +/// +/// @par Equality +/// +/// Instances of this class created via copy-construction or copy-assignment +/// always compare equal. Instances created with equal +/// `std::shared_ptr<*Connection>` objects compare equal. Objects that compare +/// equal share the same underlying resources. +/// +/// @par Performance +/// +/// Creating a new instance of this class is a relatively expensive operation, +/// new objects establish new connections to the service. In contrast, +/// copy-construction, move-construction, and the corresponding assignment +/// operations are relatively efficient as the copies share all underlying +/// resources. +/// +/// @par Thread Safety +/// +/// Concurrent access to different instances of this class, even if they compare +/// equal, is guaranteed to work. Two or more threads operating on the same +/// instance of this class is not guaranteed to work. Since copy-construction +/// and move-construction is a relatively efficient operation, consider using +/// such a copy when using this class from multiple threads. +/// +class RegionBackendBucketsClient { + public: + explicit RegionBackendBucketsClient( + std::shared_ptr connection, + Options opts = {}); + ~RegionBackendBucketsClient(); + + ///@{ + /// @name Copy and move support + RegionBackendBucketsClient(RegionBackendBucketsClient const&) = default; + RegionBackendBucketsClient& operator=(RegionBackendBucketsClient const&) = + default; + RegionBackendBucketsClient(RegionBackendBucketsClient&&) = default; + RegionBackendBucketsClient& operator=(RegionBackendBucketsClient&&) = default; + ///@} + + ///@{ + /// @name Equality + friend bool operator==(RegionBackendBucketsClient const& a, + RegionBackendBucketsClient const& b) { + return a.connection_ == b.connection_; + } + friend bool operator!=(RegionBackendBucketsClient const& a, + RegionBackendBucketsClient const& b) { + return !(a == b); + } + ///@} + + // clang-format off + /// + /// Deletes the specified regional BackendBucket resource. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionBackendBuckets/delete + /// + /// @param project Project ID for this request. + /// @param region Name of the region scoping this request. + /// @param backend_bucket Name of the BackendBucket resource to delete. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_backend_buckets.v1.DeleteBackendBucketRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_backend_buckets/v1/region_backend_buckets.proto#L154} + /// + // clang-format on + future> + DeleteBackendBucket(std::string const& project, std::string const& region, + std::string const& backend_bucket, Options opts = {}); + + // clang-format off + /// + /// @copybrief DeleteBackendBucket + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr DeleteBackendBucket( + NoAwaitTag, std::string const& project, std::string const& region, + std::string const& backend_bucket, Options opts = {}); + + // clang-format off + /// + /// Deletes the specified regional BackendBucket resource. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionBackendBuckets/delete + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.region_backend_buckets.v1.DeleteBackendBucketRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_backend_buckets.v1.DeleteBackendBucketRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_backend_buckets/v1/region_backend_buckets.proto#L154} + /// + // clang-format on + future> + DeleteBackendBucket(google::cloud::cpp::compute::region_backend_buckets::v1:: + DeleteBackendBucketRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief DeleteBackendBucket + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr DeleteBackendBucket( + NoAwaitTag, + google::cloud::cpp::compute::region_backend_buckets::v1:: + DeleteBackendBucketRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief DeleteBackendBucket + /// + /// This method accepts a `google::cloud::cpp::compute::v1::Operation` that corresponds + /// to a previously started Long Running Operation (LRO) and polls the status + /// of the LRO in the background. + /// + // clang-format on + future> + DeleteBackendBucket( + google::cloud::cpp::compute::v1::Operation const& operation, + Options opts = {}); + + // clang-format off + /// + /// Returns the specified regional BackendBucket resource. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionBackendBuckets/get + /// + /// @param project Project ID for this request. + /// @param region Name of the region scoping this request. + /// @param backend_bucket Name of the BackendBucket resource to return. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.BackendBucket]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_backend_buckets.v1.GetBackendBucketRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_backend_buckets/v1/region_backend_buckets.proto#L191} + /// [google.cloud.cpp.compute.v1.BackendBucket]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_012.proto#L28} + /// + // clang-format on + StatusOr GetBackendBucket( + std::string const& project, std::string const& region, + std::string const& backend_bucket, Options opts = {}); + + // clang-format off + /// + /// Returns the specified regional BackendBucket resource. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionBackendBuckets/get + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.region_backend_buckets.v1.GetBackendBucketRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.BackendBucket]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_backend_buckets.v1.GetBackendBucketRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_backend_buckets/v1/region_backend_buckets.proto#L191} + /// [google.cloud.cpp.compute.v1.BackendBucket]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_012.proto#L28} + /// + // clang-format on + StatusOr GetBackendBucket( + google::cloud::cpp::compute::region_backend_buckets::v1:: + GetBackendBucketRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// Gets the access control policy for a resource. May be empty if no such + /// policy or resource exists. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionBackendBuckets/getIamPolicy + /// + /// @param project Project ID for this request. + /// @param region The name of the region for this request. + /// @param resource Name or id of the resource for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.Policy]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_backend_buckets.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_backend_buckets/v1/region_backend_buckets.proto#L206} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} + /// + // clang-format on + StatusOr GetIamPolicy( + std::string const& project, std::string const& region, + std::string const& resource, Options opts = {}); + + // clang-format off + /// + /// Gets the access control policy for a resource. May be empty if no such + /// policy or resource exists. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionBackendBuckets/getIamPolicy + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.region_backend_buckets.v1.GetIamPolicyRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.Policy]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_backend_buckets.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_backend_buckets/v1/region_backend_buckets.proto#L206} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} + /// + // clang-format on + StatusOr GetIamPolicy( + google::cloud::cpp::compute::region_backend_buckets::v1:: + GetIamPolicyRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// Creates a RegionBackendBucket in the specified project in the given scope + /// using the parameters that are included in the request. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionBackendBuckets/insert + /// + /// @param project Project ID for this request. + /// @param region Name of the region of this request. + /// @param backend_bucket_resource The BackendBucket for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_backend_buckets.v1.InsertBackendBucketRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_backend_buckets/v1/region_backend_buckets.proto#L225} + /// + // clang-format on + future> + InsertBackendBucket(std::string const& project, std::string const& region, + google::cloud::cpp::compute::v1::BackendBucket const& + backend_bucket_resource, + Options opts = {}); + + // clang-format off + /// + /// @copybrief InsertBackendBucket + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr InsertBackendBucket( + NoAwaitTag, std::string const& project, std::string const& region, + google::cloud::cpp::compute::v1::BackendBucket const& + backend_bucket_resource, + Options opts = {}); + + // clang-format off + /// + /// Creates a RegionBackendBucket in the specified project in the given scope + /// using the parameters that are included in the request. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionBackendBuckets/insert + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.region_backend_buckets.v1.InsertBackendBucketRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_backend_buckets.v1.InsertBackendBucketRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_backend_buckets/v1/region_backend_buckets.proto#L225} + /// + // clang-format on + future> + InsertBackendBucket(google::cloud::cpp::compute::region_backend_buckets::v1:: + InsertBackendBucketRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief InsertBackendBucket + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr InsertBackendBucket( + NoAwaitTag, + google::cloud::cpp::compute::region_backend_buckets::v1:: + InsertBackendBucketRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief InsertBackendBucket + /// + /// This method accepts a `google::cloud::cpp::compute::v1::Operation` that corresponds + /// to a previously started Long Running Operation (LRO) and polls the status + /// of the LRO in the background. + /// + // clang-format on + future> + InsertBackendBucket( + google::cloud::cpp::compute::v1::Operation const& operation, + Options opts = {}); + + // clang-format off + /// + /// Retrieves the list of BackendBucket resources available to the specified + /// project in the given region. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionBackendBuckets/list + /// + /// @param project Project ID for this request. + /// @param region Name of the region of this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return a [StreamRange](@ref google::cloud::StreamRange) + /// to iterate of the results. See the documentation of this type for + /// details. In brief, this class has `begin()` and `end()` member + /// functions returning a iterator class meeting the + /// [input iterator requirements]. The value type for this iterator is a + /// [`StatusOr`] as the iteration may fail even after some values are + /// retrieved successfully, for example, if there is a network disconnect. + /// An empty set of results does not indicate an error, it indicates + /// that there are no resources meeting the request criteria. + /// On a successful iteration the `StatusOr` contains elements of type + /// [google.cloud.cpp.compute.v1.BackendBucket], or rather, + /// the C++ class generated by Protobuf from that type. Please consult the + /// Protobuf documentation for details on the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_backend_buckets.v1.ListRegionBackendBucketsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_backend_buckets/v1/region_backend_buckets.proto#L261} + /// [google.cloud.cpp.compute.v1.BackendBucket]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_012.proto#L28} + /// + // clang-format on + StreamRange + ListRegionBackendBuckets(std::string const& project, + std::string const& region, Options opts = {}); + + // clang-format off + /// + /// Retrieves the list of BackendBucket resources available to the specified + /// project in the given region. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionBackendBuckets/list + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.region_backend_buckets.v1.ListRegionBackendBucketsRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return a [StreamRange](@ref google::cloud::StreamRange) + /// to iterate of the results. See the documentation of this type for + /// details. In brief, this class has `begin()` and `end()` member + /// functions returning a iterator class meeting the + /// [input iterator requirements]. The value type for this iterator is a + /// [`StatusOr`] as the iteration may fail even after some values are + /// retrieved successfully, for example, if there is a network disconnect. + /// An empty set of results does not indicate an error, it indicates + /// that there are no resources meeting the request criteria. + /// On a successful iteration the `StatusOr` contains elements of type + /// [google.cloud.cpp.compute.v1.BackendBucket], or rather, + /// the C++ class generated by Protobuf from that type. Please consult the + /// Protobuf documentation for details on the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_backend_buckets.v1.ListRegionBackendBucketsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_backend_buckets/v1/region_backend_buckets.proto#L261} + /// [google.cloud.cpp.compute.v1.BackendBucket]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_012.proto#L28} + /// + // clang-format on + StreamRange + ListRegionBackendBuckets(google::cloud::cpp::compute::region_backend_buckets:: + v1::ListRegionBackendBucketsRequest request, + Options opts = {}); + + // clang-format off + /// + /// Retrieves a list of all usable backend buckets in the specified project in + /// the given region. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionBackendBuckets/listUsable + /// + /// @param project Project ID for this request. + /// @param region Name of the region scoping this request. + /// It must be a string that meets the requirements in RFC1035. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return a [StreamRange](@ref google::cloud::StreamRange) + /// to iterate of the results. See the documentation of this type for + /// details. In brief, this class has `begin()` and `end()` member + /// functions returning a iterator class meeting the + /// [input iterator requirements]. The value type for this iterator is a + /// [`StatusOr`] as the iteration may fail even after some values are + /// retrieved successfully, for example, if there is a network disconnect. + /// An empty set of results does not indicate an error, it indicates + /// that there are no resources meeting the request criteria. + /// On a successful iteration the `StatusOr` contains elements of type + /// [google.cloud.cpp.compute.v1.BackendBucket], or rather, + /// the C++ class generated by Protobuf from that type. Please consult the + /// Protobuf documentation for details on the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_backend_buckets.v1.ListUsableRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_backend_buckets/v1/region_backend_buckets.proto#L366} + /// [google.cloud.cpp.compute.v1.BackendBucket]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_012.proto#L28} + /// + // clang-format on + StreamRange ListUsable( + std::string const& project, std::string const& region, Options opts = {}); + + // clang-format off + /// + /// Retrieves a list of all usable backend buckets in the specified project in + /// the given region. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionBackendBuckets/listUsable + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.region_backend_buckets.v1.ListUsableRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return a [StreamRange](@ref google::cloud::StreamRange) + /// to iterate of the results. See the documentation of this type for + /// details. In brief, this class has `begin()` and `end()` member + /// functions returning a iterator class meeting the + /// [input iterator requirements]. The value type for this iterator is a + /// [`StatusOr`] as the iteration may fail even after some values are + /// retrieved successfully, for example, if there is a network disconnect. + /// An empty set of results does not indicate an error, it indicates + /// that there are no resources meeting the request criteria. + /// On a successful iteration the `StatusOr` contains elements of type + /// [google.cloud.cpp.compute.v1.BackendBucket], or rather, + /// the C++ class generated by Protobuf from that type. Please consult the + /// Protobuf documentation for details on the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_backend_buckets.v1.ListUsableRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_backend_buckets/v1/region_backend_buckets.proto#L366} + /// [google.cloud.cpp.compute.v1.BackendBucket]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_012.proto#L28} + /// + // clang-format on + StreamRange ListUsable( + google::cloud::cpp::compute::region_backend_buckets::v1::ListUsableRequest + request, + Options opts = {}); + + // clang-format off + /// + /// Updates the specified BackendBucket resource with the data included in the + /// request. This method supportsPATCH + /// semantics and uses theJSON merge + /// patch format and processing rules. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionBackendBuckets/patch + /// + /// @param project Project ID for this request. + /// @param region Name of the region scoping this request. + /// @param backend_bucket Name of the BackendBucket resource to patch. + /// @param backend_bucket_resource The BackendBucket for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_backend_buckets.v1.PatchBackendBucketRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_backend_buckets/v1/region_backend_buckets.proto#L472} + /// + // clang-format on + future> + PatchBackendBucket(std::string const& project, std::string const& region, + std::string const& backend_bucket, + google::cloud::cpp::compute::v1::BackendBucket const& + backend_bucket_resource, + Options opts = {}); + + // clang-format off + /// + /// @copybrief PatchBackendBucket + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr PatchBackendBucket( + NoAwaitTag, std::string const& project, std::string const& region, + std::string const& backend_bucket, + google::cloud::cpp::compute::v1::BackendBucket const& + backend_bucket_resource, + Options opts = {}); + + // clang-format off + /// + /// Updates the specified BackendBucket resource with the data included in the + /// request. This method supportsPATCH + /// semantics and uses theJSON merge + /// patch format and processing rules. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionBackendBuckets/patch + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.region_backend_buckets.v1.PatchBackendBucketRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_backend_buckets.v1.PatchBackendBucketRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_backend_buckets/v1/region_backend_buckets.proto#L472} + /// + // clang-format on + future> + PatchBackendBucket(google::cloud::cpp::compute::region_backend_buckets::v1:: + PatchBackendBucketRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief PatchBackendBucket + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr PatchBackendBucket( + NoAwaitTag, + google::cloud::cpp::compute::region_backend_buckets::v1:: + PatchBackendBucketRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief PatchBackendBucket + /// + /// This method accepts a `google::cloud::cpp::compute::v1::Operation` that corresponds + /// to a previously started Long Running Operation (LRO) and polls the status + /// of the LRO in the background. + /// + // clang-format on + future> + PatchBackendBucket( + google::cloud::cpp::compute::v1::Operation const& operation, + Options opts = {}); + + // clang-format off + /// + /// Sets the access control policy on the specified resource. + /// Replaces any existing policy. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionBackendBuckets/setIamPolicy + /// + /// @param project Project ID for this request. + /// @param region The name of the region for this request. + /// @param resource Name or id of the resource for this request. + /// @param region_set_policy_request_resource The RegionSetPolicyRequest for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.Policy]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_backend_buckets.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_backend_buckets/v1/region_backend_buckets.proto#L513} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} + /// + // clang-format on + StatusOr SetIamPolicy( + std::string const& project, std::string const& region, + std::string const& resource, + google::cloud::cpp::compute::v1::RegionSetPolicyRequest const& + region_set_policy_request_resource, + Options opts = {}); + + // clang-format off + /// + /// Sets the access control policy on the specified resource. + /// Replaces any existing policy. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionBackendBuckets/setIamPolicy + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.region_backend_buckets.v1.SetIamPolicyRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.Policy]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_backend_buckets.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_backend_buckets/v1/region_backend_buckets.proto#L513} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} + /// + // clang-format on + StatusOr SetIamPolicy( + google::cloud::cpp::compute::region_backend_buckets::v1:: + SetIamPolicyRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// Returns permissions that a caller has on the specified resource. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionBackendBuckets/testIamPermissions + /// + /// @param project Project ID for this request. + /// @param region The name of the region for this request. + /// @param resource Name or id of the resource for this request. + /// @param test_permissions_request_resource The TestPermissionsRequest for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.TestPermissionsResponse]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_backend_buckets.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_backend_buckets/v1/region_backend_buckets.proto#L533} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} + /// + // clang-format on + StatusOr + TestIamPermissions( + std::string const& project, std::string const& region, + std::string const& resource, + google::cloud::cpp::compute::v1::TestPermissionsRequest const& + test_permissions_request_resource, + Options opts = {}); + + // clang-format off + /// + /// Returns permissions that a caller has on the specified resource. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionBackendBuckets/testIamPermissions + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.region_backend_buckets.v1.TestIamPermissionsRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.TestPermissionsResponse]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_backend_buckets.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_backend_buckets/v1/region_backend_buckets.proto#L533} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} + /// + // clang-format on + StatusOr + TestIamPermissions(google::cloud::cpp::compute::region_backend_buckets::v1:: + TestIamPermissionsRequest const& request, + Options opts = {}); + + private: + std::shared_ptr connection_; + Options options_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_backend_buckets_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_BACKEND_BUCKETS_V1_REGION_BACKEND_BUCKETS_CLIENT_H diff --git a/google/cloud/compute/region_backend_buckets/v1/region_backend_buckets_connection.cc b/google/cloud/compute/region_backend_buckets/v1/region_backend_buckets_connection.cc new file mode 100644 index 0000000000000..aea0cc99084a5 --- /dev/null +++ b/google/cloud/compute/region_backend_buckets/v1/region_backend_buckets_connection.cc @@ -0,0 +1,162 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_backend_buckets/v1/region_backend_buckets.proto + +#include "google/cloud/compute/region_backend_buckets/v1/region_backend_buckets_connection.h" +#include "google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_option_defaults.h" +#include "google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_tracing_connection.h" +#include "google/cloud/compute/region_backend_buckets/v1/region_backend_buckets_options.h" +#include "google/cloud/background_threads.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/grpc_options.h" +#include "google/cloud/internal/pagination_range.h" +#include "google/cloud/internal/unified_grpc_credentials.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_backend_buckets_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +RegionBackendBucketsConnection::~RegionBackendBucketsConnection() = default; + +future> +RegionBackendBucketsConnection::DeleteBackendBucket( + google::cloud::cpp::compute::region_backend_buckets::v1:: + DeleteBackendBucketRequest const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +RegionBackendBucketsConnection::DeleteBackendBucket( + NoAwaitTag, google::cloud::cpp::compute::region_backend_buckets::v1:: + DeleteBackendBucketRequest const&) { + return StatusOr( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +RegionBackendBucketsConnection::DeleteBackendBucket( + google::cloud::cpp::compute::v1::Operation const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +RegionBackendBucketsConnection::GetBackendBucket( + google::cloud::cpp::compute::region_backend_buckets::v1:: + GetBackendBucketRequest const&) { + return Status(StatusCode::kUnimplemented, "not implemented"); +} + +StatusOr +RegionBackendBucketsConnection::GetIamPolicy( + google::cloud::cpp::compute::region_backend_buckets::v1:: + GetIamPolicyRequest const&) { + return Status(StatusCode::kUnimplemented, "not implemented"); +} + +future> +RegionBackendBucketsConnection::InsertBackendBucket( + google::cloud::cpp::compute::region_backend_buckets::v1:: + InsertBackendBucketRequest const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +RegionBackendBucketsConnection::InsertBackendBucket( + NoAwaitTag, google::cloud::cpp::compute::region_backend_buckets::v1:: + InsertBackendBucketRequest const&) { + return StatusOr( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +RegionBackendBucketsConnection::InsertBackendBucket( + google::cloud::cpp::compute::v1::Operation const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StreamRange +RegionBackendBucketsConnection::ListRegionBackendBuckets( + google::cloud::cpp::compute::region_backend_buckets::v1:: + ListRegionBackendBucketsRequest) { // NOLINT(performance-unnecessary-value-param) + return google::cloud::internal::MakeUnimplementedPaginationRange< + StreamRange>(); +} + +StreamRange +RegionBackendBucketsConnection::ListUsable( + google::cloud::cpp::compute::region_backend_buckets::v1:: + ListUsableRequest) { // NOLINT(performance-unnecessary-value-param) + return google::cloud::internal::MakeUnimplementedPaginationRange< + StreamRange>(); +} + +future> +RegionBackendBucketsConnection::PatchBackendBucket( + google::cloud::cpp::compute::region_backend_buckets::v1:: + PatchBackendBucketRequest const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +RegionBackendBucketsConnection::PatchBackendBucket( + NoAwaitTag, google::cloud::cpp::compute::region_backend_buckets::v1:: + PatchBackendBucketRequest const&) { + return StatusOr( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +RegionBackendBucketsConnection::PatchBackendBucket( + google::cloud::cpp::compute::v1::Operation const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +RegionBackendBucketsConnection::SetIamPolicy( + google::cloud::cpp::compute::region_backend_buckets::v1:: + SetIamPolicyRequest const&) { + return Status(StatusCode::kUnimplemented, "not implemented"); +} + +StatusOr +RegionBackendBucketsConnection::TestIamPermissions( + google::cloud::cpp::compute::region_backend_buckets::v1:: + TestIamPermissionsRequest const&) { + return Status(StatusCode::kUnimplemented, "not implemented"); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_backend_buckets_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_backend_buckets/v1/region_backend_buckets_connection.h b/google/cloud/compute/region_backend_buckets/v1/region_backend_buckets_connection.h new file mode 100644 index 0000000000000..d30131f2e204a --- /dev/null +++ b/google/cloud/compute/region_backend_buckets/v1/region_backend_buckets_connection.h @@ -0,0 +1,266 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_backend_buckets/v1/region_backend_buckets.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_BACKEND_BUCKETS_V1_REGION_BACKEND_BUCKETS_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_BACKEND_BUCKETS_V1_REGION_BACKEND_BUCKETS_CONNECTION_H + +#include "google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_retry_traits.h" +#include "google/cloud/compute/region_backend_buckets/v1/region_backend_buckets.pb.h" +#include "google/cloud/compute/region_backend_buckets/v1/region_backend_buckets_connection_idempotency_policy.h" +#include "google/cloud/backoff_policy.h" +#include "google/cloud/future.h" +#include "google/cloud/internal/retry_policy_impl.h" +#include "google/cloud/no_await_tag.h" +#include "google/cloud/options.h" +#include "google/cloud/polling_policy.h" +#include "google/cloud/status_or.h" +#include "google/cloud/stream_range.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_backend_buckets_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/// The retry policy for `RegionBackendBucketsConnection`. +class RegionBackendBucketsRetryPolicy : public ::google::cloud::RetryPolicy { + public: + /// Creates a new instance of the policy, reset to the initial state. + virtual std::unique_ptr clone() const = 0; +}; + +/** + * A retry policy for `RegionBackendBucketsConnection` based on counting errors. + * + * This policy stops retrying if: + * - An RPC returns a non-transient error. + * - More than a prescribed number of transient failures is detected. + * + * In this class the following status codes are treated as transient errors: + * - [`kUnavailable`](@ref google::cloud::StatusCode) + */ +class RegionBackendBucketsLimitedErrorCountRetryPolicy + : public RegionBackendBucketsRetryPolicy { + public: + /** + * Create an instance that tolerates up to @p maximum_failures transient + * errors. + * + * @note Disable the retry loop by providing an instance of this policy with + * @p maximum_failures == 0. + */ + explicit RegionBackendBucketsLimitedErrorCountRetryPolicy( + int maximum_failures) + : impl_(maximum_failures) {} + + RegionBackendBucketsLimitedErrorCountRetryPolicy( + RegionBackendBucketsLimitedErrorCountRetryPolicy&& rhs) noexcept + : RegionBackendBucketsLimitedErrorCountRetryPolicy( + rhs.maximum_failures()) {} + RegionBackendBucketsLimitedErrorCountRetryPolicy( + RegionBackendBucketsLimitedErrorCountRetryPolicy const& rhs) noexcept + : RegionBackendBucketsLimitedErrorCountRetryPolicy( + rhs.maximum_failures()) {} + + int maximum_failures() const { return impl_.maximum_failures(); } + + bool OnFailure(Status const& status) override { + return impl_.OnFailure(status); + } + bool IsExhausted() const override { return impl_.IsExhausted(); } + bool IsPermanentFailure(Status const& status) const override { + return impl_.IsPermanentFailure(status); + } + std::unique_ptr clone() const override { + return std::make_unique( + maximum_failures()); + } + + // This is provided only for backwards compatibility. + using BaseType = RegionBackendBucketsRetryPolicy; + + private: + google::cloud::internal::LimitedErrorCountRetryPolicy< + compute_region_backend_buckets_v1_internal:: + RegionBackendBucketsRetryTraits> + impl_; +}; + +/** + * A retry policy for `RegionBackendBucketsConnection` based on elapsed time. + * + * This policy stops retrying if: + * - An RPC returns a non-transient error. + * - The elapsed time in the retry loop exceeds a prescribed duration. + * + * In this class the following status codes are treated as transient errors: + * - [`kUnavailable`](@ref google::cloud::StatusCode) + */ +class RegionBackendBucketsLimitedTimeRetryPolicy + : public RegionBackendBucketsRetryPolicy { + public: + /** + * Constructor given a `std::chrono::duration<>` object. + * + * @tparam DurationRep a placeholder to match the `Rep` tparam for @p + * duration's type. The semantics of this template parameter are + * documented in `std::chrono::duration<>`. In brief, the underlying + * arithmetic type used to store the number of ticks. For our purposes it + * is simply a formal parameter. + * @tparam DurationPeriod a placeholder to match the `Period` tparam for @p + * duration's type. The semantics of this template parameter are + * documented in `std::chrono::duration<>`. In brief, the length of the + * tick in seconds, expressed as a `std::ratio<>`. For our purposes it is + * simply a formal parameter. + * @param maximum_duration the maximum time allowed before the policy expires. + * While the application can express this time in any units they desire, + * the class truncates to milliseconds. + * + * @see https://en.cppreference.com/w/cpp/chrono/duration for more information + * about `std::chrono::duration`. + */ + template + explicit RegionBackendBucketsLimitedTimeRetryPolicy( + std::chrono::duration maximum_duration) + : impl_(maximum_duration) {} + + RegionBackendBucketsLimitedTimeRetryPolicy( + RegionBackendBucketsLimitedTimeRetryPolicy&& rhs) noexcept + : RegionBackendBucketsLimitedTimeRetryPolicy(rhs.maximum_duration()) {} + RegionBackendBucketsLimitedTimeRetryPolicy( + RegionBackendBucketsLimitedTimeRetryPolicy const& rhs) noexcept + : RegionBackendBucketsLimitedTimeRetryPolicy(rhs.maximum_duration()) {} + + std::chrono::milliseconds maximum_duration() const { + return impl_.maximum_duration(); + } + + bool OnFailure(Status const& status) override { + return impl_.OnFailure(status); + } + bool IsExhausted() const override { return impl_.IsExhausted(); } + bool IsPermanentFailure(Status const& status) const override { + return impl_.IsPermanentFailure(status); + } + std::unique_ptr clone() const override { + return std::make_unique( + maximum_duration()); + } + + // This is provided only for backwards compatibility. + using BaseType = RegionBackendBucketsRetryPolicy; + + private: + google::cloud::internal::LimitedTimeRetryPolicy< + compute_region_backend_buckets_v1_internal:: + RegionBackendBucketsRetryTraits> + impl_; +}; + +/** + * The `RegionBackendBucketsConnection` object for `RegionBackendBucketsClient`. + * + * This interface defines virtual methods for each of the user-facing overload + * sets in `RegionBackendBucketsClient`. This allows users to inject custom + * behavior (e.g., with a Google Mock object) when writing tests that use + * objects of type `RegionBackendBucketsClient`. + * + * To create a concrete instance, see `MakeRegionBackendBucketsConnection()`. + * + * For mocking, see + * `compute_region_backend_buckets_v1_mocks::MockRegionBackendBucketsConnection`. + */ +class RegionBackendBucketsConnection { + public: + virtual ~RegionBackendBucketsConnection() = 0; + + virtual Options options() { return Options{}; } + + virtual future> + DeleteBackendBucket(google::cloud::cpp::compute::region_backend_buckets::v1:: + DeleteBackendBucketRequest const& request); + + virtual StatusOr + DeleteBackendBucket(NoAwaitTag, + google::cloud::cpp::compute::region_backend_buckets::v1:: + DeleteBackendBucketRequest const& request); + + virtual future> + DeleteBackendBucket( + google::cloud::cpp::compute::v1::Operation const& operation); + + virtual StatusOr + GetBackendBucket(google::cloud::cpp::compute::region_backend_buckets::v1:: + GetBackendBucketRequest const& request); + + virtual StatusOr GetIamPolicy( + google::cloud::cpp::compute::region_backend_buckets::v1:: + GetIamPolicyRequest const& request); + + virtual future> + InsertBackendBucket(google::cloud::cpp::compute::region_backend_buckets::v1:: + InsertBackendBucketRequest const& request); + + virtual StatusOr + InsertBackendBucket(NoAwaitTag, + google::cloud::cpp::compute::region_backend_buckets::v1:: + InsertBackendBucketRequest const& request); + + virtual future> + InsertBackendBucket( + google::cloud::cpp::compute::v1::Operation const& operation); + + virtual StreamRange + ListRegionBackendBuckets(google::cloud::cpp::compute::region_backend_buckets:: + v1::ListRegionBackendBucketsRequest request); + + virtual StreamRange + ListUsable( + google::cloud::cpp::compute::region_backend_buckets::v1::ListUsableRequest + request); + + virtual future> + PatchBackendBucket(google::cloud::cpp::compute::region_backend_buckets::v1:: + PatchBackendBucketRequest const& request); + + virtual StatusOr + PatchBackendBucket(NoAwaitTag, + google::cloud::cpp::compute::region_backend_buckets::v1:: + PatchBackendBucketRequest const& request); + + virtual future> + PatchBackendBucket( + google::cloud::cpp::compute::v1::Operation const& operation); + + virtual StatusOr SetIamPolicy( + google::cloud::cpp::compute::region_backend_buckets::v1:: + SetIamPolicyRequest const& request); + + virtual StatusOr + TestIamPermissions(google::cloud::cpp::compute::region_backend_buckets::v1:: + TestIamPermissionsRequest const& request); +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_backend_buckets_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_BACKEND_BUCKETS_V1_REGION_BACKEND_BUCKETS_CONNECTION_H diff --git a/google/cloud/compute/region_backend_buckets/v1/region_backend_buckets_connection_idempotency_policy.cc b/google/cloud/compute/region_backend_buckets/v1/region_backend_buckets_connection_idempotency_policy.cc new file mode 100644 index 0000000000000..212b92daaea9e --- /dev/null +++ b/google/cloud/compute/region_backend_buckets/v1/region_backend_buckets_connection_idempotency_policy.cc @@ -0,0 +1,104 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_backend_buckets/v1/region_backend_buckets.proto + +#include "google/cloud/compute/region_backend_buckets/v1/region_backend_buckets_connection_idempotency_policy.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_backend_buckets_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +using ::google::cloud::Idempotency; + +RegionBackendBucketsConnectionIdempotencyPolicy:: + ~RegionBackendBucketsConnectionIdempotencyPolicy() = default; + +std::unique_ptr +RegionBackendBucketsConnectionIdempotencyPolicy::clone() const { + return std::make_unique( + *this); +} + +Idempotency +RegionBackendBucketsConnectionIdempotencyPolicy::DeleteBackendBucket( + google::cloud::cpp::compute::region_backend_buckets::v1:: + DeleteBackendBucketRequest const&) { + return Idempotency::kNonIdempotent; +} + +Idempotency RegionBackendBucketsConnectionIdempotencyPolicy::GetBackendBucket( + google::cloud::cpp::compute::region_backend_buckets::v1:: + GetBackendBucketRequest const&) { + return Idempotency::kIdempotent; +} + +Idempotency RegionBackendBucketsConnectionIdempotencyPolicy::GetIamPolicy( + google::cloud::cpp::compute::region_backend_buckets::v1:: + GetIamPolicyRequest const&) { + return Idempotency::kIdempotent; +} + +Idempotency +RegionBackendBucketsConnectionIdempotencyPolicy::InsertBackendBucket( + google::cloud::cpp::compute::region_backend_buckets::v1:: + InsertBackendBucketRequest const&) { + return Idempotency::kNonIdempotent; +} + +Idempotency +RegionBackendBucketsConnectionIdempotencyPolicy::ListRegionBackendBuckets( + google::cloud::cpp::compute::region_backend_buckets::v1:: + ListRegionBackendBucketsRequest) { // NOLINT + return Idempotency::kIdempotent; +} + +Idempotency RegionBackendBucketsConnectionIdempotencyPolicy::ListUsable( + google::cloud::cpp::compute::region_backend_buckets::v1:: + ListUsableRequest) { // NOLINT + return Idempotency::kIdempotent; +} + +Idempotency RegionBackendBucketsConnectionIdempotencyPolicy::PatchBackendBucket( + google::cloud::cpp::compute::region_backend_buckets::v1:: + PatchBackendBucketRequest const&) { + return Idempotency::kNonIdempotent; +} + +Idempotency RegionBackendBucketsConnectionIdempotencyPolicy::SetIamPolicy( + google::cloud::cpp::compute::region_backend_buckets::v1:: + SetIamPolicyRequest const&) { + return Idempotency::kNonIdempotent; +} + +Idempotency RegionBackendBucketsConnectionIdempotencyPolicy::TestIamPermissions( + google::cloud::cpp::compute::region_backend_buckets::v1:: + TestIamPermissionsRequest const&) { + return Idempotency::kNonIdempotent; +} + +std::unique_ptr +MakeDefaultRegionBackendBucketsConnectionIdempotencyPolicy() { + return std::make_unique(); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_backend_buckets_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_backend_buckets/v1/region_backend_buckets_connection_idempotency_policy.h b/google/cloud/compute/region_backend_buckets/v1/region_backend_buckets_connection_idempotency_policy.h new file mode 100644 index 0000000000000..4a64cbb129d37 --- /dev/null +++ b/google/cloud/compute/region_backend_buckets/v1/region_backend_buckets_connection_idempotency_policy.h @@ -0,0 +1,86 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_backend_buckets/v1/region_backend_buckets.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_BACKEND_BUCKETS_V1_REGION_BACKEND_BUCKETS_CONNECTION_IDEMPOTENCY_POLICY_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_BACKEND_BUCKETS_V1_REGION_BACKEND_BUCKETS_CONNECTION_IDEMPOTENCY_POLICY_H + +#include "google/cloud/compute/region_backend_buckets/v1/region_backend_buckets.pb.h" +#include "google/cloud/idempotency.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_backend_buckets_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class RegionBackendBucketsConnectionIdempotencyPolicy { + public: + virtual ~RegionBackendBucketsConnectionIdempotencyPolicy(); + + /// Create a new copy of this object. + virtual std::unique_ptr + clone() const; + + virtual google::cloud::Idempotency DeleteBackendBucket( + google::cloud::cpp::compute::region_backend_buckets::v1:: + DeleteBackendBucketRequest const& request); + + virtual google::cloud::Idempotency GetBackendBucket( + google::cloud::cpp::compute::region_backend_buckets::v1:: + GetBackendBucketRequest const& request); + + virtual google::cloud::Idempotency GetIamPolicy( + google::cloud::cpp::compute::region_backend_buckets::v1:: + GetIamPolicyRequest const& request); + + virtual google::cloud::Idempotency InsertBackendBucket( + google::cloud::cpp::compute::region_backend_buckets::v1:: + InsertBackendBucketRequest const& request); + + virtual google::cloud::Idempotency ListRegionBackendBuckets( + google::cloud::cpp::compute::region_backend_buckets::v1:: + ListRegionBackendBucketsRequest request); + + virtual google::cloud::Idempotency ListUsable( + google::cloud::cpp::compute::region_backend_buckets::v1::ListUsableRequest + request); + + virtual google::cloud::Idempotency PatchBackendBucket( + google::cloud::cpp::compute::region_backend_buckets::v1:: + PatchBackendBucketRequest const& request); + + virtual google::cloud::Idempotency SetIamPolicy( + google::cloud::cpp::compute::region_backend_buckets::v1:: + SetIamPolicyRequest const& request); + + virtual google::cloud::Idempotency TestIamPermissions( + google::cloud::cpp::compute::region_backend_buckets::v1:: + TestIamPermissionsRequest const& request); +}; + +std::unique_ptr +MakeDefaultRegionBackendBucketsConnectionIdempotencyPolicy(); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_backend_buckets_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_BACKEND_BUCKETS_V1_REGION_BACKEND_BUCKETS_CONNECTION_IDEMPOTENCY_POLICY_H diff --git a/google/cloud/compute/region_backend_buckets/v1/region_backend_buckets_options.h b/google/cloud/compute/region_backend_buckets/v1/region_backend_buckets_options.h new file mode 100644 index 0000000000000..a9e15b3f636f1 --- /dev/null +++ b/google/cloud/compute/region_backend_buckets/v1/region_backend_buckets_options.h @@ -0,0 +1,88 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_backend_buckets/v1/region_backend_buckets.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_BACKEND_BUCKETS_V1_REGION_BACKEND_BUCKETS_OPTIONS_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_BACKEND_BUCKETS_V1_REGION_BACKEND_BUCKETS_OPTIONS_H + +#include "google/cloud/compute/region_backend_buckets/v1/region_backend_buckets_connection.h" +#include "google/cloud/compute/region_backend_buckets/v1/region_backend_buckets_connection_idempotency_policy.h" +#include "google/cloud/backoff_policy.h" +#include "google/cloud/options.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_backend_buckets_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/** + * Use with `google::cloud::Options` to configure the retry policy. + * + * @ingroup google-cloud-compute-options + */ +struct RegionBackendBucketsRetryPolicyOption { + using Type = std::shared_ptr; +}; + +/** + * Use with `google::cloud::Options` to configure the backoff policy. + * + * @ingroup google-cloud-compute-options + */ +struct RegionBackendBucketsBackoffPolicyOption { + using Type = std::shared_ptr; +}; + +/** + * Use with `google::cloud::Options` to configure which operations are retried. + * + * @ingroup google-cloud-compute-options + */ +struct RegionBackendBucketsConnectionIdempotencyPolicyOption { + using Type = std::shared_ptr; +}; + +/** + * Use with `google::cloud::Options` to configure the long-running operations + * polling policy. + * + * @ingroup google-cloud-compute-options + */ +struct RegionBackendBucketsPollingPolicyOption { + using Type = std::shared_ptr; +}; + +/** + * The options applicable to RegionBackendBuckets. + * + * @ingroup google-cloud-compute-options + */ +using RegionBackendBucketsPolicyOptionList = + OptionList; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_backend_buckets_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_BACKEND_BUCKETS_V1_REGION_BACKEND_BUCKETS_OPTIONS_H diff --git a/google/cloud/compute/region_backend_buckets/v1/region_backend_buckets_proto_export.h b/google/cloud/compute/region_backend_buckets/v1/region_backend_buckets_proto_export.h new file mode 100644 index 0000000000000..3000555f512dc --- /dev/null +++ b/google/cloud/compute/region_backend_buckets/v1/region_backend_buckets_proto_export.h @@ -0,0 +1,37 @@ +// Copyright 2026 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_REGION_BACKEND_BUCKETS_V1_REGION_BACKEND_BUCKETS_PROTO_EXPORT_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_BACKEND_BUCKETS_V1_REGION_BACKEND_BUCKETS_PROTO_EXPORT_H + +// IWYU pragma: begin_exports +#include "google/cloud/compute/v1/internal/common_009.pb.h" +#include "google/cloud/compute/v1/internal/common_012.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_040.pb.h" +#include "google/cloud/compute/v1/internal/common_126.pb.h" +#include "google/cloud/compute/v1/internal/common_171.pb.h" +// IWYU pragma: end_exports + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_BACKEND_BUCKETS_V1_REGION_BACKEND_BUCKETS_PROTO_EXPORT_H diff --git a/google/cloud/compute/region_backend_buckets/v1/region_backend_buckets_rest_connection.cc b/google/cloud/compute/region_backend_buckets/v1/region_backend_buckets_rest_connection.cc new file mode 100644 index 0000000000000..91067063b737b --- /dev/null +++ b/google/cloud/compute/region_backend_buckets/v1/region_backend_buckets_rest_connection.cc @@ -0,0 +1,61 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_backend_buckets/v1/region_backend_buckets.proto + +#include "google/cloud/compute/region_backend_buckets/v1/region_backend_buckets_rest_connection.h" +#include "google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_option_defaults.h" +#include "google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_rest_connection_impl.h" +#include "google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_rest_stub_factory.h" +#include "google/cloud/compute/region_backend_buckets/v1/internal/region_backend_buckets_tracing_connection.h" +#include "google/cloud/compute/region_backend_buckets/v1/region_backend_buckets_options.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/internal/rest_background_threads_impl.h" +#include "google/cloud/internal/rest_options.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_backend_buckets_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +std::shared_ptr +MakeRegionBackendBucketsConnectionRest(Options options) { + internal::CheckExpectedOptions( + options, __func__); + options = compute_region_backend_buckets_v1_internal:: + RegionBackendBucketsDefaultOptions(std::move(options)); + auto background = std::make_unique< + rest_internal::AutomaticallyCreatedRestBackgroundThreads>(); + auto stub = compute_region_backend_buckets_v1_internal:: + CreateDefaultRegionBackendBucketsRestStub(options); + return compute_region_backend_buckets_v1_internal:: + MakeRegionBackendBucketsTracingConnection( + std::make_shared( + std::move(background), std::move(stub), std::move(options))); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_backend_buckets_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_backend_buckets/v1/region_backend_buckets_rest_connection.h b/google/cloud/compute/region_backend_buckets/v1/region_backend_buckets_rest_connection.h new file mode 100644 index 0000000000000..fea65d2402e67 --- /dev/null +++ b/google/cloud/compute/region_backend_buckets/v1/region_backend_buckets_rest_connection.h @@ -0,0 +1,67 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_backend_buckets/v1/region_backend_buckets.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_BACKEND_BUCKETS_V1_REGION_BACKEND_BUCKETS_REST_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_BACKEND_BUCKETS_V1_REGION_BACKEND_BUCKETS_REST_CONNECTION_H + +#include "google/cloud/compute/region_backend_buckets/v1/region_backend_buckets_connection.h" +#include "google/cloud/options.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_backend_buckets_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/** + * A factory function to construct an object of type + * `RegionBackendBucketsConnection` that uses REST over HTTP as transport in + * lieu of gRPC. REST transport should only be used for services that do not + * support gRPC or if the existing network configuration precludes using gRPC. + * + * The returned connection object should not be used directly; instead it + * should be passed as an argument to the constructor of + * RegionBackendBucketsClient. + * + * The optional @p options argument may be used to configure aspects of the + * returned `RegionBackendBucketsConnection`. Expected options are any of the + * types in the following option lists: + * + * - `google::cloud::CommonOptionList` + * - `google::cloud::RestOptionList` + * - `google::cloud::UnifiedCredentialsOptionList` + * - + * `google::cloud::compute_region_backend_buckets_v1::RegionBackendBucketsPolicyOptionList` + * + * @note Unexpected options will be ignored. To log unexpected options instead, + * set `GOOGLE_CLOUD_CPP_ENABLE_CLOG=yes` in the environment. + * + * @param options (optional) Configure the `RegionBackendBucketsConnection` + * created by this function. + */ +std::shared_ptr +MakeRegionBackendBucketsConnectionRest(Options options = {}); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_backend_buckets_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_BACKEND_BUCKETS_V1_REGION_BACKEND_BUCKETS_REST_CONNECTION_H diff --git a/google/cloud/compute/region_backend_buckets/v1/samples/region_backend_buckets_client_samples.cc b/google/cloud/compute/region_backend_buckets/v1/samples/region_backend_buckets_client_samples.cc new file mode 100644 index 0000000000000..f665c2a3f71d2 --- /dev/null +++ b/google/cloud/compute/region_backend_buckets/v1/samples/region_backend_buckets_client_samples.cc @@ -0,0 +1,244 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_backend_buckets/v1/region_backend_buckets.proto + +#include "google/cloud/compute/region_backend_buckets/v1/region_backend_buckets_client.h" +#include "google/cloud/compute/region_backend_buckets/v1/region_backend_buckets_connection_idempotency_policy.h" +#include "google/cloud/compute/region_backend_buckets/v1/region_backend_buckets_options.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/internal/getenv.h" +#include "google/cloud/polling_policy.h" +#include "google/cloud/testing_util/example_driver.h" +#include "google/cloud/universe_domain.h" +#include +#include +#include +#include + +// clang-format off +// main-dox-marker: compute_region_backend_buckets_v1::RegionBackendBucketsClient +// lro-marker: true +// clang-format on +namespace { + +void SetClientEndpoint(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-endpoint"}; + } + //! [set-client-endpoint] + // This configuration is common with Private Google Access: + // https://cloud.google.com/vpc/docs/private-google-access + auto options = google::cloud::Options{}.set( + "private.googleapis.com"); + auto vpc_client = google::cloud::compute_region_backend_buckets_v1:: + RegionBackendBucketsClient( + google::cloud::compute_region_backend_buckets_v1:: + MakeRegionBackendBucketsConnectionRest(options)); + //! [set-client-endpoint] +} + +void SetClientUniverseDomain(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-universe-domain"}; + } + //! [set-client-universe-domain] + google::cloud::Options options; + + // AddUniverseDomainOption interrogates the UnifiedCredentialsOption, if set, + // in the provided Options for the Universe Domain associated with the + // credentials and adds it to the set of Options. + // If no UnifiedCredentialsOption is set, GoogleDefaultCredentials are used. + auto ud_options = google::cloud::AddUniverseDomainOption(std::move(options)); + + if (!ud_options.ok()) throw std::move(ud_options).status(); + auto ud_client = google::cloud::compute_region_backend_buckets_v1:: + RegionBackendBucketsClient( + google::cloud::compute_region_backend_buckets_v1:: + MakeRegionBackendBucketsConnectionRest(*ud_options)); + //! [set-client-universe-domain] +} + +//! [custom-idempotency-policy] +class CustomIdempotencyPolicy + : public google::cloud::compute_region_backend_buckets_v1:: + RegionBackendBucketsConnectionIdempotencyPolicy { + public: + ~CustomIdempotencyPolicy() override = default; + std::unique_ptr + clone() const override { + return std::make_unique(*this); + } + // Override inherited functions to define as needed. +}; +//! [custom-idempotency-policy] + +void SetRetryPolicy(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-retry-policy"}; + } + //! [set-retry-policy] + auto options = + google::cloud::Options{} + .set( + CustomIdempotencyPolicy().clone()) + .set( + google::cloud::compute_region_backend_buckets_v1:: + RegionBackendBucketsLimitedErrorCountRetryPolicy(3) + .clone()) + .set( + google::cloud::ExponentialBackoffPolicy( + /*initial_delay=*/std::chrono::milliseconds(200), + /*maximum_delay=*/std::chrono::seconds(45), + /*scaling=*/2.0) + .clone()); + auto connection = google::cloud::compute_region_backend_buckets_v1:: + MakeRegionBackendBucketsConnectionRest(options); + + // c1 and c2 share the same retry policies + auto c1 = google::cloud::compute_region_backend_buckets_v1:: + RegionBackendBucketsClient(connection); + auto c2 = google::cloud::compute_region_backend_buckets_v1:: + RegionBackendBucketsClient(connection); + + // You can override any of the policies in a new client. This new client + // will share the policies from c1 (or c2) *except* for the retry policy. + auto c3 = google::cloud::compute_region_backend_buckets_v1:: + RegionBackendBucketsClient( + connection, + google::cloud::Options{} + .set( + google::cloud::compute_region_backend_buckets_v1:: + RegionBackendBucketsLimitedTimeRetryPolicy( + std::chrono::minutes(5)) + .clone())); + + // You can also override the policies in a single call: + // c3.SomeRpc(..., google::cloud::Options{} + // .set( + // google::cloud::compute_region_backend_buckets_v1::RegionBackendBucketsLimitedErrorCountRetryPolicy(10).clone())); + //! [set-retry-policy] +} + +void SetPollingPolicy(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-policy-policy"}; + } + //! [set-polling-policy] + + // The polling policy controls how the client waits for long-running + // operations. `GenericPollingPolicy<>` combines existing policies. + // In this case, keep polling until the operation completes (with success + // or error) or 45 minutes, whichever happens first. Initially pause for + // 10 seconds between polling requests, increasing the pause by a factor + // of 4 until it becomes 2 minutes. + auto options = + google::cloud::Options{} + .set( + google::cloud::GenericPollingPolicy< + google::cloud::compute_region_backend_buckets_v1:: + RegionBackendBucketsRetryPolicyOption::Type, + google::cloud::compute_region_backend_buckets_v1:: + RegionBackendBucketsBackoffPolicyOption::Type>( + google::cloud::compute_region_backend_buckets_v1:: + RegionBackendBucketsLimitedTimeRetryPolicy( + /*maximum_duration=*/std::chrono::minutes(45)) + .clone(), + google::cloud::ExponentialBackoffPolicy( + /*initial_delay=*/std::chrono::seconds(10), + /*maximum_delay=*/std::chrono::minutes(2), + /*scaling=*/4.0) + .clone()) + .clone()); + + auto connection = google::cloud::compute_region_backend_buckets_v1:: + MakeRegionBackendBucketsConnectionRest(options); + + // c1 and c2 share the same polling policies. + auto c1 = google::cloud::compute_region_backend_buckets_v1:: + RegionBackendBucketsClient(connection); + auto c2 = google::cloud::compute_region_backend_buckets_v1:: + RegionBackendBucketsClient(connection); + //! [set-polling-policy] +} + +void WithServiceAccount(std::vector const& argv) { + if (argv.size() != 1 || argv[0] == "--help") { + throw google::cloud::testing_util::Usage{"with-service-account "}; + } + //! [with-service-account] + [](std::string const& keyfile) { + auto is = std::ifstream(keyfile); + is.exceptions(std::ios::badbit); // Minimal error handling in examples + auto contents = std::string(std::istreambuf_iterator(is.rdbuf()), {}); + auto options = + google::cloud::Options{}.set( + google::cloud::MakeServiceAccountCredentials(contents)); + return google::cloud::compute_region_backend_buckets_v1:: + RegionBackendBucketsClient( + google::cloud::compute_region_backend_buckets_v1:: + MakeRegionBackendBucketsConnectionRest(options)); + } + //! [with-service-account] + (argv.at(0)); +} + +void AutoRun(std::vector const& argv) { + namespace examples = ::google::cloud::testing_util; + using ::google::cloud::internal::GetEnv; + if (!argv.empty()) throw examples::Usage{"auto"}; + examples::CheckEnvironmentVariablesAreSet( + {"GOOGLE_CLOUD_CPP_TEST_SERVICE_ACCOUNT_KEYFILE"}); + auto const keyfile = + GetEnv("GOOGLE_CLOUD_CPP_TEST_SERVICE_ACCOUNT_KEYFILE").value(); + + std::cout << "\nRunning SetClientEndpoint() example" << std::endl; + SetClientEndpoint({}); + + std::cout << "\nRunning SetRetryPolicy() example" << std::endl; + SetRetryPolicy({}); + + std::cout << "\nRunning SetPollingPolicy() example" << std::endl; + SetPollingPolicy({}); + + std::cout << "\nRunning WithServiceAccount() example" << std::endl; + WithServiceAccount({keyfile}); + + std::cout << "\nRunning SetClientUniverseDomain() example" << std::endl; + SetClientUniverseDomain({}); +} + +} // namespace + +int main(int argc, char* argv[]) { // NOLINT(bugprone-exception-escape) + google::cloud::testing_util::Example example({ + {"set-client-endpoint", SetClientEndpoint}, + {"set-retry-policy", SetRetryPolicy}, + {"set-polling-policy", SetPollingPolicy}, + {"with-service-account", WithServiceAccount}, + {"set-client-universe-domain", SetClientUniverseDomain}, + {"auto", AutoRun}, + }); + return example.Run(argc, argv); +} 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 e138cb1655972..065777f2f0499 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 @@ -120,7 +120,7 @@ class RegionBackendServicesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_backend_services.v1.DeleteBackendServiceRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_backend_services/v1/region_backend_services.proto#L197} + /// [google.cloud.cpp.compute.region_backend_services.v1.DeleteBackendServiceRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_backend_services/v1/region_backend_services.proto#L203} /// // clang-format on future> @@ -173,7 +173,7 @@ class RegionBackendServicesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_backend_services.v1.DeleteBackendServiceRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_backend_services/v1/region_backend_services.proto#L197} + /// [google.cloud.cpp.compute.region_backend_services.v1.DeleteBackendServiceRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_backend_services/v1/region_backend_services.proto#L203} /// // clang-format on future> @@ -233,8 +233,8 @@ class RegionBackendServicesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_backend_services.v1.GetBackendServiceRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_backend_services/v1/region_backend_services.proto#L230} - /// [google.cloud.cpp.compute.v1.BackendService]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_000.proto#L187} + /// [google.cloud.cpp.compute.region_backend_services.v1.GetBackendServiceRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_backend_services/v1/region_backend_services.proto#L239} + /// [google.cloud.cpp.compute.v1.BackendService]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_000.proto#L282} /// // clang-format on StatusOr GetBackendService( @@ -265,8 +265,8 @@ class RegionBackendServicesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_backend_services.v1.GetBackendServiceRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_backend_services/v1/region_backend_services.proto#L230} - /// [google.cloud.cpp.compute.v1.BackendService]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_000.proto#L187} + /// [google.cloud.cpp.compute.region_backend_services.v1.GetBackendServiceRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_backend_services/v1/region_backend_services.proto#L239} + /// [google.cloud.cpp.compute.v1.BackendService]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_000.proto#L282} /// // clang-format on StatusOr GetBackendService( @@ -276,7 +276,8 @@ class RegionBackendServicesClient { // clang-format off /// - /// Gets the most recent health check results for this regional BackendService. + /// Gets the most recent health check results for this + /// regional BackendService. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionBackendServices/getHealth /// /// @param project @@ -296,8 +297,8 @@ class RegionBackendServicesClient { /// [`future`]: @ref google::cloud::future /// [`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#L930} + /// [google.cloud.cpp.compute.region_backend_services.v1.GetHealthRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_backend_services/v1/region_backend_services.proto#L254} + /// [google.cloud.cpp.compute.v1.BackendServiceGroupHealth]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_000.proto#L1272} /// // clang-format on StatusOr @@ -309,7 +310,8 @@ class RegionBackendServicesClient { // clang-format off /// - /// Gets the most recent health check results for this regional BackendService. + /// Gets the most recent health check results for this + /// regional BackendService. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionBackendServices/getHealth /// /// @param request Unary RPCs, such as the one wrapped by this @@ -331,8 +333,8 @@ class RegionBackendServicesClient { /// [`future`]: @ref google::cloud::future /// [`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#L930} + /// [google.cloud.cpp.compute.region_backend_services.v1.GetHealthRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_backend_services/v1/region_backend_services.proto#L254} + /// [google.cloud.cpp.compute.v1.BackendServiceGroupHealth]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_000.proto#L1272} /// // clang-format on StatusOr @@ -362,8 +364,8 @@ class RegionBackendServicesClient { /// [`future`]: @ref google::cloud::future /// [`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_007.proto#L178} + /// [google.cloud.cpp.compute.region_backend_services.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_backend_services/v1/region_backend_services.proto#L272} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr GetIamPolicy( @@ -395,8 +397,8 @@ class RegionBackendServicesClient { /// [`future`]: @ref google::cloud::future /// [`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_007.proto#L178} + /// [google.cloud.cpp.compute.region_backend_services.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_backend_services/v1/region_backend_services.proto#L272} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr GetIamPolicy( @@ -407,8 +409,8 @@ class RegionBackendServicesClient { // clang-format off /// /// Creates a regional BackendService resource in the specified project using - /// the data included in the request. For more information, see Backend - /// services overview. + /// the data included in the request. For more information, see + /// Backend services overview. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionBackendServices/insert /// /// @param project Project ID for this request. @@ -434,7 +436,7 @@ class RegionBackendServicesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_backend_services.v1.InsertBackendServiceRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_backend_services/v1/region_backend_services.proto#L282} + /// [google.cloud.cpp.compute.region_backend_services.v1.InsertBackendServiceRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_backend_services/v1/region_backend_services.proto#L291} /// // clang-format on future> @@ -463,8 +465,8 @@ class RegionBackendServicesClient { // clang-format off /// /// Creates a regional BackendService resource in the specified project using - /// the data included in the request. For more information, see Backend - /// services overview. + /// the data included in the request. For more information, see + /// Backend services overview. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionBackendServices/insert /// /// @param request Unary RPCs, such as the one wrapped by this @@ -493,7 +495,7 @@ class RegionBackendServicesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_backend_services.v1.InsertBackendServiceRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_backend_services/v1/region_backend_services.proto#L282} + /// [google.cloud.cpp.compute.region_backend_services.v1.InsertBackendServiceRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_backend_services/v1/region_backend_services.proto#L291} /// // clang-format on future> @@ -562,8 +564,8 @@ class RegionBackendServicesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_backend_services.v1.ListRegionBackendServicesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_backend_services/v1/region_backend_services.proto#L315} - /// [google.cloud.cpp.compute.v1.BackendService]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_000.proto#L187} + /// [google.cloud.cpp.compute.region_backend_services.v1.ListRegionBackendServicesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_backend_services/v1/region_backend_services.proto#L327} + /// [google.cloud.cpp.compute.v1.BackendService]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_000.proto#L282} /// // clang-format on StreamRange @@ -604,8 +606,8 @@ class RegionBackendServicesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_backend_services.v1.ListRegionBackendServicesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_backend_services/v1/region_backend_services.proto#L315} - /// [google.cloud.cpp.compute.v1.BackendService]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_000.proto#L187} + /// [google.cloud.cpp.compute.region_backend_services.v1.ListRegionBackendServicesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_backend_services/v1/region_backend_services.proto#L327} + /// [google.cloud.cpp.compute.v1.BackendService]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_000.proto#L282} /// // clang-format on StreamRange @@ -616,13 +618,15 @@ class RegionBackendServicesClient { // clang-format off /// - /// Retrieves a list of all usable backend services in the specified project in - /// the given region. + /// Retrieves a list of all usable backend services for Application Load + /// Balancers and Proxy Network Load Balancers in the specified project in the + /// given region. Backend services for external and internal passthrough + /// Network Load Balancers are not included in the response. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionBackendServices/listUsable /// /// @param project Project ID for this request. - /// @param region Name of the region scoping this request. It must be a string that meets the - /// requirements in RFC1035. + /// @param region Name of the region scoping this request. + /// It must be a string that meets the requirements in RFC1035. /// @param opts Optional. Override the class-level options, such as retry and /// backoff policies. /// @return a [StreamRange](@ref google::cloud::StreamRange) @@ -645,8 +649,8 @@ class RegionBackendServicesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_backend_services.v1.ListUsableRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_backend_services/v1/region_backend_services.proto#L387} - /// [google.cloud.cpp.compute.v1.BackendService]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_000.proto#L187} + /// [google.cloud.cpp.compute.region_backend_services.v1.ListUsableRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_backend_services/v1/region_backend_services.proto#L432} + /// [google.cloud.cpp.compute.v1.BackendService]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_000.proto#L282} /// // clang-format on StreamRange ListUsable( @@ -654,8 +658,10 @@ class RegionBackendServicesClient { // clang-format off /// - /// Retrieves a list of all usable backend services in the specified project in - /// the given region. + /// Retrieves a list of all usable backend services for Application Load + /// Balancers and Proxy Network Load Balancers in the specified project in the + /// given region. Backend services for external and internal passthrough + /// Network Load Balancers are not included in the response. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionBackendServices/listUsable /// /// @param request Unary RPCs, such as the one wrapped by this @@ -686,8 +692,8 @@ class RegionBackendServicesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_backend_services.v1.ListUsableRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_backend_services/v1/region_backend_services.proto#L387} - /// [google.cloud.cpp.compute.v1.BackendService]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_000.proto#L187} + /// [google.cloud.cpp.compute.region_backend_services.v1.ListUsableRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_backend_services/v1/region_backend_services.proto#L432} + /// [google.cloud.cpp.compute.v1.BackendService]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_000.proto#L282} /// // clang-format on StreamRange ListUsable( @@ -698,9 +704,10 @@ class RegionBackendServicesClient { // clang-format off /// /// 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. + /// 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. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionBackendServices/patch /// /// @param project Project ID for this request. @@ -727,7 +734,7 @@ class RegionBackendServicesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_backend_services.v1.PatchBackendServiceRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_backend_services/v1/region_backend_services.proto#L460} + /// [google.cloud.cpp.compute.region_backend_services.v1.PatchBackendServiceRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_backend_services/v1/region_backend_services.proto#L538} /// // clang-format on future> @@ -758,9 +765,10 @@ class RegionBackendServicesClient { // clang-format off /// /// 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. + /// 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. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionBackendServices/patch /// /// @param request Unary RPCs, such as the one wrapped by this @@ -789,7 +797,7 @@ class RegionBackendServicesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_backend_services.v1.PatchBackendServiceRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_backend_services/v1/region_backend_services.proto#L460} + /// [google.cloud.cpp.compute.region_backend_services.v1.PatchBackendServiceRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_backend_services/v1/region_backend_services.proto#L538} /// // clang-format on future> @@ -830,8 +838,8 @@ class RegionBackendServicesClient { // clang-format off /// - /// Sets the access control policy on the specified resource. Replaces any - /// existing policy. + /// Sets the access control policy on the specified resource. + /// Replaces any existing policy. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionBackendServices/setIamPolicy /// /// @param project Project ID for this request. @@ -851,8 +859,8 @@ class RegionBackendServicesClient { /// [`future`]: @ref google::cloud::future /// [`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_007.proto#L178} + /// [google.cloud.cpp.compute.region_backend_services.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_backend_services/v1/region_backend_services.proto#L578} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr SetIamPolicy( @@ -864,8 +872,8 @@ class RegionBackendServicesClient { // clang-format off /// - /// Sets the access control policy on the specified resource. Replaces any - /// existing policy. + /// Sets the access control policy on the specified resource. + /// Replaces any existing policy. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionBackendServices/setIamPolicy /// /// @param request Unary RPCs, such as the one wrapped by this @@ -887,8 +895,8 @@ class RegionBackendServicesClient { /// [`future`]: @ref google::cloud::future /// [`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_007.proto#L178} + /// [google.cloud.cpp.compute.region_backend_services.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_backend_services/v1/region_backend_services.proto#L578} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr SetIamPolicy( @@ -899,7 +907,8 @@ class RegionBackendServicesClient { // clang-format off /// /// Sets the Google Cloud Armor security policy for the specified backend - /// service. For more information, see Google Cloud Armor Overview + /// service. For more information, seeGoogle + /// Cloud Armor Overview /// https://cloud.google.com/compute/docs/reference/rest/v1/regionBackendServices/setSecurityPolicy /// /// @param project Project ID for this request. @@ -927,7 +936,7 @@ class RegionBackendServicesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_backend_services.v1.SetSecurityPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_backend_services/v1/region_backend_services.proto#L517} + /// [google.cloud.cpp.compute.region_backend_services.v1.SetSecurityPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_backend_services/v1/region_backend_services.proto#L598} /// // clang-format on future> @@ -959,7 +968,8 @@ class RegionBackendServicesClient { // clang-format off /// /// Sets the Google Cloud Armor security policy for the specified backend - /// service. For more information, see Google Cloud Armor Overview + /// service. For more information, seeGoogle + /// Cloud Armor Overview /// https://cloud.google.com/compute/docs/reference/rest/v1/regionBackendServices/setSecurityPolicy /// /// @param request Unary RPCs, such as the one wrapped by this @@ -988,7 +998,7 @@ class RegionBackendServicesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_backend_services.v1.SetSecurityPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_backend_services/v1/region_backend_services.proto#L517} + /// [google.cloud.cpp.compute.region_backend_services.v1.SetSecurityPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_backend_services/v1/region_backend_services.proto#L598} /// // clang-format on future> @@ -1048,8 +1058,8 @@ class RegionBackendServicesClient { /// [`future`]: @ref google::cloud::future /// [`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_145.proto#L30} + /// [google.cloud.cpp.compute.region_backend_services.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_backend_services/v1/region_backend_services.proto#L640} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} /// // clang-format on StatusOr @@ -1084,8 +1094,8 @@ class RegionBackendServicesClient { /// [`future`]: @ref google::cloud::future /// [`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_145.proto#L30} + /// [google.cloud.cpp.compute.region_backend_services.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_backend_services/v1/region_backend_services.proto#L640} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} /// // clang-format on StatusOr @@ -1096,8 +1106,9 @@ class RegionBackendServicesClient { // clang-format off /// /// Updates the specified regional BackendService resource with the data - /// included in the request. For more information, see Backend services - /// overview . + /// included in the request. For more information, + /// see + /// Backend services overview. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionBackendServices/update /// /// @param project Project ID for this request. @@ -1124,7 +1135,7 @@ class RegionBackendServicesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_backend_services.v1.UpdateBackendServiceRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_backend_services/v1/region_backend_services.proto#L575} + /// [google.cloud.cpp.compute.region_backend_services.v1.UpdateBackendServiceRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_backend_services/v1/region_backend_services.proto#L659} /// // clang-format on future> @@ -1155,8 +1166,9 @@ class RegionBackendServicesClient { // clang-format off /// /// Updates the specified regional BackendService resource with the data - /// included in the request. For more information, see Backend services - /// overview . + /// included in the request. For more information, + /// see + /// Backend services overview. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionBackendServices/update /// /// @param request Unary RPCs, such as the one wrapped by this @@ -1185,7 +1197,7 @@ class RegionBackendServicesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_backend_services.v1.UpdateBackendServiceRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_backend_services/v1/region_backend_services.proto#L575} + /// [google.cloud.cpp.compute.region_backend_services.v1.UpdateBackendServiceRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_backend_services/v1/region_backend_services.proto#L659} /// // clang-format on future> 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 d049495648f3a..cef3a7ccbaa74 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 "google/cloud/compute/v1/internal/common_000.pb.h" -#include "google/cloud/compute/v1/internal/common_007.pb.h" -#include "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_029.pb.h" -#include "google/cloud/compute/v1/internal/common_031.pb.h" -#include "google/cloud/compute/v1/internal/common_052.pb.h" -#include "google/cloud/compute/v1/internal/common_108.pb.h" -#include "google/cloud/compute/v1/internal/common_118.pb.h" -#include "google/cloud/compute/v1/internal/common_145.pb.h" +#include "google/cloud/compute/v1/internal/common_009.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_038.pb.h" +#include "google/cloud/compute/v1/internal/common_040.pb.h" +#include "google/cloud/compute/v1/internal/common_065.pb.h" +#include "google/cloud/compute/v1/internal/common_126.pb.h" +#include "google/cloud/compute/v1/internal/common_142.pb.h" +#include "google/cloud/compute/v1/internal/common_171.pb.h" // 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 c5406f6f2f20b..a6986073d5e92 100644 --- a/google/cloud/compute/region_commitments/v1/region_commitments_client.h +++ b/google/cloud/compute/region_commitments/v1/region_commitments_client.h @@ -91,9 +91,10 @@ class RegionCommitmentsClient { // clang-format off /// - /// Retrieves an aggregated list of commitments by region. To prevent failure, - /// Google recommends that you set the `returnPartialSuccess` parameter to - /// `true`. + /// Retrieves an aggregated list of commitments by region. + /// + /// To prevent failure, it is recommended that you set the + /// `returnPartialSuccess` parameter to `true`. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionCommitments/aggregatedList /// /// @param project Project ID for this request. @@ -119,8 +120,8 @@ class RegionCommitmentsClient { /// [`future`]: @ref google::cloud::future /// [`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#L433} + /// [google.cloud.cpp.compute.region_commitments.v1.AggregatedListRegionCommitmentsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_commitments/v1/region_commitments.proto#L104} + /// [google.cloud.cpp.compute.v1.CommitmentsScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_025.proto#L537} /// // clang-format on StreamRange GetCommitment( @@ -227,8 +229,8 @@ class RegionCommitmentsClient { /// [`future`]: @ref google::cloud::future /// [`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.region_commitments.v1.GetCommitmentRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_commitments/v1/region_commitments.proto#L219} + /// [google.cloud.cpp.compute.v1.Commitment]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_025.proto#L33} /// // clang-format on StatusOr GetCommitment( @@ -238,8 +240,8 @@ class RegionCommitmentsClient { // clang-format off /// - /// Creates a commitment in the specified project using the data included in - /// the request. + /// Creates a commitment in the specified project using the data + /// included in the request. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionCommitments/insert /// /// @param project Project ID for this request. @@ -265,7 +267,7 @@ class RegionCommitmentsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_commitments.v1.InsertCommitmentRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_commitments/v1/region_commitments.proto#L199} + /// [google.cloud.cpp.compute.region_commitments.v1.InsertCommitmentRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_commitments/v1/region_commitments.proto#L234} /// // clang-format on future> InsertCommitment( @@ -291,8 +293,8 @@ class RegionCommitmentsClient { // clang-format off /// - /// Creates a commitment in the specified project using the data included in - /// the request. + /// Creates a commitment in the specified project using the data + /// included in the request. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionCommitments/insert /// /// @param request Unary RPCs, such as the one wrapped by this @@ -321,7 +323,7 @@ class RegionCommitmentsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_commitments.v1.InsertCommitmentRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_commitments/v1/region_commitments.proto#L199} + /// [google.cloud.cpp.compute.region_commitments.v1.InsertCommitmentRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_commitments/v1/region_commitments.proto#L234} /// // clang-format on future> InsertCommitment( @@ -361,7 +363,8 @@ class RegionCommitmentsClient { // clang-format off /// - /// Retrieves a list of commitments contained within the specified region. + /// Retrieves a list of commitments contained within + /// the specified region. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionCommitments/list /// /// @param project Project ID for this request. @@ -388,8 +391,8 @@ class RegionCommitmentsClient { /// [`future`]: @ref google::cloud::future /// [`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.region_commitments.v1.ListRegionCommitmentsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_commitments/v1/region_commitments.proto#L270} + /// [google.cloud.cpp.compute.v1.Commitment]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_025.proto#L33} /// // clang-format on StreamRange @@ -398,7 +401,8 @@ class RegionCommitmentsClient { // clang-format off /// - /// Retrieves a list of commitments contained within the specified region. + /// Retrieves a list of commitments contained within + /// the specified region. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionCommitments/list /// /// @param request Unary RPCs, such as the one wrapped by this @@ -429,8 +433,8 @@ class RegionCommitmentsClient { /// [`future`]: @ref google::cloud::future /// [`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.region_commitments.v1.ListRegionCommitmentsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_commitments/v1/region_commitments.proto#L270} + /// [google.cloud.cpp.compute.v1.Commitment]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_025.proto#L33} /// // clang-format on StreamRange @@ -470,7 +474,7 @@ class RegionCommitmentsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_commitments.v1.UpdateCommitmentRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_commitments/v1/region_commitments.proto#L304} + /// [google.cloud.cpp.compute.region_commitments.v1.UpdateCommitmentRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_commitments/v1/region_commitments.proto#L375} /// // clang-format on future> UpdateCommitment( @@ -529,7 +533,7 @@ class RegionCommitmentsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_commitments.v1.UpdateCommitmentRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_commitments/v1/region_commitments.proto#L304} + /// [google.cloud.cpp.compute.region_commitments.v1.UpdateCommitmentRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_commitments/v1/region_commitments.proto#L375} /// // clang-format on future> UpdateCommitment( 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 6f39ec34042f9..4ea5e822424b1 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 @@ -27,13 +27,15 @@ // IWYU pragma: begin_exports #include "google/cloud/compute/v1/internal/common_001.pb.h" -#include "google/cloud/compute/v1/internal/common_006.pb.h" -#include "google/cloud/compute/v1/internal/common_016.pb.h" +#include "google/cloud/compute/v1/internal/common_007.pb.h" +#include "google/cloud/compute/v1/internal/common_008.pb.h" #include "google/cloud/compute/v1/internal/common_019.pb.h" -#include "google/cloud/compute/v1/internal/common_029.pb.h" -#include "google/cloud/compute/v1/internal/common_048.pb.h" -#include "google/cloud/compute/v1/internal/common_120.pb.h" -#include "google/cloud/compute/v1/internal/common_146.pb.h" +#include "google/cloud/compute/v1/internal/common_025.pb.h" +#include "google/cloud/compute/v1/internal/common_038.pb.h" +#include "google/cloud/compute/v1/internal/common_059.pb.h" +#include "google/cloud/compute/v1/internal/common_134.pb.h" +#include "google/cloud/compute/v1/internal/common_144.pb.h" +#include "google/cloud/compute/v1/internal/common_173.pb.h" // 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_composite_health_checks/v1/internal/region_composite_health_checks_option_defaults.cc b/google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_option_defaults.cc new file mode 100644 index 0000000000000..d1eeae1005da5 --- /dev/null +++ b/google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_option_defaults.cc @@ -0,0 +1,96 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks.proto + +#include "google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_option_defaults.h" +#include "google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks_connection.h" +#include "google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks_options.h" +#include "google/cloud/internal/populate_common_options.h" +#include "google/cloud/internal/populate_grpc_options.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_composite_health_checks_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +namespace { +auto constexpr kBackoffScaling = 2.0; +} // namespace + +Options RegionCompositeHealthChecksDefaultOptions(Options options) { + options = internal::PopulateCommonOptions( + std::move(options), + "GOOGLE_CLOUD_CPP_REGION_COMPOSITE_HEALTH_CHECKS_ENDPOINT", "", + "GOOGLE_CLOUD_CPP_REGION_COMPOSITE_HEALTH_CHECKS_AUTHORITY", + "compute.googleapis.com"); + options = internal::PopulateGrpcOptions(std::move(options)); + if (!options.has()) { + options.set( + compute_region_composite_health_checks_v1:: + RegionCompositeHealthChecksLimitedTimeRetryPolicy( + std::chrono::minutes(10)) + .clone()); + } + if (!options.has()) { + options.set( + ExponentialBackoffPolicy( + std::chrono::seconds(0), std::chrono::seconds(1), + std::chrono::minutes(5), kBackoffScaling, kBackoffScaling) + .clone()); + } + if (!options.has()) { + options.set( + GenericPollingPolicy< + compute_region_composite_health_checks_v1:: + RegionCompositeHealthChecksRetryPolicyOption::Type, + compute_region_composite_health_checks_v1:: + RegionCompositeHealthChecksBackoffPolicyOption::Type>( + options + .get() + ->clone(), + ExponentialBackoffPolicy(std::chrono::seconds(1), + std::chrono::minutes(5), kBackoffScaling) + .clone()) + .clone()); + } + if (!options.has< + compute_region_composite_health_checks_v1:: + RegionCompositeHealthChecksConnectionIdempotencyPolicyOption>()) { + options.set< + compute_region_composite_health_checks_v1:: + RegionCompositeHealthChecksConnectionIdempotencyPolicyOption>( + compute_region_composite_health_checks_v1:: + MakeDefaultRegionCompositeHealthChecksConnectionIdempotencyPolicy()); + } + + return options; +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_composite_health_checks_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_option_defaults.h b/google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_option_defaults.h new file mode 100644 index 0000000000000..675ef37d00c75 --- /dev/null +++ b/google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_option_defaults.h @@ -0,0 +1,38 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_COMPOSITE_HEALTH_CHECKS_V1_INTERNAL_REGION_COMPOSITE_HEALTH_CHECKS_OPTION_DEFAULTS_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_COMPOSITE_HEALTH_CHECKS_V1_INTERNAL_REGION_COMPOSITE_HEALTH_CHECKS_OPTION_DEFAULTS_H + +#include "google/cloud/options.h" +#include "google/cloud/version.h" + +namespace google { +namespace cloud { +namespace compute_region_composite_health_checks_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +Options RegionCompositeHealthChecksDefaultOptions(Options options); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_composite_health_checks_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_COMPOSITE_HEALTH_CHECKS_V1_INTERNAL_REGION_COMPOSITE_HEALTH_CHECKS_OPTION_DEFAULTS_H diff --git a/google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_rest_connection_impl.cc b/google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_rest_connection_impl.cc new file mode 100644 index 0000000000000..fcd8f71d42601 --- /dev/null +++ b/google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_rest_connection_impl.cc @@ -0,0 +1,590 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks.proto + +#include "google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_rest_connection_impl.h" +#include "google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_rest_stub_factory.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/internal/async_rest_long_running_operation_custom.h" +#include "google/cloud/internal/extract_long_running_result.h" +#include "google/cloud/internal/pagination_range.h" +#include "google/cloud/internal/rest_lro_helpers.h" +#include "google/cloud/internal/rest_retry_loop.h" +#include "google/cloud/rest_options.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_composite_health_checks_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +RegionCompositeHealthChecksRestConnectionImpl:: + RegionCompositeHealthChecksRestConnectionImpl( + std::unique_ptr background, + std::shared_ptr + stub, + Options options) + : background_(std::move(background)), + stub_(std::move(stub)), + options_(internal::MergeOptions( + std::move(options), + RegionCompositeHealthChecksConnection::options())) {} + +StreamRange< + std::pair> +RegionCompositeHealthChecksRestConnectionImpl:: + AggregatedListRegionCompositeHealthChecks( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + AggregatedListRegionCompositeHealthChecksRequest request) { + request.clear_page_token(); + auto current = google::cloud::internal::SaveCurrentOptions(); + auto idempotency = + idempotency_policy(*current)->AggregatedListRegionCompositeHealthChecks( + request); + char const* function_name = __func__; + return google::cloud::internal::MakePaginationRange>>( + current, std::move(request), + [idempotency, function_name, stub = stub_, + retry = std::shared_ptr( + retry_policy(*current)), + backoff = std::shared_ptr(backoff_policy(*current))]( + Options const& options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + AggregatedListRegionCompositeHealthChecksRequest const& r) { + return google::cloud::rest_internal::RestRetryLoop( + retry->clone(), backoff->clone(), idempotency, + [stub]( + rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_composite_health_checks:: + v1::AggregatedListRegionCompositeHealthChecksRequest const& + request) { + return stub->AggregatedListRegionCompositeHealthChecks( + rest_context, options, request); + }, + options, r, function_name); + }, + [](google::cloud::cpp::compute::v1::CompositeHealthCheckAggregatedList + r) { + std::vector> + result(r.items().size()); + auto& messages = *r.mutable_items(); + std::move(messages.begin(), messages.end(), result.begin()); + return result; + }); +} + +future> +RegionCompositeHealthChecksRestConnectionImpl::DeleteCompositeHealthCheck( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + DeleteCompositeHealthCheckRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::region_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, request, + [stub = stub_]( + CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + DeleteCompositeHealthCheckRequest const& request) { + return stub->AsyncDeleteCompositeHealthCheck( + cq, std::move(context), std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->DeleteCompositeHealthCheck(request), + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [request](std::string const& op, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest& r) { + r.set_project(request.project()); + r.set_region(request.region()); + r.set_operation(op); + }, + [request](std::string const& op, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest& r) { + r.set_project(request.project()); + r.set_region(request.region()); + r.set_operation(op); + }); +} + +StatusOr +RegionCompositeHealthChecksRestConnectionImpl::DeleteCompositeHealthCheck( + NoAwaitTag, google::cloud::cpp::compute::region_composite_health_checks:: + v1::DeleteCompositeHealthCheckRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->DeleteCompositeHealthCheck(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + DeleteCompositeHealthCheckRequest const& request) { + return stub_->DeleteCompositeHealthCheck(rest_context, options, + request); + }, + *current, request, __func__); +} + +future> +RegionCompositeHealthChecksRestConnectionImpl::DeleteCompositeHealthCheck( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestAwaitLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::region_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, operation, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [operation](std::string const&, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_region(info.region); + r.set_operation(info.operation); + }, + [operation](std::string const&, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_region(info.region); + r.set_operation(info.operation); + }); +} + +StatusOr +RegionCompositeHealthChecksRestConnectionImpl::GetCompositeHealthCheck( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + GetCompositeHealthCheckRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->GetCompositeHealthCheck(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + GetCompositeHealthCheckRequest const& request) { + return stub_->GetCompositeHealthCheck(rest_context, options, request); + }, + *current, request, __func__); +} + +StatusOr +RegionCompositeHealthChecksRestConnectionImpl::GetHealth( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + GetHealthRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->GetHealth(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + GetHealthRequest const& request) { + return stub_->GetHealth(rest_context, options, request); + }, + *current, request, __func__); +} + +future> +RegionCompositeHealthChecksRestConnectionImpl::InsertCompositeHealthCheck( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + InsertCompositeHealthCheckRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::region_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, request, + [stub = stub_]( + CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + InsertCompositeHealthCheckRequest const& request) { + return stub->AsyncInsertCompositeHealthCheck( + cq, std::move(context), std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->InsertCompositeHealthCheck(request), + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [request](std::string const& op, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest& r) { + r.set_project(request.project()); + r.set_region(request.region()); + r.set_operation(op); + }, + [request](std::string const& op, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest& r) { + r.set_project(request.project()); + r.set_region(request.region()); + r.set_operation(op); + }); +} + +StatusOr +RegionCompositeHealthChecksRestConnectionImpl::InsertCompositeHealthCheck( + NoAwaitTag, google::cloud::cpp::compute::region_composite_health_checks:: + v1::InsertCompositeHealthCheckRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->InsertCompositeHealthCheck(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + InsertCompositeHealthCheckRequest const& request) { + return stub_->InsertCompositeHealthCheck(rest_context, options, + request); + }, + *current, request, __func__); +} + +future> +RegionCompositeHealthChecksRestConnectionImpl::InsertCompositeHealthCheck( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestAwaitLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::region_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, operation, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [operation](std::string const&, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_region(info.region); + r.set_operation(info.operation); + }, + [operation](std::string const&, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_region(info.region); + r.set_operation(info.operation); + }); +} + +StreamRange +RegionCompositeHealthChecksRestConnectionImpl::ListRegionCompositeHealthChecks( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + ListRegionCompositeHealthChecksRequest request) { + request.clear_page_token(); + auto current = google::cloud::internal::SaveCurrentOptions(); + auto idempotency = + idempotency_policy(*current)->ListRegionCompositeHealthChecks(request); + char const* function_name = __func__; + return google::cloud::internal::MakePaginationRange< + StreamRange>( + current, std::move(request), + [idempotency, function_name, stub = stub_, + retry = std::shared_ptr( + retry_policy(*current)), + backoff = std::shared_ptr(backoff_policy(*current))]( + Options const& options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + ListRegionCompositeHealthChecksRequest const& r) { + return google::cloud::rest_internal::RestRetryLoop( + retry->clone(), backoff->clone(), idempotency, + [stub]( + rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_composite_health_checks:: + v1::ListRegionCompositeHealthChecksRequest const& request) { + return stub->ListRegionCompositeHealthChecks(rest_context, + options, request); + }, + options, r, function_name); + }, + [](google::cloud::cpp::compute::v1::CompositeHealthCheckList r) { + std::vector + result(r.items().size()); + auto& messages = *r.mutable_items(); + std::move(messages.begin(), messages.end(), result.begin()); + return result; + }); +} + +future> +RegionCompositeHealthChecksRestConnectionImpl::PatchCompositeHealthCheck( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + PatchCompositeHealthCheckRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::region_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, request, + [stub = stub_]( + CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + PatchCompositeHealthCheckRequest const& request) { + return stub->AsyncPatchCompositeHealthCheck( + cq, std::move(context), std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->PatchCompositeHealthCheck(request), + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [request](std::string const& op, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest& r) { + r.set_project(request.project()); + r.set_region(request.region()); + r.set_operation(op); + }, + [request](std::string const& op, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest& r) { + r.set_project(request.project()); + r.set_region(request.region()); + r.set_operation(op); + }); +} + +StatusOr +RegionCompositeHealthChecksRestConnectionImpl::PatchCompositeHealthCheck( + NoAwaitTag, google::cloud::cpp::compute::region_composite_health_checks:: + v1::PatchCompositeHealthCheckRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->PatchCompositeHealthCheck(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + PatchCompositeHealthCheckRequest const& request) { + return stub_->PatchCompositeHealthCheck(rest_context, options, request); + }, + *current, request, __func__); +} + +future> +RegionCompositeHealthChecksRestConnectionImpl::PatchCompositeHealthCheck( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestAwaitLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::region_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, operation, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [operation](std::string const&, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_region(info.region); + r.set_operation(info.operation); + }, + [operation](std::string const&, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_region(info.region); + r.set_operation(info.operation); + }); +} + +StatusOr +RegionCompositeHealthChecksRestConnectionImpl::TestIamPermissions( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + TestIamPermissionsRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->TestIamPermissions(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + TestIamPermissionsRequest const& request) { + return stub_->TestIamPermissions(rest_context, options, request); + }, + *current, request, __func__); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_composite_health_checks_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_rest_connection_impl.h b/google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_rest_connection_impl.h new file mode 100644 index 0000000000000..a8bb43fde6a7c --- /dev/null +++ b/google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_rest_connection_impl.h @@ -0,0 +1,173 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_COMPOSITE_HEALTH_CHECKS_V1_INTERNAL_REGION_COMPOSITE_HEALTH_CHECKS_REST_CONNECTION_IMPL_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_COMPOSITE_HEALTH_CHECKS_V1_INTERNAL_REGION_COMPOSITE_HEALTH_CHECKS_REST_CONNECTION_IMPL_H + +#include "google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_rest_stub.h" +#include "google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_retry_traits.h" +#include "google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks_connection.h" +#include "google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks_connection_idempotency_policy.h" +#include "google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks_options.h" +#include "google/cloud/compute/region_operations/v1/region_operations.pb.h" +#include "google/cloud/background_threads.h" +#include "google/cloud/backoff_policy.h" +#include "google/cloud/options.h" +#include "google/cloud/status_or.h" +#include "google/cloud/stream_range.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_composite_health_checks_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class RegionCompositeHealthChecksRestConnectionImpl + : public compute_region_composite_health_checks_v1:: + RegionCompositeHealthChecksConnection { + public: + ~RegionCompositeHealthChecksRestConnectionImpl() override = default; + + RegionCompositeHealthChecksRestConnectionImpl( + std::unique_ptr background, + std::shared_ptr + stub, + Options options); + + Options options() override { return options_; } + + StreamRange> + AggregatedListRegionCompositeHealthChecks( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + AggregatedListRegionCompositeHealthChecksRequest request) override; + + future> + DeleteCompositeHealthCheck( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + DeleteCompositeHealthCheckRequest const& request) override; + + StatusOr + DeleteCompositeHealthCheck( + NoAwaitTag, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + DeleteCompositeHealthCheckRequest const& request) override; + + future> + DeleteCompositeHealthCheck( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + StatusOr + GetCompositeHealthCheck( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + GetCompositeHealthCheckRequest const& request) override; + + StatusOr + GetHealth(google::cloud::cpp::compute::region_composite_health_checks::v1:: + GetHealthRequest const& request) override; + + future> + InsertCompositeHealthCheck( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + InsertCompositeHealthCheckRequest const& request) override; + + StatusOr + InsertCompositeHealthCheck( + NoAwaitTag, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + InsertCompositeHealthCheckRequest const& request) override; + + future> + InsertCompositeHealthCheck( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + StreamRange + ListRegionCompositeHealthChecks( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + ListRegionCompositeHealthChecksRequest request) override; + + future> + PatchCompositeHealthCheck( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + PatchCompositeHealthCheckRequest const& request) override; + + StatusOr + PatchCompositeHealthCheck( + NoAwaitTag, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + PatchCompositeHealthCheckRequest const& request) override; + + future> + PatchCompositeHealthCheck( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + StatusOr + TestIamPermissions( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + TestIamPermissionsRequest const& request) override; + + private: + static std::unique_ptr + retry_policy(Options const& options) { + return options + .get() + ->clone(); + } + + static std::unique_ptr backoff_policy(Options const& options) { + return options + .get() + ->clone(); + } + + static std::unique_ptr< + compute_region_composite_health_checks_v1:: + RegionCompositeHealthChecksConnectionIdempotencyPolicy> + idempotency_policy(Options const& options) { + return options + .get() + ->clone(); + } + + static std::unique_ptr polling_policy(Options const& options) { + return options + .get() + ->clone(); + } + + std::unique_ptr background_; + std::shared_ptr + stub_; + Options options_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_composite_health_checks_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_COMPOSITE_HEALTH_CHECKS_V1_INTERNAL_REGION_COMPOSITE_HEALTH_CHECKS_REST_CONNECTION_IMPL_H diff --git a/google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_rest_logging_decorator.cc b/google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_rest_logging_decorator.cc new file mode 100644 index 0000000000000..5fe0bd4bc7957 --- /dev/null +++ b/google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_rest_logging_decorator.cc @@ -0,0 +1,259 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks.proto + +#include "google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_rest_logging_decorator.h" +#include "google/cloud/internal/log_wrapper.h" +#include "google/cloud/status_or.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_composite_health_checks_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +RegionCompositeHealthChecksRestLogging::RegionCompositeHealthChecksRestLogging( + std::shared_ptr child, + TracingOptions tracing_options, std::set components) + : child_(std::move(child)), + tracing_options_(std::move(tracing_options)), + components_(std::move(components)) {} + +StatusOr +RegionCompositeHealthChecksRestLogging:: + AggregatedListRegionCompositeHealthChecks( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + AggregatedListRegionCompositeHealthChecksRequest const& request) { + return google::cloud::internal::LogWrapper( + [this]( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + AggregatedListRegionCompositeHealthChecksRequest const& request) { + return child_->AggregatedListRegionCompositeHealthChecks( + rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +future> +RegionCompositeHealthChecksRestLogging::AsyncDeleteCompositeHealthCheck( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + DeleteCompositeHealthCheckRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + DeleteCompositeHealthCheckRequest const& request) { + return child_->AsyncDeleteCompositeHealthCheck( + cq, std::move(rest_context), std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +StatusOr +RegionCompositeHealthChecksRestLogging::DeleteCompositeHealthCheck( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + DeleteCompositeHealthCheckRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + DeleteCompositeHealthCheckRequest const& request) { + return child_->DeleteCompositeHealthCheck(rest_context, options, + request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +StatusOr +RegionCompositeHealthChecksRestLogging::GetCompositeHealthCheck( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + GetCompositeHealthCheckRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + GetCompositeHealthCheckRequest const& request) { + return child_->GetCompositeHealthCheck(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +StatusOr +RegionCompositeHealthChecksRestLogging::GetHealth( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + GetHealthRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + GetHealthRequest const& request) { + return child_->GetHealth(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +future> +RegionCompositeHealthChecksRestLogging::AsyncInsertCompositeHealthCheck( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + InsertCompositeHealthCheckRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + InsertCompositeHealthCheckRequest const& request) { + return child_->AsyncInsertCompositeHealthCheck( + cq, std::move(rest_context), std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +StatusOr +RegionCompositeHealthChecksRestLogging::InsertCompositeHealthCheck( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + InsertCompositeHealthCheckRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + InsertCompositeHealthCheckRequest const& request) { + return child_->InsertCompositeHealthCheck(rest_context, options, + request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +StatusOr +RegionCompositeHealthChecksRestLogging::ListRegionCompositeHealthChecks( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + ListRegionCompositeHealthChecksRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + ListRegionCompositeHealthChecksRequest const& request) { + return child_->ListRegionCompositeHealthChecks(rest_context, options, + request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +future> +RegionCompositeHealthChecksRestLogging::AsyncPatchCompositeHealthCheck( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + PatchCompositeHealthCheckRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + PatchCompositeHealthCheckRequest const& request) { + return child_->AsyncPatchCompositeHealthCheck( + cq, std::move(rest_context), std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +StatusOr +RegionCompositeHealthChecksRestLogging::PatchCompositeHealthCheck( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + PatchCompositeHealthCheckRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + PatchCompositeHealthCheckRequest const& request) { + return child_->PatchCompositeHealthCheck(rest_context, options, + request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +StatusOr +RegionCompositeHealthChecksRestLogging::TestIamPermissions( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + TestIamPermissionsRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + TestIamPermissionsRequest const& request) { + return child_->TestIamPermissions(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +future> +RegionCompositeHealthChecksRestLogging::AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + return child_->AsyncGetOperation(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +future RegionCompositeHealthChecksRestLogging::AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + return child_->AsyncCancelOperation(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_composite_health_checks_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_rest_logging_decorator.h b/google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_rest_logging_decorator.h new file mode 100644 index 0000000000000..627db2b59e929 --- /dev/null +++ b/google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_rest_logging_decorator.h @@ -0,0 +1,153 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_COMPOSITE_HEALTH_CHECKS_V1_INTERNAL_REGION_COMPOSITE_HEALTH_CHECKS_REST_LOGGING_DECORATOR_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_COMPOSITE_HEALTH_CHECKS_V1_INTERNAL_REGION_COMPOSITE_HEALTH_CHECKS_REST_LOGGING_DECORATOR_H + +#include "google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_rest_stub.h" +#include "google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks.pb.h" +#include "google/cloud/compute/region_operations/v1/region_operations.pb.h" +#include "google/cloud/future.h" +#include "google/cloud/internal/rest_context.h" +#include "google/cloud/tracing_options.h" +#include "google/cloud/version.h" +#include +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_composite_health_checks_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class RegionCompositeHealthChecksRestLogging + : public RegionCompositeHealthChecksRestStub { + public: + ~RegionCompositeHealthChecksRestLogging() override = default; + RegionCompositeHealthChecksRestLogging( + std::shared_ptr child, + TracingOptions tracing_options, std::set components); + + StatusOr + AggregatedListRegionCompositeHealthChecks( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + AggregatedListRegionCompositeHealthChecksRequest const& request) + override; + + future> + AsyncDeleteCompositeHealthCheck( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + DeleteCompositeHealthCheckRequest const& request) override; + + StatusOr + DeleteCompositeHealthCheck( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + DeleteCompositeHealthCheckRequest const& request) override; + + StatusOr + GetCompositeHealthCheck( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + GetCompositeHealthCheckRequest const& request) override; + + StatusOr + GetHealth(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + GetHealthRequest const& request) override; + + future> + AsyncInsertCompositeHealthCheck( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + InsertCompositeHealthCheckRequest const& request) override; + + StatusOr + InsertCompositeHealthCheck( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + InsertCompositeHealthCheckRequest const& request) override; + + StatusOr + ListRegionCompositeHealthChecks( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + ListRegionCompositeHealthChecksRequest const& request) override; + + future> + AsyncPatchCompositeHealthCheck( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + PatchCompositeHealthCheckRequest const& request) override; + + StatusOr + PatchCompositeHealthCheck( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + PatchCompositeHealthCheckRequest const& request) override; + + StatusOr + TestIamPermissions( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + TestIamPermissionsRequest const& request) override; + + future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) override; + + future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) override; + + private: + std::shared_ptr child_; + TracingOptions tracing_options_; + std::set components_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_composite_health_checks_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_COMPOSITE_HEALTH_CHECKS_V1_INTERNAL_REGION_COMPOSITE_HEALTH_CHECKS_REST_LOGGING_DECORATOR_H diff --git a/google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_rest_metadata_decorator.cc b/google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_rest_metadata_decorator.cc new file mode 100644 index 0000000000000..e65732d99e49c --- /dev/null +++ b/google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_rest_metadata_decorator.cc @@ -0,0 +1,188 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks.proto + +#include "google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_rest_metadata_decorator.h" +#include "google/cloud/internal/api_client_header.h" +#include "google/cloud/internal/rest_set_metadata.h" +#include "google/cloud/status_or.h" +#include "absl/strings/str_cat.h" +#include "absl/strings/str_format.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_composite_health_checks_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +RegionCompositeHealthChecksRestMetadata:: + RegionCompositeHealthChecksRestMetadata( + std::shared_ptr child, + std::string api_client_header) + : child_(std::move(child)), + api_client_header_( + api_client_header.empty() + ? google::cloud::internal::GeneratedLibClientHeader() + : std::move(api_client_header)) {} + +StatusOr +RegionCompositeHealthChecksRestMetadata:: + AggregatedListRegionCompositeHealthChecks( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + AggregatedListRegionCompositeHealthChecksRequest const& request) { + SetMetadata(rest_context, options); + return child_->AggregatedListRegionCompositeHealthChecks(rest_context, + options, request); +} + +future> +RegionCompositeHealthChecksRestMetadata::AsyncDeleteCompositeHealthCheck( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + DeleteCompositeHealthCheckRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncDeleteCompositeHealthCheck(cq, std::move(rest_context), + std::move(options), request); +} + +StatusOr +RegionCompositeHealthChecksRestMetadata::DeleteCompositeHealthCheck( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + DeleteCompositeHealthCheckRequest const& request) { + SetMetadata(rest_context, options); + return child_->DeleteCompositeHealthCheck(rest_context, options, request); +} + +StatusOr +RegionCompositeHealthChecksRestMetadata::GetCompositeHealthCheck( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + GetCompositeHealthCheckRequest const& request) { + SetMetadata(rest_context, options); + return child_->GetCompositeHealthCheck(rest_context, options, request); +} + +StatusOr +RegionCompositeHealthChecksRestMetadata::GetHealth( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + GetHealthRequest const& request) { + SetMetadata(rest_context, options); + return child_->GetHealth(rest_context, options, request); +} + +future> +RegionCompositeHealthChecksRestMetadata::AsyncInsertCompositeHealthCheck( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + InsertCompositeHealthCheckRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncInsertCompositeHealthCheck(cq, std::move(rest_context), + std::move(options), request); +} + +StatusOr +RegionCompositeHealthChecksRestMetadata::InsertCompositeHealthCheck( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + InsertCompositeHealthCheckRequest const& request) { + SetMetadata(rest_context, options); + return child_->InsertCompositeHealthCheck(rest_context, options, request); +} + +StatusOr +RegionCompositeHealthChecksRestMetadata::ListRegionCompositeHealthChecks( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + ListRegionCompositeHealthChecksRequest const& request) { + SetMetadata(rest_context, options); + return child_->ListRegionCompositeHealthChecks(rest_context, options, + request); +} + +future> +RegionCompositeHealthChecksRestMetadata::AsyncPatchCompositeHealthCheck( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + PatchCompositeHealthCheckRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncPatchCompositeHealthCheck(cq, std::move(rest_context), + std::move(options), request); +} + +StatusOr +RegionCompositeHealthChecksRestMetadata::PatchCompositeHealthCheck( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + PatchCompositeHealthCheckRequest const& request) { + SetMetadata(rest_context, options); + return child_->PatchCompositeHealthCheck(rest_context, options, request); +} + +StatusOr +RegionCompositeHealthChecksRestMetadata::TestIamPermissions( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + TestIamPermissionsRequest const& request) { + SetMetadata(rest_context, options); + return child_->TestIamPermissions(rest_context, options, request); +} + +future> +RegionCompositeHealthChecksRestMetadata::AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncGetOperation(cq, std::move(rest_context), + std::move(options), request); +} + +future RegionCompositeHealthChecksRestMetadata::AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncCancelOperation(cq, std::move(rest_context), + std::move(options), request); +} + +void RegionCompositeHealthChecksRestMetadata::SetMetadata( + rest_internal::RestContext& rest_context, Options const& options, + std::vector const& params) { + google::cloud::rest_internal::SetMetadata(rest_context, options, params, + api_client_header_); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_composite_health_checks_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_rest_metadata_decorator.h b/google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_rest_metadata_decorator.h new file mode 100644 index 0000000000000..b702669b3b068 --- /dev/null +++ b/google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_rest_metadata_decorator.h @@ -0,0 +1,154 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_COMPOSITE_HEALTH_CHECKS_V1_INTERNAL_REGION_COMPOSITE_HEALTH_CHECKS_REST_METADATA_DECORATOR_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_COMPOSITE_HEALTH_CHECKS_V1_INTERNAL_REGION_COMPOSITE_HEALTH_CHECKS_REST_METADATA_DECORATOR_H + +#include "google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_rest_stub.h" +#include "google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks.pb.h" +#include "google/cloud/compute/region_operations/v1/region_operations.pb.h" +#include "google/cloud/future.h" +#include "google/cloud/rest_options.h" +#include "google/cloud/version.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_composite_health_checks_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class RegionCompositeHealthChecksRestMetadata + : public RegionCompositeHealthChecksRestStub { + public: + ~RegionCompositeHealthChecksRestMetadata() override = default; + explicit RegionCompositeHealthChecksRestMetadata( + std::shared_ptr child, + std::string api_client_header = ""); + + StatusOr + AggregatedListRegionCompositeHealthChecks( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + AggregatedListRegionCompositeHealthChecksRequest const& request) + override; + + google::cloud::future> + AsyncDeleteCompositeHealthCheck( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + DeleteCompositeHealthCheckRequest const& request) override; + + StatusOr + DeleteCompositeHealthCheck( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + DeleteCompositeHealthCheckRequest const& request) override; + + StatusOr + GetCompositeHealthCheck( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + GetCompositeHealthCheckRequest const& request) override; + + StatusOr + GetHealth(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + GetHealthRequest const& request) override; + + google::cloud::future> + AsyncInsertCompositeHealthCheck( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + InsertCompositeHealthCheckRequest const& request) override; + + StatusOr + InsertCompositeHealthCheck( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + InsertCompositeHealthCheckRequest const& request) override; + + StatusOr + ListRegionCompositeHealthChecks( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + ListRegionCompositeHealthChecksRequest const& request) override; + + google::cloud::future> + AsyncPatchCompositeHealthCheck( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + PatchCompositeHealthCheckRequest const& request) override; + + StatusOr + PatchCompositeHealthCheck( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + PatchCompositeHealthCheckRequest const& request) override; + + StatusOr + TestIamPermissions( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + TestIamPermissionsRequest const& request) override; + + google::cloud::future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) override; + + google::cloud::future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) override; + + private: + void SetMetadata(rest_internal::RestContext& rest_context, + Options const& options, + std::vector const& params = {}); + + std::shared_ptr child_; + std::string api_client_header_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_composite_health_checks_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_COMPOSITE_HEALTH_CHECKS_V1_INTERNAL_REGION_COMPOSITE_HEALTH_CHECKS_REST_METADATA_DECORATOR_H diff --git a/google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_rest_stub.cc b/google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_rest_stub.cc new file mode 100644 index 0000000000000..51177debd89bd --- /dev/null +++ b/google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_rest_stub.cc @@ -0,0 +1,402 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks.proto + +#include "google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_rest_stub.h" +#include "google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks.pb.h" +#include "google/cloud/compute/region_operations/v1/region_operations.pb.h" +#include "google/cloud/common_options.h" +#include "google/cloud/internal/rest_stub_helpers.h" +#include "google/cloud/status_or.h" +#include "absl/strings/str_cat.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_composite_health_checks_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +DefaultRegionCompositeHealthChecksRestStub:: + DefaultRegionCompositeHealthChecksRestStub(Options options) + : service_(rest_internal::MakePooledRestClient( + options.get(), options)), + operations_(rest_internal::MakePooledRestClient( + options.get(), options)), + options_(std::move(options)) {} + +DefaultRegionCompositeHealthChecksRestStub:: + DefaultRegionCompositeHealthChecksRestStub( + std::shared_ptr service, + std::shared_ptr operations, Options options) + : service_(std::move(service)), + operations_(std::move(operations)), + options_(std::move(options)) {} + +StatusOr +DefaultRegionCompositeHealthChecksRestStub:: + AggregatedListRegionCompositeHealthChecks( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + AggregatedListRegionCompositeHealthChecksRequest const& request) { + std::vector> query_params; + query_params.push_back({"filter", request.filter()}); + query_params.push_back( + {"include_all_scopes", (request.include_all_scopes() ? "1" : "0")}); + query_params.push_back( + {"max_results", std::to_string(request.max_results())}); + query_params.push_back({"order_by", request.order_by()}); + query_params.push_back({"page_token", request.page_token()}); + query_params.push_back({"return_partial_success", + (request.return_partial_success() ? "1" : "0")}); + query_params.push_back( + {"service_project_number", request.service_project_number()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Get< + google::cloud::cpp::compute::v1::CompositeHealthCheckAggregatedList>( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "aggregated", "/", + "compositeHealthChecks"), + std::move(query_params)); +} + +future> +DefaultRegionCompositeHealthChecksRestStub::AsyncDeleteCompositeHealthCheck( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + DeleteCompositeHealthCheckRequest const& request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto service, auto request, auto rest_context, auto options) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + p.set_value( + rest_internal::Delete( + *service, *rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", *options), + "/", "projects", "/", request.project(), "/", + "regions", "/", request.region(), "/", + "compositeHealthChecks", "/", + request.composite_health_check()), + std::move(query_params))); + }, + std::move(p), + service_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +StatusOr +DefaultRegionCompositeHealthChecksRestStub::DeleteCompositeHealthCheck( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + DeleteCompositeHealthCheckRequest const& request) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Delete( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "regions", "/", + request.region(), "/", "compositeHealthChecks", "/", + request.composite_health_check()), + std::move(query_params)); +} + +StatusOr +DefaultRegionCompositeHealthChecksRestStub::GetCompositeHealthCheck( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + GetCompositeHealthCheckRequest const& request) { + std::vector> query_params; + return rest_internal::Get< + google::cloud::cpp::compute::v1::CompositeHealthCheck>( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "regions", "/", + request.region(), "/", "compositeHealthChecks", "/", + request.composite_health_check()), + std::move(query_params)); +} + +StatusOr +DefaultRegionCompositeHealthChecksRestStub::GetHealth( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + GetHealthRequest const& request) { + std::vector> query_params; + return rest_internal::Get< + google::cloud::cpp::compute::v1::CompositeHealthCheckHealth>( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "regions", "/", + request.region(), "/", "compositeHealthChecks", "/", + request.composite_health_check(), "/", "getHealth"), + std::move(query_params)); +} + +future> +DefaultRegionCompositeHealthChecksRestStub::AsyncInsertCompositeHealthCheck( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + InsertCompositeHealthCheckRequest const& request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto service, auto request, auto rest_context, auto options) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + p.set_value( + rest_internal::Post( + *service, *rest_context, + request.composite_health_check_resource(), false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", *options), + "/", "projects", "/", request.project(), "/", + "regions", "/", request.region(), "/", + "compositeHealthChecks"), + std::move(query_params))); + }, + std::move(p), + service_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +StatusOr +DefaultRegionCompositeHealthChecksRestStub::InsertCompositeHealthCheck( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + InsertCompositeHealthCheckRequest const& request) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Post( + *service_, rest_context, request.composite_health_check_resource(), false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "regions", "/", + request.region(), "/", "compositeHealthChecks"), + std::move(query_params)); +} + +StatusOr +DefaultRegionCompositeHealthChecksRestStub::ListRegionCompositeHealthChecks( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + ListRegionCompositeHealthChecksRequest const& request) { + std::vector> query_params; + query_params.push_back({"filter", request.filter()}); + query_params.push_back( + {"max_results", std::to_string(request.max_results())}); + query_params.push_back({"order_by", request.order_by()}); + query_params.push_back({"page_token", request.page_token()}); + query_params.push_back({"return_partial_success", + (request.return_partial_success() ? "1" : "0")}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Get< + google::cloud::cpp::compute::v1::CompositeHealthCheckList>( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "regions", "/", + request.region(), "/", "compositeHealthChecks"), + std::move(query_params)); +} + +future> +DefaultRegionCompositeHealthChecksRestStub::AsyncPatchCompositeHealthCheck( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + PatchCompositeHealthCheckRequest const& request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto service, auto request, auto rest_context, auto options) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + p.set_value( + rest_internal::Patch( + *service, *rest_context, + request.composite_health_check_resource(), false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", *options), + "/", "projects", "/", request.project(), "/", + "regions", "/", request.region(), "/", + "compositeHealthChecks", "/", + request.composite_health_check()), + std::move(query_params))); + }, + std::move(p), + service_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +StatusOr +DefaultRegionCompositeHealthChecksRestStub::PatchCompositeHealthCheck( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + PatchCompositeHealthCheckRequest const& request) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Patch( + *service_, rest_context, request.composite_health_check_resource(), false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "regions", "/", + request.region(), "/", "compositeHealthChecks", "/", + request.composite_health_check()), + std::move(query_params)); +} + +StatusOr +DefaultRegionCompositeHealthChecksRestStub::TestIamPermissions( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + TestIamPermissionsRequest const& request) { + std::vector> query_params; + return rest_internal::Post< + google::cloud::cpp::compute::v1::TestPermissionsResponse>( + *service_, rest_context, request.test_permissions_request_resource(), + false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "regions", "/", + request.region(), "/", "compositeHealthChecks", "/", + request.resource(), "/", "testIamPermissions"), + std::move(query_params)); +} + +future> +DefaultRegionCompositeHealthChecksRestStub::AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto operations, auto request, auto rest_context, + auto options) { + p.set_value( + rest_internal::Get( + *operations, *rest_context, request, false, + absl::StrCat("/compute/", + rest_internal::DetermineApiVersion("v1", *options), + "/projects/", request.project(), "/regions/", + request.region(), "/operations/", + request.operation()))); + }, + std::move(p), + operations_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +future DefaultRegionCompositeHealthChecksRestStub::AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + promise> p; + future> f = p.get_future(); + std::thread t{ + [](auto p, auto operations, auto request, auto rest_context, + auto options) { + p.set_value(rest_internal::Post( + *operations, *rest_context, request, false, + absl::StrCat( + "/compute/", rest_internal::DetermineApiVersion("v1", *options), + "/projects/", request.project(), "/regions/", request.region(), + "/operations/", request.operation()))); + }, + std::move(p), + operations_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get().status(); + }); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_composite_health_checks_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_rest_stub.h b/google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_rest_stub.h new file mode 100644 index 0000000000000..2fdfa170d02dc --- /dev/null +++ b/google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_rest_stub.h @@ -0,0 +1,253 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_COMPOSITE_HEALTH_CHECKS_V1_INTERNAL_REGION_COMPOSITE_HEALTH_CHECKS_REST_STUB_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_COMPOSITE_HEALTH_CHECKS_V1_INTERNAL_REGION_COMPOSITE_HEALTH_CHECKS_REST_STUB_H + +#include "google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks.pb.h" +#include "google/cloud/compute/region_operations/v1/region_operations.pb.h" +#include "google/cloud/completion_queue.h" +#include "google/cloud/internal/rest_client.h" +#include "google/cloud/internal/rest_context.h" +#include "google/cloud/status_or.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_composite_health_checks_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class RegionCompositeHealthChecksRestStub { + public: + virtual ~RegionCompositeHealthChecksRestStub() = default; + + virtual StatusOr< + google::cloud::cpp::compute::v1::CompositeHealthCheckAggregatedList> + AggregatedListRegionCompositeHealthChecks( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + AggregatedListRegionCompositeHealthChecksRequest const& request) = 0; + + virtual future> + AsyncDeleteCompositeHealthCheck( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + DeleteCompositeHealthCheckRequest const& request) = 0; + + virtual StatusOr + DeleteCompositeHealthCheck( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + DeleteCompositeHealthCheckRequest const& request) = 0; + + virtual StatusOr + GetCompositeHealthCheck( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + GetCompositeHealthCheckRequest const& request) = 0; + + virtual StatusOr + GetHealth(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + GetHealthRequest const& request) = 0; + + virtual future> + AsyncInsertCompositeHealthCheck( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + InsertCompositeHealthCheckRequest const& request) = 0; + + virtual StatusOr + InsertCompositeHealthCheck( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + InsertCompositeHealthCheckRequest const& request) = 0; + + virtual StatusOr + ListRegionCompositeHealthChecks( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + ListRegionCompositeHealthChecksRequest const& request) = 0; + + virtual future> + AsyncPatchCompositeHealthCheck( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + PatchCompositeHealthCheckRequest const& request) = 0; + + virtual StatusOr + PatchCompositeHealthCheck( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + PatchCompositeHealthCheckRequest const& request) = 0; + + virtual StatusOr + TestIamPermissions( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + TestIamPermissionsRequest const& request) = 0; + + virtual future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) = 0; + + virtual future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) = 0; +}; + +class DefaultRegionCompositeHealthChecksRestStub + : public RegionCompositeHealthChecksRestStub { + public: + ~DefaultRegionCompositeHealthChecksRestStub() override = default; + + explicit DefaultRegionCompositeHealthChecksRestStub(Options options); + DefaultRegionCompositeHealthChecksRestStub( + std::shared_ptr service, + std::shared_ptr operations, Options options); + + StatusOr + AggregatedListRegionCompositeHealthChecks( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + AggregatedListRegionCompositeHealthChecksRequest const& request) + override; + + future> + AsyncDeleteCompositeHealthCheck( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + DeleteCompositeHealthCheckRequest const& request) override; + + StatusOr + DeleteCompositeHealthCheck( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + DeleteCompositeHealthCheckRequest const& request) override; + + StatusOr + GetCompositeHealthCheck( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + GetCompositeHealthCheckRequest const& request) override; + + StatusOr + GetHealth(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + GetHealthRequest const& request) override; + + future> + AsyncInsertCompositeHealthCheck( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + InsertCompositeHealthCheckRequest const& request) override; + + StatusOr + InsertCompositeHealthCheck( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + InsertCompositeHealthCheckRequest const& request) override; + + StatusOr + ListRegionCompositeHealthChecks( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + ListRegionCompositeHealthChecksRequest const& request) override; + + future> + AsyncPatchCompositeHealthCheck( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + PatchCompositeHealthCheckRequest const& request) override; + + StatusOr + PatchCompositeHealthCheck( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + PatchCompositeHealthCheckRequest const& request) override; + + StatusOr + TestIamPermissions( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + TestIamPermissionsRequest const& request) override; + + future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) override; + + future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) override; + + private: + std::shared_ptr service_; + std::shared_ptr operations_; + Options options_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_composite_health_checks_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_COMPOSITE_HEALTH_CHECKS_V1_INTERNAL_REGION_COMPOSITE_HEALTH_CHECKS_REST_STUB_H diff --git a/google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_rest_stub_factory.cc b/google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_rest_stub_factory.cc new file mode 100644 index 0000000000000..bdd148704dd37 --- /dev/null +++ b/google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_rest_stub_factory.cc @@ -0,0 +1,59 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks.proto + +#include "google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_rest_stub_factory.h" +#include "google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_rest_logging_decorator.h" +#include "google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_rest_metadata_decorator.h" +#include "google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_rest_stub.h" +#include "google/cloud/common_options.h" +#include "google/cloud/internal/algorithm.h" +#include "google/cloud/internal/populate_rest_options.h" +#include "google/cloud/log.h" +#include "google/cloud/options.h" +#include "google/cloud/rest_options.h" +#include "absl/strings/match.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_composite_health_checks_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +std::shared_ptr +CreateDefaultRegionCompositeHealthChecksRestStub(Options const& options) { + auto opts = internal::PopulateRestOptions(options); + std::shared_ptr stub = + std::make_shared( + std::move(opts)); + stub = std::make_shared( + std::move(stub)); + if (internal::Contains(options.get(), "rpc")) { + GCP_LOG(INFO) << "Enabled logging for REST rpc calls"; + stub = std::make_shared( + std::move(stub), options.get(), + options.get()); + } + return stub; +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_composite_health_checks_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_rest_stub_factory.h b/google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_rest_stub_factory.h new file mode 100644 index 0000000000000..80e014be97bd2 --- /dev/null +++ b/google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_rest_stub_factory.h @@ -0,0 +1,41 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_COMPOSITE_HEALTH_CHECKS_V1_INTERNAL_REGION_COMPOSITE_HEALTH_CHECKS_REST_STUB_FACTORY_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_COMPOSITE_HEALTH_CHECKS_V1_INTERNAL_REGION_COMPOSITE_HEALTH_CHECKS_REST_STUB_FACTORY_H + +#include "google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_rest_stub.h" +#include "google/cloud/options.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_composite_health_checks_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +std::shared_ptr +CreateDefaultRegionCompositeHealthChecksRestStub(Options const& options); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_composite_health_checks_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_COMPOSITE_HEALTH_CHECKS_V1_INTERNAL_REGION_COMPOSITE_HEALTH_CHECKS_REST_STUB_FACTORY_H diff --git a/google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_retry_traits.h b/google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_retry_traits.h new file mode 100644 index 0000000000000..5a96598d9d315 --- /dev/null +++ b/google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_retry_traits.h @@ -0,0 +1,44 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_COMPOSITE_HEALTH_CHECKS_V1_INTERNAL_REGION_COMPOSITE_HEALTH_CHECKS_RETRY_TRAITS_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_COMPOSITE_HEALTH_CHECKS_V1_INTERNAL_REGION_COMPOSITE_HEALTH_CHECKS_RETRY_TRAITS_H + +#include "google/cloud/status.h" +#include "google/cloud/version.h" + +namespace google { +namespace cloud { +namespace compute_region_composite_health_checks_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/// Define the gRPC status code semantics for retrying requests. +struct RegionCompositeHealthChecksRetryTraits { + static bool IsPermanentFailure(google::cloud::Status const& status) { + return status.code() != StatusCode::kOk && + status.code() != StatusCode::kUnavailable; + } +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_composite_health_checks_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_COMPOSITE_HEALTH_CHECKS_V1_INTERNAL_REGION_COMPOSITE_HEALTH_CHECKS_RETRY_TRAITS_H diff --git a/google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_sources.cc b/google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_sources.cc new file mode 100644 index 0000000000000..2a454c9393a15 --- /dev/null +++ b/google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_sources.cc @@ -0,0 +1,32 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks.proto + +// NOLINTBEGIN(bugprone-suspicious-include) +#include "google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_option_defaults.cc" +#include "google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_rest_connection_impl.cc" +#include "google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_rest_logging_decorator.cc" +#include "google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_rest_metadata_decorator.cc" +#include "google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_rest_stub.cc" +#include "google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_rest_stub_factory.cc" +#include "google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_tracing_connection.cc" +#include "google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks_client.cc" +#include "google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks_connection.cc" +#include "google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks_connection_idempotency_policy.cc" +#include "google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks_rest_connection.cc" +// NOLINTEND(bugprone-suspicious-include) diff --git a/google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_tracing_connection.cc b/google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_tracing_connection.cc new file mode 100644 index 0000000000000..1cdee8f6f23c6 --- /dev/null +++ b/google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_tracing_connection.cc @@ -0,0 +1,226 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks.proto + +#include "google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_tracing_connection.h" +#include "google/cloud/internal/opentelemetry.h" +#include "google/cloud/internal/traced_stream_range.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_composite_health_checks_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +RegionCompositeHealthChecksTracingConnection:: + RegionCompositeHealthChecksTracingConnection( + std::shared_ptr + child) + : child_(std::move(child)) {} + +StreamRange< + std::pair> +RegionCompositeHealthChecksTracingConnection:: + AggregatedListRegionCompositeHealthChecks( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + AggregatedListRegionCompositeHealthChecksRequest request) { + auto span = internal::MakeSpan( + "compute_region_composite_health_checks_v1::" + "RegionCompositeHealthChecksConnection::" + "AggregatedListRegionCompositeHealthChecks"); + internal::OTelScope scope(span); + auto sr = + child_->AggregatedListRegionCompositeHealthChecks(std::move(request)); + return internal::MakeTracedStreamRange>( + std::move(span), std::move(sr)); +} + +future> +RegionCompositeHealthChecksTracingConnection::DeleteCompositeHealthCheck( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + DeleteCompositeHealthCheckRequest const& request) { + auto span = internal::MakeSpan( + "compute_region_composite_health_checks_v1::" + "RegionCompositeHealthChecksConnection::DeleteCompositeHealthCheck"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), + child_->DeleteCompositeHealthCheck(request)); +} + +StatusOr +RegionCompositeHealthChecksTracingConnection::DeleteCompositeHealthCheck( + NoAwaitTag, google::cloud::cpp::compute::region_composite_health_checks:: + v1::DeleteCompositeHealthCheckRequest const& request) { + auto span = internal::MakeSpan( + "compute_region_composite_health_checks_v1::" + "RegionCompositeHealthChecksConnection::DeleteCompositeHealthCheck"); + opentelemetry::trace::Scope scope(span); + return internal::EndSpan( + *span, child_->DeleteCompositeHealthCheck(NoAwaitTag{}, request)); +} + +future> +RegionCompositeHealthChecksTracingConnection::DeleteCompositeHealthCheck( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto span = internal::MakeSpan( + "compute_region_composite_health_checks_v1::" + "RegionCompositeHealthChecksConnection::DeleteCompositeHealthCheck"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), + child_->DeleteCompositeHealthCheck(operation)); +} + +StatusOr +RegionCompositeHealthChecksTracingConnection::GetCompositeHealthCheck( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + GetCompositeHealthCheckRequest const& request) { + auto span = internal::MakeSpan( + "compute_region_composite_health_checks_v1::" + "RegionCompositeHealthChecksConnection::GetCompositeHealthCheck"); + auto scope = opentelemetry::trace::Scope(span); + return internal::EndSpan(*span, child_->GetCompositeHealthCheck(request)); +} + +StatusOr +RegionCompositeHealthChecksTracingConnection::GetHealth( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + GetHealthRequest const& request) { + auto span = internal::MakeSpan( + "compute_region_composite_health_checks_v1::" + "RegionCompositeHealthChecksConnection::GetHealth"); + auto scope = opentelemetry::trace::Scope(span); + return internal::EndSpan(*span, child_->GetHealth(request)); +} + +future> +RegionCompositeHealthChecksTracingConnection::InsertCompositeHealthCheck( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + InsertCompositeHealthCheckRequest const& request) { + auto span = internal::MakeSpan( + "compute_region_composite_health_checks_v1::" + "RegionCompositeHealthChecksConnection::InsertCompositeHealthCheck"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), + child_->InsertCompositeHealthCheck(request)); +} + +StatusOr +RegionCompositeHealthChecksTracingConnection::InsertCompositeHealthCheck( + NoAwaitTag, google::cloud::cpp::compute::region_composite_health_checks:: + v1::InsertCompositeHealthCheckRequest const& request) { + auto span = internal::MakeSpan( + "compute_region_composite_health_checks_v1::" + "RegionCompositeHealthChecksConnection::InsertCompositeHealthCheck"); + opentelemetry::trace::Scope scope(span); + return internal::EndSpan( + *span, child_->InsertCompositeHealthCheck(NoAwaitTag{}, request)); +} + +future> +RegionCompositeHealthChecksTracingConnection::InsertCompositeHealthCheck( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto span = internal::MakeSpan( + "compute_region_composite_health_checks_v1::" + "RegionCompositeHealthChecksConnection::InsertCompositeHealthCheck"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), + child_->InsertCompositeHealthCheck(operation)); +} + +StreamRange +RegionCompositeHealthChecksTracingConnection::ListRegionCompositeHealthChecks( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + ListRegionCompositeHealthChecksRequest request) { + auto span = internal::MakeSpan( + "compute_region_composite_health_checks_v1::" + "RegionCompositeHealthChecksConnection::ListRegionCompositeHealthChecks"); + internal::OTelScope scope(span); + auto sr = child_->ListRegionCompositeHealthChecks(std::move(request)); + return internal::MakeTracedStreamRange< + google::cloud::cpp::compute::v1::CompositeHealthCheck>(std::move(span), + std::move(sr)); +} + +future> +RegionCompositeHealthChecksTracingConnection::PatchCompositeHealthCheck( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + PatchCompositeHealthCheckRequest const& request) { + auto span = internal::MakeSpan( + "compute_region_composite_health_checks_v1::" + "RegionCompositeHealthChecksConnection::PatchCompositeHealthCheck"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), + child_->PatchCompositeHealthCheck(request)); +} + +StatusOr +RegionCompositeHealthChecksTracingConnection::PatchCompositeHealthCheck( + NoAwaitTag, google::cloud::cpp::compute::region_composite_health_checks:: + v1::PatchCompositeHealthCheckRequest const& request) { + auto span = internal::MakeSpan( + "compute_region_composite_health_checks_v1::" + "RegionCompositeHealthChecksConnection::PatchCompositeHealthCheck"); + opentelemetry::trace::Scope scope(span); + return internal::EndSpan( + *span, child_->PatchCompositeHealthCheck(NoAwaitTag{}, request)); +} + +future> +RegionCompositeHealthChecksTracingConnection::PatchCompositeHealthCheck( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto span = internal::MakeSpan( + "compute_region_composite_health_checks_v1::" + "RegionCompositeHealthChecksConnection::PatchCompositeHealthCheck"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), + child_->PatchCompositeHealthCheck(operation)); +} + +StatusOr +RegionCompositeHealthChecksTracingConnection::TestIamPermissions( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + TestIamPermissionsRequest const& request) { + auto span = internal::MakeSpan( + "compute_region_composite_health_checks_v1::" + "RegionCompositeHealthChecksConnection::TestIamPermissions"); + auto scope = opentelemetry::trace::Scope(span); + return internal::EndSpan(*span, child_->TestIamPermissions(request)); +} + +std::shared_ptr +MakeRegionCompositeHealthChecksTracingConnection( + std::shared_ptr + conn) { + if (internal::TracingEnabled(conn->options())) { + conn = std::make_shared( + std::move(conn)); + } + return conn; +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_composite_health_checks_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_tracing_connection.h b/google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_tracing_connection.h new file mode 100644 index 0000000000000..b37b4c68fae6a --- /dev/null +++ b/google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_tracing_connection.h @@ -0,0 +1,139 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_COMPOSITE_HEALTH_CHECKS_V1_INTERNAL_REGION_COMPOSITE_HEALTH_CHECKS_TRACING_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_COMPOSITE_HEALTH_CHECKS_V1_INTERNAL_REGION_COMPOSITE_HEALTH_CHECKS_TRACING_CONNECTION_H + +#include "google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks_connection.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_composite_health_checks_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class RegionCompositeHealthChecksTracingConnection + : public compute_region_composite_health_checks_v1:: + RegionCompositeHealthChecksConnection { + public: + ~RegionCompositeHealthChecksTracingConnection() override = default; + + explicit RegionCompositeHealthChecksTracingConnection( + std::shared_ptr + child); + + Options options() override { return child_->options(); } + + StreamRange> + AggregatedListRegionCompositeHealthChecks( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + AggregatedListRegionCompositeHealthChecksRequest request) override; + + future> + DeleteCompositeHealthCheck( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + DeleteCompositeHealthCheckRequest const& request) override; + + StatusOr + DeleteCompositeHealthCheck( + NoAwaitTag, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + DeleteCompositeHealthCheckRequest const& request) override; + + future> + DeleteCompositeHealthCheck( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + StatusOr + GetCompositeHealthCheck( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + GetCompositeHealthCheckRequest const& request) override; + + StatusOr + GetHealth(google::cloud::cpp::compute::region_composite_health_checks::v1:: + GetHealthRequest const& request) override; + + future> + InsertCompositeHealthCheck( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + InsertCompositeHealthCheckRequest const& request) override; + + StatusOr + InsertCompositeHealthCheck( + NoAwaitTag, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + InsertCompositeHealthCheckRequest const& request) override; + + future> + InsertCompositeHealthCheck( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + StreamRange + ListRegionCompositeHealthChecks( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + ListRegionCompositeHealthChecksRequest request) override; + + future> + PatchCompositeHealthCheck( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + PatchCompositeHealthCheckRequest const& request) override; + + StatusOr + PatchCompositeHealthCheck( + NoAwaitTag, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + PatchCompositeHealthCheckRequest const& request) override; + + future> + PatchCompositeHealthCheck( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + StatusOr + TestIamPermissions( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + TestIamPermissionsRequest const& request) override; + + private: + std::shared_ptr + child_; +}; + +/** + * Conditionally applies the tracing decorator to the given connection. + * + * The connection is only decorated if tracing is enabled (as determined by the + * connection's options). + */ +std::shared_ptr +MakeRegionCompositeHealthChecksTracingConnection( + std::shared_ptr + conn); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_composite_health_checks_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_COMPOSITE_HEALTH_CHECKS_V1_INTERNAL_REGION_COMPOSITE_HEALTH_CHECKS_TRACING_CONNECTION_H diff --git a/google/cloud/compute/region_composite_health_checks/v1/mocks/mock_region_composite_health_checks_connection.h b/google/cloud/compute/region_composite_health_checks/v1/mocks/mock_region_composite_health_checks_connection.h new file mode 100644 index 0000000000000..ba23ff3a8a3c1 --- /dev/null +++ b/google/cloud/compute/region_composite_health_checks/v1/mocks/mock_region_composite_health_checks_connection.h @@ -0,0 +1,220 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_COMPOSITE_HEALTH_CHECKS_V1_MOCKS_MOCK_REGION_COMPOSITE_HEALTH_CHECKS_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_COMPOSITE_HEALTH_CHECKS_V1_MOCKS_MOCK_REGION_COMPOSITE_HEALTH_CHECKS_CONNECTION_H + +#include "google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks_connection.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_composite_health_checks_v1_mocks { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/** + * A class to mock `RegionCompositeHealthChecksConnection`. + * + * Application developers may want to test their code with simulated responses, + * including errors, from an object of type `RegionCompositeHealthChecksClient`. + * To do so, construct an object of type `RegionCompositeHealthChecksClient` + * with an instance of this class. Then use the Google Test framework functions + * to program the behavior of this mock. + * + * @see [This example][bq-mock] for how to test your application with GoogleTest. + * While the example showcases types from the BigQuery library, the underlying + * principles apply for any pair of `*Client` and `*Connection`. + * + * [bq-mock]: @cloud_cpp_docs_link{bigquery,bigquery-read-mock} + */ +class MockRegionCompositeHealthChecksConnection + : public compute_region_composite_health_checks_v1:: + RegionCompositeHealthChecksConnection { + public: + MOCK_METHOD(Options, options, (), (override)); + + MOCK_METHOD( + (StreamRange>), + AggregatedListRegionCompositeHealthChecks, + (google::cloud::cpp::compute::region_composite_health_checks::v1:: + AggregatedListRegionCompositeHealthChecksRequest request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// DeleteCompositeHealthCheck(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + DeleteCompositeHealthCheck, + (google::cloud::cpp::compute::region_composite_health_checks::v1:: + DeleteCompositeHealthCheckRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// EXPECT_CALL(*mock, DeleteCompositeHealthCheck(_, _)) + /// @endcode + MOCK_METHOD(StatusOr, + DeleteCompositeHealthCheck, + (NoAwaitTag, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + DeleteCompositeHealthCheckRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// DeleteCompositeHealthCheck(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + DeleteCompositeHealthCheck, + (google::cloud::cpp::compute::v1::Operation const& operation), + (override)); + + MOCK_METHOD(StatusOr, + GetCompositeHealthCheck, + (google::cloud::cpp::compute::region_composite_health_checks::v1:: + GetCompositeHealthCheckRequest const& request), + (override)); + + MOCK_METHOD( + StatusOr, + GetHealth, + (google::cloud::cpp::compute::region_composite_health_checks::v1:: + GetHealthRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// InsertCompositeHealthCheck(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + InsertCompositeHealthCheck, + (google::cloud::cpp::compute::region_composite_health_checks::v1:: + InsertCompositeHealthCheckRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// EXPECT_CALL(*mock, InsertCompositeHealthCheck(_, _)) + /// @endcode + MOCK_METHOD(StatusOr, + InsertCompositeHealthCheck, + (NoAwaitTag, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + InsertCompositeHealthCheckRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// InsertCompositeHealthCheck(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + InsertCompositeHealthCheck, + (google::cloud::cpp::compute::v1::Operation const& operation), + (override)); + + MOCK_METHOD( + (StreamRange), + ListRegionCompositeHealthChecks, + (google::cloud::cpp::compute::region_composite_health_checks::v1:: + ListRegionCompositeHealthChecksRequest request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// PatchCompositeHealthCheck(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + PatchCompositeHealthCheck, + (google::cloud::cpp::compute::region_composite_health_checks::v1:: + PatchCompositeHealthCheckRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// EXPECT_CALL(*mock, PatchCompositeHealthCheck(_, _)) + /// @endcode + MOCK_METHOD(StatusOr, + PatchCompositeHealthCheck, + (NoAwaitTag, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + PatchCompositeHealthCheckRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// PatchCompositeHealthCheck(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + PatchCompositeHealthCheck, + (google::cloud::cpp::compute::v1::Operation const& operation), + (override)); + + MOCK_METHOD( + StatusOr, + TestIamPermissions, + (google::cloud::cpp::compute::region_composite_health_checks::v1:: + TestIamPermissionsRequest const& request), + (override)); +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_composite_health_checks_v1_mocks +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_COMPOSITE_HEALTH_CHECKS_V1_MOCKS_MOCK_REGION_COMPOSITE_HEALTH_CHECKS_CONNECTION_H diff --git a/google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks_client.cc b/google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks_client.cc new file mode 100644 index 0000000000000..ec87d0554d8bd --- /dev/null +++ b/google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks_client.cc @@ -0,0 +1,328 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks.proto + +#include "google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks_client.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_composite_health_checks_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +RegionCompositeHealthChecksClient::RegionCompositeHealthChecksClient( + std::shared_ptr connection, + Options opts) + : connection_(std::move(connection)), + options_( + internal::MergeOptions(std::move(opts), connection_->options())) {} +RegionCompositeHealthChecksClient::~RegionCompositeHealthChecksClient() = + default; + +StreamRange< + std::pair> +RegionCompositeHealthChecksClient::AggregatedListRegionCompositeHealthChecks( + std::string const& project, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_composite_health_checks::v1:: + AggregatedListRegionCompositeHealthChecksRequest request; + request.set_project(project); + return connection_->AggregatedListRegionCompositeHealthChecks(request); +} + +StreamRange< + std::pair> +RegionCompositeHealthChecksClient::AggregatedListRegionCompositeHealthChecks( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + AggregatedListRegionCompositeHealthChecksRequest request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->AggregatedListRegionCompositeHealthChecks( + std::move(request)); +} + +future> +RegionCompositeHealthChecksClient::DeleteCompositeHealthCheck( + std::string const& project, std::string const& region, + std::string const& composite_health_check, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_composite_health_checks::v1:: + DeleteCompositeHealthCheckRequest request; + request.set_project(project); + request.set_region(region); + request.set_composite_health_check(composite_health_check); + return connection_->DeleteCompositeHealthCheck(request); +} + +StatusOr +RegionCompositeHealthChecksClient::DeleteCompositeHealthCheck( + NoAwaitTag, std::string const& project, std::string const& region, + std::string const& composite_health_check, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_composite_health_checks::v1:: + DeleteCompositeHealthCheckRequest request; + request.set_project(project); + request.set_region(region); + request.set_composite_health_check(composite_health_check); + return connection_->DeleteCompositeHealthCheck(NoAwaitTag{}, request); +} + +future> +RegionCompositeHealthChecksClient::DeleteCompositeHealthCheck( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + DeleteCompositeHealthCheckRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->DeleteCompositeHealthCheck(request); +} + +StatusOr +RegionCompositeHealthChecksClient::DeleteCompositeHealthCheck( + NoAwaitTag, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + DeleteCompositeHealthCheckRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->DeleteCompositeHealthCheck(NoAwaitTag{}, request); +} + +future> +RegionCompositeHealthChecksClient::DeleteCompositeHealthCheck( + google::cloud::cpp::compute::v1::Operation const& operation, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->DeleteCompositeHealthCheck(operation); +} + +StatusOr +RegionCompositeHealthChecksClient::GetCompositeHealthCheck( + std::string const& project, std::string const& region, + std::string const& composite_health_check, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_composite_health_checks::v1:: + GetCompositeHealthCheckRequest request; + request.set_project(project); + request.set_region(region); + request.set_composite_health_check(composite_health_check); + return connection_->GetCompositeHealthCheck(request); +} + +StatusOr +RegionCompositeHealthChecksClient::GetCompositeHealthCheck( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + GetCompositeHealthCheckRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->GetCompositeHealthCheck(request); +} + +StatusOr +RegionCompositeHealthChecksClient::GetHealth( + std::string const& project, std::string const& region, + std::string const& composite_health_check, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_composite_health_checks::v1:: + GetHealthRequest request; + request.set_project(project); + request.set_region(region); + request.set_composite_health_check(composite_health_check); + return connection_->GetHealth(request); +} + +StatusOr +RegionCompositeHealthChecksClient::GetHealth( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + GetHealthRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->GetHealth(request); +} + +future> +RegionCompositeHealthChecksClient::InsertCompositeHealthCheck( + std::string const& project, std::string const& region, + google::cloud::cpp::compute::v1::CompositeHealthCheck const& + composite_health_check_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_composite_health_checks::v1:: + InsertCompositeHealthCheckRequest request; + request.set_project(project); + request.set_region(region); + *request.mutable_composite_health_check_resource() = + composite_health_check_resource; + return connection_->InsertCompositeHealthCheck(request); +} + +StatusOr +RegionCompositeHealthChecksClient::InsertCompositeHealthCheck( + NoAwaitTag, std::string const& project, std::string const& region, + google::cloud::cpp::compute::v1::CompositeHealthCheck const& + composite_health_check_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_composite_health_checks::v1:: + InsertCompositeHealthCheckRequest request; + request.set_project(project); + request.set_region(region); + *request.mutable_composite_health_check_resource() = + composite_health_check_resource; + return connection_->InsertCompositeHealthCheck(NoAwaitTag{}, request); +} + +future> +RegionCompositeHealthChecksClient::InsertCompositeHealthCheck( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + InsertCompositeHealthCheckRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->InsertCompositeHealthCheck(request); +} + +StatusOr +RegionCompositeHealthChecksClient::InsertCompositeHealthCheck( + NoAwaitTag, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + InsertCompositeHealthCheckRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->InsertCompositeHealthCheck(NoAwaitTag{}, request); +} + +future> +RegionCompositeHealthChecksClient::InsertCompositeHealthCheck( + google::cloud::cpp::compute::v1::Operation const& operation, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->InsertCompositeHealthCheck(operation); +} + +StreamRange +RegionCompositeHealthChecksClient::ListRegionCompositeHealthChecks( + std::string const& project, std::string const& region, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_composite_health_checks::v1:: + ListRegionCompositeHealthChecksRequest request; + request.set_project(project); + request.set_region(region); + return connection_->ListRegionCompositeHealthChecks(request); +} + +StreamRange +RegionCompositeHealthChecksClient::ListRegionCompositeHealthChecks( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + ListRegionCompositeHealthChecksRequest request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->ListRegionCompositeHealthChecks(std::move(request)); +} + +future> +RegionCompositeHealthChecksClient::PatchCompositeHealthCheck( + std::string const& project, std::string const& region, + std::string const& composite_health_check, + google::cloud::cpp::compute::v1::CompositeHealthCheck const& + composite_health_check_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_composite_health_checks::v1:: + PatchCompositeHealthCheckRequest request; + request.set_project(project); + request.set_region(region); + request.set_composite_health_check(composite_health_check); + *request.mutable_composite_health_check_resource() = + composite_health_check_resource; + return connection_->PatchCompositeHealthCheck(request); +} + +StatusOr +RegionCompositeHealthChecksClient::PatchCompositeHealthCheck( + NoAwaitTag, std::string const& project, std::string const& region, + std::string const& composite_health_check, + google::cloud::cpp::compute::v1::CompositeHealthCheck const& + composite_health_check_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_composite_health_checks::v1:: + PatchCompositeHealthCheckRequest request; + request.set_project(project); + request.set_region(region); + request.set_composite_health_check(composite_health_check); + *request.mutable_composite_health_check_resource() = + composite_health_check_resource; + return connection_->PatchCompositeHealthCheck(NoAwaitTag{}, request); +} + +future> +RegionCompositeHealthChecksClient::PatchCompositeHealthCheck( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + PatchCompositeHealthCheckRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->PatchCompositeHealthCheck(request); +} + +StatusOr +RegionCompositeHealthChecksClient::PatchCompositeHealthCheck( + NoAwaitTag, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + PatchCompositeHealthCheckRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->PatchCompositeHealthCheck(NoAwaitTag{}, request); +} + +future> +RegionCompositeHealthChecksClient::PatchCompositeHealthCheck( + google::cloud::cpp::compute::v1::Operation const& operation, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->PatchCompositeHealthCheck(operation); +} + +StatusOr +RegionCompositeHealthChecksClient::TestIamPermissions( + std::string const& project, std::string const& region, + std::string const& resource, + google::cloud::cpp::compute::v1::TestPermissionsRequest const& + test_permissions_request_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_composite_health_checks::v1:: + TestIamPermissionsRequest request; + request.set_project(project); + request.set_region(region); + request.set_resource(resource); + *request.mutable_test_permissions_request_resource() = + test_permissions_request_resource; + return connection_->TestIamPermissions(request); +} + +StatusOr +RegionCompositeHealthChecksClient::TestIamPermissions( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + TestIamPermissionsRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->TestIamPermissions(request); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_composite_health_checks_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks_client.h b/google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks_client.h new file mode 100644 index 0000000000000..e3c8034fc5d54 --- /dev/null +++ b/google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks_client.h @@ -0,0 +1,866 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_COMPOSITE_HEALTH_CHECKS_V1_REGION_COMPOSITE_HEALTH_CHECKS_CLIENT_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_COMPOSITE_HEALTH_CHECKS_V1_REGION_COMPOSITE_HEALTH_CHECKS_CLIENT_H + +#include "google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks_rest_connection.h" +#include "google/cloud/future.h" +#include "google/cloud/no_await_tag.h" +#include "google/cloud/options.h" +#include "google/cloud/polling_policy.h" +#include "google/cloud/status_or.h" +#include "google/cloud/version.h" +#include +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_composite_health_checks_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/// +/// Service for the regionCompositeHealthChecks resource. +/// https://cloud.google.com/compute/docs/reference/rest/v1/regionCompositeHealthChecks +/// +/// @par Equality +/// +/// Instances of this class created via copy-construction or copy-assignment +/// always compare equal. Instances created with equal +/// `std::shared_ptr<*Connection>` objects compare equal. Objects that compare +/// equal share the same underlying resources. +/// +/// @par Performance +/// +/// Creating a new instance of this class is a relatively expensive operation, +/// new objects establish new connections to the service. In contrast, +/// copy-construction, move-construction, and the corresponding assignment +/// operations are relatively efficient as the copies share all underlying +/// resources. +/// +/// @par Thread Safety +/// +/// Concurrent access to different instances of this class, even if they compare +/// equal, is guaranteed to work. Two or more threads operating on the same +/// instance of this class is not guaranteed to work. Since copy-construction +/// and move-construction is a relatively efficient operation, consider using +/// such a copy when using this class from multiple threads. +/// +class RegionCompositeHealthChecksClient { + public: + explicit RegionCompositeHealthChecksClient( + std::shared_ptr connection, + Options opts = {}); + ~RegionCompositeHealthChecksClient(); + + ///@{ + /// @name Copy and move support + RegionCompositeHealthChecksClient(RegionCompositeHealthChecksClient const&) = + default; + RegionCompositeHealthChecksClient& operator=( + RegionCompositeHealthChecksClient const&) = default; + RegionCompositeHealthChecksClient(RegionCompositeHealthChecksClient&&) = + default; + RegionCompositeHealthChecksClient& operator=( + RegionCompositeHealthChecksClient&&) = default; + ///@} + + ///@{ + /// @name Equality + friend bool operator==(RegionCompositeHealthChecksClient const& a, + RegionCompositeHealthChecksClient const& b) { + return a.connection_ == b.connection_; + } + friend bool operator!=(RegionCompositeHealthChecksClient const& a, + RegionCompositeHealthChecksClient const& b) { + return !(a == b); + } + ///@} + + // clang-format off + /// + /// Retrieves the list of all CompositeHealthCheck resources (all + /// regional) available to the specified project. + /// + /// To prevent failure, it is recommended that you set the + /// `returnPartialSuccess` parameter to `true`. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionCompositeHealthChecks/aggregatedList + /// + /// @param project Name of the project scoping this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return a [StreamRange](@ref google::cloud::StreamRange) + /// to iterate of the results. See the documentation of this type for + /// details. In brief, this class has `begin()` and `end()` member + /// functions returning a iterator class meeting the + /// [input iterator requirements]. The value type for this iterator is a + /// [`StatusOr`] as the iteration may fail even after some values are + /// retrieved successfully, for example, if there is a network disconnect. + /// An empty set of results does not indicate an error, it indicates + /// that there are no resources meeting the request criteria. + /// On a successful iteration the `StatusOr` contains elements of type + /// [google.cloud.cpp.compute.v1.CompositeHealthChecksScopedList], or rather, + /// the C++ class generated by Protobuf from that type. Please consult the + /// Protobuf documentation for details on the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_composite_health_checks.v1.AggregatedListRegionCompositeHealthChecksRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks.proto#L145} + /// [google.cloud.cpp.compute.v1.CompositeHealthChecksScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_026.proto#L384} + /// + // clang-format on + StreamRange> + AggregatedListRegionCompositeHealthChecks(std::string const& project, + Options opts = {}); + + // clang-format off + /// + /// Retrieves the list of all CompositeHealthCheck resources (all + /// regional) available to the specified project. + /// + /// To prevent failure, it is recommended that you set the + /// `returnPartialSuccess` parameter to `true`. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionCompositeHealthChecks/aggregatedList + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.region_composite_health_checks.v1.AggregatedListRegionCompositeHealthChecksRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return a [StreamRange](@ref google::cloud::StreamRange) + /// to iterate of the results. See the documentation of this type for + /// details. In brief, this class has `begin()` and `end()` member + /// functions returning a iterator class meeting the + /// [input iterator requirements]. The value type for this iterator is a + /// [`StatusOr`] as the iteration may fail even after some values are + /// retrieved successfully, for example, if there is a network disconnect. + /// An empty set of results does not indicate an error, it indicates + /// that there are no resources meeting the request criteria. + /// On a successful iteration the `StatusOr` contains elements of type + /// [google.cloud.cpp.compute.v1.CompositeHealthChecksScopedList], or rather, + /// the C++ class generated by Protobuf from that type. Please consult the + /// Protobuf documentation for details on the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_composite_health_checks.v1.AggregatedListRegionCompositeHealthChecksRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks.proto#L145} + /// [google.cloud.cpp.compute.v1.CompositeHealthChecksScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_026.proto#L384} + /// + // clang-format on + StreamRange> + AggregatedListRegionCompositeHealthChecks( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + AggregatedListRegionCompositeHealthChecksRequest request, + Options opts = {}); + + // clang-format off + /// + /// Deletes the specified CompositeHealthCheck in the given region + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionCompositeHealthChecks/delete + /// + /// @param project Project ID for this request. + /// @param region Name of the region scoping this request. + /// @param composite_health_check Name of the CompositeHealthCheck resource to delete. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_composite_health_checks.v1.DeleteCompositeHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks.proto#L260} + /// + // clang-format on + future> + DeleteCompositeHealthCheck(std::string const& project, + std::string const& region, + std::string const& composite_health_check, + Options opts = {}); + + // clang-format off + /// + /// @copybrief DeleteCompositeHealthCheck + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr + DeleteCompositeHealthCheck(NoAwaitTag, std::string const& project, + std::string const& region, + std::string const& composite_health_check, + Options opts = {}); + + // clang-format off + /// + /// Deletes the specified CompositeHealthCheck in the given region + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionCompositeHealthChecks/delete + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.region_composite_health_checks.v1.DeleteCompositeHealthCheckRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_composite_health_checks.v1.DeleteCompositeHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks.proto#L260} + /// + // clang-format on + future> + DeleteCompositeHealthCheck( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + DeleteCompositeHealthCheckRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief DeleteCompositeHealthCheck + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr + DeleteCompositeHealthCheck( + NoAwaitTag, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + DeleteCompositeHealthCheckRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief DeleteCompositeHealthCheck + /// + /// This method accepts a `google::cloud::cpp::compute::v1::Operation` that corresponds + /// to a previously started Long Running Operation (LRO) and polls the status + /// of the LRO in the background. + /// + // clang-format on + future> + DeleteCompositeHealthCheck( + google::cloud::cpp::compute::v1::Operation const& operation, + Options opts = {}); + + // clang-format off + /// + /// Returns the specified CompositeHealthCheck resource in the given region. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionCompositeHealthChecks/get + /// + /// @param project Project ID for this request. + /// @param region Name of the region scoping this request. + /// @param composite_health_check Name of the CompositeHealthCheck resource to return. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.CompositeHealthCheck]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_composite_health_checks.v1.GetCompositeHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks.proto#L298} + /// [google.cloud.cpp.compute.v1.CompositeHealthCheck]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_026.proto#L29} + /// + // clang-format on + StatusOr + GetCompositeHealthCheck(std::string const& project, std::string const& region, + std::string const& composite_health_check, + Options opts = {}); + + // clang-format off + /// + /// Returns the specified CompositeHealthCheck resource in the given region. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionCompositeHealthChecks/get + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.region_composite_health_checks.v1.GetCompositeHealthCheckRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.CompositeHealthCheck]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_composite_health_checks.v1.GetCompositeHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks.proto#L298} + /// [google.cloud.cpp.compute.v1.CompositeHealthCheck]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_026.proto#L29} + /// + // clang-format on + StatusOr + GetCompositeHealthCheck( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + GetCompositeHealthCheckRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// Gets the most recent health check results for this + /// regional CompositeHealthCheck. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionCompositeHealthChecks/getHealth + /// + /// @param project Name of the project scoping this request. + /// @param region Name of the region scoping this request. + /// @param composite_health_check Name of the CompositeHealthCheck resource to get health for. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.CompositeHealthCheckHealth]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_composite_health_checks.v1.GetHealthRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks.proto#L315} + /// [google.cloud.cpp.compute.v1.CompositeHealthCheckHealth]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_026.proto#L227} + /// + // clang-format on + StatusOr + GetHealth(std::string const& project, std::string const& region, + std::string const& composite_health_check, Options opts = {}); + + // clang-format off + /// + /// Gets the most recent health check results for this + /// regional CompositeHealthCheck. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionCompositeHealthChecks/getHealth + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.region_composite_health_checks.v1.GetHealthRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.CompositeHealthCheckHealth]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_composite_health_checks.v1.GetHealthRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks.proto#L315} + /// [google.cloud.cpp.compute.v1.CompositeHealthCheckHealth]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_026.proto#L227} + /// + // clang-format on + StatusOr + GetHealth(google::cloud::cpp::compute::region_composite_health_checks::v1:: + GetHealthRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// Create a CompositeHealthCheck in the specified project in the given region + /// using the parameters that are included in the request. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionCompositeHealthChecks/insert + /// + /// @param project Project ID for this request. + /// @param region Name of the region scoping this request. + /// @param composite_health_check_resource The CompositeHealthCheck for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_composite_health_checks.v1.InsertCompositeHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks.proto#L332} + /// + // clang-format on + future> + InsertCompositeHealthCheck( + std::string const& project, std::string const& region, + google::cloud::cpp::compute::v1::CompositeHealthCheck const& + composite_health_check_resource, + Options opts = {}); + + // clang-format off + /// + /// @copybrief InsertCompositeHealthCheck + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr + InsertCompositeHealthCheck( + NoAwaitTag, std::string const& project, std::string const& region, + google::cloud::cpp::compute::v1::CompositeHealthCheck const& + composite_health_check_resource, + Options opts = {}); + + // clang-format off + /// + /// Create a CompositeHealthCheck in the specified project in the given region + /// using the parameters that are included in the request. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionCompositeHealthChecks/insert + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.region_composite_health_checks.v1.InsertCompositeHealthCheckRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_composite_health_checks.v1.InsertCompositeHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks.proto#L332} + /// + // clang-format on + future> + InsertCompositeHealthCheck( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + InsertCompositeHealthCheckRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief InsertCompositeHealthCheck + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr + InsertCompositeHealthCheck( + NoAwaitTag, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + InsertCompositeHealthCheckRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief InsertCompositeHealthCheck + /// + /// This method accepts a `google::cloud::cpp::compute::v1::Operation` that corresponds + /// to a previously started Long Running Operation (LRO) and polls the status + /// of the LRO in the background. + /// + // clang-format on + future> + InsertCompositeHealthCheck( + google::cloud::cpp::compute::v1::Operation const& operation, + Options opts = {}); + + // clang-format off + /// + /// Lists the CompositeHealthChecks for a project in the given region. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionCompositeHealthChecks/list + /// + /// @param project Project ID for this request. + /// @param region Name of the region scoping this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return a [StreamRange](@ref google::cloud::StreamRange) + /// to iterate of the results. See the documentation of this type for + /// details. In brief, this class has `begin()` and `end()` member + /// functions returning a iterator class meeting the + /// [input iterator requirements]. The value type for this iterator is a + /// [`StatusOr`] as the iteration may fail even after some values are + /// retrieved successfully, for example, if there is a network disconnect. + /// An empty set of results does not indicate an error, it indicates + /// that there are no resources meeting the request criteria. + /// On a successful iteration the `StatusOr` contains elements of type + /// [google.cloud.cpp.compute.v1.CompositeHealthCheck], or rather, + /// the C++ class generated by Protobuf from that type. Please consult the + /// Protobuf documentation for details on the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_composite_health_checks.v1.ListRegionCompositeHealthChecksRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks.proto#L368} + /// [google.cloud.cpp.compute.v1.CompositeHealthCheck]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_026.proto#L29} + /// + // clang-format on + StreamRange + ListRegionCompositeHealthChecks(std::string const& project, + std::string const& region, Options opts = {}); + + // clang-format off + /// + /// Lists the CompositeHealthChecks for a project in the given region. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionCompositeHealthChecks/list + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.region_composite_health_checks.v1.ListRegionCompositeHealthChecksRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return a [StreamRange](@ref google::cloud::StreamRange) + /// to iterate of the results. See the documentation of this type for + /// details. In brief, this class has `begin()` and `end()` member + /// functions returning a iterator class meeting the + /// [input iterator requirements]. The value type for this iterator is a + /// [`StatusOr`] as the iteration may fail even after some values are + /// retrieved successfully, for example, if there is a network disconnect. + /// An empty set of results does not indicate an error, it indicates + /// that there are no resources meeting the request criteria. + /// On a successful iteration the `StatusOr` contains elements of type + /// [google.cloud.cpp.compute.v1.CompositeHealthCheck], or rather, + /// the C++ class generated by Protobuf from that type. Please consult the + /// Protobuf documentation for details on the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_composite_health_checks.v1.ListRegionCompositeHealthChecksRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks.proto#L368} + /// [google.cloud.cpp.compute.v1.CompositeHealthCheck]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_026.proto#L29} + /// + // clang-format on + StreamRange + ListRegionCompositeHealthChecks( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + ListRegionCompositeHealthChecksRequest request, + Options opts = {}); + + // clang-format off + /// + /// Updates the specified regional CompositeHealthCheck resource + /// with the data included in the request. This method supportsPATCH + /// semantics and uses theJSON merge + /// patch format and processing rules. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionCompositeHealthChecks/patch + /// + /// @param project Project ID for this request. + /// @param region Name of the region scoping this request. + /// @param composite_health_check Name of the CompositeHealthCheck to update. The name + /// must be 1-63 characters long, and comply with RFC1035. + /// @param composite_health_check_resource The CompositeHealthCheck for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_composite_health_checks.v1.PatchCompositeHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks.proto#L473} + /// + // clang-format on + future> + PatchCompositeHealthCheck( + std::string const& project, std::string const& region, + std::string const& composite_health_check, + google::cloud::cpp::compute::v1::CompositeHealthCheck const& + composite_health_check_resource, + Options opts = {}); + + // clang-format off + /// + /// @copybrief PatchCompositeHealthCheck + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr + PatchCompositeHealthCheck( + NoAwaitTag, std::string const& project, std::string const& region, + std::string const& composite_health_check, + google::cloud::cpp::compute::v1::CompositeHealthCheck const& + composite_health_check_resource, + Options opts = {}); + + // clang-format off + /// + /// Updates the specified regional CompositeHealthCheck resource + /// with the data included in the request. This method supportsPATCH + /// semantics and uses theJSON merge + /// patch format and processing rules. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionCompositeHealthChecks/patch + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.region_composite_health_checks.v1.PatchCompositeHealthCheckRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_composite_health_checks.v1.PatchCompositeHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks.proto#L473} + /// + // clang-format on + future> + PatchCompositeHealthCheck( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + PatchCompositeHealthCheckRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief PatchCompositeHealthCheck + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr + PatchCompositeHealthCheck( + NoAwaitTag, + google::cloud::cpp::compute::region_composite_health_checks::v1:: + PatchCompositeHealthCheckRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief PatchCompositeHealthCheck + /// + /// This method accepts a `google::cloud::cpp::compute::v1::Operation` that corresponds + /// to a previously started Long Running Operation (LRO) and polls the status + /// of the LRO in the background. + /// + // clang-format on + future> + PatchCompositeHealthCheck( + google::cloud::cpp::compute::v1::Operation const& operation, + Options opts = {}); + + // clang-format off + /// + /// Returns permissions that a caller has on the specified resource. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionCompositeHealthChecks/testIamPermissions + /// + /// @param project Project ID for this request. + /// @param region The name of the region for this request. + /// @param resource Name or id of the resource for this request. + /// @param test_permissions_request_resource The TestPermissionsRequest for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.TestPermissionsResponse]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_composite_health_checks.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks.proto#L516} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} + /// + // clang-format on + StatusOr + TestIamPermissions( + std::string const& project, std::string const& region, + std::string const& resource, + google::cloud::cpp::compute::v1::TestPermissionsRequest const& + test_permissions_request_resource, + Options opts = {}); + + // clang-format off + /// + /// Returns permissions that a caller has on the specified resource. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionCompositeHealthChecks/testIamPermissions + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.region_composite_health_checks.v1.TestIamPermissionsRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.TestPermissionsResponse]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_composite_health_checks.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks.proto#L516} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} + /// + // clang-format on + StatusOr + TestIamPermissions( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + TestIamPermissionsRequest const& request, + Options opts = {}); + + private: + std::shared_ptr connection_; + Options options_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_composite_health_checks_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_COMPOSITE_HEALTH_CHECKS_V1_REGION_COMPOSITE_HEALTH_CHECKS_CLIENT_H diff --git a/google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks_connection.cc b/google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks_connection.cc new file mode 100644 index 0000000000000..612f317333029 --- /dev/null +++ b/google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks_connection.cc @@ -0,0 +1,159 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks.proto + +#include "google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks_connection.h" +#include "google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_option_defaults.h" +#include "google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_tracing_connection.h" +#include "google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks_options.h" +#include "google/cloud/background_threads.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/grpc_options.h" +#include "google/cloud/internal/pagination_range.h" +#include "google/cloud/internal/unified_grpc_credentials.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_composite_health_checks_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +RegionCompositeHealthChecksConnection:: + ~RegionCompositeHealthChecksConnection() = default; + +StreamRange< + std::pair> +RegionCompositeHealthChecksConnection::AggregatedListRegionCompositeHealthChecks( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + AggregatedListRegionCompositeHealthChecksRequest) { // NOLINT(performance-unnecessary-value-param) + return google::cloud::internal::MakeUnimplementedPaginationRange>>(); +} + +future> +RegionCompositeHealthChecksConnection::DeleteCompositeHealthCheck( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + DeleteCompositeHealthCheckRequest const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +RegionCompositeHealthChecksConnection::DeleteCompositeHealthCheck( + NoAwaitTag, google::cloud::cpp::compute::region_composite_health_checks:: + v1::DeleteCompositeHealthCheckRequest const&) { + return StatusOr( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +RegionCompositeHealthChecksConnection::DeleteCompositeHealthCheck( + google::cloud::cpp::compute::v1::Operation const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +RegionCompositeHealthChecksConnection::GetCompositeHealthCheck( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + GetCompositeHealthCheckRequest const&) { + return Status(StatusCode::kUnimplemented, "not implemented"); +} + +StatusOr +RegionCompositeHealthChecksConnection::GetHealth( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + GetHealthRequest const&) { + return Status(StatusCode::kUnimplemented, "not implemented"); +} + +future> +RegionCompositeHealthChecksConnection::InsertCompositeHealthCheck( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + InsertCompositeHealthCheckRequest const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +RegionCompositeHealthChecksConnection::InsertCompositeHealthCheck( + NoAwaitTag, google::cloud::cpp::compute::region_composite_health_checks:: + v1::InsertCompositeHealthCheckRequest const&) { + return StatusOr( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +RegionCompositeHealthChecksConnection::InsertCompositeHealthCheck( + google::cloud::cpp::compute::v1::Operation const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StreamRange +RegionCompositeHealthChecksConnection::ListRegionCompositeHealthChecks( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + ListRegionCompositeHealthChecksRequest) { // NOLINT(performance-unnecessary-value-param) + return google::cloud::internal::MakeUnimplementedPaginationRange< + StreamRange>(); +} + +future> +RegionCompositeHealthChecksConnection::PatchCompositeHealthCheck( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + PatchCompositeHealthCheckRequest const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +RegionCompositeHealthChecksConnection::PatchCompositeHealthCheck( + NoAwaitTag, google::cloud::cpp::compute::region_composite_health_checks:: + v1::PatchCompositeHealthCheckRequest const&) { + return StatusOr( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +RegionCompositeHealthChecksConnection::PatchCompositeHealthCheck( + google::cloud::cpp::compute::v1::Operation const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +RegionCompositeHealthChecksConnection::TestIamPermissions( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + TestIamPermissionsRequest const&) { + return Status(StatusCode::kUnimplemented, "not implemented"); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_composite_health_checks_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks_connection.h b/google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks_connection.h new file mode 100644 index 0000000000000..af41e3363f3e8 --- /dev/null +++ b/google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks_connection.h @@ -0,0 +1,282 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_COMPOSITE_HEALTH_CHECKS_V1_REGION_COMPOSITE_HEALTH_CHECKS_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_COMPOSITE_HEALTH_CHECKS_V1_REGION_COMPOSITE_HEALTH_CHECKS_CONNECTION_H + +#include "google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_retry_traits.h" +#include "google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks.pb.h" +#include "google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks_connection_idempotency_policy.h" +#include "google/cloud/backoff_policy.h" +#include "google/cloud/future.h" +#include "google/cloud/internal/retry_policy_impl.h" +#include "google/cloud/no_await_tag.h" +#include "google/cloud/options.h" +#include "google/cloud/polling_policy.h" +#include "google/cloud/status_or.h" +#include "google/cloud/stream_range.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_composite_health_checks_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/// The retry policy for `RegionCompositeHealthChecksConnection`. +class RegionCompositeHealthChecksRetryPolicy + : public ::google::cloud::RetryPolicy { + public: + /// Creates a new instance of the policy, reset to the initial state. + virtual std::unique_ptr clone() + const = 0; +}; + +/** + * A retry policy for `RegionCompositeHealthChecksConnection` based on counting + * errors. + * + * This policy stops retrying if: + * - An RPC returns a non-transient error. + * - More than a prescribed number of transient failures is detected. + * + * In this class the following status codes are treated as transient errors: + * - [`kUnavailable`](@ref google::cloud::StatusCode) + */ +class RegionCompositeHealthChecksLimitedErrorCountRetryPolicy + : public RegionCompositeHealthChecksRetryPolicy { + public: + /** + * Create an instance that tolerates up to @p maximum_failures transient + * errors. + * + * @note Disable the retry loop by providing an instance of this policy with + * @p maximum_failures == 0. + */ + explicit RegionCompositeHealthChecksLimitedErrorCountRetryPolicy( + int maximum_failures) + : impl_(maximum_failures) {} + + RegionCompositeHealthChecksLimitedErrorCountRetryPolicy( + RegionCompositeHealthChecksLimitedErrorCountRetryPolicy&& rhs) noexcept + : RegionCompositeHealthChecksLimitedErrorCountRetryPolicy( + rhs.maximum_failures()) {} + RegionCompositeHealthChecksLimitedErrorCountRetryPolicy( + RegionCompositeHealthChecksLimitedErrorCountRetryPolicy const& + rhs) noexcept + : RegionCompositeHealthChecksLimitedErrorCountRetryPolicy( + rhs.maximum_failures()) {} + + int maximum_failures() const { return impl_.maximum_failures(); } + + bool OnFailure(Status const& status) override { + return impl_.OnFailure(status); + } + bool IsExhausted() const override { return impl_.IsExhausted(); } + bool IsPermanentFailure(Status const& status) const override { + return impl_.IsPermanentFailure(status); + } + std::unique_ptr clone() + const override { + return std::make_unique< + RegionCompositeHealthChecksLimitedErrorCountRetryPolicy>( + maximum_failures()); + } + + // This is provided only for backwards compatibility. + using BaseType = RegionCompositeHealthChecksRetryPolicy; + + private: + google::cloud::internal::LimitedErrorCountRetryPolicy< + compute_region_composite_health_checks_v1_internal:: + RegionCompositeHealthChecksRetryTraits> + impl_; +}; + +/** + * A retry policy for `RegionCompositeHealthChecksConnection` based on elapsed + * time. + * + * This policy stops retrying if: + * - An RPC returns a non-transient error. + * - The elapsed time in the retry loop exceeds a prescribed duration. + * + * In this class the following status codes are treated as transient errors: + * - [`kUnavailable`](@ref google::cloud::StatusCode) + */ +class RegionCompositeHealthChecksLimitedTimeRetryPolicy + : public RegionCompositeHealthChecksRetryPolicy { + public: + /** + * Constructor given a `std::chrono::duration<>` object. + * + * @tparam DurationRep a placeholder to match the `Rep` tparam for @p + * duration's type. The semantics of this template parameter are + * documented in `std::chrono::duration<>`. In brief, the underlying + * arithmetic type used to store the number of ticks. For our purposes it + * is simply a formal parameter. + * @tparam DurationPeriod a placeholder to match the `Period` tparam for @p + * duration's type. The semantics of this template parameter are + * documented in `std::chrono::duration<>`. In brief, the length of the + * tick in seconds, expressed as a `std::ratio<>`. For our purposes it is + * simply a formal parameter. + * @param maximum_duration the maximum time allowed before the policy expires. + * While the application can express this time in any units they desire, + * the class truncates to milliseconds. + * + * @see https://en.cppreference.com/w/cpp/chrono/duration for more information + * about `std::chrono::duration`. + */ + template + explicit RegionCompositeHealthChecksLimitedTimeRetryPolicy( + std::chrono::duration maximum_duration) + : impl_(maximum_duration) {} + + RegionCompositeHealthChecksLimitedTimeRetryPolicy( + RegionCompositeHealthChecksLimitedTimeRetryPolicy&& rhs) noexcept + : RegionCompositeHealthChecksLimitedTimeRetryPolicy( + rhs.maximum_duration()) {} + RegionCompositeHealthChecksLimitedTimeRetryPolicy( + RegionCompositeHealthChecksLimitedTimeRetryPolicy const& rhs) noexcept + : RegionCompositeHealthChecksLimitedTimeRetryPolicy( + rhs.maximum_duration()) {} + + std::chrono::milliseconds maximum_duration() const { + return impl_.maximum_duration(); + } + + bool OnFailure(Status const& status) override { + return impl_.OnFailure(status); + } + bool IsExhausted() const override { return impl_.IsExhausted(); } + bool IsPermanentFailure(Status const& status) const override { + return impl_.IsPermanentFailure(status); + } + std::unique_ptr clone() + const override { + return std::make_unique( + maximum_duration()); + } + + // This is provided only for backwards compatibility. + using BaseType = RegionCompositeHealthChecksRetryPolicy; + + private: + google::cloud::internal::LimitedTimeRetryPolicy< + compute_region_composite_health_checks_v1_internal:: + RegionCompositeHealthChecksRetryTraits> + impl_; +}; + +/** + * The `RegionCompositeHealthChecksConnection` object for + * `RegionCompositeHealthChecksClient`. + * + * This interface defines virtual methods for each of the user-facing overload + * sets in `RegionCompositeHealthChecksClient`. This allows users to inject + * custom behavior (e.g., with a Google Mock object) when writing tests that use + * objects of type `RegionCompositeHealthChecksClient`. + * + * To create a concrete instance, see + * `MakeRegionCompositeHealthChecksConnection()`. + * + * For mocking, see + * `compute_region_composite_health_checks_v1_mocks::MockRegionCompositeHealthChecksConnection`. + */ +class RegionCompositeHealthChecksConnection { + public: + virtual ~RegionCompositeHealthChecksConnection() = 0; + + virtual Options options() { return Options{}; } + + virtual StreamRange> + AggregatedListRegionCompositeHealthChecks( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + AggregatedListRegionCompositeHealthChecksRequest request); + + virtual future> + DeleteCompositeHealthCheck( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + DeleteCompositeHealthCheckRequest const& request); + + virtual StatusOr + DeleteCompositeHealthCheck( + NoAwaitTag, google::cloud::cpp::compute::region_composite_health_checks:: + v1::DeleteCompositeHealthCheckRequest const& request); + + virtual future> + DeleteCompositeHealthCheck( + google::cloud::cpp::compute::v1::Operation const& operation); + + virtual StatusOr + GetCompositeHealthCheck( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + GetCompositeHealthCheckRequest const& request); + + virtual StatusOr + GetHealth(google::cloud::cpp::compute::region_composite_health_checks::v1:: + GetHealthRequest const& request); + + virtual future> + InsertCompositeHealthCheck( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + InsertCompositeHealthCheckRequest const& request); + + virtual StatusOr + InsertCompositeHealthCheck( + NoAwaitTag, google::cloud::cpp::compute::region_composite_health_checks:: + v1::InsertCompositeHealthCheckRequest const& request); + + virtual future> + InsertCompositeHealthCheck( + google::cloud::cpp::compute::v1::Operation const& operation); + + virtual StreamRange + ListRegionCompositeHealthChecks( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + ListRegionCompositeHealthChecksRequest request); + + virtual future> + PatchCompositeHealthCheck( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + PatchCompositeHealthCheckRequest const& request); + + virtual StatusOr + PatchCompositeHealthCheck( + NoAwaitTag, google::cloud::cpp::compute::region_composite_health_checks:: + v1::PatchCompositeHealthCheckRequest const& request); + + virtual future> + PatchCompositeHealthCheck( + google::cloud::cpp::compute::v1::Operation const& operation); + + virtual StatusOr + TestIamPermissions( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + TestIamPermissionsRequest const& request); +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_composite_health_checks_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_COMPOSITE_HEALTH_CHECKS_V1_REGION_COMPOSITE_HEALTH_CHECKS_CONNECTION_H diff --git a/google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks_connection_idempotency_policy.cc b/google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks_connection_idempotency_policy.cc new file mode 100644 index 0000000000000..6d8eb11c9d660 --- /dev/null +++ b/google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks_connection_idempotency_policy.cc @@ -0,0 +1,103 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks.proto + +#include "google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks_connection_idempotency_policy.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_composite_health_checks_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +using ::google::cloud::Idempotency; + +RegionCompositeHealthChecksConnectionIdempotencyPolicy:: + ~RegionCompositeHealthChecksConnectionIdempotencyPolicy() = default; + +std::unique_ptr +RegionCompositeHealthChecksConnectionIdempotencyPolicy::clone() const { + return std::make_unique< + RegionCompositeHealthChecksConnectionIdempotencyPolicy>(*this); +} + +Idempotency RegionCompositeHealthChecksConnectionIdempotencyPolicy:: + AggregatedListRegionCompositeHealthChecks( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + AggregatedListRegionCompositeHealthChecksRequest) { // NOLINT + return Idempotency::kIdempotent; +} + +Idempotency RegionCompositeHealthChecksConnectionIdempotencyPolicy:: + DeleteCompositeHealthCheck( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + DeleteCompositeHealthCheckRequest const&) { + return Idempotency::kNonIdempotent; +} + +Idempotency +RegionCompositeHealthChecksConnectionIdempotencyPolicy::GetCompositeHealthCheck( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + GetCompositeHealthCheckRequest const&) { + return Idempotency::kIdempotent; +} + +Idempotency RegionCompositeHealthChecksConnectionIdempotencyPolicy::GetHealth( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + GetHealthRequest const&) { + return Idempotency::kIdempotent; +} + +Idempotency RegionCompositeHealthChecksConnectionIdempotencyPolicy:: + InsertCompositeHealthCheck( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + InsertCompositeHealthCheckRequest const&) { + return Idempotency::kNonIdempotent; +} + +Idempotency RegionCompositeHealthChecksConnectionIdempotencyPolicy:: + ListRegionCompositeHealthChecks( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + ListRegionCompositeHealthChecksRequest) { // NOLINT + return Idempotency::kIdempotent; +} + +Idempotency RegionCompositeHealthChecksConnectionIdempotencyPolicy:: + PatchCompositeHealthCheck( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + PatchCompositeHealthCheckRequest const&) { + return Idempotency::kNonIdempotent; +} + +Idempotency +RegionCompositeHealthChecksConnectionIdempotencyPolicy::TestIamPermissions( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + TestIamPermissionsRequest const&) { + return Idempotency::kNonIdempotent; +} + +std::unique_ptr +MakeDefaultRegionCompositeHealthChecksConnectionIdempotencyPolicy() { + return std::make_unique< + RegionCompositeHealthChecksConnectionIdempotencyPolicy>(); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_composite_health_checks_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks_connection_idempotency_policy.h b/google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks_connection_idempotency_policy.h new file mode 100644 index 0000000000000..670b5bc1eb79f --- /dev/null +++ b/google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks_connection_idempotency_policy.h @@ -0,0 +1,83 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_COMPOSITE_HEALTH_CHECKS_V1_REGION_COMPOSITE_HEALTH_CHECKS_CONNECTION_IDEMPOTENCY_POLICY_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_COMPOSITE_HEALTH_CHECKS_V1_REGION_COMPOSITE_HEALTH_CHECKS_CONNECTION_IDEMPOTENCY_POLICY_H + +#include "google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks.pb.h" +#include "google/cloud/idempotency.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_composite_health_checks_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class RegionCompositeHealthChecksConnectionIdempotencyPolicy { + public: + virtual ~RegionCompositeHealthChecksConnectionIdempotencyPolicy(); + + /// Create a new copy of this object. + virtual std::unique_ptr< + RegionCompositeHealthChecksConnectionIdempotencyPolicy> + clone() const; + + virtual google::cloud::Idempotency AggregatedListRegionCompositeHealthChecks( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + AggregatedListRegionCompositeHealthChecksRequest request); + + virtual google::cloud::Idempotency DeleteCompositeHealthCheck( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + DeleteCompositeHealthCheckRequest const& request); + + virtual google::cloud::Idempotency GetCompositeHealthCheck( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + GetCompositeHealthCheckRequest const& request); + + virtual google::cloud::Idempotency GetHealth( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + GetHealthRequest const& request); + + virtual google::cloud::Idempotency InsertCompositeHealthCheck( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + InsertCompositeHealthCheckRequest const& request); + + virtual google::cloud::Idempotency ListRegionCompositeHealthChecks( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + ListRegionCompositeHealthChecksRequest request); + + virtual google::cloud::Idempotency PatchCompositeHealthCheck( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + PatchCompositeHealthCheckRequest const& request); + + virtual google::cloud::Idempotency TestIamPermissions( + google::cloud::cpp::compute::region_composite_health_checks::v1:: + TestIamPermissionsRequest const& request); +}; + +std::unique_ptr +MakeDefaultRegionCompositeHealthChecksConnectionIdempotencyPolicy(); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_composite_health_checks_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_COMPOSITE_HEALTH_CHECKS_V1_REGION_COMPOSITE_HEALTH_CHECKS_CONNECTION_IDEMPOTENCY_POLICY_H diff --git a/google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks_options.h b/google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks_options.h new file mode 100644 index 0000000000000..3787d6fb0ec29 --- /dev/null +++ b/google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks_options.h @@ -0,0 +1,89 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_COMPOSITE_HEALTH_CHECKS_V1_REGION_COMPOSITE_HEALTH_CHECKS_OPTIONS_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_COMPOSITE_HEALTH_CHECKS_V1_REGION_COMPOSITE_HEALTH_CHECKS_OPTIONS_H + +#include "google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks_connection.h" +#include "google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks_connection_idempotency_policy.h" +#include "google/cloud/backoff_policy.h" +#include "google/cloud/options.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_composite_health_checks_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/** + * Use with `google::cloud::Options` to configure the retry policy. + * + * @ingroup google-cloud-compute-options + */ +struct RegionCompositeHealthChecksRetryPolicyOption { + using Type = std::shared_ptr; +}; + +/** + * Use with `google::cloud::Options` to configure the backoff policy. + * + * @ingroup google-cloud-compute-options + */ +struct RegionCompositeHealthChecksBackoffPolicyOption { + using Type = std::shared_ptr; +}; + +/** + * Use with `google::cloud::Options` to configure which operations are retried. + * + * @ingroup google-cloud-compute-options + */ +struct RegionCompositeHealthChecksConnectionIdempotencyPolicyOption { + using Type = + std::shared_ptr; +}; + +/** + * Use with `google::cloud::Options` to configure the long-running operations + * polling policy. + * + * @ingroup google-cloud-compute-options + */ +struct RegionCompositeHealthChecksPollingPolicyOption { + using Type = std::shared_ptr; +}; + +/** + * The options applicable to RegionCompositeHealthChecks. + * + * @ingroup google-cloud-compute-options + */ +using RegionCompositeHealthChecksPolicyOptionList = + OptionList; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_composite_health_checks_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_COMPOSITE_HEALTH_CHECKS_V1_REGION_COMPOSITE_HEALTH_CHECKS_OPTIONS_H diff --git a/google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks_proto_export.h b/google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks_proto_export.h new file mode 100644 index 0000000000000..ef3c3a27c60dc --- /dev/null +++ b/google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks_proto_export.h @@ -0,0 +1,34 @@ +// Copyright 2026 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_REGION_COMPOSITE_HEALTH_CHECKS_V1_REGION_COMPOSITE_HEALTH_CHECKS_PROTO_EXPORT_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_COMPOSITE_HEALTH_CHECKS_V1_REGION_COMPOSITE_HEALTH_CHECKS_PROTO_EXPORT_H + +// IWYU pragma: begin_exports +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_026.pb.h" +#include "google/cloud/compute/v1/internal/common_171.pb.h" +// IWYU pragma: end_exports + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_COMPOSITE_HEALTH_CHECKS_V1_REGION_COMPOSITE_HEALTH_CHECKS_PROTO_EXPORT_H diff --git a/google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks_rest_connection.cc b/google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks_rest_connection.cc new file mode 100644 index 0000000000000..402b89b6eec9b --- /dev/null +++ b/google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks_rest_connection.cc @@ -0,0 +1,61 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks.proto + +#include "google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks_rest_connection.h" +#include "google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_option_defaults.h" +#include "google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_rest_connection_impl.h" +#include "google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_rest_stub_factory.h" +#include "google/cloud/compute/region_composite_health_checks/v1/internal/region_composite_health_checks_tracing_connection.h" +#include "google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks_options.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/internal/rest_background_threads_impl.h" +#include "google/cloud/internal/rest_options.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_composite_health_checks_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +std::shared_ptr +MakeRegionCompositeHealthChecksConnectionRest(Options options) { + internal::CheckExpectedOptions( + options, __func__); + options = compute_region_composite_health_checks_v1_internal:: + RegionCompositeHealthChecksDefaultOptions(std::move(options)); + auto background = std::make_unique< + rest_internal::AutomaticallyCreatedRestBackgroundThreads>(); + auto stub = compute_region_composite_health_checks_v1_internal:: + CreateDefaultRegionCompositeHealthChecksRestStub(options); + return compute_region_composite_health_checks_v1_internal:: + MakeRegionCompositeHealthChecksTracingConnection( + std::make_shared( + std::move(background), std::move(stub), std::move(options))); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_composite_health_checks_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks_rest_connection.h b/google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks_rest_connection.h new file mode 100644 index 0000000000000..5ca92e773e594 --- /dev/null +++ b/google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks_rest_connection.h @@ -0,0 +1,67 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_COMPOSITE_HEALTH_CHECKS_V1_REGION_COMPOSITE_HEALTH_CHECKS_REST_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_COMPOSITE_HEALTH_CHECKS_V1_REGION_COMPOSITE_HEALTH_CHECKS_REST_CONNECTION_H + +#include "google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks_connection.h" +#include "google/cloud/options.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_composite_health_checks_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/** + * A factory function to construct an object of type + * `RegionCompositeHealthChecksConnection` that uses REST over HTTP as transport + * in lieu of gRPC. REST transport should only be used for services that do not + * support gRPC or if the existing network configuration precludes using gRPC. + * + * The returned connection object should not be used directly; instead it + * should be passed as an argument to the constructor of + * RegionCompositeHealthChecksClient. + * + * The optional @p options argument may be used to configure aspects of the + * returned `RegionCompositeHealthChecksConnection`. Expected options are any of + * the types in the following option lists: + * + * - `google::cloud::CommonOptionList` + * - `google::cloud::RestOptionList` + * - `google::cloud::UnifiedCredentialsOptionList` + * - + * `google::cloud::compute_region_composite_health_checks_v1::RegionCompositeHealthChecksPolicyOptionList` + * + * @note Unexpected options will be ignored. To log unexpected options instead, + * set `GOOGLE_CLOUD_CPP_ENABLE_CLOG=yes` in the environment. + * + * @param options (optional) Configure the + * `RegionCompositeHealthChecksConnection` created by this function. + */ +std::shared_ptr +MakeRegionCompositeHealthChecksConnectionRest(Options options = {}); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_composite_health_checks_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_COMPOSITE_HEALTH_CHECKS_V1_REGION_COMPOSITE_HEALTH_CHECKS_REST_CONNECTION_H diff --git a/google/cloud/compute/region_composite_health_checks/v1/samples/region_composite_health_checks_client_samples.cc b/google/cloud/compute/region_composite_health_checks/v1/samples/region_composite_health_checks_client_samples.cc new file mode 100644 index 0000000000000..083c456e34001 --- /dev/null +++ b/google/cloud/compute/region_composite_health_checks/v1/samples/region_composite_health_checks_client_samples.cc @@ -0,0 +1,245 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks.proto + +#include "google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks_client.h" +#include "google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks_connection_idempotency_policy.h" +#include "google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks_options.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/internal/getenv.h" +#include "google/cloud/polling_policy.h" +#include "google/cloud/testing_util/example_driver.h" +#include "google/cloud/universe_domain.h" +#include +#include +#include +#include + +// clang-format off +// main-dox-marker: compute_region_composite_health_checks_v1::RegionCompositeHealthChecksClient +// lro-marker: true +// clang-format on +namespace { + +void SetClientEndpoint(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-endpoint"}; + } + //! [set-client-endpoint] + // This configuration is common with Private Google Access: + // https://cloud.google.com/vpc/docs/private-google-access + auto options = google::cloud::Options{}.set( + "private.googleapis.com"); + auto vpc_client = google::cloud::compute_region_composite_health_checks_v1:: + RegionCompositeHealthChecksClient( + google::cloud::compute_region_composite_health_checks_v1:: + MakeRegionCompositeHealthChecksConnectionRest(options)); + //! [set-client-endpoint] +} + +void SetClientUniverseDomain(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-universe-domain"}; + } + //! [set-client-universe-domain] + google::cloud::Options options; + + // AddUniverseDomainOption interrogates the UnifiedCredentialsOption, if set, + // in the provided Options for the Universe Domain associated with the + // credentials and adds it to the set of Options. + // If no UnifiedCredentialsOption is set, GoogleDefaultCredentials are used. + auto ud_options = google::cloud::AddUniverseDomainOption(std::move(options)); + + if (!ud_options.ok()) throw std::move(ud_options).status(); + auto ud_client = google::cloud::compute_region_composite_health_checks_v1:: + RegionCompositeHealthChecksClient( + google::cloud::compute_region_composite_health_checks_v1:: + MakeRegionCompositeHealthChecksConnectionRest(*ud_options)); + //! [set-client-universe-domain] +} + +//! [custom-idempotency-policy] +class CustomIdempotencyPolicy + : public google::cloud::compute_region_composite_health_checks_v1:: + RegionCompositeHealthChecksConnectionIdempotencyPolicy { + public: + ~CustomIdempotencyPolicy() override = default; + std::unique_ptr + clone() const override { + return std::make_unique(*this); + } + // Override inherited functions to define as needed. +}; +//! [custom-idempotency-policy] + +void SetRetryPolicy(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-retry-policy"}; + } + //! [set-retry-policy] + auto options = + google::cloud::Options{} + .set< + google::cloud::compute_region_composite_health_checks_v1:: + RegionCompositeHealthChecksConnectionIdempotencyPolicyOption>( + CustomIdempotencyPolicy().clone()) + .set( + google::cloud::compute_region_composite_health_checks_v1:: + RegionCompositeHealthChecksLimitedErrorCountRetryPolicy(3) + .clone()) + .set( + google::cloud::ExponentialBackoffPolicy( + /*initial_delay=*/std::chrono::milliseconds(200), + /*maximum_delay=*/std::chrono::seconds(45), + /*scaling=*/2.0) + .clone()); + auto connection = google::cloud::compute_region_composite_health_checks_v1:: + MakeRegionCompositeHealthChecksConnectionRest(options); + + // c1 and c2 share the same retry policies + auto c1 = google::cloud::compute_region_composite_health_checks_v1:: + RegionCompositeHealthChecksClient(connection); + auto c2 = google::cloud::compute_region_composite_health_checks_v1:: + RegionCompositeHealthChecksClient(connection); + + // You can override any of the policies in a new client. This new client + // will share the policies from c1 (or c2) *except* for the retry policy. + auto c3 = google::cloud::compute_region_composite_health_checks_v1:: + RegionCompositeHealthChecksClient( + connection, + google::cloud::Options{} + .set( + google::cloud::compute_region_composite_health_checks_v1:: + RegionCompositeHealthChecksLimitedTimeRetryPolicy( + std::chrono::minutes(5)) + .clone())); + + // You can also override the policies in a single call: + // c3.SomeRpc(..., google::cloud::Options{} + // .set( + // google::cloud::compute_region_composite_health_checks_v1::RegionCompositeHealthChecksLimitedErrorCountRetryPolicy(10).clone())); + //! [set-retry-policy] +} + +void SetPollingPolicy(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-policy-policy"}; + } + //! [set-polling-policy] + + // The polling policy controls how the client waits for long-running + // operations. `GenericPollingPolicy<>` combines existing policies. + // In this case, keep polling until the operation completes (with success + // or error) or 45 minutes, whichever happens first. Initially pause for + // 10 seconds between polling requests, increasing the pause by a factor + // of 4 until it becomes 2 minutes. + auto options = + google::cloud::Options{} + .set( + google::cloud::GenericPollingPolicy< + google::cloud::compute_region_composite_health_checks_v1:: + RegionCompositeHealthChecksRetryPolicyOption::Type, + google::cloud::compute_region_composite_health_checks_v1:: + RegionCompositeHealthChecksBackoffPolicyOption::Type>( + google::cloud::compute_region_composite_health_checks_v1:: + RegionCompositeHealthChecksLimitedTimeRetryPolicy( + /*maximum_duration=*/std::chrono::minutes(45)) + .clone(), + google::cloud::ExponentialBackoffPolicy( + /*initial_delay=*/std::chrono::seconds(10), + /*maximum_delay=*/std::chrono::minutes(2), + /*scaling=*/4.0) + .clone()) + .clone()); + + auto connection = google::cloud::compute_region_composite_health_checks_v1:: + MakeRegionCompositeHealthChecksConnectionRest(options); + + // c1 and c2 share the same polling policies. + auto c1 = google::cloud::compute_region_composite_health_checks_v1:: + RegionCompositeHealthChecksClient(connection); + auto c2 = google::cloud::compute_region_composite_health_checks_v1:: + RegionCompositeHealthChecksClient(connection); + //! [set-polling-policy] +} + +void WithServiceAccount(std::vector const& argv) { + if (argv.size() != 1 || argv[0] == "--help") { + throw google::cloud::testing_util::Usage{"with-service-account "}; + } + //! [with-service-account] + [](std::string const& keyfile) { + auto is = std::ifstream(keyfile); + is.exceptions(std::ios::badbit); // Minimal error handling in examples + auto contents = std::string(std::istreambuf_iterator(is.rdbuf()), {}); + auto options = + google::cloud::Options{}.set( + google::cloud::MakeServiceAccountCredentials(contents)); + return google::cloud::compute_region_composite_health_checks_v1:: + RegionCompositeHealthChecksClient( + google::cloud::compute_region_composite_health_checks_v1:: + MakeRegionCompositeHealthChecksConnectionRest(options)); + } + //! [with-service-account] + (argv.at(0)); +} + +void AutoRun(std::vector const& argv) { + namespace examples = ::google::cloud::testing_util; + using ::google::cloud::internal::GetEnv; + if (!argv.empty()) throw examples::Usage{"auto"}; + examples::CheckEnvironmentVariablesAreSet( + {"GOOGLE_CLOUD_CPP_TEST_SERVICE_ACCOUNT_KEYFILE"}); + auto const keyfile = + GetEnv("GOOGLE_CLOUD_CPP_TEST_SERVICE_ACCOUNT_KEYFILE").value(); + + std::cout << "\nRunning SetClientEndpoint() example" << std::endl; + SetClientEndpoint({}); + + std::cout << "\nRunning SetRetryPolicy() example" << std::endl; + SetRetryPolicy({}); + + std::cout << "\nRunning SetPollingPolicy() example" << std::endl; + SetPollingPolicy({}); + + std::cout << "\nRunning WithServiceAccount() example" << std::endl; + WithServiceAccount({keyfile}); + + std::cout << "\nRunning SetClientUniverseDomain() example" << std::endl; + SetClientUniverseDomain({}); +} + +} // namespace + +int main(int argc, char* argv[]) { // NOLINT(bugprone-exception-escape) + google::cloud::testing_util::Example example({ + {"set-client-endpoint", SetClientEndpoint}, + {"set-retry-policy", SetRetryPolicy}, + {"set-polling-policy", SetPollingPolicy}, + {"with-service-account", WithServiceAccount}, + {"set-client-universe-domain", SetClientUniverseDomain}, + {"auto", AutoRun}, + }); + return example.Run(argc, argv); +} 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 22558d0d8f816..8777916da2748 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_026.proto#L34} + /// [google.cloud.cpp.compute.v1.DiskType]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_035.proto#L44} /// // 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_026.proto#L34} + /// [google.cloud.cpp.compute.v1.DiskType]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_035.proto#L44} /// // 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_026.proto#L34} + /// [google.cloud.cpp.compute.v1.DiskType]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_035.proto#L44} /// // 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_026.proto#L34} + /// [google.cloud.cpp.compute.v1.DiskType]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_035.proto#L44} /// // 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 fc8d3d29cffe4..32858d274e8ac 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 "google/cloud/compute/v1/internal/common_023.pb.h" -#include "google/cloud/compute/v1/internal/common_026.pb.h" -#include "google/cloud/compute/v1/internal/common_101.pb.h" +#include "google/cloud/compute/v1/internal/common_032.pb.h" +#include "google/cloud/compute/v1/internal/common_035.pb.h" +#include "google/cloud/compute/v1/internal/common_118.pb.h" // 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/internal/region_disks_rest_connection_impl.cc b/google/cloud/compute/region_disks/v1/internal/region_disks_rest_connection_impl.cc index fd5f34a637a72..f9a42c31f74a0 100644 --- a/google/cloud/compute/region_disks/v1/internal/region_disks_rest_connection_impl.cc +++ b/google/cloud/compute/region_disks/v1/internal/region_disks_rest_connection_impl.cc @@ -1726,6 +1726,138 @@ RegionDisksRestConnectionImpl::UpdateDisk( }); } +future> +RegionDisksRestConnectionImpl::UpdateKmsKey( + google::cloud::cpp::compute::region_disks::v1::UpdateKmsKeyRequest const& + request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::region_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, request, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_disks::v1:: + UpdateKmsKeyRequest const& request) { + return stub->AsyncUpdateKmsKey(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->UpdateKmsKey(request), + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [request](std::string const& op, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest& r) { + r.set_project(request.project()); + r.set_region(request.region()); + r.set_operation(op); + }, + [request](std::string const& op, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest& r) { + r.set_project(request.project()); + r.set_region(request.region()); + r.set_operation(op); + }); +} + +StatusOr +RegionDisksRestConnectionImpl::UpdateKmsKey( + NoAwaitTag, + google::cloud::cpp::compute::region_disks::v1::UpdateKmsKeyRequest const& + request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->UpdateKmsKey(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_disks::v1:: + UpdateKmsKeyRequest const& request) { + return stub_->UpdateKmsKey(rest_context, options, request); + }, + *current, request, __func__); +} + +future> +RegionDisksRestConnectionImpl::UpdateKmsKey( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestAwaitLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::region_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, operation, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [operation](std::string const&, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_region(info.region); + r.set_operation(info.operation); + }, + [operation](std::string const&, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_region(info.region); + r.set_operation(info.operation); + }); +} + GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END } // namespace compute_region_disks_v1_internal } // namespace cloud diff --git a/google/cloud/compute/region_disks/v1/internal/region_disks_rest_connection_impl.h b/google/cloud/compute/region_disks/v1/internal/region_disks_rest_connection_impl.h index a336f0ac2bd92..64986eed00fd9 100644 --- a/google/cloud/compute/region_disks/v1/internal/region_disks_rest_connection_impl.h +++ b/google/cloud/compute/region_disks/v1/internal/region_disks_rest_connection_impl.h @@ -218,6 +218,18 @@ class RegionDisksRestConnectionImpl future> UpdateDisk( google::cloud::cpp::compute::v1::Operation const& operation) override; + future> UpdateKmsKey( + google::cloud::cpp::compute::region_disks::v1::UpdateKmsKeyRequest const& + request) override; + + StatusOr UpdateKmsKey( + NoAwaitTag, + google::cloud::cpp::compute::region_disks::v1::UpdateKmsKeyRequest const& + request) override; + + future> UpdateKmsKey( + google::cloud::cpp::compute::v1::Operation const& operation) override; + private: static std::unique_ptr retry_policy(Options const& options) { diff --git a/google/cloud/compute/region_disks/v1/internal/region_disks_rest_logging_decorator.cc b/google/cloud/compute/region_disks/v1/internal/region_disks_rest_logging_decorator.cc index 4d91a43053ea4..36b57e25f1a1d 100644 --- a/google/cloud/compute/region_disks/v1/internal/region_disks_rest_logging_decorator.cc +++ b/google/cloud/compute/region_disks/v1/internal/region_disks_rest_logging_decorator.cc @@ -515,6 +515,40 @@ RegionDisksRestLogging::UpdateDisk( rest_context, options, request, __func__, tracing_options_); } +future> +RegionDisksRestLogging::AsyncUpdateKmsKey( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_disks::v1::UpdateKmsKeyRequest const& + request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_disks::v1:: + UpdateKmsKeyRequest const& request) { + return child_->AsyncUpdateKmsKey(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +StatusOr +RegionDisksRestLogging::UpdateKmsKey( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_disks::v1::UpdateKmsKeyRequest const& + request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_disks::v1:: + UpdateKmsKeyRequest const& request) { + return child_->UpdateKmsKey(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + future> RegionDisksRestLogging::AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/region_disks/v1/internal/region_disks_rest_logging_decorator.h b/google/cloud/compute/region_disks/v1/internal/region_disks_rest_logging_decorator.h index 6e6b773edf131..f97b089969127 100644 --- a/google/cloud/compute/region_disks/v1/internal/region_disks_rest_logging_decorator.h +++ b/google/cloud/compute/region_disks/v1/internal/region_disks_rest_logging_decorator.h @@ -235,6 +235,20 @@ class RegionDisksRestLogging : public RegionDisksRestStub { google::cloud::cpp::compute::region_disks::v1::UpdateDiskRequest const& request) override; + future> + AsyncUpdateKmsKey( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_disks::v1::UpdateKmsKeyRequest const& + request) override; + + StatusOr UpdateKmsKey( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_disks::v1::UpdateKmsKeyRequest const& + request) override; + future> AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/region_disks/v1/internal/region_disks_rest_metadata_decorator.cc b/google/cloud/compute/region_disks/v1/internal/region_disks_rest_metadata_decorator.cc index 64be6ec7a6b69..1339d13a6926f 100644 --- a/google/cloud/compute/region_disks/v1/internal/region_disks_rest_metadata_decorator.cc +++ b/google/cloud/compute/region_disks/v1/internal/region_disks_rest_metadata_decorator.cc @@ -335,6 +335,27 @@ RegionDisksRestMetadata::UpdateDisk( return child_->UpdateDisk(rest_context, options, request); } +future> +RegionDisksRestMetadata::AsyncUpdateKmsKey( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_disks::v1::UpdateKmsKeyRequest const& + request) { + SetMetadata(*rest_context, *options); + return child_->AsyncUpdateKmsKey(cq, std::move(rest_context), + std::move(options), request); +} + +StatusOr +RegionDisksRestMetadata::UpdateKmsKey( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_disks::v1::UpdateKmsKeyRequest const& + request) { + SetMetadata(rest_context, options); + return child_->UpdateKmsKey(rest_context, options, request); +} + future> RegionDisksRestMetadata::AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/region_disks/v1/internal/region_disks_rest_metadata_decorator.h b/google/cloud/compute/region_disks/v1/internal/region_disks_rest_metadata_decorator.h index fb0315454a9f3..fd78f089ff406 100644 --- a/google/cloud/compute/region_disks/v1/internal/region_disks_rest_metadata_decorator.h +++ b/google/cloud/compute/region_disks/v1/internal/region_disks_rest_metadata_decorator.h @@ -238,6 +238,20 @@ class RegionDisksRestMetadata : public RegionDisksRestStub { google::cloud::cpp::compute::region_disks::v1::UpdateDiskRequest const& request) override; + google::cloud::future> + AsyncUpdateKmsKey( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_disks::v1::UpdateKmsKeyRequest const& + request) override; + + StatusOr UpdateKmsKey( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_disks::v1::UpdateKmsKeyRequest const& + request) override; + google::cloud::future> AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/region_disks/v1/internal/region_disks_rest_stub.cc b/google/cloud/compute/region_disks/v1/internal/region_disks_rest_stub.cc index 87a5fc1c09fcb..71e8b4396535c 100644 --- a/google/cloud/compute/region_disks/v1/internal/region_disks_rest_stub.cc +++ b/google/cloud/compute/region_disks/v1/internal/region_disks_rest_stub.cc @@ -842,6 +842,65 @@ DefaultRegionDisksRestStub::UpdateDisk( std::move(query_params)); } +future> +DefaultRegionDisksRestStub::AsyncUpdateKmsKey( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_disks::v1::UpdateKmsKeyRequest const& + request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto service, auto request, auto rest_context, auto options) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + p.set_value( + rest_internal::Post( + *service, *rest_context, + request.region_disk_update_kms_key_request_resource(), false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", *options), + "/", "projects", "/", request.project(), "/", + "regions", "/", request.region(), "/", "disks", + "/", request.disk(), "/", "updateKmsKey"), + std::move(query_params))); + }, + std::move(p), + service_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +StatusOr +DefaultRegionDisksRestStub::UpdateKmsKey( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_disks::v1::UpdateKmsKeyRequest const& + request) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Post( + *service_, rest_context, + request.region_disk_update_kms_key_request_resource(), false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "regions", "/", + request.region(), "/", "disks", "/", request.disk(), "/", + "updateKmsKey"), + std::move(query_params)); +} + future> DefaultRegionDisksRestStub::AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/region_disks/v1/internal/region_disks_rest_stub.h b/google/cloud/compute/region_disks/v1/internal/region_disks_rest_stub.h index 051309674f6a6..87751eb4c22b2 100644 --- a/google/cloud/compute/region_disks/v1/internal/region_disks_rest_stub.h +++ b/google/cloud/compute/region_disks/v1/internal/region_disks_rest_stub.h @@ -237,6 +237,20 @@ class RegionDisksRestStub { google::cloud::cpp::compute::region_disks::v1::UpdateDiskRequest const& request) = 0; + virtual future> + AsyncUpdateKmsKey( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_disks::v1::UpdateKmsKeyRequest const& + request) = 0; + + virtual StatusOr UpdateKmsKey( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_disks::v1::UpdateKmsKeyRequest const& + request) = 0; + virtual future> AsyncGetOperation( google::cloud::CompletionQueue& cq, @@ -455,6 +469,20 @@ class DefaultRegionDisksRestStub : public RegionDisksRestStub { google::cloud::cpp::compute::region_disks::v1::UpdateDiskRequest const& request) override; + future> + AsyncUpdateKmsKey( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_disks::v1::UpdateKmsKeyRequest const& + request) override; + + StatusOr UpdateKmsKey( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_disks::v1::UpdateKmsKeyRequest const& + request) override; + future> AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/region_disks/v1/internal/region_disks_tracing_connection.cc b/google/cloud/compute/region_disks/v1/internal/region_disks_tracing_connection.cc index 2b85dac179a6b..e53699dc28894 100644 --- a/google/cloud/compute/region_disks/v1/internal/region_disks_tracing_connection.cc +++ b/google/cloud/compute/region_disks/v1/internal/region_disks_tracing_connection.cc @@ -457,6 +457,36 @@ RegionDisksTracingConnection::UpdateDisk( return internal::EndSpan(std::move(span), child_->UpdateDisk(operation)); } +future> +RegionDisksTracingConnection::UpdateKmsKey( + google::cloud::cpp::compute::region_disks::v1::UpdateKmsKeyRequest const& + request) { + auto span = internal::MakeSpan( + "compute_region_disks_v1::RegionDisksConnection::UpdateKmsKey"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), child_->UpdateKmsKey(request)); +} + +StatusOr +RegionDisksTracingConnection::UpdateKmsKey( + NoAwaitTag, + google::cloud::cpp::compute::region_disks::v1::UpdateKmsKeyRequest const& + request) { + auto span = internal::MakeSpan( + "compute_region_disks_v1::RegionDisksConnection::UpdateKmsKey"); + opentelemetry::trace::Scope scope(span); + return internal::EndSpan(*span, child_->UpdateKmsKey(NoAwaitTag{}, request)); +} + +future> +RegionDisksTracingConnection::UpdateKmsKey( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto span = internal::MakeSpan( + "compute_region_disks_v1::RegionDisksConnection::UpdateKmsKey"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), child_->UpdateKmsKey(operation)); +} + std::shared_ptr MakeRegionDisksTracingConnection( std::shared_ptr conn) { diff --git a/google/cloud/compute/region_disks/v1/internal/region_disks_tracing_connection.h b/google/cloud/compute/region_disks/v1/internal/region_disks_tracing_connection.h index ebc54d08a6128..99692358f9cbc 100644 --- a/google/cloud/compute/region_disks/v1/internal/region_disks_tracing_connection.h +++ b/google/cloud/compute/region_disks/v1/internal/region_disks_tracing_connection.h @@ -205,6 +205,18 @@ class RegionDisksTracingConnection future> UpdateDisk( google::cloud::cpp::compute::v1::Operation const& operation) override; + future> UpdateKmsKey( + google::cloud::cpp::compute::region_disks::v1::UpdateKmsKeyRequest const& + request) override; + + StatusOr UpdateKmsKey( + NoAwaitTag, + google::cloud::cpp::compute::region_disks::v1::UpdateKmsKeyRequest const& + request) override; + + future> UpdateKmsKey( + google::cloud::cpp::compute::v1::Operation const& operation) override; + private: std::shared_ptr child_; }; diff --git a/google/cloud/compute/region_disks/v1/mocks/mock_region_disks_connection.h b/google/cloud/compute/region_disks/v1/mocks/mock_region_disks_connection.h index 1f2b8938ce7f7..9f46e0392ded8 100644 --- a/google/cloud/compute/region_disks/v1/mocks/mock_region_disks_connection.h +++ b/google/cloud/compute/region_disks/v1/mocks/mock_region_disks_connection.h @@ -569,6 +569,49 @@ class MockRegionDisksConnection UpdateDisk, (google::cloud::cpp::compute::v1::Operation const& operation), (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// UpdateKmsKey(Matcher(_))) + /// @endcode + MOCK_METHOD( + future>, + UpdateKmsKey, + (google::cloud::cpp::compute::region_disks::v1::UpdateKmsKeyRequest const& + request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// EXPECT_CALL(*mock, UpdateKmsKey(_, _)) + /// @endcode + MOCK_METHOD( + StatusOr, UpdateKmsKey, + (NoAwaitTag, + google::cloud::cpp::compute::region_disks::v1::UpdateKmsKeyRequest const& + request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// UpdateKmsKey(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + UpdateKmsKey, + (google::cloud::cpp::compute::v1::Operation const& operation), + (override)); }; GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END diff --git a/google/cloud/compute/region_disks/v1/region_disks_client.cc b/google/cloud/compute/region_disks/v1/region_disks_client.cc index 36467e2d03513..1d73138e5ff35 100644 --- a/google/cloud/compute/region_disks/v1/region_disks_client.cc +++ b/google/cloud/compute/region_disks/v1/region_disks_client.cc @@ -830,6 +830,66 @@ RegionDisksClient::UpdateDisk( return connection_->UpdateDisk(operation); } +future> +RegionDisksClient::UpdateKmsKey( + std::string const& project, std::string const& region, + std::string const& disk, + google::cloud::cpp::compute::v1::RegionDiskUpdateKmsKeyRequest const& + region_disk_update_kms_key_request_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_disks::v1::UpdateKmsKeyRequest request; + request.set_project(project); + request.set_region(region); + request.set_disk(disk); + *request.mutable_region_disk_update_kms_key_request_resource() = + region_disk_update_kms_key_request_resource; + return connection_->UpdateKmsKey(request); +} + +StatusOr +RegionDisksClient::UpdateKmsKey( + NoAwaitTag, std::string const& project, std::string const& region, + std::string const& disk, + google::cloud::cpp::compute::v1::RegionDiskUpdateKmsKeyRequest const& + region_disk_update_kms_key_request_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_disks::v1::UpdateKmsKeyRequest request; + request.set_project(project); + request.set_region(region); + request.set_disk(disk); + *request.mutable_region_disk_update_kms_key_request_resource() = + region_disk_update_kms_key_request_resource; + return connection_->UpdateKmsKey(NoAwaitTag{}, request); +} + +future> +RegionDisksClient::UpdateKmsKey( + google::cloud::cpp::compute::region_disks::v1::UpdateKmsKeyRequest const& + request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->UpdateKmsKey(request); +} + +StatusOr +RegionDisksClient::UpdateKmsKey( + NoAwaitTag, + google::cloud::cpp::compute::region_disks::v1::UpdateKmsKeyRequest const& + request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->UpdateKmsKey(NoAwaitTag{}, request); +} + +future> +RegionDisksClient::UpdateKmsKey( + google::cloud::cpp::compute::v1::Operation const& operation, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->UpdateKmsKey(operation); +} + GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END } // namespace compute_region_disks_v1 } // namespace cloud 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 e424823157013..9e4fe4c85814a 100644 --- a/google/cloud/compute/region_disks/v1/region_disks_client.h +++ b/google/cloud/compute/region_disks/v1/region_disks_client.h @@ -91,7 +91,8 @@ class RegionDisksClient { // clang-format off /// /// 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. + /// policy which will be applied to this disk for scheduling snapshot + /// creation. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionDisks/addResourcePolicies /// /// @param project Project ID for this request. @@ -118,7 +119,7 @@ class RegionDisksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_disks.v1.AddResourcePoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_disks/v1/region_disks.proto#L267} + /// [google.cloud.cpp.compute.region_disks.v1.AddResourcePoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_disks/v1/region_disks.proto#L283} /// // clang-format on future> @@ -152,7 +153,8 @@ class RegionDisksClient { // clang-format off /// /// 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. + /// policy which will be applied to this disk for scheduling snapshot + /// creation. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionDisks/addResourcePolicies /// /// @param request Unary RPCs, such as the one wrapped by this @@ -181,7 +183,7 @@ class RegionDisksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_disks.v1.AddResourcePoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_disks/v1/region_disks.proto#L267} + /// [google.cloud.cpp.compute.region_disks.v1.AddResourcePoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_disks/v1/region_disks.proto#L283} /// // clang-format on future> @@ -248,7 +250,7 @@ class RegionDisksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_disks.v1.BulkInsertRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_disks/v1/region_disks.proto#L304} + /// [google.cloud.cpp.compute.region_disks.v1.BulkInsertRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_disks/v1/region_disks.proto#L323} /// // clang-format on future> BulkInsert( @@ -305,7 +307,7 @@ class RegionDisksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_disks.v1.BulkInsertRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_disks/v1/region_disks.proto#L304} + /// [google.cloud.cpp.compute.region_disks.v1.BulkInsertRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_disks/v1/region_disks.proto#L323} /// // clang-format on future> BulkInsert( @@ -346,9 +348,9 @@ class RegionDisksClient { // clang-format off /// /// 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. + /// 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. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionDisks/createSnapshot /// /// @param project Project ID for this request. @@ -375,7 +377,7 @@ class RegionDisksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_disks.v1.CreateSnapshotRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_disks/v1/region_disks.proto#L337} + /// [google.cloud.cpp.compute.region_disks.v1.CreateSnapshotRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_disks/v1/region_disks.proto#L359} /// // clang-format on future> CreateSnapshot( @@ -404,9 +406,9 @@ class RegionDisksClient { // clang-format off /// /// 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. + /// 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. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionDisks/createSnapshot /// /// @param request Unary RPCs, such as the one wrapped by this @@ -435,7 +437,7 @@ class RegionDisksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_disks.v1.CreateSnapshotRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_disks/v1/region_disks.proto#L337} + /// [google.cloud.cpp.compute.region_disks.v1.CreateSnapshotRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_disks/v1/region_disks.proto#L359} /// // clang-format on future> CreateSnapshot( @@ -477,8 +479,9 @@ class RegionDisksClient { /// /// 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. + /// However, deleting a disk does not delete anysnapshots + /// previously made from the disk. You must separatelydelete + /// snapshots. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionDisks/delete /// /// @param project Project ID for this request. @@ -504,7 +507,7 @@ class RegionDisksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_disks.v1.DeleteDiskRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_disks/v1/region_disks.proto#L373} + /// [google.cloud.cpp.compute.region_disks.v1.DeleteDiskRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_disks/v1/region_disks.proto#L398} /// // clang-format on future> DeleteDisk( @@ -530,8 +533,9 @@ class RegionDisksClient { /// /// 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. + /// However, deleting a disk does not delete anysnapshots + /// previously made from the disk. You must separatelydelete + /// snapshots. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionDisks/delete /// /// @param request Unary RPCs, such as the one wrapped by this @@ -560,7 +564,7 @@ class RegionDisksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_disks.v1.DeleteDiskRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_disks/v1/region_disks.proto#L373} + /// [google.cloud.cpp.compute.region_disks.v1.DeleteDiskRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_disks/v1/region_disks.proto#L398} /// // clang-format on future> DeleteDisk( @@ -619,8 +623,8 @@ class RegionDisksClient { /// [`future`]: @ref google::cloud::future /// [`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_014.proto#L49} + /// [google.cloud.cpp.compute.region_disks.v1.GetDiskRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_disks/v1/region_disks.proto#L433} + /// [google.cloud.cpp.compute.v1.Disk]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_017.proto#L75} /// // clang-format on StatusOr GetDisk( @@ -651,8 +655,8 @@ class RegionDisksClient { /// [`future`]: @ref google::cloud::future /// [`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_014.proto#L49} + /// [google.cloud.cpp.compute.region_disks.v1.GetDiskRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_disks/v1/region_disks.proto#L433} + /// [google.cloud.cpp.compute.v1.Disk]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_017.proto#L75} /// // clang-format on StatusOr GetDisk( @@ -682,8 +686,8 @@ class RegionDisksClient { /// [`future`]: @ref google::cloud::future /// [`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_007.proto#L178} + /// [google.cloud.cpp.compute.region_disks.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_disks/v1/region_disks.proto#L447} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr GetIamPolicy( @@ -715,8 +719,8 @@ class RegionDisksClient { /// [`future`]: @ref google::cloud::future /// [`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_007.proto#L178} + /// [google.cloud.cpp.compute.region_disks.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_disks/v1/region_disks.proto#L447} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr GetIamPolicy( @@ -753,7 +757,7 @@ class RegionDisksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_disks.v1.InsertDiskRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_disks/v1/region_disks.proto#L438} + /// [google.cloud.cpp.compute.region_disks.v1.InsertDiskRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_disks/v1/region_disks.proto#L466} /// // clang-format on future> InsertDisk( @@ -809,7 +813,7 @@ class RegionDisksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_disks.v1.InsertDiskRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_disks/v1/region_disks.proto#L438} + /// [google.cloud.cpp.compute.region_disks.v1.InsertDiskRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_disks/v1/region_disks.proto#L466} /// // clang-format on future> InsertDisk( @@ -849,8 +853,8 @@ class RegionDisksClient { // clang-format off /// - /// Retrieves the list of persistent disks contained within the specified - /// region. + /// Retrieves the list of persistent disks contained within + /// the specified region. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionDisks/list /// /// @param project Project ID for this request. @@ -877,8 +881,8 @@ class RegionDisksClient { /// [`future`]: @ref google::cloud::future /// [`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_014.proto#L49} + /// [google.cloud.cpp.compute.region_disks.v1.ListRegionDisksRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_disks/v1/region_disks.proto#L505} + /// [google.cloud.cpp.compute.v1.Disk]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_017.proto#L75} /// // clang-format on StreamRange ListRegionDisks( @@ -886,8 +890,8 @@ class RegionDisksClient { // clang-format off /// - /// Retrieves the list of persistent disks contained within the specified - /// region. + /// Retrieves the list of persistent disks contained within + /// the specified region. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionDisks/list /// /// @param request Unary RPCs, such as the one wrapped by this @@ -918,8 +922,8 @@ class RegionDisksClient { /// [`future`]: @ref google::cloud::future /// [`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_014.proto#L49} + /// [google.cloud.cpp.compute.region_disks.v1.ListRegionDisksRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_disks/v1/region_disks.proto#L505} + /// [google.cloud.cpp.compute.v1.Disk]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_017.proto#L75} /// // clang-format on StreamRange ListRegionDisks( @@ -956,7 +960,7 @@ class RegionDisksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_disks.v1.RemoveResourcePoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_disks/v1/region_disks.proto#L546} + /// [google.cloud.cpp.compute.region_disks.v1.RemoveResourcePoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_disks/v1/region_disks.proto#L610} /// // clang-format on future> @@ -1018,7 +1022,7 @@ class RegionDisksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_disks.v1.RemoveResourcePoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_disks/v1/region_disks.proto#L546} + /// [google.cloud.cpp.compute.region_disks.v1.RemoveResourcePoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_disks/v1/region_disks.proto#L610} /// // clang-format on future> @@ -1086,7 +1090,7 @@ class RegionDisksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_disks.v1.ResizeRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_disks/v1/region_disks.proto#L583} + /// [google.cloud.cpp.compute.region_disks.v1.ResizeRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_disks/v1/region_disks.proto#L650} /// // clang-format on future> Resize( @@ -1145,7 +1149,7 @@ class RegionDisksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_disks.v1.ResizeRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_disks/v1/region_disks.proto#L583} + /// [google.cloud.cpp.compute.region_disks.v1.ResizeRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_disks/v1/region_disks.proto#L650} /// // clang-format on future> Resize( @@ -1185,8 +1189,8 @@ class RegionDisksClient { // clang-format off /// - /// Sets the access control policy on the specified resource. Replaces any - /// existing policy. + /// Sets the access control policy on the specified resource. + /// Replaces any existing policy. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionDisks/setIamPolicy /// /// @param project Project ID for this request. @@ -1206,8 +1210,8 @@ class RegionDisksClient { /// [`future`]: @ref google::cloud::future /// [`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_007.proto#L178} + /// [google.cloud.cpp.compute.region_disks.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_disks/v1/region_disks.proto#L690} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr SetIamPolicy( @@ -1219,8 +1223,8 @@ class RegionDisksClient { // clang-format off /// - /// Sets the access control policy on the specified resource. Replaces any - /// existing policy. + /// Sets the access control policy on the specified resource. + /// Replaces any existing policy. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionDisks/setIamPolicy /// /// @param request Unary RPCs, such as the one wrapped by this @@ -1242,8 +1246,8 @@ class RegionDisksClient { /// [`future`]: @ref google::cloud::future /// [`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_007.proto#L178} + /// [google.cloud.cpp.compute.region_disks.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_disks/v1/region_disks.proto#L690} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr SetIamPolicy( @@ -1280,7 +1284,7 @@ class RegionDisksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_disks.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_disks/v1/region_disks.proto#L640} + /// [google.cloud.cpp.compute.region_disks.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_disks/v1/region_disks.proto#L710} /// // clang-format on future> SetLabels( @@ -1339,7 +1343,7 @@ class RegionDisksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_disks.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_disks/v1/region_disks.proto#L640} + /// [google.cloud.cpp.compute.region_disks.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_disks/v1/region_disks.proto#L710} /// // clang-format on future> SetLabels( @@ -1379,7 +1383,8 @@ class RegionDisksClient { // clang-format off /// - /// Starts asynchronous replication. Must be invoked on the primary disk. + /// Starts asynchronous replication. + /// Must be invoked on the primary disk. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionDisks/startAsyncReplication /// /// @param project Project ID for this request. @@ -1406,7 +1411,7 @@ class RegionDisksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_disks.v1.StartAsyncReplicationRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_disks/v1/region_disks.proto#L678} + /// [google.cloud.cpp.compute.region_disks.v1.StartAsyncReplicationRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_disks/v1/region_disks.proto#L751} /// // clang-format on future> @@ -1439,7 +1444,8 @@ class RegionDisksClient { // clang-format off /// - /// Starts asynchronous replication. Must be invoked on the primary disk. + /// Starts asynchronous replication. + /// Must be invoked on the primary disk. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionDisks/startAsyncReplication /// /// @param request Unary RPCs, such as the one wrapped by this @@ -1468,7 +1474,7 @@ class RegionDisksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_disks.v1.StartAsyncReplicationRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_disks/v1/region_disks.proto#L678} + /// [google.cloud.cpp.compute.region_disks.v1.StartAsyncReplicationRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_disks/v1/region_disks.proto#L751} /// // clang-format on future> @@ -1509,8 +1515,8 @@ class RegionDisksClient { // clang-format off /// - /// Stops asynchronous replication. Can be invoked either on the primary or on - /// the secondary disk. + /// Stops asynchronous replication. + /// Can be invoked either on the primary or on the secondary disk. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionDisks/stopAsyncReplication /// /// @param project Project ID for this request. @@ -1536,7 +1542,7 @@ class RegionDisksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_disks.v1.StopAsyncReplicationRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_disks/v1/region_disks.proto#L715} + /// [google.cloud.cpp.compute.region_disks.v1.StopAsyncReplicationRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_disks/v1/region_disks.proto#L791} /// // clang-format on future> @@ -1560,8 +1566,8 @@ class RegionDisksClient { // clang-format off /// - /// Stops asynchronous replication. Can be invoked either on the primary or on - /// the secondary disk. + /// Stops asynchronous replication. + /// Can be invoked either on the primary or on the secondary disk. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionDisks/stopAsyncReplication /// /// @param request Unary RPCs, such as the one wrapped by this @@ -1590,7 +1596,7 @@ class RegionDisksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_disks.v1.StopAsyncReplicationRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_disks/v1/region_disks.proto#L715} + /// [google.cloud.cpp.compute.region_disks.v1.StopAsyncReplicationRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_disks/v1/region_disks.proto#L791} /// // clang-format on future> @@ -1631,8 +1637,8 @@ class RegionDisksClient { // clang-format off /// - /// Stops asynchronous replication for a consistency group of disks. Can be - /// invoked either in the primary or secondary scope. + /// Stops asynchronous replication for a consistency group of disks. + /// Can be invoked either in the primary or secondary scope. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionDisks/stopGroupAsyncReplication /// /// @param project Project ID for this request. @@ -1659,7 +1665,7 @@ class RegionDisksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_disks.v1.StopGroupAsyncReplicationRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_disks/v1/region_disks.proto#L747} + /// [google.cloud.cpp.compute.region_disks.v1.StopGroupAsyncReplicationRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_disks/v1/region_disks.proto#L826} /// // clang-format on future> @@ -1691,8 +1697,8 @@ class RegionDisksClient { // clang-format off /// - /// Stops asynchronous replication for a consistency group of disks. Can be - /// invoked either in the primary or secondary scope. + /// Stops asynchronous replication for a consistency group of disks. + /// Can be invoked either in the primary or secondary scope. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionDisks/stopGroupAsyncReplication /// /// @param request Unary RPCs, such as the one wrapped by this @@ -1721,7 +1727,7 @@ class RegionDisksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_disks.v1.StopGroupAsyncReplicationRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_disks/v1/region_disks.proto#L747} + /// [google.cloud.cpp.compute.region_disks.v1.StopGroupAsyncReplicationRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_disks/v1/region_disks.proto#L826} /// // clang-format on future> @@ -1782,8 +1788,8 @@ class RegionDisksClient { /// [`future`]: @ref google::cloud::future /// [`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_145.proto#L30} + /// [google.cloud.cpp.compute.region_disks.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_disks/v1/region_disks.proto#L864} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} /// // clang-format on StatusOr @@ -1818,8 +1824,8 @@ class RegionDisksClient { /// [`future`]: @ref google::cloud::future /// [`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_145.proto#L30} + /// [google.cloud.cpp.compute.region_disks.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_disks/v1/region_disks.proto#L864} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} /// // clang-format on StatusOr @@ -1830,8 +1836,7 @@ class RegionDisksClient { // clang-format off /// /// 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. + /// performed only on selected fields included as part of update-mask. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionDisks/update /// /// @param project Project ID for this request. @@ -1859,7 +1864,7 @@ class RegionDisksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_disks.v1.UpdateDiskRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_disks/v1/region_disks.proto#L801} + /// [google.cloud.cpp.compute.region_disks.v1.UpdateDiskRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_disks/v1/region_disks.proto#L883} /// // clang-format on future> UpdateDisk( @@ -1888,8 +1893,7 @@ class RegionDisksClient { // clang-format off /// /// 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. + /// performed only on selected fields included as part of update-mask. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionDisks/update /// /// @param request Unary RPCs, such as the one wrapped by this @@ -1918,7 +1922,7 @@ class RegionDisksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_disks.v1.UpdateDiskRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_disks/v1/region_disks.proto#L801} + /// [google.cloud.cpp.compute.region_disks.v1.UpdateDiskRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_disks/v1/region_disks.proto#L883} /// // clang-format on future> UpdateDisk( @@ -1956,6 +1960,134 @@ class RegionDisksClient { google::cloud::cpp::compute::v1::Operation const& operation, Options opts = {}); + // clang-format off + /// + /// Rotates the customer-managed + /// encryption key to the latest version for the specified persistent disk. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionDisks/updateKmsKey + /// + /// @param project Project ID for this request. + /// @param region The name of the region for this request. + /// @param disk Name of the Disk resource, should conform to RFC1035. + /// @param region_disk_update_kms_key_request_resource The RegionDiskUpdateKmsKeyRequest for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_disks.v1.UpdateKmsKeyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_disks/v1/region_disks.proto#L927} + /// + // clang-format on + future> UpdateKmsKey( + std::string const& project, std::string const& region, + std::string const& disk, + google::cloud::cpp::compute::v1::RegionDiskUpdateKmsKeyRequest const& + region_disk_update_kms_key_request_resource, + Options opts = {}); + + // clang-format off + /// + /// @copybrief UpdateKmsKey + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr UpdateKmsKey( + NoAwaitTag, std::string const& project, std::string const& region, + std::string const& disk, + google::cloud::cpp::compute::v1::RegionDiskUpdateKmsKeyRequest const& + region_disk_update_kms_key_request_resource, + Options opts = {}); + + // clang-format off + /// + /// Rotates the customer-managed + /// encryption key to the latest version for the specified persistent disk. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionDisks/updateKmsKey + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.region_disks.v1.UpdateKmsKeyRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_disks.v1.UpdateKmsKeyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_disks/v1/region_disks.proto#L927} + /// + // clang-format on + future> UpdateKmsKey( + google::cloud::cpp::compute::region_disks::v1::UpdateKmsKeyRequest const& + request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief UpdateKmsKey + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr UpdateKmsKey( + NoAwaitTag, + google::cloud::cpp::compute::region_disks::v1::UpdateKmsKeyRequest const& + request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief UpdateKmsKey + /// + /// This method accepts a `google::cloud::cpp::compute::v1::Operation` that corresponds + /// to a previously started Long Running Operation (LRO) and polls the status + /// of the LRO in the background. + /// + // clang-format on + future> UpdateKmsKey( + google::cloud::cpp::compute::v1::Operation const& operation, + Options opts = {}); + private: std::shared_ptr connection_; Options options_; diff --git a/google/cloud/compute/region_disks/v1/region_disks_connection.cc b/google/cloud/compute/region_disks/v1/region_disks_connection.cc index d1a9dc52260a5..ae1a0bcf3b296 100644 --- a/google/cloud/compute/region_disks/v1/region_disks_connection.cc +++ b/google/cloud/compute/region_disks/v1/region_disks_connection.cc @@ -362,6 +362,30 @@ RegionDisksConnection::UpdateDisk( Status(StatusCode::kUnimplemented, "not implemented")); } +future> +RegionDisksConnection::UpdateKmsKey( + google::cloud::cpp::compute::region_disks::v1::UpdateKmsKeyRequest const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +RegionDisksConnection::UpdateKmsKey( + NoAwaitTag, + google::cloud::cpp::compute::region_disks::v1::UpdateKmsKeyRequest const&) { + return StatusOr( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +RegionDisksConnection::UpdateKmsKey( + google::cloud::cpp::compute::v1::Operation const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END } // namespace compute_region_disks_v1 } // namespace cloud diff --git a/google/cloud/compute/region_disks/v1/region_disks_connection.h b/google/cloud/compute/region_disks/v1/region_disks_connection.h index c216eadeeaab9..ebf7ec65f58a8 100644 --- a/google/cloud/compute/region_disks/v1/region_disks_connection.h +++ b/google/cloud/compute/region_disks/v1/region_disks_connection.h @@ -357,6 +357,19 @@ class RegionDisksConnection { virtual future> UpdateDisk(google::cloud::cpp::compute::v1::Operation const& operation); + + virtual future> + UpdateKmsKey( + google::cloud::cpp::compute::region_disks::v1::UpdateKmsKeyRequest const& + request); + + virtual StatusOr UpdateKmsKey( + NoAwaitTag, + google::cloud::cpp::compute::region_disks::v1::UpdateKmsKeyRequest const& + request); + + virtual future> + UpdateKmsKey(google::cloud::cpp::compute::v1::Operation const& operation); }; GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END diff --git a/google/cloud/compute/region_disks/v1/region_disks_connection_idempotency_policy.cc b/google/cloud/compute/region_disks/v1/region_disks_connection_idempotency_policy.cc index 0cb2d091bdb40..10f85eebdd38e 100644 --- a/google/cloud/compute/region_disks/v1/region_disks_connection_idempotency_policy.cc +++ b/google/cloud/compute/region_disks/v1/region_disks_connection_idempotency_policy.cc @@ -127,6 +127,11 @@ Idempotency RegionDisksConnectionIdempotencyPolicy::UpdateDisk( return Idempotency::kNonIdempotent; } +Idempotency RegionDisksConnectionIdempotencyPolicy::UpdateKmsKey( + google::cloud::cpp::compute::region_disks::v1::UpdateKmsKeyRequest const&) { + return Idempotency::kNonIdempotent; +} + std::unique_ptr MakeDefaultRegionDisksConnectionIdempotencyPolicy() { return std::make_unique(); diff --git a/google/cloud/compute/region_disks/v1/region_disks_connection_idempotency_policy.h b/google/cloud/compute/region_disks/v1/region_disks_connection_idempotency_policy.h index c683ec6a17696..ec1018f7ca0b1 100644 --- a/google/cloud/compute/region_disks/v1/region_disks_connection_idempotency_policy.h +++ b/google/cloud/compute/region_disks/v1/region_disks_connection_idempotency_policy.h @@ -103,6 +103,10 @@ class RegionDisksConnectionIdempotencyPolicy { virtual google::cloud::Idempotency UpdateDisk( google::cloud::cpp::compute::region_disks::v1::UpdateDiskRequest const& request); + + virtual google::cloud::Idempotency UpdateKmsKey( + google::cloud::cpp::compute::region_disks::v1::UpdateKmsKeyRequest const& + request); }; std::unique_ptr 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 ef63807d80d40..4689b6e4acbff 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 "google/cloud/compute/v1/internal/common_007.pb.h" -#include "google/cloud/compute/v1/internal/common_014.pb.h" -#include "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_021.pb.h" -#include "google/cloud/compute/v1/internal/common_031.pb.h" -#include "google/cloud/compute/v1/internal/common_102.pb.h" -#include "google/cloud/compute/v1/internal/common_107.pb.h" -#include "google/cloud/compute/v1/internal/common_108.pb.h" -#include "google/cloud/compute/v1/internal/common_122.pb.h" -#include "google/cloud/compute/v1/internal/common_145.pb.h" +#include "google/cloud/compute/v1/internal/common_009.pb.h" +#include "google/cloud/compute/v1/internal/common_017.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_028.pb.h" +#include "google/cloud/compute/v1/internal/common_040.pb.h" +#include "google/cloud/compute/v1/internal/common_119.pb.h" +#include "google/cloud/compute/v1/internal/common_125.pb.h" +#include "google/cloud/compute/v1/internal/common_126.pb.h" +#include "google/cloud/compute/v1/internal/common_146.pb.h" +#include "google/cloud/compute/v1/internal/common_171.pb.h" // 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_aggregation_policies/v1/internal/region_health_aggregation_policies_option_defaults.cc b/google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_option_defaults.cc new file mode 100644 index 0000000000000..b330ae9d84727 --- /dev/null +++ b/google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_option_defaults.cc @@ -0,0 +1,96 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies.proto + +#include "google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_option_defaults.h" +#include "google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies_connection.h" +#include "google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies_options.h" +#include "google/cloud/internal/populate_common_options.h" +#include "google/cloud/internal/populate_grpc_options.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_health_aggregation_policies_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +namespace { +auto constexpr kBackoffScaling = 2.0; +} // namespace + +Options RegionHealthAggregationPoliciesDefaultOptions(Options options) { + options = internal::PopulateCommonOptions( + std::move(options), + "GOOGLE_CLOUD_CPP_REGION_HEALTH_AGGREGATION_POLICIES_ENDPOINT", "", + "GOOGLE_CLOUD_CPP_REGION_HEALTH_AGGREGATION_POLICIES_AUTHORITY", + "compute.googleapis.com"); + options = internal::PopulateGrpcOptions(std::move(options)); + if (!options.has()) { + options.set( + compute_region_health_aggregation_policies_v1:: + RegionHealthAggregationPoliciesLimitedTimeRetryPolicy( + std::chrono::minutes(10)) + .clone()); + } + if (!options.has()) { + options.set( + ExponentialBackoffPolicy( + std::chrono::seconds(0), std::chrono::seconds(1), + std::chrono::minutes(5), kBackoffScaling, kBackoffScaling) + .clone()); + } + if (!options.has()) { + options.set( + GenericPollingPolicy< + compute_region_health_aggregation_policies_v1:: + RegionHealthAggregationPoliciesRetryPolicyOption::Type, + compute_region_health_aggregation_policies_v1:: + RegionHealthAggregationPoliciesBackoffPolicyOption::Type>( + options + .get() + ->clone(), + ExponentialBackoffPolicy(std::chrono::seconds(1), + std::chrono::minutes(5), kBackoffScaling) + .clone()) + .clone()); + } + if (!options.has< + compute_region_health_aggregation_policies_v1:: + RegionHealthAggregationPoliciesConnectionIdempotencyPolicyOption>()) { + options.set< + compute_region_health_aggregation_policies_v1:: + RegionHealthAggregationPoliciesConnectionIdempotencyPolicyOption>( + compute_region_health_aggregation_policies_v1:: + MakeDefaultRegionHealthAggregationPoliciesConnectionIdempotencyPolicy()); + } + + return options; +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_health_aggregation_policies_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_option_defaults.h b/google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_option_defaults.h new file mode 100644 index 0000000000000..faf723b16963e --- /dev/null +++ b/google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_option_defaults.h @@ -0,0 +1,38 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_AGGREGATION_POLICIES_V1_INTERNAL_REGION_HEALTH_AGGREGATION_POLICIES_OPTION_DEFAULTS_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_AGGREGATION_POLICIES_V1_INTERNAL_REGION_HEALTH_AGGREGATION_POLICIES_OPTION_DEFAULTS_H + +#include "google/cloud/options.h" +#include "google/cloud/version.h" + +namespace google { +namespace cloud { +namespace compute_region_health_aggregation_policies_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +Options RegionHealthAggregationPoliciesDefaultOptions(Options options); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_health_aggregation_policies_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_AGGREGATION_POLICIES_V1_INTERNAL_REGION_HEALTH_AGGREGATION_POLICIES_OPTION_DEFAULTS_H diff --git a/google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_rest_connection_impl.cc b/google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_rest_connection_impl.cc new file mode 100644 index 0000000000000..6fd4fa4425b94 --- /dev/null +++ b/google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_rest_connection_impl.cc @@ -0,0 +1,589 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies.proto + +#include "google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_rest_connection_impl.h" +#include "google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_rest_stub_factory.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/internal/async_rest_long_running_operation_custom.h" +#include "google/cloud/internal/extract_long_running_result.h" +#include "google/cloud/internal/pagination_range.h" +#include "google/cloud/internal/rest_lro_helpers.h" +#include "google/cloud/internal/rest_retry_loop.h" +#include "google/cloud/rest_options.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_health_aggregation_policies_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +RegionHealthAggregationPoliciesRestConnectionImpl:: + RegionHealthAggregationPoliciesRestConnectionImpl( + std::unique_ptr background, + std::shared_ptr + stub, + Options options) + : background_(std::move(background)), + stub_(std::move(stub)), + options_(internal::MergeOptions( + std::move(options), + RegionHealthAggregationPoliciesConnection::options())) {} + +StreamRange> +RegionHealthAggregationPoliciesRestConnectionImpl:: + AggregatedListRegionHealthAggregationPolicies( + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + AggregatedListRegionHealthAggregationPoliciesRequest request) { + request.clear_page_token(); + auto current = google::cloud::internal::SaveCurrentOptions(); + auto idempotency = + idempotency_policy(*current) + ->AggregatedListRegionHealthAggregationPolicies(request); + char const* function_name = __func__; + return google::cloud::internal::MakePaginationRange>>( + current, std::move(request), + [idempotency, function_name, stub = stub_, + retry = std::shared_ptr( + retry_policy(*current)), + backoff = std::shared_ptr(backoff_policy(*current))]( + Options const& options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + AggregatedListRegionHealthAggregationPoliciesRequest const& r) { + return google::cloud::rest_internal::RestRetryLoop( + retry->clone(), backoff->clone(), idempotency, + [stub]( + rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute:: + region_health_aggregation_policies::v1:: + AggregatedListRegionHealthAggregationPoliciesRequest const& + request) { + return stub->AggregatedListRegionHealthAggregationPolicies( + rest_context, options, request); + }, + options, r, function_name); + }, + [](google::cloud::cpp::compute::v1::HealthAggregationPolicyAggregatedList + r) { + std::vector< + std::pair> + result(r.items().size()); + auto& messages = *r.mutable_items(); + std::move(messages.begin(), messages.end(), result.begin()); + return result; + }); +} + +future> +RegionHealthAggregationPoliciesRestConnectionImpl:: + DeleteHealthAggregationPolicy( + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + DeleteHealthAggregationPolicyRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::region_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, request, + [stub = stub_]( + CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + DeleteHealthAggregationPolicyRequest const& request) { + return stub->AsyncDeleteHealthAggregationPolicy( + cq, std::move(context), std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->DeleteHealthAggregationPolicy(request), + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [request](std::string const& op, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest& r) { + r.set_project(request.project()); + r.set_region(request.region()); + r.set_operation(op); + }, + [request](std::string const& op, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest& r) { + r.set_project(request.project()); + r.set_region(request.region()); + r.set_operation(op); + }); +} + +StatusOr +RegionHealthAggregationPoliciesRestConnectionImpl:: + DeleteHealthAggregationPolicy( + NoAwaitTag, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + DeleteHealthAggregationPolicyRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->DeleteHealthAggregationPolicy(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_health_aggregation_policies:: + v1::DeleteHealthAggregationPolicyRequest const& request) { + return stub_->DeleteHealthAggregationPolicy(rest_context, options, + request); + }, + *current, request, __func__); +} + +future> +RegionHealthAggregationPoliciesRestConnectionImpl:: + DeleteHealthAggregationPolicy( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestAwaitLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::region_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, operation, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [operation](std::string const&, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_region(info.region); + r.set_operation(info.operation); + }, + [operation](std::string const&, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_region(info.region); + r.set_operation(info.operation); + }); +} + +StatusOr +RegionHealthAggregationPoliciesRestConnectionImpl::GetHealthAggregationPolicy( + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + GetHealthAggregationPolicyRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->GetHealthAggregationPolicy(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_health_aggregation_policies:: + v1::GetHealthAggregationPolicyRequest const& request) { + return stub_->GetHealthAggregationPolicy(rest_context, options, + request); + }, + *current, request, __func__); +} + +future> +RegionHealthAggregationPoliciesRestConnectionImpl:: + InsertHealthAggregationPolicy( + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + InsertHealthAggregationPolicyRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::region_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, request, + [stub = stub_]( + CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + InsertHealthAggregationPolicyRequest const& request) { + return stub->AsyncInsertHealthAggregationPolicy( + cq, std::move(context), std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->InsertHealthAggregationPolicy(request), + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [request](std::string const& op, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest& r) { + r.set_project(request.project()); + r.set_region(request.region()); + r.set_operation(op); + }, + [request](std::string const& op, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest& r) { + r.set_project(request.project()); + r.set_region(request.region()); + r.set_operation(op); + }); +} + +StatusOr +RegionHealthAggregationPoliciesRestConnectionImpl:: + InsertHealthAggregationPolicy( + NoAwaitTag, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + InsertHealthAggregationPolicyRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->InsertHealthAggregationPolicy(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_health_aggregation_policies:: + v1::InsertHealthAggregationPolicyRequest const& request) { + return stub_->InsertHealthAggregationPolicy(rest_context, options, + request); + }, + *current, request, __func__); +} + +future> +RegionHealthAggregationPoliciesRestConnectionImpl:: + InsertHealthAggregationPolicy( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestAwaitLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::region_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, operation, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [operation](std::string const&, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_region(info.region); + r.set_operation(info.operation); + }, + [operation](std::string const&, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_region(info.region); + r.set_operation(info.operation); + }); +} + +StreamRange +RegionHealthAggregationPoliciesRestConnectionImpl:: + ListRegionHealthAggregationPolicies( + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + ListRegionHealthAggregationPoliciesRequest request) { + request.clear_page_token(); + auto current = google::cloud::internal::SaveCurrentOptions(); + auto idempotency = + idempotency_policy(*current)->ListRegionHealthAggregationPolicies( + request); + char const* function_name = __func__; + return google::cloud::internal::MakePaginationRange< + StreamRange>( + current, std::move(request), + [idempotency, function_name, stub = stub_, + retry = std::shared_ptr( + retry_policy(*current)), + backoff = std::shared_ptr(backoff_policy(*current))]( + Options const& options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + ListRegionHealthAggregationPoliciesRequest const& r) { + return google::cloud::rest_internal::RestRetryLoop( + retry->clone(), backoff->clone(), idempotency, + [stub](rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute:: + region_health_aggregation_policies::v1:: + ListRegionHealthAggregationPoliciesRequest const& + request) { + return stub->ListRegionHealthAggregationPolicies( + rest_context, options, request); + }, + options, r, function_name); + }, + [](google::cloud::cpp::compute::v1::HealthAggregationPolicyList r) { + std::vector + result(r.items().size()); + auto& messages = *r.mutable_items(); + std::move(messages.begin(), messages.end(), result.begin()); + return result; + }); +} + +future> +RegionHealthAggregationPoliciesRestConnectionImpl::PatchHealthAggregationPolicy( + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + PatchHealthAggregationPolicyRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::region_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, request, + [stub = stub_]( + CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + PatchHealthAggregationPolicyRequest const& request) { + return stub->AsyncPatchHealthAggregationPolicy( + cq, std::move(context), std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->PatchHealthAggregationPolicy(request), + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [request](std::string const& op, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest& r) { + r.set_project(request.project()); + r.set_region(request.region()); + r.set_operation(op); + }, + [request](std::string const& op, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest& r) { + r.set_project(request.project()); + r.set_region(request.region()); + r.set_operation(op); + }); +} + +StatusOr +RegionHealthAggregationPoliciesRestConnectionImpl::PatchHealthAggregationPolicy( + NoAwaitTag, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + PatchHealthAggregationPolicyRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->PatchHealthAggregationPolicy(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_health_aggregation_policies:: + v1::PatchHealthAggregationPolicyRequest const& request) { + return stub_->PatchHealthAggregationPolicy(rest_context, options, + request); + }, + *current, request, __func__); +} + +future> +RegionHealthAggregationPoliciesRestConnectionImpl::PatchHealthAggregationPolicy( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestAwaitLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::region_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, operation, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [operation](std::string const&, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_region(info.region); + r.set_operation(info.operation); + }, + [operation](std::string const&, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_region(info.region); + r.set_operation(info.operation); + }); +} + +StatusOr +RegionHealthAggregationPoliciesRestConnectionImpl::TestIamPermissions( + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + TestIamPermissionsRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->TestIamPermissions(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_health_aggregation_policies:: + v1::TestIamPermissionsRequest const& request) { + return stub_->TestIamPermissions(rest_context, options, request); + }, + *current, request, __func__); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_health_aggregation_policies_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_rest_connection_impl.h b/google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_rest_connection_impl.h new file mode 100644 index 0000000000000..6504558af8874 --- /dev/null +++ b/google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_rest_connection_impl.h @@ -0,0 +1,171 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_AGGREGATION_POLICIES_V1_INTERNAL_REGION_HEALTH_AGGREGATION_POLICIES_REST_CONNECTION_IMPL_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_AGGREGATION_POLICIES_V1_INTERNAL_REGION_HEALTH_AGGREGATION_POLICIES_REST_CONNECTION_IMPL_H + +#include "google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_rest_stub.h" +#include "google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_retry_traits.h" +#include "google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies_connection.h" +#include "google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies_connection_idempotency_policy.h" +#include "google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies_options.h" +#include "google/cloud/compute/region_operations/v1/region_operations.pb.h" +#include "google/cloud/background_threads.h" +#include "google/cloud/backoff_policy.h" +#include "google/cloud/options.h" +#include "google/cloud/status_or.h" +#include "google/cloud/stream_range.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_health_aggregation_policies_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class RegionHealthAggregationPoliciesRestConnectionImpl + : public compute_region_health_aggregation_policies_v1:: + RegionHealthAggregationPoliciesConnection { + public: + ~RegionHealthAggregationPoliciesRestConnectionImpl() override = default; + + RegionHealthAggregationPoliciesRestConnectionImpl( + std::unique_ptr background, + std::shared_ptr + stub, + Options options); + + Options options() override { return options_; } + + StreamRange> + AggregatedListRegionHealthAggregationPolicies( + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + AggregatedListRegionHealthAggregationPoliciesRequest request) + override; + + future> + DeleteHealthAggregationPolicy( + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + DeleteHealthAggregationPolicyRequest const& request) override; + + StatusOr + DeleteHealthAggregationPolicy( + NoAwaitTag, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + DeleteHealthAggregationPolicyRequest const& request) override; + + future> + DeleteHealthAggregationPolicy( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + StatusOr + GetHealthAggregationPolicy( + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + GetHealthAggregationPolicyRequest const& request) override; + + future> + InsertHealthAggregationPolicy( + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + InsertHealthAggregationPolicyRequest const& request) override; + + StatusOr + InsertHealthAggregationPolicy( + NoAwaitTag, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + InsertHealthAggregationPolicyRequest const& request) override; + + future> + InsertHealthAggregationPolicy( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + StreamRange + ListRegionHealthAggregationPolicies( + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + ListRegionHealthAggregationPoliciesRequest request) override; + + future> + PatchHealthAggregationPolicy( + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + PatchHealthAggregationPolicyRequest const& request) override; + + StatusOr + PatchHealthAggregationPolicy( + NoAwaitTag, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + PatchHealthAggregationPolicyRequest const& request) override; + + future> + PatchHealthAggregationPolicy( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + StatusOr + TestIamPermissions( + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + TestIamPermissionsRequest const& request) override; + + private: + static std::unique_ptr + retry_policy(Options const& options) { + return options + .get() + ->clone(); + } + + static std::unique_ptr backoff_policy(Options const& options) { + return options + .get() + ->clone(); + } + + static std::unique_ptr< + compute_region_health_aggregation_policies_v1:: + RegionHealthAggregationPoliciesConnectionIdempotencyPolicy> + idempotency_policy(Options const& options) { + return options + .get< + compute_region_health_aggregation_policies_v1:: + RegionHealthAggregationPoliciesConnectionIdempotencyPolicyOption>() + ->clone(); + } + + static std::unique_ptr polling_policy(Options const& options) { + return options + .get() + ->clone(); + } + + std::unique_ptr background_; + std::shared_ptr + stub_; + Options options_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_health_aggregation_policies_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_AGGREGATION_POLICIES_V1_INTERNAL_REGION_HEALTH_AGGREGATION_POLICIES_REST_CONNECTION_IMPL_H diff --git a/google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_rest_logging_decorator.cc b/google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_rest_logging_decorator.cc new file mode 100644 index 0000000000000..f4c65d803d395 --- /dev/null +++ b/google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_rest_logging_decorator.cc @@ -0,0 +1,249 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies.proto + +#include "google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_rest_logging_decorator.h" +#include "google/cloud/internal/log_wrapper.h" +#include "google/cloud/status_or.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_health_aggregation_policies_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +RegionHealthAggregationPoliciesRestLogging:: + RegionHealthAggregationPoliciesRestLogging( + std::shared_ptr child, + TracingOptions tracing_options, std::set components) + : child_(std::move(child)), + tracing_options_(std::move(tracing_options)), + components_(std::move(components)) {} + +StatusOr +RegionHealthAggregationPoliciesRestLogging:: + AggregatedListRegionHealthAggregationPolicies( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + AggregatedListRegionHealthAggregationPoliciesRequest const& + request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_health_aggregation_policies:: + v1::AggregatedListRegionHealthAggregationPoliciesRequest const& + request) { + return child_->AggregatedListRegionHealthAggregationPolicies( + rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +future> +RegionHealthAggregationPoliciesRestLogging::AsyncDeleteHealthAggregationPolicy( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + DeleteHealthAggregationPolicyRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_health_aggregation_policies:: + v1::DeleteHealthAggregationPolicyRequest const& request) { + return child_->AsyncDeleteHealthAggregationPolicy( + cq, std::move(rest_context), std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +StatusOr +RegionHealthAggregationPoliciesRestLogging::DeleteHealthAggregationPolicy( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + DeleteHealthAggregationPolicyRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_health_aggregation_policies:: + v1::DeleteHealthAggregationPolicyRequest const& request) { + return child_->DeleteHealthAggregationPolicy(rest_context, options, + request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +StatusOr +RegionHealthAggregationPoliciesRestLogging::GetHealthAggregationPolicy( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + GetHealthAggregationPolicyRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_health_aggregation_policies:: + v1::GetHealthAggregationPolicyRequest const& request) { + return child_->GetHealthAggregationPolicy(rest_context, options, + request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +future> +RegionHealthAggregationPoliciesRestLogging::AsyncInsertHealthAggregationPolicy( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + InsertHealthAggregationPolicyRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_health_aggregation_policies:: + v1::InsertHealthAggregationPolicyRequest const& request) { + return child_->AsyncInsertHealthAggregationPolicy( + cq, std::move(rest_context), std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +StatusOr +RegionHealthAggregationPoliciesRestLogging::InsertHealthAggregationPolicy( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + InsertHealthAggregationPolicyRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_health_aggregation_policies:: + v1::InsertHealthAggregationPolicyRequest const& request) { + return child_->InsertHealthAggregationPolicy(rest_context, options, + request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +StatusOr +RegionHealthAggregationPoliciesRestLogging::ListRegionHealthAggregationPolicies( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + ListRegionHealthAggregationPoliciesRequest const& request) { + return google::cloud::internal::LogWrapper( + [this]( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + ListRegionHealthAggregationPoliciesRequest const& request) { + return child_->ListRegionHealthAggregationPolicies(rest_context, + options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +future> +RegionHealthAggregationPoliciesRestLogging::AsyncPatchHealthAggregationPolicy( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + PatchHealthAggregationPolicyRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_health_aggregation_policies:: + v1::PatchHealthAggregationPolicyRequest const& request) { + return child_->AsyncPatchHealthAggregationPolicy( + cq, std::move(rest_context), std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +StatusOr +RegionHealthAggregationPoliciesRestLogging::PatchHealthAggregationPolicy( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + PatchHealthAggregationPolicyRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_health_aggregation_policies:: + v1::PatchHealthAggregationPolicyRequest const& request) { + return child_->PatchHealthAggregationPolicy(rest_context, options, + request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +StatusOr +RegionHealthAggregationPoliciesRestLogging::TestIamPermissions( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + TestIamPermissionsRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_health_aggregation_policies:: + v1::TestIamPermissionsRequest const& request) { + return child_->TestIamPermissions(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +future> +RegionHealthAggregationPoliciesRestLogging::AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + return child_->AsyncGetOperation(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +future RegionHealthAggregationPoliciesRestLogging::AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + return child_->AsyncCancelOperation(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_health_aggregation_policies_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_rest_logging_decorator.h b/google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_rest_logging_decorator.h new file mode 100644 index 0000000000000..33da9befd3ddd --- /dev/null +++ b/google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_rest_logging_decorator.h @@ -0,0 +1,148 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_AGGREGATION_POLICIES_V1_INTERNAL_REGION_HEALTH_AGGREGATION_POLICIES_REST_LOGGING_DECORATOR_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_AGGREGATION_POLICIES_V1_INTERNAL_REGION_HEALTH_AGGREGATION_POLICIES_REST_LOGGING_DECORATOR_H + +#include "google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_rest_stub.h" +#include "google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies.pb.h" +#include "google/cloud/compute/region_operations/v1/region_operations.pb.h" +#include "google/cloud/future.h" +#include "google/cloud/internal/rest_context.h" +#include "google/cloud/tracing_options.h" +#include "google/cloud/version.h" +#include +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_health_aggregation_policies_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class RegionHealthAggregationPoliciesRestLogging + : public RegionHealthAggregationPoliciesRestStub { + public: + ~RegionHealthAggregationPoliciesRestLogging() override = default; + RegionHealthAggregationPoliciesRestLogging( + std::shared_ptr child, + TracingOptions tracing_options, std::set components); + + StatusOr< + google::cloud::cpp::compute::v1::HealthAggregationPolicyAggregatedList> + AggregatedListRegionHealthAggregationPolicies( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + AggregatedListRegionHealthAggregationPoliciesRequest const& request) + override; + + future> + AsyncDeleteHealthAggregationPolicy( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + DeleteHealthAggregationPolicyRequest const& request) override; + + StatusOr + DeleteHealthAggregationPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + DeleteHealthAggregationPolicyRequest const& request) override; + + StatusOr + GetHealthAggregationPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + GetHealthAggregationPolicyRequest const& request) override; + + future> + AsyncInsertHealthAggregationPolicy( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + InsertHealthAggregationPolicyRequest const& request) override; + + StatusOr + InsertHealthAggregationPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + InsertHealthAggregationPolicyRequest const& request) override; + + StatusOr + ListRegionHealthAggregationPolicies( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + ListRegionHealthAggregationPoliciesRequest const& request) override; + + future> + AsyncPatchHealthAggregationPolicy( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + PatchHealthAggregationPolicyRequest const& request) override; + + StatusOr + PatchHealthAggregationPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + PatchHealthAggregationPolicyRequest const& request) override; + + StatusOr + TestIamPermissions( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + TestIamPermissionsRequest const& request) override; + + future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) override; + + future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) override; + + private: + std::shared_ptr child_; + TracingOptions tracing_options_; + std::set components_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_health_aggregation_policies_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_AGGREGATION_POLICIES_V1_INTERNAL_REGION_HEALTH_AGGREGATION_POLICIES_REST_LOGGING_DECORATOR_H diff --git a/google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_rest_metadata_decorator.cc b/google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_rest_metadata_decorator.cc new file mode 100644 index 0000000000000..b662aae18f77e --- /dev/null +++ b/google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_rest_metadata_decorator.cc @@ -0,0 +1,182 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies.proto + +#include "google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_rest_metadata_decorator.h" +#include "google/cloud/internal/api_client_header.h" +#include "google/cloud/internal/rest_set_metadata.h" +#include "google/cloud/status_or.h" +#include "absl/strings/str_cat.h" +#include "absl/strings/str_format.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_health_aggregation_policies_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +RegionHealthAggregationPoliciesRestMetadata:: + RegionHealthAggregationPoliciesRestMetadata( + std::shared_ptr child, + std::string api_client_header) + : child_(std::move(child)), + api_client_header_( + api_client_header.empty() + ? google::cloud::internal::GeneratedLibClientHeader() + : std::move(api_client_header)) {} + +StatusOr +RegionHealthAggregationPoliciesRestMetadata:: + AggregatedListRegionHealthAggregationPolicies( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + AggregatedListRegionHealthAggregationPoliciesRequest const& + request) { + SetMetadata(rest_context, options); + return child_->AggregatedListRegionHealthAggregationPolicies( + rest_context, options, request); +} + +future> +RegionHealthAggregationPoliciesRestMetadata::AsyncDeleteHealthAggregationPolicy( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + DeleteHealthAggregationPolicyRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncDeleteHealthAggregationPolicy( + cq, std::move(rest_context), std::move(options), request); +} + +StatusOr +RegionHealthAggregationPoliciesRestMetadata::DeleteHealthAggregationPolicy( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + DeleteHealthAggregationPolicyRequest const& request) { + SetMetadata(rest_context, options); + return child_->DeleteHealthAggregationPolicy(rest_context, options, request); +} + +StatusOr +RegionHealthAggregationPoliciesRestMetadata::GetHealthAggregationPolicy( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + GetHealthAggregationPolicyRequest const& request) { + SetMetadata(rest_context, options); + return child_->GetHealthAggregationPolicy(rest_context, options, request); +} + +future> +RegionHealthAggregationPoliciesRestMetadata::AsyncInsertHealthAggregationPolicy( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + InsertHealthAggregationPolicyRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncInsertHealthAggregationPolicy( + cq, std::move(rest_context), std::move(options), request); +} + +StatusOr +RegionHealthAggregationPoliciesRestMetadata::InsertHealthAggregationPolicy( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + InsertHealthAggregationPolicyRequest const& request) { + SetMetadata(rest_context, options); + return child_->InsertHealthAggregationPolicy(rest_context, options, request); +} + +StatusOr +RegionHealthAggregationPoliciesRestMetadata:: + ListRegionHealthAggregationPolicies( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + ListRegionHealthAggregationPoliciesRequest const& request) { + SetMetadata(rest_context, options); + return child_->ListRegionHealthAggregationPolicies(rest_context, options, + request); +} + +future> +RegionHealthAggregationPoliciesRestMetadata::AsyncPatchHealthAggregationPolicy( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + PatchHealthAggregationPolicyRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncPatchHealthAggregationPolicy(cq, std::move(rest_context), + std::move(options), request); +} + +StatusOr +RegionHealthAggregationPoliciesRestMetadata::PatchHealthAggregationPolicy( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + PatchHealthAggregationPolicyRequest const& request) { + SetMetadata(rest_context, options); + return child_->PatchHealthAggregationPolicy(rest_context, options, request); +} + +StatusOr +RegionHealthAggregationPoliciesRestMetadata::TestIamPermissions( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + TestIamPermissionsRequest const& request) { + SetMetadata(rest_context, options); + return child_->TestIamPermissions(rest_context, options, request); +} + +future> +RegionHealthAggregationPoliciesRestMetadata::AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncGetOperation(cq, std::move(rest_context), + std::move(options), request); +} + +future +RegionHealthAggregationPoliciesRestMetadata::AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncCancelOperation(cq, std::move(rest_context), + std::move(options), request); +} + +void RegionHealthAggregationPoliciesRestMetadata::SetMetadata( + rest_internal::RestContext& rest_context, Options const& options, + std::vector const& params) { + google::cloud::rest_internal::SetMetadata(rest_context, options, params, + api_client_header_); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_health_aggregation_policies_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_rest_metadata_decorator.h b/google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_rest_metadata_decorator.h new file mode 100644 index 0000000000000..f1ddab239a758 --- /dev/null +++ b/google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_rest_metadata_decorator.h @@ -0,0 +1,149 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_AGGREGATION_POLICIES_V1_INTERNAL_REGION_HEALTH_AGGREGATION_POLICIES_REST_METADATA_DECORATOR_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_AGGREGATION_POLICIES_V1_INTERNAL_REGION_HEALTH_AGGREGATION_POLICIES_REST_METADATA_DECORATOR_H + +#include "google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_rest_stub.h" +#include "google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies.pb.h" +#include "google/cloud/compute/region_operations/v1/region_operations.pb.h" +#include "google/cloud/future.h" +#include "google/cloud/rest_options.h" +#include "google/cloud/version.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_health_aggregation_policies_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class RegionHealthAggregationPoliciesRestMetadata + : public RegionHealthAggregationPoliciesRestStub { + public: + ~RegionHealthAggregationPoliciesRestMetadata() override = default; + explicit RegionHealthAggregationPoliciesRestMetadata( + std::shared_ptr child, + std::string api_client_header = ""); + + StatusOr< + google::cloud::cpp::compute::v1::HealthAggregationPolicyAggregatedList> + AggregatedListRegionHealthAggregationPolicies( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + AggregatedListRegionHealthAggregationPoliciesRequest const& request) + override; + + google::cloud::future> + AsyncDeleteHealthAggregationPolicy( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + DeleteHealthAggregationPolicyRequest const& request) override; + + StatusOr + DeleteHealthAggregationPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + DeleteHealthAggregationPolicyRequest const& request) override; + + StatusOr + GetHealthAggregationPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + GetHealthAggregationPolicyRequest const& request) override; + + google::cloud::future> + AsyncInsertHealthAggregationPolicy( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + InsertHealthAggregationPolicyRequest const& request) override; + + StatusOr + InsertHealthAggregationPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + InsertHealthAggregationPolicyRequest const& request) override; + + StatusOr + ListRegionHealthAggregationPolicies( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + ListRegionHealthAggregationPoliciesRequest const& request) override; + + google::cloud::future> + AsyncPatchHealthAggregationPolicy( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + PatchHealthAggregationPolicyRequest const& request) override; + + StatusOr + PatchHealthAggregationPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + PatchHealthAggregationPolicyRequest const& request) override; + + StatusOr + TestIamPermissions( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + TestIamPermissionsRequest const& request) override; + + google::cloud::future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) override; + + google::cloud::future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) override; + + private: + void SetMetadata(rest_internal::RestContext& rest_context, + Options const& options, + std::vector const& params = {}); + + std::shared_ptr child_; + std::string api_client_header_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_health_aggregation_policies_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_AGGREGATION_POLICIES_V1_INTERNAL_REGION_HEALTH_AGGREGATION_POLICIES_REST_METADATA_DECORATOR_H diff --git a/google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_rest_stub.cc b/google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_rest_stub.cc new file mode 100644 index 0000000000000..ec43b0d769129 --- /dev/null +++ b/google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_rest_stub.cc @@ -0,0 +1,392 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies.proto + +#include "google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_rest_stub.h" +#include "google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies.pb.h" +#include "google/cloud/compute/region_operations/v1/region_operations.pb.h" +#include "google/cloud/common_options.h" +#include "google/cloud/internal/rest_stub_helpers.h" +#include "google/cloud/status_or.h" +#include "absl/strings/str_cat.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_health_aggregation_policies_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +DefaultRegionHealthAggregationPoliciesRestStub:: + DefaultRegionHealthAggregationPoliciesRestStub(Options options) + : service_(rest_internal::MakePooledRestClient( + options.get(), options)), + operations_(rest_internal::MakePooledRestClient( + options.get(), options)), + options_(std::move(options)) {} + +DefaultRegionHealthAggregationPoliciesRestStub:: + DefaultRegionHealthAggregationPoliciesRestStub( + std::shared_ptr service, + std::shared_ptr operations, Options options) + : service_(std::move(service)), + operations_(std::move(operations)), + options_(std::move(options)) {} + +StatusOr +DefaultRegionHealthAggregationPoliciesRestStub:: + AggregatedListRegionHealthAggregationPolicies( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + AggregatedListRegionHealthAggregationPoliciesRequest const& + request) { + std::vector> query_params; + query_params.push_back({"filter", request.filter()}); + query_params.push_back( + {"include_all_scopes", (request.include_all_scopes() ? "1" : "0")}); + query_params.push_back( + {"max_results", std::to_string(request.max_results())}); + query_params.push_back({"order_by", request.order_by()}); + query_params.push_back({"page_token", request.page_token()}); + query_params.push_back({"return_partial_success", + (request.return_partial_success() ? "1" : "0")}); + query_params.push_back( + {"service_project_number", request.service_project_number()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Get< + google::cloud::cpp::compute::v1::HealthAggregationPolicyAggregatedList>( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "aggregated", "/", + "healthAggregationPolicies"), + std::move(query_params)); +} + +future> +DefaultRegionHealthAggregationPoliciesRestStub:: + AsyncDeleteHealthAggregationPolicy( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + DeleteHealthAggregationPolicyRequest const& request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto service, auto request, auto rest_context, auto options) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + p.set_value( + rest_internal::Delete( + *service, *rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", *options), + "/", "projects", "/", request.project(), "/", + "regions", "/", request.region(), "/", + "healthAggregationPolicies", "/", + request.health_aggregation_policy()), + std::move(query_params))); + }, + std::move(p), + service_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +StatusOr +DefaultRegionHealthAggregationPoliciesRestStub::DeleteHealthAggregationPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + DeleteHealthAggregationPolicyRequest const& request) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Delete( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "regions", "/", + request.region(), "/", "healthAggregationPolicies", "/", + request.health_aggregation_policy()), + std::move(query_params)); +} + +StatusOr +DefaultRegionHealthAggregationPoliciesRestStub::GetHealthAggregationPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + GetHealthAggregationPolicyRequest const& request) { + std::vector> query_params; + return rest_internal::Get< + google::cloud::cpp::compute::v1::HealthAggregationPolicy>( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "regions", "/", + request.region(), "/", "healthAggregationPolicies", "/", + request.health_aggregation_policy()), + std::move(query_params)); +} + +future> +DefaultRegionHealthAggregationPoliciesRestStub:: + AsyncInsertHealthAggregationPolicy( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + InsertHealthAggregationPolicyRequest const& request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto service, auto request, auto rest_context, auto options) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + p.set_value( + rest_internal::Post( + *service, *rest_context, + request.health_aggregation_policy_resource(), false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", *options), + "/", "projects", "/", request.project(), "/", + "regions", "/", request.region(), "/", + "healthAggregationPolicies"), + std::move(query_params))); + }, + std::move(p), + service_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +StatusOr +DefaultRegionHealthAggregationPoliciesRestStub::InsertHealthAggregationPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + InsertHealthAggregationPolicyRequest const& request) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Post( + *service_, rest_context, request.health_aggregation_policy_resource(), + false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "regions", "/", + request.region(), "/", "healthAggregationPolicies"), + std::move(query_params)); +} + +StatusOr +DefaultRegionHealthAggregationPoliciesRestStub:: + ListRegionHealthAggregationPolicies( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + ListRegionHealthAggregationPoliciesRequest const& request) { + std::vector> query_params; + query_params.push_back({"filter", request.filter()}); + query_params.push_back( + {"max_results", std::to_string(request.max_results())}); + query_params.push_back({"order_by", request.order_by()}); + query_params.push_back({"page_token", request.page_token()}); + query_params.push_back({"return_partial_success", + (request.return_partial_success() ? "1" : "0")}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Get< + google::cloud::cpp::compute::v1::HealthAggregationPolicyList>( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "regions", "/", + request.region(), "/", "healthAggregationPolicies"), + std::move(query_params)); +} + +future> +DefaultRegionHealthAggregationPoliciesRestStub:: + AsyncPatchHealthAggregationPolicy( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + PatchHealthAggregationPolicyRequest const& request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto service, auto request, auto rest_context, auto options) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + p.set_value( + rest_internal::Patch( + *service, *rest_context, + request.health_aggregation_policy_resource(), false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", *options), + "/", "projects", "/", request.project(), "/", + "regions", "/", request.region(), "/", + "healthAggregationPolicies", "/", + request.health_aggregation_policy()), + std::move(query_params))); + }, + std::move(p), + service_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +StatusOr +DefaultRegionHealthAggregationPoliciesRestStub::PatchHealthAggregationPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + PatchHealthAggregationPolicyRequest const& request) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Patch( + *service_, rest_context, request.health_aggregation_policy_resource(), + false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "regions", "/", + request.region(), "/", "healthAggregationPolicies", "/", + request.health_aggregation_policy()), + std::move(query_params)); +} + +StatusOr +DefaultRegionHealthAggregationPoliciesRestStub::TestIamPermissions( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + TestIamPermissionsRequest const& request) { + std::vector> query_params; + return rest_internal::Post< + google::cloud::cpp::compute::v1::TestPermissionsResponse>( + *service_, rest_context, request.test_permissions_request_resource(), + false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "regions", "/", + request.region(), "/", "healthAggregationPolicies", "/", + request.resource(), "/", "testIamPermissions"), + std::move(query_params)); +} + +future> +DefaultRegionHealthAggregationPoliciesRestStub::AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto operations, auto request, auto rest_context, + auto options) { + p.set_value( + rest_internal::Get( + *operations, *rest_context, request, false, + absl::StrCat("/compute/", + rest_internal::DetermineApiVersion("v1", *options), + "/projects/", request.project(), "/regions/", + request.region(), "/operations/", + request.operation()))); + }, + std::move(p), + operations_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +future +DefaultRegionHealthAggregationPoliciesRestStub::AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + promise> p; + future> f = p.get_future(); + std::thread t{ + [](auto p, auto operations, auto request, auto rest_context, + auto options) { + p.set_value(rest_internal::Post( + *operations, *rest_context, request, false, + absl::StrCat( + "/compute/", rest_internal::DetermineApiVersion("v1", *options), + "/projects/", request.project(), "/regions/", request.region(), + "/operations/", request.operation()))); + }, + std::move(p), + operations_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get().status(); + }); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_health_aggregation_policies_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_rest_stub.h b/google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_rest_stub.h new file mode 100644 index 0000000000000..01fe696d9af3a --- /dev/null +++ b/google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_rest_stub.h @@ -0,0 +1,243 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_AGGREGATION_POLICIES_V1_INTERNAL_REGION_HEALTH_AGGREGATION_POLICIES_REST_STUB_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_AGGREGATION_POLICIES_V1_INTERNAL_REGION_HEALTH_AGGREGATION_POLICIES_REST_STUB_H + +#include "google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies.pb.h" +#include "google/cloud/compute/region_operations/v1/region_operations.pb.h" +#include "google/cloud/completion_queue.h" +#include "google/cloud/internal/rest_client.h" +#include "google/cloud/internal/rest_context.h" +#include "google/cloud/status_or.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_health_aggregation_policies_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class RegionHealthAggregationPoliciesRestStub { + public: + virtual ~RegionHealthAggregationPoliciesRestStub() = default; + + virtual StatusOr< + google::cloud::cpp::compute::v1::HealthAggregationPolicyAggregatedList> + AggregatedListRegionHealthAggregationPolicies( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + AggregatedListRegionHealthAggregationPoliciesRequest const& + request) = 0; + + virtual future> + AsyncDeleteHealthAggregationPolicy( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + DeleteHealthAggregationPolicyRequest const& request) = 0; + + virtual StatusOr + DeleteHealthAggregationPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + DeleteHealthAggregationPolicyRequest const& request) = 0; + + virtual StatusOr + GetHealthAggregationPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + GetHealthAggregationPolicyRequest const& request) = 0; + + virtual future> + AsyncInsertHealthAggregationPolicy( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + InsertHealthAggregationPolicyRequest const& request) = 0; + + virtual StatusOr + InsertHealthAggregationPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + InsertHealthAggregationPolicyRequest const& request) = 0; + + virtual StatusOr + ListRegionHealthAggregationPolicies( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + ListRegionHealthAggregationPoliciesRequest const& request) = 0; + + virtual future> + AsyncPatchHealthAggregationPolicy( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + PatchHealthAggregationPolicyRequest const& request) = 0; + + virtual StatusOr + PatchHealthAggregationPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + PatchHealthAggregationPolicyRequest const& request) = 0; + + virtual StatusOr + TestIamPermissions( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + TestIamPermissionsRequest const& request) = 0; + + virtual future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) = 0; + + virtual future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) = 0; +}; + +class DefaultRegionHealthAggregationPoliciesRestStub + : public RegionHealthAggregationPoliciesRestStub { + public: + ~DefaultRegionHealthAggregationPoliciesRestStub() override = default; + + explicit DefaultRegionHealthAggregationPoliciesRestStub(Options options); + DefaultRegionHealthAggregationPoliciesRestStub( + std::shared_ptr service, + std::shared_ptr operations, Options options); + + StatusOr< + google::cloud::cpp::compute::v1::HealthAggregationPolicyAggregatedList> + AggregatedListRegionHealthAggregationPolicies( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + AggregatedListRegionHealthAggregationPoliciesRequest const& request) + override; + + future> + AsyncDeleteHealthAggregationPolicy( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + DeleteHealthAggregationPolicyRequest const& request) override; + + StatusOr + DeleteHealthAggregationPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + DeleteHealthAggregationPolicyRequest const& request) override; + + StatusOr + GetHealthAggregationPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + GetHealthAggregationPolicyRequest const& request) override; + + future> + AsyncInsertHealthAggregationPolicy( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + InsertHealthAggregationPolicyRequest const& request) override; + + StatusOr + InsertHealthAggregationPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + InsertHealthAggregationPolicyRequest const& request) override; + + StatusOr + ListRegionHealthAggregationPolicies( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + ListRegionHealthAggregationPoliciesRequest const& request) override; + + future> + AsyncPatchHealthAggregationPolicy( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + PatchHealthAggregationPolicyRequest const& request) override; + + StatusOr + PatchHealthAggregationPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + PatchHealthAggregationPolicyRequest const& request) override; + + StatusOr + TestIamPermissions( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + TestIamPermissionsRequest const& request) override; + + future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) override; + + future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) override; + + private: + std::shared_ptr service_; + std::shared_ptr operations_; + Options options_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_health_aggregation_policies_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_AGGREGATION_POLICIES_V1_INTERNAL_REGION_HEALTH_AGGREGATION_POLICIES_REST_STUB_H diff --git a/google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_rest_stub_factory.cc b/google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_rest_stub_factory.cc new file mode 100644 index 0000000000000..fe7ac25b6d9cd --- /dev/null +++ b/google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_rest_stub_factory.cc @@ -0,0 +1,59 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies.proto + +#include "google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_rest_stub_factory.h" +#include "google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_rest_logging_decorator.h" +#include "google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_rest_metadata_decorator.h" +#include "google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_rest_stub.h" +#include "google/cloud/common_options.h" +#include "google/cloud/internal/algorithm.h" +#include "google/cloud/internal/populate_rest_options.h" +#include "google/cloud/log.h" +#include "google/cloud/options.h" +#include "google/cloud/rest_options.h" +#include "absl/strings/match.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_health_aggregation_policies_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +std::shared_ptr +CreateDefaultRegionHealthAggregationPoliciesRestStub(Options const& options) { + auto opts = internal::PopulateRestOptions(options); + std::shared_ptr stub = + std::make_shared( + std::move(opts)); + stub = std::make_shared( + std::move(stub)); + if (internal::Contains(options.get(), "rpc")) { + GCP_LOG(INFO) << "Enabled logging for REST rpc calls"; + stub = std::make_shared( + std::move(stub), options.get(), + options.get()); + } + return stub; +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_health_aggregation_policies_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_rest_stub_factory.h b/google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_rest_stub_factory.h new file mode 100644 index 0000000000000..7a47d34065aae --- /dev/null +++ b/google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_rest_stub_factory.h @@ -0,0 +1,41 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_AGGREGATION_POLICIES_V1_INTERNAL_REGION_HEALTH_AGGREGATION_POLICIES_REST_STUB_FACTORY_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_AGGREGATION_POLICIES_V1_INTERNAL_REGION_HEALTH_AGGREGATION_POLICIES_REST_STUB_FACTORY_H + +#include "google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_rest_stub.h" +#include "google/cloud/options.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_health_aggregation_policies_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +std::shared_ptr +CreateDefaultRegionHealthAggregationPoliciesRestStub(Options const& options); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_health_aggregation_policies_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_AGGREGATION_POLICIES_V1_INTERNAL_REGION_HEALTH_AGGREGATION_POLICIES_REST_STUB_FACTORY_H diff --git a/google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_retry_traits.h b/google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_retry_traits.h new file mode 100644 index 0000000000000..876b5c12ea3d0 --- /dev/null +++ b/google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_retry_traits.h @@ -0,0 +1,44 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_AGGREGATION_POLICIES_V1_INTERNAL_REGION_HEALTH_AGGREGATION_POLICIES_RETRY_TRAITS_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_AGGREGATION_POLICIES_V1_INTERNAL_REGION_HEALTH_AGGREGATION_POLICIES_RETRY_TRAITS_H + +#include "google/cloud/status.h" +#include "google/cloud/version.h" + +namespace google { +namespace cloud { +namespace compute_region_health_aggregation_policies_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/// Define the gRPC status code semantics for retrying requests. +struct RegionHealthAggregationPoliciesRetryTraits { + static bool IsPermanentFailure(google::cloud::Status const& status) { + return status.code() != StatusCode::kOk && + status.code() != StatusCode::kUnavailable; + } +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_health_aggregation_policies_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_AGGREGATION_POLICIES_V1_INTERNAL_REGION_HEALTH_AGGREGATION_POLICIES_RETRY_TRAITS_H diff --git a/google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_sources.cc b/google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_sources.cc new file mode 100644 index 0000000000000..9c79615aa7298 --- /dev/null +++ b/google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_sources.cc @@ -0,0 +1,32 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies.proto + +// NOLINTBEGIN(bugprone-suspicious-include) +#include "google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_option_defaults.cc" +#include "google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_rest_connection_impl.cc" +#include "google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_rest_logging_decorator.cc" +#include "google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_rest_metadata_decorator.cc" +#include "google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_rest_stub.cc" +#include "google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_rest_stub_factory.cc" +#include "google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_tracing_connection.cc" +#include "google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies_client.cc" +#include "google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies_connection.cc" +#include "google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies_connection_idempotency_policy.cc" +#include "google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies_rest_connection.cc" +// NOLINTEND(bugprone-suspicious-include) diff --git a/google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_tracing_connection.cc b/google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_tracing_connection.cc new file mode 100644 index 0000000000000..bad9d53a27806 --- /dev/null +++ b/google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_tracing_connection.cc @@ -0,0 +1,228 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies.proto + +#include "google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_tracing_connection.h" +#include "google/cloud/internal/opentelemetry.h" +#include "google/cloud/internal/traced_stream_range.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_health_aggregation_policies_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +RegionHealthAggregationPoliciesTracingConnection:: + RegionHealthAggregationPoliciesTracingConnection( + std::shared_ptr + child) + : child_(std::move(child)) {} + +StreamRange> +RegionHealthAggregationPoliciesTracingConnection:: + AggregatedListRegionHealthAggregationPolicies( + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + AggregatedListRegionHealthAggregationPoliciesRequest request) { + auto span = internal::MakeSpan( + "compute_region_health_aggregation_policies_v1::" + "RegionHealthAggregationPoliciesConnection::" + "AggregatedListRegionHealthAggregationPolicies"); + internal::OTelScope scope(span); + auto sr = + child_->AggregatedListRegionHealthAggregationPolicies(std::move(request)); + return internal::MakeTracedStreamRange>( + std::move(span), std::move(sr)); +} + +future> +RegionHealthAggregationPoliciesTracingConnection::DeleteHealthAggregationPolicy( + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + DeleteHealthAggregationPolicyRequest const& request) { + auto span = internal::MakeSpan( + "compute_region_health_aggregation_policies_v1::" + "RegionHealthAggregationPoliciesConnection::" + "DeleteHealthAggregationPolicy"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), + child_->DeleteHealthAggregationPolicy(request)); +} + +StatusOr +RegionHealthAggregationPoliciesTracingConnection::DeleteHealthAggregationPolicy( + NoAwaitTag, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + DeleteHealthAggregationPolicyRequest const& request) { + auto span = internal::MakeSpan( + "compute_region_health_aggregation_policies_v1::" + "RegionHealthAggregationPoliciesConnection::" + "DeleteHealthAggregationPolicy"); + opentelemetry::trace::Scope scope(span); + return internal::EndSpan( + *span, child_->DeleteHealthAggregationPolicy(NoAwaitTag{}, request)); +} + +future> +RegionHealthAggregationPoliciesTracingConnection::DeleteHealthAggregationPolicy( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto span = internal::MakeSpan( + "compute_region_health_aggregation_policies_v1::" + "RegionHealthAggregationPoliciesConnection::" + "DeleteHealthAggregationPolicy"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), + child_->DeleteHealthAggregationPolicy(operation)); +} + +StatusOr +RegionHealthAggregationPoliciesTracingConnection::GetHealthAggregationPolicy( + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + GetHealthAggregationPolicyRequest const& request) { + auto span = internal::MakeSpan( + "compute_region_health_aggregation_policies_v1::" + "RegionHealthAggregationPoliciesConnection::GetHealthAggregationPolicy"); + auto scope = opentelemetry::trace::Scope(span); + return internal::EndSpan(*span, child_->GetHealthAggregationPolicy(request)); +} + +future> +RegionHealthAggregationPoliciesTracingConnection::InsertHealthAggregationPolicy( + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + InsertHealthAggregationPolicyRequest const& request) { + auto span = internal::MakeSpan( + "compute_region_health_aggregation_policies_v1::" + "RegionHealthAggregationPoliciesConnection::" + "InsertHealthAggregationPolicy"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), + child_->InsertHealthAggregationPolicy(request)); +} + +StatusOr +RegionHealthAggregationPoliciesTracingConnection::InsertHealthAggregationPolicy( + NoAwaitTag, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + InsertHealthAggregationPolicyRequest const& request) { + auto span = internal::MakeSpan( + "compute_region_health_aggregation_policies_v1::" + "RegionHealthAggregationPoliciesConnection::" + "InsertHealthAggregationPolicy"); + opentelemetry::trace::Scope scope(span); + return internal::EndSpan( + *span, child_->InsertHealthAggregationPolicy(NoAwaitTag{}, request)); +} + +future> +RegionHealthAggregationPoliciesTracingConnection::InsertHealthAggregationPolicy( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto span = internal::MakeSpan( + "compute_region_health_aggregation_policies_v1::" + "RegionHealthAggregationPoliciesConnection::" + "InsertHealthAggregationPolicy"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), + child_->InsertHealthAggregationPolicy(operation)); +} + +StreamRange +RegionHealthAggregationPoliciesTracingConnection:: + ListRegionHealthAggregationPolicies( + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + ListRegionHealthAggregationPoliciesRequest request) { + auto span = internal::MakeSpan( + "compute_region_health_aggregation_policies_v1::" + "RegionHealthAggregationPoliciesConnection::" + "ListRegionHealthAggregationPolicies"); + internal::OTelScope scope(span); + auto sr = child_->ListRegionHealthAggregationPolicies(std::move(request)); + return internal::MakeTracedStreamRange< + google::cloud::cpp::compute::v1::HealthAggregationPolicy>(std::move(span), + std::move(sr)); +} + +future> +RegionHealthAggregationPoliciesTracingConnection::PatchHealthAggregationPolicy( + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + PatchHealthAggregationPolicyRequest const& request) { + auto span = internal::MakeSpan( + "compute_region_health_aggregation_policies_v1::" + "RegionHealthAggregationPoliciesConnection::" + "PatchHealthAggregationPolicy"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), + child_->PatchHealthAggregationPolicy(request)); +} + +StatusOr +RegionHealthAggregationPoliciesTracingConnection::PatchHealthAggregationPolicy( + NoAwaitTag, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + PatchHealthAggregationPolicyRequest const& request) { + auto span = internal::MakeSpan( + "compute_region_health_aggregation_policies_v1::" + "RegionHealthAggregationPoliciesConnection::" + "PatchHealthAggregationPolicy"); + opentelemetry::trace::Scope scope(span); + return internal::EndSpan( + *span, child_->PatchHealthAggregationPolicy(NoAwaitTag{}, request)); +} + +future> +RegionHealthAggregationPoliciesTracingConnection::PatchHealthAggregationPolicy( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto span = internal::MakeSpan( + "compute_region_health_aggregation_policies_v1::" + "RegionHealthAggregationPoliciesConnection::" + "PatchHealthAggregationPolicy"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), + child_->PatchHealthAggregationPolicy(operation)); +} + +StatusOr +RegionHealthAggregationPoliciesTracingConnection::TestIamPermissions( + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + TestIamPermissionsRequest const& request) { + auto span = internal::MakeSpan( + "compute_region_health_aggregation_policies_v1::" + "RegionHealthAggregationPoliciesConnection::TestIamPermissions"); + auto scope = opentelemetry::trace::Scope(span); + return internal::EndSpan(*span, child_->TestIamPermissions(request)); +} + +std::shared_ptr +MakeRegionHealthAggregationPoliciesTracingConnection( + std::shared_ptr + conn) { + if (internal::TracingEnabled(conn->options())) { + conn = std::make_shared( + std::move(conn)); + } + return conn; +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_health_aggregation_policies_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_tracing_connection.h b/google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_tracing_connection.h new file mode 100644 index 0000000000000..e3a62ac42ad9d --- /dev/null +++ b/google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_tracing_connection.h @@ -0,0 +1,136 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_AGGREGATION_POLICIES_V1_INTERNAL_REGION_HEALTH_AGGREGATION_POLICIES_TRACING_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_AGGREGATION_POLICIES_V1_INTERNAL_REGION_HEALTH_AGGREGATION_POLICIES_TRACING_CONNECTION_H + +#include "google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies_connection.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_health_aggregation_policies_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class RegionHealthAggregationPoliciesTracingConnection + : public compute_region_health_aggregation_policies_v1:: + RegionHealthAggregationPoliciesConnection { + public: + ~RegionHealthAggregationPoliciesTracingConnection() override = default; + + explicit RegionHealthAggregationPoliciesTracingConnection( + std::shared_ptr + child); + + Options options() override { return child_->options(); } + + StreamRange> + AggregatedListRegionHealthAggregationPolicies( + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + AggregatedListRegionHealthAggregationPoliciesRequest request) + override; + + future> + DeleteHealthAggregationPolicy( + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + DeleteHealthAggregationPolicyRequest const& request) override; + + StatusOr + DeleteHealthAggregationPolicy( + NoAwaitTag, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + DeleteHealthAggregationPolicyRequest const& request) override; + + future> + DeleteHealthAggregationPolicy( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + StatusOr + GetHealthAggregationPolicy( + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + GetHealthAggregationPolicyRequest const& request) override; + + future> + InsertHealthAggregationPolicy( + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + InsertHealthAggregationPolicyRequest const& request) override; + + StatusOr + InsertHealthAggregationPolicy( + NoAwaitTag, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + InsertHealthAggregationPolicyRequest const& request) override; + + future> + InsertHealthAggregationPolicy( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + StreamRange + ListRegionHealthAggregationPolicies( + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + ListRegionHealthAggregationPoliciesRequest request) override; + + future> + PatchHealthAggregationPolicy( + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + PatchHealthAggregationPolicyRequest const& request) override; + + StatusOr + PatchHealthAggregationPolicy( + NoAwaitTag, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + PatchHealthAggregationPolicyRequest const& request) override; + + future> + PatchHealthAggregationPolicy( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + StatusOr + TestIamPermissions( + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + TestIamPermissionsRequest const& request) override; + + private: + std::shared_ptr + child_; +}; + +/** + * Conditionally applies the tracing decorator to the given connection. + * + * The connection is only decorated if tracing is enabled (as determined by the + * connection's options). + */ +std::shared_ptr +MakeRegionHealthAggregationPoliciesTracingConnection( + std::shared_ptr + conn); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_health_aggregation_policies_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_AGGREGATION_POLICIES_V1_INTERNAL_REGION_HEALTH_AGGREGATION_POLICIES_TRACING_CONNECTION_H diff --git a/google/cloud/compute/region_health_aggregation_policies/v1/mocks/mock_region_health_aggregation_policies_connection.h b/google/cloud/compute/region_health_aggregation_policies/v1/mocks/mock_region_health_aggregation_policies_connection.h new file mode 100644 index 0000000000000..9a5b2e40bfe53 --- /dev/null +++ b/google/cloud/compute/region_health_aggregation_policies/v1/mocks/mock_region_health_aggregation_policies_connection.h @@ -0,0 +1,215 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_AGGREGATION_POLICIES_V1_MOCKS_MOCK_REGION_HEALTH_AGGREGATION_POLICIES_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_AGGREGATION_POLICIES_V1_MOCKS_MOCK_REGION_HEALTH_AGGREGATION_POLICIES_CONNECTION_H + +#include "google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies_connection.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_health_aggregation_policies_v1_mocks { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/** + * A class to mock `RegionHealthAggregationPoliciesConnection`. + * + * Application developers may want to test their code with simulated responses, + * including errors, from an object of type + * `RegionHealthAggregationPoliciesClient`. To do so, construct an object of + * type `RegionHealthAggregationPoliciesClient` with an instance of this class. + * Then use the Google Test framework functions to program the behavior of this + * mock. + * + * @see [This example][bq-mock] for how to test your application with GoogleTest. + * While the example showcases types from the BigQuery library, the underlying + * principles apply for any pair of `*Client` and `*Connection`. + * + * [bq-mock]: @cloud_cpp_docs_link{bigquery,bigquery-read-mock} + */ +class MockRegionHealthAggregationPoliciesConnection + : public compute_region_health_aggregation_policies_v1:: + RegionHealthAggregationPoliciesConnection { + public: + MOCK_METHOD(Options, options, (), (override)); + + MOCK_METHOD( + (StreamRange< + std::pair>), + AggregatedListRegionHealthAggregationPolicies, + (google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + AggregatedListRegionHealthAggregationPoliciesRequest request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// DeleteHealthAggregationPolicy(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + DeleteHealthAggregationPolicy, + (google::cloud::cpp::compute::region_health_aggregation_policies:: + v1::DeleteHealthAggregationPolicyRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// EXPECT_CALL(*mock, DeleteHealthAggregationPolicy(_, _)) + /// @endcode + MOCK_METHOD(StatusOr, + DeleteHealthAggregationPolicy, + (NoAwaitTag, + google::cloud::cpp::compute::region_health_aggregation_policies:: + v1::DeleteHealthAggregationPolicyRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// DeleteHealthAggregationPolicy(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + DeleteHealthAggregationPolicy, + (google::cloud::cpp::compute::v1::Operation const& operation), + (override)); + + MOCK_METHOD( + StatusOr, + GetHealthAggregationPolicy, + (google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + GetHealthAggregationPolicyRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// InsertHealthAggregationPolicy(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + InsertHealthAggregationPolicy, + (google::cloud::cpp::compute::region_health_aggregation_policies:: + v1::InsertHealthAggregationPolicyRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// EXPECT_CALL(*mock, InsertHealthAggregationPolicy(_, _)) + /// @endcode + MOCK_METHOD(StatusOr, + InsertHealthAggregationPolicy, + (NoAwaitTag, + google::cloud::cpp::compute::region_health_aggregation_policies:: + v1::InsertHealthAggregationPolicyRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// InsertHealthAggregationPolicy(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + InsertHealthAggregationPolicy, + (google::cloud::cpp::compute::v1::Operation const& operation), + (override)); + + MOCK_METHOD( + (StreamRange), + ListRegionHealthAggregationPolicies, + (google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + ListRegionHealthAggregationPoliciesRequest request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// PatchHealthAggregationPolicy(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + PatchHealthAggregationPolicy, + (google::cloud::cpp::compute::region_health_aggregation_policies:: + v1::PatchHealthAggregationPolicyRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// EXPECT_CALL(*mock, PatchHealthAggregationPolicy(_, _)) + /// @endcode + MOCK_METHOD(StatusOr, + PatchHealthAggregationPolicy, + (NoAwaitTag, + google::cloud::cpp::compute::region_health_aggregation_policies:: + v1::PatchHealthAggregationPolicyRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// PatchHealthAggregationPolicy(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + PatchHealthAggregationPolicy, + (google::cloud::cpp::compute::v1::Operation const& operation), + (override)); + + MOCK_METHOD( + StatusOr, + TestIamPermissions, + (google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + TestIamPermissionsRequest const& request), + (override)); +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_health_aggregation_policies_v1_mocks +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_AGGREGATION_POLICIES_V1_MOCKS_MOCK_REGION_HEALTH_AGGREGATION_POLICIES_CONNECTION_H diff --git a/google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies_client.cc b/google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies_client.cc new file mode 100644 index 0000000000000..4c5a82e9e2d3b --- /dev/null +++ b/google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies_client.cc @@ -0,0 +1,306 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies.proto + +#include "google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies_client.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_health_aggregation_policies_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +RegionHealthAggregationPoliciesClient::RegionHealthAggregationPoliciesClient( + std::shared_ptr connection, + Options opts) + : connection_(std::move(connection)), + options_( + internal::MergeOptions(std::move(opts), connection_->options())) {} +RegionHealthAggregationPoliciesClient:: + ~RegionHealthAggregationPoliciesClient() = default; + +StreamRange> +RegionHealthAggregationPoliciesClient:: + AggregatedListRegionHealthAggregationPolicies(std::string const& project, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + AggregatedListRegionHealthAggregationPoliciesRequest request; + request.set_project(project); + return connection_->AggregatedListRegionHealthAggregationPolicies(request); +} + +StreamRange> +RegionHealthAggregationPoliciesClient:: + AggregatedListRegionHealthAggregationPolicies( + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + AggregatedListRegionHealthAggregationPoliciesRequest request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->AggregatedListRegionHealthAggregationPolicies( + std::move(request)); +} + +future> +RegionHealthAggregationPoliciesClient::DeleteHealthAggregationPolicy( + std::string const& project, std::string const& region, + std::string const& health_aggregation_policy, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + DeleteHealthAggregationPolicyRequest request; + request.set_project(project); + request.set_region(region); + request.set_health_aggregation_policy(health_aggregation_policy); + return connection_->DeleteHealthAggregationPolicy(request); +} + +StatusOr +RegionHealthAggregationPoliciesClient::DeleteHealthAggregationPolicy( + NoAwaitTag, std::string const& project, std::string const& region, + std::string const& health_aggregation_policy, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + DeleteHealthAggregationPolicyRequest request; + request.set_project(project); + request.set_region(region); + request.set_health_aggregation_policy(health_aggregation_policy); + return connection_->DeleteHealthAggregationPolicy(NoAwaitTag{}, request); +} + +future> +RegionHealthAggregationPoliciesClient::DeleteHealthAggregationPolicy( + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + DeleteHealthAggregationPolicyRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->DeleteHealthAggregationPolicy(request); +} + +StatusOr +RegionHealthAggregationPoliciesClient::DeleteHealthAggregationPolicy( + NoAwaitTag, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + DeleteHealthAggregationPolicyRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->DeleteHealthAggregationPolicy(NoAwaitTag{}, request); +} + +future> +RegionHealthAggregationPoliciesClient::DeleteHealthAggregationPolicy( + google::cloud::cpp::compute::v1::Operation const& operation, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->DeleteHealthAggregationPolicy(operation); +} + +StatusOr +RegionHealthAggregationPoliciesClient::GetHealthAggregationPolicy( + std::string const& project, std::string const& region, + std::string const& health_aggregation_policy, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + GetHealthAggregationPolicyRequest request; + request.set_project(project); + request.set_region(region); + request.set_health_aggregation_policy(health_aggregation_policy); + return connection_->GetHealthAggregationPolicy(request); +} + +StatusOr +RegionHealthAggregationPoliciesClient::GetHealthAggregationPolicy( + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + GetHealthAggregationPolicyRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->GetHealthAggregationPolicy(request); +} + +future> +RegionHealthAggregationPoliciesClient::InsertHealthAggregationPolicy( + std::string const& project, std::string const& region, + google::cloud::cpp::compute::v1::HealthAggregationPolicy const& + health_aggregation_policy_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + InsertHealthAggregationPolicyRequest request; + request.set_project(project); + request.set_region(region); + *request.mutable_health_aggregation_policy_resource() = + health_aggregation_policy_resource; + return connection_->InsertHealthAggregationPolicy(request); +} + +StatusOr +RegionHealthAggregationPoliciesClient::InsertHealthAggregationPolicy( + NoAwaitTag, std::string const& project, std::string const& region, + google::cloud::cpp::compute::v1::HealthAggregationPolicy const& + health_aggregation_policy_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + InsertHealthAggregationPolicyRequest request; + request.set_project(project); + request.set_region(region); + *request.mutable_health_aggregation_policy_resource() = + health_aggregation_policy_resource; + return connection_->InsertHealthAggregationPolicy(NoAwaitTag{}, request); +} + +future> +RegionHealthAggregationPoliciesClient::InsertHealthAggregationPolicy( + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + InsertHealthAggregationPolicyRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->InsertHealthAggregationPolicy(request); +} + +StatusOr +RegionHealthAggregationPoliciesClient::InsertHealthAggregationPolicy( + NoAwaitTag, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + InsertHealthAggregationPolicyRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->InsertHealthAggregationPolicy(NoAwaitTag{}, request); +} + +future> +RegionHealthAggregationPoliciesClient::InsertHealthAggregationPolicy( + google::cloud::cpp::compute::v1::Operation const& operation, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->InsertHealthAggregationPolicy(operation); +} + +StreamRange +RegionHealthAggregationPoliciesClient::ListRegionHealthAggregationPolicies( + std::string const& project, std::string const& region, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + ListRegionHealthAggregationPoliciesRequest request; + request.set_project(project); + request.set_region(region); + return connection_->ListRegionHealthAggregationPolicies(request); +} + +StreamRange +RegionHealthAggregationPoliciesClient::ListRegionHealthAggregationPolicies( + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + ListRegionHealthAggregationPoliciesRequest request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->ListRegionHealthAggregationPolicies(std::move(request)); +} + +future> +RegionHealthAggregationPoliciesClient::PatchHealthAggregationPolicy( + std::string const& project, std::string const& region, + std::string const& health_aggregation_policy, + google::cloud::cpp::compute::v1::HealthAggregationPolicy const& + health_aggregation_policy_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + PatchHealthAggregationPolicyRequest request; + request.set_project(project); + request.set_region(region); + request.set_health_aggregation_policy(health_aggregation_policy); + *request.mutable_health_aggregation_policy_resource() = + health_aggregation_policy_resource; + return connection_->PatchHealthAggregationPolicy(request); +} + +StatusOr +RegionHealthAggregationPoliciesClient::PatchHealthAggregationPolicy( + NoAwaitTag, std::string const& project, std::string const& region, + std::string const& health_aggregation_policy, + google::cloud::cpp::compute::v1::HealthAggregationPolicy const& + health_aggregation_policy_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + PatchHealthAggregationPolicyRequest request; + request.set_project(project); + request.set_region(region); + request.set_health_aggregation_policy(health_aggregation_policy); + *request.mutable_health_aggregation_policy_resource() = + health_aggregation_policy_resource; + return connection_->PatchHealthAggregationPolicy(NoAwaitTag{}, request); +} + +future> +RegionHealthAggregationPoliciesClient::PatchHealthAggregationPolicy( + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + PatchHealthAggregationPolicyRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->PatchHealthAggregationPolicy(request); +} + +StatusOr +RegionHealthAggregationPoliciesClient::PatchHealthAggregationPolicy( + NoAwaitTag, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + PatchHealthAggregationPolicyRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->PatchHealthAggregationPolicy(NoAwaitTag{}, request); +} + +future> +RegionHealthAggregationPoliciesClient::PatchHealthAggregationPolicy( + google::cloud::cpp::compute::v1::Operation const& operation, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->PatchHealthAggregationPolicy(operation); +} + +StatusOr +RegionHealthAggregationPoliciesClient::TestIamPermissions( + std::string const& project, std::string const& region, + std::string const& resource, + google::cloud::cpp::compute::v1::TestPermissionsRequest const& + test_permissions_request_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + TestIamPermissionsRequest request; + request.set_project(project); + request.set_region(region); + request.set_resource(resource); + *request.mutable_test_permissions_request_resource() = + test_permissions_request_resource; + return connection_->TestIamPermissions(request); +} + +StatusOr +RegionHealthAggregationPoliciesClient::TestIamPermissions( + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + TestIamPermissionsRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->TestIamPermissions(request); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_health_aggregation_policies_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies_client.h b/google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies_client.h new file mode 100644 index 0000000000000..40ee5cb779208 --- /dev/null +++ b/google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies_client.h @@ -0,0 +1,804 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_AGGREGATION_POLICIES_V1_REGION_HEALTH_AGGREGATION_POLICIES_CLIENT_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_AGGREGATION_POLICIES_V1_REGION_HEALTH_AGGREGATION_POLICIES_CLIENT_H + +#include "google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies_rest_connection.h" +#include "google/cloud/future.h" +#include "google/cloud/no_await_tag.h" +#include "google/cloud/options.h" +#include "google/cloud/polling_policy.h" +#include "google/cloud/status_or.h" +#include "google/cloud/version.h" +#include +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_health_aggregation_policies_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/// +/// Service for the regionHealthAggregationPolicies resource. +/// https://cloud.google.com/compute/docs/reference/rest/v1/regionHealthAggregationPolicies +/// +/// @par Equality +/// +/// Instances of this class created via copy-construction or copy-assignment +/// always compare equal. Instances created with equal +/// `std::shared_ptr<*Connection>` objects compare equal. Objects that compare +/// equal share the same underlying resources. +/// +/// @par Performance +/// +/// Creating a new instance of this class is a relatively expensive operation, +/// new objects establish new connections to the service. In contrast, +/// copy-construction, move-construction, and the corresponding assignment +/// operations are relatively efficient as the copies share all underlying +/// resources. +/// +/// @par Thread Safety +/// +/// Concurrent access to different instances of this class, even if they compare +/// equal, is guaranteed to work. Two or more threads operating on the same +/// instance of this class is not guaranteed to work. Since copy-construction +/// and move-construction is a relatively efficient operation, consider using +/// such a copy when using this class from multiple threads. +/// +class RegionHealthAggregationPoliciesClient { + public: + explicit RegionHealthAggregationPoliciesClient( + std::shared_ptr connection, + Options opts = {}); + ~RegionHealthAggregationPoliciesClient(); + + ///@{ + /// @name Copy and move support + RegionHealthAggregationPoliciesClient( + RegionHealthAggregationPoliciesClient const&) = default; + RegionHealthAggregationPoliciesClient& operator=( + RegionHealthAggregationPoliciesClient const&) = default; + RegionHealthAggregationPoliciesClient( + RegionHealthAggregationPoliciesClient&&) = default; + RegionHealthAggregationPoliciesClient& operator=( + RegionHealthAggregationPoliciesClient&&) = default; + ///@} + + ///@{ + /// @name Equality + friend bool operator==(RegionHealthAggregationPoliciesClient const& a, + RegionHealthAggregationPoliciesClient const& b) { + return a.connection_ == b.connection_; + } + friend bool operator!=(RegionHealthAggregationPoliciesClient const& a, + RegionHealthAggregationPoliciesClient const& b) { + return !(a == b); + } + ///@} + + // clang-format off + /// + /// Retrieves the list of all HealthAggregationPolicy resources, + /// regional and global, available to the specified project. + /// + /// To prevent failure, it is recommended that you set the + /// `returnPartialSuccess` parameter to `true`. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionHealthAggregationPolicies/aggregatedList + /// + /// @param project Name of the project scoping this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return a [StreamRange](@ref google::cloud::StreamRange) + /// to iterate of the results. See the documentation of this type for + /// details. In brief, this class has `begin()` and `end()` member + /// functions returning a iterator class meeting the + /// [input iterator requirements]. The value type for this iterator is a + /// [`StatusOr`] as the iteration may fail even after some values are + /// retrieved successfully, for example, if there is a network disconnect. + /// An empty set of results does not indicate an error, it indicates + /// that there are no resources meeting the request criteria. + /// On a successful iteration the `StatusOr` contains elements of type + /// [google.cloud.cpp.compute.v1.HealthAggregationPoliciesScopedList], or rather, + /// the C++ class generated by Protobuf from that type. Please consult the + /// Protobuf documentation for details on the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_health_aggregation_policies.v1.AggregatedListRegionHealthAggregationPoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies.proto#L135} + /// [google.cloud.cpp.compute.v1.HealthAggregationPoliciesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_060.proto#L24} + /// + // clang-format on + StreamRange> + AggregatedListRegionHealthAggregationPolicies(std::string const& project, + Options opts = {}); + + // clang-format off + /// + /// Retrieves the list of all HealthAggregationPolicy resources, + /// regional and global, available to the specified project. + /// + /// To prevent failure, it is recommended that you set the + /// `returnPartialSuccess` parameter to `true`. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionHealthAggregationPolicies/aggregatedList + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.region_health_aggregation_policies.v1.AggregatedListRegionHealthAggregationPoliciesRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return a [StreamRange](@ref google::cloud::StreamRange) + /// to iterate of the results. See the documentation of this type for + /// details. In brief, this class has `begin()` and `end()` member + /// functions returning a iterator class meeting the + /// [input iterator requirements]. The value type for this iterator is a + /// [`StatusOr`] as the iteration may fail even after some values are + /// retrieved successfully, for example, if there is a network disconnect. + /// An empty set of results does not indicate an error, it indicates + /// that there are no resources meeting the request criteria. + /// On a successful iteration the `StatusOr` contains elements of type + /// [google.cloud.cpp.compute.v1.HealthAggregationPoliciesScopedList], or rather, + /// the C++ class generated by Protobuf from that type. Please consult the + /// Protobuf documentation for details on the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_health_aggregation_policies.v1.AggregatedListRegionHealthAggregationPoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies.proto#L135} + /// [google.cloud.cpp.compute.v1.HealthAggregationPoliciesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_060.proto#L24} + /// + // clang-format on + StreamRange> + AggregatedListRegionHealthAggregationPolicies( + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + AggregatedListRegionHealthAggregationPoliciesRequest request, + Options opts = {}); + + // clang-format off + /// + /// Deletes the specified HealthAggregationPolicy in the given region. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionHealthAggregationPolicies/delete + /// + /// @param project Project ID for this request. + /// @param region Name of the region scoping this request. + /// @param health_aggregation_policy Name of the HealthAggregationPolicy resource to delete. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_health_aggregation_policies.v1.DeleteHealthAggregationPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies.proto#L250} + /// + // clang-format on + future> + DeleteHealthAggregationPolicy(std::string const& project, + std::string const& region, + std::string const& health_aggregation_policy, + Options opts = {}); + + // clang-format off + /// + /// @copybrief DeleteHealthAggregationPolicy + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr + DeleteHealthAggregationPolicy(NoAwaitTag, std::string const& project, + std::string const& region, + std::string const& health_aggregation_policy, + Options opts = {}); + + // clang-format off + /// + /// Deletes the specified HealthAggregationPolicy in the given region. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionHealthAggregationPolicies/delete + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.region_health_aggregation_policies.v1.DeleteHealthAggregationPolicyRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_health_aggregation_policies.v1.DeleteHealthAggregationPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies.proto#L250} + /// + // clang-format on + future> + DeleteHealthAggregationPolicy( + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + DeleteHealthAggregationPolicyRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief DeleteHealthAggregationPolicy + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr + DeleteHealthAggregationPolicy( + NoAwaitTag, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + DeleteHealthAggregationPolicyRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief DeleteHealthAggregationPolicy + /// + /// This method accepts a `google::cloud::cpp::compute::v1::Operation` that corresponds + /// to a previously started Long Running Operation (LRO) and polls the status + /// of the LRO in the background. + /// + // clang-format on + future> + DeleteHealthAggregationPolicy( + google::cloud::cpp::compute::v1::Operation const& operation, + Options opts = {}); + + // clang-format off + /// + /// Returns the specified HealthAggregationPolicy resource in the given region. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionHealthAggregationPolicies/get + /// + /// @param project Project ID for this request. + /// @param region Name of the region scoping this request. + /// @param health_aggregation_policy Name of the HealthAggregationPolicy resource to return. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.HealthAggregationPolicy]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_health_aggregation_policies.v1.GetHealthAggregationPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies.proto#L288} + /// [google.cloud.cpp.compute.v1.HealthAggregationPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_060.proto#L143} + /// + // clang-format on + StatusOr + GetHealthAggregationPolicy(std::string const& project, + std::string const& region, + std::string const& health_aggregation_policy, + Options opts = {}); + + // clang-format off + /// + /// Returns the specified HealthAggregationPolicy resource in the given region. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionHealthAggregationPolicies/get + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.region_health_aggregation_policies.v1.GetHealthAggregationPolicyRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.HealthAggregationPolicy]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_health_aggregation_policies.v1.GetHealthAggregationPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies.proto#L288} + /// [google.cloud.cpp.compute.v1.HealthAggregationPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_060.proto#L143} + /// + // clang-format on + StatusOr + GetHealthAggregationPolicy( + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + GetHealthAggregationPolicyRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// Create a HealthAggregationPolicy in the specified project in the given + /// region using the parameters that are included in the request. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionHealthAggregationPolicies/insert + /// + /// @param project Project ID for this request. + /// @param region Name of the region scoping this request. + /// @param health_aggregation_policy_resource The HealthAggregationPolicy for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_health_aggregation_policies.v1.InsertHealthAggregationPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies.proto#L305} + /// + // clang-format on + future> + InsertHealthAggregationPolicy( + std::string const& project, std::string const& region, + google::cloud::cpp::compute::v1::HealthAggregationPolicy const& + health_aggregation_policy_resource, + Options opts = {}); + + // clang-format off + /// + /// @copybrief InsertHealthAggregationPolicy + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr + InsertHealthAggregationPolicy( + NoAwaitTag, std::string const& project, std::string const& region, + google::cloud::cpp::compute::v1::HealthAggregationPolicy const& + health_aggregation_policy_resource, + Options opts = {}); + + // clang-format off + /// + /// Create a HealthAggregationPolicy in the specified project in the given + /// region using the parameters that are included in the request. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionHealthAggregationPolicies/insert + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.region_health_aggregation_policies.v1.InsertHealthAggregationPolicyRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_health_aggregation_policies.v1.InsertHealthAggregationPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies.proto#L305} + /// + // clang-format on + future> + InsertHealthAggregationPolicy( + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + InsertHealthAggregationPolicyRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief InsertHealthAggregationPolicy + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr + InsertHealthAggregationPolicy( + NoAwaitTag, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + InsertHealthAggregationPolicyRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief InsertHealthAggregationPolicy + /// + /// This method accepts a `google::cloud::cpp::compute::v1::Operation` that corresponds + /// to a previously started Long Running Operation (LRO) and polls the status + /// of the LRO in the background. + /// + // clang-format on + future> + InsertHealthAggregationPolicy( + google::cloud::cpp::compute::v1::Operation const& operation, + Options opts = {}); + + // clang-format off + /// + /// Lists the HealthAggregationPolicies for a project in the given region. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionHealthAggregationPolicies/list + /// + /// @param project Project ID for this request. + /// @param region Name of the region scoping this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return a [StreamRange](@ref google::cloud::StreamRange) + /// to iterate of the results. See the documentation of this type for + /// details. In brief, this class has `begin()` and `end()` member + /// functions returning a iterator class meeting the + /// [input iterator requirements]. The value type for this iterator is a + /// [`StatusOr`] as the iteration may fail even after some values are + /// retrieved successfully, for example, if there is a network disconnect. + /// An empty set of results does not indicate an error, it indicates + /// that there are no resources meeting the request criteria. + /// On a successful iteration the `StatusOr` contains elements of type + /// [google.cloud.cpp.compute.v1.HealthAggregationPolicy], or rather, + /// the C++ class generated by Protobuf from that type. Please consult the + /// Protobuf documentation for details on the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_health_aggregation_policies.v1.ListRegionHealthAggregationPoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies.proto#L342} + /// [google.cloud.cpp.compute.v1.HealthAggregationPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_060.proto#L143} + /// + // clang-format on + StreamRange + ListRegionHealthAggregationPolicies(std::string const& project, + std::string const& region, + Options opts = {}); + + // clang-format off + /// + /// Lists the HealthAggregationPolicies for a project in the given region. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionHealthAggregationPolicies/list + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.region_health_aggregation_policies.v1.ListRegionHealthAggregationPoliciesRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return a [StreamRange](@ref google::cloud::StreamRange) + /// to iterate of the results. See the documentation of this type for + /// details. In brief, this class has `begin()` and `end()` member + /// functions returning a iterator class meeting the + /// [input iterator requirements]. The value type for this iterator is a + /// [`StatusOr`] as the iteration may fail even after some values are + /// retrieved successfully, for example, if there is a network disconnect. + /// An empty set of results does not indicate an error, it indicates + /// that there are no resources meeting the request criteria. + /// On a successful iteration the `StatusOr` contains elements of type + /// [google.cloud.cpp.compute.v1.HealthAggregationPolicy], or rather, + /// the C++ class generated by Protobuf from that type. Please consult the + /// Protobuf documentation for details on the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_health_aggregation_policies.v1.ListRegionHealthAggregationPoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies.proto#L342} + /// [google.cloud.cpp.compute.v1.HealthAggregationPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_060.proto#L143} + /// + // clang-format on + StreamRange + ListRegionHealthAggregationPolicies( + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + ListRegionHealthAggregationPoliciesRequest request, + Options opts = {}); + + // clang-format off + /// + /// Updates the specified regional HealthAggregationPolicy + /// resource with the data included in the request. This method supportsPATCH + /// semantics and uses theJSON merge + /// patch format and processing rules. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionHealthAggregationPolicies/patch + /// + /// @param project Project ID for this request. + /// @param region Name of the region scoping this request. + /// @param health_aggregation_policy Name of the HealthAggregationPolicy to update. The name + /// must be 1-63 characters long, and comply with RFC1035. + /// @param health_aggregation_policy_resource The HealthAggregationPolicy for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_health_aggregation_policies.v1.PatchHealthAggregationPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies.proto#L447} + /// + // clang-format on + future> + PatchHealthAggregationPolicy( + std::string const& project, std::string const& region, + std::string const& health_aggregation_policy, + google::cloud::cpp::compute::v1::HealthAggregationPolicy const& + health_aggregation_policy_resource, + Options opts = {}); + + // clang-format off + /// + /// @copybrief PatchHealthAggregationPolicy + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr + PatchHealthAggregationPolicy( + NoAwaitTag, std::string const& project, std::string const& region, + std::string const& health_aggregation_policy, + google::cloud::cpp::compute::v1::HealthAggregationPolicy const& + health_aggregation_policy_resource, + Options opts = {}); + + // clang-format off + /// + /// Updates the specified regional HealthAggregationPolicy + /// resource with the data included in the request. This method supportsPATCH + /// semantics and uses theJSON merge + /// patch format and processing rules. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionHealthAggregationPolicies/patch + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.region_health_aggregation_policies.v1.PatchHealthAggregationPolicyRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_health_aggregation_policies.v1.PatchHealthAggregationPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies.proto#L447} + /// + // clang-format on + future> + PatchHealthAggregationPolicy( + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + PatchHealthAggregationPolicyRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief PatchHealthAggregationPolicy + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr + PatchHealthAggregationPolicy( + NoAwaitTag, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + PatchHealthAggregationPolicyRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief PatchHealthAggregationPolicy + /// + /// This method accepts a `google::cloud::cpp::compute::v1::Operation` that corresponds + /// to a previously started Long Running Operation (LRO) and polls the status + /// of the LRO in the background. + /// + // clang-format on + future> + PatchHealthAggregationPolicy( + google::cloud::cpp::compute::v1::Operation const& operation, + Options opts = {}); + + // clang-format off + /// + /// Returns permissions that a caller has on the specified resource. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionHealthAggregationPolicies/testIamPermissions + /// + /// @param project Project ID for this request. + /// @param region The name of the region for this request. + /// @param resource Name or id of the resource for this request. + /// @param test_permissions_request_resource The TestPermissionsRequest for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.TestPermissionsResponse]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_health_aggregation_policies.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies.proto#L491} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} + /// + // clang-format on + StatusOr + TestIamPermissions( + std::string const& project, std::string const& region, + std::string const& resource, + google::cloud::cpp::compute::v1::TestPermissionsRequest const& + test_permissions_request_resource, + Options opts = {}); + + // clang-format off + /// + /// Returns permissions that a caller has on the specified resource. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionHealthAggregationPolicies/testIamPermissions + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.region_health_aggregation_policies.v1.TestIamPermissionsRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.TestPermissionsResponse]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_health_aggregation_policies.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies.proto#L491} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} + /// + // clang-format on + StatusOr + TestIamPermissions( + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + TestIamPermissionsRequest const& request, + Options opts = {}); + + private: + std::shared_ptr connection_; + Options options_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_health_aggregation_policies_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_AGGREGATION_POLICIES_V1_REGION_HEALTH_AGGREGATION_POLICIES_CLIENT_H diff --git a/google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies_connection.cc b/google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies_connection.cc new file mode 100644 index 0000000000000..699559c445e2e --- /dev/null +++ b/google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies_connection.cc @@ -0,0 +1,155 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies.proto + +#include "google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies_connection.h" +#include "google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_option_defaults.h" +#include "google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_tracing_connection.h" +#include "google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies_options.h" +#include "google/cloud/background_threads.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/grpc_options.h" +#include "google/cloud/internal/pagination_range.h" +#include "google/cloud/internal/unified_grpc_credentials.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_health_aggregation_policies_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +RegionHealthAggregationPoliciesConnection:: + ~RegionHealthAggregationPoliciesConnection() = default; + +StreamRange> +RegionHealthAggregationPoliciesConnection:: + AggregatedListRegionHealthAggregationPolicies( + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + AggregatedListRegionHealthAggregationPoliciesRequest) { // NOLINT(performance-unnecessary-value-param) + return google::cloud::internal::MakeUnimplementedPaginationRange>>(); +} + +future> +RegionHealthAggregationPoliciesConnection::DeleteHealthAggregationPolicy( + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + DeleteHealthAggregationPolicyRequest const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +RegionHealthAggregationPoliciesConnection::DeleteHealthAggregationPolicy( + NoAwaitTag, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + DeleteHealthAggregationPolicyRequest const&) { + return StatusOr( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +RegionHealthAggregationPoliciesConnection::DeleteHealthAggregationPolicy( + google::cloud::cpp::compute::v1::Operation const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +RegionHealthAggregationPoliciesConnection::GetHealthAggregationPolicy( + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + GetHealthAggregationPolicyRequest const&) { + return Status(StatusCode::kUnimplemented, "not implemented"); +} + +future> +RegionHealthAggregationPoliciesConnection::InsertHealthAggregationPolicy( + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + InsertHealthAggregationPolicyRequest const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +RegionHealthAggregationPoliciesConnection::InsertHealthAggregationPolicy( + NoAwaitTag, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + InsertHealthAggregationPolicyRequest const&) { + return StatusOr( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +RegionHealthAggregationPoliciesConnection::InsertHealthAggregationPolicy( + google::cloud::cpp::compute::v1::Operation const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StreamRange +RegionHealthAggregationPoliciesConnection::ListRegionHealthAggregationPolicies( + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + ListRegionHealthAggregationPoliciesRequest) { // NOLINT(performance-unnecessary-value-param) + return google::cloud::internal::MakeUnimplementedPaginationRange< + StreamRange>(); +} + +future> +RegionHealthAggregationPoliciesConnection::PatchHealthAggregationPolicy( + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + PatchHealthAggregationPolicyRequest const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +RegionHealthAggregationPoliciesConnection::PatchHealthAggregationPolicy( + NoAwaitTag, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + PatchHealthAggregationPolicyRequest const&) { + return StatusOr( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +RegionHealthAggregationPoliciesConnection::PatchHealthAggregationPolicy( + google::cloud::cpp::compute::v1::Operation const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +RegionHealthAggregationPoliciesConnection::TestIamPermissions( + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + TestIamPermissionsRequest const&) { + return Status(StatusCode::kUnimplemented, "not implemented"); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_health_aggregation_policies_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies_connection.h b/google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies_connection.h new file mode 100644 index 0000000000000..31edfd8912822 --- /dev/null +++ b/google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies_connection.h @@ -0,0 +1,283 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_AGGREGATION_POLICIES_V1_REGION_HEALTH_AGGREGATION_POLICIES_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_AGGREGATION_POLICIES_V1_REGION_HEALTH_AGGREGATION_POLICIES_CONNECTION_H + +#include "google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_retry_traits.h" +#include "google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies.pb.h" +#include "google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies_connection_idempotency_policy.h" +#include "google/cloud/backoff_policy.h" +#include "google/cloud/future.h" +#include "google/cloud/internal/retry_policy_impl.h" +#include "google/cloud/no_await_tag.h" +#include "google/cloud/options.h" +#include "google/cloud/polling_policy.h" +#include "google/cloud/status_or.h" +#include "google/cloud/stream_range.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_health_aggregation_policies_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/// The retry policy for `RegionHealthAggregationPoliciesConnection`. +class RegionHealthAggregationPoliciesRetryPolicy + : public ::google::cloud::RetryPolicy { + public: + /// Creates a new instance of the policy, reset to the initial state. + virtual std::unique_ptr clone() + const = 0; +}; + +/** + * A retry policy for `RegionHealthAggregationPoliciesConnection` based on + * counting errors. + * + * This policy stops retrying if: + * - An RPC returns a non-transient error. + * - More than a prescribed number of transient failures is detected. + * + * In this class the following status codes are treated as transient errors: + * - [`kUnavailable`](@ref google::cloud::StatusCode) + */ +class RegionHealthAggregationPoliciesLimitedErrorCountRetryPolicy + : public RegionHealthAggregationPoliciesRetryPolicy { + public: + /** + * Create an instance that tolerates up to @p maximum_failures transient + * errors. + * + * @note Disable the retry loop by providing an instance of this policy with + * @p maximum_failures == 0. + */ + explicit RegionHealthAggregationPoliciesLimitedErrorCountRetryPolicy( + int maximum_failures) + : impl_(maximum_failures) {} + + RegionHealthAggregationPoliciesLimitedErrorCountRetryPolicy( + RegionHealthAggregationPoliciesLimitedErrorCountRetryPolicy&& + rhs) noexcept + : RegionHealthAggregationPoliciesLimitedErrorCountRetryPolicy( + rhs.maximum_failures()) {} + RegionHealthAggregationPoliciesLimitedErrorCountRetryPolicy( + RegionHealthAggregationPoliciesLimitedErrorCountRetryPolicy const& + rhs) noexcept + : RegionHealthAggregationPoliciesLimitedErrorCountRetryPolicy( + rhs.maximum_failures()) {} + + int maximum_failures() const { return impl_.maximum_failures(); } + + bool OnFailure(Status const& status) override { + return impl_.OnFailure(status); + } + bool IsExhausted() const override { return impl_.IsExhausted(); } + bool IsPermanentFailure(Status const& status) const override { + return impl_.IsPermanentFailure(status); + } + std::unique_ptr clone() + const override { + return std::make_unique< + RegionHealthAggregationPoliciesLimitedErrorCountRetryPolicy>( + maximum_failures()); + } + + // This is provided only for backwards compatibility. + using BaseType = RegionHealthAggregationPoliciesRetryPolicy; + + private: + google::cloud::internal::LimitedErrorCountRetryPolicy< + compute_region_health_aggregation_policies_v1_internal:: + RegionHealthAggregationPoliciesRetryTraits> + impl_; +}; + +/** + * A retry policy for `RegionHealthAggregationPoliciesConnection` based on + * elapsed time. + * + * This policy stops retrying if: + * - An RPC returns a non-transient error. + * - The elapsed time in the retry loop exceeds a prescribed duration. + * + * In this class the following status codes are treated as transient errors: + * - [`kUnavailable`](@ref google::cloud::StatusCode) + */ +class RegionHealthAggregationPoliciesLimitedTimeRetryPolicy + : public RegionHealthAggregationPoliciesRetryPolicy { + public: + /** + * Constructor given a `std::chrono::duration<>` object. + * + * @tparam DurationRep a placeholder to match the `Rep` tparam for @p + * duration's type. The semantics of this template parameter are + * documented in `std::chrono::duration<>`. In brief, the underlying + * arithmetic type used to store the number of ticks. For our purposes it + * is simply a formal parameter. + * @tparam DurationPeriod a placeholder to match the `Period` tparam for @p + * duration's type. The semantics of this template parameter are + * documented in `std::chrono::duration<>`. In brief, the length of the + * tick in seconds, expressed as a `std::ratio<>`. For our purposes it is + * simply a formal parameter. + * @param maximum_duration the maximum time allowed before the policy expires. + * While the application can express this time in any units they desire, + * the class truncates to milliseconds. + * + * @see https://en.cppreference.com/w/cpp/chrono/duration for more information + * about `std::chrono::duration`. + */ + template + explicit RegionHealthAggregationPoliciesLimitedTimeRetryPolicy( + std::chrono::duration maximum_duration) + : impl_(maximum_duration) {} + + RegionHealthAggregationPoliciesLimitedTimeRetryPolicy( + RegionHealthAggregationPoliciesLimitedTimeRetryPolicy&& rhs) noexcept + : RegionHealthAggregationPoliciesLimitedTimeRetryPolicy( + rhs.maximum_duration()) {} + RegionHealthAggregationPoliciesLimitedTimeRetryPolicy( + RegionHealthAggregationPoliciesLimitedTimeRetryPolicy const& rhs) noexcept + : RegionHealthAggregationPoliciesLimitedTimeRetryPolicy( + rhs.maximum_duration()) {} + + std::chrono::milliseconds maximum_duration() const { + return impl_.maximum_duration(); + } + + bool OnFailure(Status const& status) override { + return impl_.OnFailure(status); + } + bool IsExhausted() const override { return impl_.IsExhausted(); } + bool IsPermanentFailure(Status const& status) const override { + return impl_.IsPermanentFailure(status); + } + std::unique_ptr clone() + const override { + return std::make_unique< + RegionHealthAggregationPoliciesLimitedTimeRetryPolicy>( + maximum_duration()); + } + + // This is provided only for backwards compatibility. + using BaseType = RegionHealthAggregationPoliciesRetryPolicy; + + private: + google::cloud::internal::LimitedTimeRetryPolicy< + compute_region_health_aggregation_policies_v1_internal:: + RegionHealthAggregationPoliciesRetryTraits> + impl_; +}; + +/** + * The `RegionHealthAggregationPoliciesConnection` object for + * `RegionHealthAggregationPoliciesClient`. + * + * This interface defines virtual methods for each of the user-facing overload + * sets in `RegionHealthAggregationPoliciesClient`. This allows users to inject + * custom behavior (e.g., with a Google Mock object) when writing tests that use + * objects of type `RegionHealthAggregationPoliciesClient`. + * + * To create a concrete instance, see + * `MakeRegionHealthAggregationPoliciesConnection()`. + * + * For mocking, see + * `compute_region_health_aggregation_policies_v1_mocks::MockRegionHealthAggregationPoliciesConnection`. + */ +class RegionHealthAggregationPoliciesConnection { + public: + virtual ~RegionHealthAggregationPoliciesConnection() = 0; + + virtual Options options() { return Options{}; } + + virtual StreamRange> + AggregatedListRegionHealthAggregationPolicies( + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + AggregatedListRegionHealthAggregationPoliciesRequest request); + + virtual future> + DeleteHealthAggregationPolicy( + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + DeleteHealthAggregationPolicyRequest const& request); + + virtual StatusOr + DeleteHealthAggregationPolicy( + NoAwaitTag, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + DeleteHealthAggregationPolicyRequest const& request); + + virtual future> + DeleteHealthAggregationPolicy( + google::cloud::cpp::compute::v1::Operation const& operation); + + virtual StatusOr + GetHealthAggregationPolicy( + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + GetHealthAggregationPolicyRequest const& request); + + virtual future> + InsertHealthAggregationPolicy( + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + InsertHealthAggregationPolicyRequest const& request); + + virtual StatusOr + InsertHealthAggregationPolicy( + NoAwaitTag, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + InsertHealthAggregationPolicyRequest const& request); + + virtual future> + InsertHealthAggregationPolicy( + google::cloud::cpp::compute::v1::Operation const& operation); + + virtual StreamRange + ListRegionHealthAggregationPolicies( + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + ListRegionHealthAggregationPoliciesRequest request); + + virtual future> + PatchHealthAggregationPolicy( + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + PatchHealthAggregationPolicyRequest const& request); + + virtual StatusOr + PatchHealthAggregationPolicy( + NoAwaitTag, + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + PatchHealthAggregationPolicyRequest const& request); + + virtual future> + PatchHealthAggregationPolicy( + google::cloud::cpp::compute::v1::Operation const& operation); + + virtual StatusOr + TestIamPermissions( + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + TestIamPermissionsRequest const& request); +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_health_aggregation_policies_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_AGGREGATION_POLICIES_V1_REGION_HEALTH_AGGREGATION_POLICIES_CONNECTION_H diff --git a/google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies_connection_idempotency_policy.cc b/google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies_connection_idempotency_policy.cc new file mode 100644 index 0000000000000..8cc92d6af793b --- /dev/null +++ b/google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies_connection_idempotency_policy.cc @@ -0,0 +1,97 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies.proto + +#include "google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies_connection_idempotency_policy.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_health_aggregation_policies_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +using ::google::cloud::Idempotency; + +RegionHealthAggregationPoliciesConnectionIdempotencyPolicy:: + ~RegionHealthAggregationPoliciesConnectionIdempotencyPolicy() = default; + +std::unique_ptr +RegionHealthAggregationPoliciesConnectionIdempotencyPolicy::clone() const { + return std::make_unique< + RegionHealthAggregationPoliciesConnectionIdempotencyPolicy>(*this); +} + +Idempotency RegionHealthAggregationPoliciesConnectionIdempotencyPolicy:: + AggregatedListRegionHealthAggregationPolicies( + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + AggregatedListRegionHealthAggregationPoliciesRequest) { // NOLINT + return Idempotency::kIdempotent; +} + +Idempotency RegionHealthAggregationPoliciesConnectionIdempotencyPolicy:: + DeleteHealthAggregationPolicy( + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + DeleteHealthAggregationPolicyRequest const&) { + return Idempotency::kNonIdempotent; +} + +Idempotency RegionHealthAggregationPoliciesConnectionIdempotencyPolicy:: + GetHealthAggregationPolicy( + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + GetHealthAggregationPolicyRequest const&) { + return Idempotency::kIdempotent; +} + +Idempotency RegionHealthAggregationPoliciesConnectionIdempotencyPolicy:: + InsertHealthAggregationPolicy( + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + InsertHealthAggregationPolicyRequest const&) { + return Idempotency::kNonIdempotent; +} + +Idempotency RegionHealthAggregationPoliciesConnectionIdempotencyPolicy:: + ListRegionHealthAggregationPolicies( + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + ListRegionHealthAggregationPoliciesRequest) { // NOLINT + return Idempotency::kIdempotent; +} + +Idempotency RegionHealthAggregationPoliciesConnectionIdempotencyPolicy:: + PatchHealthAggregationPolicy( + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + PatchHealthAggregationPolicyRequest const&) { + return Idempotency::kNonIdempotent; +} + +Idempotency +RegionHealthAggregationPoliciesConnectionIdempotencyPolicy::TestIamPermissions( + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + TestIamPermissionsRequest const&) { + return Idempotency::kNonIdempotent; +} + +std::unique_ptr +MakeDefaultRegionHealthAggregationPoliciesConnectionIdempotencyPolicy() { + return std::make_unique< + RegionHealthAggregationPoliciesConnectionIdempotencyPolicy>(); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_health_aggregation_policies_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies_connection_idempotency_policy.h b/google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies_connection_idempotency_policy.h new file mode 100644 index 0000000000000..db95c558347b4 --- /dev/null +++ b/google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies_connection_idempotency_policy.h @@ -0,0 +1,80 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_AGGREGATION_POLICIES_V1_REGION_HEALTH_AGGREGATION_POLICIES_CONNECTION_IDEMPOTENCY_POLICY_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_AGGREGATION_POLICIES_V1_REGION_HEALTH_AGGREGATION_POLICIES_CONNECTION_IDEMPOTENCY_POLICY_H + +#include "google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies.pb.h" +#include "google/cloud/idempotency.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_health_aggregation_policies_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class RegionHealthAggregationPoliciesConnectionIdempotencyPolicy { + public: + virtual ~RegionHealthAggregationPoliciesConnectionIdempotencyPolicy(); + + /// Create a new copy of this object. + virtual std::unique_ptr< + RegionHealthAggregationPoliciesConnectionIdempotencyPolicy> + clone() const; + + virtual google::cloud::Idempotency + AggregatedListRegionHealthAggregationPolicies( + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + AggregatedListRegionHealthAggregationPoliciesRequest request); + + virtual google::cloud::Idempotency DeleteHealthAggregationPolicy( + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + DeleteHealthAggregationPolicyRequest const& request); + + virtual google::cloud::Idempotency GetHealthAggregationPolicy( + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + GetHealthAggregationPolicyRequest const& request); + + virtual google::cloud::Idempotency InsertHealthAggregationPolicy( + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + InsertHealthAggregationPolicyRequest const& request); + + virtual google::cloud::Idempotency ListRegionHealthAggregationPolicies( + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + ListRegionHealthAggregationPoliciesRequest request); + + virtual google::cloud::Idempotency PatchHealthAggregationPolicy( + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + PatchHealthAggregationPolicyRequest const& request); + + virtual google::cloud::Idempotency TestIamPermissions( + google::cloud::cpp::compute::region_health_aggregation_policies::v1:: + TestIamPermissionsRequest const& request); +}; + +std::unique_ptr +MakeDefaultRegionHealthAggregationPoliciesConnectionIdempotencyPolicy(); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_health_aggregation_policies_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_AGGREGATION_POLICIES_V1_REGION_HEALTH_AGGREGATION_POLICIES_CONNECTION_IDEMPOTENCY_POLICY_H diff --git a/google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies_options.h b/google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies_options.h new file mode 100644 index 0000000000000..c2eaca4c531a1 --- /dev/null +++ b/google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies_options.h @@ -0,0 +1,89 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_AGGREGATION_POLICIES_V1_REGION_HEALTH_AGGREGATION_POLICIES_OPTIONS_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_AGGREGATION_POLICIES_V1_REGION_HEALTH_AGGREGATION_POLICIES_OPTIONS_H + +#include "google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies_connection.h" +#include "google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies_connection_idempotency_policy.h" +#include "google/cloud/backoff_policy.h" +#include "google/cloud/options.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_health_aggregation_policies_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/** + * Use with `google::cloud::Options` to configure the retry policy. + * + * @ingroup google-cloud-compute-options + */ +struct RegionHealthAggregationPoliciesRetryPolicyOption { + using Type = std::shared_ptr; +}; + +/** + * Use with `google::cloud::Options` to configure the backoff policy. + * + * @ingroup google-cloud-compute-options + */ +struct RegionHealthAggregationPoliciesBackoffPolicyOption { + using Type = std::shared_ptr; +}; + +/** + * Use with `google::cloud::Options` to configure which operations are retried. + * + * @ingroup google-cloud-compute-options + */ +struct RegionHealthAggregationPoliciesConnectionIdempotencyPolicyOption { + using Type = std::shared_ptr< + RegionHealthAggregationPoliciesConnectionIdempotencyPolicy>; +}; + +/** + * Use with `google::cloud::Options` to configure the long-running operations + * polling policy. + * + * @ingroup google-cloud-compute-options + */ +struct RegionHealthAggregationPoliciesPollingPolicyOption { + using Type = std::shared_ptr; +}; + +/** + * The options applicable to RegionHealthAggregationPolicies. + * + * @ingroup google-cloud-compute-options + */ +using RegionHealthAggregationPoliciesPolicyOptionList = OptionList< + RegionHealthAggregationPoliciesRetryPolicyOption, + RegionHealthAggregationPoliciesBackoffPolicyOption, + RegionHealthAggregationPoliciesPollingPolicyOption, + RegionHealthAggregationPoliciesConnectionIdempotencyPolicyOption>; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_health_aggregation_policies_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_AGGREGATION_POLICIES_V1_REGION_HEALTH_AGGREGATION_POLICIES_OPTIONS_H diff --git a/google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies_proto_export.h b/google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies_proto_export.h new file mode 100644 index 0000000000000..f542f7df4a5fd --- /dev/null +++ b/google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies_proto_export.h @@ -0,0 +1,34 @@ +// Copyright 2026 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_REGION_HEALTH_AGGREGATION_POLICIES_V1_REGION_HEALTH_AGGREGATION_POLICIES_PROTO_EXPORT_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_AGGREGATION_POLICIES_V1_REGION_HEALTH_AGGREGATION_POLICIES_PROTO_EXPORT_H + +// IWYU pragma: begin_exports +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_060.pb.h" +#include "google/cloud/compute/v1/internal/common_171.pb.h" +// IWYU pragma: end_exports + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_AGGREGATION_POLICIES_V1_REGION_HEALTH_AGGREGATION_POLICIES_PROTO_EXPORT_H diff --git a/google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies_rest_connection.cc b/google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies_rest_connection.cc new file mode 100644 index 0000000000000..b8956aa2d8861 --- /dev/null +++ b/google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies_rest_connection.cc @@ -0,0 +1,61 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies.proto + +#include "google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies_rest_connection.h" +#include "google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_option_defaults.h" +#include "google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_rest_connection_impl.h" +#include "google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_rest_stub_factory.h" +#include "google/cloud/compute/region_health_aggregation_policies/v1/internal/region_health_aggregation_policies_tracing_connection.h" +#include "google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies_options.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/internal/rest_background_threads_impl.h" +#include "google/cloud/internal/rest_options.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_health_aggregation_policies_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +std::shared_ptr +MakeRegionHealthAggregationPoliciesConnectionRest(Options options) { + internal::CheckExpectedOptions< + CommonOptionList, RestOptionList, UnifiedCredentialsOptionList, + rest_internal::TargetApiVersionOption, + RegionHealthAggregationPoliciesPolicyOptionList>(options, __func__); + options = compute_region_health_aggregation_policies_v1_internal:: + RegionHealthAggregationPoliciesDefaultOptions(std::move(options)); + auto background = std::make_unique< + rest_internal::AutomaticallyCreatedRestBackgroundThreads>(); + auto stub = compute_region_health_aggregation_policies_v1_internal:: + CreateDefaultRegionHealthAggregationPoliciesRestStub(options); + return compute_region_health_aggregation_policies_v1_internal:: + MakeRegionHealthAggregationPoliciesTracingConnection( + std::make_shared< + compute_region_health_aggregation_policies_v1_internal:: + RegionHealthAggregationPoliciesRestConnectionImpl>( + std::move(background), std::move(stub), std::move(options))); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_health_aggregation_policies_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies_rest_connection.h b/google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies_rest_connection.h new file mode 100644 index 0000000000000..275a166ce37be --- /dev/null +++ b/google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies_rest_connection.h @@ -0,0 +1,68 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_AGGREGATION_POLICIES_V1_REGION_HEALTH_AGGREGATION_POLICIES_REST_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_AGGREGATION_POLICIES_V1_REGION_HEALTH_AGGREGATION_POLICIES_REST_CONNECTION_H + +#include "google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies_connection.h" +#include "google/cloud/options.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_health_aggregation_policies_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/** + * A factory function to construct an object of type + * `RegionHealthAggregationPoliciesConnection` that uses REST over HTTP as + * transport in lieu of gRPC. REST transport should only be used for services + * that do not support gRPC or if the existing network configuration precludes + * using gRPC. + * + * The returned connection object should not be used directly; instead it + * should be passed as an argument to the constructor of + * RegionHealthAggregationPoliciesClient. + * + * The optional @p options argument may be used to configure aspects of the + * returned `RegionHealthAggregationPoliciesConnection`. Expected options are + * any of the types in the following option lists: + * + * - `google::cloud::CommonOptionList` + * - `google::cloud::RestOptionList` + * - `google::cloud::UnifiedCredentialsOptionList` + * - + * `google::cloud::compute_region_health_aggregation_policies_v1::RegionHealthAggregationPoliciesPolicyOptionList` + * + * @note Unexpected options will be ignored. To log unexpected options instead, + * set `GOOGLE_CLOUD_CPP_ENABLE_CLOG=yes` in the environment. + * + * @param options (optional) Configure the + * `RegionHealthAggregationPoliciesConnection` created by this function. + */ +std::shared_ptr +MakeRegionHealthAggregationPoliciesConnectionRest(Options options = {}); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_health_aggregation_policies_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_AGGREGATION_POLICIES_V1_REGION_HEALTH_AGGREGATION_POLICIES_REST_CONNECTION_H diff --git a/google/cloud/compute/region_health_aggregation_policies/v1/samples/region_health_aggregation_policies_client_samples.cc b/google/cloud/compute/region_health_aggregation_policies/v1/samples/region_health_aggregation_policies_client_samples.cc new file mode 100644 index 0000000000000..fd531b27db3a2 --- /dev/null +++ b/google/cloud/compute/region_health_aggregation_policies/v1/samples/region_health_aggregation_policies_client_samples.cc @@ -0,0 +1,252 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies.proto + +#include "google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies_client.h" +#include "google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies_connection_idempotency_policy.h" +#include "google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies_options.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/internal/getenv.h" +#include "google/cloud/polling_policy.h" +#include "google/cloud/testing_util/example_driver.h" +#include "google/cloud/universe_domain.h" +#include +#include +#include +#include + +// clang-format off +// main-dox-marker: compute_region_health_aggregation_policies_v1::RegionHealthAggregationPoliciesClient +// lro-marker: true +// clang-format on +namespace { + +void SetClientEndpoint(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-endpoint"}; + } + //! [set-client-endpoint] + // This configuration is common with Private Google Access: + // https://cloud.google.com/vpc/docs/private-google-access + auto options = google::cloud::Options{}.set( + "private.googleapis.com"); + auto vpc_client = + google::cloud::compute_region_health_aggregation_policies_v1:: + RegionHealthAggregationPoliciesClient( + google::cloud::compute_region_health_aggregation_policies_v1:: + MakeRegionHealthAggregationPoliciesConnectionRest(options)); + //! [set-client-endpoint] +} + +void SetClientUniverseDomain(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-universe-domain"}; + } + //! [set-client-universe-domain] + google::cloud::Options options; + + // AddUniverseDomainOption interrogates the UnifiedCredentialsOption, if set, + // in the provided Options for the Universe Domain associated with the + // credentials and adds it to the set of Options. + // If no UnifiedCredentialsOption is set, GoogleDefaultCredentials are used. + auto ud_options = google::cloud::AddUniverseDomainOption(std::move(options)); + + if (!ud_options.ok()) throw std::move(ud_options).status(); + auto ud_client = + google::cloud::compute_region_health_aggregation_policies_v1:: + RegionHealthAggregationPoliciesClient( + google::cloud::compute_region_health_aggregation_policies_v1:: + MakeRegionHealthAggregationPoliciesConnectionRest( + *ud_options)); + //! [set-client-universe-domain] +} + +//! [custom-idempotency-policy] +class CustomIdempotencyPolicy + : public google::cloud::compute_region_health_aggregation_policies_v1:: + RegionHealthAggregationPoliciesConnectionIdempotencyPolicy { + public: + ~CustomIdempotencyPolicy() override = default; + std::unique_ptr< + google::cloud::compute_region_health_aggregation_policies_v1:: + RegionHealthAggregationPoliciesConnectionIdempotencyPolicy> + clone() const override { + return std::make_unique(*this); + } + // Override inherited functions to define as needed. +}; +//! [custom-idempotency-policy] + +void SetRetryPolicy(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-retry-policy"}; + } + //! [set-retry-policy] + auto options = + google::cloud::Options{} + .set< + google::cloud::compute_region_health_aggregation_policies_v1:: + RegionHealthAggregationPoliciesConnectionIdempotencyPolicyOption>( + CustomIdempotencyPolicy().clone()) + .set( + google::cloud::compute_region_health_aggregation_policies_v1:: + RegionHealthAggregationPoliciesLimitedErrorCountRetryPolicy(3) + .clone()) + .set( + google::cloud::ExponentialBackoffPolicy( + /*initial_delay=*/std::chrono::milliseconds(200), + /*maximum_delay=*/std::chrono::seconds(45), + /*scaling=*/2.0) + .clone()); + auto connection = + google::cloud::compute_region_health_aggregation_policies_v1:: + MakeRegionHealthAggregationPoliciesConnectionRest(options); + + // c1 and c2 share the same retry policies + auto c1 = google::cloud::compute_region_health_aggregation_policies_v1:: + RegionHealthAggregationPoliciesClient(connection); + auto c2 = google::cloud::compute_region_health_aggregation_policies_v1:: + RegionHealthAggregationPoliciesClient(connection); + + // You can override any of the policies in a new client. This new client + // will share the policies from c1 (or c2) *except* for the retry policy. + auto c3 = google::cloud::compute_region_health_aggregation_policies_v1:: + RegionHealthAggregationPoliciesClient( + connection, + google::cloud::Options{} + .set< + google::cloud::compute_region_health_aggregation_policies_v1:: + RegionHealthAggregationPoliciesRetryPolicyOption>( + google::cloud::compute_region_health_aggregation_policies_v1:: + RegionHealthAggregationPoliciesLimitedTimeRetryPolicy( + std::chrono::minutes(5)) + .clone())); + + // You can also override the policies in a single call: + // c3.SomeRpc(..., google::cloud::Options{} + // .set( + // google::cloud::compute_region_health_aggregation_policies_v1::RegionHealthAggregationPoliciesLimitedErrorCountRetryPolicy(10).clone())); + //! [set-retry-policy] +} + +void SetPollingPolicy(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-policy-policy"}; + } + //! [set-polling-policy] + + // The polling policy controls how the client waits for long-running + // operations. `GenericPollingPolicy<>` combines existing policies. + // In this case, keep polling until the operation completes (with success + // or error) or 45 minutes, whichever happens first. Initially pause for + // 10 seconds between polling requests, increasing the pause by a factor + // of 4 until it becomes 2 minutes. + auto options = + google::cloud::Options{} + .set( + google::cloud::GenericPollingPolicy< + google::cloud::compute_region_health_aggregation_policies_v1:: + RegionHealthAggregationPoliciesRetryPolicyOption::Type, + google::cloud::compute_region_health_aggregation_policies_v1:: + RegionHealthAggregationPoliciesBackoffPolicyOption::Type>( + google::cloud::compute_region_health_aggregation_policies_v1:: + RegionHealthAggregationPoliciesLimitedTimeRetryPolicy( + /*maximum_duration=*/std::chrono::minutes(45)) + .clone(), + google::cloud::ExponentialBackoffPolicy( + /*initial_delay=*/std::chrono::seconds(10), + /*maximum_delay=*/std::chrono::minutes(2), + /*scaling=*/4.0) + .clone()) + .clone()); + + auto connection = + google::cloud::compute_region_health_aggregation_policies_v1:: + MakeRegionHealthAggregationPoliciesConnectionRest(options); + + // c1 and c2 share the same polling policies. + auto c1 = google::cloud::compute_region_health_aggregation_policies_v1:: + RegionHealthAggregationPoliciesClient(connection); + auto c2 = google::cloud::compute_region_health_aggregation_policies_v1:: + RegionHealthAggregationPoliciesClient(connection); + //! [set-polling-policy] +} + +void WithServiceAccount(std::vector const& argv) { + if (argv.size() != 1 || argv[0] == "--help") { + throw google::cloud::testing_util::Usage{"with-service-account "}; + } + //! [with-service-account] + [](std::string const& keyfile) { + auto is = std::ifstream(keyfile); + is.exceptions(std::ios::badbit); // Minimal error handling in examples + auto contents = std::string(std::istreambuf_iterator(is.rdbuf()), {}); + auto options = + google::cloud::Options{}.set( + google::cloud::MakeServiceAccountCredentials(contents)); + return google::cloud::compute_region_health_aggregation_policies_v1:: + RegionHealthAggregationPoliciesClient( + google::cloud::compute_region_health_aggregation_policies_v1:: + MakeRegionHealthAggregationPoliciesConnectionRest(options)); + } + //! [with-service-account] + (argv.at(0)); +} + +void AutoRun(std::vector const& argv) { + namespace examples = ::google::cloud::testing_util; + using ::google::cloud::internal::GetEnv; + if (!argv.empty()) throw examples::Usage{"auto"}; + examples::CheckEnvironmentVariablesAreSet( + {"GOOGLE_CLOUD_CPP_TEST_SERVICE_ACCOUNT_KEYFILE"}); + auto const keyfile = + GetEnv("GOOGLE_CLOUD_CPP_TEST_SERVICE_ACCOUNT_KEYFILE").value(); + + std::cout << "\nRunning SetClientEndpoint() example" << std::endl; + SetClientEndpoint({}); + + std::cout << "\nRunning SetRetryPolicy() example" << std::endl; + SetRetryPolicy({}); + + std::cout << "\nRunning SetPollingPolicy() example" << std::endl; + SetPollingPolicy({}); + + std::cout << "\nRunning WithServiceAccount() example" << std::endl; + WithServiceAccount({keyfile}); + + std::cout << "\nRunning SetClientUniverseDomain() example" << std::endl; + SetClientUniverseDomain({}); +} + +} // namespace + +int main(int argc, char* argv[]) { // NOLINT(bugprone-exception-escape) + google::cloud::testing_util::Example example({ + {"set-client-endpoint", SetClientEndpoint}, + {"set-retry-policy", SetRetryPolicy}, + {"set-polling-policy", SetPollingPolicy}, + {"with-service-account", WithServiceAccount}, + {"set-client-universe-domain", SetClientUniverseDomain}, + {"auto", AutoRun}, + }); + return example.Run(argc, argv); +} diff --git a/google/cloud/compute/region_health_check_services/v1/internal/region_health_check_services_rest_connection_impl.cc b/google/cloud/compute/region_health_check_services/v1/internal/region_health_check_services_rest_connection_impl.cc index cf1f5ee644ac1..9951ca9f81d32 100644 --- a/google/cloud/compute/region_health_check_services/v1/internal/region_health_check_services_rest_connection_impl.cc +++ b/google/cloud/compute/region_health_check_services/v1/internal/region_health_check_services_rest_connection_impl.cc @@ -48,6 +48,53 @@ RegionHealthCheckServicesRestConnectionImpl:: std::move(options), RegionHealthCheckServicesConnection::options())) { } +StreamRange< + std::pair> +RegionHealthCheckServicesRestConnectionImpl:: + AggregatedListRegionHealthCheckServices( + google::cloud::cpp::compute::region_health_check_services::v1:: + AggregatedListRegionHealthCheckServicesRequest request) { + request.clear_page_token(); + auto current = google::cloud::internal::SaveCurrentOptions(); + auto idempotency = + idempotency_policy(*current)->AggregatedListRegionHealthCheckServices( + request); + char const* function_name = __func__; + return google::cloud::internal::MakePaginationRange>>( + current, std::move(request), + [idempotency, function_name, stub = stub_, + retry = std::shared_ptr( + retry_policy(*current)), + backoff = std::shared_ptr(backoff_policy(*current))]( + Options const& options, + google::cloud::cpp::compute::region_health_check_services::v1:: + AggregatedListRegionHealthCheckServicesRequest const& r) { + return google::cloud::rest_internal::RestRetryLoop( + retry->clone(), backoff->clone(), idempotency, + [stub](rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_check_services:: + v1::AggregatedListRegionHealthCheckServicesRequest const& + request) { + return stub->AggregatedListRegionHealthCheckServices( + rest_context, options, request); + }, + options, r, function_name); + }, + [](google::cloud::cpp::compute::v1::HealthCheckServiceAggregatedList r) { + std::vector> + result(r.items().size()); + auto& messages = *r.mutable_items(); + std::move(messages.begin(), messages.end(), result.begin()); + return result; + }); +} + future> RegionHealthCheckServicesRestConnectionImpl::DeleteHealthCheckService( google::cloud::cpp::compute::region_health_check_services::v1:: @@ -498,6 +545,22 @@ RegionHealthCheckServicesRestConnectionImpl::PatchHealthCheckService( }); } +StatusOr +RegionHealthCheckServicesRestConnectionImpl::TestIamPermissions( + google::cloud::cpp::compute::region_health_check_services::v1:: + TestIamPermissionsRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->TestIamPermissions(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_health_check_services::v1:: + TestIamPermissionsRequest const& request) { + return stub_->TestIamPermissions(rest_context, options, request); + }, + *current, request, __func__); +} + GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END } // namespace compute_region_health_check_services_v1_internal } // namespace cloud diff --git a/google/cloud/compute/region_health_check_services/v1/internal/region_health_check_services_rest_connection_impl.h b/google/cloud/compute/region_health_check_services/v1/internal/region_health_check_services_rest_connection_impl.h index 62eda76e04b2c..dd01cba3f9648 100644 --- a/google/cloud/compute/region_health_check_services/v1/internal/region_health_check_services_rest_connection_impl.h +++ b/google/cloud/compute/region_health_check_services/v1/internal/region_health_check_services_rest_connection_impl.h @@ -54,6 +54,13 @@ class RegionHealthCheckServicesRestConnectionImpl Options options() override { return options_; } + StreamRange< + std::pair> + AggregatedListRegionHealthCheckServices( + google::cloud::cpp::compute::region_health_check_services::v1:: + AggregatedListRegionHealthCheckServicesRequest request) override; + future> DeleteHealthCheckService( google::cloud::cpp::compute::region_health_check_services::v1:: @@ -106,6 +113,10 @@ class RegionHealthCheckServicesRestConnectionImpl PatchHealthCheckService( google::cloud::cpp::compute::v1::Operation const& operation) override; + StatusOr + TestIamPermissions(google::cloud::cpp::compute::region_health_check_services:: + v1::TestIamPermissionsRequest const& request) override; + private: static std::unique_ptr diff --git a/google/cloud/compute/region_health_check_services/v1/internal/region_health_check_services_rest_logging_decorator.cc b/google/cloud/compute/region_health_check_services/v1/internal/region_health_check_services_rest_logging_decorator.cc index 1e9ce1d9def8c..67ebc43bfa8ec 100644 --- a/google/cloud/compute/region_health_check_services/v1/internal/region_health_check_services_rest_logging_decorator.cc +++ b/google/cloud/compute/region_health_check_services/v1/internal/region_health_check_services_rest_logging_decorator.cc @@ -35,6 +35,22 @@ RegionHealthCheckServicesRestLogging::RegionHealthCheckServicesRestLogging( tracing_options_(std::move(tracing_options)), components_(std::move(components)) {} +StatusOr +RegionHealthCheckServicesRestLogging::AggregatedListRegionHealthCheckServices( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_health_check_services::v1:: + AggregatedListRegionHealthCheckServicesRequest const& request) { + return google::cloud::internal::LogWrapper( + [this]( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_health_check_services::v1:: + AggregatedListRegionHealthCheckServicesRequest const& request) { + return child_->AggregatedListRegionHealthCheckServices( + rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + future> RegionHealthCheckServicesRestLogging::AsyncDeleteHealthCheckService( CompletionQueue& cq, @@ -166,6 +182,20 @@ RegionHealthCheckServicesRestLogging::PatchHealthCheckService( rest_context, options, request, __func__, tracing_options_); } +StatusOr +RegionHealthCheckServicesRestLogging::TestIamPermissions( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_health_check_services::v1:: + TestIamPermissionsRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_health_check_services::v1:: + TestIamPermissionsRequest const& request) { + return child_->TestIamPermissions(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + future> RegionHealthCheckServicesRestLogging::AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/region_health_check_services/v1/internal/region_health_check_services_rest_logging_decorator.h b/google/cloud/compute/region_health_check_services/v1/internal/region_health_check_services_rest_logging_decorator.h index ab266db99d23b..b46e314d06f7c 100644 --- a/google/cloud/compute/region_health_check_services/v1/internal/region_health_check_services_rest_logging_decorator.h +++ b/google/cloud/compute/region_health_check_services/v1/internal/region_health_check_services_rest_logging_decorator.h @@ -44,6 +44,14 @@ class RegionHealthCheckServicesRestLogging std::shared_ptr child, TracingOptions tracing_options, std::set components); + StatusOr + AggregatedListRegionHealthCheckServices( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_check_services::v1:: + AggregatedListRegionHealthCheckServicesRequest const& request) + override; + future> AsyncDeleteHealthCheckService( google::cloud::CompletionQueue& cq, @@ -100,6 +108,12 @@ class RegionHealthCheckServicesRestLogging google::cloud::cpp::compute::region_health_check_services::v1:: PatchHealthCheckServiceRequest const& request) override; + StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_check_services:: + v1::TestIamPermissionsRequest const& request) override; + future> AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/region_health_check_services/v1/internal/region_health_check_services_rest_metadata_decorator.cc b/google/cloud/compute/region_health_check_services/v1/internal/region_health_check_services_rest_metadata_decorator.cc index eb2a69c33ee0b..e9b80d5575271 100644 --- a/google/cloud/compute/region_health_check_services/v1/internal/region_health_check_services_rest_metadata_decorator.cc +++ b/google/cloud/compute/region_health_check_services/v1/internal/region_health_check_services_rest_metadata_decorator.cc @@ -40,6 +40,16 @@ RegionHealthCheckServicesRestMetadata::RegionHealthCheckServicesRestMetadata( ? google::cloud::internal::GeneratedLibClientHeader() : std::move(api_client_header)) {} +StatusOr +RegionHealthCheckServicesRestMetadata::AggregatedListRegionHealthCheckServices( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_health_check_services::v1:: + AggregatedListRegionHealthCheckServicesRequest const& request) { + SetMetadata(rest_context, options); + return child_->AggregatedListRegionHealthCheckServices(rest_context, options, + request); +} + future> RegionHealthCheckServicesRestMetadata::AsyncDeleteHealthCheckService( CompletionQueue& cq, @@ -121,6 +131,15 @@ RegionHealthCheckServicesRestMetadata::PatchHealthCheckService( return child_->PatchHealthCheckService(rest_context, options, request); } +StatusOr +RegionHealthCheckServicesRestMetadata::TestIamPermissions( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_health_check_services::v1:: + TestIamPermissionsRequest const& request) { + SetMetadata(rest_context, options); + return child_->TestIamPermissions(rest_context, options, request); +} + future> RegionHealthCheckServicesRestMetadata::AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/region_health_check_services/v1/internal/region_health_check_services_rest_metadata_decorator.h b/google/cloud/compute/region_health_check_services/v1/internal/region_health_check_services_rest_metadata_decorator.h index 669298532b390..e597aca667ee1 100644 --- a/google/cloud/compute/region_health_check_services/v1/internal/region_health_check_services_rest_metadata_decorator.h +++ b/google/cloud/compute/region_health_check_services/v1/internal/region_health_check_services_rest_metadata_decorator.h @@ -42,6 +42,14 @@ class RegionHealthCheckServicesRestMetadata std::shared_ptr child, std::string api_client_header = ""); + StatusOr + AggregatedListRegionHealthCheckServices( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_check_services::v1:: + AggregatedListRegionHealthCheckServicesRequest const& request) + override; + google::cloud::future> AsyncDeleteHealthCheckService( google::cloud::CompletionQueue& cq, @@ -98,6 +106,12 @@ class RegionHealthCheckServicesRestMetadata google::cloud::cpp::compute::region_health_check_services::v1:: PatchHealthCheckServiceRequest const& request) override; + StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_check_services:: + v1::TestIamPermissionsRequest const& request) override; + google::cloud::future> AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/region_health_check_services/v1/internal/region_health_check_services_rest_stub.cc b/google/cloud/compute/region_health_check_services/v1/internal/region_health_check_services_rest_stub.cc index af9bb1012a88c..743d92b0e2c28 100644 --- a/google/cloud/compute/region_health_check_services/v1/internal/region_health_check_services_rest_stub.cc +++ b/google/cloud/compute/region_health_check_services/v1/internal/region_health_check_services_rest_stub.cc @@ -48,6 +48,37 @@ DefaultRegionHealthCheckServicesRestStub:: operations_(std::move(operations)), options_(std::move(options)) {} +StatusOr +DefaultRegionHealthCheckServicesRestStub:: + AggregatedListRegionHealthCheckServices( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_check_services::v1:: + AggregatedListRegionHealthCheckServicesRequest const& request) { + std::vector> query_params; + query_params.push_back({"filter", request.filter()}); + query_params.push_back( + {"include_all_scopes", (request.include_all_scopes() ? "1" : "0")}); + query_params.push_back( + {"max_results", std::to_string(request.max_results())}); + query_params.push_back({"order_by", request.order_by()}); + query_params.push_back({"page_token", request.page_token()}); + query_params.push_back({"return_partial_success", + (request.return_partial_success() ? "1" : "0")}); + query_params.push_back( + {"service_project_number", request.service_project_number()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Get< + google::cloud::cpp::compute::v1::HealthCheckServiceAggregatedList>( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "aggregated", "/", + "healthCheckServices"), + std::move(query_params)); +} + future> DefaultRegionHealthCheckServicesRestStub::AsyncDeleteHealthCheckService( CompletionQueue& cq, @@ -266,6 +297,25 @@ DefaultRegionHealthCheckServicesRestStub::PatchHealthCheckService( std::move(query_params)); } +StatusOr +DefaultRegionHealthCheckServicesRestStub::TestIamPermissions( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_check_services::v1:: + TestIamPermissionsRequest const& request) { + std::vector> query_params; + return rest_internal::Post< + google::cloud::cpp::compute::v1::TestPermissionsResponse>( + *service_, rest_context, request.test_permissions_request_resource(), + false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "regions", "/", + request.region(), "/", "healthCheckServices", "/", + request.resource(), "/", "testIamPermissions"), + std::move(query_params)); +} + future> DefaultRegionHealthCheckServicesRestStub::AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/region_health_check_services/v1/internal/region_health_check_services_rest_stub.h b/google/cloud/compute/region_health_check_services/v1/internal/region_health_check_services_rest_stub.h index 225bb02adafcb..39a7b29d22d62 100644 --- a/google/cloud/compute/region_health_check_services/v1/internal/region_health_check_services_rest_stub.h +++ b/google/cloud/compute/region_health_check_services/v1/internal/region_health_check_services_rest_stub.h @@ -38,6 +38,14 @@ class RegionHealthCheckServicesRestStub { public: virtual ~RegionHealthCheckServicesRestStub() = default; + virtual StatusOr< + google::cloud::cpp::compute::v1::HealthCheckServiceAggregatedList> + AggregatedListRegionHealthCheckServices( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_check_services::v1:: + AggregatedListRegionHealthCheckServicesRequest const& request) = 0; + virtual future> AsyncDeleteHealthCheckService( google::cloud::CompletionQueue& cq, @@ -97,6 +105,12 @@ class RegionHealthCheckServicesRestStub { google::cloud::cpp::compute::region_health_check_services::v1:: PatchHealthCheckServiceRequest const& request) = 0; + virtual StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_check_services:: + v1::TestIamPermissionsRequest const& request) = 0; + virtual future> AsyncGetOperation( google::cloud::CompletionQueue& cq, @@ -123,6 +137,14 @@ class DefaultRegionHealthCheckServicesRestStub std::shared_ptr service, std::shared_ptr operations, Options options); + StatusOr + AggregatedListRegionHealthCheckServices( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_check_services::v1:: + AggregatedListRegionHealthCheckServicesRequest const& request) + override; + future> AsyncDeleteHealthCheckService( google::cloud::CompletionQueue& cq, @@ -179,6 +201,12 @@ class DefaultRegionHealthCheckServicesRestStub google::cloud::cpp::compute::region_health_check_services::v1:: PatchHealthCheckServiceRequest const& request) override; + StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_check_services:: + v1::TestIamPermissionsRequest const& request) override; + future> AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/region_health_check_services/v1/internal/region_health_check_services_tracing_connection.cc b/google/cloud/compute/region_health_check_services/v1/internal/region_health_check_services_tracing_connection.cc index 45054b8035ae3..3e39e1e5bb15f 100644 --- a/google/cloud/compute/region_health_check_services/v1/internal/region_health_check_services_tracing_connection.cc +++ b/google/cloud/compute/region_health_check_services/v1/internal/region_health_check_services_tracing_connection.cc @@ -35,6 +35,25 @@ RegionHealthCheckServicesTracingConnection:: child) : child_(std::move(child)) {} +StreamRange< + std::pair> +RegionHealthCheckServicesTracingConnection:: + AggregatedListRegionHealthCheckServices( + google::cloud::cpp::compute::region_health_check_services::v1:: + AggregatedListRegionHealthCheckServicesRequest request) { + auto span = internal::MakeSpan( + "compute_region_health_check_services_v1::" + "RegionHealthCheckServicesConnection::" + "AggregatedListRegionHealthCheckServices"); + internal::OTelScope scope(span); + auto sr = child_->AggregatedListRegionHealthCheckServices(std::move(request)); + return internal::MakeTracedStreamRange>( + std::move(span), std::move(sr)); +} + future> RegionHealthCheckServicesTracingConnection::DeleteHealthCheckService( google::cloud::cpp::compute::region_health_check_services::v1:: @@ -165,6 +184,17 @@ RegionHealthCheckServicesTracingConnection::PatchHealthCheckService( child_->PatchHealthCheckService(operation)); } +StatusOr +RegionHealthCheckServicesTracingConnection::TestIamPermissions( + google::cloud::cpp::compute::region_health_check_services::v1:: + TestIamPermissionsRequest const& request) { + auto span = internal::MakeSpan( + "compute_region_health_check_services_v1::" + "RegionHealthCheckServicesConnection::TestIamPermissions"); + auto scope = opentelemetry::trace::Scope(span); + return internal::EndSpan(*span, child_->TestIamPermissions(request)); +} + std::shared_ptr MakeRegionHealthCheckServicesTracingConnection( diff --git a/google/cloud/compute/region_health_check_services/v1/internal/region_health_check_services_tracing_connection.h b/google/cloud/compute/region_health_check_services/v1/internal/region_health_check_services_tracing_connection.h index 4385443e7406c..b0dc85098ed08 100644 --- a/google/cloud/compute/region_health_check_services/v1/internal/region_health_check_services_tracing_connection.h +++ b/google/cloud/compute/region_health_check_services/v1/internal/region_health_check_services_tracing_connection.h @@ -42,6 +42,13 @@ class RegionHealthCheckServicesTracingConnection Options options() override { return child_->options(); } + StreamRange< + std::pair> + AggregatedListRegionHealthCheckServices( + google::cloud::cpp::compute::region_health_check_services::v1:: + AggregatedListRegionHealthCheckServicesRequest request) override; + future> DeleteHealthCheckService( google::cloud::cpp::compute::region_health_check_services::v1:: @@ -94,6 +101,10 @@ class RegionHealthCheckServicesTracingConnection PatchHealthCheckService( google::cloud::cpp::compute::v1::Operation const& operation) override; + StatusOr + TestIamPermissions(google::cloud::cpp::compute::region_health_check_services:: + v1::TestIamPermissionsRequest const& request) override; + private: std::shared_ptr diff --git a/google/cloud/compute/region_health_check_services/v1/mocks/mock_region_health_check_services_connection.h b/google/cloud/compute/region_health_check_services/v1/mocks/mock_region_health_check_services_connection.h index 2b941fbff1648..d341e59476ca3 100644 --- a/google/cloud/compute/region_health_check_services/v1/mocks/mock_region_health_check_services_connection.h +++ b/google/cloud/compute/region_health_check_services/v1/mocks/mock_region_health_check_services_connection.h @@ -49,6 +49,14 @@ class MockRegionHealthCheckServicesConnection public: MOCK_METHOD(Options, options, (), (override)); + MOCK_METHOD( + (StreamRange>), + AggregatedListRegionHealthCheckServices, + (google::cloud::cpp::compute::region_health_check_services::v1:: + AggregatedListRegionHealthCheckServicesRequest request), + (override)); + /// To disambiguate calls, use: /// /// @code @@ -187,6 +195,13 @@ class MockRegionHealthCheckServicesConnection PatchHealthCheckService, (google::cloud::cpp::compute::v1::Operation const& operation), (override)); + + MOCK_METHOD( + StatusOr, + TestIamPermissions, + (google::cloud::cpp::compute::region_health_check_services::v1:: + TestIamPermissionsRequest const& request), + (override)); }; GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END diff --git a/google/cloud/compute/region_health_check_services/v1/region_health_check_services_client.cc b/google/cloud/compute/region_health_check_services/v1/region_health_check_services_client.cc index 9807f42d7cfd8..24487257006bd 100644 --- a/google/cloud/compute/region_health_check_services/v1/region_health_check_services_client.cc +++ b/google/cloud/compute/region_health_check_services/v1/region_health_check_services_client.cc @@ -34,6 +34,30 @@ RegionHealthCheckServicesClient::RegionHealthCheckServicesClient( internal::MergeOptions(std::move(opts), connection_->options())) {} RegionHealthCheckServicesClient::~RegionHealthCheckServicesClient() = default; +StreamRange< + std::pair> +RegionHealthCheckServicesClient::AggregatedListRegionHealthCheckServices( + std::string const& project, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_health_check_services::v1:: + AggregatedListRegionHealthCheckServicesRequest request; + request.set_project(project); + return connection_->AggregatedListRegionHealthCheckServices(request); +} + +StreamRange< + std::pair> +RegionHealthCheckServicesClient::AggregatedListRegionHealthCheckServices( + google::cloud::cpp::compute::region_health_check_services::v1:: + AggregatedListRegionHealthCheckServicesRequest request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->AggregatedListRegionHealthCheckServices( + std::move(request)); +} + future> RegionHealthCheckServicesClient::DeleteHealthCheckService( std::string const& project, std::string const& region, @@ -248,6 +272,33 @@ RegionHealthCheckServicesClient::PatchHealthCheckService( return connection_->PatchHealthCheckService(operation); } +StatusOr +RegionHealthCheckServicesClient::TestIamPermissions( + std::string const& project, std::string const& region, + std::string const& resource, + google::cloud::cpp::compute::v1::TestPermissionsRequest const& + test_permissions_request_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_health_check_services::v1:: + TestIamPermissionsRequest request; + request.set_project(project); + request.set_region(region); + request.set_resource(resource); + *request.mutable_test_permissions_request_resource() = + test_permissions_request_resource; + return connection_->TestIamPermissions(request); +} + +StatusOr +RegionHealthCheckServicesClient::TestIamPermissions( + google::cloud::cpp::compute::region_health_check_services::v1:: + TestIamPermissionsRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->TestIamPermissions(request); +} + GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END } // namespace compute_region_health_check_services_v1 } // namespace cloud 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..cd2bb920374c7 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 @@ -27,6 +27,7 @@ #include "google/cloud/polling_policy.h" #include "google/cloud/status_or.h" #include "google/cloud/version.h" +#include #include #include @@ -92,6 +93,97 @@ class RegionHealthCheckServicesClient { } ///@} + // clang-format off + /// + /// Retrieves the list of all HealthCheckService resources, + /// regional and global, available to the specified project. + /// + /// To prevent failure, it is recommended that you set the + /// `returnPartialSuccess` parameter to `true`. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionHealthCheckServices/aggregatedList + /// + /// @param project Name of the project scoping this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return a [StreamRange](@ref google::cloud::StreamRange) + /// to iterate of the results. See the documentation of this type for + /// details. In brief, this class has `begin()` and `end()` member + /// functions returning a iterator class meeting the + /// [input iterator requirements]. The value type for this iterator is a + /// [`StatusOr`] as the iteration may fail even after some values are + /// retrieved successfully, for example, if there is a network disconnect. + /// An empty set of results does not indicate an error, it indicates + /// that there are no resources meeting the request criteria. + /// On a successful iteration the `StatusOr` contains elements of type + /// [google.cloud.cpp.compute.v1.HealthCheckServicesScopedList], or rather, + /// the C++ class generated by Protobuf from that type. Please consult the + /// Protobuf documentation for details on the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_health_check_services.v1.AggregatedListRegionHealthCheckServicesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_check_services/v1/region_health_check_services.proto#L134} + /// [google.cloud.cpp.compute.v1.HealthCheckServicesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_062.proto#L394} + /// + // clang-format on + StreamRange< + std::pair> + AggregatedListRegionHealthCheckServices(std::string const& project, + Options opts = {}); + + // clang-format off + /// + /// Retrieves the list of all HealthCheckService resources, + /// regional and global, available to the specified project. + /// + /// To prevent failure, it is recommended that you set the + /// `returnPartialSuccess` parameter to `true`. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionHealthCheckServices/aggregatedList + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.region_health_check_services.v1.AggregatedListRegionHealthCheckServicesRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return a [StreamRange](@ref google::cloud::StreamRange) + /// to iterate of the results. See the documentation of this type for + /// details. In brief, this class has `begin()` and `end()` member + /// functions returning a iterator class meeting the + /// [input iterator requirements]. The value type for this iterator is a + /// [`StatusOr`] as the iteration may fail even after some values are + /// retrieved successfully, for example, if there is a network disconnect. + /// An empty set of results does not indicate an error, it indicates + /// that there are no resources meeting the request criteria. + /// On a successful iteration the `StatusOr` contains elements of type + /// [google.cloud.cpp.compute.v1.HealthCheckServicesScopedList], or rather, + /// the C++ class generated by Protobuf from that type. Please consult the + /// Protobuf documentation for details on the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_health_check_services.v1.AggregatedListRegionHealthCheckServicesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_check_services/v1/region_health_check_services.proto#L134} + /// [google.cloud.cpp.compute.v1.HealthCheckServicesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_062.proto#L394} + /// + // clang-format on + StreamRange< + std::pair> + AggregatedListRegionHealthCheckServices( + google::cloud::cpp::compute::region_health_check_services::v1:: + AggregatedListRegionHealthCheckServicesRequest request, + Options opts = {}); + // clang-format off /// /// Deletes the specified regional HealthCheckService. @@ -99,8 +191,8 @@ class RegionHealthCheckServicesClient { /// /// @param project Project ID for this request. /// @param region Name of the region scoping this request. - /// @param health_check_service Name of the HealthCheckService to delete. The name must be 1-63 characters - /// long, and comply with RFC1035. + /// @param health_check_service Name of the HealthCheckService to delete. The name + /// must be 1-63 characters long, and comply with RFC1035. /// @param opts Optional. Override the class-level options, such as retry and /// backoff policies. /// @return A [`future`] that becomes satisfied when the LRO @@ -121,7 +213,7 @@ class RegionHealthCheckServicesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_health_check_services.v1.DeleteHealthCheckServiceRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_check_services/v1/region_health_check_services.proto#L105} + /// [google.cloud.cpp.compute.region_health_check_services.v1.DeleteHealthCheckServiceRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_check_services/v1/region_health_check_services.proto#L249} /// // clang-format on future> @@ -176,7 +268,7 @@ class RegionHealthCheckServicesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_health_check_services.v1.DeleteHealthCheckServiceRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_check_services/v1/region_health_check_services.proto#L105} + /// [google.cloud.cpp.compute.region_health_check_services.v1.DeleteHealthCheckServiceRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_check_services/v1/region_health_check_services.proto#L249} /// // clang-format on future> @@ -223,8 +315,8 @@ class RegionHealthCheckServicesClient { /// /// @param project Project ID for this request. /// @param region Name of the region scoping this request. - /// @param health_check_service Name of the HealthCheckService to update. The name must be 1-63 characters - /// long, and comply with RFC1035. + /// @param health_check_service Name of the HealthCheckService to update. The name + /// must be 1-63 characters long, and comply with RFC1035. /// @param opts Optional. Override the class-level options, such as retry and /// backoff policies. /// @return the result of the RPC. The response message type @@ -238,8 +330,8 @@ class RegionHealthCheckServicesClient { /// [`future`]: @ref google::cloud::future /// [`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.region_health_check_services.v1.GetHealthCheckServiceRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_check_services/v1/region_health_check_services.proto#L288} + /// [google.cloud.cpp.compute.v1.HealthCheckService]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_062.proto#L25} /// // clang-format on StatusOr @@ -271,8 +363,8 @@ class RegionHealthCheckServicesClient { /// [`future`]: @ref google::cloud::future /// [`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.region_health_check_services.v1.GetHealthCheckServiceRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_check_services/v1/region_health_check_services.proto#L288} + /// [google.cloud.cpp.compute.v1.HealthCheckService]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_062.proto#L25} /// // clang-format on StatusOr @@ -283,8 +375,8 @@ class RegionHealthCheckServicesClient { // clang-format off /// - /// Creates a regional HealthCheckService resource in the specified project and - /// region using the data included in the request. + /// Creates a regional HealthCheckService resource in the + /// specified project and region using the data included in the request. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionHealthCheckServices/insert /// /// @param project Project ID for this request. @@ -310,7 +402,7 @@ class RegionHealthCheckServicesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_health_check_services.v1.InsertHealthCheckServiceRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_check_services/v1/region_health_check_services.proto#L159} + /// [google.cloud.cpp.compute.region_health_check_services.v1.InsertHealthCheckServiceRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_check_services/v1/region_health_check_services.proto#L306} /// // clang-format on future> @@ -339,8 +431,8 @@ class RegionHealthCheckServicesClient { // clang-format off /// - /// Creates a regional HealthCheckService resource in the specified project and - /// region using the data included in the request. + /// Creates a regional HealthCheckService resource in the + /// specified project and region using the data included in the request. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionHealthCheckServices/insert /// /// @param request Unary RPCs, such as the one wrapped by this @@ -369,7 +461,7 @@ class RegionHealthCheckServicesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_health_check_services.v1.InsertHealthCheckServiceRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_check_services/v1/region_health_check_services.proto#L159} + /// [google.cloud.cpp.compute.region_health_check_services.v1.InsertHealthCheckServiceRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_check_services/v1/region_health_check_services.proto#L306} /// // clang-format on future> @@ -411,8 +503,8 @@ class RegionHealthCheckServicesClient { // clang-format off /// - /// Lists all the HealthCheckService resources that have been configured for - /// the specified project in the given region. + /// Lists all the HealthCheckService resources that have been + /// configured for the specified project in the given region. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionHealthCheckServices/list /// /// @param project Project ID for this request. @@ -439,8 +531,8 @@ class RegionHealthCheckServicesClient { /// [`future`]: @ref google::cloud::future /// [`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.region_health_check_services.v1.ListRegionHealthCheckServicesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_check_services/v1/region_health_check_services.proto#L342} + /// [google.cloud.cpp.compute.v1.HealthCheckService]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_062.proto#L25} /// // clang-format on StreamRange @@ -449,8 +541,8 @@ class RegionHealthCheckServicesClient { // clang-format off /// - /// Lists all the HealthCheckService resources that have been configured for - /// the specified project in the given region. + /// Lists all the HealthCheckService resources that have been + /// configured for the specified project in the given region. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionHealthCheckServices/list /// /// @param request Unary RPCs, such as the one wrapped by this @@ -481,8 +573,8 @@ class RegionHealthCheckServicesClient { /// [`future`]: @ref google::cloud::future /// [`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.region_health_check_services.v1.ListRegionHealthCheckServicesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_check_services/v1/region_health_check_services.proto#L342} + /// [google.cloud.cpp.compute.v1.HealthCheckService]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_062.proto#L25} /// // clang-format on StreamRange @@ -493,15 +585,16 @@ class RegionHealthCheckServicesClient { // clang-format off /// - /// 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. + /// Updates the specified regional HealthCheckService resource + /// with the data included in the request. This method supportsPATCH + /// semantics and uses theJSON merge + /// patch format and processing rules. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionHealthCheckServices/patch /// /// @param project Project ID for this request. /// @param region Name of the region scoping this request. - /// @param health_check_service Name of the HealthCheckService to update. The name must be 1-63 characters - /// long, and comply with RFC1035. + /// @param health_check_service Name of the HealthCheckService to update. The name + /// must be 1-63 characters long, and comply with RFC1035. /// @param health_check_service_resource The HealthCheckService for this request. /// @param opts Optional. Override the class-level options, such as retry and /// backoff policies. @@ -523,7 +616,7 @@ class RegionHealthCheckServicesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_health_check_services.v1.PatchHealthCheckServiceRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_check_services/v1/region_health_check_services.proto#L264} + /// [google.cloud.cpp.compute.region_health_check_services.v1.PatchHealthCheckServiceRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_check_services/v1/region_health_check_services.proto#L447} /// // clang-format on future> @@ -554,9 +647,10 @@ class RegionHealthCheckServicesClient { // clang-format off /// - /// 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. + /// Updates the specified regional HealthCheckService resource + /// with the data included in the request. This method supportsPATCH + /// semantics and uses theJSON merge + /// patch format and processing rules. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionHealthCheckServices/patch /// /// @param request Unary RPCs, such as the one wrapped by this @@ -585,7 +679,7 @@ class RegionHealthCheckServicesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_health_check_services.v1.PatchHealthCheckServiceRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_check_services/v1/region_health_check_services.proto#L264} + /// [google.cloud.cpp.compute.region_health_check_services.v1.PatchHealthCheckServiceRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_check_services/v1/region_health_check_services.proto#L447} /// // clang-format on future> @@ -625,6 +719,73 @@ class RegionHealthCheckServicesClient { google::cloud::cpp::compute::v1::Operation const& operation, Options opts = {}); + // clang-format off + /// + /// Returns permissions that a caller has on the specified resource. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionHealthCheckServices/testIamPermissions + /// + /// @param project Project ID for this request. + /// @param region The name of the region for this request. + /// @param resource Name or id of the resource for this request. + /// @param test_permissions_request_resource The TestPermissionsRequest for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.TestPermissionsResponse]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_health_check_services.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_check_services/v1/region_health_check_services.proto#L490} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} + /// + // clang-format on + StatusOr + TestIamPermissions( + std::string const& project, std::string const& region, + std::string const& resource, + google::cloud::cpp::compute::v1::TestPermissionsRequest const& + test_permissions_request_resource, + Options opts = {}); + + // clang-format off + /// + /// Returns permissions that a caller has on the specified resource. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionHealthCheckServices/testIamPermissions + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.region_health_check_services.v1.TestIamPermissionsRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.TestPermissionsResponse]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_health_check_services.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_check_services/v1/region_health_check_services.proto#L490} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} + /// + // clang-format on + StatusOr + TestIamPermissions(google::cloud::cpp::compute::region_health_check_services:: + v1::TestIamPermissionsRequest const& request, + Options opts = {}); + private: std::shared_ptr connection_; Options options_; diff --git a/google/cloud/compute/region_health_check_services/v1/region_health_check_services_connection.cc b/google/cloud/compute/region_health_check_services/v1/region_health_check_services_connection.cc index 0bd367d303132..37901bf238fe5 100644 --- a/google/cloud/compute/region_health_check_services/v1/region_health_check_services_connection.cc +++ b/google/cloud/compute/region_health_check_services/v1/region_health_check_services_connection.cc @@ -38,6 +38,17 @@ GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN RegionHealthCheckServicesConnection::~RegionHealthCheckServicesConnection() = default; +StreamRange< + std::pair> +RegionHealthCheckServicesConnection::AggregatedListRegionHealthCheckServices( + google::cloud::cpp::compute::region_health_check_services::v1:: + AggregatedListRegionHealthCheckServicesRequest) { // NOLINT(performance-unnecessary-value-param) + return google::cloud::internal::MakeUnimplementedPaginationRange< + StreamRange>>(); +} + future> RegionHealthCheckServicesConnection::DeleteHealthCheckService( google::cloud::cpp::compute::region_health_check_services::v1:: @@ -128,6 +139,13 @@ RegionHealthCheckServicesConnection::PatchHealthCheckService( Status(StatusCode::kUnimplemented, "not implemented")); } +StatusOr +RegionHealthCheckServicesConnection::TestIamPermissions( + google::cloud::cpp::compute::region_health_check_services::v1:: + TestIamPermissionsRequest const&) { + return Status(StatusCode::kUnimplemented, "not implemented"); +} + GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END } // namespace compute_region_health_check_services_v1 } // namespace cloud diff --git a/google/cloud/compute/region_health_check_services/v1/region_health_check_services_connection.h b/google/cloud/compute/region_health_check_services/v1/region_health_check_services_connection.h index af3889b1f8351..dd6809ad5afde 100644 --- a/google/cloud/compute/region_health_check_services/v1/region_health_check_services_connection.h +++ b/google/cloud/compute/region_health_check_services/v1/region_health_check_services_connection.h @@ -202,6 +202,13 @@ class RegionHealthCheckServicesConnection { virtual Options options() { return Options{}; } + virtual StreamRange< + std::pair> + AggregatedListRegionHealthCheckServices( + google::cloud::cpp::compute::region_health_check_services::v1:: + AggregatedListRegionHealthCheckServicesRequest request); + virtual future> DeleteHealthCheckService( google::cloud::cpp::compute::region_health_check_services::v1:: @@ -253,6 +260,10 @@ class RegionHealthCheckServicesConnection { virtual future> PatchHealthCheckService( google::cloud::cpp::compute::v1::Operation const& operation); + + virtual StatusOr + TestIamPermissions(google::cloud::cpp::compute::region_health_check_services:: + v1::TestIamPermissionsRequest const& request); }; GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END diff --git a/google/cloud/compute/region_health_check_services/v1/region_health_check_services_connection_idempotency_policy.cc b/google/cloud/compute/region_health_check_services/v1/region_health_check_services_connection_idempotency_policy.cc index ec9453133da80..96e0da0731509 100644 --- a/google/cloud/compute/region_health_check_services/v1/region_health_check_services_connection_idempotency_policy.cc +++ b/google/cloud/compute/region_health_check_services/v1/region_health_check_services_connection_idempotency_policy.cc @@ -36,6 +36,13 @@ RegionHealthCheckServicesConnectionIdempotencyPolicy::clone() const { *this); } +Idempotency RegionHealthCheckServicesConnectionIdempotencyPolicy:: + AggregatedListRegionHealthCheckServices( + google::cloud::cpp::compute::region_health_check_services::v1:: + AggregatedListRegionHealthCheckServicesRequest) { // NOLINT + return Idempotency::kIdempotent; +} + Idempotency RegionHealthCheckServicesConnectionIdempotencyPolicy::DeleteHealthCheckService( google::cloud::cpp::compute::region_health_check_services::v1:: @@ -71,6 +78,13 @@ RegionHealthCheckServicesConnectionIdempotencyPolicy::PatchHealthCheckService( return Idempotency::kNonIdempotent; } +Idempotency +RegionHealthCheckServicesConnectionIdempotencyPolicy::TestIamPermissions( + google::cloud::cpp::compute::region_health_check_services::v1:: + TestIamPermissionsRequest const&) { + return Idempotency::kNonIdempotent; +} + std::unique_ptr MakeDefaultRegionHealthCheckServicesConnectionIdempotencyPolicy() { return std::make_unique< diff --git a/google/cloud/compute/region_health_check_services/v1/region_health_check_services_connection_idempotency_policy.h b/google/cloud/compute/region_health_check_services/v1/region_health_check_services_connection_idempotency_policy.h index cfda50f881cbf..0175c204a86ca 100644 --- a/google/cloud/compute/region_health_check_services/v1/region_health_check_services_connection_idempotency_policy.h +++ b/google/cloud/compute/region_health_check_services/v1/region_health_check_services_connection_idempotency_policy.h @@ -38,6 +38,10 @@ class RegionHealthCheckServicesConnectionIdempotencyPolicy { virtual std::unique_ptr clone() const; + virtual google::cloud::Idempotency AggregatedListRegionHealthCheckServices( + google::cloud::cpp::compute::region_health_check_services::v1:: + AggregatedListRegionHealthCheckServicesRequest request); + virtual google::cloud::Idempotency DeleteHealthCheckService( google::cloud::cpp::compute::region_health_check_services::v1:: DeleteHealthCheckServiceRequest const& request); @@ -57,6 +61,10 @@ class RegionHealthCheckServicesConnectionIdempotencyPolicy { virtual google::cloud::Idempotency PatchHealthCheckService( google::cloud::cpp::compute::region_health_check_services::v1:: PatchHealthCheckServiceRequest const& request); + + virtual google::cloud::Idempotency TestIamPermissions( + google::cloud::cpp::compute::region_health_check_services::v1:: + TestIamPermissionsRequest const& request); }; std::unique_ptr 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 6ecb9638ff449..532ae397c7e8c 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,9 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_CHECK_SERVICES_V1_REGION_HEALTH_CHECK_SERVICES_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_050.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_062.pb.h" +#include "google/cloud/compute/v1/internal/common_171.pb.h" // 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/internal/region_health_checks_rest_connection_impl.cc b/google/cloud/compute/region_health_checks/v1/internal/region_health_checks_rest_connection_impl.cc index 9ef91a258f6cf..3c78f7e13837e 100644 --- a/google/cloud/compute/region_health_checks/v1/internal/region_health_checks_rest_connection_impl.cc +++ b/google/cloud/compute/region_health_checks/v1/internal/region_health_checks_rest_connection_impl.cc @@ -495,6 +495,22 @@ RegionHealthChecksRestConnectionImpl::PatchHealthCheck( }); } +StatusOr +RegionHealthChecksRestConnectionImpl::TestIamPermissions( + google::cloud::cpp::compute::region_health_checks::v1:: + TestIamPermissionsRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->TestIamPermissions(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_health_checks::v1:: + TestIamPermissionsRequest const& request) { + return stub_->TestIamPermissions(rest_context, options, request); + }, + *current, request, __func__); +} + future> RegionHealthChecksRestConnectionImpl::UpdateHealthCheck( google::cloud::cpp::compute::region_health_checks::v1:: diff --git a/google/cloud/compute/region_health_checks/v1/internal/region_health_checks_rest_connection_impl.h b/google/cloud/compute/region_health_checks/v1/internal/region_health_checks_rest_connection_impl.h index f0e2b6ec4d1c1..a112197e139db 100644 --- a/google/cloud/compute/region_health_checks/v1/internal/region_health_checks_rest_connection_impl.h +++ b/google/cloud/compute/region_health_checks/v1/internal/region_health_checks_rest_connection_impl.h @@ -96,6 +96,10 @@ class RegionHealthChecksRestConnectionImpl future> PatchHealthCheck( google::cloud::cpp::compute::v1::Operation const& operation) override; + StatusOr + TestIamPermissions(google::cloud::cpp::compute::region_health_checks::v1:: + TestIamPermissionsRequest const& request) override; + future> UpdateHealthCheck(google::cloud::cpp::compute::region_health_checks::v1:: UpdateHealthCheckRequest const& request) override; diff --git a/google/cloud/compute/region_health_checks/v1/internal/region_health_checks_rest_logging_decorator.cc b/google/cloud/compute/region_health_checks/v1/internal/region_health_checks_rest_logging_decorator.cc index 4c6400c415782..9cccc3ddffb5c 100644 --- a/google/cloud/compute/region_health_checks/v1/internal/region_health_checks_rest_logging_decorator.cc +++ b/google/cloud/compute/region_health_checks/v1/internal/region_health_checks_rest_logging_decorator.cc @@ -165,6 +165,20 @@ RegionHealthChecksRestLogging::PatchHealthCheck( rest_context, options, request, __func__, tracing_options_); } +StatusOr +RegionHealthChecksRestLogging::TestIamPermissions( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_health_checks::v1:: + TestIamPermissionsRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_health_checks::v1:: + TestIamPermissionsRequest const& request) { + return child_->TestIamPermissions(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + future> RegionHealthChecksRestLogging::AsyncUpdateHealthCheck( CompletionQueue& cq, diff --git a/google/cloud/compute/region_health_checks/v1/internal/region_health_checks_rest_logging_decorator.h b/google/cloud/compute/region_health_checks/v1/internal/region_health_checks_rest_logging_decorator.h index a7bb9261e8593..9d60433e9c067 100644 --- a/google/cloud/compute/region_health_checks/v1/internal/region_health_checks_rest_logging_decorator.h +++ b/google/cloud/compute/region_health_checks/v1/internal/region_health_checks_rest_logging_decorator.h @@ -98,6 +98,12 @@ class RegionHealthChecksRestLogging : public RegionHealthChecksRestStub { google::cloud::cpp::compute::region_health_checks::v1:: PatchHealthCheckRequest const& request) override; + StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_checks::v1:: + TestIamPermissionsRequest const& request) override; + future> AsyncUpdateHealthCheck( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/region_health_checks/v1/internal/region_health_checks_rest_metadata_decorator.cc b/google/cloud/compute/region_health_checks/v1/internal/region_health_checks_rest_metadata_decorator.cc index 01a0600afff61..134e7f8ce87ad 100644 --- a/google/cloud/compute/region_health_checks/v1/internal/region_health_checks_rest_metadata_decorator.cc +++ b/google/cloud/compute/region_health_checks/v1/internal/region_health_checks_rest_metadata_decorator.cc @@ -121,6 +121,15 @@ RegionHealthChecksRestMetadata::PatchHealthCheck( return child_->PatchHealthCheck(rest_context, options, request); } +StatusOr +RegionHealthChecksRestMetadata::TestIamPermissions( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_health_checks::v1:: + TestIamPermissionsRequest const& request) { + SetMetadata(rest_context, options); + return child_->TestIamPermissions(rest_context, options, request); +} + future> RegionHealthChecksRestMetadata::AsyncUpdateHealthCheck( CompletionQueue& cq, diff --git a/google/cloud/compute/region_health_checks/v1/internal/region_health_checks_rest_metadata_decorator.h b/google/cloud/compute/region_health_checks/v1/internal/region_health_checks_rest_metadata_decorator.h index 659d15aabdd1c..2811eee421298 100644 --- a/google/cloud/compute/region_health_checks/v1/internal/region_health_checks_rest_metadata_decorator.h +++ b/google/cloud/compute/region_health_checks/v1/internal/region_health_checks_rest_metadata_decorator.h @@ -96,6 +96,12 @@ class RegionHealthChecksRestMetadata : public RegionHealthChecksRestStub { google::cloud::cpp::compute::region_health_checks::v1:: PatchHealthCheckRequest const& request) override; + StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_checks::v1:: + TestIamPermissionsRequest const& request) override; + google::cloud::future> AsyncUpdateHealthCheck( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/region_health_checks/v1/internal/region_health_checks_rest_stub.cc b/google/cloud/compute/region_health_checks/v1/internal/region_health_checks_rest_stub.cc index a14d569c5df0c..ac1d06f949da3 100644 --- a/google/cloud/compute/region_health_checks/v1/internal/region_health_checks_rest_stub.cc +++ b/google/cloud/compute/region_health_checks/v1/internal/region_health_checks_rest_stub.cc @@ -259,6 +259,25 @@ DefaultRegionHealthChecksRestStub::PatchHealthCheck( std::move(query_params)); } +StatusOr +DefaultRegionHealthChecksRestStub::TestIamPermissions( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_checks::v1:: + TestIamPermissionsRequest const& request) { + std::vector> query_params; + return rest_internal::Post< + google::cloud::cpp::compute::v1::TestPermissionsResponse>( + *service_, rest_context, request.test_permissions_request_resource(), + false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "regions", "/", + request.region(), "/", "healthChecks", "/", + request.resource(), "/", "testIamPermissions"), + std::move(query_params)); +} + future> DefaultRegionHealthChecksRestStub::AsyncUpdateHealthCheck( CompletionQueue& cq, diff --git a/google/cloud/compute/region_health_checks/v1/internal/region_health_checks_rest_stub.h b/google/cloud/compute/region_health_checks/v1/internal/region_health_checks_rest_stub.h index 43bc9934e03c0..66850cb3948da 100644 --- a/google/cloud/compute/region_health_checks/v1/internal/region_health_checks_rest_stub.h +++ b/google/cloud/compute/region_health_checks/v1/internal/region_health_checks_rest_stub.h @@ -93,6 +93,12 @@ class RegionHealthChecksRestStub { google::cloud::cpp::compute::region_health_checks::v1:: PatchHealthCheckRequest const& request) = 0; + virtual StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_checks::v1:: + TestIamPermissionsRequest const& request) = 0; + virtual future> AsyncUpdateHealthCheck( google::cloud::CompletionQueue& cq, @@ -187,6 +193,12 @@ class DefaultRegionHealthChecksRestStub : public RegionHealthChecksRestStub { google::cloud::cpp::compute::region_health_checks::v1:: PatchHealthCheckRequest const& request) override; + StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_checks::v1:: + TestIamPermissionsRequest const& request) override; + future> AsyncUpdateHealthCheck( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/region_health_checks/v1/internal/region_health_checks_tracing_connection.cc b/google/cloud/compute/region_health_checks/v1/internal/region_health_checks_tracing_connection.cc index de5360789d69a..231fc2e842c4f 100644 --- a/google/cloud/compute/region_health_checks/v1/internal/region_health_checks_tracing_connection.cc +++ b/google/cloud/compute/region_health_checks/v1/internal/region_health_checks_tracing_connection.cc @@ -161,6 +161,17 @@ RegionHealthChecksTracingConnection::PatchHealthCheck( child_->PatchHealthCheck(operation)); } +StatusOr +RegionHealthChecksTracingConnection::TestIamPermissions( + google::cloud::cpp::compute::region_health_checks::v1:: + TestIamPermissionsRequest const& request) { + auto span = internal::MakeSpan( + "compute_region_health_checks_v1::RegionHealthChecksConnection::" + "TestIamPermissions"); + auto scope = opentelemetry::trace::Scope(span); + return internal::EndSpan(*span, child_->TestIamPermissions(request)); +} + future> RegionHealthChecksTracingConnection::UpdateHealthCheck( google::cloud::cpp::compute::region_health_checks::v1:: diff --git a/google/cloud/compute/region_health_checks/v1/internal/region_health_checks_tracing_connection.h b/google/cloud/compute/region_health_checks/v1/internal/region_health_checks_tracing_connection.h index ed58f596b6f06..ff08a97238540 100644 --- a/google/cloud/compute/region_health_checks/v1/internal/region_health_checks_tracing_connection.h +++ b/google/cloud/compute/region_health_checks/v1/internal/region_health_checks_tracing_connection.h @@ -84,6 +84,10 @@ class RegionHealthChecksTracingConnection future> PatchHealthCheck( google::cloud::cpp::compute::v1::Operation const& operation) override; + StatusOr + TestIamPermissions(google::cloud::cpp::compute::region_health_checks::v1:: + TestIamPermissionsRequest const& request) override; + future> UpdateHealthCheck(google::cloud::cpp::compute::region_health_checks::v1:: UpdateHealthCheckRequest const& request) override; diff --git a/google/cloud/compute/region_health_checks/v1/mocks/mock_region_health_checks_connection.h b/google/cloud/compute/region_health_checks/v1/mocks/mock_region_health_checks_connection.h index d94a379c4b3d8..d3f9783cc1f43 100644 --- a/google/cloud/compute/region_health_checks/v1/mocks/mock_region_health_checks_connection.h +++ b/google/cloud/compute/region_health_checks/v1/mocks/mock_region_health_checks_connection.h @@ -183,6 +183,13 @@ class MockRegionHealthChecksConnection (google::cloud::cpp::compute::v1::Operation const& operation), (override)); + MOCK_METHOD( + StatusOr, + TestIamPermissions, + (google::cloud::cpp::compute::region_health_checks::v1:: + TestIamPermissionsRequest const& request), + (override)); + /// To disambiguate calls, use: /// /// @code diff --git a/google/cloud/compute/region_health_checks/v1/region_health_checks_client.cc b/google/cloud/compute/region_health_checks/v1/region_health_checks_client.cc index d8363f0e26fe1..86e149b58b71f 100644 --- a/google/cloud/compute/region_health_checks/v1/region_health_checks_client.cc +++ b/google/cloud/compute/region_health_checks/v1/region_health_checks_client.cc @@ -244,6 +244,33 @@ RegionHealthChecksClient::PatchHealthCheck( return connection_->PatchHealthCheck(operation); } +StatusOr +RegionHealthChecksClient::TestIamPermissions( + std::string const& project, std::string const& region, + std::string const& resource, + google::cloud::cpp::compute::v1::TestPermissionsRequest const& + test_permissions_request_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_health_checks::v1:: + TestIamPermissionsRequest request; + request.set_project(project); + request.set_region(region); + request.set_resource(resource); + *request.mutable_test_permissions_request_resource() = + test_permissions_request_resource; + return connection_->TestIamPermissions(request); +} + +StatusOr +RegionHealthChecksClient::TestIamPermissions( + google::cloud::cpp::compute::region_health_checks::v1:: + TestIamPermissionsRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->TestIamPermissions(request); +} + future> RegionHealthChecksClient::UpdateHealthCheck( std::string const& project, std::string const& region, 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 c5f732fa7b2a1..0de5661454cd1 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 @@ -118,7 +118,7 @@ class RegionHealthChecksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_health_checks.v1.DeleteHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_checks/v1/region_health_checks.proto#L117} + /// [google.cloud.cpp.compute.region_health_checks.v1.DeleteHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_checks/v1/region_health_checks.proto#L131} /// // clang-format on future> @@ -171,7 +171,7 @@ class RegionHealthChecksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_health_checks.v1.DeleteHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_checks/v1/region_health_checks.proto#L117} + /// [google.cloud.cpp.compute.region_health_checks.v1.DeleteHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_checks/v1/region_health_checks.proto#L131} /// // clang-format on future> @@ -230,8 +230,8 @@ class RegionHealthChecksClient { /// [`future`]: @ref google::cloud::future /// [`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_043.proto#L271} + /// [google.cloud.cpp.compute.region_health_checks.v1.GetHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_checks/v1/region_health_checks.proto#L167} + /// [google.cloud.cpp.compute.v1.HealthCheck]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_053.proto#L368} /// // clang-format on StatusOr GetHealthCheck( @@ -262,8 +262,8 @@ class RegionHealthChecksClient { /// [`future`]: @ref google::cloud::future /// [`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_043.proto#L271} + /// [google.cloud.cpp.compute.region_health_checks.v1.GetHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_checks/v1/region_health_checks.proto#L167} + /// [google.cloud.cpp.compute.v1.HealthCheck]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_053.proto#L368} /// // clang-format on StatusOr GetHealthCheck( @@ -300,7 +300,7 @@ class RegionHealthChecksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_health_checks.v1.InsertHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_checks/v1/region_health_checks.proto#L165} + /// [google.cloud.cpp.compute.region_health_checks.v1.InsertHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_checks/v1/region_health_checks.proto#L182} /// // clang-format on future> @@ -357,7 +357,7 @@ class RegionHealthChecksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_health_checks.v1.InsertHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_checks/v1/region_health_checks.proto#L165} + /// [google.cloud.cpp.compute.region_health_checks.v1.InsertHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_checks/v1/region_health_checks.proto#L182} /// // clang-format on future> @@ -425,8 +425,8 @@ class RegionHealthChecksClient { /// [`future`]: @ref google::cloud::future /// [`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_043.proto#L271} + /// [google.cloud.cpp.compute.region_health_checks.v1.ListRegionHealthChecksRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_checks/v1/region_health_checks.proto#L218} + /// [google.cloud.cpp.compute.v1.HealthCheck]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_053.proto#L368} /// // clang-format on StreamRange @@ -467,8 +467,8 @@ class RegionHealthChecksClient { /// [`future`]: @ref google::cloud::future /// [`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_043.proto#L271} + /// [google.cloud.cpp.compute.region_health_checks.v1.ListRegionHealthChecksRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_checks/v1/region_health_checks.proto#L218} + /// [google.cloud.cpp.compute.v1.HealthCheck]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_053.proto#L368} /// // clang-format on StreamRange @@ -479,8 +479,9 @@ class RegionHealthChecksClient { // clang-format off /// /// 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. + /// included in the request. This method supportsPATCH + /// semantics and uses theJSON merge + /// patch format and processing rules. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionHealthChecks/patch /// /// @param project Project ID for this request. @@ -507,7 +508,7 @@ class RegionHealthChecksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_health_checks.v1.PatchHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_checks/v1/region_health_checks.proto#L270} + /// [google.cloud.cpp.compute.region_health_checks.v1.PatchHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_checks/v1/region_health_checks.proto#L323} /// // clang-format on future> PatchHealthCheck( @@ -536,8 +537,9 @@ class RegionHealthChecksClient { // clang-format off /// /// 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. + /// included in the request. This method supportsPATCH + /// semantics and uses theJSON merge + /// patch format and processing rules. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionHealthChecks/patch /// /// @param request Unary RPCs, such as the one wrapped by this @@ -566,7 +568,7 @@ class RegionHealthChecksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_health_checks.v1.PatchHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_checks/v1/region_health_checks.proto#L270} + /// [google.cloud.cpp.compute.region_health_checks.v1.PatchHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_checks/v1/region_health_checks.proto#L323} /// // clang-format on future> PatchHealthCheck( @@ -604,6 +606,73 @@ class RegionHealthChecksClient { google::cloud::cpp::compute::v1::Operation const& operation, Options opts = {}); + // clang-format off + /// + /// Returns permissions that a caller has on the specified resource. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionHealthChecks/testIamPermissions + /// + /// @param project Project ID for this request. + /// @param region The name of the region for this request. + /// @param resource Name or id of the resource for this request. + /// @param test_permissions_request_resource The TestPermissionsRequest for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.TestPermissionsResponse]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_health_checks.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_checks/v1/region_health_checks.proto#L363} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} + /// + // clang-format on + StatusOr + TestIamPermissions( + std::string const& project, std::string const& region, + std::string const& resource, + google::cloud::cpp::compute::v1::TestPermissionsRequest const& + test_permissions_request_resource, + Options opts = {}); + + // clang-format off + /// + /// Returns permissions that a caller has on the specified resource. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionHealthChecks/testIamPermissions + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.region_health_checks.v1.TestIamPermissionsRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.TestPermissionsResponse]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_health_checks.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_checks/v1/region_health_checks.proto#L363} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} + /// + // clang-format on + StatusOr + TestIamPermissions(google::cloud::cpp::compute::region_health_checks::v1:: + TestIamPermissionsRequest const& request, + Options opts = {}); + // clang-format off /// /// Updates a HealthCheck resource in the specified project using the data @@ -634,7 +703,7 @@ class RegionHealthChecksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_health_checks.v1.UpdateHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_checks/v1/region_health_checks.proto#L307} + /// [google.cloud.cpp.compute.region_health_checks.v1.UpdateHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_checks/v1/region_health_checks.proto#L382} /// // clang-format on future> @@ -693,7 +762,7 @@ class RegionHealthChecksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_health_checks.v1.UpdateHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_checks/v1/region_health_checks.proto#L307} + /// [google.cloud.cpp.compute.region_health_checks.v1.UpdateHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_checks/v1/region_health_checks.proto#L382} /// // clang-format on future> diff --git a/google/cloud/compute/region_health_checks/v1/region_health_checks_connection.cc b/google/cloud/compute/region_health_checks/v1/region_health_checks_connection.cc index 95957fd6ea0bc..482b4739d630d 100644 --- a/google/cloud/compute/region_health_checks/v1/region_health_checks_connection.cc +++ b/google/cloud/compute/region_health_checks/v1/region_health_checks_connection.cc @@ -127,6 +127,13 @@ RegionHealthChecksConnection::PatchHealthCheck( Status(StatusCode::kUnimplemented, "not implemented")); } +StatusOr +RegionHealthChecksConnection::TestIamPermissions( + google::cloud::cpp::compute::region_health_checks::v1:: + TestIamPermissionsRequest const&) { + return Status(StatusCode::kUnimplemented, "not implemented"); +} + future> RegionHealthChecksConnection::UpdateHealthCheck( google::cloud::cpp::compute::region_health_checks::v1:: diff --git a/google/cloud/compute/region_health_checks/v1/region_health_checks_connection.h b/google/cloud/compute/region_health_checks/v1/region_health_checks_connection.h index f97036dcd60b0..9e91e45a995dd 100644 --- a/google/cloud/compute/region_health_checks/v1/region_health_checks_connection.h +++ b/google/cloud/compute/region_health_checks/v1/region_health_checks_connection.h @@ -235,6 +235,10 @@ class RegionHealthChecksConnection { virtual future> PatchHealthCheck(google::cloud::cpp::compute::v1::Operation const& operation); + virtual StatusOr + TestIamPermissions(google::cloud::cpp::compute::region_health_checks::v1:: + TestIamPermissionsRequest const& request); + virtual future> UpdateHealthCheck(google::cloud::cpp::compute::region_health_checks::v1:: UpdateHealthCheckRequest const& request); diff --git a/google/cloud/compute/region_health_checks/v1/region_health_checks_connection_idempotency_policy.cc b/google/cloud/compute/region_health_checks/v1/region_health_checks_connection_idempotency_policy.cc index 8ac456321c3dc..75e6162fdb7c2 100644 --- a/google/cloud/compute/region_health_checks/v1/region_health_checks_connection_idempotency_policy.cc +++ b/google/cloud/compute/region_health_checks/v1/region_health_checks_connection_idempotency_policy.cc @@ -66,6 +66,12 @@ Idempotency RegionHealthChecksConnectionIdempotencyPolicy::PatchHealthCheck( return Idempotency::kNonIdempotent; } +Idempotency RegionHealthChecksConnectionIdempotencyPolicy::TestIamPermissions( + google::cloud::cpp::compute::region_health_checks::v1:: + TestIamPermissionsRequest const&) { + return Idempotency::kNonIdempotent; +} + Idempotency RegionHealthChecksConnectionIdempotencyPolicy::UpdateHealthCheck( google::cloud::cpp::compute::region_health_checks::v1:: UpdateHealthCheckRequest const&) { diff --git a/google/cloud/compute/region_health_checks/v1/region_health_checks_connection_idempotency_policy.h b/google/cloud/compute/region_health_checks/v1/region_health_checks_connection_idempotency_policy.h index 2b81e53261701..cf9935f8cc453 100644 --- a/google/cloud/compute/region_health_checks/v1/region_health_checks_connection_idempotency_policy.h +++ b/google/cloud/compute/region_health_checks/v1/region_health_checks_connection_idempotency_policy.h @@ -58,6 +58,10 @@ class RegionHealthChecksConnectionIdempotencyPolicy { google::cloud::cpp::compute::region_health_checks::v1:: PatchHealthCheckRequest const& request); + virtual google::cloud::Idempotency TestIamPermissions( + google::cloud::cpp::compute::region_health_checks::v1:: + TestIamPermissionsRequest const& request); + virtual google::cloud::Idempotency UpdateHealthCheck( google::cloud::cpp::compute::region_health_checks::v1:: UpdateHealthCheckRequest const& request); 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 31816f7f7222a..43d9c7940e5f6 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,9 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_CHECKS_V1_REGION_HEALTH_CHECKS_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_043.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_053.pb.h" +#include "google/cloud/compute/v1/internal/common_171.pb.h" // 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_health_sources/v1/internal/region_health_sources_option_defaults.cc b/google/cloud/compute/region_health_sources/v1/internal/region_health_sources_option_defaults.cc new file mode 100644 index 0000000000000..5aa6f53198048 --- /dev/null +++ b/google/cloud/compute/region_health_sources/v1/internal/region_health_sources_option_defaults.cc @@ -0,0 +1,92 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_health_sources/v1/region_health_sources.proto + +#include "google/cloud/compute/region_health_sources/v1/internal/region_health_sources_option_defaults.h" +#include "google/cloud/compute/region_health_sources/v1/region_health_sources_connection.h" +#include "google/cloud/compute/region_health_sources/v1/region_health_sources_options.h" +#include "google/cloud/internal/populate_common_options.h" +#include "google/cloud/internal/populate_grpc_options.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_health_sources_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +namespace { +auto constexpr kBackoffScaling = 2.0; +} // namespace + +Options RegionHealthSourcesDefaultOptions(Options options) { + options = internal::PopulateCommonOptions( + std::move(options), "GOOGLE_CLOUD_CPP_REGION_HEALTH_SOURCES_ENDPOINT", "", + "GOOGLE_CLOUD_CPP_REGION_HEALTH_SOURCES_AUTHORITY", + "compute.googleapis.com"); + options = internal::PopulateGrpcOptions(std::move(options)); + if (!options.has()) { + options.set< + compute_region_health_sources_v1::RegionHealthSourcesRetryPolicyOption>( + compute_region_health_sources_v1:: + RegionHealthSourcesLimitedTimeRetryPolicy(std::chrono::minutes(10)) + .clone()); + } + if (!options.has()) { + options.set( + ExponentialBackoffPolicy( + std::chrono::seconds(0), std::chrono::seconds(1), + std::chrono::minutes(5), kBackoffScaling, kBackoffScaling) + .clone()); + } + if (!options.has()) { + options.set( + GenericPollingPolicy( + options + .get() + ->clone(), + ExponentialBackoffPolicy(std::chrono::seconds(1), + std::chrono::minutes(5), kBackoffScaling) + .clone()) + .clone()); + } + if (!options + .has()) { + options.set( + compute_region_health_sources_v1:: + MakeDefaultRegionHealthSourcesConnectionIdempotencyPolicy()); + } + + return options; +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_health_sources_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_health_sources/v1/internal/region_health_sources_option_defaults.h b/google/cloud/compute/region_health_sources/v1/internal/region_health_sources_option_defaults.h new file mode 100644 index 0000000000000..9ab8f242c82e6 --- /dev/null +++ b/google/cloud/compute/region_health_sources/v1/internal/region_health_sources_option_defaults.h @@ -0,0 +1,38 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_health_sources/v1/region_health_sources.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_SOURCES_V1_INTERNAL_REGION_HEALTH_SOURCES_OPTION_DEFAULTS_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_SOURCES_V1_INTERNAL_REGION_HEALTH_SOURCES_OPTION_DEFAULTS_H + +#include "google/cloud/options.h" +#include "google/cloud/version.h" + +namespace google { +namespace cloud { +namespace compute_region_health_sources_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +Options RegionHealthSourcesDefaultOptions(Options options); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_health_sources_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_SOURCES_V1_INTERNAL_REGION_HEALTH_SOURCES_OPTION_DEFAULTS_H diff --git a/google/cloud/compute/region_health_sources/v1/internal/region_health_sources_rest_connection_impl.cc b/google/cloud/compute/region_health_sources/v1/internal/region_health_sources_rest_connection_impl.cc new file mode 100644 index 0000000000000..8b9c8a4d26578 --- /dev/null +++ b/google/cloud/compute/region_health_sources/v1/internal/region_health_sources_rest_connection_impl.cc @@ -0,0 +1,577 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_health_sources/v1/region_health_sources.proto + +#include "google/cloud/compute/region_health_sources/v1/internal/region_health_sources_rest_connection_impl.h" +#include "google/cloud/compute/region_health_sources/v1/internal/region_health_sources_rest_stub_factory.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/internal/async_rest_long_running_operation_custom.h" +#include "google/cloud/internal/extract_long_running_result.h" +#include "google/cloud/internal/pagination_range.h" +#include "google/cloud/internal/rest_lro_helpers.h" +#include "google/cloud/internal/rest_retry_loop.h" +#include "google/cloud/rest_options.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_health_sources_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +RegionHealthSourcesRestConnectionImpl::RegionHealthSourcesRestConnectionImpl( + std::unique_ptr background, + std::shared_ptr< + compute_region_health_sources_v1_internal::RegionHealthSourcesRestStub> + stub, + Options options) + : background_(std::move(background)), + stub_(std::move(stub)), + options_(internal::MergeOptions( + std::move(options), RegionHealthSourcesConnection::options())) {} + +StreamRange> +RegionHealthSourcesRestConnectionImpl::AggregatedListRegionHealthSources( + google::cloud::cpp::compute::region_health_sources::v1:: + AggregatedListRegionHealthSourcesRequest request) { + request.clear_page_token(); + auto current = google::cloud::internal::SaveCurrentOptions(); + auto idempotency = + idempotency_policy(*current)->AggregatedListRegionHealthSources(request); + char const* function_name = __func__; + return google::cloud::internal::MakePaginationRange>>( + current, std::move(request), + [idempotency, function_name, stub = stub_, + retry = std::shared_ptr< + compute_region_health_sources_v1::RegionHealthSourcesRetryPolicy>( + retry_policy(*current)), + backoff = std::shared_ptr(backoff_policy(*current))]( + Options const& options, + google::cloud::cpp::compute::region_health_sources::v1:: + AggregatedListRegionHealthSourcesRequest const& r) { + return google::cloud::rest_internal::RestRetryLoop( + retry->clone(), backoff->clone(), idempotency, + [stub]( + rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_sources::v1:: + AggregatedListRegionHealthSourcesRequest const& request) { + return stub->AggregatedListRegionHealthSources(rest_context, + options, request); + }, + options, r, function_name); + }, + [](google::cloud::cpp::compute::v1::HealthSourceAggregatedList r) { + std::vector< + std::pair> + result(r.items().size()); + auto& messages = *r.mutable_items(); + std::move(messages.begin(), messages.end(), result.begin()); + return result; + }); +} + +future> +RegionHealthSourcesRestConnectionImpl::DeleteHealthSource( + google::cloud::cpp::compute::region_health_sources::v1:: + DeleteHealthSourceRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::region_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, request, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_health_sources::v1:: + DeleteHealthSourceRequest const& request) { + return stub->AsyncDeleteHealthSource(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->DeleteHealthSource(request), + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [request](std::string const& op, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest& r) { + r.set_project(request.project()); + r.set_region(request.region()); + r.set_operation(op); + }, + [request](std::string const& op, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest& r) { + r.set_project(request.project()); + r.set_region(request.region()); + r.set_operation(op); + }); +} + +StatusOr +RegionHealthSourcesRestConnectionImpl::DeleteHealthSource( + NoAwaitTag, google::cloud::cpp::compute::region_health_sources::v1:: + DeleteHealthSourceRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->DeleteHealthSource(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_health_sources::v1:: + DeleteHealthSourceRequest const& request) { + return stub_->DeleteHealthSource(rest_context, options, request); + }, + *current, request, __func__); +} + +future> +RegionHealthSourcesRestConnectionImpl::DeleteHealthSource( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestAwaitLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::region_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, operation, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [operation](std::string const&, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_region(info.region); + r.set_operation(info.operation); + }, + [operation](std::string const&, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_region(info.region); + r.set_operation(info.operation); + }); +} + +StatusOr +RegionHealthSourcesRestConnectionImpl::GetHealthSource( + google::cloud::cpp::compute::region_health_sources::v1:: + GetHealthSourceRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->GetHealthSource(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_health_sources::v1:: + GetHealthSourceRequest const& request) { + return stub_->GetHealthSource(rest_context, options, request); + }, + *current, request, __func__); +} + +StatusOr +RegionHealthSourcesRestConnectionImpl::GetHealth( + google::cloud::cpp::compute::region_health_sources::v1:: + GetHealthRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->GetHealth(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_health_sources::v1:: + GetHealthRequest const& request) { + return stub_->GetHealth(rest_context, options, request); + }, + *current, request, __func__); +} + +future> +RegionHealthSourcesRestConnectionImpl::InsertHealthSource( + google::cloud::cpp::compute::region_health_sources::v1:: + InsertHealthSourceRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::region_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, request, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_health_sources::v1:: + InsertHealthSourceRequest const& request) { + return stub->AsyncInsertHealthSource(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->InsertHealthSource(request), + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [request](std::string const& op, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest& r) { + r.set_project(request.project()); + r.set_region(request.region()); + r.set_operation(op); + }, + [request](std::string const& op, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest& r) { + r.set_project(request.project()); + r.set_region(request.region()); + r.set_operation(op); + }); +} + +StatusOr +RegionHealthSourcesRestConnectionImpl::InsertHealthSource( + NoAwaitTag, google::cloud::cpp::compute::region_health_sources::v1:: + InsertHealthSourceRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->InsertHealthSource(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_health_sources::v1:: + InsertHealthSourceRequest const& request) { + return stub_->InsertHealthSource(rest_context, options, request); + }, + *current, request, __func__); +} + +future> +RegionHealthSourcesRestConnectionImpl::InsertHealthSource( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestAwaitLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::region_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, operation, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [operation](std::string const&, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_region(info.region); + r.set_operation(info.operation); + }, + [operation](std::string const&, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_region(info.region); + r.set_operation(info.operation); + }); +} + +StreamRange +RegionHealthSourcesRestConnectionImpl::ListRegionHealthSources( + google::cloud::cpp::compute::region_health_sources::v1:: + ListRegionHealthSourcesRequest request) { + request.clear_page_token(); + auto current = google::cloud::internal::SaveCurrentOptions(); + auto idempotency = + idempotency_policy(*current)->ListRegionHealthSources(request); + char const* function_name = __func__; + return google::cloud::internal::MakePaginationRange< + StreamRange>( + current, std::move(request), + [idempotency, function_name, stub = stub_, + retry = std::shared_ptr< + compute_region_health_sources_v1::RegionHealthSourcesRetryPolicy>( + retry_policy(*current)), + backoff = std::shared_ptr(backoff_policy(*current))]( + Options const& options, + google::cloud::cpp::compute::region_health_sources::v1:: + ListRegionHealthSourcesRequest const& r) { + return google::cloud::rest_internal::RestRetryLoop( + retry->clone(), backoff->clone(), idempotency, + [stub](rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_sources::v1:: + ListRegionHealthSourcesRequest const& request) { + return stub->ListRegionHealthSources(rest_context, options, + request); + }, + options, r, function_name); + }, + [](google::cloud::cpp::compute::v1::HealthSourceList r) { + std::vector result( + r.items().size()); + auto& messages = *r.mutable_items(); + std::move(messages.begin(), messages.end(), result.begin()); + return result; + }); +} + +future> +RegionHealthSourcesRestConnectionImpl::PatchHealthSource( + google::cloud::cpp::compute::region_health_sources::v1:: + PatchHealthSourceRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::region_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, request, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_health_sources::v1:: + PatchHealthSourceRequest const& request) { + return stub->AsyncPatchHealthSource(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->PatchHealthSource(request), + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [request](std::string const& op, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest& r) { + r.set_project(request.project()); + r.set_region(request.region()); + r.set_operation(op); + }, + [request](std::string const& op, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest& r) { + r.set_project(request.project()); + r.set_region(request.region()); + r.set_operation(op); + }); +} + +StatusOr +RegionHealthSourcesRestConnectionImpl::PatchHealthSource( + NoAwaitTag, google::cloud::cpp::compute::region_health_sources::v1:: + PatchHealthSourceRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->PatchHealthSource(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_health_sources::v1:: + PatchHealthSourceRequest const& request) { + return stub_->PatchHealthSource(rest_context, options, request); + }, + *current, request, __func__); +} + +future> +RegionHealthSourcesRestConnectionImpl::PatchHealthSource( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestAwaitLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::region_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, operation, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [operation](std::string const&, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_region(info.region); + r.set_operation(info.operation); + }, + [operation](std::string const&, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_region(info.region); + r.set_operation(info.operation); + }); +} + +StatusOr +RegionHealthSourcesRestConnectionImpl::TestIamPermissions( + google::cloud::cpp::compute::region_health_sources::v1:: + TestIamPermissionsRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->TestIamPermissions(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_health_sources::v1:: + TestIamPermissionsRequest const& request) { + return stub_->TestIamPermissions(rest_context, options, request); + }, + *current, request, __func__); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_health_sources_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_health_sources/v1/internal/region_health_sources_rest_connection_impl.h b/google/cloud/compute/region_health_sources/v1/internal/region_health_sources_rest_connection_impl.h new file mode 100644 index 0000000000000..f4f34a5a47174 --- /dev/null +++ b/google/cloud/compute/region_health_sources/v1/internal/region_health_sources_rest_connection_impl.h @@ -0,0 +1,160 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_health_sources/v1/region_health_sources.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_SOURCES_V1_INTERNAL_REGION_HEALTH_SOURCES_REST_CONNECTION_IMPL_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_SOURCES_V1_INTERNAL_REGION_HEALTH_SOURCES_REST_CONNECTION_IMPL_H + +#include "google/cloud/compute/region_health_sources/v1/internal/region_health_sources_rest_stub.h" +#include "google/cloud/compute/region_health_sources/v1/internal/region_health_sources_retry_traits.h" +#include "google/cloud/compute/region_health_sources/v1/region_health_sources_connection.h" +#include "google/cloud/compute/region_health_sources/v1/region_health_sources_connection_idempotency_policy.h" +#include "google/cloud/compute/region_health_sources/v1/region_health_sources_options.h" +#include "google/cloud/compute/region_operations/v1/region_operations.pb.h" +#include "google/cloud/background_threads.h" +#include "google/cloud/backoff_policy.h" +#include "google/cloud/options.h" +#include "google/cloud/status_or.h" +#include "google/cloud/stream_range.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_health_sources_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class RegionHealthSourcesRestConnectionImpl + : public compute_region_health_sources_v1::RegionHealthSourcesConnection { + public: + ~RegionHealthSourcesRestConnectionImpl() override = default; + + RegionHealthSourcesRestConnectionImpl( + std::unique_ptr background, + std::shared_ptr + stub, + Options options); + + Options options() override { return options_; } + + StreamRange> + AggregatedListRegionHealthSources( + google::cloud::cpp::compute::region_health_sources::v1:: + AggregatedListRegionHealthSourcesRequest request) override; + + future> + DeleteHealthSource(google::cloud::cpp::compute::region_health_sources::v1:: + DeleteHealthSourceRequest const& request) override; + + StatusOr DeleteHealthSource( + NoAwaitTag, google::cloud::cpp::compute::region_health_sources::v1:: + DeleteHealthSourceRequest const& request) override; + + future> + DeleteHealthSource( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + StatusOr GetHealthSource( + google::cloud::cpp::compute::region_health_sources::v1:: + GetHealthSourceRequest const& request) override; + + StatusOr GetHealth( + google::cloud::cpp::compute::region_health_sources::v1:: + GetHealthRequest const& request) override; + + future> + InsertHealthSource(google::cloud::cpp::compute::region_health_sources::v1:: + InsertHealthSourceRequest const& request) override; + + StatusOr InsertHealthSource( + NoAwaitTag, google::cloud::cpp::compute::region_health_sources::v1:: + InsertHealthSourceRequest const& request) override; + + future> + InsertHealthSource( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + StreamRange + ListRegionHealthSources( + google::cloud::cpp::compute::region_health_sources::v1:: + ListRegionHealthSourcesRequest request) override; + + future> + PatchHealthSource(google::cloud::cpp::compute::region_health_sources::v1:: + PatchHealthSourceRequest const& request) override; + + StatusOr PatchHealthSource( + NoAwaitTag, google::cloud::cpp::compute::region_health_sources::v1:: + PatchHealthSourceRequest const& request) override; + + future> + PatchHealthSource( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + StatusOr + TestIamPermissions(google::cloud::cpp::compute::region_health_sources::v1:: + TestIamPermissionsRequest const& request) override; + + private: + static std::unique_ptr< + compute_region_health_sources_v1::RegionHealthSourcesRetryPolicy> + retry_policy(Options const& options) { + return options + .get() + ->clone(); + } + + static std::unique_ptr backoff_policy(Options const& options) { + return options + .get() + ->clone(); + } + + static std::unique_ptr + idempotency_policy(Options const& options) { + return options + .get() + ->clone(); + } + + static std::unique_ptr polling_policy(Options const& options) { + return options + .get() + ->clone(); + } + + std::unique_ptr background_; + std::shared_ptr< + compute_region_health_sources_v1_internal::RegionHealthSourcesRestStub> + stub_; + Options options_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_health_sources_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_SOURCES_V1_INTERNAL_REGION_HEALTH_SOURCES_REST_CONNECTION_IMPL_H diff --git a/google/cloud/compute/region_health_sources/v1/internal/region_health_sources_rest_logging_decorator.cc b/google/cloud/compute/region_health_sources/v1/internal/region_health_sources_rest_logging_decorator.cc new file mode 100644 index 0000000000000..e0795048af173 --- /dev/null +++ b/google/cloud/compute/region_health_sources/v1/internal/region_health_sources_rest_logging_decorator.cc @@ -0,0 +1,253 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_health_sources/v1/region_health_sources.proto + +#include "google/cloud/compute/region_health_sources/v1/internal/region_health_sources_rest_logging_decorator.h" +#include "google/cloud/internal/log_wrapper.h" +#include "google/cloud/status_or.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_health_sources_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +RegionHealthSourcesRestLogging::RegionHealthSourcesRestLogging( + std::shared_ptr child, + TracingOptions tracing_options, std::set components) + : child_(std::move(child)), + tracing_options_(std::move(tracing_options)), + components_(std::move(components)) {} + +StatusOr +RegionHealthSourcesRestLogging::AggregatedListRegionHealthSources( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_health_sources::v1:: + AggregatedListRegionHealthSourcesRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_health_sources::v1:: + AggregatedListRegionHealthSourcesRequest const& request) { + return child_->AggregatedListRegionHealthSources(rest_context, options, + request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +future> +RegionHealthSourcesRestLogging::AsyncDeleteHealthSource( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_health_sources::v1:: + DeleteHealthSourceRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_health_sources::v1:: + DeleteHealthSourceRequest const& request) { + return child_->AsyncDeleteHealthSource(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +StatusOr +RegionHealthSourcesRestLogging::DeleteHealthSource( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_health_sources::v1:: + DeleteHealthSourceRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_health_sources::v1:: + DeleteHealthSourceRequest const& request) { + return child_->DeleteHealthSource(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +StatusOr +RegionHealthSourcesRestLogging::GetHealthSource( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_health_sources::v1:: + GetHealthSourceRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_health_sources::v1:: + GetHealthSourceRequest const& request) { + return child_->GetHealthSource(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +StatusOr +RegionHealthSourcesRestLogging::GetHealth( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_health_sources::v1:: + GetHealthRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_health_sources::v1:: + GetHealthRequest const& request) { + return child_->GetHealth(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +future> +RegionHealthSourcesRestLogging::AsyncInsertHealthSource( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_health_sources::v1:: + InsertHealthSourceRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_health_sources::v1:: + InsertHealthSourceRequest const& request) { + return child_->AsyncInsertHealthSource(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +StatusOr +RegionHealthSourcesRestLogging::InsertHealthSource( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_health_sources::v1:: + InsertHealthSourceRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_health_sources::v1:: + InsertHealthSourceRequest const& request) { + return child_->InsertHealthSource(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +StatusOr +RegionHealthSourcesRestLogging::ListRegionHealthSources( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_health_sources::v1:: + ListRegionHealthSourcesRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_health_sources::v1:: + ListRegionHealthSourcesRequest const& request) { + return child_->ListRegionHealthSources(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +future> +RegionHealthSourcesRestLogging::AsyncPatchHealthSource( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_health_sources::v1:: + PatchHealthSourceRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_health_sources::v1:: + PatchHealthSourceRequest const& request) { + return child_->AsyncPatchHealthSource(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +StatusOr +RegionHealthSourcesRestLogging::PatchHealthSource( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_health_sources::v1:: + PatchHealthSourceRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_health_sources::v1:: + PatchHealthSourceRequest const& request) { + return child_->PatchHealthSource(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +StatusOr +RegionHealthSourcesRestLogging::TestIamPermissions( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_health_sources::v1:: + TestIamPermissionsRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_health_sources::v1:: + TestIamPermissionsRequest const& request) { + return child_->TestIamPermissions(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +future> +RegionHealthSourcesRestLogging::AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + return child_->AsyncGetOperation(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +future RegionHealthSourcesRestLogging::AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + return child_->AsyncCancelOperation(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_health_sources_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_health_sources/v1/internal/region_health_sources_rest_logging_decorator.h b/google/cloud/compute/region_health_sources/v1/internal/region_health_sources_rest_logging_decorator.h new file mode 100644 index 0000000000000..1e59b96ce22b5 --- /dev/null +++ b/google/cloud/compute/region_health_sources/v1/internal/region_health_sources_rest_logging_decorator.h @@ -0,0 +1,146 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_health_sources/v1/region_health_sources.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_SOURCES_V1_INTERNAL_REGION_HEALTH_SOURCES_REST_LOGGING_DECORATOR_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_SOURCES_V1_INTERNAL_REGION_HEALTH_SOURCES_REST_LOGGING_DECORATOR_H + +#include "google/cloud/compute/region_health_sources/v1/internal/region_health_sources_rest_stub.h" +#include "google/cloud/compute/region_health_sources/v1/region_health_sources.pb.h" +#include "google/cloud/compute/region_operations/v1/region_operations.pb.h" +#include "google/cloud/future.h" +#include "google/cloud/internal/rest_context.h" +#include "google/cloud/tracing_options.h" +#include "google/cloud/version.h" +#include +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_health_sources_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class RegionHealthSourcesRestLogging : public RegionHealthSourcesRestStub { + public: + ~RegionHealthSourcesRestLogging() override = default; + RegionHealthSourcesRestLogging( + std::shared_ptr child, + TracingOptions tracing_options, std::set components); + + StatusOr + AggregatedListRegionHealthSources( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_sources::v1:: + AggregatedListRegionHealthSourcesRequest const& request) override; + + future> + AsyncDeleteHealthSource( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_health_sources::v1:: + DeleteHealthSourceRequest const& request) override; + + StatusOr DeleteHealthSource( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_sources::v1:: + DeleteHealthSourceRequest const& request) override; + + StatusOr GetHealthSource( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_sources::v1:: + GetHealthSourceRequest const& request) override; + + StatusOr GetHealth( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_sources::v1:: + GetHealthRequest const& request) override; + + future> + AsyncInsertHealthSource( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_health_sources::v1:: + InsertHealthSourceRequest const& request) override; + + StatusOr InsertHealthSource( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_sources::v1:: + InsertHealthSourceRequest const& request) override; + + StatusOr + ListRegionHealthSources( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_sources::v1:: + ListRegionHealthSourcesRequest const& request) override; + + future> + AsyncPatchHealthSource( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_health_sources::v1:: + PatchHealthSourceRequest const& request) override; + + StatusOr PatchHealthSource( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_sources::v1:: + PatchHealthSourceRequest const& request) override; + + StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_sources::v1:: + TestIamPermissionsRequest const& request) override; + + future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) override; + + future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) override; + + private: + std::shared_ptr child_; + TracingOptions tracing_options_; + std::set components_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_health_sources_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_SOURCES_V1_INTERNAL_REGION_HEALTH_SOURCES_REST_LOGGING_DECORATOR_H diff --git a/google/cloud/compute/region_health_sources/v1/internal/region_health_sources_rest_metadata_decorator.cc b/google/cloud/compute/region_health_sources/v1/internal/region_health_sources_rest_metadata_decorator.cc new file mode 100644 index 0000000000000..98c8243c6ae80 --- /dev/null +++ b/google/cloud/compute/region_health_sources/v1/internal/region_health_sources_rest_metadata_decorator.cc @@ -0,0 +1,185 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_health_sources/v1/region_health_sources.proto + +#include "google/cloud/compute/region_health_sources/v1/internal/region_health_sources_rest_metadata_decorator.h" +#include "google/cloud/internal/api_client_header.h" +#include "google/cloud/internal/rest_set_metadata.h" +#include "google/cloud/status_or.h" +#include "absl/strings/str_cat.h" +#include "absl/strings/str_format.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_health_sources_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +RegionHealthSourcesRestMetadata::RegionHealthSourcesRestMetadata( + std::shared_ptr child, + std::string api_client_header) + : child_(std::move(child)), + api_client_header_( + api_client_header.empty() + ? google::cloud::internal::GeneratedLibClientHeader() + : std::move(api_client_header)) {} + +StatusOr +RegionHealthSourcesRestMetadata::AggregatedListRegionHealthSources( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_health_sources::v1:: + AggregatedListRegionHealthSourcesRequest const& request) { + SetMetadata(rest_context, options); + return child_->AggregatedListRegionHealthSources(rest_context, options, + request); +} + +future> +RegionHealthSourcesRestMetadata::AsyncDeleteHealthSource( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_health_sources::v1:: + DeleteHealthSourceRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncDeleteHealthSource(cq, std::move(rest_context), + std::move(options), request); +} + +StatusOr +RegionHealthSourcesRestMetadata::DeleteHealthSource( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_health_sources::v1:: + DeleteHealthSourceRequest const& request) { + SetMetadata(rest_context, options); + return child_->DeleteHealthSource(rest_context, options, request); +} + +StatusOr +RegionHealthSourcesRestMetadata::GetHealthSource( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_health_sources::v1:: + GetHealthSourceRequest const& request) { + SetMetadata(rest_context, options); + return child_->GetHealthSource(rest_context, options, request); +} + +StatusOr +RegionHealthSourcesRestMetadata::GetHealth( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_health_sources::v1:: + GetHealthRequest const& request) { + SetMetadata(rest_context, options); + return child_->GetHealth(rest_context, options, request); +} + +future> +RegionHealthSourcesRestMetadata::AsyncInsertHealthSource( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_health_sources::v1:: + InsertHealthSourceRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncInsertHealthSource(cq, std::move(rest_context), + std::move(options), request); +} + +StatusOr +RegionHealthSourcesRestMetadata::InsertHealthSource( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_health_sources::v1:: + InsertHealthSourceRequest const& request) { + SetMetadata(rest_context, options); + return child_->InsertHealthSource(rest_context, options, request); +} + +StatusOr +RegionHealthSourcesRestMetadata::ListRegionHealthSources( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_health_sources::v1:: + ListRegionHealthSourcesRequest const& request) { + SetMetadata(rest_context, options); + return child_->ListRegionHealthSources(rest_context, options, request); +} + +future> +RegionHealthSourcesRestMetadata::AsyncPatchHealthSource( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_health_sources::v1:: + PatchHealthSourceRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncPatchHealthSource(cq, std::move(rest_context), + std::move(options), request); +} + +StatusOr +RegionHealthSourcesRestMetadata::PatchHealthSource( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_health_sources::v1:: + PatchHealthSourceRequest const& request) { + SetMetadata(rest_context, options); + return child_->PatchHealthSource(rest_context, options, request); +} + +StatusOr +RegionHealthSourcesRestMetadata::TestIamPermissions( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_health_sources::v1:: + TestIamPermissionsRequest const& request) { + SetMetadata(rest_context, options); + return child_->TestIamPermissions(rest_context, options, request); +} + +future> +RegionHealthSourcesRestMetadata::AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncGetOperation(cq, std::move(rest_context), + std::move(options), request); +} + +future RegionHealthSourcesRestMetadata::AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncCancelOperation(cq, std::move(rest_context), + std::move(options), request); +} + +void RegionHealthSourcesRestMetadata::SetMetadata( + rest_internal::RestContext& rest_context, Options const& options, + std::vector const& params) { + google::cloud::rest_internal::SetMetadata(rest_context, options, params, + api_client_header_); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_health_sources_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_health_sources/v1/internal/region_health_sources_rest_metadata_decorator.h b/google/cloud/compute/region_health_sources/v1/internal/region_health_sources_rest_metadata_decorator.h new file mode 100644 index 0000000000000..636ba7547310d --- /dev/null +++ b/google/cloud/compute/region_health_sources/v1/internal/region_health_sources_rest_metadata_decorator.h @@ -0,0 +1,147 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_health_sources/v1/region_health_sources.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_SOURCES_V1_INTERNAL_REGION_HEALTH_SOURCES_REST_METADATA_DECORATOR_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_SOURCES_V1_INTERNAL_REGION_HEALTH_SOURCES_REST_METADATA_DECORATOR_H + +#include "google/cloud/compute/region_health_sources/v1/internal/region_health_sources_rest_stub.h" +#include "google/cloud/compute/region_health_sources/v1/region_health_sources.pb.h" +#include "google/cloud/compute/region_operations/v1/region_operations.pb.h" +#include "google/cloud/future.h" +#include "google/cloud/rest_options.h" +#include "google/cloud/version.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_health_sources_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class RegionHealthSourcesRestMetadata : public RegionHealthSourcesRestStub { + public: + ~RegionHealthSourcesRestMetadata() override = default; + explicit RegionHealthSourcesRestMetadata( + std::shared_ptr child, + std::string api_client_header = ""); + + StatusOr + AggregatedListRegionHealthSources( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_sources::v1:: + AggregatedListRegionHealthSourcesRequest const& request) override; + + google::cloud::future> + AsyncDeleteHealthSource( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_health_sources::v1:: + DeleteHealthSourceRequest const& request) override; + + StatusOr DeleteHealthSource( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_sources::v1:: + DeleteHealthSourceRequest const& request) override; + + StatusOr GetHealthSource( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_sources::v1:: + GetHealthSourceRequest const& request) override; + + StatusOr GetHealth( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_sources::v1:: + GetHealthRequest const& request) override; + + google::cloud::future> + AsyncInsertHealthSource( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_health_sources::v1:: + InsertHealthSourceRequest const& request) override; + + StatusOr InsertHealthSource( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_sources::v1:: + InsertHealthSourceRequest const& request) override; + + StatusOr + ListRegionHealthSources( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_sources::v1:: + ListRegionHealthSourcesRequest const& request) override; + + google::cloud::future> + AsyncPatchHealthSource( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_health_sources::v1:: + PatchHealthSourceRequest const& request) override; + + StatusOr PatchHealthSource( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_sources::v1:: + PatchHealthSourceRequest const& request) override; + + StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_sources::v1:: + TestIamPermissionsRequest const& request) override; + + google::cloud::future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) override; + + google::cloud::future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) override; + + private: + void SetMetadata(rest_internal::RestContext& rest_context, + Options const& options, + std::vector const& params = {}); + + std::shared_ptr child_; + std::string api_client_header_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_health_sources_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_SOURCES_V1_INTERNAL_REGION_HEALTH_SOURCES_REST_METADATA_DECORATOR_H diff --git a/google/cloud/compute/region_health_sources/v1/internal/region_health_sources_rest_stub.cc b/google/cloud/compute/region_health_sources/v1/internal/region_health_sources_rest_stub.cc new file mode 100644 index 0000000000000..ae351aedcaf9d --- /dev/null +++ b/google/cloud/compute/region_health_sources/v1/internal/region_health_sources_rest_stub.cc @@ -0,0 +1,396 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_health_sources/v1/region_health_sources.proto + +#include "google/cloud/compute/region_health_sources/v1/internal/region_health_sources_rest_stub.h" +#include "google/cloud/compute/region_health_sources/v1/region_health_sources.pb.h" +#include "google/cloud/compute/region_operations/v1/region_operations.pb.h" +#include "google/cloud/common_options.h" +#include "google/cloud/internal/rest_stub_helpers.h" +#include "google/cloud/status_or.h" +#include "absl/strings/str_cat.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_health_sources_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +DefaultRegionHealthSourcesRestStub::DefaultRegionHealthSourcesRestStub( + Options options) + : service_(rest_internal::MakePooledRestClient( + options.get(), options)), + operations_(rest_internal::MakePooledRestClient( + options.get(), options)), + options_(std::move(options)) {} + +DefaultRegionHealthSourcesRestStub::DefaultRegionHealthSourcesRestStub( + std::shared_ptr service, + std::shared_ptr operations, Options options) + : service_(std::move(service)), + operations_(std::move(operations)), + options_(std::move(options)) {} + +StatusOr +DefaultRegionHealthSourcesRestStub::AggregatedListRegionHealthSources( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_sources::v1:: + AggregatedListRegionHealthSourcesRequest const& request) { + std::vector> query_params; + query_params.push_back({"filter", request.filter()}); + query_params.push_back( + {"include_all_scopes", (request.include_all_scopes() ? "1" : "0")}); + query_params.push_back( + {"max_results", std::to_string(request.max_results())}); + query_params.push_back({"order_by", request.order_by()}); + query_params.push_back({"page_token", request.page_token()}); + query_params.push_back({"return_partial_success", + (request.return_partial_success() ? "1" : "0")}); + query_params.push_back( + {"service_project_number", request.service_project_number()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Get< + google::cloud::cpp::compute::v1::HealthSourceAggregatedList>( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "aggregated", "/", + "healthSources"), + std::move(query_params)); +} + +future> +DefaultRegionHealthSourcesRestStub::AsyncDeleteHealthSource( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_health_sources::v1:: + DeleteHealthSourceRequest const& request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto service, auto request, auto rest_context, auto options) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + p.set_value( + rest_internal::Delete( + *service, *rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", *options), + "/", "projects", "/", request.project(), "/", + "regions", "/", request.region(), "/", + "healthSources", "/", request.health_source()), + std::move(query_params))); + }, + std::move(p), + service_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +StatusOr +DefaultRegionHealthSourcesRestStub::DeleteHealthSource( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_sources::v1:: + DeleteHealthSourceRequest const& request) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Delete( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "regions", "/", + request.region(), "/", "healthSources", "/", + request.health_source()), + std::move(query_params)); +} + +StatusOr +DefaultRegionHealthSourcesRestStub::GetHealthSource( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_sources::v1:: + GetHealthSourceRequest const& request) { + std::vector> query_params; + return rest_internal::Get( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "regions", "/", + request.region(), "/", "healthSources", "/", + request.health_source()), + std::move(query_params)); +} + +StatusOr +DefaultRegionHealthSourcesRestStub::GetHealth( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_sources::v1:: + GetHealthRequest const& request) { + std::vector> query_params; + return rest_internal::Get< + google::cloud::cpp::compute::v1::HealthSourceHealth>( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "regions", "/", + request.region(), "/", "healthSources", "/", + request.health_source(), "/", "getHealth"), + std::move(query_params)); +} + +future> +DefaultRegionHealthSourcesRestStub::AsyncInsertHealthSource( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_health_sources::v1:: + InsertHealthSourceRequest const& request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto service, auto request, auto rest_context, auto options) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + p.set_value( + rest_internal::Post( + *service, *rest_context, request.health_source_resource(), + false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", *options), + "/", "projects", "/", request.project(), "/", + "regions", "/", request.region(), "/", + "healthSources"), + std::move(query_params))); + }, + std::move(p), + service_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +StatusOr +DefaultRegionHealthSourcesRestStub::InsertHealthSource( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_sources::v1:: + InsertHealthSourceRequest const& request) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Post( + *service_, rest_context, request.health_source_resource(), false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "regions", "/", + request.region(), "/", "healthSources"), + std::move(query_params)); +} + +StatusOr +DefaultRegionHealthSourcesRestStub::ListRegionHealthSources( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_sources::v1:: + ListRegionHealthSourcesRequest const& request) { + std::vector> query_params; + query_params.push_back({"filter", request.filter()}); + query_params.push_back( + {"max_results", std::to_string(request.max_results())}); + query_params.push_back({"order_by", request.order_by()}); + query_params.push_back({"page_token", request.page_token()}); + query_params.push_back({"return_partial_success", + (request.return_partial_success() ? "1" : "0")}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Get( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "regions", "/", + request.region(), "/", "healthSources"), + std::move(query_params)); +} + +future> +DefaultRegionHealthSourcesRestStub::AsyncPatchHealthSource( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_health_sources::v1:: + PatchHealthSourceRequest const& request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto service, auto request, auto rest_context, auto options) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + p.set_value( + rest_internal::Patch( + *service, *rest_context, request.health_source_resource(), + false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", *options), + "/", "projects", "/", request.project(), "/", + "regions", "/", request.region(), "/", + "healthSources", "/", request.health_source()), + std::move(query_params))); + }, + std::move(p), + service_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +StatusOr +DefaultRegionHealthSourcesRestStub::PatchHealthSource( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_sources::v1:: + PatchHealthSourceRequest const& request) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Patch( + *service_, rest_context, request.health_source_resource(), false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "regions", "/", + request.region(), "/", "healthSources", "/", + request.health_source()), + std::move(query_params)); +} + +StatusOr +DefaultRegionHealthSourcesRestStub::TestIamPermissions( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_sources::v1:: + TestIamPermissionsRequest const& request) { + std::vector> query_params; + return rest_internal::Post< + google::cloud::cpp::compute::v1::TestPermissionsResponse>( + *service_, rest_context, request.test_permissions_request_resource(), + false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "regions", "/", + request.region(), "/", "healthSources", "/", + request.resource(), "/", "testIamPermissions"), + std::move(query_params)); +} + +future> +DefaultRegionHealthSourcesRestStub::AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto operations, auto request, auto rest_context, + auto options) { + p.set_value( + rest_internal::Get( + *operations, *rest_context, request, false, + absl::StrCat("/compute/", + rest_internal::DetermineApiVersion("v1", *options), + "/projects/", request.project(), "/regions/", + request.region(), "/operations/", + request.operation()))); + }, + std::move(p), + operations_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +future DefaultRegionHealthSourcesRestStub::AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + promise> p; + future> f = p.get_future(); + std::thread t{ + [](auto p, auto operations, auto request, auto rest_context, + auto options) { + p.set_value(rest_internal::Post( + *operations, *rest_context, request, false, + absl::StrCat( + "/compute/", rest_internal::DetermineApiVersion("v1", *options), + "/projects/", request.project(), "/regions/", request.region(), + "/operations/", request.operation()))); + }, + std::move(p), + operations_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get().status(); + }); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_health_sources_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_health_sources/v1/internal/region_health_sources_rest_stub.h b/google/cloud/compute/region_health_sources/v1/internal/region_health_sources_rest_stub.h new file mode 100644 index 0000000000000..d7af0fb18f96c --- /dev/null +++ b/google/cloud/compute/region_health_sources/v1/internal/region_health_sources_rest_stub.h @@ -0,0 +1,240 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_health_sources/v1/region_health_sources.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_SOURCES_V1_INTERNAL_REGION_HEALTH_SOURCES_REST_STUB_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_SOURCES_V1_INTERNAL_REGION_HEALTH_SOURCES_REST_STUB_H + +#include "google/cloud/compute/region_health_sources/v1/region_health_sources.pb.h" +#include "google/cloud/compute/region_operations/v1/region_operations.pb.h" +#include "google/cloud/completion_queue.h" +#include "google/cloud/internal/rest_client.h" +#include "google/cloud/internal/rest_context.h" +#include "google/cloud/status_or.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_health_sources_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class RegionHealthSourcesRestStub { + public: + virtual ~RegionHealthSourcesRestStub() = default; + + virtual StatusOr + AggregatedListRegionHealthSources( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_sources::v1:: + AggregatedListRegionHealthSourcesRequest const& request) = 0; + + virtual future> + AsyncDeleteHealthSource( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_health_sources::v1:: + DeleteHealthSourceRequest const& request) = 0; + + virtual StatusOr + DeleteHealthSource(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_sources::v1:: + DeleteHealthSourceRequest const& request) = 0; + + virtual StatusOr + GetHealthSource(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_sources::v1:: + GetHealthSourceRequest const& request) = 0; + + virtual StatusOr + GetHealth(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_sources::v1:: + GetHealthRequest const& request) = 0; + + virtual future> + AsyncInsertHealthSource( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_health_sources::v1:: + InsertHealthSourceRequest const& request) = 0; + + virtual StatusOr + InsertHealthSource(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_sources::v1:: + InsertHealthSourceRequest const& request) = 0; + + virtual StatusOr + ListRegionHealthSources( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_sources::v1:: + ListRegionHealthSourcesRequest const& request) = 0; + + virtual future> + AsyncPatchHealthSource( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_health_sources::v1:: + PatchHealthSourceRequest const& request) = 0; + + virtual StatusOr + PatchHealthSource(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_sources::v1:: + PatchHealthSourceRequest const& request) = 0; + + virtual StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_sources::v1:: + TestIamPermissionsRequest const& request) = 0; + + virtual future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) = 0; + + virtual future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) = 0; +}; + +class DefaultRegionHealthSourcesRestStub : public RegionHealthSourcesRestStub { + public: + ~DefaultRegionHealthSourcesRestStub() override = default; + + explicit DefaultRegionHealthSourcesRestStub(Options options); + DefaultRegionHealthSourcesRestStub( + std::shared_ptr service, + std::shared_ptr operations, Options options); + + StatusOr + AggregatedListRegionHealthSources( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_sources::v1:: + AggregatedListRegionHealthSourcesRequest const& request) override; + + future> + AsyncDeleteHealthSource( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_health_sources::v1:: + DeleteHealthSourceRequest const& request) override; + + StatusOr DeleteHealthSource( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_sources::v1:: + DeleteHealthSourceRequest const& request) override; + + StatusOr GetHealthSource( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_sources::v1:: + GetHealthSourceRequest const& request) override; + + StatusOr GetHealth( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_sources::v1:: + GetHealthRequest const& request) override; + + future> + AsyncInsertHealthSource( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_health_sources::v1:: + InsertHealthSourceRequest const& request) override; + + StatusOr InsertHealthSource( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_sources::v1:: + InsertHealthSourceRequest const& request) override; + + StatusOr + ListRegionHealthSources( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_sources::v1:: + ListRegionHealthSourcesRequest const& request) override; + + future> + AsyncPatchHealthSource( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_health_sources::v1:: + PatchHealthSourceRequest const& request) override; + + StatusOr PatchHealthSource( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_sources::v1:: + PatchHealthSourceRequest const& request) override; + + StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_health_sources::v1:: + TestIamPermissionsRequest const& request) override; + + future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) override; + + future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) override; + + private: + std::shared_ptr service_; + std::shared_ptr operations_; + Options options_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_health_sources_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_SOURCES_V1_INTERNAL_REGION_HEALTH_SOURCES_REST_STUB_H diff --git a/google/cloud/compute/region_health_sources/v1/internal/region_health_sources_rest_stub_factory.cc b/google/cloud/compute/region_health_sources/v1/internal/region_health_sources_rest_stub_factory.cc new file mode 100644 index 0000000000000..a24bf9651dc9c --- /dev/null +++ b/google/cloud/compute/region_health_sources/v1/internal/region_health_sources_rest_stub_factory.cc @@ -0,0 +1,57 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_health_sources/v1/region_health_sources.proto + +#include "google/cloud/compute/region_health_sources/v1/internal/region_health_sources_rest_stub_factory.h" +#include "google/cloud/compute/region_health_sources/v1/internal/region_health_sources_rest_logging_decorator.h" +#include "google/cloud/compute/region_health_sources/v1/internal/region_health_sources_rest_metadata_decorator.h" +#include "google/cloud/compute/region_health_sources/v1/internal/region_health_sources_rest_stub.h" +#include "google/cloud/common_options.h" +#include "google/cloud/internal/algorithm.h" +#include "google/cloud/internal/populate_rest_options.h" +#include "google/cloud/log.h" +#include "google/cloud/options.h" +#include "google/cloud/rest_options.h" +#include "absl/strings/match.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_health_sources_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +std::shared_ptr +CreateDefaultRegionHealthSourcesRestStub(Options const& options) { + auto opts = internal::PopulateRestOptions(options); + std::shared_ptr stub = + std::make_shared(std::move(opts)); + stub = std::make_shared(std::move(stub)); + if (internal::Contains(options.get(), "rpc")) { + GCP_LOG(INFO) << "Enabled logging for REST rpc calls"; + stub = std::make_shared( + std::move(stub), options.get(), + options.get()); + } + return stub; +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_health_sources_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_health_sources/v1/internal/region_health_sources_rest_stub_factory.h b/google/cloud/compute/region_health_sources/v1/internal/region_health_sources_rest_stub_factory.h new file mode 100644 index 0000000000000..4ccc92db92916 --- /dev/null +++ b/google/cloud/compute/region_health_sources/v1/internal/region_health_sources_rest_stub_factory.h @@ -0,0 +1,41 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_health_sources/v1/region_health_sources.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_SOURCES_V1_INTERNAL_REGION_HEALTH_SOURCES_REST_STUB_FACTORY_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_SOURCES_V1_INTERNAL_REGION_HEALTH_SOURCES_REST_STUB_FACTORY_H + +#include "google/cloud/compute/region_health_sources/v1/internal/region_health_sources_rest_stub.h" +#include "google/cloud/options.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_health_sources_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +std::shared_ptr +CreateDefaultRegionHealthSourcesRestStub(Options const& options); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_health_sources_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_SOURCES_V1_INTERNAL_REGION_HEALTH_SOURCES_REST_STUB_FACTORY_H diff --git a/google/cloud/compute/region_health_sources/v1/internal/region_health_sources_retry_traits.h b/google/cloud/compute/region_health_sources/v1/internal/region_health_sources_retry_traits.h new file mode 100644 index 0000000000000..a161eeabfb7ef --- /dev/null +++ b/google/cloud/compute/region_health_sources/v1/internal/region_health_sources_retry_traits.h @@ -0,0 +1,44 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_health_sources/v1/region_health_sources.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_SOURCES_V1_INTERNAL_REGION_HEALTH_SOURCES_RETRY_TRAITS_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_SOURCES_V1_INTERNAL_REGION_HEALTH_SOURCES_RETRY_TRAITS_H + +#include "google/cloud/status.h" +#include "google/cloud/version.h" + +namespace google { +namespace cloud { +namespace compute_region_health_sources_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/// Define the gRPC status code semantics for retrying requests. +struct RegionHealthSourcesRetryTraits { + static bool IsPermanentFailure(google::cloud::Status const& status) { + return status.code() != StatusCode::kOk && + status.code() != StatusCode::kUnavailable; + } +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_health_sources_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_SOURCES_V1_INTERNAL_REGION_HEALTH_SOURCES_RETRY_TRAITS_H diff --git a/google/cloud/compute/region_health_sources/v1/internal/region_health_sources_sources.cc b/google/cloud/compute/region_health_sources/v1/internal/region_health_sources_sources.cc new file mode 100644 index 0000000000000..e26097bd8b835 --- /dev/null +++ b/google/cloud/compute/region_health_sources/v1/internal/region_health_sources_sources.cc @@ -0,0 +1,32 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_health_sources/v1/region_health_sources.proto + +// NOLINTBEGIN(bugprone-suspicious-include) +#include "google/cloud/compute/region_health_sources/v1/internal/region_health_sources_option_defaults.cc" +#include "google/cloud/compute/region_health_sources/v1/internal/region_health_sources_rest_connection_impl.cc" +#include "google/cloud/compute/region_health_sources/v1/internal/region_health_sources_rest_logging_decorator.cc" +#include "google/cloud/compute/region_health_sources/v1/internal/region_health_sources_rest_metadata_decorator.cc" +#include "google/cloud/compute/region_health_sources/v1/internal/region_health_sources_rest_stub.cc" +#include "google/cloud/compute/region_health_sources/v1/internal/region_health_sources_rest_stub_factory.cc" +#include "google/cloud/compute/region_health_sources/v1/internal/region_health_sources_tracing_connection.cc" +#include "google/cloud/compute/region_health_sources/v1/region_health_sources_client.cc" +#include "google/cloud/compute/region_health_sources/v1/region_health_sources_connection.cc" +#include "google/cloud/compute/region_health_sources/v1/region_health_sources_connection_idempotency_policy.cc" +#include "google/cloud/compute/region_health_sources/v1/region_health_sources_rest_connection.cc" +// NOLINTEND(bugprone-suspicious-include) diff --git a/google/cloud/compute/region_health_sources/v1/internal/region_health_sources_tracing_connection.cc b/google/cloud/compute/region_health_sources/v1/internal/region_health_sources_tracing_connection.cc new file mode 100644 index 0000000000000..f3e835db77f03 --- /dev/null +++ b/google/cloud/compute/region_health_sources/v1/internal/region_health_sources_tracing_connection.cc @@ -0,0 +1,218 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_health_sources/v1/region_health_sources.proto + +#include "google/cloud/compute/region_health_sources/v1/internal/region_health_sources_tracing_connection.h" +#include "google/cloud/internal/opentelemetry.h" +#include "google/cloud/internal/traced_stream_range.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_health_sources_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +RegionHealthSourcesTracingConnection::RegionHealthSourcesTracingConnection( + std::shared_ptr< + compute_region_health_sources_v1::RegionHealthSourcesConnection> + child) + : child_(std::move(child)) {} + +StreamRange> +RegionHealthSourcesTracingConnection::AggregatedListRegionHealthSources( + google::cloud::cpp::compute::region_health_sources::v1:: + AggregatedListRegionHealthSourcesRequest request) { + auto span = internal::MakeSpan( + "compute_region_health_sources_v1::RegionHealthSourcesConnection::" + "AggregatedListRegionHealthSources"); + internal::OTelScope scope(span); + auto sr = child_->AggregatedListRegionHealthSources(std::move(request)); + return internal::MakeTracedStreamRange>( + std::move(span), std::move(sr)); +} + +future> +RegionHealthSourcesTracingConnection::DeleteHealthSource( + google::cloud::cpp::compute::region_health_sources::v1:: + DeleteHealthSourceRequest const& request) { + auto span = internal::MakeSpan( + "compute_region_health_sources_v1::RegionHealthSourcesConnection::" + "DeleteHealthSource"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), + child_->DeleteHealthSource(request)); +} + +StatusOr +RegionHealthSourcesTracingConnection::DeleteHealthSource( + NoAwaitTag, google::cloud::cpp::compute::region_health_sources::v1:: + DeleteHealthSourceRequest const& request) { + auto span = internal::MakeSpan( + "compute_region_health_sources_v1::RegionHealthSourcesConnection::" + "DeleteHealthSource"); + opentelemetry::trace::Scope scope(span); + return internal::EndSpan(*span, + child_->DeleteHealthSource(NoAwaitTag{}, request)); +} + +future> +RegionHealthSourcesTracingConnection::DeleteHealthSource( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto span = internal::MakeSpan( + "compute_region_health_sources_v1::RegionHealthSourcesConnection::" + "DeleteHealthSource"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), + child_->DeleteHealthSource(operation)); +} + +StatusOr +RegionHealthSourcesTracingConnection::GetHealthSource( + google::cloud::cpp::compute::region_health_sources::v1:: + GetHealthSourceRequest const& request) { + auto span = internal::MakeSpan( + "compute_region_health_sources_v1::RegionHealthSourcesConnection::" + "GetHealthSource"); + auto scope = opentelemetry::trace::Scope(span); + return internal::EndSpan(*span, child_->GetHealthSource(request)); +} + +StatusOr +RegionHealthSourcesTracingConnection::GetHealth( + google::cloud::cpp::compute::region_health_sources::v1:: + GetHealthRequest const& request) { + auto span = internal::MakeSpan( + "compute_region_health_sources_v1::RegionHealthSourcesConnection::" + "GetHealth"); + auto scope = opentelemetry::trace::Scope(span); + return internal::EndSpan(*span, child_->GetHealth(request)); +} + +future> +RegionHealthSourcesTracingConnection::InsertHealthSource( + google::cloud::cpp::compute::region_health_sources::v1:: + InsertHealthSourceRequest const& request) { + auto span = internal::MakeSpan( + "compute_region_health_sources_v1::RegionHealthSourcesConnection::" + "InsertHealthSource"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), + child_->InsertHealthSource(request)); +} + +StatusOr +RegionHealthSourcesTracingConnection::InsertHealthSource( + NoAwaitTag, google::cloud::cpp::compute::region_health_sources::v1:: + InsertHealthSourceRequest const& request) { + auto span = internal::MakeSpan( + "compute_region_health_sources_v1::RegionHealthSourcesConnection::" + "InsertHealthSource"); + opentelemetry::trace::Scope scope(span); + return internal::EndSpan(*span, + child_->InsertHealthSource(NoAwaitTag{}, request)); +} + +future> +RegionHealthSourcesTracingConnection::InsertHealthSource( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto span = internal::MakeSpan( + "compute_region_health_sources_v1::RegionHealthSourcesConnection::" + "InsertHealthSource"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), + child_->InsertHealthSource(operation)); +} + +StreamRange +RegionHealthSourcesTracingConnection::ListRegionHealthSources( + google::cloud::cpp::compute::region_health_sources::v1:: + ListRegionHealthSourcesRequest request) { + auto span = internal::MakeSpan( + "compute_region_health_sources_v1::RegionHealthSourcesConnection::" + "ListRegionHealthSources"); + internal::OTelScope scope(span); + auto sr = child_->ListRegionHealthSources(std::move(request)); + return internal::MakeTracedStreamRange< + google::cloud::cpp::compute::v1::HealthSource>(std::move(span), + std::move(sr)); +} + +future> +RegionHealthSourcesTracingConnection::PatchHealthSource( + google::cloud::cpp::compute::region_health_sources::v1:: + PatchHealthSourceRequest const& request) { + auto span = internal::MakeSpan( + "compute_region_health_sources_v1::RegionHealthSourcesConnection::" + "PatchHealthSource"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), child_->PatchHealthSource(request)); +} + +StatusOr +RegionHealthSourcesTracingConnection::PatchHealthSource( + NoAwaitTag, google::cloud::cpp::compute::region_health_sources::v1:: + PatchHealthSourceRequest const& request) { + auto span = internal::MakeSpan( + "compute_region_health_sources_v1::RegionHealthSourcesConnection::" + "PatchHealthSource"); + opentelemetry::trace::Scope scope(span); + return internal::EndSpan(*span, + child_->PatchHealthSource(NoAwaitTag{}, request)); +} + +future> +RegionHealthSourcesTracingConnection::PatchHealthSource( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto span = internal::MakeSpan( + "compute_region_health_sources_v1::RegionHealthSourcesConnection::" + "PatchHealthSource"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), + child_->PatchHealthSource(operation)); +} + +StatusOr +RegionHealthSourcesTracingConnection::TestIamPermissions( + google::cloud::cpp::compute::region_health_sources::v1:: + TestIamPermissionsRequest const& request) { + auto span = internal::MakeSpan( + "compute_region_health_sources_v1::RegionHealthSourcesConnection::" + "TestIamPermissions"); + auto scope = opentelemetry::trace::Scope(span); + return internal::EndSpan(*span, child_->TestIamPermissions(request)); +} + +std::shared_ptr +MakeRegionHealthSourcesTracingConnection( + std::shared_ptr< + compute_region_health_sources_v1::RegionHealthSourcesConnection> + conn) { + if (internal::TracingEnabled(conn->options())) { + conn = + std::make_shared(std::move(conn)); + } + return conn; +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_health_sources_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_health_sources/v1/internal/region_health_sources_tracing_connection.h b/google/cloud/compute/region_health_sources/v1/internal/region_health_sources_tracing_connection.h new file mode 100644 index 0000000000000..70a970263dad0 --- /dev/null +++ b/google/cloud/compute/region_health_sources/v1/internal/region_health_sources_tracing_connection.h @@ -0,0 +1,126 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_health_sources/v1/region_health_sources.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_SOURCES_V1_INTERNAL_REGION_HEALTH_SOURCES_TRACING_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_SOURCES_V1_INTERNAL_REGION_HEALTH_SOURCES_TRACING_CONNECTION_H + +#include "google/cloud/compute/region_health_sources/v1/region_health_sources_connection.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_health_sources_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class RegionHealthSourcesTracingConnection + : public compute_region_health_sources_v1::RegionHealthSourcesConnection { + public: + ~RegionHealthSourcesTracingConnection() override = default; + + explicit RegionHealthSourcesTracingConnection( + std::shared_ptr< + compute_region_health_sources_v1::RegionHealthSourcesConnection> + child); + + Options options() override { return child_->options(); } + + StreamRange> + AggregatedListRegionHealthSources( + google::cloud::cpp::compute::region_health_sources::v1:: + AggregatedListRegionHealthSourcesRequest request) override; + + future> + DeleteHealthSource(google::cloud::cpp::compute::region_health_sources::v1:: + DeleteHealthSourceRequest const& request) override; + + StatusOr DeleteHealthSource( + NoAwaitTag, google::cloud::cpp::compute::region_health_sources::v1:: + DeleteHealthSourceRequest const& request) override; + + future> + DeleteHealthSource( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + StatusOr GetHealthSource( + google::cloud::cpp::compute::region_health_sources::v1:: + GetHealthSourceRequest const& request) override; + + StatusOr GetHealth( + google::cloud::cpp::compute::region_health_sources::v1:: + GetHealthRequest const& request) override; + + future> + InsertHealthSource(google::cloud::cpp::compute::region_health_sources::v1:: + InsertHealthSourceRequest const& request) override; + + StatusOr InsertHealthSource( + NoAwaitTag, google::cloud::cpp::compute::region_health_sources::v1:: + InsertHealthSourceRequest const& request) override; + + future> + InsertHealthSource( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + StreamRange + ListRegionHealthSources( + google::cloud::cpp::compute::region_health_sources::v1:: + ListRegionHealthSourcesRequest request) override; + + future> + PatchHealthSource(google::cloud::cpp::compute::region_health_sources::v1:: + PatchHealthSourceRequest const& request) override; + + StatusOr PatchHealthSource( + NoAwaitTag, google::cloud::cpp::compute::region_health_sources::v1:: + PatchHealthSourceRequest const& request) override; + + future> + PatchHealthSource( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + StatusOr + TestIamPermissions(google::cloud::cpp::compute::region_health_sources::v1:: + TestIamPermissionsRequest const& request) override; + + private: + std::shared_ptr< + compute_region_health_sources_v1::RegionHealthSourcesConnection> + child_; +}; + +/** + * Conditionally applies the tracing decorator to the given connection. + * + * The connection is only decorated if tracing is enabled (as determined by the + * connection's options). + */ +std::shared_ptr +MakeRegionHealthSourcesTracingConnection( + std::shared_ptr< + compute_region_health_sources_v1::RegionHealthSourcesConnection> + conn); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_health_sources_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_SOURCES_V1_INTERNAL_REGION_HEALTH_SOURCES_TRACING_CONNECTION_H diff --git a/google/cloud/compute/region_health_sources/v1/mocks/mock_region_health_sources_connection.h b/google/cloud/compute/region_health_sources/v1/mocks/mock_region_health_sources_connection.h new file mode 100644 index 0000000000000..74428e3dc9954 --- /dev/null +++ b/google/cloud/compute/region_health_sources/v1/mocks/mock_region_health_sources_connection.h @@ -0,0 +1,214 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_health_sources/v1/region_health_sources.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_SOURCES_V1_MOCKS_MOCK_REGION_HEALTH_SOURCES_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_SOURCES_V1_MOCKS_MOCK_REGION_HEALTH_SOURCES_CONNECTION_H + +#include "google/cloud/compute/region_health_sources/v1/region_health_sources_connection.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_health_sources_v1_mocks { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/** + * A class to mock `RegionHealthSourcesConnection`. + * + * Application developers may want to test their code with simulated responses, + * including errors, from an object of type `RegionHealthSourcesClient`. To do + * so, construct an object of type `RegionHealthSourcesClient` with an instance + * of this class. Then use the Google Test framework functions to program the + * behavior of this mock. + * + * @see [This example][bq-mock] for how to test your application with GoogleTest. + * While the example showcases types from the BigQuery library, the underlying + * principles apply for any pair of `*Client` and `*Connection`. + * + * [bq-mock]: @cloud_cpp_docs_link{bigquery,bigquery-read-mock} + */ +class MockRegionHealthSourcesConnection + : public compute_region_health_sources_v1::RegionHealthSourcesConnection { + public: + MOCK_METHOD(Options, options, (), (override)); + + MOCK_METHOD( + (StreamRange< + std::pair>), + AggregatedListRegionHealthSources, + (google::cloud::cpp::compute::region_health_sources::v1:: + AggregatedListRegionHealthSourcesRequest request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// DeleteHealthSource(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + DeleteHealthSource, + (google::cloud::cpp::compute::region_health_sources::v1:: + DeleteHealthSourceRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// EXPECT_CALL(*mock, DeleteHealthSource(_, _)) + /// @endcode + MOCK_METHOD(StatusOr, + DeleteHealthSource, + (NoAwaitTag, google::cloud::cpp::compute::region_health_sources:: + v1::DeleteHealthSourceRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// DeleteHealthSource(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + DeleteHealthSource, + (google::cloud::cpp::compute::v1::Operation const& operation), + (override)); + + MOCK_METHOD(StatusOr, + GetHealthSource, + (google::cloud::cpp::compute::region_health_sources::v1:: + GetHealthSourceRequest const& request), + (override)); + + MOCK_METHOD(StatusOr, + GetHealth, + (google::cloud::cpp::compute::region_health_sources::v1:: + GetHealthRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// InsertHealthSource(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + InsertHealthSource, + (google::cloud::cpp::compute::region_health_sources::v1:: + InsertHealthSourceRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// EXPECT_CALL(*mock, InsertHealthSource(_, _)) + /// @endcode + MOCK_METHOD(StatusOr, + InsertHealthSource, + (NoAwaitTag, google::cloud::cpp::compute::region_health_sources:: + v1::InsertHealthSourceRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// InsertHealthSource(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + InsertHealthSource, + (google::cloud::cpp::compute::v1::Operation const& operation), + (override)); + + MOCK_METHOD((StreamRange), + ListRegionHealthSources, + (google::cloud::cpp::compute::region_health_sources::v1:: + ListRegionHealthSourcesRequest request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// PatchHealthSource(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + PatchHealthSource, + (google::cloud::cpp::compute::region_health_sources::v1:: + PatchHealthSourceRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// EXPECT_CALL(*mock, PatchHealthSource(_, _)) + /// @endcode + MOCK_METHOD(StatusOr, + PatchHealthSource, + (NoAwaitTag, google::cloud::cpp::compute::region_health_sources:: + v1::PatchHealthSourceRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// PatchHealthSource(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + PatchHealthSource, + (google::cloud::cpp::compute::v1::Operation const& operation), + (override)); + + MOCK_METHOD( + StatusOr, + TestIamPermissions, + (google::cloud::cpp::compute::region_health_sources::v1:: + TestIamPermissionsRequest const& request), + (override)); +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_health_sources_v1_mocks +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_SOURCES_V1_MOCKS_MOCK_REGION_HEALTH_SOURCES_CONNECTION_H diff --git a/google/cloud/compute/region_health_sources/v1/region_health_sources_client.cc b/google/cloud/compute/region_health_sources/v1/region_health_sources_client.cc new file mode 100644 index 0000000000000..89b2ccf1b9e31 --- /dev/null +++ b/google/cloud/compute/region_health_sources/v1/region_health_sources_client.cc @@ -0,0 +1,321 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_health_sources/v1/region_health_sources.proto + +#include "google/cloud/compute/region_health_sources/v1/region_health_sources_client.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_health_sources_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +RegionHealthSourcesClient::RegionHealthSourcesClient( + std::shared_ptr connection, Options opts) + : connection_(std::move(connection)), + options_( + internal::MergeOptions(std::move(opts), connection_->options())) {} +RegionHealthSourcesClient::~RegionHealthSourcesClient() = default; + +StreamRange> +RegionHealthSourcesClient::AggregatedListRegionHealthSources( + std::string const& project, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_health_sources::v1:: + AggregatedListRegionHealthSourcesRequest request; + request.set_project(project); + return connection_->AggregatedListRegionHealthSources(request); +} + +StreamRange> +RegionHealthSourcesClient::AggregatedListRegionHealthSources( + google::cloud::cpp::compute::region_health_sources::v1:: + AggregatedListRegionHealthSourcesRequest request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->AggregatedListRegionHealthSources(std::move(request)); +} + +future> +RegionHealthSourcesClient::DeleteHealthSource(std::string const& project, + std::string const& region, + std::string const& health_source, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_health_sources::v1:: + DeleteHealthSourceRequest request; + request.set_project(project); + request.set_region(region); + request.set_health_source(health_source); + return connection_->DeleteHealthSource(request); +} + +StatusOr +RegionHealthSourcesClient::DeleteHealthSource(NoAwaitTag, + std::string const& project, + std::string const& region, + std::string const& health_source, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_health_sources::v1:: + DeleteHealthSourceRequest request; + request.set_project(project); + request.set_region(region); + request.set_health_source(health_source); + return connection_->DeleteHealthSource(NoAwaitTag{}, request); +} + +future> +RegionHealthSourcesClient::DeleteHealthSource( + google::cloud::cpp::compute::region_health_sources::v1:: + DeleteHealthSourceRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->DeleteHealthSource(request); +} + +StatusOr +RegionHealthSourcesClient::DeleteHealthSource( + NoAwaitTag, + google::cloud::cpp::compute::region_health_sources::v1:: + DeleteHealthSourceRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->DeleteHealthSource(NoAwaitTag{}, request); +} + +future> +RegionHealthSourcesClient::DeleteHealthSource( + google::cloud::cpp::compute::v1::Operation const& operation, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->DeleteHealthSource(operation); +} + +StatusOr +RegionHealthSourcesClient::GetHealthSource(std::string const& project, + std::string const& region, + std::string const& health_source, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_health_sources::v1::GetHealthSourceRequest + request; + request.set_project(project); + request.set_region(region); + request.set_health_source(health_source); + return connection_->GetHealthSource(request); +} + +StatusOr +RegionHealthSourcesClient::GetHealthSource( + google::cloud::cpp::compute::region_health_sources::v1:: + GetHealthSourceRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->GetHealthSource(request); +} + +StatusOr +RegionHealthSourcesClient::GetHealth(std::string const& project, + std::string const& region, + std::string const& health_source, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_health_sources::v1::GetHealthRequest + request; + request.set_project(project); + request.set_region(region); + request.set_health_source(health_source); + return connection_->GetHealth(request); +} + +StatusOr +RegionHealthSourcesClient::GetHealth( + google::cloud::cpp::compute::region_health_sources::v1:: + GetHealthRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->GetHealth(request); +} + +future> +RegionHealthSourcesClient::InsertHealthSource( + std::string const& project, std::string const& region, + google::cloud::cpp::compute::v1::HealthSource const& health_source_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_health_sources::v1:: + InsertHealthSourceRequest request; + request.set_project(project); + request.set_region(region); + *request.mutable_health_source_resource() = health_source_resource; + return connection_->InsertHealthSource(request); +} + +StatusOr +RegionHealthSourcesClient::InsertHealthSource( + NoAwaitTag, std::string const& project, std::string const& region, + google::cloud::cpp::compute::v1::HealthSource const& health_source_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_health_sources::v1:: + InsertHealthSourceRequest request; + request.set_project(project); + request.set_region(region); + *request.mutable_health_source_resource() = health_source_resource; + return connection_->InsertHealthSource(NoAwaitTag{}, request); +} + +future> +RegionHealthSourcesClient::InsertHealthSource( + google::cloud::cpp::compute::region_health_sources::v1:: + InsertHealthSourceRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->InsertHealthSource(request); +} + +StatusOr +RegionHealthSourcesClient::InsertHealthSource( + NoAwaitTag, + google::cloud::cpp::compute::region_health_sources::v1:: + InsertHealthSourceRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->InsertHealthSource(NoAwaitTag{}, request); +} + +future> +RegionHealthSourcesClient::InsertHealthSource( + google::cloud::cpp::compute::v1::Operation const& operation, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->InsertHealthSource(operation); +} + +StreamRange +RegionHealthSourcesClient::ListRegionHealthSources(std::string const& project, + std::string const& region, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_health_sources::v1:: + ListRegionHealthSourcesRequest request; + request.set_project(project); + request.set_region(region); + return connection_->ListRegionHealthSources(request); +} + +StreamRange +RegionHealthSourcesClient::ListRegionHealthSources( + google::cloud::cpp::compute::region_health_sources::v1:: + ListRegionHealthSourcesRequest request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->ListRegionHealthSources(std::move(request)); +} + +future> +RegionHealthSourcesClient::PatchHealthSource( + std::string const& project, std::string const& region, + std::string const& health_source, + google::cloud::cpp::compute::v1::HealthSource const& health_source_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_health_sources::v1:: + PatchHealthSourceRequest request; + request.set_project(project); + request.set_region(region); + request.set_health_source(health_source); + *request.mutable_health_source_resource() = health_source_resource; + return connection_->PatchHealthSource(request); +} + +StatusOr +RegionHealthSourcesClient::PatchHealthSource( + NoAwaitTag, std::string const& project, std::string const& region, + std::string const& health_source, + google::cloud::cpp::compute::v1::HealthSource const& health_source_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_health_sources::v1:: + PatchHealthSourceRequest request; + request.set_project(project); + request.set_region(region); + request.set_health_source(health_source); + *request.mutable_health_source_resource() = health_source_resource; + return connection_->PatchHealthSource(NoAwaitTag{}, request); +} + +future> +RegionHealthSourcesClient::PatchHealthSource( + google::cloud::cpp::compute::region_health_sources::v1:: + PatchHealthSourceRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->PatchHealthSource(request); +} + +StatusOr +RegionHealthSourcesClient::PatchHealthSource( + NoAwaitTag, + google::cloud::cpp::compute::region_health_sources::v1:: + PatchHealthSourceRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->PatchHealthSource(NoAwaitTag{}, request); +} + +future> +RegionHealthSourcesClient::PatchHealthSource( + google::cloud::cpp::compute::v1::Operation const& operation, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->PatchHealthSource(operation); +} + +StatusOr +RegionHealthSourcesClient::TestIamPermissions( + std::string const& project, std::string const& region, + std::string const& resource, + google::cloud::cpp::compute::v1::TestPermissionsRequest const& + test_permissions_request_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_health_sources::v1:: + TestIamPermissionsRequest request; + request.set_project(project); + request.set_region(region); + request.set_resource(resource); + *request.mutable_test_permissions_request_resource() = + test_permissions_request_resource; + return connection_->TestIamPermissions(request); +} + +StatusOr +RegionHealthSourcesClient::TestIamPermissions( + google::cloud::cpp::compute::region_health_sources::v1:: + TestIamPermissionsRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->TestIamPermissions(request); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_health_sources_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_health_sources/v1/region_health_sources_client.h b/google/cloud/compute/region_health_sources/v1/region_health_sources_client.h new file mode 100644 index 0000000000000..16966ae10a097 --- /dev/null +++ b/google/cloud/compute/region_health_sources/v1/region_health_sources_client.h @@ -0,0 +1,844 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_health_sources/v1/region_health_sources.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_SOURCES_V1_REGION_HEALTH_SOURCES_CLIENT_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_SOURCES_V1_REGION_HEALTH_SOURCES_CLIENT_H + +#include "google/cloud/compute/region_health_sources/v1/region_health_sources_rest_connection.h" +#include "google/cloud/future.h" +#include "google/cloud/no_await_tag.h" +#include "google/cloud/options.h" +#include "google/cloud/polling_policy.h" +#include "google/cloud/status_or.h" +#include "google/cloud/version.h" +#include +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_health_sources_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/// +/// Service for the regionHealthSources resource. +/// https://cloud.google.com/compute/docs/reference/rest/v1/regionHealthSources +/// +/// @par Equality +/// +/// Instances of this class created via copy-construction or copy-assignment +/// always compare equal. Instances created with equal +/// `std::shared_ptr<*Connection>` objects compare equal. Objects that compare +/// equal share the same underlying resources. +/// +/// @par Performance +/// +/// Creating a new instance of this class is a relatively expensive operation, +/// new objects establish new connections to the service. In contrast, +/// copy-construction, move-construction, and the corresponding assignment +/// operations are relatively efficient as the copies share all underlying +/// resources. +/// +/// @par Thread Safety +/// +/// Concurrent access to different instances of this class, even if they compare +/// equal, is guaranteed to work. Two or more threads operating on the same +/// instance of this class is not guaranteed to work. Since copy-construction +/// and move-construction is a relatively efficient operation, consider using +/// such a copy when using this class from multiple threads. +/// +class RegionHealthSourcesClient { + public: + explicit RegionHealthSourcesClient( + std::shared_ptr connection, + Options opts = {}); + ~RegionHealthSourcesClient(); + + ///@{ + /// @name Copy and move support + RegionHealthSourcesClient(RegionHealthSourcesClient const&) = default; + RegionHealthSourcesClient& operator=(RegionHealthSourcesClient const&) = + default; + RegionHealthSourcesClient(RegionHealthSourcesClient&&) = default; + RegionHealthSourcesClient& operator=(RegionHealthSourcesClient&&) = default; + ///@} + + ///@{ + /// @name Equality + friend bool operator==(RegionHealthSourcesClient const& a, + RegionHealthSourcesClient const& b) { + return a.connection_ == b.connection_; + } + friend bool operator!=(RegionHealthSourcesClient const& a, + RegionHealthSourcesClient const& b) { + return !(a == b); + } + ///@} + + // clang-format off + /// + /// Retrieves the list of all HealthSource resources (all + /// regional) available to the specified project. + /// + /// To prevent failure, Google recommends that you set the + /// `returnPartialSuccess` parameter to `true`. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionHealthSources/aggregatedList + /// + /// @param project Name of the project scoping this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return a [StreamRange](@ref google::cloud::StreamRange) + /// to iterate of the results. See the documentation of this type for + /// details. In brief, this class has `begin()` and `end()` member + /// functions returning a iterator class meeting the + /// [input iterator requirements]. The value type for this iterator is a + /// [`StatusOr`] as the iteration may fail even after some values are + /// retrieved successfully, for example, if there is a network disconnect. + /// An empty set of results does not indicate an error, it indicates + /// that there are no resources meeting the request criteria. + /// On a successful iteration the `StatusOr` contains elements of type + /// [google.cloud.cpp.compute.v1.HealthSourcesScopedList], or rather, + /// the C++ class generated by Protobuf from that type. Please consult the + /// Protobuf documentation for details on the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_health_sources.v1.AggregatedListRegionHealthSourcesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_sources/v1/region_health_sources.proto#L142} + /// [google.cloud.cpp.compute.v1.HealthSourcesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_064.proto#L410} + /// + // clang-format on + StreamRange> + AggregatedListRegionHealthSources(std::string const& project, + Options opts = {}); + + // clang-format off + /// + /// Retrieves the list of all HealthSource resources (all + /// regional) available to the specified project. + /// + /// To prevent failure, Google recommends that you set the + /// `returnPartialSuccess` parameter to `true`. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionHealthSources/aggregatedList + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.region_health_sources.v1.AggregatedListRegionHealthSourcesRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return a [StreamRange](@ref google::cloud::StreamRange) + /// to iterate of the results. See the documentation of this type for + /// details. In brief, this class has `begin()` and `end()` member + /// functions returning a iterator class meeting the + /// [input iterator requirements]. The value type for this iterator is a + /// [`StatusOr`] as the iteration may fail even after some values are + /// retrieved successfully, for example, if there is a network disconnect. + /// An empty set of results does not indicate an error, it indicates + /// that there are no resources meeting the request criteria. + /// On a successful iteration the `StatusOr` contains elements of type + /// [google.cloud.cpp.compute.v1.HealthSourcesScopedList], or rather, + /// the C++ class generated by Protobuf from that type. Please consult the + /// Protobuf documentation for details on the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_health_sources.v1.AggregatedListRegionHealthSourcesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_sources/v1/region_health_sources.proto#L142} + /// [google.cloud.cpp.compute.v1.HealthSourcesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_064.proto#L410} + /// + // clang-format on + StreamRange> + AggregatedListRegionHealthSources( + google::cloud::cpp::compute::region_health_sources::v1:: + AggregatedListRegionHealthSourcesRequest request, + Options opts = {}); + + // clang-format off + /// + /// Deletes the specified HealthSource in the given region + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionHealthSources/delete + /// + /// @param project Project ID for this request. + /// @param region Name of the region scoping this request. + /// @param health_source Name of the HealthSource resource to delete. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_health_sources.v1.DeleteHealthSourceRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_sources/v1/region_health_sources.proto#L257} + /// + // clang-format on + future> + DeleteHealthSource(std::string const& project, std::string const& region, + std::string const& health_source, Options opts = {}); + + // clang-format off + /// + /// @copybrief DeleteHealthSource + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr DeleteHealthSource( + NoAwaitTag, std::string const& project, std::string const& region, + std::string const& health_source, Options opts = {}); + + // clang-format off + /// + /// Deletes the specified HealthSource in the given region + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionHealthSources/delete + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.region_health_sources.v1.DeleteHealthSourceRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_health_sources.v1.DeleteHealthSourceRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_sources/v1/region_health_sources.proto#L257} + /// + // clang-format on + future> + DeleteHealthSource(google::cloud::cpp::compute::region_health_sources::v1:: + DeleteHealthSourceRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief DeleteHealthSource + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr DeleteHealthSource( + NoAwaitTag, + google::cloud::cpp::compute::region_health_sources::v1:: + DeleteHealthSourceRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief DeleteHealthSource + /// + /// This method accepts a `google::cloud::cpp::compute::v1::Operation` that corresponds + /// to a previously started Long Running Operation (LRO) and polls the status + /// of the LRO in the background. + /// + // clang-format on + future> + DeleteHealthSource( + google::cloud::cpp::compute::v1::Operation const& operation, + Options opts = {}); + + // clang-format off + /// + /// Returns the specified HealthSource resource in the given region. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionHealthSources/get + /// + /// @param project Project ID for this request. + /// @param region Name of the region scoping this request. + /// @param health_source Name of the HealthSource resource to return. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.HealthSource]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_health_sources.v1.GetHealthSourceRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_sources/v1/region_health_sources.proto#L308} + /// [google.cloud.cpp.compute.v1.HealthSource]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_064.proto#L29} + /// + // clang-format on + StatusOr GetHealthSource( + std::string const& project, std::string const& region, + std::string const& health_source, Options opts = {}); + + // clang-format off + /// + /// Returns the specified HealthSource resource in the given region. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionHealthSources/get + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.region_health_sources.v1.GetHealthSourceRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.HealthSource]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_health_sources.v1.GetHealthSourceRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_sources/v1/region_health_sources.proto#L308} + /// [google.cloud.cpp.compute.v1.HealthSource]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_064.proto#L29} + /// + // clang-format on + StatusOr GetHealthSource( + google::cloud::cpp::compute::region_health_sources::v1:: + GetHealthSourceRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// Gets the most recent health check results for this + /// regional HealthSource. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionHealthSources/getHealth + /// + /// @param project Name of the project scoping this request. + /// @param region Name of the region scoping this request. + /// @param health_source Name of the HealthSource resource to get health for. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.HealthSourceHealth]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_health_sources.v1.GetHealthRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_sources/v1/region_health_sources.proto#L293} + /// [google.cloud.cpp.compute.v1.HealthSourceHealth]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_064.proto#L234} + /// + // clang-format on + StatusOr GetHealth( + std::string const& project, std::string const& region, + std::string const& health_source, Options opts = {}); + + // clang-format off + /// + /// Gets the most recent health check results for this + /// regional HealthSource. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionHealthSources/getHealth + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.region_health_sources.v1.GetHealthRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.HealthSourceHealth]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_health_sources.v1.GetHealthRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_sources/v1/region_health_sources.proto#L293} + /// [google.cloud.cpp.compute.v1.HealthSourceHealth]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_064.proto#L234} + /// + // clang-format on + StatusOr GetHealth( + google::cloud::cpp::compute::region_health_sources::v1:: + GetHealthRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// Create a HealthSource in the specified project in the given region + /// using the parameters that are included in the request. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionHealthSources/insert + /// + /// @param project Project ID for this request. + /// @param region Name of the region scoping this request. + /// @param health_source_resource The HealthSource for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_health_sources.v1.InsertHealthSourceRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_sources/v1/region_health_sources.proto#L323} + /// + // clang-format on + future> + InsertHealthSource(std::string const& project, std::string const& region, + google::cloud::cpp::compute::v1::HealthSource const& + health_source_resource, + Options opts = {}); + + // clang-format off + /// + /// @copybrief InsertHealthSource + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr InsertHealthSource( + NoAwaitTag, std::string const& project, std::string const& region, + google::cloud::cpp::compute::v1::HealthSource const& + health_source_resource, + Options opts = {}); + + // clang-format off + /// + /// Create a HealthSource in the specified project in the given region + /// using the parameters that are included in the request. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionHealthSources/insert + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.region_health_sources.v1.InsertHealthSourceRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_health_sources.v1.InsertHealthSourceRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_sources/v1/region_health_sources.proto#L323} + /// + // clang-format on + future> + InsertHealthSource(google::cloud::cpp::compute::region_health_sources::v1:: + InsertHealthSourceRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief InsertHealthSource + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr InsertHealthSource( + NoAwaitTag, + google::cloud::cpp::compute::region_health_sources::v1:: + InsertHealthSourceRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief InsertHealthSource + /// + /// This method accepts a `google::cloud::cpp::compute::v1::Operation` that corresponds + /// to a previously started Long Running Operation (LRO) and polls the status + /// of the LRO in the background. + /// + // clang-format on + future> + InsertHealthSource( + google::cloud::cpp::compute::v1::Operation const& operation, + Options opts = {}); + + // clang-format off + /// + /// Lists the HealthSources for a project in the given region. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionHealthSources/list + /// + /// @param project Project ID for this request. + /// @param region Name of the region scoping this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return a [StreamRange](@ref google::cloud::StreamRange) + /// to iterate of the results. See the documentation of this type for + /// details. In brief, this class has `begin()` and `end()` member + /// functions returning a iterator class meeting the + /// [input iterator requirements]. The value type for this iterator is a + /// [`StatusOr`] as the iteration may fail even after some values are + /// retrieved successfully, for example, if there is a network disconnect. + /// An empty set of results does not indicate an error, it indicates + /// that there are no resources meeting the request criteria. + /// On a successful iteration the `StatusOr` contains elements of type + /// [google.cloud.cpp.compute.v1.HealthSource], or rather, + /// the C++ class generated by Protobuf from that type. Please consult the + /// Protobuf documentation for details on the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_health_sources.v1.ListRegionHealthSourcesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_sources/v1/region_health_sources.proto#L359} + /// [google.cloud.cpp.compute.v1.HealthSource]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_064.proto#L29} + /// + // clang-format on + StreamRange + ListRegionHealthSources(std::string const& project, std::string const& region, + Options opts = {}); + + // clang-format off + /// + /// Lists the HealthSources for a project in the given region. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionHealthSources/list + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.region_health_sources.v1.ListRegionHealthSourcesRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return a [StreamRange](@ref google::cloud::StreamRange) + /// to iterate of the results. See the documentation of this type for + /// details. In brief, this class has `begin()` and `end()` member + /// functions returning a iterator class meeting the + /// [input iterator requirements]. The value type for this iterator is a + /// [`StatusOr`] as the iteration may fail even after some values are + /// retrieved successfully, for example, if there is a network disconnect. + /// An empty set of results does not indicate an error, it indicates + /// that there are no resources meeting the request criteria. + /// On a successful iteration the `StatusOr` contains elements of type + /// [google.cloud.cpp.compute.v1.HealthSource], or rather, + /// the C++ class generated by Protobuf from that type. Please consult the + /// Protobuf documentation for details on the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_health_sources.v1.ListRegionHealthSourcesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_sources/v1/region_health_sources.proto#L359} + /// [google.cloud.cpp.compute.v1.HealthSource]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_064.proto#L29} + /// + // clang-format on + StreamRange + ListRegionHealthSources(google::cloud::cpp::compute::region_health_sources:: + v1::ListRegionHealthSourcesRequest request, + Options opts = {}); + + // clang-format off + /// + /// Updates the specified regional HealthSource resource + /// with the data included in the request. This method supportsPATCH + /// semantics and uses theJSON merge + /// patch format and processing rules. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionHealthSources/patch + /// + /// @param project Project ID for this request. + /// @param region Name of the region scoping this request. + /// @param health_source Name of the HealthSource to update. The name + /// must be 1-63 characters long, and comply with RFC1035. + /// @param health_source_resource The HealthSource for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_health_sources.v1.PatchHealthSourceRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_sources/v1/region_health_sources.proto#L464} + /// + // clang-format on + future> + PatchHealthSource(std::string const& project, std::string const& region, + std::string const& health_source, + google::cloud::cpp::compute::v1::HealthSource const& + health_source_resource, + Options opts = {}); + + // clang-format off + /// + /// @copybrief PatchHealthSource + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr PatchHealthSource( + NoAwaitTag, std::string const& project, std::string const& region, + std::string const& health_source, + google::cloud::cpp::compute::v1::HealthSource const& + health_source_resource, + Options opts = {}); + + // clang-format off + /// + /// Updates the specified regional HealthSource resource + /// with the data included in the request. This method supportsPATCH + /// semantics and uses theJSON merge + /// patch format and processing rules. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionHealthSources/patch + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.region_health_sources.v1.PatchHealthSourceRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_health_sources.v1.PatchHealthSourceRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_sources/v1/region_health_sources.proto#L464} + /// + // clang-format on + future> + PatchHealthSource(google::cloud::cpp::compute::region_health_sources::v1:: + PatchHealthSourceRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief PatchHealthSource + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr PatchHealthSource( + NoAwaitTag, + google::cloud::cpp::compute::region_health_sources::v1:: + PatchHealthSourceRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief PatchHealthSource + /// + /// This method accepts a `google::cloud::cpp::compute::v1::Operation` that corresponds + /// to a previously started Long Running Operation (LRO) and polls the status + /// of the LRO in the background. + /// + // clang-format on + future> + PatchHealthSource(google::cloud::cpp::compute::v1::Operation const& operation, + Options opts = {}); + + // clang-format off + /// + /// Returns permissions that a caller has on the specified resource. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionHealthSources/testIamPermissions + /// + /// @param project Project ID for this request. + /// @param region The name of the region for this request. + /// @param resource Name or id of the resource for this request. + /// @param test_permissions_request_resource The TestPermissionsRequest for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.TestPermissionsResponse]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_health_sources.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_sources/v1/region_health_sources.proto#L505} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} + /// + // clang-format on + StatusOr + TestIamPermissions( + std::string const& project, std::string const& region, + std::string const& resource, + google::cloud::cpp::compute::v1::TestPermissionsRequest const& + test_permissions_request_resource, + Options opts = {}); + + // clang-format off + /// + /// Returns permissions that a caller has on the specified resource. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionHealthSources/testIamPermissions + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.region_health_sources.v1.TestIamPermissionsRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.TestPermissionsResponse]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_health_sources.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_sources/v1/region_health_sources.proto#L505} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} + /// + // clang-format on + StatusOr + TestIamPermissions(google::cloud::cpp::compute::region_health_sources::v1:: + TestIamPermissionsRequest const& request, + Options opts = {}); + + private: + std::shared_ptr connection_; + Options options_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_health_sources_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_SOURCES_V1_REGION_HEALTH_SOURCES_CLIENT_H diff --git a/google/cloud/compute/region_health_sources/v1/region_health_sources_connection.cc b/google/cloud/compute/region_health_sources/v1/region_health_sources_connection.cc new file mode 100644 index 0000000000000..a4d7b114bbca9 --- /dev/null +++ b/google/cloud/compute/region_health_sources/v1/region_health_sources_connection.cc @@ -0,0 +1,157 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_health_sources/v1/region_health_sources.proto + +#include "google/cloud/compute/region_health_sources/v1/region_health_sources_connection.h" +#include "google/cloud/compute/region_health_sources/v1/internal/region_health_sources_option_defaults.h" +#include "google/cloud/compute/region_health_sources/v1/internal/region_health_sources_tracing_connection.h" +#include "google/cloud/compute/region_health_sources/v1/region_health_sources_options.h" +#include "google/cloud/background_threads.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/grpc_options.h" +#include "google/cloud/internal/pagination_range.h" +#include "google/cloud/internal/unified_grpc_credentials.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_health_sources_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +RegionHealthSourcesConnection::~RegionHealthSourcesConnection() = default; + +StreamRange> +RegionHealthSourcesConnection::AggregatedListRegionHealthSources( + google::cloud::cpp::compute::region_health_sources::v1:: + AggregatedListRegionHealthSourcesRequest) { // NOLINT(performance-unnecessary-value-param) + return google::cloud::internal::MakeUnimplementedPaginationRange>>(); +} + +future> +RegionHealthSourcesConnection::DeleteHealthSource( + google::cloud::cpp::compute::region_health_sources::v1:: + DeleteHealthSourceRequest const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +RegionHealthSourcesConnection::DeleteHealthSource( + NoAwaitTag, google::cloud::cpp::compute::region_health_sources::v1:: + DeleteHealthSourceRequest const&) { + return StatusOr( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +RegionHealthSourcesConnection::DeleteHealthSource( + google::cloud::cpp::compute::v1::Operation const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +RegionHealthSourcesConnection::GetHealthSource( + google::cloud::cpp::compute::region_health_sources::v1:: + GetHealthSourceRequest const&) { + return Status(StatusCode::kUnimplemented, "not implemented"); +} + +StatusOr +RegionHealthSourcesConnection::GetHealth( + google::cloud::cpp::compute::region_health_sources::v1:: + GetHealthRequest const&) { + return Status(StatusCode::kUnimplemented, "not implemented"); +} + +future> +RegionHealthSourcesConnection::InsertHealthSource( + google::cloud::cpp::compute::region_health_sources::v1:: + InsertHealthSourceRequest const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +RegionHealthSourcesConnection::InsertHealthSource( + NoAwaitTag, google::cloud::cpp::compute::region_health_sources::v1:: + InsertHealthSourceRequest const&) { + return StatusOr( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +RegionHealthSourcesConnection::InsertHealthSource( + google::cloud::cpp::compute::v1::Operation const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StreamRange +RegionHealthSourcesConnection::ListRegionHealthSources( + google::cloud::cpp::compute::region_health_sources::v1:: + ListRegionHealthSourcesRequest) { // NOLINT(performance-unnecessary-value-param) + return google::cloud::internal::MakeUnimplementedPaginationRange< + StreamRange>(); +} + +future> +RegionHealthSourcesConnection::PatchHealthSource( + google::cloud::cpp::compute::region_health_sources::v1:: + PatchHealthSourceRequest const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +RegionHealthSourcesConnection::PatchHealthSource( + NoAwaitTag, google::cloud::cpp::compute::region_health_sources::v1:: + PatchHealthSourceRequest const&) { + return StatusOr( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +RegionHealthSourcesConnection::PatchHealthSource( + google::cloud::cpp::compute::v1::Operation const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +RegionHealthSourcesConnection::TestIamPermissions( + google::cloud::cpp::compute::region_health_sources::v1:: + TestIamPermissionsRequest const&) { + return Status(StatusCode::kUnimplemented, "not implemented"); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_health_sources_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_health_sources/v1/region_health_sources_connection.h b/google/cloud/compute/region_health_sources/v1/region_health_sources_connection.h new file mode 100644 index 0000000000000..c1a7428d55217 --- /dev/null +++ b/google/cloud/compute/region_health_sources/v1/region_health_sources_connection.h @@ -0,0 +1,260 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_health_sources/v1/region_health_sources.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_SOURCES_V1_REGION_HEALTH_SOURCES_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_SOURCES_V1_REGION_HEALTH_SOURCES_CONNECTION_H + +#include "google/cloud/compute/region_health_sources/v1/internal/region_health_sources_retry_traits.h" +#include "google/cloud/compute/region_health_sources/v1/region_health_sources.pb.h" +#include "google/cloud/compute/region_health_sources/v1/region_health_sources_connection_idempotency_policy.h" +#include "google/cloud/backoff_policy.h" +#include "google/cloud/future.h" +#include "google/cloud/internal/retry_policy_impl.h" +#include "google/cloud/no_await_tag.h" +#include "google/cloud/options.h" +#include "google/cloud/polling_policy.h" +#include "google/cloud/status_or.h" +#include "google/cloud/stream_range.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_health_sources_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/// The retry policy for `RegionHealthSourcesConnection`. +class RegionHealthSourcesRetryPolicy : public ::google::cloud::RetryPolicy { + public: + /// Creates a new instance of the policy, reset to the initial state. + virtual std::unique_ptr clone() const = 0; +}; + +/** + * A retry policy for `RegionHealthSourcesConnection` based on counting errors. + * + * This policy stops retrying if: + * - An RPC returns a non-transient error. + * - More than a prescribed number of transient failures is detected. + * + * In this class the following status codes are treated as transient errors: + * - [`kUnavailable`](@ref google::cloud::StatusCode) + */ +class RegionHealthSourcesLimitedErrorCountRetryPolicy + : public RegionHealthSourcesRetryPolicy { + public: + /** + * Create an instance that tolerates up to @p maximum_failures transient + * errors. + * + * @note Disable the retry loop by providing an instance of this policy with + * @p maximum_failures == 0. + */ + explicit RegionHealthSourcesLimitedErrorCountRetryPolicy(int maximum_failures) + : impl_(maximum_failures) {} + + RegionHealthSourcesLimitedErrorCountRetryPolicy( + RegionHealthSourcesLimitedErrorCountRetryPolicy&& rhs) noexcept + : RegionHealthSourcesLimitedErrorCountRetryPolicy( + rhs.maximum_failures()) {} + RegionHealthSourcesLimitedErrorCountRetryPolicy( + RegionHealthSourcesLimitedErrorCountRetryPolicy const& rhs) noexcept + : RegionHealthSourcesLimitedErrorCountRetryPolicy( + rhs.maximum_failures()) {} + + int maximum_failures() const { return impl_.maximum_failures(); } + + bool OnFailure(Status const& status) override { + return impl_.OnFailure(status); + } + bool IsExhausted() const override { return impl_.IsExhausted(); } + bool IsPermanentFailure(Status const& status) const override { + return impl_.IsPermanentFailure(status); + } + std::unique_ptr clone() const override { + return std::make_unique( + maximum_failures()); + } + + // This is provided only for backwards compatibility. + using BaseType = RegionHealthSourcesRetryPolicy; + + private: + google::cloud::internal::LimitedErrorCountRetryPolicy< + compute_region_health_sources_v1_internal::RegionHealthSourcesRetryTraits> + impl_; +}; + +/** + * A retry policy for `RegionHealthSourcesConnection` based on elapsed time. + * + * This policy stops retrying if: + * - An RPC returns a non-transient error. + * - The elapsed time in the retry loop exceeds a prescribed duration. + * + * In this class the following status codes are treated as transient errors: + * - [`kUnavailable`](@ref google::cloud::StatusCode) + */ +class RegionHealthSourcesLimitedTimeRetryPolicy + : public RegionHealthSourcesRetryPolicy { + public: + /** + * Constructor given a `std::chrono::duration<>` object. + * + * @tparam DurationRep a placeholder to match the `Rep` tparam for @p + * duration's type. The semantics of this template parameter are + * documented in `std::chrono::duration<>`. In brief, the underlying + * arithmetic type used to store the number of ticks. For our purposes it + * is simply a formal parameter. + * @tparam DurationPeriod a placeholder to match the `Period` tparam for @p + * duration's type. The semantics of this template parameter are + * documented in `std::chrono::duration<>`. In brief, the length of the + * tick in seconds, expressed as a `std::ratio<>`. For our purposes it is + * simply a formal parameter. + * @param maximum_duration the maximum time allowed before the policy expires. + * While the application can express this time in any units they desire, + * the class truncates to milliseconds. + * + * @see https://en.cppreference.com/w/cpp/chrono/duration for more information + * about `std::chrono::duration`. + */ + template + explicit RegionHealthSourcesLimitedTimeRetryPolicy( + std::chrono::duration maximum_duration) + : impl_(maximum_duration) {} + + RegionHealthSourcesLimitedTimeRetryPolicy( + RegionHealthSourcesLimitedTimeRetryPolicy&& rhs) noexcept + : RegionHealthSourcesLimitedTimeRetryPolicy(rhs.maximum_duration()) {} + RegionHealthSourcesLimitedTimeRetryPolicy( + RegionHealthSourcesLimitedTimeRetryPolicy const& rhs) noexcept + : RegionHealthSourcesLimitedTimeRetryPolicy(rhs.maximum_duration()) {} + + std::chrono::milliseconds maximum_duration() const { + return impl_.maximum_duration(); + } + + bool OnFailure(Status const& status) override { + return impl_.OnFailure(status); + } + bool IsExhausted() const override { return impl_.IsExhausted(); } + bool IsPermanentFailure(Status const& status) const override { + return impl_.IsPermanentFailure(status); + } + std::unique_ptr clone() const override { + return std::make_unique( + maximum_duration()); + } + + // This is provided only for backwards compatibility. + using BaseType = RegionHealthSourcesRetryPolicy; + + private: + google::cloud::internal::LimitedTimeRetryPolicy< + compute_region_health_sources_v1_internal::RegionHealthSourcesRetryTraits> + impl_; +}; + +/** + * The `RegionHealthSourcesConnection` object for `RegionHealthSourcesClient`. + * + * This interface defines virtual methods for each of the user-facing overload + * sets in `RegionHealthSourcesClient`. This allows users to inject custom + * behavior (e.g., with a Google Mock object) when writing tests that use + * objects of type `RegionHealthSourcesClient`. + * + * To create a concrete instance, see `MakeRegionHealthSourcesConnection()`. + * + * For mocking, see + * `compute_region_health_sources_v1_mocks::MockRegionHealthSourcesConnection`. + */ +class RegionHealthSourcesConnection { + public: + virtual ~RegionHealthSourcesConnection() = 0; + + virtual Options options() { return Options{}; } + + virtual StreamRange> + AggregatedListRegionHealthSources( + google::cloud::cpp::compute::region_health_sources::v1:: + AggregatedListRegionHealthSourcesRequest request); + + virtual future> + DeleteHealthSource(google::cloud::cpp::compute::region_health_sources::v1:: + DeleteHealthSourceRequest const& request); + + virtual StatusOr + DeleteHealthSource(NoAwaitTag, + google::cloud::cpp::compute::region_health_sources::v1:: + DeleteHealthSourceRequest const& request); + + virtual future> + DeleteHealthSource( + google::cloud::cpp::compute::v1::Operation const& operation); + + virtual StatusOr + GetHealthSource(google::cloud::cpp::compute::region_health_sources::v1:: + GetHealthSourceRequest const& request); + + virtual StatusOr + GetHealth(google::cloud::cpp::compute::region_health_sources::v1:: + GetHealthRequest const& request); + + virtual future> + InsertHealthSource(google::cloud::cpp::compute::region_health_sources::v1:: + InsertHealthSourceRequest const& request); + + virtual StatusOr + InsertHealthSource(NoAwaitTag, + google::cloud::cpp::compute::region_health_sources::v1:: + InsertHealthSourceRequest const& request); + + virtual future> + InsertHealthSource( + google::cloud::cpp::compute::v1::Operation const& operation); + + virtual StreamRange + ListRegionHealthSources(google::cloud::cpp::compute::region_health_sources:: + v1::ListRegionHealthSourcesRequest request); + + virtual future> + PatchHealthSource(google::cloud::cpp::compute::region_health_sources::v1:: + PatchHealthSourceRequest const& request); + + virtual StatusOr + PatchHealthSource(NoAwaitTag, + google::cloud::cpp::compute::region_health_sources::v1:: + PatchHealthSourceRequest const& request); + + virtual future> + PatchHealthSource( + google::cloud::cpp::compute::v1::Operation const& operation); + + virtual StatusOr + TestIamPermissions(google::cloud::cpp::compute::region_health_sources::v1:: + TestIamPermissionsRequest const& request); +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_health_sources_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_SOURCES_V1_REGION_HEALTH_SOURCES_CONNECTION_H diff --git a/google/cloud/compute/region_health_sources/v1/region_health_sources_connection_idempotency_policy.cc b/google/cloud/compute/region_health_sources/v1/region_health_sources_connection_idempotency_policy.cc new file mode 100644 index 0000000000000..07257d2805d92 --- /dev/null +++ b/google/cloud/compute/region_health_sources/v1/region_health_sources_connection_idempotency_policy.cc @@ -0,0 +1,97 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_health_sources/v1/region_health_sources.proto + +#include "google/cloud/compute/region_health_sources/v1/region_health_sources_connection_idempotency_policy.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_health_sources_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +using ::google::cloud::Idempotency; + +RegionHealthSourcesConnectionIdempotencyPolicy:: + ~RegionHealthSourcesConnectionIdempotencyPolicy() = default; + +std::unique_ptr +RegionHealthSourcesConnectionIdempotencyPolicy::clone() const { + return std::make_unique( + *this); +} + +Idempotency RegionHealthSourcesConnectionIdempotencyPolicy:: + AggregatedListRegionHealthSources( + google::cloud::cpp::compute::region_health_sources::v1:: + AggregatedListRegionHealthSourcesRequest) { // NOLINT + return Idempotency::kIdempotent; +} + +Idempotency RegionHealthSourcesConnectionIdempotencyPolicy::DeleteHealthSource( + google::cloud::cpp::compute::region_health_sources::v1:: + DeleteHealthSourceRequest const&) { + return Idempotency::kNonIdempotent; +} + +Idempotency RegionHealthSourcesConnectionIdempotencyPolicy::GetHealthSource( + google::cloud::cpp::compute::region_health_sources::v1:: + GetHealthSourceRequest const&) { + return Idempotency::kIdempotent; +} + +Idempotency RegionHealthSourcesConnectionIdempotencyPolicy::GetHealth( + google::cloud::cpp::compute::region_health_sources::v1:: + GetHealthRequest const&) { + return Idempotency::kIdempotent; +} + +Idempotency RegionHealthSourcesConnectionIdempotencyPolicy::InsertHealthSource( + google::cloud::cpp::compute::region_health_sources::v1:: + InsertHealthSourceRequest const&) { + return Idempotency::kNonIdempotent; +} + +Idempotency +RegionHealthSourcesConnectionIdempotencyPolicy::ListRegionHealthSources( + google::cloud::cpp::compute::region_health_sources::v1:: + ListRegionHealthSourcesRequest) { // NOLINT + return Idempotency::kIdempotent; +} + +Idempotency RegionHealthSourcesConnectionIdempotencyPolicy::PatchHealthSource( + google::cloud::cpp::compute::region_health_sources::v1:: + PatchHealthSourceRequest const&) { + return Idempotency::kNonIdempotent; +} + +Idempotency RegionHealthSourcesConnectionIdempotencyPolicy::TestIamPermissions( + google::cloud::cpp::compute::region_health_sources::v1:: + TestIamPermissionsRequest const&) { + return Idempotency::kNonIdempotent; +} + +std::unique_ptr +MakeDefaultRegionHealthSourcesConnectionIdempotencyPolicy() { + return std::make_unique(); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_health_sources_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_health_sources/v1/region_health_sources_connection_idempotency_policy.h b/google/cloud/compute/region_health_sources/v1/region_health_sources_connection_idempotency_policy.h new file mode 100644 index 0000000000000..ce6363a032aed --- /dev/null +++ b/google/cloud/compute/region_health_sources/v1/region_health_sources_connection_idempotency_policy.h @@ -0,0 +1,82 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_health_sources/v1/region_health_sources.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_SOURCES_V1_REGION_HEALTH_SOURCES_CONNECTION_IDEMPOTENCY_POLICY_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_SOURCES_V1_REGION_HEALTH_SOURCES_CONNECTION_IDEMPOTENCY_POLICY_H + +#include "google/cloud/compute/region_health_sources/v1/region_health_sources.pb.h" +#include "google/cloud/idempotency.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_health_sources_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class RegionHealthSourcesConnectionIdempotencyPolicy { + public: + virtual ~RegionHealthSourcesConnectionIdempotencyPolicy(); + + /// Create a new copy of this object. + virtual std::unique_ptr + clone() const; + + virtual google::cloud::Idempotency AggregatedListRegionHealthSources( + google::cloud::cpp::compute::region_health_sources::v1:: + AggregatedListRegionHealthSourcesRequest request); + + virtual google::cloud::Idempotency DeleteHealthSource( + google::cloud::cpp::compute::region_health_sources::v1:: + DeleteHealthSourceRequest const& request); + + virtual google::cloud::Idempotency GetHealthSource( + google::cloud::cpp::compute::region_health_sources::v1:: + GetHealthSourceRequest const& request); + + virtual google::cloud::Idempotency GetHealth( + google::cloud::cpp::compute::region_health_sources::v1:: + GetHealthRequest const& request); + + virtual google::cloud::Idempotency InsertHealthSource( + google::cloud::cpp::compute::region_health_sources::v1:: + InsertHealthSourceRequest const& request); + + virtual google::cloud::Idempotency ListRegionHealthSources( + google::cloud::cpp::compute::region_health_sources::v1:: + ListRegionHealthSourcesRequest request); + + virtual google::cloud::Idempotency PatchHealthSource( + google::cloud::cpp::compute::region_health_sources::v1:: + PatchHealthSourceRequest const& request); + + virtual google::cloud::Idempotency TestIamPermissions( + google::cloud::cpp::compute::region_health_sources::v1:: + TestIamPermissionsRequest const& request); +}; + +std::unique_ptr +MakeDefaultRegionHealthSourcesConnectionIdempotencyPolicy(); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_health_sources_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_SOURCES_V1_REGION_HEALTH_SOURCES_CONNECTION_IDEMPOTENCY_POLICY_H diff --git a/google/cloud/compute/region_health_sources/v1/region_health_sources_options.h b/google/cloud/compute/region_health_sources/v1/region_health_sources_options.h new file mode 100644 index 0000000000000..c42422a250079 --- /dev/null +++ b/google/cloud/compute/region_health_sources/v1/region_health_sources_options.h @@ -0,0 +1,88 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_health_sources/v1/region_health_sources.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_SOURCES_V1_REGION_HEALTH_SOURCES_OPTIONS_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_SOURCES_V1_REGION_HEALTH_SOURCES_OPTIONS_H + +#include "google/cloud/compute/region_health_sources/v1/region_health_sources_connection.h" +#include "google/cloud/compute/region_health_sources/v1/region_health_sources_connection_idempotency_policy.h" +#include "google/cloud/backoff_policy.h" +#include "google/cloud/options.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_health_sources_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/** + * Use with `google::cloud::Options` to configure the retry policy. + * + * @ingroup google-cloud-compute-options + */ +struct RegionHealthSourcesRetryPolicyOption { + using Type = std::shared_ptr; +}; + +/** + * Use with `google::cloud::Options` to configure the backoff policy. + * + * @ingroup google-cloud-compute-options + */ +struct RegionHealthSourcesBackoffPolicyOption { + using Type = std::shared_ptr; +}; + +/** + * Use with `google::cloud::Options` to configure which operations are retried. + * + * @ingroup google-cloud-compute-options + */ +struct RegionHealthSourcesConnectionIdempotencyPolicyOption { + using Type = std::shared_ptr; +}; + +/** + * Use with `google::cloud::Options` to configure the long-running operations + * polling policy. + * + * @ingroup google-cloud-compute-options + */ +struct RegionHealthSourcesPollingPolicyOption { + using Type = std::shared_ptr; +}; + +/** + * The options applicable to RegionHealthSources. + * + * @ingroup google-cloud-compute-options + */ +using RegionHealthSourcesPolicyOptionList = + OptionList; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_health_sources_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_SOURCES_V1_REGION_HEALTH_SOURCES_OPTIONS_H diff --git a/google/cloud/compute/region_health_sources/v1/region_health_sources_proto_export.h b/google/cloud/compute/region_health_sources/v1/region_health_sources_proto_export.h new file mode 100644 index 0000000000000..1264ac09a18ab --- /dev/null +++ b/google/cloud/compute/region_health_sources/v1/region_health_sources_proto_export.h @@ -0,0 +1,34 @@ +// Copyright 2026 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_REGION_HEALTH_SOURCES_V1_REGION_HEALTH_SOURCES_PROTO_EXPORT_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_SOURCES_V1_REGION_HEALTH_SOURCES_PROTO_EXPORT_H + +// IWYU pragma: begin_exports +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_064.pb.h" +#include "google/cloud/compute/v1/internal/common_171.pb.h" +// IWYU pragma: end_exports + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_SOURCES_V1_REGION_HEALTH_SOURCES_PROTO_EXPORT_H diff --git a/google/cloud/compute/region_health_sources/v1/region_health_sources_rest_connection.cc b/google/cloud/compute/region_health_sources/v1/region_health_sources_rest_connection.cc new file mode 100644 index 0000000000000..9e13115343052 --- /dev/null +++ b/google/cloud/compute/region_health_sources/v1/region_health_sources_rest_connection.cc @@ -0,0 +1,61 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_health_sources/v1/region_health_sources.proto + +#include "google/cloud/compute/region_health_sources/v1/region_health_sources_rest_connection.h" +#include "google/cloud/compute/region_health_sources/v1/internal/region_health_sources_option_defaults.h" +#include "google/cloud/compute/region_health_sources/v1/internal/region_health_sources_rest_connection_impl.h" +#include "google/cloud/compute/region_health_sources/v1/internal/region_health_sources_rest_stub_factory.h" +#include "google/cloud/compute/region_health_sources/v1/internal/region_health_sources_tracing_connection.h" +#include "google/cloud/compute/region_health_sources/v1/region_health_sources_options.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/internal/rest_background_threads_impl.h" +#include "google/cloud/internal/rest_options.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_health_sources_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +std::shared_ptr +MakeRegionHealthSourcesConnectionRest(Options options) { + internal::CheckExpectedOptions(options, + __func__); + options = compute_region_health_sources_v1_internal:: + RegionHealthSourcesDefaultOptions(std::move(options)); + auto background = std::make_unique< + rest_internal::AutomaticallyCreatedRestBackgroundThreads>(); + auto stub = compute_region_health_sources_v1_internal:: + CreateDefaultRegionHealthSourcesRestStub(options); + return compute_region_health_sources_v1_internal:: + MakeRegionHealthSourcesTracingConnection( + std::make_shared( + std::move(background), std::move(stub), std::move(options))); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_health_sources_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_health_sources/v1/region_health_sources_rest_connection.h b/google/cloud/compute/region_health_sources/v1/region_health_sources_rest_connection.h new file mode 100644 index 0000000000000..4637bf63bb587 --- /dev/null +++ b/google/cloud/compute/region_health_sources/v1/region_health_sources_rest_connection.h @@ -0,0 +1,67 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_health_sources/v1/region_health_sources.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_SOURCES_V1_REGION_HEALTH_SOURCES_REST_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_SOURCES_V1_REGION_HEALTH_SOURCES_REST_CONNECTION_H + +#include "google/cloud/compute/region_health_sources/v1/region_health_sources_connection.h" +#include "google/cloud/options.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_health_sources_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/** + * A factory function to construct an object of type + * `RegionHealthSourcesConnection` that uses REST over HTTP as transport in lieu + * of gRPC. REST transport should only be used for services that do not support + * gRPC or if the existing network configuration precludes using gRPC. + * + * The returned connection object should not be used directly; instead it + * should be passed as an argument to the constructor of + * RegionHealthSourcesClient. + * + * The optional @p options argument may be used to configure aspects of the + * returned `RegionHealthSourcesConnection`. Expected options are any of the + * types in the following option lists: + * + * - `google::cloud::CommonOptionList` + * - `google::cloud::RestOptionList` + * - `google::cloud::UnifiedCredentialsOptionList` + * - + * `google::cloud::compute_region_health_sources_v1::RegionHealthSourcesPolicyOptionList` + * + * @note Unexpected options will be ignored. To log unexpected options instead, + * set `GOOGLE_CLOUD_CPP_ENABLE_CLOG=yes` in the environment. + * + * @param options (optional) Configure the `RegionHealthSourcesConnection` + * created by this function. + */ +std::shared_ptr +MakeRegionHealthSourcesConnectionRest(Options options = {}); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_health_sources_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_SOURCES_V1_REGION_HEALTH_SOURCES_REST_CONNECTION_H diff --git a/google/cloud/compute/region_health_sources/v1/samples/region_health_sources_client_samples.cc b/google/cloud/compute/region_health_sources/v1/samples/region_health_sources_client_samples.cc new file mode 100644 index 0000000000000..93a68ad74d7c9 --- /dev/null +++ b/google/cloud/compute/region_health_sources/v1/samples/region_health_sources_client_samples.cc @@ -0,0 +1,243 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_health_sources/v1/region_health_sources.proto + +#include "google/cloud/compute/region_health_sources/v1/region_health_sources_client.h" +#include "google/cloud/compute/region_health_sources/v1/region_health_sources_connection_idempotency_policy.h" +#include "google/cloud/compute/region_health_sources/v1/region_health_sources_options.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/internal/getenv.h" +#include "google/cloud/polling_policy.h" +#include "google/cloud/testing_util/example_driver.h" +#include "google/cloud/universe_domain.h" +#include +#include +#include +#include + +// clang-format off +// main-dox-marker: compute_region_health_sources_v1::RegionHealthSourcesClient +// lro-marker: true +// clang-format on +namespace { + +void SetClientEndpoint(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-endpoint"}; + } + //! [set-client-endpoint] + // This configuration is common with Private Google Access: + // https://cloud.google.com/vpc/docs/private-google-access + auto options = google::cloud::Options{}.set( + "private.googleapis.com"); + auto vpc_client = google::cloud::compute_region_health_sources_v1:: + RegionHealthSourcesClient( + google::cloud::compute_region_health_sources_v1:: + MakeRegionHealthSourcesConnectionRest(options)); + //! [set-client-endpoint] +} + +void SetClientUniverseDomain(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-universe-domain"}; + } + //! [set-client-universe-domain] + google::cloud::Options options; + + // AddUniverseDomainOption interrogates the UnifiedCredentialsOption, if set, + // in the provided Options for the Universe Domain associated with the + // credentials and adds it to the set of Options. + // If no UnifiedCredentialsOption is set, GoogleDefaultCredentials are used. + auto ud_options = google::cloud::AddUniverseDomainOption(std::move(options)); + + if (!ud_options.ok()) throw std::move(ud_options).status(); + auto ud_client = google::cloud::compute_region_health_sources_v1:: + RegionHealthSourcesClient( + google::cloud::compute_region_health_sources_v1:: + MakeRegionHealthSourcesConnectionRest(*ud_options)); + //! [set-client-universe-domain] +} + +//! [custom-idempotency-policy] +class CustomIdempotencyPolicy + : public google::cloud::compute_region_health_sources_v1:: + RegionHealthSourcesConnectionIdempotencyPolicy { + public: + ~CustomIdempotencyPolicy() override = default; + std::unique_ptr + clone() const override { + return std::make_unique(*this); + } + // Override inherited functions to define as needed. +}; +//! [custom-idempotency-policy] + +void SetRetryPolicy(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-retry-policy"}; + } + //! [set-retry-policy] + auto options = + google::cloud::Options{} + .set( + CustomIdempotencyPolicy().clone()) + .set( + google::cloud::compute_region_health_sources_v1:: + RegionHealthSourcesLimitedErrorCountRetryPolicy(3) + .clone()) + .set( + google::cloud::ExponentialBackoffPolicy( + /*initial_delay=*/std::chrono::milliseconds(200), + /*maximum_delay=*/std::chrono::seconds(45), + /*scaling=*/2.0) + .clone()); + auto connection = google::cloud::compute_region_health_sources_v1:: + MakeRegionHealthSourcesConnectionRest(options); + + // c1 and c2 share the same retry policies + auto c1 = google::cloud::compute_region_health_sources_v1:: + RegionHealthSourcesClient(connection); + auto c2 = google::cloud::compute_region_health_sources_v1:: + RegionHealthSourcesClient(connection); + + // You can override any of the policies in a new client. This new client + // will share the policies from c1 (or c2) *except* for the retry policy. + auto c3 = google::cloud::compute_region_health_sources_v1:: + RegionHealthSourcesClient( + connection, google::cloud::Options{} + .set( + google::cloud::compute_region_health_sources_v1:: + RegionHealthSourcesLimitedTimeRetryPolicy( + std::chrono::minutes(5)) + .clone())); + + // You can also override the policies in a single call: + // c3.SomeRpc(..., google::cloud::Options{} + // .set( + // google::cloud::compute_region_health_sources_v1::RegionHealthSourcesLimitedErrorCountRetryPolicy(10).clone())); + //! [set-retry-policy] +} + +void SetPollingPolicy(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-policy-policy"}; + } + //! [set-polling-policy] + + // The polling policy controls how the client waits for long-running + // operations. `GenericPollingPolicy<>` combines existing policies. + // In this case, keep polling until the operation completes (with success + // or error) or 45 minutes, whichever happens first. Initially pause for + // 10 seconds between polling requests, increasing the pause by a factor + // of 4 until it becomes 2 minutes. + auto options = + google::cloud::Options{} + .set( + google::cloud::GenericPollingPolicy< + google::cloud::compute_region_health_sources_v1:: + RegionHealthSourcesRetryPolicyOption::Type, + google::cloud::compute_region_health_sources_v1:: + RegionHealthSourcesBackoffPolicyOption::Type>( + google::cloud::compute_region_health_sources_v1:: + RegionHealthSourcesLimitedTimeRetryPolicy( + /*maximum_duration=*/std::chrono::minutes(45)) + .clone(), + google::cloud::ExponentialBackoffPolicy( + /*initial_delay=*/std::chrono::seconds(10), + /*maximum_delay=*/std::chrono::minutes(2), + /*scaling=*/4.0) + .clone()) + .clone()); + + auto connection = google::cloud::compute_region_health_sources_v1:: + MakeRegionHealthSourcesConnectionRest(options); + + // c1 and c2 share the same polling policies. + auto c1 = google::cloud::compute_region_health_sources_v1:: + RegionHealthSourcesClient(connection); + auto c2 = google::cloud::compute_region_health_sources_v1:: + RegionHealthSourcesClient(connection); + //! [set-polling-policy] +} + +void WithServiceAccount(std::vector const& argv) { + if (argv.size() != 1 || argv[0] == "--help") { + throw google::cloud::testing_util::Usage{"with-service-account "}; + } + //! [with-service-account] + [](std::string const& keyfile) { + auto is = std::ifstream(keyfile); + is.exceptions(std::ios::badbit); // Minimal error handling in examples + auto contents = std::string(std::istreambuf_iterator(is.rdbuf()), {}); + auto options = + google::cloud::Options{}.set( + google::cloud::MakeServiceAccountCredentials(contents)); + return google::cloud::compute_region_health_sources_v1:: + RegionHealthSourcesClient( + google::cloud::compute_region_health_sources_v1:: + MakeRegionHealthSourcesConnectionRest(options)); + } + //! [with-service-account] + (argv.at(0)); +} + +void AutoRun(std::vector const& argv) { + namespace examples = ::google::cloud::testing_util; + using ::google::cloud::internal::GetEnv; + if (!argv.empty()) throw examples::Usage{"auto"}; + examples::CheckEnvironmentVariablesAreSet( + {"GOOGLE_CLOUD_CPP_TEST_SERVICE_ACCOUNT_KEYFILE"}); + auto const keyfile = + GetEnv("GOOGLE_CLOUD_CPP_TEST_SERVICE_ACCOUNT_KEYFILE").value(); + + std::cout << "\nRunning SetClientEndpoint() example" << std::endl; + SetClientEndpoint({}); + + std::cout << "\nRunning SetRetryPolicy() example" << std::endl; + SetRetryPolicy({}); + + std::cout << "\nRunning SetPollingPolicy() example" << std::endl; + SetPollingPolicy({}); + + std::cout << "\nRunning WithServiceAccount() example" << std::endl; + WithServiceAccount({keyfile}); + + std::cout << "\nRunning SetClientUniverseDomain() example" << std::endl; + SetClientUniverseDomain({}); +} + +} // namespace + +int main(int argc, char* argv[]) { // NOLINT(bugprone-exception-escape) + google::cloud::testing_util::Example example({ + {"set-client-endpoint", SetClientEndpoint}, + {"set-retry-policy", SetRetryPolicy}, + {"set-polling-policy", SetPollingPolicy}, + {"with-service-account", WithServiceAccount}, + {"set-client-universe-domain", SetClientUniverseDomain}, + {"auto", AutoRun}, + }); + return example.Run(argc, argv); +} diff --git a/google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_option_defaults.cc b/google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_option_defaults.cc new file mode 100644 index 0000000000000..72ee7ef10acc1 --- /dev/null +++ b/google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_option_defaults.cc @@ -0,0 +1,107 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests.proto + +#include "google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_option_defaults.h" +#include "google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests_connection.h" +#include "google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests_options.h" +#include "google/cloud/internal/populate_common_options.h" +#include "google/cloud/internal/populate_grpc_options.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_instance_group_manager_resize_requests_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +namespace { +auto constexpr kBackoffScaling = 2.0; +} // namespace + +Options RegionInstanceGroupManagerResizeRequestsDefaultOptions( + Options options) { + options = internal::PopulateCommonOptions( + std::move(options), + "GOOGLE_CLOUD_CPP_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_ENDPOINT", + "", + "GOOGLE_CLOUD_CPP_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_" + "AUTHORITY", + "compute.googleapis.com"); + options = internal::PopulateGrpcOptions(std::move(options)); + if (!options.has< + compute_region_instance_group_manager_resize_requests_v1:: + RegionInstanceGroupManagerResizeRequestsRetryPolicyOption>()) { + options.set( + compute_region_instance_group_manager_resize_requests_v1:: + RegionInstanceGroupManagerResizeRequestsLimitedTimeRetryPolicy( + std::chrono::minutes(10)) + .clone()); + } + if (!options.has< + compute_region_instance_group_manager_resize_requests_v1:: + RegionInstanceGroupManagerResizeRequestsBackoffPolicyOption>()) { + options + .set( + ExponentialBackoffPolicy( + std::chrono::seconds(0), std::chrono::seconds(1), + std::chrono::minutes(5), kBackoffScaling, kBackoffScaling) + .clone()); + } + if (!options.has< + compute_region_instance_group_manager_resize_requests_v1:: + RegionInstanceGroupManagerResizeRequestsPollingPolicyOption>()) { + options.set< + compute_region_instance_group_manager_resize_requests_v1:: + RegionInstanceGroupManagerResizeRequestsPollingPolicyOption>( + GenericPollingPolicy< + compute_region_instance_group_manager_resize_requests_v1:: + RegionInstanceGroupManagerResizeRequestsRetryPolicyOption::Type, + compute_region_instance_group_manager_resize_requests_v1:: + RegionInstanceGroupManagerResizeRequestsBackoffPolicyOption:: + Type>( + options + .get< + compute_region_instance_group_manager_resize_requests_v1:: + RegionInstanceGroupManagerResizeRequestsRetryPolicyOption>() + ->clone(), + ExponentialBackoffPolicy(std::chrono::seconds(1), + std::chrono::minutes(5), kBackoffScaling) + .clone()) + .clone()); + } + if (!options.has< + compute_region_instance_group_manager_resize_requests_v1:: + RegionInstanceGroupManagerResizeRequestsConnectionIdempotencyPolicyOption>()) { + options.set< + compute_region_instance_group_manager_resize_requests_v1:: + RegionInstanceGroupManagerResizeRequestsConnectionIdempotencyPolicyOption>( + compute_region_instance_group_manager_resize_requests_v1:: + MakeDefaultRegionInstanceGroupManagerResizeRequestsConnectionIdempotencyPolicy()); + } + + return options; +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace + // compute_region_instance_group_manager_resize_requests_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_option_defaults.h b/google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_option_defaults.h new file mode 100644 index 0000000000000..e61680a4a3bec --- /dev/null +++ b/google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_option_defaults.h @@ -0,0 +1,39 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_V1_INTERNAL_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_OPTION_DEFAULTS_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_V1_INTERNAL_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_OPTION_DEFAULTS_H + +#include "google/cloud/options.h" +#include "google/cloud/version.h" + +namespace google { +namespace cloud { +namespace compute_region_instance_group_manager_resize_requests_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +Options RegionInstanceGroupManagerResizeRequestsDefaultOptions(Options options); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace + // compute_region_instance_group_manager_resize_requests_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_V1_INTERNAL_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_OPTION_DEFAULTS_H diff --git a/google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_rest_connection_impl.cc b/google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_rest_connection_impl.cc new file mode 100644 index 0000000000000..4a1f1b94c8396 --- /dev/null +++ b/google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_rest_connection_impl.cc @@ -0,0 +1,553 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests.proto + +#include "google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_rest_connection_impl.h" +#include "google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_rest_stub_factory.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/internal/async_rest_long_running_operation_custom.h" +#include "google/cloud/internal/extract_long_running_result.h" +#include "google/cloud/internal/pagination_range.h" +#include "google/cloud/internal/rest_lro_helpers.h" +#include "google/cloud/internal/rest_retry_loop.h" +#include "google/cloud/rest_options.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_instance_group_manager_resize_requests_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +RegionInstanceGroupManagerResizeRequestsRestConnectionImpl:: + RegionInstanceGroupManagerResizeRequestsRestConnectionImpl( + std::unique_ptr background, + std::shared_ptr< + compute_region_instance_group_manager_resize_requests_v1_internal:: + RegionInstanceGroupManagerResizeRequestsRestStub> + stub, + Options options) + : background_(std::move(background)), + stub_(std::move(stub)), + options_(internal::MergeOptions( + std::move(options), + RegionInstanceGroupManagerResizeRequestsConnection::options())) {} + +future> +RegionInstanceGroupManagerResizeRequestsRestConnectionImpl::Cancel( + google::cloud::cpp::compute::region_instance_group_manager_resize_requests:: + v1::CancelRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::region_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, request, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + CancelRequest const& request) { + return stub->AsyncCancel(cq, std::move(context), std::move(options), + request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->Cancel(request), polling_policy(*current), + __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [request](std::string const& op, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest& r) { + r.set_project(request.project()); + r.set_region(request.region()); + r.set_operation(op); + }, + [request](std::string const& op, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest& r) { + r.set_project(request.project()); + r.set_region(request.region()); + r.set_operation(op); + }); +} + +StatusOr +RegionInstanceGroupManagerResizeRequestsRestConnectionImpl::Cancel( + NoAwaitTag, + google::cloud::cpp::compute::region_instance_group_manager_resize_requests:: + v1::CancelRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->Cancel(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + CancelRequest const& request) { + return stub_->Cancel(rest_context, options, request); + }, + *current, request, __func__); +} + +future> +RegionInstanceGroupManagerResizeRequestsRestConnectionImpl::Cancel( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestAwaitLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::region_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, operation, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [operation](std::string const&, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_region(info.region); + r.set_operation(info.operation); + }, + [operation](std::string const&, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_region(info.region); + r.set_operation(info.operation); + }); +} + +future> +RegionInstanceGroupManagerResizeRequestsRestConnectionImpl:: + DeleteInstanceGroupManagerResizeRequest( + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + DeleteInstanceGroupManagerResizeRequestRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::region_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, request, + [stub = stub_]( + CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + DeleteInstanceGroupManagerResizeRequestRequest const& + request) { + return stub->AsyncDeleteInstanceGroupManagerResizeRequest( + cq, std::move(context), std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->DeleteInstanceGroupManagerResizeRequest( + request), + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [request](std::string const& op, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest& r) { + r.set_project(request.project()); + r.set_region(request.region()); + r.set_operation(op); + }, + [request](std::string const& op, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest& r) { + r.set_project(request.project()); + r.set_region(request.region()); + r.set_operation(op); + }); +} + +StatusOr +RegionInstanceGroupManagerResizeRequestsRestConnectionImpl:: + DeleteInstanceGroupManagerResizeRequest( + NoAwaitTag, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + DeleteInstanceGroupManagerResizeRequestRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->DeleteInstanceGroupManagerResizeRequest( + request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + DeleteInstanceGroupManagerResizeRequestRequest const& + request) { + return stub_->DeleteInstanceGroupManagerResizeRequest(rest_context, + options, request); + }, + *current, request, __func__); +} + +future> +RegionInstanceGroupManagerResizeRequestsRestConnectionImpl:: + DeleteInstanceGroupManagerResizeRequest( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestAwaitLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::region_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, operation, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [operation](std::string const&, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_region(info.region); + r.set_operation(info.operation); + }, + [operation](std::string const&, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_region(info.region); + r.set_operation(info.operation); + }); +} + +StatusOr +RegionInstanceGroupManagerResizeRequestsRestConnectionImpl:: + GetInstanceGroupManagerResizeRequest( + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + GetInstanceGroupManagerResizeRequestRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->GetInstanceGroupManagerResizeRequest( + request), + [this]( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + GetInstanceGroupManagerResizeRequestRequest const& request) { + return stub_->GetInstanceGroupManagerResizeRequest(rest_context, + options, request); + }, + *current, request, __func__); +} + +future> +RegionInstanceGroupManagerResizeRequestsRestConnectionImpl:: + InsertInstanceGroupManagerResizeRequest( + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + InsertInstanceGroupManagerResizeRequestRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::region_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, request, + [stub = stub_]( + CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + InsertInstanceGroupManagerResizeRequestRequest const& + request) { + return stub->AsyncInsertInstanceGroupManagerResizeRequest( + cq, std::move(context), std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->InsertInstanceGroupManagerResizeRequest( + request), + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [request](std::string const& op, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest& r) { + r.set_project(request.project()); + r.set_region(request.region()); + r.set_operation(op); + }, + [request](std::string const& op, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest& r) { + r.set_project(request.project()); + r.set_region(request.region()); + r.set_operation(op); + }); +} + +StatusOr +RegionInstanceGroupManagerResizeRequestsRestConnectionImpl:: + InsertInstanceGroupManagerResizeRequest( + NoAwaitTag, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + InsertInstanceGroupManagerResizeRequestRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->InsertInstanceGroupManagerResizeRequest( + request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + InsertInstanceGroupManagerResizeRequestRequest const& + request) { + return stub_->InsertInstanceGroupManagerResizeRequest(rest_context, + options, request); + }, + *current, request, __func__); +} + +future> +RegionInstanceGroupManagerResizeRequestsRestConnectionImpl:: + InsertInstanceGroupManagerResizeRequest( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestAwaitLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::region_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, operation, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [operation](std::string const&, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_region(info.region); + r.set_operation(info.operation); + }, + [operation](std::string const&, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_region(info.region); + r.set_operation(info.operation); + }); +} + +StreamRange +RegionInstanceGroupManagerResizeRequestsRestConnectionImpl:: + ListRegionInstanceGroupManagerResizeRequests( + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + ListRegionInstanceGroupManagerResizeRequestsRequest request) { + request.clear_page_token(); + auto current = google::cloud::internal::SaveCurrentOptions(); + auto idempotency = + idempotency_policy(*current) + ->ListRegionInstanceGroupManagerResizeRequests(request); + char const* function_name = __func__; + return google::cloud::internal::MakePaginationRange>( + current, std::move(request), + [idempotency, function_name, stub = stub_, + retry = std::shared_ptr< + compute_region_instance_group_manager_resize_requests_v1:: + RegionInstanceGroupManagerResizeRequestsRetryPolicy>( + retry_policy(*current)), + backoff = std::shared_ptr(backoff_policy(*current))]( + Options const& options, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + ListRegionInstanceGroupManagerResizeRequestsRequest const& + r) { + return google::cloud::rest_internal::RestRetryLoop( + retry->clone(), backoff->clone(), idempotency, + [stub]( + rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + ListRegionInstanceGroupManagerResizeRequestsRequest const& + request) { + return stub->ListRegionInstanceGroupManagerResizeRequests( + rest_context, options, request); + }, + options, r, function_name); + }, + [](google::cloud::cpp::compute::v1:: + RegionInstanceGroupManagerResizeRequestsListResponse r) { + std::vector< + google::cloud::cpp::compute::v1::InstanceGroupManagerResizeRequest> + result(r.items().size()); + auto& messages = *r.mutable_items(); + std::move(messages.begin(), messages.end(), result.begin()); + return result; + }); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace + // compute_region_instance_group_manager_resize_requests_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_rest_connection_impl.h b/google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_rest_connection_impl.h new file mode 100644 index 0000000000000..f9cfb934e063d --- /dev/null +++ b/google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_rest_connection_impl.h @@ -0,0 +1,175 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_V1_INTERNAL_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_REST_CONNECTION_IMPL_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_V1_INTERNAL_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_REST_CONNECTION_IMPL_H + +#include "google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_rest_stub.h" +#include "google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_retry_traits.h" +#include "google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests_connection.h" +#include "google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests_connection_idempotency_policy.h" +#include "google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests_options.h" +#include "google/cloud/compute/region_operations/v1/region_operations.pb.h" +#include "google/cloud/background_threads.h" +#include "google/cloud/backoff_policy.h" +#include "google/cloud/options.h" +#include "google/cloud/status_or.h" +#include "google/cloud/stream_range.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_instance_group_manager_resize_requests_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class RegionInstanceGroupManagerResizeRequestsRestConnectionImpl + : public compute_region_instance_group_manager_resize_requests_v1:: + RegionInstanceGroupManagerResizeRequestsConnection { + public: + ~RegionInstanceGroupManagerResizeRequestsRestConnectionImpl() override = + default; + + RegionInstanceGroupManagerResizeRequestsRestConnectionImpl( + std::unique_ptr background, + std::shared_ptr< + compute_region_instance_group_manager_resize_requests_v1_internal:: + RegionInstanceGroupManagerResizeRequestsRestStub> + stub, + Options options); + + Options options() override { return options_; } + + future> Cancel( + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + CancelRequest const& request) override; + + StatusOr Cancel( + NoAwaitTag, google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + CancelRequest const& request) override; + + future> Cancel( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + future> + DeleteInstanceGroupManagerResizeRequest( + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + DeleteInstanceGroupManagerResizeRequestRequest const& request) + override; + + StatusOr + DeleteInstanceGroupManagerResizeRequest( + NoAwaitTag, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + DeleteInstanceGroupManagerResizeRequestRequest const& request) + override; + + future> + DeleteInstanceGroupManagerResizeRequest( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + StatusOr + GetInstanceGroupManagerResizeRequest( + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + GetInstanceGroupManagerResizeRequestRequest const& request) + override; + + future> + InsertInstanceGroupManagerResizeRequest( + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + InsertInstanceGroupManagerResizeRequestRequest const& request) + override; + + StatusOr + InsertInstanceGroupManagerResizeRequest( + NoAwaitTag, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + InsertInstanceGroupManagerResizeRequestRequest const& request) + override; + + future> + InsertInstanceGroupManagerResizeRequest( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + StreamRange< + google::cloud::cpp::compute::v1::InstanceGroupManagerResizeRequest> + ListRegionInstanceGroupManagerResizeRequests( + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + ListRegionInstanceGroupManagerResizeRequestsRequest request) + override; + + private: + static std::unique_ptr< + compute_region_instance_group_manager_resize_requests_v1:: + RegionInstanceGroupManagerResizeRequestsRetryPolicy> + retry_policy(Options const& options) { + return options + .get() + ->clone(); + } + + static std::unique_ptr backoff_policy(Options const& options) { + return options + .get() + ->clone(); + } + + static std::unique_ptr< + compute_region_instance_group_manager_resize_requests_v1:: + RegionInstanceGroupManagerResizeRequestsConnectionIdempotencyPolicy> + idempotency_policy(Options const& options) { + return options + .get< + compute_region_instance_group_manager_resize_requests_v1:: + RegionInstanceGroupManagerResizeRequestsConnectionIdempotencyPolicyOption>() + ->clone(); + } + + static std::unique_ptr polling_policy(Options const& options) { + return options + .get() + ->clone(); + } + + std::unique_ptr background_; + std::shared_ptr< + compute_region_instance_group_manager_resize_requests_v1_internal:: + RegionInstanceGroupManagerResizeRequestsRestStub> + stub_; + Options options_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace + // compute_region_instance_group_manager_resize_requests_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_V1_INTERNAL_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_REST_CONNECTION_IMPL_H diff --git a/google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_rest_logging_decorator.cc b/google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_rest_logging_decorator.cc new file mode 100644 index 0000000000000..fa4078cdc3b4d --- /dev/null +++ b/google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_rest_logging_decorator.cc @@ -0,0 +1,245 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests.proto + +#include "google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_rest_logging_decorator.h" +#include "google/cloud/internal/log_wrapper.h" +#include "google/cloud/status_or.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_instance_group_manager_resize_requests_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +RegionInstanceGroupManagerResizeRequestsRestLogging:: + RegionInstanceGroupManagerResizeRequestsRestLogging( + std::shared_ptr child, + TracingOptions tracing_options, std::set components) + : child_(std::move(child)), + tracing_options_(std::move(tracing_options)), + components_(std::move(components)) {} + +future> +RegionInstanceGroupManagerResizeRequestsRestLogging::AsyncCancel( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_instance_group_manager_resize_requests:: + v1::CancelRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + CancelRequest const& request) { + return child_->AsyncCancel(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +StatusOr +RegionInstanceGroupManagerResizeRequestsRestLogging::Cancel( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_instance_group_manager_resize_requests:: + v1::CancelRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + CancelRequest const& request) { + return child_->Cancel(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +future> +RegionInstanceGroupManagerResizeRequestsRestLogging:: + AsyncDeleteInstanceGroupManagerResizeRequest( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + DeleteInstanceGroupManagerResizeRequestRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + DeleteInstanceGroupManagerResizeRequestRequest const& + request) { + return child_->AsyncDeleteInstanceGroupManagerResizeRequest( + cq, std::move(rest_context), std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +StatusOr +RegionInstanceGroupManagerResizeRequestsRestLogging:: + DeleteInstanceGroupManagerResizeRequest( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + DeleteInstanceGroupManagerResizeRequestRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + DeleteInstanceGroupManagerResizeRequestRequest const& + request) { + return child_->DeleteInstanceGroupManagerResizeRequest( + rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +StatusOr +RegionInstanceGroupManagerResizeRequestsRestLogging:: + GetInstanceGroupManagerResizeRequest( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + GetInstanceGroupManagerResizeRequestRequest const& request) { + return google::cloud::internal::LogWrapper( + [this]( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + GetInstanceGroupManagerResizeRequestRequest const& request) { + return child_->GetInstanceGroupManagerResizeRequest(rest_context, + options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +future> +RegionInstanceGroupManagerResizeRequestsRestLogging:: + AsyncInsertInstanceGroupManagerResizeRequest( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + InsertInstanceGroupManagerResizeRequestRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + InsertInstanceGroupManagerResizeRequestRequest const& + request) { + return child_->AsyncInsertInstanceGroupManagerResizeRequest( + cq, std::move(rest_context), std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +StatusOr +RegionInstanceGroupManagerResizeRequestsRestLogging:: + InsertInstanceGroupManagerResizeRequest( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + InsertInstanceGroupManagerResizeRequestRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + InsertInstanceGroupManagerResizeRequestRequest const& + request) { + return child_->InsertInstanceGroupManagerResizeRequest( + rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +StatusOr +RegionInstanceGroupManagerResizeRequestsRestLogging:: + ListRegionInstanceGroupManagerResizeRequests( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + ListRegionInstanceGroupManagerResizeRequestsRequest const& + request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + ListRegionInstanceGroupManagerResizeRequestsRequest const& + request) { + return child_->ListRegionInstanceGroupManagerResizeRequests( + rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +future> +RegionInstanceGroupManagerResizeRequestsRestLogging::AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + return child_->AsyncGetOperation(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +future +RegionInstanceGroupManagerResizeRequestsRestLogging::AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + return child_->AsyncCancelOperation(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace + // compute_region_instance_group_manager_resize_requests_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_rest_logging_decorator.h b/google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_rest_logging_decorator.h new file mode 100644 index 0000000000000..3adbddb890ed4 --- /dev/null +++ b/google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_rest_logging_decorator.h @@ -0,0 +1,146 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_V1_INTERNAL_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_REST_LOGGING_DECORATOR_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_V1_INTERNAL_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_REST_LOGGING_DECORATOR_H + +#include "google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_rest_stub.h" +#include "google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests.pb.h" +#include "google/cloud/compute/region_operations/v1/region_operations.pb.h" +#include "google/cloud/future.h" +#include "google/cloud/internal/rest_context.h" +#include "google/cloud/tracing_options.h" +#include "google/cloud/version.h" +#include +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_instance_group_manager_resize_requests_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class RegionInstanceGroupManagerResizeRequestsRestLogging + : public RegionInstanceGroupManagerResizeRequestsRestStub { + public: + ~RegionInstanceGroupManagerResizeRequestsRestLogging() override = default; + RegionInstanceGroupManagerResizeRequestsRestLogging( + std::shared_ptr child, + TracingOptions tracing_options, std::set components); + + future> AsyncCancel( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + CancelRequest const& request) override; + + StatusOr Cancel( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + CancelRequest const& request) override; + + future> + AsyncDeleteInstanceGroupManagerResizeRequest( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + DeleteInstanceGroupManagerResizeRequestRequest const& request) + override; + + StatusOr + DeleteInstanceGroupManagerResizeRequest( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + DeleteInstanceGroupManagerResizeRequestRequest const& request) + override; + + StatusOr + GetInstanceGroupManagerResizeRequest( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + GetInstanceGroupManagerResizeRequestRequest const& request) + override; + + future> + AsyncInsertInstanceGroupManagerResizeRequest( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + InsertInstanceGroupManagerResizeRequestRequest const& request) + override; + + StatusOr + InsertInstanceGroupManagerResizeRequest( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + InsertInstanceGroupManagerResizeRequestRequest const& request) + override; + + StatusOr + ListRegionInstanceGroupManagerResizeRequests( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + ListRegionInstanceGroupManagerResizeRequestsRequest const& + request) override; + + future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) override; + + future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) override; + + private: + std::shared_ptr child_; + TracingOptions tracing_options_; + std::set components_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace + // compute_region_instance_group_manager_resize_requests_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_V1_INTERNAL_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_REST_LOGGING_DECORATOR_H diff --git a/google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_rest_metadata_decorator.cc b/google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_rest_metadata_decorator.cc new file mode 100644 index 0000000000000..02fd93c0ba153 --- /dev/null +++ b/google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_rest_metadata_decorator.cc @@ -0,0 +1,178 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests.proto + +#include "google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_rest_metadata_decorator.h" +#include "google/cloud/internal/api_client_header.h" +#include "google/cloud/internal/rest_set_metadata.h" +#include "google/cloud/status_or.h" +#include "absl/strings/str_cat.h" +#include "absl/strings/str_format.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_instance_group_manager_resize_requests_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +RegionInstanceGroupManagerResizeRequestsRestMetadata:: + RegionInstanceGroupManagerResizeRequestsRestMetadata( + std::shared_ptr child, + std::string api_client_header) + : child_(std::move(child)), + api_client_header_( + api_client_header.empty() + ? google::cloud::internal::GeneratedLibClientHeader() + : std::move(api_client_header)) {} + +future> +RegionInstanceGroupManagerResizeRequestsRestMetadata::AsyncCancel( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_instance_group_manager_resize_requests:: + v1::CancelRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncCancel(cq, std::move(rest_context), std::move(options), + request); +} + +StatusOr +RegionInstanceGroupManagerResizeRequestsRestMetadata::Cancel( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_instance_group_manager_resize_requests:: + v1::CancelRequest const& request) { + SetMetadata(rest_context, options); + return child_->Cancel(rest_context, options, request); +} + +future> +RegionInstanceGroupManagerResizeRequestsRestMetadata:: + AsyncDeleteInstanceGroupManagerResizeRequest( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + DeleteInstanceGroupManagerResizeRequestRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncDeleteInstanceGroupManagerResizeRequest( + cq, std::move(rest_context), std::move(options), request); +} + +StatusOr +RegionInstanceGroupManagerResizeRequestsRestMetadata:: + DeleteInstanceGroupManagerResizeRequest( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + DeleteInstanceGroupManagerResizeRequestRequest const& request) { + SetMetadata(rest_context, options); + return child_->DeleteInstanceGroupManagerResizeRequest(rest_context, options, + request); +} + +StatusOr +RegionInstanceGroupManagerResizeRequestsRestMetadata:: + GetInstanceGroupManagerResizeRequest( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + GetInstanceGroupManagerResizeRequestRequest const& request) { + SetMetadata(rest_context, options); + return child_->GetInstanceGroupManagerResizeRequest(rest_context, options, + request); +} + +future> +RegionInstanceGroupManagerResizeRequestsRestMetadata:: + AsyncInsertInstanceGroupManagerResizeRequest( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + InsertInstanceGroupManagerResizeRequestRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncInsertInstanceGroupManagerResizeRequest( + cq, std::move(rest_context), std::move(options), request); +} + +StatusOr +RegionInstanceGroupManagerResizeRequestsRestMetadata:: + InsertInstanceGroupManagerResizeRequest( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + InsertInstanceGroupManagerResizeRequestRequest const& request) { + SetMetadata(rest_context, options); + return child_->InsertInstanceGroupManagerResizeRequest(rest_context, options, + request); +} + +StatusOr +RegionInstanceGroupManagerResizeRequestsRestMetadata:: + ListRegionInstanceGroupManagerResizeRequests( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + ListRegionInstanceGroupManagerResizeRequestsRequest const& + request) { + SetMetadata(rest_context, options); + return child_->ListRegionInstanceGroupManagerResizeRequests(rest_context, + options, request); +} + +future> +RegionInstanceGroupManagerResizeRequestsRestMetadata::AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncGetOperation(cq, std::move(rest_context), + std::move(options), request); +} + +future +RegionInstanceGroupManagerResizeRequestsRestMetadata::AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncCancelOperation(cq, std::move(rest_context), + std::move(options), request); +} + +void RegionInstanceGroupManagerResizeRequestsRestMetadata::SetMetadata( + rest_internal::RestContext& rest_context, Options const& options, + std::vector const& params) { + google::cloud::rest_internal::SetMetadata(rest_context, options, params, + api_client_header_); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace + // compute_region_instance_group_manager_resize_requests_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_rest_metadata_decorator.h b/google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_rest_metadata_decorator.h new file mode 100644 index 0000000000000..e72575c9af5e5 --- /dev/null +++ b/google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_rest_metadata_decorator.h @@ -0,0 +1,148 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_V1_INTERNAL_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_REST_METADATA_DECORATOR_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_V1_INTERNAL_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_REST_METADATA_DECORATOR_H + +#include "google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_rest_stub.h" +#include "google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests.pb.h" +#include "google/cloud/compute/region_operations/v1/region_operations.pb.h" +#include "google/cloud/future.h" +#include "google/cloud/rest_options.h" +#include "google/cloud/version.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_instance_group_manager_resize_requests_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class RegionInstanceGroupManagerResizeRequestsRestMetadata + : public RegionInstanceGroupManagerResizeRequestsRestStub { + public: + ~RegionInstanceGroupManagerResizeRequestsRestMetadata() override = default; + explicit RegionInstanceGroupManagerResizeRequestsRestMetadata( + std::shared_ptr child, + std::string api_client_header = ""); + + google::cloud::future> + AsyncCancel( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + CancelRequest const& request) override; + + StatusOr Cancel( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + CancelRequest const& request) override; + + google::cloud::future> + AsyncDeleteInstanceGroupManagerResizeRequest( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + DeleteInstanceGroupManagerResizeRequestRequest const& request) + override; + + StatusOr + DeleteInstanceGroupManagerResizeRequest( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + DeleteInstanceGroupManagerResizeRequestRequest const& request) + override; + + StatusOr + GetInstanceGroupManagerResizeRequest( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + GetInstanceGroupManagerResizeRequestRequest const& request) + override; + + google::cloud::future> + AsyncInsertInstanceGroupManagerResizeRequest( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + InsertInstanceGroupManagerResizeRequestRequest const& request) + override; + + StatusOr + InsertInstanceGroupManagerResizeRequest( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + InsertInstanceGroupManagerResizeRequestRequest const& request) + override; + + StatusOr + ListRegionInstanceGroupManagerResizeRequests( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + ListRegionInstanceGroupManagerResizeRequestsRequest const& + request) override; + + google::cloud::future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) override; + + google::cloud::future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) override; + + private: + void SetMetadata(rest_internal::RestContext& rest_context, + Options const& options, + std::vector const& params = {}); + + std::shared_ptr child_; + std::string api_client_header_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace + // compute_region_instance_group_manager_resize_requests_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_V1_INTERNAL_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_REST_METADATA_DECORATOR_H diff --git a/google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_rest_stub.cc b/google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_rest_stub.cc new file mode 100644 index 0000000000000..97eac6f971d3f --- /dev/null +++ b/google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_rest_stub.cc @@ -0,0 +1,353 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests.proto + +#include "google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_rest_stub.h" +#include "google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests.pb.h" +#include "google/cloud/compute/region_operations/v1/region_operations.pb.h" +#include "google/cloud/common_options.h" +#include "google/cloud/internal/rest_stub_helpers.h" +#include "google/cloud/status_or.h" +#include "absl/strings/str_cat.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_instance_group_manager_resize_requests_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +DefaultRegionInstanceGroupManagerResizeRequestsRestStub:: + DefaultRegionInstanceGroupManagerResizeRequestsRestStub(Options options) + : service_(rest_internal::MakePooledRestClient( + options.get(), options)), + operations_(rest_internal::MakePooledRestClient( + options.get(), options)), + options_(std::move(options)) {} + +DefaultRegionInstanceGroupManagerResizeRequestsRestStub:: + DefaultRegionInstanceGroupManagerResizeRequestsRestStub( + std::shared_ptr service, + std::shared_ptr operations, Options options) + : service_(std::move(service)), + operations_(std::move(operations)), + options_(std::move(options)) {} + +future> +DefaultRegionInstanceGroupManagerResizeRequestsRestStub::AsyncCancel( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_instance_group_manager_resize_requests:: + v1::CancelRequest const& request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto service, auto request, auto rest_context, auto options) { + std::vector> query_params; + p.set_value( + rest_internal::Post( + *service, *rest_context, request, false, + absl::StrCat( + "/", "compute", "/", + rest_internal::DetermineApiVersion("v1", *options), "/", + "projects", "/", request.project(), "/", "regions", "/", + request.region(), "/", "instanceGroupManagers", "/", + request.instance_group_manager(), "/", "resizeRequests", + "/", request.resize_request(), "/", "cancel"), + std::move(query_params))); + }, + std::move(p), + service_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +StatusOr +DefaultRegionInstanceGroupManagerResizeRequestsRestStub::Cancel( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_instance_group_manager_resize_requests:: + v1::CancelRequest const& request) { + std::vector> query_params; + return rest_internal::Post( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "regions", "/", + request.region(), "/", "instanceGroupManagers", "/", + request.instance_group_manager(), "/", "resizeRequests", "/", + request.resize_request(), "/", "cancel"), + std::move(query_params)); +} + +future> +DefaultRegionInstanceGroupManagerResizeRequestsRestStub:: + AsyncDeleteInstanceGroupManagerResizeRequest( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + DeleteInstanceGroupManagerResizeRequestRequest const& request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto service, auto request, auto rest_context, auto options) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + p.set_value( + rest_internal::Delete( + *service, *rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", *options), + "/", "projects", "/", request.project(), "/", + "regions", "/", request.region(), "/", + "instanceGroupManagers", "/", + request.instance_group_manager(), "/", + "resizeRequests", "/", request.resize_request()), + std::move(query_params))); + }, + std::move(p), + service_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +StatusOr +DefaultRegionInstanceGroupManagerResizeRequestsRestStub:: + DeleteInstanceGroupManagerResizeRequest( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + DeleteInstanceGroupManagerResizeRequestRequest const& request) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Delete( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "regions", "/", + request.region(), "/", "instanceGroupManagers", "/", + request.instance_group_manager(), "/", "resizeRequests", "/", + request.resize_request()), + std::move(query_params)); +} + +StatusOr +DefaultRegionInstanceGroupManagerResizeRequestsRestStub:: + GetInstanceGroupManagerResizeRequest( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + GetInstanceGroupManagerResizeRequestRequest const& request) { + std::vector> query_params; + return rest_internal::Get< + google::cloud::cpp::compute::v1::InstanceGroupManagerResizeRequest>( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "regions", "/", + request.region(), "/", "instanceGroupManagers", "/", + request.instance_group_manager(), "/", "resizeRequests", "/", + request.resize_request()), + std::move(query_params)); +} + +future> +DefaultRegionInstanceGroupManagerResizeRequestsRestStub:: + AsyncInsertInstanceGroupManagerResizeRequest( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + InsertInstanceGroupManagerResizeRequestRequest const& request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto service, auto request, auto rest_context, auto options) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + p.set_value( + rest_internal::Post( + *service, *rest_context, + request.instance_group_manager_resize_request_resource(), false, + absl::StrCat( + "/", "compute", "/", + rest_internal::DetermineApiVersion("v1", *options), "/", + "projects", "/", request.project(), "/", "regions", "/", + request.region(), "/", "instanceGroupManagers", "/", + request.instance_group_manager(), "/", "resizeRequests"), + std::move(query_params))); + }, + std::move(p), + service_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +StatusOr +DefaultRegionInstanceGroupManagerResizeRequestsRestStub:: + InsertInstanceGroupManagerResizeRequest( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + InsertInstanceGroupManagerResizeRequestRequest const& request) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Post( + *service_, rest_context, + request.instance_group_manager_resize_request_resource(), false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "regions", "/", + request.region(), "/", "instanceGroupManagers", "/", + request.instance_group_manager(), "/", "resizeRequests"), + std::move(query_params)); +} + +StatusOr +DefaultRegionInstanceGroupManagerResizeRequestsRestStub:: + ListRegionInstanceGroupManagerResizeRequests( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + ListRegionInstanceGroupManagerResizeRequestsRequest const& + request) { + std::vector> query_params; + query_params.push_back({"filter", request.filter()}); + query_params.push_back( + {"max_results", std::to_string(request.max_results())}); + query_params.push_back({"order_by", request.order_by()}); + query_params.push_back({"page_token", request.page_token()}); + query_params.push_back({"return_partial_success", + (request.return_partial_success() ? "1" : "0")}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Get< + google::cloud::cpp::compute::v1:: + RegionInstanceGroupManagerResizeRequestsListResponse>( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "regions", "/", + request.region(), "/", "instanceGroupManagers", "/", + request.instance_group_manager(), "/", "resizeRequests"), + std::move(query_params)); +} + +future> +DefaultRegionInstanceGroupManagerResizeRequestsRestStub::AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto operations, auto request, auto rest_context, + auto options) { + p.set_value( + rest_internal::Get( + *operations, *rest_context, request, false, + absl::StrCat("/compute/", + rest_internal::DetermineApiVersion("v1", *options), + "/projects/", request.project(), "/regions/", + request.region(), "/operations/", + request.operation()))); + }, + std::move(p), + operations_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +future +DefaultRegionInstanceGroupManagerResizeRequestsRestStub::AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + promise> p; + future> f = p.get_future(); + std::thread t{ + [](auto p, auto operations, auto request, auto rest_context, + auto options) { + p.set_value(rest_internal::Post( + *operations, *rest_context, request, false, + absl::StrCat( + "/compute/", rest_internal::DetermineApiVersion("v1", *options), + "/projects/", request.project(), "/regions/", request.region(), + "/operations/", request.operation()))); + }, + std::move(p), + operations_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get().status(); + }); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace + // compute_region_instance_group_manager_resize_requests_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_rest_stub.h b/google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_rest_stub.h new file mode 100644 index 0000000000000..3cca995505695 --- /dev/null +++ b/google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_rest_stub.h @@ -0,0 +1,240 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_V1_INTERNAL_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_REST_STUB_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_V1_INTERNAL_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_REST_STUB_H + +#include "google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests.pb.h" +#include "google/cloud/compute/region_operations/v1/region_operations.pb.h" +#include "google/cloud/completion_queue.h" +#include "google/cloud/internal/rest_client.h" +#include "google/cloud/internal/rest_context.h" +#include "google/cloud/status_or.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_instance_group_manager_resize_requests_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class RegionInstanceGroupManagerResizeRequestsRestStub { + public: + virtual ~RegionInstanceGroupManagerResizeRequestsRestStub() = default; + + virtual future> + AsyncCancel( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + CancelRequest const& request) = 0; + + virtual StatusOr Cancel( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + CancelRequest const& request) = 0; + + virtual future> + AsyncDeleteInstanceGroupManagerResizeRequest( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + DeleteInstanceGroupManagerResizeRequestRequest const& + request) = 0; + + virtual StatusOr + DeleteInstanceGroupManagerResizeRequest( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + DeleteInstanceGroupManagerResizeRequestRequest const& + request) = 0; + + virtual StatusOr< + google::cloud::cpp::compute::v1::InstanceGroupManagerResizeRequest> + GetInstanceGroupManagerResizeRequest( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + GetInstanceGroupManagerResizeRequestRequest const& request) = 0; + + virtual future> + AsyncInsertInstanceGroupManagerResizeRequest( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + InsertInstanceGroupManagerResizeRequestRequest const& + request) = 0; + + virtual StatusOr + InsertInstanceGroupManagerResizeRequest( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + InsertInstanceGroupManagerResizeRequestRequest const& + request) = 0; + + virtual StatusOr + ListRegionInstanceGroupManagerResizeRequests( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + ListRegionInstanceGroupManagerResizeRequestsRequest const& + request) = 0; + + virtual future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) = 0; + + virtual future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) = 0; +}; + +class DefaultRegionInstanceGroupManagerResizeRequestsRestStub + : public RegionInstanceGroupManagerResizeRequestsRestStub { + public: + ~DefaultRegionInstanceGroupManagerResizeRequestsRestStub() override = default; + + explicit DefaultRegionInstanceGroupManagerResizeRequestsRestStub( + Options options); + DefaultRegionInstanceGroupManagerResizeRequestsRestStub( + std::shared_ptr service, + std::shared_ptr operations, Options options); + + future> AsyncCancel( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + CancelRequest const& request) override; + + StatusOr Cancel( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + CancelRequest const& request) override; + + future> + AsyncDeleteInstanceGroupManagerResizeRequest( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + DeleteInstanceGroupManagerResizeRequestRequest const& request) + override; + + StatusOr + DeleteInstanceGroupManagerResizeRequest( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + DeleteInstanceGroupManagerResizeRequestRequest const& request) + override; + + StatusOr + GetInstanceGroupManagerResizeRequest( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + GetInstanceGroupManagerResizeRequestRequest const& request) + override; + + future> + AsyncInsertInstanceGroupManagerResizeRequest( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + InsertInstanceGroupManagerResizeRequestRequest const& request) + override; + + StatusOr + InsertInstanceGroupManagerResizeRequest( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + InsertInstanceGroupManagerResizeRequestRequest const& request) + override; + + StatusOr + ListRegionInstanceGroupManagerResizeRequests( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + ListRegionInstanceGroupManagerResizeRequestsRequest const& + request) override; + + future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) override; + + future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) override; + + private: + std::shared_ptr service_; + std::shared_ptr operations_; + Options options_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace + // compute_region_instance_group_manager_resize_requests_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_V1_INTERNAL_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_REST_STUB_H diff --git a/google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_rest_stub_factory.cc b/google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_rest_stub_factory.cc new file mode 100644 index 0000000000000..704ec3dd59fb4 --- /dev/null +++ b/google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_rest_stub_factory.cc @@ -0,0 +1,62 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests.proto + +#include "google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_rest_stub_factory.h" +#include "google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_rest_logging_decorator.h" +#include "google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_rest_metadata_decorator.h" +#include "google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_rest_stub.h" +#include "google/cloud/common_options.h" +#include "google/cloud/internal/algorithm.h" +#include "google/cloud/internal/populate_rest_options.h" +#include "google/cloud/log.h" +#include "google/cloud/options.h" +#include "google/cloud/rest_options.h" +#include "absl/strings/match.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_instance_group_manager_resize_requests_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +std::shared_ptr +CreateDefaultRegionInstanceGroupManagerResizeRequestsRestStub( + Options const& options) { + auto opts = internal::PopulateRestOptions(options); + std::shared_ptr stub = + std::make_shared( + std::move(opts)); + stub = std::make_shared( + std::move(stub)); + if (internal::Contains(options.get(), "rpc")) { + GCP_LOG(INFO) << "Enabled logging for REST rpc calls"; + stub = + std::make_shared( + std::move(stub), options.get(), + options.get()); + } + return stub; +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace + // compute_region_instance_group_manager_resize_requests_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_rest_stub_factory.h b/google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_rest_stub_factory.h new file mode 100644 index 0000000000000..e9d90b33b1a86 --- /dev/null +++ b/google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_rest_stub_factory.h @@ -0,0 +1,43 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_V1_INTERNAL_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_REST_STUB_FACTORY_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_V1_INTERNAL_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_REST_STUB_FACTORY_H + +#include "google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_rest_stub.h" +#include "google/cloud/options.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_instance_group_manager_resize_requests_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +std::shared_ptr +CreateDefaultRegionInstanceGroupManagerResizeRequestsRestStub( + Options const& options); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace + // compute_region_instance_group_manager_resize_requests_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_V1_INTERNAL_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_REST_STUB_FACTORY_H diff --git a/google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_retry_traits.h b/google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_retry_traits.h new file mode 100644 index 0000000000000..04ef53be470d9 --- /dev/null +++ b/google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_retry_traits.h @@ -0,0 +1,45 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_V1_INTERNAL_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_RETRY_TRAITS_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_V1_INTERNAL_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_RETRY_TRAITS_H + +#include "google/cloud/status.h" +#include "google/cloud/version.h" + +namespace google { +namespace cloud { +namespace compute_region_instance_group_manager_resize_requests_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/// Define the gRPC status code semantics for retrying requests. +struct RegionInstanceGroupManagerResizeRequestsRetryTraits { + static bool IsPermanentFailure(google::cloud::Status const& status) { + return status.code() != StatusCode::kOk && + status.code() != StatusCode::kUnavailable; + } +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace + // compute_region_instance_group_manager_resize_requests_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_V1_INTERNAL_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_RETRY_TRAITS_H diff --git a/google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_sources.cc b/google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_sources.cc new file mode 100644 index 0000000000000..48e2b33d2e10e --- /dev/null +++ b/google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_sources.cc @@ -0,0 +1,32 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests.proto + +// NOLINTBEGIN(bugprone-suspicious-include) +#include "google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_option_defaults.cc" +#include "google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_rest_connection_impl.cc" +#include "google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_rest_logging_decorator.cc" +#include "google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_rest_metadata_decorator.cc" +#include "google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_rest_stub.cc" +#include "google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_rest_stub_factory.cc" +#include "google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_tracing_connection.cc" +#include "google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests_client.cc" +#include "google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests_connection.cc" +#include "google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests_connection_idempotency_policy.cc" +#include "google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests_rest_connection.cc" +// NOLINTEND(bugprone-suspicious-include) diff --git a/google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_tracing_connection.cc b/google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_tracing_connection.cc new file mode 100644 index 0000000000000..a12f892d961f1 --- /dev/null +++ b/google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_tracing_connection.cc @@ -0,0 +1,217 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests.proto + +#include "google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_tracing_connection.h" +#include "google/cloud/internal/opentelemetry.h" +#include "google/cloud/internal/traced_stream_range.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_instance_group_manager_resize_requests_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +RegionInstanceGroupManagerResizeRequestsTracingConnection:: + RegionInstanceGroupManagerResizeRequestsTracingConnection( + std::shared_ptr< + compute_region_instance_group_manager_resize_requests_v1:: + RegionInstanceGroupManagerResizeRequestsConnection> + child) + : child_(std::move(child)) {} + +future> +RegionInstanceGroupManagerResizeRequestsTracingConnection::Cancel( + google::cloud::cpp::compute::region_instance_group_manager_resize_requests:: + v1::CancelRequest const& request) { + auto span = internal::MakeSpan( + "compute_region_instance_group_manager_resize_requests_v1::" + "RegionInstanceGroupManagerResizeRequestsConnection::Cancel"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), child_->Cancel(request)); +} + +StatusOr +RegionInstanceGroupManagerResizeRequestsTracingConnection::Cancel( + NoAwaitTag, + google::cloud::cpp::compute::region_instance_group_manager_resize_requests:: + v1::CancelRequest const& request) { + auto span = internal::MakeSpan( + "compute_region_instance_group_manager_resize_requests_v1::" + "RegionInstanceGroupManagerResizeRequestsConnection::Cancel"); + opentelemetry::trace::Scope scope(span); + return internal::EndSpan(*span, child_->Cancel(NoAwaitTag{}, request)); +} + +future> +RegionInstanceGroupManagerResizeRequestsTracingConnection::Cancel( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto span = internal::MakeSpan( + "compute_region_instance_group_manager_resize_requests_v1::" + "RegionInstanceGroupManagerResizeRequestsConnection::Cancel"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), child_->Cancel(operation)); +} + +future> +RegionInstanceGroupManagerResizeRequestsTracingConnection:: + DeleteInstanceGroupManagerResizeRequest( + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + DeleteInstanceGroupManagerResizeRequestRequest const& request) { + auto span = internal::MakeSpan( + "compute_region_instance_group_manager_resize_requests_v1::" + "RegionInstanceGroupManagerResizeRequestsConnection::" + "DeleteInstanceGroupManagerResizeRequest"); + internal::OTelScope scope(span); + return internal::EndSpan( + std::move(span), + child_->DeleteInstanceGroupManagerResizeRequest(request)); +} + +StatusOr +RegionInstanceGroupManagerResizeRequestsTracingConnection:: + DeleteInstanceGroupManagerResizeRequest( + NoAwaitTag, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + DeleteInstanceGroupManagerResizeRequestRequest const& request) { + auto span = internal::MakeSpan( + "compute_region_instance_group_manager_resize_requests_v1::" + "RegionInstanceGroupManagerResizeRequestsConnection::" + "DeleteInstanceGroupManagerResizeRequest"); + opentelemetry::trace::Scope scope(span); + return internal::EndSpan( + *span, + child_->DeleteInstanceGroupManagerResizeRequest(NoAwaitTag{}, request)); +} + +future> +RegionInstanceGroupManagerResizeRequestsTracingConnection:: + DeleteInstanceGroupManagerResizeRequest( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto span = internal::MakeSpan( + "compute_region_instance_group_manager_resize_requests_v1::" + "RegionInstanceGroupManagerResizeRequestsConnection::" + "DeleteInstanceGroupManagerResizeRequest"); + internal::OTelScope scope(span); + return internal::EndSpan( + std::move(span), + child_->DeleteInstanceGroupManagerResizeRequest(operation)); +} + +StatusOr +RegionInstanceGroupManagerResizeRequestsTracingConnection:: + GetInstanceGroupManagerResizeRequest( + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + GetInstanceGroupManagerResizeRequestRequest const& request) { + auto span = internal::MakeSpan( + "compute_region_instance_group_manager_resize_requests_v1::" + "RegionInstanceGroupManagerResizeRequestsConnection::" + "GetInstanceGroupManagerResizeRequest"); + auto scope = opentelemetry::trace::Scope(span); + return internal::EndSpan( + *span, child_->GetInstanceGroupManagerResizeRequest(request)); +} + +future> +RegionInstanceGroupManagerResizeRequestsTracingConnection:: + InsertInstanceGroupManagerResizeRequest( + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + InsertInstanceGroupManagerResizeRequestRequest const& request) { + auto span = internal::MakeSpan( + "compute_region_instance_group_manager_resize_requests_v1::" + "RegionInstanceGroupManagerResizeRequestsConnection::" + "InsertInstanceGroupManagerResizeRequest"); + internal::OTelScope scope(span); + return internal::EndSpan( + std::move(span), + child_->InsertInstanceGroupManagerResizeRequest(request)); +} + +StatusOr +RegionInstanceGroupManagerResizeRequestsTracingConnection:: + InsertInstanceGroupManagerResizeRequest( + NoAwaitTag, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + InsertInstanceGroupManagerResizeRequestRequest const& request) { + auto span = internal::MakeSpan( + "compute_region_instance_group_manager_resize_requests_v1::" + "RegionInstanceGroupManagerResizeRequestsConnection::" + "InsertInstanceGroupManagerResizeRequest"); + opentelemetry::trace::Scope scope(span); + return internal::EndSpan( + *span, + child_->InsertInstanceGroupManagerResizeRequest(NoAwaitTag{}, request)); +} + +future> +RegionInstanceGroupManagerResizeRequestsTracingConnection:: + InsertInstanceGroupManagerResizeRequest( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto span = internal::MakeSpan( + "compute_region_instance_group_manager_resize_requests_v1::" + "RegionInstanceGroupManagerResizeRequestsConnection::" + "InsertInstanceGroupManagerResizeRequest"); + internal::OTelScope scope(span); + return internal::EndSpan( + std::move(span), + child_->InsertInstanceGroupManagerResizeRequest(operation)); +} + +StreamRange +RegionInstanceGroupManagerResizeRequestsTracingConnection:: + ListRegionInstanceGroupManagerResizeRequests( + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + ListRegionInstanceGroupManagerResizeRequestsRequest request) { + auto span = internal::MakeSpan( + "compute_region_instance_group_manager_resize_requests_v1::" + "RegionInstanceGroupManagerResizeRequestsConnection::" + "ListRegionInstanceGroupManagerResizeRequests"); + internal::OTelScope scope(span); + auto sr = + child_->ListRegionInstanceGroupManagerResizeRequests(std::move(request)); + return internal::MakeTracedStreamRange< + google::cloud::cpp::compute::v1::InstanceGroupManagerResizeRequest>( + std::move(span), std::move(sr)); +} + +std::shared_ptr +MakeRegionInstanceGroupManagerResizeRequestsTracingConnection( + std::shared_ptr + conn) { + if (internal::TracingEnabled(conn->options())) { + conn = std::make_shared< + RegionInstanceGroupManagerResizeRequestsTracingConnection>( + std::move(conn)); + } + return conn; +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace + // compute_region_instance_group_manager_resize_requests_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_tracing_connection.h b/google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_tracing_connection.h new file mode 100644 index 0000000000000..3aabc52c4b187 --- /dev/null +++ b/google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_tracing_connection.h @@ -0,0 +1,137 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_V1_INTERNAL_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_TRACING_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_V1_INTERNAL_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_TRACING_CONNECTION_H + +#include "google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests_connection.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_instance_group_manager_resize_requests_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class RegionInstanceGroupManagerResizeRequestsTracingConnection + : public compute_region_instance_group_manager_resize_requests_v1:: + RegionInstanceGroupManagerResizeRequestsConnection { + public: + ~RegionInstanceGroupManagerResizeRequestsTracingConnection() override = + default; + + explicit RegionInstanceGroupManagerResizeRequestsTracingConnection( + std::shared_ptr + child); + + Options options() override { return child_->options(); } + + future> Cancel( + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + CancelRequest const& request) override; + + StatusOr Cancel( + NoAwaitTag, google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + CancelRequest const& request) override; + + future> Cancel( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + future> + DeleteInstanceGroupManagerResizeRequest( + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + DeleteInstanceGroupManagerResizeRequestRequest const& request) + override; + + StatusOr + DeleteInstanceGroupManagerResizeRequest( + NoAwaitTag, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + DeleteInstanceGroupManagerResizeRequestRequest const& request) + override; + + future> + DeleteInstanceGroupManagerResizeRequest( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + StatusOr + GetInstanceGroupManagerResizeRequest( + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + GetInstanceGroupManagerResizeRequestRequest const& request) + override; + + future> + InsertInstanceGroupManagerResizeRequest( + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + InsertInstanceGroupManagerResizeRequestRequest const& request) + override; + + StatusOr + InsertInstanceGroupManagerResizeRequest( + NoAwaitTag, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + InsertInstanceGroupManagerResizeRequestRequest const& request) + override; + + future> + InsertInstanceGroupManagerResizeRequest( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + StreamRange< + google::cloud::cpp::compute::v1::InstanceGroupManagerResizeRequest> + ListRegionInstanceGroupManagerResizeRequests( + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + ListRegionInstanceGroupManagerResizeRequestsRequest request) + override; + + private: + std::shared_ptr + child_; +}; + +/** + * Conditionally applies the tracing decorator to the given connection. + * + * The connection is only decorated if tracing is enabled (as determined by the + * connection's options). + */ +std::shared_ptr +MakeRegionInstanceGroupManagerResizeRequestsTracingConnection( + std::shared_ptr + conn); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace + // compute_region_instance_group_manager_resize_requests_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_V1_INTERNAL_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_TRACING_CONNECTION_H diff --git a/google/cloud/compute/region_instance_group_manager_resize_requests/v1/mocks/mock_region_instance_group_manager_resize_requests_connection.h b/google/cloud/compute/region_instance_group_manager_resize_requests/v1/mocks/mock_region_instance_group_manager_resize_requests_connection.h new file mode 100644 index 0000000000000..598c1d21d73ae --- /dev/null +++ b/google/cloud/compute/region_instance_group_manager_resize_requests/v1/mocks/mock_region_instance_group_manager_resize_requests_connection.h @@ -0,0 +1,210 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_V1_MOCKS_MOCK_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_V1_MOCKS_MOCK_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_CONNECTION_H + +#include "google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests_connection.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_instance_group_manager_resize_requests_v1_mocks { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/** + * A class to mock `RegionInstanceGroupManagerResizeRequestsConnection`. + * + * Application developers may want to test their code with simulated responses, + * including errors, from an object of type + * `RegionInstanceGroupManagerResizeRequestsClient`. To do so, construct an + * object of type `RegionInstanceGroupManagerResizeRequestsClient` with an + * instance of this class. Then use the Google Test framework functions to + * program the behavior of this mock. + * + * @see [This example][bq-mock] for how to test your application with GoogleTest. + * While the example showcases types from the BigQuery library, the underlying + * principles apply for any pair of `*Client` and `*Connection`. + * + * [bq-mock]: @cloud_cpp_docs_link{bigquery,bigquery-read-mock} + */ +class MockRegionInstanceGroupManagerResizeRequestsConnection + : public compute_region_instance_group_manager_resize_requests_v1:: + RegionInstanceGroupManagerResizeRequestsConnection { + public: + MOCK_METHOD(Options, options, (), (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// Cancel(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + Cancel, + (google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + CancelRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// EXPECT_CALL(*mock, Cancel(_, _)) + /// @endcode + MOCK_METHOD(StatusOr, Cancel, + (NoAwaitTag, google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests:: + v1::CancelRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// Cancel(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + Cancel, + (google::cloud::cpp::compute::v1::Operation const& operation), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// DeleteInstanceGroupManagerResizeRequest(Matcher(_))) + /// @endcode + MOCK_METHOD( + future>, + DeleteInstanceGroupManagerResizeRequest, + (google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + DeleteInstanceGroupManagerResizeRequestRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// EXPECT_CALL(*mock, DeleteInstanceGroupManagerResizeRequest(_, _)) + /// @endcode + MOCK_METHOD( + StatusOr, + DeleteInstanceGroupManagerResizeRequest, + (NoAwaitTag, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + DeleteInstanceGroupManagerResizeRequestRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// DeleteInstanceGroupManagerResizeRequest(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + DeleteInstanceGroupManagerResizeRequest, + (google::cloud::cpp::compute::v1::Operation const& operation), + (override)); + + MOCK_METHOD( + StatusOr< + google::cloud::cpp::compute::v1::InstanceGroupManagerResizeRequest>, + GetInstanceGroupManagerResizeRequest, + (google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + GetInstanceGroupManagerResizeRequestRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// InsertInstanceGroupManagerResizeRequest(Matcher(_))) + /// @endcode + MOCK_METHOD( + future>, + InsertInstanceGroupManagerResizeRequest, + (google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + InsertInstanceGroupManagerResizeRequestRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// EXPECT_CALL(*mock, InsertInstanceGroupManagerResizeRequest(_, _)) + /// @endcode + MOCK_METHOD( + StatusOr, + InsertInstanceGroupManagerResizeRequest, + (NoAwaitTag, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + InsertInstanceGroupManagerResizeRequestRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// InsertInstanceGroupManagerResizeRequest(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + InsertInstanceGroupManagerResizeRequest, + (google::cloud::cpp::compute::v1::Operation const& operation), + (override)); + + MOCK_METHOD( + (StreamRange< + google::cloud::cpp::compute::v1::InstanceGroupManagerResizeRequest>), + ListRegionInstanceGroupManagerResizeRequests, + (google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + ListRegionInstanceGroupManagerResizeRequestsRequest request), + (override)); +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_instance_group_manager_resize_requests_v1_mocks +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_V1_MOCKS_MOCK_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_CONNECTION_H diff --git a/google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests_client.cc b/google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests_client.cc new file mode 100644 index 0000000000000..f461707136299 --- /dev/null +++ b/google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests_client.cc @@ -0,0 +1,292 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests.proto + +#include "google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests_client.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_instance_group_manager_resize_requests_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +RegionInstanceGroupManagerResizeRequestsClient:: + RegionInstanceGroupManagerResizeRequestsClient( + std::shared_ptr + connection, + Options opts) + : connection_(std::move(connection)), + options_( + internal::MergeOptions(std::move(opts), connection_->options())) {} +RegionInstanceGroupManagerResizeRequestsClient:: + ~RegionInstanceGroupManagerResizeRequestsClient() = default; + +future> +RegionInstanceGroupManagerResizeRequestsClient::Cancel( + std::string const& project, std::string const& region, + std::string const& instance_group_manager, + std::string const& resize_request, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_instance_group_manager_resize_requests:: + v1::CancelRequest request; + request.set_project(project); + request.set_region(region); + request.set_instance_group_manager(instance_group_manager); + request.set_resize_request(resize_request); + return connection_->Cancel(request); +} + +StatusOr +RegionInstanceGroupManagerResizeRequestsClient::Cancel( + NoAwaitTag, std::string const& project, std::string const& region, + std::string const& instance_group_manager, + std::string const& resize_request, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_instance_group_manager_resize_requests:: + v1::CancelRequest request; + request.set_project(project); + request.set_region(region); + request.set_instance_group_manager(instance_group_manager); + request.set_resize_request(resize_request); + return connection_->Cancel(NoAwaitTag{}, request); +} + +future> +RegionInstanceGroupManagerResizeRequestsClient::Cancel( + google::cloud::cpp::compute::region_instance_group_manager_resize_requests:: + v1::CancelRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->Cancel(request); +} + +StatusOr +RegionInstanceGroupManagerResizeRequestsClient::Cancel( + NoAwaitTag, + google::cloud::cpp::compute::region_instance_group_manager_resize_requests:: + v1::CancelRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->Cancel(NoAwaitTag{}, request); +} + +future> +RegionInstanceGroupManagerResizeRequestsClient::Cancel( + google::cloud::cpp::compute::v1::Operation const& operation, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->Cancel(operation); +} + +future> +RegionInstanceGroupManagerResizeRequestsClient:: + DeleteInstanceGroupManagerResizeRequest( + std::string const& project, std::string const& region, + std::string const& instance_group_manager, + std::string const& resize_request, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_instance_group_manager_resize_requests:: + v1::DeleteInstanceGroupManagerResizeRequestRequest request; + request.set_project(project); + request.set_region(region); + request.set_instance_group_manager(instance_group_manager); + request.set_resize_request(resize_request); + return connection_->DeleteInstanceGroupManagerResizeRequest(request); +} + +StatusOr +RegionInstanceGroupManagerResizeRequestsClient:: + DeleteInstanceGroupManagerResizeRequest( + NoAwaitTag, std::string const& project, std::string const& region, + std::string const& instance_group_manager, + std::string const& resize_request, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_instance_group_manager_resize_requests:: + v1::DeleteInstanceGroupManagerResizeRequestRequest request; + request.set_project(project); + request.set_region(region); + request.set_instance_group_manager(instance_group_manager); + request.set_resize_request(resize_request); + return connection_->DeleteInstanceGroupManagerResizeRequest(NoAwaitTag{}, + request); +} + +future> +RegionInstanceGroupManagerResizeRequestsClient:: + DeleteInstanceGroupManagerResizeRequest( + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + DeleteInstanceGroupManagerResizeRequestRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->DeleteInstanceGroupManagerResizeRequest(request); +} + +StatusOr +RegionInstanceGroupManagerResizeRequestsClient:: + DeleteInstanceGroupManagerResizeRequest( + NoAwaitTag, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + DeleteInstanceGroupManagerResizeRequestRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->DeleteInstanceGroupManagerResizeRequest(NoAwaitTag{}, + request); +} + +future> +RegionInstanceGroupManagerResizeRequestsClient:: + DeleteInstanceGroupManagerResizeRequest( + google::cloud::cpp::compute::v1::Operation const& operation, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->DeleteInstanceGroupManagerResizeRequest(operation); +} + +StatusOr +RegionInstanceGroupManagerResizeRequestsClient:: + GetInstanceGroupManagerResizeRequest( + std::string const& project, std::string const& region, + std::string const& instance_group_manager, + std::string const& resize_request, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_instance_group_manager_resize_requests:: + v1::GetInstanceGroupManagerResizeRequestRequest request; + request.set_project(project); + request.set_region(region); + request.set_instance_group_manager(instance_group_manager); + request.set_resize_request(resize_request); + return connection_->GetInstanceGroupManagerResizeRequest(request); +} + +StatusOr +RegionInstanceGroupManagerResizeRequestsClient:: + GetInstanceGroupManagerResizeRequest( + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + GetInstanceGroupManagerResizeRequestRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->GetInstanceGroupManagerResizeRequest(request); +} + +future> +RegionInstanceGroupManagerResizeRequestsClient:: + InsertInstanceGroupManagerResizeRequest( + std::string const& project, std::string const& region, + std::string const& instance_group_manager, + google::cloud::cpp::compute::v1:: + InstanceGroupManagerResizeRequest const& + instance_group_manager_resize_request_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_instance_group_manager_resize_requests:: + v1::InsertInstanceGroupManagerResizeRequestRequest request; + request.set_project(project); + request.set_region(region); + request.set_instance_group_manager(instance_group_manager); + *request.mutable_instance_group_manager_resize_request_resource() = + instance_group_manager_resize_request_resource; + return connection_->InsertInstanceGroupManagerResizeRequest(request); +} + +StatusOr +RegionInstanceGroupManagerResizeRequestsClient:: + InsertInstanceGroupManagerResizeRequest( + NoAwaitTag, std::string const& project, std::string const& region, + std::string const& instance_group_manager, + google::cloud::cpp::compute::v1:: + InstanceGroupManagerResizeRequest const& + instance_group_manager_resize_request_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_instance_group_manager_resize_requests:: + v1::InsertInstanceGroupManagerResizeRequestRequest request; + request.set_project(project); + request.set_region(region); + request.set_instance_group_manager(instance_group_manager); + *request.mutable_instance_group_manager_resize_request_resource() = + instance_group_manager_resize_request_resource; + return connection_->InsertInstanceGroupManagerResizeRequest(NoAwaitTag{}, + request); +} + +future> +RegionInstanceGroupManagerResizeRequestsClient:: + InsertInstanceGroupManagerResizeRequest( + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + InsertInstanceGroupManagerResizeRequestRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->InsertInstanceGroupManagerResizeRequest(request); +} + +StatusOr +RegionInstanceGroupManagerResizeRequestsClient:: + InsertInstanceGroupManagerResizeRequest( + NoAwaitTag, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + InsertInstanceGroupManagerResizeRequestRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->InsertInstanceGroupManagerResizeRequest(NoAwaitTag{}, + request); +} + +future> +RegionInstanceGroupManagerResizeRequestsClient:: + InsertInstanceGroupManagerResizeRequest( + google::cloud::cpp::compute::v1::Operation const& operation, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->InsertInstanceGroupManagerResizeRequest(operation); +} + +StreamRange +RegionInstanceGroupManagerResizeRequestsClient:: + ListRegionInstanceGroupManagerResizeRequests( + std::string const& project, std::string const& region, + std::string const& instance_group_manager, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_instance_group_manager_resize_requests:: + v1::ListRegionInstanceGroupManagerResizeRequestsRequest request; + request.set_project(project); + request.set_region(region); + request.set_instance_group_manager(instance_group_manager); + return connection_->ListRegionInstanceGroupManagerResizeRequests(request); +} + +StreamRange +RegionInstanceGroupManagerResizeRequestsClient:: + ListRegionInstanceGroupManagerResizeRequests( + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + ListRegionInstanceGroupManagerResizeRequestsRequest request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->ListRegionInstanceGroupManagerResizeRequests( + std::move(request)); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_instance_group_manager_resize_requests_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests_client.h b/google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests_client.h new file mode 100644 index 0000000000000..714461c3f24ad --- /dev/null +++ b/google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests_client.h @@ -0,0 +1,674 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_V1_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_CLIENT_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_V1_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_CLIENT_H + +#include "google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests_rest_connection.h" +#include "google/cloud/future.h" +#include "google/cloud/no_await_tag.h" +#include "google/cloud/options.h" +#include "google/cloud/polling_policy.h" +#include "google/cloud/status_or.h" +#include "google/cloud/version.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_instance_group_manager_resize_requests_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/// +/// Service for the regionInstanceGroupManagerResizeRequests resource. +/// https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroupManagerResizeRequests +/// +/// @par Equality +/// +/// Instances of this class created via copy-construction or copy-assignment +/// always compare equal. Instances created with equal +/// `std::shared_ptr<*Connection>` objects compare equal. Objects that compare +/// equal share the same underlying resources. +/// +/// @par Performance +/// +/// Creating a new instance of this class is a relatively expensive operation, +/// new objects establish new connections to the service. In contrast, +/// copy-construction, move-construction, and the corresponding assignment +/// operations are relatively efficient as the copies share all underlying +/// resources. +/// +/// @par Thread Safety +/// +/// Concurrent access to different instances of this class, even if they compare +/// equal, is guaranteed to work. Two or more threads operating on the same +/// instance of this class is not guaranteed to work. Since copy-construction +/// and move-construction is a relatively efficient operation, consider using +/// such a copy when using this class from multiple threads. +/// +class RegionInstanceGroupManagerResizeRequestsClient { + public: + explicit RegionInstanceGroupManagerResizeRequestsClient( + std::shared_ptr + connection, + Options opts = {}); + ~RegionInstanceGroupManagerResizeRequestsClient(); + + ///@{ + /// @name Copy and move support + RegionInstanceGroupManagerResizeRequestsClient( + RegionInstanceGroupManagerResizeRequestsClient const&) = default; + RegionInstanceGroupManagerResizeRequestsClient& operator=( + RegionInstanceGroupManagerResizeRequestsClient const&) = default; + RegionInstanceGroupManagerResizeRequestsClient( + RegionInstanceGroupManagerResizeRequestsClient&&) = default; + RegionInstanceGroupManagerResizeRequestsClient& operator=( + RegionInstanceGroupManagerResizeRequestsClient&&) = default; + ///@} + + ///@{ + /// @name Equality + friend bool operator==( + RegionInstanceGroupManagerResizeRequestsClient const& a, + RegionInstanceGroupManagerResizeRequestsClient const& b) { + return a.connection_ == b.connection_; + } + friend bool operator!=( + RegionInstanceGroupManagerResizeRequestsClient const& a, + RegionInstanceGroupManagerResizeRequestsClient const& b) { + return !(a == b); + } + ///@} + + // clang-format off + /// + /// Cancels the specified resize request. + /// Cancelled resize request no longer waits for the resources to be + /// provisioned. Cancel is only possible for requests that are in accepted + /// state. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroupManagerResizeRequests/cancel + /// + /// @param project Project ID for this request. + /// @param region The name of the region + /// scoping this request. Name should conform to RFC1035. + /// @param instance_group_manager The name of the managed instance group. + /// Name should conform to RFC1035 or be a resource ID. + /// @param resize_request The name of the resize request to cancel. + /// Name should conform to RFC1035 or be a resource ID. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_instance_group_manager_resize_requests.v1.CancelRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests.proto#L114} + /// + // clang-format on + future> Cancel( + std::string const& project, std::string const& region, + std::string const& instance_group_manager, + std::string const& resize_request, Options opts = {}); + + // clang-format off + /// + /// @copybrief Cancel + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr Cancel( + NoAwaitTag, std::string const& project, std::string const& region, + std::string const& instance_group_manager, + std::string const& resize_request, Options opts = {}); + + // clang-format off + /// + /// Cancels the specified resize request. + /// Cancelled resize request no longer waits for the resources to be + /// provisioned. Cancel is only possible for requests that are in accepted + /// state. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroupManagerResizeRequests/cancel + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.region_instance_group_manager_resize_requests.v1.CancelRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_instance_group_manager_resize_requests.v1.CancelRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests.proto#L114} + /// + // clang-format on + future> Cancel( + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + CancelRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief Cancel + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr Cancel( + NoAwaitTag, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + CancelRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief Cancel + /// + /// This method accepts a `google::cloud::cpp::compute::v1::Operation` that corresponds + /// to a previously started Long Running Operation (LRO) and polls the status + /// of the LRO in the background. + /// + // clang-format on + future> Cancel( + google::cloud::cpp::compute::v1::Operation const& operation, + Options opts = {}); + + // clang-format off + /// + /// Deletes the specified, inactive resize request. Requests that are still + /// active cannot be deleted. Deleting request does not delete instances that + /// were provisioned previously. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroupManagerResizeRequests/delete + /// + /// @param project Project ID for this request. + /// @param region The name of the region + /// scoping this request. Name should conform to RFC1035. + /// @param instance_group_manager The name of the managed instance group. + /// Name should conform to RFC1035 or be a resource ID. + /// @param resize_request The name of the resize request to delete. + /// Name should conform to RFC1035 or be a resource ID. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_instance_group_manager_resize_requests.v1.DeleteInstanceGroupManagerResizeRequestRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests.proto#L159} + /// + // clang-format on + future> + DeleteInstanceGroupManagerResizeRequest( + std::string const& project, std::string const& region, + std::string const& instance_group_manager, + std::string const& resize_request, Options opts = {}); + + // clang-format off + /// + /// @copybrief DeleteInstanceGroupManagerResizeRequest + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr + DeleteInstanceGroupManagerResizeRequest( + NoAwaitTag, std::string const& project, std::string const& region, + std::string const& instance_group_manager, + std::string const& resize_request, Options opts = {}); + + // clang-format off + /// + /// Deletes the specified, inactive resize request. Requests that are still + /// active cannot be deleted. Deleting request does not delete instances that + /// were provisioned previously. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroupManagerResizeRequests/delete + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.region_instance_group_manager_resize_requests.v1.DeleteInstanceGroupManagerResizeRequestRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_instance_group_manager_resize_requests.v1.DeleteInstanceGroupManagerResizeRequestRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests.proto#L159} + /// + // clang-format on + future> + DeleteInstanceGroupManagerResizeRequest( + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + DeleteInstanceGroupManagerResizeRequestRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief DeleteInstanceGroupManagerResizeRequest + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr + DeleteInstanceGroupManagerResizeRequest( + NoAwaitTag, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + DeleteInstanceGroupManagerResizeRequestRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief DeleteInstanceGroupManagerResizeRequest + /// + /// This method accepts a `google::cloud::cpp::compute::v1::Operation` that corresponds + /// to a previously started Long Running Operation (LRO) and polls the status + /// of the LRO in the background. + /// + // clang-format on + future> + DeleteInstanceGroupManagerResizeRequest( + google::cloud::cpp::compute::v1::Operation const& operation, + Options opts = {}); + + // clang-format off + /// + /// Returns all of the details about the specified resize request. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroupManagerResizeRequests/get + /// + /// @param project Project ID for this request. + /// @param region The name of the region + /// scoping this request. Name should conform to RFC1035. + /// @param instance_group_manager The name of the managed instance group. + /// Name should conform to RFC1035 or be a resource ID. + /// @param resize_request The name of the resize request. + /// Name should conform to RFC1035 or be a resource ID. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.InstanceGroupManagerResizeRequest]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_instance_group_manager_resize_requests.v1.GetInstanceGroupManagerResizeRequestRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests.proto#L204} + /// [google.cloud.cpp.compute.v1.InstanceGroupManagerResizeRequest]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_076.proto#L33} + /// + // clang-format on + StatusOr + GetInstanceGroupManagerResizeRequest( + std::string const& project, std::string const& region, + std::string const& instance_group_manager, + std::string const& resize_request, Options opts = {}); + + // clang-format off + /// + /// Returns all of the details about the specified resize request. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroupManagerResizeRequests/get + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.region_instance_group_manager_resize_requests.v1.GetInstanceGroupManagerResizeRequestRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.InstanceGroupManagerResizeRequest]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_instance_group_manager_resize_requests.v1.GetInstanceGroupManagerResizeRequestRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests.proto#L204} + /// [google.cloud.cpp.compute.v1.InstanceGroupManagerResizeRequest]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_076.proto#L33} + /// + // clang-format on + StatusOr + GetInstanceGroupManagerResizeRequest( + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + GetInstanceGroupManagerResizeRequestRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// Creates a new Resize Request that starts provisioning VMs immediately + /// or queues VM creation. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroupManagerResizeRequests/insert + /// + /// @param project Project ID for this request. + /// @param region Name of the region + /// scoping this request. Name should conform to RFC1035. + /// @param instance_group_manager Name of the managed instance group to which the resize request is scoped. + /// Name should conform to RFC1035 or be a resource ID. + /// @param instance_group_manager_resize_request_resource The InstanceGroupManagerResizeRequest for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_instance_group_manager_resize_requests.v1.InsertInstanceGroupManagerResizeRequestRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests.proto#L228} + /// + // clang-format on + future> + InsertInstanceGroupManagerResizeRequest( + std::string const& project, std::string const& region, + std::string const& instance_group_manager, + google::cloud::cpp::compute::v1::InstanceGroupManagerResizeRequest const& + instance_group_manager_resize_request_resource, + Options opts = {}); + + // clang-format off + /// + /// @copybrief InsertInstanceGroupManagerResizeRequest + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr + InsertInstanceGroupManagerResizeRequest( + NoAwaitTag, std::string const& project, std::string const& region, + std::string const& instance_group_manager, + google::cloud::cpp::compute::v1::InstanceGroupManagerResizeRequest const& + instance_group_manager_resize_request_resource, + Options opts = {}); + + // clang-format off + /// + /// Creates a new Resize Request that starts provisioning VMs immediately + /// or queues VM creation. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroupManagerResizeRequests/insert + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.region_instance_group_manager_resize_requests.v1.InsertInstanceGroupManagerResizeRequestRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_instance_group_manager_resize_requests.v1.InsertInstanceGroupManagerResizeRequestRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests.proto#L228} + /// + // clang-format on + future> + InsertInstanceGroupManagerResizeRequest( + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + InsertInstanceGroupManagerResizeRequestRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief InsertInstanceGroupManagerResizeRequest + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr + InsertInstanceGroupManagerResizeRequest( + NoAwaitTag, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + InsertInstanceGroupManagerResizeRequestRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief InsertInstanceGroupManagerResizeRequest + /// + /// This method accepts a `google::cloud::cpp::compute::v1::Operation` that corresponds + /// to a previously started Long Running Operation (LRO) and polls the status + /// of the LRO in the background. + /// + // clang-format on + future> + InsertInstanceGroupManagerResizeRequest( + google::cloud::cpp::compute::v1::Operation const& operation, + Options opts = {}); + + // clang-format off + /// + /// Retrieves a list of Resize Requests that are contained in the + /// managed instance group. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroupManagerResizeRequests/list + /// + /// @param project Project ID for this request. + /// @param region Name of the region + /// scoping this request. Name should conform to RFC1035. + /// @param instance_group_manager The name of the managed instance group. The name should conform to RFC1035. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return a [StreamRange](@ref google::cloud::StreamRange) + /// to iterate of the results. See the documentation of this type for + /// details. In brief, this class has `begin()` and `end()` member + /// functions returning a iterator class meeting the + /// [input iterator requirements]. The value type for this iterator is a + /// [`StatusOr`] as the iteration may fail even after some values are + /// retrieved successfully, for example, if there is a network disconnect. + /// An empty set of results does not indicate an error, it indicates + /// that there are no resources meeting the request criteria. + /// On a successful iteration the `StatusOr` contains elements of type + /// [google.cloud.cpp.compute.v1.InstanceGroupManagerResizeRequest], or rather, + /// the C++ class generated by Protobuf from that type. Please consult the + /// Protobuf documentation for details on the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_instance_group_manager_resize_requests.v1.ListRegionInstanceGroupManagerResizeRequestsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests.proto#L273} + /// [google.cloud.cpp.compute.v1.InstanceGroupManagerResizeRequest]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_076.proto#L33} + /// + // clang-format on + StreamRange< + google::cloud::cpp::compute::v1::InstanceGroupManagerResizeRequest> + ListRegionInstanceGroupManagerResizeRequests( + std::string const& project, std::string const& region, + std::string const& instance_group_manager, Options opts = {}); + + // clang-format off + /// + /// Retrieves a list of Resize Requests that are contained in the + /// managed instance group. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroupManagerResizeRequests/list + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.region_instance_group_manager_resize_requests.v1.ListRegionInstanceGroupManagerResizeRequestsRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return a [StreamRange](@ref google::cloud::StreamRange) + /// to iterate of the results. See the documentation of this type for + /// details. In brief, this class has `begin()` and `end()` member + /// functions returning a iterator class meeting the + /// [input iterator requirements]. The value type for this iterator is a + /// [`StatusOr`] as the iteration may fail even after some values are + /// retrieved successfully, for example, if there is a network disconnect. + /// An empty set of results does not indicate an error, it indicates + /// that there are no resources meeting the request criteria. + /// On a successful iteration the `StatusOr` contains elements of type + /// [google.cloud.cpp.compute.v1.InstanceGroupManagerResizeRequest], or rather, + /// the C++ class generated by Protobuf from that type. Please consult the + /// Protobuf documentation for details on the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_instance_group_manager_resize_requests.v1.ListRegionInstanceGroupManagerResizeRequestsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests.proto#L273} + /// [google.cloud.cpp.compute.v1.InstanceGroupManagerResizeRequest]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_076.proto#L33} + /// + // clang-format on + StreamRange< + google::cloud::cpp::compute::v1::InstanceGroupManagerResizeRequest> + ListRegionInstanceGroupManagerResizeRequests( + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + ListRegionInstanceGroupManagerResizeRequestsRequest request, + Options opts = {}); + + private: + std::shared_ptr + connection_; + Options options_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_instance_group_manager_resize_requests_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_V1_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_CLIENT_H diff --git a/google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests_connection.cc b/google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests_connection.cc new file mode 100644 index 0000000000000..f21ef36b9ac85 --- /dev/null +++ b/google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests_connection.cc @@ -0,0 +1,151 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests.proto + +#include "google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests_connection.h" +#include "google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_option_defaults.h" +#include "google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_tracing_connection.h" +#include "google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests_options.h" +#include "google/cloud/background_threads.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/grpc_options.h" +#include "google/cloud/internal/pagination_range.h" +#include "google/cloud/internal/unified_grpc_credentials.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_instance_group_manager_resize_requests_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +RegionInstanceGroupManagerResizeRequestsConnection:: + ~RegionInstanceGroupManagerResizeRequestsConnection() = default; + +future> +RegionInstanceGroupManagerResizeRequestsConnection::Cancel( + google::cloud::cpp::compute::region_instance_group_manager_resize_requests:: + v1::CancelRequest const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +RegionInstanceGroupManagerResizeRequestsConnection::Cancel( + NoAwaitTag, + google::cloud::cpp::compute::region_instance_group_manager_resize_requests:: + v1::CancelRequest const&) { + return StatusOr( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +RegionInstanceGroupManagerResizeRequestsConnection::Cancel( + google::cloud::cpp::compute::v1::Operation const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +RegionInstanceGroupManagerResizeRequestsConnection:: + DeleteInstanceGroupManagerResizeRequest( + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + DeleteInstanceGroupManagerResizeRequestRequest const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +RegionInstanceGroupManagerResizeRequestsConnection:: + DeleteInstanceGroupManagerResizeRequest( + NoAwaitTag, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + DeleteInstanceGroupManagerResizeRequestRequest const&) { + return StatusOr( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +RegionInstanceGroupManagerResizeRequestsConnection:: + DeleteInstanceGroupManagerResizeRequest( + google::cloud::cpp::compute::v1::Operation const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +RegionInstanceGroupManagerResizeRequestsConnection:: + GetInstanceGroupManagerResizeRequest( + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + GetInstanceGroupManagerResizeRequestRequest const&) { + return Status(StatusCode::kUnimplemented, "not implemented"); +} + +future> +RegionInstanceGroupManagerResizeRequestsConnection:: + InsertInstanceGroupManagerResizeRequest( + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + InsertInstanceGroupManagerResizeRequestRequest const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +RegionInstanceGroupManagerResizeRequestsConnection:: + InsertInstanceGroupManagerResizeRequest( + NoAwaitTag, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + InsertInstanceGroupManagerResizeRequestRequest const&) { + return StatusOr( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +RegionInstanceGroupManagerResizeRequestsConnection:: + InsertInstanceGroupManagerResizeRequest( + google::cloud::cpp::compute::v1::Operation const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StreamRange +RegionInstanceGroupManagerResizeRequestsConnection:: + ListRegionInstanceGroupManagerResizeRequests( + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + ListRegionInstanceGroupManagerResizeRequestsRequest) { // NOLINT(performance-unnecessary-value-param) + return google::cloud::internal::MakeUnimplementedPaginationRange>(); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_instance_group_manager_resize_requests_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests_connection.h b/google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests_connection.h new file mode 100644 index 0000000000000..63cd0f55c2ff7 --- /dev/null +++ b/google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests_connection.h @@ -0,0 +1,280 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_V1_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_V1_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_CONNECTION_H + +#include "google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_retry_traits.h" +#include "google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests.pb.h" +#include "google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests_connection_idempotency_policy.h" +#include "google/cloud/backoff_policy.h" +#include "google/cloud/future.h" +#include "google/cloud/internal/retry_policy_impl.h" +#include "google/cloud/no_await_tag.h" +#include "google/cloud/options.h" +#include "google/cloud/polling_policy.h" +#include "google/cloud/status_or.h" +#include "google/cloud/stream_range.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_instance_group_manager_resize_requests_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/// The retry policy for `RegionInstanceGroupManagerResizeRequestsConnection`. +class RegionInstanceGroupManagerResizeRequestsRetryPolicy + : public ::google::cloud::RetryPolicy { + public: + /// Creates a new instance of the policy, reset to the initial state. + virtual std::unique_ptr + clone() const = 0; +}; + +/** + * A retry policy for `RegionInstanceGroupManagerResizeRequestsConnection` based + * on counting errors. + * + * This policy stops retrying if: + * - An RPC returns a non-transient error. + * - More than a prescribed number of transient failures is detected. + * + * In this class the following status codes are treated as transient errors: + * - [`kUnavailable`](@ref google::cloud::StatusCode) + */ +class RegionInstanceGroupManagerResizeRequestsLimitedErrorCountRetryPolicy + : public RegionInstanceGroupManagerResizeRequestsRetryPolicy { + public: + /** + * Create an instance that tolerates up to @p maximum_failures transient + * errors. + * + * @note Disable the retry loop by providing an instance of this policy with + * @p maximum_failures == 0. + */ + explicit RegionInstanceGroupManagerResizeRequestsLimitedErrorCountRetryPolicy( + int maximum_failures) + : impl_(maximum_failures) {} + + RegionInstanceGroupManagerResizeRequestsLimitedErrorCountRetryPolicy( + RegionInstanceGroupManagerResizeRequestsLimitedErrorCountRetryPolicy&& + rhs) noexcept + : RegionInstanceGroupManagerResizeRequestsLimitedErrorCountRetryPolicy( + rhs.maximum_failures()) {} + RegionInstanceGroupManagerResizeRequestsLimitedErrorCountRetryPolicy( + RegionInstanceGroupManagerResizeRequestsLimitedErrorCountRetryPolicy const& + rhs) noexcept + : RegionInstanceGroupManagerResizeRequestsLimitedErrorCountRetryPolicy( + rhs.maximum_failures()) {} + + int maximum_failures() const { return impl_.maximum_failures(); } + + bool OnFailure(Status const& status) override { + return impl_.OnFailure(status); + } + bool IsExhausted() const override { return impl_.IsExhausted(); } + bool IsPermanentFailure(Status const& status) const override { + return impl_.IsPermanentFailure(status); + } + std::unique_ptr clone() + const override { + return std::make_unique< + RegionInstanceGroupManagerResizeRequestsLimitedErrorCountRetryPolicy>( + maximum_failures()); + } + + // This is provided only for backwards compatibility. + using BaseType = RegionInstanceGroupManagerResizeRequestsRetryPolicy; + + private: + google::cloud::internal::LimitedErrorCountRetryPolicy< + compute_region_instance_group_manager_resize_requests_v1_internal:: + RegionInstanceGroupManagerResizeRequestsRetryTraits> + impl_; +}; + +/** + * A retry policy for `RegionInstanceGroupManagerResizeRequestsConnection` based + * on elapsed time. + * + * This policy stops retrying if: + * - An RPC returns a non-transient error. + * - The elapsed time in the retry loop exceeds a prescribed duration. + * + * In this class the following status codes are treated as transient errors: + * - [`kUnavailable`](@ref google::cloud::StatusCode) + */ +class RegionInstanceGroupManagerResizeRequestsLimitedTimeRetryPolicy + : public RegionInstanceGroupManagerResizeRequestsRetryPolicy { + public: + /** + * Constructor given a `std::chrono::duration<>` object. + * + * @tparam DurationRep a placeholder to match the `Rep` tparam for @p + * duration's type. The semantics of this template parameter are + * documented in `std::chrono::duration<>`. In brief, the underlying + * arithmetic type used to store the number of ticks. For our purposes it + * is simply a formal parameter. + * @tparam DurationPeriod a placeholder to match the `Period` tparam for @p + * duration's type. The semantics of this template parameter are + * documented in `std::chrono::duration<>`. In brief, the length of the + * tick in seconds, expressed as a `std::ratio<>`. For our purposes it is + * simply a formal parameter. + * @param maximum_duration the maximum time allowed before the policy expires. + * While the application can express this time in any units they desire, + * the class truncates to milliseconds. + * + * @see https://en.cppreference.com/w/cpp/chrono/duration for more information + * about `std::chrono::duration`. + */ + template + explicit RegionInstanceGroupManagerResizeRequestsLimitedTimeRetryPolicy( + std::chrono::duration maximum_duration) + : impl_(maximum_duration) {} + + RegionInstanceGroupManagerResizeRequestsLimitedTimeRetryPolicy( + RegionInstanceGroupManagerResizeRequestsLimitedTimeRetryPolicy&& + rhs) noexcept + : RegionInstanceGroupManagerResizeRequestsLimitedTimeRetryPolicy( + rhs.maximum_duration()) {} + RegionInstanceGroupManagerResizeRequestsLimitedTimeRetryPolicy( + RegionInstanceGroupManagerResizeRequestsLimitedTimeRetryPolicy const& + rhs) noexcept + : RegionInstanceGroupManagerResizeRequestsLimitedTimeRetryPolicy( + rhs.maximum_duration()) {} + + std::chrono::milliseconds maximum_duration() const { + return impl_.maximum_duration(); + } + + bool OnFailure(Status const& status) override { + return impl_.OnFailure(status); + } + bool IsExhausted() const override { return impl_.IsExhausted(); } + bool IsPermanentFailure(Status const& status) const override { + return impl_.IsPermanentFailure(status); + } + std::unique_ptr clone() + const override { + return std::make_unique< + RegionInstanceGroupManagerResizeRequestsLimitedTimeRetryPolicy>( + maximum_duration()); + } + + // This is provided only for backwards compatibility. + using BaseType = RegionInstanceGroupManagerResizeRequestsRetryPolicy; + + private: + google::cloud::internal::LimitedTimeRetryPolicy< + compute_region_instance_group_manager_resize_requests_v1_internal:: + RegionInstanceGroupManagerResizeRequestsRetryTraits> + impl_; +}; + +/** + * The `RegionInstanceGroupManagerResizeRequestsConnection` object for + * `RegionInstanceGroupManagerResizeRequestsClient`. + * + * This interface defines virtual methods for each of the user-facing overload + * sets in `RegionInstanceGroupManagerResizeRequestsClient`. This allows users + * to inject custom behavior (e.g., with a Google Mock object) when writing + * tests that use objects of type + * `RegionInstanceGroupManagerResizeRequestsClient`. + * + * To create a concrete instance, see + * `MakeRegionInstanceGroupManagerResizeRequestsConnection()`. + * + * For mocking, see + * `compute_region_instance_group_manager_resize_requests_v1_mocks::MockRegionInstanceGroupManagerResizeRequestsConnection`. + */ +class RegionInstanceGroupManagerResizeRequestsConnection { + public: + virtual ~RegionInstanceGroupManagerResizeRequestsConnection() = 0; + + virtual Options options() { return Options{}; } + + virtual future> Cancel( + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + CancelRequest const& request); + + virtual StatusOr Cancel( + NoAwaitTag, google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + CancelRequest const& request); + + virtual future> Cancel( + google::cloud::cpp::compute::v1::Operation const& operation); + + virtual future> + DeleteInstanceGroupManagerResizeRequest( + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + DeleteInstanceGroupManagerResizeRequestRequest const& request); + + virtual StatusOr + DeleteInstanceGroupManagerResizeRequest( + NoAwaitTag, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + DeleteInstanceGroupManagerResizeRequestRequest const& request); + + virtual future> + DeleteInstanceGroupManagerResizeRequest( + google::cloud::cpp::compute::v1::Operation const& operation); + + virtual StatusOr< + google::cloud::cpp::compute::v1::InstanceGroupManagerResizeRequest> + GetInstanceGroupManagerResizeRequest( + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + GetInstanceGroupManagerResizeRequestRequest const& request); + + virtual future> + InsertInstanceGroupManagerResizeRequest( + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + InsertInstanceGroupManagerResizeRequestRequest const& request); + + virtual StatusOr + InsertInstanceGroupManagerResizeRequest( + NoAwaitTag, + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + InsertInstanceGroupManagerResizeRequestRequest const& request); + + virtual future> + InsertInstanceGroupManagerResizeRequest( + google::cloud::cpp::compute::v1::Operation const& operation); + + virtual StreamRange< + google::cloud::cpp::compute::v1::InstanceGroupManagerResizeRequest> + ListRegionInstanceGroupManagerResizeRequests( + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + ListRegionInstanceGroupManagerResizeRequestsRequest request); +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_instance_group_manager_resize_requests_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_V1_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_CONNECTION_H diff --git a/google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests_connection_idempotency_policy.cc b/google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests_connection_idempotency_policy.cc new file mode 100644 index 0000000000000..503822600d2a4 --- /dev/null +++ b/google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests_connection_idempotency_policy.cc @@ -0,0 +1,96 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests.proto + +#include "google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests_connection_idempotency_policy.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_instance_group_manager_resize_requests_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +using ::google::cloud::Idempotency; + +RegionInstanceGroupManagerResizeRequestsConnectionIdempotencyPolicy:: + ~RegionInstanceGroupManagerResizeRequestsConnectionIdempotencyPolicy() = + default; + +std::unique_ptr< + RegionInstanceGroupManagerResizeRequestsConnectionIdempotencyPolicy> +RegionInstanceGroupManagerResizeRequestsConnectionIdempotencyPolicy::clone() + const { + return std::make_unique< + RegionInstanceGroupManagerResizeRequestsConnectionIdempotencyPolicy>( + *this); +} + +Idempotency +RegionInstanceGroupManagerResizeRequestsConnectionIdempotencyPolicy::Cancel( + google::cloud::cpp::compute::region_instance_group_manager_resize_requests:: + v1::CancelRequest const&) { + return Idempotency::kNonIdempotent; +} + +Idempotency +RegionInstanceGroupManagerResizeRequestsConnectionIdempotencyPolicy:: + DeleteInstanceGroupManagerResizeRequest( + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + DeleteInstanceGroupManagerResizeRequestRequest const&) { + return Idempotency::kNonIdempotent; +} + +Idempotency +RegionInstanceGroupManagerResizeRequestsConnectionIdempotencyPolicy:: + GetInstanceGroupManagerResizeRequest( + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + GetInstanceGroupManagerResizeRequestRequest const&) { + return Idempotency::kIdempotent; +} + +Idempotency +RegionInstanceGroupManagerResizeRequestsConnectionIdempotencyPolicy:: + InsertInstanceGroupManagerResizeRequest( + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + InsertInstanceGroupManagerResizeRequestRequest const&) { + return Idempotency::kNonIdempotent; +} + +Idempotency +RegionInstanceGroupManagerResizeRequestsConnectionIdempotencyPolicy:: + ListRegionInstanceGroupManagerResizeRequests( + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + ListRegionInstanceGroupManagerResizeRequestsRequest) { // NOLINT + return Idempotency::kIdempotent; +} + +std::unique_ptr< + RegionInstanceGroupManagerResizeRequestsConnectionIdempotencyPolicy> +MakeDefaultRegionInstanceGroupManagerResizeRequestsConnectionIdempotencyPolicy() { + return std::make_unique< + RegionInstanceGroupManagerResizeRequestsConnectionIdempotencyPolicy>(); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_instance_group_manager_resize_requests_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests_connection_idempotency_policy.h b/google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests_connection_idempotency_policy.h new file mode 100644 index 0000000000000..25476b718e81c --- /dev/null +++ b/google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests_connection_idempotency_policy.h @@ -0,0 +1,78 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_V1_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_CONNECTION_IDEMPOTENCY_POLICY_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_V1_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_CONNECTION_IDEMPOTENCY_POLICY_H + +#include "google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests.pb.h" +#include "google/cloud/idempotency.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_instance_group_manager_resize_requests_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class RegionInstanceGroupManagerResizeRequestsConnectionIdempotencyPolicy { + public: + virtual ~RegionInstanceGroupManagerResizeRequestsConnectionIdempotencyPolicy(); + + /// Create a new copy of this object. + virtual std::unique_ptr< + RegionInstanceGroupManagerResizeRequestsConnectionIdempotencyPolicy> + clone() const; + + virtual google::cloud::Idempotency Cancel( + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + CancelRequest const& request); + + virtual google::cloud::Idempotency DeleteInstanceGroupManagerResizeRequest( + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + DeleteInstanceGroupManagerResizeRequestRequest const& request); + + virtual google::cloud::Idempotency GetInstanceGroupManagerResizeRequest( + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + GetInstanceGroupManagerResizeRequestRequest const& request); + + virtual google::cloud::Idempotency InsertInstanceGroupManagerResizeRequest( + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + InsertInstanceGroupManagerResizeRequestRequest const& request); + + virtual google::cloud::Idempotency + ListRegionInstanceGroupManagerResizeRequests( + google::cloud::cpp::compute:: + region_instance_group_manager_resize_requests::v1:: + ListRegionInstanceGroupManagerResizeRequestsRequest request); +}; + +std::unique_ptr< + RegionInstanceGroupManagerResizeRequestsConnectionIdempotencyPolicy> +MakeDefaultRegionInstanceGroupManagerResizeRequestsConnectionIdempotencyPolicy(); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_instance_group_manager_resize_requests_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_V1_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_CONNECTION_IDEMPOTENCY_POLICY_H diff --git a/google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests_options.h b/google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests_options.h new file mode 100644 index 0000000000000..0146ab87ea3c9 --- /dev/null +++ b/google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests_options.h @@ -0,0 +1,91 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_V1_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_OPTIONS_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_V1_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_OPTIONS_H + +#include "google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests_connection.h" +#include "google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests_connection_idempotency_policy.h" +#include "google/cloud/backoff_policy.h" +#include "google/cloud/options.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_instance_group_manager_resize_requests_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/** + * Use with `google::cloud::Options` to configure the retry policy. + * + * @ingroup google-cloud-compute-options + */ +struct RegionInstanceGroupManagerResizeRequestsRetryPolicyOption { + using Type = + std::shared_ptr; +}; + +/** + * Use with `google::cloud::Options` to configure the backoff policy. + * + * @ingroup google-cloud-compute-options + */ +struct RegionInstanceGroupManagerResizeRequestsBackoffPolicyOption { + using Type = std::shared_ptr; +}; + +/** + * Use with `google::cloud::Options` to configure which operations are retried. + * + * @ingroup google-cloud-compute-options + */ +struct + RegionInstanceGroupManagerResizeRequestsConnectionIdempotencyPolicyOption { + using Type = std::shared_ptr< + RegionInstanceGroupManagerResizeRequestsConnectionIdempotencyPolicy>; +}; + +/** + * Use with `google::cloud::Options` to configure the long-running operations + * polling policy. + * + * @ingroup google-cloud-compute-options + */ +struct RegionInstanceGroupManagerResizeRequestsPollingPolicyOption { + using Type = std::shared_ptr; +}; + +/** + * The options applicable to RegionInstanceGroupManagerResizeRequests. + * + * @ingroup google-cloud-compute-options + */ +using RegionInstanceGroupManagerResizeRequestsPolicyOptionList = OptionList< + RegionInstanceGroupManagerResizeRequestsRetryPolicyOption, + RegionInstanceGroupManagerResizeRequestsBackoffPolicyOption, + RegionInstanceGroupManagerResizeRequestsPollingPolicyOption, + RegionInstanceGroupManagerResizeRequestsConnectionIdempotencyPolicyOption>; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_instance_group_manager_resize_requests_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_V1_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_OPTIONS_H diff --git a/google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests_proto_export.h b/google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests_proto_export.h new file mode 100644 index 0000000000000..51c53bd856882 --- /dev/null +++ b/google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests_proto_export.h @@ -0,0 +1,36 @@ +// Copyright 2026 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_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_V1_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_PROTO_EXPORT_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_V1_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_PROTO_EXPORT_H + +// IWYU pragma: begin_exports +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_038.pb.h" +#include "google/cloud/compute/v1/internal/common_076.pb.h" +#include "google/cloud/compute/v1/internal/common_110.pb.h" +#include "google/cloud/compute/v1/internal/common_122.pb.h" +// IWYU pragma: end_exports + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_V1_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_PROTO_EXPORT_H diff --git a/google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests_rest_connection.cc b/google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests_rest_connection.cc new file mode 100644 index 0000000000000..63889383b8d0f --- /dev/null +++ b/google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests_rest_connection.cc @@ -0,0 +1,65 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests.proto + +#include "google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests_rest_connection.h" +#include "google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_option_defaults.h" +#include "google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_rest_connection_impl.h" +#include "google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_rest_stub_factory.h" +#include "google/cloud/compute/region_instance_group_manager_resize_requests/v1/internal/region_instance_group_manager_resize_requests_tracing_connection.h" +#include "google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests_options.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/internal/rest_background_threads_impl.h" +#include "google/cloud/internal/rest_options.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_instance_group_manager_resize_requests_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +std::shared_ptr +MakeRegionInstanceGroupManagerResizeRequestsConnectionRest(Options options) { + internal::CheckExpectedOptions< + CommonOptionList, RestOptionList, UnifiedCredentialsOptionList, + rest_internal::TargetApiVersionOption, + RegionInstanceGroupManagerResizeRequestsPolicyOptionList>(options, + __func__); + options = compute_region_instance_group_manager_resize_requests_v1_internal:: + RegionInstanceGroupManagerResizeRequestsDefaultOptions( + std::move(options)); + auto background = std::make_unique< + rest_internal::AutomaticallyCreatedRestBackgroundThreads>(); + auto stub = + compute_region_instance_group_manager_resize_requests_v1_internal:: + CreateDefaultRegionInstanceGroupManagerResizeRequestsRestStub( + options); + return compute_region_instance_group_manager_resize_requests_v1_internal:: + MakeRegionInstanceGroupManagerResizeRequestsTracingConnection( + std::make_shared< + compute_region_instance_group_manager_resize_requests_v1_internal:: + RegionInstanceGroupManagerResizeRequestsRestConnectionImpl>( + std::move(background), std::move(stub), std::move(options))); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_instance_group_manager_resize_requests_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests_rest_connection.h b/google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests_rest_connection.h new file mode 100644 index 0000000000000..a9741466ae9ff --- /dev/null +++ b/google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests_rest_connection.h @@ -0,0 +1,70 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_V1_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_REST_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_V1_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_REST_CONNECTION_H + +#include "google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests_connection.h" +#include "google/cloud/options.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_instance_group_manager_resize_requests_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/** + * A factory function to construct an object of type + * `RegionInstanceGroupManagerResizeRequestsConnection` that uses REST over HTTP + * as transport in lieu of gRPC. REST transport should only be used for services + * that do not support gRPC or if the existing network configuration precludes + * using gRPC. + * + * The returned connection object should not be used directly; instead it + * should be passed as an argument to the constructor of + * RegionInstanceGroupManagerResizeRequestsClient. + * + * The optional @p options argument may be used to configure aspects of the + * returned `RegionInstanceGroupManagerResizeRequestsConnection`. Expected + * options are any of the types in the following option lists: + * + * - `google::cloud::CommonOptionList` + * - `google::cloud::RestOptionList` + * - `google::cloud::UnifiedCredentialsOptionList` + * - + * `google::cloud::compute_region_instance_group_manager_resize_requests_v1::RegionInstanceGroupManagerResizeRequestsPolicyOptionList` + * + * @note Unexpected options will be ignored. To log unexpected options instead, + * set `GOOGLE_CLOUD_CPP_ENABLE_CLOG=yes` in the environment. + * + * @param options (optional) Configure the + * `RegionInstanceGroupManagerResizeRequestsConnection` created by this + * function. + */ +std::shared_ptr +MakeRegionInstanceGroupManagerResizeRequestsConnectionRest( + Options options = {}); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_instance_group_manager_resize_requests_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_V1_REGION_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_REST_CONNECTION_H diff --git a/google/cloud/compute/region_instance_group_manager_resize_requests/v1/samples/region_instance_group_manager_resize_requests_client_samples.cc b/google/cloud/compute/region_instance_group_manager_resize_requests/v1/samples/region_instance_group_manager_resize_requests_client_samples.cc new file mode 100644 index 0000000000000..10a7a17d0ec49 --- /dev/null +++ b/google/cloud/compute/region_instance_group_manager_resize_requests/v1/samples/region_instance_group_manager_resize_requests_client_samples.cc @@ -0,0 +1,278 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests.proto + +#include "google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests_client.h" +#include "google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests_connection_idempotency_policy.h" +#include "google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests_options.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/internal/getenv.h" +#include "google/cloud/polling_policy.h" +#include "google/cloud/testing_util/example_driver.h" +#include "google/cloud/universe_domain.h" +#include +#include +#include +#include + +// clang-format off +// main-dox-marker: compute_region_instance_group_manager_resize_requests_v1::RegionInstanceGroupManagerResizeRequestsClient +// lro-marker: true +// clang-format on +namespace { + +void SetClientEndpoint(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-endpoint"}; + } + //! [set-client-endpoint] + // This configuration is common with Private Google Access: + // https://cloud.google.com/vpc/docs/private-google-access + auto options = google::cloud::Options{}.set( + "private.googleapis.com"); + auto vpc_client = + google::cloud::compute_region_instance_group_manager_resize_requests_v1:: + RegionInstanceGroupManagerResizeRequestsClient( + google::cloud:: + compute_region_instance_group_manager_resize_requests_v1:: + MakeRegionInstanceGroupManagerResizeRequestsConnectionRest( + options)); + //! [set-client-endpoint] +} + +void SetClientUniverseDomain(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-universe-domain"}; + } + //! [set-client-universe-domain] + google::cloud::Options options; + + // AddUniverseDomainOption interrogates the UnifiedCredentialsOption, if set, + // in the provided Options for the Universe Domain associated with the + // credentials and adds it to the set of Options. + // If no UnifiedCredentialsOption is set, GoogleDefaultCredentials are used. + auto ud_options = google::cloud::AddUniverseDomainOption(std::move(options)); + + if (!ud_options.ok()) throw std::move(ud_options).status(); + auto ud_client = + google::cloud::compute_region_instance_group_manager_resize_requests_v1:: + RegionInstanceGroupManagerResizeRequestsClient( + google::cloud:: + compute_region_instance_group_manager_resize_requests_v1:: + MakeRegionInstanceGroupManagerResizeRequestsConnectionRest( + *ud_options)); + //! [set-client-universe-domain] +} + +//! [custom-idempotency-policy] +class CustomIdempotencyPolicy + : public google::cloud:: + compute_region_instance_group_manager_resize_requests_v1:: + RegionInstanceGroupManagerResizeRequestsConnectionIdempotencyPolicy { + public: + ~CustomIdempotencyPolicy() override = default; + std::unique_ptr< + google::cloud::compute_region_instance_group_manager_resize_requests_v1:: + RegionInstanceGroupManagerResizeRequestsConnectionIdempotencyPolicy> + clone() const override { + return std::make_unique(*this); + } + // Override inherited functions to define as needed. +}; +//! [custom-idempotency-policy] + +void SetRetryPolicy(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-retry-policy"}; + } + //! [set-retry-policy] + auto options = + google::cloud::Options{} + .set< + google::cloud::compute_region_instance_group_manager_resize_requests_v1:: + RegionInstanceGroupManagerResizeRequestsConnectionIdempotencyPolicyOption>( + CustomIdempotencyPolicy().clone()) + .set< + google::cloud:: + compute_region_instance_group_manager_resize_requests_v1:: + RegionInstanceGroupManagerResizeRequestsRetryPolicyOption>( + google::cloud:: + compute_region_instance_group_manager_resize_requests_v1:: + RegionInstanceGroupManagerResizeRequestsLimitedErrorCountRetryPolicy( + 3) + .clone()) + .set< + google::cloud:: + compute_region_instance_group_manager_resize_requests_v1:: + RegionInstanceGroupManagerResizeRequestsBackoffPolicyOption>( + google::cloud::ExponentialBackoffPolicy( + /*initial_delay=*/std::chrono::milliseconds(200), + /*maximum_delay=*/std::chrono::seconds(45), + /*scaling=*/2.0) + .clone()); + auto connection = + google::cloud::compute_region_instance_group_manager_resize_requests_v1:: + MakeRegionInstanceGroupManagerResizeRequestsConnectionRest(options); + + // c1 and c2 share the same retry policies + auto c1 = + google::cloud::compute_region_instance_group_manager_resize_requests_v1:: + RegionInstanceGroupManagerResizeRequestsClient(connection); + auto c2 = + google::cloud::compute_region_instance_group_manager_resize_requests_v1:: + RegionInstanceGroupManagerResizeRequestsClient(connection); + + // You can override any of the policies in a new client. This new client + // will share the policies from c1 (or c2) *except* for the retry policy. + auto c3 = google::cloud::compute_region_instance_group_manager_resize_requests_v1:: + RegionInstanceGroupManagerResizeRequestsClient( + connection, + google::cloud::Options{} + .set< + google::cloud:: + compute_region_instance_group_manager_resize_requests_v1:: + RegionInstanceGroupManagerResizeRequestsRetryPolicyOption>( + google::cloud:: + compute_region_instance_group_manager_resize_requests_v1:: + RegionInstanceGroupManagerResizeRequestsLimitedTimeRetryPolicy( + std::chrono::minutes(5)) + .clone())); + + // You can also override the policies in a single call: + // c3.SomeRpc(..., google::cloud::Options{} + // .set( + // google::cloud::compute_region_instance_group_manager_resize_requests_v1::RegionInstanceGroupManagerResizeRequestsLimitedErrorCountRetryPolicy(10).clone())); + //! [set-retry-policy] +} + +void SetPollingPolicy(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-policy-policy"}; + } + //! [set-polling-policy] + + // The polling policy controls how the client waits for long-running + // operations. `GenericPollingPolicy<>` combines existing policies. + // In this case, keep polling until the operation completes (with success + // or error) or 45 minutes, whichever happens first. Initially pause for + // 10 seconds between polling requests, increasing the pause by a factor + // of 4 until it becomes 2 minutes. + auto options = + google::cloud::Options{} + .set< + google::cloud:: + compute_region_instance_group_manager_resize_requests_v1:: + RegionInstanceGroupManagerResizeRequestsPollingPolicyOption>( + google::cloud::GenericPollingPolicy< + google::cloud:: + compute_region_instance_group_manager_resize_requests_v1:: + RegionInstanceGroupManagerResizeRequestsRetryPolicyOption:: + Type, + google::cloud:: + compute_region_instance_group_manager_resize_requests_v1:: + RegionInstanceGroupManagerResizeRequestsBackoffPolicyOption:: + Type>( + google::cloud:: + compute_region_instance_group_manager_resize_requests_v1:: + RegionInstanceGroupManagerResizeRequestsLimitedTimeRetryPolicy( + /*maximum_duration=*/std::chrono::minutes(45)) + .clone(), + google::cloud::ExponentialBackoffPolicy( + /*initial_delay=*/std::chrono::seconds(10), + /*maximum_delay=*/std::chrono::minutes(2), + /*scaling=*/4.0) + .clone()) + .clone()); + + auto connection = + google::cloud::compute_region_instance_group_manager_resize_requests_v1:: + MakeRegionInstanceGroupManagerResizeRequestsConnectionRest(options); + + // c1 and c2 share the same polling policies. + auto c1 = + google::cloud::compute_region_instance_group_manager_resize_requests_v1:: + RegionInstanceGroupManagerResizeRequestsClient(connection); + auto c2 = + google::cloud::compute_region_instance_group_manager_resize_requests_v1:: + RegionInstanceGroupManagerResizeRequestsClient(connection); + //! [set-polling-policy] +} + +void WithServiceAccount(std::vector const& argv) { + if (argv.size() != 1 || argv[0] == "--help") { + throw google::cloud::testing_util::Usage{"with-service-account "}; + } + //! [with-service-account] + [](std::string const& keyfile) { + auto is = std::ifstream(keyfile); + is.exceptions(std::ios::badbit); // Minimal error handling in examples + auto contents = std::string(std::istreambuf_iterator(is.rdbuf()), {}); + auto options = + google::cloud::Options{}.set( + google::cloud::MakeServiceAccountCredentials(contents)); + return google::cloud:: + compute_region_instance_group_manager_resize_requests_v1:: + RegionInstanceGroupManagerResizeRequestsClient( + google::cloud:: + compute_region_instance_group_manager_resize_requests_v1:: + MakeRegionInstanceGroupManagerResizeRequestsConnectionRest( + options)); + } + //! [with-service-account] + (argv.at(0)); +} + +void AutoRun(std::vector const& argv) { + namespace examples = ::google::cloud::testing_util; + using ::google::cloud::internal::GetEnv; + if (!argv.empty()) throw examples::Usage{"auto"}; + examples::CheckEnvironmentVariablesAreSet( + {"GOOGLE_CLOUD_CPP_TEST_SERVICE_ACCOUNT_KEYFILE"}); + auto const keyfile = + GetEnv("GOOGLE_CLOUD_CPP_TEST_SERVICE_ACCOUNT_KEYFILE").value(); + + std::cout << "\nRunning SetClientEndpoint() example" << std::endl; + SetClientEndpoint({}); + + std::cout << "\nRunning SetRetryPolicy() example" << std::endl; + SetRetryPolicy({}); + + std::cout << "\nRunning SetPollingPolicy() example" << std::endl; + SetPollingPolicy({}); + + std::cout << "\nRunning WithServiceAccount() example" << std::endl; + WithServiceAccount({keyfile}); + + std::cout << "\nRunning SetClientUniverseDomain() example" << std::endl; + SetClientUniverseDomain({}); +} + +} // namespace + +int main(int argc, char* argv[]) { // NOLINT(bugprone-exception-escape) + google::cloud::testing_util::Example example({ + {"set-client-endpoint", SetClientEndpoint}, + {"set-retry-policy", SetRetryPolicy}, + {"set-polling-policy", SetPollingPolicy}, + {"with-service-account", WithServiceAccount}, + {"set-client-universe-domain", SetClientUniverseDomain}, + {"auto", AutoRun}, + }); + return example.Run(argc, argv); +} diff --git a/google/cloud/compute/region_instance_group_managers/v1/internal/region_instance_group_managers_rest_stub.cc b/google/cloud/compute/region_instance_group_managers/v1/internal/region_instance_group_managers_rest_stub.cc index 298543db9c1d5..d4fb9eaff1259 100644 --- a/google/cloud/compute/region_instance_group_managers/v1/internal/region_instance_group_managers_rest_stub.cc +++ b/google/cloud/compute/region_instance_group_managers/v1/internal/region_instance_group_managers_rest_stub.cc @@ -248,6 +248,8 @@ DefaultRegionInstanceGroupManagersRestStub::AsyncDeleteInstanceGroupManager( std::thread t{ [](auto p, auto service, auto request, auto rest_context, auto options) { std::vector> query_params; + query_params.push_back({"no_graceful_shutdown", + (request.no_graceful_shutdown() ? "1" : "0")}); query_params.push_back({"request_id", request.request_id()}); query_params = rest_internal::TrimEmptyQueryParameters(std::move(query_params)); @@ -280,6 +282,8 @@ DefaultRegionInstanceGroupManagersRestStub::DeleteInstanceGroupManager( google::cloud::cpp::compute::region_instance_group_managers::v1:: DeleteInstanceGroupManagerRequest const& request) { std::vector> query_params; + query_params.push_back( + {"no_graceful_shutdown", (request.no_graceful_shutdown() ? "1" : "0")}); query_params.push_back({"request_id", request.request_id()}); query_params = rest_internal::TrimEmptyQueryParameters(std::move(query_params)); @@ -306,6 +310,8 @@ DefaultRegionInstanceGroupManagersRestStub::AsyncDeleteInstances( std::thread t{ [](auto p, auto service, auto request, auto rest_context, auto options) { std::vector> query_params; + query_params.push_back({"no_graceful_shutdown", + (request.no_graceful_shutdown() ? "1" : "0")}); query_params.push_back({"request_id", request.request_id()}); query_params = rest_internal::TrimEmptyQueryParameters(std::move(query_params)); @@ -341,6 +347,8 @@ DefaultRegionInstanceGroupManagersRestStub::DeleteInstances( google::cloud::cpp::compute::region_instance_group_managers::v1:: DeleteInstancesRequest const& request) { std::vector> query_params; + query_params.push_back( + {"no_graceful_shutdown", (request.no_graceful_shutdown() ? "1" : "0")}); query_params.push_back({"request_id", request.request_id()}); query_params = rest_internal::TrimEmptyQueryParameters(std::move(query_params)); @@ -726,6 +734,8 @@ DefaultRegionInstanceGroupManagersRestStub::AsyncRecreateInstances( std::thread t{ [](auto p, auto service, auto request, auto rest_context, auto options) { std::vector> query_params; + query_params.push_back({"no_graceful_shutdown", + (request.no_graceful_shutdown() ? "1" : "0")}); query_params.push_back({"request_id", request.request_id()}); query_params = rest_internal::TrimEmptyQueryParameters(std::move(query_params)); @@ -761,6 +771,8 @@ DefaultRegionInstanceGroupManagersRestStub::RecreateInstances( google::cloud::cpp::compute::region_instance_group_managers::v1:: RecreateInstancesRequest const& request) { std::vector> query_params; + query_params.push_back( + {"no_graceful_shutdown", (request.no_graceful_shutdown() ? "1" : "0")}); query_params.push_back({"request_id", request.request_id()}); query_params = rest_internal::TrimEmptyQueryParameters(std::move(query_params)); @@ -1095,6 +1107,8 @@ DefaultRegionInstanceGroupManagersRestStub::AsyncStopInstances( std::thread t{ [](auto p, auto service, auto request, auto rest_context, auto options) { std::vector> query_params; + query_params.push_back({"no_graceful_shutdown", + (request.no_graceful_shutdown() ? "1" : "0")}); query_params.push_back({"request_id", request.request_id()}); query_params = rest_internal::TrimEmptyQueryParameters(std::move(query_params)); @@ -1130,6 +1144,8 @@ DefaultRegionInstanceGroupManagersRestStub::StopInstances( google::cloud::cpp::compute::region_instance_group_managers::v1:: StopInstancesRequest const& request) { std::vector> query_params; + query_params.push_back( + {"no_graceful_shutdown", (request.no_graceful_shutdown() ? "1" : "0")}); query_params.push_back({"request_id", request.request_id()}); query_params = rest_internal::TrimEmptyQueryParameters(std::move(query_params)); 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 775b5943ccb76..c91a162d6d2cf 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 @@ -96,17 +96,22 @@ class RegionInstanceGroupManagersClient { // clang-format off /// /// 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. + /// 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 thetargetSize of + /// the managed instance group by the + /// number of instances that you abandon. This operation is marked asDONE 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 thelistmanagedinstances + /// 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. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroupManagers/abandonInstances /// /// @param project Project ID for this request. @@ -133,7 +138,7 @@ class RegionInstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_instance_group_managers.v1.AbandonInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L469} + /// [google.cloud.cpp.compute.region_instance_group_managers.v1.AbandonInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L530} /// // clang-format on future> AbandonInstances( @@ -166,17 +171,22 @@ class RegionInstanceGroupManagersClient { // clang-format off /// /// 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. + /// 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 thetargetSize of + /// the managed instance group by the + /// number of instances that you abandon. This operation is marked asDONE 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 thelistmanagedinstances + /// 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. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroupManagers/abandonInstances /// /// @param request Unary RPCs, such as the one wrapped by this @@ -205,7 +215,7 @@ class RegionInstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_instance_group_managers.v1.AbandonInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L469} + /// [google.cloud.cpp.compute.region_instance_group_managers.v1.AbandonInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L530} /// // clang-format on future> AbandonInstances( @@ -272,7 +282,7 @@ class RegionInstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_instance_group_managers.v1.ApplyUpdatesToInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L510} + /// [google.cloud.cpp.compute.region_instance_group_managers.v1.ApplyUpdatesToInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L574} /// // clang-format on future> @@ -334,7 +344,7 @@ class RegionInstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_instance_group_managers.v1.ApplyUpdatesToInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L510} + /// [google.cloud.cpp.compute.region_instance_group_managers.v1.ApplyUpdatesToInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L574} /// // clang-format on future> @@ -378,16 +388,19 @@ class RegionInstanceGroupManagersClient { /// /// 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. + /// 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 + /// thecreating or actions with the listmanagedinstances + /// method. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroupManagers/createInstances /// /// @param project Project ID for this request. - /// @param region The name of the region where the managed instance group is located. It - /// should conform to RFC1035. - /// @param instance_group_manager The name of the managed instance group. It should conform to RFC1035. + /// @param region The name of theregion + /// where the managed instance group is located. + /// It should conform to RFC1035. + /// @param instance_group_manager The name of the managed instance group. + /// It should conform to RFC1035. /// @param region_instance_group_managers_create_instances_request_resource The RegionInstanceGroupManagersCreateInstancesRequest for this request. /// @param opts Optional. Override the class-level options, such as retry and /// backoff policies. @@ -409,7 +422,7 @@ class RegionInstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_instance_group_managers.v1.CreateInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L539} + /// [google.cloud.cpp.compute.region_instance_group_managers.v1.CreateInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L603} /// // clang-format on future> CreateInstances( @@ -443,10 +456,11 @@ class RegionInstanceGroupManagersClient { /// /// 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. + /// 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 + /// thecreating or actions with the listmanagedinstances + /// method. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroupManagers/createInstances /// /// @param request Unary RPCs, such as the one wrapped by this @@ -475,7 +489,7 @@ class RegionInstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_instance_group_managers.v1.CreateInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L539} + /// [google.cloud.cpp.compute.region_instance_group_managers.v1.CreateInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L603} /// // clang-format on future> CreateInstances( @@ -515,8 +529,8 @@ class RegionInstanceGroupManagersClient { // clang-format off /// - /// Deletes the specified managed instance group and all of the instances in - /// that group. + /// Deletes the specified managed instance group and all of the instances + /// in that group. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroupManagers/delete /// /// @param project Project ID for this request. @@ -542,7 +556,7 @@ class RegionInstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_instance_group_managers.v1.DeleteInstanceGroupManagerRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L580} + /// [google.cloud.cpp.compute.region_instance_group_managers.v1.DeleteInstanceGroupManagerRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L649} /// // clang-format on future> @@ -570,8 +584,8 @@ class RegionInstanceGroupManagersClient { // clang-format off /// - /// Deletes the specified managed instance group and all of the instances in - /// that group. + /// Deletes the specified managed instance group and all of the instances + /// in that group. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroupManagers/delete /// /// @param request Unary RPCs, such as the one wrapped by this @@ -600,7 +614,7 @@ class RegionInstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_instance_group_managers.v1.DeleteInstanceGroupManagerRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L580} + /// [google.cloud.cpp.compute.region_instance_group_managers.v1.DeleteInstanceGroupManagerRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L649} /// // clang-format on future> @@ -644,17 +658,22 @@ class RegionInstanceGroupManagersClient { // clang-format off /// /// 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. + /// immediately deleted. The instances are also removed from any target + /// pools of which they were a member. This method reduces thetargetSize 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 + /// thedeleting action with thelistmanagedinstances + /// 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. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroupManagers/deleteInstances /// /// @param project Project ID for this request. @@ -681,7 +700,7 @@ class RegionInstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_instance_group_managers.v1.DeleteInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L615} + /// [google.cloud.cpp.compute.region_instance_group_managers.v1.DeleteInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L691} /// // clang-format on future> DeleteInstances( @@ -714,17 +733,22 @@ class RegionInstanceGroupManagersClient { // clang-format off /// /// 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. + /// immediately deleted. The instances are also removed from any target + /// pools of which they were a member. This method reduces thetargetSize 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 + /// thedeleting action with thelistmanagedinstances + /// 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. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroupManagers/deleteInstances /// /// @param request Unary RPCs, such as the one wrapped by this @@ -753,7 +777,7 @@ class RegionInstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_instance_group_managers.v1.DeleteInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L615} + /// [google.cloud.cpp.compute.region_instance_group_managers.v1.DeleteInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L691} /// // clang-format on future> DeleteInstances( @@ -821,7 +845,7 @@ class RegionInstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_instance_group_managers.v1.DeletePerInstanceConfigsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L656} + /// [google.cloud.cpp.compute.region_instance_group_managers.v1.DeletePerInstanceConfigsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L739} /// // clang-format on future> @@ -884,7 +908,7 @@ class RegionInstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_instance_group_managers.v1.DeletePerInstanceConfigsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L656} + /// [google.cloud.cpp.compute.region_instance_group_managers.v1.DeletePerInstanceConfigsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L739} /// // clang-format on future> @@ -945,8 +969,8 @@ class RegionInstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`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#L685} - /// [google.cloud.cpp.compute.v1.InstanceGroupManager]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_028.proto#L67} + /// [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#L768} + /// [google.cloud.cpp.compute.v1.InstanceGroupManager]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_037.proto#L84} /// // clang-format on StatusOr @@ -978,8 +1002,8 @@ class RegionInstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`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#L685} - /// [google.cloud.cpp.compute.v1.InstanceGroupManager]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_028.proto#L67} + /// [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#L768} + /// [google.cloud.cpp.compute.v1.InstanceGroupManager]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_037.proto#L84} /// // clang-format on StatusOr @@ -990,13 +1014,16 @@ class RegionInstanceGroupManagersClient { // clang-format off /// - /// 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. + /// 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 + /// thelistmanagedinstances + /// method. + /// + /// A regional managed instance group can contain up to 2000 instances. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroupManagers/insert /// /// @param project Project ID for this request. @@ -1022,7 +1049,7 @@ class RegionInstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_instance_group_managers.v1.InsertInstanceGroupManagerRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L702} + /// [google.cloud.cpp.compute.region_instance_group_managers.v1.InsertInstanceGroupManagerRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L785} /// // clang-format on future> @@ -1052,13 +1079,16 @@ class RegionInstanceGroupManagersClient { // clang-format off /// - /// 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. + /// 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 + /// thelistmanagedinstances + /// method. + /// + /// A regional managed instance group can contain up to 2000 instances. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroupManagers/insert /// /// @param request Unary RPCs, such as the one wrapped by this @@ -1087,7 +1117,7 @@ class RegionInstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_instance_group_managers.v1.InsertInstanceGroupManagerRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L702} + /// [google.cloud.cpp.compute.region_instance_group_managers.v1.InsertInstanceGroupManagerRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L785} /// // clang-format on future> @@ -1130,8 +1160,8 @@ class RegionInstanceGroupManagersClient { // clang-format off /// - /// Retrieves the list of managed instance groups that are contained within the - /// specified region. + /// Retrieves the list of managed instance groups that are contained + /// within the specified region. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroupManagers/list /// /// @param project Project ID for this request. @@ -1158,8 +1188,8 @@ class RegionInstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`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#L971} - /// [google.cloud.cpp.compute.v1.InstanceGroupManager]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_028.proto#L67} + /// [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#L1158} + /// [google.cloud.cpp.compute.v1.InstanceGroupManager]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_037.proto#L84} /// // clang-format on StreamRange @@ -1168,8 +1198,8 @@ class RegionInstanceGroupManagersClient { // clang-format off /// - /// Retrieves the list of managed instance groups that are contained within the - /// specified region. + /// Retrieves the list of managed instance groups that are contained + /// within the specified region. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroupManagers/list /// /// @param request Unary RPCs, such as the one wrapped by this @@ -1200,8 +1230,8 @@ class RegionInstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`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#L971} - /// [google.cloud.cpp.compute.v1.InstanceGroupManager]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_028.proto#L67} + /// [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#L1158} + /// [google.cloud.cpp.compute.v1.InstanceGroupManager]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_037.proto#L84} /// // clang-format on StreamRange @@ -1213,15 +1243,17 @@ class RegionInstanceGroupManagersClient { // clang-format off /// /// Lists all errors thrown by actions on instances for a given regional - /// managed instance group. The filter and orderBy query parameters are not + /// managed instance group. The filter andorderBy query parameters are not /// supported. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroupManagers/listErrors /// /// @param project Project ID for this request. - /// @param region Name of the region scoping this request. This should conform to RFC1035. - /// @param instance_group_manager 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}. + /// @param region Name of the region scoping this request. + /// This should conform to RFC1035. + /// @param instance_group_manager 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}. /// @param opts Optional. Override the class-level options, such as retry and /// backoff policies. /// @return a [StreamRange](@ref google::cloud::StreamRange) @@ -1244,8 +1276,8 @@ class RegionInstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`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#L735} - /// [google.cloud.cpp.compute.v1.InstanceManagedByIgmError]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_028.proto#L567} + /// [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#L821} + /// [google.cloud.cpp.compute.v1.InstanceManagedByIgmError]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_037.proto#L938} /// // clang-format on StreamRange @@ -1255,7 +1287,7 @@ class RegionInstanceGroupManagersClient { // clang-format off /// /// Lists all errors thrown by actions on instances for a given regional - /// managed instance group. The filter and orderBy query parameters are not + /// managed instance group. The filter andorderBy query parameters are not /// supported. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroupManagers/listErrors /// @@ -1287,8 +1319,8 @@ class RegionInstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`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#L735} - /// [google.cloud.cpp.compute.v1.InstanceManagedByIgmError]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_028.proto#L567} + /// [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#L821} + /// [google.cloud.cpp.compute.v1.InstanceManagedByIgmError]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_037.proto#L938} /// // clang-format on StreamRange @@ -1299,10 +1331,11 @@ class RegionInstanceGroupManagersClient { // clang-format off /// /// 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`. + /// 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`. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroupManagers/listManagedInstances /// /// @param project Project ID for this request. @@ -1321,8 +1354,8 @@ class RegionInstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`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#L815} - /// [google.cloud.cpp.compute.v1.RegionInstanceGroupManagersListInstancesResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_104.proto#L339} + /// [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#L936} + /// [google.cloud.cpp.compute.v1.RegionInstanceGroupManagersListInstancesResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_121.proto#L405} /// // clang-format on StatusOr @@ -1444,8 +1478,8 @@ class RegionInstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`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#L893} - /// [google.cloud.cpp.compute.v1.PerInstanceConfig]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_028.proto#L833} + /// [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#L1047} + /// [google.cloud.cpp.compute.v1.PerInstanceConfig]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_110.proto#L24} /// // clang-format on StreamRange @@ -1456,16 +1490,22 @@ class RegionInstanceGroupManagersClient { // clang-format off /// - /// 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 + /// 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. + /// with the listmanagedinstances + /// method. This method supportsPATCH + /// semantics and uses theJSON 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, seeUpdating + /// instances in + /// a MIG. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroupManagers/patch /// /// @param project Project ID for this request. @@ -1492,7 +1532,7 @@ class RegionInstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_instance_group_managers.v1.PatchInstanceGroupManagerRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L1043} + /// [google.cloud.cpp.compute.region_instance_group_managers.v1.PatchInstanceGroupManagerRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L1263} /// // clang-format on future> @@ -1524,16 +1564,22 @@ class RegionInstanceGroupManagersClient { // clang-format off /// - /// 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 + /// 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. + /// with the listmanagedinstances + /// method. This method supportsPATCH + /// semantics and uses theJSON 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, seeUpdating + /// instances in + /// a MIG. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroupManagers/patch /// /// @param request Unary RPCs, such as the one wrapped by this @@ -1562,7 +1608,7 @@ class RegionInstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_instance_group_managers.v1.PatchInstanceGroupManagerRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L1043} + /// [google.cloud.cpp.compute.region_instance_group_managers.v1.PatchInstanceGroupManagerRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L1263} /// // clang-format on future> @@ -1606,13 +1652,14 @@ class RegionInstanceGroupManagersClient { // clang-format off /// /// 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. + /// group. perInstanceConfig.name serves as a key used to + /// distinguish whether to perform insert or patch. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroupManagers/patchPerInstanceConfigs /// /// @param project Project ID for this request. /// @param region Name of the region scoping this request, should conform to RFC1035. - /// @param instance_group_manager The name of the managed instance group. It should conform to RFC1035. + /// @param instance_group_manager The name of the managed instance group. + /// It should conform to RFC1035. /// @param region_instance_group_manager_patch_instance_config_req_resource The RegionInstanceGroupManagerPatchInstanceConfigReq for this request. /// @param opts Optional. Override the class-level options, such as retry and /// backoff policies. @@ -1634,7 +1681,7 @@ class RegionInstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_instance_group_managers.v1.PatchPerInstanceConfigsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L1082} + /// [google.cloud.cpp.compute.region_instance_group_managers.v1.PatchPerInstanceConfigsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L1305} /// // clang-format on future> @@ -1668,8 +1715,8 @@ class RegionInstanceGroupManagersClient { // clang-format off /// /// 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. + /// group. perInstanceConfig.name serves as a key used to + /// distinguish whether to perform insert or patch. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroupManagers/patchPerInstanceConfigs /// /// @param request Unary RPCs, such as the one wrapped by this @@ -1698,7 +1745,7 @@ class RegionInstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_instance_group_managers.v1.PatchPerInstanceConfigsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L1082} + /// [google.cloud.cpp.compute.region_instance_group_managers.v1.PatchPerInstanceConfigsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L1305} /// // clang-format on future> @@ -1742,14 +1789,18 @@ class RegionInstanceGroupManagersClient { /// /// 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. + /// 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 itscurrentAction + /// 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. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroupManagers/recreateInstances /// /// @param project Project ID for this request. @@ -1776,7 +1827,7 @@ class RegionInstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_instance_group_managers.v1.RecreateInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L1123} + /// [google.cloud.cpp.compute.region_instance_group_managers.v1.RecreateInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L1350} /// // clang-format on future> @@ -1811,14 +1862,18 @@ class RegionInstanceGroupManagersClient { /// /// 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. + /// 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 itscurrentAction + /// 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. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroupManagers/recreateInstances /// /// @param request Unary RPCs, such as the one wrapped by this @@ -1847,7 +1902,7 @@ class RegionInstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_instance_group_managers.v1.RecreateInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L1123} + /// [google.cloud.cpp.compute.region_instance_group_managers.v1.RecreateInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L1350} /// // clang-format on future> @@ -1891,19 +1946,25 @@ class RegionInstanceGroupManagersClient { /// 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. + /// instances. + /// + /// The resize operation is marked DONE if theresize request is successful. The + /// underlying actions take + /// additional time. You must separately verify the status of thecreating or + /// deleting actions with thelistmanagedinstances + /// 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. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroupManagers/resize /// /// @param project Project ID for this request. /// @param region Name of the region scoping this request. /// @param instance_group_manager Name of the managed instance group. - /// @param size Number of instances that should exist in this instance group manager. + /// @param size Number of instances that should exist in this instance group + /// manager. /// @param opts Optional. Override the class-level options, such as retry and /// backoff policies. /// @return A [`future`] that becomes satisfied when the LRO @@ -1924,7 +1985,7 @@ class RegionInstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_instance_group_managers.v1.ResizeRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L1164} + /// [google.cloud.cpp.compute.region_instance_group_managers.v1.ResizeRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L1398} /// // clang-format on future> Resize( @@ -1953,13 +2014,18 @@ class RegionInstanceGroupManagersClient { /// 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. + /// instances. + /// + /// The resize operation is marked DONE if theresize request is successful. The + /// underlying actions take + /// additional time. You must separately verify the status of thecreating or + /// deleting actions with thelistmanagedinstances + /// 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. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroupManagers/resize /// /// @param request Unary RPCs, such as the one wrapped by this @@ -1988,7 +2054,7 @@ class RegionInstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_instance_group_managers.v1.ResizeRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L1164} + /// [google.cloud.cpp.compute.region_instance_group_managers.v1.ResizeRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L1398} /// // clang-format on future> Resize( @@ -2028,19 +2094,24 @@ class RegionInstanceGroupManagersClient { // clang-format off /// - /// Flags the specified instances in the managed instance group to be resumed. - /// This method increases the targetSize and decreases the targetSuspendedSize + /// Flags the specified instances in the managed instance group to be + /// resumed. This method increases thetargetSize and decreases the + /// targetSuspendedSize /// of the managed instance group by the number of instances that you resume. - /// The resumeInstances operation is marked DONE if the resumeInstances request - /// is successful. The underlying actions take additional time. You must - /// separately verify the status of the RESUMING action with the - /// listmanagedinstances method. In this request, you can only specify - /// instances that are suspended. For example, if an instance was previously - /// suspended using the suspendInstances method, it can be resumed using the - /// resumeInstances method. If a health check is attached to the managed - /// instance group, the specified instances will be verified as healthy after - /// they are resumed. You can specify a maximum of 1000 instances with this - /// method per request. + /// The resumeInstances operation is marked DONE if + /// the resumeInstances request is successful. The underlying + /// actions take additional time. You must separately verify the status of + /// theRESUMING action with thelistmanagedinstances + /// method. + /// + /// In this request, you can only specify instances that are suspended. For + /// example, if an instance was previously suspended using the suspendInstances + /// method, it can be resumed using the resumeInstances method. + /// + /// If a health check is attached to the managed instance group, the specified + /// instances will be verified as healthy after they are resumed. + /// + /// You can specify a maximum of 1000 instances with this method per request. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroupManagers/resumeInstances /// /// @param project Project ID for this request. @@ -2067,7 +2138,7 @@ class RegionInstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_instance_group_managers.v1.ResumeInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L1202} + /// [google.cloud.cpp.compute.region_instance_group_managers.v1.ResumeInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L1440} /// // clang-format on future> ResumeInstances( @@ -2099,19 +2170,24 @@ class RegionInstanceGroupManagersClient { // clang-format off /// - /// Flags the specified instances in the managed instance group to be resumed. - /// This method increases the targetSize and decreases the targetSuspendedSize + /// Flags the specified instances in the managed instance group to be + /// resumed. This method increases thetargetSize and decreases the + /// targetSuspendedSize /// of the managed instance group by the number of instances that you resume. - /// The resumeInstances operation is marked DONE if the resumeInstances request - /// is successful. The underlying actions take additional time. You must - /// separately verify the status of the RESUMING action with the - /// listmanagedinstances method. In this request, you can only specify - /// instances that are suspended. For example, if an instance was previously - /// suspended using the suspendInstances method, it can be resumed using the - /// resumeInstances method. If a health check is attached to the managed - /// instance group, the specified instances will be verified as healthy after - /// they are resumed. You can specify a maximum of 1000 instances with this - /// method per request. + /// The resumeInstances operation is marked DONE if + /// the resumeInstances request is successful. The underlying + /// actions take additional time. You must separately verify the status of + /// theRESUMING action with thelistmanagedinstances + /// method. + /// + /// In this request, you can only specify instances that are suspended. For + /// example, if an instance was previously suspended using the suspendInstances + /// method, it can be resumed using the resumeInstances method. + /// + /// If a health check is attached to the managed instance group, the specified + /// instances will be verified as healthy after they are resumed. + /// + /// You can specify a maximum of 1000 instances with this method per request. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroupManagers/resumeInstances /// /// @param request Unary RPCs, such as the one wrapped by this @@ -2140,7 +2216,7 @@ class RegionInstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_instance_group_managers.v1.ResumeInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L1202} + /// [google.cloud.cpp.compute.region_instance_group_managers.v1.ResumeInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L1440} /// // clang-format on future> ResumeInstances( @@ -2208,7 +2284,7 @@ class RegionInstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_instance_group_managers.v1.SetInstanceTemplateRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L1243} + /// [google.cloud.cpp.compute.region_instance_group_managers.v1.SetInstanceTemplateRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L1484} /// // clang-format on future> @@ -2271,7 +2347,7 @@ class RegionInstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_instance_group_managers.v1.SetInstanceTemplateRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L1243} + /// [google.cloud.cpp.compute.region_instance_group_managers.v1.SetInstanceTemplateRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L1484} /// // clang-format on future> @@ -2341,7 +2417,7 @@ class RegionInstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_instance_group_managers.v1.SetTargetPoolsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L1284} + /// [google.cloud.cpp.compute.region_instance_group_managers.v1.SetTargetPoolsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L1528} /// // clang-format on future> SetTargetPools( @@ -2403,7 +2479,7 @@ class RegionInstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_instance_group_managers.v1.SetTargetPoolsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L1284} + /// [google.cloud.cpp.compute.region_instance_group_managers.v1.SetTargetPoolsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L1528} /// // clang-format on future> SetTargetPools( @@ -2443,19 +2519,24 @@ class RegionInstanceGroupManagersClient { // clang-format off /// - /// Flags the specified instances in the managed instance group to be started. - /// This method increases the targetSize and decreases the targetStoppedSize of - /// the managed instance group by the number of instances that you start. The - /// startInstances operation is marked DONE if the startInstances request is - /// successful. The underlying actions take additional time. You must - /// separately verify the status of the STARTING action with the - /// listmanagedinstances method. In this request, you can only specify - /// instances that are stopped. For example, if an instance was previously - /// stopped using the stopInstances method, it can be started using the - /// startInstances method. If a health check is attached to the managed - /// instance group, the specified instances will be verified as healthy after - /// they are started. You can specify a maximum of 1000 instances with this - /// method per request. + /// Flags the specified instances in the managed instance group to be + /// started. This method increases thetargetSize and decreases the + /// targetStoppedSize + /// of the managed instance group by the number of instances that you start. + /// The startInstances operation is marked DONE if + /// the startInstances request is successful. The underlying + /// actions take additional time. You must separately verify the status of + /// theSTARTING action with thelistmanagedinstances + /// method. + /// + /// In this request, you can only specify instances that are stopped. For + /// example, if an instance was previously stopped using the stopInstances + /// method, it can be started using the startInstances method. + /// + /// If a health check is attached to the managed instance group, the specified + /// instances will be verified as healthy after they are started. + /// + /// You can specify a maximum of 1000 instances with this method per request. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroupManagers/startInstances /// /// @param project Project ID for this request. @@ -2482,7 +2563,7 @@ class RegionInstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_instance_group_managers.v1.StartInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L1325} + /// [google.cloud.cpp.compute.region_instance_group_managers.v1.StartInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L1572} /// // clang-format on future> StartInstances( @@ -2514,19 +2595,24 @@ class RegionInstanceGroupManagersClient { // clang-format off /// - /// Flags the specified instances in the managed instance group to be started. - /// This method increases the targetSize and decreases the targetStoppedSize of - /// the managed instance group by the number of instances that you start. The - /// startInstances operation is marked DONE if the startInstances request is - /// successful. The underlying actions take additional time. You must - /// separately verify the status of the STARTING action with the - /// listmanagedinstances method. In this request, you can only specify - /// instances that are stopped. For example, if an instance was previously - /// stopped using the stopInstances method, it can be started using the - /// startInstances method. If a health check is attached to the managed - /// instance group, the specified instances will be verified as healthy after - /// they are started. You can specify a maximum of 1000 instances with this - /// method per request. + /// Flags the specified instances in the managed instance group to be + /// started. This method increases thetargetSize and decreases the + /// targetStoppedSize + /// of the managed instance group by the number of instances that you start. + /// The startInstances operation is marked DONE if + /// the startInstances request is successful. The underlying + /// actions take additional time. You must separately verify the status of + /// theSTARTING action with thelistmanagedinstances + /// method. + /// + /// In this request, you can only specify instances that are stopped. For + /// example, if an instance was previously stopped using the stopInstances + /// method, it can be started using the startInstances method. + /// + /// If a health check is attached to the managed instance group, the specified + /// instances will be verified as healthy after they are started. + /// + /// You can specify a maximum of 1000 instances with this method per request. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroupManagers/startInstances /// /// @param request Unary RPCs, such as the one wrapped by this @@ -2555,7 +2641,7 @@ class RegionInstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_instance_group_managers.v1.StartInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L1325} + /// [google.cloud.cpp.compute.region_instance_group_managers.v1.StartInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L1572} /// // clang-format on future> StartInstances( @@ -2597,22 +2683,33 @@ class RegionInstanceGroupManagersClient { /// /// Flags the specified instances in the managed instance group to be /// immediately stopped. You can only specify instances that are running in - /// this request. This method reduces the targetSize and increases the - /// targetStoppedSize of the managed instance group by the number of instances - /// that you stop. The stopInstances operation is marked DONE if the - /// stopInstances request is successful. The underlying actions take additional - /// time. You must separately verify the status of the STOPPING action with the - /// listmanagedinstances method. If the standbyPolicy.initialDelaySec field is - /// set, the group delays stopping the instances until initialDelaySec have - /// passed from instance.creationTimestamp (that is, when the instance was - /// created). This delay gives your application time to set itself up and - /// initialize on the instance. If more than initialDelaySec seconds have - /// passed since instance.creationTimestamp when this method is called, there - /// will be zero delay. 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 stopped. - /// Stopped instances can be started using the startInstances method. You can - /// specify a maximum of 1000 instances with this method per request. + /// this request. This method reduces thetargetSize and increases the + /// targetStoppedSize + /// of the managed instance group by the number of instances that you stop. + /// The stopInstances operation is marked DONE if + /// the stopInstances request is successful. The underlying + /// actions take additional time. You must separately verify the status of + /// theSTOPPING action with thelistmanagedinstances + /// method. + /// + /// If the standbyPolicy.initialDelaySec field is set, the group + /// delays stopping the instances until initialDelaySec have + /// passed from instance.creationTimestamp (that is, when the + /// instance was created). This delay gives your application time to + /// set itself up and initialize on the instance. If more thaninitialDelaySec + /// seconds have passed sinceinstance.creationTimestamp when this method is + /// called, there + /// will be zero delay. + /// + /// 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 stopped. + /// + /// Stopped instances can be started using the startInstances + /// method. + /// + /// You can specify a maximum of 1000 instances with this method per request. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroupManagers/stopInstances /// /// @param project Project ID for this request. @@ -2639,7 +2736,7 @@ class RegionInstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_instance_group_managers.v1.StopInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L1366} + /// [google.cloud.cpp.compute.region_instance_group_managers.v1.StopInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L1616} /// // clang-format on future> StopInstances( @@ -2673,22 +2770,33 @@ class RegionInstanceGroupManagersClient { /// /// Flags the specified instances in the managed instance group to be /// immediately stopped. You can only specify instances that are running in - /// this request. This method reduces the targetSize and increases the - /// targetStoppedSize of the managed instance group by the number of instances - /// that you stop. The stopInstances operation is marked DONE if the - /// stopInstances request is successful. The underlying actions take additional - /// time. You must separately verify the status of the STOPPING action with the - /// listmanagedinstances method. If the standbyPolicy.initialDelaySec field is - /// set, the group delays stopping the instances until initialDelaySec have - /// passed from instance.creationTimestamp (that is, when the instance was - /// created). This delay gives your application time to set itself up and - /// initialize on the instance. If more than initialDelaySec seconds have - /// passed since instance.creationTimestamp when this method is called, there - /// will be zero delay. 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 stopped. - /// Stopped instances can be started using the startInstances method. You can - /// specify a maximum of 1000 instances with this method per request. + /// this request. This method reduces thetargetSize and increases the + /// targetStoppedSize + /// of the managed instance group by the number of instances that you stop. + /// The stopInstances operation is marked DONE if + /// the stopInstances request is successful. The underlying + /// actions take additional time. You must separately verify the status of + /// theSTOPPING action with thelistmanagedinstances + /// method. + /// + /// If the standbyPolicy.initialDelaySec field is set, the group + /// delays stopping the instances until initialDelaySec have + /// passed from instance.creationTimestamp (that is, when the + /// instance was created). This delay gives your application time to + /// set itself up and initialize on the instance. If more thaninitialDelaySec + /// seconds have passed sinceinstance.creationTimestamp when this method is + /// called, there + /// will be zero delay. + /// + /// 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 stopped. + /// + /// Stopped instances can be started using the startInstances + /// method. + /// + /// You can specify a maximum of 1000 instances with this method per request. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroupManagers/stopInstances /// /// @param request Unary RPCs, such as the one wrapped by this @@ -2717,7 +2825,7 @@ class RegionInstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_instance_group_managers.v1.StopInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L1366} + /// [google.cloud.cpp.compute.region_instance_group_managers.v1.StopInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L1616} /// // clang-format on future> StopInstances( @@ -2759,23 +2867,33 @@ class RegionInstanceGroupManagersClient { /// /// Flags the specified instances in the managed instance group to be /// immediately suspended. You can only specify instances that are running in - /// this request. This method reduces the targetSize and increases the - /// targetSuspendedSize of the managed instance group by the number of - /// instances that you suspend. The suspendInstances operation is marked DONE - /// if the suspendInstances request is successful. The underlying actions take - /// additional time. You must separately verify the status of the SUSPENDING - /// action with the listmanagedinstances method. If the - /// standbyPolicy.initialDelaySec field is set, the group delays suspension of - /// the instances until initialDelaySec have passed from - /// instance.creationTimestamp (that is, when the instance was created). This - /// delay gives your application time to set itself up and initialize on the - /// instance. If more than initialDelaySec seconds have passed since - /// instance.creationTimestamp when this method is called, there will be zero - /// delay. If the group is part of a backend service that has enabled + /// this request. This method reduces thetargetSize and increases the + /// targetSuspendedSize + /// of the managed instance group by the number of instances that you suspend. + /// The suspendInstances operation is marked DONE if + /// the suspendInstances request is successful. The underlying + /// actions take additional time. You must separately verify the status of + /// theSUSPENDING action with thelistmanagedinstances + /// method. + /// + /// If the standbyPolicy.initialDelaySec field is set, the group + /// delays suspension of the instances until initialDelaySec have + /// passed from instance.creationTimestamp (that is, when the + /// instance was created). This delay gives your application time to + /// set itself up and initialize on the instance. If more thaninitialDelaySec + /// seconds have passed sinceinstance.creationTimestamp when this method is + /// called, there + /// will be zero delay. + /// + /// 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 suspended. - /// Suspended instances can be resumed using the resumeInstances method. You - /// can specify a maximum of 1000 instances with this method per request. + /// + /// Suspended instances can be resumed using the resumeInstances + /// method. + /// + /// You can specify a maximum of 1000 instances with this method per request. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroupManagers/suspendInstances /// /// @param project Project ID for this request. @@ -2802,7 +2920,7 @@ class RegionInstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_instance_group_managers.v1.SuspendInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L1407} + /// [google.cloud.cpp.compute.region_instance_group_managers.v1.SuspendInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L1664} /// // clang-format on future> SuspendInstances( @@ -2836,23 +2954,33 @@ class RegionInstanceGroupManagersClient { /// /// Flags the specified instances in the managed instance group to be /// immediately suspended. You can only specify instances that are running in - /// this request. This method reduces the targetSize and increases the - /// targetSuspendedSize of the managed instance group by the number of - /// instances that you suspend. The suspendInstances operation is marked DONE - /// if the suspendInstances request is successful. The underlying actions take - /// additional time. You must separately verify the status of the SUSPENDING - /// action with the listmanagedinstances method. If the - /// standbyPolicy.initialDelaySec field is set, the group delays suspension of - /// the instances until initialDelaySec have passed from - /// instance.creationTimestamp (that is, when the instance was created). This - /// delay gives your application time to set itself up and initialize on the - /// instance. If more than initialDelaySec seconds have passed since - /// instance.creationTimestamp when this method is called, there will be zero - /// delay. If the group is part of a backend service that has enabled + /// this request. This method reduces thetargetSize and increases the + /// targetSuspendedSize + /// of the managed instance group by the number of instances that you suspend. + /// The suspendInstances operation is marked DONE if + /// the suspendInstances request is successful. The underlying + /// actions take additional time. You must separately verify the status of + /// theSUSPENDING action with thelistmanagedinstances + /// method. + /// + /// If the standbyPolicy.initialDelaySec field is set, the group + /// delays suspension of the instances until initialDelaySec have + /// passed from instance.creationTimestamp (that is, when the + /// instance was created). This delay gives your application time to + /// set itself up and initialize on the instance. If more thaninitialDelaySec + /// seconds have passed sinceinstance.creationTimestamp when this method is + /// called, there + /// will be zero delay. + /// + /// 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 suspended. - /// Suspended instances can be resumed using the resumeInstances method. You - /// can specify a maximum of 1000 instances with this method per request. + /// + /// Suspended instances can be resumed using the resumeInstances + /// method. + /// + /// You can specify a maximum of 1000 instances with this method per request. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroupManagers/suspendInstances /// /// @param request Unary RPCs, such as the one wrapped by this @@ -2881,7 +3009,7 @@ class RegionInstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_instance_group_managers.v1.SuspendInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L1407} + /// [google.cloud.cpp.compute.region_instance_group_managers.v1.SuspendInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L1664} /// // clang-format on future> SuspendInstances( @@ -2922,13 +3050,14 @@ class RegionInstanceGroupManagersClient { // clang-format off /// /// 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. + /// group. perInstanceConfig.name serves as a key used to + /// distinguish whether to perform insert or patch. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroupManagers/updatePerInstanceConfigs /// /// @param project Project ID for this request. /// @param region Name of the region scoping this request, should conform to RFC1035. - /// @param instance_group_manager The name of the managed instance group. It should conform to RFC1035. + /// @param instance_group_manager The name of the managed instance group. + /// It should conform to RFC1035. /// @param region_instance_group_manager_update_instance_config_req_resource The RegionInstanceGroupManagerUpdateInstanceConfigReq for this request. /// @param opts Optional. Override the class-level options, such as retry and /// backoff policies. @@ -2950,7 +3079,7 @@ class RegionInstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_instance_group_managers.v1.UpdatePerInstanceConfigsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L1448} + /// [google.cloud.cpp.compute.region_instance_group_managers.v1.UpdatePerInstanceConfigsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L1708} /// // clang-format on future> @@ -2984,8 +3113,8 @@ class RegionInstanceGroupManagersClient { // clang-format off /// /// 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. + /// group. perInstanceConfig.name serves as a key used to + /// distinguish whether to perform insert or patch. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroupManagers/updatePerInstanceConfigs /// /// @param request Unary RPCs, such as the one wrapped by this @@ -3014,7 +3143,7 @@ class RegionInstanceGroupManagersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_instance_group_managers.v1.UpdatePerInstanceConfigsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L1448} + /// [google.cloud.cpp.compute.region_instance_group_managers.v1.UpdatePerInstanceConfigsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L1708} /// // clang-format on future> 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 6c0131758eb73..00f54bf27fe70 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,13 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANCE_GROUP_MANAGERS_V1_REGION_INSTANCE_GROUP_MANAGERS_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_028.pb.h" -#include "google/cloud/compute/v1/internal/common_040.pb.h" -#include "google/cloud/compute/v1/internal/common_083.pb.h" -#include "google/cloud/compute/v1/internal/common_104.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_037.pb.h" +#include "google/cloud/compute/v1/internal/common_038.pb.h" +#include "google/cloud/compute/v1/internal/common_049.pb.h" +#include "google/cloud/compute/v1/internal/common_098.pb.h" +#include "google/cloud/compute/v1/internal/common_110.pb.h" +#include "google/cloud/compute/v1/internal/common_121.pb.h" // 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/internal/region_instance_groups_rest_connection_impl.cc b/google/cloud/compute/region_instance_groups/v1/internal/region_instance_groups_rest_connection_impl.cc index a203f78c7746f..c165636446fc4 100644 --- a/google/cloud/compute/region_instance_groups/v1/internal/region_instance_groups_rest_connection_impl.cc +++ b/google/cloud/compute/region_instance_groups/v1/internal/region_instance_groups_rest_connection_impl.cc @@ -271,6 +271,22 @@ RegionInstanceGroupsRestConnectionImpl::SetNamedPorts( }); } +StatusOr +RegionInstanceGroupsRestConnectionImpl::TestIamPermissions( + google::cloud::cpp::compute::region_instance_groups::v1:: + TestIamPermissionsRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->TestIamPermissions(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_instance_groups::v1:: + TestIamPermissionsRequest const& request) { + return stub_->TestIamPermissions(rest_context, options, request); + }, + *current, request, __func__); +} + GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END } // namespace compute_region_instance_groups_v1_internal } // namespace cloud diff --git a/google/cloud/compute/region_instance_groups/v1/internal/region_instance_groups_rest_connection_impl.h b/google/cloud/compute/region_instance_groups/v1/internal/region_instance_groups_rest_connection_impl.h index 3733d12e46f43..436cb7356354b 100644 --- a/google/cloud/compute/region_instance_groups/v1/internal/region_instance_groups_rest_connection_impl.h +++ b/google/cloud/compute/region_instance_groups/v1/internal/region_instance_groups_rest_connection_impl.h @@ -77,6 +77,10 @@ class RegionInstanceGroupsRestConnectionImpl future> SetNamedPorts( google::cloud::cpp::compute::v1::Operation const& operation) override; + StatusOr + TestIamPermissions(google::cloud::cpp::compute::region_instance_groups::v1:: + TestIamPermissionsRequest const& request) override; + private: static std::unique_ptr< compute_region_instance_groups_v1::RegionInstanceGroupsRetryPolicy> diff --git a/google/cloud/compute/region_instance_groups/v1/internal/region_instance_groups_rest_logging_decorator.cc b/google/cloud/compute/region_instance_groups/v1/internal/region_instance_groups_rest_logging_decorator.cc index b9245565a0e29..9f3e70d501e8a 100644 --- a/google/cloud/compute/region_instance_groups/v1/internal/region_instance_groups_rest_logging_decorator.cc +++ b/google/cloud/compute/region_instance_groups/v1/internal/region_instance_groups_rest_logging_decorator.cc @@ -111,6 +111,20 @@ RegionInstanceGroupsRestLogging::SetNamedPorts( rest_context, options, request, __func__, tracing_options_); } +StatusOr +RegionInstanceGroupsRestLogging::TestIamPermissions( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_instance_groups::v1:: + TestIamPermissionsRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_instance_groups::v1:: + TestIamPermissionsRequest const& request) { + return child_->TestIamPermissions(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + future> RegionInstanceGroupsRestLogging::AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/region_instance_groups/v1/internal/region_instance_groups_rest_logging_decorator.h b/google/cloud/compute/region_instance_groups/v1/internal/region_instance_groups_rest_logging_decorator.h index 4f1eeb87ad946..8f8c194c9da8d 100644 --- a/google/cloud/compute/region_instance_groups/v1/internal/region_instance_groups_rest_logging_decorator.h +++ b/google/cloud/compute/region_instance_groups/v1/internal/region_instance_groups_rest_logging_decorator.h @@ -76,6 +76,12 @@ class RegionInstanceGroupsRestLogging : public RegionInstanceGroupsRestStub { google::cloud::cpp::compute::region_instance_groups::v1:: SetNamedPortsRequest const& request) override; + StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_instance_groups::v1:: + TestIamPermissionsRequest const& request) override; + future> AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/region_instance_groups/v1/internal/region_instance_groups_rest_metadata_decorator.cc b/google/cloud/compute/region_instance_groups/v1/internal/region_instance_groups_rest_metadata_decorator.cc index 6842dabeeb6c4..a08efc0791ccd 100644 --- a/google/cloud/compute/region_instance_groups/v1/internal/region_instance_groups_rest_metadata_decorator.cc +++ b/google/cloud/compute/region_instance_groups/v1/internal/region_instance_groups_rest_metadata_decorator.cc @@ -88,6 +88,15 @@ RegionInstanceGroupsRestMetadata::SetNamedPorts( return child_->SetNamedPorts(rest_context, options, request); } +StatusOr +RegionInstanceGroupsRestMetadata::TestIamPermissions( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_instance_groups::v1:: + TestIamPermissionsRequest const& request) { + SetMetadata(rest_context, options); + return child_->TestIamPermissions(rest_context, options, request); +} + future> RegionInstanceGroupsRestMetadata::AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/region_instance_groups/v1/internal/region_instance_groups_rest_metadata_decorator.h b/google/cloud/compute/region_instance_groups/v1/internal/region_instance_groups_rest_metadata_decorator.h index ca8f31e0721e7..b9ac47930cf3a 100644 --- a/google/cloud/compute/region_instance_groups/v1/internal/region_instance_groups_rest_metadata_decorator.h +++ b/google/cloud/compute/region_instance_groups/v1/internal/region_instance_groups_rest_metadata_decorator.h @@ -74,6 +74,12 @@ class RegionInstanceGroupsRestMetadata : public RegionInstanceGroupsRestStub { google::cloud::cpp::compute::region_instance_groups::v1:: SetNamedPortsRequest const& request) override; + StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_instance_groups::v1:: + TestIamPermissionsRequest const& request) override; + google::cloud::future> AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/region_instance_groups/v1/internal/region_instance_groups_rest_stub.cc b/google/cloud/compute/region_instance_groups/v1/internal/region_instance_groups_rest_stub.cc index ef666e695badb..93ed3e07d7d7b 100644 --- a/google/cloud/compute/region_instance_groups/v1/internal/region_instance_groups_rest_stub.cc +++ b/google/cloud/compute/region_instance_groups/v1/internal/region_instance_groups_rest_stub.cc @@ -180,6 +180,25 @@ DefaultRegionInstanceGroupsRestStub::SetNamedPorts( std::move(query_params)); } +StatusOr +DefaultRegionInstanceGroupsRestStub::TestIamPermissions( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_instance_groups::v1:: + TestIamPermissionsRequest const& request) { + std::vector> query_params; + return rest_internal::Post< + google::cloud::cpp::compute::v1::TestPermissionsResponse>( + *service_, rest_context, request.test_permissions_request_resource(), + false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "regions", "/", + request.region(), "/", "instanceGroups", "/", + request.resource(), "/", "testIamPermissions"), + std::move(query_params)); +} + future> DefaultRegionInstanceGroupsRestStub::AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/region_instance_groups/v1/internal/region_instance_groups_rest_stub.h b/google/cloud/compute/region_instance_groups/v1/internal/region_instance_groups_rest_stub.h index 3adbce621927b..3809e03b2269d 100644 --- a/google/cloud/compute/region_instance_groups/v1/internal/region_instance_groups_rest_stub.h +++ b/google/cloud/compute/region_instance_groups/v1/internal/region_instance_groups_rest_stub.h @@ -72,6 +72,12 @@ class RegionInstanceGroupsRestStub { google::cloud::cpp::compute::region_instance_groups::v1:: SetNamedPortsRequest const& request) = 0; + virtual StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_instance_groups::v1:: + TestIamPermissionsRequest const& request) = 0; + virtual future> AsyncGetOperation( google::cloud::CompletionQueue& cq, @@ -131,6 +137,12 @@ class DefaultRegionInstanceGroupsRestStub google::cloud::cpp::compute::region_instance_groups::v1:: SetNamedPortsRequest const& request) override; + StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_instance_groups::v1:: + TestIamPermissionsRequest const& request) override; + future> AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/region_instance_groups/v1/internal/region_instance_groups_tracing_connection.cc b/google/cloud/compute/region_instance_groups/v1/internal/region_instance_groups_tracing_connection.cc index b6772a08d0e94..b94a6a6b98771 100644 --- a/google/cloud/compute/region_instance_groups/v1/internal/region_instance_groups_tracing_connection.cc +++ b/google/cloud/compute/region_instance_groups/v1/internal/region_instance_groups_tracing_connection.cc @@ -105,6 +105,17 @@ RegionInstanceGroupsTracingConnection::SetNamedPorts( return internal::EndSpan(std::move(span), child_->SetNamedPorts(operation)); } +StatusOr +RegionInstanceGroupsTracingConnection::TestIamPermissions( + google::cloud::cpp::compute::region_instance_groups::v1:: + TestIamPermissionsRequest const& request) { + auto span = internal::MakeSpan( + "compute_region_instance_groups_v1::RegionInstanceGroupsConnection::" + "TestIamPermissions"); + auto scope = opentelemetry::trace::Scope(span); + return internal::EndSpan(*span, child_->TestIamPermissions(request)); +} + std::shared_ptr< compute_region_instance_groups_v1::RegionInstanceGroupsConnection> MakeRegionInstanceGroupsTracingConnection( diff --git a/google/cloud/compute/region_instance_groups/v1/internal/region_instance_groups_tracing_connection.h b/google/cloud/compute/region_instance_groups/v1/internal/region_instance_groups_tracing_connection.h index b938be2124e93..63e5cf54ef17a 100644 --- a/google/cloud/compute/region_instance_groups/v1/internal/region_instance_groups_tracing_connection.h +++ b/google/cloud/compute/region_instance_groups/v1/internal/region_instance_groups_tracing_connection.h @@ -65,6 +65,10 @@ class RegionInstanceGroupsTracingConnection future> SetNamedPorts( google::cloud::cpp::compute::v1::Operation const& operation) override; + StatusOr + TestIamPermissions(google::cloud::cpp::compute::region_instance_groups::v1:: + TestIamPermissionsRequest const& request) override; + private: std::shared_ptr< compute_region_instance_groups_v1::RegionInstanceGroupsConnection> diff --git a/google/cloud/compute/region_instance_groups/v1/mocks/mock_region_instance_groups_connection.h b/google/cloud/compute/region_instance_groups/v1/mocks/mock_region_instance_groups_connection.h index 1f4a255233b64..04b8a36c94b60 100644 --- a/google/cloud/compute/region_instance_groups/v1/mocks/mock_region_instance_groups_connection.h +++ b/google/cloud/compute/region_instance_groups/v1/mocks/mock_region_instance_groups_connection.h @@ -107,6 +107,13 @@ class MockRegionInstanceGroupsConnection SetNamedPorts, (google::cloud::cpp::compute::v1::Operation const& operation), (override)); + + MOCK_METHOD( + StatusOr, + TestIamPermissions, + (google::cloud::cpp::compute::region_instance_groups::v1:: + TestIamPermissionsRequest const& request), + (override)); }; GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END diff --git a/google/cloud/compute/region_instance_groups/v1/region_instance_groups_client.cc b/google/cloud/compute/region_instance_groups/v1/region_instance_groups_client.cc index 30a1316cfab40..26c6eb3aa1db0 100644 --- a/google/cloud/compute/region_instance_groups/v1/region_instance_groups_client.cc +++ b/google/cloud/compute/region_instance_groups/v1/region_instance_groups_client.cc @@ -169,6 +169,33 @@ RegionInstanceGroupsClient::SetNamedPorts( return connection_->SetNamedPorts(operation); } +StatusOr +RegionInstanceGroupsClient::TestIamPermissions( + std::string const& project, std::string const& region, + std::string const& resource, + google::cloud::cpp::compute::v1::TestPermissionsRequest const& + test_permissions_request_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_instance_groups::v1:: + TestIamPermissionsRequest request; + request.set_project(project); + request.set_region(region); + request.set_resource(resource); + *request.mutable_test_permissions_request_resource() = + test_permissions_request_resource; + return connection_->TestIamPermissions(request); +} + +StatusOr +RegionInstanceGroupsClient::TestIamPermissions( + google::cloud::cpp::compute::region_instance_groups::v1:: + TestIamPermissionsRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->TestIamPermissions(request); +} + GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END } // namespace compute_region_instance_groups_v1 } // namespace cloud 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 d692a88141c66..b9e8562431978 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 @@ -111,8 +111,8 @@ class RegionInstanceGroupsClient { /// [`future`]: @ref google::cloud::future /// [`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.region_instance_groups.v1.GetInstanceGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_groups/v1/region_instance_groups.proto#L105} + /// [google.cloud.cpp.compute.v1.InstanceGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_073.proto#L43} /// // clang-format on StatusOr GetInstanceGroup( @@ -143,8 +143,8 @@ class RegionInstanceGroupsClient { /// [`future`]: @ref google::cloud::future /// [`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.region_instance_groups.v1.GetInstanceGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_groups/v1/region_instance_groups.proto#L105} + /// [google.cloud.cpp.compute.v1.InstanceGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_073.proto#L43} /// // clang-format on StatusOr GetInstanceGroup( @@ -154,8 +154,8 @@ class RegionInstanceGroupsClient { // clang-format off /// - /// Retrieves the list of instance group resources contained within the - /// specified region. + /// Retrieves the list of instance group resources contained within + /// the specified region. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroups/list /// /// @param project Project ID for this request. @@ -182,8 +182,8 @@ class RegionInstanceGroupsClient { /// [`future`]: @ref google::cloud::future /// [`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.region_instance_groups.v1.ListRegionInstanceGroupsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_groups/v1/region_instance_groups.proto#L235} + /// [google.cloud.cpp.compute.v1.InstanceGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_073.proto#L43} /// // clang-format on StreamRange @@ -192,8 +192,8 @@ class RegionInstanceGroupsClient { // clang-format off /// - /// Retrieves the list of instance group resources contained within the - /// specified region. + /// Retrieves the list of instance group resources contained within + /// the specified region. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroups/list /// /// @param request Unary RPCs, such as the one wrapped by this @@ -224,8 +224,8 @@ class RegionInstanceGroupsClient { /// [`future`]: @ref google::cloud::future /// [`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.region_instance_groups.v1.ListRegionInstanceGroupsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_groups/v1/region_instance_groups.proto#L235} + /// [google.cloud.cpp.compute.v1.InstanceGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_073.proto#L43} /// // clang-format on StreamRange @@ -237,8 +237,8 @@ class RegionInstanceGroupsClient { /// /// 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. + /// method can list all instances or only the instances that are running. + /// The orderBy query parameter is not supported. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroups/listInstances /// /// @param project Project ID for this request. @@ -268,8 +268,8 @@ class RegionInstanceGroupsClient { /// [`future`]: @ref google::cloud::future /// [`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#L96} + /// [google.cloud.cpp.compute.region_instance_groups.v1.ListInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_groups/v1/region_instance_groups.proto#L120} + /// [google.cloud.cpp.compute.v1.InstanceWithNamedPorts]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_073.proto#L115} /// // clang-format on StreamRange @@ -284,8 +284,8 @@ class RegionInstanceGroupsClient { /// /// 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. + /// method can list all instances or only the instances that are running. + /// The orderBy query parameter is not supported. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroups/listInstances /// /// @param request Unary RPCs, such as the one wrapped by this @@ -316,8 +316,8 @@ class RegionInstanceGroupsClient { /// [`future`]: @ref google::cloud::future /// [`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#L96} + /// [google.cloud.cpp.compute.region_instance_groups.v1.ListInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_groups/v1/region_instance_groups.proto#L120} + /// [google.cloud.cpp.compute.v1.InstanceWithNamedPorts]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_073.proto#L115} /// // clang-format on StreamRange @@ -354,7 +354,7 @@ class RegionInstanceGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_instance_groups.v1.SetNamedPortsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_groups/v1/region_instance_groups.proto#L261} + /// [google.cloud.cpp.compute.region_instance_groups.v1.SetNamedPortsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_groups/v1/region_instance_groups.proto#L340} /// // clang-format on future> SetNamedPorts( @@ -415,7 +415,7 @@ class RegionInstanceGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_instance_groups.v1.SetNamedPortsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_groups/v1/region_instance_groups.proto#L261} + /// [google.cloud.cpp.compute.region_instance_groups.v1.SetNamedPortsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_groups/v1/region_instance_groups.proto#L340} /// // clang-format on future> SetNamedPorts( @@ -453,6 +453,73 @@ class RegionInstanceGroupsClient { google::cloud::cpp::compute::v1::Operation const& operation, Options opts = {}); + // clang-format off + /// + /// Returns permissions that a caller has on the specified resource. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroups/testIamPermissions + /// + /// @param project Project ID for this request. + /// @param region The name of the region for this request. + /// @param resource Name or id of the resource for this request. + /// @param test_permissions_request_resource The TestPermissionsRequest for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.TestPermissionsResponse]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_instance_groups.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_groups/v1/region_instance_groups.proto#L381} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} + /// + // clang-format on + StatusOr + TestIamPermissions( + std::string const& project, std::string const& region, + std::string const& resource, + google::cloud::cpp::compute::v1::TestPermissionsRequest const& + test_permissions_request_resource, + Options opts = {}); + + // clang-format off + /// + /// Returns permissions that a caller has on the specified resource. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroups/testIamPermissions + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.region_instance_groups.v1.TestIamPermissionsRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.TestPermissionsResponse]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_instance_groups.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_groups/v1/region_instance_groups.proto#L381} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} + /// + // clang-format on + StatusOr + TestIamPermissions(google::cloud::cpp::compute::region_instance_groups::v1:: + TestIamPermissionsRequest const& request, + Options opts = {}); + private: std::shared_ptr connection_; Options options_; diff --git a/google/cloud/compute/region_instance_groups/v1/region_instance_groups_connection.cc b/google/cloud/compute/region_instance_groups/v1/region_instance_groups_connection.cc index 50b8b10f2b196..047050aa710bb 100644 --- a/google/cloud/compute/region_instance_groups/v1/region_instance_groups_connection.cc +++ b/google/cloud/compute/region_instance_groups/v1/region_instance_groups_connection.cc @@ -85,6 +85,13 @@ RegionInstanceGroupsConnection::SetNamedPorts( Status(StatusCode::kUnimplemented, "not implemented")); } +StatusOr +RegionInstanceGroupsConnection::TestIamPermissions( + google::cloud::cpp::compute::region_instance_groups::v1:: + TestIamPermissionsRequest const&) { + return Status(StatusCode::kUnimplemented, "not implemented"); +} + GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END } // namespace compute_region_instance_groups_v1 } // namespace cloud diff --git a/google/cloud/compute/region_instance_groups/v1/region_instance_groups_connection.h b/google/cloud/compute/region_instance_groups/v1/region_instance_groups_connection.h index 4f674000595ec..73f9331ea07f9 100644 --- a/google/cloud/compute/region_instance_groups/v1/region_instance_groups_connection.h +++ b/google/cloud/compute/region_instance_groups/v1/region_instance_groups_connection.h @@ -215,6 +215,10 @@ class RegionInstanceGroupsConnection { virtual future> SetNamedPorts(google::cloud::cpp::compute::v1::Operation const& operation); + + virtual StatusOr + TestIamPermissions(google::cloud::cpp::compute::region_instance_groups::v1:: + TestIamPermissionsRequest const& request); }; GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END diff --git a/google/cloud/compute/region_instance_groups/v1/region_instance_groups_connection_idempotency_policy.cc b/google/cloud/compute/region_instance_groups/v1/region_instance_groups_connection_idempotency_policy.cc index cefa4cba9e02f..dcacd8c029d6a 100644 --- a/google/cloud/compute/region_instance_groups/v1/region_instance_groups_connection_idempotency_policy.cc +++ b/google/cloud/compute/region_instance_groups/v1/region_instance_groups_connection_idempotency_policy.cc @@ -61,6 +61,12 @@ Idempotency RegionInstanceGroupsConnectionIdempotencyPolicy::SetNamedPorts( return Idempotency::kNonIdempotent; } +Idempotency RegionInstanceGroupsConnectionIdempotencyPolicy::TestIamPermissions( + google::cloud::cpp::compute::region_instance_groups::v1:: + TestIamPermissionsRequest const&) { + return Idempotency::kNonIdempotent; +} + std::unique_ptr MakeDefaultRegionInstanceGroupsConnectionIdempotencyPolicy() { return std::make_unique(); diff --git a/google/cloud/compute/region_instance_groups/v1/region_instance_groups_connection_idempotency_policy.h b/google/cloud/compute/region_instance_groups/v1/region_instance_groups_connection_idempotency_policy.h index d2002fc52f5d9..585e1cfeaa3d5 100644 --- a/google/cloud/compute/region_instance_groups/v1/region_instance_groups_connection_idempotency_policy.h +++ b/google/cloud/compute/region_instance_groups/v1/region_instance_groups_connection_idempotency_policy.h @@ -53,6 +53,10 @@ class RegionInstanceGroupsConnectionIdempotencyPolicy { virtual google::cloud::Idempotency SetNamedPorts( google::cloud::cpp::compute::region_instance_groups::v1:: SetNamedPortsRequest const& request); + + virtual google::cloud::Idempotency TestIamPermissions( + google::cloud::cpp::compute::region_instance_groups::v1:: + TestIamPermissionsRequest const& request); }; std::unique_ptr 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 4d1785ab2e343..503544b1c0b16 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,11 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANCE_GROUPS_V1_REGION_INSTANCE_GROUPS_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_059.pb.h" -#include "google/cloud/compute/v1/internal/common_083.pb.h" -#include "google/cloud/compute/v1/internal/common_103.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_073.pb.h" +#include "google/cloud/compute/v1/internal/common_098.pb.h" +#include "google/cloud/compute/v1/internal/common_120.pb.h" +#include "google/cloud/compute/v1/internal/common_171.pb.h" // 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 3b5d214272878..dc74d398a25d2 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 @@ -236,8 +236,8 @@ class RegionInstanceTemplatesClient { /// [`future`]: @ref google::cloud::future /// [`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_024.proto#L85} + /// [google.cloud.cpp.compute.region_instance_templates.v1.GetInstanceTemplateRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_templates/v1/region_instance_templates.proto#L125} + /// [google.cloud.cpp.compute.v1.InstanceTemplate]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_033.proto#L109} /// // clang-format on StatusOr @@ -268,8 +268,8 @@ class RegionInstanceTemplatesClient { /// [`future`]: @ref google::cloud::future /// [`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_024.proto#L85} + /// [google.cloud.cpp.compute.region_instance_templates.v1.GetInstanceTemplateRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_templates/v1/region_instance_templates.proto#L125} + /// [google.cloud.cpp.compute.v1.InstanceTemplate]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_033.proto#L109} /// // clang-format on StatusOr @@ -306,7 +306,7 @@ class RegionInstanceTemplatesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_instance_templates.v1.InsertInstanceTemplateRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_templates/v1/region_instance_templates.proto#L137} + /// [google.cloud.cpp.compute.region_instance_templates.v1.InsertInstanceTemplateRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_templates/v1/region_instance_templates.proto#L140} /// // clang-format on future> @@ -365,7 +365,7 @@ class RegionInstanceTemplatesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_instance_templates.v1.InsertInstanceTemplateRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_templates/v1/region_instance_templates.proto#L137} + /// [google.cloud.cpp.compute.region_instance_templates.v1.InsertInstanceTemplateRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_templates/v1/region_instance_templates.proto#L140} /// // clang-format on future> @@ -435,8 +435,8 @@ class RegionInstanceTemplatesClient { /// [`future`]: @ref google::cloud::future /// [`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_024.proto#L85} + /// [google.cloud.cpp.compute.region_instance_templates.v1.ListRegionInstanceTemplatesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_templates/v1/region_instance_templates.proto#L176} + /// [google.cloud.cpp.compute.v1.InstanceTemplate]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_033.proto#L109} /// // clang-format on StreamRange @@ -477,8 +477,8 @@ class RegionInstanceTemplatesClient { /// [`future`]: @ref google::cloud::future /// [`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_024.proto#L85} + /// [google.cloud.cpp.compute.region_instance_templates.v1.ListRegionInstanceTemplatesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_templates/v1/region_instance_templates.proto#L176} + /// [google.cloud.cpp.compute.v1.InstanceTemplate]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_033.proto#L109} /// // 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 dcfd45d71cbce..2586653b24451 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 @@ -27,13 +27,13 @@ // IWYU pragma: begin_exports #include "google/cloud/compute/v1/internal/common_001.pb.h" -#include "google/cloud/compute/v1/internal/common_003.pb.h" -#include "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_021.pb.h" -#include "google/cloud/compute/v1/internal/common_024.pb.h" -#include "google/cloud/compute/v1/internal/common_029.pb.h" +#include "google/cloud/compute/v1/internal/common_004.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_028.pb.h" #include "google/cloud/compute/v1/internal/common_033.pb.h" -#include "google/cloud/compute/v1/internal/common_081.pb.h" +#include "google/cloud/compute/v1/internal/common_038.pb.h" +#include "google/cloud/compute/v1/internal/common_042.pb.h" +#include "google/cloud/compute/v1/internal/common_096.pb.h" // 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 d80a7bdcbaec8..e2180a3ab038d 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 @@ -27,13 +27,13 @@ // IWYU pragma: begin_exports #include "google/cloud/compute/v1/internal/common_001.pb.h" -#include "google/cloud/compute/v1/internal/common_003.pb.h" -#include "google/cloud/compute/v1/internal/common_015.pb.h" -#include "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_021.pb.h" -#include "google/cloud/compute/v1/internal/common_029.pb.h" -#include "google/cloud/compute/v1/internal/common_033.pb.h" -#include "google/cloud/compute/v1/internal/common_081.pb.h" +#include "google/cloud/compute/v1/internal/common_004.pb.h" +#include "google/cloud/compute/v1/internal/common_018.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_028.pb.h" +#include "google/cloud/compute/v1/internal/common_038.pb.h" +#include "google/cloud/compute/v1/internal/common_042.pb.h" +#include "google/cloud/compute/v1/internal/common_096.pb.h" // 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_snapshot_groups/v1/internal/region_instant_snapshot_groups_option_defaults.cc b/google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_option_defaults.cc new file mode 100644 index 0000000000000..eb87cf5742e8d --- /dev/null +++ b/google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_option_defaults.cc @@ -0,0 +1,96 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups.proto + +#include "google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_option_defaults.h" +#include "google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups_connection.h" +#include "google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups_options.h" +#include "google/cloud/internal/populate_common_options.h" +#include "google/cloud/internal/populate_grpc_options.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_instant_snapshot_groups_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +namespace { +auto constexpr kBackoffScaling = 2.0; +} // namespace + +Options RegionInstantSnapshotGroupsDefaultOptions(Options options) { + options = internal::PopulateCommonOptions( + std::move(options), + "GOOGLE_CLOUD_CPP_REGION_INSTANT_SNAPSHOT_GROUPS_ENDPOINT", "", + "GOOGLE_CLOUD_CPP_REGION_INSTANT_SNAPSHOT_GROUPS_AUTHORITY", + "compute.googleapis.com"); + options = internal::PopulateGrpcOptions(std::move(options)); + if (!options.has()) { + options.set( + compute_region_instant_snapshot_groups_v1:: + RegionInstantSnapshotGroupsLimitedTimeRetryPolicy( + std::chrono::minutes(10)) + .clone()); + } + if (!options.has()) { + options.set( + ExponentialBackoffPolicy( + std::chrono::seconds(0), std::chrono::seconds(1), + std::chrono::minutes(5), kBackoffScaling, kBackoffScaling) + .clone()); + } + if (!options.has()) { + options.set( + GenericPollingPolicy< + compute_region_instant_snapshot_groups_v1:: + RegionInstantSnapshotGroupsRetryPolicyOption::Type, + compute_region_instant_snapshot_groups_v1:: + RegionInstantSnapshotGroupsBackoffPolicyOption::Type>( + options + .get() + ->clone(), + ExponentialBackoffPolicy(std::chrono::seconds(1), + std::chrono::minutes(5), kBackoffScaling) + .clone()) + .clone()); + } + if (!options.has< + compute_region_instant_snapshot_groups_v1:: + RegionInstantSnapshotGroupsConnectionIdempotencyPolicyOption>()) { + options.set< + compute_region_instant_snapshot_groups_v1:: + RegionInstantSnapshotGroupsConnectionIdempotencyPolicyOption>( + compute_region_instant_snapshot_groups_v1:: + MakeDefaultRegionInstantSnapshotGroupsConnectionIdempotencyPolicy()); + } + + return options; +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_instant_snapshot_groups_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_option_defaults.h b/google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_option_defaults.h new file mode 100644 index 0000000000000..67c3e77cec76f --- /dev/null +++ b/google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_option_defaults.h @@ -0,0 +1,38 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANT_SNAPSHOT_GROUPS_V1_INTERNAL_REGION_INSTANT_SNAPSHOT_GROUPS_OPTION_DEFAULTS_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANT_SNAPSHOT_GROUPS_V1_INTERNAL_REGION_INSTANT_SNAPSHOT_GROUPS_OPTION_DEFAULTS_H + +#include "google/cloud/options.h" +#include "google/cloud/version.h" + +namespace google { +namespace cloud { +namespace compute_region_instant_snapshot_groups_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +Options RegionInstantSnapshotGroupsDefaultOptions(Options options); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_instant_snapshot_groups_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANT_SNAPSHOT_GROUPS_V1_INTERNAL_REGION_INSTANT_SNAPSHOT_GROUPS_OPTION_DEFAULTS_H diff --git a/google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_rest_connection_impl.cc b/google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_rest_connection_impl.cc new file mode 100644 index 0000000000000..2474c16d5f2ac --- /dev/null +++ b/google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_rest_connection_impl.cc @@ -0,0 +1,425 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups.proto + +#include "google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_rest_connection_impl.h" +#include "google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_rest_stub_factory.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/internal/async_rest_long_running_operation_custom.h" +#include "google/cloud/internal/extract_long_running_result.h" +#include "google/cloud/internal/pagination_range.h" +#include "google/cloud/internal/rest_lro_helpers.h" +#include "google/cloud/internal/rest_retry_loop.h" +#include "google/cloud/rest_options.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_instant_snapshot_groups_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +RegionInstantSnapshotGroupsRestConnectionImpl:: + RegionInstantSnapshotGroupsRestConnectionImpl( + std::unique_ptr background, + std::shared_ptr + stub, + Options options) + : background_(std::move(background)), + stub_(std::move(stub)), + options_(internal::MergeOptions( + std::move(options), + RegionInstantSnapshotGroupsConnection::options())) {} + +future> +RegionInstantSnapshotGroupsRestConnectionImpl::DeleteInstantSnapshotGroup( + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::region_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, request, + [stub = stub_]( + CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest const& request) { + return stub->AsyncDeleteInstantSnapshotGroup( + cq, std::move(context), std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->DeleteInstantSnapshotGroup(request), + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [request](std::string const& op, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest& r) { + r.set_project(request.project()); + r.set_region(request.region()); + r.set_operation(op); + }, + [request](std::string const& op, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest& r) { + r.set_project(request.project()); + r.set_region(request.region()); + r.set_operation(op); + }); +} + +StatusOr +RegionInstantSnapshotGroupsRestConnectionImpl::DeleteInstantSnapshotGroup( + NoAwaitTag, google::cloud::cpp::compute::region_instant_snapshot_groups:: + v1::DeleteInstantSnapshotGroupRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->DeleteInstantSnapshotGroup(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest const& request) { + return stub_->DeleteInstantSnapshotGroup(rest_context, options, + request); + }, + *current, request, __func__); +} + +future> +RegionInstantSnapshotGroupsRestConnectionImpl::DeleteInstantSnapshotGroup( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestAwaitLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::region_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, operation, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [operation](std::string const&, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_region(info.region); + r.set_operation(info.operation); + }, + [operation](std::string const&, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_region(info.region); + r.set_operation(info.operation); + }); +} + +StatusOr +RegionInstantSnapshotGroupsRestConnectionImpl::GetInstantSnapshotGroup( + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + GetInstantSnapshotGroupRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->GetInstantSnapshotGroup(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + GetInstantSnapshotGroupRequest const& request) { + return stub_->GetInstantSnapshotGroup(rest_context, options, request); + }, + *current, request, __func__); +} + +StatusOr +RegionInstantSnapshotGroupsRestConnectionImpl::GetIamPolicy( + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + GetIamPolicyRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->GetIamPolicy(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + GetIamPolicyRequest const& request) { + return stub_->GetIamPolicy(rest_context, options, request); + }, + *current, request, __func__); +} + +future> +RegionInstantSnapshotGroupsRestConnectionImpl::InsertInstantSnapshotGroup( + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::region_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, request, + [stub = stub_]( + CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest const& request) { + return stub->AsyncInsertInstantSnapshotGroup( + cq, std::move(context), std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->InsertInstantSnapshotGroup(request), + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [request](std::string const& op, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest& r) { + r.set_project(request.project()); + r.set_region(request.region()); + r.set_operation(op); + }, + [request](std::string const& op, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest& r) { + r.set_project(request.project()); + r.set_region(request.region()); + r.set_operation(op); + }); +} + +StatusOr +RegionInstantSnapshotGroupsRestConnectionImpl::InsertInstantSnapshotGroup( + NoAwaitTag, google::cloud::cpp::compute::region_instant_snapshot_groups:: + v1::InsertInstantSnapshotGroupRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->InsertInstantSnapshotGroup(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest const& request) { + return stub_->InsertInstantSnapshotGroup(rest_context, options, + request); + }, + *current, request, __func__); +} + +future> +RegionInstantSnapshotGroupsRestConnectionImpl::InsertInstantSnapshotGroup( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestAwaitLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::region_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, operation, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [operation](std::string const&, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_region(info.region); + r.set_operation(info.operation); + }, + [operation](std::string const&, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_region(info.region); + r.set_operation(info.operation); + }); +} + +StreamRange +RegionInstantSnapshotGroupsRestConnectionImpl::ListRegionInstantSnapshotGroups( + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + ListRegionInstantSnapshotGroupsRequest request) { + request.clear_page_token(); + auto current = google::cloud::internal::SaveCurrentOptions(); + auto idempotency = + idempotency_policy(*current)->ListRegionInstantSnapshotGroups(request); + char const* function_name = __func__; + return google::cloud::internal::MakePaginationRange< + StreamRange>( + current, std::move(request), + [idempotency, function_name, stub = stub_, + retry = std::shared_ptr( + retry_policy(*current)), + backoff = std::shared_ptr(backoff_policy(*current))]( + Options const& options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + ListRegionInstantSnapshotGroupsRequest const& r) { + return google::cloud::rest_internal::RestRetryLoop( + retry->clone(), backoff->clone(), idempotency, + [stub]( + rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_instant_snapshot_groups:: + v1::ListRegionInstantSnapshotGroupsRequest const& request) { + return stub->ListRegionInstantSnapshotGroups(rest_context, + options, request); + }, + options, r, function_name); + }, + [](google::cloud::cpp::compute::v1::ListInstantSnapshotGroups r) { + std::vector + result(r.items().size()); + auto& messages = *r.mutable_items(); + std::move(messages.begin(), messages.end(), result.begin()); + return result; + }); +} + +StatusOr +RegionInstantSnapshotGroupsRestConnectionImpl::SetIamPolicy( + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + SetIamPolicyRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->SetIamPolicy(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + SetIamPolicyRequest const& request) { + return stub_->SetIamPolicy(rest_context, options, request); + }, + *current, request, __func__); +} + +StatusOr +RegionInstantSnapshotGroupsRestConnectionImpl::TestIamPermissions( + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + TestIamPermissionsRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->TestIamPermissions(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + TestIamPermissionsRequest const& request) { + return stub_->TestIamPermissions(rest_context, options, request); + }, + *current, request, __func__); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_instant_snapshot_groups_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_rest_connection_impl.h b/google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_rest_connection_impl.h new file mode 100644 index 0000000000000..b6a22dcd21ef0 --- /dev/null +++ b/google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_rest_connection_impl.h @@ -0,0 +1,156 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANT_SNAPSHOT_GROUPS_V1_INTERNAL_REGION_INSTANT_SNAPSHOT_GROUPS_REST_CONNECTION_IMPL_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANT_SNAPSHOT_GROUPS_V1_INTERNAL_REGION_INSTANT_SNAPSHOT_GROUPS_REST_CONNECTION_IMPL_H + +#include "google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_rest_stub.h" +#include "google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_retry_traits.h" +#include "google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups_connection.h" +#include "google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups_connection_idempotency_policy.h" +#include "google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups_options.h" +#include "google/cloud/compute/region_operations/v1/region_operations.pb.h" +#include "google/cloud/background_threads.h" +#include "google/cloud/backoff_policy.h" +#include "google/cloud/options.h" +#include "google/cloud/status_or.h" +#include "google/cloud/stream_range.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_instant_snapshot_groups_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class RegionInstantSnapshotGroupsRestConnectionImpl + : public compute_region_instant_snapshot_groups_v1:: + RegionInstantSnapshotGroupsConnection { + public: + ~RegionInstantSnapshotGroupsRestConnectionImpl() override = default; + + RegionInstantSnapshotGroupsRestConnectionImpl( + std::unique_ptr background, + std::shared_ptr + stub, + Options options); + + Options options() override { return options_; } + + future> + DeleteInstantSnapshotGroup( + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest const& request) override; + + StatusOr + DeleteInstantSnapshotGroup( + NoAwaitTag, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest const& request) override; + + future> + DeleteInstantSnapshotGroup( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + StatusOr + GetInstantSnapshotGroup( + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + GetInstantSnapshotGroupRequest const& request) override; + + StatusOr GetIamPolicy( + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + GetIamPolicyRequest const& request) override; + + future> + InsertInstantSnapshotGroup( + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest const& request) override; + + StatusOr + InsertInstantSnapshotGroup( + NoAwaitTag, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest const& request) override; + + future> + InsertInstantSnapshotGroup( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + StreamRange + ListRegionInstantSnapshotGroups( + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + ListRegionInstantSnapshotGroupsRequest request) override; + + StatusOr SetIamPolicy( + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + SetIamPolicyRequest const& request) override; + + StatusOr + TestIamPermissions( + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + TestIamPermissionsRequest const& request) override; + + private: + static std::unique_ptr + retry_policy(Options const& options) { + return options + .get() + ->clone(); + } + + static std::unique_ptr backoff_policy(Options const& options) { + return options + .get() + ->clone(); + } + + static std::unique_ptr< + compute_region_instant_snapshot_groups_v1:: + RegionInstantSnapshotGroupsConnectionIdempotencyPolicy> + idempotency_policy(Options const& options) { + return options + .get() + ->clone(); + } + + static std::unique_ptr polling_policy(Options const& options) { + return options + .get() + ->clone(); + } + + std::unique_ptr background_; + std::shared_ptr + stub_; + Options options_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_instant_snapshot_groups_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANT_SNAPSHOT_GROUPS_V1_INTERNAL_REGION_INSTANT_SNAPSHOT_GROUPS_REST_CONNECTION_IMPL_H diff --git a/google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_rest_logging_decorator.cc b/google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_rest_logging_decorator.cc new file mode 100644 index 0000000000000..effeac87fa27e --- /dev/null +++ b/google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_rest_logging_decorator.cc @@ -0,0 +1,221 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups.proto + +#include "google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_rest_logging_decorator.h" +#include "google/cloud/internal/log_wrapper.h" +#include "google/cloud/status_or.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_instant_snapshot_groups_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +RegionInstantSnapshotGroupsRestLogging::RegionInstantSnapshotGroupsRestLogging( + std::shared_ptr child, + TracingOptions tracing_options, std::set components) + : child_(std::move(child)), + tracing_options_(std::move(tracing_options)), + components_(std::move(components)) {} + +future> +RegionInstantSnapshotGroupsRestLogging::AsyncDeleteInstantSnapshotGroup( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest const& request) { + return child_->AsyncDeleteInstantSnapshotGroup( + cq, std::move(rest_context), std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +StatusOr +RegionInstantSnapshotGroupsRestLogging::DeleteInstantSnapshotGroup( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest const& request) { + return child_->DeleteInstantSnapshotGroup(rest_context, options, + request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +StatusOr +RegionInstantSnapshotGroupsRestLogging::GetInstantSnapshotGroup( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + GetInstantSnapshotGroupRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + GetInstantSnapshotGroupRequest const& request) { + return child_->GetInstantSnapshotGroup(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +StatusOr +RegionInstantSnapshotGroupsRestLogging::GetIamPolicy( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + GetIamPolicyRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + GetIamPolicyRequest const& request) { + return child_->GetIamPolicy(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +future> +RegionInstantSnapshotGroupsRestLogging::AsyncInsertInstantSnapshotGroup( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest const& request) { + return child_->AsyncInsertInstantSnapshotGroup( + cq, std::move(rest_context), std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +StatusOr +RegionInstantSnapshotGroupsRestLogging::InsertInstantSnapshotGroup( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest const& request) { + return child_->InsertInstantSnapshotGroup(rest_context, options, + request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +StatusOr +RegionInstantSnapshotGroupsRestLogging::ListRegionInstantSnapshotGroups( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + ListRegionInstantSnapshotGroupsRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + ListRegionInstantSnapshotGroupsRequest const& request) { + return child_->ListRegionInstantSnapshotGroups(rest_context, options, + request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +StatusOr +RegionInstantSnapshotGroupsRestLogging::SetIamPolicy( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + SetIamPolicyRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + SetIamPolicyRequest const& request) { + return child_->SetIamPolicy(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +StatusOr +RegionInstantSnapshotGroupsRestLogging::TestIamPermissions( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + TestIamPermissionsRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + TestIamPermissionsRequest const& request) { + return child_->TestIamPermissions(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +future> +RegionInstantSnapshotGroupsRestLogging::AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + return child_->AsyncGetOperation(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +future RegionInstantSnapshotGroupsRestLogging::AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + return child_->AsyncCancelOperation(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_instant_snapshot_groups_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_rest_logging_decorator.h b/google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_rest_logging_decorator.h new file mode 100644 index 0000000000000..c38af019bb68f --- /dev/null +++ b/google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_rest_logging_decorator.h @@ -0,0 +1,136 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANT_SNAPSHOT_GROUPS_V1_INTERNAL_REGION_INSTANT_SNAPSHOT_GROUPS_REST_LOGGING_DECORATOR_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANT_SNAPSHOT_GROUPS_V1_INTERNAL_REGION_INSTANT_SNAPSHOT_GROUPS_REST_LOGGING_DECORATOR_H + +#include "google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_rest_stub.h" +#include "google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups.pb.h" +#include "google/cloud/compute/region_operations/v1/region_operations.pb.h" +#include "google/cloud/future.h" +#include "google/cloud/internal/rest_context.h" +#include "google/cloud/tracing_options.h" +#include "google/cloud/version.h" +#include +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_instant_snapshot_groups_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class RegionInstantSnapshotGroupsRestLogging + : public RegionInstantSnapshotGroupsRestStub { + public: + ~RegionInstantSnapshotGroupsRestLogging() override = default; + RegionInstantSnapshotGroupsRestLogging( + std::shared_ptr child, + TracingOptions tracing_options, std::set components); + + future> + AsyncDeleteInstantSnapshotGroup( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest const& request) override; + + StatusOr + DeleteInstantSnapshotGroup( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest const& request) override; + + StatusOr + GetInstantSnapshotGroup( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + GetInstantSnapshotGroupRequest const& request) override; + + StatusOr GetIamPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + GetIamPolicyRequest const& request) override; + + future> + AsyncInsertInstantSnapshotGroup( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest const& request) override; + + StatusOr + InsertInstantSnapshotGroup( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest const& request) override; + + StatusOr + ListRegionInstantSnapshotGroups( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + ListRegionInstantSnapshotGroupsRequest const& request) override; + + StatusOr SetIamPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + SetIamPolicyRequest const& request) override; + + StatusOr + TestIamPermissions( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + TestIamPermissionsRequest const& request) override; + + future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) override; + + future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) override; + + private: + std::shared_ptr child_; + TracingOptions tracing_options_; + std::set components_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_instant_snapshot_groups_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANT_SNAPSHOT_GROUPS_V1_INTERNAL_REGION_INSTANT_SNAPSHOT_GROUPS_REST_LOGGING_DECORATOR_H diff --git a/google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_rest_metadata_decorator.cc b/google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_rest_metadata_decorator.cc new file mode 100644 index 0000000000000..ed2003bce3f3b --- /dev/null +++ b/google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_rest_metadata_decorator.cc @@ -0,0 +1,165 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups.proto + +#include "google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_rest_metadata_decorator.h" +#include "google/cloud/internal/api_client_header.h" +#include "google/cloud/internal/rest_set_metadata.h" +#include "google/cloud/status_or.h" +#include "absl/strings/str_cat.h" +#include "absl/strings/str_format.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_instant_snapshot_groups_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +RegionInstantSnapshotGroupsRestMetadata:: + RegionInstantSnapshotGroupsRestMetadata( + std::shared_ptr child, + std::string api_client_header) + : child_(std::move(child)), + api_client_header_( + api_client_header.empty() + ? google::cloud::internal::GeneratedLibClientHeader() + : std::move(api_client_header)) {} + +future> +RegionInstantSnapshotGroupsRestMetadata::AsyncDeleteInstantSnapshotGroup( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncDeleteInstantSnapshotGroup(cq, std::move(rest_context), + std::move(options), request); +} + +StatusOr +RegionInstantSnapshotGroupsRestMetadata::DeleteInstantSnapshotGroup( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest const& request) { + SetMetadata(rest_context, options); + return child_->DeleteInstantSnapshotGroup(rest_context, options, request); +} + +StatusOr +RegionInstantSnapshotGroupsRestMetadata::GetInstantSnapshotGroup( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + GetInstantSnapshotGroupRequest const& request) { + SetMetadata(rest_context, options); + return child_->GetInstantSnapshotGroup(rest_context, options, request); +} + +StatusOr +RegionInstantSnapshotGroupsRestMetadata::GetIamPolicy( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + GetIamPolicyRequest const& request) { + SetMetadata(rest_context, options); + return child_->GetIamPolicy(rest_context, options, request); +} + +future> +RegionInstantSnapshotGroupsRestMetadata::AsyncInsertInstantSnapshotGroup( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncInsertInstantSnapshotGroup(cq, std::move(rest_context), + std::move(options), request); +} + +StatusOr +RegionInstantSnapshotGroupsRestMetadata::InsertInstantSnapshotGroup( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest const& request) { + SetMetadata(rest_context, options); + return child_->InsertInstantSnapshotGroup(rest_context, options, request); +} + +StatusOr +RegionInstantSnapshotGroupsRestMetadata::ListRegionInstantSnapshotGroups( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + ListRegionInstantSnapshotGroupsRequest const& request) { + SetMetadata(rest_context, options); + return child_->ListRegionInstantSnapshotGroups(rest_context, options, + request); +} + +StatusOr +RegionInstantSnapshotGroupsRestMetadata::SetIamPolicy( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + SetIamPolicyRequest const& request) { + SetMetadata(rest_context, options); + return child_->SetIamPolicy(rest_context, options, request); +} + +StatusOr +RegionInstantSnapshotGroupsRestMetadata::TestIamPermissions( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + TestIamPermissionsRequest const& request) { + SetMetadata(rest_context, options); + return child_->TestIamPermissions(rest_context, options, request); +} + +future> +RegionInstantSnapshotGroupsRestMetadata::AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncGetOperation(cq, std::move(rest_context), + std::move(options), request); +} + +future RegionInstantSnapshotGroupsRestMetadata::AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncCancelOperation(cq, std::move(rest_context), + std::move(options), request); +} + +void RegionInstantSnapshotGroupsRestMetadata::SetMetadata( + rest_internal::RestContext& rest_context, Options const& options, + std::vector const& params) { + google::cloud::rest_internal::SetMetadata(rest_context, options, params, + api_client_header_); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_instant_snapshot_groups_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_rest_metadata_decorator.h b/google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_rest_metadata_decorator.h new file mode 100644 index 0000000000000..2208850383cfa --- /dev/null +++ b/google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_rest_metadata_decorator.h @@ -0,0 +1,137 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANT_SNAPSHOT_GROUPS_V1_INTERNAL_REGION_INSTANT_SNAPSHOT_GROUPS_REST_METADATA_DECORATOR_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANT_SNAPSHOT_GROUPS_V1_INTERNAL_REGION_INSTANT_SNAPSHOT_GROUPS_REST_METADATA_DECORATOR_H + +#include "google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_rest_stub.h" +#include "google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups.pb.h" +#include "google/cloud/compute/region_operations/v1/region_operations.pb.h" +#include "google/cloud/future.h" +#include "google/cloud/rest_options.h" +#include "google/cloud/version.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_instant_snapshot_groups_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class RegionInstantSnapshotGroupsRestMetadata + : public RegionInstantSnapshotGroupsRestStub { + public: + ~RegionInstantSnapshotGroupsRestMetadata() override = default; + explicit RegionInstantSnapshotGroupsRestMetadata( + std::shared_ptr child, + std::string api_client_header = ""); + + google::cloud::future> + AsyncDeleteInstantSnapshotGroup( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest const& request) override; + + StatusOr + DeleteInstantSnapshotGroup( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest const& request) override; + + StatusOr + GetInstantSnapshotGroup( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + GetInstantSnapshotGroupRequest const& request) override; + + StatusOr GetIamPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + GetIamPolicyRequest const& request) override; + + google::cloud::future> + AsyncInsertInstantSnapshotGroup( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest const& request) override; + + StatusOr + InsertInstantSnapshotGroup( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest const& request) override; + + StatusOr + ListRegionInstantSnapshotGroups( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + ListRegionInstantSnapshotGroupsRequest const& request) override; + + StatusOr SetIamPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + SetIamPolicyRequest const& request) override; + + StatusOr + TestIamPermissions( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + TestIamPermissionsRequest const& request) override; + + google::cloud::future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) override; + + google::cloud::future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) override; + + private: + void SetMetadata(rest_internal::RestContext& rest_context, + Options const& options, + std::vector const& params = {}); + + std::shared_ptr child_; + std::string api_client_header_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_instant_snapshot_groups_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANT_SNAPSHOT_GROUPS_V1_INTERNAL_REGION_INSTANT_SNAPSHOT_GROUPS_REST_METADATA_DECORATOR_H diff --git a/google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_rest_stub.cc b/google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_rest_stub.cc new file mode 100644 index 0000000000000..43b27f1d6cf49 --- /dev/null +++ b/google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_rest_stub.cc @@ -0,0 +1,338 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups.proto + +#include "google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_rest_stub.h" +#include "google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups.pb.h" +#include "google/cloud/compute/region_operations/v1/region_operations.pb.h" +#include "google/cloud/common_options.h" +#include "google/cloud/internal/rest_stub_helpers.h" +#include "google/cloud/status_or.h" +#include "absl/strings/str_cat.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_instant_snapshot_groups_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +DefaultRegionInstantSnapshotGroupsRestStub:: + DefaultRegionInstantSnapshotGroupsRestStub(Options options) + : service_(rest_internal::MakePooledRestClient( + options.get(), options)), + operations_(rest_internal::MakePooledRestClient( + options.get(), options)), + options_(std::move(options)) {} + +DefaultRegionInstantSnapshotGroupsRestStub:: + DefaultRegionInstantSnapshotGroupsRestStub( + std::shared_ptr service, + std::shared_ptr operations, Options options) + : service_(std::move(service)), + operations_(std::move(operations)), + options_(std::move(options)) {} + +future> +DefaultRegionInstantSnapshotGroupsRestStub::AsyncDeleteInstantSnapshotGroup( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest const& request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto service, auto request, auto rest_context, auto options) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + p.set_value( + rest_internal::Delete( + *service, *rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", *options), + "/", "projects", "/", request.project(), "/", + "regions", "/", request.region(), "/", + "instantSnapshotGroups", "/", + request.instant_snapshot_group()), + std::move(query_params))); + }, + std::move(p), + service_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +StatusOr +DefaultRegionInstantSnapshotGroupsRestStub::DeleteInstantSnapshotGroup( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest const& request) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Delete( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "regions", "/", + request.region(), "/", "instantSnapshotGroups", "/", + request.instant_snapshot_group()), + std::move(query_params)); +} + +StatusOr +DefaultRegionInstantSnapshotGroupsRestStub::GetInstantSnapshotGroup( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + GetInstantSnapshotGroupRequest const& request) { + std::vector> query_params; + return rest_internal::Get< + google::cloud::cpp::compute::v1::InstantSnapshotGroup>( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "regions", "/", + request.region(), "/", "instantSnapshotGroups", "/", + request.instant_snapshot_group()), + std::move(query_params)); +} + +StatusOr +DefaultRegionInstantSnapshotGroupsRestStub::GetIamPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + GetIamPolicyRequest const& request) { + std::vector> query_params; + query_params.push_back( + {"options_requested_policy_version", + std::to_string(request.options_requested_policy_version())}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Get( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "regions", "/", + request.region(), "/", "instantSnapshotGroups", "/", + request.resource(), "/", "getIamPolicy"), + std::move(query_params)); +} + +future> +DefaultRegionInstantSnapshotGroupsRestStub::AsyncInsertInstantSnapshotGroup( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest const& request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto service, auto request, auto rest_context, auto options) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params.push_back( + {"source_consistency_group", request.source_consistency_group()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + p.set_value( + rest_internal::Post( + *service, *rest_context, + request.instant_snapshot_group_resource(), false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", *options), + "/", "projects", "/", request.project(), "/", + "regions", "/", request.region(), "/", + "instantSnapshotGroups"), + std::move(query_params))); + }, + std::move(p), + service_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +StatusOr +DefaultRegionInstantSnapshotGroupsRestStub::InsertInstantSnapshotGroup( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest const& request) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params.push_back( + {"source_consistency_group", request.source_consistency_group()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Post( + *service_, rest_context, request.instant_snapshot_group_resource(), false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "regions", "/", + request.region(), "/", "instantSnapshotGroups"), + std::move(query_params)); +} + +StatusOr +DefaultRegionInstantSnapshotGroupsRestStub::ListRegionInstantSnapshotGroups( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + ListRegionInstantSnapshotGroupsRequest const& request) { + std::vector> query_params; + query_params.push_back({"filter", request.filter()}); + query_params.push_back( + {"max_results", std::to_string(request.max_results())}); + query_params.push_back({"order_by", request.order_by()}); + query_params.push_back({"page_token", request.page_token()}); + query_params.push_back({"return_partial_success", + (request.return_partial_success() ? "1" : "0")}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Get< + google::cloud::cpp::compute::v1::ListInstantSnapshotGroups>( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "regions", "/", + request.region(), "/", "instantSnapshotGroups"), + std::move(query_params)); +} + +StatusOr +DefaultRegionInstantSnapshotGroupsRestStub::SetIamPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + SetIamPolicyRequest const& request) { + std::vector> query_params; + return rest_internal::Post( + *service_, rest_context, request.region_set_policy_request_resource(), + false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "regions", "/", + request.region(), "/", "instantSnapshotGroups", "/", + request.resource(), "/", "setIamPolicy"), + std::move(query_params)); +} + +StatusOr +DefaultRegionInstantSnapshotGroupsRestStub::TestIamPermissions( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + TestIamPermissionsRequest const& request) { + std::vector> query_params; + return rest_internal::Post< + google::cloud::cpp::compute::v1::TestPermissionsResponse>( + *service_, rest_context, request.test_permissions_request_resource(), + false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "regions", "/", + request.region(), "/", "instantSnapshotGroups", "/", + request.resource(), "/", "testIamPermissions"), + std::move(query_params)); +} + +future> +DefaultRegionInstantSnapshotGroupsRestStub::AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto operations, auto request, auto rest_context, + auto options) { + p.set_value( + rest_internal::Get( + *operations, *rest_context, request, false, + absl::StrCat("/compute/", + rest_internal::DetermineApiVersion("v1", *options), + "/projects/", request.project(), "/regions/", + request.region(), "/operations/", + request.operation()))); + }, + std::move(p), + operations_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +future DefaultRegionInstantSnapshotGroupsRestStub::AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + promise> p; + future> f = p.get_future(); + std::thread t{ + [](auto p, auto operations, auto request, auto rest_context, + auto options) { + p.set_value(rest_internal::Post( + *operations, *rest_context, request, false, + absl::StrCat( + "/compute/", rest_internal::DetermineApiVersion("v1", *options), + "/projects/", request.project(), "/regions/", request.region(), + "/operations/", request.operation()))); + }, + std::move(p), + operations_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get().status(); + }); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_instant_snapshot_groups_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_rest_stub.h b/google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_rest_stub.h new file mode 100644 index 0000000000000..81fa29c26835a --- /dev/null +++ b/google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_rest_stub.h @@ -0,0 +1,219 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANT_SNAPSHOT_GROUPS_V1_INTERNAL_REGION_INSTANT_SNAPSHOT_GROUPS_REST_STUB_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANT_SNAPSHOT_GROUPS_V1_INTERNAL_REGION_INSTANT_SNAPSHOT_GROUPS_REST_STUB_H + +#include "google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups.pb.h" +#include "google/cloud/compute/region_operations/v1/region_operations.pb.h" +#include "google/cloud/completion_queue.h" +#include "google/cloud/internal/rest_client.h" +#include "google/cloud/internal/rest_context.h" +#include "google/cloud/status_or.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_instant_snapshot_groups_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class RegionInstantSnapshotGroupsRestStub { + public: + virtual ~RegionInstantSnapshotGroupsRestStub() = default; + + virtual future> + AsyncDeleteInstantSnapshotGroup( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest const& request) = 0; + + virtual StatusOr + DeleteInstantSnapshotGroup( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest const& request) = 0; + + virtual StatusOr + GetInstantSnapshotGroup( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + GetInstantSnapshotGroupRequest const& request) = 0; + + virtual StatusOr GetIamPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + GetIamPolicyRequest const& request) = 0; + + virtual future> + AsyncInsertInstantSnapshotGroup( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest const& request) = 0; + + virtual StatusOr + InsertInstantSnapshotGroup( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest const& request) = 0; + + virtual StatusOr + ListRegionInstantSnapshotGroups( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + ListRegionInstantSnapshotGroupsRequest const& request) = 0; + + virtual StatusOr SetIamPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + SetIamPolicyRequest const& request) = 0; + + virtual StatusOr + TestIamPermissions( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + TestIamPermissionsRequest const& request) = 0; + + virtual future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) = 0; + + virtual future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) = 0; +}; + +class DefaultRegionInstantSnapshotGroupsRestStub + : public RegionInstantSnapshotGroupsRestStub { + public: + ~DefaultRegionInstantSnapshotGroupsRestStub() override = default; + + explicit DefaultRegionInstantSnapshotGroupsRestStub(Options options); + DefaultRegionInstantSnapshotGroupsRestStub( + std::shared_ptr service, + std::shared_ptr operations, Options options); + + future> + AsyncDeleteInstantSnapshotGroup( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest const& request) override; + + StatusOr + DeleteInstantSnapshotGroup( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest const& request) override; + + StatusOr + GetInstantSnapshotGroup( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + GetInstantSnapshotGroupRequest const& request) override; + + StatusOr GetIamPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + GetIamPolicyRequest const& request) override; + + future> + AsyncInsertInstantSnapshotGroup( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest const& request) override; + + StatusOr + InsertInstantSnapshotGroup( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest const& request) override; + + StatusOr + ListRegionInstantSnapshotGroups( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + ListRegionInstantSnapshotGroupsRequest const& request) override; + + StatusOr SetIamPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + SetIamPolicyRequest const& request) override; + + StatusOr + TestIamPermissions( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + TestIamPermissionsRequest const& request) override; + + future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) override; + + future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) override; + + private: + std::shared_ptr service_; + std::shared_ptr operations_; + Options options_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_instant_snapshot_groups_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANT_SNAPSHOT_GROUPS_V1_INTERNAL_REGION_INSTANT_SNAPSHOT_GROUPS_REST_STUB_H diff --git a/google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_rest_stub_factory.cc b/google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_rest_stub_factory.cc new file mode 100644 index 0000000000000..9c214b10b7c70 --- /dev/null +++ b/google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_rest_stub_factory.cc @@ -0,0 +1,59 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups.proto + +#include "google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_rest_stub_factory.h" +#include "google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_rest_logging_decorator.h" +#include "google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_rest_metadata_decorator.h" +#include "google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_rest_stub.h" +#include "google/cloud/common_options.h" +#include "google/cloud/internal/algorithm.h" +#include "google/cloud/internal/populate_rest_options.h" +#include "google/cloud/log.h" +#include "google/cloud/options.h" +#include "google/cloud/rest_options.h" +#include "absl/strings/match.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_instant_snapshot_groups_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +std::shared_ptr +CreateDefaultRegionInstantSnapshotGroupsRestStub(Options const& options) { + auto opts = internal::PopulateRestOptions(options); + std::shared_ptr stub = + std::make_shared( + std::move(opts)); + stub = std::make_shared( + std::move(stub)); + if (internal::Contains(options.get(), "rpc")) { + GCP_LOG(INFO) << "Enabled logging for REST rpc calls"; + stub = std::make_shared( + std::move(stub), options.get(), + options.get()); + } + return stub; +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_instant_snapshot_groups_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_rest_stub_factory.h b/google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_rest_stub_factory.h new file mode 100644 index 0000000000000..ce7f2ec134554 --- /dev/null +++ b/google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_rest_stub_factory.h @@ -0,0 +1,41 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANT_SNAPSHOT_GROUPS_V1_INTERNAL_REGION_INSTANT_SNAPSHOT_GROUPS_REST_STUB_FACTORY_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANT_SNAPSHOT_GROUPS_V1_INTERNAL_REGION_INSTANT_SNAPSHOT_GROUPS_REST_STUB_FACTORY_H + +#include "google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_rest_stub.h" +#include "google/cloud/options.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_instant_snapshot_groups_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +std::shared_ptr +CreateDefaultRegionInstantSnapshotGroupsRestStub(Options const& options); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_instant_snapshot_groups_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANT_SNAPSHOT_GROUPS_V1_INTERNAL_REGION_INSTANT_SNAPSHOT_GROUPS_REST_STUB_FACTORY_H diff --git a/google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_retry_traits.h b/google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_retry_traits.h new file mode 100644 index 0000000000000..06045848f1952 --- /dev/null +++ b/google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_retry_traits.h @@ -0,0 +1,44 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANT_SNAPSHOT_GROUPS_V1_INTERNAL_REGION_INSTANT_SNAPSHOT_GROUPS_RETRY_TRAITS_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANT_SNAPSHOT_GROUPS_V1_INTERNAL_REGION_INSTANT_SNAPSHOT_GROUPS_RETRY_TRAITS_H + +#include "google/cloud/status.h" +#include "google/cloud/version.h" + +namespace google { +namespace cloud { +namespace compute_region_instant_snapshot_groups_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/// Define the gRPC status code semantics for retrying requests. +struct RegionInstantSnapshotGroupsRetryTraits { + static bool IsPermanentFailure(google::cloud::Status const& status) { + return status.code() != StatusCode::kOk && + status.code() != StatusCode::kUnavailable; + } +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_instant_snapshot_groups_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANT_SNAPSHOT_GROUPS_V1_INTERNAL_REGION_INSTANT_SNAPSHOT_GROUPS_RETRY_TRAITS_H diff --git a/google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_sources.cc b/google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_sources.cc new file mode 100644 index 0000000000000..a393187fbad30 --- /dev/null +++ b/google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_sources.cc @@ -0,0 +1,32 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups.proto + +// NOLINTBEGIN(bugprone-suspicious-include) +#include "google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_option_defaults.cc" +#include "google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_rest_connection_impl.cc" +#include "google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_rest_logging_decorator.cc" +#include "google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_rest_metadata_decorator.cc" +#include "google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_rest_stub.cc" +#include "google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_rest_stub_factory.cc" +#include "google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_tracing_connection.cc" +#include "google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups_client.cc" +#include "google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups_connection.cc" +#include "google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups_connection_idempotency_policy.cc" +#include "google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups_rest_connection.cc" +// NOLINTEND(bugprone-suspicious-include) diff --git a/google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_tracing_connection.cc b/google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_tracing_connection.cc new file mode 100644 index 0000000000000..4d315ff2c9e3c --- /dev/null +++ b/google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_tracing_connection.cc @@ -0,0 +1,182 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups.proto + +#include "google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_tracing_connection.h" +#include "google/cloud/internal/opentelemetry.h" +#include "google/cloud/internal/traced_stream_range.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_instant_snapshot_groups_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +RegionInstantSnapshotGroupsTracingConnection:: + RegionInstantSnapshotGroupsTracingConnection( + std::shared_ptr + child) + : child_(std::move(child)) {} + +future> +RegionInstantSnapshotGroupsTracingConnection::DeleteInstantSnapshotGroup( + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest const& request) { + auto span = internal::MakeSpan( + "compute_region_instant_snapshot_groups_v1::" + "RegionInstantSnapshotGroupsConnection::DeleteInstantSnapshotGroup"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), + child_->DeleteInstantSnapshotGroup(request)); +} + +StatusOr +RegionInstantSnapshotGroupsTracingConnection::DeleteInstantSnapshotGroup( + NoAwaitTag, google::cloud::cpp::compute::region_instant_snapshot_groups:: + v1::DeleteInstantSnapshotGroupRequest const& request) { + auto span = internal::MakeSpan( + "compute_region_instant_snapshot_groups_v1::" + "RegionInstantSnapshotGroupsConnection::DeleteInstantSnapshotGroup"); + opentelemetry::trace::Scope scope(span); + return internal::EndSpan( + *span, child_->DeleteInstantSnapshotGroup(NoAwaitTag{}, request)); +} + +future> +RegionInstantSnapshotGroupsTracingConnection::DeleteInstantSnapshotGroup( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto span = internal::MakeSpan( + "compute_region_instant_snapshot_groups_v1::" + "RegionInstantSnapshotGroupsConnection::DeleteInstantSnapshotGroup"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), + child_->DeleteInstantSnapshotGroup(operation)); +} + +StatusOr +RegionInstantSnapshotGroupsTracingConnection::GetInstantSnapshotGroup( + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + GetInstantSnapshotGroupRequest const& request) { + auto span = internal::MakeSpan( + "compute_region_instant_snapshot_groups_v1::" + "RegionInstantSnapshotGroupsConnection::GetInstantSnapshotGroup"); + auto scope = opentelemetry::trace::Scope(span); + return internal::EndSpan(*span, child_->GetInstantSnapshotGroup(request)); +} + +StatusOr +RegionInstantSnapshotGroupsTracingConnection::GetIamPolicy( + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + GetIamPolicyRequest const& request) { + auto span = internal::MakeSpan( + "compute_region_instant_snapshot_groups_v1::" + "RegionInstantSnapshotGroupsConnection::GetIamPolicy"); + auto scope = opentelemetry::trace::Scope(span); + return internal::EndSpan(*span, child_->GetIamPolicy(request)); +} + +future> +RegionInstantSnapshotGroupsTracingConnection::InsertInstantSnapshotGroup( + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest const& request) { + auto span = internal::MakeSpan( + "compute_region_instant_snapshot_groups_v1::" + "RegionInstantSnapshotGroupsConnection::InsertInstantSnapshotGroup"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), + child_->InsertInstantSnapshotGroup(request)); +} + +StatusOr +RegionInstantSnapshotGroupsTracingConnection::InsertInstantSnapshotGroup( + NoAwaitTag, google::cloud::cpp::compute::region_instant_snapshot_groups:: + v1::InsertInstantSnapshotGroupRequest const& request) { + auto span = internal::MakeSpan( + "compute_region_instant_snapshot_groups_v1::" + "RegionInstantSnapshotGroupsConnection::InsertInstantSnapshotGroup"); + opentelemetry::trace::Scope scope(span); + return internal::EndSpan( + *span, child_->InsertInstantSnapshotGroup(NoAwaitTag{}, request)); +} + +future> +RegionInstantSnapshotGroupsTracingConnection::InsertInstantSnapshotGroup( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto span = internal::MakeSpan( + "compute_region_instant_snapshot_groups_v1::" + "RegionInstantSnapshotGroupsConnection::InsertInstantSnapshotGroup"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), + child_->InsertInstantSnapshotGroup(operation)); +} + +StreamRange +RegionInstantSnapshotGroupsTracingConnection::ListRegionInstantSnapshotGroups( + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + ListRegionInstantSnapshotGroupsRequest request) { + auto span = internal::MakeSpan( + "compute_region_instant_snapshot_groups_v1::" + "RegionInstantSnapshotGroupsConnection::ListRegionInstantSnapshotGroups"); + internal::OTelScope scope(span); + auto sr = child_->ListRegionInstantSnapshotGroups(std::move(request)); + return internal::MakeTracedStreamRange< + google::cloud::cpp::compute::v1::InstantSnapshotGroup>(std::move(span), + std::move(sr)); +} + +StatusOr +RegionInstantSnapshotGroupsTracingConnection::SetIamPolicy( + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + SetIamPolicyRequest const& request) { + auto span = internal::MakeSpan( + "compute_region_instant_snapshot_groups_v1::" + "RegionInstantSnapshotGroupsConnection::SetIamPolicy"); + auto scope = opentelemetry::trace::Scope(span); + return internal::EndSpan(*span, child_->SetIamPolicy(request)); +} + +StatusOr +RegionInstantSnapshotGroupsTracingConnection::TestIamPermissions( + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + TestIamPermissionsRequest const& request) { + auto span = internal::MakeSpan( + "compute_region_instant_snapshot_groups_v1::" + "RegionInstantSnapshotGroupsConnection::TestIamPermissions"); + auto scope = opentelemetry::trace::Scope(span); + return internal::EndSpan(*span, child_->TestIamPermissions(request)); +} + +std::shared_ptr +MakeRegionInstantSnapshotGroupsTracingConnection( + std::shared_ptr + conn) { + if (internal::TracingEnabled(conn->options())) { + conn = std::make_shared( + std::move(conn)); + } + return conn; +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_instant_snapshot_groups_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_tracing_connection.h b/google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_tracing_connection.h new file mode 100644 index 0000000000000..e46b8246031c5 --- /dev/null +++ b/google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_tracing_connection.h @@ -0,0 +1,122 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANT_SNAPSHOT_GROUPS_V1_INTERNAL_REGION_INSTANT_SNAPSHOT_GROUPS_TRACING_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANT_SNAPSHOT_GROUPS_V1_INTERNAL_REGION_INSTANT_SNAPSHOT_GROUPS_TRACING_CONNECTION_H + +#include "google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups_connection.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_instant_snapshot_groups_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class RegionInstantSnapshotGroupsTracingConnection + : public compute_region_instant_snapshot_groups_v1:: + RegionInstantSnapshotGroupsConnection { + public: + ~RegionInstantSnapshotGroupsTracingConnection() override = default; + + explicit RegionInstantSnapshotGroupsTracingConnection( + std::shared_ptr + child); + + Options options() override { return child_->options(); } + + future> + DeleteInstantSnapshotGroup( + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest const& request) override; + + StatusOr + DeleteInstantSnapshotGroup( + NoAwaitTag, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest const& request) override; + + future> + DeleteInstantSnapshotGroup( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + StatusOr + GetInstantSnapshotGroup( + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + GetInstantSnapshotGroupRequest const& request) override; + + StatusOr GetIamPolicy( + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + GetIamPolicyRequest const& request) override; + + future> + InsertInstantSnapshotGroup( + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest const& request) override; + + StatusOr + InsertInstantSnapshotGroup( + NoAwaitTag, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest const& request) override; + + future> + InsertInstantSnapshotGroup( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + StreamRange + ListRegionInstantSnapshotGroups( + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + ListRegionInstantSnapshotGroupsRequest request) override; + + StatusOr SetIamPolicy( + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + SetIamPolicyRequest const& request) override; + + StatusOr + TestIamPermissions( + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + TestIamPermissionsRequest const& request) override; + + private: + std::shared_ptr + child_; +}; + +/** + * Conditionally applies the tracing decorator to the given connection. + * + * The connection is only decorated if tracing is enabled (as determined by the + * connection's options). + */ +std::shared_ptr +MakeRegionInstantSnapshotGroupsTracingConnection( + std::shared_ptr + conn); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_instant_snapshot_groups_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANT_SNAPSHOT_GROUPS_V1_INTERNAL_REGION_INSTANT_SNAPSHOT_GROUPS_TRACING_CONNECTION_H diff --git a/google/cloud/compute/region_instant_snapshot_groups/v1/mocks/mock_region_instant_snapshot_groups_connection.h b/google/cloud/compute/region_instant_snapshot_groups/v1/mocks/mock_region_instant_snapshot_groups_connection.h new file mode 100644 index 0000000000000..0ff12a89caf50 --- /dev/null +++ b/google/cloud/compute/region_instant_snapshot_groups/v1/mocks/mock_region_instant_snapshot_groups_connection.h @@ -0,0 +1,172 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANT_SNAPSHOT_GROUPS_V1_MOCKS_MOCK_REGION_INSTANT_SNAPSHOT_GROUPS_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANT_SNAPSHOT_GROUPS_V1_MOCKS_MOCK_REGION_INSTANT_SNAPSHOT_GROUPS_CONNECTION_H + +#include "google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups_connection.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_instant_snapshot_groups_v1_mocks { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/** + * A class to mock `RegionInstantSnapshotGroupsConnection`. + * + * Application developers may want to test their code with simulated responses, + * including errors, from an object of type `RegionInstantSnapshotGroupsClient`. + * To do so, construct an object of type `RegionInstantSnapshotGroupsClient` + * with an instance of this class. Then use the Google Test framework functions + * to program the behavior of this mock. + * + * @see [This example][bq-mock] for how to test your application with GoogleTest. + * While the example showcases types from the BigQuery library, the underlying + * principles apply for any pair of `*Client` and `*Connection`. + * + * [bq-mock]: @cloud_cpp_docs_link{bigquery,bigquery-read-mock} + */ +class MockRegionInstantSnapshotGroupsConnection + : public compute_region_instant_snapshot_groups_v1:: + RegionInstantSnapshotGroupsConnection { + public: + MOCK_METHOD(Options, options, (), (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// DeleteInstantSnapshotGroup(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + DeleteInstantSnapshotGroup, + (google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// EXPECT_CALL(*mock, DeleteInstantSnapshotGroup(_, _)) + /// @endcode + MOCK_METHOD(StatusOr, + DeleteInstantSnapshotGroup, + (NoAwaitTag, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// DeleteInstantSnapshotGroup(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + DeleteInstantSnapshotGroup, + (google::cloud::cpp::compute::v1::Operation const& operation), + (override)); + + MOCK_METHOD(StatusOr, + GetInstantSnapshotGroup, + (google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + GetInstantSnapshotGroupRequest const& request), + (override)); + + MOCK_METHOD(StatusOr, GetIamPolicy, + (google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + GetIamPolicyRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// InsertInstantSnapshotGroup(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + InsertInstantSnapshotGroup, + (google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// EXPECT_CALL(*mock, InsertInstantSnapshotGroup(_, _)) + /// @endcode + MOCK_METHOD(StatusOr, + InsertInstantSnapshotGroup, + (NoAwaitTag, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// InsertInstantSnapshotGroup(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + InsertInstantSnapshotGroup, + (google::cloud::cpp::compute::v1::Operation const& operation), + (override)); + + MOCK_METHOD( + (StreamRange), + ListRegionInstantSnapshotGroups, + (google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + ListRegionInstantSnapshotGroupsRequest request), + (override)); + + MOCK_METHOD(StatusOr, SetIamPolicy, + (google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + SetIamPolicyRequest const& request), + (override)); + + MOCK_METHOD( + StatusOr, + TestIamPermissions, + (google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + TestIamPermissionsRequest const& request), + (override)); +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_instant_snapshot_groups_v1_mocks +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANT_SNAPSHOT_GROUPS_V1_MOCKS_MOCK_REGION_INSTANT_SNAPSHOT_GROUPS_CONNECTION_H diff --git a/google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups_client.cc b/google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups_client.cc new file mode 100644 index 0000000000000..95f6b9ef960ca --- /dev/null +++ b/google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups_client.cc @@ -0,0 +1,270 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups.proto + +#include "google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups_client.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_instant_snapshot_groups_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +RegionInstantSnapshotGroupsClient::RegionInstantSnapshotGroupsClient( + std::shared_ptr connection, + Options opts) + : connection_(std::move(connection)), + options_( + internal::MergeOptions(std::move(opts), connection_->options())) {} +RegionInstantSnapshotGroupsClient::~RegionInstantSnapshotGroupsClient() = + default; + +future> +RegionInstantSnapshotGroupsClient::DeleteInstantSnapshotGroup( + std::string const& project, std::string const& region, + std::string const& instant_snapshot_group, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest request; + request.set_project(project); + request.set_region(region); + request.set_instant_snapshot_group(instant_snapshot_group); + return connection_->DeleteInstantSnapshotGroup(request); +} + +StatusOr +RegionInstantSnapshotGroupsClient::DeleteInstantSnapshotGroup( + NoAwaitTag, std::string const& project, std::string const& region, + std::string const& instant_snapshot_group, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest request; + request.set_project(project); + request.set_region(region); + request.set_instant_snapshot_group(instant_snapshot_group); + return connection_->DeleteInstantSnapshotGroup(NoAwaitTag{}, request); +} + +future> +RegionInstantSnapshotGroupsClient::DeleteInstantSnapshotGroup( + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->DeleteInstantSnapshotGroup(request); +} + +StatusOr +RegionInstantSnapshotGroupsClient::DeleteInstantSnapshotGroup( + NoAwaitTag, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->DeleteInstantSnapshotGroup(NoAwaitTag{}, request); +} + +future> +RegionInstantSnapshotGroupsClient::DeleteInstantSnapshotGroup( + google::cloud::cpp::compute::v1::Operation const& operation, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->DeleteInstantSnapshotGroup(operation); +} + +StatusOr +RegionInstantSnapshotGroupsClient::GetInstantSnapshotGroup( + std::string const& project, std::string const& region, + std::string const& instant_snapshot_group, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + GetInstantSnapshotGroupRequest request; + request.set_project(project); + request.set_region(region); + request.set_instant_snapshot_group(instant_snapshot_group); + return connection_->GetInstantSnapshotGroup(request); +} + +StatusOr +RegionInstantSnapshotGroupsClient::GetInstantSnapshotGroup( + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + GetInstantSnapshotGroupRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->GetInstantSnapshotGroup(request); +} + +StatusOr +RegionInstantSnapshotGroupsClient::GetIamPolicy(std::string const& project, + std::string const& region, + std::string const& resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + GetIamPolicyRequest request; + request.set_project(project); + request.set_region(region); + request.set_resource(resource); + return connection_->GetIamPolicy(request); +} + +StatusOr +RegionInstantSnapshotGroupsClient::GetIamPolicy( + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + GetIamPolicyRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->GetIamPolicy(request); +} + +future> +RegionInstantSnapshotGroupsClient::InsertInstantSnapshotGroup( + std::string const& project, std::string const& region, + google::cloud::cpp::compute::v1::InstantSnapshotGroup const& + instant_snapshot_group_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest request; + request.set_project(project); + request.set_region(region); + *request.mutable_instant_snapshot_group_resource() = + instant_snapshot_group_resource; + return connection_->InsertInstantSnapshotGroup(request); +} + +StatusOr +RegionInstantSnapshotGroupsClient::InsertInstantSnapshotGroup( + NoAwaitTag, std::string const& project, std::string const& region, + google::cloud::cpp::compute::v1::InstantSnapshotGroup const& + instant_snapshot_group_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest request; + request.set_project(project); + request.set_region(region); + *request.mutable_instant_snapshot_group_resource() = + instant_snapshot_group_resource; + return connection_->InsertInstantSnapshotGroup(NoAwaitTag{}, request); +} + +future> +RegionInstantSnapshotGroupsClient::InsertInstantSnapshotGroup( + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->InsertInstantSnapshotGroup(request); +} + +StatusOr +RegionInstantSnapshotGroupsClient::InsertInstantSnapshotGroup( + NoAwaitTag, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->InsertInstantSnapshotGroup(NoAwaitTag{}, request); +} + +future> +RegionInstantSnapshotGroupsClient::InsertInstantSnapshotGroup( + google::cloud::cpp::compute::v1::Operation const& operation, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->InsertInstantSnapshotGroup(operation); +} + +StreamRange +RegionInstantSnapshotGroupsClient::ListRegionInstantSnapshotGroups( + std::string const& project, std::string const& region, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + ListRegionInstantSnapshotGroupsRequest request; + request.set_project(project); + request.set_region(region); + return connection_->ListRegionInstantSnapshotGroups(request); +} + +StreamRange +RegionInstantSnapshotGroupsClient::ListRegionInstantSnapshotGroups( + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + ListRegionInstantSnapshotGroupsRequest request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->ListRegionInstantSnapshotGroups(std::move(request)); +} + +StatusOr +RegionInstantSnapshotGroupsClient::SetIamPolicy( + std::string const& project, std::string const& region, + std::string const& resource, + google::cloud::cpp::compute::v1::RegionSetPolicyRequest const& + region_set_policy_request_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + SetIamPolicyRequest request; + request.set_project(project); + request.set_region(region); + request.set_resource(resource); + *request.mutable_region_set_policy_request_resource() = + region_set_policy_request_resource; + return connection_->SetIamPolicy(request); +} + +StatusOr +RegionInstantSnapshotGroupsClient::SetIamPolicy( + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + SetIamPolicyRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->SetIamPolicy(request); +} + +StatusOr +RegionInstantSnapshotGroupsClient::TestIamPermissions( + std::string const& project, std::string const& region, + std::string const& resource, + google::cloud::cpp::compute::v1::TestPermissionsRequest const& + test_permissions_request_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + TestIamPermissionsRequest request; + request.set_project(project); + request.set_region(region); + request.set_resource(resource); + *request.mutable_test_permissions_request_resource() = + test_permissions_request_resource; + return connection_->TestIamPermissions(request); +} + +StatusOr +RegionInstantSnapshotGroupsClient::TestIamPermissions( + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + TestIamPermissionsRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->TestIamPermissions(request); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_instant_snapshot_groups_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups_client.h b/google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups_client.h new file mode 100644 index 0000000000000..4fdcc9e5c86d0 --- /dev/null +++ b/google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups_client.h @@ -0,0 +1,708 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANT_SNAPSHOT_GROUPS_V1_REGION_INSTANT_SNAPSHOT_GROUPS_CLIENT_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANT_SNAPSHOT_GROUPS_V1_REGION_INSTANT_SNAPSHOT_GROUPS_CLIENT_H + +#include "google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups_rest_connection.h" +#include "google/cloud/future.h" +#include "google/cloud/no_await_tag.h" +#include "google/cloud/options.h" +#include "google/cloud/polling_policy.h" +#include "google/cloud/status_or.h" +#include "google/cloud/version.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_instant_snapshot_groups_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/// +/// Service for the regionInstantSnapshotGroups resource. +/// https://cloud.google.com/compute/docs/reference/rest/v1/regionInstantSnapshotGroups +/// +/// @par Equality +/// +/// Instances of this class created via copy-construction or copy-assignment +/// always compare equal. Instances created with equal +/// `std::shared_ptr<*Connection>` objects compare equal. Objects that compare +/// equal share the same underlying resources. +/// +/// @par Performance +/// +/// Creating a new instance of this class is a relatively expensive operation, +/// new objects establish new connections to the service. In contrast, +/// copy-construction, move-construction, and the corresponding assignment +/// operations are relatively efficient as the copies share all underlying +/// resources. +/// +/// @par Thread Safety +/// +/// Concurrent access to different instances of this class, even if they compare +/// equal, is guaranteed to work. Two or more threads operating on the same +/// instance of this class is not guaranteed to work. Since copy-construction +/// and move-construction is a relatively efficient operation, consider using +/// such a copy when using this class from multiple threads. +/// +class RegionInstantSnapshotGroupsClient { + public: + explicit RegionInstantSnapshotGroupsClient( + std::shared_ptr connection, + Options opts = {}); + ~RegionInstantSnapshotGroupsClient(); + + ///@{ + /// @name Copy and move support + RegionInstantSnapshotGroupsClient(RegionInstantSnapshotGroupsClient const&) = + default; + RegionInstantSnapshotGroupsClient& operator=( + RegionInstantSnapshotGroupsClient const&) = default; + RegionInstantSnapshotGroupsClient(RegionInstantSnapshotGroupsClient&&) = + default; + RegionInstantSnapshotGroupsClient& operator=( + RegionInstantSnapshotGroupsClient&&) = default; + ///@} + + ///@{ + /// @name Equality + friend bool operator==(RegionInstantSnapshotGroupsClient const& a, + RegionInstantSnapshotGroupsClient const& b) { + return a.connection_ == b.connection_; + } + friend bool operator!=(RegionInstantSnapshotGroupsClient const& a, + RegionInstantSnapshotGroupsClient const& b) { + return !(a == b); + } + ///@} + + // clang-format off + /// + /// deletes a Regional InstantSnapshotGroup resource + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionInstantSnapshotGroups/delete + /// + /// @param project Project ID for this request. + /// @param region The name of the region for this request. + /// @param instant_snapshot_group Name of the InstantSnapshotGroup resource to delete. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_instant_snapshot_groups.v1.DeleteInstantSnapshotGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups.proto#L129} + /// + // clang-format on + future> + DeleteInstantSnapshotGroup(std::string const& project, + std::string const& region, + std::string const& instant_snapshot_group, + Options opts = {}); + + // clang-format off + /// + /// @copybrief DeleteInstantSnapshotGroup + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr + DeleteInstantSnapshotGroup(NoAwaitTag, std::string const& project, + std::string const& region, + std::string const& instant_snapshot_group, + Options opts = {}); + + // clang-format off + /// + /// deletes a Regional InstantSnapshotGroup resource + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionInstantSnapshotGroups/delete + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.region_instant_snapshot_groups.v1.DeleteInstantSnapshotGroupRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_instant_snapshot_groups.v1.DeleteInstantSnapshotGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups.proto#L129} + /// + // clang-format on + future> + DeleteInstantSnapshotGroup( + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief DeleteInstantSnapshotGroup + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr + DeleteInstantSnapshotGroup( + NoAwaitTag, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief DeleteInstantSnapshotGroup + /// + /// This method accepts a `google::cloud::cpp::compute::v1::Operation` that corresponds + /// to a previously started Long Running Operation (LRO) and polls the status + /// of the LRO in the background. + /// + // clang-format on + future> + DeleteInstantSnapshotGroup( + google::cloud::cpp::compute::v1::Operation const& operation, + Options opts = {}); + + // clang-format off + /// + /// returns the specified InstantSnapshotGroup resource in the specified + /// region. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionInstantSnapshotGroups/get + /// + /// @param project Project ID for this request. + /// @param region The name of the region for this request. + /// @param instant_snapshot_group Name of the InstantSnapshotGroup resource to return. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.InstantSnapshotGroup]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_instant_snapshot_groups.v1.GetInstantSnapshotGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups.proto#L186} + /// [google.cloud.cpp.compute.v1.InstantSnapshotGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_083.proto#L28} + /// + // clang-format on + StatusOr + GetInstantSnapshotGroup(std::string const& project, std::string const& region, + std::string const& instant_snapshot_group, + Options opts = {}); + + // clang-format off + /// + /// returns the specified InstantSnapshotGroup resource in the specified + /// region. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionInstantSnapshotGroups/get + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.region_instant_snapshot_groups.v1.GetInstantSnapshotGroupRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.InstantSnapshotGroup]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_instant_snapshot_groups.v1.GetInstantSnapshotGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups.proto#L186} + /// [google.cloud.cpp.compute.v1.InstantSnapshotGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_083.proto#L28} + /// + // clang-format on + StatusOr + GetInstantSnapshotGroup( + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + GetInstantSnapshotGroupRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// Gets the access control policy for a resource. May be empty if no such + /// policy or resource exists. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionInstantSnapshotGroups/getIamPolicy + /// + /// @param project Project ID for this request. + /// @param region The name of the region for this request. + /// @param resource Name or id of the resource for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.Policy]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_instant_snapshot_groups.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups.proto#L167} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} + /// + // clang-format on + StatusOr GetIamPolicy( + std::string const& project, std::string const& region, + std::string const& resource, Options opts = {}); + + // clang-format off + /// + /// Gets the access control policy for a resource. May be empty if no such + /// policy or resource exists. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionInstantSnapshotGroups/getIamPolicy + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.region_instant_snapshot_groups.v1.GetIamPolicyRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.Policy]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_instant_snapshot_groups.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups.proto#L167} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} + /// + // clang-format on + StatusOr GetIamPolicy( + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + GetIamPolicyRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// creates a Regional InstantSnapshotGroup resource + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionInstantSnapshotGroups/insert + /// + /// @param project Project ID for this request. + /// @param region Name of the region for this request. + /// @param instant_snapshot_group_resource The InstantSnapshotGroup for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_instant_snapshot_groups.v1.InsertInstantSnapshotGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups.proto#L203} + /// + // clang-format on + future> + InsertInstantSnapshotGroup( + std::string const& project, std::string const& region, + google::cloud::cpp::compute::v1::InstantSnapshotGroup const& + instant_snapshot_group_resource, + Options opts = {}); + + // clang-format off + /// + /// @copybrief InsertInstantSnapshotGroup + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr + InsertInstantSnapshotGroup( + NoAwaitTag, std::string const& project, std::string const& region, + google::cloud::cpp::compute::v1::InstantSnapshotGroup const& + instant_snapshot_group_resource, + Options opts = {}); + + // clang-format off + /// + /// creates a Regional InstantSnapshotGroup resource + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionInstantSnapshotGroups/insert + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.region_instant_snapshot_groups.v1.InsertInstantSnapshotGroupRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_instant_snapshot_groups.v1.InsertInstantSnapshotGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups.proto#L203} + /// + // clang-format on + future> + InsertInstantSnapshotGroup( + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief InsertInstantSnapshotGroup + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr + InsertInstantSnapshotGroup( + NoAwaitTag, + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief InsertInstantSnapshotGroup + /// + /// This method accepts a `google::cloud::cpp::compute::v1::Operation` that corresponds + /// to a previously started Long Running Operation (LRO) and polls the status + /// of the LRO in the background. + /// + // clang-format on + future> + InsertInstantSnapshotGroup( + google::cloud::cpp::compute::v1::Operation const& operation, + Options opts = {}); + + // clang-format off + /// + /// retrieves the list of InstantSnapshotGroup resources contained within + /// the specified region. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionInstantSnapshotGroups/list + /// + /// @param project Project ID for this request. + /// @param region The name of the region for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return a [StreamRange](@ref google::cloud::StreamRange) + /// to iterate of the results. See the documentation of this type for + /// details. In brief, this class has `begin()` and `end()` member + /// functions returning a iterator class meeting the + /// [input iterator requirements]. The value type for this iterator is a + /// [`StatusOr`] as the iteration may fail even after some values are + /// retrieved successfully, for example, if there is a network disconnect. + /// An empty set of results does not indicate an error, it indicates + /// that there are no resources meeting the request criteria. + /// On a successful iteration the `StatusOr` contains elements of type + /// [google.cloud.cpp.compute.v1.InstantSnapshotGroup], or rather, + /// the C++ class generated by Protobuf from that type. Please consult the + /// Protobuf documentation for details on the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_instant_snapshot_groups.v1.ListRegionInstantSnapshotGroupsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups.proto#L243} + /// [google.cloud.cpp.compute.v1.InstantSnapshotGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_083.proto#L28} + /// + // clang-format on + StreamRange + ListRegionInstantSnapshotGroups(std::string const& project, + std::string const& region, Options opts = {}); + + // clang-format off + /// + /// retrieves the list of InstantSnapshotGroup resources contained within + /// the specified region. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionInstantSnapshotGroups/list + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.region_instant_snapshot_groups.v1.ListRegionInstantSnapshotGroupsRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return a [StreamRange](@ref google::cloud::StreamRange) + /// to iterate of the results. See the documentation of this type for + /// details. In brief, this class has `begin()` and `end()` member + /// functions returning a iterator class meeting the + /// [input iterator requirements]. The value type for this iterator is a + /// [`StatusOr`] as the iteration may fail even after some values are + /// retrieved successfully, for example, if there is a network disconnect. + /// An empty set of results does not indicate an error, it indicates + /// that there are no resources meeting the request criteria. + /// On a successful iteration the `StatusOr` contains elements of type + /// [google.cloud.cpp.compute.v1.InstantSnapshotGroup], or rather, + /// the C++ class generated by Protobuf from that type. Please consult the + /// Protobuf documentation for details on the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_instant_snapshot_groups.v1.ListRegionInstantSnapshotGroupsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups.proto#L243} + /// [google.cloud.cpp.compute.v1.InstantSnapshotGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_083.proto#L28} + /// + // clang-format on + StreamRange + ListRegionInstantSnapshotGroups( + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + ListRegionInstantSnapshotGroupsRequest request, + Options opts = {}); + + // clang-format off + /// + /// Sets the access control policy on the specified resource. + /// Replaces any existing policy. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionInstantSnapshotGroups/setIamPolicy + /// + /// @param project Project ID for this request. + /// @param region The name of the region for this request. + /// @param resource Name or id of the resource for this request. + /// @param region_set_policy_request_resource The RegionSetPolicyRequest for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.Policy]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_instant_snapshot_groups.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups.proto#L348} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} + /// + // clang-format on + StatusOr SetIamPolicy( + std::string const& project, std::string const& region, + std::string const& resource, + google::cloud::cpp::compute::v1::RegionSetPolicyRequest const& + region_set_policy_request_resource, + Options opts = {}); + + // clang-format off + /// + /// Sets the access control policy on the specified resource. + /// Replaces any existing policy. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionInstantSnapshotGroups/setIamPolicy + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.region_instant_snapshot_groups.v1.SetIamPolicyRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.Policy]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_instant_snapshot_groups.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups.proto#L348} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} + /// + // clang-format on + StatusOr SetIamPolicy( + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + SetIamPolicyRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// Returns permissions that a caller has on the specified resource. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionInstantSnapshotGroups/testIamPermissions + /// + /// @param project Project ID for this request. + /// @param region The name of the region for this request. + /// @param resource Name or id of the resource for this request. + /// @param test_permissions_request_resource The TestPermissionsRequest for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.TestPermissionsResponse]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_instant_snapshot_groups.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups.proto#L368} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} + /// + // clang-format on + StatusOr + TestIamPermissions( + std::string const& project, std::string const& region, + std::string const& resource, + google::cloud::cpp::compute::v1::TestPermissionsRequest const& + test_permissions_request_resource, + Options opts = {}); + + // clang-format off + /// + /// Returns permissions that a caller has on the specified resource. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionInstantSnapshotGroups/testIamPermissions + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.region_instant_snapshot_groups.v1.TestIamPermissionsRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.TestPermissionsResponse]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_instant_snapshot_groups.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups.proto#L368} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} + /// + // clang-format on + StatusOr + TestIamPermissions( + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + TestIamPermissionsRequest const& request, + Options opts = {}); + + private: + std::shared_ptr connection_; + Options options_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_instant_snapshot_groups_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANT_SNAPSHOT_GROUPS_V1_REGION_INSTANT_SNAPSHOT_GROUPS_CLIENT_H diff --git a/google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups_connection.cc b/google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups_connection.cc new file mode 100644 index 0000000000000..5e8d89e22552f --- /dev/null +++ b/google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups_connection.cc @@ -0,0 +1,130 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups.proto + +#include "google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups_connection.h" +#include "google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_option_defaults.h" +#include "google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_tracing_connection.h" +#include "google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups_options.h" +#include "google/cloud/background_threads.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/grpc_options.h" +#include "google/cloud/internal/pagination_range.h" +#include "google/cloud/internal/unified_grpc_credentials.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_instant_snapshot_groups_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +RegionInstantSnapshotGroupsConnection:: + ~RegionInstantSnapshotGroupsConnection() = default; + +future> +RegionInstantSnapshotGroupsConnection::DeleteInstantSnapshotGroup( + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +RegionInstantSnapshotGroupsConnection::DeleteInstantSnapshotGroup( + NoAwaitTag, google::cloud::cpp::compute::region_instant_snapshot_groups:: + v1::DeleteInstantSnapshotGroupRequest const&) { + return StatusOr( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +RegionInstantSnapshotGroupsConnection::DeleteInstantSnapshotGroup( + google::cloud::cpp::compute::v1::Operation const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +RegionInstantSnapshotGroupsConnection::GetInstantSnapshotGroup( + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + GetInstantSnapshotGroupRequest const&) { + return Status(StatusCode::kUnimplemented, "not implemented"); +} + +StatusOr +RegionInstantSnapshotGroupsConnection::GetIamPolicy( + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + GetIamPolicyRequest const&) { + return Status(StatusCode::kUnimplemented, "not implemented"); +} + +future> +RegionInstantSnapshotGroupsConnection::InsertInstantSnapshotGroup( + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +RegionInstantSnapshotGroupsConnection::InsertInstantSnapshotGroup( + NoAwaitTag, google::cloud::cpp::compute::region_instant_snapshot_groups:: + v1::InsertInstantSnapshotGroupRequest const&) { + return StatusOr( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +RegionInstantSnapshotGroupsConnection::InsertInstantSnapshotGroup( + google::cloud::cpp::compute::v1::Operation const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StreamRange +RegionInstantSnapshotGroupsConnection::ListRegionInstantSnapshotGroups( + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + ListRegionInstantSnapshotGroupsRequest) { // NOLINT(performance-unnecessary-value-param) + return google::cloud::internal::MakeUnimplementedPaginationRange< + StreamRange>(); +} + +StatusOr +RegionInstantSnapshotGroupsConnection::SetIamPolicy( + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + SetIamPolicyRequest const&) { + return Status(StatusCode::kUnimplemented, "not implemented"); +} + +StatusOr +RegionInstantSnapshotGroupsConnection::TestIamPermissions( + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + TestIamPermissionsRequest const&) { + return Status(StatusCode::kUnimplemented, "not implemented"); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_instant_snapshot_groups_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups_connection.h b/google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups_connection.h new file mode 100644 index 0000000000000..b4c01f31094a6 --- /dev/null +++ b/google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups_connection.h @@ -0,0 +1,265 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANT_SNAPSHOT_GROUPS_V1_REGION_INSTANT_SNAPSHOT_GROUPS_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANT_SNAPSHOT_GROUPS_V1_REGION_INSTANT_SNAPSHOT_GROUPS_CONNECTION_H + +#include "google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_retry_traits.h" +#include "google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups.pb.h" +#include "google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups_connection_idempotency_policy.h" +#include "google/cloud/backoff_policy.h" +#include "google/cloud/future.h" +#include "google/cloud/internal/retry_policy_impl.h" +#include "google/cloud/no_await_tag.h" +#include "google/cloud/options.h" +#include "google/cloud/polling_policy.h" +#include "google/cloud/status_or.h" +#include "google/cloud/stream_range.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_instant_snapshot_groups_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/// The retry policy for `RegionInstantSnapshotGroupsConnection`. +class RegionInstantSnapshotGroupsRetryPolicy + : public ::google::cloud::RetryPolicy { + public: + /// Creates a new instance of the policy, reset to the initial state. + virtual std::unique_ptr clone() + const = 0; +}; + +/** + * A retry policy for `RegionInstantSnapshotGroupsConnection` based on counting + * errors. + * + * This policy stops retrying if: + * - An RPC returns a non-transient error. + * - More than a prescribed number of transient failures is detected. + * + * In this class the following status codes are treated as transient errors: + * - [`kUnavailable`](@ref google::cloud::StatusCode) + */ +class RegionInstantSnapshotGroupsLimitedErrorCountRetryPolicy + : public RegionInstantSnapshotGroupsRetryPolicy { + public: + /** + * Create an instance that tolerates up to @p maximum_failures transient + * errors. + * + * @note Disable the retry loop by providing an instance of this policy with + * @p maximum_failures == 0. + */ + explicit RegionInstantSnapshotGroupsLimitedErrorCountRetryPolicy( + int maximum_failures) + : impl_(maximum_failures) {} + + RegionInstantSnapshotGroupsLimitedErrorCountRetryPolicy( + RegionInstantSnapshotGroupsLimitedErrorCountRetryPolicy&& rhs) noexcept + : RegionInstantSnapshotGroupsLimitedErrorCountRetryPolicy( + rhs.maximum_failures()) {} + RegionInstantSnapshotGroupsLimitedErrorCountRetryPolicy( + RegionInstantSnapshotGroupsLimitedErrorCountRetryPolicy const& + rhs) noexcept + : RegionInstantSnapshotGroupsLimitedErrorCountRetryPolicy( + rhs.maximum_failures()) {} + + int maximum_failures() const { return impl_.maximum_failures(); } + + bool OnFailure(Status const& status) override { + return impl_.OnFailure(status); + } + bool IsExhausted() const override { return impl_.IsExhausted(); } + bool IsPermanentFailure(Status const& status) const override { + return impl_.IsPermanentFailure(status); + } + std::unique_ptr clone() + const override { + return std::make_unique< + RegionInstantSnapshotGroupsLimitedErrorCountRetryPolicy>( + maximum_failures()); + } + + // This is provided only for backwards compatibility. + using BaseType = RegionInstantSnapshotGroupsRetryPolicy; + + private: + google::cloud::internal::LimitedErrorCountRetryPolicy< + compute_region_instant_snapshot_groups_v1_internal:: + RegionInstantSnapshotGroupsRetryTraits> + impl_; +}; + +/** + * A retry policy for `RegionInstantSnapshotGroupsConnection` based on elapsed + * time. + * + * This policy stops retrying if: + * - An RPC returns a non-transient error. + * - The elapsed time in the retry loop exceeds a prescribed duration. + * + * In this class the following status codes are treated as transient errors: + * - [`kUnavailable`](@ref google::cloud::StatusCode) + */ +class RegionInstantSnapshotGroupsLimitedTimeRetryPolicy + : public RegionInstantSnapshotGroupsRetryPolicy { + public: + /** + * Constructor given a `std::chrono::duration<>` object. + * + * @tparam DurationRep a placeholder to match the `Rep` tparam for @p + * duration's type. The semantics of this template parameter are + * documented in `std::chrono::duration<>`. In brief, the underlying + * arithmetic type used to store the number of ticks. For our purposes it + * is simply a formal parameter. + * @tparam DurationPeriod a placeholder to match the `Period` tparam for @p + * duration's type. The semantics of this template parameter are + * documented in `std::chrono::duration<>`. In brief, the length of the + * tick in seconds, expressed as a `std::ratio<>`. For our purposes it is + * simply a formal parameter. + * @param maximum_duration the maximum time allowed before the policy expires. + * While the application can express this time in any units they desire, + * the class truncates to milliseconds. + * + * @see https://en.cppreference.com/w/cpp/chrono/duration for more information + * about `std::chrono::duration`. + */ + template + explicit RegionInstantSnapshotGroupsLimitedTimeRetryPolicy( + std::chrono::duration maximum_duration) + : impl_(maximum_duration) {} + + RegionInstantSnapshotGroupsLimitedTimeRetryPolicy( + RegionInstantSnapshotGroupsLimitedTimeRetryPolicy&& rhs) noexcept + : RegionInstantSnapshotGroupsLimitedTimeRetryPolicy( + rhs.maximum_duration()) {} + RegionInstantSnapshotGroupsLimitedTimeRetryPolicy( + RegionInstantSnapshotGroupsLimitedTimeRetryPolicy const& rhs) noexcept + : RegionInstantSnapshotGroupsLimitedTimeRetryPolicy( + rhs.maximum_duration()) {} + + std::chrono::milliseconds maximum_duration() const { + return impl_.maximum_duration(); + } + + bool OnFailure(Status const& status) override { + return impl_.OnFailure(status); + } + bool IsExhausted() const override { return impl_.IsExhausted(); } + bool IsPermanentFailure(Status const& status) const override { + return impl_.IsPermanentFailure(status); + } + std::unique_ptr clone() + const override { + return std::make_unique( + maximum_duration()); + } + + // This is provided only for backwards compatibility. + using BaseType = RegionInstantSnapshotGroupsRetryPolicy; + + private: + google::cloud::internal::LimitedTimeRetryPolicy< + compute_region_instant_snapshot_groups_v1_internal:: + RegionInstantSnapshotGroupsRetryTraits> + impl_; +}; + +/** + * The `RegionInstantSnapshotGroupsConnection` object for + * `RegionInstantSnapshotGroupsClient`. + * + * This interface defines virtual methods for each of the user-facing overload + * sets in `RegionInstantSnapshotGroupsClient`. This allows users to inject + * custom behavior (e.g., with a Google Mock object) when writing tests that use + * objects of type `RegionInstantSnapshotGroupsClient`. + * + * To create a concrete instance, see + * `MakeRegionInstantSnapshotGroupsConnection()`. + * + * For mocking, see + * `compute_region_instant_snapshot_groups_v1_mocks::MockRegionInstantSnapshotGroupsConnection`. + */ +class RegionInstantSnapshotGroupsConnection { + public: + virtual ~RegionInstantSnapshotGroupsConnection() = 0; + + virtual Options options() { return Options{}; } + + virtual future> + DeleteInstantSnapshotGroup( + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest const& request); + + virtual StatusOr + DeleteInstantSnapshotGroup( + NoAwaitTag, google::cloud::cpp::compute::region_instant_snapshot_groups:: + v1::DeleteInstantSnapshotGroupRequest const& request); + + virtual future> + DeleteInstantSnapshotGroup( + google::cloud::cpp::compute::v1::Operation const& operation); + + virtual StatusOr + GetInstantSnapshotGroup( + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + GetInstantSnapshotGroupRequest const& request); + + virtual StatusOr GetIamPolicy( + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + GetIamPolicyRequest const& request); + + virtual future> + InsertInstantSnapshotGroup( + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest const& request); + + virtual StatusOr + InsertInstantSnapshotGroup( + NoAwaitTag, google::cloud::cpp::compute::region_instant_snapshot_groups:: + v1::InsertInstantSnapshotGroupRequest const& request); + + virtual future> + InsertInstantSnapshotGroup( + google::cloud::cpp::compute::v1::Operation const& operation); + + virtual StreamRange + ListRegionInstantSnapshotGroups( + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + ListRegionInstantSnapshotGroupsRequest request); + + virtual StatusOr SetIamPolicy( + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + SetIamPolicyRequest const& request); + + virtual StatusOr + TestIamPermissions( + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + TestIamPermissionsRequest const& request); +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_instant_snapshot_groups_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANT_SNAPSHOT_GROUPS_V1_REGION_INSTANT_SNAPSHOT_GROUPS_CONNECTION_H diff --git a/google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups_connection_idempotency_policy.cc b/google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups_connection_idempotency_policy.cc new file mode 100644 index 0000000000000..ee6805fe5e81a --- /dev/null +++ b/google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups_connection_idempotency_policy.cc @@ -0,0 +1,97 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups.proto + +#include "google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups_connection_idempotency_policy.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_instant_snapshot_groups_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +using ::google::cloud::Idempotency; + +RegionInstantSnapshotGroupsConnectionIdempotencyPolicy:: + ~RegionInstantSnapshotGroupsConnectionIdempotencyPolicy() = default; + +std::unique_ptr +RegionInstantSnapshotGroupsConnectionIdempotencyPolicy::clone() const { + return std::make_unique< + RegionInstantSnapshotGroupsConnectionIdempotencyPolicy>(*this); +} + +Idempotency RegionInstantSnapshotGroupsConnectionIdempotencyPolicy:: + DeleteInstantSnapshotGroup( + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest const&) { + return Idempotency::kNonIdempotent; +} + +Idempotency +RegionInstantSnapshotGroupsConnectionIdempotencyPolicy::GetInstantSnapshotGroup( + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + GetInstantSnapshotGroupRequest const&) { + return Idempotency::kIdempotent; +} + +Idempotency +RegionInstantSnapshotGroupsConnectionIdempotencyPolicy::GetIamPolicy( + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + GetIamPolicyRequest const&) { + return Idempotency::kIdempotent; +} + +Idempotency RegionInstantSnapshotGroupsConnectionIdempotencyPolicy:: + InsertInstantSnapshotGroup( + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest const&) { + return Idempotency::kNonIdempotent; +} + +Idempotency RegionInstantSnapshotGroupsConnectionIdempotencyPolicy:: + ListRegionInstantSnapshotGroups( + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + ListRegionInstantSnapshotGroupsRequest) { // NOLINT + return Idempotency::kIdempotent; +} + +Idempotency +RegionInstantSnapshotGroupsConnectionIdempotencyPolicy::SetIamPolicy( + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + SetIamPolicyRequest const&) { + return Idempotency::kNonIdempotent; +} + +Idempotency +RegionInstantSnapshotGroupsConnectionIdempotencyPolicy::TestIamPermissions( + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + TestIamPermissionsRequest const&) { + return Idempotency::kNonIdempotent; +} + +std::unique_ptr +MakeDefaultRegionInstantSnapshotGroupsConnectionIdempotencyPolicy() { + return std::make_unique< + RegionInstantSnapshotGroupsConnectionIdempotencyPolicy>(); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_instant_snapshot_groups_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups_connection_idempotency_policy.h b/google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups_connection_idempotency_policy.h new file mode 100644 index 0000000000000..c9c3f9d18a317 --- /dev/null +++ b/google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups_connection_idempotency_policy.h @@ -0,0 +1,79 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANT_SNAPSHOT_GROUPS_V1_REGION_INSTANT_SNAPSHOT_GROUPS_CONNECTION_IDEMPOTENCY_POLICY_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANT_SNAPSHOT_GROUPS_V1_REGION_INSTANT_SNAPSHOT_GROUPS_CONNECTION_IDEMPOTENCY_POLICY_H + +#include "google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups.pb.h" +#include "google/cloud/idempotency.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_instant_snapshot_groups_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class RegionInstantSnapshotGroupsConnectionIdempotencyPolicy { + public: + virtual ~RegionInstantSnapshotGroupsConnectionIdempotencyPolicy(); + + /// Create a new copy of this object. + virtual std::unique_ptr< + RegionInstantSnapshotGroupsConnectionIdempotencyPolicy> + clone() const; + + virtual google::cloud::Idempotency DeleteInstantSnapshotGroup( + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + DeleteInstantSnapshotGroupRequest const& request); + + virtual google::cloud::Idempotency GetInstantSnapshotGroup( + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + GetInstantSnapshotGroupRequest const& request); + + virtual google::cloud::Idempotency GetIamPolicy( + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + GetIamPolicyRequest const& request); + + virtual google::cloud::Idempotency InsertInstantSnapshotGroup( + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + InsertInstantSnapshotGroupRequest const& request); + + virtual google::cloud::Idempotency ListRegionInstantSnapshotGroups( + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + ListRegionInstantSnapshotGroupsRequest request); + + virtual google::cloud::Idempotency SetIamPolicy( + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + SetIamPolicyRequest const& request); + + virtual google::cloud::Idempotency TestIamPermissions( + google::cloud::cpp::compute::region_instant_snapshot_groups::v1:: + TestIamPermissionsRequest const& request); +}; + +std::unique_ptr +MakeDefaultRegionInstantSnapshotGroupsConnectionIdempotencyPolicy(); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_instant_snapshot_groups_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANT_SNAPSHOT_GROUPS_V1_REGION_INSTANT_SNAPSHOT_GROUPS_CONNECTION_IDEMPOTENCY_POLICY_H diff --git a/google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups_options.h b/google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups_options.h new file mode 100644 index 0000000000000..ce872a3c396ef --- /dev/null +++ b/google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups_options.h @@ -0,0 +1,89 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANT_SNAPSHOT_GROUPS_V1_REGION_INSTANT_SNAPSHOT_GROUPS_OPTIONS_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANT_SNAPSHOT_GROUPS_V1_REGION_INSTANT_SNAPSHOT_GROUPS_OPTIONS_H + +#include "google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups_connection.h" +#include "google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups_connection_idempotency_policy.h" +#include "google/cloud/backoff_policy.h" +#include "google/cloud/options.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_instant_snapshot_groups_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/** + * Use with `google::cloud::Options` to configure the retry policy. + * + * @ingroup google-cloud-compute-options + */ +struct RegionInstantSnapshotGroupsRetryPolicyOption { + using Type = std::shared_ptr; +}; + +/** + * Use with `google::cloud::Options` to configure the backoff policy. + * + * @ingroup google-cloud-compute-options + */ +struct RegionInstantSnapshotGroupsBackoffPolicyOption { + using Type = std::shared_ptr; +}; + +/** + * Use with `google::cloud::Options` to configure which operations are retried. + * + * @ingroup google-cloud-compute-options + */ +struct RegionInstantSnapshotGroupsConnectionIdempotencyPolicyOption { + using Type = + std::shared_ptr; +}; + +/** + * Use with `google::cloud::Options` to configure the long-running operations + * polling policy. + * + * @ingroup google-cloud-compute-options + */ +struct RegionInstantSnapshotGroupsPollingPolicyOption { + using Type = std::shared_ptr; +}; + +/** + * The options applicable to RegionInstantSnapshotGroups. + * + * @ingroup google-cloud-compute-options + */ +using RegionInstantSnapshotGroupsPolicyOptionList = + OptionList; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_instant_snapshot_groups_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANT_SNAPSHOT_GROUPS_V1_REGION_INSTANT_SNAPSHOT_GROUPS_OPTIONS_H diff --git a/google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups_proto_export.h b/google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups_proto_export.h new file mode 100644 index 0000000000000..5ea2fbfc7fe67 --- /dev/null +++ b/google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups_proto_export.h @@ -0,0 +1,37 @@ +// Copyright 2026 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_REGION_INSTANT_SNAPSHOT_GROUPS_V1_REGION_INSTANT_SNAPSHOT_GROUPS_PROTO_EXPORT_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANT_SNAPSHOT_GROUPS_V1_REGION_INSTANT_SNAPSHOT_GROUPS_PROTO_EXPORT_H + +// IWYU pragma: begin_exports +#include "google/cloud/compute/v1/internal/common_009.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_040.pb.h" +#include "google/cloud/compute/v1/internal/common_083.pb.h" +#include "google/cloud/compute/v1/internal/common_126.pb.h" +#include "google/cloud/compute/v1/internal/common_171.pb.h" +// IWYU pragma: end_exports + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANT_SNAPSHOT_GROUPS_V1_REGION_INSTANT_SNAPSHOT_GROUPS_PROTO_EXPORT_H diff --git a/google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups_rest_connection.cc b/google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups_rest_connection.cc new file mode 100644 index 0000000000000..66df0a25dfd3c --- /dev/null +++ b/google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups_rest_connection.cc @@ -0,0 +1,61 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups.proto + +#include "google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups_rest_connection.h" +#include "google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_option_defaults.h" +#include "google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_rest_connection_impl.h" +#include "google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_rest_stub_factory.h" +#include "google/cloud/compute/region_instant_snapshot_groups/v1/internal/region_instant_snapshot_groups_tracing_connection.h" +#include "google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups_options.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/internal/rest_background_threads_impl.h" +#include "google/cloud/internal/rest_options.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_instant_snapshot_groups_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +std::shared_ptr +MakeRegionInstantSnapshotGroupsConnectionRest(Options options) { + internal::CheckExpectedOptions( + options, __func__); + options = compute_region_instant_snapshot_groups_v1_internal:: + RegionInstantSnapshotGroupsDefaultOptions(std::move(options)); + auto background = std::make_unique< + rest_internal::AutomaticallyCreatedRestBackgroundThreads>(); + auto stub = compute_region_instant_snapshot_groups_v1_internal:: + CreateDefaultRegionInstantSnapshotGroupsRestStub(options); + return compute_region_instant_snapshot_groups_v1_internal:: + MakeRegionInstantSnapshotGroupsTracingConnection( + std::make_shared( + std::move(background), std::move(stub), std::move(options))); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_instant_snapshot_groups_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups_rest_connection.h b/google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups_rest_connection.h new file mode 100644 index 0000000000000..3d93d4e862da8 --- /dev/null +++ b/google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups_rest_connection.h @@ -0,0 +1,67 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANT_SNAPSHOT_GROUPS_V1_REGION_INSTANT_SNAPSHOT_GROUPS_REST_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANT_SNAPSHOT_GROUPS_V1_REGION_INSTANT_SNAPSHOT_GROUPS_REST_CONNECTION_H + +#include "google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups_connection.h" +#include "google/cloud/options.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_instant_snapshot_groups_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/** + * A factory function to construct an object of type + * `RegionInstantSnapshotGroupsConnection` that uses REST over HTTP as transport + * in lieu of gRPC. REST transport should only be used for services that do not + * support gRPC or if the existing network configuration precludes using gRPC. + * + * The returned connection object should not be used directly; instead it + * should be passed as an argument to the constructor of + * RegionInstantSnapshotGroupsClient. + * + * The optional @p options argument may be used to configure aspects of the + * returned `RegionInstantSnapshotGroupsConnection`. Expected options are any of + * the types in the following option lists: + * + * - `google::cloud::CommonOptionList` + * - `google::cloud::RestOptionList` + * - `google::cloud::UnifiedCredentialsOptionList` + * - + * `google::cloud::compute_region_instant_snapshot_groups_v1::RegionInstantSnapshotGroupsPolicyOptionList` + * + * @note Unexpected options will be ignored. To log unexpected options instead, + * set `GOOGLE_CLOUD_CPP_ENABLE_CLOG=yes` in the environment. + * + * @param options (optional) Configure the + * `RegionInstantSnapshotGroupsConnection` created by this function. + */ +std::shared_ptr +MakeRegionInstantSnapshotGroupsConnectionRest(Options options = {}); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_instant_snapshot_groups_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANT_SNAPSHOT_GROUPS_V1_REGION_INSTANT_SNAPSHOT_GROUPS_REST_CONNECTION_H diff --git a/google/cloud/compute/region_instant_snapshot_groups/v1/samples/region_instant_snapshot_groups_client_samples.cc b/google/cloud/compute/region_instant_snapshot_groups/v1/samples/region_instant_snapshot_groups_client_samples.cc new file mode 100644 index 0000000000000..27b73f0029b1a --- /dev/null +++ b/google/cloud/compute/region_instant_snapshot_groups/v1/samples/region_instant_snapshot_groups_client_samples.cc @@ -0,0 +1,245 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups.proto + +#include "google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups_client.h" +#include "google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups_connection_idempotency_policy.h" +#include "google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups_options.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/internal/getenv.h" +#include "google/cloud/polling_policy.h" +#include "google/cloud/testing_util/example_driver.h" +#include "google/cloud/universe_domain.h" +#include +#include +#include +#include + +// clang-format off +// main-dox-marker: compute_region_instant_snapshot_groups_v1::RegionInstantSnapshotGroupsClient +// lro-marker: true +// clang-format on +namespace { + +void SetClientEndpoint(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-endpoint"}; + } + //! [set-client-endpoint] + // This configuration is common with Private Google Access: + // https://cloud.google.com/vpc/docs/private-google-access + auto options = google::cloud::Options{}.set( + "private.googleapis.com"); + auto vpc_client = google::cloud::compute_region_instant_snapshot_groups_v1:: + RegionInstantSnapshotGroupsClient( + google::cloud::compute_region_instant_snapshot_groups_v1:: + MakeRegionInstantSnapshotGroupsConnectionRest(options)); + //! [set-client-endpoint] +} + +void SetClientUniverseDomain(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-universe-domain"}; + } + //! [set-client-universe-domain] + google::cloud::Options options; + + // AddUniverseDomainOption interrogates the UnifiedCredentialsOption, if set, + // in the provided Options for the Universe Domain associated with the + // credentials and adds it to the set of Options. + // If no UnifiedCredentialsOption is set, GoogleDefaultCredentials are used. + auto ud_options = google::cloud::AddUniverseDomainOption(std::move(options)); + + if (!ud_options.ok()) throw std::move(ud_options).status(); + auto ud_client = google::cloud::compute_region_instant_snapshot_groups_v1:: + RegionInstantSnapshotGroupsClient( + google::cloud::compute_region_instant_snapshot_groups_v1:: + MakeRegionInstantSnapshotGroupsConnectionRest(*ud_options)); + //! [set-client-universe-domain] +} + +//! [custom-idempotency-policy] +class CustomIdempotencyPolicy + : public google::cloud::compute_region_instant_snapshot_groups_v1:: + RegionInstantSnapshotGroupsConnectionIdempotencyPolicy { + public: + ~CustomIdempotencyPolicy() override = default; + std::unique_ptr + clone() const override { + return std::make_unique(*this); + } + // Override inherited functions to define as needed. +}; +//! [custom-idempotency-policy] + +void SetRetryPolicy(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-retry-policy"}; + } + //! [set-retry-policy] + auto options = + google::cloud::Options{} + .set< + google::cloud::compute_region_instant_snapshot_groups_v1:: + RegionInstantSnapshotGroupsConnectionIdempotencyPolicyOption>( + CustomIdempotencyPolicy().clone()) + .set( + google::cloud::compute_region_instant_snapshot_groups_v1:: + RegionInstantSnapshotGroupsLimitedErrorCountRetryPolicy(3) + .clone()) + .set( + google::cloud::ExponentialBackoffPolicy( + /*initial_delay=*/std::chrono::milliseconds(200), + /*maximum_delay=*/std::chrono::seconds(45), + /*scaling=*/2.0) + .clone()); + auto connection = google::cloud::compute_region_instant_snapshot_groups_v1:: + MakeRegionInstantSnapshotGroupsConnectionRest(options); + + // c1 and c2 share the same retry policies + auto c1 = google::cloud::compute_region_instant_snapshot_groups_v1:: + RegionInstantSnapshotGroupsClient(connection); + auto c2 = google::cloud::compute_region_instant_snapshot_groups_v1:: + RegionInstantSnapshotGroupsClient(connection); + + // You can override any of the policies in a new client. This new client + // will share the policies from c1 (or c2) *except* for the retry policy. + auto c3 = google::cloud::compute_region_instant_snapshot_groups_v1:: + RegionInstantSnapshotGroupsClient( + connection, + google::cloud::Options{} + .set( + google::cloud::compute_region_instant_snapshot_groups_v1:: + RegionInstantSnapshotGroupsLimitedTimeRetryPolicy( + std::chrono::minutes(5)) + .clone())); + + // You can also override the policies in a single call: + // c3.SomeRpc(..., google::cloud::Options{} + // .set( + // google::cloud::compute_region_instant_snapshot_groups_v1::RegionInstantSnapshotGroupsLimitedErrorCountRetryPolicy(10).clone())); + //! [set-retry-policy] +} + +void SetPollingPolicy(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-policy-policy"}; + } + //! [set-polling-policy] + + // The polling policy controls how the client waits for long-running + // operations. `GenericPollingPolicy<>` combines existing policies. + // In this case, keep polling until the operation completes (with success + // or error) or 45 minutes, whichever happens first. Initially pause for + // 10 seconds between polling requests, increasing the pause by a factor + // of 4 until it becomes 2 minutes. + auto options = + google::cloud::Options{} + .set( + google::cloud::GenericPollingPolicy< + google::cloud::compute_region_instant_snapshot_groups_v1:: + RegionInstantSnapshotGroupsRetryPolicyOption::Type, + google::cloud::compute_region_instant_snapshot_groups_v1:: + RegionInstantSnapshotGroupsBackoffPolicyOption::Type>( + google::cloud::compute_region_instant_snapshot_groups_v1:: + RegionInstantSnapshotGroupsLimitedTimeRetryPolicy( + /*maximum_duration=*/std::chrono::minutes(45)) + .clone(), + google::cloud::ExponentialBackoffPolicy( + /*initial_delay=*/std::chrono::seconds(10), + /*maximum_delay=*/std::chrono::minutes(2), + /*scaling=*/4.0) + .clone()) + .clone()); + + auto connection = google::cloud::compute_region_instant_snapshot_groups_v1:: + MakeRegionInstantSnapshotGroupsConnectionRest(options); + + // c1 and c2 share the same polling policies. + auto c1 = google::cloud::compute_region_instant_snapshot_groups_v1:: + RegionInstantSnapshotGroupsClient(connection); + auto c2 = google::cloud::compute_region_instant_snapshot_groups_v1:: + RegionInstantSnapshotGroupsClient(connection); + //! [set-polling-policy] +} + +void WithServiceAccount(std::vector const& argv) { + if (argv.size() != 1 || argv[0] == "--help") { + throw google::cloud::testing_util::Usage{"with-service-account "}; + } + //! [with-service-account] + [](std::string const& keyfile) { + auto is = std::ifstream(keyfile); + is.exceptions(std::ios::badbit); // Minimal error handling in examples + auto contents = std::string(std::istreambuf_iterator(is.rdbuf()), {}); + auto options = + google::cloud::Options{}.set( + google::cloud::MakeServiceAccountCredentials(contents)); + return google::cloud::compute_region_instant_snapshot_groups_v1:: + RegionInstantSnapshotGroupsClient( + google::cloud::compute_region_instant_snapshot_groups_v1:: + MakeRegionInstantSnapshotGroupsConnectionRest(options)); + } + //! [with-service-account] + (argv.at(0)); +} + +void AutoRun(std::vector const& argv) { + namespace examples = ::google::cloud::testing_util; + using ::google::cloud::internal::GetEnv; + if (!argv.empty()) throw examples::Usage{"auto"}; + examples::CheckEnvironmentVariablesAreSet( + {"GOOGLE_CLOUD_CPP_TEST_SERVICE_ACCOUNT_KEYFILE"}); + auto const keyfile = + GetEnv("GOOGLE_CLOUD_CPP_TEST_SERVICE_ACCOUNT_KEYFILE").value(); + + std::cout << "\nRunning SetClientEndpoint() example" << std::endl; + SetClientEndpoint({}); + + std::cout << "\nRunning SetRetryPolicy() example" << std::endl; + SetRetryPolicy({}); + + std::cout << "\nRunning SetPollingPolicy() example" << std::endl; + SetPollingPolicy({}); + + std::cout << "\nRunning WithServiceAccount() example" << std::endl; + WithServiceAccount({keyfile}); + + std::cout << "\nRunning SetClientUniverseDomain() example" << std::endl; + SetClientUniverseDomain({}); +} + +} // namespace + +int main(int argc, char* argv[]) { // NOLINT(bugprone-exception-escape) + google::cloud::testing_util::Example example({ + {"set-client-endpoint", SetClientEndpoint}, + {"set-retry-policy", SetRetryPolicy}, + {"set-polling-policy", SetPollingPolicy}, + {"with-service-account", WithServiceAccount}, + {"set-client-universe-domain", SetClientUniverseDomain}, + {"auto", AutoRun}, + }); + return example.Run(argc, argv); +} 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 cbd8becf05e5b..704faa5667f6c 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 @@ -98,8 +98,10 @@ class RegionInstantSnapshotsClient { /// 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. + /// to the next corresponding instantSnapshot. + /// + /// For more information, seeDeleting + /// instantSnapshots. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionInstantSnapshots/delete /// /// @param project Project ID for this request. @@ -125,7 +127,7 @@ class RegionInstantSnapshotsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_instant_snapshots.v1.DeleteInstantSnapshotRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instant_snapshots/v1/region_instant_snapshots.proto#L146} + /// [google.cloud.cpp.compute.region_instant_snapshots.v1.DeleteInstantSnapshotRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instant_snapshots/v1/region_instant_snapshots.proto#L149} /// // clang-format on future> @@ -153,8 +155,10 @@ class RegionInstantSnapshotsClient { /// 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. + /// to the next corresponding instantSnapshot. + /// + /// For more information, seeDeleting + /// instantSnapshots. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionInstantSnapshots/delete /// /// @param request Unary RPCs, such as the one wrapped by this @@ -183,7 +187,7 @@ class RegionInstantSnapshotsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_instant_snapshots.v1.DeleteInstantSnapshotRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instant_snapshots/v1/region_instant_snapshots.proto#L146} + /// [google.cloud.cpp.compute.region_instant_snapshots.v1.DeleteInstantSnapshotRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instant_snapshots/v1/region_instant_snapshots.proto#L149} /// // clang-format on future> @@ -243,8 +247,8 @@ class RegionInstantSnapshotsClient { /// [`future`]: @ref google::cloud::future /// [`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.region_instant_snapshots.v1.GetInstantSnapshotRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instant_snapshots/v1/region_instant_snapshots.proto#L204} + /// [google.cloud.cpp.compute.v1.InstantSnapshot]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_081.proto#L27} /// // clang-format on StatusOr GetInstantSnapshot( @@ -275,8 +279,8 @@ class RegionInstantSnapshotsClient { /// [`future`]: @ref google::cloud::future /// [`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.region_instant_snapshots.v1.GetInstantSnapshotRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instant_snapshots/v1/region_instant_snapshots.proto#L204} + /// [google.cloud.cpp.compute.v1.InstantSnapshot]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_081.proto#L27} /// // clang-format on StatusOr GetInstantSnapshot( @@ -306,8 +310,8 @@ class RegionInstantSnapshotsClient { /// [`future`]: @ref google::cloud::future /// [`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_007.proto#L178} + /// [google.cloud.cpp.compute.region_instant_snapshots.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instant_snapshots/v1/region_instant_snapshots.proto#L185} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr GetIamPolicy( @@ -339,8 +343,8 @@ class RegionInstantSnapshotsClient { /// [`future`]: @ref google::cloud::future /// [`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_007.proto#L178} + /// [google.cloud.cpp.compute.region_instant_snapshots.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instant_snapshots/v1/region_instant_snapshots.proto#L185} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr GetIamPolicy( @@ -376,7 +380,7 @@ class RegionInstantSnapshotsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_instant_snapshots.v1.InsertInstantSnapshotRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instant_snapshots/v1/region_instant_snapshots.proto#L213} + /// [google.cloud.cpp.compute.region_instant_snapshots.v1.InsertInstantSnapshotRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instant_snapshots/v1/region_instant_snapshots.proto#L219} /// // clang-format on future> @@ -433,7 +437,7 @@ class RegionInstantSnapshotsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_instant_snapshots.v1.InsertInstantSnapshotRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instant_snapshots/v1/region_instant_snapshots.proto#L213} + /// [google.cloud.cpp.compute.region_instant_snapshots.v1.InsertInstantSnapshotRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instant_snapshots/v1/region_instant_snapshots.proto#L219} /// // clang-format on future> @@ -474,8 +478,8 @@ class RegionInstantSnapshotsClient { // clang-format off /// - /// Retrieves the list of InstantSnapshot resources contained within the - /// specified region. + /// Retrieves the list of InstantSnapshot resources contained within + /// the specified region. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionInstantSnapshots/list /// /// @param project Project ID for this request. @@ -502,8 +506,8 @@ class RegionInstantSnapshotsClient { /// [`future`]: @ref google::cloud::future /// [`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.region_instant_snapshots.v1.ListRegionInstantSnapshotsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instant_snapshots/v1/region_instant_snapshots.proto#L255} + /// [google.cloud.cpp.compute.v1.InstantSnapshot]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_081.proto#L27} /// // clang-format on StreamRange @@ -512,8 +516,8 @@ class RegionInstantSnapshotsClient { // clang-format off /// - /// Retrieves the list of InstantSnapshot resources contained within the - /// specified region. + /// Retrieves the list of InstantSnapshot resources contained within + /// the specified region. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionInstantSnapshots/list /// /// @param request Unary RPCs, such as the one wrapped by this @@ -544,8 +548,8 @@ class RegionInstantSnapshotsClient { /// [`future`]: @ref google::cloud::future /// [`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.region_instant_snapshots.v1.ListRegionInstantSnapshotsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instant_snapshots/v1/region_instant_snapshots.proto#L255} + /// [google.cloud.cpp.compute.v1.InstantSnapshot]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_081.proto#L27} /// // clang-format on StreamRange @@ -556,8 +560,8 @@ class RegionInstantSnapshotsClient { // clang-format off /// - /// Sets the access control policy on the specified resource. Replaces any - /// existing policy. + /// Sets the access control policy on the specified resource. + /// Replaces any existing policy. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionInstantSnapshots/setIamPolicy /// /// @param project Project ID for this request. @@ -577,8 +581,8 @@ class RegionInstantSnapshotsClient { /// [`future`]: @ref google::cloud::future /// [`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_007.proto#L178} + /// [google.cloud.cpp.compute.region_instant_snapshots.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instant_snapshots/v1/region_instant_snapshots.proto#L360} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr SetIamPolicy( @@ -590,8 +594,8 @@ class RegionInstantSnapshotsClient { // clang-format off /// - /// Sets the access control policy on the specified resource. Replaces any - /// existing policy. + /// Sets the access control policy on the specified resource. + /// Replaces any existing policy. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionInstantSnapshots/setIamPolicy /// /// @param request Unary RPCs, such as the one wrapped by this @@ -613,8 +617,8 @@ class RegionInstantSnapshotsClient { /// [`future`]: @ref google::cloud::future /// [`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_007.proto#L178} + /// [google.cloud.cpp.compute.region_instant_snapshots.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instant_snapshots/v1/region_instant_snapshots.proto#L360} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr SetIamPolicy( @@ -625,7 +629,8 @@ class RegionInstantSnapshotsClient { // clang-format off /// /// Sets the labels on a instantSnapshot in the given region. To learn more - /// about labels, read the Labeling Resources documentation. + /// about labels, read the Labeling + /// Resources documentation. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionInstantSnapshots/setLabels /// /// @param project Project ID for this request. @@ -652,7 +657,7 @@ class RegionInstantSnapshotsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_instant_snapshots.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instant_snapshots/v1/region_instant_snapshots.proto#L338} + /// [google.cloud.cpp.compute.region_instant_snapshots.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instant_snapshots/v1/region_instant_snapshots.proto#L380} /// // clang-format on future> SetLabels( @@ -683,7 +688,8 @@ class RegionInstantSnapshotsClient { // clang-format off /// /// Sets the labels on a instantSnapshot in the given region. To learn more - /// about labels, read the Labeling Resources documentation. + /// about labels, read the Labeling + /// Resources documentation. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionInstantSnapshots/setLabels /// /// @param request Unary RPCs, such as the one wrapped by this @@ -712,7 +718,7 @@ class RegionInstantSnapshotsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_instant_snapshots.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instant_snapshots/v1/region_instant_snapshots.proto#L338} + /// [google.cloud.cpp.compute.region_instant_snapshots.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instant_snapshots/v1/region_instant_snapshots.proto#L380} /// // clang-format on future> SetLabels( @@ -772,8 +778,8 @@ class RegionInstantSnapshotsClient { /// [`future`]: @ref google::cloud::future /// [`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_145.proto#L30} + /// [google.cloud.cpp.compute.region_instant_snapshots.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instant_snapshots/v1/region_instant_snapshots.proto#L421} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} /// // clang-format on StatusOr @@ -808,8 +814,8 @@ class RegionInstantSnapshotsClient { /// [`future`]: @ref google::cloud::future /// [`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_145.proto#L30} + /// [google.cloud.cpp.compute.region_instant_snapshots.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instant_snapshots/v1/region_instant_snapshots.proto#L421} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.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 1bbe01062fe9c..16d2417dcde63 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 "google/cloud/compute/v1/internal/common_007.pb.h" -#include "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_031.pb.h" -#include "google/cloud/compute/v1/internal/common_066.pb.h" -#include "google/cloud/compute/v1/internal/common_107.pb.h" -#include "google/cloud/compute/v1/internal/common_108.pb.h" -#include "google/cloud/compute/v1/internal/common_145.pb.h" +#include "google/cloud/compute/v1/internal/common_009.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_040.pb.h" +#include "google/cloud/compute/v1/internal/common_081.pb.h" +#include "google/cloud/compute/v1/internal/common_125.pb.h" +#include "google/cloud/compute/v1/internal/common_126.pb.h" +#include "google/cloud/compute/v1/internal/common_171.pb.h" // 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 925fffa8894e2..8555b3801541a 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 @@ -100,8 +100,9 @@ class RegionNetworkEndpointGroupsClient { /// https://cloud.google.com/compute/docs/reference/rest/v1/regionNetworkEndpointGroups/attachNetworkEndpoints /// /// @param project Project ID for this request. - /// @param region The name of the region where you want to create the network endpoint group. - /// It should comply with RFC1035. + /// @param region The name of the region where + /// you want to create the network endpoint group. It should comply with + /// RFC1035. /// @param network_endpoint_group The name of the network endpoint group where you are attaching network /// endpoints to. It should comply with RFC1035. /// @param region_network_endpoint_groups_attach_endpoints_request_resource The RegionNetworkEndpointGroupsAttachEndpointsRequest for this request. @@ -125,7 +126,7 @@ class RegionNetworkEndpointGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_network_endpoint_groups.v1.AttachNetworkEndpointsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_network_endpoint_groups/v1/region_network_endpoint_groups.proto#L130} + /// [google.cloud.cpp.compute.region_network_endpoint_groups.v1.AttachNetworkEndpointsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_network_endpoint_groups/v1/region_network_endpoint_groups.proto#L144} /// // clang-format on future> @@ -187,7 +188,7 @@ class RegionNetworkEndpointGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_network_endpoint_groups.v1.AttachNetworkEndpointsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_network_endpoint_groups/v1/region_network_endpoint_groups.proto#L130} + /// [google.cloud.cpp.compute.region_network_endpoint_groups.v1.AttachNetworkEndpointsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_network_endpoint_groups/v1/region_network_endpoint_groups.proto#L144} /// // clang-format on future> @@ -234,8 +235,8 @@ class RegionNetworkEndpointGroupsClient { /// https://cloud.google.com/compute/docs/reference/rest/v1/regionNetworkEndpointGroups/delete /// /// @param project Project ID for this request. - /// @param region The name of the region where the network endpoint group is located. It - /// should comply with RFC1035. + /// @param region The name of the region where + /// the network endpoint group is located. It should comply with RFC1035. /// @param network_endpoint_group The name of the network endpoint group to delete. It should comply with /// RFC1035. /// @param opts Optional. Override the class-level options, such as retry and @@ -258,7 +259,7 @@ class RegionNetworkEndpointGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_network_endpoint_groups.v1.DeleteNetworkEndpointGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_network_endpoint_groups/v1/region_network_endpoint_groups.proto#L173} + /// [google.cloud.cpp.compute.region_network_endpoint_groups.v1.DeleteNetworkEndpointGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_network_endpoint_groups/v1/region_network_endpoint_groups.proto#L191} /// // clang-format on future> @@ -316,7 +317,7 @@ class RegionNetworkEndpointGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_network_endpoint_groups.v1.DeleteNetworkEndpointGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_network_endpoint_groups/v1/region_network_endpoint_groups.proto#L173} + /// [google.cloud.cpp.compute.region_network_endpoint_groups.v1.DeleteNetworkEndpointGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_network_endpoint_groups/v1/region_network_endpoint_groups.proto#L191} /// // clang-format on future> @@ -363,10 +364,11 @@ class RegionNetworkEndpointGroupsClient { /// https://cloud.google.com/compute/docs/reference/rest/v1/regionNetworkEndpointGroups/detachNetworkEndpoints /// /// @param project Project ID for this request. - /// @param region The name of the region where the network endpoint group is located. It - /// should comply with RFC1035. - /// @param network_endpoint_group The name of the network endpoint group you are detaching network endpoints - /// from. It should comply with RFC1035. + /// @param region The name of the region where + /// the network endpoint group is located. It should comply with + /// RFC1035. + /// @param network_endpoint_group The name of the network endpoint group you are detaching network + /// endpoints from. It should comply with RFC1035. /// @param region_network_endpoint_groups_detach_endpoints_request_resource The RegionNetworkEndpointGroupsDetachEndpointsRequest for this request. /// @param opts Optional. Override the class-level options, such as retry and /// backoff policies. @@ -388,7 +390,7 @@ class RegionNetworkEndpointGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_network_endpoint_groups.v1.DetachNetworkEndpointsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_network_endpoint_groups/v1/region_network_endpoint_groups.proto#L210} + /// [google.cloud.cpp.compute.region_network_endpoint_groups.v1.DetachNetworkEndpointsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_network_endpoint_groups/v1/region_network_endpoint_groups.proto#L231} /// // clang-format on future> @@ -450,7 +452,7 @@ class RegionNetworkEndpointGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_network_endpoint_groups.v1.DetachNetworkEndpointsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_network_endpoint_groups/v1/region_network_endpoint_groups.proto#L210} + /// [google.cloud.cpp.compute.region_network_endpoint_groups.v1.DetachNetworkEndpointsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_network_endpoint_groups/v1/region_network_endpoint_groups.proto#L231} /// // clang-format on future> @@ -496,8 +498,8 @@ class RegionNetworkEndpointGroupsClient { /// https://cloud.google.com/compute/docs/reference/rest/v1/regionNetworkEndpointGroups/get /// /// @param project Project ID for this request. - /// @param region The name of the region where the network endpoint group is located. It - /// should comply with RFC1035. + /// @param region The name of the region where + /// the network endpoint group is located. It should comply with RFC1035. /// @param network_endpoint_group The name of the network endpoint group. It should comply with RFC1035. /// @param opts Optional. Override the class-level options, such as retry and /// backoff policies. @@ -512,8 +514,8 @@ class RegionNetworkEndpointGroupsClient { /// [`future`]: @ref google::cloud::future /// [`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_012.proto#L131} + /// [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#L279} + /// [google.cloud.cpp.compute.v1.NetworkEndpointGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_015.proto#L157} /// // clang-format on StatusOr @@ -545,8 +547,8 @@ class RegionNetworkEndpointGroupsClient { /// [`future`]: @ref google::cloud::future /// [`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_012.proto#L131} + /// [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#L279} + /// [google.cloud.cpp.compute.v1.NetworkEndpointGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_015.proto#L157} /// // clang-format on StatusOr @@ -559,11 +561,26 @@ class RegionNetworkEndpointGroupsClient { /// /// Creates a network endpoint group in the specified project using the /// parameters that are included in the request. + /// + /// Note: Use the following APIs to manage network endpoint groups: + /// + /// - + /// To manage NEGs with zonal scope (such as zonal NEGs, hybrid connectivity + /// NEGs): zonal + /// API + /// - + /// To manage NEGs with regional scope (such as regional internet NEGs, + /// serverless NEGs, Private Service Connect NEGs): regional + /// API + /// - + /// To manage NEGs with global scope (such as global internet NEGs):global + /// API /// https://cloud.google.com/compute/docs/reference/rest/v1/regionNetworkEndpointGroups/insert /// /// @param project Project ID for this request. - /// @param region The name of the region where you want to create the network endpoint group. - /// It should comply with RFC1035. + /// @param region The name of the region where + /// you want to create the network endpoint group. It should comply with + /// RFC1035. /// @param network_endpoint_group_resource The NetworkEndpointGroup for this request. /// @param opts Optional. Override the class-level options, such as retry and /// backoff policies. @@ -585,7 +602,7 @@ class RegionNetworkEndpointGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_network_endpoint_groups.v1.InsertNetworkEndpointGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_network_endpoint_groups/v1/region_network_endpoint_groups.proto#L272} + /// [google.cloud.cpp.compute.region_network_endpoint_groups.v1.InsertNetworkEndpointGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_network_endpoint_groups/v1/region_network_endpoint_groups.proto#L297} /// // clang-format on future> @@ -617,6 +634,20 @@ class RegionNetworkEndpointGroupsClient { /// /// Creates a network endpoint group in the specified project using the /// parameters that are included in the request. + /// + /// Note: Use the following APIs to manage network endpoint groups: + /// + /// - + /// To manage NEGs with zonal scope (such as zonal NEGs, hybrid connectivity + /// NEGs): zonal + /// API + /// - + /// To manage NEGs with regional scope (such as regional internet NEGs, + /// serverless NEGs, Private Service Connect NEGs): regional + /// API + /// - + /// To manage NEGs with global scope (such as global internet NEGs):global + /// API /// https://cloud.google.com/compute/docs/reference/rest/v1/regionNetworkEndpointGroups/insert /// /// @param request Unary RPCs, such as the one wrapped by this @@ -645,7 +676,7 @@ class RegionNetworkEndpointGroupsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_network_endpoint_groups.v1.InsertNetworkEndpointGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_network_endpoint_groups/v1/region_network_endpoint_groups.proto#L272} + /// [google.cloud.cpp.compute.region_network_endpoint_groups.v1.InsertNetworkEndpointGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_network_endpoint_groups/v1/region_network_endpoint_groups.proto#L297} /// // clang-format on future> @@ -693,8 +724,8 @@ class RegionNetworkEndpointGroupsClient { /// https://cloud.google.com/compute/docs/reference/rest/v1/regionNetworkEndpointGroups/list /// /// @param project Project ID for this request. - /// @param region The name of the region where the network endpoint group is located. It - /// should comply with RFC1035. + /// @param region The name of theregion + /// where the network endpoint group is located. It should comply with RFC1035. /// @param opts Optional. Override the class-level options, such as retry and /// backoff policies. /// @return a [StreamRange](@ref google::cloud::StreamRange) @@ -717,8 +748,8 @@ class RegionNetworkEndpointGroupsClient { /// [`future`]: @ref google::cloud::future /// [`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_012.proto#L131} + /// [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#L448} + /// [google.cloud.cpp.compute.v1.NetworkEndpointGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_015.proto#L157} /// // clang-format on StreamRange @@ -759,8 +790,8 @@ class RegionNetworkEndpointGroupsClient { /// [`future`]: @ref google::cloud::future /// [`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_012.proto#L131} + /// [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#L448} + /// [google.cloud.cpp.compute.v1.NetworkEndpointGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_015.proto#L157} /// // clang-format on StreamRange @@ -775,8 +806,8 @@ class RegionNetworkEndpointGroupsClient { /// https://cloud.google.com/compute/docs/reference/rest/v1/regionNetworkEndpointGroups/listNetworkEndpoints /// /// @param project Project ID for this request. - /// @param region The name of the region where the network endpoint group is located. It - /// should comply with RFC1035. + /// @param region The name of theregion + /// where the network endpoint group is located. It should comply with RFC1035. /// @param network_endpoint_group The name of the network endpoint group from which you want to generate a /// list of included network endpoints. It should comply with RFC1035. /// @param opts Optional. Override the class-level options, such as retry and @@ -801,8 +832,8 @@ class RegionNetworkEndpointGroupsClient { /// [`future`]: @ref google::cloud::future /// [`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_012.proto#L548} + /// [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#L335} + /// [google.cloud.cpp.compute.v1.NetworkEndpointWithHealthStatus]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_015.proto#L678} /// // clang-format on StreamRange @@ -843,8 +874,8 @@ class RegionNetworkEndpointGroupsClient { /// [`future`]: @ref google::cloud::future /// [`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_012.proto#L548} + /// [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#L335} + /// [google.cloud.cpp.compute.v1.NetworkEndpointWithHealthStatus]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_015.proto#L678} /// // 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 6e5138a5e1c7f..0034b53271413 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 "google/cloud/compute/v1/internal/common_012.pb.h" -#include "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_049.pb.h" -#include "google/cloud/compute/v1/internal/common_105.pb.h" +#include "google/cloud/compute/v1/internal/common_015.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_061.pb.h" +#include "google/cloud/compute/v1/internal/common_123.pb.h" // 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 c1f9e08d70d49..d3765600553cf 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 @@ -248,7 +248,7 @@ class RegionNetworkFirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_network_firewall_policies.v1.AddRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_network_firewall_policies/v1/region_network_firewall_policies.proto#L291} + /// [google.cloud.cpp.compute.region_network_firewall_policies.v1.AddRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_network_firewall_policies/v1/region_network_firewall_policies.proto#L294} /// // clang-format on future> AddRule( @@ -307,7 +307,7 @@ class RegionNetworkFirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_network_firewall_policies.v1.AddRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_network_firewall_policies/v1/region_network_firewall_policies.proto#L291} + /// [google.cloud.cpp.compute.region_network_firewall_policies.v1.AddRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_network_firewall_policies/v1/region_network_firewall_policies.proto#L294} /// // clang-format on future> AddRule( @@ -373,7 +373,7 @@ class RegionNetworkFirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_network_firewall_policies.v1.CloneRulesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_network_firewall_policies/v1/region_network_firewall_policies.proto#L336} + /// [google.cloud.cpp.compute.region_network_firewall_policies.v1.CloneRulesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_network_firewall_policies/v1/region_network_firewall_policies.proto#L344} /// // clang-format on future> CloneRules( @@ -426,7 +426,7 @@ class RegionNetworkFirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_network_firewall_policies.v1.CloneRulesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_network_firewall_policies/v1/region_network_firewall_policies.proto#L336} + /// [google.cloud.cpp.compute.region_network_firewall_policies.v1.CloneRulesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_network_firewall_policies/v1/region_network_firewall_policies.proto#L344} /// // clang-format on future> CloneRules( @@ -492,7 +492,7 @@ class RegionNetworkFirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_network_firewall_policies.v1.DeleteFirewallPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_network_firewall_policies/v1/region_network_firewall_policies.proto#L373} + /// [google.cloud.cpp.compute.region_network_firewall_policies.v1.DeleteFirewallPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_network_firewall_policies/v1/region_network_firewall_policies.proto#L384} /// // clang-format on future> @@ -545,7 +545,7 @@ class RegionNetworkFirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_network_firewall_policies.v1.DeleteFirewallPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_network_firewall_policies/v1/region_network_firewall_policies.proto#L373} + /// [google.cloud.cpp.compute.region_network_firewall_policies.v1.DeleteFirewallPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_network_firewall_policies/v1/region_network_firewall_policies.proto#L384} /// // clang-format on future> @@ -606,8 +606,8 @@ class RegionNetworkFirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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.region_network_firewall_policies.v1.GetFirewallPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_network_firewall_policies/v1/region_network_firewall_policies.proto#L453} + /// [google.cloud.cpp.compute.v1.FirewallPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_047.proto#L27} /// // clang-format on StatusOr GetFirewallPolicy( @@ -638,8 +638,8 @@ class RegionNetworkFirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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.region_network_firewall_policies.v1.GetFirewallPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_network_firewall_policies/v1/region_network_firewall_policies.proto#L453} + /// [google.cloud.cpp.compute.v1.FirewallPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_047.proto#L27} /// // clang-format on StatusOr GetFirewallPolicy( @@ -668,8 +668,8 @@ class RegionNetworkFirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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#L115} + /// [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#L420} + /// [google.cloud.cpp.compute.v1.FirewallPolicyAssociation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_047.proto#L132} /// // clang-format on StatusOr @@ -700,8 +700,8 @@ class RegionNetworkFirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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#L115} + /// [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#L420} + /// [google.cloud.cpp.compute.v1.FirewallPolicyAssociation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_047.proto#L132} /// // clang-format on StatusOr @@ -730,8 +730,8 @@ class RegionNetworkFirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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_106.proto#L27} + /// [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#L438} + /// [google.cloud.cpp.compute.v1.RegionNetworkFirewallPoliciesGetEffectiveFirewallsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_124.proto#L27} /// // clang-format on StatusOr GetIamPolicy( @@ -829,8 +829,8 @@ class RegionNetworkFirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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_007.proto#L178} + /// [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#L468} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr GetIamPolicy( @@ -859,8 +859,8 @@ class RegionNetworkFirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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.region_network_firewall_policies.v1.GetRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_network_firewall_policies/v1/region_network_firewall_policies.proto#L487} + /// [google.cloud.cpp.compute.v1.FirewallPolicyRule]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_048.proto#L26} /// // clang-format on StatusOr GetRule( @@ -891,8 +891,8 @@ class RegionNetworkFirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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.region_network_firewall_policies.v1.GetRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_network_firewall_policies/v1/region_network_firewall_policies.proto#L487} + /// [google.cloud.cpp.compute.v1.FirewallPolicyRule]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_048.proto#L26} /// // clang-format on StatusOr GetRule( @@ -928,7 +928,7 @@ class RegionNetworkFirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_network_firewall_policies.v1.InsertFirewallPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_network_firewall_policies/v1/region_network_firewall_policies.proto#L491} + /// [google.cloud.cpp.compute.region_network_firewall_policies.v1.InsertFirewallPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_network_firewall_policies/v1/region_network_firewall_policies.proto#L505} /// // clang-format on future> @@ -985,7 +985,7 @@ class RegionNetworkFirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_network_firewall_policies.v1.InsertFirewallPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_network_firewall_policies/v1/region_network_firewall_policies.proto#L491} + /// [google.cloud.cpp.compute.region_network_firewall_policies.v1.InsertFirewallPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_network_firewall_policies/v1/region_network_firewall_policies.proto#L505} /// // clang-format on future> @@ -1027,8 +1027,8 @@ class RegionNetworkFirewallPoliciesClient { // clang-format off /// - /// Lists all the network firewall policies that have been configured for the - /// specified project in the given region. + /// Lists all the network firewall policies that have been configured + /// for the specified project in the given region. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionNetworkFirewallPolicies/list /// /// @param project Project ID for this request. @@ -1055,8 +1055,8 @@ class RegionNetworkFirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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.region_network_firewall_policies.v1.ListRegionNetworkFirewallPoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_network_firewall_policies/v1/region_network_firewall_policies.proto#L541} + /// [google.cloud.cpp.compute.v1.FirewallPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_047.proto#L27} /// // clang-format on StreamRange @@ -1066,8 +1066,8 @@ class RegionNetworkFirewallPoliciesClient { // clang-format off /// - /// Lists all the network firewall policies that have been configured for the - /// specified project in the given region. + /// Lists all the network firewall policies that have been configured + /// for the specified project in the given region. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionNetworkFirewallPolicies/list /// /// @param request Unary RPCs, such as the one wrapped by this @@ -1098,8 +1098,8 @@ class RegionNetworkFirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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.region_network_firewall_policies.v1.ListRegionNetworkFirewallPoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_network_firewall_policies/v1/region_network_firewall_policies.proto#L541} + /// [google.cloud.cpp.compute.v1.FirewallPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_047.proto#L27} /// // clang-format on StreamRange @@ -1137,7 +1137,7 @@ class RegionNetworkFirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_network_firewall_policies.v1.PatchFirewallPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_network_firewall_policies/v1/region_network_firewall_policies.proto#L596} + /// [google.cloud.cpp.compute.region_network_firewall_policies.v1.PatchFirewallPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_network_firewall_policies/v1/region_network_firewall_policies.proto#L646} /// // clang-format on future> @@ -1196,7 +1196,7 @@ class RegionNetworkFirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_network_firewall_policies.v1.PatchFirewallPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_network_firewall_policies/v1/region_network_firewall_policies.proto#L596} + /// [google.cloud.cpp.compute.region_network_firewall_policies.v1.PatchFirewallPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_network_firewall_policies/v1/region_network_firewall_policies.proto#L646} /// // clang-format on future> @@ -1265,7 +1265,7 @@ class RegionNetworkFirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_network_firewall_policies.v1.PatchRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_network_firewall_policies/v1/region_network_firewall_policies.proto#L633} + /// [google.cloud.cpp.compute.region_network_firewall_policies.v1.PatchRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_network_firewall_policies/v1/region_network_firewall_policies.proto#L686} /// // clang-format on future> PatchRule( @@ -1324,7 +1324,7 @@ class RegionNetworkFirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_network_firewall_policies.v1.PatchRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_network_firewall_policies/v1/region_network_firewall_policies.proto#L633} + /// [google.cloud.cpp.compute.region_network_firewall_policies.v1.PatchRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_network_firewall_policies/v1/region_network_firewall_policies.proto#L686} /// // clang-format on future> PatchRule( @@ -1390,7 +1390,7 @@ class RegionNetworkFirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_network_firewall_policies.v1.RemoveAssociationRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_network_firewall_policies/v1/region_network_firewall_policies.proto#L673} + /// [google.cloud.cpp.compute.region_network_firewall_policies.v1.RemoveAssociationRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_network_firewall_policies/v1/region_network_firewall_policies.proto#L729} /// // clang-format on future> @@ -1443,7 +1443,7 @@ class RegionNetworkFirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_network_firewall_policies.v1.RemoveAssociationRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_network_firewall_policies/v1/region_network_firewall_policies.proto#L673} + /// [google.cloud.cpp.compute.region_network_firewall_policies.v1.RemoveAssociationRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_network_firewall_policies/v1/region_network_firewall_policies.proto#L729} /// // clang-format on future> @@ -1510,7 +1510,7 @@ class RegionNetworkFirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_network_firewall_policies.v1.RemoveRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_network_firewall_policies/v1/region_network_firewall_policies.proto#L709} + /// [google.cloud.cpp.compute.region_network_firewall_policies.v1.RemoveRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_network_firewall_policies/v1/region_network_firewall_policies.proto#L768} /// // clang-format on future> RemoveRule( @@ -1563,7 +1563,7 @@ class RegionNetworkFirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_network_firewall_policies.v1.RemoveRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_network_firewall_policies/v1/region_network_firewall_policies.proto#L709} + /// [google.cloud.cpp.compute.region_network_firewall_policies.v1.RemoveRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_network_firewall_policies/v1/region_network_firewall_policies.proto#L768} /// // clang-format on future> RemoveRule( @@ -1603,8 +1603,8 @@ class RegionNetworkFirewallPoliciesClient { // clang-format off /// - /// Sets the access control policy on the specified resource. Replaces any - /// existing policy. + /// Sets the access control policy on the specified resource. + /// Replaces any existing policy. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionNetworkFirewallPolicies/setIamPolicy /// /// @param project Project ID for this request. @@ -1624,8 +1624,8 @@ class RegionNetworkFirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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_007.proto#L178} + /// [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#L807} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr SetIamPolicy( @@ -1637,8 +1637,8 @@ class RegionNetworkFirewallPoliciesClient { // clang-format off /// - /// Sets the access control policy on the specified resource. Replaces any - /// existing policy. + /// Sets the access control policy on the specified resource. + /// Replaces any existing policy. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionNetworkFirewallPolicies/setIamPolicy /// /// @param request Unary RPCs, such as the one wrapped by this @@ -1660,8 +1660,8 @@ class RegionNetworkFirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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_007.proto#L178} + /// [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#L807} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr SetIamPolicy( @@ -1691,8 +1691,8 @@ class RegionNetworkFirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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_145.proto#L30} + /// [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#L827} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} /// // clang-format on StatusOr @@ -1727,8 +1727,8 @@ class RegionNetworkFirewallPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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_145.proto#L30} + /// [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#L827} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.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 e46e7cb4a6351..7e5040a58fe67 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 "google/cloud/compute/v1/internal/common_007.pb.h" -#include "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_031.pb.h" -#include "google/cloud/compute/v1/internal/common_034.pb.h" -#include "google/cloud/compute/v1/internal/common_038.pb.h" -#include "google/cloud/compute/v1/internal/common_039.pb.h" -#include "google/cloud/compute/v1/internal/common_106.pb.h" -#include "google/cloud/compute/v1/internal/common_108.pb.h" -#include "google/cloud/compute/v1/internal/common_145.pb.h" +#include "google/cloud/compute/v1/internal/common_009.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_040.pb.h" +#include "google/cloud/compute/v1/internal/common_043.pb.h" +#include "google/cloud/compute/v1/internal/common_047.pb.h" +#include "google/cloud/compute/v1/internal/common_048.pb.h" +#include "google/cloud/compute/v1/internal/common_124.pb.h" +#include "google/cloud/compute/v1/internal/common_126.pb.h" +#include "google/cloud/compute/v1/internal/common_171.pb.h" // 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/internal/region_notification_endpoints_rest_connection_impl.cc b/google/cloud/compute/region_notification_endpoints/v1/internal/region_notification_endpoints_rest_connection_impl.cc index 8dbf8fb0e9626..90af954ab6973 100644 --- a/google/cloud/compute/region_notification_endpoints/v1/internal/region_notification_endpoints_rest_connection_impl.cc +++ b/google/cloud/compute/region_notification_endpoints/v1/internal/region_notification_endpoints_rest_connection_impl.cc @@ -48,6 +48,55 @@ RegionNotificationEndpointsRestConnectionImpl:: std::move(options), RegionNotificationEndpointsConnection::options())) {} +StreamRange< + std::pair> +RegionNotificationEndpointsRestConnectionImpl:: + AggregatedListRegionNotificationEndpoints( + google::cloud::cpp::compute::region_notification_endpoints::v1:: + AggregatedListRegionNotificationEndpointsRequest request) { + request.clear_page_token(); + auto current = google::cloud::internal::SaveCurrentOptions(); + auto idempotency = + idempotency_policy(*current)->AggregatedListRegionNotificationEndpoints( + request); + char const* function_name = __func__; + return google::cloud::internal::MakePaginationRange>>( + current, std::move(request), + [idempotency, function_name, stub = stub_, + retry = std::shared_ptr( + retry_policy(*current)), + backoff = std::shared_ptr(backoff_policy(*current))]( + Options const& options, + google::cloud::cpp::compute::region_notification_endpoints::v1:: + AggregatedListRegionNotificationEndpointsRequest const& r) { + return google::cloud::rest_internal::RestRetryLoop( + retry->clone(), backoff->clone(), idempotency, + [stub]( + rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_notification_endpoints::v1:: + AggregatedListRegionNotificationEndpointsRequest const& + request) { + return stub->AggregatedListRegionNotificationEndpoints( + rest_context, options, request); + }, + options, r, function_name); + }, + [](google::cloud::cpp::compute::v1::NotificationEndpointAggregatedList + r) { + std::vector> + result(r.items().size()); + auto& messages = *r.mutable_items(); + std::move(messages.begin(), messages.end(), result.begin()); + return result; + }); +} + future> RegionNotificationEndpointsRestConnectionImpl::DeleteNotificationEndpoint( google::cloud::cpp::compute::region_notification_endpoints::v1:: @@ -371,6 +420,22 @@ RegionNotificationEndpointsRestConnectionImpl::ListRegionNotificationEndpoints( }); } +StatusOr +RegionNotificationEndpointsRestConnectionImpl::TestIamPermissions( + google::cloud::cpp::compute::region_notification_endpoints::v1:: + TestIamPermissionsRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->TestIamPermissions(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_notification_endpoints::v1:: + TestIamPermissionsRequest const& request) { + return stub_->TestIamPermissions(rest_context, options, request); + }, + *current, request, __func__); +} + GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END } // namespace compute_region_notification_endpoints_v1_internal } // namespace cloud diff --git a/google/cloud/compute/region_notification_endpoints/v1/internal/region_notification_endpoints_rest_connection_impl.h b/google/cloud/compute/region_notification_endpoints/v1/internal/region_notification_endpoints_rest_connection_impl.h index 889aca9930472..e1d61c04b3ca3 100644 --- a/google/cloud/compute/region_notification_endpoints/v1/internal/region_notification_endpoints_rest_connection_impl.h +++ b/google/cloud/compute/region_notification_endpoints/v1/internal/region_notification_endpoints_rest_connection_impl.h @@ -54,6 +54,12 @@ class RegionNotificationEndpointsRestConnectionImpl Options options() override { return options_; } + StreamRange> + AggregatedListRegionNotificationEndpoints( + google::cloud::cpp::compute::region_notification_endpoints::v1:: + AggregatedListRegionNotificationEndpointsRequest request) override; + future> DeleteNotificationEndpoint( google::cloud::cpp::compute::region_notification_endpoints::v1:: @@ -94,6 +100,11 @@ class RegionNotificationEndpointsRestConnectionImpl google::cloud::cpp::compute::region_notification_endpoints::v1:: ListRegionNotificationEndpointsRequest request) override; + StatusOr + TestIamPermissions( + google::cloud::cpp::compute::region_notification_endpoints::v1:: + TestIamPermissionsRequest const& request) override; + private: static std::unique_ptr diff --git a/google/cloud/compute/region_notification_endpoints/v1/internal/region_notification_endpoints_rest_logging_decorator.cc b/google/cloud/compute/region_notification_endpoints/v1/internal/region_notification_endpoints_rest_logging_decorator.cc index ed1a5ed873353..fa204a45dbe39 100644 --- a/google/cloud/compute/region_notification_endpoints/v1/internal/region_notification_endpoints_rest_logging_decorator.cc +++ b/google/cloud/compute/region_notification_endpoints/v1/internal/region_notification_endpoints_rest_logging_decorator.cc @@ -35,6 +35,23 @@ RegionNotificationEndpointsRestLogging::RegionNotificationEndpointsRestLogging( tracing_options_(std::move(tracing_options)), components_(std::move(components)) {} +StatusOr +RegionNotificationEndpointsRestLogging:: + AggregatedListRegionNotificationEndpoints( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_notification_endpoints::v1:: + AggregatedListRegionNotificationEndpointsRequest const& request) { + return google::cloud::internal::LogWrapper( + [this]( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_notification_endpoints::v1:: + AggregatedListRegionNotificationEndpointsRequest const& request) { + return child_->AggregatedListRegionNotificationEndpoints( + rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + future> RegionNotificationEndpointsRestLogging::AsyncDeleteNotificationEndpoint( CompletionQueue& cq, @@ -134,6 +151,20 @@ RegionNotificationEndpointsRestLogging::ListRegionNotificationEndpoints( rest_context, options, request, __func__, tracing_options_); } +StatusOr +RegionNotificationEndpointsRestLogging::TestIamPermissions( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_notification_endpoints::v1:: + TestIamPermissionsRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_notification_endpoints::v1:: + TestIamPermissionsRequest const& request) { + return child_->TestIamPermissions(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + future> RegionNotificationEndpointsRestLogging::AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/region_notification_endpoints/v1/internal/region_notification_endpoints_rest_logging_decorator.h b/google/cloud/compute/region_notification_endpoints/v1/internal/region_notification_endpoints_rest_logging_decorator.h index 5f2f1501ee2e5..d62fa0470d018 100644 --- a/google/cloud/compute/region_notification_endpoints/v1/internal/region_notification_endpoints_rest_logging_decorator.h +++ b/google/cloud/compute/region_notification_endpoints/v1/internal/region_notification_endpoints_rest_logging_decorator.h @@ -44,6 +44,14 @@ class RegionNotificationEndpointsRestLogging std::shared_ptr child, TracingOptions tracing_options, std::set components); + StatusOr + AggregatedListRegionNotificationEndpoints( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_notification_endpoints::v1:: + AggregatedListRegionNotificationEndpointsRequest const& request) + override; + future> AsyncDeleteNotificationEndpoint( google::cloud::CompletionQueue& cq, @@ -88,6 +96,13 @@ class RegionNotificationEndpointsRestLogging google::cloud::cpp::compute::region_notification_endpoints::v1:: ListRegionNotificationEndpointsRequest const& request) override; + StatusOr + TestIamPermissions( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_notification_endpoints::v1:: + TestIamPermissionsRequest const& request) override; + future> AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/region_notification_endpoints/v1/internal/region_notification_endpoints_rest_metadata_decorator.cc b/google/cloud/compute/region_notification_endpoints/v1/internal/region_notification_endpoints_rest_metadata_decorator.cc index 08a4d93c5b81a..ca44e82d7d408 100644 --- a/google/cloud/compute/region_notification_endpoints/v1/internal/region_notification_endpoints_rest_metadata_decorator.cc +++ b/google/cloud/compute/region_notification_endpoints/v1/internal/region_notification_endpoints_rest_metadata_decorator.cc @@ -41,6 +41,17 @@ RegionNotificationEndpointsRestMetadata:: ? google::cloud::internal::GeneratedLibClientHeader() : std::move(api_client_header)) {} +StatusOr +RegionNotificationEndpointsRestMetadata:: + AggregatedListRegionNotificationEndpoints( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_notification_endpoints::v1:: + AggregatedListRegionNotificationEndpointsRequest const& request) { + SetMetadata(rest_context, options); + return child_->AggregatedListRegionNotificationEndpoints(rest_context, + options, request); +} + future> RegionNotificationEndpointsRestMetadata::AsyncDeleteNotificationEndpoint( CompletionQueue& cq, @@ -102,6 +113,15 @@ RegionNotificationEndpointsRestMetadata::ListRegionNotificationEndpoints( request); } +StatusOr +RegionNotificationEndpointsRestMetadata::TestIamPermissions( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_notification_endpoints::v1:: + TestIamPermissionsRequest const& request) { + SetMetadata(rest_context, options); + return child_->TestIamPermissions(rest_context, options, request); +} + future> RegionNotificationEndpointsRestMetadata::AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/region_notification_endpoints/v1/internal/region_notification_endpoints_rest_metadata_decorator.h b/google/cloud/compute/region_notification_endpoints/v1/internal/region_notification_endpoints_rest_metadata_decorator.h index d149fd3e3fa23..67879b6924bed 100644 --- a/google/cloud/compute/region_notification_endpoints/v1/internal/region_notification_endpoints_rest_metadata_decorator.h +++ b/google/cloud/compute/region_notification_endpoints/v1/internal/region_notification_endpoints_rest_metadata_decorator.h @@ -42,6 +42,14 @@ class RegionNotificationEndpointsRestMetadata std::shared_ptr child, std::string api_client_header = ""); + StatusOr + AggregatedListRegionNotificationEndpoints( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_notification_endpoints::v1:: + AggregatedListRegionNotificationEndpointsRequest const& request) + override; + google::cloud::future> AsyncDeleteNotificationEndpoint( google::cloud::CompletionQueue& cq, @@ -86,6 +94,13 @@ class RegionNotificationEndpointsRestMetadata google::cloud::cpp::compute::region_notification_endpoints::v1:: ListRegionNotificationEndpointsRequest const& request) override; + StatusOr + TestIamPermissions( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_notification_endpoints::v1:: + TestIamPermissionsRequest const& request) override; + google::cloud::future> AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/region_notification_endpoints/v1/internal/region_notification_endpoints_rest_stub.cc b/google/cloud/compute/region_notification_endpoints/v1/internal/region_notification_endpoints_rest_stub.cc index e6767501d82cd..2b95f6a0b3d03 100644 --- a/google/cloud/compute/region_notification_endpoints/v1/internal/region_notification_endpoints_rest_stub.cc +++ b/google/cloud/compute/region_notification_endpoints/v1/internal/region_notification_endpoints_rest_stub.cc @@ -48,6 +48,37 @@ DefaultRegionNotificationEndpointsRestStub:: operations_(std::move(operations)), options_(std::move(options)) {} +StatusOr +DefaultRegionNotificationEndpointsRestStub:: + AggregatedListRegionNotificationEndpoints( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_notification_endpoints::v1:: + AggregatedListRegionNotificationEndpointsRequest const& request) { + std::vector> query_params; + query_params.push_back({"filter", request.filter()}); + query_params.push_back( + {"include_all_scopes", (request.include_all_scopes() ? "1" : "0")}); + query_params.push_back( + {"max_results", std::to_string(request.max_results())}); + query_params.push_back({"order_by", request.order_by()}); + query_params.push_back({"page_token", request.page_token()}); + query_params.push_back({"return_partial_success", + (request.return_partial_success() ? "1" : "0")}); + query_params.push_back( + {"service_project_number", request.service_project_number()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Get< + google::cloud::cpp::compute::v1::NotificationEndpointAggregatedList>( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "aggregated", "/", + "notificationEndpoints"), + std::move(query_params)); +} + future> DefaultRegionNotificationEndpointsRestStub::AsyncDeleteNotificationEndpoint( CompletionQueue& cq, @@ -207,6 +238,25 @@ DefaultRegionNotificationEndpointsRestStub::ListRegionNotificationEndpoints( std::move(query_params)); } +StatusOr +DefaultRegionNotificationEndpointsRestStub::TestIamPermissions( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_notification_endpoints::v1:: + TestIamPermissionsRequest const& request) { + std::vector> query_params; + return rest_internal::Post< + google::cloud::cpp::compute::v1::TestPermissionsResponse>( + *service_, rest_context, request.test_permissions_request_resource(), + false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "regions", "/", + request.region(), "/", "notificationEndpoints", "/", + request.resource(), "/", "testIamPermissions"), + std::move(query_params)); +} + future> DefaultRegionNotificationEndpointsRestStub::AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/region_notification_endpoints/v1/internal/region_notification_endpoints_rest_stub.h b/google/cloud/compute/region_notification_endpoints/v1/internal/region_notification_endpoints_rest_stub.h index ceb581c607627..54a3fc4bb62f5 100644 --- a/google/cloud/compute/region_notification_endpoints/v1/internal/region_notification_endpoints_rest_stub.h +++ b/google/cloud/compute/region_notification_endpoints/v1/internal/region_notification_endpoints_rest_stub.h @@ -38,6 +38,14 @@ class RegionNotificationEndpointsRestStub { public: virtual ~RegionNotificationEndpointsRestStub() = default; + virtual StatusOr< + google::cloud::cpp::compute::v1::NotificationEndpointAggregatedList> + AggregatedListRegionNotificationEndpoints( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_notification_endpoints::v1:: + AggregatedListRegionNotificationEndpointsRequest const& request) = 0; + virtual future> AsyncDeleteNotificationEndpoint( google::cloud::CompletionQueue& cq, @@ -82,6 +90,13 @@ class RegionNotificationEndpointsRestStub { google::cloud::cpp::compute::region_notification_endpoints::v1:: ListRegionNotificationEndpointsRequest const& request) = 0; + virtual StatusOr + TestIamPermissions( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_notification_endpoints::v1:: + TestIamPermissionsRequest const& request) = 0; + virtual future> AsyncGetOperation( google::cloud::CompletionQueue& cq, @@ -108,6 +123,14 @@ class DefaultRegionNotificationEndpointsRestStub std::shared_ptr service, std::shared_ptr operations, Options options); + StatusOr + AggregatedListRegionNotificationEndpoints( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_notification_endpoints::v1:: + AggregatedListRegionNotificationEndpointsRequest const& request) + override; + future> AsyncDeleteNotificationEndpoint( google::cloud::CompletionQueue& cq, @@ -152,6 +175,13 @@ class DefaultRegionNotificationEndpointsRestStub google::cloud::cpp::compute::region_notification_endpoints::v1:: ListRegionNotificationEndpointsRequest const& request) override; + StatusOr + TestIamPermissions( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_notification_endpoints::v1:: + TestIamPermissionsRequest const& request) override; + future> AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/region_notification_endpoints/v1/internal/region_notification_endpoints_tracing_connection.cc b/google/cloud/compute/region_notification_endpoints/v1/internal/region_notification_endpoints_tracing_connection.cc index 72e64f5209ed5..9e41e02368d80 100644 --- a/google/cloud/compute/region_notification_endpoints/v1/internal/region_notification_endpoints_tracing_connection.cc +++ b/google/cloud/compute/region_notification_endpoints/v1/internal/region_notification_endpoints_tracing_connection.cc @@ -35,6 +35,26 @@ RegionNotificationEndpointsTracingConnection:: child) : child_(std::move(child)) {} +StreamRange< + std::pair> +RegionNotificationEndpointsTracingConnection:: + AggregatedListRegionNotificationEndpoints( + google::cloud::cpp::compute::region_notification_endpoints::v1:: + AggregatedListRegionNotificationEndpointsRequest request) { + auto span = internal::MakeSpan( + "compute_region_notification_endpoints_v1::" + "RegionNotificationEndpointsConnection::" + "AggregatedListRegionNotificationEndpoints"); + internal::OTelScope scope(span); + auto sr = + child_->AggregatedListRegionNotificationEndpoints(std::move(request)); + return internal::MakeTracedStreamRange>( + std::move(span), std::move(sr)); +} + future> RegionNotificationEndpointsTracingConnection::DeleteNotificationEndpoint( google::cloud::cpp::compute::region_notification_endpoints::v1:: @@ -130,6 +150,17 @@ RegionNotificationEndpointsTracingConnection::ListRegionNotificationEndpoints( std::move(sr)); } +StatusOr +RegionNotificationEndpointsTracingConnection::TestIamPermissions( + google::cloud::cpp::compute::region_notification_endpoints::v1:: + TestIamPermissionsRequest const& request) { + auto span = internal::MakeSpan( + "compute_region_notification_endpoints_v1::" + "RegionNotificationEndpointsConnection::TestIamPermissions"); + auto scope = opentelemetry::trace::Scope(span); + return internal::EndSpan(*span, child_->TestIamPermissions(request)); +} + std::shared_ptr MakeRegionNotificationEndpointsTracingConnection( diff --git a/google/cloud/compute/region_notification_endpoints/v1/internal/region_notification_endpoints_tracing_connection.h b/google/cloud/compute/region_notification_endpoints/v1/internal/region_notification_endpoints_tracing_connection.h index e11257bce71fd..5e6150d9f2770 100644 --- a/google/cloud/compute/region_notification_endpoints/v1/internal/region_notification_endpoints_tracing_connection.h +++ b/google/cloud/compute/region_notification_endpoints/v1/internal/region_notification_endpoints_tracing_connection.h @@ -42,6 +42,12 @@ class RegionNotificationEndpointsTracingConnection Options options() override { return child_->options(); } + StreamRange> + AggregatedListRegionNotificationEndpoints( + google::cloud::cpp::compute::region_notification_endpoints::v1:: + AggregatedListRegionNotificationEndpointsRequest request) override; + future> DeleteNotificationEndpoint( google::cloud::cpp::compute::region_notification_endpoints::v1:: @@ -82,6 +88,11 @@ class RegionNotificationEndpointsTracingConnection google::cloud::cpp::compute::region_notification_endpoints::v1:: ListRegionNotificationEndpointsRequest request) override; + StatusOr + TestIamPermissions( + google::cloud::cpp::compute::region_notification_endpoints::v1:: + TestIamPermissionsRequest const& request) override; + private: std::shared_ptr diff --git a/google/cloud/compute/region_notification_endpoints/v1/mocks/mock_region_notification_endpoints_connection.h b/google/cloud/compute/region_notification_endpoints/v1/mocks/mock_region_notification_endpoints_connection.h index 1c8b22e97ecca..001435362471e 100644 --- a/google/cloud/compute/region_notification_endpoints/v1/mocks/mock_region_notification_endpoints_connection.h +++ b/google/cloud/compute/region_notification_endpoints/v1/mocks/mock_region_notification_endpoints_connection.h @@ -49,6 +49,15 @@ class MockRegionNotificationEndpointsConnection public: MOCK_METHOD(Options, options, (), (override)); + MOCK_METHOD( + (StreamRange>), + AggregatedListRegionNotificationEndpoints, + (google::cloud::cpp::compute::region_notification_endpoints::v1:: + AggregatedListRegionNotificationEndpointsRequest request), + (override)); + /// To disambiguate calls, use: /// /// @code @@ -145,6 +154,13 @@ class MockRegionNotificationEndpointsConnection (google::cloud::cpp::compute::region_notification_endpoints::v1:: ListRegionNotificationEndpointsRequest request), (override)); + + MOCK_METHOD( + StatusOr, + TestIamPermissions, + (google::cloud::cpp::compute::region_notification_endpoints::v1:: + TestIamPermissionsRequest const& request), + (override)); }; GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END diff --git a/google/cloud/compute/region_notification_endpoints/v1/region_notification_endpoints_client.cc b/google/cloud/compute/region_notification_endpoints/v1/region_notification_endpoints_client.cc index 148291b44f718..1b85d53960eb0 100644 --- a/google/cloud/compute/region_notification_endpoints/v1/region_notification_endpoints_client.cc +++ b/google/cloud/compute/region_notification_endpoints/v1/region_notification_endpoints_client.cc @@ -35,6 +35,30 @@ RegionNotificationEndpointsClient::RegionNotificationEndpointsClient( RegionNotificationEndpointsClient::~RegionNotificationEndpointsClient() = default; +StreamRange< + std::pair> +RegionNotificationEndpointsClient::AggregatedListRegionNotificationEndpoints( + std::string const& project, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_notification_endpoints::v1:: + AggregatedListRegionNotificationEndpointsRequest request; + request.set_project(project); + return connection_->AggregatedListRegionNotificationEndpoints(request); +} + +StreamRange< + std::pair> +RegionNotificationEndpointsClient::AggregatedListRegionNotificationEndpoints( + google::cloud::cpp::compute::region_notification_endpoints::v1:: + AggregatedListRegionNotificationEndpointsRequest request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->AggregatedListRegionNotificationEndpoints( + std::move(request)); +} + future> RegionNotificationEndpointsClient::DeleteNotificationEndpoint( std::string const& project, std::string const& region, @@ -187,6 +211,33 @@ RegionNotificationEndpointsClient::ListRegionNotificationEndpoints( return connection_->ListRegionNotificationEndpoints(std::move(request)); } +StatusOr +RegionNotificationEndpointsClient::TestIamPermissions( + std::string const& project, std::string const& region, + std::string const& resource, + google::cloud::cpp::compute::v1::TestPermissionsRequest const& + test_permissions_request_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_notification_endpoints::v1:: + TestIamPermissionsRequest request; + request.set_project(project); + request.set_region(region); + request.set_resource(resource); + *request.mutable_test_permissions_request_resource() = + test_permissions_request_resource; + return connection_->TestIamPermissions(request); +} + +StatusOr +RegionNotificationEndpointsClient::TestIamPermissions( + google::cloud::cpp::compute::region_notification_endpoints::v1:: + TestIamPermissionsRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->TestIamPermissions(request); +} + GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END } // namespace compute_region_notification_endpoints_v1 } // namespace cloud 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 fada647241fa3..96406dfb60bc5 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 @@ -27,6 +27,7 @@ #include "google/cloud/polling_policy.h" #include "google/cloud/status_or.h" #include "google/cloud/version.h" +#include #include #include @@ -93,6 +94,89 @@ class RegionNotificationEndpointsClient { } ///@} + // clang-format off + /// + /// Retrieves the list of all NotificationEndpoint resources, + /// regional and global, available to the specified project. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionNotificationEndpoints/aggregatedList + /// + /// @param project Name of the project scoping this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return a [StreamRange](@ref google::cloud::StreamRange) + /// to iterate of the results. See the documentation of this type for + /// details. In brief, this class has `begin()` and `end()` member + /// functions returning a iterator class meeting the + /// [input iterator requirements]. The value type for this iterator is a + /// [`StatusOr`] as the iteration may fail even after some values are + /// retrieved successfully, for example, if there is a network disconnect. + /// An empty set of results does not indicate an error, it indicates + /// that there are no resources meeting the request criteria. + /// On a successful iteration the `StatusOr` contains elements of type + /// [google.cloud.cpp.compute.v1.NotificationEndpointsScopedList], or rather, + /// the C++ class generated by Protobuf from that type. Please consult the + /// Protobuf documentation for details on the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_notification_endpoints.v1.AggregatedListRegionNotificationEndpointsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_notification_endpoints/v1/region_notification_endpoints.proto#L114} + /// [google.cloud.cpp.compute.v1.NotificationEndpointsScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_105.proto#L367} + /// + // clang-format on + StreamRange> + AggregatedListRegionNotificationEndpoints(std::string const& project, + Options opts = {}); + + // clang-format off + /// + /// Retrieves the list of all NotificationEndpoint resources, + /// regional and global, available to the specified project. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionNotificationEndpoints/aggregatedList + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.region_notification_endpoints.v1.AggregatedListRegionNotificationEndpointsRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return a [StreamRange](@ref google::cloud::StreamRange) + /// to iterate of the results. See the documentation of this type for + /// details. In brief, this class has `begin()` and `end()` member + /// functions returning a iterator class meeting the + /// [input iterator requirements]. The value type for this iterator is a + /// [`StatusOr`] as the iteration may fail even after some values are + /// retrieved successfully, for example, if there is a network disconnect. + /// An empty set of results does not indicate an error, it indicates + /// that there are no resources meeting the request criteria. + /// On a successful iteration the `StatusOr` contains elements of type + /// [google.cloud.cpp.compute.v1.NotificationEndpointsScopedList], or rather, + /// the C++ class generated by Protobuf from that type. Please consult the + /// Protobuf documentation for details on the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_notification_endpoints.v1.AggregatedListRegionNotificationEndpointsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_notification_endpoints/v1/region_notification_endpoints.proto#L114} + /// [google.cloud.cpp.compute.v1.NotificationEndpointsScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_105.proto#L367} + /// + // clang-format on + StreamRange> + AggregatedListRegionNotificationEndpoints( + google::cloud::cpp::compute::region_notification_endpoints::v1:: + AggregatedListRegionNotificationEndpointsRequest request, + Options opts = {}); + // clang-format off /// /// Deletes the specified NotificationEndpoint in the given region @@ -121,7 +205,7 @@ class RegionNotificationEndpointsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_notification_endpoints.v1.DeleteNotificationEndpointRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_notification_endpoints/v1/region_notification_endpoints.proto#L89} + /// [google.cloud.cpp.compute.region_notification_endpoints.v1.DeleteNotificationEndpointRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_notification_endpoints/v1/region_notification_endpoints.proto#L229} /// // clang-format on future> @@ -178,7 +262,7 @@ class RegionNotificationEndpointsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_notification_endpoints.v1.DeleteNotificationEndpointRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_notification_endpoints/v1/region_notification_endpoints.proto#L89} + /// [google.cloud.cpp.compute.region_notification_endpoints.v1.DeleteNotificationEndpointRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_notification_endpoints/v1/region_notification_endpoints.proto#L229} /// // clang-format on future> @@ -240,8 +324,8 @@ class RegionNotificationEndpointsClient { /// [`future`]: @ref google::cloud::future /// [`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_090.proto#L30} + /// [google.cloud.cpp.compute.region_notification_endpoints.v1.GetNotificationEndpointRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_notification_endpoints/v1/region_notification_endpoints.proto#L267} + /// [google.cloud.cpp.compute.v1.NotificationEndpoint]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_105.proto#L34} /// // clang-format on StatusOr @@ -273,8 +357,8 @@ class RegionNotificationEndpointsClient { /// [`future`]: @ref google::cloud::future /// [`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_090.proto#L30} + /// [google.cloud.cpp.compute.region_notification_endpoints.v1.GetNotificationEndpointRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_notification_endpoints/v1/region_notification_endpoints.proto#L267} + /// [google.cloud.cpp.compute.v1.NotificationEndpoint]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_105.proto#L34} /// // clang-format on StatusOr @@ -312,7 +396,7 @@ class RegionNotificationEndpointsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_notification_endpoints.v1.InsertNotificationEndpointRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_notification_endpoints/v1/region_notification_endpoints.proto#L141} + /// [google.cloud.cpp.compute.region_notification_endpoints.v1.InsertNotificationEndpointRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_notification_endpoints/v1/region_notification_endpoints.proto#L284} /// // clang-format on future> @@ -372,7 +456,7 @@ class RegionNotificationEndpointsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_notification_endpoints.v1.InsertNotificationEndpointRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_notification_endpoints/v1/region_notification_endpoints.proto#L141} + /// [google.cloud.cpp.compute.region_notification_endpoints.v1.InsertNotificationEndpointRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_notification_endpoints/v1/region_notification_endpoints.proto#L284} /// // clang-format on future> @@ -442,8 +526,8 @@ class RegionNotificationEndpointsClient { /// [`future`]: @ref google::cloud::future /// [`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_090.proto#L30} + /// [google.cloud.cpp.compute.region_notification_endpoints.v1.ListRegionNotificationEndpointsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_notification_endpoints/v1/region_notification_endpoints.proto#L320} + /// [google.cloud.cpp.compute.v1.NotificationEndpoint]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_105.proto#L34} /// // clang-format on StreamRange @@ -483,8 +567,8 @@ class RegionNotificationEndpointsClient { /// [`future`]: @ref google::cloud::future /// [`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_090.proto#L30} + /// [google.cloud.cpp.compute.region_notification_endpoints.v1.ListRegionNotificationEndpointsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_notification_endpoints/v1/region_notification_endpoints.proto#L320} + /// [google.cloud.cpp.compute.v1.NotificationEndpoint]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_105.proto#L34} /// // clang-format on StreamRange @@ -493,6 +577,74 @@ class RegionNotificationEndpointsClient { ListRegionNotificationEndpointsRequest request, Options opts = {}); + // clang-format off + /// + /// Returns permissions that a caller has on the specified resource. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionNotificationEndpoints/testIamPermissions + /// + /// @param project Project ID for this request. + /// @param region The name of the region for this request. + /// @param resource Name or id of the resource for this request. + /// @param test_permissions_request_resource The TestPermissionsRequest for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.TestPermissionsResponse]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_notification_endpoints.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_notification_endpoints/v1/region_notification_endpoints.proto#L425} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} + /// + // clang-format on + StatusOr + TestIamPermissions( + std::string const& project, std::string const& region, + std::string const& resource, + google::cloud::cpp::compute::v1::TestPermissionsRequest const& + test_permissions_request_resource, + Options opts = {}); + + // clang-format off + /// + /// Returns permissions that a caller has on the specified resource. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionNotificationEndpoints/testIamPermissions + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.region_notification_endpoints.v1.TestIamPermissionsRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.TestPermissionsResponse]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_notification_endpoints.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_notification_endpoints/v1/region_notification_endpoints.proto#L425} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} + /// + // clang-format on + StatusOr + TestIamPermissions( + google::cloud::cpp::compute::region_notification_endpoints::v1:: + TestIamPermissionsRequest const& request, + Options opts = {}); + private: std::shared_ptr connection_; Options options_; diff --git a/google/cloud/compute/region_notification_endpoints/v1/region_notification_endpoints_connection.cc b/google/cloud/compute/region_notification_endpoints/v1/region_notification_endpoints_connection.cc index 3bc7c707ed162..691297b93890f 100644 --- a/google/cloud/compute/region_notification_endpoints/v1/region_notification_endpoints_connection.cc +++ b/google/cloud/compute/region_notification_endpoints/v1/region_notification_endpoints_connection.cc @@ -38,6 +38,17 @@ GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN RegionNotificationEndpointsConnection:: ~RegionNotificationEndpointsConnection() = default; +StreamRange< + std::pair> +RegionNotificationEndpointsConnection::AggregatedListRegionNotificationEndpoints( + google::cloud::cpp::compute::region_notification_endpoints::v1:: + AggregatedListRegionNotificationEndpointsRequest) { // NOLINT(performance-unnecessary-value-param) + return google::cloud::internal::MakeUnimplementedPaginationRange>>(); +} + future> RegionNotificationEndpointsConnection::DeleteNotificationEndpoint( google::cloud::cpp::compute::region_notification_endpoints::v1:: @@ -103,6 +114,13 @@ RegionNotificationEndpointsConnection::ListRegionNotificationEndpoints( StreamRange>(); } +StatusOr +RegionNotificationEndpointsConnection::TestIamPermissions( + google::cloud::cpp::compute::region_notification_endpoints::v1:: + TestIamPermissionsRequest const&) { + return Status(StatusCode::kUnimplemented, "not implemented"); +} + GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END } // namespace compute_region_notification_endpoints_v1 } // namespace cloud diff --git a/google/cloud/compute/region_notification_endpoints/v1/region_notification_endpoints_connection.h b/google/cloud/compute/region_notification_endpoints/v1/region_notification_endpoints_connection.h index 1f3f39fb505c2..80d11439227c1 100644 --- a/google/cloud/compute/region_notification_endpoints/v1/region_notification_endpoints_connection.h +++ b/google/cloud/compute/region_notification_endpoints/v1/region_notification_endpoints_connection.h @@ -205,6 +205,13 @@ class RegionNotificationEndpointsConnection { virtual Options options() { return Options{}; } + virtual StreamRange> + AggregatedListRegionNotificationEndpoints( + google::cloud::cpp::compute::region_notification_endpoints::v1:: + AggregatedListRegionNotificationEndpointsRequest request); + virtual future> DeleteNotificationEndpoint( google::cloud::cpp::compute::region_notification_endpoints::v1:: @@ -242,6 +249,11 @@ class RegionNotificationEndpointsConnection { ListRegionNotificationEndpoints( google::cloud::cpp::compute::region_notification_endpoints::v1:: ListRegionNotificationEndpointsRequest request); + + virtual StatusOr + TestIamPermissions( + google::cloud::cpp::compute::region_notification_endpoints::v1:: + TestIamPermissionsRequest const& request); }; GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END diff --git a/google/cloud/compute/region_notification_endpoints/v1/region_notification_endpoints_connection_idempotency_policy.cc b/google/cloud/compute/region_notification_endpoints/v1/region_notification_endpoints_connection_idempotency_policy.cc index 03bb18957a882..4653ba42a5219 100644 --- a/google/cloud/compute/region_notification_endpoints/v1/region_notification_endpoints_connection_idempotency_policy.cc +++ b/google/cloud/compute/region_notification_endpoints/v1/region_notification_endpoints_connection_idempotency_policy.cc @@ -36,6 +36,13 @@ RegionNotificationEndpointsConnectionIdempotencyPolicy::clone() const { RegionNotificationEndpointsConnectionIdempotencyPolicy>(*this); } +Idempotency RegionNotificationEndpointsConnectionIdempotencyPolicy:: + AggregatedListRegionNotificationEndpoints( + google::cloud::cpp::compute::region_notification_endpoints::v1:: + AggregatedListRegionNotificationEndpointsRequest) { // NOLINT + return Idempotency::kIdempotent; +} + Idempotency RegionNotificationEndpointsConnectionIdempotencyPolicy:: DeleteNotificationEndpoint( google::cloud::cpp::compute::region_notification_endpoints::v1:: @@ -64,6 +71,13 @@ Idempotency RegionNotificationEndpointsConnectionIdempotencyPolicy:: return Idempotency::kIdempotent; } +Idempotency +RegionNotificationEndpointsConnectionIdempotencyPolicy::TestIamPermissions( + google::cloud::cpp::compute::region_notification_endpoints::v1:: + TestIamPermissionsRequest const&) { + return Idempotency::kNonIdempotent; +} + std::unique_ptr MakeDefaultRegionNotificationEndpointsConnectionIdempotencyPolicy() { return std::make_unique< diff --git a/google/cloud/compute/region_notification_endpoints/v1/region_notification_endpoints_connection_idempotency_policy.h b/google/cloud/compute/region_notification_endpoints/v1/region_notification_endpoints_connection_idempotency_policy.h index 363d843a52fb6..cd9751f8f40c3 100644 --- a/google/cloud/compute/region_notification_endpoints/v1/region_notification_endpoints_connection_idempotency_policy.h +++ b/google/cloud/compute/region_notification_endpoints/v1/region_notification_endpoints_connection_idempotency_policy.h @@ -39,6 +39,10 @@ class RegionNotificationEndpointsConnectionIdempotencyPolicy { RegionNotificationEndpointsConnectionIdempotencyPolicy> clone() const; + virtual google::cloud::Idempotency AggregatedListRegionNotificationEndpoints( + google::cloud::cpp::compute::region_notification_endpoints::v1:: + AggregatedListRegionNotificationEndpointsRequest request); + virtual google::cloud::Idempotency DeleteNotificationEndpoint( google::cloud::cpp::compute::region_notification_endpoints::v1:: DeleteNotificationEndpointRequest const& request); @@ -54,6 +58,10 @@ class RegionNotificationEndpointsConnectionIdempotencyPolicy { virtual google::cloud::Idempotency ListRegionNotificationEndpoints( google::cloud::cpp::compute::region_notification_endpoints::v1:: ListRegionNotificationEndpointsRequest request); + + virtual google::cloud::Idempotency TestIamPermissions( + google::cloud::cpp::compute::region_notification_endpoints::v1:: + TestIamPermissionsRequest const& request); }; std::unique_ptr 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 f2db8aff21857..0e6669fb90a31 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,10 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_NOTIFICATION_ENDPOINTS_V1_REGION_NOTIFICATION_ENDPOINTS_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_029.pb.h" -#include "google/cloud/compute/v1/internal/common_090.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_038.pb.h" +#include "google/cloud/compute/v1/internal/common_105.pb.h" +#include "google/cloud/compute/v1/internal/common_171.pb.h" // 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 e5955c0b26689..a4278565719eb 100644 --- a/google/cloud/compute/region_operations/v1/region_operations_client.h +++ b/google/cloud/compute/region_operations/v1/region_operations_client.h @@ -107,7 +107,7 @@ class RegionOperationsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_operations.v1.DeleteOperationRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_operations/v1/region_operations.proto#L93} + /// [google.cloud.cpp.compute.region_operations.v1.DeleteOperationRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_operations/v1/region_operations.proto#L100} /// // clang-format on Status DeleteOperation(std::string const& project, std::string const& region, @@ -135,7 +135,7 @@ class RegionOperationsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_operations.v1.DeleteOperationRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_operations/v1/region_operations.proto#L93} + /// [google.cloud.cpp.compute.region_operations.v1.DeleteOperationRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_operations/v1/region_operations.proto#L100} /// // clang-format on Status DeleteOperation(google::cloud::cpp::compute::region_operations::v1:: @@ -164,8 +164,8 @@ class RegionOperationsClient { /// [`future`]: @ref google::cloud::future /// [`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_016.proto#L131} + /// [google.cloud.cpp.compute.region_operations.v1.GetOperationRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_operations/v1/region_operations.proto#L116} + /// [google.cloud.cpp.compute.v1.Operation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_019.proto#L188} /// // clang-format on StatusOr GetOperation( @@ -196,8 +196,8 @@ class RegionOperationsClient { /// [`future`]: @ref google::cloud::future /// [`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_016.proto#L131} + /// [google.cloud.cpp.compute.region_operations.v1.GetOperationRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_operations/v1/region_operations.proto#L116} + /// [google.cloud.cpp.compute.v1.Operation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_019.proto#L188} /// // clang-format on StatusOr GetOperation( @@ -207,8 +207,8 @@ class RegionOperationsClient { // clang-format off /// - /// Retrieves a list of Operation resources contained within the specified - /// region. + /// Retrieves a list of Operation resources contained within + /// the specified region. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionOperations/list /// /// @param project Project ID for this request. @@ -235,8 +235,8 @@ class RegionOperationsClient { /// [`future`]: @ref google::cloud::future /// [`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_016.proto#L131} + /// [google.cloud.cpp.compute.region_operations.v1.ListRegionOperationsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_operations/v1/region_operations.proto#L138} + /// [google.cloud.cpp.compute.v1.Operation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_019.proto#L188} /// // clang-format on StreamRange ListRegionOperations( @@ -244,8 +244,8 @@ class RegionOperationsClient { // clang-format off /// - /// Retrieves a list of Operation resources contained within the specified - /// region. + /// Retrieves a list of Operation resources contained within + /// the specified region. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionOperations/list /// /// @param request Unary RPCs, such as the one wrapped by this @@ -276,8 +276,8 @@ class RegionOperationsClient { /// [`future`]: @ref google::cloud::future /// [`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_016.proto#L131} + /// [google.cloud.cpp.compute.region_operations.v1.ListRegionOperationsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_operations/v1/region_operations.proto#L138} + /// [google.cloud.cpp.compute.v1.Operation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_019.proto#L188} /// // clang-format on StreamRange ListRegionOperations( @@ -287,17 +287,24 @@ class RegionOperationsClient { // clang-format off /// - /// 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`. + /// 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`. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionOperations/wait /// /// @param project Project ID for this request. @@ -317,8 +324,8 @@ class RegionOperationsClient { /// [`future`]: @ref google::cloud::future /// [`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_016.proto#L131} + /// [google.cloud.cpp.compute.region_operations.v1.WaitRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_operations/v1/region_operations.proto#L243} + /// [google.cloud.cpp.compute.v1.Operation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_019.proto#L188} /// // clang-format on StatusOr Wait( @@ -327,17 +334,24 @@ class RegionOperationsClient { // clang-format off /// - /// 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`. + /// 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`. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionOperations/wait /// /// @param request Unary RPCs, such as the one wrapped by this @@ -359,8 +373,8 @@ class RegionOperationsClient { /// [`future`]: @ref google::cloud::future /// [`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_016.proto#L131} + /// [google.cloud.cpp.compute.region_operations.v1.WaitRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_operations/v1/region_operations.proto#L243} + /// [google.cloud.cpp.compute.v1.Operation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_019.proto#L188} /// // 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 16e0afa4ae4e8..3f9525cb54e9d 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 "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_092.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_107.pb.h" // 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 6214adf5ba77a..5ebad0af96d1b 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 @@ -121,7 +121,7 @@ class RegionSecurityPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_security_policies.v1.AddRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_security_policies/v1/region_security_policies.proto#L168} + /// [google.cloud.cpp.compute.region_security_policies.v1.AddRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_security_policies/v1/region_security_policies.proto#L169} /// // clang-format on future> AddRule( @@ -180,7 +180,7 @@ class RegionSecurityPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_security_policies.v1.AddRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_security_policies/v1/region_security_policies.proto#L168} + /// [google.cloud.cpp.compute.region_security_policies.v1.AddRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_security_policies/v1/region_security_policies.proto#L169} /// // clang-format on future> AddRule( @@ -246,7 +246,7 @@ class RegionSecurityPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_security_policies.v1.DeleteSecurityPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_security_policies/v1/region_security_policies.proto#L196} + /// [google.cloud.cpp.compute.region_security_policies.v1.DeleteSecurityPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_security_policies/v1/region_security_policies.proto#L197} /// // clang-format on future> @@ -299,7 +299,7 @@ class RegionSecurityPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_security_policies.v1.DeleteSecurityPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_security_policies/v1/region_security_policies.proto#L196} + /// [google.cloud.cpp.compute.region_security_policies.v1.DeleteSecurityPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_security_policies/v1/region_security_policies.proto#L197} /// // clang-format on future> @@ -359,8 +359,8 @@ class RegionSecurityPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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#L247} - /// [google.cloud.cpp.compute.v1.SecurityPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_117.proto#L29} + /// [google.cloud.cpp.compute.region_security_policies.v1.GetSecurityPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_security_policies/v1/region_security_policies.proto#L251} + /// [google.cloud.cpp.compute.v1.SecurityPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_141.proto#L31} /// // clang-format on StatusOr GetSecurityPolicy( @@ -391,8 +391,8 @@ class RegionSecurityPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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#L247} - /// [google.cloud.cpp.compute.v1.SecurityPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_117.proto#L29} + /// [google.cloud.cpp.compute.region_security_policies.v1.GetSecurityPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_security_policies/v1/region_security_policies.proto#L251} + /// [google.cloud.cpp.compute.v1.SecurityPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_141.proto#L31} /// // clang-format on StatusOr GetSecurityPolicy( @@ -421,8 +421,8 @@ class RegionSecurityPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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#L229} - /// [google.cloud.cpp.compute.v1.SecurityPolicyRule]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_117.proto#L371} + /// [google.cloud.cpp.compute.region_security_policies.v1.GetRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_security_policies/v1/region_security_policies.proto#L233} + /// [google.cloud.cpp.compute.v1.SecurityPolicyRule]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_141.proto#L503} /// // clang-format on StatusOr GetRule( @@ -453,8 +453,8 @@ class RegionSecurityPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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#L229} - /// [google.cloud.cpp.compute.v1.SecurityPolicyRule]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_117.proto#L371} + /// [google.cloud.cpp.compute.region_security_policies.v1.GetRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_security_policies/v1/region_security_policies.proto#L233} + /// [google.cloud.cpp.compute.v1.SecurityPolicyRule]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_141.proto#L503} /// // clang-format on StatusOr GetRule( @@ -491,7 +491,7 @@ class RegionSecurityPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_security_policies.v1.InsertSecurityPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_security_policies/v1/region_security_policies.proto#L262} + /// [google.cloud.cpp.compute.region_security_policies.v1.InsertSecurityPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_security_policies/v1/region_security_policies.proto#L266} /// // clang-format on future> @@ -549,7 +549,7 @@ class RegionSecurityPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_security_policies.v1.InsertSecurityPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_security_policies/v1/region_security_policies.proto#L262} + /// [google.cloud.cpp.compute.region_security_policies.v1.InsertSecurityPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_security_policies/v1/region_security_policies.proto#L266} /// // clang-format on future> @@ -618,8 +618,8 @@ class RegionSecurityPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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#L298} - /// [google.cloud.cpp.compute.v1.SecurityPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_117.proto#L29} + /// [google.cloud.cpp.compute.region_security_policies.v1.ListRegionSecurityPoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_security_policies/v1/region_security_policies.proto#L305} + /// [google.cloud.cpp.compute.v1.SecurityPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_141.proto#L31} /// // clang-format on StreamRange @@ -660,8 +660,8 @@ class RegionSecurityPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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#L298} - /// [google.cloud.cpp.compute.v1.SecurityPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_117.proto#L29} + /// [google.cloud.cpp.compute.region_security_policies.v1.ListRegionSecurityPoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_security_policies/v1/region_security_policies.proto#L305} + /// [google.cloud.cpp.compute.v1.SecurityPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_141.proto#L31} /// // clang-format on StreamRange @@ -704,7 +704,7 @@ class RegionSecurityPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_security_policies.v1.PatchSecurityPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_security_policies/v1/region_security_policies.proto#L404} + /// [google.cloud.cpp.compute.region_security_policies.v1.PatchSecurityPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_security_policies/v1/region_security_policies.proto#L444} /// // clang-format on future> @@ -768,7 +768,7 @@ class RegionSecurityPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_security_policies.v1.PatchSecurityPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_security_policies/v1/region_security_policies.proto#L404} + /// [google.cloud.cpp.compute.region_security_policies.v1.PatchSecurityPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_security_policies/v1/region_security_policies.proto#L444} /// // clang-format on future> @@ -837,7 +837,7 @@ class RegionSecurityPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_security_policies.v1.PatchRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_security_policies/v1/region_security_policies.proto#L370} + /// [google.cloud.cpp.compute.region_security_policies.v1.PatchRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_security_policies/v1/region_security_policies.proto#L410} /// // clang-format on future> PatchRule( @@ -897,7 +897,7 @@ class RegionSecurityPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_security_policies.v1.PatchRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_security_policies/v1/region_security_policies.proto#L370} + /// [google.cloud.cpp.compute.region_security_policies.v1.PatchRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_security_policies/v1/region_security_policies.proto#L410} /// // clang-format on future> PatchRule( @@ -963,7 +963,7 @@ class RegionSecurityPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_security_policies.v1.RemoveRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_security_policies/v1/region_security_policies.proto#L444} + /// [google.cloud.cpp.compute.region_security_policies.v1.RemoveRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_security_policies/v1/region_security_policies.proto#L487} /// // clang-format on future> RemoveRule( @@ -1016,7 +1016,7 @@ class RegionSecurityPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_security_policies.v1.RemoveRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_security_policies/v1/region_security_policies.proto#L444} + /// [google.cloud.cpp.compute.region_security_policies.v1.RemoveRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_security_policies/v1/region_security_policies.proto#L487} /// // clang-format on future> RemoveRule( @@ -1056,8 +1056,9 @@ class RegionSecurityPoliciesClient { // clang-format off /// - /// Sets the labels on a security policy. To learn more about labels, read the - /// Labeling Resources documentation. + /// Sets the labels on a security policy. To learn more about labels, + /// read the Labeling Resources + /// documentation. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionSecurityPolicies/setLabels /// /// @param project Project ID for this request. @@ -1084,7 +1085,7 @@ class RegionSecurityPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_security_policies.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_security_policies/v1/region_security_policies.proto#L468} + /// [google.cloud.cpp.compute.region_security_policies.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_security_policies/v1/region_security_policies.proto#L511} /// // clang-format on future> SetLabels( @@ -1114,8 +1115,9 @@ class RegionSecurityPoliciesClient { // clang-format off /// - /// Sets the labels on a security policy. To learn more about labels, read the - /// Labeling Resources documentation. + /// Sets the labels on a security policy. To learn more about labels, + /// read the Labeling Resources + /// documentation. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionSecurityPolicies/setLabels /// /// @param request Unary RPCs, such as the one wrapped by this @@ -1144,7 +1146,7 @@ class RegionSecurityPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_security_policies.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_security_policies/v1/region_security_policies.proto#L468} + /// [google.cloud.cpp.compute.region_security_policies.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_security_policies/v1/region_security_policies.proto#L511} /// // clang-format on future> SetLabels( 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 dc572e34b9865..e1c56eba8d8cc 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,10 +26,10 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SECURITY_POLICIES_V1_REGION_SECURITY_POLICIES_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_031.pb.h" -#include "google/cloud/compute/v1/internal/common_107.pb.h" -#include "google/cloud/compute/v1/internal/common_117.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_040.pb.h" +#include "google/cloud/compute/v1/internal/common_125.pb.h" +#include "google/cloud/compute/v1/internal/common_141.pb.h" // 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_snapshot_settings/v1/internal/region_snapshot_settings_option_defaults.cc b/google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_option_defaults.cc new file mode 100644 index 0000000000000..7ae460b909876 --- /dev/null +++ b/google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_option_defaults.cc @@ -0,0 +1,94 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings.proto + +#include "google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_option_defaults.h" +#include "google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings_connection.h" +#include "google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings_options.h" +#include "google/cloud/internal/populate_common_options.h" +#include "google/cloud/internal/populate_grpc_options.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_snapshot_settings_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +namespace { +auto constexpr kBackoffScaling = 2.0; +} // namespace + +Options RegionSnapshotSettingsDefaultOptions(Options options) { + options = internal::PopulateCommonOptions( + std::move(options), "GOOGLE_CLOUD_CPP_REGION_SNAPSHOT_SETTINGS_ENDPOINT", + "", "GOOGLE_CLOUD_CPP_REGION_SNAPSHOT_SETTINGS_AUTHORITY", + "compute.googleapis.com"); + options = internal::PopulateGrpcOptions(std::move(options)); + if (!options.has()) { + options.set( + compute_region_snapshot_settings_v1:: + RegionSnapshotSettingsLimitedTimeRetryPolicy( + std::chrono::minutes(10)) + .clone()); + } + if (!options.has()) { + options.set( + ExponentialBackoffPolicy( + std::chrono::seconds(0), std::chrono::seconds(1), + std::chrono::minutes(5), kBackoffScaling, kBackoffScaling) + .clone()); + } + if (!options.has()) { + options.set( + GenericPollingPolicy< + compute_region_snapshot_settings_v1:: + RegionSnapshotSettingsRetryPolicyOption::Type, + compute_region_snapshot_settings_v1:: + RegionSnapshotSettingsBackoffPolicyOption::Type>( + options + .get() + ->clone(), + ExponentialBackoffPolicy(std::chrono::seconds(1), + std::chrono::minutes(5), kBackoffScaling) + .clone()) + .clone()); + } + if (!options.has< + compute_region_snapshot_settings_v1:: + RegionSnapshotSettingsConnectionIdempotencyPolicyOption>()) { + options.set( + compute_region_snapshot_settings_v1:: + MakeDefaultRegionSnapshotSettingsConnectionIdempotencyPolicy()); + } + + return options; +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_snapshot_settings_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_option_defaults.h b/google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_option_defaults.h new file mode 100644 index 0000000000000..1df6e1f30869d --- /dev/null +++ b/google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_option_defaults.h @@ -0,0 +1,38 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOT_SETTINGS_V1_INTERNAL_REGION_SNAPSHOT_SETTINGS_OPTION_DEFAULTS_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOT_SETTINGS_V1_INTERNAL_REGION_SNAPSHOT_SETTINGS_OPTION_DEFAULTS_H + +#include "google/cloud/options.h" +#include "google/cloud/version.h" + +namespace google { +namespace cloud { +namespace compute_region_snapshot_settings_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +Options RegionSnapshotSettingsDefaultOptions(Options options); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_snapshot_settings_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOT_SETTINGS_V1_INTERNAL_REGION_SNAPSHOT_SETTINGS_OPTION_DEFAULTS_H diff --git a/google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_rest_connection_impl.cc b/google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_rest_connection_impl.cc new file mode 100644 index 0000000000000..599ea45d7e0c5 --- /dev/null +++ b/google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_rest_connection_impl.cc @@ -0,0 +1,199 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings.proto + +#include "google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_rest_connection_impl.h" +#include "google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_rest_stub_factory.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/internal/async_rest_long_running_operation_custom.h" +#include "google/cloud/internal/extract_long_running_result.h" +#include "google/cloud/internal/rest_lro_helpers.h" +#include "google/cloud/internal/rest_retry_loop.h" +#include "google/cloud/rest_options.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_snapshot_settings_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +RegionSnapshotSettingsRestConnectionImpl:: + RegionSnapshotSettingsRestConnectionImpl( + std::unique_ptr background, + std::shared_ptr + stub, + Options options) + : background_(std::move(background)), + stub_(std::move(stub)), + options_(internal::MergeOptions( + std::move(options), RegionSnapshotSettingsConnection::options())) {} + +StatusOr +RegionSnapshotSettingsRestConnectionImpl::GetSnapshotSettings( + google::cloud::cpp::compute::region_snapshot_settings::v1:: + GetSnapshotSettingsRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->GetSnapshotSettings(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_snapshot_settings::v1:: + GetSnapshotSettingsRequest const& request) { + return stub_->GetSnapshotSettings(rest_context, options, request); + }, + *current, request, __func__); +} + +future> +RegionSnapshotSettingsRestConnectionImpl::PatchSnapshotSettings( + google::cloud::cpp::compute::region_snapshot_settings::v1:: + PatchSnapshotSettingsRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::region_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, request, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_snapshot_settings::v1:: + PatchSnapshotSettingsRequest const& request) { + return stub->AsyncPatchSnapshotSettings(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->PatchSnapshotSettings(request), + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [request](std::string const& op, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest& r) { + r.set_project(request.project()); + r.set_region(request.region()); + r.set_operation(op); + }, + [request](std::string const& op, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest& r) { + r.set_project(request.project()); + r.set_region(request.region()); + r.set_operation(op); + }); +} + +StatusOr +RegionSnapshotSettingsRestConnectionImpl::PatchSnapshotSettings( + NoAwaitTag, google::cloud::cpp::compute::region_snapshot_settings::v1:: + PatchSnapshotSettingsRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->PatchSnapshotSettings(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_snapshot_settings::v1:: + PatchSnapshotSettingsRequest const& request) { + return stub_->PatchSnapshotSettings(rest_context, options, request); + }, + *current, request, __func__); +} + +future> +RegionSnapshotSettingsRestConnectionImpl::PatchSnapshotSettings( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestAwaitLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::region_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, operation, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [operation](std::string const&, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_region(info.region); + r.set_operation(info.operation); + }, + [operation](std::string const&, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_region(info.region); + r.set_operation(info.operation); + }); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_snapshot_settings_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_rest_connection_impl.h b/google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_rest_connection_impl.h new file mode 100644 index 0000000000000..560efcbbc3e63 --- /dev/null +++ b/google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_rest_connection_impl.h @@ -0,0 +1,119 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOT_SETTINGS_V1_INTERNAL_REGION_SNAPSHOT_SETTINGS_REST_CONNECTION_IMPL_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOT_SETTINGS_V1_INTERNAL_REGION_SNAPSHOT_SETTINGS_REST_CONNECTION_IMPL_H + +#include "google/cloud/compute/region_operations/v1/region_operations.pb.h" +#include "google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_rest_stub.h" +#include "google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_retry_traits.h" +#include "google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings_connection.h" +#include "google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings_connection_idempotency_policy.h" +#include "google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings_options.h" +#include "google/cloud/background_threads.h" +#include "google/cloud/backoff_policy.h" +#include "google/cloud/options.h" +#include "google/cloud/status_or.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_snapshot_settings_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class RegionSnapshotSettingsRestConnectionImpl + : public compute_region_snapshot_settings_v1:: + RegionSnapshotSettingsConnection { + public: + ~RegionSnapshotSettingsRestConnectionImpl() override = default; + + RegionSnapshotSettingsRestConnectionImpl( + std::unique_ptr background, + std::shared_ptr + stub, + Options options); + + Options options() override { return options_; } + + StatusOr + GetSnapshotSettings( + google::cloud::cpp::compute::region_snapshot_settings::v1:: + GetSnapshotSettingsRequest const& request) override; + + future> + PatchSnapshotSettings( + google::cloud::cpp::compute::region_snapshot_settings::v1:: + PatchSnapshotSettingsRequest const& request) override; + + StatusOr PatchSnapshotSettings( + NoAwaitTag, google::cloud::cpp::compute::region_snapshot_settings::v1:: + PatchSnapshotSettingsRequest const& request) override; + + future> + PatchSnapshotSettings( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + private: + static std::unique_ptr< + compute_region_snapshot_settings_v1::RegionSnapshotSettingsRetryPolicy> + retry_policy(Options const& options) { + return options + .get() + ->clone(); + } + + static std::unique_ptr backoff_policy(Options const& options) { + return options + .get() + ->clone(); + } + + static std::unique_ptr + idempotency_policy(Options const& options) { + return options + .get() + ->clone(); + } + + static std::unique_ptr polling_policy(Options const& options) { + return options + .get() + ->clone(); + } + + std::unique_ptr background_; + std::shared_ptr + stub_; + Options options_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_snapshot_settings_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOT_SETTINGS_V1_INTERNAL_REGION_SNAPSHOT_SETTINGS_REST_CONNECTION_IMPL_H diff --git a/google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_rest_logging_decorator.cc b/google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_rest_logging_decorator.cc new file mode 100644 index 0000000000000..708a1032b8263 --- /dev/null +++ b/google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_rest_logging_decorator.cc @@ -0,0 +1,128 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings.proto + +#include "google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_rest_logging_decorator.h" +#include "google/cloud/internal/log_wrapper.h" +#include "google/cloud/status_or.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_snapshot_settings_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +RegionSnapshotSettingsRestLogging::RegionSnapshotSettingsRestLogging( + std::shared_ptr child, + TracingOptions tracing_options, std::set components) + : child_(std::move(child)), + tracing_options_(std::move(tracing_options)), + components_(std::move(components)) {} + +StatusOr +RegionSnapshotSettingsRestLogging::GetSnapshotSettings( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_snapshot_settings::v1:: + GetSnapshotSettingsRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_snapshot_settings::v1:: + GetSnapshotSettingsRequest const& request) { + return child_->GetSnapshotSettings(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +future> +RegionSnapshotSettingsRestLogging::AsyncPatchSnapshotSettings( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_snapshot_settings::v1:: + PatchSnapshotSettingsRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_snapshot_settings::v1:: + PatchSnapshotSettingsRequest const& request) { + return child_->AsyncPatchSnapshotSettings(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +StatusOr +RegionSnapshotSettingsRestLogging::PatchSnapshotSettings( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_snapshot_settings::v1:: + PatchSnapshotSettingsRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_snapshot_settings::v1:: + PatchSnapshotSettingsRequest const& request) { + return child_->PatchSnapshotSettings(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +future> +RegionSnapshotSettingsRestLogging::AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + return child_->AsyncGetOperation(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +future RegionSnapshotSettingsRestLogging::AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + return child_->AsyncCancelOperation(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_snapshot_settings_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_rest_logging_decorator.h b/google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_rest_logging_decorator.h new file mode 100644 index 0000000000000..c03a84316e718 --- /dev/null +++ b/google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_rest_logging_decorator.h @@ -0,0 +1,94 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOT_SETTINGS_V1_INTERNAL_REGION_SNAPSHOT_SETTINGS_REST_LOGGING_DECORATOR_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOT_SETTINGS_V1_INTERNAL_REGION_SNAPSHOT_SETTINGS_REST_LOGGING_DECORATOR_H + +#include "google/cloud/compute/region_operations/v1/region_operations.pb.h" +#include "google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_rest_stub.h" +#include "google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings.pb.h" +#include "google/cloud/future.h" +#include "google/cloud/internal/rest_context.h" +#include "google/cloud/tracing_options.h" +#include "google/cloud/version.h" +#include +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_snapshot_settings_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class RegionSnapshotSettingsRestLogging + : public RegionSnapshotSettingsRestStub { + public: + ~RegionSnapshotSettingsRestLogging() override = default; + RegionSnapshotSettingsRestLogging( + std::shared_ptr child, + TracingOptions tracing_options, std::set components); + + StatusOr + GetSnapshotSettings( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_snapshot_settings::v1:: + GetSnapshotSettingsRequest const& request) override; + + future> + AsyncPatchSnapshotSettings( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_snapshot_settings::v1:: + PatchSnapshotSettingsRequest const& request) override; + + StatusOr PatchSnapshotSettings( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_snapshot_settings::v1:: + PatchSnapshotSettingsRequest const& request) override; + + future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) override; + + future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) override; + + private: + std::shared_ptr child_; + TracingOptions tracing_options_; + std::set components_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_snapshot_settings_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOT_SETTINGS_V1_INTERNAL_REGION_SNAPSHOT_SETTINGS_REST_LOGGING_DECORATOR_H diff --git a/google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_rest_metadata_decorator.cc b/google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_rest_metadata_decorator.cc new file mode 100644 index 0000000000000..ad8b2deeaa606 --- /dev/null +++ b/google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_rest_metadata_decorator.cc @@ -0,0 +1,106 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings.proto + +#include "google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_rest_metadata_decorator.h" +#include "google/cloud/internal/api_client_header.h" +#include "google/cloud/internal/rest_set_metadata.h" +#include "google/cloud/status_or.h" +#include "absl/strings/str_cat.h" +#include "absl/strings/str_format.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_snapshot_settings_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +RegionSnapshotSettingsRestMetadata::RegionSnapshotSettingsRestMetadata( + std::shared_ptr child, + std::string api_client_header) + : child_(std::move(child)), + api_client_header_( + api_client_header.empty() + ? google::cloud::internal::GeneratedLibClientHeader() + : std::move(api_client_header)) {} + +StatusOr +RegionSnapshotSettingsRestMetadata::GetSnapshotSettings( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_snapshot_settings::v1:: + GetSnapshotSettingsRequest const& request) { + SetMetadata(rest_context, options); + return child_->GetSnapshotSettings(rest_context, options, request); +} + +future> +RegionSnapshotSettingsRestMetadata::AsyncPatchSnapshotSettings( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_snapshot_settings::v1:: + PatchSnapshotSettingsRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncPatchSnapshotSettings(cq, std::move(rest_context), + std::move(options), request); +} + +StatusOr +RegionSnapshotSettingsRestMetadata::PatchSnapshotSettings( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_snapshot_settings::v1:: + PatchSnapshotSettingsRequest const& request) { + SetMetadata(rest_context, options); + return child_->PatchSnapshotSettings(rest_context, options, request); +} + +future> +RegionSnapshotSettingsRestMetadata::AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncGetOperation(cq, std::move(rest_context), + std::move(options), request); +} + +future RegionSnapshotSettingsRestMetadata::AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncCancelOperation(cq, std::move(rest_context), + std::move(options), request); +} + +void RegionSnapshotSettingsRestMetadata::SetMetadata( + rest_internal::RestContext& rest_context, Options const& options, + std::vector const& params) { + google::cloud::rest_internal::SetMetadata(rest_context, options, params, + api_client_header_); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_snapshot_settings_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_rest_metadata_decorator.h b/google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_rest_metadata_decorator.h new file mode 100644 index 0000000000000..906c3f28c8f21 --- /dev/null +++ b/google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_rest_metadata_decorator.h @@ -0,0 +1,95 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOT_SETTINGS_V1_INTERNAL_REGION_SNAPSHOT_SETTINGS_REST_METADATA_DECORATOR_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOT_SETTINGS_V1_INTERNAL_REGION_SNAPSHOT_SETTINGS_REST_METADATA_DECORATOR_H + +#include "google/cloud/compute/region_operations/v1/region_operations.pb.h" +#include "google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_rest_stub.h" +#include "google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings.pb.h" +#include "google/cloud/future.h" +#include "google/cloud/rest_options.h" +#include "google/cloud/version.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_snapshot_settings_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class RegionSnapshotSettingsRestMetadata + : public RegionSnapshotSettingsRestStub { + public: + ~RegionSnapshotSettingsRestMetadata() override = default; + explicit RegionSnapshotSettingsRestMetadata( + std::shared_ptr child, + std::string api_client_header = ""); + + StatusOr + GetSnapshotSettings( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_snapshot_settings::v1:: + GetSnapshotSettingsRequest const& request) override; + + google::cloud::future> + AsyncPatchSnapshotSettings( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_snapshot_settings::v1:: + PatchSnapshotSettingsRequest const& request) override; + + StatusOr PatchSnapshotSettings( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_snapshot_settings::v1:: + PatchSnapshotSettingsRequest const& request) override; + + google::cloud::future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) override; + + google::cloud::future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) override; + + private: + void SetMetadata(rest_internal::RestContext& rest_context, + Options const& options, + std::vector const& params = {}); + + std::shared_ptr child_; + std::string api_client_header_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_snapshot_settings_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOT_SETTINGS_V1_INTERNAL_REGION_SNAPSHOT_SETTINGS_REST_METADATA_DECORATOR_H diff --git a/google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_rest_stub.cc b/google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_rest_stub.cc new file mode 100644 index 0000000000000..7a75ef3c303db --- /dev/null +++ b/google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_rest_stub.cc @@ -0,0 +1,190 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings.proto + +#include "google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_rest_stub.h" +#include "google/cloud/compute/region_operations/v1/region_operations.pb.h" +#include "google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings.pb.h" +#include "google/cloud/common_options.h" +#include "google/cloud/internal/rest_stub_helpers.h" +#include "google/cloud/status_or.h" +#include "absl/strings/str_cat.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_snapshot_settings_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +DefaultRegionSnapshotSettingsRestStub::DefaultRegionSnapshotSettingsRestStub( + Options options) + : service_(rest_internal::MakePooledRestClient( + options.get(), options)), + operations_(rest_internal::MakePooledRestClient( + options.get(), options)), + options_(std::move(options)) {} + +DefaultRegionSnapshotSettingsRestStub::DefaultRegionSnapshotSettingsRestStub( + std::shared_ptr service, + std::shared_ptr operations, Options options) + : service_(std::move(service)), + operations_(std::move(operations)), + options_(std::move(options)) {} + +StatusOr +DefaultRegionSnapshotSettingsRestStub::GetSnapshotSettings( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_snapshot_settings::v1:: + GetSnapshotSettingsRequest const& request) { + std::vector> query_params; + return rest_internal::Get( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "regions", "/", + request.region(), "/", "snapshotSettings"), + std::move(query_params)); +} + +future> +DefaultRegionSnapshotSettingsRestStub::AsyncPatchSnapshotSettings( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_snapshot_settings::v1:: + PatchSnapshotSettingsRequest const& request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto service, auto request, auto rest_context, auto options) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params.push_back({"update_mask", request.update_mask()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + p.set_value( + rest_internal::Patch( + *service, *rest_context, request.snapshot_settings_resource(), + false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", *options), + "/", "projects", "/", request.project(), "/", + "regions", "/", request.region(), "/", + "snapshotSettings"), + std::move(query_params))); + }, + std::move(p), + service_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +StatusOr +DefaultRegionSnapshotSettingsRestStub::PatchSnapshotSettings( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_snapshot_settings::v1:: + PatchSnapshotSettingsRequest const& request) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params.push_back({"update_mask", request.update_mask()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Patch( + *service_, rest_context, request.snapshot_settings_resource(), false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "regions", "/", + request.region(), "/", "snapshotSettings"), + std::move(query_params)); +} + +future> +DefaultRegionSnapshotSettingsRestStub::AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto operations, auto request, auto rest_context, + auto options) { + p.set_value( + rest_internal::Get( + *operations, *rest_context, request, false, + absl::StrCat("/compute/", + rest_internal::DetermineApiVersion("v1", *options), + "/projects/", request.project(), "/regions/", + request.region(), "/operations/", + request.operation()))); + }, + std::move(p), + operations_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +future DefaultRegionSnapshotSettingsRestStub::AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + promise> p; + future> f = p.get_future(); + std::thread t{ + [](auto p, auto operations, auto request, auto rest_context, + auto options) { + p.set_value(rest_internal::Post( + *operations, *rest_context, request, false, + absl::StrCat( + "/compute/", rest_internal::DetermineApiVersion("v1", *options), + "/projects/", request.project(), "/regions/", request.region(), + "/operations/", request.operation()))); + }, + std::move(p), + operations_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get().status(); + }); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_snapshot_settings_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_rest_stub.h b/google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_rest_stub.h new file mode 100644 index 0000000000000..243a2e95b926e --- /dev/null +++ b/google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_rest_stub.h @@ -0,0 +1,135 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOT_SETTINGS_V1_INTERNAL_REGION_SNAPSHOT_SETTINGS_REST_STUB_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOT_SETTINGS_V1_INTERNAL_REGION_SNAPSHOT_SETTINGS_REST_STUB_H + +#include "google/cloud/compute/region_operations/v1/region_operations.pb.h" +#include "google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings.pb.h" +#include "google/cloud/completion_queue.h" +#include "google/cloud/internal/rest_client.h" +#include "google/cloud/internal/rest_context.h" +#include "google/cloud/status_or.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_snapshot_settings_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class RegionSnapshotSettingsRestStub { + public: + virtual ~RegionSnapshotSettingsRestStub() = default; + + virtual StatusOr + GetSnapshotSettings(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_snapshot_settings:: + v1::GetSnapshotSettingsRequest const& request) = 0; + + virtual future> + AsyncPatchSnapshotSettings( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_snapshot_settings::v1:: + PatchSnapshotSettingsRequest const& request) = 0; + + virtual StatusOr + PatchSnapshotSettings( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_snapshot_settings::v1:: + PatchSnapshotSettingsRequest const& request) = 0; + + virtual future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) = 0; + + virtual future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) = 0; +}; + +class DefaultRegionSnapshotSettingsRestStub + : public RegionSnapshotSettingsRestStub { + public: + ~DefaultRegionSnapshotSettingsRestStub() override = default; + + explicit DefaultRegionSnapshotSettingsRestStub(Options options); + DefaultRegionSnapshotSettingsRestStub( + std::shared_ptr service, + std::shared_ptr operations, Options options); + + StatusOr + GetSnapshotSettings( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_snapshot_settings::v1:: + GetSnapshotSettingsRequest const& request) override; + + future> + AsyncPatchSnapshotSettings( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_snapshot_settings::v1:: + PatchSnapshotSettingsRequest const& request) override; + + StatusOr PatchSnapshotSettings( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_snapshot_settings::v1:: + PatchSnapshotSettingsRequest const& request) override; + + future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) override; + + future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) override; + + private: + std::shared_ptr service_; + std::shared_ptr operations_; + Options options_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_snapshot_settings_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOT_SETTINGS_V1_INTERNAL_REGION_SNAPSHOT_SETTINGS_REST_STUB_H diff --git a/google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_rest_stub_factory.cc b/google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_rest_stub_factory.cc new file mode 100644 index 0000000000000..75a31102b031b --- /dev/null +++ b/google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_rest_stub_factory.cc @@ -0,0 +1,57 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings.proto + +#include "google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_rest_stub_factory.h" +#include "google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_rest_logging_decorator.h" +#include "google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_rest_metadata_decorator.h" +#include "google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_rest_stub.h" +#include "google/cloud/common_options.h" +#include "google/cloud/internal/algorithm.h" +#include "google/cloud/internal/populate_rest_options.h" +#include "google/cloud/log.h" +#include "google/cloud/options.h" +#include "google/cloud/rest_options.h" +#include "absl/strings/match.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_snapshot_settings_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +std::shared_ptr +CreateDefaultRegionSnapshotSettingsRestStub(Options const& options) { + auto opts = internal::PopulateRestOptions(options); + std::shared_ptr stub = + std::make_shared(std::move(opts)); + stub = std::make_shared(std::move(stub)); + if (internal::Contains(options.get(), "rpc")) { + GCP_LOG(INFO) << "Enabled logging for REST rpc calls"; + stub = std::make_shared( + std::move(stub), options.get(), + options.get()); + } + return stub; +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_snapshot_settings_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_rest_stub_factory.h b/google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_rest_stub_factory.h new file mode 100644 index 0000000000000..cded0349521b1 --- /dev/null +++ b/google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_rest_stub_factory.h @@ -0,0 +1,41 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOT_SETTINGS_V1_INTERNAL_REGION_SNAPSHOT_SETTINGS_REST_STUB_FACTORY_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOT_SETTINGS_V1_INTERNAL_REGION_SNAPSHOT_SETTINGS_REST_STUB_FACTORY_H + +#include "google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_rest_stub.h" +#include "google/cloud/options.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_snapshot_settings_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +std::shared_ptr +CreateDefaultRegionSnapshotSettingsRestStub(Options const& options); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_snapshot_settings_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOT_SETTINGS_V1_INTERNAL_REGION_SNAPSHOT_SETTINGS_REST_STUB_FACTORY_H diff --git a/google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_retry_traits.h b/google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_retry_traits.h new file mode 100644 index 0000000000000..f103c6beceab3 --- /dev/null +++ b/google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_retry_traits.h @@ -0,0 +1,44 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOT_SETTINGS_V1_INTERNAL_REGION_SNAPSHOT_SETTINGS_RETRY_TRAITS_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOT_SETTINGS_V1_INTERNAL_REGION_SNAPSHOT_SETTINGS_RETRY_TRAITS_H + +#include "google/cloud/status.h" +#include "google/cloud/version.h" + +namespace google { +namespace cloud { +namespace compute_region_snapshot_settings_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/// Define the gRPC status code semantics for retrying requests. +struct RegionSnapshotSettingsRetryTraits { + static bool IsPermanentFailure(google::cloud::Status const& status) { + return status.code() != StatusCode::kOk && + status.code() != StatusCode::kUnavailable; + } +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_snapshot_settings_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOT_SETTINGS_V1_INTERNAL_REGION_SNAPSHOT_SETTINGS_RETRY_TRAITS_H diff --git a/google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_sources.cc b/google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_sources.cc new file mode 100644 index 0000000000000..9585f7bc2f302 --- /dev/null +++ b/google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_sources.cc @@ -0,0 +1,32 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings.proto + +// NOLINTBEGIN(bugprone-suspicious-include) +#include "google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_option_defaults.cc" +#include "google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_rest_connection_impl.cc" +#include "google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_rest_logging_decorator.cc" +#include "google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_rest_metadata_decorator.cc" +#include "google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_rest_stub.cc" +#include "google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_rest_stub_factory.cc" +#include "google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_tracing_connection.cc" +#include "google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings_client.cc" +#include "google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings_connection.cc" +#include "google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings_connection_idempotency_policy.cc" +#include "google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings_rest_connection.cc" +// NOLINTEND(bugprone-suspicious-include) diff --git a/google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_tracing_connection.cc b/google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_tracing_connection.cc new file mode 100644 index 0000000000000..ee621ab174033 --- /dev/null +++ b/google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_tracing_connection.cc @@ -0,0 +1,99 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings.proto + +#include "google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_tracing_connection.h" +#include "google/cloud/internal/opentelemetry.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_snapshot_settings_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +RegionSnapshotSettingsTracingConnection:: + RegionSnapshotSettingsTracingConnection( + std::shared_ptr + child) + : child_(std::move(child)) {} + +StatusOr +RegionSnapshotSettingsTracingConnection::GetSnapshotSettings( + google::cloud::cpp::compute::region_snapshot_settings::v1:: + GetSnapshotSettingsRequest const& request) { + auto span = internal::MakeSpan( + "compute_region_snapshot_settings_v1::RegionSnapshotSettingsConnection::" + "GetSnapshotSettings"); + auto scope = opentelemetry::trace::Scope(span); + return internal::EndSpan(*span, child_->GetSnapshotSettings(request)); +} + +future> +RegionSnapshotSettingsTracingConnection::PatchSnapshotSettings( + google::cloud::cpp::compute::region_snapshot_settings::v1:: + PatchSnapshotSettingsRequest const& request) { + auto span = internal::MakeSpan( + "compute_region_snapshot_settings_v1::RegionSnapshotSettingsConnection::" + "PatchSnapshotSettings"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), + child_->PatchSnapshotSettings(request)); +} + +StatusOr +RegionSnapshotSettingsTracingConnection::PatchSnapshotSettings( + NoAwaitTag, google::cloud::cpp::compute::region_snapshot_settings::v1:: + PatchSnapshotSettingsRequest const& request) { + auto span = internal::MakeSpan( + "compute_region_snapshot_settings_v1::RegionSnapshotSettingsConnection::" + "PatchSnapshotSettings"); + opentelemetry::trace::Scope scope(span); + return internal::EndSpan( + *span, child_->PatchSnapshotSettings(NoAwaitTag{}, request)); +} + +future> +RegionSnapshotSettingsTracingConnection::PatchSnapshotSettings( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto span = internal::MakeSpan( + "compute_region_snapshot_settings_v1::RegionSnapshotSettingsConnection::" + "PatchSnapshotSettings"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), + child_->PatchSnapshotSettings(operation)); +} + +std::shared_ptr< + compute_region_snapshot_settings_v1::RegionSnapshotSettingsConnection> +MakeRegionSnapshotSettingsTracingConnection( + std::shared_ptr< + compute_region_snapshot_settings_v1::RegionSnapshotSettingsConnection> + conn) { + if (internal::TracingEnabled(conn->options())) { + conn = std::make_shared( + std::move(conn)); + } + return conn; +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_snapshot_settings_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_tracing_connection.h b/google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_tracing_connection.h new file mode 100644 index 0000000000000..b8d2bd0a7ae10 --- /dev/null +++ b/google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_tracing_connection.h @@ -0,0 +1,87 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOT_SETTINGS_V1_INTERNAL_REGION_SNAPSHOT_SETTINGS_TRACING_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOT_SETTINGS_V1_INTERNAL_REGION_SNAPSHOT_SETTINGS_TRACING_CONNECTION_H + +#include "google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings_connection.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_snapshot_settings_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class RegionSnapshotSettingsTracingConnection + : public compute_region_snapshot_settings_v1:: + RegionSnapshotSettingsConnection { + public: + ~RegionSnapshotSettingsTracingConnection() override = default; + + explicit RegionSnapshotSettingsTracingConnection( + std::shared_ptr< + compute_region_snapshot_settings_v1::RegionSnapshotSettingsConnection> + child); + + Options options() override { return child_->options(); } + + StatusOr + GetSnapshotSettings( + google::cloud::cpp::compute::region_snapshot_settings::v1:: + GetSnapshotSettingsRequest const& request) override; + + future> + PatchSnapshotSettings( + google::cloud::cpp::compute::region_snapshot_settings::v1:: + PatchSnapshotSettingsRequest const& request) override; + + StatusOr PatchSnapshotSettings( + NoAwaitTag, google::cloud::cpp::compute::region_snapshot_settings::v1:: + PatchSnapshotSettingsRequest const& request) override; + + future> + PatchSnapshotSettings( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + private: + std::shared_ptr< + compute_region_snapshot_settings_v1::RegionSnapshotSettingsConnection> + child_; +}; + +/** + * Conditionally applies the tracing decorator to the given connection. + * + * The connection is only decorated if tracing is enabled (as determined by the + * connection's options). + */ +std::shared_ptr< + compute_region_snapshot_settings_v1::RegionSnapshotSettingsConnection> +MakeRegionSnapshotSettingsTracingConnection( + std::shared_ptr< + compute_region_snapshot_settings_v1::RegionSnapshotSettingsConnection> + conn); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_snapshot_settings_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOT_SETTINGS_V1_INTERNAL_REGION_SNAPSHOT_SETTINGS_TRACING_CONNECTION_H diff --git a/google/cloud/compute/region_snapshot_settings/v1/mocks/mock_region_snapshot_settings_connection.h b/google/cloud/compute/region_snapshot_settings/v1/mocks/mock_region_snapshot_settings_connection.h new file mode 100644 index 0000000000000..0a9040ff8270c --- /dev/null +++ b/google/cloud/compute/region_snapshot_settings/v1/mocks/mock_region_snapshot_settings_connection.h @@ -0,0 +1,106 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOT_SETTINGS_V1_MOCKS_MOCK_REGION_SNAPSHOT_SETTINGS_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOT_SETTINGS_V1_MOCKS_MOCK_REGION_SNAPSHOT_SETTINGS_CONNECTION_H + +#include "google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings_connection.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_snapshot_settings_v1_mocks { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/** + * A class to mock `RegionSnapshotSettingsConnection`. + * + * Application developers may want to test their code with simulated responses, + * including errors, from an object of type `RegionSnapshotSettingsClient`. To + * do so, construct an object of type `RegionSnapshotSettingsClient` with an + * instance of this class. Then use the Google Test framework functions to + * program the behavior of this mock. + * + * @see [This example][bq-mock] for how to test your application with GoogleTest. + * While the example showcases types from the BigQuery library, the underlying + * principles apply for any pair of `*Client` and `*Connection`. + * + * [bq-mock]: @cloud_cpp_docs_link{bigquery,bigquery-read-mock} + */ +class MockRegionSnapshotSettingsConnection + : public compute_region_snapshot_settings_v1:: + RegionSnapshotSettingsConnection { + public: + MOCK_METHOD(Options, options, (), (override)); + + MOCK_METHOD(StatusOr, + GetSnapshotSettings, + (google::cloud::cpp::compute::region_snapshot_settings::v1:: + GetSnapshotSettingsRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// PatchSnapshotSettings(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + PatchSnapshotSettings, + (google::cloud::cpp::compute::region_snapshot_settings::v1:: + PatchSnapshotSettingsRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// EXPECT_CALL(*mock, PatchSnapshotSettings(_, _)) + /// @endcode + MOCK_METHOD(StatusOr, + PatchSnapshotSettings, + (NoAwaitTag, + google::cloud::cpp::compute::region_snapshot_settings::v1:: + PatchSnapshotSettingsRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// PatchSnapshotSettings(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + PatchSnapshotSettings, + (google::cloud::cpp::compute::v1::Operation const& operation), + (override)); +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_snapshot_settings_v1_mocks +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOT_SETTINGS_V1_MOCKS_MOCK_REGION_SNAPSHOT_SETTINGS_CONNECTION_H diff --git a/google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings_client.cc b/google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings_client.cc new file mode 100644 index 0000000000000..2f411f532e819 --- /dev/null +++ b/google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings_client.cc @@ -0,0 +1,120 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings.proto + +#include "google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings_client.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_snapshot_settings_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +RegionSnapshotSettingsClient::RegionSnapshotSettingsClient( + std::shared_ptr connection, Options opts) + : connection_(std::move(connection)), + options_( + internal::MergeOptions(std::move(opts), connection_->options())) {} +RegionSnapshotSettingsClient::~RegionSnapshotSettingsClient() = default; + +StatusOr +RegionSnapshotSettingsClient::GetSnapshotSettings(std::string const& project, + std::string const& region, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_snapshot_settings::v1:: + GetSnapshotSettingsRequest request; + request.set_project(project); + request.set_region(region); + return connection_->GetSnapshotSettings(request); +} + +StatusOr +RegionSnapshotSettingsClient::GetSnapshotSettings( + google::cloud::cpp::compute::region_snapshot_settings::v1:: + GetSnapshotSettingsRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->GetSnapshotSettings(request); +} + +future> +RegionSnapshotSettingsClient::PatchSnapshotSettings( + std::string const& project, std::string const& region, + std::string const& update_mask, + google::cloud::cpp::compute::v1::SnapshotSettings const& + snapshot_settings_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_snapshot_settings::v1:: + PatchSnapshotSettingsRequest request; + request.set_project(project); + request.set_region(region); + request.set_update_mask(update_mask); + *request.mutable_snapshot_settings_resource() = snapshot_settings_resource; + return connection_->PatchSnapshotSettings(request); +} + +StatusOr +RegionSnapshotSettingsClient::PatchSnapshotSettings( + NoAwaitTag, std::string const& project, std::string const& region, + std::string const& update_mask, + google::cloud::cpp::compute::v1::SnapshotSettings const& + snapshot_settings_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_snapshot_settings::v1:: + PatchSnapshotSettingsRequest request; + request.set_project(project); + request.set_region(region); + request.set_update_mask(update_mask); + *request.mutable_snapshot_settings_resource() = snapshot_settings_resource; + return connection_->PatchSnapshotSettings(NoAwaitTag{}, request); +} + +future> +RegionSnapshotSettingsClient::PatchSnapshotSettings( + google::cloud::cpp::compute::region_snapshot_settings::v1:: + PatchSnapshotSettingsRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->PatchSnapshotSettings(request); +} + +StatusOr +RegionSnapshotSettingsClient::PatchSnapshotSettings( + NoAwaitTag, + google::cloud::cpp::compute::region_snapshot_settings::v1:: + PatchSnapshotSettingsRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->PatchSnapshotSettings(NoAwaitTag{}, request); +} + +future> +RegionSnapshotSettingsClient::PatchSnapshotSettings( + google::cloud::cpp::compute::v1::Operation const& operation, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->PatchSnapshotSettings(operation); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_snapshot_settings_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings_client.h b/google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings_client.h new file mode 100644 index 0000000000000..2e6b6387ede27 --- /dev/null +++ b/google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings_client.h @@ -0,0 +1,292 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOT_SETTINGS_V1_REGION_SNAPSHOT_SETTINGS_CLIENT_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOT_SETTINGS_V1_REGION_SNAPSHOT_SETTINGS_CLIENT_H + +#include "google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings_rest_connection.h" +#include "google/cloud/future.h" +#include "google/cloud/no_await_tag.h" +#include "google/cloud/options.h" +#include "google/cloud/polling_policy.h" +#include "google/cloud/status_or.h" +#include "google/cloud/version.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_snapshot_settings_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/// +/// Service for the regionSnapshotSettings resource. +/// https://cloud.google.com/compute/docs/reference/rest/v1/regionSnapshotSettings +/// +/// @par Equality +/// +/// Instances of this class created via copy-construction or copy-assignment +/// always compare equal. Instances created with equal +/// `std::shared_ptr<*Connection>` objects compare equal. Objects that compare +/// equal share the same underlying resources. +/// +/// @par Performance +/// +/// Creating a new instance of this class is a relatively expensive operation, +/// new objects establish new connections to the service. In contrast, +/// copy-construction, move-construction, and the corresponding assignment +/// operations are relatively efficient as the copies share all underlying +/// resources. +/// +/// @par Thread Safety +/// +/// Concurrent access to different instances of this class, even if they compare +/// equal, is guaranteed to work. Two or more threads operating on the same +/// instance of this class is not guaranteed to work. Since copy-construction +/// and move-construction is a relatively efficient operation, consider using +/// such a copy when using this class from multiple threads. +/// +class RegionSnapshotSettingsClient { + public: + explicit RegionSnapshotSettingsClient( + std::shared_ptr connection, + Options opts = {}); + ~RegionSnapshotSettingsClient(); + + ///@{ + /// @name Copy and move support + RegionSnapshotSettingsClient(RegionSnapshotSettingsClient const&) = default; + RegionSnapshotSettingsClient& operator=(RegionSnapshotSettingsClient const&) = + default; + RegionSnapshotSettingsClient(RegionSnapshotSettingsClient&&) = default; + RegionSnapshotSettingsClient& operator=(RegionSnapshotSettingsClient&&) = + default; + ///@} + + ///@{ + /// @name Equality + friend bool operator==(RegionSnapshotSettingsClient const& a, + RegionSnapshotSettingsClient const& b) { + return a.connection_ == b.connection_; + } + friend bool operator!=(RegionSnapshotSettingsClient const& a, + RegionSnapshotSettingsClient const& b) { + return !(a == b); + } + ///@} + + // clang-format off + /// + /// Get region snapshot settings. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionSnapshotSettings/get + /// + /// @param project Project ID for this request. + /// @param region Name of the region for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.SnapshotSettings]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_snapshot_settings.v1.GetSnapshotSettingsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings.proto#L65} + /// [google.cloud.cpp.compute.v1.SnapshotSettings]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_148.proto#L24} + /// + // clang-format on + StatusOr + GetSnapshotSettings(std::string const& project, std::string const& region, + Options opts = {}); + + // clang-format off + /// + /// Get region snapshot settings. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionSnapshotSettings/get + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.region_snapshot_settings.v1.GetSnapshotSettingsRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.SnapshotSettings]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_snapshot_settings.v1.GetSnapshotSettingsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings.proto#L65} + /// [google.cloud.cpp.compute.v1.SnapshotSettings]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_148.proto#L24} + /// + // clang-format on + StatusOr + GetSnapshotSettings(google::cloud::cpp::compute::region_snapshot_settings:: + v1::GetSnapshotSettingsRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// Patch region snapshot settings. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionSnapshotSettings/patch + /// + /// @param project Project ID for this request. + /// @param region Name of the region for this request. + /// @param update_mask update_mask indicates fields to be updated as part of this request. + /// @param snapshot_settings_resource The SnapshotSettings for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_snapshot_settings.v1.PatchSnapshotSettingsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings.proto#L76} + /// + // clang-format on + future> + PatchSnapshotSettings(std::string const& project, std::string const& region, + std::string const& update_mask, + google::cloud::cpp::compute::v1::SnapshotSettings const& + snapshot_settings_resource, + Options opts = {}); + + // clang-format off + /// + /// @copybrief PatchSnapshotSettings + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr PatchSnapshotSettings( + NoAwaitTag, std::string const& project, std::string const& region, + std::string const& update_mask, + google::cloud::cpp::compute::v1::SnapshotSettings const& + snapshot_settings_resource, + Options opts = {}); + + // clang-format off + /// + /// Patch region snapshot settings. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionSnapshotSettings/patch + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.region_snapshot_settings.v1.PatchSnapshotSettingsRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_snapshot_settings.v1.PatchSnapshotSettingsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings.proto#L76} + /// + // clang-format on + future> + PatchSnapshotSettings(google::cloud::cpp::compute::region_snapshot_settings:: + v1::PatchSnapshotSettingsRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief PatchSnapshotSettings + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr PatchSnapshotSettings( + NoAwaitTag, + google::cloud::cpp::compute::region_snapshot_settings::v1:: + PatchSnapshotSettingsRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief PatchSnapshotSettings + /// + /// This method accepts a `google::cloud::cpp::compute::v1::Operation` that corresponds + /// to a previously started Long Running Operation (LRO) and polls the status + /// of the LRO in the background. + /// + // clang-format on + future> + PatchSnapshotSettings( + google::cloud::cpp::compute::v1::Operation const& operation, + Options opts = {}); + + private: + std::shared_ptr connection_; + Options options_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_snapshot_settings_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOT_SETTINGS_V1_REGION_SNAPSHOT_SETTINGS_CLIENT_H diff --git a/google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings_connection.cc b/google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings_connection.cc new file mode 100644 index 0000000000000..32195699aba10 --- /dev/null +++ b/google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings_connection.cc @@ -0,0 +1,74 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings.proto + +#include "google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings_connection.h" +#include "google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_option_defaults.h" +#include "google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_tracing_connection.h" +#include "google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings_options.h" +#include "google/cloud/background_threads.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/grpc_options.h" +#include "google/cloud/internal/unified_grpc_credentials.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_snapshot_settings_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +RegionSnapshotSettingsConnection::~RegionSnapshotSettingsConnection() = default; + +StatusOr +RegionSnapshotSettingsConnection::GetSnapshotSettings( + google::cloud::cpp::compute::region_snapshot_settings::v1:: + GetSnapshotSettingsRequest const&) { + return Status(StatusCode::kUnimplemented, "not implemented"); +} + +future> +RegionSnapshotSettingsConnection::PatchSnapshotSettings( + google::cloud::cpp::compute::region_snapshot_settings::v1:: + PatchSnapshotSettingsRequest const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +RegionSnapshotSettingsConnection::PatchSnapshotSettings( + NoAwaitTag, google::cloud::cpp::compute::region_snapshot_settings::v1:: + PatchSnapshotSettingsRequest const&) { + return StatusOr( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +RegionSnapshotSettingsConnection::PatchSnapshotSettings( + google::cloud::cpp::compute::v1::Operation const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_snapshot_settings_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings_connection.h b/google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings_connection.h new file mode 100644 index 0000000000000..a61b505f32696 --- /dev/null +++ b/google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings_connection.h @@ -0,0 +1,220 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOT_SETTINGS_V1_REGION_SNAPSHOT_SETTINGS_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOT_SETTINGS_V1_REGION_SNAPSHOT_SETTINGS_CONNECTION_H + +#include "google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_retry_traits.h" +#include "google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings.pb.h" +#include "google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings_connection_idempotency_policy.h" +#include "google/cloud/backoff_policy.h" +#include "google/cloud/future.h" +#include "google/cloud/internal/retry_policy_impl.h" +#include "google/cloud/no_await_tag.h" +#include "google/cloud/options.h" +#include "google/cloud/polling_policy.h" +#include "google/cloud/status_or.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_snapshot_settings_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/// The retry policy for `RegionSnapshotSettingsConnection`. +class RegionSnapshotSettingsRetryPolicy : public ::google::cloud::RetryPolicy { + public: + /// Creates a new instance of the policy, reset to the initial state. + virtual std::unique_ptr clone() const = 0; +}; + +/** + * A retry policy for `RegionSnapshotSettingsConnection` based on counting + * errors. + * + * This policy stops retrying if: + * - An RPC returns a non-transient error. + * - More than a prescribed number of transient failures is detected. + * + * In this class the following status codes are treated as transient errors: + * - [`kUnavailable`](@ref google::cloud::StatusCode) + */ +class RegionSnapshotSettingsLimitedErrorCountRetryPolicy + : public RegionSnapshotSettingsRetryPolicy { + public: + /** + * Create an instance that tolerates up to @p maximum_failures transient + * errors. + * + * @note Disable the retry loop by providing an instance of this policy with + * @p maximum_failures == 0. + */ + explicit RegionSnapshotSettingsLimitedErrorCountRetryPolicy( + int maximum_failures) + : impl_(maximum_failures) {} + + RegionSnapshotSettingsLimitedErrorCountRetryPolicy( + RegionSnapshotSettingsLimitedErrorCountRetryPolicy&& rhs) noexcept + : RegionSnapshotSettingsLimitedErrorCountRetryPolicy( + rhs.maximum_failures()) {} + RegionSnapshotSettingsLimitedErrorCountRetryPolicy( + RegionSnapshotSettingsLimitedErrorCountRetryPolicy const& rhs) noexcept + : RegionSnapshotSettingsLimitedErrorCountRetryPolicy( + rhs.maximum_failures()) {} + + int maximum_failures() const { return impl_.maximum_failures(); } + + bool OnFailure(Status const& status) override { + return impl_.OnFailure(status); + } + bool IsExhausted() const override { return impl_.IsExhausted(); } + bool IsPermanentFailure(Status const& status) const override { + return impl_.IsPermanentFailure(status); + } + std::unique_ptr clone() const override { + return std::make_unique( + maximum_failures()); + } + + // This is provided only for backwards compatibility. + using BaseType = RegionSnapshotSettingsRetryPolicy; + + private: + google::cloud::internal::LimitedErrorCountRetryPolicy< + compute_region_snapshot_settings_v1_internal:: + RegionSnapshotSettingsRetryTraits> + impl_; +}; + +/** + * A retry policy for `RegionSnapshotSettingsConnection` based on elapsed time. + * + * This policy stops retrying if: + * - An RPC returns a non-transient error. + * - The elapsed time in the retry loop exceeds a prescribed duration. + * + * In this class the following status codes are treated as transient errors: + * - [`kUnavailable`](@ref google::cloud::StatusCode) + */ +class RegionSnapshotSettingsLimitedTimeRetryPolicy + : public RegionSnapshotSettingsRetryPolicy { + public: + /** + * Constructor given a `std::chrono::duration<>` object. + * + * @tparam DurationRep a placeholder to match the `Rep` tparam for @p + * duration's type. The semantics of this template parameter are + * documented in `std::chrono::duration<>`. In brief, the underlying + * arithmetic type used to store the number of ticks. For our purposes it + * is simply a formal parameter. + * @tparam DurationPeriod a placeholder to match the `Period` tparam for @p + * duration's type. The semantics of this template parameter are + * documented in `std::chrono::duration<>`. In brief, the length of the + * tick in seconds, expressed as a `std::ratio<>`. For our purposes it is + * simply a formal parameter. + * @param maximum_duration the maximum time allowed before the policy expires. + * While the application can express this time in any units they desire, + * the class truncates to milliseconds. + * + * @see https://en.cppreference.com/w/cpp/chrono/duration for more information + * about `std::chrono::duration`. + */ + template + explicit RegionSnapshotSettingsLimitedTimeRetryPolicy( + std::chrono::duration maximum_duration) + : impl_(maximum_duration) {} + + RegionSnapshotSettingsLimitedTimeRetryPolicy( + RegionSnapshotSettingsLimitedTimeRetryPolicy&& rhs) noexcept + : RegionSnapshotSettingsLimitedTimeRetryPolicy(rhs.maximum_duration()) {} + RegionSnapshotSettingsLimitedTimeRetryPolicy( + RegionSnapshotSettingsLimitedTimeRetryPolicy const& rhs) noexcept + : RegionSnapshotSettingsLimitedTimeRetryPolicy(rhs.maximum_duration()) {} + + std::chrono::milliseconds maximum_duration() const { + return impl_.maximum_duration(); + } + + bool OnFailure(Status const& status) override { + return impl_.OnFailure(status); + } + bool IsExhausted() const override { return impl_.IsExhausted(); } + bool IsPermanentFailure(Status const& status) const override { + return impl_.IsPermanentFailure(status); + } + std::unique_ptr clone() const override { + return std::make_unique( + maximum_duration()); + } + + // This is provided only for backwards compatibility. + using BaseType = RegionSnapshotSettingsRetryPolicy; + + private: + google::cloud::internal::LimitedTimeRetryPolicy< + compute_region_snapshot_settings_v1_internal:: + RegionSnapshotSettingsRetryTraits> + impl_; +}; + +/** + * The `RegionSnapshotSettingsConnection` object for + * `RegionSnapshotSettingsClient`. + * + * This interface defines virtual methods for each of the user-facing overload + * sets in `RegionSnapshotSettingsClient`. This allows users to inject custom + * behavior (e.g., with a Google Mock object) when writing tests that use + * objects of type `RegionSnapshotSettingsClient`. + * + * To create a concrete instance, see `MakeRegionSnapshotSettingsConnection()`. + * + * For mocking, see + * `compute_region_snapshot_settings_v1_mocks::MockRegionSnapshotSettingsConnection`. + */ +class RegionSnapshotSettingsConnection { + public: + virtual ~RegionSnapshotSettingsConnection() = 0; + + virtual Options options() { return Options{}; } + + virtual StatusOr + GetSnapshotSettings(google::cloud::cpp::compute::region_snapshot_settings:: + v1::GetSnapshotSettingsRequest const& request); + + virtual future> + PatchSnapshotSettings(google::cloud::cpp::compute::region_snapshot_settings:: + v1::PatchSnapshotSettingsRequest const& request); + + virtual StatusOr + PatchSnapshotSettings(NoAwaitTag, + google::cloud::cpp::compute::region_snapshot_settings:: + v1::PatchSnapshotSettingsRequest const& request); + + virtual future> + PatchSnapshotSettings( + google::cloud::cpp::compute::v1::Operation const& operation); +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_snapshot_settings_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOT_SETTINGS_V1_REGION_SNAPSHOT_SETTINGS_CONNECTION_H diff --git a/google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings_connection_idempotency_policy.cc b/google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings_connection_idempotency_policy.cc new file mode 100644 index 0000000000000..28eee491010bc --- /dev/null +++ b/google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings_connection_idempotency_policy.cc @@ -0,0 +1,61 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings.proto + +#include "google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings_connection_idempotency_policy.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_snapshot_settings_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +using ::google::cloud::Idempotency; + +RegionSnapshotSettingsConnectionIdempotencyPolicy:: + ~RegionSnapshotSettingsConnectionIdempotencyPolicy() = default; + +std::unique_ptr +RegionSnapshotSettingsConnectionIdempotencyPolicy::clone() const { + return std::make_unique( + *this); +} + +Idempotency +RegionSnapshotSettingsConnectionIdempotencyPolicy::GetSnapshotSettings( + google::cloud::cpp::compute::region_snapshot_settings::v1:: + GetSnapshotSettingsRequest const&) { + return Idempotency::kIdempotent; +} + +Idempotency +RegionSnapshotSettingsConnectionIdempotencyPolicy::PatchSnapshotSettings( + google::cloud::cpp::compute::region_snapshot_settings::v1:: + PatchSnapshotSettingsRequest const&) { + return Idempotency::kNonIdempotent; +} + +std::unique_ptr +MakeDefaultRegionSnapshotSettingsConnectionIdempotencyPolicy() { + return std::make_unique(); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_snapshot_settings_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings_connection_idempotency_policy.h b/google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings_connection_idempotency_policy.h new file mode 100644 index 0000000000000..05a4504e3b634 --- /dev/null +++ b/google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings_connection_idempotency_policy.h @@ -0,0 +1,58 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOT_SETTINGS_V1_REGION_SNAPSHOT_SETTINGS_CONNECTION_IDEMPOTENCY_POLICY_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOT_SETTINGS_V1_REGION_SNAPSHOT_SETTINGS_CONNECTION_IDEMPOTENCY_POLICY_H + +#include "google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings.pb.h" +#include "google/cloud/idempotency.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_snapshot_settings_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class RegionSnapshotSettingsConnectionIdempotencyPolicy { + public: + virtual ~RegionSnapshotSettingsConnectionIdempotencyPolicy(); + + /// Create a new copy of this object. + virtual std::unique_ptr + clone() const; + + virtual google::cloud::Idempotency GetSnapshotSettings( + google::cloud::cpp::compute::region_snapshot_settings::v1:: + GetSnapshotSettingsRequest const& request); + + virtual google::cloud::Idempotency PatchSnapshotSettings( + google::cloud::cpp::compute::region_snapshot_settings::v1:: + PatchSnapshotSettingsRequest const& request); +}; + +std::unique_ptr +MakeDefaultRegionSnapshotSettingsConnectionIdempotencyPolicy(); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_snapshot_settings_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOT_SETTINGS_V1_REGION_SNAPSHOT_SETTINGS_CONNECTION_IDEMPOTENCY_POLICY_H diff --git a/google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings_options.h b/google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings_options.h new file mode 100644 index 0000000000000..3c41e9b20d86a --- /dev/null +++ b/google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings_options.h @@ -0,0 +1,89 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOT_SETTINGS_V1_REGION_SNAPSHOT_SETTINGS_OPTIONS_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOT_SETTINGS_V1_REGION_SNAPSHOT_SETTINGS_OPTIONS_H + +#include "google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings_connection.h" +#include "google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings_connection_idempotency_policy.h" +#include "google/cloud/backoff_policy.h" +#include "google/cloud/options.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_snapshot_settings_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/** + * Use with `google::cloud::Options` to configure the retry policy. + * + * @ingroup google-cloud-compute-options + */ +struct RegionSnapshotSettingsRetryPolicyOption { + using Type = std::shared_ptr; +}; + +/** + * Use with `google::cloud::Options` to configure the backoff policy. + * + * @ingroup google-cloud-compute-options + */ +struct RegionSnapshotSettingsBackoffPolicyOption { + using Type = std::shared_ptr; +}; + +/** + * Use with `google::cloud::Options` to configure which operations are retried. + * + * @ingroup google-cloud-compute-options + */ +struct RegionSnapshotSettingsConnectionIdempotencyPolicyOption { + using Type = + std::shared_ptr; +}; + +/** + * Use with `google::cloud::Options` to configure the long-running operations + * polling policy. + * + * @ingroup google-cloud-compute-options + */ +struct RegionSnapshotSettingsPollingPolicyOption { + using Type = std::shared_ptr; +}; + +/** + * The options applicable to RegionSnapshotSettings. + * + * @ingroup google-cloud-compute-options + */ +using RegionSnapshotSettingsPolicyOptionList = + OptionList; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_snapshot_settings_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOT_SETTINGS_V1_REGION_SNAPSHOT_SETTINGS_OPTIONS_H diff --git a/google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings_proto_export.h b/google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings_proto_export.h new file mode 100644 index 0000000000000..4ecd879be91be --- /dev/null +++ b/google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings_proto_export.h @@ -0,0 +1,33 @@ +// Copyright 2026 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_REGION_SNAPSHOT_SETTINGS_V1_REGION_SNAPSHOT_SETTINGS_PROTO_EXPORT_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOT_SETTINGS_V1_REGION_SNAPSHOT_SETTINGS_PROTO_EXPORT_H + +// IWYU pragma: begin_exports +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_148.pb.h" +// IWYU pragma: end_exports + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOT_SETTINGS_V1_REGION_SNAPSHOT_SETTINGS_PROTO_EXPORT_H diff --git a/google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings_rest_connection.cc b/google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings_rest_connection.cc new file mode 100644 index 0000000000000..b4aa8f99e5f36 --- /dev/null +++ b/google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings_rest_connection.cc @@ -0,0 +1,61 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings.proto + +#include "google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings_rest_connection.h" +#include "google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_option_defaults.h" +#include "google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_rest_connection_impl.h" +#include "google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_rest_stub_factory.h" +#include "google/cloud/compute/region_snapshot_settings/v1/internal/region_snapshot_settings_tracing_connection.h" +#include "google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings_options.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/internal/rest_background_threads_impl.h" +#include "google/cloud/internal/rest_options.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_snapshot_settings_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +std::shared_ptr +MakeRegionSnapshotSettingsConnectionRest(Options options) { + internal::CheckExpectedOptions( + options, __func__); + options = compute_region_snapshot_settings_v1_internal:: + RegionSnapshotSettingsDefaultOptions(std::move(options)); + auto background = std::make_unique< + rest_internal::AutomaticallyCreatedRestBackgroundThreads>(); + auto stub = compute_region_snapshot_settings_v1_internal:: + CreateDefaultRegionSnapshotSettingsRestStub(options); + return compute_region_snapshot_settings_v1_internal:: + MakeRegionSnapshotSettingsTracingConnection( + std::make_shared( + std::move(background), std::move(stub), std::move(options))); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_snapshot_settings_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings_rest_connection.h b/google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings_rest_connection.h new file mode 100644 index 0000000000000..89d8fcbff83bf --- /dev/null +++ b/google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings_rest_connection.h @@ -0,0 +1,67 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOT_SETTINGS_V1_REGION_SNAPSHOT_SETTINGS_REST_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOT_SETTINGS_V1_REGION_SNAPSHOT_SETTINGS_REST_CONNECTION_H + +#include "google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings_connection.h" +#include "google/cloud/options.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_snapshot_settings_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/** + * A factory function to construct an object of type + * `RegionSnapshotSettingsConnection` that uses REST over HTTP as transport in + * lieu of gRPC. REST transport should only be used for services that do not + * support gRPC or if the existing network configuration precludes using gRPC. + * + * The returned connection object should not be used directly; instead it + * should be passed as an argument to the constructor of + * RegionSnapshotSettingsClient. + * + * The optional @p options argument may be used to configure aspects of the + * returned `RegionSnapshotSettingsConnection`. Expected options are any of the + * types in the following option lists: + * + * - `google::cloud::CommonOptionList` + * - `google::cloud::RestOptionList` + * - `google::cloud::UnifiedCredentialsOptionList` + * - + * `google::cloud::compute_region_snapshot_settings_v1::RegionSnapshotSettingsPolicyOptionList` + * + * @note Unexpected options will be ignored. To log unexpected options instead, + * set `GOOGLE_CLOUD_CPP_ENABLE_CLOG=yes` in the environment. + * + * @param options (optional) Configure the `RegionSnapshotSettingsConnection` + * created by this function. + */ +std::shared_ptr +MakeRegionSnapshotSettingsConnectionRest(Options options = {}); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_snapshot_settings_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOT_SETTINGS_V1_REGION_SNAPSHOT_SETTINGS_REST_CONNECTION_H diff --git a/google/cloud/compute/region_snapshot_settings/v1/samples/region_snapshot_settings_client_samples.cc b/google/cloud/compute/region_snapshot_settings/v1/samples/region_snapshot_settings_client_samples.cc new file mode 100644 index 0000000000000..73ce792760720 --- /dev/null +++ b/google/cloud/compute/region_snapshot_settings/v1/samples/region_snapshot_settings_client_samples.cc @@ -0,0 +1,244 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings.proto + +#include "google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings_client.h" +#include "google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings_connection_idempotency_policy.h" +#include "google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings_options.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/internal/getenv.h" +#include "google/cloud/polling_policy.h" +#include "google/cloud/testing_util/example_driver.h" +#include "google/cloud/universe_domain.h" +#include +#include +#include +#include + +// clang-format off +// main-dox-marker: compute_region_snapshot_settings_v1::RegionSnapshotSettingsClient +// lro-marker: true +// clang-format on +namespace { + +void SetClientEndpoint(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-endpoint"}; + } + //! [set-client-endpoint] + // This configuration is common with Private Google Access: + // https://cloud.google.com/vpc/docs/private-google-access + auto options = google::cloud::Options{}.set( + "private.googleapis.com"); + auto vpc_client = google::cloud::compute_region_snapshot_settings_v1:: + RegionSnapshotSettingsClient( + google::cloud::compute_region_snapshot_settings_v1:: + MakeRegionSnapshotSettingsConnectionRest(options)); + //! [set-client-endpoint] +} + +void SetClientUniverseDomain(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-universe-domain"}; + } + //! [set-client-universe-domain] + google::cloud::Options options; + + // AddUniverseDomainOption interrogates the UnifiedCredentialsOption, if set, + // in the provided Options for the Universe Domain associated with the + // credentials and adds it to the set of Options. + // If no UnifiedCredentialsOption is set, GoogleDefaultCredentials are used. + auto ud_options = google::cloud::AddUniverseDomainOption(std::move(options)); + + if (!ud_options.ok()) throw std::move(ud_options).status(); + auto ud_client = google::cloud::compute_region_snapshot_settings_v1:: + RegionSnapshotSettingsClient( + google::cloud::compute_region_snapshot_settings_v1:: + MakeRegionSnapshotSettingsConnectionRest(*ud_options)); + //! [set-client-universe-domain] +} + +//! [custom-idempotency-policy] +class CustomIdempotencyPolicy + : public google::cloud::compute_region_snapshot_settings_v1:: + RegionSnapshotSettingsConnectionIdempotencyPolicy { + public: + ~CustomIdempotencyPolicy() override = default; + std::unique_ptr + clone() const override { + return std::make_unique(*this); + } + // Override inherited functions to define as needed. +}; +//! [custom-idempotency-policy] + +void SetRetryPolicy(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-retry-policy"}; + } + //! [set-retry-policy] + auto options = + google::cloud::Options{} + .set( + CustomIdempotencyPolicy().clone()) + .set( + google::cloud::compute_region_snapshot_settings_v1:: + RegionSnapshotSettingsLimitedErrorCountRetryPolicy(3) + .clone()) + .set( + google::cloud::ExponentialBackoffPolicy( + /*initial_delay=*/std::chrono::milliseconds(200), + /*maximum_delay=*/std::chrono::seconds(45), + /*scaling=*/2.0) + .clone()); + auto connection = google::cloud::compute_region_snapshot_settings_v1:: + MakeRegionSnapshotSettingsConnectionRest(options); + + // c1 and c2 share the same retry policies + auto c1 = google::cloud::compute_region_snapshot_settings_v1:: + RegionSnapshotSettingsClient(connection); + auto c2 = google::cloud::compute_region_snapshot_settings_v1:: + RegionSnapshotSettingsClient(connection); + + // You can override any of the policies in a new client. This new client + // will share the policies from c1 (or c2) *except* for the retry policy. + auto c3 = google::cloud::compute_region_snapshot_settings_v1:: + RegionSnapshotSettingsClient( + connection, + google::cloud::Options{} + .set( + google::cloud::compute_region_snapshot_settings_v1:: + RegionSnapshotSettingsLimitedTimeRetryPolicy( + std::chrono::minutes(5)) + .clone())); + + // You can also override the policies in a single call: + // c3.SomeRpc(..., google::cloud::Options{} + // .set( + // google::cloud::compute_region_snapshot_settings_v1::RegionSnapshotSettingsLimitedErrorCountRetryPolicy(10).clone())); + //! [set-retry-policy] +} + +void SetPollingPolicy(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-policy-policy"}; + } + //! [set-polling-policy] + + // The polling policy controls how the client waits for long-running + // operations. `GenericPollingPolicy<>` combines existing policies. + // In this case, keep polling until the operation completes (with success + // or error) or 45 minutes, whichever happens first. Initially pause for + // 10 seconds between polling requests, increasing the pause by a factor + // of 4 until it becomes 2 minutes. + auto options = + google::cloud::Options{} + .set( + google::cloud::GenericPollingPolicy< + google::cloud::compute_region_snapshot_settings_v1:: + RegionSnapshotSettingsRetryPolicyOption::Type, + google::cloud::compute_region_snapshot_settings_v1:: + RegionSnapshotSettingsBackoffPolicyOption::Type>( + google::cloud::compute_region_snapshot_settings_v1:: + RegionSnapshotSettingsLimitedTimeRetryPolicy( + /*maximum_duration=*/std::chrono::minutes(45)) + .clone(), + google::cloud::ExponentialBackoffPolicy( + /*initial_delay=*/std::chrono::seconds(10), + /*maximum_delay=*/std::chrono::minutes(2), + /*scaling=*/4.0) + .clone()) + .clone()); + + auto connection = google::cloud::compute_region_snapshot_settings_v1:: + MakeRegionSnapshotSettingsConnectionRest(options); + + // c1 and c2 share the same polling policies. + auto c1 = google::cloud::compute_region_snapshot_settings_v1:: + RegionSnapshotSettingsClient(connection); + auto c2 = google::cloud::compute_region_snapshot_settings_v1:: + RegionSnapshotSettingsClient(connection); + //! [set-polling-policy] +} + +void WithServiceAccount(std::vector const& argv) { + if (argv.size() != 1 || argv[0] == "--help") { + throw google::cloud::testing_util::Usage{"with-service-account "}; + } + //! [with-service-account] + [](std::string const& keyfile) { + auto is = std::ifstream(keyfile); + is.exceptions(std::ios::badbit); // Minimal error handling in examples + auto contents = std::string(std::istreambuf_iterator(is.rdbuf()), {}); + auto options = + google::cloud::Options{}.set( + google::cloud::MakeServiceAccountCredentials(contents)); + return google::cloud::compute_region_snapshot_settings_v1:: + RegionSnapshotSettingsClient( + google::cloud::compute_region_snapshot_settings_v1:: + MakeRegionSnapshotSettingsConnectionRest(options)); + } + //! [with-service-account] + (argv.at(0)); +} + +void AutoRun(std::vector const& argv) { + namespace examples = ::google::cloud::testing_util; + using ::google::cloud::internal::GetEnv; + if (!argv.empty()) throw examples::Usage{"auto"}; + examples::CheckEnvironmentVariablesAreSet( + {"GOOGLE_CLOUD_CPP_TEST_SERVICE_ACCOUNT_KEYFILE"}); + auto const keyfile = + GetEnv("GOOGLE_CLOUD_CPP_TEST_SERVICE_ACCOUNT_KEYFILE").value(); + + std::cout << "\nRunning SetClientEndpoint() example" << std::endl; + SetClientEndpoint({}); + + std::cout << "\nRunning SetRetryPolicy() example" << std::endl; + SetRetryPolicy({}); + + std::cout << "\nRunning SetPollingPolicy() example" << std::endl; + SetPollingPolicy({}); + + std::cout << "\nRunning WithServiceAccount() example" << std::endl; + WithServiceAccount({keyfile}); + + std::cout << "\nRunning SetClientUniverseDomain() example" << std::endl; + SetClientUniverseDomain({}); +} + +} // namespace + +int main(int argc, char* argv[]) { // NOLINT(bugprone-exception-escape) + google::cloud::testing_util::Example example({ + {"set-client-endpoint", SetClientEndpoint}, + {"set-retry-policy", SetRetryPolicy}, + {"set-polling-policy", SetPollingPolicy}, + {"with-service-account", WithServiceAccount}, + {"set-client-universe-domain", SetClientUniverseDomain}, + {"auto", AutoRun}, + }); + return example.Run(argc, argv); +} diff --git a/google/cloud/compute/region_snapshots/v1/internal/region_snapshots_option_defaults.cc b/google/cloud/compute/region_snapshots/v1/internal/region_snapshots_option_defaults.cc new file mode 100644 index 0000000000000..f247388a850f0 --- /dev/null +++ b/google/cloud/compute/region_snapshots/v1/internal/region_snapshots_option_defaults.cc @@ -0,0 +1,88 @@ +// Copyright 2026 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. +// source: google/cloud/compute/region_snapshots/v1/region_snapshots.proto + +#include "google/cloud/compute/region_snapshots/v1/internal/region_snapshots_option_defaults.h" +#include "google/cloud/compute/region_snapshots/v1/region_snapshots_connection.h" +#include "google/cloud/compute/region_snapshots/v1/region_snapshots_options.h" +#include "google/cloud/internal/populate_common_options.h" +#include "google/cloud/internal/populate_grpc_options.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_snapshots_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +namespace { +auto constexpr kBackoffScaling = 2.0; +} // namespace + +Options RegionSnapshotsDefaultOptions(Options options) { + options = internal::PopulateCommonOptions( + std::move(options), "GOOGLE_CLOUD_CPP_REGION_SNAPSHOTS_ENDPOINT", "", + "GOOGLE_CLOUD_CPP_REGION_SNAPSHOTS_AUTHORITY", "compute.googleapis.com"); + options = internal::PopulateGrpcOptions(std::move(options)); + if (!options.has< + compute_region_snapshots_v1::RegionSnapshotsRetryPolicyOption>()) { + options.set( + compute_region_snapshots_v1::RegionSnapshotsLimitedTimeRetryPolicy( + std::chrono::minutes(10)) + .clone()); + } + if (!options.has< + compute_region_snapshots_v1::RegionSnapshotsBackoffPolicyOption>()) { + options + .set( + ExponentialBackoffPolicy( + std::chrono::seconds(0), std::chrono::seconds(1), + std::chrono::minutes(5), kBackoffScaling, kBackoffScaling) + .clone()); + } + if (!options.has< + compute_region_snapshots_v1::RegionSnapshotsPollingPolicyOption>()) { + options.set< + compute_region_snapshots_v1::RegionSnapshotsPollingPolicyOption>( + GenericPollingPolicy< + compute_region_snapshots_v1::RegionSnapshotsRetryPolicyOption::Type, + compute_region_snapshots_v1::RegionSnapshotsBackoffPolicyOption:: + Type>( + options + .get() + ->clone(), + ExponentialBackoffPolicy(std::chrono::seconds(1), + std::chrono::minutes(5), kBackoffScaling) + .clone()) + .clone()); + } + if (!options.has()) { + options.set( + compute_region_snapshots_v1:: + MakeDefaultRegionSnapshotsConnectionIdempotencyPolicy()); + } + + return options; +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_snapshots_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_snapshots/v1/internal/region_snapshots_option_defaults.h b/google/cloud/compute/region_snapshots/v1/internal/region_snapshots_option_defaults.h new file mode 100644 index 0000000000000..293bf94480049 --- /dev/null +++ b/google/cloud/compute/region_snapshots/v1/internal/region_snapshots_option_defaults.h @@ -0,0 +1,37 @@ +// Copyright 2026 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. +// source: google/cloud/compute/region_snapshots/v1/region_snapshots.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOTS_V1_INTERNAL_REGION_SNAPSHOTS_OPTION_DEFAULTS_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOTS_V1_INTERNAL_REGION_SNAPSHOTS_OPTION_DEFAULTS_H + +#include "google/cloud/options.h" +#include "google/cloud/version.h" + +namespace google { +namespace cloud { +namespace compute_region_snapshots_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +Options RegionSnapshotsDefaultOptions(Options options); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_snapshots_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOTS_V1_INTERNAL_REGION_SNAPSHOTS_OPTION_DEFAULTS_H diff --git a/google/cloud/compute/region_snapshots/v1/internal/region_snapshots_rest_connection_impl.cc b/google/cloud/compute/region_snapshots/v1/internal/region_snapshots_rest_connection_impl.cc new file mode 100644 index 0000000000000..9c368f0af2673 --- /dev/null +++ b/google/cloud/compute/region_snapshots/v1/internal/region_snapshots_rest_connection_impl.cc @@ -0,0 +1,678 @@ +// Copyright 2026 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. +// source: google/cloud/compute/region_snapshots/v1/region_snapshots.proto + +#include "google/cloud/compute/region_snapshots/v1/internal/region_snapshots_rest_connection_impl.h" +#include "google/cloud/compute/region_snapshots/v1/internal/region_snapshots_rest_stub_factory.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/internal/async_rest_long_running_operation_custom.h" +#include "google/cloud/internal/extract_long_running_result.h" +#include "google/cloud/internal/pagination_range.h" +#include "google/cloud/internal/rest_lro_helpers.h" +#include "google/cloud/internal/rest_retry_loop.h" +#include "google/cloud/rest_options.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_snapshots_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +RegionSnapshotsRestConnectionImpl::RegionSnapshotsRestConnectionImpl( + std::unique_ptr background, + std::shared_ptr< + compute_region_snapshots_v1_internal::RegionSnapshotsRestStub> + stub, + Options options) + : background_(std::move(background)), + stub_(std::move(stub)), + options_(internal::MergeOptions(std::move(options), + RegionSnapshotsConnection::options())) {} + +future> +RegionSnapshotsRestConnectionImpl::DeleteSnapshot( + google::cloud::cpp::compute::region_snapshots::v1:: + DeleteSnapshotRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::region_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, request, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_snapshots::v1:: + DeleteSnapshotRequest const& request) { + return stub->AsyncDeleteSnapshot(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->DeleteSnapshot(request), + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [request](std::string const& op, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest& r) { + r.set_project(request.project()); + r.set_region(request.region()); + r.set_operation(op); + }, + [request](std::string const& op, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest& r) { + r.set_project(request.project()); + r.set_region(request.region()); + r.set_operation(op); + }); +} + +StatusOr +RegionSnapshotsRestConnectionImpl::DeleteSnapshot( + NoAwaitTag, google::cloud::cpp::compute::region_snapshots::v1:: + DeleteSnapshotRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->DeleteSnapshot(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_snapshots::v1:: + DeleteSnapshotRequest const& request) { + return stub_->DeleteSnapshot(rest_context, options, request); + }, + *current, request, __func__); +} + +future> +RegionSnapshotsRestConnectionImpl::DeleteSnapshot( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestAwaitLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::region_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, operation, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [operation](std::string const&, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_region(info.region); + r.set_operation(info.operation); + }, + [operation](std::string const&, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_region(info.region); + r.set_operation(info.operation); + }); +} + +StatusOr +RegionSnapshotsRestConnectionImpl::GetSnapshot( + google::cloud::cpp::compute::region_snapshots::v1::GetSnapshotRequest const& + request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->GetSnapshot(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_snapshots::v1:: + GetSnapshotRequest const& request) { + return stub_->GetSnapshot(rest_context, options, request); + }, + *current, request, __func__); +} + +StatusOr +RegionSnapshotsRestConnectionImpl::GetIamPolicy( + google::cloud::cpp::compute::region_snapshots::v1:: + GetIamPolicyRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->GetIamPolicy(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_snapshots::v1:: + GetIamPolicyRequest const& request) { + return stub_->GetIamPolicy(rest_context, options, request); + }, + *current, request, __func__); +} + +future> +RegionSnapshotsRestConnectionImpl::InsertSnapshot( + google::cloud::cpp::compute::region_snapshots::v1:: + InsertSnapshotRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::region_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, request, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_snapshots::v1:: + InsertSnapshotRequest const& request) { + return stub->AsyncInsertSnapshot(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->InsertSnapshot(request), + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [request](std::string const& op, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest& r) { + r.set_project(request.project()); + r.set_region(request.region()); + r.set_operation(op); + }, + [request](std::string const& op, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest& r) { + r.set_project(request.project()); + r.set_region(request.region()); + r.set_operation(op); + }); +} + +StatusOr +RegionSnapshotsRestConnectionImpl::InsertSnapshot( + NoAwaitTag, google::cloud::cpp::compute::region_snapshots::v1:: + InsertSnapshotRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->InsertSnapshot(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_snapshots::v1:: + InsertSnapshotRequest const& request) { + return stub_->InsertSnapshot(rest_context, options, request); + }, + *current, request, __func__); +} + +future> +RegionSnapshotsRestConnectionImpl::InsertSnapshot( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestAwaitLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::region_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, operation, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [operation](std::string const&, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_region(info.region); + r.set_operation(info.operation); + }, + [operation](std::string const&, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_region(info.region); + r.set_operation(info.operation); + }); +} + +StreamRange +RegionSnapshotsRestConnectionImpl::ListRegionSnapshots( + google::cloud::cpp::compute::region_snapshots::v1:: + ListRegionSnapshotsRequest request) { + request.clear_page_token(); + auto current = google::cloud::internal::SaveCurrentOptions(); + auto idempotency = idempotency_policy(*current)->ListRegionSnapshots(request); + char const* function_name = __func__; + return google::cloud::internal::MakePaginationRange< + StreamRange>( + current, std::move(request), + [idempotency, function_name, stub = stub_, + retry = std::shared_ptr< + compute_region_snapshots_v1::RegionSnapshotsRetryPolicy>( + retry_policy(*current)), + backoff = std::shared_ptr(backoff_policy(*current))]( + Options const& options, + google::cloud::cpp::compute::region_snapshots::v1:: + ListRegionSnapshotsRequest const& r) { + return google::cloud::rest_internal::RestRetryLoop( + retry->clone(), backoff->clone(), idempotency, + [stub](rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_snapshots::v1:: + ListRegionSnapshotsRequest const& request) { + return stub->ListRegionSnapshots(rest_context, options, request); + }, + options, r, function_name); + }, + [](google::cloud::cpp::compute::v1::SnapshotList r) { + std::vector result( + r.items().size()); + auto& messages = *r.mutable_items(); + std::move(messages.begin(), messages.end(), result.begin()); + return result; + }); +} + +StatusOr +RegionSnapshotsRestConnectionImpl::SetIamPolicy( + google::cloud::cpp::compute::region_snapshots::v1:: + SetIamPolicyRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->SetIamPolicy(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_snapshots::v1:: + SetIamPolicyRequest const& request) { + return stub_->SetIamPolicy(rest_context, options, request); + }, + *current, request, __func__); +} + +future> +RegionSnapshotsRestConnectionImpl::SetLabels( + google::cloud::cpp::compute::region_snapshots::v1::SetLabelsRequest const& + request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::region_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, request, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_snapshots::v1:: + SetLabelsRequest const& request) { + return stub->AsyncSetLabels(cq, std::move(context), std::move(options), + request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->SetLabels(request), + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [request](std::string const& op, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest& r) { + r.set_project(request.project()); + r.set_region(request.region()); + r.set_operation(op); + }, + [request](std::string const& op, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest& r) { + r.set_project(request.project()); + r.set_region(request.region()); + r.set_operation(op); + }); +} + +StatusOr +RegionSnapshotsRestConnectionImpl::SetLabels( + NoAwaitTag, + google::cloud::cpp::compute::region_snapshots::v1::SetLabelsRequest const& + request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->SetLabels(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_snapshots::v1:: + SetLabelsRequest const& request) { + return stub_->SetLabels(rest_context, options, request); + }, + *current, request, __func__); +} + +future> +RegionSnapshotsRestConnectionImpl::SetLabels( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestAwaitLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::region_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, operation, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [operation](std::string const&, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_region(info.region); + r.set_operation(info.operation); + }, + [operation](std::string const&, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_region(info.region); + r.set_operation(info.operation); + }); +} + +StatusOr +RegionSnapshotsRestConnectionImpl::TestIamPermissions( + google::cloud::cpp::compute::region_snapshots::v1:: + TestIamPermissionsRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->TestIamPermissions(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_snapshots::v1:: + TestIamPermissionsRequest const& request) { + return stub_->TestIamPermissions(rest_context, options, request); + }, + *current, request, __func__); +} + +future> +RegionSnapshotsRestConnectionImpl::UpdateKmsKey( + google::cloud::cpp::compute::region_snapshots::v1:: + UpdateKmsKeyRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::region_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, request, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_snapshots::v1:: + UpdateKmsKeyRequest const& request) { + return stub->AsyncUpdateKmsKey(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->UpdateKmsKey(request), + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [request](std::string const& op, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest& r) { + r.set_project(request.project()); + r.set_region(request.region()); + r.set_operation(op); + }, + [request](std::string const& op, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest& r) { + r.set_project(request.project()); + r.set_region(request.region()); + r.set_operation(op); + }); +} + +StatusOr +RegionSnapshotsRestConnectionImpl::UpdateKmsKey( + NoAwaitTag, google::cloud::cpp::compute::region_snapshots::v1:: + UpdateKmsKeyRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->UpdateKmsKey(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_snapshots::v1:: + UpdateKmsKeyRequest const& request) { + return stub_->UpdateKmsKey(rest_context, options, request); + }, + *current, request, __func__); +} + +future> +RegionSnapshotsRestConnectionImpl::UpdateKmsKey( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestAwaitLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::region_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, operation, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [operation](std::string const&, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_region(info.region); + r.set_operation(info.operation); + }, + [operation](std::string const&, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_region(info.region); + r.set_operation(info.operation); + }); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_snapshots_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_snapshots/v1/internal/region_snapshots_rest_connection_impl.h b/google/cloud/compute/region_snapshots/v1/internal/region_snapshots_rest_connection_impl.h new file mode 100644 index 0000000000000..f348aef74c982 --- /dev/null +++ b/google/cloud/compute/region_snapshots/v1/internal/region_snapshots_rest_connection_impl.h @@ -0,0 +1,161 @@ +// Copyright 2026 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. +// source: google/cloud/compute/region_snapshots/v1/region_snapshots.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOTS_V1_INTERNAL_REGION_SNAPSHOTS_REST_CONNECTION_IMPL_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOTS_V1_INTERNAL_REGION_SNAPSHOTS_REST_CONNECTION_IMPL_H + +#include "google/cloud/compute/region_operations/v1/region_operations.pb.h" +#include "google/cloud/compute/region_snapshots/v1/internal/region_snapshots_rest_stub.h" +#include "google/cloud/compute/region_snapshots/v1/internal/region_snapshots_retry_traits.h" +#include "google/cloud/compute/region_snapshots/v1/region_snapshots_connection.h" +#include "google/cloud/compute/region_snapshots/v1/region_snapshots_connection_idempotency_policy.h" +#include "google/cloud/compute/region_snapshots/v1/region_snapshots_options.h" +#include "google/cloud/background_threads.h" +#include "google/cloud/backoff_policy.h" +#include "google/cloud/options.h" +#include "google/cloud/status_or.h" +#include "google/cloud/stream_range.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_snapshots_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class RegionSnapshotsRestConnectionImpl + : public compute_region_snapshots_v1::RegionSnapshotsConnection { + public: + ~RegionSnapshotsRestConnectionImpl() override = default; + + RegionSnapshotsRestConnectionImpl( + std::unique_ptr background, + std::shared_ptr< + compute_region_snapshots_v1_internal::RegionSnapshotsRestStub> + stub, + Options options); + + Options options() override { return options_; } + + future> DeleteSnapshot( + google::cloud::cpp::compute::region_snapshots::v1:: + DeleteSnapshotRequest const& request) override; + + StatusOr DeleteSnapshot( + NoAwaitTag, google::cloud::cpp::compute::region_snapshots::v1:: + DeleteSnapshotRequest const& request) override; + + future> DeleteSnapshot( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + StatusOr GetSnapshot( + google::cloud::cpp::compute::region_snapshots::v1:: + GetSnapshotRequest const& request) override; + + StatusOr GetIamPolicy( + google::cloud::cpp::compute::region_snapshots::v1:: + GetIamPolicyRequest const& request) override; + + future> InsertSnapshot( + google::cloud::cpp::compute::region_snapshots::v1:: + InsertSnapshotRequest const& request) override; + + StatusOr InsertSnapshot( + NoAwaitTag, google::cloud::cpp::compute::region_snapshots::v1:: + InsertSnapshotRequest const& request) override; + + future> InsertSnapshot( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + StreamRange ListRegionSnapshots( + google::cloud::cpp::compute::region_snapshots::v1:: + ListRegionSnapshotsRequest request) override; + + StatusOr SetIamPolicy( + google::cloud::cpp::compute::region_snapshots::v1:: + SetIamPolicyRequest const& request) override; + + future> SetLabels( + google::cloud::cpp::compute::region_snapshots::v1::SetLabelsRequest const& + request) override; + + StatusOr SetLabels( + NoAwaitTag, + google::cloud::cpp::compute::region_snapshots::v1::SetLabelsRequest const& + request) override; + + future> SetLabels( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + StatusOr + TestIamPermissions(google::cloud::cpp::compute::region_snapshots::v1:: + TestIamPermissionsRequest const& request) override; + + future> UpdateKmsKey( + google::cloud::cpp::compute::region_snapshots::v1:: + UpdateKmsKeyRequest const& request) override; + + StatusOr UpdateKmsKey( + NoAwaitTag, google::cloud::cpp::compute::region_snapshots::v1:: + UpdateKmsKeyRequest const& request) override; + + future> UpdateKmsKey( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + private: + static std::unique_ptr< + compute_region_snapshots_v1::RegionSnapshotsRetryPolicy> + retry_policy(Options const& options) { + return options + .get() + ->clone(); + } + + static std::unique_ptr backoff_policy(Options const& options) { + return options + .get() + ->clone(); + } + + static std::unique_ptr< + compute_region_snapshots_v1::RegionSnapshotsConnectionIdempotencyPolicy> + idempotency_policy(Options const& options) { + return options + .get() + ->clone(); + } + + static std::unique_ptr polling_policy(Options const& options) { + return options + .get() + ->clone(); + } + + std::unique_ptr background_; + std::shared_ptr + stub_; + Options options_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_snapshots_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOTS_V1_INTERNAL_REGION_SNAPSHOTS_REST_CONNECTION_IMPL_H diff --git a/google/cloud/compute/region_snapshots/v1/internal/region_snapshots_rest_logging_decorator.cc b/google/cloud/compute/region_snapshots/v1/internal/region_snapshots_rest_logging_decorator.cc new file mode 100644 index 0000000000000..b7e0d0767fc1a --- /dev/null +++ b/google/cloud/compute/region_snapshots/v1/internal/region_snapshots_rest_logging_decorator.cc @@ -0,0 +1,285 @@ +// Copyright 2026 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. +// source: google/cloud/compute/region_snapshots/v1/region_snapshots.proto + +#include "google/cloud/compute/region_snapshots/v1/internal/region_snapshots_rest_logging_decorator.h" +#include "google/cloud/internal/log_wrapper.h" +#include "google/cloud/status_or.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_snapshots_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +RegionSnapshotsRestLogging::RegionSnapshotsRestLogging( + std::shared_ptr child, + TracingOptions tracing_options, std::set components) + : child_(std::move(child)), + tracing_options_(std::move(tracing_options)), + components_(std::move(components)) {} + +future> +RegionSnapshotsRestLogging::AsyncDeleteSnapshot( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_snapshots::v1:: + DeleteSnapshotRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_snapshots::v1:: + DeleteSnapshotRequest const& request) { + return child_->AsyncDeleteSnapshot(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +StatusOr +RegionSnapshotsRestLogging::DeleteSnapshot( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_snapshots::v1:: + DeleteSnapshotRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_snapshots::v1:: + DeleteSnapshotRequest const& request) { + return child_->DeleteSnapshot(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +StatusOr +RegionSnapshotsRestLogging::GetSnapshot( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_snapshots::v1::GetSnapshotRequest const& + request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_snapshots::v1:: + GetSnapshotRequest const& request) { + return child_->GetSnapshot(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +StatusOr +RegionSnapshotsRestLogging::GetIamPolicy( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_snapshots::v1:: + GetIamPolicyRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_snapshots::v1:: + GetIamPolicyRequest const& request) { + return child_->GetIamPolicy(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +future> +RegionSnapshotsRestLogging::AsyncInsertSnapshot( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_snapshots::v1:: + InsertSnapshotRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_snapshots::v1:: + InsertSnapshotRequest const& request) { + return child_->AsyncInsertSnapshot(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +StatusOr +RegionSnapshotsRestLogging::InsertSnapshot( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_snapshots::v1:: + InsertSnapshotRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_snapshots::v1:: + InsertSnapshotRequest const& request) { + return child_->InsertSnapshot(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +StatusOr +RegionSnapshotsRestLogging::ListRegionSnapshots( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_snapshots::v1:: + ListRegionSnapshotsRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_snapshots::v1:: + ListRegionSnapshotsRequest const& request) { + return child_->ListRegionSnapshots(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +StatusOr +RegionSnapshotsRestLogging::SetIamPolicy( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_snapshots::v1:: + SetIamPolicyRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_snapshots::v1:: + SetIamPolicyRequest const& request) { + return child_->SetIamPolicy(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +future> +RegionSnapshotsRestLogging::AsyncSetLabels( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_snapshots::v1::SetLabelsRequest const& + request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_snapshots::v1:: + SetLabelsRequest const& request) { + return child_->AsyncSetLabels(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +StatusOr +RegionSnapshotsRestLogging::SetLabels( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_snapshots::v1::SetLabelsRequest const& + request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_snapshots::v1:: + SetLabelsRequest const& request) { + return child_->SetLabels(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +StatusOr +RegionSnapshotsRestLogging::TestIamPermissions( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_snapshots::v1:: + TestIamPermissionsRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_snapshots::v1:: + TestIamPermissionsRequest const& request) { + return child_->TestIamPermissions(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +future> +RegionSnapshotsRestLogging::AsyncUpdateKmsKey( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_snapshots::v1:: + UpdateKmsKeyRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_snapshots::v1:: + UpdateKmsKeyRequest const& request) { + return child_->AsyncUpdateKmsKey(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +StatusOr +RegionSnapshotsRestLogging::UpdateKmsKey( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_snapshots::v1:: + UpdateKmsKeyRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_snapshots::v1:: + UpdateKmsKeyRequest const& request) { + return child_->UpdateKmsKey(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +future> +RegionSnapshotsRestLogging::AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + return child_->AsyncGetOperation(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +future RegionSnapshotsRestLogging::AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + return child_->AsyncCancelOperation(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_snapshots_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_snapshots/v1/internal/region_snapshots_rest_logging_decorator.h b/google/cloud/compute/region_snapshots/v1/internal/region_snapshots_rest_logging_decorator.h new file mode 100644 index 0000000000000..1d2b67d3d5ed3 --- /dev/null +++ b/google/cloud/compute/region_snapshots/v1/internal/region_snapshots_rest_logging_decorator.h @@ -0,0 +1,156 @@ +// Copyright 2026 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. +// source: google/cloud/compute/region_snapshots/v1/region_snapshots.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOTS_V1_INTERNAL_REGION_SNAPSHOTS_REST_LOGGING_DECORATOR_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOTS_V1_INTERNAL_REGION_SNAPSHOTS_REST_LOGGING_DECORATOR_H + +#include "google/cloud/compute/region_operations/v1/region_operations.pb.h" +#include "google/cloud/compute/region_snapshots/v1/internal/region_snapshots_rest_stub.h" +#include "google/cloud/compute/region_snapshots/v1/region_snapshots.pb.h" +#include "google/cloud/future.h" +#include "google/cloud/internal/rest_context.h" +#include "google/cloud/tracing_options.h" +#include "google/cloud/version.h" +#include +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_snapshots_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class RegionSnapshotsRestLogging : public RegionSnapshotsRestStub { + public: + ~RegionSnapshotsRestLogging() override = default; + RegionSnapshotsRestLogging(std::shared_ptr child, + TracingOptions tracing_options, + std::set components); + + future> + AsyncDeleteSnapshot( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_snapshots::v1:: + DeleteSnapshotRequest const& request) override; + + StatusOr DeleteSnapshot( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_snapshots::v1:: + DeleteSnapshotRequest const& request) override; + + StatusOr GetSnapshot( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_snapshots::v1:: + GetSnapshotRequest const& request) override; + + StatusOr GetIamPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_snapshots::v1:: + GetIamPolicyRequest const& request) override; + + future> + AsyncInsertSnapshot( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_snapshots::v1:: + InsertSnapshotRequest const& request) override; + + StatusOr InsertSnapshot( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_snapshots::v1:: + InsertSnapshotRequest const& request) override; + + StatusOr ListRegionSnapshots( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_snapshots::v1:: + ListRegionSnapshotsRequest const& request) override; + + StatusOr SetIamPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_snapshots::v1:: + SetIamPolicyRequest const& request) override; + + future> AsyncSetLabels( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_snapshots::v1::SetLabelsRequest const& + request) override; + + StatusOr SetLabels( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_snapshots::v1::SetLabelsRequest const& + request) override; + + StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_snapshots::v1:: + TestIamPermissionsRequest const& request) override; + + future> + AsyncUpdateKmsKey( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_snapshots::v1:: + UpdateKmsKeyRequest const& request) override; + + StatusOr UpdateKmsKey( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_snapshots::v1:: + UpdateKmsKeyRequest const& request) override; + + future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) override; + + future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) override; + + private: + std::shared_ptr child_; + TracingOptions tracing_options_; + std::set components_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_snapshots_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOTS_V1_INTERNAL_REGION_SNAPSHOTS_REST_LOGGING_DECORATOR_H diff --git a/google/cloud/compute/region_snapshots/v1/internal/region_snapshots_rest_metadata_decorator.cc b/google/cloud/compute/region_snapshots/v1/internal/region_snapshots_rest_metadata_decorator.cc new file mode 100644 index 0000000000000..8a690e615b04e --- /dev/null +++ b/google/cloud/compute/region_snapshots/v1/internal/region_snapshots_rest_metadata_decorator.cc @@ -0,0 +1,204 @@ +// Copyright 2026 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. +// source: google/cloud/compute/region_snapshots/v1/region_snapshots.proto + +#include "google/cloud/compute/region_snapshots/v1/internal/region_snapshots_rest_metadata_decorator.h" +#include "google/cloud/internal/api_client_header.h" +#include "google/cloud/internal/rest_set_metadata.h" +#include "google/cloud/status_or.h" +#include "absl/strings/str_cat.h" +#include "absl/strings/str_format.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_snapshots_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +RegionSnapshotsRestMetadata::RegionSnapshotsRestMetadata( + std::shared_ptr child, + std::string api_client_header) + : child_(std::move(child)), + api_client_header_( + api_client_header.empty() + ? google::cloud::internal::GeneratedLibClientHeader() + : std::move(api_client_header)) {} + +future> +RegionSnapshotsRestMetadata::AsyncDeleteSnapshot( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_snapshots::v1:: + DeleteSnapshotRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncDeleteSnapshot(cq, std::move(rest_context), + std::move(options), request); +} + +StatusOr +RegionSnapshotsRestMetadata::DeleteSnapshot( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_snapshots::v1:: + DeleteSnapshotRequest const& request) { + SetMetadata(rest_context, options); + return child_->DeleteSnapshot(rest_context, options, request); +} + +StatusOr +RegionSnapshotsRestMetadata::GetSnapshot( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_snapshots::v1::GetSnapshotRequest const& + request) { + SetMetadata(rest_context, options); + return child_->GetSnapshot(rest_context, options, request); +} + +StatusOr +RegionSnapshotsRestMetadata::GetIamPolicy( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_snapshots::v1:: + GetIamPolicyRequest const& request) { + SetMetadata(rest_context, options); + return child_->GetIamPolicy(rest_context, options, request); +} + +future> +RegionSnapshotsRestMetadata::AsyncInsertSnapshot( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_snapshots::v1:: + InsertSnapshotRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncInsertSnapshot(cq, std::move(rest_context), + std::move(options), request); +} + +StatusOr +RegionSnapshotsRestMetadata::InsertSnapshot( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_snapshots::v1:: + InsertSnapshotRequest const& request) { + SetMetadata(rest_context, options); + return child_->InsertSnapshot(rest_context, options, request); +} + +StatusOr +RegionSnapshotsRestMetadata::ListRegionSnapshots( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_snapshots::v1:: + ListRegionSnapshotsRequest const& request) { + SetMetadata(rest_context, options); + return child_->ListRegionSnapshots(rest_context, options, request); +} + +StatusOr +RegionSnapshotsRestMetadata::SetIamPolicy( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_snapshots::v1:: + SetIamPolicyRequest const& request) { + SetMetadata(rest_context, options); + return child_->SetIamPolicy(rest_context, options, request); +} + +future> +RegionSnapshotsRestMetadata::AsyncSetLabels( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_snapshots::v1::SetLabelsRequest const& + request) { + SetMetadata(*rest_context, *options); + return child_->AsyncSetLabels(cq, std::move(rest_context), std::move(options), + request); +} + +StatusOr +RegionSnapshotsRestMetadata::SetLabels( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_snapshots::v1::SetLabelsRequest const& + request) { + SetMetadata(rest_context, options); + return child_->SetLabels(rest_context, options, request); +} + +StatusOr +RegionSnapshotsRestMetadata::TestIamPermissions( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_snapshots::v1:: + TestIamPermissionsRequest const& request) { + SetMetadata(rest_context, options); + return child_->TestIamPermissions(rest_context, options, request); +} + +future> +RegionSnapshotsRestMetadata::AsyncUpdateKmsKey( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_snapshots::v1:: + UpdateKmsKeyRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncUpdateKmsKey(cq, std::move(rest_context), + std::move(options), request); +} + +StatusOr +RegionSnapshotsRestMetadata::UpdateKmsKey( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::region_snapshots::v1:: + UpdateKmsKeyRequest const& request) { + SetMetadata(rest_context, options); + return child_->UpdateKmsKey(rest_context, options, request); +} + +future> +RegionSnapshotsRestMetadata::AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncGetOperation(cq, std::move(rest_context), + std::move(options), request); +} + +future RegionSnapshotsRestMetadata::AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncCancelOperation(cq, std::move(rest_context), + std::move(options), request); +} + +void RegionSnapshotsRestMetadata::SetMetadata( + rest_internal::RestContext& rest_context, Options const& options, + std::vector const& params) { + google::cloud::rest_internal::SetMetadata(rest_context, options, params, + api_client_header_); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_snapshots_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_snapshots/v1/internal/region_snapshots_rest_metadata_decorator.h b/google/cloud/compute/region_snapshots/v1/internal/region_snapshots_rest_metadata_decorator.h new file mode 100644 index 0000000000000..a7f2a03b0319d --- /dev/null +++ b/google/cloud/compute/region_snapshots/v1/internal/region_snapshots_rest_metadata_decorator.h @@ -0,0 +1,158 @@ +// Copyright 2026 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. +// source: google/cloud/compute/region_snapshots/v1/region_snapshots.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOTS_V1_INTERNAL_REGION_SNAPSHOTS_REST_METADATA_DECORATOR_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOTS_V1_INTERNAL_REGION_SNAPSHOTS_REST_METADATA_DECORATOR_H + +#include "google/cloud/compute/region_operations/v1/region_operations.pb.h" +#include "google/cloud/compute/region_snapshots/v1/internal/region_snapshots_rest_stub.h" +#include "google/cloud/compute/region_snapshots/v1/region_snapshots.pb.h" +#include "google/cloud/future.h" +#include "google/cloud/rest_options.h" +#include "google/cloud/version.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_snapshots_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class RegionSnapshotsRestMetadata : public RegionSnapshotsRestStub { + public: + ~RegionSnapshotsRestMetadata() override = default; + explicit RegionSnapshotsRestMetadata( + std::shared_ptr child, + std::string api_client_header = ""); + + google::cloud::future> + AsyncDeleteSnapshot( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_snapshots::v1:: + DeleteSnapshotRequest const& request) override; + + StatusOr DeleteSnapshot( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_snapshots::v1:: + DeleteSnapshotRequest const& request) override; + + StatusOr GetSnapshot( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_snapshots::v1:: + GetSnapshotRequest const& request) override; + + StatusOr GetIamPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_snapshots::v1:: + GetIamPolicyRequest const& request) override; + + google::cloud::future> + AsyncInsertSnapshot( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_snapshots::v1:: + InsertSnapshotRequest const& request) override; + + StatusOr InsertSnapshot( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_snapshots::v1:: + InsertSnapshotRequest const& request) override; + + StatusOr ListRegionSnapshots( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_snapshots::v1:: + ListRegionSnapshotsRequest const& request) override; + + StatusOr SetIamPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_snapshots::v1:: + SetIamPolicyRequest const& request) override; + + google::cloud::future> + AsyncSetLabels( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_snapshots::v1::SetLabelsRequest const& + request) override; + + StatusOr SetLabels( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_snapshots::v1::SetLabelsRequest const& + request) override; + + StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_snapshots::v1:: + TestIamPermissionsRequest const& request) override; + + google::cloud::future> + AsyncUpdateKmsKey( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_snapshots::v1:: + UpdateKmsKeyRequest const& request) override; + + StatusOr UpdateKmsKey( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_snapshots::v1:: + UpdateKmsKeyRequest const& request) override; + + google::cloud::future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) override; + + google::cloud::future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) override; + + private: + void SetMetadata(rest_internal::RestContext& rest_context, + Options const& options, + std::vector const& params = {}); + + std::shared_ptr child_; + std::string api_client_header_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_snapshots_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOTS_V1_INTERNAL_REGION_SNAPSHOTS_REST_METADATA_DECORATOR_H diff --git a/google/cloud/compute/region_snapshots/v1/internal/region_snapshots_rest_stub.cc b/google/cloud/compute/region_snapshots/v1/internal/region_snapshots_rest_stub.cc new file mode 100644 index 0000000000000..a647cd53146e3 --- /dev/null +++ b/google/cloud/compute/region_snapshots/v1/internal/region_snapshots_rest_stub.cc @@ -0,0 +1,444 @@ +// Copyright 2026 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. +// source: google/cloud/compute/region_snapshots/v1/region_snapshots.proto + +#include "google/cloud/compute/region_snapshots/v1/internal/region_snapshots_rest_stub.h" +#include "google/cloud/compute/region_operations/v1/region_operations.pb.h" +#include "google/cloud/compute/region_snapshots/v1/region_snapshots.pb.h" +#include "google/cloud/common_options.h" +#include "google/cloud/internal/rest_stub_helpers.h" +#include "google/cloud/status_or.h" +#include "absl/strings/str_cat.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_snapshots_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +DefaultRegionSnapshotsRestStub::DefaultRegionSnapshotsRestStub(Options options) + : service_(rest_internal::MakePooledRestClient( + options.get(), options)), + operations_(rest_internal::MakePooledRestClient( + options.get(), options)), + options_(std::move(options)) {} + +DefaultRegionSnapshotsRestStub::DefaultRegionSnapshotsRestStub( + std::shared_ptr service, + std::shared_ptr operations, Options options) + : service_(std::move(service)), + operations_(std::move(operations)), + options_(std::move(options)) {} + +future> +DefaultRegionSnapshotsRestStub::AsyncDeleteSnapshot( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_snapshots::v1:: + DeleteSnapshotRequest const& request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto service, auto request, auto rest_context, auto options) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + p.set_value( + rest_internal::Delete( + *service, *rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", *options), + "/", "projects", "/", request.project(), "/", + "regions", "/", request.region(), "/", "snapshots", + "/", request.snapshot()), + std::move(query_params))); + }, + std::move(p), + service_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +StatusOr +DefaultRegionSnapshotsRestStub::DeleteSnapshot( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_snapshots::v1:: + DeleteSnapshotRequest const& request) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Delete( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "regions", "/", + request.region(), "/", "snapshots", "/", request.snapshot()), + std::move(query_params)); +} + +StatusOr +DefaultRegionSnapshotsRestStub::GetSnapshot( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_snapshots::v1::GetSnapshotRequest const& + request) { + std::vector> query_params; + return rest_internal::Get( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "regions", "/", + request.region(), "/", "snapshots", "/", request.snapshot()), + std::move(query_params)); +} + +StatusOr +DefaultRegionSnapshotsRestStub::GetIamPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_snapshots::v1:: + GetIamPolicyRequest const& request) { + std::vector> query_params; + query_params.push_back( + {"options_requested_policy_version", + std::to_string(request.options_requested_policy_version())}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Get( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "regions", "/", + request.region(), "/", "snapshots", "/", request.resource(), + "/", "getIamPolicy"), + std::move(query_params)); +} + +future> +DefaultRegionSnapshotsRestStub::AsyncInsertSnapshot( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_snapshots::v1:: + InsertSnapshotRequest const& request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto service, auto request, auto rest_context, auto options) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + p.set_value( + rest_internal::Post( + *service, *rest_context, request.snapshot_resource(), false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", *options), + "/", "projects", "/", request.project(), "/", + "regions", "/", request.region(), "/", + "snapshots"), + std::move(query_params))); + }, + std::move(p), + service_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +StatusOr +DefaultRegionSnapshotsRestStub::InsertSnapshot( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_snapshots::v1:: + InsertSnapshotRequest const& request) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Post( + *service_, rest_context, request.snapshot_resource(), false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "regions", "/", + request.region(), "/", "snapshots"), + std::move(query_params)); +} + +StatusOr +DefaultRegionSnapshotsRestStub::ListRegionSnapshots( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_snapshots::v1:: + ListRegionSnapshotsRequest const& request) { + std::vector> query_params; + query_params.push_back({"filter", request.filter()}); + query_params.push_back( + {"max_results", std::to_string(request.max_results())}); + query_params.push_back({"order_by", request.order_by()}); + query_params.push_back({"page_token", request.page_token()}); + query_params.push_back({"return_partial_success", + (request.return_partial_success() ? "1" : "0")}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Get( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "regions", "/", + request.region(), "/", "snapshots"), + std::move(query_params)); +} + +StatusOr +DefaultRegionSnapshotsRestStub::SetIamPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_snapshots::v1:: + SetIamPolicyRequest const& request) { + std::vector> query_params; + return rest_internal::Post( + *service_, rest_context, request.region_set_policy_request_resource(), + false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "regions", "/", + request.region(), "/", "snapshots", "/", request.resource(), + "/", "setIamPolicy"), + std::move(query_params)); +} + +future> +DefaultRegionSnapshotsRestStub::AsyncSetLabels( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_snapshots::v1::SetLabelsRequest const& + request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto service, auto request, auto rest_context, auto options) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + p.set_value( + rest_internal::Post( + *service, *rest_context, + request.region_set_labels_request_resource(), false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", *options), + "/", "projects", "/", request.project(), "/", + "regions", "/", request.region(), "/", "snapshots", + "/", request.resource(), "/", "setLabels"), + std::move(query_params))); + }, + std::move(p), + service_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +StatusOr +DefaultRegionSnapshotsRestStub::SetLabels( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_snapshots::v1::SetLabelsRequest const& + request) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Post( + *service_, rest_context, request.region_set_labels_request_resource(), + false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "regions", "/", + request.region(), "/", "snapshots", "/", request.resource(), + "/", "setLabels"), + std::move(query_params)); +} + +StatusOr +DefaultRegionSnapshotsRestStub::TestIamPermissions( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_snapshots::v1:: + TestIamPermissionsRequest const& request) { + std::vector> query_params; + return rest_internal::Post< + google::cloud::cpp::compute::v1::TestPermissionsResponse>( + *service_, rest_context, request.test_permissions_request_resource(), + false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "regions", "/", + request.region(), "/", "snapshots", "/", request.resource(), + "/", "testIamPermissions"), + std::move(query_params)); +} + +future> +DefaultRegionSnapshotsRestStub::AsyncUpdateKmsKey( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_snapshots::v1:: + UpdateKmsKeyRequest const& request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto service, auto request, auto rest_context, auto options) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + p.set_value( + rest_internal::Post( + *service, *rest_context, + request.region_snapshot_update_kms_key_request_resource(), + false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", *options), + "/", "projects", "/", request.project(), "/", + "regions", "/", request.region(), "/", "snapshots", + "/", request.snapshot(), "/", "updateKmsKey"), + std::move(query_params))); + }, + std::move(p), + service_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +StatusOr +DefaultRegionSnapshotsRestStub::UpdateKmsKey( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_snapshots::v1:: + UpdateKmsKeyRequest const& request) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Post( + *service_, rest_context, + request.region_snapshot_update_kms_key_request_resource(), false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "regions", "/", + request.region(), "/", "snapshots", "/", request.snapshot(), + "/", "updateKmsKey"), + std::move(query_params)); +} + +future> +DefaultRegionSnapshotsRestStub::AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto operations, auto request, auto rest_context, + auto options) { + p.set_value( + rest_internal::Get( + *operations, *rest_context, request, false, + absl::StrCat("/compute/", + rest_internal::DetermineApiVersion("v1", *options), + "/projects/", request.project(), "/regions/", + request.region(), "/operations/", + request.operation()))); + }, + std::move(p), + operations_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +future DefaultRegionSnapshotsRestStub::AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + promise> p; + future> f = p.get_future(); + std::thread t{ + [](auto p, auto operations, auto request, auto rest_context, + auto options) { + p.set_value(rest_internal::Post( + *operations, *rest_context, request, false, + absl::StrCat( + "/compute/", rest_internal::DetermineApiVersion("v1", *options), + "/projects/", request.project(), "/regions/", request.region(), + "/operations/", request.operation()))); + }, + std::move(p), + operations_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get().status(); + }); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_snapshots_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_snapshots/v1/internal/region_snapshots_rest_stub.h b/google/cloud/compute/region_snapshots/v1/internal/region_snapshots_rest_stub.h new file mode 100644 index 0000000000000..a5eb504042dac --- /dev/null +++ b/google/cloud/compute/region_snapshots/v1/internal/region_snapshots_rest_stub.h @@ -0,0 +1,262 @@ +// Copyright 2026 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. +// source: google/cloud/compute/region_snapshots/v1/region_snapshots.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOTS_V1_INTERNAL_REGION_SNAPSHOTS_REST_STUB_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOTS_V1_INTERNAL_REGION_SNAPSHOTS_REST_STUB_H + +#include "google/cloud/compute/region_operations/v1/region_operations.pb.h" +#include "google/cloud/compute/region_snapshots/v1/region_snapshots.pb.h" +#include "google/cloud/completion_queue.h" +#include "google/cloud/internal/rest_client.h" +#include "google/cloud/internal/rest_context.h" +#include "google/cloud/status_or.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_snapshots_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class RegionSnapshotsRestStub { + public: + virtual ~RegionSnapshotsRestStub() = default; + + virtual future> + AsyncDeleteSnapshot( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_snapshots::v1:: + DeleteSnapshotRequest const& request) = 0; + + virtual StatusOr DeleteSnapshot( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_snapshots::v1:: + DeleteSnapshotRequest const& request) = 0; + + virtual StatusOr GetSnapshot( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_snapshots::v1:: + GetSnapshotRequest const& request) = 0; + + virtual StatusOr GetIamPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_snapshots::v1:: + GetIamPolicyRequest const& request) = 0; + + virtual future> + AsyncInsertSnapshot( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_snapshots::v1:: + InsertSnapshotRequest const& request) = 0; + + virtual StatusOr InsertSnapshot( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_snapshots::v1:: + InsertSnapshotRequest const& request) = 0; + + virtual StatusOr + ListRegionSnapshots(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_snapshots::v1:: + ListRegionSnapshotsRequest const& request) = 0; + + virtual StatusOr SetIamPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_snapshots::v1:: + SetIamPolicyRequest const& request) = 0; + + virtual future> + AsyncSetLabels( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_snapshots::v1::SetLabelsRequest const& + request) = 0; + + virtual StatusOr SetLabels( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_snapshots::v1::SetLabelsRequest const& + request) = 0; + + virtual StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_snapshots::v1:: + TestIamPermissionsRequest const& request) = 0; + + virtual future> + AsyncUpdateKmsKey( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_snapshots::v1:: + UpdateKmsKeyRequest const& request) = 0; + + virtual StatusOr UpdateKmsKey( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_snapshots::v1:: + UpdateKmsKeyRequest const& request) = 0; + + virtual future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) = 0; + + virtual future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) = 0; +}; + +class DefaultRegionSnapshotsRestStub : public RegionSnapshotsRestStub { + public: + ~DefaultRegionSnapshotsRestStub() override = default; + + explicit DefaultRegionSnapshotsRestStub(Options options); + DefaultRegionSnapshotsRestStub( + std::shared_ptr service, + std::shared_ptr operations, Options options); + + future> + AsyncDeleteSnapshot( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_snapshots::v1:: + DeleteSnapshotRequest const& request) override; + + StatusOr DeleteSnapshot( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_snapshots::v1:: + DeleteSnapshotRequest const& request) override; + + StatusOr GetSnapshot( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_snapshots::v1:: + GetSnapshotRequest const& request) override; + + StatusOr GetIamPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_snapshots::v1:: + GetIamPolicyRequest const& request) override; + + future> + AsyncInsertSnapshot( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_snapshots::v1:: + InsertSnapshotRequest const& request) override; + + StatusOr InsertSnapshot( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_snapshots::v1:: + InsertSnapshotRequest const& request) override; + + StatusOr ListRegionSnapshots( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_snapshots::v1:: + ListRegionSnapshotsRequest const& request) override; + + StatusOr SetIamPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_snapshots::v1:: + SetIamPolicyRequest const& request) override; + + future> AsyncSetLabels( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_snapshots::v1::SetLabelsRequest const& + request) override; + + StatusOr SetLabels( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_snapshots::v1::SetLabelsRequest const& + request) override; + + StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_snapshots::v1:: + TestIamPermissionsRequest const& request) override; + + future> + AsyncUpdateKmsKey( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_snapshots::v1:: + UpdateKmsKeyRequest const& request) override; + + StatusOr UpdateKmsKey( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::region_snapshots::v1:: + UpdateKmsKeyRequest const& request) override; + + future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) override; + + future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) override; + + private: + std::shared_ptr service_; + std::shared_ptr operations_; + Options options_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_snapshots_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOTS_V1_INTERNAL_REGION_SNAPSHOTS_REST_STUB_H diff --git a/google/cloud/compute/region_snapshots/v1/internal/region_snapshots_rest_stub_factory.cc b/google/cloud/compute/region_snapshots/v1/internal/region_snapshots_rest_stub_factory.cc new file mode 100644 index 0000000000000..b42afd4763f1e --- /dev/null +++ b/google/cloud/compute/region_snapshots/v1/internal/region_snapshots_rest_stub_factory.cc @@ -0,0 +1,56 @@ +// Copyright 2026 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. +// source: google/cloud/compute/region_snapshots/v1/region_snapshots.proto + +#include "google/cloud/compute/region_snapshots/v1/internal/region_snapshots_rest_stub_factory.h" +#include "google/cloud/compute/region_snapshots/v1/internal/region_snapshots_rest_logging_decorator.h" +#include "google/cloud/compute/region_snapshots/v1/internal/region_snapshots_rest_metadata_decorator.h" +#include "google/cloud/compute/region_snapshots/v1/internal/region_snapshots_rest_stub.h" +#include "google/cloud/common_options.h" +#include "google/cloud/internal/algorithm.h" +#include "google/cloud/internal/populate_rest_options.h" +#include "google/cloud/log.h" +#include "google/cloud/options.h" +#include "google/cloud/rest_options.h" +#include "absl/strings/match.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_snapshots_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +std::shared_ptr CreateDefaultRegionSnapshotsRestStub( + Options const& options) { + auto opts = internal::PopulateRestOptions(options); + std::shared_ptr stub = + std::make_shared(std::move(opts)); + stub = std::make_shared(std::move(stub)); + if (internal::Contains(options.get(), "rpc")) { + GCP_LOG(INFO) << "Enabled logging for REST rpc calls"; + stub = std::make_shared( + std::move(stub), options.get(), + options.get()); + } + return stub; +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_snapshots_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_snapshots/v1/internal/region_snapshots_rest_stub_factory.h b/google/cloud/compute/region_snapshots/v1/internal/region_snapshots_rest_stub_factory.h new file mode 100644 index 0000000000000..14f1180e3a0ea --- /dev/null +++ b/google/cloud/compute/region_snapshots/v1/internal/region_snapshots_rest_stub_factory.h @@ -0,0 +1,40 @@ +// Copyright 2026 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. +// source: google/cloud/compute/region_snapshots/v1/region_snapshots.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOTS_V1_INTERNAL_REGION_SNAPSHOTS_REST_STUB_FACTORY_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOTS_V1_INTERNAL_REGION_SNAPSHOTS_REST_STUB_FACTORY_H + +#include "google/cloud/compute/region_snapshots/v1/internal/region_snapshots_rest_stub.h" +#include "google/cloud/options.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_snapshots_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +std::shared_ptr CreateDefaultRegionSnapshotsRestStub( + Options const& options); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_snapshots_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOTS_V1_INTERNAL_REGION_SNAPSHOTS_REST_STUB_FACTORY_H diff --git a/google/cloud/compute/region_snapshots/v1/internal/region_snapshots_retry_traits.h b/google/cloud/compute/region_snapshots/v1/internal/region_snapshots_retry_traits.h new file mode 100644 index 0000000000000..9e935a83367b7 --- /dev/null +++ b/google/cloud/compute/region_snapshots/v1/internal/region_snapshots_retry_traits.h @@ -0,0 +1,43 @@ +// Copyright 2026 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. +// source: google/cloud/compute/region_snapshots/v1/region_snapshots.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOTS_V1_INTERNAL_REGION_SNAPSHOTS_RETRY_TRAITS_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOTS_V1_INTERNAL_REGION_SNAPSHOTS_RETRY_TRAITS_H + +#include "google/cloud/status.h" +#include "google/cloud/version.h" + +namespace google { +namespace cloud { +namespace compute_region_snapshots_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/// Define the gRPC status code semantics for retrying requests. +struct RegionSnapshotsRetryTraits { + static bool IsPermanentFailure(google::cloud::Status const& status) { + return status.code() != StatusCode::kOk && + status.code() != StatusCode::kUnavailable; + } +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_snapshots_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOTS_V1_INTERNAL_REGION_SNAPSHOTS_RETRY_TRAITS_H diff --git a/google/cloud/compute/region_snapshots/v1/internal/region_snapshots_sources.cc b/google/cloud/compute/region_snapshots/v1/internal/region_snapshots_sources.cc new file mode 100644 index 0000000000000..7a5e22f829c4c --- /dev/null +++ b/google/cloud/compute/region_snapshots/v1/internal/region_snapshots_sources.cc @@ -0,0 +1,31 @@ +// Copyright 2026 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. +// source: google/cloud/compute/region_snapshots/v1/region_snapshots.proto + +// NOLINTBEGIN(bugprone-suspicious-include) +#include "google/cloud/compute/region_snapshots/v1/internal/region_snapshots_option_defaults.cc" +#include "google/cloud/compute/region_snapshots/v1/internal/region_snapshots_rest_connection_impl.cc" +#include "google/cloud/compute/region_snapshots/v1/internal/region_snapshots_rest_logging_decorator.cc" +#include "google/cloud/compute/region_snapshots/v1/internal/region_snapshots_rest_metadata_decorator.cc" +#include "google/cloud/compute/region_snapshots/v1/internal/region_snapshots_rest_stub.cc" +#include "google/cloud/compute/region_snapshots/v1/internal/region_snapshots_rest_stub_factory.cc" +#include "google/cloud/compute/region_snapshots/v1/internal/region_snapshots_tracing_connection.cc" +#include "google/cloud/compute/region_snapshots/v1/region_snapshots_client.cc" +#include "google/cloud/compute/region_snapshots/v1/region_snapshots_connection.cc" +#include "google/cloud/compute/region_snapshots/v1/region_snapshots_connection_idempotency_policy.cc" +#include "google/cloud/compute/region_snapshots/v1/region_snapshots_rest_connection.cc" +// NOLINTEND(bugprone-suspicious-include) diff --git a/google/cloud/compute/region_snapshots/v1/internal/region_snapshots_tracing_connection.cc b/google/cloud/compute/region_snapshots/v1/internal/region_snapshots_tracing_connection.cc new file mode 100644 index 0000000000000..e3830dc9e0731 --- /dev/null +++ b/google/cloud/compute/region_snapshots/v1/internal/region_snapshots_tracing_connection.cc @@ -0,0 +1,222 @@ +// Copyright 2026 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. +// source: google/cloud/compute/region_snapshots/v1/region_snapshots.proto + +#include "google/cloud/compute/region_snapshots/v1/internal/region_snapshots_tracing_connection.h" +#include "google/cloud/internal/opentelemetry.h" +#include "google/cloud/internal/traced_stream_range.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_snapshots_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +RegionSnapshotsTracingConnection::RegionSnapshotsTracingConnection( + std::shared_ptr + child) + : child_(std::move(child)) {} + +future> +RegionSnapshotsTracingConnection::DeleteSnapshot( + google::cloud::cpp::compute::region_snapshots::v1:: + DeleteSnapshotRequest const& request) { + auto span = internal::MakeSpan( + "compute_region_snapshots_v1::RegionSnapshotsConnection::DeleteSnapshot"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), child_->DeleteSnapshot(request)); +} + +StatusOr +RegionSnapshotsTracingConnection::DeleteSnapshot( + NoAwaitTag, google::cloud::cpp::compute::region_snapshots::v1:: + DeleteSnapshotRequest const& request) { + auto span = internal::MakeSpan( + "compute_region_snapshots_v1::RegionSnapshotsConnection::DeleteSnapshot"); + opentelemetry::trace::Scope scope(span); + return internal::EndSpan(*span, + child_->DeleteSnapshot(NoAwaitTag{}, request)); +} + +future> +RegionSnapshotsTracingConnection::DeleteSnapshot( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto span = internal::MakeSpan( + "compute_region_snapshots_v1::RegionSnapshotsConnection::DeleteSnapshot"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), child_->DeleteSnapshot(operation)); +} + +StatusOr +RegionSnapshotsTracingConnection::GetSnapshot( + google::cloud::cpp::compute::region_snapshots::v1::GetSnapshotRequest const& + request) { + auto span = internal::MakeSpan( + "compute_region_snapshots_v1::RegionSnapshotsConnection::GetSnapshot"); + auto scope = opentelemetry::trace::Scope(span); + return internal::EndSpan(*span, child_->GetSnapshot(request)); +} + +StatusOr +RegionSnapshotsTracingConnection::GetIamPolicy( + google::cloud::cpp::compute::region_snapshots::v1:: + GetIamPolicyRequest const& request) { + auto span = internal::MakeSpan( + "compute_region_snapshots_v1::RegionSnapshotsConnection::GetIamPolicy"); + auto scope = opentelemetry::trace::Scope(span); + return internal::EndSpan(*span, child_->GetIamPolicy(request)); +} + +future> +RegionSnapshotsTracingConnection::InsertSnapshot( + google::cloud::cpp::compute::region_snapshots::v1:: + InsertSnapshotRequest const& request) { + auto span = internal::MakeSpan( + "compute_region_snapshots_v1::RegionSnapshotsConnection::InsertSnapshot"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), child_->InsertSnapshot(request)); +} + +StatusOr +RegionSnapshotsTracingConnection::InsertSnapshot( + NoAwaitTag, google::cloud::cpp::compute::region_snapshots::v1:: + InsertSnapshotRequest const& request) { + auto span = internal::MakeSpan( + "compute_region_snapshots_v1::RegionSnapshotsConnection::InsertSnapshot"); + opentelemetry::trace::Scope scope(span); + return internal::EndSpan(*span, + child_->InsertSnapshot(NoAwaitTag{}, request)); +} + +future> +RegionSnapshotsTracingConnection::InsertSnapshot( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto span = internal::MakeSpan( + "compute_region_snapshots_v1::RegionSnapshotsConnection::InsertSnapshot"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), child_->InsertSnapshot(operation)); +} + +StreamRange +RegionSnapshotsTracingConnection::ListRegionSnapshots( + google::cloud::cpp::compute::region_snapshots::v1:: + ListRegionSnapshotsRequest request) { + auto span = internal::MakeSpan( + "compute_region_snapshots_v1::RegionSnapshotsConnection::" + "ListRegionSnapshots"); + internal::OTelScope scope(span); + auto sr = child_->ListRegionSnapshots(std::move(request)); + return internal::MakeTracedStreamRange< + google::cloud::cpp::compute::v1::Snapshot>(std::move(span), + std::move(sr)); +} + +StatusOr +RegionSnapshotsTracingConnection::SetIamPolicy( + google::cloud::cpp::compute::region_snapshots::v1:: + SetIamPolicyRequest const& request) { + auto span = internal::MakeSpan( + "compute_region_snapshots_v1::RegionSnapshotsConnection::SetIamPolicy"); + auto scope = opentelemetry::trace::Scope(span); + return internal::EndSpan(*span, child_->SetIamPolicy(request)); +} + +future> +RegionSnapshotsTracingConnection::SetLabels( + google::cloud::cpp::compute::region_snapshots::v1::SetLabelsRequest const& + request) { + auto span = internal::MakeSpan( + "compute_region_snapshots_v1::RegionSnapshotsConnection::SetLabels"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), child_->SetLabels(request)); +} + +StatusOr +RegionSnapshotsTracingConnection::SetLabels( + NoAwaitTag, + google::cloud::cpp::compute::region_snapshots::v1::SetLabelsRequest const& + request) { + auto span = internal::MakeSpan( + "compute_region_snapshots_v1::RegionSnapshotsConnection::SetLabels"); + opentelemetry::trace::Scope scope(span); + return internal::EndSpan(*span, child_->SetLabels(NoAwaitTag{}, request)); +} + +future> +RegionSnapshotsTracingConnection::SetLabels( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto span = internal::MakeSpan( + "compute_region_snapshots_v1::RegionSnapshotsConnection::SetLabels"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), child_->SetLabels(operation)); +} + +StatusOr +RegionSnapshotsTracingConnection::TestIamPermissions( + google::cloud::cpp::compute::region_snapshots::v1:: + TestIamPermissionsRequest const& request) { + auto span = internal::MakeSpan( + "compute_region_snapshots_v1::RegionSnapshotsConnection::" + "TestIamPermissions"); + auto scope = opentelemetry::trace::Scope(span); + return internal::EndSpan(*span, child_->TestIamPermissions(request)); +} + +future> +RegionSnapshotsTracingConnection::UpdateKmsKey( + google::cloud::cpp::compute::region_snapshots::v1:: + UpdateKmsKeyRequest const& request) { + auto span = internal::MakeSpan( + "compute_region_snapshots_v1::RegionSnapshotsConnection::UpdateKmsKey"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), child_->UpdateKmsKey(request)); +} + +StatusOr +RegionSnapshotsTracingConnection::UpdateKmsKey( + NoAwaitTag, google::cloud::cpp::compute::region_snapshots::v1:: + UpdateKmsKeyRequest const& request) { + auto span = internal::MakeSpan( + "compute_region_snapshots_v1::RegionSnapshotsConnection::UpdateKmsKey"); + opentelemetry::trace::Scope scope(span); + return internal::EndSpan(*span, child_->UpdateKmsKey(NoAwaitTag{}, request)); +} + +future> +RegionSnapshotsTracingConnection::UpdateKmsKey( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto span = internal::MakeSpan( + "compute_region_snapshots_v1::RegionSnapshotsConnection::UpdateKmsKey"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), child_->UpdateKmsKey(operation)); +} + +std::shared_ptr +MakeRegionSnapshotsTracingConnection( + std::shared_ptr + conn) { + if (internal::TracingEnabled(conn->options())) { + conn = std::make_shared(std::move(conn)); + } + return conn; +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_snapshots_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_snapshots/v1/internal/region_snapshots_tracing_connection.h b/google/cloud/compute/region_snapshots/v1/internal/region_snapshots_tracing_connection.h new file mode 100644 index 0000000000000..5872313b00d91 --- /dev/null +++ b/google/cloud/compute/region_snapshots/v1/internal/region_snapshots_tracing_connection.h @@ -0,0 +1,128 @@ +// Copyright 2026 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. +// source: google/cloud/compute/region_snapshots/v1/region_snapshots.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOTS_V1_INTERNAL_REGION_SNAPSHOTS_TRACING_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOTS_V1_INTERNAL_REGION_SNAPSHOTS_TRACING_CONNECTION_H + +#include "google/cloud/compute/region_snapshots/v1/region_snapshots_connection.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_snapshots_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class RegionSnapshotsTracingConnection + : public compute_region_snapshots_v1::RegionSnapshotsConnection { + public: + ~RegionSnapshotsTracingConnection() override = default; + + explicit RegionSnapshotsTracingConnection( + std::shared_ptr + child); + + Options options() override { return child_->options(); } + + future> DeleteSnapshot( + google::cloud::cpp::compute::region_snapshots::v1:: + DeleteSnapshotRequest const& request) override; + + StatusOr DeleteSnapshot( + NoAwaitTag, google::cloud::cpp::compute::region_snapshots::v1:: + DeleteSnapshotRequest const& request) override; + + future> DeleteSnapshot( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + StatusOr GetSnapshot( + google::cloud::cpp::compute::region_snapshots::v1:: + GetSnapshotRequest const& request) override; + + StatusOr GetIamPolicy( + google::cloud::cpp::compute::region_snapshots::v1:: + GetIamPolicyRequest const& request) override; + + future> InsertSnapshot( + google::cloud::cpp::compute::region_snapshots::v1:: + InsertSnapshotRequest const& request) override; + + StatusOr InsertSnapshot( + NoAwaitTag, google::cloud::cpp::compute::region_snapshots::v1:: + InsertSnapshotRequest const& request) override; + + future> InsertSnapshot( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + StreamRange ListRegionSnapshots( + google::cloud::cpp::compute::region_snapshots::v1:: + ListRegionSnapshotsRequest request) override; + + StatusOr SetIamPolicy( + google::cloud::cpp::compute::region_snapshots::v1:: + SetIamPolicyRequest const& request) override; + + future> SetLabels( + google::cloud::cpp::compute::region_snapshots::v1::SetLabelsRequest const& + request) override; + + StatusOr SetLabels( + NoAwaitTag, + google::cloud::cpp::compute::region_snapshots::v1::SetLabelsRequest const& + request) override; + + future> SetLabels( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + StatusOr + TestIamPermissions(google::cloud::cpp::compute::region_snapshots::v1:: + TestIamPermissionsRequest const& request) override; + + future> UpdateKmsKey( + google::cloud::cpp::compute::region_snapshots::v1:: + UpdateKmsKeyRequest const& request) override; + + StatusOr UpdateKmsKey( + NoAwaitTag, google::cloud::cpp::compute::region_snapshots::v1:: + UpdateKmsKeyRequest const& request) override; + + future> UpdateKmsKey( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + private: + std::shared_ptr + child_; +}; + +/** + * Conditionally applies the tracing decorator to the given connection. + * + * The connection is only decorated if tracing is enabled (as determined by the + * connection's options). + */ +std::shared_ptr +MakeRegionSnapshotsTracingConnection( + std::shared_ptr + conn); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_snapshots_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOTS_V1_INTERNAL_REGION_SNAPSHOTS_TRACING_CONNECTION_H diff --git a/google/cloud/compute/region_snapshots/v1/mocks/mock_region_snapshots_connection.h b/google/cloud/compute/region_snapshots/v1/mocks/mock_region_snapshots_connection.h new file mode 100644 index 0000000000000..8f4d309fee9a1 --- /dev/null +++ b/google/cloud/compute/region_snapshots/v1/mocks/mock_region_snapshots_connection.h @@ -0,0 +1,246 @@ +// Copyright 2026 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. +// source: google/cloud/compute/region_snapshots/v1/region_snapshots.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOTS_V1_MOCKS_MOCK_REGION_SNAPSHOTS_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOTS_V1_MOCKS_MOCK_REGION_SNAPSHOTS_CONNECTION_H + +#include "google/cloud/compute/region_snapshots/v1/region_snapshots_connection.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_snapshots_v1_mocks { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/** + * A class to mock `RegionSnapshotsConnection`. + * + * Application developers may want to test their code with simulated responses, + * including errors, from an object of type `RegionSnapshotsClient`. To do so, + * construct an object of type `RegionSnapshotsClient` with an instance of this + * class. Then use the Google Test framework functions to program the behavior + * of this mock. + * + * @see [This example][bq-mock] for how to test your application with GoogleTest. + * While the example showcases types from the BigQuery library, the underlying + * principles apply for any pair of `*Client` and `*Connection`. + * + * [bq-mock]: @cloud_cpp_docs_link{bigquery,bigquery-read-mock} + */ +class MockRegionSnapshotsConnection + : public compute_region_snapshots_v1::RegionSnapshotsConnection { + public: + MOCK_METHOD(Options, options, (), (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// DeleteSnapshot(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + DeleteSnapshot, + (google::cloud::cpp::compute::region_snapshots::v1:: + DeleteSnapshotRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// EXPECT_CALL(*mock, DeleteSnapshot(_, _)) + /// @endcode + MOCK_METHOD(StatusOr, + DeleteSnapshot, + (NoAwaitTag, google::cloud::cpp::compute::region_snapshots::v1:: + DeleteSnapshotRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// DeleteSnapshot(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + DeleteSnapshot, + (google::cloud::cpp::compute::v1::Operation const& operation), + (override)); + + MOCK_METHOD(StatusOr, GetSnapshot, + (google::cloud::cpp::compute::region_snapshots::v1:: + GetSnapshotRequest const& request), + (override)); + + MOCK_METHOD(StatusOr, GetIamPolicy, + (google::cloud::cpp::compute::region_snapshots::v1:: + GetIamPolicyRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// InsertSnapshot(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + InsertSnapshot, + (google::cloud::cpp::compute::region_snapshots::v1:: + InsertSnapshotRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// EXPECT_CALL(*mock, InsertSnapshot(_, _)) + /// @endcode + MOCK_METHOD(StatusOr, + InsertSnapshot, + (NoAwaitTag, google::cloud::cpp::compute::region_snapshots::v1:: + InsertSnapshotRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// InsertSnapshot(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + InsertSnapshot, + (google::cloud::cpp::compute::v1::Operation const& operation), + (override)); + + MOCK_METHOD((StreamRange), + ListRegionSnapshots, + (google::cloud::cpp::compute::region_snapshots::v1:: + ListRegionSnapshotsRequest request), + (override)); + + MOCK_METHOD(StatusOr, SetIamPolicy, + (google::cloud::cpp::compute::region_snapshots::v1:: + SetIamPolicyRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// SetLabels(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + SetLabels, + (google::cloud::cpp::compute::region_snapshots::v1:: + SetLabelsRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// EXPECT_CALL(*mock, SetLabels(_, _)) + /// @endcode + MOCK_METHOD(StatusOr, SetLabels, + (NoAwaitTag, google::cloud::cpp::compute::region_snapshots::v1:: + SetLabelsRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// SetLabels(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + SetLabels, + (google::cloud::cpp::compute::v1::Operation const& operation), + (override)); + + MOCK_METHOD( + StatusOr, + TestIamPermissions, + (google::cloud::cpp::compute::region_snapshots::v1:: + TestIamPermissionsRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// UpdateKmsKey(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + UpdateKmsKey, + (google::cloud::cpp::compute::region_snapshots::v1:: + UpdateKmsKeyRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// EXPECT_CALL(*mock, UpdateKmsKey(_, _)) + /// @endcode + MOCK_METHOD(StatusOr, + UpdateKmsKey, + (NoAwaitTag, google::cloud::cpp::compute::region_snapshots::v1:: + UpdateKmsKeyRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// UpdateKmsKey(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + UpdateKmsKey, + (google::cloud::cpp::compute::v1::Operation const& operation), + (override)); +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_snapshots_v1_mocks +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOTS_V1_MOCKS_MOCK_REGION_SNAPSHOTS_CONNECTION_H diff --git a/google/cloud/compute/region_snapshots/v1/region_snapshots_client.cc b/google/cloud/compute/region_snapshots/v1/region_snapshots_client.cc new file mode 100644 index 0000000000000..e46abceab9ee0 --- /dev/null +++ b/google/cloud/compute/region_snapshots/v1/region_snapshots_client.cc @@ -0,0 +1,386 @@ +// Copyright 2026 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. +// source: google/cloud/compute/region_snapshots/v1/region_snapshots.proto + +#include "google/cloud/compute/region_snapshots/v1/region_snapshots_client.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_snapshots_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +RegionSnapshotsClient::RegionSnapshotsClient( + std::shared_ptr connection, Options opts) + : connection_(std::move(connection)), + options_( + internal::MergeOptions(std::move(opts), connection_->options())) {} +RegionSnapshotsClient::~RegionSnapshotsClient() = default; + +future> +RegionSnapshotsClient::DeleteSnapshot(std::string const& project, + std::string const& region, + std::string const& snapshot, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_snapshots::v1::DeleteSnapshotRequest + request; + request.set_project(project); + request.set_region(region); + request.set_snapshot(snapshot); + return connection_->DeleteSnapshot(request); +} + +StatusOr +RegionSnapshotsClient::DeleteSnapshot(NoAwaitTag, std::string const& project, + std::string const& region, + std::string const& snapshot, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_snapshots::v1::DeleteSnapshotRequest + request; + request.set_project(project); + request.set_region(region); + request.set_snapshot(snapshot); + return connection_->DeleteSnapshot(NoAwaitTag{}, request); +} + +future> +RegionSnapshotsClient::DeleteSnapshot( + google::cloud::cpp::compute::region_snapshots::v1:: + DeleteSnapshotRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->DeleteSnapshot(request); +} + +StatusOr +RegionSnapshotsClient::DeleteSnapshot( + NoAwaitTag, + google::cloud::cpp::compute::region_snapshots::v1:: + DeleteSnapshotRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->DeleteSnapshot(NoAwaitTag{}, request); +} + +future> +RegionSnapshotsClient::DeleteSnapshot( + google::cloud::cpp::compute::v1::Operation const& operation, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->DeleteSnapshot(operation); +} + +StatusOr +RegionSnapshotsClient::GetSnapshot(std::string const& project, + std::string const& region, + std::string const& snapshot, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_snapshots::v1::GetSnapshotRequest request; + request.set_project(project); + request.set_region(region); + request.set_snapshot(snapshot); + return connection_->GetSnapshot(request); +} + +StatusOr +RegionSnapshotsClient::GetSnapshot( + google::cloud::cpp::compute::region_snapshots::v1::GetSnapshotRequest const& + request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->GetSnapshot(request); +} + +StatusOr +RegionSnapshotsClient::GetIamPolicy(std::string const& project, + std::string const& region, + std::string const& resource, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_snapshots::v1::GetIamPolicyRequest + request; + request.set_project(project); + request.set_region(region); + request.set_resource(resource); + return connection_->GetIamPolicy(request); +} + +StatusOr +RegionSnapshotsClient::GetIamPolicy( + google::cloud::cpp::compute::region_snapshots::v1:: + GetIamPolicyRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->GetIamPolicy(request); +} + +future> +RegionSnapshotsClient::InsertSnapshot( + std::string const& project, std::string const& region, + google::cloud::cpp::compute::v1::Snapshot const& snapshot_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_snapshots::v1::InsertSnapshotRequest + request; + request.set_project(project); + request.set_region(region); + *request.mutable_snapshot_resource() = snapshot_resource; + return connection_->InsertSnapshot(request); +} + +StatusOr +RegionSnapshotsClient::InsertSnapshot( + NoAwaitTag, std::string const& project, std::string const& region, + google::cloud::cpp::compute::v1::Snapshot const& snapshot_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_snapshots::v1::InsertSnapshotRequest + request; + request.set_project(project); + request.set_region(region); + *request.mutable_snapshot_resource() = snapshot_resource; + return connection_->InsertSnapshot(NoAwaitTag{}, request); +} + +future> +RegionSnapshotsClient::InsertSnapshot( + google::cloud::cpp::compute::region_snapshots::v1:: + InsertSnapshotRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->InsertSnapshot(request); +} + +StatusOr +RegionSnapshotsClient::InsertSnapshot( + NoAwaitTag, + google::cloud::cpp::compute::region_snapshots::v1:: + InsertSnapshotRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->InsertSnapshot(NoAwaitTag{}, request); +} + +future> +RegionSnapshotsClient::InsertSnapshot( + google::cloud::cpp::compute::v1::Operation const& operation, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->InsertSnapshot(operation); +} + +StreamRange +RegionSnapshotsClient::ListRegionSnapshots(std::string const& project, + std::string const& region, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_snapshots::v1::ListRegionSnapshotsRequest + request; + request.set_project(project); + request.set_region(region); + return connection_->ListRegionSnapshots(request); +} + +StreamRange +RegionSnapshotsClient::ListRegionSnapshots( + google::cloud::cpp::compute::region_snapshots::v1:: + ListRegionSnapshotsRequest request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->ListRegionSnapshots(std::move(request)); +} + +StatusOr +RegionSnapshotsClient::SetIamPolicy( + std::string const& project, std::string const& region, + std::string const& resource, + google::cloud::cpp::compute::v1::RegionSetPolicyRequest const& + region_set_policy_request_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_snapshots::v1::SetIamPolicyRequest + request; + request.set_project(project); + request.set_region(region); + request.set_resource(resource); + *request.mutable_region_set_policy_request_resource() = + region_set_policy_request_resource; + return connection_->SetIamPolicy(request); +} + +StatusOr +RegionSnapshotsClient::SetIamPolicy( + google::cloud::cpp::compute::region_snapshots::v1:: + SetIamPolicyRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->SetIamPolicy(request); +} + +future> +RegionSnapshotsClient::SetLabels( + std::string const& project, std::string const& region, + std::string const& resource, + google::cloud::cpp::compute::v1::RegionSetLabelsRequest const& + region_set_labels_request_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_snapshots::v1::SetLabelsRequest request; + request.set_project(project); + request.set_region(region); + request.set_resource(resource); + *request.mutable_region_set_labels_request_resource() = + region_set_labels_request_resource; + return connection_->SetLabels(request); +} + +StatusOr +RegionSnapshotsClient::SetLabels( + NoAwaitTag, std::string const& project, std::string const& region, + std::string const& resource, + google::cloud::cpp::compute::v1::RegionSetLabelsRequest const& + region_set_labels_request_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_snapshots::v1::SetLabelsRequest request; + request.set_project(project); + request.set_region(region); + request.set_resource(resource); + *request.mutable_region_set_labels_request_resource() = + region_set_labels_request_resource; + return connection_->SetLabels(NoAwaitTag{}, request); +} + +future> +RegionSnapshotsClient::SetLabels( + google::cloud::cpp::compute::region_snapshots::v1::SetLabelsRequest const& + request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->SetLabels(request); +} + +StatusOr +RegionSnapshotsClient::SetLabels( + NoAwaitTag, + google::cloud::cpp::compute::region_snapshots::v1::SetLabelsRequest const& + request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->SetLabels(NoAwaitTag{}, request); +} + +future> +RegionSnapshotsClient::SetLabels( + google::cloud::cpp::compute::v1::Operation const& operation, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->SetLabels(operation); +} + +StatusOr +RegionSnapshotsClient::TestIamPermissions( + std::string const& project, std::string const& region, + std::string const& resource, + google::cloud::cpp::compute::v1::TestPermissionsRequest const& + test_permissions_request_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_snapshots::v1::TestIamPermissionsRequest + request; + request.set_project(project); + request.set_region(region); + request.set_resource(resource); + *request.mutable_test_permissions_request_resource() = + test_permissions_request_resource; + return connection_->TestIamPermissions(request); +} + +StatusOr +RegionSnapshotsClient::TestIamPermissions( + google::cloud::cpp::compute::region_snapshots::v1:: + TestIamPermissionsRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->TestIamPermissions(request); +} + +future> +RegionSnapshotsClient::UpdateKmsKey( + std::string const& project, std::string const& region, + std::string const& snapshot, + google::cloud::cpp::compute::v1::RegionSnapshotUpdateKmsKeyRequest const& + region_snapshot_update_kms_key_request_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_snapshots::v1::UpdateKmsKeyRequest + request; + request.set_project(project); + request.set_region(region); + request.set_snapshot(snapshot); + *request.mutable_region_snapshot_update_kms_key_request_resource() = + region_snapshot_update_kms_key_request_resource; + return connection_->UpdateKmsKey(request); +} + +StatusOr +RegionSnapshotsClient::UpdateKmsKey( + NoAwaitTag, std::string const& project, std::string const& region, + std::string const& snapshot, + google::cloud::cpp::compute::v1::RegionSnapshotUpdateKmsKeyRequest const& + region_snapshot_update_kms_key_request_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::region_snapshots::v1::UpdateKmsKeyRequest + request; + request.set_project(project); + request.set_region(region); + request.set_snapshot(snapshot); + *request.mutable_region_snapshot_update_kms_key_request_resource() = + region_snapshot_update_kms_key_request_resource; + return connection_->UpdateKmsKey(NoAwaitTag{}, request); +} + +future> +RegionSnapshotsClient::UpdateKmsKey( + google::cloud::cpp::compute::region_snapshots::v1:: + UpdateKmsKeyRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->UpdateKmsKey(request); +} + +StatusOr +RegionSnapshotsClient::UpdateKmsKey( + NoAwaitTag, + google::cloud::cpp::compute::region_snapshots::v1:: + UpdateKmsKeyRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->UpdateKmsKey(NoAwaitTag{}, request); +} + +future> +RegionSnapshotsClient::UpdateKmsKey( + google::cloud::cpp::compute::v1::Operation const& operation, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->UpdateKmsKey(operation); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_snapshots_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_snapshots/v1/region_snapshots_client.h b/google/cloud/compute/region_snapshots/v1/region_snapshots_client.h new file mode 100644 index 0000000000000..a843c5dbbeb59 --- /dev/null +++ b/google/cloud/compute/region_snapshots/v1/region_snapshots_client.h @@ -0,0 +1,956 @@ +// Copyright 2026 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. +// source: google/cloud/compute/region_snapshots/v1/region_snapshots.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOTS_V1_REGION_SNAPSHOTS_CLIENT_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOTS_V1_REGION_SNAPSHOTS_CLIENT_H + +#include "google/cloud/compute/region_snapshots/v1/region_snapshots_rest_connection.h" +#include "google/cloud/future.h" +#include "google/cloud/no_await_tag.h" +#include "google/cloud/options.h" +#include "google/cloud/polling_policy.h" +#include "google/cloud/status_or.h" +#include "google/cloud/version.h" +#include +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_snapshots_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/// +/// Service for the regionSnapshots resource. +/// https://cloud.google.com/compute/docs/reference/rest/v1/regionSnapshots +/// +/// @par Equality +/// +/// Instances of this class created via copy-construction or copy-assignment +/// always compare equal. Instances created with equal +/// `std::shared_ptr<*Connection>` objects compare equal. Objects that compare +/// equal share the same underlying resources. +/// +/// @par Performance +/// +/// Creating a new instance of this class is a relatively expensive operation, +/// new objects establish new connections to the service. In contrast, +/// copy-construction, move-construction, and the corresponding assignment +/// operations are relatively efficient as the copies share all underlying +/// resources. +/// +/// @par Thread Safety +/// +/// Concurrent access to different instances of this class, even if they compare +/// equal, is guaranteed to work. Two or more threads operating on the same +/// instance of this class is not guaranteed to work. Since copy-construction +/// and move-construction is a relatively efficient operation, consider using +/// such a copy when using this class from multiple threads. +/// +class RegionSnapshotsClient { + public: + explicit RegionSnapshotsClient( + std::shared_ptr connection, Options opts = {}); + ~RegionSnapshotsClient(); + + ///@{ + /// @name Copy and move support + RegionSnapshotsClient(RegionSnapshotsClient const&) = default; + RegionSnapshotsClient& operator=(RegionSnapshotsClient const&) = default; + RegionSnapshotsClient(RegionSnapshotsClient&&) = default; + RegionSnapshotsClient& operator=(RegionSnapshotsClient&&) = default; + ///@} + + ///@{ + /// @name Equality + friend bool operator==(RegionSnapshotsClient const& a, + RegionSnapshotsClient const& b) { + return a.connection_ == b.connection_; + } + friend bool operator!=(RegionSnapshotsClient const& a, + RegionSnapshotsClient const& b) { + return !(a == b); + } + ///@} + + // clang-format off + /// + /// 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, seeDeleting + /// snapshots. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionSnapshots/delete + /// + /// @param project Project ID for this request. + /// @param region The name of the region for this request. + /// @param snapshot Name of the snapshot resource to delete. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_snapshots.v1.DeleteSnapshotRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_snapshots/v1/region_snapshots.proto#L165} + /// + // clang-format on + future> DeleteSnapshot( + std::string const& project, std::string const& region, + std::string const& snapshot, Options opts = {}); + + // clang-format off + /// + /// @copybrief DeleteSnapshot + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr DeleteSnapshot( + NoAwaitTag, std::string const& project, std::string const& region, + std::string const& snapshot, Options opts = {}); + + // clang-format off + /// + /// 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, seeDeleting + /// snapshots. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionSnapshots/delete + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.region_snapshots.v1.DeleteSnapshotRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_snapshots.v1.DeleteSnapshotRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_snapshots/v1/region_snapshots.proto#L165} + /// + // clang-format on + future> DeleteSnapshot( + google::cloud::cpp::compute::region_snapshots::v1:: + DeleteSnapshotRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief DeleteSnapshot + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr DeleteSnapshot( + NoAwaitTag, + google::cloud::cpp::compute::region_snapshots::v1:: + DeleteSnapshotRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief DeleteSnapshot + /// + /// This method accepts a `google::cloud::cpp::compute::v1::Operation` that corresponds + /// to a previously started Long Running Operation (LRO) and polls the status + /// of the LRO in the background. + /// + // clang-format on + future> DeleteSnapshot( + google::cloud::cpp::compute::v1::Operation const& operation, + Options opts = {}); + + // clang-format off + /// + /// Returns the specified Snapshot resource. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionSnapshots/get + /// + /// @param project Project ID for this request. + /// @param region Name of the region for this request. + /// @param snapshot Name of the Snapshot resource to return. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.Snapshot]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_snapshots.v1.GetSnapshotRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_snapshots/v1/region_snapshots.proto#L220} + /// [google.cloud.cpp.compute.v1.Snapshot]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_146.proto#L31} + /// + // clang-format on + StatusOr GetSnapshot( + std::string const& project, std::string const& region, + std::string const& snapshot, Options opts = {}); + + // clang-format off + /// + /// Returns the specified Snapshot resource. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionSnapshots/get + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.region_snapshots.v1.GetSnapshotRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.Snapshot]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_snapshots.v1.GetSnapshotRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_snapshots/v1/region_snapshots.proto#L220} + /// [google.cloud.cpp.compute.v1.Snapshot]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_146.proto#L31} + /// + // clang-format on + StatusOr GetSnapshot( + google::cloud::cpp::compute::region_snapshots::v1:: + GetSnapshotRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// Gets the access control policy for a resource. May be empty if no such + /// policy or resource exists. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionSnapshots/getIamPolicy + /// + /// @param project Project ID for this request. + /// @param region The name of the region for this request. + /// @param resource Name or id of the resource for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.Policy]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_snapshots.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_snapshots/v1/region_snapshots.proto#L201} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} + /// + // clang-format on + StatusOr GetIamPolicy( + std::string const& project, std::string const& region, + std::string const& resource, Options opts = {}); + + // clang-format off + /// + /// Gets the access control policy for a resource. May be empty if no such + /// policy or resource exists. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionSnapshots/getIamPolicy + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.region_snapshots.v1.GetIamPolicyRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.Policy]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_snapshots.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_snapshots/v1/region_snapshots.proto#L201} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} + /// + // clang-format on + StatusOr GetIamPolicy( + google::cloud::cpp::compute::region_snapshots::v1:: + GetIamPolicyRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// Creates a snapshot in the specified region using the data included + /// in the request. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionSnapshots/insert + /// + /// @param project Project ID for this request. + /// @param region Name of the region for this request. + /// @param snapshot_resource The Snapshot for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_snapshots.v1.InsertSnapshotRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_snapshots/v1/region_snapshots.proto#L235} + /// + // clang-format on + future> InsertSnapshot( + std::string const& project, std::string const& region, + google::cloud::cpp::compute::v1::Snapshot const& snapshot_resource, + Options opts = {}); + + // clang-format off + /// + /// @copybrief InsertSnapshot + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr InsertSnapshot( + NoAwaitTag, std::string const& project, std::string const& region, + google::cloud::cpp::compute::v1::Snapshot const& snapshot_resource, + Options opts = {}); + + // clang-format off + /// + /// Creates a snapshot in the specified region using the data included + /// in the request. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionSnapshots/insert + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.region_snapshots.v1.InsertSnapshotRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_snapshots.v1.InsertSnapshotRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_snapshots/v1/region_snapshots.proto#L235} + /// + // clang-format on + future> InsertSnapshot( + google::cloud::cpp::compute::region_snapshots::v1:: + InsertSnapshotRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief InsertSnapshot + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr InsertSnapshot( + NoAwaitTag, + google::cloud::cpp::compute::region_snapshots::v1:: + InsertSnapshotRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief InsertSnapshot + /// + /// This method accepts a `google::cloud::cpp::compute::v1::Operation` that corresponds + /// to a previously started Long Running Operation (LRO) and polls the status + /// of the LRO in the background. + /// + // clang-format on + future> InsertSnapshot( + google::cloud::cpp::compute::v1::Operation const& operation, + Options opts = {}); + + // clang-format off + /// + /// Retrieves the list of Snapshot resources contained within + /// the specified region. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionSnapshots/list + /// + /// @param project Project ID for this request. + /// @param region Name of the region for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return a [StreamRange](@ref google::cloud::StreamRange) + /// to iterate of the results. See the documentation of this type for + /// details. In brief, this class has `begin()` and `end()` member + /// functions returning a iterator class meeting the + /// [input iterator requirements]. The value type for this iterator is a + /// [`StatusOr`] as the iteration may fail even after some values are + /// retrieved successfully, for example, if there is a network disconnect. + /// An empty set of results does not indicate an error, it indicates + /// that there are no resources meeting the request criteria. + /// On a successful iteration the `StatusOr` contains elements of type + /// [google.cloud.cpp.compute.v1.Snapshot], or rather, + /// the C++ class generated by Protobuf from that type. Please consult the + /// Protobuf documentation for details on the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_snapshots.v1.ListRegionSnapshotsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_snapshots/v1/region_snapshots.proto#L271} + /// [google.cloud.cpp.compute.v1.Snapshot]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_146.proto#L31} + /// + // clang-format on + StreamRange ListRegionSnapshots( + std::string const& project, std::string const& region, Options opts = {}); + + // clang-format off + /// + /// Retrieves the list of Snapshot resources contained within + /// the specified region. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionSnapshots/list + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.region_snapshots.v1.ListRegionSnapshotsRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return a [StreamRange](@ref google::cloud::StreamRange) + /// to iterate of the results. See the documentation of this type for + /// details. In brief, this class has `begin()` and `end()` member + /// functions returning a iterator class meeting the + /// [input iterator requirements]. The value type for this iterator is a + /// [`StatusOr`] as the iteration may fail even after some values are + /// retrieved successfully, for example, if there is a network disconnect. + /// An empty set of results does not indicate an error, it indicates + /// that there are no resources meeting the request criteria. + /// On a successful iteration the `StatusOr` contains elements of type + /// [google.cloud.cpp.compute.v1.Snapshot], or rather, + /// the C++ class generated by Protobuf from that type. Please consult the + /// Protobuf documentation for details on the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_snapshots.v1.ListRegionSnapshotsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_snapshots/v1/region_snapshots.proto#L271} + /// [google.cloud.cpp.compute.v1.Snapshot]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_146.proto#L31} + /// + // clang-format on + StreamRange ListRegionSnapshots( + google::cloud::cpp::compute::region_snapshots::v1:: + ListRegionSnapshotsRequest request, + Options opts = {}); + + // clang-format off + /// + /// Sets the access control policy on the specified resource. + /// Replaces any existing policy. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionSnapshots/setIamPolicy + /// + /// @param project Project ID for this request. + /// @param region The name of the region for this request. + /// @param resource Name or id of the resource for this request. + /// @param region_set_policy_request_resource The RegionSetPolicyRequest for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.Policy]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_snapshots.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_snapshots/v1/region_snapshots.proto#L376} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} + /// + // clang-format on + StatusOr SetIamPolicy( + std::string const& project, std::string const& region, + std::string const& resource, + google::cloud::cpp::compute::v1::RegionSetPolicyRequest const& + region_set_policy_request_resource, + Options opts = {}); + + // clang-format off + /// + /// Sets the access control policy on the specified resource. + /// Replaces any existing policy. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionSnapshots/setIamPolicy + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.region_snapshots.v1.SetIamPolicyRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.Policy]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_snapshots.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_snapshots/v1/region_snapshots.proto#L376} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} + /// + // clang-format on + StatusOr SetIamPolicy( + google::cloud::cpp::compute::region_snapshots::v1:: + SetIamPolicyRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// Sets the labels on a regional snapshot. To learn more about labels, read + /// the Labeling Resources + /// documentation. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionSnapshots/setLabels + /// + /// @param project Project ID for this request. + /// @param region The region for this request. + /// @param resource Name or id of the resource for this request. + /// @param region_set_labels_request_resource The RegionSetLabelsRequest for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_snapshots.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_snapshots/v1/region_snapshots.proto#L396} + /// + // clang-format on + future> SetLabels( + std::string const& project, std::string const& region, + std::string const& resource, + google::cloud::cpp::compute::v1::RegionSetLabelsRequest const& + region_set_labels_request_resource, + Options opts = {}); + + // clang-format off + /// + /// @copybrief SetLabels + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr SetLabels( + NoAwaitTag, std::string const& project, std::string const& region, + std::string const& resource, + google::cloud::cpp::compute::v1::RegionSetLabelsRequest const& + region_set_labels_request_resource, + Options opts = {}); + + // clang-format off + /// + /// Sets the labels on a regional snapshot. To learn more about labels, read + /// the Labeling Resources + /// documentation. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionSnapshots/setLabels + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.region_snapshots.v1.SetLabelsRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_snapshots.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_snapshots/v1/region_snapshots.proto#L396} + /// + // clang-format on + future> SetLabels( + google::cloud::cpp::compute::region_snapshots::v1::SetLabelsRequest const& + request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief SetLabels + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr SetLabels( + NoAwaitTag, + google::cloud::cpp::compute::region_snapshots::v1::SetLabelsRequest const& + request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief SetLabels + /// + /// This method accepts a `google::cloud::cpp::compute::v1::Operation` that corresponds + /// to a previously started Long Running Operation (LRO) and polls the status + /// of the LRO in the background. + /// + // clang-format on + future> SetLabels( + google::cloud::cpp::compute::v1::Operation const& operation, + Options opts = {}); + + // clang-format off + /// + /// Returns permissions that a caller has on the specified resource. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionSnapshots/testIamPermissions + /// + /// @param project Project ID for this request. + /// @param region The name of the region for this request. + /// @param resource Name or id of the resource for this request. + /// @param test_permissions_request_resource The TestPermissionsRequest for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.TestPermissionsResponse]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_snapshots.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_snapshots/v1/region_snapshots.proto#L437} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} + /// + // clang-format on + StatusOr + TestIamPermissions( + std::string const& project, std::string const& region, + std::string const& resource, + google::cloud::cpp::compute::v1::TestPermissionsRequest const& + test_permissions_request_resource, + Options opts = {}); + + // clang-format off + /// + /// Returns permissions that a caller has on the specified resource. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionSnapshots/testIamPermissions + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.region_snapshots.v1.TestIamPermissionsRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.TestPermissionsResponse]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_snapshots.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_snapshots/v1/region_snapshots.proto#L437} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} + /// + // clang-format on + StatusOr + TestIamPermissions(google::cloud::cpp::compute::region_snapshots::v1:: + TestIamPermissionsRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// Rotates the customer-managed + /// encryption key to the latest version for the specified snapshot. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionSnapshots/updateKmsKey + /// + /// @param project Project ID for this request. + /// @param region Name of the region for this request. + /// @param snapshot Name of the snapshot resource to update. Should conform to RFC1035. + /// @param region_snapshot_update_kms_key_request_resource The RegionSnapshotUpdateKmsKeyRequest for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_snapshots.v1.UpdateKmsKeyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_snapshots/v1/region_snapshots.proto#L456} + /// + // clang-format on + future> UpdateKmsKey( + std::string const& project, std::string const& region, + std::string const& snapshot, + google::cloud::cpp::compute::v1::RegionSnapshotUpdateKmsKeyRequest const& + region_snapshot_update_kms_key_request_resource, + Options opts = {}); + + // clang-format off + /// + /// @copybrief UpdateKmsKey + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr UpdateKmsKey( + NoAwaitTag, std::string const& project, std::string const& region, + std::string const& snapshot, + google::cloud::cpp::compute::v1::RegionSnapshotUpdateKmsKeyRequest const& + region_snapshot_update_kms_key_request_resource, + Options opts = {}); + + // clang-format off + /// + /// Rotates the customer-managed + /// encryption key to the latest version for the specified snapshot. + /// https://cloud.google.com/compute/docs/reference/rest/v1/regionSnapshots/updateKmsKey + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.region_snapshots.v1.UpdateKmsKeyRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.region_snapshots.v1.UpdateKmsKeyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_snapshots/v1/region_snapshots.proto#L456} + /// + // clang-format on + future> UpdateKmsKey( + google::cloud::cpp::compute::region_snapshots::v1:: + UpdateKmsKeyRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief UpdateKmsKey + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr UpdateKmsKey( + NoAwaitTag, + google::cloud::cpp::compute::region_snapshots::v1:: + UpdateKmsKeyRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief UpdateKmsKey + /// + /// This method accepts a `google::cloud::cpp::compute::v1::Operation` that corresponds + /// to a previously started Long Running Operation (LRO) and polls the status + /// of the LRO in the background. + /// + // clang-format on + future> UpdateKmsKey( + google::cloud::cpp::compute::v1::Operation const& operation, + Options opts = {}); + + private: + std::shared_ptr connection_; + Options options_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_snapshots_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOTS_V1_REGION_SNAPSHOTS_CLIENT_H diff --git a/google/cloud/compute/region_snapshots/v1/region_snapshots_connection.cc b/google/cloud/compute/region_snapshots/v1/region_snapshots_connection.cc new file mode 100644 index 0000000000000..763fd03b984d5 --- /dev/null +++ b/google/cloud/compute/region_snapshots/v1/region_snapshots_connection.cc @@ -0,0 +1,178 @@ +// Copyright 2026 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. +// source: google/cloud/compute/region_snapshots/v1/region_snapshots.proto + +#include "google/cloud/compute/region_snapshots/v1/region_snapshots_connection.h" +#include "google/cloud/compute/region_snapshots/v1/internal/region_snapshots_option_defaults.h" +#include "google/cloud/compute/region_snapshots/v1/internal/region_snapshots_tracing_connection.h" +#include "google/cloud/compute/region_snapshots/v1/region_snapshots_options.h" +#include "google/cloud/background_threads.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/grpc_options.h" +#include "google/cloud/internal/pagination_range.h" +#include "google/cloud/internal/unified_grpc_credentials.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_snapshots_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +RegionSnapshotsConnection::~RegionSnapshotsConnection() = default; + +future> +RegionSnapshotsConnection::DeleteSnapshot( + google::cloud::cpp::compute::region_snapshots::v1:: + DeleteSnapshotRequest const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +RegionSnapshotsConnection::DeleteSnapshot( + NoAwaitTag, google::cloud::cpp::compute::region_snapshots::v1:: + DeleteSnapshotRequest const&) { + return StatusOr( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +RegionSnapshotsConnection::DeleteSnapshot( + google::cloud::cpp::compute::v1::Operation const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +RegionSnapshotsConnection::GetSnapshot( + google::cloud::cpp::compute::region_snapshots::v1:: + GetSnapshotRequest const&) { + return Status(StatusCode::kUnimplemented, "not implemented"); +} + +StatusOr +RegionSnapshotsConnection::GetIamPolicy( + google::cloud::cpp::compute::region_snapshots::v1:: + GetIamPolicyRequest const&) { + return Status(StatusCode::kUnimplemented, "not implemented"); +} + +future> +RegionSnapshotsConnection::InsertSnapshot( + google::cloud::cpp::compute::region_snapshots::v1:: + InsertSnapshotRequest const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +RegionSnapshotsConnection::InsertSnapshot( + NoAwaitTag, google::cloud::cpp::compute::region_snapshots::v1:: + InsertSnapshotRequest const&) { + return StatusOr( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +RegionSnapshotsConnection::InsertSnapshot( + google::cloud::cpp::compute::v1::Operation const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StreamRange +RegionSnapshotsConnection::ListRegionSnapshots( + google::cloud::cpp::compute::region_snapshots::v1:: + ListRegionSnapshotsRequest) { // NOLINT(performance-unnecessary-value-param) + return google::cloud::internal::MakeUnimplementedPaginationRange< + StreamRange>(); +} + +StatusOr +RegionSnapshotsConnection::SetIamPolicy( + google::cloud::cpp::compute::region_snapshots::v1:: + SetIamPolicyRequest const&) { + return Status(StatusCode::kUnimplemented, "not implemented"); +} + +future> +RegionSnapshotsConnection::SetLabels( + google::cloud::cpp::compute::region_snapshots::v1:: + SetLabelsRequest const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +RegionSnapshotsConnection::SetLabels( + NoAwaitTag, google::cloud::cpp::compute::region_snapshots::v1:: + SetLabelsRequest const&) { + return StatusOr( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +RegionSnapshotsConnection::SetLabels( + google::cloud::cpp::compute::v1::Operation const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +RegionSnapshotsConnection::TestIamPermissions( + google::cloud::cpp::compute::region_snapshots::v1:: + TestIamPermissionsRequest const&) { + return Status(StatusCode::kUnimplemented, "not implemented"); +} + +future> +RegionSnapshotsConnection::UpdateKmsKey( + google::cloud::cpp::compute::region_snapshots::v1:: + UpdateKmsKeyRequest const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +RegionSnapshotsConnection::UpdateKmsKey( + NoAwaitTag, google::cloud::cpp::compute::region_snapshots::v1:: + UpdateKmsKeyRequest const&) { + return StatusOr( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +RegionSnapshotsConnection::UpdateKmsKey( + google::cloud::cpp::compute::v1::Operation const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_snapshots_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_snapshots/v1/region_snapshots_connection.h b/google/cloud/compute/region_snapshots/v1/region_snapshots_connection.h new file mode 100644 index 0000000000000..b34523045d834 --- /dev/null +++ b/google/cloud/compute/region_snapshots/v1/region_snapshots_connection.h @@ -0,0 +1,262 @@ +// Copyright 2026 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. +// source: google/cloud/compute/region_snapshots/v1/region_snapshots.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOTS_V1_REGION_SNAPSHOTS_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOTS_V1_REGION_SNAPSHOTS_CONNECTION_H + +#include "google/cloud/compute/region_snapshots/v1/internal/region_snapshots_retry_traits.h" +#include "google/cloud/compute/region_snapshots/v1/region_snapshots.pb.h" +#include "google/cloud/compute/region_snapshots/v1/region_snapshots_connection_idempotency_policy.h" +#include "google/cloud/backoff_policy.h" +#include "google/cloud/future.h" +#include "google/cloud/internal/retry_policy_impl.h" +#include "google/cloud/no_await_tag.h" +#include "google/cloud/options.h" +#include "google/cloud/polling_policy.h" +#include "google/cloud/status_or.h" +#include "google/cloud/stream_range.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_snapshots_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/// The retry policy for `RegionSnapshotsConnection`. +class RegionSnapshotsRetryPolicy : public ::google::cloud::RetryPolicy { + public: + /// Creates a new instance of the policy, reset to the initial state. + virtual std::unique_ptr clone() const = 0; +}; + +/** + * A retry policy for `RegionSnapshotsConnection` based on counting errors. + * + * This policy stops retrying if: + * - An RPC returns a non-transient error. + * - More than a prescribed number of transient failures is detected. + * + * In this class the following status codes are treated as transient errors: + * - [`kUnavailable`](@ref google::cloud::StatusCode) + */ +class RegionSnapshotsLimitedErrorCountRetryPolicy + : public RegionSnapshotsRetryPolicy { + public: + /** + * Create an instance that tolerates up to @p maximum_failures transient + * errors. + * + * @note Disable the retry loop by providing an instance of this policy with + * @p maximum_failures == 0. + */ + explicit RegionSnapshotsLimitedErrorCountRetryPolicy(int maximum_failures) + : impl_(maximum_failures) {} + + RegionSnapshotsLimitedErrorCountRetryPolicy( + RegionSnapshotsLimitedErrorCountRetryPolicy&& rhs) noexcept + : RegionSnapshotsLimitedErrorCountRetryPolicy(rhs.maximum_failures()) {} + RegionSnapshotsLimitedErrorCountRetryPolicy( + RegionSnapshotsLimitedErrorCountRetryPolicy const& rhs) noexcept + : RegionSnapshotsLimitedErrorCountRetryPolicy(rhs.maximum_failures()) {} + + int maximum_failures() const { return impl_.maximum_failures(); } + + bool OnFailure(Status const& status) override { + return impl_.OnFailure(status); + } + bool IsExhausted() const override { return impl_.IsExhausted(); } + bool IsPermanentFailure(Status const& status) const override { + return impl_.IsPermanentFailure(status); + } + std::unique_ptr clone() const override { + return std::make_unique( + maximum_failures()); + } + + // This is provided only for backwards compatibility. + using BaseType = RegionSnapshotsRetryPolicy; + + private: + google::cloud::internal::LimitedErrorCountRetryPolicy< + compute_region_snapshots_v1_internal::RegionSnapshotsRetryTraits> + impl_; +}; + +/** + * A retry policy for `RegionSnapshotsConnection` based on elapsed time. + * + * This policy stops retrying if: + * - An RPC returns a non-transient error. + * - The elapsed time in the retry loop exceeds a prescribed duration. + * + * In this class the following status codes are treated as transient errors: + * - [`kUnavailable`](@ref google::cloud::StatusCode) + */ +class RegionSnapshotsLimitedTimeRetryPolicy + : public RegionSnapshotsRetryPolicy { + public: + /** + * Constructor given a `std::chrono::duration<>` object. + * + * @tparam DurationRep a placeholder to match the `Rep` tparam for @p + * duration's type. The semantics of this template parameter are + * documented in `std::chrono::duration<>`. In brief, the underlying + * arithmetic type used to store the number of ticks. For our purposes it + * is simply a formal parameter. + * @tparam DurationPeriod a placeholder to match the `Period` tparam for @p + * duration's type. The semantics of this template parameter are + * documented in `std::chrono::duration<>`. In brief, the length of the + * tick in seconds, expressed as a `std::ratio<>`. For our purposes it is + * simply a formal parameter. + * @param maximum_duration the maximum time allowed before the policy expires. + * While the application can express this time in any units they desire, + * the class truncates to milliseconds. + * + * @see https://en.cppreference.com/w/cpp/chrono/duration for more information + * about `std::chrono::duration`. + */ + template + explicit RegionSnapshotsLimitedTimeRetryPolicy( + std::chrono::duration maximum_duration) + : impl_(maximum_duration) {} + + RegionSnapshotsLimitedTimeRetryPolicy( + RegionSnapshotsLimitedTimeRetryPolicy&& rhs) noexcept + : RegionSnapshotsLimitedTimeRetryPolicy(rhs.maximum_duration()) {} + RegionSnapshotsLimitedTimeRetryPolicy( + RegionSnapshotsLimitedTimeRetryPolicy const& rhs) noexcept + : RegionSnapshotsLimitedTimeRetryPolicy(rhs.maximum_duration()) {} + + std::chrono::milliseconds maximum_duration() const { + return impl_.maximum_duration(); + } + + bool OnFailure(Status const& status) override { + return impl_.OnFailure(status); + } + bool IsExhausted() const override { return impl_.IsExhausted(); } + bool IsPermanentFailure(Status const& status) const override { + return impl_.IsPermanentFailure(status); + } + std::unique_ptr clone() const override { + return std::make_unique( + maximum_duration()); + } + + // This is provided only for backwards compatibility. + using BaseType = RegionSnapshotsRetryPolicy; + + private: + google::cloud::internal::LimitedTimeRetryPolicy< + compute_region_snapshots_v1_internal::RegionSnapshotsRetryTraits> + impl_; +}; + +/** + * The `RegionSnapshotsConnection` object for `RegionSnapshotsClient`. + * + * This interface defines virtual methods for each of the user-facing overload + * sets in `RegionSnapshotsClient`. This allows users to inject custom behavior + * (e.g., with a Google Mock object) when writing tests that use objects of type + * `RegionSnapshotsClient`. + * + * To create a concrete instance, see `MakeRegionSnapshotsConnection()`. + * + * For mocking, see + * `compute_region_snapshots_v1_mocks::MockRegionSnapshotsConnection`. + */ +class RegionSnapshotsConnection { + public: + virtual ~RegionSnapshotsConnection() = 0; + + virtual Options options() { return Options{}; } + + virtual future> + DeleteSnapshot(google::cloud::cpp::compute::region_snapshots::v1:: + DeleteSnapshotRequest const& request); + + virtual StatusOr DeleteSnapshot( + NoAwaitTag, google::cloud::cpp::compute::region_snapshots::v1:: + DeleteSnapshotRequest const& request); + + virtual future> + DeleteSnapshot(google::cloud::cpp::compute::v1::Operation const& operation); + + virtual StatusOr GetSnapshot( + google::cloud::cpp::compute::region_snapshots::v1:: + GetSnapshotRequest const& request); + + virtual StatusOr GetIamPolicy( + google::cloud::cpp::compute::region_snapshots::v1:: + GetIamPolicyRequest const& request); + + virtual future> + InsertSnapshot(google::cloud::cpp::compute::region_snapshots::v1:: + InsertSnapshotRequest const& request); + + virtual StatusOr InsertSnapshot( + NoAwaitTag, google::cloud::cpp::compute::region_snapshots::v1:: + InsertSnapshotRequest const& request); + + virtual future> + InsertSnapshot(google::cloud::cpp::compute::v1::Operation const& operation); + + virtual StreamRange + ListRegionSnapshots(google::cloud::cpp::compute::region_snapshots::v1:: + ListRegionSnapshotsRequest request); + + virtual StatusOr SetIamPolicy( + google::cloud::cpp::compute::region_snapshots::v1:: + SetIamPolicyRequest const& request); + + virtual future> + SetLabels( + google::cloud::cpp::compute::region_snapshots::v1::SetLabelsRequest const& + request); + + virtual StatusOr SetLabels( + NoAwaitTag, + google::cloud::cpp::compute::region_snapshots::v1::SetLabelsRequest const& + request); + + virtual future> + SetLabels(google::cloud::cpp::compute::v1::Operation const& operation); + + virtual StatusOr + TestIamPermissions(google::cloud::cpp::compute::region_snapshots::v1:: + TestIamPermissionsRequest const& request); + + virtual future> + UpdateKmsKey(google::cloud::cpp::compute::region_snapshots::v1:: + UpdateKmsKeyRequest const& request); + + virtual StatusOr UpdateKmsKey( + NoAwaitTag, google::cloud::cpp::compute::region_snapshots::v1:: + UpdateKmsKeyRequest const& request); + + virtual future> + UpdateKmsKey(google::cloud::cpp::compute::v1::Operation const& operation); +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_snapshots_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOTS_V1_REGION_SNAPSHOTS_CONNECTION_H diff --git a/google/cloud/compute/region_snapshots/v1/region_snapshots_connection_idempotency_policy.cc b/google/cloud/compute/region_snapshots/v1/region_snapshots_connection_idempotency_policy.cc new file mode 100644 index 0000000000000..a7c107f629236 --- /dev/null +++ b/google/cloud/compute/region_snapshots/v1/region_snapshots_connection_idempotency_policy.cc @@ -0,0 +1,99 @@ +// Copyright 2026 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. +// source: google/cloud/compute/region_snapshots/v1/region_snapshots.proto + +#include "google/cloud/compute/region_snapshots/v1/region_snapshots_connection_idempotency_policy.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_snapshots_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +using ::google::cloud::Idempotency; + +RegionSnapshotsConnectionIdempotencyPolicy:: + ~RegionSnapshotsConnectionIdempotencyPolicy() = default; + +std::unique_ptr +RegionSnapshotsConnectionIdempotencyPolicy::clone() const { + return std::make_unique(*this); +} + +Idempotency RegionSnapshotsConnectionIdempotencyPolicy::DeleteSnapshot( + google::cloud::cpp::compute::region_snapshots::v1:: + DeleteSnapshotRequest const&) { + return Idempotency::kNonIdempotent; +} + +Idempotency RegionSnapshotsConnectionIdempotencyPolicy::GetSnapshot( + google::cloud::cpp::compute::region_snapshots::v1:: + GetSnapshotRequest const&) { + return Idempotency::kIdempotent; +} + +Idempotency RegionSnapshotsConnectionIdempotencyPolicy::GetIamPolicy( + google::cloud::cpp::compute::region_snapshots::v1:: + GetIamPolicyRequest const&) { + return Idempotency::kIdempotent; +} + +Idempotency RegionSnapshotsConnectionIdempotencyPolicy::InsertSnapshot( + google::cloud::cpp::compute::region_snapshots::v1:: + InsertSnapshotRequest const&) { + return Idempotency::kNonIdempotent; +} + +Idempotency RegionSnapshotsConnectionIdempotencyPolicy::ListRegionSnapshots( + google::cloud::cpp::compute::region_snapshots::v1:: + ListRegionSnapshotsRequest) { // NOLINT + return Idempotency::kIdempotent; +} + +Idempotency RegionSnapshotsConnectionIdempotencyPolicy::SetIamPolicy( + google::cloud::cpp::compute::region_snapshots::v1:: + SetIamPolicyRequest const&) { + return Idempotency::kNonIdempotent; +} + +Idempotency RegionSnapshotsConnectionIdempotencyPolicy::SetLabels( + google::cloud::cpp::compute::region_snapshots::v1:: + SetLabelsRequest const&) { + return Idempotency::kNonIdempotent; +} + +Idempotency RegionSnapshotsConnectionIdempotencyPolicy::TestIamPermissions( + google::cloud::cpp::compute::region_snapshots::v1:: + TestIamPermissionsRequest const&) { + return Idempotency::kNonIdempotent; +} + +Idempotency RegionSnapshotsConnectionIdempotencyPolicy::UpdateKmsKey( + google::cloud::cpp::compute::region_snapshots::v1:: + UpdateKmsKeyRequest const&) { + return Idempotency::kNonIdempotent; +} + +std::unique_ptr +MakeDefaultRegionSnapshotsConnectionIdempotencyPolicy() { + return std::make_unique(); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_snapshots_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_snapshots/v1/region_snapshots_connection_idempotency_policy.h b/google/cloud/compute/region_snapshots/v1/region_snapshots_connection_idempotency_policy.h new file mode 100644 index 0000000000000..53108ffd24dad --- /dev/null +++ b/google/cloud/compute/region_snapshots/v1/region_snapshots_connection_idempotency_policy.h @@ -0,0 +1,85 @@ +// Copyright 2026 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. +// source: google/cloud/compute/region_snapshots/v1/region_snapshots.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOTS_V1_REGION_SNAPSHOTS_CONNECTION_IDEMPOTENCY_POLICY_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOTS_V1_REGION_SNAPSHOTS_CONNECTION_IDEMPOTENCY_POLICY_H + +#include "google/cloud/compute/region_snapshots/v1/region_snapshots.pb.h" +#include "google/cloud/idempotency.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_snapshots_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class RegionSnapshotsConnectionIdempotencyPolicy { + public: + virtual ~RegionSnapshotsConnectionIdempotencyPolicy(); + + /// Create a new copy of this object. + virtual std::unique_ptr clone() + const; + + virtual google::cloud::Idempotency DeleteSnapshot( + google::cloud::cpp::compute::region_snapshots::v1:: + DeleteSnapshotRequest const& request); + + virtual google::cloud::Idempotency GetSnapshot( + google::cloud::cpp::compute::region_snapshots::v1:: + GetSnapshotRequest const& request); + + virtual google::cloud::Idempotency GetIamPolicy( + google::cloud::cpp::compute::region_snapshots::v1:: + GetIamPolicyRequest const& request); + + virtual google::cloud::Idempotency InsertSnapshot( + google::cloud::cpp::compute::region_snapshots::v1:: + InsertSnapshotRequest const& request); + + virtual google::cloud::Idempotency ListRegionSnapshots( + google::cloud::cpp::compute::region_snapshots::v1:: + ListRegionSnapshotsRequest request); + + virtual google::cloud::Idempotency SetIamPolicy( + google::cloud::cpp::compute::region_snapshots::v1:: + SetIamPolicyRequest const& request); + + virtual google::cloud::Idempotency SetLabels( + google::cloud::cpp::compute::region_snapshots::v1::SetLabelsRequest const& + request); + + virtual google::cloud::Idempotency TestIamPermissions( + google::cloud::cpp::compute::region_snapshots::v1:: + TestIamPermissionsRequest const& request); + + virtual google::cloud::Idempotency UpdateKmsKey( + google::cloud::cpp::compute::region_snapshots::v1:: + UpdateKmsKeyRequest const& request); +}; + +std::unique_ptr +MakeDefaultRegionSnapshotsConnectionIdempotencyPolicy(); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_snapshots_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOTS_V1_REGION_SNAPSHOTS_CONNECTION_IDEMPOTENCY_POLICY_H diff --git a/google/cloud/compute/region_snapshots/v1/region_snapshots_options.h b/google/cloud/compute/region_snapshots/v1/region_snapshots_options.h new file mode 100644 index 0000000000000..8bcdf6a916ee7 --- /dev/null +++ b/google/cloud/compute/region_snapshots/v1/region_snapshots_options.h @@ -0,0 +1,87 @@ +// Copyright 2026 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. +// source: google/cloud/compute/region_snapshots/v1/region_snapshots.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOTS_V1_REGION_SNAPSHOTS_OPTIONS_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOTS_V1_REGION_SNAPSHOTS_OPTIONS_H + +#include "google/cloud/compute/region_snapshots/v1/region_snapshots_connection.h" +#include "google/cloud/compute/region_snapshots/v1/region_snapshots_connection_idempotency_policy.h" +#include "google/cloud/backoff_policy.h" +#include "google/cloud/options.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_snapshots_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/** + * Use with `google::cloud::Options` to configure the retry policy. + * + * @ingroup google-cloud-compute-options + */ +struct RegionSnapshotsRetryPolicyOption { + using Type = std::shared_ptr; +}; + +/** + * Use with `google::cloud::Options` to configure the backoff policy. + * + * @ingroup google-cloud-compute-options + */ +struct RegionSnapshotsBackoffPolicyOption { + using Type = std::shared_ptr; +}; + +/** + * Use with `google::cloud::Options` to configure which operations are retried. + * + * @ingroup google-cloud-compute-options + */ +struct RegionSnapshotsConnectionIdempotencyPolicyOption { + using Type = std::shared_ptr; +}; + +/** + * Use with `google::cloud::Options` to configure the long-running operations + * polling policy. + * + * @ingroup google-cloud-compute-options + */ +struct RegionSnapshotsPollingPolicyOption { + using Type = std::shared_ptr; +}; + +/** + * The options applicable to RegionSnapshots. + * + * @ingroup google-cloud-compute-options + */ +using RegionSnapshotsPolicyOptionList = + OptionList; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_snapshots_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOTS_V1_REGION_SNAPSHOTS_OPTIONS_H diff --git a/google/cloud/compute/region_snapshots/v1/region_snapshots_proto_export.h b/google/cloud/compute/region_snapshots/v1/region_snapshots_proto_export.h new file mode 100644 index 0000000000000..5c7de241d54cc --- /dev/null +++ b/google/cloud/compute/region_snapshots/v1/region_snapshots_proto_export.h @@ -0,0 +1,41 @@ +// Copyright 2026 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_REGION_SNAPSHOTS_V1_REGION_SNAPSHOTS_PROTO_EXPORT_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOTS_V1_REGION_SNAPSHOTS_PROTO_EXPORT_H + +// IWYU pragma: begin_exports +#include "google/cloud/compute/v1/internal/common_009.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_028.pb.h" +#include "google/cloud/compute/v1/internal/common_040.pb.h" +#include "google/cloud/compute/v1/internal/common_125.pb.h" +#include "google/cloud/compute/v1/internal/common_126.pb.h" +#include "google/cloud/compute/v1/internal/common_127.pb.h" +#include "google/cloud/compute/v1/internal/common_146.pb.h" +#include "google/cloud/compute/v1/internal/common_147.pb.h" +#include "google/cloud/compute/v1/internal/common_171.pb.h" +// IWYU pragma: end_exports + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOTS_V1_REGION_SNAPSHOTS_PROTO_EXPORT_H diff --git a/google/cloud/compute/region_snapshots/v1/region_snapshots_rest_connection.cc b/google/cloud/compute/region_snapshots/v1/region_snapshots_rest_connection.cc new file mode 100644 index 0000000000000..e6b54de68bcbe --- /dev/null +++ b/google/cloud/compute/region_snapshots/v1/region_snapshots_rest_connection.cc @@ -0,0 +1,59 @@ +// Copyright 2026 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. +// source: google/cloud/compute/region_snapshots/v1/region_snapshots.proto + +#include "google/cloud/compute/region_snapshots/v1/region_snapshots_rest_connection.h" +#include "google/cloud/compute/region_snapshots/v1/internal/region_snapshots_option_defaults.h" +#include "google/cloud/compute/region_snapshots/v1/internal/region_snapshots_rest_connection_impl.h" +#include "google/cloud/compute/region_snapshots/v1/internal/region_snapshots_rest_stub_factory.h" +#include "google/cloud/compute/region_snapshots/v1/internal/region_snapshots_tracing_connection.h" +#include "google/cloud/compute/region_snapshots/v1/region_snapshots_options.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/internal/rest_background_threads_impl.h" +#include "google/cloud/internal/rest_options.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_region_snapshots_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +std::shared_ptr MakeRegionSnapshotsConnectionRest( + Options options) { + internal::CheckExpectedOptions< + CommonOptionList, RestOptionList, UnifiedCredentialsOptionList, + rest_internal::TargetApiVersionOption, RegionSnapshotsPolicyOptionList>( + options, __func__); + options = compute_region_snapshots_v1_internal::RegionSnapshotsDefaultOptions( + std::move(options)); + auto background = std::make_unique< + rest_internal::AutomaticallyCreatedRestBackgroundThreads>(); + auto stub = compute_region_snapshots_v1_internal:: + CreateDefaultRegionSnapshotsRestStub(options); + return compute_region_snapshots_v1_internal:: + MakeRegionSnapshotsTracingConnection( + std::make_shared( + std::move(background), std::move(stub), std::move(options))); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_snapshots_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/region_snapshots/v1/region_snapshots_rest_connection.h b/google/cloud/compute/region_snapshots/v1/region_snapshots_rest_connection.h new file mode 100644 index 0000000000000..c500a8931d61e --- /dev/null +++ b/google/cloud/compute/region_snapshots/v1/region_snapshots_rest_connection.h @@ -0,0 +1,65 @@ +// Copyright 2026 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. +// source: google/cloud/compute/region_snapshots/v1/region_snapshots.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOTS_V1_REGION_SNAPSHOTS_REST_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOTS_V1_REGION_SNAPSHOTS_REST_CONNECTION_H + +#include "google/cloud/compute/region_snapshots/v1/region_snapshots_connection.h" +#include "google/cloud/options.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_region_snapshots_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/** + * A factory function to construct an object of type `RegionSnapshotsConnection` + * that uses REST over HTTP as transport in lieu of gRPC. REST transport should + * only be used for services that do not support gRPC or if the existing network + * configuration precludes using gRPC. + * + * The returned connection object should not be used directly; instead it + * should be passed as an argument to the constructor of RegionSnapshotsClient. + * + * The optional @p options argument may be used to configure aspects of the + * returned `RegionSnapshotsConnection`. Expected options are any of the types + * in the following option lists: + * + * - `google::cloud::CommonOptionList` + * - `google::cloud::RestOptionList` + * - `google::cloud::UnifiedCredentialsOptionList` + * - + * `google::cloud::compute_region_snapshots_v1::RegionSnapshotsPolicyOptionList` + * + * @note Unexpected options will be ignored. To log unexpected options instead, + * set `GOOGLE_CLOUD_CPP_ENABLE_CLOG=yes` in the environment. + * + * @param options (optional) Configure the `RegionSnapshotsConnection` created + * by this function. + */ +std::shared_ptr MakeRegionSnapshotsConnectionRest( + Options options = {}); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_region_snapshots_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SNAPSHOTS_V1_REGION_SNAPSHOTS_REST_CONNECTION_H diff --git a/google/cloud/compute/region_snapshots/v1/samples/region_snapshots_client_samples.cc b/google/cloud/compute/region_snapshots/v1/samples/region_snapshots_client_samples.cc new file mode 100644 index 0000000000000..0ed31f12cae53 --- /dev/null +++ b/google/cloud/compute/region_snapshots/v1/samples/region_snapshots_client_samples.cc @@ -0,0 +1,239 @@ +// Copyright 2026 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. +// source: google/cloud/compute/region_snapshots/v1/region_snapshots.proto + +#include "google/cloud/compute/region_snapshots/v1/region_snapshots_client.h" +#include "google/cloud/compute/region_snapshots/v1/region_snapshots_connection_idempotency_policy.h" +#include "google/cloud/compute/region_snapshots/v1/region_snapshots_options.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/internal/getenv.h" +#include "google/cloud/polling_policy.h" +#include "google/cloud/testing_util/example_driver.h" +#include "google/cloud/universe_domain.h" +#include +#include +#include +#include + +// clang-format off +// main-dox-marker: compute_region_snapshots_v1::RegionSnapshotsClient +// lro-marker: true +// clang-format on +namespace { + +void SetClientEndpoint(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-endpoint"}; + } + //! [set-client-endpoint] + // This configuration is common with Private Google Access: + // https://cloud.google.com/vpc/docs/private-google-access + auto options = google::cloud::Options{}.set( + "private.googleapis.com"); + auto vpc_client = + google::cloud::compute_region_snapshots_v1::RegionSnapshotsClient( + google::cloud::compute_region_snapshots_v1:: + MakeRegionSnapshotsConnectionRest(options)); + //! [set-client-endpoint] +} + +void SetClientUniverseDomain(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-universe-domain"}; + } + //! [set-client-universe-domain] + google::cloud::Options options; + + // AddUniverseDomainOption interrogates the UnifiedCredentialsOption, if set, + // in the provided Options for the Universe Domain associated with the + // credentials and adds it to the set of Options. + // If no UnifiedCredentialsOption is set, GoogleDefaultCredentials are used. + auto ud_options = google::cloud::AddUniverseDomainOption(std::move(options)); + + if (!ud_options.ok()) throw std::move(ud_options).status(); + auto ud_client = + google::cloud::compute_region_snapshots_v1::RegionSnapshotsClient( + google::cloud::compute_region_snapshots_v1:: + MakeRegionSnapshotsConnectionRest(*ud_options)); + //! [set-client-universe-domain] +} + +//! [custom-idempotency-policy] +class CustomIdempotencyPolicy + : public google::cloud::compute_region_snapshots_v1:: + RegionSnapshotsConnectionIdempotencyPolicy { + public: + ~CustomIdempotencyPolicy() override = default; + std::unique_ptr + clone() const override { + return std::make_unique(*this); + } + // Override inherited functions to define as needed. +}; +//! [custom-idempotency-policy] + +void SetRetryPolicy(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-retry-policy"}; + } + //! [set-retry-policy] + auto options = google::cloud::Options{} + .set( + CustomIdempotencyPolicy().clone()) + .set( + google::cloud::compute_region_snapshots_v1:: + RegionSnapshotsLimitedErrorCountRetryPolicy(3) + .clone()) + .set( + google::cloud::ExponentialBackoffPolicy( + /*initial_delay=*/std::chrono::milliseconds(200), + /*maximum_delay=*/std::chrono::seconds(45), + /*scaling=*/2.0) + .clone()); + auto connection = google::cloud::compute_region_snapshots_v1:: + MakeRegionSnapshotsConnectionRest(options); + + // c1 and c2 share the same retry policies + auto c1 = google::cloud::compute_region_snapshots_v1::RegionSnapshotsClient( + connection); + auto c2 = google::cloud::compute_region_snapshots_v1::RegionSnapshotsClient( + connection); + + // You can override any of the policies in a new client. This new client + // will share the policies from c1 (or c2) *except* for the retry policy. + auto c3 = google::cloud::compute_region_snapshots_v1::RegionSnapshotsClient( + connection, + google::cloud::Options{} + .set( + google::cloud::compute_region_snapshots_v1:: + RegionSnapshotsLimitedTimeRetryPolicy(std::chrono::minutes(5)) + .clone())); + + // You can also override the policies in a single call: + // c3.SomeRpc(..., google::cloud::Options{} + // .set( + // google::cloud::compute_region_snapshots_v1::RegionSnapshotsLimitedErrorCountRetryPolicy(10).clone())); + //! [set-retry-policy] +} + +void SetPollingPolicy(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-policy-policy"}; + } + //! [set-polling-policy] + + // The polling policy controls how the client waits for long-running + // operations. `GenericPollingPolicy<>` combines existing policies. + // In this case, keep polling until the operation completes (with success + // or error) or 45 minutes, whichever happens first. Initially pause for + // 10 seconds between polling requests, increasing the pause by a factor + // of 4 until it becomes 2 minutes. + auto options = + google::cloud::Options{} + .set( + google::cloud::GenericPollingPolicy< + google::cloud::compute_region_snapshots_v1:: + RegionSnapshotsRetryPolicyOption::Type, + google::cloud::compute_region_snapshots_v1:: + RegionSnapshotsBackoffPolicyOption::Type>( + google::cloud::compute_region_snapshots_v1:: + RegionSnapshotsLimitedTimeRetryPolicy( + /*maximum_duration=*/std::chrono::minutes(45)) + .clone(), + google::cloud::ExponentialBackoffPolicy( + /*initial_delay=*/std::chrono::seconds(10), + /*maximum_delay=*/std::chrono::minutes(2), + /*scaling=*/4.0) + .clone()) + .clone()); + + auto connection = google::cloud::compute_region_snapshots_v1:: + MakeRegionSnapshotsConnectionRest(options); + + // c1 and c2 share the same polling policies. + auto c1 = google::cloud::compute_region_snapshots_v1::RegionSnapshotsClient( + connection); + auto c2 = google::cloud::compute_region_snapshots_v1::RegionSnapshotsClient( + connection); + //! [set-polling-policy] +} + +void WithServiceAccount(std::vector const& argv) { + if (argv.size() != 1 || argv[0] == "--help") { + throw google::cloud::testing_util::Usage{"with-service-account "}; + } + //! [with-service-account] + [](std::string const& keyfile) { + auto is = std::ifstream(keyfile); + is.exceptions(std::ios::badbit); // Minimal error handling in examples + auto contents = std::string(std::istreambuf_iterator(is.rdbuf()), {}); + auto options = + google::cloud::Options{}.set( + google::cloud::MakeServiceAccountCredentials(contents)); + return google::cloud::compute_region_snapshots_v1::RegionSnapshotsClient( + google::cloud::compute_region_snapshots_v1:: + MakeRegionSnapshotsConnectionRest(options)); + } + //! [with-service-account] + (argv.at(0)); +} + +void AutoRun(std::vector const& argv) { + namespace examples = ::google::cloud::testing_util; + using ::google::cloud::internal::GetEnv; + if (!argv.empty()) throw examples::Usage{"auto"}; + examples::CheckEnvironmentVariablesAreSet( + {"GOOGLE_CLOUD_CPP_TEST_SERVICE_ACCOUNT_KEYFILE"}); + auto const keyfile = + GetEnv("GOOGLE_CLOUD_CPP_TEST_SERVICE_ACCOUNT_KEYFILE").value(); + + std::cout << "\nRunning SetClientEndpoint() example" << std::endl; + SetClientEndpoint({}); + + std::cout << "\nRunning SetRetryPolicy() example" << std::endl; + SetRetryPolicy({}); + + std::cout << "\nRunning SetPollingPolicy() example" << std::endl; + SetPollingPolicy({}); + + std::cout << "\nRunning WithServiceAccount() example" << std::endl; + WithServiceAccount({keyfile}); + + std::cout << "\nRunning SetClientUniverseDomain() example" << std::endl; + SetClientUniverseDomain({}); +} + +} // namespace + +int main(int argc, char* argv[]) { // NOLINT(bugprone-exception-escape) + google::cloud::testing_util::Example example({ + {"set-client-endpoint", SetClientEndpoint}, + {"set-retry-policy", SetRetryPolicy}, + {"set-polling-policy", SetPollingPolicy}, + {"with-service-account", WithServiceAccount}, + {"set-client-universe-domain", SetClientUniverseDomain}, + {"auto", AutoRun}, + }); + return example.Run(argc, argv); +} 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 6bfc68675a202..d18d064cb850e 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 @@ -119,7 +119,7 @@ class RegionSslCertificatesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_ssl_certificates.v1.DeleteSslCertificateRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_ssl_certificates/v1/region_ssl_certificates.proto#L89} + /// [google.cloud.cpp.compute.region_ssl_certificates.v1.DeleteSslCertificateRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_ssl_certificates/v1/region_ssl_certificates.proto#L90} /// // clang-format on future> @@ -172,7 +172,7 @@ class RegionSslCertificatesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_ssl_certificates.v1.DeleteSslCertificateRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_ssl_certificates/v1/region_ssl_certificates.proto#L89} + /// [google.cloud.cpp.compute.region_ssl_certificates.v1.DeleteSslCertificateRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_ssl_certificates/v1/region_ssl_certificates.proto#L90} /// // clang-format on future> @@ -214,7 +214,8 @@ class RegionSslCertificatesClient { // clang-format off /// /// Returns the specified SslCertificate resource in the specified region. Get - /// a list of available SSL certificates by making a list() request. + /// a list of available SSL certificates by making a list() + /// request. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionSslCertificates/get /// /// @param project Project ID for this request. @@ -233,8 +234,8 @@ class RegionSslCertificatesClient { /// [`future`]: @ref google::cloud::future /// [`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_125.proto#L39} + /// [google.cloud.cpp.compute.region_ssl_certificates.v1.GetSslCertificateRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_ssl_certificates/v1/region_ssl_certificates.proto#L126} + /// [google.cloud.cpp.compute.v1.SslCertificate]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_150.proto#L59} /// // clang-format on StatusOr GetSslCertificate( @@ -244,7 +245,8 @@ class RegionSslCertificatesClient { // clang-format off /// /// Returns the specified SslCertificate resource in the specified region. Get - /// a list of available SSL certificates by making a list() request. + /// a list of available SSL certificates by making a list() + /// request. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionSslCertificates/get /// /// @param request Unary RPCs, such as the one wrapped by this @@ -266,8 +268,8 @@ class RegionSslCertificatesClient { /// [`future`]: @ref google::cloud::future /// [`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_125.proto#L39} + /// [google.cloud.cpp.compute.region_ssl_certificates.v1.GetSslCertificateRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_ssl_certificates/v1/region_ssl_certificates.proto#L126} + /// [google.cloud.cpp.compute.v1.SslCertificate]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_150.proto#L59} /// // clang-format on StatusOr GetSslCertificate( @@ -304,7 +306,7 @@ class RegionSslCertificatesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_ssl_certificates.v1.InsertSslCertificateRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_ssl_certificates/v1/region_ssl_certificates.proto#L137} + /// [google.cloud.cpp.compute.region_ssl_certificates.v1.InsertSslCertificateRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_ssl_certificates/v1/region_ssl_certificates.proto#L141} /// // clang-format on future> @@ -362,7 +364,7 @@ class RegionSslCertificatesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_ssl_certificates.v1.InsertSslCertificateRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_ssl_certificates/v1/region_ssl_certificates.proto#L137} + /// [google.cloud.cpp.compute.region_ssl_certificates.v1.InsertSslCertificateRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_ssl_certificates/v1/region_ssl_certificates.proto#L141} /// // clang-format on future> @@ -431,8 +433,8 @@ class RegionSslCertificatesClient { /// [`future`]: @ref google::cloud::future /// [`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_125.proto#L39} + /// [google.cloud.cpp.compute.region_ssl_certificates.v1.ListRegionSslCertificatesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_ssl_certificates/v1/region_ssl_certificates.proto#L177} + /// [google.cloud.cpp.compute.v1.SslCertificate]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_150.proto#L59} /// // clang-format on StreamRange @@ -473,8 +475,8 @@ class RegionSslCertificatesClient { /// [`future`]: @ref google::cloud::future /// [`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_125.proto#L39} + /// [google.cloud.cpp.compute.region_ssl_certificates.v1.ListRegionSslCertificatesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_ssl_certificates/v1/region_ssl_certificates.proto#L177} + /// [google.cloud.cpp.compute.v1.SslCertificate]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_150.proto#L59} /// // 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 53f07c86c3bab..1383139ec66bf 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 "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_125.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_150.pb.h" // 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 7ae7298329d5f..243bb32dcdece 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 @@ -234,8 +234,8 @@ class RegionSslPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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_128.proto#L140} + /// [google.cloud.cpp.compute.region_ssl_policies.v1.GetSslPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_ssl_policies/v1/region_ssl_policies.proto#L150} + /// [google.cloud.cpp.compute.v1.SslPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_153.proto#L165} /// // clang-format on StatusOr GetSslPolicy( @@ -266,8 +266,8 @@ class RegionSslPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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_128.proto#L140} + /// [google.cloud.cpp.compute.region_ssl_policies.v1.GetSslPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_ssl_policies/v1/region_ssl_policies.proto#L150} + /// [google.cloud.cpp.compute.v1.SslPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_153.proto#L165} /// // clang-format on StatusOr GetSslPolicy( @@ -304,7 +304,7 @@ class RegionSslPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_ssl_policies.v1.InsertSslPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_ssl_policies/v1/region_ssl_policies.proto#L163} + /// [google.cloud.cpp.compute.region_ssl_policies.v1.InsertSslPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_ssl_policies/v1/region_ssl_policies.proto#L166} /// // clang-format on future> InsertSslPolicy( @@ -360,7 +360,7 @@ class RegionSslPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_ssl_policies.v1.InsertSslPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_ssl_policies/v1/region_ssl_policies.proto#L163} + /// [google.cloud.cpp.compute.region_ssl_policies.v1.InsertSslPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_ssl_policies/v1/region_ssl_policies.proto#L166} /// // clang-format on future> InsertSslPolicy( @@ -428,8 +428,8 @@ class RegionSslPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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_128.proto#L140} + /// [google.cloud.cpp.compute.region_ssl_policies.v1.ListRegionSslPoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_ssl_policies/v1/region_ssl_policies.proto#L307} + /// [google.cloud.cpp.compute.v1.SslPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_153.proto#L165} /// // clang-format on StreamRange ListRegionSslPolicies( @@ -469,8 +469,8 @@ class RegionSslPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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_128.proto#L140} + /// [google.cloud.cpp.compute.region_ssl_policies.v1.ListRegionSslPoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_ssl_policies/v1/region_ssl_policies.proto#L307} + /// [google.cloud.cpp.compute.v1.SslPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_153.proto#L165} /// // clang-format on StreamRange ListRegionSslPolicies( @@ -499,8 +499,8 @@ class RegionSslPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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_128.proto#L132} + /// [google.cloud.cpp.compute.region_ssl_policies.v1.ListAvailableFeaturesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_ssl_policies/v1/region_ssl_policies.proto#L202} + /// [google.cloud.cpp.compute.v1.SslPoliciesListAvailableFeaturesResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_153.proto#L155} /// // clang-format on StatusOr< @@ -533,8 +533,8 @@ class RegionSslPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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_128.proto#L132} + /// [google.cloud.cpp.compute.region_ssl_policies.v1.ListAvailableFeaturesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_ssl_policies/v1/region_ssl_policies.proto#L202} + /// [google.cloud.cpp.compute.v1.SslPoliciesListAvailableFeaturesResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_153.proto#L155} /// // clang-format on StatusOr< @@ -573,7 +573,7 @@ class RegionSslPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_ssl_policies.v1.PatchSslPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_ssl_policies/v1/region_ssl_policies.proto#L340} + /// [google.cloud.cpp.compute.region_ssl_policies.v1.PatchSslPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_ssl_policies/v1/region_ssl_policies.proto#L412} /// // clang-format on future> PatchSslPolicy( @@ -630,7 +630,7 @@ class RegionSslPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_ssl_policies.v1.PatchSslPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_ssl_policies/v1/region_ssl_policies.proto#L340} + /// [google.cloud.cpp.compute.region_ssl_policies.v1.PatchSslPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_ssl_policies/v1/region_ssl_policies.proto#L412} /// // clang-format on future> PatchSslPolicy( 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 d14a283cdc0f8..fe74a87c5ff7a 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 "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_128.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_153.pb.h" // 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 a59ff1954f9b6..c3f958007df80 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 @@ -234,8 +234,8 @@ class RegionTargetHttpProxiesClient { /// [`future`]: @ref google::cloud::future /// [`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_135.proto#L36} + /// [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#L138} + /// [google.cloud.cpp.compute.v1.TargetHttpProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_161.proto#L45} /// // clang-format on StatusOr GetTargetHttpProxy( @@ -266,8 +266,8 @@ class RegionTargetHttpProxiesClient { /// [`future`]: @ref google::cloud::future /// [`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_135.proto#L36} + /// [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#L138} + /// [google.cloud.cpp.compute.v1.TargetHttpProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_161.proto#L45} /// // clang-format on StatusOr GetTargetHttpProxy( @@ -304,7 +304,7 @@ class RegionTargetHttpProxiesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_target_http_proxies.v1.InsertTargetHttpProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_target_http_proxies/v1/region_target_http_proxies.proto#L150} + /// [google.cloud.cpp.compute.region_target_http_proxies.v1.InsertTargetHttpProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_target_http_proxies/v1/region_target_http_proxies.proto#L153} /// // clang-format on future> @@ -362,7 +362,7 @@ class RegionTargetHttpProxiesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_target_http_proxies.v1.InsertTargetHttpProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_target_http_proxies/v1/region_target_http_proxies.proto#L150} + /// [google.cloud.cpp.compute.region_target_http_proxies.v1.InsertTargetHttpProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_target_http_proxies/v1/region_target_http_proxies.proto#L153} /// // clang-format on future> @@ -404,8 +404,8 @@ class RegionTargetHttpProxiesClient { // clang-format off /// - /// Retrieves the list of TargetHttpProxy resources available to the specified - /// project in the specified region. + /// Retrieves the list of TargetHttpProxy resources available + /// to the specified project in the specified region. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionTargetHttpProxies/list /// /// @param project Project ID for this request. @@ -432,8 +432,8 @@ class RegionTargetHttpProxiesClient { /// [`future`]: @ref google::cloud::future /// [`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_135.proto#L36} + /// [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#L189} + /// [google.cloud.cpp.compute.v1.TargetHttpProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_161.proto#L45} /// // clang-format on StreamRange @@ -442,8 +442,8 @@ class RegionTargetHttpProxiesClient { // clang-format off /// - /// Retrieves the list of TargetHttpProxy resources available to the specified - /// project in the specified region. + /// Retrieves the list of TargetHttpProxy resources available + /// to the specified project in the specified region. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionTargetHttpProxies/list /// /// @param request Unary RPCs, such as the one wrapped by this @@ -474,8 +474,8 @@ class RegionTargetHttpProxiesClient { /// [`future`]: @ref google::cloud::future /// [`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_135.proto#L36} + /// [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#L189} + /// [google.cloud.cpp.compute.v1.TargetHttpProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_161.proto#L45} /// // clang-format on StreamRange @@ -513,7 +513,7 @@ class RegionTargetHttpProxiesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_target_http_proxies.v1.SetUrlMapRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_target_http_proxies/v1/region_target_http_proxies.proto#L255} + /// [google.cloud.cpp.compute.region_target_http_proxies.v1.SetUrlMapRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_target_http_proxies/v1/region_target_http_proxies.proto#L294} /// // clang-format on future> SetUrlMap( @@ -572,7 +572,7 @@ class RegionTargetHttpProxiesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_target_http_proxies.v1.SetUrlMapRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_target_http_proxies/v1/region_target_http_proxies.proto#L255} + /// [google.cloud.cpp.compute.region_target_http_proxies.v1.SetUrlMapRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_target_http_proxies/v1/region_target_http_proxies.proto#L294} /// // clang-format on future> SetUrlMap( 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 7a536280922ea..2ba491c18a7b6 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 "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_135.pb.h" -#include "google/cloud/compute/v1/internal/common_147.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_161.pb.h" +#include "google/cloud/compute/v1/internal/common_174.pb.h" // 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 d6589ad06eb75..c6c99f15cd7bf 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 @@ -120,7 +120,7 @@ class RegionTargetHttpsProxiesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_target_https_proxies.v1.DeleteTargetHttpsProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_target_https_proxies/v1/region_target_https_proxies.proto#L131} + /// [google.cloud.cpp.compute.region_target_https_proxies.v1.DeleteTargetHttpsProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_target_https_proxies/v1/region_target_https_proxies.proto#L132} /// // clang-format on future> @@ -174,7 +174,7 @@ class RegionTargetHttpsProxiesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_target_https_proxies.v1.DeleteTargetHttpsProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_target_https_proxies/v1/region_target_https_proxies.proto#L131} + /// [google.cloud.cpp.compute.region_target_https_proxies.v1.DeleteTargetHttpsProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_target_https_proxies/v1/region_target_https_proxies.proto#L132} /// // clang-format on future> @@ -235,8 +235,8 @@ class RegionTargetHttpsProxiesClient { /// [`future`]: @ref google::cloud::future /// [`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_137.proto#L36} + /// [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#L168} + /// [google.cloud.cpp.compute.v1.TargetHttpsProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_163.proto#L45} /// // clang-format on StatusOr @@ -267,8 +267,8 @@ class RegionTargetHttpsProxiesClient { /// [`future`]: @ref google::cloud::future /// [`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_137.proto#L36} + /// [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#L168} + /// [google.cloud.cpp.compute.v1.TargetHttpsProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_163.proto#L45} /// // clang-format on StatusOr @@ -305,7 +305,7 @@ class RegionTargetHttpsProxiesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_target_https_proxies.v1.InsertTargetHttpsProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_target_https_proxies/v1/region_target_https_proxies.proto#L179} + /// [google.cloud.cpp.compute.region_target_https_proxies.v1.InsertTargetHttpsProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_target_https_proxies/v1/region_target_https_proxies.proto#L183} /// // clang-format on future> @@ -364,7 +364,7 @@ class RegionTargetHttpsProxiesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_target_https_proxies.v1.InsertTargetHttpsProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_target_https_proxies/v1/region_target_https_proxies.proto#L179} + /// [google.cloud.cpp.compute.region_target_https_proxies.v1.InsertTargetHttpsProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_target_https_proxies/v1/region_target_https_proxies.proto#L183} /// // clang-format on future> @@ -406,8 +406,8 @@ class RegionTargetHttpsProxiesClient { // clang-format off /// - /// Retrieves the list of TargetHttpsProxy resources available to the specified - /// project in the specified region. + /// Retrieves the list of TargetHttpsProxy resources available + /// to the specified project in the specified region. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionTargetHttpsProxies/list /// /// @param project Project ID for this request. @@ -434,8 +434,8 @@ class RegionTargetHttpsProxiesClient { /// [`future`]: @ref google::cloud::future /// [`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_137.proto#L36} + /// [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#L219} + /// [google.cloud.cpp.compute.v1.TargetHttpsProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_163.proto#L45} /// // clang-format on StreamRange @@ -444,8 +444,8 @@ class RegionTargetHttpsProxiesClient { // clang-format off /// - /// Retrieves the list of TargetHttpsProxy resources available to the specified - /// project in the specified region. + /// Retrieves the list of TargetHttpsProxy resources available + /// to the specified project in the specified region. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionTargetHttpsProxies/list /// /// @param request Unary RPCs, such as the one wrapped by this @@ -476,8 +476,8 @@ class RegionTargetHttpsProxiesClient { /// [`future`]: @ref google::cloud::future /// [`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_137.proto#L36} + /// [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#L219} + /// [google.cloud.cpp.compute.v1.TargetHttpsProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_163.proto#L45} /// // clang-format on StreamRange @@ -489,8 +489,9 @@ class RegionTargetHttpsProxiesClient { // clang-format off /// /// 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. + /// included in the request. This method supports PATCH + /// semantics and usesJSON merge + /// patch format and processing rules. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionTargetHttpsProxies/patch /// /// @param project Project ID for this request. @@ -517,7 +518,7 @@ class RegionTargetHttpsProxiesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_target_https_proxies.v1.PatchTargetHttpsProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_target_https_proxies/v1/region_target_https_proxies.proto#L284} + /// [google.cloud.cpp.compute.region_target_https_proxies.v1.PatchTargetHttpsProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_target_https_proxies/v1/region_target_https_proxies.proto#L324} /// // clang-format on future> @@ -548,8 +549,9 @@ class RegionTargetHttpsProxiesClient { // clang-format off /// /// 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. + /// included in the request. This method supports PATCH + /// semantics and usesJSON merge + /// patch format and processing rules. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionTargetHttpsProxies/patch /// /// @param request Unary RPCs, such as the one wrapped by this @@ -578,7 +580,7 @@ class RegionTargetHttpsProxiesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_target_https_proxies.v1.PatchTargetHttpsProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_target_https_proxies/v1/region_target_https_proxies.proto#L284} + /// [google.cloud.cpp.compute.region_target_https_proxies.v1.PatchTargetHttpsProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_target_https_proxies/v1/region_target_https_proxies.proto#L324} /// // clang-format on future> @@ -625,8 +627,8 @@ class RegionTargetHttpsProxiesClient { /// /// @param project Project ID for this request. /// @param region Name of the region scoping this request. - /// @param target_https_proxy Name of the TargetHttpsProxy resource to set an SslCertificates resource - /// for. + /// @param target_https_proxy Name of the TargetHttpsProxy resource to set an + /// SslCertificates resource for. /// @param region_target_https_proxies_set_ssl_certificates_request_resource The RegionTargetHttpsProxiesSetSslCertificatesRequest for this request. /// @param opts Optional. Override the class-level options, such as retry and /// backoff policies. @@ -648,7 +650,7 @@ class RegionTargetHttpsProxiesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_target_https_proxies.v1.SetSslCertificatesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_target_https_proxies/v1/region_target_https_proxies.proto#L321} + /// [google.cloud.cpp.compute.region_target_https_proxies.v1.SetSslCertificatesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_target_https_proxies/v1/region_target_https_proxies.proto#L364} /// // clang-format on future> @@ -710,7 +712,7 @@ class RegionTargetHttpsProxiesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_target_https_proxies.v1.SetSslCertificatesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_target_https_proxies/v1/region_target_https_proxies.proto#L321} + /// [google.cloud.cpp.compute.region_target_https_proxies.v1.SetSslCertificatesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_target_https_proxies/v1/region_target_https_proxies.proto#L364} /// // clang-format on future> @@ -778,7 +780,7 @@ class RegionTargetHttpsProxiesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_target_https_proxies.v1.SetUrlMapRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_target_https_proxies/v1/region_target_https_proxies.proto#L361} + /// [google.cloud.cpp.compute.region_target_https_proxies.v1.SetUrlMapRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_target_https_proxies/v1/region_target_https_proxies.proto#L407} /// // clang-format on future> SetUrlMap( @@ -837,7 +839,7 @@ class RegionTargetHttpsProxiesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_target_https_proxies.v1.SetUrlMapRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_target_https_proxies/v1/region_target_https_proxies.proto#L361} + /// [google.cloud.cpp.compute.region_target_https_proxies.v1.SetUrlMapRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_target_https_proxies/v1/region_target_https_proxies.proto#L407} /// // clang-format on future> SetUrlMap( 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 ae98cca47bc24..1f775e6b54229 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 "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_109.pb.h" -#include "google/cloud/compute/v1/internal/common_137.pb.h" -#include "google/cloud/compute/v1/internal/common_147.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_128.pb.h" +#include "google/cloud/compute/v1/internal/common_163.pb.h" +#include "google/cloud/compute/v1/internal/common_174.pb.h" // 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 662ca9be58440..fa75ff4cb055d 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 @@ -232,8 +232,8 @@ class RegionTargetTcpProxiesClient { /// [`future`]: @ref google::cloud::future /// [`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_143.proto#L28} + /// [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#L124} + /// [google.cloud.cpp.compute.v1.TargetTcpProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_169.proto#L30} /// // clang-format on StatusOr GetTargetTcpProxy( @@ -264,8 +264,8 @@ class RegionTargetTcpProxiesClient { /// [`future`]: @ref google::cloud::future /// [`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_143.proto#L28} + /// [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#L124} + /// [google.cloud.cpp.compute.v1.TargetTcpProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_169.proto#L30} /// // clang-format on StatusOr GetTargetTcpProxy( @@ -302,7 +302,7 @@ class RegionTargetTcpProxiesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_target_tcp_proxies.v1.InsertTargetTcpProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_target_tcp_proxies/v1/region_target_tcp_proxies.proto#L136} + /// [google.cloud.cpp.compute.region_target_tcp_proxies.v1.InsertTargetTcpProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_target_tcp_proxies/v1/region_target_tcp_proxies.proto#L139} /// // clang-format on future> @@ -360,7 +360,7 @@ class RegionTargetTcpProxiesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_target_tcp_proxies.v1.InsertTargetTcpProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_target_tcp_proxies/v1/region_target_tcp_proxies.proto#L136} + /// [google.cloud.cpp.compute.region_target_tcp_proxies.v1.InsertTargetTcpProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_target_tcp_proxies/v1/region_target_tcp_proxies.proto#L139} /// // clang-format on future> @@ -401,8 +401,8 @@ class RegionTargetTcpProxiesClient { // clang-format off /// - /// Retrieves a list of TargetTcpProxy resources available to the specified - /// project in a given region. + /// Retrieves a list of TargetTcpProxy resources + /// available to the specified project in a given region. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionTargetTcpProxies/list /// /// @param project Project ID for this request. @@ -429,8 +429,8 @@ class RegionTargetTcpProxiesClient { /// [`future`]: @ref google::cloud::future /// [`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_143.proto#L28} + /// [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#L175} + /// [google.cloud.cpp.compute.v1.TargetTcpProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_169.proto#L30} /// // clang-format on StreamRange @@ -439,8 +439,8 @@ class RegionTargetTcpProxiesClient { // clang-format off /// - /// Retrieves a list of TargetTcpProxy resources available to the specified - /// project in a given region. + /// Retrieves a list of TargetTcpProxy resources + /// available to the specified project in a given region. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionTargetTcpProxies/list /// /// @param request Unary RPCs, such as the one wrapped by this @@ -471,8 +471,8 @@ class RegionTargetTcpProxiesClient { /// [`future`]: @ref google::cloud::future /// [`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_143.proto#L28} + /// [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#L175} + /// [google.cloud.cpp.compute.v1.TargetTcpProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_169.proto#L30} /// // 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 cb711e208aa3c..dda54725edaa9 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 "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_143.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_169.pb.h" // 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 279be0d92d68d..e220428b695a8 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 @@ -115,7 +115,7 @@ class RegionUrlMapsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_url_maps.v1.DeleteUrlMapRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_url_maps/v1/region_url_maps.proto#L130} + /// [google.cloud.cpp.compute.region_url_maps.v1.DeleteUrlMapRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_url_maps/v1/region_url_maps.proto#L131} /// // clang-format on future> DeleteUrlMap( @@ -168,7 +168,7 @@ class RegionUrlMapsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_url_maps.v1.DeleteUrlMapRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_url_maps/v1/region_url_maps.proto#L130} + /// [google.cloud.cpp.compute.region_url_maps.v1.DeleteUrlMapRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_url_maps/v1/region_url_maps.proto#L131} /// // clang-format on future> DeleteUrlMap( @@ -227,8 +227,8 @@ class RegionUrlMapsClient { /// [`future`]: @ref google::cloud::future /// [`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#L853} + /// [google.cloud.cpp.compute.region_url_maps.v1.GetUrlMapRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_url_maps/v1/region_url_maps.proto#L156} + /// [google.cloud.cpp.compute.v1.UrlMap]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_023.proto#L1457} /// // clang-format on StatusOr GetUrlMap( @@ -259,8 +259,8 @@ class RegionUrlMapsClient { /// [`future`]: @ref google::cloud::future /// [`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#L853} + /// [google.cloud.cpp.compute.region_url_maps.v1.GetUrlMapRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_url_maps/v1/region_url_maps.proto#L156} + /// [google.cloud.cpp.compute.v1.UrlMap]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_023.proto#L1457} /// // clang-format on StatusOr GetUrlMap( @@ -270,8 +270,8 @@ class RegionUrlMapsClient { // clang-format off /// - /// Creates a UrlMap resource in the specified project using the data included - /// in the request. + /// Creates a UrlMap resource in the specified project using + /// the data included in the request. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionUrlMaps/insert /// /// @param project Project ID for this request. @@ -297,7 +297,7 @@ class RegionUrlMapsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_url_maps.v1.InsertUrlMapRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_url_maps/v1/region_url_maps.proto#L170} + /// [google.cloud.cpp.compute.region_url_maps.v1.InsertUrlMapRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_url_maps/v1/region_url_maps.proto#L171} /// // clang-format on future> InsertUrlMap( @@ -323,8 +323,8 @@ class RegionUrlMapsClient { // clang-format off /// - /// Creates a UrlMap resource in the specified project using the data included - /// in the request. + /// Creates a UrlMap resource in the specified project using + /// the data included in the request. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionUrlMaps/insert /// /// @param request Unary RPCs, such as the one wrapped by this @@ -353,7 +353,7 @@ class RegionUrlMapsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_url_maps.v1.InsertUrlMapRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_url_maps/v1/region_url_maps.proto#L170} + /// [google.cloud.cpp.compute.region_url_maps.v1.InsertUrlMapRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_url_maps/v1/region_url_maps.proto#L171} /// // clang-format on future> InsertUrlMap( @@ -393,8 +393,8 @@ class RegionUrlMapsClient { // clang-format off /// - /// Retrieves the list of UrlMap resources available to the specified project - /// in the specified region. + /// Retrieves the list of UrlMap resources available to the specified + /// project in the specified region. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionUrlMaps/list /// /// @param project Project ID for this request. @@ -421,8 +421,8 @@ class RegionUrlMapsClient { /// [`future`]: @ref google::cloud::future /// [`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#L853} + /// [google.cloud.cpp.compute.region_url_maps.v1.ListRegionUrlMapsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_url_maps/v1/region_url_maps.proto#L196} + /// [google.cloud.cpp.compute.v1.UrlMap]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_023.proto#L1457} /// // clang-format on StreamRange ListRegionUrlMaps( @@ -430,8 +430,8 @@ class RegionUrlMapsClient { // clang-format off /// - /// Retrieves the list of UrlMap resources available to the specified project - /// in the specified region. + /// Retrieves the list of UrlMap resources available to the specified + /// project in the specified region. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionUrlMaps/list /// /// @param request Unary RPCs, such as the one wrapped by this @@ -462,8 +462,8 @@ class RegionUrlMapsClient { /// [`future`]: @ref google::cloud::future /// [`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#L853} + /// [google.cloud.cpp.compute.region_url_maps.v1.ListRegionUrlMapsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_url_maps/v1/region_url_maps.proto#L196} + /// [google.cloud.cpp.compute.v1.UrlMap]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_023.proto#L1457} /// // clang-format on StreamRange ListRegionUrlMaps( @@ -474,8 +474,9 @@ class RegionUrlMapsClient { // clang-format off /// /// 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. + /// request. This method supportsPATCH + /// semantics and usesJSON merge + /// patch format and processing rules. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionUrlMaps/patch /// /// @param project Project ID for this request. @@ -502,7 +503,7 @@ class RegionUrlMapsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_url_maps.v1.PatchUrlMapRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_url_maps/v1/region_url_maps.proto#L267} + /// [google.cloud.cpp.compute.region_url_maps.v1.PatchUrlMapRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_url_maps/v1/region_url_maps.proto#L301} /// // clang-format on future> PatchUrlMap( @@ -531,8 +532,9 @@ class RegionUrlMapsClient { // clang-format off /// /// 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. + /// request. This method supportsPATCH + /// semantics and usesJSON merge + /// patch format and processing rules. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionUrlMaps/patch /// /// @param request Unary RPCs, such as the one wrapped by this @@ -561,7 +563,7 @@ class RegionUrlMapsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_url_maps.v1.PatchUrlMapRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_url_maps/v1/region_url_maps.proto#L267} + /// [google.cloud.cpp.compute.region_url_maps.v1.PatchUrlMapRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_url_maps/v1/region_url_maps.proto#L301} /// // clang-format on future> PatchUrlMap( @@ -629,7 +631,7 @@ class RegionUrlMapsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_url_maps.v1.UpdateUrlMapRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_url_maps/v1/region_url_maps.proto#L296} + /// [google.cloud.cpp.compute.region_url_maps.v1.UpdateUrlMapRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_url_maps/v1/region_url_maps.proto#L330} /// // clang-format on future> UpdateUrlMap( @@ -687,7 +689,7 @@ class RegionUrlMapsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.region_url_maps.v1.UpdateUrlMapRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_url_maps/v1/region_url_maps.proto#L296} + /// [google.cloud.cpp.compute.region_url_maps.v1.UpdateUrlMapRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_url_maps/v1/region_url_maps.proto#L330} /// // clang-format on future> UpdateUrlMap( @@ -749,8 +751,8 @@ class RegionUrlMapsClient { /// [`future`]: @ref google::cloud::future /// [`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#L1145} + /// [google.cloud.cpp.compute.region_url_maps.v1.ValidateRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_url_maps/v1/region_url_maps.proto#L359} + /// [google.cloud.cpp.compute.v1.UrlMapsValidateResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_023.proto#L1826} /// // clang-format on StatusOr Validate( @@ -786,8 +788,8 @@ class RegionUrlMapsClient { /// [`future`]: @ref google::cloud::future /// [`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#L1145} + /// [google.cloud.cpp.compute.region_url_maps.v1.ValidateRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_url_maps/v1/region_url_maps.proto#L359} + /// [google.cloud.cpp.compute.v1.UrlMapsValidateResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_023.proto#L1826} /// // 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 f37775f1a5030..3f38371f76d30 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 "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_020.pb.h" -#include "google/cloud/compute/v1/internal/common_029.pb.h" -#include "google/cloud/compute/v1/internal/common_082.pb.h" -#include "google/cloud/compute/v1/internal/common_110.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_023.pb.h" +#include "google/cloud/compute/v1/internal/common_038.pb.h" +#include "google/cloud/compute/v1/internal/common_097.pb.h" +#include "google/cloud/compute/v1/internal/common_129.pb.h" // 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 e7e8105d007bd..3853dfdef0bd2 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_150.proto#L29} + /// [google.cloud.cpp.compute.v1.Zone]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_031.proto#L140} /// // 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_150.proto#L29} + /// [google.cloud.cpp.compute.v1.Zone]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_031.proto#L140} /// // 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 de43f725c90f7..39db31ff63902 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 "google/cloud/compute/v1/internal/common_023.pb.h" -#include "google/cloud/compute/v1/internal/common_150.pb.h" +#include "google/cloud/compute/v1/internal/common_031.pb.h" +#include "google/cloud/compute/v1/internal/common_032.pb.h" // 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 6845225c5a00b..05e985745d6ee 100644 --- a/google/cloud/compute/regions/v1/regions_client.h +++ b/google/cloud/compute/regions/v1/regions_client.h @@ -86,19 +86,24 @@ class RegionsClient { // clang-format off /// - /// 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 + /// 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. + /// 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. /// https://cloud.google.com/compute/docs/reference/rest/v1/regions/get /// /// @param project Project ID for this request. @@ -116,8 +121,8 @@ class RegionsClient { /// [`future`]: @ref google::cloud::future /// [`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_099.proto#L29} + /// [google.cloud.cpp.compute.regions.v1.GetRegionRequest]: @cloud_cpp_reference_link{google/cloud/compute/regions/v1/regions.proto#L94} + /// [google.cloud.cpp.compute.v1.Region]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_116.proto#L32} /// // clang-format on StatusOr GetRegion( @@ -125,19 +130,24 @@ class RegionsClient { // clang-format off /// - /// 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 + /// 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. + /// 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. /// https://cloud.google.com/compute/docs/reference/rest/v1/regions/get /// /// @param request Unary RPCs, such as the one wrapped by this @@ -159,8 +169,8 @@ class RegionsClient { /// [`future`]: @ref google::cloud::future /// [`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_099.proto#L29} + /// [google.cloud.cpp.compute.regions.v1.GetRegionRequest]: @cloud_cpp_reference_link{google/cloud/compute/regions/v1/regions.proto#L94} + /// [google.cloud.cpp.compute.v1.Region]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_116.proto#L32} /// // clang-format on StatusOr GetRegion( @@ -170,19 +180,24 @@ class RegionsClient { // clang-format off /// /// 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 + /// 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. + /// 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. /// https://cloud.google.com/compute/docs/reference/rest/v1/regions/list /// /// @param project Project ID for this request. @@ -208,8 +223,8 @@ class RegionsClient { /// [`future`]: @ref google::cloud::future /// [`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_099.proto#L29} + /// [google.cloud.cpp.compute.regions.v1.ListRegionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/regions/v1/regions.proto#L105} + /// [google.cloud.cpp.compute.v1.Region]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_116.proto#L32} /// // clang-format on StreamRange ListRegions( @@ -218,19 +233,24 @@ class RegionsClient { // clang-format off /// /// 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 + /// 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. + /// 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. /// https://cloud.google.com/compute/docs/reference/rest/v1/regions/list /// /// @param request Unary RPCs, such as the one wrapped by this @@ -261,8 +281,8 @@ class RegionsClient { /// [`future`]: @ref google::cloud::future /// [`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_099.proto#L29} + /// [google.cloud.cpp.compute.regions.v1.ListRegionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/regions/v1/regions.proto#L105} + /// [google.cloud.cpp.compute.v1.Region]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_116.proto#L32} /// // 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 e9ffa0bc8fed5..1c40585e10728 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 "google/cloud/compute/v1/internal/common_023.pb.h" -#include "google/cloud/compute/v1/internal/common_098.pb.h" -#include "google/cloud/compute/v1/internal/common_099.pb.h" +#include "google/cloud/compute/v1/internal/common_032.pb.h" +#include "google/cloud/compute/v1/internal/common_115.pb.h" +#include "google/cloud/compute/v1/internal/common_116.pb.h" // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGIONS_V1_REGIONS_PROTO_EXPORT_H diff --git a/google/cloud/compute/reliability_risks/v1/internal/reliability_risks_option_defaults.cc b/google/cloud/compute/reliability_risks/v1/internal/reliability_risks_option_defaults.cc new file mode 100644 index 0000000000000..536837f092bcb --- /dev/null +++ b/google/cloud/compute/reliability_risks/v1/internal/reliability_risks_option_defaults.cc @@ -0,0 +1,72 @@ +// Copyright 2026 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. +// source: google/cloud/compute/reliability_risks/v1/reliability_risks.proto + +#include "google/cloud/compute/reliability_risks/v1/internal/reliability_risks_option_defaults.h" +#include "google/cloud/compute/reliability_risks/v1/reliability_risks_connection.h" +#include "google/cloud/compute/reliability_risks/v1/reliability_risks_options.h" +#include "google/cloud/internal/populate_common_options.h" +#include "google/cloud/internal/populate_grpc_options.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_reliability_risks_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +namespace { +auto constexpr kBackoffScaling = 2.0; +} // namespace + +Options ReliabilityRisksDefaultOptions(Options options) { + options = internal::PopulateCommonOptions( + std::move(options), "GOOGLE_CLOUD_CPP_RELIABILITY_RISKS_ENDPOINT", "", + "GOOGLE_CLOUD_CPP_RELIABILITY_RISKS_AUTHORITY", "compute.googleapis.com"); + options = internal::PopulateGrpcOptions(std::move(options)); + if (!options.has< + compute_reliability_risks_v1::ReliabilityRisksRetryPolicyOption>()) { + options.set< + compute_reliability_risks_v1::ReliabilityRisksRetryPolicyOption>( + compute_reliability_risks_v1::ReliabilityRisksLimitedTimeRetryPolicy( + std::chrono::minutes(10)) + .clone()); + } + if (!options.has()) { + options + .set( + ExponentialBackoffPolicy( + std::chrono::seconds(0), std::chrono::seconds(1), + std::chrono::minutes(5), kBackoffScaling, kBackoffScaling) + .clone()); + } + if (!options.has()) { + options.set( + compute_reliability_risks_v1:: + MakeDefaultReliabilityRisksConnectionIdempotencyPolicy()); + } + + return options; +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_reliability_risks_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/reliability_risks/v1/internal/reliability_risks_option_defaults.h b/google/cloud/compute/reliability_risks/v1/internal/reliability_risks_option_defaults.h new file mode 100644 index 0000000000000..c630d49a88b2e --- /dev/null +++ b/google/cloud/compute/reliability_risks/v1/internal/reliability_risks_option_defaults.h @@ -0,0 +1,37 @@ +// Copyright 2026 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. +// source: google/cloud/compute/reliability_risks/v1/reliability_risks.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RELIABILITY_RISKS_V1_INTERNAL_RELIABILITY_RISKS_OPTION_DEFAULTS_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RELIABILITY_RISKS_V1_INTERNAL_RELIABILITY_RISKS_OPTION_DEFAULTS_H + +#include "google/cloud/options.h" +#include "google/cloud/version.h" + +namespace google { +namespace cloud { +namespace compute_reliability_risks_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +Options ReliabilityRisksDefaultOptions(Options options); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_reliability_risks_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RELIABILITY_RISKS_V1_INTERNAL_RELIABILITY_RISKS_OPTION_DEFAULTS_H diff --git a/google/cloud/compute/reliability_risks/v1/internal/reliability_risks_rest_connection_impl.cc b/google/cloud/compute/reliability_risks/v1/internal/reliability_risks_rest_connection_impl.cc new file mode 100644 index 0000000000000..31662a71f4357 --- /dev/null +++ b/google/cloud/compute/reliability_risks/v1/internal/reliability_risks_rest_connection_impl.cc @@ -0,0 +1,103 @@ +// Copyright 2026 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. +// source: google/cloud/compute/reliability_risks/v1/reliability_risks.proto + +#include "google/cloud/compute/reliability_risks/v1/internal/reliability_risks_rest_connection_impl.h" +#include "google/cloud/compute/reliability_risks/v1/internal/reliability_risks_rest_stub_factory.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/internal/pagination_range.h" +#include "google/cloud/internal/rest_retry_loop.h" +#include "google/cloud/rest_options.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_reliability_risks_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +ReliabilityRisksRestConnectionImpl::ReliabilityRisksRestConnectionImpl( + std::unique_ptr background, + std::shared_ptr< + compute_reliability_risks_v1_internal::ReliabilityRisksRestStub> + stub, + Options options) + : background_(std::move(background)), + stub_(std::move(stub)), + options_(internal::MergeOptions(std::move(options), + ReliabilityRisksConnection::options())) {} + +StatusOr +ReliabilityRisksRestConnectionImpl::GetReliabilityRisk( + google::cloud::cpp::compute::reliability_risks::v1:: + GetReliabilityRiskRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->GetReliabilityRisk(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::reliability_risks::v1:: + GetReliabilityRiskRequest const& request) { + return stub_->GetReliabilityRisk(rest_context, options, request); + }, + *current, request, __func__); +} + +StreamRange +ReliabilityRisksRestConnectionImpl::ListReliabilityRisks( + google::cloud::cpp::compute::reliability_risks::v1:: + ListReliabilityRisksRequest request) { + request.clear_page_token(); + auto current = google::cloud::internal::SaveCurrentOptions(); + auto idempotency = + idempotency_policy(*current)->ListReliabilityRisks(request); + char const* function_name = __func__; + return google::cloud::internal::MakePaginationRange< + StreamRange>( + current, std::move(request), + [idempotency, function_name, stub = stub_, + retry = std::shared_ptr< + compute_reliability_risks_v1::ReliabilityRisksRetryPolicy>( + retry_policy(*current)), + backoff = std::shared_ptr(backoff_policy(*current))]( + Options const& options, + google::cloud::cpp::compute::reliability_risks::v1:: + ListReliabilityRisksRequest const& r) { + return google::cloud::rest_internal::RestRetryLoop( + retry->clone(), backoff->clone(), idempotency, + [stub](rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reliability_risks::v1:: + ListReliabilityRisksRequest const& request) { + return stub->ListReliabilityRisks(rest_context, options, request); + }, + options, r, function_name); + }, + [](google::cloud::cpp::compute::v1::ReliabilityRisksListResponse r) { + std::vector result( + r.items().size()); + auto& messages = *r.mutable_items(); + std::move(messages.begin(), messages.end(), result.begin()); + return result; + }); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_reliability_risks_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/reliability_risks/v1/internal/reliability_risks_rest_connection_impl.h b/google/cloud/compute/reliability_risks/v1/internal/reliability_risks_rest_connection_impl.h new file mode 100644 index 0000000000000..b5c87ad2504a9 --- /dev/null +++ b/google/cloud/compute/reliability_risks/v1/internal/reliability_risks_rest_connection_impl.h @@ -0,0 +1,99 @@ +// Copyright 2026 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. +// source: google/cloud/compute/reliability_risks/v1/reliability_risks.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RELIABILITY_RISKS_V1_INTERNAL_RELIABILITY_RISKS_REST_CONNECTION_IMPL_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RELIABILITY_RISKS_V1_INTERNAL_RELIABILITY_RISKS_REST_CONNECTION_IMPL_H + +#include "google/cloud/compute/reliability_risks/v1/internal/reliability_risks_rest_stub.h" +#include "google/cloud/compute/reliability_risks/v1/internal/reliability_risks_retry_traits.h" +#include "google/cloud/compute/reliability_risks/v1/reliability_risks_connection.h" +#include "google/cloud/compute/reliability_risks/v1/reliability_risks_connection_idempotency_policy.h" +#include "google/cloud/compute/reliability_risks/v1/reliability_risks_options.h" +#include "google/cloud/background_threads.h" +#include "google/cloud/backoff_policy.h" +#include "google/cloud/options.h" +#include "google/cloud/status_or.h" +#include "google/cloud/stream_range.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_reliability_risks_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class ReliabilityRisksRestConnectionImpl + : public compute_reliability_risks_v1::ReliabilityRisksConnection { + public: + ~ReliabilityRisksRestConnectionImpl() override = default; + + ReliabilityRisksRestConnectionImpl( + std::unique_ptr background, + std::shared_ptr< + compute_reliability_risks_v1_internal::ReliabilityRisksRestStub> + stub, + Options options); + + Options options() override { return options_; } + + StatusOr GetReliabilityRisk( + google::cloud::cpp::compute::reliability_risks::v1:: + GetReliabilityRiskRequest const& request) override; + + StreamRange + ListReliabilityRisks(google::cloud::cpp::compute::reliability_risks::v1:: + ListReliabilityRisksRequest request) override; + + private: + static std::unique_ptr< + compute_reliability_risks_v1::ReliabilityRisksRetryPolicy> + retry_policy(Options const& options) { + return options + .get() + ->clone(); + } + + static std::unique_ptr backoff_policy(Options const& options) { + return options + .get< + compute_reliability_risks_v1::ReliabilityRisksBackoffPolicyOption>() + ->clone(); + } + + static std::unique_ptr< + compute_reliability_risks_v1::ReliabilityRisksConnectionIdempotencyPolicy> + idempotency_policy(Options const& options) { + return options + .get() + ->clone(); + } + + std::unique_ptr background_; + std::shared_ptr< + compute_reliability_risks_v1_internal::ReliabilityRisksRestStub> + stub_; + Options options_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_reliability_risks_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RELIABILITY_RISKS_V1_INTERNAL_RELIABILITY_RISKS_REST_CONNECTION_IMPL_H diff --git a/google/cloud/compute/reliability_risks/v1/internal/reliability_risks_rest_logging_decorator.cc b/google/cloud/compute/reliability_risks/v1/internal/reliability_risks_rest_logging_decorator.cc new file mode 100644 index 0000000000000..bb0a4b00b0a5d --- /dev/null +++ b/google/cloud/compute/reliability_risks/v1/internal/reliability_risks_rest_logging_decorator.cc @@ -0,0 +1,68 @@ +// Copyright 2026 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. +// source: google/cloud/compute/reliability_risks/v1/reliability_risks.proto + +#include "google/cloud/compute/reliability_risks/v1/internal/reliability_risks_rest_logging_decorator.h" +#include "google/cloud/internal/log_wrapper.h" +#include "google/cloud/status_or.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_reliability_risks_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +ReliabilityRisksRestLogging::ReliabilityRisksRestLogging( + std::shared_ptr child, + TracingOptions tracing_options, std::set components) + : child_(std::move(child)), + tracing_options_(std::move(tracing_options)), + components_(std::move(components)) {} + +StatusOr +ReliabilityRisksRestLogging::GetReliabilityRisk( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::reliability_risks::v1:: + GetReliabilityRiskRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::reliability_risks::v1:: + GetReliabilityRiskRequest const& request) { + return child_->GetReliabilityRisk(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +StatusOr +ReliabilityRisksRestLogging::ListReliabilityRisks( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::reliability_risks::v1:: + ListReliabilityRisksRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::reliability_risks::v1:: + ListReliabilityRisksRequest const& request) { + return child_->ListReliabilityRisks(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_reliability_risks_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/reliability_risks/v1/internal/reliability_risks_rest_logging_decorator.h b/google/cloud/compute/reliability_risks/v1/internal/reliability_risks_rest_logging_decorator.h new file mode 100644 index 0000000000000..87c40179d3b60 --- /dev/null +++ b/google/cloud/compute/reliability_risks/v1/internal/reliability_risks_rest_logging_decorator.h @@ -0,0 +1,67 @@ +// Copyright 2026 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. +// source: google/cloud/compute/reliability_risks/v1/reliability_risks.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RELIABILITY_RISKS_V1_INTERNAL_RELIABILITY_RISKS_REST_LOGGING_DECORATOR_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RELIABILITY_RISKS_V1_INTERNAL_RELIABILITY_RISKS_REST_LOGGING_DECORATOR_H + +#include "google/cloud/compute/reliability_risks/v1/internal/reliability_risks_rest_stub.h" +#include "google/cloud/compute/reliability_risks/v1/reliability_risks.pb.h" +#include "google/cloud/future.h" +#include "google/cloud/internal/rest_context.h" +#include "google/cloud/tracing_options.h" +#include "google/cloud/version.h" +#include +#include +#include + +namespace google { +namespace cloud { +namespace compute_reliability_risks_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class ReliabilityRisksRestLogging : public ReliabilityRisksRestStub { + public: + ~ReliabilityRisksRestLogging() override = default; + ReliabilityRisksRestLogging(std::shared_ptr child, + TracingOptions tracing_options, + std::set components); + + StatusOr GetReliabilityRisk( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reliability_risks::v1:: + GetReliabilityRiskRequest const& request) override; + + StatusOr + ListReliabilityRisks(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reliability_risks::v1:: + ListReliabilityRisksRequest const& request) override; + + private: + std::shared_ptr child_; + TracingOptions tracing_options_; + std::set components_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_reliability_risks_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RELIABILITY_RISKS_V1_INTERNAL_RELIABILITY_RISKS_REST_LOGGING_DECORATOR_H diff --git a/google/cloud/compute/reliability_risks/v1/internal/reliability_risks_rest_metadata_decorator.cc b/google/cloud/compute/reliability_risks/v1/internal/reliability_risks_rest_metadata_decorator.cc new file mode 100644 index 0000000000000..a99d03c1eac1b --- /dev/null +++ b/google/cloud/compute/reliability_risks/v1/internal/reliability_risks_rest_metadata_decorator.cc @@ -0,0 +1,70 @@ +// Copyright 2026 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. +// source: google/cloud/compute/reliability_risks/v1/reliability_risks.proto + +#include "google/cloud/compute/reliability_risks/v1/internal/reliability_risks_rest_metadata_decorator.h" +#include "google/cloud/internal/api_client_header.h" +#include "google/cloud/internal/rest_set_metadata.h" +#include "google/cloud/status_or.h" +#include "absl/strings/str_cat.h" +#include "absl/strings/str_format.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_reliability_risks_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +ReliabilityRisksRestMetadata::ReliabilityRisksRestMetadata( + std::shared_ptr child, + std::string api_client_header) + : child_(std::move(child)), + api_client_header_( + api_client_header.empty() + ? google::cloud::internal::GeneratedLibClientHeader() + : std::move(api_client_header)) {} + +StatusOr +ReliabilityRisksRestMetadata::GetReliabilityRisk( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::reliability_risks::v1:: + GetReliabilityRiskRequest const& request) { + SetMetadata(rest_context, options); + return child_->GetReliabilityRisk(rest_context, options, request); +} + +StatusOr +ReliabilityRisksRestMetadata::ListReliabilityRisks( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::reliability_risks::v1:: + ListReliabilityRisksRequest const& request) { + SetMetadata(rest_context, options); + return child_->ListReliabilityRisks(rest_context, options, request); +} + +void ReliabilityRisksRestMetadata::SetMetadata( + rest_internal::RestContext& rest_context, Options const& options, + std::vector const& params) { + google::cloud::rest_internal::SetMetadata(rest_context, options, params, + api_client_header_); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_reliability_risks_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/reliability_risks/v1/internal/reliability_risks_rest_metadata_decorator.h b/google/cloud/compute/reliability_risks/v1/internal/reliability_risks_rest_metadata_decorator.h new file mode 100644 index 0000000000000..bef1207a0f489 --- /dev/null +++ b/google/cloud/compute/reliability_risks/v1/internal/reliability_risks_rest_metadata_decorator.h @@ -0,0 +1,68 @@ +// Copyright 2026 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. +// source: google/cloud/compute/reliability_risks/v1/reliability_risks.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RELIABILITY_RISKS_V1_INTERNAL_RELIABILITY_RISKS_REST_METADATA_DECORATOR_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RELIABILITY_RISKS_V1_INTERNAL_RELIABILITY_RISKS_REST_METADATA_DECORATOR_H + +#include "google/cloud/compute/reliability_risks/v1/internal/reliability_risks_rest_stub.h" +#include "google/cloud/compute/reliability_risks/v1/reliability_risks.pb.h" +#include "google/cloud/future.h" +#include "google/cloud/rest_options.h" +#include "google/cloud/version.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_reliability_risks_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class ReliabilityRisksRestMetadata : public ReliabilityRisksRestStub { + public: + ~ReliabilityRisksRestMetadata() override = default; + explicit ReliabilityRisksRestMetadata( + std::shared_ptr child, + std::string api_client_header = ""); + + StatusOr GetReliabilityRisk( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reliability_risks::v1:: + GetReliabilityRiskRequest const& request) override; + + StatusOr + ListReliabilityRisks(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reliability_risks::v1:: + ListReliabilityRisksRequest const& request) override; + + private: + void SetMetadata(rest_internal::RestContext& rest_context, + Options const& options, + std::vector const& params = {}); + + std::shared_ptr child_; + std::string api_client_header_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_reliability_risks_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RELIABILITY_RISKS_V1_INTERNAL_RELIABILITY_RISKS_REST_METADATA_DECORATOR_H diff --git a/google/cloud/compute/reliability_risks/v1/internal/reliability_risks_rest_stub.cc b/google/cloud/compute/reliability_risks/v1/internal/reliability_risks_rest_stub.cc new file mode 100644 index 0000000000000..277808026909e --- /dev/null +++ b/google/cloud/compute/reliability_risks/v1/internal/reliability_risks_rest_stub.cc @@ -0,0 +1,88 @@ +// Copyright 2026 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. +// source: google/cloud/compute/reliability_risks/v1/reliability_risks.proto + +#include "google/cloud/compute/reliability_risks/v1/internal/reliability_risks_rest_stub.h" +#include "google/cloud/compute/reliability_risks/v1/reliability_risks.pb.h" +#include "google/cloud/common_options.h" +#include "google/cloud/internal/rest_stub_helpers.h" +#include "google/cloud/status_or.h" +#include "absl/strings/str_cat.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_reliability_risks_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +DefaultReliabilityRisksRestStub::DefaultReliabilityRisksRestStub( + Options options) + : service_(rest_internal::MakePooledRestClient( + options.get(), options)), + options_(std::move(options)) {} + +DefaultReliabilityRisksRestStub::DefaultReliabilityRisksRestStub( + std::shared_ptr service, Options options) + : service_(std::move(service)), options_(std::move(options)) {} + +StatusOr +DefaultReliabilityRisksRestStub::GetReliabilityRisk( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reliability_risks::v1:: + GetReliabilityRiskRequest const& request) { + std::vector> query_params; + return rest_internal::Get( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "global", "/", + "reliabilityRisks", "/", request.reliability_risk()), + std::move(query_params)); +} + +StatusOr +DefaultReliabilityRisksRestStub::ListReliabilityRisks( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reliability_risks::v1:: + ListReliabilityRisksRequest const& request) { + std::vector> query_params; + query_params.push_back({"filter", request.filter()}); + query_params.push_back( + {"max_results", std::to_string(request.max_results())}); + query_params.push_back({"order_by", request.order_by()}); + query_params.push_back({"page_token", request.page_token()}); + query_params.push_back({"return_partial_success", + (request.return_partial_success() ? "1" : "0")}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Get< + google::cloud::cpp::compute::v1::ReliabilityRisksListResponse>( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "global", "/", + "reliabilityRisks"), + std::move(query_params)); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_reliability_risks_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/reliability_risks/v1/internal/reliability_risks_rest_stub.h b/google/cloud/compute/reliability_risks/v1/internal/reliability_risks_rest_stub.h new file mode 100644 index 0000000000000..927739c388974 --- /dev/null +++ b/google/cloud/compute/reliability_risks/v1/internal/reliability_risks_rest_stub.h @@ -0,0 +1,83 @@ +// Copyright 2026 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. +// source: google/cloud/compute/reliability_risks/v1/reliability_risks.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RELIABILITY_RISKS_V1_INTERNAL_RELIABILITY_RISKS_REST_STUB_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RELIABILITY_RISKS_V1_INTERNAL_RELIABILITY_RISKS_REST_STUB_H + +#include "google/cloud/compute/reliability_risks/v1/reliability_risks.pb.h" +#include "google/cloud/completion_queue.h" +#include "google/cloud/internal/rest_client.h" +#include "google/cloud/internal/rest_context.h" +#include "google/cloud/status_or.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_reliability_risks_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class ReliabilityRisksRestStub { + public: + virtual ~ReliabilityRisksRestStub() = default; + + virtual StatusOr + GetReliabilityRisk(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reliability_risks::v1:: + GetReliabilityRiskRequest const& request) = 0; + + virtual StatusOr< + google::cloud::cpp::compute::v1::ReliabilityRisksListResponse> + ListReliabilityRisks(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reliability_risks::v1:: + ListReliabilityRisksRequest const& request) = 0; +}; + +class DefaultReliabilityRisksRestStub : public ReliabilityRisksRestStub { + public: + ~DefaultReliabilityRisksRestStub() override = default; + + explicit DefaultReliabilityRisksRestStub(Options options); + DefaultReliabilityRisksRestStub( + std::shared_ptr service, Options options); + + StatusOr GetReliabilityRisk( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reliability_risks::v1:: + GetReliabilityRiskRequest const& request) override; + + StatusOr + ListReliabilityRisks(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reliability_risks::v1:: + ListReliabilityRisksRequest const& request) override; + + private: + std::shared_ptr service_; + Options options_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_reliability_risks_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RELIABILITY_RISKS_V1_INTERNAL_RELIABILITY_RISKS_REST_STUB_H diff --git a/google/cloud/compute/reliability_risks/v1/internal/reliability_risks_rest_stub_factory.cc b/google/cloud/compute/reliability_risks/v1/internal/reliability_risks_rest_stub_factory.cc new file mode 100644 index 0000000000000..e5fab62b67d1c --- /dev/null +++ b/google/cloud/compute/reliability_risks/v1/internal/reliability_risks_rest_stub_factory.cc @@ -0,0 +1,56 @@ +// Copyright 2026 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. +// source: google/cloud/compute/reliability_risks/v1/reliability_risks.proto + +#include "google/cloud/compute/reliability_risks/v1/internal/reliability_risks_rest_stub_factory.h" +#include "google/cloud/compute/reliability_risks/v1/internal/reliability_risks_rest_logging_decorator.h" +#include "google/cloud/compute/reliability_risks/v1/internal/reliability_risks_rest_metadata_decorator.h" +#include "google/cloud/compute/reliability_risks/v1/internal/reliability_risks_rest_stub.h" +#include "google/cloud/common_options.h" +#include "google/cloud/internal/algorithm.h" +#include "google/cloud/internal/populate_rest_options.h" +#include "google/cloud/log.h" +#include "google/cloud/options.h" +#include "google/cloud/rest_options.h" +#include "absl/strings/match.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_reliability_risks_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +std::shared_ptr CreateDefaultReliabilityRisksRestStub( + Options const& options) { + auto opts = internal::PopulateRestOptions(options); + std::shared_ptr stub = + std::make_shared(std::move(opts)); + stub = std::make_shared(std::move(stub)); + if (internal::Contains(options.get(), "rpc")) { + GCP_LOG(INFO) << "Enabled logging for REST rpc calls"; + stub = std::make_shared( + std::move(stub), options.get(), + options.get()); + } + return stub; +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_reliability_risks_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/reliability_risks/v1/internal/reliability_risks_rest_stub_factory.h b/google/cloud/compute/reliability_risks/v1/internal/reliability_risks_rest_stub_factory.h new file mode 100644 index 0000000000000..ddcec31be248c --- /dev/null +++ b/google/cloud/compute/reliability_risks/v1/internal/reliability_risks_rest_stub_factory.h @@ -0,0 +1,40 @@ +// Copyright 2026 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. +// source: google/cloud/compute/reliability_risks/v1/reliability_risks.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RELIABILITY_RISKS_V1_INTERNAL_RELIABILITY_RISKS_REST_STUB_FACTORY_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RELIABILITY_RISKS_V1_INTERNAL_RELIABILITY_RISKS_REST_STUB_FACTORY_H + +#include "google/cloud/compute/reliability_risks/v1/internal/reliability_risks_rest_stub.h" +#include "google/cloud/options.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_reliability_risks_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +std::shared_ptr CreateDefaultReliabilityRisksRestStub( + Options const& options); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_reliability_risks_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RELIABILITY_RISKS_V1_INTERNAL_RELIABILITY_RISKS_REST_STUB_FACTORY_H diff --git a/google/cloud/compute/reliability_risks/v1/internal/reliability_risks_retry_traits.h b/google/cloud/compute/reliability_risks/v1/internal/reliability_risks_retry_traits.h new file mode 100644 index 0000000000000..66eec28428f39 --- /dev/null +++ b/google/cloud/compute/reliability_risks/v1/internal/reliability_risks_retry_traits.h @@ -0,0 +1,43 @@ +// Copyright 2026 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. +// source: google/cloud/compute/reliability_risks/v1/reliability_risks.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RELIABILITY_RISKS_V1_INTERNAL_RELIABILITY_RISKS_RETRY_TRAITS_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RELIABILITY_RISKS_V1_INTERNAL_RELIABILITY_RISKS_RETRY_TRAITS_H + +#include "google/cloud/status.h" +#include "google/cloud/version.h" + +namespace google { +namespace cloud { +namespace compute_reliability_risks_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/// Define the gRPC status code semantics for retrying requests. +struct ReliabilityRisksRetryTraits { + static bool IsPermanentFailure(google::cloud::Status const& status) { + return status.code() != StatusCode::kOk && + status.code() != StatusCode::kUnavailable; + } +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_reliability_risks_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RELIABILITY_RISKS_V1_INTERNAL_RELIABILITY_RISKS_RETRY_TRAITS_H diff --git a/google/cloud/compute/reliability_risks/v1/internal/reliability_risks_sources.cc b/google/cloud/compute/reliability_risks/v1/internal/reliability_risks_sources.cc new file mode 100644 index 0000000000000..ef43d2c542bc4 --- /dev/null +++ b/google/cloud/compute/reliability_risks/v1/internal/reliability_risks_sources.cc @@ -0,0 +1,31 @@ +// Copyright 2026 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. +// source: google/cloud/compute/reliability_risks/v1/reliability_risks.proto + +// NOLINTBEGIN(bugprone-suspicious-include) +#include "google/cloud/compute/reliability_risks/v1/internal/reliability_risks_option_defaults.cc" +#include "google/cloud/compute/reliability_risks/v1/internal/reliability_risks_rest_connection_impl.cc" +#include "google/cloud/compute/reliability_risks/v1/internal/reliability_risks_rest_logging_decorator.cc" +#include "google/cloud/compute/reliability_risks/v1/internal/reliability_risks_rest_metadata_decorator.cc" +#include "google/cloud/compute/reliability_risks/v1/internal/reliability_risks_rest_stub.cc" +#include "google/cloud/compute/reliability_risks/v1/internal/reliability_risks_rest_stub_factory.cc" +#include "google/cloud/compute/reliability_risks/v1/internal/reliability_risks_tracing_connection.cc" +#include "google/cloud/compute/reliability_risks/v1/reliability_risks_client.cc" +#include "google/cloud/compute/reliability_risks/v1/reliability_risks_connection.cc" +#include "google/cloud/compute/reliability_risks/v1/reliability_risks_connection_idempotency_policy.cc" +#include "google/cloud/compute/reliability_risks/v1/reliability_risks_rest_connection.cc" +// NOLINTEND(bugprone-suspicious-include) diff --git a/google/cloud/compute/reliability_risks/v1/internal/reliability_risks_tracing_connection.cc b/google/cloud/compute/reliability_risks/v1/internal/reliability_risks_tracing_connection.cc new file mode 100644 index 0000000000000..d0e7aff6d7956 --- /dev/null +++ b/google/cloud/compute/reliability_risks/v1/internal/reliability_risks_tracing_connection.cc @@ -0,0 +1,73 @@ +// Copyright 2026 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. +// source: google/cloud/compute/reliability_risks/v1/reliability_risks.proto + +#include "google/cloud/compute/reliability_risks/v1/internal/reliability_risks_tracing_connection.h" +#include "google/cloud/internal/opentelemetry.h" +#include "google/cloud/internal/traced_stream_range.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_reliability_risks_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +ReliabilityRisksTracingConnection::ReliabilityRisksTracingConnection( + std::shared_ptr + child) + : child_(std::move(child)) {} + +StatusOr +ReliabilityRisksTracingConnection::GetReliabilityRisk( + google::cloud::cpp::compute::reliability_risks::v1:: + GetReliabilityRiskRequest const& request) { + auto span = internal::MakeSpan( + "compute_reliability_risks_v1::ReliabilityRisksConnection::" + "GetReliabilityRisk"); + auto scope = opentelemetry::trace::Scope(span); + return internal::EndSpan(*span, child_->GetReliabilityRisk(request)); +} + +StreamRange +ReliabilityRisksTracingConnection::ListReliabilityRisks( + google::cloud::cpp::compute::reliability_risks::v1:: + ListReliabilityRisksRequest request) { + auto span = internal::MakeSpan( + "compute_reliability_risks_v1::ReliabilityRisksConnection::" + "ListReliabilityRisks"); + internal::OTelScope scope(span); + auto sr = child_->ListReliabilityRisks(std::move(request)); + return internal::MakeTracedStreamRange< + google::cloud::cpp::compute::v1::ReliabilityRisk>(std::move(span), + std::move(sr)); +} + +std::shared_ptr +MakeReliabilityRisksTracingConnection( + std::shared_ptr + conn) { + if (internal::TracingEnabled(conn->options())) { + conn = std::make_shared(std::move(conn)); + } + return conn; +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_reliability_risks_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/reliability_risks/v1/internal/reliability_risks_tracing_connection.h b/google/cloud/compute/reliability_risks/v1/internal/reliability_risks_tracing_connection.h new file mode 100644 index 0000000000000..d4fe4d529d385 --- /dev/null +++ b/google/cloud/compute/reliability_risks/v1/internal/reliability_risks_tracing_connection.h @@ -0,0 +1,71 @@ +// Copyright 2026 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. +// source: google/cloud/compute/reliability_risks/v1/reliability_risks.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RELIABILITY_RISKS_V1_INTERNAL_RELIABILITY_RISKS_TRACING_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RELIABILITY_RISKS_V1_INTERNAL_RELIABILITY_RISKS_TRACING_CONNECTION_H + +#include "google/cloud/compute/reliability_risks/v1/reliability_risks_connection.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_reliability_risks_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class ReliabilityRisksTracingConnection + : public compute_reliability_risks_v1::ReliabilityRisksConnection { + public: + ~ReliabilityRisksTracingConnection() override = default; + + explicit ReliabilityRisksTracingConnection( + std::shared_ptr + child); + + Options options() override { return child_->options(); } + + StatusOr GetReliabilityRisk( + google::cloud::cpp::compute::reliability_risks::v1:: + GetReliabilityRiskRequest const& request) override; + + StreamRange + ListReliabilityRisks(google::cloud::cpp::compute::reliability_risks::v1:: + ListReliabilityRisksRequest request) override; + + private: + std::shared_ptr + child_; +}; + +/** + * Conditionally applies the tracing decorator to the given connection. + * + * The connection is only decorated if tracing is enabled (as determined by the + * connection's options). + */ +std::shared_ptr +MakeReliabilityRisksTracingConnection( + std::shared_ptr + conn); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_reliability_risks_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RELIABILITY_RISKS_V1_INTERNAL_RELIABILITY_RISKS_TRACING_CONNECTION_H diff --git a/google/cloud/compute/reliability_risks/v1/mocks/mock_reliability_risks_connection.h b/google/cloud/compute/reliability_risks/v1/mocks/mock_reliability_risks_connection.h new file mode 100644 index 0000000000000..a9185cd1d45bb --- /dev/null +++ b/google/cloud/compute/reliability_risks/v1/mocks/mock_reliability_risks_connection.h @@ -0,0 +1,68 @@ +// Copyright 2026 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. +// source: google/cloud/compute/reliability_risks/v1/reliability_risks.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RELIABILITY_RISKS_V1_MOCKS_MOCK_RELIABILITY_RISKS_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RELIABILITY_RISKS_V1_MOCKS_MOCK_RELIABILITY_RISKS_CONNECTION_H + +#include "google/cloud/compute/reliability_risks/v1/reliability_risks_connection.h" +#include + +namespace google { +namespace cloud { +namespace compute_reliability_risks_v1_mocks { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/** + * A class to mock `ReliabilityRisksConnection`. + * + * Application developers may want to test their code with simulated responses, + * including errors, from an object of type `ReliabilityRisksClient`. To do so, + * construct an object of type `ReliabilityRisksClient` with an instance of this + * class. Then use the Google Test framework functions to program the behavior + * of this mock. + * + * @see [This example][bq-mock] for how to test your application with GoogleTest. + * While the example showcases types from the BigQuery library, the underlying + * principles apply for any pair of `*Client` and `*Connection`. + * + * [bq-mock]: @cloud_cpp_docs_link{bigquery,bigquery-read-mock} + */ +class MockReliabilityRisksConnection + : public compute_reliability_risks_v1::ReliabilityRisksConnection { + public: + MOCK_METHOD(Options, options, (), (override)); + + MOCK_METHOD(StatusOr, + GetReliabilityRisk, + (google::cloud::cpp::compute::reliability_risks::v1:: + GetReliabilityRiskRequest const& request), + (override)); + + MOCK_METHOD((StreamRange), + ListReliabilityRisks, + (google::cloud::cpp::compute::reliability_risks::v1:: + ListReliabilityRisksRequest request), + (override)); +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_reliability_risks_v1_mocks +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RELIABILITY_RISKS_V1_MOCKS_MOCK_RELIABILITY_RISKS_CONNECTION_H diff --git a/google/cloud/compute/reliability_risks/v1/reliability_risks_client.cc b/google/cloud/compute/reliability_risks/v1/reliability_risks_client.cc new file mode 100644 index 0000000000000..62a965ef51088 --- /dev/null +++ b/google/cloud/compute/reliability_risks/v1/reliability_risks_client.cc @@ -0,0 +1,78 @@ +// Copyright 2026 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. +// source: google/cloud/compute/reliability_risks/v1/reliability_risks.proto + +#include "google/cloud/compute/reliability_risks/v1/reliability_risks_client.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_reliability_risks_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +ReliabilityRisksClient::ReliabilityRisksClient( + std::shared_ptr connection, Options opts) + : connection_(std::move(connection)), + options_( + internal::MergeOptions(std::move(opts), connection_->options())) {} +ReliabilityRisksClient::~ReliabilityRisksClient() = default; + +StatusOr +ReliabilityRisksClient::GetReliabilityRisk(std::string const& project, + std::string const& reliability_risk, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::reliability_risks::v1::GetReliabilityRiskRequest + request; + request.set_project(project); + request.set_reliability_risk(reliability_risk); + return connection_->GetReliabilityRisk(request); +} + +StatusOr +ReliabilityRisksClient::GetReliabilityRisk( + google::cloud::cpp::compute::reliability_risks::v1:: + GetReliabilityRiskRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->GetReliabilityRisk(request); +} + +StreamRange +ReliabilityRisksClient::ListReliabilityRisks(std::string const& project, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::reliability_risks::v1:: + ListReliabilityRisksRequest request; + request.set_project(project); + return connection_->ListReliabilityRisks(request); +} + +StreamRange +ReliabilityRisksClient::ListReliabilityRisks( + google::cloud::cpp::compute::reliability_risks::v1:: + ListReliabilityRisksRequest request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->ListReliabilityRisks(std::move(request)); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_reliability_risks_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/reliability_risks/v1/reliability_risks_client.h b/google/cloud/compute/reliability_risks/v1/reliability_risks_client.h new file mode 100644 index 0000000000000..76e85516cfde9 --- /dev/null +++ b/google/cloud/compute/reliability_risks/v1/reliability_risks_client.h @@ -0,0 +1,238 @@ +// Copyright 2026 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. +// source: google/cloud/compute/reliability_risks/v1/reliability_risks.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RELIABILITY_RISKS_V1_RELIABILITY_RISKS_CLIENT_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RELIABILITY_RISKS_V1_RELIABILITY_RISKS_CLIENT_H + +#include "google/cloud/compute/reliability_risks/v1/reliability_risks_rest_connection.h" +#include "google/cloud/future.h" +#include "google/cloud/options.h" +#include "google/cloud/polling_policy.h" +#include "google/cloud/status_or.h" +#include "google/cloud/version.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_reliability_risks_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/// +/// Service for the reliabilityRisks resource. +/// https://cloud.google.com/compute/docs/reference/rest/v1/reliabilityRisks +/// +/// @par Equality +/// +/// Instances of this class created via copy-construction or copy-assignment +/// always compare equal. Instances created with equal +/// `std::shared_ptr<*Connection>` objects compare equal. Objects that compare +/// equal share the same underlying resources. +/// +/// @par Performance +/// +/// Creating a new instance of this class is a relatively expensive operation, +/// new objects establish new connections to the service. In contrast, +/// copy-construction, move-construction, and the corresponding assignment +/// operations are relatively efficient as the copies share all underlying +/// resources. +/// +/// @par Thread Safety +/// +/// Concurrent access to different instances of this class, even if they compare +/// equal, is guaranteed to work. Two or more threads operating on the same +/// instance of this class is not guaranteed to work. Since copy-construction +/// and move-construction is a relatively efficient operation, consider using +/// such a copy when using this class from multiple threads. +/// +class ReliabilityRisksClient { + public: + explicit ReliabilityRisksClient( + std::shared_ptr connection, + Options opts = {}); + ~ReliabilityRisksClient(); + + ///@{ + /// @name Copy and move support + ReliabilityRisksClient(ReliabilityRisksClient const&) = default; + ReliabilityRisksClient& operator=(ReliabilityRisksClient const&) = default; + ReliabilityRisksClient(ReliabilityRisksClient&&) = default; + ReliabilityRisksClient& operator=(ReliabilityRisksClient&&) = default; + ///@} + + ///@{ + /// @name Equality + friend bool operator==(ReliabilityRisksClient const& a, + ReliabilityRisksClient const& b) { + return a.connection_ == b.connection_; + } + friend bool operator!=(ReliabilityRisksClient const& a, + ReliabilityRisksClient const& b) { + return !(a == b); + } + ///@} + + // clang-format off + /// + /// Returns the specified ReliabilityRisk resource. + /// https://cloud.google.com/compute/docs/reference/rest/v1/reliabilityRisks/get + /// + /// @param project Project ID for this request. + /// @param reliability_risk Name of the ReliabilityRisk resource to return. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.ReliabilityRisk]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.reliability_risks.v1.GetReliabilityRiskRequest]: @cloud_cpp_reference_link{google/cloud/compute/reliability_risks/v1/reliability_risks.proto#L60} + /// [google.cloud.cpp.compute.v1.ReliabilityRisk]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_130.proto#L25} + /// + // clang-format on + StatusOr GetReliabilityRisk( + std::string const& project, std::string const& reliability_risk, + Options opts = {}); + + // clang-format off + /// + /// Returns the specified ReliabilityRisk resource. + /// https://cloud.google.com/compute/docs/reference/rest/v1/reliabilityRisks/get + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.reliability_risks.v1.GetReliabilityRiskRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.ReliabilityRisk]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.reliability_risks.v1.GetReliabilityRiskRequest]: @cloud_cpp_reference_link{google/cloud/compute/reliability_risks/v1/reliability_risks.proto#L60} + /// [google.cloud.cpp.compute.v1.ReliabilityRisk]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_130.proto#L25} + /// + // clang-format on + StatusOr GetReliabilityRisk( + google::cloud::cpp::compute::reliability_risks::v1:: + GetReliabilityRiskRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// Retrieves the list of reliabilityRisks available in the specified project. + /// https://cloud.google.com/compute/docs/reference/rest/v1/reliabilityRisks/list + /// + /// @param project Project ID for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return a [StreamRange](@ref google::cloud::StreamRange) + /// to iterate of the results. See the documentation of this type for + /// details. In brief, this class has `begin()` and `end()` member + /// functions returning a iterator class meeting the + /// [input iterator requirements]. The value type for this iterator is a + /// [`StatusOr`] as the iteration may fail even after some values are + /// retrieved successfully, for example, if there is a network disconnect. + /// An empty set of results does not indicate an error, it indicates + /// that there are no resources meeting the request criteria. + /// On a successful iteration the `StatusOr` contains elements of type + /// [google.cloud.cpp.compute.v1.ReliabilityRisk], or rather, + /// the C++ class generated by Protobuf from that type. Please consult the + /// Protobuf documentation for details on the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.reliability_risks.v1.ListReliabilityRisksRequest]: @cloud_cpp_reference_link{google/cloud/compute/reliability_risks/v1/reliability_risks.proto#L71} + /// [google.cloud.cpp.compute.v1.ReliabilityRisk]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_130.proto#L25} + /// + // clang-format on + StreamRange + ListReliabilityRisks(std::string const& project, Options opts = {}); + + // clang-format off + /// + /// Retrieves the list of reliabilityRisks available in the specified project. + /// https://cloud.google.com/compute/docs/reference/rest/v1/reliabilityRisks/list + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.reliability_risks.v1.ListReliabilityRisksRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return a [StreamRange](@ref google::cloud::StreamRange) + /// to iterate of the results. See the documentation of this type for + /// details. In brief, this class has `begin()` and `end()` member + /// functions returning a iterator class meeting the + /// [input iterator requirements]. The value type for this iterator is a + /// [`StatusOr`] as the iteration may fail even after some values are + /// retrieved successfully, for example, if there is a network disconnect. + /// An empty set of results does not indicate an error, it indicates + /// that there are no resources meeting the request criteria. + /// On a successful iteration the `StatusOr` contains elements of type + /// [google.cloud.cpp.compute.v1.ReliabilityRisk], or rather, + /// the C++ class generated by Protobuf from that type. Please consult the + /// Protobuf documentation for details on the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.reliability_risks.v1.ListReliabilityRisksRequest]: @cloud_cpp_reference_link{google/cloud/compute/reliability_risks/v1/reliability_risks.proto#L71} + /// [google.cloud.cpp.compute.v1.ReliabilityRisk]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_130.proto#L25} + /// + // clang-format on + StreamRange + ListReliabilityRisks(google::cloud::cpp::compute::reliability_risks::v1:: + ListReliabilityRisksRequest request, + Options opts = {}); + + private: + std::shared_ptr connection_; + Options options_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_reliability_risks_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RELIABILITY_RISKS_V1_RELIABILITY_RISKS_CLIENT_H diff --git a/google/cloud/compute/reliability_risks/v1/reliability_risks_connection.cc b/google/cloud/compute/reliability_risks/v1/reliability_risks_connection.cc new file mode 100644 index 0000000000000..79445058fa949 --- /dev/null +++ b/google/cloud/compute/reliability_risks/v1/reliability_risks_connection.cc @@ -0,0 +1,57 @@ +// Copyright 2026 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. +// source: google/cloud/compute/reliability_risks/v1/reliability_risks.proto + +#include "google/cloud/compute/reliability_risks/v1/reliability_risks_connection.h" +#include "google/cloud/compute/reliability_risks/v1/internal/reliability_risks_option_defaults.h" +#include "google/cloud/compute/reliability_risks/v1/internal/reliability_risks_tracing_connection.h" +#include "google/cloud/compute/reliability_risks/v1/reliability_risks_options.h" +#include "google/cloud/background_threads.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/grpc_options.h" +#include "google/cloud/internal/pagination_range.h" +#include "google/cloud/internal/unified_grpc_credentials.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_reliability_risks_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +ReliabilityRisksConnection::~ReliabilityRisksConnection() = default; + +StatusOr +ReliabilityRisksConnection::GetReliabilityRisk( + google::cloud::cpp::compute::reliability_risks::v1:: + GetReliabilityRiskRequest const&) { + return Status(StatusCode::kUnimplemented, "not implemented"); +} + +StreamRange +ReliabilityRisksConnection::ListReliabilityRisks( + google::cloud::cpp::compute::reliability_risks::v1:: + ListReliabilityRisksRequest) { // NOLINT(performance-unnecessary-value-param) + return google::cloud::internal::MakeUnimplementedPaginationRange< + StreamRange>(); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_reliability_risks_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/reliability_risks/v1/reliability_risks_connection.h b/google/cloud/compute/reliability_risks/v1/reliability_risks_connection.h new file mode 100644 index 0000000000000..834a330b0c5bd --- /dev/null +++ b/google/cloud/compute/reliability_risks/v1/reliability_risks_connection.h @@ -0,0 +1,201 @@ +// Copyright 2026 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. +// source: google/cloud/compute/reliability_risks/v1/reliability_risks.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RELIABILITY_RISKS_V1_RELIABILITY_RISKS_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RELIABILITY_RISKS_V1_RELIABILITY_RISKS_CONNECTION_H + +#include "google/cloud/compute/reliability_risks/v1/internal/reliability_risks_retry_traits.h" +#include "google/cloud/compute/reliability_risks/v1/reliability_risks.pb.h" +#include "google/cloud/compute/reliability_risks/v1/reliability_risks_connection_idempotency_policy.h" +#include "google/cloud/backoff_policy.h" +#include "google/cloud/internal/retry_policy_impl.h" +#include "google/cloud/options.h" +#include "google/cloud/status_or.h" +#include "google/cloud/stream_range.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_reliability_risks_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/// The retry policy for `ReliabilityRisksConnection`. +class ReliabilityRisksRetryPolicy : public ::google::cloud::RetryPolicy { + public: + /// Creates a new instance of the policy, reset to the initial state. + virtual std::unique_ptr clone() const = 0; +}; + +/** + * A retry policy for `ReliabilityRisksConnection` based on counting errors. + * + * This policy stops retrying if: + * - An RPC returns a non-transient error. + * - More than a prescribed number of transient failures is detected. + * + * In this class the following status codes are treated as transient errors: + * - [`kUnavailable`](@ref google::cloud::StatusCode) + */ +class ReliabilityRisksLimitedErrorCountRetryPolicy + : public ReliabilityRisksRetryPolicy { + public: + /** + * Create an instance that tolerates up to @p maximum_failures transient + * errors. + * + * @note Disable the retry loop by providing an instance of this policy with + * @p maximum_failures == 0. + */ + explicit ReliabilityRisksLimitedErrorCountRetryPolicy(int maximum_failures) + : impl_(maximum_failures) {} + + ReliabilityRisksLimitedErrorCountRetryPolicy( + ReliabilityRisksLimitedErrorCountRetryPolicy&& rhs) noexcept + : ReliabilityRisksLimitedErrorCountRetryPolicy(rhs.maximum_failures()) {} + ReliabilityRisksLimitedErrorCountRetryPolicy( + ReliabilityRisksLimitedErrorCountRetryPolicy const& rhs) noexcept + : ReliabilityRisksLimitedErrorCountRetryPolicy(rhs.maximum_failures()) {} + + int maximum_failures() const { return impl_.maximum_failures(); } + + bool OnFailure(Status const& status) override { + return impl_.OnFailure(status); + } + bool IsExhausted() const override { return impl_.IsExhausted(); } + bool IsPermanentFailure(Status const& status) const override { + return impl_.IsPermanentFailure(status); + } + std::unique_ptr clone() const override { + return std::make_unique( + maximum_failures()); + } + + // This is provided only for backwards compatibility. + using BaseType = ReliabilityRisksRetryPolicy; + + private: + google::cloud::internal::LimitedErrorCountRetryPolicy< + compute_reliability_risks_v1_internal::ReliabilityRisksRetryTraits> + impl_; +}; + +/** + * A retry policy for `ReliabilityRisksConnection` based on elapsed time. + * + * This policy stops retrying if: + * - An RPC returns a non-transient error. + * - The elapsed time in the retry loop exceeds a prescribed duration. + * + * In this class the following status codes are treated as transient errors: + * - [`kUnavailable`](@ref google::cloud::StatusCode) + */ +class ReliabilityRisksLimitedTimeRetryPolicy + : public ReliabilityRisksRetryPolicy { + public: + /** + * Constructor given a `std::chrono::duration<>` object. + * + * @tparam DurationRep a placeholder to match the `Rep` tparam for @p + * duration's type. The semantics of this template parameter are + * documented in `std::chrono::duration<>`. In brief, the underlying + * arithmetic type used to store the number of ticks. For our purposes it + * is simply a formal parameter. + * @tparam DurationPeriod a placeholder to match the `Period` tparam for @p + * duration's type. The semantics of this template parameter are + * documented in `std::chrono::duration<>`. In brief, the length of the + * tick in seconds, expressed as a `std::ratio<>`. For our purposes it is + * simply a formal parameter. + * @param maximum_duration the maximum time allowed before the policy expires. + * While the application can express this time in any units they desire, + * the class truncates to milliseconds. + * + * @see https://en.cppreference.com/w/cpp/chrono/duration for more information + * about `std::chrono::duration`. + */ + template + explicit ReliabilityRisksLimitedTimeRetryPolicy( + std::chrono::duration maximum_duration) + : impl_(maximum_duration) {} + + ReliabilityRisksLimitedTimeRetryPolicy( + ReliabilityRisksLimitedTimeRetryPolicy&& rhs) noexcept + : ReliabilityRisksLimitedTimeRetryPolicy(rhs.maximum_duration()) {} + ReliabilityRisksLimitedTimeRetryPolicy( + ReliabilityRisksLimitedTimeRetryPolicy const& rhs) noexcept + : ReliabilityRisksLimitedTimeRetryPolicy(rhs.maximum_duration()) {} + + std::chrono::milliseconds maximum_duration() const { + return impl_.maximum_duration(); + } + + bool OnFailure(Status const& status) override { + return impl_.OnFailure(status); + } + bool IsExhausted() const override { return impl_.IsExhausted(); } + bool IsPermanentFailure(Status const& status) const override { + return impl_.IsPermanentFailure(status); + } + std::unique_ptr clone() const override { + return std::make_unique( + maximum_duration()); + } + + // This is provided only for backwards compatibility. + using BaseType = ReliabilityRisksRetryPolicy; + + private: + google::cloud::internal::LimitedTimeRetryPolicy< + compute_reliability_risks_v1_internal::ReliabilityRisksRetryTraits> + impl_; +}; + +/** + * The `ReliabilityRisksConnection` object for `ReliabilityRisksClient`. + * + * This interface defines virtual methods for each of the user-facing overload + * sets in `ReliabilityRisksClient`. This allows users to inject custom behavior + * (e.g., with a Google Mock object) when writing tests that use objects of type + * `ReliabilityRisksClient`. + * + * To create a concrete instance, see `MakeReliabilityRisksConnection()`. + * + * For mocking, see + * `compute_reliability_risks_v1_mocks::MockReliabilityRisksConnection`. + */ +class ReliabilityRisksConnection { + public: + virtual ~ReliabilityRisksConnection() = 0; + + virtual Options options() { return Options{}; } + + virtual StatusOr + GetReliabilityRisk(google::cloud::cpp::compute::reliability_risks::v1:: + GetReliabilityRiskRequest const& request); + + virtual StreamRange + ListReliabilityRisks(google::cloud::cpp::compute::reliability_risks::v1:: + ListReliabilityRisksRequest request); +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_reliability_risks_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RELIABILITY_RISKS_V1_RELIABILITY_RISKS_CONNECTION_H diff --git a/google/cloud/compute/reliability_risks/v1/reliability_risks_connection_idempotency_policy.cc b/google/cloud/compute/reliability_risks/v1/reliability_risks_connection_idempotency_policy.cc new file mode 100644 index 0000000000000..5685039570220 --- /dev/null +++ b/google/cloud/compute/reliability_risks/v1/reliability_risks_connection_idempotency_policy.cc @@ -0,0 +1,57 @@ +// Copyright 2026 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. +// source: google/cloud/compute/reliability_risks/v1/reliability_risks.proto + +#include "google/cloud/compute/reliability_risks/v1/reliability_risks_connection_idempotency_policy.h" +#include + +namespace google { +namespace cloud { +namespace compute_reliability_risks_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +using ::google::cloud::Idempotency; + +ReliabilityRisksConnectionIdempotencyPolicy:: + ~ReliabilityRisksConnectionIdempotencyPolicy() = default; + +std::unique_ptr +ReliabilityRisksConnectionIdempotencyPolicy::clone() const { + return std::make_unique(*this); +} + +Idempotency ReliabilityRisksConnectionIdempotencyPolicy::GetReliabilityRisk( + google::cloud::cpp::compute::reliability_risks::v1:: + GetReliabilityRiskRequest const&) { + return Idempotency::kIdempotent; +} + +Idempotency ReliabilityRisksConnectionIdempotencyPolicy::ListReliabilityRisks( + google::cloud::cpp::compute::reliability_risks::v1:: + ListReliabilityRisksRequest) { // NOLINT + return Idempotency::kIdempotent; +} + +std::unique_ptr +MakeDefaultReliabilityRisksConnectionIdempotencyPolicy() { + return std::make_unique(); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_reliability_risks_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/reliability_risks/v1/reliability_risks_connection_idempotency_policy.h b/google/cloud/compute/reliability_risks/v1/reliability_risks_connection_idempotency_policy.h new file mode 100644 index 0000000000000..86080f79190bd --- /dev/null +++ b/google/cloud/compute/reliability_risks/v1/reliability_risks_connection_idempotency_policy.h @@ -0,0 +1,57 @@ +// Copyright 2026 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. +// source: google/cloud/compute/reliability_risks/v1/reliability_risks.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RELIABILITY_RISKS_V1_RELIABILITY_RISKS_CONNECTION_IDEMPOTENCY_POLICY_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RELIABILITY_RISKS_V1_RELIABILITY_RISKS_CONNECTION_IDEMPOTENCY_POLICY_H + +#include "google/cloud/compute/reliability_risks/v1/reliability_risks.pb.h" +#include "google/cloud/idempotency.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_reliability_risks_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class ReliabilityRisksConnectionIdempotencyPolicy { + public: + virtual ~ReliabilityRisksConnectionIdempotencyPolicy(); + + /// Create a new copy of this object. + virtual std::unique_ptr clone() + const; + + virtual google::cloud::Idempotency GetReliabilityRisk( + google::cloud::cpp::compute::reliability_risks::v1:: + GetReliabilityRiskRequest const& request); + + virtual google::cloud::Idempotency ListReliabilityRisks( + google::cloud::cpp::compute::reliability_risks::v1:: + ListReliabilityRisksRequest request); +}; + +std::unique_ptr +MakeDefaultReliabilityRisksConnectionIdempotencyPolicy(); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_reliability_risks_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RELIABILITY_RISKS_V1_RELIABILITY_RISKS_CONNECTION_IDEMPOTENCY_POLICY_H diff --git a/google/cloud/compute/reliability_risks/v1/reliability_risks_options.h b/google/cloud/compute/reliability_risks/v1/reliability_risks_options.h new file mode 100644 index 0000000000000..92492cc0dfc5e --- /dev/null +++ b/google/cloud/compute/reliability_risks/v1/reliability_risks_options.h @@ -0,0 +1,76 @@ +// Copyright 2026 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. +// source: google/cloud/compute/reliability_risks/v1/reliability_risks.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RELIABILITY_RISKS_V1_RELIABILITY_RISKS_OPTIONS_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RELIABILITY_RISKS_V1_RELIABILITY_RISKS_OPTIONS_H + +#include "google/cloud/compute/reliability_risks/v1/reliability_risks_connection.h" +#include "google/cloud/compute/reliability_risks/v1/reliability_risks_connection_idempotency_policy.h" +#include "google/cloud/backoff_policy.h" +#include "google/cloud/options.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_reliability_risks_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/** + * Use with `google::cloud::Options` to configure the retry policy. + * + * @ingroup google-cloud-compute-options + */ +struct ReliabilityRisksRetryPolicyOption { + using Type = std::shared_ptr; +}; + +/** + * Use with `google::cloud::Options` to configure the backoff policy. + * + * @ingroup google-cloud-compute-options + */ +struct ReliabilityRisksBackoffPolicyOption { + using Type = std::shared_ptr; +}; + +/** + * Use with `google::cloud::Options` to configure which operations are retried. + * + * @ingroup google-cloud-compute-options + */ +struct ReliabilityRisksConnectionIdempotencyPolicyOption { + using Type = std::shared_ptr; +}; + +/** + * The options applicable to ReliabilityRisks. + * + * @ingroup google-cloud-compute-options + */ +using ReliabilityRisksPolicyOptionList = + OptionList; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_reliability_risks_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RELIABILITY_RISKS_V1_RELIABILITY_RISKS_OPTIONS_H diff --git a/google/cloud/compute/reliability_risks/v1/reliability_risks_proto_export.h b/google/cloud/compute/reliability_risks/v1/reliability_risks_proto_export.h new file mode 100644 index 0000000000000..911db96663d88 --- /dev/null +++ b/google/cloud/compute/reliability_risks/v1/reliability_risks_proto_export.h @@ -0,0 +1,32 @@ +// Copyright 2026 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_RELIABILITY_RISKS_V1_RELIABILITY_RISKS_PROTO_EXPORT_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RELIABILITY_RISKS_V1_RELIABILITY_RISKS_PROTO_EXPORT_H + +// IWYU pragma: begin_exports +#include "google/cloud/compute/v1/internal/common_130.pb.h" +// IWYU pragma: end_exports + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RELIABILITY_RISKS_V1_RELIABILITY_RISKS_PROTO_EXPORT_H diff --git a/google/cloud/compute/reliability_risks/v1/reliability_risks_rest_connection.cc b/google/cloud/compute/reliability_risks/v1/reliability_risks_rest_connection.cc new file mode 100644 index 0000000000000..647623b17cc9a --- /dev/null +++ b/google/cloud/compute/reliability_risks/v1/reliability_risks_rest_connection.cc @@ -0,0 +1,60 @@ +// Copyright 2026 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. +// source: google/cloud/compute/reliability_risks/v1/reliability_risks.proto + +#include "google/cloud/compute/reliability_risks/v1/reliability_risks_rest_connection.h" +#include "google/cloud/compute/reliability_risks/v1/internal/reliability_risks_option_defaults.h" +#include "google/cloud/compute/reliability_risks/v1/internal/reliability_risks_rest_connection_impl.h" +#include "google/cloud/compute/reliability_risks/v1/internal/reliability_risks_rest_stub_factory.h" +#include "google/cloud/compute/reliability_risks/v1/internal/reliability_risks_tracing_connection.h" +#include "google/cloud/compute/reliability_risks/v1/reliability_risks_options.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/internal/rest_background_threads_impl.h" +#include "google/cloud/internal/rest_options.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_reliability_risks_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +std::shared_ptr MakeReliabilityRisksConnectionRest( + Options options) { + internal::CheckExpectedOptions< + CommonOptionList, RestOptionList, UnifiedCredentialsOptionList, + rest_internal::TargetApiVersionOption, ReliabilityRisksPolicyOptionList>( + options, __func__); + options = + compute_reliability_risks_v1_internal::ReliabilityRisksDefaultOptions( + std::move(options)); + auto background = std::make_unique< + rest_internal::AutomaticallyCreatedRestBackgroundThreads>(); + auto stub = compute_reliability_risks_v1_internal:: + CreateDefaultReliabilityRisksRestStub(options); + return compute_reliability_risks_v1_internal:: + MakeReliabilityRisksTracingConnection( + std::make_shared( + std::move(background), std::move(stub), std::move(options))); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_reliability_risks_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/reliability_risks/v1/reliability_risks_rest_connection.h b/google/cloud/compute/reliability_risks/v1/reliability_risks_rest_connection.h new file mode 100644 index 0000000000000..2f8ae2d0230c2 --- /dev/null +++ b/google/cloud/compute/reliability_risks/v1/reliability_risks_rest_connection.h @@ -0,0 +1,65 @@ +// Copyright 2026 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. +// source: google/cloud/compute/reliability_risks/v1/reliability_risks.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RELIABILITY_RISKS_V1_RELIABILITY_RISKS_REST_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RELIABILITY_RISKS_V1_RELIABILITY_RISKS_REST_CONNECTION_H + +#include "google/cloud/compute/reliability_risks/v1/reliability_risks_connection.h" +#include "google/cloud/options.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_reliability_risks_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/** + * A factory function to construct an object of type + * `ReliabilityRisksConnection` that uses REST over HTTP as transport in lieu of + * gRPC. REST transport should only be used for services that do not support + * gRPC or if the existing network configuration precludes using gRPC. + * + * The returned connection object should not be used directly; instead it + * should be passed as an argument to the constructor of ReliabilityRisksClient. + * + * The optional @p options argument may be used to configure aspects of the + * returned `ReliabilityRisksConnection`. Expected options are any of the types + * in the following option lists: + * + * - `google::cloud::CommonOptionList` + * - `google::cloud::RestOptionList` + * - `google::cloud::UnifiedCredentialsOptionList` + * - + * `google::cloud::compute_reliability_risks_v1::ReliabilityRisksPolicyOptionList` + * + * @note Unexpected options will be ignored. To log unexpected options instead, + * set `GOOGLE_CLOUD_CPP_ENABLE_CLOG=yes` in the environment. + * + * @param options (optional) Configure the `ReliabilityRisksConnection` created + * by this function. + */ +std::shared_ptr MakeReliabilityRisksConnectionRest( + Options options = {}); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_reliability_risks_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RELIABILITY_RISKS_V1_RELIABILITY_RISKS_REST_CONNECTION_H diff --git a/google/cloud/compute/reliability_risks/v1/samples/reliability_risks_client_samples.cc b/google/cloud/compute/reliability_risks/v1/samples/reliability_risks_client_samples.cc new file mode 100644 index 0000000000000..ecb306ebbfbf7 --- /dev/null +++ b/google/cloud/compute/reliability_risks/v1/samples/reliability_risks_client_samples.cc @@ -0,0 +1,191 @@ +// Copyright 2026 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. +// source: google/cloud/compute/reliability_risks/v1/reliability_risks.proto + +#include "google/cloud/compute/reliability_risks/v1/reliability_risks_client.h" +#include "google/cloud/compute/reliability_risks/v1/reliability_risks_connection_idempotency_policy.h" +#include "google/cloud/compute/reliability_risks/v1/reliability_risks_options.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/internal/getenv.h" +#include "google/cloud/testing_util/example_driver.h" +#include "google/cloud/universe_domain.h" +#include +#include +#include +#include + +// clang-format off +// main-dox-marker: compute_reliability_risks_v1::ReliabilityRisksClient +// clang-format on +namespace { + +void SetClientEndpoint(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-endpoint"}; + } + //! [set-client-endpoint] + // This configuration is common with Private Google Access: + // https://cloud.google.com/vpc/docs/private-google-access + auto options = google::cloud::Options{}.set( + "private.googleapis.com"); + auto vpc_client = + google::cloud::compute_reliability_risks_v1::ReliabilityRisksClient( + google::cloud::compute_reliability_risks_v1:: + MakeReliabilityRisksConnectionRest(options)); + //! [set-client-endpoint] +} + +void SetClientUniverseDomain(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-universe-domain"}; + } + //! [set-client-universe-domain] + google::cloud::Options options; + + // AddUniverseDomainOption interrogates the UnifiedCredentialsOption, if set, + // in the provided Options for the Universe Domain associated with the + // credentials and adds it to the set of Options. + // If no UnifiedCredentialsOption is set, GoogleDefaultCredentials are used. + auto ud_options = google::cloud::AddUniverseDomainOption(std::move(options)); + + if (!ud_options.ok()) throw std::move(ud_options).status(); + auto ud_client = + google::cloud::compute_reliability_risks_v1::ReliabilityRisksClient( + google::cloud::compute_reliability_risks_v1:: + MakeReliabilityRisksConnectionRest(*ud_options)); + //! [set-client-universe-domain] +} + +//! [custom-idempotency-policy] +class CustomIdempotencyPolicy + : public google::cloud::compute_reliability_risks_v1:: + ReliabilityRisksConnectionIdempotencyPolicy { + public: + ~CustomIdempotencyPolicy() override = default; + std::unique_ptr + clone() const override { + return std::make_unique(*this); + } + // Override inherited functions to define as needed. +}; +//! [custom-idempotency-policy] + +void SetRetryPolicy(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-retry-policy"}; + } + //! [set-retry-policy] + auto options = + google::cloud::Options{} + .set( + CustomIdempotencyPolicy().clone()) + .set( + google::cloud::compute_reliability_risks_v1:: + ReliabilityRisksLimitedErrorCountRetryPolicy(3) + .clone()) + .set( + google::cloud::ExponentialBackoffPolicy( + /*initial_delay=*/std::chrono::milliseconds(200), + /*maximum_delay=*/std::chrono::seconds(45), + /*scaling=*/2.0) + .clone()); + auto connection = google::cloud::compute_reliability_risks_v1:: + MakeReliabilityRisksConnectionRest(options); + + // c1 and c2 share the same retry policies + auto c1 = google::cloud::compute_reliability_risks_v1::ReliabilityRisksClient( + connection); + auto c2 = google::cloud::compute_reliability_risks_v1::ReliabilityRisksClient( + connection); + + // You can override any of the policies in a new client. This new client + // will share the policies from c1 (or c2) *except* for the retry policy. + auto c3 = google::cloud::compute_reliability_risks_v1::ReliabilityRisksClient( + connection, google::cloud::Options{} + .set( + google::cloud::compute_reliability_risks_v1:: + ReliabilityRisksLimitedTimeRetryPolicy( + std::chrono::minutes(5)) + .clone())); + + // You can also override the policies in a single call: + // c3.SomeRpc(..., google::cloud::Options{} + // .set( + // google::cloud::compute_reliability_risks_v1::ReliabilityRisksLimitedErrorCountRetryPolicy(10).clone())); + //! [set-retry-policy] +} + +void WithServiceAccount(std::vector const& argv) { + if (argv.size() != 1 || argv[0] == "--help") { + throw google::cloud::testing_util::Usage{"with-service-account "}; + } + //! [with-service-account] + [](std::string const& keyfile) { + auto is = std::ifstream(keyfile); + is.exceptions(std::ios::badbit); // Minimal error handling in examples + auto contents = std::string(std::istreambuf_iterator(is.rdbuf()), {}); + auto options = + google::cloud::Options{}.set( + google::cloud::MakeServiceAccountCredentials(contents)); + return google::cloud::compute_reliability_risks_v1::ReliabilityRisksClient( + google::cloud::compute_reliability_risks_v1:: + MakeReliabilityRisksConnectionRest(options)); + } + //! [with-service-account] + (argv.at(0)); +} + +void AutoRun(std::vector const& argv) { + namespace examples = ::google::cloud::testing_util; + using ::google::cloud::internal::GetEnv; + if (!argv.empty()) throw examples::Usage{"auto"}; + examples::CheckEnvironmentVariablesAreSet( + {"GOOGLE_CLOUD_CPP_TEST_SERVICE_ACCOUNT_KEYFILE"}); + auto const keyfile = + GetEnv("GOOGLE_CLOUD_CPP_TEST_SERVICE_ACCOUNT_KEYFILE").value(); + + std::cout << "\nRunning SetClientEndpoint() example" << std::endl; + SetClientEndpoint({}); + + std::cout << "\nRunning SetRetryPolicy() example" << std::endl; + SetRetryPolicy({}); + + std::cout << "\nRunning WithServiceAccount() example" << std::endl; + WithServiceAccount({keyfile}); + + std::cout << "\nRunning SetClientUniverseDomain() example" << std::endl; + SetClientUniverseDomain({}); +} + +} // namespace + +int main(int argc, char* argv[]) { // NOLINT(bugprone-exception-escape) + google::cloud::testing_util::Example example({ + {"set-client-endpoint", SetClientEndpoint}, + {"set-retry-policy", SetRetryPolicy}, + {"with-service-account", WithServiceAccount}, + {"set-client-universe-domain", SetClientUniverseDomain}, + {"auto", AutoRun}, + }); + return example.Run(argc, argv); +} diff --git a/google/cloud/compute/reservation_blocks/v1/internal/reservation_blocks_rest_connection_impl.cc b/google/cloud/compute/reservation_blocks/v1/internal/reservation_blocks_rest_connection_impl.cc index 3aa1305dbed6b..8b4d88f1ad655 100644 --- a/google/cloud/compute/reservation_blocks/v1/internal/reservation_blocks_rest_connection_impl.cc +++ b/google/cloud/compute/reservation_blocks/v1/internal/reservation_blocks_rest_connection_impl.cc @@ -62,6 +62,22 @@ ReservationBlocksRestConnectionImpl::GetReservationBlocksGetResponse( *current, request, __func__); } +StatusOr +ReservationBlocksRestConnectionImpl::GetIamPolicy( + google::cloud::cpp::compute::reservation_blocks::v1:: + GetIamPolicyRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->GetIamPolicy(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::reservation_blocks::v1:: + GetIamPolicyRequest const& request) { + return stub_->GetIamPolicy(rest_context, options, request); + }, + *current, request, __func__); +} + StreamRange ReservationBlocksRestConnectionImpl::ListReservationBlocks( google::cloud::cpp::compute::reservation_blocks::v1:: @@ -233,6 +249,38 @@ ReservationBlocksRestConnectionImpl::PerformMaintenance( }); } +StatusOr +ReservationBlocksRestConnectionImpl::SetIamPolicy( + google::cloud::cpp::compute::reservation_blocks::v1:: + SetIamPolicyRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->SetIamPolicy(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::reservation_blocks::v1:: + SetIamPolicyRequest const& request) { + return stub_->SetIamPolicy(rest_context, options, request); + }, + *current, request, __func__); +} + +StatusOr +ReservationBlocksRestConnectionImpl::TestIamPermissions( + google::cloud::cpp::compute::reservation_blocks::v1:: + TestIamPermissionsRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->TestIamPermissions(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::reservation_blocks::v1:: + TestIamPermissionsRequest const& request) { + return stub_->TestIamPermissions(rest_context, options, request); + }, + *current, request, __func__); +} + GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END } // namespace compute_reservation_blocks_v1_internal } // namespace cloud diff --git a/google/cloud/compute/reservation_blocks/v1/internal/reservation_blocks_rest_connection_impl.h b/google/cloud/compute/reservation_blocks/v1/internal/reservation_blocks_rest_connection_impl.h index b862535751efe..7b9b22a4791ba 100644 --- a/google/cloud/compute/reservation_blocks/v1/internal/reservation_blocks_rest_connection_impl.h +++ b/google/cloud/compute/reservation_blocks/v1/internal/reservation_blocks_rest_connection_impl.h @@ -57,6 +57,10 @@ class ReservationBlocksRestConnectionImpl google::cloud::cpp::compute::reservation_blocks::v1:: GetReservationBlocksGetResponseRequest const& request) override; + StatusOr GetIamPolicy( + google::cloud::cpp::compute::reservation_blocks::v1:: + GetIamPolicyRequest const& request) override; + StreamRange ListReservationBlocks(google::cloud::cpp::compute::reservation_blocks::v1:: ListReservationBlocksRequest request) override; @@ -73,6 +77,14 @@ class ReservationBlocksRestConnectionImpl PerformMaintenance( google::cloud::cpp::compute::v1::Operation const& operation) override; + StatusOr SetIamPolicy( + google::cloud::cpp::compute::reservation_blocks::v1:: + SetIamPolicyRequest const& request) override; + + StatusOr + TestIamPermissions(google::cloud::cpp::compute::reservation_blocks::v1:: + TestIamPermissionsRequest const& request) override; + private: static std::unique_ptr< compute_reservation_blocks_v1::ReservationBlocksRetryPolicy> diff --git a/google/cloud/compute/reservation_blocks/v1/internal/reservation_blocks_rest_logging_decorator.cc b/google/cloud/compute/reservation_blocks/v1/internal/reservation_blocks_rest_logging_decorator.cc index ae35145b6e859..c2fbff6800af9 100644 --- a/google/cloud/compute/reservation_blocks/v1/internal/reservation_blocks_rest_logging_decorator.cc +++ b/google/cloud/compute/reservation_blocks/v1/internal/reservation_blocks_rest_logging_decorator.cc @@ -49,6 +49,20 @@ ReservationBlocksRestLogging::GetReservationBlocksGetResponse( rest_context, options, request, __func__, tracing_options_); } +StatusOr +ReservationBlocksRestLogging::GetIamPolicy( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::reservation_blocks::v1:: + GetIamPolicyRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::reservation_blocks::v1:: + GetIamPolicyRequest const& request) { + return child_->GetIamPolicy(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + StatusOr ReservationBlocksRestLogging::ListReservationBlocks( rest_internal::RestContext& rest_context, Options const& options, @@ -97,6 +111,34 @@ ReservationBlocksRestLogging::PerformMaintenance( rest_context, options, request, __func__, tracing_options_); } +StatusOr +ReservationBlocksRestLogging::SetIamPolicy( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::reservation_blocks::v1:: + SetIamPolicyRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::reservation_blocks::v1:: + SetIamPolicyRequest const& request) { + return child_->SetIamPolicy(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +StatusOr +ReservationBlocksRestLogging::TestIamPermissions( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::reservation_blocks::v1:: + TestIamPermissionsRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::reservation_blocks::v1:: + TestIamPermissionsRequest const& request) { + return child_->TestIamPermissions(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + future> ReservationBlocksRestLogging::AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/reservation_blocks/v1/internal/reservation_blocks_rest_logging_decorator.h b/google/cloud/compute/reservation_blocks/v1/internal/reservation_blocks_rest_logging_decorator.h index 471b3be22cc85..0621cc3b15171 100644 --- a/google/cloud/compute/reservation_blocks/v1/internal/reservation_blocks_rest_logging_decorator.h +++ b/google/cloud/compute/reservation_blocks/v1/internal/reservation_blocks_rest_logging_decorator.h @@ -49,6 +49,12 @@ class ReservationBlocksRestLogging : public ReservationBlocksRestStub { google::cloud::cpp::compute::reservation_blocks::v1:: GetReservationBlocksGetResponseRequest const& request) override; + StatusOr GetIamPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reservation_blocks::v1:: + GetIamPolicyRequest const& request) override; + StatusOr ListReservationBlocks( google::cloud::rest_internal::RestContext& rest_context, @@ -70,6 +76,18 @@ class ReservationBlocksRestLogging : public ReservationBlocksRestStub { google::cloud::cpp::compute::reservation_blocks::v1:: PerformMaintenanceRequest const& request) override; + StatusOr SetIamPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reservation_blocks::v1:: + SetIamPolicyRequest const& request) override; + + StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reservation_blocks::v1:: + TestIamPermissionsRequest const& request) override; + future> AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/reservation_blocks/v1/internal/reservation_blocks_rest_metadata_decorator.cc b/google/cloud/compute/reservation_blocks/v1/internal/reservation_blocks_rest_metadata_decorator.cc index 366924b7d2e60..8c284870c0fb5 100644 --- a/google/cloud/compute/reservation_blocks/v1/internal/reservation_blocks_rest_metadata_decorator.cc +++ b/google/cloud/compute/reservation_blocks/v1/internal/reservation_blocks_rest_metadata_decorator.cc @@ -49,6 +49,15 @@ ReservationBlocksRestMetadata::GetReservationBlocksGetResponse( request); } +StatusOr +ReservationBlocksRestMetadata::GetIamPolicy( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::reservation_blocks::v1:: + GetIamPolicyRequest const& request) { + SetMetadata(rest_context, options); + return child_->GetIamPolicy(rest_context, options, request); +} + StatusOr ReservationBlocksRestMetadata::ListReservationBlocks( rest_internal::RestContext& rest_context, Options const& options, @@ -79,6 +88,24 @@ ReservationBlocksRestMetadata::PerformMaintenance( return child_->PerformMaintenance(rest_context, options, request); } +StatusOr +ReservationBlocksRestMetadata::SetIamPolicy( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::reservation_blocks::v1:: + SetIamPolicyRequest const& request) { + SetMetadata(rest_context, options); + return child_->SetIamPolicy(rest_context, options, request); +} + +StatusOr +ReservationBlocksRestMetadata::TestIamPermissions( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::reservation_blocks::v1:: + TestIamPermissionsRequest const& request) { + SetMetadata(rest_context, options); + return child_->TestIamPermissions(rest_context, options, request); +} + future> ReservationBlocksRestMetadata::AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/reservation_blocks/v1/internal/reservation_blocks_rest_metadata_decorator.h b/google/cloud/compute/reservation_blocks/v1/internal/reservation_blocks_rest_metadata_decorator.h index 05cb920355fb1..76051ad5b3e6b 100644 --- a/google/cloud/compute/reservation_blocks/v1/internal/reservation_blocks_rest_metadata_decorator.h +++ b/google/cloud/compute/reservation_blocks/v1/internal/reservation_blocks_rest_metadata_decorator.h @@ -47,6 +47,12 @@ class ReservationBlocksRestMetadata : public ReservationBlocksRestStub { google::cloud::cpp::compute::reservation_blocks::v1:: GetReservationBlocksGetResponseRequest const& request) override; + StatusOr GetIamPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reservation_blocks::v1:: + GetIamPolicyRequest const& request) override; + StatusOr ListReservationBlocks( google::cloud::rest_internal::RestContext& rest_context, @@ -68,6 +74,18 @@ class ReservationBlocksRestMetadata : public ReservationBlocksRestStub { google::cloud::cpp::compute::reservation_blocks::v1:: PerformMaintenanceRequest const& request) override; + StatusOr SetIamPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reservation_blocks::v1:: + SetIamPolicyRequest const& request) override; + + StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reservation_blocks::v1:: + TestIamPermissionsRequest const& request) override; + google::cloud::future> AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/reservation_blocks/v1/internal/reservation_blocks_rest_stub.cc b/google/cloud/compute/reservation_blocks/v1/internal/reservation_blocks_rest_stub.cc index 837ed439c5d55..d27433df3a513 100644 --- a/google/cloud/compute/reservation_blocks/v1/internal/reservation_blocks_rest_stub.cc +++ b/google/cloud/compute/reservation_blocks/v1/internal/reservation_blocks_rest_stub.cc @@ -53,6 +53,9 @@ DefaultReservationBlocksRestStub::GetReservationBlocksGetResponse( google::cloud::cpp::compute::reservation_blocks::v1:: GetReservationBlocksGetResponseRequest const& request) { std::vector> query_params; + query_params.push_back({"view", request.view()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); return rest_internal::Get< google::cloud::cpp::compute::v1::ReservationBlocksGetResponse>( *service_, rest_context, request, false, @@ -65,6 +68,29 @@ DefaultReservationBlocksRestStub::GetReservationBlocksGetResponse( std::move(query_params)); } +StatusOr +DefaultReservationBlocksRestStub::GetIamPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reservation_blocks::v1:: + GetIamPolicyRequest const& request) { + std::vector> query_params; + query_params.push_back( + {"options_requested_policy_version", + std::to_string(request.options_requested_policy_version())}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Get( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "zones", "/", + request.zone(), "/", "reservations", "/", + request.parent_resource(), "/", "reservationBlocks", "/", + request.resource(), "/", "getIamPolicy"), + std::move(query_params)); +} + StatusOr DefaultReservationBlocksRestStub::ListReservationBlocks( google::cloud::rest_internal::RestContext& rest_context, @@ -156,6 +182,45 @@ DefaultReservationBlocksRestStub::PerformMaintenance( std::move(query_params)); } +StatusOr +DefaultReservationBlocksRestStub::SetIamPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reservation_blocks::v1:: + SetIamPolicyRequest const& request) { + std::vector> query_params; + return rest_internal::Post( + *service_, rest_context, + request.zone_set_nested_policy_request_resource(), false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "zones", "/", + request.zone(), "/", "reservations", "/", + request.parent_resource(), "/", "reservationBlocks", "/", + request.resource(), "/", "setIamPolicy"), + std::move(query_params)); +} + +StatusOr +DefaultReservationBlocksRestStub::TestIamPermissions( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reservation_blocks::v1:: + TestIamPermissionsRequest const& request) { + std::vector> query_params; + return rest_internal::Post< + google::cloud::cpp::compute::v1::TestPermissionsResponse>( + *service_, rest_context, request.test_permissions_request_resource(), + false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "zones", "/", + request.zone(), "/", "reservations", "/", + request.parent_resource(), "/", "reservationBlocks", "/", + request.resource(), "/", "testIamPermissions"), + std::move(query_params)); +} + future> DefaultReservationBlocksRestStub::AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/reservation_blocks/v1/internal/reservation_blocks_rest_stub.h b/google/cloud/compute/reservation_blocks/v1/internal/reservation_blocks_rest_stub.h index fe3b18c2e2b31..64aeedc1d54ed 100644 --- a/google/cloud/compute/reservation_blocks/v1/internal/reservation_blocks_rest_stub.h +++ b/google/cloud/compute/reservation_blocks/v1/internal/reservation_blocks_rest_stub.h @@ -45,6 +45,12 @@ class ReservationBlocksRestStub { google::cloud::cpp::compute::reservation_blocks::v1:: GetReservationBlocksGetResponseRequest const& request) = 0; + virtual StatusOr GetIamPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reservation_blocks::v1:: + GetIamPolicyRequest const& request) = 0; + virtual StatusOr< google::cloud::cpp::compute::v1::ReservationBlocksListResponse> ListReservationBlocks(google::cloud::rest_internal::RestContext& rest_context, @@ -66,6 +72,18 @@ class ReservationBlocksRestStub { google::cloud::cpp::compute::reservation_blocks::v1:: PerformMaintenanceRequest const& request) = 0; + virtual StatusOr SetIamPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reservation_blocks::v1:: + SetIamPolicyRequest const& request) = 0; + + virtual StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reservation_blocks::v1:: + TestIamPermissionsRequest const& request) = 0; + virtual future> AsyncGetOperation( google::cloud::CompletionQueue& cq, @@ -98,6 +116,12 @@ class DefaultReservationBlocksRestStub : public ReservationBlocksRestStub { google::cloud::cpp::compute::reservation_blocks::v1:: GetReservationBlocksGetResponseRequest const& request) override; + StatusOr GetIamPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reservation_blocks::v1:: + GetIamPolicyRequest const& request) override; + StatusOr ListReservationBlocks( google::cloud::rest_internal::RestContext& rest_context, @@ -119,6 +143,18 @@ class DefaultReservationBlocksRestStub : public ReservationBlocksRestStub { google::cloud::cpp::compute::reservation_blocks::v1:: PerformMaintenanceRequest const& request) override; + StatusOr SetIamPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reservation_blocks::v1:: + SetIamPolicyRequest const& request) override; + + StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reservation_blocks::v1:: + TestIamPermissionsRequest const& request) override; + future> AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/reservation_blocks/v1/internal/reservation_blocks_tracing_connection.cc b/google/cloud/compute/reservation_blocks/v1/internal/reservation_blocks_tracing_connection.cc index be03952d3f5b7..0f273e53f5001 100644 --- a/google/cloud/compute/reservation_blocks/v1/internal/reservation_blocks_tracing_connection.cc +++ b/google/cloud/compute/reservation_blocks/v1/internal/reservation_blocks_tracing_connection.cc @@ -44,6 +44,17 @@ ReservationBlocksTracingConnection::GetReservationBlocksGetResponse( child_->GetReservationBlocksGetResponse(request)); } +StatusOr +ReservationBlocksTracingConnection::GetIamPolicy( + google::cloud::cpp::compute::reservation_blocks::v1:: + GetIamPolicyRequest const& request) { + auto span = internal::MakeSpan( + "compute_reservation_blocks_v1::ReservationBlocksConnection::" + "GetIamPolicy"); + auto scope = opentelemetry::trace::Scope(span); + return internal::EndSpan(*span, child_->GetIamPolicy(request)); +} + StreamRange ReservationBlocksTracingConnection::ListReservationBlocks( google::cloud::cpp::compute::reservation_blocks::v1:: @@ -93,6 +104,28 @@ ReservationBlocksTracingConnection::PerformMaintenance( child_->PerformMaintenance(operation)); } +StatusOr +ReservationBlocksTracingConnection::SetIamPolicy( + google::cloud::cpp::compute::reservation_blocks::v1:: + SetIamPolicyRequest const& request) { + auto span = internal::MakeSpan( + "compute_reservation_blocks_v1::ReservationBlocksConnection::" + "SetIamPolicy"); + auto scope = opentelemetry::trace::Scope(span); + return internal::EndSpan(*span, child_->SetIamPolicy(request)); +} + +StatusOr +ReservationBlocksTracingConnection::TestIamPermissions( + google::cloud::cpp::compute::reservation_blocks::v1:: + TestIamPermissionsRequest const& request) { + auto span = internal::MakeSpan( + "compute_reservation_blocks_v1::ReservationBlocksConnection::" + "TestIamPermissions"); + auto scope = opentelemetry::trace::Scope(span); + return internal::EndSpan(*span, child_->TestIamPermissions(request)); +} + std::shared_ptr MakeReservationBlocksTracingConnection( std::shared_ptr diff --git a/google/cloud/compute/reservation_blocks/v1/internal/reservation_blocks_tracing_connection.h b/google/cloud/compute/reservation_blocks/v1/internal/reservation_blocks_tracing_connection.h index 923b20756ae42..046a9870334dd 100644 --- a/google/cloud/compute/reservation_blocks/v1/internal/reservation_blocks_tracing_connection.h +++ b/google/cloud/compute/reservation_blocks/v1/internal/reservation_blocks_tracing_connection.h @@ -45,6 +45,10 @@ class ReservationBlocksTracingConnection google::cloud::cpp::compute::reservation_blocks::v1:: GetReservationBlocksGetResponseRequest const& request) override; + StatusOr GetIamPolicy( + google::cloud::cpp::compute::reservation_blocks::v1:: + GetIamPolicyRequest const& request) override; + StreamRange ListReservationBlocks(google::cloud::cpp::compute::reservation_blocks::v1:: ListReservationBlocksRequest request) override; @@ -61,6 +65,14 @@ class ReservationBlocksTracingConnection PerformMaintenance( google::cloud::cpp::compute::v1::Operation const& operation) override; + StatusOr SetIamPolicy( + google::cloud::cpp::compute::reservation_blocks::v1:: + SetIamPolicyRequest const& request) override; + + StatusOr + TestIamPermissions(google::cloud::cpp::compute::reservation_blocks::v1:: + TestIamPermissionsRequest const& request) override; + private: std::shared_ptr child_; diff --git a/google/cloud/compute/reservation_blocks/v1/mocks/mock_reservation_blocks_connection.h b/google/cloud/compute/reservation_blocks/v1/mocks/mock_reservation_blocks_connection.h index eae86e038e317..e86c6469d2c80 100644 --- a/google/cloud/compute/reservation_blocks/v1/mocks/mock_reservation_blocks_connection.h +++ b/google/cloud/compute/reservation_blocks/v1/mocks/mock_reservation_blocks_connection.h @@ -54,6 +54,11 @@ class MockReservationBlocksConnection GetReservationBlocksGetResponseRequest const& request), (override)); + MOCK_METHOD(StatusOr, GetIamPolicy, + (google::cloud::cpp::compute::reservation_blocks::v1:: + GetIamPolicyRequest const& request), + (override)); + MOCK_METHOD((StreamRange), ListReservationBlocks, (google::cloud::cpp::compute::reservation_blocks::v1:: @@ -100,6 +105,18 @@ class MockReservationBlocksConnection PerformMaintenance, (google::cloud::cpp::compute::v1::Operation const& operation), (override)); + + MOCK_METHOD(StatusOr, SetIamPolicy, + (google::cloud::cpp::compute::reservation_blocks::v1:: + SetIamPolicyRequest const& request), + (override)); + + MOCK_METHOD( + StatusOr, + TestIamPermissions, + (google::cloud::cpp::compute::reservation_blocks::v1:: + TestIamPermissionsRequest const& request), + (override)); }; GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END diff --git a/google/cloud/compute/reservation_blocks/v1/reservation_blocks_client.cc b/google/cloud/compute/reservation_blocks/v1/reservation_blocks_client.cc index b75571eaec106..a52e19ef3f955 100644 --- a/google/cloud/compute/reservation_blocks/v1/reservation_blocks_client.cc +++ b/google/cloud/compute/reservation_blocks/v1/reservation_blocks_client.cc @@ -56,6 +56,31 @@ ReservationBlocksClient::GetReservationBlocksGetResponse( return connection_->GetReservationBlocksGetResponse(request); } +StatusOr +ReservationBlocksClient::GetIamPolicy(std::string const& project, + std::string const& zone, + std::string const& parent_resource, + std::string const& resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::reservation_blocks::v1::GetIamPolicyRequest + request; + request.set_project(project); + request.set_zone(zone); + request.set_parent_resource(parent_resource); + request.set_resource(resource); + return connection_->GetIamPolicy(request); +} + +StatusOr +ReservationBlocksClient::GetIamPolicy( + google::cloud::cpp::compute::reservation_blocks::v1:: + GetIamPolicyRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->GetIamPolicy(request); +} + StreamRange ReservationBlocksClient::ListReservationBlocks(std::string const& project, std::string const& zone, @@ -145,6 +170,62 @@ ReservationBlocksClient::PerformMaintenance( return connection_->PerformMaintenance(operation); } +StatusOr +ReservationBlocksClient::SetIamPolicy( + std::string const& project, std::string const& zone, + std::string const& parent_resource, std::string const& resource, + google::cloud::cpp::compute::v1::ZoneSetNestedPolicyRequest const& + zone_set_nested_policy_request_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::reservation_blocks::v1::SetIamPolicyRequest + request; + request.set_project(project); + request.set_zone(zone); + request.set_parent_resource(parent_resource); + request.set_resource(resource); + *request.mutable_zone_set_nested_policy_request_resource() = + zone_set_nested_policy_request_resource; + return connection_->SetIamPolicy(request); +} + +StatusOr +ReservationBlocksClient::SetIamPolicy( + google::cloud::cpp::compute::reservation_blocks::v1:: + SetIamPolicyRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->SetIamPolicy(request); +} + +StatusOr +ReservationBlocksClient::TestIamPermissions( + std::string const& project, std::string const& zone, + std::string const& parent_resource, std::string const& resource, + google::cloud::cpp::compute::v1::TestPermissionsRequest const& + test_permissions_request_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::reservation_blocks::v1::TestIamPermissionsRequest + request; + request.set_project(project); + request.set_zone(zone); + request.set_parent_resource(parent_resource); + request.set_resource(resource); + *request.mutable_test_permissions_request_resource() = + test_permissions_request_resource; + return connection_->TestIamPermissions(request); +} + +StatusOr +ReservationBlocksClient::TestIamPermissions( + google::cloud::cpp::compute::reservation_blocks::v1:: + TestIamPermissionsRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->TestIamPermissions(request); +} + GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END } // namespace compute_reservation_blocks_v1 } // namespace cloud diff --git a/google/cloud/compute/reservation_blocks/v1/reservation_blocks_client.h b/google/cloud/compute/reservation_blocks/v1/reservation_blocks_client.h index bec9c7959de7f..e342b8d88b6a0 100644 --- a/google/cloud/compute/reservation_blocks/v1/reservation_blocks_client.h +++ b/google/cloud/compute/reservation_blocks/v1/reservation_blocks_client.h @@ -95,10 +95,10 @@ class ReservationBlocksClient { /// /// @param project Project ID for this request. /// @param zone Name of the zone for this request. Zone name should conform to RFC1035. - /// @param reservation The name of the reservation. Name should conform to RFC1035 or be a - /// resource ID. - /// @param reservation_block The name of the reservation block. Name should conform to RFC1035 or be a - /// resource ID. + /// @param reservation The name of the reservation. + /// Name should conform to RFC1035 or be a resource ID. + /// @param reservation_block The name of the reservation block. + /// Name should conform to RFC1035 or be a resource ID. /// @param opts Optional. Override the class-level options, such as retry and /// backoff policies. /// @return the result of the RPC. The response message type @@ -112,8 +112,8 @@ class ReservationBlocksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.reservation_blocks.v1.GetReservationBlocksGetResponseRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservation_blocks/v1/reservation_blocks.proto#L76} - /// [google.cloud.cpp.compute.v1.ReservationBlocksGetResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_112.proto#L96} + /// [google.cloud.cpp.compute.reservation_blocks.v1.GetReservationBlocksGetResponseRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservation_blocks/v1/reservation_blocks.proto#L138} + /// [google.cloud.cpp.compute.v1.ReservationBlocksGetResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_132.proto#L158} /// // clang-format on StatusOr @@ -147,8 +147,8 @@ class ReservationBlocksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.reservation_blocks.v1.GetReservationBlocksGetResponseRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservation_blocks/v1/reservation_blocks.proto#L76} - /// [google.cloud.cpp.compute.v1.ReservationBlocksGetResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_112.proto#L96} + /// [google.cloud.cpp.compute.reservation_blocks.v1.GetReservationBlocksGetResponseRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservation_blocks/v1/reservation_blocks.proto#L138} + /// [google.cloud.cpp.compute.v1.ReservationBlocksGetResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_132.proto#L158} /// // clang-format on StatusOr @@ -157,6 +157,72 @@ class ReservationBlocksClient { GetReservationBlocksGetResponseRequest const& request, Options opts = {}); + // clang-format off + /// + /// Gets the access control policy for a resource. May be empty if no such + /// policy or resource exists. + /// https://cloud.google.com/compute/docs/reference/rest/v1/reservationBlocks/getIamPolicy + /// + /// @param project Project ID for this request. + /// @param zone The name of the zone for this request. + /// @param parent_resource Name or id of parent resource of the resource for this request. + /// @param resource Name or id of the resource for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.Policy]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.reservation_blocks.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservation_blocks/v1/reservation_blocks.proto#L116} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} + /// + // clang-format on + StatusOr GetIamPolicy( + std::string const& project, std::string const& zone, + std::string const& parent_resource, std::string const& resource, + Options opts = {}); + + // clang-format off + /// + /// Gets the access control policy for a resource. May be empty if no such + /// policy or resource exists. + /// https://cloud.google.com/compute/docs/reference/rest/v1/reservationBlocks/getIamPolicy + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.reservation_blocks.v1.GetIamPolicyRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.Policy]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.reservation_blocks.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservation_blocks/v1/reservation_blocks.proto#L116} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} + /// + // clang-format on + StatusOr GetIamPolicy( + google::cloud::cpp::compute::reservation_blocks::v1:: + GetIamPolicyRequest const& request, + Options opts = {}); + // clang-format off /// /// Retrieves a list of reservation blocks under a single reservation. @@ -164,8 +230,8 @@ class ReservationBlocksClient { /// /// @param project Project ID for this request. /// @param zone Name of the zone for this request. Zone name should conform to RFC1035. - /// @param reservation The name of the reservation. Name should conform to RFC1035 or be a - /// resource ID. + /// @param reservation The name of the reservation. + /// Name should conform to RFC1035 or be a resource ID. /// @param opts Optional. Override the class-level options, such as retry and /// backoff policies. /// @return a [StreamRange](@ref google::cloud::StreamRange) @@ -188,8 +254,8 @@ class ReservationBlocksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.reservation_blocks.v1.ListReservationBlocksRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservation_blocks/v1/reservation_blocks.proto#L96} - /// [google.cloud.cpp.compute.v1.ReservationBlock]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_112.proto#L27} + /// [google.cloud.cpp.compute.reservation_blocks.v1.ListReservationBlocksRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservation_blocks/v1/reservation_blocks.proto#L165} + /// [google.cloud.cpp.compute.v1.ReservationBlock]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_132.proto#L27} /// // clang-format on StreamRange @@ -229,8 +295,8 @@ class ReservationBlocksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.reservation_blocks.v1.ListReservationBlocksRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservation_blocks/v1/reservation_blocks.proto#L96} - /// [google.cloud.cpp.compute.v1.ReservationBlock]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_112.proto#L27} + /// [google.cloud.cpp.compute.reservation_blocks.v1.ListReservationBlocksRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservation_blocks/v1/reservation_blocks.proto#L165} + /// [google.cloud.cpp.compute.v1.ReservationBlock]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_132.proto#L27} /// // clang-format on StreamRange @@ -245,10 +311,10 @@ class ReservationBlocksClient { /// /// @param project Project ID for this request. /// @param zone Name of the zone for this request. Zone name should conform to RFC1035. - /// @param reservation The name of the reservation. Name should conform to RFC1035 or be a - /// resource ID. - /// @param reservation_block The name of the reservation block. Name should conform to RFC1035 or be a - /// resource ID. + /// @param reservation The name of the reservation. + /// Name should conform to RFC1035 or be a resource ID. + /// @param reservation_block The name of the reservation block. + /// Name should conform to RFC1035 or be a resource ID. /// @param reservations_blocks_perform_maintenance_request_resource The ReservationsBlocksPerformMaintenanceRequest for this request. /// @param opts Optional. Override the class-level options, such as retry and /// backoff policies. @@ -270,7 +336,7 @@ class ReservationBlocksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.reservation_blocks.v1.PerformMaintenanceRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservation_blocks/v1/reservation_blocks.proto#L172} + /// [google.cloud.cpp.compute.reservation_blocks.v1.PerformMaintenanceRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservation_blocks/v1/reservation_blocks.proto#L274} /// // clang-format on future> @@ -332,7 +398,7 @@ class ReservationBlocksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.reservation_blocks.v1.PerformMaintenanceRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservation_blocks/v1/reservation_blocks.proto#L172} + /// [google.cloud.cpp.compute.reservation_blocks.v1.PerformMaintenanceRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservation_blocks/v1/reservation_blocks.proto#L274} /// // clang-format on future> @@ -371,6 +437,143 @@ class ReservationBlocksClient { google::cloud::cpp::compute::v1::Operation const& operation, Options opts = {}); + // clang-format off + /// + /// Sets the access control policy on the specified resource. + /// Replaces any existing policy. + /// https://cloud.google.com/compute/docs/reference/rest/v1/reservationBlocks/setIamPolicy + /// + /// @param project Project ID for this request. + /// @param zone The name of the zone for this request. + /// @param parent_resource Name or id of parent resource of the resource for this request. + /// @param resource Name or id of the resource for this request. + /// @param zone_set_nested_policy_request_resource The ZoneSetNestedPolicyRequest for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.Policy]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.reservation_blocks.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservation_blocks/v1/reservation_blocks.proto#L322} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} + /// + // clang-format on + StatusOr SetIamPolicy( + std::string const& project, std::string const& zone, + std::string const& parent_resource, std::string const& resource, + google::cloud::cpp::compute::v1::ZoneSetNestedPolicyRequest const& + zone_set_nested_policy_request_resource, + Options opts = {}); + + // clang-format off + /// + /// Sets the access control policy on the specified resource. + /// Replaces any existing policy. + /// https://cloud.google.com/compute/docs/reference/rest/v1/reservationBlocks/setIamPolicy + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.reservation_blocks.v1.SetIamPolicyRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.Policy]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.reservation_blocks.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservation_blocks/v1/reservation_blocks.proto#L322} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} + /// + // clang-format on + StatusOr SetIamPolicy( + google::cloud::cpp::compute::reservation_blocks::v1:: + SetIamPolicyRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// Returns permissions that a caller has on the specified resource. + /// https://cloud.google.com/compute/docs/reference/rest/v1/reservationBlocks/testIamPermissions + /// + /// @param project Project ID for this request. + /// @param zone The name of the zone for this request. + /// @param parent_resource Name or id of parent resource of the resource for this request. + /// @param resource Name or id of the resource for this request. + /// @param test_permissions_request_resource The TestPermissionsRequest for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.TestPermissionsResponse]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.reservation_blocks.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservation_blocks/v1/reservation_blocks.proto#L345} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} + /// + // clang-format on + StatusOr + TestIamPermissions( + std::string const& project, std::string const& zone, + std::string const& parent_resource, std::string const& resource, + google::cloud::cpp::compute::v1::TestPermissionsRequest const& + test_permissions_request_resource, + Options opts = {}); + + // clang-format off + /// + /// Returns permissions that a caller has on the specified resource. + /// https://cloud.google.com/compute/docs/reference/rest/v1/reservationBlocks/testIamPermissions + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.reservation_blocks.v1.TestIamPermissionsRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.TestPermissionsResponse]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.reservation_blocks.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservation_blocks/v1/reservation_blocks.proto#L345} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} + /// + // clang-format on + StatusOr + TestIamPermissions(google::cloud::cpp::compute::reservation_blocks::v1:: + TestIamPermissionsRequest const& request, + Options opts = {}); + private: std::shared_ptr connection_; Options options_; diff --git a/google/cloud/compute/reservation_blocks/v1/reservation_blocks_connection.cc b/google/cloud/compute/reservation_blocks/v1/reservation_blocks_connection.cc index bd2761ab3a41c..fdb3196db41e6 100644 --- a/google/cloud/compute/reservation_blocks/v1/reservation_blocks_connection.cc +++ b/google/cloud/compute/reservation_blocks/v1/reservation_blocks_connection.cc @@ -43,6 +43,13 @@ ReservationBlocksConnection::GetReservationBlocksGetResponse( return Status(StatusCode::kUnimplemented, "not implemented"); } +StatusOr +ReservationBlocksConnection::GetIamPolicy( + google::cloud::cpp::compute::reservation_blocks::v1:: + GetIamPolicyRequest const&) { + return Status(StatusCode::kUnimplemented, "not implemented"); +} + StreamRange ReservationBlocksConnection::ListReservationBlocks( google::cloud::cpp::compute::reservation_blocks::v1:: @@ -76,6 +83,20 @@ ReservationBlocksConnection::PerformMaintenance( Status(StatusCode::kUnimplemented, "not implemented")); } +StatusOr +ReservationBlocksConnection::SetIamPolicy( + google::cloud::cpp::compute::reservation_blocks::v1:: + SetIamPolicyRequest const&) { + return Status(StatusCode::kUnimplemented, "not implemented"); +} + +StatusOr +ReservationBlocksConnection::TestIamPermissions( + google::cloud::cpp::compute::reservation_blocks::v1:: + TestIamPermissionsRequest const&) { + return Status(StatusCode::kUnimplemented, "not implemented"); +} + GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END } // namespace compute_reservation_blocks_v1 } // namespace cloud diff --git a/google/cloud/compute/reservation_blocks/v1/reservation_blocks_connection.h b/google/cloud/compute/reservation_blocks/v1/reservation_blocks_connection.h index 511fb51c96896..0226aeb64b646 100644 --- a/google/cloud/compute/reservation_blocks/v1/reservation_blocks_connection.h +++ b/google/cloud/compute/reservation_blocks/v1/reservation_blocks_connection.h @@ -193,6 +193,10 @@ class ReservationBlocksConnection { google::cloud::cpp::compute::reservation_blocks::v1:: GetReservationBlocksGetResponseRequest const& request); + virtual StatusOr GetIamPolicy( + google::cloud::cpp::compute::reservation_blocks::v1:: + GetIamPolicyRequest const& request); + virtual StreamRange ListReservationBlocks(google::cloud::cpp::compute::reservation_blocks::v1:: ListReservationBlocksRequest request); @@ -209,6 +213,14 @@ class ReservationBlocksConnection { virtual future> PerformMaintenance( google::cloud::cpp::compute::v1::Operation const& operation); + + virtual StatusOr SetIamPolicy( + google::cloud::cpp::compute::reservation_blocks::v1:: + SetIamPolicyRequest const& request); + + virtual StatusOr + TestIamPermissions(google::cloud::cpp::compute::reservation_blocks::v1:: + TestIamPermissionsRequest const& request); }; GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END diff --git a/google/cloud/compute/reservation_blocks/v1/reservation_blocks_connection_idempotency_policy.cc b/google/cloud/compute/reservation_blocks/v1/reservation_blocks_connection_idempotency_policy.cc index 1fca6ad141382..2bfc613536c86 100644 --- a/google/cloud/compute/reservation_blocks/v1/reservation_blocks_connection_idempotency_policy.cc +++ b/google/cloud/compute/reservation_blocks/v1/reservation_blocks_connection_idempotency_policy.cc @@ -41,6 +41,12 @@ ReservationBlocksConnectionIdempotencyPolicy::GetReservationBlocksGetResponse( return Idempotency::kIdempotent; } +Idempotency ReservationBlocksConnectionIdempotencyPolicy::GetIamPolicy( + google::cloud::cpp::compute::reservation_blocks::v1:: + GetIamPolicyRequest const&) { + return Idempotency::kIdempotent; +} + Idempotency ReservationBlocksConnectionIdempotencyPolicy::ListReservationBlocks( google::cloud::cpp::compute::reservation_blocks::v1:: ListReservationBlocksRequest) { // NOLINT @@ -53,6 +59,18 @@ Idempotency ReservationBlocksConnectionIdempotencyPolicy::PerformMaintenance( return Idempotency::kNonIdempotent; } +Idempotency ReservationBlocksConnectionIdempotencyPolicy::SetIamPolicy( + google::cloud::cpp::compute::reservation_blocks::v1:: + SetIamPolicyRequest const&) { + return Idempotency::kNonIdempotent; +} + +Idempotency ReservationBlocksConnectionIdempotencyPolicy::TestIamPermissions( + google::cloud::cpp::compute::reservation_blocks::v1:: + TestIamPermissionsRequest const&) { + return Idempotency::kNonIdempotent; +} + std::unique_ptr MakeDefaultReservationBlocksConnectionIdempotencyPolicy() { return std::make_unique(); diff --git a/google/cloud/compute/reservation_blocks/v1/reservation_blocks_connection_idempotency_policy.h b/google/cloud/compute/reservation_blocks/v1/reservation_blocks_connection_idempotency_policy.h index 3d89167901ea1..01e0c1682a3b9 100644 --- a/google/cloud/compute/reservation_blocks/v1/reservation_blocks_connection_idempotency_policy.h +++ b/google/cloud/compute/reservation_blocks/v1/reservation_blocks_connection_idempotency_policy.h @@ -41,6 +41,10 @@ class ReservationBlocksConnectionIdempotencyPolicy { google::cloud::cpp::compute::reservation_blocks::v1:: GetReservationBlocksGetResponseRequest const& request); + virtual google::cloud::Idempotency GetIamPolicy( + google::cloud::cpp::compute::reservation_blocks::v1:: + GetIamPolicyRequest const& request); + virtual google::cloud::Idempotency ListReservationBlocks( google::cloud::cpp::compute::reservation_blocks::v1:: ListReservationBlocksRequest request); @@ -48,6 +52,14 @@ class ReservationBlocksConnectionIdempotencyPolicy { virtual google::cloud::Idempotency PerformMaintenance( google::cloud::cpp::compute::reservation_blocks::v1:: PerformMaintenanceRequest const& request); + + virtual google::cloud::Idempotency SetIamPolicy( + google::cloud::cpp::compute::reservation_blocks::v1:: + SetIamPolicyRequest const& request); + + virtual google::cloud::Idempotency TestIamPermissions( + google::cloud::cpp::compute::reservation_blocks::v1:: + TestIamPermissionsRequest const& request); }; std::unique_ptr diff --git a/google/cloud/compute/reservation_blocks/v1/reservation_blocks_proto_export.h b/google/cloud/compute/reservation_blocks/v1/reservation_blocks_proto_export.h index 88aca6ea49b87..a928c415992a9 100644 --- a/google/cloud/compute/reservation_blocks/v1/reservation_blocks_proto_export.h +++ b/google/cloud/compute/reservation_blocks/v1/reservation_blocks_proto_export.h @@ -26,10 +26,14 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RESERVATION_BLOCKS_V1_RESERVATION_BLOCKS_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_048.pb.h" -#include "google/cloud/compute/v1/internal/common_112.pb.h" -#include "google/cloud/compute/v1/internal/common_146.pb.h" +#include "google/cloud/compute/v1/internal/common_009.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_040.pb.h" +#include "google/cloud/compute/v1/internal/common_059.pb.h" +#include "google/cloud/compute/v1/internal/common_132.pb.h" +#include "google/cloud/compute/v1/internal/common_171.pb.h" +#include "google/cloud/compute/v1/internal/common_173.pb.h" +#include "google/cloud/compute/v1/internal/common_181.pb.h" // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RESERVATION_BLOCKS_V1_RESERVATION_BLOCKS_PROTO_EXPORT_H diff --git a/google/cloud/compute/reservation_slots/v1/internal/reservation_slots_option_defaults.cc b/google/cloud/compute/reservation_slots/v1/internal/reservation_slots_option_defaults.cc new file mode 100644 index 0000000000000..ff62b4490f1c0 --- /dev/null +++ b/google/cloud/compute/reservation_slots/v1/internal/reservation_slots_option_defaults.cc @@ -0,0 +1,90 @@ +// Copyright 2026 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. +// source: google/cloud/compute/reservation_slots/v1/reservation_slots.proto + +#include "google/cloud/compute/reservation_slots/v1/internal/reservation_slots_option_defaults.h" +#include "google/cloud/compute/reservation_slots/v1/reservation_slots_connection.h" +#include "google/cloud/compute/reservation_slots/v1/reservation_slots_options.h" +#include "google/cloud/internal/populate_common_options.h" +#include "google/cloud/internal/populate_grpc_options.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_reservation_slots_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +namespace { +auto constexpr kBackoffScaling = 2.0; +} // namespace + +Options ReservationSlotsDefaultOptions(Options options) { + options = internal::PopulateCommonOptions( + std::move(options), "GOOGLE_CLOUD_CPP_RESERVATION_SLOTS_ENDPOINT", "", + "GOOGLE_CLOUD_CPP_RESERVATION_SLOTS_AUTHORITY", "compute.googleapis.com"); + options = internal::PopulateGrpcOptions(std::move(options)); + if (!options.has< + compute_reservation_slots_v1::ReservationSlotsRetryPolicyOption>()) { + options.set< + compute_reservation_slots_v1::ReservationSlotsRetryPolicyOption>( + compute_reservation_slots_v1::ReservationSlotsLimitedTimeRetryPolicy( + std::chrono::minutes(10)) + .clone()); + } + if (!options.has()) { + options + .set( + ExponentialBackoffPolicy( + std::chrono::seconds(0), std::chrono::seconds(1), + std::chrono::minutes(5), kBackoffScaling, kBackoffScaling) + .clone()); + } + if (!options.has()) { + options + .set( + GenericPollingPolicy( + options + .get() + ->clone(), + ExponentialBackoffPolicy(std::chrono::seconds(1), + std::chrono::minutes(5), + kBackoffScaling) + .clone()) + .clone()); + } + if (!options.has()) { + options.set( + compute_reservation_slots_v1:: + MakeDefaultReservationSlotsConnectionIdempotencyPolicy()); + } + + return options; +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_reservation_slots_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/reservation_slots/v1/internal/reservation_slots_option_defaults.h b/google/cloud/compute/reservation_slots/v1/internal/reservation_slots_option_defaults.h new file mode 100644 index 0000000000000..056fe72de8e26 --- /dev/null +++ b/google/cloud/compute/reservation_slots/v1/internal/reservation_slots_option_defaults.h @@ -0,0 +1,37 @@ +// Copyright 2026 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. +// source: google/cloud/compute/reservation_slots/v1/reservation_slots.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RESERVATION_SLOTS_V1_INTERNAL_RESERVATION_SLOTS_OPTION_DEFAULTS_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RESERVATION_SLOTS_V1_INTERNAL_RESERVATION_SLOTS_OPTION_DEFAULTS_H + +#include "google/cloud/options.h" +#include "google/cloud/version.h" + +namespace google { +namespace cloud { +namespace compute_reservation_slots_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +Options ReservationSlotsDefaultOptions(Options options); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_reservation_slots_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RESERVATION_SLOTS_V1_INTERNAL_RESERVATION_SLOTS_OPTION_DEFAULTS_H diff --git a/google/cloud/compute/reservation_slots/v1/internal/reservation_slots_rest_connection_impl.cc b/google/cloud/compute/reservation_slots/v1/internal/reservation_slots_rest_connection_impl.cc new file mode 100644 index 0000000000000..195af848ac428 --- /dev/null +++ b/google/cloud/compute/reservation_slots/v1/internal/reservation_slots_rest_connection_impl.cc @@ -0,0 +1,372 @@ +// Copyright 2026 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. +// source: google/cloud/compute/reservation_slots/v1/reservation_slots.proto + +#include "google/cloud/compute/reservation_slots/v1/internal/reservation_slots_rest_connection_impl.h" +#include "google/cloud/compute/reservation_slots/v1/internal/reservation_slots_rest_stub_factory.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/internal/async_rest_long_running_operation_custom.h" +#include "google/cloud/internal/extract_long_running_result.h" +#include "google/cloud/internal/pagination_range.h" +#include "google/cloud/internal/rest_lro_helpers.h" +#include "google/cloud/internal/rest_retry_loop.h" +#include "google/cloud/rest_options.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_reservation_slots_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +ReservationSlotsRestConnectionImpl::ReservationSlotsRestConnectionImpl( + std::unique_ptr background, + std::shared_ptr< + compute_reservation_slots_v1_internal::ReservationSlotsRestStub> + stub, + Options options) + : background_(std::move(background)), + stub_(std::move(stub)), + options_(internal::MergeOptions(std::move(options), + ReservationSlotsConnection::options())) {} + +StatusOr +ReservationSlotsRestConnectionImpl::GetReservationSlotsGetResponse( + google::cloud::cpp::compute::reservation_slots::v1:: + GetReservationSlotsGetResponseRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->GetReservationSlotsGetResponse(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::reservation_slots::v1:: + GetReservationSlotsGetResponseRequest const& request) { + return stub_->GetReservationSlotsGetResponse(rest_context, options, + request); + }, + *current, request, __func__); +} + +future> +ReservationSlotsRestConnectionImpl::GetVersion( + google::cloud::cpp::compute::reservation_slots::v1::GetVersionRequest const& + request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::zone_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::zone_operations::v1::DeleteOperationRequest>( + background_->cq(), current, request, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::reservation_slots::v1:: + GetVersionRequest const& request) { + return stub->AsyncGetVersion(cq, std::move(context), std::move(options), + request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->GetVersion(request), + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [request]( + std::string const& op, + google::cloud::cpp::compute::zone_operations::v1::GetOperationRequest& + r) { + r.set_project(request.project()); + r.set_zone(request.zone()); + r.set_operation(op); + }, + [request](std::string const& op, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest& r) { + r.set_project(request.project()); + r.set_zone(request.zone()); + r.set_operation(op); + }); +} + +StatusOr +ReservationSlotsRestConnectionImpl::GetVersion( + NoAwaitTag, + google::cloud::cpp::compute::reservation_slots::v1::GetVersionRequest const& + request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->GetVersion(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::reservation_slots::v1:: + GetVersionRequest const& request) { + return stub_->GetVersion(rest_context, options, request); + }, + *current, request, __func__); +} + +future> +ReservationSlotsRestConnectionImpl::GetVersion( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestAwaitLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::zone_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::zone_operations::v1::DeleteOperationRequest>( + background_->cq(), current, operation, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [operation]( + std::string const&, + google::cloud::cpp::compute::zone_operations::v1::GetOperationRequest& + r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_zone(info.zone); + r.set_operation(info.operation); + }, + [operation](std::string const&, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_zone(info.zone); + r.set_operation(info.operation); + }); +} + +StreamRange +ReservationSlotsRestConnectionImpl::ListReservationSlots( + google::cloud::cpp::compute::reservation_slots::v1:: + ListReservationSlotsRequest request) { + request.clear_page_token(); + auto current = google::cloud::internal::SaveCurrentOptions(); + auto idempotency = + idempotency_policy(*current)->ListReservationSlots(request); + char const* function_name = __func__; + return google::cloud::internal::MakePaginationRange< + StreamRange>( + current, std::move(request), + [idempotency, function_name, stub = stub_, + retry = std::shared_ptr< + compute_reservation_slots_v1::ReservationSlotsRetryPolicy>( + retry_policy(*current)), + backoff = std::shared_ptr(backoff_policy(*current))]( + Options const& options, + google::cloud::cpp::compute::reservation_slots::v1:: + ListReservationSlotsRequest const& r) { + return google::cloud::rest_internal::RestRetryLoop( + retry->clone(), backoff->clone(), idempotency, + [stub](rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reservation_slots::v1:: + ListReservationSlotsRequest const& request) { + return stub->ListReservationSlots(rest_context, options, request); + }, + options, r, function_name); + }, + [](google::cloud::cpp::compute::v1::ReservationSlotsListResponse r) { + std::vector result( + r.items().size()); + auto& messages = *r.mutable_items(); + std::move(messages.begin(), messages.end(), result.begin()); + return result; + }); +} + +future> +ReservationSlotsRestConnectionImpl::UpdateReservationSlotsGetResponse( + google::cloud::cpp::compute::reservation_slots::v1:: + UpdateReservationSlotsGetResponseRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::zone_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::zone_operations::v1::DeleteOperationRequest>( + background_->cq(), current, request, + [stub = stub_]( + CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::reservation_slots::v1:: + UpdateReservationSlotsGetResponseRequest const& request) { + return stub->AsyncUpdateReservationSlotsGetResponse( + cq, std::move(context), std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->UpdateReservationSlotsGetResponse(request), + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [request]( + std::string const& op, + google::cloud::cpp::compute::zone_operations::v1::GetOperationRequest& + r) { + r.set_project(request.project()); + r.set_zone(request.zone()); + r.set_operation(op); + }, + [request](std::string const& op, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest& r) { + r.set_project(request.project()); + r.set_zone(request.zone()); + r.set_operation(op); + }); +} + +StatusOr +ReservationSlotsRestConnectionImpl::UpdateReservationSlotsGetResponse( + NoAwaitTag, google::cloud::cpp::compute::reservation_slots::v1:: + UpdateReservationSlotsGetResponseRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->UpdateReservationSlotsGetResponse(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::reservation_slots::v1:: + UpdateReservationSlotsGetResponseRequest const& request) { + return stub_->UpdateReservationSlotsGetResponse(rest_context, options, + request); + }, + *current, request, __func__); +} + +future> +ReservationSlotsRestConnectionImpl::UpdateReservationSlotsGetResponse( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestAwaitLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::zone_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::zone_operations::v1::DeleteOperationRequest>( + background_->cq(), current, operation, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [operation]( + std::string const&, + google::cloud::cpp::compute::zone_operations::v1::GetOperationRequest& + r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_zone(info.zone); + r.set_operation(info.operation); + }, + [operation](std::string const&, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_zone(info.zone); + r.set_operation(info.operation); + }); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_reservation_slots_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/reservation_slots/v1/internal/reservation_slots_rest_connection_impl.h b/google/cloud/compute/reservation_slots/v1/internal/reservation_slots_rest_connection_impl.h new file mode 100644 index 0000000000000..f5a5954bdfbcc --- /dev/null +++ b/google/cloud/compute/reservation_slots/v1/internal/reservation_slots_rest_connection_impl.h @@ -0,0 +1,134 @@ +// Copyright 2026 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. +// source: google/cloud/compute/reservation_slots/v1/reservation_slots.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RESERVATION_SLOTS_V1_INTERNAL_RESERVATION_SLOTS_REST_CONNECTION_IMPL_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RESERVATION_SLOTS_V1_INTERNAL_RESERVATION_SLOTS_REST_CONNECTION_IMPL_H + +#include "google/cloud/compute/reservation_slots/v1/internal/reservation_slots_rest_stub.h" +#include "google/cloud/compute/reservation_slots/v1/internal/reservation_slots_retry_traits.h" +#include "google/cloud/compute/reservation_slots/v1/reservation_slots_connection.h" +#include "google/cloud/compute/reservation_slots/v1/reservation_slots_connection_idempotency_policy.h" +#include "google/cloud/compute/reservation_slots/v1/reservation_slots_options.h" +#include "google/cloud/compute/zone_operations/v1/zone_operations.pb.h" +#include "google/cloud/background_threads.h" +#include "google/cloud/backoff_policy.h" +#include "google/cloud/options.h" +#include "google/cloud/status_or.h" +#include "google/cloud/stream_range.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_reservation_slots_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class ReservationSlotsRestConnectionImpl + : public compute_reservation_slots_v1::ReservationSlotsConnection { + public: + ~ReservationSlotsRestConnectionImpl() override = default; + + ReservationSlotsRestConnectionImpl( + std::unique_ptr background, + std::shared_ptr< + compute_reservation_slots_v1_internal::ReservationSlotsRestStub> + stub, + Options options); + + Options options() override { return options_; } + + StatusOr + GetReservationSlotsGetResponse( + google::cloud::cpp::compute::reservation_slots::v1:: + GetReservationSlotsGetResponseRequest const& request) override; + + future> GetVersion( + google::cloud::cpp::compute::reservation_slots::v1:: + GetVersionRequest const& request) override; + + StatusOr GetVersion( + NoAwaitTag, google::cloud::cpp::compute::reservation_slots::v1:: + GetVersionRequest const& request) override; + + future> GetVersion( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + StreamRange + ListReservationSlots(google::cloud::cpp::compute::reservation_slots::v1:: + ListReservationSlotsRequest request) override; + + future> + UpdateReservationSlotsGetResponse( + google::cloud::cpp::compute::reservation_slots::v1:: + UpdateReservationSlotsGetResponseRequest const& request) override; + + StatusOr + UpdateReservationSlotsGetResponse( + NoAwaitTag, + google::cloud::cpp::compute::reservation_slots::v1:: + UpdateReservationSlotsGetResponseRequest const& request) override; + + future> + UpdateReservationSlotsGetResponse( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + private: + static std::unique_ptr< + compute_reservation_slots_v1::ReservationSlotsRetryPolicy> + retry_policy(Options const& options) { + return options + .get() + ->clone(); + } + + static std::unique_ptr backoff_policy(Options const& options) { + return options + .get< + compute_reservation_slots_v1::ReservationSlotsBackoffPolicyOption>() + ->clone(); + } + + static std::unique_ptr< + compute_reservation_slots_v1::ReservationSlotsConnectionIdempotencyPolicy> + idempotency_policy(Options const& options) { + return options + .get() + ->clone(); + } + + static std::unique_ptr polling_policy(Options const& options) { + return options + .get< + compute_reservation_slots_v1::ReservationSlotsPollingPolicyOption>() + ->clone(); + } + + std::unique_ptr background_; + std::shared_ptr< + compute_reservation_slots_v1_internal::ReservationSlotsRestStub> + stub_; + Options options_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_reservation_slots_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RESERVATION_SLOTS_V1_INTERNAL_RESERVATION_SLOTS_REST_CONNECTION_IMPL_H diff --git a/google/cloud/compute/reservation_slots/v1/internal/reservation_slots_rest_logging_decorator.cc b/google/cloud/compute/reservation_slots/v1/internal/reservation_slots_rest_logging_decorator.cc new file mode 100644 index 0000000000000..cd98a11f94573 --- /dev/null +++ b/google/cloud/compute/reservation_slots/v1/internal/reservation_slots_rest_logging_decorator.cc @@ -0,0 +1,177 @@ +// Copyright 2026 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. +// source: google/cloud/compute/reservation_slots/v1/reservation_slots.proto + +#include "google/cloud/compute/reservation_slots/v1/internal/reservation_slots_rest_logging_decorator.h" +#include "google/cloud/internal/log_wrapper.h" +#include "google/cloud/status_or.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_reservation_slots_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +ReservationSlotsRestLogging::ReservationSlotsRestLogging( + std::shared_ptr child, + TracingOptions tracing_options, std::set components) + : child_(std::move(child)), + tracing_options_(std::move(tracing_options)), + components_(std::move(components)) {} + +StatusOr +ReservationSlotsRestLogging::GetReservationSlotsGetResponse( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::reservation_slots::v1:: + GetReservationSlotsGetResponseRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::reservation_slots::v1:: + GetReservationSlotsGetResponseRequest const& request) { + return child_->GetReservationSlotsGetResponse(rest_context, options, + request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +future> +ReservationSlotsRestLogging::AsyncGetVersion( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::reservation_slots::v1::GetVersionRequest const& + request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::reservation_slots::v1:: + GetVersionRequest const& request) { + return child_->AsyncGetVersion(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +StatusOr +ReservationSlotsRestLogging::GetVersion( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::reservation_slots::v1::GetVersionRequest const& + request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::reservation_slots::v1:: + GetVersionRequest const& request) { + return child_->GetVersion(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +StatusOr +ReservationSlotsRestLogging::ListReservationSlots( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::reservation_slots::v1:: + ListReservationSlotsRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::reservation_slots::v1:: + ListReservationSlotsRequest const& request) { + return child_->ListReservationSlots(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +future> +ReservationSlotsRestLogging::AsyncUpdateReservationSlotsGetResponse( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::reservation_slots::v1:: + UpdateReservationSlotsGetResponseRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::reservation_slots::v1:: + UpdateReservationSlotsGetResponseRequest const& request) { + return child_->AsyncUpdateReservationSlotsGetResponse( + cq, std::move(rest_context), std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +StatusOr +ReservationSlotsRestLogging::UpdateReservationSlotsGetResponse( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::reservation_slots::v1:: + UpdateReservationSlotsGetResponseRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::reservation_slots::v1:: + UpdateReservationSlotsGetResponseRequest const& request) { + return child_->UpdateReservationSlotsGetResponse(rest_context, options, + request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +future> +ReservationSlotsRestLogging::AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1::GetOperationRequest const& + request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + GetOperationRequest const& request) { + return child_->AsyncGetOperation(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +future ReservationSlotsRestLogging::AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest const& request) { + return child_->AsyncCancelOperation(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_reservation_slots_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/reservation_slots/v1/internal/reservation_slots_rest_logging_decorator.h b/google/cloud/compute/reservation_slots/v1/internal/reservation_slots_rest_logging_decorator.h new file mode 100644 index 0000000000000..59cc041217d17 --- /dev/null +++ b/google/cloud/compute/reservation_slots/v1/internal/reservation_slots_rest_logging_decorator.h @@ -0,0 +1,112 @@ +// Copyright 2026 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. +// source: google/cloud/compute/reservation_slots/v1/reservation_slots.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RESERVATION_SLOTS_V1_INTERNAL_RESERVATION_SLOTS_REST_LOGGING_DECORATOR_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RESERVATION_SLOTS_V1_INTERNAL_RESERVATION_SLOTS_REST_LOGGING_DECORATOR_H + +#include "google/cloud/compute/reservation_slots/v1/internal/reservation_slots_rest_stub.h" +#include "google/cloud/compute/reservation_slots/v1/reservation_slots.pb.h" +#include "google/cloud/compute/zone_operations/v1/zone_operations.pb.h" +#include "google/cloud/future.h" +#include "google/cloud/internal/rest_context.h" +#include "google/cloud/tracing_options.h" +#include "google/cloud/version.h" +#include +#include +#include + +namespace google { +namespace cloud { +namespace compute_reservation_slots_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class ReservationSlotsRestLogging : public ReservationSlotsRestStub { + public: + ~ReservationSlotsRestLogging() override = default; + ReservationSlotsRestLogging(std::shared_ptr child, + TracingOptions tracing_options, + std::set components); + + StatusOr + GetReservationSlotsGetResponse( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reservation_slots::v1:: + GetReservationSlotsGetResponseRequest const& request) override; + + future> AsyncGetVersion( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::reservation_slots::v1:: + GetVersionRequest const& request) override; + + StatusOr GetVersion( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reservation_slots::v1:: + GetVersionRequest const& request) override; + + StatusOr + ListReservationSlots(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reservation_slots::v1:: + ListReservationSlotsRequest const& request) override; + + future> + AsyncUpdateReservationSlotsGetResponse( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::reservation_slots::v1:: + UpdateReservationSlotsGetResponseRequest const& request) override; + + StatusOr + UpdateReservationSlotsGetResponse( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reservation_slots::v1:: + UpdateReservationSlotsGetResponseRequest const& request) override; + + future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + GetOperationRequest const& request) override; + + future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest const& request) override; + + private: + std::shared_ptr child_; + TracingOptions tracing_options_; + std::set components_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_reservation_slots_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RESERVATION_SLOTS_V1_INTERNAL_RESERVATION_SLOTS_REST_LOGGING_DECORATOR_H diff --git a/google/cloud/compute/reservation_slots/v1/internal/reservation_slots_rest_metadata_decorator.cc b/google/cloud/compute/reservation_slots/v1/internal/reservation_slots_rest_metadata_decorator.cc new file mode 100644 index 0000000000000..607d00becf7c5 --- /dev/null +++ b/google/cloud/compute/reservation_slots/v1/internal/reservation_slots_rest_metadata_decorator.cc @@ -0,0 +1,136 @@ +// Copyright 2026 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. +// source: google/cloud/compute/reservation_slots/v1/reservation_slots.proto + +#include "google/cloud/compute/reservation_slots/v1/internal/reservation_slots_rest_metadata_decorator.h" +#include "google/cloud/internal/api_client_header.h" +#include "google/cloud/internal/rest_set_metadata.h" +#include "google/cloud/status_or.h" +#include "absl/strings/str_cat.h" +#include "absl/strings/str_format.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_reservation_slots_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +ReservationSlotsRestMetadata::ReservationSlotsRestMetadata( + std::shared_ptr child, + std::string api_client_header) + : child_(std::move(child)), + api_client_header_( + api_client_header.empty() + ? google::cloud::internal::GeneratedLibClientHeader() + : std::move(api_client_header)) {} + +StatusOr +ReservationSlotsRestMetadata::GetReservationSlotsGetResponse( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::reservation_slots::v1:: + GetReservationSlotsGetResponseRequest const& request) { + SetMetadata(rest_context, options); + return child_->GetReservationSlotsGetResponse(rest_context, options, request); +} + +future> +ReservationSlotsRestMetadata::AsyncGetVersion( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::reservation_slots::v1::GetVersionRequest const& + request) { + SetMetadata(*rest_context, *options); + return child_->AsyncGetVersion(cq, std::move(rest_context), + std::move(options), request); +} + +StatusOr +ReservationSlotsRestMetadata::GetVersion( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::reservation_slots::v1::GetVersionRequest const& + request) { + SetMetadata(rest_context, options); + return child_->GetVersion(rest_context, options, request); +} + +StatusOr +ReservationSlotsRestMetadata::ListReservationSlots( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::reservation_slots::v1:: + ListReservationSlotsRequest const& request) { + SetMetadata(rest_context, options); + return child_->ListReservationSlots(rest_context, options, request); +} + +future> +ReservationSlotsRestMetadata::AsyncUpdateReservationSlotsGetResponse( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::reservation_slots::v1:: + UpdateReservationSlotsGetResponseRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncUpdateReservationSlotsGetResponse( + cq, std::move(rest_context), std::move(options), request); +} + +StatusOr +ReservationSlotsRestMetadata::UpdateReservationSlotsGetResponse( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::reservation_slots::v1:: + UpdateReservationSlotsGetResponseRequest const& request) { + SetMetadata(rest_context, options); + return child_->UpdateReservationSlotsGetResponse(rest_context, options, + request); +} + +future> +ReservationSlotsRestMetadata::AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1::GetOperationRequest const& + request) { + SetMetadata(*rest_context, *options); + return child_->AsyncGetOperation(cq, std::move(rest_context), + std::move(options), request); +} + +future ReservationSlotsRestMetadata::AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncCancelOperation(cq, std::move(rest_context), + std::move(options), request); +} + +void ReservationSlotsRestMetadata::SetMetadata( + rest_internal::RestContext& rest_context, Options const& options, + std::vector const& params) { + google::cloud::rest_internal::SetMetadata(rest_context, options, params, + api_client_header_); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_reservation_slots_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/reservation_slots/v1/internal/reservation_slots_rest_metadata_decorator.h b/google/cloud/compute/reservation_slots/v1/internal/reservation_slots_rest_metadata_decorator.h new file mode 100644 index 0000000000000..b988c3611a348 --- /dev/null +++ b/google/cloud/compute/reservation_slots/v1/internal/reservation_slots_rest_metadata_decorator.h @@ -0,0 +1,114 @@ +// Copyright 2026 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. +// source: google/cloud/compute/reservation_slots/v1/reservation_slots.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RESERVATION_SLOTS_V1_INTERNAL_RESERVATION_SLOTS_REST_METADATA_DECORATOR_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RESERVATION_SLOTS_V1_INTERNAL_RESERVATION_SLOTS_REST_METADATA_DECORATOR_H + +#include "google/cloud/compute/reservation_slots/v1/internal/reservation_slots_rest_stub.h" +#include "google/cloud/compute/reservation_slots/v1/reservation_slots.pb.h" +#include "google/cloud/compute/zone_operations/v1/zone_operations.pb.h" +#include "google/cloud/future.h" +#include "google/cloud/rest_options.h" +#include "google/cloud/version.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_reservation_slots_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class ReservationSlotsRestMetadata : public ReservationSlotsRestStub { + public: + ~ReservationSlotsRestMetadata() override = default; + explicit ReservationSlotsRestMetadata( + std::shared_ptr child, + std::string api_client_header = ""); + + StatusOr + GetReservationSlotsGetResponse( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reservation_slots::v1:: + GetReservationSlotsGetResponseRequest const& request) override; + + google::cloud::future> + AsyncGetVersion( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::reservation_slots::v1:: + GetVersionRequest const& request) override; + + StatusOr GetVersion( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reservation_slots::v1:: + GetVersionRequest const& request) override; + + StatusOr + ListReservationSlots(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reservation_slots::v1:: + ListReservationSlotsRequest const& request) override; + + google::cloud::future> + AsyncUpdateReservationSlotsGetResponse( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::reservation_slots::v1:: + UpdateReservationSlotsGetResponseRequest const& request) override; + + StatusOr + UpdateReservationSlotsGetResponse( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reservation_slots::v1:: + UpdateReservationSlotsGetResponseRequest const& request) override; + + google::cloud::future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + GetOperationRequest const& request) override; + + google::cloud::future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest const& request) override; + + private: + void SetMetadata(rest_internal::RestContext& rest_context, + Options const& options, + std::vector const& params = {}); + + std::shared_ptr child_; + std::string api_client_header_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_reservation_slots_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RESERVATION_SLOTS_V1_INTERNAL_RESERVATION_SLOTS_REST_METADATA_DECORATOR_H diff --git a/google/cloud/compute/reservation_slots/v1/internal/reservation_slots_rest_stub.cc b/google/cloud/compute/reservation_slots/v1/internal/reservation_slots_rest_stub.cc new file mode 100644 index 0000000000000..0544d4edefe51 --- /dev/null +++ b/google/cloud/compute/reservation_slots/v1/internal/reservation_slots_rest_stub.cc @@ -0,0 +1,280 @@ +// Copyright 2026 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. +// source: google/cloud/compute/reservation_slots/v1/reservation_slots.proto + +#include "google/cloud/compute/reservation_slots/v1/internal/reservation_slots_rest_stub.h" +#include "google/cloud/compute/reservation_slots/v1/reservation_slots.pb.h" +#include "google/cloud/compute/zone_operations/v1/zone_operations.pb.h" +#include "google/cloud/common_options.h" +#include "google/cloud/internal/rest_stub_helpers.h" +#include "google/cloud/status_or.h" +#include "absl/strings/str_cat.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_reservation_slots_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +DefaultReservationSlotsRestStub::DefaultReservationSlotsRestStub( + Options options) + : service_(rest_internal::MakePooledRestClient( + options.get(), options)), + operations_(rest_internal::MakePooledRestClient( + options.get(), options)), + options_(std::move(options)) {} + +DefaultReservationSlotsRestStub::DefaultReservationSlotsRestStub( + std::shared_ptr service, + std::shared_ptr operations, Options options) + : service_(std::move(service)), + operations_(std::move(operations)), + options_(std::move(options)) {} + +StatusOr +DefaultReservationSlotsRestStub::GetReservationSlotsGetResponse( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reservation_slots::v1:: + GetReservationSlotsGetResponseRequest const& request) { + std::vector> query_params; + return rest_internal::Get< + google::cloud::cpp::compute::v1::ReservationSlotsGetResponse>( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "zones", "/", + request.zone(), "/", request.parent_name(), "/", + "reservationSlots", "/", request.reservation_slot()), + std::move(query_params)); +} + +future> +DefaultReservationSlotsRestStub::AsyncGetVersion( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::reservation_slots::v1::GetVersionRequest const& + request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto service, auto request, auto rest_context, auto options) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + p.set_value( + rest_internal::Post( + *service, *rest_context, + request.reservation_slots_get_version_request_resource(), false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", *options), + "/", "projects", "/", request.project(), "/", + "zones", "/", request.zone(), "/", + request.parent_name(), "/", "reservationSlots", + "/", request.reservation_slot(), "/", + "getVersion"), + std::move(query_params))); + }, + std::move(p), + service_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +StatusOr +DefaultReservationSlotsRestStub::GetVersion( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reservation_slots::v1::GetVersionRequest const& + request) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Post( + *service_, rest_context, + request.reservation_slots_get_version_request_resource(), false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "zones", "/", + request.zone(), "/", request.parent_name(), "/", + "reservationSlots", "/", request.reservation_slot(), "/", + "getVersion"), + std::move(query_params)); +} + +StatusOr +DefaultReservationSlotsRestStub::ListReservationSlots( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reservation_slots::v1:: + ListReservationSlotsRequest const& request) { + std::vector> query_params; + query_params.push_back({"filter", request.filter()}); + query_params.push_back( + {"max_results", std::to_string(request.max_results())}); + query_params.push_back({"order_by", request.order_by()}); + query_params.push_back({"page_token", request.page_token()}); + query_params.push_back({"return_partial_success", + (request.return_partial_success() ? "1" : "0")}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Get< + google::cloud::cpp::compute::v1::ReservationSlotsListResponse>( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "zones", "/", + request.zone(), "/", request.parent_name(), "/", + "reservationSlots"), + std::move(query_params)); +} + +future> +DefaultReservationSlotsRestStub::AsyncUpdateReservationSlotsGetResponse( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::reservation_slots::v1:: + UpdateReservationSlotsGetResponseRequest const& request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto service, auto request, auto rest_context, auto options) { + std::vector> query_params; + query_params.push_back({"update_mask", request.update_mask()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + p.set_value( + rest_internal::Post( + *service, *rest_context, request.reservation_slot_resource(), + false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", *options), + "/", "projects", "/", request.project(), "/", + "zones", "/", request.zone(), "/", + request.parent_name(), "/", "reservationSlots", + "/", request.reservation_slot()), + std::move(query_params))); + }, + std::move(p), + service_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +StatusOr +DefaultReservationSlotsRestStub::UpdateReservationSlotsGetResponse( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reservation_slots::v1:: + UpdateReservationSlotsGetResponseRequest const& request) { + std::vector> query_params; + query_params.push_back({"update_mask", request.update_mask()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Post( + *service_, rest_context, request.reservation_slot_resource(), false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "zones", "/", + request.zone(), "/", request.parent_name(), "/", + "reservationSlots", "/", request.reservation_slot()), + std::move(query_params)); +} + +future> +DefaultReservationSlotsRestStub::AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1::GetOperationRequest const& + request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto operations, auto request, auto rest_context, + auto options) { + p.set_value( + rest_internal::Get( + *operations, *rest_context, request, false, + absl::StrCat("/compute/", + rest_internal::DetermineApiVersion("v1", *options), + "/projects/", request.project(), "/zones/", + request.zone(), "/operations/", + request.operation()))); + }, + std::move(p), + operations_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +future DefaultReservationSlotsRestStub::AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest const& request) { + promise> p; + future> f = p.get_future(); + std::thread t{ + [](auto p, auto operations, auto request, auto rest_context, + auto options) { + p.set_value(rest_internal::Post( + *operations, *rest_context, request, false, + absl::StrCat("/compute/", + rest_internal::DetermineApiVersion("v1", *options), + "/projects/", request.project(), "/zones/", + request.zone(), "/operations/", request.operation()))); + }, + std::move(p), + operations_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get().status(); + }); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_reservation_slots_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/reservation_slots/v1/internal/reservation_slots_rest_stub.h b/google/cloud/compute/reservation_slots/v1/internal/reservation_slots_rest_stub.h new file mode 100644 index 0000000000000..c5367c2b4f708 --- /dev/null +++ b/google/cloud/compute/reservation_slots/v1/internal/reservation_slots_rest_stub.h @@ -0,0 +1,175 @@ +// Copyright 2026 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. +// source: google/cloud/compute/reservation_slots/v1/reservation_slots.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RESERVATION_SLOTS_V1_INTERNAL_RESERVATION_SLOTS_REST_STUB_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RESERVATION_SLOTS_V1_INTERNAL_RESERVATION_SLOTS_REST_STUB_H + +#include "google/cloud/compute/reservation_slots/v1/reservation_slots.pb.h" +#include "google/cloud/compute/zone_operations/v1/zone_operations.pb.h" +#include "google/cloud/completion_queue.h" +#include "google/cloud/internal/rest_client.h" +#include "google/cloud/internal/rest_context.h" +#include "google/cloud/status_or.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_reservation_slots_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class ReservationSlotsRestStub { + public: + virtual ~ReservationSlotsRestStub() = default; + + virtual StatusOr + GetReservationSlotsGetResponse( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reservation_slots::v1:: + GetReservationSlotsGetResponseRequest const& request) = 0; + + virtual future> + AsyncGetVersion( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::reservation_slots::v1:: + GetVersionRequest const& request) = 0; + + virtual StatusOr GetVersion( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reservation_slots::v1:: + GetVersionRequest const& request) = 0; + + virtual StatusOr< + google::cloud::cpp::compute::v1::ReservationSlotsListResponse> + ListReservationSlots(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reservation_slots::v1:: + ListReservationSlotsRequest const& request) = 0; + + virtual future> + AsyncUpdateReservationSlotsGetResponse( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::reservation_slots::v1:: + UpdateReservationSlotsGetResponseRequest const& request) = 0; + + virtual StatusOr + UpdateReservationSlotsGetResponse( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reservation_slots::v1:: + UpdateReservationSlotsGetResponseRequest const& request) = 0; + + virtual future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + GetOperationRequest const& request) = 0; + + virtual future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest const& request) = 0; +}; + +class DefaultReservationSlotsRestStub : public ReservationSlotsRestStub { + public: + ~DefaultReservationSlotsRestStub() override = default; + + explicit DefaultReservationSlotsRestStub(Options options); + DefaultReservationSlotsRestStub( + std::shared_ptr service, + std::shared_ptr operations, Options options); + + StatusOr + GetReservationSlotsGetResponse( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reservation_slots::v1:: + GetReservationSlotsGetResponseRequest const& request) override; + + future> AsyncGetVersion( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::reservation_slots::v1:: + GetVersionRequest const& request) override; + + StatusOr GetVersion( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reservation_slots::v1:: + GetVersionRequest const& request) override; + + StatusOr + ListReservationSlots(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reservation_slots::v1:: + ListReservationSlotsRequest const& request) override; + + future> + AsyncUpdateReservationSlotsGetResponse( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::reservation_slots::v1:: + UpdateReservationSlotsGetResponseRequest const& request) override; + + StatusOr + UpdateReservationSlotsGetResponse( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reservation_slots::v1:: + UpdateReservationSlotsGetResponseRequest const& request) override; + + future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + GetOperationRequest const& request) override; + + future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest const& request) override; + + private: + std::shared_ptr service_; + std::shared_ptr operations_; + Options options_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_reservation_slots_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RESERVATION_SLOTS_V1_INTERNAL_RESERVATION_SLOTS_REST_STUB_H diff --git a/google/cloud/compute/reservation_slots/v1/internal/reservation_slots_rest_stub_factory.cc b/google/cloud/compute/reservation_slots/v1/internal/reservation_slots_rest_stub_factory.cc new file mode 100644 index 0000000000000..6a0744463c64c --- /dev/null +++ b/google/cloud/compute/reservation_slots/v1/internal/reservation_slots_rest_stub_factory.cc @@ -0,0 +1,56 @@ +// Copyright 2026 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. +// source: google/cloud/compute/reservation_slots/v1/reservation_slots.proto + +#include "google/cloud/compute/reservation_slots/v1/internal/reservation_slots_rest_stub_factory.h" +#include "google/cloud/compute/reservation_slots/v1/internal/reservation_slots_rest_logging_decorator.h" +#include "google/cloud/compute/reservation_slots/v1/internal/reservation_slots_rest_metadata_decorator.h" +#include "google/cloud/compute/reservation_slots/v1/internal/reservation_slots_rest_stub.h" +#include "google/cloud/common_options.h" +#include "google/cloud/internal/algorithm.h" +#include "google/cloud/internal/populate_rest_options.h" +#include "google/cloud/log.h" +#include "google/cloud/options.h" +#include "google/cloud/rest_options.h" +#include "absl/strings/match.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_reservation_slots_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +std::shared_ptr CreateDefaultReservationSlotsRestStub( + Options const& options) { + auto opts = internal::PopulateRestOptions(options); + std::shared_ptr stub = + std::make_shared(std::move(opts)); + stub = std::make_shared(std::move(stub)); + if (internal::Contains(options.get(), "rpc")) { + GCP_LOG(INFO) << "Enabled logging for REST rpc calls"; + stub = std::make_shared( + std::move(stub), options.get(), + options.get()); + } + return stub; +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_reservation_slots_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/reservation_slots/v1/internal/reservation_slots_rest_stub_factory.h b/google/cloud/compute/reservation_slots/v1/internal/reservation_slots_rest_stub_factory.h new file mode 100644 index 0000000000000..bd3da478bdf84 --- /dev/null +++ b/google/cloud/compute/reservation_slots/v1/internal/reservation_slots_rest_stub_factory.h @@ -0,0 +1,40 @@ +// Copyright 2026 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. +// source: google/cloud/compute/reservation_slots/v1/reservation_slots.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RESERVATION_SLOTS_V1_INTERNAL_RESERVATION_SLOTS_REST_STUB_FACTORY_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RESERVATION_SLOTS_V1_INTERNAL_RESERVATION_SLOTS_REST_STUB_FACTORY_H + +#include "google/cloud/compute/reservation_slots/v1/internal/reservation_slots_rest_stub.h" +#include "google/cloud/options.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_reservation_slots_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +std::shared_ptr CreateDefaultReservationSlotsRestStub( + Options const& options); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_reservation_slots_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RESERVATION_SLOTS_V1_INTERNAL_RESERVATION_SLOTS_REST_STUB_FACTORY_H diff --git a/google/cloud/compute/reservation_slots/v1/internal/reservation_slots_retry_traits.h b/google/cloud/compute/reservation_slots/v1/internal/reservation_slots_retry_traits.h new file mode 100644 index 0000000000000..1a95208b4953f --- /dev/null +++ b/google/cloud/compute/reservation_slots/v1/internal/reservation_slots_retry_traits.h @@ -0,0 +1,43 @@ +// Copyright 2026 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. +// source: google/cloud/compute/reservation_slots/v1/reservation_slots.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RESERVATION_SLOTS_V1_INTERNAL_RESERVATION_SLOTS_RETRY_TRAITS_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RESERVATION_SLOTS_V1_INTERNAL_RESERVATION_SLOTS_RETRY_TRAITS_H + +#include "google/cloud/status.h" +#include "google/cloud/version.h" + +namespace google { +namespace cloud { +namespace compute_reservation_slots_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/// Define the gRPC status code semantics for retrying requests. +struct ReservationSlotsRetryTraits { + static bool IsPermanentFailure(google::cloud::Status const& status) { + return status.code() != StatusCode::kOk && + status.code() != StatusCode::kUnavailable; + } +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_reservation_slots_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RESERVATION_SLOTS_V1_INTERNAL_RESERVATION_SLOTS_RETRY_TRAITS_H diff --git a/google/cloud/compute/reservation_slots/v1/internal/reservation_slots_sources.cc b/google/cloud/compute/reservation_slots/v1/internal/reservation_slots_sources.cc new file mode 100644 index 0000000000000..9a34f64c7870d --- /dev/null +++ b/google/cloud/compute/reservation_slots/v1/internal/reservation_slots_sources.cc @@ -0,0 +1,31 @@ +// Copyright 2026 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. +// source: google/cloud/compute/reservation_slots/v1/reservation_slots.proto + +// NOLINTBEGIN(bugprone-suspicious-include) +#include "google/cloud/compute/reservation_slots/v1/internal/reservation_slots_option_defaults.cc" +#include "google/cloud/compute/reservation_slots/v1/internal/reservation_slots_rest_connection_impl.cc" +#include "google/cloud/compute/reservation_slots/v1/internal/reservation_slots_rest_logging_decorator.cc" +#include "google/cloud/compute/reservation_slots/v1/internal/reservation_slots_rest_metadata_decorator.cc" +#include "google/cloud/compute/reservation_slots/v1/internal/reservation_slots_rest_stub.cc" +#include "google/cloud/compute/reservation_slots/v1/internal/reservation_slots_rest_stub_factory.cc" +#include "google/cloud/compute/reservation_slots/v1/internal/reservation_slots_tracing_connection.cc" +#include "google/cloud/compute/reservation_slots/v1/reservation_slots_client.cc" +#include "google/cloud/compute/reservation_slots/v1/reservation_slots_connection.cc" +#include "google/cloud/compute/reservation_slots/v1/reservation_slots_connection_idempotency_policy.cc" +#include "google/cloud/compute/reservation_slots/v1/reservation_slots_rest_connection.cc" +// NOLINTEND(bugprone-suspicious-include) diff --git a/google/cloud/compute/reservation_slots/v1/internal/reservation_slots_tracing_connection.cc b/google/cloud/compute/reservation_slots/v1/internal/reservation_slots_tracing_connection.cc new file mode 100644 index 0000000000000..393ae61665997 --- /dev/null +++ b/google/cloud/compute/reservation_slots/v1/internal/reservation_slots_tracing_connection.cc @@ -0,0 +1,139 @@ +// Copyright 2026 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. +// source: google/cloud/compute/reservation_slots/v1/reservation_slots.proto + +#include "google/cloud/compute/reservation_slots/v1/internal/reservation_slots_tracing_connection.h" +#include "google/cloud/internal/opentelemetry.h" +#include "google/cloud/internal/traced_stream_range.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_reservation_slots_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +ReservationSlotsTracingConnection::ReservationSlotsTracingConnection( + std::shared_ptr + child) + : child_(std::move(child)) {} + +StatusOr +ReservationSlotsTracingConnection::GetReservationSlotsGetResponse( + google::cloud::cpp::compute::reservation_slots::v1:: + GetReservationSlotsGetResponseRequest const& request) { + auto span = internal::MakeSpan( + "compute_reservation_slots_v1::ReservationSlotsConnection::" + "GetReservationSlotsGetResponse"); + auto scope = opentelemetry::trace::Scope(span); + return internal::EndSpan(*span, + child_->GetReservationSlotsGetResponse(request)); +} + +future> +ReservationSlotsTracingConnection::GetVersion( + google::cloud::cpp::compute::reservation_slots::v1::GetVersionRequest const& + request) { + auto span = internal::MakeSpan( + "compute_reservation_slots_v1::ReservationSlotsConnection::GetVersion"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), child_->GetVersion(request)); +} + +StatusOr +ReservationSlotsTracingConnection::GetVersion( + NoAwaitTag, + google::cloud::cpp::compute::reservation_slots::v1::GetVersionRequest const& + request) { + auto span = internal::MakeSpan( + "compute_reservation_slots_v1::ReservationSlotsConnection::GetVersion"); + opentelemetry::trace::Scope scope(span); + return internal::EndSpan(*span, child_->GetVersion(NoAwaitTag{}, request)); +} + +future> +ReservationSlotsTracingConnection::GetVersion( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto span = internal::MakeSpan( + "compute_reservation_slots_v1::ReservationSlotsConnection::GetVersion"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), child_->GetVersion(operation)); +} + +StreamRange +ReservationSlotsTracingConnection::ListReservationSlots( + google::cloud::cpp::compute::reservation_slots::v1:: + ListReservationSlotsRequest request) { + auto span = internal::MakeSpan( + "compute_reservation_slots_v1::ReservationSlotsConnection::" + "ListReservationSlots"); + internal::OTelScope scope(span); + auto sr = child_->ListReservationSlots(std::move(request)); + return internal::MakeTracedStreamRange< + google::cloud::cpp::compute::v1::ReservationSlot>(std::move(span), + std::move(sr)); +} + +future> +ReservationSlotsTracingConnection::UpdateReservationSlotsGetResponse( + google::cloud::cpp::compute::reservation_slots::v1:: + UpdateReservationSlotsGetResponseRequest const& request) { + auto span = internal::MakeSpan( + "compute_reservation_slots_v1::ReservationSlotsConnection::" + "UpdateReservationSlotsGetResponse"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), + child_->UpdateReservationSlotsGetResponse(request)); +} + +StatusOr +ReservationSlotsTracingConnection::UpdateReservationSlotsGetResponse( + NoAwaitTag, google::cloud::cpp::compute::reservation_slots::v1:: + UpdateReservationSlotsGetResponseRequest const& request) { + auto span = internal::MakeSpan( + "compute_reservation_slots_v1::ReservationSlotsConnection::" + "UpdateReservationSlotsGetResponse"); + opentelemetry::trace::Scope scope(span); + return internal::EndSpan( + *span, child_->UpdateReservationSlotsGetResponse(NoAwaitTag{}, request)); +} + +future> +ReservationSlotsTracingConnection::UpdateReservationSlotsGetResponse( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto span = internal::MakeSpan( + "compute_reservation_slots_v1::ReservationSlotsConnection::" + "UpdateReservationSlotsGetResponse"); + internal::OTelScope scope(span); + return internal::EndSpan( + std::move(span), child_->UpdateReservationSlotsGetResponse(operation)); +} + +std::shared_ptr +MakeReservationSlotsTracingConnection( + std::shared_ptr + conn) { + if (internal::TracingEnabled(conn->options())) { + conn = std::make_shared(std::move(conn)); + } + return conn; +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_reservation_slots_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/reservation_slots/v1/internal/reservation_slots_tracing_connection.h b/google/cloud/compute/reservation_slots/v1/internal/reservation_slots_tracing_connection.h new file mode 100644 index 0000000000000..5b2be3167841c --- /dev/null +++ b/google/cloud/compute/reservation_slots/v1/internal/reservation_slots_tracing_connection.h @@ -0,0 +1,98 @@ +// Copyright 2026 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. +// source: google/cloud/compute/reservation_slots/v1/reservation_slots.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RESERVATION_SLOTS_V1_INTERNAL_RESERVATION_SLOTS_TRACING_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RESERVATION_SLOTS_V1_INTERNAL_RESERVATION_SLOTS_TRACING_CONNECTION_H + +#include "google/cloud/compute/reservation_slots/v1/reservation_slots_connection.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_reservation_slots_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class ReservationSlotsTracingConnection + : public compute_reservation_slots_v1::ReservationSlotsConnection { + public: + ~ReservationSlotsTracingConnection() override = default; + + explicit ReservationSlotsTracingConnection( + std::shared_ptr + child); + + Options options() override { return child_->options(); } + + StatusOr + GetReservationSlotsGetResponse( + google::cloud::cpp::compute::reservation_slots::v1:: + GetReservationSlotsGetResponseRequest const& request) override; + + future> GetVersion( + google::cloud::cpp::compute::reservation_slots::v1:: + GetVersionRequest const& request) override; + + StatusOr GetVersion( + NoAwaitTag, google::cloud::cpp::compute::reservation_slots::v1:: + GetVersionRequest const& request) override; + + future> GetVersion( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + StreamRange + ListReservationSlots(google::cloud::cpp::compute::reservation_slots::v1:: + ListReservationSlotsRequest request) override; + + future> + UpdateReservationSlotsGetResponse( + google::cloud::cpp::compute::reservation_slots::v1:: + UpdateReservationSlotsGetResponseRequest const& request) override; + + StatusOr + UpdateReservationSlotsGetResponse( + NoAwaitTag, + google::cloud::cpp::compute::reservation_slots::v1:: + UpdateReservationSlotsGetResponseRequest const& request) override; + + future> + UpdateReservationSlotsGetResponse( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + private: + std::shared_ptr + child_; +}; + +/** + * Conditionally applies the tracing decorator to the given connection. + * + * The connection is only decorated if tracing is enabled (as determined by the + * connection's options). + */ +std::shared_ptr +MakeReservationSlotsTracingConnection( + std::shared_ptr + conn); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_reservation_slots_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RESERVATION_SLOTS_V1_INTERNAL_RESERVATION_SLOTS_TRACING_CONNECTION_H diff --git a/google/cloud/compute/reservation_slots/v1/mocks/mock_reservation_slots_connection.h b/google/cloud/compute/reservation_slots/v1/mocks/mock_reservation_slots_connection.h new file mode 100644 index 0000000000000..bf0951c56fad5 --- /dev/null +++ b/google/cloud/compute/reservation_slots/v1/mocks/mock_reservation_slots_connection.h @@ -0,0 +1,150 @@ +// Copyright 2026 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. +// source: google/cloud/compute/reservation_slots/v1/reservation_slots.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RESERVATION_SLOTS_V1_MOCKS_MOCK_RESERVATION_SLOTS_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RESERVATION_SLOTS_V1_MOCKS_MOCK_RESERVATION_SLOTS_CONNECTION_H + +#include "google/cloud/compute/reservation_slots/v1/reservation_slots_connection.h" +#include + +namespace google { +namespace cloud { +namespace compute_reservation_slots_v1_mocks { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/** + * A class to mock `ReservationSlotsConnection`. + * + * Application developers may want to test their code with simulated responses, + * including errors, from an object of type `ReservationSlotsClient`. To do so, + * construct an object of type `ReservationSlotsClient` with an instance of this + * class. Then use the Google Test framework functions to program the behavior + * of this mock. + * + * @see [This example][bq-mock] for how to test your application with GoogleTest. + * While the example showcases types from the BigQuery library, the underlying + * principles apply for any pair of `*Client` and `*Connection`. + * + * [bq-mock]: @cloud_cpp_docs_link{bigquery,bigquery-read-mock} + */ +class MockReservationSlotsConnection + : public compute_reservation_slots_v1::ReservationSlotsConnection { + public: + MOCK_METHOD(Options, options, (), (override)); + + MOCK_METHOD( + StatusOr, + GetReservationSlotsGetResponse, + (google::cloud::cpp::compute::reservation_slots::v1:: + GetReservationSlotsGetResponseRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// GetVersion(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + GetVersion, + (google::cloud::cpp::compute::reservation_slots::v1:: + GetVersionRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// EXPECT_CALL(*mock, GetVersion(_, _)) + /// @endcode + MOCK_METHOD(StatusOr, GetVersion, + (NoAwaitTag, google::cloud::cpp::compute::reservation_slots::v1:: + GetVersionRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// GetVersion(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + GetVersion, + (google::cloud::cpp::compute::v1::Operation const& operation), + (override)); + + MOCK_METHOD((StreamRange), + ListReservationSlots, + (google::cloud::cpp::compute::reservation_slots::v1:: + ListReservationSlotsRequest request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// UpdateReservationSlotsGetResponse(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + UpdateReservationSlotsGetResponse, + (google::cloud::cpp::compute::reservation_slots::v1:: + UpdateReservationSlotsGetResponseRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// EXPECT_CALL(*mock, UpdateReservationSlotsGetResponse(_, _)) + /// @endcode + MOCK_METHOD(StatusOr, + UpdateReservationSlotsGetResponse, + (NoAwaitTag, + google::cloud::cpp::compute::reservation_slots::v1:: + UpdateReservationSlotsGetResponseRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// UpdateReservationSlotsGetResponse(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + UpdateReservationSlotsGetResponse, + (google::cloud::cpp::compute::v1::Operation const& operation), + (override)); +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_reservation_slots_v1_mocks +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RESERVATION_SLOTS_V1_MOCKS_MOCK_RESERVATION_SLOTS_CONNECTION_H diff --git a/google/cloud/compute/reservation_slots/v1/reservation_slots_client.cc b/google/cloud/compute/reservation_slots/v1/reservation_slots_client.cc new file mode 100644 index 0000000000000..b0a3d6b1b9264 --- /dev/null +++ b/google/cloud/compute/reservation_slots/v1/reservation_slots_client.cc @@ -0,0 +1,209 @@ +// Copyright 2026 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. +// source: google/cloud/compute/reservation_slots/v1/reservation_slots.proto + +#include "google/cloud/compute/reservation_slots/v1/reservation_slots_client.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_reservation_slots_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +ReservationSlotsClient::ReservationSlotsClient( + std::shared_ptr connection, Options opts) + : connection_(std::move(connection)), + options_( + internal::MergeOptions(std::move(opts), connection_->options())) {} +ReservationSlotsClient::~ReservationSlotsClient() = default; + +StatusOr +ReservationSlotsClient::GetReservationSlotsGetResponse( + std::string const& project, std::string const& zone, + std::string const& parent_name, std::string const& reservation_slot, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::reservation_slots::v1:: + GetReservationSlotsGetResponseRequest request; + request.set_project(project); + request.set_zone(zone); + request.set_parent_name(parent_name); + request.set_reservation_slot(reservation_slot); + return connection_->GetReservationSlotsGetResponse(request); +} + +StatusOr +ReservationSlotsClient::GetReservationSlotsGetResponse( + google::cloud::cpp::compute::reservation_slots::v1:: + GetReservationSlotsGetResponseRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->GetReservationSlotsGetResponse(request); +} + +future> +ReservationSlotsClient::GetVersion( + std::string const& project, std::string const& zone, + std::string const& parent_name, std::string const& reservation_slot, + google::cloud::cpp::compute::v1::ReservationSlotsGetVersionRequest const& + reservation_slots_get_version_request_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::reservation_slots::v1::GetVersionRequest request; + request.set_project(project); + request.set_zone(zone); + request.set_parent_name(parent_name); + request.set_reservation_slot(reservation_slot); + *request.mutable_reservation_slots_get_version_request_resource() = + reservation_slots_get_version_request_resource; + return connection_->GetVersion(request); +} + +StatusOr +ReservationSlotsClient::GetVersion( + NoAwaitTag, std::string const& project, std::string const& zone, + std::string const& parent_name, std::string const& reservation_slot, + google::cloud::cpp::compute::v1::ReservationSlotsGetVersionRequest const& + reservation_slots_get_version_request_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::reservation_slots::v1::GetVersionRequest request; + request.set_project(project); + request.set_zone(zone); + request.set_parent_name(parent_name); + request.set_reservation_slot(reservation_slot); + *request.mutable_reservation_slots_get_version_request_resource() = + reservation_slots_get_version_request_resource; + return connection_->GetVersion(NoAwaitTag{}, request); +} + +future> +ReservationSlotsClient::GetVersion( + google::cloud::cpp::compute::reservation_slots::v1::GetVersionRequest const& + request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->GetVersion(request); +} + +StatusOr +ReservationSlotsClient::GetVersion( + NoAwaitTag, + google::cloud::cpp::compute::reservation_slots::v1::GetVersionRequest const& + request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->GetVersion(NoAwaitTag{}, request); +} + +future> +ReservationSlotsClient::GetVersion( + google::cloud::cpp::compute::v1::Operation const& operation, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->GetVersion(operation); +} + +StreamRange +ReservationSlotsClient::ListReservationSlots(std::string const& project, + std::string const& zone, + std::string const& parent_name, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::reservation_slots::v1:: + ListReservationSlotsRequest request; + request.set_project(project); + request.set_zone(zone); + request.set_parent_name(parent_name); + return connection_->ListReservationSlots(request); +} + +StreamRange +ReservationSlotsClient::ListReservationSlots( + google::cloud::cpp::compute::reservation_slots::v1:: + ListReservationSlotsRequest request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->ListReservationSlots(std::move(request)); +} + +future> +ReservationSlotsClient::UpdateReservationSlotsGetResponse( + std::string const& project, std::string const& zone, + std::string const& parent_name, std::string const& reservation_slot, + google::cloud::cpp::compute::v1::ReservationSlot const& + reservation_slot_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::reservation_slots::v1:: + UpdateReservationSlotsGetResponseRequest request; + request.set_project(project); + request.set_zone(zone); + request.set_parent_name(parent_name); + request.set_reservation_slot(reservation_slot); + *request.mutable_reservation_slot_resource() = reservation_slot_resource; + return connection_->UpdateReservationSlotsGetResponse(request); +} + +StatusOr +ReservationSlotsClient::UpdateReservationSlotsGetResponse( + NoAwaitTag, std::string const& project, std::string const& zone, + std::string const& parent_name, std::string const& reservation_slot, + google::cloud::cpp::compute::v1::ReservationSlot const& + reservation_slot_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::reservation_slots::v1:: + UpdateReservationSlotsGetResponseRequest request; + request.set_project(project); + request.set_zone(zone); + request.set_parent_name(parent_name); + request.set_reservation_slot(reservation_slot); + *request.mutable_reservation_slot_resource() = reservation_slot_resource; + return connection_->UpdateReservationSlotsGetResponse(NoAwaitTag{}, request); +} + +future> +ReservationSlotsClient::UpdateReservationSlotsGetResponse( + google::cloud::cpp::compute::reservation_slots::v1:: + UpdateReservationSlotsGetResponseRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->UpdateReservationSlotsGetResponse(request); +} + +StatusOr +ReservationSlotsClient::UpdateReservationSlotsGetResponse( + NoAwaitTag, + google::cloud::cpp::compute::reservation_slots::v1:: + UpdateReservationSlotsGetResponseRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->UpdateReservationSlotsGetResponse(NoAwaitTag{}, request); +} + +future> +ReservationSlotsClient::UpdateReservationSlotsGetResponse( + google::cloud::cpp::compute::v1::Operation const& operation, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->UpdateReservationSlotsGetResponse(operation); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_reservation_slots_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/reservation_slots/v1/reservation_slots_client.h b/google/cloud/compute/reservation_slots/v1/reservation_slots_client.h new file mode 100644 index 0000000000000..b0d0bf2163923 --- /dev/null +++ b/google/cloud/compute/reservation_slots/v1/reservation_slots_client.h @@ -0,0 +1,512 @@ +// Copyright 2026 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. +// source: google/cloud/compute/reservation_slots/v1/reservation_slots.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RESERVATION_SLOTS_V1_RESERVATION_SLOTS_CLIENT_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RESERVATION_SLOTS_V1_RESERVATION_SLOTS_CLIENT_H + +#include "google/cloud/compute/reservation_slots/v1/reservation_slots_rest_connection.h" +#include "google/cloud/future.h" +#include "google/cloud/no_await_tag.h" +#include "google/cloud/options.h" +#include "google/cloud/polling_policy.h" +#include "google/cloud/status_or.h" +#include "google/cloud/version.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_reservation_slots_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/// +/// Service for the reservationSlots resource. +/// https://cloud.google.com/compute/docs/reference/rest/v1/reservationSlots +/// +/// @par Equality +/// +/// Instances of this class created via copy-construction or copy-assignment +/// always compare equal. Instances created with equal +/// `std::shared_ptr<*Connection>` objects compare equal. Objects that compare +/// equal share the same underlying resources. +/// +/// @par Performance +/// +/// Creating a new instance of this class is a relatively expensive operation, +/// new objects establish new connections to the service. In contrast, +/// copy-construction, move-construction, and the corresponding assignment +/// operations are relatively efficient as the copies share all underlying +/// resources. +/// +/// @par Thread Safety +/// +/// Concurrent access to different instances of this class, even if they compare +/// equal, is guaranteed to work. Two or more threads operating on the same +/// instance of this class is not guaranteed to work. Since copy-construction +/// and move-construction is a relatively efficient operation, consider using +/// such a copy when using this class from multiple threads. +/// +class ReservationSlotsClient { + public: + explicit ReservationSlotsClient( + std::shared_ptr connection, + Options opts = {}); + ~ReservationSlotsClient(); + + ///@{ + /// @name Copy and move support + ReservationSlotsClient(ReservationSlotsClient const&) = default; + ReservationSlotsClient& operator=(ReservationSlotsClient const&) = default; + ReservationSlotsClient(ReservationSlotsClient&&) = default; + ReservationSlotsClient& operator=(ReservationSlotsClient&&) = default; + ///@} + + ///@{ + /// @name Equality + friend bool operator==(ReservationSlotsClient const& a, + ReservationSlotsClient const& b) { + return a.connection_ == b.connection_; + } + friend bool operator!=(ReservationSlotsClient const& a, + ReservationSlotsClient const& b) { + return !(a == b); + } + ///@} + + // clang-format off + /// + /// Retrieves information about the specified reservation slot. + /// https://cloud.google.com/compute/docs/reference/rest/v1/reservationSlots/get + /// + /// @param project The project ID for this request. + /// @param zone The name of the zone for this request, formatted as RFC1035. + /// @param parent_name The name of the parent reservation and parent block, formatted as + /// reservations/{reservation_name}/reservationBlocks/{reservation_block_name}/reservationSubBlocks/{reservation_sub_block_name} + /// @param reservation_slot The name of the reservation slot, formatted as RFC1035 or a resource ID + /// number. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.ReservationSlotsGetResponse]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.reservation_slots.v1.GetReservationSlotsGetResponseRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservation_slots/v1/reservation_slots.proto#L90} + /// [google.cloud.cpp.compute.v1.ReservationSlotsGetResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_133.proto#L103} + /// + // clang-format on + StatusOr + GetReservationSlotsGetResponse(std::string const& project, + std::string const& zone, + std::string const& parent_name, + std::string const& reservation_slot, + Options opts = {}); + + // clang-format off + /// + /// Retrieves information about the specified reservation slot. + /// https://cloud.google.com/compute/docs/reference/rest/v1/reservationSlots/get + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.reservation_slots.v1.GetReservationSlotsGetResponseRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.ReservationSlotsGetResponse]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.reservation_slots.v1.GetReservationSlotsGetResponseRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservation_slots/v1/reservation_slots.proto#L90} + /// [google.cloud.cpp.compute.v1.ReservationSlotsGetResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_133.proto#L103} + /// + // clang-format on + StatusOr + GetReservationSlotsGetResponse( + google::cloud::cpp::compute::reservation_slots::v1:: + GetReservationSlotsGetResponseRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// Allows customers to get SBOM versions of a reservation slot. + /// https://cloud.google.com/compute/docs/reference/rest/v1/reservationSlots/getVersion + /// + /// @param project Project ID for this request. + /// @param zone Name of the zone for this request. Zone name should conform to RFC1035. + /// @param parent_name The name of the parent reservation and parent block. In the format of + /// reservations/{reservation_name}/reservationBlocks/{reservation_block_name}/reservationSubBlocks/{reservation_sub_block_name} + /// @param reservation_slot The name of the reservation slot. + /// Name should conform to RFC1035 or be a resource ID. + /// @param reservation_slots_get_version_request_resource The ReservationSlotsGetVersionRequest for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.reservation_slots.v1.GetVersionRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservation_slots/v1/reservation_slots.proto#L110} + /// + // clang-format on + future> GetVersion( + std::string const& project, std::string const& zone, + std::string const& parent_name, std::string const& reservation_slot, + google::cloud::cpp::compute::v1::ReservationSlotsGetVersionRequest const& + reservation_slots_get_version_request_resource, + Options opts = {}); + + // clang-format off + /// + /// @copybrief GetVersion + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr GetVersion( + NoAwaitTag, std::string const& project, std::string const& zone, + std::string const& parent_name, std::string const& reservation_slot, + google::cloud::cpp::compute::v1::ReservationSlotsGetVersionRequest const& + reservation_slots_get_version_request_resource, + Options opts = {}); + + // clang-format off + /// + /// Allows customers to get SBOM versions of a reservation slot. + /// https://cloud.google.com/compute/docs/reference/rest/v1/reservationSlots/getVersion + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.reservation_slots.v1.GetVersionRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.reservation_slots.v1.GetVersionRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservation_slots/v1/reservation_slots.proto#L110} + /// + // clang-format on + future> GetVersion( + google::cloud::cpp::compute::reservation_slots::v1:: + GetVersionRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief GetVersion + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr GetVersion( + NoAwaitTag, + google::cloud::cpp::compute::reservation_slots::v1:: + GetVersionRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief GetVersion + /// + /// This method accepts a `google::cloud::cpp::compute::v1::Operation` that corresponds + /// to a previously started Long Running Operation (LRO) and polls the status + /// of the LRO in the background. + /// + // clang-format on + future> GetVersion( + google::cloud::cpp::compute::v1::Operation const& operation, + Options opts = {}); + + // clang-format off + /// + /// Retrieves a list of reservation slots under a single reservation. + /// https://cloud.google.com/compute/docs/reference/rest/v1/reservationSlots/list + /// + /// @param project The project ID for this request. + /// @param zone The name of the zone for this request, formatted as RFC1035. + /// @param parent_name The name of the parent reservation and parent block, formatted as + /// reservations/{reservation_name}/reservationBlocks/{reservation_block_name}/reservationSubBlocks/{reservation_sub_block_name} + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return a [StreamRange](@ref google::cloud::StreamRange) + /// to iterate of the results. See the documentation of this type for + /// details. In brief, this class has `begin()` and `end()` member + /// functions returning a iterator class meeting the + /// [input iterator requirements]. The value type for this iterator is a + /// [`StatusOr`] as the iteration may fail even after some values are + /// retrieved successfully, for example, if there is a network disconnect. + /// An empty set of results does not indicate an error, it indicates + /// that there are no resources meeting the request criteria. + /// On a successful iteration the `StatusOr` contains elements of type + /// [google.cloud.cpp.compute.v1.ReservationSlot], or rather, + /// the C++ class generated by Protobuf from that type. Please consult the + /// Protobuf documentation for details on the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.reservation_slots.v1.ListReservationSlotsRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservation_slots/v1/reservation_slots.proto#L157} + /// [google.cloud.cpp.compute.v1.ReservationSlot]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_133.proto#L27} + /// + // clang-format on + StreamRange + ListReservationSlots(std::string const& project, std::string const& zone, + std::string const& parent_name, Options opts = {}); + + // clang-format off + /// + /// Retrieves a list of reservation slots under a single reservation. + /// https://cloud.google.com/compute/docs/reference/rest/v1/reservationSlots/list + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.reservation_slots.v1.ListReservationSlotsRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return a [StreamRange](@ref google::cloud::StreamRange) + /// to iterate of the results. See the documentation of this type for + /// details. In brief, this class has `begin()` and `end()` member + /// functions returning a iterator class meeting the + /// [input iterator requirements]. The value type for this iterator is a + /// [`StatusOr`] as the iteration may fail even after some values are + /// retrieved successfully, for example, if there is a network disconnect. + /// An empty set of results does not indicate an error, it indicates + /// that there are no resources meeting the request criteria. + /// On a successful iteration the `StatusOr` contains elements of type + /// [google.cloud.cpp.compute.v1.ReservationSlot], or rather, + /// the C++ class generated by Protobuf from that type. Please consult the + /// Protobuf documentation for details on the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.reservation_slots.v1.ListReservationSlotsRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservation_slots/v1/reservation_slots.proto#L157} + /// [google.cloud.cpp.compute.v1.ReservationSlot]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_133.proto#L27} + /// + // clang-format on + StreamRange + ListReservationSlots(google::cloud::cpp::compute::reservation_slots::v1:: + ListReservationSlotsRequest request, + Options opts = {}); + + // clang-format off + /// + /// Update a reservation slot in the specified sub-block. + /// https://cloud.google.com/compute/docs/reference/rest/v1/reservationSlots/update + /// + /// @param project The project ID for this request. + /// @param zone The name of the zone for this request, formatted as RFC1035. + /// @param parent_name The name of the sub-block resource. + /// @param reservation_slot The name of the slot resource. + /// @param reservation_slot_resource The ReservationSlot for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.reservation_slots.v1.UpdateReservationSlotsGetResponseRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservation_slots/v1/reservation_slots.proto#L266} + /// + // clang-format on + future> + UpdateReservationSlotsGetResponse( + std::string const& project, std::string const& zone, + std::string const& parent_name, std::string const& reservation_slot, + google::cloud::cpp::compute::v1::ReservationSlot const& + reservation_slot_resource, + Options opts = {}); + + // clang-format off + /// + /// @copybrief UpdateReservationSlotsGetResponse + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr + UpdateReservationSlotsGetResponse( + NoAwaitTag, std::string const& project, std::string const& zone, + std::string const& parent_name, std::string const& reservation_slot, + google::cloud::cpp::compute::v1::ReservationSlot const& + reservation_slot_resource, + Options opts = {}); + + // clang-format off + /// + /// Update a reservation slot in the specified sub-block. + /// https://cloud.google.com/compute/docs/reference/rest/v1/reservationSlots/update + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.reservation_slots.v1.UpdateReservationSlotsGetResponseRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.reservation_slots.v1.UpdateReservationSlotsGetResponseRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservation_slots/v1/reservation_slots.proto#L266} + /// + // clang-format on + future> + UpdateReservationSlotsGetResponse( + google::cloud::cpp::compute::reservation_slots::v1:: + UpdateReservationSlotsGetResponseRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief UpdateReservationSlotsGetResponse + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr + UpdateReservationSlotsGetResponse( + NoAwaitTag, + google::cloud::cpp::compute::reservation_slots::v1:: + UpdateReservationSlotsGetResponseRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief UpdateReservationSlotsGetResponse + /// + /// This method accepts a `google::cloud::cpp::compute::v1::Operation` that corresponds + /// to a previously started Long Running Operation (LRO) and polls the status + /// of the LRO in the background. + /// + // clang-format on + future> + UpdateReservationSlotsGetResponse( + google::cloud::cpp::compute::v1::Operation const& operation, + Options opts = {}); + + private: + std::shared_ptr connection_; + Options options_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_reservation_slots_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RESERVATION_SLOTS_V1_RESERVATION_SLOTS_CLIENT_H diff --git a/google/cloud/compute/reservation_slots/v1/reservation_slots_connection.cc b/google/cloud/compute/reservation_slots/v1/reservation_slots_connection.cc new file mode 100644 index 0000000000000..753f46e568e35 --- /dev/null +++ b/google/cloud/compute/reservation_slots/v1/reservation_slots_connection.cc @@ -0,0 +1,107 @@ +// Copyright 2026 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. +// source: google/cloud/compute/reservation_slots/v1/reservation_slots.proto + +#include "google/cloud/compute/reservation_slots/v1/reservation_slots_connection.h" +#include "google/cloud/compute/reservation_slots/v1/internal/reservation_slots_option_defaults.h" +#include "google/cloud/compute/reservation_slots/v1/internal/reservation_slots_tracing_connection.h" +#include "google/cloud/compute/reservation_slots/v1/reservation_slots_options.h" +#include "google/cloud/background_threads.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/grpc_options.h" +#include "google/cloud/internal/pagination_range.h" +#include "google/cloud/internal/unified_grpc_credentials.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_reservation_slots_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +ReservationSlotsConnection::~ReservationSlotsConnection() = default; + +StatusOr +ReservationSlotsConnection::GetReservationSlotsGetResponse( + google::cloud::cpp::compute::reservation_slots::v1:: + GetReservationSlotsGetResponseRequest const&) { + return Status(StatusCode::kUnimplemented, "not implemented"); +} + +future> +ReservationSlotsConnection::GetVersion( + google::cloud::cpp::compute::reservation_slots::v1:: + GetVersionRequest const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +ReservationSlotsConnection::GetVersion( + NoAwaitTag, google::cloud::cpp::compute::reservation_slots::v1:: + GetVersionRequest const&) { + return StatusOr( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +ReservationSlotsConnection::GetVersion( + google::cloud::cpp::compute::v1::Operation const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StreamRange +ReservationSlotsConnection::ListReservationSlots( + google::cloud::cpp::compute::reservation_slots::v1:: + ListReservationSlotsRequest) { // NOLINT(performance-unnecessary-value-param) + return google::cloud::internal::MakeUnimplementedPaginationRange< + StreamRange>(); +} + +future> +ReservationSlotsConnection::UpdateReservationSlotsGetResponse( + google::cloud::cpp::compute::reservation_slots::v1:: + UpdateReservationSlotsGetResponseRequest const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +ReservationSlotsConnection::UpdateReservationSlotsGetResponse( + NoAwaitTag, google::cloud::cpp::compute::reservation_slots::v1:: + UpdateReservationSlotsGetResponseRequest const&) { + return StatusOr( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +ReservationSlotsConnection::UpdateReservationSlotsGetResponse( + google::cloud::cpp::compute::v1::Operation const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_reservation_slots_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/reservation_slots/v1/reservation_slots_connection.h b/google/cloud/compute/reservation_slots/v1/reservation_slots_connection.h new file mode 100644 index 0000000000000..cc011019aa5df --- /dev/null +++ b/google/cloud/compute/reservation_slots/v1/reservation_slots_connection.h @@ -0,0 +1,230 @@ +// Copyright 2026 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. +// source: google/cloud/compute/reservation_slots/v1/reservation_slots.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RESERVATION_SLOTS_V1_RESERVATION_SLOTS_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RESERVATION_SLOTS_V1_RESERVATION_SLOTS_CONNECTION_H + +#include "google/cloud/compute/reservation_slots/v1/internal/reservation_slots_retry_traits.h" +#include "google/cloud/compute/reservation_slots/v1/reservation_slots.pb.h" +#include "google/cloud/compute/reservation_slots/v1/reservation_slots_connection_idempotency_policy.h" +#include "google/cloud/backoff_policy.h" +#include "google/cloud/future.h" +#include "google/cloud/internal/retry_policy_impl.h" +#include "google/cloud/no_await_tag.h" +#include "google/cloud/options.h" +#include "google/cloud/polling_policy.h" +#include "google/cloud/status_or.h" +#include "google/cloud/stream_range.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_reservation_slots_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/// The retry policy for `ReservationSlotsConnection`. +class ReservationSlotsRetryPolicy : public ::google::cloud::RetryPolicy { + public: + /// Creates a new instance of the policy, reset to the initial state. + virtual std::unique_ptr clone() const = 0; +}; + +/** + * A retry policy for `ReservationSlotsConnection` based on counting errors. + * + * This policy stops retrying if: + * - An RPC returns a non-transient error. + * - More than a prescribed number of transient failures is detected. + * + * In this class the following status codes are treated as transient errors: + * - [`kUnavailable`](@ref google::cloud::StatusCode) + */ +class ReservationSlotsLimitedErrorCountRetryPolicy + : public ReservationSlotsRetryPolicy { + public: + /** + * Create an instance that tolerates up to @p maximum_failures transient + * errors. + * + * @note Disable the retry loop by providing an instance of this policy with + * @p maximum_failures == 0. + */ + explicit ReservationSlotsLimitedErrorCountRetryPolicy(int maximum_failures) + : impl_(maximum_failures) {} + + ReservationSlotsLimitedErrorCountRetryPolicy( + ReservationSlotsLimitedErrorCountRetryPolicy&& rhs) noexcept + : ReservationSlotsLimitedErrorCountRetryPolicy(rhs.maximum_failures()) {} + ReservationSlotsLimitedErrorCountRetryPolicy( + ReservationSlotsLimitedErrorCountRetryPolicy const& rhs) noexcept + : ReservationSlotsLimitedErrorCountRetryPolicy(rhs.maximum_failures()) {} + + int maximum_failures() const { return impl_.maximum_failures(); } + + bool OnFailure(Status const& status) override { + return impl_.OnFailure(status); + } + bool IsExhausted() const override { return impl_.IsExhausted(); } + bool IsPermanentFailure(Status const& status) const override { + return impl_.IsPermanentFailure(status); + } + std::unique_ptr clone() const override { + return std::make_unique( + maximum_failures()); + } + + // This is provided only for backwards compatibility. + using BaseType = ReservationSlotsRetryPolicy; + + private: + google::cloud::internal::LimitedErrorCountRetryPolicy< + compute_reservation_slots_v1_internal::ReservationSlotsRetryTraits> + impl_; +}; + +/** + * A retry policy for `ReservationSlotsConnection` based on elapsed time. + * + * This policy stops retrying if: + * - An RPC returns a non-transient error. + * - The elapsed time in the retry loop exceeds a prescribed duration. + * + * In this class the following status codes are treated as transient errors: + * - [`kUnavailable`](@ref google::cloud::StatusCode) + */ +class ReservationSlotsLimitedTimeRetryPolicy + : public ReservationSlotsRetryPolicy { + public: + /** + * Constructor given a `std::chrono::duration<>` object. + * + * @tparam DurationRep a placeholder to match the `Rep` tparam for @p + * duration's type. The semantics of this template parameter are + * documented in `std::chrono::duration<>`. In brief, the underlying + * arithmetic type used to store the number of ticks. For our purposes it + * is simply a formal parameter. + * @tparam DurationPeriod a placeholder to match the `Period` tparam for @p + * duration's type. The semantics of this template parameter are + * documented in `std::chrono::duration<>`. In brief, the length of the + * tick in seconds, expressed as a `std::ratio<>`. For our purposes it is + * simply a formal parameter. + * @param maximum_duration the maximum time allowed before the policy expires. + * While the application can express this time in any units they desire, + * the class truncates to milliseconds. + * + * @see https://en.cppreference.com/w/cpp/chrono/duration for more information + * about `std::chrono::duration`. + */ + template + explicit ReservationSlotsLimitedTimeRetryPolicy( + std::chrono::duration maximum_duration) + : impl_(maximum_duration) {} + + ReservationSlotsLimitedTimeRetryPolicy( + ReservationSlotsLimitedTimeRetryPolicy&& rhs) noexcept + : ReservationSlotsLimitedTimeRetryPolicy(rhs.maximum_duration()) {} + ReservationSlotsLimitedTimeRetryPolicy( + ReservationSlotsLimitedTimeRetryPolicy const& rhs) noexcept + : ReservationSlotsLimitedTimeRetryPolicy(rhs.maximum_duration()) {} + + std::chrono::milliseconds maximum_duration() const { + return impl_.maximum_duration(); + } + + bool OnFailure(Status const& status) override { + return impl_.OnFailure(status); + } + bool IsExhausted() const override { return impl_.IsExhausted(); } + bool IsPermanentFailure(Status const& status) const override { + return impl_.IsPermanentFailure(status); + } + std::unique_ptr clone() const override { + return std::make_unique( + maximum_duration()); + } + + // This is provided only for backwards compatibility. + using BaseType = ReservationSlotsRetryPolicy; + + private: + google::cloud::internal::LimitedTimeRetryPolicy< + compute_reservation_slots_v1_internal::ReservationSlotsRetryTraits> + impl_; +}; + +/** + * The `ReservationSlotsConnection` object for `ReservationSlotsClient`. + * + * This interface defines virtual methods for each of the user-facing overload + * sets in `ReservationSlotsClient`. This allows users to inject custom behavior + * (e.g., with a Google Mock object) when writing tests that use objects of type + * `ReservationSlotsClient`. + * + * To create a concrete instance, see `MakeReservationSlotsConnection()`. + * + * For mocking, see + * `compute_reservation_slots_v1_mocks::MockReservationSlotsConnection`. + */ +class ReservationSlotsConnection { + public: + virtual ~ReservationSlotsConnection() = 0; + + virtual Options options() { return Options{}; } + + virtual StatusOr + GetReservationSlotsGetResponse( + google::cloud::cpp::compute::reservation_slots::v1:: + GetReservationSlotsGetResponseRequest const& request); + + virtual future> + GetVersion(google::cloud::cpp::compute::reservation_slots::v1:: + GetVersionRequest const& request); + + virtual StatusOr GetVersion( + NoAwaitTag, google::cloud::cpp::compute::reservation_slots::v1:: + GetVersionRequest const& request); + + virtual future> + GetVersion(google::cloud::cpp::compute::v1::Operation const& operation); + + virtual StreamRange + ListReservationSlots(google::cloud::cpp::compute::reservation_slots::v1:: + ListReservationSlotsRequest request); + + virtual future> + UpdateReservationSlotsGetResponse( + google::cloud::cpp::compute::reservation_slots::v1:: + UpdateReservationSlotsGetResponseRequest const& request); + + virtual StatusOr + UpdateReservationSlotsGetResponse( + NoAwaitTag, google::cloud::cpp::compute::reservation_slots::v1:: + UpdateReservationSlotsGetResponseRequest const& request); + + virtual future> + UpdateReservationSlotsGetResponse( + google::cloud::cpp::compute::v1::Operation const& operation); +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_reservation_slots_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RESERVATION_SLOTS_V1_RESERVATION_SLOTS_CONNECTION_H diff --git a/google/cloud/compute/reservation_slots/v1/reservation_slots_connection_idempotency_policy.cc b/google/cloud/compute/reservation_slots/v1/reservation_slots_connection_idempotency_policy.cc new file mode 100644 index 0000000000000..a4745e340dd2b --- /dev/null +++ b/google/cloud/compute/reservation_slots/v1/reservation_slots_connection_idempotency_policy.cc @@ -0,0 +1,71 @@ +// Copyright 2026 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. +// source: google/cloud/compute/reservation_slots/v1/reservation_slots.proto + +#include "google/cloud/compute/reservation_slots/v1/reservation_slots_connection_idempotency_policy.h" +#include + +namespace google { +namespace cloud { +namespace compute_reservation_slots_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +using ::google::cloud::Idempotency; + +ReservationSlotsConnectionIdempotencyPolicy:: + ~ReservationSlotsConnectionIdempotencyPolicy() = default; + +std::unique_ptr +ReservationSlotsConnectionIdempotencyPolicy::clone() const { + return std::make_unique(*this); +} + +Idempotency +ReservationSlotsConnectionIdempotencyPolicy::GetReservationSlotsGetResponse( + google::cloud::cpp::compute::reservation_slots::v1:: + GetReservationSlotsGetResponseRequest const&) { + return Idempotency::kIdempotent; +} + +Idempotency ReservationSlotsConnectionIdempotencyPolicy::GetVersion( + google::cloud::cpp::compute::reservation_slots::v1:: + GetVersionRequest const&) { + return Idempotency::kNonIdempotent; +} + +Idempotency ReservationSlotsConnectionIdempotencyPolicy::ListReservationSlots( + google::cloud::cpp::compute::reservation_slots::v1:: + ListReservationSlotsRequest) { // NOLINT + return Idempotency::kIdempotent; +} + +Idempotency +ReservationSlotsConnectionIdempotencyPolicy::UpdateReservationSlotsGetResponse( + google::cloud::cpp::compute::reservation_slots::v1:: + UpdateReservationSlotsGetResponseRequest const&) { + return Idempotency::kNonIdempotent; +} + +std::unique_ptr +MakeDefaultReservationSlotsConnectionIdempotencyPolicy() { + return std::make_unique(); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_reservation_slots_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/reservation_slots/v1/reservation_slots_connection_idempotency_policy.h b/google/cloud/compute/reservation_slots/v1/reservation_slots_connection_idempotency_policy.h new file mode 100644 index 0000000000000..2e7590e5a3c79 --- /dev/null +++ b/google/cloud/compute/reservation_slots/v1/reservation_slots_connection_idempotency_policy.h @@ -0,0 +1,65 @@ +// Copyright 2026 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. +// source: google/cloud/compute/reservation_slots/v1/reservation_slots.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RESERVATION_SLOTS_V1_RESERVATION_SLOTS_CONNECTION_IDEMPOTENCY_POLICY_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RESERVATION_SLOTS_V1_RESERVATION_SLOTS_CONNECTION_IDEMPOTENCY_POLICY_H + +#include "google/cloud/compute/reservation_slots/v1/reservation_slots.pb.h" +#include "google/cloud/idempotency.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_reservation_slots_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class ReservationSlotsConnectionIdempotencyPolicy { + public: + virtual ~ReservationSlotsConnectionIdempotencyPolicy(); + + /// Create a new copy of this object. + virtual std::unique_ptr clone() + const; + + virtual google::cloud::Idempotency GetReservationSlotsGetResponse( + google::cloud::cpp::compute::reservation_slots::v1:: + GetReservationSlotsGetResponseRequest const& request); + + virtual google::cloud::Idempotency GetVersion( + google::cloud::cpp::compute::reservation_slots::v1:: + GetVersionRequest const& request); + + virtual google::cloud::Idempotency ListReservationSlots( + google::cloud::cpp::compute::reservation_slots::v1:: + ListReservationSlotsRequest request); + + virtual google::cloud::Idempotency UpdateReservationSlotsGetResponse( + google::cloud::cpp::compute::reservation_slots::v1:: + UpdateReservationSlotsGetResponseRequest const& request); +}; + +std::unique_ptr +MakeDefaultReservationSlotsConnectionIdempotencyPolicy(); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_reservation_slots_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RESERVATION_SLOTS_V1_RESERVATION_SLOTS_CONNECTION_IDEMPOTENCY_POLICY_H diff --git a/google/cloud/compute/reservation_slots/v1/reservation_slots_options.h b/google/cloud/compute/reservation_slots/v1/reservation_slots_options.h new file mode 100644 index 0000000000000..a9d4c7fa9eb6a --- /dev/null +++ b/google/cloud/compute/reservation_slots/v1/reservation_slots_options.h @@ -0,0 +1,87 @@ +// Copyright 2026 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. +// source: google/cloud/compute/reservation_slots/v1/reservation_slots.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RESERVATION_SLOTS_V1_RESERVATION_SLOTS_OPTIONS_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RESERVATION_SLOTS_V1_RESERVATION_SLOTS_OPTIONS_H + +#include "google/cloud/compute/reservation_slots/v1/reservation_slots_connection.h" +#include "google/cloud/compute/reservation_slots/v1/reservation_slots_connection_idempotency_policy.h" +#include "google/cloud/backoff_policy.h" +#include "google/cloud/options.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_reservation_slots_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/** + * Use with `google::cloud::Options` to configure the retry policy. + * + * @ingroup google-cloud-compute-options + */ +struct ReservationSlotsRetryPolicyOption { + using Type = std::shared_ptr; +}; + +/** + * Use with `google::cloud::Options` to configure the backoff policy. + * + * @ingroup google-cloud-compute-options + */ +struct ReservationSlotsBackoffPolicyOption { + using Type = std::shared_ptr; +}; + +/** + * Use with `google::cloud::Options` to configure which operations are retried. + * + * @ingroup google-cloud-compute-options + */ +struct ReservationSlotsConnectionIdempotencyPolicyOption { + using Type = std::shared_ptr; +}; + +/** + * Use with `google::cloud::Options` to configure the long-running operations + * polling policy. + * + * @ingroup google-cloud-compute-options + */ +struct ReservationSlotsPollingPolicyOption { + using Type = std::shared_ptr; +}; + +/** + * The options applicable to ReservationSlots. + * + * @ingroup google-cloud-compute-options + */ +using ReservationSlotsPolicyOptionList = + OptionList; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_reservation_slots_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RESERVATION_SLOTS_V1_RESERVATION_SLOTS_OPTIONS_H diff --git a/google/cloud/compute/reservation_slots/v1/reservation_slots_proto_export.h b/google/cloud/compute/reservation_slots/v1/reservation_slots_proto_export.h new file mode 100644 index 0000000000000..01ec91653ff3f --- /dev/null +++ b/google/cloud/compute/reservation_slots/v1/reservation_slots_proto_export.h @@ -0,0 +1,34 @@ +// Copyright 2026 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_RESERVATION_SLOTS_V1_RESERVATION_SLOTS_PROTO_EXPORT_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RESERVATION_SLOTS_V1_RESERVATION_SLOTS_PROTO_EXPORT_H + +// IWYU pragma: begin_exports +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_133.pb.h" +#include "google/cloud/compute/v1/internal/common_144.pb.h" +// IWYU pragma: end_exports + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RESERVATION_SLOTS_V1_RESERVATION_SLOTS_PROTO_EXPORT_H diff --git a/google/cloud/compute/reservation_slots/v1/reservation_slots_rest_connection.cc b/google/cloud/compute/reservation_slots/v1/reservation_slots_rest_connection.cc new file mode 100644 index 0000000000000..c3e658b3bff52 --- /dev/null +++ b/google/cloud/compute/reservation_slots/v1/reservation_slots_rest_connection.cc @@ -0,0 +1,60 @@ +// Copyright 2026 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. +// source: google/cloud/compute/reservation_slots/v1/reservation_slots.proto + +#include "google/cloud/compute/reservation_slots/v1/reservation_slots_rest_connection.h" +#include "google/cloud/compute/reservation_slots/v1/internal/reservation_slots_option_defaults.h" +#include "google/cloud/compute/reservation_slots/v1/internal/reservation_slots_rest_connection_impl.h" +#include "google/cloud/compute/reservation_slots/v1/internal/reservation_slots_rest_stub_factory.h" +#include "google/cloud/compute/reservation_slots/v1/internal/reservation_slots_tracing_connection.h" +#include "google/cloud/compute/reservation_slots/v1/reservation_slots_options.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/internal/rest_background_threads_impl.h" +#include "google/cloud/internal/rest_options.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_reservation_slots_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +std::shared_ptr MakeReservationSlotsConnectionRest( + Options options) { + internal::CheckExpectedOptions< + CommonOptionList, RestOptionList, UnifiedCredentialsOptionList, + rest_internal::TargetApiVersionOption, ReservationSlotsPolicyOptionList>( + options, __func__); + options = + compute_reservation_slots_v1_internal::ReservationSlotsDefaultOptions( + std::move(options)); + auto background = std::make_unique< + rest_internal::AutomaticallyCreatedRestBackgroundThreads>(); + auto stub = compute_reservation_slots_v1_internal:: + CreateDefaultReservationSlotsRestStub(options); + return compute_reservation_slots_v1_internal:: + MakeReservationSlotsTracingConnection( + std::make_shared( + std::move(background), std::move(stub), std::move(options))); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_reservation_slots_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/reservation_slots/v1/reservation_slots_rest_connection.h b/google/cloud/compute/reservation_slots/v1/reservation_slots_rest_connection.h new file mode 100644 index 0000000000000..8f145cb83e58a --- /dev/null +++ b/google/cloud/compute/reservation_slots/v1/reservation_slots_rest_connection.h @@ -0,0 +1,65 @@ +// Copyright 2026 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. +// source: google/cloud/compute/reservation_slots/v1/reservation_slots.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RESERVATION_SLOTS_V1_RESERVATION_SLOTS_REST_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RESERVATION_SLOTS_V1_RESERVATION_SLOTS_REST_CONNECTION_H + +#include "google/cloud/compute/reservation_slots/v1/reservation_slots_connection.h" +#include "google/cloud/options.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_reservation_slots_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/** + * A factory function to construct an object of type + * `ReservationSlotsConnection` that uses REST over HTTP as transport in lieu of + * gRPC. REST transport should only be used for services that do not support + * gRPC or if the existing network configuration precludes using gRPC. + * + * The returned connection object should not be used directly; instead it + * should be passed as an argument to the constructor of ReservationSlotsClient. + * + * The optional @p options argument may be used to configure aspects of the + * returned `ReservationSlotsConnection`. Expected options are any of the types + * in the following option lists: + * + * - `google::cloud::CommonOptionList` + * - `google::cloud::RestOptionList` + * - `google::cloud::UnifiedCredentialsOptionList` + * - + * `google::cloud::compute_reservation_slots_v1::ReservationSlotsPolicyOptionList` + * + * @note Unexpected options will be ignored. To log unexpected options instead, + * set `GOOGLE_CLOUD_CPP_ENABLE_CLOG=yes` in the environment. + * + * @param options (optional) Configure the `ReservationSlotsConnection` created + * by this function. + */ +std::shared_ptr MakeReservationSlotsConnectionRest( + Options options = {}); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_reservation_slots_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RESERVATION_SLOTS_V1_RESERVATION_SLOTS_REST_CONNECTION_H diff --git a/google/cloud/compute/reservation_slots/v1/samples/reservation_slots_client_samples.cc b/google/cloud/compute/reservation_slots/v1/samples/reservation_slots_client_samples.cc new file mode 100644 index 0000000000000..e5a8a2fe893d6 --- /dev/null +++ b/google/cloud/compute/reservation_slots/v1/samples/reservation_slots_client_samples.cc @@ -0,0 +1,240 @@ +// Copyright 2026 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. +// source: google/cloud/compute/reservation_slots/v1/reservation_slots.proto + +#include "google/cloud/compute/reservation_slots/v1/reservation_slots_client.h" +#include "google/cloud/compute/reservation_slots/v1/reservation_slots_connection_idempotency_policy.h" +#include "google/cloud/compute/reservation_slots/v1/reservation_slots_options.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/internal/getenv.h" +#include "google/cloud/polling_policy.h" +#include "google/cloud/testing_util/example_driver.h" +#include "google/cloud/universe_domain.h" +#include +#include +#include +#include + +// clang-format off +// main-dox-marker: compute_reservation_slots_v1::ReservationSlotsClient +// lro-marker: true +// clang-format on +namespace { + +void SetClientEndpoint(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-endpoint"}; + } + //! [set-client-endpoint] + // This configuration is common with Private Google Access: + // https://cloud.google.com/vpc/docs/private-google-access + auto options = google::cloud::Options{}.set( + "private.googleapis.com"); + auto vpc_client = + google::cloud::compute_reservation_slots_v1::ReservationSlotsClient( + google::cloud::compute_reservation_slots_v1:: + MakeReservationSlotsConnectionRest(options)); + //! [set-client-endpoint] +} + +void SetClientUniverseDomain(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-universe-domain"}; + } + //! [set-client-universe-domain] + google::cloud::Options options; + + // AddUniverseDomainOption interrogates the UnifiedCredentialsOption, if set, + // in the provided Options for the Universe Domain associated with the + // credentials and adds it to the set of Options. + // If no UnifiedCredentialsOption is set, GoogleDefaultCredentials are used. + auto ud_options = google::cloud::AddUniverseDomainOption(std::move(options)); + + if (!ud_options.ok()) throw std::move(ud_options).status(); + auto ud_client = + google::cloud::compute_reservation_slots_v1::ReservationSlotsClient( + google::cloud::compute_reservation_slots_v1:: + MakeReservationSlotsConnectionRest(*ud_options)); + //! [set-client-universe-domain] +} + +//! [custom-idempotency-policy] +class CustomIdempotencyPolicy + : public google::cloud::compute_reservation_slots_v1:: + ReservationSlotsConnectionIdempotencyPolicy { + public: + ~CustomIdempotencyPolicy() override = default; + std::unique_ptr + clone() const override { + return std::make_unique(*this); + } + // Override inherited functions to define as needed. +}; +//! [custom-idempotency-policy] + +void SetRetryPolicy(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-retry-policy"}; + } + //! [set-retry-policy] + auto options = + google::cloud::Options{} + .set( + CustomIdempotencyPolicy().clone()) + .set( + google::cloud::compute_reservation_slots_v1:: + ReservationSlotsLimitedErrorCountRetryPolicy(3) + .clone()) + .set( + google::cloud::ExponentialBackoffPolicy( + /*initial_delay=*/std::chrono::milliseconds(200), + /*maximum_delay=*/std::chrono::seconds(45), + /*scaling=*/2.0) + .clone()); + auto connection = google::cloud::compute_reservation_slots_v1:: + MakeReservationSlotsConnectionRest(options); + + // c1 and c2 share the same retry policies + auto c1 = google::cloud::compute_reservation_slots_v1::ReservationSlotsClient( + connection); + auto c2 = google::cloud::compute_reservation_slots_v1::ReservationSlotsClient( + connection); + + // You can override any of the policies in a new client. This new client + // will share the policies from c1 (or c2) *except* for the retry policy. + auto c3 = google::cloud::compute_reservation_slots_v1::ReservationSlotsClient( + connection, google::cloud::Options{} + .set( + google::cloud::compute_reservation_slots_v1:: + ReservationSlotsLimitedTimeRetryPolicy( + std::chrono::minutes(5)) + .clone())); + + // You can also override the policies in a single call: + // c3.SomeRpc(..., google::cloud::Options{} + // .set( + // google::cloud::compute_reservation_slots_v1::ReservationSlotsLimitedErrorCountRetryPolicy(10).clone())); + //! [set-retry-policy] +} + +void SetPollingPolicy(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-policy-policy"}; + } + //! [set-polling-policy] + + // The polling policy controls how the client waits for long-running + // operations. `GenericPollingPolicy<>` combines existing policies. + // In this case, keep polling until the operation completes (with success + // or error) or 45 minutes, whichever happens first. Initially pause for + // 10 seconds between polling requests, increasing the pause by a factor + // of 4 until it becomes 2 minutes. + auto options = + google::cloud::Options{} + .set( + google::cloud::GenericPollingPolicy< + google::cloud::compute_reservation_slots_v1:: + ReservationSlotsRetryPolicyOption::Type, + google::cloud::compute_reservation_slots_v1:: + ReservationSlotsBackoffPolicyOption::Type>( + google::cloud::compute_reservation_slots_v1:: + ReservationSlotsLimitedTimeRetryPolicy( + /*maximum_duration=*/std::chrono::minutes(45)) + .clone(), + google::cloud::ExponentialBackoffPolicy( + /*initial_delay=*/std::chrono::seconds(10), + /*maximum_delay=*/std::chrono::minutes(2), + /*scaling=*/4.0) + .clone()) + .clone()); + + auto connection = google::cloud::compute_reservation_slots_v1:: + MakeReservationSlotsConnectionRest(options); + + // c1 and c2 share the same polling policies. + auto c1 = google::cloud::compute_reservation_slots_v1::ReservationSlotsClient( + connection); + auto c2 = google::cloud::compute_reservation_slots_v1::ReservationSlotsClient( + connection); + //! [set-polling-policy] +} + +void WithServiceAccount(std::vector const& argv) { + if (argv.size() != 1 || argv[0] == "--help") { + throw google::cloud::testing_util::Usage{"with-service-account "}; + } + //! [with-service-account] + [](std::string const& keyfile) { + auto is = std::ifstream(keyfile); + is.exceptions(std::ios::badbit); // Minimal error handling in examples + auto contents = std::string(std::istreambuf_iterator(is.rdbuf()), {}); + auto options = + google::cloud::Options{}.set( + google::cloud::MakeServiceAccountCredentials(contents)); + return google::cloud::compute_reservation_slots_v1::ReservationSlotsClient( + google::cloud::compute_reservation_slots_v1:: + MakeReservationSlotsConnectionRest(options)); + } + //! [with-service-account] + (argv.at(0)); +} + +void AutoRun(std::vector const& argv) { + namespace examples = ::google::cloud::testing_util; + using ::google::cloud::internal::GetEnv; + if (!argv.empty()) throw examples::Usage{"auto"}; + examples::CheckEnvironmentVariablesAreSet( + {"GOOGLE_CLOUD_CPP_TEST_SERVICE_ACCOUNT_KEYFILE"}); + auto const keyfile = + GetEnv("GOOGLE_CLOUD_CPP_TEST_SERVICE_ACCOUNT_KEYFILE").value(); + + std::cout << "\nRunning SetClientEndpoint() example" << std::endl; + SetClientEndpoint({}); + + std::cout << "\nRunning SetRetryPolicy() example" << std::endl; + SetRetryPolicy({}); + + std::cout << "\nRunning SetPollingPolicy() example" << std::endl; + SetPollingPolicy({}); + + std::cout << "\nRunning WithServiceAccount() example" << std::endl; + WithServiceAccount({keyfile}); + + std::cout << "\nRunning SetClientUniverseDomain() example" << std::endl; + SetClientUniverseDomain({}); +} + +} // namespace + +int main(int argc, char* argv[]) { // NOLINT(bugprone-exception-escape) + google::cloud::testing_util::Example example({ + {"set-client-endpoint", SetClientEndpoint}, + {"set-retry-policy", SetRetryPolicy}, + {"set-polling-policy", SetPollingPolicy}, + {"with-service-account", WithServiceAccount}, + {"set-client-universe-domain", SetClientUniverseDomain}, + {"auto", AutoRun}, + }); + return example.Run(argc, argv); +} diff --git a/google/cloud/compute/reservation_sub_blocks/v1/internal/reservation_sub_blocks_option_defaults.cc b/google/cloud/compute/reservation_sub_blocks/v1/internal/reservation_sub_blocks_option_defaults.cc index 18024fc0cfaaa..733cf8550a378 100644 --- a/google/cloud/compute/reservation_sub_blocks/v1/internal/reservation_sub_blocks_option_defaults.cc +++ b/google/cloud/compute/reservation_sub_blocks/v1/internal/reservation_sub_blocks_option_defaults.cc @@ -57,6 +57,23 @@ Options ReservationSubBlocksDefaultOptions(Options options) { std::chrono::minutes(5), kBackoffScaling, kBackoffScaling) .clone()); } + if (!options.has()) { + options.set( + GenericPollingPolicy( + options + .get() + ->clone(), + ExponentialBackoffPolicy(std::chrono::seconds(1), + std::chrono::minutes(5), kBackoffScaling) + .clone()) + .clone()); + } if (!options .has()) { diff --git a/google/cloud/compute/reservation_sub_blocks/v1/internal/reservation_sub_blocks_rest_connection_impl.cc b/google/cloud/compute/reservation_sub_blocks/v1/internal/reservation_sub_blocks_rest_connection_impl.cc index 828c885cc2603..517c867725546 100644 --- a/google/cloud/compute/reservation_sub_blocks/v1/internal/reservation_sub_blocks_rest_connection_impl.cc +++ b/google/cloud/compute/reservation_sub_blocks/v1/internal/reservation_sub_blocks_rest_connection_impl.cc @@ -21,7 +21,10 @@ #include "google/cloud/compute/reservation_sub_blocks/v1/internal/reservation_sub_blocks_rest_stub_factory.h" #include "google/cloud/common_options.h" #include "google/cloud/credentials.h" +#include "google/cloud/internal/async_rest_long_running_operation_custom.h" +#include "google/cloud/internal/extract_long_running_result.h" #include "google/cloud/internal/pagination_range.h" +#include "google/cloud/internal/rest_lro_helpers.h" #include "google/cloud/internal/rest_retry_loop.h" #include "google/cloud/rest_options.h" #include @@ -60,6 +63,153 @@ ReservationSubBlocksRestConnectionImpl::GetReservationSubBlocksGetResponse( *current, request, __func__); } +StatusOr +ReservationSubBlocksRestConnectionImpl::GetIamPolicy( + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + GetIamPolicyRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->GetIamPolicy(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + GetIamPolicyRequest const& request) { + return stub_->GetIamPolicy(rest_context, options, request); + }, + *current, request, __func__); +} + +future> +ReservationSubBlocksRestConnectionImpl::GetVersion( + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + GetVersionRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::zone_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::zone_operations::v1::DeleteOperationRequest>( + background_->cq(), current, request, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + GetVersionRequest const& request) { + return stub->AsyncGetVersion(cq, std::move(context), std::move(options), + request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->GetVersion(request), + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [request]( + std::string const& op, + google::cloud::cpp::compute::zone_operations::v1::GetOperationRequest& + r) { + r.set_project(request.project()); + r.set_zone(request.zone()); + r.set_operation(op); + }, + [request](std::string const& op, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest& r) { + r.set_project(request.project()); + r.set_zone(request.zone()); + r.set_operation(op); + }); +} + +StatusOr +ReservationSubBlocksRestConnectionImpl::GetVersion( + NoAwaitTag, google::cloud::cpp::compute::reservation_sub_blocks::v1:: + GetVersionRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->GetVersion(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + GetVersionRequest const& request) { + return stub_->GetVersion(rest_context, options, request); + }, + *current, request, __func__); +} + +future> +ReservationSubBlocksRestConnectionImpl::GetVersion( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestAwaitLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::zone_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::zone_operations::v1::DeleteOperationRequest>( + background_->cq(), current, operation, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [operation]( + std::string const&, + google::cloud::cpp::compute::zone_operations::v1::GetOperationRequest& + r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_zone(info.zone); + r.set_operation(info.operation); + }, + [operation](std::string const&, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_zone(info.zone); + r.set_operation(info.operation); + }); +} + StreamRange ReservationSubBlocksRestConnectionImpl::ListReservationSubBlocks( google::cloud::cpp::compute::reservation_sub_blocks::v1:: @@ -100,6 +250,300 @@ ReservationSubBlocksRestConnectionImpl::ListReservationSubBlocks( }); } +future> +ReservationSubBlocksRestConnectionImpl::PerformMaintenance( + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + PerformMaintenanceRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::zone_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::zone_operations::v1::DeleteOperationRequest>( + background_->cq(), current, request, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + PerformMaintenanceRequest const& request) { + return stub->AsyncPerformMaintenance(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->PerformMaintenance(request), + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [request]( + std::string const& op, + google::cloud::cpp::compute::zone_operations::v1::GetOperationRequest& + r) { + r.set_project(request.project()); + r.set_zone(request.zone()); + r.set_operation(op); + }, + [request](std::string const& op, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest& r) { + r.set_project(request.project()); + r.set_zone(request.zone()); + r.set_operation(op); + }); +} + +StatusOr +ReservationSubBlocksRestConnectionImpl::PerformMaintenance( + NoAwaitTag, google::cloud::cpp::compute::reservation_sub_blocks::v1:: + PerformMaintenanceRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->PerformMaintenance(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + PerformMaintenanceRequest const& request) { + return stub_->PerformMaintenance(rest_context, options, request); + }, + *current, request, __func__); +} + +future> +ReservationSubBlocksRestConnectionImpl::PerformMaintenance( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestAwaitLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::zone_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::zone_operations::v1::DeleteOperationRequest>( + background_->cq(), current, operation, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [operation]( + std::string const&, + google::cloud::cpp::compute::zone_operations::v1::GetOperationRequest& + r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_zone(info.zone); + r.set_operation(info.operation); + }, + [operation](std::string const&, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_zone(info.zone); + r.set_operation(info.operation); + }); +} + +future> +ReservationSubBlocksRestConnectionImpl::ReportFaulty( + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + ReportFaultyRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::zone_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::zone_operations::v1::DeleteOperationRequest>( + background_->cq(), current, request, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + ReportFaultyRequest const& request) { + return stub->AsyncReportFaulty(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->ReportFaulty(request), + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [request]( + std::string const& op, + google::cloud::cpp::compute::zone_operations::v1::GetOperationRequest& + r) { + r.set_project(request.project()); + r.set_zone(request.zone()); + r.set_operation(op); + }, + [request](std::string const& op, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest& r) { + r.set_project(request.project()); + r.set_zone(request.zone()); + r.set_operation(op); + }); +} + +StatusOr +ReservationSubBlocksRestConnectionImpl::ReportFaulty( + NoAwaitTag, google::cloud::cpp::compute::reservation_sub_blocks::v1:: + ReportFaultyRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->ReportFaulty(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + ReportFaultyRequest const& request) { + return stub_->ReportFaulty(rest_context, options, request); + }, + *current, request, __func__); +} + +future> +ReservationSubBlocksRestConnectionImpl::ReportFaulty( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestAwaitLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::zone_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::zone_operations::v1::DeleteOperationRequest>( + background_->cq(), current, operation, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [operation]( + std::string const&, + google::cloud::cpp::compute::zone_operations::v1::GetOperationRequest& + r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_zone(info.zone); + r.set_operation(info.operation); + }, + [operation](std::string const&, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_zone(info.zone); + r.set_operation(info.operation); + }); +} + +StatusOr +ReservationSubBlocksRestConnectionImpl::SetIamPolicy( + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + SetIamPolicyRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->SetIamPolicy(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + SetIamPolicyRequest const& request) { + return stub_->SetIamPolicy(rest_context, options, request); + }, + *current, request, __func__); +} + +StatusOr +ReservationSubBlocksRestConnectionImpl::TestIamPermissions( + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + TestIamPermissionsRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->TestIamPermissions(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + TestIamPermissionsRequest const& request) { + return stub_->TestIamPermissions(rest_context, options, request); + }, + *current, request, __func__); +} + GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END } // namespace compute_reservation_sub_blocks_v1_internal } // namespace cloud diff --git a/google/cloud/compute/reservation_sub_blocks/v1/internal/reservation_sub_blocks_rest_connection_impl.h b/google/cloud/compute/reservation_sub_blocks/v1/internal/reservation_sub_blocks_rest_connection_impl.h index e2df1f24c8bd6..d500590d92821 100644 --- a/google/cloud/compute/reservation_sub_blocks/v1/internal/reservation_sub_blocks_rest_connection_impl.h +++ b/google/cloud/compute/reservation_sub_blocks/v1/internal/reservation_sub_blocks_rest_connection_impl.h @@ -25,6 +25,7 @@ #include "google/cloud/compute/reservation_sub_blocks/v1/reservation_sub_blocks_connection.h" #include "google/cloud/compute/reservation_sub_blocks/v1/reservation_sub_blocks_connection_idempotency_policy.h" #include "google/cloud/compute/reservation_sub_blocks/v1/reservation_sub_blocks_options.h" +#include "google/cloud/compute/zone_operations/v1/zone_operations.pb.h" #include "google/cloud/background_threads.h" #include "google/cloud/backoff_policy.h" #include "google/cloud/options.h" @@ -57,11 +58,57 @@ class ReservationSubBlocksRestConnectionImpl google::cloud::cpp::compute::reservation_sub_blocks::v1:: GetReservationSubBlocksGetResponseRequest const& request) override; + StatusOr GetIamPolicy( + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + GetIamPolicyRequest const& request) override; + + future> GetVersion( + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + GetVersionRequest const& request) override; + + StatusOr GetVersion( + NoAwaitTag, google::cloud::cpp::compute::reservation_sub_blocks::v1:: + GetVersionRequest const& request) override; + + future> GetVersion( + google::cloud::cpp::compute::v1::Operation const& operation) override; + StreamRange ListReservationSubBlocks( google::cloud::cpp::compute::reservation_sub_blocks::v1:: ListReservationSubBlocksRequest request) override; + future> + PerformMaintenance(google::cloud::cpp::compute::reservation_sub_blocks::v1:: + PerformMaintenanceRequest const& request) override; + + StatusOr PerformMaintenance( + NoAwaitTag, google::cloud::cpp::compute::reservation_sub_blocks::v1:: + PerformMaintenanceRequest const& request) override; + + future> + PerformMaintenance( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + future> ReportFaulty( + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + ReportFaultyRequest const& request) override; + + StatusOr ReportFaulty( + NoAwaitTag, google::cloud::cpp::compute::reservation_sub_blocks::v1:: + ReportFaultyRequest const& request) override; + + future> ReportFaulty( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + StatusOr SetIamPolicy( + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + SetIamPolicyRequest const& request) override; + + StatusOr + TestIamPermissions(google::cloud::cpp::compute::reservation_sub_blocks::v1:: + TestIamPermissionsRequest const& request) override; + private: static std::unique_ptr< compute_reservation_sub_blocks_v1::ReservationSubBlocksRetryPolicy> @@ -88,6 +135,13 @@ class ReservationSubBlocksRestConnectionImpl ->clone(); } + static std::unique_ptr polling_policy(Options const& options) { + return options + .get() + ->clone(); + } + std::unique_ptr background_; std::shared_ptr< compute_reservation_sub_blocks_v1_internal::ReservationSubBlocksRestStub> diff --git a/google/cloud/compute/reservation_sub_blocks/v1/internal/reservation_sub_blocks_rest_logging_decorator.cc b/google/cloud/compute/reservation_sub_blocks/v1/internal/reservation_sub_blocks_rest_logging_decorator.cc index c5626776e83d0..678eb79ecae12 100644 --- a/google/cloud/compute/reservation_sub_blocks/v1/internal/reservation_sub_blocks_rest_logging_decorator.cc +++ b/google/cloud/compute/reservation_sub_blocks/v1/internal/reservation_sub_blocks_rest_logging_decorator.cc @@ -50,6 +50,54 @@ ReservationSubBlocksRestLogging::GetReservationSubBlocksGetResponse( rest_context, options, request, __func__, tracing_options_); } +StatusOr +ReservationSubBlocksRestLogging::GetIamPolicy( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + GetIamPolicyRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + GetIamPolicyRequest const& request) { + return child_->GetIamPolicy(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +future> +ReservationSubBlocksRestLogging::AsyncGetVersion( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + GetVersionRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + GetVersionRequest const& request) { + return child_->AsyncGetVersion(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +StatusOr +ReservationSubBlocksRestLogging::GetVersion( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + GetVersionRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + GetVersionRequest const& request) { + return child_->GetVersion(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + StatusOr ReservationSubBlocksRestLogging::ListReservationSubBlocks( rest_internal::RestContext& rest_context, Options const& options, @@ -64,6 +112,141 @@ ReservationSubBlocksRestLogging::ListReservationSubBlocks( rest_context, options, request, __func__, tracing_options_); } +future> +ReservationSubBlocksRestLogging::AsyncPerformMaintenance( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + PerformMaintenanceRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + PerformMaintenanceRequest const& request) { + return child_->AsyncPerformMaintenance(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +StatusOr +ReservationSubBlocksRestLogging::PerformMaintenance( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + PerformMaintenanceRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + PerformMaintenanceRequest const& request) { + return child_->PerformMaintenance(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +future> +ReservationSubBlocksRestLogging::AsyncReportFaulty( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + ReportFaultyRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + ReportFaultyRequest const& request) { + return child_->AsyncReportFaulty(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +StatusOr +ReservationSubBlocksRestLogging::ReportFaulty( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + ReportFaultyRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + ReportFaultyRequest const& request) { + return child_->ReportFaulty(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +StatusOr +ReservationSubBlocksRestLogging::SetIamPolicy( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + SetIamPolicyRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + SetIamPolicyRequest const& request) { + return child_->SetIamPolicy(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +StatusOr +ReservationSubBlocksRestLogging::TestIamPermissions( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + TestIamPermissionsRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + TestIamPermissionsRequest const& request) { + return child_->TestIamPermissions(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +future> +ReservationSubBlocksRestLogging::AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1::GetOperationRequest const& + request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + GetOperationRequest const& request) { + return child_->AsyncGetOperation(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +future ReservationSubBlocksRestLogging::AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest const& request) { + return child_->AsyncCancelOperation(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END } // namespace compute_reservation_sub_blocks_v1_internal } // namespace cloud diff --git a/google/cloud/compute/reservation_sub_blocks/v1/internal/reservation_sub_blocks_rest_logging_decorator.h b/google/cloud/compute/reservation_sub_blocks/v1/internal/reservation_sub_blocks_rest_logging_decorator.h index 237897f601e72..ae766a0f7c8f9 100644 --- a/google/cloud/compute/reservation_sub_blocks/v1/internal/reservation_sub_blocks_rest_logging_decorator.h +++ b/google/cloud/compute/reservation_sub_blocks/v1/internal/reservation_sub_blocks_rest_logging_decorator.h @@ -22,6 +22,7 @@ #include "google/cloud/compute/reservation_sub_blocks/v1/internal/reservation_sub_blocks_rest_stub.h" #include "google/cloud/compute/reservation_sub_blocks/v1/reservation_sub_blocks.pb.h" +#include "google/cloud/compute/zone_operations/v1/zone_operations.pb.h" #include "google/cloud/future.h" #include "google/cloud/internal/rest_context.h" #include "google/cloud/tracing_options.h" @@ -49,6 +50,25 @@ class ReservationSubBlocksRestLogging : public ReservationSubBlocksRestStub { google::cloud::cpp::compute::reservation_sub_blocks::v1:: GetReservationSubBlocksGetResponseRequest const& request) override; + StatusOr GetIamPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + GetIamPolicyRequest const& request) override; + + future> AsyncGetVersion( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + GetVersionRequest const& request) override; + + StatusOr GetVersion( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + GetVersionRequest const& request) override; + StatusOr ListReservationSubBlocks( google::cloud::rest_internal::RestContext& rest_context, @@ -56,6 +76,61 @@ class ReservationSubBlocksRestLogging : public ReservationSubBlocksRestStub { google::cloud::cpp::compute::reservation_sub_blocks::v1:: ListReservationSubBlocksRequest const& request) override; + future> + AsyncPerformMaintenance( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + PerformMaintenanceRequest const& request) override; + + StatusOr PerformMaintenance( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + PerformMaintenanceRequest const& request) override; + + future> + AsyncReportFaulty( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + ReportFaultyRequest const& request) override; + + StatusOr ReportFaulty( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + ReportFaultyRequest const& request) override; + + StatusOr SetIamPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + SetIamPolicyRequest const& request) override; + + StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + TestIamPermissionsRequest const& request) override; + + future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + GetOperationRequest const& request) override; + + future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest const& request) override; + private: std::shared_ptr child_; TracingOptions tracing_options_; diff --git a/google/cloud/compute/reservation_sub_blocks/v1/internal/reservation_sub_blocks_rest_metadata_decorator.cc b/google/cloud/compute/reservation_sub_blocks/v1/internal/reservation_sub_blocks_rest_metadata_decorator.cc index d10d4e707e9ca..e8d0dd553363a 100644 --- a/google/cloud/compute/reservation_sub_blocks/v1/internal/reservation_sub_blocks_rest_metadata_decorator.cc +++ b/google/cloud/compute/reservation_sub_blocks/v1/internal/reservation_sub_blocks_rest_metadata_decorator.cc @@ -50,6 +50,36 @@ ReservationSubBlocksRestMetadata::GetReservationSubBlocksGetResponse( request); } +StatusOr +ReservationSubBlocksRestMetadata::GetIamPolicy( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + GetIamPolicyRequest const& request) { + SetMetadata(rest_context, options); + return child_->GetIamPolicy(rest_context, options, request); +} + +future> +ReservationSubBlocksRestMetadata::AsyncGetVersion( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + GetVersionRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncGetVersion(cq, std::move(rest_context), + std::move(options), request); +} + +StatusOr +ReservationSubBlocksRestMetadata::GetVersion( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + GetVersionRequest const& request) { + SetMetadata(rest_context, options); + return child_->GetVersion(rest_context, options, request); +} + StatusOr ReservationSubBlocksRestMetadata::ListReservationSubBlocks( rest_internal::RestContext& rest_context, Options const& options, @@ -59,6 +89,89 @@ ReservationSubBlocksRestMetadata::ListReservationSubBlocks( return child_->ListReservationSubBlocks(rest_context, options, request); } +future> +ReservationSubBlocksRestMetadata::AsyncPerformMaintenance( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + PerformMaintenanceRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncPerformMaintenance(cq, std::move(rest_context), + std::move(options), request); +} + +StatusOr +ReservationSubBlocksRestMetadata::PerformMaintenance( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + PerformMaintenanceRequest const& request) { + SetMetadata(rest_context, options); + return child_->PerformMaintenance(rest_context, options, request); +} + +future> +ReservationSubBlocksRestMetadata::AsyncReportFaulty( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + ReportFaultyRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncReportFaulty(cq, std::move(rest_context), + std::move(options), request); +} + +StatusOr +ReservationSubBlocksRestMetadata::ReportFaulty( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + ReportFaultyRequest const& request) { + SetMetadata(rest_context, options); + return child_->ReportFaulty(rest_context, options, request); +} + +StatusOr +ReservationSubBlocksRestMetadata::SetIamPolicy( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + SetIamPolicyRequest const& request) { + SetMetadata(rest_context, options); + return child_->SetIamPolicy(rest_context, options, request); +} + +StatusOr +ReservationSubBlocksRestMetadata::TestIamPermissions( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + TestIamPermissionsRequest const& request) { + SetMetadata(rest_context, options); + return child_->TestIamPermissions(rest_context, options, request); +} + +future> +ReservationSubBlocksRestMetadata::AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1::GetOperationRequest const& + request) { + SetMetadata(*rest_context, *options); + return child_->AsyncGetOperation(cq, std::move(rest_context), + std::move(options), request); +} + +future ReservationSubBlocksRestMetadata::AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncCancelOperation(cq, std::move(rest_context), + std::move(options), request); +} + void ReservationSubBlocksRestMetadata::SetMetadata( rest_internal::RestContext& rest_context, Options const& options, std::vector const& params) { diff --git a/google/cloud/compute/reservation_sub_blocks/v1/internal/reservation_sub_blocks_rest_metadata_decorator.h b/google/cloud/compute/reservation_sub_blocks/v1/internal/reservation_sub_blocks_rest_metadata_decorator.h index 178b7e76cb1f0..4dcafb40cf427 100644 --- a/google/cloud/compute/reservation_sub_blocks/v1/internal/reservation_sub_blocks_rest_metadata_decorator.h +++ b/google/cloud/compute/reservation_sub_blocks/v1/internal/reservation_sub_blocks_rest_metadata_decorator.h @@ -22,6 +22,7 @@ #include "google/cloud/compute/reservation_sub_blocks/v1/internal/reservation_sub_blocks_rest_stub.h" #include "google/cloud/compute/reservation_sub_blocks/v1/reservation_sub_blocks.pb.h" +#include "google/cloud/compute/zone_operations/v1/zone_operations.pb.h" #include "google/cloud/future.h" #include "google/cloud/rest_options.h" #include "google/cloud/version.h" @@ -47,6 +48,26 @@ class ReservationSubBlocksRestMetadata : public ReservationSubBlocksRestStub { google::cloud::cpp::compute::reservation_sub_blocks::v1:: GetReservationSubBlocksGetResponseRequest const& request) override; + StatusOr GetIamPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + GetIamPolicyRequest const& request) override; + + google::cloud::future> + AsyncGetVersion( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + GetVersionRequest const& request) override; + + StatusOr GetVersion( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + GetVersionRequest const& request) override; + StatusOr ListReservationSubBlocks( google::cloud::rest_internal::RestContext& rest_context, @@ -54,6 +75,61 @@ class ReservationSubBlocksRestMetadata : public ReservationSubBlocksRestStub { google::cloud::cpp::compute::reservation_sub_blocks::v1:: ListReservationSubBlocksRequest const& request) override; + google::cloud::future> + AsyncPerformMaintenance( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + PerformMaintenanceRequest const& request) override; + + StatusOr PerformMaintenance( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + PerformMaintenanceRequest const& request) override; + + google::cloud::future> + AsyncReportFaulty( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + ReportFaultyRequest const& request) override; + + StatusOr ReportFaulty( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + ReportFaultyRequest const& request) override; + + StatusOr SetIamPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + SetIamPolicyRequest const& request) override; + + StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + TestIamPermissionsRequest const& request) override; + + google::cloud::future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + GetOperationRequest const& request) override; + + google::cloud::future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest const& request) override; + private: void SetMetadata(rest_internal::RestContext& rest_context, Options const& options, diff --git a/google/cloud/compute/reservation_sub_blocks/v1/internal/reservation_sub_blocks_rest_stub.cc b/google/cloud/compute/reservation_sub_blocks/v1/internal/reservation_sub_blocks_rest_stub.cc index db542fe5b0697..e41eddda57a11 100644 --- a/google/cloud/compute/reservation_sub_blocks/v1/internal/reservation_sub_blocks_rest_stub.cc +++ b/google/cloud/compute/reservation_sub_blocks/v1/internal/reservation_sub_blocks_rest_stub.cc @@ -19,6 +19,7 @@ #include "google/cloud/compute/reservation_sub_blocks/v1/internal/reservation_sub_blocks_rest_stub.h" #include "google/cloud/compute/reservation_sub_blocks/v1/reservation_sub_blocks.pb.h" +#include "google/cloud/compute/zone_operations/v1/zone_operations.pb.h" #include "google/cloud/common_options.h" #include "google/cloud/internal/rest_stub_helpers.h" #include "google/cloud/status_or.h" @@ -35,11 +36,16 @@ DefaultReservationSubBlocksRestStub::DefaultReservationSubBlocksRestStub( Options options) : service_(rest_internal::MakePooledRestClient( options.get(), options)), + operations_(rest_internal::MakePooledRestClient( + options.get(), options)), options_(std::move(options)) {} DefaultReservationSubBlocksRestStub::DefaultReservationSubBlocksRestStub( - std::shared_ptr service, Options options) - : service_(std::move(service)), options_(std::move(options)) {} + std::shared_ptr service, + std::shared_ptr operations, Options options) + : service_(std::move(service)), + operations_(std::move(operations)), + options_(std::move(options)) {} StatusOr DefaultReservationSubBlocksRestStub::GetReservationSubBlocksGetResponse( @@ -48,6 +54,9 @@ DefaultReservationSubBlocksRestStub::GetReservationSubBlocksGetResponse( google::cloud::cpp::compute::reservation_sub_blocks::v1:: GetReservationSubBlocksGetResponseRequest const& request) { std::vector> query_params; + query_params.push_back({"view", request.view()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); return rest_internal::Get< google::cloud::cpp::compute::v1::ReservationSubBlocksGetResponse>( *service_, rest_context, request, false, @@ -60,6 +69,92 @@ DefaultReservationSubBlocksRestStub::GetReservationSubBlocksGetResponse( std::move(query_params)); } +StatusOr +DefaultReservationSubBlocksRestStub::GetIamPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + GetIamPolicyRequest const& request) { + std::vector> query_params; + query_params.push_back( + {"options_requested_policy_version", + std::to_string(request.options_requested_policy_version())}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Get( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "zones", "/", + request.zone(), "/", request.parent_resource(), "/", + "reservationSubBlocks", "/", request.resource(), "/", + "getIamPolicy"), + std::move(query_params)); +} + +future> +DefaultReservationSubBlocksRestStub::AsyncGetVersion( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + GetVersionRequest const& request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto service, auto request, auto rest_context, auto options) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + p.set_value( + rest_internal::Post( + *service, *rest_context, + request.reservation_sub_blocks_get_version_request_resource(), + false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", *options), + "/", "projects", "/", request.project(), "/", + "zones", "/", request.zone(), "/", + request.parent_name(), "/", "reservationSubBlocks", + "/", request.reservation_sub_block(), "/", + "getVersion"), + std::move(query_params))); + }, + std::move(p), + service_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +StatusOr +DefaultReservationSubBlocksRestStub::GetVersion( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + GetVersionRequest const& request) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Post( + *service_, rest_context, + request.reservation_sub_blocks_get_version_request_resource(), false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "zones", "/", + request.zone(), "/", request.parent_name(), "/", + "reservationSubBlocks", "/", request.reservation_sub_block(), + "/", "getVersion"), + std::move(query_params)); +} + StatusOr DefaultReservationSubBlocksRestStub::ListReservationSubBlocks( google::cloud::rest_internal::RestContext& rest_context, @@ -87,6 +182,224 @@ DefaultReservationSubBlocksRestStub::ListReservationSubBlocks( std::move(query_params)); } +future> +DefaultReservationSubBlocksRestStub::AsyncPerformMaintenance( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + PerformMaintenanceRequest const& request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto service, auto request, auto rest_context, auto options) { + std::vector> query_params; + p.set_value( + rest_internal::Post( + *service, *rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", *options), + "/", "projects", "/", request.project(), "/", + "zones", "/", request.zone(), "/", + request.parent_name(), "/", "reservationSubBlocks", + "/", request.reservation_sub_block(), "/", + "performMaintenance"), + std::move(query_params))); + }, + std::move(p), + service_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +StatusOr +DefaultReservationSubBlocksRestStub::PerformMaintenance( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + PerformMaintenanceRequest const& request) { + std::vector> query_params; + return rest_internal::Post( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "zones", "/", + request.zone(), "/", request.parent_name(), "/", + "reservationSubBlocks", "/", request.reservation_sub_block(), + "/", "performMaintenance"), + std::move(query_params)); +} + +future> +DefaultReservationSubBlocksRestStub::AsyncReportFaulty( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + ReportFaultyRequest const& request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto service, auto request, auto rest_context, auto options) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + p.set_value( + rest_internal::Post( + *service, *rest_context, + request.reservation_sub_blocks_report_faulty_request_resource(), + false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", *options), + "/", "projects", "/", request.project(), "/", + "zones", "/", request.zone(), "/", + request.parent_name(), "/", "reservationSubBlocks", + "/", request.reservation_sub_block(), "/", + "reportFaulty"), + std::move(query_params))); + }, + std::move(p), + service_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +StatusOr +DefaultReservationSubBlocksRestStub::ReportFaulty( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + ReportFaultyRequest const& request) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Post( + *service_, rest_context, + request.reservation_sub_blocks_report_faulty_request_resource(), false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "zones", "/", + request.zone(), "/", request.parent_name(), "/", + "reservationSubBlocks", "/", request.reservation_sub_block(), + "/", "reportFaulty"), + std::move(query_params)); +} + +StatusOr +DefaultReservationSubBlocksRestStub::SetIamPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + SetIamPolicyRequest const& request) { + std::vector> query_params; + return rest_internal::Post( + *service_, rest_context, + request.zone_set_nested_policy_request_resource(), false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "zones", "/", + request.zone(), "/", request.parent_resource(), "/", + "reservationSubBlocks", "/", request.resource(), "/", + "setIamPolicy"), + std::move(query_params)); +} + +StatusOr +DefaultReservationSubBlocksRestStub::TestIamPermissions( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + TestIamPermissionsRequest const& request) { + std::vector> query_params; + return rest_internal::Post< + google::cloud::cpp::compute::v1::TestPermissionsResponse>( + *service_, rest_context, request.test_permissions_request_resource(), + false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "zones", "/", + request.zone(), "/", request.parent_resource(), "/", + "reservationSubBlocks", "/", request.resource(), "/", + "testIamPermissions"), + std::move(query_params)); +} + +future> +DefaultReservationSubBlocksRestStub::AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1::GetOperationRequest const& + request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto operations, auto request, auto rest_context, + auto options) { + p.set_value( + rest_internal::Get( + *operations, *rest_context, request, false, + absl::StrCat("/compute/", + rest_internal::DetermineApiVersion("v1", *options), + "/projects/", request.project(), "/zones/", + request.zone(), "/operations/", + request.operation()))); + }, + std::move(p), + operations_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +future DefaultReservationSubBlocksRestStub::AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest const& request) { + promise> p; + future> f = p.get_future(); + std::thread t{ + [](auto p, auto operations, auto request, auto rest_context, + auto options) { + p.set_value(rest_internal::Post( + *operations, *rest_context, request, false, + absl::StrCat("/compute/", + rest_internal::DetermineApiVersion("v1", *options), + "/projects/", request.project(), "/zones/", + request.zone(), "/operations/", request.operation()))); + }, + std::move(p), + operations_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get().status(); + }); +} + GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END } // namespace compute_reservation_sub_blocks_v1_internal } // namespace cloud diff --git a/google/cloud/compute/reservation_sub_blocks/v1/internal/reservation_sub_blocks_rest_stub.h b/google/cloud/compute/reservation_sub_blocks/v1/internal/reservation_sub_blocks_rest_stub.h index a469779eb964d..553b85a0c158b 100644 --- a/google/cloud/compute/reservation_sub_blocks/v1/internal/reservation_sub_blocks_rest_stub.h +++ b/google/cloud/compute/reservation_sub_blocks/v1/internal/reservation_sub_blocks_rest_stub.h @@ -21,6 +21,7 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RESERVATION_SUB_BLOCKS_V1_INTERNAL_RESERVATION_SUB_BLOCKS_REST_STUB_H #include "google/cloud/compute/reservation_sub_blocks/v1/reservation_sub_blocks.pb.h" +#include "google/cloud/compute/zone_operations/v1/zone_operations.pb.h" #include "google/cloud/completion_queue.h" #include "google/cloud/internal/rest_client.h" #include "google/cloud/internal/rest_context.h" @@ -45,6 +46,26 @@ class ReservationSubBlocksRestStub { google::cloud::cpp::compute::reservation_sub_blocks::v1:: GetReservationSubBlocksGetResponseRequest const& request) = 0; + virtual StatusOr GetIamPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + GetIamPolicyRequest const& request) = 0; + + virtual future> + AsyncGetVersion( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + GetVersionRequest const& request) = 0; + + virtual StatusOr GetVersion( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + GetVersionRequest const& request) = 0; + virtual StatusOr< google::cloud::cpp::compute::v1::ReservationSubBlocksListResponse> ListReservationSubBlocks( @@ -52,6 +73,61 @@ class ReservationSubBlocksRestStub { Options const& options, google::cloud::cpp::compute::reservation_sub_blocks::v1:: ListReservationSubBlocksRequest const& request) = 0; + + virtual future> + AsyncPerformMaintenance( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + PerformMaintenanceRequest const& request) = 0; + + virtual StatusOr + PerformMaintenance(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + PerformMaintenanceRequest const& request) = 0; + + virtual future> + AsyncReportFaulty( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + ReportFaultyRequest const& request) = 0; + + virtual StatusOr ReportFaulty( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + ReportFaultyRequest const& request) = 0; + + virtual StatusOr SetIamPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + SetIamPolicyRequest const& request) = 0; + + virtual StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + TestIamPermissionsRequest const& request) = 0; + + virtual future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + GetOperationRequest const& request) = 0; + + virtual future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest const& request) = 0; }; class DefaultReservationSubBlocksRestStub @@ -61,7 +137,8 @@ class DefaultReservationSubBlocksRestStub explicit DefaultReservationSubBlocksRestStub(Options options); DefaultReservationSubBlocksRestStub( - std::shared_ptr service, Options options); + std::shared_ptr service, + std::shared_ptr operations, Options options); StatusOr GetReservationSubBlocksGetResponse( @@ -70,6 +147,25 @@ class DefaultReservationSubBlocksRestStub google::cloud::cpp::compute::reservation_sub_blocks::v1:: GetReservationSubBlocksGetResponseRequest const& request) override; + StatusOr GetIamPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + GetIamPolicyRequest const& request) override; + + future> AsyncGetVersion( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + GetVersionRequest const& request) override; + + StatusOr GetVersion( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + GetVersionRequest const& request) override; + StatusOr ListReservationSubBlocks( google::cloud::rest_internal::RestContext& rest_context, @@ -77,8 +173,64 @@ class DefaultReservationSubBlocksRestStub google::cloud::cpp::compute::reservation_sub_blocks::v1:: ListReservationSubBlocksRequest const& request) override; + future> + AsyncPerformMaintenance( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + PerformMaintenanceRequest const& request) override; + + StatusOr PerformMaintenance( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + PerformMaintenanceRequest const& request) override; + + future> + AsyncReportFaulty( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + ReportFaultyRequest const& request) override; + + StatusOr ReportFaulty( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + ReportFaultyRequest const& request) override; + + StatusOr SetIamPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + SetIamPolicyRequest const& request) override; + + StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + TestIamPermissionsRequest const& request) override; + + future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + GetOperationRequest const& request) override; + + future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest const& request) override; + private: std::shared_ptr service_; + std::shared_ptr operations_; Options options_; }; diff --git a/google/cloud/compute/reservation_sub_blocks/v1/internal/reservation_sub_blocks_tracing_connection.cc b/google/cloud/compute/reservation_sub_blocks/v1/internal/reservation_sub_blocks_tracing_connection.cc index 19c78d6bb1833..a44619bf745ea 100644 --- a/google/cloud/compute/reservation_sub_blocks/v1/internal/reservation_sub_blocks_tracing_connection.cc +++ b/google/cloud/compute/reservation_sub_blocks/v1/internal/reservation_sub_blocks_tracing_connection.cc @@ -46,6 +46,49 @@ ReservationSubBlocksTracingConnection::GetReservationSubBlocksGetResponse( child_->GetReservationSubBlocksGetResponse(request)); } +StatusOr +ReservationSubBlocksTracingConnection::GetIamPolicy( + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + GetIamPolicyRequest const& request) { + auto span = internal::MakeSpan( + "compute_reservation_sub_blocks_v1::ReservationSubBlocksConnection::" + "GetIamPolicy"); + auto scope = opentelemetry::trace::Scope(span); + return internal::EndSpan(*span, child_->GetIamPolicy(request)); +} + +future> +ReservationSubBlocksTracingConnection::GetVersion( + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + GetVersionRequest const& request) { + auto span = internal::MakeSpan( + "compute_reservation_sub_blocks_v1::ReservationSubBlocksConnection::" + "GetVersion"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), child_->GetVersion(request)); +} + +StatusOr +ReservationSubBlocksTracingConnection::GetVersion( + NoAwaitTag, google::cloud::cpp::compute::reservation_sub_blocks::v1:: + GetVersionRequest const& request) { + auto span = internal::MakeSpan( + "compute_reservation_sub_blocks_v1::ReservationSubBlocksConnection::" + "GetVersion"); + opentelemetry::trace::Scope scope(span); + return internal::EndSpan(*span, child_->GetVersion(NoAwaitTag{}, request)); +} + +future> +ReservationSubBlocksTracingConnection::GetVersion( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto span = internal::MakeSpan( + "compute_reservation_sub_blocks_v1::ReservationSubBlocksConnection::" + "GetVersion"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), child_->GetVersion(operation)); +} + StreamRange ReservationSubBlocksTracingConnection::ListReservationSubBlocks( google::cloud::cpp::compute::reservation_sub_blocks::v1:: @@ -60,6 +103,95 @@ ReservationSubBlocksTracingConnection::ListReservationSubBlocks( std::move(sr)); } +future> +ReservationSubBlocksTracingConnection::PerformMaintenance( + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + PerformMaintenanceRequest const& request) { + auto span = internal::MakeSpan( + "compute_reservation_sub_blocks_v1::ReservationSubBlocksConnection::" + "PerformMaintenance"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), + child_->PerformMaintenance(request)); +} + +StatusOr +ReservationSubBlocksTracingConnection::PerformMaintenance( + NoAwaitTag, google::cloud::cpp::compute::reservation_sub_blocks::v1:: + PerformMaintenanceRequest const& request) { + auto span = internal::MakeSpan( + "compute_reservation_sub_blocks_v1::ReservationSubBlocksConnection::" + "PerformMaintenance"); + opentelemetry::trace::Scope scope(span); + return internal::EndSpan(*span, + child_->PerformMaintenance(NoAwaitTag{}, request)); +} + +future> +ReservationSubBlocksTracingConnection::PerformMaintenance( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto span = internal::MakeSpan( + "compute_reservation_sub_blocks_v1::ReservationSubBlocksConnection::" + "PerformMaintenance"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), + child_->PerformMaintenance(operation)); +} + +future> +ReservationSubBlocksTracingConnection::ReportFaulty( + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + ReportFaultyRequest const& request) { + auto span = internal::MakeSpan( + "compute_reservation_sub_blocks_v1::ReservationSubBlocksConnection::" + "ReportFaulty"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), child_->ReportFaulty(request)); +} + +StatusOr +ReservationSubBlocksTracingConnection::ReportFaulty( + NoAwaitTag, google::cloud::cpp::compute::reservation_sub_blocks::v1:: + ReportFaultyRequest const& request) { + auto span = internal::MakeSpan( + "compute_reservation_sub_blocks_v1::ReservationSubBlocksConnection::" + "ReportFaulty"); + opentelemetry::trace::Scope scope(span); + return internal::EndSpan(*span, child_->ReportFaulty(NoAwaitTag{}, request)); +} + +future> +ReservationSubBlocksTracingConnection::ReportFaulty( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto span = internal::MakeSpan( + "compute_reservation_sub_blocks_v1::ReservationSubBlocksConnection::" + "ReportFaulty"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), child_->ReportFaulty(operation)); +} + +StatusOr +ReservationSubBlocksTracingConnection::SetIamPolicy( + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + SetIamPolicyRequest const& request) { + auto span = internal::MakeSpan( + "compute_reservation_sub_blocks_v1::ReservationSubBlocksConnection::" + "SetIamPolicy"); + auto scope = opentelemetry::trace::Scope(span); + return internal::EndSpan(*span, child_->SetIamPolicy(request)); +} + +StatusOr +ReservationSubBlocksTracingConnection::TestIamPermissions( + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + TestIamPermissionsRequest const& request) { + auto span = internal::MakeSpan( + "compute_reservation_sub_blocks_v1::ReservationSubBlocksConnection::" + "TestIamPermissions"); + auto scope = opentelemetry::trace::Scope(span); + return internal::EndSpan(*span, child_->TestIamPermissions(request)); +} + std::shared_ptr< compute_reservation_sub_blocks_v1::ReservationSubBlocksConnection> MakeReservationSubBlocksTracingConnection( diff --git a/google/cloud/compute/reservation_sub_blocks/v1/internal/reservation_sub_blocks_tracing_connection.h b/google/cloud/compute/reservation_sub_blocks/v1/internal/reservation_sub_blocks_tracing_connection.h index a9f931da2eaff..fe6b3bd83bcdc 100644 --- a/google/cloud/compute/reservation_sub_blocks/v1/internal/reservation_sub_blocks_tracing_connection.h +++ b/google/cloud/compute/reservation_sub_blocks/v1/internal/reservation_sub_blocks_tracing_connection.h @@ -46,11 +46,57 @@ class ReservationSubBlocksTracingConnection google::cloud::cpp::compute::reservation_sub_blocks::v1:: GetReservationSubBlocksGetResponseRequest const& request) override; + StatusOr GetIamPolicy( + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + GetIamPolicyRequest const& request) override; + + future> GetVersion( + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + GetVersionRequest const& request) override; + + StatusOr GetVersion( + NoAwaitTag, google::cloud::cpp::compute::reservation_sub_blocks::v1:: + GetVersionRequest const& request) override; + + future> GetVersion( + google::cloud::cpp::compute::v1::Operation const& operation) override; + StreamRange ListReservationSubBlocks( google::cloud::cpp::compute::reservation_sub_blocks::v1:: ListReservationSubBlocksRequest request) override; + future> + PerformMaintenance(google::cloud::cpp::compute::reservation_sub_blocks::v1:: + PerformMaintenanceRequest const& request) override; + + StatusOr PerformMaintenance( + NoAwaitTag, google::cloud::cpp::compute::reservation_sub_blocks::v1:: + PerformMaintenanceRequest const& request) override; + + future> + PerformMaintenance( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + future> ReportFaulty( + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + ReportFaultyRequest const& request) override; + + StatusOr ReportFaulty( + NoAwaitTag, google::cloud::cpp::compute::reservation_sub_blocks::v1:: + ReportFaultyRequest const& request) override; + + future> ReportFaulty( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + StatusOr SetIamPolicy( + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + SetIamPolicyRequest const& request) override; + + StatusOr + TestIamPermissions(google::cloud::cpp::compute::reservation_sub_blocks::v1:: + TestIamPermissionsRequest const& request) override; + private: std::shared_ptr< compute_reservation_sub_blocks_v1::ReservationSubBlocksConnection> diff --git a/google/cloud/compute/reservation_sub_blocks/v1/mocks/mock_reservation_sub_blocks_connection.h b/google/cloud/compute/reservation_sub_blocks/v1/mocks/mock_reservation_sub_blocks_connection.h index 2d637cb7684b1..fe64bbdecfdee 100644 --- a/google/cloud/compute/reservation_sub_blocks/v1/mocks/mock_reservation_sub_blocks_connection.h +++ b/google/cloud/compute/reservation_sub_blocks/v1/mocks/mock_reservation_sub_blocks_connection.h @@ -56,12 +56,150 @@ class MockReservationSubBlocksConnection GetReservationSubBlocksGetResponseRequest const& request), (override)); + MOCK_METHOD(StatusOr, GetIamPolicy, + (google::cloud::cpp::compute::reservation_sub_blocks::v1:: + GetIamPolicyRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// GetVersion(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + GetVersion, + (google::cloud::cpp::compute::reservation_sub_blocks::v1:: + GetVersionRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// EXPECT_CALL(*mock, GetVersion(_, _)) + /// @endcode + MOCK_METHOD(StatusOr, GetVersion, + (NoAwaitTag, google::cloud::cpp::compute::reservation_sub_blocks:: + v1::GetVersionRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// GetVersion(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + GetVersion, + (google::cloud::cpp::compute::v1::Operation const& operation), + (override)); + MOCK_METHOD( (StreamRange), ListReservationSubBlocks, (google::cloud::cpp::compute::reservation_sub_blocks::v1:: ListReservationSubBlocksRequest request), (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// PerformMaintenance(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + PerformMaintenance, + (google::cloud::cpp::compute::reservation_sub_blocks::v1:: + PerformMaintenanceRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// EXPECT_CALL(*mock, PerformMaintenance(_, _)) + /// @endcode + MOCK_METHOD(StatusOr, + PerformMaintenance, + (NoAwaitTag, google::cloud::cpp::compute::reservation_sub_blocks:: + v1::PerformMaintenanceRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// PerformMaintenance(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + PerformMaintenance, + (google::cloud::cpp::compute::v1::Operation const& operation), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// ReportFaulty(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + ReportFaulty, + (google::cloud::cpp::compute::reservation_sub_blocks::v1:: + ReportFaultyRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// EXPECT_CALL(*mock, ReportFaulty(_, _)) + /// @endcode + MOCK_METHOD(StatusOr, + ReportFaulty, + (NoAwaitTag, google::cloud::cpp::compute::reservation_sub_blocks:: + v1::ReportFaultyRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// ReportFaulty(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + ReportFaulty, + (google::cloud::cpp::compute::v1::Operation const& operation), + (override)); + + MOCK_METHOD(StatusOr, SetIamPolicy, + (google::cloud::cpp::compute::reservation_sub_blocks::v1:: + SetIamPolicyRequest const& request), + (override)); + + MOCK_METHOD( + StatusOr, + TestIamPermissions, + (google::cloud::cpp::compute::reservation_sub_blocks::v1:: + TestIamPermissionsRequest const& request), + (override)); }; GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END diff --git a/google/cloud/compute/reservation_sub_blocks/v1/reservation_sub_blocks_client.cc b/google/cloud/compute/reservation_sub_blocks/v1/reservation_sub_blocks_client.cc index fe25dc2e83361..2274f99ee8b57 100644 --- a/google/cloud/compute/reservation_sub_blocks/v1/reservation_sub_blocks_client.cc +++ b/google/cloud/compute/reservation_sub_blocks/v1/reservation_sub_blocks_client.cc @@ -57,6 +57,97 @@ ReservationSubBlocksClient::GetReservationSubBlocksGetResponse( return connection_->GetReservationSubBlocksGetResponse(request); } +StatusOr +ReservationSubBlocksClient::GetIamPolicy(std::string const& project, + std::string const& zone, + std::string const& parent_resource, + std::string const& resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::reservation_sub_blocks::v1::GetIamPolicyRequest + request; + request.set_project(project); + request.set_zone(zone); + request.set_parent_resource(parent_resource); + request.set_resource(resource); + return connection_->GetIamPolicy(request); +} + +StatusOr +ReservationSubBlocksClient::GetIamPolicy( + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + GetIamPolicyRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->GetIamPolicy(request); +} + +future> +ReservationSubBlocksClient::GetVersion( + std::string const& project, std::string const& zone, + std::string const& parent_name, std::string const& reservation_sub_block, + google::cloud::cpp::compute::v1:: + ReservationSubBlocksGetVersionRequest const& + reservation_sub_blocks_get_version_request_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::reservation_sub_blocks::v1::GetVersionRequest + request; + request.set_project(project); + request.set_zone(zone); + request.set_parent_name(parent_name); + request.set_reservation_sub_block(reservation_sub_block); + *request.mutable_reservation_sub_blocks_get_version_request_resource() = + reservation_sub_blocks_get_version_request_resource; + return connection_->GetVersion(request); +} + +StatusOr +ReservationSubBlocksClient::GetVersion( + NoAwaitTag, std::string const& project, std::string const& zone, + std::string const& parent_name, std::string const& reservation_sub_block, + google::cloud::cpp::compute::v1:: + ReservationSubBlocksGetVersionRequest const& + reservation_sub_blocks_get_version_request_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::reservation_sub_blocks::v1::GetVersionRequest + request; + request.set_project(project); + request.set_zone(zone); + request.set_parent_name(parent_name); + request.set_reservation_sub_block(reservation_sub_block); + *request.mutable_reservation_sub_blocks_get_version_request_resource() = + reservation_sub_blocks_get_version_request_resource; + return connection_->GetVersion(NoAwaitTag{}, request); +} + +future> +ReservationSubBlocksClient::GetVersion( + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + GetVersionRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->GetVersion(request); +} + +StatusOr +ReservationSubBlocksClient::GetVersion( + NoAwaitTag, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + GetVersionRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->GetVersion(NoAwaitTag{}, request); +} + +future> +ReservationSubBlocksClient::GetVersion( + google::cloud::cpp::compute::v1::Operation const& operation, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->GetVersion(operation); +} + StreamRange ReservationSubBlocksClient::ListReservationSubBlocks( std::string const& project, std::string const& zone, @@ -79,6 +170,184 @@ ReservationSubBlocksClient::ListReservationSubBlocks( return connection_->ListReservationSubBlocks(std::move(request)); } +future> +ReservationSubBlocksClient::PerformMaintenance( + std::string const& project, std::string const& zone, + std::string const& parent_name, std::string const& reservation_sub_block, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + PerformMaintenanceRequest request; + request.set_project(project); + request.set_zone(zone); + request.set_parent_name(parent_name); + request.set_reservation_sub_block(reservation_sub_block); + return connection_->PerformMaintenance(request); +} + +StatusOr +ReservationSubBlocksClient::PerformMaintenance( + NoAwaitTag, std::string const& project, std::string const& zone, + std::string const& parent_name, std::string const& reservation_sub_block, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + PerformMaintenanceRequest request; + request.set_project(project); + request.set_zone(zone); + request.set_parent_name(parent_name); + request.set_reservation_sub_block(reservation_sub_block); + return connection_->PerformMaintenance(NoAwaitTag{}, request); +} + +future> +ReservationSubBlocksClient::PerformMaintenance( + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + PerformMaintenanceRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->PerformMaintenance(request); +} + +StatusOr +ReservationSubBlocksClient::PerformMaintenance( + NoAwaitTag, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + PerformMaintenanceRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->PerformMaintenance(NoAwaitTag{}, request); +} + +future> +ReservationSubBlocksClient::PerformMaintenance( + google::cloud::cpp::compute::v1::Operation const& operation, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->PerformMaintenance(operation); +} + +future> +ReservationSubBlocksClient::ReportFaulty( + std::string const& project, std::string const& zone, + std::string const& parent_name, std::string const& reservation_sub_block, + google::cloud::cpp::compute::v1:: + ReservationSubBlocksReportFaultyRequest const& + reservation_sub_blocks_report_faulty_request_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::reservation_sub_blocks::v1::ReportFaultyRequest + request; + request.set_project(project); + request.set_zone(zone); + request.set_parent_name(parent_name); + request.set_reservation_sub_block(reservation_sub_block); + *request.mutable_reservation_sub_blocks_report_faulty_request_resource() = + reservation_sub_blocks_report_faulty_request_resource; + return connection_->ReportFaulty(request); +} + +StatusOr +ReservationSubBlocksClient::ReportFaulty( + NoAwaitTag, std::string const& project, std::string const& zone, + std::string const& parent_name, std::string const& reservation_sub_block, + google::cloud::cpp::compute::v1:: + ReservationSubBlocksReportFaultyRequest const& + reservation_sub_blocks_report_faulty_request_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::reservation_sub_blocks::v1::ReportFaultyRequest + request; + request.set_project(project); + request.set_zone(zone); + request.set_parent_name(parent_name); + request.set_reservation_sub_block(reservation_sub_block); + *request.mutable_reservation_sub_blocks_report_faulty_request_resource() = + reservation_sub_blocks_report_faulty_request_resource; + return connection_->ReportFaulty(NoAwaitTag{}, request); +} + +future> +ReservationSubBlocksClient::ReportFaulty( + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + ReportFaultyRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->ReportFaulty(request); +} + +StatusOr +ReservationSubBlocksClient::ReportFaulty( + NoAwaitTag, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + ReportFaultyRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->ReportFaulty(NoAwaitTag{}, request); +} + +future> +ReservationSubBlocksClient::ReportFaulty( + google::cloud::cpp::compute::v1::Operation const& operation, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->ReportFaulty(operation); +} + +StatusOr +ReservationSubBlocksClient::SetIamPolicy( + std::string const& project, std::string const& zone, + std::string const& parent_resource, std::string const& resource, + google::cloud::cpp::compute::v1::ZoneSetNestedPolicyRequest const& + zone_set_nested_policy_request_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::reservation_sub_blocks::v1::SetIamPolicyRequest + request; + request.set_project(project); + request.set_zone(zone); + request.set_parent_resource(parent_resource); + request.set_resource(resource); + *request.mutable_zone_set_nested_policy_request_resource() = + zone_set_nested_policy_request_resource; + return connection_->SetIamPolicy(request); +} + +StatusOr +ReservationSubBlocksClient::SetIamPolicy( + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + SetIamPolicyRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->SetIamPolicy(request); +} + +StatusOr +ReservationSubBlocksClient::TestIamPermissions( + std::string const& project, std::string const& zone, + std::string const& parent_resource, std::string const& resource, + google::cloud::cpp::compute::v1::TestPermissionsRequest const& + test_permissions_request_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + TestIamPermissionsRequest request; + request.set_project(project); + request.set_zone(zone); + request.set_parent_resource(parent_resource); + request.set_resource(resource); + *request.mutable_test_permissions_request_resource() = + test_permissions_request_resource; + return connection_->TestIamPermissions(request); +} + +StatusOr +ReservationSubBlocksClient::TestIamPermissions( + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + TestIamPermissionsRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->TestIamPermissions(request); +} + GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END } // namespace compute_reservation_sub_blocks_v1 } // namespace cloud diff --git a/google/cloud/compute/reservation_sub_blocks/v1/reservation_sub_blocks_client.h b/google/cloud/compute/reservation_sub_blocks/v1/reservation_sub_blocks_client.h index 07afd9e3999f5..4d6f14edd0e6c 100644 --- a/google/cloud/compute/reservation_sub_blocks/v1/reservation_sub_blocks_client.h +++ b/google/cloud/compute/reservation_sub_blocks/v1/reservation_sub_blocks_client.h @@ -22,6 +22,7 @@ #include "google/cloud/compute/reservation_sub_blocks/v1/reservation_sub_blocks_rest_connection.h" #include "google/cloud/future.h" +#include "google/cloud/no_await_tag.h" #include "google/cloud/options.h" #include "google/cloud/polling_policy.h" #include "google/cloud/status_or.h" @@ -98,8 +99,8 @@ class ReservationSubBlocksClient { /// @param zone Name of the zone for this request. Zone name should conform to RFC1035. /// @param parent_name The name of the parent reservation and parent block. In the format of /// reservations/{reservation_name}/reservationBlocks/{reservation_block_name} - /// @param reservation_sub_block The name of the reservation subBlock. Name should conform to RFC1035 or be - /// a resource ID. + /// @param reservation_sub_block The name of the reservation subBlock. + /// Name should conform to RFC1035 or be a resource ID. /// @param opts Optional. Override the class-level options, such as retry and /// backoff policies. /// @return the result of the RPC. The response message type @@ -113,8 +114,8 @@ class ReservationSubBlocksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.reservation_sub_blocks.v1.GetReservationSubBlocksGetResponseRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservation_sub_blocks/v1/reservation_sub_blocks.proto#L62} - /// [google.cloud.cpp.compute.v1.ReservationSubBlocksGetResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_113.proto#L82} + /// [google.cloud.cpp.compute.reservation_sub_blocks.v1.GetReservationSubBlocksGetResponseRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservation_sub_blocks/v1/reservation_sub_blocks.proto#L165} + /// [google.cloud.cpp.compute.v1.ReservationSubBlocksGetResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_002.proto#L165} /// // clang-format on StatusOr @@ -148,8 +149,8 @@ class ReservationSubBlocksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.reservation_sub_blocks.v1.GetReservationSubBlocksGetResponseRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservation_sub_blocks/v1/reservation_sub_blocks.proto#L62} - /// [google.cloud.cpp.compute.v1.ReservationSubBlocksGetResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_113.proto#L82} + /// [google.cloud.cpp.compute.reservation_sub_blocks.v1.GetReservationSubBlocksGetResponseRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservation_sub_blocks/v1/reservation_sub_blocks.proto#L165} + /// [google.cloud.cpp.compute.v1.ReservationSubBlocksGetResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_002.proto#L165} /// // clang-format on StatusOr @@ -158,6 +159,203 @@ class ReservationSubBlocksClient { GetReservationSubBlocksGetResponseRequest const& request, Options opts = {}); + // clang-format off + /// + /// Gets the access control policy for a resource. May be empty if no such + /// policy or resource exists. + /// https://cloud.google.com/compute/docs/reference/rest/v1/reservationSubBlocks/getIamPolicy + /// + /// @param project Project ID for this request. + /// @param zone The name of the zone for this request. + /// @param parent_resource Name or id of parent resource of the resource for this request. + /// @param resource Name or id of the resource for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.Policy]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.reservation_sub_blocks.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservation_sub_blocks/v1/reservation_sub_blocks.proto#L143} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} + /// + // clang-format on + StatusOr GetIamPolicy( + std::string const& project, std::string const& zone, + std::string const& parent_resource, std::string const& resource, + Options opts = {}); + + // clang-format off + /// + /// Gets the access control policy for a resource. May be empty if no such + /// policy or resource exists. + /// https://cloud.google.com/compute/docs/reference/rest/v1/reservationSubBlocks/getIamPolicy + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.reservation_sub_blocks.v1.GetIamPolicyRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.Policy]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.reservation_sub_blocks.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservation_sub_blocks/v1/reservation_sub_blocks.proto#L143} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} + /// + // clang-format on + StatusOr GetIamPolicy( + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + GetIamPolicyRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// Allows customers to get SBOM versions of a reservation subBlock. + /// https://cloud.google.com/compute/docs/reference/rest/v1/reservationSubBlocks/getVersion + /// + /// @param project Project ID for this request. + /// @param zone Name of the zone for this request. Zone name should conform to RFC1035. + /// @param parent_name The name of the parent reservation and parent block. In the format of + /// reservations/{reservation_name}/reservationBlocks/{reservation_block_name} + /// @param reservation_sub_block The name of the reservation subBlock. + /// Name should conform to RFC1035 or be a resource ID. + /// @param reservation_sub_blocks_get_version_request_resource The ReservationSubBlocksGetVersionRequest for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.reservation_sub_blocks.v1.GetVersionRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservation_sub_blocks/v1/reservation_sub_blocks.proto#L195} + /// + // clang-format on + future> GetVersion( + std::string const& project, std::string const& zone, + std::string const& parent_name, std::string const& reservation_sub_block, + google::cloud::cpp::compute::v1:: + ReservationSubBlocksGetVersionRequest const& + reservation_sub_blocks_get_version_request_resource, + Options opts = {}); + + // clang-format off + /// + /// @copybrief GetVersion + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr GetVersion( + NoAwaitTag, std::string const& project, std::string const& zone, + std::string const& parent_name, std::string const& reservation_sub_block, + google::cloud::cpp::compute::v1:: + ReservationSubBlocksGetVersionRequest const& + reservation_sub_blocks_get_version_request_resource, + Options opts = {}); + + // clang-format off + /// + /// Allows customers to get SBOM versions of a reservation subBlock. + /// https://cloud.google.com/compute/docs/reference/rest/v1/reservationSubBlocks/getVersion + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.reservation_sub_blocks.v1.GetVersionRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.reservation_sub_blocks.v1.GetVersionRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservation_sub_blocks/v1/reservation_sub_blocks.proto#L195} + /// + // clang-format on + future> GetVersion( + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + GetVersionRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief GetVersion + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr GetVersion( + NoAwaitTag, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + GetVersionRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief GetVersion + /// + /// This method accepts a `google::cloud::cpp::compute::v1::Operation` that corresponds + /// to a previously started Long Running Operation (LRO) and polls the status + /// of the LRO in the background. + /// + // clang-format on + future> GetVersion( + google::cloud::cpp::compute::v1::Operation const& operation, + Options opts = {}); + // clang-format off /// /// Retrieves a list of reservation subBlocks under a single reservation. @@ -189,8 +387,8 @@ class ReservationSubBlocksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.reservation_sub_blocks.v1.ListReservationSubBlocksRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservation_sub_blocks/v1/reservation_sub_blocks.proto#L84} - /// [google.cloud.cpp.compute.v1.ReservationSubBlock]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_113.proto#L25} + /// [google.cloud.cpp.compute.reservation_sub_blocks.v1.ListReservationSubBlocksRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservation_sub_blocks/v1/reservation_sub_blocks.proto#L244} + /// [google.cloud.cpp.compute.v1.ReservationSubBlock]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_002.proto#L61} /// // clang-format on StreamRange @@ -230,8 +428,8 @@ class ReservationSubBlocksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.reservation_sub_blocks.v1.ListReservationSubBlocksRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservation_sub_blocks/v1/reservation_sub_blocks.proto#L84} - /// [google.cloud.cpp.compute.v1.ReservationSubBlock]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_113.proto#L25} + /// [google.cloud.cpp.compute.reservation_sub_blocks.v1.ListReservationSubBlocksRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservation_sub_blocks/v1/reservation_sub_blocks.proto#L244} + /// [google.cloud.cpp.compute.v1.ReservationSubBlock]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_002.proto#L61} /// // clang-format on StreamRange @@ -239,6 +437,400 @@ class ReservationSubBlocksClient { v1::ListReservationSubBlocksRequest request, Options opts = {}); + // clang-format off + /// + /// Allows customers to perform maintenance on a reservation subBlock + /// https://cloud.google.com/compute/docs/reference/rest/v1/reservationSubBlocks/performMaintenance + /// + /// @param project Project ID for this request. + /// @param zone Name of the zone for this request. Zone name should conform to RFC1035. + /// @param parent_name The name of the parent reservation and parent block. In the format of + /// reservations/{reservation_name}/reservationBlocks/{reservation_block_name} + /// @param reservation_sub_block The name of the reservation subBlock. + /// Name should conform to RFC1035 or be a resource ID. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.reservation_sub_blocks.v1.PerformMaintenanceRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservation_sub_blocks/v1/reservation_sub_blocks.proto#L353} + /// + // clang-format on + future> + PerformMaintenance(std::string const& project, std::string const& zone, + std::string const& parent_name, + std::string const& reservation_sub_block, + Options opts = {}); + + // clang-format off + /// + /// @copybrief PerformMaintenance + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr PerformMaintenance( + NoAwaitTag, std::string const& project, std::string const& zone, + std::string const& parent_name, std::string const& reservation_sub_block, + Options opts = {}); + + // clang-format off + /// + /// Allows customers to perform maintenance on a reservation subBlock + /// https://cloud.google.com/compute/docs/reference/rest/v1/reservationSubBlocks/performMaintenance + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.reservation_sub_blocks.v1.PerformMaintenanceRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.reservation_sub_blocks.v1.PerformMaintenanceRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservation_sub_blocks/v1/reservation_sub_blocks.proto#L353} + /// + // clang-format on + future> + PerformMaintenance(google::cloud::cpp::compute::reservation_sub_blocks::v1:: + PerformMaintenanceRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief PerformMaintenance + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr PerformMaintenance( + NoAwaitTag, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + PerformMaintenanceRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief PerformMaintenance + /// + /// This method accepts a `google::cloud::cpp::compute::v1::Operation` that corresponds + /// to a previously started Long Running Operation (LRO) and polls the status + /// of the LRO in the background. + /// + // clang-format on + future> + PerformMaintenance( + google::cloud::cpp::compute::v1::Operation const& operation, + Options opts = {}); + + // clang-format off + /// + /// Allows customers to report a faulty subBlock. + /// https://cloud.google.com/compute/docs/reference/rest/v1/reservationSubBlocks/reportFaulty + /// + /// @param project Project ID for this request. + /// @param zone Name of the zone for this request. Zone name should conform to RFC1035. + /// @param parent_name The name of the parent reservation and parent block. In the format of + /// reservations/{reservation_name}/reservationBlocks/{reservation_block_name} + /// @param reservation_sub_block The name of the reservation subBlock. + /// Name should conform to RFC1035 or be a resource ID. + /// @param reservation_sub_blocks_report_faulty_request_resource The ReservationSubBlocksReportFaultyRequest for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.reservation_sub_blocks.v1.ReportFaultyRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservation_sub_blocks/v1/reservation_sub_blocks.proto#L397} + /// + // clang-format on + future> ReportFaulty( + std::string const& project, std::string const& zone, + std::string const& parent_name, std::string const& reservation_sub_block, + google::cloud::cpp::compute::v1:: + ReservationSubBlocksReportFaultyRequest const& + reservation_sub_blocks_report_faulty_request_resource, + Options opts = {}); + + // clang-format off + /// + /// @copybrief ReportFaulty + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr ReportFaulty( + NoAwaitTag, std::string const& project, std::string const& zone, + std::string const& parent_name, std::string const& reservation_sub_block, + google::cloud::cpp::compute::v1:: + ReservationSubBlocksReportFaultyRequest const& + reservation_sub_blocks_report_faulty_request_resource, + Options opts = {}); + + // clang-format off + /// + /// Allows customers to report a faulty subBlock. + /// https://cloud.google.com/compute/docs/reference/rest/v1/reservationSubBlocks/reportFaulty + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.reservation_sub_blocks.v1.ReportFaultyRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.reservation_sub_blocks.v1.ReportFaultyRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservation_sub_blocks/v1/reservation_sub_blocks.proto#L397} + /// + // clang-format on + future> ReportFaulty( + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + ReportFaultyRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief ReportFaulty + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr ReportFaulty( + NoAwaitTag, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + ReportFaultyRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief ReportFaulty + /// + /// This method accepts a `google::cloud::cpp::compute::v1::Operation` that corresponds + /// to a previously started Long Running Operation (LRO) and polls the status + /// of the LRO in the background. + /// + // clang-format on + future> ReportFaulty( + google::cloud::cpp::compute::v1::Operation const& operation, + Options opts = {}); + + // clang-format off + /// + /// Sets the access control policy on the specified resource. + /// Replaces any existing policy. + /// https://cloud.google.com/compute/docs/reference/rest/v1/reservationSubBlocks/setIamPolicy + /// + /// @param project Project ID for this request. + /// @param zone The name of the zone for this request. + /// @param parent_resource Name or id of parent resource of the resource for this request. + /// @param resource Name or id of the resource for this request. + /// @param zone_set_nested_policy_request_resource The ZoneSetNestedPolicyRequest for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.Policy]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.reservation_sub_blocks.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservation_sub_blocks/v1/reservation_sub_blocks.proto#L446} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} + /// + // clang-format on + StatusOr SetIamPolicy( + std::string const& project, std::string const& zone, + std::string const& parent_resource, std::string const& resource, + google::cloud::cpp::compute::v1::ZoneSetNestedPolicyRequest const& + zone_set_nested_policy_request_resource, + Options opts = {}); + + // clang-format off + /// + /// Sets the access control policy on the specified resource. + /// Replaces any existing policy. + /// https://cloud.google.com/compute/docs/reference/rest/v1/reservationSubBlocks/setIamPolicy + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.reservation_sub_blocks.v1.SetIamPolicyRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.Policy]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.reservation_sub_blocks.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservation_sub_blocks/v1/reservation_sub_blocks.proto#L446} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} + /// + // clang-format on + StatusOr SetIamPolicy( + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + SetIamPolicyRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// Returns permissions that a caller has on the specified resource. + /// https://cloud.google.com/compute/docs/reference/rest/v1/reservationSubBlocks/testIamPermissions + /// + /// @param project Project ID for this request. + /// @param zone The name of the zone for this request. + /// @param parent_resource Name or id of parent resource of the resource for this request. + /// @param resource Name or id of the resource for this request. + /// @param test_permissions_request_resource The TestPermissionsRequest for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.TestPermissionsResponse]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.reservation_sub_blocks.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservation_sub_blocks/v1/reservation_sub_blocks.proto#L469} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} + /// + // clang-format on + StatusOr + TestIamPermissions( + std::string const& project, std::string const& zone, + std::string const& parent_resource, std::string const& resource, + google::cloud::cpp::compute::v1::TestPermissionsRequest const& + test_permissions_request_resource, + Options opts = {}); + + // clang-format off + /// + /// Returns permissions that a caller has on the specified resource. + /// https://cloud.google.com/compute/docs/reference/rest/v1/reservationSubBlocks/testIamPermissions + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.reservation_sub_blocks.v1.TestIamPermissionsRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.TestPermissionsResponse]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.reservation_sub_blocks.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservation_sub_blocks/v1/reservation_sub_blocks.proto#L469} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} + /// + // clang-format on + StatusOr + TestIamPermissions(google::cloud::cpp::compute::reservation_sub_blocks::v1:: + TestIamPermissionsRequest const& request, + Options opts = {}); + private: std::shared_ptr connection_; Options options_; diff --git a/google/cloud/compute/reservation_sub_blocks/v1/reservation_sub_blocks_connection.cc b/google/cloud/compute/reservation_sub_blocks/v1/reservation_sub_blocks_connection.cc index faa0f832af3ee..08427b044525b 100644 --- a/google/cloud/compute/reservation_sub_blocks/v1/reservation_sub_blocks_connection.cc +++ b/google/cloud/compute/reservation_sub_blocks/v1/reservation_sub_blocks_connection.cc @@ -44,6 +44,38 @@ ReservationSubBlocksConnection::GetReservationSubBlocksGetResponse( return Status(StatusCode::kUnimplemented, "not implemented"); } +StatusOr +ReservationSubBlocksConnection::GetIamPolicy( + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + GetIamPolicyRequest const&) { + return Status(StatusCode::kUnimplemented, "not implemented"); +} + +future> +ReservationSubBlocksConnection::GetVersion( + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + GetVersionRequest const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +ReservationSubBlocksConnection::GetVersion( + NoAwaitTag, google::cloud::cpp::compute::reservation_sub_blocks::v1:: + GetVersionRequest const&) { + return StatusOr( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +ReservationSubBlocksConnection::GetVersion( + google::cloud::cpp::compute::v1::Operation const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + StreamRange ReservationSubBlocksConnection::ListReservationSubBlocks( google::cloud::cpp::compute::reservation_sub_blocks::v1:: @@ -52,6 +84,70 @@ ReservationSubBlocksConnection::ListReservationSubBlocks( StreamRange>(); } +future> +ReservationSubBlocksConnection::PerformMaintenance( + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + PerformMaintenanceRequest const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +ReservationSubBlocksConnection::PerformMaintenance( + NoAwaitTag, google::cloud::cpp::compute::reservation_sub_blocks::v1:: + PerformMaintenanceRequest const&) { + return StatusOr( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +ReservationSubBlocksConnection::PerformMaintenance( + google::cloud::cpp::compute::v1::Operation const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +ReservationSubBlocksConnection::ReportFaulty( + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + ReportFaultyRequest const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +ReservationSubBlocksConnection::ReportFaulty( + NoAwaitTag, google::cloud::cpp::compute::reservation_sub_blocks::v1:: + ReportFaultyRequest const&) { + return StatusOr( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +ReservationSubBlocksConnection::ReportFaulty( + google::cloud::cpp::compute::v1::Operation const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +ReservationSubBlocksConnection::SetIamPolicy( + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + SetIamPolicyRequest const&) { + return Status(StatusCode::kUnimplemented, "not implemented"); +} + +StatusOr +ReservationSubBlocksConnection::TestIamPermissions( + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + TestIamPermissionsRequest const&) { + return Status(StatusCode::kUnimplemented, "not implemented"); +} + GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END } // namespace compute_reservation_sub_blocks_v1 } // namespace cloud diff --git a/google/cloud/compute/reservation_sub_blocks/v1/reservation_sub_blocks_connection.h b/google/cloud/compute/reservation_sub_blocks/v1/reservation_sub_blocks_connection.h index 4a5f11208dc3a..e9c6b8ad40866 100644 --- a/google/cloud/compute/reservation_sub_blocks/v1/reservation_sub_blocks_connection.h +++ b/google/cloud/compute/reservation_sub_blocks/v1/reservation_sub_blocks_connection.h @@ -24,8 +24,11 @@ #include "google/cloud/compute/reservation_sub_blocks/v1/reservation_sub_blocks.pb.h" #include "google/cloud/compute/reservation_sub_blocks/v1/reservation_sub_blocks_connection_idempotency_policy.h" #include "google/cloud/backoff_policy.h" +#include "google/cloud/future.h" #include "google/cloud/internal/retry_policy_impl.h" +#include "google/cloud/no_await_tag.h" #include "google/cloud/options.h" +#include "google/cloud/polling_policy.h" #include "google/cloud/status_or.h" #include "google/cloud/stream_range.h" #include "google/cloud/version.h" @@ -196,9 +199,56 @@ class ReservationSubBlocksConnection { google::cloud::cpp::compute::reservation_sub_blocks::v1:: GetReservationSubBlocksGetResponseRequest const& request); + virtual StatusOr GetIamPolicy( + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + GetIamPolicyRequest const& request); + + virtual future> + GetVersion(google::cloud::cpp::compute::reservation_sub_blocks::v1:: + GetVersionRequest const& request); + + virtual StatusOr GetVersion( + NoAwaitTag, google::cloud::cpp::compute::reservation_sub_blocks::v1:: + GetVersionRequest const& request); + + virtual future> + GetVersion(google::cloud::cpp::compute::v1::Operation const& operation); + virtual StreamRange ListReservationSubBlocks(google::cloud::cpp::compute::reservation_sub_blocks:: v1::ListReservationSubBlocksRequest request); + + virtual future> + PerformMaintenance(google::cloud::cpp::compute::reservation_sub_blocks::v1:: + PerformMaintenanceRequest const& request); + + virtual StatusOr + PerformMaintenance(NoAwaitTag, + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + PerformMaintenanceRequest const& request); + + virtual future> + PerformMaintenance( + google::cloud::cpp::compute::v1::Operation const& operation); + + virtual future> + ReportFaulty(google::cloud::cpp::compute::reservation_sub_blocks::v1:: + ReportFaultyRequest const& request); + + virtual StatusOr ReportFaulty( + NoAwaitTag, google::cloud::cpp::compute::reservation_sub_blocks::v1:: + ReportFaultyRequest const& request); + + virtual future> + ReportFaulty(google::cloud::cpp::compute::v1::Operation const& operation); + + virtual StatusOr SetIamPolicy( + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + SetIamPolicyRequest const& request); + + virtual StatusOr + TestIamPermissions(google::cloud::cpp::compute::reservation_sub_blocks::v1:: + TestIamPermissionsRequest const& request); }; GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END diff --git a/google/cloud/compute/reservation_sub_blocks/v1/reservation_sub_blocks_connection_idempotency_policy.cc b/google/cloud/compute/reservation_sub_blocks/v1/reservation_sub_blocks_connection_idempotency_policy.cc index b130f0c5cdeee..75aeac28e1e7f 100644 --- a/google/cloud/compute/reservation_sub_blocks/v1/reservation_sub_blocks_connection_idempotency_policy.cc +++ b/google/cloud/compute/reservation_sub_blocks/v1/reservation_sub_blocks_connection_idempotency_policy.cc @@ -43,6 +43,18 @@ Idempotency ReservationSubBlocksConnectionIdempotencyPolicy:: return Idempotency::kIdempotent; } +Idempotency ReservationSubBlocksConnectionIdempotencyPolicy::GetIamPolicy( + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + GetIamPolicyRequest const&) { + return Idempotency::kIdempotent; +} + +Idempotency ReservationSubBlocksConnectionIdempotencyPolicy::GetVersion( + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + GetVersionRequest const&) { + return Idempotency::kNonIdempotent; +} + Idempotency ReservationSubBlocksConnectionIdempotencyPolicy::ListReservationSubBlocks( google::cloud::cpp::compute::reservation_sub_blocks::v1:: @@ -50,6 +62,30 @@ ReservationSubBlocksConnectionIdempotencyPolicy::ListReservationSubBlocks( return Idempotency::kIdempotent; } +Idempotency ReservationSubBlocksConnectionIdempotencyPolicy::PerformMaintenance( + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + PerformMaintenanceRequest const&) { + return Idempotency::kNonIdempotent; +} + +Idempotency ReservationSubBlocksConnectionIdempotencyPolicy::ReportFaulty( + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + ReportFaultyRequest const&) { + return Idempotency::kNonIdempotent; +} + +Idempotency ReservationSubBlocksConnectionIdempotencyPolicy::SetIamPolicy( + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + SetIamPolicyRequest const&) { + return Idempotency::kNonIdempotent; +} + +Idempotency ReservationSubBlocksConnectionIdempotencyPolicy::TestIamPermissions( + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + TestIamPermissionsRequest const&) { + return Idempotency::kNonIdempotent; +} + std::unique_ptr MakeDefaultReservationSubBlocksConnectionIdempotencyPolicy() { return std::make_unique(); diff --git a/google/cloud/compute/reservation_sub_blocks/v1/reservation_sub_blocks_connection_idempotency_policy.h b/google/cloud/compute/reservation_sub_blocks/v1/reservation_sub_blocks_connection_idempotency_policy.h index 43d85621d4f68..e16b5123e61a4 100644 --- a/google/cloud/compute/reservation_sub_blocks/v1/reservation_sub_blocks_connection_idempotency_policy.h +++ b/google/cloud/compute/reservation_sub_blocks/v1/reservation_sub_blocks_connection_idempotency_policy.h @@ -42,9 +42,33 @@ class ReservationSubBlocksConnectionIdempotencyPolicy { google::cloud::cpp::compute::reservation_sub_blocks::v1:: GetReservationSubBlocksGetResponseRequest const& request); + virtual google::cloud::Idempotency GetIamPolicy( + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + GetIamPolicyRequest const& request); + + virtual google::cloud::Idempotency GetVersion( + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + GetVersionRequest const& request); + virtual google::cloud::Idempotency ListReservationSubBlocks( google::cloud::cpp::compute::reservation_sub_blocks::v1:: ListReservationSubBlocksRequest request); + + virtual google::cloud::Idempotency PerformMaintenance( + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + PerformMaintenanceRequest const& request); + + virtual google::cloud::Idempotency ReportFaulty( + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + ReportFaultyRequest const& request); + + virtual google::cloud::Idempotency SetIamPolicy( + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + SetIamPolicyRequest const& request); + + virtual google::cloud::Idempotency TestIamPermissions( + google::cloud::cpp::compute::reservation_sub_blocks::v1:: + TestIamPermissionsRequest const& request); }; std::unique_ptr diff --git a/google/cloud/compute/reservation_sub_blocks/v1/reservation_sub_blocks_options.h b/google/cloud/compute/reservation_sub_blocks/v1/reservation_sub_blocks_options.h index ce227ddd0d431..ad098516fd18c 100644 --- a/google/cloud/compute/reservation_sub_blocks/v1/reservation_sub_blocks_options.h +++ b/google/cloud/compute/reservation_sub_blocks/v1/reservation_sub_blocks_options.h @@ -59,6 +59,16 @@ struct ReservationSubBlocksConnectionIdempotencyPolicyOption { using Type = std::shared_ptr; }; +/** + * Use with `google::cloud::Options` to configure the long-running operations + * polling policy. + * + * @ingroup google-cloud-compute-options + */ +struct ReservationSubBlocksPollingPolicyOption { + using Type = std::shared_ptr; +}; + /** * The options applicable to ReservationSubBlocks. * @@ -67,6 +77,7 @@ struct ReservationSubBlocksConnectionIdempotencyPolicyOption { using ReservationSubBlocksPolicyOptionList = OptionList; GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END diff --git a/google/cloud/compute/reservation_sub_blocks/v1/reservation_sub_blocks_proto_export.h b/google/cloud/compute/reservation_sub_blocks/v1/reservation_sub_blocks_proto_export.h index 182c254584614..8be6cbbaddb8b 100644 --- a/google/cloud/compute/reservation_sub_blocks/v1/reservation_sub_blocks_proto_export.h +++ b/google/cloud/compute/reservation_sub_blocks/v1/reservation_sub_blocks_proto_export.h @@ -26,7 +26,14 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RESERVATION_SUB_BLOCKS_V1_RESERVATION_SUB_BLOCKS_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include "google/cloud/compute/v1/internal/common_113.pb.h" +#include "google/cloud/compute/v1/internal/common_002.pb.h" +#include "google/cloud/compute/v1/internal/common_009.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_040.pb.h" +#include "google/cloud/compute/v1/internal/common_059.pb.h" +#include "google/cloud/compute/v1/internal/common_171.pb.h" +#include "google/cloud/compute/v1/internal/common_173.pb.h" +#include "google/cloud/compute/v1/internal/common_181.pb.h" // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RESERVATION_SUB_BLOCKS_V1_RESERVATION_SUB_BLOCKS_PROTO_EXPORT_H diff --git a/google/cloud/compute/reservation_sub_blocks/v1/samples/reservation_sub_blocks_client_samples.cc b/google/cloud/compute/reservation_sub_blocks/v1/samples/reservation_sub_blocks_client_samples.cc index fc8b4ec15b751..55fda58509c68 100644 --- a/google/cloud/compute/reservation_sub_blocks/v1/samples/reservation_sub_blocks_client_samples.cc +++ b/google/cloud/compute/reservation_sub_blocks/v1/samples/reservation_sub_blocks_client_samples.cc @@ -23,6 +23,7 @@ #include "google/cloud/common_options.h" #include "google/cloud/credentials.h" #include "google/cloud/internal/getenv.h" +#include "google/cloud/polling_policy.h" #include "google/cloud/testing_util/example_driver.h" #include "google/cloud/universe_domain.h" #include @@ -32,6 +33,7 @@ // clang-format off // main-dox-marker: compute_reservation_sub_blocks_v1::ReservationSubBlocksClient +// lro-marker: true // clang-format on namespace { @@ -138,6 +140,49 @@ void SetRetryPolicy(std::vector const& argv) { //! [set-retry-policy] } +void SetPollingPolicy(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-policy-policy"}; + } + //! [set-polling-policy] + + // The polling policy controls how the client waits for long-running + // operations. `GenericPollingPolicy<>` combines existing policies. + // In this case, keep polling until the operation completes (with success + // or error) or 45 minutes, whichever happens first. Initially pause for + // 10 seconds between polling requests, increasing the pause by a factor + // of 4 until it becomes 2 minutes. + auto options = + google::cloud::Options{} + .set( + google::cloud::GenericPollingPolicy< + google::cloud::compute_reservation_sub_blocks_v1:: + ReservationSubBlocksRetryPolicyOption::Type, + google::cloud::compute_reservation_sub_blocks_v1:: + ReservationSubBlocksBackoffPolicyOption::Type>( + google::cloud::compute_reservation_sub_blocks_v1:: + ReservationSubBlocksLimitedTimeRetryPolicy( + /*maximum_duration=*/std::chrono::minutes(45)) + .clone(), + google::cloud::ExponentialBackoffPolicy( + /*initial_delay=*/std::chrono::seconds(10), + /*maximum_delay=*/std::chrono::minutes(2), + /*scaling=*/4.0) + .clone()) + .clone()); + + auto connection = google::cloud::compute_reservation_sub_blocks_v1:: + MakeReservationSubBlocksConnectionRest(options); + + // c1 and c2 share the same polling policies. + auto c1 = google::cloud::compute_reservation_sub_blocks_v1:: + ReservationSubBlocksClient(connection); + auto c2 = google::cloud::compute_reservation_sub_blocks_v1:: + ReservationSubBlocksClient(connection); + //! [set-polling-policy] +} + void WithServiceAccount(std::vector const& argv) { if (argv.size() != 1 || argv[0] == "--help") { throw google::cloud::testing_util::Usage{"with-service-account "}; @@ -174,6 +219,9 @@ void AutoRun(std::vector const& argv) { std::cout << "\nRunning SetRetryPolicy() example" << std::endl; SetRetryPolicy({}); + std::cout << "\nRunning SetPollingPolicy() example" << std::endl; + SetPollingPolicy({}); + std::cout << "\nRunning WithServiceAccount() example" << std::endl; WithServiceAccount({keyfile}); @@ -187,6 +235,7 @@ int main(int argc, char* argv[]) { // NOLINT(bugprone-exception-escape) google::cloud::testing_util::Example example({ {"set-client-endpoint", SetClientEndpoint}, {"set-retry-policy", SetRetryPolicy}, + {"set-polling-policy", SetPollingPolicy}, {"with-service-account", WithServiceAccount}, {"set-client-universe-domain", SetClientUniverseDomain}, {"auto", AutoRun}, diff --git a/google/cloud/compute/reservations/v1/reservations_client.h b/google/cloud/compute/reservations/v1/reservations_client.h index 19187713543cc..20017504f47ae 100644 --- a/google/cloud/compute/reservations/v1/reservations_client.h +++ b/google/cloud/compute/reservations/v1/reservations_client.h @@ -90,8 +90,10 @@ class ReservationsClient { // clang-format off /// - /// Retrieves an aggregated list of reservations. To prevent failure, Google - /// recommends that you set the `returnPartialSuccess` parameter to `true`. + /// Retrieves an aggregated list of reservations. + /// + /// To prevent failure, it is recommended that you set the + /// `returnPartialSuccess` parameter to `true`. /// https://cloud.google.com/compute/docs/reference/rest/v1/reservations/aggregatedList /// /// @param project Project ID for this request. @@ -117,8 +119,8 @@ class ReservationsClient { /// [`future`]: @ref google::cloud::future /// [`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#L177} - /// [google.cloud.cpp.compute.v1.ReservationsScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_111.proto#L265} + /// [google.cloud.cpp.compute.reservations.v1.AggregatedListReservationsRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservations/v1/reservations.proto#L180} + /// [google.cloud.cpp.compute.v1.ReservationsScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_131.proto#L308} /// // clang-format on StreamRange> @@ -250,7 +254,7 @@ class ReservationsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.reservations.v1.DeleteReservationRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservations/v1/reservations.proto#L259} + /// [google.cloud.cpp.compute.reservations.v1.DeleteReservationRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservations/v1/reservations.proto#L295} /// // clang-format on future> @@ -309,8 +313,8 @@ class ReservationsClient { /// [`future`]: @ref google::cloud::future /// [`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#L310} - /// [google.cloud.cpp.compute.v1.Reservation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_006.proto#L177} + /// [google.cloud.cpp.compute.reservations.v1.GetReservationRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservations/v1/reservations.proto#L349} + /// [google.cloud.cpp.compute.v1.Reservation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L120} /// // clang-format on StatusOr GetReservation( @@ -341,8 +345,8 @@ class ReservationsClient { /// [`future`]: @ref google::cloud::future /// [`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#L310} - /// [google.cloud.cpp.compute.v1.Reservation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_006.proto#L177} + /// [google.cloud.cpp.compute.reservations.v1.GetReservationRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservations/v1/reservations.proto#L349} + /// [google.cloud.cpp.compute.v1.Reservation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L120} /// // clang-format on StatusOr GetReservation( @@ -372,8 +376,8 @@ class ReservationsClient { /// [`future`]: @ref google::cloud::future /// [`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#L292} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} + /// [google.cloud.cpp.compute.reservations.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservations/v1/reservations.proto#L331} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr GetIamPolicy( @@ -405,8 +409,8 @@ class ReservationsClient { /// [`future`]: @ref google::cloud::future /// [`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#L292} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} + /// [google.cloud.cpp.compute.reservations.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservations/v1/reservations.proto#L331} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr GetIamPolicy( @@ -416,7 +420,7 @@ class ReservationsClient { // clang-format off /// - /// Creates a new reservation. For more information, read Reserving zonal + /// Creates a new reservation. For more information, readReserving zonal /// resources. /// https://cloud.google.com/compute/docs/reference/rest/v1/reservations/insert /// @@ -443,7 +447,7 @@ class ReservationsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.reservations.v1.InsertReservationRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservations/v1/reservations.proto#L324} + /// [google.cloud.cpp.compute.reservations.v1.InsertReservationRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservations/v1/reservations.proto#L363} /// // clang-format on future> @@ -470,7 +474,7 @@ class ReservationsClient { // clang-format off /// - /// Creates a new reservation. For more information, read Reserving zonal + /// Creates a new reservation. For more information, readReserving zonal /// resources. /// https://cloud.google.com/compute/docs/reference/rest/v1/reservations/insert /// @@ -500,7 +504,7 @@ class ReservationsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.reservations.v1.InsertReservationRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservations/v1/reservations.proto#L324} + /// [google.cloud.cpp.compute.reservations.v1.InsertReservationRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservations/v1/reservations.proto#L363} /// // clang-format on future> @@ -540,8 +544,8 @@ class ReservationsClient { // clang-format off /// - /// A list of all the reservations that have been configured for the specified - /// project in specified zone. + /// A list of all the reservations that have been configured for the + /// specified project in specified zone. /// https://cloud.google.com/compute/docs/reference/rest/v1/reservations/list /// /// @param project Project ID for this request. @@ -568,8 +572,8 @@ class ReservationsClient { /// [`future`]: @ref google::cloud::future /// [`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#L357} - /// [google.cloud.cpp.compute.v1.Reservation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_006.proto#L177} + /// [google.cloud.cpp.compute.reservations.v1.ListReservationsRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservations/v1/reservations.proto#L399} + /// [google.cloud.cpp.compute.v1.Reservation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L120} /// // clang-format on StreamRange ListReservations( @@ -577,8 +581,8 @@ class ReservationsClient { // clang-format off /// - /// A list of all the reservations that have been configured for the specified - /// project in specified zone. + /// A list of all the reservations that have been configured for the + /// specified project in specified zone. /// https://cloud.google.com/compute/docs/reference/rest/v1/reservations/list /// /// @param request Unary RPCs, such as the one wrapped by this @@ -609,8 +613,8 @@ class ReservationsClient { /// [`future`]: @ref google::cloud::future /// [`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#L357} - /// [google.cloud.cpp.compute.v1.Reservation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_006.proto#L177} + /// [google.cloud.cpp.compute.reservations.v1.ListReservationsRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservations/v1/reservations.proto#L399} + /// [google.cloud.cpp.compute.v1.Reservation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L120} /// // clang-format on StreamRange ListReservations( @@ -625,8 +629,8 @@ class ReservationsClient { /// /// @param project Project ID for this request. /// @param zone Name of the zone for this request. Zone name should conform to RFC1035. - /// @param reservation The name of the reservation. Name should conform to RFC1035 or be a - /// resource ID. + /// @param reservation The name of the reservation. + /// Name should conform to RFC1035 or be a resource ID. /// @param reservations_perform_maintenance_request_resource The ReservationsPerformMaintenanceRequest for this request. /// @param opts Optional. Override the class-level options, such as retry and /// backoff policies. @@ -648,7 +652,7 @@ class ReservationsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.reservations.v1.PerformMaintenanceRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservations/v1/reservations.proto#L428} + /// [google.cloud.cpp.compute.reservations.v1.PerformMaintenanceRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservations/v1/reservations.proto#L503} /// // clang-format on future> @@ -709,7 +713,7 @@ class ReservationsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.reservations.v1.PerformMaintenanceRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservations/v1/reservations.proto#L428} + /// [google.cloud.cpp.compute.reservations.v1.PerformMaintenanceRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservations/v1/reservations.proto#L503} /// // clang-format on future> @@ -751,7 +755,8 @@ class ReservationsClient { // clang-format off /// /// Resizes the reservation (applicable to standalone reservations only). For - /// more information, read Modifying reservations. + /// more information, readModifying + /// reservations. /// https://cloud.google.com/compute/docs/reference/rest/v1/reservations/resize /// /// @param project Project ID for this request. @@ -778,7 +783,7 @@ class ReservationsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.reservations.v1.ResizeRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservations/v1/reservations.proto#L467} + /// [google.cloud.cpp.compute.reservations.v1.ResizeRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservations/v1/reservations.proto#L545} /// // clang-format on future> Resize( @@ -809,7 +814,8 @@ class ReservationsClient { // clang-format off /// /// Resizes the reservation (applicable to standalone reservations only). For - /// more information, read Modifying reservations. + /// more information, readModifying + /// reservations. /// https://cloud.google.com/compute/docs/reference/rest/v1/reservations/resize /// /// @param request Unary RPCs, such as the one wrapped by this @@ -838,7 +844,7 @@ class ReservationsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.reservations.v1.ResizeRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservations/v1/reservations.proto#L467} + /// [google.cloud.cpp.compute.reservations.v1.ResizeRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservations/v1/reservations.proto#L545} /// // clang-format on future> Resize( @@ -878,8 +884,8 @@ class ReservationsClient { // clang-format off /// - /// Sets the access control policy on the specified resource. Replaces any - /// existing policy. + /// Sets the access control policy on the specified resource. + /// Replaces any existing policy. /// https://cloud.google.com/compute/docs/reference/rest/v1/reservations/setIamPolicy /// /// @param project Project ID for this request. @@ -899,8 +905,8 @@ class ReservationsClient { /// [`future`]: @ref google::cloud::future /// [`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#L505} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} + /// [google.cloud.cpp.compute.reservations.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservations/v1/reservations.proto#L586} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr SetIamPolicy( @@ -912,8 +918,8 @@ class ReservationsClient { // clang-format off /// - /// Sets the access control policy on the specified resource. Replaces any - /// existing policy. + /// Sets the access control policy on the specified resource. + /// Replaces any existing policy. /// https://cloud.google.com/compute/docs/reference/rest/v1/reservations/setIamPolicy /// /// @param request Unary RPCs, such as the one wrapped by this @@ -935,8 +941,8 @@ class ReservationsClient { /// [`future`]: @ref google::cloud::future /// [`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#L505} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} + /// [google.cloud.cpp.compute.reservations.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservations/v1/reservations.proto#L586} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr SetIamPolicy( @@ -966,8 +972,8 @@ class ReservationsClient { /// [`future`]: @ref google::cloud::future /// [`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#L523} - /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_145.proto#L30} + /// [google.cloud.cpp.compute.reservations.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservations/v1/reservations.proto#L604} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} /// // clang-format on StatusOr @@ -1002,8 +1008,8 @@ class ReservationsClient { /// [`future`]: @ref google::cloud::future /// [`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#L523} - /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_145.proto#L30} + /// [google.cloud.cpp.compute.reservations.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservations/v1/reservations.proto#L604} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} /// // clang-format on StatusOr @@ -1041,7 +1047,7 @@ class ReservationsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.reservations.v1.UpdateReservationRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservations/v1/reservations.proto#L541} + /// [google.cloud.cpp.compute.reservations.v1.UpdateReservationRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservations/v1/reservations.proto#L622} /// // clang-format on future> @@ -1099,7 +1105,7 @@ class ReservationsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.reservations.v1.UpdateReservationRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservations/v1/reservations.proto#L541} + /// [google.cloud.cpp.compute.reservations.v1.UpdateReservationRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservations/v1/reservations.proto#L622} /// // clang-format on future> diff --git a/google/cloud/compute/reservations/v1/reservations_proto_export.h b/google/cloud/compute/reservations/v1/reservations_proto_export.h index 62ac023a86131..f06252df7d757 100644 --- a/google/cloud/compute/reservations/v1/reservations_proto_export.h +++ b/google/cloud/compute/reservations/v1/reservations_proto_export.h @@ -27,17 +27,19 @@ // IWYU pragma: begin_exports #include "google/cloud/compute/v1/internal/common_001.pb.h" -#include "google/cloud/compute/v1/internal/common_006.pb.h" #include "google/cloud/compute/v1/internal/common_007.pb.h" -#include "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_029.pb.h" -#include "google/cloud/compute/v1/internal/common_031.pb.h" -#include "google/cloud/compute/v1/internal/common_048.pb.h" -#include "google/cloud/compute/v1/internal/common_111.pb.h" -#include "google/cloud/compute/v1/internal/common_120.pb.h" -#include "google/cloud/compute/v1/internal/common_145.pb.h" -#include "google/cloud/compute/v1/internal/common_146.pb.h" -#include "google/cloud/compute/v1/internal/common_152.pb.h" +#include "google/cloud/compute/v1/internal/common_008.pb.h" +#include "google/cloud/compute/v1/internal/common_009.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_038.pb.h" +#include "google/cloud/compute/v1/internal/common_040.pb.h" +#include "google/cloud/compute/v1/internal/common_059.pb.h" +#include "google/cloud/compute/v1/internal/common_131.pb.h" +#include "google/cloud/compute/v1/internal/common_134.pb.h" +#include "google/cloud/compute/v1/internal/common_144.pb.h" +#include "google/cloud/compute/v1/internal/common_171.pb.h" +#include "google/cloud/compute/v1/internal/common_173.pb.h" +#include "google/cloud/compute/v1/internal/common_182.pb.h" // 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 99983becc615a..e232b2c722431 100644 --- a/google/cloud/compute/resource_policies/v1/resource_policies_client.h +++ b/google/cloud/compute/resource_policies/v1/resource_policies_client.h @@ -91,9 +91,10 @@ class ResourcePoliciesClient { // clang-format off /// - /// Retrieves an aggregated list of resource policies. To prevent failure, - /// Google recommends that you set the `returnPartialSuccess` parameter to - /// `true`. + /// Retrieves an aggregated list of resource policies. + /// + /// To prevent failure, Google recommends that you set the + /// `returnPartialSuccess` parameter to `true`. /// https://cloud.google.com/compute/docs/reference/rest/v1/resourcePolicies/aggregatedList /// /// @param project Project ID for this request. @@ -119,8 +120,8 @@ class ResourcePoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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_114.proto#L24} + /// [google.cloud.cpp.compute.resource_policies.v1.AggregatedListResourcePoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/resource_policies/v1/resource_policies.proto#L152} + /// [google.cloud.cpp.compute.v1.ResourcePoliciesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_135.proto#L24} /// // clang-format on StreamRange> @@ -254,7 +256,7 @@ class ResourcePoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.resource_policies.v1.DeleteResourcePolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/resource_policies/v1/resource_policies.proto#L233} + /// [google.cloud.cpp.compute.resource_policies.v1.DeleteResourcePolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/resource_policies/v1/resource_policies.proto#L267} /// // clang-format on future> @@ -314,8 +316,8 @@ class ResourcePoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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_114.proto#L120} + /// [google.cloud.cpp.compute.resource_policies.v1.GetResourcePolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/resource_policies/v1/resource_policies.proto#L322} + /// [google.cloud.cpp.compute.v1.ResourcePolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_135.proto#L141} /// // clang-format on StatusOr GetResourcePolicy( @@ -346,8 +348,8 @@ class ResourcePoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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_114.proto#L120} + /// [google.cloud.cpp.compute.resource_policies.v1.GetResourcePolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/resource_policies/v1/resource_policies.proto#L322} + /// [google.cloud.cpp.compute.v1.ResourcePolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_135.proto#L141} /// // clang-format on StatusOr GetResourcePolicy( @@ -377,8 +379,8 @@ class ResourcePoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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_007.proto#L178} + /// [google.cloud.cpp.compute.resource_policies.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/resource_policies/v1/resource_policies.proto#L303} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr GetIamPolicy( @@ -410,8 +412,8 @@ class ResourcePoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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_007.proto#L178} + /// [google.cloud.cpp.compute.resource_policies.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/resource_policies/v1/resource_policies.proto#L303} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr GetIamPolicy( @@ -447,7 +449,7 @@ class ResourcePoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.resource_policies.v1.InsertResourcePolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/resource_policies/v1/resource_policies.proto#L300} + /// [google.cloud.cpp.compute.resource_policies.v1.InsertResourcePolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/resource_policies/v1/resource_policies.proto#L337} /// // clang-format on future> @@ -504,7 +506,7 @@ class ResourcePoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.resource_policies.v1.InsertResourcePolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/resource_policies/v1/resource_policies.proto#L300} + /// [google.cloud.cpp.compute.resource_policies.v1.InsertResourcePolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/resource_policies/v1/resource_policies.proto#L337} /// // clang-format on future> @@ -573,8 +575,8 @@ class ResourcePoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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_114.proto#L120} + /// [google.cloud.cpp.compute.resource_policies.v1.ListResourcePoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/resource_policies/v1/resource_policies.proto#L373} + /// [google.cloud.cpp.compute.v1.ResourcePolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_135.proto#L141} /// // clang-format on StreamRange @@ -615,8 +617,8 @@ class ResourcePoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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_114.proto#L120} + /// [google.cloud.cpp.compute.resource_policies.v1.ListResourcePoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/resource_policies/v1/resource_policies.proto#L373} + /// [google.cloud.cpp.compute.v1.ResourcePolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_135.proto#L141} /// // clang-format on StreamRange @@ -654,7 +656,7 @@ class ResourcePoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.resource_policies.v1.PatchResourcePolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/resource_policies/v1/resource_policies.proto#L405} + /// [google.cloud.cpp.compute.resource_policies.v1.PatchResourcePolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/resource_policies/v1/resource_policies.proto#L478} /// // clang-format on future> @@ -714,7 +716,7 @@ class ResourcePoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.resource_policies.v1.PatchResourcePolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/resource_policies/v1/resource_policies.proto#L405} + /// [google.cloud.cpp.compute.resource_policies.v1.PatchResourcePolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/resource_policies/v1/resource_policies.proto#L478} /// // clang-format on future> @@ -755,8 +757,8 @@ class ResourcePoliciesClient { // clang-format off /// - /// Sets the access control policy on the specified resource. Replaces any - /// existing policy. + /// Sets the access control policy on the specified resource. + /// Replaces any existing policy. /// https://cloud.google.com/compute/docs/reference/rest/v1/resourcePolicies/setIamPolicy /// /// @param project Project ID for this request. @@ -776,8 +778,8 @@ class ResourcePoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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_007.proto#L178} + /// [google.cloud.cpp.compute.resource_policies.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/resource_policies/v1/resource_policies.proto#L521} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr SetIamPolicy( @@ -789,8 +791,8 @@ class ResourcePoliciesClient { // clang-format off /// - /// Sets the access control policy on the specified resource. Replaces any - /// existing policy. + /// Sets the access control policy on the specified resource. + /// Replaces any existing policy. /// https://cloud.google.com/compute/docs/reference/rest/v1/resourcePolicies/setIamPolicy /// /// @param request Unary RPCs, such as the one wrapped by this @@ -812,8 +814,8 @@ class ResourcePoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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_007.proto#L178} + /// [google.cloud.cpp.compute.resource_policies.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/resource_policies/v1/resource_policies.proto#L521} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr SetIamPolicy( @@ -843,8 +845,8 @@ class ResourcePoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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_145.proto#L30} + /// [google.cloud.cpp.compute.resource_policies.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/resource_policies/v1/resource_policies.proto#L541} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} /// // clang-format on StatusOr @@ -879,8 +881,8 @@ class ResourcePoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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_145.proto#L30} + /// [google.cloud.cpp.compute.resource_policies.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/resource_policies/v1/resource_policies.proto#L541} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.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 1863bee555dcf..201ad9b9f0a30 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 "google/cloud/compute/v1/internal/common_007.pb.h" -#include "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_031.pb.h" -#include "google/cloud/compute/v1/internal/common_108.pb.h" -#include "google/cloud/compute/v1/internal/common_114.pb.h" -#include "google/cloud/compute/v1/internal/common_145.pb.h" +#include "google/cloud/compute/v1/internal/common_009.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_040.pb.h" +#include "google/cloud/compute/v1/internal/common_126.pb.h" +#include "google/cloud/compute/v1/internal/common_135.pb.h" +#include "google/cloud/compute/v1/internal/common_171.pb.h" // 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/rollout_plans/v1/internal/rollout_plans_option_defaults.cc b/google/cloud/compute/rollout_plans/v1/internal/rollout_plans_option_defaults.cc new file mode 100644 index 0000000000000..26946ecf342fc --- /dev/null +++ b/google/cloud/compute/rollout_plans/v1/internal/rollout_plans_option_defaults.cc @@ -0,0 +1,83 @@ +// Copyright 2026 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. +// source: google/cloud/compute/rollout_plans/v1/rollout_plans.proto + +#include "google/cloud/compute/rollout_plans/v1/internal/rollout_plans_option_defaults.h" +#include "google/cloud/compute/rollout_plans/v1/rollout_plans_connection.h" +#include "google/cloud/compute/rollout_plans/v1/rollout_plans_options.h" +#include "google/cloud/internal/populate_common_options.h" +#include "google/cloud/internal/populate_grpc_options.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_rollout_plans_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +namespace { +auto constexpr kBackoffScaling = 2.0; +} // namespace + +Options RolloutPlansDefaultOptions(Options options) { + options = internal::PopulateCommonOptions( + std::move(options), "GOOGLE_CLOUD_CPP_ROLLOUT_PLANS_ENDPOINT", "", + "GOOGLE_CLOUD_CPP_ROLLOUT_PLANS_AUTHORITY", "compute.googleapis.com"); + options = internal::PopulateGrpcOptions(std::move(options)); + if (!options.has()) { + options.set( + compute_rollout_plans_v1::RolloutPlansLimitedTimeRetryPolicy( + std::chrono::minutes(10)) + .clone()); + } + if (!options + .has()) { + options.set( + ExponentialBackoffPolicy( + std::chrono::seconds(0), std::chrono::seconds(1), + std::chrono::minutes(5), kBackoffScaling, kBackoffScaling) + .clone()); + } + if (!options + .has()) { + options.set( + GenericPollingPolicy< + compute_rollout_plans_v1::RolloutPlansRetryPolicyOption::Type, + compute_rollout_plans_v1::RolloutPlansBackoffPolicyOption::Type>( + options + .get() + ->clone(), + ExponentialBackoffPolicy(std::chrono::seconds(1), + std::chrono::minutes(5), kBackoffScaling) + .clone()) + .clone()); + } + if (!options.has()) { + options.set( + compute_rollout_plans_v1:: + MakeDefaultRolloutPlansConnectionIdempotencyPolicy()); + } + + return options; +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_rollout_plans_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/rollout_plans/v1/internal/rollout_plans_option_defaults.h b/google/cloud/compute/rollout_plans/v1/internal/rollout_plans_option_defaults.h new file mode 100644 index 0000000000000..8155ef202ffcc --- /dev/null +++ b/google/cloud/compute/rollout_plans/v1/internal/rollout_plans_option_defaults.h @@ -0,0 +1,37 @@ +// Copyright 2026 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. +// source: google/cloud/compute/rollout_plans/v1/rollout_plans.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUT_PLANS_V1_INTERNAL_ROLLOUT_PLANS_OPTION_DEFAULTS_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUT_PLANS_V1_INTERNAL_ROLLOUT_PLANS_OPTION_DEFAULTS_H + +#include "google/cloud/options.h" +#include "google/cloud/version.h" + +namespace google { +namespace cloud { +namespace compute_rollout_plans_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +Options RolloutPlansDefaultOptions(Options options); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_rollout_plans_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUT_PLANS_V1_INTERNAL_ROLLOUT_PLANS_OPTION_DEFAULTS_H diff --git a/google/cloud/compute/rollout_plans/v1/internal/rollout_plans_rest_connection_impl.cc b/google/cloud/compute/rollout_plans/v1/internal/rollout_plans_rest_connection_impl.cc new file mode 100644 index 0000000000000..35cd2568a4e37 --- /dev/null +++ b/google/cloud/compute/rollout_plans/v1/internal/rollout_plans_rest_connection_impl.cc @@ -0,0 +1,357 @@ +// Copyright 2026 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. +// source: google/cloud/compute/rollout_plans/v1/rollout_plans.proto + +#include "google/cloud/compute/rollout_plans/v1/internal/rollout_plans_rest_connection_impl.h" +#include "google/cloud/compute/rollout_plans/v1/internal/rollout_plans_rest_stub_factory.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/internal/async_rest_long_running_operation_custom.h" +#include "google/cloud/internal/extract_long_running_result.h" +#include "google/cloud/internal/pagination_range.h" +#include "google/cloud/internal/rest_lro_helpers.h" +#include "google/cloud/internal/rest_retry_loop.h" +#include "google/cloud/rest_options.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_rollout_plans_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +RolloutPlansRestConnectionImpl::RolloutPlansRestConnectionImpl( + std::unique_ptr background, + std::shared_ptr + stub, + Options options) + : background_(std::move(background)), + stub_(std::move(stub)), + options_(internal::MergeOptions(std::move(options), + RolloutPlansConnection::options())) {} + +future> +RolloutPlansRestConnectionImpl::DeleteRolloutPlan( + google::cloud::cpp::compute::rollout_plans::v1:: + DeleteRolloutPlanRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::global_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, request, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::rollout_plans::v1:: + DeleteRolloutPlanRequest const& request) { + return stub->AsyncDeleteRolloutPlan(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->DeleteRolloutPlan(request), + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [request](std::string const& op, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest& r) { + r.set_project(request.project()); + r.set_operation(op); + }, + [request](std::string const& op, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest& r) { + r.set_project(request.project()); + r.set_operation(op); + }); +} + +StatusOr +RolloutPlansRestConnectionImpl::DeleteRolloutPlan( + NoAwaitTag, google::cloud::cpp::compute::rollout_plans::v1:: + DeleteRolloutPlanRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->DeleteRolloutPlan(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::rollout_plans::v1:: + DeleteRolloutPlanRequest const& request) { + return stub_->DeleteRolloutPlan(rest_context, options, request); + }, + *current, request, __func__); +} + +future> +RolloutPlansRestConnectionImpl::DeleteRolloutPlan( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestAwaitLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::global_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, operation, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [operation](std::string const&, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_operation(info.operation); + }, + [operation](std::string const&, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_operation(info.operation); + }); +} + +StatusOr +RolloutPlansRestConnectionImpl::GetRolloutPlan( + google::cloud::cpp::compute::rollout_plans::v1::GetRolloutPlanRequest const& + request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->GetRolloutPlan(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::rollout_plans::v1:: + GetRolloutPlanRequest const& request) { + return stub_->GetRolloutPlan(rest_context, options, request); + }, + *current, request, __func__); +} + +future> +RolloutPlansRestConnectionImpl::InsertRolloutPlan( + google::cloud::cpp::compute::rollout_plans::v1:: + InsertRolloutPlanRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::global_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, request, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::rollout_plans::v1:: + InsertRolloutPlanRequest const& request) { + return stub->AsyncInsertRolloutPlan(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->InsertRolloutPlan(request), + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [request](std::string const& op, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest& r) { + r.set_project(request.project()); + r.set_operation(op); + }, + [request](std::string const& op, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest& r) { + r.set_project(request.project()); + r.set_operation(op); + }); +} + +StatusOr +RolloutPlansRestConnectionImpl::InsertRolloutPlan( + NoAwaitTag, google::cloud::cpp::compute::rollout_plans::v1:: + InsertRolloutPlanRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->InsertRolloutPlan(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::rollout_plans::v1:: + InsertRolloutPlanRequest const& request) { + return stub_->InsertRolloutPlan(rest_context, options, request); + }, + *current, request, __func__); +} + +future> +RolloutPlansRestConnectionImpl::InsertRolloutPlan( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestAwaitLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::global_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, operation, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [operation](std::string const&, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_operation(info.operation); + }, + [operation](std::string const&, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_operation(info.operation); + }); +} + +StreamRange +RolloutPlansRestConnectionImpl::ListRolloutPlans( + google::cloud::cpp::compute::rollout_plans::v1::ListRolloutPlansRequest + request) { + request.clear_page_token(); + auto current = google::cloud::internal::SaveCurrentOptions(); + auto idempotency = idempotency_policy(*current)->ListRolloutPlans(request); + char const* function_name = __func__; + return google::cloud::internal::MakePaginationRange< + StreamRange>( + current, std::move(request), + [idempotency, function_name, stub = stub_, + retry = + std::shared_ptr( + retry_policy(*current)), + backoff = std::shared_ptr(backoff_policy(*current))]( + Options const& options, google::cloud::cpp::compute::rollout_plans:: + v1::ListRolloutPlansRequest const& r) { + return google::cloud::rest_internal::RestRetryLoop( + retry->clone(), backoff->clone(), idempotency, + [stub](rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::rollout_plans::v1:: + ListRolloutPlansRequest const& request) { + return stub->ListRolloutPlans(rest_context, options, request); + }, + options, r, function_name); + }, + [](google::cloud::cpp::compute::v1::RolloutPlansListResponse r) { + std::vector result( + r.items().size()); + auto& messages = *r.mutable_items(); + std::move(messages.begin(), messages.end(), result.begin()); + return result; + }); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_rollout_plans_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/rollout_plans/v1/internal/rollout_plans_rest_connection_impl.h b/google/cloud/compute/rollout_plans/v1/internal/rollout_plans_rest_connection_impl.h new file mode 100644 index 0000000000000..f1912dabb247b --- /dev/null +++ b/google/cloud/compute/rollout_plans/v1/internal/rollout_plans_rest_connection_impl.h @@ -0,0 +1,126 @@ +// Copyright 2026 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. +// source: google/cloud/compute/rollout_plans/v1/rollout_plans.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUT_PLANS_V1_INTERNAL_ROLLOUT_PLANS_REST_CONNECTION_IMPL_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUT_PLANS_V1_INTERNAL_ROLLOUT_PLANS_REST_CONNECTION_IMPL_H + +#include "google/cloud/compute/global_operations/v1/global_operations.pb.h" +#include "google/cloud/compute/rollout_plans/v1/internal/rollout_plans_rest_stub.h" +#include "google/cloud/compute/rollout_plans/v1/internal/rollout_plans_retry_traits.h" +#include "google/cloud/compute/rollout_plans/v1/rollout_plans_connection.h" +#include "google/cloud/compute/rollout_plans/v1/rollout_plans_connection_idempotency_policy.h" +#include "google/cloud/compute/rollout_plans/v1/rollout_plans_options.h" +#include "google/cloud/background_threads.h" +#include "google/cloud/backoff_policy.h" +#include "google/cloud/options.h" +#include "google/cloud/status_or.h" +#include "google/cloud/stream_range.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_rollout_plans_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class RolloutPlansRestConnectionImpl + : public compute_rollout_plans_v1::RolloutPlansConnection { + public: + ~RolloutPlansRestConnectionImpl() override = default; + + RolloutPlansRestConnectionImpl( + std::unique_ptr background, + std::shared_ptr + stub, + Options options); + + Options options() override { return options_; } + + future> + DeleteRolloutPlan(google::cloud::cpp::compute::rollout_plans::v1:: + DeleteRolloutPlanRequest const& request) override; + + StatusOr DeleteRolloutPlan( + NoAwaitTag, google::cloud::cpp::compute::rollout_plans::v1:: + DeleteRolloutPlanRequest const& request) override; + + future> + DeleteRolloutPlan( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + StatusOr GetRolloutPlan( + google::cloud::cpp::compute::rollout_plans::v1:: + GetRolloutPlanRequest const& request) override; + + future> + InsertRolloutPlan(google::cloud::cpp::compute::rollout_plans::v1:: + InsertRolloutPlanRequest const& request) override; + + StatusOr InsertRolloutPlan( + NoAwaitTag, google::cloud::cpp::compute::rollout_plans::v1:: + InsertRolloutPlanRequest const& request) override; + + future> + InsertRolloutPlan( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + StreamRange ListRolloutPlans( + google::cloud::cpp::compute::rollout_plans::v1::ListRolloutPlansRequest + request) override; + + private: + static std::unique_ptr + retry_policy(Options const& options) { + return options + .get() + ->clone(); + } + + static std::unique_ptr backoff_policy(Options const& options) { + return options + .get() + ->clone(); + } + + static std::unique_ptr< + compute_rollout_plans_v1::RolloutPlansConnectionIdempotencyPolicy> + idempotency_policy(Options const& options) { + return options + .get() + ->clone(); + } + + static std::unique_ptr polling_policy(Options const& options) { + return options + .get() + ->clone(); + } + + std::unique_ptr background_; + std::shared_ptr + stub_; + Options options_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_rollout_plans_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUT_PLANS_V1_INTERNAL_ROLLOUT_PLANS_REST_CONNECTION_IMPL_H diff --git a/google/cloud/compute/rollout_plans/v1/internal/rollout_plans_rest_logging_decorator.cc b/google/cloud/compute/rollout_plans/v1/internal/rollout_plans_rest_logging_decorator.cc new file mode 100644 index 0000000000000..e7bbab396fc1b --- /dev/null +++ b/google/cloud/compute/rollout_plans/v1/internal/rollout_plans_rest_logging_decorator.cc @@ -0,0 +1,175 @@ +// Copyright 2026 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. +// source: google/cloud/compute/rollout_plans/v1/rollout_plans.proto + +#include "google/cloud/compute/rollout_plans/v1/internal/rollout_plans_rest_logging_decorator.h" +#include "google/cloud/internal/log_wrapper.h" +#include "google/cloud/status_or.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_rollout_plans_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +RolloutPlansRestLogging::RolloutPlansRestLogging( + std::shared_ptr child, TracingOptions tracing_options, + std::set components) + : child_(std::move(child)), + tracing_options_(std::move(tracing_options)), + components_(std::move(components)) {} + +future> +RolloutPlansRestLogging::AsyncDeleteRolloutPlan( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::rollout_plans::v1:: + DeleteRolloutPlanRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::rollout_plans::v1:: + DeleteRolloutPlanRequest const& request) { + return child_->AsyncDeleteRolloutPlan(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +StatusOr +RolloutPlansRestLogging::DeleteRolloutPlan( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::rollout_plans::v1:: + DeleteRolloutPlanRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::rollout_plans::v1:: + DeleteRolloutPlanRequest const& request) { + return child_->DeleteRolloutPlan(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +StatusOr +RolloutPlansRestLogging::GetRolloutPlan( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::rollout_plans::v1::GetRolloutPlanRequest const& + request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::rollout_plans::v1:: + GetRolloutPlanRequest const& request) { + return child_->GetRolloutPlan(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +future> +RolloutPlansRestLogging::AsyncInsertRolloutPlan( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::rollout_plans::v1:: + InsertRolloutPlanRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::rollout_plans::v1:: + InsertRolloutPlanRequest const& request) { + return child_->AsyncInsertRolloutPlan(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +StatusOr +RolloutPlansRestLogging::InsertRolloutPlan( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::rollout_plans::v1:: + InsertRolloutPlanRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::rollout_plans::v1:: + InsertRolloutPlanRequest const& request) { + return child_->InsertRolloutPlan(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +StatusOr +RolloutPlansRestLogging::ListRolloutPlans( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::rollout_plans::v1:: + ListRolloutPlansRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::rollout_plans::v1:: + ListRolloutPlansRequest const& request) { + return child_->ListRolloutPlans(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +future> +RolloutPlansRestLogging::AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) { + return child_->AsyncGetOperation(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +future RolloutPlansRestLogging::AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) { + return child_->AsyncCancelOperation(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_rollout_plans_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/rollout_plans/v1/internal/rollout_plans_rest_logging_decorator.h b/google/cloud/compute/rollout_plans/v1/internal/rollout_plans_rest_logging_decorator.h new file mode 100644 index 0000000000000..c12f7c387e466 --- /dev/null +++ b/google/cloud/compute/rollout_plans/v1/internal/rollout_plans_rest_logging_decorator.h @@ -0,0 +1,111 @@ +// Copyright 2026 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. +// source: google/cloud/compute/rollout_plans/v1/rollout_plans.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUT_PLANS_V1_INTERNAL_ROLLOUT_PLANS_REST_LOGGING_DECORATOR_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUT_PLANS_V1_INTERNAL_ROLLOUT_PLANS_REST_LOGGING_DECORATOR_H + +#include "google/cloud/compute/global_operations/v1/global_operations.pb.h" +#include "google/cloud/compute/rollout_plans/v1/internal/rollout_plans_rest_stub.h" +#include "google/cloud/compute/rollout_plans/v1/rollout_plans.pb.h" +#include "google/cloud/future.h" +#include "google/cloud/internal/rest_context.h" +#include "google/cloud/tracing_options.h" +#include "google/cloud/version.h" +#include +#include +#include + +namespace google { +namespace cloud { +namespace compute_rollout_plans_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class RolloutPlansRestLogging : public RolloutPlansRestStub { + public: + ~RolloutPlansRestLogging() override = default; + RolloutPlansRestLogging(std::shared_ptr child, + TracingOptions tracing_options, + std::set components); + + future> + AsyncDeleteRolloutPlan( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::rollout_plans::v1:: + DeleteRolloutPlanRequest const& request) override; + + StatusOr DeleteRolloutPlan( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::rollout_plans::v1:: + DeleteRolloutPlanRequest const& request) override; + + StatusOr GetRolloutPlan( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::rollout_plans::v1:: + GetRolloutPlanRequest const& request) override; + + future> + AsyncInsertRolloutPlan( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::rollout_plans::v1:: + InsertRolloutPlanRequest const& request) override; + + StatusOr InsertRolloutPlan( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::rollout_plans::v1:: + InsertRolloutPlanRequest const& request) override; + + StatusOr + ListRolloutPlans(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::rollout_plans::v1:: + ListRolloutPlansRequest const& request) override; + + future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) override; + + future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) override; + + private: + std::shared_ptr child_; + TracingOptions tracing_options_; + std::set components_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_rollout_plans_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUT_PLANS_V1_INTERNAL_ROLLOUT_PLANS_REST_LOGGING_DECORATOR_H diff --git a/google/cloud/compute/rollout_plans/v1/internal/rollout_plans_rest_metadata_decorator.cc b/google/cloud/compute/rollout_plans/v1/internal/rollout_plans_rest_metadata_decorator.cc new file mode 100644 index 0000000000000..52b75b1be1d45 --- /dev/null +++ b/google/cloud/compute/rollout_plans/v1/internal/rollout_plans_rest_metadata_decorator.cc @@ -0,0 +1,134 @@ +// Copyright 2026 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. +// source: google/cloud/compute/rollout_plans/v1/rollout_plans.proto + +#include "google/cloud/compute/rollout_plans/v1/internal/rollout_plans_rest_metadata_decorator.h" +#include "google/cloud/internal/api_client_header.h" +#include "google/cloud/internal/rest_set_metadata.h" +#include "google/cloud/status_or.h" +#include "absl/strings/str_cat.h" +#include "absl/strings/str_format.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_rollout_plans_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +RolloutPlansRestMetadata::RolloutPlansRestMetadata( + std::shared_ptr child, std::string api_client_header) + : child_(std::move(child)), + api_client_header_( + api_client_header.empty() + ? google::cloud::internal::GeneratedLibClientHeader() + : std::move(api_client_header)) {} + +future> +RolloutPlansRestMetadata::AsyncDeleteRolloutPlan( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::rollout_plans::v1:: + DeleteRolloutPlanRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncDeleteRolloutPlan(cq, std::move(rest_context), + std::move(options), request); +} + +StatusOr +RolloutPlansRestMetadata::DeleteRolloutPlan( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::rollout_plans::v1:: + DeleteRolloutPlanRequest const& request) { + SetMetadata(rest_context, options); + return child_->DeleteRolloutPlan(rest_context, options, request); +} + +StatusOr +RolloutPlansRestMetadata::GetRolloutPlan( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::rollout_plans::v1::GetRolloutPlanRequest const& + request) { + SetMetadata(rest_context, options); + return child_->GetRolloutPlan(rest_context, options, request); +} + +future> +RolloutPlansRestMetadata::AsyncInsertRolloutPlan( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::rollout_plans::v1:: + InsertRolloutPlanRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncInsertRolloutPlan(cq, std::move(rest_context), + std::move(options), request); +} + +StatusOr +RolloutPlansRestMetadata::InsertRolloutPlan( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::rollout_plans::v1:: + InsertRolloutPlanRequest const& request) { + SetMetadata(rest_context, options); + return child_->InsertRolloutPlan(rest_context, options, request); +} + +StatusOr +RolloutPlansRestMetadata::ListRolloutPlans( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::rollout_plans::v1:: + ListRolloutPlansRequest const& request) { + SetMetadata(rest_context, options); + return child_->ListRolloutPlans(rest_context, options, request); +} + +future> +RolloutPlansRestMetadata::AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncGetOperation(cq, std::move(rest_context), + std::move(options), request); +} + +future RolloutPlansRestMetadata::AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncCancelOperation(cq, std::move(rest_context), + std::move(options), request); +} + +void RolloutPlansRestMetadata::SetMetadata( + rest_internal::RestContext& rest_context, Options const& options, + std::vector const& params) { + google::cloud::rest_internal::SetMetadata(rest_context, options, params, + api_client_header_); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_rollout_plans_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/rollout_plans/v1/internal/rollout_plans_rest_metadata_decorator.h b/google/cloud/compute/rollout_plans/v1/internal/rollout_plans_rest_metadata_decorator.h new file mode 100644 index 0000000000000..6e4ff6cf52864 --- /dev/null +++ b/google/cloud/compute/rollout_plans/v1/internal/rollout_plans_rest_metadata_decorator.h @@ -0,0 +1,111 @@ +// Copyright 2026 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. +// source: google/cloud/compute/rollout_plans/v1/rollout_plans.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUT_PLANS_V1_INTERNAL_ROLLOUT_PLANS_REST_METADATA_DECORATOR_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUT_PLANS_V1_INTERNAL_ROLLOUT_PLANS_REST_METADATA_DECORATOR_H + +#include "google/cloud/compute/global_operations/v1/global_operations.pb.h" +#include "google/cloud/compute/rollout_plans/v1/internal/rollout_plans_rest_stub.h" +#include "google/cloud/compute/rollout_plans/v1/rollout_plans.pb.h" +#include "google/cloud/future.h" +#include "google/cloud/rest_options.h" +#include "google/cloud/version.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_rollout_plans_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class RolloutPlansRestMetadata : public RolloutPlansRestStub { + public: + ~RolloutPlansRestMetadata() override = default; + explicit RolloutPlansRestMetadata(std::shared_ptr child, + std::string api_client_header = ""); + + google::cloud::future> + AsyncDeleteRolloutPlan( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::rollout_plans::v1:: + DeleteRolloutPlanRequest const& request) override; + + StatusOr DeleteRolloutPlan( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::rollout_plans::v1:: + DeleteRolloutPlanRequest const& request) override; + + StatusOr GetRolloutPlan( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::rollout_plans::v1:: + GetRolloutPlanRequest const& request) override; + + google::cloud::future> + AsyncInsertRolloutPlan( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::rollout_plans::v1:: + InsertRolloutPlanRequest const& request) override; + + StatusOr InsertRolloutPlan( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::rollout_plans::v1:: + InsertRolloutPlanRequest const& request) override; + + StatusOr + ListRolloutPlans(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::rollout_plans::v1:: + ListRolloutPlansRequest const& request) override; + + google::cloud::future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) override; + + google::cloud::future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) override; + + private: + void SetMetadata(rest_internal::RestContext& rest_context, + Options const& options, + std::vector const& params = {}); + + std::shared_ptr child_; + std::string api_client_header_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_rollout_plans_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUT_PLANS_V1_INTERNAL_ROLLOUT_PLANS_REST_METADATA_DECORATOR_H diff --git a/google/cloud/compute/rollout_plans/v1/internal/rollout_plans_rest_stub.cc b/google/cloud/compute/rollout_plans/v1/internal/rollout_plans_rest_stub.cc new file mode 100644 index 0000000000000..d2068922f9775 --- /dev/null +++ b/google/cloud/compute/rollout_plans/v1/internal/rollout_plans_rest_stub.cc @@ -0,0 +1,265 @@ +// Copyright 2026 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. +// source: google/cloud/compute/rollout_plans/v1/rollout_plans.proto + +#include "google/cloud/compute/rollout_plans/v1/internal/rollout_plans_rest_stub.h" +#include "google/cloud/compute/global_operations/v1/global_operations.pb.h" +#include "google/cloud/compute/rollout_plans/v1/rollout_plans.pb.h" +#include "google/cloud/common_options.h" +#include "google/cloud/internal/rest_stub_helpers.h" +#include "google/cloud/status_or.h" +#include "absl/strings/str_cat.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_rollout_plans_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +DefaultRolloutPlansRestStub::DefaultRolloutPlansRestStub(Options options) + : service_(rest_internal::MakePooledRestClient( + options.get(), options)), + operations_(rest_internal::MakePooledRestClient( + options.get(), options)), + options_(std::move(options)) {} + +DefaultRolloutPlansRestStub::DefaultRolloutPlansRestStub( + std::shared_ptr service, + std::shared_ptr operations, Options options) + : service_(std::move(service)), + operations_(std::move(operations)), + options_(std::move(options)) {} + +future> +DefaultRolloutPlansRestStub::AsyncDeleteRolloutPlan( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::rollout_plans::v1:: + DeleteRolloutPlanRequest const& request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto service, auto request, auto rest_context, auto options) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + p.set_value( + rest_internal::Delete( + *service, *rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", *options), + "/", "projects", "/", request.project(), "/", + "global", "/", "rolloutPlans", "/", + request.rollout_plan()), + std::move(query_params))); + }, + std::move(p), + service_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +StatusOr +DefaultRolloutPlansRestStub::DeleteRolloutPlan( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::rollout_plans::v1:: + DeleteRolloutPlanRequest const& request) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Delete( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "global", "/", + "rolloutPlans", "/", request.rollout_plan()), + std::move(query_params)); +} + +StatusOr +DefaultRolloutPlansRestStub::GetRolloutPlan( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::rollout_plans::v1::GetRolloutPlanRequest const& + request) { + std::vector> query_params; + return rest_internal::Get( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "global", "/", + "rolloutPlans", "/", request.rollout_plan()), + std::move(query_params)); +} + +future> +DefaultRolloutPlansRestStub::AsyncInsertRolloutPlan( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::rollout_plans::v1:: + InsertRolloutPlanRequest const& request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto service, auto request, auto rest_context, auto options) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + p.set_value( + rest_internal::Post( + *service, *rest_context, request.rollout_plan_resource(), false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", *options), + "/", "projects", "/", request.project(), "/", + "global", "/", "rolloutPlans"), + std::move(query_params))); + }, + std::move(p), + service_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +StatusOr +DefaultRolloutPlansRestStub::InsertRolloutPlan( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::rollout_plans::v1:: + InsertRolloutPlanRequest const& request) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Post( + *service_, rest_context, request.rollout_plan_resource(), false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "global", "/", + "rolloutPlans"), + std::move(query_params)); +} + +StatusOr +DefaultRolloutPlansRestStub::ListRolloutPlans( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::rollout_plans::v1:: + ListRolloutPlansRequest const& request) { + std::vector> query_params; + query_params.push_back({"filter", request.filter()}); + query_params.push_back( + {"max_results", std::to_string(request.max_results())}); + query_params.push_back({"order_by", request.order_by()}); + query_params.push_back({"page_token", request.page_token()}); + query_params.push_back({"return_partial_success", + (request.return_partial_success() ? "1" : "0")}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Get< + google::cloud::cpp::compute::v1::RolloutPlansListResponse>( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "global", "/", + "rolloutPlans"), + std::move(query_params)); +} + +future> +DefaultRolloutPlansRestStub::AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto operations, auto request, auto rest_context, + auto options) { + p.set_value( + rest_internal::Get( + *operations, *rest_context, request, false, + absl::StrCat("/compute/", + rest_internal::DetermineApiVersion("v1", *options), + "/projects/", request.project(), + "/global/operations/", request.operation()))); + }, + std::move(p), + operations_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +future DefaultRolloutPlansRestStub::AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) { + promise> p; + future> f = p.get_future(); + std::thread t{ + [](auto p, auto operations, auto request, auto rest_context, + auto options) { + p.set_value(rest_internal::Post( + *operations, *rest_context, request, false, + absl::StrCat("/compute/", + rest_internal::DetermineApiVersion("v1", *options), + "/projects/", request.project(), "/global/operations/", + request.operation()))); + }, + std::move(p), + operations_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get().status(); + }); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_rollout_plans_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/rollout_plans/v1/internal/rollout_plans_rest_stub.h b/google/cloud/compute/rollout_plans/v1/internal/rollout_plans_rest_stub.h new file mode 100644 index 0000000000000..fd26e74302cc7 --- /dev/null +++ b/google/cloud/compute/rollout_plans/v1/internal/rollout_plans_rest_stub.h @@ -0,0 +1,171 @@ +// Copyright 2026 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. +// source: google/cloud/compute/rollout_plans/v1/rollout_plans.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUT_PLANS_V1_INTERNAL_ROLLOUT_PLANS_REST_STUB_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUT_PLANS_V1_INTERNAL_ROLLOUT_PLANS_REST_STUB_H + +#include "google/cloud/compute/global_operations/v1/global_operations.pb.h" +#include "google/cloud/compute/rollout_plans/v1/rollout_plans.pb.h" +#include "google/cloud/completion_queue.h" +#include "google/cloud/internal/rest_client.h" +#include "google/cloud/internal/rest_context.h" +#include "google/cloud/status_or.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_rollout_plans_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class RolloutPlansRestStub { + public: + virtual ~RolloutPlansRestStub() = default; + + virtual future> + AsyncDeleteRolloutPlan( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::rollout_plans::v1:: + DeleteRolloutPlanRequest const& request) = 0; + + virtual StatusOr + DeleteRolloutPlan(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::rollout_plans::v1:: + DeleteRolloutPlanRequest const& request) = 0; + + virtual StatusOr GetRolloutPlan( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::rollout_plans::v1:: + GetRolloutPlanRequest const& request) = 0; + + virtual future> + AsyncInsertRolloutPlan( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::rollout_plans::v1:: + InsertRolloutPlanRequest const& request) = 0; + + virtual StatusOr + InsertRolloutPlan(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::rollout_plans::v1:: + InsertRolloutPlanRequest const& request) = 0; + + virtual StatusOr + ListRolloutPlans(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::rollout_plans::v1:: + ListRolloutPlansRequest const& request) = 0; + + virtual future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) = 0; + + virtual future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) = 0; +}; + +class DefaultRolloutPlansRestStub : public RolloutPlansRestStub { + public: + ~DefaultRolloutPlansRestStub() override = default; + + explicit DefaultRolloutPlansRestStub(Options options); + DefaultRolloutPlansRestStub( + std::shared_ptr service, + std::shared_ptr operations, Options options); + + future> + AsyncDeleteRolloutPlan( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::rollout_plans::v1:: + DeleteRolloutPlanRequest const& request) override; + + StatusOr DeleteRolloutPlan( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::rollout_plans::v1:: + DeleteRolloutPlanRequest const& request) override; + + StatusOr GetRolloutPlan( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::rollout_plans::v1:: + GetRolloutPlanRequest const& request) override; + + future> + AsyncInsertRolloutPlan( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::rollout_plans::v1:: + InsertRolloutPlanRequest const& request) override; + + StatusOr InsertRolloutPlan( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::rollout_plans::v1:: + InsertRolloutPlanRequest const& request) override; + + StatusOr + ListRolloutPlans(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::rollout_plans::v1:: + ListRolloutPlansRequest const& request) override; + + future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) override; + + future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) override; + + private: + std::shared_ptr service_; + std::shared_ptr operations_; + Options options_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_rollout_plans_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUT_PLANS_V1_INTERNAL_ROLLOUT_PLANS_REST_STUB_H diff --git a/google/cloud/compute/rollout_plans/v1/internal/rollout_plans_rest_stub_factory.cc b/google/cloud/compute/rollout_plans/v1/internal/rollout_plans_rest_stub_factory.cc new file mode 100644 index 0000000000000..10d02d4d08bf9 --- /dev/null +++ b/google/cloud/compute/rollout_plans/v1/internal/rollout_plans_rest_stub_factory.cc @@ -0,0 +1,56 @@ +// Copyright 2026 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. +// source: google/cloud/compute/rollout_plans/v1/rollout_plans.proto + +#include "google/cloud/compute/rollout_plans/v1/internal/rollout_plans_rest_stub_factory.h" +#include "google/cloud/compute/rollout_plans/v1/internal/rollout_plans_rest_logging_decorator.h" +#include "google/cloud/compute/rollout_plans/v1/internal/rollout_plans_rest_metadata_decorator.h" +#include "google/cloud/compute/rollout_plans/v1/internal/rollout_plans_rest_stub.h" +#include "google/cloud/common_options.h" +#include "google/cloud/internal/algorithm.h" +#include "google/cloud/internal/populate_rest_options.h" +#include "google/cloud/log.h" +#include "google/cloud/options.h" +#include "google/cloud/rest_options.h" +#include "absl/strings/match.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_rollout_plans_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +std::shared_ptr CreateDefaultRolloutPlansRestStub( + Options const& options) { + auto opts = internal::PopulateRestOptions(options); + std::shared_ptr stub = + std::make_shared(std::move(opts)); + stub = std::make_shared(std::move(stub)); + if (internal::Contains(options.get(), "rpc")) { + GCP_LOG(INFO) << "Enabled logging for REST rpc calls"; + stub = std::make_shared( + std::move(stub), options.get(), + options.get()); + } + return stub; +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_rollout_plans_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/rollout_plans/v1/internal/rollout_plans_rest_stub_factory.h b/google/cloud/compute/rollout_plans/v1/internal/rollout_plans_rest_stub_factory.h new file mode 100644 index 0000000000000..dcfcb323df63d --- /dev/null +++ b/google/cloud/compute/rollout_plans/v1/internal/rollout_plans_rest_stub_factory.h @@ -0,0 +1,40 @@ +// Copyright 2026 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. +// source: google/cloud/compute/rollout_plans/v1/rollout_plans.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUT_PLANS_V1_INTERNAL_ROLLOUT_PLANS_REST_STUB_FACTORY_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUT_PLANS_V1_INTERNAL_ROLLOUT_PLANS_REST_STUB_FACTORY_H + +#include "google/cloud/compute/rollout_plans/v1/internal/rollout_plans_rest_stub.h" +#include "google/cloud/options.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_rollout_plans_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +std::shared_ptr CreateDefaultRolloutPlansRestStub( + Options const& options); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_rollout_plans_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUT_PLANS_V1_INTERNAL_ROLLOUT_PLANS_REST_STUB_FACTORY_H diff --git a/google/cloud/compute/rollout_plans/v1/internal/rollout_plans_retry_traits.h b/google/cloud/compute/rollout_plans/v1/internal/rollout_plans_retry_traits.h new file mode 100644 index 0000000000000..a60700a387e40 --- /dev/null +++ b/google/cloud/compute/rollout_plans/v1/internal/rollout_plans_retry_traits.h @@ -0,0 +1,43 @@ +// Copyright 2026 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. +// source: google/cloud/compute/rollout_plans/v1/rollout_plans.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUT_PLANS_V1_INTERNAL_ROLLOUT_PLANS_RETRY_TRAITS_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUT_PLANS_V1_INTERNAL_ROLLOUT_PLANS_RETRY_TRAITS_H + +#include "google/cloud/status.h" +#include "google/cloud/version.h" + +namespace google { +namespace cloud { +namespace compute_rollout_plans_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/// Define the gRPC status code semantics for retrying requests. +struct RolloutPlansRetryTraits { + static bool IsPermanentFailure(google::cloud::Status const& status) { + return status.code() != StatusCode::kOk && + status.code() != StatusCode::kUnavailable; + } +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_rollout_plans_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUT_PLANS_V1_INTERNAL_ROLLOUT_PLANS_RETRY_TRAITS_H diff --git a/google/cloud/compute/rollout_plans/v1/internal/rollout_plans_sources.cc b/google/cloud/compute/rollout_plans/v1/internal/rollout_plans_sources.cc new file mode 100644 index 0000000000000..7815ea41313d6 --- /dev/null +++ b/google/cloud/compute/rollout_plans/v1/internal/rollout_plans_sources.cc @@ -0,0 +1,31 @@ +// Copyright 2026 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. +// source: google/cloud/compute/rollout_plans/v1/rollout_plans.proto + +// NOLINTBEGIN(bugprone-suspicious-include) +#include "google/cloud/compute/rollout_plans/v1/internal/rollout_plans_option_defaults.cc" +#include "google/cloud/compute/rollout_plans/v1/internal/rollout_plans_rest_connection_impl.cc" +#include "google/cloud/compute/rollout_plans/v1/internal/rollout_plans_rest_logging_decorator.cc" +#include "google/cloud/compute/rollout_plans/v1/internal/rollout_plans_rest_metadata_decorator.cc" +#include "google/cloud/compute/rollout_plans/v1/internal/rollout_plans_rest_stub.cc" +#include "google/cloud/compute/rollout_plans/v1/internal/rollout_plans_rest_stub_factory.cc" +#include "google/cloud/compute/rollout_plans/v1/internal/rollout_plans_tracing_connection.cc" +#include "google/cloud/compute/rollout_plans/v1/rollout_plans_client.cc" +#include "google/cloud/compute/rollout_plans/v1/rollout_plans_connection.cc" +#include "google/cloud/compute/rollout_plans/v1/rollout_plans_connection_idempotency_policy.cc" +#include "google/cloud/compute/rollout_plans/v1/rollout_plans_rest_connection.cc" +// NOLINTEND(bugprone-suspicious-include) diff --git a/google/cloud/compute/rollout_plans/v1/internal/rollout_plans_tracing_connection.cc b/google/cloud/compute/rollout_plans/v1/internal/rollout_plans_tracing_connection.cc new file mode 100644 index 0000000000000..1553966b3ce49 --- /dev/null +++ b/google/cloud/compute/rollout_plans/v1/internal/rollout_plans_tracing_connection.cc @@ -0,0 +1,131 @@ +// Copyright 2026 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. +// source: google/cloud/compute/rollout_plans/v1/rollout_plans.proto + +#include "google/cloud/compute/rollout_plans/v1/internal/rollout_plans_tracing_connection.h" +#include "google/cloud/internal/opentelemetry.h" +#include "google/cloud/internal/traced_stream_range.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_rollout_plans_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +RolloutPlansTracingConnection::RolloutPlansTracingConnection( + std::shared_ptr child) + : child_(std::move(child)) {} + +future> +RolloutPlansTracingConnection::DeleteRolloutPlan( + google::cloud::cpp::compute::rollout_plans::v1:: + DeleteRolloutPlanRequest const& request) { + auto span = internal::MakeSpan( + "compute_rollout_plans_v1::RolloutPlansConnection::DeleteRolloutPlan"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), child_->DeleteRolloutPlan(request)); +} + +StatusOr +RolloutPlansTracingConnection::DeleteRolloutPlan( + NoAwaitTag, google::cloud::cpp::compute::rollout_plans::v1:: + DeleteRolloutPlanRequest const& request) { + auto span = internal::MakeSpan( + "compute_rollout_plans_v1::RolloutPlansConnection::DeleteRolloutPlan"); + opentelemetry::trace::Scope scope(span); + return internal::EndSpan(*span, + child_->DeleteRolloutPlan(NoAwaitTag{}, request)); +} + +future> +RolloutPlansTracingConnection::DeleteRolloutPlan( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto span = internal::MakeSpan( + "compute_rollout_plans_v1::RolloutPlansConnection::DeleteRolloutPlan"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), + child_->DeleteRolloutPlan(operation)); +} + +StatusOr +RolloutPlansTracingConnection::GetRolloutPlan( + google::cloud::cpp::compute::rollout_plans::v1::GetRolloutPlanRequest const& + request) { + auto span = internal::MakeSpan( + "compute_rollout_plans_v1::RolloutPlansConnection::GetRolloutPlan"); + auto scope = opentelemetry::trace::Scope(span); + return internal::EndSpan(*span, child_->GetRolloutPlan(request)); +} + +future> +RolloutPlansTracingConnection::InsertRolloutPlan( + google::cloud::cpp::compute::rollout_plans::v1:: + InsertRolloutPlanRequest const& request) { + auto span = internal::MakeSpan( + "compute_rollout_plans_v1::RolloutPlansConnection::InsertRolloutPlan"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), child_->InsertRolloutPlan(request)); +} + +StatusOr +RolloutPlansTracingConnection::InsertRolloutPlan( + NoAwaitTag, google::cloud::cpp::compute::rollout_plans::v1:: + InsertRolloutPlanRequest const& request) { + auto span = internal::MakeSpan( + "compute_rollout_plans_v1::RolloutPlansConnection::InsertRolloutPlan"); + opentelemetry::trace::Scope scope(span); + return internal::EndSpan(*span, + child_->InsertRolloutPlan(NoAwaitTag{}, request)); +} + +future> +RolloutPlansTracingConnection::InsertRolloutPlan( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto span = internal::MakeSpan( + "compute_rollout_plans_v1::RolloutPlansConnection::InsertRolloutPlan"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), + child_->InsertRolloutPlan(operation)); +} + +StreamRange +RolloutPlansTracingConnection::ListRolloutPlans( + google::cloud::cpp::compute::rollout_plans::v1::ListRolloutPlansRequest + request) { + auto span = internal::MakeSpan( + "compute_rollout_plans_v1::RolloutPlansConnection::ListRolloutPlans"); + internal::OTelScope scope(span); + auto sr = child_->ListRolloutPlans(std::move(request)); + return internal::MakeTracedStreamRange< + google::cloud::cpp::compute::v1::RolloutPlan>(std::move(span), + std::move(sr)); +} + +std::shared_ptr +MakeRolloutPlansTracingConnection( + std::shared_ptr conn) { + if (internal::TracingEnabled(conn->options())) { + conn = std::make_shared(std::move(conn)); + } + return conn; +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_rollout_plans_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/rollout_plans/v1/internal/rollout_plans_tracing_connection.h b/google/cloud/compute/rollout_plans/v1/internal/rollout_plans_tracing_connection.h new file mode 100644 index 0000000000000..e7e4ec2c17cf3 --- /dev/null +++ b/google/cloud/compute/rollout_plans/v1/internal/rollout_plans_tracing_connection.h @@ -0,0 +1,92 @@ +// Copyright 2026 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. +// source: google/cloud/compute/rollout_plans/v1/rollout_plans.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUT_PLANS_V1_INTERNAL_ROLLOUT_PLANS_TRACING_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUT_PLANS_V1_INTERNAL_ROLLOUT_PLANS_TRACING_CONNECTION_H + +#include "google/cloud/compute/rollout_plans/v1/rollout_plans_connection.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_rollout_plans_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class RolloutPlansTracingConnection + : public compute_rollout_plans_v1::RolloutPlansConnection { + public: + ~RolloutPlansTracingConnection() override = default; + + explicit RolloutPlansTracingConnection( + std::shared_ptr child); + + Options options() override { return child_->options(); } + + future> + DeleteRolloutPlan(google::cloud::cpp::compute::rollout_plans::v1:: + DeleteRolloutPlanRequest const& request) override; + + StatusOr DeleteRolloutPlan( + NoAwaitTag, google::cloud::cpp::compute::rollout_plans::v1:: + DeleteRolloutPlanRequest const& request) override; + + future> + DeleteRolloutPlan( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + StatusOr GetRolloutPlan( + google::cloud::cpp::compute::rollout_plans::v1:: + GetRolloutPlanRequest const& request) override; + + future> + InsertRolloutPlan(google::cloud::cpp::compute::rollout_plans::v1:: + InsertRolloutPlanRequest const& request) override; + + StatusOr InsertRolloutPlan( + NoAwaitTag, google::cloud::cpp::compute::rollout_plans::v1:: + InsertRolloutPlanRequest const& request) override; + + future> + InsertRolloutPlan( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + StreamRange ListRolloutPlans( + google::cloud::cpp::compute::rollout_plans::v1::ListRolloutPlansRequest + request) override; + + private: + std::shared_ptr child_; +}; + +/** + * Conditionally applies the tracing decorator to the given connection. + * + * The connection is only decorated if tracing is enabled (as determined by the + * connection's options). + */ +std::shared_ptr +MakeRolloutPlansTracingConnection( + std::shared_ptr conn); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_rollout_plans_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUT_PLANS_V1_INTERNAL_ROLLOUT_PLANS_TRACING_CONNECTION_H diff --git a/google/cloud/compute/rollout_plans/v1/mocks/mock_rollout_plans_connection.h b/google/cloud/compute/rollout_plans/v1/mocks/mock_rollout_plans_connection.h new file mode 100644 index 0000000000000..32cf260463678 --- /dev/null +++ b/google/cloud/compute/rollout_plans/v1/mocks/mock_rollout_plans_connection.h @@ -0,0 +1,151 @@ +// Copyright 2026 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. +// source: google/cloud/compute/rollout_plans/v1/rollout_plans.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUT_PLANS_V1_MOCKS_MOCK_ROLLOUT_PLANS_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUT_PLANS_V1_MOCKS_MOCK_ROLLOUT_PLANS_CONNECTION_H + +#include "google/cloud/compute/rollout_plans/v1/rollout_plans_connection.h" +#include + +namespace google { +namespace cloud { +namespace compute_rollout_plans_v1_mocks { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/** + * A class to mock `RolloutPlansConnection`. + * + * Application developers may want to test their code with simulated responses, + * including errors, from an object of type `RolloutPlansClient`. To do so, + * construct an object of type `RolloutPlansClient` with an instance of this + * class. Then use the Google Test framework functions to program the behavior + * of this mock. + * + * @see [This example][bq-mock] for how to test your application with GoogleTest. + * While the example showcases types from the BigQuery library, the underlying + * principles apply for any pair of `*Client` and `*Connection`. + * + * [bq-mock]: @cloud_cpp_docs_link{bigquery,bigquery-read-mock} + */ +class MockRolloutPlansConnection + : public compute_rollout_plans_v1::RolloutPlansConnection { + public: + MOCK_METHOD(Options, options, (), (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// DeleteRolloutPlan(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + DeleteRolloutPlan, + (google::cloud::cpp::compute::rollout_plans::v1:: + DeleteRolloutPlanRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// EXPECT_CALL(*mock, DeleteRolloutPlan(_, _)) + /// @endcode + MOCK_METHOD(StatusOr, + DeleteRolloutPlan, + (NoAwaitTag, google::cloud::cpp::compute::rollout_plans::v1:: + DeleteRolloutPlanRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// DeleteRolloutPlan(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + DeleteRolloutPlan, + (google::cloud::cpp::compute::v1::Operation const& operation), + (override)); + + MOCK_METHOD(StatusOr, + GetRolloutPlan, + (google::cloud::cpp::compute::rollout_plans::v1:: + GetRolloutPlanRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// InsertRolloutPlan(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + InsertRolloutPlan, + (google::cloud::cpp::compute::rollout_plans::v1:: + InsertRolloutPlanRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// EXPECT_CALL(*mock, InsertRolloutPlan(_, _)) + /// @endcode + MOCK_METHOD(StatusOr, + InsertRolloutPlan, + (NoAwaitTag, google::cloud::cpp::compute::rollout_plans::v1:: + InsertRolloutPlanRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// InsertRolloutPlan(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + InsertRolloutPlan, + (google::cloud::cpp::compute::v1::Operation const& operation), + (override)); + + MOCK_METHOD( + (StreamRange), + ListRolloutPlans, + (google::cloud::cpp::compute::rollout_plans::v1::ListRolloutPlansRequest + request), + (override)); +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_rollout_plans_v1_mocks +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUT_PLANS_V1_MOCKS_MOCK_ROLLOUT_PLANS_CONNECTION_H diff --git a/google/cloud/compute/rollout_plans/v1/rollout_plans_client.cc b/google/cloud/compute/rollout_plans/v1/rollout_plans_client.cc new file mode 100644 index 0000000000000..eb92cf367be5c --- /dev/null +++ b/google/cloud/compute/rollout_plans/v1/rollout_plans_client.cc @@ -0,0 +1,178 @@ +// Copyright 2026 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. +// source: google/cloud/compute/rollout_plans/v1/rollout_plans.proto + +#include "google/cloud/compute/rollout_plans/v1/rollout_plans_client.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_rollout_plans_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +RolloutPlansClient::RolloutPlansClient( + std::shared_ptr connection, Options opts) + : connection_(std::move(connection)), + options_( + internal::MergeOptions(std::move(opts), connection_->options())) {} +RolloutPlansClient::~RolloutPlansClient() = default; + +future> +RolloutPlansClient::DeleteRolloutPlan(std::string const& project, + std::string const& rollout_plan, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::rollout_plans::v1::DeleteRolloutPlanRequest + request; + request.set_project(project); + request.set_rollout_plan(rollout_plan); + return connection_->DeleteRolloutPlan(request); +} + +StatusOr +RolloutPlansClient::DeleteRolloutPlan(NoAwaitTag, std::string const& project, + std::string const& rollout_plan, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::rollout_plans::v1::DeleteRolloutPlanRequest + request; + request.set_project(project); + request.set_rollout_plan(rollout_plan); + return connection_->DeleteRolloutPlan(NoAwaitTag{}, request); +} + +future> +RolloutPlansClient::DeleteRolloutPlan( + google::cloud::cpp::compute::rollout_plans::v1:: + DeleteRolloutPlanRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->DeleteRolloutPlan(request); +} + +StatusOr +RolloutPlansClient::DeleteRolloutPlan( + NoAwaitTag, + google::cloud::cpp::compute::rollout_plans::v1:: + DeleteRolloutPlanRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->DeleteRolloutPlan(NoAwaitTag{}, request); +} + +future> +RolloutPlansClient::DeleteRolloutPlan( + google::cloud::cpp::compute::v1::Operation const& operation, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->DeleteRolloutPlan(operation); +} + +StatusOr +RolloutPlansClient::GetRolloutPlan(std::string const& project, + std::string const& rollout_plan, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::rollout_plans::v1::GetRolloutPlanRequest request; + request.set_project(project); + request.set_rollout_plan(rollout_plan); + return connection_->GetRolloutPlan(request); +} + +StatusOr +RolloutPlansClient::GetRolloutPlan( + google::cloud::cpp::compute::rollout_plans::v1::GetRolloutPlanRequest const& + request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->GetRolloutPlan(request); +} + +future> +RolloutPlansClient::InsertRolloutPlan( + std::string const& project, + google::cloud::cpp::compute::v1::RolloutPlan const& rollout_plan_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::rollout_plans::v1::InsertRolloutPlanRequest + request; + request.set_project(project); + *request.mutable_rollout_plan_resource() = rollout_plan_resource; + return connection_->InsertRolloutPlan(request); +} + +StatusOr +RolloutPlansClient::InsertRolloutPlan( + NoAwaitTag, std::string const& project, + google::cloud::cpp::compute::v1::RolloutPlan const& rollout_plan_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::rollout_plans::v1::InsertRolloutPlanRequest + request; + request.set_project(project); + *request.mutable_rollout_plan_resource() = rollout_plan_resource; + return connection_->InsertRolloutPlan(NoAwaitTag{}, request); +} + +future> +RolloutPlansClient::InsertRolloutPlan( + google::cloud::cpp::compute::rollout_plans::v1:: + InsertRolloutPlanRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->InsertRolloutPlan(request); +} + +StatusOr +RolloutPlansClient::InsertRolloutPlan( + NoAwaitTag, + google::cloud::cpp::compute::rollout_plans::v1:: + InsertRolloutPlanRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->InsertRolloutPlan(NoAwaitTag{}, request); +} + +future> +RolloutPlansClient::InsertRolloutPlan( + google::cloud::cpp::compute::v1::Operation const& operation, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->InsertRolloutPlan(operation); +} + +StreamRange +RolloutPlansClient::ListRolloutPlans(std::string const& project, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::rollout_plans::v1::ListRolloutPlansRequest + request; + request.set_project(project); + return connection_->ListRolloutPlans(request); +} + +StreamRange +RolloutPlansClient::ListRolloutPlans( + google::cloud::cpp::compute::rollout_plans::v1::ListRolloutPlansRequest + request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->ListRolloutPlans(std::move(request)); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_rollout_plans_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/rollout_plans/v1/rollout_plans_client.h b/google/cloud/compute/rollout_plans/v1/rollout_plans_client.h new file mode 100644 index 0000000000000..a8bc65508cb50 --- /dev/null +++ b/google/cloud/compute/rollout_plans/v1/rollout_plans_client.h @@ -0,0 +1,477 @@ +// Copyright 2026 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. +// source: google/cloud/compute/rollout_plans/v1/rollout_plans.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUT_PLANS_V1_ROLLOUT_PLANS_CLIENT_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUT_PLANS_V1_ROLLOUT_PLANS_CLIENT_H + +#include "google/cloud/compute/rollout_plans/v1/rollout_plans_rest_connection.h" +#include "google/cloud/future.h" +#include "google/cloud/no_await_tag.h" +#include "google/cloud/options.h" +#include "google/cloud/polling_policy.h" +#include "google/cloud/status_or.h" +#include "google/cloud/version.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_rollout_plans_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/// +/// Service for the rolloutPlans resource. +/// https://cloud.google.com/compute/docs/reference/rest/v1/rolloutPlans +/// +/// @par Equality +/// +/// Instances of this class created via copy-construction or copy-assignment +/// always compare equal. Instances created with equal +/// `std::shared_ptr<*Connection>` objects compare equal. Objects that compare +/// equal share the same underlying resources. +/// +/// @par Performance +/// +/// Creating a new instance of this class is a relatively expensive operation, +/// new objects establish new connections to the service. In contrast, +/// copy-construction, move-construction, and the corresponding assignment +/// operations are relatively efficient as the copies share all underlying +/// resources. +/// +/// @par Thread Safety +/// +/// Concurrent access to different instances of this class, even if they compare +/// equal, is guaranteed to work. Two or more threads operating on the same +/// instance of this class is not guaranteed to work. Since copy-construction +/// and move-construction is a relatively efficient operation, consider using +/// such a copy when using this class from multiple threads. +/// +class RolloutPlansClient { + public: + explicit RolloutPlansClient( + std::shared_ptr connection, Options opts = {}); + ~RolloutPlansClient(); + + ///@{ + /// @name Copy and move support + RolloutPlansClient(RolloutPlansClient const&) = default; + RolloutPlansClient& operator=(RolloutPlansClient const&) = default; + RolloutPlansClient(RolloutPlansClient&&) = default; + RolloutPlansClient& operator=(RolloutPlansClient&&) = default; + ///@} + + ///@{ + /// @name Equality + friend bool operator==(RolloutPlansClient const& a, + RolloutPlansClient const& b) { + return a.connection_ == b.connection_; + } + friend bool operator!=(RolloutPlansClient const& a, + RolloutPlansClient const& b) { + return !(a == b); + } + ///@} + + // clang-format off + /// + /// Deletes a RolloutPlan. + /// https://cloud.google.com/compute/docs/reference/rest/v1/rolloutPlans/delete + /// + /// @param project Project ID for this request. + /// @param rollout_plan Name of the RolloutPlan resource to delete. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.rollout_plans.v1.DeleteRolloutPlanRequest]: @cloud_cpp_reference_link{google/cloud/compute/rollout_plans/v1/rollout_plans.proto#L85} + /// + // clang-format on + future> + DeleteRolloutPlan(std::string const& project, std::string const& rollout_plan, + Options opts = {}); + + // clang-format off + /// + /// @copybrief DeleteRolloutPlan + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr DeleteRolloutPlan( + NoAwaitTag, std::string const& project, std::string const& rollout_plan, + Options opts = {}); + + // clang-format off + /// + /// Deletes a RolloutPlan. + /// https://cloud.google.com/compute/docs/reference/rest/v1/rolloutPlans/delete + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.rollout_plans.v1.DeleteRolloutPlanRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.rollout_plans.v1.DeleteRolloutPlanRequest]: @cloud_cpp_reference_link{google/cloud/compute/rollout_plans/v1/rollout_plans.proto#L85} + /// + // clang-format on + future> + DeleteRolloutPlan(google::cloud::cpp::compute::rollout_plans::v1:: + DeleteRolloutPlanRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief DeleteRolloutPlan + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr DeleteRolloutPlan( + NoAwaitTag, + google::cloud::cpp::compute::rollout_plans::v1:: + DeleteRolloutPlanRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief DeleteRolloutPlan + /// + /// This method accepts a `google::cloud::cpp::compute::v1::Operation` that corresponds + /// to a previously started Long Running Operation (LRO) and polls the status + /// of the LRO in the background. + /// + // clang-format on + future> + DeleteRolloutPlan(google::cloud::cpp::compute::v1::Operation const& operation, + Options opts = {}); + + // clang-format off + /// + /// Gets details of a single project-scoped RolloutPlan. + /// https://cloud.google.com/compute/docs/reference/rest/v1/rolloutPlans/get + /// + /// @param project Project ID for this request. + /// @param rollout_plan Name of the persistent rollout plan to return. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.RolloutPlan]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.rollout_plans.v1.GetRolloutPlanRequest]: @cloud_cpp_reference_link{google/cloud/compute/rollout_plans/v1/rollout_plans.proto#L114} + /// [google.cloud.cpp.compute.v1.RolloutPlan]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_137.proto#L30} + /// + // clang-format on + StatusOr GetRolloutPlan( + std::string const& project, std::string const& rollout_plan, + Options opts = {}); + + // clang-format off + /// + /// Gets details of a single project-scoped RolloutPlan. + /// https://cloud.google.com/compute/docs/reference/rest/v1/rolloutPlans/get + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.rollout_plans.v1.GetRolloutPlanRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.RolloutPlan]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.rollout_plans.v1.GetRolloutPlanRequest]: @cloud_cpp_reference_link{google/cloud/compute/rollout_plans/v1/rollout_plans.proto#L114} + /// [google.cloud.cpp.compute.v1.RolloutPlan]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_137.proto#L30} + /// + // clang-format on + StatusOr GetRolloutPlan( + google::cloud::cpp::compute::rollout_plans::v1:: + GetRolloutPlanRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// Creates a new RolloutPlan in a given project and location. + /// https://cloud.google.com/compute/docs/reference/rest/v1/rolloutPlans/insert + /// + /// @param project Project ID for this request. + /// @param rollout_plan_resource The RolloutPlan for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.rollout_plans.v1.InsertRolloutPlanRequest]: @cloud_cpp_reference_link{google/cloud/compute/rollout_plans/v1/rollout_plans.proto#L125} + /// + // clang-format on + future> + InsertRolloutPlan( + std::string const& project, + google::cloud::cpp::compute::v1::RolloutPlan const& rollout_plan_resource, + Options opts = {}); + + // clang-format off + /// + /// @copybrief InsertRolloutPlan + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr InsertRolloutPlan( + NoAwaitTag, std::string const& project, + google::cloud::cpp::compute::v1::RolloutPlan const& rollout_plan_resource, + Options opts = {}); + + // clang-format off + /// + /// Creates a new RolloutPlan in a given project and location. + /// https://cloud.google.com/compute/docs/reference/rest/v1/rolloutPlans/insert + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.rollout_plans.v1.InsertRolloutPlanRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.rollout_plans.v1.InsertRolloutPlanRequest]: @cloud_cpp_reference_link{google/cloud/compute/rollout_plans/v1/rollout_plans.proto#L125} + /// + // clang-format on + future> + InsertRolloutPlan(google::cloud::cpp::compute::rollout_plans::v1:: + InsertRolloutPlanRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief InsertRolloutPlan + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr InsertRolloutPlan( + NoAwaitTag, + google::cloud::cpp::compute::rollout_plans::v1:: + InsertRolloutPlanRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief InsertRolloutPlan + /// + /// This method accepts a `google::cloud::cpp::compute::v1::Operation` that corresponds + /// to a previously started Long Running Operation (LRO) and polls the status + /// of the LRO in the background. + /// + // clang-format on + future> + InsertRolloutPlan(google::cloud::cpp::compute::v1::Operation const& operation, + Options opts = {}); + + // clang-format off + /// + /// Lists RolloutPlans in a given project and location. + /// https://cloud.google.com/compute/docs/reference/rest/v1/rolloutPlans/list + /// + /// @param project Project ID for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return a [StreamRange](@ref google::cloud::StreamRange) + /// to iterate of the results. See the documentation of this type for + /// details. In brief, this class has `begin()` and `end()` member + /// functions returning a iterator class meeting the + /// [input iterator requirements]. The value type for this iterator is a + /// [`StatusOr`] as the iteration may fail even after some values are + /// retrieved successfully, for example, if there is a network disconnect. + /// An empty set of results does not indicate an error, it indicates + /// that there are no resources meeting the request criteria. + /// On a successful iteration the `StatusOr` contains elements of type + /// [google.cloud.cpp.compute.v1.RolloutPlan], or rather, + /// the C++ class generated by Protobuf from that type. Please consult the + /// Protobuf documentation for details on the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.rollout_plans.v1.ListRolloutPlansRequest]: @cloud_cpp_reference_link{google/cloud/compute/rollout_plans/v1/rollout_plans.proto#L154} + /// [google.cloud.cpp.compute.v1.RolloutPlan]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_137.proto#L30} + /// + // clang-format on + StreamRange ListRolloutPlans( + std::string const& project, Options opts = {}); + + // clang-format off + /// + /// Lists RolloutPlans in a given project and location. + /// https://cloud.google.com/compute/docs/reference/rest/v1/rolloutPlans/list + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.rollout_plans.v1.ListRolloutPlansRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return a [StreamRange](@ref google::cloud::StreamRange) + /// to iterate of the results. See the documentation of this type for + /// details. In brief, this class has `begin()` and `end()` member + /// functions returning a iterator class meeting the + /// [input iterator requirements]. The value type for this iterator is a + /// [`StatusOr`] as the iteration may fail even after some values are + /// retrieved successfully, for example, if there is a network disconnect. + /// An empty set of results does not indicate an error, it indicates + /// that there are no resources meeting the request criteria. + /// On a successful iteration the `StatusOr` contains elements of type + /// [google.cloud.cpp.compute.v1.RolloutPlan], or rather, + /// the C++ class generated by Protobuf from that type. Please consult the + /// Protobuf documentation for details on the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.rollout_plans.v1.ListRolloutPlansRequest]: @cloud_cpp_reference_link{google/cloud/compute/rollout_plans/v1/rollout_plans.proto#L154} + /// [google.cloud.cpp.compute.v1.RolloutPlan]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_137.proto#L30} + /// + // clang-format on + StreamRange ListRolloutPlans( + google::cloud::cpp::compute::rollout_plans::v1::ListRolloutPlansRequest + request, + Options opts = {}); + + private: + std::shared_ptr connection_; + Options options_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_rollout_plans_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUT_PLANS_V1_ROLLOUT_PLANS_CLIENT_H diff --git a/google/cloud/compute/rollout_plans/v1/rollout_plans_connection.cc b/google/cloud/compute/rollout_plans/v1/rollout_plans_connection.cc new file mode 100644 index 0000000000000..00748b54f5fb8 --- /dev/null +++ b/google/cloud/compute/rollout_plans/v1/rollout_plans_connection.cc @@ -0,0 +1,107 @@ +// Copyright 2026 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. +// source: google/cloud/compute/rollout_plans/v1/rollout_plans.proto + +#include "google/cloud/compute/rollout_plans/v1/rollout_plans_connection.h" +#include "google/cloud/compute/rollout_plans/v1/internal/rollout_plans_option_defaults.h" +#include "google/cloud/compute/rollout_plans/v1/internal/rollout_plans_tracing_connection.h" +#include "google/cloud/compute/rollout_plans/v1/rollout_plans_options.h" +#include "google/cloud/background_threads.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/grpc_options.h" +#include "google/cloud/internal/pagination_range.h" +#include "google/cloud/internal/unified_grpc_credentials.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_rollout_plans_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +RolloutPlansConnection::~RolloutPlansConnection() = default; + +future> +RolloutPlansConnection::DeleteRolloutPlan( + google::cloud::cpp::compute::rollout_plans::v1:: + DeleteRolloutPlanRequest const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +RolloutPlansConnection::DeleteRolloutPlan( + NoAwaitTag, google::cloud::cpp::compute::rollout_plans::v1:: + DeleteRolloutPlanRequest const&) { + return StatusOr( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +RolloutPlansConnection::DeleteRolloutPlan( + google::cloud::cpp::compute::v1::Operation const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +RolloutPlansConnection::GetRolloutPlan( + google::cloud::cpp::compute::rollout_plans::v1:: + GetRolloutPlanRequest const&) { + return Status(StatusCode::kUnimplemented, "not implemented"); +} + +future> +RolloutPlansConnection::InsertRolloutPlan( + google::cloud::cpp::compute::rollout_plans::v1:: + InsertRolloutPlanRequest const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +RolloutPlansConnection::InsertRolloutPlan( + NoAwaitTag, google::cloud::cpp::compute::rollout_plans::v1:: + InsertRolloutPlanRequest const&) { + return StatusOr( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +RolloutPlansConnection::InsertRolloutPlan( + google::cloud::cpp::compute::v1::Operation const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StreamRange +RolloutPlansConnection::ListRolloutPlans( + google::cloud::cpp::compute::rollout_plans::v1:: + ListRolloutPlansRequest) { // NOLINT(performance-unnecessary-value-param) + return google::cloud::internal::MakeUnimplementedPaginationRange< + StreamRange>(); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_rollout_plans_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/rollout_plans/v1/rollout_plans_connection.h b/google/cloud/compute/rollout_plans/v1/rollout_plans_connection.h new file mode 100644 index 0000000000000..69d9d390614ca --- /dev/null +++ b/google/cloud/compute/rollout_plans/v1/rollout_plans_connection.h @@ -0,0 +1,228 @@ +// Copyright 2026 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. +// source: google/cloud/compute/rollout_plans/v1/rollout_plans.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUT_PLANS_V1_ROLLOUT_PLANS_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUT_PLANS_V1_ROLLOUT_PLANS_CONNECTION_H + +#include "google/cloud/compute/rollout_plans/v1/internal/rollout_plans_retry_traits.h" +#include "google/cloud/compute/rollout_plans/v1/rollout_plans.pb.h" +#include "google/cloud/compute/rollout_plans/v1/rollout_plans_connection_idempotency_policy.h" +#include "google/cloud/backoff_policy.h" +#include "google/cloud/future.h" +#include "google/cloud/internal/retry_policy_impl.h" +#include "google/cloud/no_await_tag.h" +#include "google/cloud/options.h" +#include "google/cloud/polling_policy.h" +#include "google/cloud/status_or.h" +#include "google/cloud/stream_range.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_rollout_plans_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/// The retry policy for `RolloutPlansConnection`. +class RolloutPlansRetryPolicy : public ::google::cloud::RetryPolicy { + public: + /// Creates a new instance of the policy, reset to the initial state. + virtual std::unique_ptr clone() const = 0; +}; + +/** + * A retry policy for `RolloutPlansConnection` based on counting errors. + * + * This policy stops retrying if: + * - An RPC returns a non-transient error. + * - More than a prescribed number of transient failures is detected. + * + * In this class the following status codes are treated as transient errors: + * - [`kUnavailable`](@ref google::cloud::StatusCode) + */ +class RolloutPlansLimitedErrorCountRetryPolicy + : public RolloutPlansRetryPolicy { + public: + /** + * Create an instance that tolerates up to @p maximum_failures transient + * errors. + * + * @note Disable the retry loop by providing an instance of this policy with + * @p maximum_failures == 0. + */ + explicit RolloutPlansLimitedErrorCountRetryPolicy(int maximum_failures) + : impl_(maximum_failures) {} + + RolloutPlansLimitedErrorCountRetryPolicy( + RolloutPlansLimitedErrorCountRetryPolicy&& rhs) noexcept + : RolloutPlansLimitedErrorCountRetryPolicy(rhs.maximum_failures()) {} + RolloutPlansLimitedErrorCountRetryPolicy( + RolloutPlansLimitedErrorCountRetryPolicy const& rhs) noexcept + : RolloutPlansLimitedErrorCountRetryPolicy(rhs.maximum_failures()) {} + + int maximum_failures() const { return impl_.maximum_failures(); } + + bool OnFailure(Status const& status) override { + return impl_.OnFailure(status); + } + bool IsExhausted() const override { return impl_.IsExhausted(); } + bool IsPermanentFailure(Status const& status) const override { + return impl_.IsPermanentFailure(status); + } + std::unique_ptr clone() const override { + return std::make_unique( + maximum_failures()); + } + + // This is provided only for backwards compatibility. + using BaseType = RolloutPlansRetryPolicy; + + private: + google::cloud::internal::LimitedErrorCountRetryPolicy< + compute_rollout_plans_v1_internal::RolloutPlansRetryTraits> + impl_; +}; + +/** + * A retry policy for `RolloutPlansConnection` based on elapsed time. + * + * This policy stops retrying if: + * - An RPC returns a non-transient error. + * - The elapsed time in the retry loop exceeds a prescribed duration. + * + * In this class the following status codes are treated as transient errors: + * - [`kUnavailable`](@ref google::cloud::StatusCode) + */ +class RolloutPlansLimitedTimeRetryPolicy : public RolloutPlansRetryPolicy { + public: + /** + * Constructor given a `std::chrono::duration<>` object. + * + * @tparam DurationRep a placeholder to match the `Rep` tparam for @p + * duration's type. The semantics of this template parameter are + * documented in `std::chrono::duration<>`. In brief, the underlying + * arithmetic type used to store the number of ticks. For our purposes it + * is simply a formal parameter. + * @tparam DurationPeriod a placeholder to match the `Period` tparam for @p + * duration's type. The semantics of this template parameter are + * documented in `std::chrono::duration<>`. In brief, the length of the + * tick in seconds, expressed as a `std::ratio<>`. For our purposes it is + * simply a formal parameter. + * @param maximum_duration the maximum time allowed before the policy expires. + * While the application can express this time in any units they desire, + * the class truncates to milliseconds. + * + * @see https://en.cppreference.com/w/cpp/chrono/duration for more information + * about `std::chrono::duration`. + */ + template + explicit RolloutPlansLimitedTimeRetryPolicy( + std::chrono::duration maximum_duration) + : impl_(maximum_duration) {} + + RolloutPlansLimitedTimeRetryPolicy( + RolloutPlansLimitedTimeRetryPolicy&& rhs) noexcept + : RolloutPlansLimitedTimeRetryPolicy(rhs.maximum_duration()) {} + RolloutPlansLimitedTimeRetryPolicy( + RolloutPlansLimitedTimeRetryPolicy const& rhs) noexcept + : RolloutPlansLimitedTimeRetryPolicy(rhs.maximum_duration()) {} + + std::chrono::milliseconds maximum_duration() const { + return impl_.maximum_duration(); + } + + bool OnFailure(Status const& status) override { + return impl_.OnFailure(status); + } + bool IsExhausted() const override { return impl_.IsExhausted(); } + bool IsPermanentFailure(Status const& status) const override { + return impl_.IsPermanentFailure(status); + } + std::unique_ptr clone() const override { + return std::make_unique( + maximum_duration()); + } + + // This is provided only for backwards compatibility. + using BaseType = RolloutPlansRetryPolicy; + + private: + google::cloud::internal::LimitedTimeRetryPolicy< + compute_rollout_plans_v1_internal::RolloutPlansRetryTraits> + impl_; +}; + +/** + * The `RolloutPlansConnection` object for `RolloutPlansClient`. + * + * This interface defines virtual methods for each of the user-facing overload + * sets in `RolloutPlansClient`. This allows users to inject custom behavior + * (e.g., with a Google Mock object) when writing tests that use objects of type + * `RolloutPlansClient`. + * + * To create a concrete instance, see `MakeRolloutPlansConnection()`. + * + * For mocking, see + * `compute_rollout_plans_v1_mocks::MockRolloutPlansConnection`. + */ +class RolloutPlansConnection { + public: + virtual ~RolloutPlansConnection() = 0; + + virtual Options options() { return Options{}; } + + virtual future> + DeleteRolloutPlan(google::cloud::cpp::compute::rollout_plans::v1:: + DeleteRolloutPlanRequest const& request); + + virtual StatusOr + DeleteRolloutPlan(NoAwaitTag, google::cloud::cpp::compute::rollout_plans::v1:: + DeleteRolloutPlanRequest const& request); + + virtual future> + DeleteRolloutPlan( + google::cloud::cpp::compute::v1::Operation const& operation); + + virtual StatusOr GetRolloutPlan( + google::cloud::cpp::compute::rollout_plans::v1:: + GetRolloutPlanRequest const& request); + + virtual future> + InsertRolloutPlan(google::cloud::cpp::compute::rollout_plans::v1:: + InsertRolloutPlanRequest const& request); + + virtual StatusOr + InsertRolloutPlan(NoAwaitTag, google::cloud::cpp::compute::rollout_plans::v1:: + InsertRolloutPlanRequest const& request); + + virtual future> + InsertRolloutPlan( + google::cloud::cpp::compute::v1::Operation const& operation); + + virtual StreamRange + ListRolloutPlans( + google::cloud::cpp::compute::rollout_plans::v1::ListRolloutPlansRequest + request); +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_rollout_plans_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUT_PLANS_V1_ROLLOUT_PLANS_CONNECTION_H diff --git a/google/cloud/compute/rollout_plans/v1/rollout_plans_connection_idempotency_policy.cc b/google/cloud/compute/rollout_plans/v1/rollout_plans_connection_idempotency_policy.cc new file mode 100644 index 0000000000000..cdab6bc569274 --- /dev/null +++ b/google/cloud/compute/rollout_plans/v1/rollout_plans_connection_idempotency_policy.cc @@ -0,0 +1,69 @@ +// Copyright 2026 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. +// source: google/cloud/compute/rollout_plans/v1/rollout_plans.proto + +#include "google/cloud/compute/rollout_plans/v1/rollout_plans_connection_idempotency_policy.h" +#include + +namespace google { +namespace cloud { +namespace compute_rollout_plans_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +using ::google::cloud::Idempotency; + +RolloutPlansConnectionIdempotencyPolicy:: + ~RolloutPlansConnectionIdempotencyPolicy() = default; + +std::unique_ptr +RolloutPlansConnectionIdempotencyPolicy::clone() const { + return std::make_unique(*this); +} + +Idempotency RolloutPlansConnectionIdempotencyPolicy::DeleteRolloutPlan( + google::cloud::cpp::compute::rollout_plans::v1:: + DeleteRolloutPlanRequest const&) { + return Idempotency::kNonIdempotent; +} + +Idempotency RolloutPlansConnectionIdempotencyPolicy::GetRolloutPlan( + google::cloud::cpp::compute::rollout_plans::v1:: + GetRolloutPlanRequest const&) { + return Idempotency::kIdempotent; +} + +Idempotency RolloutPlansConnectionIdempotencyPolicy::InsertRolloutPlan( + google::cloud::cpp::compute::rollout_plans::v1:: + InsertRolloutPlanRequest const&) { + return Idempotency::kNonIdempotent; +} + +Idempotency RolloutPlansConnectionIdempotencyPolicy::ListRolloutPlans( + google::cloud::cpp::compute::rollout_plans::v1:: + ListRolloutPlansRequest) { // NOLINT + return Idempotency::kIdempotent; +} + +std::unique_ptr +MakeDefaultRolloutPlansConnectionIdempotencyPolicy() { + return std::make_unique(); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_rollout_plans_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/rollout_plans/v1/rollout_plans_connection_idempotency_policy.h b/google/cloud/compute/rollout_plans/v1/rollout_plans_connection_idempotency_policy.h new file mode 100644 index 0000000000000..577db12badf48 --- /dev/null +++ b/google/cloud/compute/rollout_plans/v1/rollout_plans_connection_idempotency_policy.h @@ -0,0 +1,65 @@ +// Copyright 2026 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. +// source: google/cloud/compute/rollout_plans/v1/rollout_plans.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUT_PLANS_V1_ROLLOUT_PLANS_CONNECTION_IDEMPOTENCY_POLICY_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUT_PLANS_V1_ROLLOUT_PLANS_CONNECTION_IDEMPOTENCY_POLICY_H + +#include "google/cloud/compute/rollout_plans/v1/rollout_plans.pb.h" +#include "google/cloud/idempotency.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_rollout_plans_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class RolloutPlansConnectionIdempotencyPolicy { + public: + virtual ~RolloutPlansConnectionIdempotencyPolicy(); + + /// Create a new copy of this object. + virtual std::unique_ptr clone() + const; + + virtual google::cloud::Idempotency DeleteRolloutPlan( + google::cloud::cpp::compute::rollout_plans::v1:: + DeleteRolloutPlanRequest const& request); + + virtual google::cloud::Idempotency GetRolloutPlan( + google::cloud::cpp::compute::rollout_plans::v1:: + GetRolloutPlanRequest const& request); + + virtual google::cloud::Idempotency InsertRolloutPlan( + google::cloud::cpp::compute::rollout_plans::v1:: + InsertRolloutPlanRequest const& request); + + virtual google::cloud::Idempotency ListRolloutPlans( + google::cloud::cpp::compute::rollout_plans::v1::ListRolloutPlansRequest + request); +}; + +std::unique_ptr +MakeDefaultRolloutPlansConnectionIdempotencyPolicy(); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_rollout_plans_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUT_PLANS_V1_ROLLOUT_PLANS_CONNECTION_IDEMPOTENCY_POLICY_H diff --git a/google/cloud/compute/rollout_plans/v1/rollout_plans_options.h b/google/cloud/compute/rollout_plans/v1/rollout_plans_options.h new file mode 100644 index 0000000000000..898c060e66c00 --- /dev/null +++ b/google/cloud/compute/rollout_plans/v1/rollout_plans_options.h @@ -0,0 +1,86 @@ +// Copyright 2026 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. +// source: google/cloud/compute/rollout_plans/v1/rollout_plans.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUT_PLANS_V1_ROLLOUT_PLANS_OPTIONS_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUT_PLANS_V1_ROLLOUT_PLANS_OPTIONS_H + +#include "google/cloud/compute/rollout_plans/v1/rollout_plans_connection.h" +#include "google/cloud/compute/rollout_plans/v1/rollout_plans_connection_idempotency_policy.h" +#include "google/cloud/backoff_policy.h" +#include "google/cloud/options.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_rollout_plans_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/** + * Use with `google::cloud::Options` to configure the retry policy. + * + * @ingroup google-cloud-compute-options + */ +struct RolloutPlansRetryPolicyOption { + using Type = std::shared_ptr; +}; + +/** + * Use with `google::cloud::Options` to configure the backoff policy. + * + * @ingroup google-cloud-compute-options + */ +struct RolloutPlansBackoffPolicyOption { + using Type = std::shared_ptr; +}; + +/** + * Use with `google::cloud::Options` to configure which operations are retried. + * + * @ingroup google-cloud-compute-options + */ +struct RolloutPlansConnectionIdempotencyPolicyOption { + using Type = std::shared_ptr; +}; + +/** + * Use with `google::cloud::Options` to configure the long-running operations + * polling policy. + * + * @ingroup google-cloud-compute-options + */ +struct RolloutPlansPollingPolicyOption { + using Type = std::shared_ptr; +}; + +/** + * The options applicable to RolloutPlans. + * + * @ingroup google-cloud-compute-options + */ +using RolloutPlansPolicyOptionList = + OptionList; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_rollout_plans_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUT_PLANS_V1_ROLLOUT_PLANS_OPTIONS_H diff --git a/google/cloud/compute/rollout_plans/v1/rollout_plans_proto_export.h b/google/cloud/compute/rollout_plans/v1/rollout_plans_proto_export.h new file mode 100644 index 0000000000000..faddcdc1e230f --- /dev/null +++ b/google/cloud/compute/rollout_plans/v1/rollout_plans_proto_export.h @@ -0,0 +1,33 @@ +// Copyright 2026 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_ROLLOUT_PLANS_V1_ROLLOUT_PLANS_PROTO_EXPORT_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUT_PLANS_V1_ROLLOUT_PLANS_PROTO_EXPORT_H + +// IWYU pragma: begin_exports +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_137.pb.h" +// IWYU pragma: end_exports + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUT_PLANS_V1_ROLLOUT_PLANS_PROTO_EXPORT_H diff --git a/google/cloud/compute/rollout_plans/v1/rollout_plans_rest_connection.cc b/google/cloud/compute/rollout_plans/v1/rollout_plans_rest_connection.cc new file mode 100644 index 0000000000000..52e592199d857 --- /dev/null +++ b/google/cloud/compute/rollout_plans/v1/rollout_plans_rest_connection.cc @@ -0,0 +1,59 @@ +// Copyright 2026 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. +// source: google/cloud/compute/rollout_plans/v1/rollout_plans.proto + +#include "google/cloud/compute/rollout_plans/v1/rollout_plans_rest_connection.h" +#include "google/cloud/compute/rollout_plans/v1/internal/rollout_plans_option_defaults.h" +#include "google/cloud/compute/rollout_plans/v1/internal/rollout_plans_rest_connection_impl.h" +#include "google/cloud/compute/rollout_plans/v1/internal/rollout_plans_rest_stub_factory.h" +#include "google/cloud/compute/rollout_plans/v1/internal/rollout_plans_tracing_connection.h" +#include "google/cloud/compute/rollout_plans/v1/rollout_plans_options.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/internal/rest_background_threads_impl.h" +#include "google/cloud/internal/rest_options.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_rollout_plans_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +std::shared_ptr MakeRolloutPlansConnectionRest( + Options options) { + internal::CheckExpectedOptions< + CommonOptionList, RestOptionList, UnifiedCredentialsOptionList, + rest_internal::TargetApiVersionOption, RolloutPlansPolicyOptionList>( + options, __func__); + options = compute_rollout_plans_v1_internal::RolloutPlansDefaultOptions( + std::move(options)); + auto background = std::make_unique< + rest_internal::AutomaticallyCreatedRestBackgroundThreads>(); + auto stub = + compute_rollout_plans_v1_internal::CreateDefaultRolloutPlansRestStub( + options); + return compute_rollout_plans_v1_internal::MakeRolloutPlansTracingConnection( + std::make_shared< + compute_rollout_plans_v1_internal::RolloutPlansRestConnectionImpl>( + std::move(background), std::move(stub), std::move(options))); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_rollout_plans_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/rollout_plans/v1/rollout_plans_rest_connection.h b/google/cloud/compute/rollout_plans/v1/rollout_plans_rest_connection.h new file mode 100644 index 0000000000000..546aaf8a9c292 --- /dev/null +++ b/google/cloud/compute/rollout_plans/v1/rollout_plans_rest_connection.h @@ -0,0 +1,64 @@ +// Copyright 2026 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. +// source: google/cloud/compute/rollout_plans/v1/rollout_plans.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUT_PLANS_V1_ROLLOUT_PLANS_REST_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUT_PLANS_V1_ROLLOUT_PLANS_REST_CONNECTION_H + +#include "google/cloud/compute/rollout_plans/v1/rollout_plans_connection.h" +#include "google/cloud/options.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_rollout_plans_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/** + * A factory function to construct an object of type `RolloutPlansConnection` + * that uses REST over HTTP as transport in lieu of gRPC. REST transport should + * only be used for services that do not support gRPC or if the existing network + * configuration precludes using gRPC. + * + * The returned connection object should not be used directly; instead it + * should be passed as an argument to the constructor of RolloutPlansClient. + * + * The optional @p options argument may be used to configure aspects of the + * returned `RolloutPlansConnection`. Expected options are any of the types in + * the following option lists: + * + * - `google::cloud::CommonOptionList` + * - `google::cloud::RestOptionList` + * - `google::cloud::UnifiedCredentialsOptionList` + * - `google::cloud::compute_rollout_plans_v1::RolloutPlansPolicyOptionList` + * + * @note Unexpected options will be ignored. To log unexpected options instead, + * set `GOOGLE_CLOUD_CPP_ENABLE_CLOG=yes` in the environment. + * + * @param options (optional) Configure the `RolloutPlansConnection` created by + * this function. + */ +std::shared_ptr MakeRolloutPlansConnectionRest( + Options options = {}); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_rollout_plans_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUT_PLANS_V1_ROLLOUT_PLANS_REST_CONNECTION_H diff --git a/google/cloud/compute/rollout_plans/v1/samples/rollout_plans_client_samples.cc b/google/cloud/compute/rollout_plans/v1/samples/rollout_plans_client_samples.cc new file mode 100644 index 0000000000000..dcf50fd4c8c16 --- /dev/null +++ b/google/cloud/compute/rollout_plans/v1/samples/rollout_plans_client_samples.cc @@ -0,0 +1,238 @@ +// Copyright 2026 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. +// source: google/cloud/compute/rollout_plans/v1/rollout_plans.proto + +#include "google/cloud/compute/rollout_plans/v1/rollout_plans_client.h" +#include "google/cloud/compute/rollout_plans/v1/rollout_plans_connection_idempotency_policy.h" +#include "google/cloud/compute/rollout_plans/v1/rollout_plans_options.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/internal/getenv.h" +#include "google/cloud/polling_policy.h" +#include "google/cloud/testing_util/example_driver.h" +#include "google/cloud/universe_domain.h" +#include +#include +#include +#include + +// clang-format off +// main-dox-marker: compute_rollout_plans_v1::RolloutPlansClient +// lro-marker: true +// clang-format on +namespace { + +void SetClientEndpoint(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-endpoint"}; + } + //! [set-client-endpoint] + // This configuration is common with Private Google Access: + // https://cloud.google.com/vpc/docs/private-google-access + auto options = google::cloud::Options{}.set( + "private.googleapis.com"); + auto vpc_client = google::cloud::compute_rollout_plans_v1::RolloutPlansClient( + google::cloud::compute_rollout_plans_v1::MakeRolloutPlansConnectionRest( + options)); + //! [set-client-endpoint] +} + +void SetClientUniverseDomain(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-universe-domain"}; + } + //! [set-client-universe-domain] + google::cloud::Options options; + + // AddUniverseDomainOption interrogates the UnifiedCredentialsOption, if set, + // in the provided Options for the Universe Domain associated with the + // credentials and adds it to the set of Options. + // If no UnifiedCredentialsOption is set, GoogleDefaultCredentials are used. + auto ud_options = google::cloud::AddUniverseDomainOption(std::move(options)); + + if (!ud_options.ok()) throw std::move(ud_options).status(); + auto ud_client = google::cloud::compute_rollout_plans_v1::RolloutPlansClient( + google::cloud::compute_rollout_plans_v1::MakeRolloutPlansConnectionRest( + *ud_options)); + //! [set-client-universe-domain] +} + +//! [custom-idempotency-policy] +class CustomIdempotencyPolicy : public google::cloud::compute_rollout_plans_v1:: + RolloutPlansConnectionIdempotencyPolicy { + public: + ~CustomIdempotencyPolicy() override = default; + std::unique_ptr + clone() const override { + return std::make_unique(*this); + } + // Override inherited functions to define as needed. +}; +//! [custom-idempotency-policy] + +void SetRetryPolicy(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-retry-policy"}; + } + //! [set-retry-policy] + auto options = google::cloud::Options{} + .set( + CustomIdempotencyPolicy().clone()) + .set( + google::cloud::compute_rollout_plans_v1:: + RolloutPlansLimitedErrorCountRetryPolicy(3) + .clone()) + .set( + google::cloud::ExponentialBackoffPolicy( + /*initial_delay=*/std::chrono::milliseconds(200), + /*maximum_delay=*/std::chrono::seconds(45), + /*scaling=*/2.0) + .clone()); + auto connection = + google::cloud::compute_rollout_plans_v1::MakeRolloutPlansConnectionRest( + options); + + // c1 and c2 share the same retry policies + auto c1 = + google::cloud::compute_rollout_plans_v1::RolloutPlansClient(connection); + auto c2 = + google::cloud::compute_rollout_plans_v1::RolloutPlansClient(connection); + + // You can override any of the policies in a new client. This new client + // will share the policies from c1 (or c2) *except* for the retry policy. + auto c3 = google::cloud::compute_rollout_plans_v1::RolloutPlansClient( + connection, + google::cloud::Options{} + .set( + google::cloud::compute_rollout_plans_v1:: + RolloutPlansLimitedTimeRetryPolicy(std::chrono::minutes(5)) + .clone())); + + // You can also override the policies in a single call: + // c3.SomeRpc(..., google::cloud::Options{} + // .set( + // google::cloud::compute_rollout_plans_v1::RolloutPlansLimitedErrorCountRetryPolicy(10).clone())); + //! [set-retry-policy] +} + +void SetPollingPolicy(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-policy-policy"}; + } + //! [set-polling-policy] + + // The polling policy controls how the client waits for long-running + // operations. `GenericPollingPolicy<>` combines existing policies. + // In this case, keep polling until the operation completes (with success + // or error) or 45 minutes, whichever happens first. Initially pause for + // 10 seconds between polling requests, increasing the pause by a factor + // of 4 until it becomes 2 minutes. + auto options = + google::cloud::Options{} + .set( + google::cloud::GenericPollingPolicy< + google::cloud::compute_rollout_plans_v1:: + RolloutPlansRetryPolicyOption::Type, + google::cloud::compute_rollout_plans_v1:: + RolloutPlansBackoffPolicyOption::Type>( + google::cloud::compute_rollout_plans_v1:: + RolloutPlansLimitedTimeRetryPolicy( + /*maximum_duration=*/std::chrono::minutes(45)) + .clone(), + google::cloud::ExponentialBackoffPolicy( + /*initial_delay=*/std::chrono::seconds(10), + /*maximum_delay=*/std::chrono::minutes(2), + /*scaling=*/4.0) + .clone()) + .clone()); + + auto connection = + google::cloud::compute_rollout_plans_v1::MakeRolloutPlansConnectionRest( + options); + + // c1 and c2 share the same polling policies. + auto c1 = + google::cloud::compute_rollout_plans_v1::RolloutPlansClient(connection); + auto c2 = + google::cloud::compute_rollout_plans_v1::RolloutPlansClient(connection); + //! [set-polling-policy] +} + +void WithServiceAccount(std::vector const& argv) { + if (argv.size() != 1 || argv[0] == "--help") { + throw google::cloud::testing_util::Usage{"with-service-account "}; + } + //! [with-service-account] + [](std::string const& keyfile) { + auto is = std::ifstream(keyfile); + is.exceptions(std::ios::badbit); // Minimal error handling in examples + auto contents = std::string(std::istreambuf_iterator(is.rdbuf()), {}); + auto options = + google::cloud::Options{}.set( + google::cloud::MakeServiceAccountCredentials(contents)); + return google::cloud::compute_rollout_plans_v1::RolloutPlansClient( + google::cloud::compute_rollout_plans_v1::MakeRolloutPlansConnectionRest( + options)); + } + //! [with-service-account] + (argv.at(0)); +} + +void AutoRun(std::vector const& argv) { + namespace examples = ::google::cloud::testing_util; + using ::google::cloud::internal::GetEnv; + if (!argv.empty()) throw examples::Usage{"auto"}; + examples::CheckEnvironmentVariablesAreSet( + {"GOOGLE_CLOUD_CPP_TEST_SERVICE_ACCOUNT_KEYFILE"}); + auto const keyfile = + GetEnv("GOOGLE_CLOUD_CPP_TEST_SERVICE_ACCOUNT_KEYFILE").value(); + + std::cout << "\nRunning SetClientEndpoint() example" << std::endl; + SetClientEndpoint({}); + + std::cout << "\nRunning SetRetryPolicy() example" << std::endl; + SetRetryPolicy({}); + + std::cout << "\nRunning SetPollingPolicy() example" << std::endl; + SetPollingPolicy({}); + + std::cout << "\nRunning WithServiceAccount() example" << std::endl; + WithServiceAccount({keyfile}); + + std::cout << "\nRunning SetClientUniverseDomain() example" << std::endl; + SetClientUniverseDomain({}); +} + +} // namespace + +int main(int argc, char* argv[]) { // NOLINT(bugprone-exception-escape) + google::cloud::testing_util::Example example({ + {"set-client-endpoint", SetClientEndpoint}, + {"set-retry-policy", SetRetryPolicy}, + {"set-polling-policy", SetPollingPolicy}, + {"with-service-account", WithServiceAccount}, + {"set-client-universe-domain", SetClientUniverseDomain}, + {"auto", AutoRun}, + }); + return example.Run(argc, argv); +} diff --git a/google/cloud/compute/rollouts/v1/internal/rollouts_option_defaults.cc b/google/cloud/compute/rollouts/v1/internal/rollouts_option_defaults.cc new file mode 100644 index 0000000000000..b074971ffb9eb --- /dev/null +++ b/google/cloud/compute/rollouts/v1/internal/rollouts_option_defaults.cc @@ -0,0 +1,78 @@ +// Copyright 2026 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. +// source: google/cloud/compute/rollouts/v1/rollouts.proto + +#include "google/cloud/compute/rollouts/v1/internal/rollouts_option_defaults.h" +#include "google/cloud/compute/rollouts/v1/rollouts_connection.h" +#include "google/cloud/compute/rollouts/v1/rollouts_options.h" +#include "google/cloud/internal/populate_common_options.h" +#include "google/cloud/internal/populate_grpc_options.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_rollouts_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +namespace { +auto constexpr kBackoffScaling = 2.0; +} // namespace + +Options RolloutsDefaultOptions(Options options) { + options = internal::PopulateCommonOptions( + std::move(options), "GOOGLE_CLOUD_CPP_ROLLOUTS_ENDPOINT", "", + "GOOGLE_CLOUD_CPP_ROLLOUTS_AUTHORITY", "compute.googleapis.com"); + options = internal::PopulateGrpcOptions(std::move(options)); + if (!options.has()) { + options.set( + compute_rollouts_v1::RolloutsLimitedTimeRetryPolicy( + std::chrono::minutes(10)) + .clone()); + } + if (!options.has()) { + options.set( + ExponentialBackoffPolicy( + std::chrono::seconds(0), std::chrono::seconds(1), + std::chrono::minutes(5), kBackoffScaling, kBackoffScaling) + .clone()); + } + if (!options.has()) { + options.set( + GenericPollingPolicy< + compute_rollouts_v1::RolloutsRetryPolicyOption::Type, + compute_rollouts_v1::RolloutsBackoffPolicyOption::Type>( + options.get() + ->clone(), + ExponentialBackoffPolicy(std::chrono::seconds(1), + std::chrono::minutes(5), kBackoffScaling) + .clone()) + .clone()); + } + if (!options.has< + compute_rollouts_v1::RolloutsConnectionIdempotencyPolicyOption>()) { + options.set( + compute_rollouts_v1::MakeDefaultRolloutsConnectionIdempotencyPolicy()); + } + + return options; +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_rollouts_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/rollouts/v1/internal/rollouts_option_defaults.h b/google/cloud/compute/rollouts/v1/internal/rollouts_option_defaults.h new file mode 100644 index 0000000000000..058f140ab5b99 --- /dev/null +++ b/google/cloud/compute/rollouts/v1/internal/rollouts_option_defaults.h @@ -0,0 +1,37 @@ +// Copyright 2026 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. +// source: google/cloud/compute/rollouts/v1/rollouts.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUTS_V1_INTERNAL_ROLLOUTS_OPTION_DEFAULTS_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUTS_V1_INTERNAL_ROLLOUTS_OPTION_DEFAULTS_H + +#include "google/cloud/options.h" +#include "google/cloud/version.h" + +namespace google { +namespace cloud { +namespace compute_rollouts_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +Options RolloutsDefaultOptions(Options options); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_rollouts_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUTS_V1_INTERNAL_ROLLOUTS_OPTION_DEFAULTS_H diff --git a/google/cloud/compute/rollouts/v1/internal/rollouts_rest_connection_impl.cc b/google/cloud/compute/rollouts/v1/internal/rollouts_rest_connection_impl.cc new file mode 100644 index 0000000000000..59421a3f8c885 --- /dev/null +++ b/google/cloud/compute/rollouts/v1/internal/rollouts_rest_connection_impl.cc @@ -0,0 +1,739 @@ +// Copyright 2026 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. +// source: google/cloud/compute/rollouts/v1/rollouts.proto + +#include "google/cloud/compute/rollouts/v1/internal/rollouts_rest_connection_impl.h" +#include "google/cloud/compute/rollouts/v1/internal/rollouts_rest_stub_factory.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/internal/async_rest_long_running_operation_custom.h" +#include "google/cloud/internal/extract_long_running_result.h" +#include "google/cloud/internal/pagination_range.h" +#include "google/cloud/internal/rest_lro_helpers.h" +#include "google/cloud/internal/rest_retry_loop.h" +#include "google/cloud/rest_options.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_rollouts_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +RolloutsRestConnectionImpl::RolloutsRestConnectionImpl( + std::unique_ptr background, + std::shared_ptr stub, + Options options) + : background_(std::move(background)), + stub_(std::move(stub)), + options_(internal::MergeOptions(std::move(options), + RolloutsConnection::options())) {} + +future> +RolloutsRestConnectionImpl::Advance( + google::cloud::cpp::compute::rollouts::v1::AdvanceRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::global_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, request, + [stub = stub_]( + CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::rollouts::v1::AdvanceRequest const& + request) { + return stub->AsyncAdvance(cq, std::move(context), std::move(options), + request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->Advance(request), polling_policy(*current), + __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [request](std::string const& op, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest& r) { + r.set_project(request.project()); + r.set_operation(op); + }, + [request](std::string const& op, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest& r) { + r.set_project(request.project()); + r.set_operation(op); + }); +} + +StatusOr +RolloutsRestConnectionImpl::Advance( + NoAwaitTag, + google::cloud::cpp::compute::rollouts::v1::AdvanceRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->Advance(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::rollouts::v1::AdvanceRequest const& + request) { + return stub_->Advance(rest_context, options, request); + }, + *current, request, __func__); +} + +future> +RolloutsRestConnectionImpl::Advance( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestAwaitLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::global_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, operation, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [operation](std::string const&, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_operation(info.operation); + }, + [operation](std::string const&, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_operation(info.operation); + }); +} + +future> +RolloutsRestConnectionImpl::Cancel( + google::cloud::cpp::compute::rollouts::v1::CancelRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::global_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, request, + [stub = stub_]( + CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::rollouts::v1::CancelRequest const& + request) { + return stub->AsyncCancel(cq, std::move(context), std::move(options), + request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->Cancel(request), polling_policy(*current), + __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [request](std::string const& op, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest& r) { + r.set_project(request.project()); + r.set_operation(op); + }, + [request](std::string const& op, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest& r) { + r.set_project(request.project()); + r.set_operation(op); + }); +} + +StatusOr +RolloutsRestConnectionImpl::Cancel( + NoAwaitTag, + google::cloud::cpp::compute::rollouts::v1::CancelRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->Cancel(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::rollouts::v1::CancelRequest const& + request) { + return stub_->Cancel(rest_context, options, request); + }, + *current, request, __func__); +} + +future> +RolloutsRestConnectionImpl::Cancel( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestAwaitLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::global_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, operation, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [operation](std::string const&, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_operation(info.operation); + }, + [operation](std::string const&, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_operation(info.operation); + }); +} + +future> +RolloutsRestConnectionImpl::DeleteRollout( + google::cloud::cpp::compute::rollouts::v1::DeleteRolloutRequest const& + request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::global_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, request, + [stub = stub_]( + CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::rollouts::v1::DeleteRolloutRequest const& + request) { + return stub->AsyncDeleteRollout(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->DeleteRollout(request), + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [request](std::string const& op, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest& r) { + r.set_project(request.project()); + r.set_operation(op); + }, + [request](std::string const& op, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest& r) { + r.set_project(request.project()); + r.set_operation(op); + }); +} + +StatusOr +RolloutsRestConnectionImpl::DeleteRollout( + NoAwaitTag, + google::cloud::cpp::compute::rollouts::v1::DeleteRolloutRequest const& + request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->DeleteRollout(request), + [this]( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::rollouts::v1::DeleteRolloutRequest const& + request) { + return stub_->DeleteRollout(rest_context, options, request); + }, + *current, request, __func__); +} + +future> +RolloutsRestConnectionImpl::DeleteRollout( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestAwaitLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::global_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, operation, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [operation](std::string const&, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_operation(info.operation); + }, + [operation](std::string const&, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_operation(info.operation); + }); +} + +StatusOr +RolloutsRestConnectionImpl::GetRollout( + google::cloud::cpp::compute::rollouts::v1::GetRolloutRequest const& + request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->GetRollout(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::rollouts::v1::GetRolloutRequest const& + request) { + return stub_->GetRollout(rest_context, options, request); + }, + *current, request, __func__); +} + +StreamRange +RolloutsRestConnectionImpl::ListRollouts( + google::cloud::cpp::compute::rollouts::v1::ListRolloutsRequest request) { + request.clear_page_token(); + auto current = google::cloud::internal::SaveCurrentOptions(); + auto idempotency = idempotency_policy(*current)->ListRollouts(request); + char const* function_name = __func__; + return google::cloud::internal::MakePaginationRange< + StreamRange>( + current, std::move(request), + [idempotency, function_name, stub = stub_, + retry = std::shared_ptr( + retry_policy(*current)), + backoff = std::shared_ptr(backoff_policy(*current))]( + Options const& options, + google::cloud::cpp::compute::rollouts::v1::ListRolloutsRequest const& + r) { + return google::cloud::rest_internal::RestRetryLoop( + retry->clone(), backoff->clone(), idempotency, + [stub](rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::rollouts::v1:: + ListRolloutsRequest const& request) { + return stub->ListRollouts(rest_context, options, request); + }, + options, r, function_name); + }, + [](google::cloud::cpp::compute::v1::RolloutsListResponse r) { + std::vector result( + r.items().size()); + auto& messages = *r.mutable_items(); + std::move(messages.begin(), messages.end(), result.begin()); + return result; + }); +} + +future> +RolloutsRestConnectionImpl::Pause( + google::cloud::cpp::compute::rollouts::v1::PauseRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::global_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, request, + [stub = stub_]( + CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::rollouts::v1::PauseRequest const& + request) { + return stub->AsyncPause(cq, std::move(context), std::move(options), + request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->Pause(request), polling_policy(*current), + __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [request](std::string const& op, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest& r) { + r.set_project(request.project()); + r.set_operation(op); + }, + [request](std::string const& op, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest& r) { + r.set_project(request.project()); + r.set_operation(op); + }); +} + +StatusOr +RolloutsRestConnectionImpl::Pause( + NoAwaitTag, + google::cloud::cpp::compute::rollouts::v1::PauseRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->Pause(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::rollouts::v1::PauseRequest const& + request) { + return stub_->Pause(rest_context, options, request); + }, + *current, request, __func__); +} + +future> +RolloutsRestConnectionImpl::Pause( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestAwaitLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::global_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, operation, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [operation](std::string const&, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_operation(info.operation); + }, + [operation](std::string const&, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_operation(info.operation); + }); +} + +future> +RolloutsRestConnectionImpl::Resume( + google::cloud::cpp::compute::rollouts::v1::ResumeRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::global_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, request, + [stub = stub_]( + CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::rollouts::v1::ResumeRequest const& + request) { + return stub->AsyncResume(cq, std::move(context), std::move(options), + request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->Resume(request), polling_policy(*current), + __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [request](std::string const& op, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest& r) { + r.set_project(request.project()); + r.set_operation(op); + }, + [request](std::string const& op, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest& r) { + r.set_project(request.project()); + r.set_operation(op); + }); +} + +StatusOr +RolloutsRestConnectionImpl::Resume( + NoAwaitTag, + google::cloud::cpp::compute::rollouts::v1::ResumeRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->Resume(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::rollouts::v1::ResumeRequest const& + request) { + return stub_->Resume(rest_context, options, request); + }, + *current, request, __func__); +} + +future> +RolloutsRestConnectionImpl::Resume( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestAwaitLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::global_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, operation, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [operation](std::string const&, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_operation(info.operation); + }, + [operation](std::string const&, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_operation(info.operation); + }); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_rollouts_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/rollouts/v1/internal/rollouts_rest_connection_impl.h b/google/cloud/compute/rollouts/v1/internal/rollouts_rest_connection_impl.h new file mode 100644 index 0000000000000..8985b691b6199 --- /dev/null +++ b/google/cloud/compute/rollouts/v1/internal/rollouts_rest_connection_impl.h @@ -0,0 +1,156 @@ +// Copyright 2026 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. +// source: google/cloud/compute/rollouts/v1/rollouts.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUTS_V1_INTERNAL_ROLLOUTS_REST_CONNECTION_IMPL_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUTS_V1_INTERNAL_ROLLOUTS_REST_CONNECTION_IMPL_H + +#include "google/cloud/compute/global_operations/v1/global_operations.pb.h" +#include "google/cloud/compute/rollouts/v1/internal/rollouts_rest_stub.h" +#include "google/cloud/compute/rollouts/v1/internal/rollouts_retry_traits.h" +#include "google/cloud/compute/rollouts/v1/rollouts_connection.h" +#include "google/cloud/compute/rollouts/v1/rollouts_connection_idempotency_policy.h" +#include "google/cloud/compute/rollouts/v1/rollouts_options.h" +#include "google/cloud/background_threads.h" +#include "google/cloud/backoff_policy.h" +#include "google/cloud/options.h" +#include "google/cloud/status_or.h" +#include "google/cloud/stream_range.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_rollouts_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class RolloutsRestConnectionImpl + : public compute_rollouts_v1::RolloutsConnection { + public: + ~RolloutsRestConnectionImpl() override = default; + + RolloutsRestConnectionImpl( + std::unique_ptr background, + std::shared_ptr stub, + Options options); + + Options options() override { return options_; } + + future> Advance( + google::cloud::cpp::compute::rollouts::v1::AdvanceRequest const& request) + override; + + StatusOr Advance( + NoAwaitTag, + google::cloud::cpp::compute::rollouts::v1::AdvanceRequest const& request) + override; + + future> Advance( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + future> Cancel( + google::cloud::cpp::compute::rollouts::v1::CancelRequest const& request) + override; + + StatusOr Cancel( + NoAwaitTag, + google::cloud::cpp::compute::rollouts::v1::CancelRequest const& request) + override; + + future> Cancel( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + future> DeleteRollout( + google::cloud::cpp::compute::rollouts::v1::DeleteRolloutRequest const& + request) override; + + StatusOr DeleteRollout( + NoAwaitTag, + google::cloud::cpp::compute::rollouts::v1::DeleteRolloutRequest const& + request) override; + + future> DeleteRollout( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + StatusOr GetRollout( + google::cloud::cpp::compute::rollouts::v1::GetRolloutRequest const& + request) override; + + StreamRange ListRollouts( + google::cloud::cpp::compute::rollouts::v1::ListRolloutsRequest request) + override; + + future> Pause( + google::cloud::cpp::compute::rollouts::v1::PauseRequest const& request) + override; + + StatusOr Pause( + NoAwaitTag, + google::cloud::cpp::compute::rollouts::v1::PauseRequest const& request) + override; + + future> Pause( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + future> Resume( + google::cloud::cpp::compute::rollouts::v1::ResumeRequest const& request) + override; + + StatusOr Resume( + NoAwaitTag, + google::cloud::cpp::compute::rollouts::v1::ResumeRequest const& request) + override; + + future> Resume( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + private: + static std::unique_ptr retry_policy( + Options const& options) { + return options.get() + ->clone(); + } + + static std::unique_ptr backoff_policy(Options const& options) { + return options.get() + ->clone(); + } + + static std::unique_ptr< + compute_rollouts_v1::RolloutsConnectionIdempotencyPolicy> + idempotency_policy(Options const& options) { + return options + .get() + ->clone(); + } + + static std::unique_ptr polling_policy(Options const& options) { + return options.get() + ->clone(); + } + + std::unique_ptr background_; + std::shared_ptr stub_; + Options options_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_rollouts_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUTS_V1_INTERNAL_ROLLOUTS_REST_CONNECTION_IMPL_H diff --git a/google/cloud/compute/rollouts/v1/internal/rollouts_rest_logging_decorator.cc b/google/cloud/compute/rollouts/v1/internal/rollouts_rest_logging_decorator.cc new file mode 100644 index 0000000000000..6107435c8c3f5 --- /dev/null +++ b/google/cloud/compute/rollouts/v1/internal/rollouts_rest_logging_decorator.cc @@ -0,0 +1,271 @@ +// Copyright 2026 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. +// source: google/cloud/compute/rollouts/v1/rollouts.proto + +#include "google/cloud/compute/rollouts/v1/internal/rollouts_rest_logging_decorator.h" +#include "google/cloud/internal/log_wrapper.h" +#include "google/cloud/status_or.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_rollouts_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +RolloutsRestLogging::RolloutsRestLogging( + std::shared_ptr child, TracingOptions tracing_options, + std::set components) + : child_(std::move(child)), + tracing_options_(std::move(tracing_options)), + components_(std::move(components)) {} + +future> +RolloutsRestLogging::AsyncAdvance( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::rollouts::v1::AdvanceRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::rollouts::v1::AdvanceRequest const& + request) { + return child_->AsyncAdvance(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +StatusOr +RolloutsRestLogging::Advance( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::rollouts::v1::AdvanceRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::rollouts::v1::AdvanceRequest const& + request) { + return child_->Advance(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +future> +RolloutsRestLogging::AsyncCancel( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::rollouts::v1::CancelRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::rollouts::v1::CancelRequest const& + request) { + return child_->AsyncCancel(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +StatusOr +RolloutsRestLogging::Cancel( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::rollouts::v1::CancelRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::rollouts::v1::CancelRequest const& + request) { + return child_->Cancel(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +future> +RolloutsRestLogging::AsyncDeleteRollout( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::rollouts::v1::DeleteRolloutRequest const& + request) { + return google::cloud::internal::LogWrapper( + [this]( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::rollouts::v1::DeleteRolloutRequest const& + request) { + return child_->AsyncDeleteRollout(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +StatusOr +RolloutsRestLogging::DeleteRollout( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::rollouts::v1::DeleteRolloutRequest const& + request) { + return google::cloud::internal::LogWrapper( + [this]( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::rollouts::v1::DeleteRolloutRequest const& + request) { + return child_->DeleteRollout(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +StatusOr +RolloutsRestLogging::GetRollout( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::rollouts::v1::GetRolloutRequest const& + request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::rollouts::v1::GetRolloutRequest const& + request) { + return child_->GetRollout(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +StatusOr +RolloutsRestLogging::ListRollouts( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::rollouts::v1::ListRolloutsRequest const& + request) { + return google::cloud::internal::LogWrapper( + [this]( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::rollouts::v1::ListRolloutsRequest const& + request) { + return child_->ListRollouts(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +future> +RolloutsRestLogging::AsyncPause( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::rollouts::v1::PauseRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::rollouts::v1::PauseRequest const& + request) { + return child_->AsyncPause(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +StatusOr RolloutsRestLogging::Pause( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::rollouts::v1::PauseRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::rollouts::v1::PauseRequest const& + request) { + return child_->Pause(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +future> +RolloutsRestLogging::AsyncResume( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::rollouts::v1::ResumeRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::rollouts::v1::ResumeRequest const& + request) { + return child_->AsyncResume(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +StatusOr +RolloutsRestLogging::Resume( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::rollouts::v1::ResumeRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::rollouts::v1::ResumeRequest const& + request) { + return child_->Resume(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +future> +RolloutsRestLogging::AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) { + return child_->AsyncGetOperation(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +future RolloutsRestLogging::AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) { + return child_->AsyncCancelOperation(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_rollouts_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/rollouts/v1/internal/rollouts_rest_logging_decorator.h b/google/cloud/compute/rollouts/v1/internal/rollouts_rest_logging_decorator.h new file mode 100644 index 0000000000000..0c0fed33ec6a8 --- /dev/null +++ b/google/cloud/compute/rollouts/v1/internal/rollouts_rest_logging_decorator.h @@ -0,0 +1,149 @@ +// Copyright 2026 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. +// source: google/cloud/compute/rollouts/v1/rollouts.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUTS_V1_INTERNAL_ROLLOUTS_REST_LOGGING_DECORATOR_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUTS_V1_INTERNAL_ROLLOUTS_REST_LOGGING_DECORATOR_H + +#include "google/cloud/compute/global_operations/v1/global_operations.pb.h" +#include "google/cloud/compute/rollouts/v1/internal/rollouts_rest_stub.h" +#include "google/cloud/compute/rollouts/v1/rollouts.pb.h" +#include "google/cloud/future.h" +#include "google/cloud/internal/rest_context.h" +#include "google/cloud/tracing_options.h" +#include "google/cloud/version.h" +#include +#include +#include + +namespace google { +namespace cloud { +namespace compute_rollouts_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class RolloutsRestLogging : public RolloutsRestStub { + public: + ~RolloutsRestLogging() override = default; + RolloutsRestLogging(std::shared_ptr child, + TracingOptions tracing_options, + std::set components); + + future> AsyncAdvance( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::rollouts::v1::AdvanceRequest const& request) + override; + + StatusOr Advance( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::rollouts::v1::AdvanceRequest const& request) + override; + + future> AsyncCancel( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::rollouts::v1::CancelRequest const& request) + override; + + StatusOr Cancel( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::rollouts::v1::CancelRequest const& request) + override; + + future> + AsyncDeleteRollout( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::rollouts::v1::DeleteRolloutRequest const& + request) override; + + StatusOr DeleteRollout( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::rollouts::v1::DeleteRolloutRequest const& + request) override; + + StatusOr GetRollout( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::rollouts::v1::GetRolloutRequest const& + request) override; + + StatusOr ListRollouts( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::rollouts::v1::ListRolloutsRequest const& + request) override; + + future> AsyncPause( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::rollouts::v1::PauseRequest const& request) + override; + + StatusOr Pause( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::rollouts::v1::PauseRequest const& request) + override; + + future> AsyncResume( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::rollouts::v1::ResumeRequest const& request) + override; + + StatusOr Resume( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::rollouts::v1::ResumeRequest const& request) + override; + + future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) override; + + future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) override; + + private: + std::shared_ptr child_; + TracingOptions tracing_options_; + std::set components_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_rollouts_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUTS_V1_INTERNAL_ROLLOUTS_REST_LOGGING_DECORATOR_H diff --git a/google/cloud/compute/rollouts/v1/internal/rollouts_rest_metadata_decorator.cc b/google/cloud/compute/rollouts/v1/internal/rollouts_rest_metadata_decorator.cc new file mode 100644 index 0000000000000..b1b09ac695777 --- /dev/null +++ b/google/cloud/compute/rollouts/v1/internal/rollouts_rest_metadata_decorator.cc @@ -0,0 +1,189 @@ +// Copyright 2026 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. +// source: google/cloud/compute/rollouts/v1/rollouts.proto + +#include "google/cloud/compute/rollouts/v1/internal/rollouts_rest_metadata_decorator.h" +#include "google/cloud/internal/api_client_header.h" +#include "google/cloud/internal/rest_set_metadata.h" +#include "google/cloud/status_or.h" +#include "absl/strings/str_cat.h" +#include "absl/strings/str_format.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_rollouts_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +RolloutsRestMetadata::RolloutsRestMetadata( + std::shared_ptr child, std::string api_client_header) + : child_(std::move(child)), + api_client_header_( + api_client_header.empty() + ? google::cloud::internal::GeneratedLibClientHeader() + : std::move(api_client_header)) {} + +future> +RolloutsRestMetadata::AsyncAdvance( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::rollouts::v1::AdvanceRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncAdvance(cq, std::move(rest_context), std::move(options), + request); +} + +StatusOr +RolloutsRestMetadata::Advance( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::rollouts::v1::AdvanceRequest const& request) { + SetMetadata(rest_context, options); + return child_->Advance(rest_context, options, request); +} + +future> +RolloutsRestMetadata::AsyncCancel( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::rollouts::v1::CancelRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncCancel(cq, std::move(rest_context), std::move(options), + request); +} + +StatusOr +RolloutsRestMetadata::Cancel( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::rollouts::v1::CancelRequest const& request) { + SetMetadata(rest_context, options); + return child_->Cancel(rest_context, options, request); +} + +future> +RolloutsRestMetadata::AsyncDeleteRollout( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::rollouts::v1::DeleteRolloutRequest const& + request) { + SetMetadata(*rest_context, *options); + return child_->AsyncDeleteRollout(cq, std::move(rest_context), + std::move(options), request); +} + +StatusOr +RolloutsRestMetadata::DeleteRollout( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::rollouts::v1::DeleteRolloutRequest const& + request) { + SetMetadata(rest_context, options); + return child_->DeleteRollout(rest_context, options, request); +} + +StatusOr +RolloutsRestMetadata::GetRollout( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::rollouts::v1::GetRolloutRequest const& + request) { + SetMetadata(rest_context, options); + return child_->GetRollout(rest_context, options, request); +} + +StatusOr +RolloutsRestMetadata::ListRollouts( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::rollouts::v1::ListRolloutsRequest const& + request) { + SetMetadata(rest_context, options); + return child_->ListRollouts(rest_context, options, request); +} + +future> +RolloutsRestMetadata::AsyncPause( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::rollouts::v1::PauseRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncPause(cq, std::move(rest_context), std::move(options), + request); +} + +StatusOr +RolloutsRestMetadata::Pause( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::rollouts::v1::PauseRequest const& request) { + SetMetadata(rest_context, options); + return child_->Pause(rest_context, options, request); +} + +future> +RolloutsRestMetadata::AsyncResume( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::rollouts::v1::ResumeRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncResume(cq, std::move(rest_context), std::move(options), + request); +} + +StatusOr +RolloutsRestMetadata::Resume( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::rollouts::v1::ResumeRequest const& request) { + SetMetadata(rest_context, options); + return child_->Resume(rest_context, options, request); +} + +future> +RolloutsRestMetadata::AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncGetOperation(cq, std::move(rest_context), + std::move(options), request); +} + +future RolloutsRestMetadata::AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncCancelOperation(cq, std::move(rest_context), + std::move(options), request); +} + +void RolloutsRestMetadata::SetMetadata(rest_internal::RestContext& rest_context, + Options const& options, + std::vector const& params) { + google::cloud::rest_internal::SetMetadata(rest_context, options, params, + api_client_header_); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_rollouts_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/rollouts/v1/internal/rollouts_rest_metadata_decorator.h b/google/cloud/compute/rollouts/v1/internal/rollouts_rest_metadata_decorator.h new file mode 100644 index 0000000000000..5914583d3697d --- /dev/null +++ b/google/cloud/compute/rollouts/v1/internal/rollouts_rest_metadata_decorator.h @@ -0,0 +1,153 @@ +// Copyright 2026 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. +// source: google/cloud/compute/rollouts/v1/rollouts.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUTS_V1_INTERNAL_ROLLOUTS_REST_METADATA_DECORATOR_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUTS_V1_INTERNAL_ROLLOUTS_REST_METADATA_DECORATOR_H + +#include "google/cloud/compute/global_operations/v1/global_operations.pb.h" +#include "google/cloud/compute/rollouts/v1/internal/rollouts_rest_stub.h" +#include "google/cloud/compute/rollouts/v1/rollouts.pb.h" +#include "google/cloud/future.h" +#include "google/cloud/rest_options.h" +#include "google/cloud/version.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_rollouts_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class RolloutsRestMetadata : public RolloutsRestStub { + public: + ~RolloutsRestMetadata() override = default; + explicit RolloutsRestMetadata(std::shared_ptr child, + std::string api_client_header = ""); + + google::cloud::future> + AsyncAdvance( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::rollouts::v1::AdvanceRequest const& request) + override; + + StatusOr Advance( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::rollouts::v1::AdvanceRequest const& request) + override; + + google::cloud::future> + AsyncCancel( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::rollouts::v1::CancelRequest const& request) + override; + + StatusOr Cancel( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::rollouts::v1::CancelRequest const& request) + override; + + google::cloud::future> + AsyncDeleteRollout( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::rollouts::v1::DeleteRolloutRequest const& + request) override; + + StatusOr DeleteRollout( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::rollouts::v1::DeleteRolloutRequest const& + request) override; + + StatusOr GetRollout( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::rollouts::v1::GetRolloutRequest const& + request) override; + + StatusOr ListRollouts( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::rollouts::v1::ListRolloutsRequest const& + request) override; + + google::cloud::future> + AsyncPause( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::rollouts::v1::PauseRequest const& request) + override; + + StatusOr Pause( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::rollouts::v1::PauseRequest const& request) + override; + + google::cloud::future> + AsyncResume( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::rollouts::v1::ResumeRequest const& request) + override; + + StatusOr Resume( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::rollouts::v1::ResumeRequest const& request) + override; + + google::cloud::future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) override; + + google::cloud::future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) override; + + private: + void SetMetadata(rest_internal::RestContext& rest_context, + Options const& options, + std::vector const& params = {}); + + std::shared_ptr child_; + std::string api_client_header_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_rollouts_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUTS_V1_INTERNAL_ROLLOUTS_REST_METADATA_DECORATOR_H diff --git a/google/cloud/compute/rollouts/v1/internal/rollouts_rest_stub.cc b/google/cloud/compute/rollouts/v1/internal/rollouts_rest_stub.cc new file mode 100644 index 0000000000000..817bb733e3b2b --- /dev/null +++ b/google/cloud/compute/rollouts/v1/internal/rollouts_rest_stub.cc @@ -0,0 +1,400 @@ +// Copyright 2026 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. +// source: google/cloud/compute/rollouts/v1/rollouts.proto + +#include "google/cloud/compute/rollouts/v1/internal/rollouts_rest_stub.h" +#include "google/cloud/compute/global_operations/v1/global_operations.pb.h" +#include "google/cloud/compute/rollouts/v1/rollouts.pb.h" +#include "google/cloud/common_options.h" +#include "google/cloud/internal/rest_stub_helpers.h" +#include "google/cloud/status_or.h" +#include "absl/strings/str_cat.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_rollouts_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +DefaultRolloutsRestStub::DefaultRolloutsRestStub(Options options) + : service_(rest_internal::MakePooledRestClient( + options.get(), options)), + operations_(rest_internal::MakePooledRestClient( + options.get(), options)), + options_(std::move(options)) {} + +DefaultRolloutsRestStub::DefaultRolloutsRestStub( + std::shared_ptr service, + std::shared_ptr operations, Options options) + : service_(std::move(service)), + operations_(std::move(operations)), + options_(std::move(options)) {} + +future> +DefaultRolloutsRestStub::AsyncAdvance( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::rollouts::v1::AdvanceRequest const& request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto service, auto request, auto rest_context, auto options) { + std::vector> query_params; + p.set_value( + rest_internal::Post( + *service, *rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", *options), + "/", "projects", "/", request.project(), "/", + "global", "/", "rollouts", "/", request.rollout(), + "/", "advance"), + std::move(query_params))); + }, + std::move(p), + service_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +StatusOr +DefaultRolloutsRestStub::Advance( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::rollouts::v1::AdvanceRequest const& request) { + std::vector> query_params; + return rest_internal::Post( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "global", "/", + "rollouts", "/", request.rollout(), "/", "advance"), + std::move(query_params)); +} + +future> +DefaultRolloutsRestStub::AsyncCancel( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::rollouts::v1::CancelRequest const& request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto service, auto request, auto rest_context, auto options) { + std::vector> query_params; + p.set_value( + rest_internal::Patch( + *service, *rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", *options), + "/", "projects", "/", request.project(), "/", + "global", "/", "rollouts", "/", request.rollout()), + std::move(query_params))); + }, + std::move(p), + service_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +StatusOr +DefaultRolloutsRestStub::Cancel( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::rollouts::v1::CancelRequest const& request) { + std::vector> query_params; + return rest_internal::Patch( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "global", "/", + "rollouts", "/", request.rollout()), + std::move(query_params)); +} + +future> +DefaultRolloutsRestStub::AsyncDeleteRollout( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::rollouts::v1::DeleteRolloutRequest const& + request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto service, auto request, auto rest_context, auto options) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + p.set_value( + rest_internal::Delete( + *service, *rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", *options), + "/", "projects", "/", request.project(), "/", + "global", "/", "rollouts", "/", request.rollout()), + std::move(query_params))); + }, + std::move(p), + service_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +StatusOr +DefaultRolloutsRestStub::DeleteRollout( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::rollouts::v1::DeleteRolloutRequest const& + request) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Delete( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "global", "/", + "rollouts", "/", request.rollout()), + std::move(query_params)); +} + +StatusOr +DefaultRolloutsRestStub::GetRollout( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::rollouts::v1::GetRolloutRequest const& + request) { + std::vector> query_params; + return rest_internal::Get( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "global", "/", + "rollouts", "/", request.rollout()), + std::move(query_params)); +} + +StatusOr +DefaultRolloutsRestStub::ListRollouts( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::rollouts::v1::ListRolloutsRequest const& + request) { + std::vector> query_params; + query_params.push_back({"filter", request.filter()}); + query_params.push_back( + {"max_results", std::to_string(request.max_results())}); + query_params.push_back({"order_by", request.order_by()}); + query_params.push_back({"page_token", request.page_token()}); + query_params.push_back({"return_partial_success", + (request.return_partial_success() ? "1" : "0")}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Get< + google::cloud::cpp::compute::v1::RolloutsListResponse>( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "global", "/", + "rollouts"), + std::move(query_params)); +} + +future> +DefaultRolloutsRestStub::AsyncPause( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::rollouts::v1::PauseRequest const& request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto service, auto request, auto rest_context, auto options) { + std::vector> query_params; + p.set_value( + rest_internal::Post( + *service, *rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", *options), + "/", "projects", "/", request.project(), "/", + "global", "/", "rollouts", "/", request.rollout(), + "/", "pause"), + std::move(query_params))); + }, + std::move(p), + service_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +StatusOr +DefaultRolloutsRestStub::Pause( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::rollouts::v1::PauseRequest const& request) { + std::vector> query_params; + return rest_internal::Post( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "global", "/", + "rollouts", "/", request.rollout(), "/", "pause"), + std::move(query_params)); +} + +future> +DefaultRolloutsRestStub::AsyncResume( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::rollouts::v1::ResumeRequest const& request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto service, auto request, auto rest_context, auto options) { + std::vector> query_params; + p.set_value( + rest_internal::Post( + *service, *rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", *options), + "/", "projects", "/", request.project(), "/", + "global", "/", "rollouts", "/", request.rollout(), + "/", "resume"), + std::move(query_params))); + }, + std::move(p), + service_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +StatusOr +DefaultRolloutsRestStub::Resume( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::rollouts::v1::ResumeRequest const& request) { + std::vector> query_params; + return rest_internal::Post( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "global", "/", + "rollouts", "/", request.rollout(), "/", "resume"), + std::move(query_params)); +} + +future> +DefaultRolloutsRestStub::AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto operations, auto request, auto rest_context, + auto options) { + p.set_value( + rest_internal::Get( + *operations, *rest_context, request, false, + absl::StrCat("/compute/", + rest_internal::DetermineApiVersion("v1", *options), + "/projects/", request.project(), + "/global/operations/", request.operation()))); + }, + std::move(p), + operations_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +future DefaultRolloutsRestStub::AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) { + promise> p; + future> f = p.get_future(); + std::thread t{ + [](auto p, auto operations, auto request, auto rest_context, + auto options) { + p.set_value(rest_internal::Post( + *operations, *rest_context, request, false, + absl::StrCat("/compute/", + rest_internal::DetermineApiVersion("v1", *options), + "/projects/", request.project(), "/global/operations/", + request.operation()))); + }, + std::move(p), + operations_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get().status(); + }); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_rollouts_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/rollouts/v1/internal/rollouts_rest_stub.h b/google/cloud/compute/rollouts/v1/internal/rollouts_rest_stub.h new file mode 100644 index 0000000000000..534d348940e13 --- /dev/null +++ b/google/cloud/compute/rollouts/v1/internal/rollouts_rest_stub.h @@ -0,0 +1,252 @@ +// Copyright 2026 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. +// source: google/cloud/compute/rollouts/v1/rollouts.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUTS_V1_INTERNAL_ROLLOUTS_REST_STUB_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUTS_V1_INTERNAL_ROLLOUTS_REST_STUB_H + +#include "google/cloud/compute/global_operations/v1/global_operations.pb.h" +#include "google/cloud/compute/rollouts/v1/rollouts.pb.h" +#include "google/cloud/completion_queue.h" +#include "google/cloud/internal/rest_client.h" +#include "google/cloud/internal/rest_context.h" +#include "google/cloud/status_or.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_rollouts_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class RolloutsRestStub { + public: + virtual ~RolloutsRestStub() = default; + + virtual future> + AsyncAdvance( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::rollouts::v1::AdvanceRequest const& + request) = 0; + + virtual StatusOr Advance( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::rollouts::v1::AdvanceRequest const& + request) = 0; + + virtual future> + AsyncCancel( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::rollouts::v1::CancelRequest const& + request) = 0; + + virtual StatusOr Cancel( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::rollouts::v1::CancelRequest const& + request) = 0; + + virtual future> + AsyncDeleteRollout( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::rollouts::v1::DeleteRolloutRequest const& + request) = 0; + + virtual StatusOr DeleteRollout( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::rollouts::v1::DeleteRolloutRequest const& + request) = 0; + + virtual StatusOr GetRollout( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::rollouts::v1::GetRolloutRequest const& + request) = 0; + + virtual StatusOr + ListRollouts( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::rollouts::v1::ListRolloutsRequest const& + request) = 0; + + virtual future> + AsyncPause( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::rollouts::v1::PauseRequest const& + request) = 0; + + virtual StatusOr Pause( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::rollouts::v1::PauseRequest const& + request) = 0; + + virtual future> + AsyncResume( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::rollouts::v1::ResumeRequest const& + request) = 0; + + virtual StatusOr Resume( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::rollouts::v1::ResumeRequest const& + request) = 0; + + virtual future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) = 0; + + virtual future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) = 0; +}; + +class DefaultRolloutsRestStub : public RolloutsRestStub { + public: + ~DefaultRolloutsRestStub() override = default; + + explicit DefaultRolloutsRestStub(Options options); + DefaultRolloutsRestStub(std::shared_ptr service, + std::shared_ptr operations, + Options options); + + future> AsyncAdvance( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::rollouts::v1::AdvanceRequest const& request) + override; + + StatusOr Advance( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::rollouts::v1::AdvanceRequest const& request) + override; + + future> AsyncCancel( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::rollouts::v1::CancelRequest const& request) + override; + + StatusOr Cancel( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::rollouts::v1::CancelRequest const& request) + override; + + future> + AsyncDeleteRollout( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::rollouts::v1::DeleteRolloutRequest const& + request) override; + + StatusOr DeleteRollout( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::rollouts::v1::DeleteRolloutRequest const& + request) override; + + StatusOr GetRollout( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::rollouts::v1::GetRolloutRequest const& + request) override; + + StatusOr ListRollouts( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::rollouts::v1::ListRolloutsRequest const& + request) override; + + future> AsyncPause( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::rollouts::v1::PauseRequest const& request) + override; + + StatusOr Pause( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::rollouts::v1::PauseRequest const& request) + override; + + future> AsyncResume( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::rollouts::v1::ResumeRequest const& request) + override; + + StatusOr Resume( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::rollouts::v1::ResumeRequest const& request) + override; + + future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) override; + + future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) override; + + private: + std::shared_ptr service_; + std::shared_ptr operations_; + Options options_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_rollouts_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUTS_V1_INTERNAL_ROLLOUTS_REST_STUB_H diff --git a/google/cloud/compute/rollouts/v1/internal/rollouts_rest_stub_factory.cc b/google/cloud/compute/rollouts/v1/internal/rollouts_rest_stub_factory.cc new file mode 100644 index 0000000000000..07cc4ebb6bd05 --- /dev/null +++ b/google/cloud/compute/rollouts/v1/internal/rollouts_rest_stub_factory.cc @@ -0,0 +1,56 @@ +// Copyright 2026 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. +// source: google/cloud/compute/rollouts/v1/rollouts.proto + +#include "google/cloud/compute/rollouts/v1/internal/rollouts_rest_stub_factory.h" +#include "google/cloud/compute/rollouts/v1/internal/rollouts_rest_logging_decorator.h" +#include "google/cloud/compute/rollouts/v1/internal/rollouts_rest_metadata_decorator.h" +#include "google/cloud/compute/rollouts/v1/internal/rollouts_rest_stub.h" +#include "google/cloud/common_options.h" +#include "google/cloud/internal/algorithm.h" +#include "google/cloud/internal/populate_rest_options.h" +#include "google/cloud/log.h" +#include "google/cloud/options.h" +#include "google/cloud/rest_options.h" +#include "absl/strings/match.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_rollouts_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +std::shared_ptr CreateDefaultRolloutsRestStub( + Options const& options) { + auto opts = internal::PopulateRestOptions(options); + std::shared_ptr stub = + std::make_shared(std::move(opts)); + stub = std::make_shared(std::move(stub)); + if (internal::Contains(options.get(), "rpc")) { + GCP_LOG(INFO) << "Enabled logging for REST rpc calls"; + stub = std::make_shared( + std::move(stub), options.get(), + options.get()); + } + return stub; +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_rollouts_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/rollouts/v1/internal/rollouts_rest_stub_factory.h b/google/cloud/compute/rollouts/v1/internal/rollouts_rest_stub_factory.h new file mode 100644 index 0000000000000..929df4ee5ed9c --- /dev/null +++ b/google/cloud/compute/rollouts/v1/internal/rollouts_rest_stub_factory.h @@ -0,0 +1,40 @@ +// Copyright 2026 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. +// source: google/cloud/compute/rollouts/v1/rollouts.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUTS_V1_INTERNAL_ROLLOUTS_REST_STUB_FACTORY_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUTS_V1_INTERNAL_ROLLOUTS_REST_STUB_FACTORY_H + +#include "google/cloud/compute/rollouts/v1/internal/rollouts_rest_stub.h" +#include "google/cloud/options.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_rollouts_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +std::shared_ptr CreateDefaultRolloutsRestStub( + Options const& options); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_rollouts_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUTS_V1_INTERNAL_ROLLOUTS_REST_STUB_FACTORY_H diff --git a/google/cloud/compute/rollouts/v1/internal/rollouts_retry_traits.h b/google/cloud/compute/rollouts/v1/internal/rollouts_retry_traits.h new file mode 100644 index 0000000000000..1bc5f4783f88b --- /dev/null +++ b/google/cloud/compute/rollouts/v1/internal/rollouts_retry_traits.h @@ -0,0 +1,43 @@ +// Copyright 2026 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. +// source: google/cloud/compute/rollouts/v1/rollouts.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUTS_V1_INTERNAL_ROLLOUTS_RETRY_TRAITS_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUTS_V1_INTERNAL_ROLLOUTS_RETRY_TRAITS_H + +#include "google/cloud/status.h" +#include "google/cloud/version.h" + +namespace google { +namespace cloud { +namespace compute_rollouts_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/// Define the gRPC status code semantics for retrying requests. +struct RolloutsRetryTraits { + static bool IsPermanentFailure(google::cloud::Status const& status) { + return status.code() != StatusCode::kOk && + status.code() != StatusCode::kUnavailable; + } +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_rollouts_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUTS_V1_INTERNAL_ROLLOUTS_RETRY_TRAITS_H diff --git a/google/cloud/compute/rollouts/v1/internal/rollouts_sources.cc b/google/cloud/compute/rollouts/v1/internal/rollouts_sources.cc new file mode 100644 index 0000000000000..b1ec6a4c5a818 --- /dev/null +++ b/google/cloud/compute/rollouts/v1/internal/rollouts_sources.cc @@ -0,0 +1,31 @@ +// Copyright 2026 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. +// source: google/cloud/compute/rollouts/v1/rollouts.proto + +// NOLINTBEGIN(bugprone-suspicious-include) +#include "google/cloud/compute/rollouts/v1/internal/rollouts_option_defaults.cc" +#include "google/cloud/compute/rollouts/v1/internal/rollouts_rest_connection_impl.cc" +#include "google/cloud/compute/rollouts/v1/internal/rollouts_rest_logging_decorator.cc" +#include "google/cloud/compute/rollouts/v1/internal/rollouts_rest_metadata_decorator.cc" +#include "google/cloud/compute/rollouts/v1/internal/rollouts_rest_stub.cc" +#include "google/cloud/compute/rollouts/v1/internal/rollouts_rest_stub_factory.cc" +#include "google/cloud/compute/rollouts/v1/internal/rollouts_tracing_connection.cc" +#include "google/cloud/compute/rollouts/v1/rollouts_client.cc" +#include "google/cloud/compute/rollouts/v1/rollouts_connection.cc" +#include "google/cloud/compute/rollouts/v1/rollouts_connection_idempotency_policy.cc" +#include "google/cloud/compute/rollouts/v1/rollouts_rest_connection.cc" +// NOLINTEND(bugprone-suspicious-include) diff --git a/google/cloud/compute/rollouts/v1/internal/rollouts_tracing_connection.cc b/google/cloud/compute/rollouts/v1/internal/rollouts_tracing_connection.cc new file mode 100644 index 0000000000000..cf49368200ff6 --- /dev/null +++ b/google/cloud/compute/rollouts/v1/internal/rollouts_tracing_connection.cc @@ -0,0 +1,209 @@ +// Copyright 2026 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. +// source: google/cloud/compute/rollouts/v1/rollouts.proto + +#include "google/cloud/compute/rollouts/v1/internal/rollouts_tracing_connection.h" +#include "google/cloud/internal/opentelemetry.h" +#include "google/cloud/internal/traced_stream_range.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_rollouts_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +RolloutsTracingConnection::RolloutsTracingConnection( + std::shared_ptr child) + : child_(std::move(child)) {} + +future> +RolloutsTracingConnection::Advance( + google::cloud::cpp::compute::rollouts::v1::AdvanceRequest const& request) { + auto span = + internal::MakeSpan("compute_rollouts_v1::RolloutsConnection::Advance"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), child_->Advance(request)); +} + +StatusOr +RolloutsTracingConnection::Advance( + NoAwaitTag, + google::cloud::cpp::compute::rollouts::v1::AdvanceRequest const& request) { + auto span = + internal::MakeSpan("compute_rollouts_v1::RolloutsConnection::Advance"); + opentelemetry::trace::Scope scope(span); + return internal::EndSpan(*span, child_->Advance(NoAwaitTag{}, request)); +} + +future> +RolloutsTracingConnection::Advance( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto span = + internal::MakeSpan("compute_rollouts_v1::RolloutsConnection::Advance"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), child_->Advance(operation)); +} + +future> +RolloutsTracingConnection::Cancel( + google::cloud::cpp::compute::rollouts::v1::CancelRequest const& request) { + auto span = + internal::MakeSpan("compute_rollouts_v1::RolloutsConnection::Cancel"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), child_->Cancel(request)); +} + +StatusOr +RolloutsTracingConnection::Cancel( + NoAwaitTag, + google::cloud::cpp::compute::rollouts::v1::CancelRequest const& request) { + auto span = + internal::MakeSpan("compute_rollouts_v1::RolloutsConnection::Cancel"); + opentelemetry::trace::Scope scope(span); + return internal::EndSpan(*span, child_->Cancel(NoAwaitTag{}, request)); +} + +future> +RolloutsTracingConnection::Cancel( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto span = + internal::MakeSpan("compute_rollouts_v1::RolloutsConnection::Cancel"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), child_->Cancel(operation)); +} + +future> +RolloutsTracingConnection::DeleteRollout( + google::cloud::cpp::compute::rollouts::v1::DeleteRolloutRequest const& + request) { + auto span = internal::MakeSpan( + "compute_rollouts_v1::RolloutsConnection::DeleteRollout"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), child_->DeleteRollout(request)); +} + +StatusOr +RolloutsTracingConnection::DeleteRollout( + NoAwaitTag, + google::cloud::cpp::compute::rollouts::v1::DeleteRolloutRequest const& + request) { + auto span = internal::MakeSpan( + "compute_rollouts_v1::RolloutsConnection::DeleteRollout"); + opentelemetry::trace::Scope scope(span); + return internal::EndSpan(*span, child_->DeleteRollout(NoAwaitTag{}, request)); +} + +future> +RolloutsTracingConnection::DeleteRollout( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto span = internal::MakeSpan( + "compute_rollouts_v1::RolloutsConnection::DeleteRollout"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), child_->DeleteRollout(operation)); +} + +StatusOr +RolloutsTracingConnection::GetRollout( + google::cloud::cpp::compute::rollouts::v1::GetRolloutRequest const& + request) { + auto span = + internal::MakeSpan("compute_rollouts_v1::RolloutsConnection::GetRollout"); + auto scope = opentelemetry::trace::Scope(span); + return internal::EndSpan(*span, child_->GetRollout(request)); +} + +StreamRange +RolloutsTracingConnection::ListRollouts( + google::cloud::cpp::compute::rollouts::v1::ListRolloutsRequest request) { + auto span = internal::MakeSpan( + "compute_rollouts_v1::RolloutsConnection::ListRollouts"); + internal::OTelScope scope(span); + auto sr = child_->ListRollouts(std::move(request)); + return internal::MakeTracedStreamRange< + google::cloud::cpp::compute::v1::Rollout>(std::move(span), std::move(sr)); +} + +future> +RolloutsTracingConnection::Pause( + google::cloud::cpp::compute::rollouts::v1::PauseRequest const& request) { + auto span = + internal::MakeSpan("compute_rollouts_v1::RolloutsConnection::Pause"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), child_->Pause(request)); +} + +StatusOr +RolloutsTracingConnection::Pause( + NoAwaitTag, + google::cloud::cpp::compute::rollouts::v1::PauseRequest const& request) { + auto span = + internal::MakeSpan("compute_rollouts_v1::RolloutsConnection::Pause"); + opentelemetry::trace::Scope scope(span); + return internal::EndSpan(*span, child_->Pause(NoAwaitTag{}, request)); +} + +future> +RolloutsTracingConnection::Pause( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto span = + internal::MakeSpan("compute_rollouts_v1::RolloutsConnection::Pause"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), child_->Pause(operation)); +} + +future> +RolloutsTracingConnection::Resume( + google::cloud::cpp::compute::rollouts::v1::ResumeRequest const& request) { + auto span = + internal::MakeSpan("compute_rollouts_v1::RolloutsConnection::Resume"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), child_->Resume(request)); +} + +StatusOr +RolloutsTracingConnection::Resume( + NoAwaitTag, + google::cloud::cpp::compute::rollouts::v1::ResumeRequest const& request) { + auto span = + internal::MakeSpan("compute_rollouts_v1::RolloutsConnection::Resume"); + opentelemetry::trace::Scope scope(span); + return internal::EndSpan(*span, child_->Resume(NoAwaitTag{}, request)); +} + +future> +RolloutsTracingConnection::Resume( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto span = + internal::MakeSpan("compute_rollouts_v1::RolloutsConnection::Resume"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), child_->Resume(operation)); +} + +std::shared_ptr +MakeRolloutsTracingConnection( + std::shared_ptr conn) { + if (internal::TracingEnabled(conn->options())) { + conn = std::make_shared(std::move(conn)); + } + return conn; +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_rollouts_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/rollouts/v1/internal/rollouts_tracing_connection.h b/google/cloud/compute/rollouts/v1/internal/rollouts_tracing_connection.h new file mode 100644 index 0000000000000..8bafd63c55359 --- /dev/null +++ b/google/cloud/compute/rollouts/v1/internal/rollouts_tracing_connection.h @@ -0,0 +1,128 @@ +// Copyright 2026 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. +// source: google/cloud/compute/rollouts/v1/rollouts.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUTS_V1_INTERNAL_ROLLOUTS_TRACING_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUTS_V1_INTERNAL_ROLLOUTS_TRACING_CONNECTION_H + +#include "google/cloud/compute/rollouts/v1/rollouts_connection.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_rollouts_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class RolloutsTracingConnection + : public compute_rollouts_v1::RolloutsConnection { + public: + ~RolloutsTracingConnection() override = default; + + explicit RolloutsTracingConnection( + std::shared_ptr child); + + Options options() override { return child_->options(); } + + future> Advance( + google::cloud::cpp::compute::rollouts::v1::AdvanceRequest const& request) + override; + + StatusOr Advance( + NoAwaitTag, + google::cloud::cpp::compute::rollouts::v1::AdvanceRequest const& request) + override; + + future> Advance( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + future> Cancel( + google::cloud::cpp::compute::rollouts::v1::CancelRequest const& request) + override; + + StatusOr Cancel( + NoAwaitTag, + google::cloud::cpp::compute::rollouts::v1::CancelRequest const& request) + override; + + future> Cancel( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + future> DeleteRollout( + google::cloud::cpp::compute::rollouts::v1::DeleteRolloutRequest const& + request) override; + + StatusOr DeleteRollout( + NoAwaitTag, + google::cloud::cpp::compute::rollouts::v1::DeleteRolloutRequest const& + request) override; + + future> DeleteRollout( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + StatusOr GetRollout( + google::cloud::cpp::compute::rollouts::v1::GetRolloutRequest const& + request) override; + + StreamRange ListRollouts( + google::cloud::cpp::compute::rollouts::v1::ListRolloutsRequest request) + override; + + future> Pause( + google::cloud::cpp::compute::rollouts::v1::PauseRequest const& request) + override; + + StatusOr Pause( + NoAwaitTag, + google::cloud::cpp::compute::rollouts::v1::PauseRequest const& request) + override; + + future> Pause( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + future> Resume( + google::cloud::cpp::compute::rollouts::v1::ResumeRequest const& request) + override; + + StatusOr Resume( + NoAwaitTag, + google::cloud::cpp::compute::rollouts::v1::ResumeRequest const& request) + override; + + future> Resume( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + private: + std::shared_ptr child_; +}; + +/** + * Conditionally applies the tracing decorator to the given connection. + * + * The connection is only decorated if tracing is enabled (as determined by the + * connection's options). + */ +std::shared_ptr +MakeRolloutsTracingConnection( + std::shared_ptr conn); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_rollouts_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUTS_V1_INTERNAL_ROLLOUTS_TRACING_CONNECTION_H diff --git a/google/cloud/compute/rollouts/v1/mocks/mock_rollouts_connection.h b/google/cloud/compute/rollouts/v1/mocks/mock_rollouts_connection.h new file mode 100644 index 0000000000000..7be1aba435121 --- /dev/null +++ b/google/cloud/compute/rollouts/v1/mocks/mock_rollouts_connection.h @@ -0,0 +1,266 @@ +// Copyright 2026 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. +// source: google/cloud/compute/rollouts/v1/rollouts.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUTS_V1_MOCKS_MOCK_ROLLOUTS_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUTS_V1_MOCKS_MOCK_ROLLOUTS_CONNECTION_H + +#include "google/cloud/compute/rollouts/v1/rollouts_connection.h" +#include + +namespace google { +namespace cloud { +namespace compute_rollouts_v1_mocks { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/** + * A class to mock `RolloutsConnection`. + * + * Application developers may want to test their code with simulated responses, + * including errors, from an object of type `RolloutsClient`. To do so, + * construct an object of type `RolloutsClient` with an instance of this + * class. Then use the Google Test framework functions to program the behavior + * of this mock. + * + * @see [This example][bq-mock] for how to test your application with GoogleTest. + * While the example showcases types from the BigQuery library, the underlying + * principles apply for any pair of `*Client` and `*Connection`. + * + * [bq-mock]: @cloud_cpp_docs_link{bigquery,bigquery-read-mock} + */ +class MockRolloutsConnection : public compute_rollouts_v1::RolloutsConnection { + public: + MOCK_METHOD(Options, options, (), (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// Advance(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + Advance, + (google::cloud::cpp::compute::rollouts::v1::AdvanceRequest const& + request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// EXPECT_CALL(*mock, Advance(_, _)) + /// @endcode + MOCK_METHOD(StatusOr, Advance, + (NoAwaitTag, + google::cloud::cpp::compute::rollouts::v1::AdvanceRequest const& + request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// Advance(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + Advance, + (google::cloud::cpp::compute::v1::Operation const& operation), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// Cancel(Matcher(_))) + /// @endcode + MOCK_METHOD( + future>, Cancel, + (google::cloud::cpp::compute::rollouts::v1::CancelRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// EXPECT_CALL(*mock, Cancel(_, _)) + /// @endcode + MOCK_METHOD( + StatusOr, Cancel, + (NoAwaitTag, + google::cloud::cpp::compute::rollouts::v1::CancelRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// Cancel(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + Cancel, + (google::cloud::cpp::compute::v1::Operation const& operation), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// DeleteRollout(Matcher(_))) + /// @endcode + MOCK_METHOD( + future>, + DeleteRollout, + (google::cloud::cpp::compute::rollouts::v1::DeleteRolloutRequest const& + request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// EXPECT_CALL(*mock, DeleteRollout(_, _)) + /// @endcode + MOCK_METHOD( + StatusOr, DeleteRollout, + (NoAwaitTag, + google::cloud::cpp::compute::rollouts::v1::DeleteRolloutRequest const& + request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// DeleteRollout(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + DeleteRollout, + (google::cloud::cpp::compute::v1::Operation const& operation), + (override)); + + MOCK_METHOD( + StatusOr, GetRollout, + (google::cloud::cpp::compute::rollouts::v1::GetRolloutRequest const& + request), + (override)); + + MOCK_METHOD( + (StreamRange), ListRollouts, + (google::cloud::cpp::compute::rollouts::v1::ListRolloutsRequest request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// Pause(Matcher(_))) + /// @endcode + MOCK_METHOD( + future>, Pause, + (google::cloud::cpp::compute::rollouts::v1::PauseRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// EXPECT_CALL(*mock, Pause(_, _)) + /// @endcode + MOCK_METHOD( + StatusOr, Pause, + (NoAwaitTag, + google::cloud::cpp::compute::rollouts::v1::PauseRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// Pause(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + Pause, + (google::cloud::cpp::compute::v1::Operation const& operation), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// Resume(Matcher(_))) + /// @endcode + MOCK_METHOD( + future>, Resume, + (google::cloud::cpp::compute::rollouts::v1::ResumeRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// EXPECT_CALL(*mock, Resume(_, _)) + /// @endcode + MOCK_METHOD( + StatusOr, Resume, + (NoAwaitTag, + google::cloud::cpp::compute::rollouts::v1::ResumeRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// Resume(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + Resume, + (google::cloud::cpp::compute::v1::Operation const& operation), + (override)); +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_rollouts_v1_mocks +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUTS_V1_MOCKS_MOCK_ROLLOUTS_CONNECTION_H diff --git a/google/cloud/compute/rollouts/v1/rollouts_client.cc b/google/cloud/compute/rollouts/v1/rollouts_client.cc new file mode 100644 index 0000000000000..a8346416d5439 --- /dev/null +++ b/google/cloud/compute/rollouts/v1/rollouts_client.cc @@ -0,0 +1,288 @@ +// Copyright 2026 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. +// source: google/cloud/compute/rollouts/v1/rollouts.proto + +#include "google/cloud/compute/rollouts/v1/rollouts_client.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_rollouts_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +RolloutsClient::RolloutsClient(std::shared_ptr connection, + Options opts) + : connection_(std::move(connection)), + options_( + internal::MergeOptions(std::move(opts), connection_->options())) {} +RolloutsClient::~RolloutsClient() = default; + +future> +RolloutsClient::Advance(std::string const& project, std::string const& rollout, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::rollouts::v1::AdvanceRequest request; + request.set_project(project); + request.set_rollout(rollout); + return connection_->Advance(request); +} + +StatusOr RolloutsClient::Advance( + NoAwaitTag, std::string const& project, std::string const& rollout, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::rollouts::v1::AdvanceRequest request; + request.set_project(project); + request.set_rollout(rollout); + return connection_->Advance(NoAwaitTag{}, request); +} + +future> +RolloutsClient::Advance( + google::cloud::cpp::compute::rollouts::v1::AdvanceRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->Advance(request); +} + +StatusOr RolloutsClient::Advance( + NoAwaitTag, + google::cloud::cpp::compute::rollouts::v1::AdvanceRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->Advance(NoAwaitTag{}, request); +} + +future> +RolloutsClient::Advance( + google::cloud::cpp::compute::v1::Operation const& operation, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->Advance(operation); +} + +future> +RolloutsClient::Cancel(std::string const& project, std::string const& rollout, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::rollouts::v1::CancelRequest request; + request.set_project(project); + request.set_rollout(rollout); + return connection_->Cancel(request); +} + +StatusOr RolloutsClient::Cancel( + NoAwaitTag, std::string const& project, std::string const& rollout, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::rollouts::v1::CancelRequest request; + request.set_project(project); + request.set_rollout(rollout); + return connection_->Cancel(NoAwaitTag{}, request); +} + +future> +RolloutsClient::Cancel( + google::cloud::cpp::compute::rollouts::v1::CancelRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->Cancel(request); +} + +StatusOr RolloutsClient::Cancel( + NoAwaitTag, + google::cloud::cpp::compute::rollouts::v1::CancelRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->Cancel(NoAwaitTag{}, request); +} + +future> +RolloutsClient::Cancel( + google::cloud::cpp::compute::v1::Operation const& operation, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->Cancel(operation); +} + +future> +RolloutsClient::DeleteRollout(std::string const& project, + std::string const& rollout, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::rollouts::v1::DeleteRolloutRequest request; + request.set_project(project); + request.set_rollout(rollout); + return connection_->DeleteRollout(request); +} + +StatusOr +RolloutsClient::DeleteRollout(NoAwaitTag, std::string const& project, + std::string const& rollout, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::rollouts::v1::DeleteRolloutRequest request; + request.set_project(project); + request.set_rollout(rollout); + return connection_->DeleteRollout(NoAwaitTag{}, request); +} + +future> +RolloutsClient::DeleteRollout( + google::cloud::cpp::compute::rollouts::v1::DeleteRolloutRequest const& + request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->DeleteRollout(request); +} + +StatusOr +RolloutsClient::DeleteRollout( + NoAwaitTag, + google::cloud::cpp::compute::rollouts::v1::DeleteRolloutRequest const& + request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->DeleteRollout(NoAwaitTag{}, request); +} + +future> +RolloutsClient::DeleteRollout( + google::cloud::cpp::compute::v1::Operation const& operation, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->DeleteRollout(operation); +} + +StatusOr RolloutsClient::GetRollout( + std::string const& project, std::string const& rollout, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::rollouts::v1::GetRolloutRequest request; + request.set_project(project); + request.set_rollout(rollout); + return connection_->GetRollout(request); +} + +StatusOr RolloutsClient::GetRollout( + google::cloud::cpp::compute::rollouts::v1::GetRolloutRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->GetRollout(request); +} + +StreamRange +RolloutsClient::ListRollouts(std::string const& project, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::rollouts::v1::ListRolloutsRequest request; + request.set_project(project); + return connection_->ListRollouts(request); +} + +StreamRange +RolloutsClient::ListRollouts( + google::cloud::cpp::compute::rollouts::v1::ListRolloutsRequest request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->ListRollouts(std::move(request)); +} + +future> +RolloutsClient::Pause(std::string const& project, std::string const& rollout, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::rollouts::v1::PauseRequest request; + request.set_project(project); + request.set_rollout(rollout); + return connection_->Pause(request); +} + +StatusOr RolloutsClient::Pause( + NoAwaitTag, std::string const& project, std::string const& rollout, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::rollouts::v1::PauseRequest request; + request.set_project(project); + request.set_rollout(rollout); + return connection_->Pause(NoAwaitTag{}, request); +} + +future> +RolloutsClient::Pause( + google::cloud::cpp::compute::rollouts::v1::PauseRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->Pause(request); +} + +StatusOr RolloutsClient::Pause( + NoAwaitTag, + google::cloud::cpp::compute::rollouts::v1::PauseRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->Pause(NoAwaitTag{}, request); +} + +future> +RolloutsClient::Pause( + google::cloud::cpp::compute::v1::Operation const& operation, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->Pause(operation); +} + +future> +RolloutsClient::Resume(std::string const& project, std::string const& rollout, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::rollouts::v1::ResumeRequest request; + request.set_project(project); + request.set_rollout(rollout); + return connection_->Resume(request); +} + +StatusOr RolloutsClient::Resume( + NoAwaitTag, std::string const& project, std::string const& rollout, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::rollouts::v1::ResumeRequest request; + request.set_project(project); + request.set_rollout(rollout); + return connection_->Resume(NoAwaitTag{}, request); +} + +future> +RolloutsClient::Resume( + google::cloud::cpp::compute::rollouts::v1::ResumeRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->Resume(request); +} + +StatusOr RolloutsClient::Resume( + NoAwaitTag, + google::cloud::cpp::compute::rollouts::v1::ResumeRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->Resume(NoAwaitTag{}, request); +} + +future> +RolloutsClient::Resume( + google::cloud::cpp::compute::v1::Operation const& operation, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->Resume(operation); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_rollouts_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/rollouts/v1/rollouts_client.h b/google/cloud/compute/rollouts/v1/rollouts_client.h new file mode 100644 index 0000000000000..fc16f7949701e --- /dev/null +++ b/google/cloud/compute/rollouts/v1/rollouts_client.h @@ -0,0 +1,817 @@ +// Copyright 2026 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. +// source: google/cloud/compute/rollouts/v1/rollouts.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUTS_V1_ROLLOUTS_CLIENT_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUTS_V1_ROLLOUTS_CLIENT_H + +#include "google/cloud/compute/rollouts/v1/rollouts_rest_connection.h" +#include "google/cloud/future.h" +#include "google/cloud/no_await_tag.h" +#include "google/cloud/options.h" +#include "google/cloud/polling_policy.h" +#include "google/cloud/status_or.h" +#include "google/cloud/version.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_rollouts_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/// +/// Service for the rollouts resource. +/// https://cloud.google.com/compute/docs/reference/rest/v1/rollouts +/// +/// @par Equality +/// +/// Instances of this class created via copy-construction or copy-assignment +/// always compare equal. Instances created with equal +/// `std::shared_ptr<*Connection>` objects compare equal. Objects that compare +/// equal share the same underlying resources. +/// +/// @par Performance +/// +/// Creating a new instance of this class is a relatively expensive operation, +/// new objects establish new connections to the service. In contrast, +/// copy-construction, move-construction, and the corresponding assignment +/// operations are relatively efficient as the copies share all underlying +/// resources. +/// +/// @par Thread Safety +/// +/// Concurrent access to different instances of this class, even if they compare +/// equal, is guaranteed to work. Two or more threads operating on the same +/// instance of this class is not guaranteed to work. Since copy-construction +/// and move-construction is a relatively efficient operation, consider using +/// such a copy when using this class from multiple threads. +/// +class RolloutsClient { + public: + explicit RolloutsClient(std::shared_ptr connection, + Options opts = {}); + ~RolloutsClient(); + + ///@{ + /// @name Copy and move support + RolloutsClient(RolloutsClient const&) = default; + RolloutsClient& operator=(RolloutsClient const&) = default; + RolloutsClient(RolloutsClient&&) = default; + RolloutsClient& operator=(RolloutsClient&&) = default; + ///@} + + ///@{ + /// @name Equality + friend bool operator==(RolloutsClient const& a, RolloutsClient const& b) { + return a.connection_ == b.connection_; + } + friend bool operator!=(RolloutsClient const& a, RolloutsClient const& b) { + return !(a == b); + } + ///@} + + // clang-format off + /// + /// Advances a Rollout to the next wave, or completes it if no waves remain. + /// https://cloud.google.com/compute/docs/reference/rest/v1/rollouts/advance + /// + /// @param project Required. Project ID for this request. + /// @param rollout Required. Name of the Rollout resource to advance. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.rollouts.v1.AdvanceRequest]: @cloud_cpp_reference_link{google/cloud/compute/rollouts/v1/rollouts.proto#L117} + /// + // clang-format on + future> Advance( + std::string const& project, std::string const& rollout, + Options opts = {}); + + // clang-format off + /// + /// @copybrief Advance + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr Advance( + NoAwaitTag, std::string const& project, std::string const& rollout, + Options opts = {}); + + // clang-format off + /// + /// Advances a Rollout to the next wave, or completes it if no waves remain. + /// https://cloud.google.com/compute/docs/reference/rest/v1/rollouts/advance + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.rollouts.v1.AdvanceRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.rollouts.v1.AdvanceRequest]: @cloud_cpp_reference_link{google/cloud/compute/rollouts/v1/rollouts.proto#L117} + /// + // clang-format on + future> Advance( + google::cloud::cpp::compute::rollouts::v1::AdvanceRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief Advance + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr Advance( + NoAwaitTag, + google::cloud::cpp::compute::rollouts::v1::AdvanceRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief Advance + /// + /// This method accepts a `google::cloud::cpp::compute::v1::Operation` that corresponds + /// to a previously started Long Running Operation (LRO) and polls the status + /// of the LRO in the background. + /// + // clang-format on + future> Advance( + google::cloud::cpp::compute::v1::Operation const& operation, + Options opts = {}); + + // clang-format off + /// + /// Cancels a Rollout. + /// https://cloud.google.com/compute/docs/reference/rest/v1/rollouts/cancel + /// + /// @param project Project ID for this request. + /// @param rollout Name of the Rollout resource to cancel. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.rollouts.v1.CancelRequest]: @cloud_cpp_reference_link{google/cloud/compute/rollouts/v1/rollouts.proto#L149} + /// + // clang-format on + future> Cancel( + std::string const& project, std::string const& rollout, + Options opts = {}); + + // clang-format off + /// + /// @copybrief Cancel + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr Cancel( + NoAwaitTag, std::string const& project, std::string const& rollout, + Options opts = {}); + + // clang-format off + /// + /// Cancels a Rollout. + /// https://cloud.google.com/compute/docs/reference/rest/v1/rollouts/cancel + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.rollouts.v1.CancelRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.rollouts.v1.CancelRequest]: @cloud_cpp_reference_link{google/cloud/compute/rollouts/v1/rollouts.proto#L149} + /// + // clang-format on + future> Cancel( + google::cloud::cpp::compute::rollouts::v1::CancelRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief Cancel + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr Cancel( + NoAwaitTag, + google::cloud::cpp::compute::rollouts::v1::CancelRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief Cancel + /// + /// This method accepts a `google::cloud::cpp::compute::v1::Operation` that corresponds + /// to a previously started Long Running Operation (LRO) and polls the status + /// of the LRO in the background. + /// + // clang-format on + future> Cancel( + google::cloud::cpp::compute::v1::Operation const& operation, + Options opts = {}); + + // clang-format off + /// + /// Deletes a Rollout. + /// https://cloud.google.com/compute/docs/reference/rest/v1/rollouts/delete + /// + /// @param project Project ID for this request. + /// @param rollout Name of the Rollout resource to delete. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.rollouts.v1.DeleteRolloutRequest]: @cloud_cpp_reference_link{google/cloud/compute/rollouts/v1/rollouts.proto#L185} + /// + // clang-format on + future> DeleteRollout( + std::string const& project, std::string const& rollout, + Options opts = {}); + + // clang-format off + /// + /// @copybrief DeleteRollout + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr DeleteRollout( + NoAwaitTag, std::string const& project, std::string const& rollout, + Options opts = {}); + + // clang-format off + /// + /// Deletes a Rollout. + /// https://cloud.google.com/compute/docs/reference/rest/v1/rollouts/delete + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.rollouts.v1.DeleteRolloutRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.rollouts.v1.DeleteRolloutRequest]: @cloud_cpp_reference_link{google/cloud/compute/rollouts/v1/rollouts.proto#L185} + /// + // clang-format on + future> DeleteRollout( + google::cloud::cpp::compute::rollouts::v1::DeleteRolloutRequest const& + request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief DeleteRollout + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr DeleteRollout( + NoAwaitTag, + google::cloud::cpp::compute::rollouts::v1::DeleteRolloutRequest const& + request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief DeleteRollout + /// + /// This method accepts a `google::cloud::cpp::compute::v1::Operation` that corresponds + /// to a previously started Long Running Operation (LRO) and polls the status + /// of the LRO in the background. + /// + // clang-format on + future> DeleteRollout( + google::cloud::cpp::compute::v1::Operation const& operation, + Options opts = {}); + + // clang-format off + /// + /// Gets details of a single project-scoped Rollout. + /// https://cloud.google.com/compute/docs/reference/rest/v1/rollouts/get + /// + /// @param project Project ID for this request. + /// @param rollout Name of the persistent rollout to return. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.Rollout]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.rollouts.v1.GetRolloutRequest]: @cloud_cpp_reference_link{google/cloud/compute/rollouts/v1/rollouts.proto#L214} + /// [google.cloud.cpp.compute.v1.Rollout]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_136.proto#L29} + /// + // clang-format on + StatusOr GetRollout( + std::string const& project, std::string const& rollout, + Options opts = {}); + + // clang-format off + /// + /// Gets details of a single project-scoped Rollout. + /// https://cloud.google.com/compute/docs/reference/rest/v1/rollouts/get + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.rollouts.v1.GetRolloutRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.Rollout]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.rollouts.v1.GetRolloutRequest]: @cloud_cpp_reference_link{google/cloud/compute/rollouts/v1/rollouts.proto#L214} + /// [google.cloud.cpp.compute.v1.Rollout]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_136.proto#L29} + /// + // clang-format on + StatusOr GetRollout( + google::cloud::cpp::compute::rollouts::v1::GetRolloutRequest const& + request, + Options opts = {}); + + // clang-format off + /// + /// Lists Rollouts in a given project and location. + /// https://cloud.google.com/compute/docs/reference/rest/v1/rollouts/list + /// + /// @param project Project ID for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return a [StreamRange](@ref google::cloud::StreamRange) + /// to iterate of the results. See the documentation of this type for + /// details. In brief, this class has `begin()` and `end()` member + /// functions returning a iterator class meeting the + /// [input iterator requirements]. The value type for this iterator is a + /// [`StatusOr`] as the iteration may fail even after some values are + /// retrieved successfully, for example, if there is a network disconnect. + /// An empty set of results does not indicate an error, it indicates + /// that there are no resources meeting the request criteria. + /// On a successful iteration the `StatusOr` contains elements of type + /// [google.cloud.cpp.compute.v1.Rollout], or rather, + /// the C++ class generated by Protobuf from that type. Please consult the + /// Protobuf documentation for details on the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.rollouts.v1.ListRolloutsRequest]: @cloud_cpp_reference_link{google/cloud/compute/rollouts/v1/rollouts.proto#L225} + /// [google.cloud.cpp.compute.v1.Rollout]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_136.proto#L29} + /// + // clang-format on + StreamRange ListRollouts( + std::string const& project, Options opts = {}); + + // clang-format off + /// + /// Lists Rollouts in a given project and location. + /// https://cloud.google.com/compute/docs/reference/rest/v1/rollouts/list + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.rollouts.v1.ListRolloutsRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return a [StreamRange](@ref google::cloud::StreamRange) + /// to iterate of the results. See the documentation of this type for + /// details. In brief, this class has `begin()` and `end()` member + /// functions returning a iterator class meeting the + /// [input iterator requirements]. The value type for this iterator is a + /// [`StatusOr`] as the iteration may fail even after some values are + /// retrieved successfully, for example, if there is a network disconnect. + /// An empty set of results does not indicate an error, it indicates + /// that there are no resources meeting the request criteria. + /// On a successful iteration the `StatusOr` contains elements of type + /// [google.cloud.cpp.compute.v1.Rollout], or rather, + /// the C++ class generated by Protobuf from that type. Please consult the + /// Protobuf documentation for details on the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.rollouts.v1.ListRolloutsRequest]: @cloud_cpp_reference_link{google/cloud/compute/rollouts/v1/rollouts.proto#L225} + /// [google.cloud.cpp.compute.v1.Rollout]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_136.proto#L29} + /// + // clang-format on + StreamRange ListRollouts( + google::cloud::cpp::compute::rollouts::v1::ListRolloutsRequest request, + Options opts = {}); + + // clang-format off + /// + /// Pauses a Rollout. + /// https://cloud.google.com/compute/docs/reference/rest/v1/rollouts/pause + /// + /// @param project Required. Project ID for this request. + /// @param rollout Required. Name of the Rollout resource to pause. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.rollouts.v1.PauseRequest]: @cloud_cpp_reference_link{google/cloud/compute/rollouts/v1/rollouts.proto#L326} + /// + // clang-format on + future> Pause( + std::string const& project, std::string const& rollout, + Options opts = {}); + + // clang-format off + /// + /// @copybrief Pause + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr Pause( + NoAwaitTag, std::string const& project, std::string const& rollout, + Options opts = {}); + + // clang-format off + /// + /// Pauses a Rollout. + /// https://cloud.google.com/compute/docs/reference/rest/v1/rollouts/pause + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.rollouts.v1.PauseRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.rollouts.v1.PauseRequest]: @cloud_cpp_reference_link{google/cloud/compute/rollouts/v1/rollouts.proto#L326} + /// + // clang-format on + future> Pause( + google::cloud::cpp::compute::rollouts::v1::PauseRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief Pause + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr Pause( + NoAwaitTag, + google::cloud::cpp::compute::rollouts::v1::PauseRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief Pause + /// + /// This method accepts a `google::cloud::cpp::compute::v1::Operation` that corresponds + /// to a previously started Long Running Operation (LRO) and polls the status + /// of the LRO in the background. + /// + // clang-format on + future> Pause( + google::cloud::cpp::compute::v1::Operation const& operation, + Options opts = {}); + + // clang-format off + /// + /// Resumes a Rollout. + /// https://cloud.google.com/compute/docs/reference/rest/v1/rollouts/resume + /// + /// @param project Required. Project ID for this request. + /// @param rollout Required. Name of the Rollout resource to resume. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.rollouts.v1.ResumeRequest]: @cloud_cpp_reference_link{google/cloud/compute/rollouts/v1/rollouts.proto#L360} + /// + // clang-format on + future> Resume( + std::string const& project, std::string const& rollout, + Options opts = {}); + + // clang-format off + /// + /// @copybrief Resume + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr Resume( + NoAwaitTag, std::string const& project, std::string const& rollout, + Options opts = {}); + + // clang-format off + /// + /// Resumes a Rollout. + /// https://cloud.google.com/compute/docs/reference/rest/v1/rollouts/resume + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.rollouts.v1.ResumeRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.rollouts.v1.ResumeRequest]: @cloud_cpp_reference_link{google/cloud/compute/rollouts/v1/rollouts.proto#L360} + /// + // clang-format on + future> Resume( + google::cloud::cpp::compute::rollouts::v1::ResumeRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief Resume + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr Resume( + NoAwaitTag, + google::cloud::cpp::compute::rollouts::v1::ResumeRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief Resume + /// + /// This method accepts a `google::cloud::cpp::compute::v1::Operation` that corresponds + /// to a previously started Long Running Operation (LRO) and polls the status + /// of the LRO in the background. + /// + // clang-format on + future> Resume( + google::cloud::cpp::compute::v1::Operation const& operation, + Options opts = {}); + + private: + std::shared_ptr connection_; + Options options_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_rollouts_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUTS_V1_ROLLOUTS_CLIENT_H diff --git a/google/cloud/compute/rollouts/v1/rollouts_connection.cc b/google/cloud/compute/rollouts/v1/rollouts_connection.cc new file mode 100644 index 0000000000000..8e9faff521582 --- /dev/null +++ b/google/cloud/compute/rollouts/v1/rollouts_connection.cc @@ -0,0 +1,169 @@ +// Copyright 2026 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. +// source: google/cloud/compute/rollouts/v1/rollouts.proto + +#include "google/cloud/compute/rollouts/v1/rollouts_connection.h" +#include "google/cloud/compute/rollouts/v1/internal/rollouts_option_defaults.h" +#include "google/cloud/compute/rollouts/v1/internal/rollouts_tracing_connection.h" +#include "google/cloud/compute/rollouts/v1/rollouts_options.h" +#include "google/cloud/background_threads.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/grpc_options.h" +#include "google/cloud/internal/pagination_range.h" +#include "google/cloud/internal/unified_grpc_credentials.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_rollouts_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +RolloutsConnection::~RolloutsConnection() = default; + +future> +RolloutsConnection::Advance( + google::cloud::cpp::compute::rollouts::v1::AdvanceRequest const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +RolloutsConnection::Advance( + NoAwaitTag, + google::cloud::cpp::compute::rollouts::v1::AdvanceRequest const&) { + return StatusOr( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +RolloutsConnection::Advance(google::cloud::cpp::compute::v1::Operation const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +RolloutsConnection::Cancel( + google::cloud::cpp::compute::rollouts::v1::CancelRequest const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr RolloutsConnection::Cancel( + NoAwaitTag, + google::cloud::cpp::compute::rollouts::v1::CancelRequest const&) { + return StatusOr( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +RolloutsConnection::Cancel(google::cloud::cpp::compute::v1::Operation const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +RolloutsConnection::DeleteRollout( + google::cloud::cpp::compute::rollouts::v1::DeleteRolloutRequest const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +RolloutsConnection::DeleteRollout( + NoAwaitTag, + google::cloud::cpp::compute::rollouts::v1::DeleteRolloutRequest const&) { + return StatusOr( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +RolloutsConnection::DeleteRollout( + google::cloud::cpp::compute::v1::Operation const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +RolloutsConnection::GetRollout( + google::cloud::cpp::compute::rollouts::v1::GetRolloutRequest const&) { + return Status(StatusCode::kUnimplemented, "not implemented"); +} + +StreamRange +RolloutsConnection::ListRollouts( + google::cloud::cpp::compute::rollouts::v1:: + ListRolloutsRequest) { // NOLINT(performance-unnecessary-value-param) + return google::cloud::internal::MakeUnimplementedPaginationRange< + StreamRange>(); +} + +future> +RolloutsConnection::Pause( + google::cloud::cpp::compute::rollouts::v1::PauseRequest const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr RolloutsConnection::Pause( + NoAwaitTag, + google::cloud::cpp::compute::rollouts::v1::PauseRequest const&) { + return StatusOr( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +RolloutsConnection::Pause(google::cloud::cpp::compute::v1::Operation const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +RolloutsConnection::Resume( + google::cloud::cpp::compute::rollouts::v1::ResumeRequest const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr RolloutsConnection::Resume( + NoAwaitTag, + google::cloud::cpp::compute::rollouts::v1::ResumeRequest const&) { + return StatusOr( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +RolloutsConnection::Resume(google::cloud::cpp::compute::v1::Operation const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_rollouts_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/rollouts/v1/rollouts_connection.h b/google/cloud/compute/rollouts/v1/rollouts_connection.h new file mode 100644 index 0000000000000..0bfed2d7e9426 --- /dev/null +++ b/google/cloud/compute/rollouts/v1/rollouts_connection.h @@ -0,0 +1,251 @@ +// Copyright 2026 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. +// source: google/cloud/compute/rollouts/v1/rollouts.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUTS_V1_ROLLOUTS_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUTS_V1_ROLLOUTS_CONNECTION_H + +#include "google/cloud/compute/rollouts/v1/internal/rollouts_retry_traits.h" +#include "google/cloud/compute/rollouts/v1/rollouts.pb.h" +#include "google/cloud/compute/rollouts/v1/rollouts_connection_idempotency_policy.h" +#include "google/cloud/backoff_policy.h" +#include "google/cloud/future.h" +#include "google/cloud/internal/retry_policy_impl.h" +#include "google/cloud/no_await_tag.h" +#include "google/cloud/options.h" +#include "google/cloud/polling_policy.h" +#include "google/cloud/status_or.h" +#include "google/cloud/stream_range.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_rollouts_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/// The retry policy for `RolloutsConnection`. +class RolloutsRetryPolicy : public ::google::cloud::RetryPolicy { + public: + /// Creates a new instance of the policy, reset to the initial state. + virtual std::unique_ptr clone() const = 0; +}; + +/** + * A retry policy for `RolloutsConnection` based on counting errors. + * + * This policy stops retrying if: + * - An RPC returns a non-transient error. + * - More than a prescribed number of transient failures is detected. + * + * In this class the following status codes are treated as transient errors: + * - [`kUnavailable`](@ref google::cloud::StatusCode) + */ +class RolloutsLimitedErrorCountRetryPolicy : public RolloutsRetryPolicy { + public: + /** + * Create an instance that tolerates up to @p maximum_failures transient + * errors. + * + * @note Disable the retry loop by providing an instance of this policy with + * @p maximum_failures == 0. + */ + explicit RolloutsLimitedErrorCountRetryPolicy(int maximum_failures) + : impl_(maximum_failures) {} + + RolloutsLimitedErrorCountRetryPolicy( + RolloutsLimitedErrorCountRetryPolicy&& rhs) noexcept + : RolloutsLimitedErrorCountRetryPolicy(rhs.maximum_failures()) {} + RolloutsLimitedErrorCountRetryPolicy( + RolloutsLimitedErrorCountRetryPolicy const& rhs) noexcept + : RolloutsLimitedErrorCountRetryPolicy(rhs.maximum_failures()) {} + + int maximum_failures() const { return impl_.maximum_failures(); } + + bool OnFailure(Status const& status) override { + return impl_.OnFailure(status); + } + bool IsExhausted() const override { return impl_.IsExhausted(); } + bool IsPermanentFailure(Status const& status) const override { + return impl_.IsPermanentFailure(status); + } + std::unique_ptr clone() const override { + return std::make_unique( + maximum_failures()); + } + + // This is provided only for backwards compatibility. + using BaseType = RolloutsRetryPolicy; + + private: + google::cloud::internal::LimitedErrorCountRetryPolicy< + compute_rollouts_v1_internal::RolloutsRetryTraits> + impl_; +}; + +/** + * A retry policy for `RolloutsConnection` based on elapsed time. + * + * This policy stops retrying if: + * - An RPC returns a non-transient error. + * - The elapsed time in the retry loop exceeds a prescribed duration. + * + * In this class the following status codes are treated as transient errors: + * - [`kUnavailable`](@ref google::cloud::StatusCode) + */ +class RolloutsLimitedTimeRetryPolicy : public RolloutsRetryPolicy { + public: + /** + * Constructor given a `std::chrono::duration<>` object. + * + * @tparam DurationRep a placeholder to match the `Rep` tparam for @p + * duration's type. The semantics of this template parameter are + * documented in `std::chrono::duration<>`. In brief, the underlying + * arithmetic type used to store the number of ticks. For our purposes it + * is simply a formal parameter. + * @tparam DurationPeriod a placeholder to match the `Period` tparam for @p + * duration's type. The semantics of this template parameter are + * documented in `std::chrono::duration<>`. In brief, the length of the + * tick in seconds, expressed as a `std::ratio<>`. For our purposes it is + * simply a formal parameter. + * @param maximum_duration the maximum time allowed before the policy expires. + * While the application can express this time in any units they desire, + * the class truncates to milliseconds. + * + * @see https://en.cppreference.com/w/cpp/chrono/duration for more information + * about `std::chrono::duration`. + */ + template + explicit RolloutsLimitedTimeRetryPolicy( + std::chrono::duration maximum_duration) + : impl_(maximum_duration) {} + + RolloutsLimitedTimeRetryPolicy(RolloutsLimitedTimeRetryPolicy&& rhs) noexcept + : RolloutsLimitedTimeRetryPolicy(rhs.maximum_duration()) {} + RolloutsLimitedTimeRetryPolicy( + RolloutsLimitedTimeRetryPolicy const& rhs) noexcept + : RolloutsLimitedTimeRetryPolicy(rhs.maximum_duration()) {} + + std::chrono::milliseconds maximum_duration() const { + return impl_.maximum_duration(); + } + + bool OnFailure(Status const& status) override { + return impl_.OnFailure(status); + } + bool IsExhausted() const override { return impl_.IsExhausted(); } + bool IsPermanentFailure(Status const& status) const override { + return impl_.IsPermanentFailure(status); + } + std::unique_ptr clone() const override { + return std::make_unique(maximum_duration()); + } + + // This is provided only for backwards compatibility. + using BaseType = RolloutsRetryPolicy; + + private: + google::cloud::internal::LimitedTimeRetryPolicy< + compute_rollouts_v1_internal::RolloutsRetryTraits> + impl_; +}; + +/** + * The `RolloutsConnection` object for `RolloutsClient`. + * + * This interface defines virtual methods for each of the user-facing overload + * sets in `RolloutsClient`. This allows users to inject custom behavior + * (e.g., with a Google Mock object) when writing tests that use objects of type + * `RolloutsClient`. + * + * To create a concrete instance, see `MakeRolloutsConnection()`. + * + * For mocking, see `compute_rollouts_v1_mocks::MockRolloutsConnection`. + */ +class RolloutsConnection { + public: + virtual ~RolloutsConnection() = 0; + + virtual Options options() { return Options{}; } + + virtual future> Advance( + google::cloud::cpp::compute::rollouts::v1::AdvanceRequest const& request); + + virtual StatusOr Advance( + NoAwaitTag, + google::cloud::cpp::compute::rollouts::v1::AdvanceRequest const& request); + + virtual future> Advance( + google::cloud::cpp::compute::v1::Operation const& operation); + + virtual future> Cancel( + google::cloud::cpp::compute::rollouts::v1::CancelRequest const& request); + + virtual StatusOr Cancel( + NoAwaitTag, + google::cloud::cpp::compute::rollouts::v1::CancelRequest const& request); + + virtual future> Cancel( + google::cloud::cpp::compute::v1::Operation const& operation); + + virtual future> + DeleteRollout( + google::cloud::cpp::compute::rollouts::v1::DeleteRolloutRequest const& + request); + + virtual StatusOr DeleteRollout( + NoAwaitTag, + google::cloud::cpp::compute::rollouts::v1::DeleteRolloutRequest const& + request); + + virtual future> + DeleteRollout(google::cloud::cpp::compute::v1::Operation const& operation); + + virtual StatusOr GetRollout( + google::cloud::cpp::compute::rollouts::v1::GetRolloutRequest const& + request); + + virtual StreamRange ListRollouts( + google::cloud::cpp::compute::rollouts::v1::ListRolloutsRequest request); + + virtual future> Pause( + google::cloud::cpp::compute::rollouts::v1::PauseRequest const& request); + + virtual StatusOr Pause( + NoAwaitTag, + google::cloud::cpp::compute::rollouts::v1::PauseRequest const& request); + + virtual future> Pause( + google::cloud::cpp::compute::v1::Operation const& operation); + + virtual future> Resume( + google::cloud::cpp::compute::rollouts::v1::ResumeRequest const& request); + + virtual StatusOr Resume( + NoAwaitTag, + google::cloud::cpp::compute::rollouts::v1::ResumeRequest const& request); + + virtual future> Resume( + google::cloud::cpp::compute::v1::Operation const& operation); +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_rollouts_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUTS_V1_ROLLOUTS_CONNECTION_H diff --git a/google/cloud/compute/rollouts/v1/rollouts_connection_idempotency_policy.cc b/google/cloud/compute/rollouts/v1/rollouts_connection_idempotency_policy.cc new file mode 100644 index 0000000000000..abeb61c3f697d --- /dev/null +++ b/google/cloud/compute/rollouts/v1/rollouts_connection_idempotency_policy.cc @@ -0,0 +1,80 @@ +// Copyright 2026 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. +// source: google/cloud/compute/rollouts/v1/rollouts.proto + +#include "google/cloud/compute/rollouts/v1/rollouts_connection_idempotency_policy.h" +#include + +namespace google { +namespace cloud { +namespace compute_rollouts_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +using ::google::cloud::Idempotency; + +RolloutsConnectionIdempotencyPolicy::~RolloutsConnectionIdempotencyPolicy() = + default; + +std::unique_ptr +RolloutsConnectionIdempotencyPolicy::clone() const { + return std::make_unique(*this); +} + +Idempotency RolloutsConnectionIdempotencyPolicy::Advance( + google::cloud::cpp::compute::rollouts::v1::AdvanceRequest const&) { + return Idempotency::kNonIdempotent; +} + +Idempotency RolloutsConnectionIdempotencyPolicy::Cancel( + google::cloud::cpp::compute::rollouts::v1::CancelRequest const&) { + return Idempotency::kNonIdempotent; +} + +Idempotency RolloutsConnectionIdempotencyPolicy::DeleteRollout( + google::cloud::cpp::compute::rollouts::v1::DeleteRolloutRequest const&) { + return Idempotency::kNonIdempotent; +} + +Idempotency RolloutsConnectionIdempotencyPolicy::GetRollout( + google::cloud::cpp::compute::rollouts::v1::GetRolloutRequest const&) { + return Idempotency::kIdempotent; +} + +Idempotency RolloutsConnectionIdempotencyPolicy::ListRollouts( + google::cloud::cpp::compute::rollouts::v1::ListRolloutsRequest) { // NOLINT + return Idempotency::kIdempotent; +} + +Idempotency RolloutsConnectionIdempotencyPolicy::Pause( + google::cloud::cpp::compute::rollouts::v1::PauseRequest const&) { + return Idempotency::kNonIdempotent; +} + +Idempotency RolloutsConnectionIdempotencyPolicy::Resume( + google::cloud::cpp::compute::rollouts::v1::ResumeRequest const&) { + return Idempotency::kNonIdempotent; +} + +std::unique_ptr +MakeDefaultRolloutsConnectionIdempotencyPolicy() { + return std::make_unique(); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_rollouts_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/rollouts/v1/rollouts_connection_idempotency_policy.h b/google/cloud/compute/rollouts/v1/rollouts_connection_idempotency_policy.h new file mode 100644 index 0000000000000..6a42a3eb37949 --- /dev/null +++ b/google/cloud/compute/rollouts/v1/rollouts_connection_idempotency_policy.h @@ -0,0 +1,71 @@ +// Copyright 2026 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. +// source: google/cloud/compute/rollouts/v1/rollouts.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUTS_V1_ROLLOUTS_CONNECTION_IDEMPOTENCY_POLICY_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUTS_V1_ROLLOUTS_CONNECTION_IDEMPOTENCY_POLICY_H + +#include "google/cloud/compute/rollouts/v1/rollouts.pb.h" +#include "google/cloud/idempotency.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_rollouts_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class RolloutsConnectionIdempotencyPolicy { + public: + virtual ~RolloutsConnectionIdempotencyPolicy(); + + /// Create a new copy of this object. + virtual std::unique_ptr clone() const; + + virtual google::cloud::Idempotency Advance( + google::cloud::cpp::compute::rollouts::v1::AdvanceRequest const& request); + + virtual google::cloud::Idempotency Cancel( + google::cloud::cpp::compute::rollouts::v1::CancelRequest const& request); + + virtual google::cloud::Idempotency DeleteRollout( + google::cloud::cpp::compute::rollouts::v1::DeleteRolloutRequest const& + request); + + virtual google::cloud::Idempotency GetRollout( + google::cloud::cpp::compute::rollouts::v1::GetRolloutRequest const& + request); + + virtual google::cloud::Idempotency ListRollouts( + google::cloud::cpp::compute::rollouts::v1::ListRolloutsRequest request); + + virtual google::cloud::Idempotency Pause( + google::cloud::cpp::compute::rollouts::v1::PauseRequest const& request); + + virtual google::cloud::Idempotency Resume( + google::cloud::cpp::compute::rollouts::v1::ResumeRequest const& request); +}; + +std::unique_ptr +MakeDefaultRolloutsConnectionIdempotencyPolicy(); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_rollouts_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUTS_V1_ROLLOUTS_CONNECTION_IDEMPOTENCY_POLICY_H diff --git a/google/cloud/compute/rollouts/v1/rollouts_options.h b/google/cloud/compute/rollouts/v1/rollouts_options.h new file mode 100644 index 0000000000000..2594be6d03b01 --- /dev/null +++ b/google/cloud/compute/rollouts/v1/rollouts_options.h @@ -0,0 +1,86 @@ +// Copyright 2026 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. +// source: google/cloud/compute/rollouts/v1/rollouts.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUTS_V1_ROLLOUTS_OPTIONS_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUTS_V1_ROLLOUTS_OPTIONS_H + +#include "google/cloud/compute/rollouts/v1/rollouts_connection.h" +#include "google/cloud/compute/rollouts/v1/rollouts_connection_idempotency_policy.h" +#include "google/cloud/backoff_policy.h" +#include "google/cloud/options.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_rollouts_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/** + * Use with `google::cloud::Options` to configure the retry policy. + * + * @ingroup google-cloud-compute-options + */ +struct RolloutsRetryPolicyOption { + using Type = std::shared_ptr; +}; + +/** + * Use with `google::cloud::Options` to configure the backoff policy. + * + * @ingroup google-cloud-compute-options + */ +struct RolloutsBackoffPolicyOption { + using Type = std::shared_ptr; +}; + +/** + * Use with `google::cloud::Options` to configure which operations are retried. + * + * @ingroup google-cloud-compute-options + */ +struct RolloutsConnectionIdempotencyPolicyOption { + using Type = std::shared_ptr; +}; + +/** + * Use with `google::cloud::Options` to configure the long-running operations + * polling policy. + * + * @ingroup google-cloud-compute-options + */ +struct RolloutsPollingPolicyOption { + using Type = std::shared_ptr; +}; + +/** + * The options applicable to Rollouts. + * + * @ingroup google-cloud-compute-options + */ +using RolloutsPolicyOptionList = + OptionList; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_rollouts_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUTS_V1_ROLLOUTS_OPTIONS_H diff --git a/google/cloud/compute/rollouts/v1/rollouts_proto_export.h b/google/cloud/compute/rollouts/v1/rollouts_proto_export.h new file mode 100644 index 0000000000000..f7129dc087c8d --- /dev/null +++ b/google/cloud/compute/rollouts/v1/rollouts_proto_export.h @@ -0,0 +1,33 @@ +// Copyright 2026 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_ROLLOUTS_V1_ROLLOUTS_PROTO_EXPORT_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUTS_V1_ROLLOUTS_PROTO_EXPORT_H + +// IWYU pragma: begin_exports +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_136.pb.h" +// IWYU pragma: end_exports + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUTS_V1_ROLLOUTS_PROTO_EXPORT_H diff --git a/google/cloud/compute/rollouts/v1/rollouts_rest_connection.cc b/google/cloud/compute/rollouts/v1/rollouts_rest_connection.cc new file mode 100644 index 0000000000000..f150226a8961c --- /dev/null +++ b/google/cloud/compute/rollouts/v1/rollouts_rest_connection.cc @@ -0,0 +1,58 @@ +// Copyright 2026 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. +// source: google/cloud/compute/rollouts/v1/rollouts.proto + +#include "google/cloud/compute/rollouts/v1/rollouts_rest_connection.h" +#include "google/cloud/compute/rollouts/v1/internal/rollouts_option_defaults.h" +#include "google/cloud/compute/rollouts/v1/internal/rollouts_rest_connection_impl.h" +#include "google/cloud/compute/rollouts/v1/internal/rollouts_rest_stub_factory.h" +#include "google/cloud/compute/rollouts/v1/internal/rollouts_tracing_connection.h" +#include "google/cloud/compute/rollouts/v1/rollouts_options.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/internal/rest_background_threads_impl.h" +#include "google/cloud/internal/rest_options.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_rollouts_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +std::shared_ptr MakeRolloutsConnectionRest( + Options options) { + internal::CheckExpectedOptions< + CommonOptionList, RestOptionList, UnifiedCredentialsOptionList, + rest_internal::TargetApiVersionOption, RolloutsPolicyOptionList>( + options, __func__); + options = + compute_rollouts_v1_internal::RolloutsDefaultOptions(std::move(options)); + auto background = std::make_unique< + rest_internal::AutomaticallyCreatedRestBackgroundThreads>(); + auto stub = + compute_rollouts_v1_internal::CreateDefaultRolloutsRestStub(options); + return compute_rollouts_v1_internal::MakeRolloutsTracingConnection( + std::make_shared< + compute_rollouts_v1_internal::RolloutsRestConnectionImpl>( + std::move(background), std::move(stub), std::move(options))); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_rollouts_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/rollouts/v1/rollouts_rest_connection.h b/google/cloud/compute/rollouts/v1/rollouts_rest_connection.h new file mode 100644 index 0000000000000..802f14e57a558 --- /dev/null +++ b/google/cloud/compute/rollouts/v1/rollouts_rest_connection.h @@ -0,0 +1,64 @@ +// Copyright 2026 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. +// source: google/cloud/compute/rollouts/v1/rollouts.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUTS_V1_ROLLOUTS_REST_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUTS_V1_ROLLOUTS_REST_CONNECTION_H + +#include "google/cloud/compute/rollouts/v1/rollouts_connection.h" +#include "google/cloud/options.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_rollouts_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/** + * A factory function to construct an object of type `RolloutsConnection` + * that uses REST over HTTP as transport in lieu of gRPC. REST transport should + * only be used for services that do not support gRPC or if the existing network + * configuration precludes using gRPC. + * + * The returned connection object should not be used directly; instead it + * should be passed as an argument to the constructor of RolloutsClient. + * + * The optional @p options argument may be used to configure aspects of the + * returned `RolloutsConnection`. Expected options are any of the types in + * the following option lists: + * + * - `google::cloud::CommonOptionList` + * - `google::cloud::RestOptionList` + * - `google::cloud::UnifiedCredentialsOptionList` + * - `google::cloud::compute_rollouts_v1::RolloutsPolicyOptionList` + * + * @note Unexpected options will be ignored. To log unexpected options instead, + * set `GOOGLE_CLOUD_CPP_ENABLE_CLOG=yes` in the environment. + * + * @param options (optional) Configure the `RolloutsConnection` created by + * this function. + */ +std::shared_ptr MakeRolloutsConnectionRest( + Options options = {}); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_rollouts_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROLLOUTS_V1_ROLLOUTS_REST_CONNECTION_H diff --git a/google/cloud/compute/rollouts/v1/samples/rollouts_client_samples.cc b/google/cloud/compute/rollouts/v1/samples/rollouts_client_samples.cc new file mode 100644 index 0000000000000..2bdcd4813ef35 --- /dev/null +++ b/google/cloud/compute/rollouts/v1/samples/rollouts_client_samples.cc @@ -0,0 +1,228 @@ +// Copyright 2026 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. +// source: google/cloud/compute/rollouts/v1/rollouts.proto + +#include "google/cloud/compute/rollouts/v1/rollouts_client.h" +#include "google/cloud/compute/rollouts/v1/rollouts_connection_idempotency_policy.h" +#include "google/cloud/compute/rollouts/v1/rollouts_options.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/internal/getenv.h" +#include "google/cloud/polling_policy.h" +#include "google/cloud/testing_util/example_driver.h" +#include "google/cloud/universe_domain.h" +#include +#include +#include +#include + +// clang-format off +// main-dox-marker: compute_rollouts_v1::RolloutsClient +// lro-marker: true +// clang-format on +namespace { + +void SetClientEndpoint(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-endpoint"}; + } + //! [set-client-endpoint] + // This configuration is common with Private Google Access: + // https://cloud.google.com/vpc/docs/private-google-access + auto options = google::cloud::Options{}.set( + "private.googleapis.com"); + auto vpc_client = google::cloud::compute_rollouts_v1::RolloutsClient( + google::cloud::compute_rollouts_v1::MakeRolloutsConnectionRest(options)); + //! [set-client-endpoint] +} + +void SetClientUniverseDomain(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-universe-domain"}; + } + //! [set-client-universe-domain] + google::cloud::Options options; + + // AddUniverseDomainOption interrogates the UnifiedCredentialsOption, if set, + // in the provided Options for the Universe Domain associated with the + // credentials and adds it to the set of Options. + // If no UnifiedCredentialsOption is set, GoogleDefaultCredentials are used. + auto ud_options = google::cloud::AddUniverseDomainOption(std::move(options)); + + if (!ud_options.ok()) throw std::move(ud_options).status(); + auto ud_client = google::cloud::compute_rollouts_v1::RolloutsClient( + google::cloud::compute_rollouts_v1::MakeRolloutsConnectionRest( + *ud_options)); + //! [set-client-universe-domain] +} + +//! [custom-idempotency-policy] +class CustomIdempotencyPolicy : public google::cloud::compute_rollouts_v1:: + RolloutsConnectionIdempotencyPolicy { + public: + ~CustomIdempotencyPolicy() override = default; + std::unique_ptr< + google::cloud::compute_rollouts_v1::RolloutsConnectionIdempotencyPolicy> + clone() const override { + return std::make_unique(*this); + } + // Override inherited functions to define as needed. +}; +//! [custom-idempotency-policy] + +void SetRetryPolicy(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-retry-policy"}; + } + //! [set-retry-policy] + auto options = + google::cloud::Options{} + .set( + CustomIdempotencyPolicy().clone()) + .set( + google::cloud::compute_rollouts_v1:: + RolloutsLimitedErrorCountRetryPolicy(3) + .clone()) + .set( + google::cloud::ExponentialBackoffPolicy( + /*initial_delay=*/std::chrono::milliseconds(200), + /*maximum_delay=*/std::chrono::seconds(45), + /*scaling=*/2.0) + .clone()); + auto connection = + google::cloud::compute_rollouts_v1::MakeRolloutsConnectionRest(options); + + // c1 and c2 share the same retry policies + auto c1 = google::cloud::compute_rollouts_v1::RolloutsClient(connection); + auto c2 = google::cloud::compute_rollouts_v1::RolloutsClient(connection); + + // You can override any of the policies in a new client. This new client + // will share the policies from c1 (or c2) *except* for the retry policy. + auto c3 = google::cloud::compute_rollouts_v1::RolloutsClient( + connection, + google::cloud::Options{} + .set( + google::cloud::compute_rollouts_v1:: + RolloutsLimitedTimeRetryPolicy(std::chrono::minutes(5)) + .clone())); + + // You can also override the policies in a single call: + // c3.SomeRpc(..., google::cloud::Options{} + // .set( + // google::cloud::compute_rollouts_v1::RolloutsLimitedErrorCountRetryPolicy(10).clone())); + //! [set-retry-policy] +} + +void SetPollingPolicy(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-policy-policy"}; + } + //! [set-polling-policy] + + // The polling policy controls how the client waits for long-running + // operations. `GenericPollingPolicy<>` combines existing policies. + // In this case, keep polling until the operation completes (with success + // or error) or 45 minutes, whichever happens first. Initially pause for + // 10 seconds between polling requests, increasing the pause by a factor + // of 4 until it becomes 2 minutes. + auto options = + google::cloud::Options{} + .set( + google::cloud::GenericPollingPolicy< + google::cloud::compute_rollouts_v1:: + RolloutsRetryPolicyOption::Type, + google::cloud::compute_rollouts_v1:: + RolloutsBackoffPolicyOption::Type>( + google::cloud::compute_rollouts_v1:: + RolloutsLimitedTimeRetryPolicy( + /*maximum_duration=*/std::chrono::minutes(45)) + .clone(), + google::cloud::ExponentialBackoffPolicy( + /*initial_delay=*/std::chrono::seconds(10), + /*maximum_delay=*/std::chrono::minutes(2), + /*scaling=*/4.0) + .clone()) + .clone()); + + auto connection = + google::cloud::compute_rollouts_v1::MakeRolloutsConnectionRest(options); + + // c1 and c2 share the same polling policies. + auto c1 = google::cloud::compute_rollouts_v1::RolloutsClient(connection); + auto c2 = google::cloud::compute_rollouts_v1::RolloutsClient(connection); + //! [set-polling-policy] +} + +void WithServiceAccount(std::vector const& argv) { + if (argv.size() != 1 || argv[0] == "--help") { + throw google::cloud::testing_util::Usage{"with-service-account "}; + } + //! [with-service-account] + [](std::string const& keyfile) { + auto is = std::ifstream(keyfile); + is.exceptions(std::ios::badbit); // Minimal error handling in examples + auto contents = std::string(std::istreambuf_iterator(is.rdbuf()), {}); + auto options = + google::cloud::Options{}.set( + google::cloud::MakeServiceAccountCredentials(contents)); + return google::cloud::compute_rollouts_v1::RolloutsClient( + google::cloud::compute_rollouts_v1::MakeRolloutsConnectionRest( + options)); + } + //! [with-service-account] + (argv.at(0)); +} + +void AutoRun(std::vector const& argv) { + namespace examples = ::google::cloud::testing_util; + using ::google::cloud::internal::GetEnv; + if (!argv.empty()) throw examples::Usage{"auto"}; + examples::CheckEnvironmentVariablesAreSet( + {"GOOGLE_CLOUD_CPP_TEST_SERVICE_ACCOUNT_KEYFILE"}); + auto const keyfile = + GetEnv("GOOGLE_CLOUD_CPP_TEST_SERVICE_ACCOUNT_KEYFILE").value(); + + std::cout << "\nRunning SetClientEndpoint() example" << std::endl; + SetClientEndpoint({}); + + std::cout << "\nRunning SetRetryPolicy() example" << std::endl; + SetRetryPolicy({}); + + std::cout << "\nRunning SetPollingPolicy() example" << std::endl; + SetPollingPolicy({}); + + std::cout << "\nRunning WithServiceAccount() example" << std::endl; + WithServiceAccount({keyfile}); + + std::cout << "\nRunning SetClientUniverseDomain() example" << std::endl; + SetClientUniverseDomain({}); +} + +} // namespace + +int main(int argc, char* argv[]) { // NOLINT(bugprone-exception-escape) + google::cloud::testing_util::Example example({ + {"set-client-endpoint", SetClientEndpoint}, + {"set-retry-policy", SetRetryPolicy}, + {"set-polling-policy", SetPollingPolicy}, + {"with-service-account", WithServiceAccount}, + {"set-client-universe-domain", SetClientUniverseDomain}, + {"auto", AutoRun}, + }); + return example.Run(argc, argv); +} diff --git a/google/cloud/compute/routers/v1/internal/routers_rest_connection_impl.cc b/google/cloud/compute/routers/v1/internal/routers_rest_connection_impl.cc index 13579ce4445cf..b4ca6ad50b22e 100644 --- a/google/cloud/compute/routers/v1/internal/routers_rest_connection_impl.cc +++ b/google/cloud/compute/routers/v1/internal/routers_rest_connection_impl.cc @@ -217,6 +217,140 @@ RoutersRestConnectionImpl::DeleteRouter( }); } +future> +RoutersRestConnectionImpl::DeleteNamedSet( + google::cloud::cpp::compute::routers::v1::DeleteNamedSetRequest const& + request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::region_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, request, + [stub = stub_]( + CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::routers::v1::DeleteNamedSetRequest const& + request) { + return stub->AsyncDeleteNamedSet(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->DeleteNamedSet(request), + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [request](std::string const& op, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest& r) { + r.set_project(request.project()); + r.set_region(request.region()); + r.set_operation(op); + }, + [request](std::string const& op, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest& r) { + r.set_project(request.project()); + r.set_region(request.region()); + r.set_operation(op); + }); +} + +StatusOr +RoutersRestConnectionImpl::DeleteNamedSet( + NoAwaitTag, + google::cloud::cpp::compute::routers::v1::DeleteNamedSetRequest const& + request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->DeleteNamedSet(request), + [this]( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::routers::v1::DeleteNamedSetRequest const& + request) { + return stub_->DeleteNamedSet(rest_context, options, request); + }, + *current, request, __func__); +} + +future> +RoutersRestConnectionImpl::DeleteNamedSet( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestAwaitLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::region_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, operation, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [operation](std::string const&, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_region(info.region); + r.set_operation(info.operation); + }, + [operation](std::string const&, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_region(info.region); + r.set_operation(info.operation); + }); +} + future> RoutersRestConnectionImpl::DeleteRoutePolicy( google::cloud::cpp::compute::routers::v1::DeleteRoutePolicyRequest const& @@ -364,6 +498,22 @@ RoutersRestConnectionImpl::GetRouter( *current, request, __func__); } +StatusOr +RoutersRestConnectionImpl::GetNamedSet( + google::cloud::cpp::compute::routers::v1::GetNamedSetRequest const& + request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->GetNamedSet(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::routers::v1::GetNamedSetRequest const& + request) { + return stub_->GetNamedSet(rest_context, options, request); + }, + *current, request, __func__); +} + StatusOr RoutersRestConnectionImpl::GetNatIpInfo( google::cloud::cpp::compute::routers::v1::GetNatIpInfoRequest const& @@ -617,6 +767,23 @@ RoutersRestConnectionImpl::ListBgpRoutes( *current, request, __func__); } +StatusOr +RoutersRestConnectionImpl::ListNamedSets( + google::cloud::cpp::compute::routers::v1::ListNamedSetsRequest const& + request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->ListNamedSets(request), + [this]( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::routers::v1::ListNamedSetsRequest const& + request) { + return stub_->ListNamedSets(rest_context, options, request); + }, + *current, request, __func__); +} + StatusOr RoutersRestConnectionImpl::ListRoutePolicies( google::cloud::cpp::compute::routers::v1::ListRoutePoliciesRequest const& @@ -766,6 +933,140 @@ RoutersRestConnectionImpl::PatchRouter( }); } +future> +RoutersRestConnectionImpl::PatchNamedSet( + google::cloud::cpp::compute::routers::v1::PatchNamedSetRequest const& + request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::region_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, request, + [stub = stub_]( + CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::routers::v1::PatchNamedSetRequest const& + request) { + return stub->AsyncPatchNamedSet(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->PatchNamedSet(request), + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [request](std::string const& op, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest& r) { + r.set_project(request.project()); + r.set_region(request.region()); + r.set_operation(op); + }, + [request](std::string const& op, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest& r) { + r.set_project(request.project()); + r.set_region(request.region()); + r.set_operation(op); + }); +} + +StatusOr +RoutersRestConnectionImpl::PatchNamedSet( + NoAwaitTag, + google::cloud::cpp::compute::routers::v1::PatchNamedSetRequest const& + request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->PatchNamedSet(request), + [this]( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::routers::v1::PatchNamedSetRequest const& + request) { + return stub_->PatchNamedSet(rest_context, options, request); + }, + *current, request, __func__); +} + +future> +RoutersRestConnectionImpl::PatchNamedSet( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestAwaitLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::region_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, operation, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [operation](std::string const&, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_region(info.region); + r.set_operation(info.operation); + }, + [operation](std::string const&, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_region(info.region); + r.set_operation(info.operation); + }); +} + future> RoutersRestConnectionImpl::PatchRoutePolicy( google::cloud::cpp::compute::routers::v1::PatchRoutePolicyRequest const& @@ -1047,6 +1348,140 @@ RoutersRestConnectionImpl::UpdateRouter( }); } +future> +RoutersRestConnectionImpl::UpdateNamedSet( + google::cloud::cpp::compute::routers::v1::UpdateNamedSetRequest const& + request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::region_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, request, + [stub = stub_]( + CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::routers::v1::UpdateNamedSetRequest const& + request) { + return stub->AsyncUpdateNamedSet(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->UpdateNamedSet(request), + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [request](std::string const& op, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest& r) { + r.set_project(request.project()); + r.set_region(request.region()); + r.set_operation(op); + }, + [request](std::string const& op, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest& r) { + r.set_project(request.project()); + r.set_region(request.region()); + r.set_operation(op); + }); +} + +StatusOr +RoutersRestConnectionImpl::UpdateNamedSet( + NoAwaitTag, + google::cloud::cpp::compute::routers::v1::UpdateNamedSetRequest const& + request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->UpdateNamedSet(request), + [this]( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::routers::v1::UpdateNamedSetRequest const& + request) { + return stub_->UpdateNamedSet(rest_context, options, request); + }, + *current, request, __func__); +} + +future> +RoutersRestConnectionImpl::UpdateNamedSet( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestAwaitLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::region_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, operation, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [operation](std::string const&, + google::cloud::cpp::compute::region_operations::v1:: + GetOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_region(info.region); + r.set_operation(info.operation); + }, + [operation](std::string const&, + google::cloud::cpp::compute::region_operations::v1:: + DeleteOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_region(info.region); + r.set_operation(info.operation); + }); +} + future> RoutersRestConnectionImpl::UpdateRoutePolicy( google::cloud::cpp::compute::routers::v1::UpdateRoutePolicyRequest const& diff --git a/google/cloud/compute/routers/v1/internal/routers_rest_connection_impl.h b/google/cloud/compute/routers/v1/internal/routers_rest_connection_impl.h index 9b52454754c99..1af18bd8bfb5e 100644 --- a/google/cloud/compute/routers/v1/internal/routers_rest_connection_impl.h +++ b/google/cloud/compute/routers/v1/internal/routers_rest_connection_impl.h @@ -67,6 +67,18 @@ class RoutersRestConnectionImpl : public compute_routers_v1::RoutersConnection { future> DeleteRouter( google::cloud::cpp::compute::v1::Operation const& operation) override; + future> DeleteNamedSet( + google::cloud::cpp::compute::routers::v1::DeleteNamedSetRequest const& + request) override; + + StatusOr DeleteNamedSet( + NoAwaitTag, + google::cloud::cpp::compute::routers::v1::DeleteNamedSetRequest const& + request) override; + + future> DeleteNamedSet( + google::cloud::cpp::compute::v1::Operation const& operation) override; + future> DeleteRoutePolicy( google::cloud::cpp::compute::routers::v1::DeleteRoutePolicyRequest const& @@ -85,6 +97,11 @@ class RoutersRestConnectionImpl : public compute_routers_v1::RoutersConnection { google::cloud::cpp::compute::routers::v1::GetRouterRequest const& request) override; + StatusOr + GetNamedSet( + google::cloud::cpp::compute::routers::v1::GetNamedSetRequest const& + request) override; + StatusOr GetNatIpInfo( google::cloud::cpp::compute::routers::v1::GetNatIpInfoRequest const& request) override; @@ -124,6 +141,10 @@ class RoutersRestConnectionImpl : public compute_routers_v1::RoutersConnection { google::cloud::cpp::compute::routers::v1::ListBgpRoutesRequest const& request) override; + StatusOr ListNamedSets( + google::cloud::cpp::compute::routers::v1::ListNamedSetsRequest const& + request) override; + StatusOr ListRoutePolicies( google::cloud::cpp::compute::routers::v1::ListRoutePoliciesRequest const& @@ -141,6 +162,18 @@ class RoutersRestConnectionImpl : public compute_routers_v1::RoutersConnection { future> PatchRouter( google::cloud::cpp::compute::v1::Operation const& operation) override; + future> PatchNamedSet( + google::cloud::cpp::compute::routers::v1::PatchNamedSetRequest const& + request) override; + + StatusOr PatchNamedSet( + NoAwaitTag, + google::cloud::cpp::compute::routers::v1::PatchNamedSetRequest const& + request) override; + + future> PatchNamedSet( + google::cloud::cpp::compute::v1::Operation const& operation) override; + future> PatchRoutePolicy( google::cloud::cpp::compute::routers::v1::PatchRoutePolicyRequest const& request) override; @@ -169,6 +202,18 @@ class RoutersRestConnectionImpl : public compute_routers_v1::RoutersConnection { future> UpdateRouter( google::cloud::cpp::compute::v1::Operation const& operation) override; + future> UpdateNamedSet( + google::cloud::cpp::compute::routers::v1::UpdateNamedSetRequest const& + request) override; + + StatusOr UpdateNamedSet( + NoAwaitTag, + google::cloud::cpp::compute::routers::v1::UpdateNamedSetRequest const& + request) override; + + future> UpdateNamedSet( + google::cloud::cpp::compute::v1::Operation const& operation) override; + future> UpdateRoutePolicy( google::cloud::cpp::compute::routers::v1::UpdateRoutePolicyRequest const& diff --git a/google/cloud/compute/routers/v1/internal/routers_rest_logging_decorator.cc b/google/cloud/compute/routers/v1/internal/routers_rest_logging_decorator.cc index 1d8a3e28595a6..f4dfb5bdd1e8f 100644 --- a/google/cloud/compute/routers/v1/internal/routers_rest_logging_decorator.cc +++ b/google/cloud/compute/routers/v1/internal/routers_rest_logging_decorator.cc @@ -84,6 +84,42 @@ RoutersRestLogging::DeleteRouter( rest_context, options, request, __func__, tracing_options_); } +future> +RoutersRestLogging::AsyncDeleteNamedSet( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::routers::v1::DeleteNamedSetRequest const& + request) { + return google::cloud::internal::LogWrapper( + [this]( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::routers::v1::DeleteNamedSetRequest const& + request) { + return child_->AsyncDeleteNamedSet(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +StatusOr +RoutersRestLogging::DeleteNamedSet( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::routers::v1::DeleteNamedSetRequest const& + request) { + return google::cloud::internal::LogWrapper( + [this]( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::routers::v1::DeleteNamedSetRequest const& + request) { + return child_->DeleteNamedSet(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + future> RoutersRestLogging::AsyncDeleteRoutePolicy( CompletionQueue& cq, @@ -130,6 +166,20 @@ StatusOr RoutersRestLogging::GetRouter( rest_context, options, request, __func__, tracing_options_); } +StatusOr +RoutersRestLogging::GetNamedSet( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::routers::v1::GetNamedSetRequest const& + request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::routers::v1::GetNamedSetRequest const& + request) { + return child_->GetNamedSet(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + StatusOr RoutersRestLogging::GetNatIpInfo( rest_internal::RestContext& rest_context, Options const& options, @@ -253,6 +303,21 @@ RoutersRestLogging::ListBgpRoutes( rest_context, options, request, __func__, tracing_options_); } +StatusOr +RoutersRestLogging::ListNamedSets( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::routers::v1::ListNamedSetsRequest const& + request) { + return google::cloud::internal::LogWrapper( + [this]( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::routers::v1::ListNamedSetsRequest const& + request) { + return child_->ListNamedSets(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + StatusOr RoutersRestLogging::ListRoutePolicies( rest_internal::RestContext& rest_context, Options const& options, @@ -301,6 +366,42 @@ RoutersRestLogging::PatchRouter( rest_context, options, request, __func__, tracing_options_); } +future> +RoutersRestLogging::AsyncPatchNamedSet( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::routers::v1::PatchNamedSetRequest const& + request) { + return google::cloud::internal::LogWrapper( + [this]( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::routers::v1::PatchNamedSetRequest const& + request) { + return child_->AsyncPatchNamedSet(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +StatusOr +RoutersRestLogging::PatchNamedSet( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::routers::v1::PatchNamedSetRequest const& + request) { + return google::cloud::internal::LogWrapper( + [this]( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::routers::v1::PatchNamedSetRequest const& + request) { + return child_->PatchNamedSet(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + future> RoutersRestLogging::AsyncPatchRoutePolicy( CompletionQueue& cq, @@ -384,6 +485,42 @@ RoutersRestLogging::UpdateRouter( rest_context, options, request, __func__, tracing_options_); } +future> +RoutersRestLogging::AsyncUpdateNamedSet( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::routers::v1::UpdateNamedSetRequest const& + request) { + return google::cloud::internal::LogWrapper( + [this]( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::routers::v1::UpdateNamedSetRequest const& + request) { + return child_->AsyncUpdateNamedSet(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +StatusOr +RoutersRestLogging::UpdateNamedSet( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::routers::v1::UpdateNamedSetRequest const& + request) { + return google::cloud::internal::LogWrapper( + [this]( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::routers::v1::UpdateNamedSetRequest const& + request) { + return child_->UpdateNamedSet(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + future> RoutersRestLogging::AsyncUpdateRoutePolicy( CompletionQueue& cq, diff --git a/google/cloud/compute/routers/v1/internal/routers_rest_logging_decorator.h b/google/cloud/compute/routers/v1/internal/routers_rest_logging_decorator.h index eb10d4f068f4c..8580fbefc2abb 100644 --- a/google/cloud/compute/routers/v1/internal/routers_rest_logging_decorator.h +++ b/google/cloud/compute/routers/v1/internal/routers_rest_logging_decorator.h @@ -63,6 +63,20 @@ class RoutersRestLogging : public RoutersRestStub { google::cloud::cpp::compute::routers::v1::DeleteRouterRequest const& request) override; + future> + AsyncDeleteNamedSet( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::routers::v1::DeleteNamedSetRequest const& + request) override; + + StatusOr DeleteNamedSet( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::routers::v1::DeleteNamedSetRequest const& + request) override; + future> AsyncDeleteRoutePolicy( google::cloud::CompletionQueue& cq, @@ -83,6 +97,13 @@ class RoutersRestLogging : public RoutersRestStub { google::cloud::cpp::compute::routers::v1::GetRouterRequest const& request) override; + StatusOr + GetNamedSet( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::routers::v1::GetNamedSetRequest const& + request) override; + StatusOr GetNatIpInfo( google::cloud::rest_internal::RestContext& rest_context, Options const& options, @@ -136,6 +157,12 @@ class RoutersRestLogging : public RoutersRestStub { google::cloud::cpp::compute::routers::v1::ListBgpRoutesRequest const& request) override; + StatusOr ListNamedSets( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::routers::v1::ListNamedSetsRequest const& + request) override; + StatusOr ListRoutePolicies( google::cloud::rest_internal::RestContext& rest_context, @@ -156,6 +183,20 @@ class RoutersRestLogging : public RoutersRestStub { google::cloud::cpp::compute::routers::v1::PatchRouterRequest const& request) override; + future> + AsyncPatchNamedSet( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::routers::v1::PatchNamedSetRequest const& + request) override; + + StatusOr PatchNamedSet( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::routers::v1::PatchNamedSetRequest const& + request) override; + future> AsyncPatchRoutePolicy( google::cloud::CompletionQueue& cq, @@ -190,6 +231,20 @@ class RoutersRestLogging : public RoutersRestStub { google::cloud::cpp::compute::routers::v1::UpdateRouterRequest const& request) override; + future> + AsyncUpdateNamedSet( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::routers::v1::UpdateNamedSetRequest const& + request) override; + + StatusOr UpdateNamedSet( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::routers::v1::UpdateNamedSetRequest const& + request) override; + future> AsyncUpdateRoutePolicy( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/routers/v1/internal/routers_rest_metadata_decorator.cc b/google/cloud/compute/routers/v1/internal/routers_rest_metadata_decorator.cc index 2763fe10af6c3..0101373fc8357 100644 --- a/google/cloud/compute/routers/v1/internal/routers_rest_metadata_decorator.cc +++ b/google/cloud/compute/routers/v1/internal/routers_rest_metadata_decorator.cc @@ -68,6 +68,27 @@ RoutersRestMetadata::DeleteRouter( return child_->DeleteRouter(rest_context, options, request); } +future> +RoutersRestMetadata::AsyncDeleteNamedSet( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::routers::v1::DeleteNamedSetRequest const& + request) { + SetMetadata(*rest_context, *options); + return child_->AsyncDeleteNamedSet(cq, std::move(rest_context), + std::move(options), request); +} + +StatusOr +RoutersRestMetadata::DeleteNamedSet( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::routers::v1::DeleteNamedSetRequest const& + request) { + SetMetadata(rest_context, options); + return child_->DeleteNamedSet(rest_context, options, request); +} + future> RoutersRestMetadata::AsyncDeleteRoutePolicy( CompletionQueue& cq, @@ -97,6 +118,15 @@ RoutersRestMetadata::GetRouter( return child_->GetRouter(rest_context, options, request); } +StatusOr +RoutersRestMetadata::GetNamedSet( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::routers::v1::GetNamedSetRequest const& + request) { + SetMetadata(rest_context, options); + return child_->GetNamedSet(rest_context, options, request); +} + StatusOr RoutersRestMetadata::GetNatIpInfo( rest_internal::RestContext& rest_context, Options const& options, @@ -172,6 +202,15 @@ RoutersRestMetadata::ListBgpRoutes( return child_->ListBgpRoutes(rest_context, options, request); } +StatusOr +RoutersRestMetadata::ListNamedSets( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::routers::v1::ListNamedSetsRequest const& + request) { + SetMetadata(rest_context, options); + return child_->ListNamedSets(rest_context, options, request); +} + StatusOr RoutersRestMetadata::ListRoutePolicies( rest_internal::RestContext& rest_context, Options const& options, @@ -202,6 +241,27 @@ RoutersRestMetadata::PatchRouter( return child_->PatchRouter(rest_context, options, request); } +future> +RoutersRestMetadata::AsyncPatchNamedSet( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::routers::v1::PatchNamedSetRequest const& + request) { + SetMetadata(*rest_context, *options); + return child_->AsyncPatchNamedSet(cq, std::move(rest_context), + std::move(options), request); +} + +StatusOr +RoutersRestMetadata::PatchNamedSet( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::routers::v1::PatchNamedSetRequest const& + request) { + SetMetadata(rest_context, options); + return child_->PatchNamedSet(rest_context, options, request); +} + future> RoutersRestMetadata::AsyncPatchRoutePolicy( CompletionQueue& cq, @@ -252,6 +312,27 @@ RoutersRestMetadata::UpdateRouter( return child_->UpdateRouter(rest_context, options, request); } +future> +RoutersRestMetadata::AsyncUpdateNamedSet( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::routers::v1::UpdateNamedSetRequest const& + request) { + SetMetadata(*rest_context, *options); + return child_->AsyncUpdateNamedSet(cq, std::move(rest_context), + std::move(options), request); +} + +StatusOr +RoutersRestMetadata::UpdateNamedSet( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::routers::v1::UpdateNamedSetRequest const& + request) { + SetMetadata(rest_context, options); + return child_->UpdateNamedSet(rest_context, options, request); +} + future> RoutersRestMetadata::AsyncUpdateRoutePolicy( CompletionQueue& cq, diff --git a/google/cloud/compute/routers/v1/internal/routers_rest_metadata_decorator.h b/google/cloud/compute/routers/v1/internal/routers_rest_metadata_decorator.h index 3c31e3febaaff..abb974524a0b4 100644 --- a/google/cloud/compute/routers/v1/internal/routers_rest_metadata_decorator.h +++ b/google/cloud/compute/routers/v1/internal/routers_rest_metadata_decorator.h @@ -60,6 +60,20 @@ class RoutersRestMetadata : public RoutersRestStub { google::cloud::cpp::compute::routers::v1::DeleteRouterRequest const& request) override; + google::cloud::future> + AsyncDeleteNamedSet( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::routers::v1::DeleteNamedSetRequest const& + request) override; + + StatusOr DeleteNamedSet( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::routers::v1::DeleteNamedSetRequest const& + request) override; + google::cloud::future> AsyncDeleteRoutePolicy( google::cloud::CompletionQueue& cq, @@ -80,6 +94,13 @@ class RoutersRestMetadata : public RoutersRestStub { google::cloud::cpp::compute::routers::v1::GetRouterRequest const& request) override; + StatusOr + GetNamedSet( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::routers::v1::GetNamedSetRequest const& + request) override; + StatusOr GetNatIpInfo( google::cloud::rest_internal::RestContext& rest_context, Options const& options, @@ -133,6 +154,12 @@ class RoutersRestMetadata : public RoutersRestStub { google::cloud::cpp::compute::routers::v1::ListBgpRoutesRequest const& request) override; + StatusOr ListNamedSets( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::routers::v1::ListNamedSetsRequest const& + request) override; + StatusOr ListRoutePolicies( google::cloud::rest_internal::RestContext& rest_context, @@ -154,6 +181,20 @@ class RoutersRestMetadata : public RoutersRestStub { google::cloud::cpp::compute::routers::v1::PatchRouterRequest const& request) override; + google::cloud::future> + AsyncPatchNamedSet( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::routers::v1::PatchNamedSetRequest const& + request) override; + + StatusOr PatchNamedSet( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::routers::v1::PatchNamedSetRequest const& + request) override; + google::cloud::future> AsyncPatchRoutePolicy( google::cloud::CompletionQueue& cq, @@ -188,6 +229,20 @@ class RoutersRestMetadata : public RoutersRestStub { google::cloud::cpp::compute::routers::v1::UpdateRouterRequest const& request) override; + google::cloud::future> + AsyncUpdateNamedSet( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::routers::v1::UpdateNamedSetRequest const& + request) override; + + StatusOr UpdateNamedSet( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::routers::v1::UpdateNamedSetRequest const& + request) override; + google::cloud::future> AsyncUpdateRoutePolicy( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/routers/v1/internal/routers_rest_stub.cc b/google/cloud/compute/routers/v1/internal/routers_rest_stub.cc index ee1096bf12dd3..af8f5aab2e36f 100644 --- a/google/cloud/compute/routers/v1/internal/routers_rest_stub.cc +++ b/google/cloud/compute/routers/v1/internal/routers_rest_stub.cc @@ -131,6 +131,57 @@ DefaultRoutersRestStub::DeleteRouter( std::move(query_params)); } +future> +DefaultRoutersRestStub::AsyncDeleteNamedSet( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::routers::v1::DeleteNamedSetRequest const& + request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto service, auto request, auto rest_context, auto options) { + std::vector> query_params; + p.set_value( + rest_internal::Post( + *service, *rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", *options), + "/", "projects", "/", request.project(), "/", + "regions", "/", request.region(), "/", "routers", + "/", request.router(), "/", "deleteNamedSet"), + std::move(query_params))); + }, + std::move(p), + service_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +StatusOr +DefaultRoutersRestStub::DeleteNamedSet( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::routers::v1::DeleteNamedSetRequest const& + request) { + std::vector> query_params; + return rest_internal::Post( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "regions", "/", + request.region(), "/", "routers", "/", request.router(), "/", + "deleteNamedSet"), + std::move(query_params)); +} + future> DefaultRoutersRestStub::AsyncDeleteRoutePolicy( CompletionQueue& cq, @@ -197,6 +248,27 @@ DefaultRoutersRestStub::GetRouter( std::move(query_params)); } +StatusOr +DefaultRoutersRestStub::GetNamedSet( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::routers::v1::GetNamedSetRequest const& + request) { + std::vector> query_params; + query_params.push_back({"named_set", request.named_set()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Get< + google::cloud::cpp::compute::v1::RoutersGetNamedSetResponse>( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "regions", "/", + request.region(), "/", "routers", "/", request.router(), "/", + "getNamedSet"), + std::move(query_params)); +} + StatusOr DefaultRoutersRestStub::GetNatIpInfo( google::cloud::rest_internal::RestContext& rest_context, @@ -397,6 +469,33 @@ DefaultRoutersRestStub::ListBgpRoutes( std::move(query_params)); } +StatusOr +DefaultRoutersRestStub::ListNamedSets( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::routers::v1::ListNamedSetsRequest const& + request) { + std::vector> query_params; + query_params.push_back({"filter", request.filter()}); + query_params.push_back( + {"max_results", std::to_string(request.max_results())}); + query_params.push_back({"order_by", request.order_by()}); + query_params.push_back({"page_token", request.page_token()}); + query_params.push_back({"return_partial_success", + (request.return_partial_success() ? "1" : "0")}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Get< + google::cloud::cpp::compute::v1::RoutersListNamedSets>( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "regions", "/", + request.region(), "/", "routers", "/", request.router(), "/", + "listNamedSets"), + std::move(query_params)); +} + StatusOr DefaultRoutersRestStub::ListRoutePolicies( google::cloud::rest_internal::RestContext& rest_context, @@ -480,6 +579,63 @@ DefaultRoutersRestStub::PatchRouter( std::move(query_params)); } +future> +DefaultRoutersRestStub::AsyncPatchNamedSet( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::routers::v1::PatchNamedSetRequest const& + request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto service, auto request, auto rest_context, auto options) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + p.set_value( + rest_internal::Post( + *service, *rest_context, request.named_set_resource(), false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", *options), + "/", "projects", "/", request.project(), "/", + "regions", "/", request.region(), "/", "routers", + "/", request.router(), "/", "patchNamedSet"), + std::move(query_params))); + }, + std::move(p), + service_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +StatusOr +DefaultRoutersRestStub::PatchNamedSet( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::routers::v1::PatchNamedSetRequest const& + request) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Post( + *service_, rest_context, request.named_set_resource(), false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "regions", "/", + request.region(), "/", "routers", "/", request.router(), "/", + "patchNamedSet"), + std::move(query_params)); +} + future> DefaultRoutersRestStub::AsyncPatchRoutePolicy( CompletionQueue& cq, @@ -610,6 +766,63 @@ DefaultRoutersRestStub::UpdateRouter( std::move(query_params)); } +future> +DefaultRoutersRestStub::AsyncUpdateNamedSet( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::routers::v1::UpdateNamedSetRequest const& + request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto service, auto request, auto rest_context, auto options) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + p.set_value( + rest_internal::Post( + *service, *rest_context, request.named_set_resource(), false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", *options), + "/", "projects", "/", request.project(), "/", + "regions", "/", request.region(), "/", "routers", + "/", request.router(), "/", "updateNamedSet"), + std::move(query_params))); + }, + std::move(p), + service_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +StatusOr +DefaultRoutersRestStub::UpdateNamedSet( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::routers::v1::UpdateNamedSetRequest const& + request) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Post( + *service_, rest_context, request.named_set_resource(), false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "regions", "/", + request.region(), "/", "routers", "/", request.router(), "/", + "updateNamedSet"), + std::move(query_params)); +} + future> DefaultRoutersRestStub::AsyncUpdateRoutePolicy( CompletionQueue& cq, diff --git a/google/cloud/compute/routers/v1/internal/routers_rest_stub.h b/google/cloud/compute/routers/v1/internal/routers_rest_stub.h index 261af1927e8c7..907618f53d4c6 100644 --- a/google/cloud/compute/routers/v1/internal/routers_rest_stub.h +++ b/google/cloud/compute/routers/v1/internal/routers_rest_stub.h @@ -57,6 +57,20 @@ class RoutersRestStub { google::cloud::cpp::compute::routers::v1::DeleteRouterRequest const& request) = 0; + virtual future> + AsyncDeleteNamedSet( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::routers::v1::DeleteNamedSetRequest const& + request) = 0; + + virtual StatusOr DeleteNamedSet( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::routers::v1::DeleteNamedSetRequest const& + request) = 0; + virtual future> AsyncDeleteRoutePolicy( google::cloud::CompletionQueue& cq, @@ -78,6 +92,13 @@ class RoutersRestStub { google::cloud::cpp::compute::routers::v1::GetRouterRequest const& request) = 0; + virtual StatusOr + GetNamedSet( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::routers::v1::GetNamedSetRequest const& + request) = 0; + virtual StatusOr GetNatIpInfo( google::cloud::rest_internal::RestContext& rest_context, @@ -134,6 +155,13 @@ class RoutersRestStub { google::cloud::cpp::compute::routers::v1::ListBgpRoutesRequest const& request) = 0; + virtual StatusOr + ListNamedSets( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::routers::v1::ListNamedSetsRequest const& + request) = 0; + virtual StatusOr ListRoutePolicies( google::cloud::rest_internal::RestContext& rest_context, @@ -155,6 +183,20 @@ class RoutersRestStub { google::cloud::cpp::compute::routers::v1::PatchRouterRequest const& request) = 0; + virtual future> + AsyncPatchNamedSet( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::routers::v1::PatchNamedSetRequest const& + request) = 0; + + virtual StatusOr PatchNamedSet( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::routers::v1::PatchNamedSetRequest const& + request) = 0; + virtual future> AsyncPatchRoutePolicy( google::cloud::CompletionQueue& cq, @@ -189,6 +231,20 @@ class RoutersRestStub { google::cloud::cpp::compute::routers::v1::UpdateRouterRequest const& request) = 0; + virtual future> + AsyncUpdateNamedSet( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::routers::v1::UpdateNamedSetRequest const& + request) = 0; + + virtual StatusOr UpdateNamedSet( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::routers::v1::UpdateNamedSetRequest const& + request) = 0; + virtual future> AsyncUpdateRoutePolicy( google::cloud::CompletionQueue& cq, @@ -250,6 +306,20 @@ class DefaultRoutersRestStub : public RoutersRestStub { google::cloud::cpp::compute::routers::v1::DeleteRouterRequest const& request) override; + future> + AsyncDeleteNamedSet( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::routers::v1::DeleteNamedSetRequest const& + request) override; + + StatusOr DeleteNamedSet( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::routers::v1::DeleteNamedSetRequest const& + request) override; + future> AsyncDeleteRoutePolicy( google::cloud::CompletionQueue& cq, @@ -270,6 +340,13 @@ class DefaultRoutersRestStub : public RoutersRestStub { google::cloud::cpp::compute::routers::v1::GetRouterRequest const& request) override; + StatusOr + GetNamedSet( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::routers::v1::GetNamedSetRequest const& + request) override; + StatusOr GetNatIpInfo( google::cloud::rest_internal::RestContext& rest_context, Options const& options, @@ -323,6 +400,12 @@ class DefaultRoutersRestStub : public RoutersRestStub { google::cloud::cpp::compute::routers::v1::ListBgpRoutesRequest const& request) override; + StatusOr ListNamedSets( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::routers::v1::ListNamedSetsRequest const& + request) override; + StatusOr ListRoutePolicies( google::cloud::rest_internal::RestContext& rest_context, @@ -343,6 +426,20 @@ class DefaultRoutersRestStub : public RoutersRestStub { google::cloud::cpp::compute::routers::v1::PatchRouterRequest const& request) override; + future> + AsyncPatchNamedSet( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::routers::v1::PatchNamedSetRequest const& + request) override; + + StatusOr PatchNamedSet( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::routers::v1::PatchNamedSetRequest const& + request) override; + future> AsyncPatchRoutePolicy( google::cloud::CompletionQueue& cq, @@ -377,6 +474,20 @@ class DefaultRoutersRestStub : public RoutersRestStub { google::cloud::cpp::compute::routers::v1::UpdateRouterRequest const& request) override; + future> + AsyncUpdateNamedSet( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::routers::v1::UpdateNamedSetRequest const& + request) override; + + StatusOr UpdateNamedSet( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::routers::v1::UpdateNamedSetRequest const& + request) override; + future> AsyncUpdateRoutePolicy( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/routers/v1/internal/routers_tracing_connection.cc b/google/cloud/compute/routers/v1/internal/routers_tracing_connection.cc index bec02c39781d1..b25039c34a800 100644 --- a/google/cloud/compute/routers/v1/internal/routers_tracing_connection.cc +++ b/google/cloud/compute/routers/v1/internal/routers_tracing_connection.cc @@ -75,6 +75,37 @@ RoutersTracingConnection::DeleteRouter( return internal::EndSpan(std::move(span), child_->DeleteRouter(operation)); } +future> +RoutersTracingConnection::DeleteNamedSet( + google::cloud::cpp::compute::routers::v1::DeleteNamedSetRequest const& + request) { + auto span = internal::MakeSpan( + "compute_routers_v1::RoutersConnection::DeleteNamedSet"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), child_->DeleteNamedSet(request)); +} + +StatusOr +RoutersTracingConnection::DeleteNamedSet( + NoAwaitTag, + google::cloud::cpp::compute::routers::v1::DeleteNamedSetRequest const& + request) { + auto span = internal::MakeSpan( + "compute_routers_v1::RoutersConnection::DeleteNamedSet"); + opentelemetry::trace::Scope scope(span); + return internal::EndSpan(*span, + child_->DeleteNamedSet(NoAwaitTag{}, request)); +} + +future> +RoutersTracingConnection::DeleteNamedSet( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto span = internal::MakeSpan( + "compute_routers_v1::RoutersConnection::DeleteNamedSet"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), child_->DeleteNamedSet(operation)); +} + future> RoutersTracingConnection::DeleteRoutePolicy( google::cloud::cpp::compute::routers::v1::DeleteRoutePolicyRequest const& @@ -116,6 +147,16 @@ RoutersTracingConnection::GetRouter( return internal::EndSpan(*span, child_->GetRouter(request)); } +StatusOr +RoutersTracingConnection::GetNamedSet( + google::cloud::cpp::compute::routers::v1::GetNamedSetRequest const& + request) { + auto span = + internal::MakeSpan("compute_routers_v1::RoutersConnection::GetNamedSet"); + auto scope = opentelemetry::trace::Scope(span); + return internal::EndSpan(*span, child_->GetNamedSet(request)); +} + StatusOr RoutersTracingConnection::GetNatIpInfo( google::cloud::cpp::compute::routers::v1::GetNatIpInfoRequest const& @@ -207,6 +248,16 @@ RoutersTracingConnection::ListBgpRoutes( return internal::EndSpan(*span, child_->ListBgpRoutes(request)); } +StatusOr +RoutersTracingConnection::ListNamedSets( + google::cloud::cpp::compute::routers::v1::ListNamedSetsRequest const& + request) { + auto span = internal::MakeSpan( + "compute_routers_v1::RoutersConnection::ListNamedSets"); + auto scope = opentelemetry::trace::Scope(span); + return internal::EndSpan(*span, child_->ListNamedSets(request)); +} + StatusOr RoutersTracingConnection::ListRoutePolicies( google::cloud::cpp::compute::routers::v1::ListRoutePoliciesRequest const& @@ -247,6 +298,36 @@ RoutersTracingConnection::PatchRouter( return internal::EndSpan(std::move(span), child_->PatchRouter(operation)); } +future> +RoutersTracingConnection::PatchNamedSet( + google::cloud::cpp::compute::routers::v1::PatchNamedSetRequest const& + request) { + auto span = internal::MakeSpan( + "compute_routers_v1::RoutersConnection::PatchNamedSet"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), child_->PatchNamedSet(request)); +} + +StatusOr +RoutersTracingConnection::PatchNamedSet( + NoAwaitTag, + google::cloud::cpp::compute::routers::v1::PatchNamedSetRequest const& + request) { + auto span = internal::MakeSpan( + "compute_routers_v1::RoutersConnection::PatchNamedSet"); + opentelemetry::trace::Scope scope(span); + return internal::EndSpan(*span, child_->PatchNamedSet(NoAwaitTag{}, request)); +} + +future> +RoutersTracingConnection::PatchNamedSet( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto span = internal::MakeSpan( + "compute_routers_v1::RoutersConnection::PatchNamedSet"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), child_->PatchNamedSet(operation)); +} + future> RoutersTracingConnection::PatchRoutePolicy( google::cloud::cpp::compute::routers::v1::PatchRoutePolicyRequest const& @@ -318,6 +399,37 @@ RoutersTracingConnection::UpdateRouter( return internal::EndSpan(std::move(span), child_->UpdateRouter(operation)); } +future> +RoutersTracingConnection::UpdateNamedSet( + google::cloud::cpp::compute::routers::v1::UpdateNamedSetRequest const& + request) { + auto span = internal::MakeSpan( + "compute_routers_v1::RoutersConnection::UpdateNamedSet"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), child_->UpdateNamedSet(request)); +} + +StatusOr +RoutersTracingConnection::UpdateNamedSet( + NoAwaitTag, + google::cloud::cpp::compute::routers::v1::UpdateNamedSetRequest const& + request) { + auto span = internal::MakeSpan( + "compute_routers_v1::RoutersConnection::UpdateNamedSet"); + opentelemetry::trace::Scope scope(span); + return internal::EndSpan(*span, + child_->UpdateNamedSet(NoAwaitTag{}, request)); +} + +future> +RoutersTracingConnection::UpdateNamedSet( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto span = internal::MakeSpan( + "compute_routers_v1::RoutersConnection::UpdateNamedSet"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), child_->UpdateNamedSet(operation)); +} + future> RoutersTracingConnection::UpdateRoutePolicy( google::cloud::cpp::compute::routers::v1::UpdateRoutePolicyRequest const& diff --git a/google/cloud/compute/routers/v1/internal/routers_tracing_connection.h b/google/cloud/compute/routers/v1/internal/routers_tracing_connection.h index ffbf63a3f295b..04fc2d2ae9d8c 100644 --- a/google/cloud/compute/routers/v1/internal/routers_tracing_connection.h +++ b/google/cloud/compute/routers/v1/internal/routers_tracing_connection.h @@ -55,6 +55,18 @@ class RoutersTracingConnection : public compute_routers_v1::RoutersConnection { future> DeleteRouter( google::cloud::cpp::compute::v1::Operation const& operation) override; + future> DeleteNamedSet( + google::cloud::cpp::compute::routers::v1::DeleteNamedSetRequest const& + request) override; + + StatusOr DeleteNamedSet( + NoAwaitTag, + google::cloud::cpp::compute::routers::v1::DeleteNamedSetRequest const& + request) override; + + future> DeleteNamedSet( + google::cloud::cpp::compute::v1::Operation const& operation) override; + future> DeleteRoutePolicy( google::cloud::cpp::compute::routers::v1::DeleteRoutePolicyRequest const& @@ -73,6 +85,11 @@ class RoutersTracingConnection : public compute_routers_v1::RoutersConnection { google::cloud::cpp::compute::routers::v1::GetRouterRequest const& request) override; + StatusOr + GetNamedSet( + google::cloud::cpp::compute::routers::v1::GetNamedSetRequest const& + request) override; + StatusOr GetNatIpInfo( google::cloud::cpp::compute::routers::v1::GetNatIpInfoRequest const& request) override; @@ -112,6 +129,10 @@ class RoutersTracingConnection : public compute_routers_v1::RoutersConnection { google::cloud::cpp::compute::routers::v1::ListBgpRoutesRequest const& request) override; + StatusOr ListNamedSets( + google::cloud::cpp::compute::routers::v1::ListNamedSetsRequest const& + request) override; + StatusOr ListRoutePolicies( google::cloud::cpp::compute::routers::v1::ListRoutePoliciesRequest const& @@ -129,6 +150,18 @@ class RoutersTracingConnection : public compute_routers_v1::RoutersConnection { future> PatchRouter( google::cloud::cpp::compute::v1::Operation const& operation) override; + future> PatchNamedSet( + google::cloud::cpp::compute::routers::v1::PatchNamedSetRequest const& + request) override; + + StatusOr PatchNamedSet( + NoAwaitTag, + google::cloud::cpp::compute::routers::v1::PatchNamedSetRequest const& + request) override; + + future> PatchNamedSet( + google::cloud::cpp::compute::v1::Operation const& operation) override; + future> PatchRoutePolicy( google::cloud::cpp::compute::routers::v1::PatchRoutePolicyRequest const& request) override; @@ -157,6 +190,18 @@ class RoutersTracingConnection : public compute_routers_v1::RoutersConnection { future> UpdateRouter( google::cloud::cpp::compute::v1::Operation const& operation) override; + future> UpdateNamedSet( + google::cloud::cpp::compute::routers::v1::UpdateNamedSetRequest const& + request) override; + + StatusOr UpdateNamedSet( + NoAwaitTag, + google::cloud::cpp::compute::routers::v1::UpdateNamedSetRequest const& + request) override; + + future> UpdateNamedSet( + google::cloud::cpp::compute::v1::Operation const& operation) override; + future> UpdateRoutePolicy( google::cloud::cpp::compute::routers::v1::UpdateRoutePolicyRequest const& diff --git a/google/cloud/compute/routers/v1/mocks/mock_routers_connection.h b/google/cloud/compute/routers/v1/mocks/mock_routers_connection.h index 4efd20319e66a..55673ed56be06 100644 --- a/google/cloud/compute/routers/v1/mocks/mock_routers_connection.h +++ b/google/cloud/compute/routers/v1/mocks/mock_routers_connection.h @@ -97,6 +97,49 @@ class MockRoutersConnection : public compute_routers_v1::RoutersConnection { (google::cloud::cpp::compute::v1::Operation const& operation), (override)); + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// DeleteNamedSet(Matcher(_))) + /// @endcode + MOCK_METHOD( + future>, + DeleteNamedSet, + (google::cloud::cpp::compute::routers::v1::DeleteNamedSetRequest const& + request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// EXPECT_CALL(*mock, DeleteNamedSet(_, _)) + /// @endcode + MOCK_METHOD( + StatusOr, DeleteNamedSet, + (NoAwaitTag, + google::cloud::cpp::compute::routers::v1::DeleteNamedSetRequest const& + request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// DeleteNamedSet(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + DeleteNamedSet, + (google::cloud::cpp::compute::v1::Operation const& operation), + (override)); + /// To disambiguate calls, use: /// /// @code @@ -145,6 +188,13 @@ class MockRoutersConnection : public compute_routers_v1::RoutersConnection { request), (override)); + MOCK_METHOD( + StatusOr, + GetNamedSet, + (google::cloud::cpp::compute::routers::v1::GetNamedSetRequest const& + request), + (override)); + MOCK_METHOD( StatusOr, GetNatIpInfo, @@ -228,6 +278,13 @@ class MockRoutersConnection : public compute_routers_v1::RoutersConnection { request), (override)); + MOCK_METHOD( + StatusOr, + ListNamedSets, + (google::cloud::cpp::compute::routers::v1::ListNamedSetsRequest const& + request), + (override)); + MOCK_METHOD( StatusOr, ListRoutePolicies, @@ -277,6 +334,49 @@ class MockRoutersConnection : public compute_routers_v1::RoutersConnection { (google::cloud::cpp::compute::v1::Operation const& operation), (override)); + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// PatchNamedSet(Matcher(_))) + /// @endcode + MOCK_METHOD( + future>, + PatchNamedSet, + (google::cloud::cpp::compute::routers::v1::PatchNamedSetRequest const& + request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// EXPECT_CALL(*mock, PatchNamedSet(_, _)) + /// @endcode + MOCK_METHOD( + StatusOr, PatchNamedSet, + (NoAwaitTag, + google::cloud::cpp::compute::routers::v1::PatchNamedSetRequest const& + request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// PatchNamedSet(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + PatchNamedSet, + (google::cloud::cpp::compute::v1::Operation const& operation), + (override)); + /// To disambiguate calls, use: /// /// @code @@ -369,6 +469,49 @@ class MockRoutersConnection : public compute_routers_v1::RoutersConnection { (google::cloud::cpp::compute::v1::Operation const& operation), (override)); + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// UpdateNamedSet(Matcher(_))) + /// @endcode + MOCK_METHOD( + future>, + UpdateNamedSet, + (google::cloud::cpp::compute::routers::v1::UpdateNamedSetRequest const& + request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// EXPECT_CALL(*mock, UpdateNamedSet(_, _)) + /// @endcode + MOCK_METHOD( + StatusOr, UpdateNamedSet, + (NoAwaitTag, + google::cloud::cpp::compute::routers::v1::UpdateNamedSetRequest const& + request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// UpdateNamedSet(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + UpdateNamedSet, + (google::cloud::cpp::compute::v1::Operation const& operation), + (override)); + /// To disambiguate calls, use: /// /// @code diff --git a/google/cloud/compute/routers/v1/routers_client.cc b/google/cloud/compute/routers/v1/routers_client.cc index 710b40617425c..138d435252e7a 100644 --- a/google/cloud/compute/routers/v1/routers_client.cc +++ b/google/cloud/compute/routers/v1/routers_client.cc @@ -102,6 +102,56 @@ RoutersClient::DeleteRouter( return connection_->DeleteRouter(operation); } +future> +RoutersClient::DeleteNamedSet(std::string const& project, + std::string const& region, + std::string const& router, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::routers::v1::DeleteNamedSetRequest request; + request.set_project(project); + request.set_region(region); + request.set_router(router); + return connection_->DeleteNamedSet(request); +} + +StatusOr +RoutersClient::DeleteNamedSet(NoAwaitTag, std::string const& project, + std::string const& region, + std::string const& router, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::routers::v1::DeleteNamedSetRequest request; + request.set_project(project); + request.set_region(region); + request.set_router(router); + return connection_->DeleteNamedSet(NoAwaitTag{}, request); +} + +future> +RoutersClient::DeleteNamedSet( + google::cloud::cpp::compute::routers::v1::DeleteNamedSetRequest const& + request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->DeleteNamedSet(request); +} + +StatusOr +RoutersClient::DeleteNamedSet( + NoAwaitTag, + google::cloud::cpp::compute::routers::v1::DeleteNamedSetRequest const& + request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->DeleteNamedSet(NoAwaitTag{}, request); +} + +future> +RoutersClient::DeleteNamedSet( + google::cloud::cpp::compute::v1::Operation const& operation, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->DeleteNamedSet(operation); +} + future> RoutersClient::DeleteRoutePolicy(std::string const& project, std::string const& region, @@ -170,6 +220,26 @@ StatusOr RoutersClient::GetRouter( return connection_->GetRouter(request); } +StatusOr +RoutersClient::GetNamedSet(std::string const& project, + std::string const& region, std::string const& router, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::routers::v1::GetNamedSetRequest request; + request.set_project(project); + request.set_region(region); + request.set_router(router); + return connection_->GetNamedSet(request); +} + +StatusOr +RoutersClient::GetNamedSet( + google::cloud::cpp::compute::routers::v1::GetNamedSetRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->GetNamedSet(request); +} + StatusOr RoutersClient::GetNatIpInfo(std::string const& project, std::string const& region, @@ -343,6 +413,27 @@ RoutersClient::ListBgpRoutes( return connection_->ListBgpRoutes(request); } +StatusOr +RoutersClient::ListNamedSets(std::string const& project, + std::string const& region, + std::string const& router, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::routers::v1::ListNamedSetsRequest request; + request.set_project(project); + request.set_region(region); + request.set_router(router); + return connection_->ListNamedSets(request); +} + +StatusOr +RoutersClient::ListNamedSets( + google::cloud::cpp::compute::routers::v1::ListNamedSetsRequest const& + request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->ListNamedSets(request); +} + StatusOr RoutersClient::ListRoutePolicies(std::string const& project, std::string const& region, @@ -416,6 +507,62 @@ RoutersClient::PatchRouter( return connection_->PatchRouter(operation); } +future> +RoutersClient::PatchNamedSet( + std::string const& project, std::string const& region, + std::string const& router, + google::cloud::cpp::compute::v1::NamedSet const& named_set_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::routers::v1::PatchNamedSetRequest request; + request.set_project(project); + request.set_region(region); + request.set_router(router); + *request.mutable_named_set_resource() = named_set_resource; + return connection_->PatchNamedSet(request); +} + +StatusOr +RoutersClient::PatchNamedSet( + NoAwaitTag, std::string const& project, std::string const& region, + std::string const& router, + google::cloud::cpp::compute::v1::NamedSet const& named_set_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::routers::v1::PatchNamedSetRequest request; + request.set_project(project); + request.set_region(region); + request.set_router(router); + *request.mutable_named_set_resource() = named_set_resource; + return connection_->PatchNamedSet(NoAwaitTag{}, request); +} + +future> +RoutersClient::PatchNamedSet( + google::cloud::cpp::compute::routers::v1::PatchNamedSetRequest const& + request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->PatchNamedSet(request); +} + +StatusOr +RoutersClient::PatchNamedSet( + NoAwaitTag, + google::cloud::cpp::compute::routers::v1::PatchNamedSetRequest const& + request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->PatchNamedSet(NoAwaitTag{}, request); +} + +future> +RoutersClient::PatchNamedSet( + google::cloud::cpp::compute::v1::Operation const& operation, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->PatchNamedSet(operation); +} + future> RoutersClient::PatchRoutePolicy( std::string const& project, std::string const& region, @@ -551,6 +698,62 @@ RoutersClient::UpdateRouter( return connection_->UpdateRouter(operation); } +future> +RoutersClient::UpdateNamedSet( + std::string const& project, std::string const& region, + std::string const& router, + google::cloud::cpp::compute::v1::NamedSet const& named_set_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::routers::v1::UpdateNamedSetRequest request; + request.set_project(project); + request.set_region(region); + request.set_router(router); + *request.mutable_named_set_resource() = named_set_resource; + return connection_->UpdateNamedSet(request); +} + +StatusOr +RoutersClient::UpdateNamedSet( + NoAwaitTag, std::string const& project, std::string const& region, + std::string const& router, + google::cloud::cpp::compute::v1::NamedSet const& named_set_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::routers::v1::UpdateNamedSetRequest request; + request.set_project(project); + request.set_region(region); + request.set_router(router); + *request.mutable_named_set_resource() = named_set_resource; + return connection_->UpdateNamedSet(NoAwaitTag{}, request); +} + +future> +RoutersClient::UpdateNamedSet( + google::cloud::cpp::compute::routers::v1::UpdateNamedSetRequest const& + request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->UpdateNamedSet(request); +} + +StatusOr +RoutersClient::UpdateNamedSet( + NoAwaitTag, + google::cloud::cpp::compute::routers::v1::UpdateNamedSetRequest const& + request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->UpdateNamedSet(NoAwaitTag{}, request); +} + +future> +RoutersClient::UpdateNamedSet( + google::cloud::cpp::compute::v1::Operation const& operation, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->UpdateNamedSet(operation); +} + future> RoutersClient::UpdateRoutePolicy( std::string const& project, std::string const& region, diff --git a/google/cloud/compute/routers/v1/routers_client.h b/google/cloud/compute/routers/v1/routers_client.h index 1dfd21e1e0fbf..b74ca51083766 100644 --- a/google/cloud/compute/routers/v1/routers_client.h +++ b/google/cloud/compute/routers/v1/routers_client.h @@ -88,8 +88,10 @@ class RoutersClient { // clang-format off /// - /// Retrieves an aggregated list of routers. To prevent failure, Google - /// recommends that you set the `returnPartialSuccess` parameter to `true`. + /// Retrieves an aggregated list of routers. + /// + /// To prevent failure, Google recommends that you set the + /// `returnPartialSuccess` parameter to `true`. /// https://cloud.google.com/compute/docs/reference/rest/v1/routers/aggregatedList /// /// @param project Project ID for this request. @@ -115,8 +117,8 @@ class RoutersClient { /// [`future`]: @ref google::cloud::future /// [`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#L239} - /// [google.cloud.cpp.compute.v1.RoutersScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_013.proto#L1601} + /// [google.cloud.cpp.compute.routers.v1.AggregatedListRoutersRequest]: @cloud_cpp_reference_link{google/cloud/compute/routers/v1/routers.proto#L302} + /// [google.cloud.cpp.compute.v1.RoutersScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_016.proto#L2053} /// // clang-format on StreamRange> DeleteRouter( @@ -249,7 +253,7 @@ class RoutersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.routers.v1.DeleteRouterRequest]: @cloud_cpp_reference_link{google/cloud/compute/routers/v1/routers.proto#L357} + /// [google.cloud.cpp.compute.routers.v1.DeleteRouterRequest]: @cloud_cpp_reference_link{google/cloud/compute/routers/v1/routers.proto#L495} /// // clang-format on future> DeleteRouter( @@ -287,6 +291,125 @@ class RoutersClient { google::cloud::cpp::compute::v1::Operation const& operation, Options opts = {}); + // clang-format off + /// + /// Deletes Named Set + /// https://cloud.google.com/compute/docs/reference/rest/v1/routers/deleteNamedSet + /// + /// @param project Project ID for this request. + /// @param region Name of the region for this request. + /// @param router Name of the Router resource where Named Set is defined. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.routers.v1.DeleteNamedSetRequest]: @cloud_cpp_reference_link{google/cloud/compute/routers/v1/routers.proto#L417} + /// + // clang-format on + future> DeleteNamedSet( + std::string const& project, std::string const& region, + std::string const& router, Options opts = {}); + + // clang-format off + /// + /// @copybrief DeleteNamedSet + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr DeleteNamedSet( + NoAwaitTag, std::string const& project, std::string const& region, + std::string const& router, Options opts = {}); + + // clang-format off + /// + /// Deletes Named Set + /// https://cloud.google.com/compute/docs/reference/rest/v1/routers/deleteNamedSet + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.routers.v1.DeleteNamedSetRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.routers.v1.DeleteNamedSetRequest]: @cloud_cpp_reference_link{google/cloud/compute/routers/v1/routers.proto#L417} + /// + // clang-format on + future> DeleteNamedSet( + google::cloud::cpp::compute::routers::v1::DeleteNamedSetRequest const& + request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief DeleteNamedSet + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr DeleteNamedSet( + NoAwaitTag, + google::cloud::cpp::compute::routers::v1::DeleteNamedSetRequest const& + request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief DeleteNamedSet + /// + /// This method accepts a `google::cloud::cpp::compute::v1::Operation` that corresponds + /// to a previously started Long Running Operation (LRO) and polls the status + /// of the LRO in the background. + /// + // clang-format on + future> DeleteNamedSet( + google::cloud::cpp::compute::v1::Operation const& operation, + Options opts = {}); + // clang-format off /// /// Deletes Route Policy @@ -315,7 +438,7 @@ class RoutersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.routers.v1.DeleteRoutePolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/routers/v1/routers.proto#L321} + /// [google.cloud.cpp.compute.routers.v1.DeleteRoutePolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/routers/v1/routers.proto#L456} /// // clang-format on future> @@ -368,7 +491,7 @@ class RoutersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.routers.v1.DeleteRoutePolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/routers/v1/routers.proto#L321} + /// [google.cloud.cpp.compute.routers.v1.DeleteRoutePolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/routers/v1/routers.proto#L456} /// // clang-format on future> @@ -428,8 +551,8 @@ class RoutersClient { /// [`future`]: @ref google::cloud::future /// [`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#L511} - /// [google.cloud.cpp.compute.v1.Router]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_013.proto#L339} + /// [google.cloud.cpp.compute.routers.v1.GetRouterRequest]: @cloud_cpp_reference_link{google/cloud/compute/routers/v1/routers.proto#L705} + /// [google.cloud.cpp.compute.v1.Router]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_016.proto#L384} /// // clang-format on StatusOr GetRouter( @@ -460,14 +583,78 @@ class RoutersClient { /// [`future`]: @ref google::cloud::future /// [`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#L511} - /// [google.cloud.cpp.compute.v1.Router]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_013.proto#L339} + /// [google.cloud.cpp.compute.routers.v1.GetRouterRequest]: @cloud_cpp_reference_link{google/cloud/compute/routers/v1/routers.proto#L705} + /// [google.cloud.cpp.compute.v1.Router]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_016.proto#L384} /// // clang-format on StatusOr GetRouter( google::cloud::cpp::compute::routers::v1::GetRouterRequest const& request, Options opts = {}); + // clang-format off + /// + /// Returns specified Named Set + /// https://cloud.google.com/compute/docs/reference/rest/v1/routers/getNamedSet + /// + /// @param project Project ID for this request. + /// @param region Name of the region for this request. + /// @param router Name of the Router resource to query for the named set. The name should + /// conform to RFC1035. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.RoutersGetNamedSetResponse]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.routers.v1.GetNamedSetRequest]: @cloud_cpp_reference_link{google/cloud/compute/routers/v1/routers.proto#L531} + /// [google.cloud.cpp.compute.v1.RoutersGetNamedSetResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_016.proto#L1632} + /// + // clang-format on + StatusOr + GetNamedSet(std::string const& project, std::string const& region, + std::string const& router, Options opts = {}); + + // clang-format off + /// + /// Returns specified Named Set + /// https://cloud.google.com/compute/docs/reference/rest/v1/routers/getNamedSet + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.routers.v1.GetNamedSetRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.RoutersGetNamedSetResponse]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.routers.v1.GetNamedSetRequest]: @cloud_cpp_reference_link{google/cloud/compute/routers/v1/routers.proto#L531} + /// [google.cloud.cpp.compute.v1.RoutersGetNamedSetResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_016.proto#L1632} + /// + // clang-format on + StatusOr + GetNamedSet( + google::cloud::cpp::compute::routers::v1::GetNamedSetRequest const& + request, + Options opts = {}); + // clang-format off /// /// Retrieves runtime NAT IP information. @@ -490,8 +677,8 @@ class RoutersClient { /// [`future`]: @ref google::cloud::future /// [`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#L390} - /// [google.cloud.cpp.compute.v1.NatIpInfoResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_013.proto#L262} + /// [google.cloud.cpp.compute.routers.v1.GetNatIpInfoRequest]: @cloud_cpp_reference_link{google/cloud/compute/routers/v1/routers.proto#L550} + /// [google.cloud.cpp.compute.v1.NatIpInfoResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_016.proto#L301} /// // clang-format on StatusOr GetNatIpInfo( @@ -522,8 +709,8 @@ class RoutersClient { /// [`future`]: @ref google::cloud::future /// [`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#L390} - /// [google.cloud.cpp.compute.v1.NatIpInfoResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_013.proto#L262} + /// [google.cloud.cpp.compute.routers.v1.GetNatIpInfoRequest]: @cloud_cpp_reference_link{google/cloud/compute/routers/v1/routers.proto#L550} + /// [google.cloud.cpp.compute.v1.NatIpInfoResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_016.proto#L301} /// // clang-format on StatusOr GetNatIpInfo( @@ -538,8 +725,8 @@ class RoutersClient { /// /// @param project Project ID for this request. /// @param region Name of the region for this request. - /// @param router Name of the Router resource to query for Nat Mapping information of VM - /// endpoints. + /// @param router Name of the Router resource to query for Nat Mapping information of + /// VM endpoints. /// @param opts Optional. Override the class-level options, such as retry and /// backoff policies. /// @return the result of the RPC. The response message type @@ -553,8 +740,8 @@ class RoutersClient { /// [`future`]: @ref google::cloud::future /// [`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#L410} - /// [google.cloud.cpp.compute.v1.VmEndpointNatMappingsList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_013.proto#L1768} + /// [google.cloud.cpp.compute.routers.v1.GetNatMappingInfoRequest]: @cloud_cpp_reference_link{google/cloud/compute/routers/v1/routers.proto#L571} + /// [google.cloud.cpp.compute.v1.VmEndpointNatMappingsList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_016.proto#L2254} /// // clang-format on StatusOr @@ -585,8 +772,8 @@ class RoutersClient { /// [`future`]: @ref google::cloud::future /// [`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#L410} - /// [google.cloud.cpp.compute.v1.VmEndpointNatMappingsList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_013.proto#L1768} + /// [google.cloud.cpp.compute.routers.v1.GetNatMappingInfoRequest]: @cloud_cpp_reference_link{google/cloud/compute/routers/v1/routers.proto#L571} + /// [google.cloud.cpp.compute.v1.VmEndpointNatMappingsList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_016.proto#L2254} /// // clang-format on StatusOr @@ -617,8 +804,8 @@ class RoutersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.routers.v1.GetRoutePolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/routers/v1/routers.proto#L492} - /// [google.cloud.cpp.compute.v1.RoutersGetRoutePolicyResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_013.proto#L1364} + /// [google.cloud.cpp.compute.routers.v1.GetRoutePolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/routers/v1/routers.proto#L686} + /// [google.cloud.cpp.compute.v1.RoutersGetRoutePolicyResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_016.proto#L1639} /// // clang-format on StatusOr @@ -649,8 +836,8 @@ class RoutersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.routers.v1.GetRoutePolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/routers/v1/routers.proto#L492} - /// [google.cloud.cpp.compute.v1.RoutersGetRoutePolicyResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_013.proto#L1364} + /// [google.cloud.cpp.compute.routers.v1.GetRoutePolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/routers/v1/routers.proto#L686} + /// [google.cloud.cpp.compute.v1.RoutersGetRoutePolicyResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_016.proto#L1639} /// // clang-format on StatusOr @@ -680,8 +867,8 @@ class RoutersClient { /// [`future`]: @ref google::cloud::future /// [`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#L526} - /// [google.cloud.cpp.compute.v1.RouterStatusResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_013.proto#L1357} + /// [google.cloud.cpp.compute.routers.v1.GetRouterStatusRequest]: @cloud_cpp_reference_link{google/cloud/compute/routers/v1/routers.proto#L720} + /// [google.cloud.cpp.compute.v1.RouterStatusResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_016.proto#L1625} /// // clang-format on StatusOr @@ -712,8 +899,8 @@ class RoutersClient { /// [`future`]: @ref google::cloud::future /// [`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#L526} - /// [google.cloud.cpp.compute.v1.RouterStatusResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_013.proto#L1357} + /// [google.cloud.cpp.compute.routers.v1.GetRouterStatusRequest]: @cloud_cpp_reference_link{google/cloud/compute/routers/v1/routers.proto#L720} + /// [google.cloud.cpp.compute.v1.RouterStatusResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_016.proto#L1625} /// // clang-format on StatusOr @@ -724,8 +911,8 @@ class RoutersClient { // clang-format off /// - /// Creates a Router resource in the specified project and region using the - /// data included in the request. + /// Creates a Router resource in the specified project and region using + /// the data included in the request. /// https://cloud.google.com/compute/docs/reference/rest/v1/routers/insert /// /// @param project Project ID for this request. @@ -751,7 +938,7 @@ class RoutersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.routers.v1.InsertRouterRequest]: @cloud_cpp_reference_link{google/cloud/compute/routers/v1/routers.proto#L541} + /// [google.cloud.cpp.compute.routers.v1.InsertRouterRequest]: @cloud_cpp_reference_link{google/cloud/compute/routers/v1/routers.proto#L735} /// // clang-format on future> InsertRouter( @@ -777,8 +964,8 @@ class RoutersClient { // clang-format off /// - /// Creates a Router resource in the specified project and region using the - /// data included in the request. + /// Creates a Router resource in the specified project and region using + /// the data included in the request. /// https://cloud.google.com/compute/docs/reference/rest/v1/routers/insert /// /// @param request Unary RPCs, such as the one wrapped by this @@ -807,7 +994,7 @@ class RoutersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.routers.v1.InsertRouterRequest]: @cloud_cpp_reference_link{google/cloud/compute/routers/v1/routers.proto#L541} + /// [google.cloud.cpp.compute.routers.v1.InsertRouterRequest]: @cloud_cpp_reference_link{google/cloud/compute/routers/v1/routers.proto#L735} /// // clang-format on future> InsertRouter( @@ -874,8 +1061,8 @@ class RoutersClient { /// [`future`]: @ref google::cloud::future /// [`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#L753} - /// [google.cloud.cpp.compute.v1.Router]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_013.proto#L339} + /// [google.cloud.cpp.compute.routers.v1.ListRoutersRequest]: @cloud_cpp_reference_link{google/cloud/compute/routers/v1/routers.proto#L1126} + /// [google.cloud.cpp.compute.v1.Router]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_016.proto#L384} /// // clang-format on StreamRange ListRouters( @@ -914,8 +1101,8 @@ class RoutersClient { /// [`future`]: @ref google::cloud::future /// [`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#L753} - /// [google.cloud.cpp.compute.v1.Router]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_013.proto#L339} + /// [google.cloud.cpp.compute.routers.v1.ListRoutersRequest]: @cloud_cpp_reference_link{google/cloud/compute/routers/v1/routers.proto#L1126} + /// [google.cloud.cpp.compute.v1.Router]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_016.proto#L384} /// // clang-format on StreamRange ListRouters( @@ -929,8 +1116,8 @@ class RoutersClient { /// /// @param project Project ID for this request. /// @param region Name of the region for this request. - /// @param router Name or id of the resource for this request. Name should conform to - /// RFC1035. + /// @param router Name or id of the resource for this request. + /// Name should conform to RFC1035. /// @param opts Optional. Override the class-level options, such as retry and /// backoff policies. /// @return the result of the RPC. The response message type @@ -944,8 +1131,8 @@ class RoutersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.routers.v1.ListBgpRoutesRequest]: @cloud_cpp_reference_link{google/cloud/compute/routers/v1/routers.proto#L574} - /// [google.cloud.cpp.compute.v1.RoutersListBgpRoutes]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_013.proto#L1368} + /// [google.cloud.cpp.compute.routers.v1.ListBgpRoutesRequest]: @cloud_cpp_reference_link{google/cloud/compute/routers/v1/routers.proto#L771} + /// [google.cloud.cpp.compute.v1.RoutersListBgpRoutes]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_016.proto#L1643} /// // clang-format on StatusOr ListBgpRoutes( @@ -976,8 +1163,8 @@ class RoutersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.routers.v1.ListBgpRoutesRequest]: @cloud_cpp_reference_link{google/cloud/compute/routers/v1/routers.proto#L574} - /// [google.cloud.cpp.compute.v1.RoutersListBgpRoutes]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_013.proto#L1368} + /// [google.cloud.cpp.compute.routers.v1.ListBgpRoutesRequest]: @cloud_cpp_reference_link{google/cloud/compute/routers/v1/routers.proto#L771} + /// [google.cloud.cpp.compute.v1.RoutersListBgpRoutes]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_016.proto#L1643} /// // clang-format on StatusOr ListBgpRoutes( @@ -985,6 +1172,71 @@ class RoutersClient { request, Options opts = {}); + // clang-format off + /// + /// Retrieves a list of router named set subresources available to the + /// specified project. + /// https://cloud.google.com/compute/docs/reference/rest/v1/routers/listNamedSets + /// + /// @param project Project ID for this request. + /// @param region Name of the region for this request. + /// @param router Name or id of the resource for this request. + /// Name should conform to RFC1035. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.RoutersListNamedSets]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.routers.v1.ListNamedSetsRequest]: @cloud_cpp_reference_link{google/cloud/compute/routers/v1/routers.proto#L906} + /// [google.cloud.cpp.compute.v1.RoutersListNamedSets]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_016.proto#L1778} + /// + // clang-format on + StatusOr ListNamedSets( + std::string const& project, std::string const& region, + std::string const& router, Options opts = {}); + + // clang-format off + /// + /// Retrieves a list of router named set subresources available to the + /// specified project. + /// https://cloud.google.com/compute/docs/reference/rest/v1/routers/listNamedSets + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.routers.v1.ListNamedSetsRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.RoutersListNamedSets]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.routers.v1.ListNamedSetsRequest]: @cloud_cpp_reference_link{google/cloud/compute/routers/v1/routers.proto#L906} + /// [google.cloud.cpp.compute.v1.RoutersListNamedSets]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_016.proto#L1778} + /// + // clang-format on + StatusOr ListNamedSets( + google::cloud::cpp::compute::routers::v1::ListNamedSetsRequest const& + request, + Options opts = {}); + // clang-format off /// /// Retrieves a list of router route policy subresources available to the @@ -993,8 +1245,8 @@ class RoutersClient { /// /// @param project Project ID for this request. /// @param region Name of the region for this request. - /// @param router Name or id of the resource for this request. Name should conform to - /// RFC1035. + /// @param router Name or id of the resource for this request. + /// Name should conform to RFC1035. /// @param opts Optional. Override the class-level options, such as retry and /// backoff policies. /// @return the result of the RPC. The response message type @@ -1008,8 +1260,8 @@ class RoutersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.routers.v1.ListRoutePoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/routers/v1/routers.proto#L676} - /// [google.cloud.cpp.compute.v1.RoutersListRoutePolicies]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_013.proto#L1482} + /// [google.cloud.cpp.compute.routers.v1.ListRoutePoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/routers/v1/routers.proto#L1016} + /// [google.cloud.cpp.compute.v1.RoutersListRoutePolicies]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_016.proto#L1913} /// // clang-format on StatusOr @@ -1041,8 +1293,8 @@ class RoutersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.routers.v1.ListRoutePoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/routers/v1/routers.proto#L676} - /// [google.cloud.cpp.compute.v1.RoutersListRoutePolicies]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_013.proto#L1482} + /// [google.cloud.cpp.compute.routers.v1.ListRoutePoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/routers/v1/routers.proto#L1016} + /// [google.cloud.cpp.compute.v1.RoutersListRoutePolicies]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_016.proto#L1913} /// // clang-format on StatusOr @@ -1054,8 +1306,9 @@ class RoutersClient { // clang-format off /// /// 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. + /// request. This method supportsPATCH + /// semantics and usesJSON merge + /// patch format and processing rules. /// https://cloud.google.com/compute/docs/reference/rest/v1/routers/patch /// /// @param project Project ID for this request. @@ -1082,7 +1335,7 @@ class RoutersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.routers.v1.PatchRouterRequest]: @cloud_cpp_reference_link{google/cloud/compute/routers/v1/routers.proto#L862} + /// [google.cloud.cpp.compute.routers.v1.PatchRouterRequest]: @cloud_cpp_reference_link{google/cloud/compute/routers/v1/routers.proto#L1311} /// // clang-format on future> PatchRouter( @@ -1111,8 +1364,9 @@ class RoutersClient { // clang-format off /// /// 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. + /// request. This method supportsPATCH + /// semantics and usesJSON merge + /// patch format and processing rules. /// https://cloud.google.com/compute/docs/reference/rest/v1/routers/patch /// /// @param request Unary RPCs, such as the one wrapped by this @@ -1141,7 +1395,7 @@ class RoutersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.routers.v1.PatchRouterRequest]: @cloud_cpp_reference_link{google/cloud/compute/routers/v1/routers.proto#L862} + /// [google.cloud.cpp.compute.routers.v1.PatchRouterRequest]: @cloud_cpp_reference_link{google/cloud/compute/routers/v1/routers.proto#L1311} /// // clang-format on future> PatchRouter( @@ -1179,6 +1433,130 @@ class RoutersClient { google::cloud::cpp::compute::v1::Operation const& operation, Options opts = {}); + // clang-format off + /// + /// Patches Named Set + /// https://cloud.google.com/compute/docs/reference/rest/v1/routers/patchNamedSet + /// + /// @param project Project ID for this request. + /// @param region Name of the region for this request. + /// @param router Name of the Router resource where Named Set is defined. + /// @param named_set_resource The NamedSet for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.routers.v1.PatchNamedSetRequest]: @cloud_cpp_reference_link{google/cloud/compute/routers/v1/routers.proto#L1231} + /// + // clang-format on + future> PatchNamedSet( + std::string const& project, std::string const& region, + std::string const& router, + google::cloud::cpp::compute::v1::NamedSet const& named_set_resource, + Options opts = {}); + + // clang-format off + /// + /// @copybrief PatchNamedSet + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr PatchNamedSet( + NoAwaitTag, std::string const& project, std::string const& region, + std::string const& router, + google::cloud::cpp::compute::v1::NamedSet const& named_set_resource, + Options opts = {}); + + // clang-format off + /// + /// Patches Named Set + /// https://cloud.google.com/compute/docs/reference/rest/v1/routers/patchNamedSet + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.routers.v1.PatchNamedSetRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.routers.v1.PatchNamedSetRequest]: @cloud_cpp_reference_link{google/cloud/compute/routers/v1/routers.proto#L1231} + /// + // clang-format on + future> PatchNamedSet( + google::cloud::cpp::compute::routers::v1::PatchNamedSetRequest const& + request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief PatchNamedSet + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr PatchNamedSet( + NoAwaitTag, + google::cloud::cpp::compute::routers::v1::PatchNamedSetRequest const& + request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief PatchNamedSet + /// + /// This method accepts a `google::cloud::cpp::compute::v1::Operation` that corresponds + /// to a previously started Long Running Operation (LRO) and polls the status + /// of the LRO in the background. + /// + // clang-format on + future> PatchNamedSet( + google::cloud::cpp::compute::v1::Operation const& operation, + Options opts = {}); + // clang-format off /// /// Patches Route Policy @@ -1208,7 +1586,7 @@ class RoutersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.routers.v1.PatchRoutePolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/routers/v1/routers.proto#L825} + /// [google.cloud.cpp.compute.routers.v1.PatchRoutePolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/routers/v1/routers.proto#L1271} /// // clang-format on future> PatchRoutePolicy( @@ -1265,7 +1643,7 @@ class RoutersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.routers.v1.PatchRoutePolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/routers/v1/routers.proto#L825} + /// [google.cloud.cpp.compute.routers.v1.PatchRoutePolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/routers/v1/routers.proto#L1271} /// // clang-format on future> PatchRoutePolicy( @@ -1305,7 +1683,7 @@ class RoutersClient { // clang-format off /// - /// Preview fields auto-generated during router create and update operations. + /// Preview fields auto-generated during router create andupdate operations. /// Calling this method does NOT create or update the router. /// https://cloud.google.com/compute/docs/reference/rest/v1/routers/preview /// @@ -1326,8 +1704,8 @@ class RoutersClient { /// [`future`]: @ref google::cloud::future /// [`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#L899} - /// [google.cloud.cpp.compute.v1.RoutersPreviewResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_013.proto#L1596} + /// [google.cloud.cpp.compute.routers.v1.PreviewRequest]: @cloud_cpp_reference_link{google/cloud/compute/routers/v1/routers.proto#L1351} + /// [google.cloud.cpp.compute.v1.RoutersPreviewResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_016.proto#L2048} /// // clang-format on StatusOr Preview( @@ -1338,7 +1716,7 @@ class RoutersClient { // clang-format off /// - /// Preview fields auto-generated during router create and update operations. + /// Preview fields auto-generated during router create andupdate operations. /// Calling this method does NOT create or update the router. /// https://cloud.google.com/compute/docs/reference/rest/v1/routers/preview /// @@ -1361,8 +1739,8 @@ class RoutersClient { /// [`future`]: @ref google::cloud::future /// [`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#L899} - /// [google.cloud.cpp.compute.v1.RoutersPreviewResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_013.proto#L1596} + /// [google.cloud.cpp.compute.routers.v1.PreviewRequest]: @cloud_cpp_reference_link{google/cloud/compute/routers/v1/routers.proto#L1351} + /// [google.cloud.cpp.compute.v1.RoutersPreviewResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_016.proto#L2048} /// // clang-format on StatusOr Preview( @@ -1372,9 +1750,10 @@ class RoutersClient { // clang-format off /// /// 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. + /// request. This method conforms toPUT 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. /// https://cloud.google.com/compute/docs/reference/rest/v1/routers/update /// /// @param project Project ID for this request. @@ -1401,7 +1780,7 @@ class RoutersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.routers.v1.UpdateRouterRequest]: @cloud_cpp_reference_link{google/cloud/compute/routers/v1/routers.proto#L955} + /// [google.cloud.cpp.compute.routers.v1.UpdateRouterRequest]: @cloud_cpp_reference_link{google/cloud/compute/routers/v1/routers.proto#L1450} /// // clang-format on future> UpdateRouter( @@ -1430,9 +1809,10 @@ class RoutersClient { // clang-format off /// /// 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. + /// request. This method conforms toPUT 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. /// https://cloud.google.com/compute/docs/reference/rest/v1/routers/update /// /// @param request Unary RPCs, such as the one wrapped by this @@ -1461,7 +1841,7 @@ class RoutersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.routers.v1.UpdateRouterRequest]: @cloud_cpp_reference_link{google/cloud/compute/routers/v1/routers.proto#L955} + /// [google.cloud.cpp.compute.routers.v1.UpdateRouterRequest]: @cloud_cpp_reference_link{google/cloud/compute/routers/v1/routers.proto#L1450} /// // clang-format on future> UpdateRouter( @@ -1499,6 +1879,130 @@ class RoutersClient { google::cloud::cpp::compute::v1::Operation const& operation, Options opts = {}); + // clang-format off + /// + /// Updates or creates new Named Set + /// https://cloud.google.com/compute/docs/reference/rest/v1/routers/updateNamedSet + /// + /// @param project Project ID for this request. + /// @param region Name of the region for this request. + /// @param router Name of the Router resource where Named Set is defined. + /// @param named_set_resource The NamedSet for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.routers.v1.UpdateNamedSetRequest]: @cloud_cpp_reference_link{google/cloud/compute/routers/v1/routers.proto#L1370} + /// + // clang-format on + future> UpdateNamedSet( + std::string const& project, std::string const& region, + std::string const& router, + google::cloud::cpp::compute::v1::NamedSet const& named_set_resource, + Options opts = {}); + + // clang-format off + /// + /// @copybrief UpdateNamedSet + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr UpdateNamedSet( + NoAwaitTag, std::string const& project, std::string const& region, + std::string const& router, + google::cloud::cpp::compute::v1::NamedSet const& named_set_resource, + Options opts = {}); + + // clang-format off + /// + /// Updates or creates new Named Set + /// https://cloud.google.com/compute/docs/reference/rest/v1/routers/updateNamedSet + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.routers.v1.UpdateNamedSetRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.routers.v1.UpdateNamedSetRequest]: @cloud_cpp_reference_link{google/cloud/compute/routers/v1/routers.proto#L1370} + /// + // clang-format on + future> UpdateNamedSet( + google::cloud::cpp::compute::routers::v1::UpdateNamedSetRequest const& + request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief UpdateNamedSet + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr UpdateNamedSet( + NoAwaitTag, + google::cloud::cpp::compute::routers::v1::UpdateNamedSetRequest const& + request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief UpdateNamedSet + /// + /// This method accepts a `google::cloud::cpp::compute::v1::Operation` that corresponds + /// to a previously started Long Running Operation (LRO) and polls the status + /// of the LRO in the background. + /// + // clang-format on + future> UpdateNamedSet( + google::cloud::cpp::compute::v1::Operation const& operation, + Options opts = {}); + // clang-format off /// /// Updates or creates new Route Policy @@ -1528,7 +2032,7 @@ class RoutersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.routers.v1.UpdateRoutePolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/routers/v1/routers.proto#L918} + /// [google.cloud.cpp.compute.routers.v1.UpdateRoutePolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/routers/v1/routers.proto#L1410} /// // clang-format on future> @@ -1586,7 +2090,7 @@ class RoutersClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.routers.v1.UpdateRoutePolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/routers/v1/routers.proto#L918} + /// [google.cloud.cpp.compute.routers.v1.UpdateRoutePolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/routers/v1/routers.proto#L1410} /// // clang-format on future> diff --git a/google/cloud/compute/routers/v1/routers_connection.cc b/google/cloud/compute/routers/v1/routers_connection.cc index 68d51728dc775..181d4c0cadd80 100644 --- a/google/cloud/compute/routers/v1/routers_connection.cc +++ b/google/cloud/compute/routers/v1/routers_connection.cc @@ -70,6 +70,30 @@ RoutersConnection::DeleteRouter( Status(StatusCode::kUnimplemented, "not implemented")); } +future> +RoutersConnection::DeleteNamedSet( + google::cloud::cpp::compute::routers::v1::DeleteNamedSetRequest const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +RoutersConnection::DeleteNamedSet( + NoAwaitTag, + google::cloud::cpp::compute::routers::v1::DeleteNamedSetRequest const&) { + return StatusOr( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +RoutersConnection::DeleteNamedSet( + google::cloud::cpp::compute::v1::Operation const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + future> RoutersConnection::DeleteRoutePolicy( google::cloud::cpp::compute::routers::v1::DeleteRoutePolicyRequest const&) { @@ -99,6 +123,12 @@ StatusOr RoutersConnection::GetRouter( return Status(StatusCode::kUnimplemented, "not implemented"); } +StatusOr +RoutersConnection::GetNamedSet( + google::cloud::cpp::compute::routers::v1::GetNamedSetRequest const&) { + return Status(StatusCode::kUnimplemented, "not implemented"); +} + StatusOr RoutersConnection::GetNatIpInfo( google::cloud::cpp::compute::routers::v1::GetNatIpInfoRequest const&) { @@ -161,6 +191,12 @@ RoutersConnection::ListBgpRoutes( return Status(StatusCode::kUnimplemented, "not implemented"); } +StatusOr +RoutersConnection::ListNamedSets( + google::cloud::cpp::compute::routers::v1::ListNamedSetsRequest const&) { + return Status(StatusCode::kUnimplemented, "not implemented"); +} + StatusOr RoutersConnection::ListRoutePolicies( google::cloud::cpp::compute::routers::v1::ListRoutePoliciesRequest const&) { @@ -191,6 +227,30 @@ RoutersConnection::PatchRouter( Status(StatusCode::kUnimplemented, "not implemented")); } +future> +RoutersConnection::PatchNamedSet( + google::cloud::cpp::compute::routers::v1::PatchNamedSetRequest const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +RoutersConnection::PatchNamedSet( + NoAwaitTag, + google::cloud::cpp::compute::routers::v1::PatchNamedSetRequest const&) { + return StatusOr( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +RoutersConnection::PatchNamedSet( + google::cloud::cpp::compute::v1::Operation const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + future> RoutersConnection::PatchRoutePolicy( google::cloud::cpp::compute::routers::v1::PatchRoutePolicyRequest const&) { @@ -245,6 +305,30 @@ RoutersConnection::UpdateRouter( Status(StatusCode::kUnimplemented, "not implemented")); } +future> +RoutersConnection::UpdateNamedSet( + google::cloud::cpp::compute::routers::v1::UpdateNamedSetRequest const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +RoutersConnection::UpdateNamedSet( + NoAwaitTag, + google::cloud::cpp::compute::routers::v1::UpdateNamedSetRequest const&) { + return StatusOr( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +RoutersConnection::UpdateNamedSet( + google::cloud::cpp::compute::v1::Operation const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + future> RoutersConnection::UpdateRoutePolicy( google::cloud::cpp::compute::routers::v1::UpdateRoutePolicyRequest const&) { diff --git a/google/cloud/compute/routers/v1/routers_connection.h b/google/cloud/compute/routers/v1/routers_connection.h index 21f9c3e2fad74..112fa7fe0432d 100644 --- a/google/cloud/compute/routers/v1/routers_connection.h +++ b/google/cloud/compute/routers/v1/routers_connection.h @@ -201,6 +201,19 @@ class RoutersConnection { virtual future> DeleteRouter(google::cloud::cpp::compute::v1::Operation const& operation); + virtual future> + DeleteNamedSet( + google::cloud::cpp::compute::routers::v1::DeleteNamedSetRequest const& + request); + + virtual StatusOr DeleteNamedSet( + NoAwaitTag, + google::cloud::cpp::compute::routers::v1::DeleteNamedSetRequest const& + request); + + virtual future> + DeleteNamedSet(google::cloud::cpp::compute::v1::Operation const& operation); + virtual future> DeleteRoutePolicy( google::cloud::cpp::compute::routers::v1::DeleteRoutePolicyRequest const& @@ -220,6 +233,11 @@ class RoutersConnection { google::cloud::cpp::compute::routers::v1::GetRouterRequest const& request); + virtual StatusOr + GetNamedSet( + google::cloud::cpp::compute::routers::v1::GetNamedSetRequest const& + request); + virtual StatusOr GetNatIpInfo( google::cloud::cpp::compute::routers::v1::GetNatIpInfoRequest const& @@ -262,6 +280,11 @@ class RoutersConnection { google::cloud::cpp::compute::routers::v1::ListBgpRoutesRequest const& request); + virtual StatusOr + ListNamedSets( + google::cloud::cpp::compute::routers::v1::ListNamedSetsRequest const& + request); + virtual StatusOr ListRoutePolicies( google::cloud::cpp::compute::routers::v1::ListRoutePoliciesRequest const& @@ -280,6 +303,19 @@ class RoutersConnection { virtual future> PatchRouter(google::cloud::cpp::compute::v1::Operation const& operation); + virtual future> + PatchNamedSet( + google::cloud::cpp::compute::routers::v1::PatchNamedSetRequest const& + request); + + virtual StatusOr PatchNamedSet( + NoAwaitTag, + google::cloud::cpp::compute::routers::v1::PatchNamedSetRequest const& + request); + + virtual future> + PatchNamedSet(google::cloud::cpp::compute::v1::Operation const& operation); + virtual future> PatchRoutePolicy( google::cloud::cpp::compute::routers::v1::PatchRoutePolicyRequest const& @@ -310,6 +346,19 @@ class RoutersConnection { virtual future> UpdateRouter(google::cloud::cpp::compute::v1::Operation const& operation); + virtual future> + UpdateNamedSet( + google::cloud::cpp::compute::routers::v1::UpdateNamedSetRequest const& + request); + + virtual StatusOr UpdateNamedSet( + NoAwaitTag, + google::cloud::cpp::compute::routers::v1::UpdateNamedSetRequest const& + request); + + virtual future> + UpdateNamedSet(google::cloud::cpp::compute::v1::Operation const& operation); + virtual future> UpdateRoutePolicy( google::cloud::cpp::compute::routers::v1::UpdateRoutePolicyRequest const& diff --git a/google/cloud/compute/routers/v1/routers_connection_idempotency_policy.cc b/google/cloud/compute/routers/v1/routers_connection_idempotency_policy.cc index e770eb3839d0f..97b86eb9137ae 100644 --- a/google/cloud/compute/routers/v1/routers_connection_idempotency_policy.cc +++ b/google/cloud/compute/routers/v1/routers_connection_idempotency_policy.cc @@ -45,6 +45,11 @@ Idempotency RoutersConnectionIdempotencyPolicy::DeleteRouter( return Idempotency::kNonIdempotent; } +Idempotency RoutersConnectionIdempotencyPolicy::DeleteNamedSet( + google::cloud::cpp::compute::routers::v1::DeleteNamedSetRequest const&) { + return Idempotency::kNonIdempotent; +} + Idempotency RoutersConnectionIdempotencyPolicy::DeleteRoutePolicy( google::cloud::cpp::compute::routers::v1::DeleteRoutePolicyRequest const&) { return Idempotency::kNonIdempotent; @@ -55,6 +60,11 @@ Idempotency RoutersConnectionIdempotencyPolicy::GetRouter( return Idempotency::kIdempotent; } +Idempotency RoutersConnectionIdempotencyPolicy::GetNamedSet( + google::cloud::cpp::compute::routers::v1::GetNamedSetRequest const&) { + return Idempotency::kIdempotent; +} + Idempotency RoutersConnectionIdempotencyPolicy::GetNatIpInfo( google::cloud::cpp::compute::routers::v1::GetNatIpInfoRequest const&) { return Idempotency::kIdempotent; @@ -90,6 +100,11 @@ Idempotency RoutersConnectionIdempotencyPolicy::ListBgpRoutes( return Idempotency::kIdempotent; } +Idempotency RoutersConnectionIdempotencyPolicy::ListNamedSets( + google::cloud::cpp::compute::routers::v1::ListNamedSetsRequest const&) { + return Idempotency::kIdempotent; +} + Idempotency RoutersConnectionIdempotencyPolicy::ListRoutePolicies( google::cloud::cpp::compute::routers::v1::ListRoutePoliciesRequest const&) { return Idempotency::kIdempotent; @@ -100,6 +115,11 @@ Idempotency RoutersConnectionIdempotencyPolicy::PatchRouter( return Idempotency::kNonIdempotent; } +Idempotency RoutersConnectionIdempotencyPolicy::PatchNamedSet( + google::cloud::cpp::compute::routers::v1::PatchNamedSetRequest const&) { + return Idempotency::kNonIdempotent; +} + Idempotency RoutersConnectionIdempotencyPolicy::PatchRoutePolicy( google::cloud::cpp::compute::routers::v1::PatchRoutePolicyRequest const&) { return Idempotency::kNonIdempotent; @@ -115,6 +135,11 @@ Idempotency RoutersConnectionIdempotencyPolicy::UpdateRouter( return Idempotency::kIdempotent; } +Idempotency RoutersConnectionIdempotencyPolicy::UpdateNamedSet( + google::cloud::cpp::compute::routers::v1::UpdateNamedSetRequest const&) { + return Idempotency::kNonIdempotent; +} + Idempotency RoutersConnectionIdempotencyPolicy::UpdateRoutePolicy( google::cloud::cpp::compute::routers::v1::UpdateRoutePolicyRequest const&) { return Idempotency::kNonIdempotent; diff --git a/google/cloud/compute/routers/v1/routers_connection_idempotency_policy.h b/google/cloud/compute/routers/v1/routers_connection_idempotency_policy.h index f1de3e599d65b..383f3edbe3537 100644 --- a/google/cloud/compute/routers/v1/routers_connection_idempotency_policy.h +++ b/google/cloud/compute/routers/v1/routers_connection_idempotency_policy.h @@ -44,6 +44,10 @@ class RoutersConnectionIdempotencyPolicy { google::cloud::cpp::compute::routers::v1::DeleteRouterRequest const& request); + virtual google::cloud::Idempotency DeleteNamedSet( + google::cloud::cpp::compute::routers::v1::DeleteNamedSetRequest const& + request); + virtual google::cloud::Idempotency DeleteRoutePolicy( google::cloud::cpp::compute::routers::v1::DeleteRoutePolicyRequest const& request); @@ -52,6 +56,10 @@ class RoutersConnectionIdempotencyPolicy { google::cloud::cpp::compute::routers::v1::GetRouterRequest const& request); + virtual google::cloud::Idempotency GetNamedSet( + google::cloud::cpp::compute::routers::v1::GetNamedSetRequest const& + request); + virtual google::cloud::Idempotency GetNatIpInfo( google::cloud::cpp::compute::routers::v1::GetNatIpInfoRequest const& request); @@ -79,6 +87,10 @@ class RoutersConnectionIdempotencyPolicy { google::cloud::cpp::compute::routers::v1::ListBgpRoutesRequest const& request); + virtual google::cloud::Idempotency ListNamedSets( + google::cloud::cpp::compute::routers::v1::ListNamedSetsRequest const& + request); + virtual google::cloud::Idempotency ListRoutePolicies( google::cloud::cpp::compute::routers::v1::ListRoutePoliciesRequest const& request); @@ -87,6 +99,10 @@ class RoutersConnectionIdempotencyPolicy { google::cloud::cpp::compute::routers::v1::PatchRouterRequest const& request); + virtual google::cloud::Idempotency PatchNamedSet( + google::cloud::cpp::compute::routers::v1::PatchNamedSetRequest const& + request); + virtual google::cloud::Idempotency PatchRoutePolicy( google::cloud::cpp::compute::routers::v1::PatchRoutePolicyRequest const& request); @@ -98,6 +114,10 @@ class RoutersConnectionIdempotencyPolicy { google::cloud::cpp::compute::routers::v1::UpdateRouterRequest const& request); + virtual google::cloud::Idempotency UpdateNamedSet( + google::cloud::cpp::compute::routers::v1::UpdateNamedSetRequest const& + request); + virtual google::cloud::Idempotency UpdateRoutePolicy( google::cloud::cpp::compute::routers::v1::UpdateRoutePolicyRequest const& request); diff --git a/google/cloud/compute/routers/v1/routers_proto_export.h b/google/cloud/compute/routers/v1/routers_proto_export.h index 405c57335485c..92386c33dc551 100644 --- a/google/cloud/compute/routers/v1/routers_proto_export.h +++ b/google/cloud/compute/routers/v1/routers_proto_export.h @@ -26,10 +26,10 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROUTERS_V1_ROUTERS_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include "google/cloud/compute/v1/internal/common_013.pb.h" #include "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_031.pb.h" -#include "google/cloud/compute/v1/internal/common_115.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_040.pb.h" +#include "google/cloud/compute/v1/internal/common_138.pb.h" // 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/internal/routes_rest_connection_impl.cc b/google/cloud/compute/routes/v1/internal/routes_rest_connection_impl.cc index c259e3b3351bb..a5e96a7501922 100644 --- a/google/cloud/compute/routes/v1/internal/routes_rest_connection_impl.cc +++ b/google/cloud/compute/routes/v1/internal/routes_rest_connection_impl.cc @@ -351,6 +351,22 @@ RoutesRestConnectionImpl::ListRoutes( }); } +StatusOr +RoutesRestConnectionImpl::TestIamPermissions( + google::cloud::cpp::compute::routes::v1::TestIamPermissionsRequest const& + request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->TestIamPermissions(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::routes::v1:: + TestIamPermissionsRequest const& request) { + return stub_->TestIamPermissions(rest_context, options, request); + }, + *current, request, __func__); +} + GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END } // namespace compute_routes_v1_internal } // namespace cloud diff --git a/google/cloud/compute/routes/v1/internal/routes_rest_connection_impl.h b/google/cloud/compute/routes/v1/internal/routes_rest_connection_impl.h index 115a2ef2757ef..2603c372521cf 100644 --- a/google/cloud/compute/routes/v1/internal/routes_rest_connection_impl.h +++ b/google/cloud/compute/routes/v1/internal/routes_rest_connection_impl.h @@ -81,6 +81,11 @@ class RoutesRestConnectionImpl : public compute_routes_v1::RoutesConnection { google::cloud::cpp::compute::routes::v1::ListRoutesRequest request) override; + StatusOr + TestIamPermissions( + google::cloud::cpp::compute::routes::v1::TestIamPermissionsRequest const& + request) override; + private: static std::unique_ptr retry_policy( Options const& options) { diff --git a/google/cloud/compute/routes/v1/internal/routes_rest_logging_decorator.cc b/google/cloud/compute/routes/v1/internal/routes_rest_logging_decorator.cc index 4b5499efde70b..ec8428c9201c7 100644 --- a/google/cloud/compute/routes/v1/internal/routes_rest_logging_decorator.cc +++ b/google/cloud/compute/routes/v1/internal/routes_rest_logging_decorator.cc @@ -127,6 +127,20 @@ RoutesRestLogging::ListRoutes( rest_context, options, request, __func__, tracing_options_); } +StatusOr +RoutesRestLogging::TestIamPermissions( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::routes::v1::TestIamPermissionsRequest const& + request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::routes::v1:: + TestIamPermissionsRequest const& request) { + return child_->TestIamPermissions(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + future> RoutesRestLogging::AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/routes/v1/internal/routes_rest_logging_decorator.h b/google/cloud/compute/routes/v1/internal/routes_rest_logging_decorator.h index 7a8a9ea8ed26f..da266c566d5b3 100644 --- a/google/cloud/compute/routes/v1/internal/routes_rest_logging_decorator.h +++ b/google/cloud/compute/routes/v1/internal/routes_rest_logging_decorator.h @@ -80,6 +80,13 @@ class RoutesRestLogging : public RoutesRestStub { google::cloud::cpp::compute::routes::v1::ListRoutesRequest const& request) override; + StatusOr + TestIamPermissions( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::routes::v1::TestIamPermissionsRequest const& + request) override; + future> AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/routes/v1/internal/routes_rest_metadata_decorator.cc b/google/cloud/compute/routes/v1/internal/routes_rest_metadata_decorator.cc index 818766a2b48e6..aa28a6677db1a 100644 --- a/google/cloud/compute/routes/v1/internal/routes_rest_metadata_decorator.cc +++ b/google/cloud/compute/routes/v1/internal/routes_rest_metadata_decorator.cc @@ -95,6 +95,15 @@ RoutesRestMetadata::ListRoutes( return child_->ListRoutes(rest_context, options, request); } +StatusOr +RoutesRestMetadata::TestIamPermissions( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::routes::v1::TestIamPermissionsRequest const& + request) { + SetMetadata(rest_context, options); + return child_->TestIamPermissions(rest_context, options, request); +} + future> RoutesRestMetadata::AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/routes/v1/internal/routes_rest_metadata_decorator.h b/google/cloud/compute/routes/v1/internal/routes_rest_metadata_decorator.h index 50258b5aad3bc..4f6e5dc21bf3d 100644 --- a/google/cloud/compute/routes/v1/internal/routes_rest_metadata_decorator.h +++ b/google/cloud/compute/routes/v1/internal/routes_rest_metadata_decorator.h @@ -79,6 +79,13 @@ class RoutesRestMetadata : public RoutesRestStub { google::cloud::cpp::compute::routes::v1::ListRoutesRequest const& request) override; + StatusOr + TestIamPermissions( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::routes::v1::TestIamPermissionsRequest const& + request) override; + google::cloud::future> AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/routes/v1/internal/routes_rest_stub.cc b/google/cloud/compute/routes/v1/internal/routes_rest_stub.cc index eacfd65950be4..84c8fcb4c15f6 100644 --- a/google/cloud/compute/routes/v1/internal/routes_rest_stub.cc +++ b/google/cloud/compute/routes/v1/internal/routes_rest_stub.cc @@ -194,6 +194,25 @@ DefaultRoutesRestStub::ListRoutes( std::move(query_params)); } +StatusOr +DefaultRoutesRestStub::TestIamPermissions( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::routes::v1::TestIamPermissionsRequest const& + request) { + std::vector> query_params; + return rest_internal::Post< + google::cloud::cpp::compute::v1::TestPermissionsResponse>( + *service_, rest_context, request.test_permissions_request_resource(), + false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "global", "/", + "routes", "/", request.resource(), "/", + "testIamPermissions"), + std::move(query_params)); +} + future> DefaultRoutesRestStub::AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/routes/v1/internal/routes_rest_stub.h b/google/cloud/compute/routes/v1/internal/routes_rest_stub.h index 9ed3cd9f4246d..669397eabf05d 100644 --- a/google/cloud/compute/routes/v1/internal/routes_rest_stub.h +++ b/google/cloud/compute/routes/v1/internal/routes_rest_stub.h @@ -77,6 +77,13 @@ class RoutesRestStub { google::cloud::cpp::compute::routes::v1::ListRoutesRequest const& request) = 0; + virtual StatusOr + TestIamPermissions( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::routes::v1::TestIamPermissionsRequest const& + request) = 0; + virtual future> AsyncGetOperation( google::cloud::CompletionQueue& cq, @@ -140,6 +147,13 @@ class DefaultRoutesRestStub : public RoutesRestStub { google::cloud::cpp::compute::routes::v1::ListRoutesRequest const& request) override; + StatusOr + TestIamPermissions( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::routes::v1::TestIamPermissionsRequest const& + request) override; + future> AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/routes/v1/internal/routes_tracing_connection.cc b/google/cloud/compute/routes/v1/internal/routes_tracing_connection.cc index 5b0b2b32276be..44f641aef873d 100644 --- a/google/cloud/compute/routes/v1/internal/routes_tracing_connection.cc +++ b/google/cloud/compute/routes/v1/internal/routes_tracing_connection.cc @@ -111,6 +111,16 @@ RoutesTracingConnection::ListRoutes( google::cloud::cpp::compute::v1::Route>(std::move(span), std::move(sr)); } +StatusOr +RoutesTracingConnection::TestIamPermissions( + google::cloud::cpp::compute::routes::v1::TestIamPermissionsRequest const& + request) { + auto span = internal::MakeSpan( + "compute_routes_v1::RoutesConnection::TestIamPermissions"); + auto scope = opentelemetry::trace::Scope(span); + return internal::EndSpan(*span, child_->TestIamPermissions(request)); +} + std::shared_ptr MakeRoutesTracingConnection( std::shared_ptr conn) { diff --git a/google/cloud/compute/routes/v1/internal/routes_tracing_connection.h b/google/cloud/compute/routes/v1/internal/routes_tracing_connection.h index 9fa1a83a198a2..0bfd7936bed13 100644 --- a/google/cloud/compute/routes/v1/internal/routes_tracing_connection.h +++ b/google/cloud/compute/routes/v1/internal/routes_tracing_connection.h @@ -69,6 +69,11 @@ class RoutesTracingConnection : public compute_routes_v1::RoutesConnection { google::cloud::cpp::compute::routes::v1::ListRoutesRequest request) override; + StatusOr + TestIamPermissions( + google::cloud::cpp::compute::routes::v1::TestIamPermissionsRequest const& + request) override; + private: std::shared_ptr child_; }; diff --git a/google/cloud/compute/routes/v1/mocks/mock_routes_connection.h b/google/cloud/compute/routes/v1/mocks/mock_routes_connection.h index 29bda66fbd1e6..0d231135d792b 100644 --- a/google/cloud/compute/routes/v1/mocks/mock_routes_connection.h +++ b/google/cloud/compute/routes/v1/mocks/mock_routes_connection.h @@ -139,6 +139,13 @@ class MockRoutesConnection : public compute_routes_v1::RoutesConnection { (StreamRange), ListRoutes, (google::cloud::cpp::compute::routes::v1::ListRoutesRequest request), (override)); + + MOCK_METHOD( + StatusOr, + TestIamPermissions, + (google::cloud::cpp::compute::routes::v1::TestIamPermissionsRequest const& + request), + (override)); }; GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END diff --git a/google/cloud/compute/routes/v1/routes_client.cc b/google/cloud/compute/routes/v1/routes_client.cc index 91c45148315cf..0c876fde73e6b 100644 --- a/google/cloud/compute/routes/v1/routes_client.cc +++ b/google/cloud/compute/routes/v1/routes_client.cc @@ -152,6 +152,30 @@ StreamRange RoutesClient::ListRoutes( return connection_->ListRoutes(std::move(request)); } +StatusOr +RoutesClient::TestIamPermissions( + std::string const& project, std::string const& resource, + google::cloud::cpp::compute::v1::TestPermissionsRequest const& + test_permissions_request_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::routes::v1::TestIamPermissionsRequest request; + request.set_project(project); + request.set_resource(resource); + *request.mutable_test_permissions_request_resource() = + test_permissions_request_resource; + return connection_->TestIamPermissions(request); +} + +StatusOr +RoutesClient::TestIamPermissions( + google::cloud::cpp::compute::routes::v1::TestIamPermissionsRequest const& + request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->TestIamPermissions(request); +} + GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END } // namespace compute_routes_v1 } // namespace cloud diff --git a/google/cloud/compute/routes/v1/routes_client.h b/google/cloud/compute/routes/v1/routes_client.h index 82fa46cb19af7..84889cf1b8b6d 100644 --- a/google/cloud/compute/routes/v1/routes_client.h +++ b/google/cloud/compute/routes/v1/routes_client.h @@ -112,7 +112,7 @@ class RoutesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.routes.v1.DeleteRouteRequest]: @cloud_cpp_reference_link{google/cloud/compute/routes/v1/routes.proto#L86} + /// [google.cloud.cpp.compute.routes.v1.DeleteRouteRequest]: @cloud_cpp_reference_link{google/cloud/compute/routes/v1/routes.proto#L99} /// // clang-format on future> DeleteRoute( @@ -164,7 +164,7 @@ class RoutesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.routes.v1.DeleteRouteRequest]: @cloud_cpp_reference_link{google/cloud/compute/routes/v1/routes.proto#L86} + /// [google.cloud.cpp.compute.routes.v1.DeleteRouteRequest]: @cloud_cpp_reference_link{google/cloud/compute/routes/v1/routes.proto#L99} /// // clang-format on future> DeleteRoute( @@ -222,8 +222,8 @@ class RoutesClient { /// [`future`]: @ref google::cloud::future /// [`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_115.proto#L27} + /// [google.cloud.cpp.compute.routes.v1.GetRouteRequest]: @cloud_cpp_reference_link{google/cloud/compute/routes/v1/routes.proto#L128} + /// [google.cloud.cpp.compute.v1.Route]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_138.proto#L29} /// // clang-format on StatusOr GetRoute( @@ -253,8 +253,8 @@ class RoutesClient { /// [`future`]: @ref google::cloud::future /// [`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_115.proto#L27} + /// [google.cloud.cpp.compute.routes.v1.GetRouteRequest]: @cloud_cpp_reference_link{google/cloud/compute/routes/v1/routes.proto#L128} + /// [google.cloud.cpp.compute.v1.Route]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_138.proto#L29} /// // clang-format on StatusOr GetRoute( @@ -289,7 +289,7 @@ class RoutesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.routes.v1.InsertRouteRequest]: @cloud_cpp_reference_link{google/cloud/compute/routes/v1/routes.proto#L123} + /// [google.cloud.cpp.compute.routes.v1.InsertRouteRequest]: @cloud_cpp_reference_link{google/cloud/compute/routes/v1/routes.proto#L139} /// // clang-format on future> InsertRoute( @@ -345,7 +345,7 @@ class RoutesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.routes.v1.InsertRouteRequest]: @cloud_cpp_reference_link{google/cloud/compute/routes/v1/routes.proto#L123} + /// [google.cloud.cpp.compute.routes.v1.InsertRouteRequest]: @cloud_cpp_reference_link{google/cloud/compute/routes/v1/routes.proto#L139} /// // clang-format on future> InsertRoute( @@ -411,8 +411,8 @@ class RoutesClient { /// [`future`]: @ref google::cloud::future /// [`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_115.proto#L27} + /// [google.cloud.cpp.compute.routes.v1.ListRoutesRequest]: @cloud_cpp_reference_link{google/cloud/compute/routes/v1/routes.proto#L168} + /// [google.cloud.cpp.compute.v1.Route]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_138.proto#L29} /// // clang-format on StreamRange ListRoutes( @@ -451,14 +451,80 @@ class RoutesClient { /// [`future`]: @ref google::cloud::future /// [`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_115.proto#L27} + /// [google.cloud.cpp.compute.routes.v1.ListRoutesRequest]: @cloud_cpp_reference_link{google/cloud/compute/routes/v1/routes.proto#L168} + /// [google.cloud.cpp.compute.v1.Route]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_138.proto#L29} /// // clang-format on StreamRange ListRoutes( google::cloud::cpp::compute::routes::v1::ListRoutesRequest request, Options opts = {}); + // clang-format off + /// + /// Returns permissions that a caller has on the specified resource. + /// https://cloud.google.com/compute/docs/reference/rest/v1/routes/testIamPermissions + /// + /// @param project Project ID for this request. + /// @param resource Name or id of the resource for this request. + /// @param test_permissions_request_resource The TestPermissionsRequest for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.TestPermissionsResponse]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.routes.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/routes/v1/routes.proto#L269} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} + /// + // clang-format on + StatusOr + TestIamPermissions( + std::string const& project, std::string const& resource, + google::cloud::cpp::compute::v1::TestPermissionsRequest const& + test_permissions_request_resource, + Options opts = {}); + + // clang-format off + /// + /// Returns permissions that a caller has on the specified resource. + /// https://cloud.google.com/compute/docs/reference/rest/v1/routes/testIamPermissions + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.routes.v1.TestIamPermissionsRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.TestPermissionsResponse]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.routes.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/routes/v1/routes.proto#L269} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} + /// + // clang-format on + StatusOr + TestIamPermissions( + google::cloud::cpp::compute::routes::v1::TestIamPermissionsRequest const& + request, + Options opts = {}); + private: std::shared_ptr connection_; Options options_; diff --git a/google/cloud/compute/routes/v1/routes_connection.cc b/google/cloud/compute/routes/v1/routes_connection.cc index 6149345af3fbd..a7a94ee90a6d5 100644 --- a/google/cloud/compute/routes/v1/routes_connection.cc +++ b/google/cloud/compute/routes/v1/routes_connection.cc @@ -97,6 +97,12 @@ RoutesConnection::ListRoutes( StreamRange>(); } +StatusOr +RoutesConnection::TestIamPermissions( + google::cloud::cpp::compute::routes::v1::TestIamPermissionsRequest const&) { + return Status(StatusCode::kUnimplemented, "not implemented"); +} + GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END } // namespace compute_routes_v1 } // namespace cloud diff --git a/google/cloud/compute/routes/v1/routes_connection.h b/google/cloud/compute/routes/v1/routes_connection.h index 1ee615c1fa68f..4b20408247484 100644 --- a/google/cloud/compute/routes/v1/routes_connection.h +++ b/google/cloud/compute/routes/v1/routes_connection.h @@ -210,6 +210,11 @@ class RoutesConnection { virtual StreamRange ListRoutes( google::cloud::cpp::compute::routes::v1::ListRoutesRequest request); + + virtual StatusOr + TestIamPermissions( + google::cloud::cpp::compute::routes::v1::TestIamPermissionsRequest const& + request); }; GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END diff --git a/google/cloud/compute/routes/v1/routes_connection_idempotency_policy.cc b/google/cloud/compute/routes/v1/routes_connection_idempotency_policy.cc index 6155ffcdb7d9d..dd36d5755492e 100644 --- a/google/cloud/compute/routes/v1/routes_connection_idempotency_policy.cc +++ b/google/cloud/compute/routes/v1/routes_connection_idempotency_policy.cc @@ -54,6 +54,11 @@ Idempotency RoutesConnectionIdempotencyPolicy::ListRoutes( return Idempotency::kIdempotent; } +Idempotency RoutesConnectionIdempotencyPolicy::TestIamPermissions( + google::cloud::cpp::compute::routes::v1::TestIamPermissionsRequest const&) { + return Idempotency::kNonIdempotent; +} + std::unique_ptr MakeDefaultRoutesConnectionIdempotencyPolicy() { return std::make_unique(); diff --git a/google/cloud/compute/routes/v1/routes_connection_idempotency_policy.h b/google/cloud/compute/routes/v1/routes_connection_idempotency_policy.h index bdbd0ca4e2128..91d5bd22549f3 100644 --- a/google/cloud/compute/routes/v1/routes_connection_idempotency_policy.h +++ b/google/cloud/compute/routes/v1/routes_connection_idempotency_policy.h @@ -49,6 +49,10 @@ class RoutesConnectionIdempotencyPolicy { virtual google::cloud::Idempotency ListRoutes( google::cloud::cpp::compute::routes::v1::ListRoutesRequest request); + + virtual google::cloud::Idempotency TestIamPermissions( + google::cloud::cpp::compute::routes::v1::TestIamPermissionsRequest const& + request); }; std::unique_ptr diff --git a/google/cloud/compute/routes/v1/routes_proto_export.h b/google/cloud/compute/routes/v1/routes_proto_export.h index f6371fbf47845..b4e1b3a7d2b99 100644 --- a/google/cloud/compute/routes/v1/routes_proto_export.h +++ b/google/cloud/compute/routes/v1/routes_proto_export.h @@ -26,9 +26,10 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROUTES_V1_ROUTES_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_115.pb.h" -#include "google/cloud/compute/v1/internal/common_116.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_138.pb.h" +#include "google/cloud/compute/v1/internal/common_139.pb.h" +#include "google/cloud/compute/v1/internal/common_171.pb.h" // 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 783af613eeaf4..4c753adecd4f7 100644 --- a/google/cloud/compute/security_policies/v1/security_policies_client.h +++ b/google/cloud/compute/security_policies/v1/security_policies_client.h @@ -117,7 +117,7 @@ class SecurityPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.security_policies.v1.AddRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/security_policies/v1/security_policies.proto#L191} + /// [google.cloud.cpp.compute.security_policies.v1.AddRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/security_policies/v1/security_policies.proto#L195} /// // clang-format on future> AddRule( @@ -175,7 +175,7 @@ class SecurityPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.security_policies.v1.AddRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/security_policies/v1/security_policies.proto#L191} + /// [google.cloud.cpp.compute.security_policies.v1.AddRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/security_policies/v1/security_policies.proto#L195} /// // clang-format on future> AddRule( @@ -216,8 +216,10 @@ class SecurityPoliciesClient { // clang-format off /// /// 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`. + /// available to the specified project. + /// + /// To prevent failure, Google recommends that you set the + /// `returnPartialSuccess` parameter to `true`. /// https://cloud.google.com/compute/docs/reference/rest/v1/securityPolicies/aggregatedList /// /// @param project Name of the project scoping this request. @@ -243,8 +245,8 @@ class SecurityPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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_094.proto#L149} + /// [google.cloud.cpp.compute.security_policies.v1.AggregatedListSecurityPoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/security_policies/v1/security_policies.proto#L216} + /// [google.cloud.cpp.compute.v1.SecurityPoliciesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_140.proto#L161} /// // clang-format on StreamRange> @@ -377,7 +381,7 @@ class SecurityPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.security_policies.v1.DeleteSecurityPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/security_policies/v1/security_policies.proto#L294} + /// [google.cloud.cpp.compute.security_policies.v1.DeleteSecurityPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/security_policies/v1/security_policies.proto#L331} /// // clang-format on future> @@ -436,8 +440,8 @@ class SecurityPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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_117.proto#L29} + /// [google.cloud.cpp.compute.security_policies.v1.GetSecurityPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/security_policies/v1/security_policies.proto#L374} + /// [google.cloud.cpp.compute.v1.SecurityPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_141.proto#L31} /// // clang-format on StatusOr GetSecurityPolicy( @@ -468,8 +472,8 @@ class SecurityPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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_117.proto#L29} + /// [google.cloud.cpp.compute.security_policies.v1.GetSecurityPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/security_policies/v1/security_policies.proto#L374} + /// [google.cloud.cpp.compute.v1.SecurityPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_141.proto#L31} /// // clang-format on StatusOr GetSecurityPolicy( @@ -497,8 +501,8 @@ class SecurityPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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_117.proto#L371} + /// [google.cloud.cpp.compute.security_policies.v1.GetRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/security_policies/v1/security_policies.proto#L360} + /// [google.cloud.cpp.compute.v1.SecurityPolicyRule]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_141.proto#L503} /// // clang-format on StatusOr GetRule( @@ -529,8 +533,8 @@ class SecurityPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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_117.proto#L371} + /// [google.cloud.cpp.compute.security_policies.v1.GetRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/security_policies/v1/security_policies.proto#L360} + /// [google.cloud.cpp.compute.v1.SecurityPolicyRule]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_141.proto#L503} /// // clang-format on StatusOr GetRule( @@ -566,7 +570,7 @@ class SecurityPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.security_policies.v1.InsertSecurityPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/security_policies/v1/security_policies.proto#L345} + /// [google.cloud.cpp.compute.security_policies.v1.InsertSecurityPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/security_policies/v1/security_policies.proto#L385} /// // clang-format on future> @@ -624,7 +628,7 @@ class SecurityPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.security_policies.v1.InsertSecurityPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/security_policies/v1/security_policies.proto#L345} + /// [google.cloud.cpp.compute.security_policies.v1.InsertSecurityPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/security_policies/v1/security_policies.proto#L385} /// // clang-format on future> @@ -691,8 +695,8 @@ class SecurityPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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_117.proto#L29} + /// [google.cloud.cpp.compute.security_policies.v1.ListSecurityPoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/security_policies/v1/security_policies.proto#L518} + /// [google.cloud.cpp.compute.v1.SecurityPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_141.proto#L31} /// // clang-format on StreamRange @@ -731,8 +735,8 @@ class SecurityPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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_117.proto#L29} + /// [google.cloud.cpp.compute.security_policies.v1.ListSecurityPoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/security_policies/v1/security_policies.proto#L518} + /// [google.cloud.cpp.compute.v1.SecurityPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_141.proto#L31} /// // clang-format on StreamRange @@ -760,8 +764,8 @@ class SecurityPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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_094.proto#L144} + /// [google.cloud.cpp.compute.security_policies.v1.ListPreconfiguredExpressionSetsRequest]: @cloud_cpp_reference_link{google/cloud/compute/security_policies/v1/security_policies.proto#L417} + /// [google.cloud.cpp.compute.v1.SecurityPoliciesListPreconfiguredExpressionSetsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_111.proto#L29} /// // clang-format on StatusOr> @@ -902,7 +906,7 @@ class SecurityPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.security_policies.v1.PatchSecurityPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/security_policies/v1/security_policies.proto#L537} + /// [google.cloud.cpp.compute.security_policies.v1.PatchSecurityPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/security_policies/v1/security_policies.proto#L646} /// // clang-format on future> @@ -970,7 +974,7 @@ class SecurityPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.security_policies.v1.PatchRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/security_policies/v1/security_policies.proto#L510} + /// [google.cloud.cpp.compute.security_policies.v1.PatchRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/security_policies/v1/security_policies.proto#L619} /// // clang-format on future> PatchRule( @@ -1029,7 +1033,7 @@ class SecurityPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.security_policies.v1.PatchRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/security_policies/v1/security_policies.proto#L510} + /// [google.cloud.cpp.compute.security_policies.v1.PatchRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/security_policies/v1/security_policies.proto#L619} /// // clang-format on future> PatchRule( @@ -1094,7 +1098,7 @@ class SecurityPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.security_policies.v1.RemoveRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/security_policies/v1/security_policies.proto#L570} + /// [google.cloud.cpp.compute.security_policies.v1.RemoveRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/security_policies/v1/security_policies.proto#L682} /// // clang-format on future> RemoveRule( @@ -1147,7 +1151,7 @@ class SecurityPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.security_policies.v1.RemoveRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/security_policies/v1/security_policies.proto#L570} + /// [google.cloud.cpp.compute.security_policies.v1.RemoveRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/security_policies/v1/security_policies.proto#L682} /// // clang-format on future> RemoveRule( @@ -1187,8 +1191,9 @@ class SecurityPoliciesClient { // clang-format off /// - /// Sets the labels on a security policy. To learn more about labels, read the - /// Labeling Resources documentation. + /// Sets the labels on a security policy. To learn more about labels, + /// read the Labeling Resources + /// documentation. /// https://cloud.google.com/compute/docs/reference/rest/v1/securityPolicies/setLabels /// /// @param project Project ID for this request. @@ -1214,7 +1219,7 @@ class SecurityPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.security_policies.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/security_policies/v1/security_policies.proto#L587} + /// [google.cloud.cpp.compute.security_policies.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/security_policies/v1/security_policies.proto#L699} /// // clang-format on future> SetLabels( @@ -1242,8 +1247,9 @@ class SecurityPoliciesClient { // clang-format off /// - /// Sets the labels on a security policy. To learn more about labels, read the - /// Labeling Resources documentation. + /// Sets the labels on a security policy. To learn more about labels, + /// read the Labeling Resources + /// documentation. /// https://cloud.google.com/compute/docs/reference/rest/v1/securityPolicies/setLabels /// /// @param request Unary RPCs, such as the one wrapped by this @@ -1272,7 +1278,7 @@ class SecurityPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.security_policies.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/security_policies/v1/security_policies.proto#L587} + /// [google.cloud.cpp.compute.security_policies.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/security_policies/v1/security_policies.proto#L699} /// // clang-format on future> SetLabels( diff --git a/google/cloud/compute/security_policies/v1/security_policies_proto_export.h b/google/cloud/compute/security_policies/v1/security_policies_proto_export.h index bd3ba6eb69771..8021f880c450b 100644 --- a/google/cloud/compute/security_policies/v1/security_policies_proto_export.h +++ b/google/cloud/compute/security_policies/v1/security_policies_proto_export.h @@ -26,11 +26,12 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_SECURITY_POLICIES_V1_SECURITY_POLICIES_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_031.pb.h" -#include "google/cloud/compute/v1/internal/common_046.pb.h" -#include "google/cloud/compute/v1/internal/common_094.pb.h" -#include "google/cloud/compute/v1/internal/common_117.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_040.pb.h" +#include "google/cloud/compute/v1/internal/common_056.pb.h" +#include "google/cloud/compute/v1/internal/common_111.pb.h" +#include "google/cloud/compute/v1/internal/common_140.pb.h" +#include "google/cloud/compute/v1/internal/common_141.pb.h" // 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/internal/service_attachments_rest_stub.cc b/google/cloud/compute/service_attachments/v1/internal/service_attachments_rest_stub.cc index 340878aa67e93..85bbadab29d22 100644 --- a/google/cloud/compute/service_attachments/v1/internal/service_attachments_rest_stub.cc +++ b/google/cloud/compute/service_attachments/v1/internal/service_attachments_rest_stub.cc @@ -141,6 +141,10 @@ DefaultServiceAttachmentsRestStub::GetServiceAttachment( google::cloud::cpp::compute::service_attachments::v1:: GetServiceAttachmentRequest const& request) { std::vector> query_params; + query_params.push_back( + {"show_nat_ips", (request.show_nat_ips() ? "1" : "0")}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); return rest_internal::Get( *service_, rest_context, request, false, absl::StrCat("/", "compute", "/", 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 f8c60231ea018..31043614be781 100644 --- a/google/cloud/compute/service_attachments/v1/service_attachments_client.h +++ b/google/cloud/compute/service_attachments/v1/service_attachments_client.h @@ -92,9 +92,11 @@ class ServiceAttachmentsClient { // clang-format off /// - /// 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`. + /// 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`. /// https://cloud.google.com/compute/docs/reference/rest/v1/serviceAttachments/aggregatedList /// /// @param project Name of the project scoping this request. @@ -120,8 +122,8 @@ class ServiceAttachmentsClient { /// [`future`]: @ref google::cloud::future /// [`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_119.proto#L411} + /// [google.cloud.cpp.compute.service_attachments.v1.AggregatedListServiceAttachmentsRequest]: @cloud_cpp_reference_link{google/cloud/compute/service_attachments/v1/service_attachments.proto#L156} + /// [google.cloud.cpp.compute.v1.ServiceAttachmentsScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_143.proto#L495} /// // clang-format on StreamRange< @@ -132,9 +134,11 @@ class ServiceAttachmentsClient { // clang-format off /// - /// 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`. + /// 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`. /// https://cloud.google.com/compute/docs/reference/rest/v1/serviceAttachments/aggregatedList /// /// @param request Unary RPCs, such as the one wrapped by this @@ -165,8 +169,8 @@ class ServiceAttachmentsClient { /// [`future`]: @ref google::cloud::future /// [`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_119.proto#L411} + /// [google.cloud.cpp.compute.service_attachments.v1.AggregatedListServiceAttachmentsRequest]: @cloud_cpp_reference_link{google/cloud/compute/service_attachments/v1/service_attachments.proto#L156} + /// [google.cloud.cpp.compute.v1.ServiceAttachmentsScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_143.proto#L495} /// // clang-format on StreamRange< @@ -205,7 +209,7 @@ class ServiceAttachmentsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.service_attachments.v1.DeleteServiceAttachmentRequest]: @cloud_cpp_reference_link{google/cloud/compute/service_attachments/v1/service_attachments.proto#L235} + /// [google.cloud.cpp.compute.service_attachments.v1.DeleteServiceAttachmentRequest]: @cloud_cpp_reference_link{google/cloud/compute/service_attachments/v1/service_attachments.proto#L271} /// // clang-format on future> @@ -259,7 +263,7 @@ class ServiceAttachmentsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.service_attachments.v1.DeleteServiceAttachmentRequest]: @cloud_cpp_reference_link{google/cloud/compute/service_attachments/v1/service_attachments.proto#L235} + /// [google.cloud.cpp.compute.service_attachments.v1.DeleteServiceAttachmentRequest]: @cloud_cpp_reference_link{google/cloud/compute/service_attachments/v1/service_attachments.proto#L271} /// // clang-format on future> @@ -319,8 +323,8 @@ class ServiceAttachmentsClient { /// [`future`]: @ref google::cloud::future /// [`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_119.proto#L28} + /// [google.cloud.cpp.compute.service_attachments.v1.GetServiceAttachmentRequest]: @cloud_cpp_reference_link{google/cloud/compute/service_attachments/v1/service_attachments.proto#L326} + /// [google.cloud.cpp.compute.v1.ServiceAttachment]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_143.proto#L32} /// // clang-format on StatusOr @@ -352,8 +356,8 @@ class ServiceAttachmentsClient { /// [`future`]: @ref google::cloud::future /// [`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_119.proto#L28} + /// [google.cloud.cpp.compute.service_attachments.v1.GetServiceAttachmentRequest]: @cloud_cpp_reference_link{google/cloud/compute/service_attachments/v1/service_attachments.proto#L326} + /// [google.cloud.cpp.compute.v1.ServiceAttachment]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_143.proto#L32} /// // clang-format on StatusOr @@ -383,8 +387,8 @@ class ServiceAttachmentsClient { /// [`future`]: @ref google::cloud::future /// [`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_007.proto#L178} + /// [google.cloud.cpp.compute.service_attachments.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/service_attachments/v1/service_attachments.proto#L307} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr GetIamPolicy( @@ -416,8 +420,8 @@ class ServiceAttachmentsClient { /// [`future`]: @ref google::cloud::future /// [`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_007.proto#L178} + /// [google.cloud.cpp.compute.service_attachments.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/service_attachments/v1/service_attachments.proto#L307} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr GetIamPolicy( @@ -454,7 +458,7 @@ class ServiceAttachmentsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.service_attachments.v1.InsertServiceAttachmentRequest]: @cloud_cpp_reference_link{google/cloud/compute/service_attachments/v1/service_attachments.proto#L302} + /// [google.cloud.cpp.compute.service_attachments.v1.InsertServiceAttachmentRequest]: @cloud_cpp_reference_link{google/cloud/compute/service_attachments/v1/service_attachments.proto#L344} /// // clang-format on future> @@ -513,7 +517,7 @@ class ServiceAttachmentsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.service_attachments.v1.InsertServiceAttachmentRequest]: @cloud_cpp_reference_link{google/cloud/compute/service_attachments/v1/service_attachments.proto#L302} + /// [google.cloud.cpp.compute.service_attachments.v1.InsertServiceAttachmentRequest]: @cloud_cpp_reference_link{google/cloud/compute/service_attachments/v1/service_attachments.proto#L344} /// // clang-format on future> @@ -581,8 +585,8 @@ class ServiceAttachmentsClient { /// [`future`]: @ref google::cloud::future /// [`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_119.proto#L28} + /// [google.cloud.cpp.compute.service_attachments.v1.ListServiceAttachmentsRequest]: @cloud_cpp_reference_link{google/cloud/compute/service_attachments/v1/service_attachments.proto#L380} + /// [google.cloud.cpp.compute.v1.ServiceAttachment]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_143.proto#L32} /// // clang-format on StreamRange @@ -622,8 +626,8 @@ class ServiceAttachmentsClient { /// [`future`]: @ref google::cloud::future /// [`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_119.proto#L28} + /// [google.cloud.cpp.compute.service_attachments.v1.ListServiceAttachmentsRequest]: @cloud_cpp_reference_link{google/cloud/compute/service_attachments/v1/service_attachments.proto#L380} + /// [google.cloud.cpp.compute.v1.ServiceAttachment]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_143.proto#L32} /// // clang-format on StreamRange @@ -634,8 +638,9 @@ class ServiceAttachmentsClient { // clang-format off /// /// 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. + /// the request. This method supports PATCH + /// semantics and usesJSON merge + /// patch format and processing rules. /// https://cloud.google.com/compute/docs/reference/rest/v1/serviceAttachments/patch /// /// @param project Project ID for this request. @@ -663,7 +668,7 @@ class ServiceAttachmentsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.service_attachments.v1.PatchServiceAttachmentRequest]: @cloud_cpp_reference_link{google/cloud/compute/service_attachments/v1/service_attachments.proto#L407} + /// [google.cloud.cpp.compute.service_attachments.v1.PatchServiceAttachmentRequest]: @cloud_cpp_reference_link{google/cloud/compute/service_attachments/v1/service_attachments.proto#L485} /// // clang-format on future> @@ -695,8 +700,9 @@ class ServiceAttachmentsClient { // clang-format off /// /// 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. + /// the request. This method supports PATCH + /// semantics and usesJSON merge + /// patch format and processing rules. /// https://cloud.google.com/compute/docs/reference/rest/v1/serviceAttachments/patch /// /// @param request Unary RPCs, such as the one wrapped by this @@ -725,7 +731,7 @@ class ServiceAttachmentsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.service_attachments.v1.PatchServiceAttachmentRequest]: @cloud_cpp_reference_link{google/cloud/compute/service_attachments/v1/service_attachments.proto#L407} + /// [google.cloud.cpp.compute.service_attachments.v1.PatchServiceAttachmentRequest]: @cloud_cpp_reference_link{google/cloud/compute/service_attachments/v1/service_attachments.proto#L485} /// // clang-format on future> @@ -766,8 +772,8 @@ class ServiceAttachmentsClient { // clang-format off /// - /// Sets the access control policy on the specified resource. Replaces any - /// existing policy. + /// Sets the access control policy on the specified resource. + /// Replaces any existing policy. /// https://cloud.google.com/compute/docs/reference/rest/v1/serviceAttachments/setIamPolicy /// /// @param project Project ID for this request. @@ -787,8 +793,8 @@ class ServiceAttachmentsClient { /// [`future`]: @ref google::cloud::future /// [`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_007.proto#L178} + /// [google.cloud.cpp.compute.service_attachments.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/service_attachments/v1/service_attachments.proto#L526} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr SetIamPolicy( @@ -800,8 +806,8 @@ class ServiceAttachmentsClient { // clang-format off /// - /// Sets the access control policy on the specified resource. Replaces any - /// existing policy. + /// Sets the access control policy on the specified resource. + /// Replaces any existing policy. /// https://cloud.google.com/compute/docs/reference/rest/v1/serviceAttachments/setIamPolicy /// /// @param request Unary RPCs, such as the one wrapped by this @@ -823,8 +829,8 @@ class ServiceAttachmentsClient { /// [`future`]: @ref google::cloud::future /// [`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_007.proto#L178} + /// [google.cloud.cpp.compute.service_attachments.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/service_attachments/v1/service_attachments.proto#L526} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr SetIamPolicy( @@ -854,8 +860,8 @@ class ServiceAttachmentsClient { /// [`future`]: @ref google::cloud::future /// [`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_145.proto#L30} + /// [google.cloud.cpp.compute.service_attachments.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/service_attachments/v1/service_attachments.proto#L546} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} /// // clang-format on StatusOr @@ -890,8 +896,8 @@ class ServiceAttachmentsClient { /// [`future`]: @ref google::cloud::future /// [`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_145.proto#L30} + /// [google.cloud.cpp.compute.service_attachments.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/service_attachments/v1/service_attachments.proto#L546} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.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 4d61226dba6e7..24b329c235ba9 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,13 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_SERVICE_ATTACHMENTS_V1_SERVICE_ATTACHMENTS_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include "google/cloud/compute/v1/internal/common_007.pb.h" -#include "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_031.pb.h" -#include "google/cloud/compute/v1/internal/common_108.pb.h" -#include "google/cloud/compute/v1/internal/common_119.pb.h" -#include "google/cloud/compute/v1/internal/common_145.pb.h" +#include "google/cloud/compute/v1/internal/common_009.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_040.pb.h" +#include "google/cloud/compute/v1/internal/common_126.pb.h" +#include "google/cloud/compute/v1/internal/common_143.pb.h" +#include "google/cloud/compute/v1/internal/common_171.pb.h" +#include "google/cloud/compute/v1/internal/common_172.pb.h" // 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/service_dirs.cmake b/google/cloud/compute/service_dirs.cmake index 8c659b7445cb3..ccf876c773cc3 100644 --- a/google/cloud/compute/service_dirs.cmake +++ b/google/cloud/compute/service_dirs.cmake @@ -18,9 +18,11 @@ set(service_dirs # cmake-format: sort "accelerator_types/v1/" "addresses/v1/" + "advice/v1/" "autoscalers/v1/" "backend_buckets/v1/" "backend_services/v1/" + "cross_site_networks/v1/" "disk_types/v1/" "disks/v1/" "external_vpn_gateways/v1/" @@ -31,7 +33,9 @@ set(service_dirs "global_forwarding_rules/v1/" "global_network_endpoint_groups/v1/" "global_public_delegated_prefixes/v1/" + "global_vm_extension_policies/v1/" "health_checks/v1/" + "hosts/v1/" "http_health_checks/v1/" "https_health_checks/v1/" "image_family_views/v1/" @@ -42,6 +46,7 @@ set(service_dirs "instance_settings/v1/" "instance_templates/v1/" "instances/v1/" + "instant_snapshot_groups/v1/" "instant_snapshots/v1/" "interconnect_attachment_groups/v1/" "interconnect_attachments/v1/" @@ -62,26 +67,36 @@ set(service_dirs "node_groups/v1/" "node_templates/v1/" "node_types/v1/" + "organization_security_policies/v1/" "packet_mirrorings/v1/" + "preview_features/v1/" "projects/v1/" "public_advertised_prefixes/v1/" "public_delegated_prefixes/v1/" "region_autoscalers/v1/" + "region_backend_buckets/v1/" "region_backend_services/v1/" "region_commitments/v1/" + "region_composite_health_checks/v1/" "region_disk_types/v1/" "region_disks/v1/" + "region_health_aggregation_policies/v1/" "region_health_check_services/v1/" "region_health_checks/v1/" + "region_health_sources/v1/" + "region_instance_group_manager_resize_requests/v1/" "region_instance_group_managers/v1/" "region_instance_groups/v1/" "region_instance_templates/v1/" "region_instances/v1/" + "region_instant_snapshot_groups/v1/" "region_instant_snapshots/v1/" "region_network_endpoint_groups/v1/" "region_network_firewall_policies/v1/" "region_notification_endpoints/v1/" "region_security_policies/v1/" + "region_snapshot_settings/v1/" + "region_snapshots/v1/" "region_ssl_certificates/v1/" "region_ssl_policies/v1/" "region_target_http_proxies/v1/" @@ -90,10 +105,14 @@ set(service_dirs "region_url_maps/v1/" "region_zones/v1/" "regions/v1/" + "reliability_risks/v1/" "reservation_blocks/v1/" + "reservation_slots/v1/" "reservation_sub_blocks/v1/" "reservations/v1/" "resource_policies/v1/" + "rollout_plans/v1/" + "rollouts/v1/" "routers/v1/" "routes/v1/" "security_policies/v1/" @@ -116,6 +135,8 @@ set(service_dirs "url_maps/v1/" "vpn_gateways/v1/" "vpn_tunnels/v1/" + "wire_groups/v1/" + "zone_vm_extension_policies/v1/" "zones/v1/") set(operation_service_dirs 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 4e7f4e65cee53..eb018c8bd4b6c 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_124.proto#L24} + /// [google.cloud.cpp.compute.v1.SnapshotSettings]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_148.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_124.proto#L24} + /// [google.cloud.cpp.compute.v1.SnapshotSettings]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_148.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 cff16a8f85b49..016ab927b211c 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 "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_124.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_148.pb.h" // 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/internal/snapshots_rest_connection_impl.cc b/google/cloud/compute/snapshots/v1/internal/snapshots_rest_connection_impl.cc index 8f3af69dd9df7..a138040215fc3 100644 --- a/google/cloud/compute/snapshots/v1/internal/snapshots_rest_connection_impl.cc +++ b/google/cloud/compute/snapshots/v1/internal/snapshots_rest_connection_impl.cc @@ -530,6 +530,136 @@ SnapshotsRestConnectionImpl::TestIamPermissions( *current, request, __func__); } +future> +SnapshotsRestConnectionImpl::UpdateKmsKey( + google::cloud::cpp::compute::snapshots::v1::UpdateKmsKeyRequest const& + request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::global_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, request, + [stub = stub_]( + CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::snapshots::v1::UpdateKmsKeyRequest const& + request) { + return stub->AsyncUpdateKmsKey(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->UpdateKmsKey(request), + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [request](std::string const& op, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest& r) { + r.set_project(request.project()); + r.set_operation(op); + }, + [request](std::string const& op, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest& r) { + r.set_project(request.project()); + r.set_operation(op); + }); +} + +StatusOr +SnapshotsRestConnectionImpl::UpdateKmsKey( + NoAwaitTag, + google::cloud::cpp::compute::snapshots::v1::UpdateKmsKeyRequest const& + request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->UpdateKmsKey(request), + [this]( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::snapshots::v1::UpdateKmsKeyRequest const& + request) { + return stub_->UpdateKmsKey(rest_context, options, request); + }, + *current, request, __func__); +} + +future> +SnapshotsRestConnectionImpl::UpdateKmsKey( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestAwaitLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::global_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, operation, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [operation](std::string const&, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_operation(info.operation); + }, + [operation](std::string const&, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_operation(info.operation); + }); +} + GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END } // namespace compute_snapshots_v1_internal } // namespace cloud diff --git a/google/cloud/compute/snapshots/v1/internal/snapshots_rest_connection_impl.h b/google/cloud/compute/snapshots/v1/internal/snapshots_rest_connection_impl.h index 845f6fdd46732..3c20539cdcd9c 100644 --- a/google/cloud/compute/snapshots/v1/internal/snapshots_rest_connection_impl.h +++ b/google/cloud/compute/snapshots/v1/internal/snapshots_rest_connection_impl.h @@ -106,6 +106,18 @@ class SnapshotsRestConnectionImpl TestIamPermissions(google::cloud::cpp::compute::snapshots::v1:: TestIamPermissionsRequest const& request) override; + future> UpdateKmsKey( + google::cloud::cpp::compute::snapshots::v1::UpdateKmsKeyRequest const& + request) override; + + StatusOr UpdateKmsKey( + NoAwaitTag, + google::cloud::cpp::compute::snapshots::v1::UpdateKmsKeyRequest const& + request) override; + + future> UpdateKmsKey( + google::cloud::cpp::compute::v1::Operation const& operation) override; + private: static std::unique_ptr retry_policy(Options const& options) { diff --git a/google/cloud/compute/snapshots/v1/internal/snapshots_rest_logging_decorator.cc b/google/cloud/compute/snapshots/v1/internal/snapshots_rest_logging_decorator.cc index b2bb36b0fd847..cf398f58b35a3 100644 --- a/google/cloud/compute/snapshots/v1/internal/snapshots_rest_logging_decorator.cc +++ b/google/cloud/compute/snapshots/v1/internal/snapshots_rest_logging_decorator.cc @@ -209,6 +209,42 @@ SnapshotsRestLogging::TestIamPermissions( rest_context, options, request, __func__, tracing_options_); } +future> +SnapshotsRestLogging::AsyncUpdateKmsKey( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::snapshots::v1::UpdateKmsKeyRequest const& + request) { + return google::cloud::internal::LogWrapper( + [this]( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::snapshots::v1::UpdateKmsKeyRequest const& + request) { + return child_->AsyncUpdateKmsKey(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +StatusOr +SnapshotsRestLogging::UpdateKmsKey( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::snapshots::v1::UpdateKmsKeyRequest const& + request) { + return google::cloud::internal::LogWrapper( + [this]( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::snapshots::v1::UpdateKmsKeyRequest const& + request) { + return child_->UpdateKmsKey(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + future> SnapshotsRestLogging::AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/snapshots/v1/internal/snapshots_rest_logging_decorator.h b/google/cloud/compute/snapshots/v1/internal/snapshots_rest_logging_decorator.h index bd987a7bea166..357ab393e99c4 100644 --- a/google/cloud/compute/snapshots/v1/internal/snapshots_rest_logging_decorator.h +++ b/google/cloud/compute/snapshots/v1/internal/snapshots_rest_logging_decorator.h @@ -113,6 +113,20 @@ class SnapshotsRestLogging : public SnapshotsRestStub { google::cloud::cpp::compute::snapshots::v1:: TestIamPermissionsRequest const& request) override; + future> + AsyncUpdateKmsKey( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::snapshots::v1::UpdateKmsKeyRequest const& + request) override; + + StatusOr UpdateKmsKey( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::snapshots::v1::UpdateKmsKeyRequest const& + request) override; + future> AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/snapshots/v1/internal/snapshots_rest_metadata_decorator.cc b/google/cloud/compute/snapshots/v1/internal/snapshots_rest_metadata_decorator.cc index 703d7346314ac..486186a550c76 100644 --- a/google/cloud/compute/snapshots/v1/internal/snapshots_rest_metadata_decorator.cc +++ b/google/cloud/compute/snapshots/v1/internal/snapshots_rest_metadata_decorator.cc @@ -146,6 +146,27 @@ SnapshotsRestMetadata::TestIamPermissions( return child_->TestIamPermissions(rest_context, options, request); } +future> +SnapshotsRestMetadata::AsyncUpdateKmsKey( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::snapshots::v1::UpdateKmsKeyRequest const& + request) { + SetMetadata(*rest_context, *options); + return child_->AsyncUpdateKmsKey(cq, std::move(rest_context), + std::move(options), request); +} + +StatusOr +SnapshotsRestMetadata::UpdateKmsKey( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::snapshots::v1::UpdateKmsKeyRequest const& + request) { + SetMetadata(rest_context, options); + return child_->UpdateKmsKey(rest_context, options, request); +} + future> SnapshotsRestMetadata::AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/snapshots/v1/internal/snapshots_rest_metadata_decorator.h b/google/cloud/compute/snapshots/v1/internal/snapshots_rest_metadata_decorator.h index 10a45c4d89a56..56ee56194b77d 100644 --- a/google/cloud/compute/snapshots/v1/internal/snapshots_rest_metadata_decorator.h +++ b/google/cloud/compute/snapshots/v1/internal/snapshots_rest_metadata_decorator.h @@ -111,6 +111,20 @@ class SnapshotsRestMetadata : public SnapshotsRestStub { google::cloud::cpp::compute::snapshots::v1:: TestIamPermissionsRequest const& request) override; + google::cloud::future> + AsyncUpdateKmsKey( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::snapshots::v1::UpdateKmsKeyRequest const& + request) override; + + StatusOr UpdateKmsKey( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::snapshots::v1::UpdateKmsKeyRequest const& + request) override; + google::cloud::future> AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/snapshots/v1/internal/snapshots_rest_stub.cc b/google/cloud/compute/snapshots/v1/internal/snapshots_rest_stub.cc index a9511128179d8..192c31a21f822 100644 --- a/google/cloud/compute/snapshots/v1/internal/snapshots_rest_stub.cc +++ b/google/cloud/compute/snapshots/v1/internal/snapshots_rest_stub.cc @@ -306,6 +306,64 @@ DefaultSnapshotsRestStub::TestIamPermissions( std::move(query_params)); } +future> +DefaultSnapshotsRestStub::AsyncUpdateKmsKey( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::snapshots::v1::UpdateKmsKeyRequest const& + request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto service, auto request, auto rest_context, auto options) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + p.set_value( + rest_internal::Post( + *service, *rest_context, + request.snapshot_update_kms_key_request_resource(), false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", *options), + "/", "projects", "/", request.project(), "/", + "global", "/", "snapshots", "/", + request.snapshot(), "/", "updateKmsKey"), + std::move(query_params))); + }, + std::move(p), + service_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +StatusOr +DefaultSnapshotsRestStub::UpdateKmsKey( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::snapshots::v1::UpdateKmsKeyRequest const& + request) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Post( + *service_, rest_context, + request.snapshot_update_kms_key_request_resource(), false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "global", "/", + "snapshots", "/", request.snapshot(), "/", "updateKmsKey"), + std::move(query_params)); +} + future> DefaultSnapshotsRestStub::AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/snapshots/v1/internal/snapshots_rest_stub.h b/google/cloud/compute/snapshots/v1/internal/snapshots_rest_stub.h index 875ac41116211..a75e6cbee2d38 100644 --- a/google/cloud/compute/snapshots/v1/internal/snapshots_rest_stub.h +++ b/google/cloud/compute/snapshots/v1/internal/snapshots_rest_stub.h @@ -109,6 +109,20 @@ class SnapshotsRestStub { google::cloud::cpp::compute::snapshots::v1:: TestIamPermissionsRequest const& request) = 0; + virtual future> + AsyncUpdateKmsKey( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::snapshots::v1::UpdateKmsKeyRequest const& + request) = 0; + + virtual StatusOr UpdateKmsKey( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::snapshots::v1::UpdateKmsKeyRequest const& + request) = 0; + virtual future> AsyncGetOperation( google::cloud::CompletionQueue& cq, @@ -205,6 +219,20 @@ class DefaultSnapshotsRestStub : public SnapshotsRestStub { google::cloud::cpp::compute::snapshots::v1:: TestIamPermissionsRequest const& request) override; + future> + AsyncUpdateKmsKey( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::snapshots::v1::UpdateKmsKeyRequest const& + request) override; + + StatusOr UpdateKmsKey( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::snapshots::v1::UpdateKmsKeyRequest const& + request) override; + future> AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/snapshots/v1/internal/snapshots_tracing_connection.cc b/google/cloud/compute/snapshots/v1/internal/snapshots_tracing_connection.cc index 45fc0a248e50d..927e6132d1edc 100644 --- a/google/cloud/compute/snapshots/v1/internal/snapshots_tracing_connection.cc +++ b/google/cloud/compute/snapshots/v1/internal/snapshots_tracing_connection.cc @@ -175,6 +175,36 @@ SnapshotsTracingConnection::TestIamPermissions( return internal::EndSpan(*span, child_->TestIamPermissions(request)); } +future> +SnapshotsTracingConnection::UpdateKmsKey( + google::cloud::cpp::compute::snapshots::v1::UpdateKmsKeyRequest const& + request) { + auto span = internal::MakeSpan( + "compute_snapshots_v1::SnapshotsConnection::UpdateKmsKey"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), child_->UpdateKmsKey(request)); +} + +StatusOr +SnapshotsTracingConnection::UpdateKmsKey( + NoAwaitTag, + google::cloud::cpp::compute::snapshots::v1::UpdateKmsKeyRequest const& + request) { + auto span = internal::MakeSpan( + "compute_snapshots_v1::SnapshotsConnection::UpdateKmsKey"); + opentelemetry::trace::Scope scope(span); + return internal::EndSpan(*span, child_->UpdateKmsKey(NoAwaitTag{}, request)); +} + +future> +SnapshotsTracingConnection::UpdateKmsKey( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto span = internal::MakeSpan( + "compute_snapshots_v1::SnapshotsConnection::UpdateKmsKey"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), child_->UpdateKmsKey(operation)); +} + std::shared_ptr MakeSnapshotsTracingConnection( std::shared_ptr conn) { diff --git a/google/cloud/compute/snapshots/v1/internal/snapshots_tracing_connection.h b/google/cloud/compute/snapshots/v1/internal/snapshots_tracing_connection.h index ce137314de40b..5de15e1dac53e 100644 --- a/google/cloud/compute/snapshots/v1/internal/snapshots_tracing_connection.h +++ b/google/cloud/compute/snapshots/v1/internal/snapshots_tracing_connection.h @@ -94,6 +94,18 @@ class SnapshotsTracingConnection TestIamPermissions(google::cloud::cpp::compute::snapshots::v1:: TestIamPermissionsRequest const& request) override; + future> UpdateKmsKey( + google::cloud::cpp::compute::snapshots::v1::UpdateKmsKeyRequest const& + request) override; + + StatusOr UpdateKmsKey( + NoAwaitTag, + google::cloud::cpp::compute::snapshots::v1::UpdateKmsKeyRequest const& + request) override; + + future> UpdateKmsKey( + google::cloud::cpp::compute::v1::Operation const& operation) override; + private: std::shared_ptr child_; }; diff --git a/google/cloud/compute/snapshots/v1/mocks/mock_snapshots_connection.h b/google/cloud/compute/snapshots/v1/mocks/mock_snapshots_connection.h index 00c9f9385d71d..8b47f53063450 100644 --- a/google/cloud/compute/snapshots/v1/mocks/mock_snapshots_connection.h +++ b/google/cloud/compute/snapshots/v1/mocks/mock_snapshots_connection.h @@ -204,6 +204,49 @@ class MockSnapshotsConnection (google::cloud::cpp::compute::snapshots::v1:: TestIamPermissionsRequest const& request), (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// UpdateKmsKey(Matcher(_))) + /// @endcode + MOCK_METHOD( + future>, + UpdateKmsKey, + (google::cloud::cpp::compute::snapshots::v1::UpdateKmsKeyRequest const& + request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// EXPECT_CALL(*mock, UpdateKmsKey(_, _)) + /// @endcode + MOCK_METHOD( + StatusOr, UpdateKmsKey, + (NoAwaitTag, + google::cloud::cpp::compute::snapshots::v1::UpdateKmsKeyRequest const& + request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// UpdateKmsKey(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + UpdateKmsKey, + (google::cloud::cpp::compute::v1::Operation const& operation), + (override)); }; GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END diff --git a/google/cloud/compute/snapshots/v1/snapshots_client.cc b/google/cloud/compute/snapshots/v1/snapshots_client.cc index 235073bf7947b..4d0eb5871329a 100644 --- a/google/cloud/compute/snapshots/v1/snapshots_client.cc +++ b/google/cloud/compute/snapshots/v1/snapshots_client.cc @@ -278,6 +278,62 @@ SnapshotsClient::TestIamPermissions( return connection_->TestIamPermissions(request); } +future> +SnapshotsClient::UpdateKmsKey( + std::string const& project, std::string const& snapshot, + google::cloud::cpp::compute::v1::SnapshotUpdateKmsKeyRequest const& + snapshot_update_kms_key_request_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::snapshots::v1::UpdateKmsKeyRequest request; + request.set_project(project); + request.set_snapshot(snapshot); + *request.mutable_snapshot_update_kms_key_request_resource() = + snapshot_update_kms_key_request_resource; + return connection_->UpdateKmsKey(request); +} + +StatusOr +SnapshotsClient::UpdateKmsKey( + NoAwaitTag, std::string const& project, std::string const& snapshot, + google::cloud::cpp::compute::v1::SnapshotUpdateKmsKeyRequest const& + snapshot_update_kms_key_request_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::snapshots::v1::UpdateKmsKeyRequest request; + request.set_project(project); + request.set_snapshot(snapshot); + *request.mutable_snapshot_update_kms_key_request_resource() = + snapshot_update_kms_key_request_resource; + return connection_->UpdateKmsKey(NoAwaitTag{}, request); +} + +future> +SnapshotsClient::UpdateKmsKey( + google::cloud::cpp::compute::snapshots::v1::UpdateKmsKeyRequest const& + request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->UpdateKmsKey(request); +} + +StatusOr +SnapshotsClient::UpdateKmsKey( + NoAwaitTag, + google::cloud::cpp::compute::snapshots::v1::UpdateKmsKeyRequest const& + request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->UpdateKmsKey(NoAwaitTag{}, request); +} + +future> +SnapshotsClient::UpdateKmsKey( + google::cloud::cpp::compute::v1::Operation const& operation, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->UpdateKmsKey(operation); +} + GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END } // namespace compute_snapshots_v1 } // namespace cloud diff --git a/google/cloud/compute/snapshots/v1/snapshots_client.h b/google/cloud/compute/snapshots/v1/snapshots_client.h index 26c5cf4080797..61d649c075ce9 100644 --- a/google/cloud/compute/snapshots/v1/snapshots_client.h +++ b/google/cloud/compute/snapshots/v1/snapshots_client.h @@ -88,11 +88,14 @@ class SnapshotsClient { // clang-format off /// - /// 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. + /// 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, seeDeleting + /// snapshots. /// https://cloud.google.com/compute/docs/reference/rest/v1/snapshots/delete /// /// @param project Project ID for this request. @@ -117,7 +120,7 @@ class SnapshotsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.snapshots.v1.DeleteSnapshotRequest]: @cloud_cpp_reference_link{google/cloud/compute/snapshots/v1/snapshots.proto#L148} + /// [google.cloud.cpp.compute.snapshots.v1.DeleteSnapshotRequest]: @cloud_cpp_reference_link{google/cloud/compute/snapshots/v1/snapshots.proto#L167} /// // clang-format on future> DeleteSnapshot( @@ -141,11 +144,14 @@ class SnapshotsClient { // clang-format off /// - /// 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. + /// 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, seeDeleting + /// snapshots. /// https://cloud.google.com/compute/docs/reference/rest/v1/snapshots/delete /// /// @param request Unary RPCs, such as the one wrapped by this @@ -174,7 +180,7 @@ class SnapshotsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.snapshots.v1.DeleteSnapshotRequest]: @cloud_cpp_reference_link{google/cloud/compute/snapshots/v1/snapshots.proto#L148} + /// [google.cloud.cpp.compute.snapshots.v1.DeleteSnapshotRequest]: @cloud_cpp_reference_link{google/cloud/compute/snapshots/v1/snapshots.proto#L167} /// // clang-format on future> DeleteSnapshot( @@ -232,8 +238,8 @@ class SnapshotsClient { /// [`future`]: @ref google::cloud::future /// [`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_122.proto#L29} + /// [google.cloud.cpp.compute.snapshots.v1.GetSnapshotRequest]: @cloud_cpp_reference_link{google/cloud/compute/snapshots/v1/snapshots.proto#L211} + /// [google.cloud.cpp.compute.v1.Snapshot]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_146.proto#L31} /// // clang-format on StatusOr GetSnapshot( @@ -264,8 +270,8 @@ class SnapshotsClient { /// [`future`]: @ref google::cloud::future /// [`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_122.proto#L29} + /// [google.cloud.cpp.compute.snapshots.v1.GetSnapshotRequest]: @cloud_cpp_reference_link{google/cloud/compute/snapshots/v1/snapshots.proto#L211} + /// [google.cloud.cpp.compute.v1.Snapshot]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_146.proto#L31} /// // clang-format on StatusOr GetSnapshot( @@ -294,8 +300,8 @@ class SnapshotsClient { /// [`future`]: @ref google::cloud::future /// [`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_007.proto#L178} + /// [google.cloud.cpp.compute.snapshots.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/snapshots/v1/snapshots.proto#L196} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr GetIamPolicy( @@ -327,8 +333,8 @@ class SnapshotsClient { /// [`future`]: @ref google::cloud::future /// [`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_007.proto#L178} + /// [google.cloud.cpp.compute.snapshots.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/snapshots/v1/snapshots.proto#L196} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr GetIamPolicy( @@ -338,10 +344,11 @@ class SnapshotsClient { // clang-format off /// - /// 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. + /// 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. /// https://cloud.google.com/compute/docs/reference/rest/v1/snapshots/insert /// /// @param project Project ID for this request. @@ -366,7 +373,7 @@ class SnapshotsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.snapshots.v1.InsertSnapshotRequest]: @cloud_cpp_reference_link{google/cloud/compute/snapshots/v1/snapshots.proto#L200} + /// [google.cloud.cpp.compute.snapshots.v1.InsertSnapshotRequest]: @cloud_cpp_reference_link{google/cloud/compute/snapshots/v1/snapshots.proto#L222} /// // clang-format on future> InsertSnapshot( @@ -392,10 +399,11 @@ class SnapshotsClient { // clang-format off /// - /// 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. + /// 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. /// https://cloud.google.com/compute/docs/reference/rest/v1/snapshots/insert /// /// @param request Unary RPCs, such as the one wrapped by this @@ -424,7 +432,7 @@ class SnapshotsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.snapshots.v1.InsertSnapshotRequest]: @cloud_cpp_reference_link{google/cloud/compute/snapshots/v1/snapshots.proto#L200} + /// [google.cloud.cpp.compute.snapshots.v1.InsertSnapshotRequest]: @cloud_cpp_reference_link{google/cloud/compute/snapshots/v1/snapshots.proto#L222} /// // clang-format on future> InsertSnapshot( @@ -464,8 +472,8 @@ class SnapshotsClient { // clang-format off /// - /// Retrieves the list of Snapshot resources contained within the specified - /// project. + /// Retrieves the list of Snapshot resources contained within + /// the specified project. /// https://cloud.google.com/compute/docs/reference/rest/v1/snapshots/list /// /// @param project Project ID for this request. @@ -491,8 +499,8 @@ class SnapshotsClient { /// [`future`]: @ref google::cloud::future /// [`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_122.proto#L29} + /// [google.cloud.cpp.compute.snapshots.v1.ListSnapshotsRequest]: @cloud_cpp_reference_link{google/cloud/compute/snapshots/v1/snapshots.proto#L251} + /// [google.cloud.cpp.compute.v1.Snapshot]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_146.proto#L31} /// // clang-format on StreamRange ListSnapshots( @@ -500,8 +508,8 @@ class SnapshotsClient { // clang-format off /// - /// Retrieves the list of Snapshot resources contained within the specified - /// project. + /// Retrieves the list of Snapshot resources contained within + /// the specified project. /// https://cloud.google.com/compute/docs/reference/rest/v1/snapshots/list /// /// @param request Unary RPCs, such as the one wrapped by this @@ -532,8 +540,8 @@ class SnapshotsClient { /// [`future`]: @ref google::cloud::future /// [`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_122.proto#L29} + /// [google.cloud.cpp.compute.snapshots.v1.ListSnapshotsRequest]: @cloud_cpp_reference_link{google/cloud/compute/snapshots/v1/snapshots.proto#L251} + /// [google.cloud.cpp.compute.v1.Snapshot]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_146.proto#L31} /// // clang-format on StreamRange ListSnapshots( @@ -542,8 +550,8 @@ class SnapshotsClient { // clang-format off /// - /// Sets the access control policy on the specified resource. Replaces any - /// existing policy. + /// Sets the access control policy on the specified resource. + /// Replaces any existing policy. /// https://cloud.google.com/compute/docs/reference/rest/v1/snapshots/setIamPolicy /// /// @param project Project ID for this request. @@ -562,8 +570,8 @@ class SnapshotsClient { /// [`future`]: @ref google::cloud::future /// [`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_007.proto#L178} + /// [google.cloud.cpp.compute.snapshots.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/snapshots/v1/snapshots.proto#L352} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr SetIamPolicy( @@ -574,8 +582,8 @@ class SnapshotsClient { // clang-format off /// - /// Sets the access control policy on the specified resource. Replaces any - /// existing policy. + /// Sets the access control policy on the specified resource. + /// Replaces any existing policy. /// https://cloud.google.com/compute/docs/reference/rest/v1/snapshots/setIamPolicy /// /// @param request Unary RPCs, such as the one wrapped by this @@ -597,8 +605,8 @@ class SnapshotsClient { /// [`future`]: @ref google::cloud::future /// [`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_007.proto#L178} + /// [google.cloud.cpp.compute.snapshots.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/snapshots/v1/snapshots.proto#L352} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr SetIamPolicy( @@ -608,8 +616,8 @@ class SnapshotsClient { // clang-format off /// - /// Sets the labels on a snapshot. To learn more about labels, read the - /// Labeling Resources documentation. + /// Sets the labels on a snapshot. To learn more about labels, read theLabeling + /// Resources documentation. /// https://cloud.google.com/compute/docs/reference/rest/v1/snapshots/setLabels /// /// @param project Project ID for this request. @@ -635,7 +643,7 @@ class SnapshotsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.snapshots.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/snapshots/v1/snapshots.proto#L310} + /// [google.cloud.cpp.compute.snapshots.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/snapshots/v1/snapshots.proto#L368} /// // clang-format on future> SetLabels( @@ -663,8 +671,8 @@ class SnapshotsClient { // clang-format off /// - /// Sets the labels on a snapshot. To learn more about labels, read the - /// Labeling Resources documentation. + /// Sets the labels on a snapshot. To learn more about labels, read theLabeling + /// Resources documentation. /// https://cloud.google.com/compute/docs/reference/rest/v1/snapshots/setLabels /// /// @param request Unary RPCs, such as the one wrapped by this @@ -693,7 +701,7 @@ class SnapshotsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.snapshots.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/snapshots/v1/snapshots.proto#L310} + /// [google.cloud.cpp.compute.snapshots.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/snapshots/v1/snapshots.proto#L368} /// // clang-format on future> SetLabels( @@ -752,8 +760,8 @@ class SnapshotsClient { /// [`future`]: @ref google::cloud::future /// [`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_145.proto#L30} + /// [google.cloud.cpp.compute.snapshots.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/snapshots/v1/snapshots.proto#L387} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} /// // clang-format on StatusOr @@ -787,8 +795,8 @@ class SnapshotsClient { /// [`future`]: @ref google::cloud::future /// [`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_145.proto#L30} + /// [google.cloud.cpp.compute.snapshots.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/snapshots/v1/snapshots.proto#L387} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} /// // clang-format on StatusOr @@ -796,6 +804,131 @@ class SnapshotsClient { TestIamPermissionsRequest const& request, Options opts = {}); + // clang-format off + /// + /// Rotates the customer-managed + /// encryption key to the latest version for the specified snapshot. + /// https://cloud.google.com/compute/docs/reference/rest/v1/snapshots/updateKmsKey + /// + /// @param project Project ID for this request. + /// @param snapshot Name of the snapshot resource to update. Should conform to RFC1035. + /// @param snapshot_update_kms_key_request_resource The SnapshotUpdateKmsKeyRequest for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.snapshots.v1.UpdateKmsKeyRequest]: @cloud_cpp_reference_link{google/cloud/compute/snapshots/v1/snapshots.proto#L402} + /// + // clang-format on + future> UpdateKmsKey( + std::string const& project, std::string const& snapshot, + google::cloud::cpp::compute::v1::SnapshotUpdateKmsKeyRequest const& + snapshot_update_kms_key_request_resource, + Options opts = {}); + + // clang-format off + /// + /// @copybrief UpdateKmsKey + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr UpdateKmsKey( + NoAwaitTag, std::string const& project, std::string const& snapshot, + google::cloud::cpp::compute::v1::SnapshotUpdateKmsKeyRequest const& + snapshot_update_kms_key_request_resource, + Options opts = {}); + + // clang-format off + /// + /// Rotates the customer-managed + /// encryption key to the latest version for the specified snapshot. + /// https://cloud.google.com/compute/docs/reference/rest/v1/snapshots/updateKmsKey + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.snapshots.v1.UpdateKmsKeyRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.snapshots.v1.UpdateKmsKeyRequest]: @cloud_cpp_reference_link{google/cloud/compute/snapshots/v1/snapshots.proto#L402} + /// + // clang-format on + future> UpdateKmsKey( + google::cloud::cpp::compute::snapshots::v1::UpdateKmsKeyRequest const& + request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief UpdateKmsKey + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr UpdateKmsKey( + NoAwaitTag, + google::cloud::cpp::compute::snapshots::v1::UpdateKmsKeyRequest const& + request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief UpdateKmsKey + /// + /// This method accepts a `google::cloud::cpp::compute::v1::Operation` that corresponds + /// to a previously started Long Running Operation (LRO) and polls the status + /// of the LRO in the background. + /// + // clang-format on + future> UpdateKmsKey( + google::cloud::cpp::compute::v1::Operation const& operation, + Options opts = {}); + private: std::shared_ptr connection_; Options options_; diff --git a/google/cloud/compute/snapshots/v1/snapshots_connection.cc b/google/cloud/compute/snapshots/v1/snapshots_connection.cc index 5a9696d7b4fa0..b9e7a2bd8f1d5 100644 --- a/google/cloud/compute/snapshots/v1/snapshots_connection.cc +++ b/google/cloud/compute/snapshots/v1/snapshots_connection.cc @@ -141,6 +141,30 @@ SnapshotsConnection::TestIamPermissions( return Status(StatusCode::kUnimplemented, "not implemented"); } +future> +SnapshotsConnection::UpdateKmsKey( + google::cloud::cpp::compute::snapshots::v1::UpdateKmsKeyRequest const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +SnapshotsConnection::UpdateKmsKey( + NoAwaitTag, + google::cloud::cpp::compute::snapshots::v1::UpdateKmsKeyRequest const&) { + return StatusOr( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +SnapshotsConnection::UpdateKmsKey( + google::cloud::cpp::compute::v1::Operation const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END } // namespace compute_snapshots_v1 } // namespace cloud diff --git a/google/cloud/compute/snapshots/v1/snapshots_connection.h b/google/cloud/compute/snapshots/v1/snapshots_connection.h index c8478224c89bd..a5b79ce06da9e 100644 --- a/google/cloud/compute/snapshots/v1/snapshots_connection.h +++ b/google/cloud/compute/snapshots/v1/snapshots_connection.h @@ -240,6 +240,19 @@ class SnapshotsConnection { virtual StatusOr TestIamPermissions(google::cloud::cpp::compute::snapshots::v1:: TestIamPermissionsRequest const& request); + + virtual future> + UpdateKmsKey( + google::cloud::cpp::compute::snapshots::v1::UpdateKmsKeyRequest const& + request); + + virtual StatusOr UpdateKmsKey( + NoAwaitTag, + google::cloud::cpp::compute::snapshots::v1::UpdateKmsKeyRequest const& + request); + + virtual future> + UpdateKmsKey(google::cloud::cpp::compute::v1::Operation const& operation); }; GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END diff --git a/google/cloud/compute/snapshots/v1/snapshots_connection_idempotency_policy.cc b/google/cloud/compute/snapshots/v1/snapshots_connection_idempotency_policy.cc index 27414a749e864..b2cd4bc1f9c6a 100644 --- a/google/cloud/compute/snapshots/v1/snapshots_connection_idempotency_policy.cc +++ b/google/cloud/compute/snapshots/v1/snapshots_connection_idempotency_policy.cc @@ -76,6 +76,11 @@ Idempotency SnapshotsConnectionIdempotencyPolicy::TestIamPermissions( return Idempotency::kNonIdempotent; } +Idempotency SnapshotsConnectionIdempotencyPolicy::UpdateKmsKey( + google::cloud::cpp::compute::snapshots::v1::UpdateKmsKeyRequest const&) { + return Idempotency::kNonIdempotent; +} + std::unique_ptr MakeDefaultSnapshotsConnectionIdempotencyPolicy() { return std::make_unique(); diff --git a/google/cloud/compute/snapshots/v1/snapshots_connection_idempotency_policy.h b/google/cloud/compute/snapshots/v1/snapshots_connection_idempotency_policy.h index f3d7fed50796b..26b789af5d672 100644 --- a/google/cloud/compute/snapshots/v1/snapshots_connection_idempotency_policy.h +++ b/google/cloud/compute/snapshots/v1/snapshots_connection_idempotency_policy.h @@ -66,6 +66,10 @@ class SnapshotsConnectionIdempotencyPolicy { virtual google::cloud::Idempotency TestIamPermissions( google::cloud::cpp::compute::snapshots::v1:: TestIamPermissionsRequest const& request); + + virtual google::cloud::Idempotency UpdateKmsKey( + google::cloud::cpp::compute::snapshots::v1::UpdateKmsKeyRequest const& + request); }; std::unique_ptr diff --git a/google/cloud/compute/snapshots/v1/snapshots_proto_export.h b/google/cloud/compute/snapshots/v1/snapshots_proto_export.h index 20047a2da893a..761efdb9b9ef1 100644 --- a/google/cloud/compute/snapshots/v1/snapshots_proto_export.h +++ b/google/cloud/compute/snapshots/v1/snapshots_proto_export.h @@ -26,15 +26,16 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_SNAPSHOTS_V1_SNAPSHOTS_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include "google/cloud/compute/v1/internal/common_007.pb.h" -#include "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_021.pb.h" -#include "google/cloud/compute/v1/internal/common_031.pb.h" -#include "google/cloud/compute/v1/internal/common_046.pb.h" -#include "google/cloud/compute/v1/internal/common_047.pb.h" -#include "google/cloud/compute/v1/internal/common_122.pb.h" -#include "google/cloud/compute/v1/internal/common_123.pb.h" -#include "google/cloud/compute/v1/internal/common_145.pb.h" +#include "google/cloud/compute/v1/internal/common_009.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_028.pb.h" +#include "google/cloud/compute/v1/internal/common_040.pb.h" +#include "google/cloud/compute/v1/internal/common_056.pb.h" +#include "google/cloud/compute/v1/internal/common_057.pb.h" +#include "google/cloud/compute/v1/internal/common_146.pb.h" +#include "google/cloud/compute/v1/internal/common_147.pb.h" +#include "google/cloud/compute/v1/internal/common_149.pb.h" +#include "google/cloud/compute/v1/internal/common_171.pb.h" // 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 cea45cebfa576..ac1b0e504e112 100644 --- a/google/cloud/compute/ssl_certificates/v1/ssl_certificates_client.h +++ b/google/cloud/compute/ssl_certificates/v1/ssl_certificates_client.h @@ -91,8 +91,10 @@ class SslCertificatesClient { // clang-format off /// /// 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`. + /// available to the specified project. + /// + /// To prevent failure, Google recommends that you set the + /// `returnPartialSuccess` parameter to `true`. /// https://cloud.google.com/compute/docs/reference/rest/v1/sslCertificates/aggregatedList /// /// @param project Name of the project scoping this request. @@ -118,8 +120,8 @@ class SslCertificatesClient { /// [`future`]: @ref google::cloud::future /// [`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_126.proto#L137} + /// [google.cloud.cpp.compute.ssl_certificates.v1.AggregatedListSslCertificatesRequest]: @cloud_cpp_reference_link{google/cloud/compute/ssl_certificates/v1/ssl_certificates.proto#L102} + /// [google.cloud.cpp.compute.v1.SslCertificatesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_151.proto#L159} /// // clang-format on StreamRange> @@ -252,7 +256,7 @@ class SslCertificatesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.ssl_certificates.v1.DeleteSslCertificateRequest]: @cloud_cpp_reference_link{google/cloud/compute/ssl_certificates/v1/ssl_certificates.proto#L182} + /// [google.cloud.cpp.compute.ssl_certificates.v1.DeleteSslCertificateRequest]: @cloud_cpp_reference_link{google/cloud/compute/ssl_certificates/v1/ssl_certificates.proto#L217} /// // clang-format on future> @@ -311,8 +315,8 @@ class SslCertificatesClient { /// [`future`]: @ref google::cloud::future /// [`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_125.proto#L39} + /// [google.cloud.cpp.compute.ssl_certificates.v1.GetSslCertificateRequest]: @cloud_cpp_reference_link{google/cloud/compute/ssl_certificates/v1/ssl_certificates.proto#L246} + /// [google.cloud.cpp.compute.v1.SslCertificate]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_150.proto#L59} /// // clang-format on StatusOr GetSslCertificate( @@ -343,8 +347,8 @@ class SslCertificatesClient { /// [`future`]: @ref google::cloud::future /// [`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_125.proto#L39} + /// [google.cloud.cpp.compute.ssl_certificates.v1.GetSslCertificateRequest]: @cloud_cpp_reference_link{google/cloud/compute/ssl_certificates/v1/ssl_certificates.proto#L246} + /// [google.cloud.cpp.compute.v1.SslCertificate]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_150.proto#L59} /// // clang-format on StatusOr GetSslCertificate( @@ -380,7 +384,7 @@ class SslCertificatesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.ssl_certificates.v1.InsertSslCertificateRequest]: @cloud_cpp_reference_link{google/cloud/compute/ssl_certificates/v1/ssl_certificates.proto#L219} + /// [google.cloud.cpp.compute.ssl_certificates.v1.InsertSslCertificateRequest]: @cloud_cpp_reference_link{google/cloud/compute/ssl_certificates/v1/ssl_certificates.proto#L257} /// // clang-format on future> @@ -438,7 +442,7 @@ class SslCertificatesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.ssl_certificates.v1.InsertSslCertificateRequest]: @cloud_cpp_reference_link{google/cloud/compute/ssl_certificates/v1/ssl_certificates.proto#L219} + /// [google.cloud.cpp.compute.ssl_certificates.v1.InsertSslCertificateRequest]: @cloud_cpp_reference_link{google/cloud/compute/ssl_certificates/v1/ssl_certificates.proto#L257} /// // clang-format on future> @@ -506,8 +510,8 @@ class SslCertificatesClient { /// [`future`]: @ref google::cloud::future /// [`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_125.proto#L39} + /// [google.cloud.cpp.compute.ssl_certificates.v1.ListSslCertificatesRequest]: @cloud_cpp_reference_link{google/cloud/compute/ssl_certificates/v1/ssl_certificates.proto#L286} + /// [google.cloud.cpp.compute.v1.SslCertificate]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_150.proto#L59} /// // clang-format on StreamRange @@ -547,8 +551,8 @@ class SslCertificatesClient { /// [`future`]: @ref google::cloud::future /// [`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_125.proto#L39} + /// [google.cloud.cpp.compute.ssl_certificates.v1.ListSslCertificatesRequest]: @cloud_cpp_reference_link{google/cloud/compute/ssl_certificates/v1/ssl_certificates.proto#L286} + /// [google.cloud.cpp.compute.v1.SslCertificate]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_150.proto#L59} /// // 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 35f1555726484..000d5054d4a54 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 "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_125.pb.h" -#include "google/cloud/compute/v1/internal/common_126.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_150.pb.h" +#include "google/cloud/compute/v1/internal/common_151.pb.h" // 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 af7b1b4c5a23e..6d42f3e68ad39 100644 --- a/google/cloud/compute/ssl_policies/v1/ssl_policies_client.h +++ b/google/cloud/compute/ssl_policies/v1/ssl_policies_client.h @@ -91,8 +91,10 @@ class SslPoliciesClient { // clang-format off /// /// 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`. + /// available to the specified project. + /// + /// To prevent failure, Google recommends that you set the + /// `returnPartialSuccess` parameter to `true`. /// https://cloud.google.com/compute/docs/reference/rest/v1/sslPolicies/aggregatedList /// /// @param project Name of the project scoping this request. @@ -118,8 +120,8 @@ class SslPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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_127.proto#L139} + /// [google.cloud.cpp.compute.ssl_policies.v1.AggregatedListSslPoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/ssl_policies/v1/ssl_policies.proto#L127} + /// [google.cloud.cpp.compute.v1.SslPoliciesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_152.proto#L160} /// // clang-format on StreamRange> DeleteSslPolicy( @@ -256,7 +260,7 @@ class SslPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.ssl_policies.v1.DeleteSslPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/ssl_policies/v1/ssl_policies.proto#L207} + /// [google.cloud.cpp.compute.ssl_policies.v1.DeleteSslPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/ssl_policies/v1/ssl_policies.proto#L242} /// // clang-format on future> DeleteSslPolicy( @@ -315,8 +319,8 @@ class SslPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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_128.proto#L140} + /// [google.cloud.cpp.compute.ssl_policies.v1.GetSslPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/ssl_policies/v1/ssl_policies.proto#L272} + /// [google.cloud.cpp.compute.v1.SslPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_153.proto#L165} /// // clang-format on StatusOr GetSslPolicy( @@ -347,8 +351,8 @@ class SslPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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_128.proto#L140} + /// [google.cloud.cpp.compute.ssl_policies.v1.GetSslPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/ssl_policies/v1/ssl_policies.proto#L272} + /// [google.cloud.cpp.compute.v1.SslPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_153.proto#L165} /// // clang-format on StatusOr GetSslPolicy( @@ -383,7 +387,7 @@ class SslPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.ssl_policies.v1.InsertSslPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/ssl_policies/v1/ssl_policies.proto#L246} + /// [google.cloud.cpp.compute.ssl_policies.v1.InsertSslPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/ssl_policies/v1/ssl_policies.proto#L284} /// // clang-format on future> InsertSslPolicy( @@ -438,7 +442,7 @@ class SslPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.ssl_policies.v1.InsertSslPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/ssl_policies/v1/ssl_policies.proto#L246} + /// [google.cloud.cpp.compute.ssl_policies.v1.InsertSslPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/ssl_policies/v1/ssl_policies.proto#L284} /// // clang-format on future> InsertSslPolicy( @@ -505,8 +509,8 @@ class SslPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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_128.proto#L140} + /// [google.cloud.cpp.compute.ssl_policies.v1.ListSslPoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/ssl_policies/v1/ssl_policies.proto#L414} + /// [google.cloud.cpp.compute.v1.SslPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_153.proto#L165} /// // clang-format on StreamRange ListSslPolicies( @@ -546,8 +550,8 @@ class SslPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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_128.proto#L140} + /// [google.cloud.cpp.compute.ssl_policies.v1.ListSslPoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/ssl_policies/v1/ssl_policies.proto#L414} + /// [google.cloud.cpp.compute.v1.SslPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_153.proto#L165} /// // clang-format on StreamRange ListSslPolicies( @@ -575,8 +579,8 @@ class SslPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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_128.proto#L132} + /// [google.cloud.cpp.compute.ssl_policies.v1.ListAvailableFeaturesRequest]: @cloud_cpp_reference_link{google/cloud/compute/ssl_policies/v1/ssl_policies.proto#L313} + /// [google.cloud.cpp.compute.v1.SslPoliciesListAvailableFeaturesResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_153.proto#L155} /// // clang-format on StatusOr< @@ -608,8 +612,8 @@ class SslPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`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_128.proto#L132} + /// [google.cloud.cpp.compute.ssl_policies.v1.ListAvailableFeaturesRequest]: @cloud_cpp_reference_link{google/cloud/compute/ssl_policies/v1/ssl_policies.proto#L313} + /// [google.cloud.cpp.compute.v1.SslPoliciesListAvailableFeaturesResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_153.proto#L155} /// // clang-format on StatusOr< @@ -647,7 +651,7 @@ class SslPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.ssl_policies.v1.PatchSslPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/ssl_policies/v1/ssl_policies.proto#L408} + /// [google.cloud.cpp.compute.ssl_policies.v1.PatchSslPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/ssl_policies/v1/ssl_policies.proto#L515} /// // clang-format on future> PatchSslPolicy( @@ -702,7 +706,7 @@ class SslPoliciesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.ssl_policies.v1.PatchSslPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/ssl_policies/v1/ssl_policies.proto#L408} + /// [google.cloud.cpp.compute.ssl_policies.v1.PatchSslPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/ssl_policies/v1/ssl_policies.proto#L515} /// // clang-format on future> PatchSslPolicy( 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 c5cb512953f3d..46980833f80b8 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 "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_127.pb.h" -#include "google/cloud/compute/v1/internal/common_128.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_152.pb.h" +#include "google/cloud/compute/v1/internal/common_153.pb.h" // 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 d7c7923f3ba61..26aed27245829 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 @@ -90,9 +90,10 @@ class StoragePoolTypesClient { // clang-format off /// - /// Retrieves an aggregated list of storage pool types. To prevent failure, - /// Google recommends that you set the `returnPartialSuccess` parameter to - /// `true`. + /// Retrieves an aggregated list of storage pool types. + /// + /// To prevent failure, Google recommends that you set the + /// `returnPartialSuccess` parameter to `true`. /// https://cloud.google.com/compute/docs/reference/rest/v1/storagePoolTypes/aggregatedList /// /// @param project Project ID for this request. @@ -118,8 +119,8 @@ class StoragePoolTypesClient { /// [`future`]: @ref google::cloud::future /// [`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_131.proto#L308} + /// [google.cloud.cpp.compute.storage_pool_types.v1.AggregatedListStoragePoolTypesRequest]: @cloud_cpp_reference_link{google/cloud/compute/storage_pool_types/v1/storage_pool_types.proto#L74} + /// [google.cloud.cpp.compute.v1.StoragePoolTypesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_157.proto#L352} /// // clang-format on StreamRange GetStoragePoolType( @@ -225,8 +227,8 @@ class StoragePoolTypesClient { /// [`future`]: @ref google::cloud::future /// [`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_131.proto#L26} + /// [google.cloud.cpp.compute.storage_pool_types.v1.GetStoragePoolTypeRequest]: @cloud_cpp_reference_link{google/cloud/compute/storage_pool_types/v1/storage_pool_types.proto#L189} + /// [google.cloud.cpp.compute.v1.StoragePoolType]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_157.proto#L26} /// // clang-format on StatusOr GetStoragePoolType( @@ -236,7 +238,8 @@ class StoragePoolTypesClient { // clang-format off /// - /// Retrieves a list of storage pool types available to the specified project. + /// Retrieves a list of storage pool types available to the specified + /// project. /// https://cloud.google.com/compute/docs/reference/rest/v1/storagePoolTypes/list /// /// @param project Project ID for this request. @@ -263,8 +266,8 @@ class StoragePoolTypesClient { /// [`future`]: @ref google::cloud::future /// [`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_131.proto#L26} + /// [google.cloud.cpp.compute.storage_pool_types.v1.ListStoragePoolTypesRequest]: @cloud_cpp_reference_link{google/cloud/compute/storage_pool_types/v1/storage_pool_types.proto#L203} + /// [google.cloud.cpp.compute.v1.StoragePoolType]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_157.proto#L26} /// // clang-format on StreamRange @@ -273,7 +276,8 @@ class StoragePoolTypesClient { // clang-format off /// - /// Retrieves a list of storage pool types available to the specified project. + /// Retrieves a list of storage pool types available to the specified + /// project. /// https://cloud.google.com/compute/docs/reference/rest/v1/storagePoolTypes/list /// /// @param request Unary RPCs, such as the one wrapped by this @@ -304,8 +308,8 @@ class StoragePoolTypesClient { /// [`future`]: @ref google::cloud::future /// [`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_131.proto#L26} + /// [google.cloud.cpp.compute.storage_pool_types.v1.ListStoragePoolTypesRequest]: @cloud_cpp_reference_link{google/cloud/compute/storage_pool_types/v1/storage_pool_types.proto#L203} + /// [google.cloud.cpp.compute.v1.StoragePoolType]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_157.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 b335bef741dec..b663182583699 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 "google/cloud/compute/v1/internal/common_023.pb.h" -#include "google/cloud/compute/v1/internal/common_131.pb.h" +#include "google/cloud/compute/v1/internal/common_032.pb.h" +#include "google/cloud/compute/v1/internal/common_157.pb.h" // 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 2644ef95d5eb9..1f0add2f13c37 100644 --- a/google/cloud/compute/storage_pools/v1/storage_pools_client.h +++ b/google/cloud/compute/storage_pools/v1/storage_pools_client.h @@ -90,8 +90,10 @@ class StoragePoolsClient { // clang-format off /// - /// Retrieves an aggregated list of storage pools. To prevent failure, Google - /// recommends that you set the `returnPartialSuccess` parameter to `true`. + /// Retrieves an aggregated list of storage pools. + /// + /// To prevent failure, Google recommends that you set the + /// `returnPartialSuccess` parameter to `true`. /// https://cloud.google.com/compute/docs/reference/rest/v1/storagePools/aggregatedList /// /// @param project Project ID for this request. @@ -117,8 +119,8 @@ class StoragePoolsClient { /// [`future`]: @ref google::cloud::future /// [`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_130.proto#L560} + /// [google.cloud.cpp.compute.storage_pools.v1.AggregatedListStoragePoolsRequest]: @cloud_cpp_reference_link{google/cloud/compute/storage_pools/v1/storage_pools.proto#L171} + /// [google.cloud.cpp.compute.v1.StoragePoolsScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_155.proto#L705} /// // clang-format on StreamRange> @@ -224,10 +229,11 @@ class StoragePoolsClient { // clang-format off /// - /// 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. + /// 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. /// https://cloud.google.com/compute/docs/reference/rest/v1/storagePools/delete /// /// @param request Unary RPCs, such as the one wrapped by this @@ -256,7 +262,7 @@ class StoragePoolsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.storage_pools.v1.DeleteStoragePoolRequest]: @cloud_cpp_reference_link{google/cloud/compute/storage_pools/v1/storage_pools.proto#L249} + /// [google.cloud.cpp.compute.storage_pools.v1.DeleteStoragePoolRequest]: @cloud_cpp_reference_link{google/cloud/compute/storage_pools/v1/storage_pools.proto#L286} /// // clang-format on future> @@ -296,8 +302,8 @@ class StoragePoolsClient { // clang-format off /// - /// Returns a specified storage pool. Gets a list of available storage pools by - /// making a list() request. + /// Returns a specified storage pool. Gets a list of available + /// storage pools by making a list() request. /// https://cloud.google.com/compute/docs/reference/rest/v1/storagePools/get /// /// @param project Project ID for this request. @@ -316,8 +322,8 @@ class StoragePoolsClient { /// [`future`]: @ref google::cloud::future /// [`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_130.proto#L25} + /// [google.cloud.cpp.compute.storage_pools.v1.GetStoragePoolRequest]: @cloud_cpp_reference_link{google/cloud/compute/storage_pools/v1/storage_pools.proto#L340} + /// [google.cloud.cpp.compute.v1.StoragePool]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_155.proto#L27} /// // clang-format on StatusOr GetStoragePool( @@ -326,8 +332,8 @@ class StoragePoolsClient { // clang-format off /// - /// Returns a specified storage pool. Gets a list of available storage pools by - /// making a list() request. + /// Returns a specified storage pool. Gets a list of available + /// storage pools by making a list() request. /// https://cloud.google.com/compute/docs/reference/rest/v1/storagePools/get /// /// @param request Unary RPCs, such as the one wrapped by this @@ -349,8 +355,8 @@ class StoragePoolsClient { /// [`future`]: @ref google::cloud::future /// [`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_130.proto#L25} + /// [google.cloud.cpp.compute.storage_pools.v1.GetStoragePoolRequest]: @cloud_cpp_reference_link{google/cloud/compute/storage_pools/v1/storage_pools.proto#L340} + /// [google.cloud.cpp.compute.v1.StoragePool]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_155.proto#L27} /// // clang-format on StatusOr GetStoragePool( @@ -380,8 +386,8 @@ class StoragePoolsClient { /// [`future`]: @ref google::cloud::future /// [`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_007.proto#L178} + /// [google.cloud.cpp.compute.storage_pools.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/storage_pools/v1/storage_pools.proto#L322} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr GetIamPolicy( @@ -413,8 +419,8 @@ class StoragePoolsClient { /// [`future`]: @ref google::cloud::future /// [`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_007.proto#L178} + /// [google.cloud.cpp.compute.storage_pools.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/storage_pools/v1/storage_pools.proto#L322} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr GetIamPolicy( @@ -424,8 +430,8 @@ class StoragePoolsClient { // clang-format off /// - /// Creates a storage pool in the specified project using the data in the - /// request. + /// Creates a storage pool in the specified project using the data + /// in the request. /// https://cloud.google.com/compute/docs/reference/rest/v1/storagePools/insert /// /// @param project Project ID for this request. @@ -451,7 +457,7 @@ class StoragePoolsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.storage_pools.v1.InsertStoragePoolRequest]: @cloud_cpp_reference_link{google/cloud/compute/storage_pools/v1/storage_pools.proto#L314} + /// [google.cloud.cpp.compute.storage_pools.v1.InsertStoragePoolRequest]: @cloud_cpp_reference_link{google/cloud/compute/storage_pools/v1/storage_pools.proto#L354} /// // clang-format on future> @@ -478,8 +484,8 @@ class StoragePoolsClient { // clang-format off /// - /// Creates a storage pool in the specified project using the data in the - /// request. + /// Creates a storage pool in the specified project using the data + /// in the request. /// https://cloud.google.com/compute/docs/reference/rest/v1/storagePools/insert /// /// @param request Unary RPCs, such as the one wrapped by this @@ -508,7 +514,7 @@ class StoragePoolsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.storage_pools.v1.InsertStoragePoolRequest]: @cloud_cpp_reference_link{google/cloud/compute/storage_pools/v1/storage_pools.proto#L314} + /// [google.cloud.cpp.compute.storage_pools.v1.InsertStoragePoolRequest]: @cloud_cpp_reference_link{google/cloud/compute/storage_pools/v1/storage_pools.proto#L354} /// // clang-format on future> @@ -548,7 +554,8 @@ class StoragePoolsClient { // clang-format off /// - /// Retrieves a list of storage pools contained within the specified zone. + /// Retrieves a list of storage pools contained within + /// the specified zone. /// https://cloud.google.com/compute/docs/reference/rest/v1/storagePools/list /// /// @param project Project ID for this request. @@ -575,8 +582,8 @@ class StoragePoolsClient { /// [`future`]: @ref google::cloud::future /// [`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_130.proto#L25} + /// [google.cloud.cpp.compute.storage_pools.v1.ListStoragePoolsRequest]: @cloud_cpp_reference_link{google/cloud/compute/storage_pools/v1/storage_pools.proto#L498} + /// [google.cloud.cpp.compute.v1.StoragePool]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_155.proto#L27} /// // clang-format on StreamRange ListStoragePools( @@ -584,7 +591,8 @@ class StoragePoolsClient { // clang-format off /// - /// Retrieves a list of storage pools contained within the specified zone. + /// Retrieves a list of storage pools contained within + /// the specified zone. /// https://cloud.google.com/compute/docs/reference/rest/v1/storagePools/list /// /// @param request Unary RPCs, such as the one wrapped by this @@ -615,8 +623,8 @@ class StoragePoolsClient { /// [`future`]: @ref google::cloud::future /// [`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_130.proto#L25} + /// [google.cloud.cpp.compute.storage_pools.v1.ListStoragePoolsRequest]: @cloud_cpp_reference_link{google/cloud/compute/storage_pools/v1/storage_pools.proto#L498} + /// [google.cloud.cpp.compute.v1.StoragePool]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_155.proto#L27} /// // clang-format on StreamRange ListStoragePools( @@ -654,8 +662,8 @@ class StoragePoolsClient { /// [`future`]: @ref google::cloud::future /// [`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_130.proto#L239} + /// [google.cloud.cpp.compute.storage_pools.v1.ListDisksRequest]: @cloud_cpp_reference_link{google/cloud/compute/storage_pools/v1/storage_pools.proto#L390} + /// [google.cloud.cpp.compute.v1.StoragePoolDisk]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_155.proto#L289} /// // clang-format on StreamRange ListDisks( @@ -695,8 +703,8 @@ class StoragePoolsClient { /// [`future`]: @ref google::cloud::future /// [`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_130.proto#L239} + /// [google.cloud.cpp.compute.storage_pools.v1.ListDisksRequest]: @cloud_cpp_reference_link{google/cloud/compute/storage_pools/v1/storage_pools.proto#L390} + /// [google.cloud.cpp.compute.v1.StoragePoolDisk]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_155.proto#L289} /// // clang-format on StreamRange ListDisks( @@ -705,8 +713,8 @@ class StoragePoolsClient { // clang-format off /// - /// Sets the access control policy on the specified resource. Replaces any - /// existing policy. + /// Sets the access control policy on the specified resource. + /// Replaces any existing policy. /// https://cloud.google.com/compute/docs/reference/rest/v1/storagePools/setIamPolicy /// /// @param project Project ID for this request. @@ -726,8 +734,8 @@ class StoragePoolsClient { /// [`future`]: @ref google::cloud::future /// [`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_007.proto#L178} + /// [google.cloud.cpp.compute.storage_pools.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/storage_pools/v1/storage_pools.proto#L602} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr SetIamPolicy( @@ -739,8 +747,8 @@ class StoragePoolsClient { // clang-format off /// - /// Sets the access control policy on the specified resource. Replaces any - /// existing policy. + /// Sets the access control policy on the specified resource. + /// Replaces any existing policy. /// https://cloud.google.com/compute/docs/reference/rest/v1/storagePools/setIamPolicy /// /// @param request Unary RPCs, such as the one wrapped by this @@ -762,8 +770,8 @@ class StoragePoolsClient { /// [`future`]: @ref google::cloud::future /// [`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_007.proto#L178} + /// [google.cloud.cpp.compute.storage_pools.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/storage_pools/v1/storage_pools.proto#L602} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr SetIamPolicy( @@ -793,8 +801,8 @@ class StoragePoolsClient { /// [`future`]: @ref google::cloud::future /// [`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_145.proto#L30} + /// [google.cloud.cpp.compute.storage_pools.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/storage_pools/v1/storage_pools.proto#L620} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} /// // clang-format on StatusOr @@ -829,8 +837,8 @@ class StoragePoolsClient { /// [`future`]: @ref google::cloud::future /// [`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_145.proto#L30} + /// [google.cloud.cpp.compute.storage_pools.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/storage_pools/v1/storage_pools.proto#L620} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} /// // clang-format on StatusOr @@ -841,8 +849,8 @@ class StoragePoolsClient { // clang-format off /// /// 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: + /// 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. /// https://cloud.google.com/compute/docs/reference/rest/v1/storagePools/update @@ -872,7 +880,7 @@ class StoragePoolsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.storage_pools.v1.UpdateStoragePoolRequest]: @cloud_cpp_reference_link{google/cloud/compute/storage_pools/v1/storage_pools.proto#L529} + /// [google.cloud.cpp.compute.storage_pools.v1.UpdateStoragePoolRequest]: @cloud_cpp_reference_link{google/cloud/compute/storage_pools/v1/storage_pools.proto#L638} /// // clang-format on future> @@ -902,8 +910,8 @@ class StoragePoolsClient { // clang-format off /// /// 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: + /// 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. /// https://cloud.google.com/compute/docs/reference/rest/v1/storagePools/update @@ -934,7 +942,7 @@ class StoragePoolsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.storage_pools.v1.UpdateStoragePoolRequest]: @cloud_cpp_reference_link{google/cloud/compute/storage_pools/v1/storage_pools.proto#L529} + /// [google.cloud.cpp.compute.storage_pools.v1.UpdateStoragePoolRequest]: @cloud_cpp_reference_link{google/cloud/compute/storage_pools/v1/storage_pools.proto#L638} /// // clang-format on future> 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 d71ea8cc40522..e85ca41ca8dc7 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,13 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_STORAGE_POOLS_V1_STORAGE_POOLS_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include "google/cloud/compute/v1/internal/common_007.pb.h" -#include "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_031.pb.h" -#include "google/cloud/compute/v1/internal/common_130.pb.h" -#include "google/cloud/compute/v1/internal/common_145.pb.h" -#include "google/cloud/compute/v1/internal/common_152.pb.h" +#include "google/cloud/compute/v1/internal/common_009.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_040.pb.h" +#include "google/cloud/compute/v1/internal/common_155.pb.h" +#include "google/cloud/compute/v1/internal/common_156.pb.h" +#include "google/cloud/compute/v1/internal/common_171.pb.h" +#include "google/cloud/compute/v1/internal/common_182.pb.h" // 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/internal/subnetworks_rest_stub.cc b/google/cloud/compute/subnetworks/v1/internal/subnetworks_rest_stub.cc index bfb4d1f74071e..782d2257bef9f 100644 --- a/google/cloud/compute/subnetworks/v1/internal/subnetworks_rest_stub.cc +++ b/google/cloud/compute/subnetworks/v1/internal/subnetworks_rest_stub.cc @@ -63,6 +63,7 @@ DefaultSubnetworksRestStub::AggregatedListSubnetworks( (request.return_partial_success() ? "1" : "0")}); query_params.push_back( {"service_project_number", request.service_project_number()}); + query_params.push_back({"views", request.views()}); query_params = rest_internal::TrimEmptyQueryParameters(std::move(query_params)); return rest_internal::Get< @@ -200,6 +201,9 @@ DefaultSubnetworksRestStub::GetSubnetwork( google::cloud::cpp::compute::subnetworks::v1::GetSubnetworkRequest const& request) { std::vector> query_params; + query_params.push_back({"views", request.views()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); return rest_internal::Get( *service_, rest_context, request, false, absl::StrCat("/", "compute", "/", @@ -302,6 +306,7 @@ DefaultSubnetworksRestStub::ListSubnetworks( query_params.push_back({"page_token", request.page_token()}); query_params.push_back({"return_partial_success", (request.return_partial_success() ? "1" : "0")}); + query_params.push_back({"views", request.views()}); query_params = rest_internal::TrimEmptyQueryParameters(std::move(query_params)); return rest_internal::Get( @@ -327,6 +332,7 @@ DefaultSubnetworksRestStub::ListUsable( query_params.push_back({"page_token", request.page_token()}); query_params.push_back({"return_partial_success", (request.return_partial_success() ? "1" : "0")}); + query_params.push_back({"service_project", request.service_project()}); query_params = rest_internal::TrimEmptyQueryParameters(std::move(query_params)); return rest_internal::Get< diff --git a/google/cloud/compute/subnetworks/v1/subnetworks_client.h b/google/cloud/compute/subnetworks/v1/subnetworks_client.h index 995f78163390a..c1e995bbeabf0 100644 --- a/google/cloud/compute/subnetworks/v1/subnetworks_client.h +++ b/google/cloud/compute/subnetworks/v1/subnetworks_client.h @@ -90,8 +90,10 @@ class SubnetworksClient { // clang-format off /// - /// Retrieves an aggregated list of subnetworks. To prevent failure, Google - /// recommends that you set the `returnPartialSuccess` parameter to `true`. + /// Retrieves an aggregated list of subnetworks. + /// + /// To prevent failure, Google recommends that you set the + /// `returnPartialSuccess` parameter to `true`. /// https://cloud.google.com/compute/docs/reference/rest/v1/subnetworks/aggregatedList /// /// @param project Project ID for this request. @@ -117,8 +119,8 @@ class SubnetworksClient { /// [`future`]: @ref google::cloud::future /// [`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_132.proto#L534} + /// [google.cloud.cpp.compute.subnetworks.v1.AggregatedListSubnetworksRequest]: @cloud_cpp_reference_link{google/cloud/compute/subnetworks/v1/subnetworks.proto#L193} + /// [google.cloud.cpp.compute.v1.SubnetworksScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_158.proto#L725} /// // clang-format on StreamRange> DeleteSubnetwork( @@ -250,7 +254,7 @@ class SubnetworksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.subnetworks.v1.DeleteSubnetworkRequest]: @cloud_cpp_reference_link{google/cloud/compute/subnetworks/v1/subnetworks.proto#L271} + /// [google.cloud.cpp.compute.subnetworks.v1.DeleteSubnetworkRequest]: @cloud_cpp_reference_link{google/cloud/compute/subnetworks/v1/subnetworks.proto#L317} /// // clang-format on future> DeleteSubnetwork( @@ -317,7 +321,7 @@ class SubnetworksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.subnetworks.v1.ExpandIpCidrRangeRequest]: @cloud_cpp_reference_link{google/cloud/compute/subnetworks/v1/subnetworks.proto#L304} + /// [google.cloud.cpp.compute.subnetworks.v1.ExpandIpCidrRangeRequest]: @cloud_cpp_reference_link{google/cloud/compute/subnetworks/v1/subnetworks.proto#L353} /// // clang-format on future> @@ -378,7 +382,7 @@ class SubnetworksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.subnetworks.v1.ExpandIpCidrRangeRequest]: @cloud_cpp_reference_link{google/cloud/compute/subnetworks/v1/subnetworks.proto#L304} + /// [google.cloud.cpp.compute.subnetworks.v1.ExpandIpCidrRangeRequest]: @cloud_cpp_reference_link{google/cloud/compute/subnetworks/v1/subnetworks.proto#L353} /// // clang-format on future> @@ -437,8 +441,8 @@ class SubnetworksClient { /// [`future`]: @ref google::cloud::future /// [`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_132.proto#L28} + /// [google.cloud.cpp.compute.subnetworks.v1.GetSubnetworkRequest]: @cloud_cpp_reference_link{google/cloud/compute/subnetworks/v1/subnetworks.proto#L413} + /// [google.cloud.cpp.compute.v1.Subnetwork]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_158.proto#L32} /// // clang-format on StatusOr GetSubnetwork( @@ -469,8 +473,8 @@ class SubnetworksClient { /// [`future`]: @ref google::cloud::future /// [`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_132.proto#L28} + /// [google.cloud.cpp.compute.subnetworks.v1.GetSubnetworkRequest]: @cloud_cpp_reference_link{google/cloud/compute/subnetworks/v1/subnetworks.proto#L413} + /// [google.cloud.cpp.compute.v1.Subnetwork]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_158.proto#L32} /// // clang-format on StatusOr GetSubnetwork( @@ -500,8 +504,8 @@ class SubnetworksClient { /// [`future`]: @ref google::cloud::future /// [`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_007.proto#L178} + /// [google.cloud.cpp.compute.subnetworks.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/subnetworks/v1/subnetworks.proto#L394} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr GetIamPolicy( @@ -533,8 +537,8 @@ class SubnetworksClient { /// [`future`]: @ref google::cloud::future /// [`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_007.proto#L178} + /// [google.cloud.cpp.compute.subnetworks.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/subnetworks/v1/subnetworks.proto#L394} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr GetIamPolicy( @@ -544,8 +548,8 @@ class SubnetworksClient { // clang-format off /// - /// Creates a subnetwork in the specified project using the data included in - /// the request. + /// Creates a subnetwork in the specified project using the data + /// included in the request. /// https://cloud.google.com/compute/docs/reference/rest/v1/subnetworks/insert /// /// @param project Project ID for this request. @@ -571,7 +575,7 @@ class SubnetworksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.subnetworks.v1.InsertSubnetworkRequest]: @cloud_cpp_reference_link{google/cloud/compute/subnetworks/v1/subnetworks.proto#L376} + /// [google.cloud.cpp.compute.subnetworks.v1.InsertSubnetworkRequest]: @cloud_cpp_reference_link{google/cloud/compute/subnetworks/v1/subnetworks.proto#L437} /// // clang-format on future> InsertSubnetwork( @@ -597,8 +601,8 @@ class SubnetworksClient { // clang-format off /// - /// Creates a subnetwork in the specified project using the data included in - /// the request. + /// Creates a subnetwork in the specified project using the data + /// included in the request. /// https://cloud.google.com/compute/docs/reference/rest/v1/subnetworks/insert /// /// @param request Unary RPCs, such as the one wrapped by this @@ -627,7 +631,7 @@ class SubnetworksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.subnetworks.v1.InsertSubnetworkRequest]: @cloud_cpp_reference_link{google/cloud/compute/subnetworks/v1/subnetworks.proto#L376} + /// [google.cloud.cpp.compute.subnetworks.v1.InsertSubnetworkRequest]: @cloud_cpp_reference_link{google/cloud/compute/subnetworks/v1/subnetworks.proto#L437} /// // clang-format on future> InsertSubnetwork( @@ -667,7 +671,8 @@ class SubnetworksClient { // clang-format off /// - /// Retrieves a list of subnetworks available to the specified project. + /// Retrieves a list of subnetworks available to the specified + /// project. /// https://cloud.google.com/compute/docs/reference/rest/v1/subnetworks/list /// /// @param project Project ID for this request. @@ -694,8 +699,8 @@ class SubnetworksClient { /// [`future`]: @ref google::cloud::future /// [`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_132.proto#L28} + /// [google.cloud.cpp.compute.subnetworks.v1.ListSubnetworksRequest]: @cloud_cpp_reference_link{google/cloud/compute/subnetworks/v1/subnetworks.proto#L473} + /// [google.cloud.cpp.compute.v1.Subnetwork]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_158.proto#L32} /// // clang-format on StreamRange ListSubnetworks( @@ -703,7 +708,8 @@ class SubnetworksClient { // clang-format off /// - /// Retrieves a list of subnetworks available to the specified project. + /// Retrieves a list of subnetworks available to the specified + /// project. /// https://cloud.google.com/compute/docs/reference/rest/v1/subnetworks/list /// /// @param request Unary RPCs, such as the one wrapped by this @@ -734,8 +740,8 @@ class SubnetworksClient { /// [`future`]: @ref google::cloud::future /// [`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_132.proto#L28} + /// [google.cloud.cpp.compute.subnetworks.v1.ListSubnetworksRequest]: @cloud_cpp_reference_link{google/cloud/compute/subnetworks/v1/subnetworks.proto#L473} + /// [google.cloud.cpp.compute.v1.Subnetwork]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_158.proto#L32} /// // clang-format on StreamRange ListSubnetworks( @@ -771,8 +777,8 @@ class SubnetworksClient { /// [`future`]: @ref google::cloud::future /// [`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_132.proto#L722} + /// [google.cloud.cpp.compute.subnetworks.v1.ListUsableRequest]: @cloud_cpp_reference_link{google/cloud/compute/subnetworks/v1/subnetworks.proto#L587} + /// [google.cloud.cpp.compute.v1.UsableSubnetwork]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_158.proto#L954} /// // clang-format on StreamRange ListUsable( @@ -811,8 +817,8 @@ class SubnetworksClient { /// [`future`]: @ref google::cloud::future /// [`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_132.proto#L722} + /// [google.cloud.cpp.compute.subnetworks.v1.ListUsableRequest]: @cloud_cpp_reference_link{google/cloud/compute/subnetworks/v1/subnetworks.proto#L587} + /// [google.cloud.cpp.compute.v1.UsableSubnetwork]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_158.proto#L954} /// // clang-format on StreamRange ListUsable( @@ -822,8 +828,9 @@ class SubnetworksClient { // clang-format off /// /// 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 + /// 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. /// https://cloud.google.com/compute/docs/reference/rest/v1/subnetworks/patch /// @@ -851,7 +858,7 @@ class SubnetworksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.subnetworks.v1.PatchSubnetworkRequest]: @cloud_cpp_reference_link{google/cloud/compute/subnetworks/v1/subnetworks.proto#L549} + /// [google.cloud.cpp.compute.subnetworks.v1.PatchSubnetworkRequest]: @cloud_cpp_reference_link{google/cloud/compute/subnetworks/v1/subnetworks.proto#L693} /// // clang-format on future> PatchSubnetwork( @@ -880,8 +887,9 @@ class SubnetworksClient { // clang-format off /// /// 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 + /// 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. /// https://cloud.google.com/compute/docs/reference/rest/v1/subnetworks/patch /// @@ -911,7 +919,7 @@ class SubnetworksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.subnetworks.v1.PatchSubnetworkRequest]: @cloud_cpp_reference_link{google/cloud/compute/subnetworks/v1/subnetworks.proto#L549} + /// [google.cloud.cpp.compute.subnetworks.v1.PatchSubnetworkRequest]: @cloud_cpp_reference_link{google/cloud/compute/subnetworks/v1/subnetworks.proto#L693} /// // clang-format on future> PatchSubnetwork( @@ -951,8 +959,8 @@ class SubnetworksClient { // clang-format off /// - /// Sets the access control policy on the specified resource. Replaces any - /// existing policy. + /// Sets the access control policy on the specified resource. + /// Replaces any existing policy. /// https://cloud.google.com/compute/docs/reference/rest/v1/subnetworks/setIamPolicy /// /// @param project Project ID for this request. @@ -972,8 +980,8 @@ class SubnetworksClient { /// [`future`]: @ref google::cloud::future /// [`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_007.proto#L178} + /// [google.cloud.cpp.compute.subnetworks.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/subnetworks/v1/subnetworks.proto#L744} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr SetIamPolicy( @@ -985,8 +993,8 @@ class SubnetworksClient { // clang-format off /// - /// Sets the access control policy on the specified resource. Replaces any - /// existing policy. + /// Sets the access control policy on the specified resource. + /// Replaces any existing policy. /// https://cloud.google.com/compute/docs/reference/rest/v1/subnetworks/setIamPolicy /// /// @param request Unary RPCs, such as the one wrapped by this @@ -1008,8 +1016,8 @@ class SubnetworksClient { /// [`future`]: @ref google::cloud::future /// [`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_007.proto#L178} + /// [google.cloud.cpp.compute.subnetworks.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/subnetworks/v1/subnetworks.proto#L744} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L317} /// // clang-format on StatusOr SetIamPolicy( @@ -1047,7 +1055,7 @@ class SubnetworksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.subnetworks.v1.SetPrivateIpGoogleAccessRequest]: @cloud_cpp_reference_link{google/cloud/compute/subnetworks/v1/subnetworks.proto#L616} + /// [google.cloud.cpp.compute.subnetworks.v1.SetPrivateIpGoogleAccessRequest]: @cloud_cpp_reference_link{google/cloud/compute/subnetworks/v1/subnetworks.proto#L764} /// // clang-format on future> @@ -1110,7 +1118,7 @@ class SubnetworksClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.subnetworks.v1.SetPrivateIpGoogleAccessRequest]: @cloud_cpp_reference_link{google/cloud/compute/subnetworks/v1/subnetworks.proto#L616} + /// [google.cloud.cpp.compute.subnetworks.v1.SetPrivateIpGoogleAccessRequest]: @cloud_cpp_reference_link{google/cloud/compute/subnetworks/v1/subnetworks.proto#L764} /// // clang-format on future> @@ -1171,8 +1179,8 @@ class SubnetworksClient { /// [`future`]: @ref google::cloud::future /// [`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_145.proto#L30} + /// [google.cloud.cpp.compute.subnetworks.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/subnetworks/v1/subnetworks.proto#L806} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} /// // clang-format on StatusOr @@ -1207,8 +1215,8 @@ class SubnetworksClient { /// [`future`]: @ref google::cloud::future /// [`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_145.proto#L30} + /// [google.cloud.cpp.compute.subnetworks.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/subnetworks/v1/subnetworks.proto#L806} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.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 34e22f287766b..6f191263cccc5 100644 --- a/google/cloud/compute/subnetworks/v1/subnetworks_proto_export.h +++ b/google/cloud/compute/subnetworks/v1/subnetworks_proto_export.h @@ -26,12 +26,13 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_SUBNETWORKS_V1_SUBNETWORKS_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include "google/cloud/compute/v1/internal/common_007.pb.h" -#include "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_031.pb.h" -#include "google/cloud/compute/v1/internal/common_108.pb.h" -#include "google/cloud/compute/v1/internal/common_132.pb.h" -#include "google/cloud/compute/v1/internal/common_145.pb.h" +#include "google/cloud/compute/v1/internal/common_009.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_040.pb.h" +#include "google/cloud/compute/v1/internal/common_126.pb.h" +#include "google/cloud/compute/v1/internal/common_158.pb.h" +#include "google/cloud/compute/v1/internal/common_171.pb.h" +#include "google/cloud/compute/v1/internal/common_172.pb.h" // 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 9c33e1d9dda7c..71ed401641278 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 @@ -115,7 +115,7 @@ class TargetGrpcProxiesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_grpc_proxies.v1.DeleteTargetGrpcProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_grpc_proxies/v1/target_grpc_proxies.proto#L101} + /// [google.cloud.cpp.compute.target_grpc_proxies.v1.DeleteTargetGrpcProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_grpc_proxies/v1/target_grpc_proxies.proto#L102} /// // clang-format on future> @@ -169,7 +169,7 @@ class TargetGrpcProxiesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_grpc_proxies.v1.DeleteTargetGrpcProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_grpc_proxies/v1/target_grpc_proxies.proto#L101} + /// [google.cloud.cpp.compute.target_grpc_proxies.v1.DeleteTargetGrpcProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_grpc_proxies/v1/target_grpc_proxies.proto#L102} /// // clang-format on future> @@ -228,8 +228,8 @@ class TargetGrpcProxiesClient { /// [`future`]: @ref google::cloud::future /// [`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_133.proto#L29} + /// [google.cloud.cpp.compute.target_grpc_proxies.v1.GetTargetGrpcProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_grpc_proxies/v1/target_grpc_proxies.proto#L131} + /// [google.cloud.cpp.compute.v1.TargetGrpcProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_159.proto#L31} /// // clang-format on StatusOr GetTargetGrpcProxy( @@ -260,8 +260,8 @@ class TargetGrpcProxiesClient { /// [`future`]: @ref google::cloud::future /// [`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_133.proto#L29} + /// [google.cloud.cpp.compute.target_grpc_proxies.v1.GetTargetGrpcProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_grpc_proxies/v1/target_grpc_proxies.proto#L131} + /// [google.cloud.cpp.compute.v1.TargetGrpcProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_159.proto#L31} /// // clang-format on StatusOr GetTargetGrpcProxy( @@ -271,8 +271,8 @@ class TargetGrpcProxiesClient { // clang-format off /// - /// Creates a TargetGrpcProxy in the specified project in the given scope using - /// the parameters that are included in the request. + /// Creates a TargetGrpcProxy in the specified project in the given scope + /// using the parameters that are included in the request. /// https://cloud.google.com/compute/docs/reference/rest/v1/targetGrpcProxies/insert /// /// @param project Project ID for this request. @@ -297,7 +297,7 @@ class TargetGrpcProxiesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_grpc_proxies.v1.InsertTargetGrpcProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_grpc_proxies/v1/target_grpc_proxies.proto#L138} + /// [google.cloud.cpp.compute.target_grpc_proxies.v1.InsertTargetGrpcProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_grpc_proxies/v1/target_grpc_proxies.proto#L142} /// // clang-format on future> @@ -325,8 +325,8 @@ class TargetGrpcProxiesClient { // clang-format off /// - /// Creates a TargetGrpcProxy in the specified project in the given scope using - /// the parameters that are included in the request. + /// Creates a TargetGrpcProxy in the specified project in the given scope + /// using the parameters that are included in the request. /// https://cloud.google.com/compute/docs/reference/rest/v1/targetGrpcProxies/insert /// /// @param request Unary RPCs, such as the one wrapped by this @@ -355,7 +355,7 @@ class TargetGrpcProxiesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_grpc_proxies.v1.InsertTargetGrpcProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_grpc_proxies/v1/target_grpc_proxies.proto#L138} + /// [google.cloud.cpp.compute.target_grpc_proxies.v1.InsertTargetGrpcProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_grpc_proxies/v1/target_grpc_proxies.proto#L142} /// // clang-format on future> @@ -422,8 +422,8 @@ class TargetGrpcProxiesClient { /// [`future`]: @ref google::cloud::future /// [`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_133.proto#L29} + /// [google.cloud.cpp.compute.target_grpc_proxies.v1.ListTargetGrpcProxiesRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_grpc_proxies/v1/target_grpc_proxies.proto#L171} + /// [google.cloud.cpp.compute.v1.TargetGrpcProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_159.proto#L31} /// // clang-format on StreamRange @@ -462,8 +462,8 @@ class TargetGrpcProxiesClient { /// [`future`]: @ref google::cloud::future /// [`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_133.proto#L29} + /// [google.cloud.cpp.compute.target_grpc_proxies.v1.ListTargetGrpcProxiesRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_grpc_proxies/v1/target_grpc_proxies.proto#L171} + /// [google.cloud.cpp.compute.v1.TargetGrpcProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_159.proto#L31} /// // clang-format on StreamRange @@ -474,8 +474,9 @@ class TargetGrpcProxiesClient { // clang-format off /// /// 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. + /// the request. This method supports PATCH + /// semantics and usesJSON merge + /// patch format and processing rules. /// https://cloud.google.com/compute/docs/reference/rest/v1/targetGrpcProxies/patch /// /// @param project Project ID for this request. @@ -501,7 +502,7 @@ class TargetGrpcProxiesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_grpc_proxies.v1.PatchTargetGrpcProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_grpc_proxies/v1/target_grpc_proxies.proto#L232} + /// [google.cloud.cpp.compute.target_grpc_proxies.v1.PatchTargetGrpcProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_grpc_proxies/v1/target_grpc_proxies.proto#L272} /// // clang-format on future> @@ -532,8 +533,9 @@ class TargetGrpcProxiesClient { // clang-format off /// /// 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. + /// the request. This method supports PATCH + /// semantics and usesJSON merge + /// patch format and processing rules. /// https://cloud.google.com/compute/docs/reference/rest/v1/targetGrpcProxies/patch /// /// @param request Unary RPCs, such as the one wrapped by this @@ -562,7 +564,7 @@ class TargetGrpcProxiesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_grpc_proxies.v1.PatchTargetGrpcProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_grpc_proxies/v1/target_grpc_proxies.proto#L232} + /// [google.cloud.cpp.compute.target_grpc_proxies.v1.PatchTargetGrpcProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_grpc_proxies/v1/target_grpc_proxies.proto#L272} /// // clang-format on future> 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 d59c48640a678..34696ff6ffa62 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 "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_133.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_159.pb.h" // 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 725d1b2a03ee4..b99209de63360 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 @@ -92,8 +92,10 @@ class TargetHttpProxiesClient { // clang-format off /// /// 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`. + /// available to the specified project. + /// + /// To prevent failure, Google recommends that you set the + /// `returnPartialSuccess` parameter to `true`. /// https://cloud.google.com/compute/docs/reference/rest/v1/targetHttpProxies/aggregatedList /// /// @param project Name of the project scoping this request. @@ -119,8 +121,8 @@ class TargetHttpProxiesClient { /// [`future`]: @ref google::cloud::future /// [`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_134.proto#L26} + /// [google.cloud.cpp.compute.target_http_proxies.v1.AggregatedListTargetHttpProxiesRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_http_proxies/v1/target_http_proxies.proto#L132} + /// [google.cloud.cpp.compute.v1.TargetHttpProxiesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_160.proto#L26} /// // clang-format on StreamRange< @@ -132,8 +134,10 @@ class TargetHttpProxiesClient { // clang-format off /// /// 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`. + /// available to the specified project. + /// + /// To prevent failure, Google recommends that you set the + /// `returnPartialSuccess` parameter to `true`. /// https://cloud.google.com/compute/docs/reference/rest/v1/targetHttpProxies/aggregatedList /// /// @param request Unary RPCs, such as the one wrapped by this @@ -164,8 +168,8 @@ class TargetHttpProxiesClient { /// [`future`]: @ref google::cloud::future /// [`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_134.proto#L26} + /// [google.cloud.cpp.compute.target_http_proxies.v1.AggregatedListTargetHttpProxiesRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_http_proxies/v1/target_http_proxies.proto#L132} + /// [google.cloud.cpp.compute.v1.TargetHttpProxiesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_160.proto#L26} /// // clang-format on StreamRange< @@ -203,7 +207,7 @@ class TargetHttpProxiesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_http_proxies.v1.DeleteTargetHttpProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_http_proxies/v1/target_http_proxies.proto#L211} + /// [google.cloud.cpp.compute.target_http_proxies.v1.DeleteTargetHttpProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_http_proxies/v1/target_http_proxies.proto#L247} /// // clang-format on future> @@ -257,7 +261,7 @@ class TargetHttpProxiesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_http_proxies.v1.DeleteTargetHttpProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_http_proxies/v1/target_http_proxies.proto#L211} + /// [google.cloud.cpp.compute.target_http_proxies.v1.DeleteTargetHttpProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_http_proxies/v1/target_http_proxies.proto#L247} /// // clang-format on future> @@ -316,8 +320,8 @@ class TargetHttpProxiesClient { /// [`future`]: @ref google::cloud::future /// [`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_135.proto#L36} + /// [google.cloud.cpp.compute.target_http_proxies.v1.GetTargetHttpProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_http_proxies/v1/target_http_proxies.proto#L276} + /// [google.cloud.cpp.compute.v1.TargetHttpProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_161.proto#L45} /// // clang-format on StatusOr GetTargetHttpProxy( @@ -348,8 +352,8 @@ class TargetHttpProxiesClient { /// [`future`]: @ref google::cloud::future /// [`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_135.proto#L36} + /// [google.cloud.cpp.compute.target_http_proxies.v1.GetTargetHttpProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_http_proxies/v1/target_http_proxies.proto#L276} + /// [google.cloud.cpp.compute.v1.TargetHttpProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_161.proto#L45} /// // clang-format on StatusOr GetTargetHttpProxy( @@ -359,8 +363,8 @@ class TargetHttpProxiesClient { // clang-format off /// - /// Creates a TargetHttpProxy resource in the specified project using the data - /// included in the request. + /// Creates a TargetHttpProxy resource in the specified + /// project using the data included in the request. /// https://cloud.google.com/compute/docs/reference/rest/v1/targetHttpProxies/insert /// /// @param project Project ID for this request. @@ -385,7 +389,7 @@ class TargetHttpProxiesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_http_proxies.v1.InsertTargetHttpProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_http_proxies/v1/target_http_proxies.proto#L248} + /// [google.cloud.cpp.compute.target_http_proxies.v1.InsertTargetHttpProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_http_proxies/v1/target_http_proxies.proto#L287} /// // clang-format on future> @@ -413,8 +417,8 @@ class TargetHttpProxiesClient { // clang-format off /// - /// Creates a TargetHttpProxy resource in the specified project using the data - /// included in the request. + /// Creates a TargetHttpProxy resource in the specified + /// project using the data included in the request. /// https://cloud.google.com/compute/docs/reference/rest/v1/targetHttpProxies/insert /// /// @param request Unary RPCs, such as the one wrapped by this @@ -443,7 +447,7 @@ class TargetHttpProxiesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_http_proxies.v1.InsertTargetHttpProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_http_proxies/v1/target_http_proxies.proto#L248} + /// [google.cloud.cpp.compute.target_http_proxies.v1.InsertTargetHttpProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_http_proxies/v1/target_http_proxies.proto#L287} /// // clang-format on future> @@ -484,8 +488,8 @@ class TargetHttpProxiesClient { // clang-format off /// - /// Retrieves the list of TargetHttpProxy resources available to the specified - /// project. + /// Retrieves the list of TargetHttpProxy resources available + /// to the specified project. /// https://cloud.google.com/compute/docs/reference/rest/v1/targetHttpProxies/list /// /// @param project Project ID for this request. @@ -511,8 +515,8 @@ class TargetHttpProxiesClient { /// [`future`]: @ref google::cloud::future /// [`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_135.proto#L36} + /// [google.cloud.cpp.compute.target_http_proxies.v1.ListTargetHttpProxiesRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_http_proxies/v1/target_http_proxies.proto#L316} + /// [google.cloud.cpp.compute.v1.TargetHttpProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_161.proto#L45} /// // clang-format on StreamRange @@ -520,8 +524,8 @@ class TargetHttpProxiesClient { // clang-format off /// - /// Retrieves the list of TargetHttpProxy resources available to the specified - /// project. + /// Retrieves the list of TargetHttpProxy resources available + /// to the specified project. /// https://cloud.google.com/compute/docs/reference/rest/v1/targetHttpProxies/list /// /// @param request Unary RPCs, such as the one wrapped by this @@ -552,8 +556,8 @@ class TargetHttpProxiesClient { /// [`future`]: @ref google::cloud::future /// [`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_135.proto#L36} + /// [google.cloud.cpp.compute.target_http_proxies.v1.ListTargetHttpProxiesRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_http_proxies/v1/target_http_proxies.proto#L316} + /// [google.cloud.cpp.compute.v1.TargetHttpProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_161.proto#L45} /// // clang-format on StreamRange @@ -564,8 +568,9 @@ class TargetHttpProxiesClient { // clang-format off /// /// 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. + /// the request. This method supports PATCH + /// semantics and usesJSON merge + /// patch format and processing rules. /// https://cloud.google.com/compute/docs/reference/rest/v1/targetHttpProxies/patch /// /// @param project Project ID for this request. @@ -591,7 +596,7 @@ class TargetHttpProxiesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_http_proxies.v1.PatchTargetHttpProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_http_proxies/v1/target_http_proxies.proto#L342} + /// [google.cloud.cpp.compute.target_http_proxies.v1.PatchTargetHttpProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_http_proxies/v1/target_http_proxies.proto#L417} /// // clang-format on future> @@ -622,8 +627,9 @@ class TargetHttpProxiesClient { // clang-format off /// /// 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. + /// the request. This method supports PATCH + /// semantics and usesJSON merge + /// patch format and processing rules. /// https://cloud.google.com/compute/docs/reference/rest/v1/targetHttpProxies/patch /// /// @param request Unary RPCs, such as the one wrapped by this @@ -652,7 +658,7 @@ class TargetHttpProxiesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_http_proxies.v1.PatchTargetHttpProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_http_proxies/v1/target_http_proxies.proto#L342} + /// [google.cloud.cpp.compute.target_http_proxies.v1.PatchTargetHttpProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_http_proxies/v1/target_http_proxies.proto#L417} /// // clang-format on future> @@ -719,7 +725,7 @@ class TargetHttpProxiesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_http_proxies.v1.SetUrlMapRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_http_proxies/v1/target_http_proxies.proto#L372} + /// [google.cloud.cpp.compute.target_http_proxies.v1.SetUrlMapRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_http_proxies/v1/target_http_proxies.proto#L450} /// // clang-format on future> SetUrlMap( @@ -777,7 +783,7 @@ class TargetHttpProxiesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_http_proxies.v1.SetUrlMapRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_http_proxies/v1/target_http_proxies.proto#L372} + /// [google.cloud.cpp.compute.target_http_proxies.v1.SetUrlMapRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_http_proxies/v1/target_http_proxies.proto#L450} /// // clang-format on future> SetUrlMap( 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 98f1de712447b..59decdfb77bc5 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 "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_134.pb.h" -#include "google/cloud/compute/v1/internal/common_135.pb.h" -#include "google/cloud/compute/v1/internal/common_147.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_160.pb.h" +#include "google/cloud/compute/v1/internal/common_161.pb.h" +#include "google/cloud/compute/v1/internal/common_174.pb.h" // 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 4b343fe3d01fa..cab5772f0a5d8 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 @@ -94,8 +94,10 @@ class TargetHttpsProxiesClient { // clang-format off /// /// 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`. + /// available to the specified project. + /// + /// To prevent failure, Google recommends that you set the + /// `returnPartialSuccess` parameter to `true`. /// https://cloud.google.com/compute/docs/reference/rest/v1/targetHttpsProxies/aggregatedList /// /// @param project Name of the project scoping this request. @@ -121,8 +123,8 @@ class TargetHttpsProxiesClient { /// [`future`]: @ref google::cloud::future /// [`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_136.proto#L26} + /// [google.cloud.cpp.compute.target_https_proxies.v1.AggregatedListTargetHttpsProxiesRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_https_proxies/v1/target_https_proxies.proto#L189} + /// [google.cloud.cpp.compute.v1.TargetHttpsProxiesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_162.proto#L26} /// // clang-format on StreamRange< @@ -134,8 +136,10 @@ class TargetHttpsProxiesClient { // clang-format off /// /// 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`. + /// available to the specified project. + /// + /// To prevent failure, Google recommends that you set the + /// `returnPartialSuccess` parameter to `true`. /// https://cloud.google.com/compute/docs/reference/rest/v1/targetHttpsProxies/aggregatedList /// /// @param request Unary RPCs, such as the one wrapped by this @@ -166,8 +170,8 @@ class TargetHttpsProxiesClient { /// [`future`]: @ref google::cloud::future /// [`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_136.proto#L26} + /// [google.cloud.cpp.compute.target_https_proxies.v1.AggregatedListTargetHttpsProxiesRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_https_proxies/v1/target_https_proxies.proto#L189} + /// [google.cloud.cpp.compute.v1.TargetHttpsProxiesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_162.proto#L26} /// // clang-format on StreamRange< @@ -205,7 +209,7 @@ class TargetHttpsProxiesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_https_proxies.v1.DeleteTargetHttpsProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_https_proxies/v1/target_https_proxies.proto#L268} + /// [google.cloud.cpp.compute.target_https_proxies.v1.DeleteTargetHttpsProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_https_proxies/v1/target_https_proxies.proto#L304} /// // clang-format on future> @@ -259,7 +263,7 @@ class TargetHttpsProxiesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_https_proxies.v1.DeleteTargetHttpsProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_https_proxies/v1/target_https_proxies.proto#L268} + /// [google.cloud.cpp.compute.target_https_proxies.v1.DeleteTargetHttpsProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_https_proxies/v1/target_https_proxies.proto#L304} /// // clang-format on future> @@ -318,8 +322,8 @@ class TargetHttpsProxiesClient { /// [`future`]: @ref google::cloud::future /// [`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_137.proto#L36} + /// [google.cloud.cpp.compute.target_https_proxies.v1.GetTargetHttpsProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_https_proxies/v1/target_https_proxies.proto#L333} + /// [google.cloud.cpp.compute.v1.TargetHttpsProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_163.proto#L45} /// // clang-format on StatusOr @@ -350,8 +354,8 @@ class TargetHttpsProxiesClient { /// [`future`]: @ref google::cloud::future /// [`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_137.proto#L36} + /// [google.cloud.cpp.compute.target_https_proxies.v1.GetTargetHttpsProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_https_proxies/v1/target_https_proxies.proto#L333} + /// [google.cloud.cpp.compute.v1.TargetHttpsProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_163.proto#L45} /// // clang-format on StatusOr @@ -361,8 +365,8 @@ class TargetHttpsProxiesClient { // clang-format off /// - /// Creates a TargetHttpsProxy resource in the specified project using the data - /// included in the request. + /// Creates a TargetHttpsProxy resource in the specified + /// project using the data included in the request. /// https://cloud.google.com/compute/docs/reference/rest/v1/targetHttpsProxies/insert /// /// @param project Project ID for this request. @@ -387,7 +391,7 @@ class TargetHttpsProxiesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_https_proxies.v1.InsertTargetHttpsProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_https_proxies/v1/target_https_proxies.proto#L305} + /// [google.cloud.cpp.compute.target_https_proxies.v1.InsertTargetHttpsProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_https_proxies/v1/target_https_proxies.proto#L344} /// // clang-format on future> @@ -416,8 +420,8 @@ class TargetHttpsProxiesClient { // clang-format off /// - /// Creates a TargetHttpsProxy resource in the specified project using the data - /// included in the request. + /// Creates a TargetHttpsProxy resource in the specified + /// project using the data included in the request. /// https://cloud.google.com/compute/docs/reference/rest/v1/targetHttpsProxies/insert /// /// @param request Unary RPCs, such as the one wrapped by this @@ -446,7 +450,7 @@ class TargetHttpsProxiesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_https_proxies.v1.InsertTargetHttpsProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_https_proxies/v1/target_https_proxies.proto#L305} + /// [google.cloud.cpp.compute.target_https_proxies.v1.InsertTargetHttpsProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_https_proxies/v1/target_https_proxies.proto#L344} /// // clang-format on future> @@ -487,8 +491,8 @@ class TargetHttpsProxiesClient { // clang-format off /// - /// Retrieves the list of TargetHttpsProxy resources available to the specified - /// project. + /// Retrieves the list of TargetHttpsProxy resources + /// available to the specified project. /// https://cloud.google.com/compute/docs/reference/rest/v1/targetHttpsProxies/list /// /// @param project Project ID for this request. @@ -514,8 +518,8 @@ class TargetHttpsProxiesClient { /// [`future`]: @ref google::cloud::future /// [`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_137.proto#L36} + /// [google.cloud.cpp.compute.target_https_proxies.v1.ListTargetHttpsProxiesRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_https_proxies/v1/target_https_proxies.proto#L373} + /// [google.cloud.cpp.compute.v1.TargetHttpsProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_163.proto#L45} /// // clang-format on StreamRange @@ -523,8 +527,8 @@ class TargetHttpsProxiesClient { // clang-format off /// - /// Retrieves the list of TargetHttpsProxy resources available to the specified - /// project. + /// Retrieves the list of TargetHttpsProxy resources + /// available to the specified project. /// https://cloud.google.com/compute/docs/reference/rest/v1/targetHttpsProxies/list /// /// @param request Unary RPCs, such as the one wrapped by this @@ -555,8 +559,8 @@ class TargetHttpsProxiesClient { /// [`future`]: @ref google::cloud::future /// [`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_137.proto#L36} + /// [google.cloud.cpp.compute.target_https_proxies.v1.ListTargetHttpsProxiesRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_https_proxies/v1/target_https_proxies.proto#L373} + /// [google.cloud.cpp.compute.v1.TargetHttpsProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_163.proto#L45} /// // clang-format on StreamRange @@ -567,8 +571,9 @@ class TargetHttpsProxiesClient { // clang-format off /// /// 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. + /// the request. This method supports PATCH + /// semantics and usesJSON merge + /// patch format and processing rules. /// https://cloud.google.com/compute/docs/reference/rest/v1/targetHttpsProxies/patch /// /// @param project Project ID for this request. @@ -594,7 +599,7 @@ class TargetHttpsProxiesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_https_proxies.v1.PatchTargetHttpsProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_https_proxies/v1/target_https_proxies.proto#L399} + /// [google.cloud.cpp.compute.target_https_proxies.v1.PatchTargetHttpsProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_https_proxies/v1/target_https_proxies.proto#L474} /// // clang-format on future> @@ -625,8 +630,9 @@ class TargetHttpsProxiesClient { // clang-format off /// /// 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. + /// the request. This method supports PATCH + /// semantics and usesJSON merge + /// patch format and processing rules. /// https://cloud.google.com/compute/docs/reference/rest/v1/targetHttpsProxies/patch /// /// @param request Unary RPCs, such as the one wrapped by this @@ -655,7 +661,7 @@ class TargetHttpsProxiesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_https_proxies.v1.PatchTargetHttpsProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_https_proxies/v1/target_https_proxies.proto#L399} + /// [google.cloud.cpp.compute.target_https_proxies.v1.PatchTargetHttpsProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_https_proxies/v1/target_https_proxies.proto#L474} /// // clang-format on future> @@ -700,8 +706,8 @@ class TargetHttpsProxiesClient { /// https://cloud.google.com/compute/docs/reference/rest/v1/targetHttpsProxies/setCertificateMap /// /// @param project Project ID for this request. - /// @param target_https_proxy Name of the TargetHttpsProxy resource whose CertificateMap is to be set. - /// The name must be 1-63 characters long, and comply with RFC1035. + /// @param target_https_proxy Name of the TargetHttpsProxy resource whose CertificateMap is + /// to be set. The name must be 1-63 characters long, and comply with RFC1035. /// @param target_https_proxies_set_certificate_map_request_resource The TargetHttpsProxiesSetCertificateMapRequest for this request. /// @param opts Optional. Override the class-level options, such as retry and /// backoff policies. @@ -723,7 +729,7 @@ class TargetHttpsProxiesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_https_proxies.v1.SetCertificateMapRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_https_proxies/v1/target_https_proxies.proto#L429} + /// [google.cloud.cpp.compute.target_https_proxies.v1.SetCertificateMapRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_https_proxies/v1/target_https_proxies.proto#L507} /// // clang-format on future> @@ -784,7 +790,7 @@ class TargetHttpsProxiesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_https_proxies.v1.SetCertificateMapRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_https_proxies/v1/target_https_proxies.proto#L429} + /// [google.cloud.cpp.compute.target_https_proxies.v1.SetCertificateMapRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_https_proxies/v1/target_https_proxies.proto#L507} /// // clang-format on future> @@ -851,7 +857,7 @@ class TargetHttpsProxiesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_https_proxies.v1.SetQuicOverrideRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_https_proxies/v1/target_https_proxies.proto#L462} + /// [google.cloud.cpp.compute.target_https_proxies.v1.SetQuicOverrideRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_https_proxies/v1/target_https_proxies.proto#L543} /// // clang-format on future> SetQuicOverride( @@ -911,7 +917,7 @@ class TargetHttpsProxiesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_https_proxies.v1.SetQuicOverrideRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_https_proxies/v1/target_https_proxies.proto#L462} + /// [google.cloud.cpp.compute.target_https_proxies.v1.SetQuicOverrideRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_https_proxies/v1/target_https_proxies.proto#L543} /// // clang-format on future> SetQuicOverride( @@ -955,8 +961,8 @@ class TargetHttpsProxiesClient { /// https://cloud.google.com/compute/docs/reference/rest/v1/targetHttpsProxies/setSslCertificates /// /// @param project Project ID for this request. - /// @param target_https_proxy Name of the TargetHttpsProxy resource to set an SslCertificates resource - /// for. + /// @param target_https_proxy Name of the TargetHttpsProxy resource to set an + /// SslCertificates resource for. /// @param target_https_proxies_set_ssl_certificates_request_resource The TargetHttpsProxiesSetSslCertificatesRequest for this request. /// @param opts Optional. Override the class-level options, such as retry and /// backoff policies. @@ -978,7 +984,7 @@ class TargetHttpsProxiesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_https_proxies.v1.SetSslCertificatesRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_https_proxies/v1/target_https_proxies.proto#L494} + /// [google.cloud.cpp.compute.target_https_proxies.v1.SetSslCertificatesRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_https_proxies/v1/target_https_proxies.proto#L578} /// // clang-format on future> @@ -1039,7 +1045,7 @@ class TargetHttpsProxiesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_https_proxies.v1.SetSslCertificatesRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_https_proxies/v1/target_https_proxies.proto#L494} + /// [google.cloud.cpp.compute.target_https_proxies.v1.SetSslCertificatesRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_https_proxies/v1/target_https_proxies.proto#L578} /// // clang-format on future> @@ -1087,8 +1093,8 @@ class TargetHttpsProxiesClient { /// https://cloud.google.com/compute/docs/reference/rest/v1/targetHttpsProxies/setSslPolicy /// /// @param project Project ID for this request. - /// @param target_https_proxy Name of the TargetHttpsProxy resource whose SSL policy is to be set. The - /// name must be 1-63 characters long, and comply with RFC1035. + /// @param target_https_proxy Name of the TargetHttpsProxy resource whose SSL policy is + /// to be set. The name must be 1-63 characters long, and comply with RFC1035. /// @param ssl_policy_reference_resource The SslPolicyReference for this request. /// @param opts Optional. Override the class-level options, such as retry and /// backoff policies. @@ -1110,7 +1116,7 @@ class TargetHttpsProxiesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_https_proxies.v1.SetSslPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_https_proxies/v1/target_https_proxies.proto#L527} + /// [google.cloud.cpp.compute.target_https_proxies.v1.SetSslPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_https_proxies/v1/target_https_proxies.proto#L614} /// // clang-format on future> SetSslPolicy( @@ -1171,7 +1177,7 @@ class TargetHttpsProxiesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_https_proxies.v1.SetSslPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_https_proxies/v1/target_https_proxies.proto#L527} + /// [google.cloud.cpp.compute.target_https_proxies.v1.SetSslPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_https_proxies/v1/target_https_proxies.proto#L614} /// // clang-format on future> SetSslPolicy( @@ -1215,7 +1221,8 @@ class TargetHttpsProxiesClient { /// https://cloud.google.com/compute/docs/reference/rest/v1/targetHttpsProxies/setUrlMap /// /// @param project Project ID for this request. - /// @param target_https_proxy Name of the TargetHttpsProxy resource whose URL map is to be set. + /// @param target_https_proxy Name of the TargetHttpsProxy resource whose URL map is + /// to be set. /// @param url_map_reference_resource The UrlMapReference for this request. /// @param opts Optional. Override the class-level options, such as retry and /// backoff policies. @@ -1237,7 +1244,7 @@ class TargetHttpsProxiesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_https_proxies.v1.SetUrlMapRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_https_proxies/v1/target_https_proxies.proto#L558} + /// [google.cloud.cpp.compute.target_https_proxies.v1.SetUrlMapRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_https_proxies/v1/target_https_proxies.proto#L648} /// // clang-format on future> SetUrlMap( @@ -1295,7 +1302,7 @@ class TargetHttpsProxiesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_https_proxies.v1.SetUrlMapRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_https_proxies/v1/target_https_proxies.proto#L558} + /// [google.cloud.cpp.compute.target_https_proxies.v1.SetUrlMapRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_https_proxies/v1/target_https_proxies.proto#L648} /// // clang-format on future> SetUrlMap( 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 3bff5a44ef7e2..f37dae9c6fee3 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 "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_129.pb.h" -#include "google/cloud/compute/v1/internal/common_136.pb.h" -#include "google/cloud/compute/v1/internal/common_137.pb.h" -#include "google/cloud/compute/v1/internal/common_147.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_154.pb.h" +#include "google/cloud/compute/v1/internal/common_162.pb.h" +#include "google/cloud/compute/v1/internal/common_163.pb.h" +#include "google/cloud/compute/v1/internal/common_174.pb.h" // 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/internal/target_instances_rest_connection_impl.cc b/google/cloud/compute/target_instances/v1/internal/target_instances_rest_connection_impl.cc index ba6abeacb297a..a8f85a14047e1 100644 --- a/google/cloud/compute/target_instances/v1/internal/target_instances_rest_connection_impl.cc +++ b/google/cloud/compute/target_instances/v1/internal/target_instances_rest_connection_impl.cc @@ -535,6 +535,22 @@ TargetInstancesRestConnectionImpl::SetSecurityPolicy( }); } +StatusOr +TargetInstancesRestConnectionImpl::TestIamPermissions( + google::cloud::cpp::compute::target_instances::v1:: + TestIamPermissionsRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->TestIamPermissions(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::target_instances::v1:: + TestIamPermissionsRequest const& request) { + return stub_->TestIamPermissions(rest_context, options, request); + }, + *current, request, __func__); +} + GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END } // namespace compute_target_instances_v1_internal } // namespace cloud diff --git a/google/cloud/compute/target_instances/v1/internal/target_instances_rest_connection_impl.h b/google/cloud/compute/target_instances/v1/internal/target_instances_rest_connection_impl.h index fafcfee77c7e1..dda1d8d514de4 100644 --- a/google/cloud/compute/target_instances/v1/internal/target_instances_rest_connection_impl.h +++ b/google/cloud/compute/target_instances/v1/internal/target_instances_rest_connection_impl.h @@ -102,6 +102,10 @@ class TargetInstancesRestConnectionImpl SetSecurityPolicy( google::cloud::cpp::compute::v1::Operation const& operation) override; + StatusOr + TestIamPermissions(google::cloud::cpp::compute::target_instances::v1:: + TestIamPermissionsRequest const& request) override; + private: static std::unique_ptr< compute_target_instances_v1::TargetInstancesRetryPolicy> diff --git a/google/cloud/compute/target_instances/v1/internal/target_instances_rest_logging_decorator.cc b/google/cloud/compute/target_instances/v1/internal/target_instances_rest_logging_decorator.cc index 01c230efd4991..24da9836d02fc 100644 --- a/google/cloud/compute/target_instances/v1/internal/target_instances_rest_logging_decorator.cc +++ b/google/cloud/compute/target_instances/v1/internal/target_instances_rest_logging_decorator.cc @@ -179,6 +179,20 @@ TargetInstancesRestLogging::SetSecurityPolicy( rest_context, options, request, __func__, tracing_options_); } +StatusOr +TargetInstancesRestLogging::TestIamPermissions( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::target_instances::v1:: + TestIamPermissionsRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::target_instances::v1:: + TestIamPermissionsRequest const& request) { + return child_->TestIamPermissions(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + future> TargetInstancesRestLogging::AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/target_instances/v1/internal/target_instances_rest_logging_decorator.h b/google/cloud/compute/target_instances/v1/internal/target_instances_rest_logging_decorator.h index 10706071bd783..22628bc7b0790 100644 --- a/google/cloud/compute/target_instances/v1/internal/target_instances_rest_logging_decorator.h +++ b/google/cloud/compute/target_instances/v1/internal/target_instances_rest_logging_decorator.h @@ -103,6 +103,12 @@ class TargetInstancesRestLogging : public TargetInstancesRestStub { google::cloud::cpp::compute::target_instances::v1:: SetSecurityPolicyRequest const& request) override; + StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::target_instances::v1:: + TestIamPermissionsRequest const& request) override; + future> AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/target_instances/v1/internal/target_instances_rest_metadata_decorator.cc b/google/cloud/compute/target_instances/v1/internal/target_instances_rest_metadata_decorator.cc index 3ffdbda20ce3a..0889ba04f3648 100644 --- a/google/cloud/compute/target_instances/v1/internal/target_instances_rest_metadata_decorator.cc +++ b/google/cloud/compute/target_instances/v1/internal/target_instances_rest_metadata_decorator.cc @@ -129,6 +129,15 @@ TargetInstancesRestMetadata::SetSecurityPolicy( return child_->SetSecurityPolicy(rest_context, options, request); } +StatusOr +TargetInstancesRestMetadata::TestIamPermissions( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::target_instances::v1:: + TestIamPermissionsRequest const& request) { + SetMetadata(rest_context, options); + return child_->TestIamPermissions(rest_context, options, request); +} + future> TargetInstancesRestMetadata::AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/target_instances/v1/internal/target_instances_rest_metadata_decorator.h b/google/cloud/compute/target_instances/v1/internal/target_instances_rest_metadata_decorator.h index ed4a4d6342af1..cfa58db17fc51 100644 --- a/google/cloud/compute/target_instances/v1/internal/target_instances_rest_metadata_decorator.h +++ b/google/cloud/compute/target_instances/v1/internal/target_instances_rest_metadata_decorator.h @@ -101,6 +101,12 @@ class TargetInstancesRestMetadata : public TargetInstancesRestStub { google::cloud::cpp::compute::target_instances::v1:: SetSecurityPolicyRequest const& request) override; + StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::target_instances::v1:: + TestIamPermissionsRequest const& request) override; + google::cloud::future> AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/target_instances/v1/internal/target_instances_rest_stub.cc b/google/cloud/compute/target_instances/v1/internal/target_instances_rest_stub.cc index 81e8c12bcb160..ef0c05f77f9b4 100644 --- a/google/cloud/compute/target_instances/v1/internal/target_instances_rest_stub.cc +++ b/google/cloud/compute/target_instances/v1/internal/target_instances_rest_stub.cc @@ -292,6 +292,25 @@ DefaultTargetInstancesRestStub::SetSecurityPolicy( std::move(query_params)); } +StatusOr +DefaultTargetInstancesRestStub::TestIamPermissions( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::target_instances::v1:: + TestIamPermissionsRequest const& request) { + std::vector> query_params; + return rest_internal::Post< + google::cloud::cpp::compute::v1::TestPermissionsResponse>( + *service_, rest_context, request.test_permissions_request_resource(), + false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "zones", "/", + request.zone(), "/", "targetInstances", "/", + request.resource(), "/", "testIamPermissions"), + std::move(query_params)); +} + future> DefaultTargetInstancesRestStub::AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/target_instances/v1/internal/target_instances_rest_stub.h b/google/cloud/compute/target_instances/v1/internal/target_instances_rest_stub.h index dbf138d5470af..953bebd0c7c23 100644 --- a/google/cloud/compute/target_instances/v1/internal/target_instances_rest_stub.h +++ b/google/cloud/compute/target_instances/v1/internal/target_instances_rest_stub.h @@ -99,6 +99,12 @@ class TargetInstancesRestStub { google::cloud::cpp::compute::target_instances::v1:: SetSecurityPolicyRequest const& request) = 0; + virtual StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::target_instances::v1:: + TestIamPermissionsRequest const& request) = 0; + virtual future> AsyncGetOperation( google::cloud::CompletionQueue& cq, @@ -185,6 +191,12 @@ class DefaultTargetInstancesRestStub : public TargetInstancesRestStub { google::cloud::cpp::compute::target_instances::v1:: SetSecurityPolicyRequest const& request) override; + StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::target_instances::v1:: + TestIamPermissionsRequest const& request) override; + future> AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/target_instances/v1/internal/target_instances_tracing_connection.cc b/google/cloud/compute/target_instances/v1/internal/target_instances_tracing_connection.cc index 938a614b5f807..5ec038410f51d 100644 --- a/google/cloud/compute/target_instances/v1/internal/target_instances_tracing_connection.cc +++ b/google/cloud/compute/target_instances/v1/internal/target_instances_tracing_connection.cc @@ -176,6 +176,17 @@ TargetInstancesTracingConnection::SetSecurityPolicy( child_->SetSecurityPolicy(operation)); } +StatusOr +TargetInstancesTracingConnection::TestIamPermissions( + google::cloud::cpp::compute::target_instances::v1:: + TestIamPermissionsRequest const& request) { + auto span = internal::MakeSpan( + "compute_target_instances_v1::TargetInstancesConnection::" + "TestIamPermissions"); + auto scope = opentelemetry::trace::Scope(span); + return internal::EndSpan(*span, child_->TestIamPermissions(request)); +} + std::shared_ptr MakeTargetInstancesTracingConnection( std::shared_ptr diff --git a/google/cloud/compute/target_instances/v1/internal/target_instances_tracing_connection.h b/google/cloud/compute/target_instances/v1/internal/target_instances_tracing_connection.h index 049586b689e60..70415e6bc65c2 100644 --- a/google/cloud/compute/target_instances/v1/internal/target_instances_tracing_connection.h +++ b/google/cloud/compute/target_instances/v1/internal/target_instances_tracing_connection.h @@ -89,6 +89,10 @@ class TargetInstancesTracingConnection SetSecurityPolicy( google::cloud::cpp::compute::v1::Operation const& operation) override; + StatusOr + TestIamPermissions(google::cloud::cpp::compute::target_instances::v1:: + TestIamPermissionsRequest const& request) override; + private: std::shared_ptr child_; diff --git a/google/cloud/compute/target_instances/v1/mocks/mock_target_instances_connection.h b/google/cloud/compute/target_instances/v1/mocks/mock_target_instances_connection.h index 4684b2343ce10..adb3e9c8fb49d 100644 --- a/google/cloud/compute/target_instances/v1/mocks/mock_target_instances_connection.h +++ b/google/cloud/compute/target_instances/v1/mocks/mock_target_instances_connection.h @@ -189,6 +189,13 @@ class MockTargetInstancesConnection SetSecurityPolicy, (google::cloud::cpp::compute::v1::Operation const& operation), (override)); + + MOCK_METHOD( + StatusOr, + TestIamPermissions, + (google::cloud::cpp::compute::target_instances::v1:: + TestIamPermissionsRequest const& request), + (override)); }; GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END diff --git a/google/cloud/compute/target_instances/v1/target_instances_client.cc b/google/cloud/compute/target_instances/v1/target_instances_client.cc index 1be11027d0e4d..7ed7780e88822 100644 --- a/google/cloud/compute/target_instances/v1/target_instances_client.cc +++ b/google/cloud/compute/target_instances/v1/target_instances_client.cc @@ -270,6 +270,33 @@ TargetInstancesClient::SetSecurityPolicy( return connection_->SetSecurityPolicy(operation); } +StatusOr +TargetInstancesClient::TestIamPermissions( + std::string const& project, std::string const& zone, + std::string const& resource, + google::cloud::cpp::compute::v1::TestPermissionsRequest const& + test_permissions_request_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::target_instances::v1::TestIamPermissionsRequest + request; + request.set_project(project); + request.set_zone(zone); + request.set_resource(resource); + *request.mutable_test_permissions_request_resource() = + test_permissions_request_resource; + return connection_->TestIamPermissions(request); +} + +StatusOr +TargetInstancesClient::TestIamPermissions( + google::cloud::cpp::compute::target_instances::v1:: + TestIamPermissionsRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->TestIamPermissions(request); +} + GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END } // namespace compute_target_instances_v1 } // namespace cloud 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 bfd35ace07702..99cec0adcc4a3 100644 --- a/google/cloud/compute/target_instances/v1/target_instances_client.h +++ b/google/cloud/compute/target_instances/v1/target_instances_client.h @@ -90,9 +90,10 @@ class TargetInstancesClient { // clang-format off /// - /// Retrieves an aggregated list of target instances. To prevent failure, - /// Google recommends that you set the `returnPartialSuccess` parameter to - /// `true`. + /// Retrieves an aggregated list of target instances. + /// + /// To prevent failure, Google recommends that you set the + /// `returnPartialSuccess` parameter to `true`. /// https://cloud.google.com/compute/docs/reference/rest/v1/targetInstances/aggregatedList /// /// @param project Project ID for this request. @@ -118,8 +119,8 @@ class TargetInstancesClient { /// [`future`]: @ref google::cloud::future /// [`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_138.proto#L304} + /// [google.cloud.cpp.compute.target_instances.v1.AggregatedListTargetInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_instances/v1/target_instances.proto#L130} + /// [google.cloud.cpp.compute.v1.TargetInstancesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_164.proto#L353} /// // clang-format on StreamRange> @@ -253,7 +255,7 @@ class TargetInstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_instances.v1.DeleteTargetInstanceRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_instances/v1/target_instances.proto#L197} + /// [google.cloud.cpp.compute.target_instances.v1.DeleteTargetInstanceRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_instances/v1/target_instances.proto#L245} /// // clang-format on future> @@ -313,8 +315,8 @@ class TargetInstancesClient { /// [`future`]: @ref google::cloud::future /// [`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_138.proto#L28} + /// [google.cloud.cpp.compute.target_instances.v1.GetTargetInstanceRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_instances/v1/target_instances.proto#L281} + /// [google.cloud.cpp.compute.v1.TargetInstance]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_164.proto#L31} /// // clang-format on StatusOr GetTargetInstance( @@ -345,8 +347,8 @@ class TargetInstancesClient { /// [`future`]: @ref google::cloud::future /// [`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_138.proto#L28} + /// [google.cloud.cpp.compute.target_instances.v1.GetTargetInstanceRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_instances/v1/target_instances.proto#L281} + /// [google.cloud.cpp.compute.v1.TargetInstance]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_164.proto#L31} /// // clang-format on StatusOr GetTargetInstance( @@ -383,7 +385,7 @@ class TargetInstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_instances.v1.InsertTargetInstanceRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_instances/v1/target_instances.proto#L244} + /// [google.cloud.cpp.compute.target_instances.v1.InsertTargetInstanceRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_instances/v1/target_instances.proto#L295} /// // clang-format on future> @@ -441,7 +443,7 @@ class TargetInstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_instances.v1.InsertTargetInstanceRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_instances/v1/target_instances.proto#L244} + /// [google.cloud.cpp.compute.target_instances.v1.InsertTargetInstanceRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_instances/v1/target_instances.proto#L295} /// // clang-format on future> @@ -510,8 +512,8 @@ class TargetInstancesClient { /// [`future`]: @ref google::cloud::future /// [`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_138.proto#L28} + /// [google.cloud.cpp.compute.target_instances.v1.ListTargetInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_instances/v1/target_instances.proto#L331} + /// [google.cloud.cpp.compute.v1.TargetInstance]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_164.proto#L31} /// // clang-format on StreamRange @@ -552,8 +554,8 @@ class TargetInstancesClient { /// [`future`]: @ref google::cloud::future /// [`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_138.proto#L28} + /// [google.cloud.cpp.compute.target_instances.v1.ListTargetInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_instances/v1/target_instances.proto#L331} + /// [google.cloud.cpp.compute.v1.TargetInstance]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_164.proto#L31} /// // clang-format on StreamRange @@ -564,7 +566,8 @@ class TargetInstancesClient { // clang-format off /// /// Sets the Google Cloud Armor security policy for the specified target - /// instance. For more information, see Google Cloud Armor Overview + /// instance. For more information, seeGoogle + /// Cloud Armor Overview /// https://cloud.google.com/compute/docs/reference/rest/v1/targetInstances/setSecurityPolicy /// /// @param project Project ID for this request. @@ -592,7 +595,7 @@ class TargetInstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_instances.v1.SetSecurityPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_instances/v1/target_instances.proto#L348} + /// [google.cloud.cpp.compute.target_instances.v1.SetSecurityPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_instances/v1/target_instances.proto#L435} /// // clang-format on future> @@ -624,7 +627,8 @@ class TargetInstancesClient { // clang-format off /// /// Sets the Google Cloud Armor security policy for the specified target - /// instance. For more information, see Google Cloud Armor Overview + /// instance. For more information, seeGoogle + /// Cloud Armor Overview /// https://cloud.google.com/compute/docs/reference/rest/v1/targetInstances/setSecurityPolicy /// /// @param request Unary RPCs, such as the one wrapped by this @@ -653,7 +657,7 @@ class TargetInstancesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_instances.v1.SetSecurityPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_instances/v1/target_instances.proto#L348} + /// [google.cloud.cpp.compute.target_instances.v1.SetSecurityPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_instances/v1/target_instances.proto#L435} /// // clang-format on future> @@ -691,6 +695,73 @@ class TargetInstancesClient { SetSecurityPolicy(google::cloud::cpp::compute::v1::Operation const& operation, Options opts = {}); + // clang-format off + /// + /// Returns permissions that a caller has on the specified resource. + /// https://cloud.google.com/compute/docs/reference/rest/v1/targetInstances/testIamPermissions + /// + /// @param project Project ID for this request. + /// @param zone The name of the zone for this request. + /// @param resource Name or id of the resource for this request. + /// @param test_permissions_request_resource The TestPermissionsRequest for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.TestPermissionsResponse]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.target_instances.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_instances/v1/target_instances.proto#L477} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} + /// + // clang-format on + StatusOr + TestIamPermissions( + std::string const& project, std::string const& zone, + std::string const& resource, + google::cloud::cpp::compute::v1::TestPermissionsRequest const& + test_permissions_request_resource, + Options opts = {}); + + // clang-format off + /// + /// Returns permissions that a caller has on the specified resource. + /// https://cloud.google.com/compute/docs/reference/rest/v1/targetInstances/testIamPermissions + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.target_instances.v1.TestIamPermissionsRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.TestPermissionsResponse]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.target_instances.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_instances/v1/target_instances.proto#L477} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} + /// + // clang-format on + StatusOr + TestIamPermissions(google::cloud::cpp::compute::target_instances::v1:: + TestIamPermissionsRequest const& request, + Options opts = {}); + private: std::shared_ptr connection_; Options options_; diff --git a/google/cloud/compute/target_instances/v1/target_instances_connection.cc b/google/cloud/compute/target_instances/v1/target_instances_connection.cc index 07a774336bb18..d6fb60309c850 100644 --- a/google/cloud/compute/target_instances/v1/target_instances_connection.cc +++ b/google/cloud/compute/target_instances/v1/target_instances_connection.cc @@ -136,6 +136,13 @@ TargetInstancesConnection::SetSecurityPolicy( Status(StatusCode::kUnimplemented, "not implemented")); } +StatusOr +TargetInstancesConnection::TestIamPermissions( + google::cloud::cpp::compute::target_instances::v1:: + TestIamPermissionsRequest const&) { + return Status(StatusCode::kUnimplemented, "not implemented"); +} + GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END } // namespace compute_target_instances_v1 } // namespace cloud diff --git a/google/cloud/compute/target_instances/v1/target_instances_connection.h b/google/cloud/compute/target_instances/v1/target_instances_connection.h index 18eb77a6bdd44..405ce27d6f467 100644 --- a/google/cloud/compute/target_instances/v1/target_instances_connection.h +++ b/google/cloud/compute/target_instances/v1/target_instances_connection.h @@ -239,6 +239,10 @@ class TargetInstancesConnection { virtual future> SetSecurityPolicy( google::cloud::cpp::compute::v1::Operation const& operation); + + virtual StatusOr + TestIamPermissions(google::cloud::cpp::compute::target_instances::v1:: + TestIamPermissionsRequest const& request); }; GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END diff --git a/google/cloud/compute/target_instances/v1/target_instances_connection_idempotency_policy.cc b/google/cloud/compute/target_instances/v1/target_instances_connection_idempotency_policy.cc index 308dfa30fb152..612c9d8f3f78b 100644 --- a/google/cloud/compute/target_instances/v1/target_instances_connection_idempotency_policy.cc +++ b/google/cloud/compute/target_instances/v1/target_instances_connection_idempotency_policy.cc @@ -71,6 +71,12 @@ Idempotency TargetInstancesConnectionIdempotencyPolicy::SetSecurityPolicy( return Idempotency::kNonIdempotent; } +Idempotency TargetInstancesConnectionIdempotencyPolicy::TestIamPermissions( + google::cloud::cpp::compute::target_instances::v1:: + TestIamPermissionsRequest const&) { + return Idempotency::kNonIdempotent; +} + std::unique_ptr MakeDefaultTargetInstancesConnectionIdempotencyPolicy() { return std::make_unique(); diff --git a/google/cloud/compute/target_instances/v1/target_instances_connection_idempotency_policy.h b/google/cloud/compute/target_instances/v1/target_instances_connection_idempotency_policy.h index 766e3771e1fc4..b1978f69d73ec 100644 --- a/google/cloud/compute/target_instances/v1/target_instances_connection_idempotency_policy.h +++ b/google/cloud/compute/target_instances/v1/target_instances_connection_idempotency_policy.h @@ -60,6 +60,10 @@ class TargetInstancesConnectionIdempotencyPolicy { virtual google::cloud::Idempotency SetSecurityPolicy( google::cloud::cpp::compute::target_instances::v1:: SetSecurityPolicyRequest const& request); + + virtual google::cloud::Idempotency TestIamPermissions( + google::cloud::cpp::compute::target_instances::v1:: + TestIamPermissionsRequest const& request); }; std::unique_ptr 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 4c9edebaabaf2..acfdce5cd1ca5 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,10 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_TARGET_INSTANCES_V1_TARGET_INSTANCES_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_118.pb.h" -#include "google/cloud/compute/v1/internal/common_138.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_142.pb.h" +#include "google/cloud/compute/v1/internal/common_164.pb.h" +#include "google/cloud/compute/v1/internal/common_171.pb.h" // 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/internal/target_pools_rest_connection_impl.cc b/google/cloud/compute/target_pools/v1/internal/target_pools_rest_connection_impl.cc index 7688624d8d9b3..ea89535c0adab 100644 --- a/google/cloud/compute/target_pools/v1/internal/target_pools_rest_connection_impl.cc +++ b/google/cloud/compute/target_pools/v1/internal/target_pools_rest_connection_impl.cc @@ -1208,6 +1208,22 @@ TargetPoolsRestConnectionImpl::SetSecurityPolicy( }); } +StatusOr +TargetPoolsRestConnectionImpl::TestIamPermissions( + google::cloud::cpp::compute::target_pools::v1:: + TestIamPermissionsRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->TestIamPermissions(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::target_pools::v1:: + TestIamPermissionsRequest const& request) { + return stub_->TestIamPermissions(rest_context, options, request); + }, + *current, request, __func__); +} + GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END } // namespace compute_target_pools_v1_internal } // namespace cloud diff --git a/google/cloud/compute/target_pools/v1/internal/target_pools_rest_connection_impl.h b/google/cloud/compute/target_pools/v1/internal/target_pools_rest_connection_impl.h index e564a34d379c8..02309b6a124f0 100644 --- a/google/cloud/compute/target_pools/v1/internal/target_pools_rest_connection_impl.h +++ b/google/cloud/compute/target_pools/v1/internal/target_pools_rest_connection_impl.h @@ -161,6 +161,10 @@ class TargetPoolsRestConnectionImpl SetSecurityPolicy( google::cloud::cpp::compute::v1::Operation const& operation) override; + StatusOr + TestIamPermissions(google::cloud::cpp::compute::target_pools::v1:: + TestIamPermissionsRequest const& request) override; + private: static std::unique_ptr retry_policy(Options const& options) { diff --git a/google/cloud/compute/target_pools/v1/internal/target_pools_rest_logging_decorator.cc b/google/cloud/compute/target_pools/v1/internal/target_pools_rest_logging_decorator.cc index d2618d9da057a..0d20244ebf609 100644 --- a/google/cloud/compute/target_pools/v1/internal/target_pools_rest_logging_decorator.cc +++ b/google/cloud/compute/target_pools/v1/internal/target_pools_rest_logging_decorator.cc @@ -366,6 +366,20 @@ TargetPoolsRestLogging::SetSecurityPolicy( rest_context, options, request, __func__, tracing_options_); } +StatusOr +TargetPoolsRestLogging::TestIamPermissions( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::target_pools::v1:: + TestIamPermissionsRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::target_pools::v1:: + TestIamPermissionsRequest const& request) { + return child_->TestIamPermissions(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + future> TargetPoolsRestLogging::AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/target_pools/v1/internal/target_pools_rest_logging_decorator.h b/google/cloud/compute/target_pools/v1/internal/target_pools_rest_logging_decorator.h index 1db83a1253083..7bcdbe31dd4ba 100644 --- a/google/cloud/compute/target_pools/v1/internal/target_pools_rest_logging_decorator.h +++ b/google/cloud/compute/target_pools/v1/internal/target_pools_rest_logging_decorator.h @@ -177,6 +177,12 @@ class TargetPoolsRestLogging : public TargetPoolsRestStub { google::cloud::cpp::compute::target_pools::v1:: SetSecurityPolicyRequest const& request) override; + StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::target_pools::v1:: + TestIamPermissionsRequest const& request) override; + future> AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/target_pools/v1/internal/target_pools_rest_metadata_decorator.cc b/google/cloud/compute/target_pools/v1/internal/target_pools_rest_metadata_decorator.cc index 908ef562a5f77..f09fcaa334c88 100644 --- a/google/cloud/compute/target_pools/v1/internal/target_pools_rest_metadata_decorator.cc +++ b/google/cloud/compute/target_pools/v1/internal/target_pools_rest_metadata_decorator.cc @@ -242,6 +242,15 @@ TargetPoolsRestMetadata::SetSecurityPolicy( return child_->SetSecurityPolicy(rest_context, options, request); } +StatusOr +TargetPoolsRestMetadata::TestIamPermissions( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::target_pools::v1:: + TestIamPermissionsRequest const& request) { + SetMetadata(rest_context, options); + return child_->TestIamPermissions(rest_context, options, request); +} + future> TargetPoolsRestMetadata::AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/target_pools/v1/internal/target_pools_rest_metadata_decorator.h b/google/cloud/compute/target_pools/v1/internal/target_pools_rest_metadata_decorator.h index 7d31c4e6af8af..69db1f978050d 100644 --- a/google/cloud/compute/target_pools/v1/internal/target_pools_rest_metadata_decorator.h +++ b/google/cloud/compute/target_pools/v1/internal/target_pools_rest_metadata_decorator.h @@ -176,6 +176,12 @@ class TargetPoolsRestMetadata : public TargetPoolsRestStub { google::cloud::cpp::compute::target_pools::v1:: SetSecurityPolicyRequest const& request) override; + StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::target_pools::v1:: + TestIamPermissionsRequest const& request) override; + google::cloud::future> AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/target_pools/v1/internal/target_pools_rest_stub.cc b/google/cloud/compute/target_pools/v1/internal/target_pools_rest_stub.cc index c0d1a3a560185..6eb0af3522d06 100644 --- a/google/cloud/compute/target_pools/v1/internal/target_pools_rest_stub.cc +++ b/google/cloud/compute/target_pools/v1/internal/target_pools_rest_stub.cc @@ -612,6 +612,25 @@ DefaultTargetPoolsRestStub::SetSecurityPolicy( std::move(query_params)); } +StatusOr +DefaultTargetPoolsRestStub::TestIamPermissions( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::target_pools::v1:: + TestIamPermissionsRequest const& request) { + std::vector> query_params; + return rest_internal::Post< + google::cloud::cpp::compute::v1::TestPermissionsResponse>( + *service_, rest_context, request.test_permissions_request_resource(), + false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "regions", "/", + request.region(), "/", "targetPools", "/", + request.resource(), "/", "testIamPermissions"), + std::move(query_params)); +} + future> DefaultTargetPoolsRestStub::AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/target_pools/v1/internal/target_pools_rest_stub.h b/google/cloud/compute/target_pools/v1/internal/target_pools_rest_stub.h index 6f6691f901265..5d2a53ef5b1a7 100644 --- a/google/cloud/compute/target_pools/v1/internal/target_pools_rest_stub.h +++ b/google/cloud/compute/target_pools/v1/internal/target_pools_rest_stub.h @@ -175,6 +175,12 @@ class TargetPoolsRestStub { google::cloud::cpp::compute::target_pools::v1:: SetSecurityPolicyRequest const& request) = 0; + virtual StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::target_pools::v1:: + TestIamPermissionsRequest const& request) = 0; + virtual future> AsyncGetOperation( google::cloud::CompletionQueue& cq, @@ -335,6 +341,12 @@ class DefaultTargetPoolsRestStub : public TargetPoolsRestStub { google::cloud::cpp::compute::target_pools::v1:: SetSecurityPolicyRequest const& request) override; + StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::target_pools::v1:: + TestIamPermissionsRequest const& request) override; + future> AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/target_pools/v1/internal/target_pools_tracing_connection.cc b/google/cloud/compute/target_pools/v1/internal/target_pools_tracing_connection.cc index 793b6810d6017..13d1563e0a38a 100644 --- a/google/cloud/compute/target_pools/v1/internal/target_pools_tracing_connection.cc +++ b/google/cloud/compute/target_pools/v1/internal/target_pools_tracing_connection.cc @@ -325,6 +325,16 @@ TargetPoolsTracingConnection::SetSecurityPolicy( child_->SetSecurityPolicy(operation)); } +StatusOr +TargetPoolsTracingConnection::TestIamPermissions( + google::cloud::cpp::compute::target_pools::v1:: + TestIamPermissionsRequest const& request) { + auto span = internal::MakeSpan( + "compute_target_pools_v1::TargetPoolsConnection::TestIamPermissions"); + auto scope = opentelemetry::trace::Scope(span); + return internal::EndSpan(*span, child_->TestIamPermissions(request)); +} + std::shared_ptr MakeTargetPoolsTracingConnection( std::shared_ptr conn) { diff --git a/google/cloud/compute/target_pools/v1/internal/target_pools_tracing_connection.h b/google/cloud/compute/target_pools/v1/internal/target_pools_tracing_connection.h index f119b0ba11fb4..b7138cf31a08a 100644 --- a/google/cloud/compute/target_pools/v1/internal/target_pools_tracing_connection.h +++ b/google/cloud/compute/target_pools/v1/internal/target_pools_tracing_connection.h @@ -148,6 +148,10 @@ class TargetPoolsTracingConnection SetSecurityPolicy( google::cloud::cpp::compute::v1::Operation const& operation) override; + StatusOr + TestIamPermissions(google::cloud::cpp::compute::target_pools::v1:: + TestIamPermissionsRequest const& request) override; + private: std::shared_ptr child_; }; diff --git a/google/cloud/compute/target_pools/v1/mocks/mock_target_pools_connection.h b/google/cloud/compute/target_pools/v1/mocks/mock_target_pools_connection.h index 7a3549f02573e..144a333d7ff99 100644 --- a/google/cloud/compute/target_pools/v1/mocks/mock_target_pools_connection.h +++ b/google/cloud/compute/target_pools/v1/mocks/mock_target_pools_connection.h @@ -404,6 +404,13 @@ class MockTargetPoolsConnection SetSecurityPolicy, (google::cloud::cpp::compute::v1::Operation const& operation), (override)); + + MOCK_METHOD( + StatusOr, + TestIamPermissions, + (google::cloud::cpp::compute::target_pools::v1:: + TestIamPermissionsRequest const& request), + (override)); }; GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END diff --git a/google/cloud/compute/target_pools/v1/target_pools_client.cc b/google/cloud/compute/target_pools/v1/target_pools_client.cc index 4924ed2179565..dce80a8c4ad99 100644 --- a/google/cloud/compute/target_pools/v1/target_pools_client.cc +++ b/google/cloud/compute/target_pools/v1/target_pools_client.cc @@ -588,6 +588,33 @@ TargetPoolsClient::SetSecurityPolicy( return connection_->SetSecurityPolicy(operation); } +StatusOr +TargetPoolsClient::TestIamPermissions( + std::string const& project, std::string const& region, + std::string const& resource, + google::cloud::cpp::compute::v1::TestPermissionsRequest const& + test_permissions_request_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::target_pools::v1::TestIamPermissionsRequest + request; + request.set_project(project); + request.set_region(region); + request.set_resource(resource); + *request.mutable_test_permissions_request_resource() = + test_permissions_request_resource; + return connection_->TestIamPermissions(request); +} + +StatusOr +TargetPoolsClient::TestIamPermissions( + google::cloud::cpp::compute::target_pools::v1:: + TestIamPermissionsRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->TestIamPermissions(request); +} + GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END } // namespace compute_target_pools_v1 } // namespace cloud 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 a1dbbb45bc6d7..5ad59007cb3c9 100644 --- a/google/cloud/compute/target_pools/v1/target_pools_client.h +++ b/google/cloud/compute/target_pools/v1/target_pools_client.h @@ -117,7 +117,7 @@ class TargetPoolsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_pools.v1.AddHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_pools/v1/target_pools.proto#L194} + /// [google.cloud.cpp.compute.target_pools.v1.AddHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_pools/v1/target_pools.proto#L210} /// // clang-format on future> AddHealthCheck( @@ -176,7 +176,7 @@ class TargetPoolsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_pools.v1.AddHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_pools/v1/target_pools.proto#L194} + /// [google.cloud.cpp.compute.target_pools.v1.AddHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_pools/v1/target_pools.proto#L210} /// // clang-format on future> AddHealthCheck( @@ -243,7 +243,7 @@ class TargetPoolsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_pools.v1.AddInstanceRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_pools/v1/target_pools.proto#L232} + /// [google.cloud.cpp.compute.target_pools.v1.AddInstanceRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_pools/v1/target_pools.proto#L251} /// // clang-format on future> AddInstance( @@ -302,7 +302,7 @@ class TargetPoolsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_pools.v1.AddInstanceRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_pools/v1/target_pools.proto#L232} + /// [google.cloud.cpp.compute.target_pools.v1.AddInstanceRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_pools/v1/target_pools.proto#L251} /// // clang-format on future> AddInstance( @@ -342,8 +342,10 @@ class TargetPoolsClient { // clang-format off /// - /// Retrieves an aggregated list of target pools. To prevent failure, Google - /// recommends that you set the `returnPartialSuccess` parameter to `true`. + /// Retrieves an aggregated list of target pools. + /// + /// To prevent failure, Google recommends that you set the + /// `returnPartialSuccess` parameter to `true`. /// https://cloud.google.com/compute/docs/reference/rest/v1/targetPools/aggregatedList /// /// @param project Project ID for this request. @@ -369,8 +371,8 @@ class TargetPoolsClient { /// [`future`]: @ref google::cloud::future /// [`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_139.proto#L398} + /// [google.cloud.cpp.compute.target_pools.v1.AggregatedListTargetPoolsRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_pools/v1/target_pools.proto#L292} + /// [google.cloud.cpp.compute.v1.TargetPoolsScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_165.proto#L461} /// // clang-format on StreamRange> DeleteTargetPool( @@ -502,7 +506,7 @@ class TargetPoolsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_pools.v1.DeleteTargetPoolRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_pools/v1/target_pools.proto#L352} + /// [google.cloud.cpp.compute.target_pools.v1.DeleteTargetPoolRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_pools/v1/target_pools.proto#L407} /// // clang-format on future> DeleteTargetPool( @@ -561,8 +565,8 @@ class TargetPoolsClient { /// [`future`]: @ref google::cloud::future /// [`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_139.proto#L32} + /// [google.cloud.cpp.compute.target_pools.v1.GetTargetPoolRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_pools/v1/target_pools.proto#L462} + /// [google.cloud.cpp.compute.v1.TargetPool]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_165.proto#L34} /// // clang-format on StatusOr GetTargetPool( @@ -593,8 +597,8 @@ class TargetPoolsClient { /// [`future`]: @ref google::cloud::future /// [`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_139.proto#L32} + /// [google.cloud.cpp.compute.target_pools.v1.GetTargetPoolRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_pools/v1/target_pools.proto#L462} + /// [google.cloud.cpp.compute.v1.TargetPool]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_165.proto#L34} /// // clang-format on StatusOr GetTargetPool( @@ -604,8 +608,8 @@ class TargetPoolsClient { // clang-format off /// - /// Gets the most recent health check results for each IP for the instance that - /// is referenced by the given target pool. + /// Gets the most recent health check results for each IP for the + /// instance that is referenced by the given target pool. /// https://cloud.google.com/compute/docs/reference/rest/v1/targetPools/getHealth /// /// @param project Project ID for this request. @@ -625,8 +629,8 @@ class TargetPoolsClient { /// [`future`]: @ref google::cloud::future /// [`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_139.proto#L251} + /// [google.cloud.cpp.compute.target_pools.v1.GetHealthRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_pools/v1/target_pools.proto#L443} + /// [google.cloud.cpp.compute.v1.TargetPoolInstanceHealth]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_165.proto#L290} /// // clang-format on StatusOr GetHealth( @@ -638,8 +642,8 @@ class TargetPoolsClient { // clang-format off /// - /// Gets the most recent health check results for each IP for the instance that - /// is referenced by the given target pool. + /// Gets the most recent health check results for each IP for the + /// instance that is referenced by the given target pool. /// https://cloud.google.com/compute/docs/reference/rest/v1/targetPools/getHealth /// /// @param request Unary RPCs, such as the one wrapped by this @@ -661,8 +665,8 @@ class TargetPoolsClient { /// [`future`]: @ref google::cloud::future /// [`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_139.proto#L251} + /// [google.cloud.cpp.compute.target_pools.v1.GetHealthRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_pools/v1/target_pools.proto#L443} + /// [google.cloud.cpp.compute.v1.TargetPoolInstanceHealth]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_165.proto#L290} /// // clang-format on StatusOr GetHealth( @@ -672,8 +676,8 @@ class TargetPoolsClient { // clang-format off /// - /// Creates a target pool in the specified project and region using the data - /// included in the request. + /// Creates a target pool in the specified project and region using + /// the data included in the request. /// https://cloud.google.com/compute/docs/reference/rest/v1/targetPools/insert /// /// @param project Project ID for this request. @@ -699,7 +703,7 @@ class TargetPoolsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_pools.v1.InsertTargetPoolRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_pools/v1/target_pools.proto#L419} + /// [google.cloud.cpp.compute.target_pools.v1.InsertTargetPoolRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_pools/v1/target_pools.proto#L477} /// // clang-format on future> InsertTargetPool( @@ -725,8 +729,8 @@ class TargetPoolsClient { // clang-format off /// - /// Creates a target pool in the specified project and region using the data - /// included in the request. + /// Creates a target pool in the specified project and region using + /// the data included in the request. /// https://cloud.google.com/compute/docs/reference/rest/v1/targetPools/insert /// /// @param request Unary RPCs, such as the one wrapped by this @@ -755,7 +759,7 @@ class TargetPoolsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_pools.v1.InsertTargetPoolRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_pools/v1/target_pools.proto#L419} + /// [google.cloud.cpp.compute.target_pools.v1.InsertTargetPoolRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_pools/v1/target_pools.proto#L477} /// // clang-format on future> InsertTargetPool( @@ -795,8 +799,8 @@ class TargetPoolsClient { // clang-format off /// - /// Retrieves a list of target pools available to the specified project and - /// region. + /// Retrieves a list of target pools available to the specified + /// project and region. /// https://cloud.google.com/compute/docs/reference/rest/v1/targetPools/list /// /// @param project Project ID for this request. @@ -823,8 +827,8 @@ class TargetPoolsClient { /// [`future`]: @ref google::cloud::future /// [`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_139.proto#L32} + /// [google.cloud.cpp.compute.target_pools.v1.ListTargetPoolsRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_pools/v1/target_pools.proto#L513} + /// [google.cloud.cpp.compute.v1.TargetPool]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_165.proto#L34} /// // clang-format on StreamRange ListTargetPools( @@ -832,8 +836,8 @@ class TargetPoolsClient { // clang-format off /// - /// Retrieves a list of target pools available to the specified project and - /// region. + /// Retrieves a list of target pools available to the specified + /// project and region. /// https://cloud.google.com/compute/docs/reference/rest/v1/targetPools/list /// /// @param request Unary RPCs, such as the one wrapped by this @@ -864,8 +868,8 @@ class TargetPoolsClient { /// [`future`]: @ref google::cloud::future /// [`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_139.proto#L32} + /// [google.cloud.cpp.compute.target_pools.v1.ListTargetPoolsRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_pools/v1/target_pools.proto#L513} + /// [google.cloud.cpp.compute.v1.TargetPool]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_165.proto#L34} /// // clang-format on StreamRange ListTargetPools( @@ -902,7 +906,7 @@ class TargetPoolsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_pools.v1.RemoveHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_pools/v1/target_pools.proto#L524} + /// [google.cloud.cpp.compute.target_pools.v1.RemoveHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_pools/v1/target_pools.proto#L618} /// // clang-format on future> @@ -963,7 +967,7 @@ class TargetPoolsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_pools.v1.RemoveHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_pools/v1/target_pools.proto#L524} + /// [google.cloud.cpp.compute.target_pools.v1.RemoveHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_pools/v1/target_pools.proto#L618} /// // clang-format on future> @@ -1030,7 +1034,7 @@ class TargetPoolsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_pools.v1.RemoveInstanceRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_pools/v1/target_pools.proto#L562} + /// [google.cloud.cpp.compute.target_pools.v1.RemoveInstanceRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_pools/v1/target_pools.proto#L659} /// // clang-format on future> RemoveInstance( @@ -1089,7 +1093,7 @@ class TargetPoolsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_pools.v1.RemoveInstanceRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_pools/v1/target_pools.proto#L562} + /// [google.cloud.cpp.compute.target_pools.v1.RemoveInstanceRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_pools/v1/target_pools.proto#L659} /// // clang-format on future> RemoveInstance( @@ -1156,7 +1160,7 @@ class TargetPoolsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_pools.v1.SetBackupRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_pools/v1/target_pools.proto#L600} + /// [google.cloud.cpp.compute.target_pools.v1.SetBackupRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_pools/v1/target_pools.proto#L700} /// // clang-format on future> SetBackup( @@ -1215,7 +1219,7 @@ class TargetPoolsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_pools.v1.SetBackupRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_pools/v1/target_pools.proto#L600} + /// [google.cloud.cpp.compute.target_pools.v1.SetBackupRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_pools/v1/target_pools.proto#L700} /// // clang-format on future> SetBackup( @@ -1256,13 +1260,14 @@ class TargetPoolsClient { // clang-format off /// /// Sets the Google Cloud Armor security policy for the specified target pool. - /// For more information, see Google Cloud Armor Overview + /// For more information, seeGoogle + /// Cloud Armor Overview /// https://cloud.google.com/compute/docs/reference/rest/v1/targetPools/setSecurityPolicy /// /// @param project Project ID for this request. /// @param region Name of the region scoping this request. - /// @param target_pool Name of the TargetPool resource to which the security policy should be set. - /// The name should conform to RFC1035. + /// @param target_pool Name of the TargetPool resource to which the security policy should be + /// set. The name should conform to RFC1035. /// @param security_policy_reference_resource The SecurityPolicyReference for this request. /// @param opts Optional. Override the class-level options, such as retry and /// backoff policies. @@ -1284,7 +1289,7 @@ class TargetPoolsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_pools.v1.SetSecurityPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_pools/v1/target_pools.proto#L640} + /// [google.cloud.cpp.compute.target_pools.v1.SetSecurityPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_pools/v1/target_pools.proto#L743} /// // clang-format on future> @@ -1316,7 +1321,8 @@ class TargetPoolsClient { // clang-format off /// /// Sets the Google Cloud Armor security policy for the specified target pool. - /// For more information, see Google Cloud Armor Overview + /// For more information, seeGoogle + /// Cloud Armor Overview /// https://cloud.google.com/compute/docs/reference/rest/v1/targetPools/setSecurityPolicy /// /// @param request Unary RPCs, such as the one wrapped by this @@ -1345,7 +1351,7 @@ class TargetPoolsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_pools.v1.SetSecurityPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_pools/v1/target_pools.proto#L640} + /// [google.cloud.cpp.compute.target_pools.v1.SetSecurityPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_pools/v1/target_pools.proto#L743} /// // clang-format on future> @@ -1383,6 +1389,73 @@ class TargetPoolsClient { SetSecurityPolicy(google::cloud::cpp::compute::v1::Operation const& operation, Options opts = {}); + // clang-format off + /// + /// Returns permissions that a caller has on the specified resource. + /// https://cloud.google.com/compute/docs/reference/rest/v1/targetPools/testIamPermissions + /// + /// @param project Project ID for this request. + /// @param region The name of the region for this request. + /// @param resource Name or id of the resource for this request. + /// @param test_permissions_request_resource The TestPermissionsRequest for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.TestPermissionsResponse]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.target_pools.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_pools/v1/target_pools.proto#L785} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} + /// + // clang-format on + StatusOr + TestIamPermissions( + std::string const& project, std::string const& region, + std::string const& resource, + google::cloud::cpp::compute::v1::TestPermissionsRequest const& + test_permissions_request_resource, + Options opts = {}); + + // clang-format off + /// + /// Returns permissions that a caller has on the specified resource. + /// https://cloud.google.com/compute/docs/reference/rest/v1/targetPools/testIamPermissions + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.target_pools.v1.TestIamPermissionsRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.TestPermissionsResponse]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.target_pools.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_pools/v1/target_pools.proto#L785} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} + /// + // clang-format on + StatusOr + TestIamPermissions(google::cloud::cpp::compute::target_pools::v1:: + TestIamPermissionsRequest const& request, + Options opts = {}); + private: std::shared_ptr connection_; Options options_; diff --git a/google/cloud/compute/target_pools/v1/target_pools_connection.cc b/google/cloud/compute/target_pools/v1/target_pools_connection.cc index 9fd152cd7143b..77f7c7909568d 100644 --- a/google/cloud/compute/target_pools/v1/target_pools_connection.cc +++ b/google/cloud/compute/target_pools/v1/target_pools_connection.cc @@ -264,6 +264,13 @@ TargetPoolsConnection::SetSecurityPolicy( Status(StatusCode::kUnimplemented, "not implemented")); } +StatusOr +TargetPoolsConnection::TestIamPermissions( + google::cloud::cpp::compute::target_pools::v1:: + TestIamPermissionsRequest const&) { + return Status(StatusCode::kUnimplemented, "not implemented"); +} + GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END } // namespace compute_target_pools_v1 } // namespace cloud diff --git a/google/cloud/compute/target_pools/v1/target_pools_connection.h b/google/cloud/compute/target_pools/v1/target_pools_connection.h index 4cb09cef7221a..1eef4eda60637 100644 --- a/google/cloud/compute/target_pools/v1/target_pools_connection.h +++ b/google/cloud/compute/target_pools/v1/target_pools_connection.h @@ -296,6 +296,10 @@ class TargetPoolsConnection { virtual future> SetSecurityPolicy( google::cloud::cpp::compute::v1::Operation const& operation); + + virtual StatusOr + TestIamPermissions(google::cloud::cpp::compute::target_pools::v1:: + TestIamPermissionsRequest const& request); }; GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END diff --git a/google/cloud/compute/target_pools/v1/target_pools_connection_idempotency_policy.cc b/google/cloud/compute/target_pools/v1/target_pools_connection_idempotency_policy.cc index 4b4997e4867b5..0011c5a5cec1e 100644 --- a/google/cloud/compute/target_pools/v1/target_pools_connection_idempotency_policy.cc +++ b/google/cloud/compute/target_pools/v1/target_pools_connection_idempotency_policy.cc @@ -103,6 +103,12 @@ Idempotency TargetPoolsConnectionIdempotencyPolicy::SetSecurityPolicy( return Idempotency::kNonIdempotent; } +Idempotency TargetPoolsConnectionIdempotencyPolicy::TestIamPermissions( + google::cloud::cpp::compute::target_pools::v1:: + TestIamPermissionsRequest const&) { + return Idempotency::kNonIdempotent; +} + std::unique_ptr MakeDefaultTargetPoolsConnectionIdempotencyPolicy() { return std::make_unique(); diff --git a/google/cloud/compute/target_pools/v1/target_pools_connection_idempotency_policy.h b/google/cloud/compute/target_pools/v1/target_pools_connection_idempotency_policy.h index fd9dafc079137..5d70770fa9ac7 100644 --- a/google/cloud/compute/target_pools/v1/target_pools_connection_idempotency_policy.h +++ b/google/cloud/compute/target_pools/v1/target_pools_connection_idempotency_policy.h @@ -83,6 +83,10 @@ class TargetPoolsConnectionIdempotencyPolicy { virtual google::cloud::Idempotency SetSecurityPolicy( google::cloud::cpp::compute::target_pools::v1:: SetSecurityPolicyRequest const& request); + + virtual google::cloud::Idempotency TestIamPermissions( + google::cloud::cpp::compute::target_pools::v1:: + TestIamPermissionsRequest const& request); }; std::unique_ptr 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 c38bcff3b167b..20703e5d27e71 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,14 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_TARGET_POOLS_V1_TARGET_POOLS_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_049.pb.h" -#include "google/cloud/compute/v1/internal/common_052.pb.h" -#include "google/cloud/compute/v1/internal/common_063.pb.h" -#include "google/cloud/compute/v1/internal/common_118.pb.h" -#include "google/cloud/compute/v1/internal/common_139.pb.h" -#include "google/cloud/compute/v1/internal/common_140.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_061.pb.h" +#include "google/cloud/compute/v1/internal/common_065.pb.h" +#include "google/cloud/compute/v1/internal/common_078.pb.h" +#include "google/cloud/compute/v1/internal/common_142.pb.h" +#include "google/cloud/compute/v1/internal/common_165.pb.h" +#include "google/cloud/compute/v1/internal/common_166.pb.h" +#include "google/cloud/compute/v1/internal/common_171.pb.h" // 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/internal/target_ssl_proxies_rest_connection_impl.cc b/google/cloud/compute/target_ssl_proxies/v1/internal/target_ssl_proxies_rest_connection_impl.cc index d7a1772e5f359..fbc8e2893b316 100644 --- a/google/cloud/compute/target_ssl_proxies/v1/internal/target_ssl_proxies_rest_connection_impl.cc +++ b/google/cloud/compute/target_ssl_proxies/v1/internal/target_ssl_proxies_rest_connection_impl.cc @@ -989,6 +989,22 @@ TargetSslProxiesRestConnectionImpl::SetSslPolicy( }); } +StatusOr +TargetSslProxiesRestConnectionImpl::TestIamPermissions( + google::cloud::cpp::compute::target_ssl_proxies::v1:: + TestIamPermissionsRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->TestIamPermissions(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::target_ssl_proxies::v1:: + TestIamPermissionsRequest const& request) { + return stub_->TestIamPermissions(rest_context, options, request); + }, + *current, request, __func__); +} + GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END } // namespace compute_target_ssl_proxies_v1_internal } // namespace cloud diff --git a/google/cloud/compute/target_ssl_proxies/v1/internal/target_ssl_proxies_rest_connection_impl.h b/google/cloud/compute/target_ssl_proxies/v1/internal/target_ssl_proxies_rest_connection_impl.h index 978f6954b4b4e..112eb7fc258c2 100644 --- a/google/cloud/compute/target_ssl_proxies/v1/internal/target_ssl_proxies_rest_connection_impl.h +++ b/google/cloud/compute/target_ssl_proxies/v1/internal/target_ssl_proxies_rest_connection_impl.h @@ -142,6 +142,10 @@ class TargetSslProxiesRestConnectionImpl future> SetSslPolicy( google::cloud::cpp::compute::v1::Operation const& operation) override; + StatusOr + TestIamPermissions(google::cloud::cpp::compute::target_ssl_proxies::v1:: + TestIamPermissionsRequest const& request) override; + private: static std::unique_ptr< compute_target_ssl_proxies_v1::TargetSslProxiesRetryPolicy> diff --git a/google/cloud/compute/target_ssl_proxies/v1/internal/target_ssl_proxies_rest_logging_decorator.cc b/google/cloud/compute/target_ssl_proxies/v1/internal/target_ssl_proxies_rest_logging_decorator.cc index 2a4aececeaa03..3a135985cf575 100644 --- a/google/cloud/compute/target_ssl_proxies/v1/internal/target_ssl_proxies_rest_logging_decorator.cc +++ b/google/cloud/compute/target_ssl_proxies/v1/internal/target_ssl_proxies_rest_logging_decorator.cc @@ -300,6 +300,20 @@ TargetSslProxiesRestLogging::SetSslPolicy( rest_context, options, request, __func__, tracing_options_); } +StatusOr +TargetSslProxiesRestLogging::TestIamPermissions( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::target_ssl_proxies::v1:: + TestIamPermissionsRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::target_ssl_proxies::v1:: + TestIamPermissionsRequest const& request) { + return child_->TestIamPermissions(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + future> TargetSslProxiesRestLogging::AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/target_ssl_proxies/v1/internal/target_ssl_proxies_rest_logging_decorator.h b/google/cloud/compute/target_ssl_proxies/v1/internal/target_ssl_proxies_rest_logging_decorator.h index 590327bf0e574..021b818061346 100644 --- a/google/cloud/compute/target_ssl_proxies/v1/internal/target_ssl_proxies_rest_logging_decorator.h +++ b/google/cloud/compute/target_ssl_proxies/v1/internal/target_ssl_proxies_rest_logging_decorator.h @@ -152,6 +152,12 @@ class TargetSslProxiesRestLogging : public TargetSslProxiesRestStub { google::cloud::cpp::compute::target_ssl_proxies::v1:: SetSslPolicyRequest const& request) override; + StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::target_ssl_proxies::v1:: + TestIamPermissionsRequest const& request) override; + future> AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/target_ssl_proxies/v1/internal/target_ssl_proxies_rest_metadata_decorator.cc b/google/cloud/compute/target_ssl_proxies/v1/internal/target_ssl_proxies_rest_metadata_decorator.cc index 31bb9c96ae8e2..6d61f98a0d06f 100644 --- a/google/cloud/compute/target_ssl_proxies/v1/internal/target_ssl_proxies_rest_metadata_decorator.cc +++ b/google/cloud/compute/target_ssl_proxies/v1/internal/target_ssl_proxies_rest_metadata_decorator.cc @@ -204,6 +204,15 @@ TargetSslProxiesRestMetadata::SetSslPolicy( return child_->SetSslPolicy(rest_context, options, request); } +StatusOr +TargetSslProxiesRestMetadata::TestIamPermissions( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::target_ssl_proxies::v1:: + TestIamPermissionsRequest const& request) { + SetMetadata(rest_context, options); + return child_->TestIamPermissions(rest_context, options, request); +} + future> TargetSslProxiesRestMetadata::AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/target_ssl_proxies/v1/internal/target_ssl_proxies_rest_metadata_decorator.h b/google/cloud/compute/target_ssl_proxies/v1/internal/target_ssl_proxies_rest_metadata_decorator.h index 89f83ebe7df1e..c3810f06091f2 100644 --- a/google/cloud/compute/target_ssl_proxies/v1/internal/target_ssl_proxies_rest_metadata_decorator.h +++ b/google/cloud/compute/target_ssl_proxies/v1/internal/target_ssl_proxies_rest_metadata_decorator.h @@ -150,6 +150,12 @@ class TargetSslProxiesRestMetadata : public TargetSslProxiesRestStub { google::cloud::cpp::compute::target_ssl_proxies::v1:: SetSslPolicyRequest const& request) override; + StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::target_ssl_proxies::v1:: + TestIamPermissionsRequest const& request) override; + google::cloud::future> AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/target_ssl_proxies/v1/internal/target_ssl_proxies_rest_stub.cc b/google/cloud/compute/target_ssl_proxies/v1/internal/target_ssl_proxies_rest_stub.cc index 712df00fe786c..a7a2db6437b67 100644 --- a/google/cloud/compute/target_ssl_proxies/v1/internal/target_ssl_proxies_rest_stub.cc +++ b/google/cloud/compute/target_ssl_proxies/v1/internal/target_ssl_proxies_rest_stub.cc @@ -504,6 +504,25 @@ DefaultTargetSslProxiesRestStub::SetSslPolicy( std::move(query_params)); } +StatusOr +DefaultTargetSslProxiesRestStub::TestIamPermissions( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::target_ssl_proxies::v1:: + TestIamPermissionsRequest const& request) { + std::vector> query_params; + return rest_internal::Post< + google::cloud::cpp::compute::v1::TestPermissionsResponse>( + *service_, rest_context, request.test_permissions_request_resource(), + false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "global", "/", + "targetSslProxies", "/", request.resource(), "/", + "testIamPermissions"), + std::move(query_params)); +} + future> DefaultTargetSslProxiesRestStub::AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/target_ssl_proxies/v1/internal/target_ssl_proxies_rest_stub.h b/google/cloud/compute/target_ssl_proxies/v1/internal/target_ssl_proxies_rest_stub.h index 9ce8af0d9b570..e2329beded47e 100644 --- a/google/cloud/compute/target_ssl_proxies/v1/internal/target_ssl_proxies_rest_stub.h +++ b/google/cloud/compute/target_ssl_proxies/v1/internal/target_ssl_proxies_rest_stub.h @@ -147,6 +147,12 @@ class TargetSslProxiesRestStub { google::cloud::cpp::compute::target_ssl_proxies::v1:: SetSslPolicyRequest const& request) = 0; + virtual StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::target_ssl_proxies::v1:: + TestIamPermissionsRequest const& request) = 0; + virtual future> AsyncGetOperation( google::cloud::CompletionQueue& cq, @@ -282,6 +288,12 @@ class DefaultTargetSslProxiesRestStub : public TargetSslProxiesRestStub { google::cloud::cpp::compute::target_ssl_proxies::v1:: SetSslPolicyRequest const& request) override; + StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::target_ssl_proxies::v1:: + TestIamPermissionsRequest const& request) override; + future> AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/target_ssl_proxies/v1/internal/target_ssl_proxies_tracing_connection.cc b/google/cloud/compute/target_ssl_proxies/v1/internal/target_ssl_proxies_tracing_connection.cc index c6f282c81fea4..ca114d37a7b68 100644 --- a/google/cloud/compute/target_ssl_proxies/v1/internal/target_ssl_proxies_tracing_connection.cc +++ b/google/cloud/compute/target_ssl_proxies/v1/internal/target_ssl_proxies_tracing_connection.cc @@ -295,6 +295,17 @@ TargetSslProxiesTracingConnection::SetSslPolicy( return internal::EndSpan(std::move(span), child_->SetSslPolicy(operation)); } +StatusOr +TargetSslProxiesTracingConnection::TestIamPermissions( + google::cloud::cpp::compute::target_ssl_proxies::v1:: + TestIamPermissionsRequest const& request) { + auto span = internal::MakeSpan( + "compute_target_ssl_proxies_v1::TargetSslProxiesConnection::" + "TestIamPermissions"); + auto scope = opentelemetry::trace::Scope(span); + return internal::EndSpan(*span, child_->TestIamPermissions(request)); +} + std::shared_ptr MakeTargetSslProxiesTracingConnection( std::shared_ptr diff --git a/google/cloud/compute/target_ssl_proxies/v1/internal/target_ssl_proxies_tracing_connection.h b/google/cloud/compute/target_ssl_proxies/v1/internal/target_ssl_proxies_tracing_connection.h index 57feb389d0b73..cb35df20280ae 100644 --- a/google/cloud/compute/target_ssl_proxies/v1/internal/target_ssl_proxies_tracing_connection.h +++ b/google/cloud/compute/target_ssl_proxies/v1/internal/target_ssl_proxies_tracing_connection.h @@ -129,6 +129,10 @@ class TargetSslProxiesTracingConnection future> SetSslPolicy( google::cloud::cpp::compute::v1::Operation const& operation) override; + StatusOr + TestIamPermissions(google::cloud::cpp::compute::target_ssl_proxies::v1:: + TestIamPermissionsRequest const& request) override; + private: std::shared_ptr child_; diff --git a/google/cloud/compute/target_ssl_proxies/v1/mocks/mock_target_ssl_proxies_connection.h b/google/cloud/compute/target_ssl_proxies/v1/mocks/mock_target_ssl_proxies_connection.h index 75faf917f0229..3225c6fbb23ac 100644 --- a/google/cloud/compute/target_ssl_proxies/v1/mocks/mock_target_ssl_proxies_connection.h +++ b/google/cloud/compute/target_ssl_proxies/v1/mocks/mock_target_ssl_proxies_connection.h @@ -345,6 +345,13 @@ class MockTargetSslProxiesConnection SetSslPolicy, (google::cloud::cpp::compute::v1::Operation const& operation), (override)); + + MOCK_METHOD( + StatusOr, + TestIamPermissions, + (google::cloud::cpp::compute::target_ssl_proxies::v1:: + TestIamPermissionsRequest const& request), + (override)); }; GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END diff --git a/google/cloud/compute/target_ssl_proxies/v1/target_ssl_proxies_client.cc b/google/cloud/compute/target_ssl_proxies/v1/target_ssl_proxies_client.cc index c01a4db03d28b..50ae92deeb376 100644 --- a/google/cloud/compute/target_ssl_proxies/v1/target_ssl_proxies_client.cc +++ b/google/cloud/compute/target_ssl_proxies/v1/target_ssl_proxies_client.cc @@ -474,6 +474,31 @@ TargetSslProxiesClient::SetSslPolicy( return connection_->SetSslPolicy(operation); } +StatusOr +TargetSslProxiesClient::TestIamPermissions( + std::string const& project, std::string const& resource, + google::cloud::cpp::compute::v1::TestPermissionsRequest const& + test_permissions_request_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::target_ssl_proxies::v1::TestIamPermissionsRequest + request; + request.set_project(project); + request.set_resource(resource); + *request.mutable_test_permissions_request_resource() = + test_permissions_request_resource; + return connection_->TestIamPermissions(request); +} + +StatusOr +TargetSslProxiesClient::TestIamPermissions( + google::cloud::cpp::compute::target_ssl_proxies::v1:: + TestIamPermissionsRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->TestIamPermissions(request); +} + GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END } // namespace compute_target_ssl_proxies_v1 } // namespace cloud 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 02760e06703a8..3c3c123ae64a2 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 @@ -115,7 +115,7 @@ class TargetSslProxiesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_ssl_proxies.v1.DeleteTargetSslProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_ssl_proxies/v1/target_ssl_proxies.proto#L156} + /// [google.cloud.cpp.compute.target_ssl_proxies.v1.DeleteTargetSslProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_ssl_proxies/v1/target_ssl_proxies.proto#L169} /// // clang-format on future> @@ -168,7 +168,7 @@ class TargetSslProxiesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_ssl_proxies.v1.DeleteTargetSslProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_ssl_proxies/v1/target_ssl_proxies.proto#L156} + /// [google.cloud.cpp.compute.target_ssl_proxies.v1.DeleteTargetSslProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_ssl_proxies/v1/target_ssl_proxies.proto#L169} /// // clang-format on future> @@ -227,8 +227,8 @@ class TargetSslProxiesClient { /// [`future`]: @ref google::cloud::future /// [`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_141.proto#L55} + /// [google.cloud.cpp.compute.target_ssl_proxies.v1.GetTargetSslProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_ssl_proxies/v1/target_ssl_proxies.proto#L198} + /// [google.cloud.cpp.compute.v1.TargetSslProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_167.proto#L58} /// // clang-format on StatusOr GetTargetSslProxy( @@ -259,8 +259,8 @@ class TargetSslProxiesClient { /// [`future`]: @ref google::cloud::future /// [`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_141.proto#L55} + /// [google.cloud.cpp.compute.target_ssl_proxies.v1.GetTargetSslProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_ssl_proxies/v1/target_ssl_proxies.proto#L198} + /// [google.cloud.cpp.compute.v1.TargetSslProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_167.proto#L58} /// // clang-format on StatusOr GetTargetSslProxy( @@ -270,8 +270,8 @@ class TargetSslProxiesClient { // clang-format off /// - /// Creates a TargetSslProxy resource in the specified project using the data - /// included in the request. + /// Creates a TargetSslProxy resource in the specified project using + /// the data included in the request. /// https://cloud.google.com/compute/docs/reference/rest/v1/targetSslProxies/insert /// /// @param project Project ID for this request. @@ -296,7 +296,7 @@ class TargetSslProxiesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_ssl_proxies.v1.InsertTargetSslProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_ssl_proxies/v1/target_ssl_proxies.proto#L193} + /// [google.cloud.cpp.compute.target_ssl_proxies.v1.InsertTargetSslProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_ssl_proxies/v1/target_ssl_proxies.proto#L209} /// // clang-format on future> @@ -324,8 +324,8 @@ class TargetSslProxiesClient { // clang-format off /// - /// Creates a TargetSslProxy resource in the specified project using the data - /// included in the request. + /// Creates a TargetSslProxy resource in the specified project using + /// the data included in the request. /// https://cloud.google.com/compute/docs/reference/rest/v1/targetSslProxies/insert /// /// @param request Unary RPCs, such as the one wrapped by this @@ -354,7 +354,7 @@ class TargetSslProxiesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_ssl_proxies.v1.InsertTargetSslProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_ssl_proxies/v1/target_ssl_proxies.proto#L193} + /// [google.cloud.cpp.compute.target_ssl_proxies.v1.InsertTargetSslProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_ssl_proxies/v1/target_ssl_proxies.proto#L209} /// // clang-format on future> @@ -395,8 +395,8 @@ class TargetSslProxiesClient { // clang-format off /// - /// Retrieves the list of TargetSslProxy resources available to the specified - /// project. + /// Retrieves the list of TargetSslProxy resources + /// available to the specified project. /// https://cloud.google.com/compute/docs/reference/rest/v1/targetSslProxies/list /// /// @param project Project ID for this request. @@ -422,8 +422,8 @@ class TargetSslProxiesClient { /// [`future`]: @ref google::cloud::future /// [`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_141.proto#L55} + /// [google.cloud.cpp.compute.target_ssl_proxies.v1.ListTargetSslProxiesRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_ssl_proxies/v1/target_ssl_proxies.proto#L238} + /// [google.cloud.cpp.compute.v1.TargetSslProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_167.proto#L58} /// // clang-format on StreamRange @@ -431,8 +431,8 @@ class TargetSslProxiesClient { // clang-format off /// - /// Retrieves the list of TargetSslProxy resources available to the specified - /// project. + /// Retrieves the list of TargetSslProxy resources + /// available to the specified project. /// https://cloud.google.com/compute/docs/reference/rest/v1/targetSslProxies/list /// /// @param request Unary RPCs, such as the one wrapped by this @@ -463,8 +463,8 @@ class TargetSslProxiesClient { /// [`future`]: @ref google::cloud::future /// [`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_141.proto#L55} + /// [google.cloud.cpp.compute.target_ssl_proxies.v1.ListTargetSslProxiesRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_ssl_proxies/v1/target_ssl_proxies.proto#L238} + /// [google.cloud.cpp.compute.v1.TargetSslProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_167.proto#L58} /// // clang-format on StreamRange @@ -478,8 +478,8 @@ class TargetSslProxiesClient { /// https://cloud.google.com/compute/docs/reference/rest/v1/targetSslProxies/setBackendService /// /// @param project Project ID for this request. - /// @param target_ssl_proxy Name of the TargetSslProxy resource whose BackendService resource is to be - /// set. + /// @param target_ssl_proxy Name of the TargetSslProxy resource whose BackendService resource + /// is to be set. /// @param target_ssl_proxies_set_backend_service_request_resource The TargetSslProxiesSetBackendServiceRequest for this request. /// @param opts Optional. Override the class-level options, such as retry and /// backoff policies. @@ -501,7 +501,7 @@ class TargetSslProxiesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_ssl_proxies.v1.SetBackendServiceRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_ssl_proxies/v1/target_ssl_proxies.proto#L287} + /// [google.cloud.cpp.compute.target_ssl_proxies.v1.SetBackendServiceRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_ssl_proxies/v1/target_ssl_proxies.proto#L339} /// // clang-format on future> @@ -562,7 +562,7 @@ class TargetSslProxiesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_ssl_proxies.v1.SetBackendServiceRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_ssl_proxies/v1/target_ssl_proxies.proto#L287} + /// [google.cloud.cpp.compute.target_ssl_proxies.v1.SetBackendServiceRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_ssl_proxies/v1/target_ssl_proxies.proto#L339} /// // clang-format on future> @@ -606,8 +606,8 @@ class TargetSslProxiesClient { /// https://cloud.google.com/compute/docs/reference/rest/v1/targetSslProxies/setCertificateMap /// /// @param project Project ID for this request. - /// @param target_ssl_proxy Name of the TargetSslProxy resource whose CertificateMap is to be set. The - /// name must be 1-63 characters long, and comply with RFC1035. + /// @param target_ssl_proxy Name of the TargetSslProxy resource whose CertificateMap is + /// to be set. The name must be 1-63 characters long, and comply with RFC1035. /// @param target_ssl_proxies_set_certificate_map_request_resource The TargetSslProxiesSetCertificateMapRequest for this request. /// @param opts Optional. Override the class-level options, such as retry and /// backoff policies. @@ -629,7 +629,7 @@ class TargetSslProxiesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_ssl_proxies.v1.SetCertificateMapRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_ssl_proxies/v1/target_ssl_proxies.proto#L319} + /// [google.cloud.cpp.compute.target_ssl_proxies.v1.SetCertificateMapRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_ssl_proxies/v1/target_ssl_proxies.proto#L374} /// // clang-format on future> @@ -690,7 +690,7 @@ class TargetSslProxiesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_ssl_proxies.v1.SetCertificateMapRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_ssl_proxies/v1/target_ssl_proxies.proto#L319} + /// [google.cloud.cpp.compute.target_ssl_proxies.v1.SetCertificateMapRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_ssl_proxies/v1/target_ssl_proxies.proto#L374} /// // clang-format on future> @@ -756,7 +756,7 @@ class TargetSslProxiesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_ssl_proxies.v1.SetProxyHeaderRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_ssl_proxies/v1/target_ssl_proxies.proto#L351} + /// [google.cloud.cpp.compute.target_ssl_proxies.v1.SetProxyHeaderRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_ssl_proxies/v1/target_ssl_proxies.proto#L409} /// // clang-format on future> SetProxyHeader( @@ -816,7 +816,7 @@ class TargetSslProxiesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_ssl_proxies.v1.SetProxyHeaderRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_ssl_proxies/v1/target_ssl_proxies.proto#L351} + /// [google.cloud.cpp.compute.target_ssl_proxies.v1.SetProxyHeaderRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_ssl_proxies/v1/target_ssl_proxies.proto#L409} /// // clang-format on future> SetProxyHeader( @@ -860,8 +860,8 @@ class TargetSslProxiesClient { /// https://cloud.google.com/compute/docs/reference/rest/v1/targetSslProxies/setSslCertificates /// /// @param project Project ID for this request. - /// @param target_ssl_proxy Name of the TargetSslProxy resource whose SslCertificate resource is to be - /// set. + /// @param target_ssl_proxy Name of the TargetSslProxy resource whose SslCertificate resource + /// is to be set. /// @param target_ssl_proxies_set_ssl_certificates_request_resource The TargetSslProxiesSetSslCertificatesRequest for this request. /// @param opts Optional. Override the class-level options, such as retry and /// backoff policies. @@ -883,7 +883,7 @@ class TargetSslProxiesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_ssl_proxies.v1.SetSslCertificatesRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_ssl_proxies/v1/target_ssl_proxies.proto#L382} + /// [google.cloud.cpp.compute.target_ssl_proxies.v1.SetSslCertificatesRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_ssl_proxies/v1/target_ssl_proxies.proto#L443} /// // clang-format on future> @@ -944,7 +944,7 @@ class TargetSslProxiesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_ssl_proxies.v1.SetSslCertificatesRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_ssl_proxies/v1/target_ssl_proxies.proto#L382} + /// [google.cloud.cpp.compute.target_ssl_proxies.v1.SetSslCertificatesRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_ssl_proxies/v1/target_ssl_proxies.proto#L443} /// // clang-format on future> @@ -987,13 +987,13 @@ class TargetSslProxiesClient { /// /// 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. + /// clients and the load balancer. They do not affect the + /// connection between the load balancer and the backends. /// https://cloud.google.com/compute/docs/reference/rest/v1/targetSslProxies/setSslPolicy /// /// @param project Project ID for this request. - /// @param target_ssl_proxy Name of the TargetSslProxy resource whose SSL policy is to be set. The name - /// must be 1-63 characters long, and comply with RFC1035. + /// @param target_ssl_proxy Name of the TargetSslProxy resource whose SSL policy is + /// to be set. The name must be 1-63 characters long, and comply with RFC1035. /// @param ssl_policy_reference_resource The SslPolicyReference for this request. /// @param opts Optional. Override the class-level options, such as retry and /// backoff policies. @@ -1015,7 +1015,7 @@ class TargetSslProxiesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_ssl_proxies.v1.SetSslPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_ssl_proxies/v1/target_ssl_proxies.proto#L414} + /// [google.cloud.cpp.compute.target_ssl_proxies.v1.SetSslPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_ssl_proxies/v1/target_ssl_proxies.proto#L478} /// // clang-format on future> SetSslPolicy( @@ -1046,8 +1046,8 @@ class TargetSslProxiesClient { /// /// 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. + /// clients and the load balancer. They do not affect the + /// connection between the load balancer and the backends. /// https://cloud.google.com/compute/docs/reference/rest/v1/targetSslProxies/setSslPolicy /// /// @param request Unary RPCs, such as the one wrapped by this @@ -1076,7 +1076,7 @@ class TargetSslProxiesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_ssl_proxies.v1.SetSslPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_ssl_proxies/v1/target_ssl_proxies.proto#L414} + /// [google.cloud.cpp.compute.target_ssl_proxies.v1.SetSslPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_ssl_proxies/v1/target_ssl_proxies.proto#L478} /// // clang-format on future> SetSslPolicy( @@ -1114,6 +1114,71 @@ class TargetSslProxiesClient { google::cloud::cpp::compute::v1::Operation const& operation, Options opts = {}); + // clang-format off + /// + /// Returns permissions that a caller has on the specified resource. + /// https://cloud.google.com/compute/docs/reference/rest/v1/targetSslProxies/testIamPermissions + /// + /// @param project Project ID for this request. + /// @param resource Name or id of the resource for this request. + /// @param test_permissions_request_resource The TestPermissionsRequest for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.TestPermissionsResponse]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.target_ssl_proxies.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_ssl_proxies/v1/target_ssl_proxies.proto#L512} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} + /// + // clang-format on + StatusOr + TestIamPermissions( + std::string const& project, std::string const& resource, + google::cloud::cpp::compute::v1::TestPermissionsRequest const& + test_permissions_request_resource, + Options opts = {}); + + // clang-format off + /// + /// Returns permissions that a caller has on the specified resource. + /// https://cloud.google.com/compute/docs/reference/rest/v1/targetSslProxies/testIamPermissions + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.target_ssl_proxies.v1.TestIamPermissionsRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.TestPermissionsResponse]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.target_ssl_proxies.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_ssl_proxies/v1/target_ssl_proxies.proto#L512} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} + /// + // clang-format on + StatusOr + TestIamPermissions(google::cloud::cpp::compute::target_ssl_proxies::v1:: + TestIamPermissionsRequest const& request, + Options opts = {}); + private: std::shared_ptr connection_; Options options_; diff --git a/google/cloud/compute/target_ssl_proxies/v1/target_ssl_proxies_connection.cc b/google/cloud/compute/target_ssl_proxies/v1/target_ssl_proxies_connection.cc index 1b58fa96b51ba..92c8bff7d0b2f 100644 --- a/google/cloud/compute/target_ssl_proxies/v1/target_ssl_proxies_connection.cc +++ b/google/cloud/compute/target_ssl_proxies/v1/target_ssl_proxies_connection.cc @@ -226,6 +226,13 @@ TargetSslProxiesConnection::SetSslPolicy( Status(StatusCode::kUnimplemented, "not implemented")); } +StatusOr +TargetSslProxiesConnection::TestIamPermissions( + google::cloud::cpp::compute::target_ssl_proxies::v1:: + TestIamPermissionsRequest const&) { + return Status(StatusCode::kUnimplemented, "not implemented"); +} + GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END } // namespace compute_target_ssl_proxies_v1 } // namespace cloud diff --git a/google/cloud/compute/target_ssl_proxies/v1/target_ssl_proxies_connection.h b/google/cloud/compute/target_ssl_proxies/v1/target_ssl_proxies_connection.h index f616b746a18a3..e2f9ac626db55 100644 --- a/google/cloud/compute/target_ssl_proxies/v1/target_ssl_proxies_connection.h +++ b/google/cloud/compute/target_ssl_proxies/v1/target_ssl_proxies_connection.h @@ -281,6 +281,10 @@ class TargetSslProxiesConnection { virtual future> SetSslPolicy(google::cloud::cpp::compute::v1::Operation const& operation); + + virtual StatusOr + TestIamPermissions(google::cloud::cpp::compute::target_ssl_proxies::v1:: + TestIamPermissionsRequest const& request); }; GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END diff --git a/google/cloud/compute/target_ssl_proxies/v1/target_ssl_proxies_connection_idempotency_policy.cc b/google/cloud/compute/target_ssl_proxies/v1/target_ssl_proxies_connection_idempotency_policy.cc index 0b59b28559506..caff0b57b7b29 100644 --- a/google/cloud/compute/target_ssl_proxies/v1/target_ssl_proxies_connection_idempotency_policy.cc +++ b/google/cloud/compute/target_ssl_proxies/v1/target_ssl_proxies_connection_idempotency_policy.cc @@ -88,6 +88,12 @@ Idempotency TargetSslProxiesConnectionIdempotencyPolicy::SetSslPolicy( return Idempotency::kNonIdempotent; } +Idempotency TargetSslProxiesConnectionIdempotencyPolicy::TestIamPermissions( + google::cloud::cpp::compute::target_ssl_proxies::v1:: + TestIamPermissionsRequest const&) { + return Idempotency::kNonIdempotent; +} + std::unique_ptr MakeDefaultTargetSslProxiesConnectionIdempotencyPolicy() { return std::make_unique(); diff --git a/google/cloud/compute/target_ssl_proxies/v1/target_ssl_proxies_connection_idempotency_policy.h b/google/cloud/compute/target_ssl_proxies/v1/target_ssl_proxies_connection_idempotency_policy.h index 354e5032c8d85..6623b2f6ba6ea 100644 --- a/google/cloud/compute/target_ssl_proxies/v1/target_ssl_proxies_connection_idempotency_policy.h +++ b/google/cloud/compute/target_ssl_proxies/v1/target_ssl_proxies_connection_idempotency_policy.h @@ -72,6 +72,10 @@ class TargetSslProxiesConnectionIdempotencyPolicy { virtual google::cloud::Idempotency SetSslPolicy( google::cloud::cpp::compute::target_ssl_proxies::v1:: SetSslPolicyRequest const& request); + + virtual google::cloud::Idempotency TestIamPermissions( + google::cloud::cpp::compute::target_ssl_proxies::v1:: + TestIamPermissionsRequest const& request); }; std::unique_ptr 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 2518416d36cba..dcc829743c21d 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,10 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_TARGET_SSL_PROXIES_V1_TARGET_SSL_PROXIES_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_129.pb.h" -#include "google/cloud/compute/v1/internal/common_141.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_154.pb.h" +#include "google/cloud/compute/v1/internal/common_167.pb.h" +#include "google/cloud/compute/v1/internal/common_171.pb.h" // 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/internal/target_tcp_proxies_rest_connection_impl.cc b/google/cloud/compute/target_tcp_proxies/v1/internal/target_tcp_proxies_rest_connection_impl.cc index a0a2d5545b58b..8ef32c050a53d 100644 --- a/google/cloud/compute/target_tcp_proxies/v1/internal/target_tcp_proxies_rest_connection_impl.cc +++ b/google/cloud/compute/target_tcp_proxies/v1/internal/target_tcp_proxies_rest_connection_impl.cc @@ -651,6 +651,22 @@ TargetTcpProxiesRestConnectionImpl::SetProxyHeader( }); } +StatusOr +TargetTcpProxiesRestConnectionImpl::TestIamPermissions( + google::cloud::cpp::compute::target_tcp_proxies::v1:: + TestIamPermissionsRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->TestIamPermissions(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::target_tcp_proxies::v1:: + TestIamPermissionsRequest const& request) { + return stub_->TestIamPermissions(rest_context, options, request); + }, + *current, request, __func__); +} + GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END } // namespace compute_target_tcp_proxies_v1_internal } // namespace cloud diff --git a/google/cloud/compute/target_tcp_proxies/v1/internal/target_tcp_proxies_rest_connection_impl.h b/google/cloud/compute/target_tcp_proxies/v1/internal/target_tcp_proxies_rest_connection_impl.h index 8db7fb3d62c69..a9a49168bf9f4 100644 --- a/google/cloud/compute/target_tcp_proxies/v1/internal/target_tcp_proxies_rest_connection_impl.h +++ b/google/cloud/compute/target_tcp_proxies/v1/internal/target_tcp_proxies_rest_connection_impl.h @@ -113,6 +113,10 @@ class TargetTcpProxiesRestConnectionImpl future> SetProxyHeader( google::cloud::cpp::compute::v1::Operation const& operation) override; + StatusOr + TestIamPermissions(google::cloud::cpp::compute::target_tcp_proxies::v1:: + TestIamPermissionsRequest const& request) override; + private: static std::unique_ptr< compute_target_tcp_proxies_v1::TargetTcpProxiesRetryPolicy> diff --git a/google/cloud/compute/target_tcp_proxies/v1/internal/target_tcp_proxies_rest_logging_decorator.cc b/google/cloud/compute/target_tcp_proxies/v1/internal/target_tcp_proxies_rest_logging_decorator.cc index e45567710e2cd..8d90cac360b2e 100644 --- a/google/cloud/compute/target_tcp_proxies/v1/internal/target_tcp_proxies_rest_logging_decorator.cc +++ b/google/cloud/compute/target_tcp_proxies/v1/internal/target_tcp_proxies_rest_logging_decorator.cc @@ -213,6 +213,20 @@ TargetTcpProxiesRestLogging::SetProxyHeader( rest_context, options, request, __func__, tracing_options_); } +StatusOr +TargetTcpProxiesRestLogging::TestIamPermissions( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::target_tcp_proxies::v1:: + TestIamPermissionsRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::target_tcp_proxies::v1:: + TestIamPermissionsRequest const& request) { + return child_->TestIamPermissions(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + future> TargetTcpProxiesRestLogging::AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/target_tcp_proxies/v1/internal/target_tcp_proxies_rest_logging_decorator.h b/google/cloud/compute/target_tcp_proxies/v1/internal/target_tcp_proxies_rest_logging_decorator.h index 32a13953a0756..01c16f15f2a25 100644 --- a/google/cloud/compute/target_tcp_proxies/v1/internal/target_tcp_proxies_rest_logging_decorator.h +++ b/google/cloud/compute/target_tcp_proxies/v1/internal/target_tcp_proxies_rest_logging_decorator.h @@ -117,6 +117,12 @@ class TargetTcpProxiesRestLogging : public TargetTcpProxiesRestStub { google::cloud::cpp::compute::target_tcp_proxies::v1:: SetProxyHeaderRequest const& request) override; + StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::target_tcp_proxies::v1:: + TestIamPermissionsRequest const& request) override; + future> AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/target_tcp_proxies/v1/internal/target_tcp_proxies_rest_metadata_decorator.cc b/google/cloud/compute/target_tcp_proxies/v1/internal/target_tcp_proxies_rest_metadata_decorator.cc index 561a8472587bb..cec3d503a9fb7 100644 --- a/google/cloud/compute/target_tcp_proxies/v1/internal/target_tcp_proxies_rest_metadata_decorator.cc +++ b/google/cloud/compute/target_tcp_proxies/v1/internal/target_tcp_proxies_rest_metadata_decorator.cc @@ -150,6 +150,15 @@ TargetTcpProxiesRestMetadata::SetProxyHeader( return child_->SetProxyHeader(rest_context, options, request); } +StatusOr +TargetTcpProxiesRestMetadata::TestIamPermissions( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::target_tcp_proxies::v1:: + TestIamPermissionsRequest const& request) { + SetMetadata(rest_context, options); + return child_->TestIamPermissions(rest_context, options, request); +} + future> TargetTcpProxiesRestMetadata::AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/target_tcp_proxies/v1/internal/target_tcp_proxies_rest_metadata_decorator.h b/google/cloud/compute/target_tcp_proxies/v1/internal/target_tcp_proxies_rest_metadata_decorator.h index 857d0dbd28f4f..c8aa9247291c9 100644 --- a/google/cloud/compute/target_tcp_proxies/v1/internal/target_tcp_proxies_rest_metadata_decorator.h +++ b/google/cloud/compute/target_tcp_proxies/v1/internal/target_tcp_proxies_rest_metadata_decorator.h @@ -115,6 +115,12 @@ class TargetTcpProxiesRestMetadata : public TargetTcpProxiesRestStub { google::cloud::cpp::compute::target_tcp_proxies::v1:: SetProxyHeaderRequest const& request) override; + StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::target_tcp_proxies::v1:: + TestIamPermissionsRequest const& request) override; + google::cloud::future> AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/target_tcp_proxies/v1/internal/target_tcp_proxies_rest_stub.cc b/google/cloud/compute/target_tcp_proxies/v1/internal/target_tcp_proxies_rest_stub.cc index 7f88bcaebe19a..ca9ae2ba401ef 100644 --- a/google/cloud/compute/target_tcp_proxies/v1/internal/target_tcp_proxies_rest_stub.cc +++ b/google/cloud/compute/target_tcp_proxies/v1/internal/target_tcp_proxies_rest_stub.cc @@ -352,6 +352,25 @@ DefaultTargetTcpProxiesRestStub::SetProxyHeader( std::move(query_params)); } +StatusOr +DefaultTargetTcpProxiesRestStub::TestIamPermissions( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::target_tcp_proxies::v1:: + TestIamPermissionsRequest const& request) { + std::vector> query_params; + return rest_internal::Post< + google::cloud::cpp::compute::v1::TestPermissionsResponse>( + *service_, rest_context, request.test_permissions_request_resource(), + false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "global", "/", + "targetTcpProxies", "/", request.resource(), "/", + "testIamPermissions"), + std::move(query_params)); +} + future> DefaultTargetTcpProxiesRestStub::AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/target_tcp_proxies/v1/internal/target_tcp_proxies_rest_stub.h b/google/cloud/compute/target_tcp_proxies/v1/internal/target_tcp_proxies_rest_stub.h index 4b88f8554ec80..e70d278cf889e 100644 --- a/google/cloud/compute/target_tcp_proxies/v1/internal/target_tcp_proxies_rest_stub.h +++ b/google/cloud/compute/target_tcp_proxies/v1/internal/target_tcp_proxies_rest_stub.h @@ -113,6 +113,12 @@ class TargetTcpProxiesRestStub { google::cloud::cpp::compute::target_tcp_proxies::v1:: SetProxyHeaderRequest const& request) = 0; + virtual StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::target_tcp_proxies::v1:: + TestIamPermissionsRequest const& request) = 0; + virtual future> AsyncGetOperation( google::cloud::CompletionQueue& cq, @@ -213,6 +219,12 @@ class DefaultTargetTcpProxiesRestStub : public TargetTcpProxiesRestStub { google::cloud::cpp::compute::target_tcp_proxies::v1:: SetProxyHeaderRequest const& request) override; + StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::target_tcp_proxies::v1:: + TestIamPermissionsRequest const& request) override; + future> AsyncGetOperation( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/target_tcp_proxies/v1/internal/target_tcp_proxies_tracing_connection.cc b/google/cloud/compute/target_tcp_proxies/v1/internal/target_tcp_proxies_tracing_connection.cc index 90c2c77e2bf1a..ed0d400111687 100644 --- a/google/cloud/compute/target_tcp_proxies/v1/internal/target_tcp_proxies_tracing_connection.cc +++ b/google/cloud/compute/target_tcp_proxies/v1/internal/target_tcp_proxies_tracing_connection.cc @@ -210,6 +210,17 @@ TargetTcpProxiesTracingConnection::SetProxyHeader( return internal::EndSpan(std::move(span), child_->SetProxyHeader(operation)); } +StatusOr +TargetTcpProxiesTracingConnection::TestIamPermissions( + google::cloud::cpp::compute::target_tcp_proxies::v1:: + TestIamPermissionsRequest const& request) { + auto span = internal::MakeSpan( + "compute_target_tcp_proxies_v1::TargetTcpProxiesConnection::" + "TestIamPermissions"); + auto scope = opentelemetry::trace::Scope(span); + return internal::EndSpan(*span, child_->TestIamPermissions(request)); +} + std::shared_ptr MakeTargetTcpProxiesTracingConnection( std::shared_ptr diff --git a/google/cloud/compute/target_tcp_proxies/v1/internal/target_tcp_proxies_tracing_connection.h b/google/cloud/compute/target_tcp_proxies/v1/internal/target_tcp_proxies_tracing_connection.h index 7e47641266caa..96bb6df055820 100644 --- a/google/cloud/compute/target_tcp_proxies/v1/internal/target_tcp_proxies_tracing_connection.h +++ b/google/cloud/compute/target_tcp_proxies/v1/internal/target_tcp_proxies_tracing_connection.h @@ -100,6 +100,10 @@ class TargetTcpProxiesTracingConnection future> SetProxyHeader( google::cloud::cpp::compute::v1::Operation const& operation) override; + StatusOr + TestIamPermissions(google::cloud::cpp::compute::target_tcp_proxies::v1:: + TestIamPermissionsRequest const& request) override; + private: std::shared_ptr child_; diff --git a/google/cloud/compute/target_tcp_proxies/v1/mocks/mock_target_tcp_proxies_connection.h b/google/cloud/compute/target_tcp_proxies/v1/mocks/mock_target_tcp_proxies_connection.h index 239416c9284d4..ff1a0d6da9556 100644 --- a/google/cloud/compute/target_tcp_proxies/v1/mocks/mock_target_tcp_proxies_connection.h +++ b/google/cloud/compute/target_tcp_proxies/v1/mocks/mock_target_tcp_proxies_connection.h @@ -230,6 +230,13 @@ class MockTargetTcpProxiesConnection SetProxyHeader, (google::cloud::cpp::compute::v1::Operation const& operation), (override)); + + MOCK_METHOD( + StatusOr, + TestIamPermissions, + (google::cloud::cpp::compute::target_tcp_proxies::v1:: + TestIamPermissionsRequest const& request), + (override)); }; GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END diff --git a/google/cloud/compute/target_tcp_proxies/v1/target_tcp_proxies_client.cc b/google/cloud/compute/target_tcp_proxies/v1/target_tcp_proxies_client.cc index aedbb6ea84398..08c361b2d9072 100644 --- a/google/cloud/compute/target_tcp_proxies/v1/target_tcp_proxies_client.cc +++ b/google/cloud/compute/target_tcp_proxies/v1/target_tcp_proxies_client.cc @@ -317,6 +317,31 @@ TargetTcpProxiesClient::SetProxyHeader( return connection_->SetProxyHeader(operation); } +StatusOr +TargetTcpProxiesClient::TestIamPermissions( + std::string const& project, std::string const& resource, + google::cloud::cpp::compute::v1::TestPermissionsRequest const& + test_permissions_request_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::target_tcp_proxies::v1::TestIamPermissionsRequest + request; + request.set_project(project); + request.set_resource(resource); + *request.mutable_test_permissions_request_resource() = + test_permissions_request_resource; + return connection_->TestIamPermissions(request); +} + +StatusOr +TargetTcpProxiesClient::TestIamPermissions( + google::cloud::cpp::compute::target_tcp_proxies::v1:: + TestIamPermissionsRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->TestIamPermissions(request); +} + GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END } // namespace compute_target_tcp_proxies_v1 } // namespace cloud 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 949fbb0c58535..5603f6b9aa817 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 @@ -92,8 +92,10 @@ class TargetTcpProxiesClient { // clang-format off /// /// 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`. + /// available to the specified project. + /// + /// To prevent failure, Google recommends that you set the + /// `returnPartialSuccess` parameter to `true`. /// https://cloud.google.com/compute/docs/reference/rest/v1/targetTcpProxies/aggregatedList /// /// @param project Name of the project scoping this request. @@ -119,8 +121,8 @@ class TargetTcpProxiesClient { /// [`future`]: @ref google::cloud::future /// [`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_142.proto#L26} + /// [google.cloud.cpp.compute.target_tcp_proxies.v1.AggregatedListTargetTcpProxiesRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_tcp_proxies/v1/target_tcp_proxies.proto#L141} + /// [google.cloud.cpp.compute.v1.TargetTcpProxiesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_168.proto#L26} /// // clang-format on StreamRange> @@ -253,7 +257,7 @@ class TargetTcpProxiesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_tcp_proxies.v1.DeleteTargetTcpProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_tcp_proxies/v1/target_tcp_proxies.proto#L208} + /// [google.cloud.cpp.compute.target_tcp_proxies.v1.DeleteTargetTcpProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_tcp_proxies/v1/target_tcp_proxies.proto#L256} /// // clang-format on future> @@ -312,8 +316,8 @@ class TargetTcpProxiesClient { /// [`future`]: @ref google::cloud::future /// [`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_143.proto#L28} + /// [google.cloud.cpp.compute.target_tcp_proxies.v1.GetTargetTcpProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_tcp_proxies/v1/target_tcp_proxies.proto#L285} + /// [google.cloud.cpp.compute.v1.TargetTcpProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_169.proto#L30} /// // clang-format on StatusOr GetTargetTcpProxy( @@ -344,8 +348,8 @@ class TargetTcpProxiesClient { /// [`future`]: @ref google::cloud::future /// [`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_143.proto#L28} + /// [google.cloud.cpp.compute.target_tcp_proxies.v1.GetTargetTcpProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_tcp_proxies/v1/target_tcp_proxies.proto#L285} + /// [google.cloud.cpp.compute.v1.TargetTcpProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_169.proto#L30} /// // clang-format on StatusOr GetTargetTcpProxy( @@ -355,8 +359,8 @@ class TargetTcpProxiesClient { // clang-format off /// - /// Creates a TargetTcpProxy resource in the specified project using the data - /// included in the request. + /// Creates a TargetTcpProxy resource in the specified project using + /// the data included in the request. /// https://cloud.google.com/compute/docs/reference/rest/v1/targetTcpProxies/insert /// /// @param project Project ID for this request. @@ -381,7 +385,7 @@ class TargetTcpProxiesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_tcp_proxies.v1.InsertTargetTcpProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_tcp_proxies/v1/target_tcp_proxies.proto#L245} + /// [google.cloud.cpp.compute.target_tcp_proxies.v1.InsertTargetTcpProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_tcp_proxies/v1/target_tcp_proxies.proto#L296} /// // clang-format on future> @@ -409,8 +413,8 @@ class TargetTcpProxiesClient { // clang-format off /// - /// Creates a TargetTcpProxy resource in the specified project using the data - /// included in the request. + /// Creates a TargetTcpProxy resource in the specified project using + /// the data included in the request. /// https://cloud.google.com/compute/docs/reference/rest/v1/targetTcpProxies/insert /// /// @param request Unary RPCs, such as the one wrapped by this @@ -439,7 +443,7 @@ class TargetTcpProxiesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_tcp_proxies.v1.InsertTargetTcpProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_tcp_proxies/v1/target_tcp_proxies.proto#L245} + /// [google.cloud.cpp.compute.target_tcp_proxies.v1.InsertTargetTcpProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_tcp_proxies/v1/target_tcp_proxies.proto#L296} /// // clang-format on future> @@ -480,8 +484,8 @@ class TargetTcpProxiesClient { // clang-format off /// - /// Retrieves the list of TargetTcpProxy resources available to the specified - /// project. + /// Retrieves the list of TargetTcpProxy resources + /// available to the specified project. /// https://cloud.google.com/compute/docs/reference/rest/v1/targetTcpProxies/list /// /// @param project Project ID for this request. @@ -507,8 +511,8 @@ class TargetTcpProxiesClient { /// [`future`]: @ref google::cloud::future /// [`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_143.proto#L28} + /// [google.cloud.cpp.compute.target_tcp_proxies.v1.ListTargetTcpProxiesRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_tcp_proxies/v1/target_tcp_proxies.proto#L325} + /// [google.cloud.cpp.compute.v1.TargetTcpProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_169.proto#L30} /// // clang-format on StreamRange @@ -516,8 +520,8 @@ class TargetTcpProxiesClient { // clang-format off /// - /// Retrieves the list of TargetTcpProxy resources available to the specified - /// project. + /// Retrieves the list of TargetTcpProxy resources + /// available to the specified project. /// https://cloud.google.com/compute/docs/reference/rest/v1/targetTcpProxies/list /// /// @param request Unary RPCs, such as the one wrapped by this @@ -548,8 +552,8 @@ class TargetTcpProxiesClient { /// [`future`]: @ref google::cloud::future /// [`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_143.proto#L28} + /// [google.cloud.cpp.compute.target_tcp_proxies.v1.ListTargetTcpProxiesRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_tcp_proxies/v1/target_tcp_proxies.proto#L325} + /// [google.cloud.cpp.compute.v1.TargetTcpProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_169.proto#L30} /// // clang-format on StreamRange @@ -563,8 +567,8 @@ class TargetTcpProxiesClient { /// https://cloud.google.com/compute/docs/reference/rest/v1/targetTcpProxies/setBackendService /// /// @param project Project ID for this request. - /// @param target_tcp_proxy Name of the TargetTcpProxy resource whose BackendService resource is to be - /// set. + /// @param target_tcp_proxy Name of the TargetTcpProxy resource whose BackendService resource + /// is to be set. /// @param target_tcp_proxies_set_backend_service_request_resource The TargetTcpProxiesSetBackendServiceRequest for this request. /// @param opts Optional. Override the class-level options, such as retry and /// backoff policies. @@ -586,7 +590,7 @@ class TargetTcpProxiesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_tcp_proxies.v1.SetBackendServiceRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_tcp_proxies/v1/target_tcp_proxies.proto#L339} + /// [google.cloud.cpp.compute.target_tcp_proxies.v1.SetBackendServiceRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_tcp_proxies/v1/target_tcp_proxies.proto#L426} /// // clang-format on future> @@ -647,7 +651,7 @@ class TargetTcpProxiesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_tcp_proxies.v1.SetBackendServiceRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_tcp_proxies/v1/target_tcp_proxies.proto#L339} + /// [google.cloud.cpp.compute.target_tcp_proxies.v1.SetBackendServiceRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_tcp_proxies/v1/target_tcp_proxies.proto#L426} /// // clang-format on future> @@ -713,7 +717,7 @@ class TargetTcpProxiesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_tcp_proxies.v1.SetProxyHeaderRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_tcp_proxies/v1/target_tcp_proxies.proto#L371} + /// [google.cloud.cpp.compute.target_tcp_proxies.v1.SetProxyHeaderRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_tcp_proxies/v1/target_tcp_proxies.proto#L461} /// // clang-format on future> SetProxyHeader( @@ -773,7 +777,7 @@ class TargetTcpProxiesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_tcp_proxies.v1.SetProxyHeaderRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_tcp_proxies/v1/target_tcp_proxies.proto#L371} + /// [google.cloud.cpp.compute.target_tcp_proxies.v1.SetProxyHeaderRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_tcp_proxies/v1/target_tcp_proxies.proto#L461} /// // clang-format on future> SetProxyHeader( @@ -811,6 +815,71 @@ class TargetTcpProxiesClient { google::cloud::cpp::compute::v1::Operation const& operation, Options opts = {}); + // clang-format off + /// + /// Returns permissions that a caller has on the specified resource. + /// https://cloud.google.com/compute/docs/reference/rest/v1/targetTcpProxies/testIamPermissions + /// + /// @param project Project ID for this request. + /// @param resource Name or id of the resource for this request. + /// @param test_permissions_request_resource The TestPermissionsRequest for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.TestPermissionsResponse]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.target_tcp_proxies.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_tcp_proxies/v1/target_tcp_proxies.proto#L495} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} + /// + // clang-format on + StatusOr + TestIamPermissions( + std::string const& project, std::string const& resource, + google::cloud::cpp::compute::v1::TestPermissionsRequest const& + test_permissions_request_resource, + Options opts = {}); + + // clang-format off + /// + /// Returns permissions that a caller has on the specified resource. + /// https://cloud.google.com/compute/docs/reference/rest/v1/targetTcpProxies/testIamPermissions + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.target_tcp_proxies.v1.TestIamPermissionsRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.TestPermissionsResponse]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.target_tcp_proxies.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_tcp_proxies/v1/target_tcp_proxies.proto#L495} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} + /// + // clang-format on + StatusOr + TestIamPermissions(google::cloud::cpp::compute::target_tcp_proxies::v1:: + TestIamPermissionsRequest const& request, + Options opts = {}); + private: std::shared_ptr connection_; Options options_; diff --git a/google/cloud/compute/target_tcp_proxies/v1/target_tcp_proxies_connection.cc b/google/cloud/compute/target_tcp_proxies/v1/target_tcp_proxies_connection.cc index fd96e6d86fb19..261cda0443f06 100644 --- a/google/cloud/compute/target_tcp_proxies/v1/target_tcp_proxies_connection.cc +++ b/google/cloud/compute/target_tcp_proxies/v1/target_tcp_proxies_connection.cc @@ -161,6 +161,13 @@ TargetTcpProxiesConnection::SetProxyHeader( Status(StatusCode::kUnimplemented, "not implemented")); } +StatusOr +TargetTcpProxiesConnection::TestIamPermissions( + google::cloud::cpp::compute::target_tcp_proxies::v1:: + TestIamPermissionsRequest const&) { + return Status(StatusCode::kUnimplemented, "not implemented"); +} + GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END } // namespace compute_target_tcp_proxies_v1 } // namespace cloud diff --git a/google/cloud/compute/target_tcp_proxies/v1/target_tcp_proxies_connection.h b/google/cloud/compute/target_tcp_proxies/v1/target_tcp_proxies_connection.h index a03358010eee0..d38e6cf741299 100644 --- a/google/cloud/compute/target_tcp_proxies/v1/target_tcp_proxies_connection.h +++ b/google/cloud/compute/target_tcp_proxies/v1/target_tcp_proxies_connection.h @@ -250,6 +250,10 @@ class TargetTcpProxiesConnection { virtual future> SetProxyHeader(google::cloud::cpp::compute::v1::Operation const& operation); + + virtual StatusOr + TestIamPermissions(google::cloud::cpp::compute::target_tcp_proxies::v1:: + TestIamPermissionsRequest const& request); }; GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END diff --git a/google/cloud/compute/target_tcp_proxies/v1/target_tcp_proxies_connection_idempotency_policy.cc b/google/cloud/compute/target_tcp_proxies/v1/target_tcp_proxies_connection_idempotency_policy.cc index c7ae5324b4d91..9369e7e081223 100644 --- a/google/cloud/compute/target_tcp_proxies/v1/target_tcp_proxies_connection_idempotency_policy.cc +++ b/google/cloud/compute/target_tcp_proxies/v1/target_tcp_proxies_connection_idempotency_policy.cc @@ -77,6 +77,12 @@ Idempotency TargetTcpProxiesConnectionIdempotencyPolicy::SetProxyHeader( return Idempotency::kNonIdempotent; } +Idempotency TargetTcpProxiesConnectionIdempotencyPolicy::TestIamPermissions( + google::cloud::cpp::compute::target_tcp_proxies::v1:: + TestIamPermissionsRequest const&) { + return Idempotency::kNonIdempotent; +} + std::unique_ptr MakeDefaultTargetTcpProxiesConnectionIdempotencyPolicy() { return std::make_unique(); diff --git a/google/cloud/compute/target_tcp_proxies/v1/target_tcp_proxies_connection_idempotency_policy.h b/google/cloud/compute/target_tcp_proxies/v1/target_tcp_proxies_connection_idempotency_policy.h index 71168c8ed4cb7..afd31ecafd809 100644 --- a/google/cloud/compute/target_tcp_proxies/v1/target_tcp_proxies_connection_idempotency_policy.h +++ b/google/cloud/compute/target_tcp_proxies/v1/target_tcp_proxies_connection_idempotency_policy.h @@ -64,6 +64,10 @@ class TargetTcpProxiesConnectionIdempotencyPolicy { virtual google::cloud::Idempotency SetProxyHeader( google::cloud::cpp::compute::target_tcp_proxies::v1:: SetProxyHeaderRequest const& request); + + virtual google::cloud::Idempotency TestIamPermissions( + google::cloud::cpp::compute::target_tcp_proxies::v1:: + TestIamPermissionsRequest const& request); }; std::unique_ptr 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 d8adacff18dd7..1be41f8a8abd6 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,10 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_TARGET_TCP_PROXIES_V1_TARGET_TCP_PROXIES_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_142.pb.h" -#include "google/cloud/compute/v1/internal/common_143.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_168.pb.h" +#include "google/cloud/compute/v1/internal/common_169.pb.h" +#include "google/cloud/compute/v1/internal/common_171.pb.h" // 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 1dc466eb2582a..dea7c02976b36 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 @@ -91,9 +91,10 @@ class TargetVpnGatewaysClient { // clang-format off /// - /// Retrieves an aggregated list of target VPN gateways. To prevent failure, - /// Google recommends that you set the `returnPartialSuccess` parameter to - /// `true`. + /// Retrieves an aggregated list of target VPN gateways. + /// + /// To prevent failure, Google recommends that you set the + /// `returnPartialSuccess` parameter to `true`. /// https://cloud.google.com/compute/docs/reference/rest/v1/targetVpnGateways/aggregatedList /// /// @param project Project ID for this request. @@ -119,8 +120,8 @@ class TargetVpnGatewaysClient { /// [`future`]: @ref google::cloud::future /// [`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_144.proto#L317} + /// [google.cloud.cpp.compute.target_vpn_gateways.v1.AggregatedListTargetVpnGatewaysRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_vpn_gateways/v1/target_vpn_gateways.proto#L117} + /// [google.cloud.cpp.compute.v1.TargetVpnGatewaysScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_170.proto#L389} /// // clang-format on StreamRange< @@ -131,9 +132,10 @@ class TargetVpnGatewaysClient { // clang-format off /// - /// Retrieves an aggregated list of target VPN gateways. To prevent failure, - /// Google recommends that you set the `returnPartialSuccess` parameter to - /// `true`. + /// Retrieves an aggregated list of target VPN gateways. + /// + /// To prevent failure, Google recommends that you set the + /// `returnPartialSuccess` parameter to `true`. /// https://cloud.google.com/compute/docs/reference/rest/v1/targetVpnGateways/aggregatedList /// /// @param request Unary RPCs, such as the one wrapped by this @@ -164,8 +166,8 @@ class TargetVpnGatewaysClient { /// [`future`]: @ref google::cloud::future /// [`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_144.proto#L317} + /// [google.cloud.cpp.compute.target_vpn_gateways.v1.AggregatedListTargetVpnGatewaysRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_vpn_gateways/v1/target_vpn_gateways.proto#L117} + /// [google.cloud.cpp.compute.v1.TargetVpnGatewaysScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_170.proto#L389} /// // clang-format on StreamRange< @@ -204,7 +206,7 @@ class TargetVpnGatewaysClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_vpn_gateways.v1.DeleteTargetVpnGatewayRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_vpn_gateways/v1/target_vpn_gateways.proto#L197} + /// [google.cloud.cpp.compute.target_vpn_gateways.v1.DeleteTargetVpnGatewayRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_vpn_gateways/v1/target_vpn_gateways.proto#L232} /// // clang-format on future> @@ -258,7 +260,7 @@ class TargetVpnGatewaysClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_vpn_gateways.v1.DeleteTargetVpnGatewayRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_vpn_gateways/v1/target_vpn_gateways.proto#L197} + /// [google.cloud.cpp.compute.target_vpn_gateways.v1.DeleteTargetVpnGatewayRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_vpn_gateways/v1/target_vpn_gateways.proto#L232} /// // clang-format on future> @@ -318,8 +320,8 @@ class TargetVpnGatewaysClient { /// [`future`]: @ref google::cloud::future /// [`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_144.proto#L27} + /// [google.cloud.cpp.compute.target_vpn_gateways.v1.GetTargetVpnGatewayRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_vpn_gateways/v1/target_vpn_gateways.proto#L268} + /// [google.cloud.cpp.compute.v1.TargetVpnGateway]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_170.proto#L29} /// // clang-format on StatusOr @@ -350,8 +352,8 @@ class TargetVpnGatewaysClient { /// [`future`]: @ref google::cloud::future /// [`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_144.proto#L27} + /// [google.cloud.cpp.compute.target_vpn_gateways.v1.GetTargetVpnGatewayRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_vpn_gateways/v1/target_vpn_gateways.proto#L268} + /// [google.cloud.cpp.compute.v1.TargetVpnGateway]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_170.proto#L29} /// // clang-format on StatusOr @@ -361,8 +363,8 @@ class TargetVpnGatewaysClient { // clang-format off /// - /// Creates a target VPN gateway in the specified project and region using the - /// data included in the request. + /// Creates a target VPN gateway in the specified project and region using + /// the data included in the request. /// https://cloud.google.com/compute/docs/reference/rest/v1/targetVpnGateways/insert /// /// @param project Project ID for this request. @@ -388,7 +390,7 @@ class TargetVpnGatewaysClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_vpn_gateways.v1.InsertTargetVpnGatewayRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_vpn_gateways/v1/target_vpn_gateways.proto#L245} + /// [google.cloud.cpp.compute.target_vpn_gateways.v1.InsertTargetVpnGatewayRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_vpn_gateways/v1/target_vpn_gateways.proto#L283} /// // clang-format on future> @@ -417,8 +419,8 @@ class TargetVpnGatewaysClient { // clang-format off /// - /// Creates a target VPN gateway in the specified project and region using the - /// data included in the request. + /// Creates a target VPN gateway in the specified project and region using + /// the data included in the request. /// https://cloud.google.com/compute/docs/reference/rest/v1/targetVpnGateways/insert /// /// @param request Unary RPCs, such as the one wrapped by this @@ -447,7 +449,7 @@ class TargetVpnGatewaysClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_vpn_gateways.v1.InsertTargetVpnGatewayRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_vpn_gateways/v1/target_vpn_gateways.proto#L245} + /// [google.cloud.cpp.compute.target_vpn_gateways.v1.InsertTargetVpnGatewayRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_vpn_gateways/v1/target_vpn_gateways.proto#L283} /// // clang-format on future> @@ -488,8 +490,8 @@ class TargetVpnGatewaysClient { // clang-format off /// - /// Retrieves a list of target VPN gateways available to the specified project - /// and region. + /// Retrieves a list of target VPN gateways available to the specified + /// project and region. /// https://cloud.google.com/compute/docs/reference/rest/v1/targetVpnGateways/list /// /// @param project Project ID for this request. @@ -516,8 +518,8 @@ class TargetVpnGatewaysClient { /// [`future`]: @ref google::cloud::future /// [`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_144.proto#L27} + /// [google.cloud.cpp.compute.target_vpn_gateways.v1.ListTargetVpnGatewaysRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_vpn_gateways/v1/target_vpn_gateways.proto#L319} + /// [google.cloud.cpp.compute.v1.TargetVpnGateway]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_170.proto#L29} /// // clang-format on StreamRange @@ -526,8 +528,8 @@ class TargetVpnGatewaysClient { // clang-format off /// - /// Retrieves a list of target VPN gateways available to the specified project - /// and region. + /// Retrieves a list of target VPN gateways available to the specified + /// project and region. /// https://cloud.google.com/compute/docs/reference/rest/v1/targetVpnGateways/list /// /// @param request Unary RPCs, such as the one wrapped by this @@ -558,8 +560,8 @@ class TargetVpnGatewaysClient { /// [`future`]: @ref google::cloud::future /// [`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_144.proto#L27} + /// [google.cloud.cpp.compute.target_vpn_gateways.v1.ListTargetVpnGatewaysRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_vpn_gateways/v1/target_vpn_gateways.proto#L319} + /// [google.cloud.cpp.compute.v1.TargetVpnGateway]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_170.proto#L29} /// // clang-format on StreamRange @@ -569,8 +571,9 @@ class TargetVpnGatewaysClient { // clang-format off /// - /// Sets the labels on a TargetVpnGateway. To learn more about labels, read the - /// Labeling Resources documentation. + /// Sets the labels on a TargetVpnGateway. To learn more about labels, read + /// theLabeling + /// Resources documentation. /// https://cloud.google.com/compute/docs/reference/rest/v1/targetVpnGateways/setLabels /// /// @param project Project ID for this request. @@ -597,7 +600,7 @@ class TargetVpnGatewaysClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_vpn_gateways.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_vpn_gateways/v1/target_vpn_gateways.proto#L350} + /// [google.cloud.cpp.compute.target_vpn_gateways.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_vpn_gateways/v1/target_vpn_gateways.proto#L424} /// // clang-format on future> SetLabels( @@ -627,8 +630,9 @@ class TargetVpnGatewaysClient { // clang-format off /// - /// Sets the labels on a TargetVpnGateway. To learn more about labels, read the - /// Labeling Resources documentation. + /// Sets the labels on a TargetVpnGateway. To learn more about labels, read + /// theLabeling + /// Resources documentation. /// https://cloud.google.com/compute/docs/reference/rest/v1/targetVpnGateways/setLabels /// /// @param request Unary RPCs, such as the one wrapped by this @@ -657,7 +661,7 @@ class TargetVpnGatewaysClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.target_vpn_gateways.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_vpn_gateways/v1/target_vpn_gateways.proto#L350} + /// [google.cloud.cpp.compute.target_vpn_gateways.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_vpn_gateways/v1/target_vpn_gateways.proto#L424} /// // clang-format on future> SetLabels( 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 ccdd2e817d00b..23ab2e6df2d95 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 "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_107.pb.h" -#include "google/cloud/compute/v1/internal/common_144.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_125.pb.h" +#include "google/cloud/compute/v1/internal/common_170.pb.h" // 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/internal/url_maps_rest_connection_impl.cc b/google/cloud/compute/url_maps/v1/internal/url_maps_rest_connection_impl.cc index 0540effcce09a..8ad5d8db46c47 100644 --- a/google/cloud/compute/url_maps/v1/internal/url_maps_rest_connection_impl.cc +++ b/google/cloud/compute/url_maps/v1/internal/url_maps_rest_connection_impl.cc @@ -653,6 +653,22 @@ UrlMapsRestConnectionImpl::PatchUrlMap( }); } +StatusOr +UrlMapsRestConnectionImpl::TestIamPermissions( + google::cloud::cpp::compute::url_maps::v1::TestIamPermissionsRequest const& + request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->TestIamPermissions(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::url_maps::v1:: + TestIamPermissionsRequest const& request) { + return stub_->TestIamPermissions(rest_context, options, request); + }, + *current, request, __func__); +} + future> UrlMapsRestConnectionImpl::UpdateUrlMap( google::cloud::cpp::compute::url_maps::v1::UpdateUrlMapRequest const& diff --git a/google/cloud/compute/url_maps/v1/internal/url_maps_rest_connection_impl.h b/google/cloud/compute/url_maps/v1/internal/url_maps_rest_connection_impl.h index 082b0038ea46b..48c823c366180 100644 --- a/google/cloud/compute/url_maps/v1/internal/url_maps_rest_connection_impl.h +++ b/google/cloud/compute/url_maps/v1/internal/url_maps_rest_connection_impl.h @@ -112,6 +112,10 @@ class UrlMapsRestConnectionImpl future> PatchUrlMap( google::cloud::cpp::compute::v1::Operation const& operation) override; + StatusOr + TestIamPermissions(google::cloud::cpp::compute::url_maps::v1:: + TestIamPermissionsRequest const& request) override; + future> UpdateUrlMap( google::cloud::cpp::compute::url_maps::v1::UpdateUrlMapRequest const& request) override; diff --git a/google/cloud/compute/url_maps/v1/internal/url_maps_rest_logging_decorator.cc b/google/cloud/compute/url_maps/v1/internal/url_maps_rest_logging_decorator.cc index efc645c486394..47189b7bb0790 100644 --- a/google/cloud/compute/url_maps/v1/internal/url_maps_rest_logging_decorator.cc +++ b/google/cloud/compute/url_maps/v1/internal/url_maps_rest_logging_decorator.cc @@ -218,6 +218,20 @@ UrlMapsRestLogging::PatchUrlMap( rest_context, options, request, __func__, tracing_options_); } +StatusOr +UrlMapsRestLogging::TestIamPermissions( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::url_maps::v1::TestIamPermissionsRequest const& + request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::url_maps::v1:: + TestIamPermissionsRequest const& request) { + return child_->TestIamPermissions(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + future> UrlMapsRestLogging::AsyncUpdateUrlMap( CompletionQueue& cq, diff --git a/google/cloud/compute/url_maps/v1/internal/url_maps_rest_logging_decorator.h b/google/cloud/compute/url_maps/v1/internal/url_maps_rest_logging_decorator.h index 8bf58112f8054..8dd440f57d729 100644 --- a/google/cloud/compute/url_maps/v1/internal/url_maps_rest_logging_decorator.h +++ b/google/cloud/compute/url_maps/v1/internal/url_maps_rest_logging_decorator.h @@ -116,6 +116,12 @@ class UrlMapsRestLogging : public UrlMapsRestStub { google::cloud::cpp::compute::url_maps::v1::PatchUrlMapRequest const& request) override; + StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::url_maps::v1:: + TestIamPermissionsRequest const& request) override; + future> AsyncUpdateUrlMap( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/url_maps/v1/internal/url_maps_rest_metadata_decorator.cc b/google/cloud/compute/url_maps/v1/internal/url_maps_rest_metadata_decorator.cc index 550e7baee1f34..8bbcc4fdc565c 100644 --- a/google/cloud/compute/url_maps/v1/internal/url_maps_rest_metadata_decorator.cc +++ b/google/cloud/compute/url_maps/v1/internal/url_maps_rest_metadata_decorator.cc @@ -149,6 +149,15 @@ UrlMapsRestMetadata::PatchUrlMap( return child_->PatchUrlMap(rest_context, options, request); } +StatusOr +UrlMapsRestMetadata::TestIamPermissions( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::url_maps::v1::TestIamPermissionsRequest const& + request) { + SetMetadata(rest_context, options); + return child_->TestIamPermissions(rest_context, options, request); +} + future> UrlMapsRestMetadata::AsyncUpdateUrlMap( CompletionQueue& cq, diff --git a/google/cloud/compute/url_maps/v1/internal/url_maps_rest_metadata_decorator.h b/google/cloud/compute/url_maps/v1/internal/url_maps_rest_metadata_decorator.h index 62eeb60893749..a2f7e7564abff 100644 --- a/google/cloud/compute/url_maps/v1/internal/url_maps_rest_metadata_decorator.h +++ b/google/cloud/compute/url_maps/v1/internal/url_maps_rest_metadata_decorator.h @@ -114,6 +114,12 @@ class UrlMapsRestMetadata : public UrlMapsRestStub { google::cloud::cpp::compute::url_maps::v1::PatchUrlMapRequest const& request) override; + StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::url_maps::v1:: + TestIamPermissionsRequest const& request) override; + google::cloud::future> AsyncUpdateUrlMap( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/url_maps/v1/internal/url_maps_rest_stub.cc b/google/cloud/compute/url_maps/v1/internal/url_maps_rest_stub.cc index 76cbf1ce2759e..971786f27dc56 100644 --- a/google/cloud/compute/url_maps/v1/internal/url_maps_rest_stub.cc +++ b/google/cloud/compute/url_maps/v1/internal/url_maps_rest_stub.cc @@ -339,6 +339,25 @@ DefaultUrlMapsRestStub::PatchUrlMap( std::move(query_params)); } +StatusOr +DefaultUrlMapsRestStub::TestIamPermissions( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::url_maps::v1::TestIamPermissionsRequest const& + request) { + std::vector> query_params; + return rest_internal::Post< + google::cloud::cpp::compute::v1::TestPermissionsResponse>( + *service_, rest_context, request.test_permissions_request_resource(), + false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "global", "/", + "urlMaps", "/", request.resource(), "/", + "testIamPermissions"), + std::move(query_params)); +} + future> DefaultUrlMapsRestStub::AsyncUpdateUrlMap( CompletionQueue& cq, diff --git a/google/cloud/compute/url_maps/v1/internal/url_maps_rest_stub.h b/google/cloud/compute/url_maps/v1/internal/url_maps_rest_stub.h index 553a9cd6c7ae4..e85bf0c539179 100644 --- a/google/cloud/compute/url_maps/v1/internal/url_maps_rest_stub.h +++ b/google/cloud/compute/url_maps/v1/internal/url_maps_rest_stub.h @@ -111,6 +111,12 @@ class UrlMapsRestStub { google::cloud::cpp::compute::url_maps::v1::PatchUrlMapRequest const& request) = 0; + virtual StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::url_maps::v1:: + TestIamPermissionsRequest const& request) = 0; + virtual future> AsyncUpdateUrlMap( google::cloud::CompletionQueue& cq, @@ -230,6 +236,12 @@ class DefaultUrlMapsRestStub : public UrlMapsRestStub { google::cloud::cpp::compute::url_maps::v1::PatchUrlMapRequest const& request) override; + StatusOr + TestIamPermissions(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::url_maps::v1:: + TestIamPermissionsRequest const& request) override; + future> AsyncUpdateUrlMap( google::cloud::CompletionQueue& cq, diff --git a/google/cloud/compute/url_maps/v1/internal/url_maps_tracing_connection.cc b/google/cloud/compute/url_maps/v1/internal/url_maps_tracing_connection.cc index ffb4a9cc3bd15..b82cc993aedde 100644 --- a/google/cloud/compute/url_maps/v1/internal/url_maps_tracing_connection.cc +++ b/google/cloud/compute/url_maps/v1/internal/url_maps_tracing_connection.cc @@ -187,6 +187,16 @@ UrlMapsTracingConnection::PatchUrlMap( return internal::EndSpan(std::move(span), child_->PatchUrlMap(operation)); } +StatusOr +UrlMapsTracingConnection::TestIamPermissions( + google::cloud::cpp::compute::url_maps::v1::TestIamPermissionsRequest const& + request) { + auto span = internal::MakeSpan( + "compute_url_maps_v1::UrlMapsConnection::TestIamPermissions"); + auto scope = opentelemetry::trace::Scope(span); + return internal::EndSpan(*span, child_->TestIamPermissions(request)); +} + future> UrlMapsTracingConnection::UpdateUrlMap( google::cloud::cpp::compute::url_maps::v1::UpdateUrlMapRequest const& diff --git a/google/cloud/compute/url_maps/v1/internal/url_maps_tracing_connection.h b/google/cloud/compute/url_maps/v1/internal/url_maps_tracing_connection.h index a4c4382c763d7..0bd5276f72174 100644 --- a/google/cloud/compute/url_maps/v1/internal/url_maps_tracing_connection.h +++ b/google/cloud/compute/url_maps/v1/internal/url_maps_tracing_connection.h @@ -99,6 +99,10 @@ class UrlMapsTracingConnection : public compute_url_maps_v1::UrlMapsConnection { future> PatchUrlMap( google::cloud::cpp::compute::v1::Operation const& operation) override; + StatusOr + TestIamPermissions(google::cloud::cpp::compute::url_maps::v1:: + TestIamPermissionsRequest const& request) override; + future> UpdateUrlMap( google::cloud::cpp::compute::url_maps::v1::UpdateUrlMapRequest const& request) override; diff --git a/google/cloud/compute/url_maps/v1/mocks/mock_url_maps_connection.h b/google/cloud/compute/url_maps/v1/mocks/mock_url_maps_connection.h index 847cd2df3b6b9..ad785331718e5 100644 --- a/google/cloud/compute/url_maps/v1/mocks/mock_url_maps_connection.h +++ b/google/cloud/compute/url_maps/v1/mocks/mock_url_maps_connection.h @@ -236,6 +236,13 @@ class MockUrlMapsConnection : public compute_url_maps_v1::UrlMapsConnection { (google::cloud::cpp::compute::v1::Operation const& operation), (override)); + MOCK_METHOD( + StatusOr, + TestIamPermissions, + (google::cloud::cpp::compute::url_maps::v1:: + TestIamPermissionsRequest const& request), + (override)); + /// To disambiguate calls, use: /// /// @code diff --git a/google/cloud/compute/url_maps/v1/url_maps_client.cc b/google/cloud/compute/url_maps/v1/url_maps_client.cc index be1dd36b8bdd8..5df5bdf519658 100644 --- a/google/cloud/compute/url_maps/v1/url_maps_client.cc +++ b/google/cloud/compute/url_maps/v1/url_maps_client.cc @@ -285,6 +285,30 @@ UrlMapsClient::PatchUrlMap( return connection_->PatchUrlMap(operation); } +StatusOr +UrlMapsClient::TestIamPermissions( + std::string const& project, std::string const& resource, + google::cloud::cpp::compute::v1::TestPermissionsRequest const& + test_permissions_request_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::url_maps::v1::TestIamPermissionsRequest request; + request.set_project(project); + request.set_resource(resource); + *request.mutable_test_permissions_request_resource() = + test_permissions_request_resource; + return connection_->TestIamPermissions(request); +} + +StatusOr +UrlMapsClient::TestIamPermissions( + google::cloud::cpp::compute::url_maps::v1::TestIamPermissionsRequest const& + request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->TestIamPermissions(request); +} + future> UrlMapsClient::UpdateUrlMap( std::string const& project, std::string const& url_map, 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 85415d25bbef8..d78f2624048b5 100644 --- a/google/cloud/compute/url_maps/v1/url_maps_client.h +++ b/google/cloud/compute/url_maps/v1/url_maps_client.h @@ -88,9 +88,11 @@ class UrlMapsClient { // clang-format off /// - /// 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`. + /// 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`. /// https://cloud.google.com/compute/docs/reference/rest/v1/urlMaps/aggregatedList /// /// @param project Name of the project scoping this request. @@ -116,8 +118,8 @@ class UrlMapsClient { /// [`future`]: @ref google::cloud::future /// [`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#L153} + /// [google.cloud.cpp.compute.url_maps.v1.AggregatedListUrlMapsRequest]: @cloud_cpp_reference_link{google/cloud/compute/url_maps/v1/url_maps.proto#L173} + /// [google.cloud.cpp.compute.v1.UrlMapsScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_022.proto#L179} /// // clang-format on StreamRange> DeleteUrlMap( @@ -250,7 +254,7 @@ class UrlMapsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.url_maps.v1.DeleteUrlMapRequest]: @cloud_cpp_reference_link{google/cloud/compute/url_maps/v1/url_maps.proto#L236} + /// [google.cloud.cpp.compute.url_maps.v1.DeleteUrlMapRequest]: @cloud_cpp_reference_link{google/cloud/compute/url_maps/v1/url_maps.proto#L288} /// // clang-format on future> DeleteUrlMap( @@ -308,8 +312,8 @@ class UrlMapsClient { /// [`future`]: @ref google::cloud::future /// [`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#L853} + /// [google.cloud.cpp.compute.url_maps.v1.GetUrlMapRequest]: @cloud_cpp_reference_link{google/cloud/compute/url_maps/v1/url_maps.proto#L317} + /// [google.cloud.cpp.compute.v1.UrlMap]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_023.proto#L1457} /// // clang-format on StatusOr GetUrlMap( @@ -340,8 +344,8 @@ class UrlMapsClient { /// [`future`]: @ref google::cloud::future /// [`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#L853} + /// [google.cloud.cpp.compute.url_maps.v1.GetUrlMapRequest]: @cloud_cpp_reference_link{google/cloud/compute/url_maps/v1/url_maps.proto#L317} + /// [google.cloud.cpp.compute.v1.UrlMap]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_023.proto#L1457} /// // clang-format on StatusOr GetUrlMap( @@ -351,8 +355,8 @@ class UrlMapsClient { // clang-format off /// - /// Creates a UrlMap resource in the specified project using the data included - /// in the request. + /// Creates a UrlMap resource in the specified project using + /// the data included in the request. /// https://cloud.google.com/compute/docs/reference/rest/v1/urlMaps/insert /// /// @param project Project ID for this request. @@ -377,7 +381,7 @@ class UrlMapsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.url_maps.v1.InsertUrlMapRequest]: @cloud_cpp_reference_link{google/cloud/compute/url_maps/v1/url_maps.proto#L273} + /// [google.cloud.cpp.compute.url_maps.v1.InsertUrlMapRequest]: @cloud_cpp_reference_link{google/cloud/compute/url_maps/v1/url_maps.proto#L328} /// // clang-format on future> InsertUrlMap( @@ -403,8 +407,8 @@ class UrlMapsClient { // clang-format off /// - /// Creates a UrlMap resource in the specified project using the data included - /// in the request. + /// Creates a UrlMap resource in the specified project using + /// the data included in the request. /// https://cloud.google.com/compute/docs/reference/rest/v1/urlMaps/insert /// /// @param request Unary RPCs, such as the one wrapped by this @@ -433,7 +437,7 @@ class UrlMapsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.url_maps.v1.InsertUrlMapRequest]: @cloud_cpp_reference_link{google/cloud/compute/url_maps/v1/url_maps.proto#L273} + /// [google.cloud.cpp.compute.url_maps.v1.InsertUrlMapRequest]: @cloud_cpp_reference_link{google/cloud/compute/url_maps/v1/url_maps.proto#L328} /// // clang-format on future> InsertUrlMap( @@ -474,8 +478,10 @@ class UrlMapsClient { // clang-format off /// /// 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). + /// scoped to the specified UrlMap. + /// + /// For more information, see [Invalidating cached + /// content](https://cloud.google.com/cdn/docs/invalidating-cached-content). /// https://cloud.google.com/compute/docs/reference/rest/v1/urlMaps/invalidateCache /// /// @param project Project ID for this request. @@ -501,7 +507,7 @@ class UrlMapsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.url_maps.v1.InvalidateCacheRequest]: @cloud_cpp_reference_link{google/cloud/compute/url_maps/v1/url_maps.proto#L299} + /// [google.cloud.cpp.compute.url_maps.v1.InvalidateCacheRequest]: @cloud_cpp_reference_link{google/cloud/compute/url_maps/v1/url_maps.proto#L357} /// // clang-format on future> InvalidateCache( @@ -530,8 +536,10 @@ class UrlMapsClient { // clang-format off /// /// 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). + /// scoped to the specified UrlMap. + /// + /// For more information, see [Invalidating cached + /// content](https://cloud.google.com/cdn/docs/invalidating-cached-content). /// https://cloud.google.com/compute/docs/reference/rest/v1/urlMaps/invalidateCache /// /// @param request Unary RPCs, such as the one wrapped by this @@ -560,7 +568,7 @@ class UrlMapsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.url_maps.v1.InvalidateCacheRequest]: @cloud_cpp_reference_link{google/cloud/compute/url_maps/v1/url_maps.proto#L299} + /// [google.cloud.cpp.compute.url_maps.v1.InvalidateCacheRequest]: @cloud_cpp_reference_link{google/cloud/compute/url_maps/v1/url_maps.proto#L357} /// // clang-format on future> InvalidateCache( @@ -600,7 +608,8 @@ class UrlMapsClient { // clang-format off /// - /// Retrieves the list of UrlMap resources available to the specified project. + /// Retrieves the list of UrlMap resources available to the specified + /// project. /// https://cloud.google.com/compute/docs/reference/rest/v1/urlMaps/list /// /// @param project Project ID for this request. @@ -626,8 +635,8 @@ class UrlMapsClient { /// [`future`]: @ref google::cloud::future /// [`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#L853} + /// [google.cloud.cpp.compute.url_maps.v1.ListUrlMapsRequest]: @cloud_cpp_reference_link{google/cloud/compute/url_maps/v1/url_maps.proto#L390} + /// [google.cloud.cpp.compute.v1.UrlMap]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_023.proto#L1457} /// // clang-format on StreamRange ListUrlMaps( @@ -635,7 +644,8 @@ class UrlMapsClient { // clang-format off /// - /// Retrieves the list of UrlMap resources available to the specified project. + /// Retrieves the list of UrlMap resources available to the specified + /// project. /// https://cloud.google.com/compute/docs/reference/rest/v1/urlMaps/list /// /// @param request Unary RPCs, such as the one wrapped by this @@ -666,8 +676,8 @@ class UrlMapsClient { /// [`future`]: @ref google::cloud::future /// [`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#L853} + /// [google.cloud.cpp.compute.url_maps.v1.ListUrlMapsRequest]: @cloud_cpp_reference_link{google/cloud/compute/url_maps/v1/url_maps.proto#L390} + /// [google.cloud.cpp.compute.v1.UrlMap]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_023.proto#L1457} /// // clang-format on StreamRange ListUrlMaps( @@ -677,8 +687,9 @@ class UrlMapsClient { // clang-format off /// /// 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. + /// request. This method supportsPATCH + /// semantics and uses theJSON merge + /// patch format and processing rules. /// https://cloud.google.com/compute/docs/reference/rest/v1/urlMaps/patch /// /// @param project Project ID for this request. @@ -704,7 +715,7 @@ class UrlMapsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.url_maps.v1.PatchUrlMapRequest]: @cloud_cpp_reference_link{google/cloud/compute/url_maps/v1/url_maps.proto#L397} + /// [google.cloud.cpp.compute.url_maps.v1.PatchUrlMapRequest]: @cloud_cpp_reference_link{google/cloud/compute/url_maps/v1/url_maps.proto#L491} /// // clang-format on future> PatchUrlMap( @@ -731,8 +742,9 @@ class UrlMapsClient { // clang-format off /// /// 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. + /// request. This method supportsPATCH + /// semantics and uses theJSON merge + /// patch format and processing rules. /// https://cloud.google.com/compute/docs/reference/rest/v1/urlMaps/patch /// /// @param request Unary RPCs, such as the one wrapped by this @@ -761,7 +773,7 @@ class UrlMapsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.url_maps.v1.PatchUrlMapRequest]: @cloud_cpp_reference_link{google/cloud/compute/url_maps/v1/url_maps.proto#L397} + /// [google.cloud.cpp.compute.url_maps.v1.PatchUrlMapRequest]: @cloud_cpp_reference_link{google/cloud/compute/url_maps/v1/url_maps.proto#L491} /// // clang-format on future> PatchUrlMap( @@ -799,6 +811,71 @@ class UrlMapsClient { google::cloud::cpp::compute::v1::Operation const& operation, Options opts = {}); + // clang-format off + /// + /// Returns permissions that a caller has on the specified resource. + /// https://cloud.google.com/compute/docs/reference/rest/v1/urlMaps/testIamPermissions + /// + /// @param project Project ID for this request. + /// @param resource Name or id of the resource for this request. + /// @param test_permissions_request_resource The TestPermissionsRequest for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.TestPermissionsResponse]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.url_maps.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/url_maps/v1/url_maps.proto#L524} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} + /// + // clang-format on + StatusOr + TestIamPermissions( + std::string const& project, std::string const& resource, + google::cloud::cpp::compute::v1::TestPermissionsRequest const& + test_permissions_request_resource, + Options opts = {}); + + // clang-format off + /// + /// Returns permissions that a caller has on the specified resource. + /// https://cloud.google.com/compute/docs/reference/rest/v1/urlMaps/testIamPermissions + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.url_maps.v1.TestIamPermissionsRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.TestPermissionsResponse]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.url_maps.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/url_maps/v1/url_maps.proto#L524} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} + /// + // clang-format on + StatusOr + TestIamPermissions(google::cloud::cpp::compute::url_maps::v1:: + TestIamPermissionsRequest const& request, + Options opts = {}); + // clang-format off /// /// Updates the specified UrlMap resource with the data included in the @@ -828,7 +905,7 @@ class UrlMapsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.url_maps.v1.UpdateUrlMapRequest]: @cloud_cpp_reference_link{google/cloud/compute/url_maps/v1/url_maps.proto#L427} + /// [google.cloud.cpp.compute.url_maps.v1.UpdateUrlMapRequest]: @cloud_cpp_reference_link{google/cloud/compute/url_maps/v1/url_maps.proto#L539} /// // clang-format on future> UpdateUrlMap( @@ -884,7 +961,7 @@ class UrlMapsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.url_maps.v1.UpdateUrlMapRequest]: @cloud_cpp_reference_link{google/cloud/compute/url_maps/v1/url_maps.proto#L427} + /// [google.cloud.cpp.compute.url_maps.v1.UpdateUrlMapRequest]: @cloud_cpp_reference_link{google/cloud/compute/url_maps/v1/url_maps.proto#L539} /// // clang-format on future> UpdateUrlMap( @@ -945,8 +1022,8 @@ class UrlMapsClient { /// [`future`]: @ref google::cloud::future /// [`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#L1145} + /// [google.cloud.cpp.compute.url_maps.v1.ValidateRequest]: @cloud_cpp_reference_link{google/cloud/compute/url_maps/v1/url_maps.proto#L572} + /// [google.cloud.cpp.compute.v1.UrlMapsValidateResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_023.proto#L1826} /// // clang-format on StatusOr Validate( @@ -981,8 +1058,8 @@ class UrlMapsClient { /// [`future`]: @ref google::cloud::future /// [`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#L1145} + /// [google.cloud.cpp.compute.url_maps.v1.ValidateRequest]: @cloud_cpp_reference_link{google/cloud/compute/url_maps/v1/url_maps.proto#L572} + /// [google.cloud.cpp.compute.v1.UrlMapsValidateResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_023.proto#L1826} /// // clang-format on StatusOr Validate( diff --git a/google/cloud/compute/url_maps/v1/url_maps_connection.cc b/google/cloud/compute/url_maps/v1/url_maps_connection.cc index 1a051018c5828..e30ad4d612aa1 100644 --- a/google/cloud/compute/url_maps/v1/url_maps_connection.cc +++ b/google/cloud/compute/url_maps/v1/url_maps_connection.cc @@ -155,6 +155,13 @@ UrlMapsConnection::PatchUrlMap( Status(StatusCode::kUnimplemented, "not implemented")); } +StatusOr +UrlMapsConnection::TestIamPermissions( + google::cloud::cpp::compute::url_maps::v1:: + TestIamPermissionsRequest const&) { + return Status(StatusCode::kUnimplemented, "not implemented"); +} + future> UrlMapsConnection::UpdateUrlMap( google::cloud::cpp::compute::url_maps::v1::UpdateUrlMapRequest const&) { diff --git a/google/cloud/compute/url_maps/v1/url_maps_connection.h b/google/cloud/compute/url_maps/v1/url_maps_connection.h index 931d51d72d425..65839f54ffe0f 100644 --- a/google/cloud/compute/url_maps/v1/url_maps_connection.h +++ b/google/cloud/compute/url_maps/v1/url_maps_connection.h @@ -247,6 +247,10 @@ class UrlMapsConnection { virtual future> PatchUrlMap(google::cloud::cpp::compute::v1::Operation const& operation); + virtual StatusOr + TestIamPermissions(google::cloud::cpp::compute::url_maps::v1:: + TestIamPermissionsRequest const& request); + virtual future> UpdateUrlMap( google::cloud::cpp::compute::url_maps::v1::UpdateUrlMapRequest const& diff --git a/google/cloud/compute/url_maps/v1/url_maps_connection_idempotency_policy.cc b/google/cloud/compute/url_maps/v1/url_maps_connection_idempotency_policy.cc index 4d881fa9ae155..03a459b72bb7b 100644 --- a/google/cloud/compute/url_maps/v1/url_maps_connection_idempotency_policy.cc +++ b/google/cloud/compute/url_maps/v1/url_maps_connection_idempotency_policy.cc @@ -70,6 +70,12 @@ Idempotency UrlMapsConnectionIdempotencyPolicy::PatchUrlMap( return Idempotency::kNonIdempotent; } +Idempotency UrlMapsConnectionIdempotencyPolicy::TestIamPermissions( + google::cloud::cpp::compute::url_maps::v1:: + TestIamPermissionsRequest const&) { + return Idempotency::kNonIdempotent; +} + Idempotency UrlMapsConnectionIdempotencyPolicy::UpdateUrlMap( google::cloud::cpp::compute::url_maps::v1::UpdateUrlMapRequest const&) { return Idempotency::kIdempotent; diff --git a/google/cloud/compute/url_maps/v1/url_maps_connection_idempotency_policy.h b/google/cloud/compute/url_maps/v1/url_maps_connection_idempotency_policy.h index b22ff0bec4526..eb34ab4ad1a4a 100644 --- a/google/cloud/compute/url_maps/v1/url_maps_connection_idempotency_policy.h +++ b/google/cloud/compute/url_maps/v1/url_maps_connection_idempotency_policy.h @@ -63,6 +63,10 @@ class UrlMapsConnectionIdempotencyPolicy { google::cloud::cpp::compute::url_maps::v1::PatchUrlMapRequest const& request); + virtual google::cloud::Idempotency TestIamPermissions( + google::cloud::cpp::compute::url_maps::v1:: + TestIamPermissionsRequest const& request); + virtual google::cloud::Idempotency UpdateUrlMap( google::cloud::cpp::compute::url_maps::v1::UpdateUrlMapRequest const& request); 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 074ac7e920b9c..11ce29e396e4d 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,12 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_URL_MAPS_V1_URL_MAPS_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_018.pb.h" -#include "google/cloud/compute/v1/internal/common_020.pb.h" -#include "google/cloud/compute/v1/internal/common_029.pb.h" -#include "google/cloud/compute/v1/internal/common_082.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_022.pb.h" +#include "google/cloud/compute/v1/internal/common_023.pb.h" +#include "google/cloud/compute/v1/internal/common_038.pb.h" +#include "google/cloud/compute/v1/internal/common_097.pb.h" +#include "google/cloud/compute/v1/internal/common_171.pb.h" // 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 e8cd9f54bcd7a..b5e15d90bdc6d 100644 --- a/google/cloud/compute/vpn_gateways/v1/vpn_gateways_client.h +++ b/google/cloud/compute/vpn_gateways/v1/vpn_gateways_client.h @@ -90,8 +90,10 @@ class VpnGatewaysClient { // clang-format off /// - /// Retrieves an aggregated list of VPN gateways. To prevent failure, Google - /// recommends that you set the `returnPartialSuccess` parameter to `true`. + /// Retrieves an aggregated list of VPN gateways. + /// + /// To prevent failure, Google recommends that you set the + /// `returnPartialSuccess` parameter to `true`. /// https://cloud.google.com/compute/docs/reference/rest/v1/vpnGateways/aggregatedList /// /// @param project Project ID for this request. @@ -117,8 +119,8 @@ 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_148.proto#L416} - /// [google.cloud.cpp.compute.vpn_gateways.v1.AggregatedListVpnGatewaysRequest]: @cloud_cpp_reference_link{google/cloud/compute/vpn_gateways/v1/vpn_gateways.proto#L137} + /// [google.cloud.cpp.compute.v1.VpnGatewaysScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_177.proto#L502} + /// [google.cloud.cpp.compute.vpn_gateways.v1.AggregatedListVpnGatewaysRequest]: @cloud_cpp_reference_link{google/cloud/compute/vpn_gateways/v1/vpn_gateways.proto#L140} /// // clang-format on StreamRange> DeleteVpnGateway( @@ -250,7 +254,7 @@ class VpnGatewaysClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.vpn_gateways.v1.DeleteVpnGatewayRequest]: @cloud_cpp_reference_link{google/cloud/compute/vpn_gateways/v1/vpn_gateways.proto#L219} + /// [google.cloud.cpp.compute.vpn_gateways.v1.DeleteVpnGatewayRequest]: @cloud_cpp_reference_link{google/cloud/compute/vpn_gateways/v1/vpn_gateways.proto#L255} /// // clang-format on future> DeleteVpnGateway( @@ -309,8 +313,8 @@ 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_148.proto#L29} - /// [google.cloud.cpp.compute.vpn_gateways.v1.GetVpnGatewayRequest]: @cloud_cpp_reference_link{google/cloud/compute/vpn_gateways/v1/vpn_gateways.proto#L267} + /// [google.cloud.cpp.compute.v1.VpnGateway]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_177.proto#L31} + /// [google.cloud.cpp.compute.vpn_gateways.v1.GetVpnGatewayRequest]: @cloud_cpp_reference_link{google/cloud/compute/vpn_gateways/v1/vpn_gateways.proto#L306} /// // clang-format on StatusOr GetVpnGateway( @@ -341,8 +345,8 @@ 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_148.proto#L29} - /// [google.cloud.cpp.compute.vpn_gateways.v1.GetVpnGatewayRequest]: @cloud_cpp_reference_link{google/cloud/compute/vpn_gateways/v1/vpn_gateways.proto#L267} + /// [google.cloud.cpp.compute.v1.VpnGateway]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_177.proto#L31} + /// [google.cloud.cpp.compute.vpn_gateways.v1.GetVpnGatewayRequest]: @cloud_cpp_reference_link{google/cloud/compute/vpn_gateways/v1/vpn_gateways.proto#L306} /// // clang-format on StatusOr GetVpnGateway( @@ -371,8 +375,8 @@ 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_148.proto#L412} - /// [google.cloud.cpp.compute.vpn_gateways.v1.GetStatusRequest]: @cloud_cpp_reference_link{google/cloud/compute/vpn_gateways/v1/vpn_gateways.proto#L252} + /// [google.cloud.cpp.compute.v1.VpnGatewaysGetStatusResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_177.proto#L498} + /// [google.cloud.cpp.compute.vpn_gateways.v1.GetStatusRequest]: @cloud_cpp_reference_link{google/cloud/compute/vpn_gateways/v1/vpn_gateways.proto#L291} /// // clang-format on StatusOr @@ -403,8 +407,8 @@ 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_148.proto#L412} - /// [google.cloud.cpp.compute.vpn_gateways.v1.GetStatusRequest]: @cloud_cpp_reference_link{google/cloud/compute/vpn_gateways/v1/vpn_gateways.proto#L252} + /// [google.cloud.cpp.compute.v1.VpnGatewaysGetStatusResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_177.proto#L498} + /// [google.cloud.cpp.compute.vpn_gateways.v1.GetStatusRequest]: @cloud_cpp_reference_link{google/cloud/compute/vpn_gateways/v1/vpn_gateways.proto#L291} /// // clang-format on StatusOr @@ -415,8 +419,8 @@ class VpnGatewaysClient { // clang-format off /// - /// Creates a VPN gateway in the specified project and region using the data - /// included in the request. + /// Creates a VPN gateway in the specified project and region using + /// the data included in the request. /// https://cloud.google.com/compute/docs/reference/rest/v1/vpnGateways/insert /// /// @param project Project ID for this request. @@ -442,7 +446,7 @@ class VpnGatewaysClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.vpn_gateways.v1.InsertVpnGatewayRequest]: @cloud_cpp_reference_link{google/cloud/compute/vpn_gateways/v1/vpn_gateways.proto#L282} + /// [google.cloud.cpp.compute.vpn_gateways.v1.InsertVpnGatewayRequest]: @cloud_cpp_reference_link{google/cloud/compute/vpn_gateways/v1/vpn_gateways.proto#L321} /// // clang-format on future> InsertVpnGateway( @@ -468,8 +472,8 @@ class VpnGatewaysClient { // clang-format off /// - /// Creates a VPN gateway in the specified project and region using the data - /// included in the request. + /// Creates a VPN gateway in the specified project and region using + /// the data included in the request. /// https://cloud.google.com/compute/docs/reference/rest/v1/vpnGateways/insert /// /// @param request Unary RPCs, such as the one wrapped by this @@ -498,7 +502,7 @@ class VpnGatewaysClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.vpn_gateways.v1.InsertVpnGatewayRequest]: @cloud_cpp_reference_link{google/cloud/compute/vpn_gateways/v1/vpn_gateways.proto#L282} + /// [google.cloud.cpp.compute.vpn_gateways.v1.InsertVpnGatewayRequest]: @cloud_cpp_reference_link{google/cloud/compute/vpn_gateways/v1/vpn_gateways.proto#L321} /// // clang-format on future> InsertVpnGateway( @@ -538,8 +542,8 @@ class VpnGatewaysClient { // clang-format off /// - /// Retrieves a list of VPN gateways available to the specified project and - /// region. + /// Retrieves a list of VPN gateways available to the specified + /// project and region. /// https://cloud.google.com/compute/docs/reference/rest/v1/vpnGateways/list /// /// @param project Project ID for this request. @@ -566,8 +570,8 @@ 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_148.proto#L29} - /// [google.cloud.cpp.compute.vpn_gateways.v1.ListVpnGatewaysRequest]: @cloud_cpp_reference_link{google/cloud/compute/vpn_gateways/v1/vpn_gateways.proto#L315} + /// [google.cloud.cpp.compute.v1.VpnGateway]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_177.proto#L31} + /// [google.cloud.cpp.compute.vpn_gateways.v1.ListVpnGatewaysRequest]: @cloud_cpp_reference_link{google/cloud/compute/vpn_gateways/v1/vpn_gateways.proto#L357} /// // clang-format on StreamRange ListVpnGateways( @@ -575,8 +579,8 @@ class VpnGatewaysClient { // clang-format off /// - /// Retrieves a list of VPN gateways available to the specified project and - /// region. + /// Retrieves a list of VPN gateways available to the specified + /// project and region. /// https://cloud.google.com/compute/docs/reference/rest/v1/vpnGateways/list /// /// @param request Unary RPCs, such as the one wrapped by this @@ -607,8 +611,8 @@ 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_148.proto#L29} - /// [google.cloud.cpp.compute.vpn_gateways.v1.ListVpnGatewaysRequest]: @cloud_cpp_reference_link{google/cloud/compute/vpn_gateways/v1/vpn_gateways.proto#L315} + /// [google.cloud.cpp.compute.v1.VpnGateway]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_177.proto#L31} + /// [google.cloud.cpp.compute.vpn_gateways.v1.ListVpnGatewaysRequest]: @cloud_cpp_reference_link{google/cloud/compute/vpn_gateways/v1/vpn_gateways.proto#L357} /// // clang-format on StreamRange ListVpnGateways( @@ -618,8 +622,9 @@ class VpnGatewaysClient { // clang-format off /// - /// Sets the labels on a VpnGateway. To learn more about labels, read the - /// Labeling Resources documentation. + /// Sets the labels on a VpnGateway. To learn more about labels, read + /// theLabeling + /// Resources documentation. /// https://cloud.google.com/compute/docs/reference/rest/v1/vpnGateways/setLabels /// /// @param project Project ID for this request. @@ -646,7 +651,7 @@ class VpnGatewaysClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.vpn_gateways.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/vpn_gateways/v1/vpn_gateways.proto#L387} + /// [google.cloud.cpp.compute.vpn_gateways.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/vpn_gateways/v1/vpn_gateways.proto#L462} /// // clang-format on future> SetLabels( @@ -676,8 +681,9 @@ class VpnGatewaysClient { // clang-format off /// - /// Sets the labels on a VpnGateway. To learn more about labels, read the - /// Labeling Resources documentation. + /// Sets the labels on a VpnGateway. To learn more about labels, read + /// theLabeling + /// Resources documentation. /// https://cloud.google.com/compute/docs/reference/rest/v1/vpnGateways/setLabels /// /// @param request Unary RPCs, such as the one wrapped by this @@ -706,7 +712,7 @@ class VpnGatewaysClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.vpn_gateways.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/vpn_gateways/v1/vpn_gateways.proto#L387} + /// [google.cloud.cpp.compute.vpn_gateways.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/vpn_gateways/v1/vpn_gateways.proto#L462} /// // clang-format on future> SetLabels( @@ -766,8 +772,8 @@ 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_145.proto#L30} - /// [google.cloud.cpp.compute.vpn_gateways.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/vpn_gateways/v1/vpn_gateways.proto#L425} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} + /// [google.cloud.cpp.compute.vpn_gateways.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/vpn_gateways/v1/vpn_gateways.proto#L503} /// // clang-format on StatusOr @@ -802,8 +808,8 @@ 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_145.proto#L30} - /// [google.cloud.cpp.compute.vpn_gateways.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/vpn_gateways/v1/vpn_gateways.proto#L425} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_171.proto#L30} + /// [google.cloud.cpp.compute.vpn_gateways.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/vpn_gateways/v1/vpn_gateways.proto#L503} /// // clang-format on StatusOr 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 4511d005df643..38632d676d0f7 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 "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_107.pb.h" -#include "google/cloud/compute/v1/internal/common_145.pb.h" -#include "google/cloud/compute/v1/internal/common_148.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_125.pb.h" +#include "google/cloud/compute/v1/internal/common_171.pb.h" +#include "google/cloud/compute/v1/internal/common_177.pb.h" // 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 4db44fe355a2b..8cb16e67f3cb7 100644 --- a/google/cloud/compute/vpn_tunnels/v1/vpn_tunnels_client.h +++ b/google/cloud/compute/vpn_tunnels/v1/vpn_tunnels_client.h @@ -88,8 +88,10 @@ class VpnTunnelsClient { // clang-format off /// - /// Retrieves an aggregated list of VPN tunnels. To prevent failure, Google - /// recommends that you set the `returnPartialSuccess` parameter to `true`. + /// Retrieves an aggregated list of VPN tunnels. + /// + /// To prevent failure, Google recommends that you set the + /// `returnPartialSuccess` parameter to `true`. /// https://cloud.google.com/compute/docs/reference/rest/v1/vpnTunnels/aggregatedList /// /// @param project Project ID for this request. @@ -115,8 +117,8 @@ 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_149.proto#L398} - /// [google.cloud.cpp.compute.vpn_tunnels.v1.AggregatedListVpnTunnelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/vpn_tunnels/v1/vpn_tunnels.proto#L113} + /// [google.cloud.cpp.compute.v1.VpnTunnelsScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_178.proto#L522} + /// [google.cloud.cpp.compute.vpn_tunnels.v1.AggregatedListVpnTunnelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/vpn_tunnels/v1/vpn_tunnels.proto#L116} /// // clang-format on StreamRange> DeleteVpnTunnel( @@ -248,7 +252,7 @@ class VpnTunnelsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.vpn_tunnels.v1.DeleteVpnTunnelRequest]: @cloud_cpp_reference_link{google/cloud/compute/vpn_tunnels/v1/vpn_tunnels.proto#L195} + /// [google.cloud.cpp.compute.vpn_tunnels.v1.DeleteVpnTunnelRequest]: @cloud_cpp_reference_link{google/cloud/compute/vpn_tunnels/v1/vpn_tunnels.proto#L231} /// // clang-format on future> DeleteVpnTunnel( @@ -307,8 +311,8 @@ 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_149.proto#L26} - /// [google.cloud.cpp.compute.vpn_tunnels.v1.GetVpnTunnelRequest]: @cloud_cpp_reference_link{google/cloud/compute/vpn_tunnels/v1/vpn_tunnels.proto#L228} + /// [google.cloud.cpp.compute.v1.VpnTunnel]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_178.proto#L28} + /// [google.cloud.cpp.compute.vpn_tunnels.v1.GetVpnTunnelRequest]: @cloud_cpp_reference_link{google/cloud/compute/vpn_tunnels/v1/vpn_tunnels.proto#L267} /// // clang-format on StatusOr GetVpnTunnel( @@ -339,8 +343,8 @@ 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_149.proto#L26} - /// [google.cloud.cpp.compute.vpn_tunnels.v1.GetVpnTunnelRequest]: @cloud_cpp_reference_link{google/cloud/compute/vpn_tunnels/v1/vpn_tunnels.proto#L228} + /// [google.cloud.cpp.compute.v1.VpnTunnel]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_178.proto#L28} + /// [google.cloud.cpp.compute.vpn_tunnels.v1.GetVpnTunnelRequest]: @cloud_cpp_reference_link{google/cloud/compute/vpn_tunnels/v1/vpn_tunnels.proto#L267} /// // clang-format on StatusOr GetVpnTunnel( @@ -350,8 +354,8 @@ class VpnTunnelsClient { // clang-format off /// - /// Creates a VpnTunnel resource in the specified project and region using the - /// data included in the request. + /// Creates a VpnTunnel resource in the specified project and region using + /// the data included in the request. /// https://cloud.google.com/compute/docs/reference/rest/v1/vpnTunnels/insert /// /// @param project Project ID for this request. @@ -377,7 +381,7 @@ class VpnTunnelsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.vpn_tunnels.v1.InsertVpnTunnelRequest]: @cloud_cpp_reference_link{google/cloud/compute/vpn_tunnels/v1/vpn_tunnels.proto#L243} + /// [google.cloud.cpp.compute.vpn_tunnels.v1.InsertVpnTunnelRequest]: @cloud_cpp_reference_link{google/cloud/compute/vpn_tunnels/v1/vpn_tunnels.proto#L282} /// // clang-format on future> InsertVpnTunnel( @@ -403,8 +407,8 @@ class VpnTunnelsClient { // clang-format off /// - /// Creates a VpnTunnel resource in the specified project and region using the - /// data included in the request. + /// Creates a VpnTunnel resource in the specified project and region using + /// the data included in the request. /// https://cloud.google.com/compute/docs/reference/rest/v1/vpnTunnels/insert /// /// @param request Unary RPCs, such as the one wrapped by this @@ -433,7 +437,7 @@ class VpnTunnelsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.vpn_tunnels.v1.InsertVpnTunnelRequest]: @cloud_cpp_reference_link{google/cloud/compute/vpn_tunnels/v1/vpn_tunnels.proto#L243} + /// [google.cloud.cpp.compute.vpn_tunnels.v1.InsertVpnTunnelRequest]: @cloud_cpp_reference_link{google/cloud/compute/vpn_tunnels/v1/vpn_tunnels.proto#L282} /// // clang-format on future> InsertVpnTunnel( @@ -473,8 +477,8 @@ class VpnTunnelsClient { // clang-format off /// - /// Retrieves a list of VpnTunnel resources contained in the specified project - /// and region. + /// Retrieves a list of VpnTunnel resources contained in the specified + /// project and region. /// https://cloud.google.com/compute/docs/reference/rest/v1/vpnTunnels/list /// /// @param project Project ID for this request. @@ -501,8 +505,8 @@ 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_149.proto#L26} - /// [google.cloud.cpp.compute.vpn_tunnels.v1.ListVpnTunnelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/vpn_tunnels/v1/vpn_tunnels.proto#L276} + /// [google.cloud.cpp.compute.v1.VpnTunnel]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_178.proto#L28} + /// [google.cloud.cpp.compute.vpn_tunnels.v1.ListVpnTunnelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/vpn_tunnels/v1/vpn_tunnels.proto#L318} /// // clang-format on StreamRange ListVpnTunnels( @@ -510,8 +514,8 @@ class VpnTunnelsClient { // clang-format off /// - /// Retrieves a list of VpnTunnel resources contained in the specified project - /// and region. + /// Retrieves a list of VpnTunnel resources contained in the specified + /// project and region. /// https://cloud.google.com/compute/docs/reference/rest/v1/vpnTunnels/list /// /// @param request Unary RPCs, such as the one wrapped by this @@ -542,8 +546,8 @@ 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_149.proto#L26} - /// [google.cloud.cpp.compute.vpn_tunnels.v1.ListVpnTunnelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/vpn_tunnels/v1/vpn_tunnels.proto#L276} + /// [google.cloud.cpp.compute.v1.VpnTunnel]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_178.proto#L28} + /// [google.cloud.cpp.compute.vpn_tunnels.v1.ListVpnTunnelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/vpn_tunnels/v1/vpn_tunnels.proto#L318} /// // clang-format on StreamRange ListVpnTunnels( @@ -553,8 +557,9 @@ class VpnTunnelsClient { // clang-format off /// - /// Sets the labels on a VpnTunnel. To learn more about labels, read the - /// Labeling Resources documentation. + /// Sets the labels on a VpnTunnel. To learn more about labels, read + /// theLabeling + /// Resources documentation. /// https://cloud.google.com/compute/docs/reference/rest/v1/vpnTunnels/setLabels /// /// @param project Project ID for this request. @@ -581,7 +586,7 @@ class VpnTunnelsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.vpn_tunnels.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/vpn_tunnels/v1/vpn_tunnels.proto#L348} + /// [google.cloud.cpp.compute.vpn_tunnels.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/vpn_tunnels/v1/vpn_tunnels.proto#L423} /// // clang-format on future> SetLabels( @@ -611,8 +616,9 @@ class VpnTunnelsClient { // clang-format off /// - /// Sets the labels on a VpnTunnel. To learn more about labels, read the - /// Labeling Resources documentation. + /// Sets the labels on a VpnTunnel. To learn more about labels, read + /// theLabeling + /// Resources documentation. /// https://cloud.google.com/compute/docs/reference/rest/v1/vpnTunnels/setLabels /// /// @param request Unary RPCs, such as the one wrapped by this @@ -641,7 +647,7 @@ class VpnTunnelsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.vpn_tunnels.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/vpn_tunnels/v1/vpn_tunnels.proto#L348} + /// [google.cloud.cpp.compute.vpn_tunnels.v1.SetLabelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/vpn_tunnels/v1/vpn_tunnels.proto#L423} /// // clang-format on future> SetLabels( 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 d551a462fbb5f..012749ce55a74 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 "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_107.pb.h" -#include "google/cloud/compute/v1/internal/common_149.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_125.pb.h" +#include "google/cloud/compute/v1/internal/common_178.pb.h" // 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/wire_groups/v1/internal/wire_groups_option_defaults.cc b/google/cloud/compute/wire_groups/v1/internal/wire_groups_option_defaults.cc new file mode 100644 index 0000000000000..45160c7542e5b --- /dev/null +++ b/google/cloud/compute/wire_groups/v1/internal/wire_groups_option_defaults.cc @@ -0,0 +1,80 @@ +// Copyright 2026 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. +// source: google/cloud/compute/wire_groups/v1/wire_groups.proto + +#include "google/cloud/compute/wire_groups/v1/internal/wire_groups_option_defaults.h" +#include "google/cloud/compute/wire_groups/v1/wire_groups_connection.h" +#include "google/cloud/compute/wire_groups/v1/wire_groups_options.h" +#include "google/cloud/internal/populate_common_options.h" +#include "google/cloud/internal/populate_grpc_options.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_wire_groups_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +namespace { +auto constexpr kBackoffScaling = 2.0; +} // namespace + +Options WireGroupsDefaultOptions(Options options) { + options = internal::PopulateCommonOptions( + std::move(options), "GOOGLE_CLOUD_CPP_WIRE_GROUPS_ENDPOINT", "", + "GOOGLE_CLOUD_CPP_WIRE_GROUPS_AUTHORITY", "compute.googleapis.com"); + options = internal::PopulateGrpcOptions(std::move(options)); + if (!options.has()) { + options.set( + compute_wire_groups_v1::WireGroupsLimitedTimeRetryPolicy( + std::chrono::minutes(10)) + .clone()); + } + if (!options.has()) { + options.set( + ExponentialBackoffPolicy( + std::chrono::seconds(0), std::chrono::seconds(1), + std::chrono::minutes(5), kBackoffScaling, kBackoffScaling) + .clone()); + } + if (!options.has()) { + options.set( + GenericPollingPolicy< + compute_wire_groups_v1::WireGroupsRetryPolicyOption::Type, + compute_wire_groups_v1::WireGroupsBackoffPolicyOption::Type>( + options.get() + ->clone(), + ExponentialBackoffPolicy(std::chrono::seconds(1), + std::chrono::minutes(5), kBackoffScaling) + .clone()) + .clone()); + } + if (!options.has()) { + options.set< + compute_wire_groups_v1::WireGroupsConnectionIdempotencyPolicyOption>( + compute_wire_groups_v1:: + MakeDefaultWireGroupsConnectionIdempotencyPolicy()); + } + + return options; +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_wire_groups_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/wire_groups/v1/internal/wire_groups_option_defaults.h b/google/cloud/compute/wire_groups/v1/internal/wire_groups_option_defaults.h new file mode 100644 index 0000000000000..6e4e1772805fb --- /dev/null +++ b/google/cloud/compute/wire_groups/v1/internal/wire_groups_option_defaults.h @@ -0,0 +1,37 @@ +// Copyright 2026 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. +// source: google/cloud/compute/wire_groups/v1/wire_groups.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_WIRE_GROUPS_V1_INTERNAL_WIRE_GROUPS_OPTION_DEFAULTS_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_WIRE_GROUPS_V1_INTERNAL_WIRE_GROUPS_OPTION_DEFAULTS_H + +#include "google/cloud/options.h" +#include "google/cloud/version.h" + +namespace google { +namespace cloud { +namespace compute_wire_groups_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +Options WireGroupsDefaultOptions(Options options); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_wire_groups_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_WIRE_GROUPS_V1_INTERNAL_WIRE_GROUPS_OPTION_DEFAULTS_H diff --git a/google/cloud/compute/wire_groups/v1/internal/wire_groups_rest_connection_impl.cc b/google/cloud/compute/wire_groups/v1/internal/wire_groups_rest_connection_impl.cc new file mode 100644 index 0000000000000..267656823d544 --- /dev/null +++ b/google/cloud/compute/wire_groups/v1/internal/wire_groups_rest_connection_impl.cc @@ -0,0 +1,485 @@ +// Copyright 2026 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. +// source: google/cloud/compute/wire_groups/v1/wire_groups.proto + +#include "google/cloud/compute/wire_groups/v1/internal/wire_groups_rest_connection_impl.h" +#include "google/cloud/compute/wire_groups/v1/internal/wire_groups_rest_stub_factory.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/internal/async_rest_long_running_operation_custom.h" +#include "google/cloud/internal/extract_long_running_result.h" +#include "google/cloud/internal/pagination_range.h" +#include "google/cloud/internal/rest_lro_helpers.h" +#include "google/cloud/internal/rest_retry_loop.h" +#include "google/cloud/rest_options.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_wire_groups_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +WireGroupsRestConnectionImpl::WireGroupsRestConnectionImpl( + std::unique_ptr background, + std::shared_ptr stub, + Options options) + : background_(std::move(background)), + stub_(std::move(stub)), + options_(internal::MergeOptions(std::move(options), + WireGroupsConnection::options())) {} + +future> +WireGroupsRestConnectionImpl::DeleteWireGroup( + google::cloud::cpp::compute::wire_groups::v1::DeleteWireGroupRequest const& + request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::global_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, request, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::wire_groups::v1:: + DeleteWireGroupRequest const& request) { + return stub->AsyncDeleteWireGroup(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->DeleteWireGroup(request), + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [request](std::string const& op, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest& r) { + r.set_project(request.project()); + r.set_operation(op); + }, + [request](std::string const& op, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest& r) { + r.set_project(request.project()); + r.set_operation(op); + }); +} + +StatusOr +WireGroupsRestConnectionImpl::DeleteWireGroup( + NoAwaitTag, + google::cloud::cpp::compute::wire_groups::v1::DeleteWireGroupRequest const& + request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->DeleteWireGroup(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::wire_groups::v1:: + DeleteWireGroupRequest const& request) { + return stub_->DeleteWireGroup(rest_context, options, request); + }, + *current, request, __func__); +} + +future> +WireGroupsRestConnectionImpl::DeleteWireGroup( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestAwaitLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::global_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, operation, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [operation](std::string const&, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_operation(info.operation); + }, + [operation](std::string const&, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_operation(info.operation); + }); +} + +StatusOr +WireGroupsRestConnectionImpl::GetWireGroup( + google::cloud::cpp::compute::wire_groups::v1::GetWireGroupRequest const& + request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->GetWireGroup(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::wire_groups::v1:: + GetWireGroupRequest const& request) { + return stub_->GetWireGroup(rest_context, options, request); + }, + *current, request, __func__); +} + +future> +WireGroupsRestConnectionImpl::InsertWireGroup( + google::cloud::cpp::compute::wire_groups::v1::InsertWireGroupRequest const& + request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::global_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, request, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::wire_groups::v1:: + InsertWireGroupRequest const& request) { + return stub->AsyncInsertWireGroup(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->InsertWireGroup(request), + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [request](std::string const& op, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest& r) { + r.set_project(request.project()); + r.set_operation(op); + }, + [request](std::string const& op, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest& r) { + r.set_project(request.project()); + r.set_operation(op); + }); +} + +StatusOr +WireGroupsRestConnectionImpl::InsertWireGroup( + NoAwaitTag, + google::cloud::cpp::compute::wire_groups::v1::InsertWireGroupRequest const& + request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->InsertWireGroup(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::wire_groups::v1:: + InsertWireGroupRequest const& request) { + return stub_->InsertWireGroup(rest_context, options, request); + }, + *current, request, __func__); +} + +future> +WireGroupsRestConnectionImpl::InsertWireGroup( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestAwaitLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::global_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, operation, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [operation](std::string const&, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_operation(info.operation); + }, + [operation](std::string const&, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_operation(info.operation); + }); +} + +StreamRange +WireGroupsRestConnectionImpl::ListWireGroups( + google::cloud::cpp::compute::wire_groups::v1::ListWireGroupsRequest + request) { + request.clear_page_token(); + auto current = google::cloud::internal::SaveCurrentOptions(); + auto idempotency = idempotency_policy(*current)->ListWireGroups(request); + char const* function_name = __func__; + return google::cloud::internal::MakePaginationRange< + StreamRange>( + current, std::move(request), + [idempotency, function_name, stub = stub_, + retry = std::shared_ptr( + retry_policy(*current)), + backoff = std::shared_ptr(backoff_policy(*current))]( + Options const& options, google::cloud::cpp::compute::wire_groups::v1:: + ListWireGroupsRequest const& r) { + return google::cloud::rest_internal::RestRetryLoop( + retry->clone(), backoff->clone(), idempotency, + [stub](rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::wire_groups::v1:: + ListWireGroupsRequest const& request) { + return stub->ListWireGroups(rest_context, options, request); + }, + options, r, function_name); + }, + [](google::cloud::cpp::compute::v1::WireGroupList r) { + std::vector result( + r.items().size()); + auto& messages = *r.mutable_items(); + std::move(messages.begin(), messages.end(), result.begin()); + return result; + }); +} + +future> +WireGroupsRestConnectionImpl::PatchWireGroup( + google::cloud::cpp::compute::wire_groups::v1::PatchWireGroupRequest const& + request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::global_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, request, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::wire_groups::v1:: + PatchWireGroupRequest const& request) { + return stub->AsyncPatchWireGroup(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->PatchWireGroup(request), + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [request](std::string const& op, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest& r) { + r.set_project(request.project()); + r.set_operation(op); + }, + [request](std::string const& op, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest& r) { + r.set_project(request.project()); + r.set_operation(op); + }); +} + +StatusOr +WireGroupsRestConnectionImpl::PatchWireGroup( + NoAwaitTag, + google::cloud::cpp::compute::wire_groups::v1::PatchWireGroupRequest const& + request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->PatchWireGroup(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::wire_groups::v1:: + PatchWireGroupRequest const& request) { + return stub_->PatchWireGroup(rest_context, options, request); + }, + *current, request, __func__); +} + +future> +WireGroupsRestConnectionImpl::PatchWireGroup( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestAwaitLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::global_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest>( + background_->cq(), current, operation, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [operation](std::string const&, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_operation(info.operation); + }, + [operation](std::string const&, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_operation(info.operation); + }); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_wire_groups_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/wire_groups/v1/internal/wire_groups_rest_connection_impl.h b/google/cloud/compute/wire_groups/v1/internal/wire_groups_rest_connection_impl.h new file mode 100644 index 0000000000000..b21f5611d4a59 --- /dev/null +++ b/google/cloud/compute/wire_groups/v1/internal/wire_groups_rest_connection_impl.h @@ -0,0 +1,131 @@ +// Copyright 2026 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. +// source: google/cloud/compute/wire_groups/v1/wire_groups.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_WIRE_GROUPS_V1_INTERNAL_WIRE_GROUPS_REST_CONNECTION_IMPL_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_WIRE_GROUPS_V1_INTERNAL_WIRE_GROUPS_REST_CONNECTION_IMPL_H + +#include "google/cloud/compute/global_operations/v1/global_operations.pb.h" +#include "google/cloud/compute/wire_groups/v1/internal/wire_groups_rest_stub.h" +#include "google/cloud/compute/wire_groups/v1/internal/wire_groups_retry_traits.h" +#include "google/cloud/compute/wire_groups/v1/wire_groups_connection.h" +#include "google/cloud/compute/wire_groups/v1/wire_groups_connection_idempotency_policy.h" +#include "google/cloud/compute/wire_groups/v1/wire_groups_options.h" +#include "google/cloud/background_threads.h" +#include "google/cloud/backoff_policy.h" +#include "google/cloud/options.h" +#include "google/cloud/status_or.h" +#include "google/cloud/stream_range.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_wire_groups_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class WireGroupsRestConnectionImpl + : public compute_wire_groups_v1::WireGroupsConnection { + public: + ~WireGroupsRestConnectionImpl() override = default; + + WireGroupsRestConnectionImpl( + std::unique_ptr background, + std::shared_ptr stub, + Options options); + + Options options() override { return options_; } + + future> DeleteWireGroup( + google::cloud::cpp::compute::wire_groups::v1:: + DeleteWireGroupRequest const& request) override; + + StatusOr DeleteWireGroup( + NoAwaitTag, google::cloud::cpp::compute::wire_groups::v1:: + DeleteWireGroupRequest const& request) override; + + future> DeleteWireGroup( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + StatusOr GetWireGroup( + google::cloud::cpp::compute::wire_groups::v1::GetWireGroupRequest const& + request) override; + + future> InsertWireGroup( + google::cloud::cpp::compute::wire_groups::v1:: + InsertWireGroupRequest const& request) override; + + StatusOr InsertWireGroup( + NoAwaitTag, google::cloud::cpp::compute::wire_groups::v1:: + InsertWireGroupRequest const& request) override; + + future> InsertWireGroup( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + StreamRange ListWireGroups( + google::cloud::cpp::compute::wire_groups::v1::ListWireGroupsRequest + request) override; + + future> PatchWireGroup( + google::cloud::cpp::compute::wire_groups::v1::PatchWireGroupRequest const& + request) override; + + StatusOr PatchWireGroup( + NoAwaitTag, + google::cloud::cpp::compute::wire_groups::v1::PatchWireGroupRequest const& + request) override; + + future> PatchWireGroup( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + private: + static std::unique_ptr + retry_policy(Options const& options) { + return options.get() + ->clone(); + } + + static std::unique_ptr backoff_policy(Options const& options) { + return options.get() + ->clone(); + } + + static std::unique_ptr< + compute_wire_groups_v1::WireGroupsConnectionIdempotencyPolicy> + idempotency_policy(Options const& options) { + return options + .get() + ->clone(); + } + + static std::unique_ptr polling_policy(Options const& options) { + return options.get() + ->clone(); + } + + std::unique_ptr background_; + std::shared_ptr stub_; + Options options_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_wire_groups_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_WIRE_GROUPS_V1_INTERNAL_WIRE_GROUPS_REST_CONNECTION_IMPL_H diff --git a/google/cloud/compute/wire_groups/v1/internal/wire_groups_rest_logging_decorator.cc b/google/cloud/compute/wire_groups/v1/internal/wire_groups_rest_logging_decorator.cc new file mode 100644 index 0000000000000..2cf0083faf290 --- /dev/null +++ b/google/cloud/compute/wire_groups/v1/internal/wire_groups_rest_logging_decorator.cc @@ -0,0 +1,209 @@ +// Copyright 2026 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. +// source: google/cloud/compute/wire_groups/v1/wire_groups.proto + +#include "google/cloud/compute/wire_groups/v1/internal/wire_groups_rest_logging_decorator.h" +#include "google/cloud/internal/log_wrapper.h" +#include "google/cloud/status_or.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_wire_groups_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +WireGroupsRestLogging::WireGroupsRestLogging( + std::shared_ptr child, TracingOptions tracing_options, + std::set components) + : child_(std::move(child)), + tracing_options_(std::move(tracing_options)), + components_(std::move(components)) {} + +future> +WireGroupsRestLogging::AsyncDeleteWireGroup( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::wire_groups::v1::DeleteWireGroupRequest const& + request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::wire_groups::v1:: + DeleteWireGroupRequest const& request) { + return child_->AsyncDeleteWireGroup(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +StatusOr +WireGroupsRestLogging::DeleteWireGroup( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::wire_groups::v1::DeleteWireGroupRequest const& + request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::wire_groups::v1:: + DeleteWireGroupRequest const& request) { + return child_->DeleteWireGroup(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +StatusOr +WireGroupsRestLogging::GetWireGroup( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::wire_groups::v1::GetWireGroupRequest const& + request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::wire_groups::v1:: + GetWireGroupRequest const& request) { + return child_->GetWireGroup(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +future> +WireGroupsRestLogging::AsyncInsertWireGroup( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::wire_groups::v1::InsertWireGroupRequest const& + request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::wire_groups::v1:: + InsertWireGroupRequest const& request) { + return child_->AsyncInsertWireGroup(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +StatusOr +WireGroupsRestLogging::InsertWireGroup( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::wire_groups::v1::InsertWireGroupRequest const& + request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::wire_groups::v1:: + InsertWireGroupRequest const& request) { + return child_->InsertWireGroup(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +StatusOr +WireGroupsRestLogging::ListWireGroups( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::wire_groups::v1::ListWireGroupsRequest const& + request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::wire_groups::v1:: + ListWireGroupsRequest const& request) { + return child_->ListWireGroups(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +future> +WireGroupsRestLogging::AsyncPatchWireGroup( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::wire_groups::v1::PatchWireGroupRequest const& + request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::wire_groups::v1:: + PatchWireGroupRequest const& request) { + return child_->AsyncPatchWireGroup(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +StatusOr +WireGroupsRestLogging::PatchWireGroup( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::wire_groups::v1::PatchWireGroupRequest const& + request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::wire_groups::v1:: + PatchWireGroupRequest const& request) { + return child_->PatchWireGroup(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +future> +WireGroupsRestLogging::AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) { + return child_->AsyncGetOperation(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +future WireGroupsRestLogging::AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) { + return child_->AsyncCancelOperation(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_wire_groups_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/wire_groups/v1/internal/wire_groups_rest_logging_decorator.h b/google/cloud/compute/wire_groups/v1/internal/wire_groups_rest_logging_decorator.h new file mode 100644 index 0000000000000..6caad3be5d99a --- /dev/null +++ b/google/cloud/compute/wire_groups/v1/internal/wire_groups_rest_logging_decorator.h @@ -0,0 +1,125 @@ +// Copyright 2026 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. +// source: google/cloud/compute/wire_groups/v1/wire_groups.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_WIRE_GROUPS_V1_INTERNAL_WIRE_GROUPS_REST_LOGGING_DECORATOR_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_WIRE_GROUPS_V1_INTERNAL_WIRE_GROUPS_REST_LOGGING_DECORATOR_H + +#include "google/cloud/compute/global_operations/v1/global_operations.pb.h" +#include "google/cloud/compute/wire_groups/v1/internal/wire_groups_rest_stub.h" +#include "google/cloud/compute/wire_groups/v1/wire_groups.pb.h" +#include "google/cloud/future.h" +#include "google/cloud/internal/rest_context.h" +#include "google/cloud/tracing_options.h" +#include "google/cloud/version.h" +#include +#include +#include + +namespace google { +namespace cloud { +namespace compute_wire_groups_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class WireGroupsRestLogging : public WireGroupsRestStub { + public: + ~WireGroupsRestLogging() override = default; + WireGroupsRestLogging(std::shared_ptr child, + TracingOptions tracing_options, + std::set components); + + future> + AsyncDeleteWireGroup( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::wire_groups::v1:: + DeleteWireGroupRequest const& request) override; + + StatusOr DeleteWireGroup( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::wire_groups::v1:: + DeleteWireGroupRequest const& request) override; + + StatusOr GetWireGroup( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::wire_groups::v1::GetWireGroupRequest const& + request) override; + + future> + AsyncInsertWireGroup( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::wire_groups::v1:: + InsertWireGroupRequest const& request) override; + + StatusOr InsertWireGroup( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::wire_groups::v1:: + InsertWireGroupRequest const& request) override; + + StatusOr ListWireGroups( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::wire_groups::v1::ListWireGroupsRequest const& + request) override; + + future> + AsyncPatchWireGroup( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::wire_groups::v1::PatchWireGroupRequest const& + request) override; + + StatusOr PatchWireGroup( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::wire_groups::v1::PatchWireGroupRequest const& + request) override; + + future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) override; + + future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) override; + + private: + std::shared_ptr child_; + TracingOptions tracing_options_; + std::set components_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_wire_groups_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_WIRE_GROUPS_V1_INTERNAL_WIRE_GROUPS_REST_LOGGING_DECORATOR_H diff --git a/google/cloud/compute/wire_groups/v1/internal/wire_groups_rest_metadata_decorator.cc b/google/cloud/compute/wire_groups/v1/internal/wire_groups_rest_metadata_decorator.cc new file mode 100644 index 0000000000000..5a7a9791d733a --- /dev/null +++ b/google/cloud/compute/wire_groups/v1/internal/wire_groups_rest_metadata_decorator.cc @@ -0,0 +1,155 @@ +// Copyright 2026 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. +// source: google/cloud/compute/wire_groups/v1/wire_groups.proto + +#include "google/cloud/compute/wire_groups/v1/internal/wire_groups_rest_metadata_decorator.h" +#include "google/cloud/internal/api_client_header.h" +#include "google/cloud/internal/rest_set_metadata.h" +#include "google/cloud/status_or.h" +#include "absl/strings/str_cat.h" +#include "absl/strings/str_format.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_wire_groups_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +WireGroupsRestMetadata::WireGroupsRestMetadata( + std::shared_ptr child, std::string api_client_header) + : child_(std::move(child)), + api_client_header_( + api_client_header.empty() + ? google::cloud::internal::GeneratedLibClientHeader() + : std::move(api_client_header)) {} + +future> +WireGroupsRestMetadata::AsyncDeleteWireGroup( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::wire_groups::v1::DeleteWireGroupRequest const& + request) { + SetMetadata(*rest_context, *options); + return child_->AsyncDeleteWireGroup(cq, std::move(rest_context), + std::move(options), request); +} + +StatusOr +WireGroupsRestMetadata::DeleteWireGroup( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::wire_groups::v1::DeleteWireGroupRequest const& + request) { + SetMetadata(rest_context, options); + return child_->DeleteWireGroup(rest_context, options, request); +} + +StatusOr +WireGroupsRestMetadata::GetWireGroup( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::wire_groups::v1::GetWireGroupRequest const& + request) { + SetMetadata(rest_context, options); + return child_->GetWireGroup(rest_context, options, request); +} + +future> +WireGroupsRestMetadata::AsyncInsertWireGroup( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::wire_groups::v1::InsertWireGroupRequest const& + request) { + SetMetadata(*rest_context, *options); + return child_->AsyncInsertWireGroup(cq, std::move(rest_context), + std::move(options), request); +} + +StatusOr +WireGroupsRestMetadata::InsertWireGroup( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::wire_groups::v1::InsertWireGroupRequest const& + request) { + SetMetadata(rest_context, options); + return child_->InsertWireGroup(rest_context, options, request); +} + +StatusOr +WireGroupsRestMetadata::ListWireGroups( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::wire_groups::v1::ListWireGroupsRequest const& + request) { + SetMetadata(rest_context, options); + return child_->ListWireGroups(rest_context, options, request); +} + +future> +WireGroupsRestMetadata::AsyncPatchWireGroup( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::wire_groups::v1::PatchWireGroupRequest const& + request) { + SetMetadata(*rest_context, *options); + return child_->AsyncPatchWireGroup(cq, std::move(rest_context), + std::move(options), request); +} + +StatusOr +WireGroupsRestMetadata::PatchWireGroup( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::wire_groups::v1::PatchWireGroupRequest const& + request) { + SetMetadata(rest_context, options); + return child_->PatchWireGroup(rest_context, options, request); +} + +future> +WireGroupsRestMetadata::AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncGetOperation(cq, std::move(rest_context), + std::move(options), request); +} + +future WireGroupsRestMetadata::AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncCancelOperation(cq, std::move(rest_context), + std::move(options), request); +} + +void WireGroupsRestMetadata::SetMetadata( + rest_internal::RestContext& rest_context, Options const& options, + std::vector const& params) { + google::cloud::rest_internal::SetMetadata(rest_context, options, params, + api_client_header_); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_wire_groups_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/wire_groups/v1/internal/wire_groups_rest_metadata_decorator.h b/google/cloud/compute/wire_groups/v1/internal/wire_groups_rest_metadata_decorator.h new file mode 100644 index 0000000000000..18d5df27b0c40 --- /dev/null +++ b/google/cloud/compute/wire_groups/v1/internal/wire_groups_rest_metadata_decorator.h @@ -0,0 +1,125 @@ +// Copyright 2026 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. +// source: google/cloud/compute/wire_groups/v1/wire_groups.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_WIRE_GROUPS_V1_INTERNAL_WIRE_GROUPS_REST_METADATA_DECORATOR_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_WIRE_GROUPS_V1_INTERNAL_WIRE_GROUPS_REST_METADATA_DECORATOR_H + +#include "google/cloud/compute/global_operations/v1/global_operations.pb.h" +#include "google/cloud/compute/wire_groups/v1/internal/wire_groups_rest_stub.h" +#include "google/cloud/compute/wire_groups/v1/wire_groups.pb.h" +#include "google/cloud/future.h" +#include "google/cloud/rest_options.h" +#include "google/cloud/version.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_wire_groups_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class WireGroupsRestMetadata : public WireGroupsRestStub { + public: + ~WireGroupsRestMetadata() override = default; + explicit WireGroupsRestMetadata(std::shared_ptr child, + std::string api_client_header = ""); + + google::cloud::future> + AsyncDeleteWireGroup( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::wire_groups::v1:: + DeleteWireGroupRequest const& request) override; + + StatusOr DeleteWireGroup( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::wire_groups::v1:: + DeleteWireGroupRequest const& request) override; + + StatusOr GetWireGroup( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::wire_groups::v1::GetWireGroupRequest const& + request) override; + + google::cloud::future> + AsyncInsertWireGroup( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::wire_groups::v1:: + InsertWireGroupRequest const& request) override; + + StatusOr InsertWireGroup( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::wire_groups::v1:: + InsertWireGroupRequest const& request) override; + + StatusOr ListWireGroups( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::wire_groups::v1::ListWireGroupsRequest const& + request) override; + + google::cloud::future> + AsyncPatchWireGroup( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::wire_groups::v1::PatchWireGroupRequest const& + request) override; + + StatusOr PatchWireGroup( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::wire_groups::v1::PatchWireGroupRequest const& + request) override; + + google::cloud::future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) override; + + google::cloud::future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) override; + + private: + void SetMetadata(rest_internal::RestContext& rest_context, + Options const& options, + std::vector const& params = {}); + + std::shared_ptr child_; + std::string api_client_header_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_wire_groups_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_WIRE_GROUPS_V1_INTERNAL_WIRE_GROUPS_REST_METADATA_DECORATOR_H diff --git a/google/cloud/compute/wire_groups/v1/internal/wire_groups_rest_stub.cc b/google/cloud/compute/wire_groups/v1/internal/wire_groups_rest_stub.cc new file mode 100644 index 0000000000000..70f4b327de57c --- /dev/null +++ b/google/cloud/compute/wire_groups/v1/internal/wire_groups_rest_stub.cc @@ -0,0 +1,338 @@ +// Copyright 2026 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. +// source: google/cloud/compute/wire_groups/v1/wire_groups.proto + +#include "google/cloud/compute/wire_groups/v1/internal/wire_groups_rest_stub.h" +#include "google/cloud/compute/global_operations/v1/global_operations.pb.h" +#include "google/cloud/compute/wire_groups/v1/wire_groups.pb.h" +#include "google/cloud/common_options.h" +#include "google/cloud/internal/rest_stub_helpers.h" +#include "google/cloud/status_or.h" +#include "absl/strings/str_cat.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_wire_groups_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +DefaultWireGroupsRestStub::DefaultWireGroupsRestStub(Options options) + : service_(rest_internal::MakePooledRestClient( + options.get(), options)), + operations_(rest_internal::MakePooledRestClient( + options.get(), options)), + options_(std::move(options)) {} + +DefaultWireGroupsRestStub::DefaultWireGroupsRestStub( + std::shared_ptr service, + std::shared_ptr operations, Options options) + : service_(std::move(service)), + operations_(std::move(operations)), + options_(std::move(options)) {} + +future> +DefaultWireGroupsRestStub::AsyncDeleteWireGroup( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::wire_groups::v1::DeleteWireGroupRequest const& + request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto service, auto request, auto rest_context, auto options) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + p.set_value( + rest_internal::Delete( + *service, *rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", *options), + "/", "projects", "/", request.project(), "/", + "global", "/", "crossSiteNetworks", "/", + request.cross_site_network(), "/", "wireGroups", + "/", request.wire_group()), + std::move(query_params))); + }, + std::move(p), + service_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +StatusOr +DefaultWireGroupsRestStub::DeleteWireGroup( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::wire_groups::v1::DeleteWireGroupRequest const& + request) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Delete( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "global", "/", + "crossSiteNetworks", "/", request.cross_site_network(), "/", + "wireGroups", "/", request.wire_group()), + std::move(query_params)); +} + +StatusOr +DefaultWireGroupsRestStub::GetWireGroup( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::wire_groups::v1::GetWireGroupRequest const& + request) { + std::vector> query_params; + return rest_internal::Get( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "global", "/", + "crossSiteNetworks", "/", request.cross_site_network(), "/", + "wireGroups", "/", request.wire_group()), + std::move(query_params)); +} + +future> +DefaultWireGroupsRestStub::AsyncInsertWireGroup( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::wire_groups::v1::InsertWireGroupRequest const& + request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto service, auto request, auto rest_context, auto options) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params.push_back( + {"validate_only", (request.validate_only() ? "1" : "0")}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + p.set_value( + rest_internal::Post( + *service, *rest_context, request.wire_group_resource(), false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", *options), + "/", "projects", "/", request.project(), "/", + "global", "/", "crossSiteNetworks", "/", + request.cross_site_network(), "/", "wireGroups"), + std::move(query_params))); + }, + std::move(p), + service_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +StatusOr +DefaultWireGroupsRestStub::InsertWireGroup( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::wire_groups::v1::InsertWireGroupRequest const& + request) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params.push_back( + {"validate_only", (request.validate_only() ? "1" : "0")}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Post( + *service_, rest_context, request.wire_group_resource(), false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "global", "/", + "crossSiteNetworks", "/", request.cross_site_network(), "/", + "wireGroups"), + std::move(query_params)); +} + +StatusOr +DefaultWireGroupsRestStub::ListWireGroups( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::wire_groups::v1::ListWireGroupsRequest const& + request) { + std::vector> query_params; + query_params.push_back({"filter", request.filter()}); + query_params.push_back( + {"max_results", std::to_string(request.max_results())}); + query_params.push_back({"order_by", request.order_by()}); + query_params.push_back({"page_token", request.page_token()}); + query_params.push_back({"return_partial_success", + (request.return_partial_success() ? "1" : "0")}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Get( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "global", "/", + "crossSiteNetworks", "/", request.cross_site_network(), "/", + "wireGroups"), + std::move(query_params)); +} + +future> +DefaultWireGroupsRestStub::AsyncPatchWireGroup( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::wire_groups::v1::PatchWireGroupRequest const& + request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto service, auto request, auto rest_context, auto options) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params.push_back({"update_mask", request.update_mask()}); + query_params.push_back( + {"validate_only", (request.validate_only() ? "1" : "0")}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + p.set_value( + rest_internal::Patch( + *service, *rest_context, request.wire_group_resource(), false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", *options), + "/", "projects", "/", request.project(), "/", + "global", "/", "crossSiteNetworks", "/", + request.cross_site_network(), "/", "wireGroups", + "/", request.wire_group()), + std::move(query_params))); + }, + std::move(p), + service_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +StatusOr +DefaultWireGroupsRestStub::PatchWireGroup( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::wire_groups::v1::PatchWireGroupRequest const& + request) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params.push_back({"update_mask", request.update_mask()}); + query_params.push_back( + {"validate_only", (request.validate_only() ? "1" : "0")}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Patch( + *service_, rest_context, request.wire_group_resource(), false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "global", "/", + "crossSiteNetworks", "/", request.cross_site_network(), "/", + "wireGroups", "/", request.wire_group()), + std::move(query_params)); +} + +future> +DefaultWireGroupsRestStub::AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto operations, auto request, auto rest_context, + auto options) { + p.set_value( + rest_internal::Get( + *operations, *rest_context, request, false, + absl::StrCat("/compute/", + rest_internal::DetermineApiVersion("v1", *options), + "/projects/", request.project(), + "/global/operations/", request.operation()))); + }, + std::move(p), + operations_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +future DefaultWireGroupsRestStub::AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) { + promise> p; + future> f = p.get_future(); + std::thread t{ + [](auto p, auto operations, auto request, auto rest_context, + auto options) { + p.set_value(rest_internal::Post( + *operations, *rest_context, request, false, + absl::StrCat("/compute/", + rest_internal::DetermineApiVersion("v1", *options), + "/projects/", request.project(), "/global/operations/", + request.operation()))); + }, + std::move(p), + operations_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get().status(); + }); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_wire_groups_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/wire_groups/v1/internal/wire_groups_rest_stub.h b/google/cloud/compute/wire_groups/v1/internal/wire_groups_rest_stub.h new file mode 100644 index 0000000000000..5a2aa86a1df6e --- /dev/null +++ b/google/cloud/compute/wire_groups/v1/internal/wire_groups_rest_stub.h @@ -0,0 +1,200 @@ +// Copyright 2026 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. +// source: google/cloud/compute/wire_groups/v1/wire_groups.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_WIRE_GROUPS_V1_INTERNAL_WIRE_GROUPS_REST_STUB_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_WIRE_GROUPS_V1_INTERNAL_WIRE_GROUPS_REST_STUB_H + +#include "google/cloud/compute/global_operations/v1/global_operations.pb.h" +#include "google/cloud/compute/wire_groups/v1/wire_groups.pb.h" +#include "google/cloud/completion_queue.h" +#include "google/cloud/internal/rest_client.h" +#include "google/cloud/internal/rest_context.h" +#include "google/cloud/status_or.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_wire_groups_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class WireGroupsRestStub { + public: + virtual ~WireGroupsRestStub() = default; + + virtual future> + AsyncDeleteWireGroup( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::wire_groups::v1:: + DeleteWireGroupRequest const& request) = 0; + + virtual StatusOr DeleteWireGroup( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::wire_groups::v1:: + DeleteWireGroupRequest const& request) = 0; + + virtual StatusOr GetWireGroup( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::wire_groups::v1::GetWireGroupRequest const& + request) = 0; + + virtual future> + AsyncInsertWireGroup( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::wire_groups::v1:: + InsertWireGroupRequest const& request) = 0; + + virtual StatusOr InsertWireGroup( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::wire_groups::v1:: + InsertWireGroupRequest const& request) = 0; + + virtual StatusOr + ListWireGroups( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::wire_groups::v1::ListWireGroupsRequest const& + request) = 0; + + virtual future> + AsyncPatchWireGroup( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::wire_groups::v1::PatchWireGroupRequest const& + request) = 0; + + virtual StatusOr PatchWireGroup( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::wire_groups::v1::PatchWireGroupRequest const& + request) = 0; + + virtual future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) = 0; + + virtual future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) = 0; +}; + +class DefaultWireGroupsRestStub : public WireGroupsRestStub { + public: + ~DefaultWireGroupsRestStub() override = default; + + explicit DefaultWireGroupsRestStub(Options options); + DefaultWireGroupsRestStub( + std::shared_ptr service, + std::shared_ptr operations, Options options); + + future> + AsyncDeleteWireGroup( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::wire_groups::v1:: + DeleteWireGroupRequest const& request) override; + + StatusOr DeleteWireGroup( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::wire_groups::v1:: + DeleteWireGroupRequest const& request) override; + + StatusOr GetWireGroup( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::wire_groups::v1::GetWireGroupRequest const& + request) override; + + future> + AsyncInsertWireGroup( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::wire_groups::v1:: + InsertWireGroupRequest const& request) override; + + StatusOr InsertWireGroup( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::wire_groups::v1:: + InsertWireGroupRequest const& request) override; + + StatusOr ListWireGroups( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::wire_groups::v1::ListWireGroupsRequest const& + request) override; + + future> + AsyncPatchWireGroup( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::wire_groups::v1::PatchWireGroupRequest const& + request) override; + + StatusOr PatchWireGroup( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::wire_groups::v1::PatchWireGroupRequest const& + request) override; + + future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + GetOperationRequest const& request) override; + + future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::global_operations::v1:: + DeleteOperationRequest const& request) override; + + private: + std::shared_ptr service_; + std::shared_ptr operations_; + Options options_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_wire_groups_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_WIRE_GROUPS_V1_INTERNAL_WIRE_GROUPS_REST_STUB_H diff --git a/google/cloud/compute/wire_groups/v1/internal/wire_groups_rest_stub_factory.cc b/google/cloud/compute/wire_groups/v1/internal/wire_groups_rest_stub_factory.cc new file mode 100644 index 0000000000000..8d9ecae92067d --- /dev/null +++ b/google/cloud/compute/wire_groups/v1/internal/wire_groups_rest_stub_factory.cc @@ -0,0 +1,56 @@ +// Copyright 2026 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. +// source: google/cloud/compute/wire_groups/v1/wire_groups.proto + +#include "google/cloud/compute/wire_groups/v1/internal/wire_groups_rest_stub_factory.h" +#include "google/cloud/compute/wire_groups/v1/internal/wire_groups_rest_logging_decorator.h" +#include "google/cloud/compute/wire_groups/v1/internal/wire_groups_rest_metadata_decorator.h" +#include "google/cloud/compute/wire_groups/v1/internal/wire_groups_rest_stub.h" +#include "google/cloud/common_options.h" +#include "google/cloud/internal/algorithm.h" +#include "google/cloud/internal/populate_rest_options.h" +#include "google/cloud/log.h" +#include "google/cloud/options.h" +#include "google/cloud/rest_options.h" +#include "absl/strings/match.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_wire_groups_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +std::shared_ptr CreateDefaultWireGroupsRestStub( + Options const& options) { + auto opts = internal::PopulateRestOptions(options); + std::shared_ptr stub = + std::make_shared(std::move(opts)); + stub = std::make_shared(std::move(stub)); + if (internal::Contains(options.get(), "rpc")) { + GCP_LOG(INFO) << "Enabled logging for REST rpc calls"; + stub = std::make_shared( + std::move(stub), options.get(), + options.get()); + } + return stub; +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_wire_groups_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/wire_groups/v1/internal/wire_groups_rest_stub_factory.h b/google/cloud/compute/wire_groups/v1/internal/wire_groups_rest_stub_factory.h new file mode 100644 index 0000000000000..608251bdab6e4 --- /dev/null +++ b/google/cloud/compute/wire_groups/v1/internal/wire_groups_rest_stub_factory.h @@ -0,0 +1,40 @@ +// Copyright 2026 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. +// source: google/cloud/compute/wire_groups/v1/wire_groups.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_WIRE_GROUPS_V1_INTERNAL_WIRE_GROUPS_REST_STUB_FACTORY_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_WIRE_GROUPS_V1_INTERNAL_WIRE_GROUPS_REST_STUB_FACTORY_H + +#include "google/cloud/compute/wire_groups/v1/internal/wire_groups_rest_stub.h" +#include "google/cloud/options.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_wire_groups_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +std::shared_ptr CreateDefaultWireGroupsRestStub( + Options const& options); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_wire_groups_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_WIRE_GROUPS_V1_INTERNAL_WIRE_GROUPS_REST_STUB_FACTORY_H diff --git a/google/cloud/compute/wire_groups/v1/internal/wire_groups_retry_traits.h b/google/cloud/compute/wire_groups/v1/internal/wire_groups_retry_traits.h new file mode 100644 index 0000000000000..c59c8cf1e8571 --- /dev/null +++ b/google/cloud/compute/wire_groups/v1/internal/wire_groups_retry_traits.h @@ -0,0 +1,43 @@ +// Copyright 2026 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. +// source: google/cloud/compute/wire_groups/v1/wire_groups.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_WIRE_GROUPS_V1_INTERNAL_WIRE_GROUPS_RETRY_TRAITS_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_WIRE_GROUPS_V1_INTERNAL_WIRE_GROUPS_RETRY_TRAITS_H + +#include "google/cloud/status.h" +#include "google/cloud/version.h" + +namespace google { +namespace cloud { +namespace compute_wire_groups_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/// Define the gRPC status code semantics for retrying requests. +struct WireGroupsRetryTraits { + static bool IsPermanentFailure(google::cloud::Status const& status) { + return status.code() != StatusCode::kOk && + status.code() != StatusCode::kUnavailable; + } +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_wire_groups_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_WIRE_GROUPS_V1_INTERNAL_WIRE_GROUPS_RETRY_TRAITS_H diff --git a/google/cloud/compute/wire_groups/v1/internal/wire_groups_sources.cc b/google/cloud/compute/wire_groups/v1/internal/wire_groups_sources.cc new file mode 100644 index 0000000000000..61e873013810f --- /dev/null +++ b/google/cloud/compute/wire_groups/v1/internal/wire_groups_sources.cc @@ -0,0 +1,31 @@ +// Copyright 2026 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. +// source: google/cloud/compute/wire_groups/v1/wire_groups.proto + +// NOLINTBEGIN(bugprone-suspicious-include) +#include "google/cloud/compute/wire_groups/v1/internal/wire_groups_option_defaults.cc" +#include "google/cloud/compute/wire_groups/v1/internal/wire_groups_rest_connection_impl.cc" +#include "google/cloud/compute/wire_groups/v1/internal/wire_groups_rest_logging_decorator.cc" +#include "google/cloud/compute/wire_groups/v1/internal/wire_groups_rest_metadata_decorator.cc" +#include "google/cloud/compute/wire_groups/v1/internal/wire_groups_rest_stub.cc" +#include "google/cloud/compute/wire_groups/v1/internal/wire_groups_rest_stub_factory.cc" +#include "google/cloud/compute/wire_groups/v1/internal/wire_groups_tracing_connection.cc" +#include "google/cloud/compute/wire_groups/v1/wire_groups_client.cc" +#include "google/cloud/compute/wire_groups/v1/wire_groups_connection.cc" +#include "google/cloud/compute/wire_groups/v1/wire_groups_connection_idempotency_policy.cc" +#include "google/cloud/compute/wire_groups/v1/wire_groups_rest_connection.cc" +// NOLINTEND(bugprone-suspicious-include) diff --git a/google/cloud/compute/wire_groups/v1/internal/wire_groups_tracing_connection.cc b/google/cloud/compute/wire_groups/v1/internal/wire_groups_tracing_connection.cc new file mode 100644 index 0000000000000..3d111b57af93c --- /dev/null +++ b/google/cloud/compute/wire_groups/v1/internal/wire_groups_tracing_connection.cc @@ -0,0 +1,162 @@ +// Copyright 2026 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. +// source: google/cloud/compute/wire_groups/v1/wire_groups.proto + +#include "google/cloud/compute/wire_groups/v1/internal/wire_groups_tracing_connection.h" +#include "google/cloud/internal/opentelemetry.h" +#include "google/cloud/internal/traced_stream_range.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_wire_groups_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +WireGroupsTracingConnection::WireGroupsTracingConnection( + std::shared_ptr child) + : child_(std::move(child)) {} + +future> +WireGroupsTracingConnection::DeleteWireGroup( + google::cloud::cpp::compute::wire_groups::v1::DeleteWireGroupRequest const& + request) { + auto span = internal::MakeSpan( + "compute_wire_groups_v1::WireGroupsConnection::DeleteWireGroup"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), child_->DeleteWireGroup(request)); +} + +StatusOr +WireGroupsTracingConnection::DeleteWireGroup( + NoAwaitTag, + google::cloud::cpp::compute::wire_groups::v1::DeleteWireGroupRequest const& + request) { + auto span = internal::MakeSpan( + "compute_wire_groups_v1::WireGroupsConnection::DeleteWireGroup"); + opentelemetry::trace::Scope scope(span); + return internal::EndSpan(*span, + child_->DeleteWireGroup(NoAwaitTag{}, request)); +} + +future> +WireGroupsTracingConnection::DeleteWireGroup( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto span = internal::MakeSpan( + "compute_wire_groups_v1::WireGroupsConnection::DeleteWireGroup"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), child_->DeleteWireGroup(operation)); +} + +StatusOr +WireGroupsTracingConnection::GetWireGroup( + google::cloud::cpp::compute::wire_groups::v1::GetWireGroupRequest const& + request) { + auto span = internal::MakeSpan( + "compute_wire_groups_v1::WireGroupsConnection::GetWireGroup"); + auto scope = opentelemetry::trace::Scope(span); + return internal::EndSpan(*span, child_->GetWireGroup(request)); +} + +future> +WireGroupsTracingConnection::InsertWireGroup( + google::cloud::cpp::compute::wire_groups::v1::InsertWireGroupRequest const& + request) { + auto span = internal::MakeSpan( + "compute_wire_groups_v1::WireGroupsConnection::InsertWireGroup"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), child_->InsertWireGroup(request)); +} + +StatusOr +WireGroupsTracingConnection::InsertWireGroup( + NoAwaitTag, + google::cloud::cpp::compute::wire_groups::v1::InsertWireGroupRequest const& + request) { + auto span = internal::MakeSpan( + "compute_wire_groups_v1::WireGroupsConnection::InsertWireGroup"); + opentelemetry::trace::Scope scope(span); + return internal::EndSpan(*span, + child_->InsertWireGroup(NoAwaitTag{}, request)); +} + +future> +WireGroupsTracingConnection::InsertWireGroup( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto span = internal::MakeSpan( + "compute_wire_groups_v1::WireGroupsConnection::InsertWireGroup"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), child_->InsertWireGroup(operation)); +} + +StreamRange +WireGroupsTracingConnection::ListWireGroups( + google::cloud::cpp::compute::wire_groups::v1::ListWireGroupsRequest + request) { + auto span = internal::MakeSpan( + "compute_wire_groups_v1::WireGroupsConnection::ListWireGroups"); + internal::OTelScope scope(span); + auto sr = child_->ListWireGroups(std::move(request)); + return internal::MakeTracedStreamRange< + google::cloud::cpp::compute::v1::WireGroup>(std::move(span), + std::move(sr)); +} + +future> +WireGroupsTracingConnection::PatchWireGroup( + google::cloud::cpp::compute::wire_groups::v1::PatchWireGroupRequest const& + request) { + auto span = internal::MakeSpan( + "compute_wire_groups_v1::WireGroupsConnection::PatchWireGroup"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), child_->PatchWireGroup(request)); +} + +StatusOr +WireGroupsTracingConnection::PatchWireGroup( + NoAwaitTag, + google::cloud::cpp::compute::wire_groups::v1::PatchWireGroupRequest const& + request) { + auto span = internal::MakeSpan( + "compute_wire_groups_v1::WireGroupsConnection::PatchWireGroup"); + opentelemetry::trace::Scope scope(span); + return internal::EndSpan(*span, + child_->PatchWireGroup(NoAwaitTag{}, request)); +} + +future> +WireGroupsTracingConnection::PatchWireGroup( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto span = internal::MakeSpan( + "compute_wire_groups_v1::WireGroupsConnection::PatchWireGroup"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), child_->PatchWireGroup(operation)); +} + +std::shared_ptr +MakeWireGroupsTracingConnection( + std::shared_ptr conn) { + if (internal::TracingEnabled(conn->options())) { + conn = std::make_shared(std::move(conn)); + } + return conn; +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_wire_groups_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/wire_groups/v1/internal/wire_groups_tracing_connection.h b/google/cloud/compute/wire_groups/v1/internal/wire_groups_tracing_connection.h new file mode 100644 index 0000000000000..828b4c429c9b2 --- /dev/null +++ b/google/cloud/compute/wire_groups/v1/internal/wire_groups_tracing_connection.h @@ -0,0 +1,102 @@ +// Copyright 2026 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. +// source: google/cloud/compute/wire_groups/v1/wire_groups.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_WIRE_GROUPS_V1_INTERNAL_WIRE_GROUPS_TRACING_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_WIRE_GROUPS_V1_INTERNAL_WIRE_GROUPS_TRACING_CONNECTION_H + +#include "google/cloud/compute/wire_groups/v1/wire_groups_connection.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_wire_groups_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class WireGroupsTracingConnection + : public compute_wire_groups_v1::WireGroupsConnection { + public: + ~WireGroupsTracingConnection() override = default; + + explicit WireGroupsTracingConnection( + std::shared_ptr child); + + Options options() override { return child_->options(); } + + future> DeleteWireGroup( + google::cloud::cpp::compute::wire_groups::v1:: + DeleteWireGroupRequest const& request) override; + + StatusOr DeleteWireGroup( + NoAwaitTag, google::cloud::cpp::compute::wire_groups::v1:: + DeleteWireGroupRequest const& request) override; + + future> DeleteWireGroup( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + StatusOr GetWireGroup( + google::cloud::cpp::compute::wire_groups::v1::GetWireGroupRequest const& + request) override; + + future> InsertWireGroup( + google::cloud::cpp::compute::wire_groups::v1:: + InsertWireGroupRequest const& request) override; + + StatusOr InsertWireGroup( + NoAwaitTag, google::cloud::cpp::compute::wire_groups::v1:: + InsertWireGroupRequest const& request) override; + + future> InsertWireGroup( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + StreamRange ListWireGroups( + google::cloud::cpp::compute::wire_groups::v1::ListWireGroupsRequest + request) override; + + future> PatchWireGroup( + google::cloud::cpp::compute::wire_groups::v1::PatchWireGroupRequest const& + request) override; + + StatusOr PatchWireGroup( + NoAwaitTag, + google::cloud::cpp::compute::wire_groups::v1::PatchWireGroupRequest const& + request) override; + + future> PatchWireGroup( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + private: + std::shared_ptr child_; +}; + +/** + * Conditionally applies the tracing decorator to the given connection. + * + * The connection is only decorated if tracing is enabled (as determined by the + * connection's options). + */ +std::shared_ptr +MakeWireGroupsTracingConnection( + std::shared_ptr conn); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_wire_groups_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_WIRE_GROUPS_V1_INTERNAL_WIRE_GROUPS_TRACING_CONNECTION_H diff --git a/google/cloud/compute/wire_groups/v1/mocks/mock_wire_groups_connection.h b/google/cloud/compute/wire_groups/v1/mocks/mock_wire_groups_connection.h new file mode 100644 index 0000000000000..ed84baf96b42b --- /dev/null +++ b/google/cloud/compute/wire_groups/v1/mocks/mock_wire_groups_connection.h @@ -0,0 +1,191 @@ +// Copyright 2026 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. +// source: google/cloud/compute/wire_groups/v1/wire_groups.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_WIRE_GROUPS_V1_MOCKS_MOCK_WIRE_GROUPS_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_WIRE_GROUPS_V1_MOCKS_MOCK_WIRE_GROUPS_CONNECTION_H + +#include "google/cloud/compute/wire_groups/v1/wire_groups_connection.h" +#include + +namespace google { +namespace cloud { +namespace compute_wire_groups_v1_mocks { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/** + * A class to mock `WireGroupsConnection`. + * + * Application developers may want to test their code with simulated responses, + * including errors, from an object of type `WireGroupsClient`. To do so, + * construct an object of type `WireGroupsClient` with an instance of this + * class. Then use the Google Test framework functions to program the behavior + * of this mock. + * + * @see [This example][bq-mock] for how to test your application with GoogleTest. + * While the example showcases types from the BigQuery library, the underlying + * principles apply for any pair of `*Client` and `*Connection`. + * + * [bq-mock]: @cloud_cpp_docs_link{bigquery,bigquery-read-mock} + */ +class MockWireGroupsConnection + : public compute_wire_groups_v1::WireGroupsConnection { + public: + MOCK_METHOD(Options, options, (), (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// DeleteWireGroup(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + DeleteWireGroup, + (google::cloud::cpp::compute::wire_groups::v1:: + DeleteWireGroupRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// EXPECT_CALL(*mock, DeleteWireGroup(_, _)) + /// @endcode + MOCK_METHOD(StatusOr, + DeleteWireGroup, + (NoAwaitTag, google::cloud::cpp::compute::wire_groups::v1:: + DeleteWireGroupRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// DeleteWireGroup(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + DeleteWireGroup, + (google::cloud::cpp::compute::v1::Operation const& operation), + (override)); + + MOCK_METHOD( + StatusOr, GetWireGroup, + (google::cloud::cpp::compute::wire_groups::v1::GetWireGroupRequest const& + request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// InsertWireGroup(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + InsertWireGroup, + (google::cloud::cpp::compute::wire_groups::v1:: + InsertWireGroupRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// EXPECT_CALL(*mock, InsertWireGroup(_, _)) + /// @endcode + MOCK_METHOD(StatusOr, + InsertWireGroup, + (NoAwaitTag, google::cloud::cpp::compute::wire_groups::v1:: + InsertWireGroupRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// InsertWireGroup(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + InsertWireGroup, + (google::cloud::cpp::compute::v1::Operation const& operation), + (override)); + + MOCK_METHOD( + (StreamRange), ListWireGroups, + (google::cloud::cpp::compute::wire_groups::v1::ListWireGroupsRequest + request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// PatchWireGroup(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + PatchWireGroup, + (google::cloud::cpp::compute::wire_groups::v1:: + PatchWireGroupRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// EXPECT_CALL(*mock, PatchWireGroup(_, _)) + /// @endcode + MOCK_METHOD(StatusOr, + PatchWireGroup, + (NoAwaitTag, google::cloud::cpp::compute::wire_groups::v1:: + PatchWireGroupRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// PatchWireGroup(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + PatchWireGroup, + (google::cloud::cpp::compute::v1::Operation const& operation), + (override)); +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_wire_groups_v1_mocks +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_WIRE_GROUPS_V1_MOCKS_MOCK_WIRE_GROUPS_CONNECTION_H diff --git a/google/cloud/compute/wire_groups/v1/samples/wire_groups_client_samples.cc b/google/cloud/compute/wire_groups/v1/samples/wire_groups_client_samples.cc new file mode 100644 index 0000000000000..3e87b1f5703f7 --- /dev/null +++ b/google/cloud/compute/wire_groups/v1/samples/wire_groups_client_samples.cc @@ -0,0 +1,234 @@ +// Copyright 2026 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. +// source: google/cloud/compute/wire_groups/v1/wire_groups.proto + +#include "google/cloud/compute/wire_groups/v1/wire_groups_client.h" +#include "google/cloud/compute/wire_groups/v1/wire_groups_connection_idempotency_policy.h" +#include "google/cloud/compute/wire_groups/v1/wire_groups_options.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/internal/getenv.h" +#include "google/cloud/polling_policy.h" +#include "google/cloud/testing_util/example_driver.h" +#include "google/cloud/universe_domain.h" +#include +#include +#include +#include + +// clang-format off +// main-dox-marker: compute_wire_groups_v1::WireGroupsClient +// lro-marker: true +// clang-format on +namespace { + +void SetClientEndpoint(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-endpoint"}; + } + //! [set-client-endpoint] + // This configuration is common with Private Google Access: + // https://cloud.google.com/vpc/docs/private-google-access + auto options = google::cloud::Options{}.set( + "private.googleapis.com"); + auto vpc_client = google::cloud::compute_wire_groups_v1::WireGroupsClient( + google::cloud::compute_wire_groups_v1::MakeWireGroupsConnectionRest( + options)); + //! [set-client-endpoint] +} + +void SetClientUniverseDomain(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-universe-domain"}; + } + //! [set-client-universe-domain] + google::cloud::Options options; + + // AddUniverseDomainOption interrogates the UnifiedCredentialsOption, if set, + // in the provided Options for the Universe Domain associated with the + // credentials and adds it to the set of Options. + // If no UnifiedCredentialsOption is set, GoogleDefaultCredentials are used. + auto ud_options = google::cloud::AddUniverseDomainOption(std::move(options)); + + if (!ud_options.ok()) throw std::move(ud_options).status(); + auto ud_client = google::cloud::compute_wire_groups_v1::WireGroupsClient( + google::cloud::compute_wire_groups_v1::MakeWireGroupsConnectionRest( + *ud_options)); + //! [set-client-universe-domain] +} + +//! [custom-idempotency-policy] +class CustomIdempotencyPolicy : public google::cloud::compute_wire_groups_v1:: + WireGroupsConnectionIdempotencyPolicy { + public: + ~CustomIdempotencyPolicy() override = default; + std::unique_ptr + clone() const override { + return std::make_unique(*this); + } + // Override inherited functions to define as needed. +}; +//! [custom-idempotency-policy] + +void SetRetryPolicy(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-retry-policy"}; + } + //! [set-retry-policy] + auto options = google::cloud::Options{} + .set( + CustomIdempotencyPolicy().clone()) + .set( + google::cloud::compute_wire_groups_v1:: + WireGroupsLimitedErrorCountRetryPolicy(3) + .clone()) + .set( + google::cloud::ExponentialBackoffPolicy( + /*initial_delay=*/std::chrono::milliseconds(200), + /*maximum_delay=*/std::chrono::seconds(45), + /*scaling=*/2.0) + .clone()); + auto connection = + google::cloud::compute_wire_groups_v1::MakeWireGroupsConnectionRest( + options); + + // c1 and c2 share the same retry policies + auto c1 = google::cloud::compute_wire_groups_v1::WireGroupsClient(connection); + auto c2 = google::cloud::compute_wire_groups_v1::WireGroupsClient(connection); + + // You can override any of the policies in a new client. This new client + // will share the policies from c1 (or c2) *except* for the retry policy. + auto c3 = google::cloud::compute_wire_groups_v1::WireGroupsClient( + connection, + google::cloud::Options{} + .set( + google::cloud::compute_wire_groups_v1:: + WireGroupsLimitedTimeRetryPolicy(std::chrono::minutes(5)) + .clone())); + + // You can also override the policies in a single call: + // c3.SomeRpc(..., google::cloud::Options{} + // .set( + // google::cloud::compute_wire_groups_v1::WireGroupsLimitedErrorCountRetryPolicy(10).clone())); + //! [set-retry-policy] +} + +void SetPollingPolicy(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-policy-policy"}; + } + //! [set-polling-policy] + + // The polling policy controls how the client waits for long-running + // operations. `GenericPollingPolicy<>` combines existing policies. + // In this case, keep polling until the operation completes (with success + // or error) or 45 minutes, whichever happens first. Initially pause for + // 10 seconds between polling requests, increasing the pause by a factor + // of 4 until it becomes 2 minutes. + auto options = + google::cloud::Options{} + .set( + google::cloud::GenericPollingPolicy< + google::cloud::compute_wire_groups_v1:: + WireGroupsRetryPolicyOption::Type, + google::cloud::compute_wire_groups_v1:: + WireGroupsBackoffPolicyOption::Type>( + google::cloud::compute_wire_groups_v1:: + WireGroupsLimitedTimeRetryPolicy( + /*maximum_duration=*/std::chrono::minutes(45)) + .clone(), + google::cloud::ExponentialBackoffPolicy( + /*initial_delay=*/std::chrono::seconds(10), + /*maximum_delay=*/std::chrono::minutes(2), + /*scaling=*/4.0) + .clone()) + .clone()); + + auto connection = + google::cloud::compute_wire_groups_v1::MakeWireGroupsConnectionRest( + options); + + // c1 and c2 share the same polling policies. + auto c1 = google::cloud::compute_wire_groups_v1::WireGroupsClient(connection); + auto c2 = google::cloud::compute_wire_groups_v1::WireGroupsClient(connection); + //! [set-polling-policy] +} + +void WithServiceAccount(std::vector const& argv) { + if (argv.size() != 1 || argv[0] == "--help") { + throw google::cloud::testing_util::Usage{"with-service-account "}; + } + //! [with-service-account] + [](std::string const& keyfile) { + auto is = std::ifstream(keyfile); + is.exceptions(std::ios::badbit); // Minimal error handling in examples + auto contents = std::string(std::istreambuf_iterator(is.rdbuf()), {}); + auto options = + google::cloud::Options{}.set( + google::cloud::MakeServiceAccountCredentials(contents)); + return google::cloud::compute_wire_groups_v1::WireGroupsClient( + google::cloud::compute_wire_groups_v1::MakeWireGroupsConnectionRest( + options)); + } + //! [with-service-account] + (argv.at(0)); +} + +void AutoRun(std::vector const& argv) { + namespace examples = ::google::cloud::testing_util; + using ::google::cloud::internal::GetEnv; + if (!argv.empty()) throw examples::Usage{"auto"}; + examples::CheckEnvironmentVariablesAreSet( + {"GOOGLE_CLOUD_CPP_TEST_SERVICE_ACCOUNT_KEYFILE"}); + auto const keyfile = + GetEnv("GOOGLE_CLOUD_CPP_TEST_SERVICE_ACCOUNT_KEYFILE").value(); + + std::cout << "\nRunning SetClientEndpoint() example" << std::endl; + SetClientEndpoint({}); + + std::cout << "\nRunning SetRetryPolicy() example" << std::endl; + SetRetryPolicy({}); + + std::cout << "\nRunning SetPollingPolicy() example" << std::endl; + SetPollingPolicy({}); + + std::cout << "\nRunning WithServiceAccount() example" << std::endl; + WithServiceAccount({keyfile}); + + std::cout << "\nRunning SetClientUniverseDomain() example" << std::endl; + SetClientUniverseDomain({}); +} + +} // namespace + +int main(int argc, char* argv[]) { // NOLINT(bugprone-exception-escape) + google::cloud::testing_util::Example example({ + {"set-client-endpoint", SetClientEndpoint}, + {"set-retry-policy", SetRetryPolicy}, + {"set-polling-policy", SetPollingPolicy}, + {"with-service-account", WithServiceAccount}, + {"set-client-universe-domain", SetClientUniverseDomain}, + {"auto", AutoRun}, + }); + return example.Run(argc, argv); +} diff --git a/google/cloud/compute/wire_groups/v1/wire_groups_client.cc b/google/cloud/compute/wire_groups/v1/wire_groups_client.cc new file mode 100644 index 0000000000000..106a251b532b2 --- /dev/null +++ b/google/cloud/compute/wire_groups/v1/wire_groups_client.cc @@ -0,0 +1,240 @@ +// Copyright 2026 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. +// source: google/cloud/compute/wire_groups/v1/wire_groups.proto + +#include "google/cloud/compute/wire_groups/v1/wire_groups_client.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_wire_groups_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +WireGroupsClient::WireGroupsClient( + std::shared_ptr connection, Options opts) + : connection_(std::move(connection)), + options_( + internal::MergeOptions(std::move(opts), connection_->options())) {} +WireGroupsClient::~WireGroupsClient() = default; + +future> +WireGroupsClient::DeleteWireGroup(std::string const& project, + std::string const& cross_site_network, + std::string const& wire_group, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::wire_groups::v1::DeleteWireGroupRequest request; + request.set_project(project); + request.set_cross_site_network(cross_site_network); + request.set_wire_group(wire_group); + return connection_->DeleteWireGroup(request); +} + +StatusOr +WireGroupsClient::DeleteWireGroup(NoAwaitTag, std::string const& project, + std::string const& cross_site_network, + std::string const& wire_group, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::wire_groups::v1::DeleteWireGroupRequest request; + request.set_project(project); + request.set_cross_site_network(cross_site_network); + request.set_wire_group(wire_group); + return connection_->DeleteWireGroup(NoAwaitTag{}, request); +} + +future> +WireGroupsClient::DeleteWireGroup( + google::cloud::cpp::compute::wire_groups::v1::DeleteWireGroupRequest const& + request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->DeleteWireGroup(request); +} + +StatusOr +WireGroupsClient::DeleteWireGroup( + NoAwaitTag, + google::cloud::cpp::compute::wire_groups::v1::DeleteWireGroupRequest const& + request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->DeleteWireGroup(NoAwaitTag{}, request); +} + +future> +WireGroupsClient::DeleteWireGroup( + google::cloud::cpp::compute::v1::Operation const& operation, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->DeleteWireGroup(operation); +} + +StatusOr +WireGroupsClient::GetWireGroup(std::string const& project, + std::string const& cross_site_network, + std::string const& wire_group, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::wire_groups::v1::GetWireGroupRequest request; + request.set_project(project); + request.set_cross_site_network(cross_site_network); + request.set_wire_group(wire_group); + return connection_->GetWireGroup(request); +} + +StatusOr +WireGroupsClient::GetWireGroup( + google::cloud::cpp::compute::wire_groups::v1::GetWireGroupRequest const& + request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->GetWireGroup(request); +} + +future> +WireGroupsClient::InsertWireGroup( + std::string const& project, std::string const& cross_site_network, + google::cloud::cpp::compute::v1::WireGroup const& wire_group_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::wire_groups::v1::InsertWireGroupRequest request; + request.set_project(project); + request.set_cross_site_network(cross_site_network); + *request.mutable_wire_group_resource() = wire_group_resource; + return connection_->InsertWireGroup(request); +} + +StatusOr +WireGroupsClient::InsertWireGroup( + NoAwaitTag, std::string const& project, + std::string const& cross_site_network, + google::cloud::cpp::compute::v1::WireGroup const& wire_group_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::wire_groups::v1::InsertWireGroupRequest request; + request.set_project(project); + request.set_cross_site_network(cross_site_network); + *request.mutable_wire_group_resource() = wire_group_resource; + return connection_->InsertWireGroup(NoAwaitTag{}, request); +} + +future> +WireGroupsClient::InsertWireGroup( + google::cloud::cpp::compute::wire_groups::v1::InsertWireGroupRequest const& + request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->InsertWireGroup(request); +} + +StatusOr +WireGroupsClient::InsertWireGroup( + NoAwaitTag, + google::cloud::cpp::compute::wire_groups::v1::InsertWireGroupRequest const& + request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->InsertWireGroup(NoAwaitTag{}, request); +} + +future> +WireGroupsClient::InsertWireGroup( + google::cloud::cpp::compute::v1::Operation const& operation, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->InsertWireGroup(operation); +} + +StreamRange +WireGroupsClient::ListWireGroups(std::string const& project, + std::string const& cross_site_network, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::wire_groups::v1::ListWireGroupsRequest request; + request.set_project(project); + request.set_cross_site_network(cross_site_network); + return connection_->ListWireGroups(request); +} + +StreamRange +WireGroupsClient::ListWireGroups( + google::cloud::cpp::compute::wire_groups::v1::ListWireGroupsRequest request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->ListWireGroups(std::move(request)); +} + +future> +WireGroupsClient::PatchWireGroup( + std::string const& project, std::string const& cross_site_network, + std::string const& wire_group, std::string const& update_mask, + google::cloud::cpp::compute::v1::WireGroup const& wire_group_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::wire_groups::v1::PatchWireGroupRequest request; + request.set_project(project); + request.set_cross_site_network(cross_site_network); + request.set_wire_group(wire_group); + request.set_update_mask(update_mask); + *request.mutable_wire_group_resource() = wire_group_resource; + return connection_->PatchWireGroup(request); +} + +StatusOr +WireGroupsClient::PatchWireGroup( + NoAwaitTag, std::string const& project, + std::string const& cross_site_network, std::string const& wire_group, + std::string const& update_mask, + google::cloud::cpp::compute::v1::WireGroup const& wire_group_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::wire_groups::v1::PatchWireGroupRequest request; + request.set_project(project); + request.set_cross_site_network(cross_site_network); + request.set_wire_group(wire_group); + request.set_update_mask(update_mask); + *request.mutable_wire_group_resource() = wire_group_resource; + return connection_->PatchWireGroup(NoAwaitTag{}, request); +} + +future> +WireGroupsClient::PatchWireGroup( + google::cloud::cpp::compute::wire_groups::v1::PatchWireGroupRequest const& + request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->PatchWireGroup(request); +} + +StatusOr +WireGroupsClient::PatchWireGroup( + NoAwaitTag, + google::cloud::cpp::compute::wire_groups::v1::PatchWireGroupRequest const& + request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->PatchWireGroup(NoAwaitTag{}, request); +} + +future> +WireGroupsClient::PatchWireGroup( + google::cloud::cpp::compute::v1::Operation const& operation, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->PatchWireGroup(operation); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_wire_groups_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/wire_groups/v1/wire_groups_client.h b/google/cloud/compute/wire_groups/v1/wire_groups_client.h new file mode 100644 index 0000000000000..1e64c9f04c64d --- /dev/null +++ b/google/cloud/compute/wire_groups/v1/wire_groups_client.h @@ -0,0 +1,616 @@ +// Copyright 2026 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. +// source: google/cloud/compute/wire_groups/v1/wire_groups.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_WIRE_GROUPS_V1_WIRE_GROUPS_CLIENT_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_WIRE_GROUPS_V1_WIRE_GROUPS_CLIENT_H + +#include "google/cloud/compute/wire_groups/v1/wire_groups_rest_connection.h" +#include "google/cloud/future.h" +#include "google/cloud/no_await_tag.h" +#include "google/cloud/options.h" +#include "google/cloud/polling_policy.h" +#include "google/cloud/status_or.h" +#include "google/cloud/version.h" +#include +#include +#include + +namespace google { +namespace cloud { +namespace compute_wire_groups_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/// +/// Service for the wireGroups resource. +/// https://cloud.google.com/compute/docs/reference/rest/v1/wireGroups +/// +/// @par Equality +/// +/// Instances of this class created via copy-construction or copy-assignment +/// always compare equal. Instances created with equal +/// `std::shared_ptr<*Connection>` objects compare equal. Objects that compare +/// equal share the same underlying resources. +/// +/// @par Performance +/// +/// Creating a new instance of this class is a relatively expensive operation, +/// new objects establish new connections to the service. In contrast, +/// copy-construction, move-construction, and the corresponding assignment +/// operations are relatively efficient as the copies share all underlying +/// resources. +/// +/// @par Thread Safety +/// +/// Concurrent access to different instances of this class, even if they compare +/// equal, is guaranteed to work. Two or more threads operating on the same +/// instance of this class is not guaranteed to work. Since copy-construction +/// and move-construction is a relatively efficient operation, consider using +/// such a copy when using this class from multiple threads. +/// +class WireGroupsClient { + public: + explicit WireGroupsClient(std::shared_ptr connection, + Options opts = {}); + ~WireGroupsClient(); + + ///@{ + /// @name Copy and move support + WireGroupsClient(WireGroupsClient const&) = default; + WireGroupsClient& operator=(WireGroupsClient const&) = default; + WireGroupsClient(WireGroupsClient&&) = default; + WireGroupsClient& operator=(WireGroupsClient&&) = default; + ///@} + + ///@{ + /// @name Equality + friend bool operator==(WireGroupsClient const& a, WireGroupsClient const& b) { + return a.connection_ == b.connection_; + } + friend bool operator!=(WireGroupsClient const& a, WireGroupsClient const& b) { + return !(a == b); + } + ///@} + + // clang-format off + /// + /// Deletes the specified wire group in the given scope. + /// https://cloud.google.com/compute/docs/reference/rest/v1/wireGroups/delete + /// + /// @param project Project ID for this request. + /// @param cross_site_network + /// @param wire_group Name of the wire group resource to delete. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.wire_groups.v1.DeleteWireGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/wire_groups/v1/wire_groups.proto#L105} + /// + // clang-format on + future> DeleteWireGroup( + std::string const& project, std::string const& cross_site_network, + std::string const& wire_group, Options opts = {}); + + // clang-format off + /// + /// @copybrief DeleteWireGroup + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr DeleteWireGroup( + NoAwaitTag, std::string const& project, + std::string const& cross_site_network, std::string const& wire_group, + Options opts = {}); + + // clang-format off + /// + /// Deletes the specified wire group in the given scope. + /// https://cloud.google.com/compute/docs/reference/rest/v1/wireGroups/delete + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.wire_groups.v1.DeleteWireGroupRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.wire_groups.v1.DeleteWireGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/wire_groups/v1/wire_groups.proto#L105} + /// + // clang-format on + future> DeleteWireGroup( + google::cloud::cpp::compute::wire_groups::v1:: + DeleteWireGroupRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief DeleteWireGroup + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr DeleteWireGroup( + NoAwaitTag, + google::cloud::cpp::compute::wire_groups::v1:: + DeleteWireGroupRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief DeleteWireGroup + /// + /// This method accepts a `google::cloud::cpp::compute::v1::Operation` that corresponds + /// to a previously started Long Running Operation (LRO) and polls the status + /// of the LRO in the background. + /// + // clang-format on + future> DeleteWireGroup( + google::cloud::cpp::compute::v1::Operation const& operation, + Options opts = {}); + + // clang-format off + /// + /// Gets the specified wire group resource in the given scope. + /// https://cloud.google.com/compute/docs/reference/rest/v1/wireGroups/get + /// + /// @param project Project ID for this request. + /// @param cross_site_network + /// @param wire_group Name of the wire group resource to return. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.WireGroup]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.v1.WireGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_179.proto#L60} + /// [google.cloud.cpp.compute.wire_groups.v1.GetWireGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/wire_groups/v1/wire_groups.proto#L138} + /// + // clang-format on + StatusOr GetWireGroup( + std::string const& project, std::string const& cross_site_network, + std::string const& wire_group, Options opts = {}); + + // clang-format off + /// + /// Gets the specified wire group resource in the given scope. + /// https://cloud.google.com/compute/docs/reference/rest/v1/wireGroups/get + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.wire_groups.v1.GetWireGroupRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.WireGroup]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.v1.WireGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_179.proto#L60} + /// [google.cloud.cpp.compute.wire_groups.v1.GetWireGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/wire_groups/v1/wire_groups.proto#L138} + /// + // clang-format on + StatusOr GetWireGroup( + google::cloud::cpp::compute::wire_groups::v1::GetWireGroupRequest const& + request, + Options opts = {}); + + // clang-format off + /// + /// Creates a wire group in the specified project in the given scope + /// using the parameters that are included in the request. + /// https://cloud.google.com/compute/docs/reference/rest/v1/wireGroups/insert + /// + /// @param project Project ID for this request. + /// @param cross_site_network + /// @param wire_group_resource The WireGroup for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.wire_groups.v1.InsertWireGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/wire_groups/v1/wire_groups.proto#L152} + /// + // clang-format on + future> InsertWireGroup( + std::string const& project, std::string const& cross_site_network, + google::cloud::cpp::compute::v1::WireGroup const& wire_group_resource, + Options opts = {}); + + // clang-format off + /// + /// @copybrief InsertWireGroup + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr InsertWireGroup( + NoAwaitTag, std::string const& project, + std::string const& cross_site_network, + google::cloud::cpp::compute::v1::WireGroup const& wire_group_resource, + Options opts = {}); + + // clang-format off + /// + /// Creates a wire group in the specified project in the given scope + /// using the parameters that are included in the request. + /// https://cloud.google.com/compute/docs/reference/rest/v1/wireGroups/insert + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.wire_groups.v1.InsertWireGroupRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.wire_groups.v1.InsertWireGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/wire_groups/v1/wire_groups.proto#L152} + /// + // clang-format on + future> InsertWireGroup( + google::cloud::cpp::compute::wire_groups::v1:: + InsertWireGroupRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief InsertWireGroup + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr InsertWireGroup( + NoAwaitTag, + google::cloud::cpp::compute::wire_groups::v1:: + InsertWireGroupRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief InsertWireGroup + /// + /// This method accepts a `google::cloud::cpp::compute::v1::Operation` that corresponds + /// to a previously started Long Running Operation (LRO) and polls the status + /// of the LRO in the background. + /// + // clang-format on + future> InsertWireGroup( + google::cloud::cpp::compute::v1::Operation const& operation, + Options opts = {}); + + // clang-format off + /// + /// Lists the wire groups for a project in the given scope. + /// https://cloud.google.com/compute/docs/reference/rest/v1/wireGroups/list + /// + /// @param project Project ID for this request. + /// @param cross_site_network + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return a [StreamRange](@ref google::cloud::StreamRange) + /// to iterate of the results. See the documentation of this type for + /// details. In brief, this class has `begin()` and `end()` member + /// functions returning a iterator class meeting the + /// [input iterator requirements]. The value type for this iterator is a + /// [`StatusOr`] as the iteration may fail even after some values are + /// retrieved successfully, for example, if there is a network disconnect. + /// An empty set of results does not indicate an error, it indicates + /// that there are no resources meeting the request criteria. + /// On a successful iteration the `StatusOr` contains elements of type + /// [google.cloud.cpp.compute.v1.WireGroup], or rather, + /// the C++ class generated by Protobuf from that type. Please consult the + /// Protobuf documentation for details on the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.v1.WireGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_179.proto#L60} + /// [google.cloud.cpp.compute.wire_groups.v1.ListWireGroupsRequest]: @cloud_cpp_reference_link{google/cloud/compute/wire_groups/v1/wire_groups.proto#L188} + /// + // clang-format on + StreamRange ListWireGroups( + std::string const& project, std::string const& cross_site_network, + Options opts = {}); + + // clang-format off + /// + /// Lists the wire groups for a project in the given scope. + /// https://cloud.google.com/compute/docs/reference/rest/v1/wireGroups/list + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.wire_groups.v1.ListWireGroupsRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return a [StreamRange](@ref google::cloud::StreamRange) + /// to iterate of the results. See the documentation of this type for + /// details. In brief, this class has `begin()` and `end()` member + /// functions returning a iterator class meeting the + /// [input iterator requirements]. The value type for this iterator is a + /// [`StatusOr`] as the iteration may fail even after some values are + /// retrieved successfully, for example, if there is a network disconnect. + /// An empty set of results does not indicate an error, it indicates + /// that there are no resources meeting the request criteria. + /// On a successful iteration the `StatusOr` contains elements of type + /// [google.cloud.cpp.compute.v1.WireGroup], or rather, + /// the C++ class generated by Protobuf from that type. Please consult the + /// Protobuf documentation for details on the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.v1.WireGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_179.proto#L60} + /// [google.cloud.cpp.compute.wire_groups.v1.ListWireGroupsRequest]: @cloud_cpp_reference_link{google/cloud/compute/wire_groups/v1/wire_groups.proto#L188} + /// + // clang-format on + StreamRange ListWireGroups( + google::cloud::cpp::compute::wire_groups::v1::ListWireGroupsRequest + request, + Options opts = {}); + + // clang-format off + /// + /// Updates the specified wire group resource with the data included in the + /// request. This method supportsPATCH + /// semantics and usesJSON merge + /// patch format and processing rules. + /// https://cloud.google.com/compute/docs/reference/rest/v1/wireGroups/patch + /// + /// @param project Project ID for this request. + /// @param cross_site_network + /// @param wire_group Name of the WireGroups resource to patch. + /// @param update_mask update_mask indicates fields to be updated as part of this request. + /// @param wire_group_resource The WireGroup for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.wire_groups.v1.PatchWireGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/wire_groups/v1/wire_groups.proto#L292} + /// + // clang-format on + future> PatchWireGroup( + std::string const& project, std::string const& cross_site_network, + std::string const& wire_group, std::string const& update_mask, + google::cloud::cpp::compute::v1::WireGroup const& wire_group_resource, + Options opts = {}); + + // clang-format off + /// + /// @copybrief PatchWireGroup + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr PatchWireGroup( + NoAwaitTag, std::string const& project, + std::string const& cross_site_network, std::string const& wire_group, + std::string const& update_mask, + google::cloud::cpp::compute::v1::WireGroup const& wire_group_resource, + Options opts = {}); + + // clang-format off + /// + /// Updates the specified wire group resource with the data included in the + /// request. This method supportsPATCH + /// semantics and usesJSON merge + /// patch format and processing rules. + /// https://cloud.google.com/compute/docs/reference/rest/v1/wireGroups/patch + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.wire_groups.v1.PatchWireGroupRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.wire_groups.v1.PatchWireGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/wire_groups/v1/wire_groups.proto#L292} + /// + // clang-format on + future> PatchWireGroup( + google::cloud::cpp::compute::wire_groups::v1::PatchWireGroupRequest const& + request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief PatchWireGroup + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr PatchWireGroup( + NoAwaitTag, + google::cloud::cpp::compute::wire_groups::v1::PatchWireGroupRequest const& + request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief PatchWireGroup + /// + /// This method accepts a `google::cloud::cpp::compute::v1::Operation` that corresponds + /// to a previously started Long Running Operation (LRO) and polls the status + /// of the LRO in the background. + /// + // clang-format on + future> PatchWireGroup( + google::cloud::cpp::compute::v1::Operation const& operation, + Options opts = {}); + + private: + std::shared_ptr connection_; + Options options_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_wire_groups_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_WIRE_GROUPS_V1_WIRE_GROUPS_CLIENT_H diff --git a/google/cloud/compute/wire_groups/v1/wire_groups_connection.cc b/google/cloud/compute/wire_groups/v1/wire_groups_connection.cc new file mode 100644 index 0000000000000..8fbc9375e7641 --- /dev/null +++ b/google/cloud/compute/wire_groups/v1/wire_groups_connection.cc @@ -0,0 +1,128 @@ +// Copyright 2026 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. +// source: google/cloud/compute/wire_groups/v1/wire_groups.proto + +#include "google/cloud/compute/wire_groups/v1/wire_groups_connection.h" +#include "google/cloud/compute/wire_groups/v1/internal/wire_groups_option_defaults.h" +#include "google/cloud/compute/wire_groups/v1/internal/wire_groups_tracing_connection.h" +#include "google/cloud/compute/wire_groups/v1/wire_groups_options.h" +#include "google/cloud/background_threads.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/grpc_options.h" +#include "google/cloud/internal/pagination_range.h" +#include "google/cloud/internal/unified_grpc_credentials.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_wire_groups_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +WireGroupsConnection::~WireGroupsConnection() = default; + +future> +WireGroupsConnection::DeleteWireGroup(google::cloud::cpp::compute::wire_groups:: + v1::DeleteWireGroupRequest const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +WireGroupsConnection::DeleteWireGroup(NoAwaitTag, + google::cloud::cpp::compute::wire_groups:: + v1::DeleteWireGroupRequest const&) { + return StatusOr( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +WireGroupsConnection::DeleteWireGroup( + google::cloud::cpp::compute::v1::Operation const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +WireGroupsConnection::GetWireGroup( + google::cloud::cpp::compute::wire_groups::v1::GetWireGroupRequest const&) { + return Status(StatusCode::kUnimplemented, "not implemented"); +} + +future> +WireGroupsConnection::InsertWireGroup(google::cloud::cpp::compute::wire_groups:: + v1::InsertWireGroupRequest const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +WireGroupsConnection::InsertWireGroup(NoAwaitTag, + google::cloud::cpp::compute::wire_groups:: + v1::InsertWireGroupRequest const&) { + return StatusOr( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +WireGroupsConnection::InsertWireGroup( + google::cloud::cpp::compute::v1::Operation const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StreamRange +WireGroupsConnection::ListWireGroups( + google::cloud::cpp::compute::wire_groups::v1:: + ListWireGroupsRequest) { // NOLINT(performance-unnecessary-value-param) + return google::cloud::internal::MakeUnimplementedPaginationRange< + StreamRange>(); +} + +future> +WireGroupsConnection::PatchWireGroup(google::cloud::cpp::compute::wire_groups:: + v1::PatchWireGroupRequest const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +WireGroupsConnection::PatchWireGroup(NoAwaitTag, + google::cloud::cpp::compute::wire_groups:: + v1::PatchWireGroupRequest const&) { + return StatusOr( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +WireGroupsConnection::PatchWireGroup( + google::cloud::cpp::compute::v1::Operation const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_wire_groups_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/wire_groups/v1/wire_groups_connection.h b/google/cloud/compute/wire_groups/v1/wire_groups_connection.h new file mode 100644 index 0000000000000..5aa084a5af5f7 --- /dev/null +++ b/google/cloud/compute/wire_groups/v1/wire_groups_connection.h @@ -0,0 +1,237 @@ +// Copyright 2026 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. +// source: google/cloud/compute/wire_groups/v1/wire_groups.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_WIRE_GROUPS_V1_WIRE_GROUPS_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_WIRE_GROUPS_V1_WIRE_GROUPS_CONNECTION_H + +#include "google/cloud/compute/wire_groups/v1/internal/wire_groups_retry_traits.h" +#include "google/cloud/compute/wire_groups/v1/wire_groups.pb.h" +#include "google/cloud/compute/wire_groups/v1/wire_groups_connection_idempotency_policy.h" +#include "google/cloud/backoff_policy.h" +#include "google/cloud/future.h" +#include "google/cloud/internal/retry_policy_impl.h" +#include "google/cloud/no_await_tag.h" +#include "google/cloud/options.h" +#include "google/cloud/polling_policy.h" +#include "google/cloud/status_or.h" +#include "google/cloud/stream_range.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_wire_groups_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/// The retry policy for `WireGroupsConnection`. +class WireGroupsRetryPolicy : public ::google::cloud::RetryPolicy { + public: + /// Creates a new instance of the policy, reset to the initial state. + virtual std::unique_ptr clone() const = 0; +}; + +/** + * A retry policy for `WireGroupsConnection` based on counting errors. + * + * This policy stops retrying if: + * - An RPC returns a non-transient error. + * - More than a prescribed number of transient failures is detected. + * + * In this class the following status codes are treated as transient errors: + * - [`kUnavailable`](@ref google::cloud::StatusCode) + */ +class WireGroupsLimitedErrorCountRetryPolicy : public WireGroupsRetryPolicy { + public: + /** + * Create an instance that tolerates up to @p maximum_failures transient + * errors. + * + * @note Disable the retry loop by providing an instance of this policy with + * @p maximum_failures == 0. + */ + explicit WireGroupsLimitedErrorCountRetryPolicy(int maximum_failures) + : impl_(maximum_failures) {} + + WireGroupsLimitedErrorCountRetryPolicy( + WireGroupsLimitedErrorCountRetryPolicy&& rhs) noexcept + : WireGroupsLimitedErrorCountRetryPolicy(rhs.maximum_failures()) {} + WireGroupsLimitedErrorCountRetryPolicy( + WireGroupsLimitedErrorCountRetryPolicy const& rhs) noexcept + : WireGroupsLimitedErrorCountRetryPolicy(rhs.maximum_failures()) {} + + int maximum_failures() const { return impl_.maximum_failures(); } + + bool OnFailure(Status const& status) override { + return impl_.OnFailure(status); + } + bool IsExhausted() const override { return impl_.IsExhausted(); } + bool IsPermanentFailure(Status const& status) const override { + return impl_.IsPermanentFailure(status); + } + std::unique_ptr clone() const override { + return std::make_unique( + maximum_failures()); + } + + // This is provided only for backwards compatibility. + using BaseType = WireGroupsRetryPolicy; + + private: + google::cloud::internal::LimitedErrorCountRetryPolicy< + compute_wire_groups_v1_internal::WireGroupsRetryTraits> + impl_; +}; + +/** + * A retry policy for `WireGroupsConnection` based on elapsed time. + * + * This policy stops retrying if: + * - An RPC returns a non-transient error. + * - The elapsed time in the retry loop exceeds a prescribed duration. + * + * In this class the following status codes are treated as transient errors: + * - [`kUnavailable`](@ref google::cloud::StatusCode) + */ +class WireGroupsLimitedTimeRetryPolicy : public WireGroupsRetryPolicy { + public: + /** + * Constructor given a `std::chrono::duration<>` object. + * + * @tparam DurationRep a placeholder to match the `Rep` tparam for @p + * duration's type. The semantics of this template parameter are + * documented in `std::chrono::duration<>`. In brief, the underlying + * arithmetic type used to store the number of ticks. For our purposes it + * is simply a formal parameter. + * @tparam DurationPeriod a placeholder to match the `Period` tparam for @p + * duration's type. The semantics of this template parameter are + * documented in `std::chrono::duration<>`. In brief, the length of the + * tick in seconds, expressed as a `std::ratio<>`. For our purposes it is + * simply a formal parameter. + * @param maximum_duration the maximum time allowed before the policy expires. + * While the application can express this time in any units they desire, + * the class truncates to milliseconds. + * + * @see https://en.cppreference.com/w/cpp/chrono/duration for more information + * about `std::chrono::duration`. + */ + template + explicit WireGroupsLimitedTimeRetryPolicy( + std::chrono::duration maximum_duration) + : impl_(maximum_duration) {} + + WireGroupsLimitedTimeRetryPolicy( + WireGroupsLimitedTimeRetryPolicy&& rhs) noexcept + : WireGroupsLimitedTimeRetryPolicy(rhs.maximum_duration()) {} + WireGroupsLimitedTimeRetryPolicy( + WireGroupsLimitedTimeRetryPolicy const& rhs) noexcept + : WireGroupsLimitedTimeRetryPolicy(rhs.maximum_duration()) {} + + std::chrono::milliseconds maximum_duration() const { + return impl_.maximum_duration(); + } + + bool OnFailure(Status const& status) override { + return impl_.OnFailure(status); + } + bool IsExhausted() const override { return impl_.IsExhausted(); } + bool IsPermanentFailure(Status const& status) const override { + return impl_.IsPermanentFailure(status); + } + std::unique_ptr clone() const override { + return std::make_unique( + maximum_duration()); + } + + // This is provided only for backwards compatibility. + using BaseType = WireGroupsRetryPolicy; + + private: + google::cloud::internal::LimitedTimeRetryPolicy< + compute_wire_groups_v1_internal::WireGroupsRetryTraits> + impl_; +}; + +/** + * The `WireGroupsConnection` object for `WireGroupsClient`. + * + * This interface defines virtual methods for each of the user-facing overload + * sets in `WireGroupsClient`. This allows users to inject custom behavior + * (e.g., with a Google Mock object) when writing tests that use objects of type + * `WireGroupsClient`. + * + * To create a concrete instance, see `MakeWireGroupsConnection()`. + * + * For mocking, see `compute_wire_groups_v1_mocks::MockWireGroupsConnection`. + */ +class WireGroupsConnection { + public: + virtual ~WireGroupsConnection() = 0; + + virtual Options options() { return Options{}; } + + virtual future> + DeleteWireGroup(google::cloud::cpp::compute::wire_groups::v1:: + DeleteWireGroupRequest const& request); + + virtual StatusOr DeleteWireGroup( + NoAwaitTag, google::cloud::cpp::compute::wire_groups::v1:: + DeleteWireGroupRequest const& request); + + virtual future> + DeleteWireGroup(google::cloud::cpp::compute::v1::Operation const& operation); + + virtual StatusOr GetWireGroup( + google::cloud::cpp::compute::wire_groups::v1::GetWireGroupRequest const& + request); + + virtual future> + InsertWireGroup(google::cloud::cpp::compute::wire_groups::v1:: + InsertWireGroupRequest const& request); + + virtual StatusOr InsertWireGroup( + NoAwaitTag, google::cloud::cpp::compute::wire_groups::v1:: + InsertWireGroupRequest const& request); + + virtual future> + InsertWireGroup(google::cloud::cpp::compute::v1::Operation const& operation); + + virtual StreamRange + ListWireGroups( + google::cloud::cpp::compute::wire_groups::v1::ListWireGroupsRequest + request); + + virtual future> + PatchWireGroup( + google::cloud::cpp::compute::wire_groups::v1::PatchWireGroupRequest const& + request); + + virtual StatusOr PatchWireGroup( + NoAwaitTag, + google::cloud::cpp::compute::wire_groups::v1::PatchWireGroupRequest const& + request); + + virtual future> + PatchWireGroup(google::cloud::cpp::compute::v1::Operation const& operation); +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_wire_groups_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_WIRE_GROUPS_V1_WIRE_GROUPS_CONNECTION_H diff --git a/google/cloud/compute/wire_groups/v1/wire_groups_connection_idempotency_policy.cc b/google/cloud/compute/wire_groups/v1/wire_groups_connection_idempotency_policy.cc new file mode 100644 index 0000000000000..9b90fad9b0ff4 --- /dev/null +++ b/google/cloud/compute/wire_groups/v1/wire_groups_connection_idempotency_policy.cc @@ -0,0 +1,74 @@ +// Copyright 2026 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. +// source: google/cloud/compute/wire_groups/v1/wire_groups.proto + +#include "google/cloud/compute/wire_groups/v1/wire_groups_connection_idempotency_policy.h" +#include + +namespace google { +namespace cloud { +namespace compute_wire_groups_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +using ::google::cloud::Idempotency; + +WireGroupsConnectionIdempotencyPolicy:: + ~WireGroupsConnectionIdempotencyPolicy() = default; + +std::unique_ptr +WireGroupsConnectionIdempotencyPolicy::clone() const { + return std::make_unique(*this); +} + +Idempotency WireGroupsConnectionIdempotencyPolicy::DeleteWireGroup( + google::cloud::cpp::compute::wire_groups::v1:: + DeleteWireGroupRequest const&) { + return Idempotency::kNonIdempotent; +} + +Idempotency WireGroupsConnectionIdempotencyPolicy::GetWireGroup( + google::cloud::cpp::compute::wire_groups::v1::GetWireGroupRequest const&) { + return Idempotency::kIdempotent; +} + +Idempotency WireGroupsConnectionIdempotencyPolicy::InsertWireGroup( + google::cloud::cpp::compute::wire_groups::v1:: + InsertWireGroupRequest const&) { + return Idempotency::kNonIdempotent; +} + +Idempotency WireGroupsConnectionIdempotencyPolicy::ListWireGroups( + google::cloud::cpp::compute::wire_groups::v1:: + ListWireGroupsRequest) { // NOLINT + return Idempotency::kIdempotent; +} + +Idempotency WireGroupsConnectionIdempotencyPolicy::PatchWireGroup( + google::cloud::cpp::compute::wire_groups::v1:: + PatchWireGroupRequest const&) { + return Idempotency::kNonIdempotent; +} + +std::unique_ptr +MakeDefaultWireGroupsConnectionIdempotencyPolicy() { + return std::make_unique(); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_wire_groups_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/wire_groups/v1/wire_groups_connection_idempotency_policy.h b/google/cloud/compute/wire_groups/v1/wire_groups_connection_idempotency_policy.h new file mode 100644 index 0000000000000..a027f22a66c23 --- /dev/null +++ b/google/cloud/compute/wire_groups/v1/wire_groups_connection_idempotency_policy.h @@ -0,0 +1,68 @@ +// Copyright 2026 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. +// source: google/cloud/compute/wire_groups/v1/wire_groups.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_WIRE_GROUPS_V1_WIRE_GROUPS_CONNECTION_IDEMPOTENCY_POLICY_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_WIRE_GROUPS_V1_WIRE_GROUPS_CONNECTION_IDEMPOTENCY_POLICY_H + +#include "google/cloud/compute/wire_groups/v1/wire_groups.pb.h" +#include "google/cloud/idempotency.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_wire_groups_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class WireGroupsConnectionIdempotencyPolicy { + public: + virtual ~WireGroupsConnectionIdempotencyPolicy(); + + /// Create a new copy of this object. + virtual std::unique_ptr clone() const; + + virtual google::cloud::Idempotency DeleteWireGroup( + google::cloud::cpp::compute::wire_groups::v1:: + DeleteWireGroupRequest const& request); + + virtual google::cloud::Idempotency GetWireGroup( + google::cloud::cpp::compute::wire_groups::v1::GetWireGroupRequest const& + request); + + virtual google::cloud::Idempotency InsertWireGroup( + google::cloud::cpp::compute::wire_groups::v1:: + InsertWireGroupRequest const& request); + + virtual google::cloud::Idempotency ListWireGroups( + google::cloud::cpp::compute::wire_groups::v1::ListWireGroupsRequest + request); + + virtual google::cloud::Idempotency PatchWireGroup( + google::cloud::cpp::compute::wire_groups::v1::PatchWireGroupRequest const& + request); +}; + +std::unique_ptr +MakeDefaultWireGroupsConnectionIdempotencyPolicy(); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_wire_groups_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_WIRE_GROUPS_V1_WIRE_GROUPS_CONNECTION_IDEMPOTENCY_POLICY_H diff --git a/google/cloud/compute/wire_groups/v1/wire_groups_options.h b/google/cloud/compute/wire_groups/v1/wire_groups_options.h new file mode 100644 index 0000000000000..8f0f5ec25ce81 --- /dev/null +++ b/google/cloud/compute/wire_groups/v1/wire_groups_options.h @@ -0,0 +1,86 @@ +// Copyright 2026 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. +// source: google/cloud/compute/wire_groups/v1/wire_groups.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_WIRE_GROUPS_V1_WIRE_GROUPS_OPTIONS_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_WIRE_GROUPS_V1_WIRE_GROUPS_OPTIONS_H + +#include "google/cloud/compute/wire_groups/v1/wire_groups_connection.h" +#include "google/cloud/compute/wire_groups/v1/wire_groups_connection_idempotency_policy.h" +#include "google/cloud/backoff_policy.h" +#include "google/cloud/options.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_wire_groups_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/** + * Use with `google::cloud::Options` to configure the retry policy. + * + * @ingroup google-cloud-compute-options + */ +struct WireGroupsRetryPolicyOption { + using Type = std::shared_ptr; +}; + +/** + * Use with `google::cloud::Options` to configure the backoff policy. + * + * @ingroup google-cloud-compute-options + */ +struct WireGroupsBackoffPolicyOption { + using Type = std::shared_ptr; +}; + +/** + * Use with `google::cloud::Options` to configure which operations are retried. + * + * @ingroup google-cloud-compute-options + */ +struct WireGroupsConnectionIdempotencyPolicyOption { + using Type = std::shared_ptr; +}; + +/** + * Use with `google::cloud::Options` to configure the long-running operations + * polling policy. + * + * @ingroup google-cloud-compute-options + */ +struct WireGroupsPollingPolicyOption { + using Type = std::shared_ptr; +}; + +/** + * The options applicable to WireGroups. + * + * @ingroup google-cloud-compute-options + */ +using WireGroupsPolicyOptionList = + OptionList; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_wire_groups_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_WIRE_GROUPS_V1_WIRE_GROUPS_OPTIONS_H diff --git a/google/cloud/compute/wire_groups/v1/wire_groups_proto_export.h b/google/cloud/compute/wire_groups/v1/wire_groups_proto_export.h new file mode 100644 index 0000000000000..81647bec9fe9e --- /dev/null +++ b/google/cloud/compute/wire_groups/v1/wire_groups_proto_export.h @@ -0,0 +1,33 @@ +// Copyright 2026 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_WIRE_GROUPS_V1_WIRE_GROUPS_PROTO_EXPORT_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_WIRE_GROUPS_V1_WIRE_GROUPS_PROTO_EXPORT_H + +// IWYU pragma: begin_exports +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_179.pb.h" +// IWYU pragma: end_exports + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_WIRE_GROUPS_V1_WIRE_GROUPS_PROTO_EXPORT_H diff --git a/google/cloud/compute/wire_groups/v1/wire_groups_rest_connection.cc b/google/cloud/compute/wire_groups/v1/wire_groups_rest_connection.cc new file mode 100644 index 0000000000000..bd4426aaeafb8 --- /dev/null +++ b/google/cloud/compute/wire_groups/v1/wire_groups_rest_connection.cc @@ -0,0 +1,58 @@ +// Copyright 2026 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. +// source: google/cloud/compute/wire_groups/v1/wire_groups.proto + +#include "google/cloud/compute/wire_groups/v1/wire_groups_rest_connection.h" +#include "google/cloud/compute/wire_groups/v1/internal/wire_groups_option_defaults.h" +#include "google/cloud/compute/wire_groups/v1/internal/wire_groups_rest_connection_impl.h" +#include "google/cloud/compute/wire_groups/v1/internal/wire_groups_rest_stub_factory.h" +#include "google/cloud/compute/wire_groups/v1/internal/wire_groups_tracing_connection.h" +#include "google/cloud/compute/wire_groups/v1/wire_groups_options.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/internal/rest_background_threads_impl.h" +#include "google/cloud/internal/rest_options.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_wire_groups_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +std::shared_ptr MakeWireGroupsConnectionRest( + Options options) { + internal::CheckExpectedOptions< + CommonOptionList, RestOptionList, UnifiedCredentialsOptionList, + rest_internal::TargetApiVersionOption, WireGroupsPolicyOptionList>( + options, __func__); + options = compute_wire_groups_v1_internal::WireGroupsDefaultOptions( + std::move(options)); + auto background = std::make_unique< + rest_internal::AutomaticallyCreatedRestBackgroundThreads>(); + auto stub = + compute_wire_groups_v1_internal::CreateDefaultWireGroupsRestStub(options); + return compute_wire_groups_v1_internal::MakeWireGroupsTracingConnection( + std::make_shared< + compute_wire_groups_v1_internal::WireGroupsRestConnectionImpl>( + std::move(background), std::move(stub), std::move(options))); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_wire_groups_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/wire_groups/v1/wire_groups_rest_connection.h b/google/cloud/compute/wire_groups/v1/wire_groups_rest_connection.h new file mode 100644 index 0000000000000..65165ef6102a0 --- /dev/null +++ b/google/cloud/compute/wire_groups/v1/wire_groups_rest_connection.h @@ -0,0 +1,64 @@ +// Copyright 2026 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. +// source: google/cloud/compute/wire_groups/v1/wire_groups.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_WIRE_GROUPS_V1_WIRE_GROUPS_REST_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_WIRE_GROUPS_V1_WIRE_GROUPS_REST_CONNECTION_H + +#include "google/cloud/compute/wire_groups/v1/wire_groups_connection.h" +#include "google/cloud/options.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_wire_groups_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/** + * A factory function to construct an object of type `WireGroupsConnection` + * that uses REST over HTTP as transport in lieu of gRPC. REST transport should + * only be used for services that do not support gRPC or if the existing network + * configuration precludes using gRPC. + * + * The returned connection object should not be used directly; instead it + * should be passed as an argument to the constructor of WireGroupsClient. + * + * The optional @p options argument may be used to configure aspects of the + * returned `WireGroupsConnection`. Expected options are any of the types in + * the following option lists: + * + * - `google::cloud::CommonOptionList` + * - `google::cloud::RestOptionList` + * - `google::cloud::UnifiedCredentialsOptionList` + * - `google::cloud::compute_wire_groups_v1::WireGroupsPolicyOptionList` + * + * @note Unexpected options will be ignored. To log unexpected options instead, + * set `GOOGLE_CLOUD_CPP_ENABLE_CLOG=yes` in the environment. + * + * @param options (optional) Configure the `WireGroupsConnection` created by + * this function. + */ +std::shared_ptr MakeWireGroupsConnectionRest( + Options options = {}); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_wire_groups_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_WIRE_GROUPS_V1_WIRE_GROUPS_REST_CONNECTION_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 dffa75af5408c..d5282deead66c 100644 --- a/google/cloud/compute/zone_operations/v1/zone_operations_client.h +++ b/google/cloud/compute/zone_operations/v1/zone_operations_client.h @@ -106,7 +106,7 @@ class ZoneOperationsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.zone_operations.v1.DeleteOperationRequest]: @cloud_cpp_reference_link{google/cloud/compute/zone_operations/v1/zone_operations.proto#L92} + /// [google.cloud.cpp.compute.zone_operations.v1.DeleteOperationRequest]: @cloud_cpp_reference_link{google/cloud/compute/zone_operations/v1/zone_operations.proto#L99} /// // clang-format on Status DeleteOperation(std::string const& project, std::string const& zone, @@ -134,7 +134,7 @@ class ZoneOperationsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.zone_operations.v1.DeleteOperationRequest]: @cloud_cpp_reference_link{google/cloud/compute/zone_operations/v1/zone_operations.proto#L92} + /// [google.cloud.cpp.compute.zone_operations.v1.DeleteOperationRequest]: @cloud_cpp_reference_link{google/cloud/compute/zone_operations/v1/zone_operations.proto#L99} /// // clang-format on Status DeleteOperation(google::cloud::cpp::compute::zone_operations::v1:: @@ -163,8 +163,8 @@ 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_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} + /// [google.cloud.cpp.compute.v1.Operation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_019.proto#L188} + /// [google.cloud.cpp.compute.zone_operations.v1.GetOperationRequest]: @cloud_cpp_reference_link{google/cloud/compute/zone_operations/v1/zone_operations.proto#L114} /// // clang-format on StatusOr GetOperation( @@ -195,8 +195,8 @@ 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_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} + /// [google.cloud.cpp.compute.v1.Operation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_019.proto#L188} + /// [google.cloud.cpp.compute.zone_operations.v1.GetOperationRequest]: @cloud_cpp_reference_link{google/cloud/compute/zone_operations/v1/zone_operations.proto#L114} /// // clang-format on StatusOr GetOperation( @@ -206,8 +206,8 @@ class ZoneOperationsClient { // clang-format off /// - /// Retrieves a list of Operation resources contained within the specified - /// zone. + /// Retrieves a list of Operation resources contained within + /// the specified zone. /// https://cloud.google.com/compute/docs/reference/rest/v1/zoneOperations/list /// /// @param project Project ID for this request. @@ -234,8 +234,8 @@ 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_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} + /// [google.cloud.cpp.compute.v1.Operation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_019.proto#L188} + /// [google.cloud.cpp.compute.zone_operations.v1.ListZoneOperationsRequest]: @cloud_cpp_reference_link{google/cloud/compute/zone_operations/v1/zone_operations.proto#L136} /// // clang-format on StreamRange ListZoneOperations( @@ -243,8 +243,8 @@ class ZoneOperationsClient { // clang-format off /// - /// Retrieves a list of Operation resources contained within the specified - /// zone. + /// Retrieves a list of Operation resources contained within + /// the specified zone. /// https://cloud.google.com/compute/docs/reference/rest/v1/zoneOperations/list /// /// @param request Unary RPCs, such as the one wrapped by this @@ -275,8 +275,8 @@ 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_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} + /// [google.cloud.cpp.compute.v1.Operation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_019.proto#L188} + /// [google.cloud.cpp.compute.zone_operations.v1.ListZoneOperationsRequest]: @cloud_cpp_reference_link{google/cloud/compute/zone_operations/v1/zone_operations.proto#L136} /// // clang-format on StreamRange ListZoneOperations( @@ -286,16 +286,23 @@ class ZoneOperationsClient { // clang-format off /// - /// 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`. + /// 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`. /// https://cloud.google.com/compute/docs/reference/rest/v1/zoneOperations/wait /// /// @param project Project ID for this request. @@ -315,8 +322,8 @@ 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_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} + /// [google.cloud.cpp.compute.v1.Operation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_019.proto#L188} + /// [google.cloud.cpp.compute.zone_operations.v1.WaitRequest]: @cloud_cpp_reference_link{google/cloud/compute/zone_operations/v1/zone_operations.proto#L240} /// // clang-format on StatusOr Wait( @@ -325,16 +332,23 @@ class ZoneOperationsClient { // clang-format off /// - /// 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`. + /// 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`. /// https://cloud.google.com/compute/docs/reference/rest/v1/zoneOperations/wait /// /// @param request Unary RPCs, such as the one wrapped by this @@ -356,8 +370,8 @@ 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_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} + /// [google.cloud.cpp.compute.v1.Operation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_019.proto#L188} + /// [google.cloud.cpp.compute.zone_operations.v1.WaitRequest]: @cloud_cpp_reference_link{google/cloud/compute/zone_operations/v1/zone_operations.proto#L240} /// // clang-format on StatusOr Wait( 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 f5d9d5a810e1e..accd2d3a92694 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 "google/cloud/compute/v1/internal/common_016.pb.h" -#include "google/cloud/compute/v1/internal/common_092.pb.h" +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_107.pb.h" // 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/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_option_defaults.cc b/google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_option_defaults.cc new file mode 100644 index 0000000000000..1e941961bcb50 --- /dev/null +++ b/google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_option_defaults.cc @@ -0,0 +1,95 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies.proto + +#include "google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_option_defaults.h" +#include "google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies_connection.h" +#include "google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies_options.h" +#include "google/cloud/internal/populate_common_options.h" +#include "google/cloud/internal/populate_grpc_options.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_zone_vm_extension_policies_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +namespace { +auto constexpr kBackoffScaling = 2.0; +} // namespace + +Options ZoneVmExtensionPoliciesDefaultOptions(Options options) { + options = internal::PopulateCommonOptions( + std::move(options), + "GOOGLE_CLOUD_CPP_ZONE_VM_EXTENSION_POLICIES_ENDPOINT", "", + "GOOGLE_CLOUD_CPP_ZONE_VM_EXTENSION_POLICIES_AUTHORITY", + "compute.googleapis.com"); + options = internal::PopulateGrpcOptions(std::move(options)); + if (!options.has()) { + options.set( + compute_zone_vm_extension_policies_v1:: + ZoneVmExtensionPoliciesLimitedTimeRetryPolicy( + std::chrono::minutes(10)) + .clone()); + } + if (!options.has()) { + options.set( + ExponentialBackoffPolicy( + std::chrono::seconds(0), std::chrono::seconds(1), + std::chrono::minutes(5), kBackoffScaling, kBackoffScaling) + .clone()); + } + if (!options.has()) { + options.set( + GenericPollingPolicy< + compute_zone_vm_extension_policies_v1:: + ZoneVmExtensionPoliciesRetryPolicyOption::Type, + compute_zone_vm_extension_policies_v1:: + ZoneVmExtensionPoliciesBackoffPolicyOption::Type>( + options + .get() + ->clone(), + ExponentialBackoffPolicy(std::chrono::seconds(1), + std::chrono::minutes(5), kBackoffScaling) + .clone()) + .clone()); + } + if (!options.has< + compute_zone_vm_extension_policies_v1:: + ZoneVmExtensionPoliciesConnectionIdempotencyPolicyOption>()) { + options.set( + compute_zone_vm_extension_policies_v1:: + MakeDefaultZoneVmExtensionPoliciesConnectionIdempotencyPolicy()); + } + + return options; +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_zone_vm_extension_policies_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_option_defaults.h b/google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_option_defaults.h new file mode 100644 index 0000000000000..bef15bee25ed8 --- /dev/null +++ b/google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_option_defaults.h @@ -0,0 +1,38 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ZONE_VM_EXTENSION_POLICIES_V1_INTERNAL_ZONE_VM_EXTENSION_POLICIES_OPTION_DEFAULTS_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ZONE_VM_EXTENSION_POLICIES_V1_INTERNAL_ZONE_VM_EXTENSION_POLICIES_OPTION_DEFAULTS_H + +#include "google/cloud/options.h" +#include "google/cloud/version.h" + +namespace google { +namespace cloud { +namespace compute_zone_vm_extension_policies_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +Options ZoneVmExtensionPoliciesDefaultOptions(Options options); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_zone_vm_extension_policies_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ZONE_VM_EXTENSION_POLICIES_V1_INTERNAL_ZONE_VM_EXTENSION_POLICIES_OPTION_DEFAULTS_H diff --git a/google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_rest_connection_impl.cc b/google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_rest_connection_impl.cc new file mode 100644 index 0000000000000..07ce4e87312f8 --- /dev/null +++ b/google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_rest_connection_impl.cc @@ -0,0 +1,502 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies.proto + +#include "google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_rest_connection_impl.h" +#include "google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_rest_stub_factory.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/internal/async_rest_long_running_operation_custom.h" +#include "google/cloud/internal/extract_long_running_result.h" +#include "google/cloud/internal/pagination_range.h" +#include "google/cloud/internal/rest_lro_helpers.h" +#include "google/cloud/internal/rest_retry_loop.h" +#include "google/cloud/rest_options.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_zone_vm_extension_policies_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +ZoneVmExtensionPoliciesRestConnectionImpl:: + ZoneVmExtensionPoliciesRestConnectionImpl( + std::unique_ptr background, + std::shared_ptr + stub, + Options options) + : background_(std::move(background)), + stub_(std::move(stub)), + options_(internal::MergeOptions( + std::move(options), ZoneVmExtensionPoliciesConnection::options())) {} + +future> +ZoneVmExtensionPoliciesRestConnectionImpl::DeleteVmExtensionPolicy( + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + DeleteVmExtensionPolicyRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::zone_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::zone_operations::v1::DeleteOperationRequest>( + background_->cq(), current, request, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_vm_extension_policies:: + v1::DeleteVmExtensionPolicyRequest const& request) { + return stub->AsyncDeleteVmExtensionPolicy(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->DeleteVmExtensionPolicy(request), + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [request]( + std::string const& op, + google::cloud::cpp::compute::zone_operations::v1::GetOperationRequest& + r) { + r.set_project(request.project()); + r.set_zone(request.zone()); + r.set_operation(op); + }, + [request](std::string const& op, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest& r) { + r.set_project(request.project()); + r.set_zone(request.zone()); + r.set_operation(op); + }); +} + +StatusOr +ZoneVmExtensionPoliciesRestConnectionImpl::DeleteVmExtensionPolicy( + NoAwaitTag, google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + DeleteVmExtensionPolicyRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->DeleteVmExtensionPolicy(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + DeleteVmExtensionPolicyRequest const& request) { + return stub_->DeleteVmExtensionPolicy(rest_context, options, request); + }, + *current, request, __func__); +} + +future> +ZoneVmExtensionPoliciesRestConnectionImpl::DeleteVmExtensionPolicy( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestAwaitLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::zone_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::zone_operations::v1::DeleteOperationRequest>( + background_->cq(), current, operation, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [operation]( + std::string const&, + google::cloud::cpp::compute::zone_operations::v1::GetOperationRequest& + r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_zone(info.zone); + r.set_operation(info.operation); + }, + [operation](std::string const&, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_zone(info.zone); + r.set_operation(info.operation); + }); +} + +StatusOr +ZoneVmExtensionPoliciesRestConnectionImpl::GetVmExtensionPolicy( + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + GetVmExtensionPolicyRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->GetVmExtensionPolicy(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + GetVmExtensionPolicyRequest const& request) { + return stub_->GetVmExtensionPolicy(rest_context, options, request); + }, + *current, request, __func__); +} + +future> +ZoneVmExtensionPoliciesRestConnectionImpl::InsertVmExtensionPolicy( + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + InsertVmExtensionPolicyRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::zone_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::zone_operations::v1::DeleteOperationRequest>( + background_->cq(), current, request, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_vm_extension_policies:: + v1::InsertVmExtensionPolicyRequest const& request) { + return stub->AsyncInsertVmExtensionPolicy(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->InsertVmExtensionPolicy(request), + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [request]( + std::string const& op, + google::cloud::cpp::compute::zone_operations::v1::GetOperationRequest& + r) { + r.set_project(request.project()); + r.set_zone(request.zone()); + r.set_operation(op); + }, + [request](std::string const& op, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest& r) { + r.set_project(request.project()); + r.set_zone(request.zone()); + r.set_operation(op); + }); +} + +StatusOr +ZoneVmExtensionPoliciesRestConnectionImpl::InsertVmExtensionPolicy( + NoAwaitTag, google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + InsertVmExtensionPolicyRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->InsertVmExtensionPolicy(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + InsertVmExtensionPolicyRequest const& request) { + return stub_->InsertVmExtensionPolicy(rest_context, options, request); + }, + *current, request, __func__); +} + +future> +ZoneVmExtensionPoliciesRestConnectionImpl::InsertVmExtensionPolicy( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestAwaitLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::zone_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::zone_operations::v1::DeleteOperationRequest>( + background_->cq(), current, operation, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [operation]( + std::string const&, + google::cloud::cpp::compute::zone_operations::v1::GetOperationRequest& + r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_zone(info.zone); + r.set_operation(info.operation); + }, + [operation](std::string const&, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_zone(info.zone); + r.set_operation(info.operation); + }); +} + +StreamRange +ZoneVmExtensionPoliciesRestConnectionImpl::ListZoneVmExtensionPolicies( + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + ListZoneVmExtensionPoliciesRequest request) { + request.clear_page_token(); + auto current = google::cloud::internal::SaveCurrentOptions(); + auto idempotency = + idempotency_policy(*current)->ListZoneVmExtensionPolicies(request); + char const* function_name = __func__; + return google::cloud::internal::MakePaginationRange< + StreamRange>( + current, std::move(request), + [idempotency, function_name, stub = stub_, + retry = std::shared_ptr( + retry_policy(*current)), + backoff = std::shared_ptr(backoff_policy(*current))]( + Options const& options, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + ListZoneVmExtensionPoliciesRequest const& r) { + return google::cloud::rest_internal::RestRetryLoop( + retry->clone(), backoff->clone(), idempotency, + [stub](rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + ListZoneVmExtensionPoliciesRequest const& request) { + return stub->ListZoneVmExtensionPolicies(rest_context, options, + request); + }, + options, r, function_name); + }, + [](google::cloud::cpp::compute::v1::VmExtensionPolicyList r) { + std::vector result( + r.items().size()); + auto& messages = *r.mutable_items(); + std::move(messages.begin(), messages.end(), result.begin()); + return result; + }); +} + +future> +ZoneVmExtensionPoliciesRestConnectionImpl::UpdateVmExtensionPolicy( + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + UpdateVmExtensionPolicyRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::zone_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::zone_operations::v1::DeleteOperationRequest>( + background_->cq(), current, request, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_vm_extension_policies:: + v1::UpdateVmExtensionPolicyRequest const& request) { + return stub->AsyncUpdateVmExtensionPolicy(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->UpdateVmExtensionPolicy(request), + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [request]( + std::string const& op, + google::cloud::cpp::compute::zone_operations::v1::GetOperationRequest& + r) { + r.set_project(request.project()); + r.set_zone(request.zone()); + r.set_operation(op); + }, + [request](std::string const& op, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest& r) { + r.set_project(request.project()); + r.set_zone(request.zone()); + r.set_operation(op); + }); +} + +StatusOr +ZoneVmExtensionPoliciesRestConnectionImpl::UpdateVmExtensionPolicy( + NoAwaitTag, google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + UpdateVmExtensionPolicyRequest const& request) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return google::cloud::rest_internal::RestRetryLoop( + retry_policy(*current), backoff_policy(*current), + idempotency_policy(*current)->UpdateVmExtensionPolicy(request), + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + UpdateVmExtensionPolicyRequest const& request) { + return stub_->UpdateVmExtensionPolicy(rest_context, options, request); + }, + *current, request, __func__); +} + +future> +ZoneVmExtensionPoliciesRestConnectionImpl::UpdateVmExtensionPolicy( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto current = google::cloud::internal::SaveCurrentOptions(); + return rest_internal::AsyncRestAwaitLongRunningOperation< + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::v1::Operation, + google::cloud::cpp::compute::zone_operations::v1::GetOperationRequest, + google::cloud::cpp::compute::zone_operations::v1::DeleteOperationRequest>( + background_->cq(), current, operation, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + GetOperationRequest const& request) { + return stub->AsyncGetOperation(cq, std::move(context), + std::move(options), request); + }, + [stub = stub_](CompletionQueue& cq, + std::unique_ptr context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest const& request) { + return stub->AsyncCancelOperation(cq, std::move(context), + std::move(options), request); + }, + [](StatusOr op, + std::string const&) { return op; }, + polling_policy(*current), __func__, + [](google::cloud::cpp::compute::v1::Operation const& op) { + return op.status() == "DONE"; + }, + [operation]( + std::string const&, + google::cloud::cpp::compute::zone_operations::v1::GetOperationRequest& + r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_zone(info.zone); + r.set_operation(info.operation); + }, + [operation](std::string const&, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest& r) { + auto info = google::cloud::rest_internal::ParseComputeOperationInfo( + operation.self_link()); + + r.set_project(info.project); + r.set_zone(info.zone); + r.set_operation(info.operation); + }); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_zone_vm_extension_policies_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_rest_connection_impl.h b/google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_rest_connection_impl.h new file mode 100644 index 0000000000000..2bf697023fe7b --- /dev/null +++ b/google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_rest_connection_impl.h @@ -0,0 +1,151 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ZONE_VM_EXTENSION_POLICIES_V1_INTERNAL_ZONE_VM_EXTENSION_POLICIES_REST_CONNECTION_IMPL_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ZONE_VM_EXTENSION_POLICIES_V1_INTERNAL_ZONE_VM_EXTENSION_POLICIES_REST_CONNECTION_IMPL_H + +#include "google/cloud/compute/zone_operations/v1/zone_operations.pb.h" +#include "google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_rest_stub.h" +#include "google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_retry_traits.h" +#include "google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies_connection.h" +#include "google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies_connection_idempotency_policy.h" +#include "google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies_options.h" +#include "google/cloud/background_threads.h" +#include "google/cloud/backoff_policy.h" +#include "google/cloud/options.h" +#include "google/cloud/status_or.h" +#include "google/cloud/stream_range.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_zone_vm_extension_policies_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class ZoneVmExtensionPoliciesRestConnectionImpl + : public compute_zone_vm_extension_policies_v1:: + ZoneVmExtensionPoliciesConnection { + public: + ~ZoneVmExtensionPoliciesRestConnectionImpl() override = default; + + ZoneVmExtensionPoliciesRestConnectionImpl( + std::unique_ptr background, + std::shared_ptr + stub, + Options options); + + Options options() override { return options_; } + + future> + DeleteVmExtensionPolicy( + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + DeleteVmExtensionPolicyRequest const& request) override; + + StatusOr DeleteVmExtensionPolicy( + NoAwaitTag, google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + DeleteVmExtensionPolicyRequest const& request) override; + + future> + DeleteVmExtensionPolicy( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + StatusOr + GetVmExtensionPolicy( + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + GetVmExtensionPolicyRequest const& request) override; + + future> + InsertVmExtensionPolicy( + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + InsertVmExtensionPolicyRequest const& request) override; + + StatusOr InsertVmExtensionPolicy( + NoAwaitTag, google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + InsertVmExtensionPolicyRequest const& request) override; + + future> + InsertVmExtensionPolicy( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + StreamRange + ListZoneVmExtensionPolicies( + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + ListZoneVmExtensionPoliciesRequest request) override; + + future> + UpdateVmExtensionPolicy( + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + UpdateVmExtensionPolicyRequest const& request) override; + + StatusOr UpdateVmExtensionPolicy( + NoAwaitTag, google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + UpdateVmExtensionPolicyRequest const& request) override; + + future> + UpdateVmExtensionPolicy( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + private: + static std::unique_ptr< + compute_zone_vm_extension_policies_v1::ZoneVmExtensionPoliciesRetryPolicy> + retry_policy(Options const& options) { + return options + .get() + ->clone(); + } + + static std::unique_ptr backoff_policy(Options const& options) { + return options + .get() + ->clone(); + } + + static std::unique_ptr + idempotency_policy(Options const& options) { + return options + .get() + ->clone(); + } + + static std::unique_ptr polling_policy(Options const& options) { + return options + .get() + ->clone(); + } + + std::unique_ptr background_; + std::shared_ptr + stub_; + Options options_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_zone_vm_extension_policies_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ZONE_VM_EXTENSION_POLICIES_V1_INTERNAL_ZONE_VM_EXTENSION_POLICIES_REST_CONNECTION_IMPL_H diff --git a/google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_rest_logging_decorator.cc b/google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_rest_logging_decorator.cc new file mode 100644 index 0000000000000..af1a58dce2cfc --- /dev/null +++ b/google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_rest_logging_decorator.cc @@ -0,0 +1,211 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies.proto + +#include "google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_rest_logging_decorator.h" +#include "google/cloud/internal/log_wrapper.h" +#include "google/cloud/status_or.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_zone_vm_extension_policies_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +ZoneVmExtensionPoliciesRestLogging::ZoneVmExtensionPoliciesRestLogging( + std::shared_ptr child, + TracingOptions tracing_options, std::set components) + : child_(std::move(child)), + tracing_options_(std::move(tracing_options)), + components_(std::move(components)) {} + +future> +ZoneVmExtensionPoliciesRestLogging::AsyncDeleteVmExtensionPolicy( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + DeleteVmExtensionPolicyRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + DeleteVmExtensionPolicyRequest const& request) { + return child_->AsyncDeleteVmExtensionPolicy( + cq, std::move(rest_context), std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +StatusOr +ZoneVmExtensionPoliciesRestLogging::DeleteVmExtensionPolicy( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + DeleteVmExtensionPolicyRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + DeleteVmExtensionPolicyRequest const& request) { + return child_->DeleteVmExtensionPolicy(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +StatusOr +ZoneVmExtensionPoliciesRestLogging::GetVmExtensionPolicy( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + GetVmExtensionPolicyRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + GetVmExtensionPolicyRequest const& request) { + return child_->GetVmExtensionPolicy(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +future> +ZoneVmExtensionPoliciesRestLogging::AsyncInsertVmExtensionPolicy( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + InsertVmExtensionPolicyRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + InsertVmExtensionPolicyRequest const& request) { + return child_->AsyncInsertVmExtensionPolicy( + cq, std::move(rest_context), std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +StatusOr +ZoneVmExtensionPoliciesRestLogging::InsertVmExtensionPolicy( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + InsertVmExtensionPolicyRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + InsertVmExtensionPolicyRequest const& request) { + return child_->InsertVmExtensionPolicy(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +StatusOr +ZoneVmExtensionPoliciesRestLogging::ListZoneVmExtensionPolicies( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + ListZoneVmExtensionPoliciesRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + ListZoneVmExtensionPoliciesRequest const& request) { + return child_->ListZoneVmExtensionPolicies(rest_context, options, + request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +future> +ZoneVmExtensionPoliciesRestLogging::AsyncUpdateVmExtensionPolicy( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + UpdateVmExtensionPolicyRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + UpdateVmExtensionPolicyRequest const& request) { + return child_->AsyncUpdateVmExtensionPolicy( + cq, std::move(rest_context), std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +StatusOr +ZoneVmExtensionPoliciesRestLogging::UpdateVmExtensionPolicy( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + UpdateVmExtensionPolicyRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + UpdateVmExtensionPolicyRequest const& request) { + return child_->UpdateVmExtensionPolicy(rest_context, options, request); + }, + rest_context, options, request, __func__, tracing_options_); +} + +future> +ZoneVmExtensionPoliciesRestLogging::AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1::GetOperationRequest const& + request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + GetOperationRequest const& request) { + return child_->AsyncGetOperation(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +future ZoneVmExtensionPoliciesRestLogging::AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest const& request) { + return google::cloud::internal::LogWrapper( + [this](CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest const& request) { + return child_->AsyncCancelOperation(cq, std::move(rest_context), + std::move(options), request); + }, + cq, std::move(rest_context), std::move(options), request, __func__, + tracing_options_); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_zone_vm_extension_policies_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_rest_logging_decorator.h b/google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_rest_logging_decorator.h new file mode 100644 index 0000000000000..611c663b00bc1 --- /dev/null +++ b/google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_rest_logging_decorator.h @@ -0,0 +1,129 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ZONE_VM_EXTENSION_POLICIES_V1_INTERNAL_ZONE_VM_EXTENSION_POLICIES_REST_LOGGING_DECORATOR_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ZONE_VM_EXTENSION_POLICIES_V1_INTERNAL_ZONE_VM_EXTENSION_POLICIES_REST_LOGGING_DECORATOR_H + +#include "google/cloud/compute/zone_operations/v1/zone_operations.pb.h" +#include "google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_rest_stub.h" +#include "google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies.pb.h" +#include "google/cloud/future.h" +#include "google/cloud/internal/rest_context.h" +#include "google/cloud/tracing_options.h" +#include "google/cloud/version.h" +#include +#include +#include + +namespace google { +namespace cloud { +namespace compute_zone_vm_extension_policies_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class ZoneVmExtensionPoliciesRestLogging + : public ZoneVmExtensionPoliciesRestStub { + public: + ~ZoneVmExtensionPoliciesRestLogging() override = default; + ZoneVmExtensionPoliciesRestLogging( + std::shared_ptr child, + TracingOptions tracing_options, std::set components); + + future> + AsyncDeleteVmExtensionPolicy( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + DeleteVmExtensionPolicyRequest const& request) override; + + StatusOr DeleteVmExtensionPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + DeleteVmExtensionPolicyRequest const& request) override; + + StatusOr + GetVmExtensionPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + GetVmExtensionPolicyRequest const& request) override; + + future> + AsyncInsertVmExtensionPolicy( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + InsertVmExtensionPolicyRequest const& request) override; + + StatusOr InsertVmExtensionPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + InsertVmExtensionPolicyRequest const& request) override; + + StatusOr + ListZoneVmExtensionPolicies( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + ListZoneVmExtensionPoliciesRequest const& request) override; + + future> + AsyncUpdateVmExtensionPolicy( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + UpdateVmExtensionPolicyRequest const& request) override; + + StatusOr UpdateVmExtensionPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + UpdateVmExtensionPolicyRequest const& request) override; + + future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + GetOperationRequest const& request) override; + + future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest const& request) override; + + private: + std::shared_ptr child_; + TracingOptions tracing_options_; + std::set components_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_zone_vm_extension_policies_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ZONE_VM_EXTENSION_POLICIES_V1_INTERNAL_ZONE_VM_EXTENSION_POLICIES_REST_LOGGING_DECORATOR_H diff --git a/google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_rest_metadata_decorator.cc b/google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_rest_metadata_decorator.cc new file mode 100644 index 0000000000000..9557c6b5027ba --- /dev/null +++ b/google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_rest_metadata_decorator.cc @@ -0,0 +1,157 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies.proto + +#include "google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_rest_metadata_decorator.h" +#include "google/cloud/internal/api_client_header.h" +#include "google/cloud/internal/rest_set_metadata.h" +#include "google/cloud/status_or.h" +#include "absl/strings/str_cat.h" +#include "absl/strings/str_format.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_zone_vm_extension_policies_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +ZoneVmExtensionPoliciesRestMetadata::ZoneVmExtensionPoliciesRestMetadata( + std::shared_ptr child, + std::string api_client_header) + : child_(std::move(child)), + api_client_header_( + api_client_header.empty() + ? google::cloud::internal::GeneratedLibClientHeader() + : std::move(api_client_header)) {} + +future> +ZoneVmExtensionPoliciesRestMetadata::AsyncDeleteVmExtensionPolicy( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + DeleteVmExtensionPolicyRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncDeleteVmExtensionPolicy(cq, std::move(rest_context), + std::move(options), request); +} + +StatusOr +ZoneVmExtensionPoliciesRestMetadata::DeleteVmExtensionPolicy( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + DeleteVmExtensionPolicyRequest const& request) { + SetMetadata(rest_context, options); + return child_->DeleteVmExtensionPolicy(rest_context, options, request); +} + +StatusOr +ZoneVmExtensionPoliciesRestMetadata::GetVmExtensionPolicy( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + GetVmExtensionPolicyRequest const& request) { + SetMetadata(rest_context, options); + return child_->GetVmExtensionPolicy(rest_context, options, request); +} + +future> +ZoneVmExtensionPoliciesRestMetadata::AsyncInsertVmExtensionPolicy( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + InsertVmExtensionPolicyRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncInsertVmExtensionPolicy(cq, std::move(rest_context), + std::move(options), request); +} + +StatusOr +ZoneVmExtensionPoliciesRestMetadata::InsertVmExtensionPolicy( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + InsertVmExtensionPolicyRequest const& request) { + SetMetadata(rest_context, options); + return child_->InsertVmExtensionPolicy(rest_context, options, request); +} + +StatusOr +ZoneVmExtensionPoliciesRestMetadata::ListZoneVmExtensionPolicies( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + ListZoneVmExtensionPoliciesRequest const& request) { + SetMetadata(rest_context, options); + return child_->ListZoneVmExtensionPolicies(rest_context, options, request); +} + +future> +ZoneVmExtensionPoliciesRestMetadata::AsyncUpdateVmExtensionPolicy( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + UpdateVmExtensionPolicyRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncUpdateVmExtensionPolicy(cq, std::move(rest_context), + std::move(options), request); +} + +StatusOr +ZoneVmExtensionPoliciesRestMetadata::UpdateVmExtensionPolicy( + rest_internal::RestContext& rest_context, Options const& options, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + UpdateVmExtensionPolicyRequest const& request) { + SetMetadata(rest_context, options); + return child_->UpdateVmExtensionPolicy(rest_context, options, request); +} + +future> +ZoneVmExtensionPoliciesRestMetadata::AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1::GetOperationRequest const& + request) { + SetMetadata(*rest_context, *options); + return child_->AsyncGetOperation(cq, std::move(rest_context), + std::move(options), request); +} + +future ZoneVmExtensionPoliciesRestMetadata::AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest const& request) { + SetMetadata(*rest_context, *options); + return child_->AsyncCancelOperation(cq, std::move(rest_context), + std::move(options), request); +} + +void ZoneVmExtensionPoliciesRestMetadata::SetMetadata( + rest_internal::RestContext& rest_context, Options const& options, + std::vector const& params) { + google::cloud::rest_internal::SetMetadata(rest_context, options, params, + api_client_header_); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_zone_vm_extension_policies_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_rest_metadata_decorator.h b/google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_rest_metadata_decorator.h new file mode 100644 index 0000000000000..09be2ae7628d1 --- /dev/null +++ b/google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_rest_metadata_decorator.h @@ -0,0 +1,130 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ZONE_VM_EXTENSION_POLICIES_V1_INTERNAL_ZONE_VM_EXTENSION_POLICIES_REST_METADATA_DECORATOR_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ZONE_VM_EXTENSION_POLICIES_V1_INTERNAL_ZONE_VM_EXTENSION_POLICIES_REST_METADATA_DECORATOR_H + +#include "google/cloud/compute/zone_operations/v1/zone_operations.pb.h" +#include "google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_rest_stub.h" +#include "google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies.pb.h" +#include "google/cloud/future.h" +#include "google/cloud/rest_options.h" +#include "google/cloud/version.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_zone_vm_extension_policies_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class ZoneVmExtensionPoliciesRestMetadata + : public ZoneVmExtensionPoliciesRestStub { + public: + ~ZoneVmExtensionPoliciesRestMetadata() override = default; + explicit ZoneVmExtensionPoliciesRestMetadata( + std::shared_ptr child, + std::string api_client_header = ""); + + google::cloud::future> + AsyncDeleteVmExtensionPolicy( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + DeleteVmExtensionPolicyRequest const& request) override; + + StatusOr DeleteVmExtensionPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + DeleteVmExtensionPolicyRequest const& request) override; + + StatusOr + GetVmExtensionPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + GetVmExtensionPolicyRequest const& request) override; + + google::cloud::future> + AsyncInsertVmExtensionPolicy( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + InsertVmExtensionPolicyRequest const& request) override; + + StatusOr InsertVmExtensionPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + InsertVmExtensionPolicyRequest const& request) override; + + StatusOr + ListZoneVmExtensionPolicies( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + ListZoneVmExtensionPoliciesRequest const& request) override; + + google::cloud::future> + AsyncUpdateVmExtensionPolicy( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + UpdateVmExtensionPolicyRequest const& request) override; + + StatusOr UpdateVmExtensionPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + UpdateVmExtensionPolicyRequest const& request) override; + + google::cloud::future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + GetOperationRequest const& request) override; + + google::cloud::future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest const& request) override; + + private: + void SetMetadata(rest_internal::RestContext& rest_context, + Options const& options, + std::vector const& params = {}); + + std::shared_ptr child_; + std::string api_client_header_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_zone_vm_extension_policies_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ZONE_VM_EXTENSION_POLICIES_V1_INTERNAL_ZONE_VM_EXTENSION_POLICIES_REST_METADATA_DECORATOR_H diff --git a/google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_rest_stub.cc b/google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_rest_stub.cc new file mode 100644 index 0000000000000..9d545b84aa208 --- /dev/null +++ b/google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_rest_stub.cc @@ -0,0 +1,332 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies.proto + +#include "google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_rest_stub.h" +#include "google/cloud/compute/zone_operations/v1/zone_operations.pb.h" +#include "google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies.pb.h" +#include "google/cloud/common_options.h" +#include "google/cloud/internal/rest_stub_helpers.h" +#include "google/cloud/status_or.h" +#include "absl/strings/str_cat.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_zone_vm_extension_policies_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +DefaultZoneVmExtensionPoliciesRestStub::DefaultZoneVmExtensionPoliciesRestStub( + Options options) + : service_(rest_internal::MakePooledRestClient( + options.get(), options)), + operations_(rest_internal::MakePooledRestClient( + options.get(), options)), + options_(std::move(options)) {} + +DefaultZoneVmExtensionPoliciesRestStub::DefaultZoneVmExtensionPoliciesRestStub( + std::shared_ptr service, + std::shared_ptr operations, Options options) + : service_(std::move(service)), + operations_(std::move(operations)), + options_(std::move(options)) {} + +future> +DefaultZoneVmExtensionPoliciesRestStub::AsyncDeleteVmExtensionPolicy( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + DeleteVmExtensionPolicyRequest const& request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto service, auto request, auto rest_context, auto options) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + p.set_value( + rest_internal::Delete( + *service, *rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", *options), + "/", "projects", "/", request.project(), "/", + "zones", "/", request.zone(), "/", + "vmExtensionPolicies", "/", + request.vm_extension_policy()), + std::move(query_params))); + }, + std::move(p), + service_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +StatusOr +DefaultZoneVmExtensionPoliciesRestStub::DeleteVmExtensionPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + DeleteVmExtensionPolicyRequest const& request) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Delete( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "zones", "/", + request.zone(), "/", "vmExtensionPolicies", "/", + request.vm_extension_policy()), + std::move(query_params)); +} + +StatusOr +DefaultZoneVmExtensionPoliciesRestStub::GetVmExtensionPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + GetVmExtensionPolicyRequest const& request) { + std::vector> query_params; + return rest_internal::Get( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "zones", "/", + request.zone(), "/", "vmExtensionPolicies", "/", + request.vm_extension_policy()), + std::move(query_params)); +} + +future> +DefaultZoneVmExtensionPoliciesRestStub::AsyncInsertVmExtensionPolicy( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + InsertVmExtensionPolicyRequest const& request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto service, auto request, auto rest_context, auto options) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + p.set_value( + rest_internal::Post( + *service, *rest_context, request.vm_extension_policy_resource(), + false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", *options), + "/", "projects", "/", request.project(), "/", + "zones", "/", request.zone(), "/", + "vmExtensionPolicies"), + std::move(query_params))); + }, + std::move(p), + service_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +StatusOr +DefaultZoneVmExtensionPoliciesRestStub::InsertVmExtensionPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + InsertVmExtensionPolicyRequest const& request) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Post( + *service_, rest_context, request.vm_extension_policy_resource(), false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "zones", "/", + request.zone(), "/", "vmExtensionPolicies"), + std::move(query_params)); +} + +StatusOr +DefaultZoneVmExtensionPoliciesRestStub::ListZoneVmExtensionPolicies( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + ListZoneVmExtensionPoliciesRequest const& request) { + std::vector> query_params; + query_params.push_back({"filter", request.filter()}); + query_params.push_back( + {"max_results", std::to_string(request.max_results())}); + query_params.push_back({"order_by", request.order_by()}); + query_params.push_back({"page_token", request.page_token()}); + query_params.push_back({"return_partial_success", + (request.return_partial_success() ? "1" : "0")}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Get< + google::cloud::cpp::compute::v1::VmExtensionPolicyList>( + *service_, rest_context, request, false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "zones", "/", + request.zone(), "/", "vmExtensionPolicies"), + std::move(query_params)); +} + +future> +DefaultZoneVmExtensionPoliciesRestStub::AsyncUpdateVmExtensionPolicy( + CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + UpdateVmExtensionPolicyRequest const& request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto service, auto request, auto rest_context, auto options) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + p.set_value( + rest_internal::Patch( + *service, *rest_context, request.vm_extension_policy_resource(), + false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", *options), + "/", "projects", "/", request.project(), "/", + "zones", "/", request.zone(), "/", + "vmExtensionPolicies", "/", + request.vm_extension_policy()), + std::move(query_params))); + }, + std::move(p), + service_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +StatusOr +DefaultZoneVmExtensionPoliciesRestStub::UpdateVmExtensionPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + UpdateVmExtensionPolicyRequest const& request) { + std::vector> query_params; + query_params.push_back({"request_id", request.request_id()}); + query_params = + rest_internal::TrimEmptyQueryParameters(std::move(query_params)); + return rest_internal::Patch( + *service_, rest_context, request.vm_extension_policy_resource(), false, + absl::StrCat("/", "compute", "/", + rest_internal::DetermineApiVersion("v1", options), "/", + "projects", "/", request.project(), "/", "zones", "/", + request.zone(), "/", "vmExtensionPolicies", "/", + request.vm_extension_policy()), + std::move(query_params)); +} + +future> +DefaultZoneVmExtensionPoliciesRestStub::AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1::GetOperationRequest const& + request) { + promise> p; + future> f = + p.get_future(); + std::thread t{ + [](auto p, auto operations, auto request, auto rest_context, + auto options) { + p.set_value( + rest_internal::Get( + *operations, *rest_context, request, false, + absl::StrCat("/compute/", + rest_internal::DetermineApiVersion("v1", *options), + "/projects/", request.project(), "/zones/", + request.zone(), "/operations/", + request.operation()))); + }, + std::move(p), + operations_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get(); + }); +} + +future DefaultZoneVmExtensionPoliciesRestStub::AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest const& request) { + promise> p; + future> f = p.get_future(); + std::thread t{ + [](auto p, auto operations, auto request, auto rest_context, + auto options) { + p.set_value(rest_internal::Post( + *operations, *rest_context, request, false, + absl::StrCat("/compute/", + rest_internal::DetermineApiVersion("v1", *options), + "/projects/", request.project(), "/zones/", + request.zone(), "/operations/", request.operation()))); + }, + std::move(p), + operations_, + request, + std::move(rest_context), + std::move(options)}; + return f.then([t = std::move(t), cq](auto f) mutable { + cq.RunAsync([t = std::move(t)]() mutable { t.join(); }); + return f.get().status(); + }); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_zone_vm_extension_policies_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_rest_stub.h b/google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_rest_stub.h new file mode 100644 index 0000000000000..2f17c70d8c5bd --- /dev/null +++ b/google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_rest_stub.h @@ -0,0 +1,207 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ZONE_VM_EXTENSION_POLICIES_V1_INTERNAL_ZONE_VM_EXTENSION_POLICIES_REST_STUB_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ZONE_VM_EXTENSION_POLICIES_V1_INTERNAL_ZONE_VM_EXTENSION_POLICIES_REST_STUB_H + +#include "google/cloud/compute/zone_operations/v1/zone_operations.pb.h" +#include "google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies.pb.h" +#include "google/cloud/completion_queue.h" +#include "google/cloud/internal/rest_client.h" +#include "google/cloud/internal/rest_context.h" +#include "google/cloud/status_or.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_zone_vm_extension_policies_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class ZoneVmExtensionPoliciesRestStub { + public: + virtual ~ZoneVmExtensionPoliciesRestStub() = default; + + virtual future> + AsyncDeleteVmExtensionPolicy( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + DeleteVmExtensionPolicyRequest const& request) = 0; + + virtual StatusOr + DeleteVmExtensionPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + DeleteVmExtensionPolicyRequest const& request) = 0; + + virtual StatusOr + GetVmExtensionPolicy(google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::zone_vm_extension_policies:: + v1::GetVmExtensionPolicyRequest const& request) = 0; + + virtual future> + AsyncInsertVmExtensionPolicy( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + InsertVmExtensionPolicyRequest const& request) = 0; + + virtual StatusOr + InsertVmExtensionPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + InsertVmExtensionPolicyRequest const& request) = 0; + + virtual StatusOr + ListZoneVmExtensionPolicies( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + ListZoneVmExtensionPoliciesRequest const& request) = 0; + + virtual future> + AsyncUpdateVmExtensionPolicy( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + UpdateVmExtensionPolicyRequest const& request) = 0; + + virtual StatusOr + UpdateVmExtensionPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + UpdateVmExtensionPolicyRequest const& request) = 0; + + virtual future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + GetOperationRequest const& request) = 0; + + virtual future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest const& request) = 0; +}; + +class DefaultZoneVmExtensionPoliciesRestStub + : public ZoneVmExtensionPoliciesRestStub { + public: + ~DefaultZoneVmExtensionPoliciesRestStub() override = default; + + explicit DefaultZoneVmExtensionPoliciesRestStub(Options options); + DefaultZoneVmExtensionPoliciesRestStub( + std::shared_ptr service, + std::shared_ptr operations, Options options); + + future> + AsyncDeleteVmExtensionPolicy( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + DeleteVmExtensionPolicyRequest const& request) override; + + StatusOr DeleteVmExtensionPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + DeleteVmExtensionPolicyRequest const& request) override; + + StatusOr + GetVmExtensionPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + GetVmExtensionPolicyRequest const& request) override; + + future> + AsyncInsertVmExtensionPolicy( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + InsertVmExtensionPolicyRequest const& request) override; + + StatusOr InsertVmExtensionPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + InsertVmExtensionPolicyRequest const& request) override; + + StatusOr + ListZoneVmExtensionPolicies( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + ListZoneVmExtensionPoliciesRequest const& request) override; + + future> + AsyncUpdateVmExtensionPolicy( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + UpdateVmExtensionPolicyRequest const& request) override; + + StatusOr UpdateVmExtensionPolicy( + google::cloud::rest_internal::RestContext& rest_context, + Options const& options, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + UpdateVmExtensionPolicyRequest const& request) override; + + future> + AsyncGetOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + GetOperationRequest const& request) override; + + future AsyncCancelOperation( + google::cloud::CompletionQueue& cq, + std::unique_ptr rest_context, + google::cloud::internal::ImmutableOptions options, + google::cloud::cpp::compute::zone_operations::v1:: + DeleteOperationRequest const& request) override; + + private: + std::shared_ptr service_; + std::shared_ptr operations_; + Options options_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_zone_vm_extension_policies_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ZONE_VM_EXTENSION_POLICIES_V1_INTERNAL_ZONE_VM_EXTENSION_POLICIES_REST_STUB_H diff --git a/google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_rest_stub_factory.cc b/google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_rest_stub_factory.cc new file mode 100644 index 0000000000000..75accd1e9f984 --- /dev/null +++ b/google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_rest_stub_factory.cc @@ -0,0 +1,57 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies.proto + +#include "google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_rest_stub_factory.h" +#include "google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_rest_logging_decorator.h" +#include "google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_rest_metadata_decorator.h" +#include "google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_rest_stub.h" +#include "google/cloud/common_options.h" +#include "google/cloud/internal/algorithm.h" +#include "google/cloud/internal/populate_rest_options.h" +#include "google/cloud/log.h" +#include "google/cloud/options.h" +#include "google/cloud/rest_options.h" +#include "absl/strings/match.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_zone_vm_extension_policies_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +std::shared_ptr +CreateDefaultZoneVmExtensionPoliciesRestStub(Options const& options) { + auto opts = internal::PopulateRestOptions(options); + std::shared_ptr stub = + std::make_shared(std::move(opts)); + stub = std::make_shared(std::move(stub)); + if (internal::Contains(options.get(), "rpc")) { + GCP_LOG(INFO) << "Enabled logging for REST rpc calls"; + stub = std::make_shared( + std::move(stub), options.get(), + options.get()); + } + return stub; +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_zone_vm_extension_policies_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_rest_stub_factory.h b/google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_rest_stub_factory.h new file mode 100644 index 0000000000000..1670ae7ecfffa --- /dev/null +++ b/google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_rest_stub_factory.h @@ -0,0 +1,41 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ZONE_VM_EXTENSION_POLICIES_V1_INTERNAL_ZONE_VM_EXTENSION_POLICIES_REST_STUB_FACTORY_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ZONE_VM_EXTENSION_POLICIES_V1_INTERNAL_ZONE_VM_EXTENSION_POLICIES_REST_STUB_FACTORY_H + +#include "google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_rest_stub.h" +#include "google/cloud/options.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_zone_vm_extension_policies_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +std::shared_ptr +CreateDefaultZoneVmExtensionPoliciesRestStub(Options const& options); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_zone_vm_extension_policies_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ZONE_VM_EXTENSION_POLICIES_V1_INTERNAL_ZONE_VM_EXTENSION_POLICIES_REST_STUB_FACTORY_H diff --git a/google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_retry_traits.h b/google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_retry_traits.h new file mode 100644 index 0000000000000..ebdcfea7d0f05 --- /dev/null +++ b/google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_retry_traits.h @@ -0,0 +1,44 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ZONE_VM_EXTENSION_POLICIES_V1_INTERNAL_ZONE_VM_EXTENSION_POLICIES_RETRY_TRAITS_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ZONE_VM_EXTENSION_POLICIES_V1_INTERNAL_ZONE_VM_EXTENSION_POLICIES_RETRY_TRAITS_H + +#include "google/cloud/status.h" +#include "google/cloud/version.h" + +namespace google { +namespace cloud { +namespace compute_zone_vm_extension_policies_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/// Define the gRPC status code semantics for retrying requests. +struct ZoneVmExtensionPoliciesRetryTraits { + static bool IsPermanentFailure(google::cloud::Status const& status) { + return status.code() != StatusCode::kOk && + status.code() != StatusCode::kUnavailable; + } +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_zone_vm_extension_policies_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ZONE_VM_EXTENSION_POLICIES_V1_INTERNAL_ZONE_VM_EXTENSION_POLICIES_RETRY_TRAITS_H diff --git a/google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_sources.cc b/google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_sources.cc new file mode 100644 index 0000000000000..fc18ad57db6d7 --- /dev/null +++ b/google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_sources.cc @@ -0,0 +1,32 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies.proto + +// NOLINTBEGIN(bugprone-suspicious-include) +#include "google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_option_defaults.cc" +#include "google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_rest_connection_impl.cc" +#include "google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_rest_logging_decorator.cc" +#include "google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_rest_metadata_decorator.cc" +#include "google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_rest_stub.cc" +#include "google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_rest_stub_factory.cc" +#include "google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_tracing_connection.cc" +#include "google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies_client.cc" +#include "google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies_connection.cc" +#include "google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies_connection_idempotency_policy.cc" +#include "google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies_rest_connection.cc" +// NOLINTEND(bugprone-suspicious-include) diff --git a/google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_tracing_connection.cc b/google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_tracing_connection.cc new file mode 100644 index 0000000000000..2f822f21ac29d --- /dev/null +++ b/google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_tracing_connection.cc @@ -0,0 +1,184 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies.proto + +#include "google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_tracing_connection.h" +#include "google/cloud/internal/opentelemetry.h" +#include "google/cloud/internal/traced_stream_range.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_zone_vm_extension_policies_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +ZoneVmExtensionPoliciesTracingConnection:: + ZoneVmExtensionPoliciesTracingConnection( + std::shared_ptr + child) + : child_(std::move(child)) {} + +future> +ZoneVmExtensionPoliciesTracingConnection::DeleteVmExtensionPolicy( + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + DeleteVmExtensionPolicyRequest const& request) { + auto span = internal::MakeSpan( + "compute_zone_vm_extension_policies_v1::" + "ZoneVmExtensionPoliciesConnection::DeleteVmExtensionPolicy"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), + child_->DeleteVmExtensionPolicy(request)); +} + +StatusOr +ZoneVmExtensionPoliciesTracingConnection::DeleteVmExtensionPolicy( + NoAwaitTag, google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + DeleteVmExtensionPolicyRequest const& request) { + auto span = internal::MakeSpan( + "compute_zone_vm_extension_policies_v1::" + "ZoneVmExtensionPoliciesConnection::DeleteVmExtensionPolicy"); + opentelemetry::trace::Scope scope(span); + return internal::EndSpan( + *span, child_->DeleteVmExtensionPolicy(NoAwaitTag{}, request)); +} + +future> +ZoneVmExtensionPoliciesTracingConnection::DeleteVmExtensionPolicy( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto span = internal::MakeSpan( + "compute_zone_vm_extension_policies_v1::" + "ZoneVmExtensionPoliciesConnection::DeleteVmExtensionPolicy"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), + child_->DeleteVmExtensionPolicy(operation)); +} + +StatusOr +ZoneVmExtensionPoliciesTracingConnection::GetVmExtensionPolicy( + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + GetVmExtensionPolicyRequest const& request) { + auto span = internal::MakeSpan( + "compute_zone_vm_extension_policies_v1::" + "ZoneVmExtensionPoliciesConnection::GetVmExtensionPolicy"); + auto scope = opentelemetry::trace::Scope(span); + return internal::EndSpan(*span, child_->GetVmExtensionPolicy(request)); +} + +future> +ZoneVmExtensionPoliciesTracingConnection::InsertVmExtensionPolicy( + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + InsertVmExtensionPolicyRequest const& request) { + auto span = internal::MakeSpan( + "compute_zone_vm_extension_policies_v1::" + "ZoneVmExtensionPoliciesConnection::InsertVmExtensionPolicy"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), + child_->InsertVmExtensionPolicy(request)); +} + +StatusOr +ZoneVmExtensionPoliciesTracingConnection::InsertVmExtensionPolicy( + NoAwaitTag, google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + InsertVmExtensionPolicyRequest const& request) { + auto span = internal::MakeSpan( + "compute_zone_vm_extension_policies_v1::" + "ZoneVmExtensionPoliciesConnection::InsertVmExtensionPolicy"); + opentelemetry::trace::Scope scope(span); + return internal::EndSpan( + *span, child_->InsertVmExtensionPolicy(NoAwaitTag{}, request)); +} + +future> +ZoneVmExtensionPoliciesTracingConnection::InsertVmExtensionPolicy( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto span = internal::MakeSpan( + "compute_zone_vm_extension_policies_v1::" + "ZoneVmExtensionPoliciesConnection::InsertVmExtensionPolicy"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), + child_->InsertVmExtensionPolicy(operation)); +} + +StreamRange +ZoneVmExtensionPoliciesTracingConnection::ListZoneVmExtensionPolicies( + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + ListZoneVmExtensionPoliciesRequest request) { + auto span = internal::MakeSpan( + "compute_zone_vm_extension_policies_v1::" + "ZoneVmExtensionPoliciesConnection::ListZoneVmExtensionPolicies"); + internal::OTelScope scope(span); + auto sr = child_->ListZoneVmExtensionPolicies(std::move(request)); + return internal::MakeTracedStreamRange< + google::cloud::cpp::compute::v1::VmExtensionPolicy>(std::move(span), + std::move(sr)); +} + +future> +ZoneVmExtensionPoliciesTracingConnection::UpdateVmExtensionPolicy( + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + UpdateVmExtensionPolicyRequest const& request) { + auto span = internal::MakeSpan( + "compute_zone_vm_extension_policies_v1::" + "ZoneVmExtensionPoliciesConnection::UpdateVmExtensionPolicy"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), + child_->UpdateVmExtensionPolicy(request)); +} + +StatusOr +ZoneVmExtensionPoliciesTracingConnection::UpdateVmExtensionPolicy( + NoAwaitTag, google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + UpdateVmExtensionPolicyRequest const& request) { + auto span = internal::MakeSpan( + "compute_zone_vm_extension_policies_v1::" + "ZoneVmExtensionPoliciesConnection::UpdateVmExtensionPolicy"); + opentelemetry::trace::Scope scope(span); + return internal::EndSpan( + *span, child_->UpdateVmExtensionPolicy(NoAwaitTag{}, request)); +} + +future> +ZoneVmExtensionPoliciesTracingConnection::UpdateVmExtensionPolicy( + google::cloud::cpp::compute::v1::Operation const& operation) { + auto span = internal::MakeSpan( + "compute_zone_vm_extension_policies_v1::" + "ZoneVmExtensionPoliciesConnection::UpdateVmExtensionPolicy"); + internal::OTelScope scope(span); + return internal::EndSpan(std::move(span), + child_->UpdateVmExtensionPolicy(operation)); +} + +std::shared_ptr< + compute_zone_vm_extension_policies_v1::ZoneVmExtensionPoliciesConnection> +MakeZoneVmExtensionPoliciesTracingConnection( + std::shared_ptr + conn) { + if (internal::TracingEnabled(conn->options())) { + conn = std::make_shared( + std::move(conn)); + } + return conn; +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_zone_vm_extension_policies_v1_internal +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_tracing_connection.h b/google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_tracing_connection.h new file mode 100644 index 0000000000000..a16718717bbb1 --- /dev/null +++ b/google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_tracing_connection.h @@ -0,0 +1,118 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ZONE_VM_EXTENSION_POLICIES_V1_INTERNAL_ZONE_VM_EXTENSION_POLICIES_TRACING_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ZONE_VM_EXTENSION_POLICIES_V1_INTERNAL_ZONE_VM_EXTENSION_POLICIES_TRACING_CONNECTION_H + +#include "google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies_connection.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_zone_vm_extension_policies_v1_internal { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class ZoneVmExtensionPoliciesTracingConnection + : public compute_zone_vm_extension_policies_v1:: + ZoneVmExtensionPoliciesConnection { + public: + ~ZoneVmExtensionPoliciesTracingConnection() override = default; + + explicit ZoneVmExtensionPoliciesTracingConnection( + std::shared_ptr + child); + + Options options() override { return child_->options(); } + + future> + DeleteVmExtensionPolicy( + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + DeleteVmExtensionPolicyRequest const& request) override; + + StatusOr DeleteVmExtensionPolicy( + NoAwaitTag, google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + DeleteVmExtensionPolicyRequest const& request) override; + + future> + DeleteVmExtensionPolicy( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + StatusOr + GetVmExtensionPolicy( + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + GetVmExtensionPolicyRequest const& request) override; + + future> + InsertVmExtensionPolicy( + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + InsertVmExtensionPolicyRequest const& request) override; + + StatusOr InsertVmExtensionPolicy( + NoAwaitTag, google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + InsertVmExtensionPolicyRequest const& request) override; + + future> + InsertVmExtensionPolicy( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + StreamRange + ListZoneVmExtensionPolicies( + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + ListZoneVmExtensionPoliciesRequest request) override; + + future> + UpdateVmExtensionPolicy( + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + UpdateVmExtensionPolicyRequest const& request) override; + + StatusOr UpdateVmExtensionPolicy( + NoAwaitTag, google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + UpdateVmExtensionPolicyRequest const& request) override; + + future> + UpdateVmExtensionPolicy( + google::cloud::cpp::compute::v1::Operation const& operation) override; + + private: + std::shared_ptr< + compute_zone_vm_extension_policies_v1::ZoneVmExtensionPoliciesConnection> + child_; +}; + +/** + * Conditionally applies the tracing decorator to the given connection. + * + * The connection is only decorated if tracing is enabled (as determined by the + * connection's options). + */ +std::shared_ptr< + compute_zone_vm_extension_policies_v1::ZoneVmExtensionPoliciesConnection> +MakeZoneVmExtensionPoliciesTracingConnection( + std::shared_ptr + conn); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_zone_vm_extension_policies_v1_internal +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ZONE_VM_EXTENSION_POLICIES_V1_INTERNAL_ZONE_VM_EXTENSION_POLICIES_TRACING_CONNECTION_H diff --git a/google/cloud/compute/zone_vm_extension_policies/v1/mocks/mock_zone_vm_extension_policies_connection.h b/google/cloud/compute/zone_vm_extension_policies/v1/mocks/mock_zone_vm_extension_policies_connection.h new file mode 100644 index 0000000000000..adec5a6a06664 --- /dev/null +++ b/google/cloud/compute/zone_vm_extension_policies/v1/mocks/mock_zone_vm_extension_policies_connection.h @@ -0,0 +1,196 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ZONE_VM_EXTENSION_POLICIES_V1_MOCKS_MOCK_ZONE_VM_EXTENSION_POLICIES_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ZONE_VM_EXTENSION_POLICIES_V1_MOCKS_MOCK_ZONE_VM_EXTENSION_POLICIES_CONNECTION_H + +#include "google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies_connection.h" +#include + +namespace google { +namespace cloud { +namespace compute_zone_vm_extension_policies_v1_mocks { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/** + * A class to mock `ZoneVmExtensionPoliciesConnection`. + * + * Application developers may want to test their code with simulated responses, + * including errors, from an object of type `ZoneVmExtensionPoliciesClient`. To + * do so, construct an object of type `ZoneVmExtensionPoliciesClient` with an + * instance of this class. Then use the Google Test framework functions to + * program the behavior of this mock. + * + * @see [This example][bq-mock] for how to test your application with GoogleTest. + * While the example showcases types from the BigQuery library, the underlying + * principles apply for any pair of `*Client` and `*Connection`. + * + * [bq-mock]: @cloud_cpp_docs_link{bigquery,bigquery-read-mock} + */ +class MockZoneVmExtensionPoliciesConnection + : public compute_zone_vm_extension_policies_v1:: + ZoneVmExtensionPoliciesConnection { + public: + MOCK_METHOD(Options, options, (), (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// DeleteVmExtensionPolicy(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + DeleteVmExtensionPolicy, + (google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + DeleteVmExtensionPolicyRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// EXPECT_CALL(*mock, DeleteVmExtensionPolicy(_, _)) + /// @endcode + MOCK_METHOD(StatusOr, + DeleteVmExtensionPolicy, + (NoAwaitTag, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + DeleteVmExtensionPolicyRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// DeleteVmExtensionPolicy(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + DeleteVmExtensionPolicy, + (google::cloud::cpp::compute::v1::Operation const& operation), + (override)); + + MOCK_METHOD(StatusOr, + GetVmExtensionPolicy, + (google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + GetVmExtensionPolicyRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// InsertVmExtensionPolicy(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + InsertVmExtensionPolicy, + (google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + InsertVmExtensionPolicyRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// EXPECT_CALL(*mock, InsertVmExtensionPolicy(_, _)) + /// @endcode + MOCK_METHOD(StatusOr, + InsertVmExtensionPolicy, + (NoAwaitTag, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + InsertVmExtensionPolicyRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// InsertVmExtensionPolicy(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + InsertVmExtensionPolicy, + (google::cloud::cpp::compute::v1::Operation const& operation), + (override)); + + MOCK_METHOD((StreamRange), + ListZoneVmExtensionPolicies, + (google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + ListZoneVmExtensionPoliciesRequest request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// UpdateVmExtensionPolicy(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + UpdateVmExtensionPolicy, + (google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + UpdateVmExtensionPolicyRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// EXPECT_CALL(*mock, UpdateVmExtensionPolicy(_, _)) + /// @endcode + MOCK_METHOD(StatusOr, + UpdateVmExtensionPolicy, + (NoAwaitTag, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + UpdateVmExtensionPolicyRequest const& request), + (override)); + + /// To disambiguate calls, use: + /// + /// @code + /// using ::testing::_; + /// using ::testing::Matcher; + /// EXPECT_CALL(*mock, + /// UpdateVmExtensionPolicy(Matcher(_))) + /// @endcode + MOCK_METHOD(future>, + UpdateVmExtensionPolicy, + (google::cloud::cpp::compute::v1::Operation const& operation), + (override)); +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_zone_vm_extension_policies_v1_mocks +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ZONE_VM_EXTENSION_POLICIES_V1_MOCKS_MOCK_ZONE_VM_EXTENSION_POLICIES_CONNECTION_H diff --git a/google/cloud/compute/zone_vm_extension_policies/v1/samples/zone_vm_extension_policies_client_samples.cc b/google/cloud/compute/zone_vm_extension_policies/v1/samples/zone_vm_extension_policies_client_samples.cc new file mode 100644 index 0000000000000..837ed8dc1e37f --- /dev/null +++ b/google/cloud/compute/zone_vm_extension_policies/v1/samples/zone_vm_extension_policies_client_samples.cc @@ -0,0 +1,244 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies.proto + +#include "google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies_client.h" +#include "google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies_connection_idempotency_policy.h" +#include "google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies_options.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/internal/getenv.h" +#include "google/cloud/polling_policy.h" +#include "google/cloud/testing_util/example_driver.h" +#include "google/cloud/universe_domain.h" +#include +#include +#include +#include + +// clang-format off +// main-dox-marker: compute_zone_vm_extension_policies_v1::ZoneVmExtensionPoliciesClient +// lro-marker: true +// clang-format on +namespace { + +void SetClientEndpoint(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-endpoint"}; + } + //! [set-client-endpoint] + // This configuration is common with Private Google Access: + // https://cloud.google.com/vpc/docs/private-google-access + auto options = google::cloud::Options{}.set( + "private.googleapis.com"); + auto vpc_client = google::cloud::compute_zone_vm_extension_policies_v1:: + ZoneVmExtensionPoliciesClient( + google::cloud::compute_zone_vm_extension_policies_v1:: + MakeZoneVmExtensionPoliciesConnectionRest(options)); + //! [set-client-endpoint] +} + +void SetClientUniverseDomain(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-universe-domain"}; + } + //! [set-client-universe-domain] + google::cloud::Options options; + + // AddUniverseDomainOption interrogates the UnifiedCredentialsOption, if set, + // in the provided Options for the Universe Domain associated with the + // credentials and adds it to the set of Options. + // If no UnifiedCredentialsOption is set, GoogleDefaultCredentials are used. + auto ud_options = google::cloud::AddUniverseDomainOption(std::move(options)); + + if (!ud_options.ok()) throw std::move(ud_options).status(); + auto ud_client = google::cloud::compute_zone_vm_extension_policies_v1:: + ZoneVmExtensionPoliciesClient( + google::cloud::compute_zone_vm_extension_policies_v1:: + MakeZoneVmExtensionPoliciesConnectionRest(*ud_options)); + //! [set-client-universe-domain] +} + +//! [custom-idempotency-policy] +class CustomIdempotencyPolicy + : public google::cloud::compute_zone_vm_extension_policies_v1:: + ZoneVmExtensionPoliciesConnectionIdempotencyPolicy { + public: + ~CustomIdempotencyPolicy() override = default; + std::unique_ptr + clone() const override { + return std::make_unique(*this); + } + // Override inherited functions to define as needed. +}; +//! [custom-idempotency-policy] + +void SetRetryPolicy(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-retry-policy"}; + } + //! [set-retry-policy] + auto options = + google::cloud::Options{} + .set( + CustomIdempotencyPolicy().clone()) + .set( + google::cloud::compute_zone_vm_extension_policies_v1:: + ZoneVmExtensionPoliciesLimitedErrorCountRetryPolicy(3) + .clone()) + .set( + google::cloud::ExponentialBackoffPolicy( + /*initial_delay=*/std::chrono::milliseconds(200), + /*maximum_delay=*/std::chrono::seconds(45), + /*scaling=*/2.0) + .clone()); + auto connection = google::cloud::compute_zone_vm_extension_policies_v1:: + MakeZoneVmExtensionPoliciesConnectionRest(options); + + // c1 and c2 share the same retry policies + auto c1 = google::cloud::compute_zone_vm_extension_policies_v1:: + ZoneVmExtensionPoliciesClient(connection); + auto c2 = google::cloud::compute_zone_vm_extension_policies_v1:: + ZoneVmExtensionPoliciesClient(connection); + + // You can override any of the policies in a new client. This new client + // will share the policies from c1 (or c2) *except* for the retry policy. + auto c3 = google::cloud::compute_zone_vm_extension_policies_v1:: + ZoneVmExtensionPoliciesClient( + connection, + google::cloud::Options{} + .set( + google::cloud::compute_zone_vm_extension_policies_v1:: + ZoneVmExtensionPoliciesLimitedTimeRetryPolicy( + std::chrono::minutes(5)) + .clone())); + + // You can also override the policies in a single call: + // c3.SomeRpc(..., google::cloud::Options{} + // .set( + // google::cloud::compute_zone_vm_extension_policies_v1::ZoneVmExtensionPoliciesLimitedErrorCountRetryPolicy(10).clone())); + //! [set-retry-policy] +} + +void SetPollingPolicy(std::vector const& argv) { + if (!argv.empty()) { + throw google::cloud::testing_util::Usage{"set-client-policy-policy"}; + } + //! [set-polling-policy] + + // The polling policy controls how the client waits for long-running + // operations. `GenericPollingPolicy<>` combines existing policies. + // In this case, keep polling until the operation completes (with success + // or error) or 45 minutes, whichever happens first. Initially pause for + // 10 seconds between polling requests, increasing the pause by a factor + // of 4 until it becomes 2 minutes. + auto options = + google::cloud::Options{} + .set( + google::cloud::GenericPollingPolicy< + google::cloud::compute_zone_vm_extension_policies_v1:: + ZoneVmExtensionPoliciesRetryPolicyOption::Type, + google::cloud::compute_zone_vm_extension_policies_v1:: + ZoneVmExtensionPoliciesBackoffPolicyOption::Type>( + google::cloud::compute_zone_vm_extension_policies_v1:: + ZoneVmExtensionPoliciesLimitedTimeRetryPolicy( + /*maximum_duration=*/std::chrono::minutes(45)) + .clone(), + google::cloud::ExponentialBackoffPolicy( + /*initial_delay=*/std::chrono::seconds(10), + /*maximum_delay=*/std::chrono::minutes(2), + /*scaling=*/4.0) + .clone()) + .clone()); + + auto connection = google::cloud::compute_zone_vm_extension_policies_v1:: + MakeZoneVmExtensionPoliciesConnectionRest(options); + + // c1 and c2 share the same polling policies. + auto c1 = google::cloud::compute_zone_vm_extension_policies_v1:: + ZoneVmExtensionPoliciesClient(connection); + auto c2 = google::cloud::compute_zone_vm_extension_policies_v1:: + ZoneVmExtensionPoliciesClient(connection); + //! [set-polling-policy] +} + +void WithServiceAccount(std::vector const& argv) { + if (argv.size() != 1 || argv[0] == "--help") { + throw google::cloud::testing_util::Usage{"with-service-account "}; + } + //! [with-service-account] + [](std::string const& keyfile) { + auto is = std::ifstream(keyfile); + is.exceptions(std::ios::badbit); // Minimal error handling in examples + auto contents = std::string(std::istreambuf_iterator(is.rdbuf()), {}); + auto options = + google::cloud::Options{}.set( + google::cloud::MakeServiceAccountCredentials(contents)); + return google::cloud::compute_zone_vm_extension_policies_v1:: + ZoneVmExtensionPoliciesClient( + google::cloud::compute_zone_vm_extension_policies_v1:: + MakeZoneVmExtensionPoliciesConnectionRest(options)); + } + //! [with-service-account] + (argv.at(0)); +} + +void AutoRun(std::vector const& argv) { + namespace examples = ::google::cloud::testing_util; + using ::google::cloud::internal::GetEnv; + if (!argv.empty()) throw examples::Usage{"auto"}; + examples::CheckEnvironmentVariablesAreSet( + {"GOOGLE_CLOUD_CPP_TEST_SERVICE_ACCOUNT_KEYFILE"}); + auto const keyfile = + GetEnv("GOOGLE_CLOUD_CPP_TEST_SERVICE_ACCOUNT_KEYFILE").value(); + + std::cout << "\nRunning SetClientEndpoint() example" << std::endl; + SetClientEndpoint({}); + + std::cout << "\nRunning SetRetryPolicy() example" << std::endl; + SetRetryPolicy({}); + + std::cout << "\nRunning SetPollingPolicy() example" << std::endl; + SetPollingPolicy({}); + + std::cout << "\nRunning WithServiceAccount() example" << std::endl; + WithServiceAccount({keyfile}); + + std::cout << "\nRunning SetClientUniverseDomain() example" << std::endl; + SetClientUniverseDomain({}); +} + +} // namespace + +int main(int argc, char* argv[]) { // NOLINT(bugprone-exception-escape) + google::cloud::testing_util::Example example({ + {"set-client-endpoint", SetClientEndpoint}, + {"set-retry-policy", SetRetryPolicy}, + {"set-polling-policy", SetPollingPolicy}, + {"with-service-account", WithServiceAccount}, + {"set-client-universe-domain", SetClientUniverseDomain}, + {"auto", AutoRun}, + }); + return example.Run(argc, argv); +} diff --git a/google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies_client.cc b/google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies_client.cc new file mode 100644 index 0000000000000..48becb551c1a8 --- /dev/null +++ b/google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies_client.cc @@ -0,0 +1,253 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies.proto + +#include "google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies_client.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_zone_vm_extension_policies_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +ZoneVmExtensionPoliciesClient::ZoneVmExtensionPoliciesClient( + std::shared_ptr connection, Options opts) + : connection_(std::move(connection)), + options_( + internal::MergeOptions(std::move(opts), connection_->options())) {} +ZoneVmExtensionPoliciesClient::~ZoneVmExtensionPoliciesClient() = default; + +future> +ZoneVmExtensionPoliciesClient::DeleteVmExtensionPolicy( + std::string const& project, std::string const& zone, + std::string const& vm_extension_policy, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + DeleteVmExtensionPolicyRequest request; + request.set_project(project); + request.set_zone(zone); + request.set_vm_extension_policy(vm_extension_policy); + return connection_->DeleteVmExtensionPolicy(request); +} + +StatusOr +ZoneVmExtensionPoliciesClient::DeleteVmExtensionPolicy( + NoAwaitTag, std::string const& project, std::string const& zone, + std::string const& vm_extension_policy, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + DeleteVmExtensionPolicyRequest request; + request.set_project(project); + request.set_zone(zone); + request.set_vm_extension_policy(vm_extension_policy); + return connection_->DeleteVmExtensionPolicy(NoAwaitTag{}, request); +} + +future> +ZoneVmExtensionPoliciesClient::DeleteVmExtensionPolicy( + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + DeleteVmExtensionPolicyRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->DeleteVmExtensionPolicy(request); +} + +StatusOr +ZoneVmExtensionPoliciesClient::DeleteVmExtensionPolicy( + NoAwaitTag, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + DeleteVmExtensionPolicyRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->DeleteVmExtensionPolicy(NoAwaitTag{}, request); +} + +future> +ZoneVmExtensionPoliciesClient::DeleteVmExtensionPolicy( + google::cloud::cpp::compute::v1::Operation const& operation, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->DeleteVmExtensionPolicy(operation); +} + +StatusOr +ZoneVmExtensionPoliciesClient::GetVmExtensionPolicy( + std::string const& project, std::string const& zone, + std::string const& vm_extension_policy, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + GetVmExtensionPolicyRequest request; + request.set_project(project); + request.set_zone(zone); + request.set_vm_extension_policy(vm_extension_policy); + return connection_->GetVmExtensionPolicy(request); +} + +StatusOr +ZoneVmExtensionPoliciesClient::GetVmExtensionPolicy( + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + GetVmExtensionPolicyRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->GetVmExtensionPolicy(request); +} + +future> +ZoneVmExtensionPoliciesClient::InsertVmExtensionPolicy( + std::string const& project, std::string const& zone, + google::cloud::cpp::compute::v1::VmExtensionPolicy const& + vm_extension_policy_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + InsertVmExtensionPolicyRequest request; + request.set_project(project); + request.set_zone(zone); + *request.mutable_vm_extension_policy_resource() = + vm_extension_policy_resource; + return connection_->InsertVmExtensionPolicy(request); +} + +StatusOr +ZoneVmExtensionPoliciesClient::InsertVmExtensionPolicy( + NoAwaitTag, std::string const& project, std::string const& zone, + google::cloud::cpp::compute::v1::VmExtensionPolicy const& + vm_extension_policy_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + InsertVmExtensionPolicyRequest request; + request.set_project(project); + request.set_zone(zone); + *request.mutable_vm_extension_policy_resource() = + vm_extension_policy_resource; + return connection_->InsertVmExtensionPolicy(NoAwaitTag{}, request); +} + +future> +ZoneVmExtensionPoliciesClient::InsertVmExtensionPolicy( + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + InsertVmExtensionPolicyRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->InsertVmExtensionPolicy(request); +} + +StatusOr +ZoneVmExtensionPoliciesClient::InsertVmExtensionPolicy( + NoAwaitTag, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + InsertVmExtensionPolicyRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->InsertVmExtensionPolicy(NoAwaitTag{}, request); +} + +future> +ZoneVmExtensionPoliciesClient::InsertVmExtensionPolicy( + google::cloud::cpp::compute::v1::Operation const& operation, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->InsertVmExtensionPolicy(operation); +} + +StreamRange +ZoneVmExtensionPoliciesClient::ListZoneVmExtensionPolicies( + std::string const& project, std::string const& zone, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + ListZoneVmExtensionPoliciesRequest request; + request.set_project(project); + request.set_zone(zone); + return connection_->ListZoneVmExtensionPolicies(request); +} + +StreamRange +ZoneVmExtensionPoliciesClient::ListZoneVmExtensionPolicies( + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + ListZoneVmExtensionPoliciesRequest request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->ListZoneVmExtensionPolicies(std::move(request)); +} + +future> +ZoneVmExtensionPoliciesClient::UpdateVmExtensionPolicy( + std::string const& project, std::string const& zone, + std::string const& vm_extension_policy, + google::cloud::cpp::compute::v1::VmExtensionPolicy const& + vm_extension_policy_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + UpdateVmExtensionPolicyRequest request; + request.set_project(project); + request.set_zone(zone); + request.set_vm_extension_policy(vm_extension_policy); + *request.mutable_vm_extension_policy_resource() = + vm_extension_policy_resource; + return connection_->UpdateVmExtensionPolicy(request); +} + +StatusOr +ZoneVmExtensionPoliciesClient::UpdateVmExtensionPolicy( + NoAwaitTag, std::string const& project, std::string const& zone, + std::string const& vm_extension_policy, + google::cloud::cpp::compute::v1::VmExtensionPolicy const& + vm_extension_policy_resource, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + UpdateVmExtensionPolicyRequest request; + request.set_project(project); + request.set_zone(zone); + request.set_vm_extension_policy(vm_extension_policy); + *request.mutable_vm_extension_policy_resource() = + vm_extension_policy_resource; + return connection_->UpdateVmExtensionPolicy(NoAwaitTag{}, request); +} + +future> +ZoneVmExtensionPoliciesClient::UpdateVmExtensionPolicy( + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + UpdateVmExtensionPolicyRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->UpdateVmExtensionPolicy(request); +} + +StatusOr +ZoneVmExtensionPoliciesClient::UpdateVmExtensionPolicy( + NoAwaitTag, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + UpdateVmExtensionPolicyRequest const& request, + Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->UpdateVmExtensionPolicy(NoAwaitTag{}, request); +} + +future> +ZoneVmExtensionPoliciesClient::UpdateVmExtensionPolicy( + google::cloud::cpp::compute::v1::Operation const& operation, Options opts) { + internal::OptionsSpan span(internal::MergeOptions(std::move(opts), options_)); + return connection_->UpdateVmExtensionPolicy(operation); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_zone_vm_extension_policies_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies_client.h b/google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies_client.h new file mode 100644 index 0000000000000..b468cd0c96238 --- /dev/null +++ b/google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies_client.h @@ -0,0 +1,625 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ZONE_VM_EXTENSION_POLICIES_V1_ZONE_VM_EXTENSION_POLICIES_CLIENT_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ZONE_VM_EXTENSION_POLICIES_V1_ZONE_VM_EXTENSION_POLICIES_CLIENT_H + +#include "google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies_rest_connection.h" +#include "google/cloud/future.h" +#include "google/cloud/no_await_tag.h" +#include "google/cloud/options.h" +#include "google/cloud/polling_policy.h" +#include "google/cloud/status_or.h" +#include "google/cloud/version.h" +#include +#include +#include + +namespace google { +namespace cloud { +namespace compute_zone_vm_extension_policies_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/// +/// Service for the zoneVmExtensionPolicies resource. +/// https://cloud.google.com/compute/docs/reference/rest/v1/zoneVmExtensionPolicies +/// +/// @par Equality +/// +/// Instances of this class created via copy-construction or copy-assignment +/// always compare equal. Instances created with equal +/// `std::shared_ptr<*Connection>` objects compare equal. Objects that compare +/// equal share the same underlying resources. +/// +/// @par Performance +/// +/// Creating a new instance of this class is a relatively expensive operation, +/// new objects establish new connections to the service. In contrast, +/// copy-construction, move-construction, and the corresponding assignment +/// operations are relatively efficient as the copies share all underlying +/// resources. +/// +/// @par Thread Safety +/// +/// Concurrent access to different instances of this class, even if they compare +/// equal, is guaranteed to work. Two or more threads operating on the same +/// instance of this class is not guaranteed to work. Since copy-construction +/// and move-construction is a relatively efficient operation, consider using +/// such a copy when using this class from multiple threads. +/// +class ZoneVmExtensionPoliciesClient { + public: + explicit ZoneVmExtensionPoliciesClient( + std::shared_ptr connection, + Options opts = {}); + ~ZoneVmExtensionPoliciesClient(); + + ///@{ + /// @name Copy and move support + ZoneVmExtensionPoliciesClient(ZoneVmExtensionPoliciesClient const&) = default; + ZoneVmExtensionPoliciesClient& operator=( + ZoneVmExtensionPoliciesClient const&) = default; + ZoneVmExtensionPoliciesClient(ZoneVmExtensionPoliciesClient&&) = default; + ZoneVmExtensionPoliciesClient& operator=(ZoneVmExtensionPoliciesClient&&) = + default; + ///@} + + ///@{ + /// @name Equality + friend bool operator==(ZoneVmExtensionPoliciesClient const& a, + ZoneVmExtensionPoliciesClient const& b) { + return a.connection_ == b.connection_; + } + friend bool operator!=(ZoneVmExtensionPoliciesClient const& a, + ZoneVmExtensionPoliciesClient const& b) { + return !(a == b); + } + ///@} + + // clang-format off + /// + /// Deletes a specified zone VM extension policy within a project. + /// https://cloud.google.com/compute/docs/reference/rest/v1/zoneVmExtensionPolicies/delete + /// + /// @param project Project ID for this request. + /// @param zone Name of the zone for this request. + /// @param vm_extension_policy Name of the zone VM extension policy to delete. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.zone_vm_extension_policies.v1.DeleteVmExtensionPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies.proto#L100} + /// + // clang-format on + future> + DeleteVmExtensionPolicy(std::string const& project, std::string const& zone, + std::string const& vm_extension_policy, + Options opts = {}); + + // clang-format off + /// + /// @copybrief DeleteVmExtensionPolicy + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr DeleteVmExtensionPolicy( + NoAwaitTag, std::string const& project, std::string const& zone, + std::string const& vm_extension_policy, Options opts = {}); + + // clang-format off + /// + /// Deletes a specified zone VM extension policy within a project. + /// https://cloud.google.com/compute/docs/reference/rest/v1/zoneVmExtensionPolicies/delete + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.zone_vm_extension_policies.v1.DeleteVmExtensionPolicyRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.zone_vm_extension_policies.v1.DeleteVmExtensionPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies.proto#L100} + /// + // clang-format on + future> + DeleteVmExtensionPolicy( + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + DeleteVmExtensionPolicyRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief DeleteVmExtensionPolicy + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr DeleteVmExtensionPolicy( + NoAwaitTag, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + DeleteVmExtensionPolicyRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief DeleteVmExtensionPolicy + /// + /// This method accepts a `google::cloud::cpp::compute::v1::Operation` that corresponds + /// to a previously started Long Running Operation (LRO) and polls the status + /// of the LRO in the background. + /// + // clang-format on + future> + DeleteVmExtensionPolicy( + google::cloud::cpp::compute::v1::Operation const& operation, + Options opts = {}); + + // clang-format off + /// + /// Retrieves details of a specific zone VM extension policy within a project. + /// https://cloud.google.com/compute/docs/reference/rest/v1/zoneVmExtensionPolicies/get + /// + /// @param project Project ID for this request. + /// @param zone Name of the zone for this request. + /// @param vm_extension_policy Name of the VM extension policy resource to return. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.VmExtensionPolicy]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.v1.VmExtensionPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_175.proto#L25} + /// [google.cloud.cpp.compute.zone_vm_extension_policies.v1.GetVmExtensionPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies.proto#L136} + /// + // clang-format on + StatusOr + GetVmExtensionPolicy(std::string const& project, std::string const& zone, + std::string const& vm_extension_policy, + Options opts = {}); + + // clang-format off + /// + /// Retrieves details of a specific zone VM extension policy within a project. + /// https://cloud.google.com/compute/docs/reference/rest/v1/zoneVmExtensionPolicies/get + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.zone_vm_extension_policies.v1.GetVmExtensionPolicyRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return the result of the RPC. The response message type + /// ([google.cloud.cpp.compute.v1.VmExtensionPolicy]) + /// is mapped to a C++ class using the [Protobuf mapping rules]. + /// If the request fails, the [`StatusOr`] contains the error details. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.v1.VmExtensionPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_175.proto#L25} + /// [google.cloud.cpp.compute.zone_vm_extension_policies.v1.GetVmExtensionPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies.proto#L136} + /// + // clang-format on + StatusOr + GetVmExtensionPolicy(google::cloud::cpp::compute::zone_vm_extension_policies:: + v1::GetVmExtensionPolicyRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// Creates a new zone-level VM extension policy within a project. + /// https://cloud.google.com/compute/docs/reference/rest/v1/zoneVmExtensionPolicies/insert + /// + /// @param project Project ID for this request. + /// @param zone Name of the zone for this request. + /// @param vm_extension_policy_resource The VmExtensionPolicy for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.zone_vm_extension_policies.v1.InsertVmExtensionPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies.proto#L150} + /// + // clang-format on + future> + InsertVmExtensionPolicy( + std::string const& project, std::string const& zone, + google::cloud::cpp::compute::v1::VmExtensionPolicy const& + vm_extension_policy_resource, + Options opts = {}); + + // clang-format off + /// + /// @copybrief InsertVmExtensionPolicy + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr InsertVmExtensionPolicy( + NoAwaitTag, std::string const& project, std::string const& zone, + google::cloud::cpp::compute::v1::VmExtensionPolicy const& + vm_extension_policy_resource, + Options opts = {}); + + // clang-format off + /// + /// Creates a new zone-level VM extension policy within a project. + /// https://cloud.google.com/compute/docs/reference/rest/v1/zoneVmExtensionPolicies/insert + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.zone_vm_extension_policies.v1.InsertVmExtensionPolicyRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.zone_vm_extension_policies.v1.InsertVmExtensionPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies.proto#L150} + /// + // clang-format on + future> + InsertVmExtensionPolicy( + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + InsertVmExtensionPolicyRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief InsertVmExtensionPolicy + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr InsertVmExtensionPolicy( + NoAwaitTag, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + InsertVmExtensionPolicyRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief InsertVmExtensionPolicy + /// + /// This method accepts a `google::cloud::cpp::compute::v1::Operation` that corresponds + /// to a previously started Long Running Operation (LRO) and polls the status + /// of the LRO in the background. + /// + // clang-format on + future> + InsertVmExtensionPolicy( + google::cloud::cpp::compute::v1::Operation const& operation, + Options opts = {}); + + // clang-format off + /// + /// Lists all VM extension policies within a specific zone for a project. + /// https://cloud.google.com/compute/docs/reference/rest/v1/zoneVmExtensionPolicies/list + /// + /// @param project Project ID for this request. + /// @param zone Name of the zone for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return a [StreamRange](@ref google::cloud::StreamRange) + /// to iterate of the results. See the documentation of this type for + /// details. In brief, this class has `begin()` and `end()` member + /// functions returning a iterator class meeting the + /// [input iterator requirements]. The value type for this iterator is a + /// [`StatusOr`] as the iteration may fail even after some values are + /// retrieved successfully, for example, if there is a network disconnect. + /// An empty set of results does not indicate an error, it indicates + /// that there are no resources meeting the request criteria. + /// On a successful iteration the `StatusOr` contains elements of type + /// [google.cloud.cpp.compute.v1.VmExtensionPolicy], or rather, + /// the C++ class generated by Protobuf from that type. Please consult the + /// Protobuf documentation for details on the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.v1.VmExtensionPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_175.proto#L25} + /// [google.cloud.cpp.compute.zone_vm_extension_policies.v1.ListZoneVmExtensionPoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies.proto#L186} + /// + // clang-format on + StreamRange + ListZoneVmExtensionPolicies(std::string const& project, + std::string const& zone, Options opts = {}); + + // clang-format off + /// + /// Lists all VM extension policies within a specific zone for a project. + /// https://cloud.google.com/compute/docs/reference/rest/v1/zoneVmExtensionPolicies/list + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.zone_vm_extension_policies.v1.ListZoneVmExtensionPoliciesRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return a [StreamRange](@ref google::cloud::StreamRange) + /// to iterate of the results. See the documentation of this type for + /// details. In brief, this class has `begin()` and `end()` member + /// functions returning a iterator class meeting the + /// [input iterator requirements]. The value type for this iterator is a + /// [`StatusOr`] as the iteration may fail even after some values are + /// retrieved successfully, for example, if there is a network disconnect. + /// An empty set of results does not indicate an error, it indicates + /// that there are no resources meeting the request criteria. + /// On a successful iteration the `StatusOr` contains elements of type + /// [google.cloud.cpp.compute.v1.VmExtensionPolicy], or rather, + /// the C++ class generated by Protobuf from that type. Please consult the + /// Protobuf documentation for details on the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.v1.VmExtensionPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_175.proto#L25} + /// [google.cloud.cpp.compute.zone_vm_extension_policies.v1.ListZoneVmExtensionPoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies.proto#L186} + /// + // clang-format on + StreamRange + ListZoneVmExtensionPolicies( + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + ListZoneVmExtensionPoliciesRequest request, + Options opts = {}); + + // clang-format off + /// + /// Modifies an existing zone VM extension policy within a project. + /// https://cloud.google.com/compute/docs/reference/rest/v1/zoneVmExtensionPolicies/update + /// + /// @param project Project ID for this request. + /// @param zone Name of the zone for this request. + /// @param vm_extension_policy Name of the zone VM extension policy to update. + /// @param vm_extension_policy_resource The VmExtensionPolicy for this request. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.zone_vm_extension_policies.v1.UpdateVmExtensionPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies.proto#L290} + /// + // clang-format on + future> + UpdateVmExtensionPolicy( + std::string const& project, std::string const& zone, + std::string const& vm_extension_policy, + google::cloud::cpp::compute::v1::VmExtensionPolicy const& + vm_extension_policy_resource, + Options opts = {}); + + // clang-format off + /// + /// @copybrief UpdateVmExtensionPolicy + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr UpdateVmExtensionPolicy( + NoAwaitTag, std::string const& project, std::string const& zone, + std::string const& vm_extension_policy, + google::cloud::cpp::compute::v1::VmExtensionPolicy const& + vm_extension_policy_resource, + Options opts = {}); + + // clang-format off + /// + /// Modifies an existing zone VM extension policy within a project. + /// https://cloud.google.com/compute/docs/reference/rest/v1/zoneVmExtensionPolicies/update + /// + /// @param request Unary RPCs, such as the one wrapped by this + /// function, receive a single `request` proto message which includes all + /// the inputs for the RPC. In this case, the proto message is a + /// [google.cloud.cpp.compute.zone_vm_extension_policies.v1.UpdateVmExtensionPolicyRequest]. + /// Proto messages are converted to C++ classes by Protobuf, using the + /// [Protobuf mapping rules]. + /// @param opts Optional. Override the class-level options, such as retry and + /// backoff policies. + /// @return A [`future`] that becomes satisfied when the LRO + /// ([Long Running Operation]) completes or the polling policy in effect + /// for this call is exhausted. The future is satisfied with an error if + /// the LRO completes with an error or the polling policy is exhausted. + /// In this case the [`StatusOr`] returned by the future contains the + /// error. If the LRO completes successfully the value of the future + /// contains the LRO's result. For this RPC the result is a + /// [google.cloud.cpp.compute.v1.Operation] proto message. + /// The C++ class representing this message is created by Protobuf, using + /// the [Protobuf mapping rules]. + /// + /// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/ + /// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator + /// [Long Running Operation]: http://cloud/compute/docs/api/how-tos/api-requests-responses#handling_api_responses + /// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string + /// [`future`]: @ref google::cloud::future + /// [`StatusOr`]: @ref google::cloud::StatusOr + /// [`Status`]: @ref google::cloud::Status + /// [google.cloud.cpp.compute.zone_vm_extension_policies.v1.UpdateVmExtensionPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies.proto#L290} + /// + // clang-format on + future> + UpdateVmExtensionPolicy( + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + UpdateVmExtensionPolicyRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief UpdateVmExtensionPolicy + /// + /// Specifying the [`NoAwaitTag`] immediately returns the + /// [`google::cloud::cpp::compute::v1::Operation`] that corresponds to the Long Running + /// Operation that has been started. No polling for operation status occurs. + /// + /// [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag + /// + // clang-format on + StatusOr UpdateVmExtensionPolicy( + NoAwaitTag, + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + UpdateVmExtensionPolicyRequest const& request, + Options opts = {}); + + // clang-format off + /// + /// @copybrief UpdateVmExtensionPolicy + /// + /// This method accepts a `google::cloud::cpp::compute::v1::Operation` that corresponds + /// to a previously started Long Running Operation (LRO) and polls the status + /// of the LRO in the background. + /// + // clang-format on + future> + UpdateVmExtensionPolicy( + google::cloud::cpp::compute::v1::Operation const& operation, + Options opts = {}); + + private: + std::shared_ptr connection_; + Options options_; +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_zone_vm_extension_policies_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ZONE_VM_EXTENSION_POLICIES_V1_ZONE_VM_EXTENSION_POLICIES_CLIENT_H diff --git a/google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies_connection.cc b/google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies_connection.cc new file mode 100644 index 0000000000000..07583392f6c6d --- /dev/null +++ b/google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies_connection.cc @@ -0,0 +1,134 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies.proto + +#include "google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies_connection.h" +#include "google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_option_defaults.h" +#include "google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_tracing_connection.h" +#include "google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies_options.h" +#include "google/cloud/background_threads.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/grpc_options.h" +#include "google/cloud/internal/pagination_range.h" +#include "google/cloud/internal/unified_grpc_credentials.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_zone_vm_extension_policies_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +ZoneVmExtensionPoliciesConnection::~ZoneVmExtensionPoliciesConnection() = + default; + +future> +ZoneVmExtensionPoliciesConnection::DeleteVmExtensionPolicy( + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + DeleteVmExtensionPolicyRequest const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +ZoneVmExtensionPoliciesConnection::DeleteVmExtensionPolicy( + NoAwaitTag, google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + DeleteVmExtensionPolicyRequest const&) { + return StatusOr( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +ZoneVmExtensionPoliciesConnection::DeleteVmExtensionPolicy( + google::cloud::cpp::compute::v1::Operation const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +ZoneVmExtensionPoliciesConnection::GetVmExtensionPolicy( + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + GetVmExtensionPolicyRequest const&) { + return Status(StatusCode::kUnimplemented, "not implemented"); +} + +future> +ZoneVmExtensionPoliciesConnection::InsertVmExtensionPolicy( + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + InsertVmExtensionPolicyRequest const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +ZoneVmExtensionPoliciesConnection::InsertVmExtensionPolicy( + NoAwaitTag, google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + InsertVmExtensionPolicyRequest const&) { + return StatusOr( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +ZoneVmExtensionPoliciesConnection::InsertVmExtensionPolicy( + google::cloud::cpp::compute::v1::Operation const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StreamRange +ZoneVmExtensionPoliciesConnection::ListZoneVmExtensionPolicies( + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + ListZoneVmExtensionPoliciesRequest) { // NOLINT(performance-unnecessary-value-param) + return google::cloud::internal::MakeUnimplementedPaginationRange< + StreamRange>(); +} + +future> +ZoneVmExtensionPoliciesConnection::UpdateVmExtensionPolicy( + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + UpdateVmExtensionPolicyRequest const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +StatusOr +ZoneVmExtensionPoliciesConnection::UpdateVmExtensionPolicy( + NoAwaitTag, google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + UpdateVmExtensionPolicyRequest const&) { + return StatusOr( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +future> +ZoneVmExtensionPoliciesConnection::UpdateVmExtensionPolicy( + google::cloud::cpp::compute::v1::Operation const&) { + return google::cloud::make_ready_future< + StatusOr>( + Status(StatusCode::kUnimplemented, "not implemented")); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_zone_vm_extension_policies_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies_connection.h b/google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies_connection.h new file mode 100644 index 0000000000000..f2b57a6083e55 --- /dev/null +++ b/google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies_connection.h @@ -0,0 +1,256 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ZONE_VM_EXTENSION_POLICIES_V1_ZONE_VM_EXTENSION_POLICIES_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ZONE_VM_EXTENSION_POLICIES_V1_ZONE_VM_EXTENSION_POLICIES_CONNECTION_H + +#include "google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_retry_traits.h" +#include "google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies.pb.h" +#include "google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies_connection_idempotency_policy.h" +#include "google/cloud/backoff_policy.h" +#include "google/cloud/future.h" +#include "google/cloud/internal/retry_policy_impl.h" +#include "google/cloud/no_await_tag.h" +#include "google/cloud/options.h" +#include "google/cloud/polling_policy.h" +#include "google/cloud/status_or.h" +#include "google/cloud/stream_range.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_zone_vm_extension_policies_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/// The retry policy for `ZoneVmExtensionPoliciesConnection`. +class ZoneVmExtensionPoliciesRetryPolicy : public ::google::cloud::RetryPolicy { + public: + /// Creates a new instance of the policy, reset to the initial state. + virtual std::unique_ptr clone() const = 0; +}; + +/** + * A retry policy for `ZoneVmExtensionPoliciesConnection` based on counting + * errors. + * + * This policy stops retrying if: + * - An RPC returns a non-transient error. + * - More than a prescribed number of transient failures is detected. + * + * In this class the following status codes are treated as transient errors: + * - [`kUnavailable`](@ref google::cloud::StatusCode) + */ +class ZoneVmExtensionPoliciesLimitedErrorCountRetryPolicy + : public ZoneVmExtensionPoliciesRetryPolicy { + public: + /** + * Create an instance that tolerates up to @p maximum_failures transient + * errors. + * + * @note Disable the retry loop by providing an instance of this policy with + * @p maximum_failures == 0. + */ + explicit ZoneVmExtensionPoliciesLimitedErrorCountRetryPolicy( + int maximum_failures) + : impl_(maximum_failures) {} + + ZoneVmExtensionPoliciesLimitedErrorCountRetryPolicy( + ZoneVmExtensionPoliciesLimitedErrorCountRetryPolicy&& rhs) noexcept + : ZoneVmExtensionPoliciesLimitedErrorCountRetryPolicy( + rhs.maximum_failures()) {} + ZoneVmExtensionPoliciesLimitedErrorCountRetryPolicy( + ZoneVmExtensionPoliciesLimitedErrorCountRetryPolicy const& rhs) noexcept + : ZoneVmExtensionPoliciesLimitedErrorCountRetryPolicy( + rhs.maximum_failures()) {} + + int maximum_failures() const { return impl_.maximum_failures(); } + + bool OnFailure(Status const& status) override { + return impl_.OnFailure(status); + } + bool IsExhausted() const override { return impl_.IsExhausted(); } + bool IsPermanentFailure(Status const& status) const override { + return impl_.IsPermanentFailure(status); + } + std::unique_ptr clone() const override { + return std::make_unique< + ZoneVmExtensionPoliciesLimitedErrorCountRetryPolicy>( + maximum_failures()); + } + + // This is provided only for backwards compatibility. + using BaseType = ZoneVmExtensionPoliciesRetryPolicy; + + private: + google::cloud::internal::LimitedErrorCountRetryPolicy< + compute_zone_vm_extension_policies_v1_internal:: + ZoneVmExtensionPoliciesRetryTraits> + impl_; +}; + +/** + * A retry policy for `ZoneVmExtensionPoliciesConnection` based on elapsed time. + * + * This policy stops retrying if: + * - An RPC returns a non-transient error. + * - The elapsed time in the retry loop exceeds a prescribed duration. + * + * In this class the following status codes are treated as transient errors: + * - [`kUnavailable`](@ref google::cloud::StatusCode) + */ +class ZoneVmExtensionPoliciesLimitedTimeRetryPolicy + : public ZoneVmExtensionPoliciesRetryPolicy { + public: + /** + * Constructor given a `std::chrono::duration<>` object. + * + * @tparam DurationRep a placeholder to match the `Rep` tparam for @p + * duration's type. The semantics of this template parameter are + * documented in `std::chrono::duration<>`. In brief, the underlying + * arithmetic type used to store the number of ticks. For our purposes it + * is simply a formal parameter. + * @tparam DurationPeriod a placeholder to match the `Period` tparam for @p + * duration's type. The semantics of this template parameter are + * documented in `std::chrono::duration<>`. In brief, the length of the + * tick in seconds, expressed as a `std::ratio<>`. For our purposes it is + * simply a formal parameter. + * @param maximum_duration the maximum time allowed before the policy expires. + * While the application can express this time in any units they desire, + * the class truncates to milliseconds. + * + * @see https://en.cppreference.com/w/cpp/chrono/duration for more information + * about `std::chrono::duration`. + */ + template + explicit ZoneVmExtensionPoliciesLimitedTimeRetryPolicy( + std::chrono::duration maximum_duration) + : impl_(maximum_duration) {} + + ZoneVmExtensionPoliciesLimitedTimeRetryPolicy( + ZoneVmExtensionPoliciesLimitedTimeRetryPolicy&& rhs) noexcept + : ZoneVmExtensionPoliciesLimitedTimeRetryPolicy(rhs.maximum_duration()) {} + ZoneVmExtensionPoliciesLimitedTimeRetryPolicy( + ZoneVmExtensionPoliciesLimitedTimeRetryPolicy const& rhs) noexcept + : ZoneVmExtensionPoliciesLimitedTimeRetryPolicy(rhs.maximum_duration()) {} + + std::chrono::milliseconds maximum_duration() const { + return impl_.maximum_duration(); + } + + bool OnFailure(Status const& status) override { + return impl_.OnFailure(status); + } + bool IsExhausted() const override { return impl_.IsExhausted(); } + bool IsPermanentFailure(Status const& status) const override { + return impl_.IsPermanentFailure(status); + } + std::unique_ptr clone() const override { + return std::make_unique( + maximum_duration()); + } + + // This is provided only for backwards compatibility. + using BaseType = ZoneVmExtensionPoliciesRetryPolicy; + + private: + google::cloud::internal::LimitedTimeRetryPolicy< + compute_zone_vm_extension_policies_v1_internal:: + ZoneVmExtensionPoliciesRetryTraits> + impl_; +}; + +/** + * The `ZoneVmExtensionPoliciesConnection` object for + * `ZoneVmExtensionPoliciesClient`. + * + * This interface defines virtual methods for each of the user-facing overload + * sets in `ZoneVmExtensionPoliciesClient`. This allows users to inject custom + * behavior (e.g., with a Google Mock object) when writing tests that use + * objects of type `ZoneVmExtensionPoliciesClient`. + * + * To create a concrete instance, see `MakeZoneVmExtensionPoliciesConnection()`. + * + * For mocking, see + * `compute_zone_vm_extension_policies_v1_mocks::MockZoneVmExtensionPoliciesConnection`. + */ +class ZoneVmExtensionPoliciesConnection { + public: + virtual ~ZoneVmExtensionPoliciesConnection() = 0; + + virtual Options options() { return Options{}; } + + virtual future> + DeleteVmExtensionPolicy( + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + DeleteVmExtensionPolicyRequest const& request); + + virtual StatusOr + DeleteVmExtensionPolicy( + NoAwaitTag, google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + DeleteVmExtensionPolicyRequest const& request); + + virtual future> + DeleteVmExtensionPolicy( + google::cloud::cpp::compute::v1::Operation const& operation); + + virtual StatusOr + GetVmExtensionPolicy(google::cloud::cpp::compute::zone_vm_extension_policies:: + v1::GetVmExtensionPolicyRequest const& request); + + virtual future> + InsertVmExtensionPolicy( + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + InsertVmExtensionPolicyRequest const& request); + + virtual StatusOr + InsertVmExtensionPolicy( + NoAwaitTag, google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + InsertVmExtensionPolicyRequest const& request); + + virtual future> + InsertVmExtensionPolicy( + google::cloud::cpp::compute::v1::Operation const& operation); + + virtual StreamRange + ListZoneVmExtensionPolicies( + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + ListZoneVmExtensionPoliciesRequest request); + + virtual future> + UpdateVmExtensionPolicy( + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + UpdateVmExtensionPolicyRequest const& request); + + virtual StatusOr + UpdateVmExtensionPolicy( + NoAwaitTag, google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + UpdateVmExtensionPolicyRequest const& request); + + virtual future> + UpdateVmExtensionPolicy( + google::cloud::cpp::compute::v1::Operation const& operation); +}; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_zone_vm_extension_policies_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ZONE_VM_EXTENSION_POLICIES_V1_ZONE_VM_EXTENSION_POLICIES_CONNECTION_H diff --git a/google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies_connection_idempotency_policy.cc b/google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies_connection_idempotency_policy.cc new file mode 100644 index 0000000000000..738613adbf14f --- /dev/null +++ b/google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies_connection_idempotency_policy.cc @@ -0,0 +1,82 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies.proto + +#include "google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies_connection_idempotency_policy.h" +#include + +namespace google { +namespace cloud { +namespace compute_zone_vm_extension_policies_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +using ::google::cloud::Idempotency; + +ZoneVmExtensionPoliciesConnectionIdempotencyPolicy:: + ~ZoneVmExtensionPoliciesConnectionIdempotencyPolicy() = default; + +std::unique_ptr +ZoneVmExtensionPoliciesConnectionIdempotencyPolicy::clone() const { + return std::make_unique( + *this); +} + +Idempotency +ZoneVmExtensionPoliciesConnectionIdempotencyPolicy::DeleteVmExtensionPolicy( + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + DeleteVmExtensionPolicyRequest const&) { + return Idempotency::kNonIdempotent; +} + +Idempotency +ZoneVmExtensionPoliciesConnectionIdempotencyPolicy::GetVmExtensionPolicy( + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + GetVmExtensionPolicyRequest const&) { + return Idempotency::kIdempotent; +} + +Idempotency +ZoneVmExtensionPoliciesConnectionIdempotencyPolicy::InsertVmExtensionPolicy( + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + InsertVmExtensionPolicyRequest const&) { + return Idempotency::kNonIdempotent; +} + +Idempotency +ZoneVmExtensionPoliciesConnectionIdempotencyPolicy::ListZoneVmExtensionPolicies( + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + ListZoneVmExtensionPoliciesRequest) { // NOLINT + return Idempotency::kIdempotent; +} + +Idempotency +ZoneVmExtensionPoliciesConnectionIdempotencyPolicy::UpdateVmExtensionPolicy( + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + UpdateVmExtensionPolicyRequest const&) { + return Idempotency::kNonIdempotent; +} + +std::unique_ptr +MakeDefaultZoneVmExtensionPoliciesConnectionIdempotencyPolicy() { + return std::make_unique(); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_zone_vm_extension_policies_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies_connection_idempotency_policy.h b/google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies_connection_idempotency_policy.h new file mode 100644 index 0000000000000..68582c5aba4ed --- /dev/null +++ b/google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies_connection_idempotency_policy.h @@ -0,0 +1,70 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ZONE_VM_EXTENSION_POLICIES_V1_ZONE_VM_EXTENSION_POLICIES_CONNECTION_IDEMPOTENCY_POLICY_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ZONE_VM_EXTENSION_POLICIES_V1_ZONE_VM_EXTENSION_POLICIES_CONNECTION_IDEMPOTENCY_POLICY_H + +#include "google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies.pb.h" +#include "google/cloud/idempotency.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_zone_vm_extension_policies_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +class ZoneVmExtensionPoliciesConnectionIdempotencyPolicy { + public: + virtual ~ZoneVmExtensionPoliciesConnectionIdempotencyPolicy(); + + /// Create a new copy of this object. + virtual std::unique_ptr + clone() const; + + virtual google::cloud::Idempotency DeleteVmExtensionPolicy( + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + DeleteVmExtensionPolicyRequest const& request); + + virtual google::cloud::Idempotency GetVmExtensionPolicy( + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + GetVmExtensionPolicyRequest const& request); + + virtual google::cloud::Idempotency InsertVmExtensionPolicy( + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + InsertVmExtensionPolicyRequest const& request); + + virtual google::cloud::Idempotency ListZoneVmExtensionPolicies( + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + ListZoneVmExtensionPoliciesRequest request); + + virtual google::cloud::Idempotency UpdateVmExtensionPolicy( + google::cloud::cpp::compute::zone_vm_extension_policies::v1:: + UpdateVmExtensionPolicyRequest const& request); +}; + +std::unique_ptr +MakeDefaultZoneVmExtensionPoliciesConnectionIdempotencyPolicy(); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_zone_vm_extension_policies_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ZONE_VM_EXTENSION_POLICIES_V1_ZONE_VM_EXTENSION_POLICIES_CONNECTION_IDEMPOTENCY_POLICY_H diff --git a/google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies_options.h b/google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies_options.h new file mode 100644 index 0000000000000..7c9c27d2879b3 --- /dev/null +++ b/google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies_options.h @@ -0,0 +1,89 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ZONE_VM_EXTENSION_POLICIES_V1_ZONE_VM_EXTENSION_POLICIES_OPTIONS_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ZONE_VM_EXTENSION_POLICIES_V1_ZONE_VM_EXTENSION_POLICIES_OPTIONS_H + +#include "google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies_connection.h" +#include "google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies_connection_idempotency_policy.h" +#include "google/cloud/backoff_policy.h" +#include "google/cloud/options.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_zone_vm_extension_policies_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/** + * Use with `google::cloud::Options` to configure the retry policy. + * + * @ingroup google-cloud-compute-options + */ +struct ZoneVmExtensionPoliciesRetryPolicyOption { + using Type = std::shared_ptr; +}; + +/** + * Use with `google::cloud::Options` to configure the backoff policy. + * + * @ingroup google-cloud-compute-options + */ +struct ZoneVmExtensionPoliciesBackoffPolicyOption { + using Type = std::shared_ptr; +}; + +/** + * Use with `google::cloud::Options` to configure which operations are retried. + * + * @ingroup google-cloud-compute-options + */ +struct ZoneVmExtensionPoliciesConnectionIdempotencyPolicyOption { + using Type = + std::shared_ptr; +}; + +/** + * Use with `google::cloud::Options` to configure the long-running operations + * polling policy. + * + * @ingroup google-cloud-compute-options + */ +struct ZoneVmExtensionPoliciesPollingPolicyOption { + using Type = std::shared_ptr; +}; + +/** + * The options applicable to ZoneVmExtensionPolicies. + * + * @ingroup google-cloud-compute-options + */ +using ZoneVmExtensionPoliciesPolicyOptionList = + OptionList; + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_zone_vm_extension_policies_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ZONE_VM_EXTENSION_POLICIES_V1_ZONE_VM_EXTENSION_POLICIES_OPTIONS_H diff --git a/google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies_proto_export.h b/google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies_proto_export.h new file mode 100644 index 0000000000000..b6f52e4fb5e40 --- /dev/null +++ b/google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies_proto_export.h @@ -0,0 +1,34 @@ +// Copyright 2026 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_ZONE_VM_EXTENSION_POLICIES_V1_ZONE_VM_EXTENSION_POLICIES_PROTO_EXPORT_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ZONE_VM_EXTENSION_POLICIES_V1_ZONE_VM_EXTENSION_POLICIES_PROTO_EXPORT_H + +// IWYU pragma: begin_exports +#include "google/cloud/compute/v1/internal/common_019.pb.h" +#include "google/cloud/compute/v1/internal/common_175.pb.h" +#include "google/cloud/compute/v1/internal/common_176.pb.h" +// IWYU pragma: end_exports + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ZONE_VM_EXTENSION_POLICIES_V1_ZONE_VM_EXTENSION_POLICIES_PROTO_EXPORT_H diff --git a/google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies_rest_connection.cc b/google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies_rest_connection.cc new file mode 100644 index 0000000000000..1836d100581e7 --- /dev/null +++ b/google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies_rest_connection.cc @@ -0,0 +1,61 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies.proto + +#include "google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies_rest_connection.h" +#include "google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_option_defaults.h" +#include "google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_rest_connection_impl.h" +#include "google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_rest_stub_factory.h" +#include "google/cloud/compute/zone_vm_extension_policies/v1/internal/zone_vm_extension_policies_tracing_connection.h" +#include "google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies_options.h" +#include "google/cloud/common_options.h" +#include "google/cloud/credentials.h" +#include "google/cloud/internal/rest_background_threads_impl.h" +#include "google/cloud/internal/rest_options.h" +#include +#include + +namespace google { +namespace cloud { +namespace compute_zone_vm_extension_policies_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +std::shared_ptr +MakeZoneVmExtensionPoliciesConnectionRest(Options options) { + internal::CheckExpectedOptions( + options, __func__); + options = compute_zone_vm_extension_policies_v1_internal:: + ZoneVmExtensionPoliciesDefaultOptions(std::move(options)); + auto background = std::make_unique< + rest_internal::AutomaticallyCreatedRestBackgroundThreads>(); + auto stub = compute_zone_vm_extension_policies_v1_internal:: + CreateDefaultZoneVmExtensionPoliciesRestStub(options); + return compute_zone_vm_extension_policies_v1_internal:: + MakeZoneVmExtensionPoliciesTracingConnection( + std::make_shared( + std::move(background), std::move(stub), std::move(options))); +} + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_zone_vm_extension_policies_v1 +} // namespace cloud +} // namespace google diff --git a/google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies_rest_connection.h b/google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies_rest_connection.h new file mode 100644 index 0000000000000..31dec767ffe9d --- /dev/null +++ b/google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies_rest_connection.h @@ -0,0 +1,67 @@ +// Copyright 2026 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. +// source: +// google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies.proto + +#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ZONE_VM_EXTENSION_POLICIES_V1_ZONE_VM_EXTENSION_POLICIES_REST_CONNECTION_H +#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ZONE_VM_EXTENSION_POLICIES_V1_ZONE_VM_EXTENSION_POLICIES_REST_CONNECTION_H + +#include "google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies_connection.h" +#include "google/cloud/options.h" +#include "google/cloud/version.h" +#include + +namespace google { +namespace cloud { +namespace compute_zone_vm_extension_policies_v1 { +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN + +/** + * A factory function to construct an object of type + * `ZoneVmExtensionPoliciesConnection` that uses REST over HTTP as transport in + * lieu of gRPC. REST transport should only be used for services that do not + * support gRPC or if the existing network configuration precludes using gRPC. + * + * The returned connection object should not be used directly; instead it + * should be passed as an argument to the constructor of + * ZoneVmExtensionPoliciesClient. + * + * The optional @p options argument may be used to configure aspects of the + * returned `ZoneVmExtensionPoliciesConnection`. Expected options are any of the + * types in the following option lists: + * + * - `google::cloud::CommonOptionList` + * - `google::cloud::RestOptionList` + * - `google::cloud::UnifiedCredentialsOptionList` + * - + * `google::cloud::compute_zone_vm_extension_policies_v1::ZoneVmExtensionPoliciesPolicyOptionList` + * + * @note Unexpected options will be ignored. To log unexpected options instead, + * set `GOOGLE_CLOUD_CPP_ENABLE_CLOG=yes` in the environment. + * + * @param options (optional) Configure the `ZoneVmExtensionPoliciesConnection` + * created by this function. + */ +std::shared_ptr +MakeZoneVmExtensionPoliciesConnectionRest(Options options = {}); + +GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END +} // namespace compute_zone_vm_extension_policies_v1 +} // namespace cloud +} // namespace google + +#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ZONE_VM_EXTENSION_POLICIES_V1_ZONE_VM_EXTENSION_POLICIES_REST_CONNECTION_H diff --git a/google/cloud/compute/zones/v1/zones_client.h b/google/cloud/compute/zones/v1/zones_client.h index 5cacfbecccc68..6dd3a40ecd962 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_150.proto#L29} + /// [google.cloud.cpp.compute.v1.Zone]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_031.proto#L140} /// [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_150.proto#L29} + /// [google.cloud.cpp.compute.v1.Zone]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_031.proto#L140} /// [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_150.proto#L29} + /// [google.cloud.cpp.compute.v1.Zone]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_031.proto#L140} /// [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_150.proto#L29} + /// [google.cloud.cpp.compute.v1.Zone]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_031.proto#L140} /// [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 be0f981cd6a7b..4088436f56a78 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 "google/cloud/compute/v1/internal/common_023.pb.h" -#include "google/cloud/compute/v1/internal/common_150.pb.h" +#include "google/cloud/compute/v1/internal/common_031.pb.h" +#include "google/cloud/compute/v1/internal/common_032.pb.h" // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ZONES_V1_ZONES_PROTO_EXPORT_H diff --git a/google/cloud/internal/rest_stub_helpers.h b/google/cloud/internal/rest_stub_helpers.h index 5cb5338e7051e..49a344d87bd69 100644 --- a/google/cloud/internal/rest_stub_helpers.h +++ b/google/cloud/internal/rest_stub_helpers.h @@ -88,7 +88,9 @@ StatusOr Delete( return RestResponseToProto(std::move(**response)); } -template +template ::value, + int> = 0> StatusOr Get( rest_internal::RestClient& client, rest_internal::RestContext& rest_context, Request const&, bool, std::string path, @@ -100,6 +102,20 @@ StatusOr Get( return RestResponseToProto(std::move(**response)); } +template < + typename Response, typename Request, + std::enable_if_t::value, int> = 0> +Status Get(rest_internal::RestClient& client, + rest_internal::RestContext& rest_context, Request const&, bool, + std::string path, + std::vector> query_params = {}) { + auto rest_request = + CreateRestRequest(std::move(path), std::move(query_params)); + auto response = client.Get(rest_context, rest_request); + if (!response.ok()) return response.status(); + return Status(); +} + template StatusOr Patch( rest_internal::RestClient& client, rest_internal::RestContext& rest_context, 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 4b40c5cf95844..6821ccf678372 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: 20250601 +// revision: 20260807 syntax = "proto3"; @@ -24,7 +24,7 @@ package google.cloud.cpp.compute.accelerator_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_002.proto"; +import "google/cloud/compute/v1/internal/common_003.proto"; // Service for the acceleratorTypes resource. // https://cloud.google.com/compute/docs/reference/rest/v1/acceleratorTypes @@ -35,9 +35,10 @@ service AcceleratorTypes { "https://www.googleapis.com/auth/compute," "https://www.googleapis.com/auth/compute.readonly"; - // Retrieves an aggregated list of accelerator types. To prevent failure, - // Google recommends that you set the `returnPartialSuccess` parameter to - // `true`. + // Retrieves an aggregated list of accelerator types. + // + // To prevent failure, it is recommended that you set the + // `returnPartialSuccess` parameter to `true`. // https://cloud.google.com/compute/docs/reference/rest/v1/acceleratorTypes/aggregatedList rpc AggregatedListAcceleratorTypes(AggregatedListAcceleratorTypesRequest) returns (google.cloud.cpp.compute.v1.AcceleratorTypeAggregatedList) { @@ -72,37 +73,64 @@ service AcceleratorTypes { // Request message for AggregatedListAcceleratorTypes. message AggregatedListAcceleratorTypesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; // Indicates whether every visible scope for each scope type (zone, region, @@ -114,25 +142,29 @@ message AggregatedListAcceleratorTypesRequest { // will be included. optional bool include_all_scopes = 2 [json_name = "includeAllScopes"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 3 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 4 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 5 [json_name = "pageToken"]; // Project ID for this request. @@ -140,9 +172,11 @@ message AggregatedListAcceleratorTypesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; // The Shared VPC service project id or service project number for which @@ -168,58 +202,89 @@ message GetAcceleratorTypeRequest { // Request message for ListAcceleratorTypes. message ListAcceleratorTypesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -227,9 +292,11 @@ message ListAcceleratorTypesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 6 [json_name = "returnPartialSuccess"]; // The name of the zone for this request. diff --git a/protos/google/cloud/compute/addresses/v1/addresses.proto b/protos/google/cloud/compute/addresses/v1/addresses.proto index e19f409667cfe..b22feaf216a66 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: 20250601 +// revision: 20260807 syntax = "proto3"; @@ -24,10 +24,11 @@ package google.cloud.cpp.compute.addresses.v1; 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_005.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_006.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_125.proto"; +import "google/cloud/compute/v1/internal/common_171.proto"; import "google/cloud/extended_operations.proto"; // Service for the addresses resource. @@ -39,8 +40,10 @@ service Addresses { "https://www.googleapis.com/auth/compute," "https://www.googleapis.com/auth/compute.readonly"; - // Retrieves an aggregated list of addresses. To prevent failure, Google - // recommends that you set the `returnPartialSuccess` parameter to `true`. + // Retrieves an aggregated list of addresses. + // + // To prevent failure, it is recommended that you set the + // `returnPartialSuccess` parameter to `true`. // https://cloud.google.com/compute/docs/reference/rest/v1/addresses/aggregatedList rpc AggregatedListAddresses(AggregatedListAddressesRequest) returns (google.cloud.cpp.compute.v1.AddressAggregatedList) { @@ -84,7 +87,8 @@ service Addresses { option (google.cloud.operation_service) = "RegionOperations"; } - // Retrieves a list of addresses contained within the specified region. + // Retrieves a list of addresses contained within + // the specified region. // https://cloud.google.com/compute/docs/reference/rest/v1/addresses/list rpc ListAddresses(ListAddressesRequest) returns (google.cloud.cpp.compute.v1.AddressList) { @@ -106,8 +110,8 @@ service Addresses { option (google.cloud.operation_service) = "RegionOperations"; } - // Sets the labels on an Address. To learn more about labels, read the - // Labeling Resources documentation. + // Sets the labels on an Address. To learn more about labels, read theLabeling + // Resources documentation. // https://cloud.google.com/compute/docs/reference/rest/v1/addresses/setLabels rpc SetLabels(SetLabelsRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -119,42 +123,81 @@ service Addresses { "project,region,resource,region_set_labels_request_resource"; option (google.cloud.operation_service) = "RegionOperations"; } + + // Returns permissions that a caller has on the specified resource. + // https://cloud.google.com/compute/docs/reference/rest/v1/addresses/testIamPermissions + rpc TestIamPermissions(TestIamPermissionsRequest) + returns (google.cloud.cpp.compute.v1.TestPermissionsResponse) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/regions/{region}/addresses/{resource}/testIamPermissions" + body: "test_permissions_request_resource" + }; + option (google.api.method_signature) = + "project,region,resource,test_permissions_request_resource"; + } } // Request message for AggregatedListAddresses. message AggregatedListAddressesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; // Indicates whether every visible scope for each scope type (zone, region, @@ -166,25 +209,29 @@ message AggregatedListAddressesRequest { // will be included. optional bool include_all_scopes = 2 [json_name = "includeAllScopes"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 3 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 4 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 5 [json_name = "pageToken"]; // Project ID for this request. @@ -192,9 +239,11 @@ message AggregatedListAddressesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; // The Shared VPC service project id or service project number for which @@ -225,14 +274,17 @@ message DeleteAddressRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; } @@ -273,72 +325,106 @@ message InsertAddressRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; } // Request message for ListAddresses. message ListAddressesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -350,9 +436,11 @@ message ListAddressesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "region"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; } @@ -383,14 +471,17 @@ message MoveRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 5 [json_name = "requestId"]; } @@ -417,17 +508,39 @@ message SetLabelsRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; // Name or id of the resource for this request. string resource = 5 [(google.api.field_behavior) = REQUIRED, json_name = "resource"]; } + +// Request message for TestIamPermissions. +message TestIamPermissionsRequest { + // Project ID for this request. + string project = 1 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // The name of the region for this request. + string region = 2 + [(google.api.field_behavior) = REQUIRED, json_name = "region"]; + + // Name or id of the resource for this request. + string resource = 3 + [(google.api.field_behavior) = REQUIRED, json_name = "resource"]; + + // The TestPermissionsRequest for this request. + optional google.cloud.cpp.compute.v1.TestPermissionsRequest + test_permissions_request_resource = 4 [json_name = "__json_request_body"]; +} diff --git a/protos/google/cloud/compute/advice/v1/advice.proto b/protos/google/cloud/compute/advice/v1/advice.proto new file mode 100644 index 0000000000000..cc2a1b0df3726 --- /dev/null +++ b/protos/google/cloud/compute/advice/v1/advice.proto @@ -0,0 +1,67 @@ +// Copyright 2026 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: 20260807 + +syntax = "proto3"; + +package google.cloud.cpp.compute.advice.v1; + +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/cloud/compute/v1/internal/common_024.proto"; + +// Service for the advice resource. +// https://cloud.google.com/compute/docs/reference/rest/v1/advice +service Advice { + option (google.api.default_host) = "compute.googleapis.com"; + option (google.api.oauth_scopes) = + "https://www.googleapis.com/auth/cloud-platform," + "https://www.googleapis.com/auth/compute"; + + // Advise how, where and when to create the requested amount of instances + // with specified accelerators, within the specified time and location limits. + // The method recommends creating future reservations for the requested + // resources. + // https://cloud.google.com/compute/docs/reference/rest/v1/advice/calendarMode + rpc CalendarMode(CalendarModeRequest) + returns (google.cloud.cpp.compute.v1.CalendarModeAdviceResponse) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/regions/{region}/advice/calendarMode" + body: "calendar_mode_advice_request_resource" + }; + option (google.api.method_signature) = + "project,region,calendar_mode_advice_request_resource"; + } +} + +// Request message for CalendarMode. +message CalendarModeRequest { + // The CalendarModeAdviceRequest for this request. + optional google.cloud.cpp.compute.v1.CalendarModeAdviceRequest + calendar_mode_advice_request_resource = 1 + [json_name = "__json_request_body"]; + + // Project ID for this request. + string project = 2 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // Name of the region for this request. + string region = 3 + [(google.api.field_behavior) = REQUIRED, json_name = "region"]; +} diff --git a/protos/google/cloud/compute/autoscalers/v1/autoscalers.proto b/protos/google/cloud/compute/autoscalers/v1/autoscalers.proto index a7b1f509ba4f9..6ac2161168331 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: 20250601 +// revision: 20260807 syntax = "proto3"; @@ -24,9 +24,10 @@ 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_016.proto"; +import "google/cloud/compute/v1/internal/common_010.proto"; +import "google/cloud/compute/v1/internal/common_011.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_171.proto"; import "google/cloud/extended_operations.proto"; // Service for the autoscalers resource. @@ -38,8 +39,10 @@ service Autoscalers { "https://www.googleapis.com/auth/compute," "https://www.googleapis.com/auth/compute.readonly"; - // Retrieves an aggregated list of autoscalers. To prevent failure, Google - // recommends that you set the `returnPartialSuccess` parameter to `true`. + // Retrieves an aggregated list of autoscalers. + // + // To prevent failure, it is recommended that you set the + // `returnPartialSuccess` parameter to `true`. // https://cloud.google.com/compute/docs/reference/rest/v1/autoscalers/aggregatedList rpc AggregatedListAutoscalers(AggregatedListAutoscalersRequest) returns (google.cloud.cpp.compute.v1.AutoscalerAggregatedList) { @@ -70,8 +73,8 @@ service Autoscalers { option (google.api.method_signature) = "project,zone,autoscaler"; } - // Creates an autoscaler in the specified project using the data included in - // the request. + // Creates an autoscaler in the specified project using the data + // included in the request. // https://cloud.google.com/compute/docs/reference/rest/v1/autoscalers/insert rpc InsertAutoscaler(InsertAutoscalerRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -83,7 +86,8 @@ service Autoscalers { option (google.cloud.operation_service) = "ZoneOperations"; } - // Retrieves a list of autoscalers contained within the specified zone. + // Retrieves a list of autoscalers contained within + // the specified zone. // https://cloud.google.com/compute/docs/reference/rest/v1/autoscalers/list rpc ListAutoscalers(ListAutoscalersRequest) returns (google.cloud.cpp.compute.v1.AutoscalerList) { @@ -93,8 +97,9 @@ service Autoscalers { option (google.api.method_signature) = "project,zone"; } - // Updates an autoscaler in the specified project using the data included in - // the request. This method supports PATCH semantics and uses the JSON merge + // Updates an autoscaler in the specified project using the data + // included in the request. This method supportsPATCH + // semantics and uses theJSON merge // patch format and processing rules. // https://cloud.google.com/compute/docs/reference/rest/v1/autoscalers/patch rpc PatchAutoscaler(PatchAutoscalerRequest) @@ -107,8 +112,20 @@ service Autoscalers { option (google.cloud.operation_service) = "ZoneOperations"; } - // Updates an autoscaler in the specified project using the data included in - // the request. + // Returns permissions that a caller has on the specified resource. + // https://cloud.google.com/compute/docs/reference/rest/v1/autoscalers/testIamPermissions + rpc TestIamPermissions(TestIamPermissionsRequest) + returns (google.cloud.cpp.compute.v1.TestPermissionsResponse) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/zones/{zone}/autoscalers/{resource}/testIamPermissions" + body: "test_permissions_request_resource" + }; + option (google.api.method_signature) = + "project,zone,resource,test_permissions_request_resource"; + } + + // Updates an autoscaler in the specified project using the data + // included in the request. // https://cloud.google.com/compute/docs/reference/rest/v1/autoscalers/update rpc UpdateAutoscaler(UpdateAutoscalerRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -124,37 +141,64 @@ service Autoscalers { // Request message for AggregatedListAutoscalers. message AggregatedListAutoscalersRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; // Indicates whether every visible scope for each scope type (zone, region, @@ -166,25 +210,29 @@ message AggregatedListAutoscalersRequest { // will be included. optional bool include_all_scopes = 2 [json_name = "includeAllScopes"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 3 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 4 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 5 [json_name = "pageToken"]; // Project ID for this request. @@ -192,9 +240,11 @@ message AggregatedListAutoscalersRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; // The Shared VPC service project id or service project number for which @@ -218,14 +268,17 @@ message DeleteAutoscalerRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // Name of the zone for this request. @@ -265,14 +318,17 @@ message InsertAutoscalerRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // Name of the zone for this request. @@ -286,58 +342,89 @@ message InsertAutoscalerRequest { // Request message for ListAutoscalers. message ListAutoscalersRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -345,9 +432,11 @@ message ListAutoscalersRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 6 [json_name = "returnPartialSuccess"]; // Name of the zone for this request. @@ -372,14 +461,17 @@ message PatchAutoscalerRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; // Name of the zone for this request. @@ -390,6 +482,24 @@ message PatchAutoscalerRequest { ]; } +// Request message for TestIamPermissions. +message TestIamPermissionsRequest { + // Project ID for this request. + string project = 1 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // Name or id of the resource for this request. + string resource = 2 + [(google.api.field_behavior) = REQUIRED, json_name = "resource"]; + + // The TestPermissionsRequest for this request. + optional google.cloud.cpp.compute.v1.TestPermissionsRequest + test_permissions_request_resource = 3 [json_name = "__json_request_body"]; + + // The name of the zone for this request. + string zone = 4 [(google.api.field_behavior) = REQUIRED, json_name = "zone"]; +} + // Request message for UpdateAutoscaler. message UpdateAutoscalerRequest { // Name of the autoscaler to update. @@ -408,14 +518,17 @@ message UpdateAutoscalerRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; // Name of the zone for this request. 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 a2c5833518853..786682eb9bc70 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: 20250601 +// revision: 20260807 syntax = "proto3"; @@ -24,13 +24,14 @@ 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_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_047.proto"; -import "google/cloud/compute/v1/internal/common_118.proto"; -import "google/cloud/compute/v1/internal/common_121.proto"; +import "google/cloud/compute/v1/internal/common_009.proto"; +import "google/cloud/compute/v1/internal/common_012.proto"; +import "google/cloud/compute/v1/internal/common_013.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_057.proto"; +import "google/cloud/compute/v1/internal/common_142.proto"; import "google/cloud/compute/v1/internal/common_145.proto"; +import "google/cloud/compute/v1/internal/common_171.proto"; import "google/cloud/extended_operations.proto"; // Service for the backendBuckets resource. @@ -56,6 +57,20 @@ service BackendBuckets { option (google.cloud.operation_service) = "GlobalOperations"; } + // Retrieves the list of all BackendBucket resources, regional and global, + // available to the specified project. + // + // To prevent failure, it is recommended that you set the + // `returnPartialSuccess` parameter to `true`. + // https://cloud.google.com/compute/docs/reference/rest/v1/backendBuckets/aggregatedList + rpc AggregatedListBackendBuckets(AggregatedListBackendBucketsRequest) + returns (google.cloud.cpp.compute.v1.BackendBucketAggregatedList) { + option (google.api.http) = { + get: "/compute/v1/projects/{project}/aggregated/backendBuckets" + }; + option (google.api.method_signature) = "project"; + } + // Deletes the specified BackendBucket resource. // https://cloud.google.com/compute/docs/reference/rest/v1/backendBuckets/delete rpc DeleteBackendBucket(DeleteBackendBucketRequest) @@ -101,8 +116,8 @@ service BackendBuckets { option (google.api.method_signature) = "project,resource"; } - // Creates a BackendBucket resource in the specified project using the data - // included in the request. + // Creates a BackendBucket resource in the specified project using + // the data included in the request. // https://cloud.google.com/compute/docs/reference/rest/v1/backendBuckets/insert rpc InsertBackendBucket(InsertBackendBucketRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -125,9 +140,20 @@ service BackendBuckets { option (google.api.method_signature) = "project"; } + // Retrieves a list of all usable backend buckets in the specified project. + // https://cloud.google.com/compute/docs/reference/rest/v1/backendBuckets/listUsable + rpc ListUsable(ListUsableRequest) + returns (google.cloud.cpp.compute.v1.BackendBucketListUsable) { + option (google.api.http) = { + get: "/compute/v1/projects/{project}/global/backendBuckets/listUsable" + }; + option (google.api.method_signature) = "project"; + } + // 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. + // request. This method supportsPATCH + // semantics and uses theJSON merge + // patch format and processing rules. // https://cloud.google.com/compute/docs/reference/rest/v1/backendBuckets/patch rpc PatchBackendBucket(PatchBackendBucketRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -153,8 +179,8 @@ service BackendBuckets { option (google.cloud.operation_service) = "GlobalOperations"; } - // Sets the access control policy on the specified resource. Replaces any - // existing policy. + // Sets the access control policy on the specified resource. + // Replaces any existing policy. // https://cloud.google.com/compute/docs/reference/rest/v1/backendBuckets/setIamPolicy rpc SetIamPolicy(SetIamPolicyRequest) returns (google.cloud.cpp.compute.v1.Policy) { @@ -209,14 +235,17 @@ message AddSignedUrlKeyRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // The SignedUrlKey for this request. @@ -224,6 +253,121 @@ message AddSignedUrlKeyRequest { [json_name = "__json_request_body"]; } +// Request message for AggregatedListBackendBuckets. +message AggregatedListBackendBucketsRequest { + // A filter expression that filters resources listed in the response. Most + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. + optional string filter = 1 [json_name = "filter"]; + + // 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. + optional bool include_all_scopes = 2 [json_name = "includeAllScopes"]; + + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) + optional uint32 max_results = 3 [json_name = "maxResults"]; + + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or + // `creationTimestamp desc` is supported. + optional string order_by = 4 [json_name = "orderBy"]; + + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. + optional string page_token = 5 [json_name = "pageToken"]; + + // Name of the project scoping this request. + string project = 6 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // Opt-in for partial success behavior which provides partial results in case + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. + optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; + + // The Shared VPC service project id or service project number for which + // aggregated list request is invoked for subnetworks list-usable api. + optional string service_project_number = 8 + [json_name = "serviceProjectNumber"]; +} + // Request message for DeleteBackendBucket. message DeleteBackendBucketRequest { // Name of the BackendBucket resource to delete. @@ -239,14 +383,17 @@ message DeleteBackendBucketRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; } @@ -270,14 +417,17 @@ message DeleteSignedUrlKeyRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; } @@ -322,72 +472,207 @@ message InsertBackendBucketRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; } // Request message for ListBackendBuckets. message ListBackendBucketsRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. + optional string filter = 1 [json_name = "filter"]; + + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) + optional uint32 max_results = 2 [json_name = "maxResults"]; + + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or + // `creationTimestamp desc` is supported. + optional string order_by = 3 [json_name = "orderBy"]; + + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. + optional string page_token = 4 [json_name = "pageToken"]; + + // Project ID for this request. + string project = 5 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // Opt-in for partial success behavior which provides partial results in case + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. + optional bool return_partial_success = 6 [json_name = "returnPartialSuccess"]; +} + +// Request message for ListUsable. +message ListUsableRequest { + // A filter expression that filters resources listed in the response. Most + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -395,9 +680,11 @@ message ListBackendBucketsRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 6 [json_name = "returnPartialSuccess"]; } @@ -420,14 +707,17 @@ message PatchBackendBucketRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; } @@ -447,14 +737,17 @@ message SetEdgeSecurityPolicyRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // The SecurityPolicyReference for this request. @@ -513,13 +806,16 @@ message UpdateBackendBucketRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; } 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 9ea86ac190e1d..9a58d6e1976ad 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: 20250601 +// revision: 20260807 syntax = "proto3"; @@ -25,14 +25,15 @@ 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_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_047.proto"; -import "google/cloud/compute/v1/internal/common_118.proto"; -import "google/cloud/compute/v1/internal/common_121.proto"; +import "google/cloud/compute/v1/internal/common_009.proto"; +import "google/cloud/compute/v1/internal/common_014.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_057.proto"; +import "google/cloud/compute/v1/internal/common_142.proto"; import "google/cloud/compute/v1/internal/common_145.proto"; +import "google/cloud/compute/v1/internal/common_171.proto"; import "google/cloud/extended_operations.proto"; +import "google/protobuf/empty.proto"; // Service for the backendServices resource. // https://cloud.google.com/compute/docs/reference/rest/v1/backendServices @@ -58,8 +59,10 @@ service BackendServices { } // 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`. + // available to the specified project. + // + // To prevent failure, it is recommended that you set the + // `returnPartialSuccess` parameter to `true`. // https://cloud.google.com/compute/docs/reference/rest/v1/backendServices/aggregatedList rpc AggregatedListBackendServices(AggregatedListBackendServicesRequest) returns (google.cloud.cpp.compute.v1.BackendServiceAggregatedList) { @@ -103,9 +106,24 @@ service BackendServices { option (google.api.method_signature) = "project,backend_service"; } - // Gets the most recent health check results for this BackendService. Example - // request body: { "group": - // "/zones/us-east1-b/instanceGroups/lb-backend-example" } + // Returns effective security policies applied to this backend service. + // https://cloud.google.com/compute/docs/reference/rest/v1/backendServices/getEffectiveSecurityPolicies + rpc GetEffectiveSecurityPolicies(GetEffectiveSecurityPoliciesRequest) + returns (google.protobuf.Empty) { + option (google.api.http) = { + get: "/compute/v1/projects/{project}/global/backendServices/{backend_service}/getEffectiveSecurityPolicies" + }; + option (google.api.method_signature) = "project,backend_service"; + } + + // Gets the most recent health check results for this + // BackendService. + // + // Example request body: + // + // { + // "group": "/zones/us-east1-b/instanceGroups/lb-backend-example" + // } // https://cloud.google.com/compute/docs/reference/rest/v1/backendServices/getHealth rpc GetHealth(GetHealthRequest) returns (google.cloud.cpp.compute.v1.BackendServiceGroupHealth) { @@ -128,9 +146,9 @@ service BackendServices { option (google.api.method_signature) = "project,resource"; } - // Creates a BackendService resource in the specified project using the data - // included in the request. For more information, see Backend services - // overview . + // Creates a BackendService resource in the specified project using + // the data included in the request. For more information, see + // Backend services overview. // https://cloud.google.com/compute/docs/reference/rest/v1/backendServices/insert rpc InsertBackendService(InsertBackendServiceRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -153,7 +171,10 @@ service BackendServices { option (google.api.method_signature) = "project"; } - // Retrieves a list of all usable backend services in the specified project. + // Retrieves a list of all usable backend services for Application Load + // Balancers and Proxy Network Load Balancers in the specified project. + // Backend services for external and internal passthrough Network Load + // Balancers are not included in the response. // https://cloud.google.com/compute/docs/reference/rest/v1/backendServices/listUsable rpc ListUsable(ListUsableRequest) returns (google.cloud.cpp.compute.v1.BackendServiceListUsable) { @@ -164,9 +185,10 @@ service BackendServices { } // 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. + // request. For more information, see + // Backend services overview. This method + // supports PATCH semantics and uses the JSON merge + // patch format and processing rules. // https://cloud.google.com/compute/docs/reference/rest/v1/backendServices/patch rpc PatchBackendService(PatchBackendServiceRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -192,8 +214,8 @@ service BackendServices { option (google.cloud.operation_service) = "GlobalOperations"; } - // Sets the access control policy on the specified resource. Replaces any - // existing policy. + // Sets the access control policy on the specified resource. + // Replaces any existing policy. // https://cloud.google.com/compute/docs/reference/rest/v1/backendServices/setIamPolicy rpc SetIamPolicy(SetIamPolicyRequest) returns (google.cloud.cpp.compute.v1.Policy) { @@ -206,7 +228,8 @@ service BackendServices { } // Sets the Google Cloud Armor security policy for the specified backend - // service. For more information, see Google Cloud Armor Overview + // service. For more information, seeGoogle + // Cloud Armor Overview // https://cloud.google.com/compute/docs/reference/rest/v1/backendServices/setSecurityPolicy rpc SetSecurityPolicy(SetSecurityPolicyRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -232,7 +255,8 @@ service BackendServices { } // Updates the specified BackendService resource with the data included in the - // request. For more information, see Backend services overview. + // request. For more information, seeBackend + // services overview. // https://cloud.google.com/compute/docs/reference/rest/v1/backendServices/update rpc UpdateBackendService(UpdateBackendServiceRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -262,14 +286,17 @@ message AddSignedUrlKeyRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // The SignedUrlKey for this request. @@ -280,37 +307,64 @@ message AddSignedUrlKeyRequest { // Request message for AggregatedListBackendServices. message AggregatedListBackendServicesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; // Indicates whether every visible scope for each scope type (zone, region, @@ -322,25 +376,29 @@ message AggregatedListBackendServicesRequest { // will be included. optional bool include_all_scopes = 2 [json_name = "includeAllScopes"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 3 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 4 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 5 [json_name = "pageToken"]; // Name of the project scoping this request. @@ -348,9 +406,11 @@ message AggregatedListBackendServicesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; // The Shared VPC service project id or service project number for which @@ -374,14 +434,17 @@ message DeleteBackendServiceRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; } @@ -405,14 +468,17 @@ message DeleteSignedUrlKeyRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; } @@ -427,6 +493,17 @@ message GetBackendServiceRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; } +// Request message for GetEffectiveSecurityPolicies. +message GetEffectiveSecurityPoliciesRequest { + // Name of the Backend Service for this request. + string backend_service = 1 + [(google.api.field_behavior) = REQUIRED, json_name = "backendService"]; + + // Project ID for this request. + string project = 2 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; +} + // Request message for GetHealth. message GetHealthRequest { // Name of the BackendService resource to which the queried instance belongs. @@ -471,72 +548,106 @@ message InsertBackendServiceRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; } // Request message for ListBackendServices. message ListBackendServicesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -544,67 +655,100 @@ message ListBackendServicesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 6 [json_name = "returnPartialSuccess"]; } // Request message for ListUsable. message ListUsableRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -612,9 +756,11 @@ message ListUsableRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 6 [json_name = "returnPartialSuccess"]; } @@ -637,14 +783,17 @@ message PatchBackendServiceRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; } @@ -664,14 +813,17 @@ message SetEdgeSecurityPolicyRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // The SecurityPolicyReference for this request. @@ -712,14 +864,17 @@ message SetSecurityPolicyRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // The SecurityPolicyReference for this request. @@ -762,13 +917,16 @@ message UpdateBackendServiceRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; } diff --git a/protos/google/cloud/compute/cross_site_networks/v1/cross_site_networks.proto b/protos/google/cloud/compute/cross_site_networks/v1/cross_site_networks.proto new file mode 100644 index 0000000000000..eca3802b18519 --- /dev/null +++ b/protos/google/cloud/compute/cross_site_networks/v1/cross_site_networks.proto @@ -0,0 +1,315 @@ +// Copyright 2026 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: 20260807 + +syntax = "proto3"; + +package google.cloud.cpp.compute.cross_site_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_019.proto"; +import "google/cloud/compute/v1/internal/common_027.proto"; +import "google/cloud/extended_operations.proto"; + +// Service for the crossSiteNetworks resource. +// https://cloud.google.com/compute/docs/reference/rest/v1/crossSiteNetworks +service CrossSiteNetworks { + option (google.api.default_host) = "compute.googleapis.com"; + option (google.api.oauth_scopes) = + "https://www.googleapis.com/auth/cloud-platform," + "https://www.googleapis.com/auth/compute," + "https://www.googleapis.com/auth/compute.readonly"; + + // Deletes the specified cross-site network in the given scope. + // https://cloud.google.com/compute/docs/reference/rest/v1/crossSiteNetworks/delete + rpc DeleteCrossSiteNetwork(DeleteCrossSiteNetworkRequest) + returns (google.cloud.cpp.compute.v1.Operation) { + option (google.api.http) = { + delete: "/compute/v1/projects/{project}/global/crossSiteNetworks/{cross_site_network}" + }; + option (google.api.method_signature) = "project,cross_site_network"; + option (google.cloud.operation_service) = "GlobalOperations"; + } + + // Returns the specified cross-site network in the given scope. + // https://cloud.google.com/compute/docs/reference/rest/v1/crossSiteNetworks/get + rpc GetCrossSiteNetwork(GetCrossSiteNetworkRequest) + returns (google.cloud.cpp.compute.v1.CrossSiteNetwork) { + option (google.api.http) = { + get: "/compute/v1/projects/{project}/global/crossSiteNetworks/{cross_site_network}" + }; + option (google.api.method_signature) = "project,cross_site_network"; + } + + // Creates a cross-site network in the specified project in the given scope + // using the parameters that are included in the request. + // https://cloud.google.com/compute/docs/reference/rest/v1/crossSiteNetworks/insert + rpc InsertCrossSiteNetwork(InsertCrossSiteNetworkRequest) + returns (google.cloud.cpp.compute.v1.Operation) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/global/crossSiteNetworks" + body: "cross_site_network_resource" + }; + option (google.api.method_signature) = + "project,cross_site_network_resource"; + option (google.cloud.operation_service) = "GlobalOperations"; + } + + // Lists the cross-site networks for a project in the given scope. + // https://cloud.google.com/compute/docs/reference/rest/v1/crossSiteNetworks/list + rpc ListCrossSiteNetworks(ListCrossSiteNetworksRequest) + returns (google.cloud.cpp.compute.v1.CrossSiteNetworkList) { + option (google.api.http) = { + get: "/compute/v1/projects/{project}/global/crossSiteNetworks" + }; + option (google.api.method_signature) = "project"; + } + + // Updates the specified cross-site network with the data included in + // the request. This method supportsPATCH + // semantics and uses theJSON merge + // patch format and processing rules. + // https://cloud.google.com/compute/docs/reference/rest/v1/crossSiteNetworks/patch + rpc PatchCrossSiteNetwork(PatchCrossSiteNetworkRequest) + returns (google.cloud.cpp.compute.v1.Operation) { + option (google.api.http) = { + patch: "/compute/v1/projects/{project}/global/crossSiteNetworks/{cross_site_network}" + body: "cross_site_network_resource" + }; + option (google.api.method_signature) = + "project,cross_site_network,update_mask,cross_site_network_resource"; + option (google.cloud.operation_service) = "GlobalOperations"; + } +} + +// Request message for DeleteCrossSiteNetwork. +message DeleteCrossSiteNetworkRequest { + // Name of the cross-site network to delete. + string cross_site_network = 1 + [(google.api.field_behavior) = REQUIRED, json_name = "crossSiteNetwork"]; + + // Project ID for this request. + string project = 2 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "project", + json_name = "project" + ]; + + // An optional request ID to identify requests. Specify a unique request ID so + // that if you must retry your request, the server will know to ignore the + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating 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 + optional string request_id = 3 [json_name = "requestId"]; +} + +// Request message for GetCrossSiteNetwork. +message GetCrossSiteNetworkRequest { + // Name of the cross-site network to return. + string cross_site_network = 1 + [(google.api.field_behavior) = REQUIRED, json_name = "crossSiteNetwork"]; + + // Project ID for this request. + string project = 2 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; +} + +// Request message for InsertCrossSiteNetwork. +message InsertCrossSiteNetworkRequest { + // The CrossSiteNetwork for this request. + optional google.cloud.cpp.compute.v1.CrossSiteNetwork + cross_site_network_resource = 1 [json_name = "__json_request_body"]; + + // Project ID for this request. + string project = 2 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "project", + json_name = "project" + ]; + + // An optional request ID to identify requests. Specify a unique request ID so + // that if you must retry your request, the server will know to ignore the + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating 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 + optional string request_id = 3 [json_name = "requestId"]; + + // [Input Only] Validate the new configuration, but don't create it. + optional bool validate_only = 4 [json_name = "validateOnly"]; +} + +// Request message for ListCrossSiteNetworks. +message ListCrossSiteNetworksRequest { + // A filter expression that filters resources listed in the response. Most + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. + optional string filter = 1 [json_name = "filter"]; + + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) + optional uint32 max_results = 2 [json_name = "maxResults"]; + + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or + // `creationTimestamp desc` is supported. + optional string order_by = 3 [json_name = "orderBy"]; + + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. + optional string page_token = 4 [json_name = "pageToken"]; + + // Project ID for this request. + string project = 5 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // Opt-in for partial success behavior which provides partial results in case + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. + optional bool return_partial_success = 6 [json_name = "returnPartialSuccess"]; +} + +// Request message for PatchCrossSiteNetwork. +message PatchCrossSiteNetworkRequest { + // Name of the cross-site network to update. + string cross_site_network = 1 + [(google.api.field_behavior) = REQUIRED, json_name = "crossSiteNetwork"]; + + // The CrossSiteNetwork for this request. + optional google.cloud.cpp.compute.v1.CrossSiteNetwork + cross_site_network_resource = 2 [json_name = "__json_request_body"]; + + // Project ID for this request. + string project = 3 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "project", + json_name = "project" + ]; + + // An optional request ID to identify requests. Specify a unique request ID so + // that if you must retry your request, the server will know to ignore the + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating 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 + optional string request_id = 4 [json_name = "requestId"]; + + // update_mask indicates fields to be updated as part of this request. + optional string update_mask = 5 [json_name = "updateMask"]; + + // [Input Only] Validate the new configuration, but don't update it. + optional bool validate_only = 6 [json_name = "validateOnly"]; +} 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 c9ae7f045130e..cc26810245ca7 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: 20250601 +// revision: 20260807 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_035.proto"; +import "google/cloud/compute/v1/internal/common_036.proto"; // Service for the diskTypes resource. // https://cloud.google.com/compute/docs/reference/rest/v1/diskTypes @@ -36,8 +36,10 @@ service DiskTypes { "https://www.googleapis.com/auth/compute," "https://www.googleapis.com/auth/compute.readonly"; - // Retrieves an aggregated list of disk types. To prevent failure, Google - // recommends that you set the `returnPartialSuccess` parameter to `true`. + // Retrieves an aggregated list of disk types. + // + // To prevent failure, it is recommended that you set the + // `returnPartialSuccess` parameter to `true`. // https://cloud.google.com/compute/docs/reference/rest/v1/diskTypes/aggregatedList rpc AggregatedListDiskTypes(AggregatedListDiskTypesRequest) returns (google.cloud.cpp.compute.v1.DiskTypeAggregatedList) { @@ -57,7 +59,8 @@ service DiskTypes { option (google.api.method_signature) = "project,zone,disk_type"; } - // Retrieves a list of disk types available to the specified project. + // Retrieves a list of disk types available to the specified + // project. // https://cloud.google.com/compute/docs/reference/rest/v1/diskTypes/list rpc ListDiskTypes(ListDiskTypesRequest) returns (google.cloud.cpp.compute.v1.DiskTypeList) { @@ -71,37 +74,64 @@ service DiskTypes { // Request message for AggregatedListDiskTypes. message AggregatedListDiskTypesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; // Indicates whether every visible scope for each scope type (zone, region, @@ -113,25 +143,29 @@ message AggregatedListDiskTypesRequest { // will be included. optional bool include_all_scopes = 2 [json_name = "includeAllScopes"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 3 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 4 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 5 [json_name = "pageToken"]; // Project ID for this request. @@ -139,9 +173,11 @@ message AggregatedListDiskTypesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; // The Shared VPC service project id or service project number for which @@ -167,58 +203,89 @@ message GetDiskTypeRequest { // Request message for ListDiskTypes. message ListDiskTypesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -226,9 +293,11 @@ message ListDiskTypesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 6 [json_name = "returnPartialSuccess"]; // The name of the zone for this request. diff --git a/protos/google/cloud/compute/disks/v1/disks.proto b/protos/google/cloud/compute/disks/v1/disks.proto index 1fc82311b5c79..a1ac2c276a476 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: 20250601 +// revision: 20260807 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_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_009.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_145.proto"; -import "google/cloud/compute/v1/internal/common_151.proto"; -import "google/cloud/compute/v1/internal/common_152.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_020.proto"; +import "google/cloud/compute/v1/internal/common_146.proto"; +import "google/cloud/compute/v1/internal/common_171.proto"; +import "google/cloud/compute/v1/internal/common_180.proto"; +import "google/cloud/compute/v1/internal/common_182.proto"; import "google/cloud/extended_operations.proto"; // Service for the disks resource. @@ -43,8 +43,9 @@ service Disks { "https://www.googleapis.com/auth/compute," "https://www.googleapis.com/auth/compute.readonly"; - // Adds existing resource policies to a disk. You can only add one policy - // which will be applied to this disk for scheduling snapshot creation. + // Adds existing resource policies to a disk. You can only add one + // policy which will be applied to this disk for scheduling snapshot + // creation. // https://cloud.google.com/compute/docs/reference/rest/v1/disks/addResourcePolicies rpc AddResourcePolicies(AddResourcePoliciesRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -57,9 +58,10 @@ service Disks { option (google.cloud.operation_service) = "ZoneOperations"; } - // Retrieves an aggregated list of persistent disks. To prevent failure, - // Google recommends that you set the `returnPartialSuccess` parameter to - // `true`. + // Retrieves an aggregated list of persistent disks. + // + // To prevent failure, it is recommended that you set the + // `returnPartialSuccess` parameter to `true`. // https://cloud.google.com/compute/docs/reference/rest/v1/disks/aggregatedList rpc AggregatedListDisks(AggregatedListDisksRequest) returns (google.cloud.cpp.compute.v1.DiskAggregatedList) { @@ -82,8 +84,9 @@ service Disks { option (google.cloud.operation_service) = "ZoneOperations"; } - // Sets the labels on many disks at once. To learn more about labels, read the - // Labeling Resources documentation. + // Sets the labels on many disks at once. To learn more about labels, read + // theLabeling + // Resources documentation. // https://cloud.google.com/compute/docs/reference/rest/v1/disks/bulkSetLabels rpc BulkSetLabels(BulkSetLabelsRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -97,9 +100,9 @@ service Disks { } // 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. + // 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. // https://cloud.google.com/compute/docs/reference/rest/v1/disks/createSnapshot rpc CreateSnapshot(CreateSnapshotRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -113,8 +116,9 @@ service Disks { } // 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 + // permanently and is irreversible. However, deleting a disk does not + // delete any snapshots + // previously made from the disk. You must separatelydelete // snapshots. // https://cloud.google.com/compute/docs/reference/rest/v1/disks/delete rpc DeleteDisk(DeleteDiskRequest) @@ -146,11 +150,12 @@ service Disks { option (google.api.method_signature) = "project,zone,resource"; } - // 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. + // Creates a persistent disk in the specified project using the data + // in the request. You can create a disk from a source + // (sourceImage, sourceSnapshot, orsourceDisk) 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. // https://cloud.google.com/compute/docs/reference/rest/v1/disks/insert rpc InsertDisk(InsertDiskRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -162,7 +167,8 @@ service Disks { option (google.cloud.operation_service) = "ZoneOperations"; } - // Retrieves a list of persistent disks contained within the specified zone. + // Retrieves a list of persistent disks contained within + // the specified zone. // https://cloud.google.com/compute/docs/reference/rest/v1/disks/list rpc ListDisks(ListDisksRequest) returns (google.cloud.cpp.compute.v1.DiskList) { @@ -185,8 +191,8 @@ service Disks { option (google.cloud.operation_service) = "ZoneOperations"; } - // Resizes the specified persistent disk. You can only increase the size of - // the disk. + // Resizes the specified persistent disk. + // You can only increase the size of the disk. // https://cloud.google.com/compute/docs/reference/rest/v1/disks/resize rpc Resize(ResizeRequest) returns (google.cloud.cpp.compute.v1.Operation) { option (google.api.http) = { @@ -198,8 +204,8 @@ service Disks { option (google.cloud.operation_service) = "ZoneOperations"; } - // Sets the access control policy on the specified resource. Replaces any - // existing policy. + // Sets the access control policy on the specified resource. + // Replaces any existing policy. // https://cloud.google.com/compute/docs/reference/rest/v1/disks/setIamPolicy rpc SetIamPolicy(SetIamPolicyRequest) returns (google.cloud.cpp.compute.v1.Policy) { @@ -211,7 +217,7 @@ service Disks { "project,zone,resource,zone_set_policy_request_resource"; } - // Sets the labels on a disk. To learn more about labels, read the Labeling + // Sets the labels on a disk. To learn more about labels, read theLabeling // Resources documentation. // https://cloud.google.com/compute/docs/reference/rest/v1/disks/setLabels rpc SetLabels(SetLabelsRequest) @@ -225,7 +231,8 @@ service Disks { option (google.cloud.operation_service) = "ZoneOperations"; } - // Starts asynchronous replication. Must be invoked on the primary disk. + // Starts asynchronous replication. + // Must be invoked on the primary disk. // https://cloud.google.com/compute/docs/reference/rest/v1/disks/startAsyncReplication rpc StartAsyncReplication(StartAsyncReplicationRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -238,8 +245,8 @@ service Disks { option (google.cloud.operation_service) = "ZoneOperations"; } - // Stops asynchronous replication. Can be invoked either on the primary or on - // the secondary disk. + // Stops asynchronous replication. + // Can be invoked either on the primary or on the secondary disk. // https://cloud.google.com/compute/docs/reference/rest/v1/disks/stopAsyncReplication rpc StopAsyncReplication(StopAsyncReplicationRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -251,8 +258,8 @@ service Disks { option (google.cloud.operation_service) = "ZoneOperations"; } - // Stops asynchronous replication for a consistency group of disks. Can be - // invoked either in the primary or secondary scope. + // Stops asynchronous replication for a consistency group of disks. + // Can be invoked either in the primary or secondary scope. // https://cloud.google.com/compute/docs/reference/rest/v1/disks/stopGroupAsyncReplication rpc StopGroupAsyncReplication(StopGroupAsyncReplicationRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -277,9 +284,9 @@ service Disks { "project,zone,resource,test_permissions_request_resource"; } - // 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. + // 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. // https://cloud.google.com/compute/docs/reference/rest/v1/disks/update rpc UpdateDisk(UpdateDiskRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -291,6 +298,20 @@ service Disks { "project,zone,disk,update_mask,disk_resource"; option (google.cloud.operation_service) = "ZoneOperations"; } + + // Rotates the customer-managed + // encryption key to the latest version for the specified persistent disk. + // https://cloud.google.com/compute/docs/reference/rest/v1/disks/updateKmsKey + rpc UpdateKmsKey(UpdateKmsKeyRequest) + returns (google.cloud.cpp.compute.v1.Operation) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/zones/{zone}/disks/{disk}/updateKmsKey" + body: "disk_update_kms_key_request_resource" + }; + option (google.api.method_signature) = + "project,zone,disk,disk_update_kms_key_request_resource"; + option (google.cloud.operation_service) = "ZoneOperations"; + } } // Request message for AddResourcePolicies. @@ -312,14 +333,17 @@ message AddResourcePoliciesRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; // The name of the zone for this request. @@ -333,37 +357,64 @@ message AddResourcePoliciesRequest { // Request message for AggregatedListDisks. message AggregatedListDisksRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; // Indicates whether every visible scope for each scope type (zone, region, @@ -375,25 +426,29 @@ message AggregatedListDisksRequest { // will be included. optional bool include_all_scopes = 2 [json_name = "includeAllScopes"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 3 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 4 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 5 [json_name = "pageToken"]; // Project ID for this request. @@ -401,9 +456,11 @@ message AggregatedListDisksRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; // The Shared VPC service project id or service project number for which @@ -427,14 +484,17 @@ message BulkInsertRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // The name of the zone for this request. @@ -461,14 +521,17 @@ message BulkSetLabelsRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // Name or id of the resource for this request. @@ -500,14 +563,17 @@ message CreateSnapshotRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; // The Snapshot for this request. @@ -536,14 +602,17 @@ message DeleteDiskRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // The name of the zone for this request. @@ -600,14 +669,17 @@ message InsertDiskRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // Source image to restore onto a disk. This field is optional. @@ -624,58 +696,89 @@ message InsertDiskRequest { // Request message for ListDisks. message ListDisksRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -683,9 +786,11 @@ message ListDisksRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 6 [json_name = "returnPartialSuccess"]; // The name of the zone for this request. @@ -711,14 +816,17 @@ message RemoveResourcePoliciesRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; // The name of the zone for this request. @@ -747,14 +855,17 @@ message ResizeRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; // The name of the zone for this request. @@ -794,14 +905,17 @@ message SetLabelsRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 2 [json_name = "requestId"]; // Name or id of the resource for this request. @@ -839,14 +953,17 @@ message StartAsyncReplicationRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; // The name of the zone for this request. @@ -871,14 +988,17 @@ message StopAsyncReplicationRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // The name of the zone for this request. @@ -905,14 +1025,17 @@ message StopGroupAsyncReplicationRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // The name of the zone for this request. This must be the zone of the primary @@ -962,14 +1085,17 @@ message UpdateDiskRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 5 [json_name = "requestId"]; // update_mask indicates fields to be updated as part of this request. @@ -982,3 +1108,43 @@ message UpdateDiskRequest { json_name = "zone" ]; } + +// Request message for UpdateKmsKey. +message UpdateKmsKeyRequest { + // Name of the Disk resource, should conform to RFC1035. + string disk = 1 [(google.api.field_behavior) = REQUIRED, json_name = "disk"]; + + // The DiskUpdateKmsKeyRequest for this request. + optional google.cloud.cpp.compute.v1.DiskUpdateKmsKeyRequest + disk_update_kms_key_request_resource = 2 + [json_name = "__json_request_body"]; + + // Project ID for this request. + string project = 3 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "project", + json_name = "project" + ]; + + // An optional request ID to identify requests. Specify a unique request ID so + // that if you must retry your request, the server will know to ignore the + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). + optional string request_id = 4 [json_name = "requestId"]; + + // The name of the zone for this request. + string zone = 5 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "zone", + json_name = "zone" + ]; +} 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 01153ee58514b..7d5b60315ac68 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: 20250601 +// revision: 20260807 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_016.proto"; -import "google/cloud/compute/v1/internal/common_032.proto"; -import "google/cloud/compute/v1/internal/common_046.proto"; -import "google/cloud/compute/v1/internal/common_145.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_041.proto"; +import "google/cloud/compute/v1/internal/common_056.proto"; +import "google/cloud/compute/v1/internal/common_171.proto"; import "google/cloud/extended_operations.proto"; // Service for the externalVpnGateways resource. @@ -61,8 +61,8 @@ service ExternalVpnGateways { option (google.api.method_signature) = "project,external_vpn_gateway"; } - // Creates a ExternalVpnGateway in the specified project using the data - // included in the request. + // Creates a ExternalVpnGateway in the specified project using + // the data included in the request. // https://cloud.google.com/compute/docs/reference/rest/v1/externalVpnGateways/insert rpc InsertExternalVpnGateway(InsertExternalVpnGatewayRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -86,8 +86,9 @@ service ExternalVpnGateways { option (google.api.method_signature) = "project"; } - // Sets the labels on an ExternalVpnGateway. To learn more about labels, read - // the Labeling Resources documentation. + // Sets the labels on an ExternalVpnGateway. To learn more about labels, + // read the Labeling + // Resources documentation. // https://cloud.google.com/compute/docs/reference/rest/v1/externalVpnGateways/setLabels rpc SetLabels(SetLabelsRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -130,14 +131,17 @@ message DeleteExternalVpnGatewayRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; } @@ -169,72 +173,106 @@ message InsertExternalVpnGatewayRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; } // Request message for ListExternalVpnGateways. message ListExternalVpnGatewaysRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -242,9 +280,11 @@ message ListExternalVpnGatewaysRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 6 [json_name = "returnPartialSuccess"]; } 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 0c522ea5a0027..78761984d527e 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: 20250601 +// revision: 20260807 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_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_038.proto"; -import "google/cloud/compute/v1/internal/common_039.proto"; -import "google/cloud/compute/v1/internal/common_145.proto"; +import "google/cloud/compute/v1/internal/common_009.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_045.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_171.proto"; import "google/cloud/extended_operations.proto"; // Service for the firewallPolicies resource. @@ -142,8 +142,8 @@ service FirewallPolicies { option (google.cloud.operation_service) = "GlobalOrganizationOperations"; } - // Lists all the policies that have been configured for the specified folder - // or organization. + // Lists all the policies that have been configured for the specified + // folder or organization. // https://cloud.google.com/compute/docs/reference/rest/v1/firewallPolicies/list rpc ListFirewallPolicies(ListFirewallPoliciesRequest) returns (google.cloud.cpp.compute.v1.FirewallPolicyList) { @@ -222,8 +222,8 @@ service FirewallPolicies { option (google.cloud.operation_service) = "GlobalOrganizationOperations"; } - // Sets the access control policy on the specified resource. Replaces any - // existing policy. + // Sets the access control policy on the specified resource. + // Replaces any existing policy. // https://cloud.google.com/compute/docs/reference/rest/v1/firewallPolicies/setIamPolicy rpc SetIamPolicy(SetIamPolicyRequest) returns (google.cloud.cpp.compute.v1.Policy) { @@ -267,14 +267,17 @@ message AddAssociationRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; } @@ -290,14 +293,17 @@ message AddRuleRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; } @@ -309,14 +315,17 @@ message CloneRulesRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 2 [json_name = "requestId"]; // The firewall policy from which to copy rules. @@ -332,14 +341,17 @@ message DeleteFirewallPolicyRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 2 [json_name = "requestId"]; } @@ -394,19 +406,28 @@ message InsertFirewallPolicyRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; } // Request message for ListAssociations. message ListAssociationsRequest { + // If set to "true", the response will contain a list of all associations for + // the containing folders and the containing organization of the target. The + // parameter has no effect if the target is an organization. + optional bool include_inherited_policies = 2 + [json_name = "includeInheritedPolicies"]; + // The target resource to list associations. It is an organization, or a // folder. optional string target_resource = 1 [json_name = "targetResource"]; @@ -415,58 +436,89 @@ message ListAssociationsRequest { // Request message for ListFirewallPolicies. message ListFirewallPoliciesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Parent ID for this request. The ID can be either be "folders/[FOLDER_ID]" @@ -475,9 +527,11 @@ message ListFirewallPoliciesRequest { optional string parent_id = 5 [json_name = "parentId"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 6 [json_name = "returnPartialSuccess"]; } @@ -494,14 +548,17 @@ message MoveRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; } @@ -517,14 +574,17 @@ message PatchFirewallPolicyRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; } @@ -543,14 +603,17 @@ message PatchRuleRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; } @@ -565,14 +628,17 @@ message RemoveAssociationRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; } @@ -587,14 +653,17 @@ message RemoveRuleRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; } diff --git a/protos/google/cloud/compute/firewalls/v1/firewalls.proto b/protos/google/cloud/compute/firewalls/v1/firewalls.proto index ef3523b35ba1d..386dbf568ae8e 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: 20250601 +// revision: 20260807 syntax = "proto3"; @@ -24,9 +24,10 @@ 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_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_019.proto"; +import "google/cloud/compute/v1/internal/common_043.proto"; +import "google/cloud/compute/v1/internal/common_044.proto"; +import "google/cloud/compute/v1/internal/common_171.proto"; import "google/cloud/extended_operations.proto"; // Service for the firewalls resource. @@ -59,8 +60,8 @@ service Firewalls { option (google.api.method_signature) = "project,firewall"; } - // Creates a firewall rule in the specified project using the data included in - // the request. + // Creates a firewall rule in the specified project using the data + // included in the request. // https://cloud.google.com/compute/docs/reference/rest/v1/firewalls/insert rpc InsertFirewall(InsertFirewallRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -72,7 +73,8 @@ service Firewalls { option (google.cloud.operation_service) = "GlobalOperations"; } - // Retrieves the list of firewall rules available to the specified project. + // Retrieves the list of firewall rules available to the specified + // project. // https://cloud.google.com/compute/docs/reference/rest/v1/firewalls/list rpc ListFirewalls(ListFirewallsRequest) returns (google.cloud.cpp.compute.v1.FirewallList) { @@ -82,9 +84,10 @@ service Firewalls { option (google.api.method_signature) = "project"; } - // 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. + // Updates the specified firewall rule with the data included in the + // request. This method supportsPATCH + // semantics and uses theJSON merge + // patch format and processing rules. // https://cloud.google.com/compute/docs/reference/rest/v1/firewalls/patch rpc PatchFirewall(PatchFirewallRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -96,7 +99,20 @@ service Firewalls { option (google.cloud.operation_service) = "GlobalOperations"; } - // Updates the specified firewall rule with the data included in the request. + // Returns permissions that a caller has on the specified resource. + // https://cloud.google.com/compute/docs/reference/rest/v1/firewalls/testIamPermissions + rpc TestIamPermissions(TestIamPermissionsRequest) + returns (google.cloud.cpp.compute.v1.TestPermissionsResponse) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/global/firewalls/{resource}/testIamPermissions" + body: "test_permissions_request_resource" + }; + option (google.api.method_signature) = + "project,resource,test_permissions_request_resource"; + } + + // 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. // https://cloud.google.com/compute/docs/reference/rest/v1/firewalls/update @@ -126,14 +142,17 @@ message DeleteFirewallRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; } @@ -163,72 +182,106 @@ message InsertFirewallRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; } // Request message for ListFirewalls. message ListFirewallsRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -236,9 +289,11 @@ message ListFirewallsRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 6 [json_name = "returnPartialSuccess"]; } @@ -261,17 +316,35 @@ message PatchFirewallRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; } +// Request message for TestIamPermissions. +message TestIamPermissionsRequest { + // Project ID for this request. + string project = 1 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // Name or id of the resource for this request. + string resource = 2 + [(google.api.field_behavior) = REQUIRED, json_name = "resource"]; + + // The TestPermissionsRequest for this request. + optional google.cloud.cpp.compute.v1.TestPermissionsRequest + test_permissions_request_resource = 3 [json_name = "__json_request_body"]; +} + // Request message for UpdateFirewall. message UpdateFirewallRequest { // Name of the firewall rule to update. @@ -291,13 +364,16 @@ message UpdateFirewallRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; } 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 7f89e23af5bdc..68243d63d6467 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: 20250601 +// revision: 20260807 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_016.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_107.proto"; -import "google/cloud/compute/v1/internal/common_140.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_050.proto"; +import "google/cloud/compute/v1/internal/common_051.proto"; +import "google/cloud/compute/v1/internal/common_125.proto"; +import "google/cloud/compute/v1/internal/common_166.proto"; import "google/cloud/extended_operations.proto"; // Service for the forwardingRules resource. @@ -40,9 +40,10 @@ service ForwardingRules { "https://www.googleapis.com/auth/compute," "https://www.googleapis.com/auth/compute.readonly"; - // Retrieves an aggregated list of forwarding rules. To prevent failure, - // Google recommends that you set the `returnPartialSuccess` parameter to - // `true`. + // Retrieves an aggregated list of forwarding rules. + // + // To prevent failure, it is recommended that you set the + // `returnPartialSuccess` parameter to `true`. // https://cloud.google.com/compute/docs/reference/rest/v1/forwardingRules/aggregatedList rpc AggregatedListForwardingRules(AggregatedListForwardingRulesRequest) returns (google.cloud.cpp.compute.v1.ForwardingRuleAggregatedList) { @@ -99,9 +100,10 @@ service ForwardingRules { } // 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. + // request. This method supportsPATCH + // semantics and uses theJSON merge + // patch format and processing rules. Currently, you can only + // patch the network_tier field. // https://cloud.google.com/compute/docs/reference/rest/v1/forwardingRules/patch rpc PatchForwardingRule(PatchForwardingRuleRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -114,8 +116,9 @@ service ForwardingRules { option (google.cloud.operation_service) = "RegionOperations"; } - // Sets the labels on the specified resource. To learn more about labels, read - // the Labeling Resources documentation. + // Sets the labels on the specified resource. To learn more about labels, + // read the + // Labeling Resources documentation. // https://cloud.google.com/compute/docs/reference/rest/v1/forwardingRules/setLabels rpc SetLabels(SetLabelsRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -146,37 +149,64 @@ service ForwardingRules { // Request message for AggregatedListForwardingRules. message AggregatedListForwardingRulesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; // Indicates whether every visible scope for each scope type (zone, region, @@ -188,25 +218,29 @@ message AggregatedListForwardingRulesRequest { // will be included. optional bool include_all_scopes = 2 [json_name = "includeAllScopes"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 3 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 4 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 5 [json_name = "pageToken"]; // Project ID for this request. @@ -214,9 +248,11 @@ message AggregatedListForwardingRulesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; // The Shared VPC service project id or service project number for which @@ -247,14 +283,17 @@ message DeleteForwardingRuleRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; } @@ -271,6 +310,12 @@ message GetForwardingRuleRequest { // Name of the region scoping this request. string region = 3 [(google.api.field_behavior) = REQUIRED, json_name = "region"]; + + // BASIC: The default view of a ForwardingRule, which includes the basic + // fields. + // FULL: The full view, including the ForwardingRule.`attached_extensions` + // field. + optional string view = 4 [json_name = "view"]; } // Request message for InsertForwardingRule. @@ -295,72 +340,106 @@ message InsertForwardingRuleRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; } // Request message for ListForwardingRules. message ListForwardingRulesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -372,9 +451,11 @@ message ListForwardingRulesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "region"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; } @@ -404,14 +485,17 @@ message PatchForwardingRuleRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 5 [json_name = "requestId"]; } @@ -438,14 +522,17 @@ message SetLabelsRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; // Name or id of the resource for this request. @@ -475,14 +562,17 @@ message SetTargetRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; // The TargetReference for this request. diff --git a/protos/google/cloud/compute/future_reservations/v1/future_reservations.proto b/protos/google/cloud/compute/future_reservations/v1/future_reservations.proto index ad2d8a851a1d4..34df7dee46660 100644 --- a/protos/google/cloud/compute/future_reservations/v1/future_reservations.proto +++ b/protos/google/cloud/compute/future_reservations/v1/future_reservations.proto @@ -1,4 +1,4 @@ -// Copyright 2024 Google LLC +// Copyright 2026 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -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: 20260807 syntax = "proto3"; @@ -24,8 +24,8 @@ package google.cloud.cpp.compute.future_reservations.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_043.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_052.proto"; import "google/cloud/extended_operations.proto"; // Service for the futureReservations resource. @@ -37,9 +37,10 @@ service FutureReservations { "https://www.googleapis.com/auth/compute," "https://www.googleapis.com/auth/compute.readonly"; - // Retrieves an aggregated list of future reservations. To prevent failure, - // Google recommends that you set the `returnPartialSuccess` parameter to - // `true`. + // Retrieves an aggregated list of future reservations. + // + // To prevent failure, it is recommended that you set the + // `returnPartialSuccess` parameter to `true`. // https://cloud.google.com/compute/docs/reference/rest/v1/futureReservations/aggregatedList rpc AggregatedListFutureReservations(AggregatedListFutureReservationsRequest) returns (google.cloud.cpp.compute.v1 @@ -123,37 +124,64 @@ service FutureReservations { // Request message for AggregatedListFutureReservations. message AggregatedListFutureReservationsRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; // Indicates whether every visible scope for each scope type (zone, region, @@ -165,25 +193,29 @@ message AggregatedListFutureReservationsRequest { // will be included. optional bool include_all_scopes = 2 [json_name = "includeAllScopes"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 3 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 4 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 5 [json_name = "pageToken"]; // Project ID for this request. @@ -191,9 +223,11 @@ message AggregatedListFutureReservationsRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; // The Shared VPC service project id or service project number for which @@ -217,14 +251,17 @@ message CancelRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // Name of the zone for this request. Name should conform to RFC1035. @@ -250,14 +287,17 @@ message DeleteFutureReservationRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // Name of the zone for this request. Name should conform to RFC1035. @@ -297,14 +337,17 @@ message InsertFutureReservationRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // Name of the zone for this request. Name should conform to RFC1035. @@ -318,58 +361,89 @@ message InsertFutureReservationRequest { // Request message for ListFutureReservations. message ListFutureReservationsRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -377,9 +451,11 @@ message ListFutureReservationsRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 6 [json_name = "returnPartialSuccess"]; // Name of the zone for this request. Name should conform to RFC1035. @@ -405,14 +481,17 @@ message UpdateFutureReservationRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; // update_mask indicates fields to be updated as part of this request. 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 3b3c3ee0067df..78d2922f56891 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: 20250601 +// revision: 20260807 syntax = "proto3"; @@ -24,10 +24,11 @@ package google.cloud.cpp.compute.global_addresses.v1; 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_016.proto"; -import "google/cloud/compute/v1/internal/common_044.proto"; -import "google/cloud/compute/v1/internal/common_046.proto"; +import "google/cloud/compute/v1/internal/common_005.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_054.proto"; +import "google/cloud/compute/v1/internal/common_056.proto"; +import "google/cloud/compute/v1/internal/common_171.proto"; import "google/cloud/extended_operations.proto"; // Service for the globalAddresses resource. @@ -95,8 +96,9 @@ service GlobalAddresses { option (google.cloud.operation_service) = "GlobalOperations"; } - // Sets the labels on a GlobalAddress. To learn more about labels, read the - // Labeling Resources documentation. + // Sets the labels on a GlobalAddress. To learn more about labels, read + // theLabeling + // Resources documentation. // https://cloud.google.com/compute/docs/reference/rest/v1/globalAddresses/setLabels rpc SetLabels(SetLabelsRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -108,6 +110,18 @@ service GlobalAddresses { "project,resource,global_set_labels_request_resource"; option (google.cloud.operation_service) = "GlobalOperations"; } + + // Returns permissions that a caller has on the specified resource. + // https://cloud.google.com/compute/docs/reference/rest/v1/globalAddresses/testIamPermissions + rpc TestIamPermissions(TestIamPermissionsRequest) + returns (google.cloud.cpp.compute.v1.TestPermissionsResponse) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/global/addresses/{resource}/testIamPermissions" + body: "test_permissions_request_resource" + }; + option (google.api.method_signature) = + "project,resource,test_permissions_request_resource"; + } } // Request message for DeleteAddress. @@ -125,14 +139,17 @@ message DeleteAddressRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; } @@ -162,72 +179,106 @@ message InsertAddressRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; } // Request message for ListGlobalAddresses. message ListGlobalAddressesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -235,9 +286,11 @@ message ListGlobalAddressesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 6 [json_name = "returnPartialSuccess"]; } @@ -261,14 +314,17 @@ message MoveRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; } @@ -290,3 +346,18 @@ message SetLabelsRequest { string resource = 3 [(google.api.field_behavior) = REQUIRED, json_name = "resource"]; } + +// Request message for TestIamPermissions. +message TestIamPermissionsRequest { + // Project ID for this request. + string project = 1 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // Name or id of the resource for this request. + string resource = 2 + [(google.api.field_behavior) = REQUIRED, json_name = "resource"]; + + // The TestPermissionsRequest for this request. + optional google.cloud.cpp.compute.v1.TestPermissionsRequest + test_permissions_request_resource = 3 [json_name = "__json_request_body"]; +} 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 ef02447ceeda0..8ab3ec2710139 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: 20250601 +// revision: 20260807 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_016.proto"; -import "google/cloud/compute/v1/internal/common_041.proto"; -import "google/cloud/compute/v1/internal/common_046.proto"; -import "google/cloud/compute/v1/internal/common_140.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_050.proto"; +import "google/cloud/compute/v1/internal/common_056.proto"; +import "google/cloud/compute/v1/internal/common_166.proto"; import "google/cloud/extended_operations.proto"; // Service for the globalForwardingRules resource. @@ -61,8 +61,8 @@ service GlobalForwardingRules { option (google.api.method_signature) = "project,forwarding_rule"; } - // Creates a GlobalForwardingRule resource in the specified project using the - // data included in the request. + // Creates a GlobalForwardingRule resource in the specified project using + // the data included in the request. // https://cloud.google.com/compute/docs/reference/rest/v1/globalForwardingRules/insert rpc InsertForwardingRule(InsertForwardingRuleRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -86,9 +86,10 @@ service GlobalForwardingRules { } // 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. + // request. This method supportsPATCH + // semantics and uses theJSON merge + // patch format and processing rules. Currently, you can only + // patch the network_tier field. // https://cloud.google.com/compute/docs/reference/rest/v1/globalForwardingRules/patch rpc PatchForwardingRule(PatchForwardingRuleRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -101,8 +102,9 @@ service GlobalForwardingRules { option (google.cloud.operation_service) = "GlobalOperations"; } - // Sets the labels on the specified resource. To learn more about labels, read - // the Labeling resources documentation. + // Sets the labels on the specified resource. To learn more about labels, + // read the + // Labeling resources documentation. // https://cloud.google.com/compute/docs/reference/rest/v1/globalForwardingRules/setLabels rpc SetLabels(SetLabelsRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -145,14 +147,17 @@ message DeleteForwardingRuleRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; } @@ -165,6 +170,12 @@ message GetForwardingRuleRequest { // Project ID for this request. string project = 2 [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // BASIC: The default view of a ForwardingRule, which includes the basic + // fields. + // FULL: The full view, including the ForwardingRule.`attached_extensions` + // field. + optional string view = 3 [json_name = "view"]; } // Request message for InsertForwardingRule. @@ -182,72 +193,106 @@ message InsertForwardingRuleRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; } // Request message for ListGlobalForwardingRules. message ListGlobalForwardingRulesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -255,9 +300,11 @@ message ListGlobalForwardingRulesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 6 [json_name = "returnPartialSuccess"]; } @@ -280,14 +327,17 @@ message PatchForwardingRuleRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; } @@ -325,14 +375,17 @@ message SetTargetRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // The TargetReference for this request. 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 ec36a1259e5db..8a236b0314fc9 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: 20250601 +// revision: 20260807 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_012.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_015.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_055.proto"; import "google/cloud/extended_operations.proto"; // Service for the globalNetworkEndpointGroups resource. @@ -88,6 +88,20 @@ service GlobalNetworkEndpointGroups { // Creates a network endpoint group in the specified project using the // parameters that are included in the request. + // + // Note: Use the following APIs to manage network endpoint groups: + // + // - + // To manage NEGs with zonal scope (such as zonal NEGs, hybrid connectivity + // NEGs): zonal + // API + // - + // To manage NEGs with regional scope (such as regional internet NEGs, + // serverless NEGs, Private Service Connect NEGs): regional + // API + // - + // To manage NEGs with global scope (such as global internet NEGs):global + // API // https://cloud.google.com/compute/docs/reference/rest/v1/globalNetworkEndpointGroups/insert rpc InsertNetworkEndpointGroup(InsertNetworkEndpointGroupRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -147,14 +161,17 @@ message AttachNetworkEndpointsRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; } @@ -176,14 +193,17 @@ message DeleteNetworkEndpointGroupRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; } @@ -211,14 +231,17 @@ message DetachNetworkEndpointsRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; } @@ -250,72 +273,106 @@ message InsertNetworkEndpointGroupRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; } // Request message for ListGlobalNetworkEndpointGroups. message ListGlobalNetworkEndpointGroupsRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -323,53 +380,82 @@ message ListGlobalNetworkEndpointGroupsRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 6 [json_name = "returnPartialSuccess"]; } // Request message for ListNetworkEndpoints. message ListNetworkEndpointsRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; // The name of the network endpoint group from which you want to generate a @@ -379,18 +465,22 @@ message ListNetworkEndpointsRequest { json_name = "networkEndpointGroup" ]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 4 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 5 [json_name = "pageToken"]; // Project ID for this request. @@ -398,8 +488,10 @@ message ListNetworkEndpointsRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; } 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 444be27258112..09d474680f526 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: 20250601 +// revision: 20260807 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_016.proto"; -import "google/cloud/compute/v1/internal/common_091.proto"; -import "google/cloud/compute/v1/internal/common_092.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_106.proto"; +import "google/cloud/compute/v1/internal/common_107.proto"; import "google/cloud/extended_operations.proto"; import "google/protobuf/empty.proto"; @@ -39,8 +39,10 @@ service GlobalOperations { "https://www.googleapis.com/auth/compute," "https://www.googleapis.com/auth/compute.readonly"; - // Retrieves an aggregated list of all operations. To prevent failure, Google - // recommends that you set the `returnPartialSuccess` parameter to `true`. + // Retrieves an aggregated list of all operations. + // + // To prevent failure, Google recommends that you set the + // `returnPartialSuccess` parameter to `true`. // https://cloud.google.com/compute/docs/reference/rest/v1/globalOperations/aggregatedList rpc AggregatedListGlobalOperations(AggregatedListGlobalOperationsRequest) returns (google.cloud.cpp.compute.v1.OperationAggregatedList) { @@ -80,17 +82,24 @@ service GlobalOperations { option (google.api.method_signature) = "project"; } - // 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`. + // 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`. // https://cloud.google.com/compute/docs/reference/rest/v1/globalOperations/wait rpc Wait(WaitRequest) returns (google.cloud.cpp.compute.v1.Operation) { option (google.api.http) = { @@ -104,37 +113,64 @@ service GlobalOperations { // Request message for AggregatedListGlobalOperations. message AggregatedListGlobalOperationsRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; // Indicates whether every visible scope for each scope type (zone, region, @@ -146,25 +182,29 @@ message AggregatedListGlobalOperationsRequest { // will be included. optional bool include_all_scopes = 2 [json_name = "includeAllScopes"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 3 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 4 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 5 [json_name = "pageToken"]; // Project ID for this request. @@ -172,9 +212,11 @@ message AggregatedListGlobalOperationsRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; // The Shared VPC service project id or service project number for which @@ -213,58 +255,89 @@ message GetOperationRequest { // Request message for ListGlobalOperations. message ListGlobalOperationsRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -272,9 +345,11 @@ message ListGlobalOperationsRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 6 [json_name = "returnPartialSuccess"]; } 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 cef0db53b27b6..b31b8ff477d3d 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: 20250601 +// revision: 20260807 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_016.proto"; -import "google/cloud/compute/v1/internal/common_092.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_107.proto"; import "google/cloud/extended_operations.proto"; import "google/protobuf/empty.proto"; @@ -47,8 +47,8 @@ service GlobalOrganizationOperations { option (google.api.method_signature) = "operation"; } - // Retrieves the specified Operations resource. Gets a list of operations by - // making a `list()` request. + // Retrieves the specified Operations resource. Gets a list of operations + // by making a `list()` request. // https://cloud.google.com/compute/docs/reference/rest/v1/globalOrganizationOperations/get rpc GetOperation(GetOperationRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -82,78 +82,111 @@ message DeleteOperationRequest { // Request message for GetOperation. message GetOperationRequest { - // Name of the Operations resource to return, or its unique numeric - // identifier. + // Name of the Operations resource to return. Parent is derived from this + // field. string operation = 1 [(google.api.field_behavior) = REQUIRED, json_name = "operation"]; - // Parent ID for this request. + // Parent ID for this request. Not used. Parent is derived from resource_id. optional string parent_id = 2 [json_name = "parentId"]; } // Request message for ListGlobalOrganizationOperations. message ListGlobalOrganizationOperationsRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Parent ID for this request. optional string parent_id = 5 [json_name = "parentId"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 6 [json_name = "returnPartialSuccess"]; } 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 5e9516821c728..81495ad704b78 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: 20250601 +// revision: 20260807 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_016.proto"; -import "google/cloud/compute/v1/internal/common_096.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_113.proto"; import "google/cloud/extended_operations.proto"; // Service for the globalPublicDelegatedPrefixes resource. @@ -84,8 +84,9 @@ service GlobalPublicDelegatedPrefixes { } // 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. + // included in the request. This method supportsPATCH + // semantics and usesJSON merge + // patch format and processing rules. // https://cloud.google.com/compute/docs/reference/rest/v1/globalPublicDelegatedPrefixes/patch rpc PatchPublicDelegatedPrefix(PatchPublicDelegatedPrefixRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -116,14 +117,17 @@ message DeletePublicDelegatedPrefixRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; } @@ -155,72 +159,106 @@ message InsertPublicDelegatedPrefixRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; } // Request message for ListGlobalPublicDelegatedPrefixes. message ListGlobalPublicDelegatedPrefixesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -228,9 +266,11 @@ message ListGlobalPublicDelegatedPrefixesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 6 [json_name = "returnPartialSuccess"]; } @@ -255,13 +295,16 @@ message PatchPublicDelegatedPrefixRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; } diff --git a/protos/google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies.proto b/protos/google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies.proto new file mode 100644 index 0000000000000..94aa73def18bd --- /dev/null +++ b/protos/google/cloud/compute/global_vm_extension_policies/v1/global_vm_extension_policies.proto @@ -0,0 +1,451 @@ +// Copyright 2026 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: 20260807 + +syntax = "proto3"; + +package google.cloud.cpp.compute.global_vm_extension_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_019.proto"; +import "google/cloud/compute/v1/internal/common_058.proto"; +import "google/cloud/extended_operations.proto"; + +// Service for the globalVmExtensionPolicies resource. +// https://cloud.google.com/compute/docs/reference/rest/v1/globalVmExtensionPolicies +service GlobalVmExtensionPolicies { + option (google.api.default_host) = "compute.googleapis.com"; + option (google.api.oauth_scopes) = + "https://www.googleapis.com/auth/cloud-platform," + "https://www.googleapis.com/auth/compute," + "https://www.googleapis.com/auth/compute.readonly"; + + // Retrieves the list of all VM Extension Policy resources + // available to the specified project. + // + // To prevent failure, it's recommended that you set the + // `returnPartialSuccess` parameter to `true`. + // https://cloud.google.com/compute/docs/reference/rest/v1/globalVmExtensionPolicies/aggregatedList + rpc AggregatedListGlobalVmExtensionPolicies( + AggregatedListGlobalVmExtensionPoliciesRequest) + returns ( + google.cloud.cpp.compute.v1.VmExtensionPolicyAggregatedListResponse) { + option (google.api.http) = { + get: "/compute/v1/projects/{project}/aggregated/vmExtensionPolicies" + }; + option (google.api.method_signature) = "project"; + } + + // Purge scoped resources (zonal policies) from a global VM extension + // policy, and then delete the global VM extension policy. Purge of the scoped + // resources is a pre-condition of the global VM extension policy deletion. + // The deletion of the global VM extension policy happens after the purge + // rollout is done, so it's not a part of the LRO. It's an automatic process + // that triggers in the backend. + // https://cloud.google.com/compute/docs/reference/rest/v1/globalVmExtensionPolicies/delete + rpc DeleteGlobalVmExtensionPolicy(DeleteGlobalVmExtensionPolicyRequest) + returns (google.cloud.cpp.compute.v1.Operation) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/global/vmExtensionPolicies/{global_vm_extension_policy}/delete" + body: "global_vm_extension_policy_rollout_operation_rollout_input_resource" + }; + option (google.api.method_signature) = + "project,global_vm_extension_policy,global_vm_extension_policy_rollout_operation_rollout_input_resource"; + option (google.cloud.operation_service) = "GlobalOperations"; + } + + // Gets details of a global VM extension policy. + // https://cloud.google.com/compute/docs/reference/rest/v1/globalVmExtensionPolicies/get + rpc GetGlobalVmExtensionPolicy(GetGlobalVmExtensionPolicyRequest) + returns (google.cloud.cpp.compute.v1.GlobalVmExtensionPolicy) { + option (google.api.http) = { + get: "/compute/v1/projects/{project}/global/vmExtensionPolicies/{global_vm_extension_policy}" + }; + option (google.api.method_signature) = "project,global_vm_extension_policy"; + } + + // Creates a new project level GlobalVmExtensionPolicy. + // https://cloud.google.com/compute/docs/reference/rest/v1/globalVmExtensionPolicies/insert + rpc InsertGlobalVmExtensionPolicy(InsertGlobalVmExtensionPolicyRequest) + returns (google.cloud.cpp.compute.v1.Operation) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/global/vmExtensionPolicies" + body: "global_vm_extension_policy_resource" + }; + option (google.api.method_signature) = + "project,global_vm_extension_policy_resource"; + option (google.cloud.operation_service) = "GlobalOperations"; + } + + // Lists global VM extension policies. + // https://cloud.google.com/compute/docs/reference/rest/v1/globalVmExtensionPolicies/list + rpc ListGlobalVmExtensionPolicies(ListGlobalVmExtensionPoliciesRequest) + returns (google.cloud.cpp.compute.v1.GlobalVmExtensionPolicyList) { + option (google.api.http) = { + get: "/compute/v1/projects/{project}/global/vmExtensionPolicies" + }; + option (google.api.method_signature) = "project"; + } + + // Updates a global VM extension policy. + // https://cloud.google.com/compute/docs/reference/rest/v1/globalVmExtensionPolicies/update + rpc UpdateGlobalVmExtensionPolicy(UpdateGlobalVmExtensionPolicyRequest) + returns (google.cloud.cpp.compute.v1.Operation) { + option (google.api.http) = { + patch: "/compute/v1/projects/{project}/global/vmExtensionPolicies/{global_vm_extension_policy}" + body: "global_vm_extension_policy_resource" + }; + option (google.api.method_signature) = + "project,global_vm_extension_policy,global_vm_extension_policy_resource"; + option (google.cloud.operation_service) = "GlobalOperations"; + } +} + +// Request message for AggregatedListGlobalVmExtensionPolicies. +message AggregatedListGlobalVmExtensionPoliciesRequest { + // A filter expression that filters resources listed in the response. Most + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. + optional string filter = 1 [json_name = "filter"]; + + // 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. + optional bool include_all_scopes = 2 [json_name = "includeAllScopes"]; + + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) + optional uint32 max_results = 3 [json_name = "maxResults"]; + + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or + // `creationTimestamp desc` is supported. + optional string order_by = 4 [json_name = "orderBy"]; + + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. + optional string page_token = 5 [json_name = "pageToken"]; + + // Name of the project scoping this request. + string project = 6 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // Opt-in for partial success behavior which provides partial results in case + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. + optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; + + // The Shared VPC service project id or service project number for which + // aggregated list request is invoked for subnetworks list-usable api. + optional string service_project_number = 8 + [json_name = "serviceProjectNumber"]; +} + +// Request message for DeleteGlobalVmExtensionPolicy. +message DeleteGlobalVmExtensionPolicyRequest { + // Name of the global VM extension policy to purge scoped resources for. + string global_vm_extension_policy = 1 [ + (google.api.field_behavior) = REQUIRED, + json_name = "globalVmExtensionPolicy" + ]; + + // The GlobalVmExtensionPolicyRolloutOperationRolloutInput for this request. + optional google.cloud.cpp.compute.v1 + .GlobalVmExtensionPolicyRolloutOperationRolloutInput + global_vm_extension_policy_rollout_operation_rollout_input_resource = + 2 [json_name = "__json_request_body"]; + + // Project ID for this request. + string project = 3 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "project", + json_name = "project" + ]; + + // An optional request ID to identify requests. Specify a unique request ID so + // that if you must retry your request, the server will know to ignore the + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). + optional string request_id = 4 [json_name = "requestId"]; +} + +// Request message for GetGlobalVmExtensionPolicy. +message GetGlobalVmExtensionPolicyRequest { + // Name of the GlobalVmExtensionPolicy resource to return. + string global_vm_extension_policy = 1 [ + (google.api.field_behavior) = REQUIRED, + json_name = "globalVmExtensionPolicy" + ]; + + // Project ID for this request. + string project = 2 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; +} + +// Request message for InsertGlobalVmExtensionPolicy. +message InsertGlobalVmExtensionPolicyRequest { + // The GlobalVmExtensionPolicy for this request. + optional google.cloud.cpp.compute.v1.GlobalVmExtensionPolicy + global_vm_extension_policy_resource = 1 + [json_name = "__json_request_body"]; + + // Project ID for this request. + string project = 2 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "project", + json_name = "project" + ]; + + // An optional request ID to identify requests. Specify a unique request ID so + // that if you must retry your request, the server will know to ignore the + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). + optional string request_id = 3 [json_name = "requestId"]; +} + +// Request message for ListGlobalVmExtensionPolicies. +message ListGlobalVmExtensionPoliciesRequest { + // A filter expression that filters resources listed in the response. Most + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. + optional string filter = 1 [json_name = "filter"]; + + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) + optional uint32 max_results = 2 [json_name = "maxResults"]; + + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or + // `creationTimestamp desc` is supported. + optional string order_by = 3 [json_name = "orderBy"]; + + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. + optional string page_token = 4 [json_name = "pageToken"]; + + // Project ID for this request. + string project = 5 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // Opt-in for partial success behavior which provides partial results in case + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. + optional bool return_partial_success = 6 [json_name = "returnPartialSuccess"]; +} + +// Request message for UpdateGlobalVmExtensionPolicy. +message UpdateGlobalVmExtensionPolicyRequest { + // Name of the global VM extension policy to update. + string global_vm_extension_policy = 1 [ + (google.api.field_behavior) = REQUIRED, + json_name = "globalVmExtensionPolicy" + ]; + + // The GlobalVmExtensionPolicy for this request. + optional google.cloud.cpp.compute.v1.GlobalVmExtensionPolicy + global_vm_extension_policy_resource = 2 + [json_name = "__json_request_body"]; + + // Project ID for this request. + string project = 3 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "project", + json_name = "project" + ]; + + // An optional request ID to identify requests. Specify a unique request ID so + // that if you must retry your request, the server will know to ignore the + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). + optional string request_id = 4 [json_name = "requestId"]; +} 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 b5e923a2e401d..d414128776133 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: 20250601 +// revision: 20260807 syntax = "proto3"; @@ -24,9 +24,10 @@ 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_016.proto"; -import "google/cloud/compute/v1/internal/common_043.proto"; -import "google/cloud/compute/v1/internal/common_051.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_053.proto"; +import "google/cloud/compute/v1/internal/common_063.proto"; +import "google/cloud/compute/v1/internal/common_171.proto"; import "google/cloud/extended_operations.proto"; // Service for the healthChecks resource. @@ -39,8 +40,10 @@ service HealthChecks { "https://www.googleapis.com/auth/compute.readonly"; // 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`. + // available to the specified project. + // + // To prevent failure, Google recommends that you set the + // `returnPartialSuccess` parameter to `true`. // https://cloud.google.com/compute/docs/reference/rest/v1/healthChecks/aggregatedList rpc AggregatedListHealthChecks(AggregatedListHealthChecksRequest) returns (google.cloud.cpp.compute.v1.HealthChecksAggregatedList) { @@ -96,8 +99,9 @@ service HealthChecks { } // 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. + // included in the request. This method supportsPATCH + // semantics and uses theJSON merge + // patch format and processing rules. // https://cloud.google.com/compute/docs/reference/rest/v1/healthChecks/patch rpc PatchHealthCheck(PatchHealthCheckRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -110,6 +114,18 @@ service HealthChecks { option (google.cloud.operation_service) = "GlobalOperations"; } + // Returns permissions that a caller has on the specified resource. + // https://cloud.google.com/compute/docs/reference/rest/v1/healthChecks/testIamPermissions + rpc TestIamPermissions(TestIamPermissionsRequest) + returns (google.cloud.cpp.compute.v1.TestPermissionsResponse) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/global/healthChecks/{resource}/testIamPermissions" + body: "test_permissions_request_resource" + }; + option (google.api.method_signature) = + "project,resource,test_permissions_request_resource"; + } + // Updates a HealthCheck resource in the specified project using the data // included in the request. // https://cloud.google.com/compute/docs/reference/rest/v1/healthChecks/update @@ -128,37 +144,64 @@ service HealthChecks { // Request message for AggregatedListHealthChecks. message AggregatedListHealthChecksRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; // Indicates whether every visible scope for each scope type (zone, region, @@ -170,25 +213,29 @@ message AggregatedListHealthChecksRequest { // will be included. optional bool include_all_scopes = 2 [json_name = "includeAllScopes"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 3 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 4 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 5 [json_name = "pageToken"]; // Name of the project scoping this request. @@ -196,9 +243,11 @@ message AggregatedListHealthChecksRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; // The Shared VPC service project id or service project number for which @@ -222,14 +271,17 @@ message DeleteHealthCheckRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; } @@ -259,72 +311,106 @@ message InsertHealthCheckRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; } // Request message for ListHealthChecks. message ListHealthChecksRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -332,9 +418,11 @@ message ListHealthChecksRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 6 [json_name = "returnPartialSuccess"]; } @@ -357,17 +445,35 @@ message PatchHealthCheckRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; } +// Request message for TestIamPermissions. +message TestIamPermissionsRequest { + // Project ID for this request. + string project = 1 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // Name or id of the resource for this request. + string resource = 2 + [(google.api.field_behavior) = REQUIRED, json_name = "resource"]; + + // The TestPermissionsRequest for this request. + optional google.cloud.cpp.compute.v1.TestPermissionsRequest + test_permissions_request_resource = 3 [json_name = "__json_request_body"]; +} + // Request message for UpdateHealthCheck. message UpdateHealthCheckRequest { // Name of the HealthCheck resource to update. @@ -387,13 +493,16 @@ message UpdateHealthCheckRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; } diff --git a/protos/google/cloud/compute/hosts/v1/hosts.proto b/protos/google/cloud/compute/hosts/v1/hosts.proto new file mode 100644 index 0000000000000..d5707c707e547 --- /dev/null +++ b/protos/google/cloud/compute/hosts/v1/hosts.proto @@ -0,0 +1,242 @@ +// Copyright 2026 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: 20260807 + +syntax = "proto3"; + +package google.cloud.cpp.compute.hosts.v1; + +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_066.proto"; +import "google/cloud/extended_operations.proto"; + +// Service for the hosts resource. +// https://cloud.google.com/compute/docs/reference/rest/v1/hosts +service Hosts { + option (google.api.default_host) = "compute.googleapis.com"; + option (google.api.oauth_scopes) = + "https://www.googleapis.com/auth/cloud-platform," + "https://www.googleapis.com/auth/compute," + "https://www.googleapis.com/auth/compute.readonly"; + + // Retrieves information about the specified host. + // https://cloud.google.com/compute/docs/reference/rest/v1/hosts/get + rpc GetHost(GetHostRequest) returns (google.cloud.cpp.compute.v1.Host) { + option (google.api.http) = { + get: "/compute/v1/projects/{project}/zones/{zone}/{association}/hosts/{host}" + }; + option (google.api.method_signature) = "project,zone,association,host"; + } + + // Allows customers to get SBOM versions of a host. + // https://cloud.google.com/compute/docs/reference/rest/v1/hosts/getVersion + rpc GetVersion(GetVersionRequest) + returns (google.cloud.cpp.compute.v1.Operation) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/zones/{zone}/{association}/hosts/{host}/getVersion" + body: "hosts_get_version_request_resource" + }; + option (google.api.method_signature) = + "project,zone,association,host,hosts_get_version_request_resource"; + option (google.cloud.operation_service) = "ZoneOperations"; + } + + // Retrieves a list of hosts. + // https://cloud.google.com/compute/docs/reference/rest/v1/hosts/list + rpc ListHosts(ListHostsRequest) + returns (google.cloud.cpp.compute.v1.HostsListResponse) { + option (google.api.http) = { + get: "/compute/v1/projects/{project}/zones/{zone}/{association}/hosts" + }; + option (google.api.method_signature) = "project,zone,association"; + } +} + +// Request message for GetHost. +message GetHostRequest { + // The parent resource association for the Host. This field specifies the + // hierarchical context (e.g., reservation, block, sub-block) when + // accessing the host. For example, reservations/reservation_name, + // reservations/reservation_name/reservationBlocks/reservation_block_name or + // reservations/reservation_name/reservationBlocks/reservation_block_name/reservationSubBlocks/reservation_sub_block_name. + string association = 1 + [(google.api.field_behavior) = REQUIRED, json_name = "association"]; + + // The name of the host, formatted as RFC1035 or a resource ID + // number. + string host = 2 [(google.api.field_behavior) = REQUIRED, json_name = "host"]; + + // The project ID for this request. + string project = 3 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // The name of the zone for this request, formatted as RFC1035. + string zone = 4 [(google.api.field_behavior) = REQUIRED, json_name = "zone"]; +} + +// Request message for GetVersion. +message GetVersionRequest { + // The parent resource association for the Host. This field specifies the + // hierarchical context (e.g., reservation, block, sub-block) when + // accessing the host. + string association = 1 + [(google.api.field_behavior) = REQUIRED, json_name = "association"]; + + // The name of the host, formatted as RFC1035 or a resource ID + // number. + string host = 2 [(google.api.field_behavior) = REQUIRED, json_name = "host"]; + + // The HostsGetVersionRequest for this request. + optional google.cloud.cpp.compute.v1.HostsGetVersionRequest + hosts_get_version_request_resource = 3 + [json_name = "__json_request_body"]; + + // Project ID for this request. + string project = 4 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "project", + json_name = "project" + ]; + + // An optional request ID to identify requests. Specify a unique request ID so + // that if you must retry your request, the server will know to ignore the + // request if it has already been completed. + optional string request_id = 5 [json_name = "requestId"]; + + // Name of the zone for this request. Zone name should conform to RFC1035. + string zone = 6 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "zone", + json_name = "zone" + ]; +} + +// Request message for ListHosts. +message ListHostsRequest { + // The parent resource association for the Host. This field specifies the + // hierarchical context (e.g., reservation, block, sub-block) when + // accessing the host. For example, reservations/reservation_name, + // reservations/reservation_name/reservationBlocks/reservation_block_name or + // reservations/reservation_name/reservationBlocks/reservation_block_name/reservationSubBlocks/reservation_sub_block_name. + string association = 1 + [(google.api.field_behavior) = REQUIRED, json_name = "association"]; + + // A filter expression that filters resources listed in the response. Most + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. + optional string filter = 2 [json_name = "filter"]; + + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) + optional uint32 max_results = 3 [json_name = "maxResults"]; + + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or + // `creationTimestamp desc` is supported. + optional string order_by = 4 [json_name = "orderBy"]; + + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. + optional string page_token = 5 [json_name = "pageToken"]; + + // The project ID for this request. + string project = 6 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // Opt-in for partial success behavior which provides partial results in case + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. + optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; + + // The name of the zone for this request, formatted as RFC1035. + string zone = 8 [(google.api.field_behavior) = REQUIRED, json_name = "zone"]; +} 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 7a1465990e447..4bbd97a085ec8 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: 20250601 +// revision: 20260807 syntax = "proto3"; @@ -24,8 +24,9 @@ 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_016.proto"; -import "google/cloud/compute/v1/internal/common_053.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_067.proto"; +import "google/cloud/compute/v1/internal/common_171.proto"; import "google/cloud/extended_operations.proto"; // Service for the httpHealthChecks resource. @@ -83,8 +84,9 @@ service HttpHealthChecks { } // 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. + // included in the request. This method supportsPATCH + // semantics and uses theJSON merge + // patch format and processing rules. // https://cloud.google.com/compute/docs/reference/rest/v1/httpHealthChecks/patch rpc PatchHttpHealthCheck(PatchHttpHealthCheckRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -97,6 +99,18 @@ service HttpHealthChecks { option (google.cloud.operation_service) = "GlobalOperations"; } + // Returns permissions that a caller has on the specified resource. + // https://cloud.google.com/compute/docs/reference/rest/v1/httpHealthChecks/testIamPermissions + rpc TestIamPermissions(TestIamPermissionsRequest) + returns (google.cloud.cpp.compute.v1.TestPermissionsResponse) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/global/httpHealthChecks/{resource}/testIamPermissions" + body: "test_permissions_request_resource" + }; + option (google.api.method_signature) = + "project,resource,test_permissions_request_resource"; + } + // Updates a HttpHealthCheck resource in the specified project using the data // included in the request. // https://cloud.google.com/compute/docs/reference/rest/v1/httpHealthChecks/update @@ -127,14 +141,17 @@ message DeleteHttpHealthCheckRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; } @@ -164,72 +181,106 @@ message InsertHttpHealthCheckRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; } // Request message for ListHttpHealthChecks. message ListHttpHealthChecksRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -237,9 +288,11 @@ message ListHttpHealthChecksRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 6 [json_name = "returnPartialSuccess"]; } @@ -262,17 +315,35 @@ message PatchHttpHealthCheckRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; } +// Request message for TestIamPermissions. +message TestIamPermissionsRequest { + // Project ID for this request. + string project = 1 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // Name or id of the resource for this request. + string resource = 2 + [(google.api.field_behavior) = REQUIRED, json_name = "resource"]; + + // The TestPermissionsRequest for this request. + optional google.cloud.cpp.compute.v1.TestPermissionsRequest + test_permissions_request_resource = 3 [json_name = "__json_request_body"]; +} + // Request message for UpdateHttpHealthCheck. message UpdateHttpHealthCheckRequest { // Name of the HttpHealthCheck resource to update. @@ -292,13 +363,16 @@ message UpdateHttpHealthCheckRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; } 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 dfd3ce4539043..4bdda5b66893d 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: 20250601 +// revision: 20260807 syntax = "proto3"; @@ -24,8 +24,9 @@ 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_016.proto"; -import "google/cloud/compute/v1/internal/common_054.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_068.proto"; +import "google/cloud/compute/v1/internal/common_171.proto"; import "google/cloud/extended_operations.proto"; // Service for the httpsHealthChecks resource. @@ -84,8 +85,9 @@ service HttpsHealthChecks { } // 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. + // included in the request. This method supportsPATCH + // semantics and uses theJSON merge + // patch format and processing rules. // https://cloud.google.com/compute/docs/reference/rest/v1/httpsHealthChecks/patch rpc PatchHttpsHealthCheck(PatchHttpsHealthCheckRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -98,6 +100,18 @@ service HttpsHealthChecks { option (google.cloud.operation_service) = "GlobalOperations"; } + // Returns permissions that a caller has on the specified resource. + // https://cloud.google.com/compute/docs/reference/rest/v1/httpsHealthChecks/testIamPermissions + rpc TestIamPermissions(TestIamPermissionsRequest) + returns (google.cloud.cpp.compute.v1.TestPermissionsResponse) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/global/httpsHealthChecks/{resource}/testIamPermissions" + body: "test_permissions_request_resource" + }; + option (google.api.method_signature) = + "project,resource,test_permissions_request_resource"; + } + // Updates a HttpsHealthCheck resource in the specified project using the data // included in the request. // https://cloud.google.com/compute/docs/reference/rest/v1/httpsHealthChecks/update @@ -128,14 +142,17 @@ message DeleteHttpsHealthCheckRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; } @@ -165,72 +182,106 @@ message InsertHttpsHealthCheckRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; } // Request message for ListHttpsHealthChecks. message ListHttpsHealthChecksRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -238,9 +289,11 @@ message ListHttpsHealthChecksRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 6 [json_name = "returnPartialSuccess"]; } @@ -263,17 +316,35 @@ message PatchHttpsHealthCheckRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; } +// Request message for TestIamPermissions. +message TestIamPermissionsRequest { + // Project ID for this request. + string project = 1 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // Name or id of the resource for this request. + string resource = 2 + [(google.api.field_behavior) = REQUIRED, json_name = "resource"]; + + // The TestPermissionsRequest for this request. + optional google.cloud.cpp.compute.v1.TestPermissionsRequest + test_permissions_request_resource = 3 [json_name = "__json_request_body"]; +} + // Request message for UpdateHttpsHealthCheck. message UpdateHttpsHealthCheckRequest { // Name of the HttpsHealthCheck resource to update. @@ -293,13 +364,16 @@ message UpdateHttpsHealthCheckRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; } 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 2514bdf3462bd..6db7402664c1c 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: 20250601 +// revision: 20260807 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_070.proto"; // Service for the imageFamilyViews resource. // https://cloud.google.com/compute/docs/reference/rest/v1/imageFamilyViews @@ -35,8 +35,8 @@ service ImageFamilyViews { "https://www.googleapis.com/auth/compute," "https://www.googleapis.com/auth/compute.readonly"; - // Returns the latest image that is part of an image family, is not deprecated - // and is rolled out in the specified zone. + // Returns the latest image that is part of an image family, is not + // deprecated and is rolled out in the specified zone. // https://cloud.google.com/compute/docs/reference/rest/v1/imageFamilyViews/get rpc GetImageFamilyView(GetImageFamilyViewRequest) returns (google.cloud.cpp.compute.v1.ImageFamilyView) { diff --git a/protos/google/cloud/compute/images/v1/images.proto b/protos/google/cloud/compute/images/v1/images.proto index fe9f9ea106964..30e7a14d3e825 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: 20250601 +// revision: 20260807 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_007.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_046.proto"; -import "google/cloud/compute/v1/internal/common_047.proto"; -import "google/cloud/compute/v1/internal/common_055.proto"; +import "google/cloud/compute/v1/internal/common_009.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_032.proto"; +import "google/cloud/compute/v1/internal/common_056.proto"; import "google/cloud/compute/v1/internal/common_057.proto"; -import "google/cloud/compute/v1/internal/common_145.proto"; +import "google/cloud/compute/v1/internal/common_069.proto"; +import "google/cloud/compute/v1/internal/common_071.proto"; +import "google/cloud/compute/v1/internal/common_171.proto"; import "google/cloud/extended_operations.proto"; // Service for the images resource. @@ -41,10 +41,7 @@ service Images { option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform," "https://www.googleapis.com/auth/compute," - "https://www.googleapis.com/auth/compute.readonly," - "https://www.googleapis.com/auth/devstorage.full_control," - "https://www.googleapis.com/auth/devstorage.read_only," - "https://www.googleapis.com/auth/devstorage.read_write"; + "https://www.googleapis.com/auth/compute.readonly"; // Deletes the specified image. // https://cloud.google.com/compute/docs/reference/rest/v1/images/delete @@ -57,8 +54,9 @@ service Images { option (google.cloud.operation_service) = "GlobalOperations"; } - // Sets the deprecation status of an image. If an empty request body is given, - // clears the deprecation status instead. + // Sets the deprecation status of an image. + // + // If an empty request body is given, clears the deprecation status instead. // https://cloud.google.com/compute/docs/reference/rest/v1/images/deprecate rpc Deprecate(DeprecateRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -81,8 +79,8 @@ service Images { } // 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. + // deprecated. For more information on image families, seePublic + // image families documentation. // https://cloud.google.com/compute/docs/reference/rest/v1/images/getFromFamily rpc GetFromFamily(GetFromFamilyRequest) returns (google.cloud.cpp.compute.v1.Image) { @@ -103,8 +101,8 @@ service Images { option (google.api.method_signature) = "project,resource"; } - // Creates an image in the specified project using the data included in the - // request. + // Creates an image in the specified project using the data included + // in the request. // https://cloud.google.com/compute/docs/reference/rest/v1/images/insert rpc InsertImage(InsertImageRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -116,12 +114,13 @@ service Images { option (google.cloud.operation_service) = "GlobalOperations"; } - // 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. + // 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. // https://cloud.google.com/compute/docs/reference/rest/v1/images/list rpc ListImages(ListImagesRequest) returns (google.cloud.cpp.compute.v1.ImageList) { @@ -131,8 +130,9 @@ service Images { option (google.api.method_signature) = "project"; } - // Patches the specified image with the data included in the request. Only the - // following fields can be modified: family, description, deprecation status. + // Patches the specified image with the data included in the request. + // Only the following fields can be modified: family, description, + // deprecation status. // https://cloud.google.com/compute/docs/reference/rest/v1/images/patch rpc PatchImage(PatchImageRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -144,8 +144,8 @@ service Images { option (google.cloud.operation_service) = "GlobalOperations"; } - // Sets the access control policy on the specified resource. Replaces any - // existing policy. + // Sets the access control policy on the specified resource. + // Replaces any existing policy. // https://cloud.google.com/compute/docs/reference/rest/v1/images/setIamPolicy rpc SetIamPolicy(SetIamPolicyRequest) returns (google.cloud.cpp.compute.v1.Policy) { @@ -157,7 +157,7 @@ service Images { "project,resource,global_set_policy_request_resource"; } - // Sets the labels on an image. To learn more about labels, read the Labeling + // Sets the labels on an image. To learn more about labels, read theLabeling // Resources documentation. // https://cloud.google.com/compute/docs/reference/rest/v1/images/setLabels rpc SetLabels(SetLabelsRequest) @@ -199,14 +199,17 @@ message DeleteImageRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; } @@ -229,14 +232,17 @@ message DeprecateRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; } @@ -296,72 +302,106 @@ message InsertImageRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; } // Request message for ListImages. message ListImagesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -369,9 +409,11 @@ message ListImagesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 6 [json_name = "returnPartialSuccess"]; } @@ -394,14 +436,17 @@ message PatchImageRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; } 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 9a83b495bea0a..2fb3225cd91d6 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: 20250601 +// revision: 20260807 syntax = "proto3"; @@ -24,8 +24,9 @@ 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_016.proto"; -import "google/cloud/compute/v1/internal/common_062.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_076.proto"; +import "google/cloud/compute/v1/internal/common_077.proto"; import "google/cloud/extended_operations.proto"; // Service for the instanceGroupManagerResizeRequests resource. @@ -79,8 +80,8 @@ service InstanceGroupManagerResizeRequests { "project,zone,instance_group_manager,resize_request"; } - // Creates a new resize request that starts provisioning VMs immediately or - // queues VM creation. + // Creates a new resize request that starts provisioning VMs immediately + // or queues VM creation. // https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagerResizeRequests/insert rpc InsertInstanceGroupManagerResizeRequest( InsertInstanceGroupManagerResizeRequestRequest) @@ -94,8 +95,8 @@ service InstanceGroupManagerResizeRequests { option (google.cloud.operation_service) = "ZoneOperations"; } - // Retrieves a list of resize requests that are contained in the managed - // instance group. + // Retrieves a list of resize requests that are contained in the + // managed instance group. // https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagerResizeRequests/list rpc ListInstanceGroupManagerResizeRequests( ListInstanceGroupManagerResizeRequestsRequest) @@ -111,8 +112,8 @@ service InstanceGroupManagerResizeRequests { // Request message for Cancel. message CancelRequest { - // The name of the managed instance group. The name should conform to RFC1035 - // or be a resource ID. + // The name of the managed instance group. + // The name should conform to RFC1035 or be a resource ID. string instance_group_manager = 1 [ (google.api.field_behavior) = REQUIRED, json_name = "instanceGroupManager" @@ -127,23 +128,26 @@ message CancelRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; - // The name of the resize request to cancel. The name should conform to - // RFC1035 or be a resource ID. + // The name of the resize request to cancel. + // The name should conform to RFC1035 or be a resource ID. string resize_request = 4 [(google.api.field_behavior) = REQUIRED, json_name = "resizeRequest"]; - // The name of the zone where the managed instance group is located. The name - // should conform to RFC1035. + // The name of thezone where the managed + // instance group is located. The name should conform to RFC1035. string zone = 5 [ (google.api.field_behavior) = REQUIRED, (google.cloud.operation_request_field) = "zone", @@ -153,8 +157,8 @@ message CancelRequest { // Request message for DeleteInstanceGroupManagerResizeRequest. message DeleteInstanceGroupManagerResizeRequestRequest { - // The name of the managed instance group. The name should conform to RFC1035 - // or be a resource ID. + // The name of the managed instance group. + // The name should conform to RFC1035 or be a resource ID. string instance_group_manager = 1 [ (google.api.field_behavior) = REQUIRED, json_name = "instanceGroupManager" @@ -169,23 +173,26 @@ message DeleteInstanceGroupManagerResizeRequestRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; - // The name of the resize request to delete. The name should conform to - // RFC1035 or be a resource ID. + // The name of the resize request to delete. + // The name should conform to RFC1035 or be a resource ID. string resize_request = 4 [(google.api.field_behavior) = REQUIRED, json_name = "resizeRequest"]; - // The name of the zone where the managed instance group is located. The name - // should conform to RFC1035. + // The name of thezone where the managed + // instance group is located. The name should conform to RFC1035. string zone = 5 [ (google.api.field_behavior) = REQUIRED, (google.cloud.operation_request_field) = "zone", @@ -195,8 +202,8 @@ message DeleteInstanceGroupManagerResizeRequestRequest { // Request message for GetInstanceGroupManagerResizeRequest. message GetInstanceGroupManagerResizeRequestRequest { - // The name of the managed instance group. Name should conform to RFC1035 or - // be a resource ID. + // The name of the managed instance group. + // Name should conform to RFC1035 or be a resource ID. string instance_group_manager = 1 [ (google.api.field_behavior) = REQUIRED, json_name = "instanceGroupManager" @@ -206,20 +213,21 @@ message GetInstanceGroupManagerResizeRequestRequest { string project = 2 [(google.api.field_behavior) = REQUIRED, json_name = "project"]; - // The name of the resize request. Name should conform to RFC1035 or be a - // resource ID. + // The name of the resize request. + // Name should conform to RFC1035 or be a resource ID. string resize_request = 3 [(google.api.field_behavior) = REQUIRED, json_name = "resizeRequest"]; - // Name of the href="/compute/docs/regions-zones/#available">zone scoping this - // request. Name should conform to RFC1035. + // Name of the href="/compute/docs/regions-zones/#available">zone + // scoping this request. Name should conform to RFC1035. string zone = 4 [(google.api.field_behavior) = REQUIRED, json_name = "zone"]; } // Request message for InsertInstanceGroupManagerResizeRequest. message InsertInstanceGroupManagerResizeRequestRequest { - // 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. + // 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. string instance_group_manager = 1 [ (google.api.field_behavior) = REQUIRED, json_name = "instanceGroupManager" @@ -239,18 +247,22 @@ message InsertInstanceGroupManagerResizeRequestRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; - // 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. + // The name of thezone where the managed + // instance group is located and where the resize request will be created. + // Name should conform to RFC1035. string zone = 5 [ (google.api.field_behavior) = REQUIRED, (google.cloud.operation_request_field) = "zone", @@ -261,37 +273,64 @@ message InsertInstanceGroupManagerResizeRequestRequest { // Request message for ListInstanceGroupManagerResizeRequests. message ListInstanceGroupManagerResizeRequestsRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; // The name of the managed instance group. The name should conform to RFC1035. @@ -300,25 +339,29 @@ message ListInstanceGroupManagerResizeRequestsRequest { json_name = "instanceGroupManager" ]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 3 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 4 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 5 [json_name = "pageToken"]; // Project ID for this request. @@ -326,12 +369,14 @@ message ListInstanceGroupManagerResizeRequestsRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; - // The name of the zone where the managed instance group is located. The name - // should conform to RFC1035. + // The name of thezone where the managed + // instance group is located. The name should conform to RFC1035. string zone = 8 [(google.api.field_behavior) = REQUIRED, json_name = "zone"]; } 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 807423fa4697f..7d2b8203f8c17 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: 20250601 +// revision: 20260807 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_016.proto"; -import "google/cloud/compute/v1/internal/common_028.proto"; -import "google/cloud/compute/v1/internal/common_061.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_037.proto"; +import "google/cloud/compute/v1/internal/common_075.proto"; import "google/cloud/extended_operations.proto"; // Service for the instanceGroupManagers resource. @@ -38,18 +38,23 @@ service InstanceGroupManagers { "https://www.googleapis.com/auth/compute," "https://www.googleapis.com/auth/compute.readonly"; - // 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. + // 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 thetargetSize of + // the managed instance group by the + // number of instances that you abandon. This operation is marked asDONE 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 thelistmanagedinstances + // 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. // https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagers/abandonInstances rpc AbandonInstances(AbandonInstancesRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -62,9 +67,10 @@ service InstanceGroupManagers { option (google.cloud.operation_service) = "ZoneOperations"; } - // 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`. + // 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`. // https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagers/aggregatedList rpc AggregatedListInstanceGroupManagers( AggregatedListInstanceGroupManagersRequest) @@ -75,8 +81,8 @@ service InstanceGroupManagers { option (google.api.method_signature) = "project"; } - // Applies changes to selected instances on the managed instance group. This - // method can be used to apply new overrides and/or new versions. + // Applies changes to selected instances on the managed instance group. + // This method can be used to apply new overrides and/or new versions. // https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagers/applyUpdatesToInstances rpc ApplyUpdatesToInstances(ApplyUpdatesToInstancesRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -90,11 +96,12 @@ service InstanceGroupManagers { } // 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. + // group. Instances are created using the current instance template. Thecreate + // instances operation is marked DONE if thecreateInstances request is + // successful. The underlying actions + // take additional time. You must separately verify the status of thecreating + // or actions with the listmanagedinstances + // method. // https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagers/createInstances rpc CreateInstances(CreateInstancesRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -107,9 +114,10 @@ service InstanceGroupManagers { option (google.cloud.operation_service) = "ZoneOperations"; } - // 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. + // 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. // https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagers/delete rpc DeleteInstanceGroupManager(DeleteInstanceGroupManagerRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -122,16 +130,21 @@ service InstanceGroupManagers { } // 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. + // deletion. The instances are also removed from any target + // pools of which they were a member. This method reduces thetargetSize 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 thelistmanagedinstances + // 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. // https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagers/deleteInstances rpc DeleteInstances(DeleteInstancesRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -169,14 +182,18 @@ service InstanceGroupManagers { "project,zone,instance_group_manager"; } - // 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. + // 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 + // thelistmanagedinstances + // 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. // https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagers/insert rpc InsertInstanceGroupManager(InsertInstanceGroupManagerRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -201,7 +218,8 @@ service InstanceGroupManagers { } // Lists all errors thrown by actions on instances for a given managed - // instance group. The filter and orderBy query parameters are not supported. + // instance group. The filter and orderBy query + // parameters are not supported. // https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagers/listErrors rpc ListErrors(ListErrorsRequest) returns ( google.cloud.cpp.compute.v1.InstanceGroupManagersListErrorsResponse) { @@ -212,13 +230,14 @@ service InstanceGroupManagers { "project,zone,instance_group_manager"; } - // 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 + // 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`. // https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagers/listManagedInstances rpc ListManagedInstances(ListManagedInstancesRequest) @@ -246,16 +265,22 @@ service InstanceGroupManagers { "project,zone,instance_group_manager"; } - // 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 + // 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. + // with thelistManagedInstances + // method. This method supportsPATCH + // semantics and uses theJSON 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, seeUpdating + // instances in + // a MIG. // https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagers/patch rpc PatchInstanceGroupManager(PatchInstanceGroupManagerRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -269,8 +294,8 @@ service InstanceGroupManagers { } // 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. + // group. perInstanceConfig.name serves as a key used to + // distinguish whether to perform insert or patch. // https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagers/patchPerInstanceConfigs rpc PatchPerInstanceConfigs(PatchPerInstanceConfigsRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -285,14 +310,18 @@ service InstanceGroupManagers { // 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. + // 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 itscurrentAction + // 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. // https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagers/recreateInstances rpc RecreateInstances(RecreateInstancesRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -307,19 +336,28 @@ service InstanceGroupManagers { // 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. + // the size, the group deletes instances. The resize operation is markedDONE + // 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 thelistmanagedinstances + // 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. // https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagers/resize rpc Resize(ResizeRequest) returns (google.cloud.cpp.compute.v1.Operation) { option (google.api.http) = { @@ -331,19 +369,24 @@ service InstanceGroupManagers { option (google.cloud.operation_service) = "ZoneOperations"; } - // Flags the specified instances in the managed instance group to be resumed. - // This method increases the targetSize and decreases the targetSuspendedSize + // Flags the specified instances in the managed instance group to be + // resumed. This method increases thetargetSize and decreases the + // targetSuspendedSize // of the managed instance group by the number of instances that you resume. - // The resumeInstances operation is marked DONE if the resumeInstances request - // is successful. The underlying actions take additional time. You must - // separately verify the status of the RESUMING action with the - // listmanagedinstances method. In this request, you can only specify - // instances that are suspended. For example, if an instance was previously - // suspended using the suspendInstances method, it can be resumed using the - // resumeInstances method. If a health check is attached to the managed - // instance group, the specified instances will be verified as healthy after - // they are resumed. You can specify a maximum of 1000 instances with this - // method per request. + // The resumeInstances operation is marked DONE if + // the resumeInstances request is successful. The underlying + // actions take additional time. You must separately verify the status of + // theRESUMING action with thelistmanagedinstances + // method. + // + // In this request, you can only specify instances that are suspended. For + // example, if an instance was previously suspended using the suspendInstances + // method, it can be resumed using the resumeInstances method. + // + // If a health check is attached to the managed instance group, the specified + // instances will be verified as healthy after they are resumed. + // + // You can specify a maximum of 1000 instances with this method per request. // https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagers/resumeInstances rpc ResumeInstances(ResumeInstancesRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -358,8 +401,8 @@ service InstanceGroupManagers { // 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. + // unless you run recreateInstances, runapplyUpdatesToInstances, or set the + // group'supdatePolicy.type to PROACTIVE. // https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagers/setInstanceTemplate rpc SetInstanceTemplate(SetInstanceTemplateRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -374,10 +417,11 @@ service InstanceGroupManagers { // 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. + // instances in the managed instance group. This operation is markedDONE 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. // https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagers/setTargetPools rpc SetTargetPools(SetTargetPoolsRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -390,19 +434,24 @@ service InstanceGroupManagers { option (google.cloud.operation_service) = "ZoneOperations"; } - // Flags the specified instances in the managed instance group to be started. - // This method increases the targetSize and decreases the targetStoppedSize of - // the managed instance group by the number of instances that you start. The - // startInstances operation is marked DONE if the startInstances request is - // successful. The underlying actions take additional time. You must - // separately verify the status of the STARTING action with the - // listmanagedinstances method. In this request, you can only specify - // instances that are stopped. For example, if an instance was previously - // stopped using the stopInstances method, it can be started using the - // startInstances method. If a health check is attached to the managed - // instance group, the specified instances will be verified as healthy after - // they are started. You can specify a maximum of 1000 instances with this - // method per request. + // Flags the specified instances in the managed instance group to be + // started. This method increases thetargetSize and decreases the + // targetStoppedSize + // of the managed instance group by the number of instances that you start. + // The startInstances operation is marked DONE if + // the startInstances request is successful. The underlying + // actions take additional time. You must separately verify the status of + // theSTARTING action with thelistmanagedinstances + // method. + // + // In this request, you can only specify instances that are stopped. For + // example, if an instance was previously stopped using the stopInstances + // method, it can be started using the startInstances method. + // + // If a health check is attached to the managed instance group, the specified + // instances will be verified as healthy after they are started. + // + // You can specify a maximum of 1000 instances with this method per request. // https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagers/startInstances rpc StartInstances(StartInstancesRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -417,22 +466,33 @@ service InstanceGroupManagers { // Flags the specified instances in the managed instance group to be // immediately stopped. You can only specify instances that are running in - // this request. This method reduces the targetSize and increases the - // targetStoppedSize of the managed instance group by the number of instances - // that you stop. The stopInstances operation is marked DONE if the - // stopInstances request is successful. The underlying actions take additional - // time. You must separately verify the status of the STOPPING action with the - // listmanagedinstances method. If the standbyPolicy.initialDelaySec field is - // set, the group delays stopping the instances until initialDelaySec have - // passed from instance.creationTimestamp (that is, when the instance was - // created). This delay gives your application time to set itself up and - // initialize on the instance. If more than initialDelaySec seconds have - // passed since instance.creationTimestamp when this method is called, there - // will be zero delay. 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 stopped. - // Stopped instances can be started using the startInstances method. You can - // specify a maximum of 1000 instances with this method per request. + // this request. This method reduces thetargetSize and increases the + // targetStoppedSize + // of the managed instance group by the number of instances that you stop. + // The stopInstances operation is marked DONE if + // the stopInstances request is successful. The underlying + // actions take additional time. You must separately verify the status of + // theSTOPPING action with thelistmanagedinstances + // method. + // + // If the standbyPolicy.initialDelaySec field is set, the group + // delays stopping the instances until initialDelaySec have + // passed from instance.creationTimestamp (that is, when the + // instance was created). This delay gives your application time to + // set itself up and initialize on the instance. If more thaninitialDelaySec + // seconds have passed sinceinstance.creationTimestamp when this method is + // called, there + // will be zero delay. + // + // 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 stopped. + // + // Stopped instances can be started using the startInstances + // method. + // + // You can specify a maximum of 1000 instances with this method per request. // https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagers/stopInstances rpc StopInstances(StopInstancesRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -447,23 +507,33 @@ service InstanceGroupManagers { // Flags the specified instances in the managed instance group to be // immediately suspended. You can only specify instances that are running in - // this request. This method reduces the targetSize and increases the - // targetSuspendedSize of the managed instance group by the number of - // instances that you suspend. The suspendInstances operation is marked DONE - // if the suspendInstances request is successful. The underlying actions take - // additional time. You must separately verify the status of the SUSPENDING - // action with the listmanagedinstances method. If the - // standbyPolicy.initialDelaySec field is set, the group delays suspension of - // the instances until initialDelaySec have passed from - // instance.creationTimestamp (that is, when the instance was created). This - // delay gives your application time to set itself up and initialize on the - // instance. If more than initialDelaySec seconds have passed since - // instance.creationTimestamp when this method is called, there will be zero - // delay. If the group is part of a backend service that has enabled + // this request. This method reduces thetargetSize and increases the + // targetSuspendedSize + // of the managed instance group by the number of instances that you suspend. + // The suspendInstances operation is marked DONE if + // the suspendInstances request is successful. The underlying + // actions take additional time. You must separately verify the status of + // theSUSPENDING action with thelistmanagedinstances + // method. + // + // If the standbyPolicy.initialDelaySec field is set, the group + // delays suspension of the instances until initialDelaySec have + // passed from instance.creationTimestamp (that is, when the + // instance was created). This delay gives your application time to + // set itself up and initialize on the instance. If more thaninitialDelaySec + // seconds have passed sinceinstance.creationTimestamp when this method is + // called, there + // will be zero delay. + // + // 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 suspended. - // Suspended instances can be resumed using the resumeInstances method. You - // can specify a maximum of 1000 instances with this method per request. + // + // Suspended instances can be resumed using the resumeInstances + // method. + // + // You can specify a maximum of 1000 instances with this method per request. // https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagers/suspendInstances rpc SuspendInstances(SuspendInstancesRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -477,8 +547,8 @@ service InstanceGroupManagers { } // 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. + // group. perInstanceConfig.name serves as a key used to + // distinguish whether to perform insert or patch. // https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagers/updatePerInstanceConfigs rpc UpdatePerInstanceConfigs(UpdatePerInstanceConfigsRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -515,17 +585,21 @@ message AbandonInstancesRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; - // The name of the zone where the managed instance group is located. + // The name of thezone where the managed + // instance group is located. string zone = 5 [ (google.api.field_behavior) = REQUIRED, (google.cloud.operation_request_field) = "zone", @@ -536,37 +610,64 @@ message AbandonInstancesRequest { // Request message for AggregatedListInstanceGroupManagers. message AggregatedListInstanceGroupManagersRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; // Indicates whether every visible scope for each scope type (zone, region, @@ -578,25 +679,29 @@ message AggregatedListInstanceGroupManagersRequest { // will be included. optional bool include_all_scopes = 2 [json_name = "includeAllScopes"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 3 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 4 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 5 [json_name = "pageToken"]; // Project ID for this request. @@ -604,9 +709,11 @@ message AggregatedListInstanceGroupManagersRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; // The Shared VPC service project id or service project number for which @@ -635,8 +742,8 @@ message ApplyUpdatesToInstancesRequest { json_name = "project" ]; - // The name of the zone where the managed instance group is located. Should - // conform to RFC1035. + // The name of thezone + // where the managed instance group is located. Should conform to RFC1035. string zone = 4 [ (google.api.field_behavior) = REQUIRED, (google.cloud.operation_request_field) = "zone", @@ -646,7 +753,8 @@ message ApplyUpdatesToInstancesRequest { // Request message for CreateInstances. message CreateInstancesRequest { - // The name of the managed instance group. It should conform to RFC1035. + // The name of the managed instance group. + // It should conform to RFC1035. string instance_group_manager = 1 [ (google.api.field_behavior) = REQUIRED, json_name = "instanceGroupManager" @@ -667,17 +775,21 @@ message CreateInstancesRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same 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). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // 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). optional string request_id = 4 [json_name = "requestId"]; - // The name of the zone where the managed instance group is located. It should - // conform to RFC1035. + // The name of thezone + // where the managed instance group is located. + // It should conform to RFC1035. string zone = 5 [ (google.api.field_behavior) = REQUIRED, (google.cloud.operation_request_field) = "zone", @@ -693,6 +805,10 @@ message DeleteInstanceGroupManagerRequest { json_name = "instanceGroupManager" ]; + // When set, graceful shutdown is skipped for instance deletion even if it's + // configured for the instances. + optional bool no_graceful_shutdown = 5 [json_name = "noGracefulShutdown"]; + // Project ID for this request. string project = 2 [ (google.api.field_behavior) = REQUIRED, @@ -702,17 +818,21 @@ message DeleteInstanceGroupManagerRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; - // The name of the zone where the managed instance group is located. + // The name of thezone where the managed + // instance group is located. string zone = 4 [ (google.api.field_behavior) = REQUIRED, (google.cloud.operation_request_field) = "zone", @@ -734,6 +854,10 @@ message DeleteInstancesRequest { instance_group_managers_delete_instances_request_resource = 2 [json_name = "__json_request_body"]; + // When set, graceful shutdown is skipped for instance deletion even if it's + // configured for the instances. + optional bool no_graceful_shutdown = 6 [json_name = "noGracefulShutdown"]; + // Project ID for this request. string project = 3 [ (google.api.field_behavior) = REQUIRED, @@ -743,17 +867,21 @@ message DeleteInstancesRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; - // The name of the zone where the managed instance group is located. + // The name of thezone where the managed + // instance group is located. string zone = 5 [ (google.api.field_behavior) = REQUIRED, (google.cloud.operation_request_field) = "zone", @@ -763,7 +891,8 @@ message DeleteInstancesRequest { // Request message for DeletePerInstanceConfigs. message DeletePerInstanceConfigsRequest { - // The name of the managed instance group. It should conform to RFC1035. + // The name of the managed instance group. + // It should conform to RFC1035. string instance_group_manager = 1 [ (google.api.field_behavior) = REQUIRED, json_name = "instanceGroupManager" @@ -782,8 +911,10 @@ message DeletePerInstanceConfigsRequest { json_name = "project" ]; - // The name of the zone where the managed instance group is located. It should - // conform to RFC1035. + // The name of thezone + // where the managed instance + // group is located. + // It should conform to RFC1035. string zone = 4 [ (google.api.field_behavior) = REQUIRED, (google.cloud.operation_request_field) = "zone", @@ -803,7 +934,8 @@ message GetInstanceGroupManagerRequest { string project = 2 [(google.api.field_behavior) = REQUIRED, json_name = "project"]; - // The name of the zone where the managed instance group is located. + // The name of thezone where the managed + // instance group is located. string zone = 3 [(google.api.field_behavior) = REQUIRED, json_name = "zone"]; } @@ -822,17 +954,21 @@ message InsertInstanceGroupManagerRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; - // The name of the zone where you want to create the managed instance group. + // The name of the zone + // where you want to create the managed instance group. string zone = 4 [ (google.api.field_behavior) = REQUIRED, (google.cloud.operation_request_field) = "zone", @@ -843,66 +979,98 @@ message InsertInstanceGroupManagerRequest { // Request message for ListErrors. message ListErrorsRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // 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}. + // 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}. string instance_group_manager = 2 [ (google.api.field_behavior) = REQUIRED, json_name = "instanceGroupManager" ]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 3 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 4 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 5 [json_name = "pageToken"]; // Project ID for this request. @@ -910,71 +1078,105 @@ message ListErrorsRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; - // The name of the zone where the managed instance group is located. It should - // conform to RFC1035. + // The name of thezone where the managed + // instance group is located. + // It should conform to RFC1035. string zone = 8 [(google.api.field_behavior) = REQUIRED, json_name = "zone"]; } // Request message for ListInstanceGroupManagers. message ListInstanceGroupManagersRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -982,49 +1184,79 @@ message ListInstanceGroupManagersRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 6 [json_name = "returnPartialSuccess"]; - // The name of the zone where the managed instance group is located. + // The name of thezone where the managed + // instance group is located. string zone = 7 [(google.api.field_behavior) = REQUIRED, json_name = "zone"]; } // Request message for ListManagedInstances. message ListManagedInstancesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; // The name of the managed instance group. @@ -1033,25 +1265,29 @@ message ListManagedInstancesRequest { json_name = "instanceGroupManager" ]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 3 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 4 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 5 [json_name = "pageToken"]; // Project ID for this request. @@ -1059,49 +1295,79 @@ message ListManagedInstancesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; - // The name of the zone where the managed instance group is located. + // The name of thezone where the managed + // instance group is located. string zone = 8 [(google.api.field_behavior) = REQUIRED, json_name = "zone"]; } // Request message for ListPerInstanceConfigs. message ListPerInstanceConfigsRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; // The name of the managed instance group. It should conform to RFC1035. @@ -1110,25 +1376,29 @@ message ListPerInstanceConfigsRequest { json_name = "instanceGroupManager" ]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 3 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 4 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 5 [json_name = "pageToken"]; // Project ID for this request. @@ -1136,13 +1406,16 @@ message ListPerInstanceConfigsRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; - // The name of the zone where the managed instance group is located. It should - // conform to RFC1035. + // The name of thezone + // where the managed instance group is located. + // It should conform to RFC1035. string zone = 8 [(google.api.field_behavior) = REQUIRED, json_name = "zone"]; } @@ -1167,17 +1440,21 @@ message PatchInstanceGroupManagerRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; - // The name of the zone where you want to create the managed instance group. + // The name of the zone where + // you want to create the managed instance group. string zone = 5 [ (google.api.field_behavior) = REQUIRED, (google.cloud.operation_request_field) = "zone", @@ -1187,7 +1464,8 @@ message PatchInstanceGroupManagerRequest { // Request message for PatchPerInstanceConfigs. message PatchPerInstanceConfigsRequest { - // The name of the managed instance group. It should conform to RFC1035. + // The name of the managed instance group. + // It should conform to RFC1035. string instance_group_manager = 1 [ (google.api.field_behavior) = REQUIRED, json_name = "instanceGroupManager" @@ -1208,18 +1486,22 @@ message PatchPerInstanceConfigsRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; - // The name of the zone where the managed instance group is located. It should - // conform to RFC1035. + // The name of thezone + // where the managed instance group is located. + // It should conform to RFC1035. string zone = 5 [ (google.api.field_behavior) = REQUIRED, (google.cloud.operation_request_field) = "zone", @@ -1241,6 +1523,10 @@ message RecreateInstancesRequest { instance_group_managers_recreate_instances_request_resource = 2 [json_name = "__json_request_body"]; + // When set, graceful shutdown is skipped for instance recreation even if it's + // configured for the instances. + optional bool no_graceful_shutdown = 6 [json_name = "noGracefulShutdown"]; + // Project ID for this request. string project = 3 [ (google.api.field_behavior) = REQUIRED, @@ -1250,17 +1536,21 @@ message RecreateInstancesRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; - // The name of the zone where the managed instance group is located. + // The name of thezone where the managed + // instance group is located. string zone = 5 [ (google.api.field_behavior) = REQUIRED, (google.cloud.operation_request_field) = "zone", @@ -1285,14 +1575,17 @@ message ResizeRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // The number of running instances that the managed instance group should @@ -1300,7 +1593,8 @@ message ResizeRequest { // instances to maintain the number of instances specified by this parameter. int32 size = 4 [(google.api.field_behavior) = REQUIRED, json_name = "size"]; - // The name of the zone where the managed instance group is located. + // The name of thezone where the managed + // instance group is located. string zone = 5 [ (google.api.field_behavior) = REQUIRED, (google.cloud.operation_request_field) = "zone", @@ -1331,17 +1625,21 @@ message ResumeInstancesRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; - // The name of the zone where the managed instance group is located. + // The name of thezone where the managed + // instance group is located. string zone = 5 [ (google.api.field_behavior) = REQUIRED, (google.cloud.operation_request_field) = "zone", @@ -1372,17 +1670,21 @@ message SetInstanceTemplateRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; - // The name of the zone where the managed instance group is located. + // The name of thezone where the managed + // instance group is located. string zone = 5 [ (google.api.field_behavior) = REQUIRED, (google.cloud.operation_request_field) = "zone", @@ -1413,17 +1715,21 @@ message SetTargetPoolsRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; - // The name of the zone where the managed instance group is located. + // The name of thezone where the managed + // instance group is located. string zone = 5 [ (google.api.field_behavior) = REQUIRED, (google.cloud.operation_request_field) = "zone", @@ -1454,17 +1760,21 @@ message StartInstancesRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; - // The name of the zone where the managed instance group is located. + // The name of thezone where the managed + // instance group is located. string zone = 5 [ (google.api.field_behavior) = REQUIRED, (google.cloud.operation_request_field) = "zone", @@ -1485,6 +1795,10 @@ message StopInstancesRequest { instance_group_managers_stop_instances_request_resource = 2 [json_name = "__json_request_body"]; + // When set, graceful shutdown is skipped for instance stopping even if it's + // configured for the instances. + optional bool no_graceful_shutdown = 6 [json_name = "noGracefulShutdown"]; + // Project ID for this request. string project = 3 [ (google.api.field_behavior) = REQUIRED, @@ -1494,17 +1808,21 @@ message StopInstancesRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; - // The name of the zone where the managed instance group is located. + // The name of thezone where the managed + // instance group is located. string zone = 5 [ (google.api.field_behavior) = REQUIRED, (google.cloud.operation_request_field) = "zone", @@ -1535,17 +1853,21 @@ message SuspendInstancesRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; - // The name of the zone where the managed instance group is located. + // The name of thezone where the managed + // instance group is located. string zone = 5 [ (google.api.field_behavior) = REQUIRED, (google.cloud.operation_request_field) = "zone", @@ -1555,7 +1877,8 @@ message SuspendInstancesRequest { // Request message for UpdatePerInstanceConfigs. message UpdatePerInstanceConfigsRequest { - // The name of the managed instance group. It should conform to RFC1035. + // The name of the managed instance group. + // It should conform to RFC1035. string instance_group_manager = 1 [ (google.api.field_behavior) = REQUIRED, json_name = "instanceGroupManager" @@ -1576,18 +1899,22 @@ message UpdatePerInstanceConfigsRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; - // The name of the zone where the managed instance group is located. It should - // conform to RFC1035. + // The name of thezone + // where the managed instance group is located. + // It should conform to RFC1035. string zone = 5 [ (google.api.field_behavior) = REQUIRED, (google.cloud.operation_request_field) = "zone", 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 57954ae9aa17e..66d3dbab5d13f 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: 20250601 +// revision: 20260807 syntax = "proto3"; @@ -24,9 +24,10 @@ 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_016.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_019.proto"; +import "google/cloud/compute/v1/internal/common_073.proto"; +import "google/cloud/compute/v1/internal/common_074.proto"; +import "google/cloud/compute/v1/internal/common_171.proto"; import "google/cloud/extended_operations.proto"; // Service for the instanceGroups resource. @@ -38,9 +39,10 @@ service InstanceGroups { "https://www.googleapis.com/auth/compute," "https://www.googleapis.com/auth/compute.readonly"; - // Adds a list of instances to the specified instance group. All of the + // 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. + // Read + // Adding instances for more information. // https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroups/addInstances rpc AddInstances(AddInstancesRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -53,9 +55,10 @@ service InstanceGroups { option (google.cloud.operation_service) = "ZoneOperations"; } - // Retrieves the list of instance groups and sorts them by zone. To prevent - // failure, Google recommends that you set the `returnPartialSuccess` - // parameter to `true`. + // Retrieves the list of instance groups and sorts them by zone. + // + // To prevent failure, Google recommends that you set the + // `returnPartialSuccess` parameter to `true`. // https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroups/aggregatedList rpc AggregatedListInstanceGroups(AggregatedListInstanceGroupsRequest) returns (google.cloud.cpp.compute.v1.InstanceGroupAggregatedList) { @@ -67,7 +70,8 @@ service InstanceGroups { // 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. + // Read + // Deleting an instance group for more information. // https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroups/delete rpc DeleteInstanceGroup(DeleteInstanceGroupRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -79,9 +83,11 @@ service InstanceGroups { } // 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. + // instance groups by making a list() request. + // + // For managed instance groups, use theinstanceGroupManagers + // or regionInstanceGroupManagers + // methods instead. // https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroups/get rpc GetInstanceGroup(GetInstanceGroupRequest) returns (google.cloud.cpp.compute.v1.InstanceGroup) { @@ -91,8 +97,8 @@ service InstanceGroups { option (google.api.method_signature) = "project,zone,instance_group"; } - // Creates an instance group in the specified project using the parameters - // that are included in the request. + // Creates an instance group in the specified project using the + // parameters that are included in the request. // https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroups/insert rpc InsertInstanceGroup(InsertInstanceGroupRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -106,8 +112,11 @@ service InstanceGroups { } // Retrieves the list of zonal instance group resources contained within the - // specified zone. For managed instance groups, use the instanceGroupManagers - // or regionInstanceGroupManagers methods instead. + // specified zone. + // + // For managed instance groups, use theinstanceGroupManagers + // or regionInstanceGroupManagers + // methods instead. // https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroups/list rpc ListInstanceGroups(ListInstanceGroupsRequest) returns (google.cloud.cpp.compute.v1.InstanceGroupList) { @@ -117,9 +126,10 @@ service InstanceGroups { option (google.api.method_signature) = "project,zone"; } - // 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. + // 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. // https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroups/listInstances rpc ListInstances(ListInstancesRequest) returns (google.cloud.cpp.compute.v1.InstanceGroupsListInstances) { @@ -132,9 +142,12 @@ service InstanceGroups { } // 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. + // 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. // https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroups/removeInstances rpc RemoveInstances(RemoveInstancesRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -159,6 +172,18 @@ service InstanceGroups { "project,zone,instance_group,instance_groups_set_named_ports_request_resource"; option (google.cloud.operation_service) = "ZoneOperations"; } + + // Returns permissions that a caller has on the specified resource. + // https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroups/testIamPermissions + rpc TestIamPermissions(TestIamPermissionsRequest) + returns (google.cloud.cpp.compute.v1.TestPermissionsResponse) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/zones/{zone}/instanceGroups/{resource}/testIamPermissions" + body: "test_permissions_request_resource" + }; + option (google.api.method_signature) = + "project,zone,resource,test_permissions_request_resource"; + } } // Request message for AddInstances. @@ -181,17 +206,21 @@ message AddInstancesRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; - // The name of the zone where the instance group is located. + // The name of the zone + // where the instance group is located. string zone = 5 [ (google.api.field_behavior) = REQUIRED, (google.cloud.operation_request_field) = "zone", @@ -202,37 +231,64 @@ message AddInstancesRequest { // Request message for AggregatedListInstanceGroups. message AggregatedListInstanceGroupsRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; // Indicates whether every visible scope for each scope type (zone, region, @@ -244,25 +300,29 @@ message AggregatedListInstanceGroupsRequest { // will be included. optional bool include_all_scopes = 2 [json_name = "includeAllScopes"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 3 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 4 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 5 [json_name = "pageToken"]; // Project ID for this request. @@ -270,9 +330,11 @@ message AggregatedListInstanceGroupsRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; // The Shared VPC service project id or service project number for which @@ -296,17 +358,21 @@ message DeleteInstanceGroupRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; - // The name of the zone where the instance group is located. + // The name of the zone + // where the instance group is located. string zone = 4 [ (google.api.field_behavior) = REQUIRED, (google.cloud.operation_request_field) = "zone", @@ -324,7 +390,8 @@ message GetInstanceGroupRequest { string project = 2 [(google.api.field_behavior) = REQUIRED, json_name = "project"]; - // The name of the zone where the instance group is located. + // The name of the zone + // where the instance group is located. string zone = 3 [(google.api.field_behavior) = REQUIRED, json_name = "zone"]; } @@ -343,17 +410,21 @@ message InsertInstanceGroupRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; - // The name of the zone where you want to create the instance group. + // The name of the zone + // where you want to create the instance group. string zone = 4 [ (google.api.field_behavior) = REQUIRED, (google.cloud.operation_request_field) = "zone", @@ -364,58 +435,89 @@ message InsertInstanceGroupRequest { // Request message for ListInstanceGroups. message ListInstanceGroupsRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -423,53 +525,83 @@ message ListInstanceGroupsRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 6 [json_name = "returnPartialSuccess"]; - // The name of the zone where the instance group is located. + // The name of thezone + // where the instance group is located. string zone = 7 [(google.api.field_behavior) = REQUIRED, json_name = "zone"]; } // Request message for ListInstances. message ListInstancesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The name of the instance group from which you want to generate a list of - // included instances. + // The name of the instance group from which you want to generate a list + // of included instances. string instance_group = 2 [(google.api.field_behavior) = REQUIRED, json_name = "instanceGroup"]; @@ -478,25 +610,29 @@ message ListInstancesRequest { instance_groups_list_instances_request_resource = 3 [json_name = "__json_request_body"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 4 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 5 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 6 [json_name = "pageToken"]; // Project ID for this request. @@ -504,12 +640,15 @@ message ListInstancesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 8 [json_name = "returnPartialSuccess"]; - // The name of the zone where the instance group is located. + // The name of the zone + // where the instance group is located. string zone = 9 [(google.api.field_behavior) = REQUIRED, json_name = "zone"]; } @@ -534,17 +673,21 @@ message RemoveInstancesRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; - // The name of the zone where the instance group is located. + // The name of the zone + // where the instance group is located. string zone = 5 [ (google.api.field_behavior) = REQUIRED, (google.cloud.operation_request_field) = "zone", @@ -572,20 +715,42 @@ message SetNamedPortsRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; - // The name of the zone where the instance group is located. + // The name of the zone + // where the instance group is located. string zone = 5 [ (google.api.field_behavior) = REQUIRED, (google.cloud.operation_request_field) = "zone", json_name = "zone" ]; } + +// Request message for TestIamPermissions. +message TestIamPermissionsRequest { + // Project ID for this request. + string project = 1 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // Name or id of the resource for this request. + string resource = 2 + [(google.api.field_behavior) = REQUIRED, json_name = "resource"]; + + // The TestPermissionsRequest for this request. + optional google.cloud.cpp.compute.v1.TestPermissionsRequest + test_permissions_request_resource = 3 [json_name = "__json_request_body"]; + + // The name of the zone for this request. + string zone = 4 [(google.api.field_behavior) = REQUIRED, json_name = "zone"]; +} 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 8200e6ea63144..f9cff4a88cb21 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: 20250601 +// revision: 20260807 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_016.proto"; -import "google/cloud/compute/v1/internal/common_064.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_079.proto"; import "google/cloud/extended_operations.proto"; // Service for the instanceSettings resource. @@ -86,14 +86,17 @@ message PatchInstanceSettingsRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // update_mask indicates fields to be updated as part of this request. 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 0e0c496faca07..8b081cddc62a3 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: 20250601 +// revision: 20260807 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_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_047.proto"; -import "google/cloud/compute/v1/internal/common_065.proto"; -import "google/cloud/compute/v1/internal/common_145.proto"; +import "google/cloud/compute/v1/internal/common_009.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_033.proto"; +import "google/cloud/compute/v1/internal/common_057.proto"; +import "google/cloud/compute/v1/internal/common_080.proto"; +import "google/cloud/compute/v1/internal/common_171.proto"; import "google/cloud/extended_operations.proto"; // Service for the instanceTemplates resource. @@ -42,8 +42,10 @@ service InstanceTemplates { "https://www.googleapis.com/auth/compute.readonly"; // 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`. + // available to the specified project. + // + // To prevent failure, Google recommends that you set the + // `returnPartialSuccess` parameter to `true`. // https://cloud.google.com/compute/docs/reference/rest/v1/instanceTemplates/aggregatedList rpc AggregatedListInstanceTemplates(AggregatedListInstanceTemplatesRequest) returns (google.cloud.cpp.compute.v1.InstanceTemplateAggregatedList) { @@ -54,8 +56,8 @@ service InstanceTemplates { } // 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. + // permanent and cannot be undone. It is not possible to delete templates + // that are already in use by a managed instance group. // https://cloud.google.com/compute/docs/reference/rest/v1/instanceTemplates/delete rpc DeleteInstanceTemplate(DeleteInstanceTemplateRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -87,10 +89,11 @@ service InstanceTemplates { option (google.api.method_signature) = "project,resource"; } - // 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. + // 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. // https://cloud.google.com/compute/docs/reference/rest/v1/instanceTemplates/insert rpc InsertInstanceTemplate(InsertInstanceTemplateRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -102,8 +105,8 @@ service InstanceTemplates { option (google.cloud.operation_service) = "GlobalOperations"; } - // Retrieves a list of instance templates that are contained within the - // specified project. + // Retrieves a list of instance templates that are contained within + // the specified project. // https://cloud.google.com/compute/docs/reference/rest/v1/instanceTemplates/list rpc ListInstanceTemplates(ListInstanceTemplatesRequest) returns (google.cloud.cpp.compute.v1.InstanceTemplateList) { @@ -113,8 +116,8 @@ service InstanceTemplates { option (google.api.method_signature) = "project"; } - // Sets the access control policy on the specified resource. Replaces any - // existing policy. + // Sets the access control policy on the specified resource. + // Replaces any existing policy. // https://cloud.google.com/compute/docs/reference/rest/v1/instanceTemplates/setIamPolicy rpc SetIamPolicy(SetIamPolicyRequest) returns (google.cloud.cpp.compute.v1.Policy) { @@ -142,37 +145,64 @@ service InstanceTemplates { // Request message for AggregatedListInstanceTemplates. message AggregatedListInstanceTemplatesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; // Indicates whether every visible scope for each scope type (zone, region, @@ -184,25 +214,29 @@ message AggregatedListInstanceTemplatesRequest { // will be included. optional bool include_all_scopes = 2 [json_name = "includeAllScopes"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 3 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 4 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 5 [json_name = "pageToken"]; // Name of the project scoping this request. @@ -210,9 +244,11 @@ message AggregatedListInstanceTemplatesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; // The Shared VPC service project id or service project number for which @@ -236,14 +272,17 @@ message DeleteInstanceTemplateRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; } @@ -288,72 +327,106 @@ message InsertInstanceTemplateRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; } // Request message for ListInstanceTemplates. message ListInstanceTemplatesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -361,9 +434,11 @@ message ListInstanceTemplatesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 6 [json_name = "returnPartialSuccess"]; } diff --git a/protos/google/cloud/compute/instances/v1/instances.proto b/protos/google/cloud/compute/instances/v1/instances.proto index 867e98b8acb17..ade92b60c2fdd 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: 20250601 +// revision: 20260807 syntax = "proto3"; @@ -24,14 +24,14 @@ package google.cloud.cpp.compute.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_003.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_022.proto"; -import "google/cloud/compute/v1/internal/common_081.proto"; -import "google/cloud/compute/v1/internal/common_145.proto"; -import "google/cloud/compute/v1/internal/common_152.proto"; +import "google/cloud/compute/v1/internal/common_004.proto"; +import "google/cloud/compute/v1/internal/common_009.proto"; +import "google/cloud/compute/v1/internal/common_018.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_029.proto"; +import "google/cloud/compute/v1/internal/common_096.proto"; +import "google/cloud/compute/v1/internal/common_171.proto"; +import "google/cloud/compute/v1/internal/common_182.proto"; import "google/cloud/extended_operations.proto"; import "google/protobuf/empty.proto"; @@ -57,8 +57,21 @@ service Instances { option (google.cloud.operation_service) = "ZoneOperations"; } - // 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 + // Adds one dynamic network interface to an active instance. + // https://cloud.google.com/compute/docs/reference/rest/v1/instances/addNetworkInterface + rpc AddNetworkInterface(AddNetworkInterfaceRequest) + returns (google.cloud.cpp.compute.v1.Operation) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/zones/{zone}/instances/{instance}/addNetworkInterface" + body: "network_interface_resource" + }; + option (google.api.method_signature) = + "project,zone,instance,network_interface_resource"; + option (google.cloud.operation_service) = "ZoneOperations"; + } + + // 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. // https://cloud.google.com/compute/docs/reference/rest/v1/instances/addResourcePolicies rpc AddResourcePolicies(AddResourcePoliciesRequest) @@ -72,9 +85,12 @@ service Instances { option (google.cloud.operation_service) = "ZoneOperations"; } - // 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. + // 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`. // https://cloud.google.com/compute/docs/reference/rest/v1/instances/aggregatedList @@ -86,10 +102,10 @@ service Instances { option (google.api.method_signature) = "project"; } - // 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. + // 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, readAdding a + // persistent disk to your instance. // https://cloud.google.com/compute/docs/reference/rest/v1/instances/attachDisk rpc AttachDisk(AttachDiskRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -103,7 +119,8 @@ service Instances { } // Creates multiple instances. Count specifies the number of instances to - // create. For more information, see About bulk creation of VMs. + // create. For more information, seeAbout bulk + // creation of VMs. // https://cloud.google.com/compute/docs/reference/rest/v1/instances/bulkInsert rpc BulkInsert(BulkInsertRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -116,7 +133,7 @@ service Instances { option (google.cloud.operation_service) = "ZoneOperations"; } - // Deletes the specified Instance resource. For more information, see Deleting + // Deletes the specified Instance resource. For more information, seeDeleting // an instance. // https://cloud.google.com/compute/docs/reference/rest/v1/instances/delete rpc DeleteInstance(DeleteInstanceRequest) @@ -141,6 +158,23 @@ service Instances { option (google.cloud.operation_service) = "ZoneOperations"; } + // Deletes one dynamic network interface from an active instance. + // InstancesDeleteNetworkInterfaceRequest indicates: + // - instance from which to delete, using project+zone+resource_id fields; + // - dynamic network interface to be deleted, using network_interface_name + // field; + // https://cloud.google.com/compute/docs/reference/rest/v1/instances/deleteNetworkInterface + rpc DeleteNetworkInterface(DeleteNetworkInterfaceRequest) + returns (google.cloud.cpp.compute.v1.Operation) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/zones/{zone}/instances/{instance}/deleteNetworkInterface" + body: "*" + }; + option (google.api.method_signature) = + "project,zone,instance,network_interface_name"; + option (google.cloud.operation_service) = "ZoneOperations"; + } + // Detaches a disk from an instance. // https://cloud.google.com/compute/docs/reference/rest/v1/instances/detachDisk rpc DetachDisk(DetachDiskRequest) @@ -238,7 +272,8 @@ service Instances { option (google.cloud.operation_service) = "ZoneOperations"; } - // Retrieves the list of instances contained within the specified zone. + // Retrieves the list of instances contained within + // the specified zone. // https://cloud.google.com/compute/docs/reference/rest/v1/instances/list rpc ListInstances(ListInstancesRequest) returns (google.cloud.cpp.compute.v1.InstanceList) { @@ -251,7 +286,8 @@ service Instances { // 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. + // For more information, readViewing + // referrers to VM instances. // https://cloud.google.com/compute/docs/reference/rest/v1/instances/listReferrers rpc ListReferrers(ListReferrersRequest) returns (google.cloud.cpp.compute.v1.InstanceListReferrers) { @@ -299,8 +335,9 @@ service Instances { option (google.cloud.operation_service) = "ZoneOperations"; } - // 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. + // Performs a reset on the instance. This is a hard reset. The VM + // does not do a graceful shutdown. For more information, seeResetting + // an instance. // https://cloud.google.com/compute/docs/reference/rest/v1/instances/reset rpc Reset(ResetRequest) returns (google.cloud.cpp.compute.v1.Operation) { option (google.api.http) = { @@ -311,7 +348,7 @@ service Instances { option (google.cloud.operation_service) = "ZoneOperations"; } - // Resumes an instance that was suspended using the instances().suspend + // Resumes an instance that was suspended using theinstances().suspend // method. // https://cloud.google.com/compute/docs/reference/rest/v1/instances/resume rpc Resume(ResumeRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -359,8 +396,8 @@ service Instances { option (google.cloud.operation_service) = "ZoneOperations"; } - // Sets the access control policy on the specified resource. Replaces any - // existing policy. + // Sets the access control policy on the specified resource. + // Replaces any existing policy. // https://cloud.google.com/compute/docs/reference/rest/v1/instances/setIamPolicy rpc SetIamPolicy(SetIamPolicyRequest) returns (google.cloud.cpp.compute.v1.Policy) { @@ -372,7 +409,7 @@ service Instances { "project,zone,resource,zone_set_policy_request_resource"; } - // Sets labels on an instance. To learn more about labels, read the Labeling + // Sets labels on an instance. To learn more about labels, read theLabeling // Resources documentation. // https://cloud.google.com/compute/docs/reference/rest/v1/instances/setLabels rpc SetLabels(SetLabelsRequest) @@ -400,8 +437,8 @@ service Instances { option (google.cloud.operation_service) = "ZoneOperations"; } - // Changes the machine type for a stopped instance to the machine type - // specified in the request. + // Changes the machine type for a stopped instance to the machine + // type specified in the request. // https://cloud.google.com/compute/docs/reference/rest/v1/instances/setMachineType rpc SetMachineType(SetMachineTypeRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -414,8 +451,8 @@ service Instances { option (google.cloud.operation_service) = "ZoneOperations"; } - // Sets metadata for the specified instance to the data included in the - // request. + // Sets metadata for the specified instance to the data included + // in the request. // https://cloud.google.com/compute/docs/reference/rest/v1/instances/setMetadata rpc SetMetadata(SetMetadataRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -428,9 +465,10 @@ service Instances { option (google.cloud.operation_service) = "ZoneOperations"; } - // 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. + // Changes the minimum CPU platform that this instance should use. + // This method can only + // be called on a stopped instance. For more information, readSpecifying a + // Minimum CPU Platform. // https://cloud.google.com/compute/docs/reference/rest/v1/instances/setMinCpuPlatform rpc SetMinCpuPlatform(SetMinCpuPlatformRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -455,11 +493,12 @@ service Instances { option (google.cloud.operation_service) = "ZoneOperations"; } - // 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. + // Sets an instance's scheduling options. You can only call this method on + // astopped instance, + // that is, a VM instance that is in a `TERMINATED` state. SeeInstance Life + // Cycle for more information on the possible instance states. + // For more information about setting scheduling options for a VM, seeSet + // VM host maintenance policy. // https://cloud.google.com/compute/docs/reference/rest/v1/instances/setScheduling rpc SetScheduling(SetSchedulingRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -472,8 +511,9 @@ service Instances { option (google.cloud.operation_service) = "ZoneOperations"; } - // Sets the Google Cloud Armor security policy for the specified instance. For - // more information, see Google Cloud Armor Overview + // Sets the Google Cloud Armor security policy for the specified instance. + // For more information, seeGoogle + // Cloud Armor Overview // https://cloud.google.com/compute/docs/reference/rest/v1/instances/setSecurityPolicy rpc SetSecurityPolicy(SetSecurityPolicyRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -486,8 +526,9 @@ service Instances { option (google.cloud.operation_service) = "ZoneOperations"; } - // Sets the service account on the instance. For more information, read - // Changing the service account and access scopes for an instance. + // Sets the service account on the instance. For more information, + // readChanging + // the service account and access scopes for an instance. // https://cloud.google.com/compute/docs/reference/rest/v1/instances/setServiceAccount rpc SetServiceAccount(SetServiceAccountRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -500,9 +541,10 @@ service Instances { option (google.cloud.operation_service) = "ZoneOperations"; } - // 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. + // 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. // https://cloud.google.com/compute/docs/reference/rest/v1/instances/setShieldedInstanceIntegrityPolicy rpc SetShieldedInstanceIntegrityPolicy( SetShieldedInstanceIntegrityPolicyRequest) @@ -516,8 +558,8 @@ service Instances { option (google.cloud.operation_service) = "ZoneOperations"; } - // Sets network tags for the specified instance to the data included in the - // request. + // Sets network tags + // for the specified instance to the data included in the request. // https://cloud.google.com/compute/docs/reference/rest/v1/instances/setTags rpc SetTags(SetTagsRequest) returns (google.cloud.cpp.compute.v1.Operation) { option (google.api.http) = { @@ -542,8 +584,9 @@ service Instances { option (google.cloud.operation_service) = "ZoneOperations"; } - // Starts an instance that was stopped using the instances().stop method. For - // more information, see Restart an instance. + // Starts an instance that was stopped using theinstances().stop + // method. For more information, seeRestart an + // instance. // https://cloud.google.com/compute/docs/reference/rest/v1/instances/start rpc Start(StartRequest) returns (google.cloud.cpp.compute.v1.Operation) { option (google.api.http) = { @@ -554,8 +597,9 @@ service Instances { option (google.cloud.operation_service) = "ZoneOperations"; } - // Starts an instance that was stopped using the instances().stop method. For - // more information, see Restart an instance. + // Starts an instance that was stopped using theinstances().stop + // method. For more information, seeRestart an + // instance. // https://cloud.google.com/compute/docs/reference/rest/v1/instances/startWithEncryptionKey rpc StartWithEncryptionKey(StartWithEncryptionKeyRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -568,12 +612,12 @@ service Instances { option (google.cloud.operation_service) = "ZoneOperations"; } - // 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 + // 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. + // be charged until they are deleted. For more information, seeStopping + // an instance. // https://cloud.google.com/compute/docs/reference/rest/v1/instances/stop rpc Stop(StopRequest) returns (google.cloud.cpp.compute.v1.Operation) { option (google.api.http) = { @@ -589,8 +633,9 @@ service Instances { // 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. + // addresses, will continue to be charged while the instance is suspended. + // For more information, see + // Suspending and resuming an instance. // https://cloud.google.com/compute/docs/reference/rest/v1/instances/suspend rpc Suspend(SuspendRequest) returns (google.cloud.cpp.compute.v1.Operation) { option (google.api.http) = { @@ -614,8 +659,9 @@ service Instances { } // 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. + // method can update only a specific set of instance properties. See + // Updating a running instance for a list of updatable instance + // properties. // https://cloud.google.com/compute/docs/reference/rest/v1/instances/update rpc UpdateInstance(UpdateInstanceRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -629,8 +675,9 @@ service Instances { } // 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. + // with the data included in the request. This method supportsPATCH + // semantics and uses theJSON merge + // patch format and processing rules. // https://cloud.google.com/compute/docs/reference/rest/v1/instances/updateAccessConfig rpc UpdateAccessConfig(UpdateAccessConfigRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -643,9 +690,10 @@ service Instances { option (google.cloud.operation_service) = "ZoneOperations"; } - // 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. + // Updates the Display config for a VM instance. You can + // only use this method on a stopped VM instance. This method supportsPATCH + // semantics and uses theJSON merge + // patch format and processing rules. // https://cloud.google.com/compute/docs/reference/rest/v1/instances/updateDisplayDevice rpc UpdateDisplayDevice(UpdateDisplayDeviceRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -659,10 +707,11 @@ service Instances { } // 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. + // 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. // https://cloud.google.com/compute/docs/reference/rest/v1/instances/updateNetworkInterface rpc UpdateNetworkInterface(UpdateNetworkInterfaceRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -675,9 +724,10 @@ service Instances { option (google.cloud.operation_service) = "ZoneOperations"; } - // 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. + // Updates the Shielded Instance config for an instance. You can + // only use this method on a stopped instance. This method supportsPATCH + // semantics and uses theJSON merge + // patch format and processing rules. // https://cloud.google.com/compute/docs/reference/rest/v1/instances/updateShieldedInstanceConfig rpc UpdateShieldedInstanceConfig(UpdateShieldedInstanceConfigRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -714,14 +764,17 @@ message AddAccessConfigRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 5 [json_name = "requestId"]; // The name of the zone for this request. @@ -732,6 +785,47 @@ message AddAccessConfigRequest { ]; } +// Request message for AddNetworkInterface. +message AddNetworkInterfaceRequest { + // The instance name for this request stored as resource_id. + // Name should conform to RFC1035 or be an unsigned long integer. + string instance = 1 + [(google.api.field_behavior) = REQUIRED, json_name = "instance"]; + + // The NetworkInterface for this request. + optional google.cloud.cpp.compute.v1.NetworkInterface + network_interface_resource = 2 [json_name = "__json_request_body"]; + + // Project ID for this request. + string project = 3 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "project", + json_name = "project" + ]; + + // An optional request ID to identify requests. Specify a unique request ID so + // that if you must retry your request, the server will know to ignore the + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). + optional string request_id = 4 [json_name = "requestId"]; + + // The name of the zone for this request. + string zone = 5 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "zone", + json_name = "zone" + ]; +} + // Request message for AddResourcePolicies. message AddResourcePoliciesRequest { // The instance name for this request. @@ -752,14 +846,17 @@ message AddResourcePoliciesRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; // The name of the zone for this request. @@ -773,37 +870,64 @@ message AddResourcePoliciesRequest { // Request message for AggregatedListInstances. message AggregatedListInstancesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; // Indicates whether every visible scope for each scope type (zone, region, @@ -815,25 +939,29 @@ message AggregatedListInstancesRequest { // will be included. optional bool include_all_scopes = 2 [json_name = "includeAllScopes"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 3 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 4 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 5 [json_name = "pageToken"]; // Project ID for this request. @@ -841,9 +969,11 @@ message AggregatedListInstancesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; // The Shared VPC service project id or service project number for which @@ -876,14 +1006,17 @@ message AttachDiskRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 5 [json_name = "requestId"]; // The name of the zone for this request. @@ -909,14 +1042,17 @@ message BulkInsertRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // The name of the zone for this request. @@ -950,14 +1086,17 @@ message DeleteAccessConfigRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 5 [json_name = "requestId"]; // The name of the zone for this request. @@ -974,6 +1113,9 @@ message DeleteInstanceRequest { string instance = 1 [(google.api.field_behavior) = REQUIRED, json_name = "instance"]; + // If set to true, Graceful Shutdown is skipped. + optional bool no_graceful_shutdown = 5 [json_name = "noGracefulShutdown"]; + // Project ID for this request. string project = 2 [ (google.api.field_behavior) = REQUIRED, @@ -983,14 +1125,17 @@ message DeleteInstanceRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // The name of the zone for this request. @@ -1001,10 +1146,53 @@ message DeleteInstanceRequest { ]; } +// Request message for DeleteNetworkInterface. +message DeleteNetworkInterfaceRequest { + // The instance name for this request stored as resource_id. + // Name should conform to RFC1035 or be an unsigned long integer. + string instance = 1 + [(google.api.field_behavior) = REQUIRED, json_name = "instance"]; + + // The name of the dynamic network interface to be deleted from the instance. + string network_interface_name = 2 [ + (google.api.field_behavior) = REQUIRED, + json_name = "networkInterfaceName" + ]; + + // Project ID for this request. + string project = 3 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "project", + json_name = "project" + ]; + + // An optional request ID to identify requests. Specify a unique request ID so + // that if you must retry your request, the server will know to ignore the + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). + optional string request_id = 4 [json_name = "requestId"]; + + // The name of the zone for this request. + string zone = 5 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "zone", + json_name = "zone" + ]; +} + // Request message for DetachDisk. message DetachDiskRequest { - // The device name of the disk to detach. Make a get() request on the instance - // to view currently attached disks and device names. + // The device name of the disk to detach. Make a get() request on + // the instance to view currently attached disks and device names. string device_name = 1 [(google.api.field_behavior) = REQUIRED, json_name = "deviceName"]; @@ -1021,14 +1209,17 @@ message DetachDiskRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; // The name of the zone for this request. @@ -1138,18 +1329,21 @@ message GetSerialPortOutputRequest { // 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. Note that the negative start is bounded by - // the retained buffer size, and the returned serial console output will not - // exceed the max buffer size. + // 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. Note + // that the negative start is bounded by the retained buffer size, and the + // returned serial console output will not exceed the max buffer size. optional string start = 4 [json_name = "start"]; // The name of the zone for this request. @@ -1185,33 +1379,42 @@ message InsertInstanceRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; - // 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 + // 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 optional string source_instance_template = 4 [json_name = "sourceInstanceTemplate"]; - // 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 + // 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 optional string source_machine_image = 5 [json_name = "sourceMachineImage"]; // The name of the zone for this request. @@ -1225,58 +1428,89 @@ message InsertInstanceRequest { // Request message for ListInstances. message ListInstancesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -1284,9 +1518,11 @@ message ListInstancesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 6 [json_name = "returnPartialSuccess"]; // The name of the zone for this request. @@ -1296,63 +1532,94 @@ message ListInstancesRequest { // Request message for ListReferrers. message ListReferrersRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // Name of the target instance scoping this request, or '-' if the request - // should span over all instances in the container. + // Name of the target instance scoping this request, or '-' if the + // request should span over all instances in the container. string instance = 2 [(google.api.field_behavior) = REQUIRED, json_name = "instance"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 3 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 4 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 5 [json_name = "pageToken"]; // Project ID for this request. @@ -1360,9 +1627,11 @@ message ListReferrersRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; // The name of the zone for this request. @@ -1384,14 +1653,17 @@ message PerformMaintenanceRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // The name of the zone for this request. @@ -1422,14 +1694,17 @@ message RemoveResourcePoliciesRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; // The name of the zone for this request. @@ -1460,14 +1735,17 @@ message ReportHostAsFaultyRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; // The name of the zone for this request. @@ -1493,14 +1771,17 @@ message ResetRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // The name of the zone for this request. @@ -1526,14 +1807,17 @@ message ResumeRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // The name of the zone for this request. @@ -1572,14 +1856,17 @@ message SetDeletionProtectionRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // Name or id of the resource for this request. @@ -1600,8 +1887,8 @@ message SetDiskAutoDeleteRequest { bool auto_delete = 1 [(google.api.field_behavior) = REQUIRED, json_name = "autoDelete"]; - // The device name of the disk to modify. Make a get() request on the instance - // to view currently attached disks and device names. + // The device name of the disk to modify. Make a get() request + // on the instance to view currently attached disks and device names. string device_name = 2 [(google.api.field_behavior) = REQUIRED, json_name = "deviceName"]; @@ -1618,14 +1905,17 @@ message SetDiskAutoDeleteRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 5 [json_name = "requestId"]; // The name of the zone for this request. @@ -1674,14 +1964,17 @@ message SetLabelsRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; // The name of the zone for this request. @@ -1712,14 +2005,17 @@ message SetMachineResourcesRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; // The name of the zone for this request. @@ -1750,14 +2046,17 @@ message SetMachineTypeRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; // The name of the zone for this request. @@ -1787,14 +2086,17 @@ message SetMetadataRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; // The name of the zone for this request. @@ -1825,14 +2127,17 @@ message SetMinCpuPlatformRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; // The name of the zone for this request. @@ -1863,14 +2168,17 @@ message SetNameRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; // The name of the zone for this request. @@ -1896,14 +2204,17 @@ message SetSchedulingRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // The Scheduling for this request. @@ -1920,8 +2231,8 @@ message SetSchedulingRequest { // Request message for SetSecurityPolicy. message SetSecurityPolicyRequest { - // Name of the Instance resource to which the security policy should be set. - // The name should conform to RFC1035. + // Name of the Instance resource to which the security policy should be + // set. The name should conform to RFC1035. string instance = 1 [(google.api.field_behavior) = REQUIRED, json_name = "instance"]; @@ -1939,14 +2250,17 @@ message SetSecurityPolicyRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; // Name of the zone scoping this request. @@ -1977,14 +2291,17 @@ message SetServiceAccountRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; // The name of the zone for this request. @@ -2010,14 +2327,17 @@ message SetShieldedInstanceIntegrityPolicyRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // The ShieldedInstanceIntegrityPolicy for this request. @@ -2048,14 +2368,17 @@ message SetTagsRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // The Tags for this request. @@ -2085,14 +2408,17 @@ message SimulateMaintenanceEventRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // Determines whether the customers receive notifications before migration. @@ -2123,14 +2449,17 @@ message StartRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // The name of the zone for this request. @@ -2161,14 +2490,17 @@ message StartWithEncryptionKeyRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; // The name of the zone for this request. @@ -2190,6 +2522,9 @@ message StopRequest { string instance = 2 [(google.api.field_behavior) = REQUIRED, json_name = "instance"]; + // If set to true, Graceful Shutdown is skipped. + optional bool no_graceful_shutdown = 6 [json_name = "noGracefulShutdown"]; + // Project ID for this request. string project = 3 [ (google.api.field_behavior) = REQUIRED, @@ -2199,14 +2534,17 @@ message StopRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; // The name of the zone for this request. @@ -2237,14 +2575,17 @@ message SuspendRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; // The name of the zone for this request. @@ -2296,14 +2637,17 @@ message UpdateAccessConfigRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 5 [json_name = "requestId"]; // The name of the zone for this request. @@ -2333,14 +2677,17 @@ message UpdateDisplayDeviceRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; // The name of the zone for this request. @@ -2353,6 +2700,10 @@ message UpdateDisplayDeviceRequest { // Request message for UpdateInstance. message UpdateInstanceRequest { + // Whether to discard local SSDs from the instance during restart + // default value is false. + optional bool discard_local_ssd = 8 [json_name = "discardLocalSsd"]; + // Name of the instance resource to update. string instance = 1 [(google.api.field_behavior) = REQUIRED, json_name = "instance"]; @@ -2361,23 +2712,25 @@ message UpdateInstanceRequest { optional google.cloud.cpp.compute.v1.Instance instance_resource = 2 [json_name = "__json_request_body"]; - // 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. + // 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. // INVALID: // NO_EFFECT: No changes can be made to the instance. // REFRESH: The instance will not restart. - // RESTART: The instance will restart. + // RESTART: The instance will restart, potentially on a different host. optional string minimal_action = 3 [json_name = "minimalAction"]; - // 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. + // 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. // INVALID: // NO_EFFECT: No changes can be made to the instance. // REFRESH: The instance will not restart. - // RESTART: The instance will restart. + // RESTART: The instance will restart, potentially on a different host. optional string most_disruptive_allowed_action = 4 [json_name = "mostDisruptiveAllowedAction"]; @@ -2390,14 +2743,17 @@ message UpdateInstanceRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 6 [json_name = "requestId"]; // The name of the zone for this request. @@ -2431,14 +2787,17 @@ message UpdateNetworkInterfaceRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 5 [json_name = "requestId"]; // The name of the zone for this request. @@ -2464,14 +2823,17 @@ message UpdateShieldedInstanceConfigRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // The ShieldedInstanceConfig for this request. diff --git a/protos/google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups.proto b/protos/google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups.proto new file mode 100644 index 0000000000000..7c4469c36cd1a --- /dev/null +++ b/protos/google/cloud/compute/instant_snapshot_groups/v1/instant_snapshot_groups.proto @@ -0,0 +1,377 @@ +// Copyright 2026 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: 20260807 + +syntax = "proto3"; + +package google.cloud.cpp.compute.instant_snapshot_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_009.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_083.proto"; +import "google/cloud/compute/v1/internal/common_171.proto"; +import "google/cloud/compute/v1/internal/common_182.proto"; +import "google/cloud/extended_operations.proto"; + +// Service for the instantSnapshotGroups resource. +// https://cloud.google.com/compute/docs/reference/rest/v1/instantSnapshotGroups +service InstantSnapshotGroups { + option (google.api.default_host) = "compute.googleapis.com"; + option (google.api.oauth_scopes) = + "https://www.googleapis.com/auth/cloud-platform," + "https://www.googleapis.com/auth/compute," + "https://www.googleapis.com/auth/compute.readonly"; + + // deletes a Zonal InstantSnapshotGroup resource + // https://cloud.google.com/compute/docs/reference/rest/v1/instantSnapshotGroups/delete + rpc DeleteInstantSnapshotGroup(DeleteInstantSnapshotGroupRequest) + returns (google.cloud.cpp.compute.v1.Operation) { + option (google.api.http) = { + delete: "/compute/v1/projects/{project}/zones/{zone}/instantSnapshotGroups/{instant_snapshot_group}" + }; + option (google.api.method_signature) = + "project,zone,instant_snapshot_group"; + option (google.cloud.operation_service) = "ZoneOperations"; + } + + // returns the specified InstantSnapshotGroup resource in the specified zone. + // https://cloud.google.com/compute/docs/reference/rest/v1/instantSnapshotGroups/get + rpc GetInstantSnapshotGroup(GetInstantSnapshotGroupRequest) + returns (google.cloud.cpp.compute.v1.InstantSnapshotGroup) { + option (google.api.http) = { + get: "/compute/v1/projects/{project}/zones/{zone}/instantSnapshotGroups/{instant_snapshot_group}" + }; + option (google.api.method_signature) = + "project,zone,instant_snapshot_group"; + } + + // Gets the access control policy for a resource. May be empty if no such + // policy or resource exists. + // https://cloud.google.com/compute/docs/reference/rest/v1/instantSnapshotGroups/getIamPolicy + rpc GetIamPolicy(GetIamPolicyRequest) + returns (google.cloud.cpp.compute.v1.Policy) { + option (google.api.http) = { + get: "/compute/v1/projects/{project}/zones/{zone}/instantSnapshotGroups/{resource}/getIamPolicy" + }; + option (google.api.method_signature) = "project,zone,resource"; + } + + // inserts a Zonal InstantSnapshotGroup resource + // https://cloud.google.com/compute/docs/reference/rest/v1/instantSnapshotGroups/insert + rpc InsertInstantSnapshotGroup(InsertInstantSnapshotGroupRequest) + returns (google.cloud.cpp.compute.v1.Operation) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/zones/{zone}/instantSnapshotGroups" + body: "instant_snapshot_group_resource" + }; + option (google.api.method_signature) = + "project,zone,instant_snapshot_group_resource"; + option (google.cloud.operation_service) = "ZoneOperations"; + } + + // retrieves the list of InstantSnapshotGroup resources contained within + // the specified zone. + // https://cloud.google.com/compute/docs/reference/rest/v1/instantSnapshotGroups/list + rpc ListInstantSnapshotGroups(ListInstantSnapshotGroupsRequest) + returns (google.cloud.cpp.compute.v1.ListInstantSnapshotGroups) { + option (google.api.http) = { + get: "/compute/v1/projects/{project}/zones/{zone}/instantSnapshotGroups" + }; + option (google.api.method_signature) = "project,zone"; + } + + // Sets the access control policy on the specified resource. + // Replaces any existing policy. + // https://cloud.google.com/compute/docs/reference/rest/v1/instantSnapshotGroups/setIamPolicy + rpc SetIamPolicy(SetIamPolicyRequest) + returns (google.cloud.cpp.compute.v1.Policy) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/zones/{zone}/instantSnapshotGroups/{resource}/setIamPolicy" + body: "zone_set_policy_request_resource" + }; + option (google.api.method_signature) = + "project,zone,resource,zone_set_policy_request_resource"; + } + + // Returns permissions that a caller has on the specified resource. + // https://cloud.google.com/compute/docs/reference/rest/v1/instantSnapshotGroups/testIamPermissions + rpc TestIamPermissions(TestIamPermissionsRequest) + returns (google.cloud.cpp.compute.v1.TestPermissionsResponse) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/zones/{zone}/instantSnapshotGroups/{resource}/testIamPermissions" + body: "test_permissions_request_resource" + }; + option (google.api.method_signature) = + "project,zone,resource,test_permissions_request_resource"; + } +} + +// Request message for DeleteInstantSnapshotGroup. +message DeleteInstantSnapshotGroupRequest { + // Name of the InstantSnapshot resource to delete. + string instant_snapshot_group = 1 [ + (google.api.field_behavior) = REQUIRED, + json_name = "instantSnapshotGroup" + ]; + + // Project ID for this request. + string project = 2 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "project", + json_name = "project" + ]; + + // An optional request ID to identify requests. Specify a unique request ID so + // that if you must retry your request, the server will know to ignore the + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). + optional string request_id = 3 [json_name = "requestId"]; + + // The name of the zone for this request. + string zone = 4 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "zone", + json_name = "zone" + ]; +} + +// Request message for GetIamPolicy. +message GetIamPolicyRequest { + // Requested IAM Policy version. + optional int32 options_requested_policy_version = 1 + [json_name = "optionsRequestedPolicyVersion"]; + + // Project ID for this request. + string project = 2 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // Name or id of the resource for this request. + string resource = 3 + [(google.api.field_behavior) = REQUIRED, json_name = "resource"]; + + // The name of the zone for this request. + string zone = 4 [(google.api.field_behavior) = REQUIRED, json_name = "zone"]; +} + +// Request message for GetInstantSnapshotGroup. +message GetInstantSnapshotGroupRequest { + // Name of the InstantSnapshotGroup resource to return. + string instant_snapshot_group = 1 [ + (google.api.field_behavior) = REQUIRED, + json_name = "instantSnapshotGroup" + ]; + + // Project ID for this request. + string project = 2 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // The name of the zone for this request. + string zone = 3 [(google.api.field_behavior) = REQUIRED, json_name = "zone"]; +} + +// Request message for InsertInstantSnapshotGroup. +message InsertInstantSnapshotGroupRequest { + // The InstantSnapshotGroup for this request. + optional google.cloud.cpp.compute.v1.InstantSnapshotGroup + instant_snapshot_group_resource = 1 [json_name = "__json_request_body"]; + + // Project ID for this request. + string project = 2 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "project", + json_name = "project" + ]; + + // An optional request ID to identify requests. Specify a unique request ID so + // that if you must retry your request, the server will know to ignore the + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). + optional string request_id = 3 [json_name = "requestId"]; + + // begin_interface: MixerMutationRequestBuilder + optional string source_consistency_group = 4 + [json_name = "sourceConsistencyGroup"]; + + // Name of the zone for this request. + string zone = 5 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "zone", + json_name = "zone" + ]; +} + +// Request message for ListInstantSnapshotGroups. +message ListInstantSnapshotGroupsRequest { + // A filter expression that filters resources listed in the response. Most + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. + optional string filter = 1 [json_name = "filter"]; + + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) + optional uint32 max_results = 2 [json_name = "maxResults"]; + + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or + // `creationTimestamp desc` is supported. + optional string order_by = 3 [json_name = "orderBy"]; + + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. + optional string page_token = 4 [json_name = "pageToken"]; + + // Project ID for this request. + string project = 5 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // Opt-in for partial success behavior which provides partial results in case + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. + optional bool return_partial_success = 6 [json_name = "returnPartialSuccess"]; + + // The name of the zone for this request. + string zone = 7 [(google.api.field_behavior) = REQUIRED, json_name = "zone"]; +} + +// Request message for SetIamPolicy. +message SetIamPolicyRequest { + // Project ID for this request. + string project = 1 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // Name or id of the resource for this request. + string resource = 2 + [(google.api.field_behavior) = REQUIRED, json_name = "resource"]; + + // The name of the zone for this request. + string zone = 3 [(google.api.field_behavior) = REQUIRED, json_name = "zone"]; + + // The ZoneSetPolicyRequest for this request. + optional google.cloud.cpp.compute.v1.ZoneSetPolicyRequest + zone_set_policy_request_resource = 4 [json_name = "__json_request_body"]; +} + +// Request message for TestIamPermissions. +message TestIamPermissionsRequest { + // Project ID for this request. + string project = 1 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // Name or id of the resource for this request. + string resource = 2 + [(google.api.field_behavior) = REQUIRED, json_name = "resource"]; + + // The TestPermissionsRequest for this request. + optional google.cloud.cpp.compute.v1.TestPermissionsRequest + test_permissions_request_resource = 3 [json_name = "__json_request_body"]; + + // The name of the zone for this request. + string zone = 4 [(google.api.field_behavior) = REQUIRED, json_name = "zone"]; +} 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 d00983c7c0855..181d64c8235eb 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: 20250601 +// revision: 20260807 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_007.proto"; -import "google/cloud/compute/v1/internal/common_016.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_145.proto"; -import "google/cloud/compute/v1/internal/common_151.proto"; -import "google/cloud/compute/v1/internal/common_152.proto"; +import "google/cloud/compute/v1/internal/common_009.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_081.proto"; +import "google/cloud/compute/v1/internal/common_082.proto"; +import "google/cloud/compute/v1/internal/common_171.proto"; +import "google/cloud/compute/v1/internal/common_180.proto"; +import "google/cloud/compute/v1/internal/common_182.proto"; import "google/cloud/extended_operations.proto"; // Service for the instantSnapshots resource. @@ -42,9 +42,10 @@ service InstantSnapshots { "https://www.googleapis.com/auth/compute," "https://www.googleapis.com/auth/compute.readonly"; - // Retrieves an aggregated list of instantSnapshots. To prevent failure, - // Google recommends that you set the `returnPartialSuccess` parameter to - // `true`. + // Retrieves an aggregated list of instantSnapshots. + // + // To prevent failure, Google recommends that you set the + // `returnPartialSuccess` parameter to `true`. // https://cloud.google.com/compute/docs/reference/rest/v1/instantSnapshots/aggregatedList rpc AggregatedListInstantSnapshots(AggregatedListInstantSnapshotsRequest) returns (google.cloud.cpp.compute.v1.InstantSnapshotAggregatedList) { @@ -58,8 +59,10 @@ service InstantSnapshots { // 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. + // to the next corresponding instantSnapshot. + // + // For more information, seeDeleting + // instantSnapshots. // https://cloud.google.com/compute/docs/reference/rest/v1/instantSnapshots/delete rpc DeleteInstantSnapshot(DeleteInstantSnapshotRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -104,8 +107,8 @@ service InstantSnapshots { option (google.cloud.operation_service) = "ZoneOperations"; } - // Retrieves the list of InstantSnapshot resources contained within the - // specified zone. + // Retrieves the list of InstantSnapshot resources contained within + // the specified zone. // https://cloud.google.com/compute/docs/reference/rest/v1/instantSnapshots/list rpc ListInstantSnapshots(ListInstantSnapshotsRequest) returns (google.cloud.cpp.compute.v1.InstantSnapshotList) { @@ -115,8 +118,8 @@ service InstantSnapshots { option (google.api.method_signature) = "project,zone"; } - // Sets the access control policy on the specified resource. Replaces any - // existing policy. + // Sets the access control policy on the specified resource. + // Replaces any existing policy. // https://cloud.google.com/compute/docs/reference/rest/v1/instantSnapshots/setIamPolicy rpc SetIamPolicy(SetIamPolicyRequest) returns (google.cloud.cpp.compute.v1.Policy) { @@ -129,7 +132,8 @@ service InstantSnapshots { } // Sets the labels on a instantSnapshot in the given zone. To learn more about - // labels, read the Labeling Resources documentation. + // labels, read the Labeling + // Resources documentation. // https://cloud.google.com/compute/docs/reference/rest/v1/instantSnapshots/setLabels rpc SetLabels(SetLabelsRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -158,37 +162,64 @@ service InstantSnapshots { // Request message for AggregatedListInstantSnapshots. message AggregatedListInstantSnapshotsRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; // Indicates whether every visible scope for each scope type (zone, region, @@ -200,25 +231,29 @@ message AggregatedListInstantSnapshotsRequest { // will be included. optional bool include_all_scopes = 2 [json_name = "includeAllScopes"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 3 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 4 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 5 [json_name = "pageToken"]; // Project ID for this request. @@ -226,9 +261,11 @@ message AggregatedListInstantSnapshotsRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; // The Shared VPC service project id or service project number for which @@ -252,14 +289,17 @@ message DeleteInstantSnapshotRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // The name of the zone for this request. @@ -317,14 +357,17 @@ message InsertInstantSnapshotRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // Name of the zone for this request. @@ -338,58 +381,89 @@ message InsertInstantSnapshotRequest { // Request message for ListInstantSnapshots. message ListInstantSnapshotsRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -397,9 +471,11 @@ message ListInstantSnapshotsRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 6 [json_name = "returnPartialSuccess"]; // The name of the zone for this request. @@ -435,14 +511,17 @@ message SetLabelsRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 2 [json_name = "requestId"]; // Name or id of the resource for this request. diff --git a/protos/google/cloud/compute/interconnect_attachment_groups/v1/interconnect_attachment_groups.proto b/protos/google/cloud/compute/interconnect_attachment_groups/v1/interconnect_attachment_groups.proto index 1514621095f04..e7a6c912a2501 100644 --- a/protos/google/cloud/compute/interconnect_attachment_groups/v1/interconnect_attachment_groups.proto +++ b/protos/google/cloud/compute/interconnect_attachment_groups/v1/interconnect_attachment_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: 20250601 +// revision: 20260807 syntax = "proto3"; @@ -24,11 +24,11 @@ package google.cloud.cpp.compute.interconnect_attachment_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_007.proto"; -import "google/cloud/compute/v1/internal/common_016.proto"; -import "google/cloud/compute/v1/internal/common_047.proto"; -import "google/cloud/compute/v1/internal/common_071.proto"; -import "google/cloud/compute/v1/internal/common_145.proto"; +import "google/cloud/compute/v1/internal/common_009.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_057.proto"; +import "google/cloud/compute/v1/internal/common_087.proto"; +import "google/cloud/compute/v1/internal/common_171.proto"; import "google/cloud/extended_operations.proto"; // Service for the interconnectAttachmentGroups resource. @@ -116,8 +116,9 @@ service InterconnectAttachmentGroups { } // Patches the specified InterconnectAttachmentGroup resource with the data - // included in the request. This method supports PATCH semantics and uses JSON - // merge patch format and processing rules. + // included in the request. This method supports PATCH + // semantics and usesJSON merge + // patch format and processing rules. // https://cloud.google.com/compute/docs/reference/rest/v1/interconnectAttachmentGroups/patch rpc PatchInterconnectAttachmentGroup(PatchInterconnectAttachmentGroupRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -130,8 +131,8 @@ service InterconnectAttachmentGroups { option (google.cloud.operation_service) = "GlobalOperations"; } - // Sets the access control policy on the specified resource. Replaces any - // existing policy. + // Sets the access control policy on the specified resource. + // Replaces any existing policy. // https://cloud.google.com/compute/docs/reference/rest/v1/interconnectAttachmentGroups/setIamPolicy rpc SetIamPolicy(SetIamPolicyRequest) returns (google.cloud.cpp.compute.v1.Policy) { @@ -173,15 +174,18 @@ message DeleteInterconnectAttachmentGroupRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // 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 + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating 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 optional string request_id = 3 [json_name = "requestId"]; } @@ -242,73 +246,107 @@ message InsertInterconnectAttachmentGroupRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // 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 + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating 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 optional string request_id = 3 [json_name = "requestId"]; } // Request message for ListInterconnectAttachmentGroups. message ListInterconnectAttachmentGroupsRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -316,9 +354,11 @@ message ListInterconnectAttachmentGroupsRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 6 [json_name = "returnPartialSuccess"]; } @@ -344,15 +384,18 @@ message PatchInterconnectAttachmentGroupRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // 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 + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating 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 optional string request_id = 4 [json_name = "requestId"]; // The list of fields to update. 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 cb121e8522a1b..2e8489628d658 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: 20250601 +// revision: 20260807 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_016.proto"; -import "google/cloud/compute/v1/internal/common_069.proto"; -import "google/cloud/compute/v1/internal/common_107.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_085.proto"; +import "google/cloud/compute/v1/internal/common_125.proto"; import "google/cloud/extended_operations.proto"; // Service for the interconnectAttachments resource. @@ -38,9 +38,10 @@ service InterconnectAttachments { "https://www.googleapis.com/auth/compute," "https://www.googleapis.com/auth/compute.readonly"; - // Retrieves an aggregated list of interconnect attachments. To prevent - // failure, Google recommends that you set the `returnPartialSuccess` - // parameter to `true`. + // Retrieves an aggregated list of interconnect attachments. + // + // To prevent failure, Google recommends that you set the + // `returnPartialSuccess` parameter to `true`. // https://cloud.google.com/compute/docs/reference/rest/v1/interconnectAttachments/aggregatedList rpc AggregatedListInterconnectAttachments( AggregatedListInterconnectAttachmentsRequest) @@ -89,8 +90,8 @@ service InterconnectAttachments { option (google.cloud.operation_service) = "RegionOperations"; } - // Retrieves the list of interconnect attachments contained within the - // specified region. + // Retrieves the list of interconnect attachments contained within + // the specified region. // https://cloud.google.com/compute/docs/reference/rest/v1/interconnectAttachments/list rpc ListInterconnectAttachments(ListInterconnectAttachmentsRequest) returns (google.cloud.cpp.compute.v1.InterconnectAttachmentList) { @@ -101,8 +102,9 @@ service InterconnectAttachments { } // 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. + // request. This method supportsPATCH + // semantics and uses theJSON merge + // patch format and processing rules. // https://cloud.google.com/compute/docs/reference/rest/v1/interconnectAttachments/patch rpc PatchInterconnectAttachment(PatchInterconnectAttachmentRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -116,7 +118,8 @@ service InterconnectAttachments { } // Sets the labels on an InterconnectAttachment. To learn more about labels, - // read the Labeling Resources documentation. + // read the Labeling + // Resources documentation. // https://cloud.google.com/compute/docs/reference/rest/v1/interconnectAttachments/setLabels rpc SetLabels(SetLabelsRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -133,37 +136,64 @@ service InterconnectAttachments { // Request message for AggregatedListInterconnectAttachments. message AggregatedListInterconnectAttachmentsRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; // Indicates whether every visible scope for each scope type (zone, region, @@ -175,25 +205,29 @@ message AggregatedListInterconnectAttachmentsRequest { // will be included. optional bool include_all_scopes = 2 [json_name = "includeAllScopes"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 3 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 4 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 5 [json_name = "pageToken"]; // Project ID for this request. @@ -201,9 +235,11 @@ message AggregatedListInterconnectAttachmentsRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; // The Shared VPC service project id or service project number for which @@ -236,14 +272,17 @@ message DeleteInterconnectAttachmentRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; } @@ -286,14 +325,17 @@ message InsertInterconnectAttachmentRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; // If true, the request will not be committed. @@ -303,58 +345,89 @@ message InsertInterconnectAttachmentRequest { // Request message for ListInterconnectAttachments. message ListInterconnectAttachmentsRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -366,9 +439,11 @@ message ListInterconnectAttachmentsRequest { [(google.api.field_behavior) = REQUIRED, json_name = "region"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; } @@ -400,14 +475,17 @@ message PatchInterconnectAttachmentRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 5 [json_name = "requestId"]; } @@ -434,14 +512,17 @@ message SetLabelsRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; // Name or id of the resource for this request. diff --git a/protos/google/cloud/compute/interconnect_groups/v1/interconnect_groups.proto b/protos/google/cloud/compute/interconnect_groups/v1/interconnect_groups.proto index 5ec007a7268d4..22c7e97ae2783 100644 --- a/protos/google/cloud/compute/interconnect_groups/v1/interconnect_groups.proto +++ b/protos/google/cloud/compute/interconnect_groups/v1/interconnect_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: 20250601 +// revision: 20260807 syntax = "proto3"; @@ -24,11 +24,11 @@ package google.cloud.cpp.compute.interconnect_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_007.proto"; -import "google/cloud/compute/v1/internal/common_016.proto"; -import "google/cloud/compute/v1/internal/common_047.proto"; -import "google/cloud/compute/v1/internal/common_073.proto"; -import "google/cloud/compute/v1/internal/common_145.proto"; +import "google/cloud/compute/v1/internal/common_009.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_057.proto"; +import "google/cloud/compute/v1/internal/common_089.proto"; +import "google/cloud/compute/v1/internal/common_171.proto"; import "google/cloud/extended_operations.proto"; // Service for the interconnectGroups resource. @@ -86,7 +86,8 @@ service InterconnectGroups { option (google.api.method_signature) = "project,resource"; } - // Returns the interconnectStatuses for the specified InterconnectGroup. + // Returns the interconnectStatuses for the specified + // InterconnectGroup. // https://cloud.google.com/compute/docs/reference/rest/v1/interconnectGroups/getOperationalStatus rpc GetOperationalStatus(GetOperationalStatusRequest) returns (google.cloud.cpp.compute.v1 @@ -122,8 +123,9 @@ service InterconnectGroups { } // Patches the specified InterconnectGroup resource with the data included in - // the request. This method supports PATCH semantics and uses JSON merge patch - // format and processing rules. + // the request. This method supports PATCH + // semantics and usesJSON merge + // patch format and processing rules. // https://cloud.google.com/compute/docs/reference/rest/v1/interconnectGroups/patch rpc PatchInterconnectGroup(PatchInterconnectGroupRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -136,8 +138,8 @@ service InterconnectGroups { option (google.cloud.operation_service) = "GlobalOperations"; } - // Sets the access control policy on the specified resource. Replaces any - // existing policy. + // Sets the access control policy on the specified resource. + // Replaces any existing policy. // https://cloud.google.com/compute/docs/reference/rest/v1/interconnectGroups/setIamPolicy rpc SetIamPolicy(SetIamPolicyRequest) returns (google.cloud.cpp.compute.v1.Policy) { @@ -196,15 +198,18 @@ message DeleteInterconnectGroupRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // 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 + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating 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 optional string request_id = 3 [json_name = "requestId"]; } @@ -260,73 +265,107 @@ message InsertInterconnectGroupRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // 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 + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating 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 optional string request_id = 3 [json_name = "requestId"]; } // Request message for ListInterconnectGroups. message ListInterconnectGroupsRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -334,9 +373,11 @@ message ListInterconnectGroupsRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 6 [json_name = "returnPartialSuccess"]; } @@ -359,15 +400,18 @@ message PatchInterconnectGroupRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // 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 + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating 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 optional string request_id = 4 [json_name = "requestId"]; // The list of fields to update. 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 bd663b57be429..fec2b030d2063 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: 20250601 +// revision: 20260807 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_074.proto"; +import "google/cloud/compute/v1/internal/common_090.proto"; // Service for the interconnectLocations resource. // https://cloud.google.com/compute/docs/reference/rest/v1/interconnectLocations @@ -74,58 +74,89 @@ message GetInterconnectLocationRequest { // Request message for ListInterconnectLocations. message ListInterconnectLocationsRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -133,8 +164,10 @@ message ListInterconnectLocationsRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 6 [json_name = "returnPartialSuccess"]; } 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 f6f1cede0ed9e..7bcd8f6315865 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: 20250601 +// revision: 20260807 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_075.proto"; +import "google/cloud/compute/v1/internal/common_091.proto"; // Service for the interconnectRemoteLocations resource. // https://cloud.google.com/compute/docs/reference/rest/v1/interconnectRemoteLocations @@ -36,7 +36,7 @@ service InterconnectRemoteLocations { "https://www.googleapis.com/auth/compute.readonly"; // Returns the details for the specified interconnect remote location. Gets a - // list of available interconnect remote locations by making a list() request. + // list of available interconnect remote locations by making alist() request. // https://cloud.google.com/compute/docs/reference/rest/v1/interconnectRemoteLocations/get rpc GetInterconnectRemoteLocation(GetInterconnectRemoteLocationRequest) returns (google.cloud.cpp.compute.v1.InterconnectRemoteLocation) { @@ -75,58 +75,89 @@ message GetInterconnectRemoteLocationRequest { // Request message for ListInterconnectRemoteLocations. message ListInterconnectRemoteLocationsRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -134,8 +165,10 @@ message ListInterconnectRemoteLocationsRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 6 [json_name = "returnPartialSuccess"]; } diff --git a/protos/google/cloud/compute/interconnects/v1/interconnects.proto b/protos/google/cloud/compute/interconnects/v1/interconnects.proto index 2a32bff60ad65..fb99372cd247b 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: 20250601 +// revision: 20260807 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_016.proto"; -import "google/cloud/compute/v1/internal/common_046.proto"; -import "google/cloud/compute/v1/internal/common_068.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_056.proto"; +import "google/cloud/compute/v1/internal/common_084.proto"; import "google/cloud/extended_operations.proto"; // Service for the interconnects resource. @@ -60,11 +60,16 @@ service Interconnects { option (google.api.method_signature) = "project,interconnect"; } - // 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. + // 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. // https://cloud.google.com/compute/docs/reference/rest/v1/interconnects/getDiagnostics rpc GetDiagnostics(GetDiagnosticsRequest) returns ( google.cloud.cpp.compute.v1.InterconnectsGetDiagnosticsResponse) { @@ -74,7 +79,8 @@ service Interconnects { option (google.api.method_signature) = "project,interconnect"; } - // Returns the interconnectMacsecConfig for the specified Interconnect. + // Returns the interconnectMacsecConfig for the specified + // Interconnect. // https://cloud.google.com/compute/docs/reference/rest/v1/interconnects/getMacsecConfig rpc GetMacsecConfig(GetMacsecConfigRequest) returns ( google.cloud.cpp.compute.v1.InterconnectsGetMacsecConfigResponse) { @@ -84,8 +90,8 @@ service Interconnects { option (google.api.method_signature) = "project,interconnect"; } - // Creates an Interconnect in the specified project using the data included in - // the request. + // Creates an Interconnect in the specified project using + // the data included in the request. // https://cloud.google.com/compute/docs/reference/rest/v1/interconnects/insert rpc InsertInterconnect(InsertInterconnectRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -108,8 +114,9 @@ service Interconnects { } // 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. + // This method supportsPATCH + // semantics and uses theJSON merge + // patch format and processing rules. // https://cloud.google.com/compute/docs/reference/rest/v1/interconnects/patch rpc PatchInterconnect(PatchInterconnectRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -122,8 +129,9 @@ service Interconnects { option (google.cloud.operation_service) = "GlobalOperations"; } - // Sets the labels on an Interconnect. To learn more about labels, read the - // Labeling Resources documentation. + // Sets the labels on an Interconnect. To learn more about labels, + // read the Labeling + // Resources documentation. // https://cloud.google.com/compute/docs/reference/rest/v1/interconnects/setLabels rpc SetLabels(SetLabelsRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -152,14 +160,17 @@ message DeleteInterconnectRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; } @@ -211,72 +222,106 @@ message InsertInterconnectRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; } // Request message for ListInterconnects. message ListInterconnectsRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -284,9 +329,11 @@ message ListInterconnectsRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 6 [json_name = "returnPartialSuccess"]; } @@ -309,14 +356,17 @@ message PatchInterconnectRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; } 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 63caaff103d77..9908f802f9df4 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: 20250601 +// revision: 20260807 syntax = "proto3"; @@ -24,8 +24,10 @@ 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_077.proto"; -import "google/cloud/compute/v1/internal/common_145.proto"; +import "google/cloud/compute/v1/internal/common_009.proto"; +import "google/cloud/compute/v1/internal/common_057.proto"; +import "google/cloud/compute/v1/internal/common_093.proto"; +import "google/cloud/compute/v1/internal/common_171.proto"; // Service for the licenseCodes resource. // https://cloud.google.com/compute/docs/reference/rest/v1/licenseCodes @@ -36,10 +38,11 @@ service LicenseCodes { "https://www.googleapis.com/auth/compute," "https://www.googleapis.com/auth/compute.readonly"; - // 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. + // 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 creatingCloud Marketplace + // images. // https://cloud.google.com/compute/docs/reference/rest/v1/licenseCodes/get rpc GetLicenseCode(GetLicenseCodeRequest) returns (google.cloud.cpp.compute.v1.LicenseCode) { @@ -49,9 +52,40 @@ service LicenseCodes { option (google.api.method_signature) = "project,license_code"; } - // 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. + // 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 creatingCloud Marketplace + // images. + // https://cloud.google.com/compute/docs/reference/rest/v1/licenseCodes/getIamPolicy + rpc GetIamPolicy(GetIamPolicyRequest) + returns (google.cloud.cpp.compute.v1.Policy) { + option (google.api.http) = { + get: "/compute/v1/projects/{project}/global/licenseCodes/{resource}/getIamPolicy" + }; + option (google.api.method_signature) = "project,resource"; + } + + // 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 creatingCloud Marketplace + // images. + // https://cloud.google.com/compute/docs/reference/rest/v1/licenseCodes/setIamPolicy + rpc SetIamPolicy(SetIamPolicyRequest) + returns (google.cloud.cpp.compute.v1.Policy) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/global/licenseCodes/{resource}/setIamPolicy" + body: "global_set_policy_request_resource" + }; + option (google.api.method_signature) = + "project,resource,global_set_policy_request_resource"; + } + + // Returns permissions that a caller has on the specified resource. + // *Caution* This resource is intended + // for use only by third-party partners who are creatingCloud Marketplace + // images. // https://cloud.google.com/compute/docs/reference/rest/v1/licenseCodes/testIamPermissions rpc TestIamPermissions(TestIamPermissionsRequest) returns (google.cloud.cpp.compute.v1.TestPermissionsResponse) { @@ -64,6 +98,21 @@ service LicenseCodes { } } +// Request message for GetIamPolicy. +message GetIamPolicyRequest { + // Requested IAM Policy version. + optional int32 options_requested_policy_version = 1 + [json_name = "optionsRequestedPolicyVersion"]; + + // Project ID for this request. + string project = 2 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // Name or id of the resource for this request. + string resource = 3 + [(google.api.field_behavior) = REQUIRED, json_name = "resource"]; +} + // Request message for GetLicenseCode. message GetLicenseCodeRequest { // Number corresponding to the License code resource to return. @@ -75,6 +124,22 @@ message GetLicenseCodeRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; } +// Request message for SetIamPolicy. +message SetIamPolicyRequest { + // The GlobalSetPolicyRequest for this request. + optional google.cloud.cpp.compute.v1.GlobalSetPolicyRequest + global_set_policy_request_resource = 1 + [json_name = "__json_request_body"]; + + // Project ID for this request. + string project = 2 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // Name or id of the resource for this request. + string resource = 3 + [(google.api.field_behavior) = REQUIRED, json_name = "resource"]; +} + // Request message for TestIamPermissions. message TestIamPermissionsRequest { // Project ID for this request. diff --git a/protos/google/cloud/compute/licenses/v1/licenses.proto b/protos/google/cloud/compute/licenses/v1/licenses.proto index bedb861ac9bfd..ca6f7dd8dc73c 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: 20250601 +// revision: 20260807 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_007.proto"; -import "google/cloud/compute/v1/internal/common_016.proto"; -import "google/cloud/compute/v1/internal/common_047.proto"; -import "google/cloud/compute/v1/internal/common_076.proto"; -import "google/cloud/compute/v1/internal/common_145.proto"; +import "google/cloud/compute/v1/internal/common_009.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_057.proto"; +import "google/cloud/compute/v1/internal/common_092.proto"; +import "google/cloud/compute/v1/internal/common_171.proto"; import "google/cloud/extended_operations.proto"; // Service for the licenses resource. @@ -43,8 +43,10 @@ service Licenses { "https://www.googleapis.com/auth/devstorage.read_only," "https://www.googleapis.com/auth/devstorage.read_write"; - // Deletes the specified license. *Caution* This resource is intended for use - // only by third-party partners who are creating Cloud Marketplace images. + // Deletes the specified license. + // *Caution* This resource is intended + // for use only by third-party partners who are creatingCloud Marketplace + // images. // https://cloud.google.com/compute/docs/reference/rest/v1/licenses/delete rpc DeleteLicense(DeleteLicenseRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -55,8 +57,9 @@ service Licenses { option (google.cloud.operation_service) = "GlobalOperations"; } - // Returns the specified License resource. *Caution* This resource is intended - // for use only by third-party partners who are creating Cloud Marketplace + // Returns the specified License resource. + // *Caution* This resource is intended + // for use only by third-party partners who are creatingCloud Marketplace // images. // https://cloud.google.com/compute/docs/reference/rest/v1/licenses/get rpc GetLicense(GetLicenseRequest) @@ -68,8 +71,10 @@ service Licenses { } // 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. + // policy or resource exists. + // *Caution* This resource is intended + // for use only by third-party partners who are creatingCloud Marketplace + // images. // https://cloud.google.com/compute/docs/reference/rest/v1/licenses/getIamPolicy rpc GetIamPolicy(GetIamPolicyRequest) returns (google.cloud.cpp.compute.v1.Policy) { @@ -79,9 +84,10 @@ service Licenses { option (google.api.method_signature) = "project,resource"; } - // 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. + // Create a License resource in the specified project. + // *Caution* This resource is intended + // for use only by third-party partners who are creatingCloud Marketplace + // images. // https://cloud.google.com/compute/docs/reference/rest/v1/licenses/insert rpc InsertLicense(InsertLicenseRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -93,13 +99,15 @@ service Licenses { option (google.cloud.operation_service) = "GlobalOperations"; } - // 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. + // 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 orwindows-cloud. + // *Caution* This resource is intended + // for use only by third-party partners who are creatingCloud Marketplace + // images. // https://cloud.google.com/compute/docs/reference/rest/v1/licenses/list rpc ListLicenses(ListLicensesRequest) returns (google.cloud.cpp.compute.v1.LicensesListResponse) { @@ -109,9 +117,11 @@ service Licenses { option (google.api.method_signature) = "project"; } - // 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. + // 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 creatingCloud Marketplace + // images. // https://cloud.google.com/compute/docs/reference/rest/v1/licenses/setIamPolicy rpc SetIamPolicy(SetIamPolicyRequest) returns (google.cloud.cpp.compute.v1.Policy) { @@ -123,9 +133,10 @@ service Licenses { "project,resource,global_set_policy_request_resource"; } - // 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. + // Returns permissions that a caller has on the specified resource. + // *Caution* This resource is intended + // for use only by third-party partners who are creatingCloud Marketplace + // images. // https://cloud.google.com/compute/docs/reference/rest/v1/licenses/testIamPermissions rpc TestIamPermissions(TestIamPermissionsRequest) returns (google.cloud.cpp.compute.v1.TestPermissionsResponse) { @@ -137,9 +148,10 @@ service Licenses { "project,resource,test_permissions_request_resource"; } - // Updates 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. + // Updates a License resource in the specified project. + // *Caution* This resource is intended + // for use only by third-party partners who are creatingCloud Marketplace + // images. // https://cloud.google.com/compute/docs/reference/rest/v1/licenses/update rpc UpdateLicense(UpdateLicenseRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -168,14 +180,17 @@ message DeleteLicenseRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; } @@ -220,72 +235,106 @@ message InsertLicenseRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; } // Request message for ListLicenses. message ListLicensesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -293,9 +342,11 @@ message ListLicensesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 6 [json_name = "returnPartialSuccess"]; } @@ -349,14 +400,17 @@ message UpdateLicenseRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; // update_mask indicates fields to be updated as part of this request. 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 b18fafe56036d..8a7291d1385d8 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: 20250601 +// revision: 20260807 syntax = "proto3"; @@ -24,12 +24,12 @@ 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_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_047.proto"; -import "google/cloud/compute/v1/internal/common_079.proto"; -import "google/cloud/compute/v1/internal/common_145.proto"; +import "google/cloud/compute/v1/internal/common_009.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_056.proto"; +import "google/cloud/compute/v1/internal/common_057.proto"; +import "google/cloud/compute/v1/internal/common_095.proto"; +import "google/cloud/compute/v1/internal/common_171.proto"; import "google/cloud/extended_operations.proto"; // Service for the machineImages resource. @@ -74,10 +74,11 @@ service MachineImages { option (google.api.method_signature) = "project,resource"; } - // 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. + // 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. // https://cloud.google.com/compute/docs/reference/rest/v1/machineImages/insert rpc InsertMachineImage(InsertMachineImageRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -89,8 +90,8 @@ service MachineImages { option (google.cloud.operation_service) = "GlobalOperations"; } - // Retrieves a list of machine images that are contained within the specified - // project. + // Retrieves a list of machine images that are contained within + // the specified project. // https://cloud.google.com/compute/docs/reference/rest/v1/machineImages/list rpc ListMachineImages(ListMachineImagesRequest) returns (google.cloud.cpp.compute.v1.MachineImageList) { @@ -100,8 +101,8 @@ service MachineImages { option (google.api.method_signature) = "project"; } - // Sets the access control policy on the specified resource. Replaces any - // existing policy. + // Sets the access control policy on the specified resource. + // Replaces any existing policy. // https://cloud.google.com/compute/docs/reference/rest/v1/machineImages/setIamPolicy rpc SetIamPolicy(SetIamPolicyRequest) returns (google.cloud.cpp.compute.v1.Policy) { @@ -113,8 +114,9 @@ service MachineImages { "project,resource,global_set_policy_request_resource"; } - // Sets the labels on a machine image. To learn more about labels, read the - // Labeling Resources documentation. + // Sets the labels on a machine image. To learn more about labels, read + // theLabeling + // Resources documentation. // https://cloud.google.com/compute/docs/reference/rest/v1/machineImages/setLabels rpc SetLabels(SetLabelsRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -155,14 +157,17 @@ message DeleteMachineImageRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; } @@ -207,14 +212,17 @@ message InsertMachineImageRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // Required. Source instance that is used to create the machine image from. @@ -224,58 +232,89 @@ message InsertMachineImageRequest { // Request message for ListMachineImages. message ListMachineImagesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -283,9 +322,11 @@ message ListMachineImagesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 6 [json_name = "returnPartialSuccess"]; } 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 3e5809cc2cc2a..54790944671e3 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: 20250601 +// revision: 20260807 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_080.proto"; +import "google/cloud/compute/v1/internal/common_021.proto"; // Service for the machineTypes resource. // https://cloud.google.com/compute/docs/reference/rest/v1/machineTypes @@ -35,8 +35,10 @@ service MachineTypes { "https://www.googleapis.com/auth/compute," "https://www.googleapis.com/auth/compute.readonly"; - // Retrieves an aggregated list of machine types. To prevent failure, Google - // recommends that you set the `returnPartialSuccess` parameter to `true`. + // Retrieves an aggregated list of machine types. + // + // To prevent failure, Google recommends that you set the + // `returnPartialSuccess` parameter to `true`. // https://cloud.google.com/compute/docs/reference/rest/v1/machineTypes/aggregatedList rpc AggregatedListMachineTypes(AggregatedListMachineTypesRequest) returns (google.cloud.cpp.compute.v1.MachineTypeAggregatedList) { @@ -56,7 +58,8 @@ service MachineTypes { option (google.api.method_signature) = "project,zone,machine_type"; } - // Retrieves a list of machine types available to the specified project. + // Retrieves a list of machine types available to the specified + // project. // https://cloud.google.com/compute/docs/reference/rest/v1/machineTypes/list rpc ListMachineTypes(ListMachineTypesRequest) returns (google.cloud.cpp.compute.v1.MachineTypeList) { @@ -70,37 +73,64 @@ service MachineTypes { // Request message for AggregatedListMachineTypes. message AggregatedListMachineTypesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; // Indicates whether every visible scope for each scope type (zone, region, @@ -112,25 +142,29 @@ message AggregatedListMachineTypesRequest { // will be included. optional bool include_all_scopes = 2 [json_name = "includeAllScopes"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 3 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 4 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 5 [json_name = "pageToken"]; // Project ID for this request. @@ -138,9 +172,11 @@ message AggregatedListMachineTypesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; // The Shared VPC service project id or service project number for which @@ -166,58 +202,89 @@ message GetMachineTypeRequest { // Request message for ListMachineTypes. message ListMachineTypesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -225,9 +292,11 @@ message ListMachineTypesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 6 [json_name = "returnPartialSuccess"]; // The name of the zone for this request. 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 eb13576134a2b..6af6e01dbafb4 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: 20250601 +// revision: 20260807 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_007.proto"; -import "google/cloud/compute/v1/internal/common_016.proto"; -import "google/cloud/compute/v1/internal/common_084.proto"; -import "google/cloud/compute/v1/internal/common_108.proto"; -import "google/cloud/compute/v1/internal/common_145.proto"; +import "google/cloud/compute/v1/internal/common_009.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_099.proto"; +import "google/cloud/compute/v1/internal/common_126.proto"; +import "google/cloud/compute/v1/internal/common_171.proto"; import "google/cloud/extended_operations.proto"; // Service for the networkAttachments resource. @@ -40,9 +40,11 @@ service NetworkAttachments { "https://www.googleapis.com/auth/compute," "https://www.googleapis.com/auth/compute.readonly"; - // 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`. + // 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`. // https://cloud.google.com/compute/docs/reference/rest/v1/networkAttachments/aggregatedList rpc AggregatedListNetworkAttachments(AggregatedListNetworkAttachmentsRequest) returns (google.cloud.cpp.compute.v1.NetworkAttachmentAggregatedList) { @@ -109,8 +111,9 @@ service NetworkAttachments { } // 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. + // the request. This method supports PATCH + // semantics and usesJSON merge + // patch format and processing rules. // https://cloud.google.com/compute/docs/reference/rest/v1/networkAttachments/patch rpc PatchNetworkAttachment(PatchNetworkAttachmentRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -123,8 +126,8 @@ service NetworkAttachments { option (google.cloud.operation_service) = "RegionOperations"; } - // Sets the access control policy on the specified resource. Replaces any - // existing policy. + // Sets the access control policy on the specified resource. + // Replaces any existing policy. // https://cloud.google.com/compute/docs/reference/rest/v1/networkAttachments/setIamPolicy rpc SetIamPolicy(SetIamPolicyRequest) returns (google.cloud.cpp.compute.v1.Policy) { @@ -152,37 +155,64 @@ service NetworkAttachments { // Request message for AggregatedListNetworkAttachments. message AggregatedListNetworkAttachmentsRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; // Indicates whether every visible scope for each scope type (zone, region, @@ -194,25 +224,29 @@ message AggregatedListNetworkAttachmentsRequest { // will be included. optional bool include_all_scopes = 2 [json_name = "includeAllScopes"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 3 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 4 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 5 [json_name = "pageToken"]; // Project ID for this request. @@ -220,9 +254,11 @@ message AggregatedListNetworkAttachmentsRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; // The Shared VPC service project id or service project number for which @@ -253,15 +289,18 @@ message DeleteNetworkAttachmentRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // 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 + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating 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 optional string request_id = 4 [json_name = "requestId"]; } @@ -321,73 +360,107 @@ message InsertNetworkAttachmentRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // 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 + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating 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 optional string request_id = 4 [json_name = "requestId"]; } // Request message for ListNetworkAttachments. message ListNetworkAttachmentsRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -399,9 +472,11 @@ message ListNetworkAttachmentsRequest { [(google.api.field_behavior) = REQUIRED, json_name = "region"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; } @@ -431,15 +506,18 @@ message PatchNetworkAttachmentRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // 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 + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating 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 optional string request_id = 5 [json_name = "requestId"]; } 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 6ae797b0f9997..73f7a954d6bd1 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: 20250601 +// revision: 20260807 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_016.proto"; -import "google/cloud/compute/v1/internal/common_085.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_100.proto"; import "google/cloud/extended_operations.proto"; // Service for the networkEdgeSecurityServices resource. @@ -38,8 +38,10 @@ service NetworkEdgeSecurityServices { "https://www.googleapis.com/auth/compute.readonly"; // 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`. + // the specified project. + // + // To prevent failure, Google recommends that you set the + // `returnPartialSuccess` parameter to `true`. // https://cloud.google.com/compute/docs/reference/rest/v1/networkEdgeSecurityServices/aggregatedList rpc AggregatedListNetworkEdgeSecurityServices( AggregatedListNetworkEdgeSecurityServicesRequest) @@ -105,37 +107,64 @@ service NetworkEdgeSecurityServices { // Request message for AggregatedListNetworkEdgeSecurityServices. message AggregatedListNetworkEdgeSecurityServicesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; // Indicates whether every visible scope for each scope type (zone, region, @@ -147,25 +176,29 @@ message AggregatedListNetworkEdgeSecurityServicesRequest { // will be included. optional bool include_all_scopes = 2 [json_name = "includeAllScopes"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 3 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 4 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 5 [json_name = "pageToken"]; // Name of the project scoping this request. @@ -173,9 +206,11 @@ message AggregatedListNetworkEdgeSecurityServicesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; // The Shared VPC service project id or service project number for which @@ -208,14 +243,17 @@ message DeleteNetworkEdgeSecurityServiceRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; } @@ -259,14 +297,17 @@ message InsertNetworkEdgeSecurityServiceRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; // If true, the request will not be committed. @@ -304,14 +345,17 @@ message PatchNetworkEdgeSecurityServiceRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 6 [json_name = "requestId"]; // Indicates fields to be updated as part of this request. 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 c69d798e6b195..5a63386f5e561 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: 20250601 +// revision: 20260807 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_012.proto"; -import "google/cloud/compute/v1/internal/common_016.proto"; -import "google/cloud/compute/v1/internal/common_086.proto"; -import "google/cloud/compute/v1/internal/common_145.proto"; +import "google/cloud/compute/v1/internal/common_015.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_101.proto"; +import "google/cloud/compute/v1/internal/common_171.proto"; import "google/cloud/extended_operations.proto"; // Service for the networkEndpointGroups resource. @@ -39,9 +39,10 @@ service NetworkEndpointGroups { "https://www.googleapis.com/auth/compute," "https://www.googleapis.com/auth/compute.readonly"; - // 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`. + // 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`. // https://cloud.google.com/compute/docs/reference/rest/v1/networkEndpointGroups/aggregatedList rpc AggregatedListNetworkEndpointGroups( AggregatedListNetworkEndpointGroupsRequest) @@ -107,6 +108,20 @@ service NetworkEndpointGroups { // Creates a network endpoint group in the specified project using the // parameters that are included in the request. + // + // Note: Use the following APIs to manage network endpoint groups: + // + // - + // To manage NEGs with zonal scope (such as zonal NEGs, hybrid connectivity + // NEGs): zonal + // API + // - + // To manage NEGs with regional scope (such as regional internet NEGs, + // serverless NEGs, Private Service Connect NEGs): regional + // API + // - + // To manage NEGs with global scope (such as global internet NEGs):global + // API // https://cloud.google.com/compute/docs/reference/rest/v1/networkEndpointGroups/insert rpc InsertNetworkEndpointGroup(InsertNetworkEndpointGroupRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -158,37 +173,64 @@ service NetworkEndpointGroups { // Request message for AggregatedListNetworkEndpointGroups. message AggregatedListNetworkEndpointGroupsRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; // Indicates whether every visible scope for each scope type (zone, region, @@ -200,25 +242,29 @@ message AggregatedListNetworkEndpointGroupsRequest { // will be included. optional bool include_all_scopes = 2 [json_name = "includeAllScopes"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 3 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 4 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 5 [json_name = "pageToken"]; // Project ID for this request. @@ -226,9 +272,11 @@ message AggregatedListNetworkEndpointGroupsRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; // The Shared VPC service project id or service project number for which @@ -261,18 +309,21 @@ message AttachNetworkEndpointsRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; - // The name of the zone where the network endpoint group is located. It should - // comply with RFC1035. + // The name of the zone where + // the network endpoint group is located. It should comply with RFC1035. string zone = 5 [ (google.api.field_behavior) = REQUIRED, (google.cloud.operation_request_field) = "zone", @@ -298,18 +349,21 @@ message DeleteNetworkEndpointGroupRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; - // The name of the zone where the network endpoint group is located. It should - // comply with RFC1035. + // The name of the zone where + // the network endpoint group is located. It should comply with RFC1035. string zone = 4 [ (google.api.field_behavior) = REQUIRED, (google.cloud.operation_request_field) = "zone", @@ -341,18 +395,21 @@ message DetachNetworkEndpointsRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; - // The name of the zone where the network endpoint group is located. It should - // comply with RFC1035. + // The name of the zone where + // the network endpoint group is located. It should comply with RFC1035. string zone = 5 [ (google.api.field_behavior) = REQUIRED, (google.cloud.operation_request_field) = "zone", @@ -372,8 +429,8 @@ message GetNetworkEndpointGroupRequest { string project = 2 [(google.api.field_behavior) = REQUIRED, json_name = "project"]; - // The name of the zone where the network endpoint group is located. It should - // comply with RFC1035. + // The name of the zone where + // the network endpoint group is located. It should comply with RFC1035. string zone = 3 [(google.api.field_behavior) = REQUIRED, json_name = "zone"]; } @@ -392,18 +449,22 @@ message InsertNetworkEndpointGroupRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; - // The name of the zone where you want to create the network endpoint group. - // It should comply with RFC1035. + // The name of the zone where + // you want to create the network endpoint group. It should comply with + // RFC1035. string zone = 4 [ (google.api.field_behavior) = REQUIRED, (google.cloud.operation_request_field) = "zone", @@ -414,58 +475,89 @@ message InsertNetworkEndpointGroupRequest { // Request message for ListNetworkEndpointGroups. message ListNetworkEndpointGroupsRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -473,57 +565,86 @@ message ListNetworkEndpointGroupsRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 6 [json_name = "returnPartialSuccess"]; - // The name of the zone where the network endpoint group is located. It should - // comply with RFC1035. + // The name of thezone + // where the network endpoint group is located. It should comply with RFC1035. string zone = 7 [(google.api.field_behavior) = REQUIRED, json_name = "zone"]; } // Request message for ListNetworkEndpoints. message ListNetworkEndpointsRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; // The name of the network endpoint group from which you want to generate a @@ -538,18 +659,22 @@ message ListNetworkEndpointsRequest { network_endpoint_groups_list_endpoints_request_resource = 4 [json_name = "__json_request_body"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 5 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 6 [json_name = "pageToken"]; // Project ID for this request. @@ -557,13 +682,15 @@ message ListNetworkEndpointsRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 8 [json_name = "returnPartialSuccess"]; - // The name of the zone where the network endpoint group is located. It should - // comply with RFC1035. + // The name of the zone where + // the network endpoint group is located. It should comply with RFC1035. string zone = 9 [(google.api.field_behavior) = REQUIRED, json_name = "zone"]; } 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 d9800d433fd7a..58605d6a1bd00 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: 20250601 +// revision: 20260807 syntax = "proto3"; @@ -24,13 +24,13 @@ 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_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_009.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_046.proto"; import "google/cloud/compute/v1/internal/common_047.proto"; -import "google/cloud/compute/v1/internal/common_145.proto"; +import "google/cloud/compute/v1/internal/common_048.proto"; +import "google/cloud/compute/v1/internal/common_057.proto"; +import "google/cloud/compute/v1/internal/common_171.proto"; import "google/cloud/extended_operations.proto"; // Service for the networkFirewallPolicies resource. @@ -82,8 +82,10 @@ service NetworkFirewallPolicies { // Retrieves an aggregated list of network firewall policies, listing network // firewall policies from all applicable scopes (global and regional) and - // grouping the results per scope. To prevent failure, Google recommends that - // you set the `returnPartialSuccess` parameter to `true`. + // grouping the results per scope. + // + // To prevent failure, it is recommended that you set the + // `returnPartialSuccess` parameter to `true`. // https://cloud.google.com/compute/docs/reference/rest/v1/networkFirewallPolicies/aggregatedList rpc AggregatedListNetworkFirewallPolicies( AggregatedListNetworkFirewallPoliciesRequest) @@ -267,8 +269,8 @@ service NetworkFirewallPolicies { option (google.cloud.operation_service) = "GlobalOperations"; } - // Sets the access control policy on the specified resource. Replaces any - // existing policy. + // Sets the access control policy on the specified resource. + // Replaces any existing policy. // https://cloud.google.com/compute/docs/reference/rest/v1/networkFirewallPolicies/setIamPolicy rpc SetIamPolicy(SetIamPolicyRequest) returns (google.cloud.cpp.compute.v1.Policy) { @@ -319,14 +321,17 @@ message AddAssociationRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 5 [json_name = "requestId"]; } @@ -340,12 +345,14 @@ message AddPacketMirroringRuleRequest { optional google.cloud.cpp.compute.v1.FirewallPolicyRule firewall_policy_rule_resource = 2 [json_name = "__json_request_body"]; - // When rule.priority is not specified, auto choose a unused priority between - // minPriority and maxPriority>. This field is exclusive with rule.priority. + // When rule.priority is not specified, auto choose a unused priority + // betweenminPriority and maxPriority>. + // This field is exclusive with rule.priority. optional int32 max_priority = 3 [json_name = "maxPriority"]; - // When rule.priority is not specified, auto choose a unused priority between - // minPriority and maxPriority>. This field is exclusive with rule.priority. + // When rule.priority is not specified, auto choose a unused priority + // betweenminPriority and maxPriority>. + // This field is exclusive with rule.priority. optional int32 min_priority = 4 [json_name = "minPriority"]; // Project ID for this request. @@ -357,14 +364,17 @@ message AddPacketMirroringRuleRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 6 [json_name = "requestId"]; } @@ -378,12 +388,14 @@ message AddRuleRequest { optional google.cloud.cpp.compute.v1.FirewallPolicyRule firewall_policy_rule_resource = 2 [json_name = "__json_request_body"]; - // When rule.priority is not specified, auto choose a unused priority between - // minPriority and maxPriority>. This field is exclusive with rule.priority. + // When rule.priority is not specified, auto choose a unused priority + // betweenminPriority and maxPriority>. + // This field is exclusive with rule.priority. optional int32 max_priority = 3 [json_name = "maxPriority"]; - // When rule.priority is not specified, auto choose a unused priority between - // minPriority and maxPriority>. This field is exclusive with rule.priority. + // When rule.priority is not specified, auto choose a unused priority + // betweenminPriority and maxPriority>. + // This field is exclusive with rule.priority. optional int32 min_priority = 4 [json_name = "minPriority"]; // Project ID for this request. @@ -395,51 +407,81 @@ message AddRuleRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 6 [json_name = "requestId"]; } // Request message for AggregatedListNetworkFirewallPolicies. message AggregatedListNetworkFirewallPoliciesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; // Indicates whether every visible scope for each scope type (zone, region, @@ -451,25 +493,29 @@ message AggregatedListNetworkFirewallPoliciesRequest { // will be included. optional bool include_all_scopes = 2 [json_name = "includeAllScopes"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 3 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 4 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 5 [json_name = "pageToken"]; // Project ID for this request. @@ -477,9 +523,11 @@ message AggregatedListNetworkFirewallPoliciesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; // The Shared VPC service project id or service project number for which @@ -503,14 +551,17 @@ message CloneRulesRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // The firewall policy from which to copy rules. @@ -533,14 +584,17 @@ message DeleteFirewallPolicyRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; } @@ -627,72 +681,106 @@ message InsertFirewallPolicyRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; } // Request message for ListNetworkFirewallPolicies. message ListNetworkFirewallPoliciesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -700,9 +788,11 @@ message ListNetworkFirewallPoliciesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 6 [json_name = "returnPartialSuccess"]; } @@ -725,14 +815,17 @@ message PatchFirewallPolicyRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; } @@ -758,14 +851,17 @@ message PatchPacketMirroringRuleRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 5 [json_name = "requestId"]; } @@ -791,14 +887,17 @@ message PatchRuleRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 5 [json_name = "requestId"]; } @@ -820,14 +919,17 @@ message RemoveAssociationRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; } @@ -849,14 +951,17 @@ message RemovePacketMirroringRuleRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; } @@ -878,14 +983,17 @@ message RemoveRuleRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; } diff --git a/protos/google/cloud/compute/network_profiles/v1/network_profiles.proto b/protos/google/cloud/compute/network_profiles/v1/network_profiles.proto index 0458edbf85fb7..bd84e3e78feef 100644 --- a/protos/google/cloud/compute/network_profiles/v1/network_profiles.proto +++ b/protos/google/cloud/compute/network_profiles/v1/network_profiles.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: 20250601 +// revision: 20260807 syntax = "proto3"; @@ -24,7 +24,7 @@ package google.cloud.cpp.compute.network_profiles.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_087.proto"; +import "google/cloud/compute/v1/internal/common_102.proto"; // Service for the networkProfiles resource. // https://cloud.google.com/compute/docs/reference/rest/v1/networkProfiles @@ -45,7 +45,8 @@ service NetworkProfiles { option (google.api.method_signature) = "project,network_profile"; } - // Retrieves a list of network profiles available to the specified project. + // Retrieves a list of network profiles available to the specified + // project. // https://cloud.google.com/compute/docs/reference/rest/v1/networkProfiles/list rpc ListNetworkProfiles(ListNetworkProfilesRequest) returns (google.cloud.cpp.compute.v1.NetworkProfilesListResponse) { @@ -70,58 +71,89 @@ message GetNetworkProfileRequest { // Request message for ListNetworkProfiles. message ListNetworkProfilesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -129,8 +161,10 @@ message ListNetworkProfilesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 6 [json_name = "returnPartialSuccess"]; } diff --git a/protos/google/cloud/compute/networks/v1/networks.proto b/protos/google/cloud/compute/networks/v1/networks.proto index 64747c1822aa4..b1a43195e7802 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: 20250601 +// revision: 20260807 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_016.proto"; -import "google/cloud/compute/v1/internal/common_030.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_039.proto"; import "google/cloud/extended_operations.proto"; // Service for the networks resource. @@ -50,6 +50,21 @@ service Networks { option (google.cloud.operation_service) = "GlobalOperations"; } + // Cancel requests to remove a peering from the specified network. Applicable + // only for PeeringConnection with update_strategy=CONSENSUS. Cancels a + // request to remove a peering from the specified network. + // https://cloud.google.com/compute/docs/reference/rest/v1/networks/cancelRequestRemovePeering + rpc CancelRequestRemovePeering(CancelRequestRemovePeeringRequest) + returns (google.cloud.cpp.compute.v1.Operation) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/global/networks/{network}/cancelRequestRemovePeering" + body: "networks_cancel_request_remove_peering_request_resource" + }; + option (google.api.method_signature) = + "project,network,networks_cancel_request_remove_peering_request_resource"; + option (google.cloud.operation_service) = "GlobalOperations"; + } + // Deletes the specified network. // https://cloud.google.com/compute/docs/reference/rest/v1/networks/delete rpc DeleteNetwork(DeleteNetworkRequest) @@ -81,8 +96,8 @@ service Networks { option (google.api.method_signature) = "project,network"; } - // Creates a network in the specified project using the data included in the - // request. + // Creates a network in the specified project using the data included + // in the request. // https://cloud.google.com/compute/docs/reference/rest/v1/networks/insert rpc InsertNetwork(InsertNetworkRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -114,8 +129,8 @@ service Networks { option (google.api.method_signature) = "project,network"; } - // Patches the specified network with the data included in the request. Only - // routingConfig can be modified. + // Patches the specified network with the data included in the request. + // Only routingConfig can be modified. // https://cloud.google.com/compute/docs/reference/rest/v1/networks/patch rpc PatchNetwork(PatchNetworkRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -140,6 +155,20 @@ service Networks { option (google.cloud.operation_service) = "GlobalOperations"; } + // Requests to remove a peering from the specified network. Applicable only + // for PeeringConnection with update_strategy=CONSENSUS. + // https://cloud.google.com/compute/docs/reference/rest/v1/networks/requestRemovePeering + rpc RequestRemovePeering(RequestRemovePeeringRequest) + returns (google.cloud.cpp.compute.v1.Operation) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/global/networks/{network}/requestRemovePeering" + body: "networks_request_remove_peering_request_resource" + }; + option (google.api.method_signature) = + "project,network,networks_request_remove_peering_request_resource"; + option (google.cloud.operation_service) = "GlobalOperations"; + } + // Switches the network mode from auto subnet mode to custom subnet mode. // https://cloud.google.com/compute/docs/reference/rest/v1/networks/switchToCustomMode rpc SwitchToCustomMode(SwitchToCustomModeRequest) @@ -188,14 +217,51 @@ message AddPeeringRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). + optional string request_id = 4 [json_name = "requestId"]; +} + +// Request message for CancelRequestRemovePeering. +message CancelRequestRemovePeeringRequest { + // Name of the network resource to remove peering from. + string network = 1 + [(google.api.field_behavior) = REQUIRED, json_name = "network"]; + + // The NetworksCancelRequestRemovePeeringRequest for this request. + optional google.cloud.cpp.compute.v1.NetworksCancelRequestRemovePeeringRequest + networks_cancel_request_remove_peering_request_resource = 2 + [json_name = "__json_request_body"]; + + // Project ID for this request. + string project = 3 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "project", + json_name = "project" + ]; + + // An optional request ID to identify requests. Specify a unique request ID so + // that if you must retry your request, the server will know to ignore the + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; } @@ -214,14 +280,17 @@ message DeleteNetworkRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; } @@ -262,72 +331,106 @@ message InsertNetworkRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; } // Request message for ListNetworks. message ListNetworksRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -335,9 +438,11 @@ message ListNetworksRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 6 [json_name = "returnPartialSuccess"]; } @@ -349,62 +454,93 @@ message ListPeeringRoutesRequest { optional string direction = 1 [json_name = "direction"]; // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 2 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 3 [json_name = "maxResults"]; // Name of the network for this request. string network = 4 [(google.api.field_behavior) = REQUIRED, json_name = "network"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 5 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 6 [json_name = "pageToken"]; // The response will show routes exchanged over the given peering connection. @@ -419,9 +555,11 @@ message ListPeeringRoutesRequest { optional string region = 9 [json_name = "region"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 10 [json_name = "returnPartialSuccess"]; } @@ -445,14 +583,17 @@ message PatchNetworkRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; } @@ -476,14 +617,51 @@ message RemovePeeringRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). + optional string request_id = 4 [json_name = "requestId"]; +} + +// Request message for RequestRemovePeering. +message RequestRemovePeeringRequest { + // Name of the network resource to remove peering from. + string network = 1 + [(google.api.field_behavior) = REQUIRED, json_name = "network"]; + + // The NetworksRequestRemovePeeringRequest for this request. + optional google.cloud.cpp.compute.v1.NetworksRequestRemovePeeringRequest + networks_request_remove_peering_request_resource = 2 + [json_name = "__json_request_body"]; + + // Project ID for this request. + string project = 3 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "project", + json_name = "project" + ]; + + // An optional request ID to identify requests. Specify a unique request ID so + // that if you must retry your request, the server will know to ignore the + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; } @@ -502,14 +680,17 @@ message SwitchToCustomModeRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; } @@ -533,13 +714,16 @@ message UpdatePeeringRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; } 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 be723ebd50d27..1a12f00c820b8 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: 20250601 +// revision: 20260807 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_007.proto"; -import "google/cloud/compute/v1/internal/common_016.proto"; -import "google/cloud/compute/v1/internal/common_058.proto"; -import "google/cloud/compute/v1/internal/common_145.proto"; -import "google/cloud/compute/v1/internal/common_152.proto"; +import "google/cloud/compute/v1/internal/common_009.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_072.proto"; +import "google/cloud/compute/v1/internal/common_171.proto"; +import "google/cloud/compute/v1/internal/common_182.proto"; import "google/cloud/extended_operations.proto"; // Service for the nodeGroups resource. @@ -53,9 +53,11 @@ service NodeGroups { option (google.cloud.operation_service) = "ZoneOperations"; } - // 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`. + // 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`. // https://cloud.google.com/compute/docs/reference/rest/v1/nodeGroups/aggregatedList rpc AggregatedListNodeGroups(AggregatedListNodeGroupsRequest) returns (google.cloud.cpp.compute.v1.NodeGroupAggregatedList) { @@ -89,9 +91,10 @@ service NodeGroups { option (google.cloud.operation_service) = "ZoneOperations"; } - // 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. + // 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. // https://cloud.google.com/compute/docs/reference/rest/v1/nodeGroups/get rpc GetNodeGroup(GetNodeGroupRequest) returns (google.cloud.cpp.compute.v1.NodeGroup) { @@ -126,8 +129,8 @@ service NodeGroups { option (google.cloud.operation_service) = "ZoneOperations"; } - // Retrieves a list of node groups available to the specified project. Note: - // use nodeGroups.listNodes for more details about each group. + // Retrieves a list of node groups available to the specified project. + // Note: use nodeGroups.listNodes for more details about each group. // https://cloud.google.com/compute/docs/reference/rest/v1/nodeGroups/list rpc ListNodeGroups(ListNodeGroupsRequest) returns (google.cloud.cpp.compute.v1.NodeGroupList) { @@ -174,8 +177,8 @@ service NodeGroups { option (google.cloud.operation_service) = "ZoneOperations"; } - // Sets the access control policy on the specified resource. Replaces any - // existing policy. + // Sets the access control policy on the specified resource. + // Replaces any existing policy. // https://cloud.google.com/compute/docs/reference/rest/v1/nodeGroups/setIamPolicy rpc SetIamPolicy(SetIamPolicyRequest) returns (google.cloud.cpp.compute.v1.Policy) { @@ -246,14 +249,17 @@ message AddNodesRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; // The name of the zone for this request. @@ -267,37 +273,64 @@ message AddNodesRequest { // Request message for AggregatedListNodeGroups. message AggregatedListNodeGroupsRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; // Indicates whether every visible scope for each scope type (zone, region, @@ -309,25 +342,29 @@ message AggregatedListNodeGroupsRequest { // will be included. optional bool include_all_scopes = 2 [json_name = "includeAllScopes"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 3 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 4 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 5 [json_name = "pageToken"]; // Project ID for this request. @@ -335,9 +372,11 @@ message AggregatedListNodeGroupsRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; // The Shared VPC service project id or service project number for which @@ -361,14 +400,17 @@ message DeleteNodeGroupRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // The name of the zone for this request. @@ -399,14 +441,17 @@ message DeleteNodesRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; // The name of the zone for this request. @@ -468,14 +513,17 @@ message InsertNodeGroupRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; // The name of the zone for this request. @@ -489,58 +537,89 @@ message InsertNodeGroupRequest { // Request message for ListNodeGroups. message ListNodeGroupsRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -548,9 +627,11 @@ message ListNodeGroupsRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 6 [json_name = "returnPartialSuccess"]; // The name of the zone for this request. @@ -560,62 +641,93 @@ message ListNodeGroupsRequest { // Request message for ListNodes. message ListNodesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; // Name of the NodeGroup resource whose nodes you want to list. string node_group = 3 [(google.api.field_behavior) = REQUIRED, json_name = "nodeGroup"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 4 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 5 [json_name = "pageToken"]; // Project ID for this request. @@ -623,9 +735,11 @@ message ListNodesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; // The name of the zone for this request. @@ -651,14 +765,17 @@ message PatchNodeGroupRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; // The name of the zone for this request. @@ -689,14 +806,17 @@ message PerformMaintenanceRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; // The name of the zone for this request. @@ -745,14 +865,17 @@ message SetNodeTemplateRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; // The name of the zone for this request. @@ -784,14 +907,17 @@ message SimulateMaintenanceEventRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; // The name of the zone for this request. 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 9a618afee05ee..8693f0dd129e3 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: 20250601 +// revision: 20260807 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_007.proto"; -import "google/cloud/compute/v1/internal/common_016.proto"; -import "google/cloud/compute/v1/internal/common_088.proto"; -import "google/cloud/compute/v1/internal/common_108.proto"; -import "google/cloud/compute/v1/internal/common_145.proto"; +import "google/cloud/compute/v1/internal/common_009.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_103.proto"; +import "google/cloud/compute/v1/internal/common_126.proto"; +import "google/cloud/compute/v1/internal/common_171.proto"; import "google/cloud/extended_operations.proto"; // Service for the nodeTemplates resource. @@ -40,8 +40,10 @@ service NodeTemplates { "https://www.googleapis.com/auth/compute," "https://www.googleapis.com/auth/compute.readonly"; - // Retrieves an aggregated list of node templates. To prevent failure, Google - // recommends that you set the `returnPartialSuccess` parameter to `true`. + // Retrieves an aggregated list of node templates. + // + // To prevent failure, Google recommends that you set the + // `returnPartialSuccess` parameter to `true`. // https://cloud.google.com/compute/docs/reference/rest/v1/nodeTemplates/aggregatedList rpc AggregatedListNodeTemplates(AggregatedListNodeTemplatesRequest) returns (google.cloud.cpp.compute.v1.NodeTemplateAggregatedList) { @@ -97,7 +99,8 @@ service NodeTemplates { option (google.cloud.operation_service) = "RegionOperations"; } - // Retrieves a list of node templates available to the specified project. + // Retrieves a list of node templates available to the specified + // project. // https://cloud.google.com/compute/docs/reference/rest/v1/nodeTemplates/list rpc ListNodeTemplates(ListNodeTemplatesRequest) returns (google.cloud.cpp.compute.v1.NodeTemplateList) { @@ -107,8 +110,8 @@ service NodeTemplates { option (google.api.method_signature) = "project,region"; } - // Sets the access control policy on the specified resource. Replaces any - // existing policy. + // Sets the access control policy on the specified resource. + // Replaces any existing policy. // https://cloud.google.com/compute/docs/reference/rest/v1/nodeTemplates/setIamPolicy rpc SetIamPolicy(SetIamPolicyRequest) returns (google.cloud.cpp.compute.v1.Policy) { @@ -136,37 +139,64 @@ service NodeTemplates { // Request message for AggregatedListNodeTemplates. message AggregatedListNodeTemplatesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; // Indicates whether every visible scope for each scope type (zone, region, @@ -178,25 +208,29 @@ message AggregatedListNodeTemplatesRequest { // will be included. optional bool include_all_scopes = 2 [json_name = "includeAllScopes"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 3 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 4 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 5 [json_name = "pageToken"]; // Project ID for this request. @@ -204,9 +238,11 @@ message AggregatedListNodeTemplatesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; // The Shared VPC service project id or service project number for which @@ -237,14 +273,17 @@ message DeleteNodeTemplateRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; } @@ -304,72 +343,106 @@ message InsertNodeTemplateRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; } // Request message for ListNodeTemplates. message ListNodeTemplatesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -381,9 +454,11 @@ message ListNodeTemplatesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "region"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; } 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 b3c698edbcabf..d8b3ae69cb23e 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: 20250601 +// revision: 20260807 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_089.proto"; +import "google/cloud/compute/v1/internal/common_104.proto"; // Service for the nodeTypes resource. // https://cloud.google.com/compute/docs/reference/rest/v1/nodeTypes @@ -35,8 +35,10 @@ service NodeTypes { "https://www.googleapis.com/auth/compute," "https://www.googleapis.com/auth/compute.readonly"; - // Retrieves an aggregated list of node types. To prevent failure, Google - // recommends that you set the `returnPartialSuccess` parameter to `true`. + // Retrieves an aggregated list of node types. + // + // To prevent failure, Google recommends that you set the + // `returnPartialSuccess` parameter to `true`. // https://cloud.google.com/compute/docs/reference/rest/v1/nodeTypes/aggregatedList rpc AggregatedListNodeTypes(AggregatedListNodeTypesRequest) returns (google.cloud.cpp.compute.v1.NodeTypeAggregatedList) { @@ -56,7 +58,8 @@ service NodeTypes { option (google.api.method_signature) = "project,zone,node_type"; } - // Retrieves a list of node types available to the specified project. + // Retrieves a list of node types available to the specified + // project. // https://cloud.google.com/compute/docs/reference/rest/v1/nodeTypes/list rpc ListNodeTypes(ListNodeTypesRequest) returns (google.cloud.cpp.compute.v1.NodeTypeList) { @@ -70,37 +73,64 @@ service NodeTypes { // Request message for AggregatedListNodeTypes. message AggregatedListNodeTypesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; // Indicates whether every visible scope for each scope type (zone, region, @@ -112,25 +142,29 @@ message AggregatedListNodeTypesRequest { // will be included. optional bool include_all_scopes = 2 [json_name = "includeAllScopes"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 3 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 4 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 5 [json_name = "pageToken"]; // Project ID for this request. @@ -138,9 +172,11 @@ message AggregatedListNodeTypesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; // The Shared VPC service project id or service project number for which @@ -166,58 +202,89 @@ message GetNodeTypeRequest { // Request message for ListNodeTypes. message ListNodeTypesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -225,9 +292,11 @@ message ListNodeTypesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 6 [json_name = "returnPartialSuccess"]; // The name of the zone for this request. diff --git a/protos/google/cloud/compute/organization_security_policies/v1/organization_security_policies.proto b/protos/google/cloud/compute/organization_security_policies/v1/organization_security_policies.proto new file mode 100644 index 0000000000000..5ee0440721e72 --- /dev/null +++ b/protos/google/cloud/compute/organization_security_policies/v1/organization_security_policies.proto @@ -0,0 +1,792 @@ +// Copyright 2026 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: 20260807 + +syntax = "proto3"; + +package google.cloud.cpp.compute.organization_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_019.proto"; +import "google/cloud/compute/v1/internal/common_108.proto"; +import "google/cloud/compute/v1/internal/common_111.proto"; +import "google/cloud/compute/v1/internal/common_141.proto"; +import "google/cloud/extended_operations.proto"; + +// Service for the organizationSecurityPolicies resource. +// https://cloud.google.com/compute/docs/reference/rest/v1/organizationSecurityPolicies +service OrganizationSecurityPolicies { + option (google.api.default_host) = "compute.googleapis.com"; + option (google.api.oauth_scopes) = + "https://www.googleapis.com/auth/cloud-platform," + "https://www.googleapis.com/auth/compute," + "https://www.googleapis.com/auth/compute.readonly"; + + // Inserts an association for the specified security policy. + // + // This has billing implications. Projects in the hierarchy with effective + // hierarchical security policies will be automatically enrolled into Cloud + // Armor Enterprise if not already enrolled. + // + // Use this API to modify Cloud Armor policies. Previously, alpha and beta + // versions of this API were used to modify firewall policies. This usage is + // now disabled for most organizations. Use firewallPolicies.addAssociation + // instead. + // https://cloud.google.com/compute/docs/reference/rest/v1/organizationSecurityPolicies/addAssociation + rpc AddAssociation(AddAssociationRequest) + returns (google.cloud.cpp.compute.v1.Operation) { + option (google.api.http) = { + post: "/compute/v1/locations/global/securityPolicies/{security_policy}/addAssociation" + body: "security_policy_association_resource" + }; + option (google.api.method_signature) = + "security_policy,security_policy_association_resource"; + option (google.cloud.operation_service) = "GlobalOrganizationOperations"; + } + + // Inserts a rule into a security policy. + // + // Use this API to modify Cloud Armor policies. Previously, alpha and beta + // versions of this API were used to modify firewall policies. This usage is + // now disabled for most organizations. Use firewallPolicies.addRule instead. + // https://cloud.google.com/compute/docs/reference/rest/v1/organizationSecurityPolicies/addRule + rpc AddRule(AddRuleRequest) returns (google.cloud.cpp.compute.v1.Operation) { + option (google.api.http) = { + post: "/compute/v1/locations/global/securityPolicies/{security_policy}/addRule" + body: "security_policy_rule_resource" + }; + option (google.api.method_signature) = + "security_policy,security_policy_rule_resource"; + option (google.cloud.operation_service) = "GlobalOrganizationOperations"; + } + + // Copies rules to the specified security policy. + // + // Use this API to modify Cloud Armor policies. Previously, alpha and beta + // versions of this API were used to modify firewall policies. This usage is + // now disabled for most organizations. Use firewallPolicies.cloneRules + // instead. + // https://cloud.google.com/compute/docs/reference/rest/v1/organizationSecurityPolicies/copyRules + rpc CopyRules(CopyRulesRequest) + returns (google.cloud.cpp.compute.v1.Operation) { + option (google.api.http) = { + post: "/compute/v1/locations/global/securityPolicies/{security_policy}/copyRules" + body: "*" + }; + option (google.api.method_signature) = "security_policy"; + option (google.cloud.operation_service) = "GlobalOrganizationOperations"; + } + + // Deletes the specified policy. + // + // Use this API to remove Cloud Armor policies. Previously, alpha and beta + // versions of this API were used to remove firewall policies. This usage is + // now disabled for most organizations. Use firewallPolicies.delete instead. + // https://cloud.google.com/compute/docs/reference/rest/v1/organizationSecurityPolicies/delete + rpc DeleteSecurityPolicy(DeleteSecurityPolicyRequest) + returns (google.cloud.cpp.compute.v1.Operation) { + option (google.api.http) = { + delete: "/compute/v1/locations/global/securityPolicies/{security_policy}" + }; + option (google.api.method_signature) = "security_policy"; + option (google.cloud.operation_service) = "GlobalOrganizationOperations"; + } + + // List all of the ordered rules present in a single specified policy. + // + // Use this API to read Cloud Armor policies. Previously, alpha and beta + // versions of this API were used to read firewall policies. This usage is now + // disabled for most organizations. Use firewallPolicies.get instead. + // https://cloud.google.com/compute/docs/reference/rest/v1/organizationSecurityPolicies/get + rpc GetSecurityPolicy(GetSecurityPolicyRequest) + returns (google.cloud.cpp.compute.v1.SecurityPolicy) { + option (google.api.http) = { + get: "/compute/v1/locations/global/securityPolicies/{security_policy}" + }; + option (google.api.method_signature) = "security_policy"; + } + + // Gets an association with the specified name. + // + // Use this API to read Cloud Armor policies. Previously, alpha and beta + // versions of this API were used to read firewall policies. This usage is + // now disabled for most organizations. Use firewallPolicies.getAssociation + // instead. + // https://cloud.google.com/compute/docs/reference/rest/v1/organizationSecurityPolicies/getAssociation + rpc GetAssociation(GetAssociationRequest) + returns (google.cloud.cpp.compute.v1.SecurityPolicyAssociation) { + option (google.api.http) = { + get: "/compute/v1/locations/global/securityPolicies/{security_policy}/getAssociation" + }; + option (google.api.method_signature) = "security_policy"; + } + + // Gets a rule at the specified priority. + // + // Use this API to read Cloud Armor policies. Previously, alpha and beta + // versions of this API were used to read firewall policies. This usage is now + // disabled for most organizations. Use firewallPolicies.getRule instead. + // https://cloud.google.com/compute/docs/reference/rest/v1/organizationSecurityPolicies/getRule + rpc GetRule(GetRuleRequest) + returns (google.cloud.cpp.compute.v1.SecurityPolicyRule) { + option (google.api.http) = { + get: "/compute/v1/locations/global/securityPolicies/{security_policy}/getRule" + }; + option (google.api.method_signature) = "security_policy"; + } + + // Creates a new policy in the specified organization using the data included + // in the request. + // + // Use this API to add Cloud Armor policies. Previously, alpha and beta + // versions of this API were used to add firewall policies. This usage is now + // disabled for most organizations. Use firewallPolicies.insert instead. + // https://cloud.google.com/compute/docs/reference/rest/v1/organizationSecurityPolicies/insert + rpc InsertSecurityPolicy(InsertSecurityPolicyRequest) + returns (google.cloud.cpp.compute.v1.Operation) { + option (google.api.http) = { + post: "/compute/v1/locations/global/securityPolicies" + body: "security_policy_resource" + }; + option (google.cloud.operation_service) = "GlobalOrganizationOperations"; + } + + // List all the policies that have been configured for the specified + // organization. + // + // Use this API to read Cloud Armor policies. Previously, alpha and beta + // versions of this API were used to read firewall policies. This usage is now + // disabled for most organizations. Use firewallPolicies.list instead. + // https://cloud.google.com/compute/docs/reference/rest/v1/organizationSecurityPolicies/list + rpc ListOrganizationSecurityPolicies(ListOrganizationSecurityPoliciesRequest) + returns (google.cloud.cpp.compute.v1.SecurityPolicyList) { + option (google.api.http) = { + get: "/compute/v1/locations/global/securityPolicies" + }; + } + + // Lists associations of a specified target, i.e., organization or folder. + // + // Use this API to read Cloud Armor policies. Previously, alpha and beta + // versions of this API were used to read firewall policies. This usage is + // now disabled for most organizations. Use firewallPolicies.listAssociations + // instead. + // https://cloud.google.com/compute/docs/reference/rest/v1/organizationSecurityPolicies/listAssociations + rpc ListAssociations(ListAssociationsRequest) + returns (google.cloud.cpp.compute.v1 + .OrganizationSecurityPoliciesListAssociationsResponse) { + option (google.api.http) = { + get: "/compute/v1/locations/global/securityPolicies/listAssociations" + }; + } + + // Gets the current list of preconfigured Web Application Firewall (WAF) + // expressions. + // https://cloud.google.com/compute/docs/reference/rest/v1/organizationSecurityPolicies/listPreconfiguredExpressionSets + rpc ListPreconfiguredExpressionSets(ListPreconfiguredExpressionSetsRequest) + returns (google.cloud.cpp.compute.v1 + .SecurityPoliciesListPreconfiguredExpressionSetsResponse) { + option (google.api.http) = { + get: "/compute/v1/locations/global/securityPolicies/listPreconfiguredExpressionSets" + }; + } + + // Moves the specified security policy. + // + // Use this API to modify Cloud Armor policies. Previously, alpha and beta + // versions of this API were used to modify firewall policies. This usage is + // now disabled for most organizations. Use firewallPolicies.move instead. + // https://cloud.google.com/compute/docs/reference/rest/v1/organizationSecurityPolicies/move + rpc Move(MoveRequest) returns (google.cloud.cpp.compute.v1.Operation) { + option (google.api.http) = { + post: "/compute/v1/locations/global/securityPolicies/{security_policy}/move" + body: "*" + }; + option (google.api.method_signature) = "security_policy"; + option (google.cloud.operation_service) = "GlobalOrganizationOperations"; + } + + // Patches the specified policy with the data included in the request. + // + // Use this API to modify Cloud Armor policies. Previously, alpha and beta + // versions of this API were used to modify firewall policies. This usage is + // now disabled for most organizations. Use firewallPolicies.patch instead. + // https://cloud.google.com/compute/docs/reference/rest/v1/organizationSecurityPolicies/patch + rpc PatchSecurityPolicy(PatchSecurityPolicyRequest) + returns (google.cloud.cpp.compute.v1.Operation) { + option (google.api.http) = { + patch: "/compute/v1/locations/global/securityPolicies/{security_policy}" + body: "security_policy_resource" + }; + option (google.api.method_signature) = + "security_policy,security_policy_resource"; + option (google.cloud.operation_service) = "GlobalOrganizationOperations"; + } + + // Patches a rule at the specified priority. + // + // Use this API to modify Cloud Armor policies. Previously, alpha and beta + // versions of this API were used to modify firewall policies. This usage is + // now disabled for most organizations. Use firewallPolicies.patchRule + // instead. + // https://cloud.google.com/compute/docs/reference/rest/v1/organizationSecurityPolicies/patchRule + rpc PatchRule(PatchRuleRequest) + returns (google.cloud.cpp.compute.v1.Operation) { + option (google.api.http) = { + post: "/compute/v1/locations/global/securityPolicies/{security_policy}/patchRule" + body: "security_policy_rule_resource" + }; + option (google.api.method_signature) = + "security_policy,security_policy_rule_resource"; + option (google.cloud.operation_service) = "GlobalOrganizationOperations"; + } + + // Removes an association for the specified security policy. + // + // Use this API to modify Cloud Armor policies. Previously, alpha and beta + // versions of this API were used to modify firewall policies. This usage is + // now disabled for most organizations. Use firewallPolicies.removeAssociation + // instead. + // https://cloud.google.com/compute/docs/reference/rest/v1/organizationSecurityPolicies/removeAssociation + rpc RemoveAssociation(RemoveAssociationRequest) + returns (google.cloud.cpp.compute.v1.Operation) { + option (google.api.http) = { + post: "/compute/v1/locations/global/securityPolicies/{security_policy}/removeAssociation" + body: "*" + }; + option (google.api.method_signature) = "security_policy"; + option (google.cloud.operation_service) = "GlobalOrganizationOperations"; + } + + // Deletes a rule at the specified priority. + // + // Use this API to modify Cloud Armor policies. Previously, alpha and beta + // versions of this API were used to modify firewall policies. This usage is + // now disabled for most organizations. Use firewallPolicies.removeRule + // instead. + // https://cloud.google.com/compute/docs/reference/rest/v1/organizationSecurityPolicies/removeRule + rpc RemoveRule(RemoveRuleRequest) + returns (google.cloud.cpp.compute.v1.Operation) { + option (google.api.http) = { + post: "/compute/v1/locations/global/securityPolicies/{security_policy}/removeRule" + body: "*" + }; + option (google.api.method_signature) = "security_policy"; + option (google.cloud.operation_service) = "GlobalOrganizationOperations"; + } +} + +// Request message for AddAssociation. +message AddAssociationRequest { + // 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. + optional bool replace_existing_association = 1 + [json_name = "replaceExistingAssociation"]; + + // An optional request ID to identify requests. Specify a unique request ID so + // that if you must retry your request, the server will know to ignore the + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). + optional string request_id = 2 [json_name = "requestId"]; + + // Name of the security policy to update. + string security_policy = 3 + [(google.api.field_behavior) = REQUIRED, json_name = "securityPolicy"]; + + // The SecurityPolicyAssociation for this request. + optional google.cloud.cpp.compute.v1.SecurityPolicyAssociation + security_policy_association_resource = 4 + [json_name = "__json_request_body"]; +} + +// Request message for AddRule. +message AddRuleRequest { + // An optional request ID to identify requests. Specify a unique request ID so + // that if you must retry your request, the server will know to ignore the + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). + optional string request_id = 1 [json_name = "requestId"]; + + // Name of the security policy to update. + string security_policy = 2 + [(google.api.field_behavior) = REQUIRED, json_name = "securityPolicy"]; + + // The SecurityPolicyRule for this request. + optional google.cloud.cpp.compute.v1.SecurityPolicyRule + security_policy_rule_resource = 3 [json_name = "__json_request_body"]; +} + +// Request message for CopyRules. +message CopyRulesRequest { + // An optional request ID to identify requests. Specify a unique request ID so + // that if you must retry your request, the server will know to ignore the + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). + optional string request_id = 1 [json_name = "requestId"]; + + // Name of the security policy to update. + string security_policy = 2 + [(google.api.field_behavior) = REQUIRED, json_name = "securityPolicy"]; + + // The security policy from which to copy rules. + optional string source_security_policy = 3 + [json_name = "sourceSecurityPolicy"]; +} + +// Request message for DeleteSecurityPolicy. +message DeleteSecurityPolicyRequest { + // An optional request ID to identify requests. Specify a unique request ID so + // that if you must retry your request, the server will know to ignore the + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). + optional string request_id = 1 [json_name = "requestId"]; + + // Name of the security policy to delete. + string security_policy = 2 + [(google.api.field_behavior) = REQUIRED, json_name = "securityPolicy"]; +} + +// Request message for GetAssociation. +message GetAssociationRequest { + // The name of the association to get from the security policy. + optional string name = 1 [json_name = "name"]; + + // Name of the security policy to which the queried rule belongs. + string security_policy = 2 + [(google.api.field_behavior) = REQUIRED, json_name = "securityPolicy"]; +} + +// Request message for GetRule. +message GetRuleRequest { + // The priority of the rule to get from the security policy. + optional int32 priority = 1 [json_name = "priority"]; + + // Name of the security policy to which the queried rule belongs. + string security_policy = 2 + [(google.api.field_behavior) = REQUIRED, json_name = "securityPolicy"]; +} + +// Request message for GetSecurityPolicy. +message GetSecurityPolicyRequest { + // Name of the security policy to get. + string security_policy = 1 + [(google.api.field_behavior) = REQUIRED, json_name = "securityPolicy"]; +} + +// Request message for InsertSecurityPolicy. +message InsertSecurityPolicyRequest { + // 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. + optional string parent_id = 1 [json_name = "parentId"]; + + // An optional request ID to identify requests. Specify a unique request ID so + // that if you must retry your request, the server will know to ignore the + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). + optional string request_id = 2 [json_name = "requestId"]; + + // The SecurityPolicy for this request. + optional google.cloud.cpp.compute.v1.SecurityPolicy security_policy_resource = + 3 [json_name = "__json_request_body"]; +} + +// Request message for ListAssociations. +message ListAssociationsRequest { + // The target resource to list associations. It is an organization, or a + // folder. + optional string target_resource = 1 [json_name = "targetResource"]; +} + +// Request message for ListOrganizationSecurityPolicies. +message ListOrganizationSecurityPoliciesRequest { + // A filter expression that filters resources listed in the response. Most + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. + optional string filter = 1 [json_name = "filter"]; + + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) + optional uint32 max_results = 2 [json_name = "maxResults"]; + + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or + // `creationTimestamp desc` is supported. + optional string order_by = 3 [json_name = "orderBy"]; + + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. + optional string page_token = 4 [json_name = "pageToken"]; + + // Parent ID for this request. + optional string parent_id = 5 [json_name = "parentId"]; + + // Opt-in for partial success behavior which provides partial results in case + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. + optional bool return_partial_success = 6 [json_name = "returnPartialSuccess"]; +} + +// Request message for ListPreconfiguredExpressionSets. +message ListPreconfiguredExpressionSetsRequest { + // A filter expression that filters resources listed in the response. Most + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. + optional string filter = 1 [json_name = "filter"]; + + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) + optional uint32 max_results = 2 [json_name = "maxResults"]; + + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or + // `creationTimestamp desc` is supported. + optional string order_by = 3 [json_name = "orderBy"]; + + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. + optional string page_token = 4 [json_name = "pageToken"]; + + // Parent ID for this request. + optional string parent_id = 5 [json_name = "parentId"]; + + // Opt-in for partial success behavior which provides partial results in case + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. + optional bool return_partial_success = 6 [json_name = "returnPartialSuccess"]; +} + +// Request message for Move. +message MoveRequest { + // The new parent of the security policy. + optional string parent_id = 1 [json_name = "parentId"]; + + // An optional request ID to identify requests. Specify a unique request ID so + // that if you must retry your request, the server will know to ignore the + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). + optional string request_id = 2 [json_name = "requestId"]; + + // Name of the security policy to update. + string security_policy = 3 + [(google.api.field_behavior) = REQUIRED, json_name = "securityPolicy"]; +} + +// Request message for PatchRule. +message PatchRuleRequest { + // The priority of the rule to patch. + optional int32 priority = 1 [json_name = "priority"]; + + // An optional request ID to identify requests. Specify a unique request ID so + // that if you must retry your request, the server will know to ignore the + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). + optional string request_id = 2 [json_name = "requestId"]; + + // Name of the security policy to update. + string security_policy = 3 + [(google.api.field_behavior) = REQUIRED, json_name = "securityPolicy"]; + + // The SecurityPolicyRule for this request. + optional google.cloud.cpp.compute.v1.SecurityPolicyRule + security_policy_rule_resource = 4 [json_name = "__json_request_body"]; +} + +// Request message for PatchSecurityPolicy. +message PatchSecurityPolicyRequest { + // An optional request ID to identify requests. Specify a unique request ID so + // that if you must retry your request, the server will know to ignore the + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). + optional string request_id = 1 [json_name = "requestId"]; + + // Name of the security policy to update. + string security_policy = 2 + [(google.api.field_behavior) = REQUIRED, json_name = "securityPolicy"]; + + // The SecurityPolicy for this request. + optional google.cloud.cpp.compute.v1.SecurityPolicy security_policy_resource = + 3 [json_name = "__json_request_body"]; +} + +// Request message for RemoveAssociation. +message RemoveAssociationRequest { + // Name for the attachment that will be removed. + optional string name = 1 [json_name = "name"]; + + // An optional request ID to identify requests. Specify a unique request ID so + // that if you must retry your request, the server will know to ignore the + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). + optional string request_id = 2 [json_name = "requestId"]; + + // Name of the security policy to update. + string security_policy = 3 + [(google.api.field_behavior) = REQUIRED, json_name = "securityPolicy"]; +} + +// Request message for RemoveRule. +message RemoveRuleRequest { + // The priority of the rule to remove from the security policy. + optional int32 priority = 1 [json_name = "priority"]; + + // An optional request ID to identify requests. Specify a unique request ID so + // that if you must retry your request, the server will know to ignore the + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). + optional string request_id = 2 [json_name = "requestId"]; + + // Name of the security policy to update. + string security_policy = 3 + [(google.api.field_behavior) = REQUIRED, json_name = "securityPolicy"]; +} 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 6ebd952e70d40..afe9f68c15e6d 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: 20250601 +// revision: 20260807 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_016.proto"; -import "google/cloud/compute/v1/internal/common_093.proto"; -import "google/cloud/compute/v1/internal/common_145.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_109.proto"; +import "google/cloud/compute/v1/internal/common_171.proto"; import "google/cloud/extended_operations.proto"; // Service for the packetMirrorings resource. @@ -38,9 +38,10 @@ service PacketMirrorings { "https://www.googleapis.com/auth/compute," "https://www.googleapis.com/auth/compute.readonly"; - // Retrieves an aggregated list of packetMirrorings. To prevent failure, - // Google recommends that you set the `returnPartialSuccess` parameter to - // `true`. + // Retrieves an aggregated list of packetMirrorings. + // + // To prevent failure, Google recommends that you set the + // `returnPartialSuccess` parameter to `true`. // https://cloud.google.com/compute/docs/reference/rest/v1/packetMirrorings/aggregatedList rpc AggregatedListPacketMirrorings(AggregatedListPacketMirroringsRequest) returns (google.cloud.cpp.compute.v1.PacketMirroringAggregatedList) { @@ -97,8 +98,9 @@ service PacketMirrorings { } // 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. + // the request. This method supportsPATCH + // semantics and usesJSON merge + // patch format and processing rules. // https://cloud.google.com/compute/docs/reference/rest/v1/packetMirrorings/patch rpc PatchPacketMirroring(PatchPacketMirroringRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -127,37 +129,64 @@ service PacketMirrorings { // Request message for AggregatedListPacketMirrorings. message AggregatedListPacketMirroringsRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; // Indicates whether every visible scope for each scope type (zone, region, @@ -169,25 +198,29 @@ message AggregatedListPacketMirroringsRequest { // will be included. optional bool include_all_scopes = 2 [json_name = "includeAllScopes"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 3 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 4 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 5 [json_name = "pageToken"]; // Project ID for this request. @@ -195,9 +228,11 @@ message AggregatedListPacketMirroringsRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; // The Shared VPC service project id or service project number for which @@ -228,14 +263,17 @@ message DeletePacketMirroringRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; } @@ -276,72 +314,106 @@ message InsertPacketMirroringRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; } // Request message for ListPacketMirrorings. message ListPacketMirroringsRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -353,9 +425,11 @@ message ListPacketMirroringsRequest { [(google.api.field_behavior) = REQUIRED, json_name = "region"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; } @@ -385,14 +459,17 @@ message PatchPacketMirroringRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 5 [json_name = "requestId"]; } diff --git a/protos/google/cloud/compute/preview_features/v1/preview_features.proto b/protos/google/cloud/compute/preview_features/v1/preview_features.proto new file mode 100644 index 0000000000000..9f83ea8ae38e2 --- /dev/null +++ b/protos/google/cloud/compute/preview_features/v1/preview_features.proto @@ -0,0 +1,218 @@ +// Copyright 2026 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: 20260807 + +syntax = "proto3"; + +package google.cloud.cpp.compute.preview_features.v1; + +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_030.proto"; +import "google/cloud/extended_operations.proto"; + +// Service for the previewFeatures resource. +// https://cloud.google.com/compute/docs/reference/rest/v1/previewFeatures +service PreviewFeatures { + option (google.api.default_host) = "compute.googleapis.com"; + option (google.api.oauth_scopes) = + "https://www.googleapis.com/auth/cloud-platform," + "https://www.googleapis.com/auth/compute," + "https://www.googleapis.com/auth/compute.readonly"; + + // Returns the details of the given PreviewFeature. + // https://cloud.google.com/compute/docs/reference/rest/v1/previewFeatures/get + rpc GetPreviewFeature(GetPreviewFeatureRequest) + returns (google.cloud.cpp.compute.v1.PreviewFeature) { + option (google.api.http) = { + get: "/compute/v1/projects/{project}/global/previewFeatures/{preview_feature}" + }; + option (google.api.method_signature) = "project,preview_feature"; + } + + // Returns the details of the given PreviewFeature. + // https://cloud.google.com/compute/docs/reference/rest/v1/previewFeatures/list + rpc ListPreviewFeatures(ListPreviewFeaturesRequest) + returns (google.cloud.cpp.compute.v1.PreviewFeatureList) { + option (google.api.http) = { + get: "/compute/v1/projects/{project}/global/previewFeatures" + }; + option (google.api.method_signature) = "project"; + } + + // Patches the given PreviewFeature. This method is used to enable or disable + // a PreviewFeature. + // https://cloud.google.com/compute/docs/reference/rest/v1/previewFeatures/update + rpc UpdatePreviewFeature(UpdatePreviewFeatureRequest) + returns (google.cloud.cpp.compute.v1.Operation) { + option (google.api.http) = { + patch: "/compute/v1/projects/{project}/global/previewFeatures/{preview_feature}" + body: "preview_feature_resource" + }; + option (google.api.method_signature) = + "project,preview_feature,preview_feature_resource"; + option (google.cloud.operation_service) = "GlobalOperations"; + } +} + +// Request message for GetPreviewFeature. +message GetPreviewFeatureRequest { + // Name of the PreviewFeature for this request. + string preview_feature = 1 + [(google.api.field_behavior) = REQUIRED, json_name = "previewFeature"]; + + // Project ID for this request. + string project = 2 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; +} + +// Request message for ListPreviewFeatures. +message ListPreviewFeaturesRequest { + // A filter expression that filters resources listed in the response. Most + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. + optional string filter = 1 [json_name = "filter"]; + + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) + optional uint32 max_results = 2 [json_name = "maxResults"]; + + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or + // `creationTimestamp desc` is supported. + optional string order_by = 3 [json_name = "orderBy"]; + + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. + optional string page_token = 4 [json_name = "pageToken"]; + + // Project ID for this request. + string project = 5 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // Opt-in for partial success behavior which provides partial results in case + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. + optional bool return_partial_success = 6 [json_name = "returnPartialSuccess"]; +} + +// Request message for UpdatePreviewFeature. +message UpdatePreviewFeatureRequest { + // Name of the PreviewFeature for this request. + string preview_feature = 1 + [(google.api.field_behavior) = REQUIRED, json_name = "previewFeature"]; + + // The PreviewFeature for this request. + optional google.cloud.cpp.compute.v1.PreviewFeature preview_feature_resource = + 2 [json_name = "__json_request_body"]; + + // Project ID for this request. + string project = 3 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "project", + json_name = "project" + ]; + + // An optional request ID to identify requests. Specify a unique request ID so + // that if you must retry your request, the server will know to ignore the + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). + optional string request_id = 4 [json_name = "requestId"]; +} diff --git a/protos/google/cloud/compute/projects/v1/projects.proto b/protos/google/cloud/compute/projects/v1/projects.proto index 0a8c556d00e6e..5f2f92af19747 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: 20250601 +// revision: 20260807 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_016.proto"; -import "google/cloud/compute/v1/internal/common_025.proto"; -import "google/cloud/compute/v1/internal/common_081.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_034.proto"; +import "google/cloud/compute/v1/internal/common_096.proto"; import "google/cloud/extended_operations.proto"; // Service for the projects resource. @@ -94,13 +94,15 @@ service Projects { option (google.cloud.operation_service) = "GlobalOperations"; } - // 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. + // 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. // https://cloud.google.com/compute/docs/reference/rest/v1/projects/get rpc GetProject(GetProjectRequest) returns (google.cloud.cpp.compute.v1.Project) { @@ -145,6 +147,19 @@ service Projects { } // Moves a persistent disk from one zone to another. + // *Note*: The moveDisk API will be deprecated on September 29, 2026. + // + // Starting September 29, 2025, you can't use the moveDisk API on new + // projects. To move a disk to a different region or zone, follow the steps in + // [Change the location of a + // disk](https://cloud.google.com/compute/docs/disks/migrate-to-hyperdisk#migrate-to-hd). + // + // Projects that already use the moveDisk API can continue usage until + // September 29, 2026. + // + // Starting November 1, 2025, API responses will include a warning message in + // the response body about the upcoming deprecation. You can skip the message + // to continue using the service without interruption. // https://cloud.google.com/compute/docs/reference/rest/v1/projects/moveDisk rpc MoveDisk(MoveDiskRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -157,11 +172,14 @@ service Projects { } // 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). + // another. + // *Note*: Moving VMs or disks by using this method might + // cause unexpected behavior. For more information, see the [known + // + // issue](https://cloud.google.com/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. + // zones](https://cloud.google.com/compute/docs/instances/moving-instance-across-zones) + // instead. // https://cloud.google.com/compute/docs/reference/rest/v1/projects/moveInstance rpc MoveInstance(MoveInstanceRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -176,7 +194,8 @@ service Projects { // 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. + // Enterprise. See Subscribing + // to Cloud Armor Enterprise for more information. // https://cloud.google.com/compute/docs/reference/rest/v1/projects/setCloudArmorTier rpc SetCloudArmorTier(SetCloudArmorTierRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -217,9 +236,9 @@ service Projects { option (google.cloud.operation_service) = "GlobalOperations"; } - // 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. + // Enables the usage export feature and sets theusage export bucket + // where reports are stored. If you provide an empty request body using this + // method, the usage export feature will be disabled. // https://cloud.google.com/compute/docs/reference/rest/v1/projects/setUsageExportBucket rpc SetUsageExportBucket(SetUsageExportBucketRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -244,14 +263,17 @@ message DisableXpnHostRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 2 [json_name = "requestId"]; } @@ -271,14 +293,17 @@ message DisableXpnResourceRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; } @@ -293,14 +318,17 @@ message EnableXpnHostRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 2 [json_name = "requestId"]; } @@ -320,14 +348,17 @@ message EnableXpnResourceRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; } @@ -348,58 +379,89 @@ message GetXpnHostRequest { // Request message for GetXpnResources. message GetXpnResourcesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -407,67 +469,100 @@ message GetXpnResourcesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 6 [json_name = "returnPartialSuccess"]; } // Request message for ListXpnHosts. message ListXpnHostsRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -480,9 +575,11 @@ message ListXpnHostsRequest { [json_name = "__json_request_body"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; } @@ -501,14 +598,17 @@ message MoveDiskRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; } @@ -527,14 +627,17 @@ message MoveInstanceRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; } @@ -554,14 +657,17 @@ message SetCloudArmorTierRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; } @@ -580,14 +686,17 @@ message SetCommonInstanceMetadataRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; } @@ -607,14 +716,17 @@ message SetDefaultNetworkTierRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; } @@ -629,14 +741,17 @@ message SetUsageExportBucketRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 2 [json_name = "requestId"]; // The UsageExportLocation for this request. 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 1d0a6b807010d..5ff8c40f8de69 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: 20250601 +// revision: 20260807 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_016.proto"; -import "google/cloud/compute/v1/internal/common_095.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_112.proto"; import "google/cloud/extended_operations.proto"; // Service for the publicAdvertisedPrefixes resource. @@ -70,8 +70,8 @@ service PublicAdvertisedPrefixes { option (google.api.method_signature) = "project,public_advertised_prefix"; } - // Creates a PublicAdvertisedPrefix in the specified project using the - // parameters that are included in the request. + // Creates a PublicAdvertisedPrefix in the specified project + // using the parameters that are included in the request. // https://cloud.google.com/compute/docs/reference/rest/v1/publicAdvertisedPrefixes/insert rpc InsertPublicAdvertisedPrefix(InsertPublicAdvertisedPrefixRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -95,8 +95,9 @@ service PublicAdvertisedPrefixes { } // 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. + // request. This method supportsPATCH + // semantics and usesJSON merge + // patch format and processing rules. // https://cloud.google.com/compute/docs/reference/rest/v1/publicAdvertisedPrefixes/patch rpc PatchPublicAdvertisedPrefix(PatchPublicAdvertisedPrefixRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -139,14 +140,17 @@ message AnnounceRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; } @@ -167,14 +171,17 @@ message DeletePublicAdvertisedPrefixRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; } @@ -206,72 +213,106 @@ message InsertPublicAdvertisedPrefixRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; } // Request message for ListPublicAdvertisedPrefixes. message ListPublicAdvertisedPrefixesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -279,9 +320,11 @@ message ListPublicAdvertisedPrefixesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 6 [json_name = "returnPartialSuccess"]; } @@ -306,14 +349,17 @@ message PatchPublicAdvertisedPrefixRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; } @@ -334,13 +380,16 @@ message WithdrawRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; } 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 869926cc34a16..f3883a5252191 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: 20250601 +// revision: 20260807 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_016.proto"; -import "google/cloud/compute/v1/internal/common_096.proto"; -import "google/cloud/compute/v1/internal/common_097.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_113.proto"; +import "google/cloud/compute/v1/internal/common_114.proto"; import "google/cloud/extended_operations.proto"; // Service for the publicDelegatedPrefixes resource. @@ -39,7 +39,9 @@ service PublicDelegatedPrefixes { "https://www.googleapis.com/auth/compute.readonly"; // Lists all PublicDelegatedPrefix resources owned by the specific project - // across all scopes. To prevent failure, Google recommends that you set the + // across all scopes. + // + // To prevent failure, Google recommends that you set the // `returnPartialSuccess` parameter to `true`. // https://cloud.google.com/compute/docs/reference/rest/v1/publicDelegatedPrefixes/aggregatedList rpc AggregatedListPublicDelegatedPrefixes( @@ -113,7 +115,8 @@ service PublicDelegatedPrefixes { } // Patches the specified PublicDelegatedPrefix resource with the data included - // in the request. This method supports PATCH semantics and uses JSON merge + // in the request. This method supportsPATCH + // semantics and usesJSON merge // patch format and processing rules. // https://cloud.google.com/compute/docs/reference/rest/v1/publicDelegatedPrefixes/patch rpc PatchPublicDelegatedPrefix(PatchPublicDelegatedPrefixRequest) @@ -144,37 +147,64 @@ service PublicDelegatedPrefixes { // Request message for AggregatedListPublicDelegatedPrefixes. message AggregatedListPublicDelegatedPrefixesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; // Indicates whether every visible scope for each scope type (zone, region, @@ -186,25 +216,29 @@ message AggregatedListPublicDelegatedPrefixesRequest { // will be included. optional bool include_all_scopes = 2 [json_name = "includeAllScopes"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 3 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 4 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 5 [json_name = "pageToken"]; // Name of the project scoping this request. @@ -212,9 +246,11 @@ message AggregatedListPublicDelegatedPrefixesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; // The Shared VPC service project id or service project number for which @@ -238,8 +274,8 @@ message AnnounceRequest { json_name = "publicDelegatedPrefix" ]; - // The name of the region where the public delegated prefix is located. It - // should comply with RFC1035. + // The name of theregion where + // the public delegated prefix is located. It should comply with RFC1035. string region = 3 [ (google.api.field_behavior) = REQUIRED, (google.cloud.operation_request_field) = "region", @@ -248,14 +284,17 @@ message AnnounceRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; } @@ -283,14 +322,17 @@ message DeletePublicDelegatedPrefixRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; } @@ -333,72 +375,106 @@ message InsertPublicDelegatedPrefixRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; } // Request message for ListPublicDelegatedPrefixes. message ListPublicDelegatedPrefixesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -410,9 +486,11 @@ message ListPublicDelegatedPrefixesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "region"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; } @@ -444,14 +522,17 @@ message PatchPublicDelegatedPrefixRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 5 [json_name = "requestId"]; } @@ -470,8 +551,8 @@ message WithdrawRequest { json_name = "publicDelegatedPrefix" ]; - // The name of the region where the public delegated prefix is located. It - // should comply with RFC1035. + // The name of theregion where + // the public delegated prefix is located. It should comply with RFC1035. string region = 3 [ (google.api.field_behavior) = REQUIRED, (google.cloud.operation_request_field) = "region", @@ -480,13 +561,16 @@ message WithdrawRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; } 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 29025fcf1234c..b78355442406b 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: 20250601 +// revision: 20260807 syntax = "proto3"; @@ -24,9 +24,10 @@ 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_008.proto"; -import "google/cloud/compute/v1/internal/common_016.proto"; -import "google/cloud/compute/v1/internal/common_100.proto"; +import "google/cloud/compute/v1/internal/common_010.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_117.proto"; +import "google/cloud/compute/v1/internal/common_171.proto"; import "google/cloud/extended_operations.proto"; // Service for the regionAutoscalers resource. @@ -59,8 +60,8 @@ service RegionAutoscalers { option (google.api.method_signature) = "project,region,autoscaler"; } - // Creates an autoscaler in the specified project using the data included in - // the request. + // Creates an autoscaler in the specified project using + // the data included in the request. // https://cloud.google.com/compute/docs/reference/rest/v1/regionAutoscalers/insert rpc InsertAutoscaler(InsertAutoscalerRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -72,7 +73,8 @@ service RegionAutoscalers { option (google.cloud.operation_service) = "RegionOperations"; } - // Retrieves a list of autoscalers contained within the specified region. + // Retrieves a list of autoscalers contained within + // the specified region. // https://cloud.google.com/compute/docs/reference/rest/v1/regionAutoscalers/list rpc ListRegionAutoscalers(ListRegionAutoscalersRequest) returns (google.cloud.cpp.compute.v1.RegionAutoscalerList) { @@ -82,8 +84,9 @@ service RegionAutoscalers { option (google.api.method_signature) = "project,region"; } - // Updates an autoscaler in the specified project using the data included in - // the request. This method supports PATCH semantics and uses the JSON merge + // Updates an autoscaler in the specified project using + // the data included in the request. This method supportsPATCH + // semantics and uses theJSON merge // patch format and processing rules. // https://cloud.google.com/compute/docs/reference/rest/v1/regionAutoscalers/patch rpc PatchAutoscaler(PatchAutoscalerRequest) @@ -96,8 +99,20 @@ service RegionAutoscalers { option (google.cloud.operation_service) = "RegionOperations"; } - // Updates an autoscaler in the specified project using the data included in - // the request. + // Returns permissions that a caller has on the specified resource. + // https://cloud.google.com/compute/docs/reference/rest/v1/regionAutoscalers/testIamPermissions + rpc TestIamPermissions(TestIamPermissionsRequest) + returns (google.cloud.cpp.compute.v1.TestPermissionsResponse) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/regions/{region}/autoscalers/{resource}/testIamPermissions" + body: "test_permissions_request_resource" + }; + option (google.api.method_signature) = + "project,region,resource,test_permissions_request_resource"; + } + + // Updates an autoscaler in the specified project using + // the data included in the request. // https://cloud.google.com/compute/docs/reference/rest/v1/regionAutoscalers/update rpc UpdateAutoscaler(UpdateAutoscalerRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -132,14 +147,17 @@ message DeleteAutoscalerRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; } @@ -180,72 +198,106 @@ message InsertAutoscalerRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; } // Request message for ListRegionAutoscalers. message ListRegionAutoscalersRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -257,9 +309,11 @@ message ListRegionAutoscalersRequest { [(google.api.field_behavior) = REQUIRED, json_name = "region"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; } @@ -288,17 +342,39 @@ message PatchAutoscalerRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 5 [json_name = "requestId"]; } +// Request message for TestIamPermissions. +message TestIamPermissionsRequest { + // Project ID for this request. + string project = 1 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // The name of the region for this request. + string region = 2 + [(google.api.field_behavior) = REQUIRED, json_name = "region"]; + + // Name or id of the resource for this request. + string resource = 3 + [(google.api.field_behavior) = REQUIRED, json_name = "resource"]; + + // The TestPermissionsRequest for this request. + optional google.cloud.cpp.compute.v1.TestPermissionsRequest + test_permissions_request_resource = 4 [json_name = "__json_request_body"]; +} + // Request message for UpdateAutoscaler. message UpdateAutoscalerRequest { // Name of the autoscaler to update. @@ -324,13 +400,16 @@ message UpdateAutoscalerRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 5 [json_name = "requestId"]; } diff --git a/protos/google/cloud/compute/region_backend_buckets/v1/region_backend_buckets.proto b/protos/google/cloud/compute/region_backend_buckets/v1/region_backend_buckets.proto new file mode 100644 index 0000000000000..6fc2464791f0f --- /dev/null +++ b/protos/google/cloud/compute/region_backend_buckets/v1/region_backend_buckets.proto @@ -0,0 +1,549 @@ +// Copyright 2026 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: 20260807 + +syntax = "proto3"; + +package google.cloud.cpp.compute.region_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_009.proto"; +import "google/cloud/compute/v1/internal/common_012.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_126.proto"; +import "google/cloud/compute/v1/internal/common_171.proto"; +import "google/cloud/extended_operations.proto"; + +// Service for the regionBackendBuckets resource. +// https://cloud.google.com/compute/docs/reference/rest/v1/regionBackendBuckets +service RegionBackendBuckets { + option (google.api.default_host) = "compute.googleapis.com"; + option (google.api.oauth_scopes) = + "https://www.googleapis.com/auth/cloud-platform," + "https://www.googleapis.com/auth/compute," + "https://www.googleapis.com/auth/compute.readonly"; + + // Deletes the specified regional BackendBucket resource. + // https://cloud.google.com/compute/docs/reference/rest/v1/regionBackendBuckets/delete + rpc DeleteBackendBucket(DeleteBackendBucketRequest) + returns (google.cloud.cpp.compute.v1.Operation) { + option (google.api.http) = { + delete: "/compute/v1/projects/{project}/regions/{region}/backendBuckets/{backend_bucket}" + }; + option (google.api.method_signature) = "project,region,backend_bucket"; + option (google.cloud.operation_service) = "RegionOperations"; + } + + // Returns the specified regional BackendBucket resource. + // https://cloud.google.com/compute/docs/reference/rest/v1/regionBackendBuckets/get + rpc GetBackendBucket(GetBackendBucketRequest) + returns (google.cloud.cpp.compute.v1.BackendBucket) { + option (google.api.http) = { + get: "/compute/v1/projects/{project}/regions/{region}/backendBuckets/{backend_bucket}" + }; + option (google.api.method_signature) = "project,region,backend_bucket"; + } + + // Gets the access control policy for a resource. May be empty if no such + // policy or resource exists. + // https://cloud.google.com/compute/docs/reference/rest/v1/regionBackendBuckets/getIamPolicy + rpc GetIamPolicy(GetIamPolicyRequest) + returns (google.cloud.cpp.compute.v1.Policy) { + option (google.api.http) = { + get: "/compute/v1/projects/{project}/regions/{region}/backendBuckets/{resource}/getIamPolicy" + }; + option (google.api.method_signature) = "project,region,resource"; + } + + // Creates a RegionBackendBucket in the specified project in the given scope + // using the parameters that are included in the request. + // https://cloud.google.com/compute/docs/reference/rest/v1/regionBackendBuckets/insert + rpc InsertBackendBucket(InsertBackendBucketRequest) + returns (google.cloud.cpp.compute.v1.Operation) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/regions/{region}/backendBuckets" + body: "backend_bucket_resource" + }; + option (google.api.method_signature) = + "project,region,backend_bucket_resource"; + option (google.cloud.operation_service) = "RegionOperations"; + } + + // Retrieves the list of BackendBucket resources available to the specified + // project in the given region. + // https://cloud.google.com/compute/docs/reference/rest/v1/regionBackendBuckets/list + rpc ListRegionBackendBuckets(ListRegionBackendBucketsRequest) + returns (google.cloud.cpp.compute.v1.BackendBucketList) { + option (google.api.http) = { + get: "/compute/v1/projects/{project}/regions/{region}/backendBuckets" + }; + option (google.api.method_signature) = "project,region"; + } + + // Retrieves a list of all usable backend buckets in the specified project in + // the given region. + // https://cloud.google.com/compute/docs/reference/rest/v1/regionBackendBuckets/listUsable + rpc ListUsable(ListUsableRequest) + returns (google.cloud.cpp.compute.v1.BackendBucketListUsable) { + option (google.api.http) = { + get: "/compute/v1/projects/{project}/regions/{region}/backendBuckets/listUsable" + }; + option (google.api.method_signature) = "project,region"; + } + + // Updates the specified BackendBucket resource with the data included in the + // request. This method supportsPATCH + // semantics and uses theJSON merge + // patch format and processing rules. + // https://cloud.google.com/compute/docs/reference/rest/v1/regionBackendBuckets/patch + rpc PatchBackendBucket(PatchBackendBucketRequest) + returns (google.cloud.cpp.compute.v1.Operation) { + option (google.api.http) = { + patch: "/compute/v1/projects/{project}/regions/{region}/backendBuckets/{backend_bucket}" + body: "backend_bucket_resource" + }; + option (google.api.method_signature) = + "project,region,backend_bucket,backend_bucket_resource"; + option (google.cloud.operation_service) = "RegionOperations"; + } + + // Sets the access control policy on the specified resource. + // Replaces any existing policy. + // https://cloud.google.com/compute/docs/reference/rest/v1/regionBackendBuckets/setIamPolicy + rpc SetIamPolicy(SetIamPolicyRequest) + returns (google.cloud.cpp.compute.v1.Policy) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/regions/{region}/backendBuckets/{resource}/setIamPolicy" + body: "region_set_policy_request_resource" + }; + option (google.api.method_signature) = + "project,region,resource,region_set_policy_request_resource"; + } + + // Returns permissions that a caller has on the specified resource. + // https://cloud.google.com/compute/docs/reference/rest/v1/regionBackendBuckets/testIamPermissions + rpc TestIamPermissions(TestIamPermissionsRequest) + returns (google.cloud.cpp.compute.v1.TestPermissionsResponse) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/regions/{region}/backendBuckets/{resource}/testIamPermissions" + body: "test_permissions_request_resource" + }; + option (google.api.method_signature) = + "project,region,resource,test_permissions_request_resource"; + } +} + +// Request message for DeleteBackendBucket. +message DeleteBackendBucketRequest { + // Name of the BackendBucket resource to delete. + string backend_bucket = 1 + [(google.api.field_behavior) = REQUIRED, json_name = "backendBucket"]; + + // Project ID for this request. + string project = 2 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "project", + json_name = "project" + ]; + + // Name of the region scoping this request. + string region = 3 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "region", + json_name = "region" + ]; + + // An optional request ID to identify requests. Specify a unique request ID so + // that if you must retry your request, the server will know to ignore the + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating 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 + optional string request_id = 4 [json_name = "requestId"]; +} + +// Request message for GetBackendBucket. +message GetBackendBucketRequest { + // Name of the BackendBucket resource to return. + string backend_bucket = 1 + [(google.api.field_behavior) = REQUIRED, json_name = "backendBucket"]; + + // Project ID for this request. + string project = 2 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // Name of the region scoping this request. + string region = 3 + [(google.api.field_behavior) = REQUIRED, json_name = "region"]; +} + +// Request message for GetIamPolicy. +message GetIamPolicyRequest { + // Requested IAM Policy version. + optional int32 options_requested_policy_version = 1 + [json_name = "optionsRequestedPolicyVersion"]; + + // Project ID for this request. + string project = 2 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // The name of the region for this request. + string region = 3 + [(google.api.field_behavior) = REQUIRED, json_name = "region"]; + + // Name or id of the resource for this request. + string resource = 4 + [(google.api.field_behavior) = REQUIRED, json_name = "resource"]; +} + +// Request message for InsertBackendBucket. +message InsertBackendBucketRequest { + // The BackendBucket for this request. + optional google.cloud.cpp.compute.v1.BackendBucket backend_bucket_resource = 1 + [json_name = "__json_request_body"]; + + // Project ID for this request. + string project = 2 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "project", + json_name = "project" + ]; + + // Name of the region of this request. + string region = 3 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "region", + json_name = "region" + ]; + + // An optional request ID to identify requests. Specify a unique request ID so + // that if you must retry your request, the server will know to ignore the + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). + optional string request_id = 4 [json_name = "requestId"]; +} + +// Request message for ListRegionBackendBuckets. +message ListRegionBackendBucketsRequest { + // A filter expression that filters resources listed in the response. Most + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. + optional string filter = 1 [json_name = "filter"]; + + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) + optional uint32 max_results = 2 [json_name = "maxResults"]; + + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or + // `creationTimestamp desc` is supported. + optional string order_by = 3 [json_name = "orderBy"]; + + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. + optional string page_token = 4 [json_name = "pageToken"]; + + // Project ID for this request. + string project = 5 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // Name of the region of this request. + string region = 6 + [(google.api.field_behavior) = REQUIRED, json_name = "region"]; + + // Opt-in for partial success behavior which provides partial results in case + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. + optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; +} + +// Request message for ListUsable. +message ListUsableRequest { + // A filter expression that filters resources listed in the response. Most + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. + optional string filter = 1 [json_name = "filter"]; + + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) + optional uint32 max_results = 2 [json_name = "maxResults"]; + + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or + // `creationTimestamp desc` is supported. + optional string order_by = 3 [json_name = "orderBy"]; + + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. + optional string page_token = 4 [json_name = "pageToken"]; + + // Project ID for this request. + string project = 5 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // Name of the region scoping this request. + // It must be a string that meets the requirements in RFC1035. + string region = 6 + [(google.api.field_behavior) = REQUIRED, json_name = "region"]; + + // Opt-in for partial success behavior which provides partial results in case + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. + optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; +} + +// Request message for PatchBackendBucket. +message PatchBackendBucketRequest { + // Name of the BackendBucket resource to patch. + string backend_bucket = 1 + [(google.api.field_behavior) = REQUIRED, json_name = "backendBucket"]; + + // The BackendBucket for this request. + optional google.cloud.cpp.compute.v1.BackendBucket backend_bucket_resource = 2 + [json_name = "__json_request_body"]; + + // Project ID for this request. + string project = 3 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "project", + json_name = "project" + ]; + + // Name of the region scoping this request. + string region = 4 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "region", + json_name = "region" + ]; + + // An optional request ID to identify requests. Specify a unique request ID so + // that if you must retry your request, the server will know to ignore the + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating 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 + optional string request_id = 5 [json_name = "requestId"]; +} + +// Request message for SetIamPolicy. +message SetIamPolicyRequest { + // Project ID for this request. + string project = 1 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // The name of the region for this request. + string region = 2 + [(google.api.field_behavior) = REQUIRED, json_name = "region"]; + + // The RegionSetPolicyRequest for this request. + optional google.cloud.cpp.compute.v1.RegionSetPolicyRequest + region_set_policy_request_resource = 3 + [json_name = "__json_request_body"]; + + // Name or id of the resource for this request. + string resource = 4 + [(google.api.field_behavior) = REQUIRED, json_name = "resource"]; +} + +// Request message for TestIamPermissions. +message TestIamPermissionsRequest { + // Project ID for this request. + string project = 1 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // The name of the region for this request. + string region = 2 + [(google.api.field_behavior) = REQUIRED, json_name = "region"]; + + // Name or id of the resource for this request. + string resource = 3 + [(google.api.field_behavior) = REQUIRED, json_name = "resource"]; + + // The TestPermissionsRequest for this request. + optional google.cloud.cpp.compute.v1.TestPermissionsRequest + test_permissions_request_resource = 4 [json_name = "__json_request_body"]; +} 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 c231a31a994d9..62d40290eaf8b 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: 20250601 +// revision: 20260807 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_007.proto"; -import "google/cloud/compute/v1/internal/common_016.proto"; -import "google/cloud/compute/v1/internal/common_108.proto"; -import "google/cloud/compute/v1/internal/common_118.proto"; -import "google/cloud/compute/v1/internal/common_145.proto"; +import "google/cloud/compute/v1/internal/common_009.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_126.proto"; +import "google/cloud/compute/v1/internal/common_142.proto"; +import "google/cloud/compute/v1/internal/common_171.proto"; import "google/cloud/extended_operations.proto"; // Service for the regionBackendServices resource. @@ -62,7 +62,8 @@ service RegionBackendServices { option (google.api.method_signature) = "project,region,backend_service"; } - // Gets the most recent health check results for this regional BackendService. + // Gets the most recent health check results for this + // regional BackendService. // https://cloud.google.com/compute/docs/reference/rest/v1/regionBackendServices/getHealth rpc GetHealth(GetHealthRequest) returns (google.cloud.cpp.compute.v1.BackendServiceGroupHealth) { @@ -86,8 +87,8 @@ service RegionBackendServices { } // Creates a regional BackendService resource in the specified project using - // the data included in the request. For more information, see Backend - // services overview. + // the data included in the request. For more information, see + // Backend services overview. // https://cloud.google.com/compute/docs/reference/rest/v1/regionBackendServices/insert rpc InsertBackendService(InsertBackendServiceRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -111,8 +112,10 @@ service RegionBackendServices { option (google.api.method_signature) = "project,region"; } - // Retrieves a list of all usable backend services in the specified project in - // the given region. + // Retrieves a list of all usable backend services for Application Load + // Balancers and Proxy Network Load Balancers in the specified project in the + // given region. Backend services for external and internal passthrough + // Network Load Balancers are not included in the response. // https://cloud.google.com/compute/docs/reference/rest/v1/regionBackendServices/listUsable rpc ListUsable(ListUsableRequest) returns (google.cloud.cpp.compute.v1.BackendServiceListUsable) { @@ -123,9 +126,10 @@ service RegionBackendServices { } // 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. + // 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. // https://cloud.google.com/compute/docs/reference/rest/v1/regionBackendServices/patch rpc PatchBackendService(PatchBackendServiceRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -138,8 +142,8 @@ service RegionBackendServices { option (google.cloud.operation_service) = "RegionOperations"; } - // Sets the access control policy on the specified resource. Replaces any - // existing policy. + // Sets the access control policy on the specified resource. + // Replaces any existing policy. // https://cloud.google.com/compute/docs/reference/rest/v1/regionBackendServices/setIamPolicy rpc SetIamPolicy(SetIamPolicyRequest) returns (google.cloud.cpp.compute.v1.Policy) { @@ -152,7 +156,8 @@ service RegionBackendServices { } // Sets the Google Cloud Armor security policy for the specified backend - // service. For more information, see Google Cloud Armor Overview + // service. For more information, seeGoogle + // Cloud Armor Overview // https://cloud.google.com/compute/docs/reference/rest/v1/regionBackendServices/setSecurityPolicy rpc SetSecurityPolicy(SetSecurityPolicyRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -178,8 +183,9 @@ service RegionBackendServices { } // Updates the specified regional BackendService resource with the data - // included in the request. For more information, see Backend services - // overview . + // included in the request. For more information, + // see + // Backend services overview. // https://cloud.google.com/compute/docs/reference/rest/v1/regionBackendServices/update rpc UpdateBackendService(UpdateBackendServiceRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -215,14 +221,17 @@ message DeleteBackendServiceRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; } @@ -300,72 +309,106 @@ message InsertBackendServiceRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; } // Request message for ListRegionBackendServices. message ListRegionBackendServicesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -377,82 +420,117 @@ message ListRegionBackendServicesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "region"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; } // Request message for ListUsable. message ListUsableRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. string project = 5 [(google.api.field_behavior) = REQUIRED, json_name = "project"]; - // Name of the region scoping this request. It must be a string that meets the - // requirements in RFC1035. + // Name of the region scoping this request. + // It must be a string that meets the requirements in RFC1035. string region = 6 [(google.api.field_behavior) = REQUIRED, json_name = "region"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; } @@ -482,14 +560,17 @@ message PatchBackendServiceRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 5 [json_name = "requestId"]; } @@ -536,14 +617,17 @@ message SetSecurityPolicyRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; // The SecurityPolicyReference for this request. @@ -597,13 +681,16 @@ message UpdateBackendServiceRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 5 [json_name = "requestId"]; } 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 375e3099a51c5..c89798c006a9d 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: 20250601 +// revision: 20260807 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_016.proto"; import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_025.proto"; import "google/cloud/extended_operations.proto"; // Service for the regionCommitments resource. @@ -37,9 +37,10 @@ service RegionCommitments { "https://www.googleapis.com/auth/compute," "https://www.googleapis.com/auth/compute.readonly"; - // Retrieves an aggregated list of commitments by region. To prevent failure, - // Google recommends that you set the `returnPartialSuccess` parameter to - // `true`. + // Retrieves an aggregated list of commitments by region. + // + // To prevent failure, it is recommended that you set the + // `returnPartialSuccess` parameter to `true`. // https://cloud.google.com/compute/docs/reference/rest/v1/regionCommitments/aggregatedList rpc AggregatedListRegionCommitments(AggregatedListRegionCommitmentsRequest) returns (google.cloud.cpp.compute.v1.CommitmentAggregatedList) { @@ -59,8 +60,8 @@ service RegionCommitments { option (google.api.method_signature) = "project,region,commitment"; } - // Creates a commitment in the specified project using the data included in - // the request. + // Creates a commitment in the specified project using the data + // included in the request. // https://cloud.google.com/compute/docs/reference/rest/v1/regionCommitments/insert rpc InsertCommitment(InsertCommitmentRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -72,7 +73,8 @@ service RegionCommitments { option (google.cloud.operation_service) = "RegionOperations"; } - // Retrieves a list of commitments contained within the specified region. + // Retrieves a list of commitments contained within + // the specified region. // https://cloud.google.com/compute/docs/reference/rest/v1/regionCommitments/list rpc ListRegionCommitments(ListRegionCommitmentsRequest) returns (google.cloud.cpp.compute.v1.CommitmentList) { @@ -101,37 +103,64 @@ service RegionCommitments { // Request message for AggregatedListRegionCommitments. message AggregatedListRegionCommitmentsRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; // Indicates whether every visible scope for each scope type (zone, region, @@ -143,25 +172,29 @@ message AggregatedListRegionCommitmentsRequest { // will be included. optional bool include_all_scopes = 2 [json_name = "includeAllScopes"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 3 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 4 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 5 [json_name = "pageToken"]; // Project ID for this request. @@ -169,9 +202,11 @@ message AggregatedListRegionCommitmentsRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; // The Shared VPC service project id or service project number for which @@ -217,72 +252,106 @@ message InsertCommitmentRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; } // Request message for ListRegionCommitments. message ListRegionCommitmentsRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -294,9 +363,11 @@ message ListRegionCommitmentsRequest { [(google.api.field_behavior) = REQUIRED, json_name = "region"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; } @@ -328,14 +399,17 @@ message UpdateCommitmentRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 6 [json_name = "requestId"]; // update_mask indicates fields to be updated as part of this request. diff --git a/protos/google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks.proto b/protos/google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks.proto new file mode 100644 index 0000000000000..75861b757fc85 --- /dev/null +++ b/protos/google/cloud/compute/region_composite_health_checks/v1/region_composite_health_checks.proto @@ -0,0 +1,532 @@ +// Copyright 2026 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: 20260807 + +syntax = "proto3"; + +package google.cloud.cpp.compute.region_composite_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_019.proto"; +import "google/cloud/compute/v1/internal/common_026.proto"; +import "google/cloud/compute/v1/internal/common_171.proto"; +import "google/cloud/extended_operations.proto"; + +// Service for the regionCompositeHealthChecks resource. +// https://cloud.google.com/compute/docs/reference/rest/v1/regionCompositeHealthChecks +service RegionCompositeHealthChecks { + option (google.api.default_host) = "compute.googleapis.com"; + option (google.api.oauth_scopes) = + "https://www.googleapis.com/auth/cloud-platform," + "https://www.googleapis.com/auth/compute," + "https://www.googleapis.com/auth/compute.readonly"; + + // Retrieves the list of all CompositeHealthCheck resources (all + // regional) available to the specified project. + // + // To prevent failure, it is recommended that you set the + // `returnPartialSuccess` parameter to `true`. + // https://cloud.google.com/compute/docs/reference/rest/v1/regionCompositeHealthChecks/aggregatedList + rpc AggregatedListRegionCompositeHealthChecks( + AggregatedListRegionCompositeHealthChecksRequest) + returns (google.cloud.cpp.compute.v1.CompositeHealthCheckAggregatedList) { + option (google.api.http) = { + get: "/compute/v1/projects/{project}/aggregated/compositeHealthChecks" + }; + option (google.api.method_signature) = "project"; + } + + // Deletes the specified CompositeHealthCheck in the given region + // https://cloud.google.com/compute/docs/reference/rest/v1/regionCompositeHealthChecks/delete + rpc DeleteCompositeHealthCheck(DeleteCompositeHealthCheckRequest) + returns (google.cloud.cpp.compute.v1.Operation) { + option (google.api.http) = { + delete: "/compute/v1/projects/{project}/regions/{region}/compositeHealthChecks/{composite_health_check}" + }; + option (google.api.method_signature) = + "project,region,composite_health_check"; + option (google.cloud.operation_service) = "RegionOperations"; + } + + // Returns the specified CompositeHealthCheck resource in the given region. + // https://cloud.google.com/compute/docs/reference/rest/v1/regionCompositeHealthChecks/get + rpc GetCompositeHealthCheck(GetCompositeHealthCheckRequest) + returns (google.cloud.cpp.compute.v1.CompositeHealthCheck) { + option (google.api.http) = { + get: "/compute/v1/projects/{project}/regions/{region}/compositeHealthChecks/{composite_health_check}" + }; + option (google.api.method_signature) = + "project,region,composite_health_check"; + } + + // Gets the most recent health check results for this + // regional CompositeHealthCheck. + // https://cloud.google.com/compute/docs/reference/rest/v1/regionCompositeHealthChecks/getHealth + rpc GetHealth(GetHealthRequest) + returns (google.cloud.cpp.compute.v1.CompositeHealthCheckHealth) { + option (google.api.http) = { + get: "/compute/v1/projects/{project}/regions/{region}/compositeHealthChecks/{composite_health_check}/getHealth" + }; + option (google.api.method_signature) = + "project,region,composite_health_check"; + } + + // Create a CompositeHealthCheck in the specified project in the given region + // using the parameters that are included in the request. + // https://cloud.google.com/compute/docs/reference/rest/v1/regionCompositeHealthChecks/insert + rpc InsertCompositeHealthCheck(InsertCompositeHealthCheckRequest) + returns (google.cloud.cpp.compute.v1.Operation) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/regions/{region}/compositeHealthChecks" + body: "composite_health_check_resource" + }; + option (google.api.method_signature) = + "project,region,composite_health_check_resource"; + option (google.cloud.operation_service) = "RegionOperations"; + } + + // Lists the CompositeHealthChecks for a project in the given region. + // https://cloud.google.com/compute/docs/reference/rest/v1/regionCompositeHealthChecks/list + rpc ListRegionCompositeHealthChecks(ListRegionCompositeHealthChecksRequest) + returns (google.cloud.cpp.compute.v1.CompositeHealthCheckList) { + option (google.api.http) = { + get: "/compute/v1/projects/{project}/regions/{region}/compositeHealthChecks" + }; + option (google.api.method_signature) = "project,region"; + } + + // Updates the specified regional CompositeHealthCheck resource + // with the data included in the request. This method supportsPATCH + // semantics and uses theJSON merge + // patch format and processing rules. + // https://cloud.google.com/compute/docs/reference/rest/v1/regionCompositeHealthChecks/patch + rpc PatchCompositeHealthCheck(PatchCompositeHealthCheckRequest) + returns (google.cloud.cpp.compute.v1.Operation) { + option (google.api.http) = { + patch: "/compute/v1/projects/{project}/regions/{region}/compositeHealthChecks/{composite_health_check}" + body: "composite_health_check_resource" + }; + option (google.api.method_signature) = + "project,region,composite_health_check,composite_health_check_resource"; + option (google.cloud.operation_service) = "RegionOperations"; + } + + // Returns permissions that a caller has on the specified resource. + // https://cloud.google.com/compute/docs/reference/rest/v1/regionCompositeHealthChecks/testIamPermissions + rpc TestIamPermissions(TestIamPermissionsRequest) + returns (google.cloud.cpp.compute.v1.TestPermissionsResponse) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/regions/{region}/compositeHealthChecks/{resource}/testIamPermissions" + body: "test_permissions_request_resource" + }; + option (google.api.method_signature) = + "project,region,resource,test_permissions_request_resource"; + } +} + +// Request message for AggregatedListRegionCompositeHealthChecks. +message AggregatedListRegionCompositeHealthChecksRequest { + // A filter expression that filters resources listed in the response. Most + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. + optional string filter = 1 [json_name = "filter"]; + + // 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. + optional bool include_all_scopes = 2 [json_name = "includeAllScopes"]; + + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) + optional uint32 max_results = 3 [json_name = "maxResults"]; + + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or + // `creationTimestamp desc` is supported. + optional string order_by = 4 [json_name = "orderBy"]; + + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. + optional string page_token = 5 [json_name = "pageToken"]; + + // Name of the project scoping this request. + string project = 6 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // Opt-in for partial success behavior which provides partial results in case + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. + optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; + + // The Shared VPC service project id or service project number for which + // aggregated list request is invoked for subnetworks list-usable api. + optional string service_project_number = 8 + [json_name = "serviceProjectNumber"]; +} + +// Request message for DeleteCompositeHealthCheck. +message DeleteCompositeHealthCheckRequest { + // Name of the CompositeHealthCheck resource to delete. + string composite_health_check = 1 [ + (google.api.field_behavior) = REQUIRED, + json_name = "compositeHealthCheck" + ]; + + // Project ID for this request. + string project = 2 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "project", + json_name = "project" + ]; + + // Name of the region scoping this request. + string region = 3 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "region", + json_name = "region" + ]; + + // An optional request ID to identify requests. Specify a unique request ID so + // that if you must retry your request, the server will know to ignore the + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). + optional string request_id = 4 [json_name = "requestId"]; +} + +// Request message for GetCompositeHealthCheck. +message GetCompositeHealthCheckRequest { + // Name of the CompositeHealthCheck resource to return. + string composite_health_check = 1 [ + (google.api.field_behavior) = REQUIRED, + json_name = "compositeHealthCheck" + ]; + + // Project ID for this request. + string project = 2 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // Name of the region scoping this request. + string region = 3 + [(google.api.field_behavior) = REQUIRED, json_name = "region"]; +} + +// Request message for GetHealth. +message GetHealthRequest { + // Name of the CompositeHealthCheck resource to get health for. + string composite_health_check = 1 [ + (google.api.field_behavior) = REQUIRED, + json_name = "compositeHealthCheck" + ]; + + // Name of the project scoping this request. + string project = 2 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // Name of the region scoping this request. + string region = 3 + [(google.api.field_behavior) = REQUIRED, json_name = "region"]; +} + +// Request message for InsertCompositeHealthCheck. +message InsertCompositeHealthCheckRequest { + // The CompositeHealthCheck for this request. + optional google.cloud.cpp.compute.v1.CompositeHealthCheck + composite_health_check_resource = 1 [json_name = "__json_request_body"]; + + // Project ID for this request. + string project = 2 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "project", + json_name = "project" + ]; + + // Name of the region scoping this request. + string region = 3 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "region", + json_name = "region" + ]; + + // An optional request ID to identify requests. Specify a unique request ID so + // that if you must retry your request, the server will know to ignore the + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). + optional string request_id = 4 [json_name = "requestId"]; +} + +// Request message for ListRegionCompositeHealthChecks. +message ListRegionCompositeHealthChecksRequest { + // A filter expression that filters resources listed in the response. Most + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. + optional string filter = 1 [json_name = "filter"]; + + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) + optional uint32 max_results = 2 [json_name = "maxResults"]; + + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or + // `creationTimestamp desc` is supported. + optional string order_by = 3 [json_name = "orderBy"]; + + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. + optional string page_token = 4 [json_name = "pageToken"]; + + // Project ID for this request. + string project = 5 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // Name of the region scoping this request. + string region = 6 + [(google.api.field_behavior) = REQUIRED, json_name = "region"]; + + // Opt-in for partial success behavior which provides partial results in case + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. + optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; +} + +// Request message for PatchCompositeHealthCheck. +message PatchCompositeHealthCheckRequest { + // Name of the CompositeHealthCheck to update. The name + // must be 1-63 characters long, and comply with RFC1035. + string composite_health_check = 1 [ + (google.api.field_behavior) = REQUIRED, + json_name = "compositeHealthCheck" + ]; + + // The CompositeHealthCheck for this request. + optional google.cloud.cpp.compute.v1.CompositeHealthCheck + composite_health_check_resource = 2 [json_name = "__json_request_body"]; + + // Project ID for this request. + string project = 3 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "project", + json_name = "project" + ]; + + // Name of the region scoping this request. + string region = 4 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "region", + json_name = "region" + ]; + + // An optional request ID to identify requests. Specify a unique request ID so + // that if you must retry your request, the server will know to ignore the + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). + optional string request_id = 5 [json_name = "requestId"]; +} + +// Request message for TestIamPermissions. +message TestIamPermissionsRequest { + // Project ID for this request. + string project = 1 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // The name of the region for this request. + string region = 2 + [(google.api.field_behavior) = REQUIRED, json_name = "region"]; + + // Name or id of the resource for this request. + string resource = 3 + [(google.api.field_behavior) = REQUIRED, json_name = "resource"]; + + // The TestPermissionsRequest for this request. + optional google.cloud.cpp.compute.v1.TestPermissionsRequest + test_permissions_request_resource = 4 [json_name = "__json_request_body"]; +} 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 7f67d43dbb0c0..dbe2b0eff933e 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: 20250601 +// revision: 20260807 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_026.proto"; -import "google/cloud/compute/v1/internal/common_101.proto"; +import "google/cloud/compute/v1/internal/common_035.proto"; +import "google/cloud/compute/v1/internal/common_118.proto"; // Service for the regionDiskTypes resource. // https://cloud.google.com/compute/docs/reference/rest/v1/regionDiskTypes @@ -75,58 +75,89 @@ message GetDiskTypeRequest { // Request message for ListRegionDiskTypes. message ListRegionDiskTypesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -138,8 +169,10 @@ message ListRegionDiskTypesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "region"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; } 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 27251d382c809..4a28870cb4679 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: 20250601 +// revision: 20260807 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_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_102.proto"; -import "google/cloud/compute/v1/internal/common_107.proto"; -import "google/cloud/compute/v1/internal/common_108.proto"; -import "google/cloud/compute/v1/internal/common_122.proto"; -import "google/cloud/compute/v1/internal/common_145.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_019.proto"; +import "google/cloud/compute/v1/internal/common_119.proto"; +import "google/cloud/compute/v1/internal/common_125.proto"; +import "google/cloud/compute/v1/internal/common_126.proto"; +import "google/cloud/compute/v1/internal/common_146.proto"; +import "google/cloud/compute/v1/internal/common_171.proto"; import "google/cloud/extended_operations.proto"; // Service for the regionDisks resource. @@ -44,7 +44,8 @@ service RegionDisks { "https://www.googleapis.com/auth/compute.readonly"; // 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. + // policy which will be applied to this disk for scheduling snapshot + // creation. // https://cloud.google.com/compute/docs/reference/rest/v1/regionDisks/addResourcePolicies rpc AddResourcePolicies(AddResourcePoliciesRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -71,9 +72,9 @@ service RegionDisks { } // 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. + // 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. // https://cloud.google.com/compute/docs/reference/rest/v1/regionDisks/createSnapshot rpc CreateSnapshot(CreateSnapshotRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -88,8 +89,9 @@ service RegionDisks { // 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. + // However, deleting a disk does not delete anysnapshots + // previously made from the disk. You must separatelydelete + // snapshots. // https://cloud.google.com/compute/docs/reference/rest/v1/regionDisks/delete rpc DeleteDisk(DeleteDiskRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -133,8 +135,8 @@ service RegionDisks { option (google.cloud.operation_service) = "RegionOperations"; } - // Retrieves the list of persistent disks contained within the specified - // region. + // Retrieves the list of persistent disks contained within + // the specified region. // https://cloud.google.com/compute/docs/reference/rest/v1/regionDisks/list rpc ListRegionDisks(ListRegionDisksRequest) returns (google.cloud.cpp.compute.v1.DiskList) { @@ -169,8 +171,8 @@ service RegionDisks { option (google.cloud.operation_service) = "RegionOperations"; } - // Sets the access control policy on the specified resource. Replaces any - // existing policy. + // Sets the access control policy on the specified resource. + // Replaces any existing policy. // https://cloud.google.com/compute/docs/reference/rest/v1/regionDisks/setIamPolicy rpc SetIamPolicy(SetIamPolicyRequest) returns (google.cloud.cpp.compute.v1.Policy) { @@ -195,7 +197,8 @@ service RegionDisks { option (google.cloud.operation_service) = "RegionOperations"; } - // Starts asynchronous replication. Must be invoked on the primary disk. + // Starts asynchronous replication. + // Must be invoked on the primary disk. // https://cloud.google.com/compute/docs/reference/rest/v1/regionDisks/startAsyncReplication rpc StartAsyncReplication(StartAsyncReplicationRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -208,8 +211,8 @@ service RegionDisks { option (google.cloud.operation_service) = "RegionOperations"; } - // Stops asynchronous replication. Can be invoked either on the primary or on - // the secondary disk. + // Stops asynchronous replication. + // Can be invoked either on the primary or on the secondary disk. // https://cloud.google.com/compute/docs/reference/rest/v1/regionDisks/stopAsyncReplication rpc StopAsyncReplication(StopAsyncReplicationRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -221,8 +224,8 @@ service RegionDisks { option (google.cloud.operation_service) = "RegionOperations"; } - // Stops asynchronous replication for a consistency group of disks. Can be - // invoked either in the primary or secondary scope. + // Stops asynchronous replication for a consistency group of disks. + // Can be invoked either in the primary or secondary scope. // https://cloud.google.com/compute/docs/reference/rest/v1/regionDisks/stopGroupAsyncReplication rpc StopGroupAsyncReplication(StopGroupAsyncReplicationRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -248,8 +251,7 @@ service RegionDisks { } // 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. + // performed only on selected fields included as part of update-mask. // https://cloud.google.com/compute/docs/reference/rest/v1/regionDisks/update rpc UpdateDisk(UpdateDiskRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -261,6 +263,20 @@ service RegionDisks { "project,region,disk,update_mask,disk_resource"; option (google.cloud.operation_service) = "RegionOperations"; } + + // Rotates the customer-managed + // encryption key to the latest version for the specified persistent disk. + // https://cloud.google.com/compute/docs/reference/rest/v1/regionDisks/updateKmsKey + rpc UpdateKmsKey(UpdateKmsKeyRequest) + returns (google.cloud.cpp.compute.v1.Operation) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/regions/{region}/disks/{disk}/updateKmsKey" + body: "region_disk_update_kms_key_request_resource" + }; + option (google.api.method_signature) = + "project,region,disk,region_disk_update_kms_key_request_resource"; + option (google.cloud.operation_service) = "RegionOperations"; + } } // Request message for AddResourcePolicies. @@ -289,14 +305,17 @@ message AddResourcePoliciesRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 5 [json_name = "requestId"]; } @@ -322,14 +341,17 @@ message BulkInsertRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; } @@ -354,14 +376,17 @@ message CreateSnapshotRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; // The Snapshot for this request. @@ -390,14 +415,17 @@ message DeleteDiskRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; } @@ -456,14 +484,17 @@ message InsertDiskRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; // Source image to restore onto a disk. This field is optional. @@ -473,58 +504,89 @@ message InsertDiskRequest { // Request message for ListRegionDisks. message ListRegionDisksRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -536,9 +598,11 @@ message ListRegionDisksRequest { [(google.api.field_behavior) = REQUIRED, json_name = "region"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; } @@ -568,14 +632,17 @@ message RemoveResourcePoliciesRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 5 [json_name = "requestId"]; } @@ -605,14 +672,17 @@ message ResizeRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 5 [json_name = "requestId"]; } @@ -659,14 +729,17 @@ message SetLabelsRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; // Name or id of the resource for this request. @@ -700,14 +773,17 @@ message StartAsyncReplicationRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 5 [json_name = "requestId"]; } @@ -732,14 +808,17 @@ message StopAsyncReplicationRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; } @@ -767,14 +846,17 @@ message StopGroupAsyncReplicationRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; } @@ -824,16 +906,59 @@ message UpdateDiskRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 6 [json_name = "requestId"]; // update_mask indicates fields to be updated as part of this request. optional string update_mask = 7 [json_name = "updateMask"]; } + +// Request message for UpdateKmsKey. +message UpdateKmsKeyRequest { + // Name of the Disk resource, should conform to RFC1035. + string disk = 1 [(google.api.field_behavior) = REQUIRED, json_name = "disk"]; + + // Project ID for this request. + string project = 2 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "project", + json_name = "project" + ]; + + // The name of the region for this request. + string region = 3 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "region", + json_name = "region" + ]; + + // The RegionDiskUpdateKmsKeyRequest for this request. + optional google.cloud.cpp.compute.v1.RegionDiskUpdateKmsKeyRequest + region_disk_update_kms_key_request_resource = 4 + [json_name = "__json_request_body"]; + + // An optional request ID to identify requests. Specify a unique request ID so + // that if you must retry your request, the server will know to ignore the + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). + optional string request_id = 5 [json_name = "requestId"]; +} diff --git a/protos/google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies.proto b/protos/google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies.proto new file mode 100644 index 0000000000000..793ea6977a16c --- /dev/null +++ b/protos/google/cloud/compute/region_health_aggregation_policies/v1/region_health_aggregation_policies.proto @@ -0,0 +1,507 @@ +// Copyright 2026 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: 20260807 + +syntax = "proto3"; + +package google.cloud.cpp.compute.region_health_aggregation_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_019.proto"; +import "google/cloud/compute/v1/internal/common_060.proto"; +import "google/cloud/compute/v1/internal/common_171.proto"; +import "google/cloud/extended_operations.proto"; + +// Service for the regionHealthAggregationPolicies resource. +// https://cloud.google.com/compute/docs/reference/rest/v1/regionHealthAggregationPolicies +service RegionHealthAggregationPolicies { + option (google.api.default_host) = "compute.googleapis.com"; + option (google.api.oauth_scopes) = + "https://www.googleapis.com/auth/cloud-platform," + "https://www.googleapis.com/auth/compute," + "https://www.googleapis.com/auth/compute.readonly"; + + // Retrieves the list of all HealthAggregationPolicy resources, + // regional and global, available to the specified project. + // + // To prevent failure, it is recommended that you set the + // `returnPartialSuccess` parameter to `true`. + // https://cloud.google.com/compute/docs/reference/rest/v1/regionHealthAggregationPolicies/aggregatedList + rpc AggregatedListRegionHealthAggregationPolicies( + AggregatedListRegionHealthAggregationPoliciesRequest) + returns ( + google.cloud.cpp.compute.v1.HealthAggregationPolicyAggregatedList) { + option (google.api.http) = { + get: "/compute/v1/projects/{project}/aggregated/healthAggregationPolicies" + }; + option (google.api.method_signature) = "project"; + } + + // Deletes the specified HealthAggregationPolicy in the given region. + // https://cloud.google.com/compute/docs/reference/rest/v1/regionHealthAggregationPolicies/delete + rpc DeleteHealthAggregationPolicy(DeleteHealthAggregationPolicyRequest) + returns (google.cloud.cpp.compute.v1.Operation) { + option (google.api.http) = { + delete: "/compute/v1/projects/{project}/regions/{region}/healthAggregationPolicies/{health_aggregation_policy}" + }; + option (google.api.method_signature) = + "project,region,health_aggregation_policy"; + option (google.cloud.operation_service) = "RegionOperations"; + } + + // Returns the specified HealthAggregationPolicy resource in the given region. + // https://cloud.google.com/compute/docs/reference/rest/v1/regionHealthAggregationPolicies/get + rpc GetHealthAggregationPolicy(GetHealthAggregationPolicyRequest) + returns (google.cloud.cpp.compute.v1.HealthAggregationPolicy) { + option (google.api.http) = { + get: "/compute/v1/projects/{project}/regions/{region}/healthAggregationPolicies/{health_aggregation_policy}" + }; + option (google.api.method_signature) = + "project,region,health_aggregation_policy"; + } + + // Create a HealthAggregationPolicy in the specified project in the given + // region using the parameters that are included in the request. + // https://cloud.google.com/compute/docs/reference/rest/v1/regionHealthAggregationPolicies/insert + rpc InsertHealthAggregationPolicy(InsertHealthAggregationPolicyRequest) + returns (google.cloud.cpp.compute.v1.Operation) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/regions/{region}/healthAggregationPolicies" + body: "health_aggregation_policy_resource" + }; + option (google.api.method_signature) = + "project,region,health_aggregation_policy_resource"; + option (google.cloud.operation_service) = "RegionOperations"; + } + + // Lists the HealthAggregationPolicies for a project in the given region. + // https://cloud.google.com/compute/docs/reference/rest/v1/regionHealthAggregationPolicies/list + rpc ListRegionHealthAggregationPolicies( + ListRegionHealthAggregationPoliciesRequest) + returns (google.cloud.cpp.compute.v1.HealthAggregationPolicyList) { + option (google.api.http) = { + get: "/compute/v1/projects/{project}/regions/{region}/healthAggregationPolicies" + }; + option (google.api.method_signature) = "project,region"; + } + + // Updates the specified regional HealthAggregationPolicy + // resource with the data included in the request. This method supportsPATCH + // semantics and uses theJSON merge + // patch format and processing rules. + // https://cloud.google.com/compute/docs/reference/rest/v1/regionHealthAggregationPolicies/patch + rpc PatchHealthAggregationPolicy(PatchHealthAggregationPolicyRequest) + returns (google.cloud.cpp.compute.v1.Operation) { + option (google.api.http) = { + patch: "/compute/v1/projects/{project}/regions/{region}/healthAggregationPolicies/{health_aggregation_policy}" + body: "health_aggregation_policy_resource" + }; + option (google.api.method_signature) = + "project,region,health_aggregation_policy,health_aggregation_policy_resource"; + option (google.cloud.operation_service) = "RegionOperations"; + } + + // Returns permissions that a caller has on the specified resource. + // https://cloud.google.com/compute/docs/reference/rest/v1/regionHealthAggregationPolicies/testIamPermissions + rpc TestIamPermissions(TestIamPermissionsRequest) + returns (google.cloud.cpp.compute.v1.TestPermissionsResponse) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/regions/{region}/healthAggregationPolicies/{resource}/testIamPermissions" + body: "test_permissions_request_resource" + }; + option (google.api.method_signature) = + "project,region,resource,test_permissions_request_resource"; + } +} + +// Request message for AggregatedListRegionHealthAggregationPolicies. +message AggregatedListRegionHealthAggregationPoliciesRequest { + // A filter expression that filters resources listed in the response. Most + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. + optional string filter = 1 [json_name = "filter"]; + + // 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. + optional bool include_all_scopes = 2 [json_name = "includeAllScopes"]; + + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) + optional uint32 max_results = 3 [json_name = "maxResults"]; + + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or + // `creationTimestamp desc` is supported. + optional string order_by = 4 [json_name = "orderBy"]; + + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. + optional string page_token = 5 [json_name = "pageToken"]; + + // Name of the project scoping this request. + string project = 6 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // Opt-in for partial success behavior which provides partial results in case + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. + optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; + + // The Shared VPC service project id or service project number for which + // aggregated list request is invoked for subnetworks list-usable api. + optional string service_project_number = 8 + [json_name = "serviceProjectNumber"]; +} + +// Request message for DeleteHealthAggregationPolicy. +message DeleteHealthAggregationPolicyRequest { + // Name of the HealthAggregationPolicy resource to delete. + string health_aggregation_policy = 1 [ + (google.api.field_behavior) = REQUIRED, + json_name = "healthAggregationPolicy" + ]; + + // Project ID for this request. + string project = 2 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "project", + json_name = "project" + ]; + + // Name of the region scoping this request. + string region = 3 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "region", + json_name = "region" + ]; + + // An optional request ID to identify requests. Specify a unique request ID so + // that if you must retry your request, the server will know to ignore the + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). + optional string request_id = 4 [json_name = "requestId"]; +} + +// Request message for GetHealthAggregationPolicy. +message GetHealthAggregationPolicyRequest { + // Name of the HealthAggregationPolicy resource to return. + string health_aggregation_policy = 1 [ + (google.api.field_behavior) = REQUIRED, + json_name = "healthAggregationPolicy" + ]; + + // Project ID for this request. + string project = 2 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // Name of the region scoping this request. + string region = 3 + [(google.api.field_behavior) = REQUIRED, json_name = "region"]; +} + +// Request message for InsertHealthAggregationPolicy. +message InsertHealthAggregationPolicyRequest { + // The HealthAggregationPolicy for this request. + optional google.cloud.cpp.compute.v1.HealthAggregationPolicy + health_aggregation_policy_resource = 1 + [json_name = "__json_request_body"]; + + // Project ID for this request. + string project = 2 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "project", + json_name = "project" + ]; + + // Name of the region scoping this request. + string region = 3 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "region", + json_name = "region" + ]; + + // An optional request ID to identify requests. Specify a unique request ID so + // that if you must retry your request, the server will know to ignore the + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). + optional string request_id = 4 [json_name = "requestId"]; +} + +// Request message for ListRegionHealthAggregationPolicies. +message ListRegionHealthAggregationPoliciesRequest { + // A filter expression that filters resources listed in the response. Most + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. + optional string filter = 1 [json_name = "filter"]; + + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) + optional uint32 max_results = 2 [json_name = "maxResults"]; + + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or + // `creationTimestamp desc` is supported. + optional string order_by = 3 [json_name = "orderBy"]; + + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. + optional string page_token = 4 [json_name = "pageToken"]; + + // Project ID for this request. + string project = 5 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // Name of the region scoping this request. + string region = 6 + [(google.api.field_behavior) = REQUIRED, json_name = "region"]; + + // Opt-in for partial success behavior which provides partial results in case + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. + optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; +} + +// Request message for PatchHealthAggregationPolicy. +message PatchHealthAggregationPolicyRequest { + // Name of the HealthAggregationPolicy to update. The name + // must be 1-63 characters long, and comply with RFC1035. + string health_aggregation_policy = 1 [ + (google.api.field_behavior) = REQUIRED, + json_name = "healthAggregationPolicy" + ]; + + // The HealthAggregationPolicy for this request. + optional google.cloud.cpp.compute.v1.HealthAggregationPolicy + health_aggregation_policy_resource = 2 + [json_name = "__json_request_body"]; + + // Project ID for this request. + string project = 3 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "project", + json_name = "project" + ]; + + // Name of the region scoping this request. + string region = 4 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "region", + json_name = "region" + ]; + + // An optional request ID to identify requests. Specify a unique request ID so + // that if you must retry your request, the server will know to ignore the + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). + optional string request_id = 5 [json_name = "requestId"]; +} + +// Request message for TestIamPermissions. +message TestIamPermissionsRequest { + // Project ID for this request. + string project = 1 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // The name of the region for this request. + string region = 2 + [(google.api.field_behavior) = REQUIRED, json_name = "region"]; + + // Name or id of the resource for this request. + string resource = 3 + [(google.api.field_behavior) = REQUIRED, json_name = "resource"]; + + // The TestPermissionsRequest for this request. + optional google.cloud.cpp.compute.v1.TestPermissionsRequest + test_permissions_request_resource = 4 [json_name = "__json_request_body"]; +} 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 d548427202c94..4cfa6a7d7843f 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: 20250601 +// revision: 20260807 syntax = "proto3"; @@ -24,8 +24,9 @@ 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_016.proto"; -import "google/cloud/compute/v1/internal/common_050.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_062.proto"; +import "google/cloud/compute/v1/internal/common_171.proto"; import "google/cloud/extended_operations.proto"; // Service for the regionHealthCheckServices resource. @@ -37,6 +38,21 @@ service RegionHealthCheckServices { "https://www.googleapis.com/auth/compute," "https://www.googleapis.com/auth/compute.readonly"; + // Retrieves the list of all HealthCheckService resources, + // regional and global, available to the specified project. + // + // To prevent failure, it is recommended that you set the + // `returnPartialSuccess` parameter to `true`. + // https://cloud.google.com/compute/docs/reference/rest/v1/regionHealthCheckServices/aggregatedList + rpc AggregatedListRegionHealthCheckServices( + AggregatedListRegionHealthCheckServicesRequest) + returns (google.cloud.cpp.compute.v1.HealthCheckServiceAggregatedList) { + option (google.api.http) = { + get: "/compute/v1/projects/{project}/aggregated/healthCheckServices" + }; + option (google.api.method_signature) = "project"; + } + // Deletes the specified regional HealthCheckService. // https://cloud.google.com/compute/docs/reference/rest/v1/regionHealthCheckServices/delete rpc DeleteHealthCheckService(DeleteHealthCheckServiceRequest) @@ -60,8 +76,8 @@ service RegionHealthCheckServices { "project,region,health_check_service"; } - // Creates a regional HealthCheckService resource in the specified project and - // region using the data included in the request. + // Creates a regional HealthCheckService resource in the + // specified project and region using the data included in the request. // https://cloud.google.com/compute/docs/reference/rest/v1/regionHealthCheckServices/insert rpc InsertHealthCheckService(InsertHealthCheckServiceRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -74,8 +90,8 @@ service RegionHealthCheckServices { option (google.cloud.operation_service) = "RegionOperations"; } - // Lists all the HealthCheckService resources that have been configured for - // the specified project in the given region. + // Lists all the HealthCheckService resources that have been + // configured for the specified project in the given region. // https://cloud.google.com/compute/docs/reference/rest/v1/regionHealthCheckServices/list rpc ListRegionHealthCheckServices(ListRegionHealthCheckServicesRequest) returns (google.cloud.cpp.compute.v1.HealthCheckServicesList) { @@ -85,9 +101,10 @@ service RegionHealthCheckServices { option (google.api.method_signature) = "project,region"; } - // 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. + // Updates the specified regional HealthCheckService resource + // with the data included in the request. This method supportsPATCH + // semantics and uses theJSON merge + // patch format and processing rules. // https://cloud.google.com/compute/docs/reference/rest/v1/regionHealthCheckServices/patch rpc PatchHealthCheckService(PatchHealthCheckServiceRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -99,12 +116,139 @@ service RegionHealthCheckServices { "project,region,health_check_service,health_check_service_resource"; option (google.cloud.operation_service) = "RegionOperations"; } + + // Returns permissions that a caller has on the specified resource. + // https://cloud.google.com/compute/docs/reference/rest/v1/regionHealthCheckServices/testIamPermissions + rpc TestIamPermissions(TestIamPermissionsRequest) + returns (google.cloud.cpp.compute.v1.TestPermissionsResponse) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/regions/{region}/healthCheckServices/{resource}/testIamPermissions" + body: "test_permissions_request_resource" + }; + option (google.api.method_signature) = + "project,region,resource,test_permissions_request_resource"; + } +} + +// Request message for AggregatedListRegionHealthCheckServices. +message AggregatedListRegionHealthCheckServicesRequest { + // A filter expression that filters resources listed in the response. Most + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. + optional string filter = 1 [json_name = "filter"]; + + // 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. + optional bool include_all_scopes = 2 [json_name = "includeAllScopes"]; + + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) + optional uint32 max_results = 3 [json_name = "maxResults"]; + + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or + // `creationTimestamp desc` is supported. + optional string order_by = 4 [json_name = "orderBy"]; + + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. + optional string page_token = 5 [json_name = "pageToken"]; + + // Name of the project scoping this request. + string project = 6 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // Opt-in for partial success behavior which provides partial results in case + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. + optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; + + // The Shared VPC service project id or service project number for which + // aggregated list request is invoked for subnetworks list-usable api. + optional string service_project_number = 8 + [json_name = "serviceProjectNumber"]; } // Request message for DeleteHealthCheckService. message DeleteHealthCheckServiceRequest { - // Name of the HealthCheckService to delete. The name must be 1-63 characters - // long, and comply with RFC1035. + // Name of the HealthCheckService to delete. The name + // must be 1-63 characters long, and comply with RFC1035. string health_check_service = 1 [ (google.api.field_behavior) = REQUIRED, json_name = "healthCheckService" @@ -126,21 +270,24 @@ message DeleteHealthCheckServiceRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; } // Request message for GetHealthCheckService. message GetHealthCheckServiceRequest { - // Name of the HealthCheckService to update. The name must be 1-63 characters - // long, and comply with RFC1035. + // Name of the HealthCheckService to update. The name + // must be 1-63 characters long, and comply with RFC1035. string health_check_service = 1 [ (google.api.field_behavior) = REQUIRED, json_name = "healthCheckService" @@ -177,72 +324,106 @@ message InsertHealthCheckServiceRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; } // Request message for ListRegionHealthCheckServices. message ListRegionHealthCheckServicesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -254,16 +435,18 @@ message ListRegionHealthCheckServicesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "region"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; } // Request message for PatchHealthCheckService. message PatchHealthCheckServiceRequest { - // Name of the HealthCheckService to update. The name must be 1-63 characters - // long, and comply with RFC1035. + // Name of the HealthCheckService to update. The name + // must be 1-63 characters long, and comply with RFC1035. string health_check_service = 1 [ (google.api.field_behavior) = REQUIRED, json_name = "healthCheckService" @@ -289,13 +472,35 @@ message PatchHealthCheckServiceRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 5 [json_name = "requestId"]; } + +// Request message for TestIamPermissions. +message TestIamPermissionsRequest { + // Project ID for this request. + string project = 1 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // The name of the region for this request. + string region = 2 + [(google.api.field_behavior) = REQUIRED, json_name = "region"]; + + // Name or id of the resource for this request. + string resource = 3 + [(google.api.field_behavior) = REQUIRED, json_name = "resource"]; + + // The TestPermissionsRequest for this request. + optional google.cloud.cpp.compute.v1.TestPermissionsRequest + test_permissions_request_resource = 4 [json_name = "__json_request_body"]; +} 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 eb8c5c6574cac..571a004b2d154 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: 20250601 +// revision: 20260807 syntax = "proto3"; @@ -24,8 +24,9 @@ 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_016.proto"; -import "google/cloud/compute/v1/internal/common_043.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_053.proto"; +import "google/cloud/compute/v1/internal/common_171.proto"; import "google/cloud/extended_operations.proto"; // Service for the regionHealthChecks resource. @@ -84,8 +85,9 @@ service RegionHealthChecks { } // 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. + // included in the request. This method supportsPATCH + // semantics and uses theJSON merge + // patch format and processing rules. // https://cloud.google.com/compute/docs/reference/rest/v1/regionHealthChecks/patch rpc PatchHealthCheck(PatchHealthCheckRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -98,6 +100,18 @@ service RegionHealthChecks { option (google.cloud.operation_service) = "RegionOperations"; } + // Returns permissions that a caller has on the specified resource. + // https://cloud.google.com/compute/docs/reference/rest/v1/regionHealthChecks/testIamPermissions + rpc TestIamPermissions(TestIamPermissionsRequest) + returns (google.cloud.cpp.compute.v1.TestPermissionsResponse) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/regions/{region}/healthChecks/{resource}/testIamPermissions" + body: "test_permissions_request_resource" + }; + option (google.api.method_signature) = + "project,region,resource,test_permissions_request_resource"; + } + // Updates a HealthCheck resource in the specified project using the data // included in the request. // https://cloud.google.com/compute/docs/reference/rest/v1/regionHealthChecks/update @@ -135,14 +149,17 @@ message DeleteHealthCheckRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; } @@ -183,72 +200,106 @@ message InsertHealthCheckRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; } // Request message for ListRegionHealthChecks. message ListRegionHealthChecksRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -260,9 +311,11 @@ message ListRegionHealthChecksRequest { [(google.api.field_behavior) = REQUIRED, json_name = "region"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; } @@ -292,17 +345,39 @@ message PatchHealthCheckRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 5 [json_name = "requestId"]; } +// Request message for TestIamPermissions. +message TestIamPermissionsRequest { + // Project ID for this request. + string project = 1 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // The name of the region for this request. + string region = 2 + [(google.api.field_behavior) = REQUIRED, json_name = "region"]; + + // Name or id of the resource for this request. + string resource = 3 + [(google.api.field_behavior) = REQUIRED, json_name = "resource"]; + + // The TestPermissionsRequest for this request. + optional google.cloud.cpp.compute.v1.TestPermissionsRequest + test_permissions_request_resource = 4 [json_name = "__json_request_body"]; +} + // Request message for UpdateHealthCheck. message UpdateHealthCheckRequest { // Name of the HealthCheck resource to update. @@ -329,13 +404,16 @@ message UpdateHealthCheckRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 5 [json_name = "requestId"]; } diff --git a/protos/google/cloud/compute/region_health_sources/v1/region_health_sources.proto b/protos/google/cloud/compute/region_health_sources/v1/region_health_sources.proto new file mode 100644 index 0000000000000..f31050a5831d3 --- /dev/null +++ b/protos/google/cloud/compute/region_health_sources/v1/region_health_sources.proto @@ -0,0 +1,521 @@ +// Copyright 2026 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: 20260807 + +syntax = "proto3"; + +package google.cloud.cpp.compute.region_health_sources.v1; + +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_064.proto"; +import "google/cloud/compute/v1/internal/common_171.proto"; +import "google/cloud/extended_operations.proto"; + +// Service for the regionHealthSources resource. +// https://cloud.google.com/compute/docs/reference/rest/v1/regionHealthSources +service RegionHealthSources { + option (google.api.default_host) = "compute.googleapis.com"; + option (google.api.oauth_scopes) = + "https://www.googleapis.com/auth/cloud-platform," + "https://www.googleapis.com/auth/compute," + "https://www.googleapis.com/auth/compute.readonly"; + + // Retrieves the list of all HealthSource resources (all + // regional) available to the specified project. + // + // To prevent failure, Google recommends that you set the + // `returnPartialSuccess` parameter to `true`. + // https://cloud.google.com/compute/docs/reference/rest/v1/regionHealthSources/aggregatedList + rpc AggregatedListRegionHealthSources( + AggregatedListRegionHealthSourcesRequest) + returns (google.cloud.cpp.compute.v1.HealthSourceAggregatedList) { + option (google.api.http) = { + get: "/compute/v1/projects/{project}/aggregated/healthSources" + }; + option (google.api.method_signature) = "project"; + } + + // Deletes the specified HealthSource in the given region + // https://cloud.google.com/compute/docs/reference/rest/v1/regionHealthSources/delete + rpc DeleteHealthSource(DeleteHealthSourceRequest) + returns (google.cloud.cpp.compute.v1.Operation) { + option (google.api.http) = { + delete: "/compute/v1/projects/{project}/regions/{region}/healthSources/{health_source}" + }; + option (google.api.method_signature) = "project,region,health_source"; + option (google.cloud.operation_service) = "RegionOperations"; + } + + // Returns the specified HealthSource resource in the given region. + // https://cloud.google.com/compute/docs/reference/rest/v1/regionHealthSources/get + rpc GetHealthSource(GetHealthSourceRequest) + returns (google.cloud.cpp.compute.v1.HealthSource) { + option (google.api.http) = { + get: "/compute/v1/projects/{project}/regions/{region}/healthSources/{health_source}" + }; + option (google.api.method_signature) = "project,region,health_source"; + } + + // Gets the most recent health check results for this + // regional HealthSource. + // https://cloud.google.com/compute/docs/reference/rest/v1/regionHealthSources/getHealth + rpc GetHealth(GetHealthRequest) + returns (google.cloud.cpp.compute.v1.HealthSourceHealth) { + option (google.api.http) = { + get: "/compute/v1/projects/{project}/regions/{region}/healthSources/{health_source}/getHealth" + }; + option (google.api.method_signature) = "project,region,health_source"; + } + + // Create a HealthSource in the specified project in the given region + // using the parameters that are included in the request. + // https://cloud.google.com/compute/docs/reference/rest/v1/regionHealthSources/insert + rpc InsertHealthSource(InsertHealthSourceRequest) + returns (google.cloud.cpp.compute.v1.Operation) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/regions/{region}/healthSources" + body: "health_source_resource" + }; + option (google.api.method_signature) = + "project,region,health_source_resource"; + option (google.cloud.operation_service) = "RegionOperations"; + } + + // Lists the HealthSources for a project in the given region. + // https://cloud.google.com/compute/docs/reference/rest/v1/regionHealthSources/list + rpc ListRegionHealthSources(ListRegionHealthSourcesRequest) + returns (google.cloud.cpp.compute.v1.HealthSourceList) { + option (google.api.http) = { + get: "/compute/v1/projects/{project}/regions/{region}/healthSources" + }; + option (google.api.method_signature) = "project,region"; + } + + // Updates the specified regional HealthSource resource + // with the data included in the request. This method supportsPATCH + // semantics and uses theJSON merge + // patch format and processing rules. + // https://cloud.google.com/compute/docs/reference/rest/v1/regionHealthSources/patch + rpc PatchHealthSource(PatchHealthSourceRequest) + returns (google.cloud.cpp.compute.v1.Operation) { + option (google.api.http) = { + patch: "/compute/v1/projects/{project}/regions/{region}/healthSources/{health_source}" + body: "health_source_resource" + }; + option (google.api.method_signature) = + "project,region,health_source,health_source_resource"; + option (google.cloud.operation_service) = "RegionOperations"; + } + + // Returns permissions that a caller has on the specified resource. + // https://cloud.google.com/compute/docs/reference/rest/v1/regionHealthSources/testIamPermissions + rpc TestIamPermissions(TestIamPermissionsRequest) + returns (google.cloud.cpp.compute.v1.TestPermissionsResponse) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/regions/{region}/healthSources/{resource}/testIamPermissions" + body: "test_permissions_request_resource" + }; + option (google.api.method_signature) = + "project,region,resource,test_permissions_request_resource"; + } +} + +// Request message for AggregatedListRegionHealthSources. +message AggregatedListRegionHealthSourcesRequest { + // A filter expression that filters resources listed in the response. Most + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. + optional string filter = 1 [json_name = "filter"]; + + // 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. + optional bool include_all_scopes = 2 [json_name = "includeAllScopes"]; + + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) + optional uint32 max_results = 3 [json_name = "maxResults"]; + + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or + // `creationTimestamp desc` is supported. + optional string order_by = 4 [json_name = "orderBy"]; + + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. + optional string page_token = 5 [json_name = "pageToken"]; + + // Name of the project scoping this request. + string project = 6 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // Opt-in for partial success behavior which provides partial results in case + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. + optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; + + // The Shared VPC service project id or service project number for which + // aggregated list request is invoked for subnetworks list-usable api. + optional string service_project_number = 8 + [json_name = "serviceProjectNumber"]; +} + +// Request message for DeleteHealthSource. +message DeleteHealthSourceRequest { + // Name of the HealthSource resource to delete. + string health_source = 1 + [(google.api.field_behavior) = REQUIRED, json_name = "healthSource"]; + + // Project ID for this request. + string project = 2 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "project", + json_name = "project" + ]; + + // Name of the region scoping this request. + string region = 3 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "region", + json_name = "region" + ]; + + // An optional request ID to identify requests. Specify a unique request ID so + // that if you must retry your request, the server will know to ignore the + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). + optional string request_id = 4 [json_name = "requestId"]; +} + +// Request message for GetHealth. +message GetHealthRequest { + // Name of the HealthSource resource to get health for. + string health_source = 1 + [(google.api.field_behavior) = REQUIRED, json_name = "healthSource"]; + + // Name of the project scoping this request. + string project = 2 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // Name of the region scoping this request. + string region = 3 + [(google.api.field_behavior) = REQUIRED, json_name = "region"]; +} + +// Request message for GetHealthSource. +message GetHealthSourceRequest { + // Name of the HealthSource resource to return. + string health_source = 1 + [(google.api.field_behavior) = REQUIRED, json_name = "healthSource"]; + + // Project ID for this request. + string project = 2 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // Name of the region scoping this request. + string region = 3 + [(google.api.field_behavior) = REQUIRED, json_name = "region"]; +} + +// Request message for InsertHealthSource. +message InsertHealthSourceRequest { + // The HealthSource for this request. + optional google.cloud.cpp.compute.v1.HealthSource health_source_resource = 1 + [json_name = "__json_request_body"]; + + // Project ID for this request. + string project = 2 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "project", + json_name = "project" + ]; + + // Name of the region scoping this request. + string region = 3 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "region", + json_name = "region" + ]; + + // An optional request ID to identify requests. Specify a unique request ID so + // that if you must retry your request, the server will know to ignore the + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). + optional string request_id = 4 [json_name = "requestId"]; +} + +// Request message for ListRegionHealthSources. +message ListRegionHealthSourcesRequest { + // A filter expression that filters resources listed in the response. Most + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. + optional string filter = 1 [json_name = "filter"]; + + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) + optional uint32 max_results = 2 [json_name = "maxResults"]; + + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or + // `creationTimestamp desc` is supported. + optional string order_by = 3 [json_name = "orderBy"]; + + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. + optional string page_token = 4 [json_name = "pageToken"]; + + // Project ID for this request. + string project = 5 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // Name of the region scoping this request. + string region = 6 + [(google.api.field_behavior) = REQUIRED, json_name = "region"]; + + // Opt-in for partial success behavior which provides partial results in case + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. + optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; +} + +// Request message for PatchHealthSource. +message PatchHealthSourceRequest { + // Name of the HealthSource to update. The name + // must be 1-63 characters long, and comply with RFC1035. + string health_source = 1 + [(google.api.field_behavior) = REQUIRED, json_name = "healthSource"]; + + // The HealthSource for this request. + optional google.cloud.cpp.compute.v1.HealthSource health_source_resource = 2 + [json_name = "__json_request_body"]; + + // Project ID for this request. + string project = 3 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "project", + json_name = "project" + ]; + + // Name of the region scoping this request. + string region = 4 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "region", + json_name = "region" + ]; + + // An optional request ID to identify requests. Specify a unique request ID so + // that if you must retry your request, the server will know to ignore the + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). + optional string request_id = 5 [json_name = "requestId"]; +} + +// Request message for TestIamPermissions. +message TestIamPermissionsRequest { + // Project ID for this request. + string project = 1 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // The name of the region for this request. + string region = 2 + [(google.api.field_behavior) = REQUIRED, json_name = "region"]; + + // Name or id of the resource for this request. + string resource = 3 + [(google.api.field_behavior) = REQUIRED, json_name = "resource"]; + + // The TestPermissionsRequest for this request. + optional google.cloud.cpp.compute.v1.TestPermissionsRequest + test_permissions_request_resource = 4 [json_name = "__json_request_body"]; +} diff --git a/protos/google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests.proto b/protos/google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests.proto new file mode 100644 index 0000000000000..651daf7710203 --- /dev/null +++ b/protos/google/cloud/compute/region_instance_group_manager_resize_requests/v1/region_instance_group_manager_resize_requests.proto @@ -0,0 +1,382 @@ +// Copyright 2026 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: 20260807 + +syntax = "proto3"; + +package google.cloud.cpp.compute.region_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_019.proto"; +import "google/cloud/compute/v1/internal/common_076.proto"; +import "google/cloud/compute/v1/internal/common_122.proto"; +import "google/cloud/extended_operations.proto"; + +// Service for the regionInstanceGroupManagerResizeRequests resource. +// https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroupManagerResizeRequests +service RegionInstanceGroupManagerResizeRequests { + option (google.api.default_host) = "compute.googleapis.com"; + option (google.api.oauth_scopes) = + "https://www.googleapis.com/auth/cloud-platform," + "https://www.googleapis.com/auth/compute," + "https://www.googleapis.com/auth/compute.readonly"; + + // Cancels the specified resize request. + // Cancelled resize request no longer waits for the resources to be + // provisioned. Cancel is only possible for requests that are in accepted + // state. + // https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroupManagerResizeRequests/cancel + rpc Cancel(CancelRequest) returns (google.cloud.cpp.compute.v1.Operation) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/regions/{region}/instanceGroupManagers/{instance_group_manager}/resizeRequests/{resize_request}/cancel" + body: "*" + }; + option (google.api.method_signature) = + "project,region,instance_group_manager,resize_request"; + option (google.cloud.operation_service) = "RegionOperations"; + } + + // Deletes the specified, inactive resize request. Requests that are still + // active cannot be deleted. Deleting request does not delete instances that + // were provisioned previously. + // https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroupManagerResizeRequests/delete + rpc DeleteInstanceGroupManagerResizeRequest( + DeleteInstanceGroupManagerResizeRequestRequest) + returns (google.cloud.cpp.compute.v1.Operation) { + option (google.api.http) = { + delete: "/compute/v1/projects/{project}/regions/{region}/instanceGroupManagers/{instance_group_manager}/resizeRequests/{resize_request}" + }; + option (google.api.method_signature) = + "project,region,instance_group_manager,resize_request"; + option (google.cloud.operation_service) = "RegionOperations"; + } + + // Returns all of the details about the specified resize request. + // https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroupManagerResizeRequests/get + rpc GetInstanceGroupManagerResizeRequest( + GetInstanceGroupManagerResizeRequestRequest) + returns (google.cloud.cpp.compute.v1.InstanceGroupManagerResizeRequest) { + option (google.api.http) = { + get: "/compute/v1/projects/{project}/regions/{region}/instanceGroupManagers/{instance_group_manager}/resizeRequests/{resize_request}" + }; + option (google.api.method_signature) = + "project,region,instance_group_manager,resize_request"; + } + + // Creates a new Resize Request that starts provisioning VMs immediately + // or queues VM creation. + // https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroupManagerResizeRequests/insert + rpc InsertInstanceGroupManagerResizeRequest( + InsertInstanceGroupManagerResizeRequestRequest) + returns (google.cloud.cpp.compute.v1.Operation) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/regions/{region}/instanceGroupManagers/{instance_group_manager}/resizeRequests" + body: "instance_group_manager_resize_request_resource" + }; + option (google.api.method_signature) = + "project,region,instance_group_manager,instance_group_manager_resize_request_resource"; + option (google.cloud.operation_service) = "RegionOperations"; + } + + // Retrieves a list of Resize Requests that are contained in the + // managed instance group. + // https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroupManagerResizeRequests/list + rpc ListRegionInstanceGroupManagerResizeRequests( + ListRegionInstanceGroupManagerResizeRequestsRequest) + returns (google.cloud.cpp.compute.v1 + .RegionInstanceGroupManagerResizeRequestsListResponse) { + option (google.api.http) = { + get: "/compute/v1/projects/{project}/regions/{region}/instanceGroupManagers/{instance_group_manager}/resizeRequests" + }; + option (google.api.method_signature) = + "project,region,instance_group_manager"; + } +} + +// Request message for Cancel. +message CancelRequest { + // The name of the managed instance group. + // Name should conform to RFC1035 or be a resource ID. + string instance_group_manager = 1 [ + (google.api.field_behavior) = REQUIRED, + json_name = "instanceGroupManager" + ]; + + // Project ID for this request. + string project = 2 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "project", + json_name = "project" + ]; + + // The name of the region + // scoping this request. Name should conform to RFC1035. + string region = 3 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "region", + json_name = "region" + ]; + + // An optional request ID to identify requests. Specify a unique request ID so + // that if you must retry your request, the server will know to ignore the + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). + optional string request_id = 4 [json_name = "requestId"]; + + // The name of the resize request to cancel. + // Name should conform to RFC1035 or be a resource ID. + string resize_request = 5 + [(google.api.field_behavior) = REQUIRED, json_name = "resizeRequest"]; +} + +// Request message for DeleteInstanceGroupManagerResizeRequest. +message DeleteInstanceGroupManagerResizeRequestRequest { + // The name of the managed instance group. + // Name should conform to RFC1035 or be a resource ID. + string instance_group_manager = 1 [ + (google.api.field_behavior) = REQUIRED, + json_name = "instanceGroupManager" + ]; + + // Project ID for this request. + string project = 2 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "project", + json_name = "project" + ]; + + // The name of the region + // scoping this request. Name should conform to RFC1035. + string region = 3 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "region", + json_name = "region" + ]; + + // An optional request ID to identify requests. Specify a unique request ID so + // that if you must retry your request, the server will know to ignore the + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). + optional string request_id = 4 [json_name = "requestId"]; + + // The name of the resize request to delete. + // Name should conform to RFC1035 or be a resource ID. + string resize_request = 5 + [(google.api.field_behavior) = REQUIRED, json_name = "resizeRequest"]; +} + +// Request message for GetInstanceGroupManagerResizeRequest. +message GetInstanceGroupManagerResizeRequestRequest { + // The name of the managed instance group. + // Name should conform to RFC1035 or be a resource ID. + string instance_group_manager = 1 [ + (google.api.field_behavior) = REQUIRED, + json_name = "instanceGroupManager" + ]; + + // Project ID for this request. + string project = 2 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // The name of the region + // scoping this request. Name should conform to RFC1035. + string region = 3 + [(google.api.field_behavior) = REQUIRED, json_name = "region"]; + + // The name of the resize request. + // Name should conform to RFC1035 or be a resource ID. + string resize_request = 4 + [(google.api.field_behavior) = REQUIRED, json_name = "resizeRequest"]; +} + +// Request message for InsertInstanceGroupManagerResizeRequest. +message InsertInstanceGroupManagerResizeRequestRequest { + // Name of the managed instance group to which the resize request is scoped. + // Name should conform to RFC1035 or be a resource ID. + string instance_group_manager = 1 [ + (google.api.field_behavior) = REQUIRED, + json_name = "instanceGroupManager" + ]; + + // The InstanceGroupManagerResizeRequest for this request. + optional google.cloud.cpp.compute.v1.InstanceGroupManagerResizeRequest + instance_group_manager_resize_request_resource = 2 + [json_name = "__json_request_body"]; + + // Project ID for this request. + string project = 3 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "project", + json_name = "project" + ]; + + // Name of the region + // scoping this request. Name should conform to RFC1035. + string region = 4 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "region", + json_name = "region" + ]; + + // An optional request ID to identify requests. Specify a unique request ID so + // that if you must retry your request, the server will know to ignore the + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). + optional string request_id = 5 [json_name = "requestId"]; +} + +// Request message for ListRegionInstanceGroupManagerResizeRequests. +message ListRegionInstanceGroupManagerResizeRequestsRequest { + // A filter expression that filters resources listed in the response. Most + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. + optional string filter = 1 [json_name = "filter"]; + + // The name of the managed instance group. The name should conform to RFC1035. + string instance_group_manager = 2 [ + (google.api.field_behavior) = REQUIRED, + json_name = "instanceGroupManager" + ]; + + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) + optional uint32 max_results = 3 [json_name = "maxResults"]; + + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or + // `creationTimestamp desc` is supported. + optional string order_by = 4 [json_name = "orderBy"]; + + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. + optional string page_token = 5 [json_name = "pageToken"]; + + // Project ID for this request. + string project = 6 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // Name of the region + // scoping this request. Name should conform to RFC1035. + string region = 7 + [(google.api.field_behavior) = REQUIRED, json_name = "region"]; + + // Opt-in for partial success behavior which provides partial results in case + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. + optional bool return_partial_success = 8 [json_name = "returnPartialSuccess"]; +} 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 dc6699871714f..1e79d21177000 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: 20250601 +// revision: 20260807 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_016.proto"; -import "google/cloud/compute/v1/internal/common_028.proto"; -import "google/cloud/compute/v1/internal/common_104.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_037.proto"; +import "google/cloud/compute/v1/internal/common_121.proto"; import "google/cloud/extended_operations.proto"; // Service for the regionInstanceGroupManagers resource. @@ -39,17 +39,22 @@ service RegionInstanceGroupManagers { "https://www.googleapis.com/auth/compute.readonly"; // 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. + // 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 thetargetSize of + // the managed instance group by the + // number of instances that you abandon. This operation is marked asDONE 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 thelistmanagedinstances + // 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. // https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroupManagers/abandonInstances rpc AbandonInstances(AbandonInstancesRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -77,10 +82,11 @@ service RegionInstanceGroupManagers { // 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. + // 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 + // thecreating or actions with the listmanagedinstances + // method. // https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroupManagers/createInstances rpc CreateInstances(CreateInstancesRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -93,8 +99,8 @@ service RegionInstanceGroupManagers { option (google.cloud.operation_service) = "RegionOperations"; } - // Deletes the specified managed instance group and all of the instances in - // that group. + // Deletes the specified managed instance group and all of the instances + // in that group. // https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroupManagers/delete rpc DeleteInstanceGroupManager(DeleteInstanceGroupManagerRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -107,17 +113,22 @@ service RegionInstanceGroupManagers { } // 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. + // immediately deleted. The instances are also removed from any target + // pools of which they were a member. This method reduces thetargetSize 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 + // thedeleting action with thelistmanagedinstances + // 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. // https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroupManagers/deleteInstances rpc DeleteInstances(DeleteInstancesRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -155,13 +166,16 @@ service RegionInstanceGroupManagers { "project,region,instance_group_manager"; } - // 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. + // 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 + // thelistmanagedinstances + // method. + // + // A regional managed instance group can contain up to 2000 instances. // https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroupManagers/insert rpc InsertInstanceGroupManager(InsertInstanceGroupManagerRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -174,8 +188,8 @@ service RegionInstanceGroupManagers { option (google.cloud.operation_service) = "RegionOperations"; } - // Retrieves the list of managed instance groups that are contained within the - // specified region. + // Retrieves the list of managed instance groups that are contained + // within the specified region. // https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroupManagers/list rpc ListRegionInstanceGroupManagers(ListRegionInstanceGroupManagersRequest) returns (google.cloud.cpp.compute.v1.RegionInstanceGroupManagerList) { @@ -186,7 +200,7 @@ service RegionInstanceGroupManagers { } // Lists all errors thrown by actions on instances for a given regional - // managed instance group. The filter and orderBy query parameters are not + // managed instance group. The filter andorderBy query parameters are not // supported. // https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroupManagers/listErrors rpc ListErrors(ListErrorsRequest) @@ -200,10 +214,11 @@ service RegionInstanceGroupManagers { } // 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`. + // 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`. // https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroupManagers/listManagedInstances rpc ListManagedInstances(ListManagedInstancesRequest) returns (google.cloud.cpp.compute.v1 @@ -230,16 +245,22 @@ service RegionInstanceGroupManagers { "project,region,instance_group_manager"; } - // 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 + // 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. + // with the listmanagedinstances + // method. This method supportsPATCH + // semantics and uses theJSON 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, seeUpdating + // instances in + // a MIG. // https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroupManagers/patch rpc PatchInstanceGroupManager(PatchInstanceGroupManagerRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -253,8 +274,8 @@ service RegionInstanceGroupManagers { } // 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. + // group. perInstanceConfig.name serves as a key used to + // distinguish whether to perform insert or patch. // https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroupManagers/patchPerInstanceConfigs rpc PatchPerInstanceConfigs(PatchPerInstanceConfigsRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -269,14 +290,18 @@ service RegionInstanceGroupManagers { // 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. + // 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 itscurrentAction + // 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. // https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroupManagers/recreateInstances rpc RecreateInstances(RecreateInstancesRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -292,13 +317,18 @@ service RegionInstanceGroupManagers { // 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. + // instances. + // + // The resize operation is marked DONE if theresize request is successful. The + // underlying actions take + // additional time. You must separately verify the status of thecreating or + // deleting actions with thelistmanagedinstances + // 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. // https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroupManagers/resize rpc Resize(ResizeRequest) returns (google.cloud.cpp.compute.v1.Operation) { option (google.api.http) = { @@ -310,19 +340,24 @@ service RegionInstanceGroupManagers { option (google.cloud.operation_service) = "RegionOperations"; } - // Flags the specified instances in the managed instance group to be resumed. - // This method increases the targetSize and decreases the targetSuspendedSize + // Flags the specified instances in the managed instance group to be + // resumed. This method increases thetargetSize and decreases the + // targetSuspendedSize // of the managed instance group by the number of instances that you resume. - // The resumeInstances operation is marked DONE if the resumeInstances request - // is successful. The underlying actions take additional time. You must - // separately verify the status of the RESUMING action with the - // listmanagedinstances method. In this request, you can only specify - // instances that are suspended. For example, if an instance was previously - // suspended using the suspendInstances method, it can be resumed using the - // resumeInstances method. If a health check is attached to the managed - // instance group, the specified instances will be verified as healthy after - // they are resumed. You can specify a maximum of 1000 instances with this - // method per request. + // The resumeInstances operation is marked DONE if + // the resumeInstances request is successful. The underlying + // actions take additional time. You must separately verify the status of + // theRESUMING action with thelistmanagedinstances + // method. + // + // In this request, you can only specify instances that are suspended. For + // example, if an instance was previously suspended using the suspendInstances + // method, it can be resumed using the resumeInstances method. + // + // If a health check is attached to the managed instance group, the specified + // instances will be verified as healthy after they are resumed. + // + // You can specify a maximum of 1000 instances with this method per request. // https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroupManagers/resumeInstances rpc ResumeInstances(ResumeInstancesRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -363,19 +398,24 @@ service RegionInstanceGroupManagers { option (google.cloud.operation_service) = "RegionOperations"; } - // Flags the specified instances in the managed instance group to be started. - // This method increases the targetSize and decreases the targetStoppedSize of - // the managed instance group by the number of instances that you start. The - // startInstances operation is marked DONE if the startInstances request is - // successful. The underlying actions take additional time. You must - // separately verify the status of the STARTING action with the - // listmanagedinstances method. In this request, you can only specify - // instances that are stopped. For example, if an instance was previously - // stopped using the stopInstances method, it can be started using the - // startInstances method. If a health check is attached to the managed - // instance group, the specified instances will be verified as healthy after - // they are started. You can specify a maximum of 1000 instances with this - // method per request. + // Flags the specified instances in the managed instance group to be + // started. This method increases thetargetSize and decreases the + // targetStoppedSize + // of the managed instance group by the number of instances that you start. + // The startInstances operation is marked DONE if + // the startInstances request is successful. The underlying + // actions take additional time. You must separately verify the status of + // theSTARTING action with thelistmanagedinstances + // method. + // + // In this request, you can only specify instances that are stopped. For + // example, if an instance was previously stopped using the stopInstances + // method, it can be started using the startInstances method. + // + // If a health check is attached to the managed instance group, the specified + // instances will be verified as healthy after they are started. + // + // You can specify a maximum of 1000 instances with this method per request. // https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroupManagers/startInstances rpc StartInstances(StartInstancesRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -390,22 +430,33 @@ service RegionInstanceGroupManagers { // Flags the specified instances in the managed instance group to be // immediately stopped. You can only specify instances that are running in - // this request. This method reduces the targetSize and increases the - // targetStoppedSize of the managed instance group by the number of instances - // that you stop. The stopInstances operation is marked DONE if the - // stopInstances request is successful. The underlying actions take additional - // time. You must separately verify the status of the STOPPING action with the - // listmanagedinstances method. If the standbyPolicy.initialDelaySec field is - // set, the group delays stopping the instances until initialDelaySec have - // passed from instance.creationTimestamp (that is, when the instance was - // created). This delay gives your application time to set itself up and - // initialize on the instance. If more than initialDelaySec seconds have - // passed since instance.creationTimestamp when this method is called, there - // will be zero delay. 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 stopped. - // Stopped instances can be started using the startInstances method. You can - // specify a maximum of 1000 instances with this method per request. + // this request. This method reduces thetargetSize and increases the + // targetStoppedSize + // of the managed instance group by the number of instances that you stop. + // The stopInstances operation is marked DONE if + // the stopInstances request is successful. The underlying + // actions take additional time. You must separately verify the status of + // theSTOPPING action with thelistmanagedinstances + // method. + // + // If the standbyPolicy.initialDelaySec field is set, the group + // delays stopping the instances until initialDelaySec have + // passed from instance.creationTimestamp (that is, when the + // instance was created). This delay gives your application time to + // set itself up and initialize on the instance. If more thaninitialDelaySec + // seconds have passed sinceinstance.creationTimestamp when this method is + // called, there + // will be zero delay. + // + // 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 stopped. + // + // Stopped instances can be started using the startInstances + // method. + // + // You can specify a maximum of 1000 instances with this method per request. // https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroupManagers/stopInstances rpc StopInstances(StopInstancesRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -420,23 +471,33 @@ service RegionInstanceGroupManagers { // Flags the specified instances in the managed instance group to be // immediately suspended. You can only specify instances that are running in - // this request. This method reduces the targetSize and increases the - // targetSuspendedSize of the managed instance group by the number of - // instances that you suspend. The suspendInstances operation is marked DONE - // if the suspendInstances request is successful. The underlying actions take - // additional time. You must separately verify the status of the SUSPENDING - // action with the listmanagedinstances method. If the - // standbyPolicy.initialDelaySec field is set, the group delays suspension of - // the instances until initialDelaySec have passed from - // instance.creationTimestamp (that is, when the instance was created). This - // delay gives your application time to set itself up and initialize on the - // instance. If more than initialDelaySec seconds have passed since - // instance.creationTimestamp when this method is called, there will be zero - // delay. If the group is part of a backend service that has enabled + // this request. This method reduces thetargetSize and increases the + // targetSuspendedSize + // of the managed instance group by the number of instances that you suspend. + // The suspendInstances operation is marked DONE if + // the suspendInstances request is successful. The underlying + // actions take additional time. You must separately verify the status of + // theSUSPENDING action with thelistmanagedinstances + // method. + // + // If the standbyPolicy.initialDelaySec field is set, the group + // delays suspension of the instances until initialDelaySec have + // passed from instance.creationTimestamp (that is, when the + // instance was created). This delay gives your application time to + // set itself up and initialize on the instance. If more thaninitialDelaySec + // seconds have passed sinceinstance.creationTimestamp when this method is + // called, there + // will be zero delay. + // + // 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 suspended. - // Suspended instances can be resumed using the resumeInstances method. You - // can specify a maximum of 1000 instances with this method per request. + // + // Suspended instances can be resumed using the resumeInstances + // method. + // + // You can specify a maximum of 1000 instances with this method per request. // https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroupManagers/suspendInstances rpc SuspendInstances(SuspendInstancesRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -450,8 +511,8 @@ service RegionInstanceGroupManagers { } // 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. + // group. perInstanceConfig.name serves as a key used to + // distinguish whether to perform insert or patch. // https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroupManagers/updatePerInstanceConfigs rpc UpdatePerInstanceConfigs(UpdatePerInstanceConfigsRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -495,14 +556,17 @@ message AbandonInstancesRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 5 [json_name = "requestId"]; } @@ -537,7 +601,8 @@ message ApplyUpdatesToInstancesRequest { // Request message for CreateInstances. message CreateInstancesRequest { - // The name of the managed instance group. It should conform to RFC1035. + // The name of the managed instance group. + // It should conform to RFC1035. string instance_group_manager = 1 [ (google.api.field_behavior) = REQUIRED, json_name = "instanceGroupManager" @@ -550,8 +615,9 @@ message CreateInstancesRequest { json_name = "project" ]; - // The name of the region where the managed instance group is located. It - // should conform to RFC1035. + // The name of theregion + // where the managed instance group is located. + // It should conform to RFC1035. string region = 3 [ (google.api.field_behavior) = REQUIRED, (google.cloud.operation_request_field) = "region", @@ -566,13 +632,16 @@ message CreateInstancesRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same 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). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // 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). optional string request_id = 5 [json_name = "requestId"]; } @@ -584,6 +653,10 @@ message DeleteInstanceGroupManagerRequest { json_name = "instanceGroupManager" ]; + // When set, graceful shutdown is skipped for instance deletion even if it's + // configured for the instances. + optional bool no_graceful_shutdown = 5 [json_name = "noGracefulShutdown"]; + // Project ID for this request. string project = 2 [ (google.api.field_behavior) = REQUIRED, @@ -600,14 +673,17 @@ message DeleteInstanceGroupManagerRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; } @@ -619,6 +695,10 @@ message DeleteInstancesRequest { json_name = "instanceGroupManager" ]; + // When set, graceful shutdown is skipped for instance deletion even if it's + // configured for the instances. + optional bool no_graceful_shutdown = 6 [json_name = "noGracefulShutdown"]; + // Project ID for this request. string project = 2 [ (google.api.field_behavior) = REQUIRED, @@ -641,14 +721,17 @@ message DeleteInstancesRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 5 [json_name = "requestId"]; } @@ -720,131 +803,196 @@ message InsertInstanceGroupManagerRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; } // Request message for ListErrors. message ListErrorsRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // 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}. + // 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}. string instance_group_manager = 2 [ (google.api.field_behavior) = REQUIRED, json_name = "instanceGroupManager" ]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 3 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 4 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 5 [json_name = "pageToken"]; // Project ID for this request. string project = 6 [(google.api.field_behavior) = REQUIRED, json_name = "project"]; - // Name of the region scoping this request. This should conform to RFC1035. + // Name of the region scoping this request. + // This should conform to RFC1035. string region = 7 [(google.api.field_behavior) = REQUIRED, json_name = "region"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 8 [json_name = "returnPartialSuccess"]; } // Request message for ListManagedInstances. message ListManagedInstancesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; // The name of the managed instance group. @@ -853,25 +1001,29 @@ message ListManagedInstancesRequest { json_name = "instanceGroupManager" ]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 3 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 4 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 5 [json_name = "pageToken"]; // Project ID for this request. @@ -883,46 +1035,75 @@ message ListManagedInstancesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "region"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 8 [json_name = "returnPartialSuccess"]; } // Request message for ListPerInstanceConfigs. message ListPerInstanceConfigsRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; // The name of the managed instance group. It should conform to RFC1035. @@ -931,25 +1112,29 @@ message ListPerInstanceConfigsRequest { json_name = "instanceGroupManager" ]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 3 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 4 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 5 [json_name = "pageToken"]; // Project ID for this request. @@ -961,67 +1146,100 @@ message ListPerInstanceConfigsRequest { [(google.api.field_behavior) = REQUIRED, json_name = "region"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 8 [json_name = "returnPartialSuccess"]; } // Request message for ListRegionInstanceGroupManagers. message ListRegionInstanceGroupManagersRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -1033,9 +1251,11 @@ message ListRegionInstanceGroupManagersRequest { [(google.api.field_behavior) = REQUIRED, json_name = "region"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; } @@ -1067,20 +1287,24 @@ message PatchInstanceGroupManagerRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 5 [json_name = "requestId"]; } // Request message for PatchPerInstanceConfigs. message PatchPerInstanceConfigsRequest { - // The name of the managed instance group. It should conform to RFC1035. + // The name of the managed instance group. + // It should conform to RFC1035. string instance_group_manager = 1 [ (google.api.field_behavior) = REQUIRED, json_name = "instanceGroupManager" @@ -1108,14 +1332,17 @@ message PatchPerInstanceConfigsRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 5 [json_name = "requestId"]; } @@ -1127,6 +1354,10 @@ message RecreateInstancesRequest { json_name = "instanceGroupManager" ]; + // When set, graceful shutdown is skipped for instance recreation even if it's + // configured for the instances. + optional bool no_graceful_shutdown = 6 [json_name = "noGracefulShutdown"]; + // Project ID for this request. string project = 2 [ (google.api.field_behavior) = REQUIRED, @@ -1149,14 +1380,17 @@ message RecreateInstancesRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 5 [json_name = "requestId"]; } @@ -1184,17 +1418,21 @@ message ResizeRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; - // Number of instances that should exist in this instance group manager. + // Number of instances that should exist in this instance group + // manager. int32 size = 5 [(google.api.field_behavior) = REQUIRED, json_name = "size"]; } @@ -1228,14 +1466,17 @@ message ResumeInstancesRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 5 [json_name = "requestId"]; } @@ -1269,14 +1510,17 @@ message SetInstanceTemplateRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 5 [json_name = "requestId"]; } @@ -1310,14 +1554,17 @@ message SetTargetPoolsRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 5 [json_name = "requestId"]; } @@ -1351,14 +1598,17 @@ message StartInstancesRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 5 [json_name = "requestId"]; } @@ -1370,6 +1620,10 @@ message StopInstancesRequest { json_name = "instanceGroupManager" ]; + // When set, graceful shutdown is skipped for instance stopping even if it's + // configured for the instances. + optional bool no_graceful_shutdown = 6 [json_name = "noGracefulShutdown"]; + // Project ID for this request. string project = 2 [ (google.api.field_behavior) = REQUIRED, @@ -1392,14 +1646,17 @@ message StopInstancesRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 5 [json_name = "requestId"]; } @@ -1433,20 +1690,24 @@ message SuspendInstancesRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 5 [json_name = "requestId"]; } // Request message for UpdatePerInstanceConfigs. message UpdatePerInstanceConfigsRequest { - // The name of the managed instance group. It should conform to RFC1035. + // The name of the managed instance group. + // It should conform to RFC1035. string instance_group_manager = 1 [ (google.api.field_behavior) = REQUIRED, json_name = "instanceGroupManager" @@ -1474,13 +1735,16 @@ message UpdatePerInstanceConfigsRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 5 [json_name = "requestId"]; } 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 3ce68d4a42f18..33bd957d863a4 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: 20250601 +// revision: 20260807 syntax = "proto3"; @@ -24,9 +24,10 @@ 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_016.proto"; -import "google/cloud/compute/v1/internal/common_059.proto"; -import "google/cloud/compute/v1/internal/common_103.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_073.proto"; +import "google/cloud/compute/v1/internal/common_120.proto"; +import "google/cloud/compute/v1/internal/common_171.proto"; import "google/cloud/extended_operations.proto"; // Service for the regionInstanceGroups resource. @@ -48,8 +49,8 @@ service RegionInstanceGroups { option (google.api.method_signature) = "project,region,instance_group"; } - // Retrieves the list of instance group resources contained within the - // specified region. + // Retrieves the list of instance group resources contained within + // the specified region. // https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroups/list rpc ListRegionInstanceGroups(ListRegionInstanceGroupsRequest) returns (google.cloud.cpp.compute.v1.RegionInstanceGroupList) { @@ -61,8 +62,8 @@ service RegionInstanceGroups { // 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. + // method can list all instances or only the instances that are running. + // The orderBy query parameter is not supported. // https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroups/listInstances rpc ListInstances(ListInstancesRequest) returns (google.cloud.cpp.compute.v1.RegionInstanceGroupsListInstances) { @@ -86,6 +87,18 @@ service RegionInstanceGroups { "project,region,instance_group,region_instance_groups_set_named_ports_request_resource"; option (google.cloud.operation_service) = "RegionOperations"; } + + // Returns permissions that a caller has on the specified resource. + // https://cloud.google.com/compute/docs/reference/rest/v1/regionInstanceGroups/testIamPermissions + rpc TestIamPermissions(TestIamPermissionsRequest) + returns (google.cloud.cpp.compute.v1.TestPermissionsResponse) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/regions/{region}/instanceGroups/{resource}/testIamPermissions" + body: "test_permissions_request_resource" + }; + option (google.api.method_signature) = + "project,region,resource,test_permissions_request_resource"; + } } // Request message for GetInstanceGroup. @@ -106,37 +119,64 @@ message GetInstanceGroupRequest { // Request message for ListInstances. message ListInstancesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; // Name of the regional instance group for which we want to list the @@ -144,25 +184,29 @@ message ListInstancesRequest { string instance_group = 2 [(google.api.field_behavior) = REQUIRED, json_name = "instanceGroup"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 3 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 4 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 5 [json_name = "pageToken"]; // Project ID for this request. @@ -179,67 +223,100 @@ message ListInstancesRequest { [json_name = "__json_request_body"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 9 [json_name = "returnPartialSuccess"]; } // Request message for ListRegionInstanceGroups. message ListRegionInstanceGroupsRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -251,9 +328,11 @@ message ListRegionInstanceGroupsRequest { [(google.api.field_behavior) = REQUIRED, json_name = "region"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; } @@ -284,13 +363,35 @@ message SetNamedPortsRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 5 [json_name = "requestId"]; } + +// Request message for TestIamPermissions. +message TestIamPermissionsRequest { + // Project ID for this request. + string project = 1 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // The name of the region for this request. + string region = 2 + [(google.api.field_behavior) = REQUIRED, json_name = "region"]; + + // Name or id of the resource for this request. + string resource = 3 + [(google.api.field_behavior) = REQUIRED, json_name = "resource"]; + + // The TestPermissionsRequest for this request. + optional google.cloud.cpp.compute.v1.TestPermissionsRequest + test_permissions_request_resource = 4 [json_name = "__json_request_body"]; +} 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 40ea51258fbfd..bf6e19995c61d 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: 20250601 +// revision: 20260807 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_016.proto"; -import "google/cloud/compute/v1/internal/common_024.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_033.proto"; import "google/cloud/extended_operations.proto"; // Service for the regionInstanceTemplates resource. @@ -107,14 +107,17 @@ message DeleteInstanceTemplateRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; } @@ -155,72 +158,106 @@ message InsertInstanceTemplateRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; } // Request message for ListRegionInstanceTemplates. message ListRegionInstanceTemplatesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -232,8 +269,10 @@ message ListRegionInstanceTemplatesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "region"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; } 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 fd781957987e6..3ac1553655b0a 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: 20250601 +// revision: 20260807 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_018.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; import "google/cloud/extended_operations.proto"; // Service for the regionInstances resource. @@ -73,13 +73,16 @@ message BulkInsertRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; } diff --git a/protos/google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups.proto b/protos/google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups.proto new file mode 100644 index 0000000000000..16a49813206a4 --- /dev/null +++ b/protos/google/cloud/compute/region_instant_snapshot_groups/v1/region_instant_snapshot_groups.proto @@ -0,0 +1,384 @@ +// Copyright 2026 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: 20260807 + +syntax = "proto3"; + +package google.cloud.cpp.compute.region_instant_snapshot_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_009.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_083.proto"; +import "google/cloud/compute/v1/internal/common_126.proto"; +import "google/cloud/compute/v1/internal/common_171.proto"; +import "google/cloud/extended_operations.proto"; + +// Service for the regionInstantSnapshotGroups resource. +// https://cloud.google.com/compute/docs/reference/rest/v1/regionInstantSnapshotGroups +service RegionInstantSnapshotGroups { + option (google.api.default_host) = "compute.googleapis.com"; + option (google.api.oauth_scopes) = + "https://www.googleapis.com/auth/cloud-platform," + "https://www.googleapis.com/auth/compute," + "https://www.googleapis.com/auth/compute.readonly"; + + // deletes a Regional InstantSnapshotGroup resource + // https://cloud.google.com/compute/docs/reference/rest/v1/regionInstantSnapshotGroups/delete + rpc DeleteInstantSnapshotGroup(DeleteInstantSnapshotGroupRequest) + returns (google.cloud.cpp.compute.v1.Operation) { + option (google.api.http) = { + delete: "/compute/v1/projects/{project}/regions/{region}/instantSnapshotGroups/{instant_snapshot_group}" + }; + option (google.api.method_signature) = + "project,region,instant_snapshot_group"; + option (google.cloud.operation_service) = "RegionOperations"; + } + + // returns the specified InstantSnapshotGroup resource in the specified + // region. + // https://cloud.google.com/compute/docs/reference/rest/v1/regionInstantSnapshotGroups/get + rpc GetInstantSnapshotGroup(GetInstantSnapshotGroupRequest) + returns (google.cloud.cpp.compute.v1.InstantSnapshotGroup) { + option (google.api.http) = { + get: "/compute/v1/projects/{project}/regions/{region}/instantSnapshotGroups/{instant_snapshot_group}" + }; + option (google.api.method_signature) = + "project,region,instant_snapshot_group"; + } + + // Gets the access control policy for a resource. May be empty if no such + // policy or resource exists. + // https://cloud.google.com/compute/docs/reference/rest/v1/regionInstantSnapshotGroups/getIamPolicy + rpc GetIamPolicy(GetIamPolicyRequest) + returns (google.cloud.cpp.compute.v1.Policy) { + option (google.api.http) = { + get: "/compute/v1/projects/{project}/regions/{region}/instantSnapshotGroups/{resource}/getIamPolicy" + }; + option (google.api.method_signature) = "project,region,resource"; + } + + // creates a Regional InstantSnapshotGroup resource + // https://cloud.google.com/compute/docs/reference/rest/v1/regionInstantSnapshotGroups/insert + rpc InsertInstantSnapshotGroup(InsertInstantSnapshotGroupRequest) + returns (google.cloud.cpp.compute.v1.Operation) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/regions/{region}/instantSnapshotGroups" + body: "instant_snapshot_group_resource" + }; + option (google.api.method_signature) = + "project,region,instant_snapshot_group_resource"; + option (google.cloud.operation_service) = "RegionOperations"; + } + + // retrieves the list of InstantSnapshotGroup resources contained within + // the specified region. + // https://cloud.google.com/compute/docs/reference/rest/v1/regionInstantSnapshotGroups/list + rpc ListRegionInstantSnapshotGroups(ListRegionInstantSnapshotGroupsRequest) + returns (google.cloud.cpp.compute.v1.ListInstantSnapshotGroups) { + option (google.api.http) = { + get: "/compute/v1/projects/{project}/regions/{region}/instantSnapshotGroups" + }; + option (google.api.method_signature) = "project,region"; + } + + // Sets the access control policy on the specified resource. + // Replaces any existing policy. + // https://cloud.google.com/compute/docs/reference/rest/v1/regionInstantSnapshotGroups/setIamPolicy + rpc SetIamPolicy(SetIamPolicyRequest) + returns (google.cloud.cpp.compute.v1.Policy) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/regions/{region}/instantSnapshotGroups/{resource}/setIamPolicy" + body: "region_set_policy_request_resource" + }; + option (google.api.method_signature) = + "project,region,resource,region_set_policy_request_resource"; + } + + // Returns permissions that a caller has on the specified resource. + // https://cloud.google.com/compute/docs/reference/rest/v1/regionInstantSnapshotGroups/testIamPermissions + rpc TestIamPermissions(TestIamPermissionsRequest) + returns (google.cloud.cpp.compute.v1.TestPermissionsResponse) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/regions/{region}/instantSnapshotGroups/{resource}/testIamPermissions" + body: "test_permissions_request_resource" + }; + option (google.api.method_signature) = + "project,region,resource,test_permissions_request_resource"; + } +} + +// Request message for DeleteInstantSnapshotGroup. +message DeleteInstantSnapshotGroupRequest { + // Name of the InstantSnapshotGroup resource to delete. + string instant_snapshot_group = 1 [ + (google.api.field_behavior) = REQUIRED, + json_name = "instantSnapshotGroup" + ]; + + // Project ID for this request. + string project = 2 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "project", + json_name = "project" + ]; + + // The name of the region for this request. + string region = 3 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "region", + json_name = "region" + ]; + + // An optional request ID to identify requests. Specify a unique request ID so + // that if you must retry your request, the server will know to ignore the + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). + optional string request_id = 4 [json_name = "requestId"]; +} + +// Request message for GetIamPolicy. +message GetIamPolicyRequest { + // Requested IAM Policy version. + optional int32 options_requested_policy_version = 1 + [json_name = "optionsRequestedPolicyVersion"]; + + // Project ID for this request. + string project = 2 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // The name of the region for this request. + string region = 3 + [(google.api.field_behavior) = REQUIRED, json_name = "region"]; + + // Name or id of the resource for this request. + string resource = 4 + [(google.api.field_behavior) = REQUIRED, json_name = "resource"]; +} + +// Request message for GetInstantSnapshotGroup. +message GetInstantSnapshotGroupRequest { + // Name of the InstantSnapshotGroup resource to return. + string instant_snapshot_group = 1 [ + (google.api.field_behavior) = REQUIRED, + json_name = "instantSnapshotGroup" + ]; + + // Project ID for this request. + string project = 2 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // The name of the region for this request. + string region = 3 + [(google.api.field_behavior) = REQUIRED, json_name = "region"]; +} + +// Request message for InsertInstantSnapshotGroup. +message InsertInstantSnapshotGroupRequest { + // The InstantSnapshotGroup for this request. + optional google.cloud.cpp.compute.v1.InstantSnapshotGroup + instant_snapshot_group_resource = 1 [json_name = "__json_request_body"]; + + // Project ID for this request. + string project = 2 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "project", + json_name = "project" + ]; + + // Name of the region for this request. + string region = 3 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "region", + json_name = "region" + ]; + + // An optional request ID to identify requests. Specify a unique request ID so + // that if you must retry your request, the server will know to ignore the + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). + optional string request_id = 4 [json_name = "requestId"]; + + // begin_interface: MixerMutationRequestBuilder + optional string source_consistency_group = 5 + [json_name = "sourceConsistencyGroup"]; +} + +// Request message for ListRegionInstantSnapshotGroups. +message ListRegionInstantSnapshotGroupsRequest { + // A filter expression that filters resources listed in the response. Most + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. + optional string filter = 1 [json_name = "filter"]; + + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) + optional uint32 max_results = 2 [json_name = "maxResults"]; + + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or + // `creationTimestamp desc` is supported. + optional string order_by = 3 [json_name = "orderBy"]; + + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. + optional string page_token = 4 [json_name = "pageToken"]; + + // Project ID for this request. + string project = 5 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // The name of the region for this request. + string region = 6 + [(google.api.field_behavior) = REQUIRED, json_name = "region"]; + + // Opt-in for partial success behavior which provides partial results in case + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. + optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; +} + +// Request message for SetIamPolicy. +message SetIamPolicyRequest { + // Project ID for this request. + string project = 1 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // The name of the region for this request. + string region = 2 + [(google.api.field_behavior) = REQUIRED, json_name = "region"]; + + // The RegionSetPolicyRequest for this request. + optional google.cloud.cpp.compute.v1.RegionSetPolicyRequest + region_set_policy_request_resource = 3 + [json_name = "__json_request_body"]; + + // Name or id of the resource for this request. + string resource = 4 + [(google.api.field_behavior) = REQUIRED, json_name = "resource"]; +} + +// Request message for TestIamPermissions. +message TestIamPermissionsRequest { + // Project ID for this request. + string project = 1 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // The name of the region for this request. + string region = 2 + [(google.api.field_behavior) = REQUIRED, json_name = "region"]; + + // Name or id of the resource for this request. + string resource = 3 + [(google.api.field_behavior) = REQUIRED, json_name = "resource"]; + + // The TestPermissionsRequest for this request. + optional google.cloud.cpp.compute.v1.TestPermissionsRequest + test_permissions_request_resource = 4 [json_name = "__json_request_body"]; +} 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 bb508dd167c97..ecd0a16a033c2 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: 20250601 +// revision: 20260807 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_007.proto"; -import "google/cloud/compute/v1/internal/common_016.proto"; -import "google/cloud/compute/v1/internal/common_066.proto"; -import "google/cloud/compute/v1/internal/common_107.proto"; -import "google/cloud/compute/v1/internal/common_108.proto"; -import "google/cloud/compute/v1/internal/common_145.proto"; +import "google/cloud/compute/v1/internal/common_009.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_081.proto"; +import "google/cloud/compute/v1/internal/common_125.proto"; +import "google/cloud/compute/v1/internal/common_126.proto"; +import "google/cloud/compute/v1/internal/common_171.proto"; import "google/cloud/extended_operations.proto"; // Service for the regionInstantSnapshots resource. @@ -45,8 +45,10 @@ service RegionInstantSnapshots { // 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. + // to the next corresponding instantSnapshot. + // + // For more information, seeDeleting + // instantSnapshots. // https://cloud.google.com/compute/docs/reference/rest/v1/regionInstantSnapshots/delete rpc DeleteInstantSnapshot(DeleteInstantSnapshotRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -91,8 +93,8 @@ service RegionInstantSnapshots { option (google.cloud.operation_service) = "RegionOperations"; } - // Retrieves the list of InstantSnapshot resources contained within the - // specified region. + // Retrieves the list of InstantSnapshot resources contained within + // the specified region. // https://cloud.google.com/compute/docs/reference/rest/v1/regionInstantSnapshots/list rpc ListRegionInstantSnapshots(ListRegionInstantSnapshotsRequest) returns (google.cloud.cpp.compute.v1.InstantSnapshotList) { @@ -102,8 +104,8 @@ service RegionInstantSnapshots { option (google.api.method_signature) = "project,region"; } - // Sets the access control policy on the specified resource. Replaces any - // existing policy. + // Sets the access control policy on the specified resource. + // Replaces any existing policy. // https://cloud.google.com/compute/docs/reference/rest/v1/regionInstantSnapshots/setIamPolicy rpc SetIamPolicy(SetIamPolicyRequest) returns (google.cloud.cpp.compute.v1.Policy) { @@ -116,7 +118,8 @@ service RegionInstantSnapshots { } // Sets the labels on a instantSnapshot in the given region. To learn more - // about labels, read the Labeling Resources documentation. + // about labels, read the Labeling + // Resources documentation. // https://cloud.google.com/compute/docs/reference/rest/v1/regionInstantSnapshots/setLabels rpc SetLabels(SetLabelsRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -164,14 +167,17 @@ message DeleteInstantSnapshotRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; } @@ -231,72 +237,106 @@ message InsertInstantSnapshotRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; } // Request message for ListRegionInstantSnapshots. message ListRegionInstantSnapshotsRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -308,9 +348,11 @@ message ListRegionInstantSnapshotsRequest { [(google.api.field_behavior) = REQUIRED, json_name = "region"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; } @@ -357,14 +399,17 @@ message SetLabelsRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; // Name or id of the resource for this request. 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 dd1eedc492cf5..8ff92b80f19a2 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: 20250601 +// revision: 20260807 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_012.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_015.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_123.proto"; import "google/cloud/extended_operations.proto"; // Service for the regionNetworkEndpointGroups resource. @@ -90,6 +90,20 @@ service RegionNetworkEndpointGroups { // Creates a network endpoint group in the specified project using the // parameters that are included in the request. + // + // Note: Use the following APIs to manage network endpoint groups: + // + // - + // To manage NEGs with zonal scope (such as zonal NEGs, hybrid connectivity + // NEGs): zonal + // API + // - + // To manage NEGs with regional scope (such as regional internet NEGs, + // serverless NEGs, Private Service Connect NEGs): regional + // API + // - + // To manage NEGs with global scope (such as global internet NEGs):global + // API // https://cloud.google.com/compute/docs/reference/rest/v1/regionNetworkEndpointGroups/insert rpc InsertNetworkEndpointGroup(InsertNetworkEndpointGroupRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -142,8 +156,9 @@ message AttachNetworkEndpointsRequest { json_name = "project" ]; - // The name of the region where you want to create the network endpoint group. - // It should comply with RFC1035. + // The name of the region where + // you want to create the network endpoint group. It should comply with + // RFC1035. string region = 3 [ (google.api.field_behavior) = REQUIRED, (google.cloud.operation_request_field) = "region", @@ -158,14 +173,17 @@ message AttachNetworkEndpointsRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 5 [json_name = "requestId"]; } @@ -185,8 +203,8 @@ message DeleteNetworkEndpointGroupRequest { json_name = "project" ]; - // The name of the region where the network endpoint group is located. It - // should comply with RFC1035. + // The name of the region where + // the network endpoint group is located. It should comply with RFC1035. string region = 3 [ (google.api.field_behavior) = REQUIRED, (google.cloud.operation_request_field) = "region", @@ -195,21 +213,24 @@ message DeleteNetworkEndpointGroupRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; } // Request message for DetachNetworkEndpoints. message DetachNetworkEndpointsRequest { - // The name of the network endpoint group you are detaching network endpoints - // from. It should comply with RFC1035. + // The name of the network endpoint group you are detaching network + // endpoints from. It should comply with RFC1035. string network_endpoint_group = 1 [ (google.api.field_behavior) = REQUIRED, json_name = "networkEndpointGroup" @@ -222,8 +243,9 @@ message DetachNetworkEndpointsRequest { json_name = "project" ]; - // The name of the region where the network endpoint group is located. It - // should comply with RFC1035. + // The name of the region where + // the network endpoint group is located. It should comply with + // RFC1035. string region = 3 [ (google.api.field_behavior) = REQUIRED, (google.cloud.operation_request_field) = "region", @@ -238,15 +260,18 @@ message DetachNetworkEndpointsRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // 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 + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating 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 optional string request_id = 5 [json_name = "requestId"]; } @@ -262,8 +287,8 @@ message GetNetworkEndpointGroupRequest { string project = 2 [(google.api.field_behavior) = REQUIRED, json_name = "project"]; - // The name of the region where the network endpoint group is located. It - // should comply with RFC1035. + // The name of the region where + // the network endpoint group is located. It should comply with RFC1035. string region = 3 [(google.api.field_behavior) = REQUIRED, json_name = "region"]; } @@ -281,8 +306,9 @@ message InsertNetworkEndpointGroupRequest { json_name = "project" ]; - // The name of the region where you want to create the network endpoint group. - // It should comply with RFC1035. + // The name of the region where + // you want to create the network endpoint group. It should comply with + // RFC1035. string region = 3 [ (google.api.field_behavior) = REQUIRED, (google.cloud.operation_request_field) = "region", @@ -291,58 +317,88 @@ message InsertNetworkEndpointGroupRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; } // Request message for ListNetworkEndpoints. message ListNetworkEndpointsRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; // The name of the network endpoint group from which you want to generate a @@ -352,105 +408,144 @@ message ListNetworkEndpointsRequest { json_name = "networkEndpointGroup" ]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 4 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 5 [json_name = "pageToken"]; // Project ID for this request. string project = 6 [(google.api.field_behavior) = REQUIRED, json_name = "project"]; - // The name of the region where the network endpoint group is located. It - // should comply with RFC1035. + // The name of theregion + // where the network endpoint group is located. It should comply with RFC1035. string region = 7 [(google.api.field_behavior) = REQUIRED, json_name = "region"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 8 [json_name = "returnPartialSuccess"]; } // Request message for ListRegionNetworkEndpointGroups. message ListRegionNetworkEndpointGroupsRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. string project = 5 [(google.api.field_behavior) = REQUIRED, json_name = "project"]; - // The name of the region where the network endpoint group is located. It - // should comply with RFC1035. + // The name of theregion + // where the network endpoint group is located. It should comply with RFC1035. string region = 6 [(google.api.field_behavior) = REQUIRED, json_name = "region"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; } 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 c131e132b9df6..1d7a3261ec143 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: 20250601 +// revision: 20260807 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_007.proto"; -import "google/cloud/compute/v1/internal/common_016.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_106.proto"; -import "google/cloud/compute/v1/internal/common_108.proto"; -import "google/cloud/compute/v1/internal/common_145.proto"; +import "google/cloud/compute/v1/internal/common_009.proto"; +import "google/cloud/compute/v1/internal/common_019.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_124.proto"; +import "google/cloud/compute/v1/internal/common_126.proto"; +import "google/cloud/compute/v1/internal/common_171.proto"; import "google/cloud/extended_operations.proto"; // Service for the regionNetworkFirewallPolicies resource. @@ -155,8 +155,8 @@ service RegionNetworkFirewallPolicies { option (google.cloud.operation_service) = "RegionOperations"; } - // Lists all the network firewall policies that have been configured for the - // specified project in the given region. + // Lists all the network firewall policies that have been configured + // for the specified project in the given region. // https://cloud.google.com/compute/docs/reference/rest/v1/regionNetworkFirewallPolicies/list rpc ListRegionNetworkFirewallPolicies( ListRegionNetworkFirewallPoliciesRequest) @@ -217,8 +217,8 @@ service RegionNetworkFirewallPolicies { option (google.cloud.operation_service) = "RegionOperations"; } - // Sets the access control policy on the specified resource. Replaces any - // existing policy. + // Sets the access control policy on the specified resource. + // Replaces any existing policy. // https://cloud.google.com/compute/docs/reference/rest/v1/regionNetworkFirewallPolicies/setIamPolicy rpc SetIamPolicy(SetIamPolicyRequest) returns (google.cloud.cpp.compute.v1.Policy) { @@ -276,14 +276,17 @@ message AddAssociationRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 6 [json_name = "requestId"]; } @@ -297,12 +300,14 @@ message AddRuleRequest { optional google.cloud.cpp.compute.v1.FirewallPolicyRule firewall_policy_rule_resource = 2 [json_name = "__json_request_body"]; - // When rule.priority is not specified, auto choose a unused priority between - // minPriority and maxPriority>. This field is exclusive with rule.priority. + // When rule.priority is not specified, auto choose a unused priority + // betweenminPriority and maxPriority>. + // This field is exclusive with rule.priority. optional int32 max_priority = 3 [json_name = "maxPriority"]; - // When rule.priority is not specified, auto choose a unused priority between - // minPriority and maxPriority>. This field is exclusive with rule.priority. + // When rule.priority is not specified, auto choose a unused priority + // betweenminPriority and maxPriority>. + // This field is exclusive with rule.priority. optional int32 min_priority = 4 [json_name = "minPriority"]; // Project ID for this request. @@ -321,14 +326,17 @@ message AddRuleRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 7 [json_name = "requestId"]; } @@ -354,14 +362,17 @@ message CloneRulesRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; // The firewall policy from which to copy rules. @@ -391,14 +402,17 @@ message DeleteFirewallPolicyRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; } @@ -507,74 +521,108 @@ message InsertFirewallPolicyRequest { json_name = "region" ]; - // An optional request ID to identify requests. Specify a unique request ID so - // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // An optional request ID to identify requests. Specify a unique request ID + // so that if you must retry your request, the server will know to ignore the + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; } // Request message for ListRegionNetworkFirewallPolicies. message ListRegionNetworkFirewallPoliciesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -586,9 +634,11 @@ message ListRegionNetworkFirewallPoliciesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "region"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; } @@ -618,14 +668,17 @@ message PatchFirewallPolicyRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 5 [json_name = "requestId"]; } @@ -658,14 +711,17 @@ message PatchRuleRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 6 [json_name = "requestId"]; } @@ -694,14 +750,17 @@ message RemoveAssociationRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 5 [json_name = "requestId"]; } @@ -730,14 +789,17 @@ message RemoveRuleRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 5 [json_name = "requestId"]; } 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 1ab1e6759bd02..185bafffe27dc 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: 20250601 +// revision: 20260807 syntax = "proto3"; @@ -24,8 +24,9 @@ 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_016.proto"; -import "google/cloud/compute/v1/internal/common_090.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_105.proto"; +import "google/cloud/compute/v1/internal/common_171.proto"; import "google/cloud/extended_operations.proto"; // Service for the regionNotificationEndpoints resource. @@ -37,6 +38,18 @@ service RegionNotificationEndpoints { "https://www.googleapis.com/auth/compute," "https://www.googleapis.com/auth/compute.readonly"; + // Retrieves the list of all NotificationEndpoint resources, + // regional and global, available to the specified project. + // https://cloud.google.com/compute/docs/reference/rest/v1/regionNotificationEndpoints/aggregatedList + rpc AggregatedListRegionNotificationEndpoints( + AggregatedListRegionNotificationEndpointsRequest) + returns (google.cloud.cpp.compute.v1.NotificationEndpointAggregatedList) { + option (google.api.http) = { + get: "/compute/v1/projects/{project}/aggregated/notificationEndpoints" + }; + option (google.api.method_signature) = "project"; + } + // Deletes the specified NotificationEndpoint in the given region // https://cloud.google.com/compute/docs/reference/rest/v1/regionNotificationEndpoints/delete rpc DeleteNotificationEndpoint(DeleteNotificationEndpointRequest) @@ -83,6 +96,133 @@ service RegionNotificationEndpoints { }; option (google.api.method_signature) = "project,region"; } + + // Returns permissions that a caller has on the specified resource. + // https://cloud.google.com/compute/docs/reference/rest/v1/regionNotificationEndpoints/testIamPermissions + rpc TestIamPermissions(TestIamPermissionsRequest) + returns (google.cloud.cpp.compute.v1.TestPermissionsResponse) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/regions/{region}/notificationEndpoints/{resource}/testIamPermissions" + body: "test_permissions_request_resource" + }; + option (google.api.method_signature) = + "project,region,resource,test_permissions_request_resource"; + } +} + +// Request message for AggregatedListRegionNotificationEndpoints. +message AggregatedListRegionNotificationEndpointsRequest { + // A filter expression that filters resources listed in the response. Most + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. + optional string filter = 1 [json_name = "filter"]; + + // 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. + optional bool include_all_scopes = 2 [json_name = "includeAllScopes"]; + + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) + optional uint32 max_results = 3 [json_name = "maxResults"]; + + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or + // `creationTimestamp desc` is supported. + optional string order_by = 4 [json_name = "orderBy"]; + + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. + optional string page_token = 5 [json_name = "pageToken"]; + + // Name of the project scoping this request. + string project = 6 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // Opt-in for partial success behavior which provides partial results in case + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. + optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; + + // The Shared VPC service project id or service project number for which + // aggregated list request is invoked for subnetworks list-usable api. + optional string service_project_number = 8 + [json_name = "serviceProjectNumber"]; } // Request message for DeleteNotificationEndpoint. @@ -109,14 +249,17 @@ message DeleteNotificationEndpointRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; } @@ -159,72 +302,106 @@ message InsertNotificationEndpointRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; } // Request message for ListRegionNotificationEndpoints. message ListRegionNotificationEndpointsRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -236,8 +413,29 @@ message ListRegionNotificationEndpointsRequest { [(google.api.field_behavior) = REQUIRED, json_name = "region"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; } + +// Request message for TestIamPermissions. +message TestIamPermissionsRequest { + // Project ID for this request. + string project = 1 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // The name of the region for this request. + string region = 2 + [(google.api.field_behavior) = REQUIRED, json_name = "region"]; + + // Name or id of the resource for this request. + string resource = 3 + [(google.api.field_behavior) = REQUIRED, json_name = "resource"]; + + // The TestPermissionsRequest for this request. + optional google.cloud.cpp.compute.v1.TestPermissionsRequest + test_permissions_request_resource = 4 [json_name = "__json_request_body"]; +} 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 adeb6dda2258c..739a3525b2686 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: 20250601 +// revision: 20260807 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_016.proto"; -import "google/cloud/compute/v1/internal/common_092.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_107.proto"; import "google/cloud/extended_operations.proto"; import "google/protobuf/empty.proto"; @@ -57,8 +57,8 @@ service RegionOperations { option (google.api.method_signature) = "project,region,operation"; } - // Retrieves a list of Operation resources contained within the specified - // region. + // Retrieves a list of Operation resources contained within + // the specified region. // https://cloud.google.com/compute/docs/reference/rest/v1/regionOperations/list rpc ListRegionOperations(ListRegionOperationsRequest) returns (google.cloud.cpp.compute.v1.OperationList) { @@ -68,17 +68,24 @@ service RegionOperations { option (google.api.method_signature) = "project,region"; } - // 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`. + // 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`. // https://cloud.google.com/compute/docs/reference/rest/v1/regionOperations/wait rpc Wait(WaitRequest) returns (google.cloud.cpp.compute.v1.Operation) { option (google.api.http) = { @@ -130,58 +137,89 @@ message GetOperationRequest { // Request message for ListRegionOperations. message ListRegionOperationsRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -193,9 +231,11 @@ message ListRegionOperationsRequest { [(google.api.field_behavior) = REQUIRED, json_name = "region"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; } 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 765bd53e71620..44451f417c7ff 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: 20250601 +// revision: 20260807 syntax = "proto3"; @@ -24,9 +24,9 @@ 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_016.proto"; -import "google/cloud/compute/v1/internal/common_107.proto"; -import "google/cloud/compute/v1/internal/common_117.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_125.proto"; +import "google/cloud/compute/v1/internal/common_141.proto"; import "google/cloud/extended_operations.proto"; // Service for the regionSecurityPolicies resource. @@ -149,8 +149,9 @@ service RegionSecurityPolicies { option (google.cloud.operation_service) = "RegionOperations"; } - // Sets the labels on a security policy. To learn more about labels, read the - // Labeling Resources documentation. + // Sets the labels on a security policy. To learn more about labels, + // read the Labeling Resources + // documentation. // https://cloud.google.com/compute/docs/reference/rest/v1/regionSecurityPolicies/setLabels rpc SetLabels(SetLabelsRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -210,14 +211,17 @@ message DeleteSecurityPolicyRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // Name of the security policy to delete. @@ -276,14 +280,17 @@ message InsertSecurityPolicyRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // The SecurityPolicy for this request. @@ -297,58 +304,89 @@ message InsertSecurityPolicyRequest { // Request message for ListRegionSecurityPolicies. message ListRegionSecurityPoliciesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -360,9 +398,11 @@ message ListRegionSecurityPoliciesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "region"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; } @@ -418,14 +458,17 @@ message PatchSecurityPolicyRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // Name of the security policy to update. @@ -487,14 +530,17 @@ message SetLabelsRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; // Name or id of the resource for this request. diff --git a/protos/google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings.proto b/protos/google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings.proto new file mode 100644 index 0000000000000..d339486413225 --- /dev/null +++ b/protos/google/cloud/compute/region_snapshot_settings/v1/region_snapshot_settings.proto @@ -0,0 +1,112 @@ +// Copyright 2026 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: 20260807 + +syntax = "proto3"; + +package google.cloud.cpp.compute.region_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_019.proto"; +import "google/cloud/compute/v1/internal/common_148.proto"; +import "google/cloud/extended_operations.proto"; + +// Service for the regionSnapshotSettings resource. +// https://cloud.google.com/compute/docs/reference/rest/v1/regionSnapshotSettings +service RegionSnapshotSettings { + option (google.api.default_host) = "compute.googleapis.com"; + option (google.api.oauth_scopes) = + "https://www.googleapis.com/auth/cloud-platform," + "https://www.googleapis.com/auth/compute," + "https://www.googleapis.com/auth/compute.readonly"; + + // Get region snapshot settings. + // https://cloud.google.com/compute/docs/reference/rest/v1/regionSnapshotSettings/get + rpc GetSnapshotSettings(GetSnapshotSettingsRequest) + returns (google.cloud.cpp.compute.v1.SnapshotSettings) { + option (google.api.http) = { + get: "/compute/v1/projects/{project}/regions/{region}/snapshotSettings" + }; + option (google.api.method_signature) = "project,region"; + } + + // Patch region snapshot settings. + // https://cloud.google.com/compute/docs/reference/rest/v1/regionSnapshotSettings/patch + rpc PatchSnapshotSettings(PatchSnapshotSettingsRequest) + returns (google.cloud.cpp.compute.v1.Operation) { + option (google.api.http) = { + patch: "/compute/v1/projects/{project}/regions/{region}/snapshotSettings" + body: "snapshot_settings_resource" + }; + option (google.api.method_signature) = + "project,region,update_mask,snapshot_settings_resource"; + option (google.cloud.operation_service) = "RegionOperations"; + } +} + +// Request message for GetSnapshotSettings. +message GetSnapshotSettingsRequest { + // Project ID for this request. + string project = 1 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // Name of the region for this request. + string region = 2 + [(google.api.field_behavior) = REQUIRED, json_name = "region"]; +} + +// Request message for PatchSnapshotSettings. +message PatchSnapshotSettingsRequest { + // Project ID for this request. + string project = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "project", + json_name = "project" + ]; + + // Name of the region for this request. + string region = 2 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "region", + json_name = "region" + ]; + + // An optional request ID to identify requests. Specify a unique request ID so + // that if you must retry your request, the server will know to ignore the + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). + optional string request_id = 3 [json_name = "requestId"]; + + // The SnapshotSettings for this request. + optional google.cloud.cpp.compute.v1.SnapshotSettings + snapshot_settings_resource = 4 [json_name = "__json_request_body"]; + + // update_mask indicates fields to be updated as part of this request. + optional string update_mask = 5 [json_name = "updateMask"]; +} diff --git a/protos/google/cloud/compute/region_snapshots/v1/region_snapshots.proto b/protos/google/cloud/compute/region_snapshots/v1/region_snapshots.proto new file mode 100644 index 0000000000000..2c90fba3b30a7 --- /dev/null +++ b/protos/google/cloud/compute/region_snapshots/v1/region_snapshots.proto @@ -0,0 +1,494 @@ +// Copyright 2026 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: 20260807 + +syntax = "proto3"; + +package google.cloud.cpp.compute.region_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_009.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_125.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_146.proto"; +import "google/cloud/compute/v1/internal/common_147.proto"; +import "google/cloud/compute/v1/internal/common_171.proto"; +import "google/cloud/extended_operations.proto"; + +// Service for the regionSnapshots resource. +// https://cloud.google.com/compute/docs/reference/rest/v1/regionSnapshots +service RegionSnapshots { + option (google.api.default_host) = "compute.googleapis.com"; + option (google.api.oauth_scopes) = + "https://www.googleapis.com/auth/cloud-platform," + "https://www.googleapis.com/auth/compute," + "https://www.googleapis.com/auth/compute.readonly"; + + // 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, seeDeleting + // snapshots. + // https://cloud.google.com/compute/docs/reference/rest/v1/regionSnapshots/delete + rpc DeleteSnapshot(DeleteSnapshotRequest) + returns (google.cloud.cpp.compute.v1.Operation) { + option (google.api.http) = { + delete: "/compute/v1/projects/{project}/regions/{region}/snapshots/{snapshot}" + }; + option (google.api.method_signature) = "project,region,snapshot"; + option (google.cloud.operation_service) = "RegionOperations"; + } + + // Returns the specified Snapshot resource. + // https://cloud.google.com/compute/docs/reference/rest/v1/regionSnapshots/get + rpc GetSnapshot(GetSnapshotRequest) + returns (google.cloud.cpp.compute.v1.Snapshot) { + option (google.api.http) = { + get: "/compute/v1/projects/{project}/regions/{region}/snapshots/{snapshot}" + }; + option (google.api.method_signature) = "project,region,snapshot"; + } + + // Gets the access control policy for a resource. May be empty if no such + // policy or resource exists. + // https://cloud.google.com/compute/docs/reference/rest/v1/regionSnapshots/getIamPolicy + rpc GetIamPolicy(GetIamPolicyRequest) + returns (google.cloud.cpp.compute.v1.Policy) { + option (google.api.http) = { + get: "/compute/v1/projects/{project}/regions/{region}/snapshots/{resource}/getIamPolicy" + }; + option (google.api.method_signature) = "project,region,resource"; + } + + // Creates a snapshot in the specified region using the data included + // in the request. + // https://cloud.google.com/compute/docs/reference/rest/v1/regionSnapshots/insert + rpc InsertSnapshot(InsertSnapshotRequest) + returns (google.cloud.cpp.compute.v1.Operation) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/regions/{region}/snapshots" + body: "snapshot_resource" + }; + option (google.api.method_signature) = "project,region,snapshot_resource"; + option (google.cloud.operation_service) = "RegionOperations"; + } + + // Retrieves the list of Snapshot resources contained within + // the specified region. + // https://cloud.google.com/compute/docs/reference/rest/v1/regionSnapshots/list + rpc ListRegionSnapshots(ListRegionSnapshotsRequest) + returns (google.cloud.cpp.compute.v1.SnapshotList) { + option (google.api.http) = { + get: "/compute/v1/projects/{project}/regions/{region}/snapshots" + }; + option (google.api.method_signature) = "project,region"; + } + + // Sets the access control policy on the specified resource. + // Replaces any existing policy. + // https://cloud.google.com/compute/docs/reference/rest/v1/regionSnapshots/setIamPolicy + rpc SetIamPolicy(SetIamPolicyRequest) + returns (google.cloud.cpp.compute.v1.Policy) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/regions/{region}/snapshots/{resource}/setIamPolicy" + body: "region_set_policy_request_resource" + }; + option (google.api.method_signature) = + "project,region,resource,region_set_policy_request_resource"; + } + + // Sets the labels on a regional snapshot. To learn more about labels, read + // the Labeling Resources + // documentation. + // https://cloud.google.com/compute/docs/reference/rest/v1/regionSnapshots/setLabels + rpc SetLabels(SetLabelsRequest) + returns (google.cloud.cpp.compute.v1.Operation) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/regions/{region}/snapshots/{resource}/setLabels" + body: "region_set_labels_request_resource" + }; + option (google.api.method_signature) = + "project,region,resource,region_set_labels_request_resource"; + option (google.cloud.operation_service) = "RegionOperations"; + } + + // Returns permissions that a caller has on the specified resource. + // https://cloud.google.com/compute/docs/reference/rest/v1/regionSnapshots/testIamPermissions + rpc TestIamPermissions(TestIamPermissionsRequest) + returns (google.cloud.cpp.compute.v1.TestPermissionsResponse) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/regions/{region}/snapshots/{resource}/testIamPermissions" + body: "test_permissions_request_resource" + }; + option (google.api.method_signature) = + "project,region,resource,test_permissions_request_resource"; + } + + // Rotates the customer-managed + // encryption key to the latest version for the specified snapshot. + // https://cloud.google.com/compute/docs/reference/rest/v1/regionSnapshots/updateKmsKey + rpc UpdateKmsKey(UpdateKmsKeyRequest) + returns (google.cloud.cpp.compute.v1.Operation) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/regions/{region}/snapshots/{snapshot}/updateKmsKey" + body: "region_snapshot_update_kms_key_request_resource" + }; + option (google.api.method_signature) = + "project,region,snapshot,region_snapshot_update_kms_key_request_resource"; + option (google.cloud.operation_service) = "RegionOperations"; + } +} + +// Request message for DeleteSnapshot. +message DeleteSnapshotRequest { + // Project ID for this request. + string project = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "project", + json_name = "project" + ]; + + // The name of the region for this request. + string region = 2 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "region", + json_name = "region" + ]; + + // An optional request ID to identify requests. Specify a unique request ID so + // that if you must retry your request, the server will know to ignore the + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). + optional string request_id = 3 [json_name = "requestId"]; + + // Name of the snapshot resource to delete. + string snapshot = 4 + [(google.api.field_behavior) = REQUIRED, json_name = "snapshot"]; +} + +// Request message for GetIamPolicy. +message GetIamPolicyRequest { + // Requested IAM Policy version. + optional int32 options_requested_policy_version = 1 + [json_name = "optionsRequestedPolicyVersion"]; + + // Project ID for this request. + string project = 2 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // The name of the region for this request. + string region = 3 + [(google.api.field_behavior) = REQUIRED, json_name = "region"]; + + // Name or id of the resource for this request. + string resource = 4 + [(google.api.field_behavior) = REQUIRED, json_name = "resource"]; +} + +// Request message for GetSnapshot. +message GetSnapshotRequest { + // Project ID for this request. + string project = 1 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // Name of the region for this request. + string region = 2 + [(google.api.field_behavior) = REQUIRED, json_name = "region"]; + + // Name of the Snapshot resource to return. + string snapshot = 3 + [(google.api.field_behavior) = REQUIRED, json_name = "snapshot"]; +} + +// Request message for InsertSnapshot. +message InsertSnapshotRequest { + // Project ID for this request. + string project = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "project", + json_name = "project" + ]; + + // Name of the region for this request. + string region = 2 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "region", + json_name = "region" + ]; + + // An optional request ID to identify requests. Specify a unique request ID so + // that if you must retry your request, the server will know to ignore the + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). + optional string request_id = 3 [json_name = "requestId"]; + + // The Snapshot for this request. + optional google.cloud.cpp.compute.v1.Snapshot snapshot_resource = 4 + [json_name = "__json_request_body"]; +} + +// Request message for ListRegionSnapshots. +message ListRegionSnapshotsRequest { + // A filter expression that filters resources listed in the response. Most + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. + optional string filter = 1 [json_name = "filter"]; + + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) + optional uint32 max_results = 2 [json_name = "maxResults"]; + + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or + // `creationTimestamp desc` is supported. + optional string order_by = 3 [json_name = "orderBy"]; + + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. + optional string page_token = 4 [json_name = "pageToken"]; + + // Project ID for this request. + string project = 5 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // Name of the region for this request. + string region = 6 + [(google.api.field_behavior) = REQUIRED, json_name = "region"]; + + // Opt-in for partial success behavior which provides partial results in case + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. + optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; +} + +// Request message for SetIamPolicy. +message SetIamPolicyRequest { + // Project ID for this request. + string project = 1 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // The name of the region for this request. + string region = 2 + [(google.api.field_behavior) = REQUIRED, json_name = "region"]; + + // The RegionSetPolicyRequest for this request. + optional google.cloud.cpp.compute.v1.RegionSetPolicyRequest + region_set_policy_request_resource = 3 + [json_name = "__json_request_body"]; + + // Name or id of the resource for this request. + string resource = 4 + [(google.api.field_behavior) = REQUIRED, json_name = "resource"]; +} + +// Request message for SetLabels. +message SetLabelsRequest { + // Project ID for this request. + string project = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "project", + json_name = "project" + ]; + + // The region for this request. + string region = 2 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "region", + json_name = "region" + ]; + + // The RegionSetLabelsRequest for this request. + optional google.cloud.cpp.compute.v1.RegionSetLabelsRequest + region_set_labels_request_resource = 3 + [json_name = "__json_request_body"]; + + // An optional request ID to identify requests. Specify a unique request ID so + // that if you must retry your request, the server will know to ignore the + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). + optional string request_id = 4 [json_name = "requestId"]; + + // Name or id of the resource for this request. + string resource = 5 + [(google.api.field_behavior) = REQUIRED, json_name = "resource"]; +} + +// Request message for TestIamPermissions. +message TestIamPermissionsRequest { + // Project ID for this request. + string project = 1 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // The name of the region for this request. + string region = 2 + [(google.api.field_behavior) = REQUIRED, json_name = "region"]; + + // Name or id of the resource for this request. + string resource = 3 + [(google.api.field_behavior) = REQUIRED, json_name = "resource"]; + + // The TestPermissionsRequest for this request. + optional google.cloud.cpp.compute.v1.TestPermissionsRequest + test_permissions_request_resource = 4 [json_name = "__json_request_body"]; +} + +// Request message for UpdateKmsKey. +message UpdateKmsKeyRequest { + // Project ID for this request. + string project = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "project", + json_name = "project" + ]; + + // Name of the region for this request. + string region = 2 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "region", + json_name = "region" + ]; + + // The RegionSnapshotUpdateKmsKeyRequest for this request. + optional google.cloud.cpp.compute.v1.RegionSnapshotUpdateKmsKeyRequest + region_snapshot_update_kms_key_request_resource = 3 + [json_name = "__json_request_body"]; + + // An optional request ID to identify requests. Specify a unique request ID so + // that if you must retry your request, the server will know to ignore the + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). + optional string request_id = 4 [json_name = "requestId"]; + + // Name of the snapshot resource to update. Should conform to RFC1035. + string snapshot = 5 + [(google.api.field_behavior) = REQUIRED, json_name = "snapshot"]; +} 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 41699914944ed..60eb1a2bb89d2 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: 20250601 +// revision: 20260807 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_016.proto"; -import "google/cloud/compute/v1/internal/common_125.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_150.proto"; import "google/cloud/extended_operations.proto"; // Service for the regionSslCertificates resource. @@ -49,7 +49,8 @@ service RegionSslCertificates { } // Returns the specified SslCertificate resource in the specified region. Get - // a list of available SSL certificates by making a list() request. + // a list of available SSL certificates by making a list() + // request. // https://cloud.google.com/compute/docs/reference/rest/v1/regionSslCertificates/get rpc GetSslCertificate(GetSslCertificateRequest) returns (google.cloud.cpp.compute.v1.SslCertificate) { @@ -103,14 +104,17 @@ message DeleteSslCertificateRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // Name of the SslCertificate resource to delete. @@ -151,14 +155,17 @@ message InsertSslCertificateRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // The SslCertificate for this request. @@ -169,58 +176,89 @@ message InsertSslCertificateRequest { // Request message for ListRegionSslCertificates. message ListRegionSslCertificatesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -232,8 +270,10 @@ message ListRegionSslCertificatesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "region"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; } 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 028cf751e65ab..819d351c7ba5a 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: 20250601 +// revision: 20260807 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_016.proto"; -import "google/cloud/compute/v1/internal/common_128.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_153.proto"; import "google/cloud/extended_operations.proto"; // Service for the regionSslPolicies resource. @@ -127,14 +127,17 @@ message DeleteSslPolicyRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // Name of the SSL policy to delete. The name must be 1-63 characters long, @@ -177,14 +180,17 @@ message InsertSslPolicyRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // The SslPolicy for this request. @@ -195,58 +201,89 @@ message InsertSslPolicyRequest { // Request message for ListAvailableFeatures. message ListAvailableFeaturesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -258,67 +295,100 @@ message ListAvailableFeaturesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "region"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; } // Request message for ListRegionSslPolicies. message ListRegionSslPoliciesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -330,9 +400,11 @@ message ListRegionSslPoliciesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "region"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; } @@ -354,14 +426,17 @@ message PatchSslPolicyRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // Name of the SSL policy to update. The name must be 1-63 characters long, 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 8b7943e034e08..850b8944d8e2f 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: 20250601 +// revision: 20260807 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_016.proto"; -import "google/cloud/compute/v1/internal/common_135.proto"; -import "google/cloud/compute/v1/internal/common_147.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_161.proto"; +import "google/cloud/compute/v1/internal/common_174.proto"; import "google/cloud/extended_operations.proto"; // Service for the regionTargetHttpProxies resource. @@ -73,8 +73,8 @@ service RegionTargetHttpProxies { option (google.cloud.operation_service) = "RegionOperations"; } - // Retrieves the list of TargetHttpProxy resources available to the specified - // project in the specified region. + // Retrieves the list of TargetHttpProxy resources available + // to the specified project in the specified region. // https://cloud.google.com/compute/docs/reference/rest/v1/regionTargetHttpProxies/list rpc ListRegionTargetHttpProxies(ListRegionTargetHttpProxiesRequest) returns (google.cloud.cpp.compute.v1.TargetHttpProxyList) { @@ -116,14 +116,17 @@ message DeleteTargetHttpProxyRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // Name of the TargetHttpProxy resource to delete. @@ -164,14 +167,17 @@ message InsertTargetHttpProxyRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // The TargetHttpProxy for this request. @@ -182,58 +188,89 @@ message InsertTargetHttpProxyRequest { // Request message for ListRegionTargetHttpProxies. message ListRegionTargetHttpProxiesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -245,9 +282,11 @@ message ListRegionTargetHttpProxiesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "region"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; } @@ -269,14 +308,17 @@ message SetUrlMapRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // Name of the TargetHttpProxy to set a URL map for. 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 3fd6e98a23cdb..5ed25ff493888 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: 20250601 +// revision: 20260807 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_016.proto"; -import "google/cloud/compute/v1/internal/common_109.proto"; -import "google/cloud/compute/v1/internal/common_137.proto"; -import "google/cloud/compute/v1/internal/common_147.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_128.proto"; +import "google/cloud/compute/v1/internal/common_163.proto"; +import "google/cloud/compute/v1/internal/common_174.proto"; import "google/cloud/extended_operations.proto"; // Service for the regionTargetHttpsProxies resource. @@ -74,8 +74,8 @@ service RegionTargetHttpsProxies { option (google.cloud.operation_service) = "RegionOperations"; } - // Retrieves the list of TargetHttpsProxy resources available to the specified - // project in the specified region. + // Retrieves the list of TargetHttpsProxy resources available + // to the specified project in the specified region. // https://cloud.google.com/compute/docs/reference/rest/v1/regionTargetHttpsProxies/list rpc ListRegionTargetHttpsProxies(ListRegionTargetHttpsProxiesRequest) returns (google.cloud.cpp.compute.v1.TargetHttpsProxyList) { @@ -86,8 +86,9 @@ service RegionTargetHttpsProxies { } // 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. + // included in the request. This method supports PATCH + // semantics and usesJSON merge + // patch format and processing rules. // https://cloud.google.com/compute/docs/reference/rest/v1/regionTargetHttpsProxies/patch rpc PatchTargetHttpsProxy(PatchTargetHttpsProxyRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -145,14 +146,17 @@ message DeleteTargetHttpsProxyRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // Name of the TargetHttpsProxy resource to delete. @@ -193,14 +197,17 @@ message InsertTargetHttpsProxyRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // The TargetHttpsProxy for this request. @@ -211,58 +218,89 @@ message InsertTargetHttpsProxyRequest { // Request message for ListRegionTargetHttpsProxies. message ListRegionTargetHttpsProxiesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -274,9 +312,11 @@ message ListRegionTargetHttpsProxiesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "region"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; } @@ -298,14 +338,17 @@ message PatchTargetHttpsProxyRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // Name of the TargetHttpsProxy resource to patch. @@ -341,18 +384,21 @@ message SetSslCertificatesRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; - // Name of the TargetHttpsProxy resource to set an SslCertificates resource - // for. + // Name of the TargetHttpsProxy resource to set an + // SslCertificates resource for. string target_https_proxy = 5 [(google.api.field_behavior) = REQUIRED, json_name = "targetHttpsProxy"]; } @@ -375,14 +421,17 @@ message SetUrlMapRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // Name of the TargetHttpsProxy to set a URL map for. 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 db589fd9ad87a..b9a4233cc31f3 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: 20250601 +// revision: 20260807 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_016.proto"; -import "google/cloud/compute/v1/internal/common_143.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_169.proto"; import "google/cloud/extended_operations.proto"; // Service for the regionTargetTcpProxies resource. @@ -72,8 +72,8 @@ service RegionTargetTcpProxies { option (google.cloud.operation_service) = "RegionOperations"; } - // Retrieves a list of TargetTcpProxy resources available to the specified - // project in a given region. + // Retrieves a list of TargetTcpProxy resources + // available to the specified project in a given region. // https://cloud.google.com/compute/docs/reference/rest/v1/regionTargetTcpProxies/list rpc ListRegionTargetTcpProxies(ListRegionTargetTcpProxiesRequest) returns (google.cloud.cpp.compute.v1.TargetTcpProxyList) { @@ -102,14 +102,17 @@ message DeleteTargetTcpProxyRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // Name of the TargetTcpProxy resource to delete. @@ -150,14 +153,17 @@ message InsertTargetTcpProxyRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // The TargetTcpProxy for this request. @@ -168,58 +174,89 @@ message InsertTargetTcpProxyRequest { // Request message for ListRegionTargetTcpProxies. message ListRegionTargetTcpProxiesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -231,8 +268,10 @@ message ListRegionTargetTcpProxiesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "region"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; } 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 b91f5eb075470..fb675b5e638cd 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: 20250601 +// revision: 20260807 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_016.proto"; -import "google/cloud/compute/v1/internal/common_020.proto"; -import "google/cloud/compute/v1/internal/common_110.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_023.proto"; +import "google/cloud/compute/v1/internal/common_129.proto"; import "google/cloud/extended_operations.proto"; // Service for the regionUrlMaps resource. @@ -58,8 +58,8 @@ service RegionUrlMaps { option (google.api.method_signature) = "project,region,url_map"; } - // Creates a UrlMap resource in the specified project using the data included - // in the request. + // Creates a UrlMap resource in the specified project using + // the data included in the request. // https://cloud.google.com/compute/docs/reference/rest/v1/regionUrlMaps/insert rpc InsertUrlMap(InsertUrlMapRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -71,8 +71,8 @@ service RegionUrlMaps { option (google.cloud.operation_service) = "RegionOperations"; } - // Retrieves the list of UrlMap resources available to the specified project - // in the specified region. + // Retrieves the list of UrlMap resources available to the specified + // project in the specified region. // https://cloud.google.com/compute/docs/reference/rest/v1/regionUrlMaps/list rpc ListRegionUrlMaps(ListRegionUrlMapsRequest) returns (google.cloud.cpp.compute.v1.UrlMapList) { @@ -83,8 +83,9 @@ service RegionUrlMaps { } // 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. + // request. This method supportsPATCH + // semantics and usesJSON merge + // patch format and processing rules. // https://cloud.google.com/compute/docs/reference/rest/v1/regionUrlMaps/patch rpc PatchUrlMap(PatchUrlMapRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -142,8 +143,8 @@ message DeleteUrlMapRequest { json_name = "region" ]; - // begin_interface: MixerMutationRequestBuilder Request ID to support - // idempotency. + // begin_interface: MixerMutationRequestBuilder + // Request ID to support idempotency. optional string request_id = 3 [json_name = "requestId"]; // Name of the UrlMap resource to delete. @@ -182,8 +183,8 @@ message InsertUrlMapRequest { json_name = "region" ]; - // begin_interface: MixerMutationRequestBuilder Request ID to support - // idempotency. + // begin_interface: MixerMutationRequestBuilder + // Request ID to support idempotency. optional string request_id = 3 [json_name = "requestId"]; // The UrlMap for this request. @@ -194,58 +195,89 @@ message InsertUrlMapRequest { // Request message for ListRegionUrlMaps. message ListRegionUrlMapsRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -257,9 +289,11 @@ message ListRegionUrlMapsRequest { [(google.api.field_behavior) = REQUIRED, json_name = "region"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; } @@ -279,8 +313,8 @@ message PatchUrlMapRequest { json_name = "region" ]; - // begin_interface: MixerMutationRequestBuilder Request ID to support - // idempotency. + // begin_interface: MixerMutationRequestBuilder + // Request ID to support idempotency. optional string request_id = 3 [json_name = "requestId"]; // Name of the UrlMap resource to patch. @@ -308,8 +342,8 @@ message UpdateUrlMapRequest { json_name = "region" ]; - // begin_interface: MixerMutationRequestBuilder Request ID to support - // idempotency. + // begin_interface: MixerMutationRequestBuilder + // Request ID to support idempotency. optional string request_id = 3 [json_name = "requestId"]; // Name of the UrlMap resource to update. 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 210194f4e517d..f97cb0b2c0c11 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: 20250601 +// revision: 20260807 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_150.proto"; +import "google/cloud/compute/v1/internal/common_031.proto"; // Service for the regionZones resource. // https://cloud.google.com/compute/docs/reference/rest/v1/regionZones @@ -50,58 +50,89 @@ service RegionZones { // Request message for ListRegionZones. message ListRegionZonesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -113,8 +144,10 @@ message ListRegionZonesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "region"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; } diff --git a/protos/google/cloud/compute/regions/v1/regions.proto b/protos/google/cloud/compute/regions/v1/regions.proto index 68d7af11251c3..3ee09c001c403 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: 20250601 +// revision: 20260807 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_099.proto"; +import "google/cloud/compute/v1/internal/common_116.proto"; // Service for the regions resource. // https://cloud.google.com/compute/docs/reference/rest/v1/regions @@ -35,19 +35,24 @@ service Regions { "https://www.googleapis.com/auth/compute," "https://www.googleapis.com/auth/compute.readonly"; - // 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 + // 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. + // 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. // https://cloud.google.com/compute/docs/reference/rest/v1/regions/get rpc GetRegion(GetRegionRequest) returns (google.cloud.cpp.compute.v1.Region) { option (google.api.http) = { @@ -57,19 +62,24 @@ service Regions { } // 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 + // 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. + // 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. // https://cloud.google.com/compute/docs/reference/rest/v1/regions/list rpc ListRegions(ListRegionsRequest) returns (google.cloud.cpp.compute.v1.RegionList) { @@ -94,58 +104,89 @@ message GetRegionRequest { // Request message for ListRegions. message ListRegionsRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -153,8 +194,10 @@ message ListRegionsRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 6 [json_name = "returnPartialSuccess"]; } diff --git a/protos/google/cloud/compute/reliability_risks/v1/reliability_risks.proto b/protos/google/cloud/compute/reliability_risks/v1/reliability_risks.proto new file mode 100644 index 0000000000000..419962b216d82 --- /dev/null +++ b/protos/google/cloud/compute/reliability_risks/v1/reliability_risks.proto @@ -0,0 +1,169 @@ +// Copyright 2026 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: 20260807 + +syntax = "proto3"; + +package google.cloud.cpp.compute.reliability_risks.v1; + +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/cloud/compute/v1/internal/common_130.proto"; + +// Service for the reliabilityRisks resource. +// https://cloud.google.com/compute/docs/reference/rest/v1/reliabilityRisks +service ReliabilityRisks { + option (google.api.default_host) = "compute.googleapis.com"; + option (google.api.oauth_scopes) = + "https://www.googleapis.com/auth/cloud-platform," + "https://www.googleapis.com/auth/compute," + "https://www.googleapis.com/auth/compute.readonly"; + + // Returns the specified ReliabilityRisk resource. + // https://cloud.google.com/compute/docs/reference/rest/v1/reliabilityRisks/get + rpc GetReliabilityRisk(GetReliabilityRiskRequest) + returns (google.cloud.cpp.compute.v1.ReliabilityRisk) { + option (google.api.http) = { + get: "/compute/v1/projects/{project}/global/reliabilityRisks/{reliability_risk}" + }; + option (google.api.method_signature) = "project,reliability_risk"; + } + + // Retrieves the list of reliabilityRisks available in the specified project. + // https://cloud.google.com/compute/docs/reference/rest/v1/reliabilityRisks/list + rpc ListReliabilityRisks(ListReliabilityRisksRequest) + returns (google.cloud.cpp.compute.v1.ReliabilityRisksListResponse) { + option (google.api.http) = { + get: "/compute/v1/projects/{project}/global/reliabilityRisks" + }; + option (google.api.method_signature) = "project"; + } +} + +// Request message for GetReliabilityRisk. +message GetReliabilityRiskRequest { + // Project ID for this request. + string project = 1 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // Name of the ReliabilityRisk resource to return. + string reliability_risk = 2 + [(google.api.field_behavior) = REQUIRED, json_name = "reliabilityRisk"]; +} + +// Request message for ListReliabilityRisks. +message ListReliabilityRisksRequest { + // A filter expression that filters resources listed in the response. Most + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. + optional string filter = 1 [json_name = "filter"]; + + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) + optional uint32 max_results = 2 [json_name = "maxResults"]; + + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or + // `creationTimestamp desc` is supported. + optional string order_by = 3 [json_name = "orderBy"]; + + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. + optional string page_token = 4 [json_name = "pageToken"]; + + // Project ID for this request. + string project = 5 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // Opt-in for partial success behavior which provides partial results in case + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. + optional bool return_partial_success = 6 [json_name = "returnPartialSuccess"]; +} diff --git a/protos/google/cloud/compute/reservation_blocks/v1/reservation_blocks.proto b/protos/google/cloud/compute/reservation_blocks/v1/reservation_blocks.proto index 503cb9420e338..d799461f8ffa5 100644 --- a/protos/google/cloud/compute/reservation_blocks/v1/reservation_blocks.proto +++ b/protos/google/cloud/compute/reservation_blocks/v1/reservation_blocks.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: 20250601 +// revision: 20260807 syntax = "proto3"; @@ -24,8 +24,11 @@ package google.cloud.cpp.compute.reservation_blocks.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_112.proto"; +import "google/cloud/compute/v1/internal/common_009.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_132.proto"; +import "google/cloud/compute/v1/internal/common_171.proto"; +import "google/cloud/compute/v1/internal/common_181.proto"; import "google/cloud/extended_operations.proto"; // Service for the reservationBlocks resource. @@ -48,6 +51,18 @@ service ReservationBlocks { "project,zone,reservation,reservation_block"; } + // Gets the access control policy for a resource. May be empty if no such + // policy or resource exists. + // https://cloud.google.com/compute/docs/reference/rest/v1/reservationBlocks/getIamPolicy + rpc GetIamPolicy(GetIamPolicyRequest) + returns (google.cloud.cpp.compute.v1.Policy) { + option (google.api.http) = { + get: "/compute/v1/projects/{project}/zones/{zone}/reservations/{parent_resource}/reservationBlocks/{resource}/getIamPolicy" + }; + option (google.api.method_signature) = + "project,zone,parent_resource,resource"; + } + // Retrieves a list of reservation blocks under a single reservation. // https://cloud.google.com/compute/docs/reference/rest/v1/reservationBlocks/list rpc ListReservationBlocks(ListReservationBlocksRequest) @@ -70,6 +85,53 @@ service ReservationBlocks { "project,zone,reservation,reservation_block,reservations_blocks_perform_maintenance_request_resource"; option (google.cloud.operation_service) = "ZoneOperations"; } + + // Sets the access control policy on the specified resource. + // Replaces any existing policy. + // https://cloud.google.com/compute/docs/reference/rest/v1/reservationBlocks/setIamPolicy + rpc SetIamPolicy(SetIamPolicyRequest) + returns (google.cloud.cpp.compute.v1.Policy) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/zones/{zone}/reservations/{parent_resource}/reservationBlocks/{resource}/setIamPolicy" + body: "zone_set_nested_policy_request_resource" + }; + option (google.api.method_signature) = + "project,zone,parent_resource,resource,zone_set_nested_policy_request_resource"; + } + + // Returns permissions that a caller has on the specified resource. + // https://cloud.google.com/compute/docs/reference/rest/v1/reservationBlocks/testIamPermissions + rpc TestIamPermissions(TestIamPermissionsRequest) + returns (google.cloud.cpp.compute.v1.TestPermissionsResponse) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/zones/{zone}/reservations/{parent_resource}/reservationBlocks/{resource}/testIamPermissions" + body: "test_permissions_request_resource" + }; + option (google.api.method_signature) = + "project,zone,parent_resource,resource,test_permissions_request_resource"; + } +} + +// Request message for GetIamPolicy. +message GetIamPolicyRequest { + // Requested IAM Policy version. + optional int32 options_requested_policy_version = 1 + [json_name = "optionsRequestedPolicyVersion"]; + + // Name or id of parent resource of the resource for this request. + string parent_resource = 2 + [(google.api.field_behavior) = REQUIRED, json_name = "parentResource"]; + + // Project ID for this request. + string project = 3 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // Name or id of the resource for this request. + string resource = 4 + [(google.api.field_behavior) = REQUIRED, json_name = "resource"]; + + // The name of the zone for this request. + string zone = 5 [(google.api.field_behavior) = REQUIRED, json_name = "zone"]; } // Request message for GetReservationBlocksGetResponse. @@ -78,16 +140,23 @@ message GetReservationBlocksGetResponseRequest { string project = 1 [(google.api.field_behavior) = REQUIRED, json_name = "project"]; - // The name of the reservation. Name should conform to RFC1035 or be a - // resource ID. + // The name of the reservation. + // Name should conform to RFC1035 or be a resource ID. string reservation = 2 [(google.api.field_behavior) = REQUIRED, json_name = "reservation"]; - // The name of the reservation block. Name should conform to RFC1035 or be a - // resource ID. + // The name of the reservation block. + // Name should conform to RFC1035 or be a resource ID. string reservation_block = 3 [(google.api.field_behavior) = REQUIRED, json_name = "reservationBlock"]; + // View of the Block. + // BASIC: This view includes basic information about the reservation block + // BLOCK_VIEW_UNSPECIFIED: The default / unset value. The API will default to + // the BASIC view. + // FULL: Includes detailed topology view. + optional string view = 5 [json_name = "view"]; + // Name of the zone for this request. Zone name should conform to RFC1035. string zone = 4 [(google.api.field_behavior) = REQUIRED, json_name = "zone"]; } @@ -95,73 +164,106 @@ message GetReservationBlocksGetResponseRequest { // Request message for ListReservationBlocks. message ListReservationBlocksRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. string project = 5 [(google.api.field_behavior) = REQUIRED, json_name = "project"]; - // The name of the reservation. Name should conform to RFC1035 or be a - // resource ID. + // The name of the reservation. + // Name should conform to RFC1035 or be a resource ID. string reservation = 6 [(google.api.field_behavior) = REQUIRED, json_name = "reservation"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; // Name of the zone for this request. Zone name should conform to RFC1035. @@ -179,23 +281,26 @@ message PerformMaintenanceRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 2 [json_name = "requestId"]; - // The name of the reservation. Name should conform to RFC1035 or be a - // resource ID. + // The name of the reservation. + // Name should conform to RFC1035 or be a resource ID. string reservation = 3 [(google.api.field_behavior) = REQUIRED, json_name = "reservation"]; - // The name of the reservation block. Name should conform to RFC1035 or be a - // resource ID. + // The name of the reservation block. + // Name should conform to RFC1035 or be a resource ID. string reservation_block = 4 [(google.api.field_behavior) = REQUIRED, json_name = "reservationBlock"]; @@ -212,3 +317,48 @@ message PerformMaintenanceRequest { json_name = "zone" ]; } + +// Request message for SetIamPolicy. +message SetIamPolicyRequest { + // Name or id of parent resource of the resource for this request. + string parent_resource = 1 + [(google.api.field_behavior) = REQUIRED, json_name = "parentResource"]; + + // Project ID for this request. + string project = 2 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // Name or id of the resource for this request. + string resource = 3 + [(google.api.field_behavior) = REQUIRED, json_name = "resource"]; + + // The name of the zone for this request. + string zone = 4 [(google.api.field_behavior) = REQUIRED, json_name = "zone"]; + + // The ZoneSetNestedPolicyRequest for this request. + optional google.cloud.cpp.compute.v1.ZoneSetNestedPolicyRequest + zone_set_nested_policy_request_resource = 5 + [json_name = "__json_request_body"]; +} + +// Request message for TestIamPermissions. +message TestIamPermissionsRequest { + // Name or id of parent resource of the resource for this request. + string parent_resource = 1 + [(google.api.field_behavior) = REQUIRED, json_name = "parentResource"]; + + // Project ID for this request. + string project = 2 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // Name or id of the resource for this request. + string resource = 3 + [(google.api.field_behavior) = REQUIRED, json_name = "resource"]; + + // The TestPermissionsRequest for this request. + optional google.cloud.cpp.compute.v1.TestPermissionsRequest + test_permissions_request_resource = 4 [json_name = "__json_request_body"]; + + // The name of the zone for this request. + string zone = 5 [(google.api.field_behavior) = REQUIRED, json_name = "zone"]; +} diff --git a/protos/google/cloud/compute/reservation_slots/v1/reservation_slots.proto b/protos/google/cloud/compute/reservation_slots/v1/reservation_slots.proto new file mode 100644 index 0000000000000..84844cd0aa5d6 --- /dev/null +++ b/protos/google/cloud/compute/reservation_slots/v1/reservation_slots.proto @@ -0,0 +1,295 @@ +// Copyright 2026 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: 20260807 + +syntax = "proto3"; + +package google.cloud.cpp.compute.reservation_slots.v1; + +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_133.proto"; +import "google/cloud/extended_operations.proto"; + +// Service for the reservationSlots resource. +// https://cloud.google.com/compute/docs/reference/rest/v1/reservationSlots +service ReservationSlots { + option (google.api.default_host) = "compute.googleapis.com"; + option (google.api.oauth_scopes) = + "https://www.googleapis.com/auth/cloud-platform," + "https://www.googleapis.com/auth/compute," + "https://www.googleapis.com/auth/compute.readonly"; + + // Retrieves information about the specified reservation slot. + // https://cloud.google.com/compute/docs/reference/rest/v1/reservationSlots/get + rpc GetReservationSlotsGetResponse(GetReservationSlotsGetResponseRequest) + returns (google.cloud.cpp.compute.v1.ReservationSlotsGetResponse) { + option (google.api.http) = { + get: "/compute/v1/projects/{project}/zones/{zone}/{parent_name}/reservationSlots/{reservation_slot}" + }; + option (google.api.method_signature) = + "project,zone,parent_name,reservation_slot"; + } + + // Allows customers to get SBOM versions of a reservation slot. + // https://cloud.google.com/compute/docs/reference/rest/v1/reservationSlots/getVersion + rpc GetVersion(GetVersionRequest) + returns (google.cloud.cpp.compute.v1.Operation) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/zones/{zone}/{parent_name}/reservationSlots/{reservation_slot}/getVersion" + body: "reservation_slots_get_version_request_resource" + }; + option (google.api.method_signature) = + "project,zone,parent_name,reservation_slot,reservation_slots_get_version_request_resource"; + option (google.cloud.operation_service) = "ZoneOperations"; + } + + // Retrieves a list of reservation slots under a single reservation. + // https://cloud.google.com/compute/docs/reference/rest/v1/reservationSlots/list + rpc ListReservationSlots(ListReservationSlotsRequest) + returns (google.cloud.cpp.compute.v1.ReservationSlotsListResponse) { + option (google.api.http) = { + get: "/compute/v1/projects/{project}/zones/{zone}/{parent_name}/reservationSlots" + }; + option (google.api.method_signature) = "project,zone,parent_name"; + } + + // Update a reservation slot in the specified sub-block. + // https://cloud.google.com/compute/docs/reference/rest/v1/reservationSlots/update + rpc UpdateReservationSlotsGetResponse( + UpdateReservationSlotsGetResponseRequest) + returns (google.cloud.cpp.compute.v1.Operation) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/zones/{zone}/{parent_name}/reservationSlots/{reservation_slot}" + body: "reservation_slot_resource" + }; + option (google.api.method_signature) = + "project,zone,parent_name,reservation_slot,reservation_slot_resource"; + option (google.cloud.operation_service) = "ZoneOperations"; + } +} + +// Request message for GetReservationSlotsGetResponse. +message GetReservationSlotsGetResponseRequest { + // The name of the parent reservation and parent block, formatted as + // reservations/{reservation_name}/reservationBlocks/{reservation_block_name}/reservationSubBlocks/{reservation_sub_block_name} + string parent_name = 1 + [(google.api.field_behavior) = REQUIRED, json_name = "parentName"]; + + // The project ID for this request. + string project = 2 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // The name of the reservation slot, formatted as RFC1035 or a resource ID + // number. + string reservation_slot = 3 + [(google.api.field_behavior) = REQUIRED, json_name = "reservationSlot"]; + + // The name of the zone for this request, formatted as RFC1035. + string zone = 4 [(google.api.field_behavior) = REQUIRED, json_name = "zone"]; +} + +// Request message for GetVersion. +message GetVersionRequest { + // The name of the parent reservation and parent block. In the format of + // reservations/{reservation_name}/reservationBlocks/{reservation_block_name}/reservationSubBlocks/{reservation_sub_block_name} + string parent_name = 1 + [(google.api.field_behavior) = REQUIRED, json_name = "parentName"]; + + // Project ID for this request. + string project = 2 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "project", + json_name = "project" + ]; + + // An optional request ID to identify requests. Specify a unique request ID so + // that if you must retry your request, the server will know to ignore the + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). + optional string request_id = 3 [json_name = "requestId"]; + + // The name of the reservation slot. + // Name should conform to RFC1035 or be a resource ID. + string reservation_slot = 4 + [(google.api.field_behavior) = REQUIRED, json_name = "reservationSlot"]; + + // The ReservationSlotsGetVersionRequest for this request. + optional google.cloud.cpp.compute.v1.ReservationSlotsGetVersionRequest + reservation_slots_get_version_request_resource = 5 + [json_name = "__json_request_body"]; + + // Name of the zone for this request. Zone name should conform to RFC1035. + string zone = 6 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "zone", + json_name = "zone" + ]; +} + +// Request message for ListReservationSlots. +message ListReservationSlotsRequest { + // A filter expression that filters resources listed in the response. Most + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. + optional string filter = 1 [json_name = "filter"]; + + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) + optional uint32 max_results = 2 [json_name = "maxResults"]; + + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or + // `creationTimestamp desc` is supported. + optional string order_by = 3 [json_name = "orderBy"]; + + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. + optional string page_token = 4 [json_name = "pageToken"]; + + // The name of the parent reservation and parent block, formatted as + // reservations/{reservation_name}/reservationBlocks/{reservation_block_name}/reservationSubBlocks/{reservation_sub_block_name} + string parent_name = 5 + [(google.api.field_behavior) = REQUIRED, json_name = "parentName"]; + + // The project ID for this request. + string project = 6 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // Opt-in for partial success behavior which provides partial results in case + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. + optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; + + // The name of the zone for this request, formatted as RFC1035. + string zone = 8 [(google.api.field_behavior) = REQUIRED, json_name = "zone"]; +} + +// Request message for UpdateReservationSlotsGetResponse. +message UpdateReservationSlotsGetResponseRequest { + // The name of the sub-block resource. + string parent_name = 1 + [(google.api.field_behavior) = REQUIRED, json_name = "parentName"]; + + // The project ID for this request. + string project = 2 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "project", + json_name = "project" + ]; + + // The name of the slot resource. + string reservation_slot = 3 + [(google.api.field_behavior) = REQUIRED, json_name = "reservationSlot"]; + + // The ReservationSlot for this request. + optional google.cloud.cpp.compute.v1.ReservationSlot + reservation_slot_resource = 4 [json_name = "__json_request_body"]; + + // The fields to be updated as part of this request. + optional string update_mask = 5 [json_name = "updateMask"]; + + // The name of the zone for this request, formatted as RFC1035. + string zone = 6 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "zone", + json_name = "zone" + ]; +} diff --git a/protos/google/cloud/compute/reservation_sub_blocks/v1/reservation_sub_blocks.proto b/protos/google/cloud/compute/reservation_sub_blocks/v1/reservation_sub_blocks.proto index 8592e30e39c3e..ce4b074e9f8db 100644 --- a/protos/google/cloud/compute/reservation_sub_blocks/v1/reservation_sub_blocks.proto +++ b/protos/google/cloud/compute/reservation_sub_blocks/v1/reservation_sub_blocks.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: 20250601 +// revision: 20260807 syntax = "proto3"; @@ -24,7 +24,12 @@ package google.cloud.cpp.compute.reservation_sub_blocks.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_113.proto"; +import "google/cloud/compute/v1/internal/common_002.proto"; +import "google/cloud/compute/v1/internal/common_009.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_171.proto"; +import "google/cloud/compute/v1/internal/common_181.proto"; +import "google/cloud/extended_operations.proto"; // Service for the reservationSubBlocks resource. // https://cloud.google.com/compute/docs/reference/rest/v1/reservationSubBlocks @@ -47,6 +52,31 @@ service ReservationSubBlocks { "project,zone,parent_name,reservation_sub_block"; } + // Gets the access control policy for a resource. May be empty if no such + // policy or resource exists. + // https://cloud.google.com/compute/docs/reference/rest/v1/reservationSubBlocks/getIamPolicy + rpc GetIamPolicy(GetIamPolicyRequest) + returns (google.cloud.cpp.compute.v1.Policy) { + option (google.api.http) = { + get: "/compute/v1/projects/{project}/zones/{zone}/{parent_resource}/reservationSubBlocks/{resource}/getIamPolicy" + }; + option (google.api.method_signature) = + "project,zone,parent_resource,resource"; + } + + // Allows customers to get SBOM versions of a reservation subBlock. + // https://cloud.google.com/compute/docs/reference/rest/v1/reservationSubBlocks/getVersion + rpc GetVersion(GetVersionRequest) + returns (google.cloud.cpp.compute.v1.Operation) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/zones/{zone}/{parent_name}/reservationSubBlocks/{reservation_sub_block}/getVersion" + body: "reservation_sub_blocks_get_version_request_resource" + }; + option (google.api.method_signature) = + "project,zone,parent_name,reservation_sub_block,reservation_sub_blocks_get_version_request_resource"; + option (google.cloud.operation_service) = "ZoneOperations"; + } + // Retrieves a list of reservation subBlocks under a single reservation. // https://cloud.google.com/compute/docs/reference/rest/v1/reservationSubBlocks/list rpc ListReservationSubBlocks(ListReservationSubBlocksRequest) @@ -56,6 +86,79 @@ service ReservationSubBlocks { }; option (google.api.method_signature) = "project,zone,parent_name"; } + + // Allows customers to perform maintenance on a reservation subBlock + // https://cloud.google.com/compute/docs/reference/rest/v1/reservationSubBlocks/performMaintenance + rpc PerformMaintenance(PerformMaintenanceRequest) + returns (google.cloud.cpp.compute.v1.Operation) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/zones/{zone}/{parent_name}/reservationSubBlocks/{reservation_sub_block}/performMaintenance" + body: "*" + }; + option (google.api.method_signature) = + "project,zone,parent_name,reservation_sub_block"; + option (google.cloud.operation_service) = "ZoneOperations"; + } + + // Allows customers to report a faulty subBlock. + // https://cloud.google.com/compute/docs/reference/rest/v1/reservationSubBlocks/reportFaulty + rpc ReportFaulty(ReportFaultyRequest) + returns (google.cloud.cpp.compute.v1.Operation) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/zones/{zone}/{parent_name}/reservationSubBlocks/{reservation_sub_block}/reportFaulty" + body: "reservation_sub_blocks_report_faulty_request_resource" + }; + option (google.api.method_signature) = + "project,zone,parent_name,reservation_sub_block,reservation_sub_blocks_report_faulty_request_resource"; + option (google.cloud.operation_service) = "ZoneOperations"; + } + + // Sets the access control policy on the specified resource. + // Replaces any existing policy. + // https://cloud.google.com/compute/docs/reference/rest/v1/reservationSubBlocks/setIamPolicy + rpc SetIamPolicy(SetIamPolicyRequest) + returns (google.cloud.cpp.compute.v1.Policy) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/zones/{zone}/{parent_resource}/reservationSubBlocks/{resource}/setIamPolicy" + body: "zone_set_nested_policy_request_resource" + }; + option (google.api.method_signature) = + "project,zone,parent_resource,resource,zone_set_nested_policy_request_resource"; + } + + // Returns permissions that a caller has on the specified resource. + // https://cloud.google.com/compute/docs/reference/rest/v1/reservationSubBlocks/testIamPermissions + rpc TestIamPermissions(TestIamPermissionsRequest) + returns (google.cloud.cpp.compute.v1.TestPermissionsResponse) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/zones/{zone}/{parent_resource}/reservationSubBlocks/{resource}/testIamPermissions" + body: "test_permissions_request_resource" + }; + option (google.api.method_signature) = + "project,zone,parent_resource,resource,test_permissions_request_resource"; + } +} + +// Request message for GetIamPolicy. +message GetIamPolicyRequest { + // Requested IAM Policy version. + optional int32 options_requested_policy_version = 1 + [json_name = "optionsRequestedPolicyVersion"]; + + // Name or id of parent resource of the resource for this request. + string parent_resource = 2 + [(google.api.field_behavior) = REQUIRED, json_name = "parentResource"]; + + // Project ID for this request. + string project = 3 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // Name or id of the resource for this request. + string resource = 4 + [(google.api.field_behavior) = REQUIRED, json_name = "resource"]; + + // The name of the zone for this request. + string zone = 5 [(google.api.field_behavior) = REQUIRED, json_name = "zone"]; } // Request message for GetReservationSubBlocksGetResponse. @@ -69,72 +172,160 @@ message GetReservationSubBlocksGetResponseRequest { string project = 2 [(google.api.field_behavior) = REQUIRED, json_name = "project"]; - // The name of the reservation subBlock. Name should conform to RFC1035 or be - // a resource ID. + // The name of the reservation subBlock. + // Name should conform to RFC1035 or be a resource ID. string reservation_sub_block = 3 [ (google.api.field_behavior) = REQUIRED, json_name = "reservationSubBlock" ]; + // View of the subBlock. + // SUB_BLOCK_VIEW_BASIC: This view includes basic information about the + // reservation sub block + // SUB_BLOCK_VIEW_FULL: Includes detailed topology view. + // SUB_BLOCK_VIEW_UNSPECIFIED: The default / unset value. The API will default + // to the BASIC view. + optional string view = 5 [json_name = "view"]; + // Name of the zone for this request. Zone name should conform to RFC1035. string zone = 4 [(google.api.field_behavior) = REQUIRED, json_name = "zone"]; } +// Request message for GetVersion. +message GetVersionRequest { + // The name of the parent reservation and parent block. In the format of + // reservations/{reservation_name}/reservationBlocks/{reservation_block_name} + string parent_name = 1 + [(google.api.field_behavior) = REQUIRED, json_name = "parentName"]; + + // Project ID for this request. + string project = 2 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "project", + json_name = "project" + ]; + + // An optional request ID to identify requests. Specify a unique request ID so + // that if you must retry your request, the server will know to ignore the + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). + optional string request_id = 3 [json_name = "requestId"]; + + // The name of the reservation subBlock. + // Name should conform to RFC1035 or be a resource ID. + string reservation_sub_block = 4 [ + (google.api.field_behavior) = REQUIRED, + json_name = "reservationSubBlock" + ]; + + // The ReservationSubBlocksGetVersionRequest for this request. + optional google.cloud.cpp.compute.v1.ReservationSubBlocksGetVersionRequest + reservation_sub_blocks_get_version_request_resource = 5 + [json_name = "__json_request_body"]; + + // Name of the zone for this request. Zone name should conform to RFC1035. + string zone = 6 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "zone", + json_name = "zone" + ]; +} + // Request message for ListReservationSubBlocks. message ListReservationSubBlocksRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // The name of the parent reservation and parent block. In the format of @@ -147,11 +338,151 @@ message ListReservationSubBlocksRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; // Name of the zone for this request. Zone name should conform to RFC1035. string zone = 8 [(google.api.field_behavior) = REQUIRED, json_name = "zone"]; } + +// Request message for PerformMaintenance. +message PerformMaintenanceRequest { + // The name of the parent reservation and parent block. In the format of + // reservations/{reservation_name}/reservationBlocks/{reservation_block_name} + string parent_name = 1 + [(google.api.field_behavior) = REQUIRED, json_name = "parentName"]; + + // Project ID for this request. + string project = 2 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "project", + json_name = "project" + ]; + + // An optional request ID to identify requests. Specify a unique request ID so + // that if you must retry your request, the server will know to ignore the + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). + optional string request_id = 3 [json_name = "requestId"]; + + // The name of the reservation subBlock. + // Name should conform to RFC1035 or be a resource ID. + string reservation_sub_block = 4 [ + (google.api.field_behavior) = REQUIRED, + json_name = "reservationSubBlock" + ]; + + // Name of the zone for this request. Zone name should conform to RFC1035. + string zone = 5 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "zone", + json_name = "zone" + ]; +} + +// Request message for ReportFaulty. +message ReportFaultyRequest { + // The name of the parent reservation and parent block. In the format of + // reservations/{reservation_name}/reservationBlocks/{reservation_block_name} + string parent_name = 1 + [(google.api.field_behavior) = REQUIRED, json_name = "parentName"]; + + // Project ID for this request. + string project = 2 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "project", + json_name = "project" + ]; + + // An optional request ID to identify requests. Specify a unique request ID so + // that if you must retry your request, the server will know to ignore the + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). + optional string request_id = 3 [json_name = "requestId"]; + + // The name of the reservation subBlock. + // Name should conform to RFC1035 or be a resource ID. + string reservation_sub_block = 4 [ + (google.api.field_behavior) = REQUIRED, + json_name = "reservationSubBlock" + ]; + + // The ReservationSubBlocksReportFaultyRequest for this request. + optional google.cloud.cpp.compute.v1.ReservationSubBlocksReportFaultyRequest + reservation_sub_blocks_report_faulty_request_resource = 5 + [json_name = "__json_request_body"]; + + // Name of the zone for this request. Zone name should conform to RFC1035. + string zone = 6 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "zone", + json_name = "zone" + ]; +} + +// Request message for SetIamPolicy. +message SetIamPolicyRequest { + // Name or id of parent resource of the resource for this request. + string parent_resource = 1 + [(google.api.field_behavior) = REQUIRED, json_name = "parentResource"]; + + // Project ID for this request. + string project = 2 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // Name or id of the resource for this request. + string resource = 3 + [(google.api.field_behavior) = REQUIRED, json_name = "resource"]; + + // The name of the zone for this request. + string zone = 4 [(google.api.field_behavior) = REQUIRED, json_name = "zone"]; + + // The ZoneSetNestedPolicyRequest for this request. + optional google.cloud.cpp.compute.v1.ZoneSetNestedPolicyRequest + zone_set_nested_policy_request_resource = 5 + [json_name = "__json_request_body"]; +} + +// Request message for TestIamPermissions. +message TestIamPermissionsRequest { + // Name or id of parent resource of the resource for this request. + string parent_resource = 1 + [(google.api.field_behavior) = REQUIRED, json_name = "parentResource"]; + + // Project ID for this request. + string project = 2 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // Name or id of the resource for this request. + string resource = 3 + [(google.api.field_behavior) = REQUIRED, json_name = "resource"]; + + // The TestPermissionsRequest for this request. + optional google.cloud.cpp.compute.v1.TestPermissionsRequest + test_permissions_request_resource = 4 [json_name = "__json_request_body"]; + + // The name of the zone for this request. + string zone = 5 [(google.api.field_behavior) = REQUIRED, json_name = "zone"]; +} diff --git a/protos/google/cloud/compute/reservations/v1/reservations.proto b/protos/google/cloud/compute/reservations/v1/reservations.proto index 5d76cff2e5e2c..56154b2ba343a 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: 20250601 +// revision: 20260807 syntax = "proto3"; @@ -24,12 +24,12 @@ package google.cloud.cpp.compute.reservations.v1; 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_007.proto"; -import "google/cloud/compute/v1/internal/common_016.proto"; -import "google/cloud/compute/v1/internal/common_111.proto"; -import "google/cloud/compute/v1/internal/common_145.proto"; -import "google/cloud/compute/v1/internal/common_152.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_019.proto"; +import "google/cloud/compute/v1/internal/common_131.proto"; +import "google/cloud/compute/v1/internal/common_171.proto"; +import "google/cloud/compute/v1/internal/common_182.proto"; import "google/cloud/extended_operations.proto"; // Service for the reservations resource. @@ -41,8 +41,10 @@ service Reservations { "https://www.googleapis.com/auth/compute," "https://www.googleapis.com/auth/compute.readonly"; - // Retrieves an aggregated list of reservations. To prevent failure, Google - // recommends that you set the `returnPartialSuccess` parameter to `true`. + // Retrieves an aggregated list of reservations. + // + // To prevent failure, it is recommended that you set the + // `returnPartialSuccess` parameter to `true`. // https://cloud.google.com/compute/docs/reference/rest/v1/reservations/aggregatedList rpc AggregatedListReservations(AggregatedListReservationsRequest) returns (google.cloud.cpp.compute.v1.ReservationAggregatedList) { @@ -84,7 +86,7 @@ service Reservations { option (google.api.method_signature) = "project,zone,resource"; } - // Creates a new reservation. For more information, read Reserving zonal + // Creates a new reservation. For more information, readReserving zonal // resources. // https://cloud.google.com/compute/docs/reference/rest/v1/reservations/insert rpc InsertReservation(InsertReservationRequest) @@ -97,8 +99,8 @@ service Reservations { option (google.cloud.operation_service) = "ZoneOperations"; } - // A list of all the reservations that have been configured for the specified - // project in specified zone. + // A list of all the reservations that have been configured for the + // specified project in specified zone. // https://cloud.google.com/compute/docs/reference/rest/v1/reservations/list rpc ListReservations(ListReservationsRequest) returns (google.cloud.cpp.compute.v1.ReservationList) { @@ -122,7 +124,8 @@ service Reservations { } // Resizes the reservation (applicable to standalone reservations only). For - // more information, read Modifying reservations. + // more information, readModifying + // reservations. // https://cloud.google.com/compute/docs/reference/rest/v1/reservations/resize rpc Resize(ResizeRequest) returns (google.cloud.cpp.compute.v1.Operation) { option (google.api.http) = { @@ -134,8 +137,8 @@ service Reservations { option (google.cloud.operation_service) = "ZoneOperations"; } - // Sets the access control policy on the specified resource. Replaces any - // existing policy. + // Sets the access control policy on the specified resource. + // Replaces any existing policy. // https://cloud.google.com/compute/docs/reference/rest/v1/reservations/setIamPolicy rpc SetIamPolicy(SetIamPolicyRequest) returns (google.cloud.cpp.compute.v1.Policy) { @@ -176,37 +179,64 @@ service Reservations { // Request message for AggregatedListReservations. message AggregatedListReservationsRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; // Indicates whether every visible scope for each scope type (zone, region, @@ -218,25 +248,29 @@ message AggregatedListReservationsRequest { // will be included. optional bool include_all_scopes = 2 [json_name = "includeAllScopes"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 3 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 4 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 5 [json_name = "pageToken"]; // Project ID for this request. @@ -244,9 +278,11 @@ message AggregatedListReservationsRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; // The Shared VPC service project id or service project number for which @@ -266,14 +302,17 @@ message DeleteReservationRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 2 [json_name = "requestId"]; // Name of the reservation to delete. @@ -331,14 +370,17 @@ message InsertReservationRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 2 [json_name = "requestId"]; // The Reservation for this request. @@ -356,58 +398,89 @@ message InsertReservationRequest { // Request message for ListReservations. message ListReservationsRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -415,9 +488,11 @@ message ListReservationsRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 6 [json_name = "returnPartialSuccess"]; // Name of the zone for this request. @@ -435,18 +510,21 @@ message PerformMaintenanceRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 2 [json_name = "requestId"]; - // The name of the reservation. Name should conform to RFC1035 or be a - // resource ID. + // The name of the reservation. + // Name should conform to RFC1035 or be a resource ID. string reservation = 3 [(google.api.field_behavior) = REQUIRED, json_name = "reservation"]; @@ -474,14 +552,17 @@ message ResizeRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 2 [json_name = "requestId"]; // Name of the reservation to update. @@ -550,14 +631,17 @@ message UpdateReservationRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // Name of the reservation to update. 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 35a0dc034e36f..c816120acada5 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: 20250601 +// revision: 20260807 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_007.proto"; -import "google/cloud/compute/v1/internal/common_016.proto"; -import "google/cloud/compute/v1/internal/common_108.proto"; -import "google/cloud/compute/v1/internal/common_114.proto"; -import "google/cloud/compute/v1/internal/common_145.proto"; +import "google/cloud/compute/v1/internal/common_009.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_126.proto"; +import "google/cloud/compute/v1/internal/common_135.proto"; +import "google/cloud/compute/v1/internal/common_171.proto"; import "google/cloud/extended_operations.proto"; // Service for the resourcePolicies resource. @@ -40,9 +40,10 @@ service ResourcePolicies { "https://www.googleapis.com/auth/compute," "https://www.googleapis.com/auth/compute.readonly"; - // Retrieves an aggregated list of resource policies. To prevent failure, - // Google recommends that you set the `returnPartialSuccess` parameter to - // `true`. + // Retrieves an aggregated list of resource policies. + // + // To prevent failure, Google recommends that you set the + // `returnPartialSuccess` parameter to `true`. // https://cloud.google.com/compute/docs/reference/rest/v1/resourcePolicies/aggregatedList rpc AggregatedListResourcePolicies(AggregatedListResourcePoliciesRequest) returns (google.cloud.cpp.compute.v1.ResourcePolicyAggregatedList) { @@ -121,8 +122,8 @@ service ResourcePolicies { option (google.cloud.operation_service) = "RegionOperations"; } - // Sets the access control policy on the specified resource. Replaces any - // existing policy. + // Sets the access control policy on the specified resource. + // Replaces any existing policy. // https://cloud.google.com/compute/docs/reference/rest/v1/resourcePolicies/setIamPolicy rpc SetIamPolicy(SetIamPolicyRequest) returns (google.cloud.cpp.compute.v1.Policy) { @@ -150,37 +151,64 @@ service ResourcePolicies { // Request message for AggregatedListResourcePolicies. message AggregatedListResourcePoliciesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; // Indicates whether every visible scope for each scope type (zone, region, @@ -192,25 +220,29 @@ message AggregatedListResourcePoliciesRequest { // will be included. optional bool include_all_scopes = 2 [json_name = "includeAllScopes"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 3 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 4 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 5 [json_name = "pageToken"]; // Project ID for this request. @@ -218,9 +250,11 @@ message AggregatedListResourcePoliciesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; // The Shared VPC service project id or service project number for which @@ -247,14 +281,17 @@ message DeleteResourcePolicyRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // Name of the resource policy to delete. @@ -314,14 +351,17 @@ message InsertResourcePolicyRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // The ResourcePolicy for this request. @@ -332,58 +372,89 @@ message InsertResourcePolicyRequest { // Request message for ListResourcePolicies. message ListResourcePoliciesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -395,9 +466,11 @@ message ListResourcePoliciesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "region"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; } @@ -419,14 +492,17 @@ message PatchResourcePolicyRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // Id of the resource policy to patch. diff --git a/protos/google/cloud/compute/rollout_plans/v1/rollout_plans.proto b/protos/google/cloud/compute/rollout_plans/v1/rollout_plans.proto new file mode 100644 index 0000000000000..84e8e9cf08c78 --- /dev/null +++ b/protos/google/cloud/compute/rollout_plans/v1/rollout_plans.proto @@ -0,0 +1,252 @@ +// Copyright 2026 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: 20260807 + +syntax = "proto3"; + +package google.cloud.cpp.compute.rollout_plans.v1; + +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_137.proto"; +import "google/cloud/extended_operations.proto"; + +// Service for the rolloutPlans resource. +// https://cloud.google.com/compute/docs/reference/rest/v1/rolloutPlans +service RolloutPlans { + option (google.api.default_host) = "compute.googleapis.com"; + option (google.api.oauth_scopes) = + "https://www.googleapis.com/auth/cloud-platform," + "https://www.googleapis.com/auth/compute," + "https://www.googleapis.com/auth/compute.readonly"; + + // Deletes a RolloutPlan. + // https://cloud.google.com/compute/docs/reference/rest/v1/rolloutPlans/delete + rpc DeleteRolloutPlan(DeleteRolloutPlanRequest) + returns (google.cloud.cpp.compute.v1.Operation) { + option (google.api.http) = { + delete: "/compute/v1/projects/{project}/global/rolloutPlans/{rollout_plan}" + }; + option (google.api.method_signature) = "project,rollout_plan"; + option (google.cloud.operation_service) = "GlobalOperations"; + } + + // Gets details of a single project-scoped RolloutPlan. + // https://cloud.google.com/compute/docs/reference/rest/v1/rolloutPlans/get + rpc GetRolloutPlan(GetRolloutPlanRequest) + returns (google.cloud.cpp.compute.v1.RolloutPlan) { + option (google.api.http) = { + get: "/compute/v1/projects/{project}/global/rolloutPlans/{rollout_plan}" + }; + option (google.api.method_signature) = "project,rollout_plan"; + } + + // Creates a new RolloutPlan in a given project and location. + // https://cloud.google.com/compute/docs/reference/rest/v1/rolloutPlans/insert + rpc InsertRolloutPlan(InsertRolloutPlanRequest) + returns (google.cloud.cpp.compute.v1.Operation) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/global/rolloutPlans" + body: "rollout_plan_resource" + }; + option (google.api.method_signature) = "project,rollout_plan_resource"; + option (google.cloud.operation_service) = "GlobalOperations"; + } + + // Lists RolloutPlans in a given project and location. + // https://cloud.google.com/compute/docs/reference/rest/v1/rolloutPlans/list + rpc ListRolloutPlans(ListRolloutPlansRequest) + returns (google.cloud.cpp.compute.v1.RolloutPlansListResponse) { + option (google.api.http) = { + get: "/compute/v1/projects/{project}/global/rolloutPlans" + }; + option (google.api.method_signature) = "project"; + } +} + +// Request message for DeleteRolloutPlan. +message DeleteRolloutPlanRequest { + // Project ID for this request. + string project = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "project", + json_name = "project" + ]; + + // An optional request ID to identify requests. Specify a unique request ID so + // that if you must retry your request, the server will know to ignore the + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). + optional string request_id = 2 [json_name = "requestId"]; + + // Name of the RolloutPlan resource to delete. + string rollout_plan = 3 + [(google.api.field_behavior) = REQUIRED, json_name = "rolloutPlan"]; +} + +// Request message for GetRolloutPlan. +message GetRolloutPlanRequest { + // Project ID for this request. + string project = 1 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // Name of the persistent rollout plan to return. + string rollout_plan = 2 + [(google.api.field_behavior) = REQUIRED, json_name = "rolloutPlan"]; +} + +// Request message for InsertRolloutPlan. +message InsertRolloutPlanRequest { + // Project ID for this request. + string project = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "project", + json_name = "project" + ]; + + // An optional request ID to identify requests. Specify a unique request ID so + // that if you must retry your request, the server will know to ignore the + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). + optional string request_id = 2 [json_name = "requestId"]; + + // The RolloutPlan for this request. + optional google.cloud.cpp.compute.v1.RolloutPlan rollout_plan_resource = 3 + [json_name = "__json_request_body"]; +} + +// Request message for ListRolloutPlans. +message ListRolloutPlansRequest { + // A filter expression that filters resources listed in the response. Most + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. + optional string filter = 1 [json_name = "filter"]; + + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) + optional uint32 max_results = 2 [json_name = "maxResults"]; + + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or + // `creationTimestamp desc` is supported. + optional string order_by = 3 [json_name = "orderBy"]; + + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. + optional string page_token = 4 [json_name = "pageToken"]; + + // Project ID for this request. + string project = 5 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // Opt-in for partial success behavior which provides partial results in case + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. + optional bool return_partial_success = 6 [json_name = "returnPartialSuccess"]; +} diff --git a/protos/google/cloud/compute/rollouts/v1/rollouts.proto b/protos/google/cloud/compute/rollouts/v1/rollouts.proto new file mode 100644 index 0000000000000..b8d7b9c965497 --- /dev/null +++ b/protos/google/cloud/compute/rollouts/v1/rollouts.proto @@ -0,0 +1,391 @@ +// Copyright 2026 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: 20260807 + +syntax = "proto3"; + +package google.cloud.cpp.compute.rollouts.v1; + +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_136.proto"; +import "google/cloud/extended_operations.proto"; + +// Service for the rollouts resource. +// https://cloud.google.com/compute/docs/reference/rest/v1/rollouts +service Rollouts { + option (google.api.default_host) = "compute.googleapis.com"; + option (google.api.oauth_scopes) = + "https://www.googleapis.com/auth/cloud-platform," + "https://www.googleapis.com/auth/compute," + "https://www.googleapis.com/auth/compute.readonly"; + + // Advances a Rollout to the next wave, or completes it if no waves remain. + // https://cloud.google.com/compute/docs/reference/rest/v1/rollouts/advance + rpc Advance(AdvanceRequest) returns (google.cloud.cpp.compute.v1.Operation) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/global/rollouts/{rollout}/advance" + body: "*" + }; + option (google.api.method_signature) = "project,rollout"; + option (google.cloud.operation_service) = "GlobalOperations"; + } + + // Cancels a Rollout. + // https://cloud.google.com/compute/docs/reference/rest/v1/rollouts/cancel + rpc Cancel(CancelRequest) returns (google.cloud.cpp.compute.v1.Operation) { + option (google.api.http) = { + patch: "/compute/v1/projects/{project}/global/rollouts/{rollout}" + body: "*" + }; + option (google.api.method_signature) = "project,rollout"; + option (google.cloud.operation_service) = "GlobalOperations"; + } + + // Deletes a Rollout. + // https://cloud.google.com/compute/docs/reference/rest/v1/rollouts/delete + rpc DeleteRollout(DeleteRolloutRequest) + returns (google.cloud.cpp.compute.v1.Operation) { + option (google.api.http) = { + delete: "/compute/v1/projects/{project}/global/rollouts/{rollout}" + }; + option (google.api.method_signature) = "project,rollout"; + option (google.cloud.operation_service) = "GlobalOperations"; + } + + // Gets details of a single project-scoped Rollout. + // https://cloud.google.com/compute/docs/reference/rest/v1/rollouts/get + rpc GetRollout(GetRolloutRequest) + returns (google.cloud.cpp.compute.v1.Rollout) { + option (google.api.http) = { + get: "/compute/v1/projects/{project}/global/rollouts/{rollout}" + }; + option (google.api.method_signature) = "project,rollout"; + } + + // Lists Rollouts in a given project and location. + // https://cloud.google.com/compute/docs/reference/rest/v1/rollouts/list + rpc ListRollouts(ListRolloutsRequest) + returns (google.cloud.cpp.compute.v1.RolloutsListResponse) { + option (google.api.http) = { + get: "/compute/v1/projects/{project}/global/rollouts" + }; + option (google.api.method_signature) = "project"; + } + + // Pauses a Rollout. + // https://cloud.google.com/compute/docs/reference/rest/v1/rollouts/pause + rpc Pause(PauseRequest) returns (google.cloud.cpp.compute.v1.Operation) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/global/rollouts/{rollout}/pause" + body: "*" + }; + option (google.api.method_signature) = "project,rollout"; + option (google.cloud.operation_service) = "GlobalOperations"; + } + + // Resumes a Rollout. + // https://cloud.google.com/compute/docs/reference/rest/v1/rollouts/resume + rpc Resume(ResumeRequest) returns (google.cloud.cpp.compute.v1.Operation) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/global/rollouts/{rollout}/resume" + body: "*" + }; + option (google.api.method_signature) = "project,rollout"; + option (google.cloud.operation_service) = "GlobalOperations"; + } +} + +// Request message for Advance. +message AdvanceRequest { + // Required. Wave number of the current wave. + optional string current_wave_number = 1 [json_name = "currentWaveNumber"]; + + // Required. Project ID for this request. + string project = 2 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "project", + json_name = "project" + ]; + + // An optional request ID to identify requests. Specify a unique request ID so + // that if you must retry your request, the server will know to ignore the + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). + optional string request_id = 3 [json_name = "requestId"]; + + // Required. Name of the Rollout resource to advance. + string rollout = 4 + [(google.api.field_behavior) = REQUIRED, json_name = "rollout"]; +} + +// Request message for Cancel. +message CancelRequest { + // Project ID for this request. + string project = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "project", + json_name = "project" + ]; + + // An optional request ID to identify requests. Specify a unique request ID so + // that if you must retry your request, the server will know to ignore the + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). + optional string request_id = 2 [json_name = "requestId"]; + + // Optional. If true, then the ongoing rollout must be rolled back. Else, just + // cancel + // the rollout without taking any further actions. Note that products must + // support at least one of these options, however, it does not need to support + // both. + optional bool rollback = 3 [json_name = "rollback"]; + + // Name of the Rollout resource to cancel. + string rollout = 4 + [(google.api.field_behavior) = REQUIRED, json_name = "rollout"]; +} + +// Request message for DeleteRollout. +message DeleteRolloutRequest { + // Project ID for this request. + string project = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "project", + json_name = "project" + ]; + + // An optional request ID to identify requests. Specify a unique request ID so + // that if you must retry your request, the server will know to ignore the + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). + optional string request_id = 2 [json_name = "requestId"]; + + // Name of the Rollout resource to delete. + string rollout = 3 + [(google.api.field_behavior) = REQUIRED, json_name = "rollout"]; +} + +// Request message for GetRollout. +message GetRolloutRequest { + // Project ID for this request. + string project = 1 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // Name of the persistent rollout to return. + string rollout = 2 + [(google.api.field_behavior) = REQUIRED, json_name = "rollout"]; +} + +// Request message for ListRollouts. +message ListRolloutsRequest { + // A filter expression that filters resources listed in the response. Most + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. + optional string filter = 1 [json_name = "filter"]; + + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) + optional uint32 max_results = 2 [json_name = "maxResults"]; + + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or + // `creationTimestamp desc` is supported. + optional string order_by = 3 [json_name = "orderBy"]; + + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. + optional string page_token = 4 [json_name = "pageToken"]; + + // Project ID for this request. + string project = 5 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // Opt-in for partial success behavior which provides partial results in case + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. + optional bool return_partial_success = 6 [json_name = "returnPartialSuccess"]; +} + +// Request message for Pause. +message PauseRequest { + // The etag of the Rollout. + // If this is provided, the request will only succeed if the etag matches + // the current etag of the Rollout. + optional string etag = 1 [json_name = "etag"]; + + // Required. Project ID for this request. + string project = 2 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "project", + json_name = "project" + ]; + + // An optional request ID to identify requests. Specify a unique request ID so + // that if you must retry your request, the server will know to ignore the + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). + optional string request_id = 3 [json_name = "requestId"]; + + // Required. Name of the Rollout resource to pause. + string rollout = 4 + [(google.api.field_behavior) = REQUIRED, json_name = "rollout"]; +} + +// Request message for Resume. +message ResumeRequest { + // The etag of the Rollout. + // If this is provided, the request will only succeed if the etag matches + // the current etag of the Rollout. + optional string etag = 1 [json_name = "etag"]; + + // Required. Project ID for this request. + string project = 2 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "project", + json_name = "project" + ]; + + // An optional request ID to identify requests. Specify a unique request ID so + // that if you must retry your request, the server will know to ignore the + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). + optional string request_id = 3 [json_name = "requestId"]; + + // Required. Name of the Rollout resource to resume. + string rollout = 4 + [(google.api.field_behavior) = REQUIRED, json_name = "rollout"]; +} diff --git a/protos/google/cloud/compute/routers/v1/routers.proto b/protos/google/cloud/compute/routers/v1/routers.proto index 9828d71b10de1..b07decbb2677f 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: 20250601 +// revision: 20260807 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_013.proto"; import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; import "google/cloud/extended_operations.proto"; // Service for the routers resource. @@ -37,8 +37,10 @@ service Routers { "https://www.googleapis.com/auth/compute," "https://www.googleapis.com/auth/compute.readonly"; - // Retrieves an aggregated list of routers. To prevent failure, Google - // recommends that you set the `returnPartialSuccess` parameter to `true`. + // Retrieves an aggregated list of routers. + // + // To prevent failure, Google recommends that you set the + // `returnPartialSuccess` parameter to `true`. // https://cloud.google.com/compute/docs/reference/rest/v1/routers/aggregatedList rpc AggregatedListRouters(AggregatedListRoutersRequest) returns (google.cloud.cpp.compute.v1.RouterAggregatedList) { @@ -59,6 +61,18 @@ service Routers { option (google.cloud.operation_service) = "RegionOperations"; } + // Deletes Named Set + // https://cloud.google.com/compute/docs/reference/rest/v1/routers/deleteNamedSet + rpc DeleteNamedSet(DeleteNamedSetRequest) + returns (google.cloud.cpp.compute.v1.Operation) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/regions/{region}/routers/{router}/deleteNamedSet" + body: "*" + }; + option (google.api.method_signature) = "project,region,router"; + option (google.cloud.operation_service) = "RegionOperations"; + } + // Deletes Route Policy // https://cloud.google.com/compute/docs/reference/rest/v1/routers/deleteRoutePolicy rpc DeleteRoutePolicy(DeleteRoutePolicyRequest) @@ -80,6 +94,16 @@ service Routers { option (google.api.method_signature) = "project,region,router"; } + // Returns specified Named Set + // https://cloud.google.com/compute/docs/reference/rest/v1/routers/getNamedSet + rpc GetNamedSet(GetNamedSetRequest) + returns (google.cloud.cpp.compute.v1.RoutersGetNamedSetResponse) { + option (google.api.http) = { + get: "/compute/v1/projects/{project}/regions/{region}/routers/{router}/getNamedSet" + }; + option (google.api.method_signature) = "project,region,router"; + } + // Retrieves runtime NAT IP information. // https://cloud.google.com/compute/docs/reference/rest/v1/routers/getNatIpInfo rpc GetNatIpInfo(GetNatIpInfoRequest) @@ -120,8 +144,8 @@ service Routers { option (google.api.method_signature) = "project,region,router"; } - // Creates a Router resource in the specified project and region using the - // data included in the request. + // Creates a Router resource in the specified project and region using + // the data included in the request. // https://cloud.google.com/compute/docs/reference/rest/v1/routers/insert rpc InsertRouter(InsertRouterRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -153,6 +177,17 @@ service Routers { option (google.api.method_signature) = "project,region,router"; } + // Retrieves a list of router named set subresources available to the + // specified project. + // https://cloud.google.com/compute/docs/reference/rest/v1/routers/listNamedSets + rpc ListNamedSets(ListNamedSetsRequest) + returns (google.cloud.cpp.compute.v1.RoutersListNamedSets) { + option (google.api.http) = { + get: "/compute/v1/projects/{project}/regions/{region}/routers/{router}/listNamedSets" + }; + option (google.api.method_signature) = "project,region,router"; + } + // Retrieves a list of router route policy subresources available to the // specified project. // https://cloud.google.com/compute/docs/reference/rest/v1/routers/listRoutePolicies @@ -165,8 +200,9 @@ service Routers { } // 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. + // request. This method supportsPATCH + // semantics and usesJSON merge + // patch format and processing rules. // https://cloud.google.com/compute/docs/reference/rest/v1/routers/patch rpc PatchRouter(PatchRouterRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -179,6 +215,19 @@ service Routers { option (google.cloud.operation_service) = "RegionOperations"; } + // Patches Named Set + // https://cloud.google.com/compute/docs/reference/rest/v1/routers/patchNamedSet + rpc PatchNamedSet(PatchNamedSetRequest) + returns (google.cloud.cpp.compute.v1.Operation) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/regions/{region}/routers/{router}/patchNamedSet" + body: "named_set_resource" + }; + option (google.api.method_signature) = + "project,region,router,named_set_resource"; + option (google.cloud.operation_service) = "RegionOperations"; + } + // Patches Route Policy // https://cloud.google.com/compute/docs/reference/rest/v1/routers/patchRoutePolicy rpc PatchRoutePolicy(PatchRoutePolicyRequest) @@ -192,7 +241,7 @@ service Routers { option (google.cloud.operation_service) = "RegionOperations"; } - // Preview fields auto-generated during router create and update operations. + // Preview fields auto-generated during router create andupdate operations. // Calling this method does NOT create or update the router. // https://cloud.google.com/compute/docs/reference/rest/v1/routers/preview rpc Preview(PreviewRequest) @@ -206,9 +255,10 @@ service Routers { } // 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. + // request. This method conforms toPUT 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. // https://cloud.google.com/compute/docs/reference/rest/v1/routers/update rpc UpdateRouter(UpdateRouterRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -221,6 +271,19 @@ service Routers { option (google.cloud.operation_service) = "RegionOperations"; } + // Updates or creates new Named Set + // https://cloud.google.com/compute/docs/reference/rest/v1/routers/updateNamedSet + rpc UpdateNamedSet(UpdateNamedSetRequest) + returns (google.cloud.cpp.compute.v1.Operation) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/regions/{region}/routers/{router}/updateNamedSet" + body: "named_set_resource" + }; + option (google.api.method_signature) = + "project,region,router,named_set_resource"; + option (google.cloud.operation_service) = "RegionOperations"; + } + // Updates or creates new Route Policy // https://cloud.google.com/compute/docs/reference/rest/v1/routers/updateRoutePolicy rpc UpdateRoutePolicy(UpdateRoutePolicyRequest) @@ -238,37 +301,64 @@ service Routers { // Request message for AggregatedListRouters. message AggregatedListRoutersRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; // Indicates whether every visible scope for each scope type (zone, region, @@ -280,25 +370,29 @@ message AggregatedListRoutersRequest { // will be included. optional bool include_all_scopes = 2 [json_name = "includeAllScopes"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 3 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 4 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 5 [json_name = "pageToken"]; // Project ID for this request. @@ -306,9 +400,11 @@ message AggregatedListRoutersRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; // The Shared VPC service project id or service project number for which @@ -317,6 +413,45 @@ message AggregatedListRoutersRequest { [json_name = "serviceProjectNumber"]; } +// Request message for DeleteNamedSet. +message DeleteNamedSetRequest { + // The Named Set name for this request. Name must conform to RFC1035 + optional string named_set = 1 [json_name = "namedSet"]; + + // Project ID for this request. + string project = 2 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "project", + json_name = "project" + ]; + + // Name of the region for this request. + string region = 3 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "region", + json_name = "region" + ]; + + // An optional request ID to identify requests. Specify a unique request ID so + // that if you must retry your request, the server will know to ignore the + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). + optional string request_id = 4 [json_name = "requestId"]; + + // Name of the Router resource where Named Set is defined. + string router = 5 + [(google.api.field_behavior) = REQUIRED, json_name = "router"]; +} + // Request message for DeleteRoutePolicy. message DeleteRoutePolicyRequest { // The Policy name for this request. Name must conform to RFC1035 @@ -338,14 +473,17 @@ message DeleteRoutePolicyRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; // Name of the Router resource where Route Policy is defined. @@ -371,14 +509,17 @@ message DeleteRouterRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // Name of the Router resource to delete. @@ -386,10 +527,30 @@ message DeleteRouterRequest { [(google.api.field_behavior) = REQUIRED, json_name = "router"]; } +// Request message for GetNamedSet. +message GetNamedSetRequest { + // The Named Set name for this request. Name must conform to RFC1035 + optional string named_set = 1 [json_name = "namedSet"]; + + // Project ID for this request. + string project = 2 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // Name of the region for this request. + string region = 3 + [(google.api.field_behavior) = REQUIRED, json_name = "region"]; + + // Name of the Router resource to query for the named set. The name should + // conform to RFC1035. + string router = 4 + [(google.api.field_behavior) = REQUIRED, json_name = "router"]; +} + // Request message for GetNatIpInfo. message GetNatIpInfoRequest { - // 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. + // 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. optional string nat_name = 1 [json_name = "natName"]; // Project ID for this request. @@ -409,63 +570,94 @@ message GetNatIpInfoRequest { // Request message for GetNatMappingInfo. message GetNatMappingInfoRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // 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. + // 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. optional string nat_name = 3 [json_name = "natName"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 4 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 5 [json_name = "pageToken"]; // Project ID for this request. @@ -477,13 +669,15 @@ message GetNatMappingInfoRequest { [(google.api.field_behavior) = REQUIRED, json_name = "region"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 8 [json_name = "returnPartialSuccess"]; - // Name of the Router resource to query for Nat Mapping information of VM - // endpoints. + // Name of the Router resource to query for Nat Mapping information of + // VM endpoints. string router = 9 [(google.api.field_behavior) = REQUIRED, json_name = "router"]; } @@ -555,14 +749,17 @@ message InsertRouterRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // The Router for this request. @@ -582,62 +779,93 @@ message ListBgpRoutesRequest { optional string destination_prefix = 2 [json_name = "destinationPrefix"]; // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 3 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 4 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 5 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 6 [json_name = "pageToken"]; - // (Required) limit results to the BGP peer with the given name. Name should - // conform to RFC1035. + // (Required) limit results to the BGP peer with the given name. + // Name should conform to RFC1035. optional string peer = 7 [json_name = "peer"]; // When true, the method returns post-policy routes. Otherwise, it returns @@ -653,9 +881,11 @@ message ListBgpRoutesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "region"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 11 [json_name = "returnPartialSuccess"]; @@ -666,67 +896,208 @@ message ListBgpRoutesRequest { // UNSPECIFIED_ROUTE_TYPE: optional string route_type = 12 [json_name = "routeType"]; - // Name or id of the resource for this request. Name should conform to - // RFC1035. + // Name or id of the resource for this request. + // Name should conform to RFC1035. string router = 13 [(google.api.field_behavior) = REQUIRED, json_name = "router"]; } +// Request message for ListNamedSets. +message ListNamedSetsRequest { + // A filter expression that filters resources listed in the response. Most + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. + optional string filter = 1 [json_name = "filter"]; + + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) + optional uint32 max_results = 2 [json_name = "maxResults"]; + + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or + // `creationTimestamp desc` is supported. + optional string order_by = 3 [json_name = "orderBy"]; + + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. + optional string page_token = 4 [json_name = "pageToken"]; + + // Project ID for this request. + string project = 5 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // Name of the region for this request. + string region = 6 + [(google.api.field_behavior) = REQUIRED, json_name = "region"]; + + // Opt-in for partial success behavior which provides partial results in case + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. + optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; + + // Name or id of the resource for this request. + // Name should conform to RFC1035. + string router = 8 + [(google.api.field_behavior) = REQUIRED, json_name = "router"]; +} + // Request message for ListRoutePolicies. message ListRoutePoliciesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -738,13 +1109,15 @@ message ListRoutePoliciesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "region"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; - // Name or id of the resource for this request. Name should conform to - // RFC1035. + // Name or id of the resource for this request. + // Name should conform to RFC1035. string router = 8 [(google.api.field_behavior) = REQUIRED, json_name = "router"]; } @@ -752,58 +1125,89 @@ message ListRoutePoliciesRequest { // Request message for ListRouters. message ListRoutersRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -815,12 +1219,54 @@ message ListRoutersRequest { [(google.api.field_behavior) = REQUIRED, json_name = "region"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; } +// Request message for PatchNamedSet. +message PatchNamedSetRequest { + // The NamedSet for this request. + optional google.cloud.cpp.compute.v1.NamedSet named_set_resource = 1 + [json_name = "__json_request_body"]; + + // Project ID for this request. + string project = 2 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "project", + json_name = "project" + ]; + + // Name of the region for this request. + string region = 3 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "region", + json_name = "region" + ]; + + // An optional request ID to identify requests. Specify a unique request ID so + // that if you must retry your request, the server will know to ignore the + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). + optional string request_id = 4 [json_name = "requestId"]; + + // Name of the Router resource where Named Set is defined. + string router = 5 + [(google.api.field_behavior) = REQUIRED, json_name = "router"]; +} + // Request message for PatchRoutePolicy. message PatchRoutePolicyRequest { // Project ID for this request. @@ -839,14 +1285,17 @@ message PatchRoutePolicyRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // The RoutePolicy for this request. @@ -876,14 +1325,17 @@ message PatchRouterRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // Name of the Router resource to patch. @@ -914,6 +1366,46 @@ message PreviewRequest { [json_name = "__json_request_body"]; } +// Request message for UpdateNamedSet. +message UpdateNamedSetRequest { + // The NamedSet for this request. + optional google.cloud.cpp.compute.v1.NamedSet named_set_resource = 1 + [json_name = "__json_request_body"]; + + // Project ID for this request. + string project = 2 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "project", + json_name = "project" + ]; + + // Name of the region for this request. + string region = 3 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "region", + json_name = "region" + ]; + + // An optional request ID to identify requests. Specify a unique request ID so + // that if you must retry your request, the server will know to ignore the + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). + optional string request_id = 4 [json_name = "requestId"]; + + // Name of the Router resource where Named Set is defined. + string router = 5 + [(google.api.field_behavior) = REQUIRED, json_name = "router"]; +} + // Request message for UpdateRoutePolicy. message UpdateRoutePolicyRequest { // Project ID for this request. @@ -932,14 +1424,17 @@ message UpdateRoutePolicyRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // The RoutePolicy for this request. @@ -969,14 +1464,17 @@ message UpdateRouterRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // Name of the Router resource to update. diff --git a/protos/google/cloud/compute/routes/v1/routes.proto b/protos/google/cloud/compute/routes/v1/routes.proto index 22bdce53c75b5..8fd9e4f14168d 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: 20250601 +// revision: 20260807 syntax = "proto3"; @@ -24,9 +24,10 @@ 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_016.proto"; -import "google/cloud/compute/v1/internal/common_115.proto"; -import "google/cloud/compute/v1/internal/common_116.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_138.proto"; +import "google/cloud/compute/v1/internal/common_139.proto"; +import "google/cloud/compute/v1/internal/common_171.proto"; import "google/cloud/extended_operations.proto"; // Service for the routes resource. @@ -80,6 +81,18 @@ service Routes { }; option (google.api.method_signature) = "project"; } + + // Returns permissions that a caller has on the specified resource. + // https://cloud.google.com/compute/docs/reference/rest/v1/routes/testIamPermissions + rpc TestIamPermissions(TestIamPermissionsRequest) + returns (google.cloud.cpp.compute.v1.TestPermissionsResponse) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/global/routes/{resource}/testIamPermissions" + body: "test_permissions_request_resource" + }; + option (google.api.method_signature) = + "project,resource,test_permissions_request_resource"; + } } // Request message for DeleteRoute. @@ -93,14 +106,17 @@ message DeleteRouteRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 2 [json_name = "requestId"]; // Name of the Route resource to delete. @@ -130,14 +146,17 @@ message InsertRouteRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 2 [json_name = "requestId"]; // The Route for this request. @@ -148,58 +167,89 @@ message InsertRouteRequest { // Request message for ListRoutes. message ListRoutesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -207,8 +257,25 @@ message ListRoutesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 6 [json_name = "returnPartialSuccess"]; } + +// Request message for TestIamPermissions. +message TestIamPermissionsRequest { + // Project ID for this request. + string project = 1 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // Name or id of the resource for this request. + string resource = 2 + [(google.api.field_behavior) = REQUIRED, json_name = "resource"]; + + // The TestPermissionsRequest for this request. + optional google.cloud.cpp.compute.v1.TestPermissionsRequest + test_permissions_request_resource = 3 [json_name = "__json_request_body"]; +} 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 409d6415550f0..67fada1e0a1fe 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: 20250601 +// revision: 20260807 syntax = "proto3"; @@ -24,10 +24,11 @@ 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_016.proto"; -import "google/cloud/compute/v1/internal/common_046.proto"; -import "google/cloud/compute/v1/internal/common_094.proto"; -import "google/cloud/compute/v1/internal/common_117.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_056.proto"; +import "google/cloud/compute/v1/internal/common_111.proto"; +import "google/cloud/compute/v1/internal/common_140.proto"; +import "google/cloud/compute/v1/internal/common_141.proto"; import "google/cloud/extended_operations.proto"; // Service for the securityPolicies resource. @@ -52,8 +53,10 @@ service SecurityPolicies { } // 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`. + // available to the specified project. + // + // To prevent failure, Google recommends that you set the + // `returnPartialSuccess` parameter to `true`. // https://cloud.google.com/compute/docs/reference/rest/v1/securityPolicies/aggregatedList rpc AggregatedListSecurityPolicies(AggregatedListSecurityPoliciesRequest) returns (google.cloud.cpp.compute.v1.SecurityPoliciesAggregatedList) { @@ -172,8 +175,9 @@ service SecurityPolicies { option (google.cloud.operation_service) = "GlobalOperations"; } - // Sets the labels on a security policy. To learn more about labels, read the - // Labeling Resources documentation. + // Sets the labels on a security policy. To learn more about labels, + // read the Labeling Resources + // documentation. // https://cloud.google.com/compute/docs/reference/rest/v1/securityPolicies/setLabels rpc SetLabels(SetLabelsRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -211,37 +215,64 @@ message AddRuleRequest { // Request message for AggregatedListSecurityPolicies. message AggregatedListSecurityPoliciesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; // Indicates whether every visible scope for each scope type (zone, region, @@ -253,25 +284,29 @@ message AggregatedListSecurityPoliciesRequest { // will be included. optional bool include_all_scopes = 2 [json_name = "includeAllScopes"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 3 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 4 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 5 [json_name = "pageToken"]; // Name of the project scoping this request. @@ -279,9 +314,11 @@ message AggregatedListSecurityPoliciesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; // The Shared VPC service project id or service project number for which @@ -301,14 +338,17 @@ message DeleteSecurityPolicyRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 2 [json_name = "requestId"]; // Name of the security policy to delete. @@ -352,14 +392,17 @@ message InsertSecurityPolicyRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 2 [json_name = "requestId"]; // The SecurityPolicy for this request. @@ -373,58 +416,89 @@ message InsertSecurityPolicyRequest { // Request message for ListPreconfiguredExpressionSets. message ListPreconfiguredExpressionSetsRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -432,67 +506,100 @@ message ListPreconfiguredExpressionSetsRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 6 [json_name = "returnPartialSuccess"]; } // Request message for ListSecurityPolicies. message ListSecurityPoliciesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -500,9 +607,11 @@ message ListSecurityPoliciesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 6 [json_name = "returnPartialSuccess"]; } @@ -544,14 +653,17 @@ message PatchSecurityPolicyRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 2 [json_name = "requestId"]; // Name of the security policy to update. 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 c114c9aba3cac..6325bc0e9b36b 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: 20250601 +// revision: 20260807 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_007.proto"; -import "google/cloud/compute/v1/internal/common_016.proto"; -import "google/cloud/compute/v1/internal/common_108.proto"; -import "google/cloud/compute/v1/internal/common_119.proto"; -import "google/cloud/compute/v1/internal/common_145.proto"; +import "google/cloud/compute/v1/internal/common_009.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_126.proto"; +import "google/cloud/compute/v1/internal/common_143.proto"; +import "google/cloud/compute/v1/internal/common_171.proto"; import "google/cloud/extended_operations.proto"; // Service for the serviceAttachments resource. @@ -40,9 +40,11 @@ service ServiceAttachments { "https://www.googleapis.com/auth/compute," "https://www.googleapis.com/auth/compute.readonly"; - // 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`. + // 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`. // https://cloud.google.com/compute/docs/reference/rest/v1/serviceAttachments/aggregatedList rpc AggregatedListServiceAttachments(AggregatedListServiceAttachmentsRequest) returns (google.cloud.cpp.compute.v1.ServiceAttachmentAggregatedList) { @@ -109,8 +111,9 @@ service ServiceAttachments { } // 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. + // the request. This method supports PATCH + // semantics and usesJSON merge + // patch format and processing rules. // https://cloud.google.com/compute/docs/reference/rest/v1/serviceAttachments/patch rpc PatchServiceAttachment(PatchServiceAttachmentRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -123,8 +126,8 @@ service ServiceAttachments { option (google.cloud.operation_service) = "RegionOperations"; } - // Sets the access control policy on the specified resource. Replaces any - // existing policy. + // Sets the access control policy on the specified resource. + // Replaces any existing policy. // https://cloud.google.com/compute/docs/reference/rest/v1/serviceAttachments/setIamPolicy rpc SetIamPolicy(SetIamPolicyRequest) returns (google.cloud.cpp.compute.v1.Policy) { @@ -152,37 +155,64 @@ service ServiceAttachments { // Request message for AggregatedListServiceAttachments. message AggregatedListServiceAttachmentsRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; // Indicates whether every visible scope for each scope type (zone, region, @@ -194,25 +224,29 @@ message AggregatedListServiceAttachmentsRequest { // will be included. optional bool include_all_scopes = 2 [json_name = "includeAllScopes"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 3 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 4 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 5 [json_name = "pageToken"]; // Name of the project scoping this request. @@ -220,9 +254,11 @@ message AggregatedListServiceAttachmentsRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; // The Shared VPC service project id or service project number for which @@ -249,14 +285,17 @@ message DeleteServiceAttachmentRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // Name of the ServiceAttachment resource to delete. @@ -296,6 +335,9 @@ message GetServiceAttachmentRequest { // Name of the ServiceAttachment resource to return. string service_attachment = 3 [(google.api.field_behavior) = REQUIRED, json_name = "serviceAttachment"]; + + // Indicates whether NAT IPs should be included in the response. + optional bool show_nat_ips = 4 [json_name = "showNatIps"]; } // Request message for InsertServiceAttachment. @@ -316,14 +358,17 @@ message InsertServiceAttachmentRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // The ServiceAttachment for this request. @@ -334,58 +379,89 @@ message InsertServiceAttachmentRequest { // Request message for ListServiceAttachments. message ListServiceAttachmentsRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -397,9 +473,11 @@ message ListServiceAttachmentsRequest { [(google.api.field_behavior) = REQUIRED, json_name = "region"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; } @@ -421,14 +499,17 @@ message PatchServiceAttachmentRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // The resource id of the ServiceAttachment to patch. It should conform to 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 2cfecb42c42c5..fe84a5e4caea3 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: 20250601 +// revision: 20260807 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_016.proto"; -import "google/cloud/compute/v1/internal/common_124.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_148.proto"; import "google/cloud/extended_operations.proto"; // Service for the snapshotSettings resource. @@ -79,14 +79,17 @@ message PatchSnapshotSettingsRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 2 [json_name = "requestId"]; // The SnapshotSettings for this request. diff --git a/protos/google/cloud/compute/snapshots/v1/snapshots.proto b/protos/google/cloud/compute/snapshots/v1/snapshots.proto index a9c597b74caa8..78cf58ee81505 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: 20250601 +// revision: 20260807 syntax = "proto3"; @@ -24,13 +24,14 @@ 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_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_047.proto"; -import "google/cloud/compute/v1/internal/common_122.proto"; -import "google/cloud/compute/v1/internal/common_123.proto"; -import "google/cloud/compute/v1/internal/common_145.proto"; +import "google/cloud/compute/v1/internal/common_009.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_056.proto"; +import "google/cloud/compute/v1/internal/common_057.proto"; +import "google/cloud/compute/v1/internal/common_146.proto"; +import "google/cloud/compute/v1/internal/common_147.proto"; +import "google/cloud/compute/v1/internal/common_149.proto"; +import "google/cloud/compute/v1/internal/common_171.proto"; import "google/cloud/extended_operations.proto"; // Service for the snapshots resource. @@ -42,11 +43,14 @@ service Snapshots { "https://www.googleapis.com/auth/compute," "https://www.googleapis.com/auth/compute.readonly"; - // 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. + // 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, seeDeleting + // snapshots. // https://cloud.google.com/compute/docs/reference/rest/v1/snapshots/delete rpc DeleteSnapshot(DeleteSnapshotRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -78,10 +82,11 @@ service Snapshots { option (google.api.method_signature) = "project,resource"; } - // 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. + // 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. // https://cloud.google.com/compute/docs/reference/rest/v1/snapshots/insert rpc InsertSnapshot(InsertSnapshotRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -93,8 +98,8 @@ service Snapshots { option (google.cloud.operation_service) = "GlobalOperations"; } - // Retrieves the list of Snapshot resources contained within the specified - // project. + // Retrieves the list of Snapshot resources contained within + // the specified project. // https://cloud.google.com/compute/docs/reference/rest/v1/snapshots/list rpc ListSnapshots(ListSnapshotsRequest) returns (google.cloud.cpp.compute.v1.SnapshotList) { @@ -104,8 +109,8 @@ service Snapshots { option (google.api.method_signature) = "project"; } - // Sets the access control policy on the specified resource. Replaces any - // existing policy. + // Sets the access control policy on the specified resource. + // Replaces any existing policy. // https://cloud.google.com/compute/docs/reference/rest/v1/snapshots/setIamPolicy rpc SetIamPolicy(SetIamPolicyRequest) returns (google.cloud.cpp.compute.v1.Policy) { @@ -117,8 +122,8 @@ service Snapshots { "project,resource,global_set_policy_request_resource"; } - // Sets the labels on a snapshot. To learn more about labels, read the - // Labeling Resources documentation. + // Sets the labels on a snapshot. To learn more about labels, read theLabeling + // Resources documentation. // https://cloud.google.com/compute/docs/reference/rest/v1/snapshots/setLabels rpc SetLabels(SetLabelsRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -142,6 +147,20 @@ service Snapshots { option (google.api.method_signature) = "project,resource,test_permissions_request_resource"; } + + // Rotates the customer-managed + // encryption key to the latest version for the specified snapshot. + // https://cloud.google.com/compute/docs/reference/rest/v1/snapshots/updateKmsKey + rpc UpdateKmsKey(UpdateKmsKeyRequest) + returns (google.cloud.cpp.compute.v1.Operation) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/global/snapshots/{snapshot}/updateKmsKey" + body: "snapshot_update_kms_key_request_resource" + }; + option (google.api.method_signature) = + "project,snapshot,snapshot_update_kms_key_request_resource"; + option (google.cloud.operation_service) = "GlobalOperations"; + } } // Request message for DeleteSnapshot. @@ -155,14 +174,17 @@ message DeleteSnapshotRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 2 [json_name = "requestId"]; // Name of the Snapshot resource to delete. @@ -207,14 +229,17 @@ message InsertSnapshotRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 2 [json_name = "requestId"]; // The Snapshot for this request. @@ -225,58 +250,89 @@ message InsertSnapshotRequest { // Request message for ListSnapshots. message ListSnapshotsRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -284,9 +340,11 @@ message ListSnapshotsRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 6 [json_name = "returnPartialSuccess"]; } @@ -339,3 +397,37 @@ message TestIamPermissionsRequest { optional google.cloud.cpp.compute.v1.TestPermissionsRequest test_permissions_request_resource = 3 [json_name = "__json_request_body"]; } + +// Request message for UpdateKmsKey. +message UpdateKmsKeyRequest { + // Project ID for this request. + string project = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "project", + json_name = "project" + ]; + + // An optional request ID to identify requests. Specify a unique request ID so + // that if you must retry your request, the server will know to ignore the + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). + optional string request_id = 2 [json_name = "requestId"]; + + // Name of the snapshot resource to update. Should conform to RFC1035. + string snapshot = 3 + [(google.api.field_behavior) = REQUIRED, json_name = "snapshot"]; + + // The SnapshotUpdateKmsKeyRequest for this request. + optional google.cloud.cpp.compute.v1.SnapshotUpdateKmsKeyRequest + snapshot_update_kms_key_request_resource = 4 + [json_name = "__json_request_body"]; +} 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 85dd39105c83e..30e4ee0c4e18a 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: 20250601 +// revision: 20260807 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_016.proto"; -import "google/cloud/compute/v1/internal/common_125.proto"; -import "google/cloud/compute/v1/internal/common_126.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_150.proto"; +import "google/cloud/compute/v1/internal/common_151.proto"; import "google/cloud/extended_operations.proto"; // Service for the sslCertificates resource. @@ -39,8 +39,10 @@ service SslCertificates { "https://www.googleapis.com/auth/compute.readonly"; // 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`. + // available to the specified project. + // + // To prevent failure, Google recommends that you set the + // `returnPartialSuccess` parameter to `true`. // https://cloud.google.com/compute/docs/reference/rest/v1/sslCertificates/aggregatedList rpc AggregatedListSslCertificates(AggregatedListSslCertificatesRequest) returns (google.cloud.cpp.compute.v1.SslCertificateAggregatedList) { @@ -99,37 +101,64 @@ service SslCertificates { // Request message for AggregatedListSslCertificates. message AggregatedListSslCertificatesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; // Indicates whether every visible scope for each scope type (zone, region, @@ -141,25 +170,29 @@ message AggregatedListSslCertificatesRequest { // will be included. optional bool include_all_scopes = 2 [json_name = "includeAllScopes"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 3 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 4 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 5 [json_name = "pageToken"]; // Name of the project scoping this request. @@ -167,9 +200,11 @@ message AggregatedListSslCertificatesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; // The Shared VPC service project id or service project number for which @@ -189,14 +224,17 @@ message DeleteSslCertificateRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 2 [json_name = "requestId"]; // Name of the SslCertificate resource to delete. @@ -226,14 +264,17 @@ message InsertSslCertificateRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 2 [json_name = "requestId"]; // The SslCertificate for this request. @@ -244,58 +285,89 @@ message InsertSslCertificateRequest { // Request message for ListSslCertificates. message ListSslCertificatesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -303,8 +375,10 @@ message ListSslCertificatesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 6 [json_name = "returnPartialSuccess"]; } 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 cab21c39f6a11..60f49b0b7dcae 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: 20250601 +// revision: 20260807 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_016.proto"; -import "google/cloud/compute/v1/internal/common_127.proto"; -import "google/cloud/compute/v1/internal/common_128.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_152.proto"; +import "google/cloud/compute/v1/internal/common_153.proto"; import "google/cloud/extended_operations.proto"; // Service for the sslPolicies resource. @@ -39,8 +39,10 @@ service SslPolicies { "https://www.googleapis.com/auth/compute.readonly"; // 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`. + // available to the specified project. + // + // To prevent failure, Google recommends that you set the + // `returnPartialSuccess` parameter to `true`. // https://cloud.google.com/compute/docs/reference/rest/v1/sslPolicies/aggregatedList rpc AggregatedListSslPolicies(AggregatedListSslPoliciesRequest) returns (google.cloud.cpp.compute.v1.SslPoliciesAggregatedList) { @@ -124,37 +126,64 @@ service SslPolicies { // Request message for AggregatedListSslPolicies. message AggregatedListSslPoliciesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; // Indicates whether every visible scope for each scope type (zone, region, @@ -166,25 +195,29 @@ message AggregatedListSslPoliciesRequest { // will be included. optional bool include_all_scopes = 2 [json_name = "includeAllScopes"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 3 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 4 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 5 [json_name = "pageToken"]; // Name of the project scoping this request. @@ -192,9 +225,11 @@ message AggregatedListSslPoliciesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; // The Shared VPC service project id or service project number for which @@ -214,14 +249,17 @@ message DeleteSslPolicyRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 2 [json_name = "requestId"]; // Name of the SSL policy to delete. The name must be 1-63 characters long, @@ -253,14 +291,17 @@ message InsertSslPolicyRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 2 [json_name = "requestId"]; // The SslPolicy for this request. @@ -271,58 +312,89 @@ message InsertSslPolicyRequest { // Request message for ListAvailableFeatures. message ListAvailableFeaturesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -330,67 +402,100 @@ message ListAvailableFeaturesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 6 [json_name = "returnPartialSuccess"]; } // Request message for ListSslPolicies. message ListSslPoliciesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -398,9 +503,11 @@ message ListSslPoliciesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 6 [json_name = "returnPartialSuccess"]; } @@ -415,14 +522,17 @@ message PatchSslPolicyRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 2 [json_name = "requestId"]; // Name of the SSL policy to update. The name must be 1-63 characters long, 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 3378b5fd6f9a5..d29adad9d3d7b 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: 20250601 +// revision: 20260807 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_131.proto"; +import "google/cloud/compute/v1/internal/common_157.proto"; // Service for the storagePoolTypes resource. // https://cloud.google.com/compute/docs/reference/rest/v1/storagePoolTypes @@ -35,9 +35,10 @@ service StoragePoolTypes { "https://www.googleapis.com/auth/compute," "https://www.googleapis.com/auth/compute.readonly"; - // Retrieves an aggregated list of storage pool types. To prevent failure, - // Google recommends that you set the `returnPartialSuccess` parameter to - // `true`. + // Retrieves an aggregated list of storage pool types. + // + // To prevent failure, Google recommends that you set the + // `returnPartialSuccess` parameter to `true`. // https://cloud.google.com/compute/docs/reference/rest/v1/storagePoolTypes/aggregatedList rpc AggregatedListStoragePoolTypes(AggregatedListStoragePoolTypesRequest) returns (google.cloud.cpp.compute.v1.StoragePoolTypeAggregatedList) { @@ -57,7 +58,8 @@ service StoragePoolTypes { option (google.api.method_signature) = "project,zone,storage_pool_type"; } - // Retrieves a list of storage pool types available to the specified project. + // Retrieves a list of storage pool types available to the specified + // project. // https://cloud.google.com/compute/docs/reference/rest/v1/storagePoolTypes/list rpc ListStoragePoolTypes(ListStoragePoolTypesRequest) returns (google.cloud.cpp.compute.v1.StoragePoolTypeList) { @@ -71,37 +73,64 @@ service StoragePoolTypes { // Request message for AggregatedListStoragePoolTypes. message AggregatedListStoragePoolTypesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; // Indicates whether every visible scope for each scope type (zone, region, @@ -113,25 +142,29 @@ message AggregatedListStoragePoolTypesRequest { // will be included. optional bool include_all_scopes = 2 [json_name = "includeAllScopes"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 3 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 4 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 5 [json_name = "pageToken"]; // Project ID for this request. @@ -139,9 +172,11 @@ message AggregatedListStoragePoolTypesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; // The Shared VPC service project id or service project number for which @@ -167,58 +202,89 @@ message GetStoragePoolTypeRequest { // Request message for ListStoragePoolTypes. message ListStoragePoolTypesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -226,9 +292,11 @@ message ListStoragePoolTypesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 6 [json_name = "returnPartialSuccess"]; // The name of the zone for this request. 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 2cdcf3019d8d8..3f52bf0590188 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: 20250601 +// revision: 20260807 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_007.proto"; -import "google/cloud/compute/v1/internal/common_016.proto"; -import "google/cloud/compute/v1/internal/common_130.proto"; -import "google/cloud/compute/v1/internal/common_145.proto"; -import "google/cloud/compute/v1/internal/common_152.proto"; +import "google/cloud/compute/v1/internal/common_009.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_155.proto"; +import "google/cloud/compute/v1/internal/common_171.proto"; +import "google/cloud/compute/v1/internal/common_182.proto"; import "google/cloud/extended_operations.proto"; // Service for the storagePools resource. @@ -40,8 +40,10 @@ service StoragePools { "https://www.googleapis.com/auth/compute," "https://www.googleapis.com/auth/compute.readonly"; - // Retrieves an aggregated list of storage pools. To prevent failure, Google - // recommends that you set the `returnPartialSuccess` parameter to `true`. + // Retrieves an aggregated list of storage pools. + // + // To prevent failure, Google recommends that you set the + // `returnPartialSuccess` parameter to `true`. // https://cloud.google.com/compute/docs/reference/rest/v1/storagePools/aggregatedList rpc AggregatedListStoragePools(AggregatedListStoragePoolsRequest) returns (google.cloud.cpp.compute.v1.StoragePoolAggregatedList) { @@ -51,10 +53,11 @@ service StoragePools { option (google.api.method_signature) = "project"; } - // 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. + // 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. // https://cloud.google.com/compute/docs/reference/rest/v1/storagePools/delete rpc DeleteStoragePool(DeleteStoragePoolRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -65,8 +68,8 @@ service StoragePools { option (google.cloud.operation_service) = "ZoneOperations"; } - // Returns a specified storage pool. Gets a list of available storage pools by - // making a list() request. + // Returns a specified storage pool. Gets a list of available + // storage pools by making a list() request. // https://cloud.google.com/compute/docs/reference/rest/v1/storagePools/get rpc GetStoragePool(GetStoragePoolRequest) returns (google.cloud.cpp.compute.v1.StoragePool) { @@ -87,8 +90,8 @@ service StoragePools { option (google.api.method_signature) = "project,zone,resource"; } - // Creates a storage pool in the specified project using the data in the - // request. + // Creates a storage pool in the specified project using the data + // in the request. // https://cloud.google.com/compute/docs/reference/rest/v1/storagePools/insert rpc InsertStoragePool(InsertStoragePoolRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -100,7 +103,8 @@ service StoragePools { option (google.cloud.operation_service) = "ZoneOperations"; } - // Retrieves a list of storage pools contained within the specified zone. + // Retrieves a list of storage pools contained within + // the specified zone. // https://cloud.google.com/compute/docs/reference/rest/v1/storagePools/list rpc ListStoragePools(ListStoragePoolsRequest) returns (google.cloud.cpp.compute.v1.StoragePoolList) { @@ -120,8 +124,8 @@ service StoragePools { option (google.api.method_signature) = "project,zone,storage_pool"; } - // Sets the access control policy on the specified resource. Replaces any - // existing policy. + // Sets the access control policy on the specified resource. + // Replaces any existing policy. // https://cloud.google.com/compute/docs/reference/rest/v1/storagePools/setIamPolicy rpc SetIamPolicy(SetIamPolicyRequest) returns (google.cloud.cpp.compute.v1.Policy) { @@ -146,8 +150,8 @@ service StoragePools { } // 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: + // 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. // https://cloud.google.com/compute/docs/reference/rest/v1/storagePools/update @@ -166,37 +170,64 @@ service StoragePools { // Request message for AggregatedListStoragePools. message AggregatedListStoragePoolsRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; // Indicates whether every visible scope for each scope type (zone, region, @@ -208,25 +239,29 @@ message AggregatedListStoragePoolsRequest { // will be included. optional bool include_all_scopes = 2 [json_name = "includeAllScopes"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 3 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 4 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 5 [json_name = "pageToken"]; // Project ID for this request. @@ -234,9 +269,11 @@ message AggregatedListStoragePoolsRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; // The Shared VPC service project id or service project number for which @@ -256,14 +293,17 @@ message DeleteStoragePoolRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 2 [json_name = "requestId"]; // Name of the storage pool to delete. @@ -321,14 +361,17 @@ message InsertStoragePoolRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 2 [json_name = "requestId"]; // The StoragePool for this request. @@ -346,58 +389,89 @@ message InsertStoragePoolRequest { // Request message for ListDisks. message ListDisksRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -405,9 +479,11 @@ message ListDisksRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 6 [json_name = "returnPartialSuccess"]; // Name of the storage pool to list disks of. @@ -421,58 +497,89 @@ message ListDisksRequest { // Request message for ListStoragePools. message ListStoragePoolsRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -480,9 +587,11 @@ message ListStoragePoolsRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 6 [json_name = "returnPartialSuccess"]; // The name of the zone for this request. @@ -536,14 +645,17 @@ message UpdateStoragePoolRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 2 [json_name = "requestId"]; // The storagePool name for this request. diff --git a/protos/google/cloud/compute/subnetworks/v1/subnetworks.proto b/protos/google/cloud/compute/subnetworks/v1/subnetworks.proto index 03d697d905025..caa343db211d4 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: 20250601 +// revision: 20260807 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_007.proto"; -import "google/cloud/compute/v1/internal/common_016.proto"; -import "google/cloud/compute/v1/internal/common_108.proto"; -import "google/cloud/compute/v1/internal/common_132.proto"; -import "google/cloud/compute/v1/internal/common_145.proto"; +import "google/cloud/compute/v1/internal/common_009.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_126.proto"; +import "google/cloud/compute/v1/internal/common_158.proto"; +import "google/cloud/compute/v1/internal/common_171.proto"; import "google/cloud/extended_operations.proto"; // Service for the subnetworks resource. @@ -40,8 +40,10 @@ service Subnetworks { "https://www.googleapis.com/auth/compute," "https://www.googleapis.com/auth/compute.readonly"; - // Retrieves an aggregated list of subnetworks. To prevent failure, Google - // recommends that you set the `returnPartialSuccess` parameter to `true`. + // Retrieves an aggregated list of subnetworks. + // + // To prevent failure, Google recommends that you set the + // `returnPartialSuccess` parameter to `true`. // https://cloud.google.com/compute/docs/reference/rest/v1/subnetworks/aggregatedList rpc AggregatedListSubnetworks(AggregatedListSubnetworksRequest) returns (google.cloud.cpp.compute.v1.SubnetworkAggregatedList) { @@ -96,8 +98,8 @@ service Subnetworks { option (google.api.method_signature) = "project,region,resource"; } - // Creates a subnetwork in the specified project using the data included in - // the request. + // Creates a subnetwork in the specified project using the data + // included in the request. // https://cloud.google.com/compute/docs/reference/rest/v1/subnetworks/insert rpc InsertSubnetwork(InsertSubnetworkRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -109,7 +111,8 @@ service Subnetworks { option (google.cloud.operation_service) = "RegionOperations"; } - // Retrieves a list of subnetworks available to the specified project. + // Retrieves a list of subnetworks available to the specified + // project. // https://cloud.google.com/compute/docs/reference/rest/v1/subnetworks/list rpc ListSubnetworks(ListSubnetworksRequest) returns (google.cloud.cpp.compute.v1.SubnetworkList) { @@ -130,8 +133,9 @@ service Subnetworks { } // 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 + // 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. // https://cloud.google.com/compute/docs/reference/rest/v1/subnetworks/patch rpc PatchSubnetwork(PatchSubnetworkRequest) @@ -145,8 +149,8 @@ service Subnetworks { option (google.cloud.operation_service) = "RegionOperations"; } - // Sets the access control policy on the specified resource. Replaces any - // existing policy. + // Sets the access control policy on the specified resource. + // Replaces any existing policy. // https://cloud.google.com/compute/docs/reference/rest/v1/subnetworks/setIamPolicy rpc SetIamPolicy(SetIamPolicyRequest) returns (google.cloud.cpp.compute.v1.Policy) { @@ -188,37 +192,64 @@ service Subnetworks { // Request message for AggregatedListSubnetworks. message AggregatedListSubnetworksRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; // Indicates whether every visible scope for each scope type (zone, region, @@ -230,25 +261,29 @@ message AggregatedListSubnetworksRequest { // will be included. optional bool include_all_scopes = 2 [json_name = "includeAllScopes"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 3 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 4 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 5 [json_name = "pageToken"]; // Project ID for this request. @@ -256,15 +291,26 @@ message AggregatedListSubnetworksRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; // The Shared VPC service project id or service project number for which // aggregated list request is invoked for subnetworks list-usable api. optional string service_project_number = 8 [json_name = "serviceProjectNumber"]; + + // Defines the extra views returned back in the subnetwork resource. + // Supported values: + // + // - WITH_UTILIZATION: Utilization data is included in the + // response. + // DEFAULT: + // WITH_UTILIZATION: Utilization data is included in the response. + optional string views = 9 [json_name = "views"]; } // Request message for DeleteSubnetwork. @@ -285,14 +331,17 @@ message DeleteSubnetworkRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // Name of the Subnetwork resource to delete. @@ -318,14 +367,17 @@ message ExpandIpCidrRangeRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // Name of the Subnetwork resource to update. @@ -370,6 +422,15 @@ message GetSubnetworkRequest { // Name of the Subnetwork resource to return. string subnetwork = 3 [(google.api.field_behavior) = REQUIRED, json_name = "subnetwork"]; + + // Defines the extra views returned back in the subnetwork resource. + // Supported values: + // + // - WITH_UTILIZATION: Utilization data is included in the + // response. + // DEFAULT: + // WITH_UTILIZATION: Utilization data is included in the response. + optional string views = 4 [json_name = "views"]; } // Request message for InsertSubnetwork. @@ -390,14 +451,17 @@ message InsertSubnetworkRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // The Subnetwork for this request. @@ -408,58 +472,89 @@ message InsertSubnetworkRequest { // Request message for ListSubnetworks. message ListSubnetworksRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -471,67 +566,109 @@ message ListSubnetworksRequest { [(google.api.field_behavior) = REQUIRED, json_name = "region"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; + + // Defines the extra views returned back in the subnetwork resource. + // Supported values: + // + // - WITH_UTILIZATION: Utilization data is included in the + // response. + // DEFAULT: + // WITH_UTILIZATION: Utilization data is included in the response. + optional string views = 8 [json_name = "views"]; } // Request message for ListUsable. message ListUsableRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -539,22 +676,30 @@ message ListUsableRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 6 [json_name = "returnPartialSuccess"]; + + // The project id or project number in which the subnetwork is intended to be + // used. Only applied for Shared VPC. See [Shared VPC + // documentation](https://cloud.google.com/vpc/docs/shared-vpc/) + optional string service_project = 7 [json_name = "serviceProject"]; } // Request message for PatchSubnetwork. message PatchSubnetworkRequest { // 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. + // 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. optional int32 drain_timeout_seconds = 1 [json_name = "drainTimeoutSeconds"]; // Project ID for this request. @@ -573,14 +718,17 @@ message PatchSubnetworkRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; // Name of the Subnetwork resource to patch. @@ -630,14 +778,17 @@ message SetPrivateIpGoogleAccessRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // Name of the Subnetwork 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 dff34ad9432a0..dd9507f22eb61 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: 20250601 +// revision: 20260807 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_016.proto"; -import "google/cloud/compute/v1/internal/common_133.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_159.proto"; import "google/cloud/extended_operations.proto"; // Service for the targetGrpcProxies resource. @@ -58,8 +58,8 @@ service TargetGrpcProxies { option (google.api.method_signature) = "project,target_grpc_proxy"; } - // Creates a TargetGrpcProxy in the specified project in the given scope using - // the parameters that are included in the request. + // Creates a TargetGrpcProxy in the specified project in the given scope + // using the parameters that are included in the request. // https://cloud.google.com/compute/docs/reference/rest/v1/targetGrpcProxies/insert rpc InsertTargetGrpcProxy(InsertTargetGrpcProxyRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -82,8 +82,9 @@ service TargetGrpcProxies { } // 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. + // the request. This method supports PATCH + // semantics and usesJSON merge + // patch format and processing rules. // https://cloud.google.com/compute/docs/reference/rest/v1/targetGrpcProxies/patch rpc PatchTargetGrpcProxy(PatchTargetGrpcProxyRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -108,14 +109,17 @@ message DeleteTargetGrpcProxyRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 2 [json_name = "requestId"]; // Name of the TargetGrpcProxy resource to delete. @@ -145,14 +149,17 @@ message InsertTargetGrpcProxyRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 2 [json_name = "requestId"]; // The TargetGrpcProxy for this request. @@ -163,58 +170,89 @@ message InsertTargetGrpcProxyRequest { // Request message for ListTargetGrpcProxies. message ListTargetGrpcProxiesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -222,9 +260,11 @@ message ListTargetGrpcProxiesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 6 [json_name = "returnPartialSuccess"]; } @@ -239,14 +279,17 @@ message PatchTargetGrpcProxyRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 2 [json_name = "requestId"]; // Name of the TargetGrpcProxy resource to patch. 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 8ab780c36b5de..533572c4c636a 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: 20250601 +// revision: 20260807 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_016.proto"; -import "google/cloud/compute/v1/internal/common_134.proto"; -import "google/cloud/compute/v1/internal/common_135.proto"; -import "google/cloud/compute/v1/internal/common_147.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_160.proto"; +import "google/cloud/compute/v1/internal/common_161.proto"; +import "google/cloud/compute/v1/internal/common_174.proto"; import "google/cloud/extended_operations.proto"; // Service for the targetHttpProxies resource. @@ -40,8 +40,10 @@ service TargetHttpProxies { "https://www.googleapis.com/auth/compute.readonly"; // 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`. + // available to the specified project. + // + // To prevent failure, Google recommends that you set the + // `returnPartialSuccess` parameter to `true`. // https://cloud.google.com/compute/docs/reference/rest/v1/targetHttpProxies/aggregatedList rpc AggregatedListTargetHttpProxies(AggregatedListTargetHttpProxiesRequest) returns (google.cloud.cpp.compute.v1.TargetHttpProxyAggregatedList) { @@ -72,8 +74,8 @@ service TargetHttpProxies { option (google.api.method_signature) = "project,target_http_proxy"; } - // Creates a TargetHttpProxy resource in the specified project using the data - // included in the request. + // Creates a TargetHttpProxy resource in the specified + // project using the data included in the request. // https://cloud.google.com/compute/docs/reference/rest/v1/targetHttpProxies/insert rpc InsertTargetHttpProxy(InsertTargetHttpProxyRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -85,8 +87,8 @@ service TargetHttpProxies { option (google.cloud.operation_service) = "GlobalOperations"; } - // Retrieves the list of TargetHttpProxy resources available to the specified - // project. + // Retrieves the list of TargetHttpProxy resources available + // to the specified project. // https://cloud.google.com/compute/docs/reference/rest/v1/targetHttpProxies/list rpc ListTargetHttpProxies(ListTargetHttpProxiesRequest) returns (google.cloud.cpp.compute.v1.TargetHttpProxyList) { @@ -97,8 +99,9 @@ service TargetHttpProxies { } // 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. + // the request. This method supports PATCH + // semantics and usesJSON merge + // patch format and processing rules. // https://cloud.google.com/compute/docs/reference/rest/v1/targetHttpProxies/patch rpc PatchTargetHttpProxy(PatchTargetHttpProxyRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -128,37 +131,64 @@ service TargetHttpProxies { // Request message for AggregatedListTargetHttpProxies. message AggregatedListTargetHttpProxiesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; // Indicates whether every visible scope for each scope type (zone, region, @@ -170,25 +200,29 @@ message AggregatedListTargetHttpProxiesRequest { // will be included. optional bool include_all_scopes = 2 [json_name = "includeAllScopes"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 3 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 4 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 5 [json_name = "pageToken"]; // Name of the project scoping this request. @@ -196,9 +230,11 @@ message AggregatedListTargetHttpProxiesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; // The Shared VPC service project id or service project number for which @@ -218,14 +254,17 @@ message DeleteTargetHttpProxyRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 2 [json_name = "requestId"]; // Name of the TargetHttpProxy resource to delete. @@ -255,14 +294,17 @@ message InsertTargetHttpProxyRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 2 [json_name = "requestId"]; // The TargetHttpProxy for this request. @@ -273,58 +315,89 @@ message InsertTargetHttpProxyRequest { // Request message for ListTargetHttpProxies. message ListTargetHttpProxiesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -332,9 +405,11 @@ message ListTargetHttpProxiesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 6 [json_name = "returnPartialSuccess"]; } @@ -349,14 +424,17 @@ message PatchTargetHttpProxyRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 2 [json_name = "requestId"]; // Name of the TargetHttpProxy resource to patch. @@ -379,14 +457,17 @@ message SetUrlMapRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 2 [json_name = "requestId"]; // Name of the TargetHttpProxy to set a URL map for. 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 c2d965ddb3632..ca8082847b7f7 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: 20250601 +// revision: 20260807 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_016.proto"; -import "google/cloud/compute/v1/internal/common_129.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_147.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_154.proto"; +import "google/cloud/compute/v1/internal/common_162.proto"; +import "google/cloud/compute/v1/internal/common_163.proto"; +import "google/cloud/compute/v1/internal/common_174.proto"; import "google/cloud/extended_operations.proto"; // Service for the targetHttpsProxies resource. @@ -41,8 +41,10 @@ service TargetHttpsProxies { "https://www.googleapis.com/auth/compute.readonly"; // 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`. + // available to the specified project. + // + // To prevent failure, Google recommends that you set the + // `returnPartialSuccess` parameter to `true`. // https://cloud.google.com/compute/docs/reference/rest/v1/targetHttpsProxies/aggregatedList rpc AggregatedListTargetHttpsProxies(AggregatedListTargetHttpsProxiesRequest) returns (google.cloud.cpp.compute.v1.TargetHttpsProxyAggregatedList) { @@ -73,8 +75,8 @@ service TargetHttpsProxies { option (google.api.method_signature) = "project,target_https_proxy"; } - // Creates a TargetHttpsProxy resource in the specified project using the data - // included in the request. + // Creates a TargetHttpsProxy resource in the specified + // project using the data included in the request. // https://cloud.google.com/compute/docs/reference/rest/v1/targetHttpsProxies/insert rpc InsertTargetHttpsProxy(InsertTargetHttpsProxyRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -87,8 +89,8 @@ service TargetHttpsProxies { option (google.cloud.operation_service) = "GlobalOperations"; } - // Retrieves the list of TargetHttpsProxy resources available to the specified - // project. + // Retrieves the list of TargetHttpsProxy resources + // available to the specified project. // https://cloud.google.com/compute/docs/reference/rest/v1/targetHttpsProxies/list rpc ListTargetHttpsProxies(ListTargetHttpsProxiesRequest) returns (google.cloud.cpp.compute.v1.TargetHttpsProxyList) { @@ -99,8 +101,9 @@ service TargetHttpsProxies { } // 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. + // the request. This method supports PATCH + // semantics and usesJSON merge + // patch format and processing rules. // https://cloud.google.com/compute/docs/reference/rest/v1/targetHttpsProxies/patch rpc PatchTargetHttpsProxy(PatchTargetHttpsProxyRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -185,37 +188,64 @@ service TargetHttpsProxies { // Request message for AggregatedListTargetHttpsProxies. message AggregatedListTargetHttpsProxiesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; // Indicates whether every visible scope for each scope type (zone, region, @@ -227,25 +257,29 @@ message AggregatedListTargetHttpsProxiesRequest { // will be included. optional bool include_all_scopes = 2 [json_name = "includeAllScopes"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 3 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 4 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 5 [json_name = "pageToken"]; // Name of the project scoping this request. @@ -253,9 +287,11 @@ message AggregatedListTargetHttpsProxiesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; // The Shared VPC service project id or service project number for which @@ -275,14 +311,17 @@ message DeleteTargetHttpsProxyRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 2 [json_name = "requestId"]; // Name of the TargetHttpsProxy resource to delete. @@ -312,14 +351,17 @@ message InsertTargetHttpsProxyRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 2 [json_name = "requestId"]; // The TargetHttpsProxy for this request. @@ -330,58 +372,89 @@ message InsertTargetHttpsProxyRequest { // Request message for ListTargetHttpsProxies. message ListTargetHttpsProxiesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -389,9 +462,11 @@ message ListTargetHttpsProxiesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 6 [json_name = "returnPartialSuccess"]; } @@ -406,14 +481,17 @@ message PatchTargetHttpsProxyRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 2 [json_name = "requestId"]; // Name of the TargetHttpsProxy resource to patch. @@ -436,18 +514,21 @@ message SetCertificateMapRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 2 [json_name = "requestId"]; - // Name of the TargetHttpsProxy resource whose CertificateMap is to be set. - // The name must be 1-63 characters long, and comply with RFC1035. + // Name of the TargetHttpsProxy resource whose CertificateMap is + // to be set. The name must be 1-63 characters long, and comply with RFC1035. string target_https_proxy = 3 [(google.api.field_behavior) = REQUIRED, json_name = "targetHttpsProxy"]; @@ -469,14 +550,17 @@ message SetQuicOverrideRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 2 [json_name = "requestId"]; // Name of the TargetHttpsProxy resource to set the QUIC override policy for. @@ -501,18 +585,21 @@ message SetSslCertificatesRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 2 [json_name = "requestId"]; - // Name of the TargetHttpsProxy resource to set an SslCertificates resource - // for. + // Name of the TargetHttpsProxy resource to set an + // SslCertificates resource for. string target_https_proxy = 3 [(google.api.field_behavior) = REQUIRED, json_name = "targetHttpsProxy"]; @@ -534,22 +621,25 @@ message SetSslPolicyRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 2 [json_name = "requestId"]; // The SslPolicyReference for this request. optional google.cloud.cpp.compute.v1.SslPolicyReference ssl_policy_reference_resource = 3 [json_name = "__json_request_body"]; - // Name of the TargetHttpsProxy resource whose SSL policy is to be set. The - // name must be 1-63 characters long, and comply with RFC1035. + // Name of the TargetHttpsProxy resource whose SSL policy is + // to be set. The name must be 1-63 characters long, and comply with RFC1035. string target_https_proxy = 4 [(google.api.field_behavior) = REQUIRED, json_name = "targetHttpsProxy"]; } @@ -565,17 +655,21 @@ message SetUrlMapRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 2 [json_name = "requestId"]; - // Name of the TargetHttpsProxy resource whose URL map is to be set. + // Name of the TargetHttpsProxy resource whose URL map is + // to be set. string target_https_proxy = 3 [(google.api.field_behavior) = REQUIRED, json_name = "targetHttpsProxy"]; 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 a394f0b45c536..f98bf0a499e00 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: 20250601 +// revision: 20260807 syntax = "proto3"; @@ -24,9 +24,10 @@ 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_016.proto"; -import "google/cloud/compute/v1/internal/common_118.proto"; -import "google/cloud/compute/v1/internal/common_138.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_142.proto"; +import "google/cloud/compute/v1/internal/common_164.proto"; +import "google/cloud/compute/v1/internal/common_171.proto"; import "google/cloud/extended_operations.proto"; // Service for the targetInstances resource. @@ -38,9 +39,10 @@ service TargetInstances { "https://www.googleapis.com/auth/compute," "https://www.googleapis.com/auth/compute.readonly"; - // Retrieves an aggregated list of target instances. To prevent failure, - // Google recommends that you set the `returnPartialSuccess` parameter to - // `true`. + // Retrieves an aggregated list of target instances. + // + // To prevent failure, Google recommends that you set the + // `returnPartialSuccess` parameter to `true`. // https://cloud.google.com/compute/docs/reference/rest/v1/targetInstances/aggregatedList rpc AggregatedListTargetInstances(AggregatedListTargetInstancesRequest) returns (google.cloud.cpp.compute.v1.TargetInstanceAggregatedList) { @@ -97,7 +99,8 @@ service TargetInstances { } // Sets the Google Cloud Armor security policy for the specified target - // instance. For more information, see Google Cloud Armor Overview + // instance. For more information, seeGoogle + // Cloud Armor Overview // https://cloud.google.com/compute/docs/reference/rest/v1/targetInstances/setSecurityPolicy rpc SetSecurityPolicy(SetSecurityPolicyRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -109,42 +112,81 @@ service TargetInstances { "project,zone,target_instance,security_policy_reference_resource"; option (google.cloud.operation_service) = "ZoneOperations"; } + + // Returns permissions that a caller has on the specified resource. + // https://cloud.google.com/compute/docs/reference/rest/v1/targetInstances/testIamPermissions + rpc TestIamPermissions(TestIamPermissionsRequest) + returns (google.cloud.cpp.compute.v1.TestPermissionsResponse) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/zones/{zone}/targetInstances/{resource}/testIamPermissions" + body: "test_permissions_request_resource" + }; + option (google.api.method_signature) = + "project,zone,resource,test_permissions_request_resource"; + } } // Request message for AggregatedListTargetInstances. message AggregatedListTargetInstancesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; // Indicates whether every visible scope for each scope type (zone, region, @@ -156,25 +198,29 @@ message AggregatedListTargetInstancesRequest { // will be included. optional bool include_all_scopes = 2 [json_name = "includeAllScopes"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 3 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 4 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 5 [json_name = "pageToken"]; // Project ID for this request. @@ -182,9 +228,11 @@ message AggregatedListTargetInstancesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; // The Shared VPC service project id or service project number for which @@ -204,14 +252,17 @@ message DeleteTargetInstanceRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 2 [json_name = "requestId"]; // Name of the TargetInstance resource to delete. @@ -251,14 +302,17 @@ message InsertTargetInstanceRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 2 [json_name = "requestId"]; // The TargetInstance for this request. @@ -276,58 +330,89 @@ message InsertTargetInstanceRequest { // Request message for ListTargetInstances. message ListTargetInstancesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -335,9 +420,11 @@ message ListTargetInstancesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 6 [json_name = "returnPartialSuccess"]; // Name of the zone scoping this request. @@ -355,14 +442,17 @@ message SetSecurityPolicyRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 2 [json_name = "requestId"]; // The SecurityPolicyReference for this request. @@ -382,3 +472,21 @@ message SetSecurityPolicyRequest { json_name = "zone" ]; } + +// Request message for TestIamPermissions. +message TestIamPermissionsRequest { + // Project ID for this request. + string project = 1 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // Name or id of the resource for this request. + string resource = 2 + [(google.api.field_behavior) = REQUIRED, json_name = "resource"]; + + // The TestPermissionsRequest for this request. + optional google.cloud.cpp.compute.v1.TestPermissionsRequest + test_permissions_request_resource = 3 [json_name = "__json_request_body"]; + + // The name of the zone for this request. + string zone = 4 [(google.api.field_behavior) = REQUIRED, json_name = "zone"]; +} 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 69462dd9751df..566d3dbfd8645 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: 20250601 +// revision: 20260807 syntax = "proto3"; @@ -24,11 +24,12 @@ 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_016.proto"; -import "google/cloud/compute/v1/internal/common_063.proto"; -import "google/cloud/compute/v1/internal/common_118.proto"; -import "google/cloud/compute/v1/internal/common_139.proto"; -import "google/cloud/compute/v1/internal/common_140.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_078.proto"; +import "google/cloud/compute/v1/internal/common_142.proto"; +import "google/cloud/compute/v1/internal/common_165.proto"; +import "google/cloud/compute/v1/internal/common_166.proto"; +import "google/cloud/compute/v1/internal/common_171.proto"; import "google/cloud/extended_operations.proto"; // Service for the targetPools resource. @@ -66,8 +67,10 @@ service TargetPools { option (google.cloud.operation_service) = "RegionOperations"; } - // Retrieves an aggregated list of target pools. To prevent failure, Google - // recommends that you set the `returnPartialSuccess` parameter to `true`. + // Retrieves an aggregated list of target pools. + // + // To prevent failure, Google recommends that you set the + // `returnPartialSuccess` parameter to `true`. // https://cloud.google.com/compute/docs/reference/rest/v1/targetPools/aggregatedList rpc AggregatedListTargetPools(AggregatedListTargetPoolsRequest) returns (google.cloud.cpp.compute.v1.TargetPoolAggregatedList) { @@ -98,8 +101,8 @@ service TargetPools { option (google.api.method_signature) = "project,region,target_pool"; } - // Gets the most recent health check results for each IP for the instance that - // is referenced by the given target pool. + // Gets the most recent health check results for each IP for the + // instance that is referenced by the given target pool. // https://cloud.google.com/compute/docs/reference/rest/v1/targetPools/getHealth rpc GetHealth(GetHealthRequest) returns (google.cloud.cpp.compute.v1.TargetPoolInstanceHealth) { @@ -111,8 +114,8 @@ service TargetPools { "project,region,target_pool,instance_reference_resource"; } - // Creates a target pool in the specified project and region using the data - // included in the request. + // Creates a target pool in the specified project and region using + // the data included in the request. // https://cloud.google.com/compute/docs/reference/rest/v1/targetPools/insert rpc InsertTargetPool(InsertTargetPoolRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -125,8 +128,8 @@ service TargetPools { option (google.cloud.operation_service) = "RegionOperations"; } - // Retrieves a list of target pools available to the specified project and - // region. + // Retrieves a list of target pools available to the specified + // project and region. // https://cloud.google.com/compute/docs/reference/rest/v1/targetPools/list rpc ListTargetPools(ListTargetPoolsRequest) returns (google.cloud.cpp.compute.v1.TargetPoolList) { @@ -176,7 +179,8 @@ service TargetPools { } // Sets the Google Cloud Armor security policy for the specified target pool. - // For more information, see Google Cloud Armor Overview + // For more information, seeGoogle + // Cloud Armor Overview // https://cloud.google.com/compute/docs/reference/rest/v1/targetPools/setSecurityPolicy rpc SetSecurityPolicy(SetSecurityPolicyRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -188,6 +192,18 @@ service TargetPools { "project,region,target_pool,security_policy_reference_resource"; option (google.cloud.operation_service) = "RegionOperations"; } + + // Returns permissions that a caller has on the specified resource. + // https://cloud.google.com/compute/docs/reference/rest/v1/targetPools/testIamPermissions + rpc TestIamPermissions(TestIamPermissionsRequest) + returns (google.cloud.cpp.compute.v1.TestPermissionsResponse) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/regions/{region}/targetPools/{resource}/testIamPermissions" + body: "test_permissions_request_resource" + }; + option (google.api.method_signature) = + "project,region,resource,test_permissions_request_resource"; + } } // Request message for AddHealthCheck. @@ -208,14 +224,17 @@ message AddHealthCheckRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // Name of the target pool to add a health check to. @@ -246,14 +265,17 @@ message AddInstanceRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // Name of the TargetPool resource to add instances to. @@ -269,37 +291,64 @@ message AddInstanceRequest { // Request message for AggregatedListTargetPools. message AggregatedListTargetPoolsRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; // Indicates whether every visible scope for each scope type (zone, region, @@ -311,25 +360,29 @@ message AggregatedListTargetPoolsRequest { // will be included. optional bool include_all_scopes = 2 [json_name = "includeAllScopes"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 3 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 4 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 5 [json_name = "pageToken"]; // Project ID for this request. @@ -337,9 +390,11 @@ message AggregatedListTargetPoolsRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; // The Shared VPC service project id or service project number for which @@ -366,14 +421,17 @@ message DeleteTargetPoolRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // Name of the TargetPool resource to delete. @@ -433,14 +491,17 @@ message InsertTargetPoolRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // The TargetPool for this request. @@ -451,58 +512,89 @@ message InsertTargetPoolRequest { // Request message for ListTargetPools. message ListTargetPoolsRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -514,9 +606,11 @@ message ListTargetPoolsRequest { [(google.api.field_behavior) = REQUIRED, json_name = "region"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; } @@ -538,14 +632,17 @@ message RemoveHealthCheckRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // Name of the target pool to remove health checks from. @@ -576,14 +673,17 @@ message RemoveInstanceRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // Name of the TargetPool resource to remove instances from. @@ -617,14 +717,17 @@ message SetBackupRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; // Name of the TargetPool resource to set a backup pool for. @@ -654,14 +757,17 @@ message SetSecurityPolicyRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // The SecurityPolicyReference for this request. @@ -669,8 +775,27 @@ message SetSecurityPolicyRequest { security_policy_reference_resource = 4 [json_name = "__json_request_body"]; - // Name of the TargetPool resource to which the security policy should be set. - // The name should conform to RFC1035. + // Name of the TargetPool resource to which the security policy should be + // set. The name should conform to RFC1035. string target_pool = 5 [(google.api.field_behavior) = REQUIRED, json_name = "targetPool"]; } + +// Request message for TestIamPermissions. +message TestIamPermissionsRequest { + // Project ID for this request. + string project = 1 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // The name of the region for this request. + string region = 2 + [(google.api.field_behavior) = REQUIRED, json_name = "region"]; + + // Name or id of the resource for this request. + string resource = 3 + [(google.api.field_behavior) = REQUIRED, json_name = "resource"]; + + // The TestPermissionsRequest for this request. + optional google.cloud.cpp.compute.v1.TestPermissionsRequest + test_permissions_request_resource = 4 [json_name = "__json_request_body"]; +} 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 ba3dea18d4e69..ffa49cc65a4ad 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: 20250601 +// revision: 20260807 syntax = "proto3"; @@ -24,9 +24,10 @@ 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_016.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_019.proto"; +import "google/cloud/compute/v1/internal/common_154.proto"; +import "google/cloud/compute/v1/internal/common_167.proto"; +import "google/cloud/compute/v1/internal/common_171.proto"; import "google/cloud/extended_operations.proto"; // Service for the targetSslProxies resource. @@ -59,8 +60,8 @@ service TargetSslProxies { option (google.api.method_signature) = "project,target_ssl_proxy"; } - // Creates a TargetSslProxy resource in the specified project using the data - // included in the request. + // Creates a TargetSslProxy resource in the specified project using + // the data included in the request. // https://cloud.google.com/compute/docs/reference/rest/v1/targetSslProxies/insert rpc InsertTargetSslProxy(InsertTargetSslProxyRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -72,8 +73,8 @@ service TargetSslProxies { option (google.cloud.operation_service) = "GlobalOperations"; } - // Retrieves the list of TargetSslProxy resources available to the specified - // project. + // Retrieves the list of TargetSslProxy resources + // available to the specified project. // https://cloud.google.com/compute/docs/reference/rest/v1/targetSslProxies/list rpc ListTargetSslProxies(ListTargetSslProxiesRequest) returns (google.cloud.cpp.compute.v1.TargetSslProxyList) { @@ -137,8 +138,8 @@ service TargetSslProxies { // 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. + // clients and the load balancer. They do not affect the + // connection between the load balancer and the backends. // https://cloud.google.com/compute/docs/reference/rest/v1/targetSslProxies/setSslPolicy rpc SetSslPolicy(SetSslPolicyRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -150,6 +151,18 @@ service TargetSslProxies { "project,target_ssl_proxy,ssl_policy_reference_resource"; option (google.cloud.operation_service) = "GlobalOperations"; } + + // Returns permissions that a caller has on the specified resource. + // https://cloud.google.com/compute/docs/reference/rest/v1/targetSslProxies/testIamPermissions + rpc TestIamPermissions(TestIamPermissionsRequest) + returns (google.cloud.cpp.compute.v1.TestPermissionsResponse) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/global/targetSslProxies/{resource}/testIamPermissions" + body: "test_permissions_request_resource" + }; + option (google.api.method_signature) = + "project,resource,test_permissions_request_resource"; + } } // Request message for DeleteTargetSslProxy. @@ -163,14 +176,17 @@ message DeleteTargetSslProxyRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 2 [json_name = "requestId"]; // Name of the TargetSslProxy resource to delete. @@ -200,14 +216,17 @@ message InsertTargetSslProxyRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 2 [json_name = "requestId"]; // The TargetSslProxy for this request. @@ -218,58 +237,89 @@ message InsertTargetSslProxyRequest { // Request message for ListTargetSslProxies. message ListTargetSslProxiesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -277,9 +327,11 @@ message ListTargetSslProxiesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 6 [json_name = "returnPartialSuccess"]; } @@ -294,18 +346,21 @@ message SetBackendServiceRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 2 [json_name = "requestId"]; - // Name of the TargetSslProxy resource whose BackendService resource is to be - // set. + // Name of the TargetSslProxy resource whose BackendService resource + // is to be set. string target_ssl_proxy = 3 [(google.api.field_behavior) = REQUIRED, json_name = "targetSslProxy"]; @@ -326,18 +381,21 @@ message SetCertificateMapRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 2 [json_name = "requestId"]; - // Name of the TargetSslProxy resource whose CertificateMap is to be set. The - // name must be 1-63 characters long, and comply with RFC1035. + // Name of the TargetSslProxy resource whose CertificateMap is + // to be set. The name must be 1-63 characters long, and comply with RFC1035. string target_ssl_proxy = 3 [(google.api.field_behavior) = REQUIRED, json_name = "targetSslProxy"]; @@ -358,14 +416,17 @@ message SetProxyHeaderRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 2 [json_name = "requestId"]; // Name of the TargetSslProxy resource whose ProxyHeader is to be set. @@ -389,18 +450,21 @@ message SetSslCertificatesRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 2 [json_name = "requestId"]; - // Name of the TargetSslProxy resource whose SslCertificate resource is to be - // set. + // Name of the TargetSslProxy resource whose SslCertificate resource + // is to be set. string target_ssl_proxy = 3 [(google.api.field_behavior) = REQUIRED, json_name = "targetSslProxy"]; @@ -421,22 +485,40 @@ message SetSslPolicyRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 2 [json_name = "requestId"]; // The SslPolicyReference for this request. optional google.cloud.cpp.compute.v1.SslPolicyReference ssl_policy_reference_resource = 3 [json_name = "__json_request_body"]; - // Name of the TargetSslProxy resource whose SSL policy is to be set. The name - // must be 1-63 characters long, and comply with RFC1035. + // Name of the TargetSslProxy resource whose SSL policy is + // to be set. The name must be 1-63 characters long, and comply with RFC1035. string target_ssl_proxy = 4 [(google.api.field_behavior) = REQUIRED, json_name = "targetSslProxy"]; } + +// Request message for TestIamPermissions. +message TestIamPermissionsRequest { + // Project ID for this request. + string project = 1 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // Name or id of the resource for this request. + string resource = 2 + [(google.api.field_behavior) = REQUIRED, json_name = "resource"]; + + // The TestPermissionsRequest for this request. + optional google.cloud.cpp.compute.v1.TestPermissionsRequest + test_permissions_request_resource = 3 [json_name = "__json_request_body"]; +} 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 9df7ba52d9626..ea735dcfb7a37 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: 20250601 +// revision: 20260807 syntax = "proto3"; @@ -24,9 +24,10 @@ 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_016.proto"; -import "google/cloud/compute/v1/internal/common_142.proto"; -import "google/cloud/compute/v1/internal/common_143.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_168.proto"; +import "google/cloud/compute/v1/internal/common_169.proto"; +import "google/cloud/compute/v1/internal/common_171.proto"; import "google/cloud/extended_operations.proto"; // Service for the targetTcpProxies resource. @@ -39,8 +40,10 @@ service TargetTcpProxies { "https://www.googleapis.com/auth/compute.readonly"; // 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`. + // available to the specified project. + // + // To prevent failure, Google recommends that you set the + // `returnPartialSuccess` parameter to `true`. // https://cloud.google.com/compute/docs/reference/rest/v1/targetTcpProxies/aggregatedList rpc AggregatedListTargetTcpProxies(AggregatedListTargetTcpProxiesRequest) returns (google.cloud.cpp.compute.v1.TargetTcpProxyAggregatedList) { @@ -71,8 +74,8 @@ service TargetTcpProxies { option (google.api.method_signature) = "project,target_tcp_proxy"; } - // Creates a TargetTcpProxy resource in the specified project using the data - // included in the request. + // Creates a TargetTcpProxy resource in the specified project using + // the data included in the request. // https://cloud.google.com/compute/docs/reference/rest/v1/targetTcpProxies/insert rpc InsertTargetTcpProxy(InsertTargetTcpProxyRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -84,8 +87,8 @@ service TargetTcpProxies { option (google.cloud.operation_service) = "GlobalOperations"; } - // Retrieves the list of TargetTcpProxy resources available to the specified - // project. + // Retrieves the list of TargetTcpProxy resources + // available to the specified project. // https://cloud.google.com/compute/docs/reference/rest/v1/targetTcpProxies/list rpc ListTargetTcpProxies(ListTargetTcpProxiesRequest) returns (google.cloud.cpp.compute.v1.TargetTcpProxyList) { @@ -120,42 +123,81 @@ service TargetTcpProxies { "project,target_tcp_proxy,target_tcp_proxies_set_proxy_header_request_resource"; option (google.cloud.operation_service) = "GlobalOperations"; } + + // Returns permissions that a caller has on the specified resource. + // https://cloud.google.com/compute/docs/reference/rest/v1/targetTcpProxies/testIamPermissions + rpc TestIamPermissions(TestIamPermissionsRequest) + returns (google.cloud.cpp.compute.v1.TestPermissionsResponse) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/global/targetTcpProxies/{resource}/testIamPermissions" + body: "test_permissions_request_resource" + }; + option (google.api.method_signature) = + "project,resource,test_permissions_request_resource"; + } } // Request message for AggregatedListTargetTcpProxies. message AggregatedListTargetTcpProxiesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; // Indicates whether every visible scope for each scope type (zone, region, @@ -167,25 +209,29 @@ message AggregatedListTargetTcpProxiesRequest { // will be included. optional bool include_all_scopes = 2 [json_name = "includeAllScopes"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 3 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 4 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 5 [json_name = "pageToken"]; // Name of the project scoping this request. @@ -193,9 +239,11 @@ message AggregatedListTargetTcpProxiesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; // The Shared VPC service project id or service project number for which @@ -215,14 +263,17 @@ message DeleteTargetTcpProxyRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 2 [json_name = "requestId"]; // Name of the TargetTcpProxy resource to delete. @@ -252,14 +303,17 @@ message InsertTargetTcpProxyRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 2 [json_name = "requestId"]; // The TargetTcpProxy for this request. @@ -270,58 +324,89 @@ message InsertTargetTcpProxyRequest { // Request message for ListTargetTcpProxies. message ListTargetTcpProxiesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -329,9 +414,11 @@ message ListTargetTcpProxiesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 6 [json_name = "returnPartialSuccess"]; } @@ -346,18 +433,21 @@ message SetBackendServiceRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 2 [json_name = "requestId"]; - // Name of the TargetTcpProxy resource whose BackendService resource is to be - // set. + // Name of the TargetTcpProxy resource whose BackendService resource + // is to be set. string target_tcp_proxy = 3 [(google.api.field_behavior) = REQUIRED, json_name = "targetTcpProxy"]; @@ -378,14 +468,17 @@ message SetProxyHeaderRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 2 [json_name = "requestId"]; // Name of the TargetTcpProxy resource whose ProxyHeader is to be set. @@ -397,3 +490,18 @@ message SetProxyHeaderRequest { target_tcp_proxies_set_proxy_header_request_resource = 4 [json_name = "__json_request_body"]; } + +// Request message for TestIamPermissions. +message TestIamPermissionsRequest { + // Project ID for this request. + string project = 1 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // Name or id of the resource for this request. + string resource = 2 + [(google.api.field_behavior) = REQUIRED, json_name = "resource"]; + + // The TestPermissionsRequest for this request. + optional google.cloud.cpp.compute.v1.TestPermissionsRequest + test_permissions_request_resource = 3 [json_name = "__json_request_body"]; +} 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 e807c662ef0ad..912d42170ffb1 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: 20250601 +// revision: 20260807 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_016.proto"; -import "google/cloud/compute/v1/internal/common_107.proto"; -import "google/cloud/compute/v1/internal/common_144.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_125.proto"; +import "google/cloud/compute/v1/internal/common_170.proto"; import "google/cloud/extended_operations.proto"; // Service for the targetVpnGateways resource. @@ -38,9 +38,10 @@ service TargetVpnGateways { "https://www.googleapis.com/auth/compute," "https://www.googleapis.com/auth/compute.readonly"; - // Retrieves an aggregated list of target VPN gateways. To prevent failure, - // Google recommends that you set the `returnPartialSuccess` parameter to - // `true`. + // Retrieves an aggregated list of target VPN gateways. + // + // To prevent failure, Google recommends that you set the + // `returnPartialSuccess` parameter to `true`. // https://cloud.google.com/compute/docs/reference/rest/v1/targetVpnGateways/aggregatedList rpc AggregatedListTargetVpnGateways(AggregatedListTargetVpnGatewaysRequest) returns (google.cloud.cpp.compute.v1.TargetVpnGatewayAggregatedList) { @@ -71,8 +72,8 @@ service TargetVpnGateways { option (google.api.method_signature) = "project,region,target_vpn_gateway"; } - // Creates a target VPN gateway in the specified project and region using the - // data included in the request. + // Creates a target VPN gateway in the specified project and region using + // the data included in the request. // https://cloud.google.com/compute/docs/reference/rest/v1/targetVpnGateways/insert rpc InsertTargetVpnGateway(InsertTargetVpnGatewayRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -85,8 +86,8 @@ service TargetVpnGateways { option (google.cloud.operation_service) = "RegionOperations"; } - // Retrieves a list of target VPN gateways available to the specified project - // and region. + // Retrieves a list of target VPN gateways available to the specified + // project and region. // https://cloud.google.com/compute/docs/reference/rest/v1/targetVpnGateways/list rpc ListTargetVpnGateways(ListTargetVpnGatewaysRequest) returns (google.cloud.cpp.compute.v1.TargetVpnGatewayList) { @@ -96,8 +97,9 @@ service TargetVpnGateways { option (google.api.method_signature) = "project,region"; } - // Sets the labels on a TargetVpnGateway. To learn more about labels, read the - // Labeling Resources documentation. + // Sets the labels on a TargetVpnGateway. To learn more about labels, read + // theLabeling + // Resources documentation. // https://cloud.google.com/compute/docs/reference/rest/v1/targetVpnGateways/setLabels rpc SetLabels(SetLabelsRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -114,37 +116,64 @@ service TargetVpnGateways { // Request message for AggregatedListTargetVpnGateways. message AggregatedListTargetVpnGatewaysRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; // Indicates whether every visible scope for each scope type (zone, region, @@ -156,25 +185,29 @@ message AggregatedListTargetVpnGatewaysRequest { // will be included. optional bool include_all_scopes = 2 [json_name = "includeAllScopes"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 3 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 4 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 5 [json_name = "pageToken"]; // Project ID for this request. @@ -182,9 +215,11 @@ message AggregatedListTargetVpnGatewaysRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; // The Shared VPC service project id or service project number for which @@ -211,14 +246,17 @@ message DeleteTargetVpnGatewayRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // Name of the target VPN gateway to delete. @@ -259,14 +297,17 @@ message InsertTargetVpnGatewayRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // The TargetVpnGateway for this request. @@ -277,58 +318,89 @@ message InsertTargetVpnGatewayRequest { // Request message for ListTargetVpnGateways. message ListTargetVpnGatewaysRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -340,9 +412,11 @@ message ListTargetVpnGatewaysRequest { [(google.api.field_behavior) = REQUIRED, json_name = "region"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; } @@ -369,14 +443,17 @@ message SetLabelsRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; // Name or id of the resource for this request. 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 250deb458bd88..6eeb613fd904e 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: 20250601 +// revision: 20260807 syntax = "proto3"; @@ -24,9 +24,10 @@ 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_018.proto"; -import "google/cloud/compute/v1/internal/common_020.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_022.proto"; +import "google/cloud/compute/v1/internal/common_023.proto"; +import "google/cloud/compute/v1/internal/common_171.proto"; import "google/cloud/extended_operations.proto"; // Service for the urlMaps resource. @@ -38,9 +39,11 @@ service UrlMaps { "https://www.googleapis.com/auth/compute," "https://www.googleapis.com/auth/compute.readonly"; - // 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`. + // 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`. // https://cloud.google.com/compute/docs/reference/rest/v1/urlMaps/aggregatedList rpc AggregatedListUrlMaps(AggregatedListUrlMapsRequest) returns (google.cloud.cpp.compute.v1.UrlMapsAggregatedList) { @@ -70,8 +73,8 @@ service UrlMaps { option (google.api.method_signature) = "project,url_map"; } - // Creates a UrlMap resource in the specified project using the data included - // in the request. + // Creates a UrlMap resource in the specified project using + // the data included in the request. // https://cloud.google.com/compute/docs/reference/rest/v1/urlMaps/insert rpc InsertUrlMap(InsertUrlMapRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -84,8 +87,10 @@ service UrlMaps { } // 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). + // scoped to the specified UrlMap. + // + // For more information, see [Invalidating cached + // content](https://cloud.google.com/cdn/docs/invalidating-cached-content). // https://cloud.google.com/compute/docs/reference/rest/v1/urlMaps/invalidateCache rpc InvalidateCache(InvalidateCacheRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -98,7 +103,8 @@ service UrlMaps { option (google.cloud.operation_service) = "GlobalOperations"; } - // Retrieves the list of UrlMap resources available to the specified project. + // Retrieves the list of UrlMap resources available to the specified + // project. // https://cloud.google.com/compute/docs/reference/rest/v1/urlMaps/list rpc ListUrlMaps(ListUrlMapsRequest) returns (google.cloud.cpp.compute.v1.UrlMapList) { @@ -109,8 +115,9 @@ service UrlMaps { } // 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. + // request. This method supportsPATCH + // semantics and uses theJSON merge + // patch format and processing rules. // https://cloud.google.com/compute/docs/reference/rest/v1/urlMaps/patch rpc PatchUrlMap(PatchUrlMapRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -122,6 +129,18 @@ service UrlMaps { option (google.cloud.operation_service) = "GlobalOperations"; } + // Returns permissions that a caller has on the specified resource. + // https://cloud.google.com/compute/docs/reference/rest/v1/urlMaps/testIamPermissions + rpc TestIamPermissions(TestIamPermissionsRequest) + returns (google.cloud.cpp.compute.v1.TestPermissionsResponse) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/global/urlMaps/{resource}/testIamPermissions" + body: "test_permissions_request_resource" + }; + option (google.api.method_signature) = + "project,resource,test_permissions_request_resource"; + } + // Updates the specified UrlMap resource with the data included in the // request. // https://cloud.google.com/compute/docs/reference/rest/v1/urlMaps/update @@ -153,37 +172,64 @@ service UrlMaps { // Request message for AggregatedListUrlMaps. message AggregatedListUrlMapsRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; // Indicates whether every visible scope for each scope type (zone, region, @@ -195,25 +241,29 @@ message AggregatedListUrlMapsRequest { // will be included. optional bool include_all_scopes = 2 [json_name = "includeAllScopes"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 3 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 4 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 5 [json_name = "pageToken"]; // Name of the project scoping this request. @@ -221,9 +271,11 @@ message AggregatedListUrlMapsRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; // The Shared VPC service project id or service project number for which @@ -243,14 +295,17 @@ message DeleteUrlMapRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 2 [json_name = "requestId"]; // Name of the UrlMap resource to delete. @@ -280,14 +335,17 @@ message InsertUrlMapRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 2 [json_name = "requestId"]; // The UrlMap for this request. @@ -310,14 +368,17 @@ message InvalidateCacheRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // Name of the UrlMap scoping this request. @@ -328,58 +389,89 @@ message InvalidateCacheRequest { // Request message for ListUrlMaps. message ListUrlMapsRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -387,9 +479,11 @@ message ListUrlMapsRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 6 [json_name = "returnPartialSuccess"]; } @@ -404,14 +498,17 @@ message PatchUrlMapRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 2 [json_name = "requestId"]; // Name of the UrlMap resource to patch. @@ -423,6 +520,21 @@ message PatchUrlMapRequest { [json_name = "__json_request_body"]; } +// Request message for TestIamPermissions. +message TestIamPermissionsRequest { + // Project ID for this request. + string project = 1 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // Name or id of the resource for this request. + string resource = 2 + [(google.api.field_behavior) = REQUIRED, json_name = "resource"]; + + // The TestPermissionsRequest for this request. + optional google.cloud.cpp.compute.v1.TestPermissionsRequest + test_permissions_request_resource = 3 [json_name = "__json_request_body"]; +} + // Request message for UpdateUrlMap. message UpdateUrlMapRequest { // Project ID for this request. @@ -434,14 +546,17 @@ message UpdateUrlMapRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 2 [json_name = "requestId"]; // Name of the UrlMap resource to update. diff --git a/protos/google/cloud/compute/v1/internal/common_000.proto b/protos/google/cloud/compute/v1/internal/common_000.proto index 11073aa52382c..5ef86271a0eeb 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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_029.proto"; -import "google/cloud/compute/v1/internal/common_052.proto"; +import "google/cloud/compute/v1/internal/common_038.proto"; +import "google/cloud/compute/v1/internal/common_065.proto"; // Contains the configurations necessary to generate a signature for access to // private storage buckets that support Signature Version 4 for authentication. @@ -32,7 +32,9 @@ message AWSV4Signature { // 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 + // request. + // + // @InputOnly optional string access_key = 1 [json_name = "accessKey"]; // The identifier of an access key used for s3 bucket authentication. @@ -43,7 +45,7 @@ message AWSV4Signature { optional string access_key_version = 3 [json_name = "accessKeyVersion"]; // 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, + // 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. optional string origin_region = 4 [json_name = "originRegion"]; } @@ -52,32 +54,43 @@ message AWSV4Signature { message Backend { // 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 + // Connection balancing mode. + // + // Backends must use compatible balancing modes. Backends of a backend + // service may use different 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. // CONNECTION: Balance based on the number of simultaneous connections. // CUSTOM_METRICS: Based on custom defined and reported metrics. + // IN_FLIGHT: Balance based on the number of in-flight requests. // RATE: Balance based on requests per second (RPS). // UTILIZATION: Balance based on the backend utilization. optional string balancing_mode = 1 [json_name = "balancingMode"]; // 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. + // mode. + // The default value is 1, which means the group serves up to + // 100% of its configured capacity (depending onbalancingMode). 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 than0.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 abalancingMode. This + // includes backends such as global + // internet NEGs, regional serverless NEGs, and PSC NEGs. optional float capacity_scaler = 2 [json_name = "capacityScaler"]; - // List of custom metrics that are used for CUSTOM_METRICS BalancingMode. + // List of custom metrics that are used for CUSTOM_METRICS + // BalancingMode. repeated BackendCustomMetric custom_metrics = 14 [json_name = "customMetrics"]; @@ -87,111 +100,196 @@ message Backend { // This field designates whether this is a failover backend. More than one // failover backend can be configured for a given BackendService. + // + // This field can only be used for a regional external Passthrough Network + // Load Balancer or a regional internal Passthrough Network Load Balancer. optional bool failover = 4 [json_name = "failover"]; - // 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 + // The fully-qualified URL of aninstance + // 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. If haPolicy is specified, backends must refer to - // NEG resources of type GCE_VM_IP. + // + // You must use the *fully-qualified* URL (starting + // withhttps://www.googleapis.com/) to specify the instance group + // or NEG. Partial URLs are not supported. + // + // If haPolicy is specified, backends must refer to NEG resources of type + // GCE_VM_IP. optional string group = 5 [json_name = "group"]; // 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. + // guidelines, seeConnection + // balancing mode and Utilization + // balancing mode. Not available if the backend'sbalancingMode is RATE. optional int32 max_connections = 6 [json_name = "maxConnections"]; - // 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. + // Defines a target maximum number of simultaneous connections. For usage + // guidelines, seeConnection + // balancing mode and Utilization + // balancing mode. + // + // Not available if the backend's balancingMode isRATE. optional int32 max_connections_per_endpoint = 7 [json_name = "maxConnectionsPerEndpoint"]; - // 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. + // Defines a target maximum number of simultaneous connections. + // For usage guidelines, seeConnection + // balancing mode and Utilization + // balancing mode. + // + // Not available if the backend's balancingMode isRATE. optional int32 max_connections_per_instance = 8 [json_name = "maxConnectionsPerInstance"]; - // 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. + // Defines a maximum number of in-flight requests for the whole NEG or + // instance group. Not available if backend's balancingMode isRATE or + // CONNECTION. + optional int32 max_in_flight_requests = 15 + [json_name = "maxInFlightRequests"]; + + // Defines a maximum number of in-flight requests for a single endpoint. + // Not available if backend's balancingMode is RATE + // or CONNECTION. + optional int32 max_in_flight_requests_per_endpoint = 16 + [json_name = "maxInFlightRequestsPerEndpoint"]; + + // Defines a maximum number of in-flight requests for a single VM. + // Not available if backend's balancingMode is RATE + // or CONNECTION. + optional int32 max_in_flight_requests_per_instance = 17 + [json_name = "maxInFlightRequestsPerInstance"]; + + // Defines a maximum number of HTTP requests per second (RPS). For + // usage guidelines, seeRate + // balancing mode and Utilization + // balancing mode. + // + // Not available if the backend's balancingMode isCONNECTION. optional int32 max_rate = 9 [json_name = "maxRate"]; // 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. + // guidelines, seeRate + // balancing mode and Utilization + // balancing mode. + // + // Not available if the backend's balancingMode isCONNECTION. optional float max_rate_per_endpoint = 10 [json_name = "maxRatePerEndpoint"]; // 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. + // guidelines, seeRate + // balancing mode and Utilization + // balancing mode. + // + // Not available if the backend's balancingMode isCONNECTION. optional float max_rate_per_instance = 11 [json_name = "maxRatePerInstance"]; - // 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. + // Optional parameter to define a target capacity for theUTILIZATION balancing + // mode. The valid range is[0.0, 1.0]. + // + // For usage guidelines, seeUtilization + // balancing mode. optional float max_utilization = 12 [json_name = "maxUtilization"]; + // Information about the resource or system that manages the backend. + optional BackendBackendOrchestrationInfo orchestration_info = 18 + [json_name = "orchestrationInfo"]; + // 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 + // 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 + // + // + // + // For global external Passthrough Network Load Balancers, the following + // restrictions apply: + // + // - At most one backend can be marked as PREFERRED. + // - PREFERRED and DEFAULT backends cannot reside + // in the same Cloud region. // DEFAULT: No preference. // PREFERENCE_UNSPECIFIED: If preference is unspecified, we set it to the // DEFAULT value // PREFERRED: Traffic will be sent to this backend first. optional string preference = 13 [json_name = "preference"]; + + // LONG: Most of the requests are expected to take more than multiple seconds + // to + // finish. + // SHORT: Most requests are expected to finish with a sub-second latency. + // TRAFFIC_DURATION_UNSPECIFIED: Traffic duration is unspecified. + optional string traffic_duration = 19 [json_name = "trafficDuration"]; +} + +// A message containing information about the resource or system that manages +// the backend. +message BackendBackendOrchestrationInfo { + // The URI of the resource or system that manages the backend. + optional string resource_uri = 1 [json_name = "resourceUri"]; } // Custom Metrics are used for CUSTOM_METRICS balancing_mode. message BackendCustomMetric { - // If true, the metric data is collected and reported to Cloud Monitoring, but - // is not used for load balancing. + // If true, the metric data is collected and reported to Cloud + // Monitoring, but is not used for load balancing. optional bool dry_run = 1 [json_name = "dryRun"]; // Optional parameter to define a target utilization for the Custom Metrics // balancing mode. The valid range is [0.0, 1.0]. optional float max_utilization = 2 [json_name = "maxUtilization"]; - // Name of a custom utilization signal. The name must be 1-64 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, period, underscore, lowercase letter, or digit, - // except the last character, which cannot be a dash, period, or underscore. - // For usage guidelines, see Custom Metrics balancing mode. This field can - // only be used for a global or regional backend service with the - // loadBalancingScheme set to EXTERNAL_MANAGED, INTERNAL_MANAGED + // Name of a custom utilization signal. The name must be 1-64 characters + // long and match the regular expression + // `[a-z]([-_.a-z0-9]*[a-z0-9])?` which means that the + // first character must be a lowercase letter, and all following + // characters must be a dash, period, underscore, lowercase letter, or + // digit, except the last character, which cannot be a dash, period, or + // underscore. For usage guidelines, see Custom Metrics balancing mode. This + // field can only be used for a global or regional backend service with the + // loadBalancingScheme set to EXTERNAL_MANAGED,INTERNAL_MANAGED // INTERNAL_SELF_MANAGED. optional string name = 3 [json_name = "name"]; } -// 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. * +// 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. +// +// For more information, seeBackend +// Services. message BackendService { // 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. + // 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. optional int32 affinity_cookie_ttl_sec = 1 [json_name = "affinityCookieTtlSec"]; @@ -204,10 +302,11 @@ message BackendService { optional CircuitBreakers circuit_breakers = 4 [json_name = "circuitBreakers"]; - // Compress text responses using Brotli or gzip compression, based on the - // client's Accept-Encoding header. + // 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. + // 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 = 5 [json_name = "compressionMode"]; @@ -219,6 +318,7 @@ message BackendService { // 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. + // // connectionTrackingPolicy cannot be specified with haPolicy. optional BackendServiceConnectionTrackingPolicy connection_tracking_policy = 7 [json_name = "connectionTrackingPolicy"]; @@ -228,19 +328,24 @@ message BackendService { // 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, HTTP2 or H2C, and load_balancing_scheme set to INTERNAL_MANAGED. - A - // global backend service with the load_balancing_scheme set to - // INTERNAL_SELF_MANAGED. + // that control consistent hashing. This field is only applicable + // whenlocalityLbPolicy is set to MAGLEV orRING_HASH. + // + // This field is applicable to either: + // + // - A regional backend service with the service protocol set to HTTP, + // HTTPS, HTTP2 or H2C, and load_balancing_scheme set to + // INTERNAL_MANAGED. + // - A global backend service with the + // load_balancing_scheme set to INTERNAL_SELF_MANAGED. optional ConsistentHashLoadBalancerSettings consistent_hash = 8 [json_name = "consistentHash"]; - // [Output Only] Creation timestamp in RFC3339 text format. + // Output only. [Output Only] Creation timestamp inRFC3339 + // text format. optional string creation_timestamp = 9 [json_name = "creationTimestamp"]; - // List of custom metrics that are used for the WEIGHTED_ROUND_ROBIN + // List of custom metrics that are used for theWEIGHTED_ROUND_ROBIN // locality_lb_policy. repeated BackendServiceCustomMetric custom_metrics = 45 [json_name = "customMetrics"]; @@ -265,22 +370,24 @@ message BackendService { // this backend service. optional string edge_security_policy = 13 [json_name = "edgeSecurityPolicy"]; - // If true, enables Cloud CDN for the backend service of a global external - // Application Load Balancer. + // If true, enables Cloud CDN for the backend service of a + // global external Application Load Balancer. optional bool enable_cdn = 14 [json_name = "enableCDN"]; // Specifies the canary migration state. Possible values are PREPARE, - // TEST_BY_PERCENTAGE, and TEST_ALL_TRAFFIC. To begin the migration from - // EXTERNAL to EXTERNAL_MANAGED, the state must be changed to PREPARE. The - // state must be changed to TEST_ALL_TRAFFIC before the loadBalancingScheme - // can be changed to EXTERNAL_MANAGED. Optionally, the TEST_BY_PERCENTAGE - // state can be used to migrate traffic by percentage using - // externalManagedMigrationTestingPercentage. Rolling back a migration - // requires the states to be set in reverse order. So changing the scheme from - // EXTERNAL_MANAGED to EXTERNAL requires the state to be set to - // TEST_ALL_TRAFFIC at the same time. Optionally, the TEST_BY_PERCENTAGE state - // can be used to migrate some traffic back to EXTERNAL or PREPARE can be used - // to migrate all traffic back to EXTERNAL. + // TEST_BY_PERCENTAGE, and TEST_ALL_TRAFFIC. + // + // To begin the migration from EXTERNAL to EXTERNAL_MANAGED, the state must be + // changed to PREPARE. The state must be changed to TEST_ALL_TRAFFIC before + // the loadBalancingScheme can be changed to EXTERNAL_MANAGED. Optionally, the + // TEST_BY_PERCENTAGE state can be used to migrate traffic by percentage using + // externalManagedMigrationTestingPercentage. + // + // Rolling back a migration requires the states to be set in reverse order. So + // changing the scheme from EXTERNAL_MANAGED to EXTERNAL requires the state to + // be set to TEST_ALL_TRAFFIC at the same time. Optionally, the + // TEST_BY_PERCENTAGE state can be used to migrate some traffic back to + // EXTERNAL or PREPARE can be used to migrate all traffic back to EXTERNAL. // PREPARE: // TEST_ALL_TRAFFIC: // TEST_BY_PERCENTAGE: @@ -288,66 +395,90 @@ message BackendService { [json_name = "externalManagedMigrationState"]; // Determines the fraction of requests that should be processed by the Global - // external Application Load Balancer. The value of this field must be in the - // range [0, 100]. Session affinity options will slightly affect this routing - // behavior, for more details, see: Session Affinity. This value can only be - // set if the loadBalancingScheme in the BackendService is set to EXTERNAL - // (when using the classic Application Load Balancer) and the migration state - // is TEST_BY_PERCENTAGE. + // external Application Load Balancer. + // + // The value of this field must be in the range [0, 100]. + // + // Session affinity options will slightly affect this routing behavior, for + // more details, see:Session + // Affinity. + // + // This value can only be set if the loadBalancingScheme in the BackendService + // is set to EXTERNAL (when using the classic Application Load Balancer) and + // the migration state is TEST_BY_PERCENTAGE. optional float external_managed_migration_testing_percentage = 47 [json_name = "externalManagedMigrationTestingPercentage"]; - // Requires at least one backend instance group to be defined as a backup - // (failover) backend. For load balancers that have configurable failover: + // 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). - // failoverPolicy cannot be specified with haPolicy. + // failoverPolicy cannot be specified with haPolicy.failoverPolicy cannot be + // used by global external Passthrough + // Network Load Balancers. optional BackendServiceFailoverPolicy failover_policy = 15 [json_name = "failoverPolicy"]; // 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. + // 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. optional string fingerprint = 16 [json_name = "fingerprint"]; // Configures self-managed High Availability (HA) for External and Internal - // Protocol Forwarding. The backends of this regional backend service must - // only specify zonal network endpoint groups (NEGs) of type GCE_VM_IP. When - // haPolicy is set for an Internal Passthrough Network Load Balancer, the + // Protocol Forwarding. + // + // The backends of this regional backend service must only specify zonal + // network endpoint groups (NEGs) of type GCE_VM_IP. + // + // When haPolicy is set for an Internal Passthrough Network Load Balancer, the // regional backend service must set the network field. All zonal NEGs must - // belong to the same network. However, individual NEGs can belong to - // different subnetworks of that network. When haPolicy is specified, the set - // of attached network endpoints across all backends comprise an High - // Availability domain from which one endpoint is selected as the active - // endpoint (the leader) that receives all traffic. haPolicy can be added only - // at backend service creation time. Once set up, it cannot be deleted. Note - // that haPolicy is not for load balancing, and therefore cannot be specified - // with sessionAffinity, connectionTrackingPolicy, and failoverPolicy. - // haPolicy requires customers to be responsible for tracking backend endpoint - // health and electing a leader among the healthy endpoints. Therefore, - // haPolicy cannot be specified with healthChecks. haPolicy can only be - // specified for External Passthrough Network Load Balancers and Internal - // Passthrough Network Load Balancers. + // belong to the same network. However, individual NEGs can + // belong to different subnetworks of that network. + // + // When haPolicy is specified, the set of attached network endpoints across + // all backends comprise an High Availability domain from which one endpoint + // is selected as the active endpoint (the leader) that receives all + // traffic. + // + // haPolicy can be added only at backend service creation time. Once set up, + // it cannot be deleted. + // + // Note that haPolicy is not for load balancing, and therefore cannot be + // specified with sessionAffinity, connectionTrackingPolicy, and + // failoverPolicy. + // + // haPolicy requires customers to be responsible for tracking backend + // endpoint health and electing a leader among the healthy endpoints. + // Therefore, haPolicy cannot be specified with healthChecks. + // haPolicy can only be specified for External Passthrough + // Network Load Balancers and Internal Passthrough Network Load + // Balancers.haPolicy cannot be used by global external Passthrough Network + // Load Balancers. optional BackendServiceHAPolicy ha_policy = 48 [json_name = "haPolicy"]; // 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 unless haPolicy is specified. Backend - // services with internet or serverless NEG backends must not have a health - // check. healthChecks[] cannot be specified with haPolicy. + // 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 unless + // haPolicy is specified. Backend services with internet or serverless NEG + // backends must not have a health check. + // + // healthChecks[] cannot be specified with haPolicy. repeated string health_checks = 17 [json_name = "healthChecks"]; - // The configurations for Identity-Aware Proxy on this resource. Not available - // for internal passthrough Network Load Balancers and external passthrough - // Network Load Balancers. + // The configurations for Identity-Aware Proxy on this resource. + // Not available for internal passthrough Network Load Balancers and external + // passthrough Network Load Balancers. optional BackendServiceIAP iap = 18 [json_name = "iap"]; // [Output Only] The unique identifier for the resource. This identifier is @@ -355,53 +486,74 @@ message BackendService { 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). + // 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. + // (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. + // (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). + // 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. + // Output only. [Output Only] Type of resource. Always compute#backendService + // for backend services. optional string kind = 20 [json_name = "kind"]; - // 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. + // 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 + // Backend services product and scheme table. // EXTERNAL: Signifies that this will be used for classic Application Load - // Balancers, global external proxy Network Load Balancers, or external - // passthrough Network Load Balancers. + // Balancers, + // global external proxy Network Load Balancers, + // or external passthrough Network Load Balancers. // EXTERNAL_MANAGED: Signifies that this will be used for global external - // Application Load Balancers, regional external Application Load Balancers, - // or regional external proxy Network Load Balancers. + // Application Load + // Balancers, regional external Application Load Balancers, or regional + // external proxy Network Load Balancers. // INTERNAL: Signifies that this will be used for internal passthrough Network - // Load Balancers. + // Load + // Balancers. // INTERNAL_MANAGED: Signifies that this will be used for internal Application // Load Balancers. // INTERNAL_SELF_MANAGED: Signifies that this will be used by Traffic @@ -414,74 +566,131 @@ message BackendService { // 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. + // value set in the localityLbPolicy field. + // + // For an example of how to use this field, seeDefine + // 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. repeated BackendServiceLocalityLoadBalancingPolicyConfig locality_lb_policies = 22 [json_name = "localityLbPolicies"]; // 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, HTTP2 or H2C, 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. localityLbPolicy cannot be specified with haPolicy. + // 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 Maglev: + // A Fast and Reliable Software Network Load Balancer. + // - WEIGHTED_ROUND_ROBIN: Per-endpoint Weighted Round Robin + // Load Balancing using weights computed from Backend reported Custom + // Metrics. + // If set, the Backend Service responses are expected to contain + // non-standard + // HTTP response header field Endpoint-Load-Metrics. The reported + // metrics to use for computing the weights are specified via + // thecustomMetrics field. + // - WEIGHTED_MAGLEV: Per-endpoint weighted load balancing via + // health check reported weights. If set, the backend service must + // configure + // an HTTP-based Health Check, and health check replies are expected to + // contain the non-standard HTTP response header + // fieldX-Load-Balancing-Endpoint-Weight to specify the per-endpoint + // weights. If set, load balancing is weighted based on the per-endpoint + // 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 field is applicable to either: + // + // - A regional backend service with the service protocol set to HTTP, + // HTTPS, HTTP2 or H2C, 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 isMAGLEV. + // + // 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. + // + // localityLbPolicy cannot be specified with haPolicy. // INVALID_LB_POLICY: // LEAST_REQUEST: An O(1) algorithm which selects two random healthy hosts and // picks the host which has fewer active requests. // MAGLEV: 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 + // 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, seeMaglev: + // A Fast and Reliable Software Network Load Balancer. // 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. + // 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. // RANDOM: The load balancer selects a random healthy host. // 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. + // 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. // ROUND_ROBIN: This is a simple policy in which each healthy backend is - // selected in round robin order. This is the default. + // selected + // in round robin order. This is the default. + // WEIGHTED_GCP_RENDEZVOUS: Per-instance weighted Load Balancing via health + // check reported weights. + // In internal passthrough network load balancing, it is weighted + // rendezvous hashing. + // This option is only supported in internal passthrough network load + // balancing. // WEIGHTED_MAGLEV: 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. + // 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. // WEIGHTED_ROUND_ROBIN: Per-endpoint weighted round-robin Load Balancing - // using weights computed from Backend reported Custom Metrics. If set, the - // Backend Service responses are expected to contain non-standard HTTP - // response header field X-Endpoint-Load-Metrics. The reported metrics to use - // for computing the weights are specified via the backends[].customMetrics - // fields. + // using weights computed + // from Backend reported Custom Metrics. If set, the Backend Service + // responses are expected to contain non-standard HTTP response header field + // Endpoint-Load-Metrics. The reported metrics + // to use for computing the weights are specified via the + // customMetrics fields. optional string locality_lb_policy = 23 [json_name = "localityLbPolicy"]; // This field denotes the logging options for the load balancer traffic served @@ -492,11 +701,16 @@ message BackendService { // 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. + // 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. optional Duration max_stream_duration = 25 [json_name = "maxStreamDuration"]; // Deployment metadata associated with the resource to be set by a GKE hub @@ -504,57 +718,95 @@ message BackendService { map metadatas = 40 [json_name = "metadatas"]; // 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. + // The name must be 1-63 characters long, and comply withRFC1035. // 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. + // 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 = 26 [json_name = "name"]; - // The URL of the network to which this backend service belongs. This field - // must be set for Internal Passthrough Network Load Balancers when the - // haPolicy is enabled, and for External Passthrough Network Load Balancers - // when the haPolicy fastIpMove is enabled. This field can only be specified - // when the load balancing scheme is set to INTERNAL, or when the load - // balancing scheme is set to EXTERNAL and haPolicy fastIpMove is enabled. + // The URL of the network to which this backend service belongs. + // + // This field must be set for Internal Passthrough Network Load Balancers when + // the haPolicy is enabled, and for External Passthrough Network Load + // Balancers when the haPolicy fastIpMove is enabled. + // + // This field can only be specified when the load balancing scheme is set + // toINTERNAL, or when the load balancing scheme is set toEXTERNAL and + // haPolicy fastIpMove is enabled. optional string network = 27 [json_name = "network"]; + // Configures traffic steering properties of internal passthrough Network + // Load Balancers. + // + // networkPassThroughLbTrafficPolicy cannot be specified with haPolicy. + optional BackendServiceNetworkPassThroughLbTrafficPolicy + network_pass_through_lb_traffic_policy = 49 + [json_name = "networkPassThroughLbTrafficPolicy"]; + + // Information about the resource or system that manages the backend service. + optional BackendServiceOrchestrationInfo orchestration_info = 50 + [json_name = "orchestrationInfo"]; + // 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, HTTP2 - // or H2C, 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. + // 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 service protocol set to HTTP, HTTPS, HTTP2 or H2C, 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. optional OutlierDetection outlier_detection = 28 [json_name = "outlierDetection"]; - // 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. + // Input only. [Input Only] Additional params passed with the request, but not + // persisted + // as part of resource payload. + optional BackendServiceParams params = 51 [json_name = "params"]; + + // 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. optional int32 port = 29 [json_name = "port"]; // 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 + // 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 @@ -562,11 +814,15 @@ message BackendService { optional string port_name = 30 [json_name = "portName"]; // The protocol this BackendService uses to communicate with backends. - // Possible values are HTTP, HTTPS, HTTP2, H2C, 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. + // + // Possible values are HTTP, HTTPS, HTTP2, H2C, TCP, SSL, UDP, GRPC, or + // UNSPECIFIED, depending on the chosen load balancer or Traffic Director + // configuration. + // Refer to + // Load balancing features 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. // GRPC: gRPC (available for Traffic Director). // H2C: HTTP2 over cleartext // HTTP: @@ -576,13 +832,15 @@ message BackendService { // TCP: TCP proxying or TCP pass-through. // UDP: UDP. // UNSPECIFIED: If a Backend Service has UNSPECIFIED as its protocol, it can - // be used with any L3/L4 Forwarding Rules. + // be used with + // any L3/L4 Forwarding Rules. optional string protocol = 31 [json_name = "protocol"]; - // [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. + // Output only. [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. optional string region = 32 [json_name = "region"]; // [Output Only] The resource URL for the security policy associated with this @@ -598,80 +856,105 @@ message BackendService { // [Output Only] Server-defined URL for the resource. optional string self_link = 35 [json_name = "selfLink"]; - // 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. + // 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. repeated string service_bindings = 36 [json_name = "serviceBindings"]; - // 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. + // URL to networkservices.ServiceLbPolicy resource. + // + // Can only be set if load balancing scheme is EXTERNAL_MANAGED, + // INTERNAL_MANAGED or INTERNAL_SELF_MANAGED for a global backend service, and + // EXTERNAL_MANAGED or INTERNAL_MANAGED for a regional backend service. For a + // global backend service, the service lb policy must be global. For a + // regional backend service, the service lb policy must be regional and in the + // same region. optional string service_lb_policy = 42 [json_name = "serviceLbPolicy"]; - // 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 + // 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). + // // sessionAffinity cannot be specified with haPolicy. // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // applicable and required if the sessionAffinity is set + // toSTRONG_COOKIE_AFFINITY. optional BackendServiceHttpCookie strong_session_affinity_cookie = 44 [json_name = "strongSessionAffinityCookie"]; // subsetting cannot be specified with haPolicy. optional Subsetting subsetting = 38 [json_name = "subsetting"]; - // 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. + // 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. optional int32 timeout_sec = 39 [json_name = "timeoutSec"]; - // [Output Only] List of resources referencing given backend service. + // Configuration for Backend Authenticated TLS and mTLS. May only be specified + // when the backend protocol is SSL, HTTPS or HTTP2. + optional BackendServiceTlsSettings tls_settings = 52 + [json_name = "tlsSettings"]; + + // Output only. [Output Only] List of resources referencing given backend + // service. repeated BackendServiceUsedBy used_by = 41 [json_name = "usedBy"]; } // Message containing Cloud CDN configuration for a backend service. message BackendServiceCdnPolicy { // 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. + // Pragma or Authorization headers. Up to 5 headers can be specified. + // The cache is bypassed for all cdnPolicy.cacheMode settings. repeated BackendServiceCdnPolicyBypassCacheOnRequestHeader bypass_cache_on_request_headers = 1 [json_name = "bypassCacheOnRequestHeaders"]; @@ -679,114 +962,135 @@ message BackendServiceCdnPolicy { // The CacheKeyPolicy for this CdnPolicy. optional CacheKeyPolicy 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", + // 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, + // 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. If no value is provided for cdnPolicy.cacheMode, it defaults to - // CACHE_ALL_STATIC. + // cached. + // + // If no value is provided for cdnPolicy.cacheMode, it defaults + // to CACHE_ALL_STATIC. // 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 + // 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. + // "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. + // 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 + // 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). + // 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-maxage). - // 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. + // 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. + // 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. + // 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. + // 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), 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. + // 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 BackendServiceCdnPolicyNegativeCachingPolicy 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. + // 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-maxage) of a cached response. The - // maximum allowed value is 604800 (1 week). Set this to zero (0) to disable - // serve-while-stale. + // 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-maxage) 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. + // 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"]; @@ -794,24 +1098,26 @@ message BackendServiceCdnPolicy { 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. +// 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 BackendServiceCdnPolicyBypassCacheOnRequestHeader { - // The header field name to match on when bypassing cache. Values are - // case-insensitive. + // The header field name to match on when bypassing cache. + // Values are case-insensitive. optional string header_name = 1 [json_name = "headerName"]; } // Specify CDN TTLs for response error codes. message BackendServiceCdnPolicyNegativeCachingPolicy { - // 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. + // 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 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 + // 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"]; @@ -820,18 +1126,25 @@ message BackendServiceCdnPolicyNegativeCachingPolicy { // Connection Tracking configuration for this BackendService. message BackendServiceConnectionTrackingPolicy { // 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 + // 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 isPER_CONNECTION (default + // tracking mode) or the Session + // Affinity is configured for 5-tuple. They do not persist forUDP. + // + // 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). @@ -846,20 +1159,35 @@ message BackendServiceConnectionTrackingPolicy { optional bool enable_strong_affinity = 2 [json_name = "enableStrongAffinity"]; // 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. + // 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. optional int32 idle_timeout_sec = 3 [json_name = "idleTimeoutSec"]; - // 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. + // 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 @@ -870,57 +1198,71 @@ message BackendServiceConnectionTrackingPolicy { optional string tracking_mode = 4 [json_name = "trackingMode"]; } -// Custom Metrics are used for WEIGHTED_ROUND_ROBIN locality_lb_policy. +// Custom Metrics are used for WEIGHTED_ROUND_ROBIN +// locality_lb_policy. message BackendServiceCustomMetric { // If true, the metric data is not used for load balancing. optional bool dry_run = 1 [json_name = "dryRun"]; - // Name of a custom utilization signal. The name must be 1-64 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, period, underscore, lowercase letter, or digit, - // except the last character, which cannot be a dash, period, or underscore. - // For usage guidelines, see Custom Metrics balancing mode. This field can - // only be used for a global or regional backend service with the - // loadBalancingScheme set to EXTERNAL_MANAGED, INTERNAL_MANAGED + // Name of a custom utilization signal. The name must be 1-64 characters + // long and match the regular expression + // `[a-z]([-_.a-z0-9]*[a-z0-9])?` which means that the + // first character must be a lowercase letter, and all following + // characters must be a dash, period, underscore, lowercase letter, or + // digit, except the last character, which cannot be a dash, period, or + // underscore. For usage guidelines, see Custom Metrics balancing mode. This + // field can only be used for a global or regional backend service with the + // loadBalancingScheme set to EXTERNAL_MANAGED,INTERNAL_MANAGED // INTERNAL_SELF_MANAGED. optional string name = 2 [json_name = "name"]; } -// For load balancers that have configurable failover: [Internal passthrough -// Network Load +// 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 +// 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). +// 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). message BackendServiceFailoverPolicy { - // This can be set to true only if the protocol is TCP. The default is false. + // This can be set to true if the protocol isTCP, UDP, or UNSPECIFIED. + // + // The default is false. optional bool disable_connection_drain_on_failover = 1 [json_name = "disableConnectionDrainOnFailover"]; - // 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 + // 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 + // and [external passthrough + // Network Load // Balancers](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview). // The default is false. optional bool drop_traffic_if_unhealthy = 2 [json_name = "dropTrafficIfUnhealthy"]; - // 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 + // 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). @@ -935,97 +1277,136 @@ message BackendServiceGroupHealth { // network endpoint group, determined based on configured health checks. repeated HealthStatus health_status = 2 [json_name = "healthStatus"]; - // [Output Only] Type of resource. Always compute#backendServiceGroupHealth - // for the health of backend services. + // Output only. [Output Only] Type of resource. + // Alwayscompute#backendServiceGroupHealth for the health of backend + // services. optional string kind = 3 [json_name = "kind"]; } message BackendServiceHAPolicy { // Specifies whether fast IP move is enabled, and if so, the mechanism to - // achieve it. Supported values are: - DISABLED: Fast IP Move is disabled. You - // can only use the haPolicy.leader API to update the leader. - >GARP_RA: - // Provides a method to very quickly define a new network endpoint as the - // leader. This method is faster than updating the leader using the - // haPolicy.leader API. Fast IP move works as follows: The VM hosting the - // network endpoint that should become the new leader sends either a - // Gratuitous ARP (GARP) packet (IPv4) or an ICMPv6 Router Advertisement(RA) - // packet (IPv6). Google Cloud immediately but temporarily associates the - // forwarding rule IP address with that VM, and both new and in-flight packets - // are quickly delivered to that VM. Note the important properties of the Fast - // IP Move functionality: - The GARP/RA-initiated re-routing stays active for - // approximately 20 minutes. After triggering fast failover, you must also - // appropriately set the haPolicy.leader. - The new leader instance should - // continue to send GARP/RA packets periodically every 10 seconds until at - // least 10 minutes after updating the haPolicy.leader (but stop immediately - // if it is no longer the leader). - After triggering a fast failover, we - // recommend that you wait at least 3 seconds before sending another GARP/RA - // packet from a different VM instance to avoid race conditions. - Don't send - // GARP/RA packets from different VM instances at the same time. If multiple - // instances continue to send GARP/RA packets, traffic might be routed to - // different destinations in an alternating order. This condition ceases when - // a single instance issues a GARP/RA packet. - The GARP/RA request always - // takes priority over the leader API. Using the haPolicy.leader API to change - // the leader to a different instance will have no effect until the GARP/RA - // request becomes inactive. - The GARP/RA packets should follow the GARP/RA - // Packet Specifications.. - When multiple forwarding rules refer to a - // regional backend service, you need only send a GARP or RA packet for a - // single forwarding rule virtual IP. The virtual IPs for all forwarding rules - // targeting the same backend service will also be moved to the sender of the - // GARP or RA packet. The following are the Fast IP Move limitations (that is, - // when fastIPMove is not DISABLED): - Multiple forwarding rules cannot use - // the same IP address if one of them refers to a regional backend service - // with fastIPMove. - The regional backend service must set the network field, - // and all NEGs must belong to that network. However, individual NEGs can - // belong to different subnetworks of that network. - The maximum number of - // network endpoints across all backends of a backend service with fastIPMove - // is 32. - The maximum number of backend services with fastIPMove that can - // have the same network endpoint attached to one of its backends is 64. - The - // maximum number of backend services with fastIPMove in a VPC in a region is - // 64. - The network endpoints that are attached to a backend of a backend - // service with fastIPMove cannot resolve to Gen3+ machines for IPv6. - - // Traffic directed to the leader by a static route next hop will not be - // redirected to a new leader by fast failover. Such traffic will only be - // redirected once an haPolicy.leader update has taken effect. Only traffic to - // the forwarding rule's virtual IP will be redirected to a new leader by fast - // failover. haPolicy.fastIPMove can be set only at backend service creation - // time. Once set, it cannot be updated. By default, fastIpMove is set to - // DISABLED. + // achieve it. + // + // Supported values are: + // + // - DISABLED: Fast IP Move is disabled. You can only use the + // haPolicy.leader API to update the leader. + // - >GARP_RA: Provides a method to very quickly define a new network + // endpoint as the leader. This method is faster than updating the leader + // using the haPolicy.leader API. Fast IP move works as follows: The VM + // hosting the network endpoint that should become the new leader sends + // either a Gratuitous ARP (GARP) packet (IPv4) or an ICMPv6 Router + // Advertisement(RA) packet (IPv6). Google Cloud immediately but + // temporarily associates the forwarding rule IP address with that VM, and + // both new and in-flight packets are quickly delivered to that VM. + // + // + // + // Note the important properties of the Fast IP Move functionality: + // + // - The GARP/RA-initiated re-routing stays active for approximately 20 + // minutes. After triggering fast failover, you must also + // appropriately set the haPolicy.leader. + // - The new leader instance should continue to send GARP/RA packets + // periodically every 10 seconds until at least 10 minutes after updating + // the haPolicy.leader (but stop immediately if it is no longer the + // leader). + // - After triggering a fast failover, we recommend that you wait at least + // 3 seconds before sending another GARP/RA packet from a different VM + // instance to avoid race conditions. + // - Don't send GARP/RA packets from different VM + // instances at the same time. If multiple instances continue to send + // GARP/RA packets, traffic might be routed to different destinations in an + // alternating order. This condition ceases when a single instance + // issues a GARP/RA packet. + // - The GARP/RA request always takes priority over the leader API. + // Using the haPolicy.leader API to change the leader to a different + // instance will have no effect until the GARP/RA request becomes + // inactive. + // - The GARP/RA packets should follow the GARP/RA + // Packet Specifications.. + // - When multiple forwarding rules refer to a regional backend service, + // you need only send a GARP or RA packet for a single forwarding rule + // virtual IP. The virtual IPs for all forwarding rules targeting the same + // backend service will also be moved to the sender of the GARP or RA + // packet. + // + // + // + // The following are the Fast IP Move limitations (that is, when fastIPMove + // is not DISABLED): + // + // - Multiple forwarding rules cannot use the same IP address if one of + // them refers to a regional backend service with fastIPMove. + // - The regional backend service must set the network field, and all + // NEGs must belong to that network. However, individual + // NEGs can belong to different subnetworks of that network. + // - The maximum number of network endpoints across all backends of a + // backend service with fastIPMove is 32. + // - The maximum number of backend services with fastIPMove that can have + // the same network endpoint attached to one of its backends is 64. + // - The maximum number of backend services with fastIPMove in a VPC in a + // region is 64. + // - The network endpoints that are attached to a backend of a backend + // service with fastIPMove cannot resolve to Gen3+ machines for IPv6. + // - Traffic directed to the leader by a static route next hop will not be + // redirected to a new leader by fast failover. Such traffic will only be + // redirected once an haPolicy.leader update has taken effect. Only traffic + // to the forwarding rule's virtual IP will be redirected to a new leader + // by + // fast failover. + // + // + // haPolicy.fastIPMove can be set only at backend service creation time. + // Once set, it cannot be updated. + // + // By default, fastIpMove is set to DISABLED. // DISABLED: // GARP_RA: optional string fast_ip_move = 1 [json_name = "fastIPMove"]; - // Selects one of the network endpoints attached to the backend NEGs of this - // service as the active endpoint (the leader) that receives all traffic. When - // the leader changes, there is no connection draining to persist existing - // connections on the old leader. You are responsible for selecting a suitable - // endpoint as the leader. For example, preferring a healthy endpoint over - // unhealthy ones. Note that this service does not track backend endpoint - // health, and selects the configured leader unconditionally. + // Selects one of the network endpoints attached to the backend NEGs of + // this service as the active endpoint (the leader) that receives all + // traffic. + // + // When the leader changes, there is no connection draining to persist + // existing connections on the old leader. + // + // You are responsible for selecting a suitable endpoint as the + // leader. For example, preferring a healthy endpoint over unhealthy ones. + // Note that this service does not track backend endpoint health, and + // selects the configured leader unconditionally. optional BackendServiceHAPolicyLeader leader = 2 [json_name = "leader"]; } message BackendServiceHAPolicyLeader { - // A fully-qualified URL (starting with https://www.googleapis.com/) of the - // zonal Network Endpoint Group (NEG) with `GCE_VM_IP` endpoints that the - // leader is attached to. The leader's backendGroup must already be specified - // as a backend of this backend service. Removing a backend that is designated - // as the leader's backendGroup is not permitted. + // A fully-qualified URL (starting with https://www.googleapis.com/) + // of the zonal Network Endpoint Group (NEG) with `GCE_VM_IP` endpoints + // that the leader is attached to. + // + // The leader's backendGroup must already be specified as a backend of + // this backend service. Removing a backend that is designated as the + // leader's backendGroup is not permitted. optional string backend_group = 1 [json_name = "backendGroup"]; - // The network endpoint within the leader.backendGroup that is designated as - // the leader. This network endpoint cannot be detached from the NEG specified - // in the haPolicy.leader.backendGroup until the leader is updated with + // The network endpoint within the leader.backendGroup that is + // designated as the leader. + // + // This network endpoint cannot be detached from the NEG specified in + // the haPolicy.leader.backendGroup until the leader is updated with // another network endpoint, or the leader is removed from the haPolicy. optional BackendServiceHAPolicyLeaderNetworkEndpoint network_endpoint = 2 [json_name = "networkEndpoint"]; } message BackendServiceHAPolicyLeaderNetworkEndpoint { - // The name of the VM instance of the leader network endpoint. The instance - // must already be attached to the NEG specified in the - // haPolicy.leader.backendGroup. The name must be 1-63 characters long, and - // comply with RFC1035. Authorization requires the following IAM permission on - // the specified resource instance: compute.instances.use + // The name of the VM instance of the leader network endpoint. The + // instance must already be attached to the NEG specified in the + // haPolicy.leader.backendGroup. + // + // The name must be 1-63 characters long, and comply with RFC1035. + // Authorization requires the following IAM permission on the + // specified resource instance: compute.instances.use optional string instance = 1 [json_name = "instance"]; } @@ -1050,13 +1431,16 @@ message BackendServiceIAP { // OAuth2 client ID to use for the authentication flow. optional string oauth2_client_id = 2 [json_name = "oauth2ClientId"]; - // 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. + // 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 optional string oauth2_client_secret = 3 [json_name = "oauth2ClientSecret"]; - // [Output Only] SHA256 hash value for the field oauth2_client_secret above. + // Output only. [Output Only] SHA256 hash value for the field + // oauth2_client_secret above. optional string oauth2_client_secret_sha256 = 4 [json_name = "oauth2ClientSecretSha256"]; } @@ -1069,76 +1453,89 @@ message BackendServiceList { // A list of BackendService resources. repeated BackendService items = 2 [json_name = "items"]; - // [Output Only] Type of resource. Always compute#backendServiceList for lists - // of backend services. + // Output only. [Output Only] Type of resource. + // Alwayscompute#backendServiceList for lists of backend services. 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 + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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. + // Output only. [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. + // [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. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -1147,19 +1544,27 @@ message BackendServiceList { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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. @@ -1178,76 +1583,90 @@ message BackendServiceListUsable { // A list of BackendService resources. repeated BackendService items = 2 [json_name = "items"]; - // [Output Only] Type of resource. Always compute#usableBackendServiceList for - // lists of usable backend services. + // Output only. [Output Only] Type of resource. + // Alwayscompute#usableBackendServiceList for lists of usable backend + // services. 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 + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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. + // Output only. [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. + // [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. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -1256,19 +1675,27 @@ message BackendServiceListUsable { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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. @@ -1279,8 +1706,8 @@ message BackendServiceListUsable { optional Warning warning = 6 [json_name = "warning"]; } -// Container for either a built-in LB policy supported by gRPC or Envoy or a -// custom one implemented by the end user. +// Container for either a built-in LB policy supported by gRPC or Envoy or +// a custom one implemented by the end user. message BackendServiceLocalityLoadBalancingPolicyConfig { optional BackendServiceLocalityLoadBalancingPolicyConfigCustomPolicy custom_policy = 1 [json_name = "customPolicy"]; @@ -1289,19 +1716,24 @@ message BackendServiceLocalityLoadBalancingPolicyConfig { [json_name = "policy"]; } -// The configuration for a custom policy implemented by the user and deployed -// with the client. +// The configuration for a custom policy implemented by the user and +// deployed with the client. message BackendServiceLocalityLoadBalancingPolicyConfigCustomPolicy { - // An optional, arbitrary JSON object with configuration data, understood by a - // locally installed custom policy implementation. + // An optional, arbitrary JSON object with configuration data, understood + // by a locally installed custom policy implementation. optional string data = 1 [json_name = "data"]; - // 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 + // 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, seeUse // a custom policy. optional string name = 2 [json_name = "name"]; } @@ -1309,62 +1741,87 @@ message BackendServiceLocalityLoadBalancingPolicyConfigCustomPolicy { // The configuration for a built-in load balancing policy. message BackendServiceLocalityLoadBalancingPolicyConfigPolicy { // 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. + // 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. // INVALID_LB_POLICY: // LEAST_REQUEST: An O(1) algorithm which selects two random healthy hosts and // picks the host which has fewer active requests. // MAGLEV: 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 + // 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, seeMaglev: + // A Fast and Reliable Software Network Load Balancer. // 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. + // 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. // RANDOM: The load balancer selects a random healthy host. // 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. + // 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. // ROUND_ROBIN: This is a simple policy in which each healthy backend is - // selected in round robin order. This is the default. + // selected + // in round robin order. This is the default. + // WEIGHTED_GCP_RENDEZVOUS: Per-instance weighted Load Balancing via health + // check reported weights. + // In internal passthrough network load balancing, it is weighted + // rendezvous hashing. + // This option is only supported in internal passthrough network load + // balancing. // WEIGHTED_MAGLEV: 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. + // 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. // WEIGHTED_ROUND_ROBIN: Per-endpoint weighted round-robin Load Balancing - // using weights computed from Backend reported Custom Metrics. If set, the - // Backend Service responses are expected to contain non-standard HTTP - // response header field X-Endpoint-Load-Metrics. The reported metrics to use - // for computing the weights are specified via the backends[].customMetrics - // fields. + // using weights computed + // from Backend reported Custom Metrics. If set, the Backend Service + // responses are expected to contain non-standard HTTP response header field + // Endpoint-Load-Metrics. The reported metrics + // to use for computing the weights are specified via the + // customMetrics fields. optional string name = 1 [json_name = "name"]; } // The available logging options for the load balancer traffic served by this // backend service. message BackendServiceLogConfig { - // Denotes whether to enable logging for the load balancer traffic served by - // this backend service. The default value is false. + // Denotes whether to enable logging for the load balancer + // traffic served by this backend service. The default value is false. optional bool enable = 1 [json_name = "enable"]; + // The list of request headers that will be logged to Stackdriver. + repeated BackendServiceLogConfigLoggingHttpHeader + logging_http_request_headers = 5 + [json_name = "loggingHttpRequestHeaders"]; + + // The list of response headers that will be logged to Stackdriver. + repeated BackendServiceLogConfigLoggingHttpHeader + logging_http_response_headers = 6 + [json_name = "loggingHttpResponseHeaders"]; + // 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 + // 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 repeated string optional_fields = 2 [json_name = "optionalFields"]; // 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, + // 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. // CUSTOM: A subset of optional fields. // EXCLUDE_ALL_OPTIONAL: None optional fields. @@ -1379,10 +1836,167 @@ message BackendServiceLogConfig { optional float sample_rate = 4 [json_name = "sampleRate"]; } +// Determines which HTTP headers will be logged to Stackdriver. +message BackendServiceLogConfigLoggingHttpHeader { + // The name of the header to be logged. + optional string header_name = 1 [json_name = "headerName"]; +} + +message BackendServiceNetworkPassThroughLbTrafficPolicy { + // When configured, new connections are load balanced across healthy backend + // endpoints in the local zone. + optional BackendServiceNetworkPassThroughLbTrafficPolicyZonalAffinity + zonal_affinity = 1 [json_name = "zonalAffinity"]; +} + +message BackendServiceNetworkPassThroughLbTrafficPolicyZonalAffinity { + // This field indicates whether zonal affinity is enabled or not. The + // possible values are: + // + // - ZONAL_AFFINITY_DISABLED: Default Value. Zonal Affinity + // is disabled. The load balancer distributes new connections to all + // healthy backend endpoints across all zones. + // - ZONAL_AFFINITY_STAY_WITHIN_ZONE: Zonal Affinity is + // enabled. The load balancer distributes new connections to all healthy + // backend endpoints in the local zone only. If there are no healthy + // backend endpoints in the local zone, the load balancer distributes + // new connections to all backend endpoints in the local zone. + // - ZONAL_AFFINITY_SPILL_CROSS_ZONE: Zonal Affinity is + // enabled. The load balancer distributes new connections to all healthy + // backend endpoints in the local zone only. If there aren't enough + // healthy backend endpoints in the local zone, the load balancer + // distributes new connections to all healthy backend endpoints across all + // zones. + // ZONAL_AFFINITY_DISABLED: + // ZONAL_AFFINITY_SPILL_CROSS_ZONE: + // ZONAL_AFFINITY_STAY_WITHIN_ZONE: + optional string spillover = 1 [json_name = "spillover"]; + + // The value of the field must be in [0, 1]. When the ratio of the count + // of healthy backend endpoints in a zone to the count of backend + // endpoints in that same zone is equal to or above this threshold, the + // load balancer distributes new connections to all healthy endpoints in + // the local zone only. When the ratio of the count of healthy backend + // endpoints in a zone to the count of backend endpoints in that same + // zone is below this threshold, the load balancer distributes all new + // connections to all healthy endpoints across all zones. + optional float spillover_ratio = 2 [json_name = "spilloverRatio"]; +} + +// A message containing information about the resource or system that manages +// the backend service. +message BackendServiceOrchestrationInfo { + // The resource URI of the resource or system that manages the backend + // service. + optional string resource_uri = 1 [json_name = "resourceUri"]; +} + +// Additional Backend Service parameters. +message BackendServiceParams { + // Tag keys/values directly bound to this resource. + // Tag keys and values have the same definition as resource + // manager tags. The field is allowed for INSERT + // only. The keys/values to set on the resource should be specified in + // either ID { : } or Namespaced format + // { : }. + // For example the following are valid inputs: + // * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} + // * {"123/environment" : "production", "345/abc" : "xyz"} + // Note: + // * Invalid combinations of ID & namespaced format is not supported. For + // instance: {"123/environment" : "tagValues/444"} is invalid. + map resource_manager_tags = 1 + [json_name = "resourceManagerTags"]; +} + +message BackendServiceTlsSettings { + // Reference to the BackendAuthenticationConfig resource from the + // networksecurity.googleapis.com namespace. Can be used in authenticating + // TLS connections to the backend, as specified by the authenticationMode + // field. Can only be specified if authenticationMode is not NONE. + optional string authentication_config = 1 + [json_name = "authenticationConfig"]; + + // Assigns the Managed Identity for the BackendService Workload. + // + // + // Use this property to configure the load balancer back-end to use + // certificates and roots of trust provisioned by the Managed Workload + // Identity system. + // + // The `identity` property is the + // fully-specified SPIFFE ID to use in the SVID presented by the Load + // Balancer Workload. + // + // The SPIFFE ID must be a resource starting with the + // `trustDomain` property value, followed by the path to the Managed + // Workload Identity. + // + // Supported SPIFFE ID format: + // + // - ///ns//sa/ + // + // + // The Trust Domain within the Managed Identity must refer to a valid + // Workload Identity Pool. The TrustConfig and CertificateIssuanceConfig + // will be inherited from the Workload Identity Pool. + // + // Restrictions: + // + // - If you set the `identity` property, you cannot manually set + // the following fields: + // - tlsSettings.sni + // - tlsSettings.subjectAltNames + // - tlsSettings.authenticationConfig + // + // + // When defining a `identity` for a RegionBackendServices, the + // corresponding Workload Identity Pool must have a ca_pool + // configured in the same region. + // + // The system will set up a read-onlytlsSettings.authenticationConfig for the + // Managed Identity. + optional string identity = 2 [json_name = "identity"]; + + // Server Name Indication - see RFC3546 section 3.1. If set, the load + // balancer sends this string as the SNI hostname in the TLS connection to + // the backend, and requires that this string match a Subject Alternative + // Name (SAN) in the backend's server certificate. With a Regional Internet + // NEG backend, if the SNI is specified here, the load balancer uses it + // regardless of whether the Regional Internet NEG is specified with FQDN or + // IP address and port. When both sni and subjectAltNames[] are specified, + // the load balancer matches the backend certificate's SAN only to + // subjectAltNames[]. + optional string sni = 3 [json_name = "sni"]; + + // A list of Subject Alternative Names (SANs) that the Load Balancer + // verifies during a TLS handshake with the backend. When the server + // presents its X.509 certificate to the Load Balancer, the Load Balancer + // inspects the certificate's SAN field, and requires that at least one SAN + // match one of the subjectAltNames in the list. This field is limited to 5 + // entries. When both sni and subjectAltNames[] are specified, the load + // balancer matches the backend certificate's SAN only to subjectAltNames[]. + repeated BackendServiceTlsSettingsSubjectAltName subject_alt_names = 4 + [json_name = "subjectAltNames"]; +} + +// A Subject Alternative Name that the load balancer matches against the SAN +// field in the TLS certificate provided by the backend, specified as either +// a DNS name or a URI, in accordance with RFC 5280 4.2.1.6 +message BackendServiceTlsSettingsSubjectAltName { + // The SAN specified as a DNS Name. + optional string dns_name = 1 [json_name = "dnsName"]; + + // The SAN specified as a URI. + optional string uniform_resource_identifier = 2 + [json_name = "uniformResourceIdentifier"]; +} + message BackendServiceUsedBy { - // [Output Only] Server-defined URL for resources referencing given - // BackendService like UrlMaps, TargetTcpProxies, TargetSslProxies and - // ForwardingRule. + // Output only. [Output Only] Server-defined URL for resources referencing + // given + // BackendService like UrlMaps, TargetTcpProxies, TargetSslProxies + // and ForwardingRule. optional string reference = 1 [json_name = "reference"]; } @@ -1395,8 +2009,8 @@ message CacheKeyPolicy { // Allows HTTP request headers (by name) to be used in the cache key. repeated string include_http_headers = 2 [json_name = "includeHttpHeaders"]; - // 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. + // 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. repeated string include_named_cookies = 3 [json_name = "includeNamedCookies"]; // If true, http and https requests will be cached separately. @@ -1427,42 +2041,47 @@ message CacheKeyPolicy { // backend service. message CircuitBreakers { // 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. + // 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. optional int32 max_connections = 1 [json_name = "maxConnections"]; // 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. + // 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. optional int32 max_pending_requests = 2 [json_name = "maxPendingRequests"]; // The maximum number of parallel requests that allowed to the backend // service. If not specified, there is no limit. optional int32 max_requests = 3 [json_name = "maxRequests"]; - // 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. + // 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. optional int32 max_requests_per_connection = 4 [json_name = "maxRequestsPerConnection"]; // 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. + // 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. optional int32 max_retries = 5 [json_name = "maxRetries"]; } // Message containing connection draining configuration. message ConnectionDraining { // Configures a duration timeout for existing requests on a removed backend - // instance. For supported load balancers and protocols, as described in - // Enabling connection draining. + // instance. For supported load balancers and protocols, as described + // inEnabling + // connection draining. optional int32 draining_timeout_sec = 1 [json_name = "drainingTimeoutSec"]; } @@ -1471,14 +2090,15 @@ message ConsistentHashLoadBalancerSettings { // 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. + // 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. optional ConsistentHashLoadBalancerSettingsHttpCookie http_cookie = 1 [json_name = "httpCookie"]; // The hash based on the value of the specified header field. This field is - // applicable if the sessionAffinity is set to HEADER_FIELD. + // applicable if the sessionAffinity is set toHEADER_FIELD. optional string http_header_name = 2 [json_name = "httpHeaderName"]; // The minimum number of virtual nodes to use for the hash ring. Defaults to @@ -1488,8 +2108,8 @@ message ConsistentHashLoadBalancerSettings { optional string minimum_ring_size = 3 [json_name = "minimumRingSize"]; } -// The information about the HTTP Cookie on which the hash function is based for -// load balancing policies that use a consistent hash. +// The information about the HTTP Cookie on which the hash function is based +// for load balancing policies that use a consistent hash. message ConsistentHashLoadBalancerSettingsHttpCookie { // Name of the cookie. optional string name = 1 [json_name = "name"]; @@ -1505,10 +2125,12 @@ message ConsistentHashLoadBalancerSettingsHttpCookie { // pool for the backend service. message OutlierDetection { // 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. + // 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. optional Duration base_ejection_time = 1 [json_name = "baseEjectionTime"]; // Number of consecutive errors before a backend endpoint is ejected from the @@ -1538,6 +2160,7 @@ message OutlierDetection { // 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. optional int32 enforcing_success_rate = 6 [json_name = "enforcingSuccessRate"]; @@ -1558,8 +2181,9 @@ message OutlierDetection { // 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. + // balancing pool. Defaults to 5. + // + // Not supported when the backend service uses Serverless NEG. optional int32 success_rate_minimum_hosts = 9 [json_name = "successRateMinimumHosts"]; @@ -1567,8 +2191,9 @@ message OutlierDetection { // (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. + // performed for that backend endpoint. Defaults to 100. + // + // Not supported when the backend service uses Serverless NEG. optional int32 success_rate_request_volume = 10 [json_name = "successRateRequestVolume"]; @@ -1576,9 +2201,10 @@ message OutlierDetection { // 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. + // 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. optional int32 success_rate_stdev_factor = 11 [json_name = "successRateStdevFactor"]; } @@ -1599,41 +2225,56 @@ message SecuritySettings { // 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. + // backends. + // + // clientTlsPolicy only applies to a globalBackendService with the + // loadBalancingScheme set + // to INTERNAL_SELF_MANAGED. + // + // If left blank, communications are not encrypted. optional string client_tls_policy = 1 [json_name = "clientTlsPolicy"]; // 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). + // verifies during a mutual TLS handshake with an server/endpoint for + // thisBackendService. When the server presents its X.509 certificate + // to the client, the client inspects the certificate'ssubjectAltName 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 withloadBalancingScheme set to + // INTERNAL_SELF_MANAGED. + // Only applies when BackendService has an attachedclientTlsPolicy with + // clientCertificate (mTLS + // mode). repeated string subject_alt_names = 2 [json_name = "subjectAltNames"]; } -// Subsetting configuration for this BackendService. Currently this is -// applicable only for Internal TCP/UDP load balancing, Internal HTTP(S) load -// balancing and Traffic Director. +// Subsetting configuration for this BackendService. +// Currently this is applicable only for Internal TCP/UDP load balancing, +// Internal HTTP(S) load balancing and Traffic Director. message Subsetting { - // CONSISTENT_HASH_SUBSETTING: 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. - // NONE: 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. + // CONSISTENT_HASH_SUBSETTING: 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. + // NONE: 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. optional string policy = 1 [json_name = "policy"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_001.proto b/protos/google/cloud/compute/v1/internal/common_001.proto index 7b628616d8235..ce65bdb809927 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: 20250601 +// revision: 20260807 syntax = "proto3"; @@ -28,9 +28,11 @@ message AcceleratorConfig { optional int32 accelerator_count = 1 [json_name = "acceleratorCount"]; // 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. + // 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. optional string accelerator_type = 2 [json_name = "acceleratorType"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_002.proto b/protos/google/cloud/compute/v1/internal/common_002.proto index f1d48c4ca8d53..4389beb171687 100644 --- a/protos/google/cloud/compute/v1/internal/common_002.proto +++ b/protos/google/cloud/compute/v1/internal/common_002.proto @@ -15,242 +15,254 @@ // 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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_023.proto"; +import "google/cloud/compute/v1/internal/common_059.proto"; -// 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. -message AcceleratorType { - // [Output Only] Creation timestamp in RFC3339 text format. - optional string creation_timestamp = 1 [json_name = "creationTimestamp"]; +// Info for accelerator topologies within a densely packed reservation. +message AcceleratorTopologiesInfo { + // Info for each accelerator topology. + repeated AcceleratorTopologiesInfoAcceleratorTopologyInfo + accelerator_topology_infos = 1 [json_name = "acceleratorTopologyInfos"]; +} + +// Info for a slice of a given topology. +message AcceleratorTopologiesInfoAcceleratorTopologyInfo { + // The accelerator topology. + optional string accelerator_topology = 1 [json_name = "acceleratorTopology"]; - // [Output Only] The deprecation status associated with this accelerator type. - optional DeprecationStatus deprecated = 2 [json_name = "deprecated"]; + // Info for each topology state. + repeated AcceleratorTopologiesInfoAcceleratorTopologyInfoInfoPerTopologyState + info_per_topology_states = 2 [json_name = "infoPerTopologyStates"]; +} + +// Info for each topology state. +message AcceleratorTopologiesInfoAcceleratorTopologyInfoInfoPerTopologyState { + // The number of accelerator topologies in this state. + optional int32 count = 1 [json_name = "count"]; + + // The state of the accelerator topology. + // AVAILABLE: The accelerator topology is available. + // DEGRADED: The accelerator topology is degraded. The underlying capacity is + // not in a + // healthy state and is not available. + // RUNNING: The accelerator topology is running. If there are both running and + // degraded hosts within a topology, DEGRADED state will be returned. + // TOPOLOGY_STATE_UNSPECIFIED: The state of the topology is unspecified. + // UNHEALTHY: This value has been deprecated and is no longer used. + optional string state = 2 [json_name = "state"]; +} - // [Output Only] An optional textual description of the resource. - optional string description = 3 [json_name = "description"]; +// Represents a reservation subBlock resource. +message ReservationSubBlock { + // Output only. [Output Only] Slice info for the reservation subBlock. + optional AcceleratorTopologiesInfo accelerator_topologies_info = 12 + [json_name = "acceleratorTopologiesInfo"]; - // [Output Only] The unique identifier for the resource. This identifier is + // Output only. [Output Only] The number of hosts that are allocated in this + // reservation subBlock. + optional int32 count = 1 [json_name = "count"]; + + // Output only. [Output Only] Creation timestamp inRFC3339 text format. + optional string creation_timestamp = 2 [json_name = "creationTimestamp"]; + + // Output only. [Output Only] Health information for the reservation subBlock. + optional ReservationSubBlockHealthInfo health_info = 13 + [json_name = "healthInfo"]; + + // Output only. [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. [Output Only] The number of instances that are currently in + // use on this + // reservation subBlock. + optional int32 in_use_count = 4 [json_name = "inUseCount"]; - // [Output Only] The type of the resource. Always compute#acceleratorType for - // accelerator types. + // Output only. Number of hosts currently in use. If there is one or more + // Instances running + // on the host, it is considered in use. + optional int32 in_use_host_count = 14 [json_name = "inUseHostCount"]; + + // Output only. [Output Only] Type of the resource. + // Alwayscompute#reservationSubBlock for reservation subBlocks. optional string kind = 5 [json_name = "kind"]; - // [Output Only] Maximum number of accelerator cards allowed per instance. - optional int32 maximum_cards_per_instance = 6 - [json_name = "maximumCardsPerInstance"]; + // Output only. [Output Only] The name of this reservation subBlock generated + // by Google + // Compute Engine. The name must be 1-63 characters long, and comply with + // RFC1035 @pattern [a-z](?:[-a-z0-9]{0,61}[a-z0-9])? + optional string name = 6 [json_name = "name"]; + + // Output only. [Output Only] The physical topology of the reservation + // subBlock. + optional ReservationSubBlockPhysicalTopology physical_topology = 7 + [json_name = "physicalTopology"]; - // [Output Only] Name of the resource. - optional string name = 7 [json_name = "name"]; + // Output only. Maintenance information for this reservation subBlock. + optional GroupMaintenanceInfo reservation_sub_block_maintenance = 15 + [json_name = "reservationSubBlockMaintenance"]; - // [Output Only] Server-defined, fully qualified URL for this resource. + // Output only. [Output Only] Server-defined fully-qualified URL for this + // resource. optional string self_link = 8 [json_name = "selfLink"]; - // [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. - optional string zone = 9 [json_name = "zone"]; -} + // Output only. [Output Only] Server-defined URL for this resource with the + // resource id. + optional string self_link_with_id = 9 [json_name = "selfLinkWithId"]; -message AcceleratorTypeAggregatedList { - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 1 [json_name = "id"]; + // Output only. [Output Only] Status of the reservation subBlock. + // CREATING: Resources are being allocated for the reservation subBlock. + // DELETING: Reservation subBlock is currently being deleted. + // INVALID: + // READY: Reservation subBlock has allocated all its resources. + optional string status = 10 [json_name = "status"]; - // A list of AcceleratorTypesScopedList resources. - map items = 2 [json_name = "items"]; + // Output only. [Output Only] Zone in which the reservation subBlock resides. + optional string zone = 11 [json_name = "zone"]; +} - // [Output Only] Type of resource. Always - // compute#acceleratorTypeAggregatedList for aggregated lists of accelerator - // types. - optional string kind = 3 [json_name = "kind"]; +// Health information for the reservation subBlock. +message ReservationSubBlockHealthInfo { + // The number of degraded hosts in the reservation subBlock. + optional int32 degraded_host_count = 1 [json_name = "degradedHostCount"]; - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value 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 number of degraded infrastructure (e.g NV link domain) in the + // reservation subblock. + optional int32 degraded_infra_count = 2 [json_name = "degradedInfraCount"]; - // [Output Only] Server-defined URL for this resource. - optional string self_link = 5 [json_name = "selfLink"]; + // The health status of the reservation subBlock. + // DEGRADED: The reservation subBlock is degraded. + // HEALTHY: The reservation subBlock is healthy. + // HEALTH_STATUS_UNSPECIFIED: The health status of the reservation subBlock is + // unspecified. + optional string health_status = 3 [json_name = "healthStatus"]; - // [Output Only] Unreachable resources. - repeated string unreachables = 6 [json_name = "unreachables"]; + // The number of healthy hosts in the reservation subBlock. + optional int32 healthy_host_count = 4 [json_name = "healthyHostCount"]; - 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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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 number of healthy infrastructure (e.g NV link domain) in the + // reservation subblock. + optional int32 healthy_infra_count = 5 [json_name = "healthyInfraCount"]; +} - 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 ReservationSubBlockPhysicalTopology { + // The hash of the capacity block within the cluster. + optional string block = 1 [json_name = "block"]; - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } + // The cluster name of the reservation subBlock. + optional string cluster = 2 [json_name = "cluster"]; - // [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 hash of the capacity sub-block within the capacity block. + optional string sub_block = 3 [json_name = "subBlock"]; +} - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } +message ReservationSubBlocksGetResponse { + optional ReservationSubBlock resource = 1 [json_name = "resource"]; +} - // [Output Only] Informational warning message. - optional Warning warning = 7 [json_name = "warning"]; +message ReservationSubBlocksGetVersionRequest { + // The SBOM selection to return. + repeated string sbom_selections = 1 [json_name = "sbomSelections"]; } -// Contains a list of accelerator types. -message AcceleratorTypeList { - // [Output Only] Unique identifier for the resource; defined by the server. +// A list of reservation subBlocks under a single reservation. +message ReservationSubBlocksListResponse { + // Unique identifier for the resource; defined by the server. optional string id = 1 [json_name = "id"]; - // A list of AcceleratorType resources. - repeated AcceleratorType items = 2 [json_name = "items"]; + // A list of reservation subBlock resources. + repeated ReservationSubBlock items = 2 [json_name = "items"]; - // [Output Only] Type of resource. Always compute#acceleratorTypeList for - // lists of accelerator types. + // Type of the resource. Alwayscompute#reservationSubBlock for a list of + // reservation + // subBlocks. 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 + // This token allows you to get the next page of results for + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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. + // 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. + // [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. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -259,118 +271,64 @@ message AcceleratorTypeList { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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. + // Informational warning message. optional Warning warning = 6 [json_name = "warning"]; } -message AcceleratorTypesScopedList { - // [Output Only] A list of accelerator types contained in this scope. - repeated AcceleratorType accelerator_types = 1 - [json_name = "acceleratorTypes"]; - - 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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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 ReservationSubBlocksReportFaultyRequest { + // The disruption schedule for the subBlock. + // DISRUPTION_SCHEDULE_UNSPECIFIED: + // IMMEDIATE: All VMs will be disrupted immediately. + optional string disruption_schedule = 1 [json_name = "disruptionSchedule"]; + + // The component that experienced the fault. + // FAILURE_COMPONENT_UNSPECIFIED: + // MULTIPLE_FAULTY_HOSTS: Multiple hosts experienced the fault. + // NVLINK_SWITCH: The NVLink switch experienced the fault. + optional string failure_component = 2 [json_name = "failureComponent"]; + + // The reasons for the fault experienced with the subBlock. + repeated ReservationSubBlocksReportFaultyRequestFaultReason fault_reasons = 3 + [json_name = "faultReasons"]; +} - // [Output Only] An informational warning that appears when the accelerator - // types list is empty. - optional Warning warning = 2 [json_name = "warning"]; +// The reason for the fault experienced with the subBlock. +message ReservationSubBlocksReportFaultyRequestFaultReason { + // The behavior of the fault experienced with the subBlock. + // FAULT_BEHAVIOR_UNSPECIFIED: + // GPU_ERROR: The subBlock experienced a GPU error. + // PERFORMANCE: The subBlock experienced performance issues. + // SILENT_DATA_CORRUPTION: The subBlock experienced silent data corruption. + // SWITCH_FAILURE: The subBlock experienced a switch failure. + optional string behavior = 1 [json_name = "behavior"]; + + // The description of the fault experienced with the subBlock. + optional string description = 2 [json_name = "description"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_003.proto b/protos/google/cloud/compute/v1/internal/common_003.proto index f7d4374dd073b..04ecb61ca19cb 100644 --- a/protos/google/cloud/compute/v1/internal/common_003.proto +++ b/protos/google/cloud/compute/v1/internal/common_003.proto @@ -15,833 +15,436 @@ // 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: 20250601 +// revision: 20260807 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_029.proto"; -import "google/cloud/compute/v1/internal/common_033.proto"; -import "google/cloud/compute/v1/internal/common_081.proto"; - -// An access configuration attached to an instance's network interface. Only one -// access config per instance is supported. -message AccessConfig { - // 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. - optional string external_ipv6 = 1 [json_name = "externalIpv6"]; - - // Applies to ipv6AccessConfigs only. The prefix length of the external IPv6 - // range. - optional int32 external_ipv6_prefix_length = 2 - [json_name = "externalIpv6PrefixLength"]; - - // [Output Only] Type of the resource. Always compute#accessConfig for access - // configs. - optional string kind = 3 [json_name = "kind"]; - - // 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. - optional string name = 4 [json_name = "name"]; - - // 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. - optional string nat_ip = 5 [json_name = "natIP"]; - - // 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. - // 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 = 6 [json_name = "networkTier"]; - - // 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. - optional string public_ptr_domain_name = 7 - [json_name = "publicPtrDomainName"]; - - // The resource URL for the security policy associated with this access - // config. - optional string security_policy = 10 [json_name = "securityPolicy"]; - - // 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. - optional bool set_public_ptr = 8 [json_name = "setPublicPtr"]; - - // 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. - // DIRECT_IPV6: - // ONE_TO_ONE_NAT: - optional string type = 9 [json_name = "type"]; -} - -// 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). -message AdvancedMachineFeatures { - // Whether to enable nested virtualization or not (default is false). - optional bool enable_nested_virtualization = 1 - [json_name = "enableNestedVirtualization"]; - - // Whether to enable UEFI networking for instance creation. - optional bool enable_uefi_networking = 2 [json_name = "enableUefiNetworking"]; - - // Type of Performance Monitoring Unit requested on instance. - // ARCHITECTURAL: Architecturally defined non-LLC events. - // ENHANCED: Most documented core/L2 and LLC events. - // PERFORMANCE_MONITORING_UNIT_UNSPECIFIED: - // STANDARD: Most documented core/L2 events. - optional string performance_monitoring_unit = 5 - [json_name = "performanceMonitoringUnit"]; - - // 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. - optional int32 threads_per_core = 3 [json_name = "threadsPerCore"]; - - // 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. - optional string turbo_mode = 6 [json_name = "turboMode"]; - - // 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. - optional int32 visible_core_count = 4 [json_name = "visibleCoreCount"]; -} - -// An alias IP range attached to an instance's network interface. -message AliasIpRange { - // 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). - optional string ip_cidr_range = 1 [json_name = "ipCidrRange"]; - - // 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. - optional string subnetwork_range_name = 2 [json_name = "subnetworkRangeName"]; -} - -// An instance-attached disk resource. -message AttachedDisk { - // [Output Only] The architecture of the attached 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"]; - - // 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 = 2 [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 = 3 [json_name = "boot"]; - - // 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. - optional string device_name = 4 [json_name = "deviceName"]; - - // 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. - optional CustomerEncryptionKey disk_encryption_key = 5 - [json_name = "diskEncryptionKey"]; - - // The size of the disk in GB. - optional string disk_size_gb = 6 [json_name = "diskSizeGb"]; - - // [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. - optional bool force_attach = 7 [json_name = "forceAttach"]; - - // 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 = 8 [json_name = "guestOsFeatures"]; - - // [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. - optional int32 index = 9 [json_name = "index"]; - - // [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. - optional AttachedDiskInitializeParams initialize_params = 10 - [json_name = "initializeParams"]; - - // 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. - // NVME: - // SCSI: - optional string interface = 11 [json_name = "interface"]; - - // [Output Only] Type of the resource. Always compute#attachedDisk for - // attached disks. - optional string kind = 12 [json_name = "kind"]; - - // [Output Only] Any valid publicly visible licenses. - repeated string licenses = 13 [json_name = "licenses"]; - - // 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 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 = 14 [json_name = "mode"]; - - // 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. - // DISK_SAVED_STATE_UNSPECIFIED: *[Default]* Disk state has not been - // preserved. - // PRESERVED: Disk state has been preserved. - optional string saved_state = 18 [json_name = "savedState"]; - - // [Output Only] shielded vm initial state stored on disk - optional InitialStateConfig shielded_instance_initial_state = 15 - [json_name = "shieldedInstanceInitialState"]; - - // 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. - optional string source = 16 [json_name = "source"]; - - // Specifies the type of the disk, either SCRATCH or PERSISTENT. If not - // specified, the default is PERSISTENT. - // PERSISTENT: - // SCRATCH: - optional string type = 17 [json_name = "type"]; -} - -// [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. -message AttachedDiskInitializeParams { - // The architecture of the attached 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"]; - - // An optional description. Provide this property when creating the disk. - optional string description = 2 [json_name = "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. - optional string disk_name = 3 [json_name = "diskName"]; - - // 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. - optional string disk_size_gb = 4 [json_name = "diskSizeGb"]; - - // 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. - optional string disk_type = 5 [json_name = "diskType"]; - - // Whether this disk is using confidential compute mode. - optional bool enable_confidential_compute = 18 - [json_name = "enableConfidentialCompute"]; - - // Labels to apply to this disk. These can be later modified by the - // disks.setLabels method. This field is only applicable for persistent disks. - map labels = 6 [json_name = "labels"]; - - // A list of publicly visible licenses. Reserved for Google's use. - repeated string licenses = 7 [json_name = "licenses"]; - - // Specifies which action to take on instance update with this disk. Default - // is to use the existing disk. - // RECREATE_DISK: Always recreate the disk. - // RECREATE_DISK_IF_SOURCE_CHANGED: Recreate the disk if source (image, - // snapshot) of this disk is different from source of existing disk. - // USE_EXISTING_DISK: Use the existing disk, this is the default behaviour. - optional string on_update_action = 8 [json_name = "onUpdateAction"]; - - // 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 = 9 [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 - // greater than or equal to 1. - optional string provisioned_throughput = 16 - [json_name = "provisionedThroughput"]; - - // 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. - repeated string replica_zones = 17 [json_name = "replicaZones"]; - - // 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 = 10 - [json_name = "resourceManagerTags"]; - - // 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. - repeated string resource_policies = 11 [json_name = "resourcePolicies"]; - - // 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. - optional string source_image = 12 [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. - // 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. - optional CustomerEncryptionKey source_image_encryption_key = 13 - [json_name = "sourceImageEncryptionKey"]; - - // 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. Note: You cannot create VMs in - // bulk using a snapshot as the source. Use an image instead when you create - // VMs using the bulk insert method. - optional string source_snapshot = 14 [json_name = "sourceSnapshot"]; - - // The customer-supplied encryption key of the source snapshot. - optional CustomerEncryptionKey source_snapshot_encryption_key = 15 - [json_name = "sourceSnapshotEncryptionKey"]; - - // 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 = 19 [json_name = "storagePool"]; -} - -// A set of Confidential Instance options. -message ConfidentialInstanceConfig { - // Defines the type of technology used by the confidential instance. - // CONFIDENTIAL_INSTANCE_TYPE_UNSPECIFIED: No type specified. Do not use this - // 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"]; - - // Defines whether the instance should have confidential compute enabled. - optional bool enable_confidential_compute = 1 - [json_name = "enableConfidentialCompute"]; -} +import "google/cloud/compute/v1/internal/common_032.proto"; +import "google/cloud/compute/v1/internal/common_134.proto"; -message InstanceProperties { - // Controls for advanced machine-related behavior features. Note that for - // MachineImage, this is not supported yet. - optional AdvancedMachineFeatures advanced_machine_features = 1 - [json_name = "advancedMachineFeatures"]; - - // 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. - optional bool can_ip_forward = 2 [json_name = "canIpForward"]; - - // Specifies the Confidential Instance options. Note that for MachineImage, - // this is not supported yet. - optional ConfidentialInstanceConfig confidential_instance_config = 3 - [json_name = "confidentialInstanceConfig"]; - - // An optional text description for the instances that are created from these - // properties. - optional string description = 4 [json_name = "description"]; - - // An array of disks that are associated with the instances that are created - // from these properties. - repeated AttachedDisk disks = 5 [json_name = "disks"]; - - // A list of guest accelerator cards' type and count to use for instances - // created from these properties. - repeated AcceleratorConfig guest_accelerators = 6 - [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 = 7 - [json_name = "keyRevocationActionType"]; - - // Labels to apply to instances that are created from these properties. - map labels = 8 [json_name = "labels"]; - - // 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`. - optional string machine_type = 9 [json_name = "machineType"]; - - // 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. - optional Metadata metadata = 10 [json_name = "metadata"]; - - // 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. - optional string min_cpu_platform = 11 [json_name = "minCpuPlatform"]; - - // An array of network access configurations for this interface. - repeated NetworkInterface network_interfaces = 12 - [json_name = "networkInterfaces"]; - - // Note that for MachineImage, this is not supported yet. - optional NetworkPerformanceConfig network_performance_config = 13 - [json_name = "networkPerformanceConfig"]; - - // 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. - // 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 = 14 - [json_name = "privateIpv6GoogleAccess"]; - - // Specifies the reservations that instances can consume from. Note that for - // MachineImage, this is not supported yet. - optional ReservationAffinity reservation_affinity = 15 - [json_name = "reservationAffinity"]; - - // 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 = 16 - [json_name = "resourceManagerTags"]; - - // Resource policies (names, not URLs) applied to instances created from these - // properties. Note that for MachineImage, this is not supported yet. - repeated string resource_policies = 17 [json_name = "resourcePolicies"]; - - // Specifies the scheduling options for the instances that are created from - // these properties. - optional Scheduling scheduling = 18 [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 these - // properties. Use metadata queries to obtain the access tokens for these - // instances. - repeated ServiceAccount service_accounts = 19 [json_name = "serviceAccounts"]; - - // Note that for MachineImage, this is not supported yet. - optional ShieldedInstanceConfig shielded_instance_config = 20 - [json_name = "shieldedInstanceConfig"]; - - // 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. - optional Tags tags = 21 [json_name = "tags"]; -} - -// A network interface resource attached to an instance. -message NetworkInterface { - // 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. - repeated AccessConfig access_configs = 1 [json_name = "accessConfigs"]; - - // An array of alias IP ranges for this network interface. You can only - // specify this field for network interfaces in VPC networks. - repeated AliasIpRange alias_ip_ranges = 2 [json_name = "aliasIpRanges"]; - - // 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. - optional string fingerprint = 3 [json_name = "fingerprint"]; - - // The prefix length of the primary internal IPv6 range. - optional int32 internal_ipv6_prefix_length = 4 - [json_name = "internalIpv6PrefixLength"]; - - // 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. - repeated AccessConfig ipv6_access_configs = 5 - [json_name = "ipv6AccessConfigs"]; - - // [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. - // EXTERNAL: This network interface can have external IPv6. - // INTERNAL: This network interface can have internal IPv6. - optional string ipv6_access_type = 6 [json_name = "ipv6AccessType"]; - - // 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. - optional string ipv6_address = 7 [json_name = "ipv6Address"]; - - // [Output Only] Type of the resource. Always compute#networkInterface for - // network interfaces. - optional string kind = 8 [json_name = "kind"]; - - // [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. - optional string name = 9 [json_name = "name"]; - - // 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 - optional string network = 10 [json_name = "network"]; - - // 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}. - optional string network_attachment = 11 [json_name = "networkAttachment"]; - - // 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. - optional string network_ip = 12 [json_name = "networkIP"]; - - // The type of vNIC to be used on this interface. This may be gVNIC or - // VirtioNet. - // GVNIC: GVNIC - // IDPF: IDPF - // IRDMA: IRDMA - // MRDMA: MRDMA - // UNSPECIFIED_NIC_TYPE: No type specified. - // VIRTIO_NET: VIRTIO - optional string nic_type = 13 [json_name = "nicType"]; - - // 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. - optional int32 queue_count = 14 [json_name = "queueCount"]; - - // 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. - // IPV4_IPV6: The network interface can have both IPv4 and IPv6 addresses. - // 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 - // 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 - optional string subnetwork = 16 [json_name = "subnetwork"]; -} - -message NetworkPerformanceConfig { - // DEFAULT: - // TIER_1: - optional string total_egress_bandwidth_tier = 1 - [json_name = "totalEgressBandwidthTier"]; +// 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, readGPUs on Compute Engine. +message AcceleratorType { + // [Output Only] Creation timestamp inRFC3339 text format. + optional string creation_timestamp = 1 [json_name = "creationTimestamp"]; + + // [Output Only] The deprecation status associated with this accelerator type. + optional DeprecationStatus deprecated = 2 [json_name = "deprecated"]; + + // [Output Only] An optional 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. [Output Only] The type of the resource. + // Alwayscompute#acceleratorType for accelerator types. + optional string kind = 5 [json_name = "kind"]; + + // [Output Only] Maximum number of accelerator cards allowed per instance. + optional int32 maximum_cards_per_instance = 6 + [json_name = "maximumCardsPerInstance"]; + + // [Output Only] Name of the resource. + optional string name = 7 [json_name = "name"]; + + // Output only. Contains standard resource metadata for an AcceleratorType + // resource. It is populated for each instance of the AcceleratorType + // resource, and includes the api_version the + // instance was retrieved through, and its canonical + // resource_type name. + optional ResourceMetadata resource_metadata = 10 + [json_name = "resourceMetadata"]; + + // Output only. [Output Only] Server-defined, fully qualified URL for this + // resource. + optional string self_link = 8 [json_name = "selfLink"]; + + // [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. + optional string zone = 9 [json_name = "zone"]; } -// Specifies the reservations that this instance can consume from. -message ReservationAffinity { - // 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. - // ANY_RESERVATION: Consume any allocation available. - // NO_RESERVATION: Do not consume from any allocated capacity. - // SPECIFIC_RESERVATION: Must consume from a specific reservation. Must - // specify key value fields for specifying the reservations. - // UNSPECIFIED: - optional string consume_reservation_type = 1 - [json_name = "consumeReservationType"]; - - // 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. - optional string key = 2 [json_name = "key"]; - - // 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. - repeated string values = 3 [json_name = "values"]; -} +message AcceleratorTypeAggregatedList { + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 1 [json_name = "id"]; -// Sets the scheduling options for an Instance. -message Scheduling { - // 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. - optional bool automatic_restart = 1 [json_name = "automaticRestart"]; - - // 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 = 10 [json_name = "availabilityDomain"]; - - // Specify the time in seconds for host error detection, the value must be - // within the range of [90, 330] with the increment of 30, if unset, the - // default behavior of host error recovery will be used. - optional int32 host_error_timeout_seconds = 14 - [json_name = "hostErrorTimeoutSeconds"]; - - // Specifies the termination action for the instance. - // DELETE: Delete the VM. - // INSTANCE_TERMINATION_ACTION_UNSPECIFIED: Default value. This value is - // unused. - // STOP: Stop the VM without storing in-memory content. default action. - optional string instance_termination_action = 2 - [json_name = "instanceTerminationAction"]; - - // 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. - optional Duration local_ssd_recovery_timeout = 9 - [json_name = "localSsdRecoveryTimeout"]; - - // 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. - optional string location_hint = 3 [json_name = "locationHint"]; - - // 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. - optional Duration max_run_duration = 11 [json_name = "maxRunDuration"]; - - // The minimum number of virtual CPUs this instance will consume when running - // on a sole-tenant node. - optional int32 min_node_cpus = 4 [json_name = "minNodeCpus"]; - - // A set of node affinity and anti-affinity configurations. Refer to - // Configuring node affinity for more information. Overrides - // reservationAffinity. - repeated SchedulingNodeAffinity node_affinities = 5 - [json_name = "nodeAffinities"]; - - // 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. - // MIGRATE: *[Default]* Allows Compute Engine to automatically migrate - // instances out of the way of maintenance events. - // TERMINATE: 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. - optional string on_host_maintenance = 6 [json_name = "onHostMaintenance"]; - - optional SchedulingOnInstanceStopAction on_instance_stop_action = 12 - [json_name = "onInstanceStopAction"]; - - // 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. - optional bool preemptible = 7 [json_name = "preemptible"]; - - // Specifies the provisioning model of the instance. - // RESERVATION_BOUND: Bound to the lifecycle of the reservation in which it is - // provisioned. - // SPOT: Heavily discounted, no guaranteed runtime. - // STANDARD: Standard provisioning with user controlled runtime, no discounts. - optional string provisioning_model = 8 [json_name = "provisioningModel"]; - - // 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. - optional string termination_time = 13 [json_name = "terminationTime"]; -} + // A list of AcceleratorTypesScopedList resources. + map items = 2 [json_name = "items"]; -// Node Affinity: the configuration of desired nodes onto which this Instance -// could be scheduled. -message SchedulingNodeAffinity { - // Corresponds to the label key of Node resource. - optional string key = 1 [json_name = "key"]; - - // Defines the operation of node selection. Valid operators are IN for - // affinity and NOT_IN for anti-affinity. - // IN: Requires Compute Engine to seek for matched nodes. - // NOT_IN: Requires Compute Engine to avoid certain nodes. - // OPERATOR_UNSPECIFIED: - optional string operator = 2 [json_name = "operator"]; - - // Corresponds to the label values of Node resource. - repeated string values = 3 [json_name = "values"]; -} + // Output only. [Output Only] Type of resource. + // Alwayscompute#acceleratorTypeAggregatedList for aggregated lists of + // accelerator types. + optional string kind = 3 [json_name = "kind"]; -// Defines the behaviour for instances with the instance_termination_action -// STOP. -message SchedulingOnInstanceStopAction { - // 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. - optional bool discard_local_ssd = 1 [json_name = "discardLocalSsd"]; + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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. [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + // Output only. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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"]; } -// A service account. -message ServiceAccount { - // Email address of the service account. - optional string email = 1 [json_name = "email"]; +// Contains a list of accelerator types. +message AcceleratorTypeList { + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 1 [json_name = "id"]; - // The list of scopes to be made available for this service account. - repeated string scopes = 2 [json_name = "scopes"]; -} - -// A set of Shielded Instance options. -message ShieldedInstanceConfig { - // Defines whether the instance has integrity monitoring enabled. Enabled by - // default. - optional bool enable_integrity_monitoring = 1 - [json_name = "enableIntegrityMonitoring"]; + // A list of AcceleratorType resources. + repeated AcceleratorType items = 2 [json_name = "items"]; - // Defines whether the instance has Secure Boot enabled. Disabled by default. - optional bool enable_secure_boot = 2 [json_name = "enableSecureBoot"]; + // Output only. [Output Only] Type of resource. + // Alwayscompute#acceleratorTypeList for lists of accelerator types. + optional string kind = 3 [json_name = "kind"]; - // Defines whether the instance has the vTPM enabled. Enabled by default. - optional bool enable_vtpm = 3 [json_name = "enableVtpm"]; + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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 set of instance tags. -message Tags { - // 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. - optional string fingerprint = 1 [json_name = "fingerprint"]; - - // An array of tags. Each tag must be 1-63 characters long, and comply with - // RFC1035. - repeated string items = 2 [json_name = "items"]; +message AcceleratorTypesScopedList { + // [Output Only] A list of accelerator types contained in this scope. + repeated AcceleratorType accelerator_types = 1 + [json_name = "acceleratorTypes"]; + + 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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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 accelerator + // types list is empty. + optional Warning warning = 2 [json_name = "warning"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_004.proto b/protos/google/cloud/compute/v1/internal/common_004.proto index 91ae0a18364d2..70595fdb595c1 100644 --- a/protos/google/cloud/compute/v1/internal/common_004.proto +++ b/protos/google/cloud/compute/v1/internal/common_004.proto @@ -15,269 +15,1085 @@ // 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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -// 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. -message Address { - // The static IP address represented by this resource. - optional string address = 1 [json_name = "address"]; - - // The type of address to reserve, either INTERNAL or EXTERNAL. If - // unspecified, defaults to EXTERNAL. - // EXTERNAL: A publicly visible external IP address. - // INTERNAL: A private network IP address, for use with an Instance or - // Internal Load Balancer forwarding rule. - // UNSPECIFIED_TYPE: - optional string address_type = 2 [json_name = "addressType"]; - - // [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"]; +import "google/cloud/compute/v1/internal/common_001.proto"; +import "google/cloud/compute/v1/internal/common_028.proto"; +import "google/cloud/compute/v1/internal/common_038.proto"; +import "google/cloud/compute/v1/internal/common_042.proto"; +import "google/cloud/compute/v1/internal/common_096.proto"; - // [Output Only] The unique identifier for the resource. This identifier is - // defined by the server. - optional string id = 5 [json_name = "id"]; - - // The IP version that will be used by this address. Valid options are IPV4 or - // IPV6. - // IPV4: - // IPV6: - // UNSPECIFIED_VERSION: - optional string ip_version = 6 [json_name = "ipVersion"]; - - // 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. - // NETLB: Reserved IPv6 address can be used on network load balancer. - // VM: Reserved IPv6 address can be used on VM. - optional string ipv6_endpoint_type = 7 [json_name = "ipv6EndpointType"]; - - // [Output Only] Type of the resource. Always compute#address for addresses. - optional string kind = 8 [json_name = "kind"]; +// An access configuration attached to an instance's network interface. +// Only one access config per instance is supported. +message AccessConfig { + // Applies to ipv6AccessConfigs only. + // The first IPv6 address of the external IPv6 range associated + // with this instance, prefix length is stored inexternalIpv6PrefixLength 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. + optional string external_ipv6 = 1 [json_name = "externalIpv6"]; - // 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. - optional string label_fingerprint = 19 [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 = 20 [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 = 9 [json_name = "name"]; + // Applies to ipv6AccessConfigs only. The prefix length of the + // external IPv6 range. + optional int32 external_ipv6_prefix_length = 2 + [json_name = "externalIpv6PrefixLength"]; - // 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. - optional string network = 10 [json_name = "network"]; + // Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig + // for access configs. + optional string kind = 3 [json_name = "kind"]; + + // 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 orNetwork Access. + // In ipv6AccessConfigs, the + // recommend name is External IPv6. + optional string name = 4 [json_name = "name"]; + + // Applies to accessConfigs (IPv4) only. Anexternal 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. + optional string nat_ip = 5 [json_name = "natIP"]; - // 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. + // 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. // FIXED_STANDARD: Public internet quality with fixed bandwidth. // PREMIUM: High quality, Google-grade network tier, support for all - // networking products. + // networking + // products. // STANDARD: Public internet quality, only limited support for other - // networking products. + // 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 = 11 [json_name = "networkTier"]; - - // The prefix length if the resource represents an IP range. - optional int32 prefix_length = 12 [json_name = "prefixLength"]; - - // 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. - // DNS_RESOLVER: DNS resolver address in the subnetwork. - // GCE_ENDPOINT: VM internal/alias IP, Internal LB service IP, etc. - // IPSEC_INTERCONNECT: 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. - // NAT_AUTO: External IP automatically reserved for Cloud NAT. - // PRIVATE_SERVICE_CONNECT: 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 - // SERVERLESS: A regional internal IP address range reserved for Serverless. - // SHARED_LOADBALANCER_VIP: A private network IP address that can be shared by - // multiple Internal Load Balancer forwarding rules. - // VPC_PEERING: IP range for peer networks. - optional string purpose = 13 [json_name = "purpose"]; - - // [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.* - optional string region = 14 [json_name = "region"]; - - // [Output Only] Server-defined URL for the resource. - optional string self_link = 15 [json_name = "selfLink"]; - - // [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. - // IN_USE: Address is being used by another resource and is not available. - // RESERVED: Address is reserved and available to use. - // RESERVING: Address is being reserved. - optional string status = 16 [json_name = "status"]; - - // 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. - optional string subnetwork = 17 [json_name = "subnetwork"]; - - // [Output Only] The URLs of the resources that are using this address. - repeated string users = 18 [json_name = "users"]; + // FIXED_STANDARD when fixed standard tier + // is expired or not configured. + optional string network_tier = 6 [json_name = "networkTier"]; + + // The DNS domain name for the public PTR record. + // + // You can set this field only if the `setPublicPtr` field is enabled + // inaccessConfig. If this field is unspecified inipv6AccessConfig, a default + // PTR record will be created for + // first IP in associated external IPv6 range. + optional string public_ptr_domain_name = 7 + [json_name = "publicPtrDomainName"]; + + // The resource URL for the security policy associated with this access + // config. + optional string security_policy = 10 [json_name = "securityPolicy"]; + + // 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. + optional bool set_public_ptr = 8 [json_name = "setPublicPtr"]; + + // The type of configuration. In accessConfigs (IPv4), the + // default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default + // and only option isDIRECT_IPV6. + // DIRECT_IPV6: + // ONE_TO_ONE_NAT: + optional string type = 9 [json_name = "type"]; } -// Contains a list of addresses. -message AddressList { - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 1 [json_name = "id"]; +// 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 anImage (e.g., whether or not +// the OS in theImage supports nested virtualization being enabled or +// disabled). +message AdvancedMachineFeatures { + // Whether to enable nested virtualization or not (default is false). + optional bool enable_nested_virtualization = 1 + [json_name = "enableNestedVirtualization"]; - // A list of Address resources. - repeated Address items = 2 [json_name = "items"]; + // Whether to enable UEFI networking for instance creation. + optional bool enable_uefi_networking = 2 [json_name = "enableUefiNetworking"]; - // [Output Only] Type of resource. Always compute#addressList for lists of - // addresses. - optional string kind = 3 [json_name = "kind"]; + // Type of Performance Monitoring Unit requested on instance. + // ARCHITECTURAL: Architecturally defined non-LLC events. + // ENHANCED: Most documented core/L2 and LLC events. + // PERFORMANCE_MONITORING_UNIT_UNSPECIFIED: + // STANDARD: Most documented core/L2 events. + optional string performance_monitoring_unit = 5 + [json_name = "performanceMonitoringUnit"]; + + // 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. + optional int32 threads_per_core = 3 [json_name = "threadsPerCore"]; + + // 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. + optional string turbo_mode = 6 [json_name = "turboMode"]; + + // 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. + optional int32 visible_core_count = 4 [json_name = "visibleCoreCount"]; +} + +// An alias IP range attached to an instance's network interface. +message AliasIpRange { + // 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 as10.1.2.0/24). + optional string ip_cidr_range = 1 [json_name = "ipCidrRange"]; + + // 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. + optional string subnetwork_range_name = 2 [json_name = "subnetworkRangeName"]; +} + +// An instance-attached disk resource. +message AttachedDisk { + // Output only. [Output Only] The architecture of the attached 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"]; + + // 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 = 2 [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 = 3 [json_name = "boot"]; + + // 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. + optional string device_name = 4 [json_name = "deviceName"]; + + // Encrypts or decrypts a disk using acustomer-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 storecustomer-supplied + // encryption keys, so you cannot use your own keys to encrypt disks in + // amanaged instance group. + // + // You cannot create VMs that have disks with customer-supplied keys using + // the bulk + // insert method. + optional CustomerEncryptionKey disk_encryption_key = 5 + [json_name = "diskEncryptionKey"]; + + // The size of the disk in GB. + optional string disk_size_gb = 6 [json_name = "diskSizeGb"]; + + // [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. + optional bool force_attach = 7 [json_name = "forceAttach"]; + + // 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 = 8 [json_name = "guestOsFeatures"]; + + // Output only. [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. + optional int32 index = 9 [json_name = "index"]; + + // [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. + optional AttachedDiskInitializeParams initialize_params = 10 + [json_name = "initializeParams"]; + + // 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, seeAbout + // persistent disks. + // NVME: + // SCSI: + optional string interface = 11 [json_name = "interface"]; + + // Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk + // for attached disks. + optional string kind = 12 [json_name = "kind"]; + + // Output only. [Output Only] Any valid publicly visible licenses. + repeated string licenses = 13 [json_name = "licenses"]; + + // The mode in which to attach this disk, either READ_WRITE orREAD_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 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 = 14 [json_name = "mode"]; + + // Output only. 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. + // DISK_SAVED_STATE_UNSPECIFIED: *[Default]* Disk state has not been + // preserved. + // PRESERVED: Disk state has been preserved. + optional string saved_state = 18 [json_name = "savedState"]; + + // Output only. [Output Only] shielded vm initial state stored on disk + optional InitialStateConfig shielded_instance_initial_state = 15 + [json_name = "shieldedInstanceInitialState"]; + + // Specifies a valid partial or full URL to an existing Persistent Disk + // resource. When creating a new instance boot disk, one + // ofinitializeParams.sourceImage orinitializeParams.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. + optional string source = 16 [json_name = "source"]; + + // Specifies the type of the disk, either SCRATCH orPERSISTENT. If not + // specified, the default isPERSISTENT. + // PERSISTENT: + // SCRATCH: + optional string type = 17 [json_name = "type"]; +} + +// [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. +message AttachedDiskInitializeParams { + // The architecture of the attached 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"]; + + // An optional description. Provide this property when creating the disk. + optional string description = 2 [json_name = "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. + optional string disk_name = 3 [json_name = "diskName"]; + + // 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. + optional string disk_size_gb = 4 [json_name = "diskSizeGb"]; + + // Specifies the disk type used for the boot disk or an additional data + // disk. For valid disk type values, see + // Supported types for Hyperdisk volumes and + // Persistent Disk type variables. + // + // When creating a single instance, you must provide either the full or + // partial URL of the disk type. 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 + // + // + // + // When creating an instance template, instance flexibility policy, or when + // creating or updating an all-instances configuration, you specify the + // disk type without a URL, for example, hyperdisk-balanced. + // + // If you omit this field for a disk, the default disk type depends on + // the instance's machine series, as follows. + // + // + // - For first- and second-generation machine series like N1, N2, T2, and + // M1, the + // default disk type is Standard Persistent Disk + // (pd-standard). + // - For C3, C3D, and M3 the default is Balanced Persistent Disk + // (pd-balanced). + // - For other third-generation machine + // series like A3, H3, Z3, all + // fourth-generation types like C4, N4, M4, and newer machine series, + // the default is Hyperdisk Balanced + // (hyperdisk-balanced). + // + // + // + // The disk type you specify must be compatible with the instance's machine + // series. For a list of machine series that support Persistent Disk, see + // Machine + // series support for Persistent Disk. + // + // For a list of machine series that support Hyperdisk, seeMachine + // series support for Hyperdisk. + optional string disk_type = 5 [json_name = "diskType"]; + + // Whether this disk is using confidential compute mode. + optional bool enable_confidential_compute = 18 + [json_name = "enableConfidentialCompute"]; + + // Labels to apply to this disk. These can be later modified by + // thedisks.setLabels method. This field is only applicable for + // persistent disks. + map labels = 6 [json_name = "labels"]; + + // A list of publicly visible licenses. Reserved for Google's use. + repeated string licenses = 7 [json_name = "licenses"]; + + // Specifies which action to take on instance update with this disk. Default + // is to use the existing disk. + // RECREATE_DISK: Always recreate the disk. + // RECREATE_DISK_IF_SOURCE_CHANGED: Recreate the disk if source (image, + // snapshot) of this disk is different + // from source of existing disk. + // USE_EXISTING_DISK: Use the existing disk, this is the default behaviour. + optional string on_update_action = 8 [json_name = "onUpdateAction"]; + + // 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 theExtreme persistent + // disk documentation. + optional string provisioned_iops = 9 [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 + // greater than or equal to 1. + optional string provisioned_throughput = 16 + [json_name = "provisionedThroughput"]; + + // 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. + repeated string replica_zones = 17 [json_name = "replicaZones"]; + + // Input only. Resource manager tags to be bound to the disk. Tag keys and + // values + // have the same definition as resource + // manager tags. Keys and values can be either in numeric format, + // such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in + // namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and + // `{tag_value_short_name}`. The field is ignored (both PUT & PATCH) when + // empty. + map resource_manager_tags = 10 + [json_name = "resourceManagerTags"]; + + // 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. + repeated string resource_policies = 11 [json_name = "resourcePolicies"]; + + // The source image to create this disk. When creating a new instance boot + // disk, one of initializeParams.sourceImage orinitializeParams.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, + // specifyfamily/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. + optional string source_image = 12 [json_name = "sourceImage"]; + + // Thecustomer-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 storecustomer-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. + optional CustomerEncryptionKey source_image_encryption_key = 13 + [json_name = "sourceImageEncryptionKey"]; + + // The source snapshot to create this disk. When creating a new instance + // boot disk, one of initializeParams.sourceSnapshot + // orinitializeParams.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. + // + // Note: You cannot create VMs in bulk using a snapshot as the source. Use + // an image instead when you create VMs using + // the bulk + // insert method. + optional string source_snapshot = 14 [json_name = "sourceSnapshot"]; + + // Thecustomer-supplied + // encryption key of the source snapshot. + optional CustomerEncryptionKey source_snapshot_encryption_key = 15 + [json_name = "sourceSnapshotEncryptionKey"]; + + // 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 = 19 [json_name = "storagePool"]; +} + +// A set of Confidential Instance options. +message ConfidentialInstanceConfig { + // Defines the type of technology used by the confidential instance. + // CCA: Arm Confidential Compute Architecture. + // CONFIDENTIAL_INSTANCE_TYPE_UNSPECIFIED: No type specified. Do not use this + // 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"]; + + // Defines whether the instance should have confidential compute enabled. + optional bool enable_confidential_compute = 1 + [json_name = "enableConfidentialCompute"]; +} + +message InstanceProperties { + // Controls for advanced machine-related behavior features. + // Note that for MachineImage, this is not supported yet. + optional AdvancedMachineFeatures advanced_machine_features = 1 + [json_name = "advancedMachineFeatures"]; + + // 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 tofalse. See theEnable IP + // forwarding + // documentation for more information. + optional bool can_ip_forward = 2 [json_name = "canIpForward"]; + + // Specifies the Confidential Instance options. + // Note that for MachineImage, this is not supported yet. + optional ConfidentialInstanceConfig confidential_instance_config = 3 + [json_name = "confidentialInstanceConfig"]; + + // An optional text description for the instances that are created from these + // properties. + optional string description = 4 [json_name = "description"]; + + // An array of disks that are associated with the instances that are created + // from these properties. + repeated AttachedDisk disks = 5 [json_name = "disks"]; + + // A list of guest accelerator cards' type and count to use for instances + // created from these properties. + repeated AcceleratorConfig guest_accelerators = 6 + [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 = 7 + [json_name = "keyRevocationActionType"]; + + // Labels to apply to instances that are created from these properties. + map labels = 8 [json_name = "labels"]; + + // Specifies which method should be used for encrypting the + // Local SSDs attached to the VM. + // EPHEMERAL_KEY_ENCRYPTION: The given VM will opt-in for using ephemeral key + // for + // encryption of Local SSDs. + // The Local SSDs will not be able to recover data in case of VM + // crash. + // LOCAL_SSD_ENCRYPTION_MODE_UNSPECIFIED: The given VM will be encrypted using + // keys managed by the cloud + // infrastructure and the keys will be deleted when the VM is + // deleted. + // STANDARD_ENCRYPTION: The given VM will be encrypted using keys managed by + // the cloud + // infrastructure and the keys will be deleted when the VM is + // deleted. + optional string local_ssd_encryption_mode = 22 + [json_name = "localSsdEncryptionMode"]; + + // 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`. + optional string machine_type = 9 [json_name = "machineType"]; + + // 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. SeeProject and + // instance metadata for more information. + optional Metadata metadata = 10 [json_name = "metadata"]; + + // 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 asminCpuPlatform: "Intel Haswell" + // orminCpuPlatform: "Intel Sandy Bridge". For more + // information, read Specifying a + // Minimum CPU Platform. + optional string min_cpu_platform = 11 [json_name = "minCpuPlatform"]; + + // An array of network access configurations for this interface. + repeated NetworkInterface network_interfaces = 12 + [json_name = "networkInterfaces"]; + + // Note that for MachineImage, this is not supported yet. + optional NetworkPerformanceConfig network_performance_config = 13 + [json_name = "networkPerformanceConfig"]; + + // 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. + // 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 = 14 + [json_name = "privateIpv6GoogleAccess"]; + + // Specifies the reservations that instances can consume from. + // Note that for MachineImage, this is not supported yet. + optional ReservationAffinity reservation_affinity = 15 + [json_name = "reservationAffinity"]; + + // Input only. Resource manager tags to be bound to the instance. Tag keys and + // values + // have the same definition as resource + // manager tags. Keys and values can be either in numeric format, + // such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in + // namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and + // `{tag_value_short_name}`. The field is ignored (both PUT & + // PATCH) when empty. + map resource_manager_tags = 16 + [json_name = "resourceManagerTags"]; + + // Resource policies (names, not URLs) applied to instances created from + // these properties. + // Note that for MachineImage, this is not supported yet. + repeated string resource_policies = 17 [json_name = "resourcePolicies"]; + + // Specifies the scheduling options for the instances that are created from + // these properties. + optional Scheduling scheduling = 18 [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 + // these properties. Use metadata queries to obtain the access tokens for + // these instances. + repeated ServiceAccount service_accounts = 19 [json_name = "serviceAccounts"]; + + // Note that for MachineImage, this is not supported yet. + optional ShieldedInstanceConfig shielded_instance_config = 20 + [json_name = "shieldedInstanceConfig"]; + + // 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. + optional Tags tags = 21 [json_name = "tags"]; + + optional WorkloadIdentityConfig workload_identity_config = 23 + [json_name = "workloadIdentityConfig"]; +} + +// A network interface resource attached to an instance. +message NetworkInterface { + // An array of configurations for this interface. Currently, only one access + // config, ONE_TO_ONE_NAT, is supported. If there are noaccessConfigs + // specified, then this instance will have + // no external internet access. + repeated AccessConfig access_configs = 1 [json_name = "accessConfigs"]; + + // An array of alias IP ranges for this network interface. + // You can only specify this field for network interfaces in VPC networks. + repeated AliasIpRange alias_ip_ranges = 2 [json_name = "aliasIpRanges"]; + + // An array of alias IPv6 ranges for this network interface. + // You can only specify this field for network interfaces in VPC networks. + repeated AliasIpRange alias_ipv6_ranges = 17 [json_name = "aliasIpv6Ranges"]; + + // Optional. If true, DNS resolution will be enabled over this interface. Only + // valid + // with network_attachment. + optional bool enable_vpc_scoped_dns = 18 [json_name = "enableVpcScopedDns"]; + + // 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 theNetworkInterface. The + // request will fail with error400 Bad Request if the fingerprint is not + // provided, or412 Precondition Failed if the fingerprint is out of date. + optional string fingerprint = 3 [json_name = "fingerprint"]; + + // Indicate whether igmp query is enabled on the network interface + // or not. If enabled, also indicates the version of IGMP supported. + // IGMP_QUERY_DISABLED: The network interface has disabled IGMP query. + // IGMP_QUERY_V2: The network interface has enabled IGMP query - v2. + optional string igmp_query = 19 [json_name = "igmpQuery"]; + + // The prefix length of the primary internal IPv6 range. + optional int32 internal_ipv6_prefix_length = 4 + [json_name = "internalIpv6PrefixLength"]; + + // 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. + repeated AccessConfig ipv6_access_configs = 5 + [json_name = "ipv6AccessConfigs"]; + + // Output only. [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. + // EXTERNAL: This network interface can have external IPv6. + // INTERNAL: This network interface can have internal IPv6. + optional string ipv6_access_type = 6 [json_name = "ipv6AccessType"]; + + // 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. + optional string ipv6_address = 7 [json_name = "ipv6Address"]; + + // Output only. [Output Only] Type of the resource. + // Alwayscompute#networkInterface for network interfaces. + optional string kind = 8 [json_name = "kind"]; + + // [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 and7. The default interface value is + // nic0. + optional string name = 9 [json_name = "name"]; + + // 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 + optional string network = 10 [json_name = "network"]; + + // 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}. + optional string network_attachment = 11 [json_name = "networkAttachment"]; + + // 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. + optional string network_ip = 12 [json_name = "networkIP"]; + + // The type of vNIC to be used on this interface. This may be gVNIC or + // VirtioNet. + // GVNIC: GVNIC + // IDPF: IDPF + // IRDMA: IRDMA + // MRDMA: MRDMA + // UNSPECIFIED_NIC_TYPE: No type specified. + // VIRTIO_NET: VIRTIO + optional string nic_type = 13 [json_name = "nicType"]; + + // Name of the parent network interface of a dynamic network interface. + optional string parent_nic_name = 20 [json_name = "parentNicName"]; + + // 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. + optional int32 queue_count = 14 [json_name = "queueCount"]; + + // Optional. Producer Service's Service class Id for the region of this + // network + // interface. Can only be used with network_attachment. It is not possible to + // use on its own however, network_attachment can be used without + // service_class_id. + optional string service_class_id = 21 [json_name = "serviceClassId"]; + + // The stack type for this network interface. To assign only IPv4 addresses, + // use IPV4_ONLY. To assign both IPv4 and IPv6 addresses, useIPV4_IPV6. If 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 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 + // resource is inlegacy + // 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 + optional string subnetwork = 16 [json_name = "subnetwork"]; + + // VLAN tag of a dynamic network interface, must be an integer in the range + // from 2 to 255 inclusively. + optional int32 vlan = 22 [json_name = "vlan"]; +} + +message NetworkPerformanceConfig { + // DEFAULT: + // TIER_1: + optional string total_egress_bandwidth_tier = 1 + [json_name = "totalEgressBandwidthTier"]; +} + +// Specifies the reservations that this instance can consume from. +message ReservationAffinity { + // 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. + // ANY_RESERVATION: Consume any allocation available. + // NO_RESERVATION: Do not consume from any allocated capacity. + // SPECIFIC_RESERVATION: Must consume from a specific reservation. Must + // specify key value fields + // for specifying the reservations. + // UNSPECIFIED: + optional string consume_reservation_type = 1 + [json_name = "consumeReservationType"]; + + // Corresponds to the label key of a reservation resource. To target + // aSPECIFIC_RESERVATION by name, specifygoogleapis.com/reservation-name as + // the key and specify + // the name of your reservation as its value. + optional string key = 2 [json_name = "key"]; + + // 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. + repeated string values = 3 [json_name = "values"]; +} + +// Sets the scheduling options for an Instance. +message Scheduling { + // 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. + optional bool automatic_restart = 1 [json_name = "automaticRestart"]; + + // 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 = 10 [json_name = "availabilityDomain"]; + + optional SchedulingGracefulShutdown graceful_shutdown = 15 + [json_name = "gracefulShutdown"]; + + // Specify the time in seconds for host error detection, the value must be + // within the range of [90, 330] with the increment of 30, if unset, the + // default behavior of host error recovery will be used. + optional int32 host_error_timeout_seconds = 14 + [json_name = "hostErrorTimeoutSeconds"]; + + // Specifies the termination action for the instance. + // DELETE: Delete the VM. + // INSTANCE_TERMINATION_ACTION_UNSPECIFIED: Default value. This value is + // unused. + // STOP: Stop the VM without storing in-memory content. default action. + optional string instance_termination_action = 2 + [json_name = "instanceTerminationAction"]; + + // 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. + optional Duration local_ssd_recovery_timeout = 9 + [json_name = "localSsdRecoveryTimeout"]; + + // 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. + optional string location_hint = 3 [json_name = "locationHint"]; + + // 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. + optional Duration max_run_duration = 11 [json_name = "maxRunDuration"]; + + // The minimum number of virtual CPUs this instance will consume when running + // on a sole-tenant node. + optional int32 min_node_cpus = 4 [json_name = "minNodeCpus"]; + + // A set of node affinity and anti-affinity configurations. Refer + // toConfiguring node + // affinity for more information. + // Overrides reservationAffinity. + repeated SchedulingNodeAffinity node_affinities = 5 + [json_name = "nodeAffinities"]; + + // Defines the maintenance behavior for this instance. For standard instances, + // the default behavior is MIGRATE. Forpreemptible instances, + // the default and only possible behavior is TERMINATE. For more + // information, see + // Set + // VM host maintenance policy. + // MIGRATE: *[Default]* Allows Compute Engine to automatically migrate + // instances + // out of the way of maintenance events. + // TERMINATE: 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. + optional string on_host_maintenance = 6 [json_name = "onHostMaintenance"]; + + optional SchedulingOnInstanceStopAction on_instance_stop_action = 12 + [json_name = "onInstanceStopAction"]; + + // Defines whether the instance is preemptible. This can only be set during + // instance creation or while the instance isstopped and + // therefore, in a `TERMINATED` state. SeeInstance Life + // Cycle for more information on the possible instance states. + optional bool preemptible = 7 [json_name = "preemptible"]; + + // Specifies the Metadata Service preemption notice duration before the GCE + // ACPI G2 + // Soft Off signal is triggered for Spot VMs only. If not specified, + // there will be no wait before the G2 Soft Off signal is triggered. + optional Duration preemption_notice_duration = 16 + [json_name = "preemptionNoticeDuration"]; + + // Specifies the provisioning model of the instance. + // FLEX_START: Instance is provisioned using the Flex Start provisioning model + // and + // has a limited runtime. + // RESERVATION_BOUND: Bound to the lifecycle of the reservation in which it is + // provisioned. + // SPOT: Heavily discounted, no guaranteed runtime. + // STANDARD: Standard provisioning with user controlled runtime, no discounts. + optional string provisioning_model = 8 [json_name = "provisioningModel"]; + + // Default is false and there will be 120 seconds between GCE ACPI G2 Soft + // Off and ACPI G3 Mechanical + // Off for Standard VMs and 30 seconds for Spot VMs. + optional bool skip_guest_os_shutdown = 17 [json_name = "skipGuestOsShutdown"]; + + // Specifies the timestamp, when the instance will be terminated, inRFC3339 + // text format. If specified, the instance + // termination action will be performed at the termination time. + optional string termination_time = 13 [json_name = "terminationTime"]; +} + +// The configuration for gracefully shutting down the instance. +message SchedulingGracefulShutdown { + // Opts-in for graceful shutdown. + optional bool enabled = 1 [json_name = "enabled"]; + + // The time allotted for the instance to gracefully shut down. If the + // graceful shutdown isn't complete after this time, then the instance + // transitions to the STOPPING state. + optional Duration max_duration = 2 [json_name = "maxDuration"]; +} + +// Node Affinity: the configuration of desired nodes onto which this Instance +// could be scheduled. +message SchedulingNodeAffinity { + // Corresponds to the label key of Node resource. + optional string key = 1 [json_name = "key"]; + + // Defines the operation of node selection. Valid operators areIN for affinity + // and NOT_IN for anti-affinity. + // IN: Requires Compute Engine to seek for matched nodes. + // NOT_IN: Requires Compute Engine to avoid certain nodes. + // OPERATOR_UNSPECIFIED: + optional string operator = 2 [json_name = "operator"]; + + // Corresponds to the label values of Node resource. + repeated string values = 3 [json_name = "values"]; +} + +// Defines the behaviour for instances with the instance_termination_actionSTOP. +message SchedulingOnInstanceStopAction { + // 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. + optional bool discard_local_ssd = 1 [json_name = "discardLocalSsd"]; +} + +// A service account. +message ServiceAccount { + // 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"]; +} + +// A set of Shielded Instance options. +message ShieldedInstanceConfig { + // Defines whether the instance has integrity monitoring enabled.Enabled by + // default. + optional bool enable_integrity_monitoring = 1 + [json_name = "enableIntegrityMonitoring"]; + + // Defines whether the instance has Secure Boot enabled.Disabled by + // default. + optional bool enable_secure_boot = 2 [json_name = "enableSecureBoot"]; + + // Defines whether the instance has the vTPM enabled.Enabled by + // default. + optional bool enable_vtpm = 3 [json_name = "enableVtpm"]; +} + +// A set of instance tags. +message Tags { + // 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. + optional string fingerprint = 1 [json_name = "fingerprint"]; + + // An array of tags. Each tag must be 1-63 characters long, and comply + // with RFC1035. + repeated string items = 2 [json_name = "items"]; +} + +message WorkloadIdentityConfig { + optional string identity = 1 [json_name = "identity"]; - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value 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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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 bool identity_certificate_enabled = 2 + [json_name = "identityCertificateEnabled"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_005.proto b/protos/google/cloud/compute/v1/internal/common_005.proto index 6d152f115fbde..c386b7696f8e8 100644 --- a/protos/google/cloud/compute/v1/internal/common_005.proto +++ b/protos/google/cloud/compute/v1/internal/common_005.proto @@ -15,185 +15,330 @@ // 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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_004.proto"; +// 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. +message Address { + // The static IP address represented by this resource. + optional string address = 1 [json_name = "address"]; -message AddressAggregatedList { - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 1 [json_name = "id"]; + // The type of address to reserve, either INTERNAL orEXTERNAL. If unspecified, + // defaults to EXTERNAL. + // EXTERNAL: A publicly visible external IP address. + // INTERNAL: A private network IP address, for use with an Instance or + // Internal Load + // Balancer forwarding rule. + // UNSPECIFIED_TYPE: + optional string address_type = 2 [json_name = "addressType"]; - // A list of AddressesScopedList resources. - map items = 2 [json_name = "items"]; + // Output only. [Output Only] Creation timestamp inRFC3339 + // text format. + optional string creation_timestamp = 3 [json_name = "creationTimestamp"]; - // [Output Only] Type of resource. Always compute#addressAggregatedList for - // aggregated lists of addresses. - optional string kind = 3 [json_name = "kind"]; + // An optional description of this resource. Provide this field when you + // create the 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. [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"]; + // Reference to the source of IP addresses. + // + // It supports the following cases: + // + // - + // Case 1: PublicDelegatedPrefix (PDP) for BYOIP external + // addresses. If an IPv4 PDP is used, the PDP must support enhanced IPv4 + // allocations. If an IPv6 PDP is used, the PDP must be in + // EXTERNAL_IPV6_FORWARDING_RULE_CREATION mode. + // - + // Case 2: Internal Range for global internal addresses. + // + // + // + // Use one of the following formats to specify the resource: + // + // For a Public Delegated Prefix: + // + // - + // Full resource + // URL:https://www.googleapis.com/compute/v1/projects/projectId/regions/region/publicDelegatedPrefixes/pdp + // - Partial URL: + // - projects/projectId/regions/region/publicDelegatedPrefixes/pdp-name + // - regions/region/publicDelegatedPrefixes/pdp-name + // + // + // + // For an Internal Range: + // + // - Full + // URL:https://networkconnectivity.googleapis.com/v1/projects/project/locations/global/internalRanges/internal-range + // - Partial + // URL:projects/project/locations/global/internalRanges/internal-range + optional string ip_collection = 21 [json_name = "ipCollection"]; - // [Output Only] Unreachable resources. - repeated string unreachables = 6 [json_name = "unreachables"]; + // The IP version that will be used by this address. Valid options areIPV4 or + // IPV6. + // IPV4: + // IPV6: + // UNSPECIFIED_VERSION: + optional string ip_version = 6 [json_name = "ipVersion"]; - 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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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 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. + // NETLB: Reserved IPv6 address can be used on network load balancer. + // VM: Reserved IPv6 address can be used on VM. + optional string ipv6_endpoint_type = 7 [json_name = "ipv6EndpointType"]; - 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. [Output Only] Type of the resource. Always compute#address for + // addresses. + optional string kind = 8 [json_name = "kind"]; - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } + // 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 error412 conditionNotMet. + // + // To see the latest fingerprint, make a get() request to + // retrieve an Address. + optional string label_fingerprint = 19 [json_name = "labelFingerprint"]; - // [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"]; + // Labels for this resource. These can only be added or modified by + // thesetLabels method. Each label key/value pair must comply withRFC1035. + // Label values may be empty. + map labels = 20 [json_name = "labels"]; - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } + // Name of the resource. Provided by the client when the resource is created. + // The name must be 1-63 characters long, and comply withRFC1035. + // 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 = 9 [json_name = "name"]; - // [Output Only] Informational warning message. - optional Warning warning = 7 [json_name = "warning"]; + // The URL of the network in which to reserve the address. This field can + // only be used with INTERNAL type with theVPC_PEERING purpose. + optional string network = 10 [json_name = "network"]; + + // This signifies the networking tier used for configuring this address and + // can only take the following values: PREMIUM orSTANDARD. 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. + // 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 = 11 [json_name = "networkTier"]; + + // The prefix length if the resource represents an IP range. + optional int32 prefix_length = 12 [json_name = "prefixLength"]; + + // 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. + // - `PASSTHROUGH_LOAD_BALANCER_AVAILABILITY_GROUP0` for addresses + // that can only be assigned to global external Passthrough Network Load + // Balancer forwarding rules, as an Availability Group 0 address. + // - `PASSTHROUGH_LOAD_BALANCER_AVAILABILITY_GROUP1` for addresses that + // can only be assigned to global external Passthrough Network Load + // Balancer + // forwarding rules, as an Availability Group 1 address. + // DNS_RESOLVER: DNS resolver address in the subnetwork. + // GCE_ENDPOINT: VM internal/alias IP, Internal LB service IP, etc. + // IPSEC_INTERCONNECT: 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. + // NAT_AUTO: External IP automatically reserved for Cloud NAT. + // PRIVATE_SERVICE_CONNECT: A private network IP address that can be used to + // configure Private + // Service Connect. This purpose can be specified only forGLOBAL addresses of + // Type INTERNAL + // SERVERLESS: A regional internal IP address range reserved for Serverless. + // SHARED_LOADBALANCER_VIP: A private network IP address that can be shared by + // multiple Internal + // Load Balancer forwarding rules. + // VPC_PEERING: IP range for peer networks. + optional string purpose = 13 [json_name = "purpose"]; + + // Output only. [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.* + optional string region = 14 [json_name = "region"]; + + // [Output Only] Server-defined URL for the resource. + optional string self_link = 15 [json_name = "selfLink"]; + + // Output only. [Output Only] The status of the address, which can be one + // ofRESERVING, 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. + // IN_USE: Address is being used by another resource and is not available. + // RESERVED: Address is reserved and available to use. + // RESERVING: Address is being reserved. + optional string status = 16 [json_name = "status"]; + + // 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 aGCE_ENDPOINT or DNS_RESOLVER purpose. + optional string subnetwork = 17 [json_name = "subnetwork"]; + + // [Output Only] The URLs of the resources that are using this address. + repeated string users = 18 [json_name = "users"]; } -message AddressesScopedList { - // [Output Only] A list of addresses contained in this scope. - repeated Address addresses = 1 [json_name = "addresses"]; +// Contains a list of addresses. +message AddressList { + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 1 [json_name = "id"]; + + // A list of Address resources. + repeated Address items = 2 [json_name = "items"]; + + // Output only. [Output Only] Type of resource. Always compute#addressList for + // lists of addresses. + 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 thanmaxResults, use the + // nextPageToken as a value 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. [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. + // [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. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -202,40 +347,33 @@ message AddressesScopedList { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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"]; -} - -message RegionAddressesMoveRequest { - // An optional destination address description if intended to be different - // from the source. - optional string description = 1 [json_name = "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. - optional string destination_address = 2 [json_name = "destinationAddress"]; + // [Output Only] Informational warning message. + optional Warning warning = 6 [json_name = "warning"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_006.proto b/protos/google/cloud/compute/v1/internal/common_006.proto index 69512b634bdd1..5f39c1ff85617 100644 --- a/protos/google/cloud/compute/v1/internal/common_006.proto +++ b/protos/google/cloud/compute/v1/internal/common_006.proto @@ -15,270 +15,273 @@ // 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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -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_048.proto"; -import "google/cloud/compute/v1/internal/common_120.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, -// one can create instances of varying shapes against this reservation. -message AllocationAggregateReservation { - // [Output only] List of resources currently in use. - repeated AllocationAggregateReservationReservedResourceInfo in_use_resources = - 1 [json_name = "inUseResources"]; - - // List of reserved resources (CPUs, memory, accelerators). - repeated AllocationAggregateReservationReservedResourceInfo - reserved_resources = 2 [json_name = "reservedResources"]; - - // The VM family that all instances scheduled against this reservation must - // belong to. - // 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_LITE_POD_SLICE_CT6E: - // VM_FAMILY_CLOUD_TPU_POD_SLICE_CT3P: - // VM_FAMILY_CLOUD_TPU_POD_SLICE_CT4P: - // VM_FAMILY_CLOUD_TPU_POD_SLICE_CT5P: - optional string vm_family = 3 [json_name = "vmFamily"]; - - // The workload type of the instances that will target this reservation. - // BATCH: Reserved resources will be optimized for BATCH workloads, such as ML - // training. - // SERVING: Reserved resources will be optimized for SERVING workloads, such - // as ML inference. - // UNSPECIFIED: - optional string workload_type = 4 [json_name = "workloadType"]; -} - -message AllocationAggregateReservationReservedResourceInfo { - // Properties of accelerator resources in this reservation. - optional AllocationAggregateReservationReservedResourceInfoAccelerator - accelerator = 1 [json_name = "accelerator"]; -} - -message AllocationAggregateReservationReservedResourceInfoAccelerator { - // Number of accelerators of specified type. - optional int32 accelerator_count = 1 [json_name = "acceleratorCount"]; - - // Full or partial URL to accelerator type. e.g. - // "projects/{PROJECT}/zones/{ZONE}/acceleratorTypes/ct4l" - optional string accelerator_type = 2 [json_name = "acceleratorType"]; -} - -message AllocationReservationSharingPolicy { - // Sharing config for all Google Cloud services. - // ALLOW_ALL: Allow all Google Cloud managed services to share reservations. - // DISALLOW_ALL: [Default] Disallow sharing with all Google Cloud services. - // SERVICE_SHARE_TYPE_UNSPECIFIED: - optional string service_share_type = 1 [json_name = "serviceShareType"]; -} - -// [Output Only] Contains output only fields. -message AllocationResourceStatus { - // The number of reservation blocks associated with this reservation. - optional int32 reservation_block_count = 2 - [json_name = "reservationBlockCount"]; - - // Maintenance information for this reservation - optional GroupMaintenanceInfo reservation_maintenance = 3 - [json_name = "reservationMaintenance"]; - - // Allocation Properties of this reservation. - optional AllocationResourceStatusSpecificSKUAllocation - specific_sku_allocation = 1 [json_name = "specificSkuAllocation"]; -} - -// Contains Properties set for the reservation. -message AllocationResourceStatusSpecificSKUAllocation { - // ID of the instance template used to populate reservation properties. - optional string source_instance_template_id = 1 - [json_name = "sourceInstanceTemplateId"]; - - // Per service utilization breakdown. The Key is the Google Cloud managed - // service name. - map utilizations = 2 [json_name = "utilizations"]; -} - -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"]; +import "google/cloud/compute/v1/internal/common_005.proto"; + +message AddressAggregatedList { + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 1 [json_name = "id"]; + + // A list of AddressesScopedList resources. + map items = 2 [json_name = "items"]; + + // Output only. [Output Only] Type of resource. + // Alwayscompute#addressAggregatedList for aggregated lists of + // addresses. + 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 thanmaxResults, use the + // nextPageToken as a value 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. [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + // Output only. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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"]; } -// This reservation type allows to pre allocate specific instance configuration. -message AllocationSpecificSKUReservation { - // [Output Only] Indicates how many instances are actually usable currently. - optional string assured_count = 1 [json_name = "assuredCount"]; - - // Specifies the number of resources that are allocated. - optional string count = 2 [json_name = "count"]; - - // [Output Only] Indicates how many instances are in use. - optional string in_use_count = 3 [json_name = "inUseCount"]; - - // The instance properties for the reservation. - optional AllocationSpecificSKUAllocationReservedInstanceProperties - instance_properties = 4 [json_name = "instanceProperties"]; - - // 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 - optional string source_instance_template = 5 - [json_name = "sourceInstanceTemplate"]; +message AddressesScopedList { + // [Output Only] A list of addresses contained in this scope. + repeated Address addresses = 1 [json_name = "addresses"]; + + 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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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"]; } -// 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. -message Reservation { - // Reservation for aggregated resources, providing shape flexibility. - optional AllocationAggregateReservation aggregate_reservation = 16 - [json_name = "aggregateReservation"]; - - // [Output Only] Full or partial URL to a parent commitment. This field - // displays for reservations that are tied to a commitment. - optional string commitment = 1 [json_name = "commitment"]; - - // [Output Only] Creation timestamp in RFC3339 text format. - optional string creation_timestamp = 2 [json_name = "creationTimestamp"]; - - // Duration time relative to reservation creation when Compute Engine will - // automatically delete this resource. - optional Duration delete_after_duration = 20 - [json_name = "deleteAfterDuration"]; - - // Absolute time in future when the reservation will be auto-deleted by - // Compute Engine. Timestamp is represented in RFC3339 text format. - optional string delete_at_time = 21 [json_name = "deleteAtTime"]; - - // Specifies the deployment strategy for this reservation. - // DENSE: The reserved capacity is made up of densely deployed reservation - // blocks. - // DEPLOYMENT_TYPE_UNSPECIFIED: - optional string deployment_type = 18 [json_name = "deploymentType"]; - - // An optional description of this resource. Provide this property when you - // create the resource. - optional string description = 3 [json_name = "description"]; - - // Indicates whether Compute Engine allows unplanned maintenance for your VMs; - // for example, to fix hardware errors. - optional bool enable_emergent_maintenance = 22 - [json_name = "enableEmergentMaintenance"]; - - // [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#reservations for - // reservations. - optional string kind = 5 [json_name = "kind"]; - - // [Output Only] Full or partial URL to parent commitments. This field - // displays for reservations that are tied to multiple commitments. - repeated string linked_commitments = 19 [json_name = "linkedCommitments"]; - - // 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 = 6 [json_name = "name"]; - - // Specify the reservation sharing policy. If unspecified, the reservation - // will not be shared with Google Cloud managed services. - optional AllocationReservationSharingPolicy reservation_sharing_policy = 17 - [json_name = "reservationSharingPolicy"]; - - // 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. - map resource_policies = 7 [json_name = "resourcePolicies"]; - - // [Output Only] Status information for Reservation resource. - optional AllocationResourceStatus resource_status = 8 - [json_name = "resourceStatus"]; - - // [Output Only] Reserved for future use. - optional bool satisfies_pzs = 9 [json_name = "satisfiesPzs"]; - - // [Output Only] Server-defined fully-qualified URL for this resource. - optional string self_link = 10 [json_name = "selfLink"]; - - // 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. - optional ShareSettings share_settings = 11 [json_name = "shareSettings"]; - - // Reservation for instances with specific machine shapes. - optional AllocationSpecificSKUReservation specific_reservation = 12 - [json_name = "specificReservation"]; - - // 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. - optional bool specific_reservation_required = 13 - [json_name = "specificReservationRequired"]; - - // [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 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 - // reservation is created within a commitment. - optional string zone = 15 [json_name = "zone"]; +message RegionAddressesMoveRequest { + // An optional destination address description if intended to be different + // from the source. + optional string description = 1 [json_name = "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. + optional string destination_address = 2 [json_name = "destinationAddress"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_007.proto b/protos/google/cloud/compute/v1/internal/common_007.proto index 358491d84dc9a..cbbf650a4b650 100644 --- a/protos/google/cloud/compute/v1/internal/common_007.proto +++ b/protos/google/cloud/compute/v1/internal/common_007.proto @@ -15,209 +15,99 @@ // 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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_031.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 { - reserved 2; - // The configuration for logging of each type of permission. - repeated AuditLogConfig audit_log_configs = 1 [json_name = "auditLogConfigs"]; - - // 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_001.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, +// one can create instances of varying shapes against this reservation. +message AllocationAggregateReservation { + // Output only. [Output only] List of resources currently in use. + repeated AllocationAggregateReservationReservedResourceInfo in_use_resources = + 1 [json_name = "inUseResources"]; + + // List of reserved resources (CPUs, memory, accelerators). + repeated AllocationAggregateReservationReservedResourceInfo + reserved_resources = 2 [json_name = "reservedResources"]; + + // The VM family that all instances scheduled against this reservation must + // belong to. + // 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_LITE_POD_SLICE_CT6E: + // VM_FAMILY_CLOUD_TPU_POD_SLICE_CT3P: + // VM_FAMILY_CLOUD_TPU_POD_SLICE_CT4P: + // VM_FAMILY_CLOUD_TPU_POD_SLICE_CT5P: + // VM_FAMILY_CLOUD_TPU_POD_SLICE_TPU7X: + optional string vm_family = 3 [json_name = "vmFamily"]; + + // The workload type of the instances that will target this reservation. + // BATCH: Reserved resources will be optimized for BATCH workloads, such as ML + // training. + // SERVING: Reserved resources will be optimized for SERVING workloads, such + // as ML + // inference. + // UNSPECIFIED: + optional string workload_type = 4 [json_name = "workloadType"]; +} + +message AllocationAggregateReservationReservedResourceInfo { + // Properties of accelerator resources in this reservation. + optional AllocationAggregateReservationReservedResourceInfoAccelerator + accelerator = 1 [json_name = "accelerator"]; } -// 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"]; +message AllocationAggregateReservationReservedResourceInfoAccelerator { + // Number of accelerators of specified type. + optional int32 accelerator_count = 1 [json_name = "acceleratorCount"]; + + // Full or partial URL to accelerator type. e.g. + // "projects/{PROJECT}/zones/{ZONE}/acceleratorTypes/ct4l" + optional string accelerator_type = 2 [json_name = "acceleratorType"]; } -// 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"]; +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 isSCSI. + // For performance characteristics of SCSI over NVMe, seeLocal SSD + // performance. + // NVME: + // SCSI: + optional string interface = 2 [json_name = "interface"]; } -// 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"]; +// Properties of the SKU instances being reserved. +// Next ID: 10 +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"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_008.proto b/protos/google/cloud/compute/v1/internal/common_008.proto index c93816df2c908..53a8a8ce3b14e 100644 --- a/protos/google/cloud/compute/v1/internal/common_008.proto +++ b/protos/google/cloud/compute/v1/internal/common_008.proto @@ -15,419 +15,315 @@ // 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: 20250601 +// revision: 20260807 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"]; +import "google/cloud/compute/v1/internal/common_007.proto"; +import "google/cloud/compute/v1/internal/common_038.proto"; +import "google/cloud/compute/v1/internal/common_059.proto"; +import "google/cloud/compute/v1/internal/common_134.proto"; +import "google/cloud/compute/v1/internal/common_144.proto"; + +message AllocationReservationSharingPolicy { + // Sharing config for all Google Cloud services. + // ALLOW_ALL: Allow all Google Cloud managed services to share reservations. + // DISALLOW_ALL: [Default] Disallow sharing with all Google Cloud services. + // SERVICE_SHARE_TYPE_UNSPECIFIED: + optional string service_share_type = 1 [json_name = "serviceShareType"]; +} - // An optional description of this resource. Provide this property when you - // create the resource. - optional string description = 3 [json_name = "description"]; +// [Output Only] Contains output only fields. +message AllocationResourceStatus { + // [Output only] Health information for the reservation. + optional AllocationResourceStatusHealthInfo health_info = 4 + [json_name = "healthInfo"]; - // [Output Only] The unique identifier for the resource. This identifier is - // defined by the server. - optional string id = 4 [json_name = "id"]; + // The number of reservation blocks associated with this reservation. + optional int32 reservation_block_count = 2 + [json_name = "reservationBlockCount"]; - // [Output Only] Type of the resource. Always compute#autoscaler for - // autoscalers. - optional string kind = 5 [json_name = "kind"]; + // Maintenance information for this reservation + optional GroupMaintenanceInfo reservation_maintenance = 3 + [json_name = "reservationMaintenance"]; - // 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"]; + // Allocation Properties of this reservation. + optional AllocationResourceStatusSpecificSKUAllocation + specific_sku_allocation = 1 [json_name = "specificSkuAllocation"]; +} - // [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"]; +// Health information for the reservation. +message AllocationResourceStatusHealthInfo { + // The number of reservation blocks that are degraded. + optional int32 degraded_block_count = 1 [json_name = "degradedBlockCount"]; - // [Output Only] URL of the region where the instance group resides (for - // autoscalers living in regional scope). - optional string region = 8 [json_name = "region"]; + // The health status of the reservation. + // DEGRADED: The reservation is degraded. + // HEALTHY: The reservation is healthy. + // HEALTH_STATUS_UNSPECIFIED: The health status of the reservation is + // unspecified. + optional string health_status = 2 [json_name = "healthStatus"]; - // [Output Only] Status information of existing scaling schedules. - map scaling_schedule_status = 9 - [json_name = "scalingScheduleStatus"]; + // The number of reservation blocks that are healthy. + optional int32 healthy_block_count = 3 [json_name = "healthyBlockCount"]; +} - // [Output Only] Server-defined URL for the resource. - optional string self_link = 10 [json_name = "selfLink"]; +// Contains Properties set for the reservation. +message AllocationResourceStatusSpecificSKUAllocation { + // ID of the instance template used to populate reservation properties. + optional string source_instance_template_id = 1 + [json_name = "sourceInstanceTemplateId"]; - // [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"]; + // Per service utilization breakdown. The Key is the Google Cloud managed + // service name. + map utilizations = 2 [json_name = "utilizations"]; } -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 reservation type allows to pre allocate specific instance +// configuration. +message AllocationSpecificSKUReservation { + // Output only. [Output Only] Indicates how many instances are actually usable + // currently. + optional string assured_count = 1 [json_name = "assuredCount"]; + + // Specifies the number of resources that are allocated. + optional string count = 2 [json_name = "count"]; + + // Output only. [Output Only] Indicates how many instances are in use. + optional string in_use_count = 3 [json_name = "inUseCount"]; + + // The instance properties for the reservation. + optional AllocationSpecificSKUAllocationReservedInstanceProperties + instance_properties = 4 [json_name = "instanceProperties"]; + + // 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 + optional string source_instance_template = 5 + [json_name = "sourceInstanceTemplate"]; } -// 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"]; -} +// 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. +message Reservation { + // Advanced control for cluster management, applicable only to DENSE + // deployment type reservations. + optional ReservationAdvancedDeploymentControl advanced_deployment_control = 23 + [json_name = "advancedDeploymentControl"]; + + // Reservation for aggregated resources, providing shape flexibility. + optional AllocationAggregateReservation aggregate_reservation = 16 + [json_name = "aggregateReservation"]; + + // Output only. [Output Only] Full or partial URL to a parent commitment. This + // field + // displays for reservations that are tied to a commitment. + optional string commitment = 1 [json_name = "commitment"]; + + // CONFIDENTIAL_COMPUTE_TYPE_TDX: Intel Trust Domain Extensions. + // CONFIDENTIAL_COMPUTE_TYPE_UNSPECIFIED: + optional string confidential_compute_type = 24 + [json_name = "confidentialComputeType"]; + + // Output only. [Output Only] Creation timestamp inRFC3339 + // text format. + optional string creation_timestamp = 2 [json_name = "creationTimestamp"]; -// 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"]; -} + // Duration time relative to reservation creation when Compute Engine will + // automatically delete this resource. + optional Duration delete_after_duration = 20 + [json_name = "deleteAfterDuration"]; -// 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"]; -} + // Absolute time in future when the reservation will be + // auto-deleted by Compute Engine. Timestamp is represented inRFC3339 text + // format. + optional string delete_at_time = 21 [json_name = "deleteAtTime"]; -// 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"]; -} + // Specifies the deployment strategy for this reservation. + // DENSE: The reserved capacity is made up of densely deployed reservation + // blocks. + // DEPLOYMENT_TYPE_UNSPECIFIED: + optional string deployment_type = 18 [json_name = "deploymentType"]; + + // An optional description of this resource. Provide this property when you + // create the resource. + optional string description = 3 [json_name = "description"]; + + // Indicates the early access maintenance for the reservation. + // If this field is absent or set to NO_EARLY_ACCESS, the reservation is not + // enrolled in early access maintenance and the standard notice applies. + // NO_EARLY_ACCESS: No early access. + // WAVE1: Wave 1: Fastest notification period + // WAVE2: Wave 2: Medium notification period + optional string early_access_maintenance = 25 + [json_name = "earlyAccessMaintenance"]; + + // Indicates whether Compute Engine allows unplanned maintenance for your VMs; + // for example, to fix hardware errors. + optional bool enable_emergent_maintenance = 22 + [json_name = "enableEmergentMaintenance"]; + + // Output only. [Output Only] The unique identifier for the resource. This + // identifier is + // defined by the server. + optional string id = 4 [json_name = "id"]; + + // Output only. [Output Only] Type of the resource. Alwayscompute#reservations + // for reservations. + optional string kind = 5 [json_name = "kind"]; + + // Output only. [Output Only] Full or partial URL to parent commitments. This + // field + // displays for reservations that are tied to multiple commitments. + repeated string linked_commitments = 19 [json_name = "linkedCommitments"]; + + // 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 + // withRFC1035. + // 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"]; + + // Input only. Additional params passed with the request, but not persisted + // as part of resource payload. + optional ReservationParams params = 26 [json_name = "params"]; + + // Protection tier for the workload which specifies the workload expectations + // in the event of infrastructure failures at data center (e.g. power + // and/or cooling failures). + // CAPACITY_OPTIMIZED: CAPACITY_OPTIMIZED capacity leverages redundancies + // (e.g. power, cooling) + // at the data center during normal operating conditions. In the event of + // infrastructure failures at data center (e.g. power and/or cooling + // failures), this workload may be disrupted. As a consequence, it has a + // weaker availability SLO than STANDARD. + // PROTECTION_TIER_UNSPECIFIED: Unspecified protection tier. + // STANDARD: STANDARD protection for workload that should be protected by + // redundancies + // (e.g. power, cooling) at the data center level. In the event of + // infrastructure failures at data center (e.g. power and/or cooling + // failures), this workload is expected to continue as normal using the + // redundancies. + optional string protection_tier = 27 [json_name = "protectionTier"]; + + // Specify the reservation sharing policy. If unspecified, the reservation + // will not be shared with Google Cloud managed services. + optional AllocationReservationSharingPolicy reservation_sharing_policy = 17 + [json_name = "reservationSharingPolicy"]; + + // Output only. [Output Only] Contains standard resource metadata for an + // Allocation + // resource. It is populated for each instance of the Allocation + // resource, and includes the api_version the + // instance was retrieved through, and its canonical + // resource_type name. + optional ResourceMetadata resource_metadata = 28 + [json_name = "resourceMetadata"]; + + // 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. + map resource_policies = 7 [json_name = "resourcePolicies"]; + + // Output only. [Output Only] Status information for Reservation resource. + optional AllocationResourceStatus resource_status = 8 + [json_name = "resourceStatus"]; + + // Output only. [Output Only] Reserved for future use. + optional bool satisfies_pzs = 9 [json_name = "satisfiesPzs"]; + + // The type of maintenance for the reservation. + // GROUPED: Maintenance on all reserved instances in the reservation is + // synchronized. + // GROUP_MAINTENANCE_TYPE_UNSPECIFIED: Unknown maintenance type. + // INDEPENDENT: Maintenance is not synchronized for this reservation. Instead, + // each + // instance has its own maintenance window. + optional string scheduling_type = 29 [json_name = "schedulingType"]; + + // Output only. [Output Only] Server-defined fully-qualified URL for this + // resource. + optional string self_link = 10 [json_name = "selfLink"]; -// 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"]; + // 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. + optional ShareSettings share_settings = 11 [json_name = "shareSettings"]; + + // Reservation for instances with specific machine shapes. + optional AllocationSpecificSKUReservation specific_reservation = 12 + [json_name = "specificReservation"]; + + // 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. + optional bool specific_reservation_required = 13 + [json_name = "specificReservationRequired"]; + + // Output only. [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 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 + // reservation is created within a commitment. + optional string zone = 15 [json_name = "zone"]; } -// 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"]; +// Advance control for cluster management, applicable only to DENSE deployment +// type reservations. +message ReservationAdvancedDeploymentControl { + // Indicates chosen reservation operational mode for the reservation. + // ALL_CAPACITY: Google Cloud does not manage the failure of machines, but + // provides + // additional capacity, which is not guaranteed to be available. + // HIGHLY_AVAILABLE_CAPACITY: Google Cloud manages the failure of machines to + // provide high + // availability. + // RESERVATION_OPERATIONAL_MODE_UNSPECIFIED: + optional string reservation_operational_mode = 1 + [json_name = "reservationOperationalMode"]; } -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"]; +// Additional reservation params. +message ReservationParams { + // Input only. Resource manager tags to be bound to the reservation. Tag keys + // and + // values have the same definition as resource + // manager tags. Keys and values can be either in numeric format, + // such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in + // namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and + // `{tag_value_short_name}`. The field is ignored (both PUT & + // PATCH) when empty. + map resource_manager_tags = 1 + [json_name = "resourceManagerTags"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_009.proto b/protos/google/cloud/compute/v1/internal/common_009.proto index fa1971fc9d481..6ad6f500707f2 100644 --- a/protos/google/cloud/compute/v1/internal/common_009.proto +++ b/protos/google/cloud/compute/v1/internal/common_009.proto @@ -15,323 +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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_008.proto"; +import "google/cloud/compute/v1/internal/common_040.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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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"]; +// 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 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"]; } -// 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"]; - - // A list of Autoscaler resources. - repeated Autoscaler items = 2 [json_name = "items"]; - - // [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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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"]; +// 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"]; } -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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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"]; - } +// 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"]; +} - // [Output Only] Informational warning which replaces the list of autoscalers - // when the list is empty. - optional Warning warning = 2 [json_name = "warning"]; +// 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_010.proto b/protos/google/cloud/compute/v1/internal/common_010.proto index 1a94809d9a0b9..56c49e4ec0c33 100644 --- a/protos/google/cloud/compute/v1/internal/common_010.proto +++ b/protos/google/cloud/compute/v1/internal/common_010.proto @@ -15,353 +15,549 @@ // 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: 20250601 +// revision: 20260807 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"]; - - // [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"]; - - // The value can only be INTERNAL_MANAGED for cross-region internal layer 7 - // load balancer. If loadBalancingScheme is not specified, the backend bucket - // can be used by classic global external load balancers, or global - // application external load balancers, or both. - // INTERNAL_MANAGED: Signifies that this will be used for internal Application - // Load Balancers. - optional string load_balancing_scheme = 14 - [json_name = "loadBalancingScheme"]; +import "google/cloud/compute/v1/internal/common_049.proto"; + +// Represents an Autoscaler resource. +// +// Google Compute Engine has two Autoscaler resources: +// +// * +// [Zonal](https://cloud.google.com/compute/docs/reference/rest/v1/autoscalers) +// * +// [Regional](https://cloud.google.com/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 theregionAutoscalers resource. +message Autoscaler { + // The configuration parameters for the autoscaling algorithm. You can define + // one or more signals for an autoscaler: + // cpuUtilization,customMetricUtilizations, andloadBalancingUtilization. + // + // If none of these are specified, the default will be to autoscale based + // oncpuUtilization to 0.6 or 60%. + optional AutoscalingPolicy autoscaling_policy = 1 + [json_name = "autoscalingPolicy"]; + + // Output only. [Output Only] Creation timestamp inRFC3339 + // 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. [Output Only] The unique identifier for the resource. This + // identifier is + // defined by the server. + optional string id = 4 [json_name = "id"]; + + // Output only. [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. + // The name must be 1-63 characters long, and comply withRFC1035. // 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"]; + // 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. [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. [Output Only] URL of theregion + // where the instance group resides (for autoscalers living in regional + // scope). + optional string region = 8 [json_name = "region"]; + + // Output only. [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 = 12 [json_name = "selfLink"]; + 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 forCommonly + // 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. [Output Only] URL of thezone + // 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"]; +} - // [Output Only] List of resources referencing that backend bucket. - repeated BackendBucketUsedBy used_by = 13 [json_name = "usedBy"]; +// 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](https://cloud.google.com/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. + // It's recommended to use ONLY_SCALE_OUT instead of ONLY_UP. + 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"]; + + // The number of seconds that autoscaler waits for load stabilization before + // making scale-in decisions. This is referred to as the + // [stabilization + // period](https://cloud.google.com/compute/docs/autoscaler#stabilization_period). + // This might appear as a delay in scaling in but it is an important mechanism + // for your application to not have fluctuating size due to short term load + // fluctuations. + // + // The default stabilization period is 600 seconds. + optional int32 stabilization_period_sec = 10 + [json_name = "stabilizationPeriodSec"]; } -// 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. If no value is provided for cdnPolicy.cacheMode, it defaults to - // CACHE_ALL_STATIC. - // 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-maxage). - // 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-maxage) 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"]; +// 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 is0.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"]; } -// 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"]; +// Custom utilization metric policy. +message AutoscalingPolicyCustomMetricUtilization { + // A filter string, compatible with a Stackdriver Monitoringfilter string + // forTimeSeries.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 orDOUBLE. + 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 + // examplepubsub.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 + // ishttps://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"]; } -// 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"]; +// 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"]; } -// 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"]; +// 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"]; } -// 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 BackendBucket resources. - repeated BackendBucket 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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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"]; +// 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"]; } -message BackendBucketUsedBy { - // [Output Only] Server-defined URL for UrlMaps referencing that - // BackendBucket. - optional string reference = 1 [json_name = "reference"]; +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_011.proto b/protos/google/cloud/compute/v1/internal/common_011.proto index e75fa32fdb516..1f8a4caee454c 100644 --- a/protos/google/cloud/compute/v1/internal/common_011.proto +++ b/protos/google/cloud/compute/v1/internal/common_011.proto @@ -15,94 +15,109 @@ // 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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_000.proto"; +import "google/cloud/compute/v1/internal/common_010.proto"; -// Contains a list of BackendServicesScopedList. -message BackendServiceAggregatedList { +message AutoscalerAggregatedList { // [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 AutoscalersScopedList resources. + map items = 2 [json_name = "items"]; - // Type of resource. + // Output only. [Output Only] Type of resource. + // Alwayscompute#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 + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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. + // Output only. [Output Only] Server-defined URL for this resource. optional string self_link = 5 [json_name = "selfLink"]; - // [Output Only] Unreachable resources. + // Output only. [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. + // [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. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -111,19 +126,27 @@ message BackendServiceAggregatedList { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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. @@ -134,66 +157,208 @@ message BackendServiceAggregatedList { optional Warning warning = 7 [json_name = "warning"]; } -message BackendServicesScopedList { - // A list of BackendServices contained in this scope. - repeated BackendService backend_services = 1 [json_name = "backendServices"]; +// 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"]; + + // A list of Autoscaler resources. + repeated Autoscaler items = 2 [json_name = "items"]; + + // Output only. [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 thanmaxResults, use the + // nextPageToken as a value 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. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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 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. + // [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. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -202,26 +367,34 @@ message BackendServicesScopedList { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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. + // [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_012.proto b/protos/google/cloud/compute/v1/internal/common_012.proto index 66a0905e0837c..6644bff0e76c1 100644 --- a/protos/google/cloud/compute/v1/internal/common_012.proto +++ b/protos/google/cloud/compute/v1/internal/common_012.proto @@ -15,369 +15,377 @@ // 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: 20250601 +// revision: 20260807 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"]; - - // 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 { - // Optional metadata defined as annotations on the network endpoint. - map annotations = 1 [json_name = "annotations"]; - - // Represents the port number to which PSC consumer sends packets. Optional. - // 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. Optional, the - // field presence depends on the network endpoint type. The 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 Cloud Storage Bucket resource. +// +// This Cloud Storage bucket resource is referenced by a URL map of a load +// balancer. For more information, readBackend 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 inRFC3339 + // 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"]; -// 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 { - // Optional. Metadata defined as annotations on the network endpoint group. - map annotations = 1 [json_name = "annotations"]; - - // Optional. Only valid when networkEndpointType is SERVERLESS. Only one of - // cloudRun, appEngine or cloudFunction may be set. - optional NetworkEndpointGroupAppEngine app_engine = 2 - [json_name = "appEngine"]; - - // Optional. Only valid when networkEndpointType is SERVERLESS. Only one of - // cloudRun, appEngine or cloudFunction may be set. - optional NetworkEndpointGroupCloudFunction cloud_function = 3 - [json_name = "cloudFunction"]; - - // Optional. 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. Optional. 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. + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 9 [json_name = "id"]; + + // Output only. Type of the resource. + optional string kind = 10 [json_name = "kind"]; + + // The value can only be INTERNAL_MANAGED for cross-region internal layer 7 + // load balancer. + // + // If loadBalancingScheme is not specified, the backend bucket can be used by + // classic global external load balancers, or global application external load + // balancers, or both. + // EXTERNAL_MANAGED: Signifies that this will be used for regional external + // Application Load + // Balancers. + // INTERNAL_MANAGED: Signifies that this will be used for internal Application + // Load Balancers. + optional string load_balancing_scheme = 14 + [json_name = "loadBalancingScheme"]; + + // Name of the resource. Provided by the client when the resource is created. + // The name must be 1-63 characters long, and comply withRFC1035. // 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. Only valid when networkEndpointType is PRIVATE_SERVICE_CONNECT. - 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. Only valid when - // networkEndpointType is PRIVATE_SERVICE_CONNECT. - 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"]; + // 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"]; + + // Input only. [Input Only] Additional params passed with the request, but not + // persisted + // as part of resource payload. + optional BackendBucketParams params = 15 [json_name = "params"]; + + // Output only. [Output Only] URL of the region where the regional backend + // bucket + // resides. This field is not applicable to global backend buckets. + // 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 = 16 [json_name = "selfLink"]; - - // [Output only] Number of network endpoints in the network endpoint group. - optional int32 size = 17 [json_name = "size"]; + optional string self_link = 12 [json_name = "selfLink"]; - // Optional URL of the subnetwork to which all network endpoints in the NEG - // belong. - optional string subnetwork = 18 [json_name = "subnetwork"]; + // Output only. [Output Only] List of resources referencing that backend + // bucket. + repeated BackendBucketUsedBy used_by = 13 [json_name = "usedBy"]; +} - // [Output Only] The URL of the zone where the network endpoint group is - // located. - optional string zone = 19 [json_name = "zone"]; +// 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. + // + // If no value is provided for cdnPolicy.cacheMode, it defaults + // to CACHE_ALL_STATIC. + // 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-maxage). + // 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), 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-maxage) 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"]; } -// 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"]; +// 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"]; } -// 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"]; +// 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"]; } -// 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"]; +// 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 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"]; } -message NetworkEndpointGroupList { +// 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 NetworkEndpointGroup resources. - repeated NetworkEndpointGroup items = 2 [json_name = "items"]; + // A list of BackendBucket resources. + repeated BackendBucket items = 2 [json_name = "items"]; - // [Output Only] The resource type, which is always - // compute#networkEndpointGroupList for network endpoint group lists. + // Output only. 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 + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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. + // Output only. [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. + // [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. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -386,19 +394,27 @@ message NetworkEndpointGroupList { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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. @@ -409,111 +425,97 @@ message NetworkEndpointGroupList { optional Warning warning = 6 [json_name = "warning"]; } -// 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 { +message BackendBucketListUsable { // [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 BackendBucket resources. + repeated BackendBucket 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. [Output Only] Type of resource. + // Alwayscompute#usableBackendBucketList for lists of usable backend + // buckets. 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 + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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. [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. + // [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. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -522,19 +524,27 @@ message NetworkEndpointGroupsListNetworkEndpoints { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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. @@ -542,14 +552,29 @@ message NetworkEndpointGroupsListNetworkEndpoints { } // [Output Only] Informational warning message. - optional Warning warning = 5 [json_name = "warning"]; + optional Warning warning = 6 [json_name = "warning"]; } -message NetworkEndpointWithHealthStatus { - // [Output only] The health status of network endpoint. Optional. Displayed - // only if the network endpoint has centralized health checking configured. - repeated HealthStatusForNetworkEndpoint healths = 1 [json_name = "healths"]; +// Additional Backend Bucket parameters. +message BackendBucketParams { + // Tag keys/values directly bound to this resource. + // Tag keys and values have the same definition as resource + // manager tags. The field is allowed for INSERT + // only. The keys/values to set on the resource should be specified in + // either ID { : } or Namespaced format + // { : }. + // For example the following are valid inputs: + // * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} + // * {"123/environment" : "production", "345/abc" : "xyz"} + // Note: + // * Invalid combinations of ID & namespaced format is not supported. For + // instance: {"123/environment" : "tagValues/444"} is invalid. + map resource_manager_tags = 1 + [json_name = "resourceManagerTags"]; +} - // [Output only] The network endpoint. - optional NetworkEndpoint network_endpoint = 2 [json_name = "networkEndpoint"]; +message BackendBucketUsedBy { + // Output only. [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_013.proto b/protos/google/cloud/compute/v1/internal/common_013.proto index 6c3e34678af0c..56447c885525a 100644 --- a/protos/google/cloud/compute/v1/internal/common_013.proto +++ b/protos/google/cloud/compute/v1/internal/common_013.proto @@ -15,479 +15,103 @@ // 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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_031.proto"; -import "google/cloud/compute/v1/internal/common_115.proto"; +import "google/cloud/compute/v1/internal/common_012.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"]; -} - -message BgpRoute { - // [Output only] AS-PATH for the route - repeated BgpRouteAsPath as_paths = 1 [json_name = "asPaths"]; - - // [Output only] BGP communities in human-readable A:B format. - repeated string communities = 2 [json_name = "communities"]; - - // [Output only] Destination IP range for the route, in human-readable CIDR - // format - optional BgpRouteNetworkLayerReachabilityInformation destination = 3 - [json_name = "destination"]; - - // [Output only] BGP multi-exit discriminator - optional uint32 med = 4 [json_name = "med"]; - - // [Output only] BGP origin (EGP, IGP or INCOMPLETE) - // BGP_ORIGIN_EGP: - // BGP_ORIGIN_IGP: - // BGP_ORIGIN_INCOMPLETE: - optional string origin = 5 [json_name = "origin"]; -} - -message BgpRouteAsPath { - // [Output only] ASNs in the path segment. When type is SEQUENCE, these are - // ordered. - repeated int32 asns = 1 [json_name = "asns"]; - - // [Output only] Type of AS-PATH segment (SEQUENCE or SET) - // AS_PATH_TYPE_SEQUENCE: - // AS_PATH_TYPE_SET: - optional string type = 2 [json_name = "type"]; -} - -// Network Layer Reachability Information (NLRI) for a route. -message BgpRouteNetworkLayerReachabilityInformation { - // If the BGP session supports multiple paths (RFC 7911), the path identifier - // for this route. - optional uint32 path_id = 1 [json_name = "pathId"]; - - // Human readable CIDR notation for a prefix. E.g. 10.42.0.0/16. - optional string prefix = 2 [json_name = "prefix"]; -} - -// 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"]; -} - -message RoutePolicy { - // An optional description of route policy. - optional string description = 1 [json_name = "description"]; - - // A fingerprint for the Route Policy being applied to this Router, which is - // essentially a hash of the Route Policy used for optimistic locking. The - // fingerprint is initially generated by Compute Engine and changes after - // every request to modify or update Route Policy. You must always provide an - // up-to-date fingerprint hash in order to update or change labels. To see the - // latest fingerprint, make a getRoutePolicy() request to retrieve a Route - // Policy. - optional string fingerprint = 2 [json_name = "fingerprint"]; - - // Route Policy name, which must be a resource ID segment and unique within - // all the router's Route Policies. Name should conform to RFC1035. - optional string name = 3 [json_name = "name"]; - - // List of terms (the order in the list is not important, they are evaluated - // in order of priority). Order of policies is not retained and might change - // when getting policy later. - repeated RoutePolicyPolicyTerm terms = 4 [json_name = "terms"]; - - // ROUTE_POLICY_TYPE_EXPORT: The Route Policy is an Export Policy. - // ROUTE_POLICY_TYPE_IMPORT: The Route Policy is an Import Policy. - optional string type = 5 [json_name = "type"]; -} - -message RoutePolicyPolicyTerm { - // CEL expressions to evaluate to modify a route when this term matches. - repeated Expr actions = 1 [json_name = "actions"]; - - // CEL expression evaluated against a route to determine if this term applies. - // When not set, the term applies to all routes. - optional Expr match = 2 [json_name = "match"]; - - // The evaluation priority for this term, which must be between 0 (inclusive) - // and 2^31 (exclusive), and unique within the list. - optional int32 priority = 3 [json_name = "priority"]; -} - -// 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 = 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 = 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 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 - // 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 { +message BackendBucketAggregatedList { // [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 BackendBucketsScopedList resources. + map items = 2 [json_name = "items"]; - // Type of resource. + // Output only. 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 + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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. + // Output only. [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. + // [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. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -496,19 +120,27 @@ message RouterAggregatedList { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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. @@ -516,383 +148,81 @@ message RouterAggregatedList { } // [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. - 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. - 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, - // fdff: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"]; + optional Warning warning = 6 [json_name = "warning"]; } -// 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. - 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 BackendBucketsScopedList { + // A list of BackendBuckets contained in this scope. + repeated BackendBucket backend_buckets = 1 [json_name = "backendBuckets"]; 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. + // [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. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -901,975 +231,34 @@ message RouterList { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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 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"]; - - // List of Subnetwork resources whose traffic should be translated by NAT64 - // Gateway. It is used only when LIST_OF_IPV6_SUBNETWORKS is selected for the - // SubnetworkIpRangeToNat64Option above. - repeated RouterNatSubnetworkToNat64 nat64_subnetworks = 21 - [json_name = "nat64Subnetworks"]; - - // 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"]; - - // Specify the Nat option for NAT64, which can take one of the following - // values: - ALL_IPV6_SUBNETWORKS: All of the IP ranges in every Subnetwork - // are allowed to Nat. - LIST_OF_IPV6_SUBNETWORKS: A list of Subnetworks are - // allowed to Nat (specified in the field nat64_subnetwork below) The default - // is NAT64_OPTION_UNSPECIFIED. Note that if this field contains - // NAT64_ALL_V6_SUBNETWORKS no other Router.Nat section in this region can - // also enable NAT64 for any Subnetworks in this network. Other Router.Nat - // sections can still be present to enable NAT44 only. - // ALL_IPV6_SUBNETWORKS: NAT64 is enabled for all the IPv6 subnet ranges. In - // dual stack subnets, NAT64 will only be enabled for IPv6-only VMs. - // LIST_OF_IPV6_SUBNETWORKS: NAT64 is enabled for a list of IPv6 subnet - // ranges. In dual stack subnets, NAT64 will only be enabled for IPv6-only - // VMs. If this option is used, the nat64_subnetworks field must be specified. - optional string source_subnetwork_ip_ranges_to_nat64 = 22 - [json_name = "sourceSubnetworkIpRangesToNat64"]; - - // 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"]; -} - -// 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"]; -} - -// Specifies a subnetwork to enable NAT64. -message RouterNatSubnetworkToNat64 { - // URL for the subnetwork resource that will use NAT64. - optional string name = 1 [json_name = "name"]; -} - -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 RoutersGetRoutePolicyResponse { - optional RoutePolicy resource = 1 [json_name = "resource"]; -} - -message RoutersListBgpRoutes { - 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] Type of resource. Always compute#routersListBgpRoutes for - // lists of bgp routes. - 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] A list of bgp routes. - repeated BgpRoute result = 5 [json_name = "result"]; - - // [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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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 RoutersListRoutePolicies { - 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] Type of resource. Always compute#routersListRoutePolicies for - // lists of route policies. - 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] A list of route policies. - repeated RoutePolicy result = 5 [json_name = "result"]; - - // [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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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 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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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. + // Informational warning which replaces the list of + // backend services 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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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 5db4ab6e0d5ed..32aba23ae0d6f 100644 --- a/protos/google/cloud/compute/v1/internal/common_014.proto +++ b/protos/google/cloud/compute/v1/internal/common_014.proto @@ -15,453 +15,107 @@ // 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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_021.proto"; +import "google/cloud/compute/v1/internal/common_000.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 = 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"]; - - // 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 { +// 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 Disk resources. - repeated Disk items = 2 [json_name = "items"]; + // A list of BackendServicesScopedList resources. + map items = 2 [json_name = "items"]; - // [Output Only] Type of resource. Always compute#diskList for lists of disks. + // Output only. 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 + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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. + // Output only. [Output Only] Server-defined URL for this resource. optional string self_link = 5 [json_name = "selfLink"]; + // Output only. [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. + // [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. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -470,19 +124,27 @@ message DiskList { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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. @@ -490,47 +152,117 @@ message DiskList { } // [Output Only] Informational warning message. - optional Warning warning = 6 [json_name = "warning"]; + optional Warning warning = 7 [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 BackendServicesScopedList { + // A list of BackendServices contained in this scope. + repeated BackendService backend_services = 1 [json_name = "backendServices"]; -message DiskResourceStatus { - optional DiskResourceStatusAsyncReplicationStatus async_primary_disk = 1 - [json_name = "asyncPrimaryDisk"]; + 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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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"]; - // Key: disk, value: AsyncReplicationStatus message - map async_secondary_disks = - 2 [json_name = "asyncSecondaryDisks"]; -} + 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 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"]; -} + // [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 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"]; + // 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_015.proto b/protos/google/cloud/compute/v1/internal/common_015.proto index 2c4c98a446d1f..00ee25806b982 100644 --- a/protos/google/cloud/compute/v1/internal/common_015.proto +++ b/protos/google/cloud/compute/v1/internal/common_015.proto @@ -15,119 +15,673 @@ // 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: 20250601 +// revision: 20260807 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 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"]; +import "google/cloud/compute/v1/internal/common_061.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"]; + + // 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 { + // Optional metadata defined as annotations on the network endpoint. + map annotations = 1 [json_name = "annotations"]; + + // Represents the port number to which PSC consumer sends packets. + // + // Optional. Only valid for network endpoint groups created + // withGCE_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 + // isNON_GCP_FQDN_PORT. + optional string fqdn = 2 [json_name = "fqdn"]; + + // The name or a URL of VM instance of this network endpoint. + // Optional, the field presence depends on the network endpoint type. The + // field is required for network endpoints of type GCE_VM_IP + // andGCE_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 withRFC1035 + // 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 + // typeGCE_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 typeGCE_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, seeNetwork +// endpoint groups overview. +// +// Note: Use the following APIs to manage network endpoint groups: +// +// - +// To manage NEGs with zonal scope (such as zonal NEGs, hybrid connectivity +// NEGs): zonal +// API +// - +// To manage NEGs with regional scope (such as regional internet NEGs, +// serverless NEGs, Private Service Connect NEGs): regional +// API +// - +// To manage NEGs with global scope (such as global internet NEGs):global +// API +message NetworkEndpointGroup { + // Optional. Metadata defined as annotations on the network endpoint group. + map annotations = 1 [json_name = "annotations"]; + + // Optional. Only valid when networkEndpointType isSERVERLESS. Only one of + // cloudRun,appEngine or cloudFunction may be set. + optional NetworkEndpointGroupAppEngine app_engine = 2 + [json_name = "appEngine"]; + + // Optional. Only valid when networkEndpointType isSERVERLESS. Only one of + // cloudRun,appEngine or cloudFunction may be set. + optional NetworkEndpointGroupCloudFunction cloud_function = 3 + [json_name = "cloudFunction"]; + + // Optional. Only valid when networkEndpointType isSERVERLESS. Only one of + // cloudRun,appEngine or cloudFunction may be set. + optional NetworkEndpointGroupCloudRun cloud_run = 4 [json_name = "cloudRun"]; + + // Output only. [Output Only] Creation timestamp inRFC3339 + // 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. + // + // Optional. 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. [Output Only] The unique identifier for the resource. This + // identifier is + // defined by the server. + optional string id = 8 [json_name = "id"]; + + // Output only. [Output Only] Type of the resource. + // Alwayscompute#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 withRFC1035. + // 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. + // For networkEndpointType GCE_VM_IP_PORT,GCE_VM_IP_PORTMAP or + // NON_GCP_PRIVATE_IP_PORT, + // if this field is not specified, a default network will be used. + // This field cannot be set for NEGs with networkEndpointType set toSERVERLESS + // or PRIVATE_SERVICE_CONNECT and for + // global NEGs. + // For all other network endpoint types, this field is required. + optional string network = 11 [json_name = "network"]; + + // Type of network endpoints in this network endpoint group. Can be one + // ofGCE_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. Only valid when networkEndpointType isPRIVATE_SERVICE_CONNECT. + 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. Only valid when networkEndpointType isPRIVATE_SERVICE_CONNECT. + optional string psc_target_service = 14 [json_name = "pscTargetService"]; + + // Output only. [Output Only] The URL of theregion + // where the network endpoint group is located. + optional string region = 15 [json_name = "region"]; + + // Output only. [Output Only] Server-defined URL for the resource. + optional string self_link = 16 [json_name = "selfLink"]; + + // Output only. [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. [Output Only] The URL of thezone + // 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 URLsfoo1-dot-appname.appspot.com/v1 + // andfoo1-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 andmydomain.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 withRFC1035. + // + // 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 withRFC1035. + // + // 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 andfoo1.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"]; } -// 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"]; +message NetworkEndpointGroupList { + // [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"]; + + // Output only. [Output Only] The resource type, which is + // alwayscompute#networkEndpointGroupList for network endpoint group + // lists. + optional string kind = 3 [json_name = "kind"]; - // This field is only temporary. It will be removed. Do not use it. - optional string name = 1 [json_name = "name"]; + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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 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"]; +// All data that is specifically relevant to only network endpoint groups of +// type PRIVATE_SERVICE_CONNECT. +message NetworkEndpointGroupPscData { + // Output only. [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. [Output Only] The PSC connection id of the PSC Network + // Endpoint Group + // Consumer. + optional string psc_connection_id = 2 [json_name = "pscConnectionId"]; + + // Output only. [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 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 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. [Output Only] The resource type, which is + // alwayscompute#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 thanmaxResults, use the + // nextPageToken as a value 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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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"]; } -// 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"]; +message NetworkEndpointWithHealthStatus { + // Output only. [Output only] The health status of network endpoint. + // + // Optional. Displayed only if the network endpoint has centralized health + // checking configured. + repeated HealthStatusForNetworkEndpoint healths = 1 [json_name = "healths"]; + + // Output only. [Output only] The network endpoint. + optional NetworkEndpoint network_endpoint = 2 [json_name = "networkEndpoint"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_016.proto b/protos/google/cloud/compute/v1/internal/common_016.proto index 14a930ba914aa..b9380f5f543d8 100644 --- a/protos/google/cloud/compute/v1/internal/common_016.proto +++ b/protos/google/cloud/compute/v1/internal/common_016.proto @@ -15,317 +15,2334 @@ // 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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -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 regular - // expression of `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. +import "google/cloud/compute/v1/internal/common_040.proto"; +import "google/cloud/compute/v1/internal/common_138.proto"; + +message BfdPacket { + // The Authentication Present bit of the BFD packet. This is specified in + // section 4.1 ofRFC5880 + optional bool authentication_present = 1 + [json_name = "authenticationPresent"]; + + // The Control Plane Independent bit of the BFD packet. This is specified in + // section 4.1 ofRFC5880 + optional bool control_plane_independent = 2 + [json_name = "controlPlaneIndependent"]; + + // The demand bit of the BFD packet. This is specified in section 4.1 + // ofRFC5880 + 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 ofRFC5880 + // 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 ofRFC5880 + optional bool final = 5 [json_name = "final"]; + + // The length of the BFD Control packet in bytes. This is specified in section + // 4.1 ofRFC5880 + 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 ofRFC5880 + 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 ofRFC5880 + 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 ofRFC5880 + 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 ofRFC5880 + optional uint32 multiplier = 10 [json_name = "multiplier"]; + + // The multipoint bit of the BFD packet. This is specified in section 4.1 + // ofRFC5880 + optional bool multipoint = 11 [json_name = "multipoint"]; + + // The My Discriminator value in the BFD packet. This is specified in section + // 4.1 ofRFC5880 + optional uint32 my_discriminator = 12 [json_name = "myDiscriminator"]; + + // The Poll bit of the BFD packet. This is specified in section 4.1 ofRFC5880 + 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 ofRFC5880 + // 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 + // ofRFC5880. + optional uint32 version = 15 [json_name = "version"]; + + // The Your Discriminator value in the BFD packet. This is specified in + // section 4.1 ofRFC5880 + 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 ofRFC5880 + // 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 ofRFC5880 + // 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"]; +} + +message BgpRoute { + // Output only. [Output only] AS-PATH for the route + repeated BgpRouteAsPath as_paths = 1 [json_name = "asPaths"]; + + // Output only. [Output only] BGP communities in human-readable A:B format. + repeated string communities = 2 [json_name = "communities"]; + + // Output only. [Output only] Destination IP range for the route, in + // human-readable CIDR + // format + optional BgpRouteNetworkLayerReachabilityInformation destination = 3 + [json_name = "destination"]; + + // Output only. [Output only] BGP multi-exit discriminator + optional uint32 med = 4 [json_name = "med"]; + + // Output only. [Output only] BGP origin (EGP, IGP or INCOMPLETE) + // BGP_ORIGIN_EGP: + // BGP_ORIGIN_IGP: + // BGP_ORIGIN_INCOMPLETE: + optional string origin = 5 [json_name = "origin"]; +} + +message BgpRouteAsPath { + // Output only. [Output only] ASNs in the path segment. When type is SEQUENCE, + // these are + // ordered. + repeated int32 asns = 1 [json_name = "asns"]; + + // Output only. [Output only] ASNs in the path segment. This field is for + // better + // support of 32 bit ASNs as the other asns field suffers from overflow when + // the ASN is larger. When type is SEQUENCE, these are ordered. + repeated uint32 asns32 = 3 [json_name = "asns32"]; + + // Output only. [Output only] Type of AS-PATH segment (SEQUENCE or SET) + // AS_PATH_TYPE_SEQUENCE: + // AS_PATH_TYPE_SET: + optional string type = 2 [json_name = "type"]; +} + +// Network Layer Reachability Information (NLRI) for a route. +message BgpRouteNetworkLayerReachabilityInformation { + // If the BGP session supports multiple paths (RFC 7911), the path + // identifier for this route. + optional uint32 path_id = 1 [json_name = "pathId"]; + + // Human readable CIDR notation for a prefix. E.g. 10.42.0.0/16. + optional string prefix = 2 [json_name = "prefix"]; +} + +message NamedSet { + // An optional description of named set. 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"]; + // CEL expressions that are comparable to constructs of this set's type + // (see Policy Language). + repeated Expr elements = 2 [json_name = "elements"]; + + // A fingerprint for the Named Set being applied to this Router, which is + // essentially a hash of the Named Set used for optimistic locking. + // The fingerprint is initially generated by Compute Engine and changes + // after every request to modify or update the Named Set. You must always + // provide an up-to-date fingerprint hash in order to update or change + // labels. + // + // To see the latest fingerprint, make a getNamedSet() request + // to retrieve a Named Set. + optional string fingerprint = 3 [json_name = "fingerprint"]; + + // This set's name, which must be a resource ID segment and unique within all + // named sets owned by the Router. Name should conform to RFC1035. + optional string name = 4 [json_name = "name"]; + + // This named set's type + // NAMED_SET_TYPE_COMMUNITY: The Named Set is a Community Named Set. + // NAMED_SET_TYPE_PREFIX: The Named Set is a Prefix Named Set. + optional string type = 5 [json_name = "type"]; +} + +// Contains NAT IP information of a NAT config (i.e. usage status, mode). +message NatIpInfo { + // Output only. A list of all NAT IPs assigned to this NAT config. + repeated NatIpInfoNatIpInfoMapping nat_ip_info_mappings = 1 + [json_name = "natIpInfoMappings"]; + + // Output only. 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 { + // Output only. Specifies whether NAT IP is auto or manual. + // AUTO: + // MANUAL: + optional string mode = 1 [json_name = "mode"]; + + // Output only. NAT IP address. For example: 203.0.113.11. + optional string nat_ip = 2 [json_name = "natIp"]; + + // Output only. 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"]; +} + +message RoutePolicy { + // An optional description of route policy. + optional string description = 1 [json_name = "description"]; + + // A fingerprint for the Route Policy being applied to this Router, which is + // essentially a hash of the Route Policy used for optimistic locking. + // The fingerprint is initially generated by Compute Engine and changes + // after every request to modify or update Route Policy. You must always + // provide an up-to-date fingerprint hash in order to update or change + // labels. + // + // To see the latest fingerprint, make a getRoutePolicy() request + // to retrieve a Route Policy. + optional string fingerprint = 2 [json_name = "fingerprint"]; + + // Route Policy name, which must be a resource ID segment and unique + // within all the router's Route Policies. Name should conform to RFC1035. + optional string name = 3 [json_name = "name"]; + + // List of terms (the order in the list is not important, they are evaluated + // in order of priority). Order of policies is not retained and might change + // when getting policy later. + repeated RoutePolicyPolicyTerm terms = 4 [json_name = "terms"]; + + // ROUTE_POLICY_TYPE_EXPORT: The Route Policy is an Export Policy. + // ROUTE_POLICY_TYPE_IMPORT: The Route Policy is an Import Policy. + optional string type = 5 [json_name = "type"]; +} + +message RoutePolicyPolicyTerm { + // CEL expressions to evaluate to modify a route when this term matches. + repeated Expr actions = 1 [json_name = "actions"]; + + // CEL expression evaluated against a route to determine if this term + // applies. When not set, the term applies to all + // routes. + optional Expr match = 2 [json_name = "match"]; + + // The evaluation priority for this term, which must be between 0 + // (inclusive) and 2^31 (exclusive), and unique within the list. + optional int32 priority = 3 [json_name = "priority"]; +} + +// Represents a Cloud Router resource. +// +// For more information about Cloud Router, read theCloud +// 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 + // toRFC4273. + repeated RouterBgpPeer bgp_peers = 2 [json_name = "bgpPeers"]; + + // Output only. [Output Only] Creation timestamp inRFC3339 + // 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"]; + + // 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 = 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. [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 withRFC1035. + // 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"]; + + // A list of NAT services created in this router. + repeated RouterNat nats = 11 [json_name = "nats"]; + + // URI of the ncc_gateway to which this router associated. + optional string ncc_gateway = 15 [json_name = "nccGateway"]; + + // URI of the network to which this router belongs. + optional string network = 12 [json_name = "network"]; + + // Input only. [Input Only] Additional params passed with the request, but not + // persisted + // as part of resource payload. + optional RouterParams params = 16 [json_name = "params"]; + + // [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 { + // [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"]; + + // Output only. 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 thanmaxResults, use the + // nextPageToken as a value 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. [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + // Output only. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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] The array of errors encountered while processing this + // [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 anRFC6996 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. + 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. + 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. [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 withRFC1035. + // 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 + // theRFC3927 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, fdff: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. [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 withRFC1035. + // 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 + // withRFC1035. 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. [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 + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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. [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. - repeated ErrorsItem errors = 1 [json_name = "errors"]; + // 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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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 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 withRFC1035. + 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"]; + + // Output only. Effective timeout (in seconds) for TCP connections that are in + // TIME_WAIT + // state. This value is equal to tcp_time_wait_timeout_sec. + // If tcp_time_wait_timeout_sec isn't set, the effective timeout is 30s or + // 120s. The field is output only. + optional int32 effective_tcp_time_wait_timeout_sec = 23 + [json_name = "effectiveTcpTimeWaitTimeoutSec"]; + + // 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 withRFC1035. + optional string name = 9 [json_name = "name"]; + + // List of Subnetwork resources whose traffic should be translated by NAT64 + // Gateway. It is used only when LIST_OF_IPV6_SUBNETWORKS is + // selected for the SubnetworkIpRangeToNat64Option above. + repeated RouterNatSubnetworkToNat64 nat64_subnetworks = 21 + [json_name = "nat64Subnetworks"]; + + // 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"]; + + // Specify the Nat option for NAT64, which can take one of the following + // values: + // + // - ALL_IPV6_SUBNETWORKS: All of the IP ranges in + // every Subnetwork are allowed to Nat. + // - LIST_OF_IPV6_SUBNETWORKS: A list of Subnetworks are allowed to Nat + // (specified in the field nat64_subnetwork below) + // + // + // The default is NAT64_OPTION_UNSPECIFIED. + // Note that if this field contains NAT64_ALL_V6_SUBNETWORKS no other + // Router.Nat section in this region can also enable NAT64 for any + // Subnetworks in this network. Other Router.Nat sections can still be + // present to enable NAT44 only. + // ALL_IPV6_SUBNETWORKS: NAT64 is enabled for all the IPv6 subnet ranges. + // In dual stack subnets, NAT64 will only be enabled for IPv6-only VMs. + // LIST_OF_IPV6_SUBNETWORKS: NAT64 is enabled for a list of IPv6 subnet + // ranges. + // In dual stack subnets, NAT64 will only be enabled for IPv6-only VMs. + // If this option is used, the nat64_subnetworks field must be specified. + optional string source_subnetwork_ip_ranges_to_nat64 = 22 + [json_name = "sourceSubnetworkIpRangesToNat64"]; + + // 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"]; +} + +// 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"]; +} + +// Specifies a subnetwork to enable NAT64. +message RouterNatSubnetworkToNat64 { + // URL for the subnetwork resource that will use NAT64. + optional string name = 1 [json_name = "name"]; +} + +// Additional router parameters. +message RouterParams { + // Tag keys/values directly bound to this resource. + // The field is allowed for INSERT + // only. The keys/values to set on the resource should be specified in + // either ID { : } or Namespaced format + // { : }. + // For example the following are valid inputs: + // * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} + // * {"123/environment" : "production", "345/abc" : "xyz"} + // Note: + // * Invalid combinations of ID & namespaced format is not supported. For + // instance: {"123/environment" : "tagValues/444"} is invalid. + // * Inconsistent format is not supported. For instance: + // {"tagKeys/333" : "tagValues/444", "123/env" : "prod"} is invalid. + map resource_manager_tags = 1 + [json_name = "resourceManagerTags"]; +} + +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 ncc_gateway to which this router associated. + optional string ncc_gateway = 6 [json_name = "nccGateway"]; + + // 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"]; + + // Output only. 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"]; + + // Output only. 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"]; + + // Output only. IP address of the local BGP interface. + optional string ip_address = 4 [json_name = "ipAddress"]; + + // Output only. IPv4 address of the local BGP interface. + optional string ipv4_nexthop_address = 19 [json_name = "ipv4NexthopAddress"]; + + // Output only. IPv6 address of the local BGP interface. + optional string ipv6_nexthop_address = 5 [json_name = "ipv6NexthopAddress"]; + + // Output only. 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"]; + + // Output only. Name of this BGP peer. Unique within the Routers resource. + optional string name = 8 [json_name = "name"]; + + // Output only. Number of routes learned from the remote BGP Peer. + optional uint32 num_learned_routes = 9 [json_name = "numLearnedRoutes"]; + + // Output only. IP address of the remote BGP interface. + optional string peer_ip_address = 10 [json_name = "peerIpAddress"]; + + // Output only. IPv4 address of the remote BGP interface. + optional string peer_ipv4_nexthop_address = 20 + [json_name = "peerIpv4NexthopAddress"]; + + // Output only. IPv6 address of the remote BGP interface. + optional string peer_ipv6_nexthop_address = 11 + [json_name = "peerIpv6NexthopAddress"]; + + // Output only. [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"]; + + // Output only. The state of the BGP session. For a list of possible values + // for this + // field, seeBGP session states. + optional string state = 13 [json_name = "state"]; + + // Output only. 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"]; + + // Output only. 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"]; + + // Output only. 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 { + // Output only. 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"]; + + // Output only. 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"]; + + // Output only. 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"]; + + // Output only. 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"]; + + // Output only. Unique name of this NAT. + optional string name = 5 [json_name = "name"]; + + // Output only. 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"]; + + // Output only. A list of fully qualified URLs of reserved IP address + // resources. + repeated string user_allocated_nat_ip_resources = 8 + [json_name = "userAllocatedNatIpResources"]; + + // Output only. 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 { + // Output only. 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"]; + + // Output only. 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"]; + + // Output only. 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"]; + + // Output only. 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"]; + + // Output only. Rule number of the rule. + optional int32 rule_number = 5 [json_name = "ruleNumber"]; +} + +message RouterStatusResponse { + // Output only. Type of resource. + optional string kind = 1 [json_name = "kind"]; + + optional RouterStatus result = 2 [json_name = "result"]; +} + +message RoutersGetNamedSetResponse { + // end_interface: MixerGetResponseWithEtagBuilder + optional string etag = 1 [json_name = "etag"]; + + optional NamedSet resource = 2 [json_name = "resource"]; +} + +message RoutersGetRoutePolicyResponse { + optional RoutePolicy resource = 1 [json_name = "resource"]; +} + +message RoutersListBgpRoutes { + 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. [Output Only] Type of resource. + // Alwayscompute#routersListBgpRoutes for lists of bgp routes. + 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 thanmaxResults, use the + // nextPageToken as a value 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] A list of bgp routes. + repeated BgpRoute result = 5 [json_name = "result"]; + + // Output only. [Output Only] Server-defined URL for this resource. + optional string self_link = 6 [json_name = "selfLink"]; + + // Output only. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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 errors are generated during processing of the operation, - // this field will be populated. - optional Error error = 5 [json_name = "error"]; + // [Output Only] Informational warning message. + optional Warning warning = 8 [json_name = "warning"]; +} + +message RoutersListNamedSets { + 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. [Output Only] Type of resource. + // Alwayscompute#routersListNamedSets for lists of named sets. + 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 thanmaxResults, use the + // nextPageToken as a value 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] A list of named sets. + repeated NamedSet result = 5 [json_name = "result"]; + + // Output only. [Output Only] Server-defined URL for this resource. + optional string self_link = 6 [json_name = "selfLink"]; + + // Output only. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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] 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] 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] 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] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } - // [Output Only] The unique identifier for the operation. This identifier is + // [Output Only] Informational warning message. + optional Warning warning = 8 [json_name = "warning"]; +} + +message RoutersListRoutePolicies { + 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 = 8 [json_name = "id"]; + optional string id = 2 [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"]; + // Output only. [Output Only] Type of resource. + // Alwayscompute#routersListRoutePolicies for lists of route policies. + optional string kind = 3 [json_name = "kind"]; - optional InstancesBulkInsertOperationMetadata - instances_bulk_insert_operation_metadata = 25 - [json_name = "instancesBulkInsertOperationMetadata"]; + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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] Type of the resource. Always `compute#operation` for - // Operation resources. - optional string kind = 10 [json_name = "kind"]; + // [Output Only] A list of route policies. + repeated RoutePolicy result = 5 [json_name = "result"]; - // [Output Only] Name of the operation. - optional string name = 11 [json_name = "name"]; + // Output only. [Output Only] Server-defined URL for this resource. + optional string self_link = 6 [json_name = "selfLink"]; - // [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. [Output Only] Unreachable resources. + repeated string unreachables = 7 [json_name = "unreachables"]; - // [Output Only] The type of operation, such as `insert`, `update`, or - // `delete`, and so on. - optional string operation_type = 13 [json_name = "operationType"]; + 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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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 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"]; + 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] The URL of the region where the operation resides. Only - // applicable when performing regional operations. - optional string region = 15 [json_name = "region"]; + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } - // [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. + // [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 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. + // 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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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 { + // Output only. 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 { + // Output only. 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"]; + + // Output only. 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"]; + + // Output only. 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"]; + + // Output only. 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"]; + + // Output only. Information about mappings provided by rules in this NAT. + repeated VmEndpointNatMappingsInterfaceNatMappingsNatRuleMappings + rule_mappings = 5 [json_name = "ruleMappings"]; + + // Output only. 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"]; + + // Output only. 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 { + // Output only. 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"]; + + // Output only. 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"]; + + // Output only. 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"]; + + // Output only. 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"]; + + // Output only. 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. [Output Only] Type of resource. + // Alwayscompute#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 thanmaxResults, use the + // nextPageToken as a value 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. [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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -334,105 +2351,33 @@ message Operation { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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"]; -} - -// 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"]; - - // 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"]; -} - -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 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"]; -} - -// 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"]; + // [Output Only] Informational warning message. + optional Warning warning = 6 [json_name = "warning"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_017.proto b/protos/google/cloud/compute/v1/internal/common_017.proto index 0e4f8cf5a0f11..0d72a21ffbce6 100644 --- a/protos/google/cloud/compute/v1/internal/common_017.proto +++ b/protos/google/cloud/compute/v1/internal/common_017.proto @@ -15,111 +15,593 @@ // 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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_014.proto"; +import "google/cloud/compute/v1/internal/common_028.proto"; -message BulkSetLabelsRequest { - // 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 may - // optionally 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"]; +// 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 parameters for the instant snapshot group. + optional InstantSnapshotGroupParameters instant_snapshot_group_parameters = 2 + [json_name = "instantSnapshotGroupParameters"]; - // The labels to set for this resource. - map labels = 2 [json_name = "labels"]; + // The parameters for the snapshot group. The usage of snapshot group feature + // is restricted. + optional SnapshotGroupParameters snapshot_group_parameters = 3 + [json_name = "snapshotGroupParameters"]; + + // 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](https://cloud.google.com/compute/docs/reference/rest/v1/disks) +// * +// [Regional](https://cloud.google.com/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, readZonal 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. [Output Only] A list of disks this disk is asynchronously + // replicated to. + map async_secondary_disks = 40 + [json_name = "asyncSecondaryDisks"]; + + // Output only. [Output Only] Creation timestamp inRFC3339 + // 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, + // thediskEncryptionKey.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. [Output Only] The unique identifier for the resource. This + // identifier is + // defined by the server. + optional string id = 6 [json_name = "id"]; + + // Output only. [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 error412 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. [Output Only] Last attach timestamp inRFC3339 + // text format. + optional string last_attach_timestamp = 10 + [json_name = "lastAttachTimestamp"]; + + // Output only. [Output Only] Last detach timestamp inRFC3339 + // 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 withRFC1035. + // 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 theExtreme 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. [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. [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. [Output Only] Reserved for future use. + optional bool satisfies_pzs = 23 [json_name = "satisfiesPzs"]; + + // Output only. [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 thesourceImage, + // sourceSnapshot, orsourceDisk parameter, or specify it alone to create an + // empty + // persistent disk. + // + // If you specify this field along with a source, the value ofsizeGb 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. [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. [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. [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, specifyfamily/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"]; + + // Thecustomer-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. [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. [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"]; + + // Thecustomer-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. [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. [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. [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. [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. [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. [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. [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 BulkZoneSetLabelsRequest { - repeated BulkSetLabelsRequest requests = 1 [json_name = "requests"]; +message DiskAsyncReplicationList { + optional DiskAsyncReplication async_replication_disk = 1 + [json_name = "asyncReplicationDisk"]; } -message DiskAggregatedList { +// 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 DisksScopedList resources. - map items = 2 [json_name = "items"]; + // A list of Disk resources. + repeated Disk items = 2 [json_name = "items"]; - // [Output Only] Type of resource. Always compute#diskAggregatedList for - // aggregated lists of persistent disks. + // Output only. [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 + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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. + // Output only. [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. + // [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. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -128,19 +610,27 @@ message DiskAggregatedList { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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. @@ -148,126 +638,96 @@ message DiskAggregatedList { } // [Output Only] Informational warning message. - optional Warning warning = 7 [json_name = "warning"]; + optional Warning warning = 6 [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"]; +// Additional disk params. +message DiskParams { + // Input only. Resource manager tags to be bound to the disk. Tag keys and + // values + // have the same definition as resource + // manager tags. Keys and values can be either in numeric format, + // such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in + // namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and + // `{tag_value_short_name}`. The field is ignored (both PUT & + // PATCH) when empty. + map resource_manager_tags = 1 + [json_name = "resourceManagerTags"]; } -message DisksRemoveResourcePoliciesRequest { - // Resource policies to be removed from this disk. - repeated string resource_policies = 1 [json_name = "resourcePolicies"]; -} +message DiskResourceStatus { + optional DiskResourceStatusAsyncReplicationStatus async_primary_disk = 1 + [json_name = "asyncPrimaryDisk"]; -message DisksResizeRequest { - // The new size of the persistent disk, which is specified in GB. - optional string size_gb = 1 [json_name = "sizeGb"]; + // Key: disk, value: AsyncReplicationStatus message + map async_secondary_disks = + 2 [json_name = "asyncSecondaryDisks"]; } -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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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 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"]; +} - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } +// 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"]; +} - // [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 InstantSnapshotGroupParameters { + // The source instant snapshot group used to create disks. 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/instantSnapshotGroups/instantSnapshotGroup + // - + // projects/project/zones/zone/instantSnapshotGroups/instantSnapshotGroup + // - zones/zone/instantSnapshotGroups/instantSnapshotGroup + optional string source_instant_snapshot_group = 1 + [json_name = "sourceInstantSnapshotGroup"]; +} - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } +message SnapshotGroupParameters { + // URLs of the zones where disks should be replicated to. Only applicable + // for regional resources. + repeated string replica_zones = 1 [json_name = "replicaZones"]; - // [Output Only] Informational warning which replaces the list of disks when - // the list is empty. - optional Warning warning = 2 [json_name = "warning"]; -} + // The source snapshot group used to create disks. 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/snapshotGroups/snapshotGroup + // - projects/project/global/snapshotGroups/snapshotGroup + // - global/snapshotGroups/snapshotGroup + optional string source_snapshot_group = 2 [json_name = "sourceSnapshotGroup"]; -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"]; + // URL of the disk type resource describing which disk type to use to create + // disks. Provide this when creating the disk. For + // example:projects/project/zones/zone/diskTypes/pd-ssd. See Persistent disk + // types. + optional string type = 3 [json_name = "type"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_018.proto b/protos/google/cloud/compute/v1/internal/common_018.proto index 5d7529b3019a0..351eca64b4239 100644 --- a/protos/google/cloud/compute/v1/internal/common_018.proto +++ b/protos/google/cloud/compute/v1/internal/common_018.proto @@ -15,249 +15,200 @@ // 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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_020.proto"; - -message CacheInvalidationRule { - // A list of cache tags used to identify cached objects. - Cache tags are - // specified when the response is first cached, by setting the `Cache-Tag` - // response header at the origin. - Multiple cache tags in the same - // invalidation request are treated as Boolean `OR` - for example, `tag1 OR - // tag2 OR tag3`. - If other fields are also specified, these are treated as - // Boolean `AND` with any tags. Up to 10 tags can be specified in a single - // invalidation request. - repeated string cache_tags = 3 [json_name = "cacheTags"]; - - // If set, this invalidation rule will only apply to requests with a Host - // header matching host. - optional string host = 1 [json_name = "host"]; - - optional string path = 2 [json_name = "path"]; +import "google/cloud/compute/v1/internal/common_004.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"]; + + // A flexible specification of machine type of instances to create. + optional InstanceFlexibilityPolicy instance_flexibility_policy = 8 + [json_name = "instanceFlexibilityPolicy"]; + + // 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, seeCreate 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. Ifmin_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 asinst-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 + // nameinst-0050, then instance names generated using the patterninst-#### + // 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 withinstanceProperties 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"]; } -message UrlMapsAggregatedList { - // [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"]; - - // 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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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"]; +// 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"]; - // [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. This field is only temporary. It will be removed. Do not use + // it. + optional string name = 1 [json_name = "name"]; } -message UrlMapsScopedList { - // A list of UrlMaps contained in this scope. - repeated UrlMap url_maps = 1 [json_name = "urlMaps"]; - - 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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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"]; - } +// A flexible specification of machine types for instances to create. +message InstanceFlexibilityPolicy { + // Specification of alternative, flexible instance subsets. + // One of them will be selected to create the instances + // based on various criteria, like: + // - ranks, + // - location policy, + // - current capacity, + // - available reservations (you can specify affinity in + // InstanceProperties), + // - SWAN/GOOSE limitations. + // Key is an arbitrary, unique RFC1035 string that identifies the instance + // selection. + map instance_selections = + 1 [json_name = "instanceSelections"]; +} - // [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"]; +// Specification of machine type to use. Every position inside this message +// is an alternative. +// The count specified in the shape flexibility must not exceed the number +// of entries in per_instance_properties or the capacity of the +// name_pattern, if used. +message InstanceFlexibilityPolicyInstanceSelection { + // Disks to be attached to the instances created from in this selection. + // They override the disks specified in the instance properties. + repeated AttachedDisk disks = 1 [json_name = "disks"]; + + // Alternative machine types to use for instances that are created from + // these properties. This field only accepts a machine type names, for + // example `n2-standard-4` and not URLs or partial URLs. + repeated string machine_types = 2 [json_name = "machineTypes"]; + + // Name of the minimum CPU platform to be used by this instance selection. + // e.g. 'Intel Ice Lake'. + optional string min_cpu_platform = 3 [json_name = "minCpuPlatform"]; + + // Rank when prioritizing the shape flexibilities. + // The instance selections with rank are considered + // first, in the ascending order of the rank. + // If not set, defaults to 0. + optional string rank = 4 [json_name = "rank"]; +} - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } +// 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. + // The bulkInsert operation doesn't create instances in an AI zone, even if + // an AI zone is available in the specified region. For example, if you set a + // DENY preference for us-central1-a, Compute Engine will consider + // us-central1-b and us-central1-c for instance creation, but not + // us-central1-ai1a. Also, you can't use the locations[] configuration to + // allow instance creation in an AI zone. To include an AI zone in bulkInsert + // operations, use the locationPolicy.zones[] field. + 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"]; + + // The bulkInsert operation applies any preferences set in the locations + // field to the specific zones listed in the zones field if the same zones + // are specified in both fields. + repeated LocationPolicyZoneConfiguration zones = 3 [json_name = "zones"]; +} - // Informational warning which replaces the list of backend services when the - // list is empty. - optional Warning warning = 2 [json_name = "warning"]; +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 orDENY. + // ALLOW: Location is allowed for use. + // DENY: Location is prohibited. + // PREFERENCE_UNSPECIFIED: Default value, unused. + optional string preference = 2 [json_name = "preference"]; } -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"]; +// 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"]; +} - // Content of the UrlMap to be validated. - optional UrlMap resource = 2 [json_name = "resource"]; +message LocationPolicyZoneConfiguration { + // The URL of the zone. + // The zone must exist in the region where the request is called. + // Zones must be represented as valid partial URLs, + // such as zones/us-central1-a. + optional string zone = 1 [json_name = "zone"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_019.proto b/protos/google/cloud/compute/v1/internal/common_019.proto index 8395047ddf4bf..0b7f91e3d2c30 100644 --- a/protos/google/cloud/compute/v1/internal/common_019.proto +++ b/protos/google/cloud/compute/v1/internal/common_019.proto @@ -15,481 +15,400 @@ // 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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_006.proto"; - -// Represents a regional resource-based commitment resource. Creating this -// commitment resource means that you are purchasing a resource-based committed -// use contract, with an explicit start and end time. You can purchase -// resource-based commitments for both hardware and software resources. For more -// information, read Resource-based committed use discounts -message Commitment { - // Specifies whether to automatically renew the commitment at the end of its - // current term. The default value is false. If you set the field to true, - // each time your commitment reaches the end of its term, Compute Engine - // automatically renews it for another term. You can update this field anytime - // before the commitment expires. For example, if the commitment is set to - // expire at 12 AM UTC-8 on January 3, 2027, you can update this field until - // 11:59 PM UTC-8 on January 2, 2027. - optional bool auto_renew = 1 [json_name = "autoRenew"]; - - // The category of the commitment; specifies whether the commitment is for - // hardware or software resources. Category MACHINE specifies that you are - // committing to hardware machine resources such as VCPU or MEMORY, listed in - // resources. Category LICENSE specifies that you are committing to software - // licenses, listed in licenseResources. Note that if you specify MACHINE - // commitments, then you must also specify a type to indicate the machine - // series of the hardware resource that you are committing to. - // 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 requested commitment end time in - // RFC3339 text format. Use this option when the desired commitment's end date - // is later than the start date + term duration. - optional string custom_end_timestamp = 22 [json_name = "customEndTimestamp"]; - - // An optional description of the commitment. You can 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"]; - - 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"]; - - // The list of source commitments that you are merging to create the new - // merged commitment. For more information, see Merging commitments. - repeated string merge_source_commitments = 9 - [json_name = "mergeSourceCommitments"]; - - // Name of the commitment. You must specify a name when you purchase the - // commitment. 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 minimum time duration that you commit to purchasing resources. The plan - // that you choose determines the preset term length of the commitment (which - // is 1 year or 3 years) and affects the discount rate that you receive for - // your resources. Committing to a longer time duration typically gives you a - // higher discount rate. The supported values for this field 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 the commitment and committed - // resources are located. - optional string region = 12 [json_name = "region"]; - - // The list of new reservations that you want to create and attach to this - // commitment. You must attach reservations to your commitment if your - // commitment specifies any GPUs or Local SSD disks. For more information, see - // Attach reservations to resource-based commitments. Specify this property - // only if you want to create new reservations to attach. To attach existing - // reservations, specify the existingReservations property instead. - repeated Reservation reservations = 13 [json_name = "reservations"]; - - // [Output Only] Status information for Commitment resource. - optional CommitmentResourceStatus resource_status = 23 - [json_name = "resourceStatus"]; - - // The list of all the hardware resources, with their types and amounts, that - // you want to commit to. Specify as a separate entry in the list for each - // individual resource type. - repeated ResourceCommitment resources = 14 [json_name = "resources"]; +import "google/protobuf/any.proto"; - // [Output Only] Server-defined URL for the resource. - optional string self_link = 15 [json_name = "selfLink"]; - - // The source commitment from which you are transferring resources to create - // the new split commitment. For more information, see Split commitments. - 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). Status can be one of the - // following values: NOT_YET_ACTIVE, ACTIVE, or 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"]; +message BulkInsertOperationStatus { + // [Output Only] Count of VMs successfully created so far. + optional int32 created_vm_count = 1 [json_name = "createdVmCount"]; - // [Output Only] An optional, human-readable explanation of the status. - optional string status_message = 19 [json_name = "statusMessage"]; + // [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"]; - // The type of commitment; specifies the machine series for which you want to - // commit to purchasing resources. The choice of machine series affects the - // discount rate and the eligible resource types. The type must be one of the - // following: 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, MEMORY_OPTIMIZED_X4, STORAGE_OPTIMIZED_Z3. For - // example, type MEMORY_OPTIMIZED specifies a commitment that applies only to - // eligible resources of memory optimized M1 and M2 machine series. Type - // GENERAL_PURPOSE specifies a commitment that applies only to eligible - // resources of general purpose N1 machine series. - // ACCELERATOR_OPTIMIZED: - // ACCELERATOR_OPTIMIZED_A3: - // ACCELERATOR_OPTIMIZED_A3_MEGA: - // ACCELERATOR_OPTIMIZED_A3_ULTRA: - // ACCELERATOR_OPTIMIZED_A4: - // COMPUTE_OPTIMIZED: - // COMPUTE_OPTIMIZED_C2D: - // COMPUTE_OPTIMIZED_C3: - // COMPUTE_OPTIMIZED_C3D: - // COMPUTE_OPTIMIZED_H3: - // COMPUTE_OPTIMIZED_H4D: - // GENERAL_PURPOSE: - // GENERAL_PURPOSE_C4: - // GENERAL_PURPOSE_C4A: - // GENERAL_PURPOSE_C4D: - // GENERAL_PURPOSE_E2: - // GENERAL_PURPOSE_N2: - // GENERAL_PURPOSE_N2D: - // GENERAL_PURPOSE_N4: - // GENERAL_PURPOSE_T2D: - // GRAPHICS_OPTIMIZED: - // MEMORY_OPTIMIZED: - // MEMORY_OPTIMIZED_M3: - // MEMORY_OPTIMIZED_M4: - // MEMORY_OPTIMIZED_M4_6TB: - // MEMORY_OPTIMIZED_X4_16TB: - // MEMORY_OPTIMIZED_X4_24TB: - // MEMORY_OPTIMIZED_X4_32TB: - // STORAGE_OPTIMIZED_Z3: - // TYPE_UNSPECIFIED: Note for internal users: When adding a new enum Type for - // v1, make sure to also add it in the comment for the `optional Type type` - // definition. This ensures that the public documentation displays the new - // enum Type. - optional string type = 20 [json_name = "type"]; + // [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"]; } -message CommitmentAggregatedList { - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 1 [json_name = "id"]; +// 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 regular expression of `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"]; +} - // A list of CommitmentsScopedList resources. - map items = 2 [json_name = "items"]; +message GetVersionOperationMetadata { + optional GetVersionOperationMetadataSbomInfo inline_sbom_info = 1 + [json_name = "inlineSbomInfo"]; +} - // [Output Only] Type of resource. Always compute#commitmentAggregatedList for - // aggregated lists of commitments. - optional string kind = 3 [json_name = "kind"]; +message GetVersionOperationMetadataSbomInfo { + // A mapping of components to their currently-applied versions or other + // appropriate identifiers. + map current_component_versions = 1 + [json_name = "currentComponentVersions"]; - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value 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"]; + // A mapping of components to their target versions or other appropriate + // identifiers. + map target_component_versions = 2 + [json_name = "targetComponentVersions"]; +} - // [Output Only] Server-defined URL for this resource. - optional string self_link = 5 [json_name = "selfLink"]; +// 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"]; +} - // [Output Only] Unreachable resources. - repeated string unreachables = 6 [json_name = "unreachables"]; +// Describes a URL link. +message HelpLink { + // Describes what the link offers. + 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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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 URL of the link. + optional string url = 2 [json_name = "url"]; +} - 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 InstancesBulkInsertOperationMetadata { + // Status information per location (location name is key). + // Example key: zones/us-central1-a + map per_location_status = 1 + [json_name = "perLocationStatus"]; +} - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } +// 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"]; - // [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 localized error message in the above locale. + optional string message = 2 [json_name = "message"]; +} - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; +// Represents an Operation resource. +// +// Google Compute Engine has three Operation resources: +// +// * +// [Global](https://cloud.google.com/compute/docs/reference/rest/v1/globalOperations) +// * +// [Regional](https://cloud.google.com/compute/docs/reference/rest/v1/regionOperations) +// * +// [Zonal](https://cloud.google.com/compute/docs/reference/rest/v1/zoneOperations) +// +// You can use an operation resource to manage asynchronous API requests. +// For more information, readHandling +// 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 + // inRFC3339 + // 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 { + // Error information containing structured domain, reason, and metadata. + optional ErrorInfo error_info = 1 [json_name = "errorInfo"]; + + // Links and information to help the user resolve the error. + optional Help help = 2 [json_name = "help"]; + + // A localized human-readable error message intended for end users. + optional LocalizedMessage localized_message = 3 + [json_name = "localizedMessage"]; + + // Details about quota limits and metrics when a quota is exceeded. + 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 message. - optional Warning warning = 7 [json_name = "warning"]; -} + // [Output Only] If errors are generated during processing of the operation, + // this field will be populated. + optional Error error = 5 [json_name = "error"]; -// 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"]; + optional GetVersionOperationMetadata get_version_operation_metadata = 27 + [json_name = "getVersionOperationMetadata"]; - // A list of Commitment resources. - repeated Commitment items = 2 [json_name = "items"]; + // [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] Type of resource. Always compute#commitmentList for lists of - // commitments. - optional string kind = 3 [json_name = "kind"]; + // [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] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value 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 operation. This identifier is + // defined by the server. + optional string id = 8 [json_name = "id"]; - // [Output Only] Server-defined URL for this resource. - optional string self_link = 5 [json_name = "selfLink"]; + // [Output Only] The time that this operation was requested. + // This value is inRFC3339 + // text format. + optional string insert_time = 9 [json_name = "insertTime"]; - 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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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 InstancesBulkInsertOperationMetadata + instances_bulk_insert_operation_metadata = 25 + [json_name = "instancesBulkInsertOperationMetadata"]; - 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. [Output Only] Type of the resource. Always `compute#operation` + // for + // Operation resources. + optional string kind = 10 [json_name = "kind"]; - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } + // [Output Only] Name of the operation. + optional string name = 11 [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. [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] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } + // [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] Informational warning message. - optional Warning warning = 6 [json_name = "warning"]; -} + // [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] 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"]; -} + // [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. [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 inRFC3339 + // 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: The operation has completed processing successfully or with an error. + // PENDING: The operation is waiting to be processed. + // RUNNING: The operation is actively being processed. + optional string status = 18 [json_name = "status"]; -message CommitmentsScopedList { - // [Output Only] The list of commitments contained in this scope. - repeated Commitment commitments = 1 [json_name = "commitments"]; + // [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"]; - 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. + // [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. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -498,65 +417,117 @@ message CommitmentsScopedList { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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"]; + // [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"]; } -// Commitment for a particular license resource. -message LicenseResourceCommitment { - // The number of licenses you plan to purchase. - optional string amount = 1 [json_name = "amount"]; +// 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"]; + + // 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"]; +} - // The number of cores per license. - optional string cores_per_license = 2 [json_name = "coresPerLicense"]; +message SetCommonInstanceMetadataOperationMetadata { + // [Output Only] The client operation id. + optional string client_operation_id = 1 [json_name = "clientOperationId"]; - // The applicable license URI. - optional string license = 3 [json_name = "license"]; + // [Output Only] Status information per location (location name is key). + // Example key: zones/us-central1-a + map + per_location_operations = 2 [json_name = "perLocationOperations"]; } -// Commitment for a particular hardware resource (a commitment is composed of -// one or more of these). -message ResourceCommitment { - // Name of the accelerator type or GPU resource. Specify this field only when - // the type of hardware resource is ACCELERATOR. - optional string accelerator_type = 1 [json_name = "acceleratorType"]; - - // The quantity of the hardware resource that you want to commit to purchasing - // (in a type-dependent unit). - For vCPUs, you must specify an integer value. - // - For memory, you specify the amount of MB that you want. The value you - // specify must be a multiple of 256 MB, with up to 6.5 GB of memory per every - // vCPU. - For GPUs, you must specify an integer value. - For Local SSD disks, - // you must specify the amount in GB. The size of a single Local SSD disk is - // 375 GB. - optional string amount = 2 [json_name = "amount"]; - - // The type of hardware resource that you want to specify. You can specify any - // of the following values: - VCPU - MEMORY - LOCAL_SSD - ACCELERATOR Specify - // as a separate entry in the list for each individual resource type. - // ACCELERATOR: - // LOCAL_SSD: - // MEMORY: +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: - // VCPU: - optional string type = 3 [json_name = "type"]; + optional string state = 2 [json_name = "state"]; +} + +// 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_020.proto b/protos/google/cloud/compute/v1/internal/common_020.proto index 690f70427522e..dce2fd83e4641 100644 --- a/protos/google/cloud/compute/v1/internal/common_020.proto +++ b/protos/google/cloud/compute/v1/internal/common_020.proto @@ -15,1034 +15,125 @@ // 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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_029.proto"; -import "google/cloud/compute/v1/internal/common_082.proto"; +import "google/cloud/compute/v1/internal/common_017.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"]; +message BulkSetLabelsRequest { + // 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 may + // optionally 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"]; - // 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 true, unless a variable - // is present in headerValue, in which case 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. Only one of urlRedirect, - // service or routeAction.weightedBackendService can 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. Only one of urlRedirect, service or - // routeAction.weightedBackendService can be set. - optional string service = 6 [json_name = "service"]; - - // When this rule is matched, the request is redirected to a URL specified by - // urlRedirect. Only one of urlRedirect, service or - // routeAction.weightedBackendService can 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. Only one of defaultUrlRedirect, defaultService or - // defaultRouteAction.weightedBackendService can be set. 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. Only one of defaultUrlRedirect, - // defaultService or defaultRouteAction.weightedBackendService can be set. - // 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. Only one of - // defaultUrlRedirect, defaultService or - // defaultRouteAction.weightedBackendService can be set. 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. Only one of urlRedirect, service or - // routeAction.weightedBackendService can 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. Only one of urlRedirect, service or - // routeAction.weightedBackendService can 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. Only one of urlRedirect, service or - // routeAction.weightedBackendService can be set. Not supported when the URL - // map is bound to a target gRPC proxy. - optional HttpRedirectAction url_redirect = 4 [json_name = "urlRedirect"]; + // The labels to set for this resource. + map labels = 2 [json_name = "labels"]; } -// 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, -// 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"]; - - // 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. - // Only one of defaultUrlRedirect, defaultService or - // defaultRouteAction.weightedBackendService can 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. Only one of defaultUrlRedirect, - // defaultService or defaultRouteAction.weightedBackendService can be set. - // 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. Only one of defaultUrlRedirect, - // defaultService or defaultRouteAction.weightedBackendService can 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"]; +message BulkZoneSetLabelsRequest { + repeated BulkSetLabelsRequest requests = 1 [json_name = "requests"]; } -// Contains a list of UrlMap resources. -message UrlMapList { +message DiskAggregatedList { // [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"]; + // A list of DisksScopedList resources. + map items = 2 [json_name = "items"]; - // Type of resource. + // Output only. [Output Only] Type of resource. + // Alwayscompute#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 + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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. + // Output only. [Output Only] Server-defined URL for this resource. optional string self_link = 5 [json_name = "selfLink"]; + // Output only. [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. + // [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. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -1051,19 +142,27 @@ message UrlMapList { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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. @@ -1071,137 +170,179 @@ message UrlMapList { } // [Output Only] Informational warning message. - optional Warning warning = 6 [json_name = "warning"]; + optional Warning warning = 7 [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"]; +message DiskUpdateKmsKeyRequest { + // Optional. The new KMS key to replace the current one on the disk. If empty, + // the disk + // will be re-encrypted using the primary version of the disk's current KMS + // key. + // + // The KMS key can be provided in the following formats: + // + // + // - + // projects/project_id/locations/location/keyRings/key_ring/cryptoKeys/key + // + // + // Where project is the project ID or + // project number. + optional string kms_key_name = 1 [json_name = "kmsKeyName"]; } -// HTTP headers used in UrlMapTests. -message UrlMapTestHeader { - // Header name. - optional string name = 1 [json_name = "name"]; +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"]; +} - // Header value. - optional string value = 2 [json_name = "value"]; +message DisksRemoveResourcePoliciesRequest { + // Resource policies to be removed from this disk. + repeated string resource_policies = 1 [json_name = "resourcePolicies"]; } -// Message representing the validation result for a UrlMap. -message UrlMapValidationResult { - repeated string load_errors = 1 [json_name = "loadErrors"]; +message DisksResizeRequest { + // The new size of the persistent disk, which is specified in GB. + optional string size_gb = 1 [json_name = "sizeGb"]; +} - // Whether the given UrlMap can be successfully loaded. If false, 'loadErrors' - // indicates the reasons. - optional bool load_succeeded = 2 [json_name = "loadSucceeded"]; +message DisksScopedList { + // [Output Only] A list of disks contained in this scope. + repeated Disk disks = 1 [json_name = "disks"]; - repeated TestFailure test_failures = 3 [json_name = "testFailures"]; + 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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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 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 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 UrlMapsValidateResponse { - optional UrlMapValidationResult result = 1 [json_name = "result"]; -} + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } -// 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"]; + // [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"]; - // 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"]; + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } - // 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"]; + // [Output Only] Informational warning which replaces the list of disks when + // the list is empty. + optional Warning warning = 2 [json_name = "warning"]; } -// 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 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_021.proto b/protos/google/cloud/compute/v1/internal/common_021.proto index 1f74c58fb74c7..eabe07a0c114c 100644 --- a/protos/google/cloud/compute/v1/internal/common_021.proto +++ b/protos/google/cloud/compute/v1/internal/common_021.proto @@ -15,75 +15,478 @@ // 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: 20250601 +// revision: 20260807 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"]; +import "google/cloud/compute/v1/internal/common_032.proto"; + +message BundledLocalSsds { + // The default disk interface if the interface is not specified. + optional string default_interface = 1 [json_name = "defaultInterface"]; + + // The number of partitions. + optional int32 partition_count = 2 [json_name = "partitionCount"]; +} + +// Represents a Machine Type resource. +// +// You can use specific machine types for your VM instances based on performance +// and pricing requirements. For more information, readMachine Types. +message MachineType { + reserved 14; + 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] The configuration of bundled local SSD for the machine type. + optional BundledLocalSsds bundled_local_ssds = 18 + [json_name = "bundledLocalSsds"]; + + // [Output Only] Creation timestamp inRFC3339 + // 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. SeeShared-core + // machine + // types for more information. + optional bool is_shared_cpu = 8 [json_name = "isSharedCpu"]; + + // Output only. [Output Only] The type of the resource. + // Alwayscompute#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"]; + + // [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. [Output Only] Type of resource. + // Alwayscompute#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 thanmaxResults, use the + // nextPageToken as a value 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. [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + // Output only. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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"]; } -// 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 - SNP_SVSM_CAPABLE For more - // information, see Enabling guest operating system features. - // BARE_METAL_LINUX_COMPATIBLE: - // FEATURE_TYPE_UNSPECIFIED: - // GVNIC: - // IDPF: - // MULTI_IP_SUBNET: - // SECURE_BOOT: - // SEV_CAPABLE: - // SEV_LIVE_MIGRATABLE: - // SEV_LIVE_MIGRATABLE_V2: - // SEV_SNP_CAPABLE: - // SNP_SVSM_CAPABLE: - // TDX_CAPABLE: - // UEFI_COMPATIBLE: - // VIRTIO_SCSI_MULTIQUEUE: - // WINDOWS: - optional string type = 1 [json_name = "type"]; +// 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. [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 thanmaxResults, use the + // nextPageToken as a value 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. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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_022.proto b/protos/google/cloud/compute/v1/internal/common_022.proto index e74657d17719f..bc848f6165364 100644 --- a/protos/google/cloud/compute/v1/internal/common_022.proto +++ b/protos/google/cloud/compute/v1/internal/common_022.proto @@ -15,405 +15,128 @@ // 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: 20250601 +// revision: 20260807 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_034.proto"; -import "google/cloud/compute/v1/internal/common_039.proto"; -import "google/cloud/compute/v1/internal/common_081.proto"; -import "google/cloud/compute/v1/internal/common_146.proto"; +import "google/cloud/compute/v1/internal/common_023.proto"; -message CustomerEncryptionKeyProtectedDisk { - // Decrypts data associated with the disk with a customer-supplied encryption - // key. - optional CustomerEncryptionKey disk_encryption_key = 1 - [json_name = "diskEncryptionKey"]; +message CacheInvalidationRule { + // A list of cache tags used to identify cached objects. + // + // + // - Cache tags are specified when the response is first cached, by setting + // the `Cache-Tag` response header at the origin. + // - Multiple cache tags in the same invalidation request are treated as + // Boolean `OR` - for example, `tag1 OR tag2 OR tag3`. + // - If other fields are also specified, these are treated as Boolean `AND` + // with any tags. + // + // + // Up to 10 tags can be specified in a single invalidation request. + repeated string cache_tags = 3 [json_name = "cacheTags"]; - // 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"]; -} + // If set, this invalidation rule will only apply to requests with a Host + // header matching host. + optional string host = 1 [json_name = "host"]; -// Array of guest attribute namespace/key/value tuples. -message GuestAttributesValue { - repeated GuestAttributesEntry items = 1 [json_name = "items"]; + optional string path = 2 [json_name = "path"]; } -// 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 - // metadata keys that were explicitly defined for the instance. - 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 { +message UrlMapsAggregatedList { // [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"]; + // A list of UrlMapsScopedList resources. + map items = 2 [json_name = "items"]; - // [Output Only] Type of resource. Always compute#instanceAggregatedList for - // aggregated lists of Instance resources. + // Output only. 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 + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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. + // Output only. [Output Only] Server-defined URL for this resource. optional string self_link = 5 [json_name = "selfLink"]; - // [Output Only] Unreachable resources. + // Output only. [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. + // [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. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -422,19 +145,27 @@ message InstanceAggregatedList { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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. @@ -445,84 +176,78 @@ message InstanceAggregatedList { 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 UrlMapsScopedList { + // A list of UrlMaps contained in this scope. + repeated UrlMap url_maps = 1 [json_name = "urlMaps"]; 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. + // [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. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -531,512 +256,59 @@ message InstanceList { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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] The packet mirroring rules that apply to the instance. - repeated FirewallPolicyRule packet_mirroring_rules = 7 - [json_name = "packetMirroringRules"]; - - // [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 InstancesReportHostAsFaultyRequest { - // The disruption schedule for the VM. Required field, only allows IMMEDIATE. - // DISRUPTION_SCHEDULE_UNSPECIFIED: Not used. Required as per aip/126. - // FUTURE: Delay disruption for caller control. Will be default soon. - // IMMEDIATE: Default value. Disrupt the VM immediately. - optional string disruption_schedule = 1 [json_name = "disruptionSchedule"]; - - repeated InstancesReportHostAsFaultyRequestFaultReason fault_reasons = 2 - [json_name = "faultReasons"]; -} - -message InstancesReportHostAsFaultyRequestFaultReason { - // BEHAVIOR_UNSPECIFIED: Public reportable behaviors - // PERFORMANCE: - // SILENT_DATA_CORRUPTION: - // UNRECOVERABLE_GPU_ERROR: - optional string behavior = 1 [json_name = "behavior"]; - - optional string description = 2 [json_name = "description"]; -} - -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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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. + // Informational warning which replaces the list of + // backend services 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] The precise location of your instance within the zone's data - // center, including the block, sub-block, and host. The field is formatted as - // follows: blockId/subBlockId/hostId. - optional string physical_host = 1 [json_name = "physicalHost"]; - - // [Output Only] A series of fields containing the global name of the Compute - // Engine cluster, as well as the ID of the block, sub-block, and host on - // which the running instance is located. - optional ResourceStatusPhysicalHostTopology physical_host_topology = 4 - [json_name = "physicalHostTopology"]; - - optional ResourceStatusScheduling scheduling = 3 [json_name = "scheduling"]; - - optional UpcomingMaintenance upcoming_maintenance = 2 - [json_name = "upcomingMaintenance"]; -} - -// Represents the physical host topology of the host on which the VM is running. -message ResourceStatusPhysicalHostTopology { - // [Output Only] The ID of the block in which the running instance is located. - // Instances within the same block experience low network latency. - optional string block = 1 [json_name = "block"]; - - // [Output Only] The global name of the Compute Engine cluster where the - // running instance is located. - optional string cluster = 2 [json_name = "cluster"]; - - // [Output Only] The ID of the host on which the running instance is located. - // Instances on the same host experience the lowest possible network latency. - optional string host = 3 [json_name = "host"]; - - // [Output Only] The ID of the sub-block in which the running instance is - // located. Instances in the same sub-block experience lower network latency - // than instances in the same block. - optional string subblock = 4 [json_name = "subblock"]; -} - -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"]; +message UrlMapsValidateRequest { + // Specifies the load balancer type(s) this validation request is for. + // UseEXTERNAL_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_023.proto b/protos/google/cloud/compute/v1/internal/common_023.proto index 7b4ee84b295a1..140b0330afdd1 100644 --- a/protos/google/cloud/compute/v1/internal/common_023.proto +++ b/protos/google/cloud/compute/v1/internal/common_023.proto @@ -15,43 +15,1905 @@ // 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: 20250601 +// revision: 20260807 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_038.proto"; +import "google/cloud/compute/v1/internal/common_097.proto"; + +// Message containing CachePolicy configuration for URL Map's Route Action. +message CachePolicy { + // Bypass the cache when the specified request headers are matched by name, + // e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5 + // header names can be specified. The cache is bypassed for all `cacheMode` + // values. + repeated string cache_bypass_request_header_names = 1 + [json_name = "cacheBypassRequestHeaderNames"]; + + // The cache key configuration. If not specified, the default behavior depends + // on the backend type: for Backend Services, the complete request URI is + // used; for Backend Buckets, the request URI is used without the protocol or + // host, and only query parameters known to Cloud Storage are included. + optional CachePolicyCacheKeyPolicy cache_key_policy = 2 + [json_name = "cacheKeyPolicy"]; + + // Specifies the cache setting for all responses from this route. If not + // specified, Cloud CDN uses `CACHE_ALL_STATIC` mode. + // 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. + // USE_ORIGIN_HEADERS: Requires the origin to set valid caching headers to + // cache content. + // Responses without these headers will not be cached at the 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 for cached + // content. This is used to clamp the max-age (or Expires) value sent to the + // client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl` + // is used for the response max-age directive, along with a "public" + // directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl` + // clamps the max-age from the origin (if specified), or else sets the + // response max-age directive to the lesser of the `clientTtl` and + // `defaultTtl`, and also ensures a "public" cache-control directive is + // present. The maximum allowed value is 31,622,400s (1 year). If not + // specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode. + // Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is + // `USE_ORIGIN_HEADERS`. + optional Duration client_ttl = 4 [json_name = "clientTtl"]; + + // Specifies the default TTL for cached content for responses that do not have + // an existing valid TTL (max-age or s-maxage). Setting a TTL of "0" means + // "always revalidate". The value of `defaultTtl` cannot be set to a value + // greater than that of `maxTtl`. 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). Infrequently + // accessed objects may be evicted from the cache before the defined TTL. If + // not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and + // `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is + // `USE_ORIGIN_HEADERS`. + optional Duration default_ttl = 5 [json_name = "defaultTtl"]; + + // Specifies the maximum allowed TTL for cached content. 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). + // Infrequently accessed objects may be evicted from the cache before the + // defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for + // `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache + // mode. + optional Duration 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 `cacheMode` 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 `cacheMode` is set to + // `FORCE_CACHE_ALL`, negative caching applies to all responses + // with the specified response code, and overrides any caching headers. By + // default, Cloud CDN applies the following TTLs to these HTTP status codes: + // + // * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m + // * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s + // * 405 (Method Not Found), 501 (Not Implemented): 60s + // + // These defaults can be overridden in `negativeCachingPolicy`. + // If not specified, Cloud CDN applies negative caching by default. + optional bool negative_caching = 7 [json_name = "negativeCaching"]; + + // Sets a cache TTL for the specified HTTP status code. + // `negativeCaching` must be enabled to configure `negativeCachingPolicy`. + // Omitting the policy and leaving `negativeCaching` enabled will use Cloud + // CDN's default cache TTLs. Note that when specifying an explicit + // `negativeCachingPolicy`, 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 CachePolicyNegativeCachingPolicy 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. If not specified, + // Cloud CDN applies request coalescing by default. + 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-maxage) of a cached + // response. + // The maximum allowed value is 604800 (1 week). + // Set this to zero (0) to disable serve-while-stale. + optional Duration serve_while_stale = 10 [json_name = "serveWhileStale"]; +} + +// Message containing what to include in the cache key for a request for Cache +// Policy defined on Route Action. +message CachePolicyCacheKeyPolicy { + // Names of query string parameters to exclude in cache keys. All other + // parameters will be included. Either specify `excludedQueryParameters` + // or `includedQueryParameters`, not both. '&' and '=' will be percent + // encoded and not treated as delimiters. + // + // Note: This field applies to routes that use backend services. Attempting + // to set it on a route that points exclusively to Backend Buckets will + // result in a configuration error. For routes that point to a Backend + // Bucket, use `includedQueryParameters` to define which parameters should + // be part of the cache key. + repeated string excluded_query_parameters = 1 + [json_name = "excludedQueryParameters"]; + + // If true, requests to different hosts will be cached separately. + // + // Note: This setting is only applicable to routes that use a Backend + // Service. It does not affect requests served by a Backend Bucket, as the + // host is never included in a Backend Bucket's cache key. Attempting to set + // it on a route that points exclusively to Backend Buckets will result in a + // configuration error. + optional bool include_host = 2 [json_name = "includeHost"]; + + // If true, http and https requests will be cached separately. + // + // Note: This setting is only applicable to routes that use a Backend + // Service. It does not affect requests served by a Backend Bucket, as the + // protocol is never included in a Backend Bucket's cache key. Attempting to + // set on a route that points exclusively to Backend Buckets will result in + // a configuration error. + optional bool include_protocol = 3 [json_name = "includeProtocol"]; + + // If true, include query string parameters in the cache key according to + // `includedQueryParameters` and `excludedQueryParameters`. If neither + // is set, the entire query string will be included. If false, the query + // string will be excluded from the cache key entirely. + // + // Note: This field applies to routes that use backend services. Attempting + // to set it on a route that points exclusively to Backend Buckets will + // result in a configuration error. For routes that point to a Backend + // Bucket, use `includedQueryParameters` to define which parameters should + // be part of the cache key. + optional bool include_query_string = 4 [json_name = "includeQueryString"]; + + // 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. + // + // Note: This setting is only applicable to routes that use a Backend + // Service. It does not affect requests served by a Backend Bucket. + // Attempting to set it on a route that points exclusively to Backend + // Buckets will result in a configuration error. Up to 5 cookie names can be + // specified. + repeated string included_cookie_names = 5 [json_name = "includedCookieNames"]; + + // Allows HTTP request headers (by name) to be used in the cache key. + repeated string included_header_names = 6 [json_name = "includedHeaderNames"]; + + // Names of query string parameters to include in cache keys. All other + // parameters will be excluded. Either specify `includedQueryParameters` + // or `excludedQueryParameters`, not both. '&' and '=' will be percent + // encoded and not treated as delimiters. + repeated string included_query_parameters = 7 + [json_name = "includedQueryParameters"]; +} + +// Specify CDN TTLs for response error codes. +message CachePolicyNegativeCachingPolicy { + // 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 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). Infrequently accessed + // objects may be evicted from the cache before the defined TTL. + optional Duration ttl = 2 [json_name = "ttl"]; +} + +// 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 inallowOrigins or an item + // inallowOriginRegexes. + // + // 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 inallowOrigins or an item + // inallowOriginRegexes. + 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 a401, then the rule for + // 401 will be applied. + // However if the backend service returns a 403, the rule for4xx 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 likepathMatcher, pathRule + // and routeRule, + // an errorService specified at a higher level in theUrlMap will be used. + // IfUrlMap.defaultCustomErrorResponsePolicy contains one or + // moreerrorResponseRules[], it must specifyerrorService. + // + // If load balancer cannot reach + // the backendBucket, a simple Not Found Error will + // be returned, with the original response code (oroverrideResponseCode if + // configured). + // + // errorService is not supported for internal or regionalHTTP/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 + // allerrorResponseRules ofCustomErrorResponsePolicy. + 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 simpleNot 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 namedPathMatcher 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 + // thebackendService. + 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 ofprefixMatch. + // + // 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 + // inregexMatch. + // 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, EXTERNAL_MANAGED + // (regional scope) or INTERNAL_MANAGED. + optional string regex_match = 7 [json_name = "regexMatch"]; + + // The value of the header must end with the contents ofsuffixMatch. + // + // 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 true, + // unless a variable is present in headerValue, + // in which case 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, orregexMatch 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, orregexMatch 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 byregexMatch. For + // more information about regular expression syntax, see Syntax. + // + // Only one of presentMatch, exactMatch, orregexMatch must be set. + // + // Regular expressions can only be used when the loadBalancingScheme is + // set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED + // (regional scope) or INTERNAL_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 inTargetHttpProxys. Setting this + // true forTargetHttpsProxy 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 withprefixRedirect. 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 withpathRedirect. 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 theHttpRouteAction 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 or504. + // - 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 todeadline-exceeded. + // - internal: a retry is attempted if the gRPC + // status code in the response header is set tointernal. + // - resource-exhausted: a retry is attempted if the gRPC + // status code in the response header is set toresource-exhausted. + // - unavailable: a retry is attempted if the gRPC + // status code in the response header is set tounavailable. + // + // 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 { + // Specifies the cache policy configuration for matched traffic. Available + // only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one + // property must be specified. This policy cannot be specified if any target + // backend has Identity-Aware Proxy enabled. + optional CachePolicy cache_policy = 9 [json_name = "cachePolicy"]; + + // 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 maximummaxStreamDuration 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 toINTERNAL_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 oneweightedBackendService + // 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 BackendServiceorBackendBucket + // responds with an error. + // + // If a policy for an + // error code is not configured for the RouteRule, a policy for + // the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is + // applied. If + // one is not specified inpathMatcher.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 a404 is encountered, the + // policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 + // response is encountered for the requestwww.example.com/current_events/, the + // pathMatcher's policy + // takes effect. If however, the request forwww.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 atUrlMap.defaultCustomErrorResponsePolicy takes + // effect. + // + // When + // used in conjunction withrouteRules.routeAction.retryPolicy, retries take + // precedence. Only once all retries are exhausted, + // thecustomErrorResponsePolicy 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 + // afterpathMatchers[].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 thisrouteRule. + // This list has OR semantics: the request matches + // this routeRule when any of thematchRules 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 + // interpretsrouteRules. 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. + // + // + // Only one of urlRedirect, service orrouteAction.weightedBackendService can + // be set. + // + // + // URL maps for classic Application Load Balancers only support + // the urlRewrite action within a route rule'srouteAction. + 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. + // + // + // Only one of urlRedirect, service orrouteAction.weightedBackendService can + // be set. + optional string service = 6 [json_name = "service"]; + + // When this rule is matched, the request is redirected to a URL + // specified by urlRedirect. + // + // + // Only one of urlRedirect, service orrouteAction.weightedBackendService can + // 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 infullPathMatch 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,regexMatch or path_template_match + // 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 itsfilterMatchCriteria is set to + // MATCH_ANY, at least one of thefilterLabels 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 theUrlMap this + // HttpRouteRuleMatch belongs to. + // + // metadataFilters only applies to load balancers that haveloadBalancingScheme + // set toINTERNAL_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, this field defines a path template pattern that must match + // the :path header after the query string is removed. + // + // A path template pattern can include variables and wildcards. + // Variables are enclosed in curly braces, for example{variable_name}. + // Wildcards include * that + // matches a single path segment, and ** that matches zero or + // more path segments. The pattern must follow these rules: + // + // + // - The value must be between 1 and 1024 characters. + // - The pattern must start with a leading slash ("/"). + // - No more than 5 operators (variables or wildcards) may appear in + // the pattern. + // + // Precisely one ofprefixMatch, fullPathMatch,regexMatch, or pathTemplateMatch + // 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. + // + // The * character inside a prefix match is + // treated as a literal character, not as a wildcard. + // + // Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match + // can be + // used within a matchRule. + 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 inregexMatch 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,regexMatch or path_template_match + // must be + // specified. + // + // Regular expressions can only be used when the loadBalancingScheme is + // set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED + // (regional scope) or INTERNAL_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 BackendServiceorBackendBucket + // 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 likeRouteRule + // and PathRule within thisPathMatcher. 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 a404 is encountered, the + // policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 + // response is encountered for the requestwww.example.com/current_events/, the + // pathMatcher's policy + // takes effect. If however, the request forwww.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 atUrlMap.defaultCustomErrorResponsePolicy takes + // effect. + // + // When + // used in conjunction withpathMatcher.defaultRouteAction.retryPolicy, retries + // take + // precedence. Only once all retries are exhausted, + // thedefaultCustomErrorResponsePolicy 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. + // + // + // Only one of defaultUrlRedirect, defaultService + // or defaultRouteAction.weightedBackendService can be set. + // + // + // URL maps for classic Application Load Balancers only support + // the urlRewrite action within a path matcher'sdefaultRouteAction. + 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 orrouteRules 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. + // + // + // Only one of defaultUrlRedirect, defaultService + // or defaultRouteAction.weightedBackendService can be set. + // + // + // 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 orrouteRules match, the request is + // redirected to a URL specified + // by defaultUrlRedirect. + // + // + // Only one of defaultUrlRedirect, defaultService + // or defaultRouteAction.weightedBackendService can be set. + // + // + // 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 matchingHttpRouteRule + // HeaderAction and before theHeaderAction 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 theHostRule. + 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. A path + // rule can only include a wildcard character (*) after a + // forward slash character ("/"). + // + // 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 ofpathRules or routeRules must be set. + repeated PathRule path_rules = 7 [json_name = "pathRules"]; + + // The list of HTTP route rules. Use this list instead ofpathRules 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 ofpathRules or routeRules. + repeated HttpRouteRule route_rules = 8 [json_name = "routeRules"]; +} + +// A path-matching rule for a URL. If matched, will use the +// specifiedBackendService to handle the traffic arriving at this URL. +message PathRule { + // customErrorResponsePolicy specifies how the Load + // Balancer returns error responses when BackendServiceorBackendBucket + // responds with an error. + // + // If a policy for an + // error code is not configured for the PathRule, a policy for + // the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is + // applied. If + // one is not specified inpathMatcher.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 a404 is encountered, the + // policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 + // response is encountered for the requestwww.example.com/current_events/, the + // pathMatcher's policy + // takes effect. If however, the request forwww.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 atUrlMap.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. + // + // + // Only one of urlRedirect, service orrouteAction.weightedBackendService can + // be set. + // + // + // URL maps for classic Application Load Balancers only support + // the urlRewrite action within a path rule'srouteAction. + 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. + // + // + // Only one of urlRedirect, service orrouteAction.weightedBackendService can + // 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. + // + // + // Only one of urlRedirect, service orrouteAction.weightedBackendService can + // be set. + // + // + // Not supported when the URL map is bound to a target gRPC proxy. + optional HttpRedirectAction url_redirect = 4 [json_name = "urlRedirect"]; +} + +// The spec for modifying the path using a regular expression. +message RegexRewrite { + // Required. The regular expression used to match against the URL path. + // It uses RE2 syntax with the following constraints: + // + // + // - Any single character operators + // - Groups are allowed to have only submatch operator inside + // - Groups are allowed only without any char repetition, e.g. + // .* + // - Any char repetition, e.g. .*, is + // only allowed to be used in a single regex together with: + // + // + // - Empty string operators + // - Other repetitions + // - Ranges + // - Repetitions of ranges + // + // + // - Ranges are only allowed to have: + // + // + // - Character range + // - Digits range + // - Symbols listed in characters allowed for ranges + optional string path_pattern = 1 [json_name = "pathPattern"]; + + // Required. Required when path pattern is specified. Used to rewrite matching + // parts of + // the path. + optional string path_substitution = 2 [json_name = "pathSubstitution"]; +} + +// 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"]; + + // The percentage of requests to be mirrored to `backend_service`. + optional double mirror_percent = 2 [json_name = "mirrorPercent"]; +} + +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](https://cloud.google.com/compute/docs/reference/rest/v1/urlMaps) +// * +// [Regional](https://cloud.google.com/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 +// aloadBalancingScheme of INTERNAL_MANAGED. For more +// information, read URL +// Map Concepts. +message UrlMap { + // Output only. [Output Only] Creation timestamp inRFC3339 + // text format. + optional string creation_timestamp = 1 [json_name = "creationTimestamp"]; + + // defaultCustomErrorResponsePolicy specifies how the Load + // Balancer returns error responses when BackendServiceorBackendBucket + // 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 a404, the policy + // inpathMatcher.defaultCustomErrorResponsePolicy will be enforced. + // When the request for http://www.example.com/ encounters a502, the policy + // inUrlMap.defaultCustomErrorResponsePolicy will be enforced. When + // a request that does not match any host in *.example.com such + // as http://www.myotherexample.com/, encounters a404, + // UrlMap.defaultCustomErrorResponsePolicy + // takes effect. + // + // When used in conjunction withdefaultRouteAction.retryPolicy, retries take + // precedence. Only + // once all retries are exhausted, thedefaultCustomErrorResponsePolicy 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. + // + // + // Only one of defaultUrlRedirect, defaultService + // or defaultRouteAction.weightedBackendService can 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. + // + // + // Only one of defaultUrlRedirect, defaultService + // or defaultRouteAction.weightedBackendService can be set. + // + // + // 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. + // + // + // Only one of defaultUrlRedirect, defaultService + // or defaultRouteAction.weightedBackendService can 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 afterheaderAction 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. [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 withRFC1035. + // 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. [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 theUrlMap + // 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"]; + + // Output only. 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 thanmaxResults, use the + // nextPageToken as a value 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. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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 + // whenexpectedOutputUrl matches the request forwarded by + // the load balancer to backends. For rules with urlRewrite, + // the test verifies that the forwarded request matcheshostRewrite and + // pathPrefixRewrite in theurlRewrite action. When service is + // specified,expectedOutputUrl`s scheme is ignored. + // + // For rules with urlRedirect, the test passes only ifexpectedOutputUrl + // matches the URL in the load balancer's + // redirect response. If urlRedirect specifieshttps_redirect, the test passes + // only if the scheme inexpectedOutputUrl 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 whenservice is specified. + optional string expected_output_url = 2 [json_name = "expectedOutputUrl"]; + + // For rules with urlRedirect, the test passes only + // ifexpectedRedirectResponseCode matches the HTTP status code in + // load balancer's redirect response. + // + // expectedRedirectResponseCode cannot be set whenservice 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 bypathPrefixRewrite. + // + // 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 orpath_template_rewrite may be specified. + optional string path_template_rewrite = 3 [json_name = "pathTemplateRewrite"]; + + // The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, + // pathTemplateRewrite, orregexRewrite may be specified. + optional RegexRewrite regex_rewrite = 4 [json_name = "regexRewrite"]; +} + +// 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 + // thisbackendServiceWeight. + 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 beforeheaderAction 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 asweight / (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_024.proto b/protos/google/cloud/compute/v1/internal/common_024.proto index 0d96caf943174..87fa7326806a1 100644 --- a/protos/google/cloud/compute/v1/internal/common_024.proto +++ b/protos/google/cloud/compute/v1/internal/common_024.proto @@ -15,236 +15,214 @@ // 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: 20250601 +// revision: 20260807 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"]; +// A request to recommend the best way to consume the specified resources in the +// future. +message CalendarModeAdviceRequest { + // Specification of resources to create in the future. + // The key of the map is an arbitrary string specified by the caller. + // Value of the map is a specification of required resources and their + // constraints. Currently only one value is allowed in this map. + map future_resources_specs = 1 + [json_name = "futureResourcesSpecs"]; } -// 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"]; +// A response containing the recommended way of creating the specified resources +// in the future. It contains (will contain) multiple recommendations that can +// be analyzed by the customer and the best one can be picked. +message CalendarModeAdviceResponse { + // Recommendations where, how and when to create the requested resources + // in order to maximize their obtainability and minimize cost. + repeated CalendarModeRecommendation recommendations = 1 + [json_name = "recommendations"]; } -// 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 InstanceTemplate resources. - repeated InstanceTemplate items = 2 [json_name = "items"]; - - // [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 - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value 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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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 single recommendation to create requested resources. Contains detailed +// recommendations for every future resources specification specified in +// CalendarModeAdviceRequest. +message CalendarModeRecommendation { + // Recommendations for every future resource specification passed in + // CalendarModeAdviceRequest. Keys of the map correspond to keys + // specified in the request. + map recommendations_per_spec = 1 + [json_name = "recommendationsPerSpec"]; } -// 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"]; +// Specifies a flexible time range with flexible start time and duration. +// +// It is possible to specify a contradictory time range that cannot be matched +// by any Interval. This causes a validation error. +message FlexibleTimeRange { + optional string max_duration = 1 [json_name = "maxDuration"]; + + optional string min_duration = 2 [json_name = "minDuration"]; + + optional string start_time_not_earlier_than = 3 + [json_name = "startTimeNotEarlierThan"]; + + optional string start_time_not_later_than = 4 + [json_name = "startTimeNotLaterThan"]; +} + +// Recommendation for single resources specification, to be created in the +// future. +message FutureResourcesRecommendation { + optional string end_time = 1 [json_name = "endTime"]; + + // The advised location for resource usage. When a zone, in format + // 'zones/'. + // If not set, it means that no location is recommended - see + // other_locations for details. + optional string location = 2 [json_name = "location"]; + + // List of locations in the request scope that were not + // recommended. Keys of the map are zones, in format 'zones/'. + // The values are status information indicating the recommendation status. + map other_locations = 3 + [json_name = "otherLocations"]; + + // Unique id of the recommendation, a UUID string generated by the API. + optional string recommendation_id = 4 [json_name = "recommendationId"]; + + // Type of recommendation. Currently only FUTURE_RESERVATION is supported. + // FUTURE_RESERVATION: A Future Reservation is recommended. + // RECOMMENDATION_TYPE_UNSPECIFIED: Default value, unused. + optional string recommendation_type = 5 [json_name = "recommendationType"]; + + optional string start_time = 6 [json_name = "startTime"]; +} + +// Information about recommendation status for locations +// that were allowed but not used by the response. +message FutureResourcesRecommendationOtherLocation { + // Details (human readable) describing the situation. + // For example, if status is CONDITION_NOT_MET, then + // details contain information about the parameters of the time window + // that did not meet the required conditions. + optional string details = 1 [json_name = "details"]; + + // Status of recommendation in this location. + // CONDITIONS_NOT_MET: The requested resources are offered in this location + // but the requested time window is does not meet the required conditions. + // NOT_SUPPORTED: The requested resources are not offered in this location. + // Retrying the request will not change this status. + // NO_CAPACITY: The requested resources are offered in this location + // and the requested time window is accepted + // but there is no capacity within the requested time window. + // OTHER_LOCATION_STATUS_UNDEFINED: Default value, unused. + // RECOMMENDED: The requested resources are offered in this location + // and it is possible to request them. However, another location + // was better and was recommended. + optional string status = 2 [json_name = "status"]; +} + +// Specification of resources to be created at some time in the future within an +// optionally specified set of locations, and within the specified time range. +message FutureResourcesSpec { + // Indicates if the reservation allocation strategy is static (DENSE) or + // dynamic (STANDARD). Defaults to DENSE. + // DENSE: The reserved capacity is made up of densely deployed reservation + // blocks. + // DEPLOYMENT_TYPE_UNSPECIFIED: + optional string deployment_type = 1 [json_name = "deploymentType"]; + + // Optional location policy allowing to exclude some zone(s) in which + // the resources must not be created. + optional FutureResourcesSpecLocationPolicy location_policy = 2 + [json_name = "locationPolicy"]; + + // Specification of the reserved resources. + optional FutureResourcesSpecTargetResources target_resources = 3 + [json_name = "targetResources"]; + + // Specification of a time range in which the resources may be created. + // The time range specifies start of resource use and planned end of resource + // use. + optional FlexibleTimeRange time_range_spec = 4 [json_name = "timeRangeSpec"]; +} + +message FutureResourcesSpecAggregateResources { + // Size of the request, in accelerator (chip) count. + optional string accelerator_count = 1 [json_name = "acceleratorCount"]; + + // The VM family that all instances scheduled against this reservation + // must belong to. Use for TPU reservations. + // 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_LITE_POD_SLICE_CT6E: + // VM_FAMILY_CLOUD_TPU_POD_SLICE_CT3P: + // VM_FAMILY_CLOUD_TPU_POD_SLICE_CT4P: + // VM_FAMILY_CLOUD_TPU_POD_SLICE_CT5P: + // VM_FAMILY_CLOUD_TPU_POD_SLICE_TPU7X: + optional string vm_family = 2 [json_name = "vmFamily"]; + + // Workload type. Use for TPU reservations. + // BATCH: Reserved resources will be optimized for BATCH workloads, such as ML + // training. + // SERVING: Reserved resources will be optimized for SERVING workloads, such + // as ML + // inference. + // UNSPECIFIED: + optional string workload_type = 3 [json_name = "workloadType"]; +} + +message FutureResourcesSpecLocalSsdPartition { + // Disk interface. Defaults to SCSI. + // NVME: + // SCSI: + optional string disk_interface = 1 [json_name = "diskInterface"]; + + // The size of the disk in GB. + optional string disk_size_gb = 2 [json_name = "diskSizeGb"]; +} + +// Specification of locations to create resources in. +message FutureResourcesSpecLocationPolicy { + // Preferences for specified locations. + // Keys of the map are locations - zones, in format of 'zones/'. + // Values are preferences for the zones. + // If a zone is not specified in this map, it is ALLOWed. + map locations = 1 + [json_name = "locations"]; +} + +// Preference for a single specified location. +message FutureResourcesSpecLocationPolicyLocation { + // Preference for this location. + // ALLOW: Location is allowed for use. + // DENY: Location is prohibited. + // PREFERENCE_UNSPECIFIED: Default value, unused. + optional string preference = 1 [json_name = "preference"]; +} + +message FutureResourcesSpecSpecificSKUResources { + // Size of the request, in instance count. + optional string instance_count = 1 [json_name = "instanceCount"]; + + // Local SSD partitions. You do not have to include SSD partitions that + // are built in the machine type. + repeated FutureResourcesSpecLocalSsdPartition local_ssd_partitions = 2 + [json_name = "localSsdPartitions"]; + + // The machine type to use for instances that will use the reservation. + // This field only accepts machine type names. e.g. n2-standard-4 + // and does not accept machine type full or partial url. e.g. + // projects/my-l7ilb-project/zones/us-central1-a/machineTypes/n2-standard-4. + // Use for GPU reservations. + optional string machine_type = 3 [json_name = "machineType"]; +} + +// Specification of reserved resources. +message FutureResourcesSpecTargetResources { + optional FutureResourcesSpecAggregateResources aggregate_resources = 1 + [json_name = "aggregateResources"]; + + optional FutureResourcesSpecSpecificSKUResources specific_sku_resources = 2 + [json_name = "specificSkuResources"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_025.proto b/protos/google/cloud/compute/v1/internal/common_025.proto index 9a444e9f23481..29d72ca63b961 100644 --- a/protos/google/cloud/compute/v1/internal/common_025.proto +++ b/protos/google/cloud/compute/v1/internal/common_025.proto @@ -15,276 +15,462 @@ // 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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_081.proto"; -import "google/cloud/compute/v1/internal/common_098.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"]; -} +import "google/cloud/compute/v1/internal/common_008.proto"; -// 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"]; - - // An optional list of 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"]; - - // An optional 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 a regional resource-based commitment resource. +// +// Creating this commitment resource means that you are purchasing a +// resource-based committed use contract, with an explicit start and end time. +// You can purchase resource-based commitments for both hardware and software +// resources. For more information, read +// Resource-based committed use discounts +message Commitment { + // Specifies whether to automatically renew the commitment at the end of its + // current term. The default value is false. If you set the field + // to true, each time your commitment reaches the end of its + // term, Compute Engine automatically renews it for another term. You can + // update this field anytime before the commitment expires. For example, if + // the commitment is set to expire at 12 AM UTC-8 on January 3, 2027, you can + // update this field until 11:59 PM UTC-8 on January 2, 2027. + optional bool auto_renew = 1 [json_name = "autoRenew"]; + + // The category of the commitment; specifies whether the commitment is for + // hardware or software resources. Category MACHINE specifies + // that you are committing to hardware machine resources such asVCPU or + // MEMORY, listed in resources. + // Category LICENSE specifies that you are committing to software + // licenses, listed in licenseResources. + // Note that if you specify MACHINE commitments, then you must + // also specify a type to indicate the machine series of the + // hardware resource that you are committing to. + // CATEGORY_UNSPECIFIED: + // LICENSE: + // MACHINE: + optional string category = 2 [json_name = "category"]; + + // Output only. [Output Only] Creation timestamp inRFC3339 + // text format. + optional string creation_timestamp = 3 [json_name = "creationTimestamp"]; + + // [Input Only] Optional, specifies the requested commitment end time + // inRFC3339 text format. Use this option when the desired + // commitment's end date is later than the start date + term duration. + optional string custom_end_timestamp = 22 [json_name = "customEndTimestamp"]; + + // An optional description of the commitment. You can provide this property + // when you create the resource. + optional string description = 4 [json_name = "description"]; + + // Output only. [Output Only] Commitment end time inRFC3339 + // text format. + optional string end_timestamp = 5 [json_name = "endTimestamp"]; + + repeated string existing_reservations = 21 + [json_name = "existingReservations"]; + + // Output only. [Output Only] The unique identifier for the resource. This + // identifier is + // defined by the server. + optional string id = 6 [json_name = "id"]; + + // Output only. [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"]; + + // The list of source commitments that you are merging to create the new + // merged commitment. For more information, see + // Merging commitments. + repeated string merge_source_commitments = 9 + [json_name = "mergeSourceCommitments"]; + + // Name of the commitment. You must specify a name when you purchase the + // commitment. The name must be 1-63 characters long, and comply withRFC1035. + // 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"]; + + // Input only. Additional params passed with the request, but not persisted + // as part of resource payload. + optional CommitmentParams params = 24 [json_name = "params"]; + + // The minimum time duration that you commit to purchasing resources. + // The plan that you choose determines the preset term length of the + // commitment (which is 1 year or 3 years) and affects the discount rate that + // you receive for your resources. Committing to a longer time duration + // typically gives you a higher discount rate. The supported values for this + // field are TWELVE_MONTH (1 year), andTHIRTY_SIX_MONTH (3 years). + // INVALID: + // THIRTY_SIX_MONTH: + // TWELVE_MONTH: + optional string plan = 11 [json_name = "plan"]; + + // Output only. [Output Only] URL of the region where the commitment and + // committed + // resources are located. + optional string region = 12 [json_name = "region"]; + + // The list of new reservations that you want to create and attach to this + // commitment. + // + // You must attach reservations to your commitment if your commitment + // specifies any GPUs or Local SSD disks. For more information, see + // Attach reservations to resource-based commitments. + // + // Specify this property only if you want to create new + // reservations to attach. To attach existing reservations, specify + // theexistingReservations property instead. + repeated Reservation reservations = 13 [json_name = "reservations"]; + + // Output only. [Output Only] Status information for Commitment resource. + optional CommitmentResourceStatus resource_status = 23 + [json_name = "resourceStatus"]; + + // The list of all the hardware resources, with their types and amounts, that + // you want to commit to. Specify as a separate entry in the list for each + // individual resource type. + repeated ResourceCommitment resources = 14 [json_name = "resources"]; + + // Output only. [Output Only] Server-defined URL for the resource. + optional string self_link = 15 [json_name = "selfLink"]; + + // The source commitment from which you are transferring resources to create + // the new split commitment. For more information, see + // Split commitments. + optional string split_source_commitment = 16 + [json_name = "splitSourceCommitment"]; + + // Output only. [Output Only] Commitment start time inRFC3339 + // text format. + optional string start_timestamp = 17 [json_name = "startTimestamp"]; + + // Output only. [Output Only] Status of the commitment with regards to + // eventual expiration + // (each commitment has an end date defined). Status can be one of the + // following values: NOT_YET_ACTIVE, ACTIVE, orEXPIRED. + // 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. [Output Only] An optional, human-readable explanation of the + // status. + optional string status_message = 19 [json_name = "statusMessage"]; + + // The type of commitment; specifies the + // machine series for which you want to commit to purchasing resources. + // The choice of machine series affects the discount rate and the eligible + // resource types. + // + // The type must be one of the following: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, + // GRAPHICS_OPTIMIZED_G4,GRAPHICS_OPTIMIZED_G4_VGPU,MEMORY_OPTIMIZED, + // MEMORY_OPTIMIZED_M3,MEMORY_OPTIMIZED_X4, STORAGE_OPTIMIZED_Z3. For + // example, type MEMORY_OPTIMIZED specifies a commitment that + // applies only to eligible resources of memory optimized M1 and M2 machine + // series. Type GENERAL_PURPOSE specifies a commitment that + // applies only to eligible resources of general purpose N1 machine series. + // ACCELERATOR_OPTIMIZED: + // ACCELERATOR_OPTIMIZED_A3: + // ACCELERATOR_OPTIMIZED_A3_MEGA: + // ACCELERATOR_OPTIMIZED_A3_ULTRA: + // ACCELERATOR_OPTIMIZED_A4: + // COMPUTE_OPTIMIZED: + // COMPUTE_OPTIMIZED_C2D: + // COMPUTE_OPTIMIZED_C3: + // COMPUTE_OPTIMIZED_C3D: + // COMPUTE_OPTIMIZED_H3: + // COMPUTE_OPTIMIZED_H4D: + // GENERAL_PURPOSE: + // GENERAL_PURPOSE_C4: + // GENERAL_PURPOSE_C4A: + // GENERAL_PURPOSE_C4D: + // GENERAL_PURPOSE_E2: + // GENERAL_PURPOSE_N2: + // GENERAL_PURPOSE_N2D: + // GENERAL_PURPOSE_N4: + // GENERAL_PURPOSE_N4A: + // GENERAL_PURPOSE_N4D: + // GENERAL_PURPOSE_T2D: + // GRAPHICS_OPTIMIZED: + // GRAPHICS_OPTIMIZED_G4: + // GRAPHICS_OPTIMIZED_G4_VGPU: + // MEMORY_OPTIMIZED: + // MEMORY_OPTIMIZED_M3: + // MEMORY_OPTIMIZED_M4: + // MEMORY_OPTIMIZED_M4_6TB: + // MEMORY_OPTIMIZED_X4_1440_24T: CUD bucket for X4 machine with 1440 vCPUs and + // 24TB of memory. + // MEMORY_OPTIMIZED_X4_16TB: + // MEMORY_OPTIMIZED_X4_1920_32T: CUD bucket for X4 machine with 1920 vCPUs and + // 32TB of memory. + // MEMORY_OPTIMIZED_X4_24TB: + // MEMORY_OPTIMIZED_X4_32TB: + // MEMORY_OPTIMIZED_X4_480_6T: CUD bucket for X4 machine with 480 vCPUs and + // 6TB of memory. + // MEMORY_OPTIMIZED_X4_480_8T: CUD bucket for X4 machine with 480 vCPUs and + // 8TB of memory. + // MEMORY_OPTIMIZED_X4_960_12T: CUD bucket for X4 machine with 960 vCPUs and + // 12TB of memory. + // MEMORY_OPTIMIZED_X4_960_16T: CUD bucket for X4 machine with 960 vCPUs and + // 16TB of memory. + // NETWORK_OPTIMIZED_C4N: CUD bucket for C4N (dual Diorite) machines. + // NETWORK_OPTIMIZED_U4C: CUD bucket for NETWORK_OPTIMIZED_U4C machines. + // NETWORK_OPTIMIZED_U4P: CUD bucket for NETWORK_OPTIMIZED_U4P machines. + // NETWORK_OPTIMIZED_U4S: CUD bucket for NETWORK_OPTIMIZED_U4S machines. + // STORAGE_OPTIMIZED_Z3: + // TYPE_UNSPECIFIED: Note for internal users: When adding a new enum Type for + // v1, make sure + // to also add it in the comment for the `optional Type type` definition. + // This ensures that the public documentation displays the new enum Type. + optional string type = 20 [json_name = "type"]; } -message ProjectsDisableXpnResourceRequest { - // Service resource (a.k.a service project) ID. - optional XpnResourceId xpn_resource = 1 [json_name = "xpnResource"]; -} +message CommitmentAggregatedList { + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 1 [json_name = "id"]; -message ProjectsEnableXpnResourceRequest { - // Service resource (a.k.a service project) ID. - optional XpnResourceId xpn_resource = 1 [json_name = "xpnResource"]; -} + // A list of CommitmentsScopedList resources. + map items = 2 [json_name = "items"]; -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. [Output Only] Type of resource. + // Alwayscompute#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 - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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"]; + optional string next_page_token = 4 [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"]; -} + // Output only. [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; -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"]; -} + // Output only. [Output Only] Unreachable resources. + repeated string unreachables = 6 [json_name = "unreachables"]; -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 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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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 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"]; -} + 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 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"]; + // [Output Only] Informational warning message. + optional Warning warning = 7 [json_name = "warning"]; } -message XpnHostList { +// 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"]; - // [Output Only] A list of shared VPC host project URLs. - repeated Project items = 2 [json_name = "items"]; + // A list of Commitment resources. + repeated Commitment items = 2 [json_name = "items"]; - // [Output Only] Type of resource. Always compute#xpnHostList for lists of - // shared VPC hosts. + // Output only. [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 + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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. + // Output only. [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. + // [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. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -293,19 +479,27 @@ message XpnHostList { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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. @@ -316,15 +510,189 @@ message XpnHostList { optional Warning warning = 6 [json_name = "warning"]; } -// 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"]; +// Additional commitment params. +message CommitmentParams { + // Input only. Resource manager tags to be bound to the commitment. Tag keys + // and + // values have the same definition as resource + // manager tags. Keys and values can be either in numeric format, + // such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in + // namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and + // `{tag_value_short_name}`. The field is ignored (both PUT & + // PATCH) when empty. + map resource_manager_tags = 1 + [json_name = "resourceManagerTags"]; +} + +// [Output Only] Contains output only fields. +message CommitmentResourceStatus { + // Output only. [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] The 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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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"]; +} + +// Commitment for a particular license resource. +message LicenseResourceCommitment { + // The number of licenses you plan to purchase. + optional string amount = 1 [json_name = "amount"]; + + // The number of cores per license. + optional string cores_per_license = 2 [json_name = "coresPerLicense"]; + + // The applicable license URI. + optional string license = 3 [json_name = "license"]; +} - // The type of the service resource. - // PROJECT: - // XPN_RESOURCE_TYPE_UNSPECIFIED: - optional string type = 2 [json_name = "type"]; +// Commitment for a particular hardware resource (a commitment is composed of +// one or more of these). +message ResourceCommitment { + // Name of the accelerator type or GPU resource. Specify this field only when + // the type of hardware resource is ACCELERATOR. + optional string accelerator_type = 1 [json_name = "acceleratorType"]; + + // The quantity of the hardware resource that you want to commit to purchasing + // (in a type-dependent unit). + // + // - For vCPUs, you must specify an integer value. + // - For memory, you specify the amount of MB that you want. The value you + // specify must be a multiple of 256 MB, with up to 6.5 GB of + // memory per every vCPU. + // - For GPUs, you must specify an integer value. + // - For Local SSD disks, you must specify the amount in GB. The size of a + // single Local SSD disk is 375 GB. + optional string amount = 2 [json_name = "amount"]; + + // The type of hardware resource that you want to specify. + // You can specify any of the following values: + // + // - VCPU + // - MEMORY + // - LOCAL_SSD + // - ACCELERATOR + // + // + // + // Specify as a separate entry in the list for each + // individual resource type. + // ACCELERATOR: + // LOCAL_SSD: + // MEMORY: + // UNSPECIFIED: + // VCPU: + optional string type = 3 [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 9a39c68ed29d9..d09a374bbb266 100644 --- a/protos/google/cloud/compute/v1/internal/common_026.proto +++ b/protos/google/cloud/compute/v1/internal/common_026.proto @@ -15,59 +15,481 @@ // 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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_023.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. +// Represents a composite health check. +// +// A composite health check resource specifies the health source resources and +// the health destination resource to which the aggregated health result from +// the health source resources is delivered. +message CompositeHealthCheck { + // Output only. [Output Only] Creation timestamp inRFC3339 + // text format. optional string creation_timestamp = 1 [json_name = "creationTimestamp"]; - // [Output Only] Server-defined default disk size in GB. - optional string default_disk_size_gb = 2 [json_name = "defaultDiskSizeGb"]; + // 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 CompositeHealthCheck. An up-to-date fingerprint + // must be provided in order to patch the CompositeHealthCheck; Otherwise, + // the request will fail with error 412 conditionNotMet. To see + // the latest fingerprint, make a get() request to retrieve the + // CompositeHealthCheck. + optional string fingerprint = 3 [json_name = "fingerprint"]; + + // URL to the destination resource. Must be set. Must be aForwardingRule. The + // ForwardingRule must have + // load balancing scheme INTERNAL orINTERNAL_MANAGED and must be regional and + // in the same region + // as the CompositeHealthCheck (cross-region deployment forINTERNAL_MANAGED is + // not supported). Can be mutated. + optional string health_destination = 4 [json_name = "healthDestination"]; + + // URLs to the HealthSource resources whose results are AND'ed. + // I.e. he aggregated result is is HEALTHY only if all sources + // are HEALTHY. Must have at least 1. Must not have more than 10. + // Must be regional and in the same region as theCompositeHealthCheck. Can be + // mutated. + repeated string health_sources = 5 [json_name = "healthSources"]; + + // Output only. [Output Only] A unique identifier for this resource type. The + // server + // generates this identifier. + optional string id = 6 [json_name = "id"]; + + // Output only. [Output Only] Type of the resource. + // Alwayscompute#compositeHealthCheck for composite 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 withRFC1035. + // 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. [Output Only] URL of the region where the composite health + // check 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 = 9 [json_name = "region"]; + + // Output only. [Output Only] Server-defined URL for the resource. + optional string self_link = 10 [json_name = "selfLink"]; + + // Output only. [Output Only] Server-defined URL with id for the resource. + optional string self_link_with_id = 11 [json_name = "selfLinkWithId"]; +} + +// Contains a list of CompositeHealthChecksScopedList. +message CompositeHealthCheckAggregatedList { + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 1 [json_name = "id"]; + + // A list of CompositeHealthChecksScopedList resources. + map items = 2 [json_name = "items"]; + + // Output only. 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 thanmaxResults, use the + // nextPageToken as a value 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. [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + // Output only. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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] The deprecation status associated with this disk type. - optional DeprecationStatus deprecated = 3 [json_name = "deprecated"]; + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } - // [Output Only] An optional description of this resource. - optional string description = 4 [json_name = "description"]; + // [Output Only] Informational warning message. + optional Warning warning = 7 [json_name = "warning"]; +} + +// Response message for RegionCompositeHealthChecks.GetHealth +message CompositeHealthCheckHealth { + // Health sources and their corresponding health states. + repeated CompositeHealthChecksGetHealthResponseHealthSourceHealth + health_sources = 1 [json_name = "healthSources"]; + + // Health state of the CompositeHealthCheck. + // HEALTHY: + // UNHEALTHY: + // UNKNOWN: + optional string health_state = 2 [json_name = "healthState"]; + + // Output only. [Output Only] Type of resource. + // Alwayscompute#compositeHealthCheckHealth for the health of + // composite health checks. + optional string kind = 3 [json_name = "kind"]; +} + +message CompositeHealthCheckList { + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 1 [json_name = "id"]; + + // A list of CompositeHealthCheck resources. + repeated CompositeHealthCheck items = 2 [json_name = "items"]; + + // Output only. [Output Only] Type of the resource. + // Alwayscompute#compositeHealthCheck for composite health checks. + 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 thanmaxResults, use the + // nextPageToken as a value 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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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 CompositeHealthChecksGetHealthResponseHealthSourceHealth { + // Health state of the associated HealthSource resource. + // HEALTHY: + // UNHEALTHY: + // UNKNOWN: + optional string health_state = 1 [json_name = "healthState"]; + + // Fully qualified URL of the associated HealthSource resource. + optional string source = 2 [json_name = "source"]; +} - // [Output Only] The unique identifier for the resource. This identifier is - // defined by the server. - optional string id = 5 [json_name = "id"]; +message CompositeHealthChecksScopedList { + // A list of CompositeHealthChecks contained in this scope. + repeated CompositeHealthCheck composite_health_checks = 1 + [json_name = "compositeHealthChecks"]; - // [Output Only] Type of the resource. Always compute#diskType for disk types. - optional string kind = 6 [json_name = "kind"]; + 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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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] Name of the resource. - optional string name = 7 [json_name = "name"]; + 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] 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] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } - // [Output Only] Server-defined URL for the resource. - optional string self_link = 9 [json_name = "selfLink"]; + // [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] An optional textual description of the valid disk size, such - // as "10GB-10TB". - optional string valid_disk_size = 10 [json_name = "validDiskSize"]; + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } - // [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"]; + // Informational warning which replaces the list of composite health checks + // when the list is empty. + optional Warning warning = 2 [json_name = "warning"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_027.proto b/protos/google/cloud/compute/v1/internal/common_027.proto index 85dfa5f4a68bc..0f73867c7b39c 100644 --- a/protos/google/cloud/compute/v1/internal/common_027.proto +++ b/protos/google/cloud/compute/v1/internal/common_027.proto @@ -15,292 +15,143 @@ // 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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_026.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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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"]; +// A resource that represents a cross-site network. +// +// You can use cross-site networks to connect your on-premises networks to +// each other through Interconnect connections. +message CrossSiteNetwork { + // Output only. [Output Only] Creation timestamp inRFC3339 + // text format. + optional string creation_timestamp = 1 [json_name = "creationTimestamp"]; + + // An optional description of the cross-site network. + optional string description = 2 [json_name = "description"]; + + // Output only. [Output Only] The unique identifier for the resource type. The + // server + // generates this identifier. + optional string id = 3 [json_name = "id"]; + + // Output only. [Output Only] Type of the resource. + // Alwayscompute#crossSiteNetwork for cross-site networks. + 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 withRFC1035. + // 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"]; + + // Output only. [Output Only] Server-defined URL for the resource. + optional string self_link = 6 [json_name = "selfLink"]; } -// Contains a list of disk types. -message DiskTypeList { +// Response to the list request that contains a list of cross-site networks. +message CrossSiteNetworkList { + 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 DiskType resources. - repeated DiskType items = 2 [json_name = "items"]; + // A list of CrossSiteNetwork resources. + repeated CrossSiteNetwork items = 3 [json_name = "items"]; - // [Output Only] Type of resource. Always compute#diskTypeList for disk types. - optional string kind = 3 [json_name = "kind"]; + // Output only. [Output Only] Type of the resource. + // Alwayscompute#crossSiteNetwork for cross-site networks. + 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 + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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"]; - - 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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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 string self_link = 6 [json_name = "selfLink"]; - 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"]; + // Output only. [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. + // [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. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -309,26 +160,33 @@ message DiskTypesScopedList { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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"]; + // [Output Only] Informational warning message. + optional Warning warning = 8 [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 da0f8be0120e8..72c66188c2a56 100644 --- a/protos/google/cloud/compute/v1/internal/common_028.proto +++ b/protos/google/cloud/compute/v1/internal/common_028.proto @@ -15,968 +15,115 @@ // 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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -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_083.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"]; - - // 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"]; - - // Resource policies for this managed instance group. - optional InstanceGroupManagerResourcePolicies resource_policies = 32 - [json_name = "resourcePolicies"]; - - // [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"]; - - // Standby policy for stopped and suspended instances. - optional InstanceGroupManagerStandbyPolicy standby_policy = 29 - [json_name = "standbyPolicy"]; - - // 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 target number of stopped instances for this managed instance group. - // This number changes when you: - Stop instance using the stopInstances - // method or start instances using the startInstances method. - Manually - // change the targetStoppedSize using the update method. - optional int32 target_stopped_size = 30 [json_name = "targetStoppedSize"]; - - // The target number of suspended instances for this managed instance group. - // This number changes when you: - Suspend instance using the suspendInstances - // method or resume instances using the resumeInstances method. - Manually - // change the targetSuspendedSize using the update method. - optional int32 target_suspended_size = 31 [json_name = "targetSuspendedSize"]; - - // 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 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 InstanceGroupManagerResourcePolicies { - // The URL of the workload policy that is specified for this managed instance - // group. It can be a full or partial URL. For example, the following are all - // valid URLs to a workload policy: - - // https://www.googleapis.com/compute/v1/projects/project/regions/region - // /resourcePolicies/resourcePolicy - - // projects/project/regions/region/resourcePolicies/resourcePolicy - - // regions/region/resourcePolicies/resourcePolicy - optional string workload_policy = 1 [json_name = "workloadPolicy"]; -} - -message InstanceGroupManagerStandbyPolicy { - // Specifies the number of seconds that the MIG should wait to suspend or stop - // a VM after that VM was created. The initial delay gives the initialization - // script the time to prepare your VM for a quick scale out. The value of - // initial delay must be between 0 and 3600 seconds. The default value is 0. - optional int32 initial_delay_sec = 1 [json_name = "initialDelaySec"]; - - // Defines how a MIG resumes or starts VMs from a standby pool when the group - // scales out. The default mode is `MANUAL`. - // MANUAL: MIG does not automatically resume or start VMs in the standby pool - // when the group scales out. - // SCALE_OUT_POOL: MIG automatically resumes or starts VMs in the standby pool - // when the group scales out, and replenishes the standby pool afterwards. - optional string mode = 2 [json_name = "mode"]; -} - -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] 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] 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 configuration 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"]; +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"]; + + // [DEPRECATED] CSEK is no longer supported. Use CMEK instead. + // 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 thersaEncryptedKey. + // For example: + // + // "rawKey": + // "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=" + optional string raw_key = 3 [json_name = "rawKey"]; + + // [DEPRECATED] CSEK is no longer supported. Use CMEK instead. + // 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 thersaEncryptedKey. + // 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"]; + + // [DEPRECATED] CSEK is no longer supported. Use CMEK instead. + // [Output only] TheRFC + // 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 + // - SNP_SVSM_CAPABLE + // - CCA_CAPABLE + // + // + // For more information, see + // Enabling guest operating system features. + // BARE_METAL_LINUX_COMPATIBLE: + // CCA_CAPABLE: + // FEATURE_TYPE_UNSPECIFIED: + // GVNIC: + // IDPF: + // MULTI_IP_SUBNET: + // SECURE_BOOT: + // SEV_CAPABLE: + // SEV_LIVE_MIGRATABLE: + // SEV_LIVE_MIGRATABLE_V2: + // SEV_SNP_CAPABLE: + // SNP_SVSM_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_029.proto b/protos/google/cloud/compute/v1/internal/common_029.proto index 7d47aa4227eba..badb6e594db9d 100644 --- a/protos/google/cloud/compute/v1/internal/common_029.proto +++ b/protos/google/cloud/compute/v1/internal/common_029.proto @@ -15,24 +15,1343 @@ // 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: 20250601 +// revision: 20260807 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_001.proto"; +import "google/cloud/compute/v1/internal/common_004.proto"; +import "google/cloud/compute/v1/internal/common_028.proto"; +import "google/cloud/compute/v1/internal/common_038.proto"; +import "google/cloud/compute/v1/internal/common_043.proto"; +import "google/cloud/compute/v1/internal/common_048.proto"; +import "google/cloud/compute/v1/internal/common_096.proto"; +import "google/cloud/compute/v1/internal/common_173.proto"; + +message CustomerEncryptionKeyProtectedDisk { + // Decrypts data associated with the disk with acustomer-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. [Output Only] Type of the resource. + // Alwayscompute#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. [Output Only] The value of the requested queried path. + optional GuestAttributesValue query_value = 3 [json_name = "queryValue"]; + + // Output only. [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. [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, readVirtual 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, seeEnabling IP + // Forwarding. + optional bool can_ip_forward = 2 [json_name = "canIpForward"]; + + optional ConfidentialInstanceConfig confidential_instance_config = 3 + [json_name = "confidentialInstanceConfig"]; + + // Output only. [Output Only] The CPU platform used by this instance. + optional string cpu_platform = 4 [json_name = "cpuPlatform"]; + + // Output only. [Output Only] Creation timestamp inRFC3339 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. [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 acustomer-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. [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. [Output Only] Last start timestamp inRFC3339 text format. + optional string last_start_timestamp = 18 [json_name = "lastStartTimestamp"]; + + // Output only. [Output Only] Last stop timestamp inRFC3339 text format. + optional string last_stop_timestamp = 19 [json_name = "lastStopTimestamp"]; + + // Output only. [Output Only] Last suspended timestamp inRFC3339 text format. + optional string last_suspended_timestamp = 20 + [json_name = "lastSuspendedTimestamp"]; + + // Specifies which method should be used for encrypting the + // Local SSDs attached to the VM. + // EPHEMERAL_KEY_ENCRYPTION: The given VM will opt-in for using ephemeral key + // for + // encryption of Local SSDs. + // The Local SSDs will not be able to recover data in case of VM + // crash. + // LOCAL_SSD_ENCRYPTION_MODE_UNSPECIFIED: The given VM will be encrypted using + // keys managed by the cloud + // infrastructure and the keys will be deleted when the VM is + // deleted. + // STANDARD_ENCRYPTION: The given VM will be encrypted using keys managed by + // the cloud + // infrastructure and the keys will be deleted when the VM is + // deleted. + optional string local_ssd_encryption_mode = 47 + [json_name = "localSsdEncryptionMode"]; + + // 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 acustom + // 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 theSpecifications + // for custom machine types. + optional string machine_type = 21 [json_name = "machineType"]; + + // The metadata key/value pairs assigned + // to this instance. This includes metadata keys that were explicitly defined + // for the instance. + optional Metadata metadata = 22 [json_name = "metadata"]; + + // Specifies aminimum 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 + // withRFC1035. + // 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. [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. [Output Only] Reserved for future use. + optional bool satisfies_pzi = 46 [json_name = "satisfiesPzi"]; + + // Output only. [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. [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. SeeService 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. [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. [Output Only] The status of the instance. One of the + // following values: PROVISIONING, STAGING,RUNNING, STOPPING, + // SUSPENDING,SUSPENDED, REPAIRING, andTERMINATED. 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. + // PENDING: For Flex Start provisioning instance is waiting for available + // capacity + // from Dynamic Workload Scheduler (DWS). + // PENDING_STOP: The instance is gracefully shutting down. + // 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. [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 withRFC1035. + // Multiple tags can be specified via the 'tags.items' field. + optional Tags tags = 43 [json_name = "tags"]; + + optional WorkloadIdentityConfig workload_identity_config = 48 + [json_name = "workloadIdentityConfig"]; + + // Output only. [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. [Output Only] Type of resource. + // Alwayscompute#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 thanmaxResults, use the + // nextPageToken as a value 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. [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + // Output only. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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. [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 thanmaxResults, use the + // nextPageToken as a value 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. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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. [Output Only] Type of resource. + // Alwayscompute#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 thanmaxResults, use the + // nextPageToken as a value 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. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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 { + // Relative deadline for waiting for capacity. Relevant only for + // Instances.Insert API. + optional Duration request_valid_for_duration = 2 + [json_name = "requestValidForDuration"]; + + // Input only. Resource manager tags to be bound to the instance. Tag keys and + // values + // have the same definition as resource + // manager tags. Keys and values can be either in numeric format, + // such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in + // namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and + // `{tag_value_short_name}`. 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. [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. [Output Only] The name of the firewall policy. + optional string name = 2 [json_name = "name"]; + + // Output only. [Output Only] The packet mirroring rules that apply to the + // instance. + repeated FirewallPolicyRule packet_mirroring_rules = 7 + [json_name = "packetMirroringRules"]; + + // Output only. [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. [Output Only] The short name of the firewall policy. + optional string short_name = 4 [json_name = "shortName"]; + + // Output only. [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 InstancesReportHostAsFaultyRequest { + // The disruption schedule for the VM. Required field, only allows IMMEDIATE. + // DISRUPTION_SCHEDULE_UNSPECIFIED: Not used. Required as per aip/126. + // FUTURE: Delay disruption for caller control. Will be default soon. + // IMMEDIATE: Default value. Disrupt the VM immediately. + optional string disruption_schedule = 1 [json_name = "disruptionSchedule"]; + + repeated InstancesReportHostAsFaultyRequestFaultReason fault_reasons = 2 + [json_name = "faultReasons"]; +} + +message InstancesReportHostAsFaultyRequestFaultReason { + // BEHAVIOR_UNSPECIFIED: Public reportable behaviors + // CHIP_ERROR: Any GPU or TPU errors or faults where the accelerator becomes + // unusable + // PERFORMANCE: + // SILENT_DATA_CORRUPTION: + // UNRECOVERABLE_GPU_ERROR: Unrecoverable GPU error identified by an XID + optional string behavior = 1 [json_name = "behavior"]; + + optional string description = 2 [json_name = "description"]; +} + +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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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 + // acustomer-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. [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. [Output Only] Effective metadata is a field that consolidates + // project, + // zonal instance settings, and instance-level predefined metadata keys to + // provide the overridden value for those metadata keys at the instance level. + optional ResourceStatusEffectiveInstanceMetadata effective_instance_metadata = + 5 [json_name = "effectiveInstanceMetadata"]; + + // Output only. [Output Only] The precise location of your instance within the + // zone's data + // center, including the block, sub-block, and host. The field is formatted as + // follows: blockId/subBlockId/hostId. + optional string physical_host = 1 [json_name = "physicalHost"]; + + // Output only. [Output Only] A series of fields containing the global name of + // the Compute + // Engine cluster, as well as the ID of the block, sub-block, and host on + // which the running instance is located. + optional ResourceStatusPhysicalHostTopology physical_host_topology = 4 + [json_name = "physicalHostTopology"]; + + // Output only. [Output Only] Reservation information that the instance is + // consuming from. + optional ResourceStatusReservationConsumptionInfo + reservation_consumption_info = 6 + [json_name = "reservationConsumptionInfo"]; + + optional ResourceStatusScheduling scheduling = 3 [json_name = "scheduling"]; + + // Output only. [Output Only] Details about the instance stopping state. + optional ResourceStatusShutdownDetails shutdown_details = 7 + [json_name = "shutdownDetails"]; + + optional UpcomingMaintenance upcoming_maintenance = 2 + [json_name = "upcomingMaintenance"]; +} + +// Effective values of predefined metadata keys for an instance. +message ResourceStatusEffectiveInstanceMetadata { + // Effective block-project-ssh-keys value at Instance level. + optional bool block_project_ssh_keys_metadata_value = 1 + [json_name = "blockProjectSshKeysMetadataValue"]; + + // Effective enable-guest-attributes value at Instance level. + optional bool enable_guest_attributes_metadata_value = 2 + [json_name = "enableGuestAttributesMetadataValue"]; + + // Effective enable-os-inventory value at Instance level. + optional bool enable_os_inventory_metadata_value = 3 + [json_name = "enableOsInventoryMetadataValue"]; + + // Effective enable-osconfig value at Instance level. + optional bool enable_osconfig_metadata_value = 4 + [json_name = "enableOsconfigMetadataValue"]; + + // Effective enable-oslogin value at Instance level. + optional bool enable_oslogin_metadata_value = 5 + [json_name = "enableOsloginMetadataValue"]; + + // Effective gce-container-declaration value at Instance level. + optional bool gce_container_declaration_metadata_value = 6 + [json_name = "gceContainerDeclarationMetadataValue"]; + + // Effective serial-port-enable value at Instance level. + optional bool serial_port_enable_metadata_value = 7 + [json_name = "serialPortEnableMetadataValue"]; + + // Effective serial-port-logging-enable value at Instance level. + optional bool serial_port_logging_enable_metadata_value = 8 + [json_name = "serialPortLoggingEnableMetadataValue"]; + + // Effective VM DNS setting at Instance level. + optional string vm_dns_setting_metadata_value = 9 + [json_name = "vmDnsSettingMetadataValue"]; +} + +// Represents the physical host topology of the host on which the VM is +// running. +message ResourceStatusPhysicalHostTopology { + // Output only. [Output Only] Additional location information of the running + // instance. + optional ResourceStatusPhysicalHostTopologyAdditionalAttributes + additional_attributes = 5 [json_name = "additionalAttributes"]; + + // [Output Only] The ID of the block in which the running instance is + // located. Instances within the same block experience low network latency. + optional string block = 1 [json_name = "block"]; + + // [Output Only] The global name of the Compute Engine cluster where the + // running instance is located. + optional string cluster = 2 [json_name = "cluster"]; + + // [Output Only] The ID of the host on which the running instance is located. + // Instances on the same host experience the lowest possible network + // latency. + optional string host = 3 [json_name = "host"]; + + // [Output Only] The ID of the sub-block in which the running instance is + // located. Instances in the same sub-block experience lower network latency + // than instances in the same block. + optional string subblock = 4 [json_name = "subblock"]; +} + +// Additional location information of the running instance. +message ResourceStatusPhysicalHostTopologyAdditionalAttributes { + // Output only. The IDs of the accelerator topologies the instance belongs to. + // For + // example + // The key will be topologies like "4x4", "2x2x2" and the value will be + // the location ID of the topologies. + map accelerator_topology_ids = 1 + [json_name = "acceleratorTopologyIds"]; +} + +// Reservation consumption information that the instance is consuming from. +message ResourceStatusReservationConsumptionInfo { + // Output only. [Output Only] The full resource name of the reservation that + // this + // instance is consuming from. + optional string consumed_reservation = 1 [json_name = "consumedReservation"]; + + // Output only. [Output Only] The full resource name of the reservation block + // that this + // instance is consuming from. + optional string consumed_reservation_block = 2 + [json_name = "consumedReservationBlock"]; + + // Output only. [Output Only] The full resource name of the reservation + // sub-block that + // this instance is consuming from. + optional string consumed_reservation_sub_block = 3 + [json_name = "consumedReservationSubBlock"]; +} + +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"]; + + // Output only. Specifies the timestamp, when the instance will start graceful + // shutdown + // process, in RFC3339 text format. + optional string graceful_shutdown_timestamp = 2 + [json_name = "gracefulShutdownTimestamp"]; + + // Time in future when the instance will be terminated inRFC3339 text format. + optional string termination_timestamp = 3 + [json_name = "terminationTimestamp"]; +} + +// Specifies if the instance is in `PENDING_STOP` state or there is a +// programmed stop scheduled. +message ResourceStatusShutdownDetails { + // The duration for graceful shutdown. Only applicable when + // `stop_state=PENDING_STOP`. + optional Duration max_duration = 1 [json_name = "maxDuration"]; + + // Past timestamp indicating the beginning of current `stopState` in RFC3339 + // text format. + optional string request_timestamp = 2 [json_name = "requestTimestamp"]; + + // Current stopping state of the instance. + // PENDING_STOP: The instance is gracefully shutting down. + // STOPPING: The instance is stopping. + optional string stop_state = 3 [json_name = "stopState"]; + + // Target instance state. + // DELETED: The instance will be deleted. + // STOPPED: The instance will be stopped. + optional string target_state = 4 [json_name = "targetState"]; +} + +// An instance's screenshot. +message Screenshot { + // [Output Only] The Base64-encoded screenshot data. + optional string contents = 1 [json_name = "contents"]; + + // Output only. [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. [Output Only] Type of the resource. + // Alwayscompute#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. [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 ECC P256 algorithm + // issued to the Shielded Instance's vTPM. + optional ShieldedInstanceIdentityEntry ecc_p256_encryption_key = 4 + [json_name = "eccP256EncryptionKey"]; + + // An Attestation Key (AK) made by the ECC P256 algorithm + // issued to the Shielded Instance's vTPM. + optional ShieldedInstanceIdentityEntry ecc_p256_signing_key = 5 + [json_name = "eccP256SigningKey"]; + + // 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. [Output Only] Type of the resource. + // Alwayscompute#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_030.proto b/protos/google/cloud/compute/v1/internal/common_030.proto index afad0da2aadc0..d96d6fbb7e23f 100644 --- a/protos/google/cloud/compute/v1/internal/common_030.proto +++ b/protos/google/cloud/compute/v1/internal/common_030.proto @@ -15,330 +15,174 @@ // 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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_034.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"]; +// Represents a whole or partial calendar date, such as a birthday. The time of +// day and time zone are either specified elsewhere or are insignificant. The +// date is relative to the Gregorian Calendar. This can represent one of the +// following: +// +// * A full date, with non-zero year, month, and day values. +// * A month and day, with a zero year (for example, an anniversary). +// * A year on its own, with a zero month and a zero day. +// * A year and month, with a zero day (for example, a credit card expiration +// date). +// +// Related types: +// +// * google.type.TimeOfDay +// * google.type.DateTime +// * google.protobuf.Timestamp +message Date { + // Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 + // to specify a year by itself or a year and month where the day isn't + // significant. + optional int32 day = 1 [json_name = "day"]; + + // Month of a year. Must be from 1 to 12, or 0 to specify a year without a + // month and day. + optional int32 month = 2 [json_name = "month"]; + + // Year of the date. Must be from 1 to 9999, or 0 to specify a date without + // a year. + optional int32 year = 3 [json_name = "year"]; } -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"]; +// Represents a single Google Compute Engine preview feature. +message PreviewFeature { + // Specifies whether the feature is enabled or disabled. + // ACTIVATION_STATE_UNSPECIFIED: + // DISABLED: + // ENABLED: + optional string activation_status = 1 [json_name = "activationStatus"]; - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value 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. [Output Only] Creation timestamp inRFC3339 + // text format. + optional string creation_timestamp = 2 [json_name = "creationTimestamp"]; - // [Output Only] Server-defined URL for this resource. - optional string self_link = 5 [json_name = "selfLink"]; + // Output only. [Output Only] Description of the feature. + optional string description = 3 [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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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. [Output Only] The unique identifier for the resource. This + // identifier is + // defined by the server. + optional string id = 4 [json_name = "id"]; - 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. [Output only] The type of the feature. Always + // "compute#previewFeature" for + // preview features. + optional string kind = 5 [json_name = "kind"]; - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } + // Name of the feature. + optional string name = 6 [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"]; + // Rollout operation of the feature. + optional PreviewFeatureRolloutOperation rollout_operation = 7 + [json_name = "rolloutOperation"]; - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } + // Output only. [Output Only] Server-defined URL for the resource. + optional string self_link = 8 [json_name = "selfLink"]; - // [Output Only] Informational warning message. - optional Warning warning = 6 [json_name = "warning"]; + // Output only. [Output only] Status of the feature. + optional PreviewFeatureStatus status = 9 [json_name = "status"]; } -// 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"]; - - // A full or partial URL of the network profile to apply to this network. This - // field can be set only at resource creation time. For example, the following - // are valid URLs: - - // https://www.googleapis.com/compute/{api_version}/projects/{project_id}/global/networkProfiles/{network_profile_name} - // - projects/{project_id}/global/networkProfiles/{network_profile_name} - optional string network_profile = 19 [json_name = "networkProfile"]; - - // Input only. [Input Only] Additional params passed with the request, but not - // persisted as part of resource payload. - optional NetworkParams params = 20 [json_name = "params"]; - - // [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"]; -} +message PreviewFeatureList { + optional string etag = 1 [json_name = "etag"]; -// 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"]; + optional string id = 2 [json_name = "id"]; - // [Output Only] Type of resource. Always compute#networkList for lists of - // networks. - optional string kind = 3 [json_name = "kind"]; + // A list of PreviewFeature resources. + repeated PreviewFeature items = 3 [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 + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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. + // Output only. [Output Only] Server-defined URL for this resource. optional string self_link = 5 [json_name = "selfLink"]; + // Output only. [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. + // [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. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -347,19 +191,27 @@ message NetworkList { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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. @@ -367,215 +219,58 @@ message NetworkList { } // [Output Only] Informational warning message. - optional Warning warning = 6 [json_name = "warning"]; -} - -// Additional network parameters. -message NetworkParams { - // Tag keys/values directly bound to this resource. Tag keys and values have - // the same definition as resource manager tags. The field is allowed for - // INSERT only. The keys/values to set on the resource should be specified in - // either ID { : } or Namespaced format { : }. For example the following are - // valid inputs: * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : - // "tagValues/456"} * {"123/environment" : "production", "345/abc" : "xyz"} - // Note: * Invalid combinations of ID & namespaced format is not supported. - // For instance: {"123/environment" : "tagValues/444"} is invalid. - map resource_manager_tags = 1 - [json_name = "resourceManagerTags"]; -} - -// 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"]; - - // [Output Only] Maximum Transmission Unit in bytes of the peer network. - 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"]; + optional Warning warning = 7 [json_name = "warning"]; } -// 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 { - // Enable comparison of Multi-Exit Discriminators (MED) across routes with - // different neighbor ASNs when using the STANDARD BGP best path selection - // algorithm. - optional bool bgp_always_compare_med = 2 [json_name = "bgpAlwaysCompareMed"]; - - // The BGP best path selection algorithm to be employed within this network - // for dynamic routes learned by Cloud Routers. Can be LEGACY (default) or - // STANDARD. - // LEGACY: - // STANDARD: - optional string bgp_best_path_selection_mode = 3 - [json_name = "bgpBestPathSelectionMode"]; - - // Allows to define a preferred approach for handling inter-region cost in the - // selection process when using the STANDARD BGP best path selection - // algorithm. Can be DEFAULT or ADD_COST_TO_MED. - // ADD_COST_TO_MED: - // DEFAULT: - optional string bgp_inter_region_cost = 4 [json_name = "bgpInterRegionCost"]; - - // [Output Only] Effective value of the bgp_always_compare_med field. - optional bool effective_bgp_always_compare_med = 5 - [json_name = "effectiveBgpAlwaysCompareMed"]; - - // [Output Only] Effective value of the bgp_inter_region_cost field. - // ADD_COST_TO_MED: - // DEFAULT: - optional string effective_bgp_inter_region_cost = 6 - [json_name = "effectiveBgpInterRegionCost"]; - - // 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"]; +// Represents the rollout operation +message PreviewFeatureRolloutOperation { + // Input only. The input for the rollout operation. + optional PreviewFeatureRolloutOperationRolloutInput rollout_input = 1 + [json_name = "rolloutInput"]; } -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"]; +// Represents the input for the rollout operation. +message PreviewFeatureRolloutOperationRolloutInput { + // The name of the rollout plan + // Ex. + // organizations//locations/global/rolloutPlans/ + // Ex. + // folders//locations/global/rolloutPlans/ + // Ex. + // projects//locations/global/rolloutPlans/. + optional string name = 1 [json_name = "name"]; - // Effective firewalls on the network. - repeated Firewall firewalls = 2 [json_name = "firewalls"]; + // Predefined rollout plan. + // ROLLOUT_PLAN_FAST_ROLLOUT: + // ROLLOUT_PLAN_TWO_DAY_ROLLOUT: + // ROLLOUT_PLAN_UNSPECIFIED: + optional string predefined_rollout_plan = 2 + [json_name = "predefinedRolloutPlan"]; } -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] The packet mirroring rules that apply to the network. - repeated FirewallPolicyRule packet_mirroring_rules = 7 - [json_name = "packetMirroringRules"]; +// [Output Only] The status of the feature. +message PreviewFeatureStatus { + // Output only. [Output Only] The description of the feature. + optional string description = 1 [json_name = "description"]; - // [Output only] Priority of firewall policy association. Not applicable for - // type=HIERARCHY. - optional int32 priority = 6 [json_name = "priority"]; + // Output only. [Output Only] Link to the public documentation for the + // feature. + optional string help_link = 2 [json_name = "helpLink"]; - // [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"]; + optional PreviewFeatureStatusReleaseStatus release_status = 3 + [json_name = "releaseStatus"]; } -message NetworksUpdatePeeringRequest { - optional NetworkPeering network_peering = 1 [json_name = "networkPeering"]; +// [Output Only] The release status of the feature. +message PreviewFeatureStatusReleaseStatus { + // Output only. [Output Only] The stage of the feature. + // DEPRECATED: + // GA: + // PREVIEW: + // STAGE_UNSPECIFIED: + optional string stage = 1 [json_name = "stage"]; + + // Output only. The last date when a feature transitioned between + // ReleaseStatuses. + optional Date update_date = 2 [json_name = "updateDate"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_031.proto b/protos/google/cloud/compute/v1/internal/common_031.proto index 0f91593bae417..3cb0ecb0ea44c 100644 --- a/protos/google/cloud/compute/v1/internal/common_031.proto +++ b/protos/google/cloud/compute/v1/internal/common_031.proto @@ -15,42 +15,303 @@ // 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: 20250601 +// revision: 20260807 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"]; +import "google/cloud/compute/v1/internal/common_032.proto"; + +// Represents civil time (or occasionally physical time). +// +// This type can represent a civil time in one of a few possible ways: +// +// * When utc_offset is set and time_zone is unset: a civil time on a calendar +// day with a particular offset from UTC. +// * When time_zone is set and utc_offset is unset: a civil time on a calendar +// day in a particular time zone. +// * When neither time_zone nor utc_offset is set: a civil time on a calendar +// day in local time. +// +// The date is relative to the Proleptic Gregorian Calendar. +// +// If year, month, or day are 0, the DateTime is considered not to have a +// specific year, month, or day respectively. +// +// This type may also be used to represent a physical time if all the date and +// time fields are set and either case of the `time_offset` oneof is set. +// Consider using `Timestamp` message for physical time instead. If your use +// case also would like to store the user's timezone, that can be done in +// another field. +// +// This type is more flexible than some applications may want. Make sure to +// document and validate your application's limitations. +message DateTime { + // Optional. Day of month. Must be from 1 to 31 and valid for the year and + // month, or 0 if specifying a datetime without a day. + optional int32 day = 1 [json_name = "day"]; + + // Optional. Hours of day in 24 hour format. Should be from 0 to 23, defaults + // to 0 (midnight). An API may choose to allow the value "24:00:00" for + // scenarios like business closing time. + optional int32 hours = 2 [json_name = "hours"]; + + // Optional. Minutes of hour of day. Must be from 0 to 59, defaults to 0. + optional int32 minutes = 3 [json_name = "minutes"]; + + // Optional. Month of year. Must be from 1 to 12, or 0 if specifying a + // datetime without a month. + optional int32 month = 4 [json_name = "month"]; + + // Optional. Fractions of seconds in nanoseconds. Must be from 0 to + // 999,999,999, defaults to 0. + optional int32 nanos = 5 [json_name = "nanos"]; + + // Optional. Seconds of minutes of the time. Must normally be from 0 to 59, + // defaults to 0. An API may allow the value 60 if it allows leap-seconds. + optional int32 seconds = 6 [json_name = "seconds"]; + + // Time zone. + optional TimeZone time_zone = 7 [json_name = "timeZone"]; + + // UTC offset. Must be whole seconds, between -18 hours and +18 hours. + // For example, a UTC offset of -4:00 would be represented as + // { seconds: -14400 }. + optional string utc_offset = 8 [json_name = "utcOffset"]; + + // Optional. Year of date. Must be from 1 to 9999, or 0 if specifying a + // datetime without a year. + optional int32 year = 9 [json_name = "year"]; +} + +// The periodic partial maintenance schedule includes 52 weeks worth of +// maintenance windows. +// LINT.IfChange(PeriodicPartialMaintenanceSchedule) +message PeriodicPartialMaintenanceSchedule { + // The maintenance type in which the zone is during the given window. + // MAINTENANCE_SUBTYPE_UNSPECIFIED: Default value. + // MAINTENANCE_TYPE_CUSTOMER_MAINTENANCE: A dedicated window for customers to + // perform their own maintenance. This + // often runs concurrently with a DISRUPTIVE_UPGRADE. + // MAINTENANCE_TYPE_DISRUPTIVE_UPGRADE: For disruptive updates, including host + // machine kernel or firmware + // upgrades. + // MAINTENANCE_TYPE_STABLE: A post-maintenance window for customers to conduct + // final testing and + // performance validation before resuming full business operations. + // MAINTENANCE_TYPE_TRANSITION: For preliminary, non-disruptive tasks such as + // key rotations. + optional string sub_type = 1 [json_name = "subType"]; + + // The target resource that the maintenance window is for. + // For example, "projects/my-project/zones/us-central1-a". + optional string target_resource = 2 [json_name = "targetResource"]; + + // MAINTENANCE_TYPE_UNSPECIFIED: Default value. + // PRIVATE_ZONE_MAINTENANCE: The zone is in a private maintenance window. + optional string type = 3 [json_name = "type"]; + + // The end civil timestamp of the window (not inclusive). + // This contains a time zone. + optional DateTime window_end_time = 4 [json_name = "windowEndTime"]; + + // The start civil timestamp of the window. + // This contains a time zone. + optional DateTime window_start_time = 5 [json_name = "windowStartTime"]; +} + +// Represents a time zone from the +// [IANA Time Zone Database](https://www.iana.org/time-zones). +message TimeZone { + // IANA Time Zone Database time zone. For example "America/New_York". + optional string id = 1 [json_name = "id"]; + + // Optional. IANA Time Zone Database version number. For example "2019a". + optional string version = 2 [json_name = "version"]; +} + +// 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 theus-east1 region. For more +// information, readRegions 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 inRFC3339 + // text format. + optional string creation_timestamp = 2 [json_name = "creationTimestamp"]; + + // [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. [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"]; + + optional ZoneResourceStatus resource_status = 12 + [json_name = "resourceStatus"]; + + // [Output Only] Server-defined URL for the resource. + optional string self_link = 9 [json_name = "selfLink"]; + + // [Output Only] Status of the zone, either UP orDOWN. + // DOWN: + // UP: + optional string status = 10 [json_name = "status"]; + + // Output only. [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"]; + + // Output only. 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 thanmaxResults, use the + // nextPageToken as a value 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. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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 ZoneResourceStatus { + // Output only. [Output Only] The upcoming maintenance schedule. + repeated PeriodicPartialMaintenanceSchedule upcoming_maintenances = 1 + [json_name = "upcomingMaintenances"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_032.proto b/protos/google/cloud/compute/v1/internal/common_032.proto index 2ee6d27e27ba0..ba0c52f2474d5 100644 --- a/protos/google/cloud/compute/v1/internal/common_032.proto +++ b/protos/google/cloud/compute/v1/internal/common_032.proto @@ -15,225 +15,48 @@ // 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: 20250601 +// revision: 20260807 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"]; - - // 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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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"]; +// 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 + // useACTIVE. Operations which create a new resource using aDEPRECATED + // resource will return successfully, but with a + // warning indicating the deprecated resource and recommending its + // replacement. Operations which use OBSOLETE orDELETED 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_033.proto b/protos/google/cloud/compute/v1/internal/common_033.proto index d37e111579d5c..17fc111fea903 100644 --- a/protos/google/cloud/compute/v1/internal/common_033.proto +++ b/protos/google/cloud/compute/v1/internal/common_033.proto @@ -15,35 +15,290 @@ // 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: 20250601 +// revision: 20260807 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"]; +import "google/cloud/compute/v1/internal/common_004.proto"; - // The file type of source file. - // BIN: - // UNDEFINED: - // X509: - optional string file_type = 2 [json_name = "fileType"]; +// 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](https://cloud.google.com/compute/docs/reference/rest/v1/instanceTemplates) +// * +// [Regional](https://cloud.google.com/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, readInstance Templates. +message InstanceTemplate { + // Output only. [Output Only] The creation timestamp for this instance + // template inRFC3339 + // 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. [Output Only] A unique identifier for this instance template. + // The server + // defines this identifier. + optional string id = 3 [json_name = "id"]; + + // Output only. [Output Only] The resource type, which is + // alwayscompute#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 withRFC1035. + // 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. [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. [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"]; } -// 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"]; +// 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 InstanceTemplate resources. + repeated InstanceTemplate items = 2 [json_name = "items"]; + + // Output only. [Output Only] The resource type, which is + // alwayscompute#instanceTemplatesListResponse for instance template + // lists. + optional string kind = 3 [json_name = "kind"]; - // The forbidden key database (dbx). - repeated FileContentBuffer dbxs = 2 [json_name = "dbxs"]; + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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 Key Exchange Key (KEK). - repeated FileContentBuffer keks = 3 [json_name = "keks"]; + // Output only. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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 Platform Key (PK). - optional FileContentBuffer pk = 4 [json_name = "pk"]; +// 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_034.proto b/protos/google/cloud/compute/v1/internal/common_034.proto index 8153ca51f2f75..40c080da858f3 100644 --- a/protos/google/cloud/compute/v1/internal/common_034.proto +++ b/protos/google/cloud/compute/v1/internal/common_034.proto @@ -15,202 +15,364 @@ // 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: 20250601 +// revision: 20260807 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_096.proto"; +import "google/cloud/compute/v1/internal/common_115.proto"; - // 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"]; +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"]; - // [Output Only] Creation timestamp in RFC3339 text format. - optional string creation_timestamp = 2 [json_name = "creationTimestamp"]; + // 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 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"]; - } +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"]; +} - // 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"]; +// 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. [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 beCA_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 inRFC3339 + // text format. + optional string creation_timestamp = 2 [json_name = "creationTimestamp"]; - // An optional description of this resource. Provide this field when you - // create the resource. - optional string description = 4 [json_name = "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. + // 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"]; - // 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"]; + // [Output Only] Default service account used by VMs running in this project. + optional string default_service_account = 4 + [json_name = "defaultServiceAccount"]; - // 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"]; + // An optional textual description of the resource. + optional string description = 5 [json_name = "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. - optional bool disabled = 7 [json_name = "disabled"]; + // An optional list of 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. - 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"]; - - // Input only. [Input Only] Additional params passed with the request, but not - // persisted as part of resource payload. - optional FirewallParams params = 20 [json_name = "params"]; - - // 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"]; + // 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. [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 = 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"]; + optional string self_link = 11 [json_name = "selfLink"]; + + // An optional 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. [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"]; } -// 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"]; +message ProjectsEnableXpnResourceRequest { + // Service resource (a.k.a service project) ID. + optional XpnResourceId xpn_resource = 1 [json_name = "xpnResource"]; } -// Additional firewall parameters. -message FirewallParams { - // Tag keys/values directly bound to this resource. Tag keys and values have - // the same definition as resource manager tags. The field is allowed for - // INSERT only. The keys/values to set on the resource should be specified in - // either ID { : } or Namespaced format { : }. For example the following are - // valid inputs: * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : - // "tagValues/456"} * {"123/environment" : "production", "345/abc" : "xyz"} - // Note: * Invalid combinations of ID & namespaced format is not supported. - // For instance: {"123/environment" : "tagValues/444"} is invalid. - map resource_manager_tags = 1 - [json_name = "resourceManagerTags"]; +message ProjectsGetXpnResources { + // Output only. [Output Only] Type of resource. + // Alwayscompute#projectsGetXpnResources for lists of service resources + // (a.k.a service projects) + optional string kind = 1 [json_name = "kind"]; + + // Output only. [Output Only] This token allows you to get the next page of + // results for + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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 + // asexample-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 + // inbucketName. If not supplied, defaults tousage_gce. The report is stored + // as a CSV file namedreport_name_prefix_gce_YYYYMMDD.csv whereYYYYMMDD is the + // day of the usage according to Pacific Time. + // If you supply a prefix, it should conform to Cloud Storageobject 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. [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 thanmaxResults, use the + // nextPageToken as a value 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. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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"]; +} + +// 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_035.proto b/protos/google/cloud/compute/v1/internal/common_035.proto index 0f8e4e230e8e1..98de3af1c123e 100644 --- a/protos/google/cloud/compute/v1/internal/common_035.proto +++ b/protos/google/cloud/compute/v1/internal/common_035.proto @@ -15,119 +15,72 @@ // 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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_034.proto"; +import "google/cloud/compute/v1/internal/common_032.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"]; +// Represents a Disk Type resource. +// +// Google Compute Engine has two Disk Type resources: +// +// * +// [Regional](https://cloud.google.com/compute/docs/reference/rest/v1/regionDiskTypes) +// * [Zonal](https://cloud.google.com/compute/docs/reference/rest/v1/diskTypes) +// +// You can choose from a variety of disk types based on your needs. +// For more information, readStorage options. +// +// The diskTypes resource represents disk types for a zonal +// persistent disk. +// For more information, readZonal 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 inRFC3339 + // text format. + optional string creation_timestamp = 1 [json_name = "creationTimestamp"]; - // A list of Firewall resources. - repeated Firewall items = 2 [json_name = "items"]; + // [Output Only] Server-defined default disk size in GB. + optional string default_disk_size_gb = 2 [json_name = "defaultDiskSizeGb"]; - // [Output Only] Type of resource. Always compute#firewallList for lists of - // firewalls. - optional string kind = 3 [json_name = "kind"]; + // [Output Only] The deprecation status associated with this disk type. + optional DeprecationStatus deprecated = 3 [json_name = "deprecated"]; - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value 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] An optional description of this resource. + optional string description = 4 [json_name = "description"]; - // [Output Only] Server-defined URL for this resource. - optional string self_link = 5 [json_name = "selfLink"]; + // [Output Only] The unique identifier for the resource. This identifier is + // defined by the server. + optional string id = 5 [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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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. [Output Only] Type of the resource. Always compute#diskType + // for disk types. + optional string kind = 6 [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 = 7 [json_name = "name"]; - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } + // [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] 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] Server-defined URL for the resource. + optional string self_link = 9 [json_name = "selfLink"]; - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } + // [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] Informational warning message. - optional Warning warning = 6 [json_name = "warning"]; + // [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_036.proto b/protos/google/cloud/compute/v1/internal/common_036.proto index fa8eaf38a7ede..3fb4e1a4cfc72 100644 --- a/protos/google/cloud/compute/v1/internal/common_036.proto +++ b/protos/google/cloud/compute/v1/internal/common_036.proto @@ -15,37 +15,384 @@ // 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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_007.proto"; -import "google/cloud/compute/v1/internal/common_038.proto"; +import "google/cloud/compute/v1/internal/common_035.proto"; -message FirewallPoliciesListAssociationsResponse { - // A list of associations. - repeated FirewallPolicyAssociation associations = 1 - [json_name = "associations"]; +message DiskTypeAggregatedList { + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 1 [json_name = "id"]; - // [Output Only] Type of firewallPolicy associations. Always - // compute#FirewallPoliciesListAssociations for lists of firewallPolicy - // associations. - optional string kind = 2 [json_name = "kind"]; + // A list of DiskTypesScopedList resources. + map items = 2 [json_name = "items"]; + + // Output only. [Output Only] Type of resource. + // Alwayscompute#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 thanmaxResults, use the + // nextPageToken as a value 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. [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + // Output only. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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 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. [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 thanmaxResults, use the + // nextPageToken as a value 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. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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 GlobalOrganizationSetPolicyRequest { - // Flatten Policy to create a backward compatible wire-format. Deprecated. Use - // 'policy' to specify bindings. - repeated Binding bindings = 1 [json_name = "bindings"]; +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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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 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_037.proto b/protos/google/cloud/compute/v1/internal/common_037.proto index 2d06c9fa83468..0bdf232f459c3 100644 --- a/protos/google/cloud/compute/v1/internal/common_037.proto +++ b/protos/google/cloud/compute/v1/internal/common_037.proto @@ -15,215 +15,1324 @@ // 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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; +import "google/cloud/compute/v1/internal/common_019.proto"; import "google/cloud/compute/v1/internal/common_038.proto"; +import "google/cloud/compute/v1/internal/common_049.proto"; +import "google/cloud/compute/v1/internal/common_098.proto"; +import "google/cloud/compute/v1/internal/common_110.proto"; -message FirewallPoliciesScopedList { - // A list of firewall policies contained in this scope. - repeated FirewallPolicy firewall_policies = 1 - [json_name = "firewallPolicies"]; - - 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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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 DistributionPolicy { + // The distribution shape to which the group converges either proactively or + // on resize events (depending on the value set + // inupdatePolicy.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. + // By default, a regional MIG doesn't automatically select an AI zone to + // create + // instances, even if an AI zone is available in the specified region. To + // create instances in an AI zone in the selected region, you must explicitly + // specify it in the distribution policy together with the other preferred + // zones. + repeated DistributionPolicyZoneConfiguration zones = 2 [json_name = "zones"]; +} + +message DistributionPolicyZoneConfiguration { + // The URL of thezone. + // 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, readInstance groups. +// +// For zonal Managed Instance Group, use the instanceGroupManagers +// resource. +// +// For regional Managed Instance Group, use theregionInstanceGroupManagers +// 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 + // inRFC3339 + // 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 error412 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, + // runapplyUpdatesToInstances, or set the group'supdatePolicy.type to + // PROACTIVE. + optional string instance_template = 10 [json_name = "instanceTemplate"]; + + // Output only. The resource type, which is alwayscompute#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'slistManagedInstances 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 withRFC1035. + 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. [Output Only] The URL of theregion + // where the managed instance group resides (for regional resources). + optional string region = 15 [json_name = "region"]; + + // Resource policies for this managed instance group. + optional InstanceGroupManagerResourcePolicies resource_policies = 32 + [json_name = "resourcePolicies"]; + + // 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"]; + + // Standby policy for stopped and suspended instances. + optional InstanceGroupManagerStandbyPolicy standby_policy = 29 + [json_name = "standbyPolicy"]; + + // 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 + // theinstanceGroup 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 policy that specifies how the MIG creates its VMs to achieve the target + // size. + optional InstanceGroupManagerTargetSizePolicy target_size_policy = 33 + [json_name = "targetSizePolicy"]; + + // The target number of stopped instances for this managed instance group. + // This number changes when you: + // + // - Stop instance using the stopInstances + // method or start instances using the startInstances + // method. + // - Manually change the targetStoppedSize using the update + // method. + optional int32 target_stopped_size = 30 [json_name = "targetStoppedSize"]; + + // The target number of suspended instances for this managed instance group. + // This number changes when you: + // + // - Suspend instance using the suspendInstances + // method or resume instances using the resumeInstances + // method. + // - Manually change the targetSuspendedSize using the update + // method. + optional int32 target_suspended_size = 31 [json_name = "targetSuspendedSize"]; + + // 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 aname. Every version can + // appear at most once per instance + // group. This field overrides the top-level instanceTemplate + // field. Read more about therelationships + // between these fields. Exactly one version must leave thetargetSize field + // unset. That version will be applied to all + // remaining instances. For more information, read aboutcanary + // updates. + repeated InstanceGroupManagerVersion versions = 22 [json_name = "versions"]; + + // Output only. The URL of azone + // 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] 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 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 theinstanceGroupManagers.patch + // orregionInstanceGroupManagers.patch. After settingallInstancesConfig 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 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 VM. If the value of the + // onFailedHealthCheck field is `DEFAULT_ACTION`, then the same action also + // applies to the VMs on which your application fails a health check. + // Valid values are + // + // - REPAIR (default): MIG automatically repairs a failed VM + // by recreating it. For more information, see About + // repairing VMs in a MIG. + // - DO_NOTHING: MIG does not repair a failed VM. + // DO_NOTHING: MIG does not repair a failed VM. + // REPAIR: (default): MIG automatically repairs a failed 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"]; + + // The action that a MIG performs on an unhealthy VM. A VM is marked as + // unhealthy when the application running on that VM fails a health check. + // Valid values are: + // + // - DEFAULT_ACTION (default): MIG uses the same action + // configured for instanceLifecyclePolicy.defaultActionOnFailure field. + // - REPAIR: MIG automatically repairs an unhealthy VM by + // recreating it. + // - DO_NOTHING: MIG doesn't repair an unhealthy VM. + // For more information, see + // About repairing VMs in a MIG. + // DEFAULT_ACTION: (Default) MIG uses the same action configured for + // instanceLifecyclePolicy.defaultActionOnFailure field. + // DO_NOTHING: MIG doesn't repair an unhealthy VM. + // REPAIR: MIG automatically repairs an unhealthy VM by recreating it. + optional string on_failed_health_check = 3 + [json_name = "onFailedHealthCheck"]; + + // Configuration for VM repairs in the MIG. + optional InstanceGroupManagerInstanceLifecyclePolicyOnRepair on_repair = 4 + [json_name = "onRepair"]; +} + +// Configuration for VM repairs in the MIG. +message InstanceGroupManagerInstanceLifecyclePolicyOnRepair { + // Specifies whether the MIG can change a VM's zone during a repair. + // Valid values are: + // + // - NO (default): MIG cannot change a VM's zone during a + // repair. + // - YES: MIG can select a different zone for the VM during + // a repair. + // NO: [Default] MIG cannot change a VM's zone during a repair. + // YES: MIG can select a different zone for the VM during a repair. + optional string allow_changing_zone = 1 [json_name = "allowChangingZone"]; +} + +message InstanceGroupManagerResourcePolicies { + // The URL of the workload policy that is specified for this managed + // instance group. + // It can be a full or partial URL. For example, the following are + // all valid URLs to a workload policy: + // + // + // - + // https://www.googleapis.com/compute/v1/projects/project/regions/region/resourcePolicies/resourcePolicy + // - projects/project/regions/region/resourcePolicies/resourcePolicy + // - regions/region/resourcePolicies/resourcePolicy + optional string workload_policy = 1 [json_name = "workloadPolicy"]; +} + +message InstanceGroupManagerStandbyPolicy { + // Specifies the number of seconds that the MIG should wait to suspend or + // stop a VM after that VM was created. The initial delay gives the + // initialization script the time to prepare your VM for a quick scale out. + // The value of initial delay must be between 0 and 3600 seconds. The + // default value is 0. + optional int32 initial_delay_sec = 1 [json_name = "initialDelaySec"]; + + // Defines how a MIG resumes or starts VMs from a standby pool when the + // group scales out. The default mode is `MANUAL`. + // MANUAL: MIG does not automatically resume or start VMs in the standby pool + // when + // the group scales out. + // SCALE_OUT_POOL: MIG automatically resumes or starts VMs in the standby pool + // when the + // group scales out, and replenishes the standby pool afterwards. + optional string mode = 2 [json_name = "mode"]; +} + +message InstanceGroupManagerStatus { + // Output only. Status of all-instances configuration on the group. + optional InstanceGroupManagerStatusAllInstancesConfig all_instances_config = 5 + [json_name = "allInstancesConfig"]; + + // Output only. The accelerator topology applied to this MIG. + // Currently only one accelerator topology is supported. + repeated InstanceGroupManagerStatusAcceleratorTopology + applied_accelerator_topologies = 6 + [json_name = "appliedAcceleratorTopologies"]; + + // Output only. The URL of theAutoscaler + // that targets this instance group manager. + optional string autoscaler = 1 [json_name = "autoscaler"]; + + // Output only. The status of bulk instance operation. + optional InstanceGroupManagerStatusBulkInstanceOperation + bulk_instance_operation = 7 [json_name = "bulkInstanceOperation"]; - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; + // Output only. The list of instance statuses and the number of instances + // in this managed instance group that have the status. Currently only shown + // for TPU MIGs + optional InstanceGroupManagerStatusInstanceStatusSummary + current_instance_statuses = 8 [json_name = "currentInstanceStatuses"]; + + // 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 InstanceGroupManagerStatusAcceleratorTopology { + // Output only. Topology in the format of: "16x16", "4x4x4", etc. + // The value is the same as configured in the WorkloadPolicy. + optional string accelerator_topology = 1 [json_name = "acceleratorTopology"]; + + // Output only. The state of the accelerator topology. + // ACTIVATING: The accelerator topology is being activated. + // ACTIVE: The accelerator topology is active. + // DEACTIVATING: The accelerator topology is being deactivated. + // FAILED: The accelerator topology failed. + // INCOMPLETE: The configuration is incomplete and the accelerator topology + // cannot + // be activated due to insufficient number of running VMs. + // REACTIVATING: The accelerator topology is being reactivated. + optional string state = 2 [json_name = "state"]; + + // Output only. The result of the latest accelerator topology state + // check. + optional + InstanceGroupManagerStatusAcceleratorTopologyAcceleratorTopologyStateDetails + state_details = 3 [json_name = "stateDetails"]; +} + +message +InstanceGroupManagerStatusAcceleratorTopologyAcceleratorTopologyStateDetails { + message Error { + message ErrorsItem { + // [Output Only] The error type identifier for this error. + optional string code = 1 [json_name = "code"]; + + message ErrorDetailsItem { + // Error information containing structured domain, reason, and metadata. + optional ErrorInfo error_info = 1 [json_name = "errorInfo"]; + + // Links and information to help the user resolve the error. + optional Help help = 2 [json_name = "help"]; + + // A localized human-readable error message intended for end users. + optional LocalizedMessage localized_message = 3 + [json_name = "localizedMessage"]; + + // Details about quota limits and metrics when a quota is exceeded. + 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"]; } - // Informational warning which replaces the list of firewall policies when the - // list is empty. - optional Warning warning = 2 [json_name = "warning"]; -} - -message NetworkFirewallPolicyAggregatedList { - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 1 [json_name = "id"]; - - // A list of FirewallPoliciesScopedList resources. - map items = 2 [json_name = "items"]; - - // [Output Only] Type of resource. Always - // compute#networkFirewallPoliciesAggregatedList for lists of network firewall - // policies. - 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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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. Encountered errors. + optional Error error = 1 [json_name = "error"]; + + // Output only. Timestamp is shown only if there is an error. The field + // has // RFC3339 // + // text format. + optional string timestamp = 2 [json_name = "timestamp"]; +} + +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"]; +} + +// Bulk instance operation is the creation of VMs in a MIG when the +// targetSizePolicy.mode is set to BULK. +message InstanceGroupManagerStatusBulkInstanceOperation { + // Output only. Informs whether bulk instance operation is in progress. + optional bool in_progress = 1 [json_name = "inProgress"]; + + // Output only. Information from the last progress check of bulk instance + // operation. + optional InstanceGroupManagerStatusBulkInstanceOperationLastProgressCheck + last_progress_check = 2 [json_name = "lastProgressCheck"]; +} + +message InstanceGroupManagerStatusBulkInstanceOperationLastProgressCheck { + message Error { + message ErrorsItem { + // [Output Only] The error type identifier for this error. + optional string code = 1 [json_name = "code"]; + + message ErrorDetailsItem { + // Error information containing structured domain, reason, and metadata. + optional ErrorInfo error_info = 1 [json_name = "errorInfo"]; + + // Links and information to help the user resolve the error. + optional Help help = 2 [json_name = "help"]; + + // A localized human-readable error message intended for end users. + optional LocalizedMessage localized_message = 3 + [json_name = "localizedMessage"]; + + // Details about quota limits and metrics when a quota is exceeded. + 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] 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 array of errors encountered while processing this + // operation. + repeated ErrorsItem errors = 1 [json_name = "errors"]; + } + + // Output only. Errors encountered during bulk instance operation. + optional Error error = 1 [json_name = "error"]; + + // Output only. Timestamp of the last progress check of bulk instance + // operation. Timestamp is in RFC3339 text format. + optional string timestamp = 2 [json_name = "timestamp"]; +} + +// The list of instance statuses and the number of instances in this managed +// instance group that have the status. For more information about how to +// interpret each status check the instance lifecycle documentation. +// Currently only shown for TPU MIGs. +message InstanceGroupManagerStatusInstanceStatusSummary { + // Output only. The number of instances in the managed instance group + // that have DEPROVISIONING status. + optional int32 deprovisioning = 1 [json_name = "deprovisioning"]; + + // Output only. The number of instances that have not been created yet or + // have been deleted. Includes only instances that would be shown in the + // listManagedInstances method and not all instances that have been + // deleted in the lifetime of the MIG. + // Does not include FlexStart instances that are waiting for the resources + // availability, they are considered as 'pending'. + optional int32 non_existent = 2 [json_name = "nonExistent"]; + + // Output only. The number of instances in the managed instance group + // that have PENDING status, that is FlexStart instances that are waiting + // for resources. Instances that do not exist because of the other reasons + // are counted as 'non_existent'. + optional int32 pending = 3 [json_name = "pending"]; + + // Output only. The number of instances in the managed instance group + // that have PENDING_STOP status. + optional int32 pending_stop = 4 [json_name = "pendingStop"]; + + // Output only. The number of instances in the managed instance group + // that have PROVISIONING status. + optional int32 provisioning = 5 [json_name = "provisioning"]; + + // Output only. The number of instances in the managed instance group + // that have REPAIRING status. + optional int32 repairing = 6 [json_name = "repairing"]; + + // Output only. The number of instances in the managed instance group + // that have RUNNING status. + optional int32 running = 7 [json_name = "running"]; + + // Output only. The number of instances in the managed instance group + // that have STAGING status. + optional int32 staging = 8 [json_name = "staging"]; + + // Output only. The number of instances in the managed instance group + // that have STOPPED status. + optional int32 stopped = 9 [json_name = "stopped"]; + + // Output only. The number of instances in the managed instance group + // that have STOPPING status. + optional int32 stopping = 10 [json_name = "stopping"]; + + // Output only. The number of instances in the managed instance group + // that have SUSPENDED status. + optional int32 suspended = 11 [json_name = "suspended"]; + + // Output only. The number of instances in the managed instance group + // that have SUSPENDING status. + optional int32 suspending = 12 [json_name = "suspending"]; + + // Output only. The number of instances in the managed instance group + // that have TERMINATED status. + optional int32 terminated = 13 [json_name = "terminated"]; +} + +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 { + // Output only. 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 byversion field on + // Instance Group Manager. + optional bool is_reached = 1 [json_name = "isReached"]; +} + +message InstanceGroupManagerTargetSizePolicy { + // The mode of target size policy based on which the MIG creates its VMs + // individually or all at once. + // BULK: The mode in which the MIG creates VMs all at once. In this mode, if + // the + // MIG is unable to create even one VM, the MIG waits until all VMs can be + // created at the same time. + // INDIVIDUAL: The mode in which the MIG creates VMs individually. In this + // mode, if + // the MIG is unable to create a VM, the MIG will continue to create the + // other VMs in the group. This is the default mode. + // UNSPECIFIED_MODE: If mode is unspecified, MIG will behave as in the default + // `INDIVIDUAL` + // mode. + optional string mode = 1 [json_name = "mode"]; +} + +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 + // specifiedtargetSize 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 ormaxUnavailable 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 formaxUnavailable is a fixed + // value equal to the number of zones + // in which the managed instance group operates. + // + // At least one of either maxSurge ormaxUnavailable 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 + // toREFRESH. 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 + // orOPPORTUNISTIC 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, runapplyUpdatesToInstances, or set the + // group'supdatePolicy.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 + // theinstanceTemplate. 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. ReadStarting + // 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"]; +} - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; +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. [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'stargetSize + // 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. [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. [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. [Output Only] Health state of the instance per health-check. + repeated ManagedInstanceInstanceHealth instance_health = 4 + [json_name = "instanceHealth"]; + + // Output only. [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. + // PENDING: For Flex Start provisioning instance is waiting for available + // capacity + // from Dynamic Workload Scheduler (DWS). + // PENDING_STOP: The instance is gracefully shutting down. + // 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. [Output Only] Information about the last attempt to create or + // delete + // the instance. + optional ManagedInstanceLastAttempt last_attempt = 6 + [json_name = "lastAttempt"]; + + // Output only. [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. [Output Only] Preserved state applied from per-instance config + // for this instance. + optional PreservedState preserved_state_from_config = 7 + [json_name = "preservedStateFromConfig"]; + + // Output only. [Output Only] Preserved state generated based on stateful + // policy + // for this instance. + optional PreservedState preserved_state_from_policy = 8 + [json_name = "preservedStateFromPolicy"]; + + // Output only. [Output Only] Instance properties selected for this instance + // resulting from + // InstanceFlexibilityPolicy. + optional ManagedInstancePropertiesFromFlexibilityPolicy + properties_from_flexibility_policy = 11 + [json_name = "propertiesFromFlexibilityPolicy"]; + + // Output only. Information about the termination timestamp of the instance, + // if applicable. + optional ManagedInstanceScheduling scheduling = 12 [json_name = "scheduling"]; + + // Output only. Specifies the graceful shutdown details if the instance is in + // `PENDING_STOP` state or there is a programmed stop scheduled. + optional ManagedInstanceShutdownDetails shutdown_details = 13 + [json_name = "shutdownDetails"]; + + // Output only. [Output Only] Intended version of this instance. + optional ManagedInstanceVersion version = 9 [json_name = "version"]; +} + +message ManagedInstanceInstanceHealth { + // Output only. [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. [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 { + // Error information containing structured domain, reason, and metadata. + optional ErrorInfo error_info = 1 [json_name = "errorInfo"]; + + // Links and information to help the user resolve the error. + optional Help help = 2 [json_name = "help"]; + + // A localized human-readable error message intended for end users. + optional LocalizedMessage localized_message = 3 + [json_name = "localizedMessage"]; + + // Details about quota limits and metrics when a quota is exceeded. + 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 message. - optional Warning warning = 7 [json_name = "warning"]; + // Output only. [Output Only] Encountered errors during the last attempt to + // create or + // delete the instance. + optional Errors errors = 1 [json_name = "errors"]; +} + +message ManagedInstancePropertiesFromFlexibilityPolicy { + // Output only. The machine type to be used for this instance. + optional string machine_type = 1 [json_name = "machineType"]; +} + +message ManagedInstanceScheduling { + // Output only. The timestamp at which the underlying instance will be + // triggered for graceful shutdown if it is configured. This is in RFC3339 + // text format. + optional string graceful_shutdown_timestamp = 1 + [json_name = "gracefulShutdownTimestamp"]; + + // Output only. The timestamp at which the managed instance will be + // terminated. This is + // in RFC3339 text + // format. + optional string termination_timestamp = 2 + [json_name = "terminationTimestamp"]; +} + +message ManagedInstanceShutdownDetails { + // Output only. The duration for graceful shutdown. Only applicable when the + // instance is + // in `PENDING_STOP` state. + optional Duration max_duration = 1 [json_name = "maxDuration"]; + + // Output only. Past timestamp indicating the beginning of `PENDING_STOP` + // state of + // instance in RFC3339 + // text format. + optional string request_timestamp = 2 [json_name = "requestTimestamp"]; +} + +message ManagedInstanceVersion { + // Output only. [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. [Output Only] Name of the version. + optional string name = 2 [json_name = "name"]; +} + +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 inREAD_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_038.proto b/protos/google/cloud/compute/v1/internal/common_038.proto index 8f9f41864ce97..360bbd82def34 100644 --- a/protos/google/cloud/compute/v1/internal/common_038.proto +++ b/protos/google/cloud/compute/v1/internal/common_038.proto @@ -15,222 +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: 20250601 +// revision: 20260807 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"]; - - // A list of packet mirroring rules that belong to this policy. - repeated FirewallPolicyRule packet_mirroring_rules = 16 - [json_name = "packetMirroringRules"]; - - // [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 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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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"]; +// 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_039.proto b/protos/google/cloud/compute/v1/internal/common_039.proto index 0452b3f6de645..9f691be4910d7 100644 --- a/protos/google/cloud/compute/v1/internal/common_039.proto +++ b/protos/google/cloud/compute/v1/internal/common_039.proto @@ -15,200 +15,776 @@ // 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: 20250601 +// revision: 20260807 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"]; - - // Network type of the traffic destination. Allowed values are: - UNSPECIFIED - // - INTERNET - NON_INTERNET - // INTERNET: - // INTRA_VPC: - // NON_INTERNET: - // UNSPECIFIED: - // VPC_NETWORKS: - optional string dest_network_type = 13 [json_name = "destNetworkType"]; - - // 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"]; - - // Network type of the traffic source. Allowed values are: - UNSPECIFIED - - // INTERNET - INTRA_VPC - NON_INTERNET - VPC_NETWORKS - // INTERNET: - // INTRA_VPC: - // NON_INTERNET: +import "google/cloud/compute/v1/internal/common_043.proto"; +import "google/cloud/compute/v1/internal/common_048.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. [Output Only] Type of resource. + // Alwayscompute#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 thanmaxResults, use the + // nextPageToken as a value 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. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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, readVirtual 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 aCIDR 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 inAuto mode VPC network IP ranges. + // + // For custom mode VPC networks, you can add subnets using the + // subnetworksinsert + // method. + optional bool auto_create_subnetworks = 2 + [json_name = "autoCreateSubnetworks"]; + + // Output only. [Output Only] Creation timestamp inRFC3339 + // 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. [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. [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. [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 withRFC1035. + // 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"]; + + // A full or partial URL of the network profile to apply to this network. + // This field can be set only at resource creation time. For example, the + // following are valid URLs: + // + // - + // https://www.googleapis.com/compute/{api_version}/projects/{project_id}/global/networkProfiles/{network_profile_name} + // - projects/{project_id}/global/networkProfiles/{network_profile_name} + optional string network_profile = 19 [json_name = "networkProfile"]; + + // Input only. [Input Only] Additional params passed with the request, but not + // persisted + // as part of resource payload. + optional NetworkParams params = 20 [json_name = "params"]; + + // Output only. [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. [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. [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 thanmaxResults, use the + // nextPageToken as a value 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. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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 network parameters. +message NetworkParams { + // Tag keys/values directly bound to this resource. + // Tag keys and values have the same definition as resource + // manager tags. The field is allowed for INSERT + // only. The keys/values to set on the resource should be specified in + // either ID { : } or Namespaced format + // { : }. + // For example the following are valid inputs: + // * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} + // * {"123/environment" : "production", "345/abc" : "xyz"} + // Note: + // * Invalid combinations of ID & namespaced format is not supported. For + // instance: {"123/environment" : "tagValues/444"} is invalid. + map resource_manager_tags = 1 + [json_name = "resourceManagerTags"]; +} + +// 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 theexchange_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 isACTIVE. + optional bool auto_create_routes = 1 [json_name = "autoCreateRoutes"]; + + // Output only. [Output Only] The effective state of the peering connection + // as a whole. + optional NetworkPeeringConnectionStatus connection_status = 13 + [json_name = "connectionStatus"]; + + // 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 isACTIVE. + 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 withRFC1035. + // 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"]; + + // Output only. [Output Only] Maximum Transmission Unit in bytes of the peer + // network. + 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. [Output Only] State for the peering. + // 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. [Output Only] Details about the current state of the peering. + optional string state_details = 12 [json_name = "stateDetails"]; + + // The update strategy determines the semantics for updates and deletes to the + // peering connection configuration. + // CONSENSUS: Updates are reflected in the local peering but aren't applied to + // the + // peering connection until a complementary change is made to the + // matching peering. + // To delete a peering with the consensus update strategy, both the peerings + // must request the deletion of the peering before the peering can be + // deleted. + // INDEPENDENT: In this mode, changes to the peering configuration can + // be unilaterally altered by changing either side of the peering. + // This is the default value if the field is unspecified. + // UNSPECIFIED: Peerings with update strategy UNSPECIFIED are created with + // update strategy INDEPENDENT. + optional string update_strategy = 14 [json_name = "updateStrategy"]; +} + +// [Output Only] Describes the state of a peering connection, not just the +// local peering. This field provides information about the effective settings +// for the connection as a whole, including pending delete/update requests for +// CONSENSUS peerings. +message NetworkPeeringConnectionStatus { + // The consensus state contains information about the status of update + // and delete for a consensus peering connection. + optional NetworkPeeringConnectionStatusConsensusState consensus_state = 1 + [json_name = "consensusState"]; + + // The active connectivity settings for the peering connection based on the + // settings of the network peerings. + optional NetworkPeeringConnectionStatusTrafficConfiguration + traffic_configuration = 2 [json_name = "trafficConfiguration"]; + + // The update strategy determines the update/delete semantics for this + // peering connection. + // CONSENSUS: Updates are reflected in the local peering but aren't applied to + // the + // peering connection until a complementary change is made to the + // matching peering. + // To delete a peering with the consensus update strategy, both the peerings + // must request the deletion of the peering before the peering can be + // deleted. + // INDEPENDENT: In this mode, changes to the peering configuration can + // be unilaterally altered by changing either side of the peering. + // This is the default value if the field is unspecified. + // UNSPECIFIED: Peerings with update strategy UNSPECIFIED are created with + // update strategy INDEPENDENT. + optional string update_strategy = 3 [json_name = "updateStrategy"]; +} + +// The status of update/delete for a consensus peering connection. Only set +// when connection_status.update_strategy isCONSENSUS or a network peering is +// proposing to update the +// strategy to CONSENSUS. +message NetworkPeeringConnectionStatusConsensusState { + // The status of the delete request. + // DELETE_ACKNOWLEDGED: Both network admins have agreed this consensus peering + // connection can + // be deleted. + // DELETE_STATUS_UNSPECIFIED: + // LOCAL_CANCEL_REQUESTED: The local network admin requested to cancel their + // delete request + // after DELETE_ACKNOWLEDGED. + // LOCAL_DELETE_REQUESTED: Network admin has requested deletion of this + // peering connection. + // PEER_CANCEL_REQUESTED: The peer network admin requested to cancel their + // delete request after + // DELETE_ACKNOWLEDGED. + // PEER_DELETE_REQUESTED: The peer network admin has requested deletion of + // this peering + // connection. + optional string delete_status = 1 [json_name = "deleteStatus"]; + + // The status of the update request. + // IN_SYNC: No pending configuration update proposals to the peering + // connection. + // PENDING_LOCAL_ACKNOWLEDMENT: The peer network admin has made an + // updatePeering call. The change is + // awaiting acknowledgment from this peering's network admin. + // PENDING_PEER_ACKNOWLEDGEMENT: The local network admin has made an + // updatePeering call. The change + // is awaiting acknowledgment from the peer network admin. + // UPDATE_STATUS_UNSPECIFIED: + optional string update_status = 2 [json_name = "updateStatus"]; +} + +message NetworkPeeringConnectionStatusTrafficConfiguration { + // Whether custom routes are being exported to the peer network. + optional bool export_custom_routes_to_peer = 1 + [json_name = "exportCustomRoutesToPeer"]; + + // Whether subnet routes with public IP ranges are being exported to the + // peer network. + optional bool export_subnet_routes_with_public_ip_to_peer = 2 + [json_name = "exportSubnetRoutesWithPublicIpToPeer"]; + + // Whether custom routes are being imported from the peer network. + optional bool import_custom_routes_from_peer = 3 + [json_name = "importCustomRoutesFromPeer"]; + + // Whether subnet routes with public IP ranges are being imported + // from the peer network. + optional bool import_subnet_routes_with_public_ip_from_peer = 4 + [json_name = "importSubnetRoutesWithPublicIpFromPeer"]; + + // Which IP version(s) of traffic and routes are being imported or + // exported between peer networks. + // 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 = 5 [json_name = "stackType"]; +} + +// 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 { + // Enable comparison of Multi-Exit Discriminators (MED) across routes with + // different neighbor ASNs when using the STANDARD BGP best path selection + // algorithm. + optional bool bgp_always_compare_med = 2 [json_name = "bgpAlwaysCompareMed"]; + + // The BGP best path selection algorithm to be employed within this network + // for dynamic routes learned by Cloud Routers. Can be LEGACY + // (default) or STANDARD. + // LEGACY: + // STANDARD: + optional string bgp_best_path_selection_mode = 3 + [json_name = "bgpBestPathSelectionMode"]; + + // Allows to define a preferred approach for handling inter-region cost in + // the selection process when using the STANDARD BGP best path + // selection algorithm. Can be DEFAULT orADD_COST_TO_MED. + // ADD_COST_TO_MED: + // DEFAULT: + optional string bgp_inter_region_cost = 4 [json_name = "bgpInterRegionCost"]; + + // Output only. [Output Only] Effective value of the bgp_always_compare_med + // field. + optional bool effective_bgp_always_compare_med = 5 + [json_name = "effectiveBgpAlwaysCompareMed"]; + + // Output only. [Output Only] Effective value of the bgp_inter_region_cost + // field. + // ADD_COST_TO_MED: + // DEFAULT: + optional string effective_bgp_inter_region_cost = 6 + [json_name = "effectiveBgpInterRegionCost"]; + + // 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 toGLOBAL, 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. Useexchange_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 isACTIVE. + 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 NetworksCancelRequestRemovePeeringRequest { + // Name of the peering, which should conform to RFC1035. + optional string name = 1 [json_name = "name"]; +} + +message NetworksGetEffectiveFirewallsResponse { + // [Output Only] Effective firewalls from firewall policy. It returns Global + // Network Firewall Policies and Hierarchical Firewall Policies. + // UseregionNetworkFirewallPolicies.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. [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. [Output Only] The name of the firewall policy. + optional string name = 2 [json_name = "name"]; + + // Output only. [Output Only] The packet mirroring rules that apply to the + // network. + repeated FirewallPolicyRule packet_mirroring_rules = 7 + [json_name = "packetMirroringRules"]; + + // Output only. [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. [Output Only] The short name of the firewall policy. + optional string short_name = 4 [json_name = "shortName"]; + + // Output only. [Output Only] The type of the firewall policy. + // HIERARCHY: + // NETWORK: + // SYSTEM: // UNSPECIFIED: - // VPC_NETWORKS: - optional string src_network_type = 14 [json_name = "srcNetworkType"]; - - // Networks of the traffic source. It can be either a full or partial url. - repeated string src_networks = 15 [json_name = "srcNetworks"]; - - // 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 type = 5 [json_name = "type"]; +} + +message NetworksRemovePeeringRequest { + // Name of the peering, which should conform to RFC1035. optional string name = 1 [json_name = "name"]; +} + +message NetworksRequestRemovePeeringRequest { + // Name of the peering, which should conform to RFC1035. + 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"]; +message NetworksUpdatePeeringRequest { + optional NetworkPeering network_peering = 1 [json_name = "networkPeering"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_040.proto b/protos/google/cloud/compute/v1/internal/common_040.proto index 92b2408a630f6..7991d2d85cae6 100644 --- a/protos/google/cloud/compute/v1/internal/common_040.proto +++ b/protos/google/cloud/compute/v1/internal/common_040.proto @@ -15,26 +15,58 @@ // 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: 20250601 +// revision: 20260807 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"]; +// 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"]; - // Specifies a fixed number of VM instances. This must be a positive integer. - optional int32 fixed = 2 [json_name = "fixed"]; + // 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"]; - // Specifies a percentage of instances between 0 to 100%, inclusive. For - // example, specify 80 for 80%. - optional int32 percent = 3 [json_name = "percent"]; + // 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_041.proto b/protos/google/cloud/compute/v1/internal/common_041.proto index fed8754a4557e..675c108dae48e 100644 --- a/protos/google/cloud/compute/v1/internal/common_041.proto +++ b/protos/google/cloud/compute/v1/internal/common_041.proto @@ -15,448 +15,232 @@ // 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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_082.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"]; +// 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. [Output Only] Creation timestamp inRFC3339 + // 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 = 8 [json_name = "description"]; + optional string description = 2 [json_name = "description"]; - // Specifies the canary migration state for the backend buckets attached to - // this forwarding rule. Possible values are PREPARE, TEST_BY_PERCENTAGE, and - // TEST_ALL_TRAFFIC. To begin the migration from EXTERNAL to EXTERNAL_MANAGED, - // the state must be changed to PREPARE. The state must be changed to - // TEST_ALL_TRAFFIC before the loadBalancingScheme can be changed to - // EXTERNAL_MANAGED. Optionally, the TEST_BY_PERCENTAGE state can be used to - // migrate traffic to backend buckets attached to this forwarding rule by - // percentage using externalManagedBackendBucketMigrationTestingPercentage. - // Rolling back a migration requires the states to be set in reverse order. So - // changing the scheme from EXTERNAL_MANAGED to EXTERNAL requires the state to - // be set to TEST_ALL_TRAFFIC at the same time. Optionally, the - // TEST_BY_PERCENTAGE state can be used to migrate some traffic back to - // EXTERNAL or PREPARE can be used to migrate all traffic back to EXTERNAL. - // PREPARE: - // TEST_ALL_TRAFFIC: - // TEST_BY_PERCENTAGE: - optional string external_managed_backend_bucket_migration_state = 36 - [json_name = "externalManagedBackendBucketMigrationState"]; - - // Determines the fraction of requests to backend buckets that should be - // processed by the global external Application Load Balancer. The value of - // this field must be in the range [0, 100]. This value can only be set if the - // loadBalancingScheme in the BackendService is set to EXTERNAL (when using - // the classic Application Load Balancer) and the migration state is - // TEST_BY_PERCENTAGE. - optional float external_managed_backend_bucket_migration_testing_percentage = - 37 [json_name = "externalManagedBackendBucketMigrationTestingPercentage"]; - - // 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 + // Output only. [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 + 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. [Output Only] Type of the resource. + // Alwayscompute#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 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. + // up-to-date fingerprint hash in order to update or change labels, + // otherwise the request will fail with error412 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 + // thesetLabels method. Each label key/value pair must comply withRFC1035. + // 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 withRFC1035. // 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"]; - - // [Output Only] Server-defined URL for this resource with the resource id. - optional string self_link_with_id = 38 [json_name = "selfLinkWithId"]; - - // 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"]; + // 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"]; + + // Input only. [Input Only] Additional params passed with the request, but not + // persisted + // as part of resource payload. + optional ExternalVpnGatewayParams params = 11 [json_name = "params"]; + + // 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. [Output Only] Server-defined URL for the resource. + optional string self_link = 10 [json_name = "selfLink"]; +} - // 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"]; +// 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"]; } -// Contains a list of ForwardingRule resources. -message ForwardingRuleList { +// 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 = 1 [json_name = "id"]; + optional string id = 2 [json_name = "id"]; - // A list of ForwardingRule resources. - repeated ForwardingRule items = 2 [json_name = "items"]; + // A list of ExternalVpnGateway resources. + repeated ExternalVpnGateway items = 3 [json_name = "items"]; - // Type of resource. - optional string kind = 3 [json_name = "kind"]; + // Output only. [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 + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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"]; + // Output only. [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. + // [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. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -465,19 +249,27 @@ message ForwardingRuleList { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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. @@ -485,23 +277,24 @@ 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"]; - - // 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"]; +message ExternalVpnGatewayParams { + // Tag keys/values directly bound to this resource. + // Tag keys and values have the same definition as resource + // manager tags. The field is allowed for INSERT + // only. The keys/values to set on the resource should be specified in + // either ID { : } or Namespaced format + // { : }. + // For example the following are valid inputs: + // * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} + // * {"123/environment" : "production", "345/abc" : "xyz"} + // Note: + // * Invalid combinations of ID & namespaced format is not supported. For + // instance: {"123/environment" : "tagValues/444"} is invalid. + // * Inconsistent format is not supported. For instance: + // {"tagKeys/333" : "tagValues/444", "123/env" : "prod"} is invalid. + map resource_manager_tags = 1 + [json_name = "resourceManagerTags"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_042.proto b/protos/google/cloud/compute/v1/internal/common_042.proto index 89f712b505057..3fd9823ec20bc 100644 --- a/protos/google/cloud/compute/v1/internal/common_042.proto +++ b/protos/google/cloud/compute/v1/internal/common_042.proto @@ -15,213 +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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_041.proto"; +message FileContentBuffer { + // The raw content in the secure keys file. + optional string content = 1 [json_name = "content"]; -message ForwardingRuleAggregatedList { - // [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"]; - - // [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 - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value 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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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"]; + // The file type of source file. + // BIN: + // UNDEFINED: + // X509: + optional string file_type = 2 [json_name = "fileType"]; } -message ForwardingRulesScopedList { - // A list of forwarding rules contained in this scope. - repeated ForwardingRule forwarding_rules = 1 [json_name = "forwardingRules"]; - - 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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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"]; - // Informational warning which replaces the list of forwarding rules when the - // list is empty. - optional Warning warning = 2 [json_name = "warning"]; + // The Platform Key (PK). + optional FileContentBuffer pk = 4 [json_name = "pk"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_043.proto b/protos/google/cloud/compute/v1/internal/common_043.proto index 23b356ac17f38..672f68ff7b4a0 100644 --- a/protos/google/cloud/compute/v1/internal/common_043.proto +++ b/protos/google/cloud/compute/v1/internal/common_043.proto @@ -15,576 +15,231 @@ // 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: 20250601 +// revision: 20260807 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"]; - - // 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 Firewall Rule resource. +// +// Firewall rules allow or deny ingress traffic to, and egress traffic from your +// instances. For more information, readFirewall 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"]; + } -// 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"]; + // 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 3339 text format. + // Output only. [Output Only] Creation timestamp inRFC3339 + // 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"]; + 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"]; + } - optional HTTPSHealthCheck https_health_check = 8 - [json_name = "httpsHealthCheck"]; + // 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"]; - // [Output Only] The unique identifier for the resource. This identifier is + // 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 inCIDR 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. [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"]; + optional string id = 8 [json_name = "id"]; + + // Output only. [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 withRFC1035. + // 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"]; + + // Input only. [Input Only] Additional params passed with the request, but not + // persisted + // as part of resource payload. + optional FirewallParams params = 20 [json_name = "params"]; + + // 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"]; - // 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"]; + // 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 inCIDR 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 thesourceTags 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 + // assourceServiceAccounts. + // 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 + // insourceServiceAccount. The connection does not need to match + // both fields for the firewall to apply.sourceServiceAccounts cannot be used + // at the same time assourceTags 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 + // inallowed[].targetServiceAccounts cannot be used at the same time + // astargetTags 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"]; } -// 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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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. +// 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"]; -} - -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"]; + // 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"]; } -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"]; +// Additional firewall parameters. +message FirewallParams { + // Tag keys/values directly bound to this resource. + // Tag keys and values have the same definition as resource + // manager tags. The field is allowed for INSERT + // only. The keys/values to set on the resource should be specified in + // either ID { : } or Namespaced format + // { : }. + // For example the following are valid inputs: + // * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} + // * {"123/environment" : "production", "345/abc" : "xyz"} + // Note: + // * Invalid combinations of ID & namespaced format is not supported. For + // instance: {"123/environment" : "tagValues/444"} is invalid. + map resource_manager_tags = 1 + [json_name = "resourceManagerTags"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_044.proto b/protos/google/cloud/compute/v1/internal/common_044.proto index e69ce7c0fdf81..a4e4f9cd2e4fe 100644 --- a/protos/google/cloud/compute/v1/internal/common_044.proto +++ b/protos/google/cloud/compute/v1/internal/common_044.proto @@ -15,22 +15,140 @@ // 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: 20250601 +// revision: 20260807 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"]; - - // 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"]; +import "google/cloud/compute/v1/internal/common_043.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. [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 thanmaxResults, use the + // nextPageToken as a value 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. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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_045.proto b/protos/google/cloud/compute/v1/internal/common_045.proto index 72c255facfbcb..17de854e3f0eb 100644 --- a/protos/google/cloud/compute/v1/internal/common_045.proto +++ b/protos/google/cloud/compute/v1/internal/common_045.proto @@ -15,22 +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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_012.proto"; +import "google/cloud/compute/v1/internal/common_009.proto"; +import "google/cloud/compute/v1/internal/common_047.proto"; -message GlobalNetworkEndpointGroupsAttachEndpointsRequest { - // The list of network endpoints to be attached. - repeated NetworkEndpoint network_endpoints = 1 - [json_name = "networkEndpoints"]; +message FirewallPoliciesListAssociationsResponse { + // A list of associations. + repeated FirewallPolicyAssociation associations = 1 + [json_name = "associations"]; + + // Output only. [Output Only] Type of firewallPolicy associations. + // Alwayscompute#FirewallPoliciesListAssociations for lists of + // firewallPolicy associations. + optional string kind = 2 [json_name = "kind"]; } -message GlobalNetworkEndpointGroupsDetachEndpointsRequest { - // The list of network endpoints to be detached. - repeated NetworkEndpoint network_endpoints = 1 - [json_name = "networkEndpoints"]; +message GlobalOrganizationSetPolicyRequest { + // 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"]; + + // 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_046.proto b/protos/google/cloud/compute/v1/internal/common_046.proto index 58403ab88c0a2..fb2e3864f6037 100644 --- a/protos/google/cloud/compute/v1/internal/common_046.proto +++ b/protos/google/cloud/compute/v1/internal/common_046.proto @@ -15,23 +15,256 @@ // 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: 20250601 +// revision: 20260807 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"]; +import "google/cloud/compute/v1/internal/common_047.proto"; + +message FirewallPoliciesScopedList { + // A list of firewall policies contained in this scope. + repeated FirewallPolicy firewall_policies = 1 + [json_name = "firewallPolicies"]; + + 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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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 firewall policies when + // the list is empty. + optional Warning warning = 2 [json_name = "warning"]; +} + +message NetworkFirewallPolicyAggregatedList { + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 1 [json_name = "id"]; + + // A list of FirewallPoliciesScopedList resources. + map items = 2 [json_name = "items"]; + + // Output only. [Output Only] Type of resource. + // Alwayscompute#networkFirewallPoliciesAggregatedList for lists of + // network firewall policies. + 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 thanmaxResults, use the + // nextPageToken as a value 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. [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + // Output only. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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_047.proto b/protos/google/cloud/compute/v1/internal/common_047.proto index 755239e7ed713..b8cbb3fc654df 100644 --- a/protos/google/cloud/compute/v1/internal/common_047.proto +++ b/protos/google/cloud/compute/v1/internal/common_047.proto @@ -15,25 +15,261 @@ // 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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_007.proto"; +import "google/cloud/compute/v1/internal/common_048.proto"; -message GlobalSetPolicyRequest { - // Flatten Policy to create a backward compatible wire-format. Deprecated. Use - // 'policy' to specify bindings. - repeated Binding bindings = 1 [json_name = "bindings"]; +// Represents a Firewall Policy resource. +message FirewallPolicy { + // A list of associations that belong to this firewall policy. + repeated FirewallPolicyAssociation associations = 1 + [json_name = "associations"]; - // 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. [Output Only] Creation timestamp inRFC3339 + // text format. + optional string creation_timestamp = 2 [json_name = "creationTimestamp"]; - // 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"]; + // 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 error412 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. [Output only] Type of the resource. + // Alwayscompute#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"]; + + // A list of packet mirroring rules that belong to this policy. + repeated FirewallPolicyRule packet_mirroring_rules = 16 + [json_name = "packetMirroringRules"]; + + // Output only. [Output Only] The parent of the firewall policy. + // This field is not applicable to network firewall policies. + optional string parent = 9 [json_name = "parent"]; + + // The type of the firewall policy. This field can be one of + // VPC_POLICY, RDMA_ROCE_POLICY or ULL_POLICY. + // + // Note: if not specified then VPC_POLICY will be used. + // RDMA_ROCE_POLICY: + // ULL_POLICY: + // VPC_POLICY: + optional string policy_type = 17 [json_name = "policyType"]; + + // Output only. [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. [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. [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 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. [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. [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. [Output Only] Type of resource. + // Alwayscompute#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 thanmaxResults, use the + // nextPageToken as a value 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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_048.proto b/protos/google/cloud/compute/v1/internal/common_048.proto index 898ea946589c9..3f11dd6edda36 100644 --- a/protos/google/cloud/compute/v1/internal/common_048.proto +++ b/protos/google/cloud/compute/v1/internal/common_048.proto @@ -15,35 +15,276 @@ // 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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_146.proto"; - -// Maintenance Info for ReservationBlocks. -message GroupMaintenanceInfo { - // Progress for ongoing maintenance for this group of VMs/hosts. Describes - // number of hosts in the block that have ongoing maintenance. - optional int32 maintenance_ongoing_count = 1 - [json_name = "maintenanceOngoingCount"]; - - // Progress for ongoing maintenance for this group of VMs/hosts. Describes - // number of hosts in the block that have pending maintenance. - optional int32 maintenance_pending_count = 2 - [json_name = "maintenancePendingCount"]; - - // The type of maintenance for the reservation. - // GROUPED: Maintenance on all reserved instances in the reservation is - // synchronized. - // GROUP_MAINTENANCE_TYPE_UNSPECIFIED: Unknown maintenance type. - // INDEPENDENT: Maintenance is not synchronized for this reservation. Instead, - // each instance has its own maintenance window. - optional string scheduling_type = 3 [json_name = "schedulingType"]; - - // Maintenance information on this group of VMs. - optional UpcomingMaintenance upcoming_group_maintenance = 4 - [json_name = "upcomingGroupMaintenance"]; +// 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" ( + // "apply_security_profile_group" can be specified only for global + // network firewall policies or hierarchical firewall policies). + // 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. [Output only] Type of the resource. + // Returnscompute#firewallPolicyRule for firewall rules + // andcompute#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. [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 SecurityProfileGroup 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. Can be specified only + // for global network firewall policies or hierarchical firewall policies. + optional string security_profile_group = 14 + [json_name = "securityProfileGroup"]; + + // A list of forwarding rules to which this rule applies. + // This field allows you to control which load balancers get this rule. + // For example, the following are valid values: + // + // + // - + // https://www.googleapis.com/compute/v1/projects/project/global/forwardingRules/forwardingRule + // - + // https://www.googleapis.com/compute/v1/projects/project/regions/region/forwardingRules/forwardingRule + // - projects/project/global/ + // forwardingRules/forwardingRule + // - projects/project/regions/region/forwardingRules/ + // forwardingRule + repeated string target_forwarding_rules = 16 + [json_name = "targetForwardingRules"]; + + // 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 astargetServiceAccounts. + // If neither targetServiceAccounts nortargetSecureTag 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"]; + + // Target types of the firewall policy rule. + // Default value is INSTANCES. + // INSTANCES: + // INTERNAL_MANAGED_LB: + optional string target_type = 17 [json_name = "targetType"]; + + // 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"]; + + // Network context of the traffic destination. Allowed values are: + // + // + // - UNSPECIFIED + // - INTERNET + // - NON_INTERNET + // INTERNET: + // INTRA_VPC: + // NON_INTERNET: + // UNSPECIFIED: + // VPC_NETWORKS: + optional string dest_network_context = 16 [json_name = "destNetworkContext"]; + + // Network type of the traffic destination. Allowed values are: + // + // + // - UNSPECIFIED + // - INTERNET + // - NON_INTERNET + // INTERNET: + // INTRA_VPC: + // NON_INTERNET: + // UNSPECIFIED: + // VPC_NETWORKS: + optional string dest_network_type = 13 [json_name = "destNetworkType"]; + + // 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"]; + + // Network context of the traffic source. Allowed values are: + // + // + // - UNSPECIFIED + // - INTERNET + // - INTRA_VPC + // - NON_INTERNET + // - VPC_NETWORKS + // INTERNET: + // INTRA_VPC: + // NON_INTERNET: + // UNSPECIFIED: + // VPC_NETWORKS: + optional string src_network_context = 17 [json_name = "srcNetworkContext"]; + + // Network type of the traffic source. Allowed values are: + // + // + // - UNSPECIFIED + // - INTERNET + // - INTRA_VPC + // - NON_INTERNET + // - VPC_NETWORKS + // INTERNET: + // INTRA_VPC: + // NON_INTERNET: + // UNSPECIFIED: + // VPC_NETWORKS: + optional string src_network_type = 14 [json_name = "srcNetworkType"]; + + // Networks of the traffic source. It can be either a full or partial url. + repeated string src_networks = 15 [json_name = "srcNetworks"]; + + // 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. [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_049.proto b/protos/google/cloud/compute/v1/internal/common_049.proto index 7a8e40d593794..d8b713ba879dc 100644 --- a/protos/google/cloud/compute/v1/internal/common_049.proto +++ b/protos/google/cloud/compute/v1/internal/common_049.proto @@ -15,17 +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: 20250601 +// revision: 20260807 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"]; +// 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_050.proto b/protos/google/cloud/compute/v1/internal/common_050.proto index d1b7c84dc7443..20f4ef0acaaa8 100644 --- a/protos/google/cloud/compute/v1/internal/common_050.proto +++ b/protos/google/cloud/compute/v1/internal/common_050.proto @@ -15,177 +15,634 @@ // 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: 20250601 +// revision: 20260807 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"]; +import "google/cloud/compute/v1/internal/common_097.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 andvalidateForProxyless is + // set to true, theIPAddress 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 + // inhttps://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 IP address can only be set at creation. Once set, it cannot be updated. + // + // 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. + // + // When creating a global external Passthrough Network Load Balancer + // forwarding rule (a parent forwarding rule), you must use theIPAddresses + // field, but the Google Cloud generated child + // forwarding rules set the IPAddress field instead. Refer to + // theavailabilityGroup field for further details. + 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 andL3_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 requiresallPorts 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"]; + + // Output only. [Output Only]. The extensions that are attached to this + // ForwardingRule. + repeated ForwardingRuleAttachedExtension attached_extensions = 39 + [json_name = "attachedExtensions"]; + + // Identifies the backend service to which the forwarding rule sends traffic. + // + // It is a required field for the following load balancers: + // + // - Internal passthrough Network Load Balancers + // - Backend service-based regional external passthrough Network Load + // Balancers + // - Global external passthrough Network Load Balancers + // + // + // + // It cannot be set by other load balancer types and protocol forwarding + // rules. + optional string backend_service = 5 [json_name = "backendService"]; + + // Output only. [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. [Output Only] Creation timestamp inRFC3339 + // 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 = 2 [json_name = "description"]; + optional string description = 8 [json_name = "description"]; + + // Specifies the canary migration state for the backend buckets attached to + // this forwarding rule. Possible values are PREPARE, TEST_BY_PERCENTAGE, and + // TEST_ALL_TRAFFIC. + // + // To begin the migration from EXTERNAL to EXTERNAL_MANAGED, the state must be + // changed to PREPARE. The state must be changed to TEST_ALL_TRAFFIC before + // the loadBalancingScheme can be changed to EXTERNAL_MANAGED. Optionally, the + // TEST_BY_PERCENTAGE state can be used to migrate traffic to backend buckets + // attached to this forwarding rule by percentage using + // externalManagedBackendBucketMigrationTestingPercentage. + // + // Rolling back a migration requires the states to be set in reverse order. So + // changing the scheme from EXTERNAL_MANAGED to EXTERNAL requires the state to + // be set to TEST_ALL_TRAFFIC at the same time. Optionally, the + // TEST_BY_PERCENTAGE state can be used to migrate some traffic back to + // EXTERNAL or PREPARE can be used to migrate all traffic back to EXTERNAL. + // PREPARE: + // TEST_ALL_TRAFFIC: + // TEST_BY_PERCENTAGE: + optional string external_managed_backend_bucket_migration_state = 36 + [json_name = "externalManagedBackendBucketMigrationState"]; + + // Determines the fraction of requests to backend buckets that should be + // processed by the global external Application Load Balancer. + // + // The value of this field must be in the range [0, 100]. + // + // This value can only be set if the loadBalancingScheme in the BackendService + // is set to EXTERNAL (when using the classic Application Load Balancer) and + // the migration state is TEST_BY_PERCENTAGE. + optional float external_managed_backend_bucket_migration_testing_percentage = + 37 [json_name = "externalManagedBackendBucketMigrationTestingPercentage"]; // 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"]; + // 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 = 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"]; + 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 + // inhttps://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 aPacketMirroring + // rule applies to them. + // This can only be set to true for load balancers that have + // theirloadBalancingScheme set to INTERNAL. + optional bool is_mirroring_collector = 12 + [json_name = "isMirroringCollector"]; + + // Output only. [Output Only] Type of the resource. + // Alwayscompute#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 error412 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 + // thesetLabels method. Each label key/value pair must comply withRFC1035. + // Label values may be empty. + map labels = 15 [json_name = "labels"]; + + // Specifies the forwarding rule type. + // + // For more information, refer to + // Forwarding rule product and scheme table. + // 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 itsfilterMatchCriteria is set to + // MATCH_ANY, at least one of thefilterLabels 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 multiplemetadataFilters + // 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 thisForwardingRule references. + // + // metadataFilters only applies to Loadbalancers that have + // their loadBalancingScheme set toINTERNAL_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 withRFC1035. + // 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. + // + // For global external Passthrough Network Load Balancer forwarding rules, the + // forwarding rule name must be 1-43 characters long. For each global external + // Passthrough Network Load Balancer forwarding rule (a parent forwarding + // rule) that you create, Google Cloud generates two output-only child + // forwarding rules that are named by concatenating the parent forwarding rule + // name with the `-ag0` and `-ag1` suffixes, respectively. Refer to + // theavailabilityGroup field for further details. + 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 andSTANDARD. For + // GlobalForwardingRule, the valid value isPREMIUM. + // + // 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 (specified inIPAddress, IPAddresses, + // IPProtocol + // fields) if they 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 (specified inIPAddress, IPAddresses, + // IPProtocol + // fields) 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. [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 = 12 [json_name = "selfLink"]; + optional string self_link = 27 [json_name = "selfLink"]; + + // Output only. [Output Only] Server-defined URL for this resource with the + // resource id. + optional string self_link_with_id = 38 [json_name = "selfLinkWithId"]; + + // 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 withRFC1035. + // 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 + // isEXTERNAL. + // 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. + // + // + // + // The following load balancers cannot set the target field (they should set + // the backendService field instead): + // + // - Internal passthrough Network Load Balancers + // - Backend service-based regional external passthrough Network Load + // Balancers + // - Global external passthrough Network Load Balancers + optional string target = 33 [json_name = "target"]; } -message HealthCheckServicesList { +// Reference to an extension resource that is attached to this ForwardingRule. +message ForwardingRuleAttachedExtension { + // Output only. The resource name. + optional string reference = 1 [json_name = "reference"]; +} + +// 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 HealthCheckService resources. - repeated HealthCheckService items = 2 [json_name = "items"]; + // A list of ForwardingRule resources. + repeated ForwardingRule items = 2 [json_name = "items"]; - // [Output Only] Type of the resource. Always compute#healthCheckServicesList - // for lists of HealthCheckServices. + // Output only. 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 + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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. + // Output only. [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. + // [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. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -194,19 +651,27 @@ message HealthCheckServicesList { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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. @@ -216,3 +681,21 @@ message HealthCheckServicesList { // [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_051.proto b/protos/google/cloud/compute/v1/internal/common_051.proto index 5ca9408ad391d..5565a1781ad9f 100644 --- a/protos/google/cloud/compute/v1/internal/common_051.proto +++ b/protos/google/cloud/compute/v1/internal/common_051.proto @@ -15,93 +15,107 @@ // 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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_043.proto"; +import "google/cloud/compute/v1/internal/common_050.proto"; -message HealthChecksAggregatedList { +message ForwardingRuleAggregatedList { // [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 ForwardingRulesScopedList resources. + map items = 2 [json_name = "items"]; - // Type of resource. + // Output only. [Output Only] Type of resource. + // Alwayscompute#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 - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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. + // Output only. [Output Only] Server-defined URL for this resource. optional string self_link = 5 [json_name = "selfLink"]; - // [Output Only] Unreachable resources. + // Output only. [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. + // [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. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -110,19 +124,27 @@ message HealthChecksAggregatedList { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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. @@ -133,66 +155,78 @@ message HealthChecksAggregatedList { 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 ForwardingRulesScopedList { + // A list of forwarding rules contained in this scope. + repeated ForwardingRule forwarding_rules = 1 [json_name = "forwardingRules"]; 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. + // [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. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -201,26 +235,34 @@ message HealthChecksScopedList { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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. + // 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_052.proto b/protos/google/cloud/compute/v1/internal/common_052.proto index 4b6923db1c4dc..d40e3d8cff357 100644 --- a/protos/google/cloud/compute/v1/internal/common_052.proto +++ b/protos/google/cloud/compute/v1/internal/common_052.proto @@ -15,64 +15,855 @@ // 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: 20250601 +// revision: 20260807 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"]; - - 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"]; +import "google/cloud/compute/v1/internal/common_007.proto"; +import "google/cloud/compute/v1/internal/common_038.proto"; +import "google/cloud/compute/v1/internal/common_134.proto"; +import "google/cloud/compute/v1/internal/common_144.proto"; +import "google/cloud/compute/v1/internal/common_156.proto"; + +message FutureReservation { + // Aggregate reservation details for the future reservation. + optional AllocationAggregateReservation aggregate_reservation = 1 + [json_name = "aggregateReservation"]; + + // 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 = 2 + [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 = 3 + [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 = 4 + [json_name = "autoDeleteAutoCreatedReservations"]; + + // If not present, then FR will not deliver a new commitment or update an + // existing commitment. + optional FutureReservationCommitmentInfo commitment_info = 5 + [json_name = "commitmentInfo"]; + + // CONFIDENTIAL_COMPUTE_TYPE_TDX: Intel Trust Domain Extensions. + // CONFIDENTIAL_COMPUTE_TYPE_UNSPECIFIED: + optional string confidential_compute_type = 6 + [json_name = "confidentialComputeType"]; + + // Output only. [Output Only] The creation timestamp for this future + // reservation inRFC3339 + // text format. + optional string creation_timestamp = 7 [json_name = "creationTimestamp"]; + + // Type of the deployment requested as part of future reservation. + // DENSE: The reserved capacity is made up of densely deployed reservation + // blocks. + // DEPLOYMENT_TYPE_UNSPECIFIED: + optional string deployment_type = 8 [json_name = "deploymentType"]; + + // An optional description of this resource. Provide this property when you + // create the future reservation. + optional string description = 9 [json_name = "description"]; + + // Indicates if this group of VMs have emergent maintenance enabled. + optional bool enable_emergent_maintenance = 10 + [json_name = "enableEmergentMaintenance"]; + + // Output only. [Output Only] A unique identifier for this future reservation. + // The server + // defines this identifier. + optional string id = 11 [json_name = "id"]; + + // Output only. [Output Only] Type of the resource. + // Alwayscompute#futureReservation for future reservations. + optional string kind = 12 [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 + // withRFC1035. + // 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"]; + + // 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 = 14 [json_name = "namePrefix"]; + + // Input only. Additional params passed with the request, but not persisted + // as part of resource payload. + optional FutureReservationParams params = 15 [json_name = "params"]; + + // 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 = 16 [json_name = "planningStatus"]; + + // The reservation mode which determines reservation-termination behavior and + // expected pricing. + // CALENDAR: The delivered reservations will delivered at specified start time + // and + // terminated at specified end time along with terminating the VMs running + // on it. + // DEFAULT: The delivered reservations do not terminate VMs at the end of + // reservations. This is default mode. + // RESERVATION_MODE_UNSPECIFIED: + optional string reservation_mode = 17 [json_name = "reservationMode"]; + + // Name of reservations where the capacity is provisioned at the time of + // delivery of future reservations. If the reservation with the given name + // does not exist already, it is created automatically at the time of Approval + // with INACTIVE state till specified start-time. Either provide the + // reservation_name or a name_prefix. + optional string reservation_name = 18 [json_name = "reservationName"]; + + // Output only. Contains standard resource metadata for an FutureReservation + // resource. It is populated for each instance of the FutureReservation + // resource, and includes the api_version the + // instance was retrieved through, and its canonical + // resource_type name. + optional ResourceMetadata resource_metadata = 19 + [json_name = "resourceMetadata"]; + + // Name of the resource intended to be delivered. Name should conform to + // RFC1035. This will be the name of storage pool or Exapool for persistent + // disk FRs. + optional string resource_name = 20 [json_name = "resourceName"]; + + // Maintenance information for this reservation + // GROUPED: Maintenance on all reserved instances in the reservation is + // synchronized. + // GROUP_MAINTENANCE_TYPE_UNSPECIFIED: Unknown maintenance type. + // INDEPENDENT: Maintenance is not synchronized for this reservation. Instead, + // each + // instance has its own maintenance window. + optional string scheduling_type = 21 [json_name = "schedulingType"]; + + // Output only. [Output Only] Server-defined fully-qualified URL for this + // resource. + optional string self_link = 22 [json_name = "selfLink"]; + + // Output only. [Output Only] Server-defined URL for this resource with the + // resource id. + optional string self_link_with_id = 23 [json_name = "selfLinkWithId"]; + + // List of Projects/Folders to share with. + optional ShareSettings share_settings = 24 [json_name = "shareSettings"]; + + // Indicates whether the auto-created 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 the delivered reservation. + optional bool specific_reservation_required = 25 + [json_name = "specificReservationRequired"]; + + // Future Reservation configuration to indicate instance properties and + // total count. + optional FutureReservationSpecificSKUProperties specific_sku_properties = 26 + [json_name = "specificSkuProperties"]; + + // Output only. [Output only] Status of the Future Reservation + optional FutureReservationStatus status = 27 [json_name = "status"]; + + // Storage pool details for the future reservation. + optional FutureReservationStoragePoolProperties storage_pool_properties = 28 + [json_name = "storagePoolProperties"]; + + // Time window for this Future Reservation. + optional FutureReservationTimeWindow time_window = 29 + [json_name = "timeWindow"]; + + // Output only. [Output Only] URL of the Zone where this future reservation + // resides. + optional string zone = 30 [json_name = "zone"]; +} + +message FutureReservationCommitmentInfo { + // name of the commitment where capacity is being delivered to. + optional string commitment_name = 1 [json_name = "commitmentName"]; + + // Indicates if a Commitment needs to be created as part of FR delivery. If + // this field is not present, then no + // commitment needs to be created. + // INVALID: + // THIRTY_SIX_MONTH: + // TWELVE_MONTH: + optional string commitment_plan = 2 [json_name = "commitmentPlan"]; + + // Only applicable if FR is delivering to the same reservation. If set, all + // parent commitments will be extended to match the end date of the plan for + // this commitment. + // EXTEND: All associated parent Committed Used Discount(s) end-date/term will + // be + // extended to the end-time of this future reservation. Default is to + // extend previous commitment(s) time to the end_time of the reservation. + // PREVIOUSCOMMITMENTTERM_UNSPECIFIED: No changes to associated parents + // Committed Used Discount(s) terms. + optional string previous_commitment_terms = 3 + [json_name = "previousCommitmentTerms"]; +} + +// Additional future reservation params. +message FutureReservationParams { + // Input only. Resource manager tags to be bound to the future reservation. + // Tag keys and + // values have the same definition as resource + // manager tags. Keys and values can be either in numeric format, + // such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in + // namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and + // `{tag_value_short_name}`. The field is ignored (both PUT & + // PATCH) when empty. + map resource_manager_tags = 1 + [json_name = "resourceManagerTags"]; +} + +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. [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"]; + + // Output only. Fully qualified urls of the automatically created reservations + // at + // start_time. + repeated string auto_created_reservations = 2 + [json_name = "autoCreatedReservations"]; + + // Output only. Exapool provisioned capacities for each SKU type. + optional StoragePoolExapoolProvisionedCapacityGb + exapool_provisioned_capacity_gb = 3 + [json_name = "exapoolProvisionedCapacityGb"]; + + // Output only. [Output Only] Represents the existing matching usage for the + // future + // reservation. + optional FutureReservationStatusExistingMatchingUsageInfo + existing_matching_usage_info = 4 + [json_name = "existingMatchingUsageInfo"]; + + // Output only. 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 = 5 [json_name = "fulfilledCount"]; + + // Output only. [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 = 6 + [json_name = "lastKnownGoodState"]; + + // Output only. 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 = 7 [json_name = "lockTime"]; + + // Output only. 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 = 8 [json_name = "procurementStatus"]; + + optional FutureReservationStatusSpecificSKUProperties + specific_sku_properties = 9 [json_name = "specificSkuProperties"]; + + // Output only. Storage pool provisioned capacities for each SKU type. + optional FutureReservationStoragePoolProvisionedCapacity + storage_pool_provisioned_capacity = 10 + [json_name = "storagePoolProvisionedCapacity"]; +} + +// [Output Only] Represents the existing matching usage for the future +// reservation. +message FutureReservationStatusExistingMatchingUsageInfo { + // Output only. Count to represent min(FR total_count, + // matching_reserved_capacity+matching_unreserved_instances) + optional string count = 1 [json_name = "count"]; + + // Output only. 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. [Output Only] The description of the FutureReservation before + // an + // amendment was requested. + optional string description = 1 [json_name = "description"]; + + // Output only. [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. [Output Only] The lock time of the FutureReservation before an + // amendment was requested. + optional string lock_time = 4 [json_name = "lockTime"]; + + // Output only. [Output Only] The name prefix of the Future Reservation before + // an + // amendment was requested. + optional string name_prefix = 5 [json_name = "namePrefix"]; + + // Output only. [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. [Output Only] The previous share settings of the Future + // Reservation. + optional ShareSettings share_settings = 1 [json_name = "shareSettings"]; + + // Output only. [Output Only] The previous instance related properties of the + // Future Reservation. + optional FutureReservationSpecificSKUProperties specific_sku_properties = 2 + [json_name = "specificSkuProperties"]; + + // Output only. [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"]; +} + +// Storage pool properties for the future reservation. +message FutureReservationStoragePoolProperties { + // Requested exapool provisioned capacity in GiB. + optional StoragePoolExapoolProvisionedCapacityGb + requested_exapool_provisioned_capacity_gb = 1 + [json_name = "requestedExapoolProvisionedCapacityGb"]; + + // Requested storage pool provisioned capacity. + optional FutureReservationStoragePoolProvisionedCapacity + requested_storage_pool_provisioned_capacity = 2 + [json_name = "requestedStoragePoolProvisionedCapacity"]; + + // Type of the storage pool. + optional string storage_pool_type = 3 [json_name = "storagePoolType"]; +} + +// Storage pool provisioned capacities for each SKU type. +message FutureReservationStoragePoolProvisionedCapacity { + // Size of the storage pool in GiB. + optional string pool_provisioned_capacity_gb = 1 + [json_name = "poolProvisionedCapacityGb"]; + + // Provisioned IOPS of the storage pool. Only relevant if the storage pool + // type is hyperdisk-balanced. + optional string pool_provisioned_iops = 2 [json_name = "poolProvisionedIops"]; + + // Provisioned throughput of the storage pool in MiB/s. Only relevant if + // the storage pool type is hyperdisk-balanced or hyperdisk-throughput. + optional string pool_provisioned_throughput = 3 + [json_name = "poolProvisionedThroughput"]; +} + +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. [Output Only] Type of resource. + // Alwayscompute#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 thanmaxResults, use the + // nextPageToken as a value 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. [Output Only] Server-defined URL for this resource. + optional string self_link = 6 [json_name = "selfLink"]; + + // Output only. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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. [Output Only] Type of + // resource.Alwayscompute#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 thanmaxResults, use the + // nextPageToken as a value 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. [Output Only] Server-defined URL for this resource. + optional string self_link = 6 [json_name = "selfLink"]; + + // Output only. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_053.proto b/protos/google/cloud/compute/v1/internal/common_053.proto index ec1b5eef34d53..d46e21461a4ee 100644 --- a/protos/google/cloud/compute/v1/internal/common_053.proto +++ b/protos/google/cloud/compute/v1/internal/common_053.proto @@ -15,153 +15,550 @@ // 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: 20250601 +// revision: 20260807 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 { +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"]; + + // 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 theport 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 GRPCTLSHealthCheck { + // 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"]; + + // 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"]; + + // 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 theport 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"]; +} + +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 through65535. + 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 theport 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 withRFC3986. + 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 through65535. + 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 theport 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 withRFC3986. + 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 through65535. + 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 theport 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 withRFC3986. + 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](https://cloud.google.com/compute/docs/reference/rest/v1/regionHealthChecks) +// * +// [Global](https://cloud.google.com/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, seeHealth 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 RFC3339 text format. + // Output only. [Output Only] Creation timestamp in3339 + // 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"]; + optional GRPCHealthCheck grpc_health_check = 4 + [json_name = "grpcHealthCheck"]; - // 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 GRPCTLSHealthCheck grpc_tls_health_check = 21 + [json_name = "grpcTlsHealthCheck"]; + + // 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 = 6 [json_name = "id"]; + optional string id = 9 [json_name = "id"]; + + // Output only. Type of the resource. + optional string kind = 10 [json_name = "kind"]; - // [Output Only] Type of the resource. Always compute#httpHealthCheck for HTTP - // health checks. - optional string kind = 7 [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. - // 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"]; + // The name must be 1-63 characters long, and comply withRFC1035. + // 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. [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 = 11 [json_name = "selfLink"]; + 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, GRPC, and GRPC_WITH_TLS 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 = 12 [json_name = "timeoutSec"]; + // 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, + // GRPC or GRPC_WITH_TLS. + // Exactly one of the protocol-specific health check fields must be specified, + // which must match type field. + // GRPC: + // GRPC_WITH_TLS: + // 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 = 13 [json_name = "unhealthyThreshold"]; + optional int32 unhealthy_threshold = 19 [json_name = "unhealthyThreshold"]; } -// Contains a list of HttpHealthCheck resources. -message HttpHealthCheckList { +// 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 HttpHealthCheck resources. - repeated HttpHealthCheck items = 2 [json_name = "items"]; + // A list of HealthCheck resources. + repeated HealthCheck items = 2 [json_name = "items"]; - // Type of resource. + // Output only. 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 + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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. + // Output only. [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. + // [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. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -170,19 +567,27 @@ message HttpHealthCheckList { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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. @@ -192,3 +597,136 @@ message HttpHealthCheckList { // [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 through65535. + 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 theport 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 through65535. + 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 theport 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"]; +} diff --git a/protos/google/cloud/compute/v1/internal/common_054.proto b/protos/google/cloud/compute/v1/internal/common_054.proto index d1e48a08cc616..15f8770516b30 100644 --- a/protos/google/cloud/compute/v1/internal/common_054.proto +++ b/protos/google/cloud/compute/v1/internal/common_054.proto @@ -15,180 +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: 20250601 +// revision: 20260807 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"]; - - // [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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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 GlobalAddressesMoveRequest { + // An optional destination address description if intended to be different + // from the source. + optional string description = 1 [json_name = "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. + optional string destination_address = 2 [json_name = "destinationAddress"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_055.proto b/protos/google/cloud/compute/v1/internal/common_055.proto index 183cc6fb6d313..3a676ca1bd049 100644 --- a/protos/google/cloud/compute/v1/internal/common_055.proto +++ b/protos/google/cloud/compute/v1/internal/common_055.proto @@ -15,218 +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: 20250601 +// revision: 20260807 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_033.proto"; +import "google/cloud/compute/v1/internal/common_015.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"]; - } - - // 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"]; +message GlobalNetworkEndpointGroupsAttachEndpointsRequest { + // The list of network endpoints to be attached. + repeated NetworkEndpoint network_endpoints = 1 + [json_name = "networkEndpoints"]; +} - // Cloud Storage bucket storage location of the image (regional or - // multi-regional). - repeated string storage_locations = 32 [json_name = "storageLocations"]; +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_056.proto b/protos/google/cloud/compute/v1/internal/common_056.proto index c160a065d89a7..3a0e093741130 100644 --- a/protos/google/cloud/compute/v1/internal/common_056.proto +++ b/protos/google/cloud/compute/v1/internal/common_056.proto @@ -15,16 +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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_055.proto"; +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 error412 conditionNotMet. + // Make a get() request to the + // resource to get the latest fingerprint. + optional string label_fingerprint = 1 [json_name = "labelFingerprint"]; -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"]; + // 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_057.proto b/protos/google/cloud/compute/v1/internal/common_057.proto index 7815e467ca652..20cf8eeadd0e1 100644 --- a/protos/google/cloud/compute/v1/internal/common_057.proto +++ b/protos/google/cloud/compute/v1/internal/common_057.proto @@ -15,118 +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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_055.proto"; +import "google/cloud/compute/v1/internal/common_009.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"]; +message GlobalSetPolicyRequest { + // Flatten Policy to create a backward compatible wire-format. + // Deprecated. Use 'policy' to specify bindings. + repeated Binding bindings = 1 [json_name = "bindings"]; - // A list of Image resources. - repeated Image items = 2 [json_name = "items"]; + // Flatten Policy to create a backward compatible wire-format. + // Deprecated. Use 'policy' to specify the etag. + optional string etag = 2 [json_name = "etag"]; - // 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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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_058.proto b/protos/google/cloud/compute/v1/internal/common_058.proto index 1a36fa04e69c1..9d6725f0f51cb 100644 --- a/protos/google/cloud/compute/v1/internal/common_058.proto +++ b/protos/google/cloud/compute/v1/internal/common_058.proto @@ -15,221 +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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -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_078.proto"; -import "google/cloud/compute/v1/internal/common_120.proto"; -import "google/cloud/compute/v1/internal/common_146.proto"; +import "google/cloud/compute/v1/internal/common_175.proto"; -message InstanceConsumptionData { - // Resources consumed by the instance. - optional InstanceConsumptionInfo consumption_info = 1 - [json_name = "consumptionInfo"]; +// Message describing GlobalVmExtensionPolicy object. +message GlobalVmExtensionPolicy { + // Output only. [Output Only] Creation timestamp inRFC3339 + // text format. + optional string creation_timestamp = 1 [json_name = "creationTimestamp"]; - // 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"]; + // An optional description of this resource. Provide this property when you + // create the resource. + optional string description = 2 [json_name = "description"]; - // The amount of local SSD storage available to the instance, defined in GiB. - optional int32 local_ssd_gb = 2 [json_name = "localSsdGb"]; + // Required. Map from extension (eg: "cloudops") to its policy configuration. + // The key is the name of the extension. + map extension_policies = 3 + [json_name = "extensionPolicies"]; - // The amount of physical memory available to the instance, defined in MiB. - optional int32 memory_mb = 3 [json_name = "memoryMb"]; + // Output only. [Output Only] The unique identifier for the resource. This + // identifier is + // defined by the server. + optional string id = 4 [json_name = "id"]; - // The minimal guaranteed number of virtual CPUs that are reserved. - optional int32 min_node_cpus = 4 [json_name = "minNodeCpus"]; -} + // Optional. Selector to target VMs for a policy. + // There is a logical "AND" between instance_selectors. + repeated GlobalVmExtensionPolicyInstanceSelector instance_selectors = 5 + [json_name = "instanceSelectors"]; -// 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. [Output Only] Type of the resource. + // Alwayscompute#globalVmExtensionPolicy for globalVmExtensionPolicies. + optional string kind = 6 [json_name = "kind"]; - // [Output Only] Creation timestamp in RFC3339 text format. - optional string creation_timestamp = 2 [json_name = "creationTimestamp"]; + // Name of the resource. Provided by the client when the resource is created. + // The name must be 1-63 characters long, and comply withRFC1035. + // 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"]; - // An optional description of this resource. Provide this property when you - // create the resource. - optional string description = 3 [json_name = "description"]; + // Optional. Used to resolve conflicts when multiple policies are active for + // the same + // extension. Defaults to 0. + // + // Larger the number, higher the priority. When the priority is the same, + // the policy with the newer create time has higher priority. + optional int32 priority = 8 [json_name = "priority"]; + + // Required. The rollout strategy and status. + optional GlobalVmExtensionPolicyRolloutOperation rollout_operation = 9 + [json_name = "rolloutOperation"]; + + // Output only. [Output Only] The scoped resource status. It's only for + // tracking the + // purging status of the policy. + // SCOPED_RESOURCE_STATUS_DELETING: The zonal policies are being deleted. + // SCOPED_RESOURCE_STATUS_UNSPECIFIED: Default value. This value is unused. + optional string scoped_resource_status = 10 + [json_name = "scopedResourceStatus"]; + + // Output only. [Output Only] Server-defined fully-qualified URL for this + // resource. + optional string self_link = 11 [json_name = "selfLink"]; + + // Output only. [Output Only] Server-defined URL for this resource's resource + // id. + optional string self_link_with_id = 12 [json_name = "selfLinkWithId"]; + + // Output only. [Output Only] Update timestamp inRFC3339 + // text format. + optional string update_timestamp = 13 [json_name = "updateTimestamp"]; +} - optional string fingerprint = 4 [json_name = "fingerprint"]; +// Policy for a single extension. +message GlobalVmExtensionPolicyExtensionPolicy { + // Optional. The version pinning for the extension. + // If empty, the extension will be installed with the latest version + // released by the extension producer. + optional string pinned_version = 1 [json_name = "pinnedVersion"]; - // [Output Only] The unique identifier for the resource. This identifier is - // defined by the server. - optional string id = 5 [json_name = "id"]; + // Optional. String configuration. Any string payload that the extension + // understands. + optional string string_config = 2 [json_name = "stringConfig"]; +} - // [Output Only] The type of the resource. Always compute#nodeGroup for node - // group. - optional string kind = 6 [json_name = "kind"]; +// Selector to target VMs for a zone VM extension policy. +message GlobalVmExtensionPolicyInstanceSelector { + // Optional. Labels within the LabelSelector are OR'd. + optional GlobalVmExtensionPolicyLabelSelector label_selector = 1 + [json_name = "labelSelector"]; +} - // 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"]; +// A LabelSelector is applicable for a VM only if it matches all labels in +// the LabelSelector. +message GlobalVmExtensionPolicyLabelSelector { + // Optional. Labels as key value pairs. + // A VM should contain all the pairs specified in this map to be selected; + // Labels within the LabelSelector are OR'ed. + map inclusion_labels = 1 [json_name = "inclusionLabels"]; } -message NodeGroupAggregatedList { +// Response to list global VM extension policy resources. +message GlobalVmExtensionPolicyList { + 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 NodeGroupsScopedList resources. - map items = 2 [json_name = "items"]; + // A list of GlobalVmExtensionPolicy resources. + repeated GlobalVmExtensionPolicy items = 3 [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. 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 + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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"]; + // Output only. [Output Only] Server-defined URL for this resource. + optional string self_link = 6 [json_name = "selfLink"]; - // [Output Only] Unreachable resources. - repeated string unreachables = 6 [json_name = "unreachables"]; + // Output only. [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. + // [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. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -238,19 +225,27 @@ message NodeGroupAggregatedList { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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. @@ -258,104 +253,198 @@ message NodeGroupAggregatedList { } // [Output Only] Informational warning message. - optional Warning warning = 7 [json_name = "warning"]; + optional Warning warning = 8 [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"]; +// Represents the rollout operation +message GlobalVmExtensionPolicyRolloutOperation { + // Required. The rollout input which defines the rollout plan. + optional GlobalVmExtensionPolicyRolloutOperationRolloutInput rollout_input = 1 + [json_name = "rolloutInput"]; + + // Output only. [Output Only] The rollout status of the policy. + optional GlobalVmExtensionPolicyRolloutOperationRolloutStatus rollout_status = + 2 [json_name = "rolloutStatus"]; } -// 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"]; +message GlobalVmExtensionPolicyRolloutOperationRolloutInput { + // Optional. Specifies the behavior of the rollout if a conflict is detected + // in a + // project during a rollout. This only applies to `insert` and `update` + // methods. + // + // A conflict occurs in the following cases: + // + // * `insert` method: If the zonal policy already exists when the insert + // happens. + // * `update` method: If the zonal policy was modified by a zonal API call + // outside of this rollout. + // + // Possible values are the following: + // + // * `""` (empty string): If a conflict occurs, the local value is not + // overwritten. This is the default behavior. + // * `"overwrite"`: If a conflict occurs, the local value is overwritten + // with the rollout value. + optional string conflict_behavior = 1 [json_name = "conflictBehavior"]; + + // Optional. The name of the rollout plan. + // Ex. + // projects//locations/global/rolloutPlans/. + optional string name = 2 [json_name = "name"]; + + // Optional. Specifies the predefined rollout plan for the policy. Valid + // values + // are `SLOW_ROLLOUT` and `FAST_ROLLOUT`. The recommended value is + // `SLOW_ROLLOUT` for progressive rollout. For more information, see Rollout + // plans for global policies. + // FAST_ROLLOUT: + // ROLLOUT_PLAN_UNSPECIFIED: + // SLOW_ROLLOUT: + optional string predefined_rollout_plan = 3 + [json_name = "predefinedRolloutPlan"]; + + // Optional. The UUID that identifies a policy rollout retry attempt for + // update and + // delete operations. Set this field only when retrying a rollout for an + // existing extension policy. + // + // * `update` method: Lets you retry policy rollout without changes. + // An error occurs if you set retry_uuid but the policy is modified. + // * `delete` method: Lets you retry policy deletion rollout if the + // previous deletion rollout is not finished and the policy is in the + // DELETING state. If you set this field when the policy is not in the + // DELETING state, an error occurs. + optional string retry_uuid = 4 [json_name = "retryUuid"]; +} - // A list of NodeGroup resources. - repeated NodeGroup items = 2 [json_name = "items"]; +message GlobalVmExtensionPolicyRolloutOperationRolloutStatus { + // Output only. [Output Only] The current rollouts for the latest version of + // the + // resource. There should be only one current rollout, but for + // scalability, we make it repeated. + repeated GlobalVmExtensionPolicyRolloutOperationRolloutStatusRolloutMetadata + current_rollouts = 1 [json_name = "currentRollouts"]; + + // Output only. [Output Only] The last completed rollout resource. This field + // will not + // be populated until the first rollout is completed. + optional GlobalVmExtensionPolicyRolloutOperationRolloutStatusRolloutMetadata + previous_rollout = 2 [json_name = "previousRollout"]; +} - // [Output Only] Type of resource.Always compute#nodeGroupList for lists of - // node groups. - optional string kind = 3 [json_name = "kind"]; +message GlobalVmExtensionPolicyRolloutOperationRolloutStatusRolloutMetadata { + // Output only. [Output Only] The rollout status for each location. The list + // of the + // locations is the same as the list of locations in the rollout plan. + map + location_rollout_status = 1 [json_name = "locationRolloutStatus"]; + + // Output only. [Output Only] The name of the rollout. + // Ex. projects//locations/global/rollouts/. + optional string rollout = 2 [json_name = "rollout"]; + + // Output only. [Output Only] The name of the rollout plan. + // Ex. + // projects//locations/global/rolloutPlans/. + optional string rollout_plan = 3 [json_name = "rolloutPlan"]; + + // Output only. [Output Only] The overall state of the rollout. + // STATE_CANCELLED: Iteration was explicitly cancelled. + // STATE_COMPLETED: Iteration completed, with all actions being successful. + // STATE_FAILED: Iteration completed, with failures. + // STATE_PAUSED: The rollout is paused. + // STATE_PROCESSING: Iteration is in progress. + // STATE_UNKNOWN: Impossible to determine current state of the iteration. + // STATE_UNSPECIFIED: Default value. This value is unused. + optional string state = 4 [json_name = "state"]; +} - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value 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 +GlobalVmExtensionPolicyRolloutOperationRolloutStatusRolloutMetadataLocationRolloutStatus { + // Output only. [Output Only] The state of the location rollout. + // LOCATION_ROLLOUT_STATE_COMPLETED: The location rollout is completed. + // LOCATION_ROLLOUT_STATE_FAILED: The location rollout has failed. + // LOCATION_ROLLOUT_STATE_NOT_STARTED: The location rollout has not started. + // LOCATION_ROLLOUT_STATE_SKIPPED: The location rollout is skipped. + // LOCATION_ROLLOUT_STATE_UNSPECIFIED: Default value. This value is unused. + optional string state = 1 [json_name = "state"]; +} - // [Output Only] Server-defined URL for this resource. - optional string self_link = 5 [json_name = "selfLink"]; +message VmExtensionPoliciesScopedList { + // List of VmExtensionPolicy resources contained in this scope. + repeated VmExtensionPolicy vm_extension_policies = 1 + [json_name = "vmExtensionPolicies"]; 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. + // [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. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -364,285 +453,135 @@ message NodeGroupList { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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"]; + // Informational warning which replaces the list of + // backend services when the list is empty. + optional Warning warning = 2 [json_name = "warning"]; } -message NodeGroupsDeleteNodesRequest { - // Names of the nodes to delete. - repeated string nodes = 1 [json_name = "nodes"]; -} +// Response for the aggregated list of VM extension policies. +message VmExtensionPolicyAggregatedListResponse { + optional string etag = 1 [json_name = "etag"]; -message NodeGroupsListNodes { // [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 Node resources. - repeated NodeGroupNode items = 2 [json_name = "items"]; + // A list of VmExtensionPoliciesScopedList resources. + map items = 3 [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. [Output Only] Type of resource. + // Alwayscompute#VmExtensionPolicyAggregatedList for lists of + // VmExtensionPolicies. + 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 + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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 string next_page_token = 5 [json_name = "nextPageToken"]; - 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. [Output Only] Server-defined URL for this resource. + optional string self_link = 6 [json_name = "selfLink"]; - // [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"]; + // Output only. [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. + // [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. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -651,37 +590,33 @@ message NodeGroupsScopedList { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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"]; + // [Output Only] Informational warning message. + optional Warning warning = 8 [json_name = "warning"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_059.proto b/protos/google/cloud/compute/v1/internal/common_059.proto index b9718d6c3c9a4..fb3bec403cf78 100644 --- a/protos/google/cloud/compute/v1/internal/common_059.proto +++ b/protos/google/cloud/compute/v1/internal/common_059.proto @@ -15,106 +15,58 @@ // 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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_083.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"]; - - // Optional. 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_173.proto"; + +// Maintenance Info for ReservationBlocks. +message GroupMaintenanceInfo { + // Describes number of instances that have ongoing maintenance. + optional int32 instance_maintenance_ongoing_count = 5 + [json_name = "instanceMaintenanceOngoingCount"]; + + // Describes number of instances that have pending maintenance. + optional int32 instance_maintenance_pending_count = 6 + [json_name = "instanceMaintenancePendingCount"]; + + // Progress for ongoing maintenance for this group of VMs/hosts. + // Describes number of hosts in the block that have ongoing maintenance. + optional int32 maintenance_ongoing_count = 1 + [json_name = "maintenanceOngoingCount"]; + + // Progress for ongoing maintenance for this group of VMs/hosts. + // Describes number of hosts in the block that have pending maintenance. + optional int32 maintenance_pending_count = 2 + [json_name = "maintenancePendingCount"]; + + // The type of maintenance for the reservation. + // GROUPED: Maintenance on all reserved instances in the reservation is + // synchronized. + // GROUP_MAINTENANCE_TYPE_UNSPECIFIED: Unknown maintenance type. + // INDEPENDENT: Maintenance is not synchronized for this reservation. Instead, + // each + // instance has its own maintenance window. + optional string scheduling_type = 3 [json_name = "schedulingType"]; + + // Describes number of subblock Infrastructure that has ongoing maintenance. + // Here, Subblock Infrastructure Maintenance pertains to upstream hardware + // contained in the Subblock that is necessary for a VM Family(e.g. NVLink + // Domains). Not all VM Families will support this field. + optional int32 subblock_infra_maintenance_ongoing_count = 7 + [json_name = "subblockInfraMaintenanceOngoingCount"]; + + // Describes number of subblock Infrastructure that has pending maintenance. + // Here, Subblock Infrastructure Maintenance pertains to upstream hardware + // contained in the Subblock that is necessary for a VM Family (e.g. NVLink + // Domains). Not all VM Families will support this field. + optional int32 subblock_infra_maintenance_pending_count = 8 + [json_name = "subblockInfraMaintenancePendingCount"]; + + // Maintenance information on this group of VMs. + optional UpcomingMaintenance upcoming_group_maintenance = 4 + [json_name = "upcomingGroupMaintenance"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_060.proto b/protos/google/cloud/compute/v1/internal/common_060.proto index 852cf28719a20..3b2fa0b9f571d 100644 --- a/protos/google/cloud/compute/v1/internal/common_060.proto +++ b/protos/google/cloud/compute/v1/internal/common_060.proto @@ -15,97 +15,85 @@ // 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: 20250601 +// revision: 20260807 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_083.proto"; - -message InstanceGroupAggregatedList { - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 1 [json_name = "id"]; - - // A list of InstanceGroupsScopedList resources. - map items = 2 [json_name = "items"]; - - // [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 - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value 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 HealthAggregationPoliciesScopedList { + // A list of HealthAggregationPolicys contained in this scope. + repeated HealthAggregationPolicy health_aggregation_policies = 1 + [json_name = "healthAggregationPolicies"]; 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. + // [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. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -114,107 +102,225 @@ message InstanceGroupAggregatedList { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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"]; + // Informational warning which replaces the list of health aggregation + // policies when the list is empty. + optional Warning warning = 2 [json_name = "warning"]; } -// A list of InstanceGroup resources. -message InstanceGroupList { +// Represents a health aggregation policy. +// +// A health aggregation policy resource defines a policy to aggregate health. +// +// For more information, see +// Health checks overview. +message HealthAggregationPolicy { + // Output only. [Output Only] Creation timestamp inRFC3339 + // 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 HealthAggregationPolicy. An up-to-date fingerprint + // must be provided in order to patch the HealthAggregationPolicy; Otherwise, + // the request will fail with error 412 conditionNotMet. To see + // the latest fingerprint, make a get() request to retrieve the + // HealthAggregationPolicy. + optional string fingerprint = 3 [json_name = "fingerprint"]; + + // Can only be set if the policyType field isBACKEND_SERVICE_POLICY. Specifies + // the threshold (as a + // percentage) of healthy endpoints required in order to consider the + // aggregated health result HEALTHY. Defaults to 60. Must be in + // range [0, 100]. Not applicable if the policyType field + // isDNB_PUBLIC_IP_POLICY. Can be mutated. This field is optional, + // and will be set to the default if unspecified. Note that both this + // threshold and minHealthyThreshold must be satisfied in order + // for HEALTHY to be the aggregated result. "Endpoints" refers to network + // endpoints within a Network Endpoint Group or instances within an Instance + // Group. + optional uint32 healthy_percent_threshold = 4 + [json_name = "healthyPercentThreshold"]; + + // Output only. [Output Only] The unique identifier for the resource. This + // identifier is + // defined by the server. + optional string id = 5 [json_name = "id"]; + + // Output only. [Output Only] Type of the resource. + // Alwayscompute#healthAggregationPolicy for health aggregation + // policies. + optional string kind = 6 [json_name = "kind"]; + + // Can only be set if the policyType field isBACKEND_SERVICE_POLICY. Specifies + // the minimum number of + // healthy endpoints required in order to consider the aggregated health + // result HEALTHY. Defaults to 1. Must be positive. Not + // applicable if the policyType field isDNB_PUBLIC_IP_POLICY. Can be mutated. + // This field is optional, + // and will be set to the default if unspecified. Note that both this + // threshold and healthyPercentThreshold must be satisfied in + // order for HEALTHY to be the aggregated result. "Endpoints" refers to + // network endpoints within a Network Endpoint Group or instances within an + // Instance Group. + optional uint32 min_healthy_threshold = 7 [json_name = "minHealthyThreshold"]; + + // Name of the resource. Provided by the client when the resource is created. + // The name must be 1-63 characters long, and comply withRFC1035. + // 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 the type of the healthAggregationPolicy. The only allowed value + // for global resources is DNS_PUBLIC_IP_POLICY. The only allowed + // value for regional resources is BACKEND_SERVICE_POLICY. Must + // be specified when the healthAggregationPolicy is created, and cannot be + // mutated. + // BACKEND_SERVICE_POLICY: + // DNS_PUBLIC_IP_POLICY: + optional string policy_type = 9 [json_name = "policyType"]; + + // Output only. [Output Only] URL of the region where the health aggregation + // policy + // 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 = 10 [json_name = "region"]; + + // Output only. [Output Only] Server-defined URL for the resource. + optional string self_link = 11 [json_name = "selfLink"]; + + // Output only. [Output Only] Server-defined URL with id for the resource. + optional string self_link_with_id = 12 [json_name = "selfLinkWithId"]; +} + +// Contains a list of HealthAggregationPoliciesScopedList. +message HealthAggregationPolicyAggregatedList { // [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"]; + // A list of HealthAggregationPoliciesScopedList resources. + map items = 2 + [json_name = "items"]; - // [Output Only] The resource type, which is always compute#instanceGroupList - // for instance group lists. + // Output only. 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 + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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. + // Output only. [Output Only] Server-defined URL for this resource. optional string self_link = 5 [json_name = "selfLink"]; + // Output only. [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. + // [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. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -223,19 +329,27 @@ message InstanceGroupList { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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. @@ -243,30 +357,26 @@ message InstanceGroupList { } // [Output Only] Informational warning message. - optional Warning warning = 6 [json_name = "warning"]; -} - -message InstanceGroupsAddInstancesRequest { - // The list of instances to add to the instance group. - repeated InstanceReference instances = 1 [json_name = "instances"]; + optional Warning warning = 7 [json_name = "warning"]; } -message InstanceGroupsListInstances { +message HealthAggregationPolicyList { // [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 HealthAggregationPolicy resources. + repeated HealthAggregationPolicy 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. [Output Only] Type of the resource. + // Alwayscompute#healthAggregationPolicy for health aggregation + // policies. 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 + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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"]; @@ -274,61 +384,73 @@ message InstanceGroupsListInstances { 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. + // [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. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -337,19 +459,27 @@ message InstanceGroupsListInstances { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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. @@ -359,125 +489,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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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 bb408ce0fc418..ab1bb78b9c212 100644 --- a/protos/google/cloud/compute/v1/internal/common_061.proto +++ b/protos/google/cloud/compute/v1/internal/common_061.proto @@ -15,605 +15,19 @@ // 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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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 InstanceGroupManagersResumeInstancesRequest { - // The URLs of one or more instances to resume. 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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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"]; -} - -message InstanceGroupManagersStartInstancesRequest { - // The URLs of one or more instances to start. 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 InstanceGroupManagersStopInstancesRequest { - // If this flag is set to true, the Instance Group Manager will proceed to - // stop the instances, skipping initialization on them. - optional bool force_stop = 1 [json_name = "forceStop"]; - - // The URLs of one or more instances to stop. This can be a full URL or a - // partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. - repeated string instances = 2 [json_name = "instances"]; -} - -message InstanceGroupManagersSuspendInstancesRequest { - // If this flag is set to true, the Instance Group Manager will proceed to - // suspend the instances, skipping initialization on them. - optional bool force_suspend = 1 [json_name = "forceSuspend"]; - - // The URLs of one or more instances to suspend. This can be a full URL or a - // partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. - repeated string instances = 2 [json_name = "instances"]; -} - -// 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"]; +// 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_062.proto b/protos/google/cloud/compute/v1/internal/common_062.proto index 215134625321e..347bcebc76ba5 100644 --- a/protos/google/cloud/compute/v1/internal/common_062.proto +++ b/protos/google/cloud/compute/v1/internal/common_062.proto @@ -15,251 +15,343 @@ // 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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_016.proto"; -import "google/cloud/compute/v1/internal/common_029.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 +// Represents a Health-Check as a Service resource. +message HealthCheckService { + // Output only. [Output Only] Creation timestamp inRFC3339 // text format. optional string creation_timestamp = 1 [json_name = "creationTimestamp"]; - // An optional description of this resource. + // 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 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"]; + // 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 + // regionalHealthCheckService, and not more than 1 for + // globalHealthCheckService.HealthCheck resources must + // haveportSpecification=USE_SERVING_PORT orportSpecification=USE_FIXED_PORT. + // For + // regional HealthCheckService, theHealthCheck must be regional and in the + // same + // region. For global HealthCheckService,HealthCheck must be global. Mix of + // regional and globalHealthChecks is not supported. Multiple + // regionalHealthChecks must belong to the same region. RegionalHealthChecks + // must belong to the same region as zones ofNetworkEndpointGroups. For + // globalHealthCheckService using globalINTERNET_IP_PORT + // NetworkEndpointGroups, the + // global HealthChecks must specify sourceRegions, + // and HealthChecks that specify sourceRegions can + // only be used with global INTERNET_IP_PORTNetworkEndpointGroups. + 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 reportsUNHEALTHY, then + // UNHEALTHY is theHealthState of the endpoint. If all health checks + // reportHEALTHY, the HealthState of the endpoint isHEALTHY. + // + // . + // 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 isHEALTHY. + // 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. [Output Only] The unique identifier for the resource. This + // identifier is + // defined by the server. + optional string id = 6 [json_name = "id"]; + + // Output only. [Output only] Type of the resource. + // Alwayscompute#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 regionalHealthCheckService, + // NEGs must be in + // zones in the region of the HealthCheckService. For + // globalHealthCheckServices, 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 + // regionalHealthCheckService,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. [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. [Output Only] Server-defined URL for the resource. + optional string self_link = 12 [json_name = "selfLink"]; } -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"]; +// Contains a list of HealthCheckServicesScopedList. +message HealthCheckServiceAggregatedList { + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 1 [json_name = "id"]; - optional LocalizedMessage localized_message = 3 - [json_name = "localizedMessage"]; + // A list of HealthCheckServicesScopedList resources. + map items = 2 [json_name = "items"]; - optional QuotaExceededInfo quota_info = 4 [json_name = "quotaInfo"]; - } + // Output only. Type of resource. + optional string kind = 3 [json_name = "kind"]; - // [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] This token allows you to get the next page of results for + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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] Indicates the field in the request that caused the error. - // This property is optional. - optional string location = 3 [json_name = "location"]; + // Output only. [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; - // [Output Only] An optional, human-readable error message. - optional string message = 4 [json_name = "message"]; - } + // Output only. [Output Only] Unreachable resources. + repeated string unreachables = 6 [json_name = "unreachables"]; - // [Output Only] The array of errors encountered while processing this + 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. - 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"]; + // 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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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] Indicates the field in the request that caused the error. - // This property is optional. - optional string location = 3 [json_name = "location"]; + 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] An optional, human-readable error message. - optional string message = 4 [json_name = "message"]; + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; } - // [Output Only] The array of errors encountered while processing this - // operation. - repeated ErrorsItem errors = 1 [json_name = "errors"]; + // [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"]; } - // Errors that prevented the ResizeRequest to be fulfilled. - optional Error error = 1 [json_name = "error"]; + // [Output Only] Informational warning message. + optional Warning warning = 7 [json_name = "warning"]; } -// [Output Only] A list of resize requests. -message InstanceGroupManagerResizeRequestsListResponse { - // [Output Only] Unique identifier for the resource; defined by the server. +message HealthCheckServicesList { + // Output only. [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. A list of HealthCheckService resources. + repeated HealthCheckService items = 2 [json_name = "items"]; - // [Output Only] Type of the resource. Always - // compute#instanceGroupManagerResizeRequestList for a list of resize - // requests. + // Output only. [Output Only] Type of the resource. + // Alwayscompute#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 + // Output only. [Output Only] This token allows you to get the next page of + // results for + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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. + // Output only. [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. + // [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. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -268,19 +360,27 @@ message InstanceGroupManagerResizeRequestsListResponse { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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. @@ -290,3 +390,115 @@ message InstanceGroupManagerResizeRequestsListResponse { // [Output Only] Informational warning message. optional Warning warning = 6 [json_name = "warning"]; } + +message HealthCheckServicesScopedList { + // A list of HealthCheckServices contained in this scope. + repeated HealthCheckService resources = 1 [json_name = "resources"]; + + 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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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_063.proto b/protos/google/cloud/compute/v1/internal/common_063.proto index 3435a5c5e82ed..b5c97346f1797 100644 --- a/protos/google/cloud/compute/v1/internal/common_063.proto +++ b/protos/google/cloud/compute/v1/internal/common_063.proto @@ -15,14 +15,253 @@ // 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: 20250601 +// revision: 20260807 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_053.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"]; + + // Output only. 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 thanmaxResults, use the + // nextPageToken as a value 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. [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + // Output only. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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_064.proto b/protos/google/cloud/compute/v1/internal/common_064.proto index 419f8c306dc39..1b3017407e8a1 100644 --- a/protos/google/cloud/compute/v1/internal/common_064.proto +++ b/protos/google/cloud/compute/v1/internal/common_064.proto @@ -15,45 +15,506 @@ // 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: 20250601 +// revision: 20260807 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"]; +// Represents a health source. +// +// A health source resource specifies the source resources and the health +// aggregation policy applied to the source resources to determine the +// aggregated health status. +message HealthSource { + // Output only. [Output Only] Creation timestamp inRFC3339 + // 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 HealthSource. An up-to-date fingerprint + // must be provided in order to patch the HealthSource; Otherwise, the request + // will fail with error 412 conditionNotMet. To see the latest + // fingerprint, make a get() request to retrieve the + // HealthSource. + optional string fingerprint = 3 [json_name = "fingerprint"]; + + // URL to the HealthAggregationPolicy resource. Must be set. Must + // be regional and in the same region as the HealthSource. Can be + // mutated. + optional string health_aggregation_policy = 4 + [json_name = "healthAggregationPolicy"]; + + // Output only. [Output Only] A unique identifier for this resource type. The + // server + // generates this identifier. + optional string id = 5 [json_name = "id"]; + + // Output only. [Output Only] Type of the resource. Alwayscompute#healthSource + // for health sources. + optional string kind = 6 [json_name = "kind"]; - // The metadata key/value pairs assigned to all the instances in the - // corresponding scope. - optional InstanceSettingsMetadata metadata = 3 [json_name = "metadata"]; + // Name of the resource. Provided by the client when the resource is created. + // The name must be 1-63 characters long, and comply withRFC1035. + // 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"]; - // [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. [Output Only] URL of the region where the health source + // 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 = 8 [json_name = "region"]; + + // Output only. [Output Only] Server-defined URL for the resource. + optional string self_link = 9 [json_name = "selfLink"]; + + // Output only. [Output Only] Server-defined URL with id for the resource. + optional string self_link_with_id = 10 [json_name = "selfLinkWithId"]; + + // Specifies the type of the HealthSource. The only allowed value + // is BACKEND_SERVICE. Must be specified when theHealthSource is created, and + // cannot be mutated. + // BACKEND_SERVICE: + optional string source_type = 11 [json_name = "sourceType"]; + + // URLs to the source resources. Must be size 1. Must be aBackendService if + // the sourceType is BACKEND_SERVICE. TheBackendService must have load + // balancing schemeINTERNAL or INTERNAL_MANAGED and must be regional + // and in the same region as the HealthSource (cross-region + // deployment for INTERNAL_MANAGED is not supported). TheBackendService may + // use only IGs, MIGs, or NEGs of typeGCE_VM_IP or GCE_VM_IP_PORT. + // TheBackendService may not use haPolicy. Can be + // mutated. + repeated string sources = 12 [json_name = "sources"]; } -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 HealthSourcesScopedList. +message HealthSourceAggregatedList { + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 1 [json_name = "id"]; + + // A list of HealthSourcesScopedList resources. + map items = 2 [json_name = "items"]; + + // Output only. 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 thanmaxResults, use the + // nextPageToken as a value 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] Type of the resource. Always compute#metadata for metadata. + // Output only. [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + // Output only. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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"]; +} + +// Response message for RegionHealthSources.GetHealth +message HealthSourceHealth { + // Health state of the HealthSource. + // HEALTHY: + // UNHEALTHY: + // UNKNOWN: + optional string health_state = 1 [json_name = "healthState"]; + + // Output only. [Output Only] Type of resource. + // Alwayscompute#healthSourceHealth for the health of health sources. optional string kind = 2 [json_name = "kind"]; + + // Health state details of the sources. + repeated HealthSourcesGetHealthResponseSourceInfo sources = 3 + [json_name = "sources"]; +} + +message HealthSourceList { + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 1 [json_name = "id"]; + + // A list of HealthSource resources. + repeated HealthSource items = 2 [json_name = "items"]; + + // Output only. [Output Only] Type of the resource. Alwayscompute#healthSource + // for health sources. + 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 thanmaxResults, use the + // nextPageToken as a value 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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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 HealthSourcesGetHealthResponseSourceInfo { + // Represents an instance group or network endpoint group behind the source + // backend service. Only used if the sourceType of the regionHealthSource + // is BACKEND_SERVICE. + repeated HealthSourcesGetHealthResponseSourceInfoBackendInfo backends = 1 + [json_name = "backends"]; + + // Fully qualified URL of the forwarding rule associated with the source + // resource if it is a L4ILB backend service. + optional string forwarding_rule = 2 [json_name = "forwardingRule"]; + + // Fully qualified URL of the associated source resource. This is always a + // backend service URL. + optional string source = 3 [json_name = "source"]; +} + +message HealthSourcesGetHealthResponseSourceInfoBackendInfo { + // Total number of endpoints when determining the health of the + // regionHealthSource. + optional int32 endpoint_count = 1 [json_name = "endpointCount"]; + + // Fully qualified URL of an instance group or network endpoint group + // behind the source backend service. + optional string group = 2 [json_name = "group"]; + + // Number of endpoints considered healthy when determining health of the + // regionHealthSource. + optional int32 healthy_endpoint_count = 3 + [json_name = "healthyEndpointCount"]; +} + +message HealthSourcesScopedList { + // A list of HealthSources contained in this scope. + repeated HealthSource health_sources = 1 [json_name = "healthSources"]; + + 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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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 + // health sources when the list is empty. + optional Warning warning = 2 [json_name = "warning"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_065.proto b/protos/google/cloud/compute/v1/internal/common_065.proto index f440af882aedf..ac317f0a30747 100644 --- a/protos/google/cloud/compute/v1/internal/common_065.proto +++ b/protos/google/cloud/compute/v1/internal/common_065.proto @@ -15,212 +15,67 @@ // 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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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"]; +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_066.proto b/protos/google/cloud/compute/v1/internal/common_066.proto index 7459f82aa38a3..2c311713c53ac 100644 --- a/protos/google/cloud/compute/v1/internal/common_066.proto +++ b/protos/google/cloud/compute/v1/internal/common_066.proto @@ -15,193 +15,181 @@ // 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: 20250601 +// revision: 20260807 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"]; - - // [Output Only] Creation timestamp in RFC3339 text format. +// Represents a host resource. +message Host { + // Output only. All aliases for this resource. + // e.g. + // projects/123/zones/us-centra1-a/reservation/r1/reservationBlock/b1/hosts/h1 + repeated string alias_links = 1 [json_name = "aliasLinks"]; + + // Output only. The creation timestamp, formatted asRFC3339 text. optional string creation_timestamp = 2 [json_name = "creationTimestamp"]; - // An optional description of this resource. Provide this property when you - // create the resource. + // An optional description of this 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 + // Output only. The unique identifier for this 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"]; + optional string id = 4 [json_name = "id"]; + + // Output only. The type of resource. Alwayscompute#host for hosts. + optional string kind = 5 [json_name = "kind"]; + + // Output only. The name of the host. + optional string name = 6 [json_name = "name"]; + + // Output only. The self link of the host. + optional string self_link = 7 [json_name = "selfLink"]; + + // Output only. The self link with id of the host. + optional string self_link_with_id = 8 [json_name = "selfLinkWithId"]; + + // Output only. The state of the host. + // ACTIVE: The host has allocated all its resources. + // CREATING: The resources are being allocated for the host. + // DELETING: The host is currently being deleted. + // STATE_UNSPECIFIED: + // UNAVAILABLE: The host is currently unavailable. + optional string state = 9 [json_name = "state"]; + + // Output only. The status of the host + optional HostStatus status = 10 [json_name = "status"]; + + // Output only. The zone in which the host resides. + optional string zone = 11 [json_name = "zone"]; } -// 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"]; +message HostPhysicalTopology { + // The unique identifier of the capacity block within the cluster. + optional string block = 1 [json_name = "block"]; - // A list of InstantSnapshot resources. - repeated InstantSnapshot items = 2 [json_name = "items"]; + // The cluster name of the reservation sub-block. + optional string cluster = 2 [json_name = "cluster"]; + + // The unique identifier of the capacity host within the capacity sub-block. + optional string host = 3 [json_name = "host"]; + + // The unique identifier of the capacity sub-block within the capacity + // block. + optional string sub_block = 4 [json_name = "subBlock"]; +} - // Type of resource. - optional string kind = 3 [json_name = "kind"]; +message HostStatus { + // Output only. The physical topology of the reservation sub-block, if + // present + optional HostPhysicalTopology physical_topology = 1 + [json_name = "physicalTopology"]; - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to + // Output only. The URIs of the instances currently running on this host. + repeated string running_instances = 2 [json_name = "runningInstances"]; +} + +message HostsGetVersionRequest { + // The SBOM selection to return. Duplicate values in the list will be ignored. + repeated string sbom_selections = 1 [json_name = "sbomSelections"]; +} + +message HostsListResponse { + optional string etag = 1 [json_name = "etag"]; + + // The unique identifier for the resource; defined by the server. + optional string id = 2 [json_name = "id"]; + + // A list of host resources. + repeated Host items = 3 [json_name = "items"]; + + // The type of resource. Always compute#host for a list of hosts. + optional string kind = 4 [json_name = "kind"]; + + // This token allows you to get the next page of results for + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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"]; + + // The server-defined URL for this resource. + optional string self_link = 6 [json_name = "selfLink"]; - // [Output Only] Server-defined URL for this resource. - optional string self_link = 5 [json_name = "selfLink"]; + // 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. + // [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. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -210,30 +198,33 @@ message InstantSnapshotList { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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 InstantSnapshotResourceStatus { - // [Output Only] The storage size of this instant snapshot. - optional string storage_size_bytes = 1 [json_name = "storageSizeBytes"]; + // An informational warning message. + optional Warning warning = 8 [json_name = "warning"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_067.proto b/protos/google/cloud/compute/v1/internal/common_067.proto index b0cc565ca8a39..5be0ea518d78f 100644 --- a/protos/google/cloud/compute/v1/internal/common_067.proto +++ b/protos/google/cloud/compute/v1/internal/common_067.proto @@ -15,95 +15,172 @@ // 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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_066.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, seeHealth checks +// overview. +message HttpHealthCheck { + // How often (in seconds) to send a health check. The default value is5 + // seconds. + optional int32 check_interval_sec = 1 [json_name = "checkIntervalSec"]; + + // [Output Only] Creation timestamp inRFC3339 + // 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. [Output Only] Type of the resource. + // Alwayscompute#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 withRFC1035. + // 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 + // is80. + 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 withRFC3986. + 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 + // is5 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 InstantSnapshotAggregatedList { +// 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 InstantSnapshotsScopedList resources. - map items = 2 [json_name = "items"]; + // A list of HttpHealthCheck resources. + repeated HttpHealthCheck items = 2 [json_name = "items"]; - // [Output Only] Type of resource. Always - // compute#instantSnapshotAggregatedList for aggregated lists of - // instantSnapshots. + // Output only. 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 + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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. + // Output only. [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. + // [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. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -112,19 +189,27 @@ message InstantSnapshotAggregatedList { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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. @@ -132,98 +217,5 @@ message InstantSnapshotAggregatedList { } // [Output Only] Informational warning message. - 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"]; - - 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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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 - // instantSnapshots 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_068.proto b/protos/google/cloud/compute/v1/internal/common_068.proto index fe49ad24b1849..b5c6200024c68 100644 --- a/protos/google/cloud/compute/v1/internal/common_068.proto +++ b/protos/google/cloud/compute/v1/internal/common_068.proto @@ -15,294 +15,171 @@ // 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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_072.proto"; - -// 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 = 3 [json_name = "creationTimestamp"]; +// 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, seeHealth 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"]; - // 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"]; + // [Output Only] Creation timestamp inRFC3339 + // 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 = 5 [json_name = "description"]; - - // [Output Only] A list of outages expected for this Interconnect. - repeated InterconnectOutageNotification expected_outages = 6 - [json_name = "expectedOutages"]; + optional string description = 3 [json_name = "description"]; - // [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"]; + // 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"]; - // [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"]; + // 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 = 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"]; - - // [Output Only] URLs of InterconnectGroups that include this Interconnect. - // Order is arbitrary and items are unique. - repeated string interconnect_groups = 31 [json_name = "interconnectGroups"]; - - // 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"]; + optional string id = 6 [json_name = "id"]; - // 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. - - // LINK_TYPE_ETHERNET_400G_LR4: A 400G Ethernet with LR4 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]; - // LINK_TYPE_ETHERNET_400G_LR4: 400G Ethernet, LR4 Optics. - 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"]; + // 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. + // The name must be 1-63 characters long, and comply withRFC1035. // 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"]; + // 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 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"]; + // The TCP port number for the HTTPS health check request. The default value + // is 443. + optional int32 port = 9 [json_name = "port"]; - // 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] Reserved for future use. - optional bool satisfies_pzs = 21 [json_name = "satisfiesPzs"]; + // The request path of the HTTPS health check request. The default value is + // "/". Must comply withRFC3986. + optional string request_path = 10 [json_name = "requestPath"]; // [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"]; + optional string self_link = 11 [json_name = "selfLink"]; - // Google-assigned unique ID for this circuit. Assigned at circuit turn-up. - optional string google_circuit_id = 2 [json_name = "googleCircuitId"]; + // 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"]; - // 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"]; + // 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"]; } -// Response to the list request, and contains a list of interconnects. -message InterconnectList { +// 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 Interconnect resources. - repeated Interconnect items = 2 [json_name = "items"]; + // A list of HttpsHealthCheck resources. + repeated HttpsHealthCheck items = 2 [json_name = "items"]; - // [Output Only] Type of resource. Always compute#interconnectList for lists - // of interconnects. + // Output only. 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 + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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. + // Output only. [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. + // [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. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -311,19 +188,27 @@ message InterconnectList { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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. @@ -333,146 +218,3 @@ message InterconnectList { // [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"]; -} diff --git a/protos/google/cloud/compute/v1/internal/common_069.proto b/protos/google/cloud/compute/v1/internal/common_069.proto index cab47fddefa23..8f8885466120c 100644 --- a/protos/google/cloud/compute/v1/internal/common_069.proto +++ b/protos/google/cloud/compute/v1/internal/common_069.proto @@ -15,669 +15,301 @@ // 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: 20250601 +// revision: 20260807 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"]; - - // [Output Only] URL of the AttachmentGroup that includes this Attachment. - optional string attachment_group = 41 [json_name = "attachmentGroup"]; - - // 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_100G: 100 Gbit/s - // BPS_100G: 100 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"]; - - // Input only. 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"]; - - // Input only. 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 +import "google/cloud/compute/v1/internal/common_028.proto"; +import "google/cloud/compute/v1/internal/common_032.proto"; +import "google/cloud/compute/v1/internal/common_042.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. [Output Only] Creation timestamp inRFC3339 + // text format. + optional string creation_timestamp = 3 [json_name = "creationTimestamp"]; + + // Output only. 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"]; + + // Output only. 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 + // theguestOSfeatures[].type parameter. + repeated GuestOsFeature guest_os_features = 8 [json_name = "guestOsFeatures"]; + + // Output only. [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 + optional string id = 9 [json_name = "id"]; + + // Encrypts the image using acustomer-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. [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 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. Valid values are 1440, 1460, 1500, and 8896. 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"]; - - // Input only. 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"]; -} + // up-to-date fingerprint hash in order to update or change labels, + // otherwise the request will fail with error412 conditionNotMet. + // + // To see the latest fingerprint, make a get() request to + // retrieve an image. + optional string label_fingerprint = 12 [json_name = "labelFingerprint"]; -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] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value 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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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"]; -} + // Labels to apply to this image. These can be later modified by + // the setLabels method. + map labels = 13 [json_name = "labels"]; -// 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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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"]; - } + // Integer license codes indicating which licenses are attached to this image. + repeated string license_codes = 14 [json_name = "licenseCodes"]; - // [Output Only] Informational warning message. - optional Warning warning = 6 [json_name = "warning"]; -} + // Any applicable license URI. + repeated string licenses = 15 [json_name = "licenses"]; -// 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"]; -} + // Name of the resource; provided by the client when the resource is created. + // The name must be 1-63 characters long, and comply withRFC1035. + // 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"]; + + // Input only. [Input Only] Additional params passed with the request, but not + // persisted + // as part of resource payload. + optional ImageParams params = 35 [json_name = "params"]; + + message RawDisk { + // The format used to encode and transmit the block device, which should + // beTAR. 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 or Artifact Registry path where the raw + // disk image archive is stored. + // The following are valid formats: + // + // - https://storage.googleapis.com/bucket_name/image_archive_name + // - + // https://storage.googleapis.com/bucket_name/folder_name/image_archive_name + // - + // projects/project/locations/location/repositories/repo/packages/package/versions/version_id + // - + // projects/project/locations/location/repositories/repo/packages/package/versions/version_id@dirsum_sha256:hex_value + // + // + // + // 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"]; + } -// 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"]; + // 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. [Output Only] Reserved for future use. + optional bool satisfies_pzs = 18 [json_name = "satisfiesPzs"]; + + // Output only. [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"]; + + // Thecustomer-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. [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. [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. [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. [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, orREADY. + // 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"]; } -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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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"]; +// Additional image params. +message ImageParams { + // Input only. Resource manager tags to be bound to the image. Tag keys and + // values have + // the same definition as resource + // manager tags. Keys and values can be either in numeric format, + // such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in + // namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and + // `{tag_value_short_name}`. The field is ignored (both PUT & + // PATCH) when empty. + map resource_manager_tags = 1 + [json_name = "resourceManagerTags"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_070.proto b/protos/google/cloud/compute/v1/internal/common_070.proto index a04e23464616a..abdfed0e5e40c 100644 --- a/protos/google/cloud/compute/v1/internal/common_070.proto +++ b/protos/google/cloud/compute/v1/internal/common_070.proto @@ -15,40 +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: 20250601 +// revision: 20260807 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"]; +import "google/cloud/compute/v1/internal/common_069.proto"; - // [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"]; +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_071.proto b/protos/google/cloud/compute/v1/internal/common_071.proto index a3087646a3fd2..44b0cda7d1714 100644 --- a/protos/google/cloud/compute/v1/internal/common_071.proto +++ b/protos/google/cloud/compute/v1/internal/common_071.proto @@ -15,287 +15,104 @@ // 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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -// An interconnect attachment group resource allows customers to create, -// analyze, and expand highly available deployments. -message InterconnectAttachmentGroup { - // Attachments in the AttachmentGroup. Keys are arbitrary user-specified - // strings. Users are encouraged, but not required, to use their preferred - // format for resource links as keys. Note that there are add-members and - // remove-members methods in gcloud. The size of this map is limited by an - // "Attachments per group" quota. - map attachments = 1 - [json_name = "attachments"]; - - optional InterconnectAttachmentGroupConfigured configured = 2 - [json_name = "configured"]; - - // [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"]; - - // Opaque system-generated token that uniquely identifies the configuration. - // If provided when patching a configuration in update mode, the provided - // token must match the current token or the update is rejected. This provides - // a reliable means of doing read-modify-write (optimistic locking) as - // described by AIP 154. - optional string etag = 5 [json_name = "etag"]; - - // [Output Only] The unique identifier for the resource type. The server - // generates this identifier. - optional string id = 6 [json_name = "id"]; - - optional InterconnectAttachmentGroupIntent intent = 7 [json_name = "intent"]; - - // The URL of an InterconnectGroup that groups these Attachments' - // Interconnects. Customers do not need to set this unless directed by Google - // Support. - optional string interconnect_group = 8 [json_name = "interconnectGroup"]; - - // [Output Only] Type of the resource. Always - // compute#interconnectAttachmentGroup. - optional string kind = 9 [json_name = "kind"]; - - optional InterconnectAttachmentGroupLogicalStructure logical_structure = 10 - [json_name = "logicalStructure"]; - - // 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"]; -} - -// An Attachment in this AttachmentGroup. -message InterconnectAttachmentGroupAttachment { - optional string attachment = 1 [json_name = "attachment"]; -} - -// [Output Only] The redundancy this group is configured to support. The way a -// user queries what SLA their Attachment gets is by looking at this field of -// the Attachment's AttachmentGroup. -message InterconnectAttachmentGroupConfigured { - optional InterconnectAttachmentGroupConfiguredAvailabilitySLA - availability_sla = 1 [json_name = "availabilitySla"]; -} - -// [Output Only] Which SLA this group is configured to support, and why this -// group does or does not meet that SLA's requirements. -message InterconnectAttachmentGroupConfiguredAvailabilitySLA { - // EFFECTIVE_SLA_UNSPECIFIED: - // NO_SLA: - // PRODUCTION_CRITICAL: - // PRODUCTION_NON_CRITICAL: - optional string effective_sla = 1 [json_name = "effectiveSla"]; - - repeated - InterconnectAttachmentGroupConfiguredAvailabilitySLAIntendedSlaBlockers - intended_sla_blockers = 2 [json_name = "intendedSlaBlockers"]; -} - -// [Output Only] Reasons why configuration.availabilitySLA.sla differs from -// intent.availabilitySLA. This list is empty if and only if those are the same. -message -InterconnectAttachmentGroupConfiguredAvailabilitySLAIntendedSlaBlockers { - // [Output Only] URLs of any particular Attachments to explain this blocker in - // more detail. - repeated string attachments = 1 [json_name = "attachments"]; - - // BLOCKER_TYPE_UNSPECIFIED: - // INCOMPATIBLE_METROS: - // INCOMPATIBLE_REGIONS: - // MISSING_GLOBAL_ROUTING: - // NO_ATTACHMENTS: - // NO_ATTACHMENTS_IN_METRO_AND_ZONE: - // OTHER: - optional string blocker_type = 2 [json_name = "blockerType"]; - - // [Output Only] The url of Google Cloud public documentation explaining this - // requirement. This is set for every type of requirement. - optional string documentation_link = 3 [json_name = "documentationLink"]; - - // [Output Only] A human-readable explanation of this requirement and why it's - // not met. This is set for every type of requirement. - optional string explanation = 4 [json_name = "explanation"]; - - // [Output Only] Metros used to explain this blocker in more detail. These are - // three-letter lowercase strings like "iad". This will be set for some - // blockers (like NO_ATTACHMENTS_IN_METRO_AND_ZONE) but does not apply to - // others. - repeated string metros = 5 [json_name = "metros"]; - - // [Output Only] Regions used to explain this blocker in more detail. These - // are region names formatted like "us-central1". This will be set for some - // blockers (like INCOMPATIBLE_REGIONS) but does not apply to others. - repeated string regions = 6 [json_name = "regions"]; - - // [Output Only] Zones used to explain this blocker in more detail. Format is - // "zone1" and/or "zone2". This will be set for some blockers (like - // MISSING_ZONE) but does not apply to others. - repeated string zones = 7 [json_name = "zones"]; -} - -// The user's intent for this AttachmentGroup. This is the only required field -// besides the name that must be specified on group creation. -message InterconnectAttachmentGroupIntent { - // AVAILABILITY_SLA_UNSPECIFIED: - // NO_SLA: - // PRODUCTION_CRITICAL: - // PRODUCTION_NON_CRITICAL: - optional string availability_sla = 1 [json_name = "availabilitySla"]; -} - -// [Output Only] An analysis of the logical layout of Attachments in this group. -// Every Attachment in the group is shown once in this structure. -message InterconnectAttachmentGroupLogicalStructure { - repeated InterconnectAttachmentGroupLogicalStructureRegion regions = 1 - [json_name = "regions"]; -} - -// [Output Only] The regions Attachments in this group are in. -message InterconnectAttachmentGroupLogicalStructureRegion { - repeated InterconnectAttachmentGroupLogicalStructureRegionMetro metros = 1 - [json_name = "metros"]; - - // [Output Only] The name of a region, like "us-central1". - optional string region = 2 [json_name = "region"]; -} - -// [Output Only] The metros of Attachments in this group in this region. -message InterconnectAttachmentGroupLogicalStructureRegionMetro { - repeated InterconnectAttachmentGroupLogicalStructureRegionMetroFacility - facilities = 1 [json_name = "facilities"]; - - // [Output Only] The name of the metro, as a three-letter lowercase string - // like "iad". This is the first component of the location of an Interconnect. - optional string metro = 2 [json_name = "metro"]; -} - -// [Output Only] The facilities used for this group's Attachments' -// Interconnects. -message InterconnectAttachmentGroupLogicalStructureRegionMetroFacility { - // [Output Only] The name of a facility, like "iad-1234". - optional string facility = 1 [json_name = "facility"]; - - repeated InterconnectAttachmentGroupLogicalStructureRegionMetroFacilityZone - zones = 2 [json_name = "zones"]; -} - -// [Output Only] The zones that Attachments in this group are present in, in the -// given facilities. This is inherited from their Interconnects. -message InterconnectAttachmentGroupLogicalStructureRegionMetroFacilityZone { - // [Output Only] URLs of Attachments in the given zone, to the given region, - // on Interconnects in the given facility and metro. Every Attachment in the - // AG has such an entry. - repeated string attachments = 1 [json_name = "attachments"]; - - // [Output Only] The name of a zone, either "zone1" or "zone2". - optional string zone = 2 [json_name = "zone"]; -} - -// Response for the InterconnectAttachmentGroupsGetOperationalStatusResponse. -message InterconnectAttachmentGroupsGetOperationalStatusResponse { - optional string etag = 1 [json_name = "etag"]; - - optional InterconnectAttachmentGroupsOperationalStatus result = 2 - [json_name = "result"]; -} - -message InterconnectAttachmentGroupsListResponse { - optional string etag = 1 [json_name = "etag"]; +import "google/cloud/compute/v1/internal/common_069.proto"; +// Contains a list of images. +message ImageList { // [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 InterconnectAttachmentGroup resources. - repeated InterconnectAttachmentGroup items = 3 [json_name = "items"]; + // A list of Image resources. + repeated Image items = 2 [json_name = "items"]; - optional string kind = 4 [json_name = "kind"]; + // Output only. 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 + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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"]; + // Output only. [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. + // [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. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -304,19 +121,27 @@ message InterconnectAttachmentGroupsListResponse { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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. @@ -324,65 +149,5 @@ message InterconnectAttachmentGroupsListResponse { } // [Output Only] Informational warning message. - optional Warning warning = 8 [json_name = "warning"]; -} - -message InterconnectAttachmentGroupsOperationalStatus { - repeated InterconnectAttachmentGroupsOperationalStatusAttachmentStatus - attachment_statuses = 1 [json_name = "attachmentStatuses"]; - - optional InterconnectAttachmentGroupConfigured configured = 2 - [json_name = "configured"]; - - // Summarizes the status of the group. - // DEGRADED: - // FULLY_DOWN: - // FULLY_UP: - // UNSPECIFIED: - optional string group_status = 3 [json_name = "groupStatus"]; - - optional InterconnectAttachmentGroupIntent intent = 4 [json_name = "intent"]; - - // The operational state of the group, including only active Attachments. - optional InterconnectAttachmentGroupConfigured operational = 5 - [json_name = "operational"]; -} - -// The status of one Attachment in the group. List order is arbitrary. -message InterconnectAttachmentGroupsOperationalStatusAttachmentStatus { - // Whether this Attachment is enabled. This becomes false when the customer - // drains their Attachment. - optional bool admin_enabled = 1 [json_name = "adminEnabled"]; - - // The URL of the Attachment being described. - optional string attachment = 2 [json_name = "attachment"]; - - // Whether this Attachment is participating in the redundant configuration. - // This will be ACTIVE if and only if the status below is CONNECTION_UP. Any - // INACTIVE Attachments are excluded from the analysis that generates - // operational.availabilitySLA. - // ACTIVE: - // INACTIVE: - // UNSPECIFIED: - optional string is_active = 3 [json_name = "isActive"]; - - // Whether this Attachment is active, and if so, whether BGP is up. This is - // based on the statuses available in the Pantheon UI here: - // http://google3/java/com/google/cloud/boq/clientapi/gce/hybrid/api/interconnect_models.proto - // ATTACHMENT_STATUS_UNKNOWN: - // CONNECTION_DISABLED: - // CONNECTION_DOWN: - // CONNECTION_UP: - // DEFUNCT: - // IPSEC_CONFIGURATION_NEEDED_STATUS: - // IPSEC_READY_TO_RESUME_FLOW_STATUS: - // IPV4_DOWN_IPV6_UP: - // IPV4_UP_IPV6_DOWN: - // PARTNER_REQUEST_RECEIVED: - // PENDING_CUSTOMER: - // PENDING_PARTNER: - // PROVISIONED: - // ROUTER_CONFIGURATION_BROKEN: - // UNPROVISIONED: - optional string status = 4 [json_name = "status"]; + optional Warning warning = 6 [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 ef5ed4eb8e8af..a1acbdda00122 100644 --- a/protos/google/cloud/compute/v1/internal/common_072.proto +++ b/protos/google/cloud/compute/v1/internal/common_072.proto @@ -15,144 +15,778 @@ // 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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -// 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"]; +import "google/cloud/compute/v1/internal/common_001.proto"; +import "google/cloud/compute/v1/internal/common_038.proto"; +import "google/cloud/compute/v1/internal/common_094.proto"; +import "google/cloud/compute/v1/internal/common_144.proto"; +import "google/cloud/compute/v1/internal/common_173.proto"; + +message InstanceConsumptionData { + // Output only. Resources consumed by the instance. + optional InstanceConsumptionInfo consumption_info = 1 + [json_name = "consumptionInfo"]; + + // Output only. Server-defined URL for the instance. + optional string instance = 2 [json_name = "instance"]; +} + +message InstanceConsumptionInfo { + // Output only. The number of virtual CPUs that are available to the instance. + optional int32 guest_cpus = 1 [json_name = "guestCpus"]; + + // Output only. The amount of local SSD storage available to the instance, + // defined in GiB. + optional int32 local_ssd_gb = 2 [json_name = "localSsdGb"]; + + // Output only. The amount of physical memory available to the instance, + // defined in MiB. + optional int32 memory_mb = 3 [json_name = "memoryMb"]; + + // Output only. 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, readSole-tenant nodes. +message NodeGroup { + // Specifies how autoscaling should behave. + optional NodeGroupAutoscalingPolicy autoscaling_policy = 1 + [json_name = "autoscalingPolicy"]; + + // Output only. [Output Only] Creation timestamp inRFC3339 + // 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. [Output Only] The unique identifier for the resource. This + // identifier is + // defined by the server. + optional string id = 5 [json_name = "id"]; + + // Output only. [Output Only] The type of the resource. + // Alwayscompute#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 andRECURRENT + // 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 forAS_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 + // withRFC1035. + // 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. [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. [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. [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. [Output Only] Type of + // resource.Alwayscompute#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 thanmaxResults, use the + // nextPageToken as a value 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. [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + // Output only. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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. [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 thanmaxResults, use the + // nextPageToken as a value 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. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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. [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"]; + + // Output only. 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"]; + + // Output only. 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. [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"]; + + // Output only. Total amount of available resources on the node. + optional InstanceConsumptionInfo total_resources = 13 + [json_name = "totalResources"]; + + // Output only. [Output Only] The information about an upcoming maintenance + // event. + optional UpcomingMaintenance upcoming_maintenance = 14 + [json_name = "upcomingMaintenance"]; } -// 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"]; +message NodeGroupsAddNodesRequest { + // Count of additional nodes to be added to the node group. + optional int32 additional_node_count = 1 [json_name = "additionalNodeCount"]; +} - // The MAC address of this ARP neighbor. - optional string mac_address = 2 [json_name = "macAddress"]; +message NodeGroupsDeleteNodesRequest { + // Names of the nodes to delete. + repeated string nodes = 1 [json_name = "nodes"]; } -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 NodeGroupsListNodes { + // Output only. [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. [Output Only] The resource type, which is + // alwayscompute.nodeGroupsListNodes for the list of nodes in the + // specified node group. + optional string kind = 3 [json_name = "kind"]; + + // Output only. [Output Only] This token allows you to get the next page of + // results for + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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. [Output Only] Informational warning message. + optional Warning warning = 6 [json_name = "warning"]; } -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 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 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"]; +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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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"]; } -// 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"]; +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"]; +} - // Indicates whether or not MACsec is operational on this link. - optional bool operational = 2 [json_name = "operational"]; +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_073.proto b/protos/google/cloud/compute/v1/internal/common_073.proto index 382281b632d32..a86ded01a230d 100644 --- a/protos/google/cloud/compute/v1/internal/common_073.proto +++ b/protos/google/cloud/compute/v1/internal/common_073.proto @@ -15,444 +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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_072.proto"; +import "google/cloud/compute/v1/internal/common_098.proto"; -// An interconnect group resource allows customers to create, analyze, and -// expand their redundant connections. -message InterconnectGroup { - optional InterconnectGroupConfigured configured = 1 - [json_name = "configured"]; - - // [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"]; - - // Opaque system-generated token that uniquely identifies the configuration. - // If provided when patching a configuration in update mode, the provided - // token must match the current token or the update is rejected. This provides - // a reliable means of doing read-modify-write (optimistic locking) as - // described by API 154. - optional string etag = 4 [json_name = "etag"]; - - // [Output Only] The unique identifier for the resource type. The server - // generates this identifier. - optional string id = 5 [json_name = "id"]; - - optional InterconnectGroupIntent intent = 6 [json_name = "intent"]; - - // Interconnects in the InterconnectGroup. Keys are arbitrary user-specified - // strings. Users are encouraged, but not required, to use their preferred - // format for resource links as keys. Note that there are add-members and - // remove-members methods in gcloud. The size of this map is limited by an - // "Interconnects per group" quota. - map interconnects = 7 - [json_name = "interconnects"]; - - // [Output Only] Type of the resource. Always compute#InterconnectGroup - 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. - // 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 InterconnectGroupPhysicalStructure physical_structure = 10 - [json_name = "physicalStructure"]; - - // [Output Only] Server-defined URL for the resource. - optional string self_link = 11 [json_name = "selfLink"]; -} - -// [Output Only] The status of the group as configured. This has the same -// structure as the operational field reported by the OperationalStatus method, -// but does not take into account the operational status of each resource. -message InterconnectGroupConfigured { - optional InterconnectGroupConfiguredTopologyCapability topology_capability = 1 - [json_name = "topologyCapability"]; -} - -// [Output Only] How reliable this topology is configured to be, and why this -// group does or does not meet the requirements for the intended capability. -message InterconnectGroupConfiguredTopologyCapability { - repeated - InterconnectGroupConfiguredTopologyCapabilityIntendedCapabilityBlockers - intended_capability_blockers = 1 - [json_name = "intendedCapabilityBlockers"]; - - // NO_SLA: - // PRODUCTION_CRITICAL: - // PRODUCTION_NON_CRITICAL: - // UNSPECIFIED: - optional string supported_sla = 2 [json_name = "supportedSla"]; -} - -// [Output Only] Reasons why configuration.topologyCapability.sla differs from -// intent.topologyCapability. This list is empty if and only if those are the -// same. -message -InterconnectGroupConfiguredTopologyCapabilityIntendedCapabilityBlockers { - // INCOMPATIBLE_METROS: - // NOT_AVAILABLE: - // NO_INTERCONNECTS: - // NO_INTERCONNECTS_IN_METRO_AND_ZONE: - // OTHER: - // UNSPECIFIED: - optional string blocker_type = 1 [json_name = "blockerType"]; - - // [Output Only] The url of Google Cloud public documentation explaining this - // requirement. This is set for every type of requirement. - optional string documentation_link = 2 [json_name = "documentationLink"]; - - // [Output Only] A human-readable explanation of this requirement and why it's - // not met. This is set for every type of requirement. - optional string explanation = 3 [json_name = "explanation"]; - - // [Output Only] Facilities used to explain this blocker in more detail. Like - // physicalStructure.metros.facilities.facility, this is a numeric string like - // "5467". - repeated string facilities = 4 [json_name = "facilities"]; - - // [Output Only] Interconnects used to explain this blocker in more detail. - repeated string interconnects = 5 [json_name = "interconnects"]; - - // [Output Only] Metros used to explain this blocker in more detail. These are - // three-letter lowercase strings like "iad". A blocker like - // INCOMPATIBLE_METROS will specify the problematic metros in this field. - repeated string metros = 6 [json_name = "metros"]; - - // [Output Only] Zones used to explain this blocker in more detail. Zone names - // are "zone1" and/or "zone2". - repeated string zones = 7 [json_name = "zones"]; -} - -// The user's intent for this group. This is the only required field besides the -// name that must be specified on group creation. -message InterconnectGroupIntent { - // NO_SLA: - // PRODUCTION_CRITICAL: - // PRODUCTION_NON_CRITICAL: - // UNSPECIFIED: - optional string topology_capability = 1 [json_name = "topologyCapability"]; -} - -// An Interconnect in this InterconnectGroup. -message InterconnectGroupInterconnect { - // The URL of an Interconnect in this group. All Interconnects in the group - // are unique. - optional string interconnect = 1 [json_name = "interconnect"]; -} - -// [Output Only] An analysis of the physical layout of Interconnects in this -// group. Every Interconnect in the group is shown once in this structure. -message InterconnectGroupPhysicalStructure { - repeated InterconnectGroupPhysicalStructureMetros metros = 1 - [json_name = "metros"]; -} - -// [Output Only] The metros Interconnects in this group are in. -message InterconnectGroupPhysicalStructureMetros { - repeated InterconnectGroupPhysicalStructureMetrosFacilities facilities = 1 - [json_name = "facilities"]; - - // [Output Only] The name of the metro, as a three-letter lowercase string - // like "iad". This is the first component of the location of Interconnects - // underneath this. - optional string metro = 2 [json_name = "metro"]; -} - -// [Output Only] The facilities Interconnects in this metro are present in. -message InterconnectGroupPhysicalStructureMetrosFacilities { - // [Output Only] The ID of this facility, as a numeric string like "5467". - // This is the third component of the location of Interconnects in this - // facility. - optional string facility = 1 [json_name = "facility"]; - - repeated InterconnectGroupPhysicalStructureMetrosFacilitiesZones zones = 2 - [json_name = "zones"]; -} - -// [Output Only] The zones that Interconnects in this facility are present in. -message InterconnectGroupPhysicalStructureMetrosFacilitiesZones { - // [Output Only] URLs of Interconnects in this redundancy group in the given - // metro, facility, and zone. - repeated string interconnects = 1 [json_name = "interconnects"]; - - // [Output Only] The name of the zone, either "zone1" or "zone2". This is the - // second component of the location of Interconnects in this facility. - optional string zone = 2 [json_name = "zone"]; -} - -message InterconnectGroupsCreateMembers { - // How to behave when configured.topologyCapability.supportedSLA would not - // equal intent.topologyCapability after this call. - // CREATE: - // REJECT: - // UNSPECIFIED: - optional string intent_mismatch_behavior = 1 - [json_name = "intentMismatchBehavior"]; - - repeated InterconnectGroupsCreateMembersInterconnectInput interconnects = 2 - [json_name = "interconnects"]; - - // Parameters for the Interconnects to create. - optional InterconnectGroupsCreateMembersInterconnectInput - template_interconnect = 3 [json_name = "templateInterconnect"]; -} - -// LINT.IfChange -message InterconnectGroupsCreateMembersInterconnectInput { - // 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"]; - - // Customer name, to put in the Letter of Authorization as the party - // authorized to request a crossconnect. - optional string customer_name = 2 [json_name = "customerName"]; +// Represents an Instance Group resource. +// +// Instance Groups can be used to configure a target forload +// balancing. +// +// Instance groups can either be managed or unmanaged. +// +// To create +// managed instance groups, use the instanceGroupManager +// orregionInstanceGroupManager resource instead. +// +// Use zonal unmanaged instance groups if you need to applyload +// 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, readInstance +// groups. +message InstanceGroup { + // Output only. [Output Only] The creation timestamp for this instance group + // inRFC3339 + // 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 = 3 [json_name = "description"]; - - // A zone-free location to use for all Interconnects created in this call, - // like "iad-1234". - optional string facility = 4 [json_name = "facility"]; - - // 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 = 5 [json_name = "interconnectType"]; - - // 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. - - // LINK_TYPE_ETHERNET_400G_LR4: A 400G Ethernet with LR4 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]; - // LINK_TYPE_ETHERNET_400G_LR4: 400G Ethernet, LR4 Optics. - optional string link_type = 6 [json_name = "linkType"]; - - // Name of the Interconnects to be created. This must be specified on the - // template and/or on each individual interconnect. The name, if not empty, - // must be 1-63 characters long, and comply with RFC1035. Specifically, any - // nonempty 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"]; - - // 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 = 8 [json_name = "nocContactEmail"]; - - // 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 = 9 [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 = 10 [json_name = "requestedFeatures"]; - - // Target number of physical links in the link bundle, as requested by the - // customer. - optional int32 requested_link_count = 11 [json_name = "requestedLinkCount"]; -} - -message InterconnectGroupsCreateMembersRequest { - optional InterconnectGroupsCreateMembers request = 1 [json_name = "request"]; -} - -// Response for the InterconnectGroupsGetOperationalStatusResponse. -message InterconnectGroupsGetOperationalStatusResponse { - optional string etag = 1 [json_name = "etag"]; - - optional InterconnectGroupsOperationalStatus result = 2 - [json_name = "result"]; -} - -message InterconnectGroupsListResponse { - 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 InterconnectGroup resources. - repeated InterconnectGroup items = 3 [json_name = "items"]; - - 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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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"]; -} - -// Request to get the status of the interconnect group with extra detail. -message InterconnectGroupsOperationalStatus { - // The configuration analysis, as returned by Get. - optional InterconnectGroupConfigured configured = 1 - [json_name = "configured"]; - - // Summarizes the status of the group. - // DEGRADED: - // FULLY_DOWN: - // FULLY_UP: - // GROUPS_STATUS_UNSPECIFIED: - optional string group_status = 2 [json_name = "groupStatus"]; - - // The intent of the resource, as returned by Get. - optional InterconnectGroupIntent intent = 3 [json_name = "intent"]; - - repeated InterconnectGroupsOperationalStatusInterconnectStatus - interconnect_statuses = 4 [json_name = "interconnectStatuses"]; - - // The operational state of the group, including only active Interconnects. - optional InterconnectGroupConfigured operational = 5 - [json_name = "operational"]; -} - -// The status of one Interconnect in the group. The order is arbitrary. -message InterconnectGroupsOperationalStatusInterconnectStatus { - // Whether the Interconnect is enabled. - optional bool admin_enabled = 1 [json_name = "adminEnabled"]; - - // The diagnostics of the Interconnect, as returned by the existing - // get-diagnostics method. - optional InterconnectDiagnostics diagnostics = 2 [json_name = "diagnostics"]; - - // The URL of the Interconnect being described. - optional string interconnect = 3 [json_name = "interconnect"]; - - // Whether this interconnect is participating in the redundant configuration. - // ACTIVE: - // INACTIVE: - // IS_ACTIVE_UNSPECIFIED: - optional string is_active = 4 [json_name = "isActive"]; + optional string description = 2 [json_name = "description"]; + + // Output only. [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. [Output Only] A unique identifier for this instance group, + // generated + // by the server. + optional string id = 4 [json_name = "id"]; + + // Output only. [Output Only] The resource type, which is + // alwayscompute#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 withRFC1035. + optional string name = 6 [json_name = "name"]; + + // Optional. 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. [Output Only] The URL of theregion + // where the instance group is located (for regional resources). + optional string region = 9 [json_name = "region"]; + + // Output only. [Output Only] The URL for this instance group. The server + // generates + // this URL. + optional string self_link = 10 [json_name = "selfLink"]; + + // Output only. [Output Only] The total number of instances in the instance + // group. + optional int32 size = 11 [json_name = "size"]; + + // Output only. [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. [Output Only] The URL of thezone + // where the instance group is located (for zonal resources). + optional string zone = 13 [json_name = "zone"]; +} + +message InstanceWithNamedPorts { + // Output only. [Output Only] The URL of the instance. + optional string instance = 1 [json_name = "instance"]; + + // Output only. [Output Only] The named ports that belong to this instance + // group. + repeated NamedPort named_ports = 2 [json_name = "namedPorts"]; + + // Output only. [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. + // PENDING: For Flex Start provisioning instance is waiting for available + // capacity + // from Dynamic Workload Scheduler (DWS). + // PENDING_STOP: The instance is gracefully shutting down. + // 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_074.proto b/protos/google/cloud/compute/v1/internal/common_074.proto index bf239a033ec07..323743bf1b9ec 100644 --- a/protos/google/cloud/compute/v1/internal/common_074.proto +++ b/protos/google/cloud/compute/v1/internal/common_074.proto @@ -15,186 +15,244 @@ // 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: 20250601 +// revision: 20260807 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: - IF_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 - LINK_TYPE_ETHERNET_400G_LR4 - 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 = 5 [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"]; - - // [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#interconnectLocation for - // interconnect locations. - optional string kind = 10 [json_name = "kind"]; - - // [Output Only] Name of the resource. - optional string name = 11 [json_name = "name"]; - - // [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] 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] 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"]; +import "google/cloud/compute/v1/internal/common_073.proto"; +import "google/cloud/compute/v1/internal/common_078.proto"; +import "google/cloud/compute/v1/internal/common_098.proto"; + +message InstanceGroupAggregatedList { + // Output only. [Output Only] Unique identifier for the resource; defined by + // the server. + optional string id = 1 [json_name = "id"]; + + // A list of InstanceGroupsScopedList resources. + map items = 2 [json_name = "items"]; + + // Output only. [Output Only] The resource type, which is + // alwayscompute#instanceGroupAggregatedList for aggregated lists of + // instance groups. + optional string kind = 3 [json_name = "kind"]; + + // Output only. [Output Only] This token allows you to get the next page of + // results for + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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. [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + // Output only. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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. [Output Only] Informational warning message. + optional Warning warning = 7 [json_name = "warning"]; } -// 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. +// A list of InstanceGroup resources. +message InstanceGroupList { + // Output only. [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"]; + // A list of InstanceGroup resources. + repeated InstanceGroup items = 2 [json_name = "items"]; - // [Output Only] Type of resource. Always compute#interconnectLocationList for - // lists of interconnect locations. + // Output only. [Output Only] The resource type, which is + // alwayscompute#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 - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to + // Output only. [Output Only] This token allows you to get the next page of + // results for + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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. + // Output only. [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. + // [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. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -203,47 +261,316 @@ message InterconnectLocationList { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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. + // Output only. [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"]; +message InstanceGroupsAddInstancesRequest { + // The list of instances to add to the instance group. + repeated InstanceReference instances = 1 [json_name = "instances"]; +} + +message InstanceGroupsListInstances { + // Output only. [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"]; + + // Output only. [Output Only] The resource type, which is + // alwayscompute#instanceGroupsListInstances for the list of instances + // in the specified instance group. + optional string kind = 3 [json_name = "kind"]; + + // Output only. [Output Only] This token allows you to get the next page of + // results for + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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. [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. [Output Only] The list ofinstance + // 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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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. [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 + // theinstanceGroups.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 error412 + // 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_075.proto b/protos/google/cloud/compute/v1/internal/common_075.proto index 9dbc8e4d9601f..8c276973be9a2 100644 --- a/protos/google/cloud/compute/v1/internal/common_075.proto +++ b/protos/google/cloud/compute/v1/internal/common_075.proto @@ -15,251 +15,240 @@ // 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: 20250601 +// revision: 20260807 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"]; - - // [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"]; -} +import "google/cloud/compute/v1/internal/common_037.proto"; +import "google/cloud/compute/v1/internal/common_110.proto"; -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 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"]; -message InterconnectRemoteLocationConstraintsSubnetLengthRange { - optional int32 max = 1 [json_name = "max"]; + // Output only. The resource type, which is + // alwayscompute#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 thanmaxResults, use the + // nextPageToken as a value 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 int32 min = 2 [json_name = "min"]; + // 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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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"]; } -// 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. +// [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 InterconnectRemoteLocation resources. - repeated InterconnectRemoteLocation items = 2 [json_name = "items"]; + // A list of InstanceGroupManager resources. + repeated InstanceGroupManager items = 2 [json_name = "items"]; - // [Output Only] Type of resource. Always - // compute#interconnectRemoteLocationList for lists of interconnect remote - // locations. + // 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 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 + // Output only. This token allows you to get the next page of results for + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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. + // 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. + // [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. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -268,32 +257,479 @@ message InterconnectRemoteLocationList { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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. + // Output only. Informational warning message. optional Warning warning = 6 [json_name = "warning"]; } -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"]; +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 + // aszones/[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 + // , then use the nextPageToken as a value 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. [Output Only] The list of instances in the managed instance + // group. + repeated ManagedInstance managed_instances = 1 + [json_name = "managedInstances"]; + + // Output only. [Output Only] This token allows you to get the next page of + // results for + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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. [Output Only] The list of PerInstanceConfig. + repeated PerInstanceConfig items = 1 [json_name = "items"]; + + // Output only. [Output Only] This token allows you to get the next page of + // results for + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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. [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 InstanceGroupManagersResumeInstancesRequest { + // The URLs of one or more instances to resume. 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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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, + // runapplyUpdatesToInstances, or set the group'supdatePolicy.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 + // theinstanceGroupManagers.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"]; +} + +message InstanceGroupManagersStartInstancesRequest { + // The URLs of one or more instances to start. 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 InstanceGroupManagersStopInstancesRequest { + // If this flag is set to true, the Instance Group Manager will proceed to + // stop the instances, skipping initialization on them. + optional bool force_stop = 1 [json_name = "forceStop"]; + + // The URLs of one or more instances to stop. This can be a full URL or + // a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. + repeated string instances = 2 [json_name = "instances"]; +} + +message InstanceGroupManagersSuspendInstancesRequest { + // If this flag is set to true, the Instance Group Manager will proceed to + // suspend the instances, skipping initialization on them. + optional bool force_suspend = 1 [json_name = "forceSuspend"]; + + // The URLs of one or more instances to suspend. This can be a full URL or + // a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. + repeated string instances = 2 [json_name = "instances"]; +} + +// 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_076.proto b/protos/google/cloud/compute/v1/internal/common_076.proto index 2ef6db1fd5c39..ea13b5c8e5952 100644 --- a/protos/google/cloud/compute/v1/internal/common_076.proto +++ b/protos/google/cloud/compute/v1/internal/common_076.proto @@ -15,212 +15,195 @@ // 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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_029.proto"; - -// 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 { - // Specifies licenseCodes of licenses that can replace this license. Note: - // such replacements are allowed even if removable_from_disk is false. - repeated string allowed_replacement_licenses = 11 - [json_name = "allowedReplacementLicenses"]; - - // If true, this license can be appended to an existing disk's set of - // licenses. - optional bool appendable_to_disk = 12 [json_name = "appendableToDisk"]; - - // [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 = 2 [json_name = "creationTimestamp"]; - - // 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"]; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_038.proto"; +import "google/cloud/compute/v1/internal/common_110.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 inRFC3339 + // 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"]; + + // The names of instances to be created by this resize request. The number of + // names specified determines the number of instances to create. The group's + // target size will be increased by this number. This field cannot be used + // together with 'resize_by'. + repeated PerInstanceConfig instances = 13 [json_name = "instances"]; + + // Output only. The resource type, which is + // alwayscompute#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 withRFC1035. + optional string name = 5 [json_name = "name"]; + + // Output only. The URL of a region + // where the resize request is located. Populated only for regional resize + // requests. + optional string region = 14 [json_name = "region"]; + + // 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"]; +} - // Specifies licenseCodes of licenses that are incompatible with this license. - // If a license is incompatible with this license, it cannot be attached to - // the same disk or image. - repeated string incompatible_licenses = 13 - [json_name = "incompatibleLicenses"]; +message InstanceGroupManagerResizeRequestStatus { + message Error { + message ErrorsItem { + // [Output Only] The error type identifier for this error. + optional string code = 1 [json_name = "code"]; - // [Output Only] Type of resource. Always compute#license for licenses. - optional string kind = 5 [json_name = "kind"]; + message ErrorDetailsItem { + // Error information containing structured domain, reason, and metadata. + optional ErrorInfo error_info = 1 [json_name = "errorInfo"]; - // [Output Only] The unique code used to attach this license to images, - // snapshots, and disks. - optional string license_code = 6 [json_name = "licenseCode"]; + // Links and information to help the user resolve the error. + optional Help help = 2 [json_name = "help"]; - // If set, this license will be unable to be removed or replaced once attached - // to a disk until the minimum_retention period has passed. - optional Duration minimum_retention = 14 [json_name = "minimumRetention"]; + // A localized human-readable error message intended for end users. + optional LocalizedMessage localized_message = 3 + [json_name = "localizedMessage"]; - // If true, this license can only be used on VMs on multi tenant nodes. - optional bool multi_tenant_only = 15 [json_name = "multiTenantOnly"]; + // Details about quota limits and metrics when a quota is exceeded. + optional QuotaExceededInfo quota_info = 4 [json_name = "quotaInfo"]; + } - // 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] 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"]; - // If true, indicates this is an OS license. Only one OS license can be - // attached to a disk or image at a time. - optional bool os_license = 16 [json_name = "osLicense"]; + // [Output Only] Indicates the field in the request that caused the error. + // This property is optional. + optional string location = 3 [json_name = "location"]; - // If true, this license can be removed from a disk's set of licenses, with no - // replacement license needed. - optional bool removable_from_disk = 17 [json_name = "removableFromDisk"]; + // [Output Only] An optional, human-readable error message. + optional string message = 4 [json_name = "message"]; + } - // Specifies the set of permissible coattached licenseCodes of licenses that - // satisfy the coattachment requirement of this license. At least one license - // from the set must be attached to the same disk or image as this license. - repeated string required_coattached_licenses = 18 - [json_name = "requiredCoattachedLicenses"]; + // [Output Only] The array of errors encountered while processing this + // operation. + repeated ErrorsItem errors = 1 [json_name = "errors"]; + } - // [Input Only] Deprecated. - optional LicenseResourceRequirements resource_requirements = 8 - [json_name = "resourceRequirements"]; + // 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 stored in the + // "error" field only. + optional InstanceGroupManagerResizeRequestStatusLastAttempt last_attempt = 2 + [json_name = "lastAttempt"]; +} - // [Output Only] Server-defined URL for the resource. - optional string self_link = 9 [json_name = "selfLink"]; +message InstanceGroupManagerResizeRequestStatusLastAttempt { + 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 with the resource id. - optional string self_link_with_id = 19 [json_name = "selfLinkWithId"]; + message ErrorDetailsItem { + // Error information containing structured domain, reason, and metadata. + optional ErrorInfo error_info = 1 [json_name = "errorInfo"]; - // If true, this license can only be used on VMs on sole tenant nodes. - optional bool sole_tenant_only = 20 [json_name = "soleTenantOnly"]; + // Links and information to help the user resolve the error. + optional Help help = 2 [json_name = "help"]; - // 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"]; + // A localized human-readable error message intended for end users. + optional LocalizedMessage localized_message = 3 + [json_name = "localizedMessage"]; - // [Output Only] Last update timestamp in RFC3339 text format. - optional string update_timestamp = 21 [json_name = "updateTimestamp"]; -} + // Details about quota limits and metrics when a quota is exceeded. + optional QuotaExceededInfo quota_info = 4 [json_name = "quotaInfo"]; + } -message LicenseResourceRequirements { - // [Input Only] Deprecated. This field no longer reflects the minimum number - // of guest cpus required to use the Instance. - optional int32 min_guest_cpu_count = 1 [json_name = "minGuestCpuCount"]; + // [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"]; - // [Input Only] Deprecated. This field no longer reflects the minimum memory - // required to use the Instance. - optional int32 min_memory_mb = 2 [json_name = "minMemoryMb"]; -} + // [Output Only] Indicates the field in the request that caused the error. + // This property is optional. + optional string location = 3 [json_name = "location"]; -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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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] 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 = 5 [json_name = "warning"]; + // Output only. Errors that prevented the ResizeRequest to be fulfilled. + optional Error error = 1 [json_name = "error"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_077.proto b/protos/google/cloud/compute/v1/internal/common_077.proto index 72aff546a26b8..fe5ade955c083 100644 --- a/protos/google/cloud/compute/v1/internal/common_077.proto +++ b/protos/google/cloud/compute/v1/internal/common_077.proto @@ -15,60 +15,141 @@ // 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: 20250601 +// revision: 20260807 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. - optional string creation_timestamp = 1 [json_name = "creationTimestamp"]; +import "google/cloud/compute/v1/internal/common_076.proto"; - // [Output Only] Description of this License Code. - optional string description = 2 [json_name = "description"]; +// [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"]; - // [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 resize request resources. + repeated InstanceGroupManagerResizeRequest items = 2 [json_name = "items"]; - // [Output Only] Type of resource. Always compute#licenseCode for licenses. - optional string kind = 4 [json_name = "kind"]; + // Output only. Type of the resource. + // Alwayscompute#instanceGroupManagerResizeRequestList for + // a list of resize requests. + optional string kind = 3 [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. This token allows you to get the next page of results for list + // requests. + // If the number of results is larger than maxResults, use thenextPageToken as + // a value for the query parameterpageToken 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] 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 this resource. + optional string self_link = 5 [json_name = "selfLink"]; - // [Output Only] Server-defined URL for the resource. - optional string self_link = 7 [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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] 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"]; + 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] 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"]; -} + // [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"]; -message LicenseCodeLicenseAlias { - // [Output Only] Description of this License Code. - optional string description = 1 [json_name = "description"]; + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } - // [Output Only] URL of license corresponding to this License Code. - optional string self_link = 2 [json_name = "selfLink"]; + // Output only. Informational warning message. + optional Warning warning = 6 [json_name = "warning"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_078.proto b/protos/google/cloud/compute/v1/internal/common_078.proto index 65bebcfdfa5bc..6e15b2f5060e0 100644 --- a/protos/google/cloud/compute/v1/internal/common_078.proto +++ b/protos/google/cloud/compute/v1/internal/common_078.proto @@ -15,30 +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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -message LocalDisk { - // Specifies the number of such disks. - optional int32 disk_count = 1 [json_name = "diskCount"]; - - // Specifies the size of the disk in base-2 GB. - optional int32 disk_size_gb = 2 [json_name = "diskSizeGb"]; - - // 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 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 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_079.proto b/protos/google/cloud/compute/v1/internal/common_079.proto index ac13fe4cde848..750bec2f81900 100644 --- a/protos/google/cloud/compute/v1/internal/common_079.proto +++ b/protos/google/cloud/compute/v1/internal/common_079.proto @@ -15,428 +15,48 @@ // 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: 20250601 +// revision: 20260807 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_081.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"]; - - // A fingerprint for the labels being applied to this machine image, 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 machine image. - optional string label_fingerprint = 19 [json_name = "labelFingerprint"]; - - // Labels to apply to this machine image. These can be later modified by the - // setLabels method. - map labels = 20 [json_name = "labels"]; - - // 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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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"]; -} - -// 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. +// 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. [Output Only] Type of the resource. + // Alwayscompute#instance_settings for instance settings. 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"]; + // The metadata key/value pairs assigned to all the instances in the + // corresponding scope. + optional InstanceSettingsMetadata metadata = 3 [json_name = "metadata"]; - // [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"]; + // Output only. [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"]; } -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"]; +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"]; - // 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. [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_080.proto b/protos/google/cloud/compute/v1/internal/common_080.proto index c7480058a0112..ea2491f6c1446 100644 --- a/protos/google/cloud/compute/v1/internal/common_080.proto +++ b/protos/google/cloud/compute/v1/internal/common_080.proto @@ -15,281 +15,104 @@ // 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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_023.proto"; +import "google/cloud/compute/v1/internal/common_033.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 { - reserved 14; - 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"]; - - // [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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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 { +// 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 MachineType resources. - repeated MachineType items = 2 [json_name = "items"]; + // A list of InstanceTemplatesScopedList resources. + map items = 2 [json_name = "items"]; - // [Output Only] Type of resource. Always compute#machineTypeList for lists of - // machine types. + // Output only. 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 + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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. + // Output only. [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. + // [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. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -298,19 +121,27 @@ message MachineTypeList { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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. @@ -321,66 +152,80 @@ message MachineTypeList { 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 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. + // [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. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -389,26 +234,34 @@ message MachineTypesScopedList { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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. + // [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_081.proto b/protos/google/cloud/compute/v1/internal/common_081.proto index 09700e341b91f..e1f1308968b36 100644 --- a/protos/google/cloud/compute/v1/internal/common_081.proto +++ b/protos/google/cloud/compute/v1/internal/common_081.proto @@ -15,42 +15,307 @@ // 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: 20250601 +// revision: 20260807 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"]; - - 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"]; - } +// Represents a InstantSnapshot resource. +// +// You can use instant snapshots to create disk rollback points quickly.. +message InstantSnapshot { + // Output only. [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. [Output Only] Creation timestamp inRFC3339 + // 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. [Output Only] Size of the source disk, specified in GB. + optional string disk_size_gb = 4 [json_name = "diskSizeGb"]; + + // Output only. [Output Only] The unique identifier for the resource. This + // identifier is + // defined by the server. + optional string id = 5 [json_name = "id"]; + + // Output only. [Output Only] Type of the resource. + // Alwayscompute#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 error412 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 withRFC1035. + // 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"]; + + // Input only. Additional params passed with the request, but not persisted + // as part of resource payload. + optional InstantSnapshotParams params = 20 [json_name = "params"]; + + // Output only. [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. [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. [Output Only] Reserved for future use. + optional bool satisfies_pzs = 13 [json_name = "satisfiesPzs"]; + + // Output only. [Output Only] Server-defined URL for the resource. + optional string self_link = 14 [json_name = "selfLink"]; + + // Output only. [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. [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"]; - // 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. [Output Only] URL of the source instant snapshot this instant + // snapshot is + // part of. Note that the source instant snapshot group must be in the same + // zone/region as the instant snapshot to be created. This can be a full or + // valid partial URL. + optional string source_instant_snapshot_group = 21 + [json_name = "sourceInstantSnapshotGroup"]; - // [Output Only] Type of the resource. Always compute#metadata for metadata. + // Output only. [Output Only] The ID value of the source instant snapshot + // group this + // InstantSnapshot is part of. This value may be used to determine whether the + // InstantSnapshot was created as part of an InstantSnapshotGroup creation. + optional string source_instant_snapshot_group_id = 22 + [json_name = "sourceInstantSnapshotGroupId"]; + + // Output only. [Output Only] The status of the instantSnapshot. This can + // beCREATING, DELETING, FAILED, orREADY. + // 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. [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 { + // [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"]; + + // Output only. 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 thanmaxResults, use the + // nextPageToken as a value 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. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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 instant snapshot params. +message InstantSnapshotParams { + // Input only. Resource manager tags to be bound to the instant snapshot. Tag + // keys and + // values have the same definition as resource + // manager tags. Keys and values can be either in numeric format, + // such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in + // namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and + // `{tag_value_short_name}`. The field is ignored (both PUT & + // PATCH) when empty. + map resource_manager_tags = 1 + [json_name = "resourceManagerTags"]; +} + +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_082.proto b/protos/google/cloud/compute/v1/internal/common_082.proto index ae21276edd420..537c8a6e21c52 100644 --- a/protos/google/cloud/compute/v1/internal/common_082.proto +++ b/protos/google/cloud/compute/v1/internal/common_082.proto @@ -15,54 +15,256 @@ // 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: 20250601 +// revision: 20260807 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"]; +import "google/cloud/compute/v1/internal/common_081.proto"; + +message InstantSnapshotAggregatedList { + // [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"]; + + // Output only. [Output Only] Type of resource. + // Alwayscompute#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 + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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. [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + // Output only. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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"]; } -// 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"]; +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 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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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"]; + // [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_083.proto b/protos/google/cloud/compute/v1/internal/common_083.proto index fd45a9ec8132e..76b52047a30b1 100644 --- a/protos/google/cloud/compute/v1/internal/common_083.proto +++ b/protos/google/cloud/compute/v1/internal/common_083.proto @@ -15,18 +15,228 @@ // 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: 20250601 +// revision: 20260807 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 an InstantSnapshotGroup resource. +// +// An instant snapshot group is a set of instant snapshots that represents a +// point in time state of a consistency group. +message InstantSnapshotGroup { + // Output only. [Output Only] Creation timestamp inRFC3339 + // text format. + optional string creation_timestamp = 1 [json_name = "creationTimestamp"]; + + // Optional. An optional description of this resource. Provide this property + // when you + // create the resource. + optional string description = 2 [json_name = "description"]; + + // Output only. [Output Only] The unique identifier for the resource. This + // identifier is + // defined by the server. + optional string id = 3 [json_name = "id"]; + + // Output only. [Output Only] Type of the resource. + // Alwayscompute#instantSnapshotGroup for InstantSnapshotGroup + // resources. + optional string kind = 4 [json_name = "kind"]; + + // Identifier. Name of the resource; provided by the client when the resource + // is created. + // The name must be 1-63 characters long, and comply withRFC1035. + // 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"]; + + // Output only. [Output Only] URL of the region where the instant snapshot + // group 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 = 6 [json_name = "region"]; + + optional InstantSnapshotGroupResourceStatus resource_status = 7 + [json_name = "resourceStatus"]; + + // Output only. [Output Only] Server-defined URL for the resource. + optional string self_link = 8 [json_name = "selfLink"]; + + // Output only. [Output Only] Server-defined URL for this resource's resource + // id. + optional string self_link_with_id = 9 [json_name = "selfLinkWithId"]; + + optional string source_consistency_group = 10 + [json_name = "sourceConsistencyGroup"]; + + // Output only. [Output Only] + // CREATING: + // DELETING: + // FAILED: + // INVALID: + // READY: + // UNKNOWN: + optional string status = 11 [json_name = "status"]; + + // Output only. [Output Only] URL of the zone where the instant snapshot group + // 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 = 12 [json_name = "zone"]; +} + +message InstantSnapshotGroupResourceStatus { + // Output only. [Output Only] + optional string consistency_membership_resolution_time = 1 + [json_name = "consistencyMembershipResolutionTime"]; + + // Output only. [Output Only] + optional InstantSnapshotGroupSourceInfo source_info = 2 + [json_name = "sourceInfo"]; +} + +message InstantSnapshotGroupSourceInfo { + optional string consistency_group = 1 [json_name = "consistencyGroup"]; + + optional string consistency_group_id = 2 [json_name = "consistencyGroupId"]; +} + +// Contains a list of InstantSnapshotGroup resources. +message ListInstantSnapshotGroups { + 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 InstantSnapshotGroup resources. + repeated InstantSnapshotGroup items = 3 [json_name = "items"]; + + // Output only. 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 thanmaxResults, use the + // nextPageToken as a value 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. [Output Only] Server-defined URL for this resource. + optional string self_link = 6 [json_name = "selfLink"]; + + // Output only. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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 port number, which can be a value between 1 and 65535. - optional int32 port = 2 [json_name = "port"]; + // [Output Only] Informational warning message. + optional Warning warning = 8 [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 2f3efcb6eb7e5..4cb85d9c0c7aa 100644 --- a/protos/google/cloud/compute/v1/internal/common_084.proto +++ b/protos/google/cloud/compute/v1/internal/common_084.proto @@ -15,309 +15,433 @@ // 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: 20250601 +// revision: 20260807 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_088.proto"; - // ACCEPT_AUTOMATIC: - // ACCEPT_MANUAL: - // INVALID: - optional string connection_preference = 2 - [json_name = "connectionPreference"]; - - // [Output Only] Creation timestamp in RFC3339 text format. +// 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 { + // Enable or disable the application awareness feature on this Cloud + // Interconnect. + optional bool aai_enabled = 32 [json_name = "aaiEnabled"]; + + // 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"]; + + // Configuration information for application awareness on this Cloud + // Interconnect. + optional InterconnectApplicationAwareInterconnect + application_aware_interconnect = 33 + [json_name = "applicationAwareInterconnect"]; + + // [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. Any + // attempt to enable MACsec will fail. + // - IF_CROSS_SITE_NETWORK: If present, then the Interconnect connection is + // provisioned exclusively for Cross-Site Networking. Any attempt to + // configure + // VLAN attachments will fail. If not present, then the Interconnect + // connection is not provisioned for Cross-Site Networking. Any attempt to + // use + // it for Cross-Site Networking will fail. + repeated string available_features = 27 [json_name = "availableFeatures"]; + + // Output only. [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. [Output Only] Creation timestamp inRFC3339 + // 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 = 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"]; + optional string description = 5 [json_name = "description"]; + + // Output only. URL of the InterconnectLocation object that represents where + // this connection is to be provisioned. By default it will be the same as the + // location field. + optional string effective_location = 34 [json_name = "effectiveLocation"]; + + // Output only. [Output Only] A list of outages expected for this + // Interconnect. + repeated InterconnectOutageNotification expected_outages = 6 + [json_name = "expectedOutages"]; + + // Output only. [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. [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. [Output Only] The unique identifier for the resource. This + // identifier is + // defined by the server. + optional string id = 9 [json_name = "id"]; + + // Output only. [Output Only] A list of the URLs of all + // InterconnectAttachments configured + // to use this Interconnect. + repeated string interconnect_attachments = 10 + [json_name = "interconnectAttachments"]; + + // Output only. [Output Only] URLs of InterconnectGroups that include this + // Interconnect. + // Order is arbitrary and items are unique. + repeated string interconnect_groups = 31 [json_name = "interconnectGroups"]; + + // 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. [Output Only] Type of the resource. Alwayscompute#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 error412 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 + // thesetLabels method. Each label key/value pair must comply withRFC1035. + // 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. + // - LINK_TYPE_ETHERNET_400G_LR4: A 400G Ethernet with LR4 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]; + // LINK_TYPE_ETHERNET_400G_LR4: 400G Ethernet, LR4 Optics. + 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. + // The name must be 1-63 characters long, and comply withRFC1035. // 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"]; + // 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. [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"]; + + // Input only. [Input Only] Additional params passed with the request, but not + // persisted + // as part of resource payload. + optional InterconnectParams params = 35 [json_name = "params"]; + + // Output only. [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. [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. This parameter can be provided only with Interconnect INSERT. It + // isn't valid for Interconnect PATCH. 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, non-MACsec capable ports will + // also be considered. + // - IF_CROSS_SITE_NETWORK: If specified, then the connection is created + // exclusively for Cross-Site Networking. The connection can not be used + // for + // Cross-Site Networking unless this feature is specified. + 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. [Output Only] Reserved for future use. + optional bool satisfies_pzs = 21 [json_name = "satisfiesPzs"]; + + // Output only. [Output Only] Server-defined URL for the resource. + optional string self_link = 22 [json_name = "selfLink"]; + + // Output only. [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"]; + + // To be deprecated. + // SUBZONE_A: Subzone A. + // SUBZONE_B: Subzone B. + optional string subzone = 36 [json_name = "subzone"]; + + // Output only. [Output Only] A list of the URLs of all CrossSiteNetwork + // WireGroups + // configured to use this Interconnect. The Interconnect cannot be deleted if + // this list is non-empty. + repeated string wire_groups = 37 [json_name = "wireGroups"]; } -// 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"]; +// Configuration information for application awareness on this Cloud +// Interconnect. +message InterconnectApplicationAwareInterconnect { + optional InterconnectApplicationAwareInterconnectBandwidthPercentagePolicy + bandwidth_percentage_policy = 1 [json_name = "bandwidthPercentagePolicy"]; - optional string kind = 3 [json_name = "kind"]; + // Description for the application awareness profile on this Cloud + // Interconnect. + optional string profile_description = 2 [json_name = "profileDescription"]; - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value 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 field to specify a list of shape average percentages to be + // applied in conjunction with StrictPriorityPolicy or + // BandwidthPercentagePolicy. + repeated InterconnectApplicationAwareInterconnectBandwidthPercentage + shape_average_percentages = 3 [json_name = "shapeAveragePercentages"]; - // [Output Only] Server-defined URL for this resource. - optional string self_link = 5 [json_name = "selfLink"]; + optional InterconnectApplicationAwareInterconnectStrictPriorityPolicy + strict_priority_policy = 4 [json_name = "strictPriorityPolicy"]; +} - 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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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"]; +// Specify bandwidth percentages [1-100] for various traffic classes in +// BandwidthPercentagePolicy. The sum of all percentages must equal 100. +// All traffic classes must have a percentage value specified. +message InterconnectApplicationAwareInterconnectBandwidthPercentage { + // Bandwidth percentage for a specific traffic class. + optional uint32 percentage = 1 [json_name = "percentage"]; + + // TrafficClass whose bandwidth percentage is being specified. + // TC1: Traffic Class 1, corresponding to DSCP ranges (0-7) 000xxx. + // TC2: Traffic Class 2, corresponding to DSCP ranges (8-15) 001xxx. + // TC3: Traffic Class 3, corresponding to DSCP ranges (16-23) 010xxx. + // TC4: Traffic Class 4, corresponding to DSCP ranges (24-31) 011xxx. + // TC5: Traffic Class 5, corresponding to DSCP ranges (32-47) 10xxxx. + // TC6: Traffic Class 6, corresponding to DSCP ranges (48-63) 11xxxx. + optional string traffic_class = 2 [json_name = "trafficClass"]; +} - 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 InterconnectApplicationAwareInterconnectBandwidthPercentagePolicy { + // Specify bandwidth percentages for various traffic classes for queuing + // type Bandwidth Percent. + repeated InterconnectApplicationAwareInterconnectBandwidthPercentage + bandwidth_percentages = 1 [json_name = "bandwidthPercentages"]; +} - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } +// Specify configuration for StrictPriorityPolicy. +message InterconnectApplicationAwareInterconnectStrictPriorityPolicy {} - // [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"]; +// 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] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } + // Google-assigned unique ID for this circuit. Assigned at circuit turn-up. + optional string google_circuit_id = 2 [json_name = "googleCircuitId"]; - // [Output Only] Informational warning message. - optional Warning warning = 6 [json_name = "warning"]; + // 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"]; } -// [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 { +// 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 NetworkAttachment resources. - repeated NetworkAttachment items = 2 [json_name = "items"]; + // A list of Interconnect resources. + repeated Interconnect items = 2 [json_name = "items"]; + // Output only. [Output Only] Type of resource. Alwayscompute#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 + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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. + // Output only. [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. + // [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. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -326,19 +450,27 @@ message NetworkAttachmentList { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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. @@ -349,95 +481,194 @@ message NetworkAttachmentList { 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"]; +// 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 + // ashould-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 + // amust-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"]; +} - 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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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"]; +// 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"]; +} - 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"]; +// 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"]; - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } + // An auto-generated Connectivity Association Key Name (CKN) for this key. + optional string ckn = 2 [json_name = "ckn"]; - // [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"]; + // User provided name for this pre-shared key. + optional string name = 3 [json_name = "name"]; - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } + // 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 withRFC1035. + // 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"]; +} + +// Additional interconnect parameters. +message InterconnectParams { + // Tag keys/values directly bound to this resource. + // Tag keys and values have the same definition as resource + // manager tags. The field is allowed for INSERT + // only. The keys/values to set on the resource should be specified in + // either ID { : } or Namespaced format + // { : }. + // For example the following are valid inputs: + // * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} + // * {"123/environment" : "production", "345/abc" : "xyz"} + // Note: + // * Invalid combinations of ID & namespaced format is not supported. For + // instance: {"123/environment" : "tagValues/444"} is invalid. + // * Inconsistent format is not supported. For instance: + // {"tagKeys/333" : "tagValues/444", "123/env" : "prod"} is invalid. + map resource_manager_tags = 1 + [json_name = "resourceManagerTags"]; +} + +// 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"]; - // Informational warning which replaces the list of network attachments when - // the list is empty. - optional Warning warning = 2 [json_name = "warning"]; + optional InterconnectMacsecConfig result = 2 [json_name = "result"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_085.proto b/protos/google/cloud/compute/v1/internal/common_085.proto index 2e25202110962..15606f13466af 100644 --- a/protos/google/cloud/compute/v1/internal/common_085.proto +++ b/protos/google/cloud/compute/v1/internal/common_085.proto @@ -15,146 +15,555 @@ // 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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -// 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"]; +import "google/cloud/compute/v1/internal/common_086.proto"; - // 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 +// 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"]; + + // Output only. [Output Only] URL of the AttachmentGroup that includes this + // Attachment. + optional string attachment_group = 41 [json_name = "attachmentGroup"]; + + // 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_100G: 100 Gbit/s + // - BPS_400G: 400 Gbit/s + // BPS_100G: 100 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_400G: 400 Gbit/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"]; + + // Single IPv4 address + prefix length to be configured on the cloud router + // interface for this interconnect attachment. + // + // - Both candidate_cloud_router_ip_address and + // candidate_customer_router_ip_address fields must be set or both must be + // unset. + // - Prefix length of both candidate_cloud_router_ip_address and + // candidate_customer_router_ip_address must be the same. + // - Max prefix length is 31. + optional string candidate_cloud_router_ip_address = 42 + [json_name = "candidateCloudRouterIpAddress"]; + + // Single IPv6 address + prefix length to be configured on the cloud router + // interface for this interconnect attachment. + // + // - Both candidate_cloud_router_ipv6_address and + // candidate_customer_router_ipv6_address fields must be set or both must + // be + // unset. + // - Prefix length of both candidate_cloud_router_ipv6_address and + // candidate_customer_router_ipv6_address must be the same. + // - Max prefix length is 126. + optional string candidate_cloud_router_ipv6_address = 43 + [json_name = "candidateCloudRouterIpv6Address"]; + + // Single IPv4 address + prefix length to be configured on the customer router + // interface for this interconnect attachment. + optional string candidate_customer_router_ip_address = 44 + [json_name = "candidateCustomerRouterIpAddress"]; + + // Single IPv6 address + prefix length to be configured on the customer router + // interface for this interconnect attachment. + optional string candidate_customer_router_ipv6_address = 45 + [json_name = "candidateCustomerRouterIpv6Address"]; + + // This field is not available. + repeated string candidate_ipv6_subnets = 3 + [json_name = "candidateIpv6Subnets"]; + + // Input only. 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. [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. [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. [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. [Output Only] Creation timestamp inRFC3339 + // text format. + optional string creation_timestamp = 8 [json_name = "creationTimestamp"]; + + // Output only. [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. [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. [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"]; + + // Input only. 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. [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. [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"]; + 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. [Output Only] Type of the resource. + // Alwayscompute#interconnectAttachment for interconnect attachments. + optional string kind = 20 [json_name = "kind"]; + + // L2 Interconnect Attachment related config. This field is required if the + // type is L2_DEDICATED. + // + // The configuration specifies how VLAN tags (like dot1q, qinq, or dot1ad) + // within L2 packets are mapped to the destination appliances IP addresses. + // The packet is then encapsulated with the appliance IP address and sent to + // the edge appliance. + optional InterconnectAttachmentL2Forwarding l2_forwarding = 46 + [json_name = "l2Forwarding"]; + + // 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 error412 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 + // thesetLabels method. Each label key/value pair must comply withRFC1035. + // Label values may be empty. + map labels = 38 [json_name = "labels"]; + + // Maximum Transmission Unit (MTU), in bytes, of packets passing through this + // interconnect attachment. + // Valid values are 1440, 1460, 1500, and 8896. 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. + // The name must be 1-63 characters long, and comply withRFC1035. // 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"]; + // 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. [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"]; + + // Input only. [Input Only] Additional params passed with the request, but not + // persisted + // as part of resource payload. + optional InterconnectAttachmentParams params = 47 [json_name = "params"]; + + // 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. [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. [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. [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. [Output Only] Reserved for future use. + optional bool satisfies_pzs = 30 [json_name = "satisfiesPzs"]; + + // Output only. [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. [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"]; + + // Input only. 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. + // + // - L2_DEDICATED: a L2 attachment to a Dedicated Interconnect. + // DEDICATED: Attachment to a dedicated interconnect. + // L2_DEDICATED: Attachment to a dedicated interconnect, forwarding L2 + // packets. + // 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 NetworkEdgeSecurityServiceAggregatedList { - optional string etag = 1 [json_name = "etag"]; - +message InterconnectAttachmentAggregatedList { // [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 + // A list of InterconnectAttachmentsScopedList 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. [Output Only] Type of resource. + // Alwayscompute#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 - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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. [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; - // [Output Only] Unreachable resources. - repeated string unreachables = 7 [json_name = "unreachables"]; + // Output only. [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. + // [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. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -163,19 +572,27 @@ message NetworkEdgeSecurityServiceAggregatedList { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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. @@ -183,70 +600,354 @@ message NetworkEdgeSecurityServiceAggregatedList { } // [Output Only] Informational warning message. - optional Warning warning = 8 [json_name = "warning"]; + optional Warning warning = 7 [json_name = "warning"]; +} + +// L2 Interconnect Attachment related configuration. +message InterconnectAttachmentL2Forwarding { + // Optional. A map of VLAN tags to appliances and optional inner mapping + // rules. If VLANs are not explicitly mapped to any appliance, the + // defaultApplianceIpAddress is used. + // + // Each VLAN tag can be a single number or a range of numbers in the range + // of 1 to 4094, e.g., "1" or "4001-4094". Non-empty and non-overlapping + // VLAN tag ranges are enforced, and violating operations will be rejected. + // + // The VLAN tags in the Ethernet header must use an ethertype value of + // 0x88A8 or 0x8100. + map + appliance_mappings = 1 [json_name = "applianceMappings"]; + + // Optional. A single IPv4 or IPv6 address used as the default destination + // IP when there is no VLAN mapping result found. + // + // Unset field (null-value) indicates the unmatched packet should be + // dropped. + optional string default_appliance_ip_address = 2 + [json_name = "defaultApplianceIpAddress"]; + + // Optional. It represents the structure of a Geneve (Generic Network + // Virtualization Encapsulation) header, as defined in RFC8926. It + // encapsulates packets from various + // protocols (e.g., Ethernet, IPv4, IPv6) for use in network virtualization + // environments. + optional InterconnectAttachmentL2ForwardingGeneveHeader geneve_header = 3 + [json_name = "geneveHeader"]; + + // Required. Resource URL of the network to which this attachment belongs. + optional string network = 4 [json_name = "network"]; + + // Required. A single IPv4 or IPv6 address. This address will be used as the + // source IP address for packets sent to the appliances, and must be used as + // the destination IP address for packets that should be sent out through + // this attachment. + optional string tunnel_endpoint_ip_address = 5 + [json_name = "tunnelEndpointIpAddress"]; +} + +// Two-level VLAN-to-Appliance mapping rule. +message InterconnectAttachmentL2ForwardingApplianceMapping { + // Optional. A single IPv4 or IPv6 address used as the destination IP + // address for ingress packets that match on a VLAN tag, but do not match + // a more specific inner VLAN tag. + // + // Unset field (null-value) indicates both VLAN tags are required to be + // mapped. Otherwise, defaultApplianceIpAddress is used. + optional string appliance_ip_address = 1 [json_name = "applianceIpAddress"]; + + // Optional. Used to match against the inner VLAN when the packet + // contains two VLAN tags. + // + // A list of mapping rules from inner VLAN tags to IP addresses. If the + // inner VLAN is not explicitly mapped to an IP address range, the + // applianceIpAddress is used. + repeated + InterconnectAttachmentL2ForwardingApplianceMappingInnerVlanToApplianceMapping + inner_vlan_to_appliance_mappings = 2 + [json_name = "innerVlanToApplianceMappings"]; + + // Optional. The name of this appliance mapping rule. + optional string name = 3 [json_name = "name"]; +} + +// The inner VLAN-to-Appliance mapping. +message +InterconnectAttachmentL2ForwardingApplianceMappingInnerVlanToApplianceMapping { + // Required in this object. A single IPv4 or IPv6 address used as the + // destination IP address for ingress packets that match on both VLAN + // tags. + optional string inner_appliance_ip_address = 1 + [json_name = "innerApplianceIpAddress"]; + + // Required in this object. Used to match the inner VLAN tag on the + // packet. Each entry can be a single number or a range of numbers in + // the range of 1 to 4094, e.g., ["1", "4001-4094"] is valid. Non-empty + // and Non-overlapping VLAN tag ranges are enforced, and violating + // operations will be rejected. + // + // The inner VLAN tags must have an ethertype value of 0x8100. + repeated string inner_vlan_tags = 2 [json_name = "innerVlanTags"]; +} + +// GeneveHeader related configurations. +message InterconnectAttachmentL2ForwardingGeneveHeader { + // Optional. VNI is a 24-bit unique virtual network identifier, from 0 to + // 16,777,215. + optional uint32 vni = 1 [json_name = "vni"]; +} + +// 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. [Output Only] Type of resource. + // Alwayscompute#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 thanmaxResults, use the + // nextPageToken as a value 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. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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 interconnect attachment parameters. +message InterconnectAttachmentParams { + // Tag keys/values directly bound to this resource. + // Tag keys and values have the same definition as resource + // manager tags. The field is allowed for INSERT + // only. The keys/values to set on the resource should be specified in + // either ID { : } or Namespaced format + // { : }. + // For example the following are valid inputs: + // * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} + // * {"123/environment" : "production", "345/abc" : "xyz"} + // Note: + // * Invalid combinations of ID & namespaced format is not supported. For + // instance: {"123/environment" : "tagValues/444"} is invalid. + // * Inconsistent format is not supported. For instance: + // {"tagKeys/333" : "tagValues/444", "123/env" : "prod"} is invalid. + map resource_manager_tags = 1 + [json_name = "resourceManagerTags"]; +} + +// 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 NetworkEdgeSecurityServicesScopedList { - // A list of NetworkEdgeSecurityServices contained in this scope. - repeated NetworkEdgeSecurityService network_edge_security_services = 1 - [json_name = "networkEdgeSecurityServices"]; +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. + // [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. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -255,26 +956,34 @@ message NetworkEdgeSecurityServicesScopedList { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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. + // 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_086.proto b/protos/google/cloud/compute/v1/internal/common_086.proto index c9115dfa34e5e..43c5d022b8722 100644 --- a/protos/google/cloud/compute/v1/internal/common_086.proto +++ b/protos/google/cloud/compute/v1/internal/common_086.proto @@ -15,238 +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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_012.proto"; - -message NetworkEndpointGroupAggregatedList { - // [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"]; - - // [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 - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value 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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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 InterconnectAttachmentConfigurationConstraints { + // Output only. [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. [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 NetworkEndpointGroupsAttachEndpointsRequest { - // The list of network endpoints to be attached. - repeated NetworkEndpoint network_endpoints = 1 - [json_name = "networkEndpoints"]; -} - -message NetworkEndpointGroupsDetachEndpointsRequest { - // The list of network endpoints to be detached. - repeated NetworkEndpoint network_endpoints = 1 - [json_name = "networkEndpoints"]; -} - -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 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 - // 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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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 InterconnectAttachmentConfigurationConstraintsBgpPeerASNRange { + optional uint32 max = 1 [json_name = "max"]; - // [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"]; + optional uint32 min = 2 [json_name = "min"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_087.proto b/protos/google/cloud/compute/v1/internal/common_087.proto index 800f649a2092b..387d82b509bdd 100644 --- a/protos/google/cloud/compute/v1/internal/common_087.proto +++ b/protos/google/cloud/compute/v1/internal/common_087.proto @@ -15,281 +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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -// NetworkProfile represents a Google managed network profile resource. -message NetworkProfile { - reserved 10; - // [Output Only] Creation timestamp in RFC3339 text format. - optional string creation_timestamp = 1 [json_name = "creationTimestamp"]; +// An interconnect attachment group resource allows customers to create, +// analyze, and expand highly available deployments. +message InterconnectAttachmentGroup { + // Attachments in the AttachmentGroup. Keys are arbitrary user-specified + // strings. Users are encouraged, but not required, to use their preferred + // format for resource links as keys. + // Note that there are add-members and remove-members methods in gcloud. + // The size of this map is limited by an "Attachments per group" quota. + map attachments = 1 + [json_name = "attachments"]; + + optional InterconnectAttachmentGroupConfigured configured = 2 + [json_name = "configured"]; + + // Output only. [Output Only] Creation timestamp inRFC3339 + // 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"]; + + // Opaque system-generated token that uniquely identifies the configuration. + // If provided when patching a configuration in update mode, the provided + // token must match the current token or the update is rejected. This provides + // a reliable means of doing read-modify-write (optimistic locking) as + // described byAIP 154. + optional string etag = 5 [json_name = "etag"]; + + // Output only. [Output Only] The unique identifier for the resource type. The + // server + // generates this identifier. + optional string id = 6 [json_name = "id"]; + + optional InterconnectAttachmentGroupIntent intent = 7 [json_name = "intent"]; + + // The URL of an InterconnectGroup that groups these Attachments' + // Interconnects. Customers do not need to set this unless directed by + // Google Support. + optional string interconnect_group = 8 [json_name = "interconnectGroup"]; + + // Output only. [Output Only] Type of the resource. Always + // compute#interconnectAttachmentGroup. + optional string kind = 9 [json_name = "kind"]; + + optional InterconnectAttachmentGroupLogicalStructure logical_structure = 10 + [json_name = "logicalStructure"]; + + // Name of the resource. Provided by the client when the resource is created. + // The name must be 1-63 characters long, and comply withRFC1035. + // 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. [Output Only] Server-defined URL for the resource. + optional string self_link = 12 [json_name = "selfLink"]; +} - // [Output Only] An optional description of this resource. - optional string description = 2 [json_name = "description"]; +// An Attachment in this AttachmentGroup. +message InterconnectAttachmentGroupAttachment { + optional string attachment = 1 [json_name = "attachment"]; +} - // [Output Only] Features supported by the network. - optional NetworkProfileNetworkFeatures features = 3 [json_name = "features"]; +// [Output Only] The redundancy this group is configured to support. The way a +// user queries what SLA their Attachment gets is by looking at this field of +// the Attachment's AttachmentGroup. +message InterconnectAttachmentGroupConfigured { + optional InterconnectAttachmentGroupConfiguredAvailabilitySLA + availability_sla = 1 [json_name = "availabilitySla"]; +} - // [Output Only] The unique identifier for the resource. This identifier is - // defined by the server. - optional string id = 4 [json_name = "id"]; +// [Output Only] Which SLA this group is configured to support, and why this +// group does or does not meet that SLA's requirements. +message InterconnectAttachmentGroupConfiguredAvailabilitySLA { + // EFFECTIVE_SLA_UNSPECIFIED: + // NO_SLA: + // PRODUCTION_CRITICAL: + // PRODUCTION_NON_CRITICAL: + optional string effective_sla = 1 [json_name = "effectiveSla"]; + + repeated + InterconnectAttachmentGroupConfiguredAvailabilitySLAIntendedSlaBlockers + intended_sla_blockers = 2 [json_name = "intendedSlaBlockers"]; +} - // [Output Only] Type of the resource. Always compute#networkProfile for - // network profiles. - optional string kind = 5 [json_name = "kind"]; +// [Output Only] Reasons why configuration.availabilitySLA.sla differs from +// intent.availabilitySLA. This list is empty if and only if those are the +// same. +message +InterconnectAttachmentGroupConfiguredAvailabilitySLAIntendedSlaBlockers { + // Output only. [Output Only] URLs of any particular Attachments to explain + // this + // blocker in more detail. + repeated string attachments = 1 [json_name = "attachments"]; + + // BLOCKER_TYPE_UNSPECIFIED: + // INCOMPATIBLE_METROS: + // INCOMPATIBLE_REGIONS: + // MISSING_GLOBAL_ROUTING: + // NO_ATTACHMENTS: + // NO_ATTACHMENTS_IN_METRO_AND_ZONE: + // OTHER: + optional string blocker_type = 2 [json_name = "blockerType"]; + + // Output only. [Output Only] The url of Google Cloud public documentation + // explaining + // this requirement. This is set for every type of requirement. + optional string documentation_link = 3 [json_name = "documentationLink"]; + + // Output only. [Output Only] A human-readable explanation of this requirement + // and + // why it's not met. This is set for every type of requirement. + optional string explanation = 4 [json_name = "explanation"]; + + // Output only. [Output Only] Metros used to explain this blocker in more + // detail. + // These are three-letter lowercase strings like "iad". This will be set + // for some blockers (like NO_ATTACHMENTS_IN_METRO_AND_ZONE) but does + // not apply to others. + repeated string metros = 5 [json_name = "metros"]; + + // Output only. [Output Only] Regions used to explain this blocker in more + // detail. These are region names formatted like "us-central1". This + // will be set for some blockers (like INCOMPATIBLE_REGIONS) but does + // not apply to others. + repeated string regions = 6 [json_name = "regions"]; + + // Output only. [Output Only] Zones used to explain this blocker in more + // detail. + // Format is "zone1" and/or "zone2". This will be set for some blockers + // (like MISSING_ZONE) but does not apply to others. + repeated string zones = 7 [json_name = "zones"]; +} - // [Output Only] Location to which the network is restricted. - optional NetworkProfileLocation location = 6 [json_name = "location"]; +// The user's intent for this AttachmentGroup. This is the only required field +// besides the name that must be specified on group creation. +message InterconnectAttachmentGroupIntent { + // AVAILABILITY_SLA_UNSPECIFIED: + // NO_SLA: + // PRODUCTION_CRITICAL: + // PRODUCTION_NON_CRITICAL: + optional string availability_sla = 1 [json_name = "availabilitySla"]; +} - // [Output Only] Name of the resource. - optional string name = 7 [json_name = "name"]; +// [Output Only] An analysis of the logical layout of Attachments in this +// group. Every Attachment in the group is shown once in this structure. +message InterconnectAttachmentGroupLogicalStructure { + repeated InterconnectAttachmentGroupLogicalStructureRegion regions = 1 + [json_name = "regions"]; +} - // [Output Only] Server-defined URL for the resource. - optional string self_link = 8 [json_name = "selfLink"]; +// [Output Only] The regions Attachments in this group are in. +message InterconnectAttachmentGroupLogicalStructureRegion { + repeated InterconnectAttachmentGroupLogicalStructureRegionMetro metros = 1 + [json_name = "metros"]; - // [Output Only] Server-defined URL for this resource with the resource id. - optional string self_link_with_id = 9 [json_name = "selfLinkWithId"]; + // Output only. [Output Only] The name of a region, like "us-central1". + optional string region = 2 [json_name = "region"]; } -message NetworkProfileLocation { - optional string name = 1 [json_name = "name"]; +// [Output Only] The metros of Attachments in this group in this region. +message InterconnectAttachmentGroupLogicalStructureRegionMetro { + repeated InterconnectAttachmentGroupLogicalStructureRegionMetroFacility + facilities = 1 [json_name = "facilities"]; + + // Output only. [Output Only] The name of the metro, as a three-letter + // lowercase + // string like "iad". This is the first component of the location of an + // Interconnect. + optional string metro = 2 [json_name = "metro"]; +} + +// [Output Only] The facilities used for this group's Attachments' +// Interconnects. +message InterconnectAttachmentGroupLogicalStructureRegionMetroFacility { + // Output only. [Output Only] The name of a facility, like "iad-1234". + optional string facility = 1 [json_name = "facility"]; + + repeated InterconnectAttachmentGroupLogicalStructureRegionMetroFacilityZone + zones = 2 [json_name = "zones"]; +} - // REGION: - // ZONE: - optional string scope = 2 [json_name = "scope"]; +// [Output Only] The zones that Attachments in this group are present +// in, in the given facilities. This is inherited from their +// Interconnects. +message InterconnectAttachmentGroupLogicalStructureRegionMetroFacilityZone { + // Output only. [Output Only] URLs of Attachments in the given zone, to the + // given + // region, on Interconnects in the given facility and metro. Every + // Attachment in the AG has such an entry. + repeated string attachments = 1 [json_name = "attachments"]; + + // Output only. [Output Only] The name of a zone, either "zone1" or "zone2". + optional string zone = 2 [json_name = "zone"]; } -message NetworkProfileNetworkFeatures { - // Specifies what address purposes are supported. If empty, all address - // purposes are supported. - repeated string address_purposes = 1 [json_name = "addressPurposes"]; - - // Specifies whether alias IP ranges (and secondary address ranges) are - // allowed. - // ALIAS_IP_RANGES_ALLOWED: - // ALIAS_IP_RANGES_BLOCKED: - optional string allow_alias_ip_ranges = 2 [json_name = "allowAliasIpRanges"]; - - // Specifies whether auto mode subnet creation is allowed. - // AUTO_MODE_SUBNET_ALLOWED: - // AUTO_MODE_SUBNET_BLOCKED: - optional string allow_auto_mode_subnet = 3 - [json_name = "allowAutoModeSubnet"]; - - // Specifies whether firewalls for Class D address ranges are supported. - // CLASS_D_FIREWALLS_ALLOWED: - // CLASS_D_FIREWALLS_BLOCKED: - optional string allow_class_d_firewalls = 4 - [json_name = "allowClassDFirewalls"]; - - // Specifies whether cloud NAT creation is allowed. - // CLOUD_NAT_ALLOWED: - // CLOUD_NAT_BLOCKED: - optional string allow_cloud_nat = 5 [json_name = "allowCloudNat"]; - - // Specifies whether cloud router creation is allowed. - // CLOUD_ROUTER_ALLOWED: - // CLOUD_ROUTER_BLOCKED: - optional string allow_cloud_router = 6 [json_name = "allowCloudRouter"]; - - // Specifies whether default NIC attachment is allowed. - // DEFAULT_NIC_ATTACHMENT_ALLOWED: - // DEFAULT_NIC_ATTACHMENT_BLOCKED: - optional string allow_default_nic_attachment = 23 - [json_name = "allowDefaultNicAttachment"]; - - // Specifies whether VMs are allowed to have external IP access on network - // interfaces connected to this VPC. - // EXTERNAL_IP_ACCESS_ALLOWED: - // EXTERNAL_IP_ACCESS_BLOCKED: - optional string allow_external_ip_access = 7 - [json_name = "allowExternalIpAccess"]; - - // Specifies whether Cloud Interconnect creation is allowed. - // INTERCONNECT_ALLOWED: - // INTERCONNECT_BLOCKED: - optional string allow_interconnect = 8 [json_name = "allowInterconnect"]; - - // Specifies whether IP forwarding is allowed. - // IP_FORWARDING_ALLOWED: - // IP_FORWARDING_BLOCKED: - optional string allow_ip_forwarding = 24 [json_name = "allowIpForwarding"]; - - // Specifies whether cloud load balancing is allowed. - // LOAD_BALANCING_ALLOWED: - // LOAD_BALANCING_BLOCKED: - optional string allow_load_balancing = 9 [json_name = "allowLoadBalancing"]; - - // Specifies whether multi-nic in the same network is allowed. - // MULTI_NIC_IN_SAME_NETWORK_ALLOWED: - // MULTI_NIC_IN_SAME_NETWORK_BLOCKED: - optional string allow_multi_nic_in_same_network = 10 - [json_name = "allowMultiNicInSameNetwork"]; - - // Specifies whether NCC is allowed. - // NCC_ALLOWED: - // NCC_BLOCKED: - optional string allow_ncc = 25 [json_name = "allowNcc"]; - - // Specifies whether VM network migration is allowed. - // NETWORK_MIGRATION_ALLOWED: - // NETWORK_MIGRATION_BLOCKED: - optional string allow_network_migration = 26 - [json_name = "allowNetworkMigration"]; - - // Specifies whether Packet Mirroring 1.0 is supported. - // PACKET_MIRRORING_ALLOWED: - // PACKET_MIRRORING_BLOCKED: - optional string allow_packet_mirroring = 11 - [json_name = "allowPacketMirroring"]; - - // Specifies whether private Google access is allowed. - // PRIVATE_GOOGLE_ACCESS_ALLOWED: - // PRIVATE_GOOGLE_ACCESS_BLOCKED: - optional string allow_private_google_access = 12 - [json_name = "allowPrivateGoogleAccess"]; - - // Specifies whether PSC creation is allowed. - // PSC_ALLOWED: - // PSC_BLOCKED: - optional string allow_psc = 13 [json_name = "allowPsc"]; - - // Specifies whether unicast within the same network is allowed. - // SAME_NETWORK_UNICAST_ALLOWED: - // SAME_NETWORK_UNICAST_BLOCKED: - optional string allow_same_network_unicast = 14 - [json_name = "allowSameNetworkUnicast"]; - - // Specifies whether static route creation is allowed. - // STATIC_ROUTES_ALLOWED: - // STATIC_ROUTES_BLOCKED: - optional string allow_static_routes = 15 [json_name = "allowStaticRoutes"]; - - // Specifies whether sub interfaces are allowed. - // SUBINTERFACES_ALLOWED: - // SUBINTERFACES_BLOCKED: - optional string allow_sub_interfaces = 16 [json_name = "allowSubInterfaces"]; - - // Specifies whether VPC peering is allowed. - // VPC_PEERING_ALLOWED: - // VPC_PEERING_BLOCKED: - optional string allow_vpc_peering = 17 [json_name = "allowVpcPeering"]; - - // Specifies whether VPN creation is allowed. - // VPN_ALLOWED: - // VPN_BLOCKED: - optional string allow_vpn = 18 [json_name = "allowVpn"]; - - // If set, limits the interface types that the network supports. If empty, all - // interface types are supported. - repeated string interface_types = 19 [json_name = "interfaceTypes"]; - - // Specifies which subnetwork purposes are supported. - repeated string subnet_purposes = 20 [json_name = "subnetPurposes"]; - - // Specifies which subnetwork stack types are supported. - repeated string subnet_stack_types = 21 [json_name = "subnetStackTypes"]; - - // Specifies which subnetwork purposes are supported. - repeated string subnetwork_purposes = 27 [json_name = "subnetworkPurposes"]; - - // Specifies which subnetwork stack types are supported. - repeated string subnetwork_stack_types = 28 - [json_name = "subnetworkStackTypes"]; - - // Specifies which type of unicast is supported. - // UNICAST_SDN: - // UNICAST_ULL: - optional string unicast = 22 [json_name = "unicast"]; +// Response for the InterconnectAttachmentGroupsGetOperationalStatusResponse. +message InterconnectAttachmentGroupsGetOperationalStatusResponse { + optional string etag = 1 [json_name = "etag"]; + + optional InterconnectAttachmentGroupsOperationalStatus result = 2 + [json_name = "result"]; } -// Contains a list of network profiles. -message NetworkProfilesListResponse { +message InterconnectAttachmentGroupsListResponse { 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 NetworkProfile resources. - repeated NetworkProfile items = 3 [json_name = "items"]; + // A list of InterconnectAttachmentGroup resources. + repeated InterconnectAttachmentGroup items = 3 [json_name = "items"]; - // [Output Only] Type of resource. Always compute#networkProfileList for - // network profiles. 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 + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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: + // Output only. [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. + // [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. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -298,19 +331,27 @@ message NetworkProfilesListResponse { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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. @@ -320,3 +361,65 @@ message NetworkProfilesListResponse { // [Output Only] Informational warning message. optional Warning warning = 8 [json_name = "warning"]; } + +message InterconnectAttachmentGroupsOperationalStatus { + repeated InterconnectAttachmentGroupsOperationalStatusAttachmentStatus + attachment_statuses = 1 [json_name = "attachmentStatuses"]; + + optional InterconnectAttachmentGroupConfigured configured = 2 + [json_name = "configured"]; + + // Output only. Summarizes the status of the group. + // DEGRADED: + // FULLY_DOWN: + // FULLY_UP: + // UNSPECIFIED: + optional string group_status = 3 [json_name = "groupStatus"]; + + optional InterconnectAttachmentGroupIntent intent = 4 [json_name = "intent"]; + + // Output only. The operational state of the group, including only active + // Attachments. + optional InterconnectAttachmentGroupConfigured operational = 5 + [json_name = "operational"]; +} + +// The status of one Attachment in the group. List order is arbitrary. +message InterconnectAttachmentGroupsOperationalStatusAttachmentStatus { + // Output only. Whether this Attachment is enabled. This becomes false when + // the customer + // drains their Attachment. + optional bool admin_enabled = 1 [json_name = "adminEnabled"]; + + // Output only. The URL of the Attachment being described. + optional string attachment = 2 [json_name = "attachment"]; + + // Output only. Whether this Attachment is participating in the redundant + // configuration. + // This will be ACTIVE if and only if the status below is CONNECTION_UP. + // Any INACTIVE Attachments are excluded from the analysis that generates + // operational.availabilitySLA. + // ACTIVE: + // INACTIVE: + // UNSPECIFIED: + optional string is_active = 3 [json_name = "isActive"]; + + // Output only. Whether this Attachment is active, and if so, whether BGP is + // up. + // ATTACHMENT_STATUS_UNKNOWN: + // CONNECTION_DISABLED: + // CONNECTION_DOWN: + // CONNECTION_UP: + // DEFUNCT: + // IPSEC_CONFIGURATION_NEEDED_STATUS: + // IPSEC_READY_TO_RESUME_FLOW_STATUS: + // IPV4_DOWN_IPV6_UP: + // IPV4_UP_IPV6_DOWN: + // PARTNER_REQUEST_RECEIVED: + // PENDING_CUSTOMER: + // PENDING_PARTNER: + // PROVISIONED: + // ROUTER_CONFIGURATION_BROKEN: + // UNPROVISIONED: + optional string status = 4 [json_name = "status"]; +} diff --git a/protos/google/cloud/compute/v1/internal/common_088.proto b/protos/google/cloud/compute/v1/internal/common_088.proto index 5bfe4505a9dfa..205f9addd3295 100644 --- a/protos/google/cloud/compute/v1/internal/common_088.proto +++ b/protos/google/cloud/compute/v1/internal/common_088.proto @@ -15,406 +15,159 @@ // 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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_001.proto"; -import "google/cloud/compute/v1/internal/common_078.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 = 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"]; - - 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"]; - - // [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"]; +// 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"]; } -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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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"]; +// 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"]; - 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"]; + // The MAC address of this ARP neighbor. + optional string mac_address = 2 [json_name = "macAddress"]; } -// 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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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 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 NodeTemplateNodeTypeFlexibility { - optional string cpus = 1 [json_name = "cpus"]; - - optional string local_ssd = 2 [json_name = "localSsd"]; - - optional string memory = 3 [json_name = "memory"]; +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 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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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"]; +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"]; +} - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } +// 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"]; - // [Output Only] An informational warning that appears when the node templates - // list is empty. - optional Warning warning = 2 [json_name = "warning"]; + // Indicates whether or not MACsec is operational on this link. + optional bool operational = 2 [json_name = "operational"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_089.proto b/protos/google/cloud/compute/v1/internal/common_089.proto index 637aeddef35da..9929cb0de9a51 100644 --- a/protos/google/cloud/compute/v1/internal/common_089.proto +++ b/protos/google/cloud/compute/v1/internal/common_089.proto @@ -15,254 +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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_023.proto"; +import "google/cloud/compute/v1/internal/common_088.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"]; +// An interconnect group resource allows customers to create, analyze, and +// expand their redundant connections. +message InterconnectGroup { + optional InterconnectGroupConfigured configured = 1 + [json_name = "configured"]; - // [Output Only] Creation timestamp in RFC3339 text format. + // Output only. [Output Only] Creation timestamp inRFC3339 + // 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] Maximum number of VMs that can be created for this node type. - optional int32 max_vms = 13 [json_name = "maxVms"]; - - // [Output Only] The amount of physical memory available to the node type, - // defined in MB. - optional int32 memory_mb = 9 [json_name = "memoryMb"]; + // An optional description of this resource. Provide this property when you + // create the resource. + optional string description = 3 [json_name = "description"]; + + // Opaque system-generated token that uniquely identifies the configuration. + // If provided when patching a configuration in update mode, the provided + // token must match the current token or the update is rejected. This provides + // a reliable means of doing read-modify-write (optimistic locking) as + // described by AIP 154. + optional string etag = 4 [json_name = "etag"]; + + // Output only. [Output Only] The unique identifier for the resource type. The + // server + // generates this identifier. + optional string id = 5 [json_name = "id"]; + + optional InterconnectGroupIntent intent = 6 [json_name = "intent"]; + + // Interconnects in the InterconnectGroup. Keys are arbitrary user-specified + // strings. Users are encouraged, but not required, to use their preferred + // format for resource links as keys. + // Note that there are add-members and remove-members methods in gcloud. + // The size of this map is limited by an "Interconnects per group" quota. + map interconnects = 7 + [json_name = "interconnects"]; + + // Output only. [Output Only] Type of the resource. Always + // compute#InterconnectGroup + 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 withRFC1035. + // 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 InterconnectGroupPhysicalStructure physical_structure = 10 + [json_name = "physicalStructure"]; + + // Output only. [Output Only] Server-defined URL for the resource. + optional string self_link = 11 [json_name = "selfLink"]; +} - // [Output Only] Name of the resource. - optional string name = 10 [json_name = "name"]; +// [Output Only] The status of the group as configured. This has the same +// structure as the operational field reported by the OperationalStatus +// method, but does not take into account the operational status of each +// resource. +message InterconnectGroupConfigured { + optional InterconnectGroupConfiguredTopologyCapability topology_capability = 1 + [json_name = "topologyCapability"]; +} - // [Output Only] Server-defined URL for the resource. - optional string self_link = 11 [json_name = "selfLink"]; +// [Output Only] How reliable this topology is configured to be, and why +// this group does or does not meet the requirements for the intended +// capability. +message InterconnectGroupConfiguredTopologyCapability { + repeated + InterconnectGroupConfiguredTopologyCapabilityIntendedCapabilityBlockers + intended_capability_blockers = 1 + [json_name = "intendedCapabilityBlockers"]; + + // NO_SLA: + // PRODUCTION_CRITICAL: + // PRODUCTION_NON_CRITICAL: + // UNSPECIFIED: + optional string supported_sla = 2 [json_name = "supportedSla"]; +} - // [Output Only] The name of the zone where the node type resides, such as - // us-central1-a. - optional string zone = 12 [json_name = "zone"]; +// [Output Only] Reasons why configuration.topologyCapability.sla differs +// from intent.topologyCapability. This list is empty if and only if those +// are the same. +message +InterconnectGroupConfiguredTopologyCapabilityIntendedCapabilityBlockers { + // INCOMPATIBLE_METROS: + // NOT_AVAILABLE: + // NO_INTERCONNECTS: + // NO_INTERCONNECTS_IN_METRO_AND_ZONE: + // OTHER: + // UNSPECIFIED: + optional string blocker_type = 1 [json_name = "blockerType"]; + + // Output only. [Output Only] The url of Google Cloud public documentation + // explaining + // this requirement. This is set for every type of requirement. + optional string documentation_link = 2 [json_name = "documentationLink"]; + + // Output only. [Output Only] A human-readable explanation of this requirement + // and + // why it's not met. This is set for every type of requirement. + optional string explanation = 3 [json_name = "explanation"]; + + // Output only. [Output Only] Facilities used to explain this blocker in more + // detail. + // Like physicalStructure.metros.facilities.facility, this is a numeric + // string like "5467". + repeated string facilities = 4 [json_name = "facilities"]; + + // Output only. [Output Only] Interconnects used to explain this blocker in + // more + // detail. + repeated string interconnects = 5 [json_name = "interconnects"]; + + // Output only. [Output Only] Metros used to explain this blocker in more + // detail. + // These are three-letter lowercase strings like "iad". A blocker like + // INCOMPATIBLE_METROS will specify the problematic metros in this + // field. + repeated string metros = 6 [json_name = "metros"]; + + // Output only. [Output Only] Zones used to explain this blocker in more + // detail. + // Zone names are "zone1" and/or "zone2". + repeated string zones = 7 [json_name = "zones"]; } -message NodeTypeAggregatedList { - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 1 [json_name = "id"]; +// The user's intent for this group. This is the only required field besides +// the name that must be specified on group creation. +message InterconnectGroupIntent { + // NO_SLA: + // PRODUCTION_CRITICAL: + // PRODUCTION_NON_CRITICAL: + // UNSPECIFIED: + optional string topology_capability = 1 [json_name = "topologyCapability"]; +} - // A list of NodeTypesScopedList resources. - map items = 2 [json_name = "items"]; +// An Interconnect in this InterconnectGroup. +message InterconnectGroupInterconnect { + // The URL of an Interconnect in this group. All Interconnects in the group + // are unique. + optional string interconnect = 1 [json_name = "interconnect"]; +} - // [Output Only] Type of resource.Always compute#nodeTypeAggregatedList for - // aggregated lists of node types. - optional string kind = 3 [json_name = "kind"]; +// [Output Only] An analysis of the physical layout of Interconnects in this +// group. Every Interconnect in the group is shown once in this structure. +message InterconnectGroupPhysicalStructure { + repeated InterconnectGroupPhysicalStructureMetros metros = 1 + [json_name = "metros"]; +} - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value 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 metros Interconnects in this group are in. +message InterconnectGroupPhysicalStructureMetros { + repeated InterconnectGroupPhysicalStructureMetrosFacilities facilities = 1 + [json_name = "facilities"]; - // [Output Only] Server-defined URL for this resource. - optional string self_link = 5 [json_name = "selfLink"]; + // Output only. [Output Only] The name of the metro, as a three-letter + // lowercase string + // like "iad". This is the first component of the location of + // Interconnects underneath this. + optional string metro = 2 [json_name = "metro"]; +} - // [Output Only] Unreachable resources. - repeated string unreachables = 6 [json_name = "unreachables"]; +// [Output Only] The facilities Interconnects in this metro are present +// in. +message InterconnectGroupPhysicalStructureMetrosFacilities { + // Output only. [Output Only] The ID of this facility, as a numeric string + // like + // "5467". This is the third component of the location of Interconnects + // in this facility. + optional string facility = 1 [json_name = "facility"]; + + repeated InterconnectGroupPhysicalStructureMetrosFacilitiesZones zones = 2 + [json_name = "zones"]; +} - 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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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] The zones that Interconnects in this facility are +// present in. +message InterconnectGroupPhysicalStructureMetrosFacilitiesZones { + // Output only. [Output Only] URLs of Interconnects in this redundancy group + // in the + // given metro, facility, and zone. + repeated string interconnects = 1 [json_name = "interconnects"]; + + // Output only. [Output Only] The name of the zone, either "zone1" or "zone2". + // This is the second component of the location of Interconnects in + // this facility. + optional string zone = 2 [json_name = "zone"]; +} - 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 InterconnectGroupsCreateMembers { + // How to behave when configured.topologyCapability.supportedSLA would not + // equal intent.topologyCapability after this call. + // CREATE: + // REJECT: + // UNSPECIFIED: + optional string intent_mismatch_behavior = 1 + [json_name = "intentMismatchBehavior"]; + + repeated InterconnectGroupsCreateMembersInterconnectInput interconnects = 2 + [json_name = "interconnects"]; + + // Parameters for the Interconnects to create. + optional InterconnectGroupsCreateMembersInterconnectInput + template_interconnect = 3 [json_name = "templateInterconnect"]; +} - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } +message InterconnectGroupsCreateMembersInterconnectInput { + // 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"]; + + // Customer name, to put in the Letter of Authorization as the party + // authorized to request a crossconnect. + optional string customer_name = 2 [json_name = "customerName"]; + + // An optional description of this resource. Provide this property when you + // create the resource. + optional string description = 3 [json_name = "description"]; + + // A zone-free location to use for all Interconnects created in this call, + // like "iad-1234". + optional string facility = 4 [json_name = "facility"]; + + // 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 = 5 [json_name = "interconnectType"]; + + // 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. + // - LINK_TYPE_ETHERNET_400G_LR4: A 400G Ethernet with LR4 + // 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]; + // LINK_TYPE_ETHERNET_400G_LR4: 400G Ethernet, LR4 Optics. + optional string link_type = 6 [json_name = "linkType"]; + + // Name of the Interconnects to be created. This must be specified on the + // template and/or on each individual interconnect. The name, if not empty, + // must be 1-63 characters long, and comply with RFC1035. + // Specifically, any nonempty 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"]; + + // 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 = 8 [json_name = "nocContactEmail"]; + + // 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 = 9 [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, non-MACsec capable ports will + // also be considered. + // - IF_CROSS_SITE_NETWORK: If specified, then the connection is created + // exclusively for Cross-Site Networking. The connection can not be used + // for + // Cross-Site Networking unless this feature is specified. + repeated string requested_features = 10 [json_name = "requestedFeatures"]; + + // Target number of physical links in the link bundle, as requested by the + // customer. + optional int32 requested_link_count = 11 [json_name = "requestedLinkCount"]; +} - // [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 InterconnectGroupsCreateMembersRequest { + optional InterconnectGroupsCreateMembers request = 1 [json_name = "request"]; +} - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } +// Response for the InterconnectGroupsGetOperationalStatusResponse. +message InterconnectGroupsGetOperationalStatusResponse { + optional string etag = 1 [json_name = "etag"]; - // [Output Only] Informational warning message. - optional Warning warning = 7 [json_name = "warning"]; + optional InterconnectGroupsOperationalStatus result = 2 + [json_name = "result"]; } -// Contains a list of node types. -message NodeTypeList { +message InterconnectGroupsListResponse { + 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 NodeType resources. - repeated NodeType items = 2 [json_name = "items"]; + // A list of InterconnectGroup resources. + repeated InterconnectGroup items = 3 [json_name = "items"]; - // [Output Only] Type of resource.Always compute#nodeTypeList for lists of - // node types. - optional string kind = 3 [json_name = "kind"]; + 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 + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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. [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. + // [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. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -271,19 +436,27 @@ message NodeTypeList { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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. @@ -291,97 +464,51 @@ message NodeTypeList { } // [Output Only] Informational warning message. - optional Warning warning = 6 [json_name = "warning"]; + optional Warning warning = 8 [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 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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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"]; - } +// Request to get the status of the interconnect group with extra detail. +message InterconnectGroupsOperationalStatus { + // Output only. The configuration analysis, as returned by Get. + optional InterconnectGroupConfigured configured = 1 + [json_name = "configured"]; + + // Output only. Summarizes the status of the group. + // DEGRADED: + // FULLY_DOWN: + // FULLY_UP: + // GROUPS_STATUS_UNSPECIFIED: + optional string group_status = 2 [json_name = "groupStatus"]; + + // Output only. The intent of the resource, as returned by Get. + optional InterconnectGroupIntent intent = 3 [json_name = "intent"]; + + repeated InterconnectGroupsOperationalStatusInterconnectStatus + interconnect_statuses = 4 [json_name = "interconnectStatuses"]; + + // Output only. The operational state of the group, including only active + // Interconnects. + optional InterconnectGroupConfigured operational = 5 + [json_name = "operational"]; +} - // [Output Only] An informational warning that appears when the node types - // list is empty. - optional Warning warning = 2 [json_name = "warning"]; +// The status of one Interconnect in the group. The order is arbitrary. +message InterconnectGroupsOperationalStatusInterconnectStatus { + // Output only. Whether the Interconnect is enabled. + optional bool admin_enabled = 1 [json_name = "adminEnabled"]; + + // Output only. The diagnostics of the Interconnect, as returned by the + // existing + // get-diagnostics method. + optional InterconnectDiagnostics diagnostics = 2 [json_name = "diagnostics"]; + + // Output only. The URL of the Interconnect being described. + optional string interconnect = 3 [json_name = "interconnect"]; + + // Output only. Whether this interconnect is participating in the redundant + // configuration. + // ACTIVE: + // INACTIVE: + // IS_ACTIVE_UNSPECIFIED: + optional string is_active = 4 [json_name = "isActive"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_090.proto b/protos/google/cloud/compute/v1/internal/common_090.proto index ddca5b8e3229a..b39d7e5fc8f35 100644 --- a/protos/google/cloud/compute/v1/internal/common_090.proto +++ b/protos/google/cloud/compute/v1/internal/common_090.proto @@ -15,163 +15,247 @@ // 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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -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 = 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 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. [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: + // + // - IF_MACSEC + // - IF_CROSS_SITE_NETWORK + 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 + // - LINK_TYPE_ETHERNET_400G_LR4 + 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. [Output Only] Creation timestamp inRFC3339 + // text format. + optional string creation_timestamp = 5 [json_name = "creationTimestamp"]; + + // [Output Only] A list of InterconnectLocation.CrossSiteInterconnectInfo + // objects, that describe where Cross-Site Interconnect wires may connect to + // from this location and associated connection parameters. Cross-Site + // Interconnect isn't allowed to locations which are not listed. + repeated InterconnectLocationCrossSiteInterconnectInfo + cross_site_interconnect_infos = 19 + [json_name = "crossSiteInterconnectInfos"]; + + // Output only. [Output Only] An optional description of the resource. + optional string description = 6 [json_name = "description"]; + + // Output only. [Output Only] The name of the provider for this facility + // (e.g., EQUINIX). + optional string facility_provider = 7 [json_name = "facilityProvider"]; + + // Output only. [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. [Output Only] The unique identifier for the resource. This + // identifier is + // defined by the server. + optional string id = 9 [json_name = "id"]; + + // Output only. [Output Only] Type of the resource. + // Alwayscompute#interconnectLocation for interconnect locations. + optional string kind = 10 [json_name = "kind"]; + + // Output only. [Output Only] Name of the resource. + optional string name = 11 [json_name = "name"]; + + // Output only. [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. [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. [Output Only] Server-defined URL for the resource. + optional string self_link = 14 [json_name = "selfLink"]; + + // Output only. [Output Only] URLs of the other locations that can pair up + // with this + // location to support Single-Region 99.99% SLA. E.g. iad-zone1-1 and + // iad-zone2-5467 are Single-Region 99.99% peer locations of each other. + repeated string single_region_production_critical_peer_locations = 20 + [json_name = "singleRegionProductionCriticalPeerLocations"]; + + // [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. [Output Only] Reserved for future use. + optional bool supports_pzs = 16 [json_name = "supportsPzs"]; } -// 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"]; +// Information about Cross-Site Interconnect wires which may be created +// between the containing location and another remote location. +message InterconnectLocationCrossSiteInterconnectInfo { + // Output only. The remote location for Cross-Site Interconnect wires. This + // specifies an + // InterconnectLocation city (metropolitan area designator), which itself + // may match multiple InterconnectLocations. + optional string city = 1 [json_name = "city"]; } -message NotificationEndpointList { +// 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 NotificationEndpoint resources. - repeated NotificationEndpoint items = 2 [json_name = "items"]; + // A list of InterconnectLocation resources. + repeated InterconnectLocation items = 2 [json_name = "items"]; - // [Output Only] Type of the resource. Always compute#notificationEndpoint for - // notification endpoints. + // Output only. [Output Only] Type of resource. + // Alwayscompute#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 - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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. + // Output only. [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. + // [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. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -180,19 +264,27 @@ message NotificationEndpointList { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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. @@ -202,3 +294,34 @@ message NotificationEndpointList { // [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 { + // Output only. Expected round-trip time in milliseconds, from this + // InterconnectLocation + // to a VM in this region. + optional string expected_rtt_ms = 1 [json_name = "expectedRttMs"]; + + // Output only. Identifies whether L2 Interconnect Attachments can be created + // in this + // region for interconnects that are in this location. + optional bool l2_forwarding_enabled = 4 [json_name = "l2ForwardingEnabled"]; + + // Output only. 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"]; + + // Output only. URL for the region of this location. + optional string region = 3 [json_name = "region"]; +} diff --git a/protos/google/cloud/compute/v1/internal/common_091.proto b/protos/google/cloud/compute/v1/internal/common_091.proto index ac373605df45c..db9b1488d1c0f 100644 --- a/protos/google/cloud/compute/v1/internal/common_091.proto +++ b/protos/google/cloud/compute/v1/internal/common_091.proto @@ -15,186 +15,309 @@ // 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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_086.proto"; -message OperationAggregatedList { - // [Output Only] The unique identifier for the resource. This identifier is +// 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. [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. [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. [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. [Output Only] Constraints on the parameters for creating + // Cross-Cloud + // Interconnect and associated InterconnectAttachments. + optional InterconnectRemoteLocationConstraints constraints = 4 + [json_name = "constraints"]; + + // Output only. [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. [Output Only] Creation timestamp inRFC3339 + // text format. + optional string creation_timestamp = 6 [json_name = "creationTimestamp"]; + + // Output only. [Output Only] An optional description of the resource. + optional string description = 7 [json_name = "description"]; + + // Output only. [Output Only] The name of the provider for this facility + // (e.g., EQUINIX). + optional string facility_provider = 8 [json_name = "facilityProvider"]; + + // Output only. [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. [Output Only] The unique identifier for the resource. This + // identifier is // defined by the server. - optional string id = 1 [json_name = "id"]; + optional string id = 10 [json_name = "id"]; - // [Output Only] A map of scoped operation lists. - map items = 2 [json_name = "items"]; + // Output only. [Output Only] Type of the resource. + // Alwayscompute#interconnectRemoteLocation for interconnect remote + // locations. + optional string kind = 11 [json_name = "kind"]; - // [Output Only] Type of resource. Always `compute#operationAggregatedList` - // for aggregated lists of operations. - optional string kind = 3 [json_name = "kind"]; + // Output only. [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] This token allows you to get the next page of results for - // list requests. If the number of results is larger than `maxResults`, use - // the `nextPageToken` as a value 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. [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] Server-defined URL for this resource. - optional string self_link = 5 [json_name = "selfLink"]; + // Output only. [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] Unreachable resources. - repeated string unreachables = 6 [json_name = "unreachables"]; + // Output only. [Output Only] + // The maximum number of 400 Gbps ports supported in a link aggregation group + // (LAG). When linkType is 400 Gbps, requestedLinkCount cannot exceed + // max_lag_size_400_gbps. + optional int32 max_lag_size400_gbps = 21 [json_name = "maxLagSize400Gbps"]; - 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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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. [Output Only] Name of the resource. + optional string name = 15 [json_name = "name"]; - 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. [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] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } + // Output only. [Output Only] Permitted connections. + repeated InterconnectRemoteLocationPermittedConnections + permitted_connections = 17 [json_name = "permittedConnections"]; - // [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. [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] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } + // Output only. [Output Only] Server-defined URL for the resource. + optional string self_link = 19 [json_name = "selfLink"]; - // [Output Only] Informational warning message. - optional Warning warning = 7 [json_name = "warning"]; + // Output only. [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 OperationsScopedList { - // [Output Only] A list of operations contained in this scope. - repeated Operation operations = 1 [json_name = "operations"]; +message InterconnectRemoteLocationConstraints { + // Output only. [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. [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. [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"]; +} + +// 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. [Output Only] Type of resource. + // Alwayscompute#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 thanmaxResults, use the + // nextPageToken as a value 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. [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. + // [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. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -203,26 +326,41 @@ message OperationsScopedList { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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 operations - // when the list is empty. - optional Warning warning = 2 [json_name = "warning"]; + // [Output Only] Informational warning message. + optional Warning warning = 6 [json_name = "warning"]; +} + +message InterconnectRemoteLocationPermittedConnections { + // Output only. [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_092.proto b/protos/google/cloud/compute/v1/internal/common_092.proto index 6aacb38f78069..05bf6ab6b810b 100644 --- a/protos/google/cloud/compute/v1/internal/common_092.proto +++ b/protos/google/cloud/compute/v1/internal/common_092.proto @@ -15,93 +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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_038.proto"; + +// Represents a License resource. +// +// A License represents billing and aggregate usage data forpublic +// andmarketplace images. +// *Caution* This resource is intended for +// use only by third-party partners who are creatingCloud Marketplace +// images. +message License { + // Specifies licenseCodes of licenses that can replace this license. Note: + // such replacements are allowed even if removable_from_disk is false. + repeated string allowed_replacement_licenses = 11 + [json_name = "allowedReplacementLicenses"]; + + // If true, this license can be appended to an existing disk's set of + // licenses. + optional bool appendable_to_disk = 12 [json_name = "appendableToDisk"]; + + // [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. [Output Only] Creation timestamp inRFC3339 + // text format. + optional string creation_timestamp = 2 [json_name = "creationTimestamp"]; + + // An optional textual description of the resource; provided by the client + // when the resource is created. + optional string description = 3 [json_name = "description"]; -// 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"]; + optional string id = 4 [json_name = "id"]; + + // Specifies licenseCodes of licenses that are incompatible with this license. + // If a license is incompatible with this license, it cannot be attached to + // the same disk or image. + repeated string incompatible_licenses = 13 + [json_name = "incompatibleLicenses"]; + + // Output only. [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"]; + + // If set, this license will be unable to be removed or replaced once attached + // to a disk until the minimum_retention period has passed. + optional Duration minimum_retention = 14 [json_name = "minimumRetention"]; + + // If true, this license can only be used on VMs on multi tenant nodes. + optional bool multi_tenant_only = 15 [json_name = "multiTenantOnly"]; + + // Name of the resource. The name must be 1-63 characters long and + // comply withRFC1035. + optional string name = 7 [json_name = "name"]; + + // If true, indicates this is an OS license. Only one OS license can be + // attached to a disk or image at a time. + optional bool os_license = 16 [json_name = "osLicense"]; + + // Input only. Additional params passed with the request, but not persisted + // as part of resource payload. + optional LicenseParams params = 22 [json_name = "params"]; - // [Output Only] A list of Operation resources. - repeated Operation items = 2 [json_name = "items"]; + // If true, this license can be removed from a disk's set of licenses, with no + // replacement license needed. + optional bool removable_from_disk = 17 [json_name = "removableFromDisk"]; + + // Specifies the set of permissible coattached licenseCodes of licenses that + // satisfy the coattachment requirement of this license. At least one license + // from the set must be attached to the same disk or image as this license. + repeated string required_coattached_licenses = 18 + [json_name = "requiredCoattachedLicenses"]; + + // [Input Only] Deprecated. + optional LicenseResourceRequirements resource_requirements = 8 + [json_name = "resourceRequirements"]; + + // Output only. [Output Only] Server-defined URL for the resource. + optional string self_link = 9 [json_name = "selfLink"]; + + // Output only. [Output Only] Server-defined URL for this resource with the + // resource id. + optional string self_link_with_id = 19 [json_name = "selfLinkWithId"]; + + // If true, this license can only be used on VMs on sole tenant nodes. + optional bool sole_tenant_only = 20 [json_name = "soleTenantOnly"]; + + // 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"]; + + // Output only. [Output Only] Last update timestamp inRFC3339 + // text format. + optional string update_timestamp = 21 [json_name = "updateTimestamp"]; +} + +// Additional license params. +message LicenseParams { + // Input only. Resource manager tags to be bound to the license. Tag keys and + // values + // have the same definition as resource + // manager tags. Keys and values can be either in numeric format, + // such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in + // namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and + // `{tag_value_short_name}`. The field is ignored (both PUT & + // PATCH) when empty. + map resource_manager_tags = 1 + [json_name = "resourceManagerTags"]; +} + +message LicenseResourceRequirements { + // [Input Only] Deprecated. This field no longer reflects the minimum number + // of guest cpus required to use the Instance. + optional int32 min_guest_cpu_count = 1 [json_name = "minGuestCpuCount"]; + + // [Input Only] Deprecated. This field no longer reflects the minimum memory + // required to use the Instance. + 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"]; - // [Output Only] Type of resource. Always `compute#operations` for Operations - // resource. - 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"]; + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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 = 5 [json_name = "selfLink"]; + // Output only. [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. + // [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. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -110,19 +240,27 @@ message OperationList { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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. @@ -130,5 +268,5 @@ message OperationList { } // [Output Only] Informational warning message. - optional Warning warning = 6 [json_name = "warning"]; + optional Warning warning = 5 [json_name = "warning"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_093.proto b/protos/google/cloud/compute/v1/internal/common_093.proto index b96b352f247c6..fd62e1e0f17a0 100644 --- a/protos/google/cloud/compute/v1/internal/common_093.proto +++ b/protos/google/cloud/compute/v1/internal/common_093.proto @@ -15,469 +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: 20250601 +// revision: 20260807 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"]; +import "google/cloud/compute/v1/internal/common_038.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"]; - - // 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"]; - - // [Output Only] The unique identifier for the resource. This identifier is +// Represents a License Code resource. +// +// A License Code is a unique identifier used to represent alicense +// resource. +// *Caution* This resource is intended for +// use only by third-party partners who are creatingCloud Marketplace +// images. +message LicenseCode { + // Specifies licenseCodes of licenses that can replace this license. Note: + // such replacements are allowed even if removable_from_disk is false. + repeated string allowed_replacement_licenses = 10 + [json_name = "allowedReplacementLicenses"]; + + // If true, this license can be appended to an existing disk's set of + // licenses. + optional bool appendable_to_disk = 11 [json_name = "appendableToDisk"]; + + // Output only. [Output Only] Creation timestamp inRFC3339 + // text format. + optional string creation_timestamp = 1 [json_name = "creationTimestamp"]; + + // Output only. [Output Only] Description of this License Code. + optional string description = 2 [json_name = "description"]; + + // Output only. [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"]; - - // 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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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 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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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 id = 3 [json_name = "id"]; + + // Specifies licenseCodes of licenses that are incompatible with this license. + // If a license is incompatible with this license, it cannot be attached to + // the same disk or image. + repeated string incompatible_licenses = 12 + [json_name = "incompatibleLicenses"]; + + // Output only. [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"]; + + // If set, this license will be unable to be removed or replaced once attached + // to a disk until the minimum_retention period has passed. + optional Duration minimum_retention = 13 [json_name = "minimumRetention"]; + + // If true, this license can only be used on VMs on multi tenant nodes. + optional bool multi_tenant_only = 14 [json_name = "multiTenantOnly"]; + + // Output only. [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"]; + + // If true, indicates this is an OS license. Only one OS license can be + // attached to a disk or image at a time. + optional bool os_license = 15 [json_name = "osLicense"]; + + // If true, this license can be removed from a disk's set of licenses, with no + // replacement license needed. + optional bool removable_from_disk = 16 [json_name = "removableFromDisk"]; + + // Specifies the set of permissible coattached licenseCodes of licenses that + // satisfy the coattachment requirement of this license. At least one license + // from the set must be attached to the same disk or image as this license. + repeated string required_coattached_licenses = 17 + [json_name = "requiredCoattachedLicenses"]; + + // Output only. [Output Only] Server-defined URL for the resource. + optional string self_link = 7 [json_name = "selfLink"]; + + // If true, this license can only be used on VMs on sole tenant nodes. + optional bool sole_tenant_only = 18 [json_name = "soleTenantOnly"]; + + // Output only. [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. [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"]; + + // Output only. [Output Only] Last update timestamp inRFC3339 + // text format. + optional string update_timestamp = 19 [json_name = "updateTimestamp"]; } -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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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 LicenseCodeLicenseAlias { + // Output only. [Output Only] Description of this License Code. + optional string description = 1 [json_name = "description"]; - // Informational warning which replaces the list of packetMirrorings when the - // list is empty. - optional Warning warning = 2 [json_name = "warning"]; + // Output only. [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_094.proto b/protos/google/cloud/compute/v1/internal/common_094.proto index 2544ac5251b48..d261905b9cb91 100644 --- a/protos/google/cloud/compute/v1/internal/common_094.proto +++ b/protos/google/cloud/compute/v1/internal/common_094.proto @@ -15,260 +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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_117.proto"; +message LocalDisk { + // Specifies the number of such disks. + optional int32 disk_count = 1 [json_name = "diskCount"]; -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"]; - - // A list of SecurityPoliciesScopedList resources. - map items = 3 [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] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value 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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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"]; -} + // Specifies the size of the disk in base-2 GB. + optional int32 disk_size_gb = 2 [json_name = "diskSizeGb"]; -message SecurityPoliciesListPreconfiguredExpressionSetsResponse { - optional SecurityPoliciesWafConfig preconfigured_expression_sets = 1 - [json_name = "preconfiguredExpressionSets"]; + // 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 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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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"]; +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_095.proto b/protos/google/cloud/compute/v1/internal/common_095.proto index 0b355cd96a6e4..489d02913d18d 100644 --- a/protos/google/cloud/compute/v1/internal/common_095.proto +++ b/protos/google/cloud/compute/v1/internal/common_095.proto @@ -15,187 +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: 20250601 +// revision: 20260807 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. +import "google/cloud/compute/v1/internal/common_001.proto"; +import "google/cloud/compute/v1/internal/common_004.proto"; +import "google/cloud/compute/v1/internal/common_028.proto"; +import "google/cloud/compute/v1/internal/common_096.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, +// seeMachine images. +message MachineImage { + // Output only. [Output Only] The creation timestamp for this machine image + // inRFC3339 + // 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. + // [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. [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. [Output Only] The resource type, which is + // alwayscompute#machineImage for machine image. + optional string kind = 6 [json_name = "kind"]; + + // A fingerprint for the labels being applied to this machine image, 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 + // machine image. + optional string label_fingerprint = 19 [json_name = "labelFingerprint"]; + + // Labels to apply to this machine image. These can be later modified by + // the setLabels method. + map labels = 20 [json_name = "labels"]; + + // Encrypts the machine image using acustomer-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 withRFC1035. // 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. + // 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"]; + // Input only. [Input Only] Additional parameters that are passed in the + // request, but are + // not persisted in the resource. + optional MachineImageParams params = 21 [json_name = "params"]; + + // Output only. Reserved for future use. + optional bool satisfies_pzi = 18 [json_name = "satisfiesPzi"]; + + // Output only. [Output Only] Reserved for future use. + optional bool satisfies_pzs = 9 [json_name = "satisfiesPzs"]; + + // Output only. An array of Machine Image specific properties for disks + // attached to the + // source instance + repeated SavedDisk saved_disks = 10 [json_name = "savedDisks"]; + + // Output only. [Output Only] The URL for this machine image. The server + // defines this URL. + optional string self_link = 11 [json_name = "selfLink"]; + + // [Input Only] Thecustomer-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. [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. [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 + // themachine image is + // stored. + repeated string storage_locations = 16 [json_name = "storageLocations"]; + + // Output only. [Output Only] Total size of the storage used by the machine + // image. + optional string total_storage_bytes = 17 [json_name = "totalStorageBytes"]; } -message PublicAdvertisedPrefixList { +// 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 PublicAdvertisedPrefix resources. - repeated PublicAdvertisedPrefix items = 2 [json_name = "items"]; + // A list of MachineImage resources. + repeated MachineImage items = 2 [json_name = "items"]; - // [Output Only] Type of the resource. Always compute#publicAdvertisedPrefix - // for public advertised prefixes. + // Output only. [Output Only] The resource type, which is + // alwayscompute#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 + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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. + // Output only. [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. + // [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. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -204,19 +259,27 @@ message PublicAdvertisedPrefixList { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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. @@ -227,24 +290,235 @@ message PublicAdvertisedPrefixList { optional Warning warning = 6 [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"]; +// Machine Image parameters +message MachineImageParams { + // Input only. Resource manager tags to be bound to the machine image. Tag + // keys and values + // have the same definition as resource + // manager tags. Keys and values can be either in numeric format, + // such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in + // namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and + // `{tag_value_short_name}`. The field is ignored (both PUT & + // PATCH) when empty. + map resource_manager_tags = 1 + [json_name = "resourceManagerTags"]; +} - // The name of the public delegated prefix - optional string name = 2 [json_name = "name"]; +// 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. [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"]; + + // Output only. 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. [Output Only] Type of the resource. Alwayscompute#attachedDisk + // for attached disks. + optional string kind = 10 [json_name = "kind"]; + + // Output only. [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, + // eitherREAD_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. [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. [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 orPERSISTENT. + // PERSISTENT: + // SCRATCH: + optional string type = 16 [json_name = "type"]; +} - // The project number of the public delegated prefix - optional string project = 3 [json_name = "project"]; +// An instance-attached disk resource. +message SavedDisk { + // Output only. [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. [Output Only] Type of the resource. Always compute#savedDisk + // for attached disks. + optional string kind = 2 [json_name = "kind"]; + + // Output only. Specifies a URL of the disk attached to the source instance. + optional string source_disk = 3 [json_name = "sourceDisk"]; + + // Output only. [Output Only] Size of the individual disk snapshot used by + // this machine + // image. + optional string storage_bytes = 4 [json_name = "storageBytes"]; + + // Output only. [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"]; +} - // The region of the public delegated prefix if it is regional. If absent, the - // prefix is global. - optional string region = 4 [json_name = "region"]; +message SourceDiskEncryptionKey { + // Thecustomer-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"]; +} - // 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"]; +// 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 tofalse. See theEnable 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. SeeProject 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" orminCpuPlatform: "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"]; + + // PostKeyRevocationActionType of the instance. + // NOOP: Indicates user chose no operation. + // POST_KEY_REVOCATION_ACTION_TYPE_UNSPECIFIED: Default value. This value is + // unused. + // SHUTDOWN: Indicates user chose to opt for VM shutdown on key revocation. + optional string post_key_revocation_action_type = 15 + [json_name = "postKeyRevocationActionType"]; + + // 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 withRFC1035. + optional Tags tags = 14 [json_name = "tags"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_096.proto b/protos/google/cloud/compute/v1/internal/common_096.proto index f5a47426b2129..8e1abc2ae439b 100644 --- a/protos/google/cloud/compute/v1/internal/common_096.proto +++ b/protos/google/cloud/compute/v1/internal/common_096.proto @@ -15,268 +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: 20250601 +// revision: 20260807 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. - // EXTERNAL_IPV6_SUBNETWORK_CREATION: The public delegated prefix is used for - // creating dual-mode subnetworks 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 announced and ready to use. - - // `DELETING` The public delegated prefix is being deprovsioned. - // ANNOUNCED: The public delegated prefix is announced and ready to use. - // 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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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 error412 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"]; -} - -// 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"]; + // 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"]; - // 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. - // EXTERNAL_IPV6_SUBNETWORK_CREATION: The public delegated prefix is used for - // creating dual-mode subnetworks 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"]; + // Output only. [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_097.proto b/protos/google/cloud/compute/v1/internal/common_097.proto index 24f9493afa147..51872927b1120 100644 --- a/protos/google/cloud/compute/v1/internal/common_097.proto +++ b/protos/google/cloud/compute/v1/internal/common_097.proto @@ -15,216 +15,68 @@ // 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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_096.proto"; - -message PublicDelegatedPrefixAggregatedList { - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 1 [json_name = "id"]; - - // A list of PublicDelegatedPrefixesScopedList resources. - map items = 2 - [json_name = "items"]; - - // [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 - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value 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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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 itsfilterMatchCriteria is set to +// MATCH_ANY, at least +// one of thefilterLabels 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 inmetadataFilters +// 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 themetadataFilter + // to be considered a match. + // MATCH_ANY: Specifies that any filterLabel must match for themetadataFilter + // to be considered a match. + // NOT_SET: Indicates that the match criteria was not set. AmetadataFilter + // must never be created with this value. + optional string filter_match_criteria = 2 [json_name = "filterMatchCriteria"]; } -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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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 public - // delegated prefixes when the list is empty. - optional Warning warning = 2 [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"]; + + // 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_098.proto b/protos/google/cloud/compute/v1/internal/common_098.proto index 6c9e723c17537..c7c0ece878729 100644 --- a/protos/google/cloud/compute/v1/internal/common_098.proto +++ b/protos/google/cloud/compute/v1/internal/common_098.proto @@ -15,188 +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: 20250601 +// revision: 20260807 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"]; +// 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 withRFC1035. + optional string name = 1 [json_name = "name"]; - // [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"]; + // 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_099.proto b/protos/google/cloud/compute/v1/internal/common_099.proto index 95ca799dd9f38..470b55353fe9b 100644 --- a/protos/google/cloud/compute/v1/internal/common_099.proto +++ b/protos/google/cloud/compute/v1/internal/common_099.proto @@ -15,93 +15,186 @@ // 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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_023.proto"; -import "google/cloud/compute/v1/internal/common_098.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"]; +// NetworkAttachments +// A network attachment resource ... +message NetworkAttachment { + // Output only. [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. [Output Only] Creation timestamp inRFC3339 + // 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. [Output Only] The unique identifier for the resource type. The + // server + // generates this identifier. + optional string id = 6 [json_name = "id"]; + + // Output only. [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 withRFC1035. + // 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. [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 or service class ids that are allowed to connect to this network + // attachment. The project can be specified using its id or number. Service + // class id can be specified as "serviceclasses/{service_class_id}". + repeated string producer_accept_lists = 10 + [json_name = "producerAcceptLists"]; + + // Projects or service class ids that are not allowed to connect to this + // network attachment. The project can be specified using its id or number. + // Service class id can be specified as "serviceclasses/{service_class_id}". + repeated string producer_reject_lists = 11 + [json_name = "producerRejectLists"]; + + // Output only. [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. [Output Only] Server-defined URL for the resource. + optional string self_link = 13 [json_name = "selfLink"]; + + // Output only. [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"]; +} - // [Output Only] The deprecation status associated with this region. - optional DeprecationStatus deprecated = 2 [json_name = "deprecated"]; +// 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"]; - // [Output Only] Textual description of the resource. - optional string description = 3 [json_name = "description"]; + // A list of NetworkAttachmentsScopedList resources. + map items = 2 [json_name = "items"]; - // [Output Only] The unique identifier for the resource. This identifier is - // defined by the server. - optional string id = 4 [json_name = "id"]; + optional string kind = 3 [json_name = "kind"]; - // [Output Only] Type of the resource. Always compute#region for regions. - optional string kind = 5 [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 thanmaxResults, use the + // nextPageToken as a value 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] Name of the resource. - optional string name = 6 [json_name = "name"]; + // [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; - 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. + 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. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -110,65 +203,95 @@ message 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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] Informational warning message. + optional Warning warning = 6 [json_name = "warning"]; +} - // [Output Only] A list of zones available in this region, in the form of - // resource URLs. - repeated string zones = 11 [json_name = "zones"]; +// [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 service class id of the producer service to which the IP was + // assigned. + optional string service_class_id = 8 [json_name = "serviceClassId"]; + + // 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. [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"]; } -// Contains a list of region resources. -message RegionList { +message NetworkAttachmentList { // [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 NetworkAttachment resources. + repeated NetworkAttachment 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 + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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"]; @@ -176,61 +299,73 @@ message RegionList { 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. + // [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. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -239,19 +374,27 @@ message RegionList { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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. @@ -261,3 +404,116 @@ message RegionList { // [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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 + // network attachments when the list is empty. + optional Warning warning = 2 [json_name = "warning"]; +} diff --git a/protos/google/cloud/compute/v1/internal/common_100.proto b/protos/google/cloud/compute/v1/internal/common_100.proto index 4c51f86b8e51e..e60a40377d26d 100644 --- a/protos/google/cloud/compute/v1/internal/common_100.proto +++ b/protos/google/cloud/compute/v1/internal/common_100.proto @@ -15,91 +15,166 @@ // 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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_008.proto"; +// Represents a Google Cloud Armor network edge security service resource. +message NetworkEdgeSecurityService { + // Output only. [Output Only] Creation timestamp inRFC3339 + // 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 NetworkEdgeSecurityService. An up-to-date fingerprint must be + // provided in order to update the NetworkEdgeSecurityService, + // otherwise the request will fail with error412 conditionNotMet. + // + // To see the latest fingerprint, make a get() request to + // retrieve a NetworkEdgeSecurityService. + optional string fingerprint = 3 [json_name = "fingerprint"]; + + // Output only. [Output Only] The unique identifier for the resource. This + // identifier is + // defined by the server. + optional string id = 4 [json_name = "id"]; + + // Output only. [Output only] Type of the resource. + // Alwayscompute#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 withRFC1035. + // 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. [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. [Output Only] Server-defined URL for the resource. + optional string self_link = 9 [json_name = "selfLink"]; + + // Output only. [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"]; -// 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"]; + optional string id = 2 [json_name = "id"]; - // A list of Autoscaler resources. - repeated Autoscaler items = 2 [json_name = "items"]; + // A list of NetworkEdgeSecurityServicesScopedList resources. + map items = 3 + [json_name = "items"]; - // Type of resource. - optional string kind = 3 [json_name = "kind"]; + // Output only. [Output Only] Type of resource. + // Alwayscompute#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 + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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. [Output Only] Server-defined URL for this resource. + optional string self_link = 6 [json_name = "selfLink"]; - // [Output Only] Server-defined URL for this resource. - optional string self_link = 5 [json_name = "selfLink"]; + // Output only. [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. + // [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. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -108,19 +183,27 @@ message RegionAutoscalerList { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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. @@ -128,5 +211,118 @@ message RegionAutoscalerList { } // [Output Only] Informational warning message. - optional Warning warning = 6 [json_name = "warning"]; + 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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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_101.proto b/protos/google/cloud/compute/v1/internal/common_101.proto index d95f8b1e02969..b7ddefbb0e7cd 100644 --- a/protos/google/cloud/compute/v1/internal/common_101.proto +++ b/protos/google/cloud/compute/v1/internal/common_101.proto @@ -15,91 +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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_026.proto"; +import "google/cloud/compute/v1/internal/common_015.proto"; -message RegionDiskTypeList { +message NetworkEndpointGroupAggregatedList { // [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 NetworkEndpointGroupsScopedList resources. + map items = 2 [json_name = "items"]; - // [Output Only] Type of resource. Always compute#regionDiskTypeList for - // region disk types. + // Output only. [Output Only] The resource type, which is + // alwayscompute#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 - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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. + // Output only. [Output Only] Server-defined URL for this resource. optional string self_link = 5 [json_name = "selfLink"]; + // Output only. [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. + // [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. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -108,19 +125,27 @@ message RegionDiskTypeList { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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. @@ -128,5 +153,144 @@ message RegionDiskTypeList { } // [Output Only] Informational warning message. - optional Warning warning = 6 [json_name = "warning"]; + 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"]; +} + +message NetworkEndpointGroupsDetachEndpointsRequest { + // The list of network endpoints to be detached. + repeated NetworkEndpoint network_endpoints = 1 + [json_name = "networkEndpoints"]; +} + +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 NetworkEndpointGroupsScopedList { + // Output only. [Output Only] The list ofnetwork + // 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 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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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. [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_102.proto b/protos/google/cloud/compute/v1/internal/common_102.proto index b1786df985dc5..149a0c82e49bd 100644 --- a/protos/google/cloud/compute/v1/internal/common_102.proto +++ b/protos/google/cloud/compute/v1/internal/common_102.proto @@ -15,36 +15,417 @@ // 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: 20250601 +// revision: 20260807 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"]; +// NetworkProfile represents a Google managed network profile resource. +message NetworkProfile { + reserved 10; + // Output only. [Output Only] Creation timestamp inRFC3339 + // text format. + optional string creation_timestamp = 1 [json_name = "creationTimestamp"]; + + // Output only. [Output Only] An optional description of this resource. + optional string description = 2 [json_name = "description"]; + + // Output only. [Output Only] Features supported by the network. + optional NetworkProfileNetworkFeatures features = 3 [json_name = "features"]; + + // Output only. [Output Only] The unique identifier for the resource. This + // identifier is + // defined by the server. + optional string id = 4 [json_name = "id"]; + + // Output only. [Output Only] Type of the resource. + // Alwayscompute#networkProfile for network profiles. + optional string kind = 5 [json_name = "kind"]; + + // Output only. [Output Only] Location to which the network is restricted. + optional NetworkProfileLocation location = 6 [json_name = "location"]; + + // Output only. [Output Only] Name of the resource. + optional string name = 7 [json_name = "name"]; + + // Output only. [Output Only] Type of the network profile. + optional NetworkProfileProfileType profile_type = 11 + [json_name = "profileType"]; + + // Output only. [Output Only] Server-defined URL for the resource. + optional string self_link = 8 [json_name = "selfLink"]; + + // Output only. [Output Only] Server-defined URL for this resource with the + // resource id. + optional string self_link_with_id = 9 [json_name = "selfLinkWithId"]; } -message RegionDisksRemoveResourcePoliciesRequest { - // Resource policies to be removed from this disk. - repeated string resource_policies = 1 [json_name = "resourcePolicies"]; +message NetworkProfileLocation { + optional string name = 1 [json_name = "name"]; + + // REGION: + // ZONE: + optional string scope = 2 [json_name = "scope"]; } -message RegionDisksResizeRequest { - // The new size of the regional persistent disk, which is specified in GB. - optional string size_gb = 1 [json_name = "sizeGb"]; +message NetworkProfileNetworkFeatures { + // Specifies what address purposes are supported. If empty, all address + // purposes are supported. + repeated string address_purposes = 1 [json_name = "addressPurposes"]; + + // Specifies whether address creation is allowed. + // ADDRESS_CREATION_ALLOWED: + // ADDRESS_CREATION_BLOCKED: + optional string allow_address_creation = 29 + [json_name = "allowAddressCreation"]; + + // Specifies whether alias IP ranges (and secondary address ranges) are + // allowed. + // ALIAS_IP_RANGES_ALLOWED: + // ALIAS_IP_RANGES_BLOCKED: + optional string allow_alias_ip_ranges = 2 [json_name = "allowAliasIpRanges"]; + + // Specifies whether auto mode subnet creation is allowed. + // AUTO_MODE_SUBNET_ALLOWED: + // AUTO_MODE_SUBNET_BLOCKED: + optional string allow_auto_mode_subnet = 3 + [json_name = "allowAutoModeSubnet"]; + + // Specifies whether firewalls for Class D address ranges are supported. + // CLASS_D_FIREWALLS_ALLOWED: + // CLASS_D_FIREWALLS_BLOCKED: + optional string allow_class_d_firewalls = 4 + [json_name = "allowClassDFirewalls"]; + + // Specifies whether cloud NAT creation is allowed. + // CLOUD_NAT_ALLOWED: + // CLOUD_NAT_BLOCKED: + optional string allow_cloud_nat = 5 [json_name = "allowCloudNat"]; + + // Specifies whether cloud router creation is allowed. + // CLOUD_ROUTER_ALLOWED: + // CLOUD_ROUTER_BLOCKED: + optional string allow_cloud_router = 6 [json_name = "allowCloudRouter"]; + + // Specifies whether default NIC attachment is allowed. + // DEFAULT_NIC_ATTACHMENT_ALLOWED: + // DEFAULT_NIC_ATTACHMENT_BLOCKED: + optional string allow_default_nic_attachment = 23 + [json_name = "allowDefaultNicAttachment"]; + + // Specifies whether VMs are allowed to have external IP access on network + // interfaces connected to this VPC. + // EXTERNAL_IP_ACCESS_ALLOWED: + // EXTERNAL_IP_ACCESS_BLOCKED: + optional string allow_external_ip_access = 7 + [json_name = "allowExternalIpAccess"]; + + // Specifies whether firewall policy can be attached to the network. + // FIREWALL_POLICY_ALLOWED: + // FIREWALL_POLICY_BLOCKED: + optional string allow_firewall_policy = 30 + [json_name = "allowFirewallPolicy"]; + + // Specifies whether Cloud Interconnect creation is allowed. + // INTERCONNECT_ALLOWED: + // INTERCONNECT_BLOCKED: + optional string allow_interconnect = 8 [json_name = "allowInterconnect"]; + + // Specifies whether IP forwarding is allowed. + // IP_FORWARDING_ALLOWED: + // IP_FORWARDING_BLOCKED: + optional string allow_ip_forwarding = 24 [json_name = "allowIpForwarding"]; + + // Specifies whether cloud load balancing is allowed. + // LOAD_BALANCING_ALLOWED: + // LOAD_BALANCING_BLOCKED: + optional string allow_load_balancing = 9 [json_name = "allowLoadBalancing"]; + + // Specifies whether multi-nic in the same network is allowed. + // MULTI_NIC_IN_SAME_NETWORK_ALLOWED: + // MULTI_NIC_IN_SAME_NETWORK_BLOCKED: + optional string allow_multi_nic_in_same_network = 10 + [json_name = "allowMultiNicInSameNetwork"]; + + // Specifies whether multi-nic in the same subnetwork is allowed. + // MULTI_NIC_IN_SAME_SUBNETWORK_ALLOWED: + // MULTI_NIC_IN_SAME_SUBNETWORK_BLOCKED: + optional string allow_multi_nic_in_same_subnetwork = 31 + [json_name = "allowMultiNicInSameSubnetwork"]; + + // Specifies whether multicast is allowed. + // MULTICAST_ALLOWED: + // MULTICAST_BLOCKED: + optional string allow_multicast = 32 [json_name = "allowMulticast"]; + + // Specifies whether NCC is allowed. + // NCC_ALLOWED: + // NCC_BLOCKED: + optional string allow_ncc = 25 [json_name = "allowNcc"]; + + // Specifies whether VM network migration is allowed. + // NETWORK_MIGRATION_ALLOWED: + // NETWORK_MIGRATION_BLOCKED: + optional string allow_network_migration = 26 + [json_name = "allowNetworkMigration"]; + + // Specifies whether Packet Mirroring 1.0 is supported. + // PACKET_MIRRORING_ALLOWED: + // PACKET_MIRRORING_BLOCKED: + optional string allow_packet_mirroring = 11 + [json_name = "allowPacketMirroring"]; + + // Specifies whether private Google access is allowed. + // PRIVATE_GOOGLE_ACCESS_ALLOWED: + // PRIVATE_GOOGLE_ACCESS_BLOCKED: + optional string allow_private_google_access = 12 + [json_name = "allowPrivateGoogleAccess"]; + + // Specifies whether PSC creation is allowed. + // PSC_ALLOWED: + // PSC_BLOCKED: + optional string allow_psc = 13 [json_name = "allowPsc"]; + + // Specifies whether unicast within the same network is allowed. + // SAME_NETWORK_UNICAST_ALLOWED: + // SAME_NETWORK_UNICAST_BLOCKED: + optional string allow_same_network_unicast = 14 + [json_name = "allowSameNetworkUnicast"]; + + // Specifies whether static route creation is allowed. + // STATIC_ROUTES_ALLOWED: + // STATIC_ROUTES_BLOCKED: + optional string allow_static_routes = 15 [json_name = "allowStaticRoutes"]; + + // Specifies whether sub interfaces are allowed. + // SUBINTERFACES_ALLOWED: + // SUBINTERFACES_BLOCKED: + optional string allow_sub_interfaces = 16 [json_name = "allowSubInterfaces"]; + + // Specifies whether subnetwork creation is allowed. + // SUBNETWORK_CREATION_ALLOWED: + // SUBNETWORK_CREATION_BLOCKED: + optional string allow_subnetwork_creation = 33 + [json_name = "allowSubnetworkCreation"]; + + // Specifies whether VPC firewall rules can be created under the network. + // VPC_FIREWALL_RULES_ALLOWED: + // VPC_FIREWALL_RULES_BLOCKED: + optional string allow_vpc_firewall_rules = 34 + [json_name = "allowVpcFirewallRules"]; + + // Specifies whether VPC peering is allowed. + // VPC_PEERING_ALLOWED: + // VPC_PEERING_BLOCKED: + optional string allow_vpc_peering = 17 [json_name = "allowVpcPeering"]; + + // Specifies whether VPN creation is allowed. + // VPN_ALLOWED: + // VPN_BLOCKED: + optional string allow_vpn = 18 [json_name = "allowVpn"]; + + repeated string firewall_policy_types = 35 + [json_name = "firewallPolicyTypes"]; + + // If set, limits the interface types that the network supports. If + // empty, all interface types are supported. + repeated string interface_types = 19 [json_name = "interfaceTypes"]; + + // Specifies which type of multicast is supported. + // MULTICAST_SDN: + // MULTICAST_ULL: + optional string multicast = 36 [json_name = "multicast"]; + + // Specifies a predefined internal IPv6 range for the network. + optional string predefined_network_internal_ipv6_range = 37 + [json_name = "predefinedNetworkInternalIpv6Range"]; + + // Predefined subnetwork ranges for the network. + repeated NetworkProfileNetworkFeaturesPredefinedSubnetworkRange + predefined_subnetwork_ranges = 38 + [json_name = "predefinedSubnetworkRanges"]; + + // Specifies which subnetwork purposes are supported. + repeated string subnet_purposes = 20 [json_name = "subnetPurposes"]; + + // Specifies which subnetwork stack types are supported. + repeated string subnet_stack_types = 21 [json_name = "subnetStackTypes"]; + + // Output only. Specifies which subnetwork purposes are supported. + repeated string subnetwork_purposes = 27 [json_name = "subnetworkPurposes"]; + + // Output only. Specifies which subnetwork stack types are supported. + repeated string subnetwork_stack_types = 28 + [json_name = "subnetworkStackTypes"]; + + // Specifies which type of unicast is supported. + // UNICAST_SDN: + // UNICAST_ULL: + optional string unicast = 22 [json_name = "unicast"]; } -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 NetworkProfileNetworkFeaturesPredefinedSubnetworkRange { + // The IPv6 range of the predefined subnetwork. + optional string ipv6_range = 1 [json_name = "ipv6Range"]; + + // The naming prefix of the predefined subnetwork. + optional string name_prefix = 2 [json_name = "namePrefix"]; +} + +message NetworkProfileProfileType { + // RDMA: RDMA network. + // ULL: ULL network. + // VPC: VPC network. + optional string network_type = 1 [json_name = "networkType"]; + + // FALCON: RDMA over Falcon. + // ROCE: RDMA over Converged Ethernet (RoCE). + // ROCE_METAL: RDMA over Converged Ethernet (RoCE) for Bare Metal. + optional string rdma_subtype = 2 [json_name = "rdmaSubtype"]; + + // OPERATOR: Exchange operator. + // PARTICIPANT: Exchange participant. + optional string ull_subtype = 3 [json_name = "ullSubtype"]; + + // REGIONAL: Regionally bound VPC network. + optional string vpc_subtype = 4 [json_name = "vpcSubtype"]; +} + +// Contains a list of network profiles. +message NetworkProfilesListResponse { + 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 NetworkProfile resources. + repeated NetworkProfile items = 3 [json_name = "items"]; + + // Output only. [Output Only] Type of resource. + // Alwayscompute#networkProfileList for network profiles. + 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 thanmaxResults, use the + // nextPageToken as a value + // 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. [Output Only] Server-defined URL for this resource. + optional string self_link = 6 [json_name = "selfLink"]; + + // Output only. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_103.proto b/protos/google/cloud/compute/v1/internal/common_103.proto index 18e906029a7e6..311618f3fea65 100644 --- a/protos/google/cloud/compute/v1/internal/common_103.proto +++ b/protos/google/cloud/compute/v1/internal/common_103.proto @@ -15,92 +15,198 @@ // 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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_059.proto"; -import "google/cloud/compute/v1/internal/common_083.proto"; +import "google/cloud/compute/v1/internal/common_001.proto"; +import "google/cloud/compute/v1/internal/common_094.proto"; -// Contains a list of InstanceGroup resources. -message RegionInstanceGroupList { +// Represent a sole-tenant Node Template resource. +// +// You can use a template to define properties for nodes in a node group. For +// more information, readCreating 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. [Output Only] Creation timestamp inRFC3339 + // 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"]; + + repeated LocalDisk disks = 5 [json_name = "disks"]; + + // Output only. [Output Only] The unique identifier for the resource. This + // identifier is + // defined by the server. + optional string id = 6 [json_name = "id"]; + + // Output only. [Output Only] The type of the resource. + // Alwayscompute#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 + // withRFC1035. + // 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. [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. [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. [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. [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 = 1 [json_name = "id"]; - // A list of InstanceGroup resources. - repeated InstanceGroup items = 2 [json_name = "items"]; + // A list of NodeTemplatesScopedList resources. + map items = 2 [json_name = "items"]; - // The resource type. + // Output only. [Output Only] Type of + // resource.Alwayscompute#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 + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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. + // Output only. [Output Only] Server-defined URL for this resource. optional string self_link = 5 [json_name = "selfLink"]; + // Output only. [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. + // [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. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -109,19 +215,27 @@ message RegionInstanceGroupList { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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. @@ -129,85 +243,100 @@ message RegionInstanceGroupList { } // [Output Only] Informational warning message. - optional Warning warning = 6 [json_name = "warning"]; + optional Warning warning = 7 [json_name = "warning"]; } -message RegionInstanceGroupsListInstances { +// 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 InstanceWithNamedPorts resources. - repeated InstanceWithNamedPorts items = 2 [json_name = "items"]; + // A list of NodeTemplate resources. + repeated NodeTemplate items = 2 [json_name = "items"]; - // The resource type. + // Output only. [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 + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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. + // Output only. [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. + // [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. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -216,19 +345,27 @@ message RegionInstanceGroupsListInstances { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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. @@ -239,28 +376,122 @@ message RegionInstanceGroupsListInstances { 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 NodeTemplateNodeTypeFlexibility { + optional string cpus = 1 [json_name = "cpus"]; + + optional string local_ssd = 2 [json_name = "localSsd"]; + + optional string memory = 3 [json_name = "memory"]; } -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 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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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_104.proto b/protos/google/cloud/compute/v1/internal/common_104.proto index d42397b9cb818..22e2074788731 100644 --- a/protos/google/cloud/compute/v1/internal/common_104.proto +++ b/protos/google/cloud/compute/v1/internal/common_104.proto @@ -15,100 +15,164 @@ // 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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_028.proto"; +import "google/cloud/compute/v1/internal/common_032.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"]; +// 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 +// readNode 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 inRFC3339 + // 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. [Output Only] The type of the resource. Alwayscompute#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. [Output Only] Maximum number of VMs that can be created for + // this node type. + optional int32 max_vms = 13 [json_name = "maxVms"]; + + // [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. [Output Only] Server-defined URL for the resource. + optional string self_link = 11 [json_name = "selfLink"]; + + // Output only. [Output Only] The name of the zone where the node type + // resides, + // such as us-central1-a. + optional string zone = 12 [json_name = "zone"]; } -// Contains a list of managed instance groups. -message RegionInstanceGroupManagerList { +message NodeTypeAggregatedList { // [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"]; + // A list of NodeTypesScopedList resources. + map 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. + // Output only. [Output Only] Type of + // resource.Alwayscompute#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 - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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. + // Output only. [Output Only] Server-defined URL for this resource. optional string self_link = 5 [json_name = "selfLink"]; + // Output only. [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. + // [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. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -117,19 +181,27 @@ message RegionInstanceGroupManagerList { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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. @@ -137,174 +209,100 @@ message RegionInstanceGroupManagerList { } // [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"]; + optional Warning warning = 7 [json_name = "warning"]; } -// 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"]; -} +// 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 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"]; -} + // A list of NodeType resources. + repeated NodeType items = 2 [json_name = "items"]; -message RegionInstanceGroupManagersListErrorsResponse { - // [Output Only] The list of errors of the managed instance group. - repeated InstanceManagedByIgmError items = 1 [json_name = "items"]; + // Output only. [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 + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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"]; + optional string next_page_token = 4 [json_name = "nextPageToken"]; - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value 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"]; + // Output only. [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. + // [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. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -313,19 +311,27 @@ message RegionInstanceGroupManagersListInstanceConfigsResp { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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. @@ -333,74 +339,117 @@ message RegionInstanceGroupManagersListInstanceConfigsResp { } // [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 RegionInstanceGroupManagersResumeInstancesRequest { - // The URLs of one or more instances to resume. This can be a full URL or a - // partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. - repeated string instances = 1 [json_name = "instances"]; + optional Warning warning = 6 [json_name = "warning"]; } -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 NodeTypesScopedList { + // [Output Only] A list of node types contained in this scope. + repeated NodeType node_types = 1 [json_name = "nodeTypes"]; -message RegionInstanceGroupManagersSetTemplateRequest { - // URL of the InstanceTemplate resource from which all new instances will be - // created. - optional string instance_template = 1 [json_name = "instanceTemplate"]; -} + 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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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 RegionInstanceGroupManagersStartInstancesRequest { - // The URLs of one or more instances to start. 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 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 RegionInstanceGroupManagersStopInstancesRequest { - // If this flag is set to true, the Instance Group Manager will proceed to - // stop the instances, skipping initialization on them. - optional bool force_stop = 1 [json_name = "forceStop"]; + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } - // The URLs of one or more instances to stop. This can be a full URL or a - // partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. - repeated string instances = 2 [json_name = "instances"]; -} + // [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 RegionInstanceGroupManagersSuspendInstancesRequest { - // If this flag is set to true, the Instance Group Manager will proceed to - // suspend the instances, skipping initialization on them. - optional bool force_suspend = 1 [json_name = "forceSuspend"]; + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } - // The URLs of one or more instances to suspend. This can be a full URL or a - // partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. - repeated string instances = 2 [json_name = "instances"]; + // [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_105.proto b/protos/google/cloud/compute/v1/internal/common_105.proto index 178637a08b9f5..8cff7eeaebe8d 100644 --- a/protos/google/cloud/compute/v1/internal/common_105.proto +++ b/protos/google/cloud/compute/v1/internal/common_105.proto @@ -15,22 +15,463 @@ // 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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_012.proto"; +import "google/cloud/compute/v1/internal/common_038.proto"; -message RegionNetworkEndpointGroupsAttachEndpointsRequest { - // The list of network endpoints to be attached. - repeated NetworkEndpoint network_endpoints = 1 - [json_name = "networkEndpoints"]; +// 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. [Output Only] Creation timestamp inRFC3339 + // 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. [Output Only] A unique identifier for this resource type. The + // server + // generates this identifier. + optional string id = 4 [json_name = "id"]; + + // Output only. [Output Only] Type of the resource. + // Alwayscompute#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 withRFC1035. + // 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. [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. [Output Only] Server-defined URL for the resource. + optional string self_link = 8 [json_name = "selfLink"]; +} + +// Contains a list of NotificationEndpointsScopedList. +message NotificationEndpointAggregatedList { + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 1 [json_name = "id"]; + + // A list of NotificationEndpointsScopedList resources. + map items = 2 [json_name = "items"]; + + // Output only. 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 thanmaxResults, use the + // nextPageToken as a value 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. [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + // Output only. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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"]; } -message RegionNetworkEndpointGroupsDetachEndpointsRequest { - // The list of network endpoints to be detached. - repeated NetworkEndpoint network_endpoints = 1 - [json_name = "networkEndpoints"]; +message NotificationEndpointList { + // [Output Only] Unique identifier for the resource; 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. [Output Only] Type of the resource. + // Alwayscompute#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 + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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 NotificationEndpointsScopedList { + // A list of NotificationEndpoints contained in this scope. + repeated NotificationEndpoint resources = 1 [json_name = "resources"]; + + 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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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 + // notification endpoints 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 2c679ca2d7690..161a9c878dbda 100644 --- a/protos/google/cloud/compute/v1/internal/common_106.proto +++ b/protos/google/cloud/compute/v1/internal/common_106.proto @@ -15,54 +15,256 @@ // 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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_034.proto"; -import "google/cloud/compute/v1/internal/common_039.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; -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"]; +message OperationAggregatedList { + // [Output Only] The unique identifier for the resource. This identifier is + // defined by the server. + optional string id = 1 [json_name = "id"]; - // Effective firewalls on the network. - repeated Firewall firewalls = 2 [json_name = "firewalls"]; + // [Output Only] A map of scoped operation lists. + map items = 2 [json_name = "items"]; + + // Output only. [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. + 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. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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 -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"]; - - // [Output only] The packet mirroring rules that apply to the network. - repeated FirewallPolicyRule packet_mirroring_rules = 5 - [json_name = "packetMirroringRules"]; - - // [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 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 = 4 [json_name = "type"]; +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 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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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 operations + // when the list is empty. + optional Warning warning = 2 [json_name = "warning"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_107.proto b/protos/google/cloud/compute/v1/internal/common_107.proto index ae51f4c5c1f5d..0ce1a9f9f5003 100644 --- a/protos/google/cloud/compute/v1/internal/common_107.proto +++ b/protos/google/cloud/compute/v1/internal/common_107.proto @@ -15,20 +15,142 @@ // 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: 20250601 +// revision: 20260807 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"]; +import "google/cloud/compute/v1/internal/common_019.proto"; - // The labels to set for this resource. - map labels = 2 [json_name = "labels"]; +// 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"]; + + // [Output Only] A list of Operation resources. + repeated Operation items = 2 [json_name = "items"]; + + // Output only. [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. + 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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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_108.proto b/protos/google/cloud/compute/v1/internal/common_108.proto index 310287f636a29..fff4d65e8c454 100644 --- a/protos/google/cloud/compute/v1/internal/common_108.proto +++ b/protos/google/cloud/compute/v1/internal/common_108.proto @@ -15,25 +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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_007.proto"; +import "google/cloud/compute/v1/internal/common_141.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"]; +message OrganizationSecurityPoliciesListAssociationsResponse { + // A list of associations. + repeated SecurityPolicyAssociation associations = 1 + [json_name = "associations"]; - // 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"]; + // Output only. [Output Only] Type of securityPolicy associations. + // Alwayscompute#organizationSecurityPoliciesListAssociations for lists + // of securityPolicy associations. + optional string kind = 2 [json_name = "kind"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_109.proto b/protos/google/cloud/compute/v1/internal/common_109.proto index f4606dcb58ba5..002cf6ea11de2 100644 --- a/protos/google/cloud/compute/v1/internal/common_109.proto +++ b/protos/google/cloud/compute/v1/internal/common_109.proto @@ -15,14 +15,553 @@ // 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: 20250601 +// revision: 20260807 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"]; +// 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, seeUsing Packet +// Mirroring. +message PacketMirroring { + // The Forwarding Rule resource of typeloadBalancingScheme=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. [Output Only] Creation timestamp inRFC3339 + // 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"]; + + // Output only. [Output Only] The unique identifier for the resource. This + // identifier is + // defined by the server. + optional string id = 6 [json_name = "id"]; + + // Output only. [Output Only] Type of the resource. + // Alwayscompute#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 withRFC1035. + // 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. [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"]; + + // Output only. 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 thanmaxResults, use the + // nextPageToken as a value 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. [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + // Output only. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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 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. [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. [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 thanmaxResults, use the + // nextPageToken as a value 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. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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. [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. [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. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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 packetMirrorings when the + // list is empty. + optional Warning warning = 2 [json_name = "warning"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_110.proto b/protos/google/cloud/compute/v1/internal/common_110.proto index 62407abb54750..3872ef08cde1f 100644 --- a/protos/google/cloud/compute/v1/internal/common_110.proto +++ b/protos/google/cloud/compute/v1/internal/common_110.proto @@ -15,15 +15,122 @@ // 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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_020.proto"; +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"]; -message RegionUrlMapsValidateRequest { - // Content of the UrlMap to be validated. - optional UrlMap resource = 1 [json_name = "resource"]; + // 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 + // configuration 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 orREAD_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 inREAD_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"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_111.proto b/protos/google/cloud/compute/v1/internal/common_111.proto index 778b2994e6784..3a5ed6ea819e3 100644 --- a/protos/google/cloud/compute/v1/internal/common_111.proto +++ b/protos/google/cloud/compute/v1/internal/common_111.proto @@ -15,341 +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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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 PreconfiguredWafSet { + // List of entities that are currently supported for WAF rules. + repeated WafExpressionSet expression_sets = 1 [json_name = "expressionSets"]; } -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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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 SecurityPoliciesListPreconfiguredExpressionSetsResponse { + optional SecurityPoliciesWafConfig preconfigured_expression_sets = 1 + [json_name = "preconfiguredExpressionSets"]; } -message ReservationsPerformMaintenanceRequest { - // Specifies if all, running or unused hosts are in scope for this request. - // ALL: Trigger maintenance for all hosts belonging to this reservation - // irrespective of whether VMs are running on them or not. - // MAINTENANCE_SCOPE_UNSPECIFIED: Internal only - // RUNNING_VMS: Trigger maintenance only on the hosts belonging to this - // reservation which have VMs running on them. - // UNUSED_CAPACITY: Trigger maintenance only on the hosts belonging to this - // reservation which do not have any VMs running on them. This is not allowed - // for Standard ExR - optional string maintenance_scope = 1 [json_name = "maintenanceScope"]; +message SecurityPoliciesWafConfig { + optional PreconfiguredWafSet waf_rules = 1 [json_name = "wafRules"]; } -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 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 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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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 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"]; - // Informational warning which replaces the list of reservations when the list - // is empty. - optional Warning warning = 2 [json_name = "warning"]; + // 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_112.proto b/protos/google/cloud/compute/v1/internal/common_112.proto index 9d57835fcc71c..02d96a739df3a 100644 --- a/protos/google/cloud/compute/v1/internal/common_112.proto +++ b/protos/google/cloud/compute/v1/internal/common_112.proto @@ -15,166 +15,230 @@ // 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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_048.proto"; - -// Represents a reservation block resource. -message ReservationBlock { - // [Output Only] The number of resources that are allocated in this - // reservation block. - optional int32 count = 1 [json_name = "count"]; - - // [Output Only] Creation timestamp in RFC3339 text format. - optional string creation_timestamp = 2 [json_name = "creationTimestamp"]; - - // [Output Only] The unique identifier for the resource. This identifier is - // defined by the server. - optional string id = 3 [json_name = "id"]; - - // [Output Only] The number of instances that are currently in use on this - // reservation block. - optional int32 in_use_count = 4 [json_name = "inUseCount"]; - - // [Output Only] Type of the resource. Always compute#reservationBlock for - // reservation blocks. - optional string kind = 5 [json_name = "kind"]; - - // [Output Only] The name of this reservation block generated by Google - // Compute Engine. The name must be 1-63 characters long, and comply with - // RFC1035 @pattern [a-z](?:[-a-z0-9]{0,61}[a-z0-9])? - optional string name = 6 [json_name = "name"]; - - // [Output Only] The physical topology of the reservation block. - optional ReservationBlockPhysicalTopology physical_topology = 7 - [json_name = "physicalTopology"]; - - // [Output Only] Maintenance information for this reservation block. - optional GroupMaintenanceInfo reservation_maintenance = 8 - [json_name = "reservationMaintenance"]; - - // [Output Only] The number of reservation subBlocks associated with this - // reservation block. - optional int32 reservation_sub_block_count = 13 - [json_name = "reservationSubBlockCount"]; - - // [Output Only] The number of in-use reservation subBlocks associated with - // this reservation block. If at least one VM is running on a subBlock, it is - // considered in-use. - optional int32 reservation_sub_block_in_use_count = 14 - [json_name = "reservationSubBlockInUseCount"]; - - // [Output Only] Server-defined fully-qualified URL for this 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"]; - - // [Output Only] Status of the reservation block. - // CREATING: Resources are being allocated for the reservation block. - // DELETING: Reservation block is currently being deleted. - // INVALID: - // READY: Reservation block has allocated all its resources. - optional string status = 11 [json_name = "status"]; - - // [Output Only] Zone in which the reservation block resides. - optional string zone = 12 [json_name = "zone"]; -} - -message ReservationBlockPhysicalTopology { - // The hash of the capacity block within the cluster. - optional string block = 1 [json_name = "block"]; - - // The cluster name of the reservation block. - optional string cluster = 2 [json_name = "cluster"]; +// 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. [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. [Output Only] Creation timestamp inRFC3339 + // 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 thePublicAdvertisedPrefix, + // 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. [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"]; + + // The internet access type for IPv6 Public Advertised Prefixes. + // EXTERNAL: Default IPv6 access type. The prefix will be announced to the + // internet. + // All children Public Delegated Prefixes will have IPv6 access type as + // EXTERNAL. + // INTERNAL: The prefix will not be announced to the internet. Prefix will be + // used + // privately within Cloud. All children Public Delegated Prefixes + // will have IPv6 access type as INTERNAL. + optional string ipv6_access_type = 15 [json_name = "ipv6AccessType"]; + + // Output only. [Output Only] Type of the resource. + // Alwayscompute#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 withRFC1035. + // 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. [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. [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"]; } -message ReservationBlocksGetResponse { - optional ReservationBlock resource = 1 [json_name = "resource"]; -} - -// A list of reservation blocks under a single reservation. -message ReservationBlocksListResponse { - // Unique identifier for the resource; defined by the server. +message PublicAdvertisedPrefixList { + // [Output Only] Unique identifier for the resource; defined by the server. optional string id = 1 [json_name = "id"]; - // A list of reservation block resources. - repeated ReservationBlock items = 2 [json_name = "items"]; + // A list of PublicAdvertisedPrefix resources. + repeated PublicAdvertisedPrefix items = 2 [json_name = "items"]; - // Type of the resource. Always compute#reservationBlock for a list of - // reservation blocks. + // Output only. [Output Only] Type of the resource. + // Alwayscompute#publicAdvertisedPrefix for public advertised prefixes. optional string kind = 3 [json_name = "kind"]; - // This token allows you to get the next page of results for list requests. If - // the number of results is larger than maxResults, use the nextPageToken as a - // value for the query parameter pageToken in the next list request. - // Subsequent list requests will have their own nextPageToken to continue - // paging through the results. + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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"]; - // Server-defined URL for this resource. + // [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. + // [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. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -183,38 +247,55 @@ message ReservationBlocksListResponse { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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 message. + // [Output Only] Informational warning message. optional Warning warning = 6 [json_name = "warning"]; } -message ReservationsBlocksPerformMaintenanceRequest { - // Specifies if all, running or unused hosts are in scope for this request. - // ALL: Trigger maintenance for all hosts belonging to this reservation - // irrespective of whether VMs are running on them or not. - // MAINTENANCE_SCOPE_UNSPECIFIED: Internal only - // RUNNING_VMS: Trigger maintenance only on the hosts belonging to this - // reservation which have VMs running on them. - // UNUSED_CAPACITY: Trigger maintenance only on the hosts belonging to this - // reservation which do not have any VMs running on them. This is not allowed - // for Standard ExR - optional string maintenance_scope = 1 [json_name = "maintenanceScope"]; +// 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"]; + + // The name of the public delegated prefix + optional string name = 2 [json_name = "name"]; + + // The project number of the public delegated prefix + optional string project = 3 [json_name = "project"]; + + // The region of the public delegated prefix if it is regional. If absent, + // the prefix is global. + optional string region = 4 [json_name = "region"]; + + // 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_113.proto b/protos/google/cloud/compute/v1/internal/common_113.proto index d63ff863d32b4..f8040fc7bc92d 100644 --- a/protos/google/cloud/compute/v1/internal/common_113.proto +++ b/protos/google/cloud/compute/v1/internal/common_113.proto @@ -15,152 +15,252 @@ // 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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -// Represents a reservation subBlock resource. -message ReservationSubBlock { - // [Output Only] The number of hosts that are allocated in this reservation - // subBlock. - optional int32 count = 1 [json_name = "count"]; +// 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] Creation timestamp in RFC3339 text format. - optional string creation_timestamp = 2 [json_name = "creationTimestamp"]; + // Output only. [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] The unique identifier for the resource. This identifier is - // defined by the server. - optional string id = 3 [json_name = "id"]; + // Output only. [Output Only] Creation timestamp inRFC3339 + // text format. + optional string creation_timestamp = 1 [json_name = "creationTimestamp"]; - // [Output Only] The number of instances that are currently in use on this - // reservation subBlock. - optional int32 in_use_count = 4 [json_name = "inUseCount"]; + // An optional description of this resource. Provide this property when you + // create the resource. + optional string description = 2 [json_name = "description"]; - // [Output Only] Type of the resource. Always compute#reservationSubBlock for - // reservation subBlocks. - optional string kind = 5 [json_name = "kind"]; + // Output only. [Output Only] Whether this PDP supports enhanced IPv4 + // allocations. + // Applicable for IPv4 PDPs only. + optional bool enable_enhanced_ipv4_allocation = 17 + [json_name = "enableEnhancedIpv4Allocation"]; - // [Output Only] The name of this reservation subBlock generated by Google - // Compute Engine. The name must be 1-63 characters long, and comply with - // RFC1035 @pattern [a-z](?:[-a-z0-9]{0,61}[a-z0-9])? - optional string name = 6 [json_name = "name"]; + // 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 thePublicDelegatedPrefix, + // 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 physical topology of the reservation subBlock. - optional ReservationSubBlockPhysicalTopology physical_topology = 7 - [json_name = "physicalTopology"]; + // Output only. [Output Only] The unique identifier for the resource type. The + // server + // generates this identifier. + optional string id = 4 [json_name = "id"]; - // [Output Only] Server-defined fully-qualified URL for this resource. - optional string self_link = 8 [json_name = "selfLink"]; + // The IP address range, in CIDR format, represented by this public + // delegated prefix. + optional string ip_cidr_range = 5 [json_name = "ipCidrRange"]; - // [Output Only] Server-defined URL for this resource with the resource id. - optional string self_link_with_id = 9 [json_name = "selfLinkWithId"]; + // Output only. [Output Only] The internet access type for IPv6 Public + // Delegated Prefixes. + // Inherited from parent prefix. + // EXTERNAL: The parent public advertised prefix will be announced to the + // internet. + // All children public delegated prefixes will have IPv6 access type as + // EXTERNAL. + // INTERNAL: The parent public advertised prefix will not be announced to the + // internet. Prefix will be used privately within Cloud. All children + // public delegated prefixes will have IPv6 access type as INTERNAL. + optional string ipv6_access_type = 18 [json_name = "ipv6AccessType"]; - // [Output Only] Status of the reservation subBlock. - // CREATING: Resources are being allocated for the reservation subBlock. - // DELETING: Reservation subBlock is currently being deleted. - // INVALID: - // READY: Reservation subBlock has allocated all its resources. - optional string status = 10 [json_name = "status"]; + // If true, the prefix will be live migrated. + optional bool is_live_migration = 6 [json_name = "isLiveMigration"]; - // [Output Only] Zone in which the reservation subBlock resides. - optional string zone = 11 [json_name = "zone"]; -} + // Output only. [Output Only] Type of the resource. + // Alwayscompute#publicDelegatedPrefix for public delegated prefixes. + optional string kind = 7 [json_name = "kind"]; -message ReservationSubBlockPhysicalTopology { - // The hash of the capacity block within the cluster. - optional string block = 1 [json_name = "block"]; + // 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. Parent public + // delegated prefix must have IPv6 access type as EXTERNAL. + // EXTERNAL_IPV6_SUBNETWORK_CREATION: The public delegated prefix is used for + // creating dual-mode subnetworks + // only. Such prefixes cannot set publicDelegatedSubPrefixes. Parent public + // delegated prefix must have IPv6 access type as EXTERNAL. + // INTERNAL_IPV6_SUBNETWORK_CREATION: The public delegated prefix is used for + // creating dual stack or IPv6-only + // subnetwork with internal access only. Such prefixes cannot set + // publicDelegatedSubPrefixes and allocatablePrefixLength. Parent public + // delegated prefix must have IPv6 access type as INTERNAL. + optional string mode = 16 [json_name = "mode"]; - // The cluster name of the reservation subBlock. - optional string cluster = 2 [json_name = "cluster"]; + // Name of the resource. Provided by the client when the resource is created. + // The name must be 1-63 characters long, and comply withRFC1035. + // 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 hash of the capacity sub-block within the capacity block. - optional string sub_block = 3 [json_name = "subBlock"]; -} + // 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. [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. [Output Only] Server-defined URL for the resource. + optional string self_link = 12 [json_name = "selfLink"]; -message ReservationSubBlocksGetResponse { - optional ReservationSubBlock resource = 1 [json_name = "resource"]; + // [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 announced and ready to + // use. + // - `DELETING` The public delegated prefix is being deprovsioned. + // - `ACTIVE` The public delegated prefix is ready to use. + // ACTIVE: The public delegated prefix is ready to use. + // ANNOUNCED: The public delegated prefix is announced and ready to use. + // 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"]; } -// A list of reservation subBlocks under a single reservation. -message ReservationSubBlocksListResponse { - // Unique identifier for the resource; defined by the server. +message PublicDelegatedPrefixList { + // [Output Only] Unique identifier for the resource; defined by the server. optional string id = 1 [json_name = "id"]; - // A list of reservation subBlock resources. - repeated ReservationSubBlock items = 2 [json_name = "items"]; + // A list of PublicDelegatedPrefix resources. + repeated PublicDelegatedPrefix items = 2 [json_name = "items"]; - // Type of the resource. Always compute#reservationSubBlock for a list of - // reservation subBlocks. + // Output only. [Output Only] Type of the resource. + // Alwayscompute#publicDelegatedPrefixList for public delegated + // prefixes. optional string kind = 3 [json_name = "kind"]; - // This token allows you to get the next page of results for list requests. If - // the number of results is larger than maxResults, use the nextPageToken as a - // value for the query parameter pageToken in the next list request. - // Subsequent list requests will have their own nextPageToken to continue - // paging through the results. + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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"]; - // Server-defined URL for this resource. + // [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. + // [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. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -169,25 +269,105 @@ message ReservationSubBlocksListResponse { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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 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"]; + + // Output only. [Output Only] Whether this PDP supports enhanced IPv4 + // allocations. + // Applicable for IPv4 PDPs only. + optional bool enable_enhanced_ipv4_allocation = 10 + [json_name = "enableEnhancedIpv4Allocation"]; + + // The IP address range, in CIDR format, represented by this sub public + // delegated prefix. + optional string ip_cidr_range = 3 [json_name = "ipCidrRange"]; + + // Output only. [Output Only] The internet access type for IPv6 Public + // Delegated Sub + // Prefixes. Inherited from parent prefix. + // EXTERNAL: The parent public advertised prefix will be announced to the + // internet. + // All children public delegated prefixes will have IPv6 access type as + // EXTERNAL. + // INTERNAL: The parent public advertised prefix will not be announced to the + // internet. Prefix will be used privately within Cloud. All children + // public delegated prefixes will have IPv6 access type as INTERNAL. + optional string ipv6_access_type = 11 [json_name = "ipv6AccessType"]; + + // 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. Parent public + // delegated prefix must have IPv6 access type as EXTERNAL. + // EXTERNAL_IPV6_SUBNETWORK_CREATION: The public delegated prefix is used for + // creating dual-mode subnetworks + // only. Such prefixes cannot set publicDelegatedSubPrefixes. Parent public + // delegated prefix must have IPv6 access type as EXTERNAL. + // INTERNAL_IPV6_SUBNETWORK_CREATION: The public delegated prefix is used for + // creating dual stack or IPv6-only + // subnetwork with internal access only. Such prefixes cannot set + // publicDelegatedSubPrefixes and allocatablePrefixLength. Parent public + // delegated prefix must have IPv6 access type as INTERNAL. + optional string mode = 9 [json_name = "mode"]; + + // The name of the sub public delegated prefix. + optional string name = 5 [json_name = "name"]; + + // Output only. [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. [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_114.proto b/protos/google/cloud/compute/v1/internal/common_114.proto index 9807a97b1e985..8b7e4a86d3a4f 100644 --- a/protos/google/cloud/compute/v1/internal/common_114.proto +++ b/protos/google/cloud/compute/v1/internal/common_114.proto @@ -15,251 +15,109 @@ // 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: 20250601 +// revision: 20260807 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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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"]; - - optional ResourcePolicyWorkloadPolicy workload_policy = 14 - [json_name = "workloadPolicy"]; -} - -// Contains a list of resourcePolicies. -message ResourcePolicyAggregatedList { - optional string etag = 1 [json_name = "etag"]; +import "google/cloud/compute/v1/internal/common_113.proto"; +message PublicDelegatedPrefixAggregatedList { // [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 PublicDelegatedPrefixesScopedList resources. + map items = 2 + [json_name = "items"]; - // Type of resource. - optional string kind = 4 [json_name = "kind"]; + // Output only. [Output Only] Type of the resource. + // Alwayscompute#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 - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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"]; + // Output only. [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. + // [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. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -268,19 +126,27 @@ message ResourcePolicyAggregatedList { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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. @@ -288,175 +154,82 @@ 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"]; - - // Specifies the shape of the GPU slice, in slice based GPU families eg. A4X. - optional string gpu_topology = 4 [json_name = "gpuTopology"]; - - // 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"]; + optional Warning warning = 7 [json_name = "warning"]; } -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 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. + // [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. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -465,154 +238,34 @@ message ResourcePolicyList { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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"]; -} - -// Represents the workload policy. -message ResourcePolicyWorkloadPolicy { - optional string accelerator_topology = 1 [json_name = "acceleratorTopology"]; - - // BLOCK: VMs must be provisioned in the same block. - // CLUSTER: VMs must be provisioned in the same cluster. - // SUBBLOCK: VMs must be provisioned in the same subblock. - optional string max_topology_distance = 2 [json_name = "maxTopologyDistance"]; - - // HIGH_AVAILABILITY: VMs will be provisioned in such a way which provides - // high availability. - // HIGH_THROUGHPUT: VMs will be provisioned in such a way which provides high - // throughput. - optional string type = 3 [json_name = "type"]; + // [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_115.proto b/protos/google/cloud/compute/v1/internal/common_115.proto index 3e03aea1f9ca2..6ded45b366ae2 100644 --- a/protos/google/cloud/compute/v1/internal/common_115.proto +++ b/protos/google/cloud/compute/v1/internal/common_115.proto @@ -15,268 +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: 20250601 +// revision: 20260807 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"]; - - // [Output Only] Creation timestamp in RFC3339 text format. - optional string creation_timestamp = 2 [json_name = "creationTimestamp"]; - - // An optional description of this resource. Provide this field when you - // create the resource. - optional string description = 3 [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"]; - - // [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 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"]; - - // [Output only] Internal fixed region-to-region cost that Google Cloud - // calculates based on factors such as network performance, distance, and - // available bandwidth between regions. - optional uint32 next_hop_inter_region_cost = 23 - [json_name = "nextHopInterRegionCost"]; - - // 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"]; - - // [Output Only] Multi-Exit Discriminator, a BGP route metric that indicates - // the desirability of a particular route in a network. - optional uint32 next_hop_med = 24 [json_name = "nextHopMed"]; - - // The URL of the local network if it should handle matching packets. - optional string next_hop_network = 13 [json_name = "nextHopNetwork"]; - - // [Output Only] Indicates the origin of the route. Can be IGP (Interior - // Gateway Protocol), EGP (Exterior Gateway Protocol), or INCOMPLETE. - // EGP: - // IGP: - // INCOMPLETE: - optional string next_hop_origin = 25 [json_name = "nextHopOrigin"]; - - // [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"]; - - // Input only. [Input Only] Additional params passed with the request, but not - // persisted as part of resource payload. - optional RouteParams params = 26 [json_name = "params"]; - - // 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 - // 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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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 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"]; -} - -// Additional route parameters. -message RouteParams { - // Tag keys/values directly bound to this resource. Tag keys and values have - // the same definition as resource manager tags. The field is allowed for - // INSERT only. The keys/values to set on the resource should be specified in - // either ID { : } or Namespaced format { : }. For example the following are - // valid inputs: * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : - // "tagValues/456"} * {"123/environment" : "production", "345/abc" : "xyz"} - // Note: * Invalid combinations of ID & namespaced format is not supported. - // For instance: {"123/environment" : "tagValues/444"} is invalid. - map resource_manager_tags = 1 - [json_name = "resourceManagerTags"]; +// 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_116.proto b/protos/google/cloud/compute/v1/internal/common_116.proto index 079aeb702830d..773a4d28a7e14 100644 --- a/protos/google/cloud/compute/v1/internal/common_116.proto +++ b/protos/google/cloud/compute/v1/internal/common_116.proto @@ -15,91 +15,261 @@ // 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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; +import "google/cloud/compute/v1/internal/common_032.proto"; import "google/cloud/compute/v1/internal/common_115.proto"; -// Contains a list of Route resources. -message RouteList { +// Represents a Region resource. +// +// A region is a geographical area where a resource is located. For more +// information, readRegions +// and Zones. +message Region { + // [Output Only] Creation timestamp inRFC3339 + // 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. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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. [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 orDOWN. + // DOWN: + // UP: + optional string status = 9 [json_name = "status"]; + + // Output only. [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 { // [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"]; + // A list of Region resources. + repeated Region items = 2 [json_name = "items"]; - // Type of resource. + // Output only. [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 + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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. + // Output only. [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. + // [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. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -108,19 +278,27 @@ message RouteList { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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. diff --git a/protos/google/cloud/compute/v1/internal/common_117.proto b/protos/google/cloud/compute/v1/internal/common_117.proto index 1220286ba20fd..12257379bcac8 100644 --- a/protos/google/cloud/compute/v1/internal/common_117.proto +++ b/protos/google/cloud/compute/v1/internal/common_117.proto @@ -15,316 +15,104 @@ // 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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_031.proto"; +import "google/cloud/compute/v1/internal/common_010.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 = 3 [json_name = "creationTimestamp"]; - - optional SecurityPolicyDdosProtectionConfig ddos_protection_config = 4 - [json_name = "ddosProtectionConfig"]; - - // 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"]; - - // 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 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: - // ADVANCED_PREVIEW: - // STANDARD: - optional string ddos_protection = 1 [json_name = "ddosProtection"]; -} - -message SecurityPolicyList { +// 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 SecurityPolicy resources. - repeated SecurityPolicy items = 2 [json_name = "items"]; + // A list of Autoscaler resources. + repeated Autoscaler items = 2 [json_name = "items"]; - // [Output Only] Type of resource. Always compute#securityPolicyList for - // listsof securityPolicies + // Output only. 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 + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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. [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. + // [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. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -333,19 +121,27 @@ message SecurityPolicyList { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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. @@ -353,463 +149,5 @@ 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"]; -} - -// 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. - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the - // client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the key - // type defaults to ALL. - // ALL: - // HTTP_COOKIE: - // HTTP_HEADER: - // HTTP_PATH: - // IP: - // REGION_CODE: - // SNI: - // TLS_JA3_FINGERPRINT: - // TLS_JA4_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. - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the - // client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the key - // type defaults to ALL. - // ALL: - // HTTP_COOKIE: - // HTTP_HEADER: - // HTTP_PATH: - // IP: - // REGION_CODE: - // SNI: - // TLS_JA3_FINGERPRINT: - // TLS_JA4_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"]; + optional Warning warning = 6 [json_name = "warning"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_118.proto b/protos/google/cloud/compute/v1/internal/common_118.proto index 9116b89acb306..f3571c1d1d1be 100644 --- a/protos/google/cloud/compute/v1/internal/common_118.proto +++ b/protos/google/cloud/compute/v1/internal/common_118.proto @@ -15,12 +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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -message SecurityPolicyReference { - optional string security_policy = 1 [json_name = "securityPolicy"]; +import "google/cloud/compute/v1/internal/common_035.proto"; + +message RegionDiskTypeList { + // [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. [Output Only] Type of resource. + // Alwayscompute#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 + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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_119.proto b/protos/google/cloud/compute/v1/internal/common_119.proto index e9ba2b46f3430..0543eacee1791 100644 --- a/protos/google/cloud/compute/v1/internal/common_119.proto +++ b/protos/google/cloud/compute/v1/internal/common_119.proto @@ -15,494 +15,69 @@ // 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: 20250601 +// revision: 20260807 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"]; - - // 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 = 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"]; +message RegionDiskUpdateKmsKeyRequest { + // Optional. The new KMS key to replace the current one on the disk. If empty, + // the disk + // will be re-encrypted using the primary version of the disk's current KMS + // key. + // + // The KMS key can be provided in the following formats: + // + // + // - + // projects/project_id/locations/location/keyRings/key_ring/cryptoKeys/key + // + // + // Where project is the project ID or + // project number. + optional string kms_key_name = 1 [json_name = "kmsKeyName"]; } -// 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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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 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 RegionDisksAddResourcePoliciesRequest { + // Resource policies to be added to this disk. + repeated string resource_policies = 1 [json_name = "resourcePolicies"]; } -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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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 RegionDisksRemoveResourcePoliciesRequest { + // Resource policies to be removed from this disk. + repeated string resource_policies = 1 [json_name = "resourcePolicies"]; } -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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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 RegionDisksResizeRequest { + // The new size of the regional persistent disk, which is specified in GB. + optional string size_gb = 1 [json_name = "sizeGb"]; } -message Uint128 { - optional string high = 1 [json_name = "high"]; - - optional string low = 2 [json_name = "low"]; +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_120.proto b/protos/google/cloud/compute/v1/internal/common_120.proto index e6fecfc74bc08..c06e27677b15b 100644 --- a/protos/google/cloud/compute/v1/internal/common_120.proto +++ b/protos/google/cloud/compute/v1/internal/common_120.proto @@ -15,30 +15,300 @@ // 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: 20250601 +// revision: 20260807 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_073.proto"; +import "google/cloud/compute/v1/internal/common_098.proto"; + +// Contains a list of InstanceGroup resources. +message RegionInstanceGroupList { + // Output only. [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"]; + + // Output only. The resource type. + optional string kind = 3 [json_name = "kind"]; + + // Output only. [Output Only] This token allows you to get the next page of + // results for + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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. [Output Only] Informational warning message. + optional Warning warning = 6 [json_name = "warning"]; } -// 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"]; +message RegionInstanceGroupsListInstances { + // Output only. [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"]; + + // Output only. The resource type. + optional string kind = 3 [json_name = "kind"]; + + // Output only. [Output Only] This token allows you to get the next page of + // results for + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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. [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 + // theinstanceGroups.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_121.proto b/protos/google/cloud/compute/v1/internal/common_121.proto index 00bbe00e6366d..30a7887866364 100644 --- a/protos/google/cloud/compute/v1/internal/common_121.proto +++ b/protos/google/cloud/compute/v1/internal/common_121.proto @@ -15,23 +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: 20250601 +// revision: 20260807 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_037.proto"; +import "google/cloud/compute/v1/internal/common_110.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 thanmaxResults, use the + // nextPageToken as a value 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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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 + // aszones/[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. [Output Only] This token allows you to get the next page of + // results for + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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. [Output Only] The list of PerInstanceConfig. + repeated PerInstanceConfig items = 1 [json_name = "items"]; + + // Output only. [Output Only] This token allows you to get the next page of + // results for + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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. [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. [Output Only] This token allows you to get the next page of + // results for + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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 RegionInstanceGroupManagersResumeInstancesRequest { + // The URLs of one or more instances to resume. 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 theinstanceGroup + // 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 RegionInstanceGroupManagersSetTemplateRequest { + // URL of the InstanceTemplate resource from which all new instances will be + // created. + optional string instance_template = 1 [json_name = "instanceTemplate"]; +} + +message RegionInstanceGroupManagersStartInstancesRequest { + // The URLs of one or more instances to start. 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 RegionInstanceGroupManagersStopInstancesRequest { + // If this flag is set to true, the Instance Group Manager will proceed to + // stop the instances, skipping initialization on them. + optional bool force_stop = 1 [json_name = "forceStop"]; + + // The URLs of one or more instances to stop. This can be a full URL or + // a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. + repeated string instances = 2 [json_name = "instances"]; +} + +message RegionInstanceGroupManagersSuspendInstancesRequest { + // If this flag is set to true, the Instance Group Manager will proceed to + // suspend the instances, skipping initialization on them. + optional bool force_suspend = 1 [json_name = "forceSuspend"]; + + // The URLs of one or more instances to suspend. This can be a full URL or + // a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. + repeated string instances = 2 [json_name = "instances"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_122.proto b/protos/google/cloud/compute/v1/internal/common_122.proto index fec9e8dfe019d..7b57f0c48eafb 100644 --- a/protos/google/cloud/compute/v1/internal/common_122.proto +++ b/protos/google/cloud/compute/v1/internal/common_122.proto @@ -15,212 +15,146 @@ // 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: 20250601 +// revision: 20260807 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. LINT.IfChange -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"]; - - // [Input Only] Whether to attempt an application consistent snapshot by - // informing the OS to prepare for the snapshot process. - optional bool guest_flush = 37 [json_name = "guestFlush"]; - - // [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 snapshot. For example, if you created the snapshot 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"]; - - // Cloud Storage bucket storage location of the snapshot (regional or - // multi-regional). - repeated string storage_locations = 29 [json_name = "storageLocations"]; +import "google/cloud/compute/v1/internal/common_076.proto"; + +message RegionInstanceGroupManagerResizeRequestsListResponse { + 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 Resize Request resources. + repeated InstanceGroupManagerResizeRequest items = 3 [json_name = "items"]; + + // Output only. Type of the resource. + // Alwayscompute#regionInstanceGroupManagerResizeRequestList for + // a list of Resize Requests. + 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 thanmaxResults, use the + // nextPageToken as a value 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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_123.proto b/protos/google/cloud/compute/v1/internal/common_123.proto index ddc354e7d233d..c014c5f267b34 100644 --- a/protos/google/cloud/compute/v1/internal/common_123.proto +++ b/protos/google/cloud/compute/v1/internal/common_123.proto @@ -15,118 +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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_122.proto"; +import "google/cloud/compute/v1/internal/common_015.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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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 RegionNetworkEndpointGroupsAttachEndpointsRequest { + // The list of network endpoints to be attached. + repeated NetworkEndpoint network_endpoints = 1 + [json_name = "networkEndpoints"]; +} - // [Output Only] Informational warning message. - optional Warning warning = 6 [json_name = "warning"]; +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_124.proto b/protos/google/cloud/compute/v1/internal/common_124.proto index faa35c9e95a5d..3d388c1f8757c 100644 --- a/protos/google/cloud/compute/v1/internal/common_124.proto +++ b/protos/google/cloud/compute/v1/internal/common_124.proto @@ -15,42 +15,58 @@ // 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: 20250601 +// revision: 20260807 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_043.proto"; +import "google/cloud/compute/v1/internal/common_048.proto"; + +message RegionNetworkFirewallPoliciesGetEffectiveFirewallsResponse { + // Output only. [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"]; -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"]; + // Effective firewalls on the network. + repeated Firewall firewalls = 2 [json_name = "firewalls"]; } -// 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 +RegionNetworkFirewallPoliciesGetEffectiveFirewallsResponseEffectiveFirewallPolicy { + // Output only. [Output Only] The display name of the firewall policy. + optional string display_name = 1 [json_name = "displayName"]; + + // Output only. [Output Only] The name of the firewall policy. + optional string name = 2 [json_name = "name"]; + + // Output only. [Output only] The packet mirroring rules that apply to the + // network. + repeated FirewallPolicyRule packet_mirroring_rules = 5 + [json_name = "packetMirroringRules"]; + + // Output only. [Output only] Priority of firewall policy association. Not + // applicable for + // type=HIERARCHY. + optional int32 priority = 6 [json_name = "priority"]; + + // Output only. [Output only] The rules that apply to the network. + repeated FirewallPolicyRule rules = 3 [json_name = "rules"]; + + // Output only. [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 = 4 [json_name = "type"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_125.proto b/protos/google/cloud/compute/v1/internal/common_125.proto index f38802943b5ab..e5fa9279bd645 100644 --- a/protos/google/cloud/compute/v1/internal/common_125.proto +++ b/protos/google/cloud/compute/v1/internal/common_125.proto @@ -15,243 +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: 20250601 +// revision: 20260807 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"]; -} - -// 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 SslCertificate resources. - repeated SslCertificate 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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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 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"]; +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"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_126.proto b/protos/google/cloud/compute/v1/internal/common_126.proto index bdea54765a2be..75becc0b540c7 100644 --- a/protos/google/cloud/compute/v1/internal/common_126.proto +++ b/protos/google/cloud/compute/v1/internal/common_126.proto @@ -15,213 +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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_125.proto"; +import "google/cloud/compute/v1/internal/common_009.proto"; -message SslCertificateAggregatedList { - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 1 [json_name = "id"]; +message RegionSetPolicyRequest { + // Flatten Policy to create a backwacd compatible wire-format. + // Deprecated. Use 'policy' to specify bindings. + repeated Binding bindings = 1 [json_name = "bindings"]; - // A list of SslCertificatesScopedList resources. - map items = 2 [json_name = "items"]; + // 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] 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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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 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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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"]; + // 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_127.proto b/protos/google/cloud/compute/v1/internal/common_127.proto index 219d7a4482639..39dd8add7773e 100644 --- a/protos/google/cloud/compute/v1/internal/common_127.proto +++ b/protos/google/cloud/compute/v1/internal/common_127.proto @@ -15,215 +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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_128.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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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 RegionSnapshotUpdateKmsKeyRequest { + // Optional. The new KMS key to replace the current one on the snapshot. If + // empty, the + // snapshot will be re-encrypted using the primary version of the snapshot's + // current KMS key. + // + // The KMS key can be provided in the following formats: + // + // + // - projects/project_id/locations/region/keyRings/region/cryptoKeys/key + optional string kms_key_name = 1 [json_name = "kmsKeyName"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_128.proto b/protos/google/cloud/compute/v1/internal/common_128.proto index fc8b4c1424154..4a3782cb34c3b 100644 --- a/protos/google/cloud/compute/v1/internal/common_128.proto +++ b/protos/google/cloud/compute/v1/internal/common_128.proto @@ -15,282 +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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -message SslPoliciesList { - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 1 [json_name = "id"]; - - // A list of SslPolicy resources. - repeated SslPolicy items = 2 [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] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value 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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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 SslPoliciesListAvailableFeaturesResponse { - repeated string features = 1 [json_name = "features"]; -} - -// 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 - // 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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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 potential misconfigurations are detected for this SSL - // policy, this field will be populated with warning messages. - repeated WarningsItem warnings = 13 [json_name = "warnings"]; +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_129.proto b/protos/google/cloud/compute/v1/internal/common_129.proto index d365443d8f6aa..e7ccb80a9ba51 100644 --- a/protos/google/cloud/compute/v1/internal/common_129.proto +++ b/protos/google/cloud/compute/v1/internal/common_129.proto @@ -15,14 +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: 20250601 +// revision: 20260807 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_023.proto"; + +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_130.proto b/protos/google/cloud/compute/v1/internal/common_130.proto index 4f4d1f5412e83..9f0f018eba1d2 100644 --- a/protos/google/cloud/compute/v1/internal/common_130.proto +++ b/protos/google/cloud/compute/v1/internal/common_130.proto @@ -15,469 +15,142 @@ // 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: 20250601 +// revision: 20260807 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 ReliabilityRisk resource. +message ReliabilityRisk { + // Output only. [Output Only] Creation timestamp in RFC3339 + // text format. + optional string creation_timestamp = 1 [json_name = "creationTimestamp"]; - // [Output Only] Creation timestamp in RFC3339 text format. - optional string creation_timestamp = 2 [json_name = "creationTimestamp"]; + // An optional textual description of the resource; provided when the + // resource is created. + optional string description = 2 [json_name = "description"]; - // An optional description of this resource. Provide this property when you - // create the resource. - optional string description = 3 [json_name = "description"]; + // [Output Only] Details of the reliability risk resource + optional RiskDetails details = 3 [json_name = "details"]; // [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. + // Output only. [Output Only] Type of resource. Always compute#reliabilityRisk + // for reliability risks. 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 = 2 [json_name = "id"]; - - // A list of StoragePoolsScopedList resources. - map items = 3 [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] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value 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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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 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"]; - - // [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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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"]; + // Name of the resource. The name must be 1-63 characters long and + // comply with RFC1035. + optional string name = 6 [json_name = "name"]; - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } + // The recommendation to mitigate the risk. + optional RiskRecommendation recommendation = 7 [json_name = "recommendation"]; - // [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. [Output Only] Server-defined URL for the resource. + optional string self_link = 8 [json_name = "selfLink"]; - // [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. [Output Only] Server-defined URL for this resource with the + // resource id. + optional string self_link_with_id = 9 [json_name = "selfLinkWithId"]; } -message StoragePoolListDisks { +// Response message for the List method of ReliabilityRisksService. +message ReliabilityRisksListResponse { + // [Output Only] An ETag of the resource. 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"]; + // A list of ReliabilityRisk resources. + repeated ReliabilityRisk items = 3 [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 + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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. [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 = 7 [json_name = "unreachables"]; + // Output only. [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. + // [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. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -486,19 +159,27 @@ message StoragePoolListDisks { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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. @@ -506,145 +187,58 @@ message StoragePoolListDisks { } // [Output Only] Informational warning message. - optional Warning warning = 8 [json_name = "warning"]; + optional Warning warning = 7 [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"]; +// Detailed insights and metrics about a detected reliability risk. +message RiskDetails { + // The duration of the risk since it was detected. + optional string duration = 1 [json_name = "duration"]; + + // Insight details for global DNS risk. + optional RiskDetailsGlobalDnsInsight global_dns_insight = 2 + [json_name = "globalDnsInsight"]; + + // The last time the risk was updated. + optional string last_update_timestamp = 3 [json_name = "lastUpdateTimestamp"]; + + // The severity of the risk. + // CRITICAL: Critical severity. + // HIGH: High severity. + // LOW: Low severity. + // MEDIUM: Medium severity. + // SEVERITY_UNSPECIFIED: No severity specified. The default value. + optional string severity = 4 [json_name = "severity"]; + + // The type of risk. + // GLOBAL_DNS: Risk type related to global DNS. + // RISK_TYPE_UNSPECIFIED: Default value. This value is unused. + optional string type = 5 [json_name = "type"]; } -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 - // 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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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"]; +// Detailed insights for a global DNS reliability risk. +message RiskDetailsGlobalDnsInsight { + // Indicates whether the project's default DNS setting is global DNS. + optional bool project_default_is_global_dns = 1 + [json_name = "projectDefaultIsGlobalDns"]; - 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 observation window for the query counts. + optional string query_observation_window = 2 + [json_name = "queryObservationWindow"]; - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } + // The number of queries that are risky. This is always less than or + // equal to total_query_count. + optional string risky_query_count = 3 [json_name = "riskyQueryCount"]; - // [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 total number of queries in the observation window. + optional string total_query_count = 4 [json_name = "totalQueryCount"]; +} - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } +// Recommendation for mitigating a reliability risk, including a reference URL. +message RiskRecommendation { + // Mitigation guide for the risk. + optional string content = 1 [json_name = "content"]; - // [Output Only] Informational warning which replaces the list of storage pool - // when the list is empty. - optional Warning warning = 2 [json_name = "warning"]; + // URL referencing a more detailed mitigation guide. + optional string reference_url = 2 [json_name = "referenceUrl"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_131.proto b/protos/google/cloud/compute/v1/internal/common_131.proto index 603a7d6856181..774f6d04eaca3 100644 --- a/protos/google/cloud/compute/v1/internal/common_131.proto +++ b/protos/google/cloud/compute/v1/internal/common_131.proto @@ -15,156 +15,107 @@ // 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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_023.proto"; +import "google/cloud/compute/v1/internal/common_008.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 { +// 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 StoragePoolTypesScopedList resources. - map items = 2 [json_name = "items"]; + // A list of Allocation resources. + map items = 2 [json_name = "items"]; - // [Output Only] Type of resource. Always - // compute#storagePoolTypeAggregatedList . + // Output only. 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 + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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. + // Output only. [Output Only] Server-defined URL for this resource. optional string self_link = 5 [json_name = "selfLink"]; + // Output only. [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. + // [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. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -173,19 +124,27 @@ message StoragePoolTypeAggregatedList { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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. @@ -193,87 +152,100 @@ message StoragePoolTypeAggregatedList { } // [Output Only] Informational warning message. - optional Warning warning = 6 [json_name = "warning"]; + optional Warning warning = 7 [json_name = "warning"]; } -// Contains a list of storage pool types. -message StoragePoolTypeList { - // [Output Only] Unique identifier for the resource; defined by the server. +message ReservationList { + // [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 StoragePoolType resources. - repeated StoragePoolType items = 2 [json_name = "items"]; + // [Output Only] A list of Allocation resources. + repeated Reservation items = 2 [json_name = "items"]; - // [Output Only] Type of resource. Always compute#storagePoolTypeList for - // storage pool types. + // Output only. [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 + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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. + // Output only. [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. + // [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. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -282,19 +254,27 @@ message StoragePoolTypeList { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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. @@ -305,67 +285,98 @@ message StoragePoolTypeList { 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 ReservationsPerformMaintenanceRequest { + // Specifies if all, running or unused hosts are in scope for this request. + // ALL: Trigger maintenance for all hosts belonging to this reservation + // irrespective of whether VMs are running on them or not. + // MAINTENANCE_SCOPE_UNSPECIFIED: Internal only + // RUNNING_VMS: Trigger maintenance only on the hosts belonging to this + // reservation which + // have VMs running on them. + // UNUSED_CAPACITY: Trigger maintenance only on the hosts belonging to this + // reservation which + // do not have any VMs running on them. This is not allowed for Standard ExR + optional string maintenance_scope = 1 [json_name = "maintenanceScope"]; +} + +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. + // [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. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -374,26 +385,34 @@ message StoragePoolTypesScopedList { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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. + // 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_132.proto b/protos/google/cloud/compute/v1/internal/common_132.proto index 8081a2b513a28..b650e67f2dd71 100644 --- a/protos/google/cloud/compute/v1/internal/common_132.proto +++ b/protos/google/cloud/compute/v1/internal/common_132.proto @@ -15,879 +15,241 @@ // 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: 20250601 +// revision: 20260807 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"]; - - // 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"]; - - // Reference to the source of IP, like a PublicDelegatedPrefix (PDP) for - // BYOIP. The PDP must be a sub-PDP in EXTERNAL_IPV6_SUBNETWORK_CREATION mode. - // Use one of the following formats to specify a sub-PDP when creating a dual - // stack subnetwork with external access using BYOIP: - Full resource URL, as - // in https://www.googleapis.com/compute/v1/projects/projectId/regions/region - // /publicDelegatedPrefixes/sub-pdp-name - Partial URL, as in - - // projects/projectId/regions/region/publicDelegatedPrefixes/ sub-pdp-name - - // regions/region/publicDelegatedPrefixes/sub-pdp-name - optional string ip_collection = 26 [json_name = "ipCollection"]; - - // 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] Possible endpoints of this subnetwork. It can be one of the - // following: - VM_ONLY: The subnetwork can be used for creating instances and - // IPv6 addresses with VM endpoint type. Such a subnetwork gets external IPv6 - // ranges from a public delegated prefix and cannot be used to create NetLb. - - // VM_AND_FR: The subnetwork can be used for creating both VM instances and - // Forwarding Rules. It can also be used to reserve IPv6 addresses with both - // VM and FR endpoint types. Such a subnetwork gets its IPv6 range from Google - // IP Pool directly. - // VM_AND_FR: - // VM_ONLY: - optional string ipv6_gce_endpoint = 27 [json_name = "ipv6GceEndpoint"]; - - // [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"]; - - // Input only. [Input Only] Additional params passed with the request, but not - // persisted as part of resource payload. - optional SubnetworkParams params = 30 [json_name = "params"]; - - // 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"]; - - // 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. - // PEER_MIGRATION: Subnetwork will be used for Migration from one peered VPC - // to another. (a transient state of subnetwork while migrating resources from - // one project to another). - // 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"]; - - // Output only. [Output Only] The array of external IPv6 network ranges - // reserved from the subnetwork's external IPv6 range for system use. - repeated string system_reserved_external_ipv6_ranges = 28 - [json_name = "systemReservedExternalIpv6Ranges"]; - - // Output only. [Output Only] The array of internal IPv6 network ranges - // reserved from the subnetwork's internal IPv6 range for system use. - repeated string system_reserved_internal_ipv6_ranges = 29 - [json_name = "systemReservedInternalIpv6Ranges"]; -} - -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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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_059.proto"; - // [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"]; +// Represents a reservation block resource. +message ReservationBlock { + // Output only. [Output Only] The number of resources that are allocated in + // this + // reservation block. + optional int32 count = 1 [json_name = "count"]; - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } + // Output only. [Output Only] Creation timestamp inRFC3339 text format. + optional string creation_timestamp = 2 [json_name = "creationTimestamp"]; - // [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"]; -} + // Output only. [Output Only] Health information for the reservation block. + optional ReservationBlockHealthInfo health_info = 15 + [json_name = "healthInfo"]; -// Additional subnetwork parameters. -message SubnetworkParams { - // Tag keys/values directly bound to this resource. Tag keys and values have - // the same definition as resource manager tags. The field is allowed for - // INSERT only. The keys/values to set on the resource should be specified in - // either ID { : } or Namespaced format { : }. For example the following are - // valid inputs: * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : - // "tagValues/456"} * {"123/environment" : "production", "345/abc" : "xyz"} - // Note: * Invalid combinations of ID & namespaced format is not supported. - // For instance: {"123/environment" : "tagValues/444"} is invalid. - map resource_manager_tags = 1 - [json_name = "resourceManagerTags"]; -} - -// 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. [Output Only] The unique identifier for the resource. This + // identifier is + // defined by the server. + optional string id = 3 [json_name = "id"]; + + // Output only. [Output Only] The number of instances that are currently in + // use on this + // reservation block. + optional int32 in_use_count = 4 [json_name = "inUseCount"]; + + // Output only. Number of hosts currently in use. If there is one or more + // Instances running + // on the host, it is considered in use. + optional int32 in_use_host_count = 16 [json_name = "inUseHostCount"]; + + // Output only. [Output Only] Type of the resource. + // Alwayscompute#reservationBlock for reservation blocks. + optional string kind = 5 [json_name = "kind"]; + + // Output only. [Output Only] The name of this reservation block generated by + // Google + // Compute Engine. The name must be 1-63 characters long, and comply with + // RFC1035 @pattern [a-z](?:[-a-z0-9]{0,61}[a-z0-9])? + optional string name = 6 [json_name = "name"]; + + // Output only. [Output Only] The physical topology of the reservation block. + optional ReservationBlockPhysicalTopology physical_topology = 7 + [json_name = "physicalTopology"]; + + // Output only. [Output Only] Maintenance information for this reservation + // block. + optional GroupMaintenanceInfo reservation_maintenance = 8 + [json_name = "reservationMaintenance"]; + + // Output only. [Output Only] The number of reservation subBlocks associated + // with this + // reservation block. + optional int32 reservation_sub_block_count = 13 + [json_name = "reservationSubBlockCount"]; + + // Output only. [Output Only] The number of in-use reservation subBlocks + // associated with + // this reservation block. If at least one VM is running on a subBlock, it is + // considered in-use. + optional int32 reservation_sub_block_in_use_count = 14 + [json_name = "reservationSubBlockInUseCount"]; + + // Output only. [Output Only] Server-defined fully-qualified URL for this + // resource. + optional string self_link = 9 [json_name = "selfLink"]; + + // Output only. [Output Only] Server-defined URL for this resource with the + // resource id. + optional string self_link_with_id = 10 [json_name = "selfLinkWithId"]; + + // Output only. [Output Only] Status of the reservation block. + // CREATING: Resources are being allocated for the reservation block. + // DELETING: Reservation block is currently being deleted. + // INVALID: + // READY: Reservation block has allocated all its resources. + optional string status = 11 [json_name = "status"]; + + // Output only. [Output Only] Zone in which the reservation block resides. + optional string zone = 12 [json_name = "zone"]; } -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"]; +// Health information for the reservation block. +message ReservationBlockHealthInfo { + // The number of subBlocks that are degraded. + optional int32 degraded_sub_block_count = 1 + [json_name = "degradedSubBlockCount"]; + + // The health status of the reservation block. + // DEGRADED: The reservation block is degraded. + // HEALTHY: The reservation block is healthy. + // HEALTH_STATUS_UNSPECIFIED: The health status of the reservation block is + // unspecified. + optional string health_status = 2 [json_name = "healthStatus"]; + + // The number of subBlocks that are healthy. + optional int32 healthy_sub_block_count = 3 + [json_name = "healthySubBlockCount"]; } -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 - // 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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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"]; +message ReservationBlockPhysicalTopology { + // The hash of the capacity block within the cluster. + optional string block = 1 [json_name = "block"]; - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } + // The cluster name of the reservation block. + optional string cluster = 2 [json_name = "cluster"]; - // An informational warning that appears when the list of addresses is empty. - optional Warning warning = 2 [json_name = "warning"]; + // Output only. The detailed instances information for a given Block + repeated ReservationBlockPhysicalTopologyInstance instances = 3 + [json_name = "instances"]; } -message SubnetworksScopedWarning { - // Name of the scope containing this set of Subnetworks. - optional string scope_name = 1 [json_name = "scopeName"]; - - 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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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 instances information for a given Block +message ReservationBlockPhysicalTopologyInstance { + // The InstanceId of the instance + optional string instance_id = 1 [json_name = "instanceId"]; - // [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 PhysicalHostTopology of instances within a Block resource. + optional ReservationBlockPhysicalTopologyInstancePhysicalHostTopology + physical_host_topology = 2 [json_name = "physicalHostTopology"]; - // An informational warning about unreachable scope - optional Warning warning = 2 [json_name = "warning"]; + // Project where the instance lives + optional string project_id = 3 [json_name = "projectId"]; } -message SubnetworksSetPrivateIpGoogleAccessRequest { - optional bool private_ip_google_access = 1 - [json_name = "privateIpGoogleAccess"]; -} +// The PhysicalHostTopology of the instance within a Block resource. +message ReservationBlockPhysicalTopologyInstancePhysicalHostTopology { + // Host hash for a given instance + optional string host = 1 [json_name = "host"]; -// 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"]; - - // 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. - // PEER_MIGRATION: Subnetwork will be used for Migration from one peered VPC - // to another. (a transient state of subnetwork while migrating resources from - // one project to another). - // 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"]; + // Sub block hash for a given instance + optional string sub_block = 2 [json_name = "subBlock"]; } -// 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 ReservationBlocksGetResponse { + optional ReservationBlock resource = 1 [json_name = "resource"]; } -message UsableSubnetworksAggregatedList { - // [Output Only] The unique identifier for the resource. This identifier is - // defined by the server. +// A list of reservation blocks under a single reservation. +message ReservationBlocksListResponse { + // 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 reservation block resources. + repeated ReservationBlock items = 2 [json_name = "items"]; - // [Output Only] Type of resource. Always - // compute#usableSubnetworksAggregatedList for aggregated lists of usable - // subnetworks. + // Type of the resource. Alwayscompute#reservationBlock for a list of + // reservation blocks. 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. + // This token allows you to get the next page of results for + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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] Informational warning messages for failures encountered from - // scopes. - repeated SubnetworksScopedWarning scoped_warnings = 7 - [json_name = "scopedWarnings"]; - - // [Output Only] Server-defined URL for this resource. + // Server-defined URL for this resource. optional string self_link = 5 [json_name = "selfLink"]; - // [Output Only] Unreachable resources. - repeated string unreachables = 8 [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. + // [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. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -896,25 +258,47 @@ message UsableSubnetworksAggregatedList { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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. + // Informational warning message. optional Warning warning = 6 [json_name = "warning"]; } + +message ReservationsBlocksPerformMaintenanceRequest { + // Specifies if all, running or unused hosts are in scope for this request. + // ALL: Trigger maintenance for all hosts belonging to this reservation + // irrespective of whether VMs are running on them or not. + // MAINTENANCE_SCOPE_UNSPECIFIED: Internal only + // RUNNING_VMS: Trigger maintenance only on the hosts belonging to this + // reservation which + // have VMs running on them. + // UNUSED_CAPACITY: Trigger maintenance only on the hosts belonging to this + // reservation which + // do not have any VMs running on them. This is not allowed for Standard ExR + optional string maintenance_scope = 1 [json_name = "maintenanceScope"]; +} diff --git a/protos/google/cloud/compute/v1/internal/common_133.proto b/protos/google/cloud/compute/v1/internal/common_133.proto index 1510039a6c15c..d3580952cc09b 100644 --- a/protos/google/cloud/compute/v1/internal/common_133.proto +++ b/protos/google/cloud/compute/v1/internal/common_133.proto @@ -15,151 +15,192 @@ // 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: 20250601 +// revision: 20260807 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 { - // [Output Only] Creation timestamp in RFC3339 text format. +import "google/cloud/compute/v1/internal/common_144.proto"; + +// Represents a reservation slot resource. +message ReservationSlot { + // Output only. [Output Only] The creation timestamp, formatted asRFC3339 + // text. 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 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 type. The server - // generates this identifier. - optional string id = 4 [json_name = "id"]; - - // [Output Only] Type of the resource. Always compute#targetGrpcProxy for - // target grpc 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. - // 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 = 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"]; + // Output only. [Output Only] The unique identifier for this resource. This + // identifier is + // defined by the server. + optional string id = 2 [json_name = "id"]; + + // Output only. [Output Only] The type of resource. + // Alwayscompute#reservationSlot for reservation slots. + optional string kind = 3 [json_name = "kind"]; + + // Output only. [Output Only] The name of the reservation slot. + optional string name = 4 [json_name = "name"]; + + // Output only. [Output Only] The physical topology of the reservation slot. + optional ReservationSlotPhysicalTopology physical_topology = 5 + [json_name = "physicalTopology"]; + + // Output only. [Output Only] A server-defined fully-qualified URL for this + // resource. + optional string self_link = 6 [json_name = "selfLink"]; + + // Output only. [Output Only] A server-defined URL for this resource with the + // resource ID. + optional string self_link_with_id = 7 [json_name = "selfLinkWithId"]; + + // Specify share settings to create a shared slot. Set to empty + // to inherit the share settings from a parent resource. + optional ShareSettings share_settings = 8 [json_name = "shareSettings"]; + + // Output only. [Output Only] The state of the reservation slot. + // ACTIVE: The reservation slot has allocated all its resources. + // CREATING: The resources are being allocated for the reservation slot. + // DELETING: The reservation slot is currently being deleted. + // STATE_UNSPECIFIED: + // UNAVAILABLE: The reservation slot is currently unavailable. + optional string state = 9 [json_name = "state"]; + + // Output only. [Output Only] The status of the reservation slot. + optional ReservationSlotStatus status = 10 [json_name = "status"]; + + // Output only. [Output Only] The zone in which the reservation slot resides. + optional string zone = 11 [json_name = "zone"]; +} + +message ReservationSlotPhysicalTopology { + // The unique identifier of the capacity block within the cluster. + optional string block = 1 [json_name = "block"]; + + // The cluster name of the reservation sub-block. + optional string cluster = 2 [json_name = "cluster"]; + + // The unique identifier of the capacity host within the capacity sub-block. + optional string host = 3 [json_name = "host"]; + + // The unique identifier of the capacity sub-block within the capacity + // block. + optional string sub_block = 4 [json_name = "subBlock"]; +} + +message ReservationSlotStatus { + // Output only. [Output Only] The physical topology of the reservation + // sub-block. + optional ReservationSlotPhysicalTopology physical_topology = 1 + [json_name = "physicalTopology"]; + + // Output only. The RDMA IP address of the physical host. + repeated string rdma_ip_addresses = 2 [json_name = "rdmaIpAddresses"]; + + // Output only. The URIs of the instances currently running on this slot. + repeated string running_instances = 3 [json_name = "runningInstances"]; +} + +message ReservationSlotsGetResponse { + optional ReservationSlot resource = 1 [json_name = "resource"]; +} + +message ReservationSlotsGetVersionRequest { + // The SBOM selection to return. Duplicate values in the list will be ignored. + repeated string sbom_selections = 1 [json_name = "sbomSelections"]; } -message TargetGrpcProxyList { - // [Output Only] Unique identifier for the resource; defined by the server. +// A list of reservation slots within a single reservation. +message ReservationSlotsListResponse { + // The 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 reservation slot resources. + repeated ReservationSlot items = 2 [json_name = "items"]; - // [Output Only] Type of the resource. Always compute#targetGrpcProxy for - // target grpc proxies. + // The type of resource. Alwayscompute#reservationSlot for a list of + // reservation + // slots. 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 + // This token allows you to get the next page of results for + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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. + // The 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. + // [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. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -168,25 +209,33 @@ message TargetGrpcProxyList { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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. + // An informational warning message. optional Warning warning = 6 [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 1aaf6cffce68c..e2616d39b6a0b 100644 --- a/protos/google/cloud/compute/v1/internal/common_134.proto +++ b/protos/google/cloud/compute/v1/internal/common_134.proto @@ -15,128 +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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_135.proto"; +// Standardized resource metadata common to all compute resources. +message ResourceMetadata { + // The version of the API interface that this resource was retrieved through. + // For example, `"2025-01-01"` or `"2025-01-01-preview"`. + optional string api_version = 1 [json_name = "apiVersion"]; -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 - // 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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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 TargetHttpProxyAggregatedList { - // [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"]; - - // [Output Only] Type of resource. Always - // 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. - 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"]; + // The canonical resource type name in the format of a resource type + // as defined by [AIP-123](https://google.aip.dev/123). + // For example, `"compute.googleapis.com/Instance"`. + optional string resource_type = 2 [json_name = "resourceType"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_135.proto b/protos/google/cloud/compute/v1/internal/common_135.proto index f56cd6b2f989b..d6f687b87e358 100644 --- a/protos/google/cloud/compute/v1/internal/common_135.proto +++ b/protos/google/cloud/compute/v1/internal/common_135.proto @@ -15,166 +15,521 @@ // 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: 20250601 +// revision: 20260807 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 { - // [Output Only] Creation timestamp in RFC3339 text format. +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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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 toschedule persistent disk +// snapshots. +message ResourcePolicy { + // Output only. [Output Only] Creation timestamp inRFC3339 + // 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 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"]; - - // 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"]; + // Resource policy for disk consistency groups. + optional ResourcePolicyDiskConsistencyGroupPolicy + disk_consistency_group_policy = 13 + [json_name = "diskConsistencyGroupPolicy"]; - // [Output Only] The unique identifier for the resource. This identifier is + // Resource policy for instances for placement configuration. + optional ResourcePolicyGroupPlacementPolicy group_placement_policy = 3 + [json_name = "groupPlacementPolicy"]; + + // Output only. [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#targetHttpProxy for target - // HTTP proxies. - optional string kind = 5 [json_name = "kind"]; + // Resource policy for scheduling instance operations. + optional ResourcePolicyInstanceSchedulePolicy instance_schedule_policy = 5 + [json_name = "instanceSchedulePolicy"]; + + // Output only. [Output Only] Type of the resource. + // Alwayscompute#resource_policies for resource policies. + 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. + // 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 + // withRFC1035. // 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"]; - - // 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. + // 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] Server-defined URL for the resource. - optional string self_link = 9 [json_name = "selfLink"]; + // Output only. [Output Only] The system status of the resource policy. + optional ResourcePolicyResourceStatus resource_status = 9 + [json_name = "resourceStatus"]; + + // Output only. [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. [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"]; - // URL to the UrlMap resource that defines the mapping from URL to the - // BackendService. - optional string url_map = 10 [json_name = "urlMap"]; + // Resource policy for defining instance placement for MIGs. + optional ResourcePolicyWorkloadPolicy workload_policy = 14 + [json_name = "workloadPolicy"]; } -// A list of TargetHttpProxy resources. -message TargetHttpProxyList { +// 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 = 1 [json_name = "id"]; + optional string id = 2 [json_name = "id"]; + + // A list of ResourcePolicy resources. + map items = 3 [json_name = "items"]; + + // Output only. 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 thanmaxResults, use the + // nextPageToken as a value 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. [Output Only] Server-defined URL for this resource. + optional string self_link = 6 [json_name = "selfLink"]; + + // Output only. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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. [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 { + // Specifies the connection mode for the accelerator topology. If not + // specified, the default is AUTO_CONNECT. + // AUTO_CONNECT: The interconnected chips are pre-configured at the time of VM + // creation. + // PROVISION_ONLY: The interconnected chips are connected on demand. At the + // time of VM + // creation, the chips are not connected. + optional string accelerator_topology_mode = 5 + [json_name = "acceleratorTopologyMode"]; + + // 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"]; + + // Specifies the shape of the GPU slice, in slice based GPU families eg. + // A4X. + optional string gpu_topology = 4 [json_name = "gpuTopology"]; + + // 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"]; +} - // A list of TargetHttpProxy resources. - repeated TargetHttpProxy items = 2 [json_name = "items"]; +// Time window specified for hourly operations. +message ResourcePolicyHourlyCycle { + // Output only. [Output only] Duration of the time window, automatically + // chosen to be + // smallest possible in the given scenario. + optional string duration = 1 [json_name = "duration"]; - // Type of resource. Always compute#targetHttpProxyList for lists of target - // HTTP proxies. - optional string kind = 3 [json_name = "kind"]; + // 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. [Output Only] Type of + // resource.Alwayscompute#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 + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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"]; + // Output only. [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. + // [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. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -183,19 +538,27 @@ message TargetHttpProxyList { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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. @@ -203,5 +566,153 @@ message TargetHttpProxyList { } // [Output Only] Informational warning message. - optional Warning warning = 6 [json_name = "warning"]; + 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. [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. [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. [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. [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"]; +} + +// Represents the workload policy. +message ResourcePolicyWorkloadPolicy { + // Specifies the topology required to create a partition for VMs that have + // interconnected GPUs. + optional string accelerator_topology = 1 [json_name = "acceleratorTopology"]; + + // Specifies the connection mode for the accelerator topology. If not + // specified, the default is AUTO_CONNECT. + // AUTO_CONNECT: The interconnected chips are pre-configured at the time of VM + // creation. + // PROVISION_ONLY: The interconnected chips are connected on demand. At the + // time of VM + // creation, the chips are not connected. + optional string accelerator_topology_mode = 4 + [json_name = "acceleratorTopologyMode"]; + + // Specifies the maximum distance between instances. + // BLOCK: VMs must be provisioned in the same block. + // CLUSTER: VMs must be provisioned in the same cluster. + // SUBBLOCK: VMs must be provisioned in the same subblock. + optional string max_topology_distance = 2 [json_name = "maxTopologyDistance"]; + + // Specifies the intent of the instance placement in the MIG. + // HIGH_AVAILABILITY: MIG spreads out the instances as much as possible for + // high availability. + // HIGH_THROUGHPUT: MIG provisions instances as close to each other as + // possible for high + // throughput. + optional string type = 3 [json_name = "type"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_136.proto b/protos/google/cloud/compute/v1/internal/common_136.proto index cab0149ce4c84..ffe07c4134697 100644 --- a/protos/google/cloud/compute/v1/internal/common_136.proto +++ b/protos/google/cloud/compute/v1/internal/common_136.proto @@ -15,210 +15,302 @@ // 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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_137.proto"; +// Rollout resource. +// +// A Rollout is a specific instance of a RolloutPlan. It represents a single +// execution of a strategy to roll out a specific resource. It also provides +// APIs to interact with the rollout. +message Rollout { + // Output only. The timestamp at which the Rollout was cancelled. + optional string cancellation_time = 1 [json_name = "cancellationTime"]; -message TargetHttpsProxiesScopedList { - // A list of TargetHttpsProxies contained in this scope. - repeated TargetHttpsProxy target_https_proxies = 1 - [json_name = "targetHttpsProxies"]; + // Output only. The timestamp at which the Rollout was completed. + optional string completion_time = 2 [json_name = "completionTime"]; - 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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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. [Output Only] Creation timestamp inRFC3339 + // text format. + optional string creation_timestamp = 3 [json_name = "creationTimestamp"]; - 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. The number of the currently running wave. + // Ex. 1 + optional string current_wave_number = 4 [json_name = "currentWaveNumber"]; - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } + // An optional description of this resource. Provide this property when you + // create the resource. + optional string description = 5 [json_name = "description"]; - // [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. etag of the Rollout + // Ex. abc1234 + optional string etag = 6 [json_name = "etag"]; - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } + // Output only. [Output Only] The unique identifier for the resource. This + // identifier is + // defined by the server. + optional string id = 7 [json_name = "id"]; + + // Output only. [Output Only] Type of the resource. Always compute#rollout + // for rollouts. + 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 withRFC1035. + // 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. The timestamp at which the Rollout was paused. + optional string pause_time = 10 [json_name = "pauseTime"]; + + // Output only. The timestamp at which the Rollout was resumed. + optional string resume_time = 11 [json_name = "resumeTime"]; + + // Required. The resource being rolled out. + optional RolloutRolloutEntity rollout_entity = 12 + [json_name = "rolloutEntity"]; - // Informational warning which replaces the list of backend services when the - // list is empty. - optional Warning warning = 2 [json_name = "warning"]; + // Required. Rollout Plan used to model the Rollout. + // Ex. compute.googleapis.com/v1/projects/1234/rolloutPlans/rp1 + optional string rollout_plan = 13 [json_name = "rolloutPlan"]; + + // Output only. [Output Only] Server-defined fully-qualified URL for this + // resource. + optional string self_link = 14 [json_name = "selfLink"]; + + // Output only. [Output Only] Server-defined URL for this resource's resource + // id. + optional string self_link_with_id = 15 [json_name = "selfLinkWithId"]; + + // Output only. The current state of the Rollout. + // CANCELLED: The rollout is in a failure terminal state. + // CANCELLING: The rollout is being cancelled. + // CANCEL_FAILED: An attempted cancel operation was unsuccessful. + // COMPLETED: The rollout is in a successful terminal state. + // COMPLETE_FAILED: An attempted complete operation was unsuccessful. + // COMPLETING: The rollout is being marked as completed. + // FAILED: The rollout completed with failures. + // PAUSED: The rollout is paused. + // PAUSE_FAILED: An attempted pause operation was unsuccessful. + // PAUSING: The rollout is being paused. + // PROCESSING: A wave is being processed by the product. + // READY: The rollout has been successfully initialized and is ready to start. + // RESUMING: The rollout is being resumed after being paused. + // ROLLBACK_WAVE_FAILED: An attempted rollback operation failed to complete + // successfully. + // ROLLING_BACK: A wave rollback is in progress for this rollout. + // STATE_UNSPECIFIED: Undefined default state. Should never be exposed to + // users. + // UNINITIALIZED: The rollout has been created but is not yet ready to be + // started. + // WAVE_FAILED: The product failed to process the wave. + optional string state = 16 [json_name = "state"]; + + // Output only. Details about each wave of the rollout. + repeated RolloutWaveDetails wave_details = 17 [json_name = "waveDetails"]; } -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"]; +// Specifications of the resource to roll out. +message RolloutRolloutEntity { + // Optional. Entity details for products using the Orchestrated Integration + // model. + optional RolloutRolloutEntityOrchestratedEntity orchestrated_entity = 1 + [json_name = "orchestratedEntity"]; } -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"]; +// This message is used if the resource type follows the Orchestrated +// integration model with ProgressiveRollout. +message RolloutRolloutEntityOrchestratedEntity { + // Required. Specifies the behavior of the Rollout if an out of band update is + // detected in a project during a Rollout. It can be one of the following + // values: + // 1) overwrite : Overwrite the local value with the rollout value. + // 2) no_overwrite : Do not overwrite the local value with the rollout + // value. + optional string conflict_behavior = 1 [json_name = "conflictBehavior"]; + + // Required. Orchestration action during the Rollout. It can be one of the + // following + // values: + // 1) "update": Resources will be updated by the rollout. + // 2) "delete": Resources will be deleted by the rollout. + optional string orchestration_action = 2 [json_name = "orchestrationAction"]; + + // Required. Fully qualified resource name of the resource which contains the + // source + // of truth of the configuration being rolled out across + // locations/projects. For example, in the case of a global Rollout which + // is applied across regions, this contains the name of the global + // resource created by the user which contains a payload for a resource + // that is orchestrated across regions. This follows the following format: + // //.googleapis.com/projects//locations/global// + // e.g. + // //osconfig.googleapis.com/projects/1/locations/global/policyOrchestrators/po1 + optional string orchestration_source = 3 [json_name = "orchestrationSource"]; } -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"]; +// Additional metadata about the status of each wave provided by the server. +message RolloutWaveDetails { + // Output only. Additional details of the wave for products using the + // Orchestrated + // Integration model. + optional RolloutWaveDetailsOrchestratedWaveDetails orchestrated_wave_details = + 1 [json_name = "orchestratedWaveDetails"]; + + // Output only. Wave name. + // Ex. wave1 + optional string wave_display_name = 2 [json_name = "waveDisplayName"]; + + // Output only. System generated number for the wave. + optional string wave_number = 3 [json_name = "waveNumber"]; } -message TargetHttpsProxyAggregatedList { - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 1 [json_name = "id"]; +// Details of the wave for products using the Orchestrated integration +// model. +message RolloutWaveDetailsOrchestratedWaveDetails { + // Output only. Resource completed so far. + optional string completed_resources_count = 1 + [json_name = "completedResourcesCount"]; + + // Output only. Estimated timestamp at which the wave will complete. + // Extrapolated from + // current progress. + optional string estimated_completion_time = 2 + [json_name = "estimatedCompletionTime"]; - // A list of TargetHttpsProxiesScopedList resources. - map items = 2 [json_name = "items"]; + // Output only. Estimated total count of resources. + optional string estimated_total_resources_count = 3 + [json_name = "estimatedTotalResourcesCount"]; + + // Output only. Locations that failed during orchestration, and + // ProgressiveRollout + // stopped retrying. There may be some successful resources rolled out in + // the wave as the location may have failed later in the Rollout. + repeated string failed_locations = 4 [json_name = "failedLocations"]; + + // Output only. Resources failed. + optional string failed_resources_count = 5 + [json_name = "failedResourcesCount"]; + + // Output only. Status of each location in the wave. Map keys (locations) must + // be + // specified like "us-east1" or "asia-west1-a". + map + location_status = 6 [json_name = "locationStatus"]; +} + +// Represents the status of a location in a wave. +message RolloutWaveDetailsOrchestratedWaveDetailsLocationStatus { + // Output only. Location state of the wave. + // STATE_FAILED: Work on the wave failed. + // STATE_IN_PROGRESS: Work on the wave is in progress. + // STATE_PENDING: Work on the wave is pending. + // STATE_SKIPPED: Work on the wave was canceled or skipped. + // STATE_SUCCEEDED: Work on the wave succeeded. + // STATE_UNSPECIFIED: Undefined default state. Should never be exposed to + // users. + optional string state = 1 [json_name = "state"]; +} + +message RolloutsListResponse { + 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] Type of resource. Always - // compute#targetHttpsProxyAggregatedList for lists of Target HTTP Proxies. - optional string kind = 3 [json_name = "kind"]; + // A list of Rollout resources. + repeated Rollout items = 3 [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 + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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. + // Output only. [Output Only] Server-defined URL for this resource. optional string self_link = 5 [json_name = "selfLink"]; - // [Output Only] Unreachable resources. + // Output only. [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. + // [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. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -227,19 +319,27 @@ message TargetHttpsProxyAggregatedList { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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. diff --git a/protos/google/cloud/compute/v1/internal/common_137.proto b/protos/google/cloud/compute/v1/internal/common_137.proto index 97e4a58d5dc2d..046001b6304b9 100644 --- a/protos/google/cloud/compute/v1/internal/common_137.proto +++ b/protos/google/cloud/compute/v1/internal/common_137.proto @@ -15,271 +15,300 @@ // 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: 20250601 +// revision: 20260807 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 Google Cloud 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 = 3 [json_name = "creationTimestamp"]; +// RolloutPlan resource. +// +// A RolloutPlan is the customer-defined strategy to divide a large-scale change +// into smaller increments, referred to as "waves". Each wave targets a specific +// portion of the overall affected area and defines criteria that must be met +// before progressing to the subsequent wave. +message RolloutPlan { + // Output only. [Output Only] Creation timestamp inRFC3339 + // 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 = 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"]; - - // [Output Only] The unique identifier for the resource. This identifier is + optional string description = 2 [json_name = "description"]; + + // Output only. [Output Only] The unique identifier for the resource. This + // identifier is // defined by the server. - optional string id = 6 [json_name = "id"]; + optional string id = 3 [json_name = "id"]; - // [Output Only] Type of resource. Always compute#targetHttpsProxy for target - // HTTPS proxies. - optional string kind = 7 [json_name = "kind"]; + // Output only. [Output Only] Type of the resource. Always compute#rolloutPlan + // for rolloutPlans. + optional string kind = 4 [json_name = "kind"]; + + // The location scope of the rollout plan. If not specified, the location + // scope is considered as ZONAL. + // LOCATION_SCOPE_UNSPECIFIED: Unspecified value. Considered as ZONAL. + // REGIONAL: Regional scope. + // ZONAL: Zonal scope. + optional string location_scope = 5 [json_name = "locationScope"]; // 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. + // The name must be 1-63 characters long, and comply withRFC1035. // 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"]; - - // 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"]; - - // [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 or INTERNAL_MANAGED. - // It also applies to a regional TargetHttpsProxy attached to regional - // forwardingRules with the loadBalancingScheme set to EXTERNAL_MANAGED or - // INTERNAL_MANAGED. For details which ServerTlsPolicy resources are accepted - // with INTERNAL_SELF_MANAGED and which with EXTERNAL, INTERNAL_MANAGED, - // 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 - // namespace. Using Certificate Manager Certificates in this field is 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 or up to 100 Certificate Manager - // 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. - // UNRESTRICTED: This enables TLS 1.3 Early Data for requests with any HTTP - // method including non-idempotent methods list POST. This mode does not - // enforce any other limitations. This may be valuable for gRPC use cases. - // However, we do not recommend this method unless you have evaluated your - // security stance and mitigated the risk of replay attacks using other - // mechanisms. - 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"]; + // 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. [Output Only] Server-defined fully-qualified URL for this + // resource. + optional string self_link = 7 [json_name = "selfLink"]; + + // Output only. [Output Only] Server-defined URL for this resource's resource + // id. + optional string self_link_with_id = 8 [json_name = "selfLinkWithId"]; + + // Required. The waves included in this rollout plan. + repeated RolloutPlanWave waves = 9 [json_name = "waves"]; } -// 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 single wave in a rollout plan. +message RolloutPlanWave { + // Optional. The display name of this wave of the rollout plan. + optional string display_name = 1 [json_name = "displayName"]; - // A list of TargetHttpsProxy resources. - repeated TargetHttpsProxy items = 2 [json_name = "items"]; + // Output only. The wave number. + optional string number = 2 [json_name = "number"]; - // Type of resource. Always compute#targetHttpsProxyList for lists of target - // HTTPS proxies. - optional string kind = 3 [json_name = "kind"]; + // Optional. The orchestration options for this wave. + optional RolloutPlanWaveOrchestrationOptions orchestration_options = 3 + [json_name = "orchestrationOptions"]; + + // Required. The selectors for this wave. There is a logical AND between each + // selector + // defined in a wave, so a resource must satisfy the criteria of *all* the + // specified selectors to be in scope for the wave. + repeated RolloutPlanWaveSelector selectors = 4 [json_name = "selectors"]; + + // Required. The validation to be performed at the end of this wave. + optional RolloutPlanWaveValidation validation = 5 [json_name = "validation"]; +} + +// Options to control the pace of orchestration of a wave. These options are +// required only if the resource being rolled out follows the Orchestrated +// pattern. +message RolloutPlanWaveOrchestrationOptions { + // Optional. Delays, if any, to be added between batches of projects. We allow + // multiple Delays to be specified, letting users set separate delays + // between batches of projects corresponding to different locations and + // batches of projects corresponding to the same location. + repeated RolloutPlanWaveOrchestrationOptionsDelay delays = 1 + [json_name = "delays"]; + + // Optional. Maximum number of locations to be orchestrated in parallel. + optional string max_concurrent_locations = 2 + [json_name = "maxConcurrentLocations"]; + + // Optional. Maximum number of resources to be orchestrated per location in + // parallel. + optional string max_concurrent_resources_per_location = 3 + [json_name = "maxConcurrentResourcesPerLocation"]; +} + +// Options to control the delay, if any, between batches of projects. +message RolloutPlanWaveOrchestrationOptionsDelay { + // Optional. Controls whether the delay should only be added between batches + // of + // projects corresponding to different locations, or also between + // batches of projects corresponding to the same location. + // + // Must be set to DELIMITER_UNSPECIFIED if no delay is to be added. + // DELIMITER_BATCH: The delay will also be added between batches of projects + // corresponding to the same location. + // DELIMITER_LOCATION: The delay will only be added between batches of + // projects + // corresponding to different locations. + // DELIMITER_UNSPECIFIED: No delay will be added between batches of projects. + // Processing will + // continue with the next batch as soon as the previous batch of LROs + // is done. + optional string delimiter = 1 [json_name = "delimiter"]; + + // Optional. The duration of the delay, if any, to be added between batches of + // projects. A zero duration corresponds to no delay. + optional string duration = 2 [json_name = "duration"]; + + // Optional. Controls whether the specified duration is to be added at the end + // of + // each batch, or if the total processing time for each batch will be + // padded if needed to meet the specified duration. + // + // Must be set to TYPE_UNSPECIFIED if no delay is to be added. + // TYPE_MINIMUM: The total processing time for each batch of projects will be + // padded + // if needed to meet the specified delay duration. + // TYPE_OFFSET: The specified delay will directly be added after each batch of + // projects as specified by the delimiter. + // TYPE_UNSPECIFIED: No delay will be added between batches of projects. + // Processing will + // continue with the next batch as soon as the previous batch of LROs + // is done. + optional string type = 3 [json_name = "type"]; +} + +// A selector which specifies what resource(s) are included in a given wave. +message RolloutPlanWaveSelector { + // Optional. Roll out to resources by Cloud locations. + optional RolloutPlanWaveSelectorLocationSelector location_selector = 1 + [json_name = "locationSelector"]; + + // Optional. Roll out to resources by Cloud Resource Manager resource + // hierarchy. + optional RolloutPlanWaveSelectorResourceHierarchySelector + resource_hierarchy_selector = 2 [json_name = "resourceHierarchySelector"]; +} + +// Roll out to resources by location. +message RolloutPlanWaveSelectorLocationSelector { + // Optional. Example: "us-central1-a" + repeated string included_locations = 1 [json_name = "includedLocations"]; +} + +// Roll out to resources by Cloud Resource Manager resource hierarchy +// nodes such as projects, folders, orgs. +message RolloutPlanWaveSelectorResourceHierarchySelector { + // Optional. Format: "folders/{folder_id}" + repeated string included_folders = 1 [json_name = "includedFolders"]; + + // Optional. Format: "organizations/{organization_id}" + repeated string included_organizations = 2 + [json_name = "includedOrganizations"]; + + // Optional. Format: "projects/{project_id}" + repeated string included_projects = 3 [json_name = "includedProjects"]; +} + +// The validation to be performed before progressing to the next wave. +message RolloutPlanWaveValidation { + // Optional. Metadata required if type = "time". + optional RolloutPlanWaveValidationTimeBasedValidationMetadata + time_based_validation_metadata = 1 + [json_name = "timeBasedValidationMetadata"]; + + // Required. The type of the validation. If a type of validation is associated + // with + // a metadata object, the appropriate metadata field mapping to the + // validation type must be provided in the validation message. Possible + // values are in quotes below alongside an explanation: + // "manual": The system waits for an end-user approval API before + // progressing to the next wave. + // "time": The system waits for a user specified duration before + // progressing to the next wave. TimeBasedValidation must be provided. + optional string type = 2 [json_name = "type"]; +} + +// Metadata required if type = "time". +message RolloutPlanWaveValidationTimeBasedValidationMetadata { + // Optional. The duration that the system waits in between waves. This wait + // starts + // after all changes in the wave are rolled out. + optional string wait_duration = 1 [json_name = "waitDuration"]; +} + +// Contains a list of RolloutPlan resources. +message RolloutPlansListResponse { + 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 RolloutPlan resources. + repeated RolloutPlan items = 3 [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 + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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. + // Output only. [Output Only] Server-defined URL for this resource. optional string self_link = 5 [json_name = "selfLink"]; + // Output only. [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. + // [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. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -288,19 +317,27 @@ message TargetHttpsProxyList { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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. @@ -308,5 +345,5 @@ message TargetHttpsProxyList { } // [Output Only] Informational warning message. - optional Warning warning = 6 [json_name = "warning"]; + optional Warning warning = 7 [json_name = "warning"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_138.proto b/protos/google/cloud/compute/v1/internal/common_138.proto index 27b559c823c5f..5d2085b6bdf41 100644 --- a/protos/google/cloud/compute/v1/internal/common_138.proto +++ b/protos/google/cloud/compute/v1/internal/common_138.proto @@ -15,153 +15,264 @@ // 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: 20250601 +// revision: 20260807 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 +// 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 theRoutes overview. +message Route { + // Output only. [Output Only] AS path. + repeated RouteAsPath as_paths = 1 [json_name = "asPaths"]; + + // Output only. [Output Only] Creation timestamp inRFC3339 + // text format. + optional string creation_timestamp = 2 [json_name = "creationTimestamp"]; + + // An optional description of this resource. Provide this field when you // create the resource. - optional string description = 2 [json_name = "description"]; + 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 = 3 [json_name = "id"]; + // 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"]; - // 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. [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#targetInstance for - // target instances. - optional string kind = 5 [json_name = "kind"]; + // Output only. [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. + // The name must be 1-63 characters long, and comply withRFC1035. // 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"]; -} + // 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"]; -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"]; + // Fully-qualified URL of the network that this route applies to. + optional string network = 8 [json_name = "network"]; - 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. + // 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. [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 typeloadBalancingScheme=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"]; + + // Output only. [Output only] Internal fixed region-to-region cost that Google + // Cloud + // calculates based on factors such as network performance, distance, and + // available bandwidth between regions. + optional uint32 next_hop_inter_region_cost = 23 + [json_name = "nextHopInterRegionCost"]; + + // Output only. [Output Only] The URL to an InterconnectAttachment which is + // the next hop + // for the route. + // This field will only be populated for dynamic routes generated by + // Cloud Router with a linked interconnectAttachment or the static route + // generated by each L2 Interconnect Attachment. + optional string next_hop_interconnect_attachment = 27 + [json_name = "nextHopInterconnectAttachment"]; + + // 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"]; + + // Output only. [Output Only] Multi-Exit Discriminator, a BGP route metric + // that indicates + // the desirability of a particular route in a network. + optional uint32 next_hop_med = 24 [json_name = "nextHopMed"]; + + // The URL of the local network if it should handle matching packets. + optional string next_hop_network = 13 [json_name = "nextHopNetwork"]; + + // Output only. [Output Only] Indicates the origin of the route. Can be IGP + // (Interior Gateway Protocol), EGP (Exterior Gateway Protocol), + // or INCOMPLETE. + // EGP: + // IGP: + // INCOMPLETE: + optional string next_hop_origin = 25 [json_name = "nextHopOrigin"]; + + // Output only. [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"]; + + // Input only. [Input Only] Additional params passed with the request, but not + // persisted + // as part of resource payload. + optional RouteParams params = 26 [json_name = "params"]; + + // 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. This status applies to + // dynamic routes learned by Cloud Routers. It is also applicable to routes + // undergoing migration. + // 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. [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 - // a failed operation. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -170,225 +281,76 @@ message TargetInstanceAggregatedList { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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. [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"]; } -// 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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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 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"]; } -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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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"]; +// Additional route parameters. +message RouteParams { + // Tag keys/values directly bound to this resource. + // Tag keys and values have the same definition as resource + // manager tags. The field is allowed for INSERT + // only. The keys/values to set on the resource should be specified in + // either ID { : } or Namespaced format + // { : }. + // For example the following are valid inputs: + // * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} + // * {"123/environment" : "production", "345/abc" : "xyz"} + // Note: + // * Invalid combinations of ID & namespaced format is not supported. For + // instance: {"123/environment" : "tagValues/444"} is invalid. + map resource_manager_tags = 1 + [json_name = "resourceManagerTags"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_139.proto b/protos/google/cloud/compute/v1/internal/common_139.proto index 9056b6cac9a9e..cc431efeb513b 100644 --- a/protos/google/cloud/compute/v1/internal/common_139.proto +++ b/protos/google/cloud/compute/v1/internal/common_139.proto @@ -15,325 +15,104 @@ // 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: 20250601 +// revision: 20260807 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"; +import "google/cloud/compute/v1/internal/common_138.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 = 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"]; - - // 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"]; - - // [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. - // 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 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 = 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"]; -} - -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"]; - - // [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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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 { +// 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 TargetPool resources. - repeated TargetPool items = 2 [json_name = "items"]; + // A list of Route resources. + repeated Route items = 2 [json_name = "items"]; - // [Output Only] Type of resource. Always compute#targetPoolList for lists of - // target pools. + // Output only. 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 + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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. + // Output only. [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. + // [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. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -342,19 +121,27 @@ message TargetPoolList { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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. @@ -364,125 +151,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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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_140.proto b/protos/google/cloud/compute/v1/internal/common_140.proto index 2719e51b3342f..9f4904e8d777f 100644 --- a/protos/google/cloud/compute/v1/internal/common_140.proto +++ b/protos/google/cloud/compute/v1/internal/common_140.proto @@ -15,12 +15,258 @@ // 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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -message TargetReference { - optional string target = 1 [json_name = "target"]; +import "google/cloud/compute/v1/internal/common_141.proto"; + +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"]; + + // A list of SecurityPoliciesScopedList resources. + map items = 3 [json_name = "items"]; + + // Output only. [Output Only] Type of resource. + // Alwayscompute#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 thanmaxResults, use the + // nextPageToken as a value 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. [Output Only] Server-defined URL for this resource. + optional string self_link = 6 [json_name = "selfLink"]; + + // Output only. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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 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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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_141.proto b/protos/google/cloud/compute/v1/internal/common_141.proto index 628e15634482c..8a4314df6b925 100644 --- a/protos/google/cloud/compute/v1/internal/common_141.proto +++ b/protos/google/cloud/compute/v1/internal/common_141.proto @@ -15,176 +15,439 @@ // 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: 20250601 +// revision: 20260807 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"]; -} +import "google/cloud/compute/v1/internal/common_040.proto"; -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"]; -} +// 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"]; -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"]; -} + optional SecurityPolicyAdvancedOptionsConfig advanced_options_config = 2 + [json_name = "advancedOptionsConfig"]; -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"]; -} + // A list of associations that belong to this policy. + repeated SecurityPolicyAssociation associations = 18 + [json_name = "associations"]; -// 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. [Output Only] Creation timestamp inRFC3339 + // text format. + optional string creation_timestamp = 3 [json_name = "creationTimestamp"]; - // [Output Only] Creation timestamp in RFC3339 text format. - optional string creation_timestamp = 2 [json_name = "creationTimestamp"]; + optional SecurityPolicyDdosProtectionConfig ddos_protection_config = 4 + [json_name = "ddosProtectionConfig"]; // 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] The unique identifier for the resource. This identifier is + // 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 error412 conditionNotMet. + // + // To see the latest fingerprint, make get() request to the + // security policy. + optional string fingerprint = 6 [json_name = "fingerprint"]; + + // Output only. [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 = 7 [json_name = "id"]; + + // Output only. [Output only] Type of the resource. + // Alwayscompute#securityPolicyfor security policies + 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"]; + // 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 + // thesetLabels method. Each label key/value pair must comply withRFC1035. + // 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. + // The name must be 1-63 characters long, and comply withRFC1035. // 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"]; - - // 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 = 8 [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"]; -} - -// Contains a list of TargetSslProxy resources. -message TargetSslProxyList { + // 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. [Output Only] The parent of the security policy. + optional string parent = 19 [json_name = "parent"]; + + optional SecurityPolicyRecaptchaOptionsConfig recaptcha_options_config = 10 + [json_name = "recaptchaOptionsConfig"]; + + // Output only. [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. [Output Only] Server-defined URL for the resource. + optional string self_link = 13 [json_name = "selfLink"]; + + // User-provided name of the organization security policy. The name should be + // unique in the organization in which the security policy is created. This + // should only be used when SecurityPolicyType is CLOUD_ARMOR. + // The name must be 1-63 characters long, and comply with + // https://www.ietf.org/rfc/rfc1035.txt. 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 = 20 [json_name = "shortName"]; + + // 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 (preview only): 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 withRFC1035. + // 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"]; + + // The maximum request size chosen by the customer with Waf enabled. + // Values supported are "8KB", "16KB, "32KB", "48KB" and "64KB". + // Values are case insensitive. + optional string request_body_inspection_size = 5 + [json_name = "requestBodyInspectionSize"]; + + // 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 SecurityPolicyAssociation { + // The resource that the security policy is attached to. + optional string attachment_id = 1 [json_name = "attachmentId"]; + + // Output only. [Output Only] The display name of the security policy of the + // association. + optional string display_name = 2 [json_name = "displayName"]; + + // A list of folders to exclude from the security policy. + repeated string excluded_folders = 3 [json_name = "excludedFolders"]; + + // A list of projects to exclude from the security policy. + repeated string excluded_projects = 4 [json_name = "excludedProjects"]; + + // The name for an association. + optional string name = 5 [json_name = "name"]; + + // Output only. [Output Only] The security policy ID of the association. + optional string security_policy_id = 6 [json_name = "securityPolicyId"]; + + // Output only. [Output Only] The short name of the security policy of the + // association. + optional string short_name = 7 [json_name = "shortName"]; +} + +message SecurityPolicyDdosProtectionConfig { + // DDOS_ADAPTIVE_PROTECTION_UNSPECIFIED: + // DISABLED: + // ENABLED: + // PREVIEW: + // UNSPECIFIED_ADAPTIVE_PROTECTION: + optional string ddos_adaptive_protection = 2 + [json_name = "ddosAdaptiveProtection"]; + + // DDoS Protection for Network Load Balancers (and VMs with public IPs) + // builds DDoS mitigations that minimize collateral damage. It quantifies + // this as the fraction of a non-abuse baseline that's inadvertently + // blocked. + // + // Rules whose collateral damage exceeds ddosImpactedBaselineThreshold will + // not be deployed. Using a lower value will prioritize keeping collateral + // damage low, possibly at the cost of its effectiveness in rate limiting + // some or all of the attack. It should typically be unset, so Advanced DDoS + // (and Adaptive Protection) uses the best mitigation it can find. Setting + // the threshold is advised if there are logs for false positive detections + // with high collateral damage, and will cause Advanced DDoS to attempt to + // find a less aggressive rule that satisfies the constraint. If a suitable + // rule cannot be found, the system falls back to either no mitigation for + // smaller attacks or broader network throttles for larger ones. + optional float ddos_impacted_baseline_threshold = 3 + [json_name = "ddosImpactedBaselineThreshold"]; + + // ADVANCED: + // ADVANCED_PREVIEW: + // 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 TargetSslProxy resources. - repeated TargetSslProxy items = 2 [json_name = "items"]; + // A list of SecurityPolicy resources. + repeated SecurityPolicy items = 2 [json_name = "items"]; - // Type of resource. + // Output only. [Output Only] Type of resource. + // Alwayscompute#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 + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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. + // [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. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -193,19 +456,27 @@ message TargetSslProxyList { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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. @@ -213,5 +484,556 @@ message TargetSslProxyList { } // [Output Only] Informational warning message. - optional Warning warning = 6 [json_name = "warning"]; + 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. + // - fairshare (preview only): when traffic reaches the + // threshold limit, requests from the clients matching this rule begin to + // be + // rate-limited using the Fair Share algorithm. This action is only allowed + // in security policies of type `CLOUD_ARMOR_INTERNAL_SERVICE`. + 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. [Output only] Type of the resource. + // Alwayscompute#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" or + // "fairshare". 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 a Cloud + // Armor Enterprise subscription and are not supported in Edge Policies + // nor in Regional Policies. Expressions containing + // `evaluatePreconfiguredExpr('sourceiplist-*')` require a Cloud Armor + // Enterprise subscription 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 toALL. + // - 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 toALL. + // - 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 toIP. + // - ASN: The autonomous system number of the originating + // client. If not available, the key type defaults toALL. + // - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the + // client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the + // key type defaults to ALL. + // + // + // For "fairshare" action, this value is limited to ALL i.e. a single rate + // limit threshold is enforced for all the requests matching the rule. + // ALL: + // ASN: + // HTTP_COOKIE: + // HTTP_HEADER: + // HTTP_PATH: + // IP: + // REGION_CODE: + // SNI: + // TLS_JA3_FINGERPRINT: + // TLS_JA4_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 toALL. + // - 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 toALL. + // - 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 toIP. + // - ASN: The autonomous system number of the originating + // client. If not available, the key type defaults toALL. + // - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the + // client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the + // key type defaults to ALL. + // ALL: + // ASN: + // HTTP_COOKIE: + // HTTP_HEADER: + // HTTP_PATH: + // IP: + // REGION_CODE: + // SNI: + // TLS_JA3_FINGERPRINT: + // TLS_JA4_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. Possible values are: + // + // - GOOGLE_RECAPTCHA: redirect to reCAPTCHA for manual + // challenge assessment. + // - EXTERNAL_302: redirect to a different URL via a 302 + // response. + // 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_142.proto b/protos/google/cloud/compute/v1/internal/common_142.proto index b8861714cbaa6..5dfc4c6cd0a13 100644 --- a/protos/google/cloud/compute/v1/internal/common_142.proto +++ b/protos/google/cloud/compute/v1/internal/common_142.proto @@ -15,227 +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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_143.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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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 SecurityPolicyReference { + optional string security_policy = 1 [json_name = "securityPolicy"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_143.proto b/protos/google/cloud/compute/v1/internal/common_143.proto index 483eddd431955..32bc73d013e92 100644 --- a/protos/google/cloud/compute/v1/internal/common_143.proto +++ b/protos/google/cloud/compute/v1/internal/common_143.proto @@ -15,83 +15,370 @@ // 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: 20250601 +// revision: 20260807 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"]; +import "google/cloud/compute/v1/internal/common_172.proto"; + +// 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. [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 or only + // endpoints. + 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. [Output Only] Creation timestamp inRFC3339 + // 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 = 2 [json_name = "description"]; + optional string description = 6 [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"]; + // 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"]; - // [Output Only] Type of the resource. Always compute#targetTcpProxy for - // target TCP proxies. - optional string kind = 4 [json_name = "kind"]; + // 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. [Output Only] The unique identifier for the resource type. The + // server + // generates this identifier. + optional string id = 10 [json_name = "id"]; + + // Output only. [Output Only] Type of the resource. + // Alwayscompute#serviceAttachment for service attachments. + optional string kind = 11 [json_name = "kind"]; + + // Metadata of the service attachment. + map metadata = 21 [json_name = "metadata"]; // 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. + // The name must be 1-63 characters long, and comply withRFC1035. // 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"]; + // 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"]; + + // The number of NAT IP addresses to be allocated per connected endpoint. + // If not specified, the default value is 1. + optional uint32 nat_ips_per_endpoint = 22 [json_name = "natIpsPerEndpoint"]; + + // 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. [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. [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. [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 TargetTcpProxy resources. -message TargetTcpProxyList { +// 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 TargetTcpProxy resources. - repeated TargetTcpProxy items = 2 [json_name = "items"]; + // A list of ServiceAttachmentsScopedList resources. + map items = 2 [json_name = "items"]; - // Type of resource. + // Output only. 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 + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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. [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + // Output only. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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 url of a connected endpoint with resource id. + optional string endpoint_with_id = 6 [json_name = "endpointWithId"]; + + // NAT IPs of the connected PSC endpoint and those of other endpoints + // propagated from it. + repeated string nat_ips = 7 [json_name = "natIps"]; + + // 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 ServiceAttachmentConsumerProjectLimit { + // The value of the limit to set. For endpoint_url, the limit should be no + // more than 1. + optional uint32 connection_limit = 1 [json_name = "connectionLimit"]; + + // The URL for the PSC endpoint to accept + optional string endpoint_url = 4 [json_name = "endpointUrl"]; + + // 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. [Output Only] Type of the resource. + // Alwayscompute#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 thanmaxResults, use the + // nextPageToken as a value 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"]; @@ -99,61 +386,73 @@ message TargetTcpProxyList { 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. + // [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. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -162,19 +461,27 @@ message TargetTcpProxyList { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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. @@ -184,3 +491,116 @@ message TargetTcpProxyList { // [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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"]; +} diff --git a/protos/google/cloud/compute/v1/internal/common_144.proto b/protos/google/cloud/compute/v1/internal/common_144.proto index f92cff8ffef5f..bbf2e56d49fca 100644 --- a/protos/google/cloud/compute/v1/internal/common_144.proto +++ b/protos/google/cloud/compute/v1/internal/common_144.proto @@ -15,394 +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: 20250601 +// revision: 20260807 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"]; +// 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"]; } -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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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"]; +// 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_145.proto b/protos/google/cloud/compute/v1/internal/common_145.proto index c31c22fecaa69..187514bfba4b4 100644 --- a/protos/google/cloud/compute/v1/internal/common_145.proto +++ b/protos/google/cloud/compute/v1/internal/common_145.proto @@ -15,20 +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: 20250601 +// revision: 20260807 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"]; -} +// 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 + // withRFC1035. + // 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"]; -message TestPermissionsResponse { - // A subset of `TestPermissionsRequest.permissions` that the caller is - // allowed. - repeated string permissions = 1 [json_name = "permissions"]; + // 128-bit key value used for signing the URL. The key value must be a + // validRFC + // 4648 Section 5 base64url encoded string. + optional string key_value = 2 [json_name = "keyValue"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_146.proto b/protos/google/cloud/compute/v1/internal/common_146.proto index 3ea339907d256..1c8d23cedc8cc 100644 --- a/protos/google/cloud/compute/v1/internal/common_146.proto +++ b/protos/google/cloud/compute/v1/internal/common_146.proto @@ -15,40 +15,276 @@ // 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: 20250601 +// revision: 20260807 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"]; +import "google/cloud/compute/v1/internal/common_028.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. [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. [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. [Output Only] Size in bytes of the snapshot at creation time. + optional string creation_size_bytes = 4 [json_name = "creationSizeBytes"]; + + // Output only. [Output Only] Creation timestamp inRFC3339 + // 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. [Output Only] Size of the source disk, specified in GB. + optional string disk_size_gb = 7 [json_name = "diskSizeGb"]; + + // Output only. [Output Only] Number of bytes downloaded to restore a snapshot + // to a disk. + optional string download_bytes = 8 [json_name = "downloadBytes"]; + + // Output only. 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"]; + + // [Input Only] Whether to attempt an application consistent snapshot by + // informing the OS to prepare for the snapshot process. + optional bool guest_flush = 37 [json_name = "guestFlush"]; + + // Output only. [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. [Output Only] The unique identifier for the resource. This + // identifier is + // defined by the server. + optional string id = 9 [json_name = "id"]; + + // Output only. [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 error412 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. [Output Only] Integer license codes indicating which licenses + // are attached + // to this snapshot. + repeated string license_codes = 13 [json_name = "licenseCodes"]; + + // Output only. [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 withRFC1035. + // 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"]; + + // Input only. [Input Only] Additional params passed with the request, but not + // persisted + // as part of resource payload. + optional SnapshotParams params = 38 [json_name = "params"]; + + // Output only. [Output Only] URL of the region where the snapshot resides. + // Only applicable + // for regional snapshots. + optional string region = 39 [json_name = "region"]; + + // Output only. Reserved for future use. + optional bool satisfies_pzi = 33 [json_name = "satisfiesPzi"]; + + // Output only. [Output Only] Reserved for future use. + optional bool satisfies_pzs = 17 [json_name = "satisfiesPzs"]; + + // Output only. [Output Only] Server-defined URL for the resource. + optional string self_link = 18 [json_name = "selfLink"]; + + // Encrypts the snapshot using acustomer-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"]; + + // Output only. [Output Only] The unique ID of the snapshot group that this + // snapshot + // belongs to. The usage of snapshot group feature is restricted. + optional string snapshot_group_id = 40 [json_name = "snapshotGroupId"]; + + // Output only. [Output only] The snapshot group that this snapshot belongs + // to. The usage + // of snapshot group feature is restricted. + optional string snapshot_group_name = 41 [json_name = "snapshotGroupName"]; + + // 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. [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. [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 snapshot. For example, if you created the snapshot 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. [Output Only] URL of the resource policy which created this + // scheduled snapshot. + optional string source_snapshot_schedule_policy = 24 + [json_name = "sourceSnapshotSchedulePolicy"]; + + // Output only. [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. [Output Only] The status of the snapshot. This can beCREATING, + // 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. [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. [Deprecated] Instead, check the storageBytes field. After + // snapshot creation, the storageBytesStatus field is alwaysUP_TO_DATE. + // [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 unset, meaning the snapshot is + // being created, 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"]; + + // Cloud Storage bucket storage location of the snapshot (regional or + // multi-regional). + repeated string storage_locations = 29 [json_name = "storageLocations"]; +} + +// Additional snapshot params. +message SnapshotParams { + // Input only. Resource manager tags to be bound to the snapshot. Tag keys and + // values have + // the same definition as resource + // manager tags. Keys and values can be either in numeric format, + // such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in + // namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and + // `{tag_value_short_name}`. The field is ignored (both PUT & + // PATCH) when empty. + map resource_manager_tags = 1 + [json_name = "resourceManagerTags"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_147.proto b/protos/google/cloud/compute/v1/internal/common_147.proto index a68f0df981612..5ccf6deb22c68 100644 --- a/protos/google/cloud/compute/v1/internal/common_147.proto +++ b/protos/google/cloud/compute/v1/internal/common_147.proto @@ -15,12 +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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -message UrlMapReference { - optional string url_map = 1 [json_name = "urlMap"]; +import "google/cloud/compute/v1/internal/common_146.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"]; + + // Output only. 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 thanmaxResults, use the + // nextPageToken as a value 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. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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_148.proto b/protos/google/cloud/compute/v1/internal/common_148.proto index 53df1bbf830f0..3be11f5e87d22 100644 --- a/protos/google/cloud/compute/v1/internal/common_148.proto +++ b/protos/google/cloud/compute/v1/internal/common_148.proto @@ -15,492 +15,70 @@ // 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: 20250601 +// revision: 20260807 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 { - // [Output Only] Creation timestamp in RFC3339 text format. - optional string creation_timestamp = 1 [json_name = "creationTimestamp"]; +message SnapshotSettings { + // (Regional snapshots use only)Policy of which location is allowed to access + // snapshot. + optional SnapshotSettingsAccessLocation access_location = 2 + [json_name = "accessLocation"]; - // 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"]; + // 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"]; } -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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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 SnapshotSettingsAccessLocation { + // List of regions that can restore a regional + // snapshot from the current region + map + locations = 1 [json_name = "locations"]; + + // Policy of which location is allowed to access snapshot. + // ALL_REGIONS: Any regions will be able to access the source location. + // POLICY_UNSPECIFIED: + // SPECIFIC_REGIONS: Only allowlisted regions will be able to restore region + // scoped + // snapshots + optional string policy = 2 [json_name = "policy"]; } -// 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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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"]; +// A structure for specifying an allowed target region. +message SnapshotSettingsAccessLocationAccessLocationPreference { + // Accessible region name + optional string region = 1 [json_name = "region"]; } -message VpnGatewaysGetStatusResponse { - optional VpnGatewayStatus result = 1 [json_name = "result"]; +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"]; } -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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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"]; +// 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_149.proto b/protos/google/cloud/compute/v1/internal/common_149.proto index b402e427e3144..b27485db42400 100644 --- a/protos/google/cloud/compute/v1/internal/common_149.proto +++ b/protos/google/cloud/compute/v1/internal/common_149.proto @@ -15,474 +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: 20250601 +// revision: 20260807 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"]; - - // 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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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 - // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). - // 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 SnapshotUpdateKmsKeyRequest { + // Optional. The new KMS key to replace the current one on the snapshot. If + // empty, the + // snapshot will be re-encrypted using the primary version of the snapshot's + // current KMS key. + // + // The KMS key can be provided in the following formats: + // + // + // - + // projects/project_id/locations/region/keyRings/key_ring/cryptoKeys/key + optional string kms_key_name = 1 [json_name = "kmsKeyName"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_150.proto b/protos/google/cloud/compute/v1/internal/common_150.proto index 24faaa8bd1810..69961dc9dba07 100644 --- a/protos/google/cloud/compute/v1/internal/common_150.proto +++ b/protos/google/cloud/compute/v1/internal/common_150.proto @@ -15,133 +15,207 @@ // 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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_023.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"]; +// Represents an SSL certificate resource. +// +// Google Compute Engine has two SSL certificate resources: +// +// * +// [Global](https://cloud.google.com/compute/docs/reference/rest/v1/sslCertificates) +// * +// [Regional](https://cloud.google.com/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. + // [Output Only] Creation timestamp inRFC3339 + // text format. optional string creation_timestamp = 2 [json_name = "creationTimestamp"]; - // [Output Only] The deprecation status associated with this zone. - optional DeprecationStatus deprecated = 3 [json_name = "deprecated"]; + // An optional description of this resource. Provide this property when you + // create the resource. + optional string description = 3 [json_name = "description"]; - // [Output Only] Textual description of the resource. - optional string description = 4 [json_name = "description"]; + // Output only. [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#zone for zones. + // Output only. [Output Only] Type of the resource. + // Alwayscompute#sslCertificate for SSL certificates. optional string kind = 6 [json_name = "kind"]; - // [Output Only] Name of the resource. - optional string name = 7 [json_name = "name"]; + // 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 withRFC1035. + // 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] Full URL reference to the region which hosts the zone. - optional string region = 8 [json_name = "region"]; + // Output only. [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 = 9 [json_name = "selfLink"]; + // [Output only] Server-defined URL for the resource. + optional string self_link = 11 [json_name = "selfLink"]; - // [Output Only] Status of the zone, either UP or DOWN. - // DOWN: - // UP: - optional string status = 10 [json_name = "status"]; + // Configuration and status of a self-managed SSL certificate. + optional SslCertificateSelfManagedSslCertificate self_managed = 12 + [json_name = "selfManaged"]; - // [Output Only] Reserved for future use. - optional bool supports_pzs = 11 [json_name = "supportsPzs"]; + // Output only. [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 + // fieldscertificate 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 zone resources. -message ZoneList { +// 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 Zone resources. - repeated Zone items = 2 [json_name = "items"]; + // A list of SslCertificate resources. + repeated SslCertificate items = 2 [json_name = "items"]; - // Type of resource. + // Output only. 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 + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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. + // Output only. [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. + // [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. + // 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 + // 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 + // 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. + // 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. + // 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. + // 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. + // 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. + // 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. + // 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 // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client - // requests (e.g: regions.list). + // requests (e.g: + // regions.list). // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. + // 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. + // 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. + // group 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. @@ -150,19 +224,27 @@ message ZoneList { 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). + // list + // request for a particular zone, this key might be scope and + // the key value might be the zone name. Other examples might be a key + // indicating a deprecated resource and a suggested replacement, 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" } + // [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. @@ -172,3 +254,53 @@ message ZoneList { // [Output Only] Informational warning message. optional Warning warning = 6 [json_name = "warning"]; } + +// Configuration and status of a managed SSL certificate. +message SslCertificateManagedSslCertificate { + // Output only. [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](https://cloud.google.com/load-balancing/docs/quotas#ssl_certificates). + repeated string domains = 2 [json_name = "domains"]; + + // Output only. [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_151.proto b/protos/google/cloud/compute/v1/internal/common_151.proto index a6e12d8b83769..84d38fbceeb12 100644 --- a/protos/google/cloud/compute/v1/internal/common_151.proto +++ b/protos/google/cloud/compute/v1/internal/common_151.proto @@ -15,20 +15,255 @@ // 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: 20250601 +// revision: 20260807 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"]; +import "google/cloud/compute/v1/internal/common_150.proto"; - // The labels to set for this resource. - map labels = 2 [json_name = "labels"]; +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. [Output Only] Type of resource. + // Alwayscompute#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 thanmaxResults, use the + // nextPageToken as a value 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. [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + // Output only. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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 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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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_152.proto b/protos/google/cloud/compute/v1/internal/common_152.proto index 0e511ac9f6256..003bf0246ee8f 100644 --- a/protos/google/cloud/compute/v1/internal/common_152.proto +++ b/protos/google/cloud/compute/v1/internal/common_152.proto @@ -15,25 +15,256 @@ // 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: 20250601 +// revision: 20260807 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_007.proto"; +import "google/cloud/compute/v1/internal/common_153.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"]; +message SslPoliciesAggregatedList { + optional string etag = 1 [json_name = "etag"]; - // 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] Unique identifier for the resource; defined by the server. + optional string id = 2 [json_name = "id"]; - // 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 SslPoliciesScopedList resources. + map items = 3 [json_name = "items"]; + + // Output only. [Output Only] Type of resource. + // Alwayscompute#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 thanmaxResults, use the + // nextPageToken as a value 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. [Output Only] Server-defined URL for this resource. + optional string self_link = 6 [json_name = "selfLink"]; + + // Output only. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_153.proto b/protos/google/cloud/compute/v1/internal/common_153.proto new file mode 100644 index 0000000000000..66f7df30723d9 --- /dev/null +++ b/protos/google/cloud/compute/v1/internal/common_153.proto @@ -0,0 +1,374 @@ +// Copyright 2026 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: 20260807 + +syntax = "proto3"; + +package google.cloud.cpp.compute.v1; + +message SslPoliciesList { + // Output only. [Output Only] Unique identifier for the resource; defined by + // the server. + optional string id = 1 [json_name = "id"]; + + // Output only. A list of SslPolicy resources. + repeated SslPolicy items = 2 [json_name = "items"]; + + // Output only. [Output Only] Type of the resource. + // Alwayscompute#sslPoliciesList for lists of sslPolicies. + optional string kind = 3 [json_name = "kind"]; + + // Output only. [Output Only] This token allows you to get the next page of + // results for + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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 SslPoliciesListAvailableFeaturesResponse { + repeated string features = 1 [json_name = "features"]; +} + +// 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. [Output Only] Creation timestamp inRFC3339 + // 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 + // notCUSTOM. + 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. [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. [Output Only] The unique identifier for the resource. This + // identifier is + // defined by the server. + optional string id = 6 [json_name = "id"]; + + // Output only. [Output only] Type of the resource. Alwayscompute#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 ofTLS_1_0, + // TLS_1_1, TLS_1_2,TLS_1_3. When set to TLS_1_3, the profile field + // must be set to RESTRICTED. + // TLS_1_0: TLS 1.0 + // TLS_1_1: TLS 1.1 + // TLS_1_2: TLS 1.2 + // TLS_1_3: TLS 1.3 + 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"]; + + // One of DEFAULT, ENABLED, orDEFERRED. Controls whether the load balancer + // negotiates + // X25519MLKEM768 key exchange when clients advertise support for it. When set + // to DEFAULT, or if no SSL Policy is attached to the target + // proxy, the load balancer disallows X25519MLKEM768 key exchange before + // October 2026, and allows it afterward. When set to ENABLED, + // the load balancer allows X25519MLKEM768 key exchange. When set toDEFERRED, + // the load balancer disallows X25519MLKEM768 key + // exchange until October 2027, and allows it afterward. + // DEFAULT: Default behavior: disabled until October 2026, enabled afterward. + // DEFERRED: Disabled until October 2027, enabled afterward. + // ENABLED: Enabled now. + optional string post_quantum_key_exchange = 14 + [json_name = "postQuantumKeyExchange"]; + + // Profile specifies the set of SSL features that can be used by the load + // balancer when negotiating SSL with clients. This can be one ofCOMPATIBLE, + // MODERN, RESTRICTED,FIPS_202205, or CUSTOM. If usingCUSTOM, the set of SSL + // features to enable must be specified in + // the customFeatures field. If using FIPS_202205, + // the min_tls_version field must be set to TLS_1_2. + // 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. + // FIPS_202205: FIPS compatible profile. Supports a reduced set of SSL + // features, + // intended to meet FIPS 140-3 compliance requirements. + // 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. [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. [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 + // 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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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. [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_154.proto b/protos/google/cloud/compute/v1/internal/common_154.proto new file mode 100644 index 0000000000000..2bbad4d934978 --- /dev/null +++ b/protos/google/cloud/compute/v1/internal/common_154.proto @@ -0,0 +1,26 @@ +// Copyright 2026 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: 20260807 + +syntax = "proto3"; + +package google.cloud.cpp.compute.v1; + +message SslPolicyReference { + optional string ssl_policy = 1 [json_name = "sslPolicy"]; +} diff --git a/protos/google/cloud/compute/v1/internal/common_155.proto b/protos/google/cloud/compute/v1/internal/common_155.proto new file mode 100644 index 0000000000000..f1f6946b90db3 --- /dev/null +++ b/protos/google/cloud/compute/v1/internal/common_155.proto @@ -0,0 +1,815 @@ +// Copyright 2026 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: 20260807 + +syntax = "proto3"; + +package google.cloud.cpp.compute.v1; + +import "google/cloud/compute/v1/internal/common_156.proto"; + +// 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. [Output Only] Creation timestamp inRFC3339 + // 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"]; + + // Provisioned capacities for each SKU for this Exapool in GiB + optional StoragePoolExapoolProvisionedCapacityGb + exapool_provisioned_capacity_gb = 20 + [json_name = "exapoolProvisionedCapacityGb"]; + + // Output only. [Output Only] The unique identifier for the resource. This + // identifier is + // defined by the server. + optional string id = 4 [json_name = "id"]; + + // Output only. [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 error412 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 withRFC1035. + // 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"]; + + // Input only. Additional params passed with the request, but not persisted + // as part of resource payload. + optional StoragePoolParams params = 21 [json_name = "params"]; + + // 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 of the storage pool in GiB. 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 in MiB/s. Only relevant if the + // storage pool type is hyperdisk-balanced or hyperdisk-throughput. + optional string pool_provisioned_throughput = 12 + [json_name = "poolProvisionedThroughput"]; + + // Output only. [Output Only] Status information for the storage pool + // resource. + optional StoragePoolResourceStatus resource_status = 13 + [json_name = "resourceStatus"]; + + // Output only. [Output Only] Server-defined fully-qualified URL for this + // resource. + optional string self_link = 14 [json_name = "selfLink"]; + + // Output only. [Output Only] Server-defined URL for this resource's resource + // id. + optional string self_link_with_id = 15 [json_name = "selfLinkWithId"]; + + // Share settings for the storage pool. + optional StoragePoolShareSettings share_settings = 22 + [json_name = "shareSettings"]; + + // Output only. [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. [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. [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 = 2 [json_name = "id"]; + + // A list of StoragePoolsScopedList resources. + map items = 3 [json_name = "items"]; + + // Output only. [Output Only] Type of resource. + // Alwayscompute#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 thanmaxResults, use the + // nextPageToken as a value 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. [Output Only] Server-defined URL for this resource. + optional string self_link = 6 [json_name = "selfLink"]; + + // Output only. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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 StoragePoolDisk { + // Output only. [Output Only] Instances this disk is attached to. + repeated string attached_instances = 1 [json_name = "attachedInstances"]; + + // Output only. [Output Only] Creation timestamp inRFC3339 + // text format. + optional string creation_timestamp = 2 [json_name = "creationTimestamp"]; + + // Output only. [Output Only] The URL of the disk. + optional string disk = 3 [json_name = "disk"]; + + // Output only. [Output Only] The name of the disk. + optional string name = 4 [json_name = "name"]; + + // Output only. [Output Only] The number of IOPS provisioned for the disk. + optional string provisioned_iops = 5 [json_name = "provisionedIops"]; + + // Output only. [Output Only] The throughput provisioned for the disk. + optional string provisioned_throughput = 6 + [json_name = "provisionedThroughput"]; + + // Output only. [Output Only] Resource policies applied to disk for automatic + // snapshot + // creations. + repeated string resource_policies = 7 [json_name = "resourcePolicies"]; + + // Output only. [Output Only] The disk size, in GB. + optional string size_gb = 8 [json_name = "sizeGb"]; + + // Output only. [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. [Output Only] The disk type. + optional string type = 10 [json_name = "type"]; + + // Output only. [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. [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 thanmaxResults, use the + // nextPageToken as a value 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. [Output Only] Server-defined URL for this resource. + optional string self_link = 6 [json_name = "selfLink"]; + + // Output only. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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. [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. [Output Only] Type of resource. + // Alwayscompute#storagePoolListDisks for lists of disks in a + // storagePool. + optional string kind = 4 [json_name = "kind"]; + + // Output only. [Output Only] This token allows you to get the next page of + // results for + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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. [Output Only] Server-defined URL for this resource. + optional string self_link = 6 [json_name = "selfLink"]; + + // Output only. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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. [Output Only] Informational warning message. + optional Warning warning = 8 [json_name = "warning"]; +} + +// Additional storage pool params. +message StoragePoolParams { + // Input only. Resource manager tags to be bound to the storage pool. Tag keys + // and values + // have the same definition as resource + // manager tags. Keys and values can be either in numeric format, + // such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in + // namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and + // `{tag_value_short_name}`. The field is ignored (both PUT & + // PATCH) when empty. + map resource_manager_tags = 1 + [json_name = "resourceManagerTags"]; +} + +// [Output Only] Contains output only fields. +message StoragePoolResourceStatus { + // [Output Only] Number of disks used. + optional string disk_count = 1 [json_name = "diskCount"]; + + // Output only. [Output Only] Maximum allowed read IOPS for this Exapool. + optional string exapool_max_read_iops = 11 [json_name = "exapoolMaxReadIops"]; + + // Output only. [Output Only] Maximum allowed read throughput in MiB/s for + // this Exapool. + optional string exapool_max_read_throughput = 12 + [json_name = "exapoolMaxReadThroughput"]; + + // Output only. [Output Only] Maximum allowed write IOPS for this Exapool. + optional string exapool_max_write_iops = 13 + [json_name = "exapoolMaxWriteIops"]; + + // Output only. [Output Only] Maximum allowed write throughput in MiB/s + // for this Exapool. + optional string exapool_max_write_throughput = 14 + [json_name = "exapoolMaxWriteThroughput"]; + + // Output only. [Output Only] Timestamp of the last successful resize + // inRFC3339 text format. + optional string last_resize_timestamp = 2 [json_name = "lastResizeTimestamp"]; + + // [Output Only] Maximum allowed aggregate disk size in GiB. + 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 MiB/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 disks' provisioned capacity (in GiB) 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 MiB/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"]; +} + +// Share settings for the storage pool. +message StoragePoolShareSettings { + // A map of project id and project config. + map project_map = 1 + [json_name = "projectMap"]; +} + +// Config for each project in the share settings. +message StoragePoolShareSettingsProjectConfig { + // 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"]; +} + +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 + // 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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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 + // when the list is empty. + optional Warning warning = 2 [json_name = "warning"]; +} diff --git a/protos/google/cloud/compute/v1/internal/common_156.proto b/protos/google/cloud/compute/v1/internal/common_156.proto new file mode 100644 index 0000000000000..204d9cc5e099d --- /dev/null +++ b/protos/google/cloud/compute/v1/internal/common_156.proto @@ -0,0 +1,34 @@ +// Copyright 2026 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: 20260807 + +syntax = "proto3"; + +package google.cloud.cpp.compute.v1; + +// Exapool provisioned capacities for each SKU type +message StoragePoolExapoolProvisionedCapacityGb { + // Size, in GiB, of provisioned capacity-optimized capacity for this Exapool + optional string capacity_optimized = 1 [json_name = "capacityOptimized"]; + + // Size, in GiB, of provisioned read-optimized capacity for this Exapool + optional string read_optimized = 2 [json_name = "readOptimized"]; + + // Size, in GiB, of provisioned write-optimized capacity for this Exapool + optional string write_optimized = 3 [json_name = "writeOptimized"]; +} diff --git a/protos/google/cloud/compute/v1/internal/common_157.proto b/protos/google/cloud/compute/v1/internal/common_157.proto new file mode 100644 index 0000000000000..d347c7e70a0c2 --- /dev/null +++ b/protos/google/cloud/compute/v1/internal/common_157.proto @@ -0,0 +1,463 @@ +// Copyright 2026 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: 20260807 + +syntax = "proto3"; + +package google.cloud.cpp.compute.v1; + +import "google/cloud/compute/v1/internal/common_032.proto"; + +message StoragePoolType { + // [Output Only] Creation timestamp inRFC3339 + // 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. [Output Only] Type of the resource. + // Alwayscompute#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. [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. [Output Only] Type of resource. + // Alwayscompute#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 thanmaxResults, use the + // nextPageToken as a value 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. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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. [Output Only] Type of resource. + // Alwayscompute#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 thanmaxResults, use the + // nextPageToken as a value 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. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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_158.proto b/protos/google/cloud/compute/v1/internal/common_158.proto new file mode 100644 index 0000000000000..647fb7a569e26 --- /dev/null +++ b/protos/google/cloud/compute/v1/internal/common_158.proto @@ -0,0 +1,1184 @@ +// Copyright 2026 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: 20260807 + +syntax = "proto3"; + +package google.cloud.cpp.compute.v1; + +import "google/cloud/compute/v1/internal/common_172.proto"; + +// 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 { + // Whether this subnetwork's ranges can conflict with existing custom routes. + // Setting this to true allows this subnetwork's primary and secondary ranges + // to overlap with (and contain) custom routes that have already been + // configured on the corresponding network. + // + // For example if a static route has range 10.1.0.0/16, a subnet + // range 10.0.0.0/8 could only be created if allow_conflicting_routes=true. + // + // Overlapping is only allowed on subnetwork operations; routes + // whose ranges conflict with this subnetwork's ranges won't be allowed unless + // route.allow_conflicting_subnetworks is set to true. + // + // Typically packets destined to IPs within the subnetwork (which may contain + // private/sensitive data) are prevented from leaving the virtual network. + // Setting this field to true will disable this feature. + // + // The default value is false and applies to all existing subnetworks and + // automatically created subnetworks. + optional bool allow_subnet_cidr_routes_overlap = 31 + [json_name = "allowSubnetCidrRoutesOverlap"]; + + // Output only. [Output Only] Creation timestamp inRFC3339 + // text format. + optional string creation_timestamp = 1 [json_name = "creationTimestamp"]; + + // 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 toREGIONAL_MANAGED_PROXY. It + // is recommended to uselogConfig.enable field instead. + 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. [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. [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 theValid + // ranges list. The range can be expanded after creation + // usingexpandIpCidrRange. + optional string ip_cidr_range = 9 [json_name = "ipCidrRange"]; + + // Reference to the source of IP, like a PublicDelegatedPrefix + // (PDP) for BYOIP. The PDP must be a sub-PDP in + // EXTERNAL_IPV6_SUBNETWORK_CREATION or INTERNAL_IPV6_SUBNETWORK_CREATION + // mode. + // + // Use one of the following formats to specify a sub-PDP when creating a dual + // stack or IPv6-only subnetwork with external access using BYOIP: + // + // - + // Full resource URL, as + // inhttps://www.googleapis.com/compute/v1/projects/projectId/regions/region/publicDelegatedPrefixes/sub-pdp-name + // - + // Partial URL, as in + // + // + // - + // projects/projectId/regions/region/publicDelegatedPrefixes/sub-pdp-name + // - regions/region/publicDelegatedPrefixes/sub-pdp-name + optional string ip_collection = 26 [json_name = "ipCollection"]; + + // 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. [Output Only] This field is for internal use. + optional string ipv6_cidr_range = 11 [json_name = "ipv6CidrRange"]; + + // Output only. [Output Only] Possible endpoints of this subnetwork. It can be + // one of the + // following: + // + // - VM_ONLY: The subnetwork can be used for creating instances and + // IPv6 addresses with VM endpoint type. Such a subnetwork gets external + // IPv6 + // ranges from a public delegated prefix and cannot be used to create + // NetLb. + // - VM_AND_FR: The subnetwork can be used for creating both VM + // instances and Forwarding Rules. It can also be used to reserve IPv6 + // addresses with both VM and FR endpoint types. Such a subnetwork gets its + // IPv6 range from Google IP Pool directly. + // VM_AND_FR: + // VM_ONLY: + optional string ipv6_gce_endpoint = 27 [json_name = "ipv6GceEndpoint"]; + + // Output only. [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 + // withRFC1035. + // 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"]; + + // Input only. [Input Only] Additional params passed with the request, but not + // persisted + // as part of resource payload. + optional SubnetworkParams params = 30 [json_name = "params"]; + + // 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 + // usingpatch. + // 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"]; + + // 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. + // PEER_MIGRATION: Subnetwork will be used for Migration from one peered VPC + // to another. + // (a transient state of subnetwork + // while migrating resources from one project to another). + // 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"]; + + // Configures subnet mask resolution for this subnetwork. + // ARP_ALL_RANGES: All ranges assigned to the VM NIC will respond to ARP. + // ARP_PRIMARY_RANGE: Only the primary range of the VM NIC will respond to + // ARP. + optional string resolve_subnet_mask = 32 [json_name = "resolveSubnetMask"]; + + // The role of subnetwork. Currently, this field is only used when + // purpose is set to GLOBAL_MANAGED_PROXY orREGIONAL_MANAGED_PROXY. The value + // can be set toACTIVE 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 apatch request. + // Supports both IPv4 and IPv6 ranges. + 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 toIPV4_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 + // usingpatch. + // 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. [Output Only] The state of the subnetwork, which can be one of + // the + // following values:READY: Subnetwork is created and ready to useDRAINING: + // 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 ofREADY + // DRAINING: Subnetwork is being drained. + // READY: Subnetwork is ready for use. + optional string state = 24 [json_name = "state"]; + + // Output only. [Output Only] The array of external IPv6 network ranges + // reserved from + // the subnetwork's external IPv6 range for system use. + repeated string system_reserved_external_ipv6_ranges = 28 + [json_name = "systemReservedExternalIpv6Ranges"]; + + // Output only. [Output Only] The array of internal IPv6 network ranges + // reserved from + // the subnetwork's internal IPv6 range for system use. + repeated string system_reserved_internal_ipv6_ranges = 29 + [json_name = "systemReservedInternalIpv6Ranges"]; + + // Output only. [Output Only] The current IP utilization of all subnetwork + // ranges. Contains + // the total number of allocated and free IPs in each range. + optional SubnetworkUtilizationDetails utilization_details = 33 + [json_name = "utilizationDetails"]; +} + +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. [Output Only] Type of resource. + // Alwayscompute#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 thanmaxResults, use the + // nextPageToken as a value 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. [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + // Output only. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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. [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 thanmaxResults, use the + // nextPageToken as a value 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. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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 isEXCLUDE_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"]; +} + +// Additional subnetwork parameters. +message SubnetworkParams { + // Tag keys/values directly bound to this resource. + // Tag keys and values have the same definition as resource + // manager tags. The field is allowed for INSERT + // only. The keys/values to set on the resource should be specified in + // either ID { : } or Namespaced format + // { : }. + // For example the following are valid inputs: + // * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} + // * {"123/environment" : "production", "345/abc" : "xyz"} + // Note: + // * Invalid combinations of ID & namespaced format is not supported. For + // instance: {"123/environment" : "tagValues/444"} is invalid. + map resource_manager_tags = 1 + [json_name = "resourceManagerTags"]; +} + +// 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. Both IPv4 and IPv6 ranges are supported. For IPv4, + // the range can be any range listed in theValid + // ranges list. + // + // For IPv6: + // The range must have a /64 prefix length. + // The range must be omitted, for auto-allocation from Google-defined ULA + // IPv6 range. + // For BYOGUA internal IPv6 secondary range, the range may be specified + // along with the `ipCollection` field. + // If an `ipCollection` is specified, the requested ip_cidr_range must lie + // within the range of the PDP referenced by the `ipCollection` field for + // allocation. + // If `ipCollection` field is specified, but ip_cidr_range is not, + // the range is auto-allocated from the PDP referenced by the `ipCollection` + // field. + optional string ip_cidr_range = 1 [json_name = "ipCidrRange"]; + + // Reference to a Public Delegated Prefix (PDP) for BYOIP. + // This field should be specified for configuring BYOGUA internal IPv6 + // secondary range. + // When specified along with the ip_cidr_range, the ip_cidr_range must lie + // within the PDP referenced by the `ipCollection` field. + // When specified without the ip_cidr_range, the range is auto-allocated + // from the PDP referenced by the `ipCollection` field. + optional string ip_collection = 4 [json_name = "ipCollection"]; + + // IPV4: + // IPV6: + // IP_VERSION_UNSPECIFIED: Treated as IPV4 for backward-compatibility. + optional string ip_version = 5 [json_name = "ipVersion"]; + + // The name associated with this subnetwork secondary range, used when adding + // an alias IP/IPv6 range to a VM instance. + // The name must be 1-63 characters long, and comply withRFC1035. + // The name must be unique within the subnetwork. + optional string range_name = 2 [json_name = "rangeName"]; + + // The URL of the reserved internal range. Only IPv4 is supported. + optional string reserved_internal_range = 3 + [json_name = "reservedInternalRange"]; +} + +// The current IP utilization of all subnetwork ranges. Contains the total +// number of allocated and free IPs in each range. +message SubnetworkUtilizationDetails { + // Utilizations of external IPV6 IP range. + optional SubnetworkUtilizationDetailsIPV6Utilization + external_ipv6_instance_utilization = 1 + [json_name = "externalIpv6InstanceUtilization"]; + + // Utilizations of external IPV6 IP range for NetLB. + optional SubnetworkUtilizationDetailsIPV6Utilization + external_ipv6_lb_utilization = 2 + [json_name = "externalIpv6LbUtilization"]; + + // Utilizations of internal IPV6 IP range. + optional SubnetworkUtilizationDetailsIPV6Utilization + internal_ipv6_utilization = 3 [json_name = "internalIpv6Utilization"]; + + // Utilizations of all IPV4 IP ranges. For primary ranges, the range name + // will be empty. + repeated SubnetworkUtilizationDetailsIPV4Utilization ipv4_utilizations = 4 + [json_name = "ipv4Utilizations"]; +} + +// The IPV4 utilization of a single IP range. +message SubnetworkUtilizationDetailsIPV4Utilization { + // Will be set for secondary range. Empty for primary IPv4 range. + optional string range_name = 1 [json_name = "rangeName"]; + + optional string total_allocated_ip = 2 [json_name = "totalAllocatedIp"]; + + optional string total_free_ip = 3 [json_name = "totalFreeIp"]; +} + +// The IPV6 utilization of a single IP range. +message SubnetworkUtilizationDetailsIPV6Utilization { + optional Uint128 total_allocated_ip = 1 [json_name = "totalAllocatedIp"]; + + optional Uint128 total_free_ip = 2 [json_name = "totalFreeIp"]; +} + +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 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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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"]; + } + + // An informational warning that appears when the list of addresses + // is empty. + optional Warning warning = 2 [json_name = "warning"]; +} + +message SubnetworksScopedWarning { + // Name of the scope containing this set of Subnetworks. + optional string scope_name = 1 [json_name = "scopeName"]; + + 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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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"]; + } + + // An informational warning about unreachable scope + 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. [Output Only] The external IPv6 address range that is assigned + // to this + // subnetwork. + optional string external_ipv6_prefix = 1 [json_name = "externalIpv6Prefix"]; + + // Output only. [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"]; + + // 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. + // PEER_MIGRATION: Subnetwork will be used for Migration from one peered VPC + // to another. + // (a transient state of subnetwork + // while migrating resources from one project to another). + // 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 orREGIONAL_MANAGED_PROXY. The value + // can be set toACTIVE 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 toIPV4_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 + // usingpatch. + // 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. + // Can be Ipv4 or Ipv6 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 withRFC1035. + // 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. [Output Only] Type of resource. + // Alwayscompute#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 thanmaxResults, use the + // nextPageToken as a value 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 andnextPageToken which + // still should be used to get the + // next page of results. + optional string next_page_token = 4 [json_name = "nextPageToken"]; + + // Output only. [Output Only] Informational warning messages for failures + // encountered from + // scopes. + repeated SubnetworksScopedWarning scoped_warnings = 7 + [json_name = "scopedWarnings"]; + + // Output only. [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + // Output only. [Output Only] Unreachable resources. + repeated string unreachables = 8 [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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_159.proto b/protos/google/cloud/compute/v1/internal/common_159.proto new file mode 100644 index 0000000000000..37daa6dd0c730 --- /dev/null +++ b/protos/google/cloud/compute/v1/internal/common_159.proto @@ -0,0 +1,219 @@ +// Copyright 2026 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: 20260807 + +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 { + // Output only. [Output Only] Creation timestamp inRFC3339 + // 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 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. [Output Only] The unique identifier for the resource type. The + // server + // generates this identifier. + optional string id = 4 [json_name = "id"]; + + // Output only. [Output Only] Type of the resource. + // Alwayscompute#targetGrpcProxy for target grpc 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 withRFC1035. + // 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. [Output Only] Server-defined URL for the resource. + optional string self_link = 7 [json_name = "selfLink"]; + + // Output only. [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"]; +} + +message TargetGrpcProxyList { + // [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"]; + + // Output only. [Output Only] Type of the resource. + // Alwayscompute#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 + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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_160.proto b/protos/google/cloud/compute/v1/internal/common_160.proto new file mode 100644 index 0000000000000..b337713bbdcdc --- /dev/null +++ b/protos/google/cloud/compute/v1/internal/common_160.proto @@ -0,0 +1,164 @@ +// Copyright 2026 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: 20260807 + +syntax = "proto3"; + +package google.cloud.cpp.compute.v1; + +import "google/cloud/compute/v1/internal/common_161.proto"; + +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 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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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 TargetHttpProxyAggregatedList { + // [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"]; + + // Output only. [Output Only] Type of resource. + // Alwayscompute#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 thanmaxResults, use the + // nextPageToken as a value 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. [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + // Output only. [Output Only] Unreachable resources. + repeated string unreachables = 6 [json_name = "unreachables"]; +} diff --git a/protos/google/cloud/compute/v1/internal/common_161.proto b/protos/google/cloud/compute/v1/internal/common_161.proto new file mode 100644 index 0000000000000..9071e33bbf374 --- /dev/null +++ b/protos/google/cloud/compute/v1/internal/common_161.proto @@ -0,0 +1,245 @@ +// Copyright 2026 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: 20260807 + +syntax = "proto3"; + +package google.cloud.cpp.compute.v1; + +// Represents a Target HTTP Proxy resource. +// +// Google Compute Engine has two Target HTTP Proxy resources: +// +// * +// [Global](https://cloud.google.com/compute/docs/reference/rest/v1/targetHttpProxies) +// * +// [Regional](https://cloud.google.com/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, readUsing Target Proxies +// and +// Forwarding rule concepts. +message TargetHttpProxy { + // Output only. [Output Only] Creation timestamp inRFC3339 + // 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 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"]; + + // 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. [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. + // The name must be 1-63 characters long, and comply withRFC1035. + // 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"]; + + // This field only applies when the forwarding rule that references this + // target proxy has a loadBalancingScheme set toINTERNAL_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. [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 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. + optional string url_map = 10 [json_name = "urlMap"]; +} + +// 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 TargetHttpProxy resources. + repeated TargetHttpProxy items = 2 [json_name = "items"]; + + // Output only. 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 + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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_162.proto b/protos/google/cloud/compute/v1/internal/common_162.proto new file mode 100644 index 0000000000000..ac01ba9a58ded --- /dev/null +++ b/protos/google/cloud/compute/v1/internal/common_162.proto @@ -0,0 +1,295 @@ +// Copyright 2026 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: 20260807 + +syntax = "proto3"; + +package google.cloud.cpp.compute.v1; + +import "google/cloud/compute/v1/internal/common_163.proto"; + +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 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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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 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 TargetHttpsProxiesScopedList resources. + map items = 2 [json_name = "items"]; + + // Output only. [Output Only] Type of resource. + // Alwayscompute#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 + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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. [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + // Output only. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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_163.proto b/protos/google/cloud/compute/v1/internal/common_163.proto new file mode 100644 index 0000000000000..fec0a74890e3a --- /dev/null +++ b/protos/google/cloud/compute/v1/internal/common_163.proto @@ -0,0 +1,390 @@ +// Copyright 2026 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: 20260807 + +syntax = "proto3"; + +package google.cloud.cpp.compute.v1; + +// Represents a Target HTTPS Proxy resource. +// +// Google Compute Engine has two Target HTTPS Proxy resources: +// +// * +// [Global](https://cloud.google.com/compute/docs/reference/rest/v1/targetHttpsProxies) +// * +// [Regional](https://cloud.google.com/compute/docs/reference/rest/v1/regionTargetHttpsProxies) +// +// A target HTTPS proxy is a component of Google Cloud HTTPS load balancers. +// +// * targetHttpsProxies are used by global external Application Load Balancers, +// classic Application Load Balancers, cross-region internal Application Load +// Balancers, and Traffic Director. +// * regionTargetHttpsProxies 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, readUsing 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 globalTargetHttpsProxy attached + // toglobalForwardingRules with theloadBalancingScheme 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. [Output Only] Creation timestamp inRFC3339 + // 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. 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"]; + + // [Output Only] The unique identifier for the resource. This identifier is + // defined by the server. + optional string id = 6 [json_name = "id"]; + + // Output only. [Output Only] Type of resource. Alwayscompute#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 withRFC1035. + // 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"]; + + // This field only applies when the forwarding rule that references this + // target proxy has a loadBalancingScheme set toINTERNAL_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, orDISABLE. + // + // - 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. [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 = 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 globalTargetHttpsProxy attached + // toglobalForwardingRules with theloadBalancingScheme set to + // INTERNAL_SELF_MANAGED + // or EXTERNAL orEXTERNAL_MANAGED or INTERNAL_MANAGED. + // It also applies to a regional TargetHttpsProxy attached to + // regional forwardingRules with theloadBalancingScheme set to + // EXTERNAL_MANAGED orINTERNAL_MANAGED. For details whichServerTlsPolicy + // resources are accepted withINTERNAL_SELF_MANAGED and which with + // EXTERNAL,INTERNAL_MANAGED, EXTERNAL_MANAGEDloadBalancingScheme 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 namespace. Using Certificate Manager + // Certificates in this field is 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 or up to 100 + // Certificate Manager 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. + // UNRESTRICTED: This enables TLS 1.3 Early Data for requests with any HTTP + // method + // including non-idempotent methods list POST. This mode does not enforce + // any other limitations. This may be valuable for gRPC use cases. However, + // we do not recommend this method unless you have evaluated your security + // stance and mitigated the risk of replay attacks using other mechanisms. + 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"]; +} + +// 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 TargetHttpsProxy resources. + repeated TargetHttpsProxy items = 2 [json_name = "items"]; + + // Output only. 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 + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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_164.proto b/protos/google/cloud/compute/v1/internal/common_164.proto new file mode 100644 index 0000000000000..f3bd7f4f56f5c --- /dev/null +++ b/protos/google/cloud/compute/v1/internal/common_164.proto @@ -0,0 +1,463 @@ +// Copyright 2026 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: 20260807 + +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, readTarget +// instances. +message TargetInstance { + // Output only. [Output Only] Creation timestamp inRFC3339 + // 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. [Output Only] The type of the resource. + // Alwayscompute#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 withRFC1035. + // 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. [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"]; + + // Output only. 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 thanmaxResults, use the + // nextPageToken as a value 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. [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + // Output only. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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"]; + + // Output only. 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 thanmaxResults, use the + // nextPageToken as a value 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. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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_165.proto b/protos/google/cloud/compute/v1/internal/common_165.proto new file mode 100644 index 0000000000000..a3d4d266fdd02 --- /dev/null +++ b/protos/google/cloud/compute/v1/internal/common_165.proto @@ -0,0 +1,571 @@ +// Copyright 2026 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: 20260807 + +syntax = "proto3"; + +package google.cloud.cpp.compute.v1; + +import "google/cloud/compute/v1/internal/common_061.proto"; +import "google/cloud/compute/v1/internal/common_065.proto"; +import "google/cloud/compute/v1/internal/common_078.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, readUsing 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 belowfailoverRatio, 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. [Output Only] Creation timestamp inRFC3339 + // 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"]; + + // 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"]; + + // Output only. [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 withRFC1035. + // 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. [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 = 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"]; +} + +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. [Output Only] Type of resource. + // Alwayscompute#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 thanmaxResults, use the + // nextPageToken as a value 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. [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + // Output only. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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. [Output Only] Type of resource. + // Alwayscompute#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. [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 + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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 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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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_166.proto b/protos/google/cloud/compute/v1/internal/common_166.proto new file mode 100644 index 0000000000000..5147611cc009d --- /dev/null +++ b/protos/google/cloud/compute/v1/internal/common_166.proto @@ -0,0 +1,26 @@ +// Copyright 2026 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: 20260807 + +syntax = "proto3"; + +package google.cloud.cpp.compute.v1; + +message TargetReference { + optional string target = 1 [json_name = "target"]; +} diff --git a/protos/google/cloud/compute/v1/internal/common_167.proto b/protos/google/cloud/compute/v1/internal/common_167.proto new file mode 100644 index 0000000000000..7c3d5fde4b3e4 --- /dev/null +++ b/protos/google/cloud/compute/v1/internal/common_167.proto @@ -0,0 +1,246 @@ +// Copyright 2026 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: 20260807 + +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 proxy, and the target proxy +// then references a backend service. For more information, readProxy 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. [Output Only] Creation timestamp inRFC3339 + // 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. [Output Only] Type of the resource. + // Alwayscompute#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 withRFC1035. + // 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"]; + + // 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 = 8 [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"]; +} + +// 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 TargetSslProxy resources. + repeated TargetSslProxy items = 2 [json_name = "items"]; + + // Output only. 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 thanmaxResults, use the + // nextPageToken as a value 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. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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_168.proto b/protos/google/cloud/compute/v1/internal/common_168.proto new file mode 100644 index 0000000000000..a2a97bf332c69 --- /dev/null +++ b/protos/google/cloud/compute/v1/internal/common_168.proto @@ -0,0 +1,283 @@ +// Copyright 2026 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: 20260807 + +syntax = "proto3"; + +package google.cloud.cpp.compute.v1; + +import "google/cloud/compute/v1/internal/common_169.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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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. [Output Only] Type of resource. + // Alwayscompute#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 thanmaxResults, use the + // nextPageToken as a value 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. [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + // Output only. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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_169.proto b/protos/google/cloud/compute/v1/internal/common_169.proto new file mode 100644 index 0000000000000..8db0dcfc28631 --- /dev/null +++ b/protos/google/cloud/compute/v1/internal/common_169.proto @@ -0,0 +1,223 @@ +// Copyright 2026 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: 20260807 + +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, readProxy Network +// Load Balancer overview. +message TargetTcpProxy { + // Output only. [Output Only] Creation timestamp inRFC3339 + // 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. [Output Only] Type of the resource. + // Alwayscompute#targetTcpProxy for target TCP proxies. + optional string kind = 4 [json_name = "kind"]; + + // Specifies the type of load balancing scheme used by this target proxy. + // EXTERNAL: + // EXTERNAL_MANAGED: + // INTERNAL_MANAGED: + // LOAD_BALANCING_SCHEME_UNSPECIFIED: + optional string load_balancing_scheme = 11 + [json_name = "loadBalancingScheme"]; + + // Name of the resource. Provided by the client when the resource is created. + // The name must be 1-63 characters long, and comply withRFC1035. + // 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 toINTERNAL_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. [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"]; +} + +// 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"]; + + // Output only. 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 thanmaxResults, use the + // nextPageToken as a value 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. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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_170.proto b/protos/google/cloud/compute/v1/internal/common_170.proto new file mode 100644 index 0000000000000..ea28311e2a3cb --- /dev/null +++ b/protos/google/cloud/compute/v1/internal/common_170.proto @@ -0,0 +1,500 @@ +// Copyright 2026 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: 20260807 + +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 thethe +// Cloud VPN Overview. +message TargetVpnGateway { + // Output only. [Output Only] Creation timestamp inRFC3339 + // 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 usingcompute.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. [Output Only] Type of resource. Alwayscompute#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 error412 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 + // thesetLabels method. Each label key/value pair must comply withRFC1035. + // 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 withRFC1035. + // 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"]; + + // Input only. [Input Only] Additional params passed with the request, but not + // persisted + // as part of resource payload. + optional TargetVpnGatewayParams params = 14 [json_name = "params"]; + + // [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. [Output Only] Type of resource. Alwayscompute#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 thanmaxResults, use the + // nextPageToken as a value 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. [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + // Output only. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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. [Output Only] Type of resource. Alwayscompute#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 thanmaxResults, use the + // nextPageToken as a value 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. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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 TargetVpnGatewayParams { + // Tag keys/values directly bound to this resource. + // Tag keys and values have the same definition as resource + // manager tags. The field is allowed for INSERT + // only. The keys/values to set on the resource should be specified in + // either ID { : } or Namespaced format + // { : }. + // For example the following are valid inputs: + // * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} + // * {"123/environment" : "production", "345/abc" : "xyz"} + // Note: + // * Invalid combinations of ID & namespaced format is not supported. For + // instance: {"123/environment" : "tagValues/444"} is invalid. + // * Inconsistent format is not supported. For instance: + // {"tagKeys/333" : "tagValues/444", "123/env" : "prod"} is invalid. + map resource_manager_tags = 1 + [json_name = "resourceManagerTags"]; +} + +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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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_171.proto b/protos/google/cloud/compute/v1/internal/common_171.proto new file mode 100644 index 0000000000000..5fe8025a7a998 --- /dev/null +++ b/protos/google/cloud/compute/v1/internal/common_171.proto @@ -0,0 +1,34 @@ +// Copyright 2026 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: 20260807 + +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"]; +} diff --git a/protos/google/cloud/compute/v1/internal/common_172.proto b/protos/google/cloud/compute/v1/internal/common_172.proto new file mode 100644 index 0000000000000..261270072add0 --- /dev/null +++ b/protos/google/cloud/compute/v1/internal/common_172.proto @@ -0,0 +1,28 @@ +// Copyright 2026 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: 20260807 + +syntax = "proto3"; + +package google.cloud.cpp.compute.v1; + +message Uint128 { + optional string high = 1 [json_name = "high"]; + + optional string low = 2 [json_name = "low"]; +} diff --git a/protos/google/cloud/compute/v1/internal/common_173.proto b/protos/google/cloud/compute/v1/internal/common_173.proto new file mode 100644 index 0000000000000..ee77b50ef4d50 --- /dev/null +++ b/protos/google/cloud/compute/v1/internal/common_173.proto @@ -0,0 +1,64 @@ +// Copyright 2026 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: 20260807 + +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"]; + + // Indicates whether the UpcomingMaintenance will be triggered on VM shutdown. + optional bool maintenance_on_shutdown = 7 + [json_name = "maintenanceOnShutdown"]; + + // The reasons for the maintenance. Only valid for vms. + repeated string maintenance_reasons = 8 [json_name = "maintenanceReasons"]; + + // 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. + // MULTIPLE: Multiple maintenance types in one window. + // This is only intended to be used for groups. + // 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_174.proto b/protos/google/cloud/compute/v1/internal/common_174.proto new file mode 100644 index 0000000000000..d6446bacd18b1 --- /dev/null +++ b/protos/google/cloud/compute/v1/internal/common_174.proto @@ -0,0 +1,26 @@ +// Copyright 2026 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: 20260807 + +syntax = "proto3"; + +package google.cloud.cpp.compute.v1; + +message UrlMapReference { + optional string url_map = 1 [json_name = "urlMap"]; +} diff --git a/protos/google/cloud/compute/v1/internal/common_175.proto b/protos/google/cloud/compute/v1/internal/common_175.proto new file mode 100644 index 0000000000000..b4f2374f6aef9 --- /dev/null +++ b/protos/google/cloud/compute/v1/internal/common_175.proto @@ -0,0 +1,138 @@ +// Copyright 2026 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: 20260807 + +syntax = "proto3"; + +package google.cloud.cpp.compute.v1; + +// Represents a VM extension policy. +message VmExtensionPolicy { + // Output only. [Output Only] Creation timestamp inRFC3339 + // text format. + optional string creation_timestamp = 1 [json_name = "creationTimestamp"]; + + // An optional description of this resource. + optional string description = 2 [json_name = "description"]; + + // Required. A map of extension names (for example, "ops-agent") to their + // corresponding + // policy configurations. + map extension_policies = 3 + [json_name = "extensionPolicies"]; + + // Optional. Output only. [Output Only] Link to the global policy that manages + // this zone policy, if + // applicable. + optional string global_resource_link = 4 [json_name = "globalResourceLink"]; + + // Output only. [Output Only] The unique identifier for the resource. This + // identifier is + // defined by the server. + optional string id = 5 [json_name = "id"]; + + // Optional. Selectors to target VMs for this policy. VMs are selected if they + // match + // *any* of the provided selectors (logical OR). If this list is empty, the + // policy applies to all VMs. + repeated VmExtensionPolicyInstanceSelector instance_selectors = 6 + [json_name = "instanceSelectors"]; + + // Output only. [Output Only] Type of the resource. + // Alwayscompute#vmExtensionPolicy. + optional string kind = 7 [json_name = "kind"]; + + // Optional. Output only. [Output Only] Indicates if this policy is managed by + // a global policy. + optional bool managed_by_global = 8 [json_name = "managedByGlobal"]; + + // Name of the resource. Provided by the client when the resource is created. + // The name must be 1-63 characters long, and comply withRFC1035. + // 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. Priority of this policy. Used to resolve conflicts when multiple + // policies + // apply to the same extension. + // The policy priority is an integer from 0 to 65535, inclusive. Lower + // integers indicate higher priorities. If you do not specify a priority when + // creating a rule, it is assigned a priority of 1000. If priorities are + // equal, the policy with the most recent creation timestamp takes precedence. + optional int32 priority = 10 [json_name = "priority"]; + + // Output only. [Output Only] Server-defined fully-qualified URL for this + // resource. + optional string self_link = 11 [json_name = "selfLink"]; + + // Output only. [Output Only] Server-defined URL for this resource's resource + // id. + optional string self_link_with_id = 12 [json_name = "selfLinkWithId"]; + + // Optional. Output only. [Output Only] Current state of the policy: ACTIVE or + // DELETING. + // ACTIVE: The policy is active and applied to matching VMs. + // Newly created VMs that match the policy will also receive the + // extension policy. + // DELETING: The policy is in the process of being deleted. After the + // extension is + // removed from all matching VMs, the policy will be deleted. + // STATE_UNSPECIFIED: Default value. Do not use. + optional string state = 13 [json_name = "state"]; + + // Output only. [Output Only] Update timestamp inRFC3339 + // text format. + optional string update_timestamp = 14 [json_name = "updateTimestamp"]; +} + +// Configuration for a specific VM extension. +message VmExtensionPolicyExtensionPolicy { + // Optional. The specific version of the extension to install. If not set, the + // latest + // version is used. + optional string pinned_version = 1 [json_name = "pinnedVersion"]; + + // Optional. String-based configuration data for the extension. + optional string string_config = 2 [json_name = "stringConfig"]; +} + +// Defines how to select VMs to apply a zone VM extension policy. +message VmExtensionPolicyInstanceSelector { + // Optional. LabelSelector selects VMs based on their labels. + optional VmExtensionPolicyLabelSelector label_selector = 1 + [json_name = "labelSelector"]; +} + +// A LabelSelector is applied to a VM only if it matches all the specified +// labels. +message VmExtensionPolicyLabelSelector { + // Optional. A map of key-value pairs representing VM labels. + // VMs must have all of the labels specified in this map to be selected + // (logical AND). + // + // e.g. If the `inclusion_labels` are {("key1", "value1"), ("key2", + // "value2")}, the VM labels must contain both ("key1", "value1") and + // ("key2", "value2") to be selected. If the VM labels are ("key1", + // "value1") and ("something", "else"), it will not be selected. + // + // If the map is empty, it's considered a match. + map inclusion_labels = 1 [json_name = "inclusionLabels"]; +} diff --git a/protos/google/cloud/compute/v1/internal/common_176.proto b/protos/google/cloud/compute/v1/internal/common_176.proto new file mode 100644 index 0000000000000..ac0b91a172ea8 --- /dev/null +++ b/protos/google/cloud/compute/v1/internal/common_176.proto @@ -0,0 +1,167 @@ +// Copyright 2026 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: 20260807 + +syntax = "proto3"; + +package google.cloud.cpp.compute.v1; + +import "google/cloud/compute/v1/internal/common_175.proto"; + +message VmExtensionPolicyList { + // Output only. [Output Only] 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 VmExtensionPolicy. An up-to-date + // fingerprint must be provided in order to update the VmExtensionPolicy. + // + // To see the latest value of the fingerprint, make a get() request to + // retrieve a VmExtensionPolicy. + optional string etag = 1 [json_name = "etag"]; + + // Output only. [Output Only] Unique identifier for the resource; defined by + // the server. + optional string id = 2 [json_name = "id"]; + + // Output only. [Output Only] A list of VM extension policy resources. + repeated VmExtensionPolicy items = 3 [json_name = "items"]; + + // Output only. Type of resource. + optional string kind = 4 [json_name = "kind"]; + + // Output only. [Output Only] This token allows you to get the next page of + // results for + // list requests. If the number of results is larger thanmaxResults, use the + // nextPageToken as a value 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. [Output Only] Server-defined URL for this resource. + optional string self_link = 6 [json_name = "selfLink"]; + + // Output only. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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. [Output Only] Informational warning message. + optional Warning warning = 8 [json_name = "warning"]; +} diff --git a/protos/google/cloud/compute/v1/internal/common_177.proto b/protos/google/cloud/compute/v1/internal/common_177.proto new file mode 100644 index 0000000000000..38f22d13e2fb7 --- /dev/null +++ b/protos/google/cloud/compute/v1/internal/common_177.proto @@ -0,0 +1,612 @@ +// Copyright 2026 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: 20260807 + +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 { + // Output only. [Output Only] Creation timestamp inRFC3339 + // 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. [Output Only] The unique identifier for the resource. This + // identifier is + // defined by the server. + optional string id = 3 [json_name = "id"]; + + // Output only. [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 error412 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 + // thesetLabels method. Each label key/value pair must comply withRFC1035. + // 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 withRFC1035. + // 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"]; + + // Input only. [Input Only] Additional params passed with the request, but not + // persisted + // as part of resource payload. + optional VpnGatewayParams params = 14 [json_name = "params"]; + + // Output only. [Output Only] URL of the region where the VPN gateway resides. + optional string region = 9 [json_name = "region"]; + + // Output only. [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 isIPV4, or IPV4_IPV6 + // if the gateway IP version isIPV6. + // 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. [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 thanmaxResults, use the + // nextPageToken as a value 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. [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + // Output only. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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. [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 thanmaxResults, use the + // nextPageToken as a value 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. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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 VpnGatewayParams { + // Tag keys/values directly bound to this resource. + // Tag keys and values have the same definition as resource + // manager tags. The field is allowed for INSERT + // only. The keys/values to set on the resource should be specified in + // either ID { : } or Namespaced format + // { : }. + // For example the following are valid inputs: + // * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} + // * {"123/environment" : "production", "345/abc" : "xyz"} + // Note: + // * Invalid combinations of ID & namespaced format is not supported. For + // instance: {"123/environment" : "tagValues/444"} is invalid. + // * Inconsistent format is not supported. For instance: + // {"tagKeys/333" : "tagValues/444", "123/env" : "prod"} is invalid. + map resource_manager_tags = 1 + [json_name = "resourceManagerTags"]; +} + +message VpnGatewayStatus { + // Output only. 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 { + // Output only. The VPN gateway interface this VPN tunnel is associated with. + optional uint32 local_gateway_interface = 1 + [json_name = "localGatewayInterface"]; + + // Output only. 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"]; + + // Output only. 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 { + // Output only. 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"]; + + // Output only. 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. [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. [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. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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_178.proto b/protos/google/cloud/compute/v1/internal/common_178.proto new file mode 100644 index 0000000000000..306e32cef4fa4 --- /dev/null +++ b/protos/google/cloud/compute/v1/internal/common_178.proto @@ -0,0 +1,632 @@ +// Copyright 2026 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: 20260807 + +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 { + // User specified list of ciphers to use for the phase 1 and phase 2 of the + // IKE protocol. + optional VpnTunnelCipherSuite cipher_suite = 25 [json_name = "cipherSuite"]; + + // Output only. [Output Only] Creation timestamp inRFC3339 + // 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. [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 error412 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 + // thesetLabels method. Each label key/value pair must comply withRFC1035. + // 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 withRFC1035. + // 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"]; + + // Input only. [Input Only] Additional params passed with the request, but not + // persisted + // as part of resource payload. + optional VpnTunnelParams params = 26 [json_name = "params"]; + + // 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. [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 thanmaxResults, use the + // nextPageToken as a value 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. [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + // Output only. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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 VpnTunnelCipherSuite { + optional VpnTunnelPhase1Algorithms phase1 = 1 [json_name = "phase1"]; + + optional VpnTunnelPhase2Algorithms phase2 = 2 [json_name = "phase2"]; +} + +// 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. [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 thanmaxResults, use the + // nextPageToken as a value 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. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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 VpnTunnelParams { + // Tag keys/values directly bound to this resource. + // Tag keys and values have the same definition as resource + // manager tags. The field is allowed for INSERT + // only. The keys/values to set on the resource should be specified in + // either ID { : } or Namespaced format + // { : }. + // For example the following are valid inputs: + // * {"tagKeys/333" : "tagValues/444", "tagKeys/123" : "tagValues/456"} + // * {"123/environment" : "production", "345/abc" : "xyz"} + // Note: + // * Invalid combinations of ID & namespaced format is not supported. For + // instance: {"123/environment" : "tagValues/444"} is invalid. + // * Inconsistent format is not supported. For instance: + // {"tagKeys/333" : "tagValues/444", "123/env" : "prod"} is invalid. + map resource_manager_tags = 1 + [json_name = "resourceManagerTags"]; +} + +message VpnTunnelPhase1Algorithms { + repeated string dh = 1 [json_name = "dh"]; + + repeated string encryption = 2 [json_name = "encryption"]; + + repeated string integrity = 3 [json_name = "integrity"]; + + repeated string prf = 4 [json_name = "prf"]; +} + +message VpnTunnelPhase2Algorithms { + repeated string encryption = 1 [json_name = "encryption"]; + + repeated string integrity = 2 [json_name = "integrity"]; + + repeated string pfs = 3 [json_name = "pfs"]; +} + +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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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_179.proto b/protos/google/cloud/compute/v1/internal/common_179.proto new file mode 100644 index 0000000000000..4637a3e59c7d5 --- /dev/null +++ b/protos/google/cloud/compute/v1/internal/common_179.proto @@ -0,0 +1,358 @@ +// Copyright 2026 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: 20260807 + +syntax = "proto3"; + +package google.cloud.cpp.compute.v1; + +// A pseudowire that connects two Interconnect connections. +message Wire { + // Output only. [Output Only] Indicates whether the wire is enabled. + // When false, the wire is disabled. When true and when the wire group of + // the wire is also enabled, the wire is enabled. Defaults to true. + optional bool admin_enabled = 1 [json_name = "adminEnabled"]; + + // Output only. Wire endpoints are specific Interconnect connections. + repeated WireEndpoint endpoints = 2 [json_name = "endpoints"]; + + // Output only. [Output Only] A label that identifies the wire. The format of + // this label + // combines the existing labels of the wire group endpoints and Interconnect + // connections used by this wire in alphabetical order as follows: + // `ENDPOINT_A+CONNECTION_A1,ENDPOINT_B+CONNECTION_B1`, where: + // + // - ENDPOINT_A and ENDPOINT_B: are the labels + // that you entered as map keys when you specified the wire group endpoint + // objects. + // - CONNECTION_A1 and CONNECTION_B1: are the + // labels that you entered as map keys when you specified the wire group + // Interconnect objects. + optional string label = 3 [json_name = "label"]; + + // Output only. [Output Only] Properties of the wire. + optional WireProperties wire_properties = 4 [json_name = "wireProperties"]; +} + +// Wire endpoints are specific Interconnect connections. +message WireEndpoint { + optional string interconnect = 1 [json_name = "interconnect"]; + + optional int32 vlan_tag = 2 [json_name = "vlanTag"]; +} + +// A resource that represents a group of redundant wires. +message WireGroup { + // Indicates whether the wires in the wire group are enabled. When false, the + // wires in the wire group are disabled. When true and when + // there is simultaneously no wire-specific override of `adminEnabled` to + // false, a given wire is enabled. Defaults to true. + optional bool admin_enabled = 1 [json_name = "adminEnabled"]; + + // Output only. [Output Only] Creation timestamp inRFC3339 + // text format. + optional string creation_timestamp = 2 [json_name = "creationTimestamp"]; + + // An optional description of the wire group. + optional string description = 3 [json_name = "description"]; + + // A map that contains the logical endpoints of the wire group. Specify + // key-value pairs for the map as follows: + // + // - Key: an RFC1035 user-specified label. + // - Value: an Endpoint object. + map endpoints = 4 [json_name = "endpoints"]; + + // Output only. [Output Only] The unique identifier for the resource type. The + // server + // generates this identifier. + optional string id = 5 [json_name = "id"]; + + // Output only. [Output Only] Type of the resource. Alwayscompute#wireGroups + // for wire groups. + 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 withRFC1035. + // 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"]; + + // Output only. [Output Only] Indicates whether there are wire changes yet to + // be processed. + optional bool reconciling = 8 [json_name = "reconciling"]; + + // Output only. [Output Only] Server-defined URL for the resource. + optional string self_link = 9 [json_name = "selfLink"]; + + // Output only. Topology details for the wire group configuration. + optional WireGroupTopology topology = 10 [json_name = "topology"]; + + // Properties for all wires in the wire group. + optional WireProperties wire_properties = 11 [json_name = "wireProperties"]; + + // Output only. The single/redundant wire(s) managed by the wire group. + repeated Wire wires = 12 [json_name = "wires"]; +} + +// A logical endpoint for the wire group. An endpoint represents a metro that +// contains redundant Interconnect connections. A wire group is created +// between two endpoints. +message WireGroupEndpoint { + // A map that contains the redundant Interconnect connections. Specify + // key-value pairs for the map as follows: + // + // - Key: an RFC1035 user-specified label. + // - Value: an Interconnect object. + map interconnects = 1 + [json_name = "interconnects"]; +} + +// The redundant Interconnect connections for this endpoint. +message WireGroupEndpointInterconnect { + // Required. An Interconnect connection. You can specify the connection as + // a partial or full URL. If the connection is in a different project from + // the cross-site network, use a format that specifies the project. See + // the following examples of partial and full URLs: + // + // + // + // global/interconnects/NAME + // + // + // projects/PROJECT_ID/global/interconnects/NAME + // + // - + // + // https://compute.googleapis.com/compute/projects/PROJECT_ID/global/interconnects/NAME + optional string interconnect = 1 [json_name = "interconnect"]; + + // Required. To configure the wire group for VLAN mode, enter a VLAN tag, + // which is a number from `2` to `4093`. You can autoallocate a tag by + // entering `0`. To configure the wire group for port mode, enter `-1`. + // Review the following guidelines: + // + // - A VLAN tag must be unique for an Interconnect connection across all + // attachments and wire groups. + // - Both endpoints of a wire must use the same VLAN tag value. + // - Single wire and redundant type wire groups must have only one + // VLAN tag. + // - Port mode pseudowires must have a single VLAN tag with a value of + // `-1` for both endpoints. + // - Box and cross type wire groups must have two VLAN tags. The first + // is for the same-zone pseudowire, and the second is for the cross-zone + // pseudowire. + repeated int32 vlan_tags = 2 [json_name = "vlanTags"]; +} + +// Response for the list request. +message WireGroupList { + 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 wire group resources. + repeated WireGroup items = 3 [json_name = "items"]; + + // Output only. [Output Only] Type of the resource. Alwayscompute#wireGroups + // for wire groups. + 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 thanmaxResults, use the + // nextPageToken as a value 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. [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 + // QUOTA_INFO_UNAVAILABLE: Quota information is not available to client + // requests (e.g: + // regions.list). + // 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"]; +} + +// Topology details for the wire group. +message WireGroupTopology { + // Output only. Topology details for all endpoints in the wire group. + repeated WireGroupTopologyEndpoint endpoints = 1 [json_name = "endpoints"]; +} + +// Topology details for a single wire group endpoint. +message WireGroupTopologyEndpoint { + // Output only. The InterconnectLocation.city (metropolitan area designator) + // that all + // interconnects are located in. + optional string city = 1 [json_name = "city"]; + + // Output only. Endpoint label from the wire group. + optional string label = 2 [json_name = "label"]; +} + +// The properties of a wire. +message WireProperties { + // The configuration of the bandwidth allocation, one of the following: + // + // - ALLOCATE_PER_WIRE: configures a separate unmetered bandwidth + // allocation + // (and associated charges) for each wire in the group. + // - SHARED_WITH_WIRE_GROUP: this is the default behavior, which configures + // one unmetered bandwidth allocation for the wire group. The unmetered + // bandwidth is divided equally across each wire in the group, but dynamic + // throttling reallocates unused unmetered bandwidth from unused or + // underused + // wires to other wires in the group. + // ALLOCATE_PER_WIRE: Configures a separate unmetered bandwidth allocation + // (and associated + // charges) for each wire in the group. + // SHARED_WITH_WIRE_GROUP: This is the default behavior. Configures one + // unmetered bandwidth + // allocation for the wire group. The unmetered bandwidth is divided equally + // across each wire in the group, but dynamic throttling reallocates unused + // unmetered bandwidth from unused or underused wires to other wires in the + // group. + optional string bandwidth_allocation = 1 [json_name = "bandwidthAllocation"]; + + // The unmetered bandwidth in Gigabits per second, using decimal units. `10` + // is 10 Gbps, `100` is 100 Gbps. The bandwidth must be greater than 0. + optional string bandwidth_unmetered = 2 [json_name = "bandwidthUnmetered"]; + + // Response when a fault is detected in a pseudowire: + // + // - NONE: default. + // - DISABLE_PORT: set the port line protocol down when inline probes + // detect a fault. This setting is only permitted on port mode + // pseudowires. + // DISABLE_PORT: Set the port line protocol down when inline probes detect a + // fault. This + // setting is only permitted on port mode pseudowires. + // NONE: Default. + optional string fault_response = 3 [json_name = "faultResponse"]; +} diff --git a/protos/google/cloud/compute/v1/internal/common_180.proto b/protos/google/cloud/compute/v1/internal/common_180.proto new file mode 100644 index 0000000000000..782532a9c5db8 --- /dev/null +++ b/protos/google/cloud/compute/v1/internal/common_180.proto @@ -0,0 +1,35 @@ +// Copyright 2026 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: 20260807 + +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_181.proto b/protos/google/cloud/compute/v1/internal/common_181.proto new file mode 100644 index 0000000000000..cfc2eaa6ab34d --- /dev/null +++ b/protos/google/cloud/compute/v1/internal/common_181.proto @@ -0,0 +1,39 @@ +// Copyright 2026 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: 20260807 + +syntax = "proto3"; + +package google.cloud.cpp.compute.v1; + +import "google/cloud/compute/v1/internal/common_009.proto"; + +message ZoneSetNestedPolicyRequest { + // 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/v1/internal/common_182.proto b/protos/google/cloud/compute/v1/internal/common_182.proto new file mode 100644 index 0000000000000..9bca9be21860c --- /dev/null +++ b/protos/google/cloud/compute/v1/internal/common_182.proto @@ -0,0 +1,39 @@ +// Copyright 2026 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: 20260807 + +syntax = "proto3"; + +package google.cloud.cpp.compute.v1; + +import "google/cloud/compute/v1/internal/common_009.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 85154a5477899..cb969dc9c3a0d 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: 20250601 +// revision: 20260807 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_016.proto"; -import "google/cloud/compute/v1/internal/common_107.proto"; -import "google/cloud/compute/v1/internal/common_145.proto"; -import "google/cloud/compute/v1/internal/common_148.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_125.proto"; +import "google/cloud/compute/v1/internal/common_171.proto"; +import "google/cloud/compute/v1/internal/common_177.proto"; import "google/cloud/extended_operations.proto"; // Service for the vpnGateways resource. @@ -39,8 +39,10 @@ service VpnGateways { "https://www.googleapis.com/auth/compute," "https://www.googleapis.com/auth/compute.readonly"; - // Retrieves an aggregated list of VPN gateways. To prevent failure, Google - // recommends that you set the `returnPartialSuccess` parameter to `true`. + // Retrieves an aggregated list of VPN gateways. + // + // To prevent failure, Google recommends that you set the + // `returnPartialSuccess` parameter to `true`. // https://cloud.google.com/compute/docs/reference/rest/v1/vpnGateways/aggregatedList rpc AggregatedListVpnGateways(AggregatedListVpnGatewaysRequest) returns (google.cloud.cpp.compute.v1.VpnGatewayAggregatedList) { @@ -81,8 +83,8 @@ service VpnGateways { option (google.api.method_signature) = "project,region,vpn_gateway"; } - // Creates a VPN gateway in the specified project and region using the data - // included in the request. + // Creates a VPN gateway in the specified project and region using + // the data included in the request. // https://cloud.google.com/compute/docs/reference/rest/v1/vpnGateways/insert rpc InsertVpnGateway(InsertVpnGatewayRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -95,8 +97,8 @@ service VpnGateways { option (google.cloud.operation_service) = "RegionOperations"; } - // Retrieves a list of VPN gateways available to the specified project and - // region. + // Retrieves a list of VPN gateways available to the specified + // project and region. // https://cloud.google.com/compute/docs/reference/rest/v1/vpnGateways/list rpc ListVpnGateways(ListVpnGatewaysRequest) returns (google.cloud.cpp.compute.v1.VpnGatewayList) { @@ -106,8 +108,9 @@ service VpnGateways { option (google.api.method_signature) = "project,region"; } - // Sets the labels on a VpnGateway. To learn more about labels, read the - // Labeling Resources documentation. + // Sets the labels on a VpnGateway. To learn more about labels, read + // theLabeling + // Resources documentation. // https://cloud.google.com/compute/docs/reference/rest/v1/vpnGateways/setLabels rpc SetLabels(SetLabelsRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -136,37 +139,64 @@ service VpnGateways { // Request message for AggregatedListVpnGateways. message AggregatedListVpnGatewaysRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; // Indicates whether every visible scope for each scope type (zone, region, @@ -178,25 +208,29 @@ message AggregatedListVpnGatewaysRequest { // will be included. optional bool include_all_scopes = 2 [json_name = "includeAllScopes"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 3 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 4 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 5 [json_name = "pageToken"]; // Project ID for this request. @@ -204,9 +238,11 @@ message AggregatedListVpnGatewaysRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; // The Shared VPC service project id or service project number for which @@ -233,14 +269,17 @@ message DeleteVpnGatewayRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // Name of the VPN gateway to delete. @@ -296,14 +335,17 @@ message InsertVpnGatewayRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // The VpnGateway for this request. @@ -314,58 +356,89 @@ message InsertVpnGatewayRequest { // Request message for ListVpnGateways. message ListVpnGatewaysRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -377,9 +450,11 @@ message ListVpnGatewaysRequest { [(google.api.field_behavior) = REQUIRED, json_name = "region"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; } @@ -406,14 +481,17 @@ message SetLabelsRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; // Name or id of the resource for this request. 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 6a57613cc80c8..9232e5718810d 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: 20250601 +// revision: 20260807 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_016.proto"; -import "google/cloud/compute/v1/internal/common_107.proto"; -import "google/cloud/compute/v1/internal/common_149.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_125.proto"; +import "google/cloud/compute/v1/internal/common_178.proto"; import "google/cloud/extended_operations.proto"; // Service for the vpnTunnels resource. @@ -38,8 +38,10 @@ service VpnTunnels { "https://www.googleapis.com/auth/compute," "https://www.googleapis.com/auth/compute.readonly"; - // Retrieves an aggregated list of VPN tunnels. To prevent failure, Google - // recommends that you set the `returnPartialSuccess` parameter to `true`. + // Retrieves an aggregated list of VPN tunnels. + // + // To prevent failure, Google recommends that you set the + // `returnPartialSuccess` parameter to `true`. // https://cloud.google.com/compute/docs/reference/rest/v1/vpnTunnels/aggregatedList rpc AggregatedListVpnTunnels(AggregatedListVpnTunnelsRequest) returns (google.cloud.cpp.compute.v1.VpnTunnelAggregatedList) { @@ -70,8 +72,8 @@ service VpnTunnels { option (google.api.method_signature) = "project,region,vpn_tunnel"; } - // Creates a VpnTunnel resource in the specified project and region using the - // data included in the request. + // Creates a VpnTunnel resource in the specified project and region using + // the data included in the request. // https://cloud.google.com/compute/docs/reference/rest/v1/vpnTunnels/insert rpc InsertVpnTunnel(InsertVpnTunnelRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -83,8 +85,8 @@ service VpnTunnels { option (google.cloud.operation_service) = "RegionOperations"; } - // Retrieves a list of VpnTunnel resources contained in the specified project - // and region. + // Retrieves a list of VpnTunnel resources contained in the specified + // project and region. // https://cloud.google.com/compute/docs/reference/rest/v1/vpnTunnels/list rpc ListVpnTunnels(ListVpnTunnelsRequest) returns (google.cloud.cpp.compute.v1.VpnTunnelList) { @@ -94,8 +96,9 @@ service VpnTunnels { option (google.api.method_signature) = "project,region"; } - // Sets the labels on a VpnTunnel. To learn more about labels, read the - // Labeling Resources documentation. + // Sets the labels on a VpnTunnel. To learn more about labels, read + // theLabeling + // Resources documentation. // https://cloud.google.com/compute/docs/reference/rest/v1/vpnTunnels/setLabels rpc SetLabels(SetLabelsRequest) returns (google.cloud.cpp.compute.v1.Operation) { @@ -112,37 +115,64 @@ service VpnTunnels { // Request message for AggregatedListVpnTunnels. message AggregatedListVpnTunnelsRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; // Indicates whether every visible scope for each scope type (zone, region, @@ -154,25 +184,29 @@ message AggregatedListVpnTunnelsRequest { // will be included. optional bool include_all_scopes = 2 [json_name = "includeAllScopes"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 3 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 4 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 5 [json_name = "pageToken"]; // Project ID for this request. @@ -180,9 +214,11 @@ message AggregatedListVpnTunnelsRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; // The Shared VPC service project id or service project number for which @@ -209,14 +245,17 @@ message DeleteVpnTunnelRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // Name of the VpnTunnel resource to delete. @@ -257,14 +296,17 @@ message InsertVpnTunnelRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 3 [json_name = "requestId"]; // The VpnTunnel for this request. @@ -275,58 +317,89 @@ message InsertVpnTunnelRequest { // Request message for ListVpnTunnels. message ListVpnTunnelsRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -338,9 +411,11 @@ message ListVpnTunnelsRequest { [(google.api.field_behavior) = REQUIRED, json_name = "region"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; } @@ -367,14 +442,17 @@ message SetLabelsRequest { // An optional request ID to identify requests. Specify a unique request ID so // that if you must retry your request, the server will know to ignore the - // request if it has already been completed. For example, consider a situation - // where you make an initial request and the request times out. If you make - // the request again with the same request ID, the server can check if - // original operation with the same request ID was received, and if so, will - // ignore the second request. This prevents clients from accidentally creating - // duplicate commitments. The request ID must be a valid UUID with the - // exception that zero UUID is not supported ( - // 00000000-0000-0000-0000-000000000000). + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). optional string request_id = 4 [json_name = "requestId"]; // Name or id of the resource for this request. diff --git a/protos/google/cloud/compute/wire_groups/v1/wire_groups.proto b/protos/google/cloud/compute/wire_groups/v1/wire_groups.proto new file mode 100644 index 0000000000000..33e5e5ac6ca05 --- /dev/null +++ b/protos/google/cloud/compute/wire_groups/v1/wire_groups.proto @@ -0,0 +1,332 @@ +// Copyright 2026 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: 20260807 + +syntax = "proto3"; + +package google.cloud.cpp.compute.wire_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_019.proto"; +import "google/cloud/compute/v1/internal/common_179.proto"; +import "google/cloud/extended_operations.proto"; + +// Service for the wireGroups resource. +// https://cloud.google.com/compute/docs/reference/rest/v1/wireGroups +service WireGroups { + option (google.api.default_host) = "compute.googleapis.com"; + option (google.api.oauth_scopes) = + "https://www.googleapis.com/auth/cloud-platform," + "https://www.googleapis.com/auth/compute," + "https://www.googleapis.com/auth/compute.readonly"; + + // Deletes the specified wire group in the given scope. + // https://cloud.google.com/compute/docs/reference/rest/v1/wireGroups/delete + rpc DeleteWireGroup(DeleteWireGroupRequest) + returns (google.cloud.cpp.compute.v1.Operation) { + option (google.api.http) = { + delete: "/compute/v1/projects/{project}/global/crossSiteNetworks/{cross_site_network}/wireGroups/{wire_group}" + }; + option (google.api.method_signature) = + "project,cross_site_network,wire_group"; + option (google.cloud.operation_service) = "GlobalOperations"; + } + + // Gets the specified wire group resource in the given scope. + // https://cloud.google.com/compute/docs/reference/rest/v1/wireGroups/get + rpc GetWireGroup(GetWireGroupRequest) + returns (google.cloud.cpp.compute.v1.WireGroup) { + option (google.api.http) = { + get: "/compute/v1/projects/{project}/global/crossSiteNetworks/{cross_site_network}/wireGroups/{wire_group}" + }; + option (google.api.method_signature) = + "project,cross_site_network,wire_group"; + } + + // Creates a wire group in the specified project in the given scope + // using the parameters that are included in the request. + // https://cloud.google.com/compute/docs/reference/rest/v1/wireGroups/insert + rpc InsertWireGroup(InsertWireGroupRequest) + returns (google.cloud.cpp.compute.v1.Operation) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/global/crossSiteNetworks/{cross_site_network}/wireGroups" + body: "wire_group_resource" + }; + option (google.api.method_signature) = + "project,cross_site_network,wire_group_resource"; + option (google.cloud.operation_service) = "GlobalOperations"; + } + + // Lists the wire groups for a project in the given scope. + // https://cloud.google.com/compute/docs/reference/rest/v1/wireGroups/list + rpc ListWireGroups(ListWireGroupsRequest) + returns (google.cloud.cpp.compute.v1.WireGroupList) { + option (google.api.http) = { + get: "/compute/v1/projects/{project}/global/crossSiteNetworks/{cross_site_network}/wireGroups" + }; + option (google.api.method_signature) = "project,cross_site_network"; + } + + // Updates the specified wire group resource with the data included in the + // request. This method supportsPATCH + // semantics and usesJSON merge + // patch format and processing rules. + // https://cloud.google.com/compute/docs/reference/rest/v1/wireGroups/patch + rpc PatchWireGroup(PatchWireGroupRequest) + returns (google.cloud.cpp.compute.v1.Operation) { + option (google.api.http) = { + patch: "/compute/v1/projects/{project}/global/crossSiteNetworks/{cross_site_network}/wireGroups/{wire_group}" + body: "wire_group_resource" + }; + option (google.api.method_signature) = + "project,cross_site_network,wire_group,update_mask,wire_group_resource"; + option (google.cloud.operation_service) = "GlobalOperations"; + } +} + +// Request message for DeleteWireGroup. +message DeleteWireGroupRequest { + string cross_site_network = 1 + [(google.api.field_behavior) = REQUIRED, json_name = "crossSiteNetwork"]; + + // Project ID for this request. + string project = 2 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "project", + json_name = "project" + ]; + + // An optional request ID to identify requests. Specify a unique request ID so + // that if you must retry your request, the server will know to ignore the + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating 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 + optional string request_id = 3 [json_name = "requestId"]; + + // Name of the wire group resource to delete. + string wire_group = 4 + [(google.api.field_behavior) = REQUIRED, json_name = "wireGroup"]; +} + +// Request message for GetWireGroup. +message GetWireGroupRequest { + string cross_site_network = 1 + [(google.api.field_behavior) = REQUIRED, json_name = "crossSiteNetwork"]; + + // Project ID for this request. + string project = 2 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // Name of the wire group resource to return. + string wire_group = 3 + [(google.api.field_behavior) = REQUIRED, json_name = "wireGroup"]; +} + +// Request message for InsertWireGroup. +message InsertWireGroupRequest { + string cross_site_network = 1 + [(google.api.field_behavior) = REQUIRED, json_name = "crossSiteNetwork"]; + + // Project ID for this request. + string project = 2 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "project", + json_name = "project" + ]; + + // An optional request ID to identify requests. Specify a unique request ID so + // that if you must retry your request, the server will know to ignore the + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating 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 + optional string request_id = 3 [json_name = "requestId"]; + + // [Input Only] Validate the new configuration, but don't create it. + optional bool validate_only = 4 [json_name = "validateOnly"]; + + // The WireGroup for this request. + optional google.cloud.cpp.compute.v1.WireGroup wire_group_resource = 5 + [json_name = "__json_request_body"]; +} + +// Request message for ListWireGroups. +message ListWireGroupsRequest { + string cross_site_network = 1 + [(google.api.field_behavior) = REQUIRED, json_name = "crossSiteNetwork"]; + + // A filter expression that filters resources listed in the response. Most + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. + optional string filter = 2 [json_name = "filter"]; + + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) + optional uint32 max_results = 3 [json_name = "maxResults"]; + + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or + // `creationTimestamp desc` is supported. + optional string order_by = 4 [json_name = "orderBy"]; + + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. + optional string page_token = 5 [json_name = "pageToken"]; + + // Project ID for this request. + string project = 6 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // Opt-in for partial success behavior which provides partial results in case + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. + optional bool return_partial_success = 7 [json_name = "returnPartialSuccess"]; +} + +// Request message for PatchWireGroup. +message PatchWireGroupRequest { + string cross_site_network = 1 + [(google.api.field_behavior) = REQUIRED, json_name = "crossSiteNetwork"]; + + // Project ID for this request. + string project = 2 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "project", + json_name = "project" + ]; + + // An optional request ID to identify requests. Specify a unique request ID so + // that if you must retry your request, the server will know to ignore the + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating 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 + optional string request_id = 3 [json_name = "requestId"]; + + // update_mask indicates fields to be updated as part of this request. + optional string update_mask = 4 [json_name = "updateMask"]; + + // [Input Only] Validate the new configuration, but don't update it. + optional bool validate_only = 5 [json_name = "validateOnly"]; + + // Name of the WireGroups resource to patch. + string wire_group = 6 + [(google.api.field_behavior) = REQUIRED, json_name = "wireGroup"]; + + // The WireGroup for this request. + optional google.cloud.cpp.compute.v1.WireGroup wire_group_resource = 7 + [json_name = "__json_request_body"]; +} 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 62f83957efbc5..2d91bd6bc0c2e 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: 20250601 +// revision: 20260807 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_016.proto"; -import "google/cloud/compute/v1/internal/common_092.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_107.proto"; import "google/cloud/extended_operations.proto"; import "google/protobuf/empty.proto"; @@ -57,8 +57,8 @@ service ZoneOperations { option (google.api.method_signature) = "project,zone,operation"; } - // Retrieves a list of Operation resources contained within the specified - // zone. + // Retrieves a list of Operation resources contained within + // the specified zone. // https://cloud.google.com/compute/docs/reference/rest/v1/zoneOperations/list rpc ListZoneOperations(ListZoneOperationsRequest) returns (google.cloud.cpp.compute.v1.OperationList) { @@ -68,16 +68,23 @@ service ZoneOperations { option (google.api.method_signature) = "project,zone"; } - // 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`. + // 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`. // https://cloud.google.com/compute/docs/reference/rest/v1/zoneOperations/wait rpc Wait(WaitRequest) returns (google.cloud.cpp.compute.v1.Operation) { option (google.api.http) = { @@ -128,58 +135,89 @@ message GetOperationRequest { // Request message for ListZoneOperations. message ListZoneOperationsRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -187,9 +225,11 @@ message ListZoneOperationsRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 6 [json_name = "returnPartialSuccess"]; // Name of the zone for request. diff --git a/protos/google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies.proto b/protos/google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies.proto new file mode 100644 index 0000000000000..5fc8bad1f3366 --- /dev/null +++ b/protos/google/cloud/compute/zone_vm_extension_policies/v1/zone_vm_extension_policies.proto @@ -0,0 +1,327 @@ +// Copyright 2026 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: 20260807 + +syntax = "proto3"; + +package google.cloud.cpp.compute.zone_vm_extension_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_019.proto"; +import "google/cloud/compute/v1/internal/common_175.proto"; +import "google/cloud/compute/v1/internal/common_176.proto"; +import "google/cloud/extended_operations.proto"; + +// Service for the zoneVmExtensionPolicies resource. +// https://cloud.google.com/compute/docs/reference/rest/v1/zoneVmExtensionPolicies +service ZoneVmExtensionPolicies { + option (google.api.default_host) = "compute.googleapis.com"; + option (google.api.oauth_scopes) = + "https://www.googleapis.com/auth/cloud-platform," + "https://www.googleapis.com/auth/compute," + "https://www.googleapis.com/auth/compute.readonly"; + + // Deletes a specified zone VM extension policy within a project. + // https://cloud.google.com/compute/docs/reference/rest/v1/zoneVmExtensionPolicies/delete + rpc DeleteVmExtensionPolicy(DeleteVmExtensionPolicyRequest) + returns (google.cloud.cpp.compute.v1.Operation) { + option (google.api.http) = { + delete: "/compute/v1/projects/{project}/zones/{zone}/vmExtensionPolicies/{vm_extension_policy}" + }; + option (google.api.method_signature) = "project,zone,vm_extension_policy"; + option (google.cloud.operation_service) = "ZoneOperations"; + } + + // Retrieves details of a specific zone VM extension policy within a project. + // https://cloud.google.com/compute/docs/reference/rest/v1/zoneVmExtensionPolicies/get + rpc GetVmExtensionPolicy(GetVmExtensionPolicyRequest) + returns (google.cloud.cpp.compute.v1.VmExtensionPolicy) { + option (google.api.http) = { + get: "/compute/v1/projects/{project}/zones/{zone}/vmExtensionPolicies/{vm_extension_policy}" + }; + option (google.api.method_signature) = "project,zone,vm_extension_policy"; + } + + // Creates a new zone-level VM extension policy within a project. + // https://cloud.google.com/compute/docs/reference/rest/v1/zoneVmExtensionPolicies/insert + rpc InsertVmExtensionPolicy(InsertVmExtensionPolicyRequest) + returns (google.cloud.cpp.compute.v1.Operation) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/zones/{zone}/vmExtensionPolicies" + body: "vm_extension_policy_resource" + }; + option (google.api.method_signature) = + "project,zone,vm_extension_policy_resource"; + option (google.cloud.operation_service) = "ZoneOperations"; + } + + // Lists all VM extension policies within a specific zone for a project. + // https://cloud.google.com/compute/docs/reference/rest/v1/zoneVmExtensionPolicies/list + rpc ListZoneVmExtensionPolicies(ListZoneVmExtensionPoliciesRequest) + returns (google.cloud.cpp.compute.v1.VmExtensionPolicyList) { + option (google.api.http) = { + get: "/compute/v1/projects/{project}/zones/{zone}/vmExtensionPolicies" + }; + option (google.api.method_signature) = "project,zone"; + } + + // Modifies an existing zone VM extension policy within a project. + // https://cloud.google.com/compute/docs/reference/rest/v1/zoneVmExtensionPolicies/update + rpc UpdateVmExtensionPolicy(UpdateVmExtensionPolicyRequest) + returns (google.cloud.cpp.compute.v1.Operation) { + option (google.api.http) = { + patch: "/compute/v1/projects/{project}/zones/{zone}/vmExtensionPolicies/{vm_extension_policy}" + body: "vm_extension_policy_resource" + }; + option (google.api.method_signature) = + "project,zone,vm_extension_policy,vm_extension_policy_resource"; + option (google.cloud.operation_service) = "ZoneOperations"; + } +} + +// Request message for DeleteVmExtensionPolicy. +message DeleteVmExtensionPolicyRequest { + // Project ID for this request. + string project = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "project", + json_name = "project" + ]; + + // An optional request ID to identify requests. Specify a unique request ID so + // that if you must retry your request, the server will know to ignore the + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). + optional string request_id = 2 [json_name = "requestId"]; + + // Name of the zone VM extension policy to delete. + string vm_extension_policy = 3 + [(google.api.field_behavior) = REQUIRED, json_name = "vmExtensionPolicy"]; + + // Name of the zone for this request. + string zone = 4 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "zone", + json_name = "zone" + ]; +} + +// Request message for GetVmExtensionPolicy. +message GetVmExtensionPolicyRequest { + // Project ID for this request. + string project = 1 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // Name of the VM extension policy resource to return. + string vm_extension_policy = 2 + [(google.api.field_behavior) = REQUIRED, json_name = "vmExtensionPolicy"]; + + // Name of the zone for this request. + string zone = 3 [(google.api.field_behavior) = REQUIRED, json_name = "zone"]; +} + +// Request message for InsertVmExtensionPolicy. +message InsertVmExtensionPolicyRequest { + // Project ID for this request. + string project = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "project", + json_name = "project" + ]; + + // An optional request ID to identify requests. Specify a unique request ID so + // that if you must retry your request, the server will know to ignore the + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). + optional string request_id = 2 [json_name = "requestId"]; + + // The VmExtensionPolicy for this request. + optional google.cloud.cpp.compute.v1.VmExtensionPolicy + vm_extension_policy_resource = 3 [json_name = "__json_request_body"]; + + // Name of the zone for this request. + string zone = 4 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "zone", + json_name = "zone" + ]; +} + +// Request message for ListZoneVmExtensionPolicies. +message ListZoneVmExtensionPoliciesRequest { + // A filter expression that filters resources listed in the response. Most + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. + optional string filter = 1 [json_name = "filter"]; + + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) + optional uint32 max_results = 2 [json_name = "maxResults"]; + + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or + // `creationTimestamp desc` is supported. + optional string order_by = 3 [json_name = "orderBy"]; + + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. + optional string page_token = 4 [json_name = "pageToken"]; + + // Project ID for this request. + string project = 5 + [(google.api.field_behavior) = REQUIRED, json_name = "project"]; + + // Opt-in for partial success behavior which provides partial results in case + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. + optional bool return_partial_success = 6 [json_name = "returnPartialSuccess"]; + + // Name of the zone for this request. + string zone = 7 [(google.api.field_behavior) = REQUIRED, json_name = "zone"]; +} + +// Request message for UpdateVmExtensionPolicy. +message UpdateVmExtensionPolicyRequest { + // Project ID for this request. + string project = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "project", + json_name = "project" + ]; + + // An optional request ID to identify requests. Specify a unique request ID so + // that if you must retry your request, the server will know to ignore the + // request if it has already been completed. + // + // For example, consider a situation where you make an initial request and + // the request times out. If you make the request again with the same + // request ID, the server can check if original operation with the same + // request ID was received, and if so, will ignore the second request. This + // prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be + // a valid UUID with the exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). + optional string request_id = 2 [json_name = "requestId"]; + + // Name of the zone VM extension policy to update. + string vm_extension_policy = 3 + [(google.api.field_behavior) = REQUIRED, json_name = "vmExtensionPolicy"]; + + // The VmExtensionPolicy for this request. + optional google.cloud.cpp.compute.v1.VmExtensionPolicy + vm_extension_policy_resource = 4 [json_name = "__json_request_body"]; + + // Name of the zone for this request. + string zone = 5 [ + (google.api.field_behavior) = REQUIRED, + (google.cloud.operation_request_field) = "zone", + json_name = "zone" + ]; +} diff --git a/protos/google/cloud/compute/zones/v1/zones.proto b/protos/google/cloud/compute/zones/v1/zones.proto index 2495518db2f3f..325a9e5a5e735 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: 20250601 +// revision: 20260807 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_150.proto"; +import "google/cloud/compute/v1/internal/common_031.proto"; // Service for the zones resource. // https://cloud.google.com/compute/docs/reference/rest/v1/zones @@ -68,58 +68,89 @@ message GetZoneRequest { // Request message for ListZones. message ListZonesRequest { // A filter expression that filters resources listed in the response. Most - // Compute resources support two types of filter expressions: expressions that - // support regular expressions and expressions that follow API improvement - // proposal AIP-160. These two types of filter expressions cannot be mixed in - // one request. If you want to use AIP-160, your expression must specify the - // field name, an operator, and the value that you want to use for filtering. - // The value must be a string, a number, or a boolean. The operator must be - // either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are - // filtering Compute Engine instances, you can exclude instances named - // `example-instance` by specifying `name != example-instance`. The `:*` - // comparison can be used to test whether a key has been defined. For example, - // to find all objects with `owner` label use: ``` labels.owner:* ``` You can - // also filter nested fields. For example, you could specify - // `scheduling.automaticRestart = false` to include instances only if they are - // not scheduled for automatic restarts. You can use filtering on nested - // fields to filter based on resource labels. To filter on multiple - // expressions, provide each separate expression within parentheses. For - // example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel - // Skylake") ``` By default, each expression is an `AND` expression. However, - // you can include `AND` and `OR` expressions explicitly. For example: ``` - // (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND - // (scheduling.automaticRestart = true) ``` If you want to use a regular - // expression, use the `eq` (equal) or `ne` (not equal) operator against a - // single un-parenthesized expression with or without quotes or against - // multiple parenthesized expressions. Examples: `fieldname eq unquoted - // literal` `fieldname eq 'single quoted literal'` `fieldname eq "double - // quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The - // literal value is interpreted as a regular expression using Google RE2 - // library syntax. The literal value must match the entire field. For example, - // to filter for instances that do not end with name "instance", you would use - // `name ne .*instance`. You cannot combine constraints on multiple fields - // using regular expressions. + // Compute resources support two types of filter expressions: + // expressions that support regular expressions and expressions that follow + // API improvement proposal AIP-160. + // These two types of filter expressions cannot be mixed in one request. + // + // If you want to use AIP-160, your expression must specify the field name, an + // operator, and the value that you want to use for filtering. The value + // must be a string, a number, or a boolean. The operator + // must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. + // + // For example, if you are filtering Compute Engine instances, you can + // exclude instances named `example-instance` by specifying + // `name != example-instance`. + // + // The `:*` comparison can be used to test whether a key has been defined. + // For example, to find all objects with `owner` label use: + // ``` + // labels.owner:* + // ``` + // + // You can also filter nested fields. For example, you could specify + // `scheduling.automaticRestart = false` to include instances only + // if they are not scheduled for automatic restarts. You can use filtering + // on nested fields to filter based onresource labels. + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. For example: + // ``` + // (scheduling.automaticRestart = true) + // (cpuPlatform = "Intel Skylake") + // ``` + // By default, each expression is an `AND` expression. However, you + // can include `AND` and `OR` expressions explicitly. + // For example: + // ``` + // (cpuPlatform = "Intel Skylake") OR + // (cpuPlatform = "Intel Broadwell") AND + // (scheduling.automaticRestart = true) + // ``` + // + // If you want to use a regular expression, use the `eq` (equal) or `ne` + // (not equal) operator against a single un-parenthesized expression with or + // without quotes or against multiple parenthesized expressions. Examples: + // + // `fieldname eq unquoted literal` + // `fieldname eq 'single quoted literal'` + // `fieldname eq "double quoted literal"` + // `(fieldname1 eq literal) (fieldname2 ne "literal")` + // + // The literal value is interpreted as a regular expression using GoogleRE2 + // library syntax. + // The literal value must match the entire field. + // + // For example, to filter for instances that do not end with name "instance", + // you would use `name ne .*instance`. + // + // You cannot combine constraints on multiple fields using regular + // expressions. optional string filter = 1 [json_name = "filter"]; - // The maximum number of results per page that should be returned. If the - // number of available results is larger than `maxResults`, Compute Engine - // returns a `nextPageToken` that can be used to get the next page of results - // in subsequent list requests. Acceptable values are `0` to `500`, inclusive. - // (Default: `500`) + // The maximum number of results per page that should be returned. + // If the number of available results is larger than `maxResults`, + // Compute Engine returns a `nextPageToken` that can be used to get + // the next page of results in subsequent list requests. Acceptable values are + // `0` to `500`, inclusive. (Default: `500`) optional uint32 max_results = 2 [json_name = "maxResults"]; - // Sorts list results by a certain order. By default, results are returned in - // alphanumerical order based on the resource name. You can also sort results - // in descending order based on the creation timestamp using - // `orderBy="creationTimestamp desc"`. This sorts results based on the - // `creationTimestamp` field in reverse chronological order (newest result - // first). Use this to sort resources like operations so that the newest - // operation is returned first. Currently, only sorting by `name` or + // Sorts list results by a certain order. By default, results + // are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation + // timestamp using `orderBy="creationTimestamp desc"`. This sorts + // results based on the `creationTimestamp` field in + // reverse chronological order (newest result first). Use this to sort + // resources like operations so that the newest operation is returned first. + // + // Currently, only sorting by `name` or // `creationTimestamp desc` is supported. optional string order_by = 3 [json_name = "orderBy"]; - // Specifies a page token to use. Set `pageToken` to the `nextPageToken` - // returned by a previous list request to get the next page of results. + // Specifies a page token to use. Set `pageToken` to the + // `nextPageToken` returned by a previous list request to get + // the next page of results. optional string page_token = 4 [json_name = "pageToken"]; // Project ID for this request. @@ -127,8 +158,10 @@ message ListZonesRequest { [(google.api.field_behavior) = REQUIRED, json_name = "project"]; // Opt-in for partial success behavior which provides partial results in case - // of failure. The default value is false. For example, when partial success - // behavior is enabled, aggregatedList for a single zone scope either returns - // all resources in the zone or no resources, with an error code. + // of failure. The default value is false. + // + // For example, when partial success behavior is enabled, aggregatedList for a + // single zone scope either returns all resources in the zone or no resources, + // with an error code. optional bool return_partial_success = 6 [json_name = "returnPartialSuccess"]; }